@vauban-org/agent-sdk 0.16.0

package/dist/metrics/create-agent-metrics.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Prometheus metrics factory for SDK agents.
+ *
+ * Promoted from forge/src/agents/shared/metrics.ts (Vague 1.B.4).
+ *
+ * prom-client is an optional peer dependency. If absent, all metrics are
+ * no-op stubs so consumers that do not use Prometheus can still import this
+ * module without errors.
+ *
+ * @public @since 0.18.0
+ */
+type Registry = import("prom-client").Registry;
+type Counter<L extends string> = import("prom-client").Counter<L>;
+type Histogram<L extends string> = import("prom-client").Histogram<L>;
+/**
+ * Standard metrics exposed by every SDK agent.
+ *
+ * Label sets follow Prometheus conventions: snake_case, no spaces.
+ *
+ * @public
+ */
+export interface AgentMetrics {
+    /** Incremented when an OODA cycle begins. */
+    cycleStarted: Counter<"agent_id">;
+    /** Incremented when an OODA cycle finishes; `outcome` = "success" | "error" | "skipped". */
+    cycleCompleted: Counter<"agent_id" | "outcome">;
+    /** Duration of an OODA cycle by phase ("observe"|"orient"|"decide"|"act"|"total"). */
+    cycleDuration: Histogram<"agent_id" | "phase">;
+    /** Incremented when a HITL approval request is sent. */
+    hitlRequested: Counter<"agent_id">;
+    /** Incremented when a HITL request resolves; `decision` = "approved" | "rejected" | "timeout". */
+    hitlResolved: Counter<"agent_id" | "decision">;
+    /** Incremented for every LLM API call attempted. */
+    llmCallCount: Counter<"agent_id" | "provider">;
+    /** Total tokens used; `direction` = "input" | "output". */
+    llmTokensUsed: Counter<"agent_id" | "provider" | "direction">;
+    /** Cumulative LLM cost in USD (Counter, never resets). */
+    llmCostUsd: Counter<"agent_id" | "provider">;
+}
+/**
+ * Options for `createAgentMetrics`.
+ *
+ * @public
+ */
+export interface CreateAgentMetricsOptions {
+    /**
+     * prom-client Registry to register metrics on.
+     * Defaults to a fresh isolated Registry per call so multiple consumers do
+     * not collide on the global default registry.
+     * Pass your own Registry to aggregate with other metrics.
+     */
+    registry?: Registry;
+    /**
+     * Metric name prefix (must end with `_`).
+     * @default "agent_"
+     * @example "forge_"
+     */
+    prefix?: string;
+}
+/**
+ * Create a set of standard Prometheus metrics for an SDK agent.
+ *
+ * If prom-client is not installed (optional peer dependency), returns no-op
+ * stubs so the call site does not need to handle `null`.
+ *
+ * @example
+ * ```ts
+ * import { createAgentMetrics } from "@vauban-org/agent-sdk/metrics";
+ *
+ * const m = createAgentMetrics({ prefix: "forge_" });
+ * m.cycleStarted.inc({ agent_id: "my-agent" });
+ * ```
+ *
+ * @public
+ */
+export declare function createAgentMetrics(opts?: CreateAgentMetricsOptions): AgentMetrics;
+export type { Registry };
+//# sourceMappingURL=create-agent-metrics.d.ts.map

