orbitx 0.2.1 → 0.2.3

package/dist/core/worker-agent.d.ts

@@ -0,0 +1,43 @@
+import BaseAgent from "./base-agent.js";
+/**
+ * Per-task-type fit score for a WorkerAgent, e.g. `{ backend: 9, frontend: 4,
+ * "3d-web": 10 }`. Keys are free-form task-type labels chosen by whoever
+ * builds the roster; there's no fixed enum since "what counts as a task
+ * type" is app-specific. Convention (not enforced): 0-10, higher is a
+ * better fit. AgentListTool hands this straight to the hiring agent so it
+ * can judge which worker fits a given task.
+ */
+export type WorkerAgentRating = Record<string, number>;
+/**
+ * EXPERIMENTAL: this class, and the agent-management tools built on it
+ * (src/tools/agent/), are new and still settling — names and behavior may
+ * change in a future release.
+ *
+ * A BaseAgent with an identity a *hiring* agent can reason about — name,
+ * description (persona/specialty), and a rating per task type — so it can
+ * be listed, compared against other workers, and hired via the tools in
+ * `src/tools/agent/` (see AgentTools()). Everything about running it (tool
+ * dispatch, memory, streaming) is unchanged from BaseAgent; WorkerAgent only
+ * adds metadata on top.
+ *
+ * Like BaseAgent, this is a raw building block: you still bring your own
+ * `mcpClient`/`allowedTools`. If you want this worker to be able to report
+ * back to whoever hired it, include AgentReportTool() (from
+ * `src/tools/agent/`) in its own tools, same as any other tool.
+ */
+export declare class WorkerAgent extends BaseAgent {
+    #private;
+    constructor({ name, description, rating, ...baseAgentOptions }: {
+        /** Unique identifier used by AgentTools() to hire/prompt this worker — must be unique across whatever roster it's included in. */
+        name: string;
+        /** Persona/specialty shown to the hiring agent via agent-list — what this worker is good at, written for the model to judge fit from, not just a human label. */
+        description: string;
+        /** Per-task-type fit score — see WorkerAgentRating. Defaults to empty (no stated specialty). */
+        rating?: WorkerAgentRating;
+    } & ConstructorParameters<typeof BaseAgent>[0]);
+    getName(): string;
+    getDescription(): string;
+    getRating(): WorkerAgentRating;
+}
+export default WorkerAgent;
+//# sourceMappingURL=worker-agent.d.ts.map

package/dist/core/worker-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-agent.d.ts","sourceRoot":"","sources":["../../src/core/worker-agent.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,iBAAiB,CAAC;AAExC;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEvD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,WAAY,SAAQ,SAAS;;gBAK1B,EACR,IAAI,EACJ,WAAW,EACX,MAAW,EACX,GAAG,gBAAgB,EACtB,EAAE;QACC,kIAAkI;QAClI,IAAI,EAAE,MAAM,CAAC;QACb,iKAAiK;QACjK,WAAW,EAAE,MAAM,CAAC;QACpB,gGAAgG;QAChG,MAAM,CAAC,EAAE,iBAAiB,CAAC;KAC9B,GAAG,qBAAqB,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;IAO9C,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,SAAS,IAAI,iBAAiB;CAGjC;AAED,eAAe,WAAW,CAAC"}

package/dist/core/worker-agent.js

@@ -0,0 +1,40 @@
+import BaseAgent from "./base-agent.js";
+/**
+ * EXPERIMENTAL: this class, and the agent-management tools built on it
+ * (src/tools/agent/), are new and still settling — names and behavior may
+ * change in a future release.
+ *
+ * A BaseAgent with an identity a *hiring* agent can reason about — name,
+ * description (persona/specialty), and a rating per task type — so it can
+ * be listed, compared against other workers, and hired via the tools in
+ * `src/tools/agent/` (see AgentTools()). Everything about running it (tool
+ * dispatch, memory, streaming) is unchanged from BaseAgent; WorkerAgent only
+ * adds metadata on top.
+ *
+ * Like BaseAgent, this is a raw building block: you still bring your own
+ * `mcpClient`/`allowedTools`. If you want this worker to be able to report
+ * back to whoever hired it, include AgentReportTool() (from
+ * `src/tools/agent/`) in its own tools, same as any other tool.
+ */
+export class WorkerAgent extends BaseAgent {
+    #name;
+    #description;
+    #rating;
+    constructor({ name, description, rating = {}, ...baseAgentOptions }) {
+        super(baseAgentOptions);
+        this.#name = name;
+        this.#description = description;
+        this.#rating = rating;
+    }
+    getName() {
+        return this.#name;
+    }
+    getDescription() {
+        return this.#description;
+    }
+    getRating() {
+        return this.#rating;
+    }
+}
+export default WorkerAgent;
+//# sourceMappingURL=worker-agent.js.map

