replicas-engine 0.1.816 → 0.1.817

package/dist/src/{asp-host-GPNVHNDJ.js → asp-host-JUVXZCRV.js}

@@ -5,11 +5,11 @@ import {
   getCodexAspHost,
   restartCodexAspHost,
   restartCodexAspHostIfRunning
-} from "./chunk-QIDTIQQU.js";
-import "./chunk-3XXPWKPE.js";
-import "./chunk-T7RJYRCH.js";
+} from "./chunk-FN67CYNX.js";
+import "./chunk-JAITEGC4.js";
+import "./chunk-EOYBI3PV.js";
 import "./chunk-UZSNFLDQ.js";
-import "./chunk-JTAIM2QE.js";
+import "./chunk-OCQQ6AO3.js";
 import "./chunk-VEQXQN22.js";
 export {
   getCodexAspHost,

package/dist/src/{chunk-I3CLB5FS.js → chunk-6FLPUBVF.js}

@@ -3,12 +3,12 @@ import { createRequire as __createRequire } from 'node:module';
 const require = __createRequire(import.meta.url);
 import {
   monolithRequest
-} from "./chunk-3XXPWKPE.js";
+} from "./chunk-JAITEGC4.js";
 import {
   extractCommandProtectionCommandText,
   findGitCommitSignals,
   findPrMergeSignals
-} from "./chunk-JTAIM2QE.js";
+} from "./chunk-OCQQ6AO3.js";
 
 // src/services/command-protection-service.ts
 var DEFAULT_COMMAND_PROTECTION_BLOCK_MESSAGE = "Blocked by Replicas command protection.";

package/dist/src/{chunk-MEPQJE5J.js → chunk-C52ENUG3.js}

@@ -4,7 +4,7 @@ const require = __createRequire(import.meta.url);
 import {
   findCodeHostPullRequestUrls,
   mayCreatePullRequest
-} from "./chunk-JTAIM2QE.js";
+} from "./chunk-OCQQ6AO3.js";
 
 // src/services/post-tool-pr-notifier.ts
 async function notifyPostToolUse(toolName, toolInput, toolResult) {

package/dist/src/{chunk-T7RJYRCH.js → chunk-EOYBI3PV.js}

@@ -4,7 +4,7 @@ const require = __createRequire(import.meta.url);
 import {
   HOOK_EXEC_MAX_BUFFER_BYTES,
   isVersionBelow
-} from "./chunk-JTAIM2QE.js";
+} from "./chunk-OCQQ6AO3.js";
 
 // src/utils/codex-agent-env.ts
 function buildCodexAgentEnv(source = process.env) {
@@ -241,7 +241,7 @@ var DEFAULT_CODEX_ARGS = [
 var MIN_CODEX_CLI_VERSION = "0.153.3";
 var CODEX_UPGRADE_TIMEOUT_MS = 12e4;
 var codexCliVersionEnsured = null;
-var ENGINE_PACKAGE_VERSION = "0.1.816";
+var ENGINE_PACKAGE_VERSION = "0.1.817";
 var INITIALIZE_METHOD = "initialize";
 var INITIALIZED_NOTIFICATION = "initialized";
 var ACCOUNT_LOGIN_START_METHOD = "account/login/start";

package/dist/src/{chunk-QIDTIQQU.js → chunk-FN67CYNX.js}

@@ -5,18 +5,18 @@ import {
   ENGINE_ENV,
   monolithRequest,
   setAgentCredentialSnapshot
-} from "./chunk-3XXPWKPE.js";
+} from "./chunk-JAITEGC4.js";
 import {
   AppServerProcess,
   buildCodexAgentEnv
-} from "./chunk-T7RJYRCH.js";
+} from "./chunk-EOYBI3PV.js";
 import {
   CODEX_AUTH_ENV_KEYS,
   CODEX_AUTH_ENV_KEYS_BY_METHOD,
   codexAuthEnvFromResponse,
   createErrorResult,
   createSuccessResult
-} from "./chunk-JTAIM2QE.js";
+} from "./chunk-OCQQ6AO3.js";
 
 // src/managers/codex-token-manager.ts
 import { promises as fs } from "fs";
