@wrongstack/core 0.7.0 → 0.7.2

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

@@ -1,8 +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 } from './multi-agent-Cm1wYSrw.js';
-import { t as SessionWriter, x as Tool, r as SessionStore } from './context-bmR0YgBm.js';
-import { I as InMemoryAgentBridge } from './agent-bridge-CrQpYjM7.js';
-import { F as FleetBus, e as FleetUsage, f as FleetUsageAggregator } from './multi-agent-coordinator-CCupVFqv.js';
+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`
@@ -575,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
@@ -584,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;
@@ -1063,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;
@@ -1076,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
@@ -1086,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, 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, type DelegateHost as c, Director as d, type DirectorPromptParts as e, type DirectorSessionFactory as f, type DirectorSessionFactoryOptions as g, FLEET_ROSTER_BUDGETS as h, FleetManager as i, type FleetManagerOptions as j, FleetSpawnBudgetError as k, type IFleetManager as l, type SubagentPromptParts as m, applyRosterBudget as n, composeDirectorPrompt as o, composeSubagentPrompt as p, createDelegateTool as q, makeDirectorSessionFactory as r, rosterSummaryFromConfigs as s, FleetCostCapError as t };
+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-CEKFTmIY.js';
-import '../context-bmR0YgBm.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-CfT7e_HT.d.ts → path-resolver-C1NM67-u.d.ts}

@@ -1,6 +1,6 @@
-import { E as EventBus } from './events-CEKFTmIY.js';
+import { E as EventBus } from './events-AjrvHJ9V.js';
 import { M as ModelsRegistry, b as ResolvedModel } from './models-registry-Y2xbog0E.js';
-import { a6 as TokenCounter, U as Usage, a7 as CacheStats } from './context-bmR0YgBm.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-Q78an-GJ.d.ts → plan-templates-CNY6f82B.d.ts}

@@ -1,9 +1,9 @@
-import { E as EventBus } from './events-CEKFTmIY.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-bmR0YgBm.js';
-import { e as AttachmentStore, A as AddAttachmentInput, d as AttachmentRef, a as Attachment } from './session-reader-Dwjn4WZR.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-C34JRwl4.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-WDj28o7J.d.ts → provider-runner-Cmuevptw.d.ts}

@@ -1,8 +1,8 @@
-import { E as EventBus } from './events-CEKFTmIY.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 { i as Provider, R as Request, a5 as Context, l as Response } from './context-bmR0YgBm.js';
-import { R as RetryPolicy } from './retry-policy-Dpxp4SET.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-Dpxp4SET.d.ts → retry-policy-mEBn5qpv.d.ts}

@@ -1,4 +1,4 @@
-import { l as Response, a5 as Context, j as ProviderError } from './context-bmR0YgBm.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-CEKFTmIY.js';
-import { D as DoneCondition } from '../multi-agent-Cm1wYSrw.js';
-import '../context-bmR0YgBm.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-CowtdEF8.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-C2YCYtkn.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-C2YCYtkn.d.ts → secret-scrubber-bZ5AyhwJ.d.ts}

@@ -1,4 +1,4 @@
-import { x as Tool, a5 as Context, P as Permission } from './context-bmR0YgBm.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-CowtdEF8.js';
-import { x as Tool, a5 as Context } from '../context-bmR0YgBm.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-C2YCYtkn.js';
+import { a as PermissionPolicy, P as PermissionDecision } from '../secret-scrubber-bZ5AyhwJ.js';
 import '../secret-vault-DoISxaKO.js';
 
 interface PermissionPolicyOptions {

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

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

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

@@ -1,4 +1,4 @@
-import { b as ContentBlock, p as SessionEvent, q as SessionMetadata, r as SessionStore } from './context-bmR0YgBm.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-Q78an-GJ.js';
-export { D as DefaultSessionReader } from '../session-reader-Dwjn4WZR.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-CEKFTmIY.js';
-import '../context-bmR0YgBm.js';
+import '../events-AjrvHJ9V.js';
+import '../context-BwxhvyW8.js';
 import '../memory-CEXuo7sz.js';
 import '../wstack-paths-86YPFktR.js';
-import '../config-C34JRwl4.js';
+import '../config-BXAhlqJb.js';
 import '../models-registry-Y2xbog0E.js';
 import '../secret-vault-DoISxaKO.js';
 

package/dist/storage/index.js

@@ -1199,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" };