package/dist/metrics/create-agent-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-agent-metrics.d.ts","sourceRoot":"","sources":["../../src/metrics/create-agent-metrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,KAAK,QAAQ,GAAG,OAAO,aAAa,EAAE,QAAQ,CAAC;AAC/C,KAAK,OAAO,CAAC,CAAC,SAAS,MAAM,IAAI,OAAO,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,KAAK,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI,OAAO,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;AAiDtE;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,6CAA6C;IAC7C,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAClC,4FAA4F;IAC5F,cAAc,EAAE,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAChD,sFAAsF;IACtF,aAAa,EAAE,SAAS,CAAC,UAAU,GAAG,OAAO,CAAC,CAAC;IAC/C,wDAAwD;IACxD,aAAa,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACnC,kGAAkG;IAClG,YAAY,EAAE,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC,CAAC;IAC/C,oDAAoD;IACpD,YAAY,EAAE,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC,CAAC;IAC/C,2DAA2D;IAC3D,aAAa,EAAE,OAAO,CAAC,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC,CAAC;IAC9D,0DAA0D;IAC1D,UAAU,EAAE,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC,CAAC;CAC9C;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,GAAE,yBAA8B,GACnC,YAAY,CAyFd;AAID,YAAY,EAAE,QAAQ,EAAE,CAAC"}

package/dist/metrics/create-agent-metrics.js

@@ -0,0 +1,115 @@
+/**
+ * Prometheus metrics factory for SDK agents.
+ *
+ * Promoted from forge/src/agents/shared/metrics.ts (Vague 1.B.4).
+ *
+ * prom-client is an optional peer dependency. If absent, all metrics are
+ * no-op stubs so consumers that do not use Prometheus can still import this
+ * module without errors.
+ *
+ * @public @since 0.18.0
+ */
+import { createRequire } from "node:module";
+// ─── Lazy prom-client loader ──────────────────────────────────────────────────
+let _prom;
+/**
+ * Load prom-client synchronously once, cache result.
+ * Returns null if prom-client is not installed.
+ */
+function loadPromClient() {
+    if (_prom !== undefined)
+        return _prom;
+    try {
+        const req = createRequire(import.meta.url);
+        _prom = req("prom-client");
+    }
+    catch {
+        _prom = null;
+    }
+    return _prom;
+}
+// ─── No-op stubs ──────────────────────────────────────────────────────────────
+/** Minimal no-op counter. Safe to call `.inc()` / `.labels()` without effect. */
+function noopCounter() {
+    const stub = {
+        inc: () => undefined,
+        labels: () => stub,
+        reset: () => undefined,
+        remove: () => undefined,
+    };
+    return stub;
+}
+/** Minimal no-op histogram. Safe to call `.observe()` / `.startTimer()` without effect. */
+function noopHistogram() {
+    const stub = {
+        observe: () => undefined,
+        startTimer: () => () => 0,
+        labels: () => stub,
+        reset: () => undefined,
+        remove: () => undefined,
+        zero: () => undefined,
+    };
+    return stub;
+}
+// ─── Factory ──────────────────────────────────────────────────────────────────
+/**
+ * Create a set of standard Prometheus metrics for an SDK agent.
+ *
+ * If prom-client is not installed (optional peer dependency), returns no-op
+ * stubs so the call site does not need to handle `null`.
+ *
+ * @example
+ * ```ts
+ * import { createAgentMetrics } from "@vauban-org/agent-sdk/metrics";
+ *
+ * const m = createAgentMetrics({ prefix: "forge_" });
+ * m.cycleStarted.inc({ agent_id: "my-agent" });
+ * ```
+ *
+ * @public
+ */
+export function createAgentMetrics(opts = {}) {
+    const prefix = opts.prefix ?? "agent_";
+    const prom = loadPromClient();
+    if (prom === null) {
+        return {
+            cycleStarted: noopCounter(),
+            cycleCompleted: noopCounter(),
+            cycleDuration: noopHistogram(),
+            hitlRequested: noopCounter(),
+            hitlResolved: noopCounter(),
+            llmCallCount: noopCounter(),
+            llmTokensUsed: noopCounter(),
+            llmCostUsd: noopCounter(),
+        };
+    }
+    const registry = opts.registry ?? new prom.Registry();
+    function counter(name, help, labelNames) {
+        return new prom.Counter({
+            name: `${prefix}${name}`,
+            help,
+            labelNames,
+            registers: [registry],
+        });
+    }
+    function histogram(name, help, labelNames, buckets) {
+        return new prom.Histogram({
+            name: `${prefix}${name}`,
+            help,
+            labelNames,
+            buckets: buckets ?? prom.linearBuckets(0, 500, 12),
+            registers: [registry],
+        });
+    }
+    return {
+        cycleStarted: counter("cycle_started_total", "OODA cycles started", ["agent_id"]),
+        cycleCompleted: counter("cycle_completed_total", "OODA cycles completed", ["agent_id", "outcome"]),
+        cycleDuration: histogram("cycle_duration_ms", "OODA cycle duration in milliseconds", ["agent_id", "phase"]),
+        hitlRequested: counter("hitl_requested_total", "HITL requests sent", ["agent_id"]),
+        hitlResolved: counter("hitl_resolved_total", "HITL requests resolved", ["agent_id", "decision"]),
+        llmCallCount: counter("llm_calls_total", "LLM API calls", ["agent_id", "provider"]),
+        llmTokensUsed: counter("llm_tokens_total", "LLM tokens consumed", ["agent_id", "provider", "direction"]),
+        llmCostUsd: counter("llm_cost_usd_total", "Cumulative LLM cost in USD", ["agent_id", "provider"]),
+    };
+}
+//# sourceMappingURL=create-agent-metrics.js.map

