@wrongstack/core 0.270.0 → 0.272.1

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

@@ -1,4 +1,4 @@
-import { P as Provider, M as Message } from '../context-Dp87Bcaq.js';
+import { P as Provider, R as ReasoningRequest, a as ReasoningConfig, M as Message } from '../context-Dw55zZ_Q.js';
 
 /**
  * Prompt refinement ("did you mean this?").
@@ -13,7 +13,7 @@ import { P as Provider, M as Message } from '../context-Dp87Bcaq.js';
  * `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 = "You are a request refiner embedded in a coding agent. Your ONLY job is to rewrite the user's message into clearer, unambiguous instructions that the coding agent can act on confidently.\n\nRules:\n- Preserve the user's intent and scope EXACTLY. Do not add new requirements, features, constraints, or steps the user did not ask for. Do not remove anything they did ask for.\n- Do NOT answer, solve, or perform the request. Only restate it more clearly.\n- Keep all concrete details verbatim: file paths, identifiers, code, error text, numbers, names, URLs.\n- Resolve obvious ambiguity by making the implied subject explicit, not by inventing specifics. If something is genuinely unspecified, leave it general rather than guessing.\n- Be concise: one tight instruction per version (a few sentences at most). No preamble, no explanation, no quotes, no markdown headers.\n- If the message is already clear and complete, return it essentially unchanged.\n\nYou MUST output TWO versions of the refined request, separated by a line containing only \"---\".\n- First version: refined in the SAME LANGUAGE the user wrote in (if Turkish \u2192 Turkish, if Spanish \u2192 Spanish, etc.).\n- Second version: refined in ENGLISH (translate the intent into clear English while preserving all concrete details).\n\nOutput format:\n<refined in user's language>\n---\n<refined in English>\n\nWhen earlier conversation turns are provided, they are CONTEXT ONLY. Use them to resolve references in the user's latest message \u2014 \"it\", \"that\", \"the same\", \"the other one\", \"this file\", \"again\" \u2014 so the refined instruction is self-contained. Refine ONLY the user's latest message; do not answer it, do not act on or restate earlier turns, and do not summarize the conversation.\n\nOutput ONLY the two versions separated by \"---\" \u2014 nothing else.";
+declare const ENHANCER_SYSTEM_PROMPT = "You are a request refiner embedded in a coding agent. Your ONLY job is to rewrite the user's message into clearer, unambiguous instructions that the coding agent can act on confidently.\n\nRules:\n- Preserve the user's intent and scope EXACTLY. Do not add new requirements, features, constraints, or steps the user did not ask for. Do not remove anything they did ask for.\n- Do NOT answer, solve, or perform the request. Only restate it more clearly.\n- Keep all concrete details verbatim: file paths, identifiers, code, error text, numbers, names, URLs.\n- Resolve obvious ambiguity by making the implied subject explicit, not by inventing specifics. If something is genuinely unspecified, leave it general rather than guessing.\n- Be concise: one tight instruction per version (a few sentences at most). No preamble, no explanation, no quotes, no markdown headers.\n- If the message is already clear and complete, return it essentially unchanged.\n\nDetect the language of the user's LATEST message and output accordingly:\n\n- If that message is ALREADY in English: output exactly ONE refined version, in English. Nothing else \u2014 no \"---\" line, no second copy.\n- If that message is in ANY OTHER language (Turkish, Spanish, \u2026): output TWO versions separated by a line containing only \"---\":\n    - First version: refined in the SAME LANGUAGE the user wrote in.\n    - Second version: refined in ENGLISH (translate the intent into clear English while preserving all concrete details).\n\nOutput format for non-English input:\n<refined in user's language>\n---\n<refined in English>\n\nWhen earlier conversation turns are provided, they are CONTEXT ONLY. Use them to resolve references in the user's latest message \u2014 \"it\", \"that\", \"the same\", \"the other one\", \"this file\", \"again\" \u2014 so the refined instruction is self-contained. Refine ONLY the user's latest message; do not answer it, do not act on or restate earlier turns, and do not summarize the conversation. The conversation language does NOT decide the output language \u2014 only the language of the latest message does.\n\nOutput ONLY the refined request(s) in the format above \u2014 nothing else.";
 /**
  * Heuristic gate: should this raw input be sent through the refiner at all?
  * Pure + exported for unit testing. Returns false for inputs where refinement
@@ -21,6 +21,24 @@ declare const ENHANCER_SYSTEM_PROMPT = "You are a request refiner embedded in a
  * short text, bare numbers).
  */
 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
