@wrongstack/core 0.73.1 → 0.82.6

package/dist/{director-state-BmYi3DGA.d.ts → director-state-CgIc30qi.d.ts}

@@ -9,39 +9,39 @@
  */
 interface DirectorSubagentState {
     id: string;
-    name?: string;
-    role?: string;
-    provider?: string;
-    model?: string;
+    name?: string | undefined;
+    role?: string | undefined;
+    provider?: string | undefined;
+    model?: string | undefined;
     spawnedAt: string;
 }
 interface DirectorTaskState {
     taskId: string;
-    subagentId?: string;
-    description?: string;
+    subagentId?: string | undefined;
+    description?: string | undefined;
     status: 'pending' | 'running' | 'completed' | 'failed' | 'stopped' | 'timeout';
-    assignedAt?: string;
-    completedAt?: string;
-    iterations?: number;
-    toolCalls?: number;
-    durationMs?: number;
-    error?: string;
+    assignedAt?: string | undefined;
+    completedAt?: string | undefined;
+    iterations?: number | undefined;
+    toolCalls?: number | undefined;
+    durationMs?: number | undefined;
+    error?: string | undefined;
 }
 interface DirectorStateSnapshot {
     version: 1;
     directorRunId: string;
     updatedAt: string;
     spawnCount: number;
-    maxSpawns?: number;
+    maxSpawns?: number | undefined;
     spawnDepth: number;
     maxSpawnDepth: number;
     directorBudget?: {
-        maxCostUsd?: number;
-    };
+        maxCostUsd?: number | undefined;
+    } | undefined;
     subagents: DirectorSubagentState[];
     tasks: DirectorTaskState[];
     /** Aggregated usage snapshot. Optional — populated by the Director on save when available. */
-    usage?: unknown;
+    usage?: unknown | undefined;
 }
 declare function loadDirectorState(filePath: string): Promise<DirectorStateSnapshot | null>;
 /**
@@ -65,12 +65,12 @@ declare class DirectorStateCheckpoint {
     private rewriteRequested;
     constructor(filePath: string, init: {
         directorRunId: string;
-        maxSpawns?: number;
+        maxSpawns?: number | undefined;
         spawnDepth: number;
         maxSpawnDepth: number;
         directorBudget?: {
-            maxCostUsd?: number;
-        };
+            maxCostUsd?: number | undefined;
+        } | undefined;
     }, debounceMs?: number);
     /**
      * Attempt to acquire the lock for this checkpoint. Call this before

package/dist/{events-BBAlxBuw.d.ts → events-DnRqXaZ3.d.ts}

@@ -1,4 +1,4 @@
-import { $ as Usage, d as Context, X as ToolProgressEvent, Q as Tool } from './context-y87Jc5ei.js';
+import { $ as Usage, d as Context, X as ToolProgressEvent, Q as Tool } from './context-ToHAp4-U.js';
 
 /**
  * Brain coordination primitives.
@@ -15,30 +15,30 @@ type BrainFallback = 'ask_human' | 'deny' | 'continue';
 interface BrainDecisionOption {
     id: string;
     label: string;
-    consequence?: string;
-    risk?: BrainRisk;
-    recommended?: boolean;
+    consequence?: string | undefined;
+    risk?: BrainRisk | undefined;
+    recommended?: boolean | undefined;
 }
 interface BrainDecisionRequest {
     id: string;
     source: BrainDecisionSource;
     question: string;
-    context?: string;
-    options?: BrainDecisionOption[];
+    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;
+    optionId?: string | undefined;
     text: string;
-    rationale?: string;
+    rationale?: string | undefined;
 } | {
     type: 'ask_human';
     prompt: string;
-    options?: BrainDecisionOption[];
-    rationale?: string;
+    options?: BrainDecisionOption[] | undefined;
+    rationale?: string | undefined;
 } | {
     type: 'deny';
     reason: string;
@@ -59,7 +59,7 @@ declare class ObservableBrainArbiter implements BrainArbiter {
 }
 interface BrainDecisionQueueOptions {
     /** Safety fallback if the human never answers. Default: no timeout. */
-    timeoutMs?: number;
+    timeoutMs?: number | undefined;
 }
 /**
  * Bridge between an `ask_human` Brain decision and the UI. It emits the visible
@@ -86,7 +86,7 @@ declare class HumanEscalatingBrainArbiter implements BrainArbiter {
 }
 interface DefaultBrainArbiterOptions {
     /** Allow deterministic auto-answering for low-risk requests. Default true. */