package/dist/metrics/create-agent-metrics.js.map

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

package/dist/orchestration/bulkhead.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Bulkhead worker pool — bounded concurrency with FIFO queue and metrics.
+ *
+ * Sprint-468 (command-center:sprint-468:bulkhead).
+ *
+ * createBulkhead returns a typed worker-pool object with:
+ *   - run(fn)   — enqueue a zero-argument task; resolves/rejects per task
+ *   - metrics() — live snapshot: active, queued, rejected, completed
+ *
+ * This is the orchestration-layer variant of resilience/bulkhead.ts.
+ * The key difference is the factory pattern (one pool, many tasks) vs. the
+ * resilience variant that wraps a single fixed function. Use this when the
+ * pool itself is a resource to manage (e.g. DB connection pool, LLM slots).
+ *
+ * Queue discipline: FIFO. Tasks enter the queue in submission order and
+ * acquire a worker slot in the same order.
+ *
+ * Fast-reject: when `rejectOnFull` is true (default) and the queue is at
+ * `maxQueue` capacity, new submissions throw `BulkheadQueueFullError`
+ * synchronously (before awaiting). When `rejectOnFull` is false, callers
+ * block indefinitely until a slot opens — useful for back-pressure scenarios.
+ */
+export declare class BulkheadQueueFullError extends Error {
+    constructor(active: number, queued: number, maxConcurrent: number, maxQueue: number);
+}
+export interface BulkheadOptions {
+    /** Maximum number of concurrently executing tasks. */
+    maxConcurrent: number;
+    /** Maximum queue depth. Defaults to `maxConcurrent * 10`. */
+    maxQueue?: number;
+    /**
+     * When true (default): reject immediately when the queue is full.
+     * When false: block the caller indefinitely (unbounded wait).
+     */
+    rejectOnFull?: boolean;
+}
+export interface BulkheadMetrics {
+    /** Currently executing task count. */
+    active: number;
+    /** Tasks waiting in the queue. */
+    queued: number;
+    /** Tasks rejected because the queue was full (lifetime counter). */
+    rejected: number;
+    /** Tasks that completed successfully or with an error (lifetime counter). */
+    completed: number;
+}
+export interface BulkheadPool<T> {
+    /**
+     * Submit a zero-argument async task to the pool.
+     *
+     * Returns a Promise that resolves/rejects with the task's outcome.
+     * May throw `BulkheadQueueFullError` synchronously when rejectOnFull=true
+     * and the queue is at capacity.
+     */
+    run(fn: () => Promise<T>): Promise<T>;
+    /** Live metrics snapshot (no allocation beyond the returned object). */
+    metrics(): BulkheadMetrics;
+}
+/**
+ * Create a typed bulkhead worker pool.
+ *
+ * @example
+ * ```ts
+ * const pool = createBulkhead<string>({ maxConcurrent: 3, maxQueue: 10 });
+ * const result = await pool.run(() => fetchSomething());
+ * console.log(pool.metrics()); // { active: 0, queued: 0, rejected: 0, completed: 1 }
+ * ```
+ */
+export declare function createBulkhead<T>(opts: BulkheadOptions): BulkheadPool<T>;
+//# sourceMappingURL=bulkhead.d.ts.map

