replicas-engine 0.1.400 → 0.1.403

package/dist/src/index.js

@@ -484,7 +484,7 @@ var WORKSPACE_SIZES = ["small", "large"];
 var INVALID_WORKSPACE_SIZE_ERROR = `Invalid size: must be one of ${WORKSPACE_SIZES.join(", ")}`;
 
 // ../shared/src/e2b.ts
-var E2B_TEMPLATE_NAME = "replicas-sandbox-2026-07-06-v2";
+var E2B_TEMPLATE_NAME = "replicas-sandbox-2026-07-06-v5";
 
 // ../shared/src/runtime-env.ts
 function parsePosixEnvFile(content) {
@@ -647,8 +647,8 @@ var SLASH_COMMANDS = [
   },
   {
     command: "/goal",
-    description: "Set or clear a task goal.",
-    argumentHint: "<objective | clear>",
+    description: "Set, pause, resume, or clear a task goal.",
+    argumentHint: "<objective | pause | resume | clear>",
     providers: ["codex"]
   }
 ];
@@ -667,19 +667,23 @@ function getSlashCommandsForProvider(provider, commands = SLASH_COMMANDS) {
   return commands.filter((command) => command.providers.includes(provider));
 }
 var MAX_CODEX_GOAL_OBJECTIVE_CHARS = 4e3;
