agent-bober 0.17.1 → 0.19.0

package/dist/orchestrator/tools/executor.d.ts

@@ -0,0 +1,68 @@
+import type { ToolCall, ToolResult } from "../../providers/types.js";
+import type { ToolHandler } from "./handlers.js";
+import type { HookDecision } from "../loop-events.js";
+/**
+ * Delegating tool-call executor (ADR-2, agent-loop-capability-port sprint 4).
+ *
+ * Ports the agentic loop's per-tool serial block into a standalone function so
+ * contiguous runs of read-only-annotated tool calls can run concurrently while
+ * everything else (writes, unmarked tools, or `parallel: false`) stays strictly
+ * sequential. Classification travels with `ToolDef.readOnly` — this module
+ * never hard-codes a tool-name allow-list; the caller derives `readOnlyTools`
+ * from the tool schemas it was configured with.
+ */
+export interface ToolBatch {
+    /** Tool calls requested by the model this turn, in original order. */
+    toolCalls: ToolCall[];
+    /** Handler functions for each tool, keyed by name. */
+    toolHandlers: Map<string, ToolHandler>;
+    /** Names of tools annotated `readOnly: true` (derived once by the caller from `params.tools`). */
+    readOnlyTools: Set<string>;
+    /**
+     * When `false` (or omitted), every call runs strictly serially — byte-identical
+     * to the pre-change for-await loop, regardless of any `readOnly` annotation.
+     */
+    parallel: boolean;
+    /** Called when a tool is dispatched (for logging/progress). Fires for every call, including unknown tools, before the handler lookup. */
+    onToolUse?: (name: string, input: unknown) => void;
+    /**
+     * Dispatch-time observability event (agent-loop-capability-port sprint 5).
+     * Fires synchronously, BEFORE any await — same timing guarantee as
+     * `onToolUse` — so dispatch order is unaffected whether this is set or not.
+     */
+    onToolStart?: (call: ToolCall) => void;
+    /**
+     * Settle-time observability event, fired after a result (allowed, denied,
+     * or errored) is built, for every call.
+     */
+    onToolEnd?: (call: ToolCall, result: ToolResult) => void;
+    /**
+     * Host-side veto gate. Evaluated BEFORE the handler runs; a `{allow:false}`
+     * decision skips the handler and produces an `isError` rejection result
+     * instead. Always resolves to a decision — the caller (the loop) already
+     * wraps a throwing hook into a fail-closed deny before passing it in here,
+     * so the executor never needs its own try/catch around this call.
+     */
+    preToolUse?: (call: ToolCall) => Promise<HookDecision>;
+    /**
+     * Observes the result after execution (allowed, denied, or errored). The
+     * caller (the loop) already wraps a throwing hook in try/catch before
+     * passing it in here, so the executor never needs its own try/catch
+     * around this call either.
+     */
+    postToolUse?: (call: ToolCall, result: ToolResult) => void | Promise<void>;
+}
+/**
+ * Execute a turn's tool calls, delegating maximal contiguous runs of
+ * read-only-annotated calls to `Promise.all` while everything else runs
+ * strictly one-at-a-time (identical to the old for-await loop).
+ *
+ * - Results are assembled by original array position, so the returned
+ *   `ToolResult[]` always matches `toolCalls` order — even when a run
+ *   executed concurrently and resolved out of order.
+ * - Never rejects: `executeOne` catches every failure into an in-slot
+ *   `isError` ToolResult, so a thrown handler or unknown tool never
+ *   propagates past its own slot.
+ */
+export declare function executeToolBatch(batch: ToolBatch): Promise<ToolResult[]>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/orchestrator/tools/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/tools/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD;;;;;;;;;GASG;AAIH,MAAM,WAAW,SAAS;IACxB,sEAAsE;IACtE,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,sDAAsD;IACtD,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACvC,kGAAkG;IAClG,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,yIAAyI;IACzI,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnD;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACvC;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IACzD;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACvD;;;;;OAKG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5E;AA2ED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAiD9E"}

package/dist/orchestrator/tools/executor.js

