lark-remote 0.1.0

package/dist/restart.js

@@ -0,0 +1,73 @@
+import { spawn } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { getLogger } from './logger/index.js';
+/**
+ * Self-restart without an external watchdog/cron: the only process that can
+ * reliably start the successor is the dying bridge itself. The old process
+ * spawns a detached replacement (same executable + argv, hence same
+ * --config-dir), then exits cleanly. The child learns the old pid via env
+ * and waits for it to die before acquiring the instance lock, so the lock
+ * file stays the single source of truth for the handoff.
+ */
+/** Env var telling a replacement child which parent pid to wait for before acquiring the instance lock. */
+export const RESTART_WAIT_PID_ENV = 'LARK_REMOTE_RESTART_WAIT_PID';
+const WAIT_TIMEOUT_MS = 20_000;
+const POLL_MS = 100;
+/**
+ * Spawn a detached replacement bridge with the same executable and argv
+ * (including --config-dir) and return its pid. The caller is expected to
+ * exit right after. stdio is redirected to restart-child.log so early
+ * startup failures (before the file logger initializes) are not lost.
+ */
+export function spawnReplacementBridge(logsDir) {
+    fs.mkdirSync(logsDir, { recursive: true });
+    const out = fs.openSync(path.join(logsDir, 'restart-child.log'), 'a');
+    const child = spawn(process.execPath, process.argv.slice(1), {
+        cwd: process.cwd(),
+        env: { ...process.env, [RESTART_WAIT_PID_ENV]: String(process.pid) },
+        detached: true,
+        stdio: ['ignore', out, out],
+    });
+    // Late spawn errors (e.g. binary removed mid-run) must not crash the
+    // exiting parent via an unhandled 'error' event. Attach BEFORE the pid
+    // check — a failed spawn emits 'error' asynchronously (ENOENT/EACCES),
+    // and the pid check below throws synchronously first, so attaching after
+    // the throw would leave the 'error' event unhandled → uncaughtException
+    // → the old bridge exits despite having promised to stay alive.
+    child.on('error', () => { });
+    fs.closeSync(out);
+    if (child.pid === undefined) {
+        throw new Error('spawn replacement bridge failed: no pid');
+    }
+    child.unref();
+    return child.pid;
+}
+/**
+ * On startup, if this process was spawned as a restart replacement, wait for
+ * the previous bridge process to exit (and release the instance lock) before
+ * continuing. No-op for normal starts. On timeout, proceed anyway — lock
+ * acquisition remains the authority.
+ */
+export async function waitForPreviousInstance() {
+    const raw = process.env[RESTART_WAIT_PID_ENV];
+    delete process.env[RESTART_WAIT_PID_ENV];
+    if (!raw)
+        return;
+    const pid = Number(raw);
+    if (!Number.isInteger(pid) || pid <= 0)
+        return;
+    const deadline = Date.now() + WAIT_TIMEOUT_MS;
+    while (Date.now() < deadline) {
+        try {
+            process.kill(pid, 0);
+        }
+        catch {
+            getLogger().info(`[restart] previous instance pid=${pid} exited, continuing startup`);
+            return;
+        }
+        await new Promise((resolve) => setTimeout(resolve, POLL_MS));
+    }
+    getLogger().warn(`[restart] previous instance pid=${pid} still alive after ${WAIT_TIMEOUT_MS}ms, proceeding anyway`);
+}
+//# sourceMappingURL=restart.js.map

