@vauban-org/agent-sdk 0.16.0

package/dist/outcomes/trajectory.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Trajectory export — RLHF/DPO training data from agent traces.
+ *
+ * Sprint-563: B3 — exportTrajectory(runId, db, opts).
+ *
+ * Formats:
+ *  - jsonl: one JSON object per line, auto-labeled (positive/negative/neutral)
+ *  - openai-dpo: OpenAI-compatible DPO format with chosen/rejected pairs
+ *
+ * Auto-labeling: outcome.value_cents > 0 → positive, < 0 → negative, null → neutral.
+ */
+import type { DbClient } from "../tracking/agent-run-tracker.js";
+export type TrajectoryFormat = "jsonl" | "openai-dpo";
+export interface TrajectoryOptions {
+    format: TrajectoryFormat;
+    /** Minimum tokens to include a step (skip empty LLM calls). */
+    minTokens?: number;
+    /** Maximum steps to export (default 1000). */
+    maxSteps?: number;
+}
+export interface TrajectoryStep {
+    runId: string;
+    stepIndex: number;
+    phase: string;
+    type: string;
+    input?: unknown;
+    output?: unknown;
+    model?: string;
+    provider?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    costUsd?: number;
+    durationMs?: number;
+    timestamp?: string;
+    /** Auto-label: positive | negative | neutral */
+    label: "positive" | "negative" | "neutral";
+}
+export interface TrajectoryExport {
+    steps: TrajectoryStep[];
+    totalCost: number;
+    totalTokens: number;
+    format: TrajectoryFormat;
+}
+/**
+ * Fetch trace steps from a run and export as training trajectory.
+ * Uses the db client to query run_step rows.
+ */
+export declare function exportTrajectory(runId: string, db: DbClient, opts?: TrajectoryOptions): Promise<TrajectoryExport>;
+/**
+ * Serialize a trajectory export to the requested format.
+ */
+export declare function serializeTrajectory(exp: TrajectoryExport): string;
+//# sourceMappingURL=trajectory.d.ts.map

package/dist/outcomes/trajectory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory.d.ts","sourceRoot":"","sources":["../../src/outcomes/trajectory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAEjE,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,YAAY,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,gBAAgB,CAAC;IACzB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;CAC5C;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,QAAQ,EACZ,IAAI,GAAE,iBAAuC,GAC5C,OAAO,CAAC,gBAAgB,CAAC,CAwD3B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,CAsBjE"}

package/dist/outcomes/trajectory.js