@@ -0,0 +1,104 @@
+import { logger } from "../../utils/logger.js";
+// ── Single tool-call execution ───────────────────────────────────────
+/**
+ * Execute a single tool call, mirroring the three exact result shapes the
+ * pre-change serial loop produced (unknown-tool / success / thrown-handler),
+ * plus a fourth (veto-rejection) shape introduced in sprint 5. Never throws
+ * — every failure/veto path returns an `isError: true` ToolResult.
+ */
+async function executeOne(toolCall, toolHandlers, onToolUse, execHooks) {
+    const toolName = toolCall.name;
+    const toolInput = toolCall.input;
+    onToolUse?.(toolName, toolInput);
+    execHooks?.onToolStart?.(toolCall);
+    /** Fire the settle-time observers, then return the result as-is. */
+    const finalize = async (result) => {
+        execHooks?.onToolEnd?.(toolCall, result);
+        await execHooks?.postToolUse?.(toolCall, result);
+        return result;
+    };
+    if (execHooks?.preToolUse) {
+        const decision = await execHooks.preToolUse(toolCall);
+        if (!decision.allow) {
+            const reason = decision.reason ?? "no reason given";
+            logger.warn(`Tool call to "${toolName}" was denied by policy: ${reason}`);
+            return finalize({
+                toolUseId: toolCall.id,
+                content: `Error: Tool call to "${toolName}" was denied by policy: ${reason}`,
+                isError: true,
+            });
+        }
+    }
+    const handler = toolHandlers.get(toolName);
+    if (!handler) {
+        logger.warn(`Unknown tool requested: "${toolName}"`);
+        return finalize({
+            toolUseId: toolCall.id,
+            content: `Error: Unknown tool "${toolName}". Available tools: ${[...toolHandlers.keys()].join(", ")}`,
+            isError: true,
+        });
+    }
+    try {
+        const result = await handler(toolInput);
+        return finalize({
+            toolUseId: toolCall.id,
+            content: result.output,
+            isError: result.isError,
+        });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        logger.warn(`Tool "${toolName}" threw: ${message}`);
+        return finalize({
+            toolUseId: toolCall.id,
+            content: `Error: Tool execution failed: ${message}`,
+            isError: true,
+        });
+    }
+}
+// ── Batch execution ───────────────────────────────────────────────────
+/**
+ * Execute a turn's tool calls, delegating maximal contiguous runs of
+ * read-only-annotated calls to `Promise.all` while everything else runs
+ * strictly one-at-a-time (identical to the old for-await loop).
+ *
+ * - Results are assembled by original array position, so the returned
+ *   `ToolResult[]` always matches `toolCalls` order — even when a run
+ *   executed concurrently and resolved out of order.
+ * - Never rejects: `executeOne` catches every failure into an in-slot
+ *   `isError` ToolResult, so a thrown handler or unknown tool never
+ *   propagates past its own slot.
+ */
+export async function executeToolBatch(batch) {
+    const { toolCalls, toolHandlers, readOnlyTools, parallel, onToolUse, onToolStart, onToolEnd, preToolUse, postToolUse, } = batch;
+    const execHooks = { onToolStart, onToolEnd, preToolUse, postToolUse };
+    const results = new Array(toolCalls.length);
+    let i = 0;
+    while (i < toolCalls.length) {
+        const isEligible = (idx) => parallel && readOnlyTools.has(toolCalls[idx].name);
+        if (!isEligible(i)) {
+            // Not eligible for concurrency (flag off, or an unmarked/write tool) —
+            // execute exactly one call, in place, before moving on.
+            results[i] = await executeOne(toolCalls[i], toolHandlers, onToolUse, execHooks);
+            i += 1;
+            continue;
+        }
+        // Collect the maximal contiguous run of eligible (read-only) calls.
+        let j = i;
+        while (j < toolCalls.length && isEligible(j)) {
+            j += 1;
+        }
+        // Dispatch every call in the run — onToolUse/onToolStart fire
+        // synchronously, in original order, for the whole run before any handler
+        // settles (each async call runs synchronously up to its first `await`).
+        const runResults = await Promise.all(toolCalls
+            .slice(i, j)
+            .map((call) => executeOne(call, toolHandlers, onToolUse, execHooks)));
+        for (let k = 0; k < runResults.length; k++) {
+            results[i + k] = runResults[k];
+        }
+        i = j;
+    }
+    return results;
+}
+//# sourceMappingURL=executor.js.map

