replicas-engine 0.1.1302 → 0.1.1305

package/dist/src/{asp-host-CKIKB33N.js → asp-host-QEZNRY2W.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-SYZXJP4X.js";
+import "./chunk-TKAWFIXX.js";
+import "./chunk-AS77RMSN.js";
+import "./chunk-IHC4JY3Q.js";
 import "./chunk-UZSNFLDQ.js";
-import "./chunk-UAMATZ5S.js";
+import "./chunk-QBNBBWCE.js";
 import "./chunk-VEQXQN22.js";
 export {
   CODEX_ULTRAFAST_SERVICE_TIER,

package/dist/src/{chunk-4GOMPL6V.js → chunk-AS77RMSN.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-IHC4JY3Q.js";
 import {
   isVersionBelow
-} from "./chunk-UAMATZ5S.js";
+} from "./chunk-QBNBBWCE.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.1305";
 var INITIALIZE_METHOD = "initialize";
 var INITIALIZED_NOTIFICATION = "initialized";
 var ACCOUNT_LOGIN_START_METHOD = "account/login/start";

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

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

package/dist/src/{chunk-II7A63N3.js → chunk-IHC4JY3Q.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-QBNBBWCE.js";
 
 // src/utils/exec.ts
 import { exec, execFile } from "child_process";

package/dist/src/{chunk-GOOVARRF.js → chunk-NG63G5VA.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-AS77RMSN.js";
 import {
   ASTER_BASE_URL,
   ASTER_PROVIDER,
@@ -15,7 +15,7 @@ import {
   isRecord,
   readOllamaAuthEnv,
   readOpenAICompatibleAuthEnv
-} from "./chunk-UAMATZ5S.js";
+} from "./chunk-QBNBBWCE.js";
 
 // src/managers/codex-asp/notification-dispatch.ts
 var TURN_STARTED_METHOD = "turn/started";

package/dist/src/{chunk-UAMATZ5S.js → chunk-QBNBBWCE.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 } : {}
     }];
   });
@@ -9699,6 +9720,7 @@ function findPushSignals({ commands, invocations, truncated }, context) {
   });
   return truncated ? [...signals, "git-push-unknown-destination"] : signals;
 }
