@wrongstack/core 0.6.7 → 0.7.2

package/dist/{index-BlVITqm-.d.ts → null-fleet-bus-DJMbqYhL.d.ts}

@@ -1,9 +1,33 @@
-import { a as DirectorStateSnapshot } from './director-state-BmYi3DGA.js';
-import { c as SubagentConfig, j as TaskResult, a as CoordinatorStatus, k as TaskSpec, M as MultiAgentConfig, i as SubagentRunner, b as MultiAgentCoordinator, S as SpawnResult, l as BridgeMessage, A as AgentBridge } from './multi-agent-Iy8YUe3v.js';
-import { r as SessionWriter, v as Tool, p as SessionStore } from './context-C8mBUzBv.js';
-import { I as InMemoryAgentBridge } from './agent-bridge-BCVxmrOn.js';
-import { F as FleetBus, e as FleetUsage, f as FleetUsageAggregator } from './agent-subagent-runner-BTloSwjE.js';
-import { EventEmitter } from 'node:events';
+import { e as AgentPhase, A as AgentDefinition, F as FleetBus, o as FleetUsage, p as FleetUsageAggregator } from './multi-agent-coordinator-DGUn-5Bb.js';
+import { c as SubagentConfig, j as TaskResult, a as CoordinatorStatus, k as TaskSpec, M as MultiAgentConfig, i as SubagentRunner } from './multi-agent-DenFfUv5.js';
+import { t as SessionWriter, x as Tool, r as SessionStore } from './context-BwxhvyW8.js';
+import { D as DirectorStateSnapshot } from './director-state-BUB7JRUr.js';
+import { I as InMemoryAgentBridge } from './agent-bridge-Bji75Iv9.js';
+import { E as EventBus } from './events-AjrvHJ9V.js';
+
+/**
+ * Agent catalog aggregator.
+ *
+ * Collects every phase's `AgentDefinition[]` into:
+ *   - `ALL_AGENT_DEFINITIONS` — flat list, catalog order (phase 1 → 9)
+ *   - `AGENT_CATALOG`         — keyed by role for O(1) lookup
+ *   - `AGENTS_BY_PHASE`       — grouped for statusline / dispatcher tie-breaks
+ *
+ * `fleet.ts` derives `FLEET_ROSTER` + `FLEET_ROSTER_BUDGETS` from this, and the
+ * dispatcher routes free-form tasks against `capability` metadata here.
+ */
+
+/** Every catalog agent, in phase order. */
+declare const ALL_AGENT_DEFINITIONS: AgentDefinition[];
+/** Phase → its agents, for grouped display and dispatcher fallbacks. */
+declare const AGENTS_BY_PHASE: Record<AgentPhase, AgentDefinition[]>;
+/**
+ * Role → definition. Built once at module load. Throws on a duplicate role so
+ * a copy-paste collision fails loudly at startup instead of silently shadowing.
+ */
+declare const AGENT_CATALOG: Record<string, AgentDefinition>;
+/** Role lookup helper. Returns undefined for unknown roles. */
+declare function getAgentDefinition(role: string): AgentDefinition | undefined;
 
 /**
  * Interface for a fleet coordinator. Implemented by both `Director`
@@ -70,6 +94,12 @@ interface ICoordinator {
      * no new tasks are dispatched.
      */
     terminateAll(): Promise<void>;
+    /**
+     * Stop a subagent and remove it from the coordinator. Releases all
+     * associated resources (AbortController, budget state). The subagent
+     * entry is deleted so the id can be reused in a future spawn.
+     */
+    remove(subagentId: string): Promise<void>;
     /**
      * Live coordinator status — subagent list, pending task count,
      * completed task count, iteration totals.
@@ -570,6 +600,9 @@ declare class Director implements ICoordinator {
     /** Snapshot of which subagent owns each task — drives state-checkpoint
      *  status updates without re-walking the manifest. */
     private readonly taskOwners;
+    /** Cumulative auto-extension grants per subagent (all budget kinds). Lets
+     *  /fleet render "⚡ extended ×N" without replaying the event stream. */
+    private readonly extendTotals;
     /**
      * Handle to the coordinator-side `task.completed` listener so we can
      * unsubscribe in `shutdown()`. Without this, repeated Director
@@ -579,6 +612,14 @@ declare class Director implements ICoordinator {
      */
     private taskCompletedListener;
     constructor(opts: DirectorOptions);
