@vauban-org/agent-sdk 1.0.0 → 1.3.0

package/dist/telemetry/sinks/otlp.js.map

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

package/dist/telemetry/sinks/sqlite.d.ts

@@ -0,0 +1,32 @@
+/**
+ * localSqliteTelemetrySink — sovereign local mirror of agent runs.
+ *
+ * Per ADR-ECO-039 §5 : SQLite sink is ON by default. It is the exit plan for
+ * any remote sink (CC SaaS, OTLP backend) — if the network sink is revoked,
+ * the local SQLite file retains the full history.
+ *
+ * Schema (created on first use) :
+ *   - `agent_run`  : one row per OODA cycle (start + finish join)
+ *   - `agent_run_step` : one row per OODA step
+ *
+ * Dependency : `better-sqlite3` declared as **peerDependency optional**.
+ * If absent, this sink degrades gracefully — logs a warning and no-ops.
+ *
+ * Ref: command-center:sprint-693:sink-sqlite
+ */
+import type { TelemetrySink } from "../port.js";
+export interface LocalSqliteTelemetrySinkOptions {
+    /**
+     * Database file path. Default `~/.vauban/runs.db`.
+     * Pass `:memory:` for ephemeral test mode.
+     */
+    path?: string;
+    /** Synchronous mode (better-sqlite3 default). Tests may override. */
+    readonly?: boolean;
+}
+/**
+ * Build a local SQLite sink. Returns a no-op sink if `better-sqlite3` is not
+ * installed — the caller is warned via `console.warn` once.
+ */
+export declare function localSqliteTelemetrySink(opts?: LocalSqliteTelemetrySinkOptions): TelemetrySink;
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/telemetry/sinks/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../../src/telemetry/sinks/sqlite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,OAAO,KAAK,EAIV,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,+BAA+B;IAC9C;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAkED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,GAAE,+BAAoC,GACzC,aAAa,CA2Ff"}

package/dist/telemetry/sinks/sqlite.js

