orbitx 0.2.9 → 0.3.2

package/dist/tests/agents/default-agents.test.js

@@ -0,0 +1,106 @@
+import { test, describe } from "node:test";
+import assert from "node:assert/strict";
+import { DefaultAgents, PlannerAgent, ReasonerAgent, BackendAgent, FrontendAgent, TestAgent, ResearchAgent, getAgentTools, FsTools, BashTools, BrowserTools, TodoTools, UtilTools, QuestionAnswerTools, } from "../../index.js";
+const pool = () => [
+    ...getAgentTools({ maxHired: 3 }).tools,
+    ...FsTools(),
+    ...BashTools(),
+    ...BrowserTools(),
+    ...TodoTools(),
+    ...UtilTools(),
+    ...QuestionAnswerTools(),
+];
+const toolNames = (factory) => factory({ tools: pool() }).getDefinition().tools.map(t => t.getOptions().name);
+describe("agents/default", () => {
+    test("DefaultAgents is a usable roster covering the whole build pipeline", () => {
+        const tools = pool();
+        const types = DefaultAgents().map(factory => factory({ tools }).getType());
+        assert.deepStrictEqual(types, ["planner", "reasoner", "backend", "frontend", "tester", "research"]);
+    });
+    test("every default definition has a description a hiring model can judge from", () => {
+        const tools = pool();
+        for (const factory of DefaultAgents()) {
+            const { description, instruction, rating } = factory({ tools }).getDefinition();
+            assert.ok(description.length > 40, `${factory.name} description is too thin to hire from`);
+            assert.ok(instruction.length > 100, `${factory.name} instruction is too thin`);
+            assert.ok(rating && Object.keys(rating).length > 0, `${factory.name} has no ratings`);
+        }
+    });
+    test("the planner gets the hiring tools and no way to edit the project itself", () => {
+        const names = toolNames(PlannerAgent);
+        for (const hiring of ["agent-types", "agent-hire", "agent-fire", "agent-active", "agent-prompt"]) {
+            assert.ok(names.includes(hiring), `planner is missing ${hiring}`);
+        }
+        assert.ok(names.includes("fs-read-file"), "planner should still be able to read the project");
+        assert.ok(!names.includes("fs-write-file"), "a planner that can write starts doing the work itself");
+        assert.ok(!names.includes("bash-run"));
+        assert.ok(!names.includes("agent-report-parent"), "the entrypoint has nobody to report to");
+    });
+    test("workers get the reporting tools and not the hiring ones", () => {
+        for (const factory of [ReasonerAgent, BackendAgent, FrontendAgent, TestAgent, ResearchAgent]) {
+            const names = toolNames(factory);
+            assert.ok(names.includes("agent-report-parent"), `${factory.name} cannot report back`);
+            assert.ok(names.includes("agent-report-group"), `${factory.name} cannot talk to its group`);
+            assert.ok(!names.includes("agent-hire"), `${factory.name} should not be hiring`);
+        }
+    });
+    test("each worker picks the tools its own job needs", () => {
+        const backend = toolNames(BackendAgent);
+        assert.ok(backend.includes("fs-write-file") && backend.includes("bash-run"));
+        assert.ok(!backend.includes("browser-navigate"), "backend has no reason to drive a browser");
+        const frontend = toolNames(FrontendAgent);
+        assert.ok(frontend.includes("fs-write-file") && frontend.includes("browser-navigate"));
+        const research = toolNames(ResearchAgent);
+        assert.ok(research.includes("browser-navigate") && research.includes("fs-read-file"));
+        assert.ok(!research.includes("fs-write-file"), "a read-only agent must not be able to write");
+        assert.ok(!research.includes("bash-run"), "a read-only agent must not be able to run commands");
+        const tester = toolNames(TestAgent);
+        assert.ok(tester.includes("bash-run"), "the tester has to be able to build and run what it checks");
+        assert.ok(tester.includes("browser-navigate"), "the tester has to drive the real UI");
+        assert.ok(tester.includes("fs-write-file"), "the tester writes test files, though never production code");
+    });
+    test("the reasoner can measure and pace its own five minutes, and cannot build anything", () => {
+        const names = toolNames(ReasonerAgent);
+        assert.ok(names.includes("get-current-time"), "the panel's clock is measured, not estimated");
+        assert.ok(!names.includes("delay"), "the five minutes are filled with argument — there is nothing to sleep on");
+        assert.ok(names.includes("question-answer"), "the panel interrogates the user before it reasons");
+        assert.ok(names.includes("fs-read-file"), "it should argue about the real project");
+        assert.ok(!names.includes("fs-write-file"), "the reasoner thinks, it does not build");
+        assert.ok(!names.includes("bash-run"));
+    });
+    test("the pipeline the planner describes matches the roster it can hire from", () => {
+        const tools = pool();
+        const instruction = PlannerAgent({ tools }).getDefinition().instruction;
+        const types = DefaultAgents().map(factory => factory({ tools }).getType());
+        for (const type of types.filter(t => t !== "planner" && t !== "research")) {
+            assert.match(instruction, new RegExp(type), `the planner never mentions the ${type} it can hire`);
+        }
+    });
+    test("frontend agents are told how to share a project without overwriting each other", () => {
+        const instruction = FrontendAgent({ tools: pool() }).getDefinition().instruction;
+        assert.match(instruction, /claim your files/i);
+        assert.match(instruction, /never edit a file another agent has claimed/i);
+        assert.match(instruction, /agree on the scaffold/i);
+    });
+    test("a definition only picks what the app actually constructed", () => {
+        const names = BackendAgent({ tools: [...UtilTools()] }).getDefinition().tools.map(t => t.getOptions().name);
+        assert.deepStrictEqual(names, ["get-current-time"]);
+    });
+    test("factory overrides apply on top of the shipped persona", () => {
+        const definition = BackendAgent({
+            tools: pool(),
+            instruction: { append: "This project uses Postgres." },
+            safetyPolicies: "Never touch anything outside /workspace.",
+        }).getDefinition();
+        assert.match(definition.instruction, /You are a backend engineer/);
+        assert.match(definition.instruction, /This project uses Postgres\.$/);
+        assert.strictEqual(definition.safetyPolicies, "Never touch anything outside /workspace.");
+    });
+    test("skills come along with the definition and bring their own tools", () => {
+        const definition = BackendAgent({ tools: pool() });
+        const skills = definition.getDefinition().skills ?? [];
+        assert.ok(skills.length >= 3);
+        assert.ok(definition.getAllTools().length >= definition.getDefinition().tools.length);
+    });
+});
+//# sourceMappingURL=default-agents.test.js.map