@@ -0,0 +1,110 @@
+/**
+ * Trajectory export — RLHF/DPO training data from agent traces.
+ *
+ * Sprint-563: B3 — exportTrajectory(runId, db, opts).
+ *
+ * Formats:
+ *  - jsonl: one JSON object per line, auto-labeled (positive/negative/neutral)
+ *  - openai-dpo: OpenAI-compatible DPO format with chosen/rejected pairs
+ *
+ * Auto-labeling: outcome.value_cents > 0 → positive, < 0 → negative, null → neutral.
+ */
+/**
+ * Fetch trace steps from a run and export as training trajectory.
+ * Uses the db client to query run_step rows.
+ */
+export async function exportTrajectory(runId, db, opts = { format: "jsonl" }) {
+    const maxSteps = opts.maxSteps ?? 1000;
+    const minTokens = opts.minTokens ?? 0;
+    // Query steps from DB
+    const rows = await db.query?.(`SELECT step_index, phase, type, payload, model, provider,
+            input_tokens, output_tokens, cost_usd, duration_ms,
+            created_at, outcome_value_cents
+     FROM run_step
+     WHERE run_id = $1
+     ORDER BY step_index
+     LIMIT $2`, [runId, String(maxSteps)]);
+    const steps = [];
+    if (rows?.rows) {
+        for (const row of rows.rows) {
+            const inputTokens = Number(row.input_tokens ?? 0);
+            const outputTokens = Number(row.output_tokens ?? 0);
+            if (inputTokens + outputTokens < minTokens)
+                continue;
+            const valueCents = row.outcome_value_cents != null
+                ? Number(row.outcome_value_cents)
+                : null;
+            steps.push({
+                runId,
+                stepIndex: Number(row.step_index ?? 0),
+                phase: String(row.phase ?? "unknown"),
+                type: String(row.type ?? "unknown"),
+                input: tryParse(row.payload),
+                output: tryParse(row.output),
+                model: row.model ? String(row.model) : undefined,
+                provider: row.provider ? String(row.provider) : undefined,
+                inputTokens,
+                outputTokens,
+                costUsd: Number(row.cost_usd ?? 0),
+                durationMs: Number(row.duration_ms ?? 0),
+                timestamp: row.created_at ? String(row.created_at) : undefined,
+                label: valueCents === null ? "neutral"
+                    : valueCents > 0 ? "positive"
+                        : "negative",
+            });
+        }
+    }
+    const totalCost = steps.reduce((s, st) => s + (st.costUsd ?? 0), 0);
+    const totalTokens = steps.reduce((s, st) => s + (st.inputTokens ?? 0) + (st.outputTokens ?? 0), 0);
+    return { steps, totalCost, totalTokens, format: opts.format };
+}
+/**
+ * Serialize a trajectory export to the requested format.
+ */
+export function serializeTrajectory(exp) {
+    if (exp.format === "jsonl") {
+        return exp.steps.map((s) => JSON.stringify(s)).join("\n");
+    }
+    // openai-dpo: pair consecutive steps as chosen/rejected
+    const pairs = [];
+    const positive = exp.steps.filter((s) => s.label === "positive");
+    const negative = exp.steps.filter((s) => s.label === "negative");
+    for (let i = 0; i < Math.min(positive.length, negative.length); i++) {
+        pairs.push({ chosen: positive[i], rejected: negative[i] });
+    }
+    return pairs
+        .map((p) => JSON.stringify({
+        chosen: formatDpoMessage(p.chosen),
+        rejected: formatDpoMessage(p.rejected),
+    }))
+        .join("\n");
+}
+function formatDpoMessage(step) {
+    return {
+        messages: [
+            ...(step.input
+                ? [{ role: "user", content: typeof step.input === "string" ? step.input : JSON.stringify(step.input) }]
+                : []),
+            ...(step.output
+                ? [{ role: "assistant", content: typeof step.output === "string" ? step.output : JSON.stringify(step.output) }]
+                : []),
+        ],
+        metadata: {
+            model: step.model,
+            cost_usd: step.costUsd,
+            label: step.label,
+        },
+    };
+}
+function tryParse(v) {
+    if (typeof v === "string") {
+        try {
+            return JSON.parse(v);
+        }
+        catch {
+            return v;
+        }
+    }
+    return v;
+}
+//# sourceMappingURL=trajectory.js.map

package/dist/outcomes/trajectory.js.map

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