+    /**
+     * Record a granted budget extension and broadcast it on the FleetBus so
+     * the host can re-emit `subagent.budget_extended` for live UI badges.
+     * Called from both the timeout heartbeat path and the per-kind grant path.
+     */
+    private recordExtension;
+    /** Cumulative auto-extension count for one subagent (0 when never extended). */
+    extensionsFor(subagentId: string): number;
     /** Best-effort session-writer append. Swallows failures — the director
      *  must not break a fleet run because the session JSONL handle closed. */
     private appendSessionEvent;
@@ -665,6 +706,7 @@ declare class Director implements ICoordinator {
     awaitTasks(taskIds: string[]): Promise<TaskResult[]>;
     terminate(subagentId: string): Promise<void>;
     terminateAll(): Promise<void>;
+    remove(subagentId: string): Promise<void>;
     status(): CoordinatorStatus;
     /**
      * Subscribe to coordinator events. Currently only `task.completed` is
@@ -849,105 +891,6 @@ interface CreateDelegateToolOptions {
  */
 declare function createDelegateTool(opts: CreateDelegateToolOptions): Tool;
 
-interface MultiAgentCoordinatorOptions {
-    /**
-     * Callback that executes a task on behalf of a subagent. Required for
-     * `assign()` to actually run anything — without it, tasks queue forever.
-     * The coordinator provides per-subagent isolation (own budget, own signal,
-     * own bridge) and enforces timeout + concurrency.
-     */
-    runner?: SubagentRunner;
-}
-declare class DefaultMultiAgentCoordinator extends EventEmitter implements MultiAgentCoordinator {
-    readonly coordinatorId: string;
-    readonly config: MultiAgentConfig;
-    private runner?;
-    private readonly subagents;
-    private pendingTasks;
-    private completedResults;
-    private totalIterations;
-    private inFlight;
-    /**
-     * Subagents currently being stopped. Set on entry to `stop()`, cleared
-     * once `recordCompletion` lands the terminal TaskResult. Used by
-     * `runDispatched` and `findIdleSubagent` to refuse mid-flight dispatch
-     * to a subagent the caller has already asked to terminate — closes the
-     * assign+terminate race where a fresh task could land on a worker that
-     * was about to be killed.
-     */
-    private readonly terminating;
-    constructor(config: MultiAgentConfig, options?: MultiAgentCoordinatorOptions);
-    /**
-     * Replace the runner after construction. Used when the runner depends
-     * on infrastructure (e.g. FleetBus) that isn't available until after
-     * the coordinator's owning Director is built.
-     */
-    setRunner(runner: SubagentRunner): void;
-    /**
-     * Change the in-flight dispatch ceiling at runtime. Lowering does NOT
-     * preempt running tasks — already-dispatched subagents finish their
-     * current task; only future dispatches respect the new cap. Raising
-     * immediately tries to fill the freed slots from the pending queue.
-     */
-    setMaxConcurrent(n: number): void;
-    spawn(subagent: SubagentConfig): Promise<SpawnResult>;
-    assign(task: TaskSpec): Promise<void>;
-    delegate(to: string, msg: BridgeMessage): Promise<void>;
-    /**
-     * Wire up the communication bridge for a subagent. Call after spawn() once
-     * the caller has created the bidirectional connection.
-     */
-    setSubagentBridge(subagentId: string, bridge: AgentBridge): void;
-    stop(subagentId: string): Promise<void>;
-    stopAll(): Promise<void>;
-    getStatus(): CoordinatorStatus;
-    /** Expose snapshot of completed results — useful for callers awaiting all done. */
-    results(): readonly TaskResult[];
-    /**
-     * Wait for one or more tasks to complete and return their results.
-     * If a task is already done when called, returns immediately.
-     * Resolves to an array in the same order as `taskIds`.
-     */
-    awaitTasks(taskIds: string[]): Promise<TaskResult[]>;
-    /**
-     * Manual completion — for callers that drive subagents without a runner
-     * (e.g. external orchestrators). When a runner is configured the coordinator
-     * calls this itself.
-     */
-    completeTask(result: TaskResult): void;
-    private tryDispatchNext;
-    private canDispatch;
-    private takeNextDispatchableTask;
-    private findIdleSubagent;
-    private isIdleSubagent;
-    /**
-     * Returns true iff at least one spawned subagent could still
-     * process a task. A "live" subagent is one that is not stopped
-     * AND not mid-termination — `running` workers count because they
-     * will eventually finish and become idle.
-     *
-     * When no subagent has ever been spawned, returns `true` so a
-     * pre-spawn `assign()` simply queues (legacy behaviour). The
-     * dead-end detection only fires after `stop()` has retired every
-     * spawned worker.
-     *
-     * Used by `tryDispatchNext` to detect a dead-end pending queue.
-     */
-    private hasLiveSubagent;
-    /**
-     * Drain every pending task with a synthetic `aborted_by_parent`
-     * completion event. Same shape as the `stopAll()` drain — we go
-     * around `recordCompletion` because pending tasks were never
-     * counted in `inFlight` and routing them through would trip the
-     * underflow guard on every task after the first.
-     */
-    private drainPendingAsAborted;
-    private runDispatched;
-    private executeWithTimeout;
-    private recordCompletion;
-    private isDone;
-}
-
 /**
  * Per-subagent session factory.
  *
@@ -1156,7 +1099,12 @@ declare const REFACTOR_PLANNER_AGENT: SubagentConfig;
  * Use for: CI checks, pre-release audits, dependency vulnerability scanning.
  */
 declare const SECURITY_SCANNER_AGENT: SubagentConfig;
-/** All pre-built agents in a map for easy lookup by role. */
+/**
+ * All agents in a map for easy lookup by role. The four legacy pre-built
+ * agents plus the phase 1-9 catalog (`ALL_AGENT_DEFINITIONS`). Catalog roles
+ * are guaranteed collision-free by the catalog builder; none overlap the
+ * legacy four.
+ */
 declare const FLEET_ROSTER: Record<string, SubagentConfig>;
 interface FleetRosterBudget {
     timeoutMs?: number;
@@ -1169,6 +1117,56 @@ declare const FLEET_ROSTER_BUDGETS: Record<string, FleetRosterBudget>;
 declare function applyRosterBudget(cfg: SubagentConfig): SubagentConfig;
 /** Quick-access list for spawning all at once. */
 declare const ALL_FLEET_AGENTS: SubagentConfig[];
+/** All ACP external agents. */
+declare const ACP_AGENTS: SubagentConfig[];
+/** Extended roster including ACP agents. */
+declare const FLEET_ROSTER_WITHACP: Record<string, SubagentConfig>;
+
+/**
+ * Default auto-extend policy for subagent budgets.
+ *
+ * The budget's soft-limit path (`SubagentBudget` → `budget.threshold_reached`)
+ * only negotiates an extension when SOMETHING listens on the EventBus. Under a
+ * `Director`, that listener is the director's own auto-extend handler. On the
+ * plain coordinator path (e.g. a bare `/spawn` with no director) nothing
+ * listens, so the budget falls back to a hard stop and the subagent dies the
+ * moment it crosses a soft limit.
+ *
+ * `attachAutoExtend` is the additive fix: wire it to a subagent's EventBus and
+ * budget overruns are auto-granted headroom instead of killing the run. It is
+ * heartbeat-aware for the timeout kind — wall-clock time always advances, so a
+ * naive "extend timeout forever" would let a wedged agent run indefinitely.
+ * Instead, a timeout extension is granted only when the agent has executed a
+ * new tool call or started a new iteration since the last timeout extension.
+ * No progress since last time ⇒ the agent is genuinely stuck ⇒ deny and let it
+ * fail. The non-timeout kinds (iterations/tool_calls/tokens/cost) extend up to
+ * a per-kind cap, then deny — those ceilings are the real runaway guard.
+ */
+
+interface AutoExtendCeiling {
+    maxIterations?: number;
+    maxToolCalls?: number;
+    maxTokens?: number;
+    maxCostUsd?: number;
+    timeoutMs?: number;
+}
+interface AutoExtendPolicy {
+    /** Multiplier applied to the tripped limit when extending. Default 0.5 (+50%). */
+    factor?: number;
+    /**
+     * Max extensions per NON-timeout kind before denying. Timeout is governed by
+     * the heartbeat check, not this cap, so it can extend indefinitely while the
+     * agent makes progress. Default 8.
+     */
+    maxExtensionsPerKind?: number;
+    /** Absolute ceilings — an extension never pushes a limit past these. */
+    ceiling?: AutoExtendCeiling;
+}
+/**
+ * Attach an auto-extend policy to a subagent's EventBus. Returns an unsubscribe
+ * function that detaches all listeners — call it when the subagent task ends.
+ */
+declare function attachAutoExtend(events: EventBus, policy?: AutoExtendPolicy): () => void;
 
 /**
  * A no-op FleetBus that discards all events. Used when no real fleet
@@ -1179,4 +1177,4 @@ declare const ALL_FLEET_AGENTS: SubagentConfig[];
  */
 declare const NULL_FLEET_BUS: FleetBus;
 
-export { ALL_FLEET_AGENTS as A, BUG_HUNTER_AGENT as B, type CreateDelegateToolOptions as C, DEFAULT_DIRECTOR_PREAMBLE as D, FLEET_ROSTER as F, type ICoordinator as I, type MultiAgentCoordinatorOptions as M, NULL_FLEET_BUS as N, REFACTOR_PLANNER_AGENT as R, SECURITY_SCANNER_AGENT as S, AUDIT_LOG_AGENT as a, DEFAULT_SUBAGENT_BASELINE as b, DefaultMultiAgentCoordinator as c, type DelegateHost as d, Director as e, type DirectorPromptParts as f, type DirectorSessionFactory as g, type DirectorSessionFactoryOptions as h, FLEET_ROSTER_BUDGETS as i, FleetManager as j, type FleetManagerOptions as k, FleetSpawnBudgetError as l, type IFleetManager as m, type SubagentPromptParts as n, applyRosterBudget as o, composeDirectorPrompt as p, composeSubagentPrompt as q, createDelegateTool as r, makeDirectorSessionFactory as s, rosterSummaryFromConfigs as t, FleetCostCapError as u };
+export { ACP_AGENTS as A, BUG_HUNTER_AGENT as B, type CreateDelegateToolOptions as C, DEFAULT_DIRECTOR_PREAMBLE as D, createDelegateTool as E, FLEET_ROSTER as F, getAgentDefinition as G, makeDirectorSessionFactory as H, type ICoordinator as I, rosterSummaryFromConfigs as J, NULL_FLEET_BUS as N, REFACTOR_PLANNER_AGENT as R, SECURITY_SCANNER_AGENT as S, AGENTS_BY_PHASE as a, AGENT_CATALOG as b, ALL_AGENT_DEFINITIONS as c, ALL_FLEET_AGENTS as d, AUDIT_LOG_AGENT as e, type AutoExtendCeiling as f, type AutoExtendPolicy as g, DEFAULT_SUBAGENT_BASELINE as h, type DelegateHost as i, Director as j, type DirectorPromptParts as k, type DirectorSessionFactory as l, type DirectorSessionFactoryOptions as m, FLEET_ROSTER_BUDGETS as n, FLEET_ROSTER_WITHACP as o, FleetCostCapError as p, FleetManager as q, type FleetManagerOptions as r, type FleetRosterBudget as s, FleetSpawnBudgetError as t, type IFleetManager as u, type SubagentPromptParts as v, applyRosterBudget as w, attachAutoExtend as x, composeDirectorPrompt as y, composeSubagentPrompt as z };

package/dist/observability/index.d.ts

@@ -1,6 +1,6 @@
 import { e as MetricsSink, M as MetricLabels, f as MetricsSnapshot, b as HealthRegistry, H as HealthCheck, A as AggregateHealth, T as Tracer, S as Span } from '../observability-BhnVLBLS.js';
-import { E as EventBus } from '../events-DounT6pP.js';
-import '../context-C8mBUzBv.js';
+import { E as EventBus } from '../events-AjrvHJ9V.js';
+import '../context-BwxhvyW8.js';
 
 /**
  * In-memory metrics sink. Suitable for embedded use, tests, and /metrics

package/dist/{path-resolver-DwJO5XBn.d.ts → path-resolver-C1NM67-u.d.ts}

@@ -1,6 +1,6 @@
-import { E as EventBus } from './events-DounT6pP.js';
+import { E as EventBus } from './events-AjrvHJ9V.js';
 import { M as ModelsRegistry, b as ResolvedModel } from './models-registry-Y2xbog0E.js';
-import { a3 as TokenCounter, U as Usage, a4 as CacheStats } from './context-C8mBUzBv.js';
+import { a6 as TokenCounter, U as Usage, a7 as CacheStats } from './context-BwxhvyW8.js';
 import { P as PathResolver } from './path-resolver-CPRj4bFY.js';
 
 /**

package/dist/{plan-templates-CG_pInJV.d.ts → plan-templates-CNY6f82B.d.ts}

@@ -1,9 +1,9 @@
-import { E as EventBus } from './events-DounT6pP.js';
-import { p as SessionStore, o as SessionMetadata, r as SessionWriter, k as ResumedSession, S as SessionData, q as SessionSummary, b as ContentBlock, n as SessionEvent, a5 as TodoItem, a6 as ConversationState } from './context-C8mBUzBv.js';
-import { e as AttachmentStore, A as AddAttachmentInput, d as AttachmentRef, a as Attachment } from './session-reader-BXWxFAhS.js';
+import { E as EventBus } from './events-AjrvHJ9V.js';
+import { r as SessionStore, q as SessionMetadata, t as SessionWriter, m as ResumedSession, S as SessionData, s as SessionSummary, b as ContentBlock, p as SessionEvent, a8 as TodoItem, a9 as ConversationState } from './context-BwxhvyW8.js';
+import { e as AttachmentStore, A as AddAttachmentInput, d as AttachmentRef, a as Attachment } from './session-reader-g-FKCyBw.js';
 import { b as MemoryStore, a as MemoryScope } from './memory-CEXuo7sz.js';
 import { W as WstackPaths } from './wstack-paths-86YPFktR.js';
-import { c as ConfigStore, a as Config, b as ConfigLoader } from './config-BHkYGzUT.js';
+import { c as ConfigStore, a as Config, b as ConfigLoader } from './config-BXAhlqJb.js';
 import { S as SecretVault } from './secret-vault-DoISxaKO.js';
 
 interface SessionStoreOptions {

package/dist/{provider-runner-DoohzfyD.d.ts → provider-runner-Cmuevptw.d.ts}

@@ -1,8 +1,8 @@
-import { E as EventBus } from './events-DounT6pP.js';
+import { E as EventBus } from './events-AjrvHJ9V.js';
 import { L as Logger } from './logger-BMQgxvdy.js';
 import { T as Tracer } from './observability-BhnVLBLS.js';
-import { g as Provider, R as Request, a2 as Context, j as Response } from './context-C8mBUzBv.js';
-import { R as RetryPolicy } from './retry-policy-DOnwHAyz.js';
+import { i as Provider, R as Request, a5 as Context, l as Response } from './context-BwxhvyW8.js';
+import { R as RetryPolicy } from './retry-policy-mEBn5qpv.js';
 
 /**
  * Options passed to a ProviderRunner when calling the provider.

package/dist/{retry-policy-DOnwHAyz.d.ts → retry-policy-mEBn5qpv.d.ts}

@@ -1,4 +1,4 @@
-import { j as Response, a2 as Context, h as ProviderError } from './context-C8mBUzBv.js';
+import { l as Response, a5 as Context, j as ProviderError } from './context-BwxhvyW8.js';
 
 type RecoveryDecision = {
     /**

package/dist/sdd/index.d.ts

@@ -1,7 +1,7 @@
 import { h as Specification, S as SpecAnalysis, g as SpecValidationResult, l as TaskGraph, m as TaskNode, k as TaskFilter, p as TaskSort, o as TaskProgress, r as TaskType, n as TaskPriority, e as SpecStatus, f as SpecTemplate, b as SpecRequirement } from '../task-graph-D1YQbpxF.js';
-import { E as EventBus } from '../events-DounT6pP.js';
-import { D as DoneCondition } from '../multi-agent-Iy8YUe3v.js';
-import '../context-C8mBUzBv.js';
+import { E as EventBus } from '../events-AjrvHJ9V.js';
+import { D as DoneCondition } from '../multi-agent-DenFfUv5.js';
+import '../context-BwxhvyW8.js';
 
 declare class SpecParser {
     parse(content: string): Specification;

package/dist/{secret-scrubber-DcTK9JHC.d.ts → secret-scrubber-BmiGszvl.d.ts}

@@ -1,5 +1,5 @@
 import { S as SecretVault } from './secret-vault-DoISxaKO.js';
-import { S as SecretScrubber } from './secret-scrubber-C9UJxFCJ.js';
+import { S as SecretScrubber } from './secret-scrubber-bZ5AyhwJ.js';
 
 interface SecretVaultOptions {
     /** Absolute path to the key file. Created with mode 0o600 if missing. */

package/dist/{secret-scrubber-C9UJxFCJ.d.ts → secret-scrubber-bZ5AyhwJ.d.ts}

@@ -1,4 +1,4 @@
-import { v as Tool, a2 as Context, P as Permission } from './context-C8mBUzBv.js';
+import { x as Tool, a5 as Context, P as Permission } from './context-BwxhvyW8.js';
 
 interface TrustPolicy {
     [toolNameOrPattern: string]: {

package/dist/security/index.d.ts

@@ -1,7 +1,7 @@
-export { D as DefaultSecretScrubber, a as DefaultSecretVault, S as SecretVaultOptions, d as decryptConfigSecrets, e as encryptConfigSecrets, m as migratePlaintextSecrets, r as rewriteConfigEncrypted } from '../secret-scrubber-DcTK9JHC.js';
-import { v as Tool, a2 as Context } from '../context-C8mBUzBv.js';
+export { D as DefaultSecretScrubber, a as DefaultSecretVault, S as SecretVaultOptions, d as decryptConfigSecrets, e as encryptConfigSecrets, m as migratePlaintextSecrets, r as rewriteConfigEncrypted } from '../secret-scrubber-BmiGszvl.js';
+import { x as Tool, a5 as Context } from '../context-BwxhvyW8.js';
 import { I as InputReader } from '../input-reader-E-ffP2ee.js';
-import { a as PermissionPolicy, P as PermissionDecision } from '../secret-scrubber-C9UJxFCJ.js';
+import { a as PermissionPolicy, P as PermissionDecision } from '../secret-scrubber-bZ5AyhwJ.js';
 import '../secret-vault-DoISxaKO.js';
 
 interface PermissionPolicyOptions {

package/dist/{selector-DVo3eT-P.d.ts → selector-BmUma5iG.d.ts}

@@ -1,4 +1,4 @@
-import { M as Message } from './context-C8mBUzBv.js';
+import { M as Message } from './context-BwxhvyW8.js';
 
 /**
  * Result of LLM-driven message importance analysis.

package/dist/{session-reader-BXWxFAhS.d.ts → session-reader-g-FKCyBw.d.ts}

@@ -1,4 +1,4 @@
-import { b as ContentBlock, n as SessionEvent, o as SessionMetadata, p as SessionStore } from './context-C8mBUzBv.js';
+import { b as ContentBlock, p as SessionEvent, q as SessionMetadata, r as SessionStore } from './context-BwxhvyW8.js';
 
 type AttachmentKind = 'text' | 'image' | 'file';
 interface AttachmentMeta {

package/dist/storage/index.d.ts

@@ -1,13 +1,13 @@
-export { A as AbandonedSession, a as AttachmentStoreOptions, C as ConfigLoaderOptions, b as ConfigMigration, c as ConfigMigrationError, d as ConfigSource, D as DEFAULT_CONFIG_MIGRATIONS, e as DefaultAttachmentStore, f as DefaultConfigLoader, g as DefaultConfigStore, h as DefaultMemoryStore, i as DefaultSessionStore, M as MemoryStoreOptions, j as MigrationContext, k as MigrationResult, P as PersistedQueueItem, l as PlanFile, m as PlanItem, n as PlanTemplate, Q as QueueStore, R as RecoveryLock, o as RecoveryLockOptions, S as SessionAnalyzer, p as SessionStoreOptions, T as TodosCheckpointFile, q as addPlanItem, r as attachPlanCheckpoint, s as attachTodosCheckpoint, t as clearPlan, u as deriveTodosFromPlanItem, v as emptyPlan, w as formatPlan, x as formatPlanTemplates, y as getPlanTemplate, z as listPlanTemplates, B as loadPlan, E as loadTodosCheckpoint, F as removePlanItem, G as runConfigMigrations, H as savePlan, I as saveTodosCheckpoint, J as setPlanItemStatus } from '../plan-templates-CG_pInJV.js';
-export { D as DefaultSessionReader } from '../session-reader-BXWxFAhS.js';
+export { A as AbandonedSession, a as AttachmentStoreOptions, C as ConfigLoaderOptions, b as ConfigMigration, c as ConfigMigrationError, d as ConfigSource, D as DEFAULT_CONFIG_MIGRATIONS, e as DefaultAttachmentStore, f as DefaultConfigLoader, g as DefaultConfigStore, h as DefaultMemoryStore, i as DefaultSessionStore, M as MemoryStoreOptions, j as MigrationContext, k as MigrationResult, P as PersistedQueueItem, l as PlanFile, m as PlanItem, n as PlanTemplate, Q as QueueStore, R as RecoveryLock, o as RecoveryLockOptions, S as SessionAnalyzer, p as SessionStoreOptions, T as TodosCheckpointFile, q as addPlanItem, r as attachPlanCheckpoint, s as attachTodosCheckpoint, t as clearPlan, u as deriveTodosFromPlanItem, v as emptyPlan, w as formatPlan, x as formatPlanTemplates, y as getPlanTemplate, z as listPlanTemplates, B as loadPlan, E as loadTodosCheckpoint, F as removePlanItem, G as runConfigMigrations, H as savePlan, I as saveTodosCheckpoint, J as setPlanItemStatus } from '../plan-templates-CNY6f82B.js';
+export { D as DefaultSessionReader } from '../session-reader-g-FKCyBw.js';
 import { S as SessionRewinder, C as CheckpointInfo, a as RewindResultExtended } from '../session-rewinder-C9HnMkhP.js';
-export { D as DirectorStateCheckpoint, a as DirectorStateSnapshot, b as DirectorSubagentState, c as DirectorTaskState, l as loadDirectorState } from '../director-state-BmYi3DGA.js';
+export { a as DirectorStateCheckpoint, D as DirectorStateSnapshot, b as DirectorSubagentState, c as DirectorTaskState, l as loadDirectorState } from '../director-state-BUB7JRUr.js';
 export { G as GoalFile, J as JournalEntry, M as MAX_JOURNAL_ENTRIES, a as appendJournal, e as emptyGoal, f as formatGoal, g as goalFilePath, l as loadGoal, s as saveGoal, b as summarizeUsage } from '../goal-store-HHgaq5ue.js';
-import '../events-DounT6pP.js';
-import '../context-C8mBUzBv.js';
+import '../events-AjrvHJ9V.js';
+import '../context-BwxhvyW8.js';
 import '../memory-CEXuo7sz.js';
 import '../wstack-paths-86YPFktR.js';
-import '../config-BHkYGzUT.js';
+import '../config-BXAhlqJb.js';
 import '../models-registry-Y2xbog0E.js';
 import '../secret-vault-DoISxaKO.js';
 

package/dist/storage/index.js

@@ -199,8 +199,16 @@ var DefaultSessionStore = class {
     }
   }
   async resume(id) {
-    const data = await this.load(id);
     const file = path2.join(this.dir, `${id}.jsonl`);
+    try {
+      await fsp.access(file, fsp.constants.R_OK);
+    } catch {
+      throw new Error(
+        `Session "${id}" not found \u2014 the session file does not exist or was deleted.`,
+        { cause: new Error("ENOENT") }
+      );
+    }
+    const data = await this.load(id);
     let handle;
     try {
       handle = await fsp.open(file, "a", 384);
@@ -1145,6 +1153,20 @@ function safeParse(input, maxBytes = 5e6) {
   }
 }
 
+// src/types/default-config.ts
+var DEFAULT_TOOLS_CONFIG = Object.freeze({
+  defaultExecutionStrategy: "smart",
+  maxIterations: 100,
+  iterationTimeoutMs: 3e5,
+  sessionTimeoutMs: 18e5,
+  perIterationOutputCapBytes: 1e5,
+  autoExtendLimit: true
+});
+var DEFAULT_CONTEXT_CONFIG = Object.freeze({
+  preserveK: 10,
+  eliseThreshold: 2e3
+});
+
 // src/storage/config-loader.ts
 var BEHAVIOR_DEFAULTS = {
   version: 1,
@@ -1154,16 +1176,16 @@ var BEHAVIOR_DEFAULTS = {
     softThreshold: 0.75,
     hardThreshold: 0.9,
     autoCompact: true,
-    preserveK: 10,
-    eliseThreshold: 2e3
+    preserveK: DEFAULT_CONTEXT_CONFIG.preserveK,
+    eliseThreshold: DEFAULT_CONTEXT_CONFIG.eliseThreshold
   },
   tools: {
-    defaultExecutionStrategy: "smart",
-    maxIterations: 100,
-    iterationTimeoutMs: 3e5,
-    sessionTimeoutMs: 18e5,
-    perIterationOutputCapBytes: 1e5,
-    autoExtendLimit: true
+    defaultExecutionStrategy: DEFAULT_TOOLS_CONFIG.defaultExecutionStrategy,
+    maxIterations: DEFAULT_TOOLS_CONFIG.maxIterations,
+    iterationTimeoutMs: DEFAULT_TOOLS_CONFIG.iterationTimeoutMs,
+    sessionTimeoutMs: DEFAULT_TOOLS_CONFIG.sessionTimeoutMs,
+    perIterationOutputCapBytes: DEFAULT_TOOLS_CONFIG.perIterationOutputCapBytes,
+    autoExtendLimit: DEFAULT_TOOLS_CONFIG.autoExtendLimit
   },
   log: { level: "info" },
   features: {
@@ -1177,19 +1199,23 @@ var BEHAVIOR_DEFAULTS = {
 var ENV_MAP = {
   WRONGSTACK_PROVIDER: (c, v) => {
     c.provider = v;
-    (c._envSource ??= /* @__PURE__ */ new Set()).add("provider");
+    if (c._envSource === void 0) c._envSource = /* @__PURE__ */ new Set();
+    c._envSource.add("provider");
   },
   WRONGSTACK_MODEL: (c, v) => {
     c.model = v;
-    (c._envSource ??= /* @__PURE__ */ new Set()).add("model");
+    if (c._envSource === void 0) c._envSource = /* @__PURE__ */ new Set();
+    c._envSource.add("model");
   },
   WRONGSTACK_API_KEY: (c, v) => {
     c.apiKey = v;
-    (c._envSource ??= /* @__PURE__ */ new Set()).add("apiKey");
+    if (c._envSource === void 0) c._envSource = /* @__PURE__ */ new Set();
+    c._envSource.add("apiKey");
   },
   WRONGSTACK_BASE_URL: (c, v) => {
     c.baseUrl = v;
-    (c._envSource ??= /* @__PURE__ */ new Set()).add("baseUrl");
+    if (c._envSource === void 0) c._envSource = /* @__PURE__ */ new Set();
+    c._envSource.add("baseUrl");
   },
   WRONGSTACK_LOG_LEVEL: (c, v) => {
     if (!c.log) c.log = { level: "info" };
@@ -2552,6 +2578,58 @@ var DirectorStateCheckpoint = class {
     }
   }
 };
+
+// src/types/errors.ts
+var ERROR_CODES = {
+  // File system
+  FS_READ_FAILED: "FS_READ_FAILED",
+  FS_ATOMIC_WRITE_FAILED: "FS_ATOMIC_WRITE_FAILED"};
+var WrongStackError = class extends Error {
+  code;
+  subsystem;
+  severity;
+  recoverable;
+  context;
+  constructor(opts) {
+    super(opts.message, { cause: opts.cause });
+    this.name = "WrongStackError";
+    this.code = opts.code;
+    this.subsystem = opts.subsystem;
+    this.severity = opts.severity ?? "error";
+    this.recoverable = opts.recoverable ?? false;
+    this.context = opts.context;
+  }
+  /**
+   * Render a one-line user-facing description.
+   * Subclasses should override for domain-specific formatting.
+   */
+  describe() {
+    const ctx = this.context ? ` ${formatContext(this.context)}` : "";
+    return `${this.code}: ${this.message}${ctx}`;
+  }
+};
+function formatContext(ctx) {
+  const parts = Object.entries(ctx).filter(([, v]) => v !== void 0).slice(0, 3).map(([k, v]) => `${k}=${String(v)}`);
+  return parts.length > 0 ? `[${parts.join(" ")}]` : "";
+}
+var FsError = class extends WrongStackError {
+  path;
+  constructor(opts) {
+    super({
+      message: opts.message,
+      code: opts.code,
+      subsystem: "fs",
+      severity: "error",
+      recoverable: opts.code !== ERROR_CODES.FS_READ_FAILED,
+      context: { path: opts.path, ...opts.context },
+      cause: opts.cause
+    });
+    this.name = "FsError";
+    this.path = opts.path;
+  }
+};
+
+// src/storage/goal-store.ts
 var MAX_JOURNAL_ENTRIES = 500;
 function goalFilePath(projectRoot) {
   return path2.join(projectRoot, ".wrongstack", "goal.json");
@@ -2574,7 +2652,16 @@ async function loadGoal(filePath) {
   }
 }
 async function saveGoal(filePath, goal) {
-  await atomicWrite(filePath, JSON.stringify(goal, null, 2), { mode: 384 });
+  try {
+    await atomicWrite(filePath, JSON.stringify(goal, null, 2), { mode: 384 });
+  } catch (err) {
+    throw new FsError({
+      message: err instanceof Error ? err.message : String(err),
+      code: ERROR_CODES.FS_ATOMIC_WRITE_FAILED,
+      path: filePath,
+      cause: err
+    });
+  }
 }
 function emptyGoal(goal) {
   const now = (/* @__PURE__ */ new Date()).toISOString();