package/dist/router/card-helpers.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shared CardKit helpers for router cards (session history, dashboard,
+ * ls, ws, etc.).
+ *
+ * Re-exports `markdownDiv` from `card/collapsible.ts` and adds session-content
+ * specific builders (e.g. `sessionEventPanel`) so `router/index.ts` can fold
+ * long session histories into collapsible panels without duplicating logic.
+ */
+import { markdownDiv } from '../card/collapsible.js';
+import type { AgentSessionContentEvent } from '../runner/index.js';
+/**
+ * Build a collapsible panel for a single session content event.
+ *
+ * Header carries a type emoji (👤 user / 🤖 assistant·text / 💭 thinking /
+ * 🔧 tool_use / 🟢🔴 tool_result) with optional timestamp.
+ * Body: the event's content (markdown).
+ *
+ * The last `tailExpandedCount` events are expanded by default so the user
+ * sees the most recent context without clicking; older events are collapsed.
+ *
+ * @param ev - Session content event
+ * @param index - Index in the events array
+ * @param totalEvents - Total number of events
+ * @param tailExpandedCount - How many events from the end to keep expanded (default 2)
+ * @param agentKind - Agent type for display name (e.g. 'claude', 'pi'). Defaults to 'claude'.
+ */
+export declare function sessionEventPanel(ev: AgentSessionContentEvent, index: number, totalEvents: number, tailExpandedCount?: number, agentKind?: string): object;
+export { markdownDiv };

package/dist/router/card-helpers.js

@@ -0,0 +1,65 @@
+/**
+ * Shared CardKit helpers for router cards (session history, dashboard,
+ * ls, ws, etc.).
+ *
+ * Re-exports `markdownDiv` from `card/collapsible.ts` and adds session-content
+ * specific builders (e.g. `sessionEventPanel`) so `router/index.ts` can fold
+ * long session histories into collapsible panels without duplicating logic.
+ */
+import { agentDisplayName } from '../card/card-shared.js';
+import { collapsibleMarkdownPanel, markdownDiv } from '../card/collapsible.js';
+import { formatTimestamp } from '../card/time.js';
+/**
+ * Build a collapsible panel for a single session content event.
+ *
+ * Header carries a type emoji (👤 user / 🤖 assistant·text / 💭 thinking /
+ * 🔧 tool_use / 🟢🔴 tool_result) with optional timestamp.
+ * Body: the event's content (markdown).
+ *
+ * The last `tailExpandedCount` events are expanded by default so the user
+ * sees the most recent context without clicking; older events are collapsed.
+ *
+ * @param ev - Session content event
+ * @param index - Index in the events array
+ * @param totalEvents - Total number of events
+ * @param tailExpandedCount - How many events from the end to keep expanded (default 2)
+ * @param agentKind - Agent type for display name (e.g. 'claude', 'pi'). Defaults to 'claude'.
+ */
+export function sessionEventPanel(ev, index, totalEvents, tailExpandedCount = 2, agentKind = 'claude') {
+    const label = eventLabel(ev, agentKind);
+    const ts = formatTimestamp(ev.timestamp);
+    const title = ts ? `${label} (${ts})` : label;
+    const expanded = index >= totalEvents - tailExpandedCount;
+    return collapsibleMarkdownPanel({
+        title,
+        expanded,
+        border: 'grey',
+        content: ev.content,
+        textSize: 'notation',
+    });
+}
+/**
+ * 事件类型 → 面板标题标签。五种 reader 产出的事件类型是
+ * text/thinking/tool_use/tool_result（claude 另有 role-only 的 user/assistant），
+ * 裸英文 type 名对用户不可读，统一映射为 emoji 标签。
+ * tool_result 的成功/失败跟随正文前缀（content-blocks 打头 🟢/🔴），默认 🟢。
+ */
+function eventLabel(ev, agentKind) {
+    switch (ev.type) {
+        case 'user':
+            return '👤 你';
+        case 'assistant':
+        case 'text':
+            return `🤖 ${agentDisplayName(agentKind)}`;
+        case 'thinking':
+            return '💭 思考';
+        case 'tool_use':
+            return '🔧 工具调用';
+        case 'tool_result':
+            return ev.content.startsWith('🔴') ? '🔴 工具结果' : '🟢 工具结果';
+        default:
+            return ev.type;
+    }
+}
+export { markdownDiv };
+//# sourceMappingURL=card-helpers.js.map

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