@@ -232,7 +232,7 @@ var CodexTokenManager = class extends BaseRefreshManager {
     const data = await response.json();
     await this.applyCredentialsResponse(data);
     if (restartOnChange && CODEX_AUTH_ENV_KEYS.some((key, index) => process.env[key] !== previousEnv[index])) {
-      const { restartCodexAspHostIfRunning: restartCodexAspHostIfRunning2 } = await import("./asp-host-GPNVHNDJ.js");
+      const { restartCodexAspHostIfRunning: restartCodexAspHostIfRunning2 } = await import("./asp-host-JUVXZCRV.js");
       await restartCodexAspHostIfRunning2();
     }
     if (data.scope) {

package/dist/src/{chunk-3XXPWKPE.js → chunk-JAITEGC4.js}

@@ -15,7 +15,7 @@ import {
   isValidRelayBaseProvider,
   parsePosixEnvFile,
   readReplicasRuntimeEnv
-} from "./chunk-JTAIM2QE.js";
+} from "./chunk-OCQQ6AO3.js";
 
 // src/engine-env.ts
 import { readFileSync as readFileSync2 } from "fs";

package/dist/src/{chunk-JTAIM2QE.js → chunk-OCQQ6AO3.js}

@@ -817,6 +817,10 @@ var createChatRequestSchema = z3.object({
 var spawnRelaySubagentRequestSchema = z3.object({
   provider: z3.enum(VALID_AGENT_PROVIDERS),
   prompt: z3.string().min(1),
+  forkTurns: z3.string().regex(/^(all|none|[1-9]\d*)$/).refine(
+    (value) => value === "all" || value === "none" || Number.isSafeInteger(Number(value)),
+    "Expected all, none, or a positive safe integer string"
+  ).default("all"),
   model: z3.string().min(1).optional(),
   thinkingLevel: z3.enum(VALID_THINKING_LEVELS).optional(),
   title: z3.string().min(1).optional(),
@@ -7413,15 +7417,15 @@ function formatChatForkHandoffMessage(handoff) {
   const reason = describeChatForkReason(handoff.reason, handoff.source.provider);
   const why = handoff.trigger === "auto" ? `until ${reason ?? "it stopped"}, so Replicas moved the conversation to you automatically` : "until the user forked it to you";
   const body = [
-    `# Continuing a ${sourceName} chat`,
+    handoff.subagent ? "# Delegated task context" : `# Continuing a ${sourceName} chat`,
     "",
-    `You are picking up the chat "${handoff.source.title}" in this same workspace. It was running on ${sourceName} ${why}. Everything the previous agent changed is already on disk: the workspace files and git state are authoritative.`,
+    handoff.subagent ? `You are a subagent of the chat "${handoff.source.title}" in this same workspace. The inherited transcript is background for your assigned task below. Follow that task and report your result to the parent; do not take over the parent's entire request. Workspace files and git state are shared and authoritative.` : `You are picking up the chat "${handoff.source.title}" in this same workspace. It was running on ${sourceName} ${why}. Everything the previous agent changed is already on disk: the workspace files and git state are authoritative.`,
     "",
     "## Transcript",
     "",
     `- Sanitized transcript: \`${handoff.transcriptPath}\` (read or grep it for anything not in the excerpt below)`,
-    `- Raw event log: \`${handoff.rawHistoryPath}\``,
-    ...handoff.sourceTruncated ? ["- The chat was too large to sanitize in full; the sanitized file holds only its most recent part. Grep the raw event log for anything older."] : [],
+    ...handoff.rawHistoryPath ? [`- Raw event log: \`${handoff.rawHistoryPath}\``] : [],
+    ...handoff.sourceTruncated ? [`- The chat was too large to sanitize in full; the sanitized file holds only its most recent part.${handoff.rawHistoryPath ? " Grep the raw event log for anything older." : ""}`] : [],
     "",
     "## Recent turns",
     "",

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

@@ -3,12 +3,12 @@ import { createRequire as __createRequire } from 'node:module';
 const require = __createRequire(import.meta.url);
 import {
   evaluateCommandProtection
-} from "./chunk-I3CLB5FS.js";
-import "./chunk-3XXPWKPE.js";
+} from "./chunk-6FLPUBVF.js";
+import "./chunk-JAITEGC4.js";
 import {
   isRecord
 } from "./chunk-UZSNFLDQ.js";
-import "./chunk-JTAIM2QE.js";
+import "./chunk-OCQQ6AO3.js";
 import "./chunk-VEQXQN22.js";
 
 // src/command-protection-hook.ts

package/dist/src/deepseek-command-protection-plugin.js

@@ -3,13 +3,13 @@ import { createRequire as __createRequire } from 'node:module';
 const require = __createRequire(import.meta.url);
 import {
   evaluateCommandProtection
-} from "./chunk-I3CLB5FS.js";
+} from "./chunk-6FLPUBVF.js";
 import {
   notifyPostToolUse
-} from "./chunk-MEPQJE5J.js";
-import "./chunk-3XXPWKPE.js";
+} from "./chunk-C52ENUG3.js";
+import "./chunk-JAITEGC4.js";
 import "./chunk-UZSNFLDQ.js";
-import "./chunk-JTAIM2QE.js";
+import "./chunk-OCQQ6AO3.js";
 import "./chunk-VEQXQN22.js";
 
 // src/deepseek-command-protection-plugin.ts

package/dist/src/headless-agent.js

@@ -8,12 +8,12 @@ import {
 import {
   AppServerProcess,
   buildCodexAgentEnv
-} from "./chunk-T7RJYRCH.js";
+} from "./chunk-EOYBI3PV.js";
 import {
   AGENT,
   getMemoryOutputSafetyViolation,
   headlessAgentRequestSchema
-} from "./chunk-JTAIM2QE.js";
+} from "./chunk-OCQQ6AO3.js";
 import "./chunk-VEQXQN22.js";
 
 // src/headless-agent.ts

package/dist/src/index.js

@@ -91,7 +91,7 @@ import {
   evaluateCommandProtection,
   extractToolCommand,
   reportCommandProtectionBlock
-} from "./chunk-I3CLB5FS.js";
+} from "./chunk-6FLPUBVF.js";
 import {
   ACCOUNT_RATE_LIMITS_UPDATED_METHOD,
   AGENT_MESSAGE_DELTA_METHOD,
@@ -131,20 +131,20 @@ import {
   recordCredentialFallback,
   recordExhaustedCredential,
   restartCodexAspHost
-} from "./chunk-QIDTIQQU.js";
+} from "./chunk-FN67CYNX.js";
 import {
   ENGINE_ENV,
   IS_WARMING_MODE,
   monolithRequest,
   monolithService,
   setAgentCredentialSnapshot
-} from "./chunk-3XXPWKPE.js";
+} from "./chunk-JAITEGC4.js";
 import {
   AspClient,
   SUBPROCESS_MAX_BUFFER,
   execAsync,
   execFileAsync
-} from "./chunk-T7RJYRCH.js";
+} from "./chunk-EOYBI3PV.js";
 import {
   isRecord as isRecord2
 } from "./chunk-UZSNFLDQ.js";
