@vauban-org/agent-sdk 0.16.0

package/dist/llm/parse-structured-output.d.ts

@@ -0,0 +1,55 @@
+/**
+ * parseStructuredOutput — robust JSON parser for LLM outputs.
+ *
+ * Promoted from forge/src/agents/shared/parse-llm-output.ts (Vague 1.B.5).
+ * Extended with optional Zod schema validation and typed error on failure.
+ *
+ * LLMs occasionally wrap JSON in markdown code-fences or append trailing
+ * commentary. This parser strips those artifacts, attempts JSON.parse, runs
+ * optional Zod validation, then returns a fallback or throws on unrecoverable
+ * parse errors.
+ *
+ * @public @since 0.18.0
+ */
+import type { ZodSchema } from "zod";
+/**
+ * Thrown by `parseStructuredOutput` when:
+ * - JSON.parse fails AND no `fallback` is provided, OR
+ * - Zod validation fails AND no `fallback` is provided.
+ */
+export declare class ParseStructuredOutputError extends Error {
+    /** The raw LLM string that could not be parsed (first 500 chars). */
+    readonly raw: string;
+    /** The underlying parse / validation error. */
+    readonly cause: unknown;
+    constructor(message: string, raw: string, cause: unknown);
+}
+export interface ParseStructuredOutputOpts<T> {
+    /**
+     * Optional Zod schema for runtime validation after JSON.parse.
+     * If validation fails and no `fallback` is provided,
+     * `ParseStructuredOutputError` is thrown.
+     */
+    schema?: ZodSchema<T>;
+    /**
+     * Fallback value returned when JSON.parse or Zod validation fails.
+     * When provided, the function never throws.
+     */
+    fallback?: T;
+}
+/**
+ * Parse a raw LLM string into a typed value.
+ *
+ * Pipeline:
+ * 1. Strip markdown ```json / ``` fences.
+ * 2. `JSON.parse` the cleaned string.
+ * 3. Optionally validate with a Zod schema.
+ * 4. Return the value, or `fallback`, or throw `ParseStructuredOutputError`.
+ *
+ * @param raw   - Raw string produced by the LLM.
+ * @param opts  - Optional Zod schema and/or fallback value.
+ * @returns Parsed (and optionally validated) value of type `T`.
+ * @throws {ParseStructuredOutputError} when parsing fails and no fallback is set.
+ */
+export declare function parseStructuredOutput<T>(raw: string, opts?: ParseStructuredOutputOpts<T>): T;
+//# sourceMappingURL=parse-structured-output.d.ts.map

package/dist/llm/parse-structured-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-structured-output.d.ts","sourceRoot":"","sources":["../../src/llm/parse-structured-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAIrC;;;;GAIG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,qEAAqE;IACrE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,SAAkB,KAAK,EAAE,OAAO,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAMzD;AAcD,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,CAAC;CACd;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAClC,CAAC,CAmCH"}

package/dist/llm/parse-structured-output.js