package/dist/tests/agents/default-agents.test.js.map

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

package/dist/tests/core/agent-definition.test.d.ts

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

package/dist/tests/core/agent-definition.test.d.ts.map

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

package/dist/tests/core/agent-definition.test.js

@@ -0,0 +1,99 @@
+import { test, describe } from "node:test";
+import assert from "node:assert/strict";
+import { AgentDefinition, applyTextOverride, selectTools, Skill, MCPTool, GetCurrentTimeTool, DelayTool, FsReadFileTool, FsWriteFileTool } from "../../index.js";
+import { ScriptedProvider } from "./scripted-provider.js";
+const pool = () => [GetCurrentTimeTool(), DelayTool(), FsReadFileTool(), FsWriteFileTool()];
+const definition = (tools, extra = {}) => new AgentDefinition({
+    type: "worker",
+    description: "does work",
+    instruction: "BASE INSTRUCTION",
+    safetyPolicies: "BASE POLICY",
+    tools,
+    ...extra,
+});
+describe("core/agent-definition", () => {
+    test("applyTextOverride: undefined keeps the base, a bare string replaces it", () => {
+        assert.strictEqual(applyTextOverride("base"), "base");
+        assert.strictEqual(applyTextOverride("base", "new"), "new");
+        assert.strictEqual(applyTextOverride("base", { replace: "new" }), "new");
+    });
+    test("applyTextOverride: append and prepend keep the base text", () => {
+        assert.strictEqual(applyTextOverride("base", { append: "more" }), "base\n\nmore");
+        assert.strictEqual(applyTextOverride("base", { prepend: "first" }), "first\n\nbase");
+    });
+    test("applyTextOverride: an empty base doesn't leave stray blank lines", () => {
+        assert.strictEqual(applyTextOverride("", { append: "only" }), "only");
+        assert.strictEqual(applyTextOverride("", { prepend: "only" }), "only");
+    });
+    test("selectTools: picks by exact name, in the order asked for", () => {
+        const picked = selectTools(pool(), ["fs-read-file", "get-current-time"]);
+        assert.deepStrictEqual(picked.map(t => t.getOptions().name), ["fs-read-file", "get-current-time"]);
+    });
+    test("selectTools: a trailing * matches by prefix, and duplicates are dropped", () => {
+        const picked = selectTools(pool(), ["fs-*", "fs-read-file"]);
+        assert.deepStrictEqual(picked.map(t => t.getOptions().name), ["fs-read-file", "fs-write-file"]);
+    });
+    test("selectTools: a name the app didn't construct is skipped, not an error", () => {
+        const picked = selectTools(pool(), ["fs-read-file", "browser-navigate"]);
+        assert.deepStrictEqual(picked.map(t => t.getOptions().name), ["fs-read-file"]);
+    });
+    test("with(): returns a new definition and leaves the original untouched", () => {
+        const original = definition(pool());
+        const derived = original.with({ instruction: { append: "EXTRA" }, safetyPolicies: "REPLACED" });
+        assert.notStrictEqual(original, derived);
+        assert.strictEqual(original.getDefinition().instruction, "BASE INSTRUCTION");
+        assert.strictEqual(original.getDefinition().safetyPolicies, "BASE POLICY");
+        assert.strictEqual(derived.getDefinition().instruction, "BASE INSTRUCTION\n\nEXTRA");
+        assert.strictEqual(derived.getDefinition().safetyPolicies, "REPLACED");
+    });
+    test("with(): appends stack in call order, so swarm-wide lands before per-type", () => {
+        const derived = definition(pool())
+            .with({ instruction: { append: "SWARM WIDE" } })
+            .with({ instruction: { append: "PER TYPE" } });
+        assert.strictEqual(derived.getDefinition().instruction, "BASE INSTRUCTION\n\nSWARM WIDE\n\nPER TYPE");
+    });
+    test("with(): extraTools are appended and deduped", () => {
+        const tools = pool();
+        const derived = definition([tools[0]]).with({ extraTools: [tools[1], tools[0]] });
+        assert.deepStrictEqual(derived.getDefinition().tools.map(t => t.getOptions().name), ["get-current-time", "delay"]);
+    });
+    test("with(): no overrides returns the same instance", () => {
+        const original = definition(pool());
+        assert.strictEqual(original.with(), original);
+    });
+    test("getAllTools(): skill tools are merged in, without duplicating a tool already picked", () => {
+        const tools = pool();
+        const skill = new Skill({ name: "s", description: "d", instructions: "i", tools: [tools[0], tools[2]] });
+        const built = definition([tools[0], tools[1]], { skills: [skill] });
+        assert.deepStrictEqual(built.getAllTools().map(t => t.getOptions().name), ["get-current-time", "delay", "fs-read-file"]);
+    });
+    test("buildProps(): the swarm's runtime fills what the definition left open", () => {
+        const provider = new ScriptedProvider("p", () => ({ content: "hi" }));
+        const props = definition(pool()).buildProps({
+            aiProvider: provider,
+            mcpClient: {},
+            maxMemorizeToken: 4242,
+            features: { executeProviderFromMCPTool: true },
+        });
+        assert.strictEqual(props.aiProvider, provider);
+        assert.strictEqual(props.maxMemorizeToken, 4242);
+        assert.deepStrictEqual(props.features, { executeProviderFromMCPTool: true });
+        assert.strictEqual(props.instruction, "BASE INSTRUCTION");
+        assert.strictEqual(props.initData, undefined);
+    });
+    test("buildProps(): a definition's own provider and limits win over the swarm's", () => {
+        const swarmProvider = new ScriptedProvider("swarm", () => ({ content: "hi" }));
+        const ownProvider = new ScriptedProvider("own", () => ({ content: "hi" }));
+        const props = definition(pool(), { aiProvider: ownProvider, maxMemorizeToken: 10 }).buildProps({
+            aiProvider: swarmProvider,
+            mcpClient: {},
+            maxMemorizeToken: 4242,
+        });
+        assert.strictEqual(props.aiProvider, ownProvider);
+        assert.strictEqual(props.maxMemorizeToken, 10);
+    });
+    test("a definition without a type is rejected", () => {
+        assert.throws(() => new AgentDefinition({ type: "", description: "d", instruction: "i", tools: [] }), /`type` is required/);
+    });
+});
+//# sourceMappingURL=agent-definition.test.js.map