package/dist/orchestrator/tools/executor.js.map

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

package/dist/orchestrator/tools/mcp-bridge.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Opt-in MCP tool bridge (agent-loop-capability-port sprint 10).
+ *
+ * Exposes a single configured MCP server's tools as provider-agnostic
+ * `ToolDef`s the agentic loop can call directly, alongside its own tool set.
+ * Reuses the repo's existing SDK-based MCP client path (`src/mcp/external-client.ts`'s
+ * `ExternalMcpServer` — spawn `{command,args}` -> `listTools` -> `callTool` ->
+ * `stop`) rather than hand-rolling JSON-RPC: the SDK `Client` +
+ * `StdioClientTransport` perform the initialize/tools-list/tools-call
+ * handshake internally.
+ *
+ * Disabled by default: nothing in this module runs unless a caller
+ * explicitly invokes `createMcpToolBridge` — and callers must only do so
+ * after confirming `config.tools?.mcpBridge?.enabled === true` at the CALL
+ * SITE, never at config parse time (see `config/schema.ts`
+ * `ToolsSectionSchema`). This keeps `runAgenticLoop` itself hermetic (the
+ * loop never owns MCP lifecycle) and preserves the hermetic claude-code /
+ * fleet child paths (nonGoal #2 — this module is never wired there).
+ *
+ * Bridged tools are NEVER marked `readOnly` (unknown upstream side effects
+ * => serial execution per ADR-2, nonGoal #3) and are namespaced with an
+ * `mcp__` prefix so they never collide with the loop's own filesystem/bash
+ * tools (Pattern E).
+ */
+import type { ToolDef } from "../../providers/types.js";
+import type { ToolHandler } from "./handlers.js";
+/**
+ * Minimal MCP-client interface satisfied by the real SDK client AND test
+ * stubs. Mirrors `McpServerLike` (src/vault/mcp-adapter.ts:31-37) so tests
+ * never spawn a real process or import the SDK.
+ */
+export interface McpBridgeClientLike {
+    start(): Promise<void>;
+    listTools(): Promise<Array<{
+        name: string;
+        description?: string;
+        inputSchema?: unknown;
+    }>>;
+    callTool(name: string, args: unknown): Promise<unknown>;
+    close(): Promise<void>;
+}
+export interface McpToolBridge {
+    tools: ToolDef[];
+    handlers: Map<string, ToolHandler>;
+    close(): Promise<void>;
+}
+export interface CreateMcpToolBridgeOpts {
+    /** Injected for tests so no real process is ever spawned. Defaults to the real SDK client. */
+    clientFactory?: (server: {
+        command: string;
+        args: string[];
+    }) => McpBridgeClientLike;
+}
+/**
+ * Start a configured MCP server, list its tools, and expose them as
+ * `mcp__`-prefixed `ToolDef`s + `ToolHandler`s a caller can merge into a
+ * loop's own tool set. Callers own the bridge's lifetime — construct ONLY
+ * when `config.tools?.mcpBridge?.enabled === true` at the call site, and
+ * close it (directly, or via `runWithMcpBridge`) when done.
+ */
+export declare function createMcpToolBridge(server: {
+    command: string;
+    args?: string[];
+}, opts?: CreateMcpToolBridgeOpts): Promise<McpToolBridge>;
+/**
+ * Run `fn` with the bridge's tools available, closing the underlying MCP
+ * connection in a `finally` regardless of how `fn` resolves/rejects. Keeps
+ * `runAgenticLoop` itself hermetic — the loop never owns MCP lifecycle; a
+ * consumer builds the bridge, merges its tools into the loop's params, runs
+ * the loop inside `fn`, and this helper guarantees `close()` at loop end
+ * (design decision (d) in the sprint 10 briefing). `runAgenticLoop` resolves
+ * exactly once (its `finish()` single exit), so this `finally` always fires
+ * after the loop is truly done.
+ */
+export declare function runWithMcpBridge<T>(bridge: McpToolBridge, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=mcp-bridge.d.ts.map

package/dist/orchestrator/tools/mcp-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-bridge.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/tools/mcp-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAIjD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC,CAAC;IAC3F,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AA2ED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,8FAA8F;IAC9F,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,mBAAmB,CAAC;CACtF;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,EAC5C,IAAI,GAAE,uBAA4B,GACjC,OAAO,CAAC,aAAa,CAAC,CAwCxB;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,MAAM,EAAE,aAAa,EACrB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAMZ"}

package/dist/orchestrator/tools/mcp-bridge.js

@@ -0,0 +1,154 @@
+/**
+ * Opt-in MCP tool bridge (agent-loop-capability-port sprint 10).
+ *
+ * Exposes a single configured MCP server's tools as provider-agnostic
+ * `ToolDef`s the agentic loop can call directly, alongside its own tool set.
+ * Reuses the repo's existing SDK-based MCP client path (`src/mcp/external-client.ts`'s
+ * `ExternalMcpServer` — spawn `{command,args}` -> `listTools` -> `callTool` ->
+ * `stop`) rather than hand-rolling JSON-RPC: the SDK `Client` +
+ * `StdioClientTransport` perform the initialize/tools-list/tools-call
+ * handshake internally.
+ *
+ * Disabled by default: nothing in this module runs unless a caller
+ * explicitly invokes `createMcpToolBridge` — and callers must only do so
+ * after confirming `config.tools?.mcpBridge?.enabled === true` at the CALL
+ * SITE, never at config parse time (see `config/schema.ts`
+ * `ToolsSectionSchema`). This keeps `runAgenticLoop` itself hermetic (the
+ * loop never owns MCP lifecycle) and preserves the hermetic claude-code /
+ * fleet child paths (nonGoal #2 — this module is never wired there).
+ *
+ * Bridged tools are NEVER marked `readOnly` (unknown upstream side effects
+ * => serial execution per ADR-2, nonGoal #3) and are namespaced with an
+ * `mcp__` prefix so they never collide with the loop's own filesystem/bash
+ * tools (Pattern E).
+ */
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+/** Namespace prefix for bridged tool names (Pattern E). */
+const MCP_TOOL_PREFIX = "mcp__";
+// ── Default (real) SDK-backed client ──────────────────────────────────
+/** Wraps the real `@modelcontextprotocol/sdk` client behind `McpBridgeClientLike`. */
+class SdkMcpBridgeClient {
+    server;
+    client = null;
+    transport = null;
+    constructor(server) {
+        this.server = server;
+    }
+    async start() {
+        if (this.client)
+            return; // idempotent
+        this.transport = new StdioClientTransport({
+            command: this.server.command,
+            args: this.server.args,
+            env: { ...process.env },
+            stderr: "pipe",
+        });
+        this.client = new Client({ name: "agent-bober-mcp-bridge", version: "0.13.0" }, { capabilities: {} });
+        await this.client.connect(this.transport);
+    }
+    async listTools() {
+        if (!this.client)
+            throw new Error("SdkMcpBridgeClient: not started");
+        const res = await this.client.listTools();
+        return res.tools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+        }));
+    }
+    async callTool(name, args) {
+        if (!this.client)
+            throw new Error("SdkMcpBridgeClient: not started");
+        return await this.client.callTool({
+            name,
+            arguments: args ?? {},
+        });
+    }
+    async close() {
+        const clientRef = this.client;
+        this.client = null;
+        this.transport = null;
+        if (!clientRef)
+            return;
+        await clientRef.close().catch(() => { });
+    }
+}
+// ── Result unwrap (Pattern D) ──────────────────────────────────────────
+/**
+ * Unwrap an SDK `callTool` result. The MCP SDK returns
+ * `{ content: [{type:'text', text}], isError }`. Some servers put a
+ * staleness/warning line first, so join ALL `type:'text'` entries rather
+ * than assuming the payload is `content[0]`.
+ */
+function unwrapCallToolResult(raw) {
+    const candidate = raw;
+    const text = (candidate?.content ?? [])
+        .filter((c) => c?.type === "text")
+        .map((c) => c.text ?? "")
+        .join("");
+    return { output: text, isError: candidate?.isError === true };
+}
+/**
+ * Start a configured MCP server, list its tools, and expose them as
+ * `mcp__`-prefixed `ToolDef`s + `ToolHandler`s a caller can merge into a
+ * loop's own tool set. Callers own the bridge's lifetime — construct ONLY
+ * when `config.tools?.mcpBridge?.enabled === true` at the call site, and
+ * close it (directly, or via `runWithMcpBridge`) when done.
+ */
+export async function createMcpToolBridge(server, opts = {}) {
+    const args = server.args ?? [];
+    const client = (opts.clientFactory ?? ((s) => new SdkMcpBridgeClient(s)))({
+        command: server.command,
+        args,
+    });
+    await client.start();
+    const descriptors = await client.listTools();
+    const tools = [];
+    const handlers = new Map();
+    for (const d of descriptors) {
+        const prefixedName = `${MCP_TOOL_PREFIX}${d.name}`;
+        // NOT readOnly — unknown upstream side effects stay serial (ADR-2, nonGoal #3).
+        tools.push({
+            name: prefixedName,
+            description: d.description ?? `Bridged MCP tool '${d.name}'.`,
+            input_schema: d.inputSchema ??
+                { type: "object", properties: {} },
+        });
+        handlers.set(prefixedName, async (input) => {
+            try {
+                // Call the ORIGINAL upstream name — the prefix exists only for the
+                // loop's own tool list (Pattern E), never sent to the MCP server.
+                const raw = await client.callTool(d.name, input);
+                return unwrapCallToolResult(raw);
+            }
+            catch (err) {
+                return { output: err instanceof Error ? err.message : String(err), isError: true };
+            }
+        });
+    }
+    return {
+        tools,
+        handlers,
+        close: () => client.close(),
+    };
+}
+/**
+ * Run `fn` with the bridge's tools available, closing the underlying MCP
+ * connection in a `finally` regardless of how `fn` resolves/rejects. Keeps
+ * `runAgenticLoop` itself hermetic — the loop never owns MCP lifecycle; a
+ * consumer builds the bridge, merges its tools into the loop's params, runs
+ * the loop inside `fn`, and this helper guarantees `close()` at loop end
+ * (design decision (d) in the sprint 10 briefing). `runAgenticLoop` resolves
+ * exactly once (its `finish()` single exit), so this `finally` always fires
+ * after the loop is truly done.
+ */
+export async function runWithMcpBridge(bridge, fn) {
+    try {
+        return await fn();
+    }
+    finally {
+        await bridge.close();
+    }
+}
+//# sourceMappingURL=mcp-bridge.js.map

