lark-remote 0.1.3 → 0.1.4

package/CHANGELOG.md

@@ -5,6 +5,67 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.4] - 2026-08-13
+
+### 新增
+
+- 工作区列表支持 `lastUsedAt` 排序，最近使用的 workspace 排在前面；排序切换 UI 移至卡片上方，明确显示当前模式与切换目标
+- `/config` 卡片：未安装的 Coding Agent 沉底排序，已安装 agent 保持注册顺序；探测结果过期（`undefined`）时保持原位不误沉底
+
+### 修复
+
+- `/ws`、`/order` 卡片分页降为 15 条/页，修复飞书 ErrCode 11310 元素超限
+- workspace 排序相关 P2/P3 review findings 修复
+
+## [0.1.3] - 2026-08-12
+
+### 新增
+
+- Agent 可用性探测：启动时自动检测本机已安装/可用的 Agent CLI（`which` 探测），不可用的 Agent 会在 `/config` 卡片中标注；探测失败不阻塞启动，打开 `/config` 时会重试
+- 首次运行引导：PIN 绑定成功后自动设置默认工作目录，并发送欢迎卡片 + 帮助卡片
+- `message.patch` 业务码可观测性探针
+- Context 统计支持显示占比：codex 上报 `context window` 上限时，卡片按百分比展示上下文用量
+
+### 修复
+
+- `displayTitle`/`summary` 跳过 task-notification 注入
+- 修复 `scanClaudeSessions` 对迁移到其他目录的会话的遗漏（S2）
+- 修复 probe 生命周期、工厂回退、卡片回调等评审发现的问题（F1-F8）
+- 清理引用已删除文档（lessons-redlines、resume-card-budget-failure-analysis）导致的失效链接
+
+### 变更
+
+- 提取 `createAgentRegistries` 工厂，统一各 Agent 注册逻辑
+- 移除 Agent 二进制路径配置，CLI 名称改为硬编码
+- 移除 `pnpm-lock.yaml`，统一使用 `bun.lock` 管理依赖
+- 新增 husky lint-staged pre-commit / pre-push 钩子（提交前 lint + typecheck）
+- 启用 npm provenance（构建产物可溯源）
+- 移除 watchdog 相关用户文档及 `open-source-playbook` 等临时文档
+
+### 测试
+
+- 合并 stub 工厂、净化 fixtures、移除冗余测试
+- 新增 P1-15 configContainer 锚点测试（含 codex 负向断言）
+
+## [0.1.2] - 2026-08-10
+
+### 修复
+
+- claude / opencode / kimi 的 Agent 工厂改为从 `configContainer` 读取配置，避免使用过期闭包导致配置不生效（P1-15）
+- codex / kimi 的 `readSessionContent` 增加 cwd 校验，防止越界读取会话
+- `listClaudeSessions` / `isClaudeSessionActive` 支持跨目录回退，处理会话迁移后的定位
+- 修复 `handleQueueInput` 竞态：替换任务在 await 之前注册
+- 完成卡片 `resume.use` 携带 agent 字段，确保会话 reader 路由正确
+
+### 维护
+
+- 升级 `@vitest/coverage-v8` 至 4.1.10
+- 移除 CLI 子进程 smoke test，清理测试套件
+
+## [0.1.1] - 2026-08-09
+
+版本号 0.1.0 → 0.1.1，无用户可见功能变更。
+
 ## [0.1.0] - 2026-08-06
 
 Initial release.
@@ -50,3 +111,7 @@ Initial release.
 - Live Feishu API tests gated behind `FEISHU_LIVE_TEST=1` (external contributors can run full test suite without credentials)
 
 [0.1.0]: https://github.com/bungabungawoda/lark-remote/releases/tag/v0.1.0
+[0.1.1]: https://github.com/bungabungawoda/lark-remote/releases/tag/v0.1.1
+[0.1.2]: https://github.com/bungabungawoda/lark-remote/releases/tag/v0.1.2
+[0.1.3]: https://github.com/bungabungawoda/lark-remote/releases/tag/v0.1.3
+[0.1.4]: https://github.com/bungabungawoda/lark-remote/releases/tag/v0.1.4

