replicas-engine 0.1.681 → 0.1.683

package/dist/src/{chunk-HWSR36NN.js → chunk-TQJ3KKVC.js}

@@ -747,6 +747,44 @@ function coerceAuthFallbackPayload(payload) {
     ...typeof detail === "string" && detail ? { detail } : {}
   };
 }
+var CHAT_GOAL_STATUSES = [
+  "active",
+  "paused",
+  "blocked",
+  "usageLimited",
+  "budgetLimited",
+  "complete"
+];
+function isChatGoalStatus(value) {
+  return typeof value === "string" && CHAT_GOAL_STATUSES.some((status) => status === value);
+}
+function coerceChatGoalPayload(payload) {
+  const goal = payload.goal;
+  if (goal === null || goal === void 0) return null;
+  if (typeof goal !== "object") return null;
+  const candidate = goal;
+  const threadId = candidate.threadId;
+  const objective = candidate.objective;
+  const status = candidate.status;
+  const tokensUsed = candidate.tokensUsed;
+  const timeUsedSeconds = candidate.timeUsedSeconds;
+  const createdAt = candidate.createdAt;
+  const updatedAt = candidate.updatedAt;
+  const tokenBudget = candidate.tokenBudget ?? null;
+  if (typeof threadId !== "string" || typeof objective !== "string" || !isChatGoalStatus(status) || typeof tokensUsed !== "number" || typeof timeUsedSeconds !== "number" || typeof createdAt !== "string" || typeof updatedAt !== "string" || tokenBudget !== null && typeof tokenBudget !== "number") {
+    return null;
+  }
+  return {
+    threadId,
+    objective,
+    status,
+    tokenBudget,
+    tokensUsed,
+    timeUsedSeconds,
+    createdAt,
+    updatedAt
+  };
+}
 var CONTEXT_USAGE_EVENT_TYPE = "context-usage";
 
 // ../shared/src/engine/v1.ts
