replicas-engine 0.1.1302 → 0.1.1303

package/dist/src/{asp-host-CKIKB33N.js → asp-host-SNQAHZ4O.js}

@@ -8,12 +8,12 @@ import {
   listRunningCodexModels,
   restartCodexAspHost,
   restartCodexAspHostIfRunning
-} from "./chunk-EVZUJPQY.js";
-import "./chunk-WJNNX4X7.js";
-import "./chunk-4GOMPL6V.js";
-import "./chunk-II7A63N3.js";
+} from "./chunk-5OA7WBDC.js";
+import "./chunk-5ERKSVWK.js";
+import "./chunk-VQQPKWKF.js";
+import "./chunk-5MKQOOKZ.js";
 import "./chunk-UZSNFLDQ.js";
-import "./chunk-UAMATZ5S.js";
+import "./chunk-MXHSZLHO.js";
 import "./chunk-VEQXQN22.js";
 export {
   CODEX_ULTRAFAST_SERVICE_TIER,

package/dist/src/{chunk-WJNNX4X7.js → chunk-5ERKSVWK.js}

@@ -4,7 +4,7 @@ const require = __createRequire(import.meta.url);
 import {
   SUBPROCESS_MAX_BUFFER,
   execFileAsync
-} from "./chunk-II7A63N3.js";
+} from "./chunk-5MKQOOKZ.js";
 import {
   isRecord as isRecord2
 } from "./chunk-UZSNFLDQ.js";
@@ -22,7 +22,7 @@ import {
   provisionedDeviceSchema,
   readReplicasRuntimeEnv,
   serializePosixEnvFile
-} from "./chunk-UAMATZ5S.js";
+} from "./chunk-MXHSZLHO.js";
 
 // src/runtime-env-loader.ts
 import { readFileSync } from "fs";

package/dist/src/{chunk-II7A63N3.js → chunk-5MKQOOKZ.js}

@@ -3,7 +3,7 @@ import { createRequire as __createRequire } from 'node:module';
 const require = __createRequire(import.meta.url);
 import {
   HOOK_EXEC_MAX_BUFFER_BYTES
-} from "./chunk-UAMATZ5S.js";
+} from "./chunk-MXHSZLHO.js";
 
 // src/utils/exec.ts
 import { exec, execFile } from "child_process";

package/dist/src/{chunk-EVZUJPQY.js → chunk-5OA7WBDC.js}

@@ -10,15 +10,15 @@ import {
   resolveDiffBase,
   runGitCommand,
   setAgentCredentialSnapshot
-} from "./chunk-WJNNX4X7.js";
+} from "./chunk-5ERKSVWK.js";
 import {
   AppServerProcess,
   buildCodexAgentEnv
-} from "./chunk-4GOMPL6V.js";
+} from "./chunk-VQQPKWKF.js";
 import {
   SUBPROCESS_MAX_BUFFER,
   execFileAsync
-} from "./chunk-II7A63N3.js";
+} from "./chunk-5MKQOOKZ.js";
 import {
   isRecord
 } from "./chunk-UZSNFLDQ.js";
@@ -56,7 +56,7 @@ import {
   resolveOpenAICompatibleModelsUrl,
   splitMothershipInstructions,
   withTimeout
-} from "./chunk-UAMATZ5S.js";
+} from "./chunk-MXHSZLHO.js";
 
 // src/managers/codex-token-manager.ts
 import { promises as fs } from "fs";
