@vauban-org/agent-sdk 0.16.0

package/dist/orchestration/ooda/handoff.js

@@ -0,0 +1,86 @@
+/**
+ * Multi-agent handoff — Agent → Agent execution with history forwarding.
+ *
+ * Sprint-563: B2 — Multi-agent handoff() + asAgentTool() + handoffChain anti-cycle.
+ *
+ * handoff() wraps AgentsClient.execute with history forwarding (messages[]).
+ * handoffChain: string[] prevents infinite cycles (HandoffCycleError if agent
+ *   appears twice in the chain).
+ * asAgentTool(descriptor, client) → AgentTool capability for MCP consumption.
+ */
+export class HandoffCycleError extends Error {
+    constructor(agentId, chain) {
+        super(`Handoff cycle detected: agent "${agentId}" already in chain [${chain.join(" → ")} → ${agentId}]. Aborting.`);
+        this.name = "HandoffCycleError";
+    }
+}
+/**
+ * Execute a handoff to another agent. Forwards messages[] and checks for cycles.
+ * Throws HandoffCycleError if the target agent is already in the chain.
+ */
+export async function handoff(opts, client) {
+    const { targetAgentId, messages, handoffChain } = opts;
+    if (handoffChain.includes(targetAgentId)) {
+        throw new HandoffCycleError(targetAgentId, handoffChain);
+    }
+    const result = await client.execute(targetAgentId, {
+        messages,
+        handoffChain: [...handoffChain, targetAgentId],
+    });
+    return {
+        childRunId: result.runId,
+        nextChain: [...handoffChain, targetAgentId],
+        accepted: true,
+    };
+}
+/**
+ * Build a CycleEventV011 'handoff_initiated' event.
+ */
+export function handoffToEvent(targetAgentId, childRunId, handoffChain, runId, cycleIndex) {
+    return {
+        type: "handoff_initiated",
+        runId,
+        cycleIndex,
+        targetAgentId,
+        childRunId,
+        handoffChain,
+        ts: Date.now(),
+    };
+}
+export async function asAgentTool(descriptor, client) {
+    return {
+        name: `agent_${descriptor.agentId.replace(/[^a-zA-Z0-9_]/g, "_")}`,
+        description: `Handoff to agent: ${descriptor.name} — ${descriptor.description}`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                messages: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            role: { type: "string", enum: ["system", "user", "assistant", "tool"] },
+                            content: { type: "string" },
+                        },
+                        required: ["role", "content"],
+                    },
+                    description: "Conversation history to forward to the agent",
+                },
+                handoffChain: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Chain of agents that have already participated (anti-cycle)",
+                },
+            },
+            required: ["messages"],
+            additionalProperties: false,
+        },
+        async handler(input) {
+            return client.execute(descriptor.agentId, {
+                messages: input.messages,
+                handoffChain: input.handoffChain ?? [],
+            });
+        },
+    };
+}
+//# sourceMappingURL=handoff.js.map

package/dist/orchestration/ooda/handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.js","sourceRoot":"","sources":["../../../src/orchestration/ooda/handoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA0BH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe,EAAE,KAAe;QAC1C,KAAK,CACH,kCAAkC,OAAO,uBAAuB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,OAAO,cAAc,CAC7G,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAMD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,IAAoB,EACpB,MAA0B;IAE1B,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAEvD,IAAI,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,iBAAiB,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE;QACjD,QAAQ;QACR,YAAY,EAAE,CAAC,GAAG,YAAY,EAAE,aAAa,CAAC;KAC/C,CAAC,CAAC;IAEH,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,KAAK;QACxB,SAAS,EAAE,CAAC,GAAG,YAAY,EAAE,aAAa,CAAC;QAC3C,QAAQ,EAAE,IAAI;KACf,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,aAAqB,EACrB,UAAkB,EAClB,YAAsB,EACtB,KAAa,EACb,UAAkB;IAElB,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,KAAK;QACL,UAAU;QACV,aAAa;QACb,UAAU;QACV,YAAY;QACZ,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;KACf,CAAC;AACJ,CAAC;AAaD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,UAA2B,EAC3B,MAA0B;IAO1B,OAAO;QACL,IAAI,EAAE,SAAS,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,EAAE;QAClE,WAAW,EAAE,qBAAqB,UAAU,CAAC,IAAI,MAAM,UAAU,CAAC,WAAW,EAAE;QAC/E,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,UAAU,EAAE;4BACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE;4BACvE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;yBAC5B;wBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;qBAC9B;oBACD,WAAW,EAAE,8CAA8C;iBAC5D;gBACD,YAAY,EAAE;oBACZ,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,6DAA6D;iBAC3E;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;YACtB,oBAAoB,EAAE,KAAK;SAC5B;QACD,KAAK,CAAC,OAAO,CAAC,KAAK;YACjB,OAAO,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE;gBACxC,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,EAAE;aACvC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/orchestration/ooda/hitl-gate.d.ts