package/dist/bridge/index.d.ts

@@ -57,7 +57,11 @@ interface BridgeDeps {
     /** Workspace store for fallback when sessionStore has no cwd */
     workspaceStore?: {
         get(name: string): string | undefined;
-        list(): [string, string][];
+        list(): Array<{
+            name: string;
+            path: string;
+            lastUsedAt: number;
+        }>;
     };
     /** Override the idle watchdog timeout (default 15 min). Tests use a small value. */
     idleTimeoutMs?: number;

package/dist/bridge/index.js

@@ -542,7 +542,9 @@ export class Bridge {
         if (!cwd && this.workspaceStore) {
             const workspaces = this.workspaceStore.list();
             if (workspaces.length > 0) {
-                cwd = workspaces[0][1];
+                // NOTE: fallback uses insertion order, not sort preference — by design
+                // (workspace-sorting.md §9: cwd fallback stays insertion-order for now)
+                cwd = workspaces[0].path;
                 getLogger().info(`[bridge] resolveCwd fallback cwd=${cwd} (first saved workspace)`);
             }
         }

package/dist/index.js

@@ -394,7 +394,9 @@ function setupMessageHandlers(connector, router, bridge, sessionStore, workspace
         if (!workspace && workspaceStore) {
             const workspaces = workspaceStore.list();
             if (workspaces.length > 0) {
-                workspace = workspaces[0][1];
+                // NOTE: fallback uses insertion order, not sort preference — by design
+                // (workspace-sorting.md §9: cwd fallback stays insertion-order for now)
+                workspace = workspaces[0].path;
             }
         }
         // Step4/D4: 入队时刻（T0）快照 agent+session，随任务闭包带到 T1 执行时刻，

package/dist/router/config/index.d.ts

@@ -16,3 +16,13 @@ import type { AgentConfigCardBuilder } from './types.js';
 export declare function getConfigBuilder(agent: AgentKind): AgentConfigCardBuilder;
 /** List all registered agent kinds. */
 export declare function listRegisteredAgents(): AgentKind[];
+/**
+ * Sort agent kinds for UI lists: agents that are definitively unavailable
+ * (availability === false) sink to the bottom; everything else keeps its
+ * input order. The sort is stable, so relative order within both groups is
+ * preserved (e.g. registration order in the config card selector).
+ *
+ * `undefined` (probe cache missing/expired) is treated as "keep in place",
+ * so a stale cache cannot misplace installed agents.
+ */
+export declare function sortAgentsByAvailability(kinds: AgentKind[], isAvailable: (kind: AgentKind) => boolean | undefined): AgentKind[];

package/dist/router/config/index.js

@@ -35,4 +35,21 @@ export function getConfigBuilder(agent) {
 export function listRegisteredAgents() {
     return Object.keys(builders);
 }
+/**
+ * Sort agent kinds for UI lists: agents that are definitively unavailable
+ * (availability === false) sink to the bottom; everything else keeps its
+ * input order. The sort is stable, so relative order within both groups is
+ * preserved (e.g. registration order in the config card selector).
+ *
+ * `undefined` (probe cache missing/expired) is treated as "keep in place",
+ * so a stale cache cannot misplace installed agents.
+ */
+export function sortAgentsByAvailability(kinds, isAvailable) {
+    const unavailable = new Set(kinds.filter((kind) => isAvailable(kind) === false));
+    return [...kinds].sort((a, b) => {
+        const rankA = unavailable.has(a) ? 1 : 0;
+        const rankB = unavailable.has(b) ? 1 : 0;
+        return rankA - rankB;
+    });
+}
 //# sourceMappingURL=index.js.map

package/dist/router/index.d.ts

@@ -17,6 +17,7 @@ interface CommandResult {
  * These bypass the serial queue and execute immediately.
  *
  * ws.use   — /ws list card "使用 <name>"
+ * ws.page  — /ws list card "上一页/下一页"
  * queue.immediate — queue card "立即执行" button (§9.6)
  * queue.cancel    — queue card "撤销" button
  * queue.diagnose  — queue card "诊断" button
@@ -25,6 +26,7 @@ interface CommandResult {
  * new-session — clear sessionId only
  * stop        — interrupt current run
  * ls.file     — send file only
+ * ws.page     — paginate /ws list only
  * ws.remove   — delete workspace alias only
  * resume.use  — set sessionId + agent for correct reader routing
  * help.*      — read-only help commands
@@ -98,6 +100,11 @@ export declare class CommandRouter {
      * millisecond); the counter guarantees uniqueness regardless of timing.
      */
     private orderExecKeyCounter;
+    /**
+     * Per-user sort preference for /ws list (memory-only, not persisted).
+     * Default 'recent' (most recently used first), can toggle to 'alpha'.
+     */
+    private wsSortPreference;
     /**
      * Session reader registry for multi-agent path. Resolves the right
      * reader by `config.defaultAgent` (and per-agent override params).
@@ -235,12 +242,31 @@ export declare class CommandRouter {
      * Mirrors handleLsPage — updates the same card, never sends a new one.
      */
     private handleOrderPage;
+    /**
+     * Handle ws.use card action: switch to the workspace, then refresh the /ws
+     * list card in place so "recent" sort order is immediately visible.
+     *
+     * Unlike the command-line `/ws use` (which returns text), the card action
+     * uses toast + inplace refresh for a cleaner UX (matching ws.remove/ws.sort).
+     * If auto-resume produces a card, it is sent as a separate reply.
+     */
+    private handleWsUse;
     /**
      * Handle ws.remove: remove the workspace alias and refresh the /ws list card
      * in place (mirrors handleOrderDelete). Without this the stale alias would
      * remain visible on the card the user just clicked.
      */
     private handleWsRemove;
+    /**
+     * Handle ws.page: paginate the /ws list in place.
+     * Mirrors handleOrderPage — updates the same card, never sends a new one.
+     */
+    private handleWsPage;
+    /**
+     * Handle ws.sort: toggle sort preference and refresh the /ws list card.
+     * Sort preference is memory-only (not persisted); restart resets to 'recent'.
+     */
+    private handleWsSort;
     /**
      * `ls.file` card button: send file to Feishu, rejecting if > 30MB.
      */

package/dist/router/index.js

@@ -12,7 +12,7 @@ import { markdownDiv, sessionEventPanel } from './card-helpers.js';
 import { MAX_FILE_UPLOAD_SIZE } from '../connector/file-limits.js';
 import { atomicWrite } from '../persistence/atomic-write.js';
 /** Config card builder - delegates to per-agent builders */
-import { getConfigBuilder, listRegisteredAgents } from './config/index.js';
+import { getConfigBuilder, listRegisteredAgents, sortAgentsByAvailability, } from './config/index.js';
 import { probeAllAgents, getCachedAvailability } from '../runner/probe.js';
 import { buildConfigCardFromTabs } from './config/common/render.js';
 /** Max events to read for auto-resume and /resume cards.
@@ -23,8 +23,19 @@ const AUTO_RESUME_MAX_EVENTS = 5;
 const RESUME_PAGE_SIZE = 5;
 /** /active 卡片每页显示的最大条目数（agent run + bash run 合计）。 */
 const ACTIVE_PAGE_SIZE = 20;
-/** /order 列表页大小；指令超过此数量时显示分页导航栏。 */
-const ORDER_PAGE_SIZE = 20;
+/**
+ * /order 列表页大小；指令超过此数量时显示分页导航栏。
+ * 2026-08-13 实测：每行 2 个元素（div + column_set，行间 hr），20 行 + 分页栏
+ * = 61 个 body 元素，触发飞书 ErrCode 11310 "element exceeds the limit"
+ * （21+ 条指令时第 1 页必炸）。改为 15 行：3*15 - 1 + 2 = 46 个元素，留足余量。
+ */
+const ORDER_PAGE_SIZE = 15;
+/**
+ * /ws 列表页大小。从 15 降为 5：头部 2 + 5 行 × 3（div + column_set + hr）+
+ * 底栏排序 1 + 分页栏 2 ≈ 20 个 body 元素，远低于单卡 60 元素上限（ErrCode 11310），
+ * 留足余量。
+ */
+const WS_PAGE_SIZE = 5;
 /** /resume 列表页内全量预取（readSessionContent）的行数上限；其余行用轻量 summary 兜底。 */
 const RESUME_CONTENT_PREFETCH = 5;
 /**
@@ -39,6 +50,7 @@ import { newSessionButton, agentDisplayName } from '../card/card-shared.js';
  * These bypass the serial queue and execute immediately.
  *
  * ws.use   — /ws list card "使用 <name>"
+ * ws.page  — /ws list card "上一页/下一页"
  * queue.immediate — queue card "立即执行" button (§9.6)
  * queue.cancel    — queue card "撤销" button
  * queue.diagnose  — queue card "诊断" button
@@ -47,6 +59,7 @@ import { newSessionButton, agentDisplayName } from '../card/card-shared.js';
  * new-session — clear sessionId only
  * stop        — interrupt current run
  * ls.file     — send file only
+ * ws.page     — paginate /ws list only
  * ws.remove   — delete workspace alias only
  * resume.use  — set sessionId + agent for correct reader routing
  * help.*      — read-only help commands
@@ -67,7 +80,9 @@ export function isImmediateAction(cmd) {
         cmd === 'ls.page' ||
         cmd === 'resume.page' || // control operation: paginate only, never spawns claude
         cmd === 'active.page' || // control operation: paginate active card
+        cmd === 'ws.page' || // control operation: paginate /ws list only
         cmd === 'ws.remove' ||
+        cmd === 'ws.sort' || // control operation: toggle sort mode only
         cmd === 'resume.use' ||
         cmd === 'ws.use' ||
         cmd === 'queue.immediate' ||
@@ -108,6 +123,11 @@ export class CommandRouter {
      * millisecond); the counter guarantees uniqueness regardless of timing.
      */
     orderExecKeyCounter = 0;
+    /**
+     * Per-user sort preference for /ws list (memory-only, not persisted).
+     * Default 'recent' (most recently used first), can toggle to 'alpha'.
+     */
+    wsSortPreference = new Map();
     /**
      * Session reader registry for multi-agent path. Resolves the right
      * reader by `config.defaultAgent` (and per-agent override params).
@@ -204,8 +224,11 @@ export class CommandRouter {
             case 'ls.page':
                 return this.handleLsPage(value, ctx);
             case 'ws.use':
-                await this.bridge.sendResult(this.cmdWs(['use', value.name ?? ''], ctx), ctx);
-                return;
+                return await this.handleWsUse(value, ctx);
+            case 'ws.sort':
+                return await this.handleWsSort(value, ctx);
+            case 'ws.page':
+                return await this.handleWsPage(value, ctx);
             case 'ws.remove':
                 return await this.handleWsRemove(value, ctx);
             case 'resume.use': {
@@ -932,6 +955,39 @@ export class CommandRouter {
         await this.bridge.updateCardInPlace(result.card, ctx);
         return { toast: { type: 'success', content: '' } };
     }
+    /**
+     * Handle ws.use card action: switch to the workspace, then refresh the /ws
+     * list card in place so "recent" sort order is immediately visible.
+     *
+     * Unlike the command-line `/ws use` (which returns text), the card action
+     * uses toast + inplace refresh for a cleaner UX (matching ws.remove/ws.sort).
+     * If auto-resume produces a card, it is sent as a separate reply.
+     */
+    async handleWsUse(value, ctx) {
+        const name = value.name ?? '';
+        const useResult = this.cmdWs(['use', name], ctx);
+        // Error cases (workspace not found, path invalid, etc.): relay as error toast
+        if (useResult.text && !useResult.text.includes('已切换')) {
+            return { toast: { type: 'error', content: useResult.text } };
+        }
+        // Success: if auto-resume produced a card, send it as a reply
+        if (useResult.card) {
+            await this.bridge.sendResult(useResult, ctx);
+        }
+        // Refresh the /ws list card in place so "recent" sort is immediately visible
+        const currentOffset = Math.max(0, Math.trunc(Number(value.offset) || 0));
+        const refreshed = this.cmdWs([], ctx, currentOffset);
+        if (refreshed.card) {
+            await this.bridge.updateCardInPlace(refreshed.card, ctx);
+        }
+        // Toast feedback (suppress text when auto-resume card was already sent)
+        return {
+            toast: {
+                type: 'success',
+                content: useResult.card ? '' : (useResult.text ?? `已切换到 workspace "${name}"`),
+            },
+        };
+    }
     /**
      * Handle ws.remove: remove the workspace alias and refresh the /ws list card
      * in place (mirrors handleOrderDelete). Without this the stale alias would
@@ -945,11 +1001,40 @@ export class CommandRouter {
         // Execute the removal (consumes the write-side effect; the returned text
         // is discarded — feedback flows through the toast + refreshed card).
         this.cmdWs(['remove', name], ctx);
-        // Rebuild the /ws list card and update it in place.
-        const refreshed = this.cmdWs([], ctx);
+        // Rebuild the /ws list card and update it in place, preserving the page
+        // the user was on when they clicked 删除.
+        const currentOffset = Math.max(0, Math.trunc(Number(value.offset) || 0));
+        const refreshed = this.cmdWs([], ctx, currentOffset);
         await this.bridge.updateCardInPlace(refreshed.card, ctx);
         return { toast: { type: 'success', content: `已删除 workspace "${name}"` } };
     }
+    /**
+     * Handle ws.page: paginate the /ws list in place.
+     * Mirrors handleOrderPage — updates the same card, never sends a new one.
+     */
+    async handleWsPage(value, ctx) {
+        const offset = Math.max(0, Math.trunc(Number(value.offset) || 0));
+        // cmdWs internally clamps stale/out-of-range offsets
+        const result = this.cmdWs([], ctx, offset);
+        await this.bridge.updateCardInPlace(result.card, ctx);
+        return { toast: { type: 'success', content: '' } };
+    }
+    /**
+     * Handle ws.sort: toggle sort preference and refresh the /ws list card.
+     * Sort preference is memory-only (not persisted); restart resets to 'recent'.
+     */
+    async handleWsSort(value, ctx) {
+        const userId = ctx.userId;
+        const current = this.wsSortPreference.get(userId) ?? 'recent';
+        const next = current === 'recent' ? 'alpha' : 'recent';
+        this.wsSortPreference.set(userId, next);
+        const result = this.cmdWs([], ctx, 0);
+        await this.bridge.updateCardInPlace(result.card, ctx);
+        const nextLabel = next === 'recent' ? '🕐 最近使用' : '🔤 字母顺序';
+        return {
+            toast: { type: 'success', content: `已切换为 ${nextLabel}` },
+        };
+    }
     /**
      * `ls.file` card button: send file to Feishu, rejecting if > 30MB.
      */
@@ -2030,7 +2115,7 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
             return { text: `读取目录失败: ${err.message}` };
         }
     }
-    cmdWs(args, ctx) {
+    cmdWs(args, ctx, offset = 0) {
         const sub = args[0]?.toLowerCase();
         switch (sub) {
             case 'save': {
@@ -2063,6 +2148,8 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
                 catch {
                     return { text: `路径无效: ${wsPath}` };
                 }
+                // Record usage timestamp AFTER successful path validation
+                this.workspaceStore.touch(name);
                 // Switch cwd with auto-resume and user feedback (shared with /cd and ls.switch)
                 return this.switchCwdAndNotify(ctx.userId, canonical, ctx);
             }
@@ -2079,6 +2166,29 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
             default: {
                 const entries = this.workspaceStore.list();
                 const currentCwd = this.sessionStore.getCwd(ctx.userId);
+                const sortMode = this.wsSortPreference.get(ctx.userId) ?? 'recent';
+                // Sort entries by the current preference (view concern, not stored)
+                if (sortMode === 'recent') {
+                    // Most recently used first; same lastUsedAt → alphabetical by name (deterministic)
+                    entries.sort((a, b) => {
+                        if (b.lastUsedAt !== a.lastUsedAt)
+                            return b.lastUsedAt - a.lastUsedAt;
+                        return a.name.localeCompare(b.name);
+                    });
+                }
+                else {
+                    // Alphabetical by alias name
+                    entries.sort((a, b) => a.name.localeCompare(b.name));
+                }
+                // Pagination calculations (mirror cmdOrder): clamp stale/out-of-range
+                // offsets so prev/next always step by WS_PAGE_SIZE.
+                const totalCount = entries.length;
+                const totalPages = Math.max(1, Math.ceil(totalCount / WS_PAGE_SIZE));
+                const maxOffset = Math.max(0, (totalPages - 1) * WS_PAGE_SIZE);
+                const safeOffset = Math.min(Math.max(offset, 0), maxOffset);
+                const currentPage = Math.floor(safeOffset / WS_PAGE_SIZE) + 1;
+                const pageEntries = entries.slice(safeOffset, safeOffset + WS_PAGE_SIZE);
+                const hasPagination = totalCount > WS_PAGE_SIZE;
                 // Build body elements: current cwd + workspace list with dividers
                 const bodyElements = [];
                 // Current working directory section
@@ -2086,18 +2196,56 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
                     tag: 'div',
                     text: { tag: 'lark_md', content: `📂 当前工作目录：\`${currentCwd ?? '(未设置)'}\`` },
                 });
-                bodyElements.push({ tag: 'hr' });
                 if (entries.length === 0) {
+                    bodyElements.push({ tag: 'hr' });
                     bodyElements.push({
                         tag: 'div',
                         text: { tag: 'lark_md', content: '没有保存的 workspace' },
                     });
                 }
                 else {
-                    entries.forEach(([name, p]) => {
+                    // Sort mode indicator + toggle button: placed above the list so the user
+                    // sees "current mode" and "switch to X" before scanning entries.
+                    // On narrow (mobile) screens, the label and button must convey both
+                    // what-is-active and what-clicking-does to avoid ambiguity.
+                    const currentLabel = sortMode === 'recent' ? '🕐 最近使用' : '🔤 字母顺序';
+                    const switchLabel = sortMode === 'recent' ? '🔤 字母顺序' : '🕐 最近使用';
+                    bodyElements.push({ tag: 'hr' });
+                    bodyElements.push({
+                        tag: 'column_set',
+                        columns: [
+                            {
+                                tag: 'column',
+                                width: 'weighted',
+                                weight: 1,
+                                vertical_align: 'center',
+                                elements: [
+                                    {
+                                        tag: 'div',
+                                        text: { tag: 'lark_md', content: `排序：${currentLabel}` },
+                                    },
+                                ],
+                            },
+                            {
+                                tag: 'column',
+                                width: 'auto',
+                                elements: [
+                                    {
+                                        tag: 'button',
+                                        text: { tag: 'plain_text', content: `切换为 ${switchLabel}` },
+                                        type: 'default',
+                                        size: 'small',
+                                        behaviors: [{ type: 'callback', value: { cmd: 'ws.sort' } }],
+                                    },
+                                ],
+                            },
+                        ],
+                    });
+                    bodyElements.push({ tag: 'hr' });
+                    for (const entry of pageEntries) {
                         bodyElements.push({
                             tag: 'div',
-                            text: { tag: 'lark_md', content: `**${name}** → \`${p}\`` },
+                            text: { tag: 'lark_md', content: `**${entry.name}** → \`${entry.path}\`` },
                         });
                         // Use column_set+column for 2.0 (action tag not supported in 2.0)
                         bodyElements.push({
@@ -2112,7 +2260,12 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
                                             text: { tag: 'plain_text', content: '切换' },
                                             type: 'primary',
                                             size: 'small',
-                                            behaviors: [{ type: 'callback', value: { cmd: 'ws.use', name } }],
+                                            behaviors: [
+                                                {
+                                                    type: 'callback',
+                                                    value: { cmd: 'ws.use', name: entry.name, offset: safeOffset },
+                                                },
+                                            ],
                                         },
                                     ],
                                 },
@@ -2125,15 +2278,86 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
                                             text: { tag: 'plain_text', content: '删除' },
                                             type: 'danger',
                                             size: 'small',
-                                            behaviors: [{ type: 'callback', value: { cmd: 'ws.remove', name } }],
+                                            behaviors: [
+                                                {
+                                                    type: 'callback',
+                                                    value: { cmd: 'ws.remove', name: entry.name, offset: safeOffset },
+                                                },
+                                            ],
                                         },
                                     ],
                                 },
                             ],
                         });
                         bodyElements.push({ tag: 'hr' });
-                    });
+                    }
                     bodyElements.pop();