package/dist/tests/core/agent-definition.test.js.map

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

package/dist/tests/core/ai-ask.test.d.ts

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

package/dist/tests/core/ai-ask.test.d.ts.map

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

package/dist/tests/core/ai-ask.test.js

@@ -0,0 +1,101 @@
+import { test, describe } from "node:test";
+import assert from "node:assert/strict";
+import { AIASK } from "../../index.js";
+import { ScriptedProvider } from "./scripted-provider.js";
+describe("core/ai-ask", () => {
+    test("run(): a valid first attempt returns immediately with valid:true, attempts:1", async () => {
+        const provider = new ScriptedProvider("p", () => ({
+            toolCalls: [{ name: "submit_answer", inputs: { valid: true, score: 7 } }],
+        }));
+        const ask = new AIASK({
+            instruction: "classify the input",
+            aiModel: provider,
+            outputStructure: [
+                { name: "valid", type: "boolean", description: "whether it's valid" },
+                { name: "score", type: "number", description: "confidence 0-10" },
+            ],
+        });
+        const result = await ask.run("check this");
+        assert.deepStrictEqual(result.output, { valid: true, score: 7 });
+        assert.strictEqual(result.valid, true);
+        assert.strictEqual(result.attempts, 1);
+        assert.strictEqual(result.errors, undefined);
+    });
+    test("run(): a missing required field triggers a retry, and a corrected 2nd attempt succeeds", async () => {
+        const provider = new ScriptedProvider("p", [
+            () => ({ toolCalls: [{ name: "submit_answer", inputs: { valid: true } }] }), // 1st attempt, missing "score"
+            () => ({ toolCalls: [{ name: "submit_answer", inputs: { valid: true, score: 9 } }] }), // 2nd attempt, corrected
+        ]);
+        const ask = new AIASK({
+            instruction: "classify the input",
+            aiModel: provider,
+            outputStructure: [
+                { name: "valid", type: "boolean", description: "whether it's valid" },
+                { name: "score", type: "number", description: "confidence 0-10" },
+            ],
+        });
+        const result = await ask.run("check this");
+        assert.deepStrictEqual(result.output, { valid: true, score: 9 });
+        assert.strictEqual(result.valid, true);
+        assert.strictEqual(result.attempts, 2);
+    });
+    test("run(): a wrong-typed field is rejected as invalid", async () => {
+        const provider = new ScriptedProvider("p", () => ({
+            toolCalls: [{ name: "submit_answer", inputs: { valid: "yes" } }], // should be boolean
+        }));
+        const ask = new AIASK({
+            instruction: "x",
+            aiModel: provider,
+            outputStructure: [{ name: "valid", type: "boolean", description: "d" }],
+        });
+        const result = await ask.run("go");
+        assert.strictEqual(result.valid, false);
+        assert.strictEqual(result.attempts, 3);
+        assert.match(result.errors[0], /should be boolean/);
+    });
+    test("run(): plain text instead of calling the tool counts as a failed attempt and retries", async () => {
+        const provider = new ScriptedProvider("p", [
+            () => ({ content: "I think it's valid" }), // no tool call at all
+            () => ({ toolCalls: [{ name: "submit_answer", inputs: { valid: true } }] }),
+        ]);
+        const ask = new AIASK({
+            instruction: "x",
+            aiModel: provider,
+            outputStructure: [{ name: "valid", type: "boolean", description: "d" }],
+        });
+        const result = await ask.run("go");
+        assert.strictEqual(result.valid, true);
+        assert.strictEqual(result.attempts, 2);
+    });
+    test("run(): gives up after 3 attempts, returning the last best-effort output with valid:false", async () => {
+        const provider = new ScriptedProvider("p", () => ({ content: "nope, just text" }));
+        const ask = new AIASK({
+            instruction: "x",
+            aiModel: provider,
+            outputStructure: [{ name: "valid", type: "boolean", description: "d" }],
+        });
+        const result = await ask.run("go");
+        assert.strictEqual(result.valid, false);
+        assert.strictEqual(result.attempts, 3);
+        assert.deepStrictEqual(result.output, {});
+        assert.strictEqual(result.errors.length, 1);
+        assert.strictEqual(provider.getCallCount(), 3, "one chat() call per attempt, no automatic follow-up");
+    });
+    test("run(): an optional field (required: false) may be omitted without failing validation", async () => {
+        const provider = new ScriptedProvider("p", () => ({
+            toolCalls: [{ name: "submit_answer", inputs: { valid: true } }],
+        }));
+        const ask = new AIASK({
+            instruction: "x",
+            aiModel: provider,
+            outputStructure: [
+                { name: "valid", type: "boolean", description: "d" },
+                { name: "note", type: "string", description: "d", required: false },
+            ],
+        });
+        const result = await ask.run("go");
+        assert.strictEqual(result.valid, true);
+        assert.strictEqual(result.attempts, 1);
+    });
+});
+//# sourceMappingURL=ai-ask.test.js.map