@@ -0,0 +1,57 @@
+/**
+ * OODA HITL gate — sprint-525:quick-2.
+ *
+ * Blocks the OODA `act` phase until a human approves (or rejects) the
+ * pending decision. In `dry-run` execution mode the gate is a no-op
+ * (auto-approve) so simulation runs do not require human attention.
+ *
+ * Live mode persists a row in `hitl_approvals` (status=`pending`) and
+ * polls every 2s until a row reaches `approved` / `rejected` or until
+ * the configured timeout elapses. On timeout, the `onTimeout` policy
+ * decides the verdict.
+ *
+ * The DbClient interface is the same minimal subset used elsewhere in
+ * the SDK (compatible with pg.Pool, pg.Client, and test mocks).
+ *
+ * @public
+ */
+import type { DbClient } from "../../tracking/agent-run-tracker.js";
+import type { ExecutionMode } from "./types.js";
+export type HITLOnTimeoutPolicy = "reject" | "approve" | "continue-skip";
+export interface HITLGateOptions {
+    /** Hard wait before applying onTimeout policy. Default: 5 minutes. */
+    timeoutMs?: number;
+    /** Verdict on timeout. Default: "reject". */
+    onTimeout?: HITLOnTimeoutPolicy;
+    /** Polling interval for live mode. Default: 2000 ms. */
+    pollIntervalMs?: number;
+}
+export interface HITLGateArgs {
+    runId: string;
+    agentId: string;
+    decisionPayload: Record<string, unknown>;
+    executionMode: ExecutionMode;
+}
+export interface HITLGateVerdict {
+    approved: boolean;
+    rationale?: string;
+    resolvedBy?: string;
+    timedOut: boolean;
+}
+/**
+ * Wait for a HITL approval before allowing the agent to commit the act
+ * phase. In `dry-run` mode this short-circuits to `approved=true` so
+ * simulation runs are non-blocking.
+ *
+ * Live mode contract:
+ *   1. INSERT a row in `hitl_approvals` with status='pending'
+ *   2. Poll every `pollIntervalMs` (default 2s) for status change
+ *   3. Resolve when status transitions to approved/rejected
+ *   4. On timeout: apply onTimeout policy (default 'reject')
+ *
+ * The polling interval is intentionally generous (2s) to avoid DB
+ * pressure under sustained workloads — UX latency is bounded by the
+ * human approval round-trip anyway.
+ */
+export declare function waitForHITLApproval(db: DbClient, args: HITLGateArgs, options?: HITLGateOptions): Promise<HITLGateVerdict>;
+//# sourceMappingURL=hitl-gate.d.ts.map

package/dist/orchestration/ooda/hitl-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hitl-gate.d.ts","sourceRoot":"","sources":["../../../src/orchestration/ooda/hitl-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,SAAS,GAAG,eAAe,CAAC;AAEzE,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAChC,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAiBD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,YAAY,EAClB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,eAAe,CAAC,CAyE1B"}

package/dist/orchestration/ooda/hitl-gate.js

