@vauban-org/agent-sdk 1.0.0 → 1.3.0

package/dist/container/runtime.js

@@ -0,0 +1,256 @@
+/**
+ * ContainerRuntime — execute automations as local binaries or as containers,
+ * speaking the {@link ./protocol.ts | Container Execution Protocol}.
+ *
+ * Two modes:
+ *
+ *   - **Binary**: spawn a local executable directly (Rust/Go/Python binary).
+ *     The runtime uses `node:child_process.spawn` by default; tests inject a
+ *     `SpawnFn` to avoid actually running anything.
+ *
+ *   - **Container**: delegate to a host-provided {@link SandboxExecutor}.
+ *     This is structurally compatible with Command Center's `DockerExecutor`
+ *     (hardened isolation), so the SDK stays decoupled from any specific
+ *     sandbox implementation.
+ *
+ * @public @since 1.2.0
+ */
+import { randomUUID } from "node:crypto";
+import { spawn as nodeSpawn } from "node:child_process";
+import { buildProtocolEnv, parseProtocolOutput, parseStderrLogs, ProtocolParseError, } from "./protocol.js";
+const DEFAULT_TIMEOUT_SECONDS = 300;
+const MAX_OUTPUT_BYTES = 1_048_576; // 1 MB
+const TRUNCATION_MARKER = "\n[TRUNCATED — output exceeded 1 MB]";
+/**
+ * Run automations via either a sandboxed container (host-injected) or a local
+ * binary subprocess. Both paths produce a uniform {@link ExecutionResult}.
+ *
+ * @public
+ */
+export class ContainerRuntime {
+    sandbox;
+    spawnFn;
+    defaultTimeoutSeconds;
+    constructor(opts = {}) {
+        this.sandbox = opts.sandbox;
+        this.spawnFn = opts.spawnFn ?? nodeSpawn;
+        this.defaultTimeoutSeconds =
+            opts.defaultTimeoutSeconds ?? DEFAULT_TIMEOUT_SECONDS;
+    }
+    /**
+     * Execute an automation packaged as a container image. Delegates to the
+     * injected {@link SandboxExecutor} so isolation policy (caps, network,
+     * read-only FS) lives in the host implementation.
+     */
+    async executeContainer(image, automationName, input, options = {}) {
+        if (!this.sandbox) {
+            throw new Error("ContainerRuntime.executeContainer: no SandboxExecutor injected");
+        }
+        const executionId = options.executionId ?? randomUUID();
+        const timeoutSeconds = options.timeoutSeconds ?? this.defaultTimeoutSeconds;
+        const startedAt = new Date();
+        const env = buildProtocolEnv({
+            executionId,
+            automationName,
+            input,
+            timeoutSeconds,
+            mode: options.mode,
+            extraEnv: options.extraEnv,
+        });
+        const job = {
+            image,
+            command: [],
+            env,
+            timeoutMs: timeoutSeconds * 1000,
+            networkMode: options.networkMode ?? "none",
+            readOnlyRoot: options.readOnlyRoot ?? true,
+            memoryMb: options.memoryMb ?? 256,
+            cpuQuota: options.cpuQuota ?? 0.5,
+        };
+        const result = await this.sandbox.run(job);
+        return this.toExecutionResult({
+            executionId,
+            automationName,
+            input,
+            startedAt,
+            sandboxResult: result,
+        });
+    }
+    /**
+     * Execute an automation packaged as a local binary (Rust release, Python
+     * wrapper, shell script). No container — just a hardened subprocess.
+     */
+    async executeBinary(command, automationName, input, options = {}) {
+        if (!Array.isArray(command) || command.length === 0) {
+            throw new Error("ContainerRuntime.executeBinary: command must be a non-empty array");
+        }
+        const executionId = options.executionId ?? randomUUID();
+        const timeoutSeconds = options.timeoutSeconds ?? this.defaultTimeoutSeconds;
+        const startedAt = new Date();
+        const protocolEnv = buildProtocolEnv({
+            executionId,
+            automationName,
+            input,
+            timeoutSeconds,
+            mode: options.mode,
+            extraEnv: options.extraEnv,
+        });
+        const env = { ...process.env, ...protocolEnv };
+        const result = await this.runSubprocess({
+            cmd: command[0],
+            args: command.slice(1),
+            env,
+            cwd: options.cwd,
+            timeoutMs: timeoutSeconds * 1000,
+        });
+        return this.toExecutionResult({
+            executionId,
+            automationName,
+            input,
+            startedAt,
+            sandboxResult: result,
+        });
+    }
+    // ─── Internals ────────────────────────────────────────────────────────
+    async runSubprocess(args) {
+        const startedAt = Date.now();
+        const abortController = new AbortController();
+        const timeoutHandle = setTimeout(() => abortController.abort(), args.timeoutMs);
+        let stdoutBuf = "";
+        let stderrBuf = "";
+        let timedOut = false;
+        const spawnOpts = {
+            env: args.env,
+            stdio: ["pipe", "pipe", "pipe"],
+            signal: abortController.signal,
+        };
+        if (args.cwd !== undefined)
+            spawnOpts.cwd = args.cwd;
+        const child = this.spawnFn(args.cmd, args.args, spawnOpts);
+        if (child.stdin)
+            child.stdin.end();
+        child.stdout?.on("data", (chunk) => {
+            const remaining = MAX_OUTPUT_BYTES - Buffer.byteLength(stdoutBuf, "utf8");
+            if (remaining <= 0)
+                return;
+            const piece = chunk.toString("utf8");
+            if (Buffer.byteLength(piece, "utf8") <= remaining) {
+                stdoutBuf += piece;
+            }
+            else {
+                stdoutBuf += piece.slice(0, remaining) + TRUNCATION_MARKER;
+            }
+        });
+        child.stderr?.on("data", (chunk) => {
+            const remaining = MAX_OUTPUT_BYTES - Buffer.byteLength(stderrBuf, "utf8");
+            if (remaining <= 0)
+                return;
+            const piece = chunk.toString("utf8");
+            if (Buffer.byteLength(piece, "utf8") <= remaining) {
+                stderrBuf += piece;
+            }
+            else {
+                stderrBuf += piece.slice(0, remaining) + TRUNCATION_MARKER;
+            }
+        });
+        const exitCode = await new Promise((resolve) => {
+            child.on("close", (code) => resolve(code ?? 1));
+            child.on("error", (err) => {
+                if (err.name === "AbortError" || abortController.signal.aborted) {
+                    timedOut = true;
+                    resolve(137);
+                }
+                else {
+                    resolve(1);
+                }
+            });
+        });
+        clearTimeout(timeoutHandle);
+        return {
+            exitCode,
+            stdout: stdoutBuf,
+            stderr: stderrBuf,
+            timedOut,
+            durationMs: Date.now() - startedAt,
+        };
+    }
+    toExecutionResult(args) {
+        const completedAt = new Date(args.startedAt.getTime() + args.sandboxResult.durationMs);
+        const logs = parseStderrLogs(args.sandboxResult.stderr);
+        if (args.sandboxResult.timedOut) {
+            return {
+                executionId: args.executionId,
+                automationName: args.automationName,
+                status: "timeout",
+                input: args.input,
+                error: {
+                    code: "TIMEOUT",
+                    message: `execution timed out after ${args.sandboxResult.durationMs}ms`,
+                },
+                startedAt: args.startedAt,
+                completedAt,
+                durationMs: args.sandboxResult.durationMs,
+                logs,
+            };
+        }
+        // Try to parse the protocol result FIRST — a non-zero exit with a valid
+        // protocol "failed" payload is a business failure, not a container crash.
+        try {
+            const protocol = parseProtocolOutput(args.sandboxResult.stdout);
+            if (protocol.status === "completed") {
+                return {
+                    executionId: args.executionId,
+                    automationName: args.automationName,
+                    status: "completed",
+                    input: args.input,
+                    output: protocol.output,
+                    startedAt: args.startedAt,
+                    completedAt,
+                    durationMs: args.sandboxResult.durationMs,
+                    logs,
+                };
+            }
+            return {
+                executionId: args.executionId,
+                automationName: args.automationName,
+                status: "failed",
+                input: args.input,
+                error: { ...protocol.error },
+                startedAt: args.startedAt,
+                completedAt,
+                durationMs: args.sandboxResult.durationMs,
+                logs,
+            };
+        }
+        catch (err) {
+            // No parseable protocol output. If the process exited non-zero, surface
+            // it as a container crash; otherwise the binary returned 0 but said
+            // nothing useful — also a protocol violation.
+            const code = args.sandboxResult.exitCode === 0
+                ? "INVALID_OUTPUT"
+                : "CONTAINER_EXIT_ERROR";
+            const message = args.sandboxResult.exitCode === 0
+                ? "process exited 0 but produced no protocol result"
+                : `process exited with code ${args.sandboxResult.exitCode}`;
+            const stderrTail = args.sandboxResult.stderr.slice(-2000);
+            const stdoutTail = args.sandboxResult.stdout.slice(-2000);
+            const rawTail = err instanceof ProtocolParseError ? err.rawTail : "";
+            return {
+                executionId: args.executionId,
+                automationName: args.automationName,
+                status: "failed",
+                input: args.input,
+                error: {
+                    code,
+                    message,
+                    details: { stderr: stderrTail, stdout: stdoutTail, rawTail },
+                },
+                startedAt: args.startedAt,
+                completedAt,
+                durationMs: args.sandboxResult.durationMs,
+                logs,
+            };
+        }
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/container/runtime.js.map

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

package/dist/events/catalogue.d.ts

@@ -52,15 +52,15 @@ export declare const EventSchemas: {
         costUsd: z.ZodNumber;
     }, "strict", z.ZodTypeAny, {
         runId: string;
+        costUsd: number;
         durationMs: number;
         agentName: string;
-        costUsd: number;
         outputs?: unknown;
     }, {
         runId: string;
+        costUsd: number;
         durationMs: number;
         agentName: string;
-        costUsd: number;
         outputs?: unknown;
     }>;
     readonly "agent.failed": z.ZodObject<{
@@ -112,11 +112,11 @@ export declare const EventSchemas: {
     }, "strict", z.ZodTypeAny, {
         slo: string;
         burnRate: number;
-        severity: "critical" | "low" | "medium" | "high";
+        severity: "low" | "medium" | "high" | "critical";
     }, {
         slo: string;
         burnRate: number;
-        severity: "critical" | "low" | "medium" | "high";
+        severity: "low" | "medium" | "high" | "critical";
     }>;
     readonly "incident.detected": z.ZodObject<{
         source: z.ZodString;
@@ -124,11 +124,11 @@ export declare const EventSchemas: {
         summary: z.ZodString;
     }, "strict", z.ZodTypeAny, {
         source: string;
-        severity: "critical" | "low" | "medium" | "high";
+        severity: "low" | "medium" | "high" | "critical";
         summary: string;
     }, {
         source: string;
-        severity: "critical" | "low" | "medium" | "high";
+        severity: "low" | "medium" | "high" | "critical";
         summary: string;
     }>;
     readonly "forge.inbox.reply_classified": z.ZodObject<{
@@ -143,23 +143,23 @@ export declare const EventSchemas: {
         schemaVersion: z.ZodString;
     }, "strict", z.ZodTypeAny, {
         type: "INTERESTED" | "NOT_INTERESTED" | "BOUNCE" | "SPAM" | "OTHER";
+        priority: "HIGH" | "MEDIUM" | "LOW";
         timestamp: string;
         schemaVersion: string;
-        uid: string;
+        signal: string;
         from: string;
         subject: string;
-        priority: "HIGH" | "MEDIUM" | "LOW";
-        signal: string;
+        uid: string;
         nextAction: string;
     }, {
         type: "INTERESTED" | "NOT_INTERESTED" | "BOUNCE" | "SPAM" | "OTHER";
+        priority: "HIGH" | "MEDIUM" | "LOW";
         timestamp: string;
         schemaVersion: string;
-        uid: string;
+        signal: string;
         from: string;
         subject: string;
-        priority: "HIGH" | "MEDIUM" | "LOW";
-        signal: string;
+        uid: string;
         nextAction: string;
     }>;
     readonly "forge.lead.qualified": z.ZodObject<{
@@ -168,12 +168,12 @@ export declare const EventSchemas: {
         source: z.ZodEnum<["inbound", "outbound", "referral"]>;
     }, "strict", z.ZodTypeAny, {
         source: "inbound" | "outbound" | "referral";
-        leadId: string;
         score: number;
+        leadId: string;
     }, {
         source: "inbound" | "outbound" | "referral";
-        leadId: string;
         score: number;
+        leadId: string;
     }>;
     readonly "forge.outreach.sent": z.ZodObject<{
         leadId: z.ZodString;
@@ -181,22 +181,22 @@ export declare const EventSchemas: {
         content: z.ZodString;
     }, "strict", z.ZodTypeAny, {
         content: string;
+        channel: "telegram" | "email" | "linkedin" | "x";
         leadId: string;
-        channel: "email" | "linkedin" | "x" | "telegram";
     }, {
         content: string;
+        channel: "telegram" | "email" | "linkedin" | "x";
         leadId: string;
-        channel: "email" | "linkedin" | "x" | "telegram";
     }>;
     readonly "forge.policy.triggered": z.ZodObject<{
         policyId: z.ZodString;
         context: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, "strict", z.ZodTypeAny, {
-        policyId: string;
         context: Record<string, unknown>;
-    }, {
         policyId: string;
+    }, {
         context: Record<string, unknown>;
+        policyId: string;
     }>;
     readonly "vauban.vault.rebalance_proposed": z.ZodObject<{
         vaultId: z.ZodString;
@@ -232,16 +232,16 @@ export declare const EventSchemas: {
             expected: z.ZodUnion<[z.ZodString, z.ZodNumber]>;
             description: z.ZodString;
         }, "strip", z.ZodTypeAny, {
+            expected: string | number;
             type: string;
             description: string;
-            expected: string | number;
             severity: "error" | "info" | "critical" | "warning";
             metric: string;
             current: string | number;
         }, {
+            expected: string | number;
             type: string;
             description: string;
-            expected: string | number;
             severity: "error" | "info" | "critical" | "warning";
             metric: string;
             current: string | number;
@@ -253,30 +253,30 @@ export declare const EventSchemas: {
         timestamp: string;
         schemaVersion: string;
         vaultId: string;
+        overallSeverity: "error" | "info" | "critical" | "warning";
         tvlUsd: number;
         anomalies: {
+            expected: string | number;
             type: string;
             description: string;
-            expected: string | number;
             severity: "error" | "info" | "critical" | "warning";
             metric: string;
             current: string | number;
         }[];
-        overallSeverity: "error" | "info" | "critical" | "warning";
     }, {
         timestamp: string;
         schemaVersion: string;
         vaultId: string;
+        overallSeverity: "error" | "info" | "critical" | "warning";
         tvlUsd: number;
         anomalies: {
+            expected: string | number;
             type: string;
             description: string;
-            expected: string | number;
             severity: "error" | "info" | "critical" | "warning";
             metric: string;
             current: string | number;
         }[];
-        overallSeverity: "error" | "info" | "critical" | "warning";
     }>;
     readonly "vauban.goal.checked": z.ZodObject<{
         goalId: z.ZodString;
@@ -289,13 +289,13 @@ export declare const EventSchemas: {
         schemaVersion: string;
         goalId: string;
         successRate: number;
-        alertLevel: "critical" | "warning" | "none";
+        alertLevel: "none" | "critical" | "warning";
     }, {
         timestamp: string;
         schemaVersion: string;
         goalId: string;
         successRate: number;
-        alertLevel: "critical" | "warning" | "none";
+        alertLevel: "none" | "critical" | "warning";
     }>;
     readonly "vauban.rebalancing.checked": z.ZodObject<{
         portfolioId: z.ZodString;
@@ -306,13 +306,13 @@ export declare const EventSchemas: {
     }, "strict", z.ZodTypeAny, {
         timestamp: string;
         schemaVersion: string;
-        alertLevel: "critical" | "warning" | "none";
+        alertLevel: "none" | "critical" | "warning";
         portfolioId: string;
         maxDrift: number;
     }, {
         timestamp: string;
         schemaVersion: string;
-        alertLevel: "critical" | "warning" | "none";
+        alertLevel: "none" | "critical" | "warning";
         portfolioId: string;
         maxDrift: number;
     }>;
@@ -325,14 +325,14 @@ export declare const EventSchemas: {
     }, "strict", z.ZodTypeAny, {
         timestamp: string;
         schemaVersion: string;
-        alertLevel: "critical" | "warning" | "none";
         userId: string;
+        alertLevel: "none" | "critical" | "warning";
         rulesTriggered: string[];
     }, {
         timestamp: string;
         schemaVersion: string;
-        alertLevel: "critical" | "warning" | "none";
         userId: string;
+        alertLevel: "none" | "critical" | "warning";
         rulesTriggered: string[];
     }>;
     readonly "vauban.vault.compounded": z.ZodObject<{
@@ -402,23 +402,23 @@ export declare const EventSchemas: {
         userId: z.ZodString;
         method: z.ZodEnum<["zk_passport", "zk_email", "world_id"]>;
     }, "strict", z.ZodTypeAny, {
-        userId: string;
         method: "zk_passport" | "zk_email" | "world_id";
-    }, {
         userId: string;
+    }, {
         method: "zk_passport" | "zk_email" | "world_id";
+        userId: string;
     }>;
     readonly "citadel.sprint.closed": z.ZodObject<{
         sprintId: z.ZodString;
         completed: z.ZodNumber;
         carryOver: z.ZodNumber;
     }, "strict", z.ZodTypeAny, {
-        sprintId: string;
         completed: number;
+        sprintId: string;
         carryOver: number;
     }, {
-        sprintId: string;
         completed: number;
+        sprintId: string;
         carryOver: number;
     }>;
     readonly "citadel.sprint.analyzed": z.ZodObject<{
@@ -448,29 +448,29 @@ export declare const EventSchemas: {
     }, "strict", z.ZodTypeAny, {
         timestamp: string;
         schemaVersion: string;
-        overallSeverity: "error" | "info" | "critical" | "warning";
-        sprintId: string;
-        healthScore: number;
         insights: {
             type: string;
             description: string;
             severity: "error" | "info" | "critical" | "warning";
             metric: string;
         }[];
+        sprintId: string;
+        healthScore: number;
+        overallSeverity: "error" | "info" | "critical" | "warning";
         blockers: string[];
         recommendations: string[];
     }, {
         timestamp: string;
         schemaVersion: string;
-        overallSeverity: "error" | "info" | "critical" | "warning";
-        sprintId: string;
-        healthScore: number;
         insights: {
             type: string;
             description: string;
             severity: "error" | "info" | "critical" | "warning";
             metric: string;
         }[];
+        sprintId: string;
+        healthScore: number;
+        overallSeverity: "error" | "info" | "critical" | "warning";
         blockers: string[];
         recommendations: string[];
     }>;
@@ -480,12 +480,12 @@ export declare const EventSchemas: {
         confidence: z.ZodNumber;
     }, "strict", z.ZodTypeAny, {
         confidence: number;
-        skillId: string;
         agentSource: string;
+        skillId: string;
     }, {
         confidence: number;
-        skillId: string;
         agentSource: string;
+        skillId: string;
     }>;
     readonly "cc.cost.recorded": z.ZodObject<{
         agent: z.ZodString;
@@ -494,15 +494,15 @@ export declare const EventSchemas: {
         model: z.ZodString;
         tenantId: z.ZodOptional<z.ZodString>;
     }, "strict", z.ZodTypeAny, {
+        agent: string;
         model: string;
         costUsd: number;
-        agent: string;
         tokens: number;
         tenantId?: string | undefined;
     }, {
+        agent: string;
         model: string;
         costUsd: number;
-        agent: string;
         tokens: number;
         tenantId?: string | undefined;
     }>;
@@ -512,13 +512,13 @@ export declare const EventSchemas: {
         actual: z.ZodNumber;
         period: z.ZodString;
     }, "strict", z.ZodTypeAny, {
-        expected: number;
         agent: string;
+        expected: number;
         actual: number;
         period: string;
     }, {
-        expected: number;
         agent: string;
+        expected: number;
         actual: number;
         period: string;
     }>;

package/dist/events/schemas/agent.completed.v1.d.ts

@@ -7,15 +7,15 @@ export declare const AgentCompletedV1: z.ZodObject<{
     costUsd: z.ZodNumber;
 }, "strict", z.ZodTypeAny, {
     runId: string;
-    agentName: string;
-    durationMs: number;
     costUsd: number;
+    durationMs: number;
+    agentName: string;
     outputs?: unknown;
 }, {
     runId: string;
-    agentName: string;
-    durationMs: number;
     costUsd: number;
+    durationMs: number;
+    agentName: string;
     outputs?: unknown;
 }>;
 //# sourceMappingURL=agent.completed.v1.d.ts.map

package/dist/events/schemas/agent.failed.v1.d.ts

@@ -5,14 +5,14 @@ export declare const AgentFailedV1: z.ZodObject<{
     error: z.ZodString;
     retryCount: z.ZodNumber;
 }, "strict", z.ZodTypeAny, {
+    error: string;
     runId: string;
     agentName: string;
-    error: string;
     retryCount: number;
 }, {
+    error: string;
     runId: string;
     agentName: string;
-    error: string;
     retryCount: number;
 }>;
 //# sourceMappingURL=agent.failed.v1.d.ts.map

package/dist/events/schemas/agent.hitl_resolved.v1.d.ts

@@ -4,12 +4,12 @@ export declare const AgentHitlResolvedV1: z.ZodObject<{
     decision: z.ZodEnum<["approved", "rejected"]>;
     by: z.ZodString;
 }, "strict", z.ZodTypeAny, {
-    approvalId: string;
     decision: "approved" | "rejected";
+    approvalId: string;
     by: string;
 }, {
-    approvalId: string;
     decision: "approved" | "rejected";
+    approvalId: string;
     by: string;
 }>;
 //# sourceMappingURL=agent.hitl_resolved.v1.d.ts.map

package/dist/events/schemas/agent.started.v1.d.ts

@@ -7,12 +7,12 @@ export declare const AgentStartedV1: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     runId: string;
     agentName: string;
-    inputs?: unknown;
     tenantId?: string | undefined;
+    inputs?: unknown;
 }, {
     runId: string;
     agentName: string;
-    inputs?: unknown;
     tenantId?: string | undefined;
+    inputs?: unknown;
 }>;
 //# sourceMappingURL=agent.started.v1.d.ts.map