package/dist/tests/core/ai-ask.test.js.map

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

package/dist/tests/core/mcp-auto-execution-policy.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp-auto-execution-policy.test.d.ts.map

package/dist/tests/core/mcp-auto-execution-policy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-auto-execution-policy.test.d.ts","sourceRoot":"","sources":["../../../src/tests/core/mcp-auto-execution-policy.test.ts"],"names":[],"mappings":""}

package/dist/tests/core/mcp-auto-execution-policy.test.js

@@ -0,0 +1,107 @@
+import { test, describe } from "node:test";
+import assert from "node:assert/strict";
+import { MCPAutoExecutionPolicy } from "../../index.js";
+import { ScriptedProvider } from "./scripted-provider.js";
+const request = (overrides = {}) => ({
+    toolName: "bash-run",
+    inputs: { command: "rm -rf /" },
+    envID: "env",
+    toolCallId: "call-1",
+    ...overrides,
+});
+describe("core/mcp-auto-execution-policy", () => {
+    test("authorize(): an unwatched tool is authorized immediately, no model call, no verdict recorded", async () => {
+        const provider = new ScriptedProvider("p", () => ({ content: "should never be called" }));
+        const policy = new MCPAutoExecutionPolicy({ aiModel: provider });
+        const authorized = await policy.authorize(request({ toolName: "get-current-time", inputs: {}, toolCallId: "call-time" }));
+        assert.strictEqual(authorized, true);
+        assert.strictEqual(provider.getCallCount(), 0);
+        assert.strictEqual(policy.getVerdict("call-time"), undefined);
+    });
+    test("authorize(): bash-run always goes to the model — no path field to short-circuit on", async () => {
+        const provider = new ScriptedProvider("p", () => ({
+            toolCalls: [{ name: "submit_answer", inputs: { harmful: true, reason: "destroys the filesystem" } }],
+        }));
+        const policy = new MCPAutoExecutionPolicy({ aiModel: provider });
+        const authorized = await policy.authorize(request());
+        assert.strictEqual(authorized, false);
+        assert.strictEqual(provider.getCallCount(), 1);
+    });
+    test("authorize(): a watched fs call whose path resolves inside scope is authorized locally, no model call", async () => {
+        const provider = new ScriptedProvider("p", () => ({ content: "should never be called" }));
+        const policy = new MCPAutoExecutionPolicy({ aiModel: provider, scopeDir: process.cwd() });
+        const authorized = await policy.authorize(request({
+            toolName: "fs-write-file",
+            inputs: { path: "some/nested/file.txt", content: "hello" },
+            toolCallId: "call-write-in-scope",
+        }));
+        assert.strictEqual(authorized, true);
+        assert.strictEqual(provider.getCallCount(), 0);
+        assert.strictEqual(policy.getVerdict("call-write-in-scope").harmful, false);
+        assert.match(policy.getVerdict("call-write-in-scope").reason, /skipped model review/);
+    });
+    test("authorize(): a watched fs call whose path resolves outside scope escalates to the model", async () => {
+        const provider = new ScriptedProvider("p", () => ({
+            toolCalls: [{ name: "submit_answer", inputs: { harmful: true, reason: "writes outside the project" } }],
+        }));
+        const policy = new MCPAutoExecutionPolicy({ aiModel: provider, scopeDir: process.cwd() });
+        const authorized = await policy.authorize(request({
+            toolName: "fs-write-file",
+            inputs: { path: "../../outside.txt", content: "hello" },
+        }));
+        assert.strictEqual(authorized, false);
+        assert.strictEqual(provider.getCallCount(), 1);
+    });
+    test("authorize(): fs-move requires BOTH from and to inside scope to skip the model", async () => {
+        const provider = new ScriptedProvider("p", () => ({
+            toolCalls: [{ name: "submit_answer", inputs: { harmful: false, reason: "fine" } }],
+        }));
+        const policy = new MCPAutoExecutionPolicy({ aiModel: provider, scopeDir: process.cwd() });
+        await policy.authorize(request({
+            toolName: "fs-move",
+            inputs: { from: "in-scope.txt", to: "../outside.txt" },
+        }));
+        assert.strictEqual(provider.getCallCount(), 1, "one path outside scope forces a model review");
+    });
+    test("authorize(): file content is stripped before it ever reaches the model", async () => {
+        let seenPrompt = "";
+        const provider = new ScriptedProvider("p", ({ messages }) => {
+            seenPrompt = messages.at(-1)?.content ?? "";
+            return { toolCalls: [{ name: "submit_answer", inputs: { harmful: false, reason: "fine" } }] };
+        });
+        const policy = new MCPAutoExecutionPolicy({ aiModel: provider, scopeDir: "/some/other/scope" });
+        await policy.authorize(request({
+            toolName: "fs-write-file",
+            inputs: { path: "secrets.txt", content: "super-secret-password-do-not-leak-this" },
+        }));
+        assert.doesNotMatch(seenPrompt, /super-secret-password-do-not-leak-this/);
+        assert.match(seenPrompt, /omitted, \d+ bytes/);
+    });
+    test("getVerdict() / getLastVerdict() / onVerdict expose the reviewed verdict", async () => {
+        const provider = new ScriptedProvider("p", () => ({
+            toolCalls: [{ name: "submit_answer", inputs: { harmful: true, reason: "irreversible deletion" } }],
+        }));
+        const calls = [];
+        const policy = new MCPAutoExecutionPolicy({ aiModel: provider, onVerdict: (request, verdict) => calls.push({ request, verdict }) });
+        await policy.authorize(request({ toolCallId: "call-42" }));
+        assert.deepStrictEqual(policy.getVerdict("call-42"), { harmful: true, reason: "irreversible deletion" });
+        assert.deepStrictEqual(policy.getLastVerdict(), { harmful: true, reason: "irreversible deletion" });
+        assert.strictEqual(calls.length, 1);
+    });
+    test("authorize(): fails closed (denies) when the safety check itself can't produce a valid verdict", async () => {
+        const provider = new ScriptedProvider("p", () => ({ content: "I refuse to answer in JSON" }));
+        const policy = new MCPAutoExecutionPolicy({ aiModel: provider });
+        const authorized = await policy.authorize(request());
+        assert.strictEqual(authorized, false);
+        assert.strictEqual(policy.getVerdict("call-1").harmful, true);
+    });
+    test("watchedTools: a custom set overrides the default", async () => {
+        const provider = new ScriptedProvider("p", () => ({
+            toolCalls: [{ name: "submit_answer", inputs: { harmful: true, reason: "not allowed at all" } }],
+        }));
+        const policy = new MCPAutoExecutionPolicy({ aiModel: provider, watchedTools: ["todo-remove-list"] });
+        assert.strictEqual(await policy.authorize(request({ toolName: "bash-run" })), true, "bash-run isn't watched anymore");
+        assert.strictEqual(await policy.authorize(request({ toolName: "todo-remove-list", inputs: {} })), false);
+    });
+});
+//# sourceMappingURL=mcp-auto-execution-policy.test.js.map