@@ -0,0 +1,170 @@
+/**
+ * localSqliteTelemetrySink — sovereign local mirror of agent runs.
+ *
+ * Per ADR-ECO-039 §5 : SQLite sink is ON by default. It is the exit plan for
+ * any remote sink (CC SaaS, OTLP backend) — if the network sink is revoked,
+ * the local SQLite file retains the full history.
+ *
+ * Schema (created on first use) :
+ *   - `agent_run`  : one row per OODA cycle (start + finish join)
+ *   - `agent_run_step` : one row per OODA step
+ *
+ * Dependency : `better-sqlite3` declared as **peerDependency optional**.
+ * If absent, this sink degrades gracefully — logs a warning and no-ops.
+ *
+ * Ref: command-center:sprint-693:sink-sqlite
+ */
+import { homedir } from "node:os";
+import { dirname, resolve as resolvePath } from "node:path";
+import { mkdirSync } from "node:fs";
+// ─── Schema ──────────────────────────────────────────────────────────────────
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS agent_run (
+  run_id            TEXT PRIMARY KEY,
+  agent_id          TEXT NOT NULL,
+  agent_version     TEXT NOT NULL,
+  model             TEXT,
+  provider          TEXT,
+  tenant_id         TEXT,
+  trace_id          TEXT,
+  started_at        TEXT NOT NULL,
+  finished_at       TEXT,
+  status            TEXT,
+  stop_reason       TEXT,
+  error_message     TEXT,
+  total_input_tokens  INTEGER DEFAULT 0,
+  total_output_tokens INTEGER DEFAULT 0,
+  total_cost_usd      REAL DEFAULT 0,
+  total_tool_calls    INTEGER DEFAULT 0
+);
+
+CREATE INDEX IF NOT EXISTS idx_agent_run_agent_started
+  ON agent_run (agent_id, started_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_agent_run_status
+  ON agent_run (status, started_at DESC);
+
+CREATE TABLE IF NOT EXISTS agent_run_step (
+  run_id        TEXT NOT NULL,
+  step_index    INTEGER NOT NULL,
+  kind          TEXT NOT NULL,
+  status        TEXT NOT NULL,
+  input_tokens  INTEGER DEFAULT 0,
+  output_tokens INTEGER DEFAULT 0,
+  tool_calls    INTEGER DEFAULT 0,
+  cost_usd      REAL DEFAULT 0,
+  duration_ms   INTEGER,
+  metadata      TEXT,
+  recorded_at   TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  PRIMARY KEY (run_id, step_index)
+);
+
+CREATE INDEX IF NOT EXISTS idx_agent_run_step_run
+  ON agent_run_step (run_id, step_index);
+`;
+// ─── Factory ─────────────────────────────────────────────────────────────────
+/**
+ * Build a local SQLite sink. Returns a no-op sink if `better-sqlite3` is not
+ * installed — the caller is warned via `console.warn` once.
+ */
+export function localSqliteTelemetrySink(opts = {}) {
+    const dbPath = resolveDbPath(opts.path);
+    const db = openDatabaseSafely(dbPath, opts.readonly ?? false);
+    if (!db) {
+        return degradedSink(dbPath);
+    }
+    db.exec(SCHEMA);
+    db.pragma("journal_mode = WAL");
+    db.pragma("synchronous = NORMAL");
+    const insertRun = db.prepare(`
+    INSERT INTO agent_run
+      (run_id, agent_id, agent_version, model, provider,
+       tenant_id, trace_id, started_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+    ON CONFLICT (run_id) DO NOTHING
+  `);
+    const insertStep = db.prepare(`
+    INSERT INTO agent_run_step
+      (run_id, step_index, kind, status,
+       input_tokens, output_tokens, tool_calls, cost_usd,
+       duration_ms, metadata)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    ON CONFLICT (run_id, step_index) DO NOTHING
+  `);
+    const updateFinish = db.prepare(`
+    UPDATE agent_run
+       SET finished_at = ?,
+           status = ?,
+           stop_reason = ?,
+           error_message = ?,
+           total_input_tokens = COALESCE(?, total_input_tokens),
+           total_output_tokens = COALESCE(?, total_output_tokens),
+           total_cost_usd = COALESCE(?, total_cost_usd),
+           total_tool_calls = COALESCE(?, total_tool_calls)
+     WHERE run_id = ?
+  `);
+    return {
+        name: "sqlite",
+        async start(event) {
+            insertRun.run(event.runId, event.agentId, event.agentVersion, event.model ?? null, event.provider ?? null, event.tenantId ?? null, event.traceId ?? null, event.startedAt);
+        },
+        async step(runId, delta) {
+            insertStep.run(runId, delta.stepIndex, delta.kind, delta.status, delta.inputTokens, delta.outputTokens, delta.toolCalls ?? 0, delta.costUsd, delta.durationMs ?? null, delta.metadata ? JSON.stringify(delta.metadata) : null);
+        },
+        async finish(runId, event) {
+            updateFinish.run(event.finishedAt, event.status, event.stopReason ?? null, event.errorMessage ?? null, event.totalInputTokens ?? null, event.totalOutputTokens ?? null, event.totalCostUsd ?? null, event.totalToolCalls ?? null, runId);
+        },
+        async flush() {
+            // better-sqlite3 is synchronous — no buffer to flush.
+        },
+    };
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function resolveDbPath(input) {
+    if (!input)
+        return resolvePath(homedir(), ".vauban", "runs.db");
+    if (input === ":memory:")
+        return input;
+    // Expand leading ~ manually (Node doesn't do it).
+    if (input.startsWith("~/")) {
+        return resolvePath(homedir(), input.slice(2));
+    }
+    return resolvePath(input);
+}
+let warnedMissing = false;
+function openDatabaseSafely(path, readonly) {
+    try {
+        // Dynamic require so better-sqlite3 stays optional.
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const createRequire = require("node:module").createRequire;
+        const req = createRequire(import.meta.url);
+        const BetterSqlite = req("better-sqlite3");
+        if (path !== ":memory:") {
+            mkdirSync(dirname(path), { recursive: true });
+        }
+        return new BetterSqlite(path, { readonly });
+    }
+    catch (err) {
+        if (!warnedMissing) {
+            warnedMissing = true;
+            // eslint-disable-next-line no-console
+            console.warn("[telemetry:sqlite] better-sqlite3 not installed — sink degraded to no-op.", "Install with: `pnpm add better-sqlite3` (peerDependencyOptional).", err instanceof Error ? err.message : "");
+        }
+        return null;
+    }
+}
+function degradedSink(path) {
+    return {
+        name: `sqlite:degraded(${path})`,
+        async start() {
+            /* no-op when better-sqlite3 missing */
+        },
+        async step() {
+            /* no-op */
+        },
+        async finish() {
+            /* no-op */
+        },
+    };
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/telemetry/sinks/sqlite.js.map

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

package/dist/telemetry/sinks/stdout.d.ts

@@ -0,0 +1,22 @@
+/**
+ * stdoutTelemetrySink — JSON line emission to stderr (dev-friendly default).
+ *
+ * One JSON object per event, suitable for `jq`, `pino-pretty`, or any
+ * structured-log pipeline. Writes to stderr (not stdout) so that the agent's
+ * own stdout remains free for user output.
+ *
+ * Ref: command-center:sprint-693:sink-stdout
+ */
+import type { TelemetrySink } from "../port.js";
+export interface StdoutTelemetrySinkOptions {
+    /** Stream to write to. Defaults to `process.stderr`. */
+    stream?: NodeJS.WritableStream;
+    /** When true (default), emits as `key=value` instead of JSON. */
+    json?: boolean;
+}
+/**
+ * Default sink for dev visibility. Zero dependency, zero I/O latency
+ * (synchronous write to stream).
+ */
+export declare function stdoutTelemetrySink(opts?: StdoutTelemetrySinkOptions): TelemetrySink;
+//# sourceMappingURL=stdout.d.ts.map

package/dist/telemetry/sinks/stdout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdout.d.ts","sourceRoot":"","sources":["../../../src/telemetry/sinks/stdout.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAIV,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,0BAA0B;IACzC,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC/B,iEAAiE;IACjE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,GAAE,0BAA+B,GACpC,aAAa,CA4Bf"}

package/dist/telemetry/sinks/stdout.js

@@ -0,0 +1,38 @@
+/**
+ * stdoutTelemetrySink — JSON line emission to stderr (dev-friendly default).
+ *
+ * One JSON object per event, suitable for `jq`, `pino-pretty`, or any
+ * structured-log pipeline. Writes to stderr (not stdout) so that the agent's
+ * own stdout remains free for user output.
+ *
+ * Ref: command-center:sprint-693:sink-stdout
+ */
+/**
+ * Default sink for dev visibility. Zero dependency, zero I/O latency
+ * (synchronous write to stream).
+ */
+export function stdoutTelemetrySink(opts = {}) {
+    const stream = opts.stream ?? process.stderr;
+    const useJson = opts.json ?? true;
+    function emit(event) {
+        const line = useJson
+            ? JSON.stringify(event)
+            : Object.entries(event)
+                .map(([k, v]) => `${k}=${JSON.stringify(v)}`)
+                .join(" ");
+        stream.write(`${line}\n`);
+    }
+    return {
+        name: "stdout",
+        async start(event) {
+            emit({ telemetry: "run.start", ...event });
+        },
+        async step(runId, delta) {
+            emit({ telemetry: "run.step", runId, ...delta });
+        },
+        async finish(runId, event) {
+            emit({ telemetry: "run.finish", runId, ...event });
+        },
+    };
+}
+//# sourceMappingURL=stdout.js.map

package/dist/telemetry/sinks/stdout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdout.js","sourceRoot":"","sources":["../../../src/telemetry/sinks/stdout.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAmC,EAAE;IAErC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;IAElC,SAAS,IAAI,CAAC,KAA8B;QAC1C,MAAM,IAAI,GAAG,OAAO;YAClB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;YACvB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;iBAClB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC5C,IAAI,CAAC,GAAG,CAAC,CAAC;QACjB,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ;QAEd,KAAK,CAAC,KAAK,CAAC,KAAwB;YAClC,IAAI,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,KAAuB;YAC/C,IAAI,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,KAAyB;YACnD,IAAI,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QACrD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/testing/index.d.ts

@@ -22,6 +22,9 @@ export { outcomePortConformance } from "./outcome-conformance.js";
 export { loggerPortConformance } from "./logger-conformance.js";
 export { dbPortConformance } from "./db-conformance.js";
 export type { ConformanceRunner } from "./runner.js";
+export { brainPortContract } from "./contracts/brain-port.contract.js";
+export { eventBusContract } from "./contracts/event-bus.contract.js";
+export { economicObserverContract } from "./contracts/economic-observer.contract.js";
 export { TestEventBus } from "./test-event-bus.js";
 export { TestBrainPort } from "./test-brain-port.js";
 export { TestChildAgentPort } from "./test-child-agent.js";

package/dist/testing/test-brain-port.d.ts

@@ -5,6 +5,10 @@
  * Maps. Use for agent unit tests that need to archive/query without
  * external infrastructure.
  *
+ * OTel spans are emitted on archiveKnowledge and queryKnowledge via
+ * @opentelemetry/api. Gracefully degrades to noop spans when no OTel SDK
+ * is installed.
+ *
  * @public
  */
 import type { BrainPort, BrainEntry, BrainEntryInput, BrainQueryFilters } from "../ports/brain.js";

package/dist/testing/test-brain-port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-brain-port.d.ts","sourceRoot":"","sources":["../../src/testing/test-brain-port.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAOnG,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzH,qBAAa,aAAc,YAAW,SAAS;IAC7C,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IAE1C,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,MAAM,CAAK;;IASb,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAcpE,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAcvF,yBAAyB;IACzB,KAAK,IAAI,IAAI;CAId"}
+{"version":3,"file":"test-brain-port.d.ts","sourceRoot":"","sources":["../../src/testing/test-brain-port.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,eAAe,EACf,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAO3B,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAI3B,qBAAa,aAAc,YAAW,SAAS;IAC7C,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;IAE1C,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,MAAM,CAAK;;IASb,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAuCpE,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,UAAU,EAAE,CAAC;IA0CxB,yBAAyB;IACzB,KAAK,IAAI,IAAI;CAId"}

package/dist/testing/test-brain-port.js

@@ -5,9 +5,15 @@
  * Maps. Use for agent unit tests that need to archive/query without
  * external infrastructure.
  *
+ * OTel spans are emitted on archiveKnowledge and queryKnowledge via
+ * @opentelemetry/api. Gracefully degrades to noop spans when no OTel SDK
+ * is installed.
+ *
  * @public
  */
+import { SpanStatusCode, trace } from "@opentelemetry/api";
 import { InMemoryWorkingMemory, InMemoryEpisodicMemory, InMemorySemanticMemory, InMemoryProceduralMemory, } from "../ports/brain.js";
+const TEST_TRACER = trace.getTracer("vauban-agent-sdk.ports.test", "0.1.0");
 export class TestBrainPort {
     working;
     episodic;
@@ -22,28 +28,77 @@ export class TestBrainPort {
         this.procedural = new InMemoryProceduralMemory();
     }
     async archiveKnowledge(entry) {
-        const id = `test-${this.nextId++}`;
-        const created = {
-            id,
-            content: entry.content,
-            category: entry.category,
-            tags: entry.tags,
-            metadata: entry.metadata,
-            created_at: new Date().toISOString(),
-        };
-        this.entries.set(id, created);
-        return created;
+        return TEST_TRACER.startActiveSpan("brain.archiveKnowledge", {
+            attributes: {
+                "brain.entry.category": entry.category ?? "unknown",
+                "brain.entry.content_preview": entry.content.slice(0, 200),
+                "brain.entry.tags": entry.tags?.join(",") ?? "",
+                "vauban.port.name": "brain",
+                "vauban.port.impl": "TestBrainPort",
+            },
+        }, async (span) => {
+            try {
+                const id = `test-${this.nextId++}`;
+                const created = {
+                    id,
+                    content: entry.content,
+                    category: entry.category,
+                    tags: entry.tags,
+                    metadata: entry.metadata,
+                    created_at: new Date().toISOString(),
+                };
+                this.entries.set(id, created);
+                span.setAttribute("brain.entry.id", id);
+                span.setStatus({ code: SpanStatusCode.OK });
+                return created;
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                span.setStatus({ code: SpanStatusCode.ERROR, message });
+                if (err instanceof Error)
+                    span.recordException(err);
+                throw err;
+            }
+            finally {
+                span.end();
+            }
+        });
     }
     async queryKnowledge(query, filters) {
-        let results = Array.from(this.entries.values()).filter((e) => e.content.toLowerCase().includes(query.toLowerCase()));
-        if (filters?.category) {
-            results = results.filter((e) => e.category === filters.category);
-        }
-        if (filters?.tags && filters.tags.length > 0) {
-            results = results.filter((e) => e.tags?.some((t) => filters.tags.includes(t)));
-        }
-        const limit = filters?.limit ?? 10;
-        return results.slice(0, limit);
+        return TEST_TRACER.startActiveSpan("brain.queryKnowledge", {
+            attributes: {
+                "brain.query.preview": query.slice(0, 200),
+                "brain.query.category": filters?.category ?? "none",
+                "brain.query.limit": filters?.limit ?? -1,
+                "vauban.port.name": "brain",
+                "vauban.port.impl": "TestBrainPort",
+            },
+        }, async (span) => {
+            try {
+                let results = Array.from(this.entries.values()).filter((e) => e.content.toLowerCase().includes(query.toLowerCase()));
+                if (filters?.category) {
+                    results = results.filter((e) => e.category === filters.category);
+                }
+                if (filters?.tags && filters.tags.length > 0) {
+                    results = results.filter((e) => e.tags?.some((t) => filters.tags.includes(t)));
+                }
+                const limit = filters?.limit ?? 10;
+                const sliced = results.slice(0, limit);
+                span.setAttribute("brain.query.result_count", sliced.length);
+                span.setStatus({ code: SpanStatusCode.OK });
+                return sliced;
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                span.setStatus({ code: SpanStatusCode.ERROR, message });
+                if (err instanceof Error)
+                    span.recordException(err);
+                throw err;
+            }
+            finally {
+                span.end();
+            }
+        });
     }
     /** Clear all entries. */
     reset() {

package/dist/testing/test-brain-port.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-brain-port.js","sourceRoot":"","sources":["../../src/testing/test-brain-port.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,OAAO,aAAa;IACf,OAAO,CAAoB;IAC3B,QAAQ,CAAqB;IAC7B,QAAQ,CAAqB;IAC7B,UAAU,CAAuB;IAElC,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IACxC,MAAM,GAAG,CAAC,CAAC;IAEnB;QACE,IAAI,CAAC,OAAO,GAAG,IAAI,qBAAqB,EAAE,CAAC;QAC3C,IAAI,CAAC,QAAQ,GAAG,IAAI,sBAAsB,EAAE,CAAC;QAC7C,IAAI,CAAC,QAAQ,GAAG,IAAI,sBAAsB,EAAE,CAAC;QAC7C,IAAI,CAAC,UAAU,GAAG,IAAI,wBAAwB,EAAE,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,KAAsB;QAC3C,MAAM,EAAE,GAAG,QAAQ,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QACnC,MAAM,OAAO,GAAe;YAC1B,EAAE;YACF,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAA+C;YAC/D,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC9B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,KAAa,EAAE,OAA2B;QAC7D,IAAI,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CACpD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAC7D,CAAC;QACF,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;YACtB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,OAAO,EAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7C,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,OAAO,CAAC,IAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/F,CAAC;QACD,MAAM,KAAK,GAAI,OAAO,EAAE,KAAgB,IAAI,EAAE,CAAC;QAC/C,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,yBAAyB;IACzB,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IAClB,CAAC;CACF"}
+{"version":3,"file":"test-brain-port.js","sourceRoot":"","sources":["../../src/testing/test-brain-port.ts"],"names":[],"mappings":"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"}

package/dist/testing/test-event-bus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-event-bus.d.ts","sourceRoot":"","sources":["../../src/testing/test-event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACb,MAAM,uBAAuB,CAAC;AAa/B,qBAAa,YAAa,YAAW,YAAY;IAC/C,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,WAAW,CAAgD;IACnE,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,SAAS,CAAmC;IAGpD,OAAO,CAAC,aAAa,CAA0C;IAC/D,OAAO,CAAC,iBAAiB,CAAiD;IAC1E,OAAO,CAAC,SAAS,CAAqB;IAEtC,OAAO,CAAC,uBAAuB,CAA4B;IAC3D,OAAO,CAAC,kBAAkB,CAA4B;IAEtD;;;OAGG;IACH,OAAO,CAAC,aAAa,CAAuC;IAE5D,4EAA4E;IAC5E,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAMhC,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBzD,sBAAsB,CAAC,CAAC,EAC5B,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,EACxC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC;IA4BhB,SAAS,CACP,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAC5C,OAAO,CAAC,MAAM,IAAI,CAAC;IAkBtB,eAAe,CAAC,CAAC,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EACjD,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GACxC,YAAY;IAoCR,UAAU,CACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,aAAa,CAAC,WAAW,CAAC;IAW7B,GAAG,IAAI;QAAE,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;QAAC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE;IAkBrE,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM5E,wCAAwC;IACxC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE;IAIvC,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE;IAItC,oDAAoD;IACpD,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAIlC,qEAAqE;IACrE,IAAI,eAAe,IAAI,WAAW,EAAE,CAEnC;IAED,uBAAuB;IACvB,KAAK,IAAI,IAAI;CAWd"}
+{"version":3,"file":"test-event-bus.d.ts","sourceRoot":"","sources":["../../src/testing/test-event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACb,MAAM,uBAAuB,CAAC;AAe/B,qBAAa,YAAa,YAAW,YAAY;IAC/C,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,WAAW,CAAgD;IACnE,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,SAAS,CAAmC;IAGpD,OAAO,CAAC,aAAa,CAA0C;IAC/D,OAAO,CAAC,iBAAiB,CAAiD;IAC1E,OAAO,CAAC,SAAS,CAAqB;IAEtC,OAAO,CAAC,uBAAuB,CAA4B;IAC3D,OAAO,CAAC,kBAAkB,CAA4B;IAEtD;;;OAGG;IACH,OAAO,CAAC,aAAa,CAAuC;IAE5D,4EAA4E;IAC5E,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAMhC,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CzD,sBAAsB,CAAC,CAAC,EAC5B,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,EACxC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC;IA6DhB,SAAS,CACP,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAC5C,OAAO,CAAC,MAAM,IAAI,CAAC;IAkBtB,eAAe,CAAC,CAAC,EACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EACjD,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GACxC,YAAY;IAoCR,UAAU,CACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,aAAa,CAAC,WAAW,CAAC;IAW7B,GAAG,IAAI;QAAE,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;QAAC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE;IAkBrE,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM5E,wCAAwC;IACxC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE;IAIvC,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE;IAItC,oDAAoD;IACpD,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAIlC,qEAAqE;IACrE,IAAI,eAAe,IAAI,WAAW,EAAE,CAEnC;IAED,uBAAuB;IACvB,KAAK,IAAI,IAAI;CAWd"}

package/dist/testing/test-event-bus.js

@@ -12,9 +12,11 @@
  *
  * @public
  */
+import { SpanStatusCode, trace } from "@opentelemetry/api";
 import { signEvent } from "../auth/sign-event.js";
 import { verifyEvent } from "../auth/verify-event.js";
 import { InMemoryNonceStore } from "../auth/nonce-store.js";
+const TEST_TRACER = trace.getTracer("vauban-agent-sdk.ports.test", "0.1.0");
 export class TestEventBus {
     streams = new Map();
     subscribers = new Map();
@@ -38,46 +40,97 @@ export class TestEventBus {
     }
     // ─── EventBusPort ──────────────────────────────────────────────────────────
     async publish(event, stream) {
-        if (!event.id)
-            throw new Error("CloudEvent.id is required");
-        if (event.specversion !== "1.0")
-            throw new Error("CloudEvent.specversion must be 1.0");
-        const events = this.streams.get(stream) ?? [];
-        events.push(event);
-        this.streams.set(stream, events);
-        // Track consumed events per stream
-        const consumed = this._consumed.get(stream) ?? [];
-        consumed.push(event);
-        this._consumed.set(stream, consumed);
-        // Dispatch to subscribers
-        const streamSubs = this.subscribers.get(stream);
-        if (streamSubs) {
-            for (const handler of streamSubs.values()) {
-                await handler(event);
+        return TEST_TRACER.startActiveSpan("event-bus.publish", {
+            attributes: {
+                "event.type": event.type,
+                "event.stream": stream,
+                "event.id": event.id,
+                "vauban.port.name": "event-bus",
+                "vauban.port.impl": "TestEventBus",
+            },
+        }, async (span) => {
+            try {
+                if (!event.id)
+                    throw new Error("CloudEvent.id is required");
+                if (event.specversion !== "1.0")
+                    throw new Error("CloudEvent.specversion must be 1.0");
+                const events = this.streams.get(stream) ?? [];
+                events.push(event);
+                this.streams.set(stream, events);
+                // Track consumed events per stream
+                const consumed = this._consumed.get(stream) ?? [];
+                consumed.push(event);
+                this._consumed.set(stream, consumed);
+                // Dispatch to subscribers
+                const streamSubs = this.subscribers.get(stream);
+                if (streamSubs) {
+                    for (const handler of streamSubs.values()) {
+                        await handler(event);
+                    }
+                }
+                span.setStatus({ code: SpanStatusCode.OK });
             }
-        }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                span.setStatus({ code: SpanStatusCode.ERROR, message });
+                if (err instanceof Error)
+                    span.recordException(err);
+                throw err;
+            }
+            finally {
+                span.end();
+            }
+        });
     }
     async publishWithIdempotency(event, key) {
-        // Dedup: silently skip if key already processed (producer-side)
-        const isNew = await this.publishIdempotencyStore.setNX(key, 10 * 60 * 1000);
-        if (!isNew)
-            return;
-        // Auto-sign the event
-        const signature = signEvent(event, this.signingSecret);
-        const signed = { ...event, signature };
-        // Store in domain stream
-        const streamKey = `domain:${event.type}`;
-        const stored = this.domainStreams.get(streamKey) ?? [];
-        const streamId = `${Date.now()}-${stored.length}`;
-        stored.push({ streamId, event: signed });
-        this.domainStreams.set(streamKey, stored);
-        // Dispatch to domain subscribers
-        const typeSubs = this.domainSubscribers.get(event.type);
-        if (typeSubs) {
-            for (const handler of typeSubs.values()) {
-                await handler(signed);
+        return TEST_TRACER.startActiveSpan("event-bus.publishWithIdempotency", {
+            attributes: {
+                "event.type": event.type,
+                "event.idempotency_key": key,
+                "vauban.port.name": "event-bus",
+                "vauban.port.impl": "TestEventBus",
+            },
+        }, async (span) => {
+            try {
+                // Dedup: silently skip if key already processed (producer-side)
+                const isNew = await this.publishIdempotencyStore.setNX(key, 10 * 60 * 1000);
+                if (!isNew) {
+                    span.setAttribute("event.dedup.skipped", true);
+                    span.setStatus({ code: SpanStatusCode.OK });
+                    return;
+                }
+                // Auto-sign the event
+                const signature = signEvent(event, this.signingSecret);
+                const signed = {
+                    ...event,
+                    signature,
+                };
+                // Store in domain stream
+                const streamKey = `domain:${event.type}`;
+                const stored = this.domainStreams.get(streamKey) ?? [];
+                const streamId = `${Date.now()}-${stored.length}`;
+                stored.push({ streamId, event: signed });
+                this.domainStreams.set(streamKey, stored);
+                // Dispatch to domain subscribers
+                const typeSubs = this.domainSubscribers.get(event.type);
+                if (typeSubs) {
+                    for (const handler of typeSubs.values()) {
+                        await handler(signed);
+                    }
+                }
+                span.setStatus({ code: SpanStatusCode.OK });
             }
-        }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                span.setStatus({ code: SpanStatusCode.ERROR, message });
+                if (err instanceof Error)
+                    span.recordException(err);
+                throw err;
+            }
+            finally {
+                span.end();
+            }
+        });
     }
     subscribe(stream, consumerGroup, handler) {
         const key = `${stream}:${consumerGroup}`;