@myagentroam/node 0.1.8 → 0.9.2

package/dist/native-session-history.js

@@ -286,7 +286,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 +301,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 +591,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 +620,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 +636,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 +659,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 +709,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 +834,7 @@ function compactValue(value, limit) {
             text = JSON.stringify(value);
         }
         catch {
-            return { text: '（无法显示）', truncated: false };
+            return { text: '(Unable to display)', truncated: false };
         }
     }
     return {
@@ -812,7 +870,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);
 }

package/dist/opencode-server.d.ts

@@ -16,6 +16,7 @@ export declare class OpenCodeServerClient {
     start(): Promise<void>;
     private startServer;
     providers(directory: string): Promise<OpenCodeProviderCatalog>;
+    configureMcp(directory: string, mcp: unknown): Promise<void>;
     sessions(directory: string, limit?: number): Promise<readonly unknown[]>;
     sessionStatus(directory: string): Promise<Readonly<Record<string, unknown>>>;
     createSession(directory: string, title?: string): Promise<unknown>;

package/dist/opencode-server.js

@@ -77,6 +77,18 @@ export class OpenCodeServerClient {
         const client = await this.requireClient();
         return unwrap(await client.provider.list({ directory }));
     }
+    async configureMcp(directory, mcp) {
+        const client = await this.requireClient();
+        if (typeof mcp !== 'object' || mcp === null || Array.isArray(mcp))
+            return;
+        for (const [name, config] of Object.entries(mcp)) {
+            await client.mcp.add({
+                directory,
+                name,
+                config: config
+            });
+        }
+    }
     async sessions(directory, limit = 100) {
         const client = await this.requireClient();
         return unwrap(await client.session.list({ directory, limit }));

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

@@ -21,14 +21,15 @@ export declare abstract class AbstractRunner<TName extends RegisteredRunnerName
     abstract profile(capabilities: NodeCapabilities): RunnerProfile | undefined;
     refreshProfile(capabilities: NodeCapabilities, workspace?: NodeWorkspace, environment?: Readonly<Record<string, string>>): Promise<RunnerProfile | undefined>;
     abstract available(capabilities: NodeCapabilities): boolean;
-    abstract defaultConfiguration(workspace?: NodeWorkspace): RunnerDefaultConfiguration;
-    supportsConfiguration(configuration: RunnerDefaultConfiguration, workspace?: NodeWorkspace): boolean;
+    abstract defaultConfiguration(workspace?: NodeWorkspace, environment?: Readonly<Record<string, string>>): RunnerDefaultConfiguration;
+    supportsConfiguration(configuration: RunnerDefaultConfiguration, workspace?: NodeWorkspace, environment?: Readonly<Record<string, string>>): boolean;
     protected abstract profileForValidation(): RunnerProfile;
     abstract resumeExternal(session: NodeAgentSession, context: ExternalResumeContext, force?: boolean): Promise<ExternalResumeResult>;
     abstract discoverSessions(context: RunnerDiscoveryContext, workspace?: NodeWorkspace): Promise<readonly NodeAgentSession[]>;
     abstract readContextUsage(session: NodeAgentSession): Promise<RunnerContextUsage | undefined>;
     presentSession(session: NodeAgentSession, capabilities: NodeCapabilities, context: RunnerSessionPresentationContext): RunnerSessionPresentation;
     prepareMessageInput(input: string, collaborationMode: 'default' | 'plan'): string;
+    mcpConfiguration(rawInstallations: unknown, secretEnvironment: Readonly<Record<string, string>>): unknown;
     channelToken(sessionId: string): string | undefined;
     deliverChannel(sessionId: string, messageId: string, senderId: string, token: string, content: string, notify: (runId: string, messageId: string, delivery: ChannelDelivery) => void): ChannelDelivery;
     executeGlobalCommand(commandId: string, input: string): unknown;
@@ -52,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;
@@ -66,6 +67,15 @@ export declare abstract class AbstractRunner<TName extends RegisteredRunnerName
         readonly secretEnvironment: Readonly<Record<string, string>>;
     }): Promise<unknown>;
 }
