lark-remote 0.4.5 → 0.5.0

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,

package/dist/session/pi/sessions.js

@@ -6,7 +6,7 @@ import { scanJsonlOnce, tailOffsetAfter, scanTailEvents } from '../common/two-pa
 import { extractContentBlocks } from '../common/content-blocks.js';
 import { UsageAccumulator, contextWindowOccupancy, cumulativeUsageFields, } from '../common/usage-accumulator.js';
 import { isStale } from '../common/constants.js';
-import { encodeProjectDirName } from '../../platform/path.js';
+import { encodeProjectDirName, samePath } from '../../platform/path.js';
 import { paginate } from '../common/pagination.js';
 import { sortByRecencyDesc } from '../common/recency.js';
 import { TtlCache } from '../../common/ttl-cache.js';
@@ -26,7 +26,7 @@ function projectDirForCwd(cwd, sessionsDir) {
     return path.join(sessionsDir, encoded);
 }
 /**
- * P1-19: TTL cache for pi directory scans (mirror codex getSessionIndex's
+ * TTL cache for pi directory scans (mirror codex getSessionIndex's
  * 5s TTL). Repeated /resume pages re-scan the whole sessions dir per call.
  */
 const piListCache = new TtlCache(5_000, 32);
@@ -71,7 +71,7 @@ function compressSkillInjection(text) {
 }
 /** Get a one-line summary from a pi session JSONL (first user message text).
  *
- * P2-3 optimization: previously used `readJsonlLines` (full-file slurp)
+ * optimization: previously used `readJsonlLines` (full-file slurp)
  * just to get the first user message. Now uses `findJsonlLine` which
  * stops reading as soon as the predicate matches — typically only the
  * first few lines of the file, saving ~99% I/O on large sessions.
@@ -136,14 +136,14 @@ function findSessionFile(sessionId, cwd, sessionsDir) {
     return null;
 }
 /**
- * P2-6 + 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, displayTitle).
  * Does NOT retain parsed objects — the events tail is re-parsed separately
  * by `extractPiEventsFromTail` so memory for both raw line strings and
  * parsed objects is O(tail), not O(whole file).
  *
- * Mirrors claude's scalarScan (P2-2 + P2-5). Preserves the skill-signature
+ * Mirrors claude's scalarScan. Preserves the skill-signature
  * compression (`<skill>…</skill>` → `skill:x`) for displayTitle and the
  * "last turn" semantics for usage tokens.
  */
@@ -198,7 +198,7 @@ function piScalarScan(filePath) {
  * Build the AgentSessionUsage from an accumulator, preserving pi's
  * "last turn" semantics: inputTokens/outputTokens use the LAST turn's
  * values, contextLength = last turn's context-window occupancy
- * (input + cacheRead + cacheCreation, excludes output — review P2-8 unified
+ * (input + cacheRead + cacheCreation, excludes output —unified
  * contract across all five readers), cumulative = session-wide sum.
  * Returns undefined when no usage data was observed.
  */
@@ -221,10 +221,10 @@ function buildPiUsage(acc) {
     };
 }
 /**
- * P2-6 + 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) — P2-6 + P2-5.
+ * parsed-object memory are O(tail), not O(whole file) —.
  * `maxEvents` capping is applied by scanTailEvents.
  */
 function mapPiTailLine(rawObj) {
@@ -285,12 +285,13 @@ export class PiSessionReader {
         if (!filePath) {
             return { events: [] };
         }
-        // Verify cwd matches
+        // Verify cwd matches（PathKit.samePath：win32/darwin 大小写与分隔符不敏感，
+        // JSONL 里的 cwd 形态由写方决定，与请求 cwd 不保证逐字符一致）
         const fileCwd = readCwdFromPiJsonl(filePath);
-        if (fileCwd && fileCwd !== cwd) {
+        if (fileCwd && !samePath(fileCwd, cwd)) {
             return { events: [] };
         }
-        // P2-5 + P2-6: Two-pass scan (see `scanJsonlOnce` / `scanTailEvents` in
+        // Two-pass scan (see `scanJsonlOnce` / `scanTailEvents` in
         // session/common/two-pass.ts): pass 1 streams the file once collecting
         // scalars (usage, tailOffset, displayTitle) with O(1) parsed-object
         // retention; pass 2 re-reads ONLY the tail and re-parses it for events,
@@ -338,7 +339,7 @@ export class PiSessionReader {
             try {
                 const st = fs.statSync(full);
                 const fileCwd = readCwdFromPiJsonl(full);
-                if (fileCwd && fileCwd !== cwd)
+                if (fileCwd && !samePath(fileCwd, cwd))
                     continue;
                 // Extract sessionId (UUID) from filename: <timestamp>_<uuid>.jsonl
                 // The timestamp and uuid are separated by '_', and neither contains '_'

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

@@ -23,7 +23,7 @@ interface SessionEntry {
  * - Atomic write (temp + rename) to avoid truncated files on crash
  * - Corrupt files are treated as empty (with a warning)
  *
- * P3.3: sessions is Map<AgentKind, sessionId> (one session per agent), allowing
+ * 3: sessions is Map<AgentKind, sessionId> (one session per agent), allowing
  * each agent to maintain its own session context when switching between agents.
  */
 export declare class SessionStore {

package/dist/session/session-store.js

@@ -13,7 +13,7 @@ import { atomicWriteJson } from '../persistence/atomic-write.js';
  * - Atomic write (temp + rename) to avoid truncated files on crash
  * - Corrupt files are treated as empty (with a warning)
  *
- * P3.3: sessions is Map<AgentKind, sessionId> (one session per agent), allowing
+ * 3: sessions is Map<AgentKind, sessionId> (one session per agent), allowing
  * each agent to maintain its own session context when switching between agents.
  */
 export class SessionStore {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lark-remote",
-  "version": "0.4.5",
+  "version": "0.5.0",
   "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",