@wrongstack/core 0.284.1 → 0.286.0

package/dist/execution/intelligent-compactor.d.ts

@@ -0,0 +1,85 @@
+import type { Context } from '../core/context.js';
+import type { CompactReport, Compactor } from '../types/compactor.js';
+import type { Provider } from '../types/provider.js';
+/**
+ * Options for IntelligentCompactor.
+ */
+export interface IntelligentCompactorOptions {
+    /** Provider to use for LLM-assisted summarization. Required. */
+    provider: Provider;
+    /** Fraction of maxContext that triggers a warning (default 0.6). */
+    warnThreshold?: number | undefined;
+    /** Fraction of maxContext that triggers soft compaction (default 0.75). */
+    softThreshold?: number | undefined;
+    /** Fraction of maxContext that triggers hard compaction (default 0.9). */
+    hardThreshold?: number | undefined;
+    /** Max context window in tokens (used only for threshold fraction math). */
+    maxContext?: number | undefined;
+    /** How many recent (user+assistant) pairs to always preserve (default 4). */
+    preserveK?: number | undefined;
+    /** Token threshold below which tool results are not elided (default 500). */
+    eliseThreshold?: number | undefined;
+    /** System prompt for the summarizer sub-LLM. */
+    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 configured model for resilience.
+     */
+    summarizerModel?: string | undefined;
+}
+/**
+ * An importance label for a message or message range.
+ */
+export type Importance = 'critical' | 'high' | 'medium' | 'low';
+/**
+ * Result of importance analysis.
+ */
+export interface ImportanceAnalysis {
+    messages: Array<{
+        index: number;
+        importance: Importance;
+        reason: string;
+    }>;
+    criticalRanges: Array<{
+        from: number;
+        to: number;
+        summary: string;
+    }>;
+}
+/**
+ * IntelligentCompactor uses an LLM to:
+ *  - Analyze message importance and preserve critical context
+ *  - Generate semantic summaries for old message ranges
+ *  - Make intelligent decisions about what to compact
+ *
+ * It builds on the shared `compaction-core` elision/boundary primitives and
+ * adds LLM-assisted summarization on top. When the summarizer call fails it
+ * falls back to the same lossless rule-based digest used by HybridCompactor.
+ */
+export declare class IntelligentCompactor implements Compactor {
+    private readonly provider;
+    private readonly warnThreshold;
+    private readonly softThreshold;
+    private readonly hardThreshold;
+    private readonly maxContext;
+    private readonly preserveK;
+    private readonly eliseThreshold;
+    private readonly summarizerPrompt;
+    private readonly summarizerModel?;
+    constructor(opts: IntelligentCompactorOptions);
+    compact(ctx: Context, opts?: {
+        aggressive?: boolean | undefined;
+    }): Promise<CompactReport>;
+    /**
+     * Estimate the full API request token count: messages + systemPrompt + toolDefs.
+     * This is the accurate figure for context-window pressure monitoring.
+     */
+    private estimateFullRequest;
+    /** Run shared tool-result elision and commit through ConversationState. */
+    private elide;
+    private summarizeAncientTurns;
+    private callSummarizer;
+    private messagesToText;
+}
+//# sourceMappingURL=intelligent-compactor.d.ts.map

package/dist/execution/intelligent-compactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intelligent-compactor.d.ts","sourceRoot":"","sources":["../../src/execution/intelligent-compactor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,KAAK,EAAE,QAAQ,EAAW,MAAM,sBAAsB,CAAC;AAW9D;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,gEAAgE;IAChE,QAAQ,EAAE,QAAQ,CAAC;IACnB,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,cAAc,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtE;AAED;;;;;;;;;GASG;AACH,qBAAa,oBAAqB,YAAW,SAAS;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAqB;IAEtD,YAAY,IAAI,EAAE,2BAA2B,EAY5C;IAEK,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,GAAE;QAAE,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAgDnG;IAED;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAI3B,2EAA2E;IAC3E,OAAO,CAAC,KAAK;YASC,qBAAqB;YAqCrB,cAAc;IAqC5B,OAAO,CAAC,cAAc;CAevB"}

package/dist/execution/model-runtime.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Model-runtime resolver + request-pipeline middleware.
+ *
+ * Maps the shared `Config.modelRuntime` settings into the per-request
+ * `Request.reasoning` and `Request.cache` fields, gated by the active model's
+ * `reasoningConfig` capabilities so unsupported values are omitted (and
+ * surfaced as warnings) instead of triggering provider 400s.
+ *
+ * Wired once at boot (REPL/TUI/WebUI all go through the same `request`
+ * pipeline) — see `installModelRuntimeMiddleware()`. UIs only need to mutate
+ * `Config.modelRuntime` (and persist) for the change to take effect on the next
+ * request.
+ */
+import type { Capabilities, ReasoningConfig, Request } from '../types/provider.js';
+import type { ModelRuntimeConfig, ModelRuntimeParametersConfig } from '../types/config.js';
+export interface ResolvedModelRuntime {
+    reasoning: Request['reasoning'];
+    cache: Request['cache'];
+    /** Resolved generation parameters (topK, frequencyPenalty, etc.). */
+    parameters: Partial<Request> | undefined;
+    /** Human-readable warnings for settings that were ignored for this model. */
+    warnings: string[];
+}
+/**
+ * Overlay a scoped runtime override (for example a subagent role matrix entry)
+ * on top of the session-wide runtime settings. Nested objects merge so a role
+ * can set only `reasoning.effort` without losing the leader's cache TTL or
+ * other gated parameters.
+ */
+export declare function mergeModelRuntime(base: ModelRuntimeConfig | undefined, override: ModelRuntimeConfig | undefined): ModelRuntimeConfig | undefined;
+/**
+ * Resolve user-facing runtime settings into request fields for a specific
+ * model capability profile. Pure function — safe to unit-test without a
+ * provider or event bus.
+ *
+ * @param settings   `Config.modelRuntime` (may be undefined → no-op)
+ * @param reasoning  The model's `reasoningConfig`, or undefined when unknown.
+ *                   When undefined the resolver is conservative: explicit
+ *                   on/off is suppressed (provider default wins) and effort is
+ *                   dropped, because we cannot tell whether the model will
+ *                   accept the fields.
+ */
+export declare function resolveModelRuntime(settings: ModelRuntimeConfig | undefined, reasoning: ReasoningConfig | undefined, capabilities?: Capabilities | undefined): ResolvedModelRuntime;
+export declare function resolveReasoningForRequest(settings: ModelRuntimeConfig, rc: ReasoningConfig | undefined, warnings: string[]): Request['reasoning'];
+export declare function resolveCacheForRequest(settings: ModelRuntimeConfig, _warnings: string[]): Request['cache'];
+/**
+ * Map the user-facing `ModelRuntimeParametersConfig` onto `Request` fields,
+ * gated by the active model's `Capabilities`. Parameters whose capability
+ * flag is false (or unknown) are silently omitted so unsupported models
+ * never receive fields they'd reject.
+ */
+export declare function resolveParametersForRequest(params: ModelRuntimeParametersConfig | undefined, caps: Capabilities | undefined, _warnings: string[]): Partial<Request> | undefined;
+export interface ModelRuntimeMiddlewareOptions {
+    /** Provider id of the active model, for logging/diagnostics only. */
+    providerId?: string | undefined;
+    /** Model id of the active model, for logging/diagnostics only. */
+    modelId?: string | undefined;
+    /** Current runtime settings. Called per-request so live changes apply. */
+    getSettings(): ModelRuntimeConfig | undefined;
+    /** Current model capability profile. Called per-request. */
+    getReasoningConfig(): ReasoningConfig | undefined;
+    /** Current model capabilities for parameter gating. Called per-request. */
+    getCapabilities?(): Capabilities | undefined;
+    /** Optional sink for suppressed-setting warnings (e.g. emit to event bus). */
+    onWarning?: ((message: string) => void) | undefined;
+}
+/**
+ * Build a `request`-pipeline middleware that applies runtime settings. The
+ * returned function mutates the outgoing request by overlaying resolved
+ * `reasoning` / `cache` fields and generic parameters. Existing fields on
+ * the request are preserved only when the resolver produces nothing for
+ * that field.
+ */
+export declare function applyModelRuntime(req: Request, opts: ModelRuntimeMiddlewareOptions): Request;
+//# sourceMappingURL=model-runtime.d.ts.map

