lark-remote 0.1.0

package/dist/router/config/kimi.js

@@ -0,0 +1,63 @@
+/**
+ * Kimi config builder — builds fields and handles field changes for Kimi agent.
+ */
+import { loadKimiConfig, KIMI_THINKING_EFFORTS, FALLBACK_EFFORTS, } from '../../config/kimi-config.js';
+export class KimiConfigBuilder {
+    buildFields(displayConfig) {
+        const fields = [];
+        // Kimi 配置字段 - 动态从 `kimi provider list --json` 获取模型列表
+        const kimiCfg = loadKimiConfig();
+        const currentModel = displayConfig.agents?.kimi?.model ?? kimiCfg.currentModel;
+        const currentThinking = displayConfig.agents?.kimi?.thinkingEffort ?? 'max';
+        fields.push({
+            key: 'agents.kimi.model',
+            label: '使用模型',
+            type: 'select',
+            options: kimiCfg.modelOptions,
+            currentValue: currentModel,
+        });
+        fields.push({
+            key: 'agents.kimi.thinkingEffort',
+            label: '推理强度',
+            type: 'select',
+            // Layer 3: Double-defense filter - ensure only valid options show in UI
+            // (Layer 2 already filters, but this is the last line of defense)
+            options: (kimiCfg.modelEfforts[currentModel] ?? [...FALLBACK_EFFORTS]).filter((e) => KIMI_THINKING_EFFORTS.includes(e)),
+            currentValue: currentThinking,
+        });
+        return fields;
+    }
+    handleFieldChange(key, value, config) {
+        const patches = [{ key, value }];
+        // model 变更时，若当前档位不被新模型支持，重置到新模型支持的合法档位
+        if (key === 'agents.kimi.model' && typeof value === 'string') {
+            const effortPatch = this.thinkingEffortPatchForModel(config, value);
+            if (effortPatch)
+                patches.push(effortPatch);
+        }
+        return patches;
+    }
+    /**
+     * 切到 newModel 后的档位补丁（参照 codex effortPatchForModel 语义）：
+     * - 当前档位仍被新模型支持 → 不产出补丁；
+     * - 否则优先 modelEfforts[newModel] 中位 (len-1)/2；
+     * - 列表为空才用 modelDefaultEfforts[newModel]；
+     * - 两者皆无 → FALLBACK_EFFORTS 中位；仍无则 undefined（router setNestedValue
+     *   对 undefined 做键删除）。
+     */
+    thinkingEffortPatchForModel(config, newModel) {
+        const kimiCfg = loadKimiConfig();
+        const currentEffort = config.agents?.kimi?.thinkingEffort;
+        const supported = kimiCfg.modelEfforts[newModel] ?? [...FALLBACK_EFFORTS];
+        if (currentEffort && supported.includes(currentEffort))
+            return null;
+        const middle = supported[Math.floor((supported.length - 1) / 2)];
+        let newEffort = middle;
+        if (!newEffort)
+            newEffort = kimiCfg.modelDefaultEfforts?.[newModel];
+        if (!newEffort)
+            newEffort = FALLBACK_EFFORTS[Math.floor((FALLBACK_EFFORTS.length - 1) / 2)];
+        return { key: 'agents.kimi.thinkingEffort', value: newEffort };
+    }
+}
+//# sourceMappingURL=kimi.js.map

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

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

package/dist/router/config/opencode.js

@@ -0,0 +1,44 @@
+/**
+ * OpenCode config builder — builds fields and handles field changes for OpenCode agent.
+ */
+import { loadOpencodeConfig } from '../../config/opencode-config.js';
+export class OpencodeConfigBuilder {
+    buildFields(displayConfig) {
+        const fields = [];
+        // 从 opencode models 命令动态读取 provider 和 model
+        const opencodeCfg = loadOpencodeConfig();
+        const providerNames = opencodeCfg.providerNames;
+        // 根据 displayConfig 中已选的 provider 过滤 model 选项
+        const currentProvider = displayConfig.agents?.opencode?.providerID;
+        const modelOptions = opencodeCfg.modelOptions(currentProvider);
+        fields.push({
+            key: 'agents.opencode.providerID',
+            label: 'Provider',
+            type: 'select',
+            options: providerNames,
+        });
+        fields.push({
+            key: 'agents.opencode.modelID',
+            label: '使用模型',
+            type: 'select',
+            options: modelOptions,
+        });
+        return fields;
+    }
+    handleFieldChange(key, value, config) {
+        const patches = [];
+        patches.push({ key, value });
+        // provider 变更时，重置 model 为新 provider 的首个模型
+        if (key === 'agents.opencode.providerID' && typeof value === 'string') {
+            const opencodeCfg = loadOpencodeConfig();
+            const newModelOptions = opencodeCfg.modelOptions(value);
+            const currentModel = config.agents?.opencode?.modelID;
+            const currentModelIsValid = newModelOptions.some((m) => m === currentModel);
+            if (!currentModelIsValid && newModelOptions.length > 0) {
+                patches.push({ key: 'agents.opencode.modelID', value: newModelOptions[0] });
+            }
+        }
+        return patches;
+    }
+}
+//# sourceMappingURL=opencode.js.map

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

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

