replicas-engine 0.1.733 → 0.1.734

package/dist/src/index.js

@@ -8,7 +8,7 @@ import {
   monolithService,
   reportCommandProtectionBlock,
   setAgentCredentialSnapshot
-} from "./chunk-5U46EQRM.js";
+} from "./chunk-BRXEUTMC.js";
 import {
   ACCOUNT_RATE_LIMITS_UPDATED_METHOD,
   AGENT_MESSAGE_DELTA_METHOD,
@@ -36,7 +36,7 @@ import {
   execFileAsync,
   putPresignedFile,
   recoverCompletedTurn
-} from "./chunk-2ZP6PIHD.js";
+} from "./chunk-35NHHD6W.js";
 import {
   isRecord as isRecord2
 } from "./chunk-2RB7SIP3.js";
@@ -44,6 +44,7 @@ import {
   ACCEPTED_USER_MESSAGE_SOURCE,
   AGENT,
   AGENT_MODELS,
+  AGENT_QUOTA_EXHAUSTED_EVENT_TYPE,
   AI_GATEWAY_BASE_URL,
   ASTER_BASE_URL,
   ASTER_MODELS,
@@ -115,6 +116,7 @@ import {
   VALID_AGENT_PROVIDERS,
   VALID_RELAY_SUBAGENT_PROVIDERS,
   VALID_THINKING_LEVELS,
+  agentQuotaExhaustedPayloadSchema,
   applyCodexAspTranscriptDelta,
   areSameUserMessageEvents,
   areUserMessagesWithinMatchWindow,
@@ -124,6 +126,7 @@ import {
   buildHookOutputPreview,
   buildOutputPreview,
   canUseClaudeFastMode,
+  canonicalizeChatTranscriptBlocks,
   chatHistoryPageParamsFromQuery,
   clampTokensToWindow,
   clampWarmHookTimeoutMs,
@@ -132,6 +135,7 @@ import {
   codexAuthEnvFromResponse,
   codexReasoningEffortForThinkingLevel,
   coerceBackgroundTaskPayload,
+  coerceChatForkInfo,
   coerceChatGoalPayload,
   coerceClaudeResultPayload,
   createAcceptedUserMessageEvent,
@@ -143,12 +147,15 @@ import {
   createSuccessResult,
   createUuidFromHex,
   decodePathSegments,
+  defaultForkChatTitle,
   detectAgentQuotaLimit,
   detectLanguageByPath,
   extractErrorText,
   extractToolResultText,
   fetchAiGatewayModels,
   fetchModelsDevCatalog,
+  forkChatRequestSchema,
+  formatChatForkHandoffMessage,
   getChatHistoryPageSenders,
   getChatHistoryPageWindow,
   getChatTranscriptHistorySize,
@@ -191,6 +198,7 @@ import {
   isTransientErrorText,
   isValidAgentProvider,
   isValidEngineLogSessionId,
+  lastUserBlockText,
   mayCreatePullRequest,
   mergeSlashCommands,
   normalizeAutoCompactThreshold,
@@ -220,7 +228,7 @@ import {
   shellQuotePosix,
   stripAgentDiagnosticErrors,
   withTimeout
-} from "./chunk-YBI3HWHT.js";
+} from "./chunk-5K3MABJT.js";
 
 // src/index.ts
 import { serve } from "@hono/node-server";
@@ -1707,13 +1715,18 @@ var engineLogger = new EngineLogger();
 
 // src/services/replicas-config-service.ts
 import { readFile as readFile6, appendFile, writeFile as writeFile4, mkdir as mkdir6 } from "fs/promises";
-import { existsSync as existsSync3 } from "fs";
-import { join as join9 } from "path";
-import { homedir as homedir6 } from "os";
+import { existsSync as existsSync4 } from "fs";
+import { join as join10 } from "path";
+import { homedir as homedir7 } from "os";
 import { spawn as spawn2 } from "child_process";
 
 // src/services/environment-details-service.ts
 import { mkdir as mkdir4, readFile as readFile4 } from "fs/promises";
+import { existsSync as existsSync3 } from "fs";
+import { homedir as homedir5 } from "os";
+import { join as join8 } from "path";
+
+// src/managers/agent-auth-detection.ts
 import { existsSync as existsSync2 } from "fs";
 import { homedir as homedir4 } from "os";
 import { join as join7 } from "path";
@@ -1746,12 +1759,8 @@ function detectCodexAuthMethod() {
   return ENGINE_ENV.REPLICAS_CODEX_AUTH_METHOD ?? (ENGINE_ENV.OPENAI_API_KEY ? "api_key" : "none");
 }
 
-// src/services/environment-details-service.ts
-var REPLICAS_DIR = join7(homedir4(), ".replicas");
-var DETAILS_FILE = join7(REPLICAS_DIR, "environment-details.json");
+// src/managers/agent-auth-detection.ts
 var CLAUDE_CREDENTIALS_PATH = join7(homedir4(), ".claude", ".credentials.json");
-var GH_HOSTS_PATH = join7(homedir4(), ".config", "gh", "hosts.yml");
-var GIT_CREDENTIALS_PATH = join7(homedir4(), ".git-credentials");
 function detectClaudeAuthMethod() {
   if (existsSync2(CLAUDE_CREDENTIALS_PATH)) {
     return "oauth";
@@ -1767,21 +1776,38 @@ function detectClaudeAuthMethod() {
   }
   return "none";
 }
-function detectCursorAuthMethod() {
-  return ENGINE_ENV.CURSOR_API_KEY ? "api_key" : "none";
-}
-function detectOpencodeAuthMethod() {
-  return existsSync2(OPENCODE_AUTH_PATH) ? "api_key" : "none";
-}
-function detectDeepseekAuthMethod() {
-  return getDeepseekApiKey() ? "api_key" : "none";
-}
-function detectFxAuthMethod() {
-  return ENGINE_ENV.AI_GATEWAY_API_KEY ? "api_key" : "none";
+function detectAgentAuthMethod(provider) {
+  switch (provider) {
+    // Relay orchestrates subagents but authenticates as Claude.
+    case AGENT.CLAUDE:
+    case AGENT.RELAY:
+      return detectClaudeAuthMethod();
+    case AGENT.CODEX:
+      return detectCodexAuthMethod();
+    case AGENT.CURSOR:
+      return ENGINE_ENV.CURSOR_API_KEY ? "api_key" : "none";
+    case AGENT.DEEPSEEK:
+      return getDeepseekApiKey() ? "api_key" : "none";
+    case AGENT.FX:
+    case AGENT.KIMI:
+      return ENGINE_ENV.AI_GATEWAY_API_KEY ? "api_key" : "none";
+    case AGENT.MUSE:
+      return existsSync2(MUSE_AUTH_PATH) ? "oauth" : "none";
+    case AGENT.OPENCODE:
+      return existsSync2(OPENCODE_AUTH_PATH) ? "api_key" : "none";
+    case AGENT.PI:
+      return existsSync2(PI_AUTH_PATH) ? "api_key" : "none";
+  }
 }
-function detectPiAuthMethod() {
-  return existsSync2(PI_AUTH_PATH) ? "api_key" : "none";
+function isAgentAvailable(provider) {
+  return detectAgentAuthMethod(provider) !== "none";
 }
+
+// src/services/environment-details-service.ts
+var REPLICAS_DIR = join8(homedir5(), ".replicas");
+var DETAILS_FILE = join8(REPLICAS_DIR, "environment-details.json");
+var GH_HOSTS_PATH = join8(homedir5(), ".config", "gh", "hosts.yml");
+var GIT_CREDENTIALS_PATH = join8(homedir5(), ".git-credentials");
 async function detectGitIdentityConfigured() {
   try {
     const { stdout } = await execFileAsync("git", ["config", "--global", "user.name"]);
@@ -1848,7 +1874,7 @@ function createDefaultDetails() {
 }
 async function readDetails() {
   try {
-    if (!existsSync2(DETAILS_FILE)) {
+    if (!existsSync3(DETAILS_FILE)) {
       return createDefaultDetails();
     }
     const raw = await readFile4(DETAILS_FILE, "utf-8");
@@ -1877,18 +1903,18 @@ var EnvironmentDetailsService = class {
     details.supportsClaudeMidTurnSteering = true;
     details.supportsGoalUpdates = true;
     details.supportsQueuedMessageEditing = true;
-    details.claudeAuthMethod = detectClaudeAuthMethod();
-    details.codexAuthMethod = detectCodexAuthMethod();
-    details.cursorAuthMethod = detectCursorAuthMethod();
-    details.deepseekAuthMethod = detectDeepseekAuthMethod();
-    details.fxAuthMethod = detectFxAuthMethod();
-    details.kimiAuthMethod = detectFxAuthMethod();
-    details.museAuthMethod = existsSync2(MUSE_AUTH_PATH) ? "oauth" : "none";
-    details.opencodeAuthMethod = detectOpencodeAuthMethod();
-    details.piAuthMethod = detectPiAuthMethod();
+    details.claudeAuthMethod = detectAgentAuthMethod(AGENT.CLAUDE);
+    details.codexAuthMethod = detectAgentAuthMethod(AGENT.CODEX);
+    details.cursorAuthMethod = detectAgentAuthMethod(AGENT.CURSOR);
+    details.deepseekAuthMethod = detectAgentAuthMethod(AGENT.DEEPSEEK);
+    details.fxAuthMethod = detectAgentAuthMethod(AGENT.FX);
+    details.kimiAuthMethod = detectAgentAuthMethod(AGENT.KIMI);
+    details.museAuthMethod = detectAgentAuthMethod(AGENT.MUSE);
+    details.opencodeAuthMethod = detectAgentAuthMethod(AGENT.OPENCODE);
+    details.piAuthMethod = detectAgentAuthMethod(AGENT.PI);
     details.credentialFallbacks = listCredentialFallbacks();
     details.gitIdentityConfigured = gitIdentityConfigured;
-    const ghConfigured = existsSync2(GH_HOSTS_PATH);
+    const ghConfigured = existsSync3(GH_HOSTS_PATH);
     details.githubAccessConfigured = ghConfigured;
     details.githubCredentialsConfigured = ghConfigured;
     details.gitlabAccessConfigured = gitlabAccessConfigured;
@@ -1965,8 +1991,8 @@ var environmentDetailsService = new EnvironmentDetailsService();
 
 // src/services/start-hook-logs-service.ts
 import { mkdir as mkdir5, readFile as readFile5, writeFile as writeFile3, readdir as readdir2 } from "fs/promises";
-import { homedir as homedir5 } from "os";
-import { join as join8 } from "path";
+import { homedir as homedir6 } from "os";
+import { join as join9 } from "path";
 
 // src/services/hook-log-files.ts
 import { createHash } from "crypto";
@@ -1978,7 +2004,7 @@ function repoHookLogFilename(repoName) {
 }
 
 // src/services/start-hook-logs-service.ts
-var LOGS_DIR = join8(homedir5(), ".replicas", "start-hook-logs");
+var LOGS_DIR = join9(homedir6(), ".replicas", "start-hook-logs");
 function withPreview(stored) {
   const preview = buildHookOutputPreview(stored.output);
   return { ...stored, ...preview };
@@ -2016,7 +2042,7 @@ var StartHookLogsService = class {
     await this.ensureDir();
     const log = { hookType, hookName, repoName: hookName, ...entry };
     const filename = hookType === "environment" ? ENVIRONMENT_HOOK_LOG_FILENAME : repoHookLogFilename(hookName);
-    await writeFile3(join8(LOGS_DIR, filename), `${JSON.stringify(log, null, 2)}
+    await writeFile3(join9(LOGS_DIR, filename), `${JSON.stringify(log, null, 2)}
 `, "utf-8");
   }
   async saveEnvironmentLog(entry) {
@@ -2041,7 +2067,7 @@ var StartHookLogsService = class {
         continue;
       }
       try {
-        const raw = await readFile5(join8(LOGS_DIR, file), "utf-8");
+        const raw = await readFile5(join9(LOGS_DIR, file), "utf-8");
         const stored = normalizeStored(JSON.parse(raw));
         if (stored) {
           logs.push(withPreview(stored));
@@ -2060,7 +2086,7 @@ var StartHookLogsService = class {
   async getFullOutput(hookType, hookName) {
     const filename = hookType === "environment" ? ENVIRONMENT_HOOK_LOG_FILENAME : repoHookLogFilename(hookName);
     try {
-      const raw = await readFile5(join8(LOGS_DIR, filename), "utf-8");
+      const raw = await readFile5(join9(LOGS_DIR, filename), "utf-8");
       const stored = normalizeStored(JSON.parse(raw));
       if (!stored || stored.hookType !== hookType || stored.hookName !== hookName) {
         return null;
@@ -2077,7 +2103,7 @@ var StartHookLogsService = class {
 var startHookLogsService = new StartHookLogsService();
 
 // src/services/replicas-config-service.ts
-var START_HOOKS_LOG = join9(homedir6(), ".replicas", "startHooks.log");
+var START_HOOKS_LOG = join10(homedir7(), ".replicas", "startHooks.log");
 var START_HOOKS_RUNNING_PROMPT = `IMPORTANT - Start Hooks Running:
 Start hooks are shell commands/scripts set by repository owners that run on workspace startup.
 These hooks are currently executing in the background. You can:
@@ -2088,8 +2114,8 @@ The start hooks may install dependencies, build projects, or perform other setup
 If your task depends on setup being complete, check the log file before proceeding.`;
 async function readReplicasConfigFromDir(dirPath) {
   for (const filename of REPLICAS_CONFIG_FILENAMES) {
-    const configPath = join9(dirPath, filename);
-    if (!existsSync3(configPath)) {
+    const configPath = join10(dirPath, filename);
+    if (!existsSync4(configPath)) {
       continue;
     }
     const data = await readFile6(configPath, "utf-8");
@@ -2158,7 +2184,7 @@ var ReplicasConfigService = class {
     const logLine = `[${timestamp}] ${message}
 `;
     try {
-      await mkdir6(join9(homedir6(), ".replicas"), { recursive: true });
+      await mkdir6(join10(homedir7(), ".replicas"), { recursive: true });
       await appendFile(START_HOOKS_LOG, logLine, "utf-8");
     } catch (error) {
       console.error("Failed to write to start hooks log:", error);
@@ -2170,7 +2196,7 @@ var ReplicasConfigService = class {
       command: params.content,
       label: "env start hook",
       repoName: "environment",
-      cwd: homedir6(),
+      cwd: homedir7(),
       timeout: params.timeoutMs ?? DEFAULT_START_HOOK_TIMEOUT_MS,
       onOutputChunk: params.onOutputChunk
     });
@@ -2293,7 +2319,7 @@ var ReplicasConfigService = class {
     this.hooksCompleted = false;
     this.hooksFailed = false;
     try {
-      await mkdir6(join9(homedir6(), ".replicas"), { recursive: true });
+      await mkdir6(join10(homedir7(), ".replicas"), { recursive: true });
       await writeFile4(
         START_HOOKS_LOG,
         `=== Start Hooks Execution Log ===
@@ -2488,11 +2514,11 @@ var replicasConfigService = new ReplicasConfigService();
 
 // src/services/event-service.ts
 import { mkdir as mkdir7 } from "fs/promises";
-import { homedir as homedir7 } from "os";
-import { join as join10 } from "path";
+import { homedir as homedir8 } from "os";
+import { join as join11 } from "path";
 import { randomUUID as randomUUID2 } from "crypto";
-var ENGINE_DIR = join10(homedir7(), ".replicas", "engine");
-var EVENTS_FILE = join10(ENGINE_DIR, "events.jsonl");
+var ENGINE_DIR = join11(homedir8(), ".replicas", "engine");
+var EVENTS_FILE = join11(ENGINE_DIR, "events.jsonl");
 var EventService = class {
   subscribers = /* @__PURE__ */ new Map();
   writer = new StreamWriter();
@@ -2524,14 +2550,14 @@ var eventService = new EventService();
 
 // src/services/preview-service.ts
 import { mkdir as mkdir8, readFile as readFile7 } from "fs/promises";
-import { existsSync as existsSync4 } from "fs";
+import { existsSync as existsSync5 } from "fs";
 import { randomUUID as randomUUID3 } from "crypto";
-import { homedir as homedir8 } from "os";
-import { dirname as dirname2, join as join11 } from "path";
-var PREVIEW_PORTS_FILE = join11(homedir8(), ".replicas", "preview-ports.json");
+import { homedir as homedir9 } from "os";
+import { dirname as dirname2, join as join12 } from "path";
+var PREVIEW_PORTS_FILE = join12(homedir9(), ".replicas", "preview-ports.json");
 async function readPreviewsFile() {
   try {
-    if (!existsSync4(PREVIEW_PORTS_FILE)) {
+    if (!existsSync5(PREVIEW_PORTS_FILE)) {
       return { previews: [] };
     }
     const raw = await readFile7(PREVIEW_PORTS_FILE, "utf-8");
@@ -2638,9 +2664,8 @@ async function registerDesktopPreview() {
 }
 
 // src/services/chat/chat-service.ts
-import { existsSync as existsSync11 } from "fs";
-import { appendFile as appendFile4, copyFile as copyFile2, mkdir as mkdir19, readFile as readFile20, rename as rename3, rm as rm3 } from "fs/promises";
-import { join as join28 } from "path";
+import { appendFile as appendFile4, copyFile as copyFile2, mkdir as mkdir20, readFile as readFile20, rename as rename3, rm as rm3 } from "fs/promises";
+import { join as join30 } from "path";
 import { randomUUID as randomUUID9 } from "crypto";
 
 // ../shared/src/workspace-chat.ts
@@ -2807,9 +2832,9 @@ import {
   query
 } from "@anthropic-ai/claude-agent-sdk";
 import { randomUUID as randomUUID5 } from "crypto";
-import { dirname as dirname4, join as join15 } from "path";
+import { dirname as dirname4, join as join16 } from "path";
 import { mkdir as mkdir10 } from "fs/promises";
-import { homedir as homedir10 } from "os";
+import { homedir as homedir11 } from "os";
 
 // src/utils/linear-converter.ts
 function linearThoughtToResponse(thought) {
@@ -3194,8 +3219,8 @@ function extractPlanFromCodexAspNotification(notification) {
 // src/utils/image-utils.ts
 import { randomUUID as randomUUID4 } from "crypto";
 import { mkdir as mkdir9, unlink as unlink2, writeFile as writeFile5 } from "fs/promises";
-import { homedir as homedir9 } from "os";
-import { join as join12 } from "path";
+import { homedir as homedir10 } from "os";
+import { join as join13 } from "path";
 function isImageMediaType(value) {
   return IMAGE_MEDIA_TYPES.includes(value);
 }
@@ -3295,14 +3320,14 @@ async function normalizeImages(images) {
   }
   return normalized;
 }
-async function saveNormalizedImagesToTempFiles(images, tempImageDir = join12(homedir9(), ".replicas", "codex", "temp-images")) {
+async function saveNormalizedImagesToTempFiles(images, tempImageDir = join13(homedir10(), ".replicas", "codex", "temp-images")) {
   await mkdir9(tempImageDir, { recursive: true });
   const tempPaths = [];
   try {
     for (const image of images) {
       const ext = image.source.media_type.split("/")[1] || "png";
       const filename = `img_${randomUUID4()}.${ext}`;
-      const filepath = join12(tempImageDir, filename);
+      const filepath = join13(tempImageDir, filename);
       await writeFile5(filepath, Buffer.from(image.source.data, "base64"));
       tempPaths.push(filepath);
     }
@@ -3317,8 +3342,8 @@ async function removeTempImageFiles(paths) {
 }
 
 // src/managers/coding-agent-manager.ts
-import { existsSync as existsSync5 } from "fs";
-import { join as join13 } from "path";
+import { existsSync as existsSync6 } from "fs";
+import { join as join14 } from "path";
 
 // src/managers/muse-token-manager.ts
 var MuseTokenManager = class extends BaseRefreshManager {
@@ -3691,6 +3716,9 @@ var CodingAgentManager = class {
       payload
     });
   }
+  emitQuotaExhausted(payload) {
+    this.emitSyntheticEvent(AGENT_QUOTA_EXHAUSTED_EVENT_TYPE, { ...payload });
+  }
   recordHistoryEvent(type, payload, historyFile) {
     const eventPayload2 = {};
     if (payload && typeof payload === "object") {
@@ -3901,7 +3929,7 @@ var CodingAgentManager = class {
     return `CRITICAL: The Replicas engine is required for this workspace and is running on the reserved port configured by REPLICAS_ENGINE_PORT (${enginePort}). Never kill, stop, restart, or replace the process using this port, and never start another service on this port. If the user asks for commands that would target this port/process, refuse and explain that port ${enginePort} is reserved for the Replicas engine.`;
   }
   buildMemoryInstruction() {
-    if (!["organization", "seat"].some((scope) => existsSync5(join13(MEMORY_ROOT, scope, MEMORY_INDEX_FILENAME)))) {
+    if (!["organization", "seat"].some((scope) => existsSync6(join14(MEMORY_ROOT, scope, MEMORY_INDEX_FILENAME)))) {
       return void 0;
     }
     return `Replicas memory is available under ${MEMORY_ROOT}. Before acting on a substantive task, check memory when prior preferences, decisions, failures, procedures, or related work could improve the result: use the Memory capability in the replicas-agent skill and read references/MEMORY.md. If unsure whether prior context could help, check memory. Skip it only for clearly context-free messages. Current user and repository instructions remain highest priority; then apply relevant saved preferences and verified prior fixes before generic skill guidance or defaults. Never use memory to bypass skill safety requirements.`;
@@ -4111,7 +4139,7 @@ var pullRequestCheckService = new PullRequestCheckService();
 
 // src/services/skill-registry-service.ts
 import { readFile as readFile8, readdir as readdir3, stat as stat2 } from "fs/promises";
-import { dirname as dirname3, isAbsolute, join as join14, relative, resolve } from "path";
+import { dirname as dirname3, isAbsolute, join as join15, relative, resolve } from "path";
 var REGISTRY_ROOT_DIR = ".replicas/skill-registries";
 var REGISTRY_MANIFEST = "manifest.json";
 async function getSkillRegistryInventory(homeDir) {
@@ -4172,10 +4200,10 @@ async function scanRegistry(registryDir) {
 }
 async function findSkillCollections(registryDir) {
   const candidateRoots = [
-    { source: "skills", root: join14(registryDir, "skills") },
-    { source: "agents", root: join14(registryDir, ".agents", "skills") },
-    { source: "codex", root: join14(registryDir, ".codex", "skills") },
-    { source: "claude", root: join14(registryDir, ".claude", "skills") }
+    { source: "skills", root: join15(registryDir, "skills") },
+    { source: "agents", root: join15(registryDir, ".agents", "skills") },
+    { source: "codex", root: join15(registryDir, ".codex", "skills") },
+    { source: "claude", root: join15(registryDir, ".claude", "skills") }
   ];
   const collections = [];
   for (const { source, root } of candidateRoots) {
@@ -4189,9 +4217,9 @@ async function findSkillCollections(registryDir) {
 async function findSkillDirsInRoot(root) {
   const skillDirs = [];
   for (const dirent of await safeReadDir(root)) {
-    const skillDir = join14(root, dirent.name);
+    const skillDir = join15(root, dirent.name);
     if (!await isDirectoryDirent(dirent, skillDir)) continue;
-    if (await fileExists(join14(skillDir, "SKILL.md"))) {
+    if (await fileExists(join15(skillDir, "SKILL.md"))) {
       skillDirs.push(skillDir);
     }
   }
@@ -4201,9 +4229,9 @@ async function findTopLevelSkills(registryDir) {
   const skills = [];
   for (const dirent of await safeReadDir(registryDir)) {
     if (dirent.name.startsWith(".") || dirent.name === "skills" || dirent.name === "plugins") continue;
-    const skillDir = join14(registryDir, dirent.name);
+    const skillDir = join15(registryDir, dirent.name);
     if (!await isDirectoryDirent(dirent, skillDir)) continue;
-    if (await fileExists(join14(skillDir, "SKILL.md"))) {
+    if (await fileExists(join15(skillDir, "SKILL.md"))) {
       skills.push({ source: "root", skillDir });
     }
   }
@@ -4214,10 +4242,10 @@ async function findClaudePluginRoots(registryDir) {
   async function walk(dir) {
     for (const dirent of await safeReadDir(dir)) {
       if (dirent.name === ".git") continue;
-      const child = join14(dir, dirent.name);
+      const child = join15(dir, dirent.name);
       if (!await isDirectoryDirent(dirent, child)) continue;
       if (dirent.name === ".claude-plugin") {
-        if (await fileExists(join14(child, "plugin.json"))) {
+        if (await fileExists(join15(child, "plugin.json"))) {
           roots.push(dirname3(child));
         }
         continue;
@@ -4229,7 +4257,7 @@ async function findClaudePluginRoots(registryDir) {
   return uniqueStrings(roots);
 }
 async function hasCodexMarketplace(registryDir) {
-  return await fileExists(join14(registryDir, ".agents", "plugins", "marketplace.json")) || await fileExists(join14(registryDir, ".codex", "plugins", "marketplace.json"));
+  return await fileExists(join15(registryDir, ".agents", "plugins", "marketplace.json")) || await fileExists(join15(registryDir, ".codex", "plugins", "marketplace.json"));
 }
 async function installCodexRegistryPlugins(client2, inventory) {
   const cwds = inventory.codexMarketplaceCwds;
@@ -4271,10 +4299,10 @@ async function readManifest(homeDir) {
   }
 }
 function getRegistryRoot(homeDir) {
-  return join14(homeDir, REGISTRY_ROOT_DIR);
+  return join15(homeDir, REGISTRY_ROOT_DIR);
 }
 function getManifestPath(homeDir) {
-  return join14(getRegistryRoot(homeDir), REGISTRY_MANIFEST);
+  return join15(getRegistryRoot(homeDir), REGISTRY_MANIFEST);
 }
 function emptyInventory(registryRoot) {
   return {
@@ -4725,7 +4753,7 @@ var ClaudeManager = class _ClaudeManager extends CodingAgentManager {
   authRetrying = false;
   constructor(options) {
     super({ ...options, provider: AGENT.CLAUDE });
-    this.historyFilePath = options.historyFilePath ?? join15(homedir10(), ".replicas", "claude", "history.jsonl");
+    this.historyFilePath = options.historyFilePath ?? join16(homedir11(), ".replicas", "claude", "history.jsonl");
     this.historyFile = new CodexHistoryFile(this.historyFilePath);
     this.systemPromptOverride = options.systemPromptOverride;
     this.toolsOverride = options.tools;
@@ -5095,6 +5123,7 @@ var ClaudeManager = class _ClaudeManager extends CodingAgentManager {
     const limit = kind === "out_of_credits" ? "Claude ran out of credits on the credential this workspace is using." : "Claude hit the usage limit on the credential this workspace is using.";
     const next = outcome === "failed" ? "The configured fallback credential could not be used. Check it in Settings \u2192 Agents and try again." : outcome === "not_configured" ? "No fallback credential is configured for this workspace. Add one in Settings \u2192 Agents, or try again once the limit resets." : "No other credential is available for this workspace. Check Settings \u2192 Agents, or try again once the limit resets.";
     await this.emitTerminalErrorResult(detail, [`${limit} ${next}`]);
+    this.emitQuotaExhausted({ provider: "claude", reason: kind, detail });
   }
   async emitMidTurnExhaustedEvent(error) {
     const detail = error instanceof Error ? error.message : String(error);
@@ -5800,7 +5829,7 @@ var ClaudeManager = class _ClaudeManager extends CodingAgentManager {
 
 // src/managers/codex-asp/codex-asp-manager.ts
 import { readdir as readdir4 } from "fs/promises";
-import { join as join17 } from "path";
+import { join as join18 } from "path";
 
 // src/managers/codex-asp/asp-host.ts
 var hostPromise = null;
@@ -5915,7 +5944,7 @@ var CodexQuotaStatusTracker = class {
 };
 
 // src/managers/codex-asp/mappers.ts
-import { existsSync as existsSync6, readFileSync as readFileSync3 } from "fs";
+import { existsSync as existsSync7, readFileSync as readFileSync3 } from "fs";
 var localImageCache = /* @__PURE__ */ new Map();
 var DEFAULT_MODEL = DEFAULT_CODEX_MODEL;
 var THREAD_START_METHOD = "thread/start";
@@ -6039,7 +6068,7 @@ function transcriptItemsForTurn(turn) {
 function userImageForLocalPath(path6) {
   const cached = localImageCache.get(path6);
   if (cached) return cached;
-  if (!existsSync6(path6)) return null;
+  if (!existsSync7(path6)) return null;
   const image = {
     type: "image",
     mediaType: inferMediaType(path6),
@@ -6534,20 +6563,21 @@ var TranscriptUpdateCoalescer = class {
 };
 
 // src/services/chat/history-paths.ts
-import { homedir as homedir11 } from "os";
-import { join as join16 } from "path";
-var ENGINE_DIR2 = join16(homedir11(), ".replicas", "engine");
-var CHATS_FILE = join16(ENGINE_DIR2, "chats.json");
-var CLAUDE_HISTORY_DIR = join16(ENGINE_DIR2, "claude-histories");
-var RELAY_HISTORY_DIR = join16(ENGINE_DIR2, "relay-histories");
-var CODEX_HISTORY_DIR = join16(ENGINE_DIR2, "codex-histories");
-var CURSOR_HISTORY_DIR = join16(ENGINE_DIR2, "cursor-histories");
-var OPENCODE_HISTORY_DIR = join16(ENGINE_DIR2, "opencode-histories");
-var PI_HISTORY_DIR = join16(ENGINE_DIR2, "pi-histories");
-var DEEPSEEK_HISTORY_DIR = join16(ENGINE_DIR2, "deepseek-histories");
-var FX_HISTORY_DIR = join16(ENGINE_DIR2, "fx-histories");
-var KIMI_HISTORY_DIR = join16(ENGINE_DIR2, "kimi-histories");
-var MUSE_HISTORY_DIR = join16(ENGINE_DIR2, "muse-histories");
+import { homedir as homedir12 } from "os";
+import { join as join17 } from "path";
+var ENGINE_DIR2 = join17(homedir12(), ".replicas", "engine");
+var CHATS_FILE = join17(ENGINE_DIR2, "chats.json");
+var CLAUDE_HISTORY_DIR = join17(ENGINE_DIR2, "claude-histories");
+var RELAY_HISTORY_DIR = join17(ENGINE_DIR2, "relay-histories");
+var CODEX_HISTORY_DIR = join17(ENGINE_DIR2, "codex-histories");
+var CURSOR_HISTORY_DIR = join17(ENGINE_DIR2, "cursor-histories");
+var OPENCODE_HISTORY_DIR = join17(ENGINE_DIR2, "opencode-histories");
+var PI_HISTORY_DIR = join17(ENGINE_DIR2, "pi-histories");
+var DEEPSEEK_HISTORY_DIR = join17(ENGINE_DIR2, "deepseek-histories");
+var FX_HISTORY_DIR = join17(ENGINE_DIR2, "fx-histories");
+var KIMI_HISTORY_DIR = join17(ENGINE_DIR2, "kimi-histories");
+var MUSE_HISTORY_DIR = join17(ENGINE_DIR2, "muse-histories");
+var FORKS_DIR = join17(ENGINE_DIR2, "forks");
 var HISTORY_DIR_BY_PROVIDER = {
   claude: CLAUDE_HISTORY_DIR,
   relay: RELAY_HISTORY_DIR,
@@ -6587,6 +6617,12 @@ var ChatMessagePersistenceError = class extends Error {
     this.cause = cause;
   }
 };
+var ChatProviderUnavailableError = class extends Error {
+  constructor(provider) {
+    super(`${provider} is not configured in this workspace`);
+    this.name = "ChatProviderUnavailableError";
+  }
+};
 
 // src/managers/codex-asp/codex-asp-manager.ts
 var CodexQuotaError = class extends Error {
@@ -6614,7 +6650,7 @@ async function readCodexAspThreadHistory(threadId) {
   }
   for (const entry of entries) {
     if (!entry.isFile() || !entry.name.endsWith(".jsonl") || entry.name.endsWith(".pages.jsonl")) continue;
-    const history = await new CodexHistoryFile(join17(CODEX_HISTORY_DIR, entry.name)).load();
+    const history = await new CodexHistoryFile(join18(CODEX_HISTORY_DIR, entry.name)).load();
     const transcript = history.transcriptsByThreadId.get(threadId);
     if (transcript) {
       return {
@@ -6974,8 +7010,14 @@ var CodexAspManager = class extends CodingAgentManager {
           const retryFailure = await this.restartAndRetry(dispatch);
           if (!retryFailure) return;
           terminalError = retryFailure.error;
-        } else if (await this.confirmOutOfCredits(await getCodexAspHost())) {
-          return;
+        } else {
+          const outOfCredits = await this.confirmOutOfCredits(await getCodexAspHost());
+          this.emitQuotaExhausted({
+            provider: "codex",
+            reason: outOfCredits ? "out_of_credits" : detectAgentQuotaLimit(terminalError.message) ?? "rate_limit",
+            detail: terminalError.message
+          });
+          if (outOfCredits) return;
         }
       }
       if (terminalError instanceof CodexAspAuthMethodChangedError) {
@@ -8003,24 +8045,24 @@ var CodexAspManager = class extends CodingAgentManager {
 
 // src/managers/cursor-manager.ts
 import { mkdir as mkdir12, readFile as readFile11, readdir as readdir5 } from "fs/promises";
-import { basename as basename2, dirname as dirname6, extname, join as join19 } from "path";
+import { basename as basename2, dirname as dirname6, extname, join as join20 } from "path";
 import { parse as parseYaml } from "yaml";
 import { Agent as CursorAgent } from "@cursor/sdk";
 
 // src/services/native-command-protection-hooks.ts
-import { existsSync as existsSync7 } from "fs";
+import { existsSync as existsSync8 } from "fs";
 import { mkdir as mkdir11, readFile as readFile10, writeFile as writeFile6 } from "fs/promises";
-import { basename, dirname as dirname5, join as join18 } from "path";
+import { basename, dirname as dirname5, join as join19 } from "path";
 import { fileURLToPath } from "url";
 var moduleDirectory = dirname5(fileURLToPath(import.meta.url));
 var hookPath = [
-  join18(moduleDirectory, "command-protection-hook.js"),
-  join18(moduleDirectory, "..", "command-protection-hook.ts")
-].find(existsSync7);
+  join19(moduleDirectory, "command-protection-hook.js"),
+  join19(moduleDirectory, "..", "command-protection-hook.ts")
+].find(existsSync8);
 var postToolHookPath = [
-  join18(moduleDirectory, "post-tool-pr-hook.js"),
-  join18(moduleDirectory, "..", "post-tool-pr-hook.ts")
-].find(existsSync7);
+  join19(moduleDirectory, "post-tool-pr-hook.js"),
+  join19(moduleDirectory, "..", "post-tool-pr-hook.ts")
+].find(existsSync8);
 function shellCommand(path6, provider) {
   if (!path6) throw new Error("Replicas hook executable is missing.");
   const args = [
@@ -8040,7 +8082,7 @@ function getPostToolPrHookPath() {
   return postToolHookPath;
 }
 async function ensureCursorCommandProtectionHook() {
-  const path6 = join18(ENGINE_ENV.HOME_DIR, ".cursor", "hooks.json");
+  const path6 = join19(ENGINE_ENV.HOME_DIR, ".cursor", "hooks.json");
   let config = {};
   try {
     const parsed = JSON.parse(await readFile10(path6, "utf8"));
@@ -8065,7 +8107,7 @@ async function ensureCursorCommandProtectionHook() {
 `, "utf8");
 }
 async function ensureKimiCommandProtectionHook() {
-  const path6 = join18(ENGINE_ENV.HOME_DIR, ".kimi-code", "config.toml");
+  const path6 = join19(ENGINE_ENV.HOME_DIR, ".kimi-code", "config.toml");
   const start = "# Replicas command protection hook";
   const end = "# End Replicas command protection hook";
   let config = "";
@@ -8149,7 +8191,7 @@ async function listCursorCommandsInDirectory(directory) {
     const name = basename2(entry.name, ".md");
     let description;
     try {
-      description = extractCursorCommandDescription(await readFile11(join19(directory, entry.name), "utf8"));
+      description = extractCursorCommandDescription(await readFile11(join20(directory, entry.name), "utf8"));
     } catch (error) {
       console.warn("[CursorManager] Failed to read slash command file:", error);
     }
@@ -8171,7 +8213,7 @@ var CursorManager = class extends CodingAgentManager {
   slashCommandsRequest = null;
   constructor(options) {
     super(options);
-    this.historyFilePath = options.historyFilePath ?? join19(ENGINE_ENV.HOME_DIR, ".replicas", "cursor", "history.jsonl");
+    this.historyFilePath = options.historyFilePath ?? join20(ENGINE_ENV.HOME_DIR, ".replicas", "cursor", "history.jsonl");
     this.historyFile = new CodexHistoryFile(this.historyFilePath);
     this.initializeManager(this.processMessageInternal.bind(this));
   }
@@ -8246,7 +8288,7 @@ var CursorManager = class extends CodingAgentManager {
     this.slashCommandsRequest ??= (async () => {
       try {
         const repoDirectories = await getAgentAdditionalDirectories();
-        const commandDirectories = [this.workingDirectory, ...repoDirectories, ENGINE_ENV.HOME_DIR].map((directory) => join19(directory, ".cursor", "commands"));
+        const commandDirectories = [this.workingDirectory, ...repoDirectories, ENGINE_ENV.HOME_DIR].map((directory) => join20(directory, ".cursor", "commands"));
         const commands = mergeSlashCommands(
           ...await Promise.all(commandDirectories.map(listCursorCommandsInDirectory))
         );
@@ -8527,9 +8569,9 @@ ${instructions}
 import { spawn as spawn3 } from "child_process";
 import { randomUUID as randomUUID6 } from "crypto";
 import { createRequire } from "module";
-import { dirname as dirname7, join as join20 } from "path";
+import { dirname as dirname7, join as join21 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
-import { existsSync as existsSync8 } from "fs";
+import { existsSync as existsSync9 } from "fs";
 import { mkdir as mkdir13, readFile as readFile12, writeFile as writeFile7 } from "fs/promises";
 import { z as z2 } from "zod";
 import WebSocket from "ws";
@@ -8542,16 +8584,16 @@ var questionSelectionSchema = z2.record(z2.string(), z2.object({
   custom: z2.string().optional()
 }));
 var require2 = createRequire(import.meta.url);
-var DSH_BIN = join20(dirname7(require2.resolve("@deepseek-ai/dsh/package.json")), "lib", "bin.js");
+var DSH_BIN = join21(dirname7(require2.resolve("@deepseek-ai/dsh/package.json")), "lib", "bin.js");
 var MANAGER_DIR = dirname7(fileURLToPath2(import.meta.url));
 var DSH_PATCH = [
-  join20(MANAGER_DIR, "..", "..", "scripts", "deepseek", "replicas.cordis.patch.yml"),
-  join20(MANAGER_DIR, "..", "..", "..", "scripts", "deepseek", "replicas.cordis.patch.yml")
-].find(existsSync8) ?? "";
+  join21(MANAGER_DIR, "..", "..", "scripts", "deepseek", "replicas.cordis.patch.yml"),
+  join21(MANAGER_DIR, "..", "..", "..", "scripts", "deepseek", "replicas.cordis.patch.yml")
+].find(existsSync9) ?? "";
 var DSH_COMMAND_PROTECTION_PLUGIN = [
-  join20(MANAGER_DIR, "deepseek-command-protection-plugin.js"),
-  join20(MANAGER_DIR, "..", "deepseek-command-protection-plugin.ts")
-].find(existsSync8) ?? "";
+  join21(MANAGER_DIR, "deepseek-command-protection-plugin.js"),
+  join21(MANAGER_DIR, "..", "deepseek-command-protection-plugin.ts")
+].find(existsSync9) ?? "";
 var DeepseekApiClient = class extends AbstractApiClient {
   constructor(baseUrl) {
     super(3e4);
@@ -8664,7 +8706,7 @@ var DeepseekManager = class extends CodingAgentManager {
   constructor(options) {
     super(options);
     this.sessionId = options.initialSessionId ? sessionIdSchema.parse(options.initialSessionId) : null;
-    this.historyFilePath = options.historyFilePath ?? join20(ENGINE_ENV.HOME_DIR, ".replicas", "deepseek", "history.jsonl");
+    this.historyFilePath = options.historyFilePath ?? join21(ENGINE_ENV.HOME_DIR, ".replicas", "deepseek", "history.jsonl");
     this.historyFile = new CodexHistoryFile(this.historyFilePath);
     this.initializeManager(this.processMessageInternal.bind(this));
   }
@@ -8744,7 +8786,7 @@ var DeepseekManager = class extends CodingAgentManager {
   async ensureClient() {
     if (this.client) return this.client;
     if (!DSH_PATCH || !DSH_COMMAND_PROTECTION_PLUGIN) throw new Error("DeepSeek Harness configuration is missing from the engine package.");
-    const runtimePatch = join20(ENGINE_ENV.HOME_DIR, ".replicas", "deepseek", "replicas.cordis.patch.yml");
+    const runtimePatch = join21(ENGINE_ENV.HOME_DIR, ".replicas", "deepseek", "replicas.cordis.patch.yml");
     await mkdir13(dirname7(runtimePatch), { recursive: true });
     await writeFile7(runtimePatch, (await readFile12(DSH_PATCH, "utf8")).replace(
       "__REPLICAS_DSH_COMMAND_PROTECTION_PLUGIN__",
@@ -8768,7 +8810,7 @@ var DeepseekManager = class extends CodingAgentManager {
         ...process.env,
         DEEPSEEK_API_KEY: apiKey,
         DEEPSEEK_BASE_URL: "https://openrouter.ai/api/v1",
-        DSH_HOME: join20(ENGINE_ENV.HOME_DIR, ".replicas", "deepseek"),
+        DSH_HOME: join21(ENGINE_ENV.HOME_DIR, ".replicas", "deepseek"),
         DSH_PERMISSION_MODE: "danger-full-access",
         DSH_TELEMETRY_DISABLED: "true"
       },
@@ -9869,9 +9911,9 @@ ${pending}
 };
 
 // src/managers/opencode-manager.ts
-import { existsSync as existsSync9 } from "fs";
+import { existsSync as existsSync10 } from "fs";
 import { copyFile, mkdir as mkdir16, readFile as readFile15, rm as rm2 } from "fs/promises";
-import { delimiter, dirname as dirname10, join as join21 } from "path";
+import { delimiter, dirname as dirname10, join as join22 } from "path";
 import { randomBytes as randomBytes3 } from "crypto";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import { Agent } from "undici";
@@ -9931,10 +9973,10 @@ async function getAllowedOpenRouterModels() {
 
 // src/managers/opencode-manager.ts
 var OPENCODE_SHIM_DIR = dirname10(fileURLToPath3(new URL("../../scripts/opencode", import.meta.url)));
-var OPENCODE_COMMAND_PROTECTION_PLUGIN_SOURCE = join21(OPENCODE_SHIM_DIR, "opencode-command-protection-plugin.ts");
-var OPENCODE_COMMAND_PROTECTION_PLUGIN_PATH = join21(ENGINE_ENV.HOME_DIR, ".config", "opencode", "plugins", "replicas-command-protection.ts");
-var OPENCODE_LEGACY_COMMAND_PROTECTION_PLUGIN_PATH = join21(ENGINE_ENV.HOME_DIR, ".config", "opencode", "plugins", "replicas-command-protection.mjs");
-var OPENCODE_CONFIG_PATH = join21(ENGINE_ENV.HOME_DIR, ".config", "opencode", "opencode.json");
+var OPENCODE_COMMAND_PROTECTION_PLUGIN_SOURCE = join22(OPENCODE_SHIM_DIR, "opencode-command-protection-plugin.ts");
+var OPENCODE_COMMAND_PROTECTION_PLUGIN_PATH = join22(ENGINE_ENV.HOME_DIR, ".config", "opencode", "plugins", "replicas-command-protection.ts");
+var OPENCODE_LEGACY_COMMAND_PROTECTION_PLUGIN_PATH = join22(ENGINE_ENV.HOME_DIR, ".config", "opencode", "plugins", "replicas-command-protection.mjs");
+var OPENCODE_CONFIG_PATH = join22(ENGINE_ENV.HOME_DIR, ".config", "opencode", "opencode.json");
 var OPENCODE_FETCH_DISPATCHER = new Agent({ headersTimeout: 0, bodyTimeout: 0 });
 var OPENCODE_SERVER_STARTUP_TIMEOUT_MS = 3e4;
 var OPENCODE_WORKSPACE_PERMISSION = "allow";
@@ -9953,7 +9995,7 @@ var opencodeAuthSchema = z3.record(z3.string(), z3.object({
   key: z3.string().optional()
 }));
 async function hasOpencodeCredentials(provider) {
-  if (!existsSync9(OPENCODE_AUTH_PATH)) return false;
+  if (!existsSync10(OPENCODE_AUTH_PATH)) return false;
   try {
     const auth = opencodeAuthSchema.safeParse(JSON.parse(await readFile15(OPENCODE_AUTH_PATH, "utf8")));
     return auth.success && auth.data[provider]?.type === "api" && Boolean(auth.data[provider]?.key);
@@ -10146,7 +10188,7 @@ var OpencodeManager = class extends CodingAgentManager {
   constructor(options) {
     super(options);
     this.sessionId = options.initialSessionId;
-    this.historyFilePath = options.historyFilePath ?? join21(ENGINE_ENV.HOME_DIR, ".replicas", "opencode", "history.jsonl");
+    this.historyFilePath = options.historyFilePath ?? join22(ENGINE_ENV.HOME_DIR, ".replicas", "opencode", "history.jsonl");
     this.historyFile = new CodexHistoryFile(this.historyFilePath);
     this.initializeManager(this.processMessageInternal.bind(this));
   }
@@ -10248,7 +10290,7 @@ var OpencodeManager = class extends CodingAgentManager {
       if (!await hasOpencodeCredentials(providerId)) {
         throw new Error("OpenCode Go, Aster, or OpenRouter credentials are not configured for Opencode in this workspace.");
       }
-      if (!existsSync9(OPENCODE_COMMAND_PROTECTION_PLUGIN_SOURCE)) {
+      if (!existsSync10(OPENCODE_COMMAND_PROTECTION_PLUGIN_SOURCE)) {
         throw new Error("Opencode command protection plugin is missing from the engine package.");
       }
       await mkdir16(dirname10(OPENCODE_COMMAND_PROTECTION_PLUGIN_PATH), { recursive: true });
@@ -10445,6 +10487,7 @@ var OpencodeManager = class extends CodingAgentManager {
     this.handledAccountRateLimit = true;
     const message = typeof status.message === "string" ? status.message : typeof action.message === "string" ? action.message : "OpenCode Go usage limit reached.";
     this.recordHistoryEvent("opencode-error", { message, code: "account_rate_limit" }, this.historyFile);
+    this.emitQuotaExhausted({ provider: "opencode", reason: "rate_limit", detail: message });
     await this.abortActiveTurn();
   }
   recordOpencodeMessageRole(payload) {
@@ -10547,7 +10590,7 @@ var OpencodeManager = class extends CodingAgentManager {
 
 // src/managers/pi-manager.ts
 import { mkdir as mkdir17 } from "fs/promises";
-import { dirname as dirname11, join as join22 } from "path";
+import { dirname as dirname11, join as join23 } from "path";
 import {
   AuthStorage,
   createAgentSession,
@@ -10661,7 +10704,7 @@ var PiManager = class extends CodingAgentManager {
   providerApiKey = null;
   constructor(options) {
     super(options);
-    this.historyFilePath = options.historyFilePath ?? join22(PI_HISTORY_DIR, `${Date.now()}.jsonl`);
+    this.historyFilePath = options.historyFilePath ?? join23(PI_HISTORY_DIR, `${Date.now()}.jsonl`);
     this.historyFile = new CodexHistoryFile(this.historyFilePath);
     this.initializeManager(this.processMessageInternal.bind(this));
   }
@@ -10766,7 +10809,7 @@ var PiManager = class extends CodingAgentManager {
     const sessionManager = this.initialSessionId ? SessionManager.open(this.initialSessionId, PI_HISTORY_DIR, this.workingDirectory) : SessionManager.create(this.workingDirectory, PI_HISTORY_DIR);
     const resourceLoader = new DefaultResourceLoader({
       cwd: this.workingDirectory,
-      agentDir: join22(ENGINE_ENV.HOME_DIR, ".pi", "agent"),
+      agentDir: join23(ENGINE_ENV.HOME_DIR, ".pi", "agent"),
       extensionFactories: [registerCommandProtection(
         this.workingDirectory,
         this.historyFile,
@@ -11512,8 +11555,8 @@ import {
   rename as rename2,
   unlink as unlink3
 } from "fs/promises";
-import { existsSync as existsSync10, readFileSync as readFileSync4, readdirSync } from "fs";
-import { join as join23 } from "path";
+import { existsSync as existsSync11, readFileSync as readFileSync4, readdirSync } from "fs";
+import { join as join24 } from "path";
 var MAX_FAILED_RECORDS = 500;
 var FLUSH_DEBOUNCE_MS = 15e3;
 var MAX_UPLOADED_SEGMENTS = 50;
@@ -11525,7 +11568,7 @@ var AnalyticsRecordBuffer = class {
       options.storageName,
       ...options.legacyStorageNames ?? []
     ];
-    this.liveFile = join23(ENGINE_DIR2, `${options.storageName}.jsonl`);
+    this.liveFile = join24(ENGINE_DIR2, `${options.storageName}.jsonl`);
     this.segmentFilePatterns = this.storageNames.map(
       (storageName) => new RegExp(`^${storageName}\\.(\\d+)\\.jsonl$`)
     );
@@ -11560,10 +11603,10 @@ var AnalyticsRecordBuffer = class {
     void pending.finally(() => this.pendingAppends.delete(pending));
   }
   readStoredRecords() {
-    if (!existsSync10(ENGINE_DIR2)) return [];
+    if (!existsSync11(ENGINE_DIR2)) return [];
     return readdirSync(ENGINE_DIR2, { withFileTypes: true }).filter((entry) => entry.isFile() && this.storageNames.some(
       (storageName) => entry.name === `${storageName}.jsonl` || entry.name.startsWith(`${storageName}.`) && (entry.name.endsWith(".jsonl") || entry.name.endsWith(`.jsonl${UPLOADED_SUFFIX}`))
-    )).map(({ name }) => name).sort().flatMap((name) => this.parseRecords(readFileSync4(join23(ENGINE_DIR2, name), "utf-8"))).map((record) => {
+    )).map(({ name }) => name).sort().flatMap((name) => this.parseRecords(readFileSync4(join24(ENGINE_DIR2, name), "utf-8"))).map((record) => {
       const recordId = this.options.getRecordId?.(record);
       if (recordId) this.recordIds.add(recordId);
       return record;
@@ -11598,8 +11641,8 @@ var AnalyticsRecordBuffer = class {
     }
     for (const storageName of this.storageNames) {
       await rename2(
-        join23(ENGINE_DIR2, `${storageName}.jsonl`),
-        join23(ENGINE_DIR2, `${storageName}.${Date.now()}.jsonl`)
+        join24(ENGINE_DIR2, `${storageName}.jsonl`),
+        join24(ENGINE_DIR2, `${storageName}.${Date.now()}.jsonl`)
       ).catch(() => {
       });
     }
@@ -11609,7 +11652,7 @@ var AnalyticsRecordBuffer = class {
     for (const entry of entries) {
       if (!this.segmentFilePatterns.some((pattern) => pattern.test(entry))) continue;
       try {
-        await this.uploadSegment(join23(ENGINE_DIR2, entry));
+        await this.uploadSegment(join24(ENGINE_DIR2, entry));
         flushed++;
       } catch (error) {
         failed++;
@@ -11638,7 +11681,7 @@ var AnalyticsRecordBuffer = class {
         (storageName) => entry.startsWith(`${storageName}.`)
       ) && entry.endsWith(UPLOADED_SUFFIX)).sort();
       for (const entry of uploaded.slice(0, -MAX_UPLOADED_SEGMENTS)) {
-        await unlink3(join23(ENGINE_DIR2, entry)).catch(() => {
+        await unlink3(join24(ENGINE_DIR2, entry)).catch(() => {
         });
       }
     }
@@ -12456,8 +12499,8 @@ var keepAliveService = new KeepAliveService();
 
 // src/services/canvas-service.ts
 import { readdir as readdir7, readFile as readFile18, stat as stat4 } from "fs/promises";
-import { homedir as homedir12 } from "os";
-import { join as join24 } from "path";
+import { homedir as homedir13 } from "os";
+import { join as join25 } from "path";
 
 // src/utils/contained-file.ts
 import { realpath, stat as stat3 } from "fs/promises";
@@ -12499,15 +12542,15 @@ async function writeRevisionedTextFile(filePath, content, expectedRevision) {
 
 // src/services/canvas-service.ts
 var GLOBAL_CANVAS_DIRECTORIES = [
-  join24(homedir12(), ".claude", "plans"),
-  join24(process.env.XDG_DATA_HOME ?? join24(homedir12(), ".local", "share"), "opencode", "plans"),
-  join24(homedir12(), ".replicas", "canvas")
+  join25(homedir13(), ".claude", "plans"),
+  join25(process.env.XDG_DATA_HOME ?? join25(homedir13(), ".local", "share"), "opencode", "plans"),
+  join25(homedir13(), ".replicas", "canvas")
 ];
 async function canvasDirectories() {
   const repositories = await gitService.listRepositories().catch(() => []);
   return [
     ...GLOBAL_CANVAS_DIRECTORIES,
-    ...repositories.map((repository) => join24(repository.path, ".opencode", "plans"))
+    ...repositories.map((repository) => join25(repository.path, ".opencode", "plans"))
   ];
 }
 var CanvasService = class {
@@ -12532,7 +12575,7 @@ var CanvasService = class {
         for (const entry of entries) {
           if (entry.name.startsWith(".")) continue;
           const filename = current.relativePath ? `${current.relativePath}/${entry.name}` : entry.name;
-          const filePath = join24(current.directory, entry.name);
+          const filePath = join25(current.directory, entry.name);
           if (entry.isDirectory()) {
             pending.push({ directory: filePath, relativePath: filename });
             continue;
@@ -12557,7 +12600,7 @@ var CanvasService = class {
     if (!safe) return null;
     const { kind, mimeType } = classifyCanvasFilename(safe);
     for (const directory of await this.directories()) {
-      const filePath = join24(directory, safe);
+      const filePath = join25(directory, safe);
       let sizeBytes = 0;
       let updatedAt = "";
       try {
@@ -12741,13 +12784,13 @@ async function reconcileCanvasItems(filenames) {
 import { createReadStream } from "fs";
 import { createHash as createHash4 } from "crypto";
 import { readFile as readFile19, readdir as readdir8, stat as stat5 } from "fs/promises";
-import { basename as basename3, join as join26 } from "path";
+import { basename as basename3, join as join27 } from "path";
 
 // src/services/chat/chat-senders.ts
-import { join as join25 } from "path";
-var CHAT_SENDERS_DIR = join25(ENGINE_DIR2, "chat-senders");
+import { join as join26 } from "path";
+var CHAT_SENDERS_DIR = join26(ENGINE_DIR2, "chat-senders");
 function chatMessageSendersFilePath(chatId) {
-  return join25(CHAT_SENDERS_DIR, `${chatId}.jsonl`);
+  return join26(CHAT_SENDERS_DIR, `${chatId}.jsonl`);
 }
 function parseChatMessageSendersJsonl(content) {
   return content.split("\n").flatMap((line) => {
@@ -12763,9 +12806,9 @@ function parseChatMessageSendersJsonl(content) {
 
 // src/services/upload-chat-transcripts.ts
 var HISTORY_DIRS = [
-  join26(ENGINE_DIR2, "claude-histories"),
-  join26(ENGINE_DIR2, "relay-histories"),
-  join26(ENGINE_DIR2, "codex-histories")
+  join27(ENGINE_DIR2, "claude-histories"),
+  join27(ENGINE_DIR2, "relay-histories"),
+  join27(ENGINE_DIR2, "codex-histories")
 ];
 async function flushAllChatTranscripts(chatsById = /* @__PURE__ */ new Map(), capture) {
   let flushed = 0;
@@ -12783,7 +12826,7 @@ async function flushAllChatTranscripts(chatsById = /* @__PURE__ */ new Map(), ca
       if (!entry.endsWith(".jsonl")) continue;
       const chatId = basename3(entry, ".jsonl");
       tasks.push(
-        uploadChatTranscript(chatId, join26(dir, entry), chatsById.get(chatId), capture).then((artifact) => {
+        uploadChatTranscript(chatId, join27(dir, entry), chatsById.get(chatId), capture).then((artifact) => {
           flushed++;
           if (artifact && capture) revisions.push(artifact);
         }).catch((err) => {
@@ -12807,7 +12850,8 @@ async function uploadChatTranscript(chatId, filePath, chat, capture) {
     createdAt: chat.createdAt,
     updatedAt: chat.updatedAt,
     parentChatId: chat.parentChatId,
-    deletedAt: chat.deletedAt ?? null
+    deletedAt: chat.deletedAt ?? null,
+    fork: chat.fork ?? null
   } : {};
   if (capture) {
     const hash = createHash4("sha256");
@@ -12868,7 +12912,7 @@ async function uploadChatTranscript(chatId, filePath, chat, capture) {
 // src/services/upload-engine-logs.ts
 import { createReadStream as createReadStream2 } from "fs";
 import { readdir as readdir9, stat as stat6 } from "fs/promises";
-import { join as join27 } from "path";
+import { join as join28 } from "path";
 var MAX_ENGINE_LOG_FLUSH_SESSIONS = 10;
 var MAX_ENGINE_LOG_FLUSH_BYTES = 5 * 1024 * 1024;
 var ENGINE_LOG_FLUSH_TIMEOUT_MS = 2e4;
@@ -12897,7 +12941,7 @@ async function flushAllEngineLogs() {
   const candidates = (await Promise.all(filenames.slice(0, MAX_ENGINE_LOG_FLUSH_SESSIONS).map(async (filename) => {
     try {
       const sessionId = filename.slice(0, -".log".length);
-      const filePath = join27(LOG_DIR, filename);
+      const filePath = join28(LOG_DIR, filename);
       const fileStat = await runBeforeDeadline(() => stat6(filePath), deadline);
       if (!fileStat.isFile()) {
         skipped++;
@@ -12992,32 +13036,67 @@ async function uploadEngineLog(input, timeoutMs) {
   }
 }
 
+// src/services/chat/fork-handoff.ts
+import { mkdir as mkdir19, open as open2, writeFile as writeFile9 } from "fs/promises";
+import { join as join29 } from "path";
+var EXCERPT_MAX_CHARS = 24e3;
+var MAX_SANITIZED_SOURCE_BYTES = 32 * 1024 * 1024;
+function unansweredRequest(blocks) {
+  const lastUser = blocks.findLastIndex((block) => block.startsWith("## User"));
+  if (lastUser === -1) return null;
+  const answered = blocks.slice(lastUser + 1).some((block) => block.startsWith("## Agent"));
+  return answered ? null : lastUserBlockText(blocks);
+}
+async function readHistoryTail(path6, maxBytes) {
+  let handle;
+  try {
+    handle = await open2(path6, "r");
+  } catch (error) {
+    if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") return { content: "", truncated: false };
+    throw error;
+  }
+  try {
+    const { size } = await handle.stat();
+    if (size <= maxBytes) return { content: await handle.readFile("utf-8"), truncated: false };
+    const buffer = Buffer.alloc(maxBytes);
+    await handle.read(buffer, 0, maxBytes, size - maxBytes);
+    const firstNewline = buffer.indexOf(10);
+    return { content: buffer.subarray(firstNewline + 1).toString("utf-8"), truncated: true };
+  } finally {
+    await handle.close();
+  }
+}
+function tailBlocks(blocks, maxChars) {
+  let start = blocks.length;
+  while (start > 0 && blocks.slice(start - 1).join("\n\n").length <= maxChars) start--;
+  const excerpt = start < blocks.length ? blocks.slice(start).join("\n\n") : `\u2026${blocks.at(-1)?.slice(-maxChars) ?? ""}`;
+  return { excerpt, truncated: start > 0 };
+}
+async function buildForkHandoff(input) {
+  const rawHistoryPath = join29(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.sourceProvider, input.senders);
+  const forkDir = join29(FORKS_DIR, input.targetChatId);
+  await mkdir19(forkDir, { recursive: true });
+  const transcriptPath = join29(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._
+
+` : "";
+  await writeFile9(transcriptPath, `${header}${blocks.join("\n\n")}
+`, "utf-8");
+  const { excerpt, truncated } = tailBlocks(blocks, EXCERPT_MAX_CHARS);
+  return {
+    excerpt,
+    excerptTruncated: truncated,
+    sourceTruncated,
+    resumeRequest: unansweredRequest(blocks),
+    transcriptPath,
+    rawHistoryPath
+  };
+}
+
 // src/services/chat/chat-service.ts
 var CHATS_BACKUP_FILE = `${CHATS_FILE}.bak`;
-function isCodexAvailable() {
-  return detectCodexAuthMethod() !== "none";
-}
-function isOpencodeAvailable() {
-  return existsSync11(OPENCODE_AUTH_PATH);
-}
-function isDeepseekAvailable() {
-  return Boolean(getDeepseekApiKey());
-}
-function isFxAvailable() {
-  return Boolean(ENGINE_ENV.AI_GATEWAY_API_KEY);
-}
-function isKimiAvailable() {
-  return Boolean(ENGINE_ENV.AI_GATEWAY_API_KEY);
-}
-function isMuseAvailable() {
-  return existsSync11(MUSE_AUTH_PATH);
-}
-function isPiAvailable() {
-  return existsSync11(PI_AUTH_PATH);
-}
-function isCursorAvailable() {
-  return Boolean(ENGINE_ENV.CURSOR_API_KEY);
-}
 function createTurnMetadata(message, messageId, recordedAt) {
   const event = createAcceptedUserMessageEvent(
     message.message,
@@ -13095,11 +13174,14 @@ function acceptedEventInCodexTranscript(acceptedEvent, transcript) {
 }
 var LAST_MESSAGE_PREVIEW_MAX = 200;
 var MAX_ACCEPTED_SEND_RESPONSES = 50;
+function isForkPreparing(chat) {
+  return chat.persisted.fork?.state === "preparing";
+}
 function hasActiveAgentWork(chat) {
-  return chat.provider.isProcessing() || (chat.provider.hasActiveBackgroundTasks?.() ?? false);
+  return chat.provider.isProcessing() || (chat.provider.hasActiveBackgroundTasks?.() ?? false) || isForkPreparing(chat);
 }
 function hasActiveChatTurn(chat) {
-  return chat.hasActiveTurn || chat.pendingMessageIds.length > 0 || (chat.provider.hasActiveBackgroundTasks?.() ?? false);
+  return chat.hasActiveTurn || chat.pendingMessageIds.length > 0 || (chat.provider.hasActiveBackgroundTasks?.() ?? false) || isForkPreparing(chat);
 }
 function isPersistedChat(value) {
   if (!isRecord2(value)) {
@@ -13120,6 +13202,7 @@ function normalizePersistedChat(chat) {
     parentChatId: chat.parentChatId ?? null,
     lastMessageText: chat.lastMessageText ?? null,
     deletedAt: chat.deletedAt ?? null,
+    fork: coerceChatForkInfo(chat.fork),
     acceptedSendResponses: isRecord2(chat.acceptedSendResponses) ? Object.fromEntries(Object.entries(chat.acceptedSendResponses).filter((entry) => {
       const response = entry[1];
       return isRecord2(response) && typeof response.messageId === "string" && typeof response.queued === "boolean" && typeof response.position === "number";
@@ -13152,13 +13235,13 @@ var ChatService = class {
   persistPromise = null;
   persistQueued = false;
   async initialize() {
-    await mkdir19(ENGINE_DIR2, { recursive: true });
-    await mkdir19(CLAUDE_HISTORY_DIR, { recursive: true });
-    await mkdir19(RELAY_HISTORY_DIR, { recursive: true });
-    await mkdir19(CODEX_HISTORY_DIR, { recursive: true });
-    await mkdir19(CURSOR_HISTORY_DIR, { recursive: true });
-    await mkdir19(OPENCODE_HISTORY_DIR, { recursive: true });
-    await mkdir19(CHAT_SENDERS_DIR, { recursive: true });
+    await mkdir20(ENGINE_DIR2, { recursive: true });
+    await mkdir20(CLAUDE_HISTORY_DIR, { recursive: true });
+    await mkdir20(RELAY_HISTORY_DIR, { recursive: true });
+    await mkdir20(CODEX_HISTORY_DIR, { recursive: true });
+    await mkdir20(CURSOR_HISTORY_DIR, { recursive: true });
+    await mkdir20(OPENCODE_HISTORY_DIR, { recursive: true });
+    await mkdir20(CHAT_SENDERS_DIR, { recursive: true });
     const persisted = await this.loadChats();
     for (const chat of persisted) {
       const runtime = this.createRuntimeChat(chat);
@@ -13231,7 +13314,8 @@ var ChatService = class {
       createdAt: now,
       updatedAt: now,
       providerSessionId: null,
-      parentChatId
+      parentChatId,
+      fork: request.fork ?? null
     };
     const runtime = this.createRuntimeChat(persisted);
     this.chats.set(persisted.id, runtime);
@@ -13331,6 +13415,7 @@ var ChatService = class {
       chat.persisted.updatedAt = previousUpdatedAt;
       throw new ChatMessagePersistenceError(error);
     }
+    chat.lastSendRequest = request;
     this.agentChatActivityTrackerService.noteMessageAccepted(result.messageId, request);
     if (request.errorNotificationTarget) {
       chat.errorNotificationTargets.set(result.messageId, request.errorNotificationTarget);
@@ -13597,13 +13682,115 @@ var ChatService = class {
     return descendants;
   }
   async deleteHistoryFile(persisted) {
-    const historyPath = join28(HISTORY_DIR_BY_PROVIDER[persisted.provider], `${persisted.id}.jsonl`);
+    const historyPath = join30(HISTORY_DIR_BY_PROVIDER[persisted.provider], `${persisted.id}.jsonl`);
     await Promise.all([
       historyPath,
       `${historyPath}.pages.jsonl`,
       `${historyPath}.pages.index.json`
     ].map((path6) => rm3(path6, { force: true })));
     await rm3(chatMessageSendersFilePath(persisted.id), { force: true });
+    await rm3(join30(FORKS_DIR, persisted.id), { recursive: true, force: true });
+  }
+  /** Resolves once the target chat exists; the handoff and its first turn run in the background. */
+  async forkChat(sourceChatId, request, trigger = "manual", reason) {
+    const source = this.requireChat(sourceChatId);
+    if (!isAgentAvailable(request.provider)) throw new ChatProviderUnavailableError(request.provider);
+    const fork = {
+      source: { chatId: source.persisted.id, provider: source.persisted.provider, title: source.persisted.title },
+      trigger,
+      ...reason ? { reason } : {},
+      state: "preparing",
+      startedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    const target = await this.createChat({
+      id: request.id,
+      provider: request.provider,
+      title: request.title?.trim() || defaultForkChatTitle(source.persisted, request.provider),
+      clientRequestId: request.clientRequestId,
+      fork
+    });
+    this.runFork(target.id, request).catch((error) => {
+      console.error("[ChatService] Fork failed:", { sourceChatId, targetChatId: target.id, error });
+    });
+    return target;
+  }
+  async runFork(targetId, request) {
+    const target = this.chats.get(targetId);
+    const fork = target?.persisted.fork;
+    if (!target || !fork) return;
+    try {
+      const handoff = await buildForkHandoff({
+        sourceChatId: fork.source.chatId,
+        sourceProvider: fork.source.provider,
+        targetChatId: targetId,
+        senders: await this.readSenders(fork.source.chatId)
+      });
+      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
+        }),
+        model: request.model,
+        thinkingLevel: request.thinkingLevel,
+        enableInteractiveTools: request.enableInteractiveTools,
+        senderUserId: request.senderUserId,
+        senderEmail: request.senderEmail,
+        senderDisplayName: request.senderDisplayName,
+        senderAvatarUrl: request.senderAvatarUrl,
+        idempotencyKey: `chat-fork:${targetId}`
+      });
+      await this.updateFork(target, { state: "ready", completedAt: (/* @__PURE__ */ new Date()).toISOString() });
+    } catch (error) {
+      if (target.persisted.deletedAt) return;
+      const message = error instanceof Error ? error.message : String(error);
+      await this.updateFork(target, { state: "failed", error: message.slice(0, 500), completedAt: (/* @__PURE__ */ new Date()).toISOString() });
+      throw error;
+    }
+  }
+  async updateFork(chat, patch) {
+    if (!chat.persisted.fork) return;
+    chat.persisted.fork = { ...chat.persisted.fork, ...patch };
+    chat.persisted.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+    await this.persistAllChats();
+    await this.publish({ type: "chat.updated", payload: { chat: this.toSummary(chat) } });
+  }
+  /** Providers of this chat and every chat it was forked from, so a fallback never loops back. */
+  forkChainProviders(chat) {
+    const providers = [chat.persisted.provider];
+    for (let current = chat; current?.persisted.fork; current = this.chats.get(current.persisted.fork.source.chatId)) {
+      providers.push(current.persisted.fork.source.provider);
+    }
+    return providers;
+  }
+  async autoForkAfterQuota(chat, exhaustion) {
+    if (chat.persisted.parentChatId !== null || chat.persisted.deletedAt) return;
+    const alreadyForked = [...this.chats.values()].some((other) => other.persisted.fork?.trigger === "auto" && other.persisted.fork.source.chatId === chat.persisted.id && !other.persisted.deletedAt);
+    if (alreadyForked) return;
+    const last = chat.lastSendRequest;
+    const fallback = await monolithService.getChatForkFallback({
+      provider: chat.persisted.provider,
+      exclude: this.forkChainProviders(chat),
+      userId: last?.senderUserId
+    });
+    if (!fallback?.provider || !isAgentAvailable(fallback.provider)) return;
+    await this.forkChat(chat.persisted.id, {
+      provider: fallback.provider,
+      model: fallback.model,
+      thinkingLevel: fallback.thinkingLevel,
+      enableInteractiveTools: last?.enableInteractiveTools,
+      senderUserId: last?.senderUserId,
+      senderEmail: last?.senderEmail,
+      senderDisplayName: last?.senderDisplayName,
+      senderAvatarUrl: last?.senderAvatarUrl
+    }, "auto", exhaustion.reason);
   }
   async getChatHistory(chatId, page = {}) {
     const chat = this.requireChat(chatId);
@@ -13728,7 +13915,7 @@ var ChatService = class {
     if (persisted.provider === "claude") {
       provider = new ClaudeManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join28(CLAUDE_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join30(CLAUDE_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -13738,18 +13925,18 @@ var ChatService = class {
       });
     } else if (persisted.provider === "relay") {
       const getProviderAvailability = () => ({
-        codexAvailable: isCodexAvailable(),
-        opencodeAvailable: isOpencodeAvailable(),
-        piAvailable: isPiAvailable(),
-        cursorAvailable: isCursorAvailable(),
-        deepseekAvailable: isDeepseekAvailable(),
-        fxAvailable: isFxAvailable(),
-        kimiAvailable: isKimiAvailable(),
-        museAvailable: isMuseAvailable()
+        codexAvailable: isAgentAvailable(AGENT.CODEX),
+        opencodeAvailable: isAgentAvailable(AGENT.OPENCODE),
+        piAvailable: isAgentAvailable(AGENT.PI),
+        cursorAvailable: isAgentAvailable(AGENT.CURSOR),
+        deepseekAvailable: isAgentAvailable(AGENT.DEEPSEEK),
+        fxAvailable: isAgentAvailable(AGENT.FX),
+        kimiAvailable: isAgentAvailable(AGENT.KIMI),
+        museAvailable: isAgentAvailable(AGENT.MUSE)
       });
       provider = new RelayManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join28(RELAY_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join30(RELAY_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -13763,7 +13950,7 @@ var ChatService = class {
     } else if (persisted.provider === "cursor") {
       provider = new CursorManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join28(CURSOR_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join30(CURSOR_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -13775,7 +13962,7 @@ var ChatService = class {
     } else if (persisted.provider === "deepseek") {
       provider = new DeepseekManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join28(DEEPSEEK_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join30(DEEPSEEK_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -13787,7 +13974,7 @@ var ChatService = class {
     } else if (persisted.provider === "fx") {
       provider = new FxManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join28(FX_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join30(FX_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -13798,7 +13985,7 @@ var ChatService = class {
     } else if (persisted.provider === "kimi") {
       provider = new KimiManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join28(KIMI_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join30(KIMI_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -13809,7 +13996,7 @@ var ChatService = class {
     } else if (persisted.provider === "muse") {
       provider = new MuseManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join28(MUSE_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join30(MUSE_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -13821,7 +14008,7 @@ var ChatService = class {
     } else if (persisted.provider === "opencode") {
       provider = new OpencodeManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join28(OPENCODE_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join30(OPENCODE_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -13833,7 +14020,7 @@ var ChatService = class {
     } else if (persisted.provider === "pi") {
       provider = new PiManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join28(PI_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join30(PI_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -13850,7 +14037,7 @@ var ChatService = class {
       );
       provider = new CodexAspManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join28(CODEX_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join30(CODEX_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -13876,7 +14063,9 @@ var ChatService = class {
       observedBranchesByRepo: /* @__PURE__ */ new Map(),
       lastTurnErrors: null,
       errorNotificationTargets: /* @__PURE__ */ new Map(),
-      activeErrorNotificationTarget: null
+      activeErrorNotificationTarget: null,
+      quotaExhaustion: null,
+      lastSendRequest: null
     };
   }
   touch(chat) {
@@ -13900,7 +14089,8 @@ var ChatService = class {
       goal: chat.provider.getGoal?.() ?? null,
       parentChatId: chat.persisted.parentChatId,
       lastMessageText: chat.persisted.lastMessageText ?? null,
-      deletedAt: chat.persisted.deletedAt ?? null
+      deletedAt: chat.persisted.deletedAt ?? null,
+      fork: chat.persisted.fork ?? null
     };
   }
   requireChat(chatId) {
@@ -13977,6 +14167,9 @@ var ChatService = class {
     if (terminalErrors !== void 0) {
       chat.lastTurnErrors = terminalErrors;
     }
+    if (event.type === AGENT_QUOTA_EXHAUSTED_EVENT_TYPE) {
+      chat.quotaExhaustion = agentQuotaExhaustedPayloadSchema.safeParse(event.payload).data ?? null;
+    }
     let eventToPublish = event;
     if (event.type === "event_msg" && event.payload.type === "user_message") {
       if (chat.activeMessageId) {
@@ -14058,7 +14251,7 @@ var ChatService = class {
     });
     uploadChatTranscript(
       chatId,
-      join28(HISTORY_DIR_BY_PROVIDER[chat.persisted.provider], `${chatId}.jsonl`),
+      join30(HISTORY_DIR_BY_PROVIDER[chat.persisted.provider], `${chatId}.jsonl`),
       this.toSummary(chat)
     ).catch((err) => {
       console.error("[ChatService] Failed to upload chat transcript:", { chatId, err });
@@ -14067,6 +14260,13 @@ var ChatService = class {
       console.error("[ChatService] Failed to upload canvas items:", { chatId, err });
     });
     await this.publishAgentTurnCompleteWebhook(chat, completedAt, processing);
+    const exhaustion = chat.quotaExhaustion;
+    chat.quotaExhaustion = null;
+    if (exhaustion) {
+      this.autoForkAfterQuota(chat, exhaustion).catch((error) => {
+        console.error("[ChatService] Automatic fork after quota limit failed:", { chatId, error });
+      });
+    }
   }
   getRuntimeChat(chatId) {
     const chat = this.chats.get(chatId) ?? null;
@@ -14478,20 +14678,20 @@ var RepoFileService = class {
 import { Hono } from "hono";
 import { z as z5 } from "zod";
 import { readdir as readdir11, stat as stat7, readFile as readFile24 } from "fs/promises";
-import { join as join32, resolve as resolve3 } from "path";
+import { join as join34, resolve as resolve3 } from "path";
 
 // src/services/warm-hooks-service.ts
 import { spawn as spawn7 } from "child_process";
 import { readFile as readFile23 } from "fs/promises";
 import { existsSync as existsSync12 } from "fs";
-import { join as join31 } from "path";
+import { join as join33 } from "path";
 
 // src/services/warm-hook-logs-service.ts
-import { mkdir as mkdir20, readFile as readFile22, writeFile as writeFile9, readdir as readdir10, appendFile as appendFile5, unlink as unlink4 } from "fs/promises";
-import { homedir as homedir13 } from "os";
-import { join as join30 } from "path";
-var LOGS_DIR2 = join30(homedir13(), ".replicas", "warm-hook-logs");
-var CURRENT_RUN_LOG = join30(LOGS_DIR2, "current-run.log");
+import { mkdir as mkdir21, readFile as readFile22, writeFile as writeFile10, readdir as readdir10, appendFile as appendFile5, unlink as unlink4 } from "fs/promises";
+import { homedir as homedir14 } from "os";
+import { join as join32 } from "path";
+var LOGS_DIR2 = join32(homedir14(), ".replicas", "warm-hook-logs");
+var CURRENT_RUN_LOG = join32(LOGS_DIR2, "current-run.log");
 var GLOBAL_FILENAME = "global.json";
 function withPreview2(stored) {
   const preview = buildHookOutputPreview(stored.output);
@@ -14499,7 +14699,7 @@ function withPreview2(stored) {
 }
 var WarmHookLogsService = class {
   async ensureDir() {
-    await mkdir20(LOGS_DIR2, { recursive: true });
+    await mkdir21(LOGS_DIR2, { recursive: true });
   }
   async saveGlobalHookLog(entry) {
     await this.ensureDir();
@@ -14508,7 +14708,7 @@ var WarmHookLogsService = class {
       hookName: "organization",
       ...entry
     };
-    await writeFile9(join30(LOGS_DIR2, GLOBAL_FILENAME), `${JSON.stringify(log, null, 2)}
+    await writeFile10(join32(LOGS_DIR2, GLOBAL_FILENAME), `${JSON.stringify(log, null, 2)}
 `, "utf-8");
   }
   async saveEnvironmentHookLog(entry) {
@@ -14518,7 +14718,7 @@ var WarmHookLogsService = class {
       hookName: "environment",
       ...entry
     };
-    await writeFile9(join30(LOGS_DIR2, ENVIRONMENT_HOOK_LOG_FILENAME), `${JSON.stringify(log, null, 2)}
+    await writeFile10(join32(LOGS_DIR2, ENVIRONMENT_HOOK_LOG_FILENAME), `${JSON.stringify(log, null, 2)}
 `, "utf-8");
   }
   async saveRepoHookLog(repoName, entry) {
@@ -14528,7 +14728,7 @@ var WarmHookLogsService = class {
       hookName: repoName,
       ...entry
     };
-    await writeFile9(join30(LOGS_DIR2, repoHookLogFilename(repoName)), `${JSON.stringify(log, null, 2)}
+    await writeFile10(join32(LOGS_DIR2, repoHookLogFilename(repoName)), `${JSON.stringify(log, null, 2)}
 `, "utf-8");
   }
   async getAllLogs() {
@@ -14547,7 +14747,7 @@ var WarmHookLogsService = class {
         continue;
       }
       try {
-        const raw = await readFile22(join30(LOGS_DIR2, file), "utf-8");
+        const raw = await readFile22(join32(LOGS_DIR2, file), "utf-8");
         const stored = JSON.parse(raw);
         logs.push(withPreview2(stored));
       } catch {
@@ -14585,7 +14785,7 @@ var WarmHookLogsService = class {
   async getFullOutput(hookType, hookName) {
     const filename = hookType === "global" ? GLOBAL_FILENAME : hookType === "environment" ? ENVIRONMENT_HOOK_LOG_FILENAME : repoHookLogFilename(hookName);
     try {
-      const raw = await readFile22(join30(LOGS_DIR2, filename), "utf-8");
+      const raw = await readFile22(join32(LOGS_DIR2, filename), "utf-8");
       const stored = JSON.parse(raw);
       if (stored.hookType !== hookType || stored.hookName !== hookName) {
         return null;
@@ -14604,7 +14804,7 @@ var warmHookLogsService = new WarmHookLogsService();
 // src/services/warm-hooks-service.ts
 async function readRepoWarmHook(repoPath) {
   for (const filename of REPLICAS_CONFIG_FILENAMES) {
-    const configPath = join31(repoPath, filename);
+    const configPath = join33(repoPath, filename);
     if (!existsSync12(configPath)) {
       continue;
     }
@@ -15122,6 +15322,22 @@ function createV1Routes(deps) {
       return c.json(jsonError("Invalid chat request", details), 400);
     }
   });
+  app2.post("/chats/:chatId/fork", async (c) => {
+    try {
+      const body = forkChatRequestSchema.strip().parse(await c.req.json());
+      const chat = await deps.chatService.forkChat(c.req.param("chatId"), body);
+      return c.json({ chat }, 201);
+    } catch (error) {
+      const details = error instanceof Error ? error.message : "Unknown error";
+      if (error instanceof ChatNotFoundError) {
+        return c.json(jsonError("Failed to fork chat", details), 404);
+      }
+      if (error instanceof ChatProviderUnavailableError) {
+        return c.json(jsonError("Failed to fork chat", details), 409);
+      }
+      return c.json(jsonError("Failed to fork chat", details), 400);
+    }
+  });
   app2.get("/chats/:chatId", (c) => {
     const chat = deps.chatService.getChat(c.req.param("chatId"));
     if (!chat) {
@@ -15844,7 +16060,7 @@ data: ${JSON.stringify("Terminal session not found")}
       const logFiles = files.filter((f) => f.endsWith(".log"));
       const sessions = await Promise.all(
         logFiles.map(async (filename) => {
-          const filePath = join32(LOG_DIR, filename);
+          const filePath = join34(LOG_DIR, filename);
           const fileStat = await stat7(filePath);
           const sessionId = filename.replace(/\.log$/, "");
           return {
@@ -15950,7 +16166,7 @@ var HeartbeatService = class _HeartbeatService {
 var heartbeatService = new HeartbeatService();
 
 // src/services/workspace-sdk-service.ts
-import { cp, mkdir as mkdir21 } from "fs/promises";
+import { cp, mkdir as mkdir22 } from "fs/promises";
 import { dirname as dirname12, resolve as resolve4 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 async function installWorkspaceSdk() {
@@ -15960,7 +16176,7 @@ async function installWorkspaceSdk() {
     "/tmp/node_modules/@replicas/sdk"
   ];
   await Promise.all(targets.map(async (target) => {
-    await mkdir21(target, { recursive: true });
+    await mkdir22(target, { recursive: true });
     await cp(source, target, { recursive: true, force: true });
   }));
 }