@@ -0,0 +1,107 @@
+/**
+ * OODA HITL gate — sprint-525:quick-2.
+ *
+ * Blocks the OODA `act` phase until a human approves (or rejects) the
+ * pending decision. In `dry-run` execution mode the gate is a no-op
+ * (auto-approve) so simulation runs do not require human attention.
+ *
+ * Live mode persists a row in `hitl_approvals` (status=`pending`) and
+ * polls every 2s until a row reaches `approved` / `rejected` or until
+ * the configured timeout elapses. On timeout, the `onTimeout` policy
+ * decides the verdict.
+ *
+ * The DbClient interface is the same minimal subset used elsewhere in
+ * the SDK (compatible with pg.Pool, pg.Client, and test mocks).
+ *
+ * @public
+ */
+// ─── Defaults ─────────────────────────────────────────────────────────────────
+const DEFAULT_TIMEOUT_MS = 5 * 60 * 1000;
+const DEFAULT_POLL_INTERVAL_MS = 2000;
+const DEFAULT_ON_TIMEOUT = "reject";
+/**
+ * Wait for a HITL approval before allowing the agent to commit the act
+ * phase. In `dry-run` mode this short-circuits to `approved=true` so
+ * simulation runs are non-blocking.
+ *
+ * Live mode contract:
+ *   1. INSERT a row in `hitl_approvals` with status='pending'
+ *   2. Poll every `pollIntervalMs` (default 2s) for status change
+ *   3. Resolve when status transitions to approved/rejected
+ *   4. On timeout: apply onTimeout policy (default 'reject')
+ *
+ * The polling interval is intentionally generous (2s) to avoid DB
+ * pressure under sustained workloads — UX latency is bounded by the
+ * human approval round-trip anyway.
+ */
+export async function waitForHITLApproval(db, args, options = {}) {
+    // Auto-approve in dry-run regardless of DB state.
+    if (args.executionMode === "dry-run") {
+        return { approved: true, timedOut: false, resolvedBy: "dry-run-auto" };
+    }
+    if (args.executionMode !== "live") {
+        throw new Error(`[ooda/hitl-gate] invalid executionMode: ${String(args.executionMode)}`);
+    }
+    const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    const onTimeout = options.onTimeout ?? DEFAULT_ON_TIMEOUT;
+    // 1. INSERT pending row (returns id).
+    const insert = await db.query(`INSERT INTO hitl_approvals
+       (run_id, agent_id, decision_payload, status, requested_at)
+     VALUES
+       ($1, $2, $3::jsonb, 'pending', now())
+     RETURNING id`, [args.runId, args.agentId, JSON.stringify(args.decisionPayload)]);
+    const row = insert.rows[0];
+    if (!row) {
+        throw new Error("[ooda/hitl-gate] insert returned no row");
+    }
+    const hitlId = row.id;
+    // 2. Poll loop with hard deadline.
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const remaining = deadline - Date.now();
+        const sleepMs = Math.min(pollIntervalMs, Math.max(remaining, 0));
+        await sleep(sleepMs);
+        const poll = await db.query(`SELECT id, status, rationale, resolved_by
+         FROM hitl_approvals
+        WHERE id = $1`, [hitlId]);
+        const current = poll.rows[0];
+        if (!current) {
+            // Row vanished (cancellation) — treat as rejected.
+            return { approved: false, timedOut: false, rationale: "row-missing" };
+        }
+        if (current.status === "approved") {
+            return {
+                approved: true,
+                timedOut: false,
+                rationale: current.rationale ?? undefined,
+                resolvedBy: current.resolved_by ?? undefined,
+            };
+        }
+        if (current.status === "rejected") {
+            return {
+                approved: false,
+                timedOut: false,
+                rationale: current.rationale ?? undefined,
+                resolvedBy: current.resolved_by ?? undefined,
+            };
+        }
+    }
+    // 3. Timeout reached — apply policy.
+    const approvedOnTimeout = onTimeout === "approve" || onTimeout === "continue-skip";
+    return {
+        approved: approvedOnTimeout,
+        timedOut: true,
+        rationale: `timeout:${onTimeout}`,
+    };
+}
+function sleep(ms) {
+    return new Promise((resolve) => {
+        if (ms <= 0) {
+            resolve();
+            return;
+        }
+        setTimeout(resolve, ms);
+    });
+}
+//# sourceMappingURL=hitl-gate.js.map

package/dist/orchestration/ooda/hitl-gate.js.map

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

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

