@vauban-org/agent-sdk 0.16.0

package/dist/orchestration/ooda/agent-config-loader.js

@@ -0,0 +1,65 @@
+/**
+ * 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
+ */
+// ─── Factory ──────────────────────────────────────────────────────────────────
+/**
+ * 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 function createAgentConfigLoader(opts) {
+    const ttlMs = opts.ttlMs ?? 30_000;
+    const defaultConfig = (opts.defaultConfig ?? {});
+    const column = opts.columnName ?? "extra";
+    const cache = new Map();
+    async function fetch(agentId) {
+        const result = await opts.db.query(`SELECT ${column} AS cfg FROM agent_config WHERE agent_id = $1`, [agentId]);
+        if (!result.rows.length) {
+            return defaultConfig;
+        }
+        const raw = result.rows[0].cfg;
+        if (raw == null || typeof raw !== "object" || Array.isArray(raw)) {
+            return defaultConfig;
+        }
+        return raw;
+    }
+    return {
+        async get(agentId) {
+            const now = Date.now();
+            const entry = cache.get(agentId);
+            if (entry !== undefined && entry.expiresAt > now) {
+                return entry.config;
+            }
+            const config = await fetch(agentId);
+            cache.set(agentId, { config, expiresAt: now + ttlMs });
+            return config;
+        },
+        invalidate(agentId) {
+            cache.delete(agentId);
+        },
+    };
+}
+//# sourceMappingURL=agent-config-loader.js.map

package/dist/orchestration/ooda/agent-config-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-config-loader.js","sourceRoot":"","sources":["../../../src/orchestration/ooda/agent-config-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAmCH,iFAAiF;AAEjF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,uBAAuB,CAA8B,IAapE;IACC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC;IACnC,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAM,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,IAAI,OAAO,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE/C,KAAK,UAAU,KAAK,CAAC,OAAe;QAClC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAChC,UAAU,MAAM,+CAA+C,EAC/D,CAAC,OAAO,CAAC,CACV,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACxB,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAC/B,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACjE,OAAO,aAAa,CAAC;QACvB,CAAC;QACD,OAAO,GAAQ,CAAC;IAClB,CAAC;IAED,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,OAAe;YACvB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACjC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;gBACjD,OAAO,KAAK,CAAC,MAAM,CAAC;YACtB,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;YACpC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC;YACvD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,UAAU,CAAC,OAAe;YACxB,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/orchestration/ooda/agent.d.ts

@@ -0,0 +1,54 @@
+/**
+ * OODAAgentImpl — sequential while+sleep cycle loop with phase persistence,
+ * guards, HITL gate, resource limits, and replay-safe context propagation.
+ *
+ * Implements all 10 anti-patterns enforced by-design (see `./types.ts`).
+ *
+ * @public
+ */
+import type { CycleEvent, CycleStatus, OODAAgent, OODAAgentConfig } from "./types.js";
+/**
+ * OODAAgentImpl — concrete implementation. Prefer `createOODAAgent` factory.
+ */
+export declare class OODAAgentImpl<TConfig = unknown, TObs = unknown, TOrient = unknown, TDecision = unknown, TAction = unknown, TFeedback = unknown> implements OODAAgent {
+    private readonly _config;
+    private readonly _limits;
+    private _running;
+    private _cyclesCompleted;
+    private _lastCycleAt?;
+    private _activeCycle?;
+    constructor(config: OODAAgentConfig<TConfig, TObs, TOrient, TDecision, TAction, TFeedback>);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    triggerCycle(opts: {
+        dryRun: boolean;
+        initialContext?: Record<string, unknown>;
+    }): Promise<{
+        runId: string;
+        status: CycleStatus;
+    }>;
+    streamCycle(opts: {
+        dryRun: boolean;
+        initialContext?: Record<string, unknown>;
+    }): AsyncGenerator<CycleEvent>;
+    getStatus(): {
+        running: boolean;
+        lastCycleAt?: string;
+        nextCycleAt?: string;
+        cyclesCompleted: number;
+    };
+    private runCycle;
+    /**
+     * Execute one full cycle, pushing `CycleEvent` to `sink` as they occur.
+     * Used by `streamCycle()` to decouple event emission from async generator
+     * mechanics. Single-pass — each phase runs exactly once.
+     */
+    private _runCycleWithSink;
+    /**
+     * Run a single OODA phase with OTel span instrumentation. Used by runCycle().
+     */
+    private _runOodaPhase;
+    private _checkSessionGuards;
+    private _checkRiskGuards;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/orchestration/ooda/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/orchestration/ooda/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EAEX,SAAS,EACT,eAAe,EAMhB,MAAM,YAAY,CAAC;AAyGpB;;GAEG;AACH,qBAAa,aAAa,CACxB,OAAO,GAAG,OAAO,EACjB,IAAI,GAAG,OAAO,EACd,OAAO,GAAG,OAAO,EACjB,SAAS,GAAG,OAAO,EACnB,OAAO,GAAG,OAAO,EACjB,SAAS,GAAG,OAAO,CACnB,YAAW,SAAS;IAEpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAOtB;IACF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IACnD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAC,CAAmB;gBAGtC,MAAM,EAAE,eAAe,CACrB,OAAO,EACP,IAAI,EACJ,OAAO,EACP,SAAS,EACT,OAAO,EACP,SAAS,CACV;IAgBG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAatB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAWrB,YAAY,CAAC,IAAI,EAAE;QACvB,MAAM,EAAE,OAAO,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC1C,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,CAAA;KAAE,CAAC;IAS5C,WAAW,CAAC,IAAI,EAAE;QACvB,MAAM,EAAE,OAAO,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC1C,GAAG,cAAc,CAAC,UAAU,CAAC;IAyD9B,SAAS,IAAI;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;KACzB;YAUa,QAAQ;IAmOtB;;;;OAIG;YACW,iBAAiB;IAuY/B;;OAEG;YACW,aAAa;YA4Db,mBAAmB;YAWnB,gBAAgB;CAY/B"}