lark-remote 0.1.10 → 0.1.12

package/dist/runner/opencode/acp/runner.js

@@ -25,6 +25,7 @@ import { RpcErrorCode, } from '../../common/acp/protocol-types.js';
 import { findOptionIdByKind } from '../../common/acp/protocol-helpers.js';
 import { getLogger } from '../../../logger/index.js';
 import { ConnectionBasedRunner } from '../../common/connection-based-runner.js';
+import { OpencodeLogErrorMonitor, resolveOpencodeLogPath } from './error-monitor.js';
 /**
  * Build the ACP protocol response for a permission approval decision.
  *
@@ -79,6 +80,9 @@ export class OpencodeAcpRunner extends ConnectionBasedRunner {
     currentModeId;
     /** Current model value (`provider/model`), parsed from configOptions. */
     currentModelValue;
+    /** Tails opencode's own log to surface LLM stream errors the ACP protocol
+     *  never forwards (quota/limit errors back off for ~1h → turn would hang). */
+    errorMonitor;
     /** Pending approval requests: requestId → kind + view + options. */
     pendingApprovals = new Map();
     /** Tracker for the in-flight prompt request — needed for cancellation. */
@@ -91,6 +95,10 @@ export class OpencodeAcpRunner extends ConnectionBasedRunner {
         super({ kind: opts.kind, sessionReader: opts.sessionReader }, opts.turnIdleTimeoutMs);
         this.model = opts.model;
         this.configuredMode = opts.mode ?? 'build';
+        this.errorMonitor = new OpencodeLogErrorMonitor({
+            logPath: opts.errorMonitorLogPath ?? resolveOpencodeLogPath(),
+            pollIntervalMs: opts.errorMonitorPollIntervalMs,
+        });
         const managerOpts = {
             binary: opts.binary ?? 'opencode',
             args: opts.acpArgs ?? ['acp'],
@@ -138,11 +146,27 @@ export class OpencodeAcpRunner extends ConnectionBasedRunner {
         }
     }
     clearTurnState() {
+        this.errorMonitor.stop();
         this.currentTranslator = null;
         this.promptSettled = false;
         this.promptSent = false;
         this.activeSessionId = null;
     }
+    /**
+     * Start watching opencode's own log for LLM stream errors of the active
+     * session. opencode ACP does not surface retry/error state to the client
+     * (no error/status notification type, session/list has no status field), so
+     * the log is the only channel that carries the real provider error. Without
+     * this, a quota error (e.g. opencode-go weekly limit) leaves session/prompt
+     * pending for the full retry-after backoff (~1h) and the Feishu card hangs
+     * until the idle watchdog.
+     */
+    startErrorMonitor(sessionId) {
+        this.errorMonitor.start(sessionId, (message) => {
+            getLogger().warn(`[${this.logTag}] opencode stream error detected (log), failing turn: ${message}`);
+            this.failTurn(`opencode LLM stream error: ${message}`);
+        });
+    }
     async releaseConnection(cwd) {
         await this.connectionManager.release(cwd);
     }
@@ -175,6 +199,7 @@ export class OpencodeAcpRunner extends ConnectionBasedRunner {
                 throw new Error('compact requires a sessionId');
             }
             this.activeSessionId = sessionId;
+            this.startErrorMonitor(sessionId);
             // Cold-connection fallback: session/resume loads the session into
             // memory. On a reused connection the session is already loaded —
             // resume is idempotent and harmless.
@@ -310,6 +335,7 @@ export class OpencodeAcpRunner extends ConnectionBasedRunner {
             sessionId = newResult.sessionId;
         }
         this.activeSessionId = sessionId;
+        this.startErrorMonitor(sessionId);
         // §P5: apply the configured mode (build/plan). If the session already
         // runs it (from session/new|resume configOptions), skip the wire call;
         // otherwise send session/set_mode and refresh the local view (opencode

package/dist/runner/types.d.ts

@@ -416,6 +416,21 @@ export interface SessionContent {
     recap?: string;
     displayTitle?: string;
 }
+/**
+ * Lightweight session summary used by `/resume` list prefetch.
+ *
+ * Carries only the display fields (title / recap / usage) — **no `events`
+ * array**. Readers that can extract these without constructing the full event
+ * list (e.g. codex, which would otherwise JSON.parse every response_item and
+ * build an `events[]` that the prefetch immediately discards) implement the
+ * optional `readSessionSummary` on `AgentSessionReader`.
+ */
+export interface SessionSummary {
+    aiTitle?: string;
+    recap?: string;
+    displayTitle?: string;
+    usage?: AgentSessionUsage;
+}
 /**
  * Reads an agent's session history. Each agent implements its own (Claude reads
  * `~/.claude/projects/`, Codex calls `thread/list`, OpenCode calls `GET /session`).
@@ -448,6 +463,14 @@ export interface AgentSessionReader {
     readSessionContent(sessionId: string, cwd: string, opts?: {
         maxEvents?: number;
     }): SessionContent;
+    /**
+     * Optional lightweight summary for list-prefetch.
+     *
+     * Returns only the display fields (aiTitle/recap/displayTitle/usage) without
+     * constructing the full `events` array. When absent, callers fall back to
+     * `readSessionContent` and take the needed fields.
+     */
+    readSessionSummary?(sessionId: string, cwd: string): SessionSummary;
     /**
      * Whether a session is still active (process may still be running).
      *

package/dist/session/codex/rollout-reader.d.ts

@@ -13,7 +13,7 @@
  * Note: This handles the **rollout file format** (historical logging), NOT the
  * `codex exec --json` stdout format（已随 exec 模式移除）。
  */
-import type { AgentSessionContentEvent, SessionContent, AgentSessionUsage } from '../../runner/index.js';
+import type { AgentSessionContentEvent, SessionContent, SessionSummary, AgentSessionUsage } from '../../runner/index.js';
 interface CodexRolloutEntry {
     threadId: string;
     cwd: string;
@@ -38,6 +38,19 @@ interface ListCodexRolloutsOptions {
     offset?: number;
 }
 export declare function readCodexRollout(filePath: string): CodexRolloutEntry | null;
+/**
+ * Lightweight single-file scan that extracts only the display-relevant fields
+ * (last real user message + usage) — **without** constructing the `events`
+ * array. Backs `readCodexSessionSummary` so the `/resume` list prefetch does
+ * not pay the cost of JSON.parse-ing every response_item and building events
+ * that are immediately discarded.
+ *
+ * Returns null if the file doesn't exist, is corrupted, or has no session_meta.
+ */
+export declare function readCodexRolloutSummary(filePath: string): {
+    lastRealUserMessage: string;
+    usage?: AgentSessionUsage;
+} | null;
 /**
  * List Codex sessions from rollout files.
  *
@@ -71,6 +84,17 @@ export declare function readCodexSessionContent(sessionId: string, opts?: {
     maxEvents?: number;
     cwd?: string;
 }): SessionContent;
+/**
+ * Read the summary (title + usage, no events) of a specific session by id.
+ *
+ * Mirrors `readCodexSessionContent`'s index lookup + cwd guard, but uses the
+ * lightweight `readCodexRolloutSummary` instead of the full parse — so the
+ * `/resume` list prefetch never constructs the events array it would discard.
+ */
+export declare function readCodexSessionSummary(sessionId: string, opts?: {
+    codexHome?: string;
+    cwd?: string;
+}): SessionSummary;
 /**
  * Check if a session is still active (recently updated).
  *

package/dist/session/codex/rollout-reader.js

@@ -35,130 +35,8 @@ export function readCodexRollout(filePath) {
         return null;
     }
     try {
-        const lines = readJsonlLines(filePath);
-        const events = [];
-        let sessionMeta = null;
-        // Real user input is identified by a paired `event_msg` whose
-        // payload.type === "user_message" - codex emits this ONLY for text the
-        // human actually typed. Injected scaffolding (project rules,
-        // <environment_context>, permissions) is also written as `role:"user"`
-        // response_items but has NO user_message event, so it must be excluded
-        // from displayTitle/recap/summary. Regression 2026-07-13: the first
-        // `role:user` message is the injected project rules, mistakenly shown as
-        // "最近输入".
-        const realUserMessages = [];
-        // token_count tracking: codex emits cumulative `total_token_usage` and an
-        // incremental `last_token_usage`. We want the LAST turn's usage (matches
-        // pi/opencode /resume "last turn" display semantics). When
-        // last_token_usage is absent we derive it as total - previous_total.
-        let lastRawUsage;
-        // Context window limit from the same token_count event as lastRawUsage
-        // (codex reports info.model_context_window per turn; absent on old data).
-        let lastContextLimit;
-        // Final total_token_usage (cumulative across the whole session) for the
-        // Run card's "累计" display. Codex emits this alongside last_token_usage.
-        let lastTotalUsage;
-        let previousTotals;
-        // Compaction 统计：codex 的 compact turn 在会话文件里写顶层 `compacted`
-        // 事件（含摘要），压缩前后的上下文水位由相邻 token_count 表达。压缩收尾的
-        // token_count 增量是 input/cached/output 全 0、只有 total_tokens 有值
-        // （窗口被摘要+replacement history 占据），现有 zero-filter 会跳过它，
-        // 因此这里必须单独捕获，不能复用 lastRawUsage。
-        // 单位口径（review P3-9）：前后两侧统一用 total_tokens —— 压缩前取最近一次
-        // 非零 token_count 的 total_tokens（input+output，即该 turn 在窗口内的全部
-        // token），压缩后取收尾事件的 total_tokens（压缩后窗口）。不得一边 input
-        // 一边 total，否则「压缩前 X → 压缩后 Y」两边单位不一致。
-        let compactCount = 0;
-        let compactPreContextLength;
-        let compactPostContextLength;
-        for (const line of lines) {
-            const trimmed = line.trim();
-            if (!trimmed)
-                continue;
-            try {
-                const parsed = JSON.parse(trimmed);
-                if (!parsed || typeof parsed.type !== 'string')
-                    continue;
-                if (parsed.type === 'session_meta' && parsed.payload) {
-                    sessionMeta = parsed.payload;
-                }
-                else if (parsed.type === 'event_msg' && parsed.payload) {
-                    // user_message events carry the authoritative human-typed text.
-                    const payload = parsed.payload;
-                    if (payload.type === 'user_message') {
-                        const text = stringValue(payload.message);
-                        if (text) {
-                            realUserMessages.push(text.slice(0, 200));
-                        }
-                    }
-                    else if (payload.type === 'token_count') {
-                        const info = payload.info;
-                        const last = info?.last_token_usage;
-                        const total = info?.total_token_usage;
-                        let raw;
-                        if (last) {
-                            raw = last;
-                        }
-                        else if (total && previousTotals) {
-                            raw = subtractRawUsage(total, previousTotals);
-                        }
-                        else {
-                            raw = total;
-                        }
-                        if (total) {
-                            previousTotals = total;
-                            lastTotalUsage = total;
-                        }
-                        if (raw && (raw.input_tokens || raw.cached_input_tokens || raw.output_tokens)) {
-                            lastRawUsage = raw;
-                            const ctxWindow = info?.model_context_window;
-                            lastContextLimit = typeof ctxWindow === 'number' ? ctxWindow : undefined;
-                        }
-                        // 压缩后的水位：压缩收尾 token_count 全 0（raw 不满足上面 zero-filter），
-                        // 但 total_tokens 表达真实窗口；之后若出现普通 turn（input>0），
-                        // 水位回归该 turn，post-compact 值失效。
-                        if (compactCount > 0 && raw) {
-                            if (raw.total_tokens &&
-                                !raw.input_tokens &&
-                                !raw.cached_input_tokens &&
-                                !raw.output_tokens) {
-                                compactPostContextLength = raw.total_tokens;
-                            }
-                            else if (raw.input_tokens > 0) {
-                                compactPostContextLength = undefined;
-                            }
-                        }
-                    }
-                }
-                else if (parsed.type === 'compacted') {
-                    // 顶层 compacted 事件：压缩次数 +1，压缩前水位取最近一次非零 token_count。
-                    compactCount++;
-                    if (lastRawUsage?.total_tokens !== undefined) {
-                        compactPreContextLength = lastRawUsage.total_tokens;
-                    }
-                }
-                else if (parsed.type === 'response_item' && parsed.payload) {
-                    const payload = parsed.payload;
-                    if (payload.type === 'message' && Array.isArray(payload.content)) {
-                        // Extract text content for display
-                        const messages = extractMessageContent(payload);
-                        for (const msg of messages) {
-                            events.push({
-                                type: msg.role === 'user' ? 'user' : 'assistant',
-                                content: msg.text,
-                                timestamp: parsed.timestamp,
-                            });
-                        }
-                    }
-                }
-            }
-            catch {
-                // Skip malformed lines
-                continue;
-            }
-        }
-        const firstUserMessage = realUserMessages[0] ?? '';
-        const lastRealUserMessage = realUserMessages[realUserMessages.length - 1] ?? '';
+        const scan = scanCodexRollout(filePath, true);
+        const { sessionMeta } = scan;
         if (!sessionMeta) {
             return null;
         }
@@ -173,48 +51,9 @@ export function readCodexRollout(filePath) {
             ? new Date(String(sessionMeta.timestamp)).getTime()
             : stats.birthtimeMs;
         const updatedAtMs = stats.mtimeMs;
-        // Build ccusage-aligned usage from the last turn's raw tokens.
-        // input = raw - cached (codex reports cached input separately), cache
-        // creation is never reported by codex, reasoning is a subset of output
-        // (display-only, never added to total).
-        // contextLength = input_tokens (= (input_tokens-cached) + cached + 0),
-        // i.e. input + cacheRead + cacheCreation — the unified context-window
-        // occupancy contract across all five readers (review P2-8, excludes
-        // output/reasoning).
-        let usage;
-        if (lastRawUsage) {
-            const r = lastRawUsage;
-            const cached = Math.min(r.cached_input_tokens, r.input_tokens);
-            usage = {
-                inputTokens: r.input_tokens - cached,
-                outputTokens: r.output_tokens,
-                contextLength: r.input_tokens,
-                contextLimit: lastContextLimit,
-                cacheReadTokens: cached,
-                cacheCreationTokens: 0,
-                totalTokens: r.total_tokens,
-            };
-            // Cumulative from the final total_token_usage (non-cached input +
-            // output), summed across all turns in the session.
-            if (lastTotalUsage) {
-                const cumCached = Math.min(lastTotalUsage.cached_input_tokens, lastTotalUsage.input_tokens);
-                usage.cumulativeInputTokens = lastTotalUsage.input_tokens - cumCached;
-                usage.cumulativeOutputTokens = lastTotalUsage.output_tokens;
-                usage.cumulativeTotalTokens = lastTotalUsage.total_tokens;
-                usage.cumulativeCacheReadTokens = cumCached;
-                usage.cumulativeCacheCreationTokens = 0; // Codex 不报告 cache creation
-            }
-            // 压缩统计：会话内出现过 compacted 事件就计数（供 /resume 与 Compact 卡
-            // 展示）；仅当会话以压缩收尾时（post-compact 水位存在），contextLength
-            // 覆盖为压缩后水位并暴露压缩前水位——后续还有普通 turn 时水位回归该 turn。
-            if (compactCount > 0) {
-                usage.compactCount = compactCount;
-                if (compactPostContextLength !== undefined) {
-                    usage.contextLength = compactPostContextLength;
-                    usage.compactPreContextLength = compactPreContextLength;
-                }
-            }
-        }
+        const firstUserMessage = scan.realUserMessages[0] ?? '';
+        const lastRealUserMessage = scan.realUserMessages[scan.realUserMessages.length - 1] ?? '';
+        const usage = buildUsageFromScan(scan);
         return {
             threadId: sessionId,
             cwd,
@@ -222,7 +61,7 @@ export function readCodexRollout(filePath) {
             lastRealUserMessage,
             createdAtMs,
             updatedAtMs,
-            events,
+            events: scan.events,
             usage,
         };
     }
@@ -231,6 +70,222 @@ export function readCodexRollout(filePath) {
         return null;
     }
 }
+/**
+ * Lightweight single-file scan that extracts only the display-relevant fields
+ * (last real user message + usage) — **without** constructing the `events`
+ * array. Backs `readCodexSessionSummary` so the `/resume` list prefetch does
+ * not pay the cost of JSON.parse-ing every response_item and building events
+ * that are immediately discarded.
+ *
+ * Returns null if the file doesn't exist, is corrupted, or has no session_meta.
+ */
+export function readCodexRolloutSummary(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return null;
+    }
+    try {
+        const scan = scanCodexRollout(filePath, false);
+        if (!scan.sessionMeta)
+            return null;
+        return {
+            lastRealUserMessage: scan.realUserMessages[scan.realUserMessages.length - 1] ?? '',
+            usage: buildUsageFromScan(scan),
+        };
+    }
+    catch (err) {
+        getLogger().warn(`[codex-rollout-reader] failed to read summary ${filePath}: ${err}`);
+        return null;
+    }
+}
+/**
+ * Scan a rollout file once, tracking user messages, usage and compaction state.
+ * When `includeEvents` is true, response_item content is also extracted into
+ * `events`; when false, response_item lines are skipped entirely (the summary
+ * fast path).
+ */
+function scanCodexRollout(filePath, includeEvents) {
+    const lines = readJsonlLines(filePath);
+    const events = [];
+    let sessionMeta = null;
+    // Real user input is identified by a paired `event_msg` whose
+    // payload.type === "user_message" - codex emits this ONLY for text the
+    // human actually typed. Injected scaffolding (project rules,
+    // <environment_context>, permissions) is also written as `role:"user"`
+    // response_items but has NO user_message event, so it must be excluded
+    // from displayTitle/recap/summary. Regression 2026-07-13: the first
+    // `role:user` message is the injected project rules, mistakenly shown as
+    // "最近输入".
+    const realUserMessages = [];
+    // token_count tracking: codex emits cumulative `total_token_usage` and an
+    // incremental `last_token_usage`. We want the LAST turn's usage (matches
+    // pi/opencode /resume "last turn" display semantics). When
+    // last_token_usage is absent we derive it as total - previous_total.
+    let lastRawUsage;
+    // Context window limit from the same token_count event as lastRawUsage
+    // (codex reports info.model_context_window per turn; absent on old data).
+    let lastContextLimit;
+    // Final total_token_usage (cumulative across the whole session) for the
+    // Run card's "累计" display. Codex emits this alongside last_token_usage.
+    let lastTotalUsage;
+    let previousTotals;
+    // Compaction 统计：codex 的 compact turn 在会话文件里写顶层 `compacted`
+    // 事件（含摘要），压缩前后的上下文水位由相邻 token_count 表达。压缩收尾的
+    // token_count 增量是 input/cached/output 全 0、只有 total_tokens 有值
+    // （窗口被摘要+replacement history 占据），现有 zero-filter 会跳过它，
+    // 因此这里必须单独捕获，不能复用 lastRawUsage。
+    // 单位口径（review P3-9）：前后两侧统一用 total_tokens —— 压缩前取最近一次
+    // 非零 token_count 的 total_tokens（input+output，即该 turn 在窗口内的全部
+    // token），压缩后取收尾事件的 total_tokens（压缩后窗口）。不得一边 input
+    // 一边 total，否则「压缩前 X → 压缩后 Y」两边单位不一致。
+    let compactCount = 0;
+    let compactPreContextLength;
+    let compactPostContextLength;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (!parsed || typeof parsed.type !== 'string')
+                continue;
+            if (parsed.type === 'session_meta' && parsed.payload) {
+                sessionMeta = parsed.payload;
+            }
+            else if (parsed.type === 'event_msg' && parsed.payload) {
+                // user_message events carry the authoritative human-typed text.
+                const payload = parsed.payload;
+                if (payload.type === 'user_message') {
+                    const text = stringValue(payload.message);
+                    if (text) {
+                        realUserMessages.push(text.slice(0, 200));
+                    }
+                }
+                else if (payload.type === 'token_count') {
+                    const info = payload.info;
+                    const last = info?.last_token_usage;
+                    const total = info?.total_token_usage;
+                    let raw;
+                    if (last) {
+                        raw = last;
+                    }
+                    else if (total && previousTotals) {
+                        raw = subtractRawUsage(total, previousTotals);
+                    }
+                    else {
+                        raw = total;
+                    }
+                    if (total) {
+                        previousTotals = total;
+                        lastTotalUsage = total;
+                    }
+                    if (raw && (raw.input_tokens || raw.cached_input_tokens || raw.output_tokens)) {
+                        lastRawUsage = raw;
+                        const ctxWindow = info?.model_context_window;
+                        lastContextLimit = typeof ctxWindow === 'number' ? ctxWindow : undefined;
+                    }
+                    // 压缩后的水位：压缩收尾 token_count 全 0（raw 不满足上面 zero-filter），
+                    // 但 total_tokens 表达真实窗口；之后若出现普通 turn（input>0），
+                    // 水位回归该 turn，post-compact 值失效。
+                    if (compactCount > 0 && raw) {
+                        if (raw.total_tokens &&
+                            !raw.input_tokens &&
+                            !raw.cached_input_tokens &&
+                            !raw.output_tokens) {
+                            compactPostContextLength = raw.total_tokens;
+                        }
+                        else if (raw.input_tokens > 0) {
+                            compactPostContextLength = undefined;
+                        }
+                    }
+                }
+            }
+            else if (parsed.type === 'compacted') {
+                // 顶层 compacted 事件：压缩次数 +1，压缩前水位取最近一次非零 token_count。
+                compactCount++;
+                if (lastRawUsage?.total_tokens !== undefined) {
+                    compactPreContextLength = lastRawUsage.total_tokens;
+                }
+            }
+            else if (includeEvents && parsed.type === 'response_item' && parsed.payload) {
+                const payload = parsed.payload;
+                if (payload.type === 'message' && Array.isArray(payload.content)) {
+                    // Extract text content for display
+                    const messages = extractMessageContent(payload);
+                    for (const msg of messages) {
+                        events.push({
+                            type: msg.role === 'user' ? 'user' : 'assistant',
+                            content: msg.text,
+                            timestamp: parsed.timestamp,
+                        });
+                    }
+                }
+            }
+        }
+        catch {
+            // Skip malformed lines
+            continue;
+        }
+    }
+    return {
+        sessionMeta,
+        events,
+        realUserMessages,
+        lastRawUsage,
+        lastContextLimit,
+        lastTotalUsage,
+        previousTotals,
+        compactCount,
+        compactPreContextLength,
+        compactPostContextLength,
+    };
+}
+/**
+ * Build ccusage-aligned usage from a scan's last-turn raw tokens.
+ * input = raw - cached (codex reports cached input separately), cache
+ * creation is never reported by codex, reasoning is a subset of output
+ * (display-only, never added to total).
+ * contextLength = input_tokens (= (input_tokens-cached) + cached + 0),
+ * i.e. input + cacheRead + cacheCreation — the unified context-window
+ * occupancy contract across all five readers (review P2-8, excludes
+ * output/reasoning).
+ */
+function buildUsageFromScan(scan) {
+    const { lastRawUsage, lastContextLimit, lastTotalUsage, compactCount, compactPreContextLength, compactPostContextLength, } = scan;
+    if (!lastRawUsage)
+        return undefined;
+    const r = lastRawUsage;
+    const cached = Math.min(r.cached_input_tokens, r.input_tokens);
+    const usage = {
+        inputTokens: r.input_tokens - cached,
+        outputTokens: r.output_tokens,
+        contextLength: r.input_tokens,
+        contextLimit: lastContextLimit,
+        cacheReadTokens: cached,
+        cacheCreationTokens: 0,
+        totalTokens: r.total_tokens,
+    };
+    // Cumulative from the final total_token_usage (non-cached input +
+    // output), summed across all turns in the session.
+    if (lastTotalUsage) {
+        const cumCached = Math.min(lastTotalUsage.cached_input_tokens, lastTotalUsage.input_tokens);
+        usage.cumulativeInputTokens = lastTotalUsage.input_tokens - cumCached;
+        usage.cumulativeOutputTokens = lastTotalUsage.output_tokens;
+        usage.cumulativeTotalTokens = lastTotalUsage.total_tokens;
+        usage.cumulativeCacheReadTokens = cumCached;
+        usage.cumulativeCacheCreationTokens = 0; // Codex 不报告 cache creation
+    }
+    // 压缩统计：会话内出现过 compacted 事件就计数（供 /resume 与 Compact 卡
+    // 展示）；仅当会话以压缩收尾时（post-compact 水位存在），contextLength
+    // 覆盖为压缩后水位并暴露压缩前水位——后续还有普通 turn 时水位回归该 turn。
+    if (compactCount > 0) {
+        usage.compactCount = compactCount;
+        if (compactPostContextLength !== undefined) {
+            usage.contextLength = compactPostContextLength;
+            usage.compactPreContextLength = compactPreContextLength;
+        }
+    }
+    return usage;
+}
 /**
  * List Codex sessions from rollout files.
  *
@@ -327,6 +382,41 @@ export function readCodexSessionContent(sessionId, opts = {}) {
         usage: rollout.usage,
     };
 }
+/**
+ * Read the summary (title + usage, no events) of a specific session by id.
+ *
+ * Mirrors `readCodexSessionContent`'s index lookup + cwd guard, but uses the
+ * lightweight `readCodexRolloutSummary` instead of the full parse — so the
+ * `/resume` list prefetch never constructs the events array it would discard.
+ */
+export function readCodexSessionSummary(sessionId, opts = {}) {
+    const codexHome = resolveCodexHome(opts.codexHome);
+    let index = getSessionIndex(codexHome);
+    let entry = index.get(sessionId);
+    if (!entry) {
+        index = getSessionIndex(codexHome, true);
+        entry = index.get(sessionId);
+    }
+    if (!entry) {
+        return {};
+    }
+    // Cwd guard: same semantics as readCodexSessionContent — when a cwd is
+    // provided, the session's working directory must match.
+    if (opts.cwd && entry.cwd !== opts.cwd) {
+        return {};
+    }
+    const summary = readCodexRolloutSummary(entry.filePath);
+    if (!summary) {
+        return {};
+    }
+    return {
+        // displayTitle = LAST real user message (matches the "最近输入" label).
+        displayTitle: summary.lastRealUserMessage || undefined,
+        // codex has no compact-summary concept, so recap is never faked.
+        recap: undefined,
+        usage: summary.usage,
+    };
+}
 /**
  * Check if a session is still active (recently updated).
  *

package/dist/session/codex/sessions.d.ts

@@ -1,4 +1,4 @@
-import type { AgentSession, SessionContent, AgentSessionReader } from '../../runner/index.js';
+import type { AgentSession, SessionContent, SessionSummary, AgentSessionReader } from '../../runner/index.js';
 interface CodexSessionReaderOptions {
     codexHome?: string;
 }
@@ -16,6 +16,7 @@ export declare class CodexSessionReader implements AgentSessionReader {
     readSessionContent(sessionId: string, cwd: string, opts?: {
         maxEvents?: number;
     }): SessionContent;
+    readSessionSummary(sessionId: string, cwd: string): SessionSummary;
     isSessionActive(sessionId: string, cwd: string): boolean;
 }
 export {};

package/dist/session/codex/sessions.js

@@ -1,5 +1,5 @@
 import { resolveCodexHome } from '../../config/codex-config.js';
-import { listCodexRollouts, readCodexSessionContent, isCodexSessionActive, } from './rollout-reader.js';
+import { listCodexRollouts, readCodexSessionContent, readCodexSessionSummary, isCodexSessionActive, } from './rollout-reader.js';
 export class CodexSessionReader {
     codexHome;
     constructor(opts = {}) {
@@ -34,6 +34,9 @@ export class CodexSessionReader {
             cwd,
         });
     }
+    readSessionSummary(sessionId, cwd) {
+        return readCodexSessionSummary(sessionId, { codexHome: this.codexHome, cwd });
+    }
     isSessionActive(sessionId, cwd) {
         return isCodexSessionActive(sessionId, { codexHome: this.codexHome, cwd });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lark-remote",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "Feishu (Lark) private-chat bridge to local coding agents — Claude Code / Codex / opencode / pi / kimi, with live-streaming CardKit 2.0 cards",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",