package/dist/outcomes/types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Outcomes module — wire types for /api/outcomes/* REST endpoints.
+ *
+ * All monetary amounts are integer cents (signed). Negative = cost.
+ * Route implementation lives in command-center /api/outcomes/* (sprint-522:quick-4).
+ */
+/**
+ * Open-ended outcome type discriminant.
+ * Canonical values: trade_pnl, forecast_accurate, knowledge_consolidated,
+ * cost_savings, lead_qualified, sprint_completed, etc.
+ */
+export type OutcomeType = string;
+/** A single measurable business result attributed to an agent run. */
+export interface Outcome {
+    id: string;
+    agent_id: string;
+    /** UUID of the agent_run row that produced this outcome. Nullable when created offline. */
+    agent_run_id: string | null;
+    outcome_type: OutcomeType;
+    /** Signed integer cents. Positive = value created, negative = cost incurred. */
+    value_cents: number;
+    /** ISO 4217 currency code. Defaults to 'USD'. */
+    currency: string;
+    /** ISO 8601 timestamp of when the outcome occurred. */
+    occurred_at: string;
+    /**
+     * True when the monetary value has not yet been back-filled from an
+     * authoritative source (e.g. trade P&L still pending settlement).
+     */
+    is_pending_backfill: boolean;
+    metadata?: Record<string, unknown> | null;
+}
+/** Aggregated outcome statistics for a given time window. */
+export interface OutcomeSummary {
+    period: {
+        from: string;
+        to: string;
+    };
+    /** Sum of positive value_cents over the period. */
+    total_value_cents: number;
+    /** Absolute sum of negative value_cents (stored as positive). */
+    total_cost_cents: number;
+    /** total_value_cents / total_cost_cents. Null when cost == 0. */
+    value_to_cost_ratio: number | null;
+    /** (total_value_cents - total_cost_cents) / total_cost_cents * 100. Null when cost == 0. */
+    net_roi_pct: number | null;
+    outcome_count: number;
+    attributed_count: number;
+    /** Outcomes where is_pending_backfill = true. */
+    pending_attribution_count: number;
+}
+/** Per-agent ROI breakdown for a time window. */
+export interface RoiPerAgent {
+    agent_id: string;
+    period: {
+        from: string;
+        to: string;
+    };
+    value_cents: number;
+    cost_cents: number;
+    /** Null when cost_cents == 0. */
+    net_roi_pct: number | null;
+    outcome_count: number;
+    /** pending_count / outcome_count. 0 when outcome_count == 0. */
+    pending_ratio: number;
+    /** Week-over-week delta in net_roi_pct. Null when prior week data unavailable. */
+    wow_delta_pct: number | null;
+}
+/** CFO-ready burn-rate and initiative breakdown view. */
+export interface CfoView {
+    period: {
+        from: string;
+        to: string;
+    };
+    /** Average daily spend in cents over the period. */
+    burn_rate_per_day_cents: number;
+    /** burn_rate_per_day_cents * 30. */
+    projected_30d_cents: number;
+    by_initiative: Array<{
+        initiative_id: string;
+        spent_cents: number;
+        /** Null when no budget is assigned to the initiative. */
+        budget_cents: number | null;
+        /** spent_cents / budget_cents * 100. Null when budget_cents is null. */
+        pct: number | null;
+    }>;
+    /**
+     * Sum of value_cents for is_pending_backfill=true rows.
+     * Lower-bound estimate of unrealised value.
+     */
+    pending_value_estimate_cents: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/outcomes/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/outcomes/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC,sEAAsE;AACtE,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,2FAA2F;IAC3F,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,WAAW,CAAC;IAC1B,gFAAgF;IAChF,WAAW,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,mBAAmB,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC3C;AAED,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,mDAAmD;IACnD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,gBAAgB,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,4FAA4F;IAC5F,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,yBAAyB,EAAE,MAAM,CAAC;CACnC;AAED,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,yDAAyD;AACzD,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,oDAAoD;IACpD,uBAAuB,EAAE,MAAM,CAAC;IAChC,oCAAoC;IACpC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,KAAK,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,yDAAyD;QACzD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,wEAAwE;QACxE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;KACpB,CAAC,CAAC;IACH;;;OAGG;IACH,4BAA4B,EAAE,MAAM,CAAC;CACtC"}

package/dist/outcomes/types.js

@@ -0,0 +1,8 @@
+/**
+ * Outcomes module — wire types for /api/outcomes/* REST endpoints.
+ *
+ * All monetary amounts are integer cents (signed). Negative = cost.
+ * Route implementation lives in command-center /api/outcomes/* (sprint-522:quick-4).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/outcomes/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/outcomes/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/patterns/_shared/brain-logger.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared non-blocking Brain archive helper for orchestration patterns.
+ *
+ * Returns void (not Promise<void>) — explicit fire-and-forget contract.
+ * Callers that accidentally await this get a compile-time warning since
+ * void is not meaningfully awaitable.
+ *
+ * @internal — do not re-export from any public pattern barrel.
+ */
+import type { BrainPort, BrainEntryInput } from "../../ports/brain.js";
+export declare function logToBrain(brain: BrainPort | undefined | null, entry: BrainEntryInput): void;
+//# sourceMappingURL=brain-logger.d.ts.map

package/dist/patterns/_shared/brain-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-logger.d.ts","sourceRoot":"","sources":["../../../src/patterns/_shared/brain-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvE,wBAAgB,UAAU,CACxB,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,EACnC,KAAK,EAAE,eAAe,GACrB,IAAI,CAGN"}

package/dist/patterns/_shared/brain-logger.js

@@ -0,0 +1,6 @@
+export function logToBrain(brain, entry) {
+    if (!brain)
+        return;
+    brain.archiveKnowledge(entry).catch(() => undefined);
+}
+//# sourceMappingURL=brain-logger.js.map

package/dist/patterns/_shared/brain-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-logger.js","sourceRoot":"","sources":["../../../src/patterns/_shared/brain-logger.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,UAAU,CACxB,KAAmC,EACnC,KAAsB;IAEtB,IAAI,CAAC,KAAK;QAAE,OAAO;IACnB,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AACvD,CAAC"}

package/dist/patterns/circuit-breaker/index.d.ts

@@ -0,0 +1,3 @@
+export { createSessionCircuitBreaker } from "./session-cb.js";
+export type { SessionCircuitBreaker, CircuitBreakerConfig, CircuitBreakerThresholds, CircuitSnapshot, CircuitState, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/patterns/circuit-breaker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/patterns/circuit-breaker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAC9D,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,EACf,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/patterns/circuit-breaker/index.js

@@ -0,0 +1,2 @@
+export { createSessionCircuitBreaker } from "./session-cb.js";
+//# sourceMappingURL=index.js.map

package/dist/patterns/circuit-breaker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/patterns/circuit-breaker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/patterns/circuit-breaker/session-cb.d.ts

@@ -0,0 +1,3 @@
+import type { CircuitBreakerConfig, SessionCircuitBreaker } from "./types.js";
+export declare function createSessionCircuitBreaker(config: CircuitBreakerConfig): SessionCircuitBreaker;
+//# sourceMappingURL=session-cb.d.ts.map

package/dist/patterns/circuit-breaker/session-cb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-cb.d.ts","sourceRoot":"","sources":["../../../src/patterns/circuit-breaker/session-cb.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,oBAAoB,EAGpB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAUpB,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,oBAAoB,GAC3B,qBAAqB,CA+KvB"}

package/dist/patterns/circuit-breaker/session-cb.js

@@ -0,0 +1,175 @@
+/**
+ * Pattern A: Session-Level Circuit Breaker — factory.
+ * @public
+ */
+import { logToBrain } from "../_shared/brain-logger.js";
+const NOOP = {
+    debug: () => undefined,
+    info: () => undefined,
+    warn: () => undefined,
+    error: () => undefined,
+};
+export function createSessionCircuitBreaker(config) {
+    const { name, thresholds = {}, resetAfterMs = 60_000, brain, onTrip, _now = Date.now, } = config;
+    const logger = config.logger ?? NOOP;
+    const maxTokens = thresholds.maxTokens ?? 50_000;
+    const maxConsecutiveErrors = thresholds.maxConsecutiveErrors ?? 5;
+    const maxActionCount = thresholds.maxActionCount ?? 200;
+    const maxElapsedMs = thresholds.maxElapsedMs ?? 3_600_000;
+    const maxCostUsd = thresholds.maxCostUsd ?? 10.0;
+    let state = "closed";
+    let tripReason;
+    let openedAt;
+    const sessionStart = _now();
+    let tokenCount = 0;
+    let consecutiveErrors = 0;
+    let actionCount = 0;
+    let estimatedCostUsd = 0;
+    function snap() {
+        return {
+            state,
+            tokenCount,
+            consecutiveErrors,
+            actionCount,
+            elapsedMs: _now() - sessionStart,
+            estimatedCostUsd,
+            tripReason,
+            openedAt,
+        };
+    }
+    function doTrip(reason) {
+        if (state === "open")
+            return; // idempotent
+        state = "open";
+        tripReason = reason;
+        openedAt = _now();
+        logger.warn({ name, reason }, `[session-cb:${name}] OPEN: ${reason}`);
+        logToBrain(brain, {
+            content: `Session CB '${name}' tripped OPEN. ${reason}`,
+            content_type: "event",
+            author: `session-cb:${name}`,
+            category: "incident",
+            tags: ["circuit-breaker", "session", name, "tripped"],
+            confidence: 0.95,
+            metadata: snap(),
+        });
+        try {
+            onTrip?.(snap());
+        }
+        catch {
+            /* suppress */
+        }
+    }
+    function checkThresholds() {
+        if (tokenCount > maxTokens)
+            return `tokenCount(${tokenCount}) > maxTokens(${maxTokens})`;
+        if (consecutiveErrors >= maxConsecutiveErrors)
+            return `consecutiveErrors(${consecutiveErrors}) >= ${maxConsecutiveErrors}`;
+        if (actionCount > maxActionCount)
+            return `actionCount(${actionCount}) > maxActionCount(${maxActionCount})`;
+        const elapsed = _now() - sessionStart;
+        if (elapsed > maxElapsedMs)
+            return `elapsedMs(${elapsed}) > maxElapsedMs(${maxElapsedMs})`;
+        if (estimatedCostUsd > maxCostUsd)
+            return `costUsd($${estimatedCostUsd.toFixed(4)}) > maxCostUsd($${maxCostUsd})`;
+        return null;
+    }
+    async function check(_ctx) {
+        const now = _now();
+        if (state === "open") {
+            const elapsed = openedAt !== undefined ? now - openedAt : resetAfterMs;
+            if (elapsed < resetAfterMs) {
+                return {
+                    proceed: false,
+                    reason: `session-cb:${name} OPEN (${tripReason ?? "threshold breach"})`,
+                };
+            }
+            state = "half-open";
+            // Reset consecutiveErrors so the inherited count from before the trip
+            // does not immediately re-trip the probe via checkThresholds().
+            consecutiveErrors = 0;
+            logger.info({ name }, `[session-cb:${name}] HALF-OPEN probe`);
+        }
+        // In half-open state we allow the probe through without re-checking
+        // accumulated metrics (tokens, actions, cost) — only recordError() during
+        // the probe can re-trip. Threshold re-check only applies to closed state.
+        if (state !== "half-open") {
+            const violation = checkThresholds();
+            if (violation !== null) {
+                doTrip(violation);
+                return {
+                    proceed: false,
+                    reason: `session-cb:${name} tripped: ${violation}`,
+                };
+            }
+        }
+        return { proceed: true };
+    }
+    return {
+        name: `session-cb:${name}`,
+        check,
+        recordTokens(count, costUsd) {
+            tokenCount += count;
+            if (costUsd !== undefined)
+                estimatedCostUsd += costUsd;
+            if (state === "closed") {
+                const v = checkThresholds();
+                if (v)
+                    doTrip(v);
+            }
+        },
+        recordError() {
+            consecutiveErrors += 1;
+            if (state === "half-open") {
+                doTrip(`probe failed (errors=${consecutiveErrors})`);
+                return;
+            }
+            if (state === "closed") {
+                const v = checkThresholds();
+                if (v)
+                    doTrip(v);
+            }
+        },
+        recordSuccess() {
+            // NOTE: does NOT re-check thresholds — token/action/cost counters are
+            // not reset by success; only consecutiveErrors is cleared.
+            if (state === "half-open") {
+                state = "closed";
+                consecutiveErrors = 0;
+                tripReason = undefined;
+                openedAt = undefined;
+                logger.info({ name }, `[session-cb:${name}] CLOSED (probe success)`);
+                logToBrain(brain, {
+                    content: `Session CB '${name}' recovered to CLOSED after probe success.`,
+                    content_type: "event",
+                    author: `session-cb:${name}`,
+                    category: "development",
+                    tags: ["circuit-breaker", "session", name, "recovered"],
+                    confidence: 0.9,
+                });
+            }
+            else {
+                consecutiveErrors = 0;
+            }
+        },
+        recordAction() {
+            actionCount += 1;
+            if (state === "closed") {
+                const v = checkThresholds();
+                if (v)
+                    doTrip(v);
+            }
+        },
+        reset() {
+            state = "closed";
+            tokenCount = 0;
+            consecutiveErrors = 0;
+            actionCount = 0;
+            estimatedCostUsd = 0;
+            tripReason = undefined;
+            openedAt = undefined;
+        },
+        snapshot: snap,
+    };
+}
+//# sourceMappingURL=session-cb.js.map

package/dist/patterns/circuit-breaker/session-cb.js.map

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

package/dist/patterns/circuit-breaker/types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Pattern A: Session-Level Circuit Breaker — types.
+ *
+ * DISTINCT from `resilience/circuit-breaker.ts` which wraps async functions.
+ * This pattern tracks SESSION METRICS (tokens, errors, actions, cost, time)
+ * and integrates as a RiskGuard for the OODA cycle.
+ *
+ * State machine: closed → open (threshold breach) → half-open (after
+ * resetAfterMs) → closed (probe success via recordSuccess()).
+ *
+ * IMPORTANT: record* methods must be called manually from phase functions.
+ * The OODA loop does NOT auto-feed these metrics.
+ *
+ * @public
+ */
+import type { RiskGuard } from "../../orchestration/ooda/types.js";
+import type { BrainPort } from "../../ports/brain.js";
+import type { LoggerPort } from "../../ports/logger.js";
+export type CircuitState = "closed" | "open" | "half-open";
+export interface CircuitSnapshot {
+    readonly state: CircuitState;
+    readonly tokenCount: number;
+    readonly consecutiveErrors: number;
+    readonly actionCount: number;
+    readonly elapsedMs: number;
+    readonly estimatedCostUsd: number;
+    readonly tripReason?: string;
+    readonly openedAt?: number;
+}
+export interface CircuitBreakerThresholds {
+    /** Max cumulative tokens before trip. Default: 50_000 */
+    readonly maxTokens?: number;
+    /** Max consecutive errors before trip. Default: 5 */
+    readonly maxConsecutiveErrors?: number;
+    /** Max action count per session. Default: 200 */
+    readonly maxActionCount?: number;
+    /** Max session elapsed ms. Default: 3_600_000 (1h) */
+    readonly maxElapsedMs?: number;
+    /** Max estimated cost USD. Default: 10.0 */
+    readonly maxCostUsd?: number;
+}
+export interface CircuitBreakerConfig {
+    readonly name: string;
+    readonly thresholds?: CircuitBreakerThresholds;
+    /** Time to stay OPEN before half-open probe. Default: 60_000 ms */
+    readonly resetAfterMs?: number;
+    readonly brain?: BrainPort;
+    readonly logger?: LoggerPort;
+    /** Called synchronously when circuit trips. Must not throw. */
+    readonly onTrip?: (snapshot: CircuitSnapshot) => void;
+    /** Injectable clock for tests. Default: Date.now */
+    readonly _now?: () => number;
+}
+/**
+ * Session-level circuit breaker. Implements RiskGuard + metric recording.
+ *
+ * Add to OODAAgentConfig.riskGuards. Phase functions call record* methods.
+ */
+export interface SessionCircuitBreaker extends RiskGuard {
+    recordTokens(count: number, costUsd?: number): void;
+    recordError(): void;
+    /** Record a successful action. Resets consecutiveErrors. Closes half-open probe. */
+    recordSuccess(): void;
+    recordAction(): void;
+    reset(): void;
+    snapshot(): CircuitSnapshot;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/patterns/circuit-breaker/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/patterns/circuit-breaker/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,yDAAyD;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,iDAAiD;IACjD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,sDAAsD;IACtD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,4CAA4C;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,wBAAwB,CAAC;IAC/C,mEAAmE;IACnE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;IACtD,oDAAoD;IACpD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,SAAS;IACtD,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpD,WAAW,IAAI,IAAI,CAAC;IACpB,oFAAoF;IACpF,aAAa,IAAI,IAAI,CAAC;IACtB,YAAY,IAAI,IAAI,CAAC;IACrB,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,IAAI,eAAe,CAAC;CAC7B"}

package/dist/patterns/circuit-breaker/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/patterns/circuit-breaker/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/patterns/circuit-breaker/types.ts"],"names":[],"mappings":""}

package/dist/patterns/escalation/index.d.ts

@@ -0,0 +1,3 @@
+export { createEscalationPyramid } from "./pyramid.js";
+export type { EscalationPyramid, EscalationPyramidConfig, EscalationLevel, ActionDeclaration, EscalationDecision, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/patterns/escalation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/patterns/escalation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/patterns/escalation/index.js

@@ -0,0 +1,2 @@
+export { createEscalationPyramid } from "./pyramid.js";
+//# sourceMappingURL=index.js.map

package/dist/patterns/escalation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/patterns/escalation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC"}

package/dist/patterns/escalation/pyramid.d.ts

@@ -0,0 +1,3 @@
+import type { EscalationPyramid, EscalationPyramidConfig } from "./types.js";
+export declare function createEscalationPyramid(config: EscalationPyramidConfig): EscalationPyramid;
+//# sourceMappingURL=pyramid.d.ts.map

package/dist/patterns/escalation/pyramid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pyramid.d.ts","sourceRoot":"","sources":["../../../src/patterns/escalation/pyramid.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAGV,iBAAiB,EACjB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAYpB,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,uBAAuB,GAC9B,iBAAiB,CAoGnB"}