-    allowLowRiskAutoAnswer?: boolean;
+    allowLowRiskAutoAnswer?: boolean | undefined;
 }
 /**
  * Conservative deterministic Brain implementation.
@@ -124,9 +124,9 @@ interface EventMap {
     };
     'brain.human_answered': {
         id: string;
-        optionId?: string;
-        deny?: boolean;
-        text?: string;
+        optionId?: string | undefined;
+        deny?: boolean | undefined;
+        text?: string | undefined;
         at: number;
     };
     'brain.decision_denied': {
@@ -232,7 +232,7 @@ interface EventMap {
     'tool.started': {
         name: string;
         id: string;
-        input?: unknown;
+        input?: unknown | undefined;
     };
     /**
      * Fired for each ToolProgressEvent yielded by `Tool.executeStream`. UIs
@@ -280,12 +280,12 @@ interface EventMap {
          * inputs. Optional only for legacy emit sites — new code should always
          * set it.
          */
-        id?: string;
+        id?: string | undefined;
         name: string;
         durationMs: number;
         ok: boolean;
-        input?: unknown;
-        output?: string;
+        input?: unknown | undefined;
+        output?: string | undefined;
         /**
          * Full UTF-8 byte length of the serialized tool result that the model
          * actually sees (post-cap, post-scrub). The `output` preview is capped
@@ -293,19 +293,56 @@ interface EventMap {
          * model is really paying tokens for. Optional only for legacy emit
          * sites that may not yet populate it.
          */
-        outputBytes?: number;
+        outputBytes?: number | undefined;
         /**
          * Estimated token count for the full result body the model sees.
          * Computed from `outputBytes` with the standard ~3.5 chars/token
          * heuristic. Cheap to show in the TUI; not authoritative — the real
          * provider count lives in `provider.response.usage`. */
-        outputTokens?: number;
+        outputTokens?: number | undefined;
         /**
          * For tools whose output has a clear "line" notion (file reads with
          * numbered prefixes, grep hits, bash stdout), the agent counts the
          * actual lines the model received and forwards it here. Undefined
          * for tools without a meaningful line count. */
-        outputLines?: number;
+        outputLines?: number | undefined;
+    };
+    /**
+     * Fired by the `delegate` tool right before it hands work to a subagent
+     * and blocks on the result. Lets UIs render a "started delegating" line
+     * immediately instead of looking idle for the (often minutes-long) life
+     * of the subagent. Paired with `delegate.completed`.
+     */
+    'delegate.started': {
+        /** Resolved roster role or free-form subagent name. */
+        target: string;
+        /** The task instruction handed to the subagent (untruncated — UIs trim). */
+        task: string;
+    };
+    /**
+     * Fired by the `delegate` tool once the subagent settles (success,
+     * timeout, budget exhaustion, error). Carries human-friendly, untruncated
+     * fields so UIs / the Telegram bridge can render a readable summary
+     * instead of the JSON-stringified, ~400-char-truncated `tool.executed`
+     * preview.
+     */
+    'delegate.completed': {
+        /** Resolved roster role or free-form subagent name. */
+        target: string;
+        /** The task instruction handed to the subagent. */
+        task: string;
+        /** True only when the subagent finished its task cleanly. */
+        ok: boolean;
+        /** Task status — 'success' | 'timeout' | 'host_timeout' | 'stopped' | ... */
+        status?: string | undefined;
+        /** One-line human summary (from `buildDelegateSummary`), untruncated. */
+        summary: string;
+        durationMs: number;
+        iterations: number;
+        toolCalls: number;
+        /** Estimated subagent cost in USD, from the director usage snapshot when known. */
+        costUsd?: number | undefined;
+        subagentId?: string | undefined;
     };
     /**
      * Fired on every `iteration.completed`. UIs subscribe to render a live
@@ -417,10 +454,10 @@ interface EventMap {
     'subagent.spawned': {
         subagentId: string;
         taskId: string;
-        name?: string;
-        provider?: string;
-        model?: string;
-        description?: string;
+        name?: string | undefined;
+        provider?: string | undefined;
+        model?: string | undefined;
+        description?: string | undefined;
         /**
          * Absolute path to the per-subagent JSONL transcript on disk, when
          * one was created. Undefined when the subagent shares the parent
@@ -428,12 +465,12 @@ interface EventMap {
          * Surfaced so the TUI (FleetPanel) and `/fleet log` can show the
          * user *where* to look without computing it from the run id.
          */
