@wrongstack/core 0.277.1 → 0.280.0

package/dist/{brain-CCfuEOdp.d.ts → events-Bs2fmldo.d.ts}

@@ -1,4 +1,109 @@
-import { U as Usage, C as Context, l as ToolErrorCategory, m as ToolProgressEvent, T as Tool, n as ToolOutputMetadata } from './context-DPlA6kid.js';
+import { U as Usage, C as Context, l as ToolErrorCategory, m as ToolProgressEvent, T as Tool, n as RiskTier, o as ToolOutputMetadata } from './tool-BkOgs_KL.js';
+import { a as PermissionDecision } from './permission-Dx6dIqS2.js';
+
+/**
+ * Brain coordination primitives.
+ *
+ * Brain is an authority layer above a leader/director but below the human. It is
+ * intentionally modeled as a decision interface first, not as an autonomous
+ * bypass: callers ask for a decision, Brain either answers within policy or
+ * escalates to the human.
+ */
+
+type BrainDecisionSource = 'autophase' | 'director' | 'tool' | 'user' | 'system';
+type BrainRisk = 'low' | 'medium' | 'high' | 'critical';
+type BrainFallback = 'ask_human' | 'deny' | 'continue';
+interface BrainDecisionOption {
+    id: string;
+    label: string;
+    consequence?: string | undefined;
+    risk?: BrainRisk | undefined;
+    recommended?: boolean | undefined;
+}
+interface BrainDecisionRequest {
+    id: string;
+    /** Active host session id for surfaces that multiplex multiple sessions. */
+    sessionId?: string | undefined;
+    source: BrainDecisionSource;
+    question: string;
+    context?: string | undefined;
+    options?: BrainDecisionOption[] | undefined;
+    risk: BrainRisk;
+    /** What a non-LLM/default Brain should do when policy cannot decide safely. */
+    fallback: BrainFallback;
+}
+type BrainDecision = {
+    type: 'answer';
+    optionId?: string | undefined;
+    text: string;
+    rationale?: string | undefined;
+} | {
+    type: 'ask_human';
+    prompt: string;
+    options?: BrainDecisionOption[] | undefined;
+    rationale?: string | undefined;
+} | {
+    type: 'deny';
+    reason: string;
+};
+interface BrainArbiter {
+    decide(request: BrainDecisionRequest): Promise<BrainDecision>;
+}
+/**
+ * Event-emitting decorator for any Brain implementation. Hosts wire this around
+ * their actual arbiter so TUI/session surfaces can render Brain decisions
+ * without coupling to the caller that requested the decision.
+ */
+declare class ObservableBrainArbiter implements BrainArbiter {
+    private readonly inner;
+    private readonly events;
+    constructor(inner: BrainArbiter, events: EventBus);
+    decide(request: BrainDecisionRequest): Promise<BrainDecision>;
+}
+interface BrainDecisionQueueOptions {
+    /** Safety fallback if the human never answers. Default: no timeout. */
+    timeoutMs?: number | undefined;
+}
+/**
+ * Bridge between an `ask_human` Brain decision and the UI. It emits the visible
+ * ask-human event, then resolves when the TUI emits `brain.human_answered`.
+ */
+declare class BrainDecisionQueue {
+    private readonly events;
+    private readonly opts;
+    private readonly pending;
+    private readonly offAnswer;
+    constructor(events: EventBus, opts?: BrainDecisionQueueOptions);
+    requestHumanDecision(request: BrainDecisionRequest): Promise<BrainDecision>;
+    dispose(): void;
+}
+/**
+ * Decorator that turns `ask_human` into an actual awaited human decision.
+ * The wrapped Brain remains policy-only; this layer owns the UI/event bridge.
+ */
+declare class HumanEscalatingBrainArbiter implements BrainArbiter {
+    private readonly inner;
+    private readonly queue;
+    constructor(inner: BrainArbiter, queue: BrainDecisionQueue);
+    decide(request: BrainDecisionRequest): Promise<BrainDecision>;
+}
+interface DefaultBrainArbiterOptions {
+    /** Allow deterministic auto-answering for low-risk requests. Default true. */
+    allowLowRiskAutoAnswer?: boolean | undefined;
+}
+/**
+ * Conservative deterministic Brain implementation.
+ *
+ * It only auto-answers low-risk requests when the caller provided a recommended
+ * option. Everything else follows the request fallback. This gives hosts a safe
+ * policy object to wire before an LLM-backed Brain exists.
+ */
+declare class DefaultBrainArbiter implements BrainArbiter {
+    private readonly allowLowRiskAutoAnswer;
+    constructor(opts?: DefaultBrainArbiterOptions);
+    decide(request: BrainDecisionRequest): Promise<BrainDecision>;
+}
+declare function formatHumanPrompt(request: BrainDecisionRequest): string;
 
 type MemoryScope = 'project-agents' | 'project-memory' | 'user-memory';
 type MemoryType = 'fact' | 'decision' | 'convention' | 'preference' | 'reference' | 'anti_pattern';
