lark-remote 0.1.4 → 0.1.6

package/dist/index.js

@@ -3,7 +3,7 @@ import { resolveAgentChoices, } from './runner/index.js';
 import { ensureConfig } from './config/wizard.js';
 import { parseCliArgs, resolveConfigDir, setConfigDir, printHelp, printVersion, } from './config/dir.js';
 import { FeishuConnector } from './connector/index.js';
-import { ClaudeRunner, CodexExecRunner, OpencodeExecRunner, PiRunner, KimiRunner, } from './runner/index.js';
+import { ClaudeRunner, createCodexRunner, OpencodeExecRunner, PiRunner, KimiRunner, } from './runner/index.js';
 import { AgentRegistry } from './runner/registry.js';
 import { probeAllAgents } from './runner/probe.js';
 import { SessionReaderRegistry, SessionStore } from './session/index.js';
@@ -16,15 +16,16 @@ import { StartupContactStore, sendStartupHello } from './startup-contact.js';
 import { OwnerBinder, formatPinGuidance } from './binder.js';
 import { InstanceAlreadyRunningError, InstanceLock } from './instance-lock.js';
 import { spawnReplacementBridge, waitForPreviousInstance } from './restart.js';
+import { checkLatestVersion, isNewer, runInstallLatest, formatUpdateHint } from './update/index.js';
 import { classifyRejection } from './error-classification.js';
 import { WorkspaceStore } from './workspace/index.js';
 import { markdownDiv } from './card/collapsible.js';
 import { sessionEventPanel } from './router/card-helpers.js';
-import { newSessionButton, agentDisplayName } from './card/card-shared.js';
+import { newSessionButton, resumeCompactButton, agentDisplayName } from './card/card-shared.js';
 import path from 'node:path';
 import fs from 'node:fs';
 /** Send auto-resume card for a restored session */
-async function sendAutoResumeCard(connector, contact, cwd, session, state) {
+async function sendAutoResumeCard(connector, contact, cwd, session, state, compactSupported = false) {
     if (!contact.userId)
         return;
     const recipient = contact.chatId ?? contact.userId;
@@ -63,17 +64,21 @@ async function sendAutoResumeCard(connector, contact, cwd, session, state) {
         const usageStr = formatUsageStats(state.usage);
         elements.push(markdownDiv(usageStr));
     }
-    // Add new session button - use column_set+column (div+elements not supported in 2.0)
-    const newSessionBtn = newSessionButton();
+    // Add action buttons - use column_set+column (div+elements not supported in 2.0)
+    const actionButtons = [];
+    // Compact 按钮：仅 codex app-server 模式（runner 有 runCompact）且未在跑。
+    // 启动自动恢复时不会存在该会话的 activeRun，直接渲染。
+    if (compactSupported) {
+        actionButtons.push(resumeCompactButton(session.sessionId, state.agentKind ?? 'codex'));
+    }
+    actionButtons.push(newSessionButton());
     elements.push({
         tag: 'column_set',
-        columns: [
-            {
-                tag: 'column',
-                width: 'auto',
-                elements: [newSessionBtn],
-            },
-        ],
+        columns: actionButtons.map((btn) => ({
+            tag: 'column',
+            width: 'auto',
+            elements: [btn],
+        })),
     });
     const card = {
         schema: '2.0',
@@ -162,15 +167,17 @@ function initializeRunner(config, configDir, cliArgs) {
             workspace: ws,
         });
     });