@@ -0,0 +1,48 @@
+/**
+ * OODA orchestration primitive — public barrel.
+ *
+ * @public
+ */
+export type { OODAPhaseKind, ExecutionMode, OODAContext, PhaseDef, SessionGuard, RiskGuard, OutcomeRecord, ResourceLimits, OODAAgentConfig, OODAAgent, CycleStatus, CycleEvent, CycleEventV010, CycleEventV011, } from "./types.js";
+export { DEFAULT_RESOURCE_LIMITS } from "./types.js";
+export type { Skill, SkillContext, SkillRegistry } from "./skills.js";
+export { EMPTY_SKILL_REGISTRY } from "./skills.js";
+export { OODAAgentImpl } from "./agent.js";
+export { createOODAAgent } from "./factory.js";
+export type { BrainCallResult, BrainChunk, BrainContextOptions, DegradedResponse, OrientInputWithBrain, } from "./brain-context.js";
+export { BrainSkillNotConfiguredError, isDegradedResponse, withBrainContext, } from "./brain-context.js";
+export type { AgentConfigLoader } from "./agent-config-loader.js";
+export { createAgentConfigLoader } from "./agent-config-loader.js";
+export { insertRunStep, completeRunStep, errorRunStep, } from "./run-step-persistence.js";
+export type { InsertRunStepInput } from "./run-step-persistence.js";
+export { waitForHITLApproval } from "./hitl-gate.js";
+export type { HITLGateOptions, HITLGateArgs, HITLGateVerdict, HITLOnTimeoutPolicy, } from "./hitl-gate.js";
+export { assertExecutionMode, readExecutionModeFromEnv, } from "./execution-mode-guard.js";
+export { ResourceLimitsRunner, StepCountExceededError, } from "./resource-limits.js";
+export type { ResourceLimitsOpts } from "./resource-limits.js";
+export { recordHITLDecision } from "./audit-log.js";
+export type { HITLDecision } from "./audit-log.js";
+export { redisCircuitBreaker, tripCircuitBreaker, resetCircuitBreaker, } from "./guards/redis-circuit-breaker.js";
+export type { CircuitBreakerResetMode, RedisCircuitBreakerOptions, MinimalRedisClient, } from "./guards/redis-circuit-breaker.js";
+export { rthSession } from "./guards/rth-session.js";
+export type { RTHSessionOptions } from "./guards/rth-session.js";
+export { businessHours } from "./guards/business-hours.js";
+export type { BusinessHoursOptions } from "./guards/business-hours.js";
+export { alwaysOn } from "./guards/always-on.js";
+export type { ImageMediaType, AudioMediaType, MultiModalObservation, AnthropicTextBlock, AnthropicImageBlock, AnthropicDocumentBlock, AnthropicContentBlock, } from "./multimodal.js";
+export { isMultiModal, multiModalToAnthropicContent } from "./multimodal.js";
+export type { ChildAgentPort, ChildAgentOptions, ChildAgentResult, } from "./child-agent.js";
+export type { ToolCall, ReactStep, ReactResult, LLMCompletionFn, ReactMessage, LLMReactResponse, ReactLoopOptions, } from "./react-loop.js";
+export { reactLoop } from "./react-loop.js";
+export type { PlanStep, Plan, StepResult, PlanExecutionResult, } from "./plan-execute.js";
+export { decomposeTask, executeStep } from "./plan-execute.js";
+export type { ReflexionEntry, ReflexionQuery } from "./reflexion.js";
+export { storeReflexion, queryReflexionMemory } from "./reflexion.js";
+export type { DebateStance, DebateSynthesis, DebateResult, DebateConfig, } from "./debate.js";
+export { runDebate } from "./debate.js";
+export type { InnerMonologueInput, InnerMonologueOutput, } from "./inner-monologue.js";
+export { SensitiveValue, innerMonologue } from "./inner-monologue.js";
+export { cronSessionGuard } from "./cron-schedule.js";
+export type { EconomicObserver } from "./economic-observer.js";
+export { economicObserverGuard } from "./economic-observer.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/orchestration/ooda/index.js