package/dist/core/worker-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-agent.js","sourceRoot":"","sources":["../../src/core/worker-agent.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,iBAAiB,CAAC;AAYxC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,WAAY,SAAQ,SAAS;IACtC,KAAK,CAAS;IACd,YAAY,CAAS;IACrB,OAAO,CAAoB;IAE3B,YAAY,EACR,IAAI,EACJ,WAAW,EACX,MAAM,GAAG,EAAE,EACX,GAAG,gBAAgB,EAQuB;QAC1C,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IAC1B,CAAC;IAED,OAAO;QACH,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,cAAc;QACV,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAED,SAAS;QACL,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;CACJ;AAED,eAAe,WAAW,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export { AIProvider } from "./core/ai-provider.js";
 export type { ChatResponse, Message, StreamCallback, ToolSchema, ToolCallRequest, MessageContentPart, ProviderCapabilities } from "./core/ai-provider.js";
+export { resolveThinkEffortLevel, clampThinkEffort } from "./core/think-effort.js";
+export type { ThinkEffortLevel } from "./core/think-effort.js";
 export { BaseAgent } from "./core/base-agent.js";
 export type { ExtractedSegment, ParsedToolCall } from "./core/base-agent.js";
 export { DeepSeekProvider } from "./core/deepseek-provider.js";
@@ -24,6 +26,10 @@ export { MCPStorage } from "./core/mcp-storage.js";
 export { MCPFSStorage } from "./core/mcp-fs-storage.js";
 export { MCPFilter } from "./core/mcp-filter.js";
 export { SimpleAgent } from "./templates/simple.js";
+export { WorkerAgent } from "./core/worker-agent.js";
+export type { WorkerAgentRating } from "./core/worker-agent.js";
+export { AgentTools, AgentListTool, AgentHireTool, AgentPromptTool, AgentReportTool, AgentRegistry, AgentInteraction, } from "./tools/agent/index.js";
+export type { AgentInfo, AgentEvent, AgentToolsOptions } from "./tools/agent/index.js";
 export { GetCurrentTimeTool, DelayTool, UtilTools } from "./tools/utils/index.js";
 export { TodoCreateListTool, TodoRemoveListTool, TodoGetListsTool, TodoGetListTool, TodoCreateTaskTool, TodoRemoveTaskTool, TodoCheckTaskTool, TodoTools, TodoInteraction, } from "./tools/todo/index.js";
 export type { TodoTask, TodoList, TodoEvent } from "./tools/todo/index.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export { AIProvider } from "./core/ai-provider.js";
+export { resolveThinkEffortLevel, clampThinkEffort } from "./core/think-effort.js";
 export { BaseAgent } from "./core/base-agent.js";
 export { DeepSeekProvider } from "./core/deepseek-provider.js";
 export { OpenAIProvider } from "./core/openai-provider.js";
@@ -20,6 +21,8 @@ export { MCPStorage } from "./core/mcp-storage.js";
 export { MCPFSStorage } from "./core/mcp-fs-storage.js";
 export { MCPFilter } from "./core/mcp-filter.js";
 export { SimpleAgent } from "./templates/simple.js";
