@vauban-org/agent-sdk 0.16.0

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

@@ -0,0 +1,103 @@
+/**
+ * sdk-loop — Claude-native agent loop over `@anthropic-ai/sdk`.
+ *
+ * Parallel to minimal-loop (which runs over provider-router and supports
+ * Anthropic + Groq + fallbacks). sdk-loop takes the Anthropic-direct path:
+ * single provider, adaptive thinking, typed tool-use.
+ *
+ * Permissions are pinned at construction and enforced at tool-dispatch.
+ * Tools declare a `capability` via the AgentToolCapabilityMarker; missing
+ * markers default to `mcp` (safest).
+ *
+ * HITL gate: tools tagged `dangerous: true` route through an optional
+ * ApprovalChannel before execution.
+ *
+ * @experimental — surface may move before 1.0.0.
+ */
+import type Anthropic from "@anthropic-ai/sdk";
+import { type Tracer } from "@opentelemetry/api";
+import type { ApprovalChannel } from "../hitl/approval-channel.js";
+import { type SdkCapability, type SdkPermissions } from "../permissions/sdk-permissions.js";
+import type { CapabilityGate } from "../permissions/capability-gate.js";
+import type { RenewalManager } from "../permissions/renewal-manager.js";
+import type { AgentTool, ToolRegistry } from "../tools/types.js";
+export type SdkToolRegistry = ToolRegistry;
+/** @deprecated Use AgentTool from "@vauban-org/agent-sdk" directly. */
+export type SdkToolEntry = AgentTool;
+export interface AgentToolCapabilityMarker {
+    /** Capability surface this tool requires. Defaults to "mcp". */
+    capability?: SdkCapability;
+    /** Required MCP sub-scopes (e.g. ["brain:write"]). Only honoured when capability === "mcp". */
+    mcpScopes?: readonly string[];
+    /** If true, HITL approval required before each call. */
+    dangerous?: boolean;
+}
+export interface SdkAgentLoopConfig {
+    /** Stable agent identifier (e.g. "tester"). */
+    agentId: string;
+    /** Semver or git-sha tag for provenance. */
+    agentVersion: string;
+    /** System prompt; kept stable across turns for prompt-cache reuse. */
+    systemPrompt: string;
+    /** Anthropic SDK client — injected so tests can stub. */
+    client: Anthropic;
+    /** Model id (default: claude-opus-4-7). */
+    model?: string;
+    /** Max tokens per response. Default 16_000. */
+    maxTokens?: number;
+    /** Per-worker permissions — pinned at boot from JWT scopes. */
+    permissions: SdkPermissions;
+    /** Tool registry, filtered at dispatch through `permissions`. */
+    tools: SdkToolRegistry;
+    /** Optional HITL channel. Dangerous tools deny-closed when absent. */
+    approvalChannel?: ApprovalChannel;
+    /** Hard step ceiling; loop aborts with stopReason:"budget_exhausted". */
+    maxSteps?: number;
+    /** HITL poll interval (ms). Default 500. */
+    approvalPollIntervalMs?: number;
+    /** HITL default timeout (ms). Default 60_000. */
+    approvalTimeoutMs?: number;
+    /** Inject a tracer for tests. Defaults to the OTel singleton. */
+    tracer?: Tracer;
+    /**
+     * Optional Biscuit capability gate. When provided, every tool call is
+     * checked BEFORE dispatch — additionally to the pinned `cc:*` scope
+     * filter. The result is the INTERSECTION: a call must pass both the
+     * static permission projection and the dynamic Biscuit verdict.
+     */
+    capabilityGate?: CapabilityGate;
+    /** Hook fired when the gate denies. Best-effort. */
+    onToolDenied?: (event: {
+        toolName: string;
+        reason: string;
+        budgetUsed: number;
+    }) => void;
+    /** Per-call cost (USD); accumulates across the loop for the gate. */
+    costPerToolCallUsd?: number;
+    /**
+     * Optional auto-renewal manager. Loop calls `maybeRenew()` once per
+     * LLM iteration before dispatching tools.
+     */
+    renewalManager?: RenewalManager;
+}
+export interface SdkAgentLoopRunResult {
+    finalMessage: string;
+    stopReason: "complete" | "budget_exhausted" | "tool_denied" | "user_cancelled" | "max_tokens" | "error";
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    traceId: string;
+}
+declare class SdkAgentLoopImpl {
+    private readonly config;
+    constructor(config: SdkAgentLoopConfig);
+    /** Expose the pinned permissions for introspection / logging. */
+    get permissions(): SdkPermissions;
+    run(userMessage: string): Promise<SdkAgentLoopRunResult>;
+    private authoriseCall;
+    private awaitApproval;
+    private buildToolsParam;
+}
+export { SdkAgentLoopImpl as SdkAgentLoop };
+//# sourceMappingURL=sdk-loop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-loop.d.ts","sourceRoot":"","sources":["../../src/loop/sdk-loop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAkB,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AASnE,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,cAAc,EAGpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAMxE,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjE,MAAM,MAAM,eAAe,GAAG,YAAY,CAAC;AAC3C,uEAAuE;AACvE,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC;AAIrC,MAAM,WAAW,yBAAyB;IACxC,gEAAgE;IAChE,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,+FAA+F;IAC/F,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAID,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,MAAM,EAAE,SAAS,CAAC;IAClB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,WAAW,EAAE,cAAc,CAAC;IAC5B,iEAAiE;IACjE,KAAK,EAAE,eAAe,CAAC;IACvB,sEAAsE;IACtE,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,oDAAoD;IACpD,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,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EACN,UAAU,GACV,kBAAkB,GAClB,aAAa,GACb,gBAAgB,GAChB,YAAY,GACZ,OAAO,CAAC;IACZ,KAAK,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,cAAM,gBAAgB;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAiBrB;gBAEU,MAAM,EAAE,kBAAkB;IAsBtC,iEAAiE;IACjE,IAAI,WAAW,IAAI,cAAc,CAEhC;IAEK,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;YAyLhD,aAAa;YAoDb,aAAa;IA8B3B,OAAO,CAAC,eAAe;CAsBxB;AAsCD,OAAO,EAAE,gBAAgB,IAAI,YAAY,EAAE,CAAC"}

