@rallycry/conveyor-agent 10.13.3 → 10.13.9

package/dist/{chunk-P4VWWR5O.js → chunk-PXQJ4NVO.js}

@@ -196,6 +196,8 @@ var AgentConnection = class _AgentConnection {
   earlySpawnReviews = [];
   spawnTuiCallback = null;
   earlySpawnTuis = [];
+  probeUsageCallback = null;
+  earlyProbeUsage = false;
   // PTY relay (S5 terminal). Single-slot callbacks, set per PtySession run.
   ptyInputCallback = null;
   ptyResizeCallback = null;
@@ -407,6 +409,10 @@ var AgentConnection = class _AgentConnection {
         if (this.spawnTuiCallback) this.spawnTuiCallback(data);
         else this.earlySpawnTuis.push(data);
       });
+      this.socket.on("session:probeUsage", () => {
+        if (this.probeUsageCallback) this.probeUsageCallback();
+        else this.earlyProbeUsage = true;
+      });
       this.socket.on("session:finalizeSnapshot", () => {
         this.finalizeSnapshotCallback?.();
       });
@@ -667,6 +673,15 @@ var AgentConnection = class _AgentConnection {
     for (const data of this.earlySpawnTuis) callback(data);
     this.earlySpawnTuis = [];
   }
+  /** Register the on-demand usage-refresh handler; drains an early-buffered
+   *  `session:probeUsage` that arrived before the runner was ready. */
+  onProbeUsage(callback) {
+    this.probeUsageCallback = callback;
+    if (this.earlyProbeUsage) {
+      this.earlyProbeUsage = false;
+      callback();
+    }
+  }
   /**
    * Report that a same-pod TUI/shell child failed to spawn (fire-and-forget).
    * The server Ends the orphaned session — no fallback pod (unlike review).
@@ -766,12 +781,13 @@ var AgentConnection = class _AgentConnection {
       });
     }
   }
-  postChatMessage(content) {
+  postChatMessage(content, milestone) {
     if (!this.socket) return;
     if (this.suppressIfDuplicate(content)) return;
     void this.call("postAgentMessage", {
       sessionId: this.config.sessionId,
-      content
+      content,
+      milestone
     }).catch(() => {
     });
   }
@@ -779,13 +795,14 @@ var AgentConnection = class _AgentConnection {
   // the message is acknowledged by the server before proceeding (e.g. before
   // aborting the session). Dedup still applies; a suppressed message resolves
   // immediately without hitting the wire.
-  async postChatMessageAwait(content) {
+  async postChatMessageAwait(content, milestone) {
     if (!this.socket) return;
     if (this.suppressIfDuplicate(content)) return;
     try {
       await this.call("postAgentMessage", {
         sessionId: this.config.sessionId,
-        content
+        content,
+        milestone
       });
     } catch (err) {
       process.stderr.write(
@@ -990,6 +1007,12 @@ ${q.question}${q.options.length ? "\n" + q.options.map((o) => `- ${o.label}: ${o
   triggerIdentification() {
     return this.call("triggerIdentification", { sessionId: this.config.sessionId });
   }
+  handoffToImplementer(payload) {
+    return this.call("handoffToImplementer", {
+      sessionId: this.config.sessionId,
+      ...payload
+    });
+  }
   async refreshAuthToken() {
     const result = await this.refreshFromBootstrap();
     return result.refreshedClaude;
@@ -2108,7 +2131,8 @@ var CreatePRInputSchema = z3.object({
 });
 var PostToChatInputSchema = z3.object({
   message: z3.string().min(1),
-  type: z3.enum(["message", "question", "update"]).optional().default("message")
+  type: z3.enum(["message", "question", "update"]).optional().default("message"),
+  milestone: z3.enum(["plan_ready", "implementation_complete", "blocked"]).optional()
 });
 var GetTaskContextRequestSchema = z3.object({
   sessionId: z3.string(),
@@ -2294,7 +2318,10 @@ var UpdateTaskPropertiesRequestSchema = z3.object({
   tagIds: z3.array(z3.string()).optional(),
   tagNames: z3.array(z3.string()).optional(),
   githubPRUrl: z3.string().url().optional(),
-  githubBranch: z3.string().optional()
+  githubBranch: z3.string().optional(),
+  // Canonical risk level, or null to clear — same semantics as the headless
+  // update_task boundary (resolved to the project's Risk row in the handler).
+  risk: riskLevelSchema.nullable().optional()
 });
 var ListIconsRequestSchema = z3.object({
   sessionId: z3.string()
@@ -2343,6 +2370,15 @@ var VoteSuggestionRequestSchema = z3.object({
 var TriggerIdentificationRequestSchema = z3.object({
   sessionId: z3.string()
 });
+var HandoffToImplementerRequestSchema = z3.object({
+  sessionId: z3.string(),
+  // Optional difficulty sizing — sets the task's story points before resolving
+  // the matched implementer agent. Omit to hand off using the task's current
+  // story points (or the project's default task agent when unsized).
+  storyPoints: z3.number().int().positive().optional(),
+  // Optional kickoff note posted to the task chat alongside the handoff notice.
+  message: z3.string().optional()
+});
 var SubmitCodeReviewResultRequestSchema = z3.object({
   sessionId: z3.string(),
   approved: z3.boolean(),
@@ -2556,6 +2592,10 @@ var ListAccessibleProjectsRequestSchema = z4.object({
 var ListProjectTasksRequestSchema = z4.object({
   projectId: z4.string(),
   status: z4.string().optional(),
+  // Card types to include. Omitted/empty → defaults to ["task"] in the handler
+  // (mirrors searchProjectTasks) so listing doesn't surface incidents/suggestions
+  // unless asked. Enum validation lives at the MCP tool layer.
+  typeFilters: z4.array(z4.string()).optional(),
   assigneeId: z4.string().optional(),
   unassigned: z4.boolean().optional(),
   // Scope to a sub-project board when provided. Unlike the board layer's `?? null`
@@ -2596,6 +2636,9 @@ var GetProjectSummaryRequestSchema = z4.object({
 var GetProjectOnboardingStatusRequestSchema = z4.object({
   projectId: z4.string()
 });
+var GetProjectConnectUrlsRequestSchema = z4.object({
+  projectId: z4.string()
+});
 var CreateProjectTaskRequestSchema = z4.object({
   projectId: z4.string(),
   title: z4.string().min(1),
@@ -2610,7 +2653,13 @@ var UpdateProjectTaskRequestSchema = z4.object({
   projectId: z4.string(),
   taskId: z4.string(),
   title: z4.string().optional(),
+  description: z4.string().optional(),
   plan: z4.string().optional(),
+  // Enum validation lives at the MCP tool layer (mirrors createProjectTask);
+  // the handler routes through the shared updateStatus core (InProgress
+  // dependency check + cleanup/board/Slack side effects), not the stricter
+  // card-type-validating path the Socket.IO updateTaskStatus mutation uses.
+  status: z4.string().optional(),
   // Canonical risk level, or null to clear. Resolved to the project's
   // configured Risk row (by rank) in the handler.
   risk: riskLevelSchema.nullable().optional(),
@@ -2620,9 +2669,9 @@ var UpdateProjectTaskRequestSchema = z4.object({
   subProjectId: z4.string().nullable().optional(),
   requestingUserId: z4.string().optional()
 }).strict().refine(
-  (v) => v.title !== void 0 || v.plan !== void 0 || v.risk !== void 0 || v.assignedUserId !== void 0 || v.subProjectId !== void 0,
+  (v) => v.title !== void 0 || v.description !== void 0 || v.plan !== void 0 || v.status !== void 0 || v.risk !== void 0 || v.assignedUserId !== void 0 || v.subProjectId !== void 0,
   {
-    message: "update_task requires at least one field to change (title, plan, risk, assignedUserId, or subProjectId)"
+    message: "update_task requires at least one field to change (title, description, plan, status, risk, assignedUserId, or subProjectId)"
   }
 );
 var TransitionProjectTaskStatusRequestSchema = z4.object({
@@ -2728,6 +2777,14 @@ var ResumeAdhocSessionRequestSchema = z4.object({
   workspaceId: z4.string(),
   requestingUserId: z4.string().optional()
 });
+var RefreshCodingAgentKeyUsageRequestSchema = z4.object({
+  projectId: z4.string(),
+  keyId: z4.string().optional(),
+  requestingUserId: z4.string().optional()
+});
+var ListKeysToProbeRequestSchema = z4.object({
+  sessionId: z4.string()
+});
 var CreateProjectReleaseRequestSchema = z4.object({
   projectId: z4.string(),
   taskIds: z4.array(z4.string()).optional(),
@@ -2766,6 +2823,9 @@ var UpdateProjectSubtaskRequestSchema = z4.object({
   ordinal: z4.number().int().nonnegative().optional(),
   storyPointValue: z4.number().int().positive().optional(),
   followParentStatus: z4.boolean().optional(),
+  /** Replace-set of sibling subtask ids/slugs this subtask blocks on ([] clears).
+   * Mirrors the in-pod updateSubtask semantics. */
+  dependsOn: z4.array(z4.string().min(1)).max(32).optional(),
   requestingUserId: z4.string().optional()
 });
 var DeleteProjectSubtaskRequestSchema = z4.object({
@@ -3341,6 +3401,7 @@ var ClaudeCodeHarness = class {
 };
 
 // src/harness/pty/session.ts
+import { randomUUID as randomUUID2 } from "crypto";
 import { mkdtemp as mkdtemp2, mkdir as mkdir3, rm as rm5 } from "fs/promises";
 import { tmpdir as tmpdir3 } from "os";
 import { join as join4, dirname } from "path";
@@ -3739,11 +3800,131 @@ function matchUsageLimitBanner(text, now = Date.now()) {
   };
 }
 
+// src/harness/pty/pty-support.ts
+import { stat as stat2 } from "fs/promises";
+var MAX_DIAGNOSTIC_OUTPUT = 4e3;
+var MAX_BETWEEN_TURN_BUFFER = 500;
+var SUBMIT_SETTLE_MS = 300;
+var SUBMIT_NUDGE_INTERVAL_MS = 2e3;
+var SUBMIT_NUDGE_MAX_PRESSES = 5;
+var SUBMIT_NUDGE_SLOW_INTERVAL_MS = 5e3;
+var SUBMIT_NUDGE_WINDOW_MS = 9e4;
+var PLAN_DIALOG_FIRST_PRESS_MS = 700;
+var PLAN_DIALOG_INTERVAL_MS = 1500;
+var PLAN_DIALOG_SLOW_INTERVAL_MS = 5e3;
+var PLAN_DIALOG_FAST_WINDOW_MS = 1e4;
+var PLAN_DIALOG_WINDOW_MS = 9e4;
+function envMs(name, fallback) {
+  const raw = Number(process.env[name]);
+  return Number.isFinite(raw) && raw > 0 ? raw : fallback;
+}
+function resolveSubmitSettleMs() {
+  return envMs("CONVEYOR_PTY_SUBMIT_SETTLE_MS", SUBMIT_SETTLE_MS);
+}
+function resolveSubmitNudgeTiming() {
+  return {
+    intervalMs: envMs("CONVEYOR_PTY_NUDGE_INTERVAL_MS", SUBMIT_NUDGE_INTERVAL_MS),
+    slowIntervalMs: envMs("CONVEYOR_PTY_NUDGE_SLOW_INTERVAL_MS", SUBMIT_NUDGE_SLOW_INTERVAL_MS),
+    maxPresses: SUBMIT_NUDGE_MAX_PRESSES,
+    windowMs: envMs("CONVEYOR_PTY_NUDGE_WINDOW_MS", SUBMIT_NUDGE_WINDOW_MS)
+  };
+}
+function resolvePlanDialogTiming() {
+  return {
+    firstPressMs: envMs("CONVEYOR_PTY_PLAN_DIALOG_FIRST_PRESS_MS", PLAN_DIALOG_FIRST_PRESS_MS),
+    intervalMs: envMs("CONVEYOR_PTY_PLAN_DIALOG_INTERVAL_MS", PLAN_DIALOG_INTERVAL_MS),
+    slowIntervalMs: envMs(
+      "CONVEYOR_PTY_PLAN_DIALOG_SLOW_INTERVAL_MS",
+      PLAN_DIALOG_SLOW_INTERVAL_MS
+    ),
+    fastWindowMs: envMs("CONVEYOR_PTY_PLAN_DIALOG_FAST_WINDOW_MS", PLAN_DIALOG_FAST_WINDOW_MS),
+    windowMs: envMs("CONVEYOR_PTY_PLAN_DIALOG_WINDOW_MS", PLAN_DIALOG_WINDOW_MS)
+  };
+}
+function turnOptionsFrom(options) {
+  return {
+    canUseTool: options.canUseTool,
+    promptDelivery: options.promptDelivery,
+    planDialogAutoAccept: options.planDialogAutoAccept,
+    abortController: options.abortController
+  };
+}
+function isRecord2(value) {
+  return typeof value === "object" && value !== null;
+}
+function extractSpawn(mod) {
+  if (!isRecord2(mod)) return null;
+  if (typeof mod.spawn === "function") return mod.spawn;
+  const def = mod.default;
+  if (isRecord2(def) && typeof def.spawn === "function") return def.spawn;
+  return null;
+}
+async function loadPtySpawn() {
+  const mod = await import("node-pty");
+  const spawn2 = extractSpawn(mod);
+  if (!spawn2) throw new Error("node-pty: spawn export not found");
+  return spawn2;
+}
+function inheritedEnv(socketPath) {
+  const env = {};
+  for (const [key, value] of Object.entries(process.env)) {
+    if (typeof value === "string") env[key] = value;
+  }
+  if (env.CLAUDE_CODE_OAUTH_TOKEN) {
+    delete env.ANTHROPIC_API_KEY;
+  }
+  if (socketPath) {
+    env.CONVEYOR_HOOK_SOCKET = socketPath;
+  }
+  env.MCP_TIMEOUT ??= "60000";
+  env.MCP_TOOL_TIMEOUT ??= "180000";
+  return env;
+}
+function buildPromptBytes(text) {
+  return `\x1B[200~${text}\x1B[201~`;
+}
+function renderPromptContentText(content) {
+  return content.map((block) => {
+    const b = block;
+    if (b?.type === "text" && typeof b.text === "string") return b.text;
+    if (b?.type === "image") {
+      return `[Image attachment \u2014 use list_task_files / get_attachment to view]`;
+    }
+    return JSON.stringify(block);
+  }).join("\n\n");
+}
+async function transcriptSize(path4) {
+  try {
+    return (await stat2(path4)).size;
+  } catch {
+    return 0;
+  }
+}
+function parseUserQuestions(input) {
+  if (!Array.isArray(input.questions)) return [];
+  const questions = [];
+  for (const entry of input.questions) {
+    if (!isRecord2(entry)) continue;
+    if (typeof entry.question !== "string") continue;
+    const options = Array.isArray(entry.options) ? entry.options.filter(isRecord2).filter((o) => typeof o.label === "string").map((o) => ({
+      label: o.label,
+      description: typeof o.description === "string" ? o.description : ""
+    })) : [];
+    questions.push({
+      question: entry.question,
+      header: typeof entry.header === "string" ? entry.header : "",
+      options,
+      ...typeof entry.multiSelect === "boolean" ? { multiSelect: entry.multiSelect } : {}
+    });
+  }
+  return questions;
+}
+
 // src/harness/pty/chat-record-mapper.ts
 var TEXT_MAX = 16e3;
 var TOOL_INPUT_MAX = 1900;
 var TOOL_OUTPUT_MAX = 1900;
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null;
 }
 function isUnknownArray2(value) {
@@ -3759,6 +3940,27 @@ function stringField2(record, ...keys) {
 function truncate(text, max) {
   return text.length > max ? `${text.slice(0, max)}\u2026` : text;
 }
+function compactQuestionsJson(questions) {
+  const serialize = (qs) => JSON.stringify({ questions: qs });
+  const withDescriptions = (max) => questions.map((q) => ({
+    ...q,
+    options: q.options.map((o) => ({ ...o, description: truncate(o.description, max) }))
+  }));
+  const full = serialize(questions);
+  if (full.length <= TOOL_INPUT_MAX) return full;
+  const shortened = serialize(withDescriptions(80));
+  if (shortened.length <= TOOL_INPUT_MAX) return shortened;
+  const bare = serialize(withDescriptions(0));
+  if (bare.length <= TOOL_INPUT_MAX) return bare;
+  return bare.slice(0, TOOL_INPUT_MAX);
+}
+function compactToolInput(name, input) {
+  if (name === "AskUserQuestion" && isRecord3(input)) {
+    const questions = parseUserQuestions(input);
+    if (questions.length > 0) return compactQuestionsJson(questions);
+  }
+  return JSON.stringify(input ?? {}).slice(0, TOOL_INPUT_MAX);
+}
 function isNonConversationText(text) {
   const trimmed = text.trimStart();
   return trimmed.startsWith("<command-name>") || trimmed.startsWith("<local-command-") || trimmed.startsWith("<task-notification>");
@@ -3778,11 +3980,11 @@ function mapSystem2(record) {
 }
 function mapAssistant2(record) {
   const message = record.message;
-  if (!isRecord2(message)) return [];
+  if (!isRecord3(message)) return [];
   const content = isUnknownArray2(message.content) ? message.content : [];
   const events = [];
   for (const raw of content) {
-    if (!isRecord2(raw)) continue;
+    if (!isRecord3(raw)) continue;
     if (raw.type === "text") {
       const text = stringField2(raw, "text");
       if (text && text.length > 0) {
@@ -3795,7 +3997,7 @@ function mapAssistant2(record) {
         const event = {
           kind: "tool_use",
           name: truncate(name, 200),
-          input: JSON.stringify(input ?? {}).slice(0, TOOL_INPUT_MAX)
+          input: compactToolInput(name, input)
         };
         const id = stringField2(raw, "id");
         if (id !== void 0) event.id = id;
@@ -3809,14 +4011,14 @@ function toolResultText(block) {
   const content = block.content;
   if (typeof content === "string") return content;
   if (isUnknownArray2(content)) {
-    return content.filter((b) => isRecord2(b) && b.type === "text").map((b) => typeof b.text === "string" ? b.text : "").filter((t) => t.length > 0).join("\n");
+    return content.filter((b) => isRecord3(b) && b.type === "text").map((b) => typeof b.text === "string" ? b.text : "").filter((t) => t.length > 0).join("\n");
   }
   return "";
 }
 function mapToolResults(content) {
   const events = [];
   for (const raw of content) {
-    if (!isRecord2(raw) || raw.type !== "tool_result") continue;
+    if (!isRecord3(raw) || raw.type !== "tool_result") continue;
     const event = {
       kind: "tool_result",
       output: truncate(toolResultText(raw), TOOL_OUTPUT_MAX),
@@ -3830,15 +4032,15 @@ function mapToolResults(content) {
 }
 function mapUser(record) {
   const message = record.message;
-  if (!isRecord2(message)) return [];
+  if (!isRecord3(message)) return [];
   const content = message.content;
   let text;
   if (typeof content === "string") {
     text = content;
   } else if (isUnknownArray2(content)) {
-    const hasToolResult = content.some((b) => isRecord2(b) && b.type === "tool_result");
+    const hasToolResult = content.some((b) => isRecord3(b) && b.type === "tool_result");
     if (hasToolResult) return mapToolResults(content);
-    text = content.filter((b) => isRecord2(b) && b.type === "text").map((b) => typeof b.text === "string" ? b.text : "").filter((t) => t.length > 0).join("\n");
+    text = content.filter((b) => isRecord3(b) && b.type === "text").map((b) => typeof b.text === "string" ? b.text : "").filter((t) => t.length > 0).join("\n");
   } else {
     return [];
   }
@@ -3847,7 +4049,7 @@ function mapUser(record) {
   return [{ kind: "user_text", text: truncate(trimmed, TEXT_MAX) }];
 }
 function mapChatRecords(raw) {
-  if (!isRecord2(raw)) return [];
+  if (!isRecord3(raw)) return [];
   if (raw.isSidechain === true || raw.isMeta === true) return [];
   switch (raw.type) {
     case "system":
@@ -4751,126 +4953,6 @@ async function removeConveyorCredentials(env = process.env) {
   }
 }
 
-// src/harness/pty/pty-support.ts
-import { stat as stat2 } from "fs/promises";
-var MAX_DIAGNOSTIC_OUTPUT = 4e3;
-var MAX_BETWEEN_TURN_BUFFER = 500;
-var SUBMIT_SETTLE_MS = 300;
-var SUBMIT_NUDGE_INTERVAL_MS = 2e3;
-var SUBMIT_NUDGE_MAX_PRESSES = 5;
-var SUBMIT_NUDGE_SLOW_INTERVAL_MS = 5e3;
-var SUBMIT_NUDGE_WINDOW_MS = 9e4;
-var PLAN_DIALOG_FIRST_PRESS_MS = 700;
-var PLAN_DIALOG_INTERVAL_MS = 1500;
-var PLAN_DIALOG_SLOW_INTERVAL_MS = 5e3;
-var PLAN_DIALOG_FAST_WINDOW_MS = 1e4;
-var PLAN_DIALOG_WINDOW_MS = 9e4;
-function envMs(name, fallback) {
-  const raw = Number(process.env[name]);
-  return Number.isFinite(raw) && raw > 0 ? raw : fallback;
-}
-function resolveSubmitSettleMs() {
-  return envMs("CONVEYOR_PTY_SUBMIT_SETTLE_MS", SUBMIT_SETTLE_MS);
-}
-function resolveSubmitNudgeTiming() {
-  return {
-    intervalMs: envMs("CONVEYOR_PTY_NUDGE_INTERVAL_MS", SUBMIT_NUDGE_INTERVAL_MS),
-    slowIntervalMs: envMs("CONVEYOR_PTY_NUDGE_SLOW_INTERVAL_MS", SUBMIT_NUDGE_SLOW_INTERVAL_MS),
-    maxPresses: SUBMIT_NUDGE_MAX_PRESSES,
-    windowMs: envMs("CONVEYOR_PTY_NUDGE_WINDOW_MS", SUBMIT_NUDGE_WINDOW_MS)
-  };
-}
-function resolvePlanDialogTiming() {
-  return {
-    firstPressMs: envMs("CONVEYOR_PTY_PLAN_DIALOG_FIRST_PRESS_MS", PLAN_DIALOG_FIRST_PRESS_MS),
-    intervalMs: envMs("CONVEYOR_PTY_PLAN_DIALOG_INTERVAL_MS", PLAN_DIALOG_INTERVAL_MS),
-    slowIntervalMs: envMs(
-      "CONVEYOR_PTY_PLAN_DIALOG_SLOW_INTERVAL_MS",
-      PLAN_DIALOG_SLOW_INTERVAL_MS
-    ),
-    fastWindowMs: envMs("CONVEYOR_PTY_PLAN_DIALOG_FAST_WINDOW_MS", PLAN_DIALOG_FAST_WINDOW_MS),
-    windowMs: envMs("CONVEYOR_PTY_PLAN_DIALOG_WINDOW_MS", PLAN_DIALOG_WINDOW_MS)
-  };
-}
-function turnOptionsFrom(options) {
-  return {
-    canUseTool: options.canUseTool,
-    promptDelivery: options.promptDelivery,
-    planDialogAutoAccept: options.planDialogAutoAccept,
-    abortController: options.abortController
-  };
-}
-function isRecord3(value) {
-  return typeof value === "object" && value !== null;
-}
-function extractSpawn(mod) {
-  if (!isRecord3(mod)) return null;
-  if (typeof mod.spawn === "function") return mod.spawn;
-  const def = mod.default;
-  if (isRecord3(def) && typeof def.spawn === "function") return def.spawn;
-  return null;
-}
-async function loadPtySpawn() {
-  const mod = await import("node-pty");
-  const spawn2 = extractSpawn(mod);
-  if (!spawn2) throw new Error("node-pty: spawn export not found");
-  return spawn2;
-}
-function inheritedEnv(socketPath) {
-  const env = {};
-  for (const [key, value] of Object.entries(process.env)) {
-    if (typeof value === "string") env[key] = value;
-  }
-  if (env.CLAUDE_CODE_OAUTH_TOKEN) {
-    delete env.ANTHROPIC_API_KEY;
-  }
-  if (socketPath) {
-    env.CONVEYOR_HOOK_SOCKET = socketPath;
-  }
-  env.MCP_TIMEOUT ??= "60000";
-  env.MCP_TOOL_TIMEOUT ??= "180000";
-  return env;
-}
-function buildPromptBytes(text) {
-  return `\x1B[200~${text}\x1B[201~`;
-}
-function renderPromptContentText(content) {
-  return content.map((block) => {
-    const b = block;
-    if (b?.type === "text" && typeof b.text === "string") return b.text;
-    if (b?.type === "image") {
-      return `[Image attachment \u2014 use list_task_files / get_attachment to view]`;
-    }
-    return JSON.stringify(block);
-  }).join("\n\n");
-}
-async function transcriptSize(path4) {
-  try {
-    return (await stat2(path4)).size;
-  } catch {
-    return 0;
-  }
-}
-function parseUserQuestions(input) {
-  if (!Array.isArray(input.questions)) return [];
-  const questions = [];
-  for (const entry of input.questions) {
-    if (!isRecord3(entry)) continue;
-    if (typeof entry.question !== "string") continue;
-    const options = Array.isArray(entry.options) ? entry.options.filter(isRecord3).filter((o) => typeof o.label === "string").map((o) => ({
-      label: o.label,
-      description: typeof o.description === "string" ? o.description : ""
-    })) : [];
-    questions.push({
-      question: entry.question,
-      header: typeof entry.header === "string" ? entry.header : "",
-      options,
-      ...typeof entry.multiSelect === "boolean" ? { multiSelect: entry.multiSelect } : {}
-    });
-  }
-  return questions;
-}
-
 // src/harness/pty/adapters/claude.ts
 var ClaudeTuiAdapter = class {
   id = "claude-code";
@@ -4981,6 +5063,18 @@ var PtySession = class {
   // Submit-nudge state (see armSubmitNudge).
   pendingSubmitNudge = false;
   submitNudgeTimer = null;
+  // Synthetic AskUserQuestion chat-card state. The CLI does NOT flush the
+  // assistant record holding a pending AskUserQuestion tool_use to the
+  // transcript until the questionnaire resolves (verified live on CLI 2.1.209:
+  // dialog parked on screen, transcript untouched) — so a transcript-derived
+  // question card could only ever render AFTER the human answered in the raw
+  // terminal. Instead the PreToolUse hook (which fires at ask time and carries
+  // the full questions input) emits a synthetic `tool_use` chat event under an
+  // `aq-…` id. When the real records eventually flush, the duplicate tool_use
+  // is dropped (FIFO match below) and its tool_result is re-pointed at the
+  // synthetic id so the card flips to answered.
+  pendingSyntheticQuestionIds = [];
+  questionResultRemap = /* @__PURE__ */ new Map();
   // Per-turn state: the prompt to feed and the per-turn options subset. Both
   // start from the constructor args (turn 1) and are replaced by beginTurn.
   turnPrompt;
@@ -5102,6 +5196,7 @@ var PtySession = class {
     this.passiveSignaled = false;
     this.disarmSubmitNudge();
     this.disarmPlanDialogAutoAccept();
+    this.closeSyntheticQuestionCards();
   }
   /**
    * (Re)register the abort→teardown listener on the current turn's controller,
@@ -5133,6 +5228,7 @@ var PtySession = class {
    */
   endTurn(clean) {
     this.lastTurnCleanResult = clean;
+    this.closeSyntheticQuestionCards();
     this.activeQueue?.close();
     this.activeQueue = null;
     if (this.abortHandler && this.turn.abortController) {
@@ -5207,17 +5303,72 @@ var PtySession = class {
     const transcriptPath = sessionTranscriptPath(this.options.cwd, sessionId);
     await mkdir3(dirname(transcriptPath), { recursive: true });
     const startOffset = this.resume ? await transcriptSize(transcriptPath) : 0;
-    const sendChat = this.bridge?.sendChatEvent?.bind(this.bridge);
     this.tailer = new JsonlTailer(
       transcriptPath,
       (event) => this.handleTranscriptEvent(event),
-      sendChat ? (raw) => {
-        for (const chatEvent of mapChatRecords(raw)) sendChat(chatEvent);
-      } : void 0
+      typeof this.bridge?.sendChatEvent === "function" ? (raw) => this.relayChatRecord(raw) : void 0
     );
     this.tailer.start(startOffset);
     return { settingsPath, socketPath };
   }
+  /**
+   * Project a tailed transcript record to chat events, reconciling them with
+   * any synthetic question card already emitted at hook time: the flushed
+   * AskUserQuestion `tool_use` duplicate is dropped (its real id remembered),
+   * and the paired `tool_result` is re-pointed at the synthetic id so the
+   * live-rendered card is the one that flips to answered.
+   */
+  relayChatRecord(raw) {
+    for (const event of mapChatRecords(raw)) {
+      if (event.kind === "tool_use" && event.name === "AskUserQuestion") {
+        const syntheticId = this.pendingSyntheticQuestionIds.shift();
+        if (syntheticId) {
+          if (event.id) this.questionResultRemap.set(event.id, syntheticId);
+          continue;
+        }
+      } else if (event.kind === "tool_result" && event.toolUseId) {
+        const syntheticId = this.questionResultRemap.get(event.toolUseId);
+        if (syntheticId) {
+          this.questionResultRemap.delete(event.toolUseId);
+          this.sendChatEvent({ ...event, toolUseId: syntheticId });
+          continue;
+        }
+      }
+      this.sendChatEvent(event);
+    }
+  }
+  sendChatEvent(event) {
+    this.bridge?.sendChatEvent?.(event);
+  }
+  /** Render the question card in the web chat NOW — at hook time — instead of
+   * whenever the CLI flushes the transcript records (which is only after the
+   * questionnaire resolves; see the field comment). */
+  emitSyntheticQuestionCard(questions) {
+    if (questions.length === 0 || typeof this.bridge?.sendChatEvent !== "function") return;
+    const id = `aq-${randomUUID2()}`;
+    this.pendingSyntheticQuestionIds.push(id);
+    this.sendChatEvent({
+      kind: "tool_use",
+      name: "AskUserQuestion",
+      input: compactQuestionsJson(questions),
+      id
+    });
+  }
+  /**
+   * Close any still-open synthetic question cards. The questionnaire can only
+   * outlive its card via a path that never flushes the paired records — Esc /
+   * interrupt, a superseding turn, or process teardown — so an answering
+   * tool_result will never arrive for these ids; emit one so the web card
+   * stops soliciting input for a dialog that no longer exists.
+   */
+  closeSyntheticQuestionCards() {
+    const orphaned = [...this.pendingSyntheticQuestionIds, ...this.questionResultRemap.values()];
+    this.pendingSyntheticQuestionIds = [];
+    this.questionResultRemap.clear();
+    for (const toolUseId of orphaned) {
+      this.sendChatEvent({ kind: "tool_result", toolUseId, output: "", isError: false });
+    }
+  }
   writeStdin(text) {
     this.pty?.write(text);
   }
@@ -5251,6 +5402,7 @@ var PtySession = class {
     this._toreDown = true;
     this.disarmPlanDialogAutoAccept();
     this.disarmSubmitNudge();
+    this.closeSyntheticQuestionCards();
     this.unsubInput?.();
     this.unsubInput = null;
     this.unsubResize?.();
@@ -5421,10 +5573,9 @@ var PtySession = class {
     if (request.tool_name === "AskUserQuestion") {
       this.disarmSubmitNudge();
       this.disarmPlanDialogAutoAccept();
-      this.pushEvent({
-        type: "user_question",
-        questions: parseUserQuestions(request.tool_input)
-      });
+      const questions = parseUserQuestions(request.tool_input);
+      this.pushEvent({ type: "user_question", questions });
+      this.emitSyntheticQuestionCard(questions);
       return { decision: "allow" };
     }
     const canUseTool = this.turn.canUseTool;
@@ -7493,9 +7644,12 @@ function buildPostToChatTool(connection) {
     "Post a message to the task chat for the team to see. Your turn output is NOT shown in chat, so this is the only way the team sees your status, summaries, and questions. Omit task_id to post to the current task's chat; pass a child's ID to message its chat.",
     {
       message: z9.string().describe("The message to post to the team"),
-      task_id: z9.string().optional().describe("Child task ID to post to. Omit to post to the current task's chat.")
+      task_id: z9.string().optional().describe("Child task ID to post to. Omit to post to the current task's chat."),
+      milestone: z9.enum(["plan_ready", "implementation_complete", "blocked"]).optional().describe(
+        "Declare a narrative milestone instead of a routine update. Use SPARINGLY \u2014 only when the plan is ready, implementation is complete, or you are blocked. Milestones appear on the card's activity timeline and in Slack."
+      )
     },
-    async ({ message, task_id }) => {
+    async ({ message, task_id, milestone }) => {
       try {
         if (task_id) {
           await connection.call("postChildChatMessage", {
@@ -7516,7 +7670,7 @@ function buildPostToChatTool(connection) {
             })
           );
         }
-        await connection.call("postToChat", { message });
+        await connection.call("postToChat", { message, milestone });
         return textResult(JSON.stringify({ posted: true }));
       } catch (error) {
         return textResult(
@@ -7531,7 +7685,16 @@ function buildForceUpdateTaskStatusTool(connection) {
     "force_update_task_status",
     "EMERGENCY ONLY: force-override a task's Kanban status. Use when an automatic transition failed and the task is wedged. Normal flow transitions status automatically.",
     {
-      status: z9.enum(["InProgress", "ReviewPR", "ReviewDev", "Complete"]).describe("The new status for the task"),
+      status: z9.enum([
+        "Planning",
+        "Open",
+        "InProgress",
+        "ReviewPR",
+        "ReviewDev",
+        "ReviewLive",
+        "Complete",
+        "Cancelled"
+      ]).describe("The new status for the task"),
       task_id: z9.string().optional().describe("Child task ID to update. Omit to update the current task.")
     },
     async ({ status, task_id }) => {
@@ -8096,6 +8259,36 @@ function buildUpdateTaskTool(connection) {
     }
   );
 }
+function buildHandoffTool(connection) {
+  return defineTool(
+    "handoff_to_agent",
+    "Hand this task off to an implementer agent for the build phase \u2014 mid-conversation, same session, no restart. Call this once the plan is compiled and saved (update_task_plan). The server swaps this task to the difficulty-sized implementer agent (which may run at a different model level), announces the handoff in the activity log + chat, and switches you into build mode to start implementing. Size the work with the storyPoints arg (or set it first via update_task_properties). Returns the implementer's name + model.",
+    {
+      storyPoints: z12.number().int().positive().optional().describe(
+        "Difficulty sizing (1=Common, 2=Magic, 3=Rare, 5=Unique, 8=Pack) \u2014 picks which implementer agent takes over. Omit to use the task's current story points."
+      ),
+      message: z12.string().optional().describe("Optional kickoff note posted to the chat alongside the handoff notice.")
+    },
+    async ({ storyPoints, message }) => {
+      try {
+        const result = await connection.handoffToImplementer({
+          ...storyPoints !== void 0 && { storyPoints },
+          ...message !== void 0 && { message }
+        });
+        if (!result.handedOff) {
+          return textResult(`Handoff did not complete: ${result.reason ?? "unknown reason"}`);
+        }
+        return textResult(
+          `Handed off to ${result.agentName} (${result.model}). Now in build mode \u2014 start implementing the plan.`
+        );
+      } catch (error) {
+        return textResult(
+          `Failed to hand off: ${error instanceof Error ? error.message : "Unknown error"}`
+        );
+      }
+    }
+  );
+}
 function buildCreateSubtaskTool(connection) {
   return defineTool(
     "create_subtask",
@@ -8318,42 +8511,52 @@ function buildPmTools(connection, options) {
 // src/tools/discovery-tools.ts
 import { z as z13 } from "zod";
 var SP_DESCRIPTION2 = "Story point value (1=Common, 2=Magic, 3=Rare, 5=Unique). The key is 'storyPointValue' \u2014 not 'storyPoints'.";
-var VALID_PROPERTY_KEYS = "title, storyPointValue, tagNames, githubPRUrl, githubBranch";
+var VALID_PROPERTY_KEYS = "title, storyPointValue, tagNames, githubPRUrl, githubBranch, risk";
+function describeUpdatedFields(p) {
+  const fields = [];
+  if (p.title !== void 0) fields.push(`title to "${p.title}"`);
+  if (p.storyPointValue !== void 0) fields.push(`story points to ${p.storyPointValue}`);
+  if (p.tagNames !== void 0) fields.push(`tags (${p.tagNames.length} tag(s))`);
+  if (p.githubPRUrl !== void 0) fields.push(`PR link to "${p.githubPRUrl}"`);
+  if (p.githubBranch !== void 0) fields.push(`branch to "${p.githubBranch}"`);
+  if (p.risk !== void 0) fields.push(`risk to ${p.risk ?? "cleared"}`);
+  return fields;
+}
 function buildDiscoveryTools(connection) {
   return [
     defineTool(
       "update_task_properties",
-      "Set one or more task properties in a single call. Valid keys: title, storyPointValue, tagNames, githubPRUrl, githubBranch. All are optional \u2014 include only the ones you want to update (at least one). Unknown keys are rejected.",
+      "Set one or more task properties in a single call. Valid keys: title, storyPointValue, tagNames, githubPRUrl, githubBranch, risk. All are optional \u2014 include only the ones you want to update (at least one). Unknown keys are rejected.",
       {
         title: z13.string().optional().describe("The new task title"),
         storyPointValue: z13.number().optional().describe(SP_DESCRIPTION2),
         tagNames: z13.array(z13.string()).optional().describe("Array of tag names to assign"),
         githubPRUrl: z13.string().url().optional().describe("GitHub pull request URL to link to this task"),
-        githubBranch: z13.string().optional().describe("Set the GitHub branch name for this task (e.g. 'conveyor/my-feature-abc123')")
+        githubBranch: z13.string().optional().describe("Set the GitHub branch name for this task (e.g. 'conveyor/my-feature-abc123')"),
+        risk: z13.enum(["critical", "high", "medium", "low"]).nullable().optional().describe(
+          "Risk level \u2014 how much important surface the task touches (critical/high/medium/low). Pass null to clear."
+        )
       },
-      async ({ title, storyPointValue, tagNames, githubPRUrl, githubBranch }) => {
+      async ({ title, storyPointValue, tagNames, githubPRUrl, githubBranch, risk }) => {
         try {
-          const nothingToUpdate = title === void 0 && storyPointValue === void 0 && tagNames === void 0 && githubPRUrl === void 0 && githubBranch === void 0;
-          if (nothingToUpdate) {
+          const params = {
+            title,
+            storyPointValue,
+            tagNames,
+            githubPRUrl,
+            githubBranch,
+            risk
+          };
+          const updatedFields = describeUpdatedFields(params);
+          if (updatedFields.length === 0) {
             return textResult(
               `No task properties were updated: none of the recognized keys were provided. Valid keys: ${VALID_PROPERTY_KEYS}. (Story points are set via 'storyPointValue', not 'storyPoints'.)`
             );
           }
           await connection.call("updateTaskProperties", {
             sessionId: connection.sessionId,
-            title,
-            storyPointValue,
-            tagNames,
-            githubPRUrl,
-            githubBranch
+            ...params
           });
-          const updatedFields = [];
-          if (title !== void 0) updatedFields.push(`title to "${title}"`);
-          if (storyPointValue !== void 0)
-            updatedFields.push(`story points to ${storyPointValue}`);
-          if (tagNames !== void 0) updatedFields.push(`tags (${tagNames.length} tag(s))`);
-          if (githubPRUrl !== void 0) updatedFields.push(`PR link to "${githubPRUrl}"`);
-          if (githubBranch !== void 0) updatedFields.push(`branch to "${githubBranch}"`);
           return textResult(`Task properties updated: ${updatedFields.join(", ")}`);
         } catch (error) {
           return textResult(
@@ -8513,12 +8716,14 @@ function buildConveyorTools(connection, config, context, agentMode) {
   const modeTools = getModeTools(effectiveMode, connection, config, context);
   const discoveryTools = effectiveMode === "discovery" || effectiveMode === "auto" || effectiveMode === "building" || effectiveMode === "chat" ? buildDiscoveryTools(connection) : [];
   const codeReviewTools = effectiveMode === "review" ? buildCodeReviewTools(connection) : [];
+  const handoffTools = config.mode === "pm" && (effectiveMode === "discovery" || effectiveMode === "auto") ? [buildHandoffTool(connection)] : [];
   const emergencyTools = [buildForceUpdateTaskStatusTool(connection)];
   const tools = withAlwaysLoad([
     ...commonTools,
     ...modeTools,
     ...discoveryTools,
     ...codeReviewTools,
+    ...handoffTools,
     ...emergencyTools
   ]);
   if (effectiveMode === "chat") {
@@ -10504,7 +10709,7 @@ async function runUsageProbe(deps = {}) {
         cols: 120,
         rows: 45,
         cwd,
-        env: buildProbeEnv()
+        env: buildProbeEnv(deps.env)
       });
     } catch {
       resolve("");
@@ -12024,10 +12229,12 @@ export {
   DEFAULT_LIFECYCLE_CONFIG,
   Lifecycle,
   defineTool,
-  cleanTerminalOutput,
   loadPtySpawn,
   inheritedEnv,
   buildPromptBytes,
+  cleanTerminalOutput,
+  buildSynthesizedCredentials,
+  claudeJsonPath,
   ClaudeTuiAdapter,
   createServiceLogger,
   PtyHarness,
@@ -12044,6 +12251,8 @@ export {
   findOnPath,
   resolvePlaywrightMcpServer,
   resolveSessionStart,
+  parseUsageGauges,
+  runUsageProbe,
   sampleKeyUsage,
   awaitGitReady,
   PortDiscovery,
@@ -12063,4 +12272,4 @@ export {
   runStartCommand,
   unshallowRepo
 };
-//# sourceMappingURL=chunk-P4VWWR5O.js.map
+//# sourceMappingURL=chunk-PXQJ4NVO.js.map