package/dist/orchestration/bulkhead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulkhead.d.ts","sourceRoot":"","sources":["../../src/orchestration/bulkhead.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAMpF;AAED,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEtC,wEAAwE;IACxE,OAAO,IAAI,eAAe,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,GAAG,YAAY,CAAC,CAAC,CAAC,CAiExE"}

package/dist/orchestration/bulkhead.js

@@ -0,0 +1,99 @@
+/**
+ * Bulkhead worker pool — bounded concurrency with FIFO queue and metrics.
+ *
+ * Sprint-468 (command-center:sprint-468:bulkhead).
+ *
+ * createBulkhead returns a typed worker-pool object with:
+ *   - run(fn)   — enqueue a zero-argument task; resolves/rejects per task
+ *   - metrics() — live snapshot: active, queued, rejected, completed
+ *
+ * This is the orchestration-layer variant of resilience/bulkhead.ts.
+ * The key difference is the factory pattern (one pool, many tasks) vs. the
+ * resilience variant that wraps a single fixed function. Use this when the
+ * pool itself is a resource to manage (e.g. DB connection pool, LLM slots).
+ *
+ * Queue discipline: FIFO. Tasks enter the queue in submission order and
+ * acquire a worker slot in the same order.
+ *
+ * Fast-reject: when `rejectOnFull` is true (default) and the queue is at
+ * `maxQueue` capacity, new submissions throw `BulkheadQueueFullError`
+ * synchronously (before awaiting). When `rejectOnFull` is false, callers
+ * block indefinitely until a slot opens — useful for back-pressure scenarios.
+ */
+export class BulkheadQueueFullError extends Error {
+    constructor(active, queued, maxConcurrent, maxQueue) {
+        super(`Bulkhead full — active=${active}/${maxConcurrent}, queued=${queued}/${maxQueue}`);
+        this.name = "BulkheadQueueFullError";
+    }
+}
+/**
+ * Create a typed bulkhead worker pool.
+ *
+ * @example
+ * ```ts
+ * const pool = createBulkhead<string>({ maxConcurrent: 3, maxQueue: 10 });
+ * const result = await pool.run(() => fetchSomething());
+ * console.log(pool.metrics()); // { active: 0, queued: 0, rejected: 0, completed: 1 }
+ * ```
+ */
+export function createBulkhead(opts) {
+    const maxConcurrent = opts.maxConcurrent;
+    const maxQueue = opts.maxQueue ?? maxConcurrent * 10;
+    const rejectOnFull = opts.rejectOnFull !== false; // default true
+    let active = 0;
+    let rejected = 0;
+    let completed = 0;
+    const queue = [];
+    function tryDequeue() {
+        if (active >= maxConcurrent)
+            return;
+        const next = queue.shift();
+        if (next) {
+            active += 1;
+            next();
+        }
+    }
+    function acquire() {
+        if (active < maxConcurrent) {
+            active += 1;
+            return Promise.resolve();
+        }
+        if (rejectOnFull && queue.length >= maxQueue) {
+            rejected += 1;
+            return Promise.reject(new BulkheadQueueFullError(active, queue.length, maxConcurrent, maxQueue));
+        }
+        // Either not rejectOnFull, or queue has room — enqueue.
+        return new Promise((resolve, reject) => {
+            if (queue.length >= maxQueue) {
+                // Reached here only when rejectOnFull=false but queue just filled
+                // concurrently before we could enqueue. Reject as safety valve.
+                rejected += 1;
+                reject(new BulkheadQueueFullError(active, queue.length, maxConcurrent, maxQueue));
+                return;
+            }
+            queue.push(() => {
+                resolve();
+            });
+        });
+    }
+    function release() {
+        active -= 1;
+        completed += 1;
+        tryDequeue();
+    }
+    return {
+        async run(fn) {
+            await acquire();
+            try {
+                return await fn();
+            }
+            finally {
+                release();
+            }
+        },
+        metrics() {
+            return { active, queued: queue.length, rejected, completed };
+        },
+    };
+}
+//# sourceMappingURL=bulkhead.js.map