-    // Register CodexExecRunner (codex exec --json, approval_policy=never).
-    // Factory reads latest config from container.current so runtime config changes
-    // (reasoningEffort, model, etc.) take effect after bridge.setConfig() + clearRunners().
+    // Register Codex runner. Factory reads latest config from container.current
+    // so runtime config changes (serviceMode, model, sandbox, approvalPolicy,
+    // reasoningEffort, etc.) take effect after bridge.setConfig() + clearRunners().
+    // serviceMode=app-server → CodexAppServerRunner (persistent connection with
+    // approval + sandbox); otherwise CodexExecRunner (codex exec --json).
     const codexSessionReader = new CodexSessionReader({ codexHome: process.env.CODEX_HOME });
     agentRegistry.register('codex', (ws) => {
         const container = agentRegistry.getConfigContainer();
         const latestConfig = container?.current ?? config;
         const codexConfig = getAgentConfig(latestConfig, 'codex');
-        return new CodexExecRunner({
+        return createCodexRunner({
             model: codexConfig?.model,
             modelProvider: codexConfig?.modelProvider,
             reasoningEffort: codexConfig?.reasoningEffort,
@@ -178,6 +185,13 @@ function initializeRunner(config, configDir, cliArgs) {
             pidDir: configDir,
             workspace: ws,
             sessionReader: codexSessionReader,
+            serviceMode: codexConfig?.serviceMode,
+            sandbox: codexConfig?.sandbox,
+            approvalPolicy: codexConfig?.approvalPolicy,
+            appServerBinary: codexConfig?.appServer?.binary,
+            appServerRequestTimeoutMs: codexConfig?.appServer?.requestTimeoutMs,
+            appServerIdleTtlMs: codexConfig?.appServer?.idleTtlMs,
+            appServerTurnIdleTimeoutMinutes: codexConfig?.appServer?.turnIdleTimeoutMinutes,
         });
     });
     // Register OpencodeExecRunner (run mode)
@@ -444,7 +458,7 @@ function setupMessageHandlers(connector, router, bridge, sessionStore, workspace
         if (actionValue.cmd === 'stop') {
             if (!actionValue.runId) {
                 logger.warn('[control] ignored stop card action without runId');
-                // Card button clicks must have visible feedback (AGENTS.md 红线：卡片按钮
+                // Card button clicks must have visible feedback (design constraint: card button
                 // 点击必须有可见反馈，见 design.md §6.2)。
                 void bridge
                     .sendResult({ text: '⚠️ 无效的停止请求，缺少必要信息' }, { userId, chatId, messageId })
@@ -478,11 +492,15 @@ function setupMessageHandlers(connector, router, bridge, sessionStore, workspace
             inputValue: action.raw?.action?.input_value ??
                 action.action.input_value,
         };
-        // queue.input 和 config.save 返回 CardActionResponse toast 给点击用户即时反馈。
-        // 必须直接返回值 -- enqueueImmediate / enqueueConfigAction 是 fire-and-forget，
-        // 会吞掉返回值。queue.input 只做一次卡片更新 + toast，快速且不需要串行队列序列化。
-        // config.save 内部已有 enqueueConfigAction 串行化保证，但返回值需要直接返回给飞书。
-        if (actionValue.cmd === 'queue.input' || actionValue.cmd === 'config.save') {
+        // queue.input / config.save / approval.respond / approval.toggle 返回
+        // CardActionResponse toast 给点击用户即时反馈。必须直接返回值 --
+        // enqueueImmediate / enqueueConfigAction 是 fire-and-forget，会吞掉返回值。
+        // 审批响应尤其不能落串行队列：run 任务占用队列头直到 turn 结束，审批响应
+        // 排在后面会形成死锁（run 不结束不执行、run 结束 coordinator 已删响应空转）。
+        if (actionValue.cmd === 'queue.input' ||
+            actionValue.cmd === 'config.save' ||
+            actionValue.cmd === 'approval.respond' ||
+            actionValue.cmd === 'approval.toggle') {
             return router.handleCardAction(fullValue, { userId, chatId, messageId });
         }
         // order.exec → equivalent queued message (Plan A): resolve the order text
@@ -513,6 +531,8 @@ function setupMessageHandlers(connector, router, bridge, sessionStore, workspace
                     chatId,
                     messageId,
                     messagePreview: `card action: ${actionValue.cmd}`,
+                    // Compact 是单向操作，排队卡不允许编辑（编辑预览无意义）。
+                    editable: actionValue.cmd !== 'codex.compact' && actionValue.cmd !== 'resume.compact',
                 },
             });
         }
@@ -531,6 +551,32 @@ async function main() {
         printVersion();
         process.exit(0);
     }
+    // --update: upgrade to latest version and exit (for cron/script automation)
+    if (cliArgs.update) {
+        // --update 在 acquireLock 之前执行；先解析 configDir 并初始化 logger，
+        // 让版本检查的日志落到正确目录（默认 ~/.lark-remote 或 --config-dir 指定）。
+        const updateConfigDir = resolveConfigDir(cliArgs.configDir);
+        initLogger({ dir: path.join(updateConfigDir, 'logs') });
+        try {
+            const { current, latest } = await checkLatestVersion();
+            if (!isNewer(current, latest)) {
+                console.log(`Already up to date: ${current}`);
+                process.exit(0);
+            }
+            console.log(`Updating ${current} → ${latest} ...`);
+            const result = await runInstallLatest();
+            if (!result.success) {
+                console.error(`Update failed: ${result.error}`);
+                process.exit(1);
+            }
+            console.log(`✅ Updated to ${latest}. Restart lark-remote to use the new version.`);
+            process.exit(0);
+        }
+        catch (err) {
+            console.error(`Update failed: ${err.message}`);
+            process.exit(1);
+        }
+    }
     const { config, configDir, logger, instanceLock } = await initializeCliAndConfig();
     // Restart handoff: if spawned as a /restart replacement, wait for the old
     // bridge to die (and release the instance lock) before acquiring it.
@@ -574,6 +620,8 @@ async function main() {
         ordersPath: path.join(configDir, 'orders.json'),
         restartSpawner: () => spawnReplacementBridge(path.join(configDir, 'logs')),
         sessionReaderRegistry,
+        devMode: cliArgs.dev,
+        updateCachePath: path.join(configDir, 'update-cache.json'),
     });
     setupMessageHandlers(connector, router, bridge, sessionStore, workspaceStore, binder, logger, config);
     try {
@@ -586,6 +634,27 @@ async function main() {
     if (binder.isBound()) {
         // 仅已绑定时发送启动通知；未绑定时不打扰（PIN 引导已在控制台输出）
         await sendStartupHello(connector, startupContactStore, { dev: cliArgs.dev });
+        // 启动时静默检查版本（由 checkUpdateOnStartup 控制，默认关闭）
+        if (config.checkUpdateOnStartup) {
+            void (async () => {
+                try {
+                    const cachePath = path.join(configDir, 'update-cache.json');
+                    const { current, latest } = await checkLatestVersion({ cachePath });
+                    const hint = formatUpdateHint(current, latest);
+                    if (hint) {
+                        const contact = startupContactStore.getContact();
+                        const recipient = contact?.chatId ?? contact?.userId;
+                        if (recipient) {
+                            await connector.sendWithRetry(recipient, { text: hint });
+                        }
+                    }
+                }
+                catch (err) {
+                    // Non-fatal: startup check failure must not crash the bridge
+                    logger.warn(`[startup] update check failed: ${err.message}`);
+                }
+            })();
+        }
     }
     // Auto-restore: resume the persisted sessionId if available
     const restoredContact = startupContactStore.getContact();
@@ -613,7 +682,10 @@ async function main() {
                         recap: content.recap,
                         displayTitle: content.displayTitle,
                         agentKind: config.defaultAgent,
-                    });
+                    }, 
+                    // Compact 仅 codex app-server 模式有实现（runner.runCompact）。
+                    config.defaultAgent === 'codex' &&
+                        getAgentConfig(config, 'codex')?.serviceMode === 'app-server');
                 }
                 catch (err) {
                     getLogger().warn('[startup] sendAutoResumeCard failed:', err);

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

@@ -2,7 +2,7 @@
  * Codex config builder — builds fields and handles field changes for Codex agent.
  */
 import type { AgentConfigCardBuilder, ConfigField } from './types.js';
-import type { AppConfig } from '../../config/index.js';
+import { type AppConfig } from '../../config/index.js';
 export declare class CodexConfigBuilder implements AgentConfigCardBuilder {
     buildFields(displayConfig: AppConfig): ConfigField[];
     handleFieldChange(key: string, value: unknown, config: AppConfig): Array<{

package/dist/router/config/codex.js

@@ -2,6 +2,7 @@
  * Codex config builder — builds fields and handles field changes for Codex agent.
  */
 import { loadCodexConfig, getReasoningEffortOptions, getDefaultReasoningEffort, } from '../../config/codex-config.js';
+import { DEFAULT_TURN_IDLE_TIMEOUT_MINUTES } from '../../config/index.js';
 export class CodexConfigBuilder {
     buildFields(displayConfig) {
         const fields = [];
@@ -43,6 +44,54 @@ export class CodexConfigBuilder {
             options: getReasoningEffortOptions(currentCodexModel),
             currentValue: currentReasoningEffort,
         });
+        // Service mode (exec vs app-server)
+        const currentServiceMode = displayConfig.agents?.codex?.serviceMode ?? 'exec';
+        fields.push({
+            key: 'agents.codex.serviceMode',
+            label: '运行模式',
+            type: 'select',
+            options: ['exec', 'app-server'],
+            currentValue: currentServiceMode,
+        });
+        // 审批策略与沙箱模式仅 app-server 模式可配置（CodexAppServerRunner 读取）；
+        // exec 模式在 runner 层固定 `--sandbox danger-full-access` +
+        // `approval_policy="never"`（src/runner/codex/argv.ts），卡片不暴露选项，
+        // 只用说明行把默认语义呈现给用户。
+        if (currentServiceMode === 'app-server') {
+            // Approval policy (Codex 官方 AskForApproval 标准值；on-request 为 codex 默认)
+            const currentApprovalPolicy = displayConfig.agents?.codex?.approvalPolicy ?? 'on-request';
+            fields.push({
+                key: 'agents.codex.approvalPolicy',
+                label: '审批策略',
+                type: 'select',
+                options: ['untrusted', 'on-request', 'never'],
+                currentValue: currentApprovalPolicy,
+            });
+            // Sandbox mode (Codex 官方 SandboxMode 标准值)
+            const currentSandbox = displayConfig.agents?.codex?.sandbox ?? 'danger-full-access';
+            fields.push({
+                key: 'agents.codex.sandbox',
+                label: '沙箱模式',
+                type: 'select',
+                options: ['read-only', 'workspace-write', 'danger-full-access'],
+                currentValue: currentSandbox,
+            });
+            const currentTurnIdleTimeoutMinutes = displayConfig.agents?.codex?.appServer?.turnIdleTimeoutMinutes ??
+                DEFAULT_TURN_IDLE_TIMEOUT_MINUTES;
+            fields.push({
+                key: 'agents.codex.appServer.turnIdleTimeoutMinutes',
+                label: 'Turn 空闲超时(分钟, 0关闭)',
+                type: 'input',
+                currentValue: String(currentTurnIdleTimeoutMinutes),
+            });
+        }
+        else {
+            fields.push({
+                key: 'agents.codex.modeNote',
+                label: '命令行模式固定为完全访问（danger-full-access）且无需审批（approval never），不提供审批策略/沙箱配置',
+                type: 'note',
+            });
+        }
         return fields;
     }
     handleFieldChange(key, value, config) {

package/dist/router/config/common/render.js

@@ -19,6 +19,10 @@ function buildFieldElements(fields, displayConfig) {
         else if (field.type === 'select' && field.options) {
             elements.push(buildSelectElement(field, currentValue));
         }
+        else if (field.type === 'note') {
+            // 纯说明行：无 config.* 回调，只渲染 label 为 markdown 文本。
+            elements.push({ tag: 'div', text: { tag: 'lark_md', content: field.label } });
+        }
         else {
             elements.push(buildInputElement(field, currentValue));
         }

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

@@ -16,13 +16,3 @@ 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,21 +35,4 @@ 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/config/types.d.ts

@@ -9,7 +9,7 @@ import type { AppConfig } from '../../config/index.js';
 export interface ConfigField {
     key: string;
     label: string;
-    type: 'boolean' | 'select' | 'input';
+    type: 'boolean' | 'select' | 'input' | 'note';
     /** For select type: the list of options shown in the dropdown. */
     options?: readonly string[];
     /** Override the currentValue shown in the card (takes priority over getConfigValue). */

package/dist/router/index.d.ts

@@ -2,6 +2,7 @@ import type { SessionStore, SessionReaderRegistry } from '../session/index.js';
 import type { AppConfig } from '../config/index.js';
 import type { Bridge } from '../bridge/index.js';
 import type { AgentBinding } from '../bridge/queue-manager.js';
+import { type VersionCheckResult, type InstallResult } from '../update/index.js';
 interface CommandContext {
     userId: string;
     chatId: string;
@@ -59,6 +60,18 @@ export interface CardActionPayload {
     /** CardKit 2.0 input 组件自带提交图标触发回调时回传的输入值 */
     inputValue?: string;
     orderId?: string;
+    /** Approval request ID for approval card actions. */
+    requestId?: number | string;
+    /** Decision for approval.respond (e.g. 'accept', 'decline', 'cancel'). */
+    decision?: string;
+    /** Scope for acceptForSession: 'turn' | 'session'. */
+    scope?: 'turn' | 'session';
+    /** Unique nonce to prevent duplicate processing. */
+    nonce?: string;
+    /** Permission item ID for approval.toggle. */
+    permId?: string;
+    /** Desired selection state for approval.toggle (card renders !current). */
+    selected?: boolean;
 }
 /**
  * Response a cardAction handler may return to give the clicking user native
@@ -91,6 +104,12 @@ export declare class CommandRouter {
      */
     private restartSpawner?;
     private idleTimeoutMs;
+    /** Dev mode flag: --dev means the bridge was started from source (bun src/index.ts). */
+    private devMode;
+    /** Cache file for version checks (<configDir>/update-cache.json). */
+    private updateCachePath?;
+    /** Injected update functions (for testability; defaults to real implementation). */
+    private updateFns;
     private pendingConfig;
     /**
      * Monotonic counter minting unique internal keys for order.exec enqueue
@@ -135,6 +154,19 @@ export declare class CommandRouter {
         idleTimeoutMs?: number;
         /** Session reader registry (required). */
         sessionReaderRegistry: SessionReaderRegistry;
+        /** Dev mode: bridge was started from source (--dev flag). */
+        devMode?: boolean;
+        /** Version check cache path (<configDir>/update-cache.json). */
+        updateCachePath?: string;
+        /** Override update functions for testability. */
+        updateFns?: {
+            checkLatestVersion?: (opts?: {
+                cachePath?: string;
+                bypassCache?: boolean;
+            }) => Promise<VersionCheckResult>;
+            isNewer?: (current: string, latest: string) => boolean | null;
+            runInstallLatest?: () => Promise<InstallResult>;
+        };
     });
     /**
      * Resolve the active session reader for the current defaultAgent.
@@ -153,6 +185,12 @@ export declare class CommandRouter {
      * Validates payload and dispatches to the corresponding command.
      */
     handleCardAction(value: CardActionPayload, ctx: CommandContext): Promise<CardActionResponse | void>;
+    /**
+     * Handle approval-related card actions.
+     * Routes to the appropriate bridge method based on value.cmd.
+     * Returns a toast response for immediate user feedback.
+     */
+    private handleApprovalAction;
     /**
      * Handle queue.cancel: remove this message from the queue.
      */
@@ -307,7 +345,7 @@ export declare class CommandRouter {
      *
      * @param updates 以 config 路径形式给出的变更 key（卡片路径来自 diffConfig；
      *   直写路径传 mapAgentKey(key)，保证 pi./codex./opencode./kimi. 命中 agents.*）。
-     * @returns defaultAgent 切换时的通知文案（未切换返回 undefined）
+     * @returns 结构化切换结果（含 notice 文案 + 新 agent/sessionId 信息）
      */
     private propagateConfigSave;
     private executeCommand;
@@ -317,6 +355,13 @@ export declare class CommandRouter {
     private cmdStop;
     private cmdExit;
     private cmdRestart;
+    /**
+     * /update: check for newer version and upgrade if available.
+     * /update check: only check, don't upgrade.
+     *
+     * Flow: check version → if newer, install → report success (no auto-restart).
+     */
+    private cmdUpdate;
     private cmdNew;
     private cmdCd;
     private readSessionDisplayState;
@@ -330,6 +375,21 @@ export declare class CommandRouter {
     private switchCwdAndNotify;
     /** Build card for auto-resumed session with new session button */
     private buildAutoResumeCard;
+    /**
+     * Build card for config.save agent switch.
+     * When the new agent has a restored session, renders a Resume card (mirrors
+     * buildAutoResumeCard) with session history + stop/new buttons.
+     * When the session was cleared, renders a compact notice card instead.
+     */
+    private buildConfigSwitchCard;
+    /**
+     * Whether a session of the given agent kind can be compacted from a resume
+     * card. Compact (thread/compact/start) is only implemented by the codex
+     * app-server runner (`runCompact`), so the button is gated on
+     * `serviceMode === 'app-server'` — exec mode spawns a fresh CLI per message
+     * and has no persistent session to compact.
+     */
+    private canCompactSession;
     private static readonly LS_PAGE_SIZE;
     private cmdLs;
     private cmdWs;