@@ -0,0 +1,80 @@
+/**
+ * parseStructuredOutput — robust JSON parser for LLM outputs.
+ *
+ * Promoted from forge/src/agents/shared/parse-llm-output.ts (Vague 1.B.5).
+ * Extended with optional Zod schema validation and typed error on failure.
+ *
+ * LLMs occasionally wrap JSON in markdown code-fences or append trailing
+ * commentary. This parser strips those artifacts, attempts JSON.parse, runs
+ * optional Zod validation, then returns a fallback or throws on unrecoverable
+ * parse errors.
+ *
+ * @public @since 0.18.0
+ */
+// ─── Error ────────────────────────────────────────────────────────────────────
+/**
+ * Thrown by `parseStructuredOutput` when:
+ * - JSON.parse fails AND no `fallback` is provided, OR
+ * - Zod validation fails AND no `fallback` is provided.
+ */
+export class ParseStructuredOutputError extends Error {
+    /** The raw LLM string that could not be parsed (first 500 chars). */
+    raw;
+    /** The underlying parse / validation error. */
+    cause;
+    constructor(message, raw, cause) {
+        super(message);
+        this.name = "ParseStructuredOutputError";
+        this.raw = raw.slice(0, 500);
+        this.cause = cause;
+    }
+}
+// ─── Markdown fence stripping ─────────────────────────────────────────────────
+/** Strip ```json ... ``` or ``` ... ``` fences and trim whitespace. */
+function stripMarkdownFences(raw) {
+    return raw
+        .replace(/```json\s*/gi, "")
+        .replace(/```\s*/g, "")
+        .trim();
+}
+/**
+ * Parse a raw LLM string into a typed value.
+ *
+ * Pipeline:
+ * 1. Strip markdown ```json / ``` fences.
+ * 2. `JSON.parse` the cleaned string.
+ * 3. Optionally validate with a Zod schema.
+ * 4. Return the value, or `fallback`, or throw `ParseStructuredOutputError`.
+ *
+ * @param raw   - Raw string produced by the LLM.
+ * @param opts  - Optional Zod schema and/or fallback value.
+ * @returns Parsed (and optionally validated) value of type `T`.
+ * @throws {ParseStructuredOutputError} when parsing fails and no fallback is set.
+ */
+export function parseStructuredOutput(raw, opts) {
+    const cleaned = stripMarkdownFences(raw);
+    // ── Step 1: JSON.parse ───────────────────────────────────────────────────────
+    let parsed;
+    try {
+        parsed = JSON.parse(cleaned);
+    }
+    catch (err) {
+        if (opts?.fallback !== undefined) {
+            return opts.fallback;
+        }
+        throw new ParseStructuredOutputError(`Failed to JSON.parse LLM output: ${String(err)}`, raw, err);
+    }
+    // ── Step 2: Optional Zod validation ─────────────────────────────────────────
+    if (opts?.schema) {
+        const result = opts.schema.safeParse(parsed);
+        if (!result.success) {
+            if (opts.fallback !== undefined) {
+                return opts.fallback;
+            }
+            throw new ParseStructuredOutputError(`Zod validation failed: ${result.error.message}`, raw, result.error);
+        }
+        return result.data;
+    }
+    return parsed;
+}
+//# sourceMappingURL=parse-structured-output.js.map

package/dist/llm/parse-structured-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-structured-output.js","sourceRoot":"","sources":["../../src/llm/parse-structured-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,iFAAiF;AAEjF;;;;GAIG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACnD,qEAAqE;IAC5D,GAAG,CAAS;IACrB,+CAA+C;IAC7B,KAAK,CAAU;IAEjC,YAAY,OAAe,EAAE,GAAW,EAAE,KAAc;QACtD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,iFAAiF;AAEjF,uEAAuE;AACvE,SAAS,mBAAmB,CAAC,GAAW;IACtC,OAAO,GAAG;SACP,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;SAC3B,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;SACtB,IAAI,EAAE,CAAC;AACZ,CAAC;AAkBD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB,CACnC,GAAW,EACX,IAAmC;IAEnC,MAAM,OAAO,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAEzC,gFAAgF;IAChF,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,IAAI,EAAE,QAAQ,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,QAAQ,CAAC;QACvB,CAAC;QACD,MAAM,IAAI,0BAA0B,CAClC,oCAAoC,MAAM,CAAC,GAAG,CAAC,EAAE,EACjD,GAAG,EACH,GAAG,CACJ,CAAC;IACJ,CAAC;IAED,+EAA+E;IAC/E,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAChC,OAAO,IAAI,CAAC,QAAQ,CAAC;YACvB,CAAC;YACD,MAAM,IAAI,0BAA0B,CAClC,0BAA0B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAChD,GAAG,EACH,MAAM,CAAC,KAAK,CACb,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,OAAO,MAAW,CAAC;AACrB,CAAC"}

package/dist/loop/index.d.ts

@@ -0,0 +1,7 @@
+export { AgentLoop } from "./minimal-loop.js";
+export type { AgentLoopRunResult, AgentLoopConfig } from "./minimal-loop.js";
+export { SdkAgentLoop } from "./sdk-loop.js";
+export type { SdkAgentLoopConfig, SdkAgentLoopRunResult, SdkToolRegistry, SdkToolEntry, AgentToolCapabilityMarker, } from "./sdk-loop.js";
+export { ToolRegistryImpl, isValidToolName, zodToJsonSchema, } from "../tools/index.js";
+export type { AgentTool, MCPToolDefinition, ToolError, ToolErrorCode, ToolRegistry, ToolResult, } from "../tools/index.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/loop/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE7E,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,YAAY,EACZ,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,YAAY,EACZ,UAAU,GACX,MAAM,mBAAmB,CAAC"}