@@ -0,0 +1,14 @@
+/**
+ * Claude config builder — builds fields and handles field changes for Claude agent.
+ */
+import type { AgentConfigCardBuilder, ConfigField } from './types.js';
+import type { AppConfig } from '../../config/index.js';
+export declare class ClaudeConfigBuilder implements AgentConfigCardBuilder {
+    /** Find Claude settings.json path (for dynamic model reading). */
+    private findSettingsPath;
+    buildFields(displayConfig: AppConfig): ConfigField[];
+    handleFieldChange(key: string, _value: unknown, _config: AppConfig): Array<{
+        key: string;
+        value: unknown;
+    }>;
+}

package/dist/router/config/claude.js

@@ -0,0 +1,72 @@
+/**
+ * Claude config builder — builds fields and handles field changes for Claude agent.
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { MODEL_ID_TO_ALIAS, MODEL_ALIAS_TO_ID, getModelOptionsFromSettings, CLAUDE_EFFORTS, } from '../../config/index.js';
+export class ClaudeConfigBuilder {
+    /** Find Claude settings.json path (for dynamic model reading). */
+    findSettingsPath() {
+        const envPath = process.env.CLAUDE_SETTINGS_PATH;
+        if (envPath && fs.existsSync(envPath)) {
+            return envPath;
+        }
+        const defaultPath = path.join(os.homedir(), '.claude', 'settings.json');
+        if (fs.existsSync(defaultPath)) {
+            return defaultPath;
+        }
+        return undefined;
+    }
+    buildFields(displayConfig) {
+        const fields = [];
+        // 模型选项使用 alias，动态从 settings.json 读取
+        const modelAliasOptions = ['fable', 'opus', 'sonnet', 'haiku'];
+        const currentModel = displayConfig.claude?.model;
+        const currentEffort = displayConfig.claude?.effort ?? 'medium';
+        // 动态从 Claude settings.json 读取可选模型列表
+        const settingsPath = this.findSettingsPath();
+        const dynamicModelOptions = settingsPath ? getModelOptionsFromSettings(settingsPath) : [];
+        // 如果从 settings 读取到模型，使用它们；否则使用默认的 alias 列表
+        const modelOptions = dynamicModelOptions.length > 0 ? dynamicModelOptions : modelAliasOptions;
+        // 当前值处理：从 settings 读取时是 model ID，需要显示 alias
+        let currentModelValue = currentModel;
+        if (currentModel) {
+            currentModelValue = MODEL_ID_TO_ALIAS[currentModel] ?? currentModel;
+        }
+        const isCustomModel = currentModel &&
+            !modelOptions.includes(currentModel) &&
+            !modelOptions.includes(MODEL_ID_TO_ALIAS[currentModel] ?? '') &&
+            !Object.values(MODEL_ID_TO_ALIAS).includes(currentModel) &&
+            !(currentModel in MODEL_ID_TO_ALIAS) &&
+            !Object.values(MODEL_ALIAS_TO_ID).includes(currentModel);
+        fields.push({
+            key: 'claude.model',
+            label: '使用模型',
+            type: 'select',
+            options: modelOptions,
+            currentValue: isCustomModel ? undefined : currentModelValue,
+        });
+        fields.push({
+            key: 'claude.model',
+            label: '自定义模型名',
+            type: 'input',
+            currentValue: isCustomModel ? currentModel : '',
+        });
+        fields.push({
+            key: 'claude.effort',
+            label: '推理强度',
+            type: 'select',
+            // Use constant for effort options (SSOT)
+            options: CLAUDE_EFFORTS,
+            currentValue: currentEffort,
+        });
+        return fields;
+    }
+    handleFieldChange(key, _value, _config) {
+        // Claude has no dependent field changes (no auto-reset on provider change, etc.)
+        // Return the key as-is for the router to apply.
+        return [{ key, value: _value }];
+    }
+}
+//# sourceMappingURL=claude.js.map

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