+function classifyGoalValue(value) {
+  if (/^(clear|reset|unset)$/i.test(value)) return { type: "clear" };
+  if (/^pause$/i.test(value)) return { type: "pause" };
+  if (/^resume$/i.test(value)) return { type: "resume" };
+  return { type: "set", objective: value };
+}
 function parseGoalCommand(message) {
   const match = message.trim().match(/^\/goal(?:\s+([\s\S]*))?$/i);
   const value = match?.[1]?.trim();
   if (!value) return null;
-  if (/^(clear|reset|unset)$/i.test(value)) return { type: "clear" };
-  return { type: "set", objective: value };
+  return classifyGoalValue(value);
 }
 function getGoalCommand(message, goalMode) {
   if (!goalMode) return parseGoalCommand(message);
   const value = message.trim();
   if (!value) return null;
-  if (/^(clear|reset|unset)$/i.test(value)) return { type: "clear" };
-  return { type: "set", objective: value };
+  return classifyGoalValue(value);
 }
 function getGoalCommandObjectiveValidationError(message, goalMode) {
   const command = getGoalCommand(message, goalMode);
@@ -1415,8 +1419,67 @@ var GOOGLE_ABILITY = {
   referenceFile: { name: "GOOGLE.md", content: REFERENCE5 }
 };
 
+// ../shared/src/default-skills/replicas-agent/abilities/learnings.ts
+var SECTION6 = `### Learnings
+Curated, human-approved organization knowledge that helps you execute correctly \u2014 conventions, gotchas, environment facts, and past user corrections that the codebase alone can't tell you.
+
+**Reference:** \`references/LEARNINGS.md\`
+
+Use this when:
+- You are starting a substantive task and have gathered enough context to write a meaningful query
+- A user corrects you about a durable fact, preference, or process worth keeping
+- You find an existing learning contradicted by the current code or docs`;
+var REFERENCE6 = `# Learnings
+
+Learnings are curated, human-approved knowledge entries your organization maintains: conventions, gotchas, environment facts, and process rules. Some entries always apply; contextual entries are retrieved by matching your query against their trigger descriptions.
+
+## Reading Learnings
+
+\`\`\`bash
+replicas learnings read --query "<enriched query>"
+\`\`\`
+
+**When to read:** once you've collected enough context to write a meaningful query \u2014 typically after your first look at the relevant code. Don't wait until you're deep into execution; learnings are most valuable before you commit to an approach.
+
+**Enrich the query.** Use codebase specifics (feature area, module/component names), not the raw user request. Triggers describe *situations*, so a query grounded in what the task actually touches matches far better.
+
+Example: the user asks "remove the PRs chart projections". After locating the chart you know it lives in the platform admin dashboard, so query:
+
+\`\`\`bash
+replicas learnings read --query "Remove the PRs chart in the platform admin dashboard"
+\`\`\`
+
+This matches a learning triggered on "UI/UX work on the admin panel" that the raw request would have missed.
+
+Output is a list of blocks \u2014 id, name, and content. Use the ids to propose updates or deletions.
+
+## Proposing changes
+
+All writes are proposals: a human reviews them in the dashboard, and nothing takes effect until approved.
+
+\`\`\`bash
+replicas learnings add --name "<short name>" --content "<the knowledge>" [--trigger "<when to surface it>"] [--always] [--global]
+replicas learnings update <id> [--name "..."] [--content "..."] [--trigger "..."] [--always true|false]
+replicas learnings delete <id>
+\`\`\`
+
+\`--always\` marks an entry as always-returned (no trigger needed); \`--global\` proposes org-wide scope instead of this workspace's environment.
+
+**Be very conservative:**
+- Propose \`add\` only for durable, org-useful facts: explicit user corrections, hard-won environment or process knowledge.
+- Never store task-specific details, anything derivable by reading the repo, or secrets/credentials.
+- Propose \`update\` or \`delete\` when a learning is contradicted by the current code or docs \u2014 flag outdated knowledge instead of silently ignoring it.
+- Write narrow triggers describing when the entry should surface (e.g. "UI/UX work on the admin panel"), not vague topics.`;
+var LEARNINGS_ABILITY = {
+  label: "Learnings",
+  description: "Fetch curated org knowledge and propose new learnings for human review.",
+  bullet: "- Fetching organization Learnings (curated, human-approved knowledge) before executing, or proposing new ones",
+  section: SECTION6,
+  referenceFile: { name: "LEARNINGS.md", content: REFERENCE6 }
+};
+
 // ../shared/src/default-skills/replicas-agent/abilities/linear.ts
-var SECTION6 = `### Linear
+var SECTION7 = `### Linear
 Fetch issues, update state, add comments, and search via the Linear GraphQL API.
 
 **Reference:** \`references/LINEAR.md\`
@@ -1425,7 +1488,7 @@ Use this when:
 - You encounter a Linear issue link and need to understand the task
 - You need to update an issue's state (e.g. mark as done)
 - You need to comment on or search for Linear issues`;
-var REFERENCE6 = `# Linear Integration
+var REFERENCE7 = `# Linear Integration
 
 This guide covers how to interact with Linear from within your Replicas workspace.
 
@@ -1514,12 +1577,12 @@ var LINEAR_ABILITY = {
   label: "Linear",
   description: "Fetch issues, post comments, update states via the Linear GraphQL API.",
   bullet: "- Interacting with Linear (fetching issues, updating state, commenting, etc.)",
-  section: SECTION6,
-  referenceFile: { name: "LINEAR.md", content: REFERENCE6 }
+  section: SECTION7,
+  referenceFile: { name: "LINEAR.md", content: REFERENCE7 }
 };
 
 // ../shared/src/default-skills/replicas-agent/abilities/media.ts
-var SECTION7 = `### Media
+var SECTION8 = `### Media
 Share screenshots, screen recordings, generated diagrams, and audio clips inline in the Replicas chat and natively embedded in external messages.
 
 **Reference:** \`references/MEDIA.md\`
@@ -1528,7 +1591,7 @@ Use this when:
 - You produce a screenshot, recording, generated image, or audio clip the user should see
 - You record video output (browser automation, screen capture) \u2014 including the recommended aspect ratio and FPS
 - You need to embed media in a Slack/Linear/GitHub message AND keep a referenceable copy in the Replicas dashboard`;
-var REFERENCE7 = `# Media (Screenshots, Recordings, Audio)
+var REFERENCE8 = `# Media (Screenshots, Recordings, Audio)
 
 This guide covers how to share screenshots, screen recordings, generated diagrams, and audio clips \u2014 both inline in the Replicas chat and natively embedded in external surfaces (Slack, Linear, GitHub).
 
@@ -1780,12 +1843,12 @@ var MEDIA_ABILITY = {
   label: "Media",
   description: "Share screenshots, recordings, generated images, and audio clips.",
   bullet: "- Producing or showing the user any media \u2014 screenshots, screen recordings, generated images or diagrams, audio clips \u2014 including in your Replicas chat reply, PR descriptions/comments, and other external platforms",
-  section: SECTION7,
-  referenceFile: { name: "MEDIA.md", content: REFERENCE7 }
+  section: SECTION8,
+  referenceFile: { name: "MEDIA.md", content: REFERENCE8 }
 };
 
 // ../shared/src/default-skills/replicas-agent/abilities/previews.ts
-var SECTION8 = `### Previews
+var SECTION9 = `### Previews
 Expose locally running services (web apps, APIs, databases) as public preview URLs so humans can interact with them directly.
 
 **Reference:** \`references/PREVIEWS.md\`
@@ -1794,7 +1857,7 @@ Use this when:
 - You need to start a service that a human should view or interact with
 - The task involves UI work that benefits from human review
 - You are verifying frontend/backend integrations visually`;
-var REFERENCE8 = `# Preview URLs
+var REFERENCE9 = `# Preview URLs
 
 When you run services on ports \u2014 such as a web app, API server, or database \u2014 humans may want to interact with them directly. You can expose your locally running services as public preview URLs.
 
@@ -1876,12 +1939,12 @@ var PREVIEWS_ABILITY = {
   label: "Previews",
   description: "Expose locally running services on public preview URLs for humans.",
   bullet: "- Creating preview URLs for locally running services",
-  section: SECTION8,
-  referenceFile: { name: "PREVIEWS.md", content: REFERENCE8 }
+  section: SECTION9,
+  referenceFile: { name: "PREVIEWS.md", content: REFERENCE9 }
 };
 
 // ../shared/src/default-skills/replicas-agent/abilities/replicas.ts
-var SECTION9 = `### Replicas (in-workspace CLI)
+var SECTION10 = `### Replicas (in-workspace CLI)
 Take action *with* Replicas itself \u2014 manage automations, environments (variables, files), repos, and \`replicas.json\` config \u2014 using the pre-installed, pre-authenticated \`replicas\` CLI.
 
 **Reference:** \`references/REPLICAS.md\`
@@ -1891,7 +1954,7 @@ Use this when:
 - The user asks you to manage environments, environment variables, or environment files
 - The user asks "what envs / repos / automations do I have?"
 - The user asks you to scaffold a \`replicas.json\` / \`replicas.yaml\` in a repo`;
-var REFERENCE9 = `# Replicas (in-workspace CLI)
+var REFERENCE10 = `# Replicas (in-workspace CLI)
 
 This guide covers how to take action *with* Replicas itself from inside a Replicas workspace \u2014 managing automations, environments (and their variables/files), repos, previews, and the user's \`replicas.json\` config \u2014 using the pre-installed \`replicas\` CLI.
 
@@ -2093,13 +2156,13 @@ var REPLICAS_ABILITY = {
   description: "Teach the agent about Replicas itself \u2014 automations, environments, the in-workspace CLI.",
   // No bullet — help_instructions covers the `replicas` CLI surface in detail.
   bullet: "",
-  section: SECTION9,
-  referenceFile: { name: "REPLICAS.md", content: REFERENCE9 },
+  section: SECTION10,
+  referenceFile: { name: "REPLICAS.md", content: REFERENCE10 },
   locked: true
 };
 
 // ../shared/src/default-skills/replicas-agent/abilities/slack.ts
-var SECTION10 = `### Slack
+var SECTION11 = `### Slack
 Send messages, read threads, search conversations, and upload files via the Slack Web API.
 
 **Reference:** \`references/SLACK.md\`
@@ -2109,7 +2172,7 @@ Use this when:
 - You need to read or fetch a Slack conversation
 - You encounter a Slack message link and need to retrieve its content
 - The task asks you to notify, update, or communicate via Slack`;
-var REFERENCE10 = `# Slack Integration
+var REFERENCE11 = `# Slack Integration
 
 This guide covers how to interact with Slack from within your Replicas workspace.
 
@@ -2210,8 +2273,8 @@ var SLACK_ABILITY = {
   label: "Slack",
   description: "Send messages, read threads, search conversations, upload files.",
   bullet: "- Interacting with Slack (sending messages, reading threads, etc.)",
-  section: SECTION10,
-  referenceFile: { name: "SLACK.md", content: REFERENCE10 }
+  section: SECTION11,
+  referenceFile: { name: "SLACK.md", content: REFERENCE11 }
 };
 
 // ../shared/src/default-skills/replicas-agent/registry.ts
@@ -2222,6 +2285,7 @@ var REPLICAS_AGENT_ABILITY_REGISTRY = {
   github: GITHUB_ABILITY,
   gitlab: GITLAB_ABILITY,
   google: GOOGLE_ABILITY,
+  learnings: LEARNINGS_ABILITY,
   linear: LINEAR_ABILITY,
   media: MEDIA_ABILITY,
   previews: PREVIEWS_ABILITY,
@@ -2970,6 +3034,7 @@ function parseAgentEventJsonl(content, options = {}) {
 function parseAgentEventJsonlWithCodexAspTranscript(content, options = {}) {
   const events = [];
   let transcript = null;
+  const transcriptsByThreadId = /* @__PURE__ */ new Map();
   for (const event of parseAgentEventJsonl(content, options)) {
     if (event.type !== CODEX_ASP_TRANSCRIPT_UPDATED_EVENT_TYPE) {
       events.push(event);
@@ -2977,12 +3042,16 @@ function parseAgentEventJsonlWithCodexAspTranscript(content, options = {}) {
     }
     const delta = event.payload.transcriptDelta;
     if (isCodexAspTranscriptDelta(delta)) {
-      transcript = applyCodexAspTranscriptDelta(transcript, delta);
+      const previous = transcriptsByThreadId.get(delta.threadId) ?? null;
+      transcript = applyCodexAspTranscriptDelta(previous, delta);
     } else if (isCodexAspTranscript(event.payload.transcript)) {
       transcript = event.payload.transcript;
     }
+    if (transcript) {
+      transcriptsByThreadId.set(transcript.threadId, transcript);
+    }
   }
-  return { events, transcript };
+  return { events, transcript, transcriptsByThreadId };
 }
 
 // ../shared/src/display-message/parsers/codex-asp-parser.ts
@@ -4681,6 +4750,7 @@ var EnvironmentDetailsService = class {
     ]);
     details.engineVersion = E2B_TEMPLATE_NAME;
     details.supportsMidTurnSteering = true;
+    details.supportsGoalUpdates = true;
     details.claudeAuthMethod = detectClaudeAuthMethod();
     details.codexAuthMethod = detectCodexAuthMethod();
     details.cursorAuthMethod = detectCursorAuthMethod();
@@ -5436,8 +5506,8 @@ async function registerDesktopPreview() {
 // src/services/chat/chat-service.ts
 import { existsSync as existsSync7 } from "fs";
 import { appendFile as appendFile3, copyFile, mkdir as mkdir13, readFile as readFile14, rename as rename2, rm } from "fs/promises";
-import { homedir as homedir14 } from "os";
-import { join as join19 } from "path";
+import { homedir as homedir15 } from "os";
+import { join as join21 } from "path";
 import { randomUUID as randomUUID5 } from "crypto";
 
 // src/managers/claude-manager.ts
@@ -6639,7 +6709,7 @@ var CodexHistoryFile = class {
       if (!(error && typeof error === "object" && "code" in error && error.code === "ENOENT")) {
         console.error("[CodexHistoryFile] Failed to load history file:", error);
       }
-      return { events: [], transcript: null };
+      return { events: [], transcript: null, transcriptsByThreadId: /* @__PURE__ */ new Map() };
     }
   }
 };
@@ -7744,6 +7814,10 @@ var ClaudeManager = class _ClaudeManager extends CodingAgentManager {
   }
 };
 
+// src/managers/codex-asp/codex-asp-manager.ts
+import { readdir as readdir4 } from "fs/promises";
+import { join as join16 } from "path";
+
 // src/managers/codex-asp/app-server-process.ts
 import { spawn as spawn3 } from "child_process";
 import { EventEmitter as EventEmitter2 } from "events";
@@ -7940,7 +8014,7 @@ var AspClient = class {
 // src/managers/codex-asp/app-server-process.ts
 var DEFAULT_CODEX_BINARY = "codex";
 var DEFAULT_CODEX_ARGS = ["app-server", "--listen", "stdio://"];
-var ENGINE_PACKAGE_VERSION = "0.1.400";
+var ENGINE_PACKAGE_VERSION = "0.1.403";
 var INITIALIZE_METHOD = "initialize";
 var INITIALIZED_NOTIFICATION = "initialized";
 var ACCOUNT_LOGIN_START_METHOD = "account/login/start";
@@ -8374,6 +8448,7 @@ function itemToTranscriptItem(item, timestamp, status) {
         description: item.receiverThreadIds.length === 1 ? "Codex subagent" : `Codex subagents (${item.receiverThreadIds.length})`,
         prompt: item.prompt ?? "",
         subagentType: "codex",
+        receiverThreadIds: item.receiverThreadIds,
         ...item.model ? { model: item.model } : {},
         output: stringifyCollabAgentStates(item.agentsStates),
         timestamp,
@@ -8772,9 +8847,84 @@ var TranscriptUpdateCoalescer = class {
   }
 };
 
+// src/services/chat/history-paths.ts
+import { homedir as homedir12 } from "os";
+import { join as join15 } from "path";
+var ENGINE_DIR2 = join15(homedir12(), ".replicas", "engine");
+var CHATS_FILE = join15(ENGINE_DIR2, "chats.json");
+var CLAUDE_HISTORY_DIR = join15(ENGINE_DIR2, "claude-histories");
+var RELAY_HISTORY_DIR = join15(ENGINE_DIR2, "relay-histories");
+var CODEX_HISTORY_DIR = join15(ENGINE_DIR2, "codex-histories");
+var CURSOR_HISTORY_DIR = join15(ENGINE_DIR2, "cursor-histories");
+var OPENCODE_HISTORY_DIR = join15(ENGINE_DIR2, "opencode-histories");
+var HISTORY_DIR_BY_PROVIDER = {
+  claude: CLAUDE_HISTORY_DIR,
+  relay: RELAY_HISTORY_DIR,
+  codex: CODEX_HISTORY_DIR,
+  cursor: CURSOR_HISTORY_DIR,
+  opencode: OPENCODE_HISTORY_DIR
+};
+
+// src/services/chat/errors.ts
+var ChatNotFoundError = class extends Error {
+  constructor(chatId) {
+    super(`Chat not found: ${chatId}`);
+    this.name = "ChatNotFoundError";
+  }
+};
+var CodexThreadNotFoundError = class extends Error {
+  constructor(threadId) {
+    super(`Codex thread history not found: ${threadId}`);
+    this.name = "CodexThreadNotFoundError";
+  }
+};
+var DefaultChatDeletionError = class extends Error {
+  constructor() {
+    super("Default chats cannot be deleted");
+    this.name = "DefaultChatDeletionError";
+  }
+};
+var ChatProcessingDeletionError = class extends Error {
+  constructor() {
+    super("Cannot delete a chat while it is processing");
+    this.name = "ChatProcessingDeletionError";
+  }
+};
+var DuplicateDefaultChatError = class extends Error {
+  constructor(provider) {
+    super(`Default chat already exists for provider: ${provider}`);
+    this.name = "DuplicateDefaultChatError";
+  }
+};
+
 // src/managers/codex-asp/codex-asp-manager.ts
 var GOAL_TURN_CONTINUATION_GRACE_MS = 5e3;
 var CODEX_SLASH_COMMANDS_CACHE_MS = 3e4;
+async function readCodexAspThreadHistory(threadId) {
+  let entries;
+  try {
+    entries = await readdir4(CODEX_HISTORY_DIR, { withFileTypes: true });
+  } catch (error) {
+    if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
+      throw new CodexThreadNotFoundError(threadId);
+    }
+    throw error;
+  }
+  for (const entry of entries) {
+    if (!entry.isFile() || !entry.name.endsWith(".jsonl")) continue;
+    const history = await new CodexHistoryFile(join16(CODEX_HISTORY_DIR, entry.name)).load();
+    const transcript = history.transcriptsByThreadId.get(threadId);
+    if (transcript) {
+      return {
+        thread_id: threadId,
+        events: [],
+        codexAspTranscript: transcript,
+        goal: null
+      };
+    }
+  }
+  throw new CodexThreadNotFoundError(threadId);
+}
 function skillToSlashCommand(skill) {
   if (!skill.enabled) return null;
   const description = skill.interface?.shortDescription ?? skill.shortDescription ?? skill.description;
@@ -8959,6 +9109,21 @@ var CodexAspManager = class extends CodingAgentManager {
     this.recordGoalChange(null, true);
     return null;
   }
+  async updateGoal(request) {
+    await this.initialized;
+    if (!this.currentThreadId) return null;
+    const host = await getCodexAspHost();
+    const response = await host.client.request(
+      THREAD_GOAL_SET_METHOD,
+      {
+        threadId: this.currentThreadId,
+        ...request.objective !== void 0 ? { objective: request.objective } : {},
+        ...request.status !== void 0 ? { status: request.status } : {}
+      }
+    );
+    this.recordGoalChange(response.goal, true);
+    return this.currentGoal;
+  }
   recordUserMessageEvent(request, extraPayload = {}) {
     const images = imageContentToUserMessageImages(request.images);
     this.recordHistoryEvent("event_msg", {
@@ -8981,6 +9146,14 @@ var CodexAspManager = class extends CodingAgentManager {
         await this.executeGoalClearCommand(request, recordUserMessage);
         return;
       }
+      if (goalCommand?.type === "pause" || goalCommand?.type === "resume") {
+        await this.executeGoalStatusCommand(
+          request,
+          recordUserMessage,
+          goalCommand.type === "pause" ? "paused" : "active"
+        );
+        return;
+      }
       if (goalCommand?.type === "set") {
         await this.executeAspTurn(request, recordUserMessage, {
           runTurn: (host, threadId) => this.runGoalTurn(host, threadId, request, goalCommand.objective),
@@ -9013,16 +9186,28 @@ var CodexAspManager = class extends CodingAgentManager {
     }
   }
   async executeGoalClearCommand(request, recordUserMessage) {
-    const host = await getCodexAspHost();
-    const developerInstructions = this.buildCombinedInstructions(request.customInstructions);
-    recordUserMessage({ command: "goal" });
-    const threadId = await this.ensureThread(host, request, developerInstructions);
+    const { host, threadId } = await this.prepareGoalCommand(request, recordUserMessage);
     await host.client.request(
       THREAD_GOAL_CLEAR_METHOD,
       { threadId }
     );
     this.recordGoalChange(null, true);
   }
+  async executeGoalStatusCommand(request, recordUserMessage, status) {
+    const { host, threadId } = await this.prepareGoalCommand(request, recordUserMessage);
+    const response = await host.client.request(
+      THREAD_GOAL_SET_METHOD,
+      { threadId, status }
+    );
+    this.recordGoalChange(response.goal, true);
+  }
+  async prepareGoalCommand(request, recordUserMessage) {
+    const host = await getCodexAspHost();
+    const developerInstructions = this.buildCombinedInstructions(request.customInstructions);
+    recordUserMessage({ command: "goal" });
+    const threadId = await this.ensureThread(host, request, developerInstructions);
+    return { host, threadId };
+  }
   async executeAspTurn(request, recordUserMessage, options = {}) {
     const host = await getCodexAspHost();
     if (this.quotaStatus.blocked && this.quotaStatus.latestSnapshot) {
@@ -9920,8 +10105,8 @@ var CodexAspManager = class extends CodingAgentManager {
 };
 
 // src/managers/cursor-manager.ts
-import { mkdir as mkdir11, readFile as readFile10, readdir as readdir4 } from "fs/promises";
-import { basename, dirname as dirname5, extname, join as join15 } from "path";
+import { mkdir as mkdir11, readFile as readFile10, readdir as readdir5 } from "fs/promises";
+import { basename, dirname as dirname5, extname, join as join17 } from "path";
 import { parse as parseYaml2 } from "yaml";
 import { Agent as CursorAgent } from "@cursor/sdk";
 var CURSOR_SLASH_COMMANDS_CACHE_MS = 3e4;
@@ -9948,7 +10133,7 @@ function extractCursorCommandDescription(content) {
 async function listCursorCommandsInDirectory(directory) {
   let entries;
   try {
-    entries = await readdir4(directory, { withFileTypes: true });
+    entries = await readdir5(directory, { withFileTypes: true });
   } catch (error) {
     if (isRecord4(error) && error.code === "ENOENT") return [];
     console.warn("[CursorManager] Failed to read slash command directory:", error);
@@ -9958,7 +10143,7 @@ async function listCursorCommandsInDirectory(directory) {
     const name = basename(entry.name, ".md");
     let description;
     try {
-      description = extractCursorCommandDescription(await readFile10(join15(directory, entry.name), "utf8"));
+      description = extractCursorCommandDescription(await readFile10(join17(directory, entry.name), "utf8"));
     } catch (error) {
       console.warn("[CursorManager] Failed to read slash command file:", error);
     }
@@ -9976,7 +10161,7 @@ var CursorManager = class extends CodingAgentManager {
   slashCommandsRequest = null;
   constructor(options) {
     super(options);
-    this.historyFilePath = options.historyFilePath ?? join15(ENGINE_ENV.HOME_DIR, ".replicas", "cursor", "history.jsonl");
+    this.historyFilePath = options.historyFilePath ?? join17(ENGINE_ENV.HOME_DIR, ".replicas", "cursor", "history.jsonl");
     this.historyFile = new CodexHistoryFile(this.historyFilePath);
     this.initializeManager(this.processMessageInternal.bind(this));
   }
@@ -10004,8 +10189,8 @@ var CursorManager = class extends CodingAgentManager {
     this.slashCommandsRequest ??= (async () => {
       try {
         const commands = mergeSlashCommands(
-          await listCursorCommandsInDirectory(join15(this.workingDirectory, ".cursor", "commands")),
-          await listCursorCommandsInDirectory(join15(ENGINE_ENV.HOME_DIR, ".cursor", "commands"))
+          await listCursorCommandsInDirectory(join17(this.workingDirectory, ".cursor", "commands")),
+          await listCursorCommandsInDirectory(join17(ENGINE_ENV.HOME_DIR, ".cursor", "commands"))
         );
         this.slashCommandsCache = { commands, expiresAt: Date.now() + CURSOR_SLASH_COMMANDS_CACHE_MS };
         return commands;
@@ -10155,7 +10340,7 @@ var CursorManager = class extends CodingAgentManager {
 
 // src/managers/opencode-manager.ts
 import { mkdir as mkdir12, readFile as readFile11 } from "fs/promises";
-import { delimiter, dirname as dirname6, join as join16 } from "path";
+import { delimiter, dirname as dirname6, join as join18 } from "path";
 import { randomBytes as randomBytes2 } from "crypto";
 import { fileURLToPath } from "url";
 import { Agent } from "undici";
@@ -10164,7 +10349,7 @@ import {
   createOpencodeServer
 } from "@opencode-ai/sdk/v2";
 var OPENCODE_SHIM_DIR = dirname6(fileURLToPath(new URL("../../scripts/opencode", import.meta.url)));
-var OPENCODE_CONFIG_PATH = join16(ENGINE_ENV.HOME_DIR, ".config", "opencode", "opencode.json");
+var OPENCODE_CONFIG_PATH = join18(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";
@@ -10319,7 +10504,7 @@ var OpencodeManager = class extends CodingAgentManager {
   constructor(options) {
     super(options);
     this.sessionId = options.initialSessionId;
-    this.historyFilePath = options.historyFilePath ?? join16(ENGINE_ENV.HOME_DIR, ".replicas", "opencode", "history.jsonl");
+    this.historyFilePath = options.historyFilePath ?? join18(ENGINE_ENV.HOME_DIR, ".replicas", "opencode", "history.jsonl");
     this.historyFile = new CodexHistoryFile(this.historyFilePath);
     this.initializeManager(this.processMessageInternal.bind(this));
   }
@@ -11257,12 +11442,12 @@ var KeepAliveService = class _KeepAliveService {
 var keepAliveService = new KeepAliveService();
 
 // src/services/canvas-service.ts
-import { readdir as readdir5, readFile as readFile12, stat as stat3 } from "fs/promises";
-import { homedir as homedir12 } from "os";
-import { join as join17 } from "path";
+import { readdir as readdir6, readFile as readFile12, stat as stat3 } from "fs/promises";
+import { homedir as homedir13 } from "os";
+import { join as join19 } from "path";
 var CANVAS_DIRECTORIES = [
-  join17(homedir12(), ".claude", "plans"),
-  join17(homedir12(), ".replicas", "canvas")
+  join19(homedir13(), ".claude", "plans"),
+  join19(homedir13(), ".replicas", "canvas")
 ];
 var CanvasService = class {
   async listItems() {
@@ -11270,7 +11455,7 @@ var CanvasService = class {
     for (const directory of CANVAS_DIRECTORIES) {
       let entries;
       try {
-        entries = await readdir5(directory, { withFileTypes: true });
+        entries = await readdir6(directory, { withFileTypes: true });
       } catch {
         continue;
       }
@@ -11281,7 +11466,7 @@ var CanvasService = class {
         const { kind } = classifyCanvasFilename(entry.name);
         let sizeBytes = 0;
         try {
-          const s = await stat3(join17(directory, entry.name));
+          const s = await stat3(join19(directory, entry.name));
           sizeBytes = s.size;
         } catch {
           continue;
@@ -11296,7 +11481,7 @@ var CanvasService = class {
     if (!safe) return null;
     const { kind, mimeType } = classifyCanvasFilename(safe);
     for (const directory of CANVAS_DIRECTORIES) {
-      const filePath = join17(directory, safe);
+      const filePath = join19(directory, safe);
       let sizeBytes = 0;
       let updatedAt = "";
       try {
@@ -11432,14 +11617,14 @@ async function reconcileCanvasItems(filenames) {
 }
 
 // src/services/upload-chat-transcripts.ts
-import { readdir as readdir6, readFile as readFile13 } from "fs/promises";
-import { basename as basename2, join as join18 } from "path";
-import { homedir as homedir13 } from "os";
-var ENGINE_DIR2 = join18(homedir13(), ".replicas", "engine");
+import { readdir as readdir7, readFile as readFile13 } from "fs/promises";
+import { basename as basename2, join as join20 } from "path";
+import { homedir as homedir14 } from "os";
+var ENGINE_DIR3 = join20(homedir14(), ".replicas", "engine");
 var HISTORY_DIRS = [
-  join18(ENGINE_DIR2, "claude-histories"),
-  join18(ENGINE_DIR2, "relay-histories"),
-  join18(ENGINE_DIR2, "codex-histories")
+  join20(ENGINE_DIR3, "claude-histories"),
+  join20(ENGINE_DIR3, "relay-histories"),
+  join20(ENGINE_DIR3, "codex-histories")
 ];
 async function flushAllChatTranscripts(chatsById = /* @__PURE__ */ new Map()) {
   let flushed = 0;
@@ -11448,7 +11633,7 @@ async function flushAllChatTranscripts(chatsById = /* @__PURE__ */ new Map()) {
   for (const dir of HISTORY_DIRS) {
     let entries;
     try {
-      entries = await readdir6(dir);
+      entries = await readdir7(dir);
     } catch {
       continue;
     }
@@ -11456,7 +11641,7 @@ async function flushAllChatTranscripts(chatsById = /* @__PURE__ */ new Map()) {
       if (!entry.endsWith(".jsonl")) continue;
       const chatId = basename2(entry, ".jsonl");
       tasks.push(
-        uploadChatTranscript(chatId, join18(dir, entry), chatsById.get(chatId)).then(() => {
+        uploadChatTranscript(chatId, join20(dir, entry), chatsById.get(chatId)).then(() => {
           flushed++;
         }).catch((err) => {
           failed++;
@@ -11499,50 +11684,10 @@ async function uploadChatTranscript(chatId, filePath, chat) {
   }
 }
 
-// src/services/chat/errors.ts
-var ChatNotFoundError = class extends Error {
-  constructor(chatId) {
-    super(`Chat not found: ${chatId}`);
-    this.name = "ChatNotFoundError";
-  }
-};
-var DefaultChatDeletionError = class extends Error {
-  constructor() {
-    super("Default chats cannot be deleted");
-    this.name = "DefaultChatDeletionError";
-  }
-};
-var ChatProcessingDeletionError = class extends Error {
-  constructor() {
-    super("Cannot delete a chat while it is processing");
-    this.name = "ChatProcessingDeletionError";
-  }
-};
-var DuplicateDefaultChatError = class extends Error {
-  constructor(provider) {
-    super(`Default chat already exists for provider: ${provider}`);
-    this.name = "DuplicateDefaultChatError";
-  }
-};
-
 // src/services/chat/chat-service.ts
-var ENGINE_DIR3 = join19(homedir14(), ".replicas", "engine");
-var CHATS_FILE = join19(ENGINE_DIR3, "chats.json");
-var CLAUDE_HISTORY_DIR = join19(ENGINE_DIR3, "claude-histories");
-var RELAY_HISTORY_DIR = join19(ENGINE_DIR3, "relay-histories");
-var CODEX_HISTORY_DIR = join19(ENGINE_DIR3, "codex-histories");
-var CURSOR_HISTORY_DIR = join19(ENGINE_DIR3, "cursor-histories");
-var OPENCODE_HISTORY_DIR = join19(ENGINE_DIR3, "opencode-histories");
-var HISTORY_DIR_BY_PROVIDER = {
-  claude: CLAUDE_HISTORY_DIR,
-  relay: RELAY_HISTORY_DIR,
-  codex: CODEX_HISTORY_DIR,
-  cursor: CURSOR_HISTORY_DIR,
-  opencode: OPENCODE_HISTORY_DIR
-};
-var CHAT_SENDERS_DIR = join19(ENGINE_DIR3, "chat-senders");
-var CODEX_AUTH_PATH2 = join19(homedir14(), ".codex", "auth.json");
-var OPENCODE_AUTH_PATH2 = join19(homedir14(), ".local", "share", "opencode", "auth.json");
+var CHAT_SENDERS_DIR = join21(ENGINE_DIR2, "chat-senders");
+var CODEX_AUTH_PATH2 = join21(homedir15(), ".codex", "auth.json");
+var OPENCODE_AUTH_PATH2 = join21(homedir15(), ".local", "share", "opencode", "auth.json");
 var CHATS_BACKUP_FILE = `${CHATS_FILE}.bak`;
 function isChatMessageSender(value) {
   if (!isRecord4(value)) return false;
@@ -11646,7 +11791,7 @@ var ChatService = class {
   persistInFlight = false;
   persistQueued = false;
   async initialize() {
-    await mkdir13(ENGINE_DIR3, { recursive: true });
+    await mkdir13(ENGINE_DIR2, { recursive: true });
     await mkdir13(CLAUDE_HISTORY_DIR, { recursive: true });
     await mkdir13(RELAY_HISTORY_DIR, { recursive: true });
     await mkdir13(CODEX_HISTORY_DIR, { recursive: true });
@@ -11781,7 +11926,7 @@ var ChatService = class {
     };
   }
   senderFilePath(chatId) {
-    return join19(CHAT_SENDERS_DIR, `${chatId}.jsonl`);
+    return join21(CHAT_SENDERS_DIR, `${chatId}.jsonl`);
   }
   async appendSender(chatId, sender) {
     try {
@@ -11863,6 +12008,16 @@ var ChatService = class {
       goal
     };
   }
+  async updateGoal(chatId, request) {
+    const chat = this.requireChat(chatId);
+    const goal = chat.provider.updateGoal ? await chat.provider.updateGoal(request) : null;
+    this.touch(chat);
+    await this.publish({
+      type: "chat.updated",
+      payload: { chat: this.toSummary(chat) }
+    });
+    return { goal };
+  }
   getChatQueue(chatId) {
     const chat = this.requireChat(chatId);
     return {
@@ -11941,7 +12096,7 @@ var ChatService = class {
     return descendants;
   }
   async deleteHistoryFile(persisted) {
-    await rm(join19(HISTORY_DIR_BY_PROVIDER[persisted.provider], `${persisted.id}.jsonl`), { force: true });
+    await rm(join21(HISTORY_DIR_BY_PROVIDER[persisted.provider], `${persisted.id}.jsonl`), { force: true });
     await rm(this.senderFilePath(persisted.id), { force: true });
   }
   async getChatHistory(chatId) {
@@ -12012,7 +12167,7 @@ var ChatService = class {
     if (persisted.provider === "claude") {
       provider = new ClaudeManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join19(CLAUDE_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join21(CLAUDE_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -12021,7 +12176,7 @@ var ChatService = class {
     } else if (persisted.provider === "relay") {
       provider = new RelayManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join19(RELAY_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join21(RELAY_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -12034,7 +12189,7 @@ var ChatService = class {
     } else if (persisted.provider === "cursor") {
       provider = new CursorManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join19(CURSOR_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join21(CURSOR_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -12043,7 +12198,7 @@ var ChatService = class {
     } else if (persisted.provider === "opencode") {
       provider = new OpencodeManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join19(OPENCODE_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join21(OPENCODE_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -12052,7 +12207,7 @@ var ChatService = class {
     } else {
       provider = new CodexAspManager({
         workingDirectory: this.workingDirectory,
-        historyFilePath: join19(CODEX_HISTORY_DIR, `${persisted.id}.jsonl`),
+        historyFilePath: join21(CODEX_HISTORY_DIR, `${persisted.id}.jsonl`),
         initialSessionId: persisted.providerSessionId,
         onSaveSessionId: saveSession,
         onTurnComplete: onProviderTurnComplete,
@@ -12191,7 +12346,7 @@ var ChatService = class {
     });
     uploadChatTranscript(
       chatId,
-      join19(HISTORY_DIR_BY_PROVIDER[chat.persisted.provider], `${chatId}.jsonl`),
+      join21(HISTORY_DIR_BY_PROVIDER[chat.persisted.provider], `${chatId}.jsonl`),
       this.toSummary(chat)
     ).catch((err) => {
       console.error("[ChatService] Failed to upload chat transcript:", { chatId, err });
@@ -12309,7 +12464,7 @@ var ChatService = class {
 // src/services/repo-file-service.ts
 import { execFile as execFile2 } from "child_process";
 import { readFile as readFile15, realpath, stat as stat4 } from "fs/promises";
-import { join as join20, resolve as resolve2, extname as extname2 } from "path";
+import { join as join22, resolve as resolve2, extname as extname2 } from "path";
 var CACHE_TTL_MS = 3e4;
 var SEARCH_TIMEOUT_MS = 15e3;
 var MAX_CONTENT_BYTES = 256 * 1024;
@@ -12469,7 +12624,7 @@ var RepoFileService = class {
     const repo = repos.find((r) => r.name === repoName);
     if (!repo) return null;
     try {
-      const fullPath = await realpath(resolve2(join20(repo.path, filePath)));
+      const fullPath = await realpath(resolve2(join22(repo.path, filePath)));
       const repoRoot = await realpath(repo.path);
       const repoPrefix = repoRoot.endsWith("/") ? repoRoot : repoRoot + "/";
       if (!fullPath.startsWith(repoPrefix) && fullPath !== repoRoot) return null;
@@ -12576,21 +12731,21 @@ var RepoFileService = class {
 // src/v1-routes.ts
 import { Hono } from "hono";
 import { z as z2 } from "zod";
-import { readdir as readdir8, stat as stat5, readFile as readFile18 } from "fs/promises";
-import { join as join23, resolve as resolve3 } from "path";
+import { readdir as readdir9, stat as stat5, readFile as readFile18 } from "fs/promises";
+import { join as join25, resolve as resolve3 } from "path";
 
 // src/services/warm-hooks-service.ts
 import { spawn as spawn4 } from "child_process";
 import { readFile as readFile17 } from "fs/promises";
 import { existsSync as existsSync8 } from "fs";
-import { join as join22 } from "path";
+import { join as join24 } from "path";
 
 // src/services/warm-hook-logs-service.ts
-import { mkdir as mkdir14, readFile as readFile16, writeFile as writeFile6, readdir as readdir7, appendFile as appendFile4, unlink as unlink3 } from "fs/promises";
-import { homedir as homedir15 } from "os";
-import { join as join21 } from "path";
-var LOGS_DIR2 = join21(homedir15(), ".replicas", "warm-hook-logs");
-var CURRENT_RUN_LOG = join21(LOGS_DIR2, "current-run.log");
+import { mkdir as mkdir14, readFile as readFile16, writeFile as writeFile6, readdir as readdir8, appendFile as appendFile4, unlink as unlink3 } from "fs/promises";
+import { homedir as homedir16 } from "os";
+import { join as join23 } from "path";
+var LOGS_DIR2 = join23(homedir16(), ".replicas", "warm-hook-logs");
+var CURRENT_RUN_LOG = join23(LOGS_DIR2, "current-run.log");
 var GLOBAL_FILENAME = "global.json";
 function withPreview2(stored) {
   const preview = buildHookOutputPreview(stored.output);
@@ -12607,7 +12762,7 @@ var WarmHookLogsService = class {
       hookName: "organization",
       ...entry
     };
-    await writeFile6(join21(LOGS_DIR2, GLOBAL_FILENAME), `${JSON.stringify(log, null, 2)}
+    await writeFile6(join23(LOGS_DIR2, GLOBAL_FILENAME), `${JSON.stringify(log, null, 2)}
 `, "utf-8");
   }
   async saveEnvironmentHookLog(entry) {
@@ -12617,7 +12772,7 @@ var WarmHookLogsService = class {
       hookName: "environment",
       ...entry
     };
-    await writeFile6(join21(LOGS_DIR2, ENVIRONMENT_HOOK_LOG_FILENAME), `${JSON.stringify(log, null, 2)}
+    await writeFile6(join23(LOGS_DIR2, ENVIRONMENT_HOOK_LOG_FILENAME), `${JSON.stringify(log, null, 2)}
 `, "utf-8");
   }
   async saveRepoHookLog(repoName, entry) {
@@ -12627,13 +12782,13 @@ var WarmHookLogsService = class {
       hookName: repoName,
       ...entry
     };
-    await writeFile6(join21(LOGS_DIR2, repoHookLogFilename(repoName)), `${JSON.stringify(log, null, 2)}
+    await writeFile6(join23(LOGS_DIR2, repoHookLogFilename(repoName)), `${JSON.stringify(log, null, 2)}
 `, "utf-8");
   }
   async getAllLogs() {
     let files;
     try {
-      files = await readdir7(LOGS_DIR2);
+      files = await readdir8(LOGS_DIR2);
     } catch (err) {
       if (err.code === "ENOENT") {
         return [];
@@ -12646,7 +12801,7 @@ var WarmHookLogsService = class {
         continue;
       }
       try {
-        const raw = await readFile16(join21(LOGS_DIR2, file), "utf-8");
+        const raw = await readFile16(join23(LOGS_DIR2, file), "utf-8");
         const stored = JSON.parse(raw);
         logs.push(withPreview2(stored));
       } catch {
@@ -12684,7 +12839,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 readFile16(join21(LOGS_DIR2, filename), "utf-8");
+      const raw = await readFile16(join23(LOGS_DIR2, filename), "utf-8");
       const stored = JSON.parse(raw);
       if (stored.hookType !== hookType || stored.hookName !== hookName) {
         return null;
@@ -12703,7 +12858,7 @@ var warmHookLogsService = new WarmHookLogsService();
 // src/services/warm-hooks-service.ts
 async function readRepoWarmHook(repoPath) {
   for (const filename of REPLICAS_CONFIG_FILENAMES) {
-    const configPath = join22(repoPath, filename);
+    const configPath = join24(repoPath, filename);
     if (!existsSync8(configPath)) {
       continue;
     }
@@ -13011,6 +13166,12 @@ var respondToolInputSchema = z2.object({
   requestId: z2.string().min(1),
   selectionId: z2.string().min(1)
 });
+var updateGoalSchema = z2.object({
+  objective: z2.string().trim().min(1).max(MAX_CODEX_GOAL_OBJECTIVE_CHARS).optional(),
+  status: z2.enum(["active", "paused"]).optional()
+}).refine((body) => body.objective !== void 0 || body.status !== void 0, {
+  message: "Goal objective or status required"
+});
 function jsonError(message, details) {
   return { error: message, details };
 }
@@ -13187,6 +13348,21 @@ function createV1Routes(deps) {
       return c.json(jsonError("Failed to interrupt chat", error instanceof Error ? error.message : "Unknown error"), 404);
     }
   });
+  app2.patch("/chats/:chatId/goal", async (c) => {
+    try {
+      const body = updateGoalSchema.parse(await c.req.json());
+      const result = await deps.chatService.updateGoal(c.req.param("chatId"), body);
+      return c.json(result);
+    } catch (error) {
+      if (error instanceof z2.ZodError) {
+        return c.json(jsonError(error.issues[0]?.message || "Invalid goal update"), 400);
+      }
+      if (error instanceof ChatNotFoundError) {
+        return c.json(jsonError("Failed to update goal", error.message), 404);
+      }
+      return c.json(jsonError("Failed to update goal", error instanceof Error ? error.message : "Unknown error"), 500);
+    }
+  });
   app2.post("/chats/:chatId/goal/clear", async (c) => {
     try {
       const result = await deps.chatService.clearGoal(c.req.param("chatId"));
@@ -13397,6 +13573,22 @@ function createV1Routes(deps) {
       );
     }
   });
+  app2.get("/codex/threads/:threadId/history", async (c) => {
+    try {
+      return c.json(await readCodexAspThreadHistory(c.req.param("threadId")));
+    } catch (error) {
+      if (error instanceof CodexThreadNotFoundError) {
+        return c.json(
+          jsonError("Failed to load Codex thread history", error.message),
+          404
+        );
+      }
+      return c.json(
+        jsonError("Failed to load Codex thread history", error instanceof Error ? error.message : "Unknown error"),
+        500
+      );
+    }
+  });
   app2.post("/environment/track", async (c) => {
     try {
       const body = await c.req.json();
@@ -13677,11 +13869,11 @@ function createV1Routes(deps) {
   });
   app2.get("/logs", async (c) => {
     try {
-      const files = await readdir8(LOG_DIR).catch(() => []);
+      const files = await readdir9(LOG_DIR).catch(() => []);
       const logFiles = files.filter((f) => f.endsWith(".log"));
       const sessions = await Promise.all(
         logFiles.map(async (filename) => {
-          const filePath = join23(LOG_DIR, filename);
+          const filePath = join25(LOG_DIR, filename);
           const fileStat = await stat5(filePath);
           const sessionId = filename.replace(/\.log$/, "");
           return {

package/package.json

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