+export interface ResolvedMcpServer {
+    readonly name: string;
+    readonly transport: 'STDIO' | 'HTTP';
+    readonly command?: string;
+    readonly args?: readonly string[];
+    readonly environment?: Readonly<Record<string, string>>;
+    readonly url?: string;
+    readonly headers?: Readonly<Record<string, string>>;
+}
 export type RunnerCancellationIntent = 'CANCEL' | 'INTERRUPT';
 export interface RunnerControl {
     start(envelope: NodeEnvelope): void;

package/dist/runner/abstract-runner.js

@@ -1,3 +1,4 @@
+import { mcpRuntimeDescriptorSchema } from '@myagentroam/protocol';
 /**
  * Stable lifecycle boundary for every Node Runner implementation.
  *
@@ -15,8 +16,8 @@ export class AbstractRunner {
         void [workspace, environment];
         return this.profile(capabilities);
     }
-    supportsConfiguration(configuration, workspace) {
-        void workspace;
+    supportsConfiguration(configuration, workspace, environment) {
+        void [workspace, environment];
         const profile = this.profileForValidation();
         const model = profile.models.find((candidate) => candidate.id === configuration.model);
         return (configuration.runner === this.name &&
@@ -32,6 +33,9 @@ export class AbstractRunner {
         void collaborationMode;
         return input;
     }
+    mcpConfiguration(rawInstallations, secretEnvironment) {
+        return resolvedMcpServers(rawInstallations, secretEnvironment);
+    }
     channelToken(sessionId) {
         void sessionId;
         return undefined;
@@ -102,9 +106,9 @@ export class AbstractRunner {
     acceptsTruncatedNativeHistory() {
         return true;
     }
-    nativeImageRoot(session) {
+    nativeImageRoots(session) {
         void session;
-        return undefined;
+        return [];
     }
     managedRunForNativeTurn(nativeTurnId) {
         void nativeTurnId;
@@ -143,6 +147,76 @@ export class AbstractRunner {
         return this.commandControl.execute(session, command, input, context);
     }
 }
+function resolvedMcpServers(raw, secrets) {
+    if (!Array.isArray(raw))
+        return [];
+    const result = [];
+    for (const value of raw) {
+        if (value === null || typeof value !== 'object' || Array.isArray(value))
+            continue;
+        const record = value;
+        if (typeof record['serverName'] !== 'string' || record['enabled'] !== true)
+            continue;
+        const runtime = mcpRuntimeDescriptorSchema.safeParse(record['runtime']);
+        if (!runtime.success)
+            continue;
+        const configuration = isRecord(record['configuration']) ? record['configuration'] : {};
+        const resolveReferences = (candidate) => {
+            if (!isRecord(candidate))
+                return {};
+            const result = {};
+            for (const [name, reference] of Object.entries(candidate)) {
+                if (!isRecord(reference) || typeof reference['secretName'] !== 'string')
+                    return undefined;
+                const secret = secrets[reference['secretName']];
+                if (secret === undefined)
+                    return undefined;
+                result[name] = secret;
+            }
+            return result;
+        };
+        if (runtime.data.transport === 'STDIO') {
+            const runtimeEnvironment = resolveReferences(runtime.data.environment);
+            const configuredEnvironment = resolveReferences(configuration['environment']);
+            if (runtimeEnvironment === undefined || configuredEnvironment === undefined)
+                continue;
+            result.push({
+                name: record['serverName'],
+                transport: 'STDIO',
+                command: runtime.data.command,
+                args: [
+                    ...runtime.data.args,
+                    ...(Array.isArray(configuration['arguments'])
+                        ? configuration['arguments'].filter((item) => typeof item === 'string')
+                        : [])
+                ],
+                environment: {
+                    ...runtimeEnvironment,
+                    ...configuredEnvironment
+                }
+            });
+        }
+        else {
+            const runtimeHeaders = resolveReferences(runtime.data.headers);
+            const configuredHeaders = resolveReferences(configuration['headers']);
+            if (runtimeHeaders === undefined || configuredHeaders === undefined)
+                continue;
+            result.push({
+                name: record['serverName'],
+                transport: 'HTTP',
+                url: runtime.data.url,
+                headers: {
+                    ...runtimeHeaders,
+                    ...configuredHeaders
+                }
+            });
+        }
+    }
+    return result;
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
 export class RunnerCapabilityError extends Error {
     runner;
     capability;

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

@@ -4,6 +4,7 @@ import { boundedConversationItemId, claudePlanText, compactRunnerText, compactRu
 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';
 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: 'Implement', 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({
@@ -138,6 +139,7 @@ export class ClaudeManagedRunController {
                 ...(typeof payload.effort === 'string' ? { effort: payload.effort } : {}),
                 ...(typeof payload.access === 'string' ? { access: payload.access } : {}),
                 environment: secretEnvironment,
+                mcpServers: this.runner.mcpConfiguration(payload.mcpInstallations, secretEnvironment),
                 ...(attachments.length === 0
                     ? {}
                     : {
@@ -254,14 +256,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
                             });
@@ -314,12 +325,12 @@ export class ClaudeManagedRunController {
             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'
+                code: safeErrorCode(error, 'CLAUDE_RUN_FAILED')
             }));
         }
         catch (error) {
             finish('FAILED', 'run.failed', {
-                code: error instanceof Error ? error.message : 'CLAUDE_RUN_START_FAILED'
+                code: safeErrorCode(error, 'CLAUDE_RUN_START_FAILED')
             });
         }
     }

package/dist/runner/claude-code-runner.d.ts

@@ -17,6 +17,7 @@ export declare class ClaudeCodeRunner extends AbstractRunner<'claude-code'> {
     available(capabilities: NodeCapabilities): boolean;
     protected profileForValidation(): RunnerProfile;
     defaultConfiguration(): RunnerDefaultConfiguration;
+    mcpConfiguration(raw: unknown, secrets: Readonly<Record<string, string>>): unknown;
     resumeExternal(external: NodeAgentSession, context: ExternalResumeContext): Promise<ExternalResumeResult>;
     discoverSessions(context: RunnerDiscoveryContext, workspace?: NodeWorkspace): Promise<readonly NodeAgentSession[]>;
     readContextUsage(session: NodeAgentSession): Promise<import("../native-session-history.js").NativeClaudeContextUsage | undefined>;

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;
@@ -45,6 +45,20 @@ export class ClaudeCodeRunner extends AbstractRunner {
             access: 'default'
         };
     }
+    mcpConfiguration(raw, secrets) {
+        const servers = super.mcpConfiguration(raw, secrets);
+        return Object.fromEntries(servers.map((server) => [
+            server.name,
+            server.transport === 'STDIO'
+                ? {
+                    type: 'stdio',
+                    command: server.command,
+                    args: [...(server.args ?? [])],
+                    env: { ...(server.environment ?? {}) }
+                }
+                : { type: 'http', url: server.url, headers: { ...(server.headers ?? {}) } }
+        ]));
+    }
     async resumeExternal(external, context) {
         if (external.runner !== this.name ||
             external.nativeControl !== 'EXTERNAL' ||
@@ -88,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

@@ -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

@@ -201,6 +201,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 +300,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 +366,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 +420,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 +461,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 +510,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 +559,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 +585,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 +716,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 +816,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))