lark-remote 0.1.10 → 0.1.12

package/CHANGELOG.md

@@ -5,6 +5,28 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.12] - 2026-08-29
+
+### 修复
+
+- opencode ACP stream error 实时上报：tail opencode 日志即时捕获错误行，配额类错误秒级报错，不再挂起卡片等待超时
+
+### 变更
+
+- codex 会话历史读取轻量化：长会话生成轻量摘要，模型目录异步加载，减少启动阻塞
+- CI 覆盖率门禁纳入 `src/index.ts`，覆盖率统计更完整
+
+## [0.1.11] - 2026-08-24
+
+### 新增
+
+- kimi ACP 支持 Bash 命令自主执行：`terminal/*` reverse RPC 将 Bash 工具下放到本地子进程（一次性 `bash -c <script>`），yolo/auto 模式自主跑命令，manual 模式仍走审批；run 卡片显示带真实命令与本地输出的 Bash 面板，并过滤 kimi 自产的双份 Bash 通知
+
+### 变更
+
+- kimi ACP 能力声明：`fs` 保持关闭（走本地磁盘兜底，避免未实现的 `fs/*` RPC 报 `METHOD_NOT_FOUND`），`terminal` 打开
+- 文档清理：移除设计文档中对内部文档名（`lessons-redlines`）与本地仓库路径（`/Users/.../lark-remote`）的引用
+
 ## [0.1.10] - 2026-08-22
 
 ### 新增

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

@@ -75,14 +75,36 @@ export declare function parseCodexModelsOutput(stdout: string): BundledModelInfo
  * 缓存：键含 binary/home/mode/models.json mtime:size + config.toml mtime:size
  * （P3-4/P3-15/P3-5）；成功结果 TTL 1h，失败/空结果短 TTL 负缓存；stat 异常时
  * 指纹为空（P1-1/P3-10）。
+ *
+ * 同步路径（卡片构建用）：缓存命中直接返回；若有一个后台异步加载
+ * （`loadCodexCatalogModelsAsync` / 启动 warm）在途，则不阻塞事件循环、不重复
+ * spawn，直接返回 [] 走既有 fallback（FALLBACK_MODELS / currentModel）——该
+ * [] 状态与命令失败/超时的已有语义一致，由调用方既有 fallback 兜底。
  */
 export declare function getCodexCatalogModels(codexHome?: string): BundledModelInfo[];
+/**
+ * 异步加载模型目录（execFile，不阻塞事件循环），写入与同步路径共享的
+ * `catalogCache`。按缓存 key 复用 in-flight Promise：并发调用（多个 warm /
+ * 显式调用）只 spawn 一次 `codex debug models`。
+ *
+ * 与同步路径的职责划分：启动时用 `warmCodexCatalogCache` 后台预热，使首次打开
+ * Codex 配置卡（同步读）时缓存已温、无需 8s execFileSync 阻塞；若用户在 warm
+ * 完成前打开卡片，同步路径会检测到 in-flight 并直接返回 [] fallback。
+ */
+export declare function loadCodexCatalogModelsAsync(codexHome?: string): Promise<BundledModelInfo[]>;
+/**
+ * 启动/后台预热：fire-and-forget 调用异步加载，消除首次打开 Codex 配置卡时的
+ * 8s 同步阻塞。非致命——失败/未安装 codex 时静默落负缓存。
+ */
+export declare function warmCodexCatalogCache(codexHome?: string): void;
 /**
  * Test utility: clear the catalog cache. Tests that exercise the bundled
  * command path (`--bundled`) directly use `invalidateCodexBundledTestCache`
  * from `tests/lib/codex-bundled-test-helpers.ts`.
  */
 export declare function invalidateCodexBundledCache(): void;
+/** Test utility: clear in-flight async catalog loads (see async loader tests). */
+export declare function _clearCodexCatalogInFlightForTest(): void;
 /**
  * Get supported reasoning effort options for a model.
  * @param codexHome 可选 codex 配置目录覆盖（与 loadCodexConfig 的 codexHome 对齐，

package/dist/config/codex-config.js

@@ -8,7 +8,7 @@
  * - catalog 模式（config.toml 声明 model_catalog_json）：模型列表/档位来自活动目录
  * - 非 catalog 模式：openai 用 bundled 全量；anthropic 仅在用户显式配置时存在
  */
-import { execFileSync } from 'node:child_process';
+import { execFileSync, execFile } from 'node:child_process';
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
@@ -46,6 +46,8 @@ const BUNDLED_CACHE_TTL_MS = 60 * 60 * 1000;
 /** 失败/空结果负缓存 TTL：避免每次卡片构建同步阻塞最长 8s（P3-5） */
 const NEGATIVE_CACHE_TTL_MS = 30 * 1000;
 let catalogCache = null;
