@wrongstack/core 0.287.0 → 0.291.0

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

@@ -39,22 +39,6 @@ export interface IntelligentCompactorOptions {
 /**
  * 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

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

@@ -1 +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;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAY7D;;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;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;CACvD;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;IACtD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAkC;IAEvE,YAAY,IAAI,EAAE,2BAA2B,EAa5C;IAEK,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,GAAE;QAAE,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAmDnG;IAED;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAI3B,2EAA2E;IAC3E,OAAO,CAAC,KAAK;YASC,qBAAqB;YA6CrB,cAAc;IAmD5B,OAAO,CAAC,cAAc;IAgBtB,iEAAiE;IACjE,OAAO,CAAC,iBAAiB;CAe1B"}
+{"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;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAY7D;;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;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;CACvD;AAED;;GAEG;AACH;;;;;;;;;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;IACtD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAkC;IAEvE,YAAY,IAAI,EAAE,2BAA2B,EAa5C;IAEK,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,GAAE;QAAE,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAmDnG;IAED;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAI3B,2EAA2E;IAC3E,OAAO,CAAC,KAAK;YASC,qBAAqB;YA6CrB,cAAc;IAmD5B,OAAO,CAAC,cAAc;IAgBtB,iEAAiE;IACjE,OAAO,CAAC,iBAAiB;CAe1B"}

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

@@ -1 +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"}
+{"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,CAmEtB;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/one-shot-llm.d.ts

@@ -10,7 +10,7 @@ import type { OneShotLLMInput, OneShotLLMResult, OneShotOrchestratorOptions } fr
  *   system: 'You are a helpful assistant.',
  *   userPrompt: 'Summarize this conversation.',
  *   model: 'deepseek-chat',
- *   fallbackProfile: 'summary',
+ *   fallbackModels: ['anthropic/claude-haiku'],
  * });
  * console.log(result.text);
  * ```
@@ -44,9 +44,17 @@ export declare class OneShotOrchestrator {
     private resolveSignal;
     /**
      * Build the fallback model chain from input + config + current target.
+     * The injected {@link OneShotOrchestratorOptions.fallbackProfileManager}
+     * is the only allowed manager — OneShot never owns a private snapshot
+     * so a live `ConfigStore` change reaches every call without rebuilding
+     * the manager.
      */
     private resolveFallbackChain;
     /** Attempt a provider call while preserving the actual failure for callers. */
     private tryCall;
+    /** Build a success result from a provider Response. */
+    private buildResult;
+    /** Build a total-failure error result. */
+    private buildErrorResult;
 }
 //# sourceMappingURL=one-shot-llm.d.ts.map

