lark-remote 0.1.13 → 0.2.1

package/dist/session/dsh/sessions.js

@@ -12,18 +12,19 @@
  * readSessionContent: session.history → map SessionEvents to display events +
  *   session-wide usage accumulation (assistant/message.usage).
  */
-import { spawnSync } from 'node:child_process';
+import { spawnProcessSync } from '../../platform/spawn.js';
 import { cumulativeUsageFields } from '../common/usage-accumulator.js';
 import { 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 { capEvents, paginate } from '../common/pagination.js';
 import { truncateUtf8, TOOL_RESULT_MAX_BYTES } from '../../common/truncate.js';
 /**
  * CC-05: history 拉取上限。DSH session.history 的 maxMessages 同时限制返回条数，
  * 若用它同时充当展示截断，>50 事件的会话累计 usage 会少算。这里拉取一个足够大的
  * 上限保证 usage 累加覆盖整个会话；展示仍由 capEvents(opts?.maxEvents ?? 50) 截断。
- * （若 DSH 支持分页 cursor 可改成分页，当前用有界大拉取，见 review-fix-plan-cc.md）
+ * （若 DSH 支持分页 cursor 可改成分页，当前用有界大拉取）
  */
 const DSH_HISTORY_FETCH_LIMIT = 10_000;
 /** Synchronous unary POST via curl (the reader interface is synchronous). */
@@ -34,7 +35,7 @@ function defaultSyncRequest(baseUrl, method, payload) {
         method,
         payload,
     });