package/dist/loop/index.js

@@ -0,0 +1,5 @@
+export { AgentLoop } from "./minimal-loop.js";
+export { SdkAgentLoop } from "./sdk-loop.js";
+// Unified tool contract (preferred import site).
+export { ToolRegistryImpl, isValidToolName, zodToJsonSchema, } from "../tools/index.js";
+//# sourceMappingURL=index.js.map

package/dist/loop/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/loop/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAS7C,iDAAiD;AACjD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC"}

package/dist/loop/minimal-loop.d.ts

@@ -0,0 +1,81 @@
+/**
+ * minimal-loop — AgentLoop for multi-provider routing (Anthropic + Groq cascade).
+ *
+ * PUBLIC SURFACE — exactly 5 exports (1 class, 4 type re-exports). Any
+ * additional helpers MUST remain unexported.
+ */
+import { type Tracer } from "@opentelemetry/api";
+import type { ApprovalChannel } from "../hitl/approval-channel.js";
+import { type AgentBudgetState } from "../budget/budget-state.js";
+import type { ProviderRouter } from "../router/provider-router.js";
+import type { CapabilityGate } from "../permissions/capability-gate.js";
+import type { RenewalManager } from "../permissions/renewal-manager.js";
+export type { ToolRegistry } from "../tools/types.js";
+import type { ToolRegistry } from "../tools/types.js";
+interface AgentLoopConfig {
+    agentId: string;
+    agentVersion: string;
+    systemPrompt: string;
+    provider: ProviderRouter;
+    tools: ToolRegistry;
+    budget: AgentBudgetState;
+    approvalChannel?: ApprovalChannel;
+    tracker?: {
+        recordStep: (d: {
+            inputTokens: number;
+            outputTokens: number;
+            toolCalls?: number;
+            costUsd: number;
+        }) => Promise<void>;
+    };
+    /** Inject a tracer for tests. Defaults to the singleton OTel tracer. */
+    tracer?: Tracer;
+    /** HITL poll interval (ms). Default 500. */
+    approvalPollIntervalMs?: number;
+    /** HITL default timeout (ms). Default 60_000. */
+    approvalTimeoutMs?: number;
+    /**
+     * Optional Biscuit capability gate. When provided, every tool call is
+     * checked against the gate BEFORE dispatch. Denied calls produce a
+     * `tool_denied` event and a structured tool-result error; the loop
+     * continues with the next call (no panic).
+     */
+    capabilityGate?: CapabilityGate;
+    /**
+     * Hook fired when the capability gate denies a tool call. Receives the
+     * call name and the deny reason. Best-effort — exceptions are swallowed.
+     */
+    onToolDenied?: (event: {
+        toolName: string;
+        reason: string;
+        budgetUsed: number;
+    }) => void;
+    /**
+     * Coarse cost-per-call (USD). Default 0 (loop doesn't know LLM unit
+     * cost). Hosts that want budget enforcement set this to a per-call
+     * estimate; it accumulates across the loop and is passed to the gate.
+     */
+    costPerToolCallUsd?: number;
+    /**
+     * Optional auto-renewal. When provided, the loop calls `maybeRenew()`
+     * once per LLM iteration (before tool dispatch). The manager debounces
+     * and only re-issues when ≥80% of the token lifetime has elapsed.
+     */
+    renewalManager?: RenewalManager;
+}
+interface AgentLoopRunResult {
+    finalMessage: string;
+    stopReason: "complete" | "budget_exhausted" | "incoherent" | "tool_denied" | "user_cancelled" | "error";
+    budgetFinal: AgentBudgetState;
+    traceId: string;
+}
+declare class AgentLoopImpl {
+    private readonly config;
+    private readonly tracer;
+    constructor(config: AgentLoopConfig);
+    run(userMessage: string): Promise<AgentLoopRunResult>;
+    private awaitApproval;
+}
+export { AgentLoopImpl as AgentLoop };
+export type { AgentLoopRunResult, AgentLoopConfig };
+//# sourceMappingURL=minimal-loop.d.ts.map

