@myagentroam/node 0.1.3 → 0.1.6

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

@@ -0,0 +1,816 @@
+const MAX_COMPOSER_ATTACHMENT_BYTES = 5 * 1024 * 1024;
+const MAX_COMPOSER_ATTACHMENTS_BYTES = 10 * 1024 * 1024;
+export * from '../../util/runner-native-session-parsers.js';
+export function codexOfficialConversationPage(session, result, input, managedTurnForNative) {
+    if (!isPlainRecord(result) || !isPlainRecord(result.thread))
+        return undefined;
+    const thread = result.thread;
+    if (thread.id !== session.externalSessionId || !Array.isArray(thread.turns))
+        return undefined;
+    const parsedTurns = thread.turns.flatMap((value, sequence) => {
+        const nativeTurnId = typeof value === 'object' && value !== null && typeof value.id === 'string'
+            ? value.id
+            : undefined;
+        const turn = codexOfficialTurn(session, value, sequence, nativeTurnId === undefined ? undefined : managedTurnForNative(nativeTurnId));
+        return turn === undefined || nativeTurnId === undefined ? [] : [{ nativeTurnId, turn }];
+    });
+    const allTurns = parsedTurns.map(({ nativeTurnId, turn }, index) => ({
+        ...turn,
+        rewind: { before: parsedTurns[index - 1]?.nativeTurnId ?? null, after: nativeTurnId }
+    }));
+    if (allTurns.length === 0)
+        return undefined;
+    const limit = Math.min(Math.max(input.limit ?? 30, 1), 500);
+    const end = nativePageEnd(input.cursor, session.id, allTurns.length);
+    const start = Math.max(0, end - limit);
+    return {
+        turns: allTurns.slice(start, end),
+        nextCursor: start > 0
+            ? Buffer.from(JSON.stringify({ sessionId: session.id, end: start })).toString('base64url')
+            : null
+    };
+}
+export function codexOfficialTurn(session, value, sequence, managedTurn) {
+    if (!isPlainRecord(value) || typeof value.id !== 'string' || !Array.isArray(value.items))
+        return undefined;
+    const startedAt = codexTimestamp(value.startedAt);
+    const completedAt = codexTimestamp(value.completedAt) ?? startedAt;
+    const items = codexOfficialItems(session, value.id, value.items, sequence, startedAt, completedAt);
+    if (items.length === 0)
+        return undefined;
+    if (managedTurn !== undefined) {
+        const localUser = managedTurn.items.find((item) => item.kind === 'user_message');
+        const officialNativeItemIds = codexNativeItemIds(value.items);
+        const officialAssistantCount = items.filter((item) => item.kind === 'assistant_message').length;
+        const officialAssistantMessage = officialAssistantCount > 0;
+        const managedAssistants = managedTurn.items.filter((item) => item.kind === 'assistant_message');
+        const managedAssistantCandidates = officialAssistantCount === 0 ? [] : managedAssistants.slice(-officialAssistantCount);
+        const assistantLength = (values) => values.reduce((length, item) => {
+            if (item.kind !== 'assistant_message' || !isPlainRecord(item.payload))
+                return length;
+            return length + (typeof item.payload.text === 'string' ? item.payload.text.length : 0);
+        }, 0);
+        const preferLocalAssistant = officialAssistantMessage &&
+            (assistantLength(managedAssistantCandidates) > assistantLength(items) ||
+                ((managedTurn.completedAt ?? 0) > (completedAt ?? 0) &&
+                    assistantLength(managedAssistantCandidates) > 0));
+        const replacedManagedAssistantIds = new Set(preferLocalAssistant
+            ? []
+            : officialAssistantCount === 0
+                ? []
+                : managedAssistantCandidates.map((item) => item.id));
+        const localLiveItems = managedTurn.items.filter((item) => {
+            if (item.kind === 'user_message')
+                return false;
+            // `item/agentMessage/delta` uses a synthetic runtime ID. Once
+            // `thread/read` returns the final Agent message, it is the same reply
+            // without a shared native item ID and must replace that transient item.
+            if (item.kind === 'assistant_message' && replacedManagedAssistantIds.has(item.id))
+                return false;
+            const nativeItemId = conversationItemNativeId(item.id);
+            return nativeItemId === undefined || !officialNativeItemIds.has(nativeItemId);
+        });
+        const officialItems = [
+            ...retainManagedImageAttachments(managedTurn, value.id, items
+                .filter((item) => item.kind !== 'assistant_message' || !preferLocalAssistant)
+                .map((item) => item.kind === 'user_message' && localUser !== undefined
+                ? { ...localUser, turnId: managedTurn.id }
+                : { ...item, turnId: managedTurn.id, runId: managedTurn.runId }))
+        ];
+        if (localUser !== undefined && !officialItems.some((item) => item.kind === 'user_message'))
+            officialItems.unshift({ ...localUser, turnId: managedTurn.id });
+        const retainedLocalIds = new Set(localLiveItems.map((item) => item.id));
+        const consumedOfficialIds = new Set();
+        const officialUser = officialItems.find((item) => item.kind === 'user_message');
+        const officialAssistants = officialItems.filter((item) => item.kind === 'assistant_message');
+        const officialItemMarker = `:official:${value.id}:`;
+        const officialByNativeId = new Map(officialItems.flatMap((item) => {
+            const markerIndex = item.id.lastIndexOf(officialItemMarker);
+            return markerIndex < 0
+                ? []
+                : [[item.id.slice(markerIndex + officialItemMarker.length), item]];
+        }));
+        const reconciledItems = [];
+        for (const managedItem of managedTurn.items) {
+            let replacement;
+            if (managedItem.kind === 'user_message')
+                replacement = officialUser;
+            else {
+                const nativeId = conversationItemNativeId(managedItem.id);
+                if (nativeId !== undefined)
+                    replacement = officialByNativeId.get(nativeId);
+                if (replacement === undefined &&
+                    managedItem.kind === 'assistant_message' &&
+                    replacedManagedAssistantIds.has(managedItem.id))
+                    replacement = officialAssistants.find((item) => !consumedOfficialIds.has(item.id));
+            }
+            if (replacement !== undefined) {
+                if (!consumedOfficialIds.has(replacement.id)) {
+                    reconciledItems.push(replacement);
+                    consumedOfficialIds.add(replacement.id);
+                }
+            }
+            else if (retainedLocalIds.has(managedItem.id))
+                reconciledItems.push(managedItem);
+        }
+        for (const item of officialItems)
+            if (!consumedOfficialIds.has(item.id))
+                reconciledItems.push(item);
+        return {
+            ...managedTurn,
+            status: 'SUCCEEDED',
+            // Reconcile against the managed runtime order. Official items replace
+            // matching live projections in place; newly visible terminal items such
+            // as a plan are appended after the commentary and tools that preceded it.
+            items: reconciledItems,
+            startedAt,
+            completedAt
+        };
+    }
+    return {
+        id: `${session.id}:official:${value.id}`,
+        sessionId: session.id,
+        runId: null,
+        userItemId: items.find((item) => item.kind === 'user_message')?.id ?? null,
+        status: 'SUCCEEDED',
+        model: null,
+        effort: null,
+        access: null,
+        items,
+        startedAt,
+        completedAt
+    };
+}
+/**
+ * Codex's authoritative thread records omit MAR's Node-local generated-image
+ * references. Preserve those references like user-image metadata: cache expiry
+ * only makes the bytes unavailable, while the conversation still renders its
+ * image placeholder.
+ */
+export function retainManagedImageAttachments(managedTurn, nativeTurnId, officialItems) {
+    const localAttachments = new Map();
+    for (const item of managedTurn.items) {
+        const nativeItemId = conversationItemNativeId(item.id);
+        if (nativeItemId === undefined || !isPlainRecord(item.payload))
+            continue;
+        if (!Array.isArray(item.payload.attachments) || item.payload.attachments.length === 0)
+            continue;
+        localAttachments.set(nativeItemId, item.payload.attachments);
+    }
+    if (localAttachments.size === 0)
+        return officialItems;
+    const marker = `:official:${nativeTurnId}:`;
+    return officialItems.map((item) => {
+        if (!isPlainRecord(item.payload) || Array.isArray(item.payload.attachments))
+            return item;
+        const markerIndex = item.id.lastIndexOf(marker);
+        if (markerIndex < 0)
+            return item;
+        const attachments = localAttachments.get(item.id.slice(markerIndex + marker.length));
+        return attachments === undefined
+            ? item
+            : { ...item, payload: { ...item.payload, attachments } };
+    });
+}
+export function codexNativeItemIds(values) {
+    return new Set(values.flatMap((value) => {
+        if (!isPlainRecord(value))
+            return [];
+        const id = typeof value.call_id === 'string'
+            ? value.call_id
+            : typeof value.id === 'string'
+                ? value.id
+                : undefined;
+        return id === undefined ? [] : [id];
+    }));
+}
+export function conversationItemNativeId(itemId) {
+    if (itemId.startsWith('codex:'))
+        return itemId.slice('codex:'.length);
+    const marker = ':codex:';
+    const markerIndex = itemId.lastIndexOf(marker);
+    return markerIndex < 0 ? undefined : itemId.slice(markerIndex + marker.length);
+}
+/** Keep a custom tool invocation and its output in one Workbench card. */
+export function codexOfficialItems(session, nativeTurnId, values, turnSequence, startedAt, completedAt) {
+    const items = [];
+    const pairedToolIndexes = new Map();
+    // App Server preserves execution order within a Turn. Keep that order while
+    // merging a paired tool invocation with its output into one Workbench card.
+    for (const [itemSequence, value] of values.entries()) {
+        const item = codexOfficialItem(session, nativeTurnId, value, turnSequence, itemSequence, startedAt, completedAt);
+        if (item === undefined)
+            continue;
+        const key = codexPairedToolCallId(value);
+        if (key === undefined) {
+            items.push(item);
+            continue;
+        }
+        const existingIndex = pairedToolIndexes.get(key);
+        if (existingIndex === undefined) {
+            pairedToolIndexes.set(key, items.length);
+            items.push(item);
+            continue;
+        }
+        const previous = items[existingIndex];
+        const invocation = isPlainRecord(value) && (value.type === 'custom_tool_call' || value.type === 'function_call')
+            ? item
+            : previous;
+        const result = invocation === item ? previous : item;
+        items[existingIndex] = mergeCodexCustomToolItems(invocation, result);
+    }
+    return items;
+}
+export function codexPairedToolCallId(value) {
+    if (!isPlainRecord(value))
+        return undefined;
+    if (value.type !== 'custom_tool_call' &&
+        value.type !== 'custom_tool_call_output' &&
+        value.type !== 'function_call' &&
+        value.type !== 'function_call_output')
+        return undefined;
+    return typeof value.call_id === 'string'
+        ? value.call_id
+        : typeof value.id === 'string'
+            ? value.id
+            : undefined;
+}
+export function mergeCodexCustomToolItems(invocation, result) {
+    if (invocation.kind !== 'tool_call' || result.kind !== 'tool_call')
+        return invocation;
+    const invocationPayload = isPlainRecord(invocation.payload) ? invocation.payload : {};
+    const resultPayload = isPlainRecord(result.payload) ? result.payload : {};
+    return {
+        ...invocation,
+        status: result.status,
+        completedAt: result.completedAt,
+        payload: {
+            ...invocationPayload,
+            outputSummary: resultPayload.outputSummary ?? invocationPayload.outputSummary,
+            errorCode: resultPayload.errorCode ?? invocationPayload.errorCode,
+            truncated: invocationPayload.truncated === true || resultPayload.truncated === true,
+            ...(resultPayload.attachments === undefined ? {} : { attachments: resultPayload.attachments })
+        }
+    };
+}
+export function coalesceImageGenerationItems(items) {
+    const merged = [];
+    for (const item of items) {
+        const payload = isPlainRecord(item.payload) ? item.payload : undefined;
+        const previous = merged.at(-1);
+        const previousPayload = previous !== undefined && isPlainRecord(previous.payload) ? previous.payload : undefined;
+        if (item.kind !== 'tool_call' ||
+            payload?.toolName !== 'imagegen' ||
+            previous?.kind !== 'tool_call' ||
+            previousPayload?.toolName !== 'imagegen') {
+            merged.push(item);
+            continue;
+        }
+        const attachments = [
+            ...(Array.isArray(previousPayload.attachments) ? previousPayload.attachments : []),
+            ...(Array.isArray(payload.attachments) ? payload.attachments : [])
+        ];
+        merged[merged.length - 1] = {
+            ...previous,
+            completedAt: item.completedAt ?? previous.completedAt,
+            payload: { ...previousPayload, attachments }
+        };
+    }
+    return merged;
+}
+export function codexPlanText(value) {
+    if (typeof value.type !== 'string' || typeof value.text !== 'string')
+        return undefined;
+    const text = value.text.trim();
+    if (text.length === 0)
+        return undefined;
+    if (value.type.toLocaleLowerCase() === 'plan')
+        return text;
+    if (value.type !== 'agentMessage' || !text.startsWith('<proposed_plan>'))
+        return undefined;
+    const plan = text
+        .slice('<proposed_plan>'.length)
+        .replace(/<\/proposed_plan>\s*$/, '')
+        .trim();
+    return plan.length > 0 ? plan : undefined;
+}
+/**
+ * Claude 标签式 Plan Mode 的最终计划以 `<proposed_plan>` 完整包裹输出；
+ * 未闭合或缺失标签的文本保持普通 assistant 消息。
+ */
+export function codexOfficialItem(session, nativeTurnId, value, turnSequence, itemSequence, startedAt, completedAt) {
+    if (!isPlainRecord(value) || typeof value.type !== 'string')
+        return undefined;
+    const id = (value.type === 'custom_tool_call' ||
+        value.type === 'custom_tool_call_output' ||
+        value.type === 'function_call' ||
+        value.type === 'function_call_output') &&
+        typeof value.call_id === 'string'
+        ? value.call_id
+        : typeof value.id === 'string'
+            ? value.id
+            : typeof value.call_id === 'string'
+                ? value.call_id
+                : `${nativeTurnId}:${itemSequence}`;
+    const base = {
+        id: `${session.id}:official:${nativeTurnId}:${id}`,
+        sessionId: session.id,
+        turnId: `${session.id}:official:${nativeTurnId}`,
+        runId: null,
+        parentItemId: null,
+        sourceSequence: turnSequence * 10_000 + itemSequence,
+        revision: 0,
+        status: 'COMPLETED',
+        startedAt,
+        completedAt
+    };
+    if (value.type === 'userMessage') {
+        const text = codexContentText(value.content);
+        return text.length === 0
+            ? undefined
+            : {
+                ...base,
+                kind: 'user_message',
+                payload: { clientMessageId: null, text, contexts: [], delivery: 'ACCEPTED' }
+            };
+    }
+    const planText = codexPlanText(value);
+    if (planText !== undefined)
+        return { ...base, kind: 'plan', payload: { explanation: planText, steps: [] } };
+    if (value.type === 'agentMessage' &&
+        typeof value.text === 'string' &&
+        value.text.trim().length > 0)
+        return {
+            ...base,
+            kind: 'assistant_message',
+            payload: { text: value.text, format: 'markdown', source: 'codex-app-server' }
+        };
+    if (value.type === 'reasoning') {
+        const sections = Array.isArray(value.summary)
+            ? value.summary.flatMap((text, index) => typeof text === 'string' && text.trim().length > 0
+                ? [{ index, text: compactRunnerText(text, 10_000) }]
+                : [])
+            : [];
+        return { ...base, kind: 'reasoning_summary', payload: { sections } };
+    }
+    if (value.type === 'commandExecution') {
+        const output = typeof value.aggregatedOutput === 'string' ? value.aggregatedOutput : '';
+        return {
+            ...base,
+            kind: 'command_execution',
+            payload: {
+                command: typeof value.command === 'string'
+                    ? compactRunnerText(value.command, 10_000)
+                    : '（未提供命令）',
+                cwd: typeof value.cwd === 'string' ? compactRunnerText(value.cwd, 4_096) : null,
+                outputPreview: compactRunnerText(output, 10_000),
+                outputRef: null,
+                exitCode: typeof value.exitCode === 'number' && Number.isInteger(value.exitCode)
+                    ? value.exitCode
+                    : null,
+                durationMs: typeof value.durationMs === 'number' &&
+                    Number.isInteger(value.durationMs) &&
+                    value.durationMs >= 0
+                    ? value.durationMs
+                    : null,
+                truncated: output.length > 10_000
+            }
+        };
+    }
+    if (value.type === 'mcpToolCall')
+        return {
+            ...base,
+            kind: 'tool_call',
+            payload: {
+                title: [
+                    typeof value.server === 'string' ? value.server : '',
+                    typeof value.tool === 'string' ? value.tool : ''
+                ]
+                    .filter(Boolean)
+                    .join('.'),
+                namespace: typeof value.server === 'string' ? value.server : '',
+                toolName: typeof value.tool === 'string' ? value.tool : '',
+                inputSummary: codexCompactJson(value.arguments),
+                outputSummary: codexCompactJson(value.result),
+                ...(value.error === undefined ? {} : { errorCode: codexCompactJson(value.error) })
+            }
+        };
+    if (value.type === 'webSearch')
+        return {
+            ...base,
+            kind: 'tool_call',
+            payload: {
+                title: 'Web Search',
+                namespace: 'web',
+                toolName: 'search',
+                inputSummary: typeof value.query === 'string' ? value.query : ''
+            }
+        };
+    if (value.type === 'imageGeneration')
+        return {
+            ...base,
+            kind: 'tool_call',
+            payload: {
+                title: 'imagegen',
+                namespace: 'codex',
+                toolName: 'imagegen',
+                inputSummary: typeof value.revisedPrompt === 'string' ? value.revisedPrompt : null,
+                outputSummary: value.status === 'completed' ? '图片生成完成' : '图片生成失败',
+                progressLabel: null,
+                errorCode: value.status === 'failed' ? 'IMAGE_GENERATION_FAILED' : null,
+                truncated: false
+            }
+        };
+    if (value.type === 'dynamicToolCall' ||
+        value.type === 'custom_tool_call' ||
+        value.type === 'custom_tool_call_output' ||
+        value.type === 'function_call' ||
+        value.type === 'function_call_output' ||
+        value.type === 'customToolCall' ||
+        value.type === 'customToolCallOutput' ||
+        value.type === 'functionCall' ||
+        value.type === 'functionCallOutput') {
+        const name = typeof value.tool === 'string'
+            ? value.tool
+            : typeof value.name === 'string'
+                ? value.name
+                : 'tool';
+        return {
+            ...base,
+            kind: 'tool_call',
+            payload: {
+                title: name,
+                namespace: typeof value.namespace === 'string' ? value.namespace : 'codex',
+                toolName: name,
+                inputSummary: codexCompactJson(value.arguments ?? value.input),
+                outputSummary: codexToolOutputSummary(value.contentItems ?? value.output),
+                progressLabel: null,
+                errorCode: null,
+                truncated: false
+            }
+        };
+    }
+    if (value.type === 'fileChange' && Array.isArray(value.changes))
+        return { ...base, kind: 'file_change', payload: { changes: value.changes } };
+    if (value.type === 'contextCompaction')
+        return {
+            ...base,
+            kind: 'context_compaction',
+            payload: { phase: 'COMPLETED', summary: '上下文已整理' }
+        };
+    return codexUnknownOfficialItem(base, value);
+}
+export function codexLiveConversationItem(value, completed, imageAttachments = []) {
+    if (typeof value.type !== 'string')
+        return undefined;
+    const nativeId = typeof value.call_id === 'string'
+        ? value.call_id
+        : typeof value.id === 'string'
+            ? value.id
+            : undefined;
+    if (nativeId === undefined)
+        return undefined;
+    const itemId = boundedConversationItemId('codex', nativeId);
+    if (value.type === 'reasoning') {
+        const sections = Array.isArray(value.summary)
+            ? value.summary.flatMap((text, index) => typeof text === 'string' && text.trim().length > 0
+                ? [{ index, text: compactRunnerText(text, 10_000) }]
+                : [])
+            : [];
+        return {
+            itemId,
+            kind: 'reasoning_summary',
+            status: completed ? 'COMPLETED' : 'IN_PROGRESS',
+            payload: { sections }
+        };
+    }
+    const planText = codexPlanText(value);
+    if (planText !== undefined)
+        return {
+            itemId,
+            kind: 'plan',
+            status: completed ? 'COMPLETED' : 'IN_PROGRESS',
+            payload: { explanation: compactRunnerText(planText, 20_000), steps: [] }
+        };
+    if (value.type === 'commandExecution') {
+        const output = typeof value.aggregatedOutput === 'string' ? value.aggregatedOutput : '';
+        return {
+            itemId,
+            kind: 'command_execution',
+            status: codexItemStatus(value.status, completed),
+            payload: {
+                command: typeof value.command === 'string'
+                    ? compactRunnerText(value.command, 10_000)
+                    : '（未提供命令）',
+                cwd: typeof value.cwd === 'string' ? compactRunnerText(value.cwd, 4_096) : null,
+                outputPreview: compactRunnerText(output, 10_000),
+                outputRef: null,
+                exitCode: typeof value.exitCode === 'number' && Number.isInteger(value.exitCode)
+                    ? value.exitCode
+                    : null,
+                durationMs: typeof value.durationMs === 'number' &&
+                    Number.isInteger(value.durationMs) &&
+                    value.durationMs >= 0
+                    ? value.durationMs
+                    : null,
+                truncated: output.length > 10_000
+            }
+        };
+    }
+    if (value.type === 'mcpToolCall') {
+        const input = compactRunnerValue(value.arguments, 10_000);
+        const output = compactRunnerValue(value.result, 10_000);
+        const error = compactRunnerValue(value.error, 80);
+        const server = typeof value.server === 'string' ? value.server : 'mcp';
+        const tool = typeof value.tool === 'string' ? value.tool : 'tool';
+        return {
+            itemId,
+            kind: 'tool_call',
+            status: codexItemStatus(value.status, completed),
+            payload: {
+                namespace: compactRunnerText(server, 128),
+                toolName: compactRunnerText(tool, 128),
+                title: compactRunnerText(`${server}.${tool}`, 500),
+                inputSummary: input.text || null,
+                outputSummary: output.text || null,
+                progressLabel: null,
+                errorCode: error.text || null,
+                truncated: input.truncated || output.truncated || error.truncated
+            }
+        };
+    }
+    if (value.type === 'webSearch')
+        return {
+            itemId,
+            kind: 'tool_call',
+            status: completed ? 'COMPLETED' : 'IN_PROGRESS',
+            payload: {
+                namespace: 'web',
+                toolName: 'search',
+                title: 'Web Search',
+                inputSummary: typeof value.query === 'string' ? compactRunnerText(value.query, 10_000) : null,
+                outputSummary: null,
+                progressLabel: completed ? null : '正在搜索',
+                errorCode: null,
+                truncated: false
+            }
+        };
+    if (value.type === 'fileChange' && Array.isArray(value.changes))
+        return {
+            itemId,
+            kind: 'file_change',
+            status: completed ? 'COMPLETED' : 'IN_PROGRESS',
+            payload: { changes: value.changes },
+            merge: true
+        };
+    if (value.type === 'imageGeneration')
+        return {
+            itemId,
+            kind: 'tool_call',
+            status: codexItemStatus(value.status, completed),
+            payload: {
+                namespace: 'codex',
+                toolName: 'imagegen',
+                title: 'imagegen',
+                inputSummary: typeof value.revisedPrompt === 'string'
+                    ? compactRunnerText(value.revisedPrompt, 10_000)
+                    : null,
+                outputSummary: completed ? '图片生成完成' : null,
+                progressLabel: completed ? null : '正在生成图片',
+                errorCode: value.status === 'failed' ? 'IMAGE_GENERATION_FAILED' : null,
+                truncated: false,
+                ...(imageAttachments.length === 0 ? {} : { attachments: imageAttachments })
+            },
+            merge: true
+        };
+    if (value.type === 'contextCompaction')
+        return {
+            itemId,
+            kind: 'context_compaction',
+            status: completed ? 'COMPLETED' : 'IN_PROGRESS',
+            payload: { phase: completed ? 'COMPLETED' : 'STARTED', summary: null }
+        };
+    if (value.type === 'dynamicToolCall' ||
+        value.type === 'custom_tool_call' ||
+        value.type === 'custom_tool_call_output' ||
+        value.type === 'function_call' ||
+        value.type === 'function_call_output' ||
+        value.type === 'customToolCall' ||
+        value.type === 'customToolCallOutput' ||
+        value.type === 'functionCall' ||
+        value.type === 'functionCallOutput') {
+        const name = typeof value.tool === 'string'
+            ? value.tool
+            : typeof value.name === 'string'
+                ? value.name
+                : 'tool';
+        const input = compactRunnerValue(value.arguments ?? value.input, 10_000);
+        const output = compactRunnerValue(codexToolOutput(value.contentItems ?? value.output), 10_000);
+        if (value.type === 'custom_tool_call_output' ||
+            value.type === 'function_call_output' ||
+            value.type === 'customToolCallOutput' ||
+            value.type === 'functionCallOutput')
+            return {
+                itemId,
+                kind: 'tool_call',
+                status: codexItemStatus(value.status, completed),
+                payload: {
+                    outputSummary: output.text || null,
+                    ...(imageAttachments.length === 0 ? {} : { attachments: imageAttachments })
+                },
+                merge: true
+            };
+        return {
+            itemId,
+            kind: 'tool_call',
+            status: codexItemStatus(value.status, completed),
+            payload: {
+                namespace: typeof value.namespace === 'string' ? compactRunnerText(value.namespace, 128) : 'codex',
+                toolName: compactRunnerText(name, 128),
+                title: compactRunnerText(name, 500),
+                inputSummary: input.text || null,
+                outputSummary: output.text || null,
+                progressLabel: null,
+                errorCode: null,
+                truncated: input.truncated || output.truncated,
+                ...(imageAttachments.length === 0 ? {} : { attachments: imageAttachments })
+            }
+        };
+    }
+    return codexUnknownLiveItem(itemId, value.type, completed);
+}
+function codexUnknownOfficialItem(base, value) {
+    if (value.type === 'userMessage' || value.type === 'agentMessage')
+        return undefined;
+    const type = typeof value.type === 'string' ? value.type : 'unknown';
+    return {
+        ...base,
+        kind: 'unknown',
+        payload: { sourceEventType: `codex:${type}`, label: `Codex ${compactRunnerText(type, 128)}` }
+    };
+}
+function codexUnknownLiveItem(itemId, type, completed) {
+    if (type === 'userMessage' || type === 'agentMessage')
+        return undefined;
+    return {
+        itemId,
+        kind: 'unknown',
+        status: completed ? 'COMPLETED' : 'IN_PROGRESS',
+        payload: { sourceEventType: `codex:${type}`, label: `Codex ${compactRunnerText(type, 128)}` }
+    };
+}
+export function codexImageAttachments(value) {
+    const found = [];
+    let totalBytes = 0;
+    const visit = (current, depth) => {
+        if (found.length >= 5 || depth > 4 || current === null || current === undefined)
+            return;
+        if (Array.isArray(current)) {
+            for (const entry of current)
+                visit(entry, depth + 1);
+            return;
+        }
+        if (!isPlainRecord(current))
+            return;
+        const type = typeof current.type === 'string' ? current.type : '';
+        if (type === 'input_text' && typeof current.text === 'string') {
+            const embeddedImage = /["']image_url["']\s*:\s*["'](data:image\/[^"']+)["']/.exec(current.text)?.[1];
+            if (embeddedImage !== undefined) {
+                visit({ type: 'input_image', image_url: embeddedImage }, depth + 1);
+            }
+        }
+        const rawData = typeof current.data === 'string' ? current.data : undefined;
+        const rawUrl = isPlainRecord(current.image_url)
+            ? typeof current.image_url.url === 'string'
+                ? current.image_url.url
+                : undefined
+            : typeof current.image_url === 'string'
+                ? current.image_url
+                : undefined;
+        const data = rawData ?? (rawUrl?.startsWith('data:') ? rawUrl : undefined);
+        if ((type === 'image' || type === 'input_image' || type === 'output_image') &&
+            data !== undefined) {
+            const match = /^data:([^;,]+);base64,(.*)$/.exec(data);
+            const mime = typeof current.mimeType === 'string'
+                ? current.mimeType
+                : typeof current.mime === 'string'
+                    ? current.mime
+                    : (match?.[1] ?? 'image/png');
+            const dataBase64 = match?.[2] ?? data;
+            if (mime.startsWith('image/') &&
+                isCanonicalBase64(dataBase64) &&
+                dataBase64.length > 0 &&
+                Buffer.byteLength(dataBase64, 'base64') <= MAX_COMPOSER_ATTACHMENT_BYTES &&
+                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`,
+                    mime,
+                    dataBase64
+                });
+            }
+        }
+        for (const [key, child] of Object.entries(current)) {
+            if (key === 'data' || key === 'image_url')
+                continue;
+            visit(child, depth + 1);
+        }
+    };
+    visit(value, 0);
+    return found;
+}
+export function codexUserInputQuestions(value) {
+    if (!Array.isArray(value) || value.length === 0 || value.length > 3)
+        return [];
+    const questions = value.map((raw) => {
+        if (!isPlainRecord(raw) || typeof raw.id !== 'string' || typeof raw.question !== 'string')
+            return undefined;
+        const options = Array.isArray(raw.options)
+            ? raw.options.flatMap((option) => isPlainRecord(option) && typeof option.label === 'string'
+                ? [
+                    {
+                        value: compactRunnerText(option.label, 500),
+                        label: compactRunnerText(option.label, 500),
+                        description: typeof option.description === 'string'
+                            ? compactRunnerText(option.description, 1_000)
+                            : null
+                    }
+                ]
+                : [])
+            : [];
+        return {
+            id: compactRunnerText(raw.id, 128),
+            prompt: compactRunnerText(raw.question, 5_000),
+            options,
+            allowOther: raw.isOther === true
+        };
+    });
+    return questions.some((question) => question === undefined)
+        ? []
+        : questions;
+}
+export function codexItemStatus(value, completed) {
+    if (value === 'failed')
+        return 'FAILED';
+    if (value === 'declined')
+        return 'DECLINED';
+    return completed || value === 'completed' ? 'COMPLETED' : 'IN_PROGRESS';
+}
+export function codexContentText(value) {
+    if (!Array.isArray(value))
+        return '';
+    return value
+        .flatMap((part) => {
+        if (typeof part === 'string')
+            return [part];
+        if (!isPlainRecord(part))
+            return [];
+        return typeof part.text === 'string' ? [part.text] : [];
+    })
+        .join('\n')
+        .trim();
+}
+export function codexCompactJson(value) {
+    if (value === undefined || value === null)
+        return '';
+    if (typeof value === 'string')
+        return compactRunnerText(value, 10_000);
+    try {
+        return compactRunnerText(JSON.stringify(value), 10_000);
+    }
+    catch {
+        return '';
+    }
+}
+export function codexToolOutputSummary(value) {
+    return codexCompactJson(codexToolOutput(value));
+}
+/** App Server custom output is an array of text blocks, not JSON to show verbatim. */
+export function codexToolOutput(value) {
+    if (!Array.isArray(value))
+        return value;
+    const text = value.flatMap((block) => {
+        if (typeof block === 'string')
+            return [block];
+        if (!isPlainRecord(block))
+            return [];
+        if (typeof block.text === 'string') {
+            const visible = codexVisibleToolText(block.text);
+            return visible.length > 0 ? [visible] : [];
+        }
+        if (typeof block.content === 'string')
+            return [block.content];
+        return [];
+    });
+    return text.length > 0 ? text.join('') : value.some(isCodexImageBlock) ? '图片已生成' : value;
+}
+export function codexVisibleToolText(value) {
+    return value.replace(/(["']image_url["']\s*:\s*["'])data:image\/[^"']+(["'])/g, '$1[图片内容已提取]$2');
+}
+export function isCodexImageBlock(value) {
+    if (!isPlainRecord(value))
+        return false;
+    return value.type === 'image' || value.type === 'input_image' || value.type === 'output_image';
+}
+import { codexTimestamp, compactRunnerText, compactRunnerValue, boundedConversationItemId, isCanonicalBase64, isPlainRecord, nativePageEnd } from '../../util/node-operation-parsers.js';
+export * from '../../util/node-operation-parsers.js';