@namzu/cli 36.3.0 → 36.4.0

package/dist/chunks/{chunk-SFUUN6B3.js → chunk-RAKBF6PY.js}

@@ -2,22 +2,23 @@ import { createRequire as __namzuCreateRequire } from 'node:module';
 const require = __namzuCreateRequire(import.meta.url);
 import {
   openManagedWorktrees
-} from "./chunk-52OVP5BG.js";
+} from "./chunk-WIPSZYIM.js";
 import {
   createBrowserControl
 } from "./chunk-WHODOMXA.js";
 import {
   connectMcpServers
-} from "./chunk-JCDTR2ZU.js";
+} from "./chunk-TCHEQRJE.js";
 import {
   createSessionSkillCatalog
-} from "./chunk-XCWZZZOW.js";
+} from "./chunk-6ZEROVY4.js";
 import {
   SAVE_SKILL_TOOL_NAME,
   WORKFLOW_TOOL_DESCRIPTION,
   WORKFLOW_TOOL_NAME,
   attachAgentView,
   closeOpenAgents,
+  completionNotice,
   initialRunView,
   launchedText,
   readStoredTurnGuards,
@@ -26,10 +27,10 @@ import {
   viewFromJournal,
   workflowOffered,
   workflowRefusal
-} from "./chunk-QBAISLAD.js";
+} from "./chunk-ZJXRPK5W.js";
 import {
   openInBrowser
-} from "./chunk-AP5KD43Y.js";
+} from "./chunk-IGHTIUKD.js";
 import {
   CredentialRefreshRejectedError,
   CredentialWithdrawnError,
@@ -37,7 +38,7 @@ import {
   ensureFreshStoredCodexCredential,
   readSubscriptionCredential,
   sameOAuthCredential
-} from "./chunk-5URT3ZM2.js";
+} from "./chunk-3N3CDMDI.js";
 import {
   debugRequested
 } from "./chunk-GNBMKISG.js";
@@ -45,7 +46,7 @@ import {
   configuredPassthroughTools,
   resolveToolResultScreens,
   unmatchedPassthroughTools
-} from "./chunk-MBBFX64S.js";
+} from "./chunk-MUUBLY7G.js";
 import {
   formatSize,
   homePath,
@@ -73,7 +74,7 @@ import {
   requiresCredentialForModel,
   resolveChainCapabilities,
   unresolvedMembers
-} from "./chunk-DYUOXP5Q.js";
+} from "./chunk-QZSP4UWJ.js";
 import {
   PROVIDER_REGISTRY,
   missingCredentialMessage,
@@ -81,11 +82,11 @@ import {
 } from "./chunk-6LLJQ3KY.js";
 import {
   cliLogger
-} from "./chunk-FU4GQ7K2.js";
+} from "./chunk-KZJUG4HN.js";
 import {
   isPermissionMode,
   permissionModeLabel
-} from "./chunk-LBH5WVXU.js";
+} from "./chunk-DHXMHWOW.js";
 import {
   probeCapabilities
 } from "./chunk-OH6TB27S.js";