@@ -0,0 +1,22 @@
+/**
+ * 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';
+export declare class CodexConfigBuilder implements AgentConfigCardBuilder {
+    buildFields(displayConfig: AppConfig): ConfigField[];
+    handleFieldChange(key: string, value: unknown, config: AppConfig): Array<{
+        key: string;
+        value: unknown;
+    }>;
+    /**
+     * 按 codex with_model 语义（core/src/session/turn_context.rs:255-269）计算切到
+     * newModel 后的档位补丁：
+     * - 当前档位仍被新模型支持 → 不产出补丁；
+     * - 否则优先 supported_reasoning_levels 中位 (len-1)/2；
+     * - 列表为空才用声明 default_reasoning_level；
+     * - 两者皆无 → value=undefined（清空档位 = 不传 effort；router setNestedValue
+     *   对 undefined 做键删除，P1）。
+     */
+    private effortPatchForModel;
+}

package/dist/router/config/codex.js

@@ -0,0 +1,100 @@
+/**
+ * Codex config builder — builds fields and handles field changes for Codex agent.
+ */
+import { loadCodexConfig, getReasoningEffortOptions, getDefaultReasoningEffort, } from '../../config/codex-config.js';
+export class CodexConfigBuilder {
+    buildFields(displayConfig) {
+        const fields = [];
+        // 从 codex config.toml 动态读取 provider 和 model
+        const codexBinary = displayConfig.agents?.codex?.binary ?? 'codex';
+        const codexCfg = loadCodexConfig({ binary: codexBinary });
+        const codexProviderNames = codexCfg.providerNames;
+        const currentModelProvider = displayConfig.agents?.codex?.modelProvider ?? codexCfg.currentProvider;
+        const currentCodexModel = displayConfig.agents?.codex?.model ?? codexCfg.currentModel;
+        const currentReasoningEffort = displayConfig.agents?.codex?.reasoningEffort ??
+            getDefaultReasoningEffort(currentCodexModel, codexBinary);
+        // 传入当前 provider 过滤模型列���
+        const codexModelOptions = codexCfg.modelOptions(currentModelProvider);
+        fields.push({
+            key: 'agents.codex.modelProvider',
+            label: 'Codex Provider',
+            type: 'select',
+            options: codexProviderNames,
+            currentValue: currentModelProvider,
+        });
+        fields.push({
+            key: 'agents.codex.model',
+            label: '使用模型',
+            type: 'select',
+            options: codexModelOptions,
+            currentValue: currentCodexModel,
+        });
+        const isCustomModel = currentCodexModel && !codexModelOptions.includes(currentCodexModel);
+        // 自定义模型名输入框（与 Claude 一致的行为）
+        fields.push({
+            key: 'agents.codex.model',
+            label: '自定义模型名',
+            type: 'input',
+            currentValue: isCustomModel ? currentCodexModel : '',
+        });
+        fields.push({
+            key: 'agents.codex.reasoningEffort',
+            label: '推理强度',
+            type: 'select',
+            // 档位按目录实际声明透传（P2-5）：codex 支持 none/Custom，不再按标准枚举过滤
+            options: getReasoningEffortOptions(currentCodexModel, codexBinary),
+            currentValue: currentReasoningEffort,
+        });
+        return fields;
+    }
+    handleFieldChange(key, value, config) {
+        const patches = [];
+        patches.push({ key, value });
+        // provider 变更时，重置 model 为�� provider 的首个模型
+        if (key === 'agents.codex.modelProvider' && typeof value === 'string') {
+            const codexBinary = config.agents?.codex?.binary ?? 'codex';
+            const codexCfg = loadCodexConfig({ binary: codexBinary });
+            const newModelOptions = codexCfg.modelOptions(value);
+            const currentModel = config.agents?.codex?.model;
+            const currentModelIsValid = newModelOptions.some((m) => m === currentModel);
+            if (!currentModelIsValid && newModelOptions.length > 0) {
+                const replacedModel = newModelOptions[0];
+                patches.push({ key: 'agents.codex.model', value: replacedModel });
+                // provider 切换自动替换模型后，必须对替换后的模型执行
+                // 同样的档位校验——否则旧模型支持的档位会原样留在卡片/透传给不支持它的模型
+                // （codex 只在会话中 with_model 时钳制，session 创建路径不钳制）。
+                const effortPatch = this.effortPatchForModel(config, replacedModel);
+                if (effortPatch)
+                    patches.push(effortPatch);
+            }
+        }
+        // model 变更时，若当前档位不被新模型支持，按 codex with_model 语义重置
+        if (key === 'agents.codex.model' && typeof value === 'string') {
+            const effortPatch = this.effortPatchForModel(config, value);
+            if (effortPatch)
+                patches.push(effortPatch);
+        }
+        return patches;
+    }
+    /**
+     * 按 codex with_model 语义（core/src/session/turn_context.rs:255-269）计算切到
+     * newModel 后的档位补丁：
+     * - 当前档位仍被新模型支持 → 不产出补丁；
+     * - 否则优先 supported_reasoning_levels 中位 (len-1)/2；
+     * - 列表为空才用声明 default_reasoning_level；
+     * - 两者皆无 → value=undefined（清空档位 = 不传 effort；router setNestedValue
+     *   对 undefined 做键删除，P1）。
+     */
+    effortPatchForModel(config, newModel) {
+        const codexBinary = config.agents?.codex?.binary ?? 'codex';
+        const currentReasoningEffort = config.agents?.codex?.reasoningEffort;
+        const newModelSupportedEfforts = getReasoningEffortOptions(newModel, codexBinary);
+        const isCurrentEffortValid = currentReasoningEffort && newModelSupportedEfforts.includes(currentReasoningEffort);
+        if (isCurrentEffortValid)
+            return null;
+        const middle = newModelSupportedEfforts[Math.floor((newModelSupportedEfforts.length - 1) / 2)];
+        const newEffort = middle ?? getDefaultReasoningEffort(newModel, codexBinary);
+        return { key: 'agents.codex.reasoningEffort', value: newEffort };
+    }
+}
+//# sourceMappingURL=codex.js.map