@@ -0,0 +1,33 @@
+/**
+ * OODA orchestration primitive — public barrel.
+ *
+ * @public
+ */
+export { DEFAULT_RESOURCE_LIMITS } from "./types.js";
+export { EMPTY_SKILL_REGISTRY } from "./skills.js";
+export { OODAAgentImpl } from "./agent.js";
+export { createOODAAgent } from "./factory.js";
+export { BrainSkillNotConfiguredError, isDegradedResponse, withBrainContext, } from "./brain-context.js";
+export { createAgentConfigLoader } from "./agent-config-loader.js";
+// Persistence + HITL gate + EXECUTION_MODE guard + resource runner (sprint-525:quick-2)
+export { insertRunStep, completeRunStep, errorRunStep, } from "./run-step-persistence.js";
+export { waitForHITLApproval } from "./hitl-gate.js";
+export { assertExecutionMode, readExecutionModeFromEnv, } from "./execution-mode-guard.js";
+export { ResourceLimitsRunner, StepCountExceededError, } from "./resource-limits.js";
+export { recordHITLDecision } from "./audit-log.js";
+// Redis circuit breaker guards (sprint-525:quick-3 + sprint-526:quick-3)
+export { redisCircuitBreaker, tripCircuitBreaker, resetCircuitBreaker, } from "./guards/redis-circuit-breaker.js";
+// Session guards (sprint-525:quick-3 + sprint-526:quick-2)
+export { rthSession } from "./guards/rth-session.js";
+export { businessHours } from "./guards/business-hours.js";
+export { alwaysOn } from "./guards/always-on.js";
+export { isMultiModal, multiModalToAnthropicContent } from "./multimodal.js";
+export { reactLoop } from "./react-loop.js";
+export { decomposeTask, executeStep } from "./plan-execute.js";
+export { storeReflexion, queryReflexionMemory } from "./reflexion.js";
+export { runDebate } from "./debate.js";
+export { SensitiveValue, innerMonologue } from "./inner-monologue.js";
+// CronExpression scheduling — sprint-565:5
+export { cronSessionGuard } from "./cron-schedule.js";
+export { economicObserverGuard } from "./economic-observer.js";
+//# sourceMappingURL=index.js.map

package/dist/orchestration/ooda/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/orchestration/ooda/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAGrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAU/C,OAAO,EACL,4BAA4B,EAC5B,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,wFAAwF;AACxF,OAAO,EACL,aAAa,EACb,eAAe,EACf,YAAY,GACb,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAQrD,OAAO,EACL,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGpD,yEAAyE;AACzE,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,mCAAmC,CAAC;AAO3C,2DAA2D;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAYjD,OAAO,EAAE,YAAY,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAmB7E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAS5C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAI/D,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAStE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAOxC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtE,2CAA2C;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAItD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/orchestration/ooda/inner-monologue.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Inner Monologue — Private reasoning scratchpad for the decide phase.
+ *
+ * The monologue is a private reasoning trace that is:
+ *   - NEVER stored in Brain
+ *   - NEVER included in span attributes
+ *   - NEVER logged to OTel traces
+ *
+ * Content is wrapped in `SensitiveValue<T>` that throws on `toString()`,
+ * with an explicit `reveal()` method gated behind `executionMode === "debug"`.
+ *
+ * Inner monologue can contain financial reasoning, vulnerability analysis,
+ * or strategic deliberation — leaking it to traces or Brain is a security
+ * boundary violation. Enforced at the type level, not convention.
+ *
+ * @public
+ */
+/**
+ * Wraps a value that MUST NOT be logged, traced, or stored.
+ *
+ * `toString()` throws intentionally — prevents accidental leakage via
+ * template literals, JSON.stringify, or log formatters.
+ */
+export declare class SensitiveValue<T> {
+    #private;
+    constructor(value: T, label?: string);
+    /** Intentionally throws — prevents accidental leakage. */
+    toString(): string;
+    /** JSON.stringify trap — prevents serialization. */
+    toJSON(): never;
+    /**
+     * Reveal the inner value.
+     *
+     * Gate this behind `executionMode === "debug"` — never expose in
+     * production traces, logs, or Brain archives.
+     */
+    reveal(): T;
+    get label(): string;
+}
+export interface InnerMonologueInput {
+    /** The observation or orient output to reason about. */
+    observation: unknown;
+    /** Agent configuration / context. */
+    config?: unknown;
+    /** Previous monologues from this cycle (for chain-of-thought). */
+    previous?: string[];
+}
+export interface InnerMonologueOutput {
+    /** The reasoning trace — wrapped as SensitiveValue. */
+    reasoning: SensitiveValue<string>;
+    /** Key insights extracted (safe for Brain archival). */
+    insights: string[];
+    /** Decision confidence (0.0 - 1.0). */
+    confidence: number;
+}
+/**
+ * Generate an inner monologue — private reasoning that MUST NOT leak.
+ *
+ * The `reasoner` function receives the input and returns the monologue.
+ * The returned `reasoning` is wrapped in `SensitiveValue<string>`.
+ *
+ * Use `reveal()` only in debug execution mode — never in production.
+ */
+export declare function innerMonologue(input: InnerMonologueInput, reasoner: (input: InnerMonologueInput) => Promise<{
+    reasoning: string;
+    insights: string[];
+    confidence: number;
+}>): Promise<InnerMonologueOutput>;
+//# sourceMappingURL=inner-monologue.d.ts.map