package/dist/orchestration/bulkhead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulkhead.js","sourceRoot":"","sources":["../../src/orchestration/bulkhead.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,MAAc,EAAE,MAAc,EAAE,aAAqB,EAAE,QAAgB;QACjF,KAAK,CACH,0BAA0B,MAAM,IAAI,aAAa,YAAY,MAAM,IAAI,QAAQ,EAAE,CAClF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAuCD;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAI,IAAqB;IACrD,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,aAAa,GAAG,EAAE,CAAC;IACrD,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,KAAK,KAAK,CAAC,CAAC,eAAe;IAEjE,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,KAAK,GAAsB,EAAE,CAAC;IAEpC,SAAS,UAAU;QACjB,IAAI,MAAM,IAAI,aAAa;YAAE,OAAO;QACpC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,IAAI,CAAC,CAAC;YACZ,IAAI,EAAE,CAAC;QACT,CAAC;IACH,CAAC;IAED,SAAS,OAAO;QACd,IAAI,MAAM,GAAG,aAAa,EAAE,CAAC;YAC3B,MAAM,IAAI,CAAC,CAAC;YACZ,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QACD,IAAI,YAAY,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;YAC7C,QAAQ,IAAI,CAAC,CAAC;YACd,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,sBAAsB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,CAAC,CAC1E,CAAC;QACJ,CAAC;QACD,wDAAwD;QACxD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAC7B,kEAAkE;gBAClE,gEAAgE;gBAChE,QAAQ,IAAI,CAAC,CAAC;gBACd,MAAM,CAAC,IAAI,sBAAsB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;gBAClF,OAAO;YACT,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE;gBACd,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,SAAS,OAAO;QACd,MAAM,IAAI,CAAC,CAAC;QACZ,SAAS,IAAI,CAAC,CAAC;QACf,UAAU,EAAE,CAAC;IACf,CAAC;IAED,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,EAAoB;YAC5B,MAAM,OAAO,EAAE,CAAC;YAChB,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,EAAE,CAAC;YACpB,CAAC;oBAAS,CAAC;gBACT,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QAC/D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/orchestration/idempotency.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Idempotency primitives for orchestration-layer deduplication.
+ *
+ * Sprint-468 (command-center:sprint-468:idempotency-keys).
+ *
+ * Three utilities:
+ *   - computeIdempotencyKey  — SHA-256 fingerprint of a semantic payload
+ *   - withIdempotency        — in-memory call deduplication by key
+ *   - addIdempotencyHeader   — HTTP header injection for downstream services
+ *
+ * These operate at the orchestration layer (agent dispatch, pipeline step)
+ * rather than at the port level. Use the resilience/idempotent.ts primitive
+ * for direct port-wrapping; use these when you need explicit key management
+ * or HTTP propagation.
+ */
+export interface IdempotencyKeyPayload {
+    content: string;
+    author: string;
+    category: string;
+}
+/**
+ * Derive a stable SHA-256 hex key from a semantic payload.
+ *
+ * Fields are ordered deterministically (alphabetical) before hashing so
+ * that object construction order does not affect the result.
+ *
+ * @param payload - Semantic payload with content, author, and category.
+ * @returns 64-character lowercase hex string.
+ */
+export declare function computeIdempotencyKey(payload: IdempotencyKeyPayload): string;
+export interface WithIdempotencyOptions {
+    /** Entry TTL in ms. Default: 5 minutes. */
+    ttlMs?: number;
+}
+interface CacheEntry<T> {
+    promise: Promise<T>;
+    expiresAt: number;
+}
+export declare function withIdempotency<T>(call: () => Promise<T>, key: string, opts?: WithIdempotencyOptions, store?: Map<string, CacheEntry<unknown>>): Promise<T>;
+/**
+ * Inject an `X-Idempotency-Key` header into a plain headers record.
+ *
+ * Returns a new object — does not mutate the input. Safe to call in a
+ * pipeline step that builds the options for a downstream `fetch` call.
+ *
+ * @param headers - Existing headers object (may be empty).
+ * @param key     - Idempotency key (from computeIdempotencyKey or any string).
+ * @returns New headers object with X-Idempotency-Key added.
+ */
+export declare function addIdempotencyHeader(headers: Record<string, string>, key: string): Record<string, string>;
+export {};
+//# sourceMappingURL=idempotency.d.ts.map

