lark-remote 0.4.5 → 0.5.1

package/dist/runner/types.js

@@ -4,5 +4,16 @@
  * 本文件包含所有 Agent 相关的类型定义，从 runner/index.ts 提取。
  * 所有下游模块应从本文件 import 类型，而非直接依赖实现。
  */
-export {};
+// =============================================================================
+// Multi-Agent Adapter Types
+// =============================================================================
+/**
+ * Agent 名单单源（运行时数组 + 类型同源，二者不可能漂移）。
+ *
+ * 历史上这份名单被手抄成多份（router 的 VALID_AGENTS、bridge 的 resume.compact
+ * 校验、各 agent 的 config builder…），漂移过：dsh 加入后 bridge 的
+ * resume.compact 仍只有 5 个，带 dsh 的 resume 卡片会静默退回 defaultAgent。
+ * 新增 agent 只改这里。
+ */
+export const AGENT_KINDS = ['claude', 'codex', 'opencode', 'pi', 'kimi', 'dsh'];
 //# sourceMappingURL=types.js.map

package/dist/session/claude/session-index.d.ts

@@ -5,11 +5,22 @@ export interface SessionIndexEntry {
     fingerprint: string;
     mtimeMs: number;
     summary: string;
+    /**
+     * cwd 判等键集合（PathKit.pathKey 归一形态，win32/darwin 大小写+分隔符
+     * 不敏感）：索引的 byCwd 倒排与 cwdSet.has 查询都按这个形态比对。注意与
+     * {@link parseSessionJsonl} 返回的 raw cwdSet 区分——后者保持 JSONL 原样，
+     * 归一只发生在索引边界（见 normalizeCwdSet）。
+     */
     cwdSet: Set<string>;
 }
 export interface SessionIndexOptions {
     /** Minimum interval between refresh scans (ms). Default 5000. */
     refreshIntervalMs?: number;
+    /**
+     * 平台注入（测试用）；默认当前宿主。cwd 判等键（pathKey）按它取归一口径，
+     * win32 语义（大小写 + `\`/`/` 分隔符不敏感）可在任意宿主上单测。
+     */
+    platform?: NodeJS.Platform;
 }
 /** Claude-specific field-name mapping for content block extraction. */
 export declare const CLAUDE_MAPPING: ContentBlockMapping;