+ * task — extended thinking adds latency and (hidden) token cost for little
+ * gain — so we ask the model to spend as little reasoning as it safely can.
+ *
+ * The gating mirrors `resolveReasoningForRequest` so we never send a field the
+ * model would reject:
+ *   - effort-capable model      → its lowest advertised effort level;
+ *   - else disable-capable model → disable thinking (`enabled: false`);
+ *   - else (always-on / unknown) → `undefined` (leave the provider default).
+ *
+ * Returns `undefined` whenever nothing can be safely reduced. Callers forward
+ * that verbatim to `enhanceUserPrompt`, which then sends no reasoning field —
+ * identical to the behavior before this hint existed. Pure + exported for unit
+ * testing.
+ */
+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
@@ -33,13 +51,15 @@ interface ConversationTurn {
     text: string;
 }
 /**
- * Result of a successful prompt refinement. Contains both the
- * original-language and English versions so the UI can offer both.
+ * 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
+ * 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 {
     /** Refined in the user's original language. */
     refined: string;
-    /** Refined in English. */
+    /** Refined in English. Equals `refined` when the input was already English. */
     english: string;
 }
 interface EnhanceUserPromptOptions {
@@ -60,6 +80,16 @@ interface EnhanceUserPromptOptions {
     timeoutMs?: number | undefined;
     /** Max tokens for the refined output. Default 2048. */
     maxTokens?: number | undefined;
+    /**
+     * Reasoning directive for the refiner call. Refinement is a shallow
+     * restate-this-more-clearly task that does not benefit from extended
+     * thinking, so callers pass a low-effort / thinking-disabled hint here to
+     * cut latency and (hidden) reasoning-token cost — most impactful on slow
+     * reasoning models. Build it with `gatedEnhancerReasoning(rc)` so the field
+     * is gated to what the model accepts. Omit (undefined) to send no reasoning
+     * directive at all (the provider's own default applies).
+     */
+    reasoning?: ReasoningRequest | undefined;
     /**
      * Called with a short reason when refinement fails (provider error, timeout,
      * empty response). NOT called when the caller cancels via `signal`. Lets the
@@ -83,4 +113,4 @@ declare function enhanceUserPrompt(opts: EnhanceUserPromptOptions): Promise<Enha
  */
 declare function recentTextTurns(messages: Message[], maxTurns?: number, maxChars?: number): ConversationTurn[];
 
-export { type ConversationTurn, ENHANCER_SYSTEM_PROMPT, type EnhanceResult, type EnhanceUserPromptOptions, enhanceUserPrompt, normalizedEqual, recentTextTurns, shouldEnhance };
+export { type ConversationTurn, ENHANCER_SYSTEM_PROMPT, type EnhanceResult, type EnhanceUserPromptOptions, enhanceUserPrompt, gatedEnhancerReasoning, normalizedEqual, recentTextTurns, shouldEnhance };

package/dist/execution/prompt-enhancer.js

@@ -19,18 +19,21 @@ Rules:
 - Be concise: one tight instruction per version (a few sentences at most). No preamble, no explanation, no quotes, no markdown headers.
 - If the message is already clear and complete, return it essentially unchanged.
 
-You MUST output TWO versions of the refined request, separated by a line containing only "---".
-- First version: refined in the SAME LANGUAGE the user wrote in (if Turkish \u2192 Turkish, if Spanish \u2192 Spanish, etc.).
-- Second version: refined in ENGLISH (translate the intent into clear English while preserving all concrete details).
+Detect the language of the user's LATEST message and output accordingly:
 
-Output format:
+- If that message is ALREADY in English: output exactly ONE refined version, in English. Nothing else \u2014 no "---" line, no second copy.
+- If that message is in ANY OTHER language (Turkish, Spanish, \u2026): output TWO versions separated by a line containing only "---":
+    - First version: refined in the SAME LANGUAGE the user wrote in.
+    - Second version: refined in ENGLISH (translate the intent into clear English while preserving all concrete details).
+
+Output format for non-English input:
 <refined in user's language>
 ---
 <refined in English>
 
-When earlier conversation turns are provided, they are CONTEXT ONLY. Use them to resolve references in the user's latest message \u2014 "it", "that", "the same", "the other one", "this file", "again" \u2014 so the refined instruction is self-contained. Refine ONLY the user's latest message; do not answer it, do not act on or restate earlier turns, and do not summarize the conversation.
+When earlier conversation turns are provided, they are CONTEXT ONLY. Use them to resolve references in the user's latest message \u2014 "it", "that", "the same", "the other one", "this file", "again" \u2014 so the refined instruction is self-contained. Refine ONLY the user's latest message; do not answer it, do not act on or restate earlier turns, and do not summarize the conversation. The conversation language does NOT decide the output language \u2014 only the language of the latest message does.
 
-Output ONLY the two versions separated by "---" \u2014 nothing else.`;
+Output ONLY the refined request(s) in the format above \u2014 nothing else.`;
 var AFFIRMATION_RE = /^(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;
 function shouldEnhance(text) {
   const t = text.trim();
@@ -43,6 +46,24 @@ function shouldEnhance(text) {
   if (words.length < 3) return false;
   return true;
 }
+var EFFORT_PREFERENCE = [
+  "low",
+  "minimal",
+  "medium",
+  "high",
+  "xhigh",
+  "max",
+  "none"
+];
+function gatedEnhancerReasoning(rc) {
+  if (!rc) return void 0;
+  if (rc.effortSupported && rc.effortLevels.length > 0) {
+    const lowest = EFFORT_PREFERENCE.find((e) => rc.effortLevels.includes(e)) ?? rc.effortLevels[0];
+    if (lowest) return { effort: lowest };
+  }
+  if (rc.disableSupported) return { enabled: false };
+  return void 0;
+}
 function normalizedEqual(a, b) {
   const norm = (s) => s.trim().replace(/\s+/g, " ").toLowerCase();
   return norm(a) === norm(b);
@@ -66,11 +87,17 @@ async function enhanceUserPrompt(opts) {
     model,
     system: [{ type: "text", text: ENHANCER_SYSTEM_PROMPT }],
     messages: [{ role: "user", content: buildRefinerInput(text, opts.history) }],
-    maxTokens
+    maxTokens,
     // NOTE: deliberately NO `temperature`. The main agent loop never sets it,
     // and reasoning models (DeepSeek reasoner, o1/o3, …) return HTTP 400 when
     // `temperature` is present — which would make every refine call fail and
     // silently fall back to the original (no panel shown).
+    //
+    // A reasoning hint is forwarded ONLY when the caller supplies one (it must
+    // already be gated to the model's advertised support — see
+    // `gatedEnhancerReasoning`). Absent it, no reasoning field is sent, which
+    // is identical to the original behavior.
+    ...opts.reasoning ? { reasoning: opts.reasoning } : {}
   };
   const timer = new AbortController();
   const to = setTimeout(() => timer.abort(new Error("enhancer timeout")), timeoutMs);
@@ -84,7 +111,6 @@ async function enhanceUserPrompt(opts) {
     }
     const sepIdx = raw.indexOf("\n---\n");
     if (sepIdx === -1) {
-      opts.onError?.("model did not produce two versions");
       return { refined: raw, english: raw };
     }
     const refined = raw.slice(0, sepIdx).trim();
@@ -126,6 +152,6 @@ function recentTextTurns(messages, maxTurns = 6, maxChars = 1500) {
   return turns;
 }
 
-export { ENHANCER_SYSTEM_PROMPT, enhanceUserPrompt, 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 @@
-{"version":3,"sources":["../../src/types/blocks.ts","../../src/utils/error.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}\nexport function isThinkingBlock(b: ContentBlock): b is ThinkingBlock {\n  return b.type === 'thinking';\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 { isTextBlock } from '../types/blocks.js';\nimport type { ContentBlock } from '../types/blocks.js';\nimport type { Message } from '../types/messages.js';\nimport type { Provider, Request } from '../types/provider.js';\nimport { toErrorMessage } from '../utils/error.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 = `You are a request refiner embedded in a coding agent. Your ONLY job is to rewrite the user's message into clearer, unambiguous instructions that the coding agent can act on confidently.\n\nRules:\n- Preserve the user's intent and scope EXACTLY. Do not add new requirements, features, constraints, or steps the user did not ask for. Do not remove anything they did ask for.\n- Do NOT answer, solve, or perform the request. Only restate it more clearly.\n- Keep all concrete details verbatim: file paths, identifiers, code, error text, numbers, names, URLs.\n- Resolve obvious ambiguity by making the implied subject explicit, not by inventing specifics. If something is genuinely unspecified, leave it general rather than guessing.\n- Be concise: one tight instruction per version (a few sentences at most). No preamble, no explanation, no quotes, no markdown headers.\n- If the message is already clear and complete, return it essentially unchanged.\n\nYou MUST output TWO versions of the refined request, separated by a line containing only \"---\".\n- First version: refined in the SAME LANGUAGE the user wrote in (if Turkish → Turkish, if Spanish → Spanish, etc.).\n- Second version: refined in ENGLISH (translate the intent into clear English while preserving all concrete details).\n\nOutput format:\n<refined in user's language>\n---\n<refined in English>\n\nWhen earlier conversation turns are provided, they are CONTEXT ONLY. Use them to resolve references in the user's latest message — \"it\", \"that\", \"the same\", \"the other one\", \"this file\", \"again\" — so the refined instruction is self-contained. Refine ONLY the user's latest message; do not answer it, do not act on or restate earlier turns, and do not summarize the conversation.\n\nOutput ONLY the two versions separated by \"---\" — nothing else.`;\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 * 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. Contains both the\n * original-language and English versions so the UI can offer both.\n */\nexport interface EnhanceResult {\n  /** Refined in the user's original language. */\n  refined: string;\n  /** Refined in 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   * 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\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\n    ? AbortSignal.any([opts.signal, timer.signal])\n    : 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    // The model outputs two versions separated by a line with only \"---\".\n    // Split on the first occurrence so the delimiter can appear in the text.\n    const sepIdx = raw.indexOf('\\n---\\n');\n    if (sepIdx === -1) {\n      // Model didn't follow the format — treat the whole response as a\n      // single refined version (best-effort fallback).\n      opts.onError?.('model did not produce two versions');\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/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}\nexport function isThinkingBlock(b: ContentBlock): b is ThinkingBlock {\n  return b.type === 'thinking';\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 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';\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 = `You are a request refiner embedded in a coding agent. Your ONLY job is to rewrite the user's message into clearer, unambiguous instructions that the coding agent can act on confidently.\n\nRules:\n- Preserve the user's intent and scope EXACTLY. Do not add new requirements, features, constraints, or steps the user did not ask for. Do not remove anything they did ask for.\n- Do NOT answer, solve, or perform the request. Only restate it more clearly.\n- Keep all concrete details verbatim: file paths, identifiers, code, error text, numbers, names, URLs.\n- Resolve obvious ambiguity by making the implied subject explicit, not by inventing specifics. If something is genuinely unspecified, leave it general rather than guessing.\n- Be concise: one tight instruction per version (a few sentences at most). No preamble, no explanation, no quotes, no markdown headers.\n- If the message is already clear and complete, return it essentially unchanged.\n\nDetect the language of the user's LATEST message and output accordingly:\n\n- If that message is ALREADY in English: output exactly ONE refined version, in English. Nothing else — no \"---\" line, no second copy.\n- If that message is in ANY OTHER language (Turkish, Spanish, …): output TWO versions separated by a line containing only \"---\":\n    - First version: refined in the SAME LANGUAGE the user wrote in.\n    - Second version: refined in ENGLISH (translate the intent into clear English while preserving all concrete details).\n\nOutput format for non-English input:\n<refined in user's language>\n---\n<refined in English>\n\nWhen earlier conversation turns are provided, they are CONTEXT ONLY. Use them to resolve references in the user's latest message — \"it\", \"that\", \"the same\", \"the other one\", \"this file\", \"again\" — so the refined instruction is self-contained. Refine ONLY the user's latest message; do not answer it, do not act on or restate earlier turns, and do not summarize the conversation. The conversation language does NOT decide the output language — only the language of the latest message does.\n\nOutput ONLY the refined request(s) in the format above — nothing else.`;\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"]}

package/dist/extension/index.d.ts

@@ -1,9 +1,9 @@
-export { i as AfterIterationHook, j as AfterRunHook, k as AfterToolExecutionHook, l as AgentExtension, B as BeforeIterationHook, m as BeforeRunHook, n as BeforeToolExecutionHook, E as ExtensionRegistry, O as OnErrorHook, v as ProviderRunnerFn, t as ProviderRunnerWrapper } from '../index-W4VJCzHa.js';
-import '../context-Dp87Bcaq.js';
+export { i as AfterIterationHook, j as AfterRunHook, k as AfterToolExecutionHook, l as AgentExtension, B as BeforeIterationHook, m as BeforeRunHook, n as BeforeToolExecutionHook, E as ExtensionRegistry, O as OnErrorHook, v as ProviderRunnerFn, t as ProviderRunnerWrapper } from '../index-DWm_PE9L.js';
+import '../context-Dw55zZ_Q.js';
 import '../logger-B63L5bTg.js';
-import '../pipeline-l_zzFRh3.js';
+import '../pipeline-Ckkn3AOA.js';
 import '../mailbox-types-Ct2hJq0P.js';
-import '../config-C_ae2k86.js';
+import '../config-rRS8yorV.js';
 import '../observability-D-HZN_mF.js';
-import '../brain-BYcK__Ym.js';
-import '../permission-CvYQNUqZ.js';
+import '../brain-etbcbRwV.js';
+import '../permission-CC7XFYWG.js';

package/dist/{global-mailbox-Bvrz1P3f.d.ts → global-mailbox-DJ4EoRr0.d.ts}

@@ -1,4 +1,4 @@
-import { E as EventBus } from './brain-BYcK__Ym.js';
+import { E as EventBus } from './brain-etbcbRwV.js';
 import { M as MailboxMessage, a as MailboxAgentStatus, b as Mailbox, c as MailboxSendInput, d as MailboxQuery, e as MailboxAckInput, f as MailboxAckBatchInput, A as AgentRegistrationInput, g as AgentHeartbeatInput, C as ClientRegistrationInput, h as ClientHeartbeatInput, i as ClientStatus, P as PurgeOptions, j as PurgeResult } from './mailbox-types-Ct2hJq0P.js';
 
 declare const HQ_PROTOCOL_VERSION: 1;
@@ -58,7 +58,7 @@ interface HqEventEnvelope<TPayload = unknown> {
     seq: number;
     payload: TPayload;
 }
-type HqEventType = 'client.hello' | 'client.heartbeat' | 'session.started' | 'session.status' | 'session.usage' | 'tool.started' | 'tool.completed' | 'fleet.snapshot' | 'fleet.event' | 'mailbox.snapshot' | 'mailbox.event' | 'worklist.snapshot' | 'git.snapshot';
+type HqEventType = 'client.hello' | 'client.heartbeat' | 'session.started' | 'session.status' | 'session.usage' | 'tool.started' | 'tool.completed' | 'fleet.snapshot' | 'fleet.event' | 'mailbox.snapshot' | 'mailbox.event' | 'worklist.snapshot' | 'git.snapshot' | 'agent.message' | 'agent.status' | 'session.snapshot' | 'session.transcript' | 'session.ended';
 interface HqClientHeartbeatPayload {
     uptimeMs: number;
     activeSessionId?: string;
@@ -118,6 +118,26 @@ interface HqFleetSnapshotPayload {
     totalCostUsd?: number;
     subagents: readonly HqSubagentSummary[];
 }
+/** Payload for `agent.message` events — a subagent's conversational output. */
+interface HqAgentMessagePayload {
+    subagentId: string;
+    agentName: string;
+    content: string;
+    kind: 'text' | 'tool_use' | 'error' | 'status';
+    iteration: number;
+    ts: string;
+    toolName?: string;
+    costUsd?: number;
+}
+/** Payload for `agent.status` events — a subagent's lifecycle transition. */
+interface HqAgentStatusPayload {
+    subagentId: string;
+    agentName: string;
+    status: 'spawned' | 'running' | 'completed' | 'failed' | 'timeout' | 'stopped' | 'budget_exhausted';
+    ts: string;
+    summary?: string;
+    task?: string;
+}
 interface HqFleetEventPayload {
     runId: string;
     subagentId?: string;
@@ -125,6 +145,82 @@ interface HqFleetEventPayload {
     summary?: string;
     data?: unknown;
 }
+type HqSessionLiveStatus = 'active' | 'idle' | 'closing' | 'stale';
+type HqSessionAgentLiveStatus = 'idle' | 'running' | 'streaming' | 'waiting_user' | 'error';
+/** A single live agent inside a session snapshot (mirrors SessionRegistry's AgentEntry). */
+interface HqSessionAgentSummary {
+    id: string;
+    name: string;
+    /** UTC ISO timestamp when this agent/run started, when known. */
+    startedAt?: string;
+    status: HqSessionAgentLiveStatus;
+    currentTool?: string;
+    iterations: number;
+    toolCalls: number;
+    costUsd?: number;
+    tokensIn?: number;
+    tokensOut?: number;
+    ctxPct?: number;
+    model?: string;
+    /** Throttled tail of the response currently streaming, when known. */
+    partialText?: string;
+    lastActivityAt: string;
+}
+/** Payload for `session.snapshot` — one connected terminal's live state. */
+interface HqSessionSnapshotPayload {
+    sessionId: string;
+    clientKind: HqClientKind;
+    machineId: string;
+    hostname?: string;
+    pid?: number;
+    projectId: string;
+    projectName: string;
+    projectRoot: string;
+    gitBranch?: string;
+    status: HqSessionLiveStatus;
+    startedAt: string;
+    lastActivityAt: string;
+    agentCount: number;
+    agents: readonly HqSessionAgentSummary[];
+}
+type HqTranscriptRole = 'user' | 'assistant' | 'tool' | 'system' | 'error';
+/** One rendered conversation turn. Canonical shape shared by client streaming
+ * and server-side JSONL replay so both planes agree. */
+interface HqTranscriptEntry {
+    ts: string;
+    role: HqTranscriptRole;
+    text: string;
+    tool?: string;
+    /** Stringified tool input/arguments, for tool calls (shown alongside the result). */
+    toolInput?: string;
+    durationMs?: number;
+    isError?: boolean;
+    toolUseId?: string;
+    /** Which agent/subagent produced this turn, when attribution is known. */
+    agentId?: string;
+}
+/** Payload for `session.transcript` — an incremental batch of new turns. */
+interface HqTranscriptAppendPayload {
+    sessionId: string;
+    /** Monotonic sequence index of the FIRST entry in this batch within the session. */
+    fromSeq: number;
+    entries: readonly HqTranscriptEntry[];
+}
+/** Payload for `session.ended` — a terminal closed. */
+interface HqSessionEndedPayload {
+    sessionId: string;
+    endedAt: string;
+}
+/** A physical machine, aggregated by HQ from connected clients' machineId. */
+interface HqMachineRecord {
+    machineId: string;
+    hostname?: string;
+    clientCount: number;
+    sessionCount: number;
+    agentCount: number;
+    projectIds: readonly string[];
+    lastActivityAt: string;
+}
 type HqMailboxMessageType = 'note' | 'ask' | 'assign' | 'steer' | 'btw' | 'broadcast' | 'status' | 'result' | 'control';
 type HqMailboxPriority = 'low' | 'normal' | 'high';
 type HqMailboxAgentStatus = 'idle' | 'running' | 'streaming' | 'waiting_user' | 'error' | 'offline';
@@ -276,6 +372,10 @@ interface HqSnapshot {
     sessions: readonly HqSessionSummary[];
     fleets: readonly HqFleetSummary[];
     mailboxes: readonly HqMailboxSummary[];
+    /** Physical machines aggregated from connected clients (optional, additive). */
+    machines?: readonly HqMachineRecord[];
+    /** Live terminal sessions with their agents — the spine of the fleet tree. */
+    liveSessions?: readonly HqSessionSnapshotPayload[];
     totals: {
         activeProjects: number;
         activeClients: number;
@@ -284,6 +384,10 @@ interface HqSnapshot {
         unreadMailboxMessages: number;
         incompleteMailboxMessages: number;
         totalCostUsd: number;
+        /** Distinct physical machines currently connected. */
+        activeMachines?: number;
+        /** Total live agents across all sessions. */
+        activeAgents?: number;
     };
 }
 interface HqBrowserSnapshotMessage {
@@ -501,6 +605,22 @@ declare class HqPublisher {
         sessionId?: string;
         timestamp?: string;
     }): HqEventEnvelope<HqMailboxEventPayload>;
+    /** The client identity this publisher announced (clientId, kind, machineId, …). */
+    get identity(): HqClientIdentity;
+    /** The project identity this publisher is bound to. */
+    get project(): HqProjectIdentity;
+    /** Publish a live session/terminal snapshot (state + agents). */
+    publishSessionSnapshot(payload: HqSessionSnapshotPayload, opts?: {
+        timestamp?: string;
+    }): HqEventEnvelope<HqSessionSnapshotPayload>;
+    /** Publish an incremental batch of transcript turns for a session. */
+    publishTranscriptAppend(payload: HqTranscriptAppendPayload, opts?: {
+        timestamp?: string;
+    }): HqEventEnvelope<HqTranscriptAppendPayload>;
+    /** Mark a session/terminal as ended. */
+    publishSessionEnded(payload: HqSessionEndedPayload, opts?: {
+        timestamp?: string;
+    }): HqEventEnvelope<HqSessionEndedPayload>;
     pollCommands(): void;
     ackCommand(result: HqPublisherCommandResult): void;
     private sendHello;
@@ -532,6 +652,7 @@ declare class HqPublisher {
  * @module GlobalMailbox
  */
 
+type HqPublisherRef = HqPublisher | (() => HqPublisher | undefined);
 /**
  * Derive the project-level mailbox directory path.
  *
@@ -593,10 +714,11 @@ declare class GlobalMailbox implements Mailbox {
     /**
      * @param projectDir — `~/.wrongstack/projects/<slug>/`
      * @param events — optional EventBus for real-time TUI/WebUI notifications
-     * @param hqPublisher — optional HQ publisher for cross-project telemetry
+     * @param hqPublisher — optional HQ publisher, or getter, for cross-project telemetry
      */
-    constructor(projectDir: string, events?: EventBus, hqPublisher?: HqPublisher);
+    constructor(projectDir: string, events?: EventBus, hqPublisher?: HqPublisherRef);
     private get hqMailboxId();
+    private get hqPublisher();
     private publishHqMailboxEvent;
     private publishHqMailboxSnapshot;
     send(input: MailboxSendInput): Promise<MailboxMessage>;
@@ -621,6 +743,20 @@ declare class GlobalMailbox implements Mailbox {
      * should call this directly (it's what {@link _readMessagesFresh} aliases).
      */
     private _readMessages;
+    /**
+     * Read only newly-appended bytes from the file and append them to the
+     * in-memory cache. This avoids re-reading and re-parsing the entire file
+     * when another process appended messages since our last read.
+     *
+     * Only safe when the file grew in size (messages are append-only). When
+     * the file was rewritten (ack/purge changed existing content), callers
+     * must fall back to {@link _readMessages}.
+     *
+     * @returns The (now up-to-date) message cache.
+     */
+    private _readNewMessagesOnly;
+    /** Parse a JSONL string into MailboxMessage[], including migration. */
+    private _parseLines;
     /**
      * Read messages, then adopt the result as the in-memory cache. Use this
      * from writers that just took the file lock — the read reflects the
@@ -636,6 +772,10 @@ declare class GlobalMailbox implements Mailbox {
      * stat matches the cached mtime+size we return the cached array — no
      * file read and no JSON.parse — collapsing the per-iteration query
      * cost on the mailbox-loop hot path.
+     *
+     * When the file only grew (new messages appended by another process),
+     * we read and parse just the tail bytes instead of the entire file.
+     * This avoids re-parsing the full 10K-message history on every check.
      */
     private _readMessagesCached;
     /**
@@ -661,4 +801,4 @@ declare class GlobalMailbox implements Mailbox {
     private _writeClientRegistry;
 }
 
-export { type HqSessionStatusPayload as $, type HqMailboxMappingOptions as A, type HqMailboxMessageSummary as B, type HqMailboxMessageType as C, DEFAULT_HQ_REDACTION_POLICY as D, type HqMailboxPriority as E, type HqMailboxSnapshotOptions as F, GlobalMailbox as G, HQ_PROTOCOL_VERSION as H, type HqMailboxSnapshotPayload as I, type HqMailboxSummary as J, type HqParseResult as K, type HqPathPolicy as L, type HqProjectIdentity as M, type HqProjectRecord as N, type HqProjectStatus as O, type HqProtocolVersion as P, type HqPublishEventOptions as Q, HqPublisher as R, type HqPublisherCommandHandler as S, type HqPublisherCommandResult as T, type HqPublisherOptions as U, type HqQueuedCommand as V, type HqRedactionPolicy as W, type HqServerCommandBatchMessage as X, type HqServerMessage as Y, type HqSessionStartedPayload as Z, type HqSessionStatus as _, type HqAlertMessage as a, type HqSessionSummary as a0, type HqSnapshot as a1, type HqSocketFactory as a2, type HqSocketLike as a3, type HqSubagentSummary as a4, type HqToolArgsPolicy as a5, type HqToolCompletedPayload as a6, type HqToolStartedPayload as a7, type HqUsagePayload as a8, type HqWelcomePayload as a9, type HqWorklistCounts as aa, type HqWorklistSnapshotPayload as ab, type HqWorkspaceKind as ac, createHqEventEnvelope as ad, createMailboxEventPayload as ae, createMailboxSnapshotPayload as af, createMailboxSnapshotPayloadFromMailbox as ag, mapMailboxAgentToHqSummary as ah, mapMailboxMessageToHqSummary as ai, parseHqEventPayload as aj, parseHqFrame as ak, resolveProjectDir as al, type HqBrowserEventMessage as b, type HqBrowserMessage as c, type HqBrowserSnapshotMessage as d, type HqClientCapability as e, type HqClientCommandAckMessage as f, type HqClientCommandPollMessage as g, type HqClientEventMessage as h, type HqClientHeartbeatPayload as i, type HqClientHelloMessage as j, type HqClientHelloPayload as k, type HqClientIdentity as l, type HqClientKind as m, type HqClientMessage as n, type HqClientRecord as o, type HqEventEnvelope as p, type HqEventPayloadResult as q, type HqEventType as r, type HqFleetEventPayload as s, type HqFleetSnapshotPayload as t, type HqFleetSummary as u, type HqGitSnapshotPayload as v, type HqMailboxAgentStatus as w, type HqMailboxAgentSummary as x, type HqMailboxEventAction as y, type HqMailboxEventPayload as z };
+export { type HqServerMessage as $, type HqMailboxAgentSummary as A, type HqMailboxEventAction as B, type HqMailboxEventPayload as C, DEFAULT_HQ_REDACTION_POLICY as D, type HqMailboxMappingOptions as E, type HqMailboxMessageSummary as F, GlobalMailbox as G, HQ_PROTOCOL_VERSION as H, type HqMailboxMessageType as I, type HqMailboxPriority as J, type HqMailboxSnapshotOptions as K, type HqMailboxSnapshotPayload as L, type HqMailboxSummary as M, type HqParseResult as N, type HqPathPolicy as O, type HqProjectIdentity as P, type HqProjectRecord as Q, type HqProjectStatus as R, type HqProtocolVersion as S, type HqPublishEventOptions as T, HqPublisher as U, type HqPublisherCommandHandler as V, type HqPublisherCommandResult as W, type HqPublisherOptions as X, type HqQueuedCommand as Y, type HqRedactionPolicy as Z, type HqServerCommandBatchMessage as _, type HqAgentMessagePayload as a, type HqSessionAgentLiveStatus as a0, type HqSessionAgentSummary as a1, type HqSessionEndedPayload as a2, type HqSessionLiveStatus as a3, type HqSessionSnapshotPayload as a4, type HqSessionStartedPayload as a5, type HqSessionStatus as a6, type HqSessionStatusPayload as a7, type HqSessionSummary as a8, type HqSnapshot as a9, type HqSocketFactory as aa, type HqSocketLike as ab, type HqSubagentSummary as ac, type HqToolArgsPolicy as ad, type HqToolCompletedPayload as ae, type HqToolStartedPayload as af, type HqTranscriptAppendPayload as ag, type HqTranscriptEntry as ah, type HqTranscriptRole as ai, type HqUsagePayload as aj, type HqWelcomePayload as ak, type HqWorklistCounts as al, type HqWorklistSnapshotPayload as am, type HqWorkspaceKind as an, createHqEventEnvelope as ao, createMailboxEventPayload as ap, createMailboxSnapshotPayload as aq, createMailboxSnapshotPayloadFromMailbox as ar, mapMailboxAgentToHqSummary as as, mapMailboxMessageToHqSummary as at, parseHqEventPayload as au, parseHqFrame as av, resolveProjectDir as aw, type HqAgentStatusPayload as b, type HqAlertMessage as c, type HqBrowserEventMessage as d, type HqBrowserMessage as e, type HqBrowserSnapshotMessage as f, type HqClientCapability as g, type HqClientCommandAckMessage as h, type HqClientCommandPollMessage as i, type HqClientEventMessage as j, type HqClientHeartbeatPayload as k, type HqClientHelloMessage as l, type HqClientHelloPayload as m, type HqClientIdentity as n, type HqClientKind as o, type HqClientMessage as p, type HqClientRecord as q, type HqEventEnvelope as r, type HqEventPayloadResult as s, type HqEventType as t, type HqFleetEventPayload as u, type HqFleetSnapshotPayload as v, type HqFleetSummary as w, type HqGitSnapshotPayload as x, type HqMachineRecord as y, type HqMailboxAgentStatus as z };

package/dist/{goal-preamble-CA_4yiGQ.d.ts → goal-preamble-hM8BH7TK.d.ts}

@@ -1,14 +1,14 @@
 import { S as SkillLoader, a as SkillManifest, b as SkillEntry } from './skill-DGIXCtdv.js';
 import { W as WstackPaths } from './wstack-paths-hOpNLmvf.js';
-import { P as Provider, C as Context } from './context-Dp87Bcaq.js';
-import { C as Compactor, a as CompactReport } from './compactor-C2RKEBtC.js';
-import { M as MessageSelector } from './selector-CXl2_y9W.js';
-import { E as EventBus } from './brain-BYcK__Ym.js';
-import { M as MiddlewareHandler } from './pipeline-l_zzFRh3.js';
-import { S as SessionEventBridge } from './session-event-bridge-Ccud20CC.js';
-import { C as ContextWindowAggressiveOn, h as ContextWindowPolicy } from './config-C_ae2k86.js';
-import { g as Agent, D as DoneCondition } from './agent-subagent-runner-SHJW7t8q.js';
-import { R as RunResult, S as SystemPromptContributor } from './index-W4VJCzHa.js';
+import { P as Provider, C as Context } from './context-Dw55zZ_Q.js';
+import { C as Compactor, a as CompactReport } from './compactor-72ug-ZRB.js';
+import { M as MessageSelector } from './selector-C4ORTOid.js';
+import { E as EventBus } from './brain-etbcbRwV.js';
+import { M as MiddlewareHandler } from './pipeline-Ckkn3AOA.js';
+import { S as SessionEventBridge } from './session-event-bridge-CeNpUL9w.js';
+import { C as ContextWindowAggressiveOn, h as ContextWindowPolicy } from './config-rRS8yorV.js';
+import { g as Agent, D as DoneCondition } from './agent-subagent-runner-BZa_IEcd.js';
+import { R as RunResult, S as SystemPromptContributor } from './index-DWm_PE9L.js';
 
 interface SkillLoaderOptions {
     paths: WstackPaths;

package/dist/{goal-store-DhuJoUNG.d.ts → goal-store-CWlbT0TO.d.ts}

@@ -1,4 +1,4 @@
-import { E as EventBus } from './brain-BYcK__Ym.js';
+import { E as EventBus } from './brain-etbcbRwV.js';
 
 /**
  * Long-running autonomous mission. A goal survives across sessions and