package/dist/execution/one-shot-llm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"one-shot-llm.d.ts","sourceRoot":"","sources":["../../src/execution/one-shot-llm.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAwB9G;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAElD,YAAY,IAAI,EAAE,0BAA0B,EAE3C;IAED;;;;;OAKG;IACG,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsH5D;IAID;;;OAGG;IACH,OAAO,CAAC,aAAa;IAmCrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA4B5B,+EAA+E;YACjE,OAAO;CAmBtB"}
+{"version":3,"file":"one-shot-llm.d.ts","sourceRoot":"","sources":["../../src/execution/one-shot-llm.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,0BAA0B,EAC3B,MAAM,0BAA0B,CAAC;AAuBlC;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAElD,YAAY,IAAI,EAAE,0BAA0B,EAE3C;IAED;;;;;OAKG;IACG,IAAI,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoI5D;IAID;;;OAGG;IACH,OAAO,CAAC,aAAa;IAmCrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAkBpB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAKrB;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IA4B5B,+EAA+E;YACjE,OAAO;IAgCrB,uDAAuD;IACvD,OAAO,CAAC,WAAW;IA2BnB,0CAA0C;IAC1C,OAAO,CAAC,gBAAgB;CAiBzB"}

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

@@ -1,4 +1,5 @@
 import type { Message } from '../types/messages.js';
+import type { MemoryStore } from '../types/memory.js';
 import type { Provider, ReasoningConfig, ReasoningRequest } from '../types/provider.js';
 import type { OneShotOrchestrator } from './one-shot-llm.js';
 /**
@@ -51,6 +52,24 @@ export interface ConversationTurn {
     role: 'user' | 'assistant';
     text: string;
 }
+/** Additional context the refiner may use to resolve references. */
+export interface RefinerContextSection {
+    title: string;
+    items: string[];
+}
+/**
+ * Minimal structural shape of the live agent context needed to enrich the
+ * refiner. Kept structural so browser/client bundles do not need the Context
+ * class and tests can pass plain objects.
+ */
+export interface RefinerSessionContextLike {
+    projectRoot?: unknown;
+    cwd?: unknown;
+    workingDir?: unknown;
+    readFiles?: unknown;
+    writtenFiles?: unknown;
+    todos?: unknown;
+}
 /**
  * Result of a successful prompt refinement. Carries the original-language and
  * English versions so the UI can offer both. When the input was already in
@@ -73,6 +92,7 @@ export interface EnhanceResult {
  * returns `null` with no `onError` call).
  */
 export type EnhanceFailureKind = 'timeout' | 'empty' | 'provider_error';
+export declare const DEFAULT_REFINER_RETRY_FEEDBACK = "Make another pass that is sharper and more self-contained. Use the provided project memory, current session context, and recent conversation only to resolve references and preserve project vocabulary; keep the original scope unchanged.";
 export interface EnhanceUserPromptOptions {
     provider: Provider;
     model: string;
@@ -85,6 +105,17 @@ export interface EnhanceUserPromptOptions {
      * `recentTextTurns(ctx.messages)`.
      */
     history?: ConversationTurn[] | undefined;
+    /**
+     * Project/session context snippets, already filtered and compacted by the
+     * caller. They are context only: the refiner may use them to resolve
+     * references, names, files, conventions, and constraints, but must not turn
+     * them into extra requirements.
+     */
+    contextSections?: RefinerContextSection[] | undefined;
+    /** Previous refinement when the user asks for another pass. */
+    previousRefinement?: EnhanceResult | undefined;
+    /** Short instruction for a retry pass. Defaults to `DEFAULT_REFINER_RETRY_FEEDBACK`. */
+    retryFeedback?: string | undefined;
     /** Parent abort signal (e.g. the run controller / Esc). */
     signal?: AbortSignal | undefined;
     /** Hard cap on how long to wait for the refiner before giving up. Default 90s. */
@@ -116,6 +147,11 @@ export interface EnhanceUserPromptOptions {
      */
     oneShotOrchestrator?: OneShotOrchestrator | undefined;
 }
+export declare function buildRefinerContextSections(opts: {
+    text: string;
+    memoryStore?: MemoryStore | undefined;
+    context?: RefinerSessionContextLike | undefined;
+}): Promise<RefinerContextSection[]>;
 /**
  * Refine a raw user prompt. Returns the refined text, or `null` when the
  * caller should fall back to the original (refiner errored, timed out, was

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

@@ -1 +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;AAE9B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG7D;;;;;;;;;;;;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;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,OAAO,GAAG,gBAAgB,CAAC;AAExE,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;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC5E;;;OAGG;IACH,mBAAmB,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;CACvD;AAmBD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAgG/B;AAYD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,OAAO,EAAE,EACnB,QAAQ,SAAI,EACZ,QAAQ,SAAO,GACd,gBAAgB,EAAE,CAapB"}
+{"version":3,"file":"prompt-enhancer.d.ts","sourceRoot":"","sources":["../../src/execution/prompt-enhancer.ts"],"names":[],"mappings":"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"}

package/dist/execution/prompt-enhancer.js

@@ -83,25 +83,173 @@ function normalizedEqual(a, b) {
   const norm = (s) => s.trim().replace(/\s+/g, " ").toLowerCase();
   return norm(a) === norm(b);
 }
-function buildRefinerInput(text, history) {
-  if (!history || history.length === 0) return text;
-  const lines = history.map((t) => `${t.role === "user" ? "User" : "Assistant"}: ${t.text}`);
+var DEFAULT_REFINER_RETRY_FEEDBACK = "Make another pass that is sharper and more self-contained. Use the provided project memory, current session context, and recent conversation only to resolve references and preserve project vocabulary; keep the original scope unchanged.";
+function buildRefinerInput(text, history, contextSections, previousRefinement, retryFeedback) {
+  const parts = [];
+  const renderedContext = renderRefinerContextSections(contextSections);
+  if (renderedContext) parts.push(renderedContext);
+  if (previousRefinement || retryFeedback) {
+    const retryLines = [
+      "Retry context (context only - the user asked for another refinement pass):"
+    ];
+    if (previousRefinement?.refined) {
+      retryLines.push(`Previous refined version: ${compactText(previousRefinement.refined, 900)}`);
+    }
+    if (previousRefinement?.english && previousRefinement.english.trim() !== previousRefinement.refined.trim()) {
+      retryLines.push(`Previous English version: ${compactText(previousRefinement.english, 900)}`);
+    }
+    retryLines.push(`Retry instruction: ${retryFeedback ?? DEFAULT_REFINER_RETRY_FEEDBACK}`);
+    parts.push(retryLines.join("\n"));
+  }
+  if (history && history.length > 0) {
+    const lines = history.map((t) => `${t.role === "user" ? "User" : "Assistant"}: ${t.text}`);
+    parts.push(
+      [
+        "Recent conversation (context only - do not act on it):",
+        ...lines
+      ].join("\n")
+    );
+  }
+  if (parts.length === 0) return text;
   return [
-    "Recent conversation (context only \u2014 do not act on it):",
-    ...lines,
+    ...parts,
     "",
     "Latest message to refine:",
     text
-  ].join("\n");
+  ].join("\n\n");
+}
+function renderRefinerContextSections(contextSections) {
+  const sections = (contextSections ?? []).map((section) => ({
+    title: section.title.trim(),
+    items: section.items.map((item) => compactText(item, 360)).filter(Boolean)
+  })).filter((section) => section.title && section.items.length > 0);
+  if (sections.length === 0) return void 0;
+  const lines = [
+    "Additional project/session context (context only - use to resolve references, conventions, and constraints; do not add new requirements):"
+  ];
+  for (const section of sections) {
+    lines.push("", `${section.title}:`);
+    for (const item of section.items) lines.push(`- ${item}`);
+  }
+  return lines.join("\n");
+}
+function compactText(text, maxChars) {
+  const compacted = text.replace(/\s+/g, " ").trim();
+  if (compacted.length <= maxChars) return compacted;
+  return `${compacted.slice(0, Math.max(0, maxChars - 3)).trimEnd()}...`;
+}
+function unknownString(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function iterableStrings(value) {
+  if (!value || typeof value === "string") return [];
+  if (Array.isArray(value)) {
+    return value.flatMap((item) => {
+      const text = unknownString(item);
+      return text ? [text] : [];
+    });
+  }
+  if (value instanceof Set) {
+    return [...value].flatMap((item) => {
+      const text = unknownString(item);
+      return text ? [text] : [];
+    });
+  }
+  if (typeof value === "object" && typeof value[Symbol.iterator] === "function") {
+    try {
+      return Array.from(value).flatMap((item) => {
+        const text = unknownString(item);
+        return text ? [text] : [];
+      });
+    } catch {
+      return [];
+    }
+  }
+  return [];
+}
+function lastItems(values, maxItems) {
+  return values.slice(Math.max(0, values.length - maxItems));
+}
+function todoLines(value, maxItems) {
+  if (!Array.isArray(value)) return [];
+  const open = value.filter((item) => {
+    if (!item || typeof item !== "object") return false;
+    const status = item["status"];
+    return status === "pending" || status === "in_progress";
+  });
+  return open.slice(0, maxItems).flatMap((todo) => {
+    const content = unknownString(todo["activeForm"]) ?? unknownString(todo["content"]);
+    if (!content) return [];
+    return [`open todo (${String(todo["status"])}): ${compactText(content, 220)}`];
+  });
+}
+function buildRefinerSessionContextSection(context) {
+  if (!context) return void 0;
+  const items = [];
+  const projectRoot = unknownString(context.projectRoot);
+  const workingDir = unknownString(context.workingDir) ?? unknownString(context.cwd);
+  if (projectRoot) items.push(`project root: ${projectRoot}`);
+  if (workingDir && workingDir !== projectRoot) items.push(`working dir: ${workingDir}`);
+  for (const file of lastItems(iterableStrings(context.readFiles), 6)) {
+    items.push(`recently read file: ${file}`);
+  }
+  for (const file of lastItems(iterableStrings(context.writtenFiles), 6)) {
+    items.push(`recently written file: ${file}`);
+  }
+  items.push(...todoLines(context.todos, 6));
+  return items.length > 0 ? { title: "Current session state", items } : void 0;
+}
+function formatMemoryEntry(entry) {
+  const meta = [entry.scope, entry.type, entry.priority].filter(Boolean).join("/");
+  const tags = entry.tags && entry.tags.length > 0 ? ` tags: ${entry.tags.slice(0, 5).join(", ")}` : "";
+  return `${meta ? `[${meta}] ` : ""}${compactText(entry.text, 260)}${tags}`;
+}
+async function collectMemoryEntries(memoryStore, text, scope, limit) {
+  const scored = memoryStore.scoreRelevant ? await memoryStore.scoreRelevant({ currentTask: text }, scope, limit).catch(() => []) : [];
+  if (scored.length > 0) return scored;
+  return memoryStore.search(text || "prompt refinement", scope, limit).catch(() => []);
+}
+async function buildRefinerMemoryContextSection(memoryStore, text) {
+  if (!memoryStore) return void 0;
+  const seen = /* @__PURE__ */ new Set();
+  const entries = [];
+  for (const scope of ["project-memory", "user-memory"]) {
+    const remaining = Math.max(0, 6 - entries.length);
+    if (remaining === 0) break;
+    for (const entry of await collectMemoryEntries(memoryStore, text.trim(), scope, remaining)) {
+      const key = `${entry.scope}:${entry.text}`;
+      if (seen.has(key)) continue;
+      seen.add(key);
+      entries.push(entry);
+      if (entries.length >= 6) break;
+    }
+  }
+  if (entries.length === 0) return void 0;
+  return { title: "Relevant project memory", items: entries.map(formatMemoryEntry) };
+}
+async function buildRefinerContextSections(opts) {
+  const sections = [];
+  const memory = await buildRefinerMemoryContextSection(opts.memoryStore, opts.text);
+  if (memory) sections.push(memory);
+  const session = buildRefinerSessionContextSection(opts.context);
+  if (session) sections.push(session);
+  return sections;
 }
 async function enhanceUserPrompt(opts) {
   const { provider, model, text } = opts;
   const timeoutMs = opts.timeoutMs ?? 9e4;
   const maxTokens = opts.maxTokens ?? 2048;
+  const refinerInput = buildRefinerInput(
+    text,
+    opts.history,
+    opts.contextSections,
+    opts.previousRefinement,
+    opts.retryFeedback
+  );
   const req = {
     model,
     system: [{ type: "text", text: ENHANCER_SYSTEM_PROMPT }],
-    messages: [{ role: "user", content: buildRefinerInput(text, opts.history) }],
+    messages: [{ role: "user", content: refinerInput }],
     maxTokens,
     // NOTE: deliberately NO `temperature`. The main agent loop never sets it,
     // and reasoning models (DeepSeek reasoner, o1/o3, …) return HTTP 400 when
@@ -122,9 +270,7 @@ async function enhanceUserPrompt(opts) {
     if (opts.oneShotOrchestrator) {
       const result = await opts.oneShotOrchestrator.call({
         system: ENHANCER_SYSTEM_PROMPT,
-        messages: [
-          { role: "user", content: buildRefinerInput(text, opts.history) }
-        ],
+        messages: [{ role: "user", content: refinerInput }],
         maxTokens,
         timeoutMs,
         signal: opts.signal
@@ -185,7 +331,9 @@ function recentTextTurns(messages, maxTurns = 6, maxChars = 1500) {
   return turns;
 }
 export {
+  DEFAULT_REFINER_RETRY_FEEDBACK,
   ENHANCER_SYSTEM_PROMPT,
+  buildRefinerContextSections,
   enhanceUserPrompt,
   gatedEnhancerReasoning,
   normalizedEqual,

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

@@ -1,7 +1,7 @@
 {
   "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 type { OneShotOrchestrator } from './one-shot-llm.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\n/**\n * Why a refine attempt fell through. Callers use this to decide the recovery\n * path: `timeout` is a transient capacity/latency failure worth an automatic\n * retry with a longer window (the model was reachable, just slow); `empty` and\n * `provider_error` mean the attempt produced nothing useful, so the caller\n * should surface the recovery options (retry, switch model, send as-is) rather\n * than silently retry. User-initiated cancellation is NOT reported here (it\n * returns `null` with no `onError` call).\n */\nexport type EnhanceFailureKind = 'timeout' | 'empty' | 'provider_error';\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 and a machine-readable `kind` when refinement\n   * fails (provider error, timeout, empty response). NOT called when the caller\n   * cancels via `signal`. The `kind` lets the UI drive recovery: `timeout` is\n   * eligible for an automatic longer-window retry; `empty` / `provider_error`\n   * surface the recovery options instead. The second argument is optional so\n   * existing callers that only read the reason keep compiling.\n   */\n  onError?: ((reason: string, kind?: EnhanceFailureKind) => void) | undefined;\n  /**\n   * OneShotOrchestrator for the refiner LLM call. When set, uses it instead\n   * of direct provider.complete(), gaining fallback chain support.\n   */\n  oneShotOrchestrator?: OneShotOrchestrator | 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    let raw: string;\n    if (opts.oneShotOrchestrator) {\n      const result = await opts.oneShotOrchestrator.call({\n        system: ENHANCER_SYSTEM_PROMPT,\n        messages: [\n          { role: 'user', content: buildRefinerInput(text, opts.history) },\n        ],\n        maxTokens,\n        timeoutMs,\n        signal: opts.signal,\n      });\n      if (result.error) {\n        opts.onError?.(result.error, 'provider_error');\n        return null;\n      }\n      raw = result.text;\n    } else {\n      const res = await provider.complete(req, { signal });\n      raw = res.content\n        .filter(isTextBlock)\n        .map((b) => b.text)\n        .join('\\n')\n        .trim();\n    }\n    if (!raw) {\n      opts.onError?.('model returned no text', 'empty');\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', '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`, 'timeout');\n      return null;\n    }\n    opts.onError?.(toErrorMessage(err), 'provider_error');\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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",
+  "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 { MemoryEntry, MemoryScope, MemoryStore } from '../types/memory.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 type { OneShotOrchestrator } from './one-shot-llm.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/** Additional context the refiner may use to resolve references. */\nexport interface RefinerContextSection {\n  title: string;\n  items: string[];\n}\n\n/**\n * Minimal structural shape of the live agent context needed to enrich the\n * refiner. Kept structural so browser/client bundles do not need the Context\n * class and tests can pass plain objects.\n */\nexport interface RefinerSessionContextLike {\n  projectRoot?: unknown;\n  cwd?: unknown;\n  workingDir?: unknown;\n  readFiles?: unknown;\n  writtenFiles?: unknown;\n  todos?: unknown;\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\n/**\n * Why a refine attempt fell through. Callers use this to decide the recovery\n * path: `timeout` is a transient capacity/latency failure worth an automatic\n * retry with a longer window (the model was reachable, just slow); `empty` and\n * `provider_error` mean the attempt produced nothing useful, so the caller\n * should surface the recovery options (retry, switch model, send as-is) rather\n * than silently retry. User-initiated cancellation is NOT reported here (it\n * returns `null` with no `onError` call).\n */\nexport type EnhanceFailureKind = 'timeout' | 'empty' | 'provider_error';\n\nexport const DEFAULT_REFINER_RETRY_FEEDBACK =\n  'Make another pass that is sharper and more self-contained. Use the provided project memory, current session context, and recent conversation only to resolve references and preserve project vocabulary; keep the original scope unchanged.';\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  /**\n   * Project/session context snippets, already filtered and compacted by the\n   * caller. They are context only: the refiner may use them to resolve\n   * references, names, files, conventions, and constraints, but must not turn\n   * them into extra requirements.\n   */\n  contextSections?: RefinerContextSection[] | undefined;\n  /** Previous refinement when the user asks for another pass. */\n  previousRefinement?: EnhanceResult | undefined;\n  /** Short instruction for a retry pass. Defaults to `DEFAULT_REFINER_RETRY_FEEDBACK`. */\n  retryFeedback?: string | 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 and a machine-readable `kind` when refinement\n   * fails (provider error, timeout, empty response). NOT called when the caller\n   * cancels via `signal`. The `kind` lets the UI drive recovery: `timeout` is\n   * eligible for an automatic longer-window retry; `empty` / `provider_error`\n   * surface the recovery options instead. The second argument is optional so\n   * existing callers that only read the reason keep compiling.\n   */\n  onError?: ((reason: string, kind?: EnhanceFailureKind) => void) | undefined;\n  /**\n   * OneShotOrchestrator for the refiner LLM call. When set, uses it instead\n   * of direct provider.complete(), gaining fallback chain support.\n   */\n  oneShotOrchestrator?: OneShotOrchestrator | undefined;\n}\n\n/**\n * Compose the single user message sent to the refiner: the recent\n * conversation and project/session hints embedded as plain text (so we never\n * trip provider role-alternation rules) followed by the latest message to\n * refine.\n */\nfunction buildRefinerInput(\n  text: string,\n  history?: ConversationTurn[],\n  contextSections?: RefinerContextSection[],\n  previousRefinement?: EnhanceResult,\n  retryFeedback?: string,\n): string {\n  const parts: string[] = [];\n  const renderedContext = renderRefinerContextSections(contextSections);\n  if (renderedContext) parts.push(renderedContext);\n\n  if (previousRefinement || retryFeedback) {\n    const retryLines = [\n      'Retry context (context only - the user asked for another refinement pass):',\n    ];\n    if (previousRefinement?.refined) {\n      retryLines.push(`Previous refined version: ${compactText(previousRefinement.refined, 900)}`);\n    }\n    if (\n      previousRefinement?.english\n      && previousRefinement.english.trim() !== previousRefinement.refined.trim()\n    ) {\n      retryLines.push(`Previous English version: ${compactText(previousRefinement.english, 900)}`);\n    }\n    retryLines.push(`Retry instruction: ${retryFeedback ?? DEFAULT_REFINER_RETRY_FEEDBACK}`);\n    parts.push(retryLines.join('\\n'));\n  }\n\n  if (history && history.length > 0) {\n    const lines = history.map((t) => `${t.role === 'user' ? 'User' : 'Assistant'}: ${t.text}`);\n    parts.push(\n      [\n        'Recent conversation (context only - do not act on it):',\n        ...lines,\n      ].join('\\n'),\n    );\n  }\n\n  if (parts.length === 0) return text;\n  return [\n    ...parts,\n    '',\n    'Latest message to refine:',\n    text,\n  ].join('\\n\\n');\n}\n\nfunction renderRefinerContextSections(\n  contextSections?: RefinerContextSection[],\n): string | undefined {\n  const sections = (contextSections ?? [])\n    .map((section) => ({\n      title: section.title.trim(),\n      items: section.items.map((item) => compactText(item, 360)).filter(Boolean),\n    }))\n    .filter((section) => section.title && section.items.length > 0);\n  if (sections.length === 0) return undefined;\n  const lines = [\n    'Additional project/session context (context only - use to resolve references, conventions, and constraints; do not add new requirements):',\n  ];\n  for (const section of sections) {\n    lines.push('', `${section.title}:`);\n    for (const item of section.items) lines.push(`- ${item}`);\n  }\n  return lines.join('\\n');\n}\n\nfunction compactText(text: string, maxChars: number): string {\n  const compacted = text.replace(/\\s+/g, ' ').trim();\n  if (compacted.length <= maxChars) return compacted;\n  return `${compacted.slice(0, Math.max(0, maxChars - 3)).trimEnd()}...`;\n}\n\nfunction unknownString(value: unknown): string | undefined {\n  return typeof value === 'string' && value.trim() ? value.trim() : undefined;\n}\n\nfunction iterableStrings(value: unknown): string[] {\n  if (!value || typeof value === 'string') return [];\n  if (Array.isArray(value)) {\n    return value.flatMap((item) => {\n      const text = unknownString(item);\n      return text ? [text] : [];\n    });\n  }\n  if (value instanceof Set) {\n    return [...value].flatMap((item) => {\n      const text = unknownString(item);\n      return text ? [text] : [];\n    });\n  }\n  if (\n    typeof value === 'object'\n    && typeof (value as { [Symbol.iterator]?: unknown })[Symbol.iterator] === 'function'\n  ) {\n    try {\n      return Array.from(value as Iterable<unknown>).flatMap((item) => {\n        const text = unknownString(item);\n        return text ? [text] : [];\n      });\n    } catch {\n      return [];\n    }\n  }\n  return [];\n}\n\nfunction lastItems(values: string[], maxItems: number): string[] {\n  return values.slice(Math.max(0, values.length - maxItems));\n}\n\nfunction todoLines(value: unknown, maxItems: number): string[] {\n  if (!Array.isArray(value)) return [];\n  const open = value.filter((item): item is Record<string, unknown> => {\n    if (!item || typeof item !== 'object') return false;\n    const status = item['status'];\n    return status === 'pending' || status === 'in_progress';\n  });\n  return open.slice(0, maxItems).flatMap((todo) => {\n    const content = unknownString(todo['activeForm']) ?? unknownString(todo['content']);\n    if (!content) return [];\n    return [`open todo (${String(todo['status'])}): ${compactText(content, 220)}`];\n  });\n}\n\nfunction buildRefinerSessionContextSection(\n  context?: RefinerSessionContextLike,\n): RefinerContextSection | undefined {\n  if (!context) return undefined;\n  const items: string[] = [];\n  const projectRoot = unknownString(context.projectRoot);\n  const workingDir = unknownString(context.workingDir) ?? unknownString(context.cwd);\n  if (projectRoot) items.push(`project root: ${projectRoot}`);\n  if (workingDir && workingDir !== projectRoot) items.push(`working dir: ${workingDir}`);\n\n  for (const file of lastItems(iterableStrings(context.readFiles), 6)) {\n    items.push(`recently read file: ${file}`);\n  }\n  for (const file of lastItems(iterableStrings(context.writtenFiles), 6)) {\n    items.push(`recently written file: ${file}`);\n  }\n  items.push(...todoLines(context.todos, 6));\n  return items.length > 0 ? { title: 'Current session state', items } : undefined;\n}\n\nfunction formatMemoryEntry(entry: MemoryEntry): string {\n  const meta = [entry.scope, entry.type, entry.priority].filter(Boolean).join('/');\n  const tags = entry.tags && entry.tags.length > 0 ? ` tags: ${entry.tags.slice(0, 5).join(', ')}` : '';\n  return `${meta ? `[${meta}] ` : ''}${compactText(entry.text, 260)}${tags}`;\n}\n\nasync function collectMemoryEntries(\n  memoryStore: MemoryStore,\n  text: string,\n  scope: MemoryScope,\n  limit: number,\n): Promise<MemoryEntry[]> {\n  const scored = memoryStore.scoreRelevant\n    ? await memoryStore\n        .scoreRelevant({ currentTask: text }, scope, limit)\n        .catch(() => [] as MemoryEntry[])\n    : [];\n  if (scored.length > 0) return scored;\n  return memoryStore.search(text || 'prompt refinement', scope, limit).catch(() => []);\n}\n\nasync function buildRefinerMemoryContextSection(\n  memoryStore: MemoryStore | undefined,\n  text: string,\n): Promise<RefinerContextSection | undefined> {\n  if (!memoryStore) return undefined;\n  const seen = new Set<string>();\n  const entries: MemoryEntry[] = [];\n  for (const scope of ['project-memory', 'user-memory'] as const) {\n    const remaining = Math.max(0, 6 - entries.length);\n    if (remaining === 0) break;\n    for (const entry of await collectMemoryEntries(memoryStore, text.trim(), scope, remaining)) {\n      const key = `${entry.scope}:${entry.text}`;\n      if (seen.has(key)) continue;\n      seen.add(key);\n      entries.push(entry);\n      if (entries.length >= 6) break;\n    }\n  }\n  if (entries.length === 0) return undefined;\n  return { title: 'Relevant project memory', items: entries.map(formatMemoryEntry) };\n}\n\nexport async function buildRefinerContextSections(opts: {\n  text: string;\n  memoryStore?: MemoryStore | undefined;\n  context?: RefinerSessionContextLike | undefined;\n}): Promise<RefinerContextSection[]> {\n  const sections: RefinerContextSection[] = [];\n  const memory = await buildRefinerMemoryContextSection(opts.memoryStore, opts.text);\n  if (memory) sections.push(memory);\n  const session = buildRefinerSessionContextSection(opts.context);\n  if (session) sections.push(session);\n  return sections;\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  const refinerInput = buildRefinerInput(\n    text,\n    opts.history,\n    opts.contextSections,\n    opts.previousRefinement,\n    opts.retryFeedback,\n  );\n\n  const req: Request = {\n    model,\n    system: [{ type: 'text', text: ENHANCER_SYSTEM_PROMPT }],\n    messages: [{ role: 'user', content: refinerInput }],\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    let raw: string;\n    if (opts.oneShotOrchestrator) {\n      const result = await opts.oneShotOrchestrator.call({\n        system: ENHANCER_SYSTEM_PROMPT,\n        messages: [{ role: 'user', content: refinerInput }],\n        maxTokens,\n        timeoutMs,\n        signal: opts.signal,\n      });\n      if (result.error) {\n        opts.onError?.(result.error, 'provider_error');\n        return null;\n      }\n      raw = result.text;\n    } else {\n      const res = await provider.complete(req, { signal });\n      raw = res.content\n        .filter(isTextBlock)\n        .map((b) => b.text)\n        .join('\\n')\n        .trim();\n    }\n    if (!raw) {\n      opts.onError?.('model returned no text', 'empty');\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', '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`, 'timeout');\n      return null;\n    }\n    opts.onError?.(toErrorMessage(err), 'provider_error');\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/retry-policy.d.ts

@@ -1,18 +1,5 @@
 import { ProviderError } from '../types/provider.js';
 import type { RetryPolicy } from '../types/retry-policy.js';
-/**
- * Upper bound for any Retry-After hint surfaced by a provider.
- *
- * The HTTP `Retry-After` header can carry either a delta-seconds
- * integer or an absolute HTTP-date. The latter can legitimately be
- * far in the future if the provider is asking us to back off for
- * minutes or hours. We never want to be stuck waiting that long —
- * the agent kernel has its own pacing and a multi-minute single
- * retry would freeze the user. 60 seconds is the conventional cap
- * (it matches what most providers document as the practical upper
- * bound for a single rate-limit window).
- */
-export declare const MAX_RETRY_AFTER_MS = 60000;
 export declare class DefaultRetryPolicy implements RetryPolicy {
     shouldRetry(err: Error | ProviderError, attempt: number): boolean;
     maxAttempts(err: Error | ProviderError): number;

package/dist/execution/retry-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retry-policy.d.ts","sourceRoot":"","sources":["../../src/execution/retry-policy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAA0B,MAAM,sBAAsB,CAAC;AAE7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAuBzC,qBAAa,kBAAmB,YAAW,WAAW;IACpD,WAAW,CAAC,GAAG,EAAE,KAAK,GAAG,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAShE;IAED,WAAW,CAAC,GAAG,EAAE,KAAK,GAAG,aAAa,GAAG,MAAM,CAK9C;IAED;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,GAAG,aAAa,GAAG,MAAM,CAmB5D;CACF"}
+{"version":3,"file":"retry-policy.d.ts","sourceRoot":"","sources":["../../src/execution/retry-policy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAA0B,MAAM,sBAAsB,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAuC5D,qBAAa,kBAAmB,YAAW,WAAW;IACpD,WAAW,CAAC,GAAG,EAAE,KAAK,GAAG,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAShE;IAED,WAAW,CAAC,GAAG,EAAE,KAAK,GAAG,aAAa,GAAG,MAAM,CAK9C;IAED;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,GAAG,aAAa,GAAG,MAAM,CAmB5D;CACF"}

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

@@ -1 +1 @@
-{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../../src/execution/skill-loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AA+D5D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,WAAW,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,qIAAqI;IACrI,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IAChD,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAClC;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0E;IAC/F,OAAO,CAAC,KAAK,CAAC,CAA8B;IAC5C,OAAO,CAAC,YAAY,CAAC,CAA2B;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IAEvD,YAAY,IAAI,EAAE,kBAAkB,EAyBnC;IAEK,IAAI,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAwCrC;IAEK,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAI3D;IAEK,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAUpC;IAEK,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAmBzC;IAED,eAAe,IAAI,IAAI,CAItB;IAEK,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS5C;IAEK,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBhD;CACF"}
+{"version":3,"file":"skill-loader.d.ts","sourceRoot":"","sources":["../../src/execution/skill-loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AA+D5D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,WAAW,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,qIAAqI;IACrI,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IAChD,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAClC;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,kBAAmB,YAAW,WAAW;IACpD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0E;IAC/F,OAAO,CAAC,KAAK,CAAC,CAA8B;IAC5C,OAAO,CAAC,YAAY,CAAC,CAA2B;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IAEvD,YAAY,IAAI,EAAE,kBAAkB,EAyBnC;IAEK,IAAI,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CA6CrC;IAEK,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAI3D;IAEK,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAUpC;IAEK,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAmBzC;IAED,eAAe,IAAI,IAAI,CAItB;IAEK,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS5C;IAEK,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAyBhD;CACF"}

package/dist/execution/tool-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-executor.d.ts","sourceRoot":"","sources":["../../src/execution/tool-executor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAKlD,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,IAAI,EAAqB,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEnF,OAAO,EAGL,KAAK,eAAe,EAGpB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAC1B,MAAM,2BAA2B,CAAC;AAYnC,qBAAa,YAAY;IAarB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,IAAI;IAbd,0EAA0E;IAC1E,MAAM,CAAC,QAAQ,CAAC,yBAAyB,OAAO;IAChD,8EAA8E;IAC9E,MAAM,CAAC,QAAQ,CAAC,mBAAmB,SAAU;IAC7C,2EAA2E;IAC3E,MAAM,CAAC,QAAQ,CAAC,mBAAmB,SAAU;IAE7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAE1C,YACmB,QAAQ,EAAE;QAAE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;QAAC,IAAI,IAAI,IAAI,EAAE,CAAA;KAAE,EAC1E,IAAI,EAAE,mBAAmB,EAOlC;IAED;;;;;OAKG;IACH,mBAAmB,IAAI,IAAI,CAE1B;IAED;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,cAAc;IAwBtB,OAAO,CAAC,cAAc;IAuCtB;;;OAGG;IACG,YAAY,CAChB,QAAQ,EAAE,YAAY,EAAE,EACxB,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAK1B;IAED;;;;;OAKG;YACW,oBAAoB;IA8alC;;;;;OAKG;YACW,2BAA2B;IAqCzC;;;;;OAKG;IACG,WAAW,CACf,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;QAAE,KAAK,EAAE,eAAe,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAKpD;IAED;;;;;;;;;;OAUG;YACW,iBAAiB;IAmB/B;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;YA4BV,cAAc;IAsF5B,sEAAsE;YACxD,cAAc;YASd,eAAe;IA0H7B,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,oBAAoB;IA2B5B,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,mBAAmB;IAS3B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,eAAe;CAIxB;AAiED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,QAAQ,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAqFpH"}
+{"version":3,"file":"tool-executor.d.ts","sourceRoot":"","sources":["../../src/execution/tool-executor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAMlD,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,IAAI,EAAqB,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEnF,OAAO,EAGL,KAAK,eAAe,EAGpB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAC1B,MAAM,2BAA2B,CAAC;AAkBnC,qBAAa,YAAY;IAarB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,IAAI;IAbd,0EAA0E;IAC1E,MAAM,CAAC,QAAQ,CAAC,yBAAyB,OAAO;IAChD,8EAA8E;IAC9E,MAAM,CAAC,QAAQ,CAAC,mBAAmB,SAAU;IAC7C,2EAA2E;IAC3E,MAAM,CAAC,QAAQ,CAAC,mBAAmB,SAAU;IAE7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAE1C,YACmB,QAAQ,EAAE;QAAE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;QAAC,IAAI,IAAI,IAAI,EAAE,CAAA;KAAE,EAC1E,IAAI,EAAE,mBAAmB,EAOlC;IAED;;;;;OAKG;IACH,mBAAmB,IAAI,IAAI,CAE1B;IAED;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,cAAc;IAwBtB,OAAO,CAAC,cAAc;IAuCtB;;;OAGG;IACG,YAAY,CAChB,QAAQ,EAAE,YAAY,EAAE,EACxB,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAI1B;IAED;;;;;OAKG;YACW,oBAAoB;IA8gBlC;;;;;OAKG;YACW,2BAA2B;IAqCzC;;;;;OAKG;IACG,WAAW,CACf,IAAI,EAAE,IAAI,EACV,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;QAAE,KAAK,EAAE,eAAe,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAKpD;IAED;;;;;;;;;;OAUG;YACW,iBAAiB;IAsB/B;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB;YA4BV,cAAc;IAuG5B,sEAAsE;YACxD,cAAc;YASd,eAAe;IA6H7B,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,oBAAoB;IA2B5B,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,mBAAmB;IAS3B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,eAAe;CAGxB;AAiED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG;IAC/C,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAmFA"}

package/dist/goal/checkpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/goal/checkpoint.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IACjC,YAAY,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,UAAU,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,4FAA4F;IAC5F,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAYD;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,OAAO,CAAS;IAExB,YAAY,IAAI,EAAE,wBAAwB,EAMzC;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAGhC;IAEK,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAkC3E;IAEK,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAgCxE;IAED,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,CAI9C;IAEK,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ7D;YAEa,UAAU;YAyBV,cAAc;YAkCd,YAAY;YAqCZ,gBAAgB;CA0B/B"}

package/dist/{autophase/auto-phase-planner.d.ts → goal/goal-planner.d.ts}

@@ -1,5 +1,5 @@
 /**
- * AutoPhasePlanner - converts a goal into phases using a real LLM call,
+ * GoalPlanner - converts a goal into phases using a real LLM call,
  * producing a large task list with todos under each phase.
  *
  * Similar to SDD's spec-to-task flow, but different: the output is directly
@@ -11,7 +11,7 @@
  * (a subagent run in the CLI, or a deterministic stub in tests).
  */
 import type { PhaseTemplate } from './types.js';
-export interface AutoPhasePlannerOptions {
+export interface GoalPlannerOptions {
     /**
      * One-shot LLM call: receives a prompt and returns the model text output.
      * In the CLI this wraps subagent.run; in tests it can be a deterministic stub.
@@ -34,7 +34,7 @@ export interface AutoPhasePlannerOptions {
      */
     maxTotalTasks?: number | undefined;
 }
-export interface AutoPhasePlanResult {
+export interface GoalPlanResult {
     /** Phase templates passed to PhaseGraphBuilder. */
     phases: PhaseTemplate[];
     /** Raw model output for debugging and logs. */
@@ -52,13 +52,13 @@ export interface AutoPhasePlanResult {
     budgetExceeded?: boolean | undefined;
 }
 /**
- * AutoPhasePlanner drives the model through `plan()` and produces `PhaseTemplate[]`.
+ * GoalPlanner drives the model through `plan()` and produces `PhaseTemplate[]`.
  */
-export declare class AutoPhasePlanner {
+export declare class GoalPlanner {
     private readonly opts;
-    constructor(opts: AutoPhasePlannerOptions);
+    constructor(opts: GoalPlannerOptions);
     /** Convert the goal into a phase-and-todo plan. */
-    plan(): Promise<AutoPhasePlanResult>;
+    plan(): Promise<GoalPlanResult>;
     /** Instruction prompt for the plan the model should produce. */
     buildPrompt(): string;
     /** Extract JSON from raw output, validate it, and convert it to PhaseTemplate[].
@@ -76,4 +76,4 @@ export declare class AutoPhasePlanner {
  *  2. The first balanced [ ... ] block in the text, aware of strings and escapes
  */
 export declare function extractJSONArray(text: string): string | null;
-//# sourceMappingURL=auto-phase-planner.d.ts.map
+//# sourceMappingURL=goal-planner.d.ts.map

package/dist/goal/goal-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-planner.d.ts","sourceRoot":"","sources":["../../src/goal/goal-planner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,KAAK,EAAa,aAAa,EAAE,MAAM,YAAY,CAAC;AAK3D,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,WAAW,EAAE,OAAO,CAAC;IACrB,sFAAsF;IACtF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,yDAAyD;IACzD,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACtC;AAiBD;;GAEG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAjC,YAA6B,IAAI,EAAE,kBAAkB,EAAI;IAEzD,mDAAmD;IAC7C,IAAI,IAAI,OAAO,CAAC,cAAc,CAAC,CAkBpC;IAED,gEAAgE;IAChE,WAAW,IAAI,MAAM,CAapB;IAED;mFAC+E;IAC/E,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAoBlE;IAED,OAAO,CAAC,WAAW;IAsCnB,OAAO,CAAC,UAAU;CAgCnB;AAaD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY5D"}