package/dist/tests/core/mcp-auto-execution-policy.test.js.map

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

package/dist/tests/core/scripted-provider.d.ts

@@ -0,0 +1,38 @@
+import { AIProvider } from "../../index.js";
+import type { ChatResponse, Message, ProviderCapabilities, StreamCallback, ToolSchema } from "../../index.js";
+export interface ScriptedResult {
+    content?: string;
+    toolCalls?: {
+        name: string;
+        inputs: Record<string, any>;
+    }[];
+    /** Hold the "model" here for a moment, so a test can get a second call in while this turn is still running. */
+    delayMs?: number;
+}
+export type ScriptedTurn = (context: {
+    messages: Message[];
+    call: number;
+}) => ScriptedResult;
+/**
+ * A provider that answers from a script instead of a model, so swarm behavior
+ * can be tested without a network call.
+ *
+ * It streams each tool call before returning, exactly as the real providers do,
+ * so anything watching the stream (SwarmBase tags every chunk with the agent that
+ * produced it) sees what it would see in a real run.
+ */
+export declare class ScriptedProvider extends AIProvider {
+    #private;
+    constructor(name: string, script: ScriptedTurn | ScriptedTurn[]);
+    getModel(): string;
+    chat(messages: Message[], streamCallback?: StreamCallback, _tools?: ToolSchema[], _signal?: AbortSignal): Promise<ChatResponse>;
+    getCapabilities(): ProviderCapabilities;
+    setOption(): void;
+    getCallCount(): number;
+}
+/** The parsed output of the most recent result for `toolName`, as the model would read it. */
+export declare function lastToolOutput(messages: Message[], toolName: string): any;
+/** Text of the newest user-role message — how a delivered task, report, or group message arrives. */
+export declare function lastUserMessage(messages: Message[]): string;
+export default ScriptedProvider;
+//# sourceMappingURL=scripted-provider.d.ts.map

