orbitx 0.2.9 → 0.3.2

package/dist/tools/agent/registry.js

@@ -1,68 +1,113 @@
+import { randomUUID } from "crypto";
+import EventEmitter from "events";
+import { AsyncLocalStorage } from "async_hooks";
 /**
- * In-memory catalog of WorkerAgents a planner can see/hire/prompt, plus
- * which of them are currently "active" (hired). Scoped to one AgentTools()
- * call — not a process-wide singleton — so multiple independent planners in
- * the same process each get their own roster and hire state.
- *
- * WorkerAgent instances are live objects (their own AI provider, message
- * history, etc.), not serializable data, so — unlike MCPTool state such as
- * TodoTools' lists — this can't live in MCPStorage. The roster itself is
- * fixed at construction (only the developer can safely wire up a worker's
- * provider/instruction/tools); the model can only hire/prompt from what's
- * already here, never create new ones.
+ * How long a tool waits for the swarm's ack before giving up. Every listener
+ * answers immediately in practice (hiring is synchronous, delivery is
+ * fire-and-forget), so this only exists to turn a wiring mistake into a legible
+ * tool error instead of an agent that hangs forever.
  */
-export class AgentRegistry {
-    #agents = new Map();
-    #hired = new Set();
+const ACK_TIMEOUT_MS = 30000;
+export class AgentToolsRegistry extends EventEmitter {
+    id = randomUUID();
     #maxHired;
-    constructor(agents, maxHired) {
+    #controller;
+    /**
+     * Which agent's turn we are inside.
+     *
+     * The whole swarm shares one MCPClient, so a tool's `execute(envID, inputs,
+     * toolCallId, mcp)` gets nothing that identifies its caller. Rather than have
+     * the swarm keep a tool-call-id ledger, it runs each agent's turn inside this
+     * context: a tool called during that turn reads the id straight off it, and
+     * parallel agents each get their own store for free.
+     */
+    #callers = new AsyncLocalStorage();
+    constructor(maxHired) {
+        super();
         if (maxHired !== undefined && (!Number.isInteger(maxHired) || maxHired < 1)) {
-            throw new Error(`AgentTools: maxHired must be a positive integer when given, got ${maxHired}.`);
+            throw new Error(`getAgentTools: maxHired must be a positive integer when given, got ${maxHired}.`);
         }
         this.#maxHired = maxHired;
-        for (const agent of agents) {
-            const name = agent.getName();
-            if (this.#agents.has(name)) {
-                throw new Error(`AgentTools: duplicate worker agent name "${name}" — names must be unique across the roster.`);
-            }
-            this.#agents.set(name, agent);
-        }
     }
     getMaxHired() {
         return this.#maxHired;
     }
-    getHiredCount() {
-        return this.#hired.size;
+    attach(controller) {
+        if (this.#controller && this.#controller !== controller) {
+            throw new Error(`getAgentTools: this tool set (${this.id}) is already attached to another swarm — build a separate getAgentTools() per swarm.`);
+        }
+        this.#controller = controller;
     }
-    list() {
-        return [...this.#agents.values()].map(agent => ({
-            name: agent.getName(),
-            description: agent.getDescription(),
-            rating: agent.getRating(),
-            hired: this.#hired.has(agent.getName()),
-        }));
+    isAttached() {
+        return this.#controller !== undefined;
     }
-    hire(name) {
-        if (!this.#agents.has(name)) {
-            throw new Error(`no worker agent named "${name}" — check agent-list for available names.`);
+    requireController() {
+        if (!this.#controller) {
+            throw new Error("no swarm is attached to these agent tools — pass the getAgentTools() handle to SwarmBase as `agentTools`.");
         }
-        // Re-hiring an already-hired agent is a no-op — it must never count
-        // against the limit a second time.
-        if (this.#hired.has(name)) {
-            return;
+        return this.#controller;
+    }
+    /** Run an agent's turn labelled with its id. SwarmBase wraps every `BaseAgent.run()` in this. */
+    runAs(agentId, fn) {
+        return this.#callers.run(agentId, fn);
+    }
+    currentAgentId() {
+        return this.#callers.getStore();
+    }
+    /** The caller and the swarm, or a tool error saying which of the two is missing. */
+    requireCaller() {
+        const controller = this.requireController();
+        const agentId = this.#callers.getStore();
+        if (!agentId) {
+            throw new Error("could not tell which agent made this call — agent tools only work on agents running inside a SwarmBase.");
         }
-        if (this.#maxHired !== undefined && this.#hired.size >= this.#maxHired) {
-            throw new Error(`cannot hire "${name}" — maximum of ${this.#maxHired} hired agent(s) already reached ` +
-                `(currently hired: ${[...this.#hired].join(", ") || "none"}).`);
+        return { controller, agentId };
+    }
+    /** Ask the swarm to carry something out, and wait for its ack. */
+    request(event, agentId, payload) {
+        if (this.listenerCount(event) === 0) {
+            return Promise.reject(new Error(`no swarm is listening for "${event}" — pass the getAgentTools() handle to SwarmBase as \`agentTools\`.`));
         }
-        this.#hired.add(name);
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const timer = setTimeout(() => {
+                if (settled)
+                    return;
+                settled = true;
+                reject(new Error(`the swarm did not answer "${event}" within ${ACK_TIMEOUT_MS}ms.`));
+            }, ACK_TIMEOUT_MS);
+            timer.unref?.();
+            const done = (error, result) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                if (error)
+                    reject(error);
+                else
+                    resolve(result);
+            };
+            this.emit(event, agentId, payload, done);
+        });
     }
-    isHired(name) {
-        return this.#hired.has(name);
+    /** Hired agents still active — the entrypoint agent is not one of them. */
+    countHired() {
+        const controller = this.requireController();
+        return controller.listAgents().filter(a => a.active && !controller.isEntrypoint(a.agentId)).length;
     }
-    get(name) {
-        return this.#agents.get(name);
+    getRemaining() {
+        if (this.#maxHired === undefined)
+            return undefined;
+        return Math.max(0, this.#maxHired - this.countHired());
+    }
+    /** Look an agent up the way a tool needs it: with an error the model can act on. */
+    requireAgent(controller, agentId) {
+        const info = controller.getAgentInfo(agentId);
+        if (!info) {
+            throw new Error(`there is no agent "${agentId}" in this swarm — check agent-active for the ids that exist.`);
+        }
+        return info;
     }
 }
-export default AgentRegistry;
+export default AgentToolsRegistry;
 //# sourceMappingURL=registry.js.map

package/dist/tools/agent/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/tools/agent/registry.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,aAAa;IACtB,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IACzC,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAC3B,SAAS,CAAU;IAEnB,YAAY,MAAqB,EAAE,QAAiB;QAChD,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC;YAC1E,MAAM,IAAI,KAAK,CAAC,mEAAmE,QAAQ,GAAG,CAAC,CAAC;QACpG,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAE1B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,6CAA6C,CAAC,CAAC;YACnH,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAClC,CAAC;IACL,CAAC;IAED,WAAW;QACP,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,aAAa;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED,IAAI;QACA,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC5C,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE;YACrB,WAAW,EAAE,KAAK,CAAC,cAAc,EAAE;YACnC,MAAM,EAAE,KAAK,CAAC,SAAS,EAAE;YACzB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;SAC1C,CAAC,CAAC,CAAC;IACR,CAAC;IAED,IAAI,CAAC,IAAY;QACb,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,2CAA2C,CAAC,CAAC;QAC/F,CAAC;QACD,oEAAoE;QACpE,mCAAmC;QACnC,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO;QACX,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CACX,gBAAgB,IAAI,kBAAkB,IAAI,CAAC,SAAS,kCAAkC;gBACtF,qBAAqB,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,IAAI,CACjE,CAAC;QACN,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,CAAC,IAAY;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,GAAG,CAAC,IAAY;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;CACJ;AAED,eAAe,aAAa,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/tools/agent/registry.ts"],"names":[],"mappings":"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"}

package/dist/tools/agent/report-group.d.ts

@@ -0,0 +1,5 @@
+import { MCPTool } from "../../core/mcp.js";
+import type AgentToolsRegistry from "./registry.js";
+export declare const AgentReportGroupTool: (registry: AgentToolsRegistry) => MCPTool;
+export default AgentReportGroupTool;
+//# sourceMappingURL=report-group.d.ts.map

package/dist/tools/agent/report-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-group.d.ts","sourceRoot":"","sources":["../../../src/tools/agent/report-group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,kBAAkB,MAAM,eAAe,CAAC;AAEpD,eAAO,MAAM,oBAAoB,GAAI,UAAU,kBAAkB,YAuD/D,CAAC;AAEH,eAAe,oBAAoB,CAAC"}

package/dist/tools/agent/report-group.js

@@ -0,0 +1,50 @@
+import { MCPTool } from "../../core/mcp.js";
+export const AgentReportGroupTool = (registry) => new MCPTool({
+    name: "agent-report-group",
+    description: "send a message to every other agent in your group — a decision you made, an interface you settled on, something you found that changes their work. Your parent does not see it, so this is not a substitute for agent-report-parent. You keep working after sending; it does not end your turn.",
+    inputs: [
+        {
+            name: "message",
+            type: "string",
+            description: "what your group needs to know, written to stand on its own — they cannot see your conversation",
+            required: true,
+        },
+        {
+            name: "group",
+            type: "string",
+            description: "which of your groups to send to. Only needed if you belong to more than one; otherwise your only group is used.",
+            required: false,
+        },
+    ],
+    execute: async (_envID, inputs) => {
+        const { message, group } = inputs;
+        if (!message || typeof message !== "string") {
+            throw new Error("message must be a non-empty string");
+        }
+        if (group !== undefined && typeof group !== "string") {
+            throw new Error("group must be a string when given");
+        }
+        const { controller, agentId } = registry.requireCaller();
+        const self = registry.requireAgent(controller, agentId);
+        if (self.groups.length === 0) {
+            throw new Error("you are not in any group — only agents hired into a group can send group messages.");
+        }
+        if (group !== undefined && !self.groups.includes(group)) {
+            throw new Error(`you are not in group "${group}" — your groups: ${self.groups.join(", ")}.`);
+        }
+        if (group === undefined && self.groups.length > 1) {
+            throw new Error(`you belong to more than one group, so name the one to send to: ${self.groups.join(", ")}.`);
+        }
+        const target = group ?? self.groups[0];
+        const members = controller.listAgents()
+            .filter(a => a.active && a.agentId !== agentId && a.groups.includes(target))
+            .map(a => a.agentId);
+        await registry.request("agent-report-group", agentId, {
+            to: members,
+            message: `[group "${target}" message from ${agentId} (${self.type})]\n${message}`,
+        });
+        return { delivered: true, group: target, to: members };
+    },
+});
+export default AgentReportGroupTool;
+//# sourceMappingURL=report-group.js.map

package/dist/tools/agent/report-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-group.js","sourceRoot":"","sources":["../../../src/tools/agent/report-group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG5C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,QAA4B,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC;IAC9E,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EAAE,iSAAiS;IAC9S,MAAM,EAAE;QACJ;YACI,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gGAAgG;YAC7G,QAAQ,EAAE,IAAI;SACjB;QACD;YACI,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,iHAAiH;YAC9H,QAAQ,EAAE,KAAK;SAClB;KACJ;IACD,OAAO,EAAE,KAAK,EACV,MAAc,EACd,MAA2B,EACf,EAAE;QACd,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QAElC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;QACzD,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAExD,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,oFAAoF,CAAC,CAAC;QAC1G,CAAC;QACD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,oBAAoB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjG,CAAC;QACD,IAAI,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,kEAAkE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjH,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,EAAE;aAClC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,KAAK,OAAO,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;aAC3E,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAEzB,MAAM,QAAQ,CAAC,OAAO,CAAC,oBAAoB,EAAE,OAAO,EAAE;YAClD,EAAE,EAAE,OAAO;YACX,OAAO,EAAE,WAAW,MAAM,kBAAkB,OAAO,KAAK,IAAI,CAAC,IAAI,OAAO,OAAO,EAAE;SACpF,CAAC,CAAC;QAEH,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;IAC3D,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,oBAAoB,CAAC"}

package/dist/tools/agent/report-parent.d.ts

@@ -0,0 +1,5 @@
+import { MCPTool } from "../../core/mcp.js";
+import type AgentToolsRegistry from "./registry.js";
+export declare const AgentReportParentTool: (registry: AgentToolsRegistry) => MCPTool;
+export default AgentReportParentTool;
+//# sourceMappingURL=report-parent.d.ts.map

package/dist/tools/agent/report-parent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-parent.d.ts","sourceRoot":"","sources":["../../../src/tools/agent/report-parent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,kBAAkB,MAAM,eAAe,CAAC;AAEpD,eAAO,MAAM,qBAAqB,GAAI,UAAU,kBAAkB,YAyChE,CAAC;AAEH,eAAe,qBAAqB,CAAC"}

package/dist/tools/agent/report-parent.js

@@ -0,0 +1,36 @@
+import { MCPTool } from "../../core/mcp.js";
+export const AgentReportParentTool = (registry) => new MCPTool({
+    name: "agent-report-parent",
+    description: "report your result back to the agent that hired you, then stop. This ends your current turn immediately — do not call another tool or add commentary after it. Your parent decides what happens next: it may send you more work, or leave you idle.",
+    inputs: [
+        {
+            name: "report",
+            type: "string",
+            description: "the result, findings, or answer to hand back — written to stand on its own, since your parent cannot see your conversation or your reasoning",
+            required: true,
+        },
+    ],
+    stopIterationAfterUsingThisTool: true,
+    execute: async (_envID, inputs) => {
+        const { report } = inputs;
+        if (!report || typeof report !== "string") {
+            throw new Error("report must be a non-empty string");
+        }
+        const { controller, agentId } = registry.requireCaller();
+        const self = registry.requireAgent(controller, agentId);
+        if (!self.parentId) {
+            throw new Error("you have no parent to report to — you are this swarm's entrypoint agent, so your answer goes to the user directly.");
+        }
+        const parent = registry.requireAgent(controller, self.parentId);
+        if (!parent.active) {
+            throw new Error(`the agent that hired you (${self.parentId}) is no longer active, so there is nobody to report to.`);
+        }
+        await registry.request("agent-report-parent", agentId, {
+            to: [parent.agentId],
+            message: `[report from ${agentId} (${self.type}), an agent you hired]\n${report}`,
+        });
+        return { delivered: true, to: parent.agentId };
+    },
+});
+export default AgentReportParentTool;
+//# sourceMappingURL=report-parent.js.map

package/dist/tools/agent/report-parent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-parent.js","sourceRoot":"","sources":["../../../src/tools/agent/report-parent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,QAA4B,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC;IAC/E,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,qPAAqP;IAClQ,MAAM,EAAE;QACJ;YACI,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,8IAA8I;YAC3J,QAAQ,EAAE,IAAI;SACjB;KACJ;IACD,+BAA+B,EAAE,IAAI;IACrC,OAAO,EAAE,KAAK,EACV,MAAc,EACd,MAA2B,EACf,EAAE;QACd,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QAE1B,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;QACzD,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAExD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,oHAAoH,CAAC,CAAC;QAC1I,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,CAAC,QAAQ,yDAAyD,CAAC,CAAC;QACzH,CAAC;QAED,MAAM,QAAQ,CAAC,OAAO,CAAC,qBAAqB,EAAE,OAAO,EAAE;YACnD,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC;YACpB,OAAO,EAAE,gBAAgB,OAAO,KAAK,IAAI,CAAC,IAAI,2BAA2B,MAAM,EAAE;SACpF,CAAC,CAAC;QAEH,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IACnD,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,qBAAqB,CAAC"}

package/dist/tools/agent/types.d.ts

@@ -0,0 +1,5 @@
+import { MCPTool } from "../../core/mcp.js";
+import type AgentToolsRegistry from "./registry.js";
+export declare const AgentTypesTool: (registry: AgentToolsRegistry) => MCPTool;
+export default AgentTypesTool;
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/agent/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/agent/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,kBAAkB,MAAM,eAAe,CAAC;AAEpD,eAAO,MAAM,cAAc,GAAI,UAAU,kBAAkB,YAczD,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/dist/tools/agent/types.js

@@ -0,0 +1,17 @@
+import { MCPTool } from "../../core/mcp.js";
+export const AgentTypesTool = (registry) => new MCPTool({
+    name: "agent-types",
+    description: "list every kind of agent you can hire into this swarm, with what each is good at, its per-task fit ratings, how many of that kind are already working, and how many hire slots remain. Check this before agent-hire so you pick the type that actually fits the task.",
+    inputs: [],
+    execute: async () => {
+        const controller = registry.requireController();
+        return {
+            types: controller.listTypes(),
+            hired: registry.countHired(),
+            maxHired: registry.getMaxHired() ?? null,
+            remaining: registry.getRemaining() ?? null,
+        };
+    },
+});
+export default AgentTypesTool;
+//# sourceMappingURL=types.js.map

package/dist/tools/agent/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/agent/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG5C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAA4B,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC;IACxE,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,uQAAuQ;IACpR,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,KAAK,IAAkB,EAAE;QAC9B,MAAM,UAAU,GAAG,QAAQ,CAAC,iBAAiB,EAAE,CAAC;QAEhD,OAAO;YACH,KAAK,EAAE,UAAU,CAAC,SAAS,EAAE;YAC7B,KAAK,EAAE,QAAQ,CAAC,UAAU,EAAE;YAC5B,QAAQ,EAAE,QAAQ,CAAC,WAAW,EAAE,IAAI,IAAI;YACxC,SAAS,EAAE,QAAQ,CAAC,YAAY,EAAE,IAAI,IAAI;SAC7C,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,cAAc,CAAC"}