@myagentroam/node 0.9.0 → 0.9.3

package/dist/native-session-history.js

@@ -9,7 +9,9 @@ const DISCOVERY_READ_BYTES = 32 * 1024;
 const TRANSCRIPT_READ_BYTES = 4 * 1024 * 1024;
 const CONTEXT_USAGE_READ_BYTES = 256 * 1024;
 const CLAUDE_CONTEXT_USAGE_READ_BYTES = [CONTEXT_USAGE_READ_BYTES, 1024 * 1024, 4 * 1024 * 1024];
+const TRANSCRIPT_INDEX_TTL_MS = 60 * 60_000;
 const transcriptIndex = new Map();
+const transcriptIndexTimers = new Map();
 const discoveryReads = new Map();
 const DEFAULT_CLAUDE_CONTEXT_WINDOW_TOKENS = 200_000;
 const CLAUDE_CONTEXT_WINDOW_ENV = 'MAR_CLAUDE_CONTEXT_WINDOW_TOKENS';
@@ -53,7 +55,7 @@ async function performNativeSessionDiscovery(runner) {
         if (parsed === undefined)
             continue;
         const cwd = canonical(parsed.cwd);
-        transcriptIndex.set(indexKey(runner, cwd, parsed.externalSessionId), files[index]);
+        setTranscriptIndex(indexKey(runner, cwd, parsed.externalSessionId), files[index]);
         found.set(`${cwd}\u0000${parsed.externalSessionId}`, parsed);
     }
     nodeLog('native.session.discovery.completed', {
@@ -83,14 +85,14 @@ async function readDiscoveryHeaders(files, runner) {
 /** Reads one already-discovered external session again to follow appended JSONL records. */
 export async function readNativeSession(runner, workspacePath, externalSessionId) {
     const wanted = canonical(workspacePath);
-    const path = transcriptIndex.get(indexKey(runner, wanted, externalSessionId));
+    const path = getTranscriptIndex(indexKey(runner, wanted, externalSessionId));
     if (path === undefined)
         return undefined;
     const parsed = await readTranscript(path, runner, TRANSCRIPT_READ_BYTES);
     if (parsed === undefined ||
         parsed.externalSessionId !== externalSessionId ||
         canonical(parsed.cwd) !== wanted) {
-        transcriptIndex.delete(indexKey(runner, wanted, externalSessionId));
+        deleteTranscriptIndex(indexKey(runner, wanted, externalSessionId));
         return undefined;
     }
     return parsed;
@@ -103,10 +105,10 @@ export async function readNativeSession(runner, workspacePath, externalSessionId
  */
 export async function readCodexNativeContextUsage(workspacePath, externalSessionId) {
     const wanted = canonical(workspacePath);
-    let path = transcriptIndex.get(indexKey('codex', wanted, externalSessionId));
+    let path = getTranscriptIndex(indexKey('codex', wanted, externalSessionId));
     if (path === undefined) {
         await discoverNativeSessions('codex', workspacePath);
-        path = transcriptIndex.get(indexKey('codex', wanted, externalSessionId));
+        path = getTranscriptIndex(indexKey('codex', wanted, externalSessionId));
     }
     if (path === undefined)
         return undefined;
@@ -124,11 +126,11 @@ export async function readCodexNativeContextUsage(workspacePath, externalSession
 /** Reads the latest actual Claude prompt occupancy without starting a CLI/SDK control stream. */
 export async function readClaudeNativeContextUsage(workspacePath, externalSessionId, options = {}) {
     const wanted = canonical(workspacePath);
-    let path = transcriptIndex.get(indexKey('claude-code', wanted, externalSessionId));
+    let path = getTranscriptIndex(indexKey('claude-code', wanted, externalSessionId));
     path ??= await locateClaudeTranscript(wanted, externalSessionId);
     if (path === undefined) {
         await discoverNativeSessions('claude-code', workspacePath);
-        path = transcriptIndex.get(indexKey('claude-code', wanted, externalSessionId));
+        path = getTranscriptIndex(indexKey('claude-code', wanted, externalSessionId));
     }
     if (path === undefined)
         return undefined;
@@ -178,7 +180,7 @@ async function locateClaudeTranscript(wantedCwd, externalSessionId) {
     const match = parsed.find(({ history }) => history?.externalSessionId === externalSessionId && canonical(history.cwd) === wantedCwd);
     if (match === undefined)
         return undefined;
-    transcriptIndex.set(indexKey('claude-code', wantedCwd, externalSessionId), match.path);
+    setTranscriptIndex(indexKey('claude-code', wantedCwd, externalSessionId), match.path);
     return match.path;
 }
 export async function claudeContextWindowTokens(options = {}) {
@@ -207,10 +209,10 @@ export async function claudeContextWindowTokens(options = {}) {
  */
 export async function removeNativeSession(runner, workspacePath, externalSessionId) {
     const wanted = canonical(workspacePath);
-    let path = transcriptIndex.get(indexKey(runner, wanted, externalSessionId));
+    let path = getTranscriptIndex(indexKey(runner, wanted, externalSessionId));
     if (path === undefined) {
         await discoverNativeSessions(runner, workspacePath);
-        path = transcriptIndex.get(indexKey(runner, wanted, externalSessionId));
+        path = getTranscriptIndex(indexKey(runner, wanted, externalSessionId));
     }
     if (path === undefined)
         throw new Error('NATIVE_TRANSCRIPT_UNAVAILABLE');
@@ -218,7 +220,7 @@ export async function removeNativeSession(runner, workspacePath, externalSession
     if (parsed === undefined ||
         parsed.externalSessionId !== externalSessionId ||
         canonical(parsed.cwd) !== wanted) {
-        transcriptIndex.delete(indexKey(runner, wanted, externalSessionId));
+        deleteTranscriptIndex(indexKey(runner, wanted, externalSessionId));
         throw new Error('NATIVE_TRANSCRIPT_UNAVAILABLE');
     }
     try {
@@ -229,7 +231,7 @@ export async function removeNativeSession(runner, workspacePath, externalSession
             throw new Error('NATIVE_TRANSCRIPT_UNAVAILABLE');
         throw error;
     }
-    transcriptIndex.delete(indexKey(runner, wanted, externalSessionId));
+    deleteTranscriptIndex(indexKey(runner, wanted, externalSessionId));
 }
 function transcriptRoot(runner) {
     return runner === 'codex'
@@ -286,7 +288,7 @@ async function readTranscript(path, runner, byteLimit) {
         items.push({
             kind: 'tool_call',
             toolUseId: result.toolUseId,
-            toolName: '工具',
+            toolName: 'Tool',
             input: null,
             inputSummary: null,
             inputTruncated: false,
@@ -301,7 +303,7 @@ async function readTranscript(path, runner, byteLimit) {
     if (cwd === undefined)
         return undefined;
     const title = items.find((item) => item.kind === 'message' && item.role === 'USER')?.text;
-    // 标签式 Plan Mode 的指令标签不构成会话标题。
+    // Tagged Plan Mode instruction labels do not form a session title.
     const strippedTitle = title === undefined ? undefined : stripClaudePlanTag(title);
     return {
         runner,
@@ -591,7 +593,7 @@ function codexGeneratedImageEvent(record) {
         input: null,
         inputSummary: null,
         inputTruncated: false,
-        outputSummary: payload['status'] === 'completed' ? '图片生成完成' : '图片生成失败',
+        outputSummary: payload['status'] === 'completed' ? 'Image generation completed' : 'Image generation failed',
         outputTruncated: false,
         imageAttachments: [{ name: basename(localPath), mime: imageMime(localPath), localPath }],
         failed: payload['status'] !== 'completed',
@@ -620,7 +622,7 @@ function codexVisibleToolText(value) {
         const start = value.indexOf(marker, cursor);
         if (start < 0)
             return visible + value.slice(cursor);
-        visible += `${value.slice(cursor, start)}[图片内容已过滤]`;
+        visible += `${value.slice(cursor, start)}[Image content filtered]`;
         const doubleQuote = value.indexOf('"', start);
         const singleQuote = value.indexOf("'", start);
         const end = doubleQuote < 0
@@ -636,14 +638,20 @@ function codexVisibleToolText(value) {
 }
 /** Extract only image placeholder metadata from native Codex output. */
 function codexImagePlaceholders(value) {
-    const paths = [];
+    const attachments = [];
     let visited = 0;
     const visit = (current, depth) => {
-        if (paths.length >= 5 || visited >= 128 || depth > 5 || current == null)
+        if (attachments.length >= 5 || visited >= 128 || depth > 5 || current == null)
             return;
         visited += 1;
         if (typeof current === 'string') {
+            const paths = [];
             collectGeneratedImagePaths(current, paths);
+            for (const localPath of paths) {
+                if (attachments.some((attachment) => attachment.localPath === localPath))
+                    continue;
+                attachments.push({ name: basename(localPath), mime: imageMime(localPath), localPath });
+            }
             return;
         }
         if (Array.isArray(current)) {
@@ -653,15 +661,28 @@ function codexImagePlaceholders(value) {
         }
         if (!isRecord(current))
             return;
+        const type = typeof current['type'] === 'string' ? current['type'] : '';
+        if (type === 'input_text' && typeof current['text'] === 'string') {
+            const mime = /["']image_url["']\s*:\s*["']data:(image\/[^;,"']+)[;,]/.exec(current['text'])?.[1];
+            if (mime !== undefined)
+                attachments.push({ name: `image-${attachments.length + 1}.${imageExtension(mime)}`, mime });
+        }
+        const imageUrl = isRecord(current['image_url'])
+            ? firstString(current['image_url'], ['url'])
+            : typeof current['image_url'] === 'string'
+                ? current['image_url']
+                : undefined;
+        const data = typeof current['data'] === 'string' ? current['data'] : imageUrl;
+        if ((type === 'image' || type === 'input_image' || type === 'output_image') &&
+            data?.startsWith('data:image/')) {
+            const mime = /^data:([^;,]+)[;,]/.exec(data)?.[1] ?? 'image/png';
+            attachments.push({ name: `image-${attachments.length + 1}.${imageExtension(mime)}`, mime });
+        }
         for (const child of Object.values(current))
             visit(child, depth + 1);
     };
     visit(value, 0);
-    return paths.map((localPath) => ({
-        name: basename(localPath),
-        mime: imageMime(localPath),
-        localPath
-    }));
+    return attachments;
 }
 function collectGeneratedImagePaths(value, paths) {
     const marker = '/.codex/generated_images/';
@@ -690,15 +711,54 @@ function imageMime(path) {
         return 'image/webp';
     return 'image/png';
 }
+function imageExtension(mime) {
+    if (mime === 'image/jpeg')
+        return 'jpg';
+    if (mime === 'image/webp')
+        return 'webp';
+    if (mime === 'image/gif')
+        return 'gif';
+    return 'png';
+}
 function withToolResult(call, result) {
+    const viewedImagePath = codexViewedImagePath(call);
+    const imageAttachments = result.imageAttachments?.map((attachment) => attachment.localPath !== undefined || viewedImagePath === undefined
+        ? attachment
+        : {
+            name: basename(viewedImagePath),
+            mime: imageMime(viewedImagePath),
+            localPath: viewedImagePath
+        });
     return {
         ...call,
         outputSummary: result.output,
         outputTruncated: result.truncated,
-        ...(result.imageAttachments === undefined ? {} : { imageAttachments: result.imageAttachments }),
+        ...(imageAttachments === undefined ? {} : { imageAttachments }),
         failed: result.failed
     };
 }
+function codexViewedImagePath(call) {
+    const toolName = call.toolName.toLowerCase();
+    if (toolName === 'view_image' || toolName === 'imageview') {
+        return isRecord(call.input) && typeof call.input['path'] === 'string'
+            ? call.input['path']
+            : undefined;
+    }
+    if (toolName !== 'exec' || typeof call.input !== 'string')
+        return undefined;
+    if (!/tools\.view_image\s*\(/.test(call.input))
+        return undefined;
+    const encodedPath = /["']path["']\s*:\s*("(?:\\.|[^"\\])*")/.exec(call.input)?.[1];
+    if (encodedPath === undefined)
+        return undefined;
+    try {
+        const path = JSON.parse(encodedPath);
+        return typeof path === 'string' ? path : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
 function isInjectedContextPrompt(text) {
     const normalized = text.replace(/\s+/g, ' ').trim();
     if (normalized.startsWith('<codex_internal_context'))
@@ -776,7 +836,7 @@ function compactValue(value, limit) {
             text = JSON.stringify(value);
         }
         catch {
-            return { text: '（无法显示）', truncated: false };
+            return { text: '(Unable to display)', truncated: false };
         }
     }
     return {
@@ -812,7 +872,7 @@ function nestedString(value, keys) {
 function compact(value) {
     return value.replace(/\s+/g, ' ').trim().slice(0, 16_000);
 }
-/** 对话正文可能是 Markdown，不能像标题一样压缩内部空白。 */
+/** Conversation content can be Markdown, so its internal whitespace must not be collapsed like a title. */
 function messageText(value) {
     return value.trim().slice(0, 16_000);
 }
@@ -828,6 +888,25 @@ function canonical(value) {
 function indexKey(runner, cwd, externalSessionId) {
     return `${runner}\u0000${cwd}\u0000${externalSessionId}`;
 }
+function setTranscriptIndex(key, path) {
+    const previousTimer = transcriptIndexTimers.get(key);
+    if (previousTimer !== undefined)
+        clearTimeout(previousTimer);
+    transcriptIndex.set(key, path);
+    const timer = setTimeout(() => deleteTranscriptIndex(key), TRANSCRIPT_INDEX_TTL_MS);
+    timer.unref();
+    transcriptIndexTimers.set(key, timer);
+}
+function getTranscriptIndex(key) {
+    return transcriptIndex.get(key);
+}
+function deleteTranscriptIndex(key) {
+    const timer = transcriptIndexTimers.get(key);
+    if (timer !== undefined)
+        clearTimeout(timer);
+    transcriptIndexTimers.delete(key);
+    transcriptIndex.delete(key);
+}
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }

package/dist/runner/abstract-runner.d.ts

@@ -53,7 +53,7 @@ export declare abstract class AbstractRunner<TName extends RegisteredRunnerName
     }, managedTurn: (nativeTurnId: string) => NodeConversationTurn | undefined): Promise<RunnerOfficialConversationPage | undefined>;
     readExternalActivity(session: NodeAgentSession): Promise<SessionActivityState | undefined>;
     acceptsTruncatedNativeHistory(): boolean;
-    nativeImageRoot(session: NodeAgentSession): string | undefined;
+    nativeImageRoots(session: NodeAgentSession): readonly string[];
     managedRunForNativeTurn(nativeTurnId: string): string | undefined;
     abstract stop(): void | Promise<void>;
     bindControl(control: RunnerControl): void;

package/dist/runner/abstract-runner.js

@@ -106,9 +106,9 @@ export class AbstractRunner {
     acceptsTruncatedNativeHistory() {
         return true;
     }
-    nativeImageRoot(session) {
+    nativeImageRoots(session) {
         void session;
-        return undefined;
+        return [];
     }
     managedRunForNativeTurn(nativeTurnId) {
         void nativeTurnId;

package/dist/runner/claude/managed-run-controller.d.ts

@@ -26,7 +26,6 @@ export interface ClaudeManagedRunHost<TAttachment extends ClaudeRunnerImageAttac
     hasActiveSessionLease(sessionId: string): boolean;
     session(sessionId: string): NodeAgentSession | undefined;
     completeCancelled(runId: string, cwd: string): boolean;
-    captureSnapshot(runId: string, cwd: string): Promise<void>;
     requestUserInput(runId: string, input: Record<string, unknown>, toolUseId: string): Promise<ReturnType<typeof denyPermission>>;
     requestApproval(runId: string, toolName: string, input: Record<string, unknown>): Promise<ReturnType<typeof denyPermission>>;
     rememberNative(nativeSessionId: string, sessionId: string): void;

package/dist/runner/claude/managed-run-controller.js

@@ -1,9 +1,10 @@
 import { createEnvelope } from '@myagentroam/protocol';
 import { ClaudeChannelGate } from '../../claude-channel.js';
 import { boundedConversationItemId, claudePlanText, compactRunnerText, compactRunnerValue, extractClaudeText, extractClaudeThinkingSummaries, extractClaudeToolResults, extractClaudeToolUses, isClaudeCommandTool } from '../codex/conversation-parser.js';
-import { isTerminalRunStatus } from '../../util/node-operation-parsers.js';
 import { claudeContentBlocks } from '../../util/node-operation-parsers.js';
 import { parseSecretEnvironment } from '../../util/secret-environment.js';
+import { safeErrorCode } from '../../util/safe-error.js';
+import { runnerErrorProjection } from '../../util/runner-error.js';
 export class ClaudeManagedRunController {
     runner;
     host;
@@ -24,10 +25,10 @@ export class ClaudeManagedRunController {
                 commandId: 'plan',
                 active: true,
                 label: 'Plan Mode',
-                detail: '后续消息将以标签式规划模式运行，只读规划并输出计划卡。',
+                detail: 'Subsequent messages run in read-only tagged Plan Mode and produce a plan card.',
                 closable: true,
                 closeInput: '/plan',
-                continuation: { label: '执行', prompt: '请根据上述计划开始实施。' }
+                continuation: { label: 'Implement', prompt: 'Implement the plan above.' }
             });
         return { command: command.id, states: this.host.commandStates(session.id) };
     }
@@ -83,7 +84,7 @@ export class ClaudeManagedRunController {
             secretEnvironment = parseSecretEnvironment(payload.secretEnvironment);
         }
         catch (error) {
-            this.host.emit(runId, 'run.rejected', { code: error instanceof Error ? error.message : 'MESSAGE_ATTACHMENTS_INVALID' }, 'FAILED');
+            this.host.emit(runId, 'run.rejected', { code: safeErrorCode(error, 'MESSAGE_ATTACHMENTS_INVALID') }, 'FAILED');
             return;
         }
         this.host.adopt({
@@ -115,16 +116,25 @@ export class ClaudeManagedRunController {
         let terminal = false;
         let handle;
         const toolKinds = new Map();
-        const finish = (status, eventType, eventPayload) => {
+        const finish = (status, eventType, eventPayload, failure, fallbackCode = 'CLAUDE_RUN_FAILED') => {
             if (terminal)
                 return;
             terminal = true;
-            this.host.emit(runId, eventType, eventPayload, status);
+            const projected = status === 'FAILED'
+                ? runnerErrorProjection(failure ?? eventPayload, fallbackCode)
+                : undefined;
+            if (projected !== undefined) {
+                this.host.emitItem(runId, {
+                    itemId: boundedConversationItemId('runner-error', runId),
+                    kind: 'error',
+                    status: 'FAILED',
+                    payload: { ...projected, recoverable: true, retryAfterMs: null }
+                });
+            }
+            this.host.emit(runId, eventType, projected ?? eventPayload, status);
             this.runner.execution.runs.delete(runId);
             handle?.cancel();
             this.host.active.delete(runId);
-            if (isTerminalRunStatus(status))
-                void this.host.captureSnapshot(runId, cwd);
         };
         try {
             const gate = new ClaudeChannelGate(sessionId);
@@ -255,14 +265,23 @@ export class ClaudeManagedRunController {
                         const kind = toolKinds.get(record.tool_use_id);
                         if (kind === 'tool_call') {
                             const elapsed = typeof record.elapsed_time_seconds === 'number'
-                                ? `（${Math.max(0, Math.round(record.elapsed_time_seconds))} 秒）`
+                                ? ` (${Math.max(0, Math.round(record.elapsed_time_seconds))} seconds)`
                                 : '';
                             this.host.emitItem(runId, {
                                 itemId: boundedConversationItemId('claude-tool', record.tool_use_id),
                                 kind,
                                 status: 'IN_PROGRESS',
                                 payload: {
-                                    progressLabel: compactRunnerText(`${typeof record.tool_name === 'string' ? record.tool_name : '工具'}正在执行${elapsed}`, 500)
+                                    progressLabel: compactRunnerText(`${typeof record.tool_name === 'string' ? record.tool_name : 'Tool'} is running${elapsed}`, 500),
+                                    progressLabelCode: typeof record.elapsed_time_seconds === 'number'
+                                        ? 'TOOL_RUNNING_WITH_DURATION'
+                                        : 'TOOL_RUNNING',
+                                    progressLabelParameters: {
+                                        tool: typeof record.tool_name === 'string' ? record.tool_name : 'Tool',
+                                        seconds: typeof record.elapsed_time_seconds === 'number'
+                                            ? Math.max(0, Math.round(record.elapsed_time_seconds))
+                                            : 0
+                                    }
                                 },
                                 merge: true
                             });
@@ -304,7 +323,7 @@ export class ClaudeManagedRunController {
                         // result completes this AgentRun even though that iterable can
                         // remain open waiting for another user turn; waiting only for
                         // stream closure would leave the WorkspaceLease permanently held.
-                        finish(subtype === 'success' && record.is_error !== true ? 'SUCCEEDED' : 'FAILED', subtype === 'success' && record.is_error !== true ? 'run.completed' : 'run.failed', { subtype });
+                        finish(subtype === 'success' && record.is_error !== true ? 'SUCCEEDED' : 'FAILED', subtype === 'success' && record.is_error !== true ? 'run.completed' : 'run.failed', { subtype }, record);
                         if (completedNativeSessionId !== undefined)
                             void this.host.syncTitle(sessionId, completedNativeSessionId, cwd);
                     }
@@ -314,14 +333,10 @@ export class ClaudeManagedRunController {
             this.host.setChannelToken(sessionId, gate.token);
             this.host.send('session.channel.ready', { sessionId, token: gate.token });
             this.host.emit(runId, 'run.running', {}, 'RUNNING');
-            void handle.completed.then(() => finish('SUCCEEDED', 'run.completed', { subtype: 'stream_closed' }), (error) => finish('FAILED', 'run.failed', {
-                code: error instanceof Error ? error.message : 'CLAUDE_RUN_FAILED'
-            }));
+            void handle.completed.then(() => finish('SUCCEEDED', 'run.completed', { subtype: 'stream_closed' }), (error) => finish('FAILED', 'run.failed', { code: safeErrorCode(error, 'CLAUDE_RUN_FAILED') }, error));
         }
         catch (error) {
-            finish('FAILED', 'run.failed', {
-                code: error instanceof Error ? error.message : 'CLAUDE_RUN_START_FAILED'
-            });
+            finish('FAILED', 'run.failed', { code: safeErrorCode(error, 'CLAUDE_RUN_START_FAILED') }, error, 'CLAUDE_RUN_START_FAILED');
         }
     }
 }

package/dist/runner/claude-code-runner.js

@@ -3,7 +3,7 @@ import { AbstractRunner } from './abstract-runner.js';
 import { claudeDefaultModel, declaredRunnerProfiles } from '../runner-profiles.js';
 import { withClaudePlanTag } from '../runner-command-engine.js';
 import { discoverNativeSessions, readNativeSession, readClaudeNativeContextUsage } from '../native-session-history.js';
-import { claudeDiscoveredSession, deduplicateDirectSessions, externalResumeFailureDetail, isNativeHistory, isWithinWorkspace, latestNativeActivity } from './codex/conversation-parser.js';
+import { claudeDiscoveredSession, deduplicateDirectSessions, isNativeHistory, isWithinWorkspace, latestNativeActivity } from './codex/conversation-parser.js';
 export class ClaudeCodeRunner extends AbstractRunner {
     client;
     environment;
@@ -102,11 +102,10 @@ export class ClaudeCodeRunner extends AbstractRunner {
             context.rememberManagedNative(external.externalSessionId, configured.id);
             return { session: configured, activity: 'IDLE' };
         }
-        catch (error) {
+        catch {
             return {
                 failureCode: 'RUNNER_RESUME_FAILED',
-                messageFailureCode: 'SESSION_RESUME_REJECTED',
-                failureDetail: externalResumeFailureDetail(error)
+                messageFailureCode: 'SESSION_RESUME_REJECTED'
             };
         }
     }

package/dist/runner/codex/conversation-parser.d.ts

@@ -1,7 +1,7 @@
 import type { NodeAgentSession, NodeConversationItem, NodeConversationTurn, NodeMessageAttachmentInput } from '../../database.js';
 export type PublicConversationItem = {
     readonly itemId: string;
-    readonly kind: 'reasoning_summary' | 'tool_call' | 'command_execution' | 'user_input_request' | 'plan' | 'context_compaction' | 'file_change' | 'unknown';
+    readonly kind: 'reasoning_summary' | 'tool_call' | 'command_execution' | 'user_input_request' | 'plan' | 'context_compaction' | 'file_change' | 'error' | 'unknown';
     readonly status: 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'DECLINED';
     readonly payload: Record<string, unknown>;
     readonly merge?: boolean;
@@ -32,8 +32,8 @@ export declare function mergeCodexCustomToolItems(invocation: NodeConversationIt
 export declare function coalesceImageGenerationItems(items: readonly NodeConversationItem[]): readonly NodeConversationItem[];
 export declare function codexPlanText(value: Record<string, unknown>): string | undefined;
 /**
- * Claude 标签式 Plan Mode 的最终计划以 `<proposed_plan>` 完整包裹输出；
- * 未闭合或缺失标签的文本保持普通 assistant 消息。
+ * A final Claude tagged Plan Mode plan is fully wrapped in `<proposed_plan>` tags;
+ * text with missing or unclosed tags remains a regular assistant message.
  */
 export declare function codexOfficialItem(session: NodeAgentSession, nativeTurnId: string, value: unknown, turnSequence: number, itemSequence: number, startedAt: number | null, completedAt: number | null): NodeConversationItem | undefined;
 export declare function codexLiveConversationItem(value: Record<string, unknown>, completed: boolean, imageAttachments?: readonly Record<string, unknown>[]): PublicConversationItem | undefined;

package/dist/runner/codex/conversation-parser.js

@@ -83,6 +83,7 @@ export function codexOfficialTurn(session, value, sequence, managedTurn) {
         const consumedOfficialIds = new Set();
         const officialUser = officialItems.find((item) => item.kind === 'user_message');
         const officialAssistants = officialItems.filter((item) => item.kind === 'assistant_message');
+        const officialContextCompactions = officialItems.filter((item) => item.kind === 'context_compaction');
         const officialItemMarker = `:official:${value.id}:`;
         const officialByNativeId = new Map(officialItems.flatMap((item) => {
             const markerIndex = item.id.lastIndexOf(officialItemMarker);
@@ -95,6 +96,8 @@ export function codexOfficialTurn(session, value, sequence, managedTurn) {
             let replacement;
             if (managedItem.kind === 'user_message')
                 replacement = officialUser;
+            else if (managedItem.kind === 'context_compaction')
+                replacement = officialContextCompactions.find((item) => !consumedOfficialIds.has(item.id));
             else {
                 const nativeId = conversationItemNativeId(managedItem.id);
                 if (nativeId !== undefined)
@@ -201,6 +204,11 @@ export function codexOfficialItems(session, nativeTurnId, values, turnSequence,
         const item = codexOfficialItem(session, nativeTurnId, value, turnSequence, itemSequence, startedAt, completedAt);
         if (item === undefined)
             continue;
+        // Codex persists one compaction as both `compacted` state and a
+        // `context_compacted` event. App Server normalizes both records to
+        // consecutive `contextCompaction` items without preserving their source.
+        if (item.kind === 'context_compaction' && items.at(-1)?.kind === 'context_compaction')
+            continue;
         const key = codexPairedToolCallId(value);
         if (key === undefined) {
             items.push(item);
@@ -295,8 +303,8 @@ export function codexPlanText(value) {
     return plan.length > 0 ? plan : undefined;
 }
 /**
- * Claude 标签式 Plan Mode 的最终计划以 `<proposed_plan>` 完整包裹输出；
- * 未闭合或缺失标签的文本保持普通 assistant 消息。
+ * A final Claude tagged Plan Mode plan is fully wrapped in `<proposed_plan>` tags;
+ * text with missing or unclosed tags remains a regular assistant message.
  */
 export function codexOfficialItem(session, nativeTurnId, value, turnSequence, itemSequence, startedAt, completedAt) {
     if (!isPlainRecord(value) || typeof value.type !== 'string')
@@ -361,7 +369,7 @@ export function codexOfficialItem(session, nativeTurnId, value, turnSequence, it
             payload: {
                 command: typeof value.command === 'string'
                     ? compactRunnerText(value.command, 10_000)
-                    : '（未提供命令）',
+                    : '(No command provided)',
                 cwd: typeof value.cwd === 'string' ? compactRunnerText(value.cwd, 4_096) : null,
                 outputPreview: compactRunnerText(output, 10_000),
                 outputRef: null,
@@ -415,7 +423,7 @@ export function codexOfficialItem(session, nativeTurnId, value, turnSequence, it
                 namespace: 'codex',
                 toolName: 'imagegen',
                 inputSummary: typeof value.revisedPrompt === 'string' ? value.revisedPrompt : null,
-                outputSummary: value.status === 'completed' ? '图片生成完成' : '图片生成失败',
+                outputSummary: value.status === 'completed' ? 'Image generation completed' : 'Image generation failed',
                 progressLabel: null,
                 errorCode: value.status === 'failed' ? 'IMAGE_GENERATION_FAILED' : null,
                 truncated: false
@@ -456,7 +464,11 @@ export function codexOfficialItem(session, nativeTurnId, value, turnSequence, it
         return {
             ...base,
             kind: 'context_compaction',
-            payload: { phase: 'COMPLETED', summary: '上下文已整理' }
+            payload: {
+                phase: 'COMPLETED',
+                summary: 'Context compacted',
+                summaryCode: 'CONTEXT_COMPACTED'
+            }
         };
     return codexUnknownOfficialItem(base, value);
 }
@@ -501,7 +513,7 @@ export function codexLiveConversationItem(value, completed, imageAttachments = [
             payload: {
                 command: typeof value.command === 'string'
                     ? compactRunnerText(value.command, 10_000)
-                    : '（未提供命令）',
+                    : '(No command provided)',
                 cwd: typeof value.cwd === 'string' ? compactRunnerText(value.cwd, 4_096) : null,
                 outputPreview: compactRunnerText(output, 10_000),
                 outputRef: null,
@@ -550,7 +562,8 @@ export function codexLiveConversationItem(value, completed, imageAttachments = [
                 title: 'Web Search',
                 inputSummary: typeof value.query === 'string' ? compactRunnerText(value.query, 10_000) : null,
                 outputSummary: null,
-                progressLabel: completed ? null : '正在搜索',
+                progressLabel: completed ? null : 'Searching',
+                progressLabelCode: completed ? null : 'SEARCHING',
                 errorCode: null,
                 truncated: false
             }
@@ -575,8 +588,10 @@ export function codexLiveConversationItem(value, completed, imageAttachments = [
                 inputSummary: typeof value.revisedPrompt === 'string'
                     ? compactRunnerText(value.revisedPrompt, 10_000)
                     : null,
-                outputSummary: completed ? '图片生成完成' : null,
-                progressLabel: completed ? null : '正在生成图片',
+                outputSummary: completed ? 'Image generation completed' : null,
+                outputSummaryCode: completed ? 'IMAGE_GENERATION_COMPLETED' : null,
+                progressLabel: completed ? null : 'Generating image',
+                progressLabelCode: completed ? null : 'GENERATING_IMAGE',
                 errorCode: value.status === 'failed' ? 'IMAGE_GENERATION_FAILED' : null,
                 truncated: false,
                 ...(imageAttachments.length === 0 ? {} : { attachments: imageAttachments })
@@ -704,7 +719,9 @@ export function codexImageAttachments(value) {
                 totalBytes + Buffer.byteLength(dataBase64, 'base64') <= MAX_COMPOSER_ATTACHMENTS_BYTES) {
                 totalBytes += Buffer.byteLength(dataBase64, 'base64');
                 found.push({
-                    name: typeof current.name === 'string' ? current.name : `生成图片-${found.length + 1}.png`,
+                    name: typeof current.name === 'string'
+                        ? current.name
+                        : `generated-image-${found.length + 1}.png`,
                     mime,
                     dataBase64
                 });
@@ -802,10 +819,14 @@ export function codexToolOutput(value) {
             return [block.content];
         return [];
     });
-    return text.length > 0 ? text.join('') : value.some(isCodexImageBlock) ? '图片已生成' : value;
+    return text.length > 0
+        ? text.join('')
+        : value.some(isCodexImageBlock)
+            ? 'Image generated'
+            : value;
 }
 export function codexVisibleToolText(value) {
-    return value.replace(/(["']image_url["']\s*:\s*["'])data:image\/[^"']+(["'])/g, '$1[图片内容已提取]$2');
+    return value.replace(/(["']image_url["']\s*:\s*["'])data:image\/[^"']+(["'])/g, '$1[Image content extracted]$2');
 }
 export function isCodexImageBlock(value) {
     if (!isPlainRecord(value))

package/dist/runner/codex/managed-run-controller.d.ts

@@ -44,14 +44,13 @@ export interface CodexManagedRunHost<TAttachment> {
     }): void;
     emitItem(runId: string, item: {
         readonly itemId: string;
-        readonly kind: 'reasoning_summary' | 'tool_call' | 'command_execution' | 'user_input_request' | 'plan' | 'context_compaction' | 'file_change' | 'unknown';
+        readonly kind: 'reasoning_summary' | 'tool_call' | 'command_execution' | 'user_input_request' | 'plan' | 'context_compaction' | 'file_change' | 'error' | 'unknown';
         readonly status: 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'DECLINED';
         readonly payload: Record<string, unknown>;
         readonly merge?: boolean;
         readonly append?: 'sections' | 'outputPreview' | 'outputSummary';
     }): void;
     appendImages(runId: string, images: readonly NodeMessageAttachmentInput[]): readonly Record<string, unknown>[];
-    captureSnapshot(runId: string, cwd: string): Promise<void>;
     syncTitle(sessionId: string, nativeSessionId: string, cwd: string): Promise<void>;
     commandState(sessionId: string, commandId: string): RunnerCommandState | undefined;
     setCommandState(sessionId: string, state: RunnerCommandState): void;
@@ -76,5 +75,6 @@ export declare class CodexManagedRunController<TAttachment> {
     private requestUserInput;
     start(envelope: NodeEnvelope): void;
     private run;
+    private emitError;
 }
 export {};