@@ -57,6 +68,7 @@ export declare function buildFingerprint(filePath: string): string;
 export declare class SessionIndex {
     private readonly projectsDir;
     private readonly refreshIntervalMs;
+    private readonly platform;
     private readonly byPath;
     private readonly bySessionId;
     private readonly byCwd;

package/dist/session/claude/session-index.js

@@ -3,6 +3,8 @@ import path from 'node:path';
 import { scanJsonlLines } from '../common/jsonl.js';
 import { sortByRecencyDesc } from '../common/recency.js';
 import { extractContentBlocks } from '../common/content-blocks.js';
+import { pathKey } from '../../platform/path.js';
+import { currentPlatform } from '../../platform/select.js';
 import { getLogger } from '../../logger/index.js';
 // ─── Claude content block mapping (shared with sessions.ts) ─
 /** Claude-specific field-name mapping for content block extraction. */
@@ -115,6 +117,17 @@ export function buildFingerprint(filePath) {
     return parts.join('|');
 }
 // ─── SessionIndex ───────────────────────────────────────────
+/**
+ * raw cwd → pathKey 判等键。只允许在「解析结果进入索引」的边界调用：
+ * JSONL 里的 cwd 形态（大小写/分隔符/尾斜杠）由写方决定，与查询侧
+ * pathKey(cwd) 不保证逐字符一致（win32 尤甚），索引键控必须两侧同口径归一。
+ */
+function normalizeCwdSet(raw, platform) {
+    const out = new Set();
+    for (const cwd of raw)
+        out.add(pathKey(cwd, { platform }));
+    return out;
+}
 /**
  * In-memory session index with three query views:
  *   byPath:      path → entry
@@ -127,6 +140,7 @@ export function buildFingerprint(filePath) {
 export class SessionIndex {
     projectsDir;
     refreshIntervalMs;
+    platform;
     byPath = new Map();
     bySessionId = new Map();
     byCwd = new Map();
@@ -139,6 +153,7 @@ export class SessionIndex {
     constructor(projectsDir, opts = {}) {
         this.projectsDir = projectsDir;
         this.refreshIntervalMs = opts.refreshIntervalMs ?? 5000;
+        this.platform = opts.platform ?? currentPlatform;
     }
     /** Whether a full scan has ever completed successfully (readdir succeeded). */
     get isBuilt() {
@@ -162,7 +177,7 @@ export class SessionIndex {
     }
     // ── Query: listByCwd ────────────────────────────────────
     listByCwd(cwd, opts = {}) {
-        const paths = this.byCwd.get(cwd);
+        const paths = this.byCwd.get(pathKey(cwd, { platform: this.platform }));
         if (!paths || paths.size === 0)
             return [];
         // Gather entries, deduplicate by sessionId (keep mtime newest)
@@ -211,7 +226,7 @@ export class SessionIndex {
             }
             if (currentFp === entry.fingerprint) {
                 // Fingerprint matches → trust index
-                if (entry.cwdSet.has(cwd))
+                if (entry.cwdSet.has(pathKey(cwd, { platform: this.platform })))
                     return entry;
                 continue;
             }
@@ -226,11 +241,11 @@ export class SessionIndex {
                     fingerprint: currentFp,
                     mtimeMs: Number(st.mtimeMs),
                     summary: parsed.summary.replace(/\s+/g, ' ').trim(),
-                    cwdSet: parsed.cwdSet,
+                    cwdSet: normalizeCwdSet(parsed.cwdSet, this.platform),
                 };
                 this.updateEntry(p, updated);
                 // Re-check cwd after update
-                if (updated.cwdSet.has(cwd))
+                if (updated.cwdSet.has(pathKey(cwd, { platform: this.platform })))
                     return updated;
             }
             catch {
@@ -304,7 +319,7 @@ export class SessionIndex {
                         fingerprint: fpAfter,
                         mtimeMs: Number(fileStat.mtimeMs),
                         summary: parsed.summary.replace(/\s+/g, ' ').trim(),
-                        cwdSet: parsed.cwdSet,
+                        cwdSet: normalizeCwdSet(parsed.cwdSet, this.platform),
                     };
                     this.updateEntry(fullPath, newEntry);
                 }

package/dist/session/claude/sessions.js

@@ -30,7 +30,7 @@ function projectDirForCwd(cwd, projectsDir) {
  * to actually belong to the requested cwd. A relocated session contains
  * MULTIPLE cwd values (pre- and post-relocate) — accept when ANY `cwd` field
  * matches. Early-stops on the first match (findJsonlLine), keeping the
- * P2-2 single-pass parse-count anchors intact on the fallback path.
+ * single-pass parse-count anchors intact on the fallback path.
  * Regression 2026-08-04 EnterWorktree relocate.
  */
 function fileContainsCwd(filePath, cwd) {
@@ -109,8 +109,8 @@ function ensureSessionIndex(projectsDir) {
  * the project directory doesn't exist or no jsonl has a matching cwd field.
  */
 export function listClaudeSessions(cwd, opts = {}) {
-    // 不传 limit = 返回全集不切片；仅显式传值才 slice（契约迁移 plan §2.1，
-    // reader 拿全集算 total 后再自己按 offset/limit 切片）。
+    // 不传 limit = 返回全集不切片；仅显式传值才 slice
+    // reader 拿全集算 total 后再自己按 offset/limit 切片。
     const limit = opts.limit;
     const projectsDir = opts.projectsDir ?? defaultProjectsDir();
     const index = ensureSessionIndex(projectsDir);
@@ -218,7 +218,7 @@ export function isClaudeSessionActive(sessionId, cwd, opts = {}) {
     }
 }
 /**
- * P2-2 + P2-5 first-pass scan: stream the file once via `scanJsonlLines`
+ * first-pass scan: stream the file once via `scanJsonlLines`
  * (no `string[]` materialized), parse each line exactly once, and collect
  * all metadata needed by readSessionContent (usage, tailOffset, aiTitle,
  * recap, lastUserMessage). Does NOT retain parsed objects — the events tail
@@ -320,7 +320,7 @@ function scalarScan(filePath) {
     const l = acc.last;
     // contextLength = current context-window occupancy. Prefer compact_boundary
     // postTokens (the precise post-compact size); otherwise fall back to the
-    // last turn's input + cacheRead + cacheCreation (review P2-8 unified
+    // last turn's input + cacheRead + cacheCreation (unified
     // contract — excludes output/reasoning, which are generated, not part of
     // the input window). Take the max so a pre-compact turn larger than the
     // post-compact size is not under-reported.
@@ -353,12 +353,12 @@ function scalarScan(filePath) {
     };
 }
 /**
- * P2-2 + P2-5 second-pass tail mapper: expand one parsed tail line into
+ * second-pass tail mapper: expand one parsed tail line into
  * content-block events. Re-parses only tail lines (scanTailEvents does the
  * offset re-read + line filtering), so both raw line-string memory and
- * parsed-object memory are O(tail), not O(whole file) — P3-1 + P2-5.
+ * parsed-object memory are O(tail), not O(whole file) —.
  *
- * `maxEvents` capping (review P2-7 — unified "last N events" contract across
+ * `maxEvents` capping (unified "last N events" contract across
  * all readers) is applied by scanTailEvents.
  */
 function mapClaudeTailLine(obj) {
@@ -411,7 +411,7 @@ export function readSessionContent(sessionId, cwd, opts = {}) {
             return { events: [] };
         }
     }
-    // P2-2 + P3-1 + P2-5: First pass STREAMS the file once via
+    // First pass STREAMS the file once via
     // `scanJsonlLines` (no `string[]` materialized), parsing each line once to
     // collect scalars (usage, tailOffset, aiTitle, recap, lastUserMessage)
     // while retaining NO parsed objects and NO whole-file line array. The
@@ -425,7 +425,7 @@ export function readSessionContent(sessionId, cwd, opts = {}) {
     // full-file scan + tail re-parse of the usually-short post-user lines).
     // When the session has NO user message, tailOffset stays -1 and the tail
     // IS the whole file → scan(N) + tail(N) = 2.0× — the known asymptotic
-    // upper bound of the body's two-phase design (still better than pre-P2-2's
+    // upper bound of the body's two-phase design (still better than pre-'s
     // ~3×). Total parse count adds the index-miss fallback guard's fixed
     // early-stop overhead (~2 parses, independent of line count).
     const scan = scalarScan(filePath);

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

@@ -53,10 +53,10 @@ export declare function readCodexRollout(filePath: string): CodexRolloutEntry |
  * Returns `{ entries, total }`: `total` is the size of the full cwd-matched
  * set before pagination; `entries` are the newest `limit` entries by mtime.
  *
- * A global order over the full set is established first (plan §1.4: no early
+ * A global order over the full set is established first (no early
  * termination before ordering) using the lightweight session index — full
  * walk + first-line session_meta parse + stat mtime, 5s TTL cache. Only the
- * returned page is fully parsed for summary/usage (plan §2.2).
+ * returned page is fully parsed for summary/usage.
  */
 export declare function listCodexRollouts(opts?: ListCodexRolloutsOptions): {
     entries: CodexRolloutEntry[];
@@ -65,7 +65,7 @@ export declare function listCodexRollouts(opts?: ListCodexRolloutsOptions): {
 /**
  * Read the full content of a specific session by its threadId.
  *
- * P2-4: Uses session index for O(1) file lookup instead of walking the
+ * Uses session index for O(1) file lookup instead of walking the
  * entire directory tree and fully parsing every file. Only the matching
  * file is fully parsed.
  *
@@ -94,7 +94,7 @@ export declare function readCodexSessionSummary(sessionId: string, opts?: {
 /**
  * Check if a session is still active (recently updated).
  *
- * P2-4: Uses session index for direct file lookup, then checks mtime
+ * Uses session index for direct file lookup, then checks mtime
  * via statSync — no full rollout parse required. This reduces the
  * cost from "walk entire directory + full-parse every file" to a single
  * statSync call for the matching file.

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

@@ -148,7 +148,7 @@ function scanCodexRollout(filePath, includeEvents) {
     // token_count 增量是 input/cached/output 全 0、只有 total_tokens 有值
     // （窗口被摘要+replacement history 占据），现有 zero-filter 会跳过它，
     // 因此这里必须单独捕获，不能复用 lastRawUsage。
-    // 单位口径（review P3-9）：前后两侧统一用 total_tokens —— 压缩前取最近一次
+    // 单位口径：前后两侧统一用 total_tokens —— 压缩前取最近一次
     // 非零 token_count 的 total_tokens（input+output，即该 turn 在窗口内的全部
     // token），压缩后取收尾事件的 total_tokens（压缩后窗口）。不得一边 input
     // 一边 total，否则「压缩前 X → 压缩后 Y」两边单位不一致。
@@ -279,7 +279,7 @@ function scanCodexRollout(filePath, includeEvents) {
  * (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
+ * occupancy contract across all five readers (excludes
  * output/reasoning).
  */
 function buildUsageFromScan(scan) {
@@ -325,10 +325,10 @@ function buildUsageFromScan(scan) {
  * Returns `{ entries, total }`: `total` is the size of the full cwd-matched
  * set before pagination; `entries` are the newest `limit` entries by mtime.
  *
- * A global order over the full set is established first (plan §1.4: no early
+ * A global order over the full set is established first (no early
  * termination before ordering) using the lightweight session index — full
  * walk + first-line session_meta parse + stat mtime, 5s TTL cache. Only the
- * returned page is fully parsed for summary/usage (plan §2.2).
+ * returned page is fully parsed for summary/usage.
  */
 export function listCodexRollouts(opts = {}) {
     const codexHome = resolveCodexHome(opts.codexHome);
@@ -338,7 +338,7 @@ export function listCodexRollouts(opts = {}) {
     const matched = [];
     for (const entry of index.values()) {
         // Subagent thread rollouts are part of a thread tree, not standalone
-        // sessions: exclude them explicitly (plan §2.1) so a pure-subagent
+        // sessions: exclude them explicitly so a pure-subagent
         // session (main file missing) never pollutes the list or total.
         if (entry.isSubagent)
             continue;
@@ -361,15 +361,15 @@ export function listCodexRollouts(opts = {}) {
     return { entries, total };
 }
 /**
- * W2.6 单源：三处（readCodexSessionContent / readCodexSessionSummary /
+ * 单源：三处（readCodexSessionContent / readCodexSessionSummary /
  * isCodexSessionActive）共用的「索引查找 + miss 强制刷新重查」。
  * cwd 守卫与 subagent 过滤语义各异，留在调用方。
  */
 function resolveRolloutEntry(sessionId, codexHome) {
-    // P2-4: Use session index for direct file lookup
+    // Use session index for direct file lookup
     let index = getSessionIndex(codexHome);
     let entry = index.get(sessionId);
-    // P3-2: On miss, the index may be stale (a rollout file created after the
+    // On miss, the index may be stale (a rollout file created after the
     // cache was built but within the 5s TTL). Force a refresh and recheck so a
     // brand-new session is found without waiting for TTL expiry.
     if (!entry) {
@@ -381,7 +381,7 @@ function resolveRolloutEntry(sessionId, codexHome) {
 /**
  * Read the full content of a specific session by its threadId.
  *
- * P2-4: Uses session index for O(1) file lookup instead of walking the
+ * Uses session index for O(1) file lookup instead of walking the
  * entire directory tree and fully parsing every file. Only the matching
  * file is fully parsed.
  *
@@ -457,7 +457,7 @@ export function readCodexSessionSummary(sessionId, opts = {}) {
 /**
  * Check if a session is still active (recently updated).
  *
- * P2-4: Uses session index for direct file lookup, then checks mtime
+ * Uses session index for direct file lookup, then checks mtime
  * via statSync — no full rollout parse required. This reduces the
  * cost from "walk entire directory + full-parse every file" to a single
  * statSync call for the matching file.
@@ -467,14 +467,14 @@ export function isCodexSessionActive(sessionId, opts = {}) {
     // Unify with the other readers' 1-hour stale window (claude/pi/opencode/kimi
     // all use STALE_MS). Previously codex used a divergent 10-minute default.
     const threshold = opts.activeThresholdMs ?? STALE_MS;
-    // P2-4: Use session index for direct file lookup + mtime check
+    // Use session index for direct file lookup + mtime check
     const entry = resolveRolloutEntry(sessionId, codexHome);
     if (!entry) {
         return false;
     }
     // Subagent thread rollouts are never "active sessions": their mtime
     // reflects thread-tree activity, not the parent session's liveness
-    // (plan §2.1). A pure-subagent session must report inactive.
+    // A pure-subagent session must report inactive.
     if (entry.isSubagent) {
         return false;
     }

package/dist/session/common/two-pass.js

@@ -1,6 +1,6 @@
 /**
- * Two-pass scan skeleton shared by the claude / pi session readers (P2-2 +
- * P2-5/P2-6 lineage): pass 1 STREAMS the whole file once via `scanJsonlLines`
+ * Two-pass scan skeleton shared by the claude / pi session readers (
+ * lineage): pass 1 STREAMS the whole file once via `scanJsonlLines`
  * (no `string[]` materialized), parsing each line exactly once to collect
  * scalars (usage, tail offset, title) while retaining NO parsed objects; pass
  * 2 re-reads ONLY the tail from the recorded offset and re-parses it for

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

@@ -55,13 +55,13 @@ export declare class UsageAccumulator {
      */
     bumpCompact(): void;
 }
-/** P2-8 统一契约：上下文窗口占用 = 末轮 input + cacheRead + cacheCreation（不含 output/reasoning）。 */
+/** 统一契约：上下文窗口占用 = 末轮 input + cacheRead + cacheCreation（不含 output/reasoning）。 */
 export declare function contextWindowOccupancy(l: {
     input: number;
     cacheRead: number;
     cacheCreation: number;
 }): number;
-/** P2-8 统一契约：session 全量累计字段组装（4 个 reader 共用：claude/dsh/kimi/pi；
+/** 统一契约：session 全量累计字段组装（4 个 reader 共用：claude/dsh/kimi/pi；
  * codex 走 last_token_usage 口径、opencode 保留自己的条件赋值，原为逐字段复制的 4 连拷贝）。 */
 export declare function cumulativeUsageFields(t: {
     input: number;

package/dist/session/common/usage-accumulator.js

@@ -69,11 +69,11 @@ export class UsageAccumulator {
         this._compactCount++;
     }
 }
-/** P2-8 统一契约：上下文窗口占用 = 末轮 input + cacheRead + cacheCreation（不含 output/reasoning）。 */
+/** 统一契约：上下文窗口占用 = 末轮 input + cacheRead + cacheCreation（不含 output/reasoning）。 */
 export function contextWindowOccupancy(l) {
     return l.input + l.cacheRead + l.cacheCreation;
 }
-/** P2-8 统一契约：session 全量累计字段组装（4 个 reader 共用：claude/dsh/kimi/pi；
+/** 统一契约：session 全量累计字段组装（4 个 reader 共用：claude/dsh/kimi/pi；
  * codex 走 last_token_usage 口径、opencode 保留自己的条件赋值，原为逐字段复制的 4 连拷贝）。 */
 export function cumulativeUsageFields(t) {
     return {

package/dist/session/dsh/sessions.js

@@ -21,7 +21,7 @@ import { samePath } from '../../platform/path.js';
 import { capEvents, paginate } from '../common/pagination.js';
 import { truncateUtf8, TOOL_RESULT_MAX_BYTES } from '../../common/truncate.js';
 /**
- * CC-05: history 拉取上限。DSH session.history 的 maxMessages 同时限制返回条数，
+ * history 拉取上限。DSH session.history 的 maxMessages 同时限制返回条数，
  * 若用它同时充当展示截断，>50 事件的会话累计 usage 会少算。这里拉取一个足够大的
  * 上限保证 usage 累加覆盖整个会话；展示仍由 capEvents(opts?.maxEvents ?? 50) 截断。
  * （若 DSH 支持分页 cursor 可改成分页，当前用有界大拉取）
@@ -159,7 +159,7 @@ export class DshSessionReader {
                 };
             }
             return {
-                // CC-05: 展示仍按 maxEvents 尾截断（默认 50，保持原行为），usage 已在上面基于
+                // 展示仍按 maxEvents 尾截断（默认 50，保持原行为），usage 已在上面基于
                 // 完整 history 累加。
                 events: capEvents(events, opts?.maxEvents ?? 50),
                 ...(sessionUsage ? { usage: sessionUsage } : {}),

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

@@ -104,7 +104,7 @@ export declare class KimiSessionReader implements AgentSessionReader {
     readCompactionRecords(sessionId: string, cwd: string): KimiCompactionRecord[];
     /**
      * 由 begin/terminal 记录重建压缩状态机：最后一次 begin 无更新的 terminal
-     * 记录 = 在途（kimi-compact-wait-redesign §5.1）。崩溃墓碑由 kimi resume
+     * 记录 = 在途。崩溃墓碑由 kimi resume
      * 时补写 full_compaction.cancel，天然闭合。
      */
     readCompactionState(sessionId: string, cwd: string): {
@@ -114,7 +114,7 @@ export declare class KimiSessionReader implements AgentSessionReader {
         records: KimiCompactionRecord[];
     };
     /**
-     * W2.5 单源：resolveSessionWirePath 与 isSessionActive 共用的 cwd 守卫
+     * 单源：resolveSessionWirePath 与 isSessionActive 共用的 cwd 守卫
      * （realpathSync → state.json workDir/cwd 三态 → index workDir 兜底 →
      * fail-closed）。返回 sessionDir；会话未知或守卫不过返回 null。
      */

package/dist/session/kimi/sessions.js

@@ -78,7 +78,7 @@ function readJsonlLines(filePath) {
     try {
         const stat = fs.statSync(filePath);
         const mtime = stat.mtimeMs;
-        // P1-17: TTL 由 TtlCache 按缓存写入时间判定（不是文件 mtime），命中即 LRU 刷新；
+        // TTL 由 TtlCache 按缓存写入时间判定（不是文件 mtime），命中即 LRU 刷新；
         // mtime 变化视为失效（文件被改写后不得返回旧行）。
         const cached = jsonlCache.get(filePath);
         if (cached && mtime === cached.mtime) {
@@ -204,7 +204,7 @@ export class KimiSessionReader {
             const realCwd = fs.realpathSync(cwd);
             const sessions = [];
             for (const entry of this.scanSessionIndex()) {
-                // W2.7：state.json 一次读取共用（cwd 兜底 + summary），I/O 减半。
+                // state.json 一次读取共用（cwd 兜底 + summary），I/O 减半。
                 // 两次 catch 语义保留：解析失败 = 无法判 cwd → 跳过（continue）；
                 // 解析成功但字段缺失 = summary 落 wire.jsonl 提取。
                 const statePath = path.join(entry.sessionDir, 'state.json');
@@ -242,7 +242,7 @@ export class KimiSessionReader {
                     const wirePath = path.join(entry.sessionDir, 'agents', 'main', 'wire.jsonl');
                     summary = this.extractLastPromptFromWire(wirePath) || 'New Session';
                 }
-                // Get mtime. P1-16: the session DIRECTORY mtime only changes when
+                // Get mtime. the session DIRECTORY mtime only changes when
                 // entries are created/deleted/renamed inside it — kimi appending to
                 // agents/main/wire.jsonl during a run does NOT touch it, so dir-mtime
                 // sorting lags real activity by minutes. Use the wire.jsonl mtime
@@ -332,7 +332,7 @@ export class KimiSessionReader {
                     cacheCreation: inputCacheCreation,
                 });
                 if (updateContextLength) {
-                    // review P2-8 unified contract: input + cacheRead + cacheCreation
+                    // unified contract: input + cacheRead + cacheCreation
                     // (excludes output — generated, not part of the input window).
                     mainContextLength = inputOther + inputCacheRead + inputCacheCreation;
                 }
@@ -350,7 +350,7 @@ export class KimiSessionReader {
                     // 展示计数只计 context.apply_compaction：一次手动 /compact 会同时写
                     // full_compaction.complete + context.apply_compaction 两条（2026-08-16
                     // 实弹 wire.jsonl），双计会把一次压缩虚报成 2 次。full_compaction.complete
-                    // 仅作 R2 runCompact 轮询的完成信号（readCompactionRecords 仍返回两种）。
+                    // 仅作 runCompact 轮询的完成信号（readCompactionRecords 仍返回两种）。
                     if (isCompactionComplete(entry) && entry.type === 'context.apply_compaction') {
                         compactCount++;
                         // Capture context length before this compaction as the pre-compact
@@ -360,7 +360,7 @@ export class KimiSessionReader {
                         }
                         continue;
                     }
-                    // P2-7: displayTitle + display events now scan ALL lines (not a
+                    // displayTitle + display events now scan ALL lines (not a
                     // line-slice), then `events.slice(-maxEvents)` keeps the LAST N
                     // EVENTS. Previously `lines.slice(-maxEvents)` cut raw lines, but
                     // usage.record / step.begin / turn.prompt lines produce no display
@@ -402,7 +402,7 @@ export class KimiSessionReader {
                         }
                         else if (evt.type === 'tool.result') {
                             // result is { output }, { output, note }, or { isError, output }
-                            // 对齐 opencode reader 的 L2 预折叠：单条 tool_result 上限
+                            // 对齐 opencode reader 的预折叠：单条 tool_result 上限
                             // TOOL_RESULT_MAX_BYTES，病理级输出（如 51KB 文件读取）不会
                             // 撑爆 resume 卡，也约束 events[] 内存占用。
                             const rawOut = evt.result?.output ?? `[tool result for ${evt.toolCallId}]`;
@@ -523,7 +523,7 @@ export class KimiSessionReader {
     }
     /**
      * 由 begin/terminal 记录重建压缩状态机：最后一次 begin 无更新的 terminal
-     * 记录 = 在途（kimi-compact-wait-redesign §5.1）。崩溃墓碑由 kimi resume
+     * 记录 = 在途。崩溃墓碑由 kimi resume
      * 时补写 full_compaction.cancel，天然闭合。
      */
     readCompactionState(sessionId, cwd) {
@@ -545,7 +545,7 @@ export class KimiSessionReader {
         };
     }
     /**
-     * W2.5 单源：resolveSessionWirePath 与 isSessionActive 共用的 cwd 守卫
+     * 单源：resolveSessionWirePath 与 isSessionActive 共用的 cwd 守卫
      * （realpathSync → state.json workDir/cwd 三态 → index workDir 兜底 →
      * fail-closed）。返回 sessionDir；会话未知或守卫不过返回 null。
      */
@@ -626,7 +626,7 @@ export class KimiSessionReader {
      * Check if a session is currently active
      */
     isSessionActive(sessionId, cwd) {
-        // W2.5：cwd 守卫与 resolveSessionWirePath 共用 verifySessionCwd（单源）。
+        // cwd 守卫与 resolveSessionWirePath 共用 verifySessionCwd（单源）。
         const verified = this.verifySessionCwd(sessionId, cwd);
         if (!verified)
             return false;
@@ -644,7 +644,7 @@ export class KimiSessionReader {
             // Read the tail to check for active indicators. kimi appends
             // usage.record after step.end at turn completion, so the last loop
             // event (not the last line) decides whether the session is complete.
-            // P2-5: `lastLoopEventIsStepEnd` only scans backwards up to
+            // `lastLoopEventIsStepEnd` only scans backwards up to
             // LOOP_EVENT_SCAN_LIMIT lines, so we read only that many trailing lines
             // via the tail-only helper instead of full-slurping the whole wire log
             // (which can be multi-MB) into a string[].

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

@@ -20,7 +20,7 @@ interface OpencodeSessionReaderOptions {
     /**
      * Override the raw `opencode export <id>` capture (returns the JSON string).
      * Default routes stdout to a temp file fd to bypass opencode's ~128KB pipe
-     * truncation on large sessions (L1). Injectable for testing.
+     * truncation on large sessions. Injectable for testing.
      */
     captureExport?: (sessionId: string) => string;
 }
@@ -65,12 +65,12 @@ export declare class OpencodeSessionReader implements AgentSessionReader {
     /**
      * Capture raw `opencode export <sessionId>` output (JSON string). Injectable
      * via the constructor; the default routes stdout to a temp file fd to bypass
-     * opencode's ~128KB pipe truncation on large sessions (L1).
+     * opencode's ~128KB pipe truncation on large sessions.
      */
     /** 导出会话内容（public：测试直接调用，替代 as unknown as）。 */
     captureExport(sessionId: string): string;
     /**
-     * L1 default transport: run `opencode export` with stdout pointed at a
+     * default transport: run `opencode export` with stdout pointed at a
      * regular-file fd (NOT a pipe). opencode truncates piped stdout at ~128KB for
      * large sessions (huge tool_results), breaking JSON.parse; a file fd receives
      * the full output (verified: 1.3MB parses OK). execFileSync returns null when

package/dist/session/opencode/sessions.js

@@ -57,7 +57,7 @@ export class OpencodeSessionReader {
             sessions: items.map((e) => ({
                 sessionId: e.id,
                 // CLI title 字段形状不保证恒为 string（null/缺字段时 router 的
-                // s.summary.trim() 会 TypeError）——非 string 给空串（Review R3 P3-3）。
+                // s.summary.trim() 会 TypeError）——非 string 给空串（Review）。
                 summary: typeof e.title === 'string' ? e.title : '',
                 mtime: e.updated,
             })),
@@ -75,7 +75,7 @@ export class OpencodeSessionReader {
      */
     readSessionContent(sessionId, cwd, opts) {
         const realCwd = this.realpath(cwd);
-        // L1/L3: capture raw export via the injectable seam, then parse. Distinguish
+        // capture raw export via the injectable seam, then parse. Distinguish
         // a truly-missing session (empty capture) from a truncated/corrupt one
         // (non-empty but unparseable) so we never show the misleading "未找到" for
         // a session whose content is merely too large to pipe through stdout.
@@ -100,7 +100,9 @@ export class OpencodeSessionReader {
             return { events: [] };
         }
         try {
-            if (data.info.directory !== realCwd) {
+            // 与 listSessions 的过滤同口径（PathKit.samePath）：export 里的 directory
+            // 形态由 opencode 自行记录，裸 !== 会让会话列得出却读不出（win32 常态）
+            if (!samePath(data.info.directory, realCwd)) {
                 return { events: [] };
             }
             const events = [];
@@ -160,7 +162,7 @@ export class OpencodeSessionReader {
                             const rawOut = isError
                                 ? (part.state.error ?? part.state.output)
                                 : (part.state.output ?? '');
-                            // L2: pre-fold pathological tool_results (e.g. a 500KB file
+                            // pre-fold pathological tool_results (e.g. a 500KB file
                             // listing) via the shared truncateUtf8 primitive, reusing the
                             // same …（已截断） suffix as the live renderer / card budget.
                             events.push({
@@ -183,7 +185,7 @@ export class OpencodeSessionReader {
                         // ccusage-aligned: cache.write -> cacheCreationTokens.
                         // contextLength = input + cacheRead + cacheCreation (excludes
                         // output/reasoning) — the unified context-window occupancy
-                        // contract across all five readers (review P2-8).
+                        // contract across all five readers.
                         if ((part.tokens.total ?? 0) !== 0) {
                             usage = {
                                 inputTokens: part.tokens.input,
@@ -317,7 +319,7 @@ export class OpencodeSessionReader {
             const res = spawnProcessSync(this.binary, ['session', 'list', '--format', 'json'], {
                 encoding: 'utf-8',
                 timeout: 10000,
-                // P1-15: default maxBuffer is 1MiB — a large session list (>1MiB JSON)
+                // default maxBuffer is 1MiB — a large session list (>1MiB JSON)
                 // throws ENOBUFS, which the catch below silently turns into [] and the
                 // user sees "no sessions" even though the CLI returned healthy data.
                 maxBuffer: 64 * 1024 * 1024,
@@ -345,7 +347,7 @@ export class OpencodeSessionReader {
             return data;
         }
         catch (err) {
-            // P1-15: 区分「读取失败」与「真空/陈旧 cwd」。
+            // 区分「读取失败」与「真空/陈旧 cwd」。
             // - ENOENT（cwd 已删除或 binary 缺失）：沿用既有契约返回 []——/resume 对
             //   陈旧 cwd 保持优雅（sessions.test.ts「Stale-cwd coverage gap」+ round10
             //   探针的跨 reader 空目录不变量都钉死此行为）。
@@ -362,7 +364,7 @@ export class OpencodeSessionReader {
     /**
      * Capture raw `opencode export <sessionId>` output (JSON string). Injectable
      * via the constructor; the default routes stdout to a temp file fd to bypass
-     * opencode's ~128KB pipe truncation on large sessions (L1).
+     * opencode's ~128KB pipe truncation on large sessions.
      */
     /** 导出会话内容（public：测试直接调用，替代 as unknown as）。 */
     captureExport(sessionId) {
@@ -371,7 +373,7 @@ export class OpencodeSessionReader {
         return this.captureExportViaFileFd(sessionId);
     }
     /**
-     * L1 default transport: run `opencode export` with stdout pointed at a
+     * default transport: run `opencode export` with stdout pointed at a
      * regular-file fd (NOT a pipe). opencode truncates piped stdout at ~128KB for
      * large sessions (huge tool_results), breaking JSON.parse; a file fd receives
      * the full output (verified: 1.3MB parses OK). execFileSync returns null when
@@ -386,7 +388,7 @@ export class OpencodeSessionReader {
                 encoding: 'utf-8',
                 timeout: 30000,
                 stdio: ['ignore', fd, 'pipe'],
-                // P1-15: stderr is piped here; without maxBuffer a chatty CLI (>1MiB
+                // stderr is piped here; without maxBuffer a chatty CLI (>1MiB
                 // stderr) would throw ENOBUFS and lose the export. Keep the default
                 // stdout file-fd transport unaffected by raising the pipe cap.
                 maxBuffer: 64 * 1024 * 1024,