+var apiMethod = (args) => /(?:^|\s)(?:-X\s*|--method[\s=])(\w+)/i.exec(args.join(" "))?.[1]?.toUpperCase();
 function isPrMergeCommand(argv) {
   const name = argv[0].split("/").pop();
   if (name !== "gh" && name !== "glab") return false;
@@ -9706,8 +9728,7 @@ function isPrMergeCommand(argv) {
   if (args.includes("--help") || args.includes("-h")) return false;
   const words = args.filter((arg, index) => !arg.startsWith("-") && !/^(?:-R|--repo)$/.test(args[index - 1] ?? ""));
   if (words[0] === (name === "gh" ? "pr" : "mr") && words[1] === "merge") return true;
-  const method = /(?:^|\s)(?:-X\s*|--method[\s=])(\w+)/i.exec(args.join(" "))?.[1];
-  return words[0] === "api" && method?.toUpperCase() === "PUT" && words.some((word) => /\/(?:pulls|merge_requests)\/[^/]+\/merge$/.test(word));
+  return words[0] === "api" && apiMethod(args) === "PUT" && words.some((word) => /\/(?:pulls|merge_requests)\/[^/]+\/merge$/.test(word));
 }
 var matchingChecks = (checks, text3) => checks.flatMap(([name, pattern]) => pattern.test(text3) ? [name] : []);
 function executedText(commands, keepWord = () => true) {
@@ -9739,6 +9760,29 @@ function findPrMergeSignals(parsed, context) {
 function findGitCommitSignals({ invocations, truncated }) {
   return truncated || invocations.some(({ subcommand }) => subcommand === "commit") ? ["git-commit"] : [];
 }
+var SCOUT_BLOCKED_GIT_SUBCOMMANDS = /* @__PURE__ */ new Set(["clone", "push"]);
+var SCOUT_BLOCKED_HOST_COMMANDS = {
+  gh: ["repo clone", "repo fork", "pr create", "pr new"],
+  glab: ["repo clone", "repo fork", "mr create", "mr new"]
+};
+function findScoutRepoWriteSignals(parsed) {
+  const { commands, invocations } = parsed;
+  return [.../* @__PURE__ */ new Set([
+    ...findGitCommitSignals(parsed),
+    ...invocations.flatMap(({ subcommand }) => SCOUT_BLOCKED_GIT_SUBCOMMANDS.has(subcommand) ? [`git-${subcommand}`] : []),
+    ...commands.flatMap(({ argv }) => {
+      const name = argv[0].split("/").pop() ?? "";
+      const args = argv.slice(1);
+      const words = args.filter((arg, index) => !arg.startsWith("-") && !/^(?:-R|--repo)$/.test(args[index - 1] ?? ""));
+      const command = words.slice(0, 2).join(" ");
+      if (SCOUT_BLOCKED_HOST_COMMANDS[name]?.includes(command)) return [`${name}-${command.replace(" ", "-")}`];
+      if (name !== "gh" || words[0] !== "api" || !words.some((word) => /\/pulls\/?$/.test(word))) return [];
+      const method = apiMethod(args);
+      const hasFields = args.some((arg) => /^(?:-[fF]|--(?:raw-)?field(?:=|$)|--input(?:=|$))/.test(arg));
+      return (method ? method === "POST" : hasFields) ? ["gh-api-create-pull-request"] : [];
+    })
+  ])];
+}
 function findCommandProtectionGitLookups({ invocations }) {
   const writes = invocations.filter(({ subcommand }) => subcommand === "commit" || subcommand === "push");
   const messageFiles = writes.flatMap(({ subcommand, args, dir, command }) => {
@@ -10770,6 +10814,10 @@ export {
   MOTHERSHIP_INSTRUCTIONS_TAG,
   wrapInTag,
   splitMothershipInstructions,
+  MOTHERSHIP_TURN_ERROR_SUMMARY,
+  MOTHERSHIP_EVENT_MESSAGE_TYPE,
+  truncateMothershipEventResponse,
+  formatMothershipEvents,
   coerceBackgroundTaskPayload,
   CHAT_FORK_EXCERPT_OMITTED_NOTICE,
   formatChatForkHandoffMessage,
@@ -10867,6 +10915,7 @@ export {
   parseCommandProtectionRequest,
   findPrMergeSignals,
   findGitCommitSignals,
+  findScoutRepoWriteSignals,
   findCommandProtectionGitLookups,
   shouldRefreshPullRequests,
   MAX_REPO_FILE_CONTENT_BYTES,

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

@@ -10,15 +10,15 @@ import {
   resolveDiffBase,
   runGitCommand,
   setAgentCredentialSnapshot
-} from "./chunk-WJNNX4X7.js";
+} from "./chunk-TKAWFIXX.js";
 import {
   AppServerProcess,
   buildCodexAgentEnv
-} from "./chunk-4GOMPL6V.js";
+} from "./chunk-AS77RMSN.js";
 import {
   SUBPROCESS_MAX_BUFFER,
   execFileAsync
-} from "./chunk-II7A63N3.js";
+} from "./chunk-IHC4JY3Q.js";
 import {
   isRecord
 } from "./chunk-UZSNFLDQ.js";
@@ -56,7 +56,7 @@ import {
   resolveOpenAICompatibleModelsUrl,
   splitMothershipInstructions,
   withTimeout
-} from "./chunk-UAMATZ5S.js";
+} from "./chunk-QBNBBWCE.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-QEZNRY2W.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-QEZNRY2W.js");
         await restartCodexAspHostIfRunning2();
       }
       setAgentCredentialSnapshot("codex", data);

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

@@ -4,7 +4,7 @@ const require = __createRequire(import.meta.url);
 import {
   SUBPROCESS_MAX_BUFFER,
   execFileAsync
-} from "./chunk-II7A63N3.js";
+} from "./chunk-IHC4JY3Q.js";
 import {
   isRecord as isRecord2
 } from "./chunk-UZSNFLDQ.js";
@@ -22,7 +22,7 @@ import {
   provisionedDeviceSchema,
   readReplicasRuntimeEnv,
   serializePosixEnvFile
-} from "./chunk-UAMATZ5S.js";
+} from "./chunk-QBNBBWCE.js";
 
 // src/runtime-env-loader.ts
 import { readFileSync } from "fs";
@@ -172,6 +172,7 @@ function loadEngineEnv(runtimeEnvValues) {
     REPLICAS_ENV_DEVICES: parseDevices(readEnv("REPLICAS_ENV_DEVICES")),
     TS_AUTHKEY: readEnv("TS_AUTHKEY"),
     REPLICAS_DISABLE_AUTO_START_HOOKS: readEnv("REPLICAS_DISABLE_AUTO_START_HOOKS")?.toLowerCase() === "true",
+    REPLICAS_SCOUT: readEnv("REPLICAS_SCOUT") === "true",
     REPLICAS_MAX_LIVE_AGENT_PROCESSES: Number(readEnv("REPLICAS_MAX_LIVE_AGENT_PROCESSES")) || void 0
   };
   delete process.env.REPLICAS_ENV_DEVICES;