package/dist/loop/sdk-loop.js

@@ -0,0 +1,344 @@
+/**
+ * sdk-loop — Claude-native agent loop over `@anthropic-ai/sdk`.
+ *
+ * Parallel to minimal-loop (which runs over provider-router and supports
+ * Anthropic + Groq + fallbacks). sdk-loop takes the Anthropic-direct path:
+ * single provider, adaptive thinking, typed tool-use.
+ *
+ * Permissions are pinned at construction and enforced at tool-dispatch.
+ * Tools declare a `capability` via the AgentToolCapabilityMarker; missing
+ * markers default to `mcp` (safest).
+ *
+ * HITL gate: tools tagged `dangerous: true` route through an optional
+ * ApprovalChannel before execution.
+ *
+ * @experimental — surface may move before 1.0.0.
+ */
+import { SpanStatusCode } from "@opentelemetry/api";
+import { agentSpan, getTracer, llmSpan, recordLlmUsage, recordToolResult, toolSpan, } from "../tracking/gen-ai.js";
+import { permitsCapability, permitsMcpScopes, } from "../permissions/sdk-permissions.js";
+// ─── Implementation ────────────────────────────────────────────────────────
+class SdkAgentLoopImpl {
+    config;
+    constructor(config) {
+        this.config = {
+            agentId: config.agentId,
+            agentVersion: config.agentVersion,
+            systemPrompt: config.systemPrompt,
+            client: config.client,
+            model: config.model ?? "claude-opus-4-7",
+            maxTokens: config.maxTokens ?? 16_000,
+            permissions: config.permissions,
+            tools: config.tools,
+            approvalChannel: config.approvalChannel,
+            maxSteps: config.maxSteps ?? 25,
+            approvalPollIntervalMs: config.approvalPollIntervalMs ?? 500,
+            approvalTimeoutMs: config.approvalTimeoutMs ?? 60_000,
+            tracer: config.tracer ?? getTracer("vauban-agent-sdk"),
+            capabilityGate: config.capabilityGate,
+            onToolDenied: config.onToolDenied,
+            costPerToolCallUsd: config.costPerToolCallUsd ?? 0,
+            renewalManager: config.renewalManager,
+        };
+    }
+    /** Expose the pinned permissions for introspection / logging. */
+    get permissions() {
+        return this.config.permissions;
+    }
+    async run(userMessage) {
+        const rootSpan = agentSpan(this.config.tracer, {
+            agentId: this.config.agentId,
+            agentVersion: this.config.agentVersion,
+            runId: cryptoRandomId(),
+        });
+        const traceId = rootSpan.spanContext().traceId;
+        const messages = [
+            { role: "user", content: userMessage },
+        ];
+        const toolParams = this.buildToolsParam();
+        let inputTokens = 0;
+        let outputTokens = 0;
+        let steps = 0;
+        let finalMessage = "";
+        let stopReason = "complete";
+        /** Cumulative tool-call cost (USD) — fed to the capability gate. */
+        let budgetUsedUsd = 0;
+        try {
+            while (steps < this.config.maxSteps) {
+                steps += 1;
+                if (this.config.renewalManager) {
+                    try {
+                        await this.config.renewalManager.maybeRenew();
+                    }
+                    catch {
+                        /* swallow — verifier surfaces expiry on next call */
+                    }
+                }
+                const lSpan = llmSpan(this.config.tracer, {
+                    provider: "anthropic",
+                    model: this.config.model,
+                    maxTokens: this.config.maxTokens,
+                    messageCount: messages.length,
+                });
+                let response;
+                try {
+                    response = await this.config.client.messages.create({
+                        model: this.config.model,
+                        max_tokens: this.config.maxTokens,
+                        system: this.config.systemPrompt,
+                        messages,
+                        ...(toolParams.length > 0 ? { tools: toolParams } : {}),
+                    });
+                    recordLlmUsage(lSpan, {
+                        inputTokens: response.usage.input_tokens,
+                        outputTokens: response.usage.output_tokens,
+                        latencyMs: 0,
+                        finishReason: String(response.stop_reason ?? "unknown"),
+                    });
+                    lSpan.setStatus({ code: SpanStatusCode.OK });
+                }
+                catch (err) {
+                    lSpan.setStatus({
+                        code: SpanStatusCode.ERROR,
+                        message: err?.message,
+                    });
+                    lSpan.recordException(err);
+                    throw err;
+                }
+                finally {
+                    if (lSpan.isRecording())
+                        lSpan.end();
+                }
+                inputTokens += response.usage.input_tokens;
+                outputTokens += response.usage.output_tokens;
+                if (response.stop_reason === "max_tokens") {
+                    stopReason = "max_tokens";
+                    finalMessage = extractText(response.content);
+                    break;
+                }
+                const toolUses = response.content.filter((b) => b.type === "tool_use");
+                if (toolUses.length === 0) {
+                    finalMessage = extractText(response.content);
+                    stopReason = "complete";
+                    break;
+                }
+                messages.push({ role: "assistant", content: response.content });
+                const toolResults = [];
+                let cancelled = false;
+                for (const call of toolUses) {
+                    const verdict = await this.authoriseCall(call, budgetUsedUsd);
+                    if (verdict === "deny") {
+                        toolResults.push({
+                            type: "tool_result",
+                            tool_use_id: call.id,
+                            is_error: true,
+                            content: "permission_denied",
+                        });
+                        stopReason = "tool_denied";
+                        cancelled = true;
+                        break;
+                    }
+                    if (verdict === "capability_denied") {
+                        // Biscuit gate denied (token expired, scope mismatch, budget).
+                        // Graceful: surface to LLM as a tool error, allow the loop to
+                        // continue. Halt only when ALL calls in this batch fail —
+                        // see `cancelled` flag; we keep going within this batch.
+                        toolResults.push({
+                            type: "tool_result",
+                            tool_use_id: call.id,
+                            is_error: true,
+                            content: "capability_denied",
+                        });
+                        continue;
+                    }
+                    if (verdict === "cancelled") {
+                        toolResults.push({
+                            type: "tool_result",
+                            tool_use_id: call.id,
+                            is_error: true,
+                            content: "user_cancelled",
+                        });
+                        stopReason = "user_cancelled";
+                        cancelled = true;
+                        break;
+                    }
+                    budgetUsedUsd += this.config.costPerToolCallUsd;
+                    const tSpan = toolSpan(this.config.tracer, call.name, call.input);
+                    const exec = await this.config.tools.execute(call.name, call.input);
+                    recordToolResult(tSpan, {
+                        success: exec.ok,
+                        errorMessage: exec.ok ? undefined : exec.error.message,
+                    });
+                    tSpan.end();
+                    toolResults.push({
+                        type: "tool_result",
+                        tool_use_id: call.id,
+                        is_error: !exec.ok,
+                        content: exec.ok
+                            ? safeStringify(exec.data).slice(0, 2000)
+                            : `ERROR: ${exec.error.message}`,
+                    });
+                }
+                messages.push({ role: "user", content: toolResults });
+                if (cancelled)
+                    break;
+            }
+            if (steps >= this.config.maxSteps && stopReason === "complete") {
+                stopReason = "budget_exhausted";
+            }
+            rootSpan.setAttribute("gen_ai.agent.stop_reason", stopReason);
+            rootSpan.setStatus({ code: SpanStatusCode.OK });
+            return {
+                finalMessage,
+                stopReason,
+                usage: { inputTokens, outputTokens },
+                traceId,
+            };
+        }
+        catch (err) {
+            rootSpan.recordException(err);
+            rootSpan.setStatus({
+                code: SpanStatusCode.ERROR,
+                message: err?.message,
+            });
+            return {
+                finalMessage: "",
+                stopReason: "error",
+                usage: { inputTokens, outputTokens },
+                traceId,
+            };
+        }
+        finally {
+            rootSpan.end();
+        }
+    }
+    // ─── Tool authorisation path ──────────────────────────────────────────
+    async authoriseCall(call, budgetUsedUsd) {
+        const tool = this.config.tools.get(call.name);
+        if (!tool)
+            return "deny";
+        const capability = tool.capability ?? "mcp";
+        if (!permitsCapability(this.config.permissions, capability))
+            return "deny";
+        if (capability === "mcp" && tool.mcpScopes) {
+            if (!permitsMcpScopes(this.config.permissions, tool.mcpScopes))
+                return "deny";
+        }
+        // Biscuit capability gate — INTERSECTION with the cc:* projection.
+        // The static `permissions` filter has already ruled out anything the
+        // worker's JWT doesn't grant; the dynamic gate now verifies the
+        // request against the agent's signed capability token.
+        if (this.config.capabilityGate) {
+            let verdict;
+            try {
+                verdict = await this.config.capabilityGate.verify({
+                    toolName: call.name,
+                    budgetUsed: budgetUsedUsd,
+                    mcpScopes: tool.mcpScopes,
+                });
+            }
+            catch {
+                verdict = { allowed: false, reason: "gate_error" };
+            }
+            if (!verdict.allowed) {
+                try {
+                    this.config.onToolDenied?.({
+                        toolName: call.name,
+                        reason: verdict.reason,
+                        budgetUsed: budgetUsedUsd,
+                    });
+                }
+                catch {
+                    /* best-effort */
+                }
+                return "capability_denied";
+            }
+        }
+        if (tool.dangerous) {
+            if (!this.config.approvalChannel)
+                return "deny";
+            const approved = await this.awaitApproval(tool, call.input);
+            return approved ? "allow" : "cancelled";
+        }
+        return "allow";
+    }
+    async awaitApproval(tool, args) {
+        const channel = this.config.approvalChannel;
+        if (!channel)
+            return false;
+        const timeoutMs = this.config.approvalTimeoutMs;
+        const pollMs = this.config.approvalPollIntervalMs;
+        const requestId = await channel.send({
+            agentId: this.config.agentId,
+            action: tool.name,
+            context: safeStringify(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;
+    }
+    // ─── Tool schema projection (permissions-filtered) ────────────────────
+    buildToolsParam() {
+        const out = [];
+        for (const def of this.config.tools.listMCPDefinitions()) {
+            const tool = this.config.tools.get(def.name);
+            if (!tool)
+                continue;
+            const capability = tool.capability ?? "mcp";
+            if (!permitsCapability(this.config.permissions, capability))
+                continue;
+            if (capability === "mcp" &&
+                tool.mcpScopes &&
+                !permitsMcpScopes(this.config.permissions, tool.mcpScopes)) {
+                continue;
+            }
+            out.push({
+                name: def.name,
+                description: def.description ?? "",
+                input_schema: def.inputSchema,
+            });
+        }
+        return out;
+    }
+}
+// ─── 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 extractText(content) {
+    return content
+        .filter((b) => b.type === "text")
+        .map((b) => b.text)
+        .join("");
+}
+function safeStringify(v) {
+    try {
+        return typeof v === "string" ? v : (JSON.stringify(v) ?? "null");
+    }
+    catch {
+        return "[unserialisable]";
+    }
+}
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+// ─── PUBLIC SURFACE ───────────────────────────────────────────────────────
+export { SdkAgentLoopImpl as SdkAgentLoop };
+//# sourceMappingURL=sdk-loop.js.map

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

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * MCP subpath — @vauban-org/agent-sdk/mcp
+ *
+ * Sprint-563: B5 — Convert a Vauban SkillRegistry (Record<string, Skill>)
+ * into MCP-compatible tool definitions + call handler.
+ *
+ * Peer dependency: @modelcontextprotocol/sdk >= 1.5.0 (optional).
+ */
+import type { SkillRegistry } from "../orchestration/ooda/skills.js";
+export interface MCPToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+        additionalProperties?: boolean;
+    };
+}
+export interface MCPServerOptions {
+    name: string;
+    version: string;
+}
+/**
+ * Convert a Vauban SkillRegistry into MCP-compatible tool list + handler.
+ */
+export declare function skillRegistryToMCPServer(registry: SkillRegistry, opts: MCPServerOptions): {
+    name: string;
+    version: string;
+    tools: MCPToolDefinition[];
+    handleToolCall: (toolName: string, args: Record<string, unknown>) => Promise<{
+        content: Array<{
+            type: "text";
+            text: string;
+        }>;
+    }>;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;KAChC,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,gBAAgB,GACrB;IACD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,cAAc,EAAE,CACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CAClE,CAuFA"}

package/dist/mcp/index.js

@@ -0,0 +1,113 @@
+/**
+ * MCP subpath — @vauban-org/agent-sdk/mcp
+ *
+ * Sprint-563: B5 — Convert a Vauban SkillRegistry (Record<string, Skill>)
+ * into MCP-compatible tool definitions + call handler.
+ *
+ * Peer dependency: @modelcontextprotocol/sdk >= 1.5.0 (optional).
+ */
+/**
+ * Convert a Vauban SkillRegistry into MCP-compatible tool list + handler.
+ */
+export function skillRegistryToMCPServer(registry, opts) {
+    const tools = [];
+    for (const [name, skill] of Object.entries(registry)) {
+        const inputSchema = {
+            type: "object",
+            properties: {},
+            additionalProperties: false,
+        };
+        // Try to extract JSON Schema from Zod if available
+        if (skill.inputSchema && typeof skill.inputSchema === "object") {
+            try {
+                const zodSchema = skill.inputSchema;
+                if (zodSchema.shape) {
+                    inputSchema.properties = {};
+                    for (const [key, def] of Object.entries(zodSchema.shape)) {
+                        inputSchema.properties[key] = {
+                            type: inferJsonSchemaType(def),
+                            description: `Parameter: ${key}`,
+                        };
+                    }
+                }
+            }
+            catch {
+                // Keep defaults
+            }
+        }
+        tools.push({
+            name,
+            description: skill.name,
+            inputSchema,
+        });
+    }
+    return {
+        name: opts.name,
+        version: opts.version,
+        tools,
+        async handleToolCall(toolName, args) {
+            const skill = registry[toolName];
+            if (!skill) {
+                return {
+                    content: [{ type: "text", text: `Unknown tool: ${toolName}` }],
+                };
+            }
+            try {
+                // Validate input if schema available
+                let input = args;
+                if (skill.inputSchema) {
+                    try {
+                        input = skill.inputSchema.parse(args);
+                    }
+                    catch (parseErr) {
+                        return {
+                            content: [{ type: "text", text: `Invalid arguments: ${String(parseErr)}` }],
+                        };
+                    }
+                }
+                const result = await skill.execute(input, {
+                    isReplay: false,
+                    dryRunMocks: {},
+                    db: undefined,
+                    logger: { info: () => { }, warn: () => { }, error: () => { }, debug: () => { } },
+                });
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: typeof result === "string" ? result : JSON.stringify(result, null, 2),
+                        },
+                    ],
+                };
+            }
+            catch (err) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Tool execution error: ${err instanceof Error ? err.message : String(err)}`,
+                        },
+                    ],
+                };
+            }
+        },
+    };
+}
+function inferJsonSchemaType(def) {
+    if (!def || typeof def !== "object")
+        return "string";
+    const d = def;
+    const innerDef = d._def;
+    if (innerDef?.typeName) {
+        switch (innerDef.typeName) {
+            case "ZodString": return "string";
+            case "ZodNumber": return "number";
+            case "ZodBoolean": return "boolean";
+            case "ZodArray": return "array";
+            case "ZodObject": return "object";
+            default: return "string";
+        }
+    }
+    return "string";
+}
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

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