@@ -350,7 +350,7 @@ import {
   spawnRelaySubagentRequestSchema,
   stripAgentDiagnosticErrors,
   withTimeout
-} from "./chunk-JTAIM2QE.js";
+} from "./chunk-OCQQ6AO3.js";
 import {
   __commonJS,
   __export,
@@ -14977,6 +14977,7 @@ var CodexAspManager = class extends CodingAgentManager {
   }
   async getHistory(page2 = {}) {
     await this.initialized;
+    this.transcriptUpdateCoalescer.flushPending();
     await this.historyFile?.flush();
     const transcript = await this.ensureTranscriptHistory();
     const events = await this.historyFile?.loadEventsPage(page2) ?? { events: [], beforeCursor: null };
@@ -59789,7 +59790,15 @@ Go straight to the point. Lead with outcomes and decisions, keep updates concise
 
 Your primary constraint is context. Work directly when the task is small, tightly coupled to context you already hold, or cheaper to complete than explain. Delegate independent work that would consume substantial context, including broad investigation, multi-file implementation, iterative debugging, test-and-fix loops, and unbiased review or verification. Do not delegate trivial work or work whose full context would cost more to transfer than doing it yourself.
 
-Use the \`${RELAY_MCP_SERVER_NAME}\` MCP server exclusively for delegation; never use terminal commands or the base harness's native agent-spawning, delegation, or collaboration tools. It exposes \`get_providers\`, \`spawn_agent\`, \`message_agent\`, and \`delete_agent\`; your harness may show them with an MCP server prefix. In Pi, call them through the \`mcp\` gateway for the \`${RELAY_MCP_SERVER_NAME}\` server if direct tools are not yet visible. Check \`get_providers\` before the first delegation instead of guessing. Child agents start with no conversation context, so give complete prompts with the relevant requirements, paths, constraints, and definition of done. The default timeout is 10 minutes; increase it only when the task reasonably needs longer.
+Use the \`${RELAY_MCP_SERVER_NAME}\` MCP server exclusively for delegation; never use terminal commands or the base harness's native agent-spawning, delegation, or collaboration tools. It exposes \`get_providers\`, \`spawn_agent\`, \`message_agent\`, and \`delete_agent\`; your harness may show them with an MCP server prefix. In Pi, call them through the \`mcp\` gateway for the \`${RELAY_MCP_SERVER_NAME}\` server if direct tools are not yet visible. Check \`get_providers\` before the first delegation instead of guessing. The default timeout is 10 minutes; increase it only when the task reasonably needs longer.
+
+Choose how much parent context each child inherits with \`spawn_agent.fork_turns\`:
+
+- \`"all"\` (default): inherit the conversation as an extension of yourself when the task depends on prior decisions and constraints.
+- \`"none"\`: start with only the task prompt to reduce input tokens or get an independent assessment without your prior reasoning. Include all necessary requirements, paths, constraints, and evidence in the prompt; the child cannot infer omitted context.
+- A positive integer string such as \`"3"\`: inherit only the latest N user-led turns when recent context is enough. A turn includes a user message and the agent activity that follows it, including the current unfinished turn.
+
+Give every child a concrete task, clear scope, and definition of done, even when it inherits the conversation. The child should use inherited history as background and focus on its assigned task.
 
 Run truly independent child agents concurrently. Because child agents share the workspace, run modifying work sequentially unless file ownership cannot overlap. Keep dependent work sequential when one result defines another task's contract, such as schema before queries, API before its client, or implementation before its focused verification. Review child results, follow up when they are incomplete, and verify the integrated outcome yourself. Do not delete child chats unless the user asks.
 
@@ -61361,11 +61370,16 @@ function tailBlocks(blocks, maxChars) {
 async function buildForkHandoff(input) {
   const rawHistoryPath = join35(HISTORY_DIR_BY_PROVIDER[input.sourceProvider], `${input.sourceChatId}.jsonl`);
   const { content, truncated: sourceTruncated } = await readHistoryTail(rawHistoryPath, MAX_SANITIZED_SOURCE_BYTES);
-  const blocks = canonicalizeChatTranscriptBlocks(content, input.executionProvider, input.senders);
+  let blocks = canonicalizeChatTranscriptBlocks(content, input.executionProvider, input.senders);
+  if (input.turnLimit !== void 0) {
+    let turns = 0;
+    const start = blocks.findLastIndex((block) => block.startsWith("## User") && ++turns === input.turnLimit);
+    blocks = blocks.slice(Math.max(0, start));
+  }
   const forkDir = join35(FORKS_DIR, input.targetChatId);
   await mkdir20(forkDir, { recursive: true });
   const transcriptPath = join35(forkDir, "source-transcript.md");
-  const header = sourceTruncated ? `_This file covers only the most recent ${MAX_SANITIZED_SOURCE_BYTES / 1024 / 1024} MB of the source chat. The complete raw event log is at ${rawHistoryPath}; grep it for anything earlier._
+  const header = sourceTruncated ? `_This file was generated from only the most recent ${MAX_SANITIZED_SOURCE_BYTES / 1024 / 1024} MB of the source chat.${input.turnLimit === void 0 ? ` The complete raw event log is at ${rawHistoryPath}; grep it for anything earlier.` : ""}_
 
 ` : "";
   await writeFile11(transcriptPath, `${header}${blocks.join("\n\n")}
@@ -61377,7 +61391,7 @@ async function buildForkHandoff(input) {
     sourceTruncated,
     resumeRequest: unansweredRequest(blocks),
     transcriptPath,
-    rawHistoryPath
+    rawHistoryPath: input.turnLimit === void 0 ? rawHistoryPath : void 0
   };
 }
 
@@ -61656,8 +61670,19 @@ var ChatService = class {
       parentChatId
     });
     try {
+      let message = request.prompt;
+      if (request.forkTurns !== "none") {
+        const parent = this.requireChat(parentChatId).persisted;
+        message = await this.createForkHandoffMessage(chat.id, {
+          source: { chatId: parentChatId, provider: parent.provider, title: parent.title },
+          trigger: "manual",
+          subagent: true,
+          turnLimit: request.forkTurns && request.forkTurns !== "all" ? Number(request.forkTurns) : void 0,
+          message: request.prompt
+        });
+      }
       await this.sendMessage(chat.id, {
-        message: request.prompt,
+        message,
         ...request.model ? { model: request.model } : {},
         ...request.thinkingLevel ? { thinkingLevel: request.thinkingLevel } : {}
       });
@@ -62132,33 +62157,34 @@ var ChatService = class {
     });
     return target;
   }
+  async createForkHandoffMessage(targetChatId, options) {
+    const source = this.requireChat(options.source.chatId);
+    await source.provider.getHistory({ limit: 1 });
+    const handoff = await buildForkHandoff({
+      sourceChatId: options.source.chatId,
+      sourceProvider: options.source.provider,
+      executionProvider: getChatExecutionProvider(source.persisted),
+      targetChatId,
+      senders: await this.readSenders(options.source.chatId),
+      turnLimit: options.turnLimit
+    });
+    return formatChatForkHandoffMessage({ ...handoff, ...options });
+  }
   async runFork(targetId, request) {
     const target = this.chats.get(targetId);
     const fork = target?.persisted.fork;
     if (!target || !fork) return;
     try {
       if (!isAgentAvailable(getChatExecutionProvider(target.persisted))) throw new ChatProviderUnavailableError(request.provider);
-      const handoff = await buildForkHandoff({
-        sourceChatId: fork.source.chatId,
-        sourceProvider: fork.source.provider,
-        executionProvider: getChatExecutionProvider(this.requireChat(fork.source.chatId).persisted),
-        targetChatId: targetId,
-        senders: await this.readSenders(fork.source.chatId)
+      const message = await this.createForkHandoffMessage(targetId, {
+        source: fork.source,
+        trigger: fork.trigger,
+        reason: fork.reason,
+        message: request.message
       });
       if (target.persisted.deletedAt) return;
       await this.sendMessage(targetId, {
-        message: formatChatForkHandoffMessage({
-          source: fork.source,
-          trigger: fork.trigger,
-          ...fork.reason ? { reason: fork.reason } : {},
-          excerpt: handoff.excerpt,
-          excerptTruncated: handoff.excerptTruncated,
-          sourceTruncated: handoff.sourceTruncated,
-          transcriptPath: handoff.transcriptPath,
-          rawHistoryPath: handoff.rawHistoryPath,
-          resumeRequest: handoff.resumeRequest,
-          message: request.message
-        }),
+        message,
         model: request.model,
         thinkingLevel: request.thinkingLevel,
         enableInteractiveTools: request.enableInteractiveTools,

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

@@ -3,11 +3,11 @@ import { createRequire as __createRequire } from 'node:module';
 const require = __createRequire(import.meta.url);
 import {
   notifyPostToolUse
-} from "./chunk-MEPQJE5J.js";
+} from "./chunk-C52ENUG3.js";
 import {
   isRecord
 } from "./chunk-UZSNFLDQ.js";
-import "./chunk-JTAIM2QE.js";
+import "./chunk-OCQQ6AO3.js";
 import "./chunk-VEQXQN22.js";
 
 // src/post-tool-pr-hook.ts

package/dist/src/relay-mcp.js

@@ -7,7 +7,7 @@ import {
 import {
   messageRelaySubagentRequestSchema,
   spawnRelaySubagentRequestSchema
-} from "./chunk-JTAIM2QE.js";
+} from "./chunk-OCQQ6AO3.js";
 import "./chunk-VEQXQN22.js";
 
 // src/relay-mcp.ts
@@ -46,21 +46,23 @@ server.registerTool("get_providers", {
   content: [{ type: "text", text: await request(`/chats/${parentChatId}/subagents`, "GET") }]
 }));
 server.registerTool("spawn_agent", {
-  description: "Spawn a child agent with a fresh context, wait for it to finish, and return its chat ID and final response.",
+  description: "Spawn a child agent with all, none, or the latest N turns of parent context, wait for it to finish, and return its chat ID and final response.",
   inputSchema: {
     provider: spawnRelaySubagentRequestSchema.shape.provider.describe("Provider returned by get_providers."),
-    prompt: spawnRelaySubagentRequestSchema.shape.prompt.describe("Complete task instructions; the child has no parent conversation context."),
+    prompt: spawnRelaySubagentRequestSchema.shape.prompt.describe("The child\u2019s assigned task, scope, and expected result. Include all necessary context when fork_turns is none."),
+    fork_turns: spawnRelaySubagentRequestSchema.shape.forkTurns.describe("Parent context to inherit: all (default), none, or a positive integer string such as 3 for the latest 3 user-led turns, including the current turn."),
     model: spawnRelaySubagentRequestSchema.shape.model,
     thinking_level: spawnRelaySubagentRequestSchema.shape.thinkingLevel,
     title: spawnRelaySubagentRequestSchema.shape.title,
     timeout_minutes: spawnRelaySubagentRequestSchema.shape.timeoutMinutes
   }
-}, async ({ provider, prompt, model, thinking_level, title, timeout_minutes }) => ({
+}, async ({ provider, prompt, fork_turns, model, thinking_level, title, timeout_minutes }) => ({
   content: [{
     type: "text",
     text: await request(`/chats/${parentChatId}/subagents`, "POST", {
       provider,
       prompt,
+      forkTurns: fork_turns,
       ...model ? { model } : {},
       ...thinking_level ? { thinkingLevel: thinking_level } : {},
       ...title ? { title } : {},

package/package.json

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