package/dist/execution/model-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-runtime.d.ts","sourceRoot":"","sources":["../../src/execution/model-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EAEf,OAAO,EAER,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAE3F,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAChC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACxB,qEAAqE;IACrE,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IACzC,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,kBAAkB,GAAG,SAAS,EACpC,QAAQ,EAAE,kBAAkB,GAAG,SAAS,GACvC,kBAAkB,GAAG,SAAS,CAmBhC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,kBAAkB,GAAG,SAAS,EACxC,SAAS,EAAE,eAAe,GAAG,SAAS,EACtC,YAAY,CAAC,EAAE,YAAY,GAAG,SAAS,GACtC,oBAAoB,CAgBtB;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,kBAAkB,EAC5B,EAAE,EAAE,eAAe,GAAG,SAAS,EAC/B,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,WAAW,CAAC,CA+DtB;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,kBAAkB,EAC5B,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,OAAO,CAAC,CAKlB;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,4BAA4B,GAAG,SAAS,EAChD,IAAI,EAAE,YAAY,GAAG,SAAS,EAC9B,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS,CA4B9B;AAED,MAAM,WAAW,6BAA6B;IAC5C,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,0EAA0E;IAC1E,WAAW,IAAI,kBAAkB,GAAG,SAAS,CAAC;IAC9C,4DAA4D;IAC5D,kBAAkB,IAAI,eAAe,GAAG,SAAS,CAAC;IAClD,2EAA2E;IAC3E,eAAe,CAAC,IAAI,YAAY,GAAG,SAAS,CAAC;IAC7C,8EAA8E;IAC9E,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACrD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,6BAA6B,GAClC,OAAO,CAmBT"}

package/dist/execution/parallel-eternal-engine.d.ts

@@ -0,0 +1,142 @@
+import type { Agent } from '../core/agent.js';
+import type { AgentFactory } from '../coordination/agent-subagent-runner.js';
+import type { DispatchClassifier } from '../coordination/dispatcher.js';
+import type { EventBus } from '../kernel/events.js';
+import type { Logger } from '../types/logger.js';
+import type { JournalEntry } from '../storage/goal-store.js';
+import type { Compactor } from '../types/compactor.js';
+import { DefaultMultiAgentCoordinator } from '../coordination/multi-agent-coordinator.js';
+export type ParallelEngineState = 'idle' | 'running' | 'stopped';
+export type ParallelIterationStage = {
+    phase: 'idle';
+} | {
+    phase: 'decompose';
+} | {
+    phase: 'fanout';
+    slots: number;
+} | {
+    phase: 'await';
+    taskIds: string[];
+} | {
+    phase: 'aggregate';
+    successCount: number;
+    total: number;
+    goalComplete: boolean;
+} | {
+    phase: 'sleep';
+    ms: number;
+} | {
+    phase: 'stopped';
+} | {
+    phase: 'error';
+    message: string;
+};
+export interface ParallelEternalOptions {
+    /** The coordinating agent — NOT a subagent. Owns container/tools/providers. */
+    agent: Agent;
+    /** Project root (used for goal.json path). */
+    projectRoot: string;
+    /**
+     * Override the resolved goal.json path. Defaults to
+     * `goalFilePath(projectRoot)` — the canonical per-project goal file under
+     * `~/.wrongstack/projects/<slug>/`, shared with `/goal` and the TUI.
+     * Primarily for tests that want an isolated goal file under a temp dir.
+     */
+    goalPath?: string | undefined;
+    /**
+     * Number of parallel subagent slots per tick.
+     * Default: 4. Range 1–16; values >8 are for high-throughput machines.
+     */
+    parallelSlots?: number | undefined;
+    /** Per-subagent default timeout in ms. Default: 300_000 (5 min). */
+    iterationTimeoutMs?: number | undefined;
+    onIteration?: (((entry: JournalEntry) => void)) | undefined;
+    onError?: (err: Error | undefined, iteration: number) => void;
+    /** Per-tick phase notifications for live UI/status updates. */
+    onStage?: (((stage: ParallelIterationStage) => void)) | undefined;
+    gitStatusReader?: ((() => Promise<string>)) | undefined;
+    now?: ((() => Date)) | undefined;
+    compactor?: Compactor | undefined;
+    compactEveryNIterations?: number | undefined;
+    aggressiveCompactRatio?: number | undefined;
+    maxContextTokens?: number | undefined;
+    /** Override the default agent factory (uses main agent if not provided). */
+    subagentFactory?: AgentFactory | undefined;
+    /**
+     * Route each decomposed slot task to the best-fit catalog agent via the
+     * smart dispatcher (heuristic keyword scoring). When enabled (default), each
+     * slot spawns in-role — the role's budget tier applies and a persona line is
+     * injected into the task — instead of as a faceless generic worker. Set
+     * false to keep the legacy generic spawn.
+     */
+    dispatch?: boolean | undefined;
+    /**
+     * Optional LLM fallback for ambiguous tasks. Passed straight to
+     * `dispatchAgent`; when omitted, routing is pure heuristic (instant, no
+     * provider call — preferred for a continuously-ticking autonomous loop).
+     */
+    dispatchClassifier?: DispatchClassifier | undefined;
+    /** Optional EventBus for emitting storage.* observability events from goal I/O. */
+    events?: EventBus | undefined;
+    /** Logger for structured errors. Falls back to console.error when omitted. */
+    logger?: Logger | undefined;
+}
+/**
+ * Sense → Decide → Fan-out (4–8 parallel agents) → Aggregate → Loop.
+ *
+ * Each tick:
+ *   1. Sense    — load goal, todos, git status
+ *   2. Decide   — decompose goal into N parallel sub-tasks
+ *   3. Fan-out  — spawn N subagents simultaneously, await all
+ *   4. Aggregate — write journal, update todos, check [GOAL_COMPLETE]
+ *   5. Loop     — continue until stop() or mission complete
+ *
+ * Uses DefaultMultiAgentCoordinator + AgentSubagentRunner for subagent lifecycle.
+ */
+export declare class ParallelEternalEngine {
+    private readonly opts;
+    private state;
+    private stopRequested;
+    private iterationsSinceCompact;
+    private iterations;
+    private consecutiveFailures;
+    private readonly goalPath;
+    private readonly slots;
+    private readonly timeoutMs;
+    private coordinator;
+    private agentFactory;
+    private readonly dispatchEnabled;
+    private readonly dispatchClassifier?;
+    constructor(opts: ParallelEternalOptions);
+    /**
+     * Emit a structured error. Uses the configured Logger when available;
+     * falls back to console.error(JSON) so events are never silently dropped.
+     */
+    private logError;
+    /**
+     * Load the goal file with structured logging for parse/schema warnings.
+     */
+    private loadGoal;
+    get currentState(): ParallelEngineState;
+    /**
+     * Get the underlying coordinator for stats/monitoring.
+     */
+    getCoordinator(): DefaultMultiAgentCoordinator | null;
+    stop(): void;
+    prime(): Promise<void>;
+    run(): Promise<void>;
+    /**
+     * Execute one tick: decompose → fan-out → aggregate → compact.
+     * Called by the REPL in its main loop (REPL drives, engine is stateless per tick).
+     */
+    runOneIteration(): Promise<boolean>;
+    private fanOut;
+    private decomposeGoal;
+    private readGitStatus;
+    private brainstormSubtasks;
+    private maybeCompact;
+    private appendIterationEntry;
+    private appendFailure;
+    private persistState;
+}
+//# sourceMappingURL=parallel-eternal-engine.d.ts.map

package/dist/execution/parallel-eternal-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel-eternal-engine.d.ts","sourceRoot":"","sources":["../../src/execution/parallel-eternal-engine.ts"],"names":[],"mappings":"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"}

