@wrongstack/core 0.275.0 → 0.276.2

package/dist/{context-BrLe8pJy.d.ts → context-CLnUMW5g.d.ts}

@@ -196,6 +196,7 @@ declare const ERROR_CODES: {
     readonly SDD_INVALID_STATE: "SDD_INVALID_STATE";
     readonly SDD_NOT_READY: "SDD_NOT_READY";
     readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    readonly PARSE_FAILED: "PARSE_FAILED";
     readonly UNKNOWN: "UNKNOWN";
 };
 /**
@@ -370,6 +371,34 @@ declare class ToolValidationError extends WrongStackError {
         cause?: unknown | undefined;
     });
 }
+/**
+ * Response / payload parse error — thrown when an upstream HTTP response,
+ * file, or data structure is well-formed at the transport layer (HTTP 200,
+ * valid JSON) but is missing required fields or has an unexpected shape.
+ *
+ * Distinct from `ConfigError(CONFIG_PARSE_FAILED)` (which is specifically
+ * for config-file parsing) and `FetchError` (which covers HTTP non-OK
+ * responses). `ParseError` fills the gap: the request succeeded but the
+ * response body couldn't be interpreted.
+ *
+ * Common sites: OAuth token responses missing `access_token`, device-code
+ * responses missing `device_code`, registry responses with unexpected
+ * schemas.
+ */
+declare class ParseError extends WrongStackError {
+    readonly source?: string | undefined;
+    constructor(opts: {
+        message: string;
+        /**
+         * What was being parsed — e.g. `'oauth-token-response'`,
+         * `'device-code-response'`. Lets consumers distinguish parse failures
+         * from different upstream APIs without parsing the message.
+         */
+        source?: string | undefined;
+        context?: Record<string, unknown> | undefined;
+        cause?: unknown | undefined;
+    });
+}
 declare function isWrongStackError(err: unknown): err is WrongStackError;
 declare function isToolError(err: unknown): err is ToolError;
 declare function isConfigError(err: unknown): err is ConfigError;
@@ -379,6 +408,7 @@ declare function isAgentError(err: unknown): err is AgentError;
 declare function isFsError(err: unknown): err is FsError;
 declare function isToolValidationError(err: unknown): err is ToolValidationError;
 declare function isFetchError(err: unknown): err is FetchError;
+declare function isParseError(err: unknown): err is ParseError;
 declare function isSddError(err: unknown): err is SddError;
 
 type Permission = 'auto' | 'confirm' | 'deny';