package/dist/router/config/pi.js

@@ -0,0 +1,50 @@
+/**
+ * Pi config builder — builds fields and handles field changes for Pi agent.
+ */
+import { loadPiConfig, getPiModelOptions } from '../../config/pi-config.js';
+import { PI_THINKING_LEVELS } from '../../config/index.js';
+export class PiConfigBuilder {
+    buildFields(displayConfig) {
+        const fields = [];
+        const piCfg = loadPiConfig();
+        const providerOptions = piCfg.providerNames;
+        // 根据 displayConfig 中已选的 provider 过滤 model 选项
+        const currentProvider = displayConfig.agents?.pi?.provider;
+        const modelOptions = piCfg.modelOptions(currentProvider);
+        fields.push({
+            key: 'agents.pi.provider',
+            label: 'Pi Provider',
+            type: 'select',
+            options: providerOptions,
+        });
+        fields.push({
+            key: 'agents.pi.model',
+            label: '使用模型',
+            type: 'select',
+            options: modelOptions,
+        });
+        fields.push({
+            key: 'agents.pi.thinking',
+            label: '思考级别',
+            type: 'select',
+            // Use constant for thinking options (SSOT)
+            options: PI_THINKING_LEVELS,
+        });
+        return fields;
+    }
+    handleFieldChange(key, value, config) {
+        const patches = [];
+        patches.push({ key, value });
+        // provider 变更时，重置 model 为新 provider 的首个模型
+        if (key === 'agents.pi.provider' && typeof value === 'string') {
+            const newModelOptions = getPiModelOptions(value);
+            const currentModel = config.agents?.pi?.model;
+            const currentModelIsValid = newModelOptions.some((m) => m === currentModel);
+            if (!currentModelIsValid && newModelOptions.length > 0) {
+                patches.push({ key: 'agents.pi.model', value: newModelOptions[0] });
+            }
+        }
+        return patches;
+    }
+}
+//# sourceMappingURL=pi.js.map

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

@@ -0,0 +1,43 @@
+/**
+ * Config card builder interface — per-agent contract for /config card fields.
+ *
+ * Each agent implements this to declare its own config fields and change handlers.
+ * The router delegates to `getConfigBuilder(agent)` instead of a giant switch-case.
+ */
+import type { AppConfig } from '../../config/index.js';
+/** A single field descriptor in the /config card. */
+export interface ConfigField {
+    key: string;
+    label: string;
+    type: 'boolean' | 'select' | 'input';
+    /** 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). */
+    currentValue?: string | boolean;
+}
+/**
+ * Builder that provides config fields and handles field changes for a specific agent.
+ *
+ * Lifecycle:
+ * 1. `buildFields()` is called when the card is rendered (on open, on save, on any field change).
+ * 2. `handleFieldChange()` is called when a config.set or config.input modifies a field
+ *    that belongs to this agent. It returns a list of {key, value} patches to apply
+ *    to pendingConfig (side-effect-free: the caller applies the patches).
+ */
+export interface AgentConfigCardBuilder {
+    /** Build config fields for this agent, given the current display config. */
+    buildFields(displayConfig: AppConfig): ConfigField[];
+    /**
+     * Handle a field change for this agent.
+     *
+     * @param key   - The field key (e.g. 'agents.codex.modelProvider')
+     * @param value - The new value (string for select/input, already toggled for boolean)
+     * @param config - The current pendingConfig (read-only reference for deriving dependent values)
+     * @returns An array of {key, value} patches to apply to pendingConfig.
+     *          The caller (router) applies these via setNestedValue.
+     */
+    handleFieldChange(key: string, value: unknown, config: AppConfig): Array<{
+        key: string;
+        value: unknown;
+    }>;
+}

package/dist/router/config/types.js