+export { WorkerAgent } from "./core/worker-agent.js";
+export { AgentTools, AgentListTool, AgentHireTool, AgentPromptTool, AgentReportTool, AgentRegistry, AgentInteraction, } from "./tools/agent/index.js";
 export { GetCurrentTimeTool, DelayTool, UtilTools } from "./tools/utils/index.js";
 export { TodoCreateListTool, TodoRemoveListTool, TodoGetListsTool, TodoGetListTool, TodoCreateTaskTool, TodoRemoveTaskTool, TodoCheckTaskTool, TodoTools, TodoInteraction, } from "./tools/todo/index.js";
 export { BrowserCreateSessionTool, BrowserRemoveSessionTool, BrowserGetSessionsTool, BrowserNavigateTool, BrowserConsoleTool, BrowserInjectTool, BrowserReadTool, BrowserClickTool, BrowserFillTool, BrowserScrollInfoTool, BrowserScrollTool, BrowserNetworkStatusTool, BrowserNetworkTool, BrowserSubmitFormTool, BrowserScreenshotTool, BrowserTools, BrowserInteraction, } from "./tools/browser/index.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/tests/index.d.ts

@@ -4,4 +4,5 @@ import "./core/mcp-ipc-connection.test.js";
 import "./core/mcp-ws-connection.test.js";
 import "./tools/utils/delay.test.js";
 import "./tools/utils/get-current-time.test.js";
+import "./tools/agent/agent-tools.test.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/tests/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tests/index.ts"],"names":[],"mappings":"AAAA,OAAO,6BAA6B,CAAC;AACrC,OAAO,+BAA+B,CAAC;AACvC,OAAO,mCAAmC,CAAC;AAC3C,OAAO,kCAAkC,CAAC;AAG1C,OAAO,6BAA6B,CAAC;AACrC,OAAO,wCAAwC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tests/index.ts"],"names":[],"mappings":"AAAA,OAAO,6BAA6B,CAAC;AACrC,OAAO,+BAA+B,CAAC;AACvC,OAAO,mCAAmC,CAAC;AAC3C,OAAO,kCAAkC,CAAC;AAG1C,OAAO,6BAA6B,CAAC;AACrC,OAAO,wCAAwC,CAAC;AAChD,OAAO,mCAAmC,CAAC"}

package/dist/tests/index.js

@@ -4,4 +4,5 @@ import "./core/mcp-ipc-connection.test.js";
 import "./core/mcp-ws-connection.test.js";
 import "./tools/utils/delay.test.js";
 import "./tools/utils/get-current-time.test.js";
+import "./tools/agent/agent-tools.test.js";
 //# sourceMappingURL=index.js.map

package/dist/tests/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tests/index.ts"],"names":[],"mappings":"AAAA,OAAO,6BAA6B,CAAC;AACrC,OAAO,+BAA+B,CAAC;AACvC,OAAO,mCAAmC,CAAC;AAC3C,OAAO,kCAAkC,CAAC;AAG1C,OAAO,6BAA6B,CAAC;AACrC,OAAO,wCAAwC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tests/index.ts"],"names":[],"mappings":"AAAA,OAAO,6BAA6B,CAAC;AACrC,OAAO,+BAA+B,CAAC;AACvC,OAAO,mCAAmC,CAAC;AAC3C,OAAO,kCAAkC,CAAC;AAG1C,OAAO,6BAA6B,CAAC;AACrC,OAAO,wCAAwC,CAAC;AAChD,OAAO,mCAAmC,CAAC"}

package/dist/tests/tools/agent/agent-tools.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-tools.test.d.ts.map

package/dist/tests/tools/agent/agent-tools.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tools.test.d.ts","sourceRoot":"","sources":["../../../../src/tests/tools/agent/agent-tools.test.ts"],"names":[],"mappings":""}

package/dist/tests/tools/agent/agent-tools.test.js