-        transcriptPath?: string;
+        transcriptPath?: string | undefined;
     };
     'subagent.task_started': {
         subagentId: string;
         taskId: string;
-        description?: string;
+        description?: string | undefined;
     };
     /**
      * Fired by `MultiAgentHost` when a subagent hits a soft budget limit
@@ -473,12 +510,12 @@ interface EventMap {
      */
     'subagent.tool_executed': {
         subagentId: string;
-        taskId?: string;
+        taskId?: string | undefined;
         name: string;
         durationMs: number;
         ok: boolean;
-        input?: unknown;
-        outputBytes?: number;
+        input?: unknown | undefined;
+        outputBytes?: number | undefined;
     };
     /**
      * Periodic progress snapshot emitted by the subagent runner every ~25
@@ -493,8 +530,8 @@ interface EventMap {
         iteration: number;
         toolCalls: number;
         costUsd: number;
-        currentTool?: string;
-        partialText?: string;
+        currentTool?: string | undefined;
+        partialText?: string | undefined;
     };
     'subagent.task_completed': {
         subagentId: string;
@@ -515,11 +552,11 @@ interface EventMap {
             kind: string;
             message: string;
             retryable: boolean;
-            backoffMs?: number;
+            backoffMs?: number | undefined;
             cause?: {
-                name: string;
+                name: string | undefined;
                 message: string;
-                stack?: string;
+                stack?: string | undefined;
             };
         };
     };
@@ -641,7 +678,7 @@ interface EventMap {
         insertions: number;
         deletions: number;
         files: number;
-        sha?: string;
+        sha?: string | undefined;
     };
     'worktree.merged': {
         handleId: string;
@@ -665,18 +702,19 @@ interface EventMap {
     'worktree.failed': {
         handleId: string;
         ownerId: string;
-        branch?: string;
+        branch?: string | undefined;
         error: string;
     };
     error: {
         err: Error;
         phase: string;
+        _original?: Error | undefined;
     };
 }
 type EventName = keyof EventMap;
 type Listener<E extends EventName> = (payload: EventMap[E]) => void;
 interface EventLogger {
-    error(msg: string, ctx?: unknown): void;
+    error(msg: string, ctx?: unknown): void | undefined;
 }
 declare class EventBus {
     private readonly listeners;

package/dist/execution/index.d.ts

@@ -1,28 +1,28 @@
-export { C as CompactorOptions, a as DefaultErrorHandler, b as DefaultRetryPolicy, E as EternalAutonomyEngine, c as EternalAutonomyOptions, d as EternalEngineState, H as HybridCompactor, I as IterationStage, P as ParallelEngineState, e as ParallelEternalEngine, f as ParallelEternalOptions, g as ParallelIterationStage, T as ToolExecutor } from '../parallel-eternal-engine-CjAYGaCw.js';
-import { m as Provider, d as Context } from '../context-y87Jc5ei.js';
-import { a as Compactor, C as CompactReport } from '../compactor-D_ExJajC.js';
-import { M as MessageSelector } from '../selector-RvBR_YRW.js';
-import { E as EventBus } from '../events-BBAlxBuw.js';
-import { b as MiddlewareHandler } from '../system-prompt-CA11g6Jo.js';
-import { a as SessionEventBridge } from '../session-event-bridge-CDHxcmQU.js';
-import { e as ContextWindowAggressiveOn, i as ContextWindowPolicy } from '../config-Dy0CK_o6.js';
-import { A as Agent, D as DoneCondition } from '../agent-subagent-runner-BmITbs1Q.js';
-import { R as RunResult, S as SystemPromptContributor } from '../index-BN6i2Nfg.js';
-import { a as SkillLoader, b as SkillManifest, S as SkillEntry } from '../skill-CxuWrsKK.js';
-import { a as WstackPaths } from '../wstack-paths-eMXnY1_X.js';
-import '../retry-policy-CG3qvH_e.js';
-import '../models-registry-BcYJDKLm.js';
-import '../goal-store-C7jcumEh.js';
-import '../multi-agent-coordinator-BSBbZt0e.js';
+export { C as CompactorOptions, a as DefaultErrorHandler, b as DefaultRetryPolicy, E as EternalAutonomyEngine, c as EternalAutonomyOptions, d as EternalEngineState, H as HybridCompactor, I as IterationStage, P as ParallelEngineState, e as ParallelEternalEngine, f as ParallelEternalOptions, g as ParallelIterationStage, T as ToolExecutor } from '../parallel-eternal-engine-D402RASp.js';
+import { m as Provider, d as Context } from '../context-ToHAp4-U.js';
+import { a as Compactor, C as CompactReport } from '../compactor-CJq7LQev.js';
+import { M as MessageSelector } from '../selector-11-fm95U.js';
+import { E as EventBus } from '../events-DnRqXaZ3.js';
+import { b as MiddlewareHandler } from '../system-prompt-C0rLCeyn.js';
+import { a as SessionEventBridge } from '../session-event-bridge-D0u-x576.js';
+import { e as ContextWindowAggressiveOn, i as ContextWindowPolicy } from '../config-_DZ7dN-T.js';
+import { A as Agent, D as DoneCondition } from '../agent-subagent-runner-2Aq0jOSj.js';
+import { R as RunResult, S as SystemPromptContributor } from '../index-N0_c4bHQ.js';
+import { a as SkillLoader, b as SkillManifest, S as SkillEntry } from '../skill-BJeF2DwY.js';
+import { a as WstackPaths } from '../wstack-paths-BQMvEllz.js';
+import '../retry-policy-DSu6O6rD.js';
+import '../models-registry-Be3osGt5.js';
+import '../goal-store-DvWLNu52.js';
+import '../multi-agent-coordinator-DllpCVkF.js';
 import 'node:events';
-import '../logger-DDd5C--Z.js';
-import '../observability-BhnVLBLS.js';
-import '../permission-V5BLOrY6.js';
+import '../logger-B72yyPc6.js';
+import '../observability-CoSNZdhX.js';
+import '../permission-14CChMmO.js';
 import '../secret-scrubber-3MHDDAtm.js';
 
 interface SkillLoaderOptions {
     paths: WstackPaths;
-    bundledDir?: string;
+    bundledDir?: string | undefined;
 }
 /**
  * Discovery order (later layers shadow earlier ones at boot, but we walk
@@ -50,25 +50,25 @@ interface IntelligentCompactorOptions {
     /** Provider to use for LLM-assisted summarization. Required. */
     provider: Provider;
     /** Fraction of maxContext that triggers a warning (default 0.6). */