@@ -0,0 +1,8 @@
+/**
+ * Config card builder interface — per-agent contract for /config card fields.
+ *
+ * Each agent implements this to declare its own config fields and change handlers.
+ * The router delegates to `getConfigBuilder(agent)` instead of a giant switch-case.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/router/index.d.ts

@@ -0,0 +1,318 @@
+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';
+interface CommandContext {
+    userId: string;
+    chatId: string;
+    messageId: string;
+}
+interface CommandResult {
+    text?: string;
+    markdown?: string;
+    card?: object;
+}
+/**
+ * Card-action commands that must run with enqueue({ immediate: true }).
+ * These bypass the serial queue and execute immediately.
+ *
+ * ws.use   — /ws list card "使用 <name>"
+ * queue.immediate — queue card "立即执行" button (§9.6)
+ * queue.cancel    — queue card "撤销" button
+ * queue.diagnose  — queue card "诊断" button
+ *
+ * §9.19: Extended to cover all control-only actions that never spawn Claude:
+ * new-session — clear sessionId only
+ * stop        — interrupt current run
+ * ls.file     — send file only
+ * ws.remove   — delete workspace alias only
+ * resume.use  — set sessionId only
+ * help.*      — read-only help commands
+ * order.delete — delete order only
+ * order.exec is intercepted by index.ts at the enqueue boundary
+ * (resolveOrderExecForQueue → router.handle), never reaching this dispatcher.
+ */
+export declare function isImmediateAction(cmd: string): boolean;
+/** Payload carried by a card button click. */
+export interface CardActionPayload {
+    cmd: string;
+    path?: string;
+    name?: string;
+    runId?: string;
+    sessionId?: string;
+    cwd?: string;
+    workspace?: string;
+    messageId?: string;
+    userId?: string;
+    chatId?: string;
+    key?: string;
+    /** /ls 与 /resume 列表分页起点（条目数）。 */
+    offset?: number;
+    /** /resume 列表的 agent 类型。 */
+    agent?: string;
+    /** /resume 列表页大小覆盖。 */
+    pageSize?: number;
+    option?: string;
+    formValue?: Record<string, unknown>;
+    /** CardKit 2.0 input 组件自带提交图标触发回调时回传的输入值 */
+    inputValue?: string;
+    orderId?: string;
+}
+/**
+ * Response a cardAction handler may return to give the clicking user native
+ * immediate feedback (mirrors the SDK's CardActionResponse, passed through by
+ * the connector). Currently only `toast` is used. Returning void/undefined
+ * means "no immediate response" (original behavior). The index signature
+ * keeps it assignable to the SDK's loose `Record<string, unknown>`.
+ */
+interface CardActionResponse {
+    toast?: {
+        type: 'success' | 'info' | 'error' | 'warning' | 'loading';
+        content: string;
+    };
+    [key: string]: unknown;
+}
+export declare class CommandRouter {
+    private sessionStore;
+    private bridge;
+    private config;
+    private configPath;
+    private workspaceStore;
+    private orderStore;
+    private exitHandler;
+    private pendingExit;
+    /**
+     * Spawns the detached replacement bridge process (same argv/config dir) and
+     * returns its pid. Injected from index.ts; /restart is unavailable without it.
+     */
+    private restartSpawner?;
+    private idleTimeoutMs;
+    private pendingConfig;
+    /**
+     * Monotonic counter minting unique internal keys for order.exec enqueue
+     * actions. One order card can be clicked many times, so the Feishu card
+     * messageId is 1:N with enqueue actions and must not be reused as the queue
+     * dedup key. Date.now() alone is unsafe (two synchronous calls can share a
+     * millisecond); the counter guarantees uniqueness regardless of timing.
+     */
+    private orderExecKeyCounter;
+    /**
+     * Session reader registry for multi-agent path. Resolves the right
+     * reader by `config.defaultAgent` (and per-agent override params).
+     * NOTE: `/config` card's `defaultAgent` selector does NOT use this —
+     * it uses `listRegisteredAgents()` from `router/config/index.ts` (the
+     * config-builder registry), which mirrors the agents with a config card.
+     */
+    private sessionReaderRegistry;
+    /**
+     * 串行化 config.* 卡片回调（2026-07-04）。
+     * CardKit 2.0 input/button 回调经 `enqueueImmediate` 分发，**不进串行队列**，
+     * 多次快速点击 toggle/input 会并发读写 `pendingConfig` 并同时调
+     * `updateCardInPlace` → Feishu API 乱序到达，导致 toggle 卡死在某个状态。
+     * 此 Promise chain 把所有 config.* 动作串成一个执行链，保证后到的动作
+     * 等前一个动作的卡片 patch 完成后再读 `pendingConfig`。
+     */
+    private configActionQueue;
+    constructor(opts: {
+        sessionStore: SessionStore;
+        bridge: Bridge;
+        config: AppConfig;
+        configPath: string;
+        workspacePath?: string;
+        ordersPath?: string;
+        exitHandler?: () => void;
+        /** Spawn the detached replacement bridge process and return its pid (throws on failure). */
+        restartSpawner?: () => number;
+        idleTimeoutMs?: number;
+        /** Session reader registry (required). */
+        sessionReaderRegistry: SessionReaderRegistry;
+    });
+    /**
+     * Resolve the active session reader for the current defaultAgent.
+     * The reader is fetched from the registry each time to reflect config changes.
+     */
+    private get sessionReader();
+    /**
+     * Route a message: if it starts with /, handle as command; if it starts with !, execute as bash; otherwise forward to Claude.
+     */
+    handle(message: string, ctx: CommandContext, opts?: {
+        cwdOverride?: string;
+        binding?: AgentBinding;
+    }): Promise<CommandResult | null>;
+    /**
+     * Handle a CardKit card button click (§6.2).
+     * Validates payload and dispatches to the corresponding command.
+     */
+    handleCardAction(value: CardActionPayload, ctx: CommandContext): Promise<CardActionResponse | void>;
+    /**
+     * Handle queue.cancel: remove this message from the queue.
+     */
+    private handleQueueCancel;
+    /**
+     * Handle queue.immediate: stop current run, clear queue before this message, execute this message immediately.
+     * Instead of asking user to resend, we keep the target task in queue and let it execute.
+     */
+    private handleQueueImmediate;
+    /**
+     * Handle queue.diagnose: show diagnostic info for why message is queuing.
+     */
+    private handleQueueDiagnose;
+    /**
+     * Handle queue.edit: show input field for editing the queued message.
+     */
+    private handleQueueEdit;
+    /**
+     * Handle queue.input: update the queued message with new content.
+     * Returns a CardActionResponse carrying both a toast (immediate feedback,
+     * no separate message sent) and a `card` field so Feishu renders the
+     * updated queue card in place, closing the edit form. 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).
+     */
+    private handleQueueInput;
+    /**
+     * Handle ls.switch: switch cwd to target directory after path validation.
+     */
+    private handleLsSwitch;
+    /**
+     * Handle ls.refresh: reload current directory.
+     */
+    private handleLsRefresh;
+    /**
+     * Handle ls.page: paginate to a specific offset.
+     */
+    private handleLsPage;
+    /**
+     * Handle resume.page: paginate the /resume session list in place.
+     * Mirrors handleLsPage — updates the same card, never sends a new one.
+     */
+    private handleResumePage;
+    /**
+     * Handle ls.browse: browse directory without switching cwd.
+     */
+    private handleLsBrowse;
+    /**
+     * Handle stop card action: interrupt current run.
+     */
+    private handleCardStop;
+    /**
+     * Resolve an order's text at the enqueue boundary so order.exec can enter
+     * the serial queue as an equivalent user message (Plan A) — the same path a
+     * hand-typed message takes. index.ts calls this before bridge.enqueue and
+     * uses the returned `orderText` as the queue messagePreview / edit
+     * default_value, and `internalKey` as the queue dedup key.
+     *
+     * Why an internal key instead of the Feishu card messageId: one order card
+     * can be clicked many times, so the card messageId is 1:N with enqueue
+     * actions. Reusing it collides queuedTasks / queueCardMessages lookups.
+     * Each call therefore mints a unique key (the Feishu messageId still flows
+     * through ctx for replies/reactions — the two concerns are separate).
+     *
+     * `updateUsedAt` runs here, at resolve time, so the usage timestamp
+     * survives even an immediate crash before the queued task ever runs
+     * (preserves the H3 crash-safe property previously held by handleOrderExec,
+     * which recorded it right before forwardToClaude).
+     *
+     * Returns null when the order no longer exists; index.ts surfaces the error.
+     */
+    resolveOrderExecForQueue(orderId: string): {
+        orderText: string;
+        internalKey: string;
+    } | null;
+    /**
+     * Handle order.delete: remove the order and update card in place.
+     */
+    private handleOrderDelete;
+    /**
+     * Handle ws.remove: remove the workspace alias and refresh the /ws list card
+     * in place (mirrors handleOrderDelete). Without this the stale alias would
+     * remain visible on the card the user just clicked.
+     */
+    private handleWsRemove;
+    /**
+     * `ls.file` card button: send file to Feishu, rejecting if > 30MB.
+     */
+    private cardLsFile;
+    /** 确保 pendingConfig 已初始化（从当前 config 克隆） */
+    private ensurePendingConfig;
+    /**
+     * 串行化 config.* 卡片回调（2026-07-04 修复 toggle 卡死 bug）。
+     *
+     * CardKit 2.0 input/button 回调经 `enqueueImmediate` 分发，不进 bridge 的
+     * 串行队列；多次快速点击 toggle 会并发读写 `pendingConfig` 并同时调
+     * `updateCardInPlace` → 两个 patch 请求乱序到达飞书，后到达的 patch（点击 1
+     * 的旧卡片）覆盖先到达的 patch（点击 2 的新卡片），用户看到 toggle 卡死。
+     *
+     * 此方法把所有 config.* 动作串成一个 Promise chain：每个动作等前一个动作
+     * 的 `updateCardInPlace` 完全 settle 后再读 `pendingConfig`。
+     */
+    private enqueueConfigAction;
+    /** 实际的 config.* 分发逻辑（在串行队列内执行） */
+    private dispatchConfigAction;
+    /** 设置嵌套属性值（仅修改内存对象，不写盘） */
+    private setNestedValue;
+    /** 对比原始 config 与 pendingConfig，返回变化的 key→string 映射 */
+    private diffConfig;
+    /** 递归收集差异 */
+    private collectDiff;
+    /**
+     * config 写盘后的运行时传播（P1-6：自 config.save 卡片路径抽出，卡片保存与
+     * `/config <key> <value>` 文本直写两条路径共用）。
+     *
+     * 1. bridge 运行时值同步：setConfig + idle watchdog timeout；
+     * 2. agent 配置或 defaultAgent 变更 → clearRunners（否则 runner 缓存继续用旧
+     *    配置值，/status 与真实 run 自相矛盾）；
+     * 3. defaultAgent 切换 → 旧 agent session 存 previousSessions、新 agent 恢复
+     *    或清空（等效 /new）；
+     * 4. 当前 agent 配置变更 → syncAgentChoices 并原子写盘（P1-7：禁裸同步写盘，
+     *    写一半崩溃会截断 config.yaml 导致 bridge 起不来）。
+     *
+     * @param updates 以 config 路径形式给出的变更 key（卡片路径来自 diffConfig；
+     *   直写路径传 mapAgentKey(key)，保证 pi./codex./opencode./kimi. 命中 agents.*）。
+     * @returns defaultAgent 切换时的通知文案（未切换返回 undefined）
+     */
+    private propagateConfigSave;
+    private executeCommand;
+    private cmdHelp;
+    private cmdStatus;
+    private cmdPs;
+    private cmdStop;
+    private cmdExit;
+    private cmdRestart;
+    private cmdNew;
+    private cmdCd;
+    private readSessionDisplayState;
+    /**
+     * Shared logic for switching cwd with user feedback.
+     * Used by cmdCd, cmdWs use, and handleLsSwitch to ensure consistent behavior:
+     * 1. Set cwd (and clear sessionId per §9.1)
+     * 2. Auto-resume newest session if available
+     * 3. Return appropriate CommandResult (auto-resume card or plain text)
+     */
+    private switchCwdAndNotify;
+    /** Build card for auto-resumed session with new session button */
+    private buildAutoResumeCard;
+    private static readonly LS_PAGE_SIZE;
+    private cmdLs;
+    private cmdWs;
+    /**
+     * L3: degraded card when a session's export is non-empty but unparseable
+     * (truncated by opencode's pipe cap on huge sessions, or otherwise corrupt).
+     * The session exists, so reuse listSessions metadata (title) instead of the
+     * misleading "未找到". Reuses the same card-builder helpers (markdownDiv) as
+     * the normal resume card; enforceCardBudget still applies at send time.
+     */
+    private cmdResume;
+    private cmdActive;
+    /**
+     * Build CardKit 2.0 /active card from bridge memory (not file system).
+     * Shows only runs that were started by THIS bridge process.
+     */
+    private buildActiveCardFromMemory;
+    private cmdReconnect;
+    private cmdConfig;
+    /** Build an interactive config card with CardKit 2.0 tabs + batch save */
+    private buildConfigCard;
+    private cmdOrder;
+}
+export { formatUsageStats } from './utils.js';