package/dist/orchestration/idempotency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.d.ts","sourceRoot":"","sources":["../../src/orchestration/idempotency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAS5E;AAMD,MAAM,WAAW,sBAAsB;IACrC,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,UAAU,CAAC,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAwBD,wBAAgB,eAAe,CAAC,CAAC,EAC/B,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,sBAAsB,EAC7B,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,GACvC,OAAO,CAAC,CAAC,CAAC,CA0BZ;AAMD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,GAAG,EAAE,MAAM,GACV,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAExB"}

package/dist/orchestration/idempotency.js

@@ -0,0 +1,93 @@
+/**
+ * Idempotency primitives for orchestration-layer deduplication.
+ *
+ * Sprint-468 (command-center:sprint-468:idempotency-keys).
+ *
+ * Three utilities:
+ *   - computeIdempotencyKey  — SHA-256 fingerprint of a semantic payload
+ *   - withIdempotency        — in-memory call deduplication by key
+ *   - addIdempotencyHeader   — HTTP header injection for downstream services
+ *
+ * These operate at the orchestration layer (agent dispatch, pipeline step)
+ * rather than at the port level. Use the resilience/idempotent.ts primitive
+ * for direct port-wrapping; use these when you need explicit key management
+ * or HTTP propagation.
+ */
+import { createHash } from "node:crypto";
+/**
+ * Derive a stable SHA-256 hex key from a semantic payload.
+ *
+ * Fields are ordered deterministically (alphabetical) before hashing so
+ * that object construction order does not affect the result.
+ *
+ * @param payload - Semantic payload with content, author, and category.
+ * @returns 64-character lowercase hex string.
+ */
+export function computeIdempotencyKey(payload) {
+    const h = createHash("sha256");
+    // Deterministic field order — alphabet: author < category < content
+    h.update(payload.author);
+    h.update("\x1f");
+    h.update(payload.category);
+    h.update("\x1f");
+    h.update(payload.content);
+    return h.digest("hex");
+}
+/**
+ * Deduplicate concurrent or repeated async calls using an in-memory Map.
+ *
+ * While a call identified by `key` is in-flight, subsequent calls with the
+ * same key attach to the same Promise (fan-out dedup). Once the call
+ * settles, the result is cached for `ttlMs` ms so that replay requests
+ * within the window also receive the same value without re-invoking.
+ *
+ * Failures are NOT cached: a failed call is immediately evicted so it can
+ * be retried.
+ *
+ * The shared cache Map is module-scoped by default. Pass an explicit Map
+ * for per-instance isolation (e.g. in tests or multi-tenant agents).
+ *
+ * @param call  - Zero-argument factory returning a Promise.
+ * @param key   - Stable deduplication key (from computeIdempotencyKey or any string).
+ * @param opts  - Optional TTL override.
+ * @param store - Optional shared Map (module-level singleton by default).
+ */
+const _defaultStore = new Map();
+export function withIdempotency(call, key, opts, store) {
+    const cache = (store ?? _defaultStore);
+    const ttlMs = opts?.ttlMs ?? 5 * 60_000;
+    const now = Date.now();
+    const existing = cache.get(key);
+    if (existing !== undefined && existing.expiresAt > now) {
+        return existing.promise;
+    }
+    const promise = call().then((value) => {
+        // Refresh TTL on success so replays within window are cheap.
+        cache.set(key, { promise: Promise.resolve(value), expiresAt: Date.now() + ttlMs });
+        return value;
+    }, (err) => {
+        // Evict on failure — allow retry.
+        cache.delete(key);
+        return Promise.reject(err);
+    });
+    // Store the in-flight promise immediately so concurrent callers attach.
+    cache.set(key, { promise, expiresAt: now + ttlMs });
+    return promise;
+}
+// ---------------------------------------------------------------------------
+// addIdempotencyHeader
+// ---------------------------------------------------------------------------
+/**
+ * Inject an `X-Idempotency-Key` header into a plain headers record.
+ *
+ * Returns a new object — does not mutate the input. Safe to call in a
+ * pipeline step that builds the options for a downstream `fetch` call.
+ *
+ * @param headers - Existing headers object (may be empty).
+ * @param key     - Idempotency key (from computeIdempotencyKey or any string).
+ * @returns New headers object with X-Idempotency-Key added.
+ */
+export function addIdempotencyHeader(headers, key) {
+    return { ...headers, "X-Idempotency-Key": key };
+}
+//# sourceMappingURL=idempotency.js.map