package/dist/execution/prompt-enhancer.d.ts

@@ -1,5 +1,5 @@
-import { P as Provider, R as ReasoningRequest, a as ReasoningConfig, M as Message } from '../tool-BNlnIJvo.js';
-
+import type { Message } from '../types/messages.js';
+import type { Provider, ReasoningConfig, ReasoningRequest } from '../types/provider.js';
 /**
  * Prompt refinement ("did you mean this?").
  *
@@ -13,14 +13,14 @@ import { P as Provider, R as ReasoningRequest, a as ReasoningConfig, M as Messag
  * `provider.complete()` with a dedicated system prompt — and is deliberately
  * free of React / TUI dependencies so it can be unit-tested in isolation.
  */
-declare const ENHANCER_SYSTEM_PROMPT: string;
+export declare const ENHANCER_SYSTEM_PROMPT: string;
 /**
  * Heuristic gate: should this raw input be sent through the refiner at all?
  * Pure + exported for unit testing. Returns false for inputs where refinement
  * is pointless or unwanted (slash commands, one-word affirmations, trivially
  * short text, bare numbers).
  */
-declare function shouldEnhance(text: string): boolean;
+export declare function shouldEnhance(text: string): boolean;
 /**
  * Build a reasoning directive for the refiner that minimizes wasted thinking,
  * gated to what the model actually accepts. Refinement is a shallow rewrite
@@ -38,15 +38,15 @@ declare function shouldEnhance(text: string): boolean;
  * identical to the behavior before this hint existed. Pure + exported for unit
  * testing.
  */
-declare function gatedEnhancerReasoning(rc: ReasoningConfig | undefined): ReasoningRequest | undefined;
+export declare function gatedEnhancerReasoning(rc: ReasoningConfig | undefined): ReasoningRequest | undefined;
 /**
  * Normalize for "did the refiner actually change anything?" comparison —
  * collapse whitespace and lowercase so trivial reformatting doesn't trigger
  * the confirmation panel.
  */
-declare function normalizedEqual(a: string, b: string): boolean;
+export declare function normalizedEqual(a: string, b: string): boolean;
 /** A single text-only conversation turn used as refiner context. */
