lark-remote 0.5.13 → 0.5.14

package/dist/session/codex/sessions.js

@@ -1,4 +1,6 @@
 import { resolveCodexHome } from '../../config/codex-config.js';
+import { DEFAULT_LIST_LIMIT } from '../common/pagination.js';
+import { newestOf } from '../common/recency.js';
 import { listCodexRollouts, readCodexSessionContent, readCodexSessionSummary, isCodexSessionActive, } from './rollout-reader.js';
 export class CodexSessionReader {
     codexHome;
@@ -9,7 +11,7 @@ export class CodexSessionReader {
         const result = listCodexRollouts({
             codexHome: this.codexHome,
             cwd,
-            limit: opts?.limit ?? 20,
+            limit: opts?.limit ?? DEFAULT_LIST_LIMIT,
             offset: opts?.offset,
         });
         return {
@@ -25,7 +27,7 @@ export class CodexSessionReader {
         };
     }
     getNewestSession(cwd) {
-        return this.listSessions(cwd, { limit: 1 }).sessions[0] ?? null;
+        return newestOf(this, cwd);
     }
     readSessionContent(sessionId, cwd, opts) {
         return readCodexSessionContent(sessionId, {

package/dist/session/common/jsonl.js

@@ -1,4 +1,5 @@
 import fs from 'node:fs';
+import { getLogger } from '../../logger/index.js';
 /**
  * Stream a JSONL file line-by-line using chunked reads.
  *
@@ -55,7 +56,12 @@ function forEachJsonlLineCore(filePath, opts) {
     try {
         fd = fs.openSync(filePath, 'r');
     }
-    catch {
+    catch (err) {
+        // ENOENT 是正常空态（陈旧 cwd / 会话已被清理）；其余（EACCES/EBUSY…）
+        // 必须留痕：否则「文件打不开」在 /resume 上与「没有会话」不可区分。
+        if (err.code !== 'ENOENT') {
+            getLogger().warn(`[jsonl] cannot open ${filePath}: ${err?.message ?? String(err)}`);
+        }
         return false;
     }
     const CHUNK_SIZE = 65536;

package/dist/session/common/pagination.d.ts

@@ -7,6 +7,8 @@
  * drifted on the default limit). Centralized here so the contract is defined
  * once: default page limit is 20, matching the majority of readers.
  */
+/** Default page size for listSessions. */
+export declare const DEFAULT_LIST_LIMIT = 20;
 /**
  * Paginate a (already-ordered) full item list by offset + limit.
  * Clamps negative offset to 0; caps limit to the remaining items.

package/dist/session/common/pagination.js

@@ -8,7 +8,7 @@
  * once: default page limit is 20, matching the majority of readers.
  */
 /** Default page size for listSessions. */
-const DEFAULT_LIST_LIMIT = 20;
+export const DEFAULT_LIST_LIMIT = 20;
 /**
  * Paginate a (already-ordered) full item list by offset + limit.
  * Clamps negative offset to 0; caps limit to the remaining items.

package/dist/session/common/recency.d.ts

@@ -3,5 +3,11 @@
  * with a deterministic id tie-break so index rebuilds / walk-order changes
  * never reorder a page (codex red line: never break out of a partial order).
  */
+import type { AgentSessionReader } from '../../session-contract.js';
 /** 「时间降序 + id 字典序 tie-break」原地排序（原先 6 处内联拷贝）。 */
 export declare function sortByRecencyDesc<T>(items: T[], time: (item: T) => number, id: (item: T) => string): void;
+/**
+ * 列表首项 = 最新会话（`getNewestSession` 的唯一实现，此前 5 个 reader 逐字各抄一遍）。
+ * 「newest first」是 `AgentSessionReader.listSessions` 的契约，这里只取第一页第一条。
+ */
+export declare function newestOf(reader: Pick<AgentSessionReader, 'listSessions'>, cwd: string): import("../../session-contract.js").AgentSession;

package/dist/session/common/recency.js

@@ -1,10 +1,12 @@
-/**
- * Session-list ordering invariant shared by every reader: newest first,
- * with a deterministic id tie-break so index rebuilds / walk-order changes
- * never reorder a page (codex red line: never break out of a partial order).
- */
 /** 「时间降序 + id 字典序 tie-break」原地排序（原先 6 处内联拷贝）。 */
 export function sortByRecencyDesc(items, time, id) {
     items.sort((a, b) => time(b) - time(a) || id(a).localeCompare(id(b)));
 }
+/**
+ * 列表首项 = 最新会话（`getNewestSession` 的唯一实现，此前 5 个 reader 逐字各抄一遍）。
+ * 「newest first」是 `AgentSessionReader.listSessions` 的契约，这里只取第一页第一条。
+ */
+export function newestOf(reader, cwd) {
+    return reader.listSessions(cwd, { limit: 1 }).sessions[0] ?? null;
+}
 //# sourceMappingURL=recency.js.map

package/dist/session/common/two-pass.d.ts

@@ -1,4 +1,4 @@
-import type { AgentSessionContentEvent } from '../../runner/types.js';
+import type { AgentSessionContentEvent } from '../../session-contract.js';
 /**
  * Byte offset where the tail begins: the start of the line AFTER `line`.
  * `offset` is the byte offset of `line` itself; +1 accounts for the trailing

package/dist/session/common/usage-accumulator.d.ts

@@ -77,5 +77,5 @@ export declare function cumulativeUsageFields(t: {
     output: number;
     cacheRead: number;
     cacheCreation: number;
-}): Pick<import('../../runner/types.js').AgentSessionUsage, 'cumulativeTotalTokens' | 'cumulativeInputTokens' | 'cumulativeOutputTokens' | 'cumulativeCacheReadTokens' | 'cumulativeCacheCreationTokens'>;
+}): Pick<import('../../session-contract.js').AgentSessionUsage, 'cumulativeTotalTokens' | 'cumulativeInputTokens' | 'cumulativeOutputTokens' | 'cumulativeCacheReadTokens' | 'cumulativeCacheCreationTokens'>;
 export {};

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

@@ -13,7 +13,7 @@
  *   session-wide usage accumulation (assistant/message.usage)；本 run 的 flow
  *   字段 = 末个 turn（turn/start–turn/end）内所有采样之和，与 codex 同口径。
  */
-import type { AgentSession, AgentSessionReader, SessionContent } from '../../runner/index.js';
+import type { AgentSession, AgentSessionReader, SessionContent } from '../../session-contract.js';
 interface DshSessionReaderOptions {
     host?: string;
     /** Configured DSH home; selects `.credentials.yaml` when credentialsFile is unset. */

package/dist/session/dsh/sessions.js

@@ -15,13 +15,13 @@
  */
 import { spawnProcessSync } from '../../platform/spawn.js';
 import { cumulativeUsageFields } from '../common/usage-accumulator.js';
-import { sortByRecencyDesc } from '../common/recency.js';
+import { newestOf, sortByRecencyDesc } from '../common/recency.js';
 import { getLogger } from '../../logger/index.js';
 import { DEFAULT_DSH_HOST } from '../../config/index.js';
 import { samePath } from '../../platform/path.js';
 import { isWin32 } from '../../platform/select.js';
-import { dshArgs, extractDshToken } from '../../runner/dsh/client.js';
-import { DSH_COOKIE_LIFETIME_MS, isDshCredentialsNotFound, mintDshBrowserCookie, readDshBrowserSecretSync, resolveDshCredentialsFile, } from '../../runner/dsh/auth.js';
+import { dshArgs, extractDshToken } from '../../dsh/protocol.js';
+import { DSH_COOKIE_LIFETIME_MS, isDshCredentialsNotFound, mintDshBrowserCookie, readDshBrowserSecretSync, resolveDshCredentialsFile, } from '../../dsh/auth.js';
 import { capEvents, paginate } from '../common/pagination.js';
 import { truncateUtf8, TOOL_RESULT_MAX_BYTES } from '../../common/truncate.js';
 import { summarizeToolInput } from '../../common/tool-summary.js';
@@ -50,13 +50,23 @@ function defaultSyncRequest(baseUrl, method, payload, cookie) {
         ...(cookie ? ['-H', `Cookie: ${cookie}`] : []),
         '--data',
         body,
+        // 末尾追加 HTTP 状态码：401/403 要与「偶发失败」区分（cookie 失效才值得重试）。
+        '--write-out',
+        '\n%{http_code}',
     ], { encoding: 'utf-8', timeout: 15_000, maxBuffer: 64 * 1024 * 1024 });
     if (res.error || res.status !== 0) {
         throw new Error(`DSH ${method} failed: ${(res.error?.message ?? res.stderr) || 'unknown'}`);
     }
+    const raw = String(res.stdout);
+    const statusMatch = /\n(\d{3})$/.exec(raw);
+    const httpStatus = statusMatch ? Number(statusMatch[1]) : undefined;
+    const bodyText = statusMatch ? raw.slice(0, statusMatch.index) : raw;
+    if (httpStatus === 401 || httpStatus === 403) {
+        throw new Error(`DSH ${method} unauthorized (HTTP ${httpStatus})`);
+    }
     let parsed;
     try {
-        parsed = JSON.parse(String(res.stdout));
+        parsed = JSON.parse(bodyText);
     }
     catch (err) {
         throw new Error(`DSH ${method} returned non-JSON: ${err.message}`, {
@@ -82,6 +92,11 @@ function defaultSyncConnect(baseUrl, token) {
         throw new Error('DSH auth failed: index handshake did not return a cookie');
     return cookie;
 }
+/** Cookie 失效的判定：HTTP 401/403 或服务端回报 unauthorized/forbidden。 */
+function isAuthFailure(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return /\b401\b|\b403\b|unauthori[sz]ed|forbidden|invalid[ -]?cookie/i.test(msg);
+}
 export class DshSessionReader {
     hostProvider;
     dshHomeProvider;
@@ -121,11 +136,23 @@ export class DshSessionReader {
         try {
             return this.syncRequest(baseUrl, method, payload, this.resolveCookie());
         }
-        catch {
-            // DSH may have restarted while lark-remote cached a token-derived cookie.
-            // Re-read the credentials file and retry once with a fresh cookie.
+        catch (first) {
+            // 只有 cookie 失效值得清缓存重试。404/500/timeout 重试会让 /resume 延迟
+            // 翻倍，且第二次错误会盖掉真正的根因。
+            if (!isAuthFailure(first))
+                throw first;
+            getLogger().warn(`[dsh-session-reader] ${method} auth failed, refreshing cookie and retrying: ${first?.message ?? String(first)}`);
             this.cookieCache.clear();
-            return this.syncRequest(baseUrl, method, payload, this.resolveCookie());
+            try {
+                return this.syncRequest(baseUrl, method, payload, this.resolveCookie());
+            }
+            catch (second) {
+                // 重试仍失败：首错（cookie 失效）才是根因。`cause` 必须是本次捕获的 err
+                // （lint preserve-caught-error），所以根因写进 message 一并留痕。
+                const firstMsg = first?.message ?? String(first);
+                const secondMsg = second?.message ?? String(second);
+                throw new Error(`DSH ${method} failed after cookie refresh: ${secondMsg} (root cause: ${firstMsg})`, { cause: second });
+            }
         }
     }
     /** Mint from the durable secret, or bootstrap and cache a token cookie. */
@@ -186,7 +213,7 @@ export class DshSessionReader {
         }
     }
     getNewestSession(cwd) {
-        return this.listSessions(cwd, { limit: 1 }).sessions[0] ?? null;
+        return newestOf(this, cwd);
     }
     readSessionContent(sessionId, cwd, opts) {
         try {
@@ -354,9 +381,7 @@ export class DshSessionReader {
         const projection = this.unary('session/projections', { sessionId });
         if (typeof projection?.asOfSeq === 'number')
             return projection.asOfSeq;
-        const row = known ??
-            this.unary('session/list', {}).items?.find((item) => String(item.sessionId) === sessionId);
-        return typeof row?.projections?.asOfSeq === 'number' ? row.projections.asOfSeq : -1;
+        return typeof known.projections?.asOfSeq === 'number' ? known.projections.asOfSeq : -1;
     }
 }
 /** Preset moved from the summary top level to projections in DSH 0.2.x. */

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

@@ -1,4 +1,4 @@
-import type { AgentSession, AgentSessionReader, SessionContent } from '../../runner/index.js';
+import type { AgentSession, AgentSessionReader, SessionContent } from '../../session-contract.js';
 export interface KimiSessionState {
     version?: number;
     createdAt: string | number;

package/dist/session/kimi/sessions.js

@@ -5,9 +5,9 @@ import { readJsonlLines as readJsonlLinesShared, readLastNJsonlLines } from '../
 import { UsageAccumulator, cumulativeUsageFields } from '../common/usage-accumulator.js';
 import { getLogger } from '../../logger/index.js';
 import { isStale } from '../common/constants.js';
-import { samePath } from '../../platform/path.js';
+import { safeRealpath, samePath } from '../../platform/path.js';
 import { capEvents, paginate } from '../common/pagination.js';
-import { sortByRecencyDesc } from '../common/recency.js';
+import { newestOf, sortByRecencyDesc } from '../common/recency.js';
 import { TtlCache } from '../../common/ttl-cache.js';
 import { truncateUtf8, TOOL_RESULT_MAX_BYTES } from '../../common/truncate.js';
 import { truncateToolInput } from '../common/content-blocks.js';
@@ -88,7 +88,12 @@ function readJsonlLines(filePath) {
         jsonlCache.set(filePath, { mtime, lines });
         return lines;
     }
-    catch {
+    catch (err) {
+        // ENOENT = 会话文件在扫描间隙被清理（正常）；其余 errno 留痕，否则该会话
+        // 静默从 /resume 消失。
+        if (err.code !== 'ENOENT') {
+            getLogger().warn(`[kimi-session-reader] cannot read ${filePath}: ${err?.message ?? String(err)}`);
+        }
         return [];
     }
 }
@@ -201,7 +206,13 @@ export class KimiSessionReader {
      */
     listSessions(cwd, opts) {
         try {
-            const realCwd = fs.realpathSync(cwd);
+            // 归一失败（陈旧/无权限 cwd）回退原样输入，让逐条 samePath 比较去决定
+            // 空态——一次 realpathSync 抛错不得把整张列表清掉（与 opencode 同口径）。
+            const realCwd = safeRealpath(cwd, (err) => {
+                if (err.code === 'ENOENT')
+                    return;
+                getLogger().debug(`[kimi-session-reader] realpath ${cwd} failed, using the path as given: ${err?.message ?? String(err)}`);
+            });
             const sessions = [];
             for (const entry of this.scanSessionIndex()) {
                 // state.json 一次读取共用（cwd 兜底 + summary），I/O 减半。
@@ -258,7 +269,16 @@ export class KimiSessionReader {
                     mtimeMs = fs.statSync(wirePath).mtimeMs;
                 }
                 catch {
-                    mtimeMs = fs.statSync(entry.sessionDir).mtimeMs;
+                    try {
+                        mtimeMs = fs.statSync(entry.sessionDir).mtimeMs;
+                    }
+                    catch (err) {
+                        if (err.code !== 'ENOENT') {
+                            getLogger().warn(`[kimi-session-reader] cannot stat ${entry.sessionDir}: ${err?.message ?? String(err)}`);
+                        }
+                        // 会话目录已不存在（或被清理）：跳过该条，别让它拖垮整张列表。
+                        continue;
+                    }
                 }
                 sessions.push({
                     sessionId: entry.sessionId,
@@ -276,15 +296,22 @@ export class KimiSessionReader {
             };
         }
         catch (error) {
-            getLogger().error(`[kimi-session-reader] listSessions error: ${error}`);
-            return { sessions: [], total: 0 };
+            // ENOENT（cwd 已删除）：陈旧 cwd 保持优雅空态。
+            // 其余失败：error 日志 + 上抛，router 显示「列表失败」——静默 [] 会让
+            // 用户误以为没有 session，与真空不可区分（与 opencode 同口径）。
+            if (error.code === 'ENOENT') {
+                return { sessions: [], total: 0 };
+            }
+            getLogger().error(`[kimi-session-reader] listSessions failed: ${error}`);
+            const msg = error instanceof Error ? error.message : String(error);
+            throw new Error(`kimi session list 读取失败: ${msg}`, { cause: error });
         }
     }
     /**
      * Get the newest session for a given working directory
      */
     getNewestSession(cwd) {
-        return this.listSessions(cwd, { limit: 1 }).sessions[0] ?? null;
+        return newestOf(this, cwd);
     }
     /**
      * Read session content (events + usage)

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

@@ -15,7 +15,7 @@
  * - isSessionActive: use `updated` timestamp with 1 hour stale window.
  * - Simple memory cache with TTL.
  */
-import type { AgentSession, AgentSessionReader, SessionContent } from '../../runner/index.js';
+import type { AgentSession, AgentSessionReader, SessionContent } from '../../session-contract.js';
 interface OpencodeSessionReaderOptions {
     /** Path to the opencode binary. Defaults to `opencode`. */
     binary?: string;

package/dist/session/opencode/sessions.js

@@ -22,9 +22,9 @@ import os from 'node:os';
 import path from 'node:path';
 import { truncateUtf8, TOOL_RESULT_MAX_BYTES } from '../../common/truncate.js';
 import { isStale } from '../common/constants.js';
-import { samePath } from '../../platform/path.js';
+import { safeRealpath, samePath } from '../../platform/path.js';
 import { paginate, capEvents } from '../common/pagination.js';
-import { sortByRecencyDesc } from '../common/recency.js';
+import { newestOf, sortByRecencyDesc } from '../common/recency.js';
 import { TtlCache } from '../../common/ttl-cache.js';
 import { getLogger } from '../../logger/index.js';
 /** v2 CLI defaults `session list` to 100 entries; keep the reader's historical
@@ -81,6 +81,35 @@ function v2ToolOutput(state) {
         return state.result;
     return undefined;
 }
+/**
+ * 把会话级累计 token 落到 usage 上（v1 export 与 v2 export 两条读取路径共用）。
+ *
+ * 已有 usage 就地补累计字段；没有 usage 但累计非零（例如只有 cache 计数）时，
+ * 构造一条只带累计的，避免"会话有消耗却显示无 usage"。
+ */
+function withCumulativeUsage(usage, cum) {
+    if (usage) {
+        usage.cumulativeTotalTokens = cum.total;
+        usage.cumulativeInputTokens = cum.input;
+        usage.cumulativeOutputTokens = cum.output;
+        usage.cumulativeCacheReadTokens = cum.cacheRead;
+        usage.cumulativeCacheCreationTokens = cum.cacheWrite;
+        return usage;
+    }
+    if (!(cum.input || cum.output || cum.total || cum.cacheRead || cum.cacheWrite)) {
+        return undefined;
+    }
+    return {
+        inputTokens: 0,
+        outputTokens: 0,
+        contextLength: 0,
+        cumulativeTotalTokens: cum.total,
+        cumulativeInputTokens: cum.input,
+        cumulativeOutputTokens: cum.output,
+        cumulativeCacheReadTokens: cum.cacheRead,
+        cumulativeCacheCreationTokens: cum.cacheWrite,
+    };
+}
 export class OpencodeSessionReader {
     binary;
     cacheTtlMs;
@@ -124,7 +153,7 @@ export class OpencodeSessionReader {
      * Get the newest session in a given cwd.
      */
     getNewestSession(cwd) {
-        return this.listSessions(cwd, { limit: 1 }).sessions[0] ?? null;
+        return newestOf(this, cwd);
     }
     /**
      * Read session content: extract catch-up tail (last user message + everything after).
@@ -283,25 +312,13 @@ export class OpencodeSessionReader {
                     }
                 }
             }
-            if (usage) {
-                usage.cumulativeTotalTokens = cumTotal;
-                usage.cumulativeInputTokens = cumInput;
-                usage.cumulativeOutputTokens = cumOutput;
-                usage.cumulativeCacheReadTokens = cumCacheRead;
-                usage.cumulativeCacheCreationTokens = cumCacheWrite;
-            }
-            else if (cumInput || cumOutput || cumTotal || cumCacheRead || cumCacheWrite) {
-                usage = {
-                    inputTokens: 0,
-                    outputTokens: 0,
-                    contextLength: 0,
-                    cumulativeTotalTokens: cumTotal,
-                    cumulativeInputTokens: cumInput,
-                    cumulativeOutputTokens: cumOutput,
-                    cumulativeCacheReadTokens: cumCacheRead,
-                    cumulativeCacheCreationTokens: cumCacheWrite,
-                };
-            }
+            usage = withCumulativeUsage(usage, {
+                total: cumTotal,
+                input: cumInput,
+                output: cumOutput,
+                cacheRead: cumCacheRead,
+                cacheWrite: cumCacheWrite,
+            });
             // Use info.title as aiTitle
             if (data.info.title) {
                 aiTitle = data.info.title;
@@ -470,25 +487,13 @@ export class OpencodeSessionReader {
                 };
             }
         }
-        if (latest) {
-            latest.cumulativeTotalTokens = cumTotal;
-            latest.cumulativeInputTokens = cumInput;
-            latest.cumulativeOutputTokens = cumOutput;
-            latest.cumulativeCacheReadTokens = cumCacheRead;
-            latest.cumulativeCacheCreationTokens = cumCacheWrite;
-        }
-        else if (cumInput || cumOutput || cumTotal || cumCacheRead || cumCacheWrite) {
-            latest = {
-                inputTokens: 0,
-                outputTokens: 0,
-                contextLength: 0,
-                cumulativeTotalTokens: cumTotal,
-                cumulativeInputTokens: cumInput,
-                cumulativeOutputTokens: cumOutput,
-                cumulativeCacheReadTokens: cumCacheRead,
-                cumulativeCacheCreationTokens: cumCacheWrite,
-            };
-        }
+        latest = withCumulativeUsage(latest, {
+            total: cumTotal,
+            input: cumInput,
+            output: cumOutput,
+            cacheRead: cumCacheRead,
+            cacheWrite: cumCacheWrite,
+        });
         return {
             events: capEvents(events, opts?.maxEvents),
             usage: latest,
@@ -518,12 +523,11 @@ export class OpencodeSessionReader {
     // --- Private helpers ---
     /** realpath 归一化（public：测试直接调用，替代 as unknown as）。 */
     realpath(cwd) {
-        try {
-            return fs.realpathSync(cwd);
-        }
-        catch {
-            return cwd;
-        }
+        return safeRealpath(cwd, (err) => {
+            if (err.code === 'ENOENT')
+                return;
+            getLogger().debug(`[opencode-session-reader] realpath ${cwd} failed, using the path as given: ${err?.message ?? String(err)}`);
+        });
     }
     fetchSessionList(cwd) {
         const realCwd = this.realpath(cwd);

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

@@ -1,5 +1,5 @@
 import { type ContentBlockMapping } from '../common/content-blocks.js';
-import type { AgentSession, AgentSessionReader, SessionContent } from '../../runner/index.js';
+import type { AgentSession, AgentSessionReader, SessionContent } from '../../session-contract.js';
 /** Pi-specific field-name mapping for content block extraction. */
 export declare const PI_MAPPING: ContentBlockMapping;
 /**

package/dist/session/pi/sessions.js

@@ -8,7 +8,7 @@ import { UsageAccumulator, contextWindowOccupancy, cumulativeUsageFields, } from
 import { isStale } from '../common/constants.js';
 import { encodeProjectDirName, samePath } from '../../platform/path.js';
 import { paginate } from '../common/pagination.js';
-import { sortByRecencyDesc } from '../common/recency.js';
+import { newestOf, sortByRecencyDesc } from '../common/recency.js';
 import { TtlCache } from '../../common/ttl-cache.js';
 import { getLogger } from '../../logger/index.js';
 function defaultPiDir() {
@@ -135,8 +135,11 @@ function findSessionFile(sessionId, cwd, sessionsDir) {
             }
         }
     }
-    catch {
-        // dir doesn't exist
+    catch (err) {
+        // dir 不存在（陈旧 cwd / 该 cwd 从没有会话）是正常空态；其余留痕。
+        if (err.code !== 'ENOENT') {
+            getLogger().debug(`[pi-session-reader] cannot read ${dir}: ${err?.message ?? String(err)}`);
+        }
     }
     return null;
 }
@@ -282,7 +285,7 @@ export class PiSessionReader {
         };
     }
     getNewestSession(cwd) {
-        return this.listSessions(cwd, { limit: 1 }).sessions[0] ?? null;
+        return newestOf(this, cwd);
     }
     readSessionContent(sessionId, cwd, opts) {
         let filePath = null;
@@ -319,7 +322,10 @@ export class PiSessionReader {
             const st = fs.statSync(filePath);
             return !isStale(st.mtimeMs);
         }
-        catch {
+        catch (err) {
+            if (err.code !== 'ENOENT') {
+                getLogger().debug(`[pi-session-reader] stat ${filePath} failed: ${err?.message ?? String(err)}`);
+            }
             return false;
         }
     }
@@ -335,8 +341,15 @@ export class PiSessionReader {
         try {
             files = fs.readdirSync(dir).filter((f) => f.endsWith('.jsonl'));
         }
-        catch {
-            return [];
+        catch (err) {
+            // ENOENT：该 cwd 还没有会话目录（正常空态）。其余失败上抛，由 router
+            // 显示「列表失败」——静默 [] 与真空不可区分（与 opencode 同口径）。
+            if (err.code === 'ENOENT') {
+                return [];
+            }
+            getLogger().error(`[pi-session-reader] listSessions failed: ${err}`);
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`pi session list 读取失败: ${msg}`, { cause: err });
         }
         const sessions = [];
         for (const f of files) {

package/dist/session/registry.d.ts

@@ -1,4 +1,5 @@
-import type { AgentKind, AgentSessionReader } from '../runner/index.js';
+import type { AgentKind } from '../agent-kinds.js';
+import type { AgentSessionReader } from '../session-contract.js';
 /**
  * Registry of `AgentSessionReader` instances, keyed by `AgentKind`. Mirrors
  * `AgentRegistry` but for session-history reads. `index.ts` registers one

package/dist/session/session-store.d.ts

@@ -1,4 +1,4 @@
-import type { AgentKind } from '../runner/index.js';
+import type { AgentKind } from '../agent-kinds.js';
 interface SessionEntry {
     /** Session IDs per agent kind (Map for in-memory, plain object for persistence). */
     sessions: Map<AgentKind, string>;
@@ -58,7 +58,6 @@ export declare class SessionStore {
      */
     private mutateEntry;
     get(userId: string): SessionEntry | undefined;
-    set(userId: string, entry: SessionEntry): void;
     delete(userId: string): void;
     /** Clear sessionId for a specific agent, keeping cwd and other agent sessions */
     clearSessionId(userId: string, agent?: AgentKind, opts?: {

package/dist/session/session-store.js

@@ -85,10 +85,6 @@ export class SessionStore {
     get(userId) {
         return this.sessions.get(userId);
     }
-    set(userId, entry) {
-        this.sessions.set(userId, entry);
-        this.autoPersist();
-    }
     delete(userId) {
         this.sessions.delete(userId);
         this.autoPersist();
@@ -170,7 +166,7 @@ export class SessionStore {
     /** Get sessionId for a specific agent, or undefined if no session or sessionId is empty */
     getSessionId(userId, agent = 'claude') {
         const entry = this.sessions.get(userId);
-        if (!entry || !entry.sessions)
+        if (!entry)
             return undefined;
         const sessionId = entry.sessions.get(agent);
         if (!sessionId)
@@ -284,8 +280,19 @@ export class SessionStore {
                 }
             }
         }
-        catch {
-            getLogger().warn('[session] persisted session store corrupted, ignoring');
+        catch (err) {
+            getLogger().warn(`[session] persisted session store corrupted (${this.persistPath ?? '(memory)'}), ignoring:`, err);
+            // 改名保留现场：原文件继续原地躺着会让下次启动重复告警，也丢掉排障证据。
+            if (this.persistPath) {
+                const brokenPath = `${this.persistPath}.corrupt-${Date.now()}`;
+                try {
+                    fs.renameSync(this.persistPath, brokenPath);
+                    getLogger().warn(`[session] moved corrupt store to ${brokenPath}`);
+                }
+                catch (renameErr) {
+                    getLogger().warn('[session] failed to preserve corrupt store:', renameErr);
+                }
+            }
         }
     }
     autoPersist() {