package/dist/tests/core/scripted-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripted-provider.d.ts","sourceRoot":"","sources":["../../../src/tests/core/scripted-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE9G,MAAM,WAAW,cAAc;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,EAAE,CAAC;IAC5D,+GAA+G;IAC/G,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KAAK,cAAc,CAAC;AAE9F;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,UAAU;;gBAMhC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,YAAY,EAAE;IAQ/D,QAAQ,IAAI,MAAM;IAIZ,IAAI,CACN,QAAQ,EAAE,OAAO,EAAE,EACnB,cAAc,CAAC,EAAE,cAAc,EAC/B,MAAM,CAAC,EAAE,UAAU,EAAE,EACrB,OAAO,CAAC,EAAE,WAAW,GACtB,OAAO,CAAC,YAAY,CAAC;IAkCxB,eAAe,IAAI,oBAAoB;IAIvC,SAAS,IAAI,IAAI;IAEjB,YAAY,IAAI,MAAM;CAGzB;AAED,8FAA8F;AAC9F,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,CAYzE;AAED,qGAAqG;AACrG,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAK3D;AAED,eAAe,gBAAgB,CAAC"}

package/dist/tests/core/scripted-provider.js

@@ -0,0 +1,85 @@
+import { AIProvider } from "../../index.js";
+/**
+ * A provider that answers from a script instead of a model, so swarm behavior
+ * can be tested without a network call.
+ *
+ * It streams each tool call before returning, exactly as the real providers do,
+ * so anything watching the stream (SwarmBase tags every chunk with the agent that
+ * produced it) sees what it would see in a real run.
+ */
+export class ScriptedProvider extends AIProvider {
+    #name;
+    #turn;
+    #calls = 0;
+    #ids = 0;
+    constructor(name, script) {
+        super();
+        this.#name = name;
+        this.#turn = Array.isArray(script)
+            ? ({ messages, call }) => (script[call] ?? (() => ({ content: "(no script left)" })))({ messages, call })
+            : script;
+    }
+    getModel() {
+        return `scripted-${this.#name}`;
+    }
+    async chat(messages, streamCallback, _tools, _signal) {
+        const call = this.#calls++;
+        const result = this.#turn({ messages, call });
+        if (result.delayMs) {
+            await new Promise(resolve => setTimeout(resolve, result.delayMs));
+        }
+        const toolCalls = (result.toolCalls ?? []).map(tc => ({
+            id: `${this.#name}-call-${++this.#ids}`,
+            name: tc.name,
+            inputs: tc.inputs,
+        }));
+        const usage = { inputMissTokens: 1, inputCacheTokens: 0, outputTokens: 1 };
+        for (const toolCall of toolCalls) {
+            await streamCallback?.({ role: "assistant", content: "", done: false, toolCalls: [toolCall], usage });
+        }
+        const content = result.content ?? "";
+        if (content) {
+            await streamCallback?.({ role: "assistant", content, done: false, usage });
+        }
+        await streamCallback?.({ role: "assistant", content: "", done: true, usage });
+        return {
+            content,
+            inputMissTokens: 1,
+            inputCacheTokens: 0,
+            outputTokens: 1,
+            ...(toolCalls.length ? { toolCalls } : {}),
+        };
+    }
+    getCapabilities() {
+        return { supportsTools: true, supportsImages: false, contextWindow: 200000, safeUsageRatio: 0.5 };
+    }
+    setOption() { }
+    getCallCount() {
+        return this.#calls;
+    }
+}
+/** The parsed output of the most recent result for `toolName`, as the model would read it. */
+export function lastToolOutput(messages, toolName) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const message = messages[i];
+        if (message.role === "tool" && message.toolName === toolName) {
+            try {
+                return JSON.parse(message.content ?? "{}");
+            }
+            catch {
+                return { raw: message.content };
+            }
+        }
+    }
+    return undefined;
+}
+/** Text of the newest user-role message — how a delivered task, report, or group message arrives. */
+export function lastUserMessage(messages) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        if (messages[i].role === "user")
+            return messages[i].content ?? "";
+    }
+    return "";
+}
+export default ScriptedProvider;
+//# sourceMappingURL=scripted-provider.js.map