-interface ConversationTurn {
+export interface ConversationTurn {
     role: 'user' | 'assistant';
     text: string;
 }
@@ -56,13 +56,13 @@ interface ConversationTurn {
  * English the refiner emits a single version and both fields hold the same
  * text (the UI then offers two identical choices, which is correct).
  */
-interface EnhanceResult {
+export interface EnhanceResult {
     /** Refined in the user's original language. */
     refined: string;
     /** Refined in English. Equals `refined` when the input was already English. */
     english: string;
 }
-interface EnhanceUserPromptOptions {
+export interface EnhanceUserPromptOptions {
     provider: Provider;
     model: string;
     text: string;
@@ -103,7 +103,7 @@ interface EnhanceUserPromptOptions {
  * aborted, or returned nothing useful). NEVER throws — refinement is a
  * best-effort convenience and must never block the user from sending.
  */
-declare function enhanceUserPrompt(opts: EnhanceUserPromptOptions): Promise<EnhanceResult | null>;
+export declare function enhanceUserPrompt(opts: EnhanceUserPromptOptions): Promise<EnhanceResult | null>;
 /**
  * Extract the last few user/assistant TEXT turns from a conversation, newest
  * last, for use as refiner context. Skips system messages and tool-only turns
@@ -111,6 +111,5 @@ declare function enhanceUserPrompt(opts: EnhanceUserPromptOptions): Promise<Enha
  * the call). Each turn is truncated to `maxChars`; at most `maxTurns` are
  * returned. Pure + exported for unit testing.
  */
-declare function recentTextTurns(messages: Message[], maxTurns?: number, maxChars?: number): ConversationTurn[];
-
-export { type ConversationTurn, ENHANCER_SYSTEM_PROMPT, type EnhanceResult, type EnhanceUserPromptOptions, enhanceUserPrompt, gatedEnhancerReasoning, normalizedEqual, recentTextTurns, shouldEnhance };
+export declare function recentTextTurns(messages: Message[], maxTurns?: number, maxChars?: number): ConversationTurn[];
+//# sourceMappingURL=prompt-enhancer.d.ts.map

package/dist/execution/prompt-enhancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-enhancer.d.ts","sourceRoot":"","sources":["../../src/execution/prompt-enhancer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EACV,QAAQ,EACR,eAAe,EAEf,gBAAgB,EAEjB,MAAM,sBAAsB,CAAC;AAI9B;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,sBAAsB,QAAuD,CAAC;AAM3F;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUnD;AAoBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,eAAe,GAAG,SAAS,GAC9B,gBAAgB,GAAG,SAAS,CAU9B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAG7D;AAED,oEAAoE;AACpE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,gBAAgB,EAAE,GAAG,SAAS,CAAC;IACzC,2DAA2D;IAC3D,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACzC;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAClD;AAmBD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA8E/B;AAYD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,OAAO,EAAE,EACnB,QAAQ,SAAI,EACZ,QAAQ,SAAO,GACd,gBAAgB,EAAE,CAapB"}

package/dist/execution/prompt-enhancer.js

@@ -1,7 +1,3 @@
-import { readFileSync, statSync } from 'fs';
-import * as path from 'path';
-import { fileURLToPath } from 'url';
-
 // src/types/blocks.ts
 function isTextBlock(b) {
   return b.type === "text";
@@ -11,6 +7,11 @@ function isTextBlock(b) {
 function toErrorMessage(err) {
   return err instanceof Error ? err.message : String(err);
 }
+
+// src/utils/instruction-file.ts
+import { readFileSync, statSync } from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
 var textCache = /* @__PURE__ */ new Map();
 var rootCandidates;
 function readBundledInstructionText(relativePath) {
@@ -165,7 +166,12 @@ function recentTextTurns(messages, maxTurns = 6, maxChars = 1500) {
   }
   return turns;
 }
-
-export { ENHANCER_SYSTEM_PROMPT, enhanceUserPrompt, gatedEnhancerReasoning, normalizedEqual, recentTextTurns, shouldEnhance };
+export {
+  ENHANCER_SYSTEM_PROMPT,
+  enhanceUserPrompt,
+  gatedEnhancerReasoning,
+  normalizedEqual,
+  recentTextTurns,
+  shouldEnhance
+};
 //# sourceMappingURL=prompt-enhancer.js.map
-//# sourceMappingURL=prompt-enhancer.js.map

package/dist/execution/prompt-enhancer.js.map

@@ -1 +1,7 @@
-{"version":3,"sources":["../../src/types/blocks.ts","../../src/utils/error.ts","../../src/utils/instruction-file.ts","../../src/execution/prompt-enhancer.ts"],"names":[],"mappings":"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","file":"prompt-enhancer.js","sourcesContent":["export interface TextBlock {\n  type: 'text';\n  text: string;\n  cache_control?: { type: 'ephemeral' | undefined };\n}\n\nexport interface ToolUseBlock {\n  type: 'tool_use';\n  id: string;\n  name: string;\n  input: Record<string, unknown>;\n  /**\n   * Provider-specific opaque metadata captured from the wire response.\n   * Echoed back verbatim in the next request so providers that bind\n   * extra state to function calls keep working. Example: Gemini's\n   * `thoughtSignature` — required for tool-use turns with thinking\n   * models, otherwise the next request fails with 400 \"Function call\n   * is missing a thought_signature in functionCall parts\".\n   *\n   * Keys are namespaced by intent so multiple wires can coexist:\n   *   - `google.thoughtSignature` — Gemini signed-thought blob\n   * Other providers can add their own keys without colliding.\n   */\n  providerMeta?: Record<string, unknown>;\n}\n\nexport interface ToolResultBlock {\n  type: 'tool_result';\n  tool_use_id: string;\n  /**\n   * The original tool name. Useful for providers like Google Gemini that\n   * need the tool name in `functionResponse.name` — the tool_use_id is\n   * only a session-local identifier and is not stable across replays.\n   * Always set by ToolExecutor; may be absent on manually-constructed blocks.\n   */\n  name?: string | undefined;\n  content: string;\n  is_error?: boolean | undefined;\n}\n\nexport interface ImageBlock {\n  type: 'image';\n  source: {\n    type: 'base64' | 'url';\n    media_type?: string | undefined;\n    data?: string | undefined;\n    url?: string | undefined;\n  };\n}\n\n/**\n * Chain-of-thought / extended-thinking content emitted by the model.\n *\n * Both Anthropic extended thinking (`{type:'thinking', thinking, signature}`)\n * and DeepSeek reasoning mode (top-level `reasoning_content` on the assistant\n * message) require this content to be echoed back verbatim on the next\n * request, otherwise the provider returns 400:\n *   - Anthropic: \"The `content[].thinking` in the thinking mode must be passed back\"\n *   - DeepSeek:  \"The `reasoning_content` in the thinking mode must be passed back\"\n *\n * `signature` is Anthropic-specific (an opaque integrity blob). DeepSeek\n * doesn't issue a signature — the field is absent for that provider.\n *\n * Per Anthropic, thinking blocks MUST appear before any text/tool_use blocks\n * in an assistant message. Stream builders preserve that order.\n */\nexport interface ThinkingBlock {\n  type: 'thinking';\n  thinking: string;\n  signature?: string | undefined;\n  providerMeta?: Record<string, unknown>;\n}\n\nexport type ContentBlock = TextBlock | ToolUseBlock | ToolResultBlock | ImageBlock | ThinkingBlock;\n\nexport function isTextBlock(b: ContentBlock): b is TextBlock {\n  return b.type === 'text';\n}\nexport function isToolUseBlock(b: ContentBlock): b is ToolUseBlock {\n  return b.type === 'tool_use';\n}\nexport function isToolResultBlock(b: ContentBlock): b is ToolResultBlock {\n  return b.type === 'tool_result';\n}\nexport function isImageBlock(b: ContentBlock): b is ImageBlock {\n  return b.type === 'image';\n}\n","/**\n * Converts an unknown error value to a human-readable string.\n * Used in 40+ files across the codebase to normalize error messaging.\n */\nexport function toErrorMessage(err: unknown): string {\n  return err instanceof Error ? err.message : String(err);\n}\n","import { readFileSync, statSync } from 'node:fs';\nimport * as path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\n/**\n * Cache of resolved instruction text, keyed by the relative path. Bundled\n * instruction files are immutable for the process lifetime, so re-reading them\n * on every call (some callers do so per LLM request) is wasted disk I/O.\n */\nconst textCache = new Map<string, string>();\n\n/** Resolved once — the candidate roots only depend on this module's location. */\nlet rootCandidates: string[] | undefined;\n\nexport function readBundledInstructionText(relativePath: string): string {\n  const cached = textCache.get(relativePath);\n  if (cached !== undefined) return cached;\n\n  let resolved = '';\n  for (const root of instructionRootCandidates()) {\n    try {\n      resolved = readFileSync(path.join(root, relativePath), 'utf8').trimEnd();\n      break;\n    } catch {\n      // try next candidate\n    }\n  }\n  textCache.set(relativePath, resolved);\n  return resolved;\n}\n\nexport function renderInstructionTemplate(\n  template: string,\n  values: Record<string, string>,\n): string {\n  return template.replace(/\\{\\{\\s*([a-zA-Z0-9_.-]+)\\s*\\}\\}/g, (match, key: string) =>\n    Object.hasOwn(values, key) ? (values[key] ?? '') : match,\n  );\n}\n\nfunction instructionRootCandidates(): string[] {\n  if (rootCandidates !== undefined) return rootCandidates;\n  const here = path.dirname(fileURLToPath(import.meta.url));\n  const candidates = [\n    path.resolve(here, '../../instructions'),\n    path.resolve(here, '../instructions'),\n    path.resolve(here, 'instructions'),\n  ];\n  rootCandidates = candidates.sort((a, b) => Number(!isDirectory(a)) - Number(!isDirectory(b)));\n  return rootCandidates;\n}\n\nfunction isDirectory(candidate: string): boolean {\n  try {\n    return statSync(candidate).isDirectory();\n  } catch {\n    return false;\n  }\n}\n","import type { ContentBlock } from '../types/blocks.js';\nimport { isTextBlock } from '../types/blocks.js';\nimport type { Message } from '../types/messages.js';\nimport type {\n  Provider,\n  ReasoningConfig,\n  ReasoningEffort,\n  ReasoningRequest,\n  Request,\n} from '../types/provider.js';\nimport { toErrorMessage } from '../utils/error.js';\nimport { readBundledInstructionText } from '../utils/instruction-file.js';\n\n/**\n * Prompt refinement (\"did you mean this?\").\n *\n * Runs a one-shot LLM call in a SEPARATE context (its own system prompt, no\n * conversation history, no tools) that rewrites a raw user message into a\n * clearer, more complete instruction BEFORE the main agent sees it. The goal\n * is to make the main context start from a well-understood request rather than\n * guessing intent from terse input like \"fix the bug\".\n *\n * This mirrors `IntelligentCompactor.callSummarizer` — a plain\n * `provider.complete()` with a dedicated system prompt — and is deliberately\n * free of React / TUI dependencies so it can be unit-tested in isolation.\n */\n\nexport const ENHANCER_SYSTEM_PROMPT = readBundledInstructionText('llm/prompt-enhancer.md');\n\n/** Words/phrases that are control answers, not refinable requests. */\nconst AFFIRMATION_RE =\n  /^(y|n|yes|no|yep|nope|ok|okay|sure|go|go ahead|continue|proceed|stop|cancel|done|next|skip|retry|again|please do|do it)\\b[.! ]*$/i;\n\n/**\n * Heuristic gate: should this raw input be sent through the refiner at all?\n * Pure + exported for unit testing. Returns false for inputs where refinement\n * is pointless or unwanted (slash commands, one-word affirmations, trivially\n * short text, bare numbers).\n */\nexport function shouldEnhance(text: string): boolean {\n  const t = text.trim();\n  if (!t) return false;\n  if (t.startsWith('/')) return false; // slash command\n  if (t.length < 12) return false; // too short to be worth refining\n  if (AFFIRMATION_RE.test(t)) return false; // \"yes\" / \"continue\" / ...\n  if (/^[\\d\\s.,]+$/.test(t)) return false; // bare numbers (menu picks, etc.)\n  const words = t.split(/\\s+/).filter(Boolean);\n  if (words.length < 3) return false; // 1–2 words rarely benefit\n  return true;\n}\n\n/**\n * Preference order when picking an effort level: the cheapest level that still\n * does SOME reasoning first ('low', then 'minimal'), then up the ladder, with\n * fully-off ('none') last so it's only chosen when it's the sole advertised\n * option. This keeps the refiner cheap without dropping reasoning entirely when\n * a little still helps. 'low' leads because it's the most widely accepted low\n * level across adapters (e.g. OpenAI's reasoning_effort set).\n */\nconst EFFORT_PREFERENCE: ReasoningEffort[] = [\n  'low',\n  'minimal',\n  'medium',\n  'high',\n  'xhigh',\n  'max',\n  'none',\n];\n\n/**\n * Build a reasoning directive for the refiner that minimizes wasted thinking,\n * gated to what the model actually accepts. Refinement is a shallow rewrite\n * task — extended thinking adds latency and (hidden) token cost for little\n * gain — so we ask the model to spend as little reasoning as it safely can.\n *\n * The gating mirrors `resolveReasoningForRequest` so we never send a field the\n * model would reject:\n *   - effort-capable model      → its lowest advertised effort level;\n *   - else disable-capable model → disable thinking (`enabled: false`);\n *   - else (always-on / unknown) → `undefined` (leave the provider default).\n *\n * Returns `undefined` whenever nothing can be safely reduced. Callers forward\n * that verbatim to `enhanceUserPrompt`, which then sends no reasoning field —\n * identical to the behavior before this hint existed. Pure + exported for unit\n * testing.\n */\nexport function gatedEnhancerReasoning(\n  rc: ReasoningConfig | undefined,\n): ReasoningRequest | undefined {\n  // Capabilities unknown → don't risk an unsupported field (matches the\n  // conservative \"capabilities unknown\" branch in resolveReasoningForRequest).\n  if (!rc) return undefined;\n  if (rc.effortSupported && rc.effortLevels.length > 0) {\n    const lowest = EFFORT_PREFERENCE.find((e) => rc.effortLevels.includes(e)) ?? rc.effortLevels[0];\n    if (lowest) return { effort: lowest };\n  }\n  if (rc.disableSupported) return { enabled: false };\n  return undefined;\n}\n\n/**\n * Normalize for \"did the refiner actually change anything?\" comparison —\n * collapse whitespace and lowercase so trivial reformatting doesn't trigger\n * the confirmation panel.\n */\nexport function normalizedEqual(a: string, b: string): boolean {\n  const norm = (s: string) => s.trim().replace(/\\s+/g, ' ').toLowerCase();\n  return norm(a) === norm(b);\n}\n\n/** A single text-only conversation turn used as refiner context. */\nexport interface ConversationTurn {\n  role: 'user' | 'assistant';\n  text: string;\n}\n\n/**\n * Result of a successful prompt refinement. Carries the original-language and\n * English versions so the UI can offer both. When the input was already in\n * English the refiner emits a single version and both fields hold the same\n * text (the UI then offers two identical choices, which is correct).\n */\nexport interface EnhanceResult {\n  /** Refined in the user's original language. */\n  refined: string;\n  /** Refined in English. Equals `refined` when the input was already English. */\n  english: string;\n}\n\nexport interface EnhanceUserPromptOptions {\n  provider: Provider;\n  model: string;\n  text: string;\n  /**\n   * Recent conversation turns (oldest→newest), text only, used purely as\n   * CONTEXT so the refiner can resolve references in a follow-up message\n   * (\"it\", \"the same\", \"that file\"). Without this, the refiner is blind to\n   * the conversation and can only refine self-contained prompts. Build with\n   * `recentTextTurns(ctx.messages)`.\n   */\n  history?: ConversationTurn[] | undefined;\n  /** Parent abort signal (e.g. the run controller / Esc). */\n  signal?: AbortSignal | undefined;\n  /** Hard cap on how long to wait for the refiner before giving up. Default 90s. */\n  timeoutMs?: number | undefined;\n  /** Max tokens for the refined output. Default 2048. */\n  maxTokens?: number | undefined;\n  /**\n   * Reasoning directive for the refiner call. Refinement is a shallow\n   * restate-this-more-clearly task that does not benefit from extended\n   * thinking, so callers pass a low-effort / thinking-disabled hint here to\n   * cut latency and (hidden) reasoning-token cost — most impactful on slow\n   * reasoning models. Build it with `gatedEnhancerReasoning(rc)` so the field\n   * is gated to what the model accepts. Omit (undefined) to send no reasoning\n   * directive at all (the provider's own default applies).\n   */\n  reasoning?: ReasoningRequest | undefined;\n  /**\n   * Called with a short reason when refinement fails (provider error, timeout,\n   * empty response). NOT called when the caller cancels via `signal`. Lets the\n   * UI surface *why* a refine fell through instead of a generic message.\n   */\n  onError?: ((reason: string) => void) | undefined;\n}\n\n/**\n * Compose the single user message sent to the refiner: the recent\n * conversation embedded as plain text (so we never trip provider\n * role-alternation rules) followed by the latest message to refine.\n */\nfunction buildRefinerInput(text: string, history?: ConversationTurn[]): string {\n  if (!history || history.length === 0) return text;\n  const lines = history.map((t) => `${t.role === 'user' ? 'User' : 'Assistant'}: ${t.text}`);\n  return [\n    'Recent conversation (context only — do not act on it):',\n    ...lines,\n    '',\n    'Latest message to refine:',\n    text,\n  ].join('\\n');\n}\n\n/**\n * Refine a raw user prompt. Returns the refined text, or `null` when the\n * caller should fall back to the original (refiner errored, timed out, was\n * aborted, or returned nothing useful). NEVER throws — refinement is a\n * best-effort convenience and must never block the user from sending.\n */\nexport async function enhanceUserPrompt(\n  opts: EnhanceUserPromptOptions,\n): Promise<EnhanceResult | null> {\n  const { provider, model, text } = opts;\n  // Reasoning models (\"thinking\" models like DeepSeek reasoner / o1) take\n  // longer to first token, so give a generous default window.\n  const timeoutMs = opts.timeoutMs ?? 90000;\n  // Generous default: on some endpoints the model's hidden \"thinking\" tokens\n  // count against this budget, so a small cap can leave NO room for the actual\n  // refined text (→ empty completion → null). 2048 keeps the output room ample.\n  const maxTokens = opts.maxTokens ?? 2048;\n\n  const req: Request = {\n    model,\n    system: [{ type: 'text', text: ENHANCER_SYSTEM_PROMPT }],\n    messages: [{ role: 'user', content: buildRefinerInput(text, opts.history) }],\n    maxTokens,\n    // NOTE: deliberately NO `temperature`. The main agent loop never sets it,\n    // and reasoning models (DeepSeek reasoner, o1/o3, …) return HTTP 400 when\n    // `temperature` is present — which would make every refine call fail and\n    // silently fall back to the original (no panel shown).\n    //\n    // A reasoning hint is forwarded ONLY when the caller supplies one (it must\n    // already be gated to the model's advertised support — see\n    // `gatedEnhancerReasoning`). Absent it, no reasoning field is sent, which\n    // is identical to the original behavior.\n    ...(opts.reasoning ? { reasoning: opts.reasoning } : {}),\n  };\n\n  // Link a local timeout to the parent signal so a stuck provider call can't\n  // hang the submit path. AbortSignal.any keeps both cancellation sources.\n  const timer = new AbortController();\n  const to = setTimeout(() => timer.abort(new Error('enhancer timeout')), timeoutMs);\n  const signal = opts.signal ? AbortSignal.any([opts.signal, timer.signal]) : timer.signal;\n\n  try {\n    const res = await provider.complete(req, { signal });\n    const raw = res.content\n      .filter(isTextBlock)\n      .map((b) => b.text)\n      .join('\\n')\n      .trim();\n    if (!raw) {\n      opts.onError?.('model returned no text');\n      return null;\n    }\n\n    // English input → ONE version (no \"---\"); other languages → two versions\n    // separated by a line with only \"---\". Split on the first occurrence so the\n    // delimiter can still appear inside the second version's text.\n    const sepIdx = raw.indexOf('\\n---\\n');\n    if (sepIdx === -1) {\n      // Single version: the input was already English (or the model chose not\n      // to translate). Use it for both fields — the UI offers identical\n      // \"refined\" / \"english\" options, which is correct and saves the model\n      // from generating a redundant second copy. NOT an error.\n      return { refined: raw, english: raw };\n    }\n    const refined = raw.slice(0, sepIdx).trim();\n    const english = raw.slice(sepIdx + 5).trim(); // skip \"\\n---\\n\"\n    if (!refined || !english) {\n      opts.onError?.('one or both versions empty');\n      return null;\n    }\n    return { refined, english };\n  } catch (err) {\n    // User-initiated cancel → stay silent (they chose to send the original).\n    if (opts.signal?.aborted) return null;\n    if (timer.signal.aborted) {\n      opts.onError?.(`timed out after ${Math.round(timeoutMs / 1000)}s`);\n      return null;\n    }\n    opts.onError?.(toErrorMessage(err));\n    return null;\n  } finally {\n    // Idempotent — abort() after signal already fired is a no-op, so this is\n    // always safe regardless of whether the timeout fired first.\n    timer.abort();\n    clearTimeout(to);\n  }\n}\n\n/** Pull the visible text out of a message's content (ignores tool blocks). */\nfunction messageText(content: string | ContentBlock[]): string {\n  if (typeof content === 'string') return content;\n  return content\n    .filter(isTextBlock)\n    .map((b) => b.text)\n    .join('\\n')\n    .trim();\n}\n\n/**\n * Extract the last few user/assistant TEXT turns from a conversation, newest\n * last, for use as refiner context. Skips system messages and tool-only turns\n * (tool_use / tool_result carry no useful natural-language context and bloat\n * the call). Each turn is truncated to `maxChars`; at most `maxTurns` are\n * returned. Pure + exported for unit testing.\n */\nexport function recentTextTurns(\n  messages: Message[],\n  maxTurns = 6,\n  maxChars = 1500,\n): ConversationTurn[] {\n  const turns: ConversationTurn[] = [];\n  for (let i = messages.length - 1; i >= 0 && turns.length < maxTurns; i--) {\n    const m = messages[i];\n    if (!m || (m.role !== 'user' && m.role !== 'assistant')) continue;\n    const text = messageText(m.content);\n    if (!text) continue;\n    turns.unshift({\n      role: m.role,\n      text: text.length > maxChars ? `${text.slice(0, maxChars - 1)}…` : text,\n    });\n  }\n  return turns;\n}\n"]}
+{
+  "version": 3,
+  "sources": ["../../src/types/blocks.ts", "../../src/utils/error.ts", "../../src/utils/instruction-file.ts", "../../src/execution/prompt-enhancer.ts"],
+  "sourcesContent": ["export interface TextBlock {\n  type: 'text';\n  text: string;\n  cache_control?: { type: 'ephemeral' | undefined };\n}\n\nexport interface ToolUseBlock {\n  type: 'tool_use';\n  id: string;\n  name: string;\n  input: Record<string, unknown>;\n  /**\n   * Provider-specific opaque metadata captured from the wire response.\n   * Echoed back verbatim in the next request so providers that bind\n   * extra state to function calls keep working. Example: Gemini's\n   * `thoughtSignature` \u2014 required for tool-use turns with thinking\n   * models, otherwise the next request fails with 400 \"Function call\n   * is missing a thought_signature in functionCall parts\".\n   *\n   * Keys are namespaced by intent so multiple wires can coexist:\n   *   - `google.thoughtSignature` \u2014 Gemini signed-thought blob\n   * Other providers can add their own keys without colliding.\n   */\n  providerMeta?: Record<string, unknown>;\n}\n\nexport interface ToolResultBlock {\n  type: 'tool_result';\n  tool_use_id: string;\n  /**\n   * The original tool name. Useful for providers like Google Gemini that\n   * need the tool name in `functionResponse.name` \u2014 the tool_use_id is\n   * only a session-local identifier and is not stable across replays.\n   * Always set by ToolExecutor; may be absent on manually-constructed blocks.\n   */\n  name?: string | undefined;\n  content: string;\n  is_error?: boolean | undefined;\n}\n\nexport interface ImageBlock {\n  type: 'image';\n  source: {\n    type: 'base64' | 'url';\n    media_type?: string | undefined;\n    data?: string | undefined;\n    url?: string | undefined;\n  };\n}\n\n/**\n * Chain-of-thought / extended-thinking content emitted by the model.\n *\n * Both Anthropic extended thinking (`{type:'thinking', thinking, signature}`)\n * and DeepSeek reasoning mode (top-level `reasoning_content` on the assistant\n * message) require this content to be echoed back verbatim on the next\n * request, otherwise the provider returns 400:\n *   - Anthropic: \"The `content[].thinking` in the thinking mode must be passed back\"\n *   - DeepSeek:  \"The `reasoning_content` in the thinking mode must be passed back\"\n *\n * `signature` is Anthropic-specific (an opaque integrity blob). DeepSeek\n * doesn't issue a signature \u2014 the field is absent for that provider.\n *\n * Per Anthropic, thinking blocks MUST appear before any text/tool_use blocks\n * in an assistant message. Stream builders preserve that order.\n */\nexport interface ThinkingBlock {\n  type: 'thinking';\n  thinking: string;\n  signature?: string | undefined;\n  providerMeta?: Record<string, unknown>;\n}\n\nexport type ContentBlock = TextBlock | ToolUseBlock | ToolResultBlock | ImageBlock | ThinkingBlock;\n\nexport function isTextBlock(b: ContentBlock): b is TextBlock {\n  return b.type === 'text';\n}\nexport function isToolUseBlock(b: ContentBlock): b is ToolUseBlock {\n  return b.type === 'tool_use';\n}\nexport function isToolResultBlock(b: ContentBlock): b is ToolResultBlock {\n  return b.type === 'tool_result';\n}\nexport function isImageBlock(b: ContentBlock): b is ImageBlock {\n  return b.type === 'image';\n}\n", "/**\n * Converts an unknown error value to a human-readable string.\n * Used in 40+ files across the codebase to normalize error messaging.\n */\nexport function toErrorMessage(err: unknown): string {\n  return err instanceof Error ? err.message : String(err);\n}\n", "import { readFileSync, statSync } from 'node:fs';\nimport * as path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\n/**\n * Cache of resolved instruction text, keyed by the relative path. Bundled\n * instruction files are immutable for the process lifetime, so re-reading them\n * on every call (some callers do so per LLM request) is wasted disk I/O.\n */\nconst textCache = new Map<string, string>();\n\n/** Resolved once \u2014 the candidate roots only depend on this module's location. */\nlet rootCandidates: string[] | undefined;\n\nexport function readBundledInstructionText(relativePath: string): string {\n  const cached = textCache.get(relativePath);\n  if (cached !== undefined) return cached;\n\n  let resolved = '';\n  for (const root of instructionRootCandidates()) {\n    try {\n      resolved = readFileSync(path.join(root, relativePath), 'utf8').trimEnd();\n      break;\n    } catch {\n      // try next candidate\n    }\n  }\n  textCache.set(relativePath, resolved);\n  return resolved;\n}\n\nexport function renderInstructionTemplate(\n  template: string,\n  values: Record<string, string>,\n): string {\n  return template.replace(/\\{\\{\\s*([a-zA-Z0-9_.-]+)\\s*\\}\\}/g, (match, key: string) =>\n    Object.hasOwn(values, key) ? (values[key] ?? '') : match,\n  );\n}\n\nfunction instructionRootCandidates(): string[] {\n  if (rootCandidates !== undefined) return rootCandidates;\n  const here = path.dirname(fileURLToPath(import.meta.url));\n  const candidates = [\n    path.resolve(here, '../../instructions'),\n    path.resolve(here, '../instructions'),\n    path.resolve(here, 'instructions'),\n  ];\n  rootCandidates = candidates.sort((a, b) => Number(!isDirectory(a)) - Number(!isDirectory(b)));\n  return rootCandidates;\n}\n\nfunction isDirectory(candidate: string): boolean {\n  try {\n    return statSync(candidate).isDirectory();\n  } catch {\n    return false;\n  }\n}\n", "import type { ContentBlock } from '../types/blocks.js';\nimport { isTextBlock } from '../types/blocks.js';\nimport type { Message } from '../types/messages.js';\nimport type {\n  Provider,\n  ReasoningConfig,\n  ReasoningEffort,\n  ReasoningRequest,\n  Request,\n} from '../types/provider.js';\nimport { toErrorMessage } from '../utils/error.js';\nimport { readBundledInstructionText } from '../utils/instruction-file.js';\n\n/**\n * Prompt refinement (\"did you mean this?\").\n *\n * Runs a one-shot LLM call in a SEPARATE context (its own system prompt, no\n * conversation history, no tools) that rewrites a raw user message into a\n * clearer, more complete instruction BEFORE the main agent sees it. The goal\n * is to make the main context start from a well-understood request rather than\n * guessing intent from terse input like \"fix the bug\".\n *\n * This mirrors `IntelligentCompactor.callSummarizer` \u2014 a plain\n * `provider.complete()` with a dedicated system prompt \u2014 and is deliberately\n * free of React / TUI dependencies so it can be unit-tested in isolation.\n */\n\nexport const ENHANCER_SYSTEM_PROMPT = readBundledInstructionText('llm/prompt-enhancer.md');\n\n/** Words/phrases that are control answers, not refinable requests. */\nconst AFFIRMATION_RE =\n  /^(y|n|yes|no|yep|nope|ok|okay|sure|go|go ahead|continue|proceed|stop|cancel|done|next|skip|retry|again|please do|do it)\\b[.! ]*$/i;\n\n/**\n * Heuristic gate: should this raw input be sent through the refiner at all?\n * Pure + exported for unit testing. Returns false for inputs where refinement\n * is pointless or unwanted (slash commands, one-word affirmations, trivially\n * short text, bare numbers).\n */\nexport function shouldEnhance(text: string): boolean {\n  const t = text.trim();\n  if (!t) return false;\n  if (t.startsWith('/')) return false; // slash command\n  if (t.length < 12) return false; // too short to be worth refining\n  if (AFFIRMATION_RE.test(t)) return false; // \"yes\" / \"continue\" / ...\n  if (/^[\\d\\s.,]+$/.test(t)) return false; // bare numbers (menu picks, etc.)\n  const words = t.split(/\\s+/).filter(Boolean);\n  if (words.length < 3) return false; // 1\u20132 words rarely benefit\n  return true;\n}\n\n/**\n * Preference order when picking an effort level: the cheapest level that still\n * does SOME reasoning first ('low', then 'minimal'), then up the ladder, with\n * fully-off ('none') last so it's only chosen when it's the sole advertised\n * option. This keeps the refiner cheap without dropping reasoning entirely when\n * a little still helps. 'low' leads because it's the most widely accepted low\n * level across adapters (e.g. OpenAI's reasoning_effort set).\n */\nconst EFFORT_PREFERENCE: ReasoningEffort[] = [\n  'low',\n  'minimal',\n  'medium',\n  'high',\n  'xhigh',\n  'max',\n  'none',\n];\n\n/**\n * Build a reasoning directive for the refiner that minimizes wasted thinking,\n * gated to what the model actually accepts. Refinement is a shallow rewrite\n * task \u2014 extended thinking adds latency and (hidden) token cost for little\n * gain \u2014 so we ask the model to spend as little reasoning as it safely can.\n *\n * The gating mirrors `resolveReasoningForRequest` so we never send a field the\n * model would reject:\n *   - effort-capable model      \u2192 its lowest advertised effort level;\n *   - else disable-capable model \u2192 disable thinking (`enabled: false`);\n *   - else (always-on / unknown) \u2192 `undefined` (leave the provider default).\n *\n * Returns `undefined` whenever nothing can be safely reduced. Callers forward\n * that verbatim to `enhanceUserPrompt`, which then sends no reasoning field \u2014\n * identical to the behavior before this hint existed. Pure + exported for unit\n * testing.\n */\nexport function gatedEnhancerReasoning(\n  rc: ReasoningConfig | undefined,\n): ReasoningRequest | undefined {\n  // Capabilities unknown \u2192 don't risk an unsupported field (matches the\n  // conservative \"capabilities unknown\" branch in resolveReasoningForRequest).\n  if (!rc) return undefined;\n  if (rc.effortSupported && rc.effortLevels.length > 0) {\n    const lowest = EFFORT_PREFERENCE.find((e) => rc.effortLevels.includes(e)) ?? rc.effortLevels[0];\n    if (lowest) return { effort: lowest };\n  }\n  if (rc.disableSupported) return { enabled: false };\n  return undefined;\n}\n\n/**\n * Normalize for \"did the refiner actually change anything?\" comparison \u2014\n * collapse whitespace and lowercase so trivial reformatting doesn't trigger\n * the confirmation panel.\n */\nexport function normalizedEqual(a: string, b: string): boolean {\n  const norm = (s: string) => s.trim().replace(/\\s+/g, ' ').toLowerCase();\n  return norm(a) === norm(b);\n}\n\n/** A single text-only conversation turn used as refiner context. */\nexport interface ConversationTurn {\n  role: 'user' | 'assistant';\n  text: string;\n}\n\n/**\n * Result of a successful prompt refinement. Carries the original-language and\n * English versions so the UI can offer both. When the input was already in\n * English the refiner emits a single version and both fields hold the same\n * text (the UI then offers two identical choices, which is correct).\n */\nexport interface EnhanceResult {\n  /** Refined in the user's original language. */\n  refined: string;\n  /** Refined in English. Equals `refined` when the input was already English. */\n  english: string;\n}\n\nexport interface EnhanceUserPromptOptions {\n  provider: Provider;\n  model: string;\n  text: string;\n  /**\n   * Recent conversation turns (oldest\u2192newest), text only, used purely as\n   * CONTEXT so the refiner can resolve references in a follow-up message\n   * (\"it\", \"the same\", \"that file\"). Without this, the refiner is blind to\n   * the conversation and can only refine self-contained prompts. Build with\n   * `recentTextTurns(ctx.messages)`.\n   */\n  history?: ConversationTurn[] | undefined;\n  /** Parent abort signal (e.g. the run controller / Esc). */\n  signal?: AbortSignal | undefined;\n  /** Hard cap on how long to wait for the refiner before giving up. Default 90s. */\n  timeoutMs?: number | undefined;\n  /** Max tokens for the refined output. Default 2048. */\n  maxTokens?: number | undefined;\n  /**\n   * Reasoning directive for the refiner call. Refinement is a shallow\n   * restate-this-more-clearly task that does not benefit from extended\n   * thinking, so callers pass a low-effort / thinking-disabled hint here to\n   * cut latency and (hidden) reasoning-token cost \u2014 most impactful on slow\n   * reasoning models. Build it with `gatedEnhancerReasoning(rc)` so the field\n   * is gated to what the model accepts. Omit (undefined) to send no reasoning\n   * directive at all (the provider's own default applies).\n   */\n  reasoning?: ReasoningRequest | undefined;\n  /**\n   * Called with a short reason when refinement fails (provider error, timeout,\n   * empty response). NOT called when the caller cancels via `signal`. Lets the\n   * UI surface *why* a refine fell through instead of a generic message.\n   */\n  onError?: ((reason: string) => void) | undefined;\n}\n\n/**\n * Compose the single user message sent to the refiner: the recent\n * conversation embedded as plain text (so we never trip provider\n * role-alternation rules) followed by the latest message to refine.\n */\nfunction buildRefinerInput(text: string, history?: ConversationTurn[]): string {\n  if (!history || history.length === 0) return text;\n  const lines = history.map((t) => `${t.role === 'user' ? 'User' : 'Assistant'}: ${t.text}`);\n  return [\n    'Recent conversation (context only \u2014 do not act on it):',\n    ...lines,\n    '',\n    'Latest message to refine:',\n    text,\n  ].join('\\n');\n}\n\n/**\n * Refine a raw user prompt. Returns the refined text, or `null` when the\n * caller should fall back to the original (refiner errored, timed out, was\n * aborted, or returned nothing useful). NEVER throws \u2014 refinement is a\n * best-effort convenience and must never block the user from sending.\n */\nexport async function enhanceUserPrompt(\n  opts: EnhanceUserPromptOptions,\n): Promise<EnhanceResult | null> {\n  const { provider, model, text } = opts;\n  // Reasoning models (\"thinking\" models like DeepSeek reasoner / o1) take\n  // longer to first token, so give a generous default window.\n  const timeoutMs = opts.timeoutMs ?? 90000;\n  // Generous default: on some endpoints the model's hidden \"thinking\" tokens\n  // count against this budget, so a small cap can leave NO room for the actual\n  // refined text (\u2192 empty completion \u2192 null). 2048 keeps the output room ample.\n  const maxTokens = opts.maxTokens ?? 2048;\n\n  const req: Request = {\n    model,\n    system: [{ type: 'text', text: ENHANCER_SYSTEM_PROMPT }],\n    messages: [{ role: 'user', content: buildRefinerInput(text, opts.history) }],\n    maxTokens,\n    // NOTE: deliberately NO `temperature`. The main agent loop never sets it,\n    // and reasoning models (DeepSeek reasoner, o1/o3, \u2026) return HTTP 400 when\n    // `temperature` is present \u2014 which would make every refine call fail and\n    // silently fall back to the original (no panel shown).\n    //\n    // A reasoning hint is forwarded ONLY when the caller supplies one (it must\n    // already be gated to the model's advertised support \u2014 see\n    // `gatedEnhancerReasoning`). Absent it, no reasoning field is sent, which\n    // is identical to the original behavior.\n    ...(opts.reasoning ? { reasoning: opts.reasoning } : {}),\n  };\n\n  // Link a local timeout to the parent signal so a stuck provider call can't\n  // hang the submit path. AbortSignal.any keeps both cancellation sources.\n  const timer = new AbortController();\n  const to = setTimeout(() => timer.abort(new Error('enhancer timeout')), timeoutMs);\n  const signal = opts.signal ? AbortSignal.any([opts.signal, timer.signal]) : timer.signal;\n\n  try {\n    const res = await provider.complete(req, { signal });\n    const raw = res.content\n      .filter(isTextBlock)\n      .map((b) => b.text)\n      .join('\\n')\n      .trim();\n    if (!raw) {\n      opts.onError?.('model returned no text');\n      return null;\n    }\n\n    // English input \u2192 ONE version (no \"---\"); other languages \u2192 two versions\n    // separated by a line with only \"---\". Split on the first occurrence so the\n    // delimiter can still appear inside the second version's text.\n    const sepIdx = raw.indexOf('\\n---\\n');\n    if (sepIdx === -1) {\n      // Single version: the input was already English (or the model chose not\n      // to translate). Use it for both fields \u2014 the UI offers identical\n      // \"refined\" / \"english\" options, which is correct and saves the model\n      // from generating a redundant second copy. NOT an error.\n      return { refined: raw, english: raw };\n    }\n    const refined = raw.slice(0, sepIdx).trim();\n    const english = raw.slice(sepIdx + 5).trim(); // skip \"\\n---\\n\"\n    if (!refined || !english) {\n      opts.onError?.('one or both versions empty');\n      return null;\n    }\n    return { refined, english };\n  } catch (err) {\n    // User-initiated cancel \u2192 stay silent (they chose to send the original).\n    if (opts.signal?.aborted) return null;\n    if (timer.signal.aborted) {\n      opts.onError?.(`timed out after ${Math.round(timeoutMs / 1000)}s`);\n      return null;\n    }\n    opts.onError?.(toErrorMessage(err));\n    return null;\n  } finally {\n    // Idempotent \u2014 abort() after signal already fired is a no-op, so this is\n    // always safe regardless of whether the timeout fired first.\n    timer.abort();\n    clearTimeout(to);\n  }\n}\n\n/** Pull the visible text out of a message's content (ignores tool blocks). */\nfunction messageText(content: string | ContentBlock[]): string {\n  if (typeof content === 'string') return content;\n  return content\n    .filter(isTextBlock)\n    .map((b) => b.text)\n    .join('\\n')\n    .trim();\n}\n\n/**\n * Extract the last few user/assistant TEXT turns from a conversation, newest\n * last, for use as refiner context. Skips system messages and tool-only turns\n * (tool_use / tool_result carry no useful natural-language context and bloat\n * the call). Each turn is truncated to `maxChars`; at most `maxTurns` are\n * returned. Pure + exported for unit testing.\n */\nexport function recentTextTurns(\n  messages: Message[],\n  maxTurns = 6,\n  maxChars = 1500,\n): ConversationTurn[] {\n  const turns: ConversationTurn[] = [];\n  for (let i = messages.length - 1; i >= 0 && turns.length < maxTurns; i--) {\n    const m = messages[i];\n    if (!m || (m.role !== 'user' && m.role !== 'assistant')) continue;\n    const text = messageText(m.content);\n    if (!text) continue;\n    turns.unshift({\n      role: m.role,\n      text: text.length > maxChars ? `${text.slice(0, maxChars - 1)}\u2026` : text,\n    });\n  }\n  return turns;\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/execution/prompt-loader.d.ts

@@ -0,0 +1,52 @@
+import { type PromptCategoryCount, type PromptEntry, type PromptLoader, type PromptSearchOptions } from '../types/prompt.js';
+import type { WstackPaths } from '../utils/wstack-paths.js';
+export interface PromptLoaderOptions {
+    paths: WstackPaths;
+    /** Directory containing the bundled dataset (`data/prompts`), if shipped. */
+    bundledDir?: string | undefined;
+}
+/**
+ * DefaultPromptLoader — read-side view over the three prompt layers, merged and
+ * de-duplicated by `slug`. Mirrors `DefaultSkillLoader`.
+ *
+ * Discovery order (higher priority shadows lower by slug):
+ *   1. Project-committed:  <project>/.wrongstack/prompts/   (writable, source 'project')
+ *   2. User-global:        ~/.wrongstack/prompts/           (writable, source 'user'/'synced')
+ *   3. Bundled with build:  <core>/data/prompts/prompts/**  (read-only, source 'builtin')
+ *
+ * Writes go to the user layer by default (or the project layer when
+ * `scope:'project'`). Favoriting/editing a builtin copies it down into the user
+ * layer (copy-on-write) so the read-only dataset is never mutated.
+ */
+export declare class DefaultPromptLoader implements PromptLoader {
+    private readonly projectStore?;
+    private readonly userStore?;
+    private readonly builtinDir?;
+    private cache?;
+    private builtinCache?;
+    constructor(opts: PromptLoaderOptions);
+    list(): Promise<PromptEntry[]>;
+    find(slugOrId: string): Promise<PromptEntry | undefined>;
+    search(query: string, opts?: PromptSearchOptions): Promise<PromptEntry[]>;
+    categories(): Promise<PromptCategoryCount[]>;
+    save(entry: PromptEntry, opts?: {
+        scope?: 'user' | 'project';
+    }): Promise<void>;
+    delete(slugOrId: string): Promise<boolean>;
+    setFavorite(slugOrId: string, favorite: boolean): Promise<PromptEntry | undefined>;
+    invalidateCache(): void;
+    private readBuiltin;
+}
+/**
+ * Fill a prompt's `{{variable}}` placeholders with `values`. Unknown
+ * placeholders are left intact unless a declared variable supplies a `default`.
+ * Returns the rendered string, any required variables left unfilled
+ * (`missing`), and any supplied values outside a variable's declared `enum`
+ * (`invalid`).
+ */
+export declare function renderPrompt(entry: PromptEntry, values?: Record<string, string>): {
+    text: string;
+    missing: string[];
+    invalid: string[];
+};
+//# sourceMappingURL=prompt-loader.d.ts.map

package/dist/execution/prompt-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-loader.d.ts","sourceRoot":"","sources":["../../src/execution/prompt-loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,WAAW,CAAC;IACnB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACtD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAiC;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAiC;IAC5D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAqB;IACjD,OAAO,CAAC,KAAK,CAAC,CAA4B;IAC1C,OAAO,CAAC,YAAY,CAAC,CAA4B;IAEjD,YAAY,IAAI,EAAE,mBAAmB,EAYpC;IAEK,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAqBnC;IAEK,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAG7D;IAEK,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,mBAAwB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAiBlF;IAEK,UAAU,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAWjD;IAEK,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBvF;IAEK,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAS/C;IAEK,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CA0BvF;IAED,eAAe,IAAI,IAAI,CAGtB;YAEa,WAAW;CAsB1B;AA+DD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,EAClB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAClC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAsCxD"}

package/dist/execution/provider-runner-impl.d.ts

@@ -0,0 +1,14 @@
+import type { ProviderRunner, RunProviderOptions } from '../types/provider-runner.js';
+import type { Response } from '../types/provider.js';
+/**
+ * Default ProviderRunner — thin adapter over `runProviderWithRetry`.
+ *
+ * This is bound to `TOKENS.ProviderRunner` by the CLI at boot.
+ * Consumers that want to replace the provider calling layer entirely
+ * can bind a different implementation to the same token before
+ * `Agent.run()`.
+ */
+export declare class DefaultProviderRunner implements ProviderRunner {
+    run(opts: RunProviderOptions): Promise<Response>;
+}
+//# sourceMappingURL=provider-runner-impl.d.ts.map