package/dist/loop/minimal-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimal-loop.d.ts","sourceRoot":"","sources":["../../src/loop/minimal-loop.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAkB,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AASnE,OAAO,EACL,KAAK,gBAAgB,EAKtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAMxE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAc,MAAM,mBAAmB,CAAC;AAIlE,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,gBAAgB,CAAC;IACzB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,OAAO,CAAC,EAAE;QACR,UAAU,EAAE,CAAC,CAAC,EAAE;YACd,WAAW,EAAE,MAAM,CAAC;YACpB,YAAY,EAAE,MAAM,CAAC;YACrB,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,OAAO,EAAE,MAAM,CAAC;SACjB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACrB,CAAC;IACF,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,KAAK,IAAI,CAAC;IACX;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,UAAU,kBAAkB;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EACN,UAAU,GACV,kBAAkB,GAClB,YAAY,GACZ,aAAa,GACb,gBAAgB,GAChB,OAAO,CAAC;IACZ,WAAW,EAAE,gBAAgB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,cAAM,aAAa;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,EAAE,eAAe;IAK7B,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAmQ7C,aAAa;CA6B5B;AAyCD,OAAO,EAAE,aAAa,IAAI,SAAS,EAAE,CAAC;AACtC,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,CAAC"}

package/dist/loop/minimal-loop.js