package/dist/orchestrator/tools/mcp-bridge.js.map

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

package/dist/orchestrator/tools/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/tools/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;;GAIG;AAEH,eAAO,MAAM,QAAQ,EAAE,OAmBtB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,OAuB1B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,OAmB3B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,OAwB1B,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,OAmBtB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,OA6BtB,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAOhD,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/tools/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAExD;;;;GAIG;AAEH,eAAO,MAAM,QAAQ,EAAE,OAmBtB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,OAwB1B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,OAmB3B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,OAwB1B,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,OAoBtB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,OA8BtB,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAOhD,CAAC"}

package/dist/orchestrator/tools/schemas.js

@@ -23,6 +23,7 @@ export const bashTool = {
 };
 export const readFileTool = {
     name: "read_file",
+    readOnly: true,
     description: "Read a file's contents. Returns the file content with line numbers. Use offset and limit to read specific sections of large files.",
     input_schema: {
         type: "object",
@@ -85,6 +86,7 @@ export const editFileTool = {
 };
 export const globTool = {
     name: "glob",
+    readOnly: true,
     description: 'Find files matching a glob pattern. Returns a list of matching file paths relative to the search directory. Example patterns: "**/*.ts", "src/components/**/*.tsx", "*.json".',
     input_schema: {
         type: "object",
@@ -103,6 +105,7 @@ export const globTool = {
 };
 export const grepTool = {
     name: "grep",
+    readOnly: true,
     description: "Search file contents using a regular expression pattern. Returns matching lines with file paths and line numbers.",
     input_schema: {
         type: "object",

package/dist/orchestrator/tools/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/orchestrator/tools/schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/orchestrator/tools/schemas.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAY;IAC/B,IAAI,EAAE,MAAM;IACZ,WAAW,EACT,gLAAgL;IAClL,YAAY,EAAE;QACZ,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+BAA+B;aAC7C;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,0GAA0G;aAC7G;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAY;IACnC,IAAI,EAAE,WAAW;IACjB,QAAQ,EAAE,IAAI;IACd,WAAW,EACT,oIAAoI;IACtI,YAAY,EAAE;QACZ,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,kHAAkH;aACrH;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wDAAwD;aACtE;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4CAA4C;aAC1D;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KACxB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAY;IACpC,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,4JAA4J;IAC9J,YAAY,EAAE;QACZ,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,kHAAkH;aACrH;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wCAAwC;aACtD;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;KACnC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAY;IACnC,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,yKAAyK;IAC3K,YAAY,EAAE;QACZ,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,kHAAkH;aACrH;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,8EAA8E;aACjF;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uBAAuB;aACrC;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC;KAChD;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAY;IAC/B,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,IAAI;IACd,WAAW,EACT,+KAA+K;IACjL,YAAY,EAAE;QACZ,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0CAA0C;aACxD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,qIAAqI;aACxI;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAY;IAC/B,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,IAAI;IACd,WAAW,EACT,mHAAmH;IACrH,YAAY,EAAE;QACZ,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2CAA2C;aACzD;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,6IAA6I;aAChJ;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,sEAAsE;aACzE;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,8DAA8D;aACjE;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;CACF,CAAC;AAEF,sDAAsD;AACtD,MAAM,CAAC,MAAM,YAAY,GAA4B;IACnD,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,YAAY;IACvB,UAAU,EAAE,aAAa;IACzB,SAAS,EAAE,YAAY;IACvB,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;CACf,CAAC"}

package/dist/orchestrator/workflow/budget.d.ts

@@ -19,33 +19,47 @@ export interface BudgetOptions {
     maxTokens?: number | null;
     /** Max agent executions charged to this budget. `null`/omitted = unlimited. */
     maxAgents?: number | null;
+    /** Max total USD cost charged to this budget. `null`/omitted = unlimited. */
+    maxUsd?: number | null;
 }
 /** Raised by {@link Budget.assertWithinBudget} when a ceiling is exceeded. */
 export declare class BudgetExceededError extends Error {
     /** Which ceiling was hit. */
-    readonly kind: "tokens" | "agents";
+    readonly kind: "tokens" | "agents" | "usd";
     constructor(message: string, 
     /** Which ceiling was hit. */
-    kind: "tokens" | "agents");
+    kind: "tokens" | "agents" | "usd");
 }
 export declare class Budget {
     private readonly opts;
     private inputTokens;
     private outputTokens;
     private agents;
+    private usd;
     constructor(opts?: BudgetOptions);
     /** Record an agent's token usage. */
     chargeTokens(usage: TokenUsage): void;
     /** Record `n` agent executions (default 1). */
     chargeAgents(n?: number): void;
+    /**
+     * Record a USD charge. Non-finite (`NaN`, `Infinity`, `-Infinity`) or
+     * negative values are treated as 0 (no-op) rather than corrupting the
+     * running total — a malformed/absent `costUsd` must never crash or
+     * silently under/over-charge the budget.
+     */
+    chargeUsd(usd: number): void;
     /** Total tokens spent (input + output). */
     get tokensSpent(): number;
     /** Agent executions charged so far. */
     get agentsSpent(): number;
+    /** Total USD charged so far. */
+    get usdSpent(): number;
     /** Remaining token headroom, or `Infinity` when uncapped. */
     remainingTokens(): number;
     /** Remaining agent headroom, or `Infinity` when uncapped. */
     remainingAgents(): number;
+    /** Remaining USD headroom, or `Infinity` when uncapped. */
+    remainingUsd(): number;
     /** True once any configured ceiling has been reached or passed. */
     exceeded(): boolean;
     /**
@@ -54,4 +68,12 @@ export declare class Budget {
      */
     assertWithinBudget(): void;
 }
+/**
+ * Construct a USD-only {@link Budget} from a role section's `budget.maxUsd`
+ * config value, or `undefined` when unset (Sprint 3 — agent-loop capability
+ * port). Shared helper so role entry points (generator, and future
+ * curator/evaluator/planner wiring) can adopt the same absent-means-no-budget
+ * convention without duplicating the `!= null` check.
+ */
+export declare function budgetFromMaxUsd(maxUsd: number | null | undefined): Budget | undefined;
 //# sourceMappingURL=budget.d.ts.map

package/dist/orchestrator/workflow/budget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/workflow/budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,8EAA8E;AAC9E,qBAAa,mBAAoB,SAAQ,KAAK;IAG1C,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ;gBAFlC,OAAO,EAAE,MAAM;IACf,6BAA6B;IACpB,IAAI,EAAE,QAAQ,GAAG,QAAQ;CAKrC;AAED,qBAAa,MAAM;IAKL,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,MAAM,CAAK;gBAEU,IAAI,GAAE,aAAkB;IAErD,qCAAqC;IACrC,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAKrC,+CAA+C;IAC/C,YAAY,CAAC,CAAC,SAAI,GAAG,IAAI;IAIzB,2CAA2C;IAC3C,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,uCAAuC;IACvC,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,6DAA6D;IAC7D,eAAe,IAAI,MAAM;IAMzB,6DAA6D;IAC7D,eAAe,IAAI,MAAM;IAMzB,mEAAmE;IACnE,QAAQ,IAAI,OAAO;IAInB;;;OAGG;IACH,kBAAkB,IAAI,IAAI;CAc3B"}
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/workflow/budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,8EAA8E;AAC9E,qBAAa,mBAAoB,SAAQ,KAAK;IAG1C,6BAA6B;IAC7B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK;gBAF1C,OAAO,EAAE,MAAM;IACf,6BAA6B;IACpB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK;CAK7C;AAED,qBAAa,MAAM;IAML,OAAO,CAAC,QAAQ,CAAC,IAAI;IALjC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,GAAG,CAAK;gBAEa,IAAI,GAAE,aAAkB;IAErD,qCAAqC;IACrC,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAKrC,+CAA+C;IAC/C,YAAY,CAAC,CAAC,SAAI,GAAG,IAAI;IAIzB;;;;;OAKG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK5B,2CAA2C;IAC3C,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,uCAAuC;IACvC,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,gCAAgC;IAChC,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,6DAA6D;IAC7D,eAAe,IAAI,MAAM;IAMzB,6DAA6D;IAC7D,eAAe,IAAI,MAAM;IAMzB,2DAA2D;IAC3D,YAAY,IAAI,MAAM;IAMtB,mEAAmE;IACnE,QAAQ,IAAI,OAAO;IAQnB;;;OAGG;IACH,kBAAkB,IAAI,IAAI;CAoB3B;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEtF"}

package/dist/orchestrator/workflow/budget.js

@@ -26,6 +26,7 @@ export class Budget {
     inputTokens = 0;
     outputTokens = 0;
     agents = 0;
+    usd = 0;
     constructor(opts = {}) {
         this.opts = opts;
     }
@@ -38,6 +39,17 @@ export class Budget {
     chargeAgents(n = 1) {
         this.agents += n;
     }
+    /**
+     * Record a USD charge. Non-finite (`NaN`, `Infinity`, `-Infinity`) or
+     * negative values are treated as 0 (no-op) rather than corrupting the
+     * running total — a malformed/absent `costUsd` must never crash or
+     * silently under/over-charge the budget.
+     */
+    chargeUsd(usd) {
+        if (!Number.isFinite(usd) || usd < 0)
+            return;
+        this.usd += usd;
+    }
     /** Total tokens spent (input + output). */
     get tokensSpent() {
         return this.inputTokens + this.outputTokens;
@@ -46,6 +58,10 @@ export class Budget {
     get agentsSpent() {
         return this.agents;
     }
+    /** Total USD charged so far. */
+    get usdSpent() {
+        return this.usd;
+    }
     /** Remaining token headroom, or `Infinity` when uncapped. */
     remainingTokens() {
         const max = this.opts.maxTokens;
@@ -60,9 +76,18 @@ export class Budget {
             return Infinity;
         return Math.max(0, max - this.agents);
     }
+    /** Remaining USD headroom, or `Infinity` when uncapped. */
+    remainingUsd() {
+        const max = this.opts.maxUsd;
+        if (max === null || max === undefined)
+            return Infinity;
+        return Math.max(0, max - this.usd);
+    }
     /** True once any configured ceiling has been reached or passed. */
     exceeded() {
-        return this.remainingTokens() === 0 || this.remainingAgents() === 0;
+        return (this.remainingTokens() === 0 ||
+            this.remainingAgents() === 0 ||
+            this.remainingUsd() === 0);
     }
     /**
      * Throw {@link BudgetExceededError} if a ceiling has been reached. Call before
@@ -75,6 +100,19 @@ export class Budget {
         if (this.remainingAgents() === 0) {
             throw new BudgetExceededError(`Agent budget exhausted (${String(this.opts.maxAgents ?? 0)} agents).`, "agents");
         }
+        if (this.remainingUsd() === 0) {
+            throw new BudgetExceededError(`USD budget exhausted ($${String(this.opts.maxUsd ?? 0)}).`, "usd");
+        }
     }
 }
+/**
+ * Construct a USD-only {@link Budget} from a role section's `budget.maxUsd`
+ * config value, or `undefined` when unset (Sprint 3 — agent-loop capability
+ * port). Shared helper so role entry points (generator, and future
+ * curator/evaluator/planner wiring) can adopt the same absent-means-no-budget
+ * convention without duplicating the `!= null` check.
+ */
+export function budgetFromMaxUsd(maxUsd) {
+    return maxUsd != null ? new Budget({ maxUsd }) : undefined;
+}
 //# sourceMappingURL=budget.js.map

package/dist/orchestrator/workflow/budget.js.map

@@ -1 +1 @@
-{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../../src/orchestrator/workflow/budget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,8EAA8E;AAC9E,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAIjC;IAHX,YACE,OAAe;IACf,6BAA6B;IACpB,IAAyB;QAElC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,SAAI,GAAJ,IAAI,CAAqB;QAGlC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,MAAM;IAKY;IAJrB,WAAW,GAAG,CAAC,CAAC;IAChB,YAAY,GAAG,CAAC,CAAC;IACjB,MAAM,GAAG,CAAC,CAAC;IAEnB,YAA6B,OAAsB,EAAE;QAAxB,SAAI,GAAJ,IAAI,CAAoB;IAAG,CAAC;IAEzD,qCAAqC;IACrC,YAAY,CAAC,KAAiB;QAC5B,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,CAAC;IAC1C,CAAC;IAED,+CAA+C;IAC/C,YAAY,CAAC,CAAC,GAAG,CAAC;QAChB,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,2CAA2C;IAC3C,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC;IAC9C,CAAC;IAED,uCAAuC;IACvC,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,6DAA6D;IAC7D,eAAe;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;QACvD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC;IAED,6DAA6D;IAC7D,eAAe;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;QACvD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED,mEAAmE;IACnE,QAAQ;QACN,OAAO,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACtE,CAAC;IAED;;;OAGG;IACH,kBAAkB;QAChB,IAAI,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,mBAAmB,CAC3B,2BAA2B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,WAAW,EACtE,QAAQ,CACT,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,mBAAmB,CAC3B,2BAA2B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,WAAW,EACtE,QAAQ,CACT,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../../src/orchestrator/workflow/budget.ts"],"names":[],"mappings":"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"}