lark-remote 0.1.1 → 0.1.3

package/dist/router/index.js

@@ -13,6 +13,7 @@ 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 { 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,10 @@ 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 列表页大小；指令超过此数量时显示分页导航栏。 */
+const ORDER_PAGE_SIZE = 20;
 /** /resume 列表页内全量预取（readSessionContent）的行数上限；其余行用轻量 summary 兜底。 */
 const RESUME_CONTENT_PREFETCH = 5;
 /**
@@ -43,7 +48,7 @@ import { newSessionButton, agentDisplayName } from '../card/card-shared.js';
  * stop        — interrupt current run
  * ls.file     — send file only
  * ws.remove   — delete workspace alias only
- * resume.use  — set sessionId only
+ * resume.use  — set sessionId + agent for correct reader routing
  * help.*      — read-only help commands
  * order.delete — delete order only
  * order.exec is intercepted by index.ts at the enqueue boundary
@@ -61,6 +66,7 @@ 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.remove' ||
         cmd === 'resume.use' ||
         cmd === 'ws.use' ||
@@ -70,12 +76,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;
@@ -200,10 +209,10 @@ export class CommandRouter {
             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 +235,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 +271,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':
@@ -617,25 +630,57 @@ export class CommandRouter {
             await this.bridge.sendResult({ text: '⚠️ 缺少新消息内容' }, ctx);
             return;
         }
+        // RACE FIX: register the replacement closure BEFORE any await. The old
+        // code awaited updateMessagePreview first, yielding to the microtask
+        // queue. Between that yield and the later setTaskReplacement call, the
+        // queue chain could advance: the task's begin path would find no
+        // replacement → the original stale closure would run → the user saw
+        // "消息已更新" but the agent executed the old prompt.
+        //
+        // By registering synchronously first, the begin path always finds the
+        // replacement if the task starts during the subsequent await. Both
+        // setTaskReplacement and the begin-path consumption are synchronous, so
+        // there is no interleaving window.
+        //
+        // D3/Step3：复用原任务 binding（不重新快照）+ 恢复 cwdOverride。
+        const inputTask = this.bridge.getQueuedTask(workspace, messageId);
+        if (!inputTask) {
+            // Task already left the queue (began or was cancelled) before we could
+            // 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 });
+        });
         // Update the message preview (and editedMessage so handleQueueImmediate
         // re-enqueues the edited content instead of the stale original closure),
         // and build the updated queue card. Returning the card in the callback
         // response makes Feishu render it in place -- a toast-only response leaves
         // the card stuck in the edit state (Feishu keeps the pre-click card when
         // the callback response has no `card` field).
+        //
+        // After the synchronous replacement registration above, it is safe to
+        // await here: even if the queue chain advances and the replacement is
+        // consumed, the user-facing card update is best-effort (the executing card
+        // is updated by updateQueueCardToExecuting instead).
         const card = await this.bridge.updateMessagePreview(workspace, messageId, newMessage);
         if (!card) {
-            await this.bridge.sendResult({ text: '⚠️ 任务已不在队列中' }, ctx);
-            return;
+            // Task left the queue during the await (began or cancelled). The
+            // replacement was already consumed (begin path) or cleaned up
+            // (cancel/removeFromQueue path). Inform the user the edit didn't stick
+            // as a *card update*, but the replacement closure was already in effect.
+            if (this.bridge.hasTaskBegan(messageId)) {
+                return {
+                    toast: { type: 'success', content: '消息已更新（任务已开始执行）' },
+                };
+            }
+            return {
+                toast: { type: 'info', content: '任务已不在队列中，编辑未生效' },
+            };
         }
-        // 编辑即生效：自然轮到时（不经立即执行）也必须执行编辑后内容，而不是
-        // enqueue 时闭包冻结的旧指令。setTaskReplacement 原位替换该任务槽位的闭包，
-        // 保持队列位置；handleQueueImmediate 后续注册/刷新幂等覆盖。
-        // D3/Step3：复用原任务 binding（不重新快照）+ 恢复 cwdOverride。
-        const inputTask = this.bridge.getQueuedTask(workspace, messageId);
-        this.bridge.setTaskReplacement(workspace, messageId, async () => {
-            await this.handle(newMessage, ctx, { cwdOverride: workspace, binding: inputTask?.binding });
-        });
         return {
             toast: { type: 'success', content: '消息已更新' },
             card: { type: 'raw', data: card },
@@ -737,8 +782,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;
@@ -774,6 +818,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.
      */
@@ -856,11 +915,23 @@ 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.remove: remove the workspace alias and refresh the /ws list card
      * in place (mirrors handleOrderDelete). Without this the stale alias would
@@ -1293,7 +1364,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);
@@ -2085,7 +2156,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;
@@ -2440,7 +2511,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();
@@ -2449,18 +2520,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',
@@ -2483,11 +2576,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',
@@ -2508,6 +2609,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 },
@@ -2528,7 +2661,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) {
@@ -2574,25 +2709,58 @@ ${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.
+        const allAgents = listRegisteredAgents();
+        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',
@@ -2623,11 +2791,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();
@@ -2636,8 +2823,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 } });
@@ -2670,7 +2866,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 },
+                                            },
                                         ],
                                     },
                                 ],
