lark-remote 0.1.2 → 0.1.4

package/dist/router/index.js

@@ -12,7 +12,8 @@ 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.
  * Limits events at the read stage so enforceCardBudget rarely needs to truncate.
@@ -20,6 +21,21 @@ import { buildConfigCardFromTabs } from './config/common/render.js';
 const AUTO_RESUME_MAX_EVENTS = 5;
 /** /resume 列表页大小；`/resume [N]` 的 N clamp 到 [1, RESUME_PAGE_SIZE]。 */
 const RESUME_PAGE_SIZE = 5;
+/** /active 卡片每页显示的最大条目数（agent run + bash run 合计）。 */
+const ACTIVE_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;
 /**
@@ -34,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
@@ -42,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
@@ -61,7 +79,10 @@ export function isImmediateAction(cmd) {
         cmd === 'ls.switch' ||
         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' ||
@@ -70,12 +91,15 @@ export function isImmediateAction(cmd) {
         cmd === 'queue.edit' ||
         cmd === 'queue.input' ||
         cmd === 'order.delete' ||
+        cmd === 'order.page' ||
         cmd === 'config.toggle' ||
         cmd === 'config.set' ||
         cmd === 'config.input' ||
         cmd === 'config.save');
 }
 export class CommandRouter {
+    /** Valid agent kinds — single source of truth for resume.use / resume.page / cmdResume. */
+    static VALID_AGENTS = ['claude', 'codex', 'opencode', 'pi', 'kimi'];
     sessionStore;
     bridge;
     config;
@@ -99,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).
@@ -195,15 +224,18 @@ 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': {
-                // resume.use can carry an agent field when called from /resume [agent] list
+                // resume.use carries an agent field from /resume [agent] list cards
+                // (both active and completed cards include the agent field).
                 const resumeAgent = value.agent ?? this.config.defaultAgent;
-                // Validate agent is a valid type
-                const validAgents = ['claude', 'codex', 'opencode', 'pi', 'kimi'];
+                const validAgents = CommandRouter.VALID_AGENTS;
                 const resolvedAgent = validAgents.includes(resumeAgent)
                     ? resumeAgent
                     : this.config.defaultAgent;
@@ -226,6 +258,8 @@ export class CommandRouter {
             }
             case 'resume.page':
                 return this.handleResumePage(value, ctx);