@@ -354,16 +355,16 @@ var MonolithService = class {
 var monolithService = new MonolithService();
 
 export {
-  runGitCommand,
-  readRepoHeadBranches,
-  getOriginDefaultBranch,
-  getCurrentBranch,
-  resolveDiffBase,
   readRuntimeEnvFile,
   ENGINE_ENV,
   reloadEngineEnv,
   setLinearSessionId,
   setAgentCredentialSnapshot,
+  runGitCommand,
+  readRepoHeadBranches,
+  getOriginDefaultBranch,
+  getCurrentBranch,
+  resolveDiffBase,
   monolithRequest,
   monolithService
 };

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

@@ -2,22 +2,25 @@
 import { createRequire as __createRequire } from 'node:module';
 const require = __createRequire(import.meta.url);
 import {
+  ENGINE_ENV,
   getOriginDefaultBranch,
   monolithRequest,
   runGitCommand
-} from "./chunk-WJNNX4X7.js";
+} from "./chunk-TKAWFIXX.js";
 import {
   extractCommandProtectionCommandText,
   findCommandProtectionGitLookups,
   findGitCommitSignals,
   findPrMergeSignals,
+  findScoutRepoWriteSignals,
   parseCommandProtectionRequest
-} from "./chunk-UAMATZ5S.js";
+} from "./chunk-QBNBBWCE.js";
 
 // src/services/command-protection-service.ts
 import { readFile, stat } from "fs/promises";
 var DEFAULT_COMMAND_PROTECTION_BLOCK_MESSAGE = "Blocked by Replicas command protection.";
 var MAX_COMMIT_MESSAGE_FILE_BYTES = 64 * 1024;
+var SCOUT_REPO_WRITE_BLOCK_MESSAGE = "Scout never clones, commits, pushes, or opens pull requests. Spawn a workspace on an environment that has the repository, or relay this to the thread's workspace.";
 async function resolveGitContext({ repoDirs, messageFiles }) {
   if (repoDirs.length === 0 && messageFiles.length === 0) return void 0;
   const git = (dir, args) => runGitCommand(args, dir).then((output) => output || null, () => null);
@@ -56,6 +59,10 @@ function failClosed(reason, matchedSignals) {
 }
 async function evaluateCommandProtection(request, signal) {
   const parsed = parseCommandProtectionRequest(request);
+  const scoutSignals = ENGINE_ENV.REPLICAS_SCOUT ? findScoutRepoWriteSignals(parsed) : [];
+  if (scoutSignals.length > 0) {
+    return { allowed: false, enabled: true, reason: SCOUT_REPO_WRITE_BLOCK_MESSAGE, matchedSignals: scoutSignals };
+  }
   const gitContext = await resolveGitContext(findCommandProtectionGitLookups(parsed));
   const matchedSignals = [...findGitCommitSignals(parsed), ...findPrMergeSignals(parsed, gitContext).signals];
   if (matchedSignals.length === 0) {

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-VZXRPXJI.js";
+import "./chunk-TKAWFIXX.js";
+import "./chunk-IHC4JY3Q.js";
 import {
   isRecord
 } from "./chunk-UZSNFLDQ.js";
-import "./chunk-UAMATZ5S.js";
+import "./chunk-QBNBBWCE.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-NG63G5VA.js";
 import {
   AppServerProcess,
   buildCodexAgentEnv
-} from "./chunk-4GOMPL6V.js";
-import "./chunk-II7A63N3.js";
+} from "./chunk-AS77RMSN.js";
+import "./chunk-IHC4JY3Q.js";
 import {
   AGENT,
   OPENCODE_GO_PROVIDER,
@@ -29,7 +29,7 @@ import {
   headlessAgentUsagePath,
   isRecord,
   withTimeout
-} from "./chunk-UAMATZ5S.js";
+} from "./chunk-QBNBBWCE.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-VZXRPXJI.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-NG63G5VA.js";
 import {
   publishedPullRequestUrls
-} from "./chunk-BHIBP2BR.js";
+} from "./chunk-DDUTPOJ3.js";
 import {
   ACCOUNT_RATE_LIMITS_READ_METHOD,
   AsyncLock,
@@ -143,7 +143,7 @@ import {
   timestampFromSeconds,
   upsertCredentialFileLines,
   writeSecureCredentialFile
-} from "./chunk-EVZUJPQY.js";
+} from "./chunk-SYZXJP4X.js";
 import {
   ENGINE_ENV,
   monolithRequest,
@@ -153,15 +153,15 @@ import {
   resolveDiffBase,
   setAgentCredentialSnapshot,
   setLinearSessionId
-} from "./chunk-WJNNX4X7.js";
+} from "./chunk-TKAWFIXX.js";
 import {
   getCodexModelProvider
-} from "./chunk-4GOMPL6V.js";
+} from "./chunk-AS77RMSN.js";
 import {
   SUBPROCESS_MAX_BUFFER,
   execAsync,
   execFileAsync
-} from "./chunk-II7A63N3.js";
+} from "./chunk-IHC4JY3Q.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-QBNBBWCE.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-DDUTPOJ3.js";
 import {
   isRecord
 } from "./chunk-UZSNFLDQ.js";
 import {
   shouldRefreshPullRequests
-} from "./chunk-UAMATZ5S.js";
+} from "./chunk-QBNBBWCE.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-QBNBBWCE.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.1305",
   "description": "Lightweight API server for Replicas workspaces",
   "type": "module",
   "main": "dist/src/index.js",