shennian 0.3.85 → 0.3.86

package/dist/src/native-fusion/codex-parser.js

@@ -1,4 +1,660 @@
-import j from"node:fs";import R from"node:path";import{createHash as Z}from"node:crypto";import{buildApprovalPendingPayload as P,buildUserMessagePayload as U,isSystemControlPayload as A,isToolPayload as k}from"@shennian/wire";import{buildImagePayload as D,buildToolPayload as K,findJsonlLookbackOffset as O,inferMimeType as H,makeCursor as W,normalizeText as y,parseStructuredString as tt,readJsonlLines as et,readTimestamp as nt,safeParse as q,shouldIgnoreNativeScanPath as L}from"./parser-common.js";import{lookupCodexThreadName as z}from"./codex-files.js";import{parseCodexDelegationInput as rt,parseCodexResponseUserInput as ot,parseCodexTextElements as B,stripCodexUserMessageWrapper as it}from"./codex-user-input.js";import{listCodexRolloutFiles as Mt,lookupCodexThreadName as At}from"./codex-files.js";function N(t){if(typeof t=="string"){const i=t.trim();return i?{path:i,name:R.basename(i)||"image.png",mimeType:H(i),kind:"image"}:null}if(typeof t!="object"||t===null)return null;const n=t,r=typeof n.path=="string"?n.path:typeof n.file_path=="string"?n.file_path:typeof n.saved_path=="string"?n.saved_path:typeof n.image_path=="string"?n.image_path:"";if(!r.trim())return null;const e=typeof n.name=="string"&&n.name.trim()?n.name:R.basename(r)||"image.png",o=typeof n.mimeType=="string"&&n.mimeType.trim()?n.mimeType:H(r);return{path:r,name:e,mimeType:o,kind:"image"}}function F(t){const n=y(t);if(!n)return!1;if(A(n)||/^<environment_context>[\s\S]*<\/environment_context>$/i.test(n)&&n.includes("<current_date>")&&n.includes("<timezone>")&&n.includes("<workspace_roots>"))return!0;const r=n.startsWith("<recommended_plugins>")&&n.includes("</recommended_plugins>"),e=n.includes("# AGENTS.md instructions for ")&&n.includes("<INSTRUCTIONS>")&&n.includes("</INSTRUCTIONS>"),o=n.includes("<environment_context>")&&n.includes("</environment_context>");return e&&o&&(n.startsWith("# AGENTS.md instructions for ")||r)}function w(t){const n=B(t.text_elements),r=Array.isArray(t.input)?B(t.input):"",e=typeof t.message=="string"?it(t.message):{text:"",strippedWrapper:!1},o=e.text,i=n||r||o,s=e.strippedWrapper?"codex_app_context_wrapper":void 0,a=Array.isArray(t.local_images)?t.local_images.map(N).filter(l=>l!=null):[];return!i&&a.length===0||A(i)&&a.length===0||F(i)&&a.length===0?null:a.length>0?{payload:U(i,a),titleText:i,repairHint:s}:{payload:i,titleText:i,repairHint:s}}function ut(t){return t==="turn_aborted"?"aborted":t==="turn_completed"||t==="turn_complete"||t==="task_complete"?"completed":null}function ct(t){return/approval|permission|confirm|user[_-]?input|input[_-]?required/i.test(t)}function st(t){const n=typeof t.command=="string"?t.command:Array.isArray(t.command)?t.command.join(" "):"",r=typeof t.prompt=="string"?t.prompt:typeof t.reason=="string"?t.reason:typeof t.message=="string"?t.message:n?`Codex \u8BF7\u6C42\u6267\u884C\u547D\u4EE4\uFF1A${n}`:"Codex \u6B63\u5728\u7B49\u5F85\u7528\u6237\u786E\u8BA4\u540E\u7EE7\u7EED\u3002";return P({title:"\u9700\u8981\u7528\u6237\u786E\u8BA4",content:r,source:"codex",actionHint:"\u5F53\u524D\u795E\u5FF5\u6682\u4E0D\u652F\u6301\u8FDC\u7A0B\u786E\u8BA4\uFF0C\u8BF7\u56DE\u5230\u8FD0\u884C Codex \u7684\u7535\u8111/\u7EC8\u7AEF\u5B8C\u6210\u786E\u8BA4\u3002"})}function at(t,n){return Array.isArray(t)?y(t.map(r=>{if(typeof r=="string")return r;if(typeof r!="object"||r===null)return"";const e=r;return e.type!==n?"":typeof e.text=="string"?e.text:""}).filter(Boolean).join(`
-
-`)):""}function lt(t){if(!Array.isArray(t))return[];const n=[];for(const r of t){if(typeof r!="object"||r===null)continue;const e=r;if(e.type!=="input_image")continue;const o=N(e);o&&n.push(o)}return n}function J(t){if(t.type!=="message")return null;const n=t.role==="assistant"?"agent":t.role==="user"?"user":null;if(!n)return null;if(n==="agent"){const i=at(t.content,"output_text");return A(i)?null:i?{role:n,payload:i,titleText:i}:null}const r=ot(t.content),e=r.text,o=[...lt(t.content)];for(const i of r.imagePaths){const s=N(i);s&&(o.some(a=>a.path===s.path)||o.push(s))}return!e&&o.length===0||A(e)&&o.length===0||F(e)&&o.length===0?null:{role:n,payload:o.length>0?U(e,o):e,titleText:e,repairHint:r.strippedWrapper?"codex_app_context_wrapper":void 0}}function G(t){if(!t)return"";try{const n=JSON.parse(t);if(typeof n=="object"&&n!==null){const r=n;if(r.type==="user"&&typeof r.content=="string")return y(r.content)}}catch{}return y(t)}function mt(t,n,r,e){return t.agentType!=="codex"||t.role!==n||k(t.payload)||Math.abs(t.ts-e)>300*1e3?!1:G(t.payload)===G(r)}function $(t,n,r,e){for(let o=t.length-1;o>=0;o-=1){const i=t[o];if(i){if(mt(i,n,r,e))return o;if(i.agentType==="codex"&&Math.abs(i.ts-e)>300*1e3)break}}return-1}function v(t,n,r,e,o,i,s,a,l,c,u="agent",m=!1,p){s&&t.push({agentType:"codex",sourceMode:"codex_rollout_import",sourceSessionKey:o,sourceEventKey:Q(o,r,e),cursor:W(n,r),role:u,ts:i,payload:s,title:a,modelId:l,workDir:c,terminal:m,...m?{terminalState:e==="turn_aborted"?"aborted":e==="error"?"failed":"completed"}:{},repairHint:p})}function b(t,n,r,e,o,i,s,a,l,c,u,m,p){const T=Q(o,r,e),I=typeof p?.callId=="string"&&p.callId.trim()?p.callId.trim():null,_=I?Z("sha256").update(`${o}\0${I}`).digest("hex").slice(0,32):null,M=_?`tool:${_}`:void 0,f=_?`native:tool:${_}`:`native:${T}`,C=p?.completed&&_?2:1,g=m!==void 0?"completed":"running";t.push({agentType:"codex",sourceMode:"codex_rollout_import",sourceSessionKey:o,sourceEventKey:T,cursor:W(n,r),role:"agent",ts:i,payload:K({name:s,toolCallId:f,detailRevision:C,status:g}),title:a,modelId:l,workDir:c,...M?{canonicalMessageKey:M,canonicalMutation:p?.completed?"upsert":"append"}:{},localToolDetail:{toolCallId:f,detailRevision:C,name:s,...u!==void 0?{args:u}:{},...m!==void 0?{result:m}:{},status:g}})}function Q(t,n,r){return`codex:${t}:${n}:${r}`}function ft(t,n,r,e,o,i,s,a,l){const c=typeof e.type=="string"?e.type:"";if(c){if(c==="message"){const u=J(e);if(!u||$(t,u.role,u.payload,i)>=0)return;v(t,n,r,`${c}:${u.role}`,o,i,u.payload,s,a,l,u.role,!1,u.repairHint);return}if(c==="function_call"){const u=typeof e.name=="string"?e.name:"function_call";b(t,n,r,c,o,i,u,s,a,l,tt(e.arguments),void 0,{callId:e.call_id});return}if(c==="function_call_output"){const u=rt(e);if(u){v(t,n,r,"delegation:user",o,i,u,s||u.slice(0,80),a,l,"user");return}b(t,n,r,c,o,i,"function_call_output",s,a,l,void 0,e.output,{callId:e.call_id,completed:!0});return}if(c==="custom_tool_call"){const u=typeof e.name=="string"?e.name:"custom_tool_call",m=e.input!==void 0?{input:e.input}:void 0;b(t,n,r,c,o,i,u,s,a,l,m,void 0,{callId:e.call_id});return}if(c==="custom_tool_call_output"){const u=typeof e.name=="string"?e.name:"custom_tool_call_output",m=e.output??e.result??e.content;b(t,n,r,c,o,i,u,s,a,l,void 0,m,{callId:e.call_id,completed:!0});return}if(c==="web_search_call"){const u=typeof e.action=="object"&&e.action!==null?e.action:null;b(t,n,r,c,o,i,"web_search",s,a,l,u??e.query);return}}}function pt(t,n,r,e,o,i,s,a,l){const c=typeof e.type=="string"?e.type:"";if(c){if(c==="user_message"){const u=w(e);if(!u)return;v(t,n,r,c,o,i,u.payload,s,a,l,"user",!1,u.repairHint);return}if(c==="agent_message"){const u=typeof e.message=="string"?y(e.message):"";if(!u||A(u))return;v(t,n,r,c,o,i,u,s,a,l);return}if(c==="turn_aborted"||c==="error"){const u=typeof e.message=="string"?y(e.message):typeof e.error=="string"?y(e.error):"";if(!u)return;v(t,n,r,c,o,i,u,s,a,l,"agent",!0);return}if(ct(c)){v(t,n,r,c,o,i,st(e),s,a,l,"agent");return}if(c==="exec_command_end"){const u=Array.isArray(e.command)?e.command:e.parsed_cmd??e.command,m=e.exit_code??e.exitCode,p=[typeof e.aggregated_output=="string"?e.aggregated_output:"",m!=null?`
-(exit ${String(m)})`:""].join("");b(t,n,r,c,o,i,"command_execution",s,a,l,{command:u},p);return}if(c==="patch_apply_end"){b(t,n,r,c,o,i,"apply_patch",s,a,l,e.changes,{success:e.success,stdout:e.stdout,stderr:e.stderr});return}if(c==="mcp_tool_call_end"){const u=typeof e.invocation=="object"&&e.invocation!==null?e.invocation:null,m=typeof u?.tool=="string"?u.tool:"mcp_tool_call",p={server:u?.server,...typeof u?.arguments=="object"&&u.arguments!==null?u.arguments:{}};b(t,n,r,c,o,i,m,s,a,l,p,e.result);return}if(c==="dynamic_tool_call_request"){const u=typeof e.tool=="string"?e.tool:"dynamic_tool_call";b(t,n,r,c,o,i,u,s,a,l,e.arguments,void 0,{callId:e.callId??e.call_id});return}if(c==="dynamic_tool_call_response"){const u=typeof e.tool=="string"?e.tool:"dynamic_tool_call";b(t,n,r,c,o,i,u,s,a,l,void 0,e.result??e.output,{callId:e.callId??e.call_id,completed:!0});return}if(c==="web_search_end"){const u=typeof e.action=="object"&&e.action!==null?e.action:null;b(t,n,r,c,o,i,"web_search",s,a,l,u??e.query,e.query);return}if(c==="image_generation_end"){const u=typeof e.saved_path=="string"?e.saved_path.trim():"";if(!u)return;v(t,n,r,c,o,i,D(u),s,a,l);return}c==="view_image_tool_call"&&b(t,n,r,c,o,i,"view_image",s,a,l,e.path??e.image_path??e)}}function E(t=!1){return{sourceSessionKey:"",workDir:"",modelId:null,title:"",skipImport:t}}function V(t){if((typeof t.thread_source=="string"?t.thread_source.trim().toLowerCase():"")==="subagent")return!0;const r=typeof t.source=="object"&&t.source!==null?t.source:null;if(r&&typeof r.subagent=="object"&&r.subagent!==null)return!0;const e=typeof t.parent_thread_id=="string"&&t.parent_thread_id.trim().length>0,o=typeof t.agent_nickname=="string"||typeof t.agent_role=="string"||typeof t.multi_agent_version=="string";return e&&o}function gt(t){const n=j.openSync(t,"r");try{const r=[];let e=0,o="";for(;e<1024*1024;){const l=Buffer.alloc(16384),c=j.readSync(n,l,0,l.length,e);if(c<=0)break;const u=l.subarray(0,c);r.push(u),e+=c;const m=Buffer.concat(r),p=m.indexOf(10);if(p>=0){o=m.subarray(0,p).toString("utf8");break}}!o&&r.length>0&&(o=Buffer.concat(r).toString("utf8"));const i=q(o);if(!i||i.type!=="session_meta")return E();const s=typeof i.payload=="object"&&i.payload!==null?i.payload:null;if(!s)return E();if(V(s))return E(!0);const a=typeof s.id=="string"?s.id:"";return{sourceSessionKey:a,workDir:typeof s.cwd=="string"?s.cwd:"",modelId:X(s),title:z(a)??"",skipImport:!1}}finally{j.closeSync(n)}return E()}function X(t){return(typeof t.model=="string"?t.model.trim():"")||null}function yt(t,n){const r=[],e=gt(t);let{sourceSessionKey:o,workDir:i,modelId:s,title:a,skipImport:l}=e,c=e.title;if(l||L(i))return{nextOffset:j.statSync(t).size,events:[]};let u=null;const m=new Set,p=et(t,O(t,n),(T,I)=>{const _=q(T);if(!_)return;const M=typeof _.type=="string"?_.type:"",f=typeof _.payload=="object"&&_.payload!==null?_.payload:null,C=nt(_.timestamp);if(!(!f||!C)){if(M==="session_meta"){if(V(f)){r.length=0,l=!0;return}if(o=typeof f.id=="string"?f.id:o,i=typeof f.cwd=="string"?f.cwd:i,L(i)){r.length=0,l=!0;return}s=X(f)??s;const g=z(o);g&&(c=g,a=g);return}if(!l&&o){if(M==="response_item"){const g=J(f);g?.role==="user"&&g.titleText&&!a&&(a=g.titleText.slice(0,80)),ft(r,t,I,f,o,C,a,s,i);return}if(M==="event_msg"){const g=typeof f.type=="string"?f.type:"",S=ut(g);if(S){let x=!1;for(let h=r.length-1;h>=0;h-=1){const d=r[h];if(d?.agentType==="codex"&&d.role==="agent"&&!k(d.payload)){d.terminal=!0,d.terminalState=S,I>=n&&Number(d.cursor?.slice(t.length+1))<n&&m.add(d.sourceEventKey),x=!0,u=null;break}}if(!x)for(let h=r.length-1;h>=0;h-=1){const d=r[h];if(!(d?.agentType!=="codex"||d.role!=="agent")){d.terminal=!0,d.terminalState=S,I>=n&&Number(d.cursor?.slice(t.length+1))<n&&m.add(d.sourceEventKey),x=!0,u=null;break}}x||(u=S);return}if(g==="user_message"){const x=w(f);if(x?.titleText&&!a&&(a=x.titleText.slice(0,80)),x){const h=$(r,"user",x.payload,C);h>=0&&r.splice(h,1)}}else if(g==="agent_message"){const x=typeof f.message=="string"?y(f.message):"";if(x&&!A(x)){const h=$(r,"agent",x,C);h>=0&&r.splice(h,1)}}const Y=r.length;pt(r,t,I,f,o,C,a,s,i),u&&r.length>Y&&(r[r.length-1].terminal=!0,r[r.length-1].terminalState=u,u=null)}}}});for(const T of r)T.titleSource=c&&T.title===c?"agent_native":"first_user_fallback";return{nextOffset:p,events:r.filter(T=>m.has(T.sourceEventKey)||Number(T.cursor?.slice(t.length+1))>=n)}}export{Mt as listCodexRolloutFiles,At as lookupCodexThreadName,yt as parseCodexRolloutChunk};
+// @arch docs/architecture/cli/native-session-fusion.md
+// @test src/__tests__/native-fusion-parsers.test.ts
+// @test src/__tests__/native-fusion-codex-current-input.test.ts
+// @test src/__tests__/native-fusion-codex-subagent.test.ts
+import fs from 'node:fs';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+import { buildApprovalPendingPayload, buildUserMessagePayload, isSystemControlPayload, isToolPayload } from '@shennian/wire';
+import { buildImagePayload, buildToolPayload, findJsonlLookbackOffset, inferMimeType, makeCursor, normalizeText, parseStructuredString, readJsonlLines, readTimestamp, safeParse, shouldIgnoreNativeScanPath, } from './parser-common.js';
+import { lookupCodexThreadName } from './codex-files.js';
+import { parseCodexDelegationInput, parseCodexResponseUserInput, parseCodexTextElements, stripCodexUserMessageWrapper, } from './codex-user-input.js';
+export { listCodexRolloutFiles, lookupCodexThreadName } from './codex-files.js';
+function parseCodexLocalImageAttachment(value) {
+    if (typeof value === 'string') {
+        const imagePath = value.trim();
+        if (!imagePath)
+            return null;
+        return {
+            path: imagePath,
+            name: path.basename(imagePath) || 'image.png',
+            mimeType: inferMimeType(imagePath),
+            kind: 'image',
+        };
+    }
+    if (typeof value !== 'object' || value === null)
+        return null;
+    const entry = value;
+    const imagePath = typeof entry.path === 'string' ? entry.path
+        : typeof entry.file_path === 'string' ? entry.file_path
+            : typeof entry.saved_path === 'string' ? entry.saved_path
+                : typeof entry.image_path === 'string' ? entry.image_path
+                    : '';
+    if (!imagePath.trim())
+        return null;
+    const name = typeof entry.name === 'string' && entry.name.trim()
+        ? entry.name
+        : path.basename(imagePath) || 'image.png';
+    const mimeType = typeof entry.mimeType === 'string' && entry.mimeType.trim()
+        ? entry.mimeType
+        : inferMimeType(imagePath);
+    return {
+        path: imagePath,
+        name,
+        mimeType,
+        kind: 'image',
+    };
+}
+function isCodexInjectedContextText(text) {
+    const normalized = normalizeText(text);
+    if (!normalized)
+        return false;
+    if (isSystemControlPayload(normalized))
+        return true;
+    if (/^<environment_context>[\s\S]*<\/environment_context>$/i.test(normalized) &&
+        normalized.includes('<current_date>') &&
+        normalized.includes('<timezone>') &&
+        normalized.includes('<workspace_roots>')) {
+        return true;
+    }
+    const hasRecommendedPluginsPrefix = normalized.startsWith('<recommended_plugins>') &&
+        normalized.includes('</recommended_plugins>');
+    const hasProjectInstructions = normalized.includes('# AGENTS.md instructions for ') &&
+        normalized.includes('<INSTRUCTIONS>') && normalized.includes('</INSTRUCTIONS>');
+    const hasEnvironmentContext = normalized.includes('<environment_context>') &&
+        normalized.includes('</environment_context>');
+    return hasProjectInstructions && hasEnvironmentContext &&
+        (normalized.startsWith('# AGENTS.md instructions for ') || hasRecommendedPluginsPrefix);
+}
+function parseCodexUserMessage(payload) {
+    const textFromElements = parseCodexTextElements(payload.text_elements);
+    const textFromInput = Array.isArray(payload.input)
+        ? parseCodexTextElements(payload.input)
+        : '';
+    const strippedMessage = typeof payload.message === 'string'
+        ? stripCodexUserMessageWrapper(payload.message)
+        : { text: '', strippedWrapper: false };
+    const textFromMessage = strippedMessage.text;
+    const text = textFromElements || textFromInput || textFromMessage;
+    const repairHint = strippedMessage.strippedWrapper ? 'codex_app_context_wrapper' : undefined;
+    const attachments = Array.isArray(payload.local_images)
+        ? payload.local_images
+            .map(parseCodexLocalImageAttachment)
+            .filter((item) => item != null)
+        : [];
+    if (!text && attachments.length === 0)
+        return null;
+    if (isSystemControlPayload(text) && attachments.length === 0)
+        return null;
+    if (isCodexInjectedContextText(text) && attachments.length === 0)
+        return null;
+    if (attachments.length > 0) {
+        return {
+            payload: buildUserMessagePayload(text, attachments),
+            titleText: text,
+            repairHint,
+        };
+    }
+    return { payload: text, titleText: text, repairHint };
+}
+function codexTerminalState(eventType) {
+    if (eventType === 'turn_aborted')
+        return 'aborted';
+    if (eventType === 'turn_completed' || eventType === 'turn_complete' || eventType === 'task_complete') {
+        return 'completed';
+    }
+    return null;
+}
+function isCodexApprovalEventType(eventType) {
+    return /approval|permission|confirm|user[_-]?input|input[_-]?required/i.test(eventType);
+}
+function buildCodexApprovalPayload(payload) {
+    const command = typeof payload.command === 'string'
+        ? payload.command
+        : Array.isArray(payload.command)
+            ? payload.command.join(' ')
+            : '';
+    const content = typeof payload.prompt === 'string' ? payload.prompt
+        : typeof payload.reason === 'string' ? payload.reason
+            : typeof payload.message === 'string' ? payload.message
+                : command ? `Codex 请求执行命令：${command}`
+                    : 'Codex 正在等待用户确认后继续。';
+    return buildApprovalPendingPayload({
+        title: '需要用户确认',
+        content,
+        source: 'codex',
+        actionHint: '当前神念暂不支持远程确认，请回到运行 Codex 的电脑/终端完成确认。',
+    });
+}
+function codexMessageContentText(content, textType) {
+    if (!Array.isArray(content))
+        return '';
+    return normalizeText(content
+        .map((part) => {
+        if (typeof part === 'string')
+            return part;
+        if (typeof part !== 'object' || part === null)
+            return '';
+        const record = part;
+        if (record.type !== textType)
+            return '';
+        return typeof record.text === 'string' ? record.text : '';
+    })
+        .filter(Boolean)
+        .join('\n\n'));
+}
+function codexMessageInputImageAttachments(content) {
+    if (!Array.isArray(content))
+        return [];
+    const attachments = [];
+    for (const part of content) {
+        if (typeof part !== 'object' || part === null)
+            continue;
+        const record = part;
+        if (record.type !== 'input_image')
+            continue;
+        const attachment = parseCodexLocalImageAttachment(record);
+        if (attachment)
+            attachments.push(attachment);
+    }
+    return attachments;
+}
+function parseCodexResponseMessage(payload) {
+    if (payload.type !== 'message')
+        return null;
+    const role = payload.role === 'assistant' ? 'agent' : payload.role === 'user' ? 'user' : null;
+    if (!role)
+        return null;
+    if (role === 'agent') {
+        const text = codexMessageContentText(payload.content, 'output_text');
+        if (isSystemControlPayload(text))
+            return null;
+        return text ? { role, payload: text, titleText: text } : null;
+    }
+    const parsedInput = parseCodexResponseUserInput(payload.content);
+    const text = parsedInput.text;
+    const attachments = [...codexMessageInputImageAttachments(payload.content)];
+    for (const imagePath of parsedInput.imagePaths) {
+        const attachment = parseCodexLocalImageAttachment(imagePath);
+        if (!attachment)
+            continue;
+        if (!attachments.some((existing) => existing.path === attachment.path))
+            attachments.push(attachment);
+    }
+    if (!text && attachments.length === 0)
+        return null;
+    if (isSystemControlPayload(text) && attachments.length === 0)
+        return null;
+    if (isCodexInjectedContextText(text) && attachments.length === 0)
+        return null;
+    return {
+        role,
+        payload: attachments.length > 0 ? buildUserMessagePayload(text, attachments) : text,
+        titleText: text,
+        repairHint: parsedInput.strippedWrapper ? 'codex_app_context_wrapper' : undefined,
+    };
+}
+function codexDedupeText(payload) {
+    if (!payload)
+        return '';
+    try {
+        const parsed = JSON.parse(payload);
+        if (typeof parsed === 'object' && parsed !== null) {
+            const record = parsed;
+            if (record.type === 'user' && typeof record.content === 'string')
+                return normalizeText(record.content);
+        }
+    }
+    catch {
+        /* plain text payload */
+    }
+    return normalizeText(payload);
+}
+function isDuplicateCodexChatEvent(event, role, payload, ts) {
+    if (event.agentType !== 'codex')
+        return false;
+    if (event.role !== role)
+        return false;
+    if (isToolPayload(event.payload))
+        return false;
+    if (Math.abs(event.ts - ts) > 5 * 60 * 1000)
+        return false;
+    return codexDedupeText(event.payload) === codexDedupeText(payload);
+}
+function findDuplicateCodexChatEventIndex(events, role, payload, ts) {
+    for (let i = events.length - 1; i >= 0; i -= 1) {
+        const event = events[i];
+        if (!event)
+            continue;
+        if (isDuplicateCodexChatEvent(event, role, payload, ts))
+            return i;
+        if (event.agentType === 'codex' && Math.abs(event.ts - ts) > 5 * 60 * 1000)
+            break;
+    }
+    return -1;
+}
+function pushCodexEvent(events, filePath, lineOffset, kind, sourceSessionKey, ts, payload, title, modelId, workDir, role = 'agent', terminal = false, repairHint) {
+    if (!payload)
+        return;
+    events.push({
+        agentType: 'codex',
+        sourceMode: 'codex_rollout_import',
+        sourceSessionKey,
+        sourceEventKey: makeCodexEventKey(sourceSessionKey, lineOffset, kind),
+        cursor: makeCursor(filePath, lineOffset),
+        role,
+        ts,
+        payload,
+        title,
+        modelId,
+        workDir,
+        terminal,
+        ...(terminal
+            ? {
+                terminalState: kind === 'turn_aborted' ? 'aborted'
+                    : kind === 'error' ? 'failed'
+                        : 'completed',
+            }
+            : {}),
+        repairHint,
+    });
+}
+function pushCodexToolEvent(events, filePath, lineOffset, kind, sourceSessionKey, ts, toolName, title, modelId, workDir, args, result, logical) {
+    const sourceEventKey = makeCodexEventKey(sourceSessionKey, lineOffset, kind);
+    const callId = typeof logical?.callId === 'string' && logical.callId.trim()
+        ? logical.callId.trim()
+        : null;
+    const logicalDigest = callId
+        ? createHash('sha256').update(`${sourceSessionKey}\0${callId}`).digest('hex').slice(0, 32)
+        : null;
+    const canonicalMessageKey = logicalDigest ? `tool:${logicalDigest}` : undefined;
+    const toolCallId = logicalDigest ? `native:tool:${logicalDigest}` : `native:${sourceEventKey}`;
+    const detailRevision = logical?.completed && logicalDigest ? 2 : 1;
+    const status = result !== undefined ? 'completed' : 'running';
+    events.push({
+        agentType: 'codex',
+        sourceMode: 'codex_rollout_import',
+        sourceSessionKey,
+        sourceEventKey,
+        cursor: makeCursor(filePath, lineOffset),
+        role: 'agent',
+        ts,
+        payload: buildToolPayload({ name: toolName, toolCallId, detailRevision, status }),
+        title,
+        modelId,
+        workDir,
+        ...(canonicalMessageKey ? {
+            canonicalMessageKey,
+            canonicalMutation: logical?.completed ? 'upsert' : 'append',
+        } : {}),
+        localToolDetail: {
+            toolCallId,
+            detailRevision,
+            name: toolName,
+            ...(args !== undefined ? { args } : {}),
+            ...(result !== undefined ? { result } : {}),
+            status,
+        },
+    });
+}
+function makeCodexEventKey(sourceSessionKey, offset, kind) {
+    // Active/archive are discovery locations, never provider identity. Codex
+    // preserves the rollout bytes when moving a thread, so stable thread ID +
+    // byte offset + event kind survives rename, move, touch and unarchive.
+    return `codex:${sourceSessionKey}:${offset}:${kind}`;
+}
+function parseCodexResponseItem(events, filePath, lineOffset, payload, sourceSessionKey, ts, title, modelId, workDir) {
+    const itemType = typeof payload.type === 'string' ? payload.type : '';
+    if (!itemType)
+        return;
+    if (itemType === 'message') {
+        const parsedMessage = parseCodexResponseMessage(payload);
+        if (!parsedMessage)
+            return;
+        const duplicateIndex = findDuplicateCodexChatEventIndex(events, parsedMessage.role, parsedMessage.payload, ts);
+        if (duplicateIndex >= 0)
+            return;
+        pushCodexEvent(events, filePath, lineOffset, `${itemType}:${parsedMessage.role}`, sourceSessionKey, ts, parsedMessage.payload, title, modelId, workDir, parsedMessage.role, false, parsedMessage.repairHint);
+        return;
+    }
+    if (itemType === 'function_call') {
+        const name = typeof payload.name === 'string' ? payload.name : 'function_call';
+        pushCodexToolEvent(events, filePath, lineOffset, itemType, sourceSessionKey, ts, name, title, modelId, workDir, parseStructuredString(payload.arguments), undefined, { callId: payload.call_id });
+        return;
+    }
+    if (itemType === 'function_call_output') {
+        const delegationInput = parseCodexDelegationInput(payload);
+        if (delegationInput) {
+            pushCodexEvent(events, filePath, lineOffset, 'delegation:user', sourceSessionKey, ts, delegationInput, title || delegationInput.slice(0, 80), modelId, workDir, 'user');
+            return;
+        }
+        pushCodexToolEvent(events, filePath, lineOffset, itemType, sourceSessionKey, ts, 'function_call_output', title, modelId, workDir, undefined, payload.output, { callId: payload.call_id, completed: true });
+        return;
+    }
+    if (itemType === 'custom_tool_call') {
+        const name = typeof payload.name === 'string' ? payload.name : 'custom_tool_call';
+        const args = payload.input !== undefined ? { input: payload.input } : undefined;
+        pushCodexToolEvent(events, filePath, lineOffset, itemType, sourceSessionKey, ts, name, title, modelId, workDir, args, undefined, { callId: payload.call_id });
+        return;
+    }
+    if (itemType === 'custom_tool_call_output') {
+        const name = typeof payload.name === 'string' ? payload.name : 'custom_tool_call_output';
+        const result = payload.output ?? payload.result ?? payload.content;
+        pushCodexToolEvent(events, filePath, lineOffset, itemType, sourceSessionKey, ts, name, title, modelId, workDir, undefined, result, { callId: payload.call_id, completed: true });
+        return;
+    }
+    if (itemType === 'web_search_call') {
+        const action = typeof payload.action === 'object' && payload.action !== null
+            ? payload.action
+            : null;
+        pushCodexToolEvent(events, filePath, lineOffset, itemType, sourceSessionKey, ts, 'web_search', title, modelId, workDir, action ?? payload.query);
+        return;
+    }
+}
+function parseCodexEventMessage(events, filePath, lineOffset, payload, sourceSessionKey, ts, title, modelId, workDir) {
+    const eventType = typeof payload.type === 'string' ? payload.type : '';
+    if (!eventType)
+        return;
+    if (eventType === 'user_message') {
+        const parsedUser = parseCodexUserMessage(payload);
+        if (!parsedUser)
+            return;
+        pushCodexEvent(events, filePath, lineOffset, eventType, sourceSessionKey, ts, parsedUser.payload, title, modelId, workDir, 'user', false, parsedUser.repairHint);
+        return;
+    }
+    if (eventType === 'agent_message') {
+        const text = typeof payload.message === 'string' ? normalizeText(payload.message) : '';
+        if (!text || isSystemControlPayload(text))
+            return;
+        pushCodexEvent(events, filePath, lineOffset, eventType, sourceSessionKey, ts, text, title, modelId, workDir);
+        return;
+    }
+    if (eventType === 'turn_aborted' || eventType === 'error') {
+        const text = typeof payload.message === 'string'
+            ? normalizeText(payload.message)
+            : typeof payload.error === 'string'
+                ? normalizeText(payload.error)
+                : '';
+        if (!text)
+            return;
+        pushCodexEvent(events, filePath, lineOffset, eventType, sourceSessionKey, ts, text, title, modelId, workDir, 'agent', true);
+        return;
+    }
+    if (isCodexApprovalEventType(eventType)) {
+        pushCodexEvent(events, filePath, lineOffset, eventType, sourceSessionKey, ts, buildCodexApprovalPayload(payload), title, modelId, workDir, 'agent');
+        return;
+    }
+    if (eventType === 'exec_command_end') {
+        const command = Array.isArray(payload.command) ? payload.command : payload.parsed_cmd ?? payload.command;
+        const exitCode = payload.exit_code ?? payload.exitCode;
+        const output = [
+            typeof payload.aggregated_output === 'string' ? payload.aggregated_output : '',
+            exitCode != null ? `\n(exit ${String(exitCode)})` : '',
+        ].join('');
+        pushCodexToolEvent(events, filePath, lineOffset, eventType, sourceSessionKey, ts, 'command_execution', title, modelId, workDir, { command }, output);
+        return;
+    }
+    if (eventType === 'patch_apply_end') {
+        pushCodexToolEvent(events, filePath, lineOffset, eventType, sourceSessionKey, ts, 'apply_patch', title, modelId, workDir, payload.changes, {
+            success: payload.success,
+            stdout: payload.stdout,
+            stderr: payload.stderr,
+        });
+        return;
+    }
+    if (eventType === 'mcp_tool_call_end') {
+        const invocation = typeof payload.invocation === 'object' && payload.invocation !== null
+            ? payload.invocation
+            : null;
+        const tool = typeof invocation?.tool === 'string' ? invocation.tool : 'mcp_tool_call';
+        const args = {
+            server: invocation?.server,
+            ...(typeof invocation?.arguments === 'object' && invocation.arguments !== null
+                ? invocation.arguments
+                : {}),
+        };
+        pushCodexToolEvent(events, filePath, lineOffset, eventType, sourceSessionKey, ts, tool, title, modelId, workDir, args, payload.result);
+        return;
+    }
+    if (eventType === 'dynamic_tool_call_request') {
+        const tool = typeof payload.tool === 'string' ? payload.tool : 'dynamic_tool_call';
+        pushCodexToolEvent(events, filePath, lineOffset, eventType, sourceSessionKey, ts, tool, title, modelId, workDir, payload.arguments, undefined, { callId: payload.callId ?? payload.call_id });
+        return;
+    }
+    if (eventType === 'dynamic_tool_call_response') {
+        const tool = typeof payload.tool === 'string' ? payload.tool : 'dynamic_tool_call';
+        pushCodexToolEvent(events, filePath, lineOffset, eventType, sourceSessionKey, ts, tool, title, modelId, workDir, undefined, payload.result ?? payload.output, { callId: payload.callId ?? payload.call_id, completed: true });
+        return;
+    }
+    if (eventType === 'web_search_end') {
+        const action = typeof payload.action === 'object' && payload.action !== null
+            ? payload.action
+            : null;
+        pushCodexToolEvent(events, filePath, lineOffset, eventType, sourceSessionKey, ts, 'web_search', title, modelId, workDir, action ?? payload.query, payload.query);
+        return;
+    }
+    if (eventType === 'image_generation_end') {
+        const savedPath = typeof payload.saved_path === 'string' ? payload.saved_path.trim() : '';
+        if (!savedPath)
+            return;
+        pushCodexEvent(events, filePath, lineOffset, eventType, sourceSessionKey, ts, buildImagePayload(savedPath), title, modelId, workDir);
+        return;
+    }
+    if (eventType === 'view_image_tool_call') {
+        pushCodexToolEvent(events, filePath, lineOffset, eventType, sourceSessionKey, ts, 'view_image', title, modelId, workDir, payload.path ?? payload.image_path ?? payload);
+    }
+}
+function emptyCodexSessionMeta(skipImport = false) {
+    return {
+        sourceSessionKey: '',
+        workDir: '',
+        modelId: null,
+        title: '',
+        skipImport,
+    };
+}
+function isCodexSubagentSessionMeta(payload) {
+    const threadSource = typeof payload.thread_source === 'string'
+        ? payload.thread_source.trim().toLowerCase()
+        : '';
+    if (threadSource === 'subagent')
+        return true;
+    const source = typeof payload.source === 'object' && payload.source !== null
+        ? payload.source
+        : null;
+    if (source && typeof source.subagent === 'object' && source.subagent !== null)
+        return true;
+    const hasParentThread = typeof payload.parent_thread_id === 'string'
+        && payload.parent_thread_id.trim().length > 0;
+    const hasSubagentIdentity = typeof payload.agent_nickname === 'string'
+        || typeof payload.agent_role === 'string'
+        || typeof payload.multi_agent_version === 'string';
+    return hasParentThread && hasSubagentIdentity;
+}
+function readCodexSessionMeta(filePath) {
+    const fd = fs.openSync(filePath, 'r');
+    try {
+        const chunks = [];
+        let position = 0;
+        let firstLine = '';
+        while (position < 1024 * 1024) {
+            const buffer = Buffer.alloc(16 * 1024);
+            const bytesRead = fs.readSync(fd, buffer, 0, buffer.length, position);
+            if (bytesRead <= 0)
+                break;
+            const chunk = buffer.subarray(0, bytesRead);
+            chunks.push(chunk);
+            position += bytesRead;
+            const combined = Buffer.concat(chunks);
+            const newlineIndex = combined.indexOf(0x0a);
+            if (newlineIndex >= 0) {
+                firstLine = combined.subarray(0, newlineIndex).toString('utf8');
+                break;
+            }
+        }
+        if (!firstLine && chunks.length > 0) {
+            firstLine = Buffer.concat(chunks).toString('utf8');
+        }
+        const parsed = safeParse(firstLine);
+        if (!parsed || parsed.type !== 'session_meta') {
+            return emptyCodexSessionMeta();
+        }
+        const payload = typeof parsed.payload === 'object' && parsed.payload !== null
+            ? parsed.payload
+            : null;
+        if (!payload) {
+            return emptyCodexSessionMeta();
+        }
+        if (isCodexSubagentSessionMeta(payload)) {
+            return emptyCodexSessionMeta(true);
+        }
+        const sourceSessionKey = typeof payload.id === 'string' ? payload.id : '';
+        return {
+            sourceSessionKey,
+            workDir: typeof payload.cwd === 'string' ? payload.cwd : '',
+            modelId: readCodexModelId(payload),
+            title: lookupCodexThreadName(sourceSessionKey) ?? '',
+            skipImport: false,
+        };
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+    return emptyCodexSessionMeta();
+}
+function readCodexModelId(payload) {
+    const model = typeof payload.model === 'string' ? payload.model.trim() : '';
+    return model || null;
+}
+export function parseCodexRolloutChunk(filePath, startOffset) {
+    const events = [];
+    const metadata = readCodexSessionMeta(filePath);
+    let { sourceSessionKey, workDir, modelId, title, skipImport } = metadata;
+    let nativeTitle = metadata.title;
+    if (skipImport || shouldIgnoreNativeScanPath(workDir)) {
+        return { nextOffset: fs.statSync(filePath).size, events: [] };
+    }
+    let pendingTerminalState = null;
+    const terminalReplayKeys = new Set();
+    const nextOffset = readJsonlLines(filePath, findJsonlLookbackOffset(filePath, startOffset), (line, lineOffset) => {
+        const parsed = safeParse(line);
+        if (!parsed)
+            return;
+        const type = typeof parsed.type === 'string' ? parsed.type : '';
+        const payload = typeof parsed.payload === 'object' && parsed.payload !== null
+            ? parsed.payload
+            : null;
+        const ts = readTimestamp(parsed.timestamp);
+        if (!payload || !ts)
+            return;
+        if (type === 'session_meta') {
+            if (isCodexSubagentSessionMeta(payload)) {
+                events.length = 0;
+                skipImport = true;
+                return;
+            }
+            sourceSessionKey = typeof payload.id === 'string' ? payload.id : sourceSessionKey;
+            workDir = typeof payload.cwd === 'string' ? payload.cwd : workDir;
+            if (shouldIgnoreNativeScanPath(workDir)) {
+                events.length = 0;
+                skipImport = true;
+                return;
+            }
+            modelId = readCodexModelId(payload) ?? modelId;
+            const observedNativeTitle = lookupCodexThreadName(sourceSessionKey);
+            if (observedNativeTitle) {
+                nativeTitle = observedNativeTitle;
+                title = observedNativeTitle;
+            }
+            return;
+        }
+        if (skipImport)
+            return;
+        if (!sourceSessionKey)
+            return;
+        if (type === 'response_item') {
+            const parsedMessage = parseCodexResponseMessage(payload);
+            if (parsedMessage?.role === 'user' && parsedMessage.titleText && !title) {
+                title = parsedMessage.titleText.slice(0, 80);
+            }
+            parseCodexResponseItem(events, filePath, lineOffset, payload, sourceSessionKey, ts, title, modelId, workDir);
+            return;
+        }
+        if (type === 'event_msg') {
+            const eventType = typeof payload.type === 'string' ? payload.type : '';
+            const terminalState = codexTerminalState(eventType);
+            if (terminalState) {
+                let markedTerminal = false;
+                for (let i = events.length - 1; i >= 0; i -= 1) {
+                    const event = events[i];
+                    if (event?.agentType !== 'codex')
+                        continue;
+                    if (event.role !== 'agent')
+                        continue;
+                    if (isToolPayload(event.payload))
+                        continue;
+                    event.terminal = true;
+                    event.terminalState = terminalState;
+                    if (lineOffset >= startOffset && Number(event.cursor?.slice(filePath.length + 1)) < startOffset) {
+                        terminalReplayKeys.add(event.sourceEventKey);
+                    }
+                    markedTerminal = true;
+                    pendingTerminalState = null;
+                    break;
+                }
+                if (!markedTerminal) {
+                    for (let i = events.length - 1; i >= 0; i -= 1) {
+                        const event = events[i];
+                        if (event?.agentType !== 'codex' || event.role !== 'agent')
+                            continue;
+                        event.terminal = true;
+                        event.terminalState = terminalState;
+                        if (lineOffset >= startOffset && Number(event.cursor?.slice(filePath.length + 1)) < startOffset)
+                            terminalReplayKeys.add(event.sourceEventKey);
+                        markedTerminal = true;
+                        pendingTerminalState = null;
+                        break;
+                    }
+                }
+                if (!markedTerminal)
+                    pendingTerminalState = terminalState;
+                return;
+            }
+            if (eventType === 'user_message') {
+                const parsedUser = parseCodexUserMessage(payload);
+                if (parsedUser?.titleText && !title)
+                    title = parsedUser.titleText.slice(0, 80);
+                if (parsedUser) {
+                    const duplicateIndex = findDuplicateCodexChatEventIndex(events, 'user', parsedUser.payload, ts);
+                    if (duplicateIndex >= 0)
+                        events.splice(duplicateIndex, 1);
+                }
+            }
+            else if (eventType === 'agent_message') {
+                const text = typeof payload.message === 'string' ? normalizeText(payload.message) : '';
+                if (text && !isSystemControlPayload(text)) {
+                    const duplicateIndex = findDuplicateCodexChatEventIndex(events, 'agent', text, ts);
+                    if (duplicateIndex >= 0)
+                        events.splice(duplicateIndex, 1);
+                }
+            }
+            const beforeCount = events.length;
+            parseCodexEventMessage(events, filePath, lineOffset, payload, sourceSessionKey, ts, title, modelId, workDir);
+            if (pendingTerminalState && events.length > beforeCount) {
+                events[events.length - 1].terminal = true;
+                events[events.length - 1].terminalState = pendingTerminalState;
+                pendingTerminalState = null;
+            }
+        }
+    });
+    for (const event of events) {
+        event.titleSource = nativeTitle && event.title === nativeTitle
+            ? 'agent_native'
+            : 'first_user_fallback';
+    }
+    return {
+        nextOffset,
+        events: events.filter((event) => terminalReplayKeys.has(event.sourceEventKey)
+            || Number(event.cursor?.slice(filePath.length + 1)) >= startOffset),
+    };
+}