@@ -1001,7 +1031,7 @@ interface SessionMetadata {
  *   hard crashes; `DefaultSessionStore.load()` silently skips bad lines.
  *
  * ## Location (source of truth: resolveWstackPaths)
- * ~/.wrongstack/projects/<sha256(projectRoot).slice(0,12)>/sessions/<id>.jsonl
+ * ~/.wrongstack/projects/<sha256(projectRoot).slice(0,12)>/sessions/<date>/sess_<ULID>.jsonl
  *
  * The only files that live inside the project tree are the committed
  * `.wrongstack/AGENTS.md` and `.wrongstack/skills/`.
@@ -1525,6 +1555,8 @@ interface CacheStats {
 }
 interface TokenCounter {
     account(usage: Usage, model?: string): void | undefined;
+    /** Optional live session binding used by token.accounted events. */
+    setSessionId?(sessionId: string | (() => string | undefined) | undefined): void;
     /**
      * Tokens from the most recently-accounted request (input + cacheRead).
      * Use this for per-request context pressure tracking (e.g. status bar
@@ -1536,6 +1568,12 @@ interface TokenCounter {
         input: number;
         cacheRead: number;
     };
+    /**
+     * Override the last-request token snapshot. Used by slash commands like
+     * /compact that modify ctx.messages without making an API request —
+     * after calling this, the TUI/REPL context bar reflects the new size.
+     */
+    setCurrentRequestTokens(input: number, cacheRead?: number): void;
     total(): Usage;
     estimateCost(): {
         input: number;
@@ -1917,4 +1955,4 @@ declare class Context implements RunEnv {
     usage(): Usage;
 }
 
-export { type RequestCacheControl as $, AgentError as A, type ContextEvidenceState as B, Context as C, type ContextFileEvidence as D, type ContextInit as E, type ContextIntentEvidence as F, type ContextRepeatedReadEvidence as G, ERROR_CODES as H, type ErrorCode as I, type JSONSchema as J, type ErrorSeverity as K, type ErrorSubsystem as L, type Message as M, FetchError as N, type FileSnapshot as O, type Provider as P, FsError as Q, type ReasoningRequest as R, type SessionEvent as S, type Tool as T, type Usage as U, type ImageBlock as V, type JsonSchemaSpec as W, type MessageRole as X, PluginError as Y, type ProviderErrorBody as Z, type ReadonlyConversationState as _, type ReasoningConfig as a, type ResponseFormat as a0, type RiskTier as a1, type RunEnv as a2, type SafetySetting as a3, SddError as a4, SessionError as a5, type SideEffect as a6, type SideEffectRisk as a7, type StateChange as a8, type StateChangeHandler as a9, isThinkingBlock as aA, isToolError as aB, isToolResultBlock as aC, isToolUseBlock as aD, isToolValidationError as aE, isWrongStackError as aF, toWrongStackError as aG, wrapAsState as aH, type StopReason as aa, type StreamEvent as ab, StreamHangError as ac, type ThinkingBlock as ad, type ToolCallContext as ae, ToolError as af, ToolErrorCategory as ag, type ToolErrorInfo as ah, type ToolEvidenceStatus as ai, type ToolFinalEvent as aj, type ToolIconId as ak, type ToolStreamEvent as al, ToolValidationError as am, WrongStackError as an, asBlocks as ao, asText as ap, extractRunEnv as aq, isAgentError as ar, isConfigError as as, isFetchError as at, isFsError as au, isImageBlock as av, isPluginError as aw, isSddError as ax, isSessionError as ay, isTextBlock as az, type SessionWriter as b, type Request as c, type Response as d, type TokenCounter as e, type CacheStats as f, ProviderError as g, type Permission as h, type ContentBlock as i, type SessionMetadata as j, type SessionStore as k, type ToolProgressEvent as l, type ToolOutputMetadata as m, type Capabilities as n, type ReasoningEffort as o, type CacheTtl as p, type TextBlock as q, type ToolUseBlock as r, type ToolResultBlock as s, type RunOptions as t, ConversationState as u, type ResumedSession as v, type SessionData as w, type SessionSummary as x, type TodoItem as y, ConfigError as z };
+export { type ProviderErrorBody as $, AgentError as A, ConfigError as B, Context as C, type ContextEvidenceState as D, type ContextFileEvidence as E, type ContextInit as F, type ContextIntentEvidence as G, type ContextRepeatedReadEvidence as H, ERROR_CODES as I, type JSONSchema as J, type ErrorCode as K, type ErrorSeverity as L, type Message as M, type ErrorSubsystem as N, FetchError as O, type Provider as P, type FileSnapshot as Q, type ReasoningRequest as R, type SessionEvent as S, type Tool as T, type Usage as U, FsError as V, type ImageBlock as W, type JsonSchemaSpec as X, type MessageRole as Y, ParseError as Z, PluginError as _, type ReasoningConfig as a, type ReadonlyConversationState as a0, type RequestCacheControl as a1, type ResponseFormat as a2, type RiskTier as a3, type RunEnv as a4, type SafetySetting as a5, SddError as a6, SessionError as a7, type SideEffect as a8, type SideEffectRisk as a9, isSessionError as aA, isTextBlock as aB, isThinkingBlock as aC, isToolError as aD, isToolResultBlock as aE, isToolUseBlock as aF, isToolValidationError as aG, isWrongStackError as aH, toWrongStackError as aI, wrapAsState as aJ, type StateChange as aa, type StateChangeHandler as ab, type StopReason as ac, type StreamEvent as ad, StreamHangError as ae, type ThinkingBlock as af, type ToolCallContext as ag, ToolError as ah, type ToolErrorInfo as ai, type ToolEvidenceStatus as aj, type ToolFinalEvent as ak, type ToolIconId as al, type ToolStreamEvent as am, ToolValidationError as an, WrongStackError as ao, asBlocks as ap, asText as aq, extractRunEnv as ar, isAgentError as as, isConfigError as at, isFetchError as au, isFsError as av, isImageBlock as aw, isParseError as ax, isPluginError as ay, isSddError as az, type SessionWriter as b, type Request as c, type Response as d, type TokenCounter as e, type CacheStats as f, ProviderError as g, type Permission as h, type ContentBlock as i, type SessionMetadata as j, type SessionStore as k, ToolErrorCategory as l, type ToolProgressEvent as m, type ToolOutputMetadata as n, type Capabilities as o, type ReasoningEffort as p, type CacheTtl as q, type TextBlock as r, type ToolUseBlock as s, type ToolResultBlock as t, type RunOptions as u, ConversationState as v, type ResumedSession as w, type SessionData as x, type SessionSummary as y, type TodoItem as z };

package/dist/coordination/index.d.ts

@@ -1,26 +1,26 @@
-import { E as EventBus, B as BrainArbiter, f as BrainDecisionOption, k as BrainRisk, h as BrainDecisionRequest, e as BrainDecision, i as BrainDecisionSource } from '../brain-DCkB5_e7.js';
-export { g as BrainDecisionQueue, j as BrainFallback, D as DefaultBrainArbiter, l as DefaultBrainArbiterOptions, H as HumanEscalatingBrainArbiter, O as ObservableBrainArbiter, w as formatHumanPrompt } from '../brain-DCkB5_e7.js';
-import { H as FleetManager, s as Director } from '../null-fleet-bus-BMZwMin7.js';
-export { A as ACP_AGENTS, a as AGENTS_BY_PHASE, b as AGENT_CATALOG, c as ALL_AGENT_DEFINITIONS, d as ALL_FLEET_AGENTS, e as AUDIT_LOG_AGENT, f as AutoExtendCeiling, g as AutoExtendPolicy, B as BUG_HUNTER_AGENT, h as BugFinding, C as CollabBudgetConfig, i as CollabBudgetOverrides, j as CollabBudgetWarningPayload, k as CollabDebugReport, l as CollabSession, m as CollabSessionOptions, n as CreateDelegateToolOptions, o as CriticConcern, p as CriticEvaluation, D as DEFAULT_DIRECTOR_PREAMBLE, q as DEFAULT_SUBAGENT_BASELINE, r as DelegateHost, t as DirectorAlert, u as DirectorAlertLevel, v as DirectorCancelCollabPayload, w as DirectorPromptParts, x as DirectorSessionFactory, y as DirectorSessionFactoryOptions, F as FLEET_ROSTER, z as FLEET_ROSTER_BUDGETS, E as FLEET_ROSTER_WITHACP, G as FleetCostCapError, I as FleetManagerOptions, J as FleetRosterBudget, K as FleetSpawnBudgetError, L as ICoordinator, M as IFleetManager, N as LargeAnswerStore, O as NULL_FLEET_BUS, R as REFACTOR_PLANNER_AGENT, P as RefactorPhase, Q as RefactorPlan, S as SECURITY_SCANNER_AGENT, T as SharedFileEntry, U as SharedFileSnapshot, V as SubagentPromptParts, W as applyRosterBudget, X as attachAutoExtend, Y as composeDirectorPrompt, Z as composeSubagentPrompt, _ as createDelegateTool, $ as getAgentDefinition, a0 as makeAskResultTool, a1 as makeAskTool, a2 as makeAssignTool, a3 as makeAwaitTasksTool, a4 as makeCollabDebugTool, a5 as makeDirectorSessionFactory, a6 as makeFleetEmitTool, a7 as makeFleetHealthTool, a8 as makeFleetSessionTool, a9 as makeFleetStatusTool, aa as makeFleetUsageTool, ab as makeRollUpTool, ac as makeSpawnTool, ad as makeTerminateTool, ae as makeWorkCompleteTool, af as rosterSummaryFromConfigs } from '../null-fleet-bus-BMZwMin7.js';
-import { b as AgentDefinition } from '../multi-agent-coordinator-Dc_HuG9p.js';
-export { T as AGENT_TOOL_PRESETS, c as AgentBudgetTier, d as AgentCapability, A as AgentPhase, e as DEFAULT_DISPATCH_ROLE, a as DefaultMultiAgentCoordinator, f as DispatchCandidate, D as DispatchClassifier, g as DispatchMethod, h as DispatchOptions, i as DispatchResult, H as HEAVY_BUDGET, L as LIGHT_BUDGET, M as MEDIUM_BUDGET, j as MultiAgentCoordinatorOptions, k as dispatchAgent, m as makeLLMClassifier, s as scoreAgents } from '../multi-agent-coordinator-Dc_HuG9p.js';
-import { F as FleetBus } from '../agent-subagent-runner-CArSFKFl.js';
-export { h as AgentFactory, v as AgentFactoryResult, w as AgentRunnerOptions, x as BudgetExceededError, y as BudgetKind, z as BudgetLimits, E as BudgetNegotiationMode, G as BudgetThresholdDecision, H as BudgetThresholdHandler, I as BudgetThresholdSignal, J as BudgetUsage, L as DECISION_TIMEOUT_MS, N as FleetEvent, O as FleetHandler, i as FleetUsage, j as FleetUsageAggregator, Q as SubagentBudget, Y as SubagentUsageSnapshot, Z as TIMEOUT_PREEMPT_FRACTION, $ as makeAgentSubagentRunner, a0 as withDisabledToolFiltering } from '../agent-subagent-runner-CArSFKFl.js';
-export { I as InMemoryAgentBridge, a as InMemoryBridgeTransport, c as createMessage } from '../agent-bridge-D9JkPvJ0.js';
-import { b as Mailbox, c as MailboxSendInput, M as MailboxMessage, d as MailboxQuery, e as MailboxAckInput, f as MailboxAckBatchInput, a as MailboxAgentStatus, A as AgentRegistrationInput, g as AgentHeartbeatInput, P as PurgeOptions, j as PurgeResult, C as ClientRegistrationInput, h as ClientHeartbeatInput, i as ClientStatus } from '../mailbox-types-_7gaY0Rl.js';
-export { k as ClientSource, l as MailboxMessageType, m as MailboxTaskContext, R as ReadReceipts, n as RegisteredAgent, o as normalizeRecipient } from '../mailbox-types-_7gaY0Rl.js';
-import { G as GlobalMailbox } from '../global-mailbox-CXkugtNQ.js';
-export { aw as resolveProjectDir } from '../global-mailbox-CXkugtNQ.js';
-import { C as Context, T as Tool } from '../context-BrLe8pJy.js';
-import { A as AdaptiveConcurrencyConfig } from '../config-BzFRKkg7.js';
+import { E as EventBus, B as BrainArbiter, f as BrainDecisionOption, k as BrainRisk, h as BrainDecisionRequest, e as BrainDecision, i as BrainDecisionSource } from '../brain-BLOyN5ZP.js';
+export { g as BrainDecisionQueue, j as BrainFallback, D as DefaultBrainArbiter, l as DefaultBrainArbiterOptions, H as HumanEscalatingBrainArbiter, O as ObservableBrainArbiter, w as formatHumanPrompt } from '../brain-BLOyN5ZP.js';
+import { H as FleetManager, s as Director } from '../null-fleet-bus-d9G-bVy9.js';
+export { A as ACP_AGENTS, a as AGENTS_BY_PHASE, b as AGENT_CATALOG, c as ALL_AGENT_DEFINITIONS, d as ALL_FLEET_AGENTS, e as AUDIT_LOG_AGENT, f as AutoExtendCeiling, g as AutoExtendPolicy, B as BUG_HUNTER_AGENT, h as BugFinding, C as CollabBudgetConfig, i as CollabBudgetOverrides, j as CollabBudgetWarningPayload, k as CollabDebugReport, l as CollabSession, m as CollabSessionOptions, n as CreateDelegateToolOptions, o as CriticConcern, p as CriticEvaluation, D as DEFAULT_DIRECTOR_PREAMBLE, q as DEFAULT_SUBAGENT_BASELINE, r as DelegateHost, t as DirectorAlert, u as DirectorAlertLevel, v as DirectorCancelCollabPayload, w as DirectorPromptParts, x as DirectorSessionFactory, y as DirectorSessionFactoryOptions, F as FLEET_ROSTER, z as FLEET_ROSTER_BUDGETS, E as FLEET_ROSTER_WITHACP, G as FleetCostCapError, I as FleetManagerOptions, J as FleetRosterBudget, K as FleetSpawnBudgetError, L as ICoordinator, M as IFleetManager, N as LargeAnswerStore, O as NULL_FLEET_BUS, R as REFACTOR_PLANNER_AGENT, P as RefactorPhase, Q as RefactorPlan, S as SECURITY_SCANNER_AGENT, T as SharedFileEntry, U as SharedFileSnapshot, V as SubagentPromptParts, W as applyRosterBudget, X as attachAutoExtend, Y as composeDirectorPrompt, Z as composeSubagentPrompt, _ as createDelegateTool, $ as getAgentDefinition, a0 as makeAskResultTool, a1 as makeAskTool, a2 as makeAssignTool, a3 as makeAwaitTasksTool, a4 as makeCollabDebugTool, a5 as makeDirectorSessionFactory, a6 as makeFleetEmitTool, a7 as makeFleetHealthTool, a7 as makeFleetSessionTool, a7 as makeFleetStatusTool, a7 as makeFleetTool, a7 as makeFleetUsageTool, a8 as makeRollUpTool, a9 as makeSpawnTool, aa as makeTerminateAllTool, ab as makeTerminateTool, ac as makeWorkCompleteTool, ad as rosterSummaryFromConfigs } from '../null-fleet-bus-d9G-bVy9.js';
+import { b as AgentDefinition } from '../multi-agent-coordinator-CiRtKVTk.js';
+export { T as AGENT_TOOL_PRESETS, c as AgentBudgetTier, d as AgentCapability, A as AgentPhase, e as DEFAULT_DISPATCH_ROLE, a as DefaultMultiAgentCoordinator, f as DispatchCandidate, D as DispatchClassifier, g as DispatchMethod, h as DispatchOptions, i as DispatchResult, H as HEAVY_BUDGET, L as LIGHT_BUDGET, M as MEDIUM_BUDGET, j as MultiAgentCoordinatorOptions, k as dispatchAgent, m as makeLLMClassifier, s as scoreAgents } from '../multi-agent-coordinator-CiRtKVTk.js';
+import { F as FleetBus } from '../agent-subagent-runner-CEuw4ATz.js';
+export { i as AgentFactory, w as AgentFactoryResult, x as AgentRunnerOptions, y as BudgetExceededError, z as BudgetKind, E as BudgetLimits, G as BudgetNegotiationMode, H as BudgetThresholdDecision, I as BudgetThresholdHandler, J as BudgetThresholdSignal, K as BudgetUsage, N as DECISION_TIMEOUT_MS, O as FleetEvent, Q as FleetHandler, j as FleetUsage, k as FleetUsageAggregator, R as SubagentBudget, Z as SubagentUsageSnapshot, _ as TIMEOUT_PREEMPT_FRACTION, a0 as makeAgentSubagentRunner, a1 as withDisabledToolFiltering } from '../agent-subagent-runner-CEuw4ATz.js';
+export { I as InMemoryAgentBridge, a as InMemoryBridgeTransport, c as createMessage } from '../agent-bridge-D7A-eu3C.js';
+import { b as Mailbox, c as MailboxSendInput, M as MailboxMessage, d as MailboxQuery, e as MailboxAckInput, f as MailboxAckBatchInput, a as MailboxAgentStatus, A as AgentRegistrationInput, g as AgentHeartbeatInput, P as PurgeOptions, j as PurgeResult, C as ClientRegistrationInput, h as ClientHeartbeatInput, i as ClientStatus } from '../mailbox-types-DTl7bRH3.js';
+export { k as ClientSource, l as MailboxMessageType, m as MailboxTaskContext, R as ReadReceipts, n as RegisteredAgent, o as normalizeRecipient } from '../mailbox-types-DTl7bRH3.js';
+import { G as GlobalMailbox } from '../global-mailbox-Iqfkgmwu.js';
+export { aw as resolveProjectDir } from '../global-mailbox-Iqfkgmwu.js';
+import { C as Context, T as Tool } from '../context-CLnUMW5g.js';
+import { A as AdaptiveConcurrencyConfig } from '../config-Bf5mj-ad.js';
 import 'node:events';
 import '../logger-B63L5bTg.js';
 import '../director-state-BfeCUbmk.js';
-import '../index-CtlizLTK.js';
-import '../pipeline-BYR-Vdau.js';
+import '../index-Cn0NOshr.js';
+import '../pipeline-Dl6XbfE7.js';
 import '../observability-D-HZN_mF.js';
-import '../permission-CJR1qfOi.js';
-import '../retry-policy-BmY5ooh3.js';
+import '../permission-BCbQDR2s.js';
+import '../retry-policy-Dt3_z8Aj.js';
 
 /** Phase 1 · Discovery — map the territory before any work begins. */
 declare const DISCOVERY_AGENTS: AgentDefinition[];
@@ -153,6 +153,8 @@ interface BrainInterventionInput {
 interface BrainMonitorOptions {
     events: EventBus;
     brain: BrainArbiter;
+    /** Active host session id, read lazily so resume/new-session switches are reflected. */
+    sessionId?: (() => string | undefined) | undefined;
     /**
      * Deliver a corrective steer to the working agent(s). Hosts typically
      * send a `steer` mail to this session's leader via the project
@@ -499,7 +501,7 @@ interface MailboxToolOptions {
 }
 /**
  * Compact, deterministic tag for a session id — 8 hex chars of its sha256.
- * Session ids are date-sharded paths ("2026-06-11/10-48-34Z_model_e66c");
+ * Session ids are date-sharded paths ("2026-06-11/sess_<ULID>");
  * the tag keeps mailbox identities short, filesystem-safe, and stable for
  * the lifetime of the session (including across process restarts/resumes).
  */
@@ -532,10 +534,12 @@ declare function makeMailboxTool(opts?: MailboxToolOptions): Tool;
 /**
  * mail-tools — thin, high-affordance wrappers over the project mailbox.
  *
- * The multi-action `mailbox` tool is the power surface; these two exist
- * because explicit verbs ("send a mail", "read my inbox") are what makes
- * agents USE the mailbox autonomously — a model reaches for `mail_send`
- * mid-task far more readily than for `mailbox action=send ...`.
+ * These are the PREFERRED mailbox tools for agents. The multi-action `mailbox`
+ * tool is the low-level power surface for advanced queries and agent status;
+ * `mail_send` and `mail_inbox` exist because explicit verbs ("send a mail",
+ * "read my inbox") are what makes agents USE the mailbox autonomously — a model
+ * reaches for `mail_send` mid-task far more readily than for
+ * `mailbox action=send ...`.
  *
  *   mail_send  — message one agent (`to: "leader@a1b2c3d4"`), every leader
  *                (`to: "leader"`), or everyone (`to: "*"`)
@@ -1038,6 +1042,18 @@ declare class KnowledgeGraph {
     private readonly pendingDeliveries;
     private readonly filePath;
     private readonly graphFilePath;
+    /**
+     * Stable per-node insertion sequence. `nodes` (a Map) preserves insertion
+     * order even across `update()` (Map.set on an existing key keeps its slot),
+     * but the type index's `Set<string>` does NOT — `update()` removes then
+     * re-adds a node's id, moving it to the set's tail. Index-routed queries sort
+     * by this sequence so they return nodes in creation order, matching the old
+     * `nodes.values()` scan that callers like decision-history `slice(-10)` rely on.
+     */
+    private readonly seq;
+    private seqCounter;
+    /** Assign a stable insertion sequence the first time a node id is seen. */
+    private _trackSeq;
     /** Exposed for unit-testing only: read current index contents. */
     getIndex(): ReadonlyMap<string, ReadonlySet<string>>;
     constructor(sessionDir: string);
@@ -2054,6 +2070,8 @@ interface AgentVirtualSession {
     transcript: AgentTimelineEntry[];
 }
 interface AgentMonitorOptions {
+    /** Parent/host session id for emitted agent timeline/status events. */
+    sessionId?: string | undefined;
     /** The FleetBus to listen on for subagent events. Optional — set via `setFleetBus()` before `start()`. */
     fleetBus?: FleetBus | undefined;
     /** Local EventBus for emitting agent.timeline.* and agent.status_changed events. */
@@ -2070,6 +2088,7 @@ interface AgentMonitorOptions {
 declare class AgentMonitorService {
     private _fleetBus;
     private readonly _events;
+    private readonly _sessionId;
     private readonly _transcriptsDir;
     private readonly _maxEntries;
     private _streamEnabled;