@@ -236,6 +341,7 @@ interface EventMap {
     'provider.response': {
         sessionId?: string | undefined;
         ctx: Context;
+        model: string;
         usage: Usage;
         stopReason: string;
     };
@@ -385,6 +491,8 @@ interface EventMap {
         input: unknown;
         toolUseId: string;
         suggestedPattern: string;
+        decisionSource?: PermissionDecision['source'] | undefined;
+        riskTier?: RiskTier | undefined;
         resolve: (decision: 'yes' | 'no' | 'always' | 'deny') => void;
     };
     /**
@@ -540,8 +648,8 @@ interface EventMap {
         agentName: string;
         /** The assistant text block content, or a tool-call summary. */
         content: string;
-        /** 'text' | 'tool_use' | 'error' | 'status' */
-        kind: 'text' | 'tool_use' | 'error' | 'status';
+        /** Timeline entry kind. */
+        kind: 'text' | 'thinking' | 'tool_use' | 'tool_result' | 'error' | 'status' | 'system';
         /** Iteration index within the subagent's own run. */
         iteration: number;
         /** ISO 8601 timestamp. */
@@ -1159,9 +1267,9 @@ interface EventMap {
     'storage.read': {
         sessionId: string;
         /** Which store was read. */
-        store: 'session' | 'goal' | 'plan' | 'project' | 'todos' | 'queue' | 'tasks' | 'memory' | 'annotations' | 'audit' | 'replay' | 'config';
+        store: 'session' | 'goal' | 'plan' | 'project' | 'todos' | 'queue' | 'tasks' | 'completed-work' | 'memory' | 'annotations' | 'audit' | 'replay' | 'config';
         filePath: string;
-        /** Session store: load|list|summary|index_read. Goal store: load. Plan store: load. Memory store: readAll. Annotations: list. Audit: verify|load. Replay: load|lookup. Config: read_json|load_sync. */
+        /** Session store: load|list|summary|index_read. Goal store: load. Plan store: load. Memory store: readAll. Annotations: list. Audit: verify|load. Replay: load|lookup. Config: read_json|load_sync. Completed-work: load. */
         operation: string;
         outcome: 'success' | 'failure';
         durationMs: number;
@@ -1174,12 +1282,13 @@ interface EventMap {
      */
     'storage.write': {
         sessionId: string;
-        store: 'session' | 'goal' | 'plan' | 'project' | 'todos' | 'queue' | 'tasks' | 'memory' | 'annotations' | 'audit' | 'replay' | 'config';
+        store: 'session' | 'goal' | 'plan' | 'project' | 'todos' | 'queue' | 'tasks' | 'completed-work' | 'memory' | 'annotations' | 'audit' | 'replay' | 'config';
         filePath: string;
         /** Session store: create|resume|append|flush|close|index_append|compact|checkpoint.
          * Goal store: save|update|delete. Plan store: save. Project manifest: manifest_write.
          * Todos: save. Queue: write|clear. Tasks: save. Memory: remember|forget|clear|consolidate.
-         * Annotations: add|resolve|evict. Audit: record. Replay: record|compact. Config: persist_sync. */
+         * Annotations: add|resolve|evict. Audit: record. Replay: record|compact. Config: persist_sync.
+         * Completed-work: save. */
         operation: string;
         outcome: 'success' | 'failure';
         durationMs: number;
@@ -1193,7 +1302,7 @@ interface EventMap {
      */
     'storage.error': {
         sessionId: string;
-        store: 'session' | 'goal' | 'plan' | 'project' | 'todos' | 'queue' | 'tasks' | 'memory' | 'annotations' | 'audit' | 'replay' | 'config';
+        store: 'session' | 'goal' | 'plan' | 'project' | 'todos' | 'queue' | 'tasks' | 'completed-work' | 'memory' | 'annotations' | 'audit' | 'replay' | 'config';
         filePath: string;
         operation: string;
         outcome?: 'failure';
@@ -1380,108 +1489,4 @@ declare class ScopedEventBus extends EventBus {
     get scopedListenerCount(): number;
 }
 
-/**
- * Brain coordination primitives.
- *
- * Brain is an authority layer above a leader/director but below the human. It is
- * intentionally modeled as a decision interface first, not as an autonomous
- * bypass: callers ask for a decision, Brain either answers within policy or
- * escalates to the human.
- */
-
-type BrainDecisionSource = 'autophase' | 'director' | 'tool' | 'user' | 'system';
-type BrainRisk = 'low' | 'medium' | 'high' | 'critical';
-type BrainFallback = 'ask_human' | 'deny' | 'continue';
-interface BrainDecisionOption {
-    id: string;
-    label: string;
-    consequence?: string | undefined;
-    risk?: BrainRisk | undefined;
-    recommended?: boolean | undefined;
-}
-interface BrainDecisionRequest {
-    id: string;
-    /** Active host session id for surfaces that multiplex multiple sessions. */
-    sessionId?: string | undefined;
-    source: BrainDecisionSource;
-    question: string;
-    context?: string | undefined;
-    options?: BrainDecisionOption[] | undefined;
-    risk: BrainRisk;
-    /** What a non-LLM/default Brain should do when policy cannot decide safely. */
-    fallback: BrainFallback;
-}
-type BrainDecision = {
-    type: 'answer';
-    optionId?: string | undefined;
-    text: string;
-    rationale?: string | undefined;
-} | {
-    type: 'ask_human';
-    prompt: string;
-    options?: BrainDecisionOption[] | undefined;
-    rationale?: string | undefined;
-} | {
-    type: 'deny';
-    reason: string;
-};
-interface BrainArbiter {
-    decide(request: BrainDecisionRequest): Promise<BrainDecision>;
-}
-/**
- * Event-emitting decorator for any Brain implementation. Hosts wire this around
- * their actual arbiter so TUI/session surfaces can render Brain decisions
- * without coupling to the caller that requested the decision.
- */
-declare class ObservableBrainArbiter implements BrainArbiter {
-    private readonly inner;
-    private readonly events;
-    constructor(inner: BrainArbiter, events: EventBus);
-    decide(request: BrainDecisionRequest): Promise<BrainDecision>;
-}
-interface BrainDecisionQueueOptions {
-    /** Safety fallback if the human never answers. Default: no timeout. */
-    timeoutMs?: number | undefined;
-}
-/**
- * Bridge between an `ask_human` Brain decision and the UI. It emits the visible
- * ask-human event, then resolves when the TUI emits `brain.human_answered`.
- */
-declare class BrainDecisionQueue {
-    private readonly events;
-    private readonly opts;
-    private readonly pending;
-    private readonly offAnswer;
-    constructor(events: EventBus, opts?: BrainDecisionQueueOptions);
-    requestHumanDecision(request: BrainDecisionRequest): Promise<BrainDecision>;
-    dispose(): void;
-}
-/**
- * Decorator that turns `ask_human` into an actual awaited human decision.
- * The wrapped Brain remains policy-only; this layer owns the UI/event bridge.
- */
-declare class HumanEscalatingBrainArbiter implements BrainArbiter {
-    private readonly inner;
-    private readonly queue;
-    constructor(inner: BrainArbiter, queue: BrainDecisionQueue);
-    decide(request: BrainDecisionRequest): Promise<BrainDecision>;
-}
-interface DefaultBrainArbiterOptions {
-    /** Allow deterministic auto-answering for low-risk requests. Default true. */
-    allowLowRiskAutoAnswer?: boolean | undefined;
-}
-/**
- * Conservative deterministic Brain implementation.
- *
- * It only auto-answers low-risk requests when the caller provided a recommended
- * option. Everything else follows the request fallback. This gives hosts a safe
- * policy object to wire before an LLM-backed Brain exists.
- */
-declare class DefaultBrainArbiter implements BrainArbiter {
-    private readonly allowLowRiskAutoAnswer;
-    constructor(opts?: DefaultBrainArbiterOptions);
-    decide(request: BrainDecisionRequest): Promise<BrainDecision>;
-}
-declare function formatHumanPrompt(request: BrainDecisionRequest): string;
-
 export { type BrainArbiter as B, DefaultBrainArbiter as D, EventBus as E, HumanEscalatingBrainArbiter as H, type Listener as L, type MemoryScope as M, ObservableBrainArbiter as O, type ScoredEntry as S, type TrackedAgentSnapshot as T, type EventName as a, type MemoryEntry as b, type MemoryStore as c, type MemoryRelevanceContext as d, type BrainDecision as e, type BrainDecisionOption as f, BrainDecisionQueue as g, type BrainDecisionRequest as h, type BrainDecisionSource as i, type BrainFallback as j, type BrainRisk as k, type DefaultBrainArbiterOptions as l, type EventLogger as m, type EventMap as n, MEMORY_TYPE_LABELS as o, type MemoryClearedPayload as p, type MemoryConsolidatedPayload as q, type MemoryForgottenPayload as r, type MemoryPriority as s, type MemoryRememberedPayload as t, type MemoryType as u, ScopedEventBus as v, formatHumanPrompt as w };

package/dist/execution/index.d.ts

@@ -1,24 +1,25 @@
-export { A as AutoCompactionMiddleware, a as AutonomousRunner, b as AutonomousRunnerOptions, c as AutonomyPromptContributorOptions, C as CompactorStrategy, U as ContextWindowBudgetSnapshot, D as DefaultDesignKitLoader, d as DefaultPromptLoader, e as DefaultSkillLoader, f as DesignKitLoaderOptions, h as DoneCheckResult, i as DoneConditionChecker, I as IntelligentCompactor, j as IntelligentCompactorOptions, P as PersistedActiveKit, k as PromptLoaderOptions, S as SelectiveCompactor, l as SelectiveCompactorOptions, m as SkillLoaderOptions, n as StrategyCompactorOptions, _ as _resetDesignKitLoaderMemo, o as _resetDesignRulesCache, p as activateDesign, r as buildGoalPreamble, s as clearActiveKit, t as clearPersistedActiveKit, u as createStrategyCompactor, v as designProjectDir, w as detectFrontendFile, x as detectFrontendIntent, y as getDesignKitLoader, z as getDesignState, B as installDesignStudioMiddleware, E as loadActiveKit, F as loadProjectDesignRules, G as makeAutonomyPromptContributor, H as makeDesignDetectToolCallMiddleware, J as makeDesignDetectUserInputMiddleware, K as makeDesignStudioRequestMiddleware, M as recordKitChoice, O as renderPrompt, Q as resolveBundledDesignKitsDir, R as setActiveKit } from '../strategy-compactor-Bt_ZH6R0.js';
-import { P as Provider, a as ReasoningConfig, o as Capabilities, c as Request } from '../context-DPlA6kid.js';
-import { e as BrainDecision, h as BrainDecisionRequest, B as BrainArbiter } from '../brain-CCfuEOdp.js';
-export { C as CompactorOptions, h as DefaultErrorHandler, i as DefaultRetryPolicy, E as EternalAutonomyEngine, k as EternalAutonomyOptions, l as EternalEngineState, H as HybridCompactor, I as IterationStage, P as ParallelEngineState, m as ParallelEternalEngine, n as ParallelEternalOptions, o as ParallelIterationStage, T as ToolExecutor } from '../tool-executor-SVFq7IOR.js';
-import { N as ModelRuntimeConfig } from '../config-DAOjriz9.js';
-import '../pipeline-CEjBjzVA.js';
-import '../mailbox-types-DTl7bRH3.js';
-import '../session-event-bridge-DG94B3Bk.js';
-import '../compactor-D3BGw26y.js';
-import '../agent-subagent-runner-BimKihiC.js';
-import '../index-DJXj-dcr.js';
+export { A as AutoCompactionMiddleware, a as AutonomousRunner, b as AutonomousRunnerOptions, c as AutonomyPromptContributorOptions, C as CompactorStrategy, U as ContextWindowBudgetSnapshot, D as DefaultDesignKitLoader, d as DefaultPromptLoader, e as DefaultSkillLoader, f as DesignKitLoaderOptions, h as DoneCheckResult, i as DoneConditionChecker, I as IntelligentCompactor, j as IntelligentCompactorOptions, P as PersistedActiveKit, k as PromptLoaderOptions, S as SelectiveCompactor, l as SelectiveCompactorOptions, m as SkillLoaderOptions, n as StrategyCompactorOptions, _ as _resetDesignKitLoaderMemo, o as _resetDesignRulesCache, p as activateDesign, r as buildGoalPreamble, s as clearActiveKit, t as clearPersistedActiveKit, u as createStrategyCompactor, v as designProjectDir, w as detectFrontendFile, x as detectFrontendIntent, y as getDesignKitLoader, z as getDesignState, B as installDesignStudioMiddleware, E as loadActiveKit, F as loadProjectDesignRules, G as makeAutonomyPromptContributor, H as makeDesignDetectToolCallMiddleware, J as makeDesignDetectUserInputMiddleware, K as makeDesignStudioRequestMiddleware, M as recordKitChoice, O as renderPrompt, Q as resolveBundledDesignKitsDir, R as setActiveKit } from '../strategy-compactor-CQwhbErd.js';
+import { P as Provider, a as ReasoningConfig, r as Capabilities, c as Request } from '../tool-BkOgs_KL.js';
+import { e as BrainDecision, h as BrainDecisionRequest, B as BrainArbiter } from '../events-Bs2fmldo.js';
+export { C as CompactorOptions, h as DefaultErrorHandler, i as DefaultRetryPolicy, E as EternalAutonomyEngine, k as EternalAutonomyOptions, l as EternalEngineState, H as HybridCompactor, I as IterationStage, P as ParallelEngineState, m as ParallelEternalEngine, n as ParallelEternalOptions, o as ParallelIterationStage, T as ToolExecutor } from '../tool-executor-SiE1wlZo.js';
+import { h as ModelRuntimeConfig } from '../config-Cr3312zc.js';
+import '../pipeline-BwAP21_4.js';
+import '../mailbox-types-BGZWrYTJ.js';
+import '../session-event-bridge-CqdiGnfU.js';
+import '../compactor-U3agvUIG.js';
+import '../agent-subagent-runner-PoqNKiR4.js';
+import '../index-kidebiDh.js';
 import '../logger-B63L5bTg.js';
+import '../permission-Dx6dIqS2.js';
 import '../observability-D-HZN_mF.js';
-import '../permission-DbsGOA1C.js';
-import '../retry-policy-Git9WF6d.js';
-import '../selector-Cq72C0Oy.js';
-import '../skill-DGIXCtdv.js';
-import '../wstack-paths-_NrRovdr.js';
+import '../secret-scrubber-3MHDDAtm.js';
+import '../retry-policy-D4feSLk3.js';
+import '../selector-Dy-MzKp1.js';
+import '../skill-DHniprNl.js';
+import '../wstack-paths-CMl_cYgq.js';
 import '../prompt-DLd35n4Q.js';
-import '../goal-store-C1uH4srH.js';
-import '../multi-agent-coordinator-CcrcncvG.js';
+import '../goal-store-C4F6DjC0.js';
+import '../multi-agent-coordinator-CieyUoEL.js';
 import 'node:events';
 
 /**
@@ -132,6 +133,13 @@ interface ResolvedModelRuntime {
     /** Human-readable warnings for settings that were ignored for this model. */
     warnings: string[];
 }
+/**
+ * Overlay a scoped runtime override (for example a subagent role matrix entry)
+ * on top of the session-wide runtime settings. Nested objects merge so a role
+ * can set only `reasoning.effort` without losing the leader's cache TTL or
+ * other gated parameters.
+ */
+declare function mergeModelRuntime(base: ModelRuntimeConfig | undefined, override: ModelRuntimeConfig | undefined): ModelRuntimeConfig | undefined;
 /**
  * Resolve user-facing runtime settings into request fields for a specific
  * model capability profile. Pure function — safe to unit-test without a
@@ -170,4 +178,4 @@ interface ModelRuntimeMiddlewareOptions {
  */
 declare function applyModelRuntime(req: Request, opts: ModelRuntimeMiddlewareOptions): Request;
 
-export { type AutonomyBrainOptions, type BrainAutoRisk, type ModelRuntimeMiddlewareOptions, type ResolvedModelRuntime, type TieredBrainArbiterOptions, applyModelRuntime, createAutonomyBrain, createTieredBrainArbiter, formatDecisionSummary, resolveCacheForRequest, resolveModelRuntime, resolveReasoningForRequest };
+export { type AutonomyBrainOptions, type BrainAutoRisk, type ModelRuntimeMiddlewareOptions, type ResolvedModelRuntime, type TieredBrainArbiterOptions, applyModelRuntime, createAutonomyBrain, createTieredBrainArbiter, formatDecisionSummary, mergeModelRuntime, resolveCacheForRequest, resolveModelRuntime, resolveReasoningForRequest };