package/dist/orchestration/idempotency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.js","sourceRoot":"","sources":["../../src/orchestration/idempotency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAYzC;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA8B;IAClE,MAAM,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC/B,oEAAoE;IACpE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC;AAgBD;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,aAAa,GAAG,IAAI,GAAG,EAA+B,CAAC;AAE7D,MAAM,UAAU,eAAe,CAC7B,IAAsB,EACtB,GAAW,EACX,IAA6B,EAC7B,KAAwC;IAExC,MAAM,KAAK,GAAG,CAAC,KAAK,IAAI,aAAa,CAA+B,CAAC;IACrE,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC;IACxC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;QACvD,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,EAAE,CAAC,IAAI,CACzB,CAAC,KAAK,EAAE,EAAE;QACR,6DAA6D;QAC7D,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QACnF,OAAO,KAAK,CAAC;IACf,CAAC,EACD,CAAC,GAAY,EAAE,EAAE;QACf,kCAAkC;QAClC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClB,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC,CACF,CAAC;IAEF,wEAAwE;IACxE,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC;IACpD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAA+B,EAC/B,GAAW;IAEX,OAAO,EAAE,GAAG,OAAO,EAAE,mBAAmB,EAAE,GAAG,EAAE,CAAC;AAClD,CAAC"}

package/dist/orchestration/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Orchestration primitives — public barrel.
+ *
+ * Exports:
+ *   - OODA agent loop (sprint-525 Bloc 5a)
+ *   - Idempotency key utilities (sprint-468:idempotency-keys)
+ *   - Bulkhead worker pool (sprint-468:bulkhead)
+ *
+ * @public
+ */
+export * from "./ooda/index.js";
+export type { IdempotencyKeyPayload, WithIdempotencyOptions } from "./idempotency.js";
+export { computeIdempotencyKey, withIdempotency, addIdempotencyHeader, } from "./idempotency.js";
+export { BulkheadQueueFullError, createBulkhead } from "./bulkhead.js";
+export type { BulkheadOptions as OrchestrationBulkheadOptions, BulkheadMetrics, BulkheadPool } from "./bulkhead.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/orchestration/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,iBAAiB,CAAC;AAGhC,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACvE,YAAY,EAAE,eAAe,IAAI,4BAA4B,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/orchestration/index.js