-    warnThreshold?: number;
+    warnThreshold?: number | undefined;
     /** Fraction of maxContext that triggers soft compaction (default 0.75). */
-    softThreshold?: number;
+    softThreshold?: number | undefined;
     /** Fraction of maxContext that triggers hard compaction (default 0.9). */
-    hardThreshold?: number;
+    hardThreshold?: number | undefined;
     /** Max context window in tokens (used only for threshold fraction math). */
-    maxContext?: number;
+    maxContext?: number | undefined;
     /** How many recent (user+assistant) pairs to always preserve (default 4). */
-    preserveK?: number;
+    preserveK?: number | undefined;
     /** Token threshold below which tool results are not elided (default 500). */
-    eliseThreshold?: number;
+    eliseThreshold?: number | undefined;
     /** System prompt for the summarizer sub-LLM. */
-    summarizerPrompt?: string;
+    summarizerPrompt?: string | undefined;
     /**
      * Model ID to use for summarization. When not set, the same model as the
      * agent is used (which risks cascading failure on context overflow). Set to
      * a fast/cheap model like `claude-3-5-haiku-20240620` for resilience.
      */
-    summarizerModel?: string;
+    summarizerModel?: string | undefined;
 }
 /**
  * IntelligentCompactor uses an LLM to:
@@ -90,7 +90,7 @@ declare class IntelligentCompactor implements Compactor {
     private readonly summarizerModel?;
     constructor(opts: IntelligentCompactorOptions);
     compact(ctx: Context, opts?: {
-        aggressive?: boolean;
+        aggressive?: boolean | undefined;
     }): Promise<CompactReport>;
     /**
      * Estimate the full API request token count: messages + systemPrompt + toolDefs.
@@ -115,25 +115,25 @@ interface SelectiveCompactorOptions {
     /** Provider for LLM calls (selector + summarizer). Required. */
     provider: Provider;
     /** Selector for LLM-driven importance analysis. */
-    selector?: MessageSelector;
+    selector?: MessageSelector | undefined;
     /** Fraction of maxContext that triggers a warning (default 0.6). */
-    warnThreshold?: number;
+    warnThreshold?: number | undefined;
     /** Fraction of maxContext that triggers soft compaction (default 0.75). */
-    softThreshold?: number;
+    softThreshold?: number | undefined;
     /** Fraction of maxContext that triggers hard compaction (default 0.9). */
-    hardThreshold?: number;
+    hardThreshold?: number | undefined;
     /** Max context window in tokens (used for threshold fraction math). */
-    maxContext?: number;
+    maxContext?: number | undefined;
     /** How many recent (user+assistant) pairs to always preserve (default 4). */
