lark-remote 0.4.4 → 0.5.0

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 可改成分页，当前用有界大拉取）
@@ -102,7 +102,7 @@ export class DshSessionReader {
     getNewestSession(cwd) {
         return this.listSessions(cwd, { limit: 1 }).sessions[0] ?? null;
     }
-    readSessionContent(sessionId, cwd, opts) {
+    readSessionContent(sessionId, _cwd, opts) {
         try {
             const value = this.unary('session.history', {
                 sessionId,
@@ -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

@@ -66,10 +66,6 @@ export declare class KimiSessionReader implements AgentSessionReader {
      * Find a single index entry by sessionId, or undefined if not found.
      */
     private findSessionIndexEntry;
-    /**
-     * Convenience wrapper: find sessionDir from index, or null if not found.
-     */
-    private findSessionDirFromIndex;
     /**
      * Extract the last turn.prompt text from a wire.jsonl file.
      * Used as a fallback summary source when state.json has no title/lastPrompt
@@ -108,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): {
@@ -118,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) {
@@ -163,12 +163,6 @@ export class KimiSessionReader {
     findSessionIndexEntry(sessionId) {
         return this.scanSessionIndex().find((e) => e.sessionId === sessionId);
     }
-    /**
-     * Convenience wrapper: find sessionDir from index, or null if not found.
-     */
-    findSessionDirFromIndex(sessionId) {
-        return this.findSessionIndexEntry(sessionId)?.sessionDir ?? null;
-    }
     /**
      * Extract the last turn.prompt text from a wire.jsonl file.
      * Used as a fallback summary source when state.json has no title/lastPrompt
@@ -210,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');
@@ -248,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
@@ -338,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;
                 }
@@ -356,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
@@ -366,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
@@ -408,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}]`;
@@ -529,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) {
@@ -551,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。
      */
@@ -596,7 +590,7 @@ export class KimiSessionReader {
         // Fallback: when state.json is missing, unparseable, or has no workDir/cwd,
         // use the workDir from the session index entry as a secondary guard.
         // This prevents /resume <id> from accessing a session belonging to a
-        // different workspace when state.json is unavailable.
+        // different cwd when state.json is unavailable.
         if (!cwdGuardPassed) {
             const indexWorkDir = indexEntry?.workDir;
             if (indexWorkDir && indexWorkDir !== realCwd) {
@@ -604,7 +598,7 @@ export class KimiSessionReader {
             }
             // v2 sessions have empty index workDir (v1-only field) and may lack
             // state.json cwd. When no cwd source can verify the session belongs to
-            // the requested workspace, fail-closed to prevent cross-workspace access
+            // the requested cwd, fail-closed to prevent cross-workspace access
             // (aligned with claude's fail-closed cwd guard).
             if (!indexWorkDir) {
                 getLogger().warn(`[kimi-session-reader] no cwd source (state.json + index) for session ${sessionId}, rejecting (fail-closed)`);
@@ -632,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;
@@ -650,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

@@ -15,16 +15,16 @@
  */
 import { spawnProcessSync } from '../../platform/spawn.js';
 import fs from 'node:fs';
-import { silentlyUnlink } from '../../common/fs.js';
+import { bestEffortUnlink } 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 { 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';
+import { getLogger } from '../../logger/index.js';
 export class OpencodeSessionReader {
     binary;
     cacheTtlMs;
@@ -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,
@@ -401,7 +403,7 @@ export class OpencodeSessionReader {
                 }
                 catch { }
             }
-            silentlyUnlink(tmp);
+            bestEffortUnlink(tmp);
         }
     }
 }

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/registry.d.ts

@@ -3,7 +3,7 @@ import type { AgentKind, AgentSessionReader } from '../runner/index.js';
  * Registry of `AgentSessionReader` instances, keyed by `AgentKind`. Mirrors
  * `AgentRegistry` but for session-history reads. `index.ts` registers one
  * reader per available agent at startup; router/bridge look up readers here
- * instead of importing `claude-sessions.ts` directly.
+ * instead of importing `sessions.ts` directly.
  */
 export declare class SessionReaderRegistry {
     private readonly readers;

package/dist/session/registry.js

@@ -2,7 +2,7 @@
  * Registry of `AgentSessionReader` instances, keyed by `AgentKind`. Mirrors
  * `AgentRegistry` but for session-history reads. `index.ts` registers one
  * reader per available agent at startup; router/bridge look up readers here
- * instead of importing `claude-sessions.ts` directly.
+ * instead of importing `sessions.ts` directly.
  */
 export class SessionReaderRegistry {
     readers = new Map();

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

@@ -13,7 +13,7 @@ interface SessionEntry {
 }
 /**
  * Per-user session store. Persists cwd + per-agent sessions to disk so that
- * the last workspace AND the last-used sessionId per agent are restored after
+ * the last cwd AND the last-used sessionId per agent are restored after
  * a lark-remote restart.
  *
  * Persistence strategy:
@@ -23,13 +23,12 @@ 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 {
     private sessions;
     private readonly persistPath?;
-    private readonly defaultAgent?;
     /**
      * 进程内会话代际（2026-08-09 /new 被在途 run init 写回撤销事故）：
      * 每次「用户意图移动 session 指针」+1。system.init 写回通道不 bump。
@@ -47,7 +46,7 @@ export declare class SessionStore {
     bumpSessionEpoch(userId: string, agent: AgentKind): void;
     /** 用户意图移动了全部 agent 的 session 指针（/cd、/ws use 的 setCwd）。 */
     private bumpUserEpoch;
-    constructor(persistPath?: string, defaultAgent?: AgentKind);
+    constructor(persistPath?: string);
     /** A fresh, empty session entry (default factory). */
     private static emptyEntry;
     /**

package/dist/session/session-store.js

@@ -3,7 +3,7 @@ import { getLogger } from '../logger/index.js';
 import { atomicWriteJson } from '../persistence/atomic-write.js';
 /**
  * Per-user session store. Persists cwd + per-agent sessions to disk so that
- * the last workspace AND the last-used sessionId per agent are restored after
+ * the last cwd AND the last-used sessionId per agent are restored after
  * a lark-remote restart.
  *
  * Persistence strategy:
@@ -13,13 +13,12 @@ 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 {
     sessions = new Map();
     persistPath;
-    defaultAgent;
     /**
      * 进程内会话代际（2026-08-09 /new 被在途 run init 写回撤销事故）：
      * 每次「用户意图移动 session 指针」+1。system.init 写回通道不 bump。
@@ -47,9 +46,8 @@ export class SessionStore {
     bumpUserEpoch(userId) {
         this.userEpochs.set(userId, (this.userEpochs.get(userId) ?? 0) + 1);
     }
-    constructor(persistPath, defaultAgent) {
+    constructor(persistPath) {
         this.persistPath = persistPath;
-        this.defaultAgent = defaultAgent;
         if (persistPath)
             this.load();
     }

package/dist/update/index.d.ts

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

package/dist/update/index.js

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

package/dist/update/version-check.d.ts

@@ -12,10 +12,12 @@ export interface VersionCheckResult {
 }
 /**
  * Compare two semver strings (major.minor.patch).
- * Returns true if latest > current, false if latest <= current,
- * null if either version is not a valid semver string.
+ *
+ * Returns the sign of `latest - current`: `1` if latest is newer, `-1` if it
+ * is older, `0` if equal. Returns `null` if either version is not a valid
+ * semver string (callers should treat `null` as "not newer").
  */
-export declare function isNewer(current: string, latest: string): boolean | null;
+export declare function compareVersions(current: string, latest: string): -1 | 0 | 1 | null;
 /**
  * Check the latest available version of lark-remote.
  * Uses a local cache file with 1-hour TTL to avoid frequent network requests.

package/dist/update/version-check.js

@@ -10,10 +10,12 @@ export const CACHE_TTL_MS = 60 * 60 * 1000;
 const DEFAULT_REGISTRY_URL = 'https://registry.npmjs.org/lark-remote/latest';
 /**
  * Compare two semver strings (major.minor.patch).
- * Returns true if latest > current, false if latest <= current,
- * null if either version is not a valid semver string.
+ *
+ * Returns the sign of `latest - current`: `1` if latest is newer, `-1` if it
+ * is older, `0` if equal. Returns `null` if either version is not a valid
+ * semver string (callers should treat `null` as "not newer").
  */
-export function isNewer(current, latest) {
+export function compareVersions(current, latest) {
     const parse = (v) => {
         // Split core and pre-release suffix; compare the core numerically and treat
         // a release as newer than any pre-release of the same core version.
@@ -32,14 +34,14 @@ export function isNewer(current, latest) {
         return null;
     for (let i = 0; i < 3; i++) {
         if (l.nums[i] > c.nums[i])
-            return true;
+            return 1;
         if (l.nums[i] < c.nums[i])
-            return false;
+            return -1;
     }
     // Equal core version: a release beats a pre-release of the same version.
     if (c.pre !== l.pre)
-        return l.pre === '';
-    return false;
+        return l.pre === '' ? 1 : -1;
+    return 0;
 }
 /**
  * Fetch the latest version from npm registry.
@@ -151,7 +153,7 @@ export async function checkLatestVersion(opts) {
  * Returns null if no newer version is available.
  */
 export function formatUpdateHint(current, latest) {
-    if (!isNewer(current, latest))
+    if (compareVersions(current, latest) !== 1)
         return null;
     return `📦 有新版本 ${latest} 可用（当前 ${current}），发送 /update 升级`;
 }

package/dist/workspace/index.d.ts

@@ -1,11 +1,11 @@
-/** Public view of a workspace entry returned by list(). */
+/** Public view of a cwd entry returned by list(). */
 export interface WorkspaceEntry {
     name: string;
     path: string;
     lastUsedAt: number;
 }
 /**
- * Persistent named-alias store for workspace directories.
+ * Persistent named-alias store for cwd directories.
  *
  * Atomic write (§9.10): writes a temp file then `fs.rename` so a crash
  * mid-write cannot leave a truncated JSON file. On load, a corrupt file
@@ -13,7 +13,7 @@ export interface WorkspaceEntry {
  *
  * lastUsedAt 语义（2026-08-19 语义对齐）：保存（save）与使用（use/touch）
  * 都会把时间戳更新为当前时间。save 内部调用 touch，保证「最近使用」排序
- * 对新保存的 workspace 同样生效（新条目应排在列表最前，而非沉底）。
+ * 对新保存的 cwd 同样生效（新条目应排在列表最前，而非沉底）。
  * 同一毫秒内连续操作时 touch 会用 max+1 保证严格递增，避免 Date.now 相同
  * 导致最近排序退化为字母序。
  *
@@ -42,7 +42,7 @@ export declare class WorkspaceStore {
      */
     touch(name: string): void;
     /**
-     * List all workspace entries in insertion order.
+     * List all cwd entries in insertion order.
      * Sorting is the caller's responsibility (view concern).
      */
     list(): WorkspaceEntry[];