@@ -96,7 +97,7 @@ import {
 import {
   conversationLogPath,
   ensureSessionStarted
-} from "./chunk-EKUJUPFA.js";
+} from "./chunk-ZSPSXPRH.js";
 import {
   INSTRUCTIONS_FILENAME,
   MAX_CHARS_PER_FILE,
@@ -106,13 +107,13 @@ import {
 } from "./chunk-H6B6AROX.js";
 import {
   ensurePrivateStateDirectory
-} from "./chunk-S6MZK4LD.js";
+} from "./chunk-PAE4DIXR.js";
 import {
   restrictToOwner
-} from "./chunk-BOV53LZO.js";
+} from "./chunk-O5FRXERG.js";
 import {
   namzuHomePath
-} from "./chunk-HKDPP2JF.js";
+} from "./chunk-IQKT222K.js";
 import {
   AgentManager,
   AgentRegistry,
@@ -183,6 +184,7 @@ import {
   buildResidentToolEvidenceTools,
   buildSessionGoalTools,
   classifyEvidenceSource,
+  collectChatCompletion,
   compactNow,
   compactSession,
   computerUseUnavailableReason,
@@ -198,7 +200,9 @@ import {
   createReviewHandler,
   createSessionTextEvidenceSource,
   createSkillTool,
+  createSystemMessage,
   createToolPresenter,
+  createUserMessage,
   deferred,
   defineTool,
   discoverAgentDefinitions,
@@ -247,7 +251,7 @@ import {
   windowsShellNotice,
   withProviderFallback,
   wrapUntrusted
-} from "./chunk-V3ZLK3XQ.js";
+} from "./chunk-5YWWQUJ5.js";
 import {
   __name
 } from "./chunk-76FLAFCG.js";
@@ -4492,6 +4496,7 @@ var SubagentActivityMonitor = class {
     if (!prior || !prior.closed || this.options.replay)
       throw new Error("This child conversation is not available for continuation.");
     const opened = this.open(input, viewId);
+    opened.record.resumed = true;
     opened.record.rows = [...prior.rows];
     opened.record.sessionId = prior.sessionId;
     pushRow(opened.record, {
@@ -4520,6 +4525,7 @@ var SubagentActivityMonitor = class {
         model: bounded(input.model.trim(), MAX_AGENT_ACTIVITY_LABEL_CODE_UNITS)
       } : {},
       description: bounded(input.description, MAX_AGENT_ACTIVITY_LABEL_CODE_UNITS),
+      ...input.background ? { background: true } : {},
       prompt: bounded(input.prompt, MAX_PROMPT_CODE_UNITS),
       batchId,
       ...input.toolUseId ? { toolUseId: bounded(input.toolUseId, MAX_IDENTITY_LABEL_CODE_UNITS) } : {},
@@ -4560,6 +4566,7 @@ var SubagentActivityMonitor = class {
           return;
         }
         owned.completedAt = handle.completedAt ?? Date.now();
+        owned.queued = 0;
         owned.latestActivity = handle.result?.stopReason && handle.result.stopReason !== "end_turn" ? `Stopped \xB7 ${handle.result.stopReason}` : terminalLabel(owned.status);
         if (owned.rows.length === 0) {
           pushRow(owned, {
@@ -4654,7 +4661,7 @@ var SubagentActivityMonitor = class {
    * matching record (already pruned, or never tracked) is a silent no-op:
    * there is no row left to explain what was sent.
    */
-  recordMessage(taskId, text, direction) {
+  recordMessage(taskId, text, direction, kind = "queued") {
     if (this.closed) return;
     const record = [...this.records.values()].find((entry) => entry.taskId === taskId);
     if (!record) return;
@@ -4664,8 +4671,36 @@ var SubagentActivityMonitor = class {
       text: bounded(text, MAX_ROW_CODE_UNITS),
       direction
     });
+    if (kind === "queued" && !isTerminal(record.status)) record.queued = (record.queued ?? 0) + 1;
     this.notifyNow();
   }
+  /**
+   * Records who is stopping a running agent, so the line that closes it can
+   * say. The first answer stands; an agent that has ended is left alone.
+   */
+  markStopped(viewId, by) {
+    const record = this.records.get(viewId);
+    if (!record || this.closed || isTerminal(record.status) || record.stoppedBy) return;
+    record.stoppedBy = by;
+    this.scheduleNotify();
+  }
+  /** The parent's wait on this agent ended before it did; see {@link SubagentActivity.released}. */
+  markReleased(viewId) {
+    const record = this.records.get(viewId);
+    if (!record || this.closed || isTerminal(record.status) || record.released) return;
+    record.released = true;
+    this.scheduleNotify();
+  }
+  /**
+   * Sets the live label of a running agent (see `activity-label.ts`). Ignored
+   * once the agent has ended, and for an unknown row.
+   */
+  setSummary(viewId, label) {
+    const record = this.records.get(viewId);
+    if (!record || this.closed || isTerminal(record.status)) return;
+    record.summary = bounded(label, MAX_AGENT_ACTIVITY_LABEL_CODE_UNITS);
+    this.scheduleNotify();
+  }
   /**
    * Retains one line of PARENT-authored commentary for the rail to show.
    *
@@ -4736,6 +4771,12 @@ var SubagentActivityMonitor = class {
       ...record.tokens !== void 0 ? { tokens: record.tokens } : {},
       ...record.toolCalls !== void 0 ? { toolCalls: record.toolCalls } : {},
       description: record.description,
+      ...record.summary && !isTerminal(record.status) ? { summary: record.summary } : {},
+      ...record.queued ? { queued: record.queued } : {},
+      ...record.resumed ? { resumed: true } : {},
+      ...record.background ? { background: true } : {},
+      ...record.released ? { released: true } : {},
+      ...record.stoppedBy ? { stoppedBy: record.stoppedBy } : {},
       prompt: record.prompt,
       batchId: record.batchId,
       ...record.toolUseId ? { toolUseId: record.toolUseId } : {},
@@ -5003,6 +5044,7 @@ function projectEvent(record, event) {
           };
         }
       }
+      record.queued = 0;
       record.latestActivity = event.isError ? `${event.toolName} failed` : `${event.toolName} done`;
       return;
     }
@@ -5633,6 +5675,147 @@ var NamzuCliAgent = class extends QueryAgent {
   }
 };
 
+// src/integrations/subagents/activity-label.ts
+var LABEL_INTERVAL_MS = 3e4;
+var LABEL_MIN_MESSAGES = 3;
+var LABEL_MAX_CHARS = 100;
+var LABEL_CONTEXT_ROWS = 40;
+var LABEL_ROW_CHARS = 600;
+var LABEL_INSTRUCTION = [
+  "Say what this agent is doing right now, as a short status label for a list.",
+  'Rules: three to five words; present tense (for example "Reading config loader"); name the file or function it is working on rather than a branch or a goal; one line, no quotes, no punctuation at the end, no markdown.',
+  "Write the label in the predominant language of the notes below. A stray word or code token in another language does not change it, and neither does the language of these instructions.",
+  "If a previous label is shown and the agent is still doing that, repeat it; otherwise say what is new.",
+  "Use no tools. Reply with the label only."
+].join("\n");
+function validateLabel(reply) {
+  const trimmed = reply.trim();
+  if (trimmed.length === 0 || trimmed.length > LABEL_MAX_CHARS) return void 0;
+  if (/[\r\n]/u.test(trimmed)) return void 0;
+  if (trimmed.startsWith("#") || trimmed.includes("```")) return void 0;
+  return trimmed;
+}
+__name(validateLabel, "validateLabel");
+function labelPrompt(agent) {
+  const rows = agent.transcript.slice(-LABEL_CONTEXT_ROWS).map((row) => {
+    const who = row.kind === "assistant" ? "agent" : row.kind === "tool" ? "tool" : row.direction ? "message" : "note";
+    const text = row.kind === "tool" && row.detail ? `${row.text} -> ${row.detail}` : row.text;
+    return `${who}: ${text.replace(/\s+/gu, " ").slice(0, LABEL_ROW_CHARS)}`;
+  }).join("\n");
+  return [
+    `Task given to the agent:
+${agent.prompt.slice(0, 1500)}`,
+    `What it has done so far (oldest first):
+${rows}`,
+    agent.summary ? `Previous label: ${agent.summary}` : "No previous label."
+  ].join("\n\n");
+}
+__name(labelPrompt, "labelPrompt");
+function messageCount(agent) {
+  return 1 + agent.transcript.length;
+}
+__name(messageCount, "messageCount");
+function signature(agent) {
+  const last = agent.transcript.at(-1);
+  return `${agent.transcript.length}:${last?.id ?? ""}:${last && "text" in last ? last.text.length : 0}`;
+}
+__name(signature, "signature");
+function startActivityLabeler(options) {
+  const seen = /* @__PURE__ */ new Map();
+  const inFlight = /* @__PURE__ */ new Map();
+  const tick = /* @__PURE__ */ __name(() => {
+    const live = /* @__PURE__ */ new Set();
+    for (const agent of options.activity.getSnapshot()) {
+      const running = agent.status === "working" || agent.status === "queued";
+      if (!running) continue;
+      live.add(agent.viewId);
+      if (agent.background !== true || agent.replayed === true) continue;
+      if (agent.workflowRunId !== void 0) continue;
+      if (messageCount(agent) < LABEL_MIN_MESSAGES) continue;
+      if (inFlight.has(agent.viewId)) continue;
+      const sig = signature(agent);
+      if (seen.get(agent.viewId) === sig) continue;
+      seen.set(agent.viewId, sig);
+      const controller = new AbortController();
+      inFlight.set(agent.viewId, controller);
+      void options.ask(agent, LABEL_INSTRUCTION, labelPrompt(agent), controller.signal).then((reply) => {
+        if (!reply || controller.signal.aborted) return;
+        const label = validateLabel(reply.text);
+        if (label) options.activity.setSummary(agent.viewId, label);
+      }).catch(() => void 0).finally(() => {
+        inFlight.delete(agent.viewId);
+      });
+    }
+    for (const [id, controller] of inFlight) {
+      if (!live.has(id)) controller.abort();
+    }
+    for (const id of seen.keys()) if (!live.has(id)) seen.delete(id);
+  }, "tick");
+  const timer = setInterval(tick, options.intervalMs ?? LABEL_INTERVAL_MS);
+  timer.unref?.();
+  return {
+    stop() {
+      clearInterval(timer);
+      for (const controller of inFlight.values()) controller.abort();
+      inFlight.clear();
+    }
+  };
+}
+__name(startActivityLabeler, "startActivityLabeler");
+
+// src/integrations/subagents/label-ledger.ts
+var LABEL_REQUEST_ALLOWANCE_TOKENS = 8e3;
+var NOTHING = {
+  promptTokens: 0,
+  completionTokens: 0,
+  totalTokens: 0,
+  cachedTokens: 0,
+  cacheWriteTokens: 0
+};
+async function chargeLabelRequest(input) {
+  const { budget, sessionId, signal } = input;
+  let account;
+  try {
+    const remaining = budget.remaining;
+    const limited = Number.isFinite(remaining);
+    const allowance = limited ? Math.min(remaining, LABEL_REQUEST_ALLOWANCE_TOKENS) : 0;
+    if (limited && allowance < input.estimatedPromptTokens) return void 0;
+    account = budget.reserve(allowance);
+    try {
+      account.bindTurn(sessionId, generateTurnId());
+    } catch (error) {
+      account.settle();
+      throw error;
+    }
+  } catch {
+    return void 0;
+  }
+  let requestId;
+  try {
+    requestId = await account.beginRequest();
+  } catch {
+    account.settle();
+    return void 0;
+  }
+  try {
+    const result = await input.request();
+    await account.finishRequest(requestId, result.usage);
+    return result.value;
+  } catch (error) {
+    const cancelled2 = signal.aborted;
+    const prompt = cancelled2 ? Math.max(0, Math.ceil(input.estimatedPromptTokens)) : 0;
+    await account.finishRequest(requestId, {
+      ...NOTHING,
+      promptTokens: prompt,
+      totalTokens: prompt
+    }).catch(() => void 0);
+    throw error;
+  } finally {
+    account.settle();
+  }
+}
+__name(chargeLabelRequest, "chargeLabelRequest");
+
 // src/integrations/subagents/policy.ts
 var CLI_INTERACTIVE_TURN_TIMEOUT_MS = 0;
 
@@ -5851,7 +6034,12 @@ var refuseUnownedChildReview = /* @__PURE__ */ __name(async () => ({
   action: "abort",
   reason: "The parent turn no longer owns an interactive review channel for this sub-agent."
 }), "refuseUnownedChildReview");
-async function createSubagentRuntime(opts) {
+async function createSubagentRuntime(input) {
+  const childMessageListeners = /* @__PURE__ */ new Set();
+  const opts = {
+    ...input,
+    childExtraTools: /* @__PURE__ */ __name(() => childMessageListeners.size > 0 ? [toolset("agents:message-main", [messageMainTool])] : [], "childExtraTools")
+  };
   const registry = new AgentRegistry();
   registry.register(
     buildDefinition(
@@ -6056,6 +6244,7 @@ async function createSubagentRuntime(opts) {
         const runtime = {
           gateway,
           completionInbox,
+          budget,
           close() {
             if (released) return;
             released = true;
@@ -6101,8 +6290,38 @@ async function createSubagentRuntime(opts) {
     return (await pending).completionInbox;
   }, "completionInboxForTurn");
   const activity = new SubagentActivityMonitor();
+  const labeler = startActivityLabeler({
+    activity,
+    ask: /* @__PURE__ */ __name(async (agent, instruction, body, signal) => {
+      const owned = conversations.get(agent.viewId);
+      if (!owned || closed || owned.config.model !== void 0) return void 0;
+      const parent = await resolveParent(owned.turnId);
+      const turn = await parents.get(owned.turnId)?.catch(() => void 0);
+      if (!turn) return void 0;
+      const provider = await opts.buildProvider(parent.sessionId);
+      const model = owned.seed.model ?? opts.model;
+      const text = await chargeLabelRequest({
+        budget: turn.budget,
+        sessionId: parent.sessionId,
+        estimatedPromptTokens: Math.ceil((instruction.length + body.length) / 4),
+        signal,
+        request: /* @__PURE__ */ __name(async () => {
+          const response = await collectChatCompletion(
+            provider.chatStream({
+              model,
+              messages: [createSystemMessage(instruction), createUserMessage(body)],
+              maxTokens: 60,
+              signal
+            })
+          );
+          return { value: response.message.content ?? "", usage: response.usage };
+        }, "request")
+      });
+      return text === void 0 ? void 0 : { text };
+    }, "ask")
+  });
   let dynCounter = 0;
-  const launchChild = /* @__PURE__ */ __name(async (input, context, hooks = {}) => {
+  const launchChild = /* @__PURE__ */ __name(async (input2, context, hooks = {}) => {
     const {
       description,
       prompt,
@@ -6117,7 +6336,7 @@ async function createSubagentRuntime(opts) {
       model: requestedModel,
       provider: requestedProvider,
       effort: requestedEffort
-    } = input;
+    } = input2;
     if (!requestedModel && (requestedProvider || requestedEffort))
       throw new Error("Supply model when selecting a child provider or effort.");
     const explore = subagent_type === EXPLORE_SUBAGENT;
@@ -6167,6 +6386,7 @@ ${persona}` : persona || (explore ? EXPLORE_PROMPT : SUBAGENT_PROMPT),
       agentId,
       model: selection?.model ?? fileAgent?.model ?? parentModel,
       description,
+      ...run_in_background === true ? { background: true } : {},
       prompt,
       batchId: context.toolBatchId,
       toolUseId: context.toolUseId,
@@ -6282,6 +6502,8 @@ ${persona}` : persona || (explore ? EXPLORE_PROMPT : SUBAGENT_PROMPT),
           } : tracker.onEvent
         }
       });
+      if (outcome.kind === "yielded" && run_in_background !== true)
+        activity.markReleased(tracker.viewId);
       return { outcome, agentId };
     } catch (error) {
       tracker.fail(error);
@@ -6312,7 +6534,7 @@ ${persona}` : persona || (explore ? EXPLORE_PROMPT : SUBAGENT_PROMPT),
       properties: {
         description: {
           type: "string",
-          description: "Short label for tracking (shown to the user)."
+          description: "A short (3-5 word) description of the task."
         },
         prompt: {
           type: "string",
@@ -6386,9 +6608,9 @@ ${persona}` : persona || (explore ? EXPLORE_PROMPT : SUBAGENT_PROMPT),
     destructive: false,
     concurrencySafe: true,
     timeoutMs: opts.resolveLimits ? 0 : opts.timeoutMs ?? CLI_INTERACTIVE_TURN_TIMEOUT_MS,
-    async execute(input, context) {
-      const { description, run_in_background } = input;
-      const { outcome, agentId } = await launchChild(input, context);
+    async execute(input2, context) {
+      const { description, run_in_background } = input2;
+      const { outcome, agentId } = await launchChild(input2, context);
       if (outcome.kind === "yielded") {
         const progress = outcome.handle.state === "pending" ? "queued for an available slot" : "still running";
         return {
@@ -6513,8 +6735,8 @@ ${JSON.stringify(launch.schema)}`;
     readOnly: true,
     destructive: false,
     concurrencySafe: true,
-    async execute(input, context) {
-      const request = input;
+    async execute(input2, context) {
+      const request = input2;
       if (request.history || request.session_id) {
         if (!opts.savedAgents)
           return {
@@ -6535,9 +6757,8 @@ ${JSON.stringify(launch.schema)}`;
       }
       const gateway = await gatewayForTurn(context.turnId);
       const tasks = gateway.listTasks();
-      const labels = new Map(
-        activity.getSnapshot().map((entry) => [entry.taskId, entry.description])
-      );
+      const snapshot = activity.getSnapshot();
+      const labels = new Map(snapshot.map((entry) => [entry.taskId, entry.description]));
       const shown = tasks.slice(-40).map((task) => ({
         description: labels.get(task.taskId) ?? task.agentId,
         task_id: task.taskId,
@@ -6570,7 +6791,7 @@ ${JSON.stringify(launch.schema)}`;
       properties: {
         task_id: {
           type: "string",
-          description: "The task_id from the Agent launch receipt or task notification metadata."
+          description: "The task_id from the Agent launch receipt or task notification metadata. A workflow run id is not a task id."
         }
       },
       required: ["task_id"]
@@ -6581,11 +6802,19 @@ ${JSON.stringify(launch.schema)}`;
     destructive: false,
     concurrencySafe: true,
     timeoutMs: opts.resolveLimits ? 0 : opts.timeoutMs ?? CLI_INTERACTIVE_TURN_TIMEOUT_MS,
-    async execute(input, context) {
+    async execute(input2, context) {
       const gateway = await gatewayForTurn(context.turnId);
       let taskId;
+      const asked = input2.task_id;
+      if (typeof asked === "string" && /^w[0-9a-z]{8}$/.test(asked.trim())) {
+        return {
+          success: true,
+          output: `${asked.trim()} is a workflow run, not a task, so there is nothing to wait for here. You get one message when it ends, with what it returned. End your turn or do other work; do not call wait_for_task for it.`,
+          data: { run_id: asked.trim(), waited: false }
+        };
+      }
       try {
-        taskId = asTaskId(input.task_id);
+        taskId = asTaskId(asked);
       } catch {
         return {
           success: false,
@@ -6631,7 +6860,7 @@ ${JSON.stringify(launch.schema)}`;
   });
   const sendMessageTool = defineTool({
     name: "send_message",
-    description: "Queue a correction or additional context for a running or queued sub-agent task owned by this turn. The child receives it at its next request boundary; acceptance is not delivery. This does not start new work or restart finished tasks.",
+    description: "Send a correction or additional context to a sub-agent owned by this turn, addressed by its task id. A running or queued agent receives it at its next tool round; acceptance is not delivery. A finished agent is resumed from its own transcript with the message. An agent the user stopped is not resumed.",
     inputSchema: mcpJsonSchemaToZod({
       type: "object",
       properties: {
@@ -6654,9 +6883,9 @@ ${JSON.stringify(launch.schema)}`;
     readOnly: false,
     destructive: false,
     concurrencySafe: false,
-    async execute(input, context) {
+    async execute(input2, context) {
       context.abortSignal.throwIfAborted();
-      const { task_id, message: message2 } = input;
+      const { task_id, message: message2 } = input2;
       if (!message2.trim())
         return {
           success: false,
@@ -6672,18 +6901,36 @@ ${JSON.stringify(launch.schema)}`;
           output: "",
           error: `Task ${taskId} does not belong to this parent turn.`
         };
-      if (isTerminalAgentTaskState(task.state))
+      if (isTerminalAgentTaskState(task.state)) {
+        const shown = activity.getSnapshot().find((entry) => entry.taskId === String(taskId));
+        const label = shown?.agentId ?? String(taskId);
+        if (!shown)
+          return {
+            success: false,
+            output: "",
+            error: `Task ${taskId} has finished and cannot be resumed from here.`
+          };
+        try {
+          await messageChild(shown.viewId, message2, context.turnId, context.abortSignal, "parent");
+        } catch (error) {
+          return {
+            success: false,
+            output: "",
+            error: error instanceof Error ? error.message : String(error)
+          };
+        }
         return {
-          success: false,
-          output: "",
-          error: "This task has finished; send_message cannot restart it."
+          success: true,
+          output: `Resuming agent ${label}. It will notify you again when it finishes.`,
+          data: { task_id: taskId, status: "resumed" }
         };
+      }
       context.abortSignal.throwIfAborted();
       await gateway.continueTask(taskId, message2);
       activity.recordMessage(String(taskId), message2, "to-child");
       return {
         success: true,
-        output: `Message queued for task ${taskId}; it will be available at the child's next request boundary.`,
+        output: `Message queued for delivery to task ${taskId} at its next tool round. If it finishes first, it is resumed with the message and notifies again, so wait for that notification before resending.`,
         data: { task_id: taskId, status: "queued" }
       };
     }
@@ -6707,9 +6954,9 @@ ${JSON.stringify(launch.schema)}`;
     readOnly: false,
     destructive: false,
     concurrencySafe: false,
-    async execute(input, context) {
+    async execute(input2, context) {
       context.abortSignal.throwIfAborted();
-      const taskId = asTaskId(input.task_id);
+      const taskId = asTaskId(input2.task_id);
       const gateway = await gatewayForTurn(context.turnId);
       const task = gateway.getTask(taskId);
       if (!task)
@@ -6724,6 +6971,9 @@ ${JSON.stringify(launch.schema)}`;
           output: `Task ${taskId} already ended: ${agentTaskOutcome(task)}. No cancellation sent.`
         };
       context.abortSignal.throwIfAborted();
+      for (const [shownId, owned] of conversations) {
+        if (owned.task.taskId === taskId) activity.markStopped(shownId, "parent");
+      }
       gateway.cancelTask(taskId, "user");
       return {
         success: true,
@@ -6732,6 +6982,72 @@ ${JSON.stringify(launch.schema)}`;
       };
     }
   });
+  const messageMainTool = defineTool({
+    name: "send_message",
+    description: 'Send a message to the main conversation while you keep working. Your plain text output is not visible to the main conversation; to tell it something before you finish, you must call this tool with to "main". It is delivered with its next turn. Your final response goes to whoever launched you without this. Do not send routine progress: send what the main conversation needs to know or decide now.',
+    inputSchema: mcpJsonSchemaToZod({
+      type: "object",
+      properties: {
+        to: {
+          type: "string",
+          description: 'Recipient: "main", the main conversation.'
+        },
+        message: {
+          type: "string",
+          minLength: 1,
+          maxLength: 16e3,
+          description: "What to tell the main conversation."
+        }
+      },
+      required: ["to", "message"],
+      additionalProperties: false
+    }),
+    category: "custom",
+    permissions: [],
+    // Reads and writes nothing in the world; the text lands in the main
+    // conversation's context, framed as the child's own words.
+    readOnly: true,
+    destructive: false,
+    concurrencySafe: true,
+    async execute(input2, context) {
+      context.abortSignal.throwIfAborted();
+      const { to, message: message2 } = input2;
+      if (to !== "main")
+        return {
+          success: false,
+          output: "",
+          error: `No agent named '${to}' is currently addressable. Only "main" can be messaged from here.`
+        };
+      if (!message2.trim())
+        return { success: false, output: "", error: "Message must not be blank." };
+      const shown = activity.getSnapshot().find((entry) => entry.sessionId === String(context.sessionId));
+      const owned = shown ? conversations.get(shown.viewId) : void 0;
+      if (!shown || !owned || closed || childMessageListeners.size === 0 || shown.stoppedBy !== void 0)
+        return {
+          success: false,
+          output: "",
+          error: "Not sent. You cannot use send_message in this session: it is switched off for sub-agents, or you were stopped. Put what you need to pass on in your final response, which goes to whoever launched or resumed you."
+        };
+      const parent = await resolveParent(owned.turnId);
+      for (const listener of [...childMessageListeners]) {
+        try {
+          listener({
+            parentSessionId: String(parent.sessionId),
+            viewId: shown.viewId,
+            agentId: shown.agentId,
+            description: shown.description,
+            ...shown.taskId ? { taskId: shown.taskId } : {},
+            text: message2
+          });
+        } catch {
+        }
+      }
+      return {
+        success: true,
+        output: "Message queued for the main conversation's next turn."
+      };
+    }
+  });
   const narrationTool = defineTool({
     name: NARRATION_TOOL_NAME,
     description: [
@@ -6787,9 +7103,9 @@ ${JSON.stringify(launch.schema)}`;
       label: "Narrating",
       presentation: "activity"
     }), "presentCall"),
-    async execute(input, context) {
+    async execute(input2, context) {
       context.abortSignal.throwIfAborted();
-      const { line } = input;
+      const { line } = input2;
       const outcome = activity.narrate(line);
       if (outcome.kind === "empty")
         return {
@@ -6810,7 +7126,7 @@ ${JSON.stringify(launch.schema)}`;
       };
     }
   });
-  const messageChild = /* @__PURE__ */ __name(async (viewId, message2, turnId, signal) => {
+  const messageChild = /* @__PURE__ */ __name(async (viewId, message2, turnId, signal, source = "operator") => {
     if (closed) throw new Error("Sub-agent runtime is closed.");
     if (!message2.trim() || message2.length > 16e3)
       throw new Error("A child message must contain 1\u201316000 characters.");
@@ -6818,6 +7134,10 @@ ${JSON.stringify(launch.schema)}`;
     const shown = activity.getSnapshot().find((value) => value.viewId === viewId);
     if (!owned || !shown || shown.replayed)
       throw new Error("This child is saved evidence or is no longer owned by this host.");
+    if (shown.status === "cancelled")
+      throw new Error(
+        source === "operator" ? `${shown.agentId} was stopped, so it cannot take a message. Start a new agent for that work.` : `Agent "${shown.agentId}" was stopped by the user and was not resumed. Treat its work as cancelled; only start a new agent for it if the user explicitly asks.`
+      );
     if (owned.busy) throw new Error("A message to this child is already being admitted.");
     owned.busy = true;
     const id = randomUUID4();
@@ -6848,7 +7168,7 @@ ${JSON.stringify(launch.schema)}`;
       const parent = await resolveParent(turnId);
       if (owned.parentKey !== sessionKey(parent))
         throw new Error("This child belongs to a different parent conversation.");
-      if (opts.paths) {
+      if (opts.paths && source === "operator") {
         const directory = opts.paths.sessionDir({
           sessionId: parent.sessionId
         });
@@ -6909,7 +7229,12 @@ ${JSON.stringify(launch.schema)}`;
         kind = "started";
       }
       admitted = true;
-      activity.recordMessage(String(task.taskId), message2, "operator-to-child");
+      activity.recordMessage(
+        String(task.taskId),
+        message2,
+        source === "operator" ? "operator-to-child" : "to-child",
+        kind === "started" ? "started" : "queued"
+      );
       let auditWarning;
       try {
         await audit("accepted", String(task.taskId));
@@ -6942,6 +7267,7 @@ ${JSON.stringify(launch.schema)}`;
     if (closePromise) return closePromise;
     closed = true;
     closePromise = (async () => {
+      labeler.stop();
       await Promise.all([...parents.keys()].map(releaseTurn));
       await Promise.all(
         [...sessions.values()].map(async (entry) => (await entry.ready).manager.dispose())
@@ -6973,11 +7299,11 @@ ${JSON.stringify(launch.schema)}`;
     readOnly: true,
     destructive: false,
     concurrencySafe: true,
-    async execute(input, context) {
+    async execute(input2, context) {
       return {
         success: true,
         output: await listModels(
-          input.query ?? "",
+          input2.query ?? "",
           context.abortSignal
         )
       };
@@ -6990,10 +7316,17 @@ ${JSON.stringify(launch.schema)}`;
     if (!owned || !shown || shown.replayed) return false;
     const current = owned.gateway.getTask(owned.task.taskId) ?? owned.task;
     if (isTerminalAgentTaskState(current.state)) return false;
+    activity.markStopped(viewId, "user");
     owned.gateway.cancelTask(owned.task.taskId, "user");
     return true;
   }, "stopChild");
   return {
+    onChildMessage(listener) {
+      childMessageListeners.add(listener);
+      return () => {
+        childMessageListeners.delete(listener);
+      };
+    },
     cancelAgentTool,
     modelCatalogueTool,
     messageChild,
@@ -7007,9 +7340,9 @@ ${JSON.stringify(launch.schema)}`;
     sendMessageTool,
     narrationTool,
     allowedAgentIds: agentTypeIds,
-    launchesReadOnlyAgent(input) {
-      if (typeof input !== "object" || input === null) return false;
-      const fields = input;
+    launchesReadOnlyAgent(input2) {
+      if (typeof input2 !== "object" || input2 === null) return false;
+      const fields = input2;
       if (fields.workspace === "worktree") return false;
       if (fields.provider !== void 0 || fields.effort !== void 0) return false;
       const inherits = /* @__PURE__ */ __name((model) => model === void 0 || model === opts.model, "inherits");
@@ -7205,7 +7538,9 @@ ${SUBAGENT_PROMPT}`;
       const environment = opts.readEnvironment ? await opts.readEnvironment(childCwd) : null;
       const parent = options.parentTurnId ? await opts.resolveParent(asTurnId(options.parentTurnId)) : void 0;
       const provider = await opts.buildProvider(parent?.sessionId, selection);
-      const toolsets = tools();
+      const roster = tools();
+      const extra = opts.childExtraTools?.() ?? [];
+      const toolsets = extra.length > 0 ? [...roster, ...extra] : roster;
       const webSearch = opts.configureWebSearch?.(provider, options.model ?? model, toolsets);
       const resolvedToolsets = webSearch ? toolsets.map((ts) => filtered(ts, (tool) => tool.name !== "web_search")) : toolsets;
       return {
@@ -7342,6 +7677,7 @@ var WorkflowRunRegistry = class {
     };
     this.runs.set(input.runId, run2);
     this.notifySoon(true);
+    let firstAgentSeen = false;
     const settle = /* @__PURE__ */ __name(async (result, error) => {
       const at = this.now();
       if (run2.view.status === "running") {
@@ -7372,6 +7708,10 @@ var WorkflowRunRegistry = class {
       }, "onControl"),
       onEvent: /* @__PURE__ */ __name((event) => {
         run2.view = reduceRunView(run2.view, event);
+        if (event.type === "workflow_agent" && !firstAgentSeen) {
+          firstAgentSeen = true;
+          input.onFirstAgent?.();
+        }
         this.notifySoon(event.type !== "workflow_agent" || event.state !== "progress");
       }, "onEvent"),
       spawnAgent: /* @__PURE__ */ __name((request, signal) => input.spawn(request, signal, (viewId) => {
@@ -7424,6 +7764,18 @@ var WorkflowRunRegistry = class {
     }
     return void 0;
   }
+  /**
+   * Forget one run that has ended, so nothing lists it. For a run the tool
+   * answered inline: it never became background work. False when the run is
+   * unknown or still going.
+   */
+  discard(runId) {
+    const run2 = this.runs.get(runId);
+    if (!run2 || run2.view.status === "running") return false;
+    this.runs.delete(runId);
+    this.notifySoon(true);
+    return true;
+  }
   /** Forget runs that have ended (a new conversation). Running ones are stopped first. */
   reset() {
     for (const run2 of this.runs.values()) run2.abort.abort(new Error("The conversation changed."));
@@ -7473,6 +7825,24 @@ function createWorkflowRunId(isTaken = () => false) {
   }
 }
 __name(createWorkflowRunId, "createWorkflowRunId");
+function endedBeforeAgents(end, noArgs) {
+  const { view } = end;
+  if (view.status === "completed") {
+    return {
+      success: true,
+      output: completionNotice(view),
+      data: { run_id: view.runId, name: view.name, status: "completed", inline: true }
+    };
+  }
+  const reason = view.error ?? "no reason was given";
+  const hint = view.status === "failed" && noArgs ? '\nThis call passed no "args", so `args` was undefined in the script.' : "";
+  return {
+    success: false,
+    output: "",
+    error: view.status === "stopped" ? `Workflow "${view.name}" was stopped before it started any agent${view.error ? `: ${reason}` : "."}` : `${reason}${hint}`
+  };
+}
+__name(endedBeforeAgents, "endedBeforeAgents");
 function toolName(label) {
   if (!label) return { name: "tool" };
   const open3 = label.indexOf("(");
@@ -7508,7 +7878,7 @@ function createWorkflowHost(options) {
           description: "The workflow script: `export const meta = {...}` first, then the code. Plain JavaScript, not wrapped in a function or a code fence."
         },
         args: {
-          description: "JSON the script reads as `args`. Keep it small; the operator reads it before the run starts."
+          description: "JSON the script reads as `args`; undefined when omitted, so pass it or hard-code the values. Keep it small; the operator reads it before the run starts."
         },
         description: {
           type: "string",
@@ -7559,6 +7929,19 @@ function createWorkflowHost(options) {
       const limits = options.limitsFor?.(context.turnId);
       const journal = runs === void 0 ? void 0 : new FileWorkflowJournal(join9(runs, runId, "workflow"));
       const phaseDetail = /* @__PURE__ */ __name((title) => title === void 0 ? void 0 : meta.phases.find((phase) => phase.title.trim() === title.trim())?.detail, "phaseDetail");
+      let launching = true;
+      let settleLaunch = /* @__PURE__ */ __name(() => {
+      }, "settleLaunch");
+      const launch = new Promise((resolve9) => {
+        settleLaunch = resolve9;
+      });
+      const detach = /* @__PURE__ */ __name(() => {
+        if (!launching) return;
+        launching = false;
+        settleLaunch({ kind: "background" });
+      }, "detach");
+      const onAbort = /* @__PURE__ */ __name(() => detach(), "onAbort");
+      context.abortSignal.addEventListener("abort", onAbort, { once: true });
       try {
         const view = registry.start({
           runId,
@@ -7569,7 +7952,7 @@ function createWorkflowHost(options) {
           ...journal ? { journal } : {},
           spawn: /* @__PURE__ */ __name(async (request, signal, viewed) => {
             const detail = phaseDetail(request.phaseTitle);
-            const outcome = await options.subagents.launchWorkflowAgent({
+            const outcome2 = await options.subagents.launchWorkflowAgent({
               turnId: turn.turnId,
               runId,
               workflowName: meta.name,
@@ -7601,18 +7984,31 @@ function createWorkflowHost(options) {
               }, "onProgress")
             });
             return {
-              state: outcome.state,
-              ...outcome.text !== void 0 ? { text: outcome.text } : {},
-              tokens: outcome.tokens,
-              toolCalls: outcome.toolCalls,
-              ...outcome.error !== void 0 ? { error: outcome.error } : {}
+              state: outcome2.state,
+              ...outcome2.text !== void 0 ? { text: outcome2.text } : {},
+              tokens: outcome2.tokens,
+              toolCalls: outcome2.toolCalls,
+              ...outcome2.error !== void 0 ? { error: outcome2.error } : {}
             };
           }, "spawn"),
+          onFirstAgent: detach,
           onEnd: /* @__PURE__ */ __name(async (end) => {
             await turn.release().catch(() => void 0);
+            if (launching) {
+              launching = false;
+              settleLaunch({ kind: "ended", end });
+              return;
+            }
             options.onEnd?.(end);
           }, "onEnd")
         });
+        void view;
+        const outcome = await launch;
+        context.abortSignal.removeEventListener("abort", onAbort);
+        if (outcome.kind === "ended") {
+          registry.discard(runId);
+          return endedBeforeAgents(outcome.end, args === void 0);
+        }
         return {
           success: true,
           output: launchedText(view),
@@ -7624,6 +8020,7 @@ function createWorkflowHost(options) {
           }
         };
       } catch (error) {
+        context.abortSignal.removeEventListener("abort", onAbort);
         await turn.release();
         throw error;
       }
@@ -8930,10 +9327,10 @@ function clipRequestContext(prompt, limit, kind) {
 __name(clipRequestContext, "clipRequestContext");
 async function createAgentSession(prefs, detected, options = {}) {
   if (options.palEnvironment) {
-    const { createPalAgentSession } = await import("./agent-session-PLIPF3XG.js");
+    const { createPalAgentSession } = await import("./agent-session-NATAL4BA.js");
     return createPalAgentSession(prefs, detected, options);
   }
-  const { palAtWorkspace } = await import("./store-7WZWQXKX.js");
+  const { palAtWorkspace } = await import("./store-VVOUETR5.js");
   if (palAtWorkspace(options.cwd ?? process.cwd()))
     throw new Error("This Pal requires its owned virtual computer. Open it with namzu pal chat.");
   const fileObservations = /* @__PURE__ */ new Map();
@@ -9863,7 +10260,7 @@ async function createAgentSession(prefs, detected, options = {}) {
   if (options.openUrl) toolsets.push(toolset("open-url", [createOpenUrlTool()]));
   const decisionTool = maybeCreateDecisionTool(options.decision, process.env);
   if (decisionTool) toolsets.push(toolset("decide", [decisionTool]));
-  const operatorPals = await import("./operator-tools-H4MYC5PE.js");
+  const operatorPals = await import("./operator-tools-4NS32VMF.js");
   toolsets.push(
     readyWhen(
       toolset(
@@ -10503,6 +10900,8 @@ async function createAgentSession(prefs, detected, options = {}) {
           directChildReports.delete(listener);
         };
       }, "onSubagentReport"),
+      onSubagentMessage: /* @__PURE__ */ __name((listener) => subagentRuntime?.onChildMessage(listener) ?? (() => {
+      }), "onSubagentMessage"),
       stopSubagent: /* @__PURE__ */ __name((viewId) => subagentRuntime?.stopChild(viewId) ?? false, "stopSubagent"),
       messageSubagent: /* @__PURE__ */ __name((viewId, message2, opts) => operations.promise(opts?.signal, async (signal) => {
         const runtime = subagentRuntime;
@@ -12375,4 +12774,4 @@ export {
   RESULT_SUMMARY_WHOLE_MAX,
   resultSummaryLine
 };
-//# sourceMappingURL=chunk-SFUUN6B3.js.map
+//# sourceMappingURL=chunk-RAKBF6PY.js.map