@myagentroam/node 0.9.0 → 0.9.3

package/dist/util/runner-native-session-parsers.js

@@ -69,15 +69,6 @@ export function codexThreadActivity(result) {
         return 'IDLE';
     return 'UNAVAILABLE';
 }
-export function externalResumeFailureDetail(error) {
-    const message = error instanceof Error ? error.message : 'SESSION_RESUME_REJECTED';
-    return [...message]
-        .map((character) => (character <= '\u001f' || character === '\u007f' ? ' ' : character))
-        .join('')
-        .replace(/\s+/g, ' ')
-        .trim()
-        .slice(0, 240);
-}
 export function codexActiveTurnId(result) {
     if (!isPlainRecord(result) ||
         !isPlainRecord(result.thread) ||
@@ -155,23 +146,49 @@ export function deduplicateDirectSessions(sessions) {
 export function nativeConversationPage(session, history, input, runtimeTurns = [], registerImages = () => []) {
     const limit = Math.min(Math.max(input.limit ?? 30, 1), 500);
     const nativeTurns = nativeTranscriptTurns(history.items);
+    const representedClientMessageIds = new Set(nativeTurns.flatMap((entries) => entries.flatMap(({ entry, index }) => {
+        if (entry.kind !== 'message' || entry.role !== 'USER')
+            return [];
+        const clientMessageId = nativeUserClientMessageId(entry, entry.createdAt ?? index, runtimeTurns);
+        return clientMessageId === null ? [] : [clientMessageId];
+    })));
+    const missingRuntimeErrorTurns = input.cursor === undefined
+        ? runtimeTurns.filter((turn) => {
+            const clientMessageId = runtimeTurnClientMessageId(turn);
+            return (turn.items.some((item) => item.kind === 'error') &&
+                (clientMessageId === undefined || !representedClientMessageIds.has(clientMessageId)));
+        })
+        : [];
     const end = nativePageEnd(input.cursor, session.id, nativeTurns.length);
     const start = Math.max(0, end - limit);
-    const turns = nativeTurns
+    const nativePageTurns = nativeTurns
         .slice(start, end)
         .map((entries, relativeIndex) => {
         const firstIndex = entries[0]?.index ?? 0;
         const turnId = `${session.id}:native:${firstIndex}`;
-        const items = entries.map(({ entry, index }) => nativeTranscriptConversationItem(session, entry, index, turnId, runtimeTurns, registerImages));
+        const nativeItems = entries.map(({ entry, index }) => nativeTranscriptConversationItem(session, entry, index, turnId, runtimeTurns, registerImages));
+        const clientMessageId = nativeItems.flatMap((item) => item.kind === 'user_message' && isPlainRecord(item.payload)
+            ? [item.payload.clientMessageId]
+            : [])[0];
+        const runtimeTurn = typeof clientMessageId === 'string'
+            ? runtimeTurns.find((turn) => runtimeTurnClientMessageId(turn) === clientMessageId)
+            : undefined;
+        const runtimeErrors = (runtimeTurn?.items ?? [])
+            .filter((item) => item.kind === 'error')
+            .map((item) => ({ ...item, turnId, runId: runtimeTurn?.runId ?? null }));
+        const items = [
+            ...nativeItems,
+            ...runtimeErrors.filter((error) => !nativeItems.some((item) => item.id === error.id))
+        ];
         const startedAt = items[0]?.startedAt ?? firstIndex;
         const completedAt = items.at(-1)?.completedAt ?? startedAt;
         const after = lastNativeItemId(entries);
         return {
             id: turnId,
             sessionId: session.id,
-            runId: null,
+            runId: runtimeTurn?.runId ?? null,
             userItemId: items.find((item) => item.kind === 'user_message')?.id ?? null,
-            status: 'SUCCEEDED',
+            status: runtimeErrors.length > 0 ? 'FAILED' : 'SUCCEEDED',
             model: null,
             effort: null,
             access: null,
@@ -188,13 +205,24 @@ export function nativeConversationPage(session, history, input, runtimeTurns = [
             completedAt
         };
     });
+    const combined = [...nativePageTurns, ...missingRuntimeErrorTurns].sort((left, right) => (left.startedAt ?? 0) - (right.startedAt ?? 0));
+    const dropped = combined.slice(0, Math.max(0, combined.length - limit));
+    const turns = combined.slice(-limit);
+    const nativePageIds = new Set(nativePageTurns.map((turn) => turn.id));
+    const nextEnd = start + dropped.filter((turn) => nativePageIds.has(turn.id)).length;
     return {
         turns,
-        nextCursor: start > 0
-            ? Buffer.from(JSON.stringify({ sessionId: session.id, end: start })).toString('base64url')
+        nextCursor: nextEnd > 0
+            ? Buffer.from(JSON.stringify({ sessionId: session.id, end: nextEnd })).toString('base64url')
             : null
     };
 }
+function runtimeTurnClientMessageId(turn) {
+    const user = turn.items.find((item) => item.kind === 'user_message');
+    return isPlainRecord(user?.payload) && typeof user.payload.clientMessageId === 'string'
+        ? user.payload.clientMessageId
+        : undefined;
+}
 function lastNativeItemId(entries) {
     return entries.findLast(({ entry }) => entry.nativeId !== undefined)?.entry.nativeId;
 }
@@ -228,8 +256,8 @@ function nativeTranscriptConversationItem(session, entry, index, turnId, runtime
     const clientMessageId = entry.kind === 'message' && entry.role === 'USER'
         ? nativeUserClientMessageId(entry, time, runtimeTurns)
         : null;
-    // Claude 标签式 Plan Mode：用户正文剥离注入的规划指令标签，
-    // 完整的 <proposed_plan> Agent 文本归一化为计划卡。
+    // Claude tagged Plan Mode strips the injected planning instruction label from user content
+    // and normalizes a complete <proposed_plan> Agent response into a plan card.
     const entryText = entry.kind === 'message'
         ? entry.role === 'USER'
             ? stripClaudePlanTag(entry.text)
@@ -304,8 +332,8 @@ function nativeTranscriptConversationItem(session, entry, index, turnId, runtime
     return item;
 }
 /**
- * Claude JSONL 不保存浏览器请求 ID。Node 进程仍存活时，以正文和生成时刻
- * 对齐当前运行态的用户消息，让 native 历史页替换同一乐观 Turn，而不是重复一条。
+ * Claude JSONL does not retain browser request IDs. While the Node process is alive, match current
+ * runtime user messages by content and creation time so native history replaces the optimistic Turn.
  */
 export function nativeUserClientMessageId(entry, createdAt, runtimeTurns) {
     for (const turn of runtimeTurns) {
@@ -314,7 +342,7 @@ export function nativeUserClientMessageId(entry, createdAt, runtimeTurns) {
             continue;
         const payload = user.payload;
         const clientMessageId = typeof payload.clientMessageId === 'string' ? payload.clientMessageId : null;
-        // 标签式 Plan Mode 的指令标签只存在于原生 transcript，运行态气泡始终是原文。
+        // Tagged Plan Mode instruction labels exist only in native transcripts; runtime bubbles retain the original content.
         if (clientMessageId === null || payload.text !== stripClaudePlanTag(entry.text))
             continue;
         const runtimeCreatedAt = user.startedAt ?? turn.startedAt;

package/dist/util/safe-error.d.ts

@@ -0,0 +1,2 @@
+/** Returns only a stable public error code, never a raw runtime exception message. */
+export declare function safeErrorCode(error: unknown, fallback: string): string;

package/dist/util/safe-error.js

@@ -0,0 +1,5 @@
+const STABLE_ERROR_CODE = /^[A-Z][A-Z0-9_]{0,127}$/u;
+/** Returns only a stable public error code, never a raw runtime exception message. */
+export function safeErrorCode(error, fallback) {
+    return error instanceof Error && STABLE_ERROR_CODE.test(error.message) ? error.message : fallback;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/node",
-  "version": "0.9.0",
+  "version": "0.9.3",
   "description": "MyAgentRoam Node runtime CLI.",
   "type": "module",
   "files": [
@@ -24,7 +24,7 @@
     "node-pty": "1.1.0",
     "ws": "^8.21.3",
     "zod": "4.4.3",
-    "@myagentroam/protocol": "^0.9.0"
+    "@myagentroam/protocol": "^0.9.3"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1"