@@ -0,0 +1,318 @@
+/**
+ * minimal-loop — AgentLoop for multi-provider routing (Anthropic + Groq cascade).
+ *
+ * PUBLIC SURFACE — exactly 5 exports (1 class, 4 type re-exports). Any
+ * additional helpers MUST remain unexported.
+ */
+import { SpanStatusCode } from "@opentelemetry/api";
+import { agentSpan, getTracer, llmSpan, recordLlmUsage, recordToolResult, toolSpan, } from "../tracking/gen-ai.js";
+import { compactToolLog, createCoherenceDetector, emergencyContextSummary, } from "../budget/budget-state.js";
+class AgentLoopImpl {
+    config;
+    tracer;
+    constructor(config) {
+        this.config = config;
+        this.tracer = config.tracer ?? getTracer("vauban-agent-sdk");
+    }
+    async run(userMessage) {
+        const runId = cryptoRandomId();
+        const rootSpan = agentSpan(this.tracer, {
+            agentId: this.config.agentId,
+            agentVersion: this.config.agentVersion,
+            runId,
+        });
+        const traceId = rootSpan.spanContext().traceId;
+        const log = [
+            { role: "system", content: this.config.systemPrompt },
+            { role: "user", content: userMessage },
+        ];
+        const coherence = createCoherenceDetector();
+        const recentCalls = [];
+        let stepsWithoutTool = 0;
+        let stopReason = "complete";
+        let finalMessage = "";
+        /** Cumulative tool-call cost across the loop (USD), for the gate. */
+        let budgetUsedUsd = 0;
+        try {
+            while (true) {
+                if (this.config.budget.stepCount >= this.config.budget.maxSteps) {
+                    stopReason = "budget_exhausted";
+                    break;
+                }
+                // Auto-renewal: best-effort, debounced inside the manager. A
+                // failed renewal is non-fatal — the existing token may still be
+                // valid; the gate will deny on the next call if it expired.
+                if (this.config.renewalManager) {
+                    try {
+                        await this.config.renewalManager.maybeRenew();
+                    }
+                    catch {
+                        /* swallow — verifier will surface expiry on next call */
+                    }
+                }
+                // Compaction trigger.
+                if (this.config.budget.stepCount > 0 &&
+                    this.config.budget.stepCount === this.config.budget.compactionTrigger) {
+                    const before = this.config.budget.contextWindow.currentTokens;
+                    const compacted = compactToolLog(log);
+                    log.splice(0, log.length, ...compacted);
+                    rootSpan.addEvent("gen_ai.agent.compacted", {
+                        before_tokens: before,
+                        after_tokens: this.config.budget.contextWindow.currentTokens,
+                    });
+                }
+                // Emergency summary if context > 90% of max.
+                const { contextWindow } = this.config.budget;
+                if (contextWindow.maxTokens > 0 &&
+                    contextWindow.currentTokens >
+                        Math.floor(contextWindow.maxTokens * 0.9)) {
+                    try {
+                        const summary = await emergencyContextSummary(log, async (prompt) => {
+                            const res = await this.config.provider.complete({
+                                messages: [{ role: "user", content: prompt }],
+                                maxTokens: 1024,
+                            });
+                            return res.content;
+                        }, { recursion: false });
+                        log.splice(0, log.length, {
+                            role: "system",
+                            content: `[context recap] ${summary}`,
+                        });
+                        contextWindow.currentTokens = estimateTokens(summary);
+                        rootSpan.addEvent("gen_ai.agent.emergency_summary", {
+                            tokens_after: contextWindow.currentTokens,
+                        });
+                    }
+                    catch (err) {
+                        rootSpan.addEvent("gen_ai.agent.emergency_summary_failed", {
+                            error: err?.message ?? String(err),
+                        });
+                    }
+                }
+                // ─── LLM round-trip ─────────────────────────────────────────────
+                const lSpan = llmSpan(this.tracer, {
+                    provider: "router",
+                    model: "auto",
+                    maxTokens: this.config.budget.tokensBudget.output,
+                    messageCount: log.length,
+                });
+                let response;
+                try {
+                    response = await this.config.provider.complete({
+                        messages: log.map((m) => ({ role: m.role, content: m.content })),
+                        maxTokens: this.config.budget.tokensBudget.output,
+                    });
+                    recordLlmUsage(lSpan, {
+                        inputTokens: response.usage.inputTokens,
+                        outputTokens: response.usage.outputTokens,
+                        latencyMs: response.latencyMs,
+                        finishReason: response.toolCalls.length > 0 ? "tool_use" : "stop",
+                    });
+                    lSpan.setAttribute("gen_ai.system", response.provider);
+                    lSpan.setStatus({ code: SpanStatusCode.OK });
+                }
+                catch (err) {
+                    lSpan.setStatus({
+                        code: SpanStatusCode.ERROR,
+                        message: err?.message,
+                    });
+                    lSpan.recordException(err);
+                    lSpan.end();
+                    throw err;
+                }
+                finally {
+                    if (lSpan.isRecording())
+                        lSpan.end();
+                }
+                // Counters.
+                this.config.budget.stepCount += 1;
+                this.config.budget.tokensBudget.usedInput += response.usage.inputTokens;
+                this.config.budget.tokensBudget.usedOutput +=
+                    response.usage.outputTokens;
+                this.config.budget.contextWindow.currentTokens +=
+                    response.usage.inputTokens + response.usage.outputTokens;
+                await this.config.tracker?.recordStep({
+                    inputTokens: response.usage.inputTokens,
+                    outputTokens: response.usage.outputTokens,
+                    toolCalls: response.toolCalls.length,
+                    costUsd: 0,
+                });
+                // ─── No tool call → assistant finalises. ────────────────────────
+                if (response.toolCalls.length === 0) {
+                    log.push({ role: "assistant", content: response.content });
+                    finalMessage = response.content;
+                    stopReason = "complete";
+                    break;
+                }
+                log.push({ role: "assistant", content: response.content });
+                stepsWithoutTool = 0;
+                // ─── Execute each tool call sequentially. ───────────────────────
+                let userCancelled = false;
+                for (const tc of response.toolCalls) {
+                    recentCalls.push({ name: tc.name, args: tc.args });
+                    const tool = this.config.tools.get(tc.name);
+                    const isDangerous = tool?.dangerous === true;
+                    // ─── Capability gate (Biscuit) — pre-dispatch. ────────────────
+                    if (this.config.capabilityGate) {
+                        let verdict;
+                        try {
+                            verdict = await this.config.capabilityGate.verify({
+                                toolName: tc.name,
+                                budgetUsed: budgetUsedUsd,
+                                mcpScopes: tool?.mcpScopes,
+                            });
+                        }
+                        catch {
+                            verdict = { allowed: false, reason: "gate_error" };
+                        }
+                        if (!verdict.allowed) {
+                            try {
+                                this.config.onToolDenied?.({
+                                    toolName: tc.name,
+                                    reason: verdict.reason,
+                                    budgetUsed: budgetUsedUsd,
+                                });
+                            }
+                            catch {
+                                /* best-effort */
+                            }
+                            rootSpan.addEvent("gen_ai.tool.denied", {
+                                tool_name: tc.name,
+                                reason: verdict.reason,
+                            });
+                            log.push({
+                                role: "tool",
+                                content: `ERROR: capability_denied:${verdict.reason}`,
+                                toolName: tc.name,
+                            });
+                            continue; // Token expiry / scope deny is graceful — try next call.
+                        }
+                        // Account this call against the per-loop budget for the
+                        // verifier on subsequent calls.
+                        budgetUsedUsd += this.config.costPerToolCallUsd ?? 0;
+                    }
+                    if (isDangerous) {
+                        if (!this.config.approvalChannel) {
+                            stopReason = "user_cancelled";
+                            userCancelled = true;
+                            break;
+                        }
+                        const approved = await this.awaitApproval(tc);
+                        if (!approved) {
+                            stopReason = "user_cancelled";
+                            userCancelled = true;
+                            break;
+                        }
+                    }
+                    const tSpan = toolSpan(this.tracer, tc.name, tc.args);
+                    const result = await this.config.tools.execute(tc.name, tc.args);
+                    recordToolResult(tSpan, {
+                        success: result.ok,
+                        errorMessage: result.ok ? undefined : result.error.message,
+                    });
+                    tSpan.end();
+                    const toolContent = summariseToolResult(result);
+                    log.push({ role: "tool", content: toolContent, toolName: tc.name });
+                }
+                if (userCancelled)
+                    break;
+                // ─── Coherence check on tool loop / stall. ──────────────────────
+                const verdict = coherence.check(recentCalls, stepsWithoutTool);
+                this.config.budget.coherenceScore = verdict.score;
+                if (verdict.isLoop || verdict.isStall) {
+                    stopReason = "incoherent";
+                    rootSpan.addEvent("gen_ai.agent.incoherent", {
+                        is_loop: verdict.isLoop,
+                        is_stall: verdict.isStall,
+                    });
+                    break;
+                }
+            }
+            rootSpan.setAttribute("gen_ai.agent.stop_reason", stopReason);
+            rootSpan.setStatus({ code: SpanStatusCode.OK });
+            return {
+                finalMessage,
+                stopReason,
+                budgetFinal: this.config.budget,
+                traceId,
+            };
+        }
+        catch (err) {
+            rootSpan.recordException(err);
+            rootSpan.setStatus({
+                code: SpanStatusCode.ERROR,
+                message: err?.message,
+            });
+            return {
+                finalMessage: "",
+                stopReason: "error",
+                budgetFinal: this.config.budget,
+                traceId,
+            };
+        }
+        finally {
+            rootSpan.end();
+        }
+    }
+    async awaitApproval(tc) {
+        const channel = this.config.approvalChannel;
+        if (!channel)
+            return false;
+        const timeoutMs = this.config.approvalTimeoutMs ?? 60_000;
+        const pollMs = this.config.approvalPollIntervalMs ?? 500;
+        const requestId = await channel.send({
+            agentId: this.config.agentId,
+            action: tc.name,
+            context: safeStringify(tc.args),
+            timeoutMs,
+        });
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+            const verdict = await channel.poll(requestId);
+            if (verdict !== null) {
+                return verdict.approved === true;
+            }
+            await sleep(pollMs);
+        }
+        await channel.cancel(requestId).catch(() => {
+            /* best-effort */
+        });
+        return false;
+    }
+}
+// ─── Helpers (unexported) ─────────────────────────────────────────────────
+function cryptoRandomId() {
+    const bytes = new Uint8Array(8);
+    if (typeof globalThis.crypto?.getRandomValues === "function") {
+        globalThis.crypto.getRandomValues(bytes);
+    }
+    else {
+        for (let i = 0; i < bytes.length; i++) {
+            bytes[i] = Math.floor(Math.random() * 256);
+        }
+    }
+    return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+}
+function safeStringify(v) {
+    try {
+        return typeof v === "string" ? v : (JSON.stringify(v) ?? "null");
+    }
+    catch {
+        return "[unserialisable]";
+    }
+}
+function summariseToolResult(r) {
+    if (r.ok) {
+        return safeStringify(r.data).slice(0, 2000);
+    }
+    return `ERROR: ${r.error.message}`;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function estimateTokens(s) {
+    return Math.ceil(s.length / 4);
+}
+// ─── PUBLIC SURFACE ───────────────────────────────────────────────────────
+export { AgentLoopImpl as AgentLoop };
+//# sourceMappingURL=minimal-loop.js.map

package/dist/loop/minimal-loop.js.map

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