@@ -0,0 +1,156 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { AIProvider, AgentReportTool, AgentTools, MCPClient, MCPConnection, MCPServer, WorkerAgent, } from "../../../index.js";
+/**
+ * Returns a fixed, scripted response (or repeats the last one once
+ * exhausted) instead of calling a real model — lets the agent-management
+ * tools be tested end to end (hire -> prompt -> worker's own tool loop ->
+ * report) with no network access.
+ */
+class ScriptedProvider extends AIProvider {
+    #responses;
+    #calls = 0;
+    constructor(responses) {
+        super();
+        this.#responses = responses;
+    }
+    async chat(_messages, streamCallback, _tools) {
+        const response = this.#responses[Math.min(this.#calls, this.#responses.length - 1)];
+        this.#calls++;
+        if (streamCallback) {
+            if (response.content) {
+                await streamCallback({ role: "assistant", content: response.content, done: false });
+            }
+            await streamCallback({
+                role: "assistant",
+                content: "",
+                done: true,
+                ...(response.toolCalls?.length ? { toolCalls: response.toolCalls } : {}),
+            });
+        }
+        return response;
+    }
+    getCapabilities() {
+        return { supportsTools: true, supportsImages: false, contextWindow: 200_000, safeUsageRatio: 0.9 };
+    }
+}
+function buildWorker(name, description, responses) {
+    const connection = new MCPConnection();
+    const server = new MCPServer(connection);
+    const reportTool = AgentReportTool();
+    server.registerTool(reportTool);
+    const mcpClient = new MCPClient(`worker-${name}`, connection);
+    return new WorkerAgent({
+        name,
+        description,
+        rating: { backend: 8, frontend: 3 },
+        instruction: "You are a worker agent.",
+        aiProvider: new ScriptedProvider(responses),
+        mcpClient,
+        allowedTools: [reportTool],
+    });
+}
+test("AgentTools: agent-list shows every worker, unhired by default", async () => {
+    const worker = buildWorker("backend-worker", "Handles backend tasks.", [{ content: "unused", inputTokens: 0, outputTokens: 0 }]);
+    const [listTool] = AgentTools([worker]);
+    const result = await listTool.getOptions().execute("env", {});
+    assert.strictEqual(result.agents.length, 1);
+    assert.strictEqual(result.agents[0].name, "backend-worker");
+    assert.strictEqual(result.agents[0].description, "Handles backend tasks.");
+    assert.deepStrictEqual(result.agents[0].rating, { backend: 8, frontend: 3 });
+    assert.strictEqual(result.agents[0].hired, false);
+});
+test("AgentTools: agent-hire marks a worker hired, reflected in agent-list", async () => {
+    const worker = buildWorker("backend-worker", "Handles backend tasks.", [{ content: "unused", inputTokens: 0, outputTokens: 0 }]);
+    const [listTool, hireTool] = AgentTools([worker]);
+    const hireResult = await hireTool.getOptions().execute("env", { name: "backend-worker" });
+    assert.deepStrictEqual(hireResult, { hired: true, name: "backend-worker" });
+    const listResult = await listTool.getOptions().execute("env", {});
+    assert.strictEqual(listResult.agents[0].hired, true);
+});
+test("AgentTools: agent-hire on an unknown name throws", async () => {
+    const worker = buildWorker("backend-worker", "Handles backend tasks.", [{ content: "unused", inputTokens: 0, outputTokens: 0 }]);
+    const [, hireTool] = AgentTools([worker]);
+    await assert.rejects(() => hireTool.getOptions().execute("env", { name: "nonexistent" }), /no worker agent named "nonexistent"/);
+});
+test("AgentTools: agent-prompt on a worker that isn't hired yet throws", async () => {
+    const worker = buildWorker("backend-worker", "Handles backend tasks.", [{ content: "unused", inputTokens: 0, outputTokens: 0 }]);
+    const [, , promptTool] = AgentTools([worker]);
+    await assert.rejects(() => promptTool.getOptions().execute("env", { name: "backend-worker", prompt: "do it" }), /is not hired yet/);
+});
+test("AgentTools: agent-prompt runs the worker and returns its agent-report text", async () => {
+    const reportCall = { id: "call-1", name: "agent-report", inputs: { report: "answer is 42" } };
+    const worker = buildWorker("backend-worker", "Handles backend tasks.", [
+        { content: "", inputTokens: 10, outputTokens: 5, toolCalls: [reportCall] },
+    ]);
+    const [, hireTool, promptTool] = AgentTools([worker]);
+    await hireTool.getOptions().execute("env", { name: "backend-worker" });
+    const result = await promptTool.getOptions().execute("env", { name: "backend-worker", prompt: "what is the answer?" });
+    assert.strictEqual(result.reported, true);
+    assert.strictEqual(result.report, "answer is 42");
+});
+test("AgentTools: agent-prompt falls back to the worker's last assistant text when it never calls agent-report", async () => {
+    const worker = buildWorker("backend-worker", "Handles backend tasks.", [
+        { content: "I looked into it, no tool needed.", inputTokens: 10, outputTokens: 5 },
+    ]);
+    const [, hireTool, promptTool] = AgentTools([worker]);
+    await hireTool.getOptions().execute("env", { name: "backend-worker" });
+    const result = await promptTool.getOptions().execute("env", { name: "backend-worker", prompt: "check something" });
+    assert.strictEqual(result.reported, false);
+    assert.strictEqual(result.report, "I looked into it, no tool needed.");
+});
+test("AgentTools: a second agent-prompt call doesn't resurface a stale report from the first call", async () => {
+    const reportCall = { id: "call-1", name: "agent-report", inputs: { report: "first answer" } };
+    const worker = buildWorker("backend-worker", "Handles backend tasks.", [
+        { content: "", inputTokens: 10, outputTokens: 5, toolCalls: [reportCall] },
+        { content: "just acknowledging, no report this time", inputTokens: 10, outputTokens: 5 },
+    ]);
+    const [, hireTool, promptTool] = AgentTools([worker]);
+    await hireTool.getOptions().execute("env", { name: "backend-worker" });
+    await promptTool.getOptions().execute("env", { name: "backend-worker", prompt: "first task" });
+    const second = await promptTool.getOptions().execute("env", { name: "backend-worker", prompt: "second task" });
+    assert.strictEqual(second.reported, false);
+    assert.strictEqual(second.report, "just acknowledging, no report this time");
+});
+test("AgentTools: duplicate worker names are rejected at construction", async () => {
+    const workerA = buildWorker("dup", "A", [{ content: "x", inputTokens: 0, outputTokens: 0 }]);
+    const workerB = buildWorker("dup", "B", [{ content: "x", inputTokens: 0, outputTokens: 0 }]);
+    assert.throws(() => AgentTools([workerA, workerB]), /duplicate worker agent name "dup"/);
+});
+test("AgentTools: maxHired is mentioned dynamically in agent-hire's description", async () => {
+    const worker = buildWorker("backend-worker", "Handles backend tasks.", [{ content: "x", inputTokens: 0, outputTokens: 0 }]);
+    const [, hireTool] = AgentTools([worker], { maxHired: 2 });
+    assert.match(hireTool.getOptions().description, /At most 2 worker agents may be hired at once/);
+});
+test("AgentTools: agent-hire has no limit note when maxHired is omitted", async () => {
+    const worker = buildWorker("backend-worker", "Handles backend tasks.", [{ content: "x", inputTokens: 0, outputTokens: 0 }]);
+    const [, hireTool] = AgentTools([worker]);
+    assert.doesNotMatch(hireTool.getOptions().description, /At most/);
+});
+test("AgentTools: hiring beyond maxHired throws, but re-hiring an already-hired worker doesn't count against it", async () => {
+    const workerA = buildWorker("worker-a", "A", [{ content: "x", inputTokens: 0, outputTokens: 0 }]);
+    const workerB = buildWorker("worker-b", "B", [{ content: "x", inputTokens: 0, outputTokens: 0 }]);
+    const workerC = buildWorker("worker-c", "C", [{ content: "x", inputTokens: 0, outputTokens: 0 }]);
+    const [listTool, hireTool] = AgentTools([workerA, workerB, workerC], { maxHired: 1 });
+    await hireTool.getOptions().execute("env", { name: "worker-a" });
+    // re-hiring the same worker is a no-op, must not count twice against the limit
+    await hireTool.getOptions().execute("env", { name: "worker-a" });
+    await assert.rejects(() => hireTool.getOptions().execute("env", { name: "worker-b" }), /maximum of 1 hired agent\(s\) already reached/);
+    const listResult = await listTool.getOptions().execute("env", {});
+    assert.strictEqual(listResult.hiredCount, 1);
+    assert.strictEqual(listResult.maxHired, 1);
+});
+test("AgentTools: agent-list omits maxHired when no limit was configured", async () => {
+    const worker = buildWorker("backend-worker", "Handles backend tasks.", [{ content: "x", inputTokens: 0, outputTokens: 0 }]);
+    const [listTool] = AgentTools([worker]);
+    const result = await listTool.getOptions().execute("env", {});
+    assert.strictEqual(result.hiredCount, 0);
+    assert.strictEqual("maxHired" in result, false);
+});
+test("AgentTools: maxHired must be a positive integer when given", async () => {
+    const worker = buildWorker("backend-worker", "Handles backend tasks.", [{ content: "x", inputTokens: 0, outputTokens: 0 }]);
+    assert.throws(() => AgentTools([worker], { maxHired: 0 }), /maxHired must be a positive integer/);
+    assert.throws(() => AgentTools([worker], { maxHired: -1 }), /maxHired must be a positive integer/);
+    assert.throws(() => AgentTools([worker], { maxHired: 1.5 }), /maxHired must be a positive integer/);
+});
+//# sourceMappingURL=agent-tools.test.js.map