-    preserveK?: number;
+    preserveK?: number | undefined;
     /** Token threshold below which tool results are not elided (default 500). */
-    eliseThreshold?: number;
+    eliseThreshold?: number | undefined;
     /** Model for selector LLM calls (default: same as provider default). */
-    selectorModel?: string;
+    selectorModel?: string | undefined;
     /** Summarizer model for collapsed ranges (default: same as selectorModel). */
-    summarizerModel?: string;
+    summarizerModel?: string | undefined;
     /** Prompt for the summarizer sub-LLM. */
-    summarizerPrompt?: string;
+    summarizerPrompt?: string | undefined;
 }
 /**
  * SelectiveCompactor uses an LLM-driven MessageSelector to make
@@ -157,7 +157,7 @@ declare class SelectiveCompactor implements Compactor {
     private readonly summarizerPrompt;
     constructor(opts: SelectiveCompactorOptions);
     compact(ctx: Context, opts?: {
-        aggressive?: boolean;
+        aggressive?: boolean | undefined;
     }): Promise<CompactReport>;
     /**
      * Estimate the full API request token count: messages + systemPrompt + toolDefs.
@@ -191,12 +191,12 @@ declare class SelectiveCompactor implements Compactor {
 
 type CompactionFailureMode = 'throw' | 'throw_on_hard' | 'continue';
 interface AutoCompactionOptions {
-    aggressiveOn?: ContextWindowAggressiveOn;
-    events?: EventBus;
-    failureMode?: CompactionFailureMode;
+    aggressiveOn?: ContextWindowAggressiveOn | undefined;
+    events?: EventBus | undefined;
+    failureMode?: CompactionFailureMode | undefined;
     policyProvider?: (ctx: Context) => Pick<ContextWindowPolicy, 'thresholds' | 'aggressiveOn'> | null | undefined;
     /** Optional bridge for writing compaction events into the persistent session log. */
-    sessionBridge?: SessionEventBridge;
+    sessionBridge?: SessionEventBridge | undefined;
 }
 /**
  * Pipeline middleware that monitors context token load and automatically
@@ -250,7 +250,7 @@ declare class AutoCompactionMiddleware {
         warn: number;
         soft: number;
         hard: number;
-    }, optsOrAggressiveOn?: AutoCompactionOptions | ContextWindowAggressiveOn, events?: EventBus);
+    }, optsOrAggressiveOn?: AutoCompactionOptions | ContextWindowAggressiveOn, events?: EventBus | undefined);
     /** Allow callers (e.g. model-switch in WebUI) to update the context window
      *  denominator when the active model changes. */
     setMaxContext(maxContext: number): void;
@@ -267,11 +267,11 @@ declare class AutoCompactionMiddleware {
 
 type AutonomousResult = RunResult & {
     toolCalls: number;
-    reason?: string;
+    reason?: string | undefined;
 };
 interface DoneCheckResult {
     done: boolean;
-    reason?: string;
+    reason?: string | undefined;
     iterations: number;
     toolCalls: number;
 }
@@ -282,26 +282,26 @@ declare class DoneConditionChecker {
     check(state: {
         iterations: number;
         toolCalls: number;
-        lastOutput?: string;
+        lastOutput?: string | undefined;
     }): DoneCheckResult;
 }
 interface AutonomousRunnerOptions {
     agent: Agent;
     context: Context;
     doneCondition: DoneCondition;
-    iterationTimeoutMs?: number;
+    iterationTimeoutMs?: number | undefined;
     onIteration?: (state: {
-        iteration: number;
+        iteration: number | undefined;
         toolCalls: number;
     }) => void;
-    onDone?: (result: AutonomousResult) => void;
+    onDone?: (((result: AutonomousResult) => void)) | undefined;
     /**
      * When true and `doneCondition.type === 'directive'`, the runner
      * runs the agent with `autonomousContinue: true` so the agent loop
      * handles its own [continue]/[done] markers internally (no outer
      * re-invocation needed). The runner still provides iteration/timeouts.
      */
-    enableAutonomousContinue?: boolean;
+    enableAutonomousContinue?: boolean | undefined;
 }
 declare class AutonomousRunner {
     private readonly opts;
@@ -346,7 +346,7 @@ interface AutonomyPromptContributorOptions {
      */
     enabled: () => boolean;
     /** Number of journal entries to include in the recent-tail block. Default 5. */
-    journalTailSize?: number;
+    journalTailSize?: number | undefined;
 }
 /**
  * Build a contributor that renders the autonomy-state system block.