feat(codex): import local Codex sessions into Hapi (#796)

* local: add Codex Desktop session sync controls * feat(codex): import local Codex sessions into Hapi --------- Co-authored-by: Codex Local <codex-local@example.invalid>
2026-08-05 06:24:37 +00:00 · 2026-06-04 17:53:12 +08:00
parent 39fba5292c
commit f9ef3a4489
25 changed files with 3156 additions and 15 deletions
@@ -69,9 +69,11 @@ function createSessionStub(
    permissionMode: 'default' | 'read-only' | 'safe-yolo' | 'yolo',
    codexArgs?: string[],
    path = '/tmp/worktree',
-    initialTranscriptPath: string | null = null
+    initialTranscriptPath: string | null = null,
+    replayTranscriptHistoryOnStart = false
 ) {
    const sessionEvents: Array<{ type: string; message?: string }> = [];
+    const userMessages: string[] = [];
    const agentMessages: unknown[] = [];
    let localLaunchFailure: { message: string; exitReason: 'switch' | 'exit' } | null = null;
    let sessionId: string | null = null;
@@ -90,6 +92,7 @@ function createSessionStub(
            startedBy: 'terminal' as const,
            startingMode: 'local' as const,
            codexArgs,
+            replayTranscriptHistoryOnStart,
            client: {
                rpcHandlerManager: {
                    registerHandler: () => {}
@@ -124,13 +127,16 @@ function createSessionStub(
            recordLocalLaunchFailure: (message: string, exitReason: 'switch' | 'exit') => {
                localLaunchFailure = { message, exitReason };
            },
-            sendUserMessage: () => {},
+            sendUserMessage: (message: string) => {
+                userMessages.push(message);
+            },
            sendAgentMessage: (message: unknown) => {
                agentMessages.push(message);
            },
            queue: createQueueStub()
        },
        sessionEvents,
+        userMessages,
        agentMessages,
        getLocalLaunchFailure: () => localLaunchFailure
    };
@@ -348,6 +354,94 @@ describe('codexLocalLauncher', () => {
        });
    });

+    it('replays existing transcript messages when importing a Codex thread into a new Hapi session', async () => {
+        const transcriptPath = join(tempDir, 'codex-import-transcript.jsonl');
+        const { session, agentMessages } = createSessionStub('default', undefined, '/tmp/worktree', null, true);
+        let releaseRunBarrier: (() => void) | undefined;
+        harness.runBarrier = new Promise((resolve) => {
+            releaseRunBarrier = resolve;
+        });
+
+        await writeFile(
+            transcriptPath,
+            [
+                JSON.stringify({ type: 'session_meta', payload: { id: 'codex-thread-import' } }),
+                JSON.stringify({ type: 'event_msg', payload: { type: 'agent_message', message: 'old imported message' } })
+            ].join('\n') + '\n'
+        );
+
+        const launcherPromise = codexLocalLauncher(session as never);
+        await wait(50);
+
+        harness.sessionHookHandlers[0]?.('codex-thread-import', {
+            transcript_path: transcriptPath
+        });
+        await wait(300);
+
+        if (releaseRunBarrier) {
+            releaseRunBarrier();
+        }
+        await launcherPromise;
+
+        expect(agentMessages).toContainEqual({
+            type: 'message',
+            message: 'old imported message',
+            id: expect.any(String)
+        });
+    });
+
+    it('replays existing response_item chat messages when importing a Codex thread into a new Hapi session', async () => {
+        const transcriptPath = join(tempDir, 'codex-import-response-item-transcript.jsonl');
+        const { session, userMessages, agentMessages } = createSessionStub('default', undefined, '/tmp/worktree', null, true);
+        let releaseRunBarrier: (() => void) | undefined;
+        harness.runBarrier = new Promise((resolve) => {
+            releaseRunBarrier = resolve;
+        });
+
+        await writeFile(
+            transcriptPath,
+            [
+                JSON.stringify({ type: 'session_meta', payload: { id: 'codex-thread-import-response-item' } }),
+                JSON.stringify({
+                    type: 'response_item',
+                    payload: {
+                        type: 'message',
+                        role: 'user',
+                        content: [{ type: 'input_text', text: 'old response_item user message' }]
+                    }
+                }),
+                JSON.stringify({
+                    type: 'response_item',
+                    payload: {
+                        type: 'message',
+                        role: 'assistant',
+                        content: [{ type: 'output_text', text: 'old response_item assistant message' }]
+                    }
+                })
+            ].join('\n') + '\n'
+        );
+
+        const launcherPromise = codexLocalLauncher(session as never);
+        await wait(50);
+
+        harness.sessionHookHandlers[0]?.('codex-thread-import-response-item', {
+            transcript_path: transcriptPath
+        });
+        await wait(300);
+
+        if (releaseRunBarrier) {
+            releaseRunBarrier();
+        }
+        await launcherPromise;
+
+        expect(userMessages).toContain('old response_item user message');
+        expect(agentMessages).toContainEqual({
+            type: 'message',
+            message: 'old response_item assistant message',
+            id: expect.any(String)
+        });
+    });
+
    it('does not let a later non-clear hook replace the primary session', async () => {
        const primaryTranscriptPath = await writeTranscriptMeta('primary-later-hook.jsonl', 'primary-thread');
        const otherTranscriptPath = await writeTranscriptMeta('later-other-transcript.jsonl', 'other-thread');