package/dist/tests/tools/agent/agent-tools.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tools.test.js","sourceRoot":"","sources":["../../../../src/tests/tools/agent/agent-tools.test.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,6 @@
+import { MCPTool } from "../../core/mcp.js";
+import { AgentInteraction } from "./interaction.js";
+import type AgentRegistry from "./registry.js";
+export declare const AgentHireTool: (registry: AgentRegistry) => MCPTool<AgentInteraction>;
+export default AgentHireTool;
+//# sourceMappingURL=hire.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hire.d.ts","sourceRoot":"","sources":["../../../src/tools/agent/hire.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,aAAa,MAAM,eAAe,CAAC;AAE/C,eAAO,MAAM,aAAa,GAAI,UAAU,aAAa,8BAoCpD,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/tools/agent/hire.js

@@ -0,0 +1,32 @@
+import { MCPTool } from "../../core/mcp.js";
+import { AgentInteraction } from "./interaction.js";
+export const AgentHireTool = (registry) => {
+    const maxHired = registry.getMaxHired();
+    const limitNote = maxHired !== undefined
+        ? ` At most ${maxHired} worker agent${maxHired === 1 ? "" : "s"} may be hired at once — hiring beyond that will fail until fewer than ${maxHired} are currently hired, so choose which agent(s) to hire carefully.`
+        : "";
+    return new MCPTool({
+        name: "agent-hire",
+        description: `hire a worker agent by name (see agent-list), making it active. Required once per agent before agent-prompt will work on it — hiring the same agent again is a harmless no-op.${limitNote}`,
+        inputs: [
+            {
+                name: "name",
+                type: "string",
+                description: "the worker agent's name, exactly as shown by agent-list",
+                required: true,
+            },
+        ],
+        customClass: new AgentInteraction(),
+        execute: async (_envID, inputs, _mcp, customClass) => {
+            const { name } = inputs;
+            if (!name || typeof name !== "string") {
+                throw new Error("name must be a non-empty string");
+            }
+            registry.hire(name);
+            customClass?.emitAgentEvent({ type: "hired", name });
+            return { hired: true, name };
+        },
+    });
+};
+export default AgentHireTool;
+//# sourceMappingURL=hire.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hire.js","sourceRoot":"","sources":["../../../src/tools/agent/hire.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAuB,EAAE,EAAE;IACrD,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACxC,MAAM,SAAS,GAAG,QAAQ,KAAK,SAAS;QACpC,CAAC,CAAC,YAAY,QAAQ,gBAAgB,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,yEAAyE,QAAQ,mEAAmE;QACnN,CAAC,CAAC,EAAE,CAAC;IAET,OAAO,IAAI,OAAO,CAAmB;QACjC,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,iLAAiL,SAAS,EAAE;QACzM,MAAM,EAAE;YACJ;gBACI,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yDAAyD;gBACtE,QAAQ,EAAE,IAAI;aACjB;SACJ;QACD,WAAW,EAAE,IAAI,gBAAgB,EAAE;QACnC,OAAO,EAAE,KAAK,EACV,MAAc,EACd,MAA2B,EAC3B,IAAU,EACV,WAA8B,EAClB,EAAE;YACd,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;YAExB,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;YACvD,CAAC;YAED,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,WAAW,EAAE,cAAc,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAErD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACjC,CAAC;KACJ,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,eAAe,aAAa,CAAC"}

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