package/dist/orchestration/ooda/inner-monologue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inner-monologue.d.ts","sourceRoot":"","sources":["../../../src/orchestration/ooda/inner-monologue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH;;;;;GAKG;AACH,qBAAa,cAAc,CAAC,CAAC;;gBAIf,KAAK,EAAE,CAAC,EAAE,KAAK,SAAc;IAKzC,0DAA0D;IAC1D,QAAQ,IAAI,MAAM;IAIlB,oDAAoD;IACpD,MAAM,IAAI,KAAK;IAIf;;;;;OAKG;IACH,MAAM,IAAI,CAAC;IAIX,IAAI,KAAK,IAAI,MAAM,CAElB;CACF;AAID,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,WAAW,EAAE,OAAO,CAAC;IACrB,qCAAqC;IACrC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,SAAS,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAClC,wDAAwD;IACxD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,GAC/G,OAAO,CAAC,oBAAoB,CAAC,CAO/B"}

package/dist/orchestration/ooda/inner-monologue.js

@@ -0,0 +1,69 @@
+/**
+ * Inner Monologue — Private reasoning scratchpad for the decide phase.
+ *
+ * The monologue is a private reasoning trace that is:
+ *   - NEVER stored in Brain
+ *   - NEVER included in span attributes
+ *   - NEVER logged to OTel traces
+ *
+ * Content is wrapped in `SensitiveValue<T>` that throws on `toString()`,
+ * with an explicit `reveal()` method gated behind `executionMode === "debug"`.
+ *
+ * Inner monologue can contain financial reasoning, vulnerability analysis,
+ * or strategic deliberation — leaking it to traces or Brain is a security
+ * boundary violation. Enforced at the type level, not convention.
+ *
+ * @public
+ */
+// ─── SensitiveValue ─────────────────────────────────────────────────────────────
+/**
+ * Wraps a value that MUST NOT be logged, traced, or stored.
+ *
+ * `toString()` throws intentionally — prevents accidental leakage via
+ * template literals, JSON.stringify, or log formatters.
+ */
+export class SensitiveValue {
+    #value;
+    #label;
+    constructor(value, label = "sensitive") {
+        this.#value = value;
+        this.#label = label;
+    }
+    /** Intentionally throws — prevents accidental leakage. */
+    toString() {
+        throw new Error(`SensitiveValue<${this.#label}>: use reveal() with explicit debug mode check`);
+    }
+    /** JSON.stringify trap — prevents serialization. */
+    toJSON() {
+        throw new Error(`SensitiveValue<${this.#label}>: cannot be serialized`);
+    }
+    /**
+     * Reveal the inner value.
+     *
+     * Gate this behind `executionMode === "debug"` — never expose in
+     * production traces, logs, or Brain archives.
+     */
+    reveal() {
+        return this.#value;
+    }
+    get label() {
+        return this.#label;
+    }
+}
+/**
+ * Generate an inner monologue — private reasoning that MUST NOT leak.
+ *
+ * The `reasoner` function receives the input and returns the monologue.
+ * The returned `reasoning` is wrapped in `SensitiveValue<string>`.
+ *
+ * Use `reveal()` only in debug execution mode — never in production.
+ */
+export async function innerMonologue(input, reasoner) {
+    const result = await reasoner(input);
+    return {
+        reasoning: new SensitiveValue(result.reasoning, "inner-monologue"),
+        insights: result.insights,
+        confidence: result.confidence,
+    };
+}
+//# sourceMappingURL=inner-monologue.js.map

