@k-leumas/queque-cli 0.5.2 → 0.6.0

package/dist/cli/app.js

@@ -83,7 +83,7 @@ var init_uuid = __esm({
 });
 
 // node_modules/.pnpm/@anthropic-ai+sdk@0.92.0_zod@4.1.5/node_modules/@anthropic-ai/sdk/internal/errors.mjs
-function isAbortError(err) {
+function isAbortError2(err) {
   return typeof err === "object" && err !== null && // Spec-compliant fetch implementations
   ("name" in err && err.name === "AbortError" || // Expo fetch
   "message" in err && String(err.message).includes("FetchRequestCanceledException"));
@@ -841,7 +841,7 @@ var init_streaming = __esm({
             }
             done = true;
           } catch (e) {
-            if (isAbortError(e))
+            if (isAbortError2(e))
               return;
             throw e;
           } finally {
@@ -884,7 +884,7 @@ var init_streaming = __esm({
             }
             done = true;
           } catch (e) {
-            if (isAbortError(e))
+            if (isAbortError2(e))
               return;
             throw e;
           } finally {
@@ -3225,7 +3225,7 @@ var init_BetaMessageStream = __esm({
         _BetaMessageStream_logger.set(this, void 0);
         _BetaMessageStream_handleError.set(this, (error43) => {
           __classPrivateFieldSet(this, _BetaMessageStream_errored, true, "f");
-          if (isAbortError(error43)) {
+          if (isAbortError2(error43)) {
             error43 = new APIUserAbortError();
           }
           if (error43 instanceof APIUserAbortError) {
@@ -5424,7 +5424,7 @@ var init_MessageStream = __esm({
         _MessageStream_logger.set(this, void 0);
         _MessageStream_handleError.set(this, (error43) => {
           __classPrivateFieldSet(this, _MessageStream_errored, true, "f");
-          if (isAbortError(error43)) {
+          if (isAbortError2(error43)) {
             error43 = new APIUserAbortError();
           }
           if (error43 instanceof APIUserAbortError) {
@@ -6559,7 +6559,7 @@ var init_client = __esm({
           if (options.signal?.aborted) {
             throw new APIUserAbortError();
           }
-          const isTimeout = isAbortError(response) || /timed? ?out/i.test(String(response) + ("cause" in response ? String(response.cause) : ""));
+          const isTimeout = isAbortError2(response) || /timed? ?out/i.test(String(response) + ("cause" in response ? String(response.cause) : ""));
           if (retriesRemaining) {
             loggerFor(this).info(`[${requestLogID}] connection ${isTimeout ? "timed out" : "failed"} - ${retryMessage}`);
             loggerFor(this).debug(`[${requestLogID}] connection ${isTimeout ? "timed out" : "failed"} (${retryMessage})`, formatRequestDetails({
@@ -33239,7 +33239,7 @@ var require_websocket = __commonJS({
     var http = __require("http");
     var net4 = __require("net");
     var tls = __require("tls");
-    var { randomBytes, createHash } = __require("crypto");
+    var { randomBytes, createHash: createHash2 } = __require("crypto");
     var { Duplex, Readable } = __require("stream");
     var { URL: URL2 } = __require("url");
     var PerMessageDeflate2 = require_permessage_deflate();
@@ -33899,7 +33899,7 @@ var require_websocket = __commonJS({
           abortHandshake(websocket, socket, "Invalid Upgrade header");
           return;
         }
-        const digest = createHash("sha1").update(key + GUID).digest("base64");
+        const digest = createHash2("sha1").update(key + GUID).digest("base64");
         if (res.headers["sec-websocket-accept"] !== digest) {
           abortHandshake(websocket, socket, "Invalid Sec-WebSocket-Accept header");
           return;
@@ -34266,7 +34266,7 @@ var require_websocket_server = __commonJS({
     var EventEmitter3 = __require("events");
     var http = __require("http");
     var { Duplex } = __require("stream");
-    var { createHash } = __require("crypto");
+    var { createHash: createHash2 } = __require("crypto");
     var extension2 = require_extension();
     var PerMessageDeflate2 = require_permessage_deflate();
     var subprotocol2 = require_subprotocol();
@@ -34567,7 +34567,7 @@ var require_websocket_server = __commonJS({
           );
         }
         if (this._state > RUNNING) return abortHandshake(socket, 503);
-        const digest = createHash("sha1").update(key + GUID).digest("base64");
+        const digest = createHash2("sha1").update(key + GUID).digest("base64");
         const headers = [
           "HTTP/1.1 101 Switching Protocols",
           "Upgrade: websocket",
@@ -48088,7 +48088,14 @@ var privacyConfigSchema = external_exports.object({
 var safetyConfigSchema = external_exports.object({
   destructiveCommandPatterns: external_exports.array(external_exports.string()).optional()
 }).optional();
+var EFFORT_LEVELS = ["low", "medium", "high", "xhigh", "max"];
+var DEFAULT_EFFORT = "low";
+var effortSchema = external_exports.preprocess(
+  (value) => typeof value === "string" ? value.trim().toLowerCase() : value,
+  external_exports.enum(EFFORT_LEVELS)
+).optional().catch(void 0);
 var qqConfigFileSchema = external_exports.object({
+  effort: effortSchema,
   privacy: privacyConfigSchema,
   safety: safetyConfigSchema
 });
@@ -48153,10 +48160,14 @@ function loadQqConfig() {
     sensitivePathRegexes: compilePatterns(sensitivePatterns),
     redactLogKeys: new Set(redactKeys),
     allowFileRead,
-    destructiveCommandRegexes: compilePatterns(destructivePatterns)
+    destructiveCommandRegexes: compilePatterns(destructivePatterns),
+    effort: file2.effort ?? DEFAULT_EFFORT
   };
   return cachedConfig;
 }
+function resolveEffort() {
+  return loadQqConfig().effort;
+}
 
 // src/shared/privacy-filter.ts
 function isSensitivePath(path5) {
@@ -48411,6 +48422,113 @@ function readEnvValueFromDotEnvLocal(key, startDir = process.cwd()) {
   return result;
 }
 
+// src/providers/candidate-stream.ts
+var MAX_STREAMED_CANDIDATES = 5;
+function createCandidateScanner(onCandidate) {
+  let started = false;
+  let finished = false;
+  let depth = 0;
+  let inString = false;
+  let escaped = false;
+  let inObject = false;
+  let objectText = "";
+  let emitted = 0;
+  const emit = (text) => {
+    let parsed;
+    try {
+      parsed = JSON.parse(text);
+    } catch {
+      return;
+    }
+    const candidate = commandCandidateSchema.safeParse(parsed);
+    if (!candidate.success) {
+      return;
+    }
+    emitted++;
+    onCandidate(candidate.data);
+    if (emitted >= MAX_STREAMED_CANDIDATES) {
+      finished = true;
+    }
+  };
+  return (text) => {
+    for (const ch of text) {
+      if (finished) {
+        return;
+      }
+      if (!started) {
+        if (ch === "[") {
+          started = true;
+          depth = 1;
+        }
+        continue;
+      }
+      if (inObject) {
+        objectText += ch;
+      }
+      if (inString) {
+        if (escaped) {
+          escaped = false;
+        } else if (ch === "\\") {
+          escaped = true;
+        } else if (ch === '"') {
+          inString = false;
+        }
+        continue;
+      }
+      if (ch === '"') {
+        inString = true;
+      } else if (ch === "[" || ch === "{") {
+        depth++;
+        if (ch === "{" && depth === 2) {
+          inObject = true;
+          objectText = ch;
+        }
+      } else if (ch === "]" || ch === "}") {
+        depth--;
+        if (ch === "}" && depth === 1 && inObject) {
+          const closed = objectText;
+          inObject = false;
+          objectText = "";
+          emit(closed);
+        } else if (depth <= 0) {
+          finished = true;
+        }
+      }
+    }
+  };
+}
+function stripJsonCodeFence(raw) {
+  const match = raw.trim().match(/^```(?:json)?\s*\n?([\s\S]*?)\n?```\s*$/);
+  return match ? match[1].trim() : raw.trim();
+}
+function parseStrictCandidateList(text) {
+  let parsed;
+  try {
+    parsed = JSON.parse(stripJsonCodeFence(text));
+  } catch {
+    return void 0;
+  }
+  const list = candidateListSchema.safeParse(parsed);
+  return list.success ? list.data : void 0;
+}
+
+// src/providers/provider.ts
+function abortError() {
+  const error43 = new Error("QueQue: request aborted");
+  error43.name = "AbortError";
+  return error43;
+}
+function isNormalStopReason(stopReason) {
+  return stopReason === "end_turn" || stopReason === "stop_sequence";
+}
+function isAbortError(error43) {
+  if (error43 === null || typeof error43 !== "object") {
+    return false;
+  }
+  const name = error43.name;
+  return name === "AbortError" || name === "APIUserAbortError";
+}
+
 // src/shared/tool-catalog.ts
 var CATALOG = Object.freeze(
   `
@@ -48480,6 +48598,8 @@ ${buildSteeringText(chunk.payload.tools)}`;
 
 // src/providers/claude.ts
 var DEFAULT_MODEL = "claude-sonnet-5";
+var SDK_MAX_TOKENS = 16e3;
+var TRUNCATED_RESPONSE_MESSAGE = "QueQue: Claude response was truncated";
 var cachedAnthropic;
 async function getAnthropicClient(apiKey) {
   if (cachedAnthropic?.apiKey === apiKey) {
@@ -48492,12 +48612,26 @@ async function getAnthropicClient(apiKey) {
   cachedAnthropic = { apiKey, client: new AnthropicSdk({ apiKey }) };
   return cachedAnthropic.client;
 }
+var EFFORT_UNSUPPORTED_MODEL_RE = /haiku|claude-3|sonnet-4-5(?!\d)|(?:sonnet|opus)-4-(?:0|1|2025\d*)(?!\d)/i;
+function sdkOutputConfig(model, effort) {
+  if (EFFORT_UNSUPPORTED_MODEL_RE.test(model)) {
+    return void 0;
+  }
+  return { effort };
+}
 function resolveModel() {
   return process.env.QQ_MODEL ?? readEnvValueFromDotEnvLocal("QQ_MODEL") ?? DEFAULT_MODEL;
 }
 function extractText(content) {
   return content.filter((block) => block.type === "text" && typeof block.text === "string").map((block) => block.text ?? "").join("").trim();
 }
+function completeCandidates(text) {
+  const rows = [];
+  createCandidateScanner((candidate) => {
+    rows.push(candidate);
+  })(text);
+  return rows;
+}
 function stripCodeFence(raw) {
   const m = raw.trim().match(/^```(?:json)?\s*\n?([\s\S]*?)\n?```\s*$/);
   return m ? m[1].trim() : raw.trim();
@@ -48516,6 +48650,24 @@ function parseCandidates(text) {
     return [{ command: 'echo ""', explanation: "QueQue: unexpected response format" }];
   }
 }
+function finalCandidateList(text, streamed, finishedNormally, logFields = {}) {
+  const strict = parseStrictCandidateList(text);
+  if (strict) {
+    return strict;
+  }
+  if (streamed.length > 0) {
+    return streamed;
+  }
+  if (!finishedNormally) {
+    const complete = completeCandidates(text);
+    if (complete.length === 0) {
+      void appendDebugLog("provider", "response truncated", logFields);
+      throw new Error(TRUNCATED_RESPONSE_MESSAGE);
+    }
+    return complete;
+  }
+  return parseCandidates(text);
+}
 function shouldForceSelector() {
   const configured = process.env.QQ_FORCE_SELECTOR ?? readEnvValueFromDotEnvLocal("QQ_FORCE_SELECTOR");
   return configured === "1" || configured === "true";
@@ -48559,7 +48711,7 @@ function buildPrompt(envelope) {
     )
   ].join("\n");
 }
-async function fetchCandidates(envelope, rbuffer = "", timeoutMs = 25e3) {
+async function fetchCandidates(envelope, rbuffer = "", timeoutMs = 25e3, options = {}) {
   const apiKey = usableSecret(process.env.ANTHROPIC_API_KEY) ?? usableSecret(readEnvValueFromDotEnvLocal("ANTHROPIC_API_KEY"));
   if (!apiKey) {
     throw new Error("ANTHROPIC_API_KEY is required in the environment or .env.local");
@@ -48567,33 +48719,57 @@ async function fetchCandidates(envelope, rbuffer = "", timeoutMs = 25e3) {
   const client = await getAnthropicClient(apiKey);
   const prompt = buildPrompt(envelope);
   const model = resolveModel();
+  const outputConfig = sdkOutputConfig(model, resolveEffort());
   void appendDebugLog("provider", "request start", {
     model,
+    effort: outputConfig?.effort ?? "none",
     cwd: envelope.base.cwd,
     rbufferLength: rbuffer.length,
     extras: envelope.extras.map((chunk) => chunk.kind)
   });
+  const { onCandidate, signal } = options;
+  const streamed = [];
   try {
-    const response = await client.messages.create(
+    const stream = client.messages.stream(
       {
         model,
-        max_tokens: 1024,
+        max_tokens: SDK_MAX_TOKENS,
         system: buildSystemPrompt(envelope),
-        messages: [{ role: "user", content: prompt }]
+        messages: [{ role: "user", content: prompt }],
+        ...outputConfig ? { output_config: outputConfig } : {}
       },
-      {
-        timeout: timeoutMs
-      }
+      { timeout: timeoutMs, signal: options.signal }
     );
-    const text = extractText(response.content);
-    const candidates = ensureSelectableCandidates(parseCandidates(text));
+    if (onCandidate) {
+      const scan = createCandidateScanner((candidate) => {
+        streamed.push(candidate);
+        if (!signal?.aborted) {
+          onCandidate(candidate);
+        }
+      });
+      stream.on("text", (textDelta) => {
+        scan(textDelta);
+      });
+    }
+    const message = await stream.finalMessage();
+    const text = extractText(message.content);
+    const finalList = finalCandidateList(text, streamed, isNormalStopReason(message.stop_reason), {
+      model,
+      stopReason: message.stop_reason
+    });
+    const candidates = ensureSelectableCandidates(finalList);
     void appendDebugLog("provider", "response parsed", {
       model,
       candidateCount: candidates.length,
+      streamedCount: streamed.length,
       forceSelector: shouldForceSelector()
     });
     return candidates;
   } catch (error43) {
+    if (isAbortError(error43) || signal?.aborted) {
+      void appendDebugLog("provider", "request aborted", { model });
+      throw abortError();
+    }
     void appendDebugLog("provider", "request failed", {
       model,
       message: error43 instanceof Error ? error43.message : String(error43)
@@ -48602,158 +48778,636 @@ async function fetchCandidates(envelope, rbuffer = "", timeoutMs = 25e3) {
   }
 }
 var claudeAdapter = {
-  fetchCandidates
+  fetchCandidates: (envelope, options) => fetchCandidates(envelope, "", 25e3, options)
 };
 
-// src/providers/claude-exec.ts
+// src/providers/claude-prewarm.ts
+import { createHash } from "crypto";
+
+// src/providers/claude-process.ts
 import { spawn } from "child_process";
-async function execFileAsync3(file2, args, options = {}) {
-  const encoding = options.encoding ?? "utf8";
-  const maxBuffer = options.maxBuffer ?? 1024 * 1024;
-  const killSignal = options.killSignal ?? "SIGTERM";
-  const stdio = options.stdio ?? ["ignore", "pipe", "pipe"];
-  const timeoutMs = options.timeout;
-  if (typeof timeoutMs === "number" && timeoutMs <= 0) {
-    const error43 = Object.assign(new Error(`Command timed out: ${file2}`), {
-      killed: true,
-      signal: killSignal,
-      code: null,
-      stdout: "",
-      stderr: ""
-    });
-    throw error43;
+import { StringDecoder } from "string_decoder";
+
+// src/providers/stream-json.ts
+var STREAM_JSON_CARRY_CAP_BYTES = 1024 * 1024;
+var streamJsonResultSchema = external_exports.object({
+  type: external_exports.literal("result"),
+  is_error: external_exports.boolean(),
+  result: external_exports.string().optional(),
+  subtype: external_exports.string().optional(),
+  duration_api_ms: external_exports.number().optional(),
+  /**
+   * Claude Code 2.1.285 records it on `result` (Probe 2, `"end_turn"`); older builds and the
+   * Probe 3 auth result leave it out. Null is kept so the runner can fail closed on it.
+   */
+  stop_reason: external_exports.string().nullable().optional()
+});
+function isRecord(value) {
+  return value !== null && typeof value === "object";
+}
+function createLineParser(onEvent, options = {}) {
+  const maxCarryBytes = options.maxCarryBytes ?? STREAM_JSON_CARRY_CAP_BYTES;
+  let carry = "";
+  let carryBytes = 0;
+  let overflowed = false;
+  return (chunk) => {
+    if (overflowed) {
+      return;
+    }
+    carry += chunk;
+    let nl = carry.indexOf("\n");
+    if (nl === -1) {
+      carryBytes += Buffer.byteLength(chunk, "utf8");
+    } else {
+      while (nl !== -1) {
+        const line = carry.slice(0, nl).trim();
+        carry = carry.slice(nl + 1);
+        nl = carry.indexOf("\n");
+        if (!line) {
+          continue;
+        }
+        let event;
+        try {
+          event = JSON.parse(line);
+        } catch {
+          continue;
+        }
+        onEvent(event);
+      }
+      carryBytes = Buffer.byteLength(carry, "utf8");
+    }
+    if (carryBytes > maxCarryBytes) {
+      overflowed = true;
+      carry = "";
+      carryBytes = 0;
+      options.onOverflow?.();
+    }
+  };
+}
+function textDeltaOf(event) {
+  if (!isRecord(event) || event.type !== "stream_event") {
+    return void 0;
+  }
+  const inner = event.event;
+  if (!isRecord(inner) || inner.type !== "content_block_delta") {
+    return void 0;
+  }
+  const delta = inner.delta;
+  if (!isRecord(delta) || delta.type !== "text_delta" || typeof delta.text !== "string") {
+    return void 0;
+  }
+  return delta.text;
+}
+function isInitEvent(event) {
+  return isRecord(event) && event.type === "system" && event.subtype === "init";
+}
+function buildStreamJsonUserLine(prompt) {
+  return `${JSON.stringify({ type: "user", message: { role: "user", content: prompt } })}
+`;
+}
+
+// src/providers/claude-process.ts
+var SIGKILL_GRACE_MS = 1500;
+var POST_RESULT_BACKSTOP_MS = 2e3;
+var STDERR_CAP_BYTES = 64 * 1024;
+function turnFailure(message, reason, sawInit, fields) {
+  return Object.assign(new Error(message), { ...fields, reason, sawInit });
+}
+function timeoutFailure(stderr, sawInit) {
+  return turnFailure("Command timed out: claude", "timeout", sawInit, {
+    killed: true,
+    signal: "SIGTERM",
+    code: null,
+    stdout: "",
+    stderr
+  });
+}
+function isRunning(child) {
+  return child.pid !== void 0 && child.exitCode === null && child.signalCode === null;
+}
+function isRecord2(value) {
+  return value !== null && typeof value === "object";
+}
+function spawnClaudeChild(command, argv, cwd2, env3) {
+  return spawn(command, [...argv], {
+    cwd: cwd2,
+    env: env3,
+    stdio: ["pipe", "pipe", "pipe"],
+    shell: false,
+    windowsHide: true
+  });
+}
+function terminateChild(child, graceMs = SIGKILL_GRACE_MS) {
+  if (child.exitCode !== null || child.signalCode !== null) {
+    return;
+  }
+  child.kill("SIGTERM");
+  const killTimer = setTimeout(() => {
+    if (child.exitCode === null && child.signalCode === null) {
+      child.kill("SIGKILL");
+    }
+  }, graceMs);
+  killTimer.unref();
+  child.once("exit", () => {
+    clearTimeout(killTimer);
+  });
+}
+function runClaudeTurn(options) {
+  const { command, argv, cwd: cwd2, env: env3, prompt, budgetMs, signal, onTextDelta, onStage } = options;
+  const backstopMs = options.backstopMs ?? POST_RESULT_BACKSTOP_MS;
+  const killGraceMs = options.killGraceMs ?? SIGKILL_GRACE_MS;
+  const prewarmed = options.child;
+  if (signal?.aborted) {
+    if (prewarmed) {
+      terminateChild(prewarmed, killGraceMs);
+    }
+    return Promise.reject(abortError());
+  }
+  if (budgetMs <= 0) {
+    if (prewarmed) {
+      terminateChild(prewarmed, killGraceMs);
+    }
+    return Promise.reject(timeoutFailure("", false));
+  }
+  if (prewarmed && !isRunning(prewarmed)) {
+    return Promise.reject(
+      turnFailure("Command failed: claude", "exit-without-result", false, {
+        code: prewarmed.exitCode,
+        killed: false,
+        signal: prewarmed.signalCode,
+        stdout: "",
+        stderr: ""
+      })
+    );
   }
   return new Promise((resolve3, reject) => {
     let settled = false;
-    const finish = (callback) => {
+    let sawInit = false;
+    let sawDelta = false;
+    let stderr = "";
+    let stderrBytes = 0;
+    let budgetTimer;
+    let initTimer;
+    let backstopArmed = false;
+    const child = prewarmed ?? spawnClaudeChild(command, argv, cwd2, env3);
+    const onAbort = () => {
+      if (settled) {
+        return;
+      }
+      onStage?.("aborted");
+      terminateChild(child, killGraceMs);
+      finish(() => reject(abortError()));
+    };
+    const collectStderr = (chunk) => {
+      if (stderrBytes >= STDERR_CAP_BYTES) {
+        return;
+      }
+      const bytes = Buffer.byteLength(chunk, "utf8");
+      if (stderrBytes + bytes <= STDERR_CAP_BYTES) {
+        stderr += chunk;
+        stderrBytes += bytes;
+        return;
+      }
+      const room = STDERR_CAP_BYTES - stderrBytes;
+      stderr += new StringDecoder("utf8").write(Buffer.from(chunk, "utf8").subarray(0, room));
+      stderrBytes = STDERR_CAP_BYTES;
+    };
+    const armBackstop = () => {
+      if (backstopArmed) {
+        return;
+      }
+      backstopArmed = true;
+      const backstopTimer = setTimeout(() => {
+        terminateChild(child, killGraceMs);
+      }, backstopMs);
+      backstopTimer.unref();
+      child.once("exit", () => {
+        clearTimeout(backstopTimer);
+      });
+    };
+    const onOverflow = () => {
+      if (settled) {
+        return;
+      }
+      terminateChild(child, killGraceMs);
+      finish(
+        () => reject(
+          turnFailure("Command failed: claude", "invalid-result", sawInit, {
+            code: null,
+            killed: false,
+            signal: null,
+            stdout: "",
+            stderr
+          })
+        )
+      );
+    };
+    function finish(callback) {
       if (settled) {
         return;
       }
       settled = true;
+      if (budgetTimer) {
+        clearTimeout(budgetTimer);
+      }
+      if (initTimer) {
+        clearTimeout(initTimer);
+      }
+      signal?.removeEventListener("abort", onAbort);
       callback();
-    };
-    const child = spawn(file2, [...args], {
-      cwd: options.cwd,
-      env: options.env,
-      stdio,
-      windowsHide: options.windowsHide ?? true,
-      shell: options.shell ?? false
-    });
-    const stdoutChunks = [];
-    const stderrChunks = [];
-    let exceededBuffer = false;
-    let timedOut = false;
-    let timer;
-    function combined(chunks) {
-      return Buffer.concat(chunks).toString(encoding);
     }
-    function pushChunk(chunks, chunk) {
-      chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
-      if (Buffer.concat(chunks).length > maxBuffer) {
-        exceededBuffer = true;
-        child.kill(killSignal);
+    const handleEvent = (event) => {
+      if (settled) {
+        return;
       }
-    }
-    if (typeof timeoutMs === "number") {
-      timer = setTimeout(() => {
-        timedOut = true;
-        child.kill(killSignal);
-      }, timeoutMs);
-    }
-    child.stdout?.on("data", (chunk) => {
-      pushChunk(stdoutChunks, chunk);
-    });
-    child.stderr?.on("data", (chunk) => {
-      pushChunk(stderrChunks, chunk);
-    });
-    child.on("error", (error43) => {
-      if (timer) {
-        clearTimeout(timer);
+      if (isInitEvent(event)) {
+        if (!sawInit) {
+          sawInit = true;
+          if (initTimer) {
+            clearTimeout(initTimer);
+          }
+          onStage?.("init");
+        }
+        return;
       }
-      finish(() => {
-        reject(error43);
-      });
-    });
-    child.on("close", (code, signal) => {
-      if (timer) {
-        clearTimeout(timer);
+      const text = textDeltaOf(event);
+      if (text !== void 0) {
+        if (!sawDelta) {
+          sawDelta = true;
+          onStage?.("first-delta");
+        }
+        if (!settled) {
+          onTextDelta?.(text);
+        }
+        return;
       }
-      const stdout = combined(stdoutChunks);
-      const stderr = combined(stderrChunks);
-      if (exceededBuffer || timedOut) {
-        const error43 = Object.assign(new Error(`Command timed out: ${file2}`), {
-          killed: true,
-          signal: signal ?? killSignal,
-          code: null,
-          stdout,
-          stderr
-        });
-        finish(() => {
-          reject(error43);
-        });
+      if (!isRecord2(event) || event.type !== "result") {
         return;
       }
-      if (code !== 0 && code !== null) {
-        const error43 = Object.assign(new Error(`Command failed: ${file2}`), {
-          code,
-          killed: false,
-          signal,
-          stdout,
-          stderr
-        });
-        finish(() => {
-          reject(error43);
-        });
+      armBackstop();
+      const parsed = streamJsonResultSchema.safeParse(event);
+      if (!parsed.success) {
+        finish(
+          () => reject(
+            turnFailure("Command failed: claude", "invalid-result", sawInit, {
+              code: null,
+              killed: false,
+              signal: null,
+              stdout: "",
+              stderr
+            })
+          )
+        );
         return;
       }
-      if (signal) {
-        const error43 = Object.assign(new Error(`Command killed: ${file2}`), {
-          killed: true,
-          signal,
-          code: null,
-          stdout,
-          stderr
-        });
-        finish(() => {
-          reject(error43);
-        });
+      if (parsed.data.is_error) {
+        finish(
+          () => reject(
+            turnFailure("Command failed: claude", "is-error", sawInit, {
+              code: 1,
+              killed: false,
+              signal: null,
+              stdout: parsed.data.result ?? "",
+              stderr
+            })
+          )
+        );
         return;
       }
-      finish(() => {
-        resolve3({ stdout, stderr });
-      });
+      const stopReason = parsed.data.stop_reason;
+      if (stopReason !== void 0 && !isNormalStopReason(parsed.data.stop_reason)) {
+        finish(
+          () => reject(
+            turnFailure("Command failed: claude", "truncated", sawInit, {
+              code: null,
+              killed: false,
+              signal: null,
+              stdout: parsed.data.result ?? "",
+              stderr,
+              stopReason
+            })
+          )
+        );
+        return;
+      }
+      onStage?.("result");
+      finish(() => resolve3(parsed.data.result ?? ""));
+    };
+    if (!prewarmed && child.pid !== void 0) {
+      onStage?.("spawned", { pid: child.pid });
+    }
+    child.stdout.setEncoding("utf8");
+    child.stdout.on("data", createLineParser(handleEvent, { onOverflow }));
+    child.stderr.setEncoding("utf8");
+    child.stderr.on("data", collectStderr);
+    child.on("error", (error43) => {
+      finish(() => reject(Object.assign(error43, { reason: "spawn-error", sawInit })));
+    });
+    child.on("exit", (code, exitSignal) => {
+      onStage?.("exit", { code, signal: exitSignal });
     });
+    child.on("close", (code, closeSignal) => {
+      finish(
+        () => reject(
+          turnFailure("Command failed: claude", "exit-without-result", sawInit, {
+            code,
+            killed: false,
+            signal: closeSignal,
+            stdout: "",
+            stderr
+          })
+        )
+      );
+    });
+    budgetTimer = setTimeout(() => {
+      if (settled) {
+        return;
+      }
+      onStage?.("timed-out");
+      terminateChild(child, killGraceMs);
+      finish(() => reject(timeoutFailure(stderr, sawInit)));
+    }, budgetMs);
+    budgetTimer.unref();
+    if (options.initDeadlineMs !== void 0) {
+      const initDeadlineMs = options.initDeadlineMs;
+      initTimer = setTimeout(() => {
+        if (settled || sawInit) {
+          return;
+        }
+        onStage?.("init-timed-out");
+        terminateChild(child, killGraceMs);
+        finish(
+          () => reject(
+            turnFailure("Command failed: claude", "stale-prewarm", false, {
+              code: null,
+              killed: false,
+              signal: null,
+              stdout: "",
+              stderr
+            })
+          )
+        );
+      }, initDeadlineMs);
+      initTimer.unref();
+    }
+    signal?.addEventListener("abort", onAbort, { once: true });
+    child.stdin.on("error", () => {
+    });
+    child.stdin.write(buildStreamJsonUserLine(prompt));
+    child.stdin.end();
   });
 }
 
+// src/providers/claude-prewarm.ts
+var enabled = false;
+var slot;
+var diedIdle = false;
+function prewarmKey(spec) {
+  return createHash("sha256").update(JSON.stringify({ command: spec.command, cwd: spec.cwd, argv: spec.argv })).digest("hex");
+}
+function enablePrewarm() {
+  enabled = true;
+}
+function disablePrewarm() {
+  retirePrewarmed();
+  enabled = false;
+  diedIdle = false;
+}
+function retireChild(child, graceMs) {
+  if (!isRunning(child)) {
+    return;
+  }
+  child.stdin.end();
+  const killTimer = setTimeout(() => {
+    if (isRunning(child)) {
+      child.kill("SIGKILL");
+    }
+  }, graceMs);
+  killTimer.unref();
+  child.once("exit", () => {
+    clearTimeout(killTimer);
+  });
+}
+function retireSlot(graceMs) {
+  const entry = slot;
+  if (!entry) {
+    return;
+  }
+  slot = void 0;
+  entry.state = "retired";
+  void appendDebugLog("provider", "prewarm retired", { pid: entry.child.pid ?? null });
+  retireChild(entry.child, graceMs);
+}
+function schedulePrewarm(spec) {
+  if (!enabled) {
+    return;
+  }
+  const key = prewarmKey(spec);
+  if (slot && slot.key === key && isRunning(slot.child)) {
+    return;
+  }
+  retireSlot(SIGKILL_GRACE_MS);
+  diedIdle = false;
+  let child;
+  try {
+    child = spawnClaudeChild(spec.command, spec.argv, spec.cwd, process.env);
+  } catch (error43) {
+    void appendDebugLog("provider", "prewarm spawn failed", {
+      code: error43.code ?? null
+    });
+    return;
+  }
+  const entry = { child, cwd: spec.cwd, key, state: "idle", spawnedAt: Date.now() };
+  slot = entry;
+  const clearIfIdle = () => {
+    if (slot === entry) {
+      slot = void 0;
+      diedIdle = true;
+    }
+  };
+  child.on("error", (error43) => {
+    const wasIdle = entry.state === "idle";
+    clearIfIdle();
+    if (wasIdle) {
+      void appendDebugLog("provider", "prewarm error", { code: error43.code ?? null });
+    }
+  });
+  child.stdin.on("error", () => {
+  });
+  child.on("exit", (code, signal) => {
+    clearIfIdle();
+    if (entry.state !== "taken") {
+      void appendDebugLog("provider", "prewarm exit", {
+        pid: child.pid ?? null,
+        code,
+        signal,
+        retired: entry.state === "retired"
+      });
+    }
+  });
+  if (child.pid !== void 0) {
+    void appendDebugLog("provider", "prewarm spawned", { pid: child.pid });
+  }
+}
+function takePrewarmed(spec) {
+  if (!enabled) {
+    return { miss: "disabled" };
+  }
+  const entry = slot;
+  if (!entry) {
+    const reason = diedIdle ? "dead" : "empty";
+    diedIdle = false;
+    return { miss: reason };
+  }
+  if (!isRunning(entry.child)) {
+    slot = void 0;
+    entry.state = "retired";
+    diedIdle = false;
+    return { miss: "dead" };
+  }
+  if (entry.cwd !== spec.cwd) {
+    retireSlot(SIGKILL_GRACE_MS);
+    return { miss: "cwd" };
+  }
+  if (entry.key !== prewarmKey(spec)) {
+    retireSlot(SIGKILL_GRACE_MS);
+    return { miss: "prompt" };
+  }
+  slot = void 0;
+  entry.state = "taken";
+  return { child: entry.child, spawnedAt: entry.spawnedAt };
+}
+function retirePrewarmed(graceMs = SIGKILL_GRACE_MS) {
+  retireSlot(graceMs);
+}
+
 // src/providers/claude-cli.ts
-async function fetchClaudeCliCandidates(envelope, remainingBudgetMs) {
-  const prompt = buildPrompt(envelope);
-  const args = [
+var WARM_INIT_DEADLINE_MS = 1500;
+var PREWARM_BOOT_ALLOWANCE_MS = 3e3;
+function warmInitDeadlineMs(spawnedAt, now = Date.now()) {
+  const ageMs = Math.max(0, now - spawnedAt);
+  return WARM_INIT_DEADLINE_MS + Math.max(0, PREWARM_BOOT_ALLOWANCE_MS - ageMs);
+}
+var CLAUDE_COMMAND = "claude";
+function buildClaudeCliArgv(envelope) {
+  return [
     "-p",
+    "--input-format",
+    "stream-json",
     "--output-format",
-    "text",
+    "stream-json",
+    "--verbose",
+    "--include-partial-messages",
+    "--effort",
+    resolveEffort(),
     "--safe-mode",
     "--tools",
     "",
     "--no-session-persistence",
     "--system-prompt",
-    buildSystemPrompt(envelope),
-    prompt
+    buildSystemPrompt(envelope)
   ];
-  const options = {
-    encoding: "utf8",
-    timeout: remainingBudgetMs,
-    killSignal: "SIGTERM",
-    maxBuffer: 1024 * 1024,
-    cwd: envelope.base.cwd,
-    env: process.env,
-    windowsHide: true,
-    shell: false,
-    stdio: ["ignore", "pipe", "pipe"]
+}
+async function fetchClaudeCliCandidates(envelope, remainingBudgetMs, options = {}) {
+  const startedAt = Date.now();
+  const deadline = startedAt + remainingBudgetMs;
+  const streamed = [];
+  const { onCandidate, signal } = options;
+  const spec = {
+    command: CLAUDE_COMMAND,
+    argv: buildClaudeCliArgv(envelope),
+    cwd: envelope.base.cwd
   };
-  const { stdout } = await execFileAsync3("claude", args, options);
-  return ensureSelectableCandidates(parseCandidates(stdout));
+  const prompt = buildPrompt(envelope);
+  const createTextDeltaHandler = () => onCandidate ? createCandidateScanner((candidate) => {
+    streamed.push(candidate);
+    if (streamed.length === 1) {
+      void appendDebugLog("provider", "cli first candidate", { ms: Date.now() - startedAt });
+    }
+    if (!signal?.aborted) {
+      onCandidate(candidate);
+    }
+  }) : void 0;
+  const runTurn = (child, budgetMs, initDeadlineMs) => runClaudeTurn({
+    command: spec.command,
+    argv: spec.argv,
+    cwd: spec.cwd,
+    env: process.env,
+    prompt,
+    budgetMs,
+    signal,
+    onTextDelta: createTextDeltaHandler(),
+    onStage: (stage, detail) => {
+      logTurnStage(stage, detail, Date.now() - startedAt, child !== void 0);
+    },
+    ...child ? { child } : {},
+    ...initDeadlineMs === void 0 ? {} : { initDeadlineMs }
+  });
+  try {
+    let text;
+    let finishedNormally = true;
+    let stopReason;
+    try {
+      const take = takePrewarmed(spec);
+      if ("child" in take) {
+        void appendDebugLog("provider", "prewarm hit");
+        try {
+          text = await runTurn(take.child, remainingBudgetMs, warmInitDeadlineMs(take.spawnedAt));
+        } catch (error43) {
+          const leftMs = deadline - Date.now();
+          if (!isStalePrewarmFailure(error43) || streamed.length > 0 || signal?.aborted || leftMs <= 0) {
+            throw error43;
+          }
+          void appendDebugLog("provider", "prewarm retry cold", { ms: Date.now() - startedAt });
+          text = await runTurn(void 0, leftMs);
+        }
+      } else {
+        void appendDebugLog("provider", "prewarm miss", { reason: take.miss });
+        text = await runTurn(void 0, remainingBudgetMs);
+      }
+    } catch (error43) {
+      if (!isTruncatedFailure(error43)) {
+        throw error43;
+      }
+      const stdout = error43.stdout;
+      text = typeof stdout === "string" ? stdout : "";
+      finishedNormally = false;
+      stopReason = error43.stopReason;
+    }
+    return ensureSelectableCandidates(
+      finalCandidateList(text, streamed, finishedNormally, { stopReason })
+    );
+  } finally {
+    schedulePrewarm(spec);
+  }
+}
+function isStalePrewarmFailure(error43) {
+  if (error43 === null || typeof error43 !== "object") {
+    return false;
+  }
+  const reason = error43.reason;
+  return reason === "exit-without-result" || reason === "stale-prewarm";
+}
+function isTruncatedFailure(error43) {
+  if (error43 === null || typeof error43 !== "object") {
+    return false;
+  }
+  const reason = error43.reason;
+  return reason === "truncated";
+}
+var STAGE_LOG_NAMES = {
+  spawned: "cli spawned",
+  init: "cli init",
+  "first-delta": "cli first delta",
+  result: "cli result",
+  exit: "cli exit",
+  aborted: "cli aborted",
+  "timed-out": "cli timed out",
+  "init-timed-out": "cli init timed out"
+};
+function logTurnStage(stage, detail, ms, warm) {
+  const fields = stage === "exit" ? { ms, warm, code: detail?.code ?? null, signal: detail?.signal ?? null } : { ms, warm };
+  void appendDebugLog("provider", STAGE_LOG_NAMES[stage], fields);
 }
 
 // src/providers/claude-default.ts
@@ -48796,6 +49450,9 @@ function lookupApiKey() {
   return usableSecret(process.env.ANTHROPIC_API_KEY) ?? usableSecret(readEnvValueFromDotEnvLocal("ANTHROPIC_API_KEY"));
 }
 function hardError(error43) {
+  if (error43 instanceof Error && error43.message === TRUNCATED_RESPONSE_MESSAGE) {
+    return error43;
+  }
   if (isEnoent(error43)) {
     return new Error(ENOENT_MESSAGE);
   }
@@ -48808,18 +49465,22 @@ function hardError(error43) {
   return new Error(D13_MESSAGE);
 }
 var claudeDefaultAdapter = {
-  async fetchCandidates(envelope) {
+  async fetchCandidates(envelope, options) {
     const deadline = Date.now() + TOTAL_BUDGET_MS;
     const apiKey = lookupApiKey();
     if (apiKey) {
       void appendDebugLog("provider", "sdk path", {
         path: "sdk"
       });
-      return fetchCandidates(envelope, "", remainingMs(deadline));
+      return fetchCandidates(envelope, "", remainingMs(deadline), options);
     }
     try {
-      return await fetchClaudeCliCandidates(envelope, remainingMs(deadline));
+      return await fetchClaudeCliCandidates(envelope, remainingMs(deadline), options);
     } catch (error43) {
+      if (isAbortError(error43)) {
+        void appendDebugLog("provider", "claude-cli aborted");
+        throw error43;
+      }
       void appendDebugLog("provider", "claude-cli path", {
         path: "claude-cli",
         exitCode: exitCodeDetail(error43),
@@ -57261,8 +57922,8 @@ var Ink = class {
     };
     return { resume, [Symbol.asyncDispose]: resume };
   }
-  setAlternateScreen(enabled) {
-    this.alternateScreen = this.resolveAlternateScreenOption(enabled, this.interactive);
+  setAlternateScreen(enabled2) {
+    this.alternateScreen = this.resolveAlternateScreenOption(enabled2, this.interactive);
     if (this.alternateScreen) {
       this.writeBestEffort(this.options.stdout, base_exports.enterAlternativeScreen);
       this.writeBestEffort(this.options.stdout, hideCursorEscape);
@@ -58334,7 +58995,10 @@ var ipcRequestSchema = external_exports.discriminatedUnion("kind", [
   }),
   external_exports.object({
     kind: external_exports.literal("fetch-candidates"),
-    envelope: contextEnvelopeSchema
+    envelope: contextEnvelopeSchema,
+    // The client wants one `candidate` message per parsed row before the final
+    // `candidates` message (Phase 09.1). Old daemons strip the key and reply once.
+    stream: external_exports.literal(true).optional()
   })
 ]);
 var ipcResponseSchema = external_exports.discriminatedUnion("kind", [
@@ -58342,7 +59006,9 @@ var ipcResponseSchema = external_exports.discriminatedUnion("kind", [
     kind: external_exports.literal("pong"),
     fetchCandidates: external_exports.literal(true).optional(),
     // Daemon accepts envelopes carrying the `installed-tools` chunk (Phase 9).
-    installedTools: external_exports.literal(true).optional()
+    installedTools: external_exports.literal(true).optional(),
+    // Daemon streams `candidate` messages to a `stream: true` request (Phase 09.1).
+    streamCandidates: external_exports.literal(true).optional()
   }),
   external_exports.object({
     kind: external_exports.literal("session-ready"),
@@ -58355,6 +59021,12 @@ var ipcResponseSchema = external_exports.discriminatedUnion("kind", [
   external_exports.object({
     kind: external_exports.literal("fetch-accepted")
   }),
+  // One streamed row, sent only when the request carried `stream: true`.
+  external_exports.object({
+    kind: external_exports.literal("candidate"),
+    candidate: commandCandidateSchema
+  }),
+  // The done signal and the authoritative final list, for every request.
   external_exports.object({
     kind: external_exports.literal("candidates"),
     candidates: candidateListSchema
@@ -58447,7 +59119,7 @@ function pingDaemonFetchCap(socketPath2) {
         done("unknown");
         return;
       }
-      const current2 = response.data.fetchCandidates === true && response.data.installedTools === true;
+      const current2 = response.data.fetchCandidates === true && response.data.installedTools === true && response.data.streamCandidates === true;
       done(current2 ? "yes" : "no");
     });
     client.on("error", () => {
@@ -58568,12 +59240,19 @@ var IpcTransportError = class extends Error {
     this.name = "IpcTransportError";
   }
 };
-function requestDaemonFetch(socketPath2, envelope, timeoutMs = FETCH_TIMEOUT_MS) {
+function requestDaemonFetch(socketPath2, envelope, timeoutMs = FETCH_TIMEOUT_MS, options = {}) {
+  const { signal } = options;
+  if (signal?.aborted) {
+    return Promise.reject(abortError());
+  }
   return new Promise((resolve3, reject) => {
     const client = net2.createConnection(socketPath2);
     let buf = "";
     let settled = false;
     let accepted = false;
+    const onAbort = () => {
+      finish(abortError());
+    };
     const finish = (error43, candidates) => {
       if (settled) {
         return;
@@ -58581,6 +59260,7 @@ function requestDaemonFetch(socketPath2, envelope, timeoutMs = FETCH_TIMEOUT_MS)
       settled = true;
       clearTimeout(ackTimer);
       clearTimeout(timer);
+      signal?.removeEventListener("abort", onAbort);
       client.destroy();
       if (error43) {
         reject(error43);
@@ -58596,6 +59276,7 @@ function requestDaemonFetch(socketPath2, envelope, timeoutMs = FETCH_TIMEOUT_MS)
     const timer = setTimeout(() => {
       finish(new IpcTransportError("daemon fetch timed out"));
     }, timeoutMs);
+    signal?.addEventListener("abort", onAbort, { once: true });
     const handleResponse = (parsed) => {
       const response = ipcResponseSchema.safeParse(parsed);
       if (!response.success) {
@@ -58607,6 +59288,12 @@ function requestDaemonFetch(socketPath2, envelope, timeoutMs = FETCH_TIMEOUT_MS)
         clearTimeout(ackTimer);
         return;
       }
+      if (response.data.kind === "candidate") {
+        accepted = true;
+        clearTimeout(ackTimer);
+        options.onCandidate?.(response.data.candidate);
+        return;
+      }
       if (response.data.kind === "candidates") {
         accepted = true;
         finish(void 0, response.data.candidates);
@@ -58620,11 +59307,12 @@ function requestDaemonFetch(socketPath2, envelope, timeoutMs = FETCH_TIMEOUT_MS)
       finish(new IpcTransportError("unexpected daemon fetch response"));
     };
     client.on("connect", () => {
-      client.write(`${JSON.stringify({ kind: "fetch-candidates", envelope })}
+      client.write(`${JSON.stringify({ kind: "fetch-candidates", envelope, stream: true })}
 `);
     });
+    client.setEncoding("utf8");
     client.on("data", (chunk) => {
-      buf += chunk.toString();
+      buf += String(chunk);
       let nl = buf.indexOf("\n");
       while (nl !== -1) {
         const line = buf.slice(0, nl).trim();
@@ -58649,19 +59337,36 @@ function requestDaemonFetch(socketPath2, envelope, timeoutMs = FETCH_TIMEOUT_MS)
     client.on("error", (error43) => {
       finish(new IpcTransportError(error43.message));
     });
+    client.on("close", () => {
+      finish(new IpcTransportError("daemon connection closed"));
+    });
   });
 }
-async function fetchCandidatesForUi(socketPath2, envelope) {
+async function fetchCandidatesForUi(socketPath2, envelope, options = {}) {
+  let forwarded = 0;
+  const daemonOptions = {
+    signal: options.signal,
+    onCandidate: (candidate) => {
+      forwarded++;
+      options.onCandidate?.(candidate);
+    }
+  };
   try {
-    const candidates = await requestDaemonFetch(socketPath2, envelope);
+    const candidates = await requestDaemonFetch(socketPath2, envelope, void 0, daemonOptions);
     void appendDebugLog("client", "candidates from daemon", { count: candidates.length });
     return candidates;
   } catch (error43) {
     if (!(error43 instanceof IpcTransportError)) {
       throw error43;
     }
+    if (options.signal?.aborted) {
+      throw abortError();
+    }
+    if (forwarded > 0) {
+      throw error43;
+    }
     void appendDebugLog("client", "daemon fetch fallback", { message: error43.message });
-    return resolveClaudeDefaultAdapter().fetchCandidates(envelope);
+    return resolveClaudeDefaultAdapter().fetchCandidates(envelope, options);
   }
 }
 
@@ -59421,6 +60126,8 @@ function filterCandidates(candidates, query) {
   );
 }
 var MODAL_VIEWPORT_LINES = 18;
+var INCOMPLETE_LIST_NOTE = "list may be incomplete";
+var LIST_STATUS_ROW_LINES = 1;
 var MARK_COLUMNS = 2;
 function estimateCandidateSelectLines(input) {
   let lines = 0;
@@ -59451,6 +60158,9 @@ function estimateCandidateSelectLines(input) {
         lines += 1;
       }
     }
+    if (input.listState === "arriving" || input.listState === "partial") {
+      lines += LIST_STATUS_ROW_LINES;
+    }
   }
   const visible = input.candidates !== null && input.error !== true ? filterCandidates(input.candidates, input.query) : [];
   const selectedCandidate = visible[input.selectedIndex];
@@ -59510,30 +60220,42 @@ function CandidateSelect({
   onSelect,
   onCancel,
   error: error43,
-  onLayoutLinesChange
+  onLayoutLinesChange,
+  listState = "complete"
 }) {
   const { isRawModeSupported } = use_stdin_default();
   const { stdout } = use_stdout_default();
   const modalWidth = Math.min(MODAL_MAX_WIDTH, stdout.columns || MODAL_MAX_WIDTH);
   const contentWidth = modalWidth - MODAL_PADDING_X - ROW_GUTTER.length;
   const [selectedIndex, setSelectedIndex] = (0, import_react35.useState)(0);
-  const [query, setQuery] = (0, import_react35.useState)(initialQuery ?? "");
+  const [query, setQuery] = (0, import_react35.useState)("");
   const [installToggled, setInstallToggled] = (0, import_react35.useState)(/* @__PURE__ */ new Set());
   const [prevCandidates, setPrevCandidates] = (0, import_react35.useState)(null);
   const paneHold = (0, import_react35.useRef)({
     candidates: null,
     lines: 0
   });
+  const pendingInput = (0, import_react35.useRef)(null);
+  const renderToken = {};
   if (candidates !== prevCandidates) {
     setPrevCandidates(candidates);
-    if (selectedIndex !== 0) {
-      setSelectedIndex(0);
-    }
-    if (installToggled.size > 0) {
-      setInstallToggled(/* @__PURE__ */ new Set());
-    }
-    if (candidates && candidates.length > 0 && filterCandidates(candidates, query).length === 0) {
-      setQuery("");
+    if (prevCandidates === null) {
+      if (selectedIndex !== 0) {
+        setSelectedIndex(0);
+      }
+      if (installToggled.size > 0) {
+        setInstallToggled(/* @__PURE__ */ new Set());
+      }
+    } else if (candidates !== null) {
+      const highlighted = filterCandidates(prevCandidates, query)[selectedIndex];
+      const visible = filterCandidates(candidates, query);
+      const highlightedKey = highlighted === void 0 ? void 0 : candidateKey(highlighted);
+      const kept = highlightedKey === void 0 ? -1 : visible.findIndex((candidate) => candidateKey(candidate) === highlightedKey);
+      const current2 = Number.isFinite(selectedIndex) && selectedIndex >= 0 ? selectedIndex : 0;
+      const nextIndex = kept >= 0 ? kept : Math.max(0, Math.min(current2, visible.length - 1));
+      if (nextIndex !== selectedIndex) {
+        setSelectedIndex(nextIndex);
+      }
     }
   }
   (0, import_react35.useEffect)(() => {
@@ -59541,9 +60263,18 @@ function CandidateSelect({
       onCancel();
     }
   }, [isRawModeSupported, onCancel]);
-  (0, import_react35.useEffect)(() => {
-    setSelectedIndex(0);
-  }, [query]);
+  const applyInput = (live, next) => {
+    pendingInput.current = next;
+    if (next.query !== live.query) {
+      setQuery(next.query);
+    }
+    if (next.selectedIndex !== live.selectedIndex) {
+      setSelectedIndex(next.selectedIndex);
+    }
+    if (next.installToggled !== live.installToggled) {
+      setInstallToggled(next.installToggled);
+    }
+  };
   const includeDevFooter = process.env.QQ_DEV_ROOT != null;
   (0, import_react35.useEffect)(() => {
     if (!onLayoutLinesChange) {
@@ -59552,6 +60283,9 @@ function CandidateSelect({
     if (candidates === null && error43 !== true) {
       return;
     }
+    if (listState === "arriving" && error43 !== true) {
+      return;
+    }
     const layout = {
       candidates,
       initialQuery,
@@ -59560,7 +60294,8 @@ function CandidateSelect({
       error: error43,
       contentWidth,
       includeDevFooter,
-      installToggled
+      installToggled,
+      listState
     };
     const previousHeld = paneHold.current.candidates === candidates ? paneHold.current.lines : 0;
     const lines = heldPaneLines(previousHeld, layout);
@@ -59575,57 +60310,63 @@ function CandidateSelect({
     contentWidth,
     includeDevFooter,
     installToggled,
+    listState,
     onLayoutLinesChange
   ]);
   use_input_default(
     (input, key) => {
+      const live = pendingInput.current?.render === renderToken ? pendingInput.current : { render: renderToken, query, selectedIndex, installToggled };
       if (key.escape) {
         onCancel();
         return;
       }
       if (key.backspace) {
-        setQuery((q) => q.slice(0, -1));
+        if (live.query === "") {
+          return;
+        }
+        applyInput(live, { ...live, query: live.query.slice(0, -1), selectedIndex: 0 });
         return;
       }
       if (key.tab) {
         if (!candidates) return;
-        const visible = filterCandidates(candidates, query);
-        const selected = visible[selectedIndex] ?? visible[0];
+        const visible = filterCandidates(candidates, live.query);
+        const selected = visible[live.selectedIndex] ?? visible[0];
         if (selected?.install?.form == null) return;
         const id = candidateKey(selected);
-        setInstallToggled((previous) => {
-          const next = new Set(previous);
-          if (next.has(id)) {
-            next.delete(id);
-          } else {
-            next.add(id);
-          }
-          return next;
-        });
+        const toggled = new Set(live.installToggled);
+        if (toggled.has(id)) {
+          toggled.delete(id);
+        } else {
+          toggled.add(id);
+        }
+        applyInput(live, { ...live, installToggled: toggled });
         return;
       }
       if (key.return && candidates) {
-        const visible = filterCandidates(candidates, query);
+        const visible = filterCandidates(candidates, live.query);
         if (visible.length === 0) return;
-        const selected = visible[selectedIndex] ?? visible[0];
-        const command = displayedCommand(selected, installToggled);
+        const selected = visible[live.selectedIndex] ?? visible[0];
+        const command = displayedCommand(selected, live.installToggled);
         const original = normalizeCommand2(selected.command);
         const explanation = selected.explanation || `see man ${original.split(" ")[0]}`;
         onSelect(command, explanation);
         return;
       }
       if (input && !key.ctrl && !key.meta) {
-        setQuery((q) => q + input);
+        applyInput(live, { ...live, query: live.query + input, selectedIndex: 0 });
         return;
       }
       if (key.upArrow && candidates) {
-        const visible = filterCandidates(candidates, query);
-        setSelectedIndex((i) => i === 0 ? visible.length - 1 : i - 1);
+        const visible = filterCandidates(candidates, live.query);
+        if (visible.length === 0) return;
+        const index = live.selectedIndex;
+        applyInput(live, { ...live, selectedIndex: index <= 0 ? visible.length - 1 : index - 1 });
         return;
       }
       if (key.downArrow && candidates) {
-        const visible = filterCandidates(candidates, query);
-        setSelectedIndex((i) => (i + 1) % visible.length);
+        const visible = filterCandidates(candidates, live.query);
+        if (visible.length === 0) return;
+        applyInput(live, { ...live, selectedIndex: (live.selectedIndex + 1) % visible.length });
         return;
       }
     },
@@ -59684,13 +60425,15 @@ function CandidateSelect({
     initialQuery && initialQuery.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Box_default, { flexGrow: 0, height: 1, children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Text, { dimColor: true, wrap: "truncate", children: `queque \u203A ${initialQuery}` }) }),
     /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(SearchInput, { query }),
     content,
+    candidates !== null && error43 !== true && listState === "arriving" && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(LoadingSpinner, {}),
+    candidates !== null && error43 !== true && listState === "partial" && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Text, { dimColor: true, children: INCOMPLETE_LIST_NOTE }),
     showDestructiveWarning && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Box_default, { marginTop: 1, children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Text, { color: "yellow", children: DESTRUCTIVE_WARNING_TEXT }) }),
     legend !== void 0 && /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)(Box_default, { marginTop: 1, children: [
       /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Text, { color: "cyan", children: MISSING_TOOL_MARK }),
       /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Text, { dimColor: true, children: legend.slice(MISSING_TOOL_MARK.length) })
     ] }),
     /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(ControlsLine, {}),
-    process.env.QQ_DEV_ROOT != null && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Box_default, { justifyContent: "flex-end", children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Text, { color: "yellow", children: `dev v${"0.5.2"} ${"5ac6fa8"}` }) })
+    process.env.QQ_DEV_ROOT != null && /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Box_default, { justifyContent: "flex-end", children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(Text, { color: "yellow", children: `dev v${"0.6.0"} ${"3d6ffbb"}` }) })
   ] });
 }
 
@@ -60040,13 +60783,17 @@ async function runForegroundClient(args) {
         await new Promise((resolve3) => {
           let unmount;
           let resolved = false;
-          const buildCandidateElement = (candidates, errorState) => import_react36.default.createElement(CandidateSelect, {
+          const fetchAbort = new AbortController();
+          const streamed = [];
+          const buildCandidateElement = (candidates, errorState, listState = "complete") => import_react36.default.createElement(CandidateSelect, {
             candidates,
             initialQuery: request.lbuffer,
             error: errorState,
+            listState,
             onSelect: async (command, explanation) => {
               if (resolved) return;
               resolved = true;
+              fetchAbort.abort();
               const { lbuffer, rbuffer } = buildShellBuffers(command, explanation);
               await writeShellResult(resultFile, {
                 kind: "replace-buffer",
@@ -60059,6 +60806,7 @@ async function runForegroundClient(args) {
             onCancel: async () => {
               if (resolved) return;
               resolved = true;
+              fetchAbort.abort();
               await writeShellResult(resultFile, { kind: "cancel" });
               unmount?.();
             },
@@ -60075,6 +60823,7 @@ async function runForegroundClient(args) {
             }
           };
           const cleanupOnSignal = () => {
+            fetchAbort.abort();
             app.unmount();
             clearScrollReserve();
             process.exit(0);
@@ -60088,17 +60837,50 @@ async function runForegroundClient(args) {
             if (!skipClear) clearScrollReserve();
             resolve3();
           };
-          fetchCandidatesForUi(socketPath2, envelope).then((candidates) => {
+          const onCandidate = (candidate) => {
+            if (resolved) return;
+            streamed.push(candidate);
+            if (streamed.length === 1) {
+              void appendDebugLog("client", "first candidate received");
+            }
+            app.rerender(
+              buildCandidateElement(
+                annotateCandidates([...streamed], toolInventory),
+                void 0,
+                "arriving"
+              )
+            );
+          };
+          fetchCandidatesForUi(socketPath2, envelope, { signal: fetchAbort.signal, onCandidate }).then((candidates) => {
+            if (resolved) return;
             const displayCandidates = annotateCandidates(candidates, toolInventory);
             void appendDebugLog("client", "candidates received", {
               count: candidates.length,
+              streamed: streamed.length,
               flagged: displayCandidates.filter((c) => c.missingTools !== void 0).length
             });
-            app.rerender(buildCandidateElement(displayCandidates));
+            app.rerender(buildCandidateElement(displayCandidates, void 0, "complete"));
           }).catch(async (err) => {
+            if (isAbortError(err)) {
+              void appendDebugLog("client", "fetch aborted");
+              return;
+            }
             const message = err instanceof Error ? err.message : String(err);
             void appendDebugLog("client", "llm request failed", { message });
             if (resolved) return;
+            if (streamed.length > 0) {
+              void appendDebugLog("client", "llm request failed after rows", {
+                count: streamed.length
+              });
+              app.rerender(
+                buildCandidateElement(
+                  annotateCandidates([...streamed], toolInventory),
+                  void 0,
+                  "partial"
+                )
+              );
+              return;
+            }
             resolved = true;
             takeover?.clearNow();
             const errorMsg = formatFifoError(message);
@@ -60152,6 +60934,8 @@ function startDaemonServer(socketPath2) {
     const MAX_BUF_BYTES = 256 * 1024;
     const server = net3.createServer((socket) => {
       let buf = "";
+      const connectionAbort = new AbortController();
+      socket.setEncoding("utf8");
       void appendDebugLog("daemon", "socket connected", { socketPath: socketPath2 });
       const writeJson = (payload) => {
         if (socket.destroyed) {
@@ -60161,11 +60945,11 @@ function startDaemonServer(socketPath2) {
 `);
       };
       socket.on("data", (chunk) => {
-        if (buf.length + chunk.length > MAX_BUF_BYTES) {
+        if (Buffer.byteLength(buf) + Buffer.byteLength(chunk) > MAX_BUF_BYTES) {
           socket.destroy(new Error("IPC message too large"));
           return;
         }
-        buf += chunk.toString();
+        buf += chunk;
         let nl = buf.indexOf("\n");
         while (nl !== -1) {
           const line = buf.slice(0, nl).trim();
@@ -60187,7 +60971,12 @@ function startDaemonServer(socketPath2) {
           void appendDebugLog("daemon", "request received", { kind: req.kind });
           switch (req.kind) {
             case "ping": {
-              writeJson({ kind: "pong", fetchCandidates: true, installedTools: true });
+              writeJson({
+                kind: "pong",
+                fetchCandidates: true,
+                installedTools: true,
+                streamCandidates: true
+              });
               void appendDebugLog("daemon", "replied pong");
               break;
             }
@@ -60204,14 +60993,42 @@ function startDaemonServer(socketPath2) {
             }
             case "fetch-candidates": {
               writeJson({ kind: "fetch-accepted" });
-              bootstrapBuiltins();
-              const adapter = resolveClaudeDefaultAdapter();
-              void adapter.fetchCandidates(req.envelope).then((candidates) => {
+              const envelope = req.envelope;
+              let streamedIndex = 0;
+              const onCandidate = req.stream === true ? (candidate) => {
+                const index = streamedIndex++;
+                if (connectionAbort.signal.aborted) {
+                  void appendDebugLog("daemon", "candidate dropped", { index });
+                  return;
+                }
+                const row = commandCandidateSchema.safeParse(candidate);
+                if (!row.success) {
+                  return;
+                }
+                writeJson({ kind: "candidate", candidate: row.data });
+                void appendDebugLog("daemon", "replied candidate", { index });
+              } : void 0;
+              void Promise.resolve().then(() => {
+                bootstrapBuiltins();
+                const adapter = resolveClaudeDefaultAdapter();
+                return adapter.fetchCandidates(envelope, {
+                  signal: connectionAbort.signal,
+                  onCandidate
+                });
+              }).then((candidates) => {
+                if (connectionAbort.signal.aborted) {
+                  void appendDebugLog("daemon", "fetch aborted");
+                  return;
+                }
                 writeJson({ kind: "candidates", candidates });
                 void appendDebugLog("daemon", "replied candidates", {
                   count: candidates.length
                 });
               }).catch((error43) => {
+                if (connectionAbort.signal.aborted) {
+                  void appendDebugLog("daemon", "fetch aborted");
+                  return;
+                }
                 const message = error43 instanceof Error ? error43.message : String(error43);
                 writeJson({ kind: "fetch-error", message });
                 void appendDebugLog("daemon", "replied fetch-error", { message });
@@ -60223,6 +61040,9 @@ function startDaemonServer(socketPath2) {
       });
       socket.on("error", () => {
       });
+      socket.on("close", () => {
+        connectionAbort.abort();
+      });
     });
     server.on("error", reject);
     server.listen(socketPath2, () => {
@@ -60233,6 +61053,32 @@ function startDaemonServer(socketPath2) {
 }
 
 // src/cli/commands/daemon.ts
+function trackConnections(server) {
+  const connections = /* @__PURE__ */ new Set();
+  server.on("connection", (socket) => {
+    connections.add(socket);
+    socket.once("close", () => {
+      connections.delete(socket);
+    });
+  });
+  return connections;
+}
+function shutdownDaemon(server, connections, options = {}) {
+  const exit = options.exit ?? (() => process.exit(0));
+  const graceMs = options.graceMs ?? SIGKILL_GRACE_MS + 100;
+  disablePrewarm();
+  const inFlight = connections.size;
+  server.close(() => {
+    if (inFlight === 0) {
+      exit();
+      return;
+    }
+    setTimeout(exit, graceMs);
+  });
+  for (const socket of connections) {
+    socket.destroy();
+  }
+}
 async function daemonCommand(options) {
   const sock = options.socket ?? socketPath();
   void appendDebugLog("daemon", "command start", { socket: sock, ensure: options.ensure });
@@ -60242,12 +61088,12 @@ async function daemonCommand(options) {
     return;
   }
   const server = await startDaemonServer(sock);
+  const connections = trackConnections(server);
   void appendDebugLog("daemon", "server started", { socket: sock });
+  enablePrewarm();
   const shutdown = () => {
-    void appendDebugLog("daemon", "shutdown", { socket: sock });
-    server.close(() => {
-      process.exit(0);
-    });
+    void appendDebugLog("daemon", "shutdown", { socket: sock, inFlight: connections.size });
+    shutdownDaemon(server, connections);
   };
   process.once("SIGTERM", shutdown);
   process.once("SIGINT", shutdown);
@@ -60336,6 +61182,7 @@ async function main(argv = process.argv.slice(2)) {
     const requestFile = requiredOption("--request-file", options.requestFile);
     const resultFile = requiredOption("--result-file", options.resultFile);
     await clientCommand({ requestFile, resultFile, resultMode: options.resultMode });
+    process.exit(process.exitCode ?? 0);
   });
   cli.command(
     "init <shell>",