@@ -306,7 +306,7 @@ var CodexTokenManager = class extends BaseRefreshManager {
     await this.applyCredentialUpdate(++this.credentialGeneration, async () => {
       await this.applyCredentialsResponse(data);
       setAgentCredentialSnapshot("codex", data);
-      const { restartCodexAspHostIfRunning: restartCodexAspHostIfRunning2 } = await import("./asp-host-CKIKB33N.js");
+      const { restartCodexAspHostIfRunning: restartCodexAspHostIfRunning2 } = await import("./asp-host-SNQAHZ4O.js");
       await restartCodexAspHostIfRunning2();
     });
     await this.start(true);
@@ -328,7 +328,7 @@ var CodexTokenManager = class extends BaseRefreshManager {
       const accountChanged = ENGINE_ENV.REPLICAS_AGENT_CREDENTIALS.codex?.credentialId !== data.credentialId;
       await this.applyCredentialsResponse(data);
       if (restartOnChange && (accountChanged || CODEX_AUTH_ENV_KEYS.some((key, index) => process.env[key] !== previousEnv[index]))) {
-        const { restartCodexAspHostIfRunning: restartCodexAspHostIfRunning2 } = await import("./asp-host-CKIKB33N.js");
+        const { restartCodexAspHostIfRunning: restartCodexAspHostIfRunning2 } = await import("./asp-host-SNQAHZ4O.js");
         await restartCodexAspHostIfRunning2();
       }
       setAgentCredentialSnapshot("codex", data);

package/dist/src/{chunk-GOOVARRF.js → chunk-HWYNJQUU.js}

@@ -3,7 +3,7 @@ import { createRequire as __createRequire } from 'node:module';
 const require = __createRequire(import.meta.url);
 import {
   AspClient
-} from "./chunk-4GOMPL6V.js";
+} from "./chunk-VQQPKWKF.js";
 import {
   ASTER_BASE_URL,
   ASTER_PROVIDER,
@@ -15,7 +15,7 @@ import {
   isRecord,
   readOllamaAuthEnv,
   readOpenAICompatibleAuthEnv
-} from "./chunk-UAMATZ5S.js";
+} from "./chunk-MXHSZLHO.js";
 
 // src/managers/codex-asp/notification-dispatch.ts
 var TURN_STARTED_METHOD = "turn/started";

package/dist/src/{chunk-UAMATZ5S.js → chunk-MXHSZLHO.js}

@@ -5185,7 +5185,9 @@ function splitMothershipInstructions(customInstructions) {
 
 // ../shared/src/mothership-events.ts
 var MOTHERSHIP_EVENT_KINDS = ["finished", "ready", "needs_attention", "merged", "closed", "archived"];
+var MOTHERSHIP_TURN_ERROR_SUMMARY = "Turn ended with an error.";
 var MOTHERSHIP_EVENT_TYPE = "multitask-event";
+var MOTHERSHIP_EVENT_MESSAGE_TYPE = "multitask_event";
 var mothershipEventSchema = z20.object({
   id: z20.string(),
   at: z20.string(),
@@ -5194,13 +5196,31 @@ var mothershipEventSchema = z20.object({
   agentName: z20.string(),
   summary: z20.string(),
   detail: z20.string().optional(),
+  // Set when the subagent is a chat in this workspace rather than a ship; agentId is then that chat's id.
+  chatId: z20.string().optional(),
   // Set on events recorded before every kind woke the orchestrator, which were shown as a row when they happened.
   noticed: z20.boolean().optional()
 });
 var TAG = "multitask_event";
 var BLOCK = new RegExp(`<${TAG}((?:\\s+\\w+="[^"]*")*)>\\n?([\\s\\S]*?)\\n?</${TAG}>`, "g");
 var ATTRIBUTE = /(\w+)="([^"]*)"/g;
+var escapeAttribute = (value) => value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;");
 var unescapeAttribute = (value) => value.replace(/&lt;/g, "<").replace(/&quot;/g, '"').replace(/&amp;/g, "&");
+var EVENT_RESPONSE_MAX_CHARS = 8e3;
+function truncateMothershipEventResponse(response, readTool) {
+  return response.length > EVENT_RESPONSE_MAX_CHARS ? `${response.slice(0, EVENT_RESPONSE_MAX_CHARS)}\u2026
+
+(Truncated; ${readTool} returns the full response.)` : response;
+}
+function formatMothershipEvents(events) {
+  return events.map((event) => {
+    const attributes = { id: event.id, at: event.at, kind: event.kind, agent: event.agentName, agent_id: event.agentId, ...event.chatId ? { chat_id: event.chatId } : {}, ...event.noticed ? { noticed: "true" } : {} };
+    const body = [event.summary, event.detail].filter(Boolean).join("\n\n").replaceAll(`</${TAG}`, `<\\/${TAG}`);
+    return `<${TAG}${Object.entries(attributes).map(([key, value]) => ` ${key}="${escapeAttribute(value)}"`).join("")}>
+${body}
+</${TAG}>`;
+  }).join("\n\n");
+}
 function extractMothershipEvents(text3) {
   return [...text3.matchAll(BLOCK)].flatMap((match) => {
     const attributes = Object.fromEntries([...match[1].matchAll(ATTRIBUTE)].map(([, key, value]) => [key, unescapeAttribute(value)]));
@@ -5216,6 +5236,7 @@ function extractMothershipEvents(text3) {
       agentName: attributes.agent ?? "ship",
       summary: summary.trim(),
       ...detail ? { detail } : {},
+      ...attributes.chat_id ? { chatId: attributes.chat_id } : {},
       ...attributes.noticed === "true" ? { noticed: true } : {}
     }];
   });
@@ -10770,6 +10791,10 @@ export {
   MOTHERSHIP_INSTRUCTIONS_TAG,
   wrapInTag,
   splitMothershipInstructions,
+  MOTHERSHIP_TURN_ERROR_SUMMARY,
+  MOTHERSHIP_EVENT_MESSAGE_TYPE,
+  truncateMothershipEventResponse,
+  formatMothershipEvents,
   coerceBackgroundTaskPayload,
   CHAT_FORK_EXCERPT_OMITTED_NOTICE,
   formatChatForkHandoffMessage,

package/dist/src/{chunk-QWDNTCIK.js → chunk-RCJP3KY5.js}

@@ -5,14 +5,14 @@ import {
   getOriginDefaultBranch,
   monolithRequest,
   runGitCommand
-} from "./chunk-WJNNX4X7.js";
+} from "./chunk-5ERKSVWK.js";
 import {
   extractCommandProtectionCommandText,
   findCommandProtectionGitLookups,
   findGitCommitSignals,
   findPrMergeSignals,
   parseCommandProtectionRequest
-} from "./chunk-UAMATZ5S.js";
+} from "./chunk-MXHSZLHO.js";
 
 // src/services/command-protection-service.ts
 import { readFile, stat } from "fs/promises";

package/dist/src/{chunk-4GOMPL6V.js → chunk-VQQPKWKF.js}

@@ -3,10 +3,10 @@ import { createRequire as __createRequire } from 'node:module';
 const require = __createRequire(import.meta.url);
 import {
   execFileAsync
-} from "./chunk-II7A63N3.js";
+} from "./chunk-5MKQOOKZ.js";
 import {
   isVersionBelow
-} from "./chunk-UAMATZ5S.js";
+} from "./chunk-MXHSZLHO.js";
 
 // src/utils/codex-agent-env.ts
 function buildCodexAgentEnv(source = process.env) {
@@ -240,7 +240,7 @@ function getCodexModelProvider(method) {
   if (method === "foundry") return "azure";
   return method === "ollama" || method === "openai-compatible" ? "replicas_openai_compatible" : "openai";
 }
-var ENGINE_PACKAGE_VERSION = "0.1.1301";
+var ENGINE_PACKAGE_VERSION = "0.1.1303";
 var INITIALIZE_METHOD = "initialize";
 var INITIALIZED_NOTIFICATION = "initialized";
 var ACCOUNT_LOGIN_START_METHOD = "account/login/start";

package/dist/src/{chunk-BHIBP2BR.js → chunk-XHKAQ3OC.js}

@@ -5,7 +5,7 @@ import {
   extractCommandProtectionCommandText,
   isRecord,
   parseCodeHostPrUrl
-} from "./chunk-UAMATZ5S.js";
+} from "./chunk-MXHSZLHO.js";
 
 // src/services/published-pull-request-urls.ts
 function publishedPullRequestUrls(result) {

package/dist/src/command-protection-hook.js

@@ -3,13 +3,13 @@ import { createRequire as __createRequire } from 'node:module';
 const require = __createRequire(import.meta.url);
 import {
   evaluateCommandProtection
-} from "./chunk-QWDNTCIK.js";
-import "./chunk-WJNNX4X7.js";
-import "./chunk-II7A63N3.js";
+} from "./chunk-RCJP3KY5.js";
+import "./chunk-5ERKSVWK.js";
+import "./chunk-5MKQOOKZ.js";
 import {
   isRecord
 } from "./chunk-UZSNFLDQ.js";