+            case 'active.page':
+                return this.handleActivePage(value, ctx);
             case 'new-session':
                 this.sessionStore.clearSessionId(ctx.userId, this.config.defaultAgent, {
                     clearSessionCwd: true,
@@ -260,6 +294,8 @@ export class CommandRouter {
                 return await this.handleQueueInput(value, ctx);
             case 'order.delete':
                 return await this.handleOrderDelete(value, ctx);
+            case 'order.page':
+                return await this.handleOrderPage(value, ctx);
             case 'config.toggle':
             case 'config.set':
             case 'config.input':
@@ -633,9 +669,11 @@ export class CommandRouter {
         const inputTask = this.bridge.getQueuedTask(workspace, messageId);
         if (!inputTask) {
             // Task already left the queue (began or was cancelled) before we could
-            // register the replacement. The user must be told the edit failed.
-            await this.bridge.sendResult({ text: '⚠️ 任务已不在队列中（可能已开始执行或被撤销）' }, ctx);
-            return;
+            // register the replacement. Return a toast so the edit-form card gets
+            // dismissed — sendResult alone leaves the card stuck in the edit state
+            // (Feishu keeps the pre-click card when the callback response has no
+            // toast/card field).
+            return { toast: { type: 'info', content: '任务已不在队列中（可能已开始执行或被撤销）' } };
         }
         this.bridge.setTaskReplacement(workspace, messageId, async () => {
             await this.handle(newMessage, ctx, { cwdOverride: workspace, binding: inputTask.binding });
@@ -767,8 +805,7 @@ export class CommandRouter {
      */
     async handleResumePage(value, ctx) {
         const resumeAgent = value.agent ?? this.config.defaultAgent;
-        // Validate agent is a valid type (same as resume.use); fall back to default.
-        const validAgents = ['claude', 'codex', 'opencode', 'pi', 'kimi'];
+        const validAgents = CommandRouter.VALID_AGENTS;
         const resolvedAgent = validAgents.includes(resumeAgent)
             ? resumeAgent
             : this.config.defaultAgent;
@@ -804,6 +841,21 @@ export class CommandRouter {
         await this.bridge.updateCardInPlace(result.card, ctx);
         return { toast: { type: 'success', content: '' } };
     }
+    /**
+     * Handle active.page: paginate the /active run list in place.
+     * Mirrors handleResumePage — updates the same card, never sends a new one.
+     */
+    async handleActivePage(value, ctx) {
+        const rawOffset = Number(value.offset);
+        const offset = Number.isFinite(rawOffset) ? Math.max(0, Math.trunc(rawOffset)) : 0;
+        const alignedOffset = Math.floor(offset / ACTIVE_PAGE_SIZE) * ACTIVE_PAGE_SIZE;
+        const result = this.cmdActive([], ctx, alignedOffset);
+        if (!result.card) {
+            return { toast: { type: 'error', content: '当前没有正在进行中的任务' } };
+        }
+        await this.bridge.updateCardInPlace(result.card, ctx);
+        return { toast: { type: 'success', content: '' } };
+    }
     /**
      * Handle ls.browse: browse directory without switching cwd.
      */
@@ -886,11 +938,56 @@ export class CommandRouter {
         }
         // Delete the order
         this.orderStore.remove(orderId);
-        // Refresh the order list and update card in place
-        const result = this.cmdOrder([], ctx);
+        // Refresh the order list and update card in place, preserving current page
+        const currentOffset = Math.max(0, Math.trunc(Number(value.offset) || 0));
+        const result = this.cmdOrder([], ctx, currentOffset);
         await this.bridge.updateCardInPlace(result.card, ctx);
         return { toast: { type: 'success', content: '已删除指令' } };
     }
+    /**
+     * Handle order.page: paginate the /order list in place.
+     * Mirrors handleLsPage — updates the same card, never sends a new one.
+     */
+    async handleOrderPage(value, ctx) {
+        const offset = Math.max(0, Math.trunc(Number(value.offset) || 0));
+        // cmdOrder internally clamps stale/out-of-range offsets
+        const result = this.cmdOrder([], ctx, offset);
+        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
@@ -904,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.
      */
@@ -1323,7 +1449,7 @@ export class CommandRouter {
                 return await this.cmdReconnect();
             case 'config':
             case 'c':
-                return this.cmdConfig(args, ctx);
+                return await this.cmdConfig(args, ctx);
             case 'order':
             case 'o':
                 return this.cmdOrder(args, ctx);
@@ -1989,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': {
@@ -2022,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);
             }
@@ -2038,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
@@ -2045,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({
@@ -2071,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 },
+                                                },
+                                            ],
                                         },
                                     ],
                                 },
@@ -2084,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',
@@ -2115,7 +2380,7 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
         const entry = this.sessionStore.get(ctx.userId);
         const cwd = entry?.cwd;
         // Valid agent kinds for the /resume [agent] [N] feature
-        const VALID_AGENTS = ['claude', 'codex', 'opencode', 'pi', 'kimi'];
+        const VALID_AGENTS = CommandRouter.VALID_AGENTS;
         // Parse arguments: /resume [agent] [N] or /resume [sessionId] or /resume [agent] [sessionId]
         let agentKind = this.config.defaultAgent;
         let limit;
@@ -2470,7 +2735,7 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
         };
         return { card };
     }
-    cmdActive(_args, _ctx) {
+    cmdActive(_args, _ctx, offset = 0) {
         // List all active runs from bridge memory (not from file system scan)
         // New semantics (2026-07-20): only shows runs started by THIS bridge process
         const activeRuns = this.bridge.getActiveRuns();
@@ -2479,18 +2744,40 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
             return { text: '当前没有正在进行中的任务' };
         }
         // Build CardKit 2.0 card showing memory-based active runs
-        return this.buildActiveCardFromMemory(activeRuns, activeBashRuns);
+        return this.buildActiveCardFromMemory(activeRuns, activeBashRuns, offset);
     }
     /**
      * Build CardKit 2.0 /active card from bridge memory (not file system).
      * Shows only runs that were started by THIS bridge process.
+     * Paginates with ACTIVE_PAGE_SIZE (default 20) items per page.
      */
-    buildActiveCardFromMemory(activeRuns, activeBashRuns) {
+    buildActiveCardFromMemory(activeRuns, activeBashRuns, offset = 0) {
+        const totalCount = activeRuns.length + activeBashRuns.length;
+        const pageSize = ACTIVE_PAGE_SIZE;
+        const safeOffset = Math.max(0, Math.min(offset, Math.max(0, totalCount - 1)));
+        const totalPages = Math.max(1, Math.ceil(totalCount / pageSize));
+        const currentPage = Math.floor(safeOffset / pageSize) + 1;
+        // Slice: distribute offset across agent runs first, then bash runs
         const elements = [];
+        // Page info
+        if (totalPages > 1) {
+            elements.push({
+                tag: 'div',
+                text: {
+                    tag: 'lark_md',
+                    content: `**第 ${currentPage}/${totalPages} 页** （共 ${totalCount} 项）`,
+                },
+            });
+        }
+        let remaining = pageSize;
+        let skipped = safeOffset;
         // Agent runs section
-        if (activeRuns.length > 0) {
+        if (activeRuns.length > 0 && skipped < activeRuns.length && remaining > 0) {
             elements.push({ tag: 'div', text: { tag: 'lark_md', content: '## 🤖 Agent 任务' } });
-            for (const run of activeRuns) {
+            const start = skipped;
+            const end = Math.min(start + remaining, activeRuns.length);
+            for (let i = start; i < end; i++) {
+                const run = activeRuns[i];
                 const statusLabel = run.terminal === 'running' ? '运行中' : '处理中';
                 elements.push({
                     tag: 'div',
@@ -2513,11 +2800,19 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
                 });
                 elements.push({ tag: 'hr' });
             }
+            remaining -= end - start;
+            skipped = 0;
+        }
+        else {
+            skipped -= activeRuns.length;
         }
         // Bash runs section
-        if (activeBashRuns.length > 0) {
+        if (activeBashRuns.length > 0 && skipped < activeBashRuns.length && remaining > 0) {
             elements.push({ tag: 'div', text: { tag: 'lark_md', content: '## 💻 Bash 命令' } });
-            for (const run of activeBashRuns) {
+            const start = skipped;
+            const end = Math.min(start + remaining, activeBashRuns.length);
+            for (let i = start; i < end; i++) {
+                const run = activeBashRuns[i];
                 const statusLabel = run.terminal === 'running' ? '运行中' : '处理中';
                 elements.push({
                     tag: 'div',
@@ -2538,6 +2833,38 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
                 elements.push({ tag: 'hr' });
             }
         }
+        // Pagination buttons
+        if (totalPages > 1) {
+            const paginationButtons = [];
+            if (currentPage > 1) {
+                const prevOffset = (currentPage - 2) * pageSize;
+                paginationButtons.push({
+                    tag: 'button',
+                    text: { tag: 'plain_text', content: '◀ 上一页' },
+                    type: 'default',
+                    size: 'small',
+                    behaviors: [{ type: 'callback', value: { cmd: 'active.page', offset: prevOffset } }],
+                });
+            }
+            if (currentPage < totalPages) {
+                const nextOffset = currentPage * pageSize;
+                paginationButtons.push({
+                    tag: 'button',
+                    text: { tag: 'plain_text', content: '下一页 ▶' },
+                    type: 'primary',
+                    size: 'small',
+                    behaviors: [{ type: 'callback', value: { cmd: 'active.page', offset: nextOffset } }],
+                });
+            }
+            elements.push({
+                tag: 'column_set',
+                columns: paginationButtons.map((btn) => ({
+                    tag: 'column',
+                    width: 'auto',
+                    elements: [btn],
+                })),
+            });
+        }
         const card = {
             schema: '2.0',
             config: { wide_screen_mode: true },
@@ -2558,7 +2885,9 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
             return { text: '重连失败，请检查网络和配置' };
         }
     }
-    cmdConfig(args, ctx) {
+    async cmdConfig(args, ctx) {
+        // Ensure probe cache is populated before building the card.
+        await probeAllAgents();
         // Check if this is a direct set command: /config <key> <value>
         // Command-style set: immediate write to disk, clear pendingConfig
         if (args.length >= 2) {
@@ -2604,25 +2933,60 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
         // 使用 pendingConfig（若存在）或当前 config
         const displayConfig = this.pendingConfig ?? this.config;
         // 定义字段分组：defaultAgent 选择器 + 该 agent 的配置字段 + idle.watchdogMinutes +
-        // output/logging。stopGraceMs / claude.binary 等实现细节走 YAML，不在卡片暴露。
+        // output/logging。stopGraceMs 等实现细节走 YAML，不在卡片暴露。
         // 根据 defaultAgent 构建完整的 Agent 配置字段组
         // 使用 agent config builder 获取该 agent 的配置字段
         const defaultAgent = displayConfig.defaultAgent ?? 'claude';
         const configBuilder = getConfigBuilder(defaultAgent);
-        const agentConfigFields = configBuilder.buildFields(displayConfig);
-        // 使用共享渲染模块构建 tabs 和卡片
-        // 添加 defaultAgent 选择器作为第一个字段
-        agentConfigFields.unshift({
-            key: 'defaultAgent',
-            label: '默认 Agent',
-            type: 'select',
-            options: listRegisteredAgents(),
+        // Build defaultAgent selector with availability annotations.
+        // 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.
+        // 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);
+            return { text: { tag: 'plain_text', content: label }, value: kind };
         });
+        const selectedAgent = displayConfig.defaultAgent ?? 'claude';
+        const agentSelector = {
+            tag: 'column_set',
+            flex_mode: 'none',
+            columns: [
+                {
+                    tag: 'column',
+                    width: 'weighted',
+                    weight: 2,
+                    vertical_align: 'center',
+                    elements: [{ tag: 'div', text: { tag: 'lark_md', content: '默认 Agent' } }],
+                },
+                {
+                    tag: 'column',
+                    width: 'weighted',
+                    weight: 3,
+                    vertical_align: 'center',
+                    elements: [
+                        {
+                            tag: 'select_static',
+                            placeholder: { tag: 'plain_text', content: '请选择' },
+                            options: agentOptions,
+                            initial_option: selectedAgent,
+                            behaviors: [{ type: 'callback', value: { cmd: 'config.set', key: 'defaultAgent' } }],
+                        },
+                    ],
+                },
+            ],
+        };
+        // Agent config fields — no longer include defaultAgent as a ConfigField
+        // (it's rendered inline above with text/value separation).
+        const agentConfigFieldsNoSelector = configBuilder.buildFields(displayConfig);
         const tabs = [
             {
                 id: 'agent',
                 label: `🤖 ${agentDisplayName(defaultAgent)}`,
-                fields: agentConfigFields,
+                fields: agentConfigFieldsNoSelector,
             },
             {
                 id: 'idle',
@@ -2653,11 +3017,30 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
         ];
         // 使用共享渲染模块构建卡片
         const card = buildConfigCardFromTabs(tabs, displayConfig);
+        // Inject the agent selector as the first element in the agent tab section,
+        // right after the "**🤖 ..." header, so text/value can differ for uninstalled agents.
+        // NOTE: findIndex relies on the agent tab header starting with "**🤖" — if the
+        // tab label format changes, this fallback will fire and the selector moves to top.
+        const body = card.body;
+        if (body && Array.isArray(body.elements)) {
+            const headerIdx = body.elements.findIndex((el) => typeof el === 'object' &&
+                el !== null &&
+                el.tag === 'div' &&
+                el.text?.tag === 'lark_md' &&
+                (el.text?.content ?? '').startsWith('**🤖'));
+            if (headerIdx >= 0) {
+                body.elements.splice(headerIdx + 1, 0, agentSelector);
+            }
+            else {
+                getLogger().warn('[buildConfigCard] agent tab header not found, falling back to unshift');
+                body.elements.unshift(agentSelector);
+            }
+        }
         return { card };
     }
-    cmdOrder(args, _ctx) {
+    cmdOrder(args, _ctx, offset = 0) {
         const sub = args[0]?.toLowerCase();
-        // /order — list orders (simple CardKit 2.0 list, no tabs)
+        // /order — list orders (CardKit 2.0 with pagination)
         if (!sub || sub === 'list') {
             this.orderStore.reload();
             const allOrders = this.orderStore.get();
@@ -2666,8 +3049,17 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
                 elements.push({ tag: 'div', text: { tag: 'lark_md', content: '暂无指令' } });
             }
             else {
-                for (let i = 0; i < allOrders.length; i++) {
-                    const order = allOrders[i];
+                // Pagination calculations
+                const totalCount = allOrders.length;
+                const totalPages = Math.max(1, Math.ceil(totalCount / ORDER_PAGE_SIZE));
+                // Clamp offset to last page boundary to avoid empty pages
+                const maxOffset = Math.max(0, (totalPages - 1) * ORDER_PAGE_SIZE);
+                const safeOffset = Math.min(Math.max(offset, 0), maxOffset);
+                const currentPage = Math.floor(safeOffset / ORDER_PAGE_SIZE) + 1;
+                const pageOrders = allOrders.slice(safeOffset, safeOffset + ORDER_PAGE_SIZE);
+                const hasPagination = totalCount > ORDER_PAGE_SIZE;
+                for (let i = 0; i < pageOrders.length; i++) {
+                    const order = pageOrders[i];
                     const displayText = order.text.length > 100 ? order.text.slice(0, 97) + '...' : order.text;
                     // 文字在上方
                     elements.push({ tag: 'div', text: { tag: 'lark_md', content: displayText } });
@@ -2700,7 +3092,10 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
                                         type: 'danger',
                                         size: 'small',
                                         behaviors: [
-                                            { type: 'callback', value: { cmd: 'order.delete', orderId: order.id } },
+                                            {
+                                                type: 'callback',
+                                                value: { cmd: 'order.delete', orderId: order.id, offset: safeOffset },
+                                            },
                                         ],
                                     },
                                 ],
@@ -2708,10 +3103,81 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
                         ],
                     });
                     // 非最后一项，添加分隔线
-                    if (i < allOrders.length - 1) {
+                    if (i < pageOrders.length - 1) {
                         elements.push({ tag: 'hr' });
                     }
                 }
+                // Pagination bar (only shown when there are more items than ORDER_PAGE_SIZE)
+                if (hasPagination) {
+                    const hasPrev = safeOffset > 0;
+                    const hasNext = safeOffset + ORDER_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: 'order.page',
+                                                offset: safeOffset - ORDER_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: 'order.page',
+                                                offset: safeOffset + ORDER_PAGE_SIZE,
+                                            },
+                                        },
+                                    ],
+                                },
+                            ],
+                        });
+                    }
+                    elements.push({ tag: 'hr' });
+                    elements.push({ tag: 'column_set', columns: pageColumns });
+                }
             }
             return {
                 card: {