@@ -2678,10 +2877,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: {

package/dist/router/utils.d.ts

@@ -5,6 +5,8 @@
 import type { ActiveRunSnapshot } from '../bridge/index.js';
 export interface SessionDisplayUsage {
     contextLength?: number;
+    /** 当前模型 context window 上限（仅 codex 提供）；用于渲染 "Context - X (Y%)"。 */
+    contextLimit?: number;
     compactCount?: number;
     cacheReadTokens?: number;
     cacheCreationTokens?: number;
@@ -18,6 +20,7 @@ export declare function activeRunUsage(activeRun: ActiveRunSnapshot | undefined)
  */
 export declare function formatUsageStats(usage?: {
     contextLength?: number;
+    contextLimit?: number;
     compactCount?: number;
     cacheReadTokens?: number;
     cacheCreationTokens?: number;

package/dist/router/utils.js

@@ -14,10 +14,18 @@ export function activeRunUsage(activeRun) {
 }
 // --- Extracted helpers for refactoring ---
 /**
- * Format number to K unit string, rounding to the nearest integer K
- * (e.g., 120000 → 120K, 1500 → 2K, 1950 → 2K). Values < 1000 are returned as-is.
+ * Format number to human-readable unit string.
+ * - >= 1M: one decimal, M suffix (e.g., 1200000 → 1.2M, 25000000 → 25M)
+ * - >= 1K: rounded to nearest integer K (e.g., 1500 → 2K, 120000 → 120K)
+ * - < 1K: as-is (e.g., 500 → "500")
  */
 function formatTokenK(n) {
+    if (n >= 1_000_000) {
+        const m = n / 1_000_000;
+        const rounded = Math.round(m * 10) / 10;
+        // Drop unnecessary ".0" for whole numbers (2.0M → 2M)
+        return rounded === Math.floor(rounded) ? `${Math.floor(rounded)}M` : `${rounded}M`;
+    }
     if (n >= 1000) {
         const k = Math.round(n / 1000);
         return `${k}K`;
@@ -40,7 +48,11 @@ export function formatUsageStats(usage, options) {
     }
     // 2. Context 长度
     if (usage?.contextLength !== undefined) {
-        lines.push(`Context - ${formatTokenK(usage.contextLength)}`);
+        const ctxLimit = usage.contextLimit;
+        const ctxPercent = ctxLimit !== undefined && ctxLimit > 0
+            ? ` (${Math.round((usage.contextLength / ctxLimit) * 100)}%)`
+            : '';
+        lines.push(`Context - ${formatTokenK(usage.contextLength)}${ctxPercent}`);
     }
     // 3. Compact 次数
     if (usage?.compactCount) {

package/dist/runner/claude/runner.d.ts

@@ -12,7 +12,6 @@ export declare class ClaudeRunner extends SpawningRunner implements IAgentRunner
     private defaultEffort;
     private defaultSettings?;
     constructor(opts: {
-        binary?: string;
         model?: string;
         effort?: string;
         settings?: string;

package/dist/runner/claude/runner.js

@@ -19,7 +19,6 @@ export class ClaudeRunner extends SpawningRunner {
     defaultSettings;
     constructor(opts) {
         super({
-            binary: opts.binary ?? 'claude',
             pidDir: opts.pidDir,
             workspace: opts.workspace,
             stopGraceMs: opts.stopGraceMs,
@@ -27,6 +26,7 @@ export class ClaudeRunner extends SpawningRunner {
             pidFilePrefix: 'claude',
             logTag: 'claude-runner',
         });
+        this.binary = 'claude';
         this.defaultModel = opts.model ?? 'claude-opus-4-8';
         this.defaultEffort = opts.effort ?? 'medium';
         this.defaultSettings = opts.settings;

package/dist/runner/codex/runner.d.ts

@@ -26,8 +26,6 @@ import type { AgentKind, AgentSessionReader, AgentEvent, AgentRunner, AgentStatu
 import type { SpawnOptions } from '../types.js';
 import { SpawningRunner, type RunnerTranslator } from '../common/spawning-runner.js';
 interface CodexExecRunnerOptions {
-    /** Path to codex binary. Default: 'codex' (in PATH). */
-    binary?: string;
     /** Model override. Omitted → codex reads from its config.toml. */
     model?: string;
     /** Model provider override. Omitted → codex reads from its config.toml. */