package/dist/router/config/common/render.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared config card rendering logic.
+ *
+ * Builds CardKit 2.0 elements for config fields (boolean toggle, select dropdown, input).
+ * Used by all agent config builders and the shared tabs (idle, output, logging).
+ */
+import { type AppConfig } from '../../../config/index.js';
+import type { ConfigField } from '../types.js';
+/** A tab/section in the config card. */
+export interface ConfigTab {
+    id: string;
+    label: string;
+    fields: ConfigField[];
+}
+/** Build the full CardKit 2.0 card from tabs. */
+export declare function buildConfigCardFromTabs(tabs: ConfigTab[], displayConfig: AppConfig): object;

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

@@ -0,0 +1,158 @@
+/**
+ * Shared config card rendering logic.
+ *
+ * Builds CardKit 2.0 elements for config fields (boolean toggle, select dropdown, input).
+ * Used by all agent config builders and the shared tabs (idle, output, logging).
+ */
+import { getConfigValue } from '../../../config/index.js';
+/** Build CardKit 2.0 elements for a list of config fields. */
+function buildFieldElements(fields, displayConfig) {
+    const elements = [];
+    for (const field of fields) {
+        // Get current value from displayConfig for dynamic fields
+        const currentValue = getConfigValue(displayConfig, field.key);
+        if (field.type === 'boolean') {
+            // For boolean, use field.currentValue if set, otherwise use config value
+            const isOn = field.currentValue !== undefined ? field.currentValue === true : currentValue === true;
+            elements.push(buildBooleanElement(field, isOn));
+        }
+        else if (field.type === 'select' && field.options) {
+            elements.push(buildSelectElement(field, currentValue));
+        }
+        else {
+            elements.push(buildInputElement(field, currentValue));
+        }
+    }
+    return elements;
+}
+function buildBooleanElement(field, isOn) {
+    const displayVal = isOn ? '✅ 已开启' : '⚪ 已关闭';
+    return {
+        tag: 'column_set',
+        flex_mode: 'none',
+        columns: [
+            {
+                tag: 'column',
+                width: 'weighted',
+                weight: 2,
+                vertical_align: 'center',
+                elements: [{ tag: 'div', text: { tag: 'lark_md', content: field.label } }],
+            },
+            {
+                tag: 'column',
+                width: 'weighted',
+                weight: 3,
+                vertical_align: 'center',
+                elements: [
+                    {
+                        tag: 'button',
+                        text: { tag: 'plain_text', content: displayVal },
+                        type: isOn ? 'primary' : 'default',
+                        behaviors: [{ type: 'callback', value: { cmd: 'config.toggle', key: field.key } }],
+                    },
+                ],
+            },
+        ],
+    };
+}
+function buildSelectElement(field, currentValue) {
+    // 优先使用 field.currentValue（卡片显示用覆盖值），否则使用 config 中的值
+    const selectedValue = field.currentValue != null
+        ? String(field.currentValue)
+        : currentValue == null
+            ? undefined
+            : String(currentValue);
+    return {
+        tag: 'column_set',
+        flex_mode: 'none',
+        columns: [
+            {
+                tag: 'column',
+                width: 'weighted',
+                weight: 2,
+                vertical_align: 'center',
+                elements: [{ tag: 'div', text: { tag: 'lark_md', content: field.label } }],
+            },
+            {
+                tag: 'column',
+                width: 'weighted',
+                weight: 3,
+                vertical_align: 'center',
+                elements: [
+                    {
+                        tag: 'select_static',
+                        placeholder: { tag: 'plain_text', content: '请选择' },
+                        options: field.options.map((opt) => ({
+                            text: { tag: 'plain_text', content: opt },
+                            value: opt,
+                        })),
+                        initial_option: selectedValue,
+                        behaviors: [{ type: 'callback', value: { cmd: 'config.set', key: field.key } }],
+                    },
+                ],
+            },
+        ],
+    };
+}
+function buildInputElement(field, currentValue) {
+    // 优先使用 field.currentValue（允许覆盖 displayConfig 中的值）
+    const currentStr = field.currentValue != null
+        ? String(field.currentValue)
+        : currentValue == null
+            ? ''
+            : String(currentValue);
+    return {
+        tag: 'column_set',
+        flex_mode: 'none',
+        columns: [
+            {
+                tag: 'column',
+                width: 'weighted',
+                weight: 2,
+                vertical_align: 'center',
+                elements: [{ tag: 'div', text: { tag: 'lark_md', content: field.label } }],
+            },
+            {
+                tag: 'column',
+                width: 'weighted',
+                weight: 3,
+                vertical_align: 'center',
+                elements: [
+                    {
+                        tag: 'input',
+                        name: field.key,
+                        placeholder: { tag: 'plain_text', content: '请输入值' },
+                        default_value: currentStr,
+                        behaviors: [{ type: 'callback', value: { cmd: 'config.input', key: field.key } }],
+                    },
+                ],
+            },
+        ],
+    };
+}
+/** Build the full CardKit 2.0 card from tabs. */
+export function buildConfigCardFromTabs(tabs, displayConfig) {
+    const elements = [];
+    for (const tab of tabs) {
+        const fieldElements = buildFieldElements(tab.fields, displayConfig);
+        // Section header - bold markdown
+        elements.push({ tag: 'div', text: { tag: 'lark_md', content: `**${tab.label}**` } });
+        // Section fields
+        elements.push(...fieldElements);
+        elements.push({ tag: 'hr' });
+    }
+    // 底部保存按钮
+    elements.push({
+        tag: 'button',
+        text: { tag: 'plain_text', content: '💾 保存所有修改' },
+        type: 'primary',
+        behaviors: [{ type: 'callback', value: { cmd: 'config.save' } }],
+    });
+    return {
+        schema: '2.0',
+        config: { wide_screen_mode: true, update_multi: true },
+        header: { title: { tag: 'plain_text', content: '⚙️ 系统配置' }, template: 'blue' },
+        body: { elements },
+    };
+}
+//# sourceMappingURL=render.js.map

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