-    const res = spawnSync('curl', [
+    const res = spawnProcessSync('curl', [
         '-s',
         '-X',
         'POST',
@@ -49,7 +50,7 @@ function defaultSyncRequest(baseUrl, method, payload) {
     }
     let parsed;
     try {
-        parsed = JSON.parse(res.stdout);
+        parsed = JSON.parse(String(res.stdout));
     }
     catch (err) {
         throw new Error(`DSH ${method} returned non-JSON: ${err.message}`, {
@@ -82,7 +83,7 @@ export class DshSessionReader {
             const value = this.unary('session.list', {});
             const items = value.items ?? [];
             const filtered = items
-                .filter((i) => i.cwd === cwd)
+                .filter((i) => i.cwd !== undefined && samePath(i.cwd, cwd))
                 .map((i) => ({
                 sessionId: String(i.sessionId),
                 summary: '',
@@ -173,7 +174,7 @@ export class DshSessionReader {
     isSessionActive(sessionId, cwd) {
         try {
             const value = this.unary('session.list', {});
-            const found = (value.items ?? []).find((i) => String(i.sessionId) === sessionId && i.cwd === cwd);
+            const found = (value.items ?? []).find((i) => String(i.sessionId) === sessionId && i.cwd !== undefined && samePath(i.cwd, cwd));
             return found?.running === true;
         }
         catch (error) {

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

@@ -117,6 +117,12 @@ export declare class KimiSessionReader implements AgentSessionReader {
         inFlightSince?: number;
         records: KimiCompactionRecord[];
     };
+    /**
+     * W2.5 单源：resolveSessionWirePath 与 isSessionActive 共用的 cwd 守卫
+     * （realpathSync → state.json workDir/cwd 三态 → index workDir 兜底 →
+     * fail-closed）。返回 sessionDir；会话未知或守卫不过返回 null。
+     */
+    private verifySessionCwd;
     /**
      * Resolve the main wire.jsonl path for a session after passing the cwd
      * guard (state.json + session index fallback). Returns null when the

package/dist/session/kimi/sessions.js

@@ -4,7 +4,8 @@ import os from 'node:os';
 import { readJsonlLines as readJsonlLinesShared, readLastNJsonlLines } from '../common/jsonl.js';
 import { UsageAccumulator, cumulativeUsageFields } from '../common/usage-accumulator.js';
 import { getLogger } from '../../logger/index.js';
-import { STALE_MS } from '../common/constants.js';
+import { isStale } from '../common/constants.js';
+import { samePath } from '../../platform/path.js';
 import { capEvents, paginate } from '../common/pagination.js';
 import { sortByRecencyDesc } from '../common/recency.js';
 import { TtlCache } from '../../common/ttl-cache.js';
@@ -124,7 +125,7 @@ export function checkCwdGuard(state, realCwd) {
     const sessionWorkDir = extractWorkDir(state);
     if (sessionWorkDir === undefined)
         return 'unverifiable';
-    if (sessionWorkDir === realCwd)
+    if (samePath(sessionWorkDir, realCwd))
         return 'verified';
     return 'failed';
 }
@@ -209,35 +210,36 @@ export class KimiSessionReader {
             const realCwd = fs.realpathSync(cwd);
             const sessions = [];
             for (const entry of this.scanSessionIndex()) {
-                // Index workDir is v1-only; v2 sessions may have empty/missing workDir.
-                // When index workDir is absent, fall back to state.json's cwd field.
-                let entryWorkDir = entry.workDir;
-                if (!entryWorkDir) {
-                    const statePath = path.join(entry.sessionDir, 'state.json');
+                // W2.7：state.json 一次读取共用（cwd 兜底 + summary），I/O 减半。
+                // 两次 catch 语义保留：解析失败 = 无法判 cwd → 跳过（continue）；
+                // 解析成功但字段缺失 = summary 落 wire.jsonl 提取。
+                const statePath = path.join(entry.sessionDir, 'state.json');
+                let state = null;
+                let stateParsed = false;
+                if (fs.existsSync(statePath)) {
                     try {
-                        if (fs.existsSync(statePath)) {
-                            const state = JSON.parse(fs.readFileSync(statePath, 'utf-8'));
-                            entryWorkDir = extractWorkDir(state);
-                        }
+                        state = JSON.parse(fs.readFileSync(statePath, 'utf-8'));
+                        stateParsed = true;
                     }
                     catch {
-                        // Unreadable state — cannot determine cwd, skip
+                        // Corrupt state.json — cannot determine cwd → skip below
                     }
                 }
+                // Index workDir is v1-only; v2 sessions may have empty/missing workDir.
+                // When index workDir is absent, fall back to state.json's cwd field.
+                let entryWorkDir = entry.workDir;
+                if (!entryWorkDir) {
+                    if (stateParsed && state)
+                        entryWorkDir = extractWorkDir(state);
+                    // Unreadable state — cannot determine cwd, entryWorkDir stays undefined
+                }
                 if (entryWorkDir !== realCwd) {
                     continue;
                 }
-                const statePath = path.join(entry.sessionDir, 'state.json');
                 let summary = 'New Session';
-                if (fs.existsSync(statePath)) {
-                    try {
-                        const state = JSON.parse(fs.readFileSync(statePath, 'utf-8'));
-                        // v1: state.title / state.lastPrompt; v2: these fields may be absent
-                        summary = state.title || state.lastPrompt || '';
-                    }
-                    catch {
-                        // Corrupt state.json — fall through to wire.jsonl extraction
-                    }
+                if (stateParsed && state) {
+                    // v1: state.title / state.lastPrompt; v2: these fields may be absent
+                    summary = state.title || state.lastPrompt || '';
                 }
                 // v2 state.json omits title/lastPrompt: extract from wire.jsonl's last
                 // turn.prompt instead. Only scan a small tail to find it — the summary
@@ -549,11 +551,11 @@ export class KimiSessionReader {
         };
     }
     /**
-     * Resolve the main wire.jsonl path for a session after passing the cwd
-     * guard (state.json + session index fallback). Returns null when the
-     * session is unknown, fails the guard, or has no wire file.
+     * W2.5 单源：resolveSessionWirePath 与 isSessionActive 共用的 cwd 守卫
+     * （realpathSync → state.json workDir/cwd 三态 → index workDir 兜底 →
+     * fail-closed）。返回 sessionDir；会话未知或守卫不过返回 null。
      */
-    resolveSessionWirePath(sessionId, cwd) {
+    verifySessionCwd(sessionId, cwd) {
         // Find session directory from index (also retrieve index entry for
         // fallback cwd guard when state.json is missing or unparseable)
         const indexEntry = this.findSessionIndexEntry(sessionId);
@@ -561,7 +563,6 @@ export class KimiSessionReader {
         if (!sessionDir) {
             return null;
         }
-        const statePath = path.join(sessionDir, 'state.json');
         let realCwd;
         try {
             realCwd = fs.realpathSync(cwd);
@@ -571,6 +572,7 @@ export class KimiSessionReader {
             return null;
         }
         let cwdGuardPassed = false;
+        const statePath = path.join(sessionDir, 'state.json');
         try {
             if (fs.existsSync(statePath)) {
                 const state = JSON.parse(fs.readFileSync(statePath, 'utf-8'));
@@ -578,13 +580,12 @@ export class KimiSessionReader {
                 if (guardResult === 'failed') {
                     return null;
                 }
-                if (guardResult === 'unverifiable') {
-                    getLogger().warn(`[kimi-session-reader] state.json has no workDir/cwd field for session ${sessionId}, falling back to index workDir`);
-                    // Fall through to index-based guard below
+                if (guardResult === 'verified') {
+                    cwdGuardPassed = true;
                 }
                 else {
-                    // verified — state.json cwd matches
-                    cwdGuardPassed = true;
+                    getLogger().warn(`[kimi-session-reader] state.json has no workDir/cwd field for session ${sessionId}, falling back to index workDir`);
+                    // Fall through to index-based guard below
                 }
             }
         }
@@ -610,7 +611,18 @@ export class KimiSessionReader {
                 return null;
             }
         }
-        const wirePath = path.join(sessionDir, 'agents', 'main', 'wire.jsonl');
+        return { sessionDir };
+    }
+    /**
+     * Resolve the main wire.jsonl path for a session after passing the cwd
+     * guard (state.json + session index fallback). Returns null when the
+     * session is unknown, fails the guard, or has no wire file.
+     */
+    resolveSessionWirePath(sessionId, cwd) {
+        const verified = this.verifySessionCwd(sessionId, cwd);
+        if (!verified)
+            return null;
+        const wirePath = path.join(verified.sessionDir, 'agents', 'main', 'wire.jsonl');
         if (!fs.existsSync(wirePath)) {
             return null;
         }
@@ -620,46 +632,11 @@ export class KimiSessionReader {
      * Check if a session is currently active
      */
     isSessionActive(sessionId, cwd) {
-        const indexEntry = this.findSessionIndexEntry(sessionId);
-        const sessionDir = indexEntry?.sessionDir;
-        if (!sessionDir) {
+        // W2.5：cwd 守卫与 resolveSessionWirePath 共用 verifySessionCwd（单源）。
+        const verified = this.verifySessionCwd(sessionId, cwd);
+        if (!verified)
             return false;
-        }
-        // Cwd guard: the session's working directory must match the requested
-        // cwd (align with claude/pi/opencode). Mirrors readSessionContent's
-        // fail-closed cwd check (state.json workDir/cwd, then index workDir).
-        let realCwd;
-        try {
-            realCwd = fs.realpathSync(cwd);
-        }
-        catch {
-            return false;
-        }
-        let cwdGuardPassed = false;
-        const statePath = path.join(sessionDir, 'state.json');
-        try {
-            if (fs.existsSync(statePath)) {
-                const state = JSON.parse(fs.readFileSync(statePath, 'utf-8'));
-                const guardResult = checkCwdGuard(state, realCwd);
-                if (guardResult === 'failed')
-                    return false;
-                if (guardResult === 'verified')
-                    cwdGuardPassed = true;
-            }
-        }
-        catch {
-            // state.json unparseable — fall through to index-based guard
-        }
-        if (!cwdGuardPassed) {
-            const indexWorkDir = indexEntry?.workDir;
-            if (indexWorkDir && indexWorkDir !== realCwd)
-                return false;
-            // v2 sessions have empty index workDir (v1-only field) and may lack
-            // state.json cwd — fail-closed to prevent cross-workspace access.
-            if (!indexWorkDir)
-                return false;
-        }
-        const wirePath = path.join(sessionDir, 'agents', 'main', 'wire.jsonl');
+        const wirePath = path.join(verified.sessionDir, 'agents', 'main', 'wire.jsonl');
         if (!fs.existsSync(wirePath)) {
             return false;
         }
@@ -667,7 +644,7 @@ export class KimiSessionReader {
             const stat = fs.statSync(wirePath);
             const now = Date.now();
             // Check mtime freshness
-            if (now - stat.mtimeMs > STALE_MS) {
+            if (isStale(stat.mtimeMs, now)) {
                 return false;
             }
             // Read the tail to check for active indicators. kimi appends

package/dist/session/opencode/sessions.js

@@ -13,14 +13,15 @@
  * - isSessionActive: use `updated` timestamp with 1 hour stale window.
  * - Simple memory cache with TTL.
  */
-import { execFileSync } from 'node:child_process';
+import { spawnProcessSync } from '../../platform/spawn.js';
 import fs from 'node:fs';
 import { silentlyUnlink } from '../../common/fs.js';
 import os from 'node:os';
 import path from 'node:path';
 import { truncateUtf8, TOOL_RESULT_MAX_BYTES } from '../../common/truncate.js';
 import { getLogger } from '../../logger/index.js';
-import { STALE_MS } from '../common/constants.js';
+import { isStale } from '../common/constants.js';
+import { samePath } from '../../platform/path.js';
 import { paginate, capEvents } from '../common/pagination.js';
 import { sortByRecencyDesc } from '../common/recency.js';
 import { TtlCache } from '../../common/ttl-cache.js';
@@ -46,7 +47,7 @@ export class OpencodeSessionReader {
         const realCwd = this.realpath(cwd);
         const entries = this.fetchSessionList(realCwd);
         // Filter by directory === realpath(cwd)
-        const filtered = entries.filter((e) => e.directory === realCwd);
+        const filtered = entries.filter((e) => samePath(e.directory, realCwd));
         // Sort by updated descending; same-updated ties use id as a deterministic
         // secondary key so CLI/list-cache rebuilds never reorder the page.
         sortByRecencyDesc(filtered, (s) => s.updated, (s) => s.id);
@@ -281,11 +282,11 @@ export class OpencodeSessionReader {
         const realCwd = this.realpath(cwd);
         try {
             const entries = this.fetchSessionList(realCwd);
-            const entry = entries.find((e) => e.id === sessionId && e.directory === realCwd);
+            const entry = entries.find((e) => e.id === sessionId && samePath(e.directory, realCwd));
             if (!entry)
                 return false;
             // Check if updated within STALE_MS
-            return Date.now() - entry.updated < STALE_MS;
+            return !isStale(entry.updated);
         }
         catch {
             return false;
@@ -308,8 +309,12 @@ export class OpencodeSessionReader {
             return cached;
         }
         try {
+            // spawnProcessSync（cross-spawn）而非 execFileSync：opencode 是 npm 安装
+            // 的 .cmd 垫片，win32 上 execFileSync 不做 PATHEXT 解析会直接 ENOENT，
+            // 会话列表永远为空；cross-spawn 走与 runner spawn 相同的垫片执行路径
+            // （posix 为 child_process.spawnSync 直通，行为不变）。
             // Pass cwd to execFileSync so opencode CLI returns sessions for the correct directory
-            const output = execFileSync(this.binary, ['session', 'list', '--format', 'json'], {
+            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)
@@ -317,7 +322,19 @@ export class OpencodeSessionReader {
                 // user sees "no sessions" even though the CLI returned healthy data.
                 maxBuffer: 64 * 1024 * 1024,
                 cwd: realCwd, // Key fix: pass user cwd to CLI
-            }).trim();
+                windowsHide: true, // opencode 是 npm .cmd 垫片：不隐藏会闪 cmd.exe 控制台
+            });
+            if (res.error) {
+                const enoent = res.error.code === 'ENOENT';
+                if (enoent)
+                    return [];
+                throw res.error;
+            }
+            if (res.status !== 0) {
+                const stderr = String(res.stderr ?? '').trim();
+                throw new Error(`exit ${res.status}${stderr ? `: ${stderr}` : ''}`);
+            }
+            const output = String(res.stdout ?? '').trim();
             // CLI returns empty string when no sessions exist - treat as empty array
             if (!output) {
                 return [];
@@ -365,7 +382,7 @@ export class OpencodeSessionReader {
         let fd;
         try {
             fd = fs.openSync(tmp, 'w');
-            execFileSync(this.binary, ['export', sessionId], {
+            spawnProcessSync(this.binary, ['export', sessionId], {
                 encoding: 'utf-8',
                 timeout: 30000,
                 stdio: ['ignore', fd, 'pipe'],
@@ -373,6 +390,7 @@ export class OpencodeSessionReader {
                 // 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,
+                windowsHide: true,
             });
             return fs.readFileSync(tmp, 'utf-8');
         }

package/dist/session/pi/sessions.js

@@ -1,19 +1,27 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
-import { findJsonlLine, scanJsonlLines, readJsonlLinesFromOffset } from '../common/jsonl.js';
+import { findJsonlLine } from '../common/jsonl.js';
+import { scanJsonlOnce, tailOffsetAfter, scanTailEvents } from '../common/two-pass.js';
 import { extractContentBlocks } from '../common/content-blocks.js';
 import { UsageAccumulator, contextWindowOccupancy, cumulativeUsageFields, } from '../common/usage-accumulator.js';
-import { STALE_MS } from '../common/constants.js';
-import { capEvents, paginate } from '../common/pagination.js';
+import { isStale } from '../common/constants.js';
+import { encodeProjectDirName } from '../../platform/path.js';
+import { paginate } from '../common/pagination.js';
 import { sortByRecencyDesc } from '../common/recency.js';
 import { TtlCache } from '../../common/ttl-cache.js';
 function defaultPiDir() {
     return path.join(os.homedir(), '.pi', 'agent');
 }
-/** Encode cwd to pi's directory name format: '--<cwd-with-/->- + '-' --' */
+/**
+ * Encode cwd to pi's directory name format: '--<cwd with / \ : -> - --'
+ *
+ * 与 claude 共用 `encodeProjectDirName`（同一套 win32 归一规则），再去掉
+ * 前导分隔符产生的首个 `-`：`/Users/x` -> `Users-x`（不是 `-Users-x`）。
+ * win32 同理：`C:\Users\x` -> `C--Users-x`。
+ */
 function projectDirForCwd(cwd, sessionsDir) {
-    const encodedCwd = cwd.replace(/^\//, '').replace(/\//g, '-');
+    const encodedCwd = encodeProjectDirName(cwd).replace(/^-+/, '');
     const encoded = `--${encodedCwd}--`;
     return path.join(sessionsDir, encoded);
 }
@@ -143,14 +151,8 @@ function piScalarScan(filePath) {
     const acc = new UsageAccumulator();
     let tailOffset = -1;
     let lastUserText;
-    scanJsonlLines(filePath, (line, offset) => {
-        let obj;
-        try {
-            obj = JSON.parse(line);
-        }
-        catch {
-            return;
-        }
+    scanJsonlOnce(filePath, (rawObj, line, offset) => {
+        const obj = rawObj;
         if (obj.type === 'message') {
             const msg = obj.message;
             if (!msg)
@@ -168,9 +170,9 @@ function piScalarScan(filePath) {
             }
             // last user message offset + displayTitle. Record the byte offset
             // where the tail should start: the beginning of the NEXT line after
-            // this user message.
+            // this user message (see tailOffsetAfter).
             if (msg.role === 'user') {
-                tailOffset = offset + Buffer.byteLength(line, 'utf-8') + 1;
+                tailOffset = tailOffsetAfter(line, offset);
                 const text = extractPiText(msg.content);
                 // Compress skill-injection bodies so the "最近输入" label shows what
                 // the user invoked (skill:x) + any trailing real input, not a
@@ -219,44 +221,35 @@ function buildPiUsage(acc) {
     };
 }
 /**
- * P2-6 + P2-5 second-pass: extract content-block events from the tail
- * (lines after the last user message), re-parsing only those lines.
- * `tailLines` is already the tail-only slice (read via
- * `readJsonlLinesFromOffset`), so both raw line-string memory and parsed-
- * object memory are O(tail), not O(whole file) — P2-6 + P2-5.
+ * P2-6 + P2-5 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.
+ * `maxEvents` capping is applied by scanTailEvents.
  */
-function extractPiEventsFromTail(tailLines) {
+function mapPiTailLine(rawObj) {
     const events = [];
-    for (const line of tailLines) {
-        if (!line.trim())
-            continue;
-        try {
-            const obj = JSON.parse(line);
-            if (obj.type !== 'message' || !obj.message)
-                continue;
-            const message = obj.message;
-            // Handle error messages: when stopReason is "error", content is empty
-            // but errorMessage has details
-            if (message.stopReason === 'error' && message.errorMessage) {
-                events.push({
-                    type: 'error',
-                    content: `❌ ${message.errorMessage}`,
-                    timestamp: obj.timestamp,
-                });
-                continue;
-            }
-            const blocks = extractContentBlocks(message.content, PI_MAPPING);
-            const role = message.role ?? 'unknown';
-            for (const block of blocks) {
-                events.push({ type: block.type, content: block.content, timestamp: obj.timestamp });
-            }
-            if (blocks.length === 0 && message.role) {
-                events.push({ type: role, content: `(${role} event)`, timestamp: obj.timestamp });
-            }
-        }
-        catch {
-            /* skip */
-        }
+    const obj = rawObj;
+    if (obj.type !== 'message' || !obj.message)
+        return events;
+    const message = obj.message;
+    // Handle error messages: when stopReason is "error", content is empty
+    // but errorMessage has details
+    if (message.stopReason === 'error' && message.errorMessage) {
+        events.push({
+            type: 'error',
+            content: `❌ ${message.errorMessage}`,
+            timestamp: obj.timestamp,
+        });
+        return events;
+    }
+    const blocks = extractContentBlocks(message.content, PI_MAPPING);
+    const role = message.role ?? 'unknown';
+    for (const block of blocks) {
+        events.push({ type: block.type, content: block.content, timestamp: obj.timestamp });
+    }
+    if (blocks.length === 0 && message.role) {
+        events.push({ type: role, content: `(${role} event)`, timestamp: obj.timestamp });
     }
     return events;
 }
@@ -297,29 +290,17 @@ export class PiSessionReader {
         if (fileCwd && fileCwd !== cwd) {
             return { events: [] };
         }
-        // P2-5 + P2-6: First pass STREAMS the file once via `scanJsonlLines`
-        // (no `string[]` materialized), parsing each line once to collect
-        // scalars (usage, tailOffset, displayTitle) while retaining no parsed
-        // objects and no whole-file line array. The tailOffset is the byte
-        // offset where the tail begins (start of the line after the last user
-        // message). A second pass re-reads ONLY the tail from that offset via
-        // `readJsonlLinesFromOffset` and re-parses it for events — O(tail)
-        // memory for both raw line strings and parsed objects, instead of
-        // O(whole file).
-        //
-        // Parse ratio: ≈1.0–1.5× line count when a user message exists.
-        // 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 two-phase design.
+        // P2-5 + P2-6: 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,
+        // capped at maxEvents (keeps the LAST N events, matching
+        // CodexSessionReader's slice(-maxEvents), so auto-resume cards don't
+        // load the entire session).
         const scan = piScalarScan(filePath);
-        const tailLines = readJsonlLinesFromOffset(filePath, scan.tailOffset >= 0 ? scan.tailOffset : 0);
-        const events = extractPiEventsFromTail(tailLines);
-        // Apply maxEvents cap: keep the LAST N events (most recent), matching
-        // CodexSessionReader's slice(-maxEvents). maxEvents limits the catch-up
-        // tail so auto-resume cards don't load the entire session.
-        const cappedEvents = capEvents(events, opts?.maxEvents);
+        const events = scanTailEvents(filePath, scan.tailOffset, mapPiTailLine, opts?.maxEvents);
         return {
-            events: cappedEvents,
+            events,
             usage: scan.usage,
             displayTitle: scan.displayTitle,
         };
@@ -330,7 +311,7 @@ export class PiSessionReader {
             return false;
         try {
             const st = fs.statSync(filePath);
-            return Date.now() - st.mtimeMs < STALE_MS;
+            return !isStale(st.mtimeMs);
         }
         catch {
             return false;

package/dist/update/index.d.ts

@@ -5,6 +5,5 @@
  * package installation (detect package manager + global install),
  * and the combined workflow for the /update command and --update CLI flag.
  */
-export { isNewer, checkLatestVersion, type VersionCheckResult } from './version-check.js';
+export { isNewer, checkLatestVersion, formatUpdateHint, type VersionCheckResult, } from './version-check.js';
 export { runInstallLatest, type InstallResult } from './install.js';
-export { formatUpdateHint } from './startup-hint.js';

package/dist/update/index.js

@@ -5,7 +5,6 @@
  * package installation (detect package manager + global install),
  * and the combined workflow for the /update command and --update CLI flag.
  */
-export { isNewer, checkLatestVersion } from './version-check.js';
+export { isNewer, checkLatestVersion, formatUpdateHint, } from './version-check.js';
 export { runInstallLatest } from './install.js';
-export { formatUpdateHint } from './startup-hint.js';
 //# sourceMappingURL=index.js.map

package/dist/update/install.d.ts

@@ -38,7 +38,8 @@ export declare function detectPackageManager(scriptPath?: string): PackageManage
  * Run the global install command to upgrade lark-remote to the latest version.
  *
  * @param opts.packageManager - Override detected package manager
- * @param opts.execFn - Override execFile for testing
+ * @param opts.execFn - Override exec for testing; default routes through
+ *   platform/spawn.ts (cross-spawn, win32 .cmd shim safe)
  */
 export declare function runInstallLatest(opts?: {
     packageManager?: PackageManager | null;