feat: add agents_list tool

src/agents/clawdbot-tools.agents.test.ts

@@ -0,0 +1,123 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+let configOverride: ReturnType<
+  typeof import("../config/config.js")["loadConfig"]
+> = {
+  session: {
+    mainKey: "main",
+    scope: "per-sender",
+  },
+};
+
+vi.mock("../config/config.js", async (importOriginal) => {
+  const actual = await importOriginal<typeof import("../config/config.js")>();
+  return {
+    ...actual,
+    loadConfig: () => configOverride,
+    resolveGatewayPort: () => 18789,
+  };
+});
+
+import { createClawdbotTools } from "./clawdbot-tools.js";
+
+describe("agents_list", () => {
+  beforeEach(() => {
+    configOverride = {
+      session: {
+        mainKey: "main",
+        scope: "per-sender",
+      },
+    };
+  });
+
+  it("defaults to the requester agent only", async () => {
+    const tool = createClawdbotTools({
+      agentSessionKey: "main",
+    }).find((candidate) => candidate.name === "agents_list");
+    if (!tool) throw new Error("missing agents_list tool");
+
+    const result = await tool.execute("call1", {});
+    expect(result.details).toMatchObject({
+      requester: "main",
+      allowAny: false,
+    });
+    const agents = (result.details as { agents?: Array<{ id: string }> })
+      .agents;
+    expect(agents?.map((agent) => agent.id)).toEqual(["main"]);
+  });
+
+  it("includes allowlisted targets plus requester", async () => {
+    configOverride = {
+      session: {
+        mainKey: "main",
+        scope: "per-sender",
+      },
+      routing: {
+        agents: {
+          main: {
+            name: "Main",
+            subagents: {
+              allowAgents: ["research"],
+            },
+          },
+          research: {
+            name: "Research",
+          },
+        },
+      },
+    };
+
+    const tool = createClawdbotTools({
+      agentSessionKey: "main",
+    }).find((candidate) => candidate.name === "agents_list");
+    if (!tool) throw new Error("missing agents_list tool");
+
+    const result = await tool.execute("call2", {});
+    const agents = (result.details as {
+      agents?: Array<{ id: string }>;
+    }).agents;
+    expect(agents?.map((agent) => agent.id)).toEqual(["main", "research"]);
+  });
+
+  it("returns configured agents when allowlist is *", async () => {
+    configOverride = {
+      session: {
+        mainKey: "main",
+        scope: "per-sender",
+      },
+      routing: {
+        agents: {
+          main: {
+            subagents: {
+              allowAgents: ["*"],
+            },
+          },
+          research: {
+            name: "Research",
+          },
+          coder: {
+            name: "Coder",
+          },
+        },
+      },
+    };
+
+    const tool = createClawdbotTools({
+      agentSessionKey: "main",
+    }).find((candidate) => candidate.name === "agents_list");
+    if (!tool) throw new Error("missing agents_list tool");
+
+    const result = await tool.execute("call3", {});
+    expect(result.details).toMatchObject({
+      allowAny: true,
+    });
+    const agents = (result.details as {
+      agents?: Array<{ id: string }>;
+    }).agents;
+    expect(agents?.map((agent) => agent.id)).toEqual([
+      "main",
+      "coder",
+      "research",
+    ]);
+  });
+});