+/** In-flight async catalog loads, keyed by cache key — dedup concurrent warm ups. */
+const catalogInFlight = new Map();
 /**
  * Read config.toml `model_catalog_json` path (tilde-expanded).
  * 返回语义：
@@ -153,8 +155,89 @@ export function parseCodexModelsOutput(stdout) {
  * 缓存：键含 binary/home/mode/models.json mtime:size + config.toml mtime:size
  * （P3-4/P3-15/P3-5）；成功结果 TTL 1h，失败/空结果短 TTL 负缓存；stat 异常时
  * 指纹为空（P1-1/P3-10）。
+ *
+ * 同步路径（卡片构建用）：缓存命中直接返回；若有一个后台异步加载
+ * （`loadCodexCatalogModelsAsync` / 启动 warm）在途，则不阻塞事件循环、不重复
+ * spawn，直接返回 [] 走既有 fallback（FALLBACK_MODELS / currentModel）——该
+ * [] 状态与命令失败/超时的已有语义一致，由调用方既有 fallback 兜底。
  */
 export function getCodexCatalogModels(codexHome) {
+    const { key, bundled } = computeCodexCatalogKey(codexHome);
+    const cached = readCachedCatalog(key);
+    if (cached !== undefined)
+        return cached;
+    // in-flight 异步加载进行中：不 execFileSync（会阻塞 8s），返回 [] 交给
+    // 调用方既有 fallback；in-flight 完成后下次读取命中缓存。
+    if (catalogInFlight.has(key)) {
+        return [];
+    }
+    const now = Date.now();
+    try {
+        const stdout = execFileSync('codex', catalogArgs(bundled), {
+            encoding: 'utf-8',
+            timeout: 8_000,
+            maxBuffer: 4 * 1024 * 1024,
+            env: process.env,
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        const models = parseCodexModelsOutput(stdout);
+        catalogCache = { key, models, ts: now, failed: models.length === 0 };
+        return models;
+    }
+    catch (err) {
+        getLogger().warn(`[codex-config] models unavailable for binary "codex": ${err.message}`);
+        catalogCache = { key, models: [], ts: now, failed: true };
+        return [];
+    }
+}
+/**
+ * 异步加载模型目录（execFile，不阻塞事件循环），写入与同步路径共享的
+ * `catalogCache`。按缓存 key 复用 in-flight Promise：并发调用（多个 warm /
+ * 显式调用）只 spawn 一次 `codex debug models`。
+ *
+ * 与同步路径的职责划分：启动时用 `warmCodexCatalogCache` 后台预热，使首次打开
+ * Codex 配置卡（同步读）时缓存已温、无需 8s execFileSync 阻塞；若用户在 warm
+ * 完成前打开卡片，同步路径会检测到 in-flight 并直接返回 [] fallback。
+ */
+export async function loadCodexCatalogModelsAsync(codexHome) {
+    const { key, bundled } = computeCodexCatalogKey(codexHome);
+    const cached = readCachedCatalog(key);
+    if (cached !== undefined)
+        return cached;
+    const inFlight = catalogInFlight.get(key);
+    if (inFlight)
+        return inFlight;
+    const p = (async () => {
+        const now = Date.now();
+        try {
+            const stdout = await execFileAsync('codex', catalogArgs(bundled));
+            const models = parseCodexModelsOutput(stdout);
+            catalogCache = { key, models, ts: now, failed: models.length === 0 };
+            return models;
+        }
+        catch (err) {
+            getLogger().warn(`[codex-config] models unavailable for binary "codex": ${err.message}`);
+            catalogCache = { key, models: [], ts: now, failed: true };
+            return [];
+        }
+    })();
+    catalogInFlight.set(key, p);
+    try {
+        return await p;
+    }
+    finally {
+        catalogInFlight.delete(key);
+    }
+}
+/**
+ * 启动/后台预热：fire-and-forget 调用异步加载，消除首次打开 Codex 配置卡时的
+ * 8s 同步阻塞。非致命——失败/未安装 codex 时静默落负缓存。
+ */
+export function warmCodexCatalogCache(codexHome) {
+    void loadCodexCatalogModelsAsync(codexHome);
+}
+/** 计算目录缓存键（binary/home/mode + 指纹），同步与异步路径共享。 */
+function computeCodexCatalogKey(codexHome) {
     const binary = 'codex';
     const home = resolveCodexHome(codexHome);
     const catalogPath = readModelCatalogJsonPath(home);
@@ -179,6 +262,10 @@ export function getCodexCatalogModels(codexHome) {
         }
     }
     const key = `${binary}\u0000${home}\u0000${bundled ? 'bundled' : 'active'}\u0000${catalogFingerprint}\u0000${configFingerprint}`;
+    return { key, bundled };
+}
+/** 读取有效缓存（含负缓存 TTL）；命中返回模型，否则 undefined。 */
+function readCachedCatalog(key) {
     const now = Date.now();
     if (catalogCache && catalogCache.key === key) {
         const ttl = catalogCache.failed ? NEGATIVE_CACHE_TTL_MS : BUNDLED_CACHE_TTL_MS;
@@ -186,24 +273,27 @@ export function getCodexCatalogModels(codexHome) {
             return catalogCache.models;
         }
     }
-    try {
-        const args = bundled ? ['debug', 'models', '--bundled'] : ['debug', 'models'];
-        const stdout = execFileSync(binary, args, {
+    return undefined;
+}
+/** `codex debug models` 参数（--bundled 与否）。 */
+function catalogArgs(bundled) {
+    return bundled ? ['debug', 'models', '--bundled'] : ['debug', 'models'];
+}
+/** Promisify execFile with the same 8s timeout / 4MB cap as the sync path. */
+function execFileAsync(file, args) {
+    return new Promise((resolve, reject) => {
+        execFile(file, args, {
             encoding: 'utf-8',
             timeout: 8_000,
             maxBuffer: 4 * 1024 * 1024,
             env: process.env,
-            stdio: ['ignore', 'pipe', 'ignore'],
+        }, (err, stdout) => {
+            if (err)
+                reject(err);
+            else
+                resolve(stdout);
         });
-        const models = parseCodexModelsOutput(stdout);
-        catalogCache = { key, models, ts: now, failed: models.length === 0 };
-        return models;
-    }
-    catch (err) {
-        getLogger().warn(`[codex-config] models unavailable for binary "${binary}": ${err.message}`);
-        catalogCache = { key, models: [], ts: now, failed: true };
-        return [];
-    }
+    });
 }
 /**
  * Test utility: clear the catalog cache. Tests that exercise the bundled
@@ -213,6 +303,10 @@ export function getCodexCatalogModels(codexHome) {
 export function invalidateCodexBundledCache() {
     catalogCache = null;
 }
+/** Test utility: clear in-flight async catalog loads (see async loader tests). */
+export function _clearCodexCatalogInFlightForTest() {
+    catalogInFlight.clear();
+}
 /**
  * Get supported reasoning effort options for a model.
  * @param codexHome 可选 codex 配置目录覆盖（与 loadCodexConfig 的 codexHome 对齐，

package/dist/index.js

@@ -6,6 +6,7 @@ import { FeishuConnector } from './connector/index.js';
 import { ClaudeRunner, CodexAppServerRunner, OpencodeAcpRunner, PiRpcRunner, KimiAcpRunner, DshRunner, } from './runner/index.js';
 import { AgentRegistry } from './runner/registry.js';
 import { probeAllAgents } from './runner/probe.js';
+import { warmCodexCatalogCache } from './config/codex-config.js';
 import { SessionReaderRegistry, SessionStore } from './session/index.js';
 import { ClaudeSessionReader, CodexSessionReader, OpencodeSessionReader, PiSessionReader, KimiSessionReader, DshSessionReader, } from './session/index.js';
 import { CommandRouter, isImmediateAction } from './router/index.js';
@@ -289,6 +290,11 @@ function initializeRunner(config, configDir, cliArgs) {
         .catch(() => {
         // Probe failure is non-fatal; /config card will retry on open.
     });
+    // Warm the codex model catalog in the background so the first Codex /config
+    // card open reads a warm cache instead of blocking the event loop for up to
+    // 8s (execFileSync cold path). Fire-and-forget; failure lands in negative
+    // cache and the sync card path falls back gracefully.
+    warmCodexCatalogCache();
     return { agentRegistry, sessionReaderRegistry };
 }
 /** Setup message and card action handlers. */

package/dist/router/index.js

@@ -3108,12 +3108,19 @@ ${sessionCwdLine}${agentLines.map((l) => `- ${l}`).join('\n')}
         const sessionMeta = new Map();
         const prefetchCount = Math.min(RESUME_CONTENT_PREFETCH, allSessions.length);
         for (const s of allSessions.slice(0, prefetchCount)) {
-            // Use the same reader as the listSessions call above
-            const content = reader.readSessionContent(s.sessionId, cwd);
+            // 优先走轻量摘要（只取标题/用量，不构造 events）——codex 实现了
+            // readSessionSummary，避免对前 N 条各做一次全量 JSONL 解析来构造
+            // 立即被丢弃的 events 数组。其他 agent 无此方法时回退全量读取再取字段。
+            const meta = reader.readSessionSummary
+                ? reader.readSessionSummary(s.sessionId, cwd)
+                : (() => {
+                    const c = reader.readSessionContent(s.sessionId, cwd);
+                    return { aiTitle: c.aiTitle, recap: c.recap, displayTitle: c.displayTitle };
+                })();
             sessionMeta.set(s.sessionId, {
-                aiTitle: content.aiTitle,
-                recap: content.recap,
-                displayTitle: content.displayTitle,
+                aiTitle: meta.aiTitle,
+                recap: meta.recap,
+                displayTitle: meta.displayTitle,
             });
         }
         const now = Date.now();

package/dist/runner/common/acp/protocol-types.d.ts

@@ -39,7 +39,7 @@ export declare const RpcErrorCode: {
 export interface InitializeParams {
     /** Protocol version — must be 1 (number, not string). */
     protocolVersion: number;
-    /** Client capabilities: explicitly declare what we support (all off). */
+    /** Client capabilities: declare only reverse-RPC surfaces we implement. */
     clientCapabilities: {
         fs: {
             readTextFile: boolean;
@@ -209,6 +209,12 @@ export declare const ServerRequestMethod: {
     readonly REQUEST_PERMISSION: "session/request_permission";
     /** Kimi AskUserQuestion elicitation form（客户端广告 elicitation.form 时启用）。 */
     readonly ELICITATION_CREATE: "elicitation/create";
+    /** kimi terminal 工具 reverse RPC：Bash 执行下放客户端（acp-terminal）。 */
+    readonly TERMINAL_CREATE: "terminal/create";
+    readonly TERMINAL_OUTPUT: "terminal/output";
+    readonly TERMINAL_WAIT_FOR_EXIT: "terminal/wait_for_exit";
+    readonly TERMINAL_KILL: "terminal/kill";
+    readonly TERMINAL_RELEASE: "terminal/release";
 };
 export interface PermissionOption {
     /** Opaque option identifier — echo back in response outcome.optionId. */
@@ -269,3 +275,34 @@ export interface ElicitationCreateResponse {
     /** accept 时的答案，key 为 q0..qn（按问题顺序）。 */
     content?: Record<string, string | string[]>;
 }
+export interface TerminalCreateParams {
+    sessionId: string;
+    /** 恒为 'bash'（服务端 spawn 只接受 bash -c）。 */
+    command: string;
+    /** ['-c', <script>]：-c 在 args[0]，脚本在 args[1]。 */
+    args: string[];
+    env?: Array<{
+        name: string;
+        value: string;
+    }>;
+    /** 可能为 null → 回退 session cwd。 */
+    cwd?: string | null;
+    /** 输出缓冲上限（字节），默认 4MB。 */
+    outputByteLimit?: number;
+}
+export interface TerminalOutputParams {
+    sessionId: string;
+    terminalId: string;
+}
+export interface TerminalWaitForExitParams {
+    sessionId: string;
+    terminalId: string;
+}
+export interface TerminalKillParams {
+    sessionId: string;
+    terminalId: string;
+}
+export interface TerminalReleaseParams {
+    sessionId: string;
+    terminalId: string;
+}

package/dist/runner/common/acp/protocol-types.js

@@ -73,5 +73,11 @@ export const ServerRequestMethod = {
     REQUEST_PERMISSION: 'session/request_permission',
     /** Kimi AskUserQuestion elicitation form（客户端广告 elicitation.form 时启用）。 */
     ELICITATION_CREATE: 'elicitation/create',
+    /** kimi terminal 工具 reverse RPC：Bash 执行下放客户端（acp-terminal）。 */
+    TERMINAL_CREATE: 'terminal/create',
+    TERMINAL_OUTPUT: 'terminal/output',
+    TERMINAL_WAIT_FOR_EXIT: 'terminal/wait_for_exit',
+    TERMINAL_KILL: 'terminal/kill',
+    TERMINAL_RELEASE: 'terminal/release',
 };
 //# sourceMappingURL=protocol-types.js.map

package/dist/runner/index.d.ts

@@ -15,6 +15,6 @@ export { KimiAcpRunner } from './kimi/index.js';
 export { DshRunner } from './dsh/index.js';
 export { BashProcessRunner, type BashRunner } from './bash/index.js';
 export { AgentRegistry } from './registry.js';
-export type { ResultEvent, PlanEvent, FileChangeEvent, AgentEvent, Runner, RunnerLifetime, AgentKind, AgentSession, AgentSessionContentEvent, AgentSessionUsage, SessionContent, AgentSessionReader, AgentRunner, TurnStartedEvent, TurnDiffEvent, ApprovalView, ApprovalRequestedEvent, ApprovalResolvedEvent, } from './types.js';
+export type { ResultEvent, PlanEvent, FileChangeEvent, AgentEvent, Runner, RunnerLifetime, AgentKind, AgentSession, AgentSessionContentEvent, AgentSessionUsage, SessionContent, SessionSummary, AgentSessionReader, AgentRunner, TurnStartedEvent, TurnDiffEvent, ApprovalView, ApprovalRequestedEvent, ApprovalResolvedEvent, } from './types.js';
 export { resolveAgentChoices } from './resolve-agent-choices.js';
 export { syncAgentChoices } from './sync-agent-choices.js';

package/dist/runner/kimi/acp/runner.d.ts

@@ -46,6 +46,21 @@ export declare class KimiAcpRunner extends ConnectionBasedRunner<KimiAcpClient,
     private readonly compactPollTimeoutMs;
     /** Pending approval requests: requestId → kind + view + options. */
     private pendingApprovals;
+    /** 存活 terminal（kimi 把 Bash 执行下放客户端）：terminalId → 本地句柄。 */
+    private terminals;
+    /** terminalId 自增序号（term-1, term-2, …）。 */
+    private terminalSeq;
+    /**
+     * kimi 服务端对 Bash 工具的 tool_call/tool_call_update 通知（title='Bash'）。
+     * Bash 的真实执行走 terminal/* reverse RPC 下放客户端，tool 事件由本 runner
+     * 自产（tool_use 带命令、tool_result 带本地输出）；这些通知必须过滤，否则
+     * 卡片出现双份 Bash 面板（通知版无 rawInput、terminal embed 无 rawOutput，
+     * 只能渲染「_无输出_」）。收集到的 toolCallId 用于过滤对应的 update。
+     */
+    private bashToolCallIds;
+    /** 当前 run 的 session cwd（terminal/create 未给 cwd 时回退用）。 */
+    private activeCwd;
+    private readonly processStopper;
     /** Tracker for the in-flight prompt request — needed for cancellation. */
     private promptSettled;
     constructor(opts: KimiAcpRunnerOptions);
@@ -102,5 +117,41 @@ export declare class KimiAcpRunner extends ConnectionBasedRunner<KimiAcpClient,
      */
     private waitForCompactionRecord;
     private handleNotification;
+    /**
+     * Filter kimi's own Bash tool notifications so the run card doesn't get a
+     * duplicate, output-less Bash panel alongside the runner-produced one.
+     *
+     * - tool_call title='Bash' → remember the toolCallId, drop the notification
+     *   (the tool_use comes from terminal/create with the real command).
+     * - tool_call_update for a remembered id → drop (streaming args deltas and
+     *   the terminal embed final update; the tool_result is emitted locally).
+     * Returns true when the notification should be swallowed.
+     */
+    private filterBashNotifications;
     private handleServerRequest;
+    /**
+     * Handle a kimi terminal/* reverse RPC by spawning a one-shot local process.
+     *
+     * 契约（kimi-code acp-terminal/acpTerminalRunner.ts）：
+     *   create → 立即回 {terminalId}，进程异步跑，不阻塞 RPC；
+     *   output → 回累计 stdout（非增量，服务端按 emitted 偏移切片）；
+     *   wait_for_exit → 未退出则等 exit 再回 {exitCode, signal}；
+     *   kill/release → 杀进程并回 {}。
+     */
+    private handleTerminalRequest;
+    /**
+     * terminal/create: spawn 一次性进程（bash -c <script>），流式累积
+     * stdout(+stderr) 到缓冲，立即回 {terminalId}。
+     */
+    private handleTerminalCreate;
+    /** terminal/output: 回累计全量输出 + truncated + 当前退出状态（可未退出）。 */
+    private handleTerminalOutput;
+    /** terminal/wait_for_exit: 未退出则等 exit promise 再回 {exitCode, signal}。 */
+    private handleTerminalWaitForExit;
+    /** terminal/kill: 立即杀进程组，回 {}。 */
+    private handleTerminalKill;
+    /** terminal/release: 从 map 删除；进程仍在则一并杀，回 {}。 */
+    private handleTerminalRelease;
+    /** Kill every live terminal (dispose/connection-close 清理钩子)。 */
+    private cleanupTerminals;
 }