@mycompbox/compbox-cli 1.19.0 → 1.20.0

package/index.js

@@ -5555,76 +5555,10 @@ var INTERVIEW_DEFINITION = [
     fields: ["alternatives"]
   }
 ];
-var INTERVIEW_FIELD_MIN_WORDS = {
-  problemStatement: 60,
-  proposedSolution: 100,
-  impactAssessment: 40,
-  description: 150
-};
-function buildInterviewSystemPrompt(definition = INTERVIEW_DEFINITION, seedContext) {
-  const requiredSections = definition.filter((s) => s.required);
-  const optionalSections = definition.filter((s) => !s.required);
-  const renderSection = (s) => {
-    const tag = s.required ? "REQUIRED" : "OPTIONAL \u2014 ask, but the user may decline";
-    const followUps = s.followUps.map((q) => `    - ${q}`).join("\n");
-    return `- ${s.title} (${tag}) [json keys: ${s.fields.join(", ")}]
-  ${s.purpose}
-${followUps}`;
-  };
-  const completionKeys = [
-    "title",
-    ...interviewFieldKeysFor(definition),
-    "description"
-  ];
-  const completionShape = completionKeys.map((k) => `"${k}": "..."`).join(", ");
-  const base = `You are the CompBox request-formulator, interviewing an employee to turn their idea into a well-formed Epic Request. Ask exactly ONE short, focused question at a time \u2014 never multiple questions in one message, never preamble or explanation.
-
-Work through these interview sections in order. Cover EVERY required section; for optional sections, ask about them too, but if the employee has nothing to add or declines, move on and leave that field out (never invent or pad it):
-
-REQUIRED sections (an Epic Request cannot omit these):
-${requiredSections.map(renderSection).join("\n")}
-
-OPTIONAL-BUT-RECOMMENDED sections (ask about each; omit the field if the employee has nothing):
-${optionalSections.map(renderSection).join("\n")}
-
-The employee's answers may be short or casual \u2014 that's fine, but when you write the final fields below, EXPAND them into complete, well-written prose using everything they told you across the whole conversation, not just a compressed one-liner. Each required field is scored by an automated quality rubric with hard minimums, so undershooting length is a real failure, not just a style nitpick:
-- problemStatement: at least ${String(INTERVIEW_FIELD_MIN_WORDS.problemStatement)} words.
-- proposedSolution: at least ${String(INTERVIEW_FIELD_MIN_WORDS.proposedSolution)} words.
-- impactAssessment: at least ${String(INTERVIEW_FIELD_MIN_WORDS.impactAssessment)} words.
-- description: at least ${String(INTERVIEW_FIELD_MIN_WORDS.description)} words. This is a SEPARATE plain-text field (not shown to the employee) that stands alone as a full narrative summary of the whole request \u2014 restate the problem, the proposed solution, and the expected impact in flowing prose, as if writing the request from scratch for someone who hasn't seen the conversation.
-
-Once you have gathered the required sections (and covered the optional ones), respond with ONLY a fenced JSON code block (no other text) in exactly this shape. Include a key for every optional field you gathered; omit any optional field the employee had nothing for:
-\`\`\`json
-{"done": true, ${completionShape}}
-\`\`\`
-
-Until then, respond with ONLY your next question as plain text \u2014 no JSON, no labels, no numbering.`;
-  if (!seedContext || seedContext.priorTranscript.length === 0) {
-    return base;
-  }
-  return `${renderContinuationHeader(seedContext.priorTranscript)}
-
-${base}`;
-}
-function renderContinuationHeader(priorTranscript) {
-  const transcript = priorTranscript.map((t) => `${t.role === "agent" ? "You" : "Employee"}: ${t.content}`).join("\n");
-  return `\u26A0\uFE0F CONTINUATION \u2014 this is NOT a fresh interview. You already interviewed this employee; below is that prior conversation, and an Epic Request already exists from it. Your job now is to ENRICH that same request, not restart it.
-
-Prior conversation:
-${transcript}
-
-How to continue:
-- Read the prior conversation first. Do NOT re-ask anything already answered there.
-- Use the section list below only as a checklist of what a complete request needs. Identify which sections are MISSING or THIN, and ask focused questions to fill ONLY those gaps \u2014 still one short question at a time.
-- If the prior conversation already covers everything well, go straight to the completion JSON.
-- When you emit the final completion JSON, MERGE the prior answers with whatever new detail you gathered \u2014 restate and expand every field using the WHOLE conversation (old + new). Never drop or shorten content that was already captured; the goal is a richer request than before, meeting the same length minimums.
-
-`;
-}
-function interviewFieldKeysFor(definition) {
+function interviewFieldKeys() {
   const seen = /* @__PURE__ */ new Set();
   const out = [];
-  for (const section of definition) {
+  for (const section of INTERVIEW_DEFINITION) {
     for (const f of section.fields) {
       if (!seen.has(f)) {
         seen.add(f);
@@ -5634,6 +5568,12 @@ function interviewFieldKeysFor(definition) {
   }
   return out;
 }
+var INTERVIEW_FIELD_MIN_WORDS = {
+  problemStatement: 60,
+  proposedSolution: 100,
+  impactAssessment: 40,
+  description: 150
+};
 
 // ../shared/dist/interview-completion.js
 var TARGET_COMPLIANCE_TIER = "pass";
@@ -5759,6 +5699,218 @@ function looksLikeCompletionAttempt(text) {
 }
 var COMPLETION_REPAIR_INSTRUCTION = 'Your last message looked like a completion but I could NOT parse it as a valid JSON object with all required fields. Re-emit ONLY a single valid JSON object inside a ```json code fence \u2014 no other text \u2014 with every string value properly escaped (escape any internal double-quotes as \\" and any line breaks as \\n), and make sure title, problemStatement, proposedSolution, impactAssessment, and description are all present and non-empty:\n```json\n{"done": true, "title": "...", "problemStatement": "...", "proposedSolution": "...", "impactAssessment": "...", "description": "..."}\n```';
 
+// ../shared/dist/interview-conversation.js
+var CONVERSATION_QUALITY_ROUNDS = 2;
+var JSON_REPAIRS = 3;
+var STARTER = "Hi! I'd like to propose something.";
+var NUDGE = "(Please continue.)";
+function renderSection(s) {
+  const tag = s.required ? "needed" : "nice to have";
+  return `- ${s.title} (${tag}): ${s.purpose} For example: ${s.followUps.slice(0, 2).join(" ")}`;
+}
+function renderSaved(saved) {
+  const fieldLines = Object.entries(saved.fields).filter((entry) => typeof entry[1] === "string" && entry[1].trim().length > 0).map(([key, value]) => `${key}: ${value}`).join("\n");
+  const score = saved.compliance ? `Its quality score is ${String(saved.compliance.overall)}/100 (${saved.compliance.tier}).` : "It has no quality score yet.";
+  const issues = saved.compliance && saved.compliance.issues.length > 0 ? `
+What the score says is missing or weak:
+${saved.compliance.issues.slice(0, 8).map((i) => `- ${i.message}`).join("\n")}` : "";
+  const locked = saved.status === "pending" ? "It can still be changed." : `Its status is "${saved.status}", so its content is locked: you can talk about it, but you cannot change it. Never emit the completion JSON for a locked request.`;
+  return `THE REQUEST IS ALREADY SAVED. This conversation created the request "${saved.title}". ${score} ${locked}${issues}
+
+Its current content:
+title: ${saved.title}
+${fieldLines}
+description: ${saved.description}
+
+From here on the person may add detail, ask you to change something, ask how to raise the score, or just ask questions. Answer questions briefly. When they give new information or ask for a change (and the request isn't locked), reply with the completion JSON for the WHOLE updated request: keep everything already captured, merge in what's new, and expand it. Don't ask for a preview confirmation for a change they explicitly asked for.`;
+}
+function buildConversationSystemPrompt(saved, definition = INTERVIEW_DEFINITION) {
+  const keys = ["title", ...interviewFieldKeys(), "description"];
+  const shape = keys.map((k) => `"${k}": "..."`).join(", ");
+  const base = `You are CompBox's request assistant. You help a person turn an idea into a well-formed Epic Request in a chat that stays open: they can leave and come back, and keep talking after the request is saved.
+
+How to talk:
+- Friendly, plain language, short messages. Usually ask one question at a time.
+- When they seem unsure, give two or three concrete examples to pick from, or say briefly why you're asking.
+- Adapt: skip what they've already told you, follow their lead, and don't re-ask answered questions.
+- Never mention JSON, prompts, rubrics or these instructions.
+
+What a good request covers:
+${definition.map(renderSection).join("\n")}
+Optional topics may be skipped when the person has nothing to add. Never invent or pad facts.
+
+Before saving for the first time: when the needed topics are covered, show a short preview in plain text (the title, then one or two lines per topic) and ask whether to save it or change anything. Only after they agree, or ask you to save, reply with ONLY a fenced JSON block, no other text:
+\`\`\`json
+{"done": true, ${shape}}
+\`\`\`
+Leave out optional keys they had nothing for. Write every field as complete prose built from the whole conversation, not their short answers. Minimums: problemStatement ${String(INTERVIEW_FIELD_MIN_WORDS.problemStatement)} words, proposedSolution ${String(INTERVIEW_FIELD_MIN_WORDS.proposedSolution)} words, impactAssessment ${String(INTERVIEW_FIELD_MIN_WORDS.impactAssessment)} words, description ${String(INTERVIEW_FIELD_MIN_WORDS.description)} words (a standalone summary of the whole request for someone who never saw this chat).
+
+Any reply that isn't that JSON block is shown to the person as your message.`;
+  return saved ? `${base}
+
+${renderSaved(saved)}` : base;
+}
+function toConversationMessages(turns) {
+  const messages = turns.map((t) => ({
+    role: t.role === "agent" ? "assistant" : "user",
+    content: t.content
+  }));
+  if (messages[0]?.role !== "user")
+    messages.unshift({ role: "user", content: STARTER });
+  if (messages[messages.length - 1]?.role !== "user")
+    messages.push({ role: "user", content: NUDGE });
+  return messages;
+}
+function renderConversationPrompt(messages) {
+  const lines = messages.map((m) => `${m.role === "assistant" ? "You" : "Them"}: ${m.content}`);
+  return `The conversation so far:
+
+${lines.join("\n\n")}
+
+Write your next reply to them.`;
+}
+function savedMessage(saved, created, followUp) {
+  const verb = created ? "Saved your request" : "Updated your request";
+  const c = saved.compliance;
+  let text;
+  if (!c) {
+    text = `${verb} "${saved.title}". You can keep talking here to add detail or change anything.`;
+  } else if (meetsComplianceTarget(c)) {
+    text = `${verb} "${saved.title}". It scores ${String(c.overall)}/100, ready for review. You can keep talking here to change anything.`;
+  } else {
+    const gaps = [...c.issues.filter((i) => i.tier === "critical"), ...c.issues.filter((i) => i.tier === "advisory")].slice(0, 4).map((i) => `- ${i.message}`).join("\n");
+    text = `${verb} "${saved.title}". It scores ${String(c.overall)}/100; 90 is the target.${gaps ? ` To raise it:
+${gaps}` : ""}
+
+Tell me more here and I'll update it, or leave it as it is.`;
+  }
+  return followUp ? `${text}
+
+${followUp}` : text;
+}
+async function runConversationStep(input, deps) {
+  const system = buildConversationSystemPrompt(input.saved);
+  const messages = toConversationMessages(input.turns);
+  const locked = input.saved !== null && input.saved.status !== "pending";
+  let requestId = input.saved?.id ?? null;
+  let savedNow = null;
+  let createdHere = false;
+  let qualityRounds = 0;
+  let repairs = 0;
+  for (; ; ) {
+    let reply;
+    try {
+      reply = await deps.reply(system, messages);
+    } catch (error) {
+      if (savedNow)
+        return { kind: "saved", text: savedMessage(savedNow.saved, savedNow.created), ...savedNow };
+      const reason = error instanceof Error ? error.message : "Something went wrong reaching the AI.";
+      return {
+        kind: "error",
+        text: `I couldn't reply just now: ${reason}
+
+Send another message (for example "try again") when you're ready and I'll pick up where we left off.`
+      };
+    }
+    const draft = extractCompletionJson(reply);
+    if (draft) {
+      if (locked) {
+        messages.push({ role: "assistant", content: reply }, { role: "user", content: "That request is locked and can't be changed. Reply to me in plain text instead." });
+        if (++repairs > JSON_REPAIRS)
+          return { kind: "error", text: "This request is locked, so it can't be changed any more." };
+        continue;
+      }
+      let saved;
+      try {
+        saved = await deps.save(requestId, draft);
+      } catch (error) {
+        const reason = error instanceof Error ? error.message : "the save failed";
+        return { kind: "error", text: `I couldn't save the request: ${reason}
+
+Reply "try again" and I'll retry.` };
+      }
+      createdHere ||= requestId === null;
+      savedNow = { saved, created: createdHere };
+      requestId = saved.id;
+      if (meetsComplianceTarget(saved.compliance) || qualityRounds >= CONVERSATION_QUALITY_ROUNDS || !saved.compliance) {
+        return { kind: "saved", text: savedMessage(saved, savedNow.created), ...savedNow };
+      }
+      qualityRounds++;
+      messages.push({ role: "assistant", content: reply }, {
+        role: "user",
+        content: `${buildAuditFeedback(saved.compliance)}
+
+The request IS already saved, and the person will be shown its score. If you ask them something, ask it as a way to improve the saved request; never say it hasn't been saved.`
+      });
+      continue;
+    }
+    if (looksLikeCompletionAttempt(reply)) {
+      if (++repairs > JSON_REPAIRS) {
+        return savedNow ? { kind: "saved", text: savedMessage(savedNow.saved, savedNow.created), ...savedNow } : { kind: "error", text: `I had trouble writing up the request. Reply "try again" and I'll have another go.` };
+      }
+      messages.push({ role: "assistant", content: reply }, { role: "user", content: COMPLETION_REPAIR_INSTRUCTION });
+      continue;
+    }
+    const text = reply.trim();
+    if (savedNow) {
+      return { kind: "saved", text: savedMessage(savedNow.saved, savedNow.created, text || void 0), ...savedNow };
+    }
+    if (!text)
+      return { kind: "error", text: "I didn't get a reply that time. Send another message and I'll try again." };
+    return { kind: "message", text };
+  }
+}
+function savedContextFromRecord(record) {
+  if (typeof record !== "object" || record === null)
+    return null;
+  const r = record;
+  if (typeof r.id !== "string" || typeof r.title !== "string")
+    return null;
+  let structured = r.structuredDesc;
+  if (typeof structured === "string") {
+    try {
+      structured = JSON.parse(structured);
+    } catch {
+      structured = null;
+    }
+  }
+  const fields = {};
+  if (typeof structured === "object" && structured !== null) {
+    for (const [key, value] of Object.entries(structured)) {
+      if (typeof value === "string")
+        fields[key] = value;
+    }
+  }
+  let score = r.complianceScore;
+  if (typeof score === "string") {
+    try {
+      score = JSON.parse(score);
+    } catch {
+      score = null;
+    }
+  }
+  return {
+    id: r.id,
+    title: r.title,
+    status: typeof r.status === "string" ? r.status : "pending",
+    description: typeof r.description === "string" ? r.description : "",
+    fields,
+    compliance: complianceFromRecord(score)
+  };
+}
+function complianceFromRecord(score) {
+  if (typeof score !== "object" || score === null)
+    return null;
+  const s = score;
+  if (typeof s.overall !== "number" || typeof s.tier !== "string")
+    return null;
+  const issues = Array.isArray(s.issues) ? s.issues.filter((i) => typeof i === "object" && i !== null).map((i) => ({
+    message: typeof i.message === "string" ? i.message : typeof i.code === "string" ? i.code : "issue",
+    tier: i.tier === "critical" ? "critical" : "advisory"
+  })) : [];
+  return { overall: s.overall, tier: s.tier, issues };
+}
+
 // src/utils/config-store.ts
 var CONFIG_DIR_ENV = "COMPBOX_CONFIG_DIR";
 var PROJECT_DIR_ENV = "COMPBOX_PROJECT_DIR";
@@ -6360,12 +6512,18 @@ var MailboxClient = class {
    * here. Cloud Run bills vCPU for the wall-clock life of a request, so a held
    * connection kept one instance permanently awake at ~$64/month.
    */
-  async nextJob(machineToken, waitMs = 0) {
+  /**
+   * `runningIds`: jobs this daemon is already running, so the server hands out
+   * new work instead of resuming one of them.
+   */
+  async nextJob(machineToken, waitMs = 0, runningIds = []) {
     let res;
     try {
       res = await this.http.get("/api/v1/machines/next-job", {
         headers: { Authorization: `Bearer ${machineToken}` },
-        params: { waitMs }
+        // steps=1: this daemon runs request conversations one reply at a time,
+        // so it never wants back a job that is waiting on the person.
+        params: { waitMs, steps: "1", ...runningIds.length > 0 && { running: runningIds.join(",") } }
       });
     } catch (error) {
       throw toMailboxError(error, "next-job request failed");
@@ -6478,6 +6636,23 @@ var MailboxClient = class {
     const data = res.data;
     return data.data;
   }
+  /**
+   * Tells CompBox that a request conversation saved its epic request. The
+   * conversation stays open; this only links the job to the request.
+   */
+  async markRequestSaved(machineToken, jobId, epicRequestId) {
+    let res;
+    try {
+      res = await this.http.post(`/api/v1/jobs/${jobId}/saved`, { epicRequestId }, {
+        headers: { Authorization: `Bearer ${machineToken}` }
+      });
+    } catch (error) {
+      throw toMailboxError(error, "saved request failed");
+    }
+    if (res.status < 200 || res.status >= 300) {
+      throw errorFromResponse(res, "saved failed");
+    }
+  }
   /** Reports what a run on the person's API key spent. */
   async reportAiUsage(machineToken, jobId, usage) {
     let res;
@@ -7784,11 +7959,7 @@ function parseClaudeJsonResult(stdout2, fallbackModel) {
 
 // src/utils/agent-invoker.ts
 var ANTHROPIC_MODEL = "claude-fable-5";
-var MAX_INTERVIEW_TURNS = 18;
-var MAX_QUALITY_ROUNDS = 4;
-var REPLY_POLL_INTERVAL_MS = 3e3;
-var REPLY_TIMEOUT_MS = 10 * 60 * 1e3;
-var CLAUDE_CLI_TURN_TIMEOUT_MS = 2 * 60 * 1e3;
+var CLAUDE_CLI_TURN_TIMEOUT_MS = 4 * 60 * 1e3;
 function anthropicClientOptions(apiKey, routing) {
   return routing.mode === "proxy" ? { apiKey, baseURL: routing.anthropicBaseUrl } : { apiKey };
 }
@@ -7801,11 +7972,7 @@ var SUPPORTED_IMAGE_MEDIA_TYPES = [
   "image/gif",
   "image/webp"
 ];
-var MAX_IMAGES_PER_TURN = 8;
 var MAX_IMAGE_BYTES_PER_TURN = 20 * 1024 * 1024;
-var defaultWarn = (message) => {
-  console.warn(`  \u26A0 ${message}`);
-};
 function normalizeImageMediaType(mime) {
   const base = (mime.split(";")[0] ?? "").trim().toLowerCase();
   return SUPPORTED_IMAGE_MEDIA_TYPES.includes(base) ? base : null;
@@ -7813,67 +7980,10 @@ function normalizeImageMediaType(mime) {
 function isSupportedImageMediaType(mime) {
   return normalizeImageMediaType(mime) !== null;
 }
-function selectImageAttachments(attachments) {
-  if (!attachments || attachments.length === 0) return [];
-  const selected = [];
-  let declaredBytes = 0;
-  for (const att of attachments) {
-    if (selected.length >= MAX_IMAGES_PER_TURN) break;
-    if (!isSupportedImageMediaType(att.mimeType)) continue;
-    const size = typeof att.sizeBytes === "number" && att.sizeBytes > 0 ? att.sizeBytes : 0;
-    if (declaredBytes + size > MAX_IMAGE_BYTES_PER_TURN) continue;
-    declaredBytes += size;
-    selected.push(att);
-  }
-  return selected;
-}
 function imageAttachmentCount(attachments) {
   if (!attachments || attachments.length === 0) return 0;
   return attachments.filter((a) => isSupportedImageMediaType(a.mimeType)).length;
 }
-async function fetchImageBlocks(attachments, warn = defaultWarn, fetchImpl = fetch) {
-  const blocks = [];
-  let totalBytes = 0;
-  for (const att of attachments) {
-    const mediaType = normalizeImageMediaType(att.mimeType);
-    if (!mediaType) continue;
-    try {
-      const res = await fetchImpl(att.signedUrl);
-      if (!res.ok) {
-        warn(`Skipping image attachment ${att.id}: fetch failed (HTTP ${String(res.status)}).`);
-        continue;
-      }
-      const bytes = Buffer.from(await res.arrayBuffer());
-      if (bytes.byteLength === 0) {
-        warn(`Skipping image attachment ${att.id}: empty response body.`);
-        continue;
-      }
-      if (totalBytes + bytes.byteLength > MAX_IMAGE_BYTES_PER_TURN) {
-        warn(`Skipping image attachment ${att.id}: exceeds the per-turn image byte budget.`);
-        continue;
-      }
-      totalBytes += bytes.byteLength;
-      blocks.push({
-        type: "image",
-        source: { type: "base64", media_type: mediaType, data: bytes.toString("base64") }
-      });
-    } catch (error) {
-      const message = error instanceof Error ? error.message : "unknown error";
-      warn(`Skipping image attachment ${att.id}: ${message}.`);
-    }
-  }
-  return blocks;
-}
-function buildApiUserContent(text, imageBlocks) {
-  if (imageBlocks.length === 0) return text;
-  return [...imageBlocks, { type: "text", text }];
-}
-async function apiUserTurnContent(turn, warn = defaultWarn, fetchImpl = fetch) {
-  const selected = selectImageAttachments(turn.attachments);
-  if (selected.length === 0) return turn.content;
-  const blocks = await fetchImageBlocks(selected, warn, fetchImpl);
-  return buildApiUserContent(turn.content, blocks);
-}
 function appendAttachmentNote(text, imageCount) {
   if (imageCount <= 0) return text;
   const noun = imageCount === 1 ? "image" : "images";
@@ -7882,7 +7992,6 @@ function appendAttachmentNote(text, imageCount) {
 
 ${note}` : note;
 }
-var SYSTEM_PROMPT = buildInterviewSystemPrompt();
 function parseSeedPayload(payload) {
   if (typeof payload !== "object" || payload === null) return null;
   const p = payload;
@@ -7898,11 +8007,6 @@ function parseSeedPayload(payload) {
     priorTranscript
   };
 }
-function resolveSystemPrompt(seed) {
-  return seed ? buildInterviewSystemPrompt(INTERVIEW_DEFINITION, {
-    priorTranscript: seed.priorTranscript
-  }) : SYSTEM_PROMPT;
-}
 async function submitAndScore(ctx, currentErId, draft) {
   if (currentErId) {
     const compliance = await updatePersonalEpicRequest(
@@ -7916,118 +8020,6 @@ async function submitAndScore(ctx, currentErId, draft) {
   const created = await createPersonalEpicRequest(ctx.apiBaseUrl, ctx.userApiToken, draft);
   return { erId: created.id, compliance: created.compliance };
 }
-var MAX_JSON_REPAIRS = 3;
-function sleep(ms) {
-  return new Promise((resolve3) => setTimeout(resolve3, ms));
-}
-async function waitForUserReply(client, machineToken, jobId, turnsSoFar) {
-  const deadline = Date.now() + REPLY_TIMEOUT_MS;
-  while (Date.now() < deadline) {
-    await sleep(REPLY_POLL_INTERVAL_MS);
-    const job = await client.nextJob(machineToken, 0);
-    if (job?.id !== jobId) continue;
-    const last = job.turns[job.turns.length - 1];
-    if (job.turns.length > turnsSoFar && last?.role === "user") {
-      return job;
-    }
-  }
-  return null;
-}
-async function invokeEpicRequestViaApi(job, ctx) {
-  const routing = await resolveRouting();
-  const anthropic = new Anthropic(anthropicClientOptions(ctx.anthropicApiKey, routing));
-  const seed = parseSeedPayload(job.payload);
-  const systemPrompt = resolveSystemPrompt(seed);
-  let currentErId = seed?.targetEpicRequestId ?? null;
-  let qualityRounds = 0;
-  let jsonRepairs = 0;
-  const messages = [];
-  for (const turn of job.turns) {
-    if (turn.role === "agent") {
-      messages.push({ role: "assistant", content: turn.content });
-    } else {
-      messages.push({ role: "user", content: await apiUserTurnContent(turn) });
-    }
-  }
-  let turnsSoFar = job.turns.length;
-  for (let i = 0; i < MAX_INTERVIEW_TURNS; i++) {
-    let reply;
-    try {
-      const response = await anthropic.messages.create({
-        model: ANTHROPIC_MODEL,
-        max_tokens: 1024,
-        system: systemPrompt,
-        messages: messages.length > 0 ? messages : [{ role: "user", content: "Let's get started." }]
-      });
-      const textBlock = response.content.find((b) => b.type === "text");
-      reply = textBlock?.type === "text" ? textBlock.text : "";
-    } catch (error) {
-      const message = error instanceof Error ? error.message : "Anthropic API request failed";
-      return { status: "failed", result: { error: `Agent invocation failed: ${message}` } };
-    }
-    const draft = extractCompletionJson(reply);
-    if (draft) {
-      let submitted;
-      try {
-        submitted = await submitAndScore(ctx, currentErId, draft);
-      } catch (error) {
-        const message = error instanceof Error ? error.message : "Failed to save the epic request";
-        return { status: "failed", result: { error: message } };
-      }
-      currentErId = submitted.erId;
-      const compliance = submitted.compliance;
-      if (meetsComplianceTarget(compliance) || qualityRounds >= MAX_QUALITY_ROUNDS) {
-        return { status: "done", result: { epicRequestId: currentErId } };
-      }
-      qualityRounds++;
-      if (compliance !== null) {
-        messages.push({ role: "assistant", content: reply });
-        messages.push({ role: "user", content: buildAuditFeedback(compliance) });
-      }
-      continue;
-    }
-    if (looksLikeCompletionAttempt(reply)) {
-      if (jsonRepairs >= MAX_JSON_REPAIRS) {
-        return {
-          status: "failed",
-          result: {
-            error: "The interview produced malformed completion data and could not be finalized after several attempts."
-          }
-        };
-      }
-      jsonRepairs++;
-      messages.push({ role: "assistant", content: reply });
-      messages.push({ role: "user", content: COMPLETION_REPAIR_INSTRUCTION });
-      continue;
-    }
-    messages.push({ role: "assistant", content: reply });
-    let updated;
-    try {
-      updated = await ctx.mailboxClient.postTurn(ctx.machineToken, job.id, reply);
-    } catch (error) {
-      const message = error instanceof Error ? error.message : "post-turn failed";
-      return { status: "failed", result: { error: message } };
-    }
-    turnsSoFar = updated.turns.length;
-    const answered = await waitForUserReply(ctx.mailboxClient, ctx.machineToken, job.id, turnsSoFar);
-    if (!answered) {
-      return {
-        status: "failed",
-        result: { error: "Timed out waiting for a reply \u2014 no response within 10 minutes." }
-      };
-    }
-    const lastTurn = answered.turns[answered.turns.length - 1];
-    messages.push({
-      role: "user",
-      content: lastTurn ? await apiUserTurnContent(lastTurn) : ""
-    });
-    turnsSoFar = answered.turns.length;
-  }
-  return currentErId ? { status: "done", result: { epicRequestId: currentErId } } : {
-    status: "failed",
-    result: { error: `Interview did not converge after ${String(MAX_INTERVIEW_TURNS)} turns.` }
-  };
-}
 function claudeCliSessionCwd() {
   const dir = join9(homedir5(), ".compbox", "claude-sessions");
   try {
@@ -8038,11 +8030,11 @@ function claudeCliSessionCwd() {
 }
 function runClaudeCliTurn(prompt, opts) {
   return new Promise((resolve3, reject) => {
+    const model = opts.model === void 0 ? ANTHROPIC_MODEL : opts.model;
     const args = [
       "-p",
       prompt,
-      "--model",
-      ANTHROPIC_MODEL,
+      ...model ? ["--model", model] : [],
       "--output-format",
       "json",
       "--tools",
@@ -8116,91 +8108,78 @@ function runClaudeCliTurn(prompt, opts) {
     });
   });
 }
-async function invokeEpicRequestViaSubscription(job, ctx) {
-  let sessionId;
-  let turnsSoFar = job.turns.length;
+async function loadSavedRequest(apiBaseUrl, userApiToken, epicRequestId) {
+  const res = await fetch(
+    `${apiBaseUrl.replace(/\/+$/, "")}/api/v1/epic-requests/${encodeURIComponent(epicRequestId)}`,
+    { headers: { Authorization: `Bearer ${userApiToken}` } }
+  );
+  if (!res.ok) return null;
+  const body = await res.json().catch(() => null);
+  return savedContextFromRecord(body?.data);
+}
+function needsDefaultModel(error) {
+  const message = error instanceof Error ? error.message : String(error);
+  return /requires usage credits|switch to another model|model.*not available|not have access to/i.test(message);
+}
+function savedRequestIdOf(job) {
+  const result = job.result;
+  if (typeof result?.epicRequestId === "string") return result.epicRequestId;
+  return parseSeedPayload(job.payload)?.targetEpicRequestId ?? null;
+}
+async function invokeEpicRequestStep(job, ctx) {
+  try {
+    return await takeConversationStep(job, ctx);
+  } catch (error) {
+    const reason = error instanceof Error ? error.message : "something went wrong";
+    await ctx.mailboxClient.postTurn(
+      ctx.machineToken,
+      job.id,
+      `I couldn't continue: ${reason}
+
+Send another message (for example "try again") and I'll pick up where we left off.`
+    );
+    return { status: "yield" };
+  }
+}
+async function takeConversationStep(job, ctx) {
   const routing = await resolveRouting();
-  const seed = parseSeedPayload(job.payload);
-  const systemPrompt = resolveSystemPrompt(seed);
-  let currentErId = seed?.targetEpicRequestId ?? null;
-  let qualityRounds = 0;
-  let jsonRepairs = 0;
-  let nextPrompt = job.turns.length > 0 ? job.turns.map(
-    (t) => t.role === "agent" ? `You asked: ${t.content}` : (
-      // ENG-153 (A4): subscription mode has no inline-image channel, so a
-      // user turn's images degrade to an explicit textual note.
-      `They replied: ${appendAttachmentNote(t.content, imageAttachmentCount(t.attachments))}`
-    )
-  ).join("\n") + "\n\nContinue the interview from exactly where this left off \u2014 ask the next question, or if you already have everything, respond with the completion JSON." : "Let's begin the interview.";
-  for (let i = 0; i < MAX_INTERVIEW_TURNS; i++) {
-    let turn;
-    try {
-      turn = await runClaudeCliTurn(nextPrompt, {
-        systemPrompt,
-        resumeSessionId: sessionId,
-        routing
-      });
-    } catch (error) {
-      const message = error instanceof Error ? error.message : "claude CLI invocation failed";
-      return { status: "failed", result: { error: `Agent invocation failed: ${message}` } };
-    }
-    sessionId = turn.sessionId;
-    const draft = extractCompletionJson(turn.text);
-    if (draft) {
-      let submitted;
-      try {
-        submitted = await submitAndScore(ctx, currentErId, draft);
-      } catch (error) {
-        const message = error instanceof Error ? error.message : "Failed to save the epic request";
-        return { status: "failed", result: { error: message } };
-      }
-      currentErId = submitted.erId;
-      const compliance = submitted.compliance;
-      if (meetsComplianceTarget(compliance) || qualityRounds >= MAX_QUALITY_ROUNDS) {
-        return { status: "done", result: { epicRequestId: currentErId } };
-      }
-      qualityRounds++;
-      if (compliance !== null) {
-        nextPrompt = buildAuditFeedback(compliance);
-      }
-      continue;
-    }
-    if (looksLikeCompletionAttempt(turn.text)) {
-      if (jsonRepairs >= MAX_JSON_REPAIRS) {
-        return {
-          status: "failed",
-          result: {
-            error: "The interview produced malformed completion data and could not be finalized after several attempts."
-          }
-        };
+  const requestId = savedRequestIdOf(job);
+  const saved = requestId ? await loadSavedRequest(ctx.apiBaseUrl, ctx.userApiToken, requestId) : null;
+  const turns = job.turns.map((t) => ({
+    role: t.role,
+    content: t.role === "user" ? appendAttachmentNote(t.content, imageAttachmentCount(t.attachments)) : t.content
+  }));
+  const anthropic = ctx.anthropicApiKey ? new Anthropic(anthropicClientOptions(ctx.anthropicApiKey, routing)) : null;
+  let cliModel = ANTHROPIC_MODEL;
+  const outcome = await runConversationStep(
+    { turns, saved },
+    {
+      reply: async (system, messages) => {
+        if (anthropic) {
+          const response = await anthropic.messages.create({ model: ANTHROPIC_MODEL, max_tokens: 4096, system, messages });
+          const text = response.content.find((b) => b.type === "text");
+          return text?.type === "text" ? text.text : "";
+        }
+        const prompt = renderConversationPrompt(messages);
+        try {
+          return (await runClaudeCliTurn(prompt, { systemPrompt: system, resumeSessionId: void 0, routing, model: cliModel })).text;
+        } catch (error) {
+          if (cliModel === null || !needsDefaultModel(error)) throw error;
+          cliModel = null;
+          return (await runClaudeCliTurn(prompt, { systemPrompt: system, resumeSessionId: void 0, routing, model: null })).text;
+        }
+      },
+      save: async (existingId, draft) => {
+        const submitted = await submitAndScore(ctx, existingId, draft);
+        return { id: submitted.erId, title: draft.title, compliance: submitted.compliance };
       }
-      jsonRepairs++;
-      nextPrompt = COMPLETION_REPAIR_INSTRUCTION;
-      continue;
-    }
-    let updated;
-    try {
-      updated = await ctx.mailboxClient.postTurn(ctx.machineToken, job.id, turn.text);
-    } catch (error) {
-      const message = error instanceof Error ? error.message : "post-turn failed";
-      return { status: "failed", result: { error: message } };
-    }
-    turnsSoFar = updated.turns.length;
-    const answered = await waitForUserReply(ctx.mailboxClient, ctx.machineToken, job.id, turnsSoFar);
-    if (!answered) {
-      return {
-        status: "failed",
-        result: { error: "Timed out waiting for a reply \u2014 no response within 10 minutes." }
-      };
     }
-    const lastTurn = answered.turns[answered.turns.length - 1];
-    nextPrompt = lastTurn ? appendAttachmentNote(lastTurn.content, imageAttachmentCount(lastTurn.attachments)) : "";
-    turnsSoFar = answered.turns.length;
+  );
+  if (outcome.kind === "saved") {
+    await ctx.mailboxClient.markRequestSaved(ctx.machineToken, job.id, outcome.saved.id);
   }
-  return currentErId ? { status: "done", result: { epicRequestId: currentErId } } : {
-    status: "failed",
-    result: { error: `Interview did not converge after ${String(MAX_INTERVIEW_TURNS)} turns.` }
-  };
+  await ctx.mailboxClient.postTurn(ctx.machineToken, job.id, outcome.text);
+  return { status: "yield" };
 }
 var PLANNER_RUN_TIMEOUT_MS = 30 * 60 * 1e3;
 var PLANNER_HEARTBEAT_INTERVAL_MS = 20 * 1e3;
@@ -8834,6 +8813,17 @@ function githubCompareUrl(remoteUrl, baseBranch, branch) {
   if (!m) return null;
   return `https://github.com/${m[1] ?? ""}/${m[2] ?? ""}/compare/${encodeURIComponent(baseBranch)}...${encodeURIComponent(branch)}?expand=1`;
 }
+var repoQueues = /* @__PURE__ */ new Map();
+function withRepoLock(projectDir, task) {
+  const previous = repoQueues.get(projectDir) ?? Promise.resolve();
+  const result = previous.catch(() => void 0).then(task);
+  const tail = result.catch(() => void 0);
+  repoQueues.set(projectDir, tail);
+  void tail.then(() => {
+    if (repoQueues.get(projectDir) === tail) repoQueues.delete(projectDir);
+  });
+  return result;
+}
 var RunWorkspaceManager = class {
   run;
   now;
@@ -8857,6 +8847,31 @@ var RunWorkspaceManager = class {
   }
   /** Creates the branch + worktree for a run. Never touches the person's checkout. */
   async prepare(projectDir, epicId) {
+    const created = await withRepoLock(projectDir, () => this.createWorktree(projectDir, epicId));
+    if (!created.ok) return created;
+    const { workspace, notes } = created;
+    const { dir, branch } = workspace;
+    const install = installCommand2(dir, this.exists);
+    if (install) {
+      const [command, args] = install;
+      const res = await this.run(command, args, dir);
+      if (res.status !== 0) {
+        await withRepoLock(projectDir, async () => {
+          await this.git(["worktree", "remove", "--force", dir], projectDir);
+          await this.git(["branch", "-D", branch], projectDir);
+        });
+        return {
+          ok: false,
+          error: [
+            `Installing the project's dependencies failed (${command} ${args.join(" ")}): ${firstLine(res.stderr) || firstLine(res.stdout) || "unknown error"}`,
+            "The run was not started. Check that the same command works in your project folder."
+          ].join("\n")
+        };
+      }
+    }
+    return { ok: true, workspace, notes };
+  }
+  async createWorktree(projectDir, epicId) {
     const notes = [];
     const remotes = (await this.git(["remote"], projectDir)).stdout.split("\n").map((r) => r.trim()).filter(Boolean);
     const remote = remotes.includes("origin") ? "origin" : remotes[0] ?? null;
@@ -8911,26 +8926,13 @@ ${untracked.stdout}`.split("\n").map((p) => p.trim()).filter((p) => p && !p.ends
         notes.push(`Couldn't copy ${path3} into the run workspace.`);
       }
     }
-    const install = installCommand2(dir, this.exists);
-    if (install) {
-      const [command, args] = install;
-      const res = await this.run(command, args, dir);
-      if (res.status !== 0) {
-        await this.git(["worktree", "remove", "--force", dir], projectDir);
-        await this.git(["branch", "-D", branch], projectDir);
-        return {
-          ok: false,
-          error: [
-            `Installing the project's dependencies failed (${command} ${args.join(" ")}): ${firstLine(res.stderr) || firstLine(res.stdout) || "unknown error"}`,
-            "The run was not started. Check that the same command works in your project folder."
-          ].join("\n")
-        };
-      }
-    }
     return { ok: true, workspace: { dir, projectDir, branch, baseRef, baseBranch, remote }, notes };
   }
   /** Commits, pushes and opens the pull request; then cleans up the worktree. */
-  async finish(input) {
+  finish(input) {
+    return withRepoLock(input.workspace.projectDir, () => this.finishLocked(input));
+  }
+  async finishLocked(input) {
     const { workspace: ws } = input;
     const notes = [];
     if ((await this.git(["status", "--porcelain"], ws.dir)).stdout.trim()) {
@@ -9142,9 +9144,20 @@ var POLL_WAIT_MS = 0;
 var IDLE_POLL_INTERVAL_MS = 15e3;
 var ACTIVE_POLL_INTERVAL_MS = 2e3;
 var ACTIVE_WINDOW_MS = 6e4;
-function idleDelay(now, lastJobAt) {
+var CONVERSATION_POLL_INTERVAL_MS = 3e3;
+var CONVERSATION_WINDOW_MS = 10 * 6e4;
+function idleDelay(now, lastJobAt, lastConversationAt = 0) {
   const warm = lastJobAt > 0 && now - lastJobAt < ACTIVE_WINDOW_MS;
-  return warm ? ACTIVE_POLL_INTERVAL_MS : IDLE_POLL_INTERVAL_MS;
+  if (warm) return ACTIVE_POLL_INTERVAL_MS;
+  const talking = lastConversationAt > 0 && now - lastConversationAt < CONVERSATION_WINDOW_MS;
+  return talking ? CONVERSATION_POLL_INTERVAL_MS : IDLE_POLL_INTERVAL_MS;
+}
+var DEFAULT_MAX_PARALLEL_JOBS = 3;
+var MAX_JOBS_ENV = "COMPBOX_MAX_JOBS";
+function maxParallelJobs(env = process.env) {
+  const raw = Number.parseInt(env[MAX_JOBS_ENV] ?? "", 10);
+  if (!Number.isFinite(raw) || raw < 1) return DEFAULT_MAX_PARALLEL_JOBS;
+  return Math.min(raw, 10);
 }
 var BACKOFF_BASE_MS = 1e3;
 var BACKOFF_MAX_MS = 3e4;
@@ -9152,7 +9165,7 @@ var HEARTBEAT_INTERVAL_MS = 2e4;
 function runtimeHeartbeatDue(nowMs, lastRuntimeSentMs, intervalMs = HEARTBEAT_INTERVAL_MS) {
   return nowMs - lastRuntimeSentMs >= intervalMs;
 }
-function sleep2(ms) {
+function sleep(ms) {
   return new Promise((resolve3) => setTimeout(resolve3, ms));
 }
 function backoffDelay(consecutiveErrors) {
@@ -9307,6 +9320,10 @@ async function handleStartExecution(ctx, job) {
 async function runInvokerAndComplete(ctx, job, invoke) {
   try {
     const outcome = await invoke();
+    if (outcome.status === "yield") {
+      console.log(chalk9.gray(`  Job ${job.id}: replied; waiting for the person.`));
+      return;
+    }
     await ctx.client.completeJob(ctx.machineToken, job.id, outcome.status, outcome.result);
     console.log(
       outcome.status === "done" ? chalk9.green(`  Job ${job.id} completed: ${JSON.stringify(outcome.result)}`) : chalk9.yellow(`  Job ${job.id} failed: ${JSON.stringify(outcome.result)}`)
@@ -9331,37 +9348,22 @@ async function handleJob(ctx, job) {
 \u2192 Claimed job ${job.id} (type: ${job.type}, status: ${job.status})`)
   );
   const userApiToken = ctx.userApiToken;
-  const isEpicRequest = job.type === "epic_request" && !!userApiToken;
-  if (isEpicRequest && userApiToken) {
+  if (job.type === "epic_request" && userApiToken) {
+    let anthropicApiKey;
     if (ctx.aiMode === "api-key") {
-      const { value: anthropicApiKey } = await retrieveSecret(AI_KEY_ACCOUNT);
-      if (anthropicApiKey) {
-        console.log(chalk9.gray("  Running the request-formulator interview (api mode)..."));
-        await runInvokerAndComplete(
-          ctx,
-          job,
-          () => invokeEpicRequestViaApi(job, {
-            mailboxClient: ctx.client,
-            machineToken: ctx.machineToken,
-            apiBaseUrl: ctx.apiBaseUrl,
-            userApiToken,
-            anthropicApiKey
-          })
-        );
-        return;
-      }
-    } else if (ctx.aiMode === "claude-subscription") {
-      console.log(
-        chalk9.gray("  Running the request-formulator interview (claude-subscription mode, local `claude` CLI)...")
-      );
+      anthropicApiKey = (await retrieveSecret(AI_KEY_ACCOUNT)).value ?? void 0;
+    }
+    if (ctx.aiMode === "claude-subscription" || anthropicApiKey) {
+      console.log(chalk9.gray(`  Replying in the request conversation (${anthropicApiKey ? "api mode" : "local claude CLI"})...`));
       await runInvokerAndComplete(
         ctx,
         job,
-        () => invokeEpicRequestViaSubscription(job, {
+        () => invokeEpicRequestStep(job, {
           mailboxClient: ctx.client,
           machineToken: ctx.machineToken,
           apiBaseUrl: ctx.apiBaseUrl,
-          userApiToken
+          userApiToken,
+          ...anthropicApiKey && { anthropicApiKey }
         })
       );
       return;
@@ -9459,6 +9461,9 @@ var runCommand = new Command8("run").description("Start the Agent Runner daemon
 `
     )
   );
+  const maxJobs = maxParallelJobs();
+  console.log(chalk9.gray(`  Runs up to ${String(maxJobs)} job${maxJobs === 1 ? "" : "s"} at once (${MAX_JOBS_ENV} to change).
+`));
   const runtimeProbe = () => probeAgentRuntime();
   let agentRuntime = await safeProbeAgentRuntime(runtimeProbe, void 0);
   if (agentRuntime) {
@@ -9489,10 +9494,14 @@ Received ${signal}, shutting down...`));
   });
   let consecutiveErrors = 0;
   let lastJobAt = 0;
+  let lastConversationAt = 0;
+  const inFlight = /* @__PURE__ */ new Map();
   do {
     let job = null;
     try {
-      job = await client.nextJob(machineToken, waitMs);
+      if (inFlight.size < maxJobs) {
+        job = await client.nextJob(machineToken, waitMs, [...inFlight.keys()]);
+      }
       consecutiveErrors = 0;
     } catch (error) {
       consecutiveErrors += 1;
@@ -9506,12 +9515,21 @@ Received ${signal}, shutting down...`));
       );
       console.error(chalk9.gray(`  Reconnecting in ${String(Math.round(delay / 1e3))}s...`));
       if (options.once) break;
-      await sleep2(delay);
+      await sleep(delay);
       continue;
     }
+    if (job && inFlight.has(job.id)) job = null;
     if (job) {
-      await handleJob(jobContext, job);
-      lastJobAt = Date.now();
+      const jobId = job.id;
+      const isConversation = job.type === "epic_request";
+      const work = handleJob(jobContext, job).catch((error) => {
+        console.error(chalk9.red(`  Job ${jobId} stopped unexpectedly: ${error instanceof Error ? error.message : String(error)}`));
+      }).finally(() => {
+        inFlight.delete(jobId);
+        lastJobAt = Date.now();
+        if (isConversation) lastConversationAt = lastJobAt;
+      });
+      inFlight.set(jobId, work);
     }
     if (runtimeHeartbeatDue(Date.now(), lastRuntimeSentAt)) {
       const cycle = await runHeartbeatCycle({
@@ -9528,9 +9546,12 @@ Received ${signal}, shutting down...`));
         lastRuntimeSentAt = Date.now();
       }
     }
-    if (options.once) break;
+    if (options.once) {
+      await Promise.all(inFlight.values());
+      break;
+    }
     if (!job) {
-      await sleep2(idleDelay(Date.now(), lastJobAt));
+      await sleep(idleDelay(Date.now(), lastJobAt, lastConversationAt));
     }
   } while (running);
   console.log(chalk9.gray("Agent Runner stopped."));
@@ -9793,7 +9814,7 @@ machinesCommand.command("rm <id>").description("Remove (revoke) a paired machine
 // src/index.ts
 function resolveCliVersion() {
   if (true) {
-    return "1.19.0";
+    return "1.20.0";
   }
   const require2 = createRequire(import.meta.url);
   const pkg = require2("../package.json");