lark-remote 0.4.4 → 0.4.5

package/dist/runner/registry.d.ts

@@ -1,7 +1,7 @@
 import type { AgentKind, Runner } from './index.js';
 /**
  * Registry of agent factories, keyed by `AgentKind`. `index.ts` registers one
- * factory per available agent at startup; `Bridge.getRunner(workspace)` looks
+ * factory per available agent at startup; `Bridge.getRunner(cwd)` looks
  * up `config.defaultAgent` here to pick the concrete runner.
  *
  * Singleton caching: the factory MAY cache its instance internally. All
@@ -17,7 +17,7 @@ export declare class AgentRegistry {
     private readonly displayNames;
     /** Container for runtime config updates (pi provider dynamic reload). */
     private configContainer?;
-    register(kind: AgentKind, factory: (workspace: string) => Runner): void;
+    register(kind: AgentKind, factory: (cwd: string) => Runner): void;
     /**
      * 注册 agent 的显示名。应在 register(kind, factory) 后调用。
      * 用于 agentDisplayName 等全局查询，实现单点真相。
@@ -50,5 +50,5 @@ export declare class AgentRegistry {
     getConfigContainer(): {
         current: unknown;
     } | undefined;
-    get(kind: AgentKind, workspace: string): Runner;
+    get(kind: AgentKind, cwd: string): Runner;
 }

package/dist/runner/registry.js

@@ -5,7 +5,7 @@
 let globalRegistry;
 /**
  * Registry of agent factories, keyed by `AgentKind`. `index.ts` registers one
- * factory per available agent at startup; `Bridge.getRunner(workspace)` looks
+ * factory per available agent at startup; `Bridge.getRunner(cwd)` looks
  * up `config.defaultAgent` here to pick the concrete runner.
  *
  * Singleton caching: the factory MAY cache its instance internally. All
@@ -64,12 +64,12 @@ export class AgentRegistry {
     getConfigContainer() {
         return this.configContainer;
     }
-    get(kind, workspace) {
+    get(kind, cwd) {
         const factory = this.factories.get(kind);
         if (!factory) {
             throw new Error(`agent not registered: ${kind}`);
         }
-        return factory(workspace);
+        return factory(cwd);
     }
 }
 //# sourceMappingURL=registry.js.map

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

@@ -36,7 +36,7 @@ export interface ParsedSession {
 /**
  * Unified parser: single streaming scan of a JSONL file producing both
  * the complete set of cwd values AND the first real user message summary.
- * Replaces the split readCwdFromJsonl (first-cwd) + jsonlContainsCwd (any-cwd).
+ * Replaces the split readCwdFromJsonl (first-cwd) + fileContainsCwd (any-cwd).
  */
 export declare function parseSessionJsonl(filePath: string): ParsedSession;
 /**

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

@@ -42,7 +42,7 @@ export function extractText(content) {
 /**
  * Unified parser: single streaming scan of a JSONL file producing both
  * the complete set of cwd values AND the first real user message summary.
- * Replaces the split readCwdFromJsonl (first-cwd) + jsonlContainsCwd (any-cwd).
+ * Replaces the split readCwdFromJsonl (first-cwd) + fileContainsCwd (any-cwd).
  */
 export function parseSessionJsonl(filePath) {
     const cwdSet = new Set();

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

@@ -8,7 +8,7 @@ import type { AgentSession, AgentSessionReader, SessionContent } from '../../run
  * injects a reader configured with its test `projectsDir`; production code
  * uses the default (`~/.claude/projects/`).
  *
- * All methods are thin wrappers around `claude-sessions.ts` exports — zero
+ * All methods are thin wrappers around `sessions.ts` exports — zero
  * behavior change. Router and bridge reach session data exclusively through
  * this reader (via `SessionReaderRegistry`); the underlying functions remain
  * exported for tests and the reader itself.

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

@@ -9,7 +9,7 @@ import { listClaudeSessions, getNewestSession, readSessionContent, isClaudeSessi
  * injects a reader configured with its test `projectsDir`; production code
  * uses the default (`~/.claude/projects/`).
  *
- * All methods are thin wrappers around `claude-sessions.ts` exports — zero
+ * All methods are thin wrappers around `sessions.ts` exports — zero
  * behavior change. Router and bridge reach session data exclusively through
  * this reader (via `SessionReaderRegistry`); the underlying functions remain
  * exported for tests and the reader itself.

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

@@ -399,9 +399,9 @@ export function readCodexSessionContent(sessionId, opts = {}) {
     }
     // Cwd guard: when a cwd is provided, the session's working directory must
     // match. Without this, /resume <id> finds sessions by global ID lookup and
-    // allows resuming a session from workspace B while the user is in workspace A.
+    // allows resuming a session from cwd B while the user is in cwd A.
     // Codex has no relocation (no EnterWorktree equivalent), so a simple equality
-    // check suffices — unlike claude which needs jsonlContainsCwd to handle
+    // check suffices — unlike claude which needs fileContainsCwd to handle
     // relocated sessions with multiple cwd values.
     if (opts.cwd && !samePath(entry.cwd, opts.cwd)) {
         return { events: [] };

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

@@ -36,7 +36,7 @@ export declare class DshSessionReader implements AgentSessionReader {
         total: number;
     };
     getNewestSession(cwd: string): AgentSession | null;
-    readSessionContent(sessionId: string, cwd: string, opts?: {
+    readSessionContent(sessionId: string, _cwd: string, opts?: {
         maxEvents?: number;
     }): SessionContent;
     isSessionActive(sessionId: string, cwd: string): boolean;

package/dist/session/dsh/sessions.js

@@ -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,

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

package/dist/session/kimi/sessions.js

@@ -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
@@ -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)`);

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;
@@ -401,7 +401,7 @@ export class OpencodeSessionReader {
                 }
                 catch { }
             }
-            silentlyUnlink(tmp);
+            bestEffortUnlink(tmp);
         }
     }
 }

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:
@@ -29,7 +29,6 @@ interface SessionEntry {
 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:
@@ -19,7 +19,6 @@ import { atomicWriteJson } from '../persistence/atomic-write.js';
 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[];

package/dist/workspace/index.js

@@ -4,7 +4,7 @@ import { atomicWriteJson } from '../persistence/atomic-write.js';
 import { loadJsonFile } from '../persistence/load-json-file.js';
 import { getLogger } from '../logger/index.js';
 /**
- * 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
@@ -12,7 +12,7 @@ import { getLogger } from '../logger/index.js';
  *
  * lastUsedAt 语义（2026-08-19 语义对齐）：保存（save）与使用（use/touch）
  * 都会把时间戳更新为当前时间。save 内部调用 touch，保证「最近使用」排序
- * 对新保存的 workspace 同样生效（新条目应排在列表最前，而非沉底）。
+ * 对新保存的 cwd 同样生效（新条目应排在列表最前，而非沉底）。
  * 同一毫秒内连续操作时 touch 会用 max+1 保证严格递增，避免 Date.now 相同
  * 导致最近排序退化为字母序。
  *
@@ -46,7 +46,7 @@ export class WorkspaceStore {
                 const lastUsedAt = typeof obj.lastUsedAt === 'number' ? obj.lastUsedAt : 0;
                 if (typeof obj.lastUsedAt !== 'number') {
                     if (obj.lastUsedAt !== undefined) {
-                        getLogger().warn(`[workspace] "${k}" has invalid lastUsedAt (${JSON.stringify(obj.lastUsedAt)}), resetting to 0`);
+                        getLogger().warn(`[cwd] "${k}" has invalid lastUsedAt (${JSON.stringify(obj.lastUsedAt)}), resetting to 0`);
                     }
                     needsMigration = true;
                 }
@@ -66,7 +66,7 @@ export class WorkspaceStore {
         atomicWriteJson(this.filePath, obj);
     }
     save(name, dirPath) {
-        // 保存即视为使用（语义对齐）：新建/覆盖的 workspace 都应拿到当前
+        // 保存即视为使用（语义对齐）：新建/覆盖的 cwd 都应拿到当前
         // lastUsedAt，而不是 0，否则「最近使用」排序下新条目会沉底。
         // touch() 负责统一写入时间戳并 persist，消除 save 写 0 / use 写 now 的不对称。
         this.data.set(name, { path: dirPath, lastUsedAt: 0 });
@@ -111,7 +111,7 @@ export class WorkspaceStore {
         this.persist();
     }
     /**
-     * List all workspace entries in insertion order.
+     * List all cwd entries in insertion order.
      * Sorting is the caller's responsibility (view concern).
      */
     list() {

package/package.json

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