@@ -1632,7 +1670,7 @@ For any external destination, continue with the required delivery flow in \`MEDI
 ## Command reference
 
 ### \`replicas computer info\`
-Prints the live desktop viewer URL (\`https://6080-<hash>.tryreplicas.com/\`). The engine auto-registers this authenticated preview on startup; \`info\` just looks it up. Use it when you want to share the live stream URL with the user out-of-band (e.g. in a Slack reply) - the dashboard \`Desktop\` tab already points at the same URL automatically.
+Prints the live desktop viewer URL (\`https://6080-<hash>.replicas.dev/\`). The engine auto-registers this authenticated preview on startup; \`info\` just looks it up. Use it when you want to share the live stream URL with the user out-of-band (e.g. in a Slack reply) - the dashboard \`Desktop\` tab already points at the same URL automatically.
 
 If invoked very early in the workspace lifecycle, \`info\` will poll briefly while the engine finishes registering the preview, then error if it's still not available.
 
@@ -2180,7 +2218,7 @@ Names are normalized to hyphen-case (spaces become hyphens, e.g. \`Login page\`
 For each media file, the CLI prints two lines:
 
 1. \`![filename](<api-url>)\` \u2014 the chat embed (renders inline in Replicas chat **only** \u2014 see below).
-2. \`View in Replicas: <deep-link>\` \u2014 a per-file dashboard URL of the form \`https://tryreplicas.com/workspaces/<workspace-id>?media=<media-id>\` that opens directly to that specific file.
+2. \`View in Replicas: <deep-link>\` \u2014 a per-file dashboard URL of the form \`https://replicas.dev/workspaces/<workspace-id>?media=<media-id>\` that opens directly to that specific file.
 
 Match each "View in Replicas" line to the embed line directly above it \u2014 that's the deep link for that file.
 
@@ -2206,14 +2244,14 @@ replicas media upload screenshot.png --name "Login page" --access public
 
 | URL | What it is | Where it's allowed |
 |---|---|---|
-| \`https://api.tryreplicas.com/v1/media/<id>\` (inside \`![\u2026](\u2026)\`) | Authenticated API redirect to a presigned blob \u2014 requires the Replicas chat session | **Only** in the Replicas chat reply. Nowhere else. |
-| \`https://tryreplicas.com/organizations/<organization-id>/media/<media-id>\` | Organization-only page printed by \`--access organization\` | Pull requests and other places where every viewer belongs to the Replicas organization. |
-| \`https://api.tryreplicas.com/v1/media/public/<id>/<token>\` | Opt-in public bearer URL printed by \`--access public\` or \`--share\` | GitHub embeds for image, video, or audio media. |
-| \`https://tryreplicas.com/workspaces/<workspace-id>?media=<media-id>\` | Authenticated dashboard deep link that opens the media file in the workspace | Everywhere external: Slack, GitHub, GitLab, Linear, PR bodies, comments, emails. |
+| \`https://api.replicas.dev/v1/media/<id>\` (inside \`![\u2026](\u2026)\`) | Authenticated API redirect to a presigned blob \u2014 requires the Replicas chat session | **Only** in the Replicas chat reply. Nowhere else. |
+| \`https://replicas.dev/organizations/<organization-id>/media/<media-id>\` | Organization-only page printed by \`--access organization\` | Pull requests and other places where every viewer belongs to the Replicas organization. |
+| \`https://api.replicas.dev/v1/media/public/<id>/<token>\` | Opt-in public bearer URL printed by \`--access public\` or \`--share\` | GitHub embeds for image, video, or audio media. |
+| \`https://replicas.dev/workspaces/<workspace-id>?media=<media-id>\` | Authenticated dashboard deep link that opens the media file in the workspace | Everywhere external: Slack, GitHub, GitLab, Linear, PR bodies, comments, emails. |
 
 ### NEVER link the API redirect URL outside the Replicas chat reply
 
-The \`api.tryreplicas.com/v1/media/<id>\` URL is **not public**. It's an authenticated redirect that only resolves to a presigned download when the Replicas chat session token is present. Anywhere else (Slack, Linear, GitHub, a browser tab the user opens directly, a customer copy-pasting from chat) it returns \`{"error":"Missing authorization token"}\` and renders as a broken image.
+The \`api.replicas.dev/v1/media/<id>\` URL is **not public**. It's an authenticated redirect that only resolves to a presigned download when the Replicas chat session token is present. Anywhere else (Slack, Linear, GitHub, a browser tab the user opens directly, a customer copy-pasting from chat) it returns \`{"error":"Missing authorization token"}\` and renders as a broken image.
 
 This rule has no exceptions:
 - \u274C Never paste it in a Slack message \u2014 upload the actual bytes via the 3-step \`files.getUploadURLExternal\` \u2192 POST bytes \u2192 \`files.completeUploadExternal\` flow instead (see below).
@@ -2228,7 +2266,7 @@ This rule has no exceptions:
 For an organization-only HTML page, use the \`Forge link\` printed by \`--access organization\`. For other authenticated media references, use the dashboard form:
 
 \`\`\`
-https://tryreplicas.com/workspaces/<workspace-id>?media=<media-id>
+https://replicas.dev/workspaces/<workspace-id>?media=<media-id>
 \`\`\`
 
 The \`media=<media-id>\` query param opens that specific file in the workspace.
@@ -2256,7 +2294,7 @@ Slack, Linear, and GitLab receive the original bytes through their native upload
 
 ### Slack \u2014 embed natively via the 3-step external file upload flow
 
-A Slack message that just contains a \`tryreplicas.com\` link is not acceptable when the message is supposed to show an image. The recipient should see the image inline in the thread.
+A Slack message that just contains a \`replicas.dev\` link is not acceptable when the message is supposed to show an image. The recipient should see the image inline in the thread.
 
 Slack deprecated the single-shot \`files.upload\` endpoint. The raw HTTP replacement is a 3-step flow: reserve an upload URL with \`files.getUploadURLExternal\`, POST the bytes to it, then share into the channel/thread with \`files.completeUploadExternal\`. (\`files.uploadV2\` is **only** an SDK convenience wrapper \u2014 it is NOT a real Web API HTTP endpoint and \`POST https://slack.com/api/files.uploadV2\` will return \`unknown_method\`.)
 
@@ -2288,7 +2326,7 @@ curl -s -X POST "https://slack.com/api/files.completeUploadExternal" \\
     \\"files\\": [{\\"id\\": \\"$FILE_ID\\", \\"title\\": \\"Screenshot\\"}],
     \\"channel_id\\": \\"CHANNEL_ID\\",
     \\"thread_ts\\": \\"THREAD_TS\\",
-    \\"initial_comment\\": \\"<https://tryreplicas.com/workspaces/<workspace-id>?media=<media-id>|View in Replicas>\\"
+    \\"initial_comment\\": \\"<https://replicas.dev/workspaces/<workspace-id>?media=<media-id>|View in Replicas>\\"
   }"
 \`\`\`
 
@@ -2299,7 +2337,7 @@ Notes:
 - For multiple files in the same message, run steps 1\u20132 per file and pass all \`{id, title}\` objects in the \`files\` array of a single \`files.completeUploadExternal\` call \u2014 they share into the thread together.
 - If you also need to post a separate text reply in the thread, send it with \`chat.postMessage\` after the upload \u2014 but the upload itself must carry the image.
 
-Never paste the \`api.tryreplicas.com/v1/media/<id>\` URL into a Slack message body or \`initial_comment\` \u2014 it will render as a broken image attempt.
+Never paste the \`api.replicas.dev/v1/media/<id>\` URL into a Slack message body or \`initial_comment\` \u2014 it will render as a broken image attempt.
 
 ### Linear \u2014 embed natively via the GraphQL \`fileUpload\` mutation
 
@@ -2348,7 +2386,7 @@ curl -s -X PUT "$UPLOAD_URL" \\
   --data-binary @"$FILE"
 
 # 3. Reference assetUrl inline in the comment body, alongside the dashboard link.
-BODY=$(printf '![screenshot](%s)\\n\\n[View in Replicas](https://tryreplicas.com/workspaces/%s?media=%s)' \\
+BODY=$(printf '![screenshot](%s)\\n\\n[View in Replicas](https://replicas.dev/workspaces/%s?media=%s)' \\
   "$ASSET_URL" "$REPLICAS_WORKSPACE_ID" "$MEDIA_ID")
 
 jq -n \\
@@ -2362,7 +2400,7 @@ jq -n \\
 
 The same flow works for issue bodies (use \`issueCreate\` / \`issueUpdate\` with the same markdown body).
 
-Never paste the \`api.tryreplicas.com/v1/media/<id>\` URL into a Linear body or comment \u2014 it will render as a broken image to anyone outside your Replicas chat.
+Never paste the \`api.replicas.dev/v1/media/<id>\` URL into a Linear body or comment \u2014 it will render as a broken image to anyone outside your Replicas chat.
 
 ### GitHub: inline screenshots and recording previews
 
@@ -6704,7 +6742,7 @@ var DEFAULT_CODEX_ARGS = [
 var MIN_CODEX_CLI_VERSION = "0.144.6";
 var CODEX_UPGRADE_TIMEOUT_MS = 12e4;
 var codexCliVersionEnsured = null;
-var ENGINE_PACKAGE_VERSION = "0.1.681";
+var ENGINE_PACKAGE_VERSION = "0.1.683";
 var INITIALIZE_METHOD = "initialize";
 var INITIALIZED_NOTIFICATION = "initialized";
 var ACCOUNT_LOGIN_START_METHOD = "account/login/start";
@@ -6985,6 +7023,7 @@ export {
   AUTH_RETRY_STATUS_EVENT_TYPE,
   CURSOR_CONNECTION_STATUS_EVENT_TYPE,
   AUTH_FALLBACK_EVENT_TYPE,
+  coerceChatGoalPayload,
   CONTEXT_USAGE_EVENT_TYPE,
   detectLanguageByPath,
   ASTER_PROVIDER,
@@ -7085,6 +7124,7 @@ export {
   parseChatHistoryCursor,
   createChatHistoryCursor,
   chatHistoryPageParamsFromQuery,
+  getChatHistoryPageWindow,
   paginateChatHistory,
   CODEX_AUTH_ENV_KEYS,
   codexAuthEnvFromResponse,

package/dist/src/headless-agent.js

@@ -7,7 +7,7 @@ import {
   headlessAgentRequestSchema,
   putPresignedFile,
   recoverCompletedTurn
-} from "./chunk-HWSR36NN.js";
+} from "./chunk-TQJ3KKVC.js";
 
 // src/headless-agent.ts
 import { createHash } from "crypto";

package/dist/src/index.js

@@ -106,6 +106,7 @@ import {
   codexAuthEnvFromResponse,
   codexReasoningEffortForThinkingLevel,
   coerceBackgroundTaskPayload,
+  coerceChatGoalPayload,
   coerceClaudeResultPayload,
   createAcceptedUserMessageEvent,
   createChatHistoryCursor,
@@ -127,6 +128,7 @@ import {
   findGitCommitSignals,
   findPrMergeSignals,
   getChatHistoryPageSenders,
+  getChatHistoryPageWindow,
   getChatTranscriptHistorySize,
   getClaudeModelContextWindow,
   getCodexAspTurnResponse,
@@ -190,7 +192,7 @@ import {
   serializeCanvasContentResponse,
   shellQuotePosix,
   stripAgentDiagnosticErrors
-} from "./chunk-HWSR36NN.js";
+} from "./chunk-TQJ3KKVC.js";
 
 // src/index.ts
 import { serve } from "@hono/node-server";
@@ -5772,7 +5774,6 @@ var DEFAULT_MODEL = DEFAULT_CODEX_MODEL;
 var THREAD_START_METHOD = "thread/start";
 var THREAD_RESUME_METHOD = "thread/resume";
 var THREAD_READ_METHOD = "thread/read";
-var THREAD_TURNS_LIST_METHOD = "thread/turns/list";
 var THREAD_GOAL_SET_METHOD = "thread/goal/set";
 var THREAD_GOAL_GET_METHOD = "thread/goal/get";
 var THREAD_GOAL_CLEAR_METHOD = "thread/goal/clear";
@@ -6510,6 +6511,7 @@ var CodexAspManager = class extends CodingAgentManager {
   codexAspSequence = 0;
   quotaStatus = new CodexQuotaStatusTracker();
   currentGoal = null;
+  goalHistoryKnown = false;
   transcriptUpdateCoalescer = new TranscriptUpdateCoalescer((threadId) => {
     this.flushTranscriptUpdated(threadId);
   });
@@ -6530,6 +6532,11 @@ var CodexAspManager = class extends CodingAgentManager {
     if (replayed?.transcript && (!this.initialSessionId || replayed.transcript.threadId === this.initialSessionId)) {
       this.mergeTranscriptSnapshot(replayed.transcript);
     }
+    const goalEvent = replayed?.events.findLast((event) => event.type === CHAT_GOAL_EVENT_TYPE);
+    if (goalEvent) {
+      this.currentGoal = coerceChatGoalPayload(goalEvent.payload);
+      this.goalHistoryKnown = true;
+    }
     this.currentThreadId = this.initialSessionId ?? replayed?.transcript?.threadId ?? null;
   }
   getHistorySink() {
@@ -6614,38 +6621,45 @@ var CodexAspManager = class extends CodingAgentManager {
     return true;
   }
   async getHistory(page = {}) {
+    await this.initialized;
     await this.historyFile?.flush();
+    const transcript = await this.ensureTranscriptHistory();
+    const events = await this.historyFile?.loadEventsPage(page) ?? { events: [], beforeCursor: null };
     if (page.limit === void 0) {
-      const local = async () => {
-        const history = await this.historyFile?.load();
-        return {
-          thread_id: this.currentThreadId,
-          events: history?.events ?? [],
-          codexAspTranscript: this.currentThreadId ? history?.transcriptsByThreadId.get(this.currentThreadId) ?? null : null,
-          goal: this.currentGoal
-        };
+      return {
+        thread_id: this.currentThreadId,
+        events: events.events,
+        codexAspTranscript: transcript,
+        goal: this.currentGoal
       };
-      if (!this.currentThreadId) return local();
-      return this.readFullNativeHistory().catch(local);
     }
-    const events = await this.historyFile?.loadEventsPage(page) ?? { events: [], beforeCursor: null };
     if (!this.currentThreadId) return { thread_id: null, ...events, goal: this.currentGoal };
     const cursor = parseChatHistoryCursor(page.beforeCursor);
     if (page.beforeCursor !== void 0 && cursor?.mode !== "range") throw new RangeError("Invalid chat history cursor");
-    let transcript = null;
+    if (page.beforeCursor === void 0 && !this.goalHistoryKnown) {
+      try {
+        await this.refreshThreadGoal(await getCodexAspHost(), this.currentThreadId);
+      } catch (error) {
+        console.warn("[CodexAspManager] Failed to connect while refreshing thread goal:", error);
+      }
+    }
+    let transcriptPage = null;
     let turnsBefore = null;
-    if (cursor?.turns !== null) {
-      const host = await getCodexAspHost();
-      if (page.beforeCursor === void 0) await this.refreshThreadGoal(host, this.currentThreadId);
-      const turns = await this.readNativeTurnsPage(page.limit, cursor?.turns, host);
-      transcript = turns.transcript;
-      turnsBefore = turns.before;
+    if (cursor?.turns !== null && transcript) {
+      const before = cursor?.turns === void 0 ? transcript.turns.length : /^\d+$/.test(cursor.turns) ? Number(cursor.turns) : Number.NaN;
+      if (!Number.isSafeInteger(before) || before < 0) throw new RangeError("Invalid chat history cursor");
+      const { startIndex, endIndex } = getChatHistoryPageWindow(transcript.turns.length, page.limit, before);
+      transcriptPage = {
+        ...transcript,
+        turns: transcript.turns.slice(startIndex, endIndex)
+      };
+      turnsBefore = startIndex > 0 ? String(startIndex) : null;
     }
     const eventCursor = parseChatHistoryCursor(events.beforeCursor ?? void 0);
     return {
       thread_id: this.currentThreadId,
       ...events,
-      codexAspTranscript: transcript,
+      codexAspTranscript: transcriptPage,
       goal: this.currentGoal,
       beforeCursor: createChatHistoryCursor({
         events: eventCursor?.events ?? null,
@@ -6653,54 +6667,14 @@ var CodexAspManager = class extends CodingAgentManager {
       })
     };
   }
-  async readFullNativeHistory() {
-    if (!this.currentThreadId) {
-      return { thread_id: null, events: [], goal: this.currentGoal };
-    }
+  async ensureTranscriptHistory() {
+    if (this.codexAspTranscript || !this.currentThreadId) return this.codexAspTranscript;
     const host = await getCodexAspHost();
-    const [response, history] = await Promise.all([
-      host.client.request(
-        THREAD_READ_METHOD,
-        { threadId: this.currentThreadId, includeTurns: true }
-      ),
-      this.historyFile?.load()
-    ]);
-    const transcript = this.mergeTranscriptSnapshot(threadToAspTranscript(response.thread));
-    return {
-      thread_id: this.currentThreadId,
-      events: history?.events ?? [],
-      codexAspTranscript: transcript,
-      goal: this.currentGoal
-    };
-  }
-  async readNativeTurnsPage(limit, cursor, host) {
-    if (!this.currentThreadId) throw new Error("A thread is required for native turn pagination");
     const response = await host.client.request(
-      THREAD_TURNS_LIST_METHOD,
-      {
-        threadId: this.currentThreadId,
-        cursor: cursor ?? null,
-        limit,
-        sortDirection: "desc",
-        itemsView: "full"
-      }
-    );
-    const nativeTranscript = turnsToAspTranscript(
-      this.currentThreadId,
-      (/* @__PURE__ */ new Date()).toISOString(),
-      response.data
+      THREAD_READ_METHOD,
+      { threadId: this.currentThreadId, includeTurns: true }
     );
-    const mergedTranscript = mergeCodexAspTranscripts(this.codexAspTranscript, nativeTranscript) ?? nativeTranscript;
-    this.codexAspTranscript = mergedTranscript;
-    this.syncTranscriptSequence(mergedTranscript);
-    const turnIds = new Set(response.data.map((turn) => turn.id));
-    return {
-      transcript: {
-        ...mergedTranscript,
-        turns: mergedTranscript.turns.filter((turn) => turnIds.has(turn.id))
-      },
-      before: response.nextCursor
-    };
+    return this.mergeTranscriptSnapshot(threadToAspTranscript(response.thread));
   }
   getGoal() {
     return this.currentGoal;
@@ -7619,6 +7593,7 @@ var CodexAspManager = class extends CodingAgentManager {
         { threadId }
       );
       this.currentGoal = response.goal ? aspGoalToChatGoal(response.goal) : null;
+      this.goalHistoryKnown = true;
     } catch (error) {
       console.warn("[CodexAspManager] Failed to read ASP thread goal:", error);
     }
@@ -7629,6 +7604,7 @@ var CodexAspManager = class extends CodingAgentManager {
       return;
     }
     this.currentGoal = nextGoal;
+    this.goalHistoryKnown = true;
     const event = this.recordCodexHistoryEvent(
       CHAT_GOAL_EVENT_TYPE,
       { goal: nextGoal }

package/package.json

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