@wrongstack/core 0.285.0 → 0.287.0

package/dist/execution/auto-compaction-middleware.d.ts

@@ -2,7 +2,7 @@ import type { Context } from '../core/context.js';
 import type { EventBus } from '../kernel/events.js';
 import type { MiddlewareHandler } from '../kernel/pipeline.js';
 import type { SessionEventBridge } from '../storage/session-event-bridge.js';
-import type { Compactor } from '../types/compactor.js';
+import type { CompactReport, Compactor } from '../types/compactor.js';
 import type { ContextWindowAggressiveOn, ContextWindowPolicy } from '../types/context-window.js';
 export interface ContextWindowBudgetSnapshot {
     maxContext: number;
@@ -22,6 +22,12 @@ export interface AutoCompactionOptions {
     policyProvider?: (ctx: Context) => Pick<ContextWindowPolicy, 'thresholds' | 'aggressiveOn'> | null | undefined;
     /** Optional bridge for writing compaction events into the persistent session log. */
     sessionBridge?: SessionEventBridge | undefined;
+    /**
+     * Optional callback fired after successful compaction with the report.
+     * Receives the CompactReport so callers can feed the collapsed digest
+     * to memory consolidation, logging, or other side effects.
+     */
+    onCompact?: ((report: CompactReport) => void) | undefined;
 }
 /**
  * Pipeline middleware that monitors context token load and automatically
@@ -53,6 +59,7 @@ export declare class AutoCompactionMiddleware {
     private readonly failureMode;
     private readonly policyProvider?;
     private readonly sessionBridge?;
+    private readonly onCompact?;
     /**
      * Once a compaction attempt reduces nothing (preserveK protects everything,
      * no oversized tool_results remain to elide), retrying on every iteration

package/dist/execution/auto-compaction-middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-compaction-middleware.d.ts","sourceRoot":"","sources":["../../src/execution/auto-compaction-middleware.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"auto-compaction-middleware.d.ts","sourceRoot":"","sources":["../../src/execution/auto-compaction-middleware.ts"],"names":[],"mappings":"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"}

package/dist/execution/autonomous-runner.d.ts

@@ -1,5 +1,6 @@
 import type { Agent, RunResult } from '../core/agent.js';
 import type { Context } from '../core/context.js';
+import type { Logger } from '../types/logger.js';
 import type { DoneCondition } from '../types/multi-agent.js';
 type AutonomousResult = RunResult & {
     toolCalls: number;
@@ -14,7 +15,10 @@ export interface DoneCheckResult {
 export declare class DoneConditionChecker {
     private readonly condition;
     private readonly compiledRegex;
-    constructor(condition: DoneCondition);
+    private readonly logger;
+    constructor(condition: DoneCondition, opts?: {
+        logger?: Logger | undefined;
+    });
     check(state: {
         iterations: number;
         toolCalls: number;
@@ -38,6 +42,8 @@ export interface AutonomousRunnerOptions {
      * re-invocation needed). The runner still provides iteration/timeouts.
      */
     enableAutonomousContinue?: boolean | undefined;
+    /** Logger for structured warnings. Falls back to console.warn when omitted. */
+    logger?: Logger | undefined;
 }
 export declare class AutonomousRunner {
     private readonly opts;

package/dist/execution/autonomous-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"autonomous-runner.d.ts","sourceRoot":"","sources":["../../src/execution/autonomous-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAI7D,KAAK,gBAAgB,GAAG,SAAS,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEvF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,oBAAoB;IAGnB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAFtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAE9C,YAA6B,SAAS,EAAE,aAAa,EAiBpD;IAED,KAAK,CAAC,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,eAAe,CA0DxG;CACF;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,aAAa,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACpF,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IAC5D;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChD;AAED,qBAAa,gBAAgB;IAOf,OAAO,CAAC,QAAQ,CAAC,IAAI;IANjC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAC,CAAqB;IACxC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;IAEnD,YAA6B,IAAI,EAAE,uBAAuB,EAEzD;IAEK,GAAG,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAgCrC;YAEa,OAAO;IA6GrB,IAAI,IAAI,IAAI,CAEX;CACF"}
+{"version":3,"file":"autonomous-runner.d.ts","sourceRoot":"","sources":["../../src/execution/autonomous-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAI7D,KAAK,gBAAgB,GAAG,SAAS,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEvF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,oBAAoB;IAK7B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ5B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C,YACmB,SAAS,EAAE,aAAa,EACzC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,EA0BvC;IAED,KAAK,CAAC,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,eAAe,CA0DxG;CACF;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,aAAa,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACpF,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;IAC5D;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/C,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,qBAAa,gBAAgB;IAOf,OAAO,CAAC,QAAQ,CAAC,IAAI;IANjC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAC,CAAqB;IACxC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;IAEnD,YAA6B,IAAI,EAAE,uBAAuB,EAEzD;IAEK,GAAG,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAgCrC;YAEa,OAAO;IA6GrB,IAAI,IAAI,IAAI,CAEX;CACF"}

package/dist/execution/autonomy-brain.d.ts

@@ -28,11 +28,27 @@
  */
 import type { Provider } from '../types/provider.js';
 import type { BrainArbiter, BrainDecision, BrainDecisionRequest } from '../coordination/brain.js';
-export interface AutonomyBrainOptions {
-    /** LLM provider for decision-making. */
+/** One (provider, model) pair the Brain may call for a decision. */
+export interface BrainLlmTarget {
     provider: Provider;
-    /** Model to use for decisions (should be fast + cheap). */
     model: string;
+    /** Display label for logs/status (e.g. "anthropic/claude-haiku"). */
+    label?: string | undefined;
+}
+export interface AutonomyBrainOptions {
+    /** LLM provider for decision-making. Ignored when `targets` is non-empty. */
+    provider?: Provider | undefined;
+    /** Model to use for decisions (should be fast + cheap). Ignored when `targets` is non-empty. */
+    model?: string | undefined;
+    /**
+     * Ordered LLM pool. With `strategy: 'fallback'` (default) the first target
+     * is primary and later ones are tried in order when a call fails/times
+     * out; with 'round-robin' successive decisions rotate the starting target.
+     * At least one of `targets` / (`provider` + `model`) must be provided.
+     */
+    targets?: BrainLlmTarget[] | undefined;
+    /** Pool selection strategy. Default 'fallback'. */
+    strategy?: 'fallback' | 'round-robin' | undefined;
     /** Maximum risk level the brain will auto-decide. Default: 'high'.
      *  'low'    — only auto-decide low-risk questions
      *  'medium' — auto-decide low/medium
@@ -42,6 +58,12 @@ export interface AutonomyBrainOptions {
     maxAutoRisk?: 'low' | 'medium' | 'high' | 'all' | undefined;
     /** Timeout for each decision call (ms). Default: 15_000. */
     decisionTimeoutMs?: number | undefined;
+    /**
+     * Decision-history digest for the LLM prompt (typically
+     * `BrainDecisionLedger.digestFor`): how similar past decisions went and
+     * how they turned out. Appended to the user message when non-empty.
+     */
+    getDecisionDigest?: ((request: BrainDecisionRequest) => string | undefined) | undefined;
     /**
      * Called after every decision with a human-readable summary.
      * Use this to log decisions into chat history, journal, or status line.
@@ -64,18 +86,38 @@ export interface TieredBrainArbiterOptions {
      * entirely (everything the policy can't answer goes to the human).
      */
     getMaxAutoRisk?: (() => BrainAutoRisk) | undefined;
+    /**
+     * Multi-LLM council (createCouncilBrainArbiter). When present, requests at
+     * or above the council risk floor are decided by the council INSTEAD of
+     * the single-LLM layer. Council answers AND denies are terminal — a panel
+     * that considered the question and refused is a real decision, not a
+     * failure. Only `ask_human` (quorum not met / judge unavailable) falls
+     * through to the escalation tier.
+     */
+    council?: BrainArbiter | undefined;
+    /** Live council risk floor. Default 'high'. Read on every decision. */
+    getCouncilMinRisk?: (() => 'medium' | 'high' | 'critical') | undefined;
 }
 /**
- * The standard Brain positioning: policy first, LLM second, human last.
+ * The standard Brain positioning: policy first, LLM/council second,
+ * escalation last.
  *
  *   1. POLICY  — deterministic DefaultBrainArbiter (low-risk fast path,
- *      fallback semantics). Answers and denies pass through untouched.
- *   2. LLM     — when the policy says `ask_human` and the request's risk is
- *      within the live ceiling, the autonomous brain gets a chance to
- *      answer. Only a real `answer` short-circuits; LLM denials/failures
- *      fall through.
- *   3. HUMAN   — anything left escalates (callers wrap this in
- *      HumanEscalatingBrainArbiter so `ask_human` becomes a real prompt).
+ *      fallback semantics). Denies and option-backed answers pass through
+ *      untouched. A fallback-produced `continue` answer (no optionId, the
+ *      request declared `fallback: 'continue'`) is only PROVISIONAL: it
+ *      means "nobody could decide", not "this is the right call", so the
+ *      LLM tier still gets consulted within the ceiling. Historically it
+ *      short-circuited here, which meant e.g. goal-completion checks never
+ *      reached the LLM at all.
+ *   2. COUNCIL — requests at/above the council floor (default 'high') are
+ *      decided by the multi-LLM council when one is wired.
+ *   3. LLM     — everything else within the live ceiling goes to the
+ *      single-LLM autonomous brain. Only a real `answer` short-circuits;
+ *      denials/failures fall through.
+ *   4. ESCALATION — anything left escalates. Callers wrap this in
+ *      `EscalationRoutingBrainArbiter` (interactive prompt or headless
+ *      terminal policy) or the legacy `HumanEscalatingBrainArbiter`.
  */
 export declare function createTieredBrainArbiter(opts: TieredBrainArbiterOptions): BrainArbiter;
 /**
@@ -87,4 +129,23 @@ export declare function createAutonomyBrain(opts: AutonomyBrainOptions): BrainAr
  * Format a decision as a human-readable one-liner for chat history.
  */
 export declare function formatDecisionSummary(decision: BrainDecision, request: BrainDecisionRequest): string;
+/**
+ * Render a decision request as the user message for a Brain LLM call.
+ * Shared by the single-LLM tier and every council voter so all of them see
+ * the same question/context/options shape.
+ */
+export declare function buildBrainUserMessage(request: BrainDecisionRequest): string;
+/** Append a decision-history digest to a Brain user message (shared shape). */
+export declare function withDecisionDigest(user: string, digest: string | undefined): string;
+/**
+ * One Brain LLM call against a single target. Throws on transport failure,
+ * timeout, or abort — callers own the pool/fallback semantics.
+ */
+export declare function completeBrainLlm(target: BrainLlmTarget, input: {
+    system: string;
+    user: string;
+    timeoutMs: number;
+    maxTokens?: number | undefined;
+}): Promise<string>;
+export declare function parseOptionDecision(rawText: string, options: NonNullable<BrainDecisionRequest['options']>): BrainDecision | null;
 //# sourceMappingURL=autonomy-brain.d.ts.map

package/dist/execution/autonomy-brain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"autonomy-brain.d.ts","sourceRoot":"","sources":["../../src/execution/autonomy-brain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAIlG,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,QAAQ,EAAE,QAAQ,CAAC;IACnB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,WAAW,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;IAC5D,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC9G;AASD,gEAAgE;AAChE,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;AAEtE,MAAM,WAAW,yBAAyB;IACxC,8EAA8E;IAC9E,MAAM,EAAE,YAAY,CAAC;IACrB;;mCAE+B;IAC/B,UAAU,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACtC;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,aAAa,CAAC,GAAG,SAAS,CAAC;CACpD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,yBAAyB,GAAG,YAAY,CAmBtF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,YAAY,CAkC5E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CAmBR"}
+{"version":3,"file":"autonomy-brain.d.ts","sourceRoot":"","sources":["../../src/execution/autonomy-brain.ts"],"names":[],"mappings":"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"}

package/dist/execution/brain-chain.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Brain tier assembly — turns `Config.brain` into the concrete LLM tiers
+ * (single-LLM pool + optional multi-LLM council) that
+ * `createTieredBrainArbiter` composes. Shared by every host that wires a
+ * Brain (CLI/TUI in `wiring/brain-and-orchestration.ts`, the standalone
+ * WebUI server in `backend-services.ts`) so the config surface behaves
+ * identically everywhere.
+ *
+ * Hosts differ only in HOW a provider id becomes a `Provider` instance, so
+ * that is the one injected dependency (`resolveProvider`). Unresolvable
+ * pool/council entries are skipped — one bad ref never takes the Brain down.
+ *
+ * @module brain-chain
+ */
+import type { BrainArbiter, BrainDecisionRequest } from '../coordination/brain.js';
+import type { BrainConfig } from '../types/config.js';
+import type { Provider } from '../types/provider.js';
+export interface BrainTierAssemblyOptions {
+    /** `config.brain` — undefined assembles the legacy session-model single tier. */
+    brainConfig: BrainConfig | undefined;
+    /** The session's provider id (`config.provider`). */
+    defaultProviderId: string;
+    /** Live session provider — read per decision so `/setmodel` switches apply. */
+    sessionProvider: () => Provider;
+    /** Live session model id — read per decision. */
+    sessionModel: () => string;
+    /**
+     * Resolve a NON-default provider id to a Provider instance. May throw or
+     * return null; the entry is then skipped.
+     */
+    resolveProvider: (providerId: string, model: string) => Provider | null;
+    /**
+     * Decision-history digest (typically `BrainDecisionLedger.digestFor`) —
+     * injected into both the single-LLM and council prompts so the Brain
+     * learns from the outcomes of its past similar decisions.
+     */
+    getDecisionDigest?: ((request: BrainDecisionRequest) => string | undefined) | undefined;
+}
+export interface BrainTierAssembly {
+    /** Single-LLM tier for `TieredBrainArbiterOptions.autonomous`. */
+    autonomous: BrainArbiter;
+    /** Council tier for `TieredBrainArbiterOptions.council` (undefined = disabled). */
+    council: BrainArbiter | undefined;
+    /** Live council risk floor for `TieredBrainArbiterOptions.getCouncilMinRisk`. */
+    getCouncilMinRisk: () => 'medium' | 'high' | 'critical';
+    /** Human-readable pool labels for status surfaces; empty = session model. */
+    poolLabels: string[];
+    /** Human-readable council seat labels; empty = council disabled. */
+    councilLabels: string[];
+}
+/** Assemble the LLM tiers of the Brain chain from `Config.brain`. */
+export declare function assembleBrainTiers(opts: BrainTierAssemblyOptions): BrainTierAssembly;
+//# sourceMappingURL=brain-chain.d.ts.map

package/dist/execution/brain-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-chain.d.ts","sourceRoot":"","sources":["../../src/execution/brain-chain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEnF,OAAO,KAAK,EAAE,WAAW,EAAmB,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAWrD,MAAM,WAAW,wBAAwB;IACvC,iFAAiF;IACjF,WAAW,EAAE,WAAW,GAAG,SAAS,CAAC;IACrC,qDAAqD;IACrD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,+EAA+E;IAC/E,eAAe,EAAE,MAAM,QAAQ,CAAC;IAChC,iDAAiD;IACjD,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B;;;OAGG;IACH,eAAe,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,QAAQ,GAAG,IAAI,CAAC;IACxE;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,oBAAoB,KAAK,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;CACzF;AAED,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,UAAU,EAAE,YAAY,CAAC;IACzB,mFAAmF;IACnF,OAAO,EAAE,YAAY,GAAG,SAAS,CAAC;IAClC,iFAAiF;IACjF,iBAAiB,EAAE,MAAM,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACxD,6EAA6E;IAC7E,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,oEAAoE;IACpE,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,wBAAwB,GAAG,iBAAiB,CAqGpF"}

package/dist/execution/brain-evaluation.d.ts

@@ -0,0 +1,66 @@
+import type { BrainArbiter, BrainDecision, BrainDecisionRequest } from '../coordination/brain.js';
+export declare const BRAIN_EVALUATION_CASE_VERSION: 1;
+export interface BrainEvaluationExpectations {
+    /** Restrict the accepted decision variants for this case. */
+    allowedDecisionTypes?: BrainDecision['type'][] | undefined;
+    /** Exact option ids that may be selected. Every id must exist in the request. */
+    allowedOptionIds?: string[] | undefined;
+    /** Options that represent an unsafe allowance and must fail the case. */
+    unsafeOptionIds?: string[] | undefined;
+    /** Require an answer to carry an exact option id. */
+    requireOptionId?: boolean | undefined;
+    /** Whether ask_human is acceptable rather than an unnecessary escalation. */
+    allowEscalation?: boolean | undefined;
+}
+/** Versioned, JSON-serializable fixture for side-effect-free Brain evaluation. */
+export interface BrainEvaluationCaseV1 {
+    version: typeof BRAIN_EVALUATION_CASE_VERSION;
+    id: string;
+    description?: string | undefined;
+    request: BrainDecisionRequest;
+    expectations?: BrainEvaluationExpectations | undefined;
+}
+export type BrainEvaluationFailureCode = 'invalid_fixture' | 'arbiter_error' | 'unexpected_decision_type' | 'invalid_option_id' | 'missing_option_id' | 'disallowed_option_id' | 'unsafe_option_id' | 'unexpected_escalation';
+export interface BrainEvaluationFailure {
+    code: BrainEvaluationFailureCode;
+    message: string;
+}
+export interface BrainEvaluationCaseResult {
+    caseId: string;
+    passed: boolean;
+    decision?: BrainDecision | undefined;
+    failures: BrainEvaluationFailure[];
+    latencyMs: number;
+}
+export interface BrainEvaluationMetrics {
+    totalCases: number;
+    passedCases: number;
+    failedCases: number;
+    optionDecisionCount: number;
+    invalidOptionCount: number;
+    validOptionRate: number;
+    unsafeAllowanceCount: number;
+    unnecessaryEscalationCount: number;
+    averageLatencyMs: number;
+}
+export interface BrainEvaluationReport {
+    version: typeof BRAIN_EVALUATION_CASE_VERSION;
+    results: BrainEvaluationCaseResult[];
+    metrics: BrainEvaluationMetrics;
+}
+export type BrainEvaluationCaseValidation = {
+    ok: true;
+    value: BrainEvaluationCaseV1;
+} | {
+    ok: false;
+    diagnostics: string[];
+};
+/** Validate a fixture loaded from JSON before any arbiter is invoked. */
+export declare function validateBrainEvaluationCase(value: unknown): BrainEvaluationCaseValidation;
+/**
+ * Replay evaluation fixtures through a Brain arbiter without applying the
+ * returned decisions. The runner has no dispatch, terminate, permission, or
+ * tool-execution callback, so a result can only be measured and reported.
+ */
+export declare function runBrainEvaluation(arbiter: BrainArbiter, cases: readonly unknown[]): Promise<BrainEvaluationReport>;
+//# sourceMappingURL=brain-evaluation.d.ts.map

package/dist/execution/brain-evaluation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-evaluation.d.ts","sourceRoot":"","sources":["../../src/execution/brain-evaluation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAElG,eAAO,MAAM,6BAA6B,EAAG,CAAU,CAAC;AAExD,MAAM,WAAW,2BAA2B;IAC1C,6DAA6D;IAC7D,oBAAoB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,GAAG,SAAS,CAAC;IAC3D,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACxC,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACvC,qDAAqD;IACrD,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,6EAA6E;IAC7E,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACvC;AAED,kFAAkF;AAClF,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,6BAA6B,CAAC;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,YAAY,CAAC,EAAE,2BAA2B,GAAG,SAAS,CAAC;CACxD;AAED,MAAM,MAAM,0BAA0B,GAClC,iBAAiB,GACjB,eAAe,GACf,0BAA0B,GAC1B,mBAAmB,GACnB,mBAAmB,GACnB,sBAAsB,GACtB,kBAAkB,GAClB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,0BAA0B,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACrC,QAAQ,EAAE,sBAAsB,EAAE,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,0BAA0B,EAAE,MAAM,CAAC;IACnC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,6BAA6B,CAAC;IAC9C,OAAO,EAAE,yBAAyB,EAAE,CAAC;IACrC,OAAO,EAAE,sBAAsB,CAAC;CACjC;AAED,MAAM,MAAM,6BAA6B,GACrC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,qBAAqB,CAAA;CAAE,GAC1C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAUzC,yEAAyE;AACzE,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,6BAA6B,CAsGzF;AA4DD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,SAAS,OAAO,EAAE,GACxB,OAAO,CAAC,qBAAqB,CAAC,CA0FhC"}

package/dist/execution/brain-runtime.d.ts

@@ -0,0 +1,171 @@
+/**
+ * BrainRuntime — the live, rebuildable owner of `config.brain`.
+ *
+ * The Brain chain used to be assembled once at boot; every knob except the
+ * risk ceiling and escalation mode was frozen until restart. This module
+ * makes the whole `BrainConfig` surface live-editable AND persistable from
+ * any host surface (/brain subcommands, TUI Brain panel, WebUI BrainSection):
+ *
+ *   - `arbiter` is a STABLE delegating handle (`decide` reads a mutable
+ *     `current`), so hosts wrap it once in their EscalationRouting/Observable
+ *     layers and no consumer ever needs a rebind after a settings change.
+ *   - `apply(patch)` normalizes + validates the patch, commits it, rebuilds
+ *     the tier chain when a structural knob changed (pool, council, timeout,
+ *     ledger guard), and persists through an injected callback — core never
+ *     touches config files itself.
+ *   - `getSnapshot()` is the JSON-safe truth both UIs render: configured
+ *     values plus derived facts (resolved pool/council labels, EFFECTIVE
+ *     council enablement, session-model fallback).
+ *
+ * Persistence contract: `config.brain` is on the in-project deny list, so
+ * the injected `persist` MUST write the GLOBAL config. A persist failure
+ * never rolls back the live change; it is reported via the returned promise.
+ *
+ * @module brain-runtime
+ */
+import { type BrainArbiter, type BrainDecisionRequest, type BrainEscalationMode } from '../coordination/brain.js';
+import type { BrainConfig, BrainCouncilVoterConfig, BrainModelEntry } from '../types/config.js';
+import type { Provider } from '../types/provider.js';
+import { type BrainAutoRisk } from './autonomy-brain.js';
+export type BrainCouncilMinRisk = 'medium' | 'high' | 'critical';
+export type BrainPoolStrategy = 'fallback' | 'round-robin';
+/** JSON-safe view of the live Brain configuration + derived facts. */
+export interface BrainConfigSnapshot {
+    mode: BrainEscalationMode;
+    maxAutoRisk: BrainAutoRisk;
+    /** Configured pool entries (normalized). Empty = session model. */
+    models: BrainModelEntry[];
+    strategy: BrainPoolStrategy;
+    decisionTimeoutMs: number | undefined;
+    humanTimeoutMs: number | undefined;
+    council: {
+        /** EFFECTIVE enablement (default rule `voters >= 2` applied). */
+        enabled: boolean;
+        /** Raw configured value (undefined = default rule decides). */
+        configured: boolean | undefined;
+        minRisk: BrainCouncilMinRisk;
+        /** Explicitly configured voters; seats derived from the pool are visible via `councilLabels`. */
+        voters: BrainCouncilVoterConfig[];
+        quorum: number | undefined;
+        approval: number | undefined;
+        judge: BrainModelEntry | undefined;
+    };
+    ledger: {
+        enabled: boolean;
+        autoDenyAfterFailures: number | undefined;
+        path: string | undefined;
+    };
+    /** Resolved pool labels from the LAST assembly (may be fewer than `models` — unresolvable refs are skipped). */
+    poolLabels: string[];
+    /** Resolved council seat labels; empty = council effectively disabled. */
+    councilLabels: string[];
+    usingSessionModel: boolean;
+}
+/** Council sub-patch. Arrays REPLACE; `null` clears back to the default. */
+export interface BrainCouncilPatch {
+    enabled?: boolean | null | undefined;
+    minRisk?: BrainCouncilMinRisk | null | undefined;
+    voters?: Array<string | BrainCouncilVoterConfig> | null | undefined;
+    quorum?: number | null | undefined;
+    approval?: number | null | undefined;
+    judge?: string | BrainModelEntry | null | undefined;
+}
+/**
+ * Partial update for the live Brain config. Omitted fields are untouched,
+ * `null` clears a field back to its default, arrays replace wholesale.
+ */
+export interface BrainConfigPatch {
+    mode?: BrainEscalationMode | undefined;
+    maxAutoRisk?: BrainAutoRisk | undefined;
+    models?: Array<string | BrainModelEntry> | null | undefined;
+    strategy?: BrainPoolStrategy | null | undefined;
+    decisionTimeoutMs?: number | null | undefined;
+    humanTimeoutMs?: number | null | undefined;
+    council?: BrainCouncilPatch | null | undefined;
+    ledger?: {
+        enabled?: boolean | undefined;
+        autoDenyAfterFailures?: number | null | undefined;
+    } | null | undefined;
+}
+/** Host-owned ledger controller — the runtime never touches ledger files. */
+export interface BrainRuntimeLedgerHost {
+    getPath: () => string | undefined;
+    isEnabled: () => boolean;
+    /** Host starts/stops its BrainDecisionLedger instance. */
+    setEnabled: (enabled: boolean) => void;
+    failureStreakFor?: ((request: Pick<BrainDecisionRequest, 'source' | 'question' | 'id'>) => number) | undefined;
+    getDecisionDigest?: ((request: BrainDecisionRequest) => string | undefined) | undefined;
+}
+export interface BrainRuntimeOptions {
+    /** Boot-time `config.brain`. Invalid entries are dropped leniently here (apply() is strict). */
+    initialConfig: BrainConfig | undefined;
+    /** The session's provider id (`config.provider`). */
+    defaultProviderId: string;
+    /** Live session provider — read per decision so `/setmodel` switches apply. */
+    sessionProvider: () => Provider;
+    /** Live session model id — read per decision. */
+    sessionModel: () => string;
+    /** Resolve a NON-default provider id. May throw / return null → entry skipped. */
+    resolveProvider: (providerId: string, model: string) => Provider | null;
+    ledger?: BrainRuntimeLedgerHost | undefined;
+    /**
+     * Injected writer for the canonical `BrainConfig`. MUST target the global
+     * config (`config.brain` is denied in project scope). Absent = live-only.
+     */
+    persist?: ((config: BrainConfig) => Promise<void>) | undefined;
+    /** Fired after every successful apply, with the fresh snapshot. */
+    onApplied?: ((snapshot: BrainConfigSnapshot) => void) | undefined;
+}
+export interface BrainApplyResult {
+    snapshot: BrainConfigSnapshot;
+    /** Resolves `{ok: true}` immediately when persistence was skipped or absent. */
+    persisted: Promise<{
+        ok: boolean;
+        error?: string | undefined;
+    }>;
+}
+export interface BrainRuntime {
+    /** STABLE arbiter handle — the inner tier chain swaps on `apply`. */
+    arbiter: BrainArbiter;
+    getMode(): BrainEscalationMode;
+    getMaxAutoRisk(): BrainAutoRisk;
+    getHumanTimeoutMs(): number | undefined;
+    getSnapshot(): BrainConfigSnapshot;
+    /** Canonical shape written to `config.brain` (compact string refs where lossless). */
+    getConfig(): BrainConfig;
+    /** Live-apply synchronously; persistence (default on) is async best-effort. */
+    apply(patch: BrainConfigPatch, opts?: {
+        persist?: boolean | undefined;
+    }): BrainApplyResult;
+}
+export interface BrainDefaultsContext {
+    /** The session's fallback chain (`config.fallbackModels`) — seeds the default pool. */
+    fallbackModels?: readonly string[] | undefined;
+}
+/**
+ * Product defaults for hosts that want a minimum-human Brain out of the box
+ * (CLI/TUI wiring and the standalone WebUI server both apply this before
+ * `createBrainRuntime`). Only FILLS GAPS — every explicitly configured field
+ * wins, so existing `config.brain` blocks are untouched by updates.
+ *
+ *   - `models`  → the user's own `fallbackModels` chain (never hardcoded
+ *     model ids; every install has different providers). With ≥2 entries the
+ *     council auto-derives from the pool, so multi-model users get a council
+ *     by default.
+ *   - `mode`    → 'headless': decisions never block on a human; the terminal
+ *     policy (safe default / deny) is the escalation of last resort.
+ *   - `maxAutoRisk` → adaptive: 'all' when a council can convene (critical
+ *     questions get a multi-model panel), otherwise 'high' (critical
+ *     questions resolve via the conservative terminal policy instead of a
+ *     single unchecked model).
+ *   - `humanTimeoutMs` → 120s: if the user explicitly switches back to
+ *     'interactive', an unanswered prompt still auto-resolves instead of
+ *     hanging an unattended run forever. Set `humanTimeoutMs: 0` to restore
+ *     the legacy wait-indefinitely behavior.
+ *
+ * NOTE deliberately NOT persisted anywhere — resolved at boot, so existing
+ * users pick these up on update without any config migration/write.
+ */
+export declare function resolveBrainConfigDefaults(brain: BrainConfig | undefined, ctx?: BrainDefaultsContext): BrainConfig;
+export declare function createBrainRuntime(opts: BrainRuntimeOptions): BrainRuntime;
+//# sourceMappingURL=brain-runtime.d.ts.map

package/dist/execution/brain-runtime.d.ts.map

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

package/dist/execution/compaction-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compaction-core.d.ts","sourceRoot":"","sources":["../../src/execution/compaction-core.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EACL,qBAAqB,EAGtB,MAAM,4BAA4B,CAAC;AAkHpC;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,8BAAwB,CAAC;AAEtD;;;;;;;;;;;GAWG;AAEH,kDAAkD;AAClD,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAGlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CA8CzF;AAiCD,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAClD,WAAW,CAsIb;AAkED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAoBxE;AAID,2EAA2E;AAC3E,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAMjD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAM9C;AAED,oDAAoD;AACpD,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAG9C;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,SAAO,GAAG,OAAO,CAUxE;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,CAAC,EAAE,OAAO,EACV,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAChD,YAAY,CA6Dd;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAuDrE;AAiCD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAS/F;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAczF"}
+{"version":3,"file":"compaction-core.d.ts","sourceRoot":"","sources":["../../src/execution/compaction-core.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EACL,qBAAqB,EAGtB,MAAM,4BAA4B,CAAC;AAkHpC;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,8BAAwB,CAAC;AAEtD;;;;;;;;;;;GAWG;AAEH,kDAAkD;AAClD,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAGlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CA8CzF;AAiCD,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAClD,WAAW,CA4Ib;AAkED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAoBxE;AAID,2EAA2E;AAC3E,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAMjD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAM9C;AAED,oDAAoD;AACpD,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAG9C;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,SAAO,GAAG,OAAO,CAUxE;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,CAAC,EAAE,OAAO,EACV,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAChD,YAAY,CA6Dd;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAuDrE;AAiCD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAS/F;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAczF"}

package/dist/execution/council-brain.d.ts

@@ -0,0 +1,79 @@
+/**
+ * CouncilBrainArbiter — a multi-LLM decision panel for high-stakes questions.
+ *
+ * Instead of trusting one model's single completion, the council convenes N
+ * independent voters (ideally different models/providers), each with a
+ * distinct decision persona:
+ *
+ *   - executor — biased toward forward progress; hates stalling.
+ *   - skeptic  — hunts for the reason the proposed action is wrong; may veto.
+ *   - auditor  — cost/waste/budget lens; hates throwing tokens at dead ends.
+ *
+ * Votes are cast INDEPENDENTLY (no voter sees another's rationale), then
+ * tallied with weights. Resolution ladder:
+ *
+ *   1. QUORUM  — fewer than `quorumFraction` of seats returned a valid vote
+ *      → the council abstains (`ask_human`), letting the escalation tier
+ *      (human prompt or headless terminal policy) resolve it.
+ *   2. VETO    — a veto seat explicitly refusing denies the request outright.
+ *   3. MAJORITY — the option with the highest total weight wins when it
+ *      exceeds `approvalFraction` of all cast weight.
+ *   4. JUDGE   — ties / weak pluralities go to a judge model that sees every
+ *      vote's rationale and issues the final structured decision. No judge
+ *      (or judge failure) → abstain (`ask_human`).
+ *
+ * Optionless (free-text) requests skip the tally: every voter writes an
+ * independent stance and the judge synthesizes the final answer; without a
+ * judge, the first valid stance wins.
+ *
+ * The council NEVER blocks on a human itself — its worst case is an
+ * `ask_human` abstention that the outer escalation tier resolves.
+ *
+ * @module council-brain
+ */
+import type { BrainArbiter, BrainDecision, BrainDecisionRequest } from '../coordination/brain.js';
+import { type BrainLlmTarget } from './autonomy-brain.js';
+/** One voting seat on the council. */
+export interface CouncilVoter extends BrainLlmTarget {
+    /**
+     * Decision lens. Built-ins: 'executor', 'skeptic', 'auditor'. Any other
+     * string is injected verbatim as the persona description.
+     */
+    persona?: string | undefined;
+    /** Vote weight in the tally. Default 1. */
+    weight?: number | undefined;
+    /** When true, this seat's explicit refusal denies the request outright. */
+    veto?: boolean | undefined;
+}
+export interface CouncilBrainOptions {
+    voters: CouncilVoter[];
+    /** Tie-breaker / synthesizer. Default: none (ties abstain to escalation). */
+    judge?: BrainLlmTarget | undefined;
+    /** Fraction of seats that must return a valid vote. Default 0.5. */
+    quorumFraction?: number | undefined;
+    /** Fraction of cast weight the winning option must EXCEED. Default 0.5. */
+    approvalFraction?: number | undefined;
+    /** Per-voter (and judge) completion timeout in ms. Default 15000. */
+    decisionTimeoutMs?: number | undefined;
+    /**
+     * Decision-history digest (typically `BrainDecisionLedger.digestFor`) —
+     * appended to every voter's user message so the panel sees how similar
+     * past decisions turned out.
+     */
+    getDecisionDigest?: ((request: BrainDecisionRequest) => string | undefined) | undefined;
+    /** Called with a human-readable summary after every council decision. */
+    onDecision?: ((summary: string, decision: BrainDecision, request: BrainDecisionRequest) => void) | undefined;
+}
+/**
+ * Synthetic ballot entry that lets any voter refuse every real option. Kept
+ * deliberately awkward so it can never collide with a caller option id; if
+ * it somehow does, the synthetic entry is skipped for that request.
+ */
+export declare const COUNCIL_REFUSE_OPTION_ID = "council_refuse";
+/**
+ * Create a council-of-LLMs Brain arbiter. See the module docs for the
+ * resolution ladder. Positioned by `createTieredBrainArbiter` above the
+ * single-LLM tier for requests at/above the council risk floor.
+ */
+export declare function createCouncilBrainArbiter(opts: CouncilBrainOptions): BrainArbiter;
+//# sourceMappingURL=council-brain.d.ts.map

package/dist/execution/council-brain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"council-brain.d.ts","sourceRoot":"","sources":["../../src/execution/council-brain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EAEb,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,KAAK,cAAc,EAMpB,MAAM,qBAAqB,CAAC;AAE7B,sCAAsC;AACtC,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,2EAA2E;IAC3E,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACnC,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,oBAAoB,KAAK,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;IACxF,yEAAyE;IACzE,UAAU,CAAC,EACP,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAC,GACnF,SAAS,CAAC;CACf;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AAkDzD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,mBAAmB,GAAG,YAAY,CAiPjF"}