@@ -0,0 +1,27 @@
+export { AgentListTool } from "./list.js";
+export { AgentHireTool } from "./hire.js";
+export { AgentPromptTool } from "./prompt.js";
+export { AgentReportTool } from "./report.js";
+export { AgentRegistry } from "./registry.js";
+export { AgentInteraction } from "./interaction.js";
+export type { AgentInfo } from "./registry.js";
+export type { AgentEvent } from "./interaction.js";
+import type WorkerAgent from "../../core/worker-agent.js";
+export interface AgentToolsOptions {
+    /** Cap on how many workers may be hired at once. Omit for no limit. Surfaced dynamically in agent-hire's own description (and in agent-list's output) so the model knows the constraint without being told out of band. */
+    maxHired?: number;
+}
+/**
+ * EXPERIMENTAL — see the note on WorkerAgent (src/core/worker-agent.ts).
+ *
+ * Planner-side tools for a fixed roster of WorkerAgents: list them, hire
+ * one, and prompt a hired one. Each call builds its own AgentRegistry, so
+ * separate AgentTools(...) calls (e.g. for two different planners in the
+ * same process) never share hire state.
+ *
+ * Not included here: AgentReportTool — that one goes on each *worker's*
+ * own tool list instead, not the planner's. Import it separately.
+ */
+export declare const AgentTools: (availableAgents: WorkerAgent[], options?: AgentToolsOptions) => (import("../../index.js").MCPTool<undefined> | import("../../index.js").MCPTool<import("./interaction.js").AgentInteraction>)[];
+export default AgentTools;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,WAAW,MAAM,4BAA4B,CAAC;AAM1D,MAAM,WAAW,iBAAiB;IAC9B,2NAA2N;IAC3N,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,GAAI,iBAAiB,WAAW,EAAE,EAAE,UAAS,iBAAsB,oIAOzF,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/tools/agent/index.js