+                    // Pagination bar — separate row below the list (not crowded with sort
+                    // toggle; mobile-friendly vertical layout).
+                    if (hasPagination) {
+                        const hasPrev = safeOffset > 0;
+                        const hasNext = safeOffset + WS_PAGE_SIZE < totalCount;
+                        const pageColumns = [];
+                        if (hasPrev) {
+                            pageColumns.push({
+                                tag: 'column',
+                                width: 'auto',
+                                vertical_align: 'center',
+                                elements: [
+                                    {
+                                        tag: 'button',
+                                        text: { tag: 'plain_text', content: '⬅' },
+                                        type: 'default',
+                                        size: 'small',
+                                        behaviors: [
+                                            {
+                                                type: 'callback',
+                                                value: { cmd: 'ws.page', offset: safeOffset - WS_PAGE_SIZE },
+                                            },
+                                        ],
+                                    },
+                                ],
+                            });
+                        }
+                        pageColumns.push({
+                            tag: 'column',
+                            width: 'weighted',
+                            weight: 1,
+                            vertical_align: 'center',
+                            elements: [
+                                {
+                                    tag: 'div',
+                                    text: {
+                                        tag: 'lark_md',
+                                        content: `**${currentPage}/${totalPages}**（${totalCount}）`,
+                                    },
+                                },
+                            ],
+                        });
+                        if (hasNext) {
+                            pageColumns.push({
+                                tag: 'column',
+                                width: 'auto',
+                                vertical_align: 'center',
+                                elements: [
+                                    {
+                                        tag: 'button',
+                                        text: { tag: 'plain_text', content: '➡' },
+                                        type: 'default',
+                                        size: 'small',
+                                        behaviors: [
+                                            {
+                                                type: 'callback',
+                                                value: { cmd: 'ws.page', offset: safeOffset + WS_PAGE_SIZE },
+                                            },
+                                        ],
+                                    },
+                                ],
+                            });
+                        }
+                        bodyElements.push({ tag: 'hr' });
+                        bodyElements.push({ tag: 'column_set', columns: pageColumns });
+                    }
                 }
                 const card = {
                     schema: '2.0',
@@ -2718,7 +2942,9 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
         // Direct inline construction (not via ConfigField) so that text (display label)
         // and value (agentKind for config storage) can differ — uninstalled agents get
         // a "⚠️ (未安装)" suffix in the label while the value stays clean.
-        const allAgents = listRegisteredAgents();
+        // Uninstalled agents sink to the bottom; installed ones keep registration
+        // order (claude → codex → pi → opencode → kimi).
+        const allAgents = sortAgentsByAvailability(listRegisteredAgents(), getCachedAvailability);
         const agentOptions = allAgents.map((kind) => {
             const available = getCachedAvailability(kind);
             const label = available === false ? `${agentDisplayName(kind)} ⚠️ (未安装)` : agentDisplayName(kind);

package/dist/workspace/index.d.ts

@@ -1,9 +1,18 @@
+/** Public view of a workspace entry returned by list(). */
+export interface WorkspaceEntry {
+    name: string;
+    path: string;
+    lastUsedAt: number;
+}
 /**
  * Persistent named-alias store for workspace 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
  * is treated as empty (with a warning) so the bridge can still start.
+ *
+ * Data migration: old format `{ alias: "path" }` is normalized to
+ * `{ alias: { path, lastUsedAt: 0 } }` on first load and persisted.
  */
 export declare class WorkspaceStore {
     private filePath;
@@ -15,5 +24,14 @@ export declare class WorkspaceStore {
     get(name: string): string | undefined;
     has(name: string): boolean;
     remove(name: string): void;
-    list(): [string, string][];
+    /**
+     * Update lastUsedAt to now for the given alias and persist.
+     * No-op if the alias does not exist.
+     */
+    touch(name: string): void;
+    /**
+     * List all workspace entries in insertion order.
+     * Sorting is the caller's responsibility (view concern).
+     */
+    list(): WorkspaceEntry[];
 }

package/dist/workspace/index.js

@@ -2,12 +2,16 @@ import path from 'node:path';
 import os from 'node:os';
 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.
  *
  * 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
  * is treated as empty (with a warning) so the bridge can still start.
+ *
+ * Data migration: old format `{ alias: "path" }` is normalized to
+ * `{ alias: { path, lastUsedAt: 0 } }` on first load and persisted.
  */
 export class WorkspaceStore {
     filePath;
@@ -21,9 +25,32 @@ export class WorkspaceStore {
         const parsed = loadJsonFile(this.filePath, undefined);
         if (!parsed)
             return;
+        let needsMigration = false;
         for (const [k, v] of Object.entries(parsed)) {
-            if (typeof v === 'string')
-                this.data.set(k, v);
+            if (typeof v === 'string') {
+                // Old format: string value → { path, lastUsedAt: 0 }
+                this.data.set(k, { path: v, lastUsedAt: 0 });
+                needsMigration = true;
+            }
+            else if (typeof v === 'object' &&
+                v !== null &&
+                typeof v.path === 'string') {
+                // New format: extract path and lastUsedAt (default 0 if missing)
+                const obj = v;
+                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`);
+                    }
+                    needsMigration = true;
+                }
+                this.data.set(k, { path: obj.path, lastUsedAt });
+            }
+            // Non-string, non-object entries are silently skipped (existing behavior)
+        }
+        // Write back immediately if migration occurred
+        if (needsMigration) {
+            this.persist();
         }
     }
     persist() {
@@ -33,11 +60,11 @@ export class WorkspaceStore {
         atomicWriteJson(this.filePath, obj);
     }
     save(name, dirPath) {
-        this.data.set(name, dirPath);
+        this.data.set(name, { path: dirPath, lastUsedAt: 0 });
         this.persist();
     }
     get(name) {
-        return this.data.get(name);
+        return this.data.get(name)?.path;
     }
     has(name) {
         return this.data.has(name);
@@ -46,8 +73,27 @@ export class WorkspaceStore {
         this.data.delete(name);
         this.persist();
     }
+    /**
+     * Update lastUsedAt to now for the given alias and persist.
+     * No-op if the alias does not exist.
+     */
+    touch(name) {
+        const entry = this.data.get(name);
+        if (!entry)
+            return;
+        entry.lastUsedAt = Date.now();
+        this.persist();
+    }
+    /**
+     * List all workspace entries in insertion order.
+     * Sorting is the caller's responsibility (view concern).
+     */
     list() {
-        return [...this.data.entries()];
+        return [...this.data.entries()].map(([name, data]) => ({
+            name,
+            path: data.path,
+            lastUsedAt: data.lastUsedAt,
+        }));
     }
 }
 //# sourceMappingURL=index.js.map

package/package.json

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