-import "./chunk-UAMATZ5S.js";
+import "./chunk-MXHSZLHO.js";
 import "./chunk-VEQXQN22.js";
 
 // src/command-protection-hook.ts

package/dist/src/headless-agent.js

@@ -14,12 +14,12 @@ import {
   recoverCompletedTurn,
   spawnMuseMsp,
   startMuseSession
-} from "./chunk-GOOVARRF.js";
+} from "./chunk-HWYNJQUU.js";
 import {
   AppServerProcess,
   buildCodexAgentEnv
-} from "./chunk-4GOMPL6V.js";
-import "./chunk-II7A63N3.js";
+} from "./chunk-VQQPKWKF.js";
+import "./chunk-5MKQOOKZ.js";
 import {
   AGENT,
   OPENCODE_GO_PROVIDER,
@@ -29,7 +29,7 @@ import {
   headlessAgentUsagePath,
   isRecord,
   withTimeout
-} from "./chunk-UAMATZ5S.js";
+} from "./chunk-MXHSZLHO.js";
 import "./chunk-VEQXQN22.js";
 
 // src/headless-agent.ts

package/dist/src/index.js

@@ -27,7 +27,7 @@ import {
   evaluateCommandProtection,
   extractToolCommand,
   reportCommandProtectionBlock
-} from "./chunk-QWDNTCIK.js";
+} from "./chunk-RCJP3KY5.js";
 import {
   ACCOUNT_RATE_LIMITS_UPDATED_METHOD,
   AGENT_MESSAGE_DELTA_METHOD,
@@ -65,10 +65,10 @@ import {
   spawnMuseMsp,
   startMuseSession,
   uuidV7
-} from "./chunk-GOOVARRF.js";
+} from "./chunk-HWYNJQUU.js";
 import {
   publishedPullRequestUrls
-} from "./chunk-BHIBP2BR.js";
+} from "./chunk-XHKAQ3OC.js";
 import {
   ACCOUNT_RATE_LIMITS_READ_METHOD,
   AsyncLock,
@@ -143,7 +143,7 @@ import {
   timestampFromSeconds,
   upsertCredentialFileLines,
   writeSecureCredentialFile
-} from "./chunk-EVZUJPQY.js";
+} from "./chunk-5OA7WBDC.js";
 import {
   ENGINE_ENV,
   monolithRequest,
@@ -153,15 +153,15 @@ import {
   resolveDiffBase,
   setAgentCredentialSnapshot,
   setLinearSessionId
-} from "./chunk-WJNNX4X7.js";
+} from "./chunk-5ERKSVWK.js";
 import {
   getCodexModelProvider
-} from "./chunk-4GOMPL6V.js";
+} from "./chunk-VQQPKWKF.js";
 import {
   SUBPROCESS_MAX_BUFFER,
   execAsync,
   execFileAsync
-} from "./chunk-II7A63N3.js";
+} from "./chunk-5MKQOOKZ.js";
 import {
   isRecord as isRecord2
 } from "./chunk-UZSNFLDQ.js";