@@ -0,0 +1,31 @@
+export { AgentListTool } from "./list.js";
+export { AgentHireTool } from "./hire.js";
+export { AgentPromptTool } from "./prompt.js";
+export { AgentReportTool } from "./report.js";
+export { AgentRegistry } from "./registry.js";
+export { AgentInteraction } from "./interaction.js";
+import { AgentListTool } from "./list.js";
+import { AgentHireTool } from "./hire.js";
+import { AgentPromptTool } from "./prompt.js";
+import { AgentRegistry } from "./registry.js";
+/**
+ * EXPERIMENTAL — see the note on WorkerAgent (src/core/worker-agent.ts).
+ *
+ * Planner-side tools for a fixed roster of WorkerAgents: list them, hire
+ * one, and prompt a hired one. Each call builds its own AgentRegistry, so
+ * separate AgentTools(...) calls (e.g. for two different planners in the
+ * same process) never share hire state.
+ *
+ * Not included here: AgentReportTool — that one goes on each *worker's*
+ * own tool list instead, not the planner's. Import it separately.
+ */
+export const AgentTools = (availableAgents, options = {}) => {
+    const registry = new AgentRegistry(availableAgents, options.maxHired);
+    return [
+        AgentListTool(registry),
+        AgentHireTool(registry),
+        AgentPromptTool(registry),
+    ];
+};
+export default AgentTools;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAKpD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAO9C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,eAA8B,EAAE,UAA6B,EAAE,EAAE,EAAE;IAC1F,MAAM,QAAQ,GAAG,IAAI,aAAa,CAAC,eAAe,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACtE,OAAO;QACH,aAAa,CAAC,QAAQ,CAAC;QACvB,aAAa,CAAC,QAAQ,CAAC;QACvB,eAAe,CAAC,QAAQ,CAAC;KAC5B,CAAC;AACN,CAAC,CAAC;AAEF,eAAe,UAAU,CAAC"}

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