package/dist/orchestration/ooda/inner-monologue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inner-monologue.js","sourceRoot":"","sources":["../../../src/orchestration/ooda/inner-monologue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,mFAAmF;AAEnF;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IAChB,MAAM,CAAI;IACV,MAAM,CAAS;IAExB,YAAY,KAAQ,EAAE,KAAK,GAAG,WAAW;QACvC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,0DAA0D;IAC1D,QAAQ;QACN,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,CAAC,MAAM,gDAAgD,CAAC,CAAC;IACjG,CAAC;IAED,oDAAoD;IACpD,MAAM;QACJ,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,CAAC,MAAM,yBAAyB,CAAC,CAAC;IAC1E,CAAC;IAED;;;;;OAKG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAsBD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAA0B,EAC1B,QAAgH;IAEhH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC;IACrC,OAAO;QACL,SAAS,EAAE,IAAI,cAAc,CAAC,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAAC;QAClE,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,60 @@
+/**
+ * Learning loop — shadow mode skill extraction from agent traces.
+ *
+ * Sprint-564: C2 — extractSkillFromTrace via LLM-as-optimizer.
+ *
+ * Trigger composite: toolCallCount >= 4 && roi > 0 && durationMs > 5000 && !wasReplay.
+ * NEVER inject learned skills into prod without explicit feature flag + signal stat sig.
+ * Golden fixtures snapshot tests detect drift in extraction quality.
+ *
+ * ANTI-AUDITABLE: learning loop is opt-in shadow mode only. Never active in production
+ * without explicit founder approval (CH7 Audit safe).
+ */
+import type { OODAContext, CycleEvent } from "./types.js";
+export interface SkillLedger {
+    add?(name: string, skill: {
+        description: string;
+        chainOfThought: string;
+        source: string;
+        confidence: number;
+    }): void;
+}
+export interface LearningTrigger {
+    toolCallCount: number;
+    roi: number;
+    durationMs: number;
+    wasReplay: boolean;
+}
+export interface ExtractedSkill {
+    name: string;
+    description: string;
+    chainOfThought: string;
+    confidence: number;
+    /** Whether this skill passed the golden fixtures gate. */
+    verified: boolean;
+}
+export interface LearnOptions {
+    /** Feature flag — must be explicitly enabled. Default: false. */
+    enabled: boolean;
+    /** Minimum confidence to accept a learned skill (0-1). Default: 0.85. */
+    minConfidence?: number;
+    /** Skill ledger to inject learned skills into. */
+    ledger?: SkillLedger;
+    /** LLM call for skill extraction. */
+    extractor?: (trace: string) => Promise<ExtractedSkill | null>;
+}
+/**
+ * Determine if learning should trigger for a completed cycle.
+ */
+export declare function shouldLearn(trigger: LearningTrigger): boolean;
+/**
+ * Extract a skill from a completed trace. Uses LLM-as-optimizer (Claude, not GEPA Python).
+ * Returns null if extraction fails or confidence below threshold.
+ * NEVER injects into SkillLedger without feature flag gate.
+ */
+export declare function extractSkillFromTrace(events: CycleEvent[], _ctx: OODAContext, opts: LearnOptions): Promise<ExtractedSkill | null>;
+export declare const GOLDEN_FIXTURES: ReadonlyArray<{
+    trace: string;
+    expectedSkillName: string;
+}>;
+//# sourceMappingURL=learn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"learn.d.ts","sourceRoot":"","sources":["../../../src/orchestration/ooda/learn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACtH;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,qCAAqC;IACrC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CAC/D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAO7D;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,UAAU,EAAE,EACpB,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA4BhC;AAmCD,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAYA,CAAC"}