@@ -236,7 +236,9 @@ import {
   MAX_CODEX_GOAL_OBJECTIVE_CHARS,
   MAX_REPO_FILE_CONTENT_BYTES,
   MERGED_MESSAGE_SEPARATOR,
+  MOTHERSHIP_EVENT_MESSAGE_TYPE,
   MOTHERSHIP_INSTRUCTIONS_TAG,
+  MOTHERSHIP_TURN_ERROR_SUMMARY,
   OLLAMA_AGENTS,
   OPENCODE_GO_BASE_URL,
   OPENCODE_GO_PROVIDER,
@@ -309,6 +311,7 @@ import {
   forkChatRequestSchema,
   formatChatForkHandoffMessage,
   formatChatForkUpdateMessage,
+  formatMothershipEvents,
   getChatContinuation,
   getChatHistoryPageSenders,
   getChatKind,
@@ -403,6 +406,7 @@ import {
   stripAgentDiagnosticErrors,
   threadHandoffText,
   toClaudeCodeModel,
+  truncateMothershipEventResponse,
   updateChatDisplayNameRequestSchema,
   waitSubagentRequestSchema,
   withTimeout,
@@ -411,7 +415,7 @@ import {
   workspaceTokenRequestSchema,
   workspaceTokenResponseSchema,
   wrapInTag
-} from "./chunk-UAMATZ5S.js";
+} from "./chunk-MXHSZLHO.js";
 import {
   cloneMcpConfig,
   ensureCompatibilityImports,
@@ -11650,7 +11654,7 @@ var MessageQueueService = class {
 // src/managers/subagent-mcp-prompt.ts
 var SUBAGENT_MCP_INSTRUCTIONS = `# Subagents
 
-Native subagent tools are disabled in this workspace. To delegate work to a subagent, use the \`${SUBAGENT_MCP_SERVER_NAME}\` MCP server (\`${SUBAGENT_MCP_TOOLS.getProviders}\`, \`${SUBAGENT_MCP_TOOLS.spawnAgent}\`, \`${SUBAGENT_MCP_TOOLS.getAgent}\`, \`${SUBAGENT_MCP_TOOLS.waitAgent}\`, \`${SUBAGENT_MCP_TOOLS.messageAgent}\`, \`${SUBAGENT_MCP_TOOLS.deleteAgent}\`); your harness may prefix them, and Pi exposes them through its \`mcp\` gateway. Call \`${SUBAGENT_MCP_TOOLS.getProviders}\` before the first spawn. \`fork_turns\` sets inherited context: "all" (default), "none" (include every needed detail in the prompt), or "N" for the latest N user turns. \`${SUBAGENT_MCP_TOOLS.spawnAgent}\` and \`${SUBAGENT_MCP_TOOLS.messageAgent}\` block by default; pass \`blocking: false\` to keep working, then use \`${SUBAGENT_MCP_TOOLS.getAgent}\` or \`${SUBAGENT_MCP_TOOLS.waitAgent}\`. Subagents share this workspace.`;
+Native subagent tools are disabled in this workspace. To delegate work to a subagent, use the \`${SUBAGENT_MCP_SERVER_NAME}\` MCP server (\`${SUBAGENT_MCP_TOOLS.getProviders}\`, \`${SUBAGENT_MCP_TOOLS.spawnAgent}\`, \`${SUBAGENT_MCP_TOOLS.getAgent}\`, \`${SUBAGENT_MCP_TOOLS.waitAgent}\`, \`${SUBAGENT_MCP_TOOLS.messageAgent}\`, \`${SUBAGENT_MCP_TOOLS.deleteAgent}\`); your harness may prefix them, and Pi exposes them through its \`mcp\` gateway. Call \`${SUBAGENT_MCP_TOOLS.getProviders}\` before the first spawn. \`fork_turns\` sets inherited context: "all" (default), "none" (include every needed detail in the prompt), or "N" for the latest N user turns. \`${SUBAGENT_MCP_TOOLS.spawnAgent}\` and \`${SUBAGENT_MCP_TOOLS.messageAgent}\` block by default; pass \`blocking: false\` to keep working. A subagent you are not waiting on reports back when it finishes: its final response arrives as a \`<multitask_event>\` message once your turn ends, so end your turn instead of polling. Subagents share this workspace.`;
 
 // src/managers/coding-agent-manager.ts
 var MAX_INTERRUPT_QUEUE_ITEMS = 1e3;
@@ -60262,6 +60266,8 @@ var ChatService = class {
   agentChatActivityTrackerService;
   agentTokenUsageTracker;
   chats = /* @__PURE__ */ new Map();
+  awaitedSubagents = /* @__PURE__ */ new Map();
+  heldSubagentReports = /* @__PURE__ */ new Map();
   forkSourceSeenBlocks = /* @__PURE__ */ new Map();
   persistPromise = null;
   persistQueued = false;
@@ -60468,19 +60474,68 @@ var ChatService = class {
   async waitForSubagent(parentChatId, chatId, timeoutMinutes, signal) {
     const timeoutMs = timeoutMinutes ? timeoutMinutes * 6e4 : null;
     const startedAt = Date.now();
-    while (true) {
-      if (signal?.aborted) throw new Error("Subagent wait was cancelled");
-      const result = await this.getSubagent(parentChatId, chatId);
-      if (result.status === "completed") return result;
-      if (this.requireChat(parentChatId).provider.getQueue().some(({ steeredAt }) => steeredAt && Date.parse(steeredAt) >= startedAt)) {
-        return { ...result, interruptedByUserMessage: true };
-      }
-      const remainingMs = timeoutMs === null ? null : timeoutMs - (Date.now() - startedAt);
-      if (remainingMs !== null && remainingMs <= 0) return { ...result, timedOut: true };
-      await new Promise((resolve7) => setTimeout(
-        resolve7,
-        remainingMs === null ? SUBAGENT_POLL_INTERVAL_MS : Math.min(SUBAGENT_POLL_INTERVAL_MS, remainingMs)
-      ));
+    this.awaitedSubagents.set(chatId, (this.awaitedSubagents.get(chatId) ?? 0) + 1);
+    try {
+      while (true) {
+        if (signal?.aborted) throw new Error("Subagent wait was cancelled");
+        const result = await this.getSubagent(parentChatId, chatId);
+        if (result.status === "completed" && !signal?.aborted) {
+          this.heldSubagentReports.delete(chatId);
+          return result;
+        }
+        if (this.requireChat(parentChatId).provider.getQueue().some(({ steeredAt }) => steeredAt && Date.parse(steeredAt) >= startedAt)) {
+          return { ...result, interruptedByUserMessage: true };
+        }
+        const remainingMs = timeoutMs === null ? null : timeoutMs - (Date.now() - startedAt);
+        if (remainingMs !== null && remainingMs <= 0) return { ...result, timedOut: true };
+        await new Promise((resolve7) => setTimeout(
+          resolve7,
+          remainingMs === null ? SUBAGENT_POLL_INTERVAL_MS : Math.min(SUBAGENT_POLL_INTERVAL_MS, remainingMs)
+        ));
+      }
+    } finally {
+      const waits = (this.awaitedSubagents.get(chatId) ?? 1) - 1;
+      if (waits > 0) this.awaitedSubagents.set(chatId, waits);
+      else {
+        this.awaitedSubagents.delete(chatId);
+        const held = this.heldSubagentReports.get(chatId);
+        const child = this.getRuntimeChat(chatId);
+        this.heldSubagentReports.delete(chatId);
+        if (held && child) void this.reportSubagentToParent(child, held.completedAt, held.errors);
+      }
+    }
+  }
+  async reportSubagentToParent(chat, completedAt, errors) {
+    const parentChatId = chat.persisted.parentChatId;
+    if (!parentChatId) return;
+    if (this.awaitedSubagents.has(chat.persisted.id)) {
+      this.heldSubagentReports.set(chat.persisted.id, { completedAt, errors });
+      return;
+    }
+    const last = this.getRuntimeChat(parentChatId)?.lastSendRequest;
+    if (!last) return;
+    try {
+      const detail = errors?.length ? errors.join("\n") : extractFinalResponse(await chat.provider.getHistory(), chat.persisted.provider) ?? "[No response from subagent]";
+      await this.sendMessage(parentChatId, {
+        message: formatMothershipEvents([{
+          id: randomUUID10(),
+          at: completedAt,
+          kind: "finished",
+          agentId: chat.persisted.id,
+          agentName: chat.persisted.title,
+          chatId: chat.persisted.id,
+          summary: `${errors?.length ? MOTHERSHIP_TURN_ERROR_SUMMARY : "Finished its turn."} It is a subagent in this workspace: reach it with the ${SUBAGENT_MCP_TOOLS.messageAgent} and ${SUBAGENT_MCP_TOOLS.getAgent} tools and this chat_id.`,
+          detail: truncateMothershipEventResponse(detail, SUBAGENT_MCP_TOOLS.getAgent)
+        }]),
+        ...last.customInstructions ? { customInstructions: last.customInstructions } : {},
+        ...last.enableInteractiveTools !== void 0 ? { enableInteractiveTools: last.enableInteractiveTools } : {},
+        type: MOTHERSHIP_EVENT_MESSAGE_TYPE,
+        merge: true,
+        inheritThinkingLevel: true,
+        idempotencyKey: `subagent-finished:${chat.persisted.id}:${completedAt}`
+      });
+    } catch (error) {
+      console.error("[ChatService] Failed to report subagent to its parent:", { chatId: chat.persisted.id, error });
     }
   }
   async sendMessage(chatId, request) {
@@ -61779,6 +61834,7 @@ ${note}`;
     if (chat.persisted.parentChatId) {
       this.publish({ type: "chat.updated", payload: { chat: this.toSummary(chat) } }).catch(() => {
       });
+      if (!processing) void this.reportSubagentToParent(chat, completedAt, chat.lastTurnErrors);
       return;
     }
     this.publish({

package/dist/src/post-tool-pr-hook.js

@@ -3,13 +3,13 @@ import { createRequire as __createRequire } from 'node:module';
 const require = __createRequire(import.meta.url);
 import {
   publishedPullRequestUrls
-} from "./chunk-BHIBP2BR.js";
+} from "./chunk-XHKAQ3OC.js";
 import {
   isRecord
 } from "./chunk-UZSNFLDQ.js";
 import {
   shouldRefreshPullRequests
-} from "./chunk-UAMATZ5S.js";
+} from "./chunk-MXHSZLHO.js";
 import "./chunk-VEQXQN22.js";
 
 // src/services/post-tool-pr-notifier.ts

package/dist/src/subagent-mcp.js

@@ -11,7 +11,7 @@ import {
   spawnSubagentRequestSchema,
   subagentResponseSchema,
   waitSubagentRequestSchema
-} from "./chunk-UAMATZ5S.js";
+} from "./chunk-MXHSZLHO.js";
 import "./chunk-VEQXQN22.js";
 
 // src/subagent-mcp.ts
@@ -43,13 +43,14 @@ async function request(path, method, body) {
   if (!response.ok) throw new Error(text || `Subagent request failed (${response.status})`);
   return text || JSON.stringify({ success: true });
 }
-async function waitForAgent(chatId, timeoutMinutes) {
+async function waitForAgent(chatId, timeoutMinutes, signal) {
   const query = timeoutMinutes ? `?timeoutMinutes=${timeoutMinutes}` : "";
   const response = await fetch(`http://localhost:${enginePort}/chats/${parentChatId}/subagents/${chatId}/wait${query}`, {
     headers: {
       Accept: "text/event-stream",
       "X-Replicas-Engine-Secret": engineSecret
-    }
+    },
+    signal
   });
   if (!response.ok || !response.body) throw new Error(await response.text() || `Subagent wait failed (${response.status})`);
   let result;
@@ -79,7 +80,7 @@ server.registerTool(SUBAGENT_MCP_TOOLS.getProviders, {
   content: [{ type: "text", text: await request(`/chats/${parentChatId}/subagents`, "GET") }]
 }));
 server.registerTool(SUBAGENT_MCP_TOOLS.spawnAgent, {
-  description: "Spawn a child agent with all, none, or the latest N turns of parent context. Blocks by default; set blocking to false to return its chat ID immediately.",
+  description: "Spawn a child agent with all, none, or the latest N turns of parent context. Blocks by default; set blocking to false to return its chat ID immediately, and its final response reaches you as a message once your turn ends.",
   inputSchema: {
     provider: spawnSubagentRequestSchema.shape.provider.describe("Provider returned by get_providers."),
     prompt: spawnSubagentRequestSchema.shape.prompt.describe("The child\u2019s assigned task, scope, and expected result. Include all necessary context when fork_turns is none."),
@@ -91,7 +92,7 @@ server.registerTool(SUBAGENT_MCP_TOOLS.spawnAgent, {
     blocking: z.boolean().optional().describe("Wait for the child to finish. Defaults to true."),
     timeout_minutes: waitSubagentRequestSchema.shape.timeoutMinutes.describe("Maximum time to wait without interrupting the child.")
   }
-}, async ({ provider, prompt, fork_turns, model, thinking_level, service_tier, title, blocking, timeout_minutes }) => {
+}, async ({ provider, prompt, fork_turns, model, thinking_level, service_tier, title, blocking, timeout_minutes }, { signal }) => {
   const created = await request(`/chats/${parentChatId}/subagents`, "POST", {
     provider,
     prompt,
@@ -102,7 +103,7 @@ server.registerTool(SUBAGENT_MCP_TOOLS.spawnAgent, {
     ...title ? { title } : {}
   });
   const createdAgent = subagentResponseSchema.parse(JSON.parse(created));
-  return { content: [{ type: "text", text: blocking === false ? created : await waitForAgent(createdAgent.chatId, timeout_minutes) }] };
+  return { content: [{ type: "text", text: blocking === false ? created : await waitForAgent(createdAgent.chatId, timeout_minutes, signal) }] };
 });
 server.registerTool(SUBAGENT_MCP_TOOLS.getAgent, {
   description: "Get the current status and final response, if available, for one of this chat\u2019s subagents.",
@@ -116,11 +117,11 @@ server.registerTool(SUBAGENT_MCP_TOOLS.waitAgent, {
     chat_id: z.string().uuid(),
     timeout_minutes: waitSubagentRequestSchema.shape.timeoutMinutes
   }
-}, async ({ chat_id, timeout_minutes }) => ({
-  content: [{ type: "text", text: await waitForAgent(chat_id, timeout_minutes) }]
+}, async ({ chat_id, timeout_minutes }, { signal }) => ({
+  content: [{ type: "text", text: await waitForAgent(chat_id, timeout_minutes, signal) }]
 }));
 server.registerTool(SUBAGENT_MCP_TOOLS.messageAgent, {
-  description: "Send a follow-up to one of this chat\u2019s subagents. Blocks by default; set blocking to false to return immediately.",
+  description: "Send a follow-up to one of this chat\u2019s subagents. Blocks by default; set blocking to false to return immediately, and its reply reaches you as a message once your turn ends.",
   inputSchema: {
     chat_id: z.string().uuid(),
     message: messageSubagentRequestSchema.shape.message,
@@ -130,14 +131,14 @@ server.registerTool(SUBAGENT_MCP_TOOLS.messageAgent, {
     blocking: z.boolean().optional().describe("Wait for the child to finish. Defaults to true."),
     timeout_minutes: waitSubagentRequestSchema.shape.timeoutMinutes.describe("Maximum time to wait without interrupting the child.")
   }
-}, async ({ chat_id, message, model, thinking_level, service_tier, blocking, timeout_minutes }) => {
+}, async ({ chat_id, message, model, thinking_level, service_tier, blocking, timeout_minutes }, { signal }) => {
   const accepted = await request(`/chats/${parentChatId}/subagents/${chat_id}/messages`, "POST", {
     message,
     ...model ? { model } : {},
     ...thinking_level ? { thinkingLevel: thinking_level } : {},
     ...serviceTierFields(service_tier)
   });
-  return { content: [{ type: "text", text: blocking === false ? accepted : await waitForAgent(chat_id, timeout_minutes) }] };
+  return { content: [{ type: "text", text: blocking === false ? accepted : await waitForAgent(chat_id, timeout_minutes, signal) }] };
 });
 server.registerTool(SUBAGENT_MCP_TOOLS.deleteAgent, {
   description: "Delete one of this chat\u2019s subagents.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "replicas-engine",
-  "version": "0.1.1302",
+  "version": "0.1.1303",
   "description": "Lightweight API server for Replicas workspaces",
   "type": "module",
   "main": "dist/src/index.js",