@@ -0,0 +1,25 @@
+import { MCPCustomClass } from "../../core/mcp.js";
+export type AgentEvent = {
+    type: "hired";
+    name: string;
+} | {
+    type: "prompted";
+    name: string;
+    prompt: string;
+} | {
+    type: "reported";
+    name: string;
+    reported: boolean;
+    report: string;
+};
+/**
+ * Shared custom interaction class for the agent-management tools. A
+ * frontend can listen on getEvents() to show live status (e.g. "Hiring
+ * backend-worker...", "backend-worker is working...") while the planner
+ * hires and prompts worker agents.
+ */
+export declare class AgentInteraction extends MCPCustomClass {
+    emitAgentEvent(event: AgentEvent): void;
+}
+export default AgentInteraction;
+//# sourceMappingURL=interaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.d.ts","sourceRoot":"","sources":["../../../src/tools/agent/interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,MAAM,UAAU,GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAChD,cAAc,CAAC,KAAK,EAAE,UAAU;CAGnC;AAED,eAAe,gBAAgB,CAAC"}

package/dist/tools/agent/interaction.js

@@ -0,0 +1,14 @@
+import { MCPCustomClass } from "../../core/mcp.js";
+/**
+ * Shared custom interaction class for the agent-management tools. A
+ * frontend can listen on getEvents() to show live status (e.g. "Hiring
+ * backend-worker...", "backend-worker is working...") while the planner
+ * hires and prompts worker agents.
+ */
+export class AgentInteraction extends MCPCustomClass {
+    emitAgentEvent(event) {
+        this.getEvents().emit("agent", event);
+    }
+}
+export default AgentInteraction;
+//# sourceMappingURL=interaction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interaction.js","sourceRoot":"","sources":["../../../src/tools/agent/interaction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAOnD;;;;;GAKG;AACH,MAAM,OAAO,gBAAiB,SAAQ,cAAc;IAChD,cAAc,CAAC,KAAiB;QAC5B,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC1C,CAAC;CACJ;AAED,eAAe,gBAAgB,CAAC"}

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

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

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

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

package/dist/tools/agent/list.js

@@ -0,0 +1,16 @@
+import { MCPTool } from "../../core/mcp.js";
+export const AgentListTool = (registry) => new MCPTool({
+    name: "agent-list",
+    description: "list every worker agent available to hire, with their name, description/persona, per-task-type rating, and whether they're already hired. Check this before hiring — pick whichever agent's rating best fits the task at hand, and check hiredCount against maxHired if there's a hiring limit.",
+    inputs: [],
+    execute: async () => {
+        const maxHired = registry.getMaxHired();
+        return {
+            agents: registry.list(),
+            hiredCount: registry.getHiredCount(),
+            ...(maxHired !== undefined ? { maxHired } : {}),
+        };
+    },
+});
+export default AgentListTool;
+//# sourceMappingURL=list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/tools/agent/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG5C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAuB,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC;IAClE,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,iSAAiS;IAC9S,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,KAAK,IAAkB,EAAE;QAC9B,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACxC,OAAO;YACH,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE;YACvB,UAAU,EAAE,QAAQ,CAAC,aAAa,EAAE;YACpC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClD,CAAC;IACN,CAAC;CACJ,CAAC,CAAC;AAEH,eAAe,aAAa,CAAC"}

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

@@ -0,0 +1,6 @@
+import { MCPTool } from "../../core/mcp.js";
+import { AgentInteraction } from "./interaction.js";
+import type AgentRegistry from "./registry.js";
+export declare const AgentPromptTool: (registry: AgentRegistry) => MCPTool<AgentInteraction>;
+export default AgentPromptTool;
+//# sourceMappingURL=prompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/tools/agent/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAY,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,aAAa,MAAM,eAAe,CAAC;AAE/C,eAAO,MAAM,eAAe,GAAI,UAAU,aAAa,8BAkFrD,CAAC;AAEH,eAAe,eAAe,CAAC"}