@jingyi0605/codingns 0.5.5 → 0.6.1

package/node_modules/@codingns/session-sync-core/dist/runtime/codex-runtime.js

@@ -12,6 +12,7 @@ import { buildApplyPatchFromFileChangeList, extractApplyPatchTargetPathsFromTool
 import { loadDatabaseSync } from "../sqlite/node-sqlite.js";
 import { createCodexThreadPermissionOptions } from "./codex-permissions.js";
 const CODEX_RUNTIME_DEBUG_ENABLED = /^(1|true|yes)$/i.test(process.env.CODINGNS_PERF_DEBUG?.trim() ?? "");
+const CODEX_APP_SERVER_REQUEST_TIMEOUT_MS = 20_000;
 function logCodexRuntimeStep(scope, startedAtMs, detail = {}) {
     if (!CODEX_RUNTIME_DEBUG_ENABLED) {
         return;
@@ -59,110 +60,121 @@ export class CodexRuntimeAdapter {
         const launchedAtMs = Date.now();
         const launchPerfStartedAtMs = performance.now();
         const transport = this.options.transportFactory
-            ? this.options.transportFactory()
-            : createCodexAppServerTransport(this.options);
-        const initializeStartedAtMs = performance.now();
-        await transport.initialize();
-        logCodexRuntimeStep("start_session.initialize", initializeStartedAtMs, {
-            sessionId: request.sessionId,
-            workspacePath: request.workspacePath
-        });
-        const abortController = new AbortController();
-        const eventQueue = createAsyncEventQueue();
-        const forwardTranslatedNotification = createCodexTranslatedNotificationForwarder(eventQueue);
-        const resumedSyntheticSession = await this.resumeSyntheticThreadFromHistory(transport, request);
-        const startedSession = resumedSyntheticSession ??
-            await (async () => {
-                const startThreadStartedAtMs = performance.now();
-                const started = await transport.startThread(request);
-                logCodexRuntimeStep("start_session.thread_start", startThreadStartedAtMs, {
-                    sessionId: request.sessionId,
-                    providerSessionId: started.providerSessionId
-                });
-                return started;
-            })();
-        const providerSessionId = startedSession.providerSessionId;
-        const syntheticRawStoreRef = buildRuntimeRawStoreRef(resolveRuntimeStoreKey(providerSessionId, request.sessionId));
-        const rawStoreRef = pickAvailableCodexRawStoreRef(providerSessionId, resumedSyntheticSession
-            ? [resumedSyntheticSession.rawStoreRef]
-            : [startedSession.rawStoreRef, request.rawStoreRef], syntheticRawStoreRef);
-        logCodexRuntimeStep("start_session.raw_store_ref_ready", launchPerfStartedAtMs, {
-            sessionId: request.sessionId,
-            providerSessionId,
-            synthetic: isSyntheticRawStoreRef(rawStoreRef),
-            hasProviderRawStoreRef: Boolean(startedSession.rawStoreRef),
-            providerRawStoreRefExists: Boolean(startedSession.rawStoreRef && existsSync(startedSession.rawStoreRef))
-        });
-        sink.updateSessionBinding({
-            providerSessionId,
-            rawStoreRef
-        });
-        let firstNotificationLogged = false;
-        transport.setNotificationHandler(async (notification) => {
-            if (!firstNotificationLogged) {
-                firstNotificationLogged = true;
-                logCodexRuntimeStep("start_session.first_notification", launchPerfStartedAtMs, {
+            ? this.options.transportFactory(request)
+            : createCodexAppServerTransport({
+                ...this.options,
+                homeDir: request.runtimeHomeDir?.trim() || this.options.homeDir,
+                runtimeEnv: request.runtimeEnv ?? this.options.runtimeEnv ?? null
+            });
+        try {
+            const initializeStartedAtMs = performance.now();
+            await transport.initialize();
+            logCodexRuntimeStep("start_session.initialize", initializeStartedAtMs, {
+                sessionId: request.sessionId,
+                workspacePath: request.workspacePath
+            });
+            const abortController = new AbortController();
+            const eventQueue = createAsyncEventQueue();
+            const translateNotification = createCodexAppServerNotificationTranslator();
+            const forwardTranslatedNotification = createCodexTranslatedNotificationForwarder(eventQueue);
+            const resumedSyntheticSession = await this.resumeSyntheticThreadFromHistory(transport, request);
+            const startedSession = resumedSyntheticSession ??
+                await (async () => {
+                    const startThreadStartedAtMs = performance.now();
+                    const started = await transport.startThread(request);
+                    logCodexRuntimeStep("start_session.thread_start", startThreadStartedAtMs, {
+                        sessionId: request.sessionId,
+                        providerSessionId: started.providerSessionId
+                    });
+                    return started;
+                })();
+            const providerSessionId = startedSession.providerSessionId;
+            const syntheticRawStoreRef = buildRuntimeRawStoreRef(resolveRuntimeStoreKey(providerSessionId, request.sessionId));
+            const rawStoreRef = pickAvailableCodexRawStoreRef(providerSessionId, resumedSyntheticSession
+                ? [resumedSyntheticSession.rawStoreRef]
+                : [startedSession.rawStoreRef, request.rawStoreRef], syntheticRawStoreRef);
+            logCodexRuntimeStep("start_session.raw_store_ref_ready", launchPerfStartedAtMs, {
+                sessionId: request.sessionId,
+                providerSessionId,
+                synthetic: isSyntheticRawStoreRef(rawStoreRef),
+                hasProviderRawStoreRef: Boolean(startedSession.rawStoreRef),
+                providerRawStoreRefExists: Boolean(startedSession.rawStoreRef && existsSync(startedSession.rawStoreRef))
+            });
+            sink.updateSessionBinding({
+                providerSessionId,
+                rawStoreRef
+            });
+            let firstNotificationLogged = false;
+            transport.setNotificationHandler(async (notification) => {
+                if (!firstNotificationLogged) {
+                    firstNotificationLogged = true;
+                    logCodexRuntimeStep("start_session.first_notification", launchPerfStartedAtMs, {
+                        sessionId: request.sessionId,
+                        providerSessionId,
+                        method: ensureText(notification.method).trim() || null
+                    });
+                }
+                const translated = translateNotification(notification);
+                forwardTranslatedNotification(translated);
+            });
+            transport.setServerRequestHandler(async (serverRequest) => {
+                if (!this.options.handleServerRequest) {
+                    throw new Error("CODEX_APP_SERVER_REQUEST_NOT_SUPPORTED");
+                }
+                return this.options.handleServerRequest({
                     sessionId: request.sessionId,
                     providerSessionId,
-                    method: ensureText(notification.method).trim() || null
+                    request: serverRequest
                 });
+            });
+            transport.setOnClose((error) => {
+                if (error) {
+                    eventQueue.push({
+                        type: "turn.failed",
+                        timestamp: nextTimestamp(),
+                        error: error.message
+                    });
+                }
+                eventQueue.close();
+            });
+            const startTurnStartedAtMs = performance.now();
+            const startTurnResult = await transport.startTurn(request, providerSessionId);
+            const startTurnNotification = startTurnResult?.notification ?? null;
+            if (startTurnNotification) {
+                const translated = translateNotification(startTurnNotification);
+                forwardTranslatedNotification(translated);
             }
-            const translated = translateCodexAppServerNotification(notification);
-            forwardTranslatedNotification(translated);
-        });
-        transport.setServerRequestHandler(async (serverRequest) => {
-            if (!this.options.handleServerRequest) {
-                throw new Error("CODEX_APP_SERVER_REQUEST_NOT_SUPPORTED");
-            }
-            return this.options.handleServerRequest({
+            logCodexRuntimeStep("start_session.turn_start", startTurnStartedAtMs, {
                 sessionId: request.sessionId,
-                providerSessionId,
-                request: serverRequest
+                providerSessionId
             });
-        });
-        transport.setOnClose((error) => {
-            if (error) {
-                eventQueue.push({
-                    type: "turn.failed",
-                    timestamp: nextTimestamp(),
-                    error: error.message
-                });
-            }
-            eventQueue.close();
-        });
-        const startTurnStartedAtMs = performance.now();
-        const startTurnResult = await transport.startTurn(request, providerSessionId);
-        const startTurnNotification = startTurnResult?.notification ?? null;
-        if (startTurnNotification) {
-            const translated = translateCodexAppServerNotification(startTurnNotification);
-            forwardTranslatedNotification(translated);
-        }
-        logCodexRuntimeStep("start_session.turn_start", startTurnStartedAtMs, {
-            sessionId: request.sessionId,
-            providerSessionId
-        });
-        logCodexRuntimeStep("start_session.ready", launchPerfStartedAtMs, {
-            sessionId: request.sessionId,
-            providerSessionId
-        });
-        return {
-            providerSessionId,
-            rawStoreRef,
-            submitDuringRun: async (options) => {
-                await transport.steerTurn(options);
-            },
-            interrupt: async () => {
-                abortController.abort();
-                await transport.interruptTurn().catch(() => {
-                    return;
-                });
-                transport.close();
-            },
-            isAlive: () => transport.isClosed() === false,
-            completed: this.runTurn(null, request, sink, providerSessionId, rawStoreRef, abortController, eventQueue.iterator, [], launchedAtMs, launchPerfStartedAtMs).finally(() => {
-                transport.close();
-            })
-        };
+            logCodexRuntimeStep("start_session.ready", launchPerfStartedAtMs, {
+                sessionId: request.sessionId,
+                providerSessionId
+            });
+            return {
+                providerSessionId,
+                rawStoreRef,
+                submitDuringRun: async (options) => {
+                    await transport.steerTurn(options);
+                },
+                interrupt: async () => {
+                    abortController.abort();
+                    await transport.interruptTurn().catch(() => {
+                        return;
+                    });
+                    transport.close();
+                },
+                isAlive: () => transport.isClosed() === false,
+                completed: this.runTurn(null, request, sink, providerSessionId, rawStoreRef, abortController, eventQueue.iterator, [], launchedAtMs, launchPerfStartedAtMs).finally(() => {
+                    transport.close();
+                })
+            };
+        }
+        catch (error) {
+            transport.close();
+            throw error;
+        }
     }
     async resumeSyntheticThreadFromHistory(transport, request) {
         const history = buildSyntheticResumeHistory(request.rawStoreRef);
@@ -189,139 +201,151 @@ export class CodexRuntimeAdapter {
             throw new Error("PROVIDER_SESSION_ID_REQUIRED");
         }
         const transport = this.options.transportFactory
-            ? this.options.transportFactory()
-            : createCodexAppServerTransport(this.options);
-        const runtimeStartedAtMs = performance.now();
-        const initializeStartedAtMs = performance.now();
-        await transport.initialize();
-        logCodexRuntimeStep("continue_session.initialize", initializeStartedAtMs, {
-            sessionId: request.sessionId,
-            providerSessionId
-        });
-        const syntheticRawStoreRef = buildRuntimeRawStoreRef(providerSessionId);
-        let resolvedSessionId = providerSessionId;
-        let resolvedFallbackHistoryRawStoreRef = null;
-        const resumeThreadStartedAtMs = performance.now();
-        let resumed;
-        try {
-            resumed = await transport.resumeThread(request, resolvedSessionId);
-            logCodexRuntimeStep("continue_session.thread_resume", resumeThreadStartedAtMs, {
-                sessionId: request.sessionId,
-                providerSessionId: resolvedSessionId,
-                fallback: false
+            ? this.options.transportFactory(request)
+            : createCodexAppServerTransport({
+                ...this.options,
+                homeDir: request.runtimeHomeDir?.trim() || this.options.homeDir,
+                runtimeEnv: request.runtimeEnv ?? this.options.runtimeEnv ?? null
             });
-        }
-        catch (error) {
-            const fallbackHistorySource = await this.resolveContinueFallbackHistorySource({
-                providerSessionId,
-                rawStoreRef: request.rawStoreRef,
-                workspacePath: request.workspacePath
-            });
-            const resumeHistory = fallbackHistorySource?.history ?? [];
-            if (!shouldFallbackCodexContinueFromHistory(error, resumeHistory)) {
-                throw error;
-            }
-            resolvedFallbackHistoryRawStoreRef = fallbackHistorySource?.rawStoreRef ?? null;
-            const resumeFallbackStartedAtMs = performance.now();
-            resumed = await transport.resumeThreadFromHistory({
-                providerSessionId: null,
-                workspacePath: request.workspacePath,
-                history: resumeHistory,
-                model: request.options.model
-            });
-            resolvedSessionId = resumed.providerSessionId;
-            logCodexRuntimeStep("continue_session.thread_resume_from_history_fallback", resumeFallbackStartedAtMs, {
+        try {
+            const runtimeStartedAtMs = performance.now();
+            const initializeStartedAtMs = performance.now();
+            await transport.initialize();
+            logCodexRuntimeStep("continue_session.initialize", initializeStartedAtMs, {
                 sessionId: request.sessionId,
-                requestedProviderSessionId: providerSessionId,
-                providerSessionId: resolvedSessionId,
-                historyLength: resumeHistory.length
+                providerSessionId
             });
-        }
-        const pickedRawStoreRef = pickAvailableCodexRawStoreRef(resolvedSessionId, [resolvedFallbackHistoryRawStoreRef, request.rawStoreRef, resumed.rawStoreRef], syntheticRawStoreRef);
-        const rawStoreRef = !resumed.rawStoreRef?.trim() && resolvedFallbackHistoryRawStoreRef
-            ? resolvedFallbackHistoryRawStoreRef
-            : pickedRawStoreRef;
-        const abortController = new AbortController();
-        const eventQueue = createAsyncEventQueue();
-        const forwardTranslatedNotification = createCodexTranslatedNotificationForwarder(eventQueue);
-        logCodexRuntimeStep("continue_session.raw_store_ref_ready", runtimeStartedAtMs, {
-            sessionId: request.sessionId,
-            providerSessionId: resolvedSessionId,
-            synthetic: isSyntheticRawStoreRef(rawStoreRef),
-            hasResumedRawStoreRef: Boolean(resumed.rawStoreRef),
-            hasRequestRawStoreRef: Boolean(request.rawStoreRef),
-            resumedRawStoreRefExists: Boolean(resumed.rawStoreRef && existsSync(resumed.rawStoreRef))
-        });
-        sink.updateSessionBinding({
-            providerSessionId: resolvedSessionId,
-            rawStoreRef
-        });
-        let firstNotificationLogged = false;
-        transport.setNotificationHandler(async (notification) => {
-            if (!firstNotificationLogged) {
-                firstNotificationLogged = true;
-                logCodexRuntimeStep("continue_session.first_notification", runtimeStartedAtMs, {
+            const syntheticRawStoreRef = buildRuntimeRawStoreRef(providerSessionId);
+            let resolvedSessionId = providerSessionId;
+            let resolvedFallbackHistoryRawStoreRef = null;
+            const resumeThreadStartedAtMs = performance.now();
+            let resumed;
+            try {
+                resumed = await transport.resumeThread(request, resolvedSessionId);
+                logCodexRuntimeStep("continue_session.thread_resume", resumeThreadStartedAtMs, {
                     sessionId: request.sessionId,
                     providerSessionId: resolvedSessionId,
-                    method: ensureText(notification.method).trim() || null
+                    fallback: false
                 });
             }
-            const translated = translateCodexAppServerNotification(notification);
-            forwardTranslatedNotification(translated);
-        });
-        transport.setServerRequestHandler(async (serverRequest) => {
-            if (!this.options.handleServerRequest) {
-                throw new Error("CODEX_APP_SERVER_REQUEST_NOT_SUPPORTED");
+            catch (error) {
+                const fallbackHistorySource = await this.resolveContinueFallbackHistorySource({
+                    providerSessionId,
+                    rawStoreRef: request.rawStoreRef,
+                    workspacePath: request.workspacePath,
+                    homeDir: request.runtimeHomeDir?.trim() || this.options.homeDir?.trim() || null
+                });
+                const resumeHistory = fallbackHistorySource?.history ?? [];
+                if (!shouldFallbackCodexContinueFromHistory(error, resumeHistory)) {
+                    throw error;
+                }
+                resolvedFallbackHistoryRawStoreRef = fallbackHistorySource?.rawStoreRef ?? null;
+                const resumeFallbackStartedAtMs = performance.now();
+                resumed = await transport.resumeThreadFromHistory({
+                    providerSessionId: null,
+                    workspacePath: request.workspacePath,
+                    history: resumeHistory,
+                    model: request.options.model
+                });
+                resolvedSessionId = resumed.providerSessionId;
+                logCodexRuntimeStep("continue_session.thread_resume_from_history_fallback", resumeFallbackStartedAtMs, {
+                    sessionId: request.sessionId,
+                    requestedProviderSessionId: providerSessionId,
+                    providerSessionId: resolvedSessionId,
+                    historyLength: resumeHistory.length
+                });
             }
-            return this.options.handleServerRequest({
+            const pickedRawStoreRef = pickAvailableCodexRawStoreRef(resolvedSessionId, [resolvedFallbackHistoryRawStoreRef, request.rawStoreRef, resumed.rawStoreRef], syntheticRawStoreRef);
+            const rawStoreRef = !resumed.rawStoreRef?.trim() && resolvedFallbackHistoryRawStoreRef
+                ? resolvedFallbackHistoryRawStoreRef
+                : pickedRawStoreRef;
+            const abortController = new AbortController();
+            const eventQueue = createAsyncEventQueue();
+            const translateNotification = createCodexAppServerNotificationTranslator();
+            const forwardTranslatedNotification = createCodexTranslatedNotificationForwarder(eventQueue);
+            logCodexRuntimeStep("continue_session.raw_store_ref_ready", runtimeStartedAtMs, {
                 sessionId: request.sessionId,
                 providerSessionId: resolvedSessionId,
-                request: serverRequest
+                synthetic: isSyntheticRawStoreRef(rawStoreRef),
+                hasResumedRawStoreRef: Boolean(resumed.rawStoreRef),
+                hasRequestRawStoreRef: Boolean(request.rawStoreRef),
+                resumedRawStoreRefExists: Boolean(resumed.rawStoreRef && existsSync(resumed.rawStoreRef))
             });
-        });
-        transport.setOnClose((error) => {
-            if (error) {
-                eventQueue.push({
-                    type: "turn.failed",
-                    timestamp: nextTimestamp(),
-                    error: error.message
+            sink.updateSessionBinding({
+                providerSessionId: resolvedSessionId,
+                rawStoreRef
+            });
+            let firstNotificationLogged = false;
+            transport.setNotificationHandler(async (notification) => {
+                if (!firstNotificationLogged) {
+                    firstNotificationLogged = true;
+                    logCodexRuntimeStep("continue_session.first_notification", runtimeStartedAtMs, {
+                        sessionId: request.sessionId,
+                        providerSessionId: resolvedSessionId,
+                        method: ensureText(notification.method).trim() || null
+                    });
+                }
+                const translated = translateNotification(notification);
+                forwardTranslatedNotification(translated);
+            });
+            transport.setServerRequestHandler(async (serverRequest) => {
+                if (!this.options.handleServerRequest) {
+                    throw new Error("CODEX_APP_SERVER_REQUEST_NOT_SUPPORTED");
+                }
+                return this.options.handleServerRequest({
+                    sessionId: request.sessionId,
+                    providerSessionId: resolvedSessionId,
+                    request: serverRequest
                 });
+            });
+            transport.setOnClose((error) => {
+                if (error) {
+                    eventQueue.push({
+                        type: "turn.failed",
+                        timestamp: nextTimestamp(),
+                        error: error.message
+                    });
+                }
+                eventQueue.close();
+            });
+            const startTurnStartedAtMs = performance.now();
+            const startTurnResult = await transport.startTurn(request, resolvedSessionId);
+            const startTurnNotification = startTurnResult?.notification ?? null;
+            if (startTurnNotification) {
+                const translated = translateNotification(startTurnNotification);
+                forwardTranslatedNotification(translated);
             }
-            eventQueue.close();
-        });
-        const startTurnStartedAtMs = performance.now();
-        const startTurnResult = await transport.startTurn(request, resolvedSessionId);
-        const startTurnNotification = startTurnResult?.notification ?? null;
-        if (startTurnNotification) {
-            const translated = translateCodexAppServerNotification(startTurnNotification);
-            forwardTranslatedNotification(translated);
-        }
-        logCodexRuntimeStep("continue_session.turn_start", startTurnStartedAtMs, {
-            sessionId: request.sessionId,
-            providerSessionId: resolvedSessionId
-        });
-        logCodexRuntimeStep("continue_session.ready", runtimeStartedAtMs, {
-            sessionId: request.sessionId,
-            providerSessionId: resolvedSessionId
-        });
-        return {
-            providerSessionId: resolvedSessionId,
-            rawStoreRef,
-            submitDuringRun: async (options) => {
-                await transport.steerTurn(options);
-            },
-            interrupt: async () => {
-                abortController.abort();
-                await transport.interruptTurn().catch(() => {
-                    return;
-                });
-                transport.close();
-            },
-            isAlive: () => transport.isClosed() === false,
-            completed: this.runTurn(null, request, sink, resolvedSessionId, rawStoreRef, abortController, eventQueue.iterator, [], Date.now()).finally(() => {
-                transport.close();
-            })
-        };
+            logCodexRuntimeStep("continue_session.turn_start", startTurnStartedAtMs, {
+                sessionId: request.sessionId,
+                providerSessionId: resolvedSessionId
+            });
+            logCodexRuntimeStep("continue_session.ready", runtimeStartedAtMs, {
+                sessionId: request.sessionId,
+                providerSessionId: resolvedSessionId
+            });
+            return {
+                providerSessionId: resolvedSessionId,
+                rawStoreRef,
+                submitDuringRun: async (options) => {
+                    await transport.steerTurn(options);
+                },
+                interrupt: async () => {
+                    abortController.abort();
+                    await transport.interruptTurn().catch(() => {
+                        return;
+                    });
+                    transport.close();
+                },
+                isAlive: () => transport.isClosed() === false,
+                completed: this.runTurn(null, request, sink, resolvedSessionId, rawStoreRef, abortController, eventQueue.iterator, [], Date.now()).finally(() => {
+                    transport.close();
+                })
+            };
+        }
+        catch (error) {
+            transport.close();
+            throw error;
+        }
     }
     async resolveContinueFallbackHistorySource(input) {
         const candidates = [];
@@ -337,7 +361,7 @@ export class CodexRuntimeAdapter {
         pushCandidate(input.rawStoreRef);
         // 旧会话的 binding 可能只剩 synthetic stream，或者已经指到了父线程 transcript。
         // 继续会话失败时，额外按真实 thread id 扫一次本地 transcript，尽量把历史恢复链路救回来。
-        pushCandidate(await this.resolveRealRawStoreRef(input.providerSessionId.trim(), input.workspacePath));
+        pushCandidate(await this.resolveRealRawStoreRef(input.providerSessionId.trim(), input.workspacePath, input.homeDir));
         let fallbackMatch = null;
         for (const candidate of candidates) {
             const history = buildCodexResumeHistoryFromRawStore(candidate);
@@ -371,6 +395,7 @@ export class CodexRuntimeAdapter {
             sink,
             workspacePath: request.workspacePath,
             firstUserMessage: request.options.content,
+            homeDir: request.runtimeHomeDir?.trim() || this.options.homeDir?.trim() || null,
             launchedAtMs,
             launchPerfStartedAtMs
         };
@@ -613,8 +638,8 @@ export class CodexRuntimeAdapter {
         if (!isSyntheticRawStoreRef(context.rawStoreRef)) {
             return;
         }
-        const resolved = await this.resolveLaunchedSessionBinding(context.workspacePath, context.firstUserMessage, context.launchedAtMs) ??
-            await this.resolveExistingSessionBinding(context.providerSessionId, context.rawStoreRef, context.workspacePath);
+        const resolved = await this.resolveLaunchedSessionBinding(context.workspacePath, context.firstUserMessage, context.launchedAtMs, context.homeDir) ??
+            await this.resolveExistingSessionBinding(context.providerSessionId, context.rawStoreRef, context.workspacePath, context.homeDir);
         if (!resolved ||
             (resolved.providerSessionId === context.providerSessionId &&
                 resolved.rawStoreRef === context.rawStoreRef)) {
@@ -627,7 +652,7 @@ export class CodexRuntimeAdapter {
             rawStoreRef: resolved.rawStoreRef
         });
     }
-    async resolveExistingSessionBinding(providerSessionId, rawStoreRef, workspacePath) {
+    async resolveExistingSessionBinding(providerSessionId, rawStoreRef, workspacePath, homeDirOverride = null) {
         const normalizedProviderSessionId = providerSessionId.trim();
         const meta = readSessionMeta(rawStoreRef);
         if (meta && meta.threadId === normalizedProviderSessionId && existsSync(rawStoreRef)) {
@@ -639,7 +664,7 @@ export class CodexRuntimeAdapter {
         if (!normalizedProviderSessionId) {
             return null;
         }
-        const resolvedRawStoreRef = await this.resolveRealRawStoreRef(normalizedProviderSessionId, workspacePath);
+        const resolvedRawStoreRef = await this.resolveRealRawStoreRef(normalizedProviderSessionId, workspacePath, homeDirOverride);
         if (!resolvedRawStoreRef) {
             return null;
         }
@@ -648,9 +673,9 @@ export class CodexRuntimeAdapter {
             rawStoreRef: resolvedRawStoreRef
         };
     }
-    async resolveLaunchedSessionBinding(workspacePath, firstUserMessage, launchedAtMs) {
+    async resolveLaunchedSessionBinding(workspacePath, firstUserMessage, launchedAtMs, homeDirOverride = null) {
         for (let attempt = 0; attempt < 20; attempt += 1) {
-            const matched = this.findLaunchedSessionBindingOnce(workspacePath, firstUserMessage, launchedAtMs);
+            const matched = this.findLaunchedSessionBindingOnce(workspacePath, firstUserMessage, launchedAtMs, homeDirOverride);
             if (matched) {
                 return matched;
             }
@@ -660,9 +685,9 @@ export class CodexRuntimeAdapter {
         }
         return null;
     }
-    async resolveRealRawStoreRef(providerSessionId, workspacePath) {
+    async resolveRealRawStoreRef(providerSessionId, workspacePath, homeDirOverride = null) {
         for (let attempt = 0; attempt < 10; attempt += 1) {
-            const matched = this.findRawStoreRefOnce(providerSessionId, workspacePath);
+            const matched = this.findRawStoreRefOnce(providerSessionId, workspacePath, homeDirOverride);
             if (matched) {
                 return matched;
             }
@@ -672,8 +697,11 @@ export class CodexRuntimeAdapter {
         }
         return null;
     }
-    findRawStoreRefOnce(providerSessionId, workspacePath) {
-        const homeDir = this.options.homeDir?.trim() || process.env.CODINGNS_CODEX_HOME || join(homedir(), ".codex");
+    findRawStoreRefOnce(providerSessionId, workspacePath, homeDirOverride = null) {
+        const homeDir = homeDirOverride?.trim()
+            || this.options.homeDir?.trim()
+            || process.env.CODINGNS_CODEX_HOME
+            || join(homedir(), ".codex");
         const candidates = this.listSessionFiles(homeDir);
         const normalizedWorkspace = normalizeWorkspacePath(workspacePath);
         for (const filePath of candidates) {
@@ -714,8 +742,8 @@ export class CodexRuntimeAdapter {
         }
         return files;
     }
-    findLaunchedSessionBindingOnce(workspacePath, firstUserMessage, launchedAtMs) {
-        const dbPath = findLatestCodexStateDatabase(this.getCodexHomeDir());
+    findLaunchedSessionBindingOnce(workspacePath, firstUserMessage, launchedAtMs, homeDirOverride = null) {
+        const dbPath = findLatestCodexStateDatabase(this.getCodexHomeDir(homeDirOverride));
         if (!dbPath) {
             return null;
         }
@@ -751,8 +779,11 @@ export class CodexRuntimeAdapter {
         }
         return null;
     }
-    getCodexHomeDir() {
-        return this.options.homeDir?.trim() || process.env.CODINGNS_CODEX_HOME || join(homedir(), ".codex");
+    getCodexHomeDir(homeDirOverride = null) {
+        return (homeDirOverride?.trim()
+            || this.options.homeDir?.trim()
+            || process.env.CODINGNS_CODEX_HOME
+            || join(homedir(), ".codex"));
     }
     buildMessage(context, input) {
         const stableRef = this.resolveStableMessageRef(context, input.stableIdentity ?? null);
@@ -830,8 +861,12 @@ export class CodexRuntimeAdapter {
 function createCodexAppServerTransport(options) {
     const commandPath = resolveCodexCommand(options.commandPath);
     const launch = resolveCodexCommandLaunch(commandPath, ["app-server"]);
+    const runtimeEnv = options.runtimeEnv ?? null;
     const child = spawn(launch.command, launch.args, {
-        env: process.env,
+        env: {
+            ...process.env,
+            ...(runtimeEnv ?? {})
+        },
         stdio: ["pipe", "pipe", "pipe"],
         shell: launch.shell,
         windowsHide: true
@@ -1230,110 +1265,285 @@ function normalizeReplayKeyText(value) {
     }
     return ensureText(value).trim();
 }
-function translateCodexAppServerNotification(notification) {
-    const method = ensureText(notification.method).trim();
-    const params = toRecord(notification.params) ?? {};
-    if (method === "turn/started") {
+function createCodexAppServerNotificationTranslator() {
+    const agentMessageTextById = new Map();
+    const reasoningSummaryPartsById = new Map();
+    const reasoningContentPartsById = new Map();
+    const resetStreamState = () => {
+        agentMessageTextById.clear();
+        reasoningSummaryPartsById.clear();
+        reasoningContentPartsById.clear();
+    };
+    const ensureIndexedTextPart = (store, itemId, index) => {
+        if (!itemId || !Number.isInteger(index) || index < 0) {
+            return null;
+        }
+        const existing = store.get(itemId) ?? [];
+        while (existing.length <= index) {
+            existing.push("");
+        }
+        store.set(itemId, existing);
+        return existing;
+    };
+    const buildReasoningSyntheticItem = (itemId) => {
+        // 这里必须复制一份快照，不能把可变数组引用直接塞进事件队列。
+        // 否则后续 delta 继续追加时，前一帧事件里的 summary/content 也会被同步改掉，
+        // 最终所有帧都会看起来像“最后一帧”，下游稳定消息去重就会把中间增量吃掉。
+        const summary = [...(reasoningSummaryPartsById.get(itemId) ?? [])];
+        const content = [...(reasoningContentPartsById.get(itemId) ?? [])];
         return {
-            events: [],
-            terminal: false,
-            turnId: ensureText(readProp(readProp(params, "turn"), "id")).trim() || null
+            type: "reasoning",
+            id: itemId,
+            summary,
+            content
         };
-    }
-    if (method === "turn/completed") {
-        const turn = toRecord(params.turn);
-        const status = ensureText(turn?.status).trim();
-        const itemEvents = translateCodexAppServerTurnItems(turn, "item.completed");
-        if (status === "failed") {
-            return {
-                events: [
-                    ...itemEvents,
-                    {
-                        type: "turn.failed",
-                        timestamp: nextTimestamp(),
-                        error: ensureText(readProp(turn?.error, "message")).trim() || "codex turn failed"
-                    }
-                ],
-                terminal: true,
-                turnId: ensureText(turn?.id).trim() || null
-            };
-        }
-        if (status === "interrupted") {
+    };
+    const translateAgentMessageDelta = (params) => {
+        const itemId = ensureText(params.itemId).trim();
+        const delta = ensureText(params.delta);
+        if (!itemId || delta.length === 0) {
             return {
-                events: [
-                    ...itemEvents,
-                    {
-                        type: "turn.interrupted",
-                        timestamp: nextTimestamp()
-                    }
-                ],
-                terminal: true,
-                turnId: ensureText(turn?.id).trim() || null
+                events: [],
+                terminal: false,
+                turnId: ensureText(params.turnId).trim() || null
             };
         }
+        const nextText = `${agentMessageTextById.get(itemId) ?? ""}${delta}`;
+        agentMessageTextById.set(itemId, nextText);
         return {
             events: [
-                ...itemEvents,
                 {
-                    type: "turn.completed",
+                    type: "item.updated",
+                    item: {
+                        type: "agent_message",
+                        id: itemId,
+                        text: nextText
+                    },
                     timestamp: nextTimestamp()
                 }
             ],
-            terminal: true,
-            turnId: ensureText(turn?.id).trim() || null
+            terminal: false,
+            turnId: ensureText(params.turnId).trim() || null
         };
-    }
-    if (method === "error") {
-        const error = toRecord(params.error);
-        const detail = buildCodexAppServerErrorDetail(error);
-        if (params.willRetry === true) {
+    };
+    const translateReasoningSummaryPartAdded = (params) => {
+        const itemId = ensureText(params.itemId).trim();
+        const summaryIndex = Math.trunc(Number(params.summaryIndex));
+        ensureIndexedTextPart(reasoningSummaryPartsById, itemId, summaryIndex);
+        return {
+            events: [],
+            terminal: false,
+            turnId: ensureText(params.turnId).trim() || null
+        };
+    };
+    const translateReasoningSummaryTextDelta = (params) => {
+        const itemId = ensureText(params.itemId).trim();
+        const summaryIndex = Math.trunc(Number(params.summaryIndex));
+        const delta = ensureText(params.delta);
+        const parts = ensureIndexedTextPart(reasoningSummaryPartsById, itemId, summaryIndex);
+        if (!parts || delta.length === 0) {
             return {
                 events: [],
                 terminal: false,
                 turnId: ensureText(params.turnId).trim() || null
             };
         }
+        parts[summaryIndex] = `${parts[summaryIndex] ?? ""}${delta}`;
         return {
             events: [
                 {
-                    type: "turn.failed",
-                    timestamp: nextTimestamp(),
-                    error: detail
+                    type: "item.updated",
+                    item: buildReasoningSyntheticItem(itemId),
+                    timestamp: nextTimestamp()
                 }
             ],
-            terminal: true,
+            terminal: false,
             turnId: ensureText(params.turnId).trim() || null
         };
-    }
-    if (method === "item/started" || method === "item/updated" || method === "item/completed") {
-        const item = translateCodexAppServerItem(toRecord(params.item));
-        if (!item) {
+    };
+    const translateReasoningTextDelta = (params) => {
+        const itemId = ensureText(params.itemId).trim();
+        const contentIndex = Math.trunc(Number(params.contentIndex));
+        const delta = ensureText(params.delta);
+        const parts = ensureIndexedTextPart(reasoningContentPartsById, itemId, contentIndex);
+        if (!parts || delta.length === 0) {
             return {
                 events: [],
                 terminal: false,
-                turnId: null
+                turnId: ensureText(params.turnId).trim() || null
             };
         }
+        parts[contentIndex] = `${parts[contentIndex] ?? ""}${delta}`;
         return {
             events: [
                 {
-                    type: method === "item/started"
-                        ? "item.started"
-                        : method === "item/updated"
-                            ? "item.updated"
-                            : "item.completed",
-                    item,
+                    type: "item.updated",
+                    item: buildReasoningSyntheticItem(itemId),
                     timestamp: nextTimestamp()
                 }
             ],
             terminal: false,
+            turnId: ensureText(params.turnId).trim() || null
+        };
+    };
+    return (notification) => {
+        const method = ensureText(notification.method).trim();
+        const params = toRecord(notification.params) ?? {};
+        if (method === "turn/started") {
+            return {
+                events: [],
+                terminal: false,
+                turnId: ensureText(readProp(readProp(params, "turn"), "id")).trim() || null
+            };
+        }
+        if (method === "turn/completed") {
+            const turn = toRecord(params.turn);
+            const status = ensureText(turn?.status).trim();
+            const itemEvents = translateCodexAppServerTurnItems(turn, "item.completed");
+            resetStreamState();
+            if (status === "failed") {
+                return {
+                    events: [
+                        ...itemEvents,
+                        {
+                            type: "turn.failed",
+                            timestamp: nextTimestamp(),
+                            error: ensureText(readProp(turn?.error, "message")).trim() || "codex turn failed"
+                        }
+                    ],
+                    terminal: true,
+                    turnId: ensureText(turn?.id).trim() || null
+                };
+            }
+            if (status === "interrupted") {
+                return {
+                    events: [
+                        ...itemEvents,
+                        {
+                            type: "turn.interrupted",
+                            timestamp: nextTimestamp()
+                        }
+                    ],
+                    terminal: true,
+                    turnId: ensureText(turn?.id).trim() || null
+                };
+            }
+            return {
+                events: [
+                    ...itemEvents,
+                    {
+                        type: "turn.completed",
+                        timestamp: nextTimestamp()
+                    }
+                ],
+                terminal: true,
+                turnId: ensureText(turn?.id).trim() || null
+            };
+        }
+        if (method === "error") {
+            const error = toRecord(params.error);
+            const detail = buildCodexAppServerErrorDetail(error);
+            if (params.willRetry === true) {
+                return {
+                    events: [],
+                    terminal: false,
+                    turnId: ensureText(params.turnId).trim() || null
+                };
+            }
+            resetStreamState();
+            return {
+                events: [
+                    {
+                        type: "turn.failed",
+                        timestamp: nextTimestamp(),
+                        error: detail
+                    }
+                ],
+                terminal: true,
+                turnId: ensureText(params.turnId).trim() || null
+            };
+        }
+        if (method === "item/agentMessage/delta") {
+            return translateAgentMessageDelta(params);
+        }
+        if (method === "item/reasoning/summaryPartAdded") {
+            return translateReasoningSummaryPartAdded(params);
+        }
+        if (method === "item/reasoning/summaryTextDelta") {
+            return translateReasoningSummaryTextDelta(params);
+        }
+        if (method === "item/reasoning/textDelta") {
+            return translateReasoningTextDelta(params);
+        }
+        if (method === "item/started" || method === "item/updated" || method === "item/completed") {
+            const item = translateCodexAppServerItem(toRecord(params.item));
+            if (!item) {
+                return {
+                    events: [],
+                    terminal: false,
+                    turnId: null
+                };
+            }
+            if (ensureText(item.type).trim() === "agent_message") {
+                const itemId = ensureText(item.id).trim();
+                const itemText = ensureText(item.text);
+                if (itemId) {
+                    if (itemText.length > 0) {
+                        agentMessageTextById.set(itemId, itemText);
+                    }
+                    else if (method === "item/completed") {
+                        agentMessageTextById.delete(itemId);
+                    }
+                }
+            }
+            if (ensureText(item.type).trim() === "reasoning") {
+                const itemId = ensureText(item.id).trim();
+                if (itemId) {
+                    const summary = Array.isArray(item.summary)
+                        ? item.summary.map((entry) => ensureText(entry))
+                        : ensureText(item.summary).trim()
+                            ? [ensureText(item.summary)]
+                            : [];
+                    const content = Array.isArray(item.content)
+                        ? item.content.map((entry) => ensureText(entry))
+                        : ensureText(item.text).trim()
+                            ? [ensureText(item.text)]
+                            : [];
+                    if (summary.length > 0) {
+                        reasoningSummaryPartsById.set(itemId, summary);
+                    }
+                    else if (method === "item/completed") {
+                        reasoningSummaryPartsById.delete(itemId);
+                    }
+                    if (content.length > 0) {
+                        reasoningContentPartsById.set(itemId, content);
+                    }
+                    else if (method === "item/completed") {
+                        reasoningContentPartsById.delete(itemId);
+                    }
+                }
+            }
+            return {
+                events: [
+                    {
+                        type: method === "item/started"
+                            ? "item.started"
+                            : method === "item/updated"
+                                ? "item.updated"
+                                : "item.completed",
+                        item,
+                        timestamp: nextTimestamp()
+                    }
+                ],
+                terminal: false,
+                turnId: null
+            };
+        }
+        return {
+            events: [],
+            terminal: false,
             turnId: null
         };
-    }
-    return {
-        events: [],
-        terminal: false,
-        turnId: null
     };
 }
 function translateCodexAppServerTurnItems(turn, eventType) {
@@ -1796,7 +2006,20 @@ function writeJsonRpcMessage(child, payload) {
 function sendJsonRpcRequest(child, pendingResponses, createRequestId, input) {
     const id = createRequestId();
     return new Promise((resolve, reject) => {
-        pendingResponses.set(id, { resolve, reject });
+        const timeout = setTimeout(() => {
+            pendingResponses.delete(id);
+            reject(new Error("SERVER_TIMEOUT"));
+        }, CODEX_APP_SERVER_REQUEST_TIMEOUT_MS);
+        pendingResponses.set(id, {
+            resolve: (value) => {
+                clearTimeout(timeout);
+                resolve(value);
+            },
+            reject: (error) => {
+                clearTimeout(timeout);
+                reject(error);
+            }
+        });
         try {
             writeJsonRpcMessage(child, {
                 jsonrpc: "2.0",
@@ -1806,6 +2029,7 @@ function sendJsonRpcRequest(child, pendingResponses, createRequestId, input) {
             });
         }
         catch (error) {
+            clearTimeout(timeout);
             pendingResponses.delete(id);
             reject(error instanceof Error ? error : new Error("CODEX_APP_SERVER_REQUEST_WRITE_FAILED"));
         }
@@ -1843,7 +2067,7 @@ function shouldFallbackCodexContinueFromHistory(error, history) {
     if (history.length === 0) {
         return false;
     }
-    return isCodexThreadLoadError(error);
+    return isCodexThreadLoadError(error) || isCodexRequestTimeoutError(error);
 }
 function isCodexThreadLoadError(error) {
     const message = error instanceof Error ? error.message : String(error);
@@ -1851,6 +2075,9 @@ function isCodexThreadLoadError(error) {
     return (normalized.includes("thread not loaded") ||
         normalized.includes("no rollout found for thread id"));
 }
+function isCodexRequestTimeoutError(error) {
+    return error instanceof Error && error.message === "SERVER_TIMEOUT";
+}
 function readProp(value, key) {
     if (!value || typeof value !== "object") {
         return null;