@@ -0,0 +1,18 @@
+/**
+ * Config card builder registry — provides getConfigBuilder(agent) factory.
+ *
+ * Each agent implements AgentConfigCardBuilder in its own file.
+ * Adding a new agent = add a file + register here (no upstream changes needed).
+ */
+import type { AgentKind } from '../../runner/types.js';
+import type { AgentConfigCardBuilder } from './types.js';
+/**
+ * Get the config builder for a specific agent.
+ *
+ * @param agent - The agent kind (claude, codex, pi, opencode, kimi)
+ * @returns The config builder instance for that agent
+ * @throws Error if the agent is not registered
+ */
+export declare function getConfigBuilder(agent: AgentKind): AgentConfigCardBuilder;
+/** List all registered agent kinds. */
+export declare function listRegisteredAgents(): AgentKind[];

package/dist/router/config/index.js

@@ -0,0 +1,38 @@
+/**
+ * Config card builder registry — provides getConfigBuilder(agent) factory.
+ *
+ * Each agent implements AgentConfigCardBuilder in its own file.
+ * Adding a new agent = add a file + register here (no upstream changes needed).
+ */
+import { ClaudeConfigBuilder } from './claude.js';
+import { CodexConfigBuilder } from './codex.js';
+import { PiConfigBuilder } from './pi.js';
+import { OpencodeConfigBuilder } from './opencode.js';
+import { KimiConfigBuilder } from './kimi.js';
+/** Registry of config builders, keyed by agent kind. */
+const builders = {
+    claude: new ClaudeConfigBuilder(),
+    codex: new CodexConfigBuilder(),
+    pi: new PiConfigBuilder(),
+    opencode: new OpencodeConfigBuilder(),
+    kimi: new KimiConfigBuilder(),
+};
+/**
+ * Get the config builder for a specific agent.
+ *
+ * @param agent - The agent kind (claude, codex, pi, opencode, kimi)
+ * @returns The config builder instance for that agent
+ * @throws Error if the agent is not registered
+ */
+export function getConfigBuilder(agent) {
+    const builder = builders[agent];
+    if (!builder) {
+        throw new Error(`No config builder registered for agent: ${agent}`);
+    }
+    return builder;
+}
+/** List all registered agent kinds. */
+export function listRegisteredAgents() {
+    return Object.keys(builders);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,21 @@
+/**
+ * Kimi config builder — builds fields and handles field changes for Kimi agent.
+ */
+import type { AgentConfigCardBuilder, ConfigField } from './types.js';
+import type { AppConfig } from '../../config/index.js';
+export declare class KimiConfigBuilder implements AgentConfigCardBuilder {
+    buildFields(displayConfig: AppConfig): ConfigField[];
+    handleFieldChange(key: string, value: unknown, config: AppConfig): Array<{
+        key: string;
+        value: unknown;
+    }>;
+    /**
+     * 切到 newModel 后的档位补丁（参照 codex effortPatchForModel 语义）：
+     * - 当前档位仍被新模型支持 → 不产出补丁；
+     * - 否则优先 modelEfforts[newModel] 中位 (len-1)/2；
+     * - 列表为空才用 modelDefaultEfforts[newModel]；
+     * - 两者皆无 → FALLBACK_EFFORTS 中位；仍无则 undefined（router setNestedValue
+     *   对 undefined 做键删除）。
+     */
+    private thinkingEffortPatchForModel;
+}