@@ -0,0 +1,15 @@
+/**
+ * Orchestration primitives — public barrel.
+ *
+ * Exports:
+ *   - OODA agent loop (sprint-525 Bloc 5a)
+ *   - Idempotency key utilities (sprint-468:idempotency-keys)
+ *   - Bulkhead worker pool (sprint-468:bulkhead)
+ *
+ * @public
+ */
+export * from "./ooda/index.js";
+export { computeIdempotencyKey, withIdempotency, addIdempotencyHeader, } from "./idempotency.js";
+// Bulkhead worker pool (sprint-468:bulkhead)
+export { BulkheadQueueFullError, createBulkhead } from "./bulkhead.js";
+//# sourceMappingURL=index.js.map

package/dist/orchestration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/orchestration/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,iBAAiB,CAAC;AAIhC,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAE1B,6CAA6C;AAC7C,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/orchestration/ooda/agent-config-loader.d.ts

@@ -0,0 +1,67 @@
+/**
+ * AgentConfigLoader — hot-reload config cache for OODA agents.
+ *
+ * Reads per-agent runtime configuration from the `agent_config` table with an
+ * in-memory TTL cache (default 30s). Each OODA cycle calls `get(agentId)` at
+ * the start; after the TTL expires the next call transparently re-fetches from
+ * the DB. No restart required for config changes.
+ *
+ * Column strategy:
+ *   - `config` (new schema) — preferred when present.
+ *   - `extra` (sprint-472 legacy) — backward-compat fallback.
+ *
+ * The `columnName` option allows the host to pin the column explicitly.
+ *
+ * @public
+ */
+import type { DbClient } from "../../tracking/agent-run-tracker.js";
+/**
+ * Minimal contract for a hot-reload config cache.
+ *
+ * @typeParam T - Shape of the agent configuration object.
+ */
+export interface AgentConfigLoader<T = Record<string, unknown>> {
+    /**
+     * Return config for `agentId`. Serves from cache when within TTL;
+     * otherwise fetches from `agent_config` table and refreshes the cache.
+     *
+     * If no row exists for `agentId`, returns `defaultConfig` (or `{}` if
+     * none was provided).
+     */
+    get(agentId: string): Promise<T>;
+    /**
+     * Evict `agentId` from the cache. The next `get` call will re-fetch
+     * from the database regardless of TTL.
+     */
+    invalidate(agentId: string): void;
+}
+/**
+ * Create a hot-reload config loader backed by the `agent_config` table.
+ *
+ * @example
+ * ```typescript
+ * const loader = createAgentConfigLoader<MyConfig>({
+ *   db,
+ *   ttlMs: 30_000,
+ *   defaultConfig: { kelly_cap: 0.2, conviction_min: 0.6 },
+ * });
+ *
+ * // At cycle start:
+ * const cfg = await loader.get(agentId);
+ * ```
+ */
+export declare function createAgentConfigLoader<T = Record<string, unknown>>(opts: {
+    /** Postgres-compatible DB client (pg.Pool, pg.Client, or test mock). */
+    db: DbClient;
+    /** Cache TTL in milliseconds. Default: 30 000 (30s). */
+    ttlMs?: number;
+    /** Returned when no row exists for the requested agentId. */
+    defaultConfig?: T;
+    /**
+     * Which JSONB column to read from `agent_config`.
+     * - `'extra'` — sprint-472 legacy column (default when omitted).
+     * - `'config'` — new column (set if schema was migrated to add it).
+     */
+    columnName?: "config" | "extra";
+}): AgentConfigLoader<T>;
+//# sourceMappingURL=agent-config-loader.d.ts.map

package/dist/orchestration/ooda/agent-config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-config-loader.d.ts","sourceRoot":"","sources":["../../../src/orchestration/ooda/agent-config-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAIpE;;;;GAIG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5D;;;;;;OAMG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEjC;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAWD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE;IACzE,wEAAwE;IACxE,EAAE,EAAE,QAAQ,CAAC;IACb,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,aAAa,CAAC,EAAE,CAAC,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CACjC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAqCvB"}