lark-remote 0.1.1 → 0.1.3

package/README.en.md

@@ -64,7 +64,6 @@ feishu:
 defaultAgent: claude
 
 claude:
-  binary: claude
   model: claude-opus-4-8
   effort: medium            # low | medium | high | xhigh | max
   # permissionMode is hardcoded to bypassPermissions (inside the runner)
@@ -79,7 +78,7 @@ logging:
   level: info               # debug | info | warn | error
 
 idle:
-  watchdogMinutes: 15       # 0 disables the idle watchdog
+  watchdogMinutes: 15       # 0 disables the idle timeout auto-stop
 ```
 
 Override the config directory with `--config-dir <path>`; override the Claude settings path with `--settings <path>` or the `CLAUDE_SETTINGS_PATH` environment variable.
@@ -98,8 +97,6 @@ lark-remote --settings ~/.claude/settings.json  # specify Claude settings file
 
 The bridge prints nothing to the terminal after startup; logs go to `~/.lark-remote/logs/YYYY-MM-DD/lark-remote-<pid>.log` (rotated daily, one subdirectory per day). Only one `lark-remote` instance is allowed per `configDir` — a duplicate start fails with the existing pid. After connecting to Feishu, a startup notification (with start time and pid) is sent to the most recent private chat.
 
-For automatic process restart, set up your own supervisor such as systemd, launchd, or pm2.
-
 Each agent run creates one CardKit 2.0 card that updates in place with thinking, body text, and tool summaries in real time.
 Timestamps are read from the JSONL and shown in local time as `YYYY-MM-DD HH:mm` for thinking, body, tool call/result, and session history events.
 The card clearly shows completion, error, interruption, or idle timeout at the end; the in-card "⏹ Stop" button is equivalent to `/stop`.
@@ -152,7 +149,7 @@ Full docs under [`docs/`](docs/):
 - Single-card streaming architecture and Feishu acceptance: [`docs/en/architecture/streaming-card.md`](docs/en/architecture/streaming-card.md)
 - Template for adding a new agent: [`docs/en/guides/add-new-agent.md`](docs/en/guides/add-new-agent.md)
 - Codex config card guide: [`docs/en/guides/codex-config.md`](docs/en/guides/codex-config.md)
-- Feishu CardKit 2.0 component reference: [Feishu Open Platform official docs](https://open.feishu.cn/document/feishu-cards/card-json-v2-components/component-json-v2-overview)
+- Feishu CardKit 2.0 component reference: [Official Feishu docs](https://open.feishu.cn/document/feishu-cards/card-json-v2-components/component-json-v2-overview)
 - AI collaboration rules and red lines: [`CLAUDE.md`](CLAUDE.md)
 
 > This package is a CLI tool only — no programmatic API is exposed.

package/README.md

@@ -64,7 +64,6 @@ feishu:
 defaultAgent: claude
 
 claude:
-  binary: claude
   model: claude-opus-4-8
   effort: medium            # low | medium | high | xhigh | max
   # permissionMode 硬编码为 bypassPermissions（runner 内部）
@@ -79,7 +78,7 @@ logging:
   level: info               # debug | info | warn | error
 
 idle:
-  watchdogMinutes: 15       # 0 关闭空闲看门狗
+  watchdogMinutes: 15       # 0 关闭空闲超时自动停止
 ```
 
 配置目录可用 `--config-dir <path>` 覆盖；Claude settings 路径可用 `--settings <path>` 或 `CLAUDE_SETTINGS_PATH` 环境变量覆盖。
@@ -98,8 +97,6 @@ lark-remote --settings ~/.claude/settings.json  # 指定 Claude 配置文件
 
 bridge 启动后不在终端输出，运行日志写入 `~/.lark-remote/logs/YYYY-MM-DD/lark-remote-<pid>.log`（按日期轮转，每天一个子目录）。同一 `configDir` 只允许一个 `lark-remote` 实例，重复启动会直接报错并提示已有 pid。连接飞书成功后会向最近私聊用户发送启动通知，包含启动时间和进程号。
 
-如需进程自动重启，可自行配置 systemd / launchd / pm2 等守护方案。
-
 每次 agent 运行会创建一张 CardKit 2.0 卡片，并在原地实时更新 thinking、正文和工具摘要。
 卡片会读取 JSONL 的 `timestamp`，以本地时间 `YYYY-MM-DD HH:mm` 显示 thinking、正文、tool call/result 和会话历史事件。
 结束时卡片明确显示完成、出错、中断或空闲超时；运行中的「⏹ 终止」按钮与 `/stop` 等价。

package/dist/bridge/index.d.ts

@@ -1,4 +1,4 @@
-import type { Runner, AgentRunner } from '../runner/index.js';
+import type { AgentRunner } from '../runner/index.js';
 import type { AgentRegistry } from '../runner/registry.js';
 import type { SessionReaderRegistry, SessionStore } from '../session/index.js';
 import type { AppConfig } from '../config/index.js';
@@ -51,7 +51,6 @@ export interface ActiveRunSnapshot {
     cacheCreationTokens?: number;
 }
 interface BridgeDeps {
-    runner: Runner;
     connector: BridgeChannel;
     sessionStore: SessionStore;
     config: AppConfig;
@@ -93,7 +92,6 @@ interface BridgeDeps {
  * Runner/BridgeChannel seams.
  */
 export declare class Bridge {
-    private runner;
     private connector;
     private sessionStore;
     private config;

package/dist/bridge/index.js

@@ -7,7 +7,7 @@ import { BashCardSession, capBashOutput } from '../card/bash-card-session.js';
 import { markdownDiv } from '../card/collapsible.js';
 import { sessionEventPanel } from '../router/card-helpers.js';
 import { formatUsageStats } from '../router/index.js';
-import { agentDisplayName } from '../card/card-shared.js';
+import { agentDisplayName, resumeUseButton } from '../card/card-shared.js';
 import { enforceCardBudget } from '../card/card-budget.js';
 import { normalizeResultUsage } from '../runner/common/usage.js';
 import { BashProcessRunner } from '../runner/index.js';
@@ -58,7 +58,6 @@ function terminalReactionEmoji(terminal) {
  * Runner/BridgeChannel seams.
  */
 export class Bridge {
-    runner;
     connector;
     sessionStore;
     config;
@@ -89,7 +88,6 @@ export class Bridge {
      */
     activeBashRuns = new Map();
     constructor(deps) {
-        this.runner = deps.runner;
         this.connector = deps.connector;
         this.sessionStore = deps.sessionStore;
         this.config = deps.config;
@@ -654,6 +652,7 @@ export class Bridge {
         // Final usage read from jsonl after the run completes. live stream-json does
         // not emit compact_boundary, so the live contextLength is unreliable.
         let finalContextLength;
+        let finalContextLimit;
         let finalCompactCount;
         let finalCacheReadTokens;
         let finalCacheCreationTokens;
@@ -827,6 +826,7 @@ export class Bridge {
                 ? undefined
                 : this.resolveFinalUsage(finalSessionId, cwd, agentKind);
             finalContextLength = finalUsage?.contextLength ?? contextLength;
+            finalContextLimit = finalUsage?.contextLimit;
             finalCompactCount = finalUsage?.compactCount;
             finalCumulativeTotalTokens = finalUsage?.cumulativeTotalTokens;
             finalCumulativeInputTokens = finalUsage?.cumulativeInputTokens;
@@ -860,7 +860,7 @@ export class Bridge {
                 finalCacheCreationTokens = finalUsage?.cacheCreationTokens ?? finalCacheCreationTokens;
                 finalTotalTokens = finalUsage?.totalTokens ?? finalTotalTokens;
             }
-            getLogger().info(`[bridge] final usage runId=${runId} contextLength=${finalContextLength} compactCount=${finalCompactCount ?? 'undefined'} cacheRead=${finalCacheReadTokens ?? 'undefined'} cacheCreate=${finalCacheCreationTokens ?? 'undefined'}`);
+            getLogger().info(`[bridge] final usage runId=${runId} contextLength=${finalContextLength} contextLimit=${finalContextLimit ?? 'undefined'} compactCount=${finalCompactCount ?? 'undefined'} cacheRead=${finalCacheReadTokens ?? 'undefined'} cacheCreate=${finalCacheCreationTokens ?? 'undefined'}`);
             // for-await 自然结束 = stream 关闭 = CLI 进程退出。
             // 进程退出（for-await end）= 唯一终态触发源。
             // 1) finalizing（result 已收到）-> 转 done/error + usage meta
@@ -873,6 +873,7 @@ export class Bridge {
                     resultSubtype: finalState.resultSubtype,
                     errorMsg: finalState.errorMsg,
                     contextLength: finalContextLength,
+                    contextLimit: finalContextLimit,
                     compactCount: finalCompactCount,
                     cacheReadTokens: finalCacheReadTokens,
                     cacheCreationTokens: finalCacheCreationTokens,
@@ -889,6 +890,7 @@ export class Bridge {
             else if (finalState.terminal === 'running') {
                 await cardSession.finish('error', {
                     contextLength: finalContextLength,
+                    contextLimit: finalContextLimit,
                     compactCount: finalCompactCount,
                     cacheReadTokens: finalCacheReadTokens,
                     cacheCreationTokens: finalCacheCreationTokens,
@@ -908,6 +910,7 @@ export class Bridge {
                 // 仅补充 usage meta（finalizing 期间被 /stop 或 idle 超时也展示 token 统计）
                 await cardSession.finish(finalState.terminal, {
                     contextLength: finalContextLength,
+                    contextLimit: finalContextLimit,
                     compactCount: finalCompactCount,
                     cacheReadTokens: finalCacheReadTokens,
                     cacheCreationTokens: finalCacheCreationTokens,
@@ -939,6 +942,7 @@ export class Bridge {
             if (catchTerminal === 'running' || catchTerminal === 'finalizing') {
                 await cardSession.finish('error', {
                     contextLength: finalContextLength,
+                    contextLimit: finalContextLimit,
                     compactCount: finalCompactCount,
                     cacheReadTokens: finalCacheReadTokens,
                     cacheCreationTokens: finalCacheCreationTokens,
@@ -956,6 +960,7 @@ export class Bridge {
                 if (sawResult) {
                     await cardSession.finish(catchTerminal, {
                         contextLength: finalContextLength,
+                        contextLimit: finalContextLimit,
                         compactCount: finalCompactCount,
                         cacheReadTokens: finalCacheReadTokens,
                         cacheCreationTokens: finalCacheCreationTokens,
@@ -1050,6 +1055,7 @@ export class Bridge {
             return content.usage
                 ? {
                     contextLength: content.usage.contextLength,
+                    contextLimit: content.usage.contextLimit,
                     compactCount: content.usage.compactCount,
                     cacheReadTokens: content.usage.cacheReadTokens,
                     cacheCreationTokens: content.usage.cacheCreationTokens,
@@ -1104,14 +1110,7 @@ export class Bridge {
                     {
                         tag: 'column',
                         width: 'auto',
-                        elements: [
-                            {
-                                tag: 'button',
-                                text: { tag: 'plain_text', content: '🔁 切换到此会话' },
-                                type: 'primary',
-                                behaviors: [{ type: 'callback', value: { cmd: 'resume.use', sessionId } }],
-                            },
-                        ],
+                        elements: [resumeUseButton(sessionId, agentKind)],
                     },
                 ],
             });

package/dist/card/card-budget.js

@@ -46,8 +46,7 @@ export function enforceCardBudget(card, opts = {}) {
  * when table truncation alone doesn't bring the card under the byte limit.
  *
  * 裁剪判定是**结构化**的：所有 collapsible_panel 都是待裁剪对象，不看面板
- * 标题文本。历史教训（2026-08-08，详见
- * docs/zh/architecture/resume-card-budget-failure-analysis.md）：旧实现用
+ * 标题文本。历史教训（2026-08-08）：旧实现用
  * emoji 标题模式（🤖👤💭🔧🟢🔴）识别「会话事件面板」，但真实
  * sessionEventPanel 产出的标题是裸英文 type 名（emoji 在事件正文而非标题），
  * 导致裁剪阶段对真实 resume 卡零命中，任何 >28KB 的卡片无裁剪直通极端降级，

package/dist/card/card-shared.d.ts

@@ -1,3 +1,4 @@
+import { type AgentKind } from '../runner/index.js';
 interface TruncateOptions {
     suffix?: string;
     normalizeWhitespace?: boolean;
@@ -25,4 +26,11 @@ export declare function stopButton(runId: string): object;
  * Standardized: ✨ 新会话 + primary type
  */
 export declare function newSessionButton(): object;
+/**
+ * Create a CardKit 2.0 "resume session" button with behaviors callback.
+ * Carries both sessionId and agent so the handler routes to the correct
+ * agent's session reader (P2 fix: completion cards from non-default agents
+ * must carry agent to avoid wrong-reader fallback).
+ */
+export declare function resumeUseButton(sessionId: string, agent: AgentKind): object;
 export {};

package/dist/card/card-shared.js

@@ -96,4 +96,18 @@ export function newSessionButton() {
         behaviors: [{ type: 'callback', value: { cmd: 'new-session' } }],
     };
 }
+/**
+ * Create a CardKit 2.0 "resume session" button with behaviors callback.
+ * Carries both sessionId and agent so the handler routes to the correct
+ * agent's session reader (P2 fix: completion cards from non-default agents
+ * must carry agent to avoid wrong-reader fallback).
+ */
+export function resumeUseButton(sessionId, agent) {
+    return {
+        tag: 'button',
+        text: { tag: 'plain_text', content: '🔁 切换到此会话' },
+        type: 'primary',
+        behaviors: [{ type: 'callback', value: { cmd: 'resume.use', sessionId, agent } }],
+    };
+}
 //# sourceMappingURL=card-shared.js.map

package/dist/card/run-renderer.js

@@ -776,6 +776,7 @@ function buildSummaryContent(state) {
         const empty = !hasContent ? '\n\n（未返回内容）' : '';
         const usageStatsStr = formatUsageStats({
             contextLength: state.contextLength,
+            contextLimit: state.contextLimit,
             compactCount: state.compactCount,
             cacheReadTokens: state.cacheReadTokens,
             cacheCreationTokens: state.cacheCreationTokens,

package/dist/card/run-state.d.ts

@@ -53,6 +53,8 @@ export interface RunState {
     sessionId?: string;
     resultSubtype?: 'success' | 'error';
     contextLength?: number;
+    /** 当前模型 context window 上限（codex jsonl 提供）；卡片据此渲染百分比。 */
+    contextLimit?: number;
     errorMsg?: string;
     idleTimeoutMinutes?: number;
     compactCount?: number;
@@ -79,6 +81,8 @@ export interface RunState {
 export interface FinishMeta {
     resultSubtype?: 'success' | 'error';
     contextLength?: number;
+    /** 当前模型 context window 上限；透传到 RunState 供 done 卡片显示百分比。 */
+    contextLimit?: number;
     errorMsg?: string;
     idleTimeoutMinutes?: number;
     compactCount?: number;

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

@@ -76,7 +76,7 @@ export declare function parseCodexModelsOutput(stdout: string): BundledModelInfo
  * （P3-4/P3-15/P3-5）；成功结果 TTL 1h，失败/空结果短 TTL 负缓存；stat 异常时
  * 指纹为空（P1-1/P3-10）。
  */
-export declare function getCodexCatalogModels(binary: string, codexHome?: string): BundledModelInfo[];
+export declare function getCodexCatalogModels(codexHome?: string): BundledModelInfo[];
 /**
  * Test utility: clear the catalog cache. Tests that exercise the bundled
  * command path (`--bundled`) directly use `invalidateCodexBundledTestCache`
@@ -88,18 +88,16 @@ export declare function invalidateCodexBundledCache(): void;
  * @param codexHome 可选 codex 配置目录覆盖（与 loadCodexConfig 的 codexHome 对齐，
  *   与 loadCodexConfig 的 codexHome 对齐）；省略时走 $CODEX_HOME → ~/.codex。
  */
-export declare function getReasoningEffortOptions(model: string, binary?: string, codexHome?: string): readonly string[];
+export declare function getReasoningEffortOptions(model: string, codexHome?: string): readonly string[];
 /**
  * Get default reasoning effort for a model.
  * 未声明/未知模型 → undefined（codex 语义：ModelPreset.default_reasoning_effort
  * unwrap_or(ReasoningEffort::None)，即不传 effort；P3-12）。
  */
-export declare function getDefaultReasoningEffort(model: string, binary?: string, codexHome?: string): string | undefined;
+export declare function getDefaultReasoningEffort(model: string, codexHome?: string): string | undefined;
 interface LoadCodexConfigOpts {
     /** Explicit codex home override. Default: $CODEX_HOME -> ~/.codex */
     codexHome?: string;
-    /** codex binary path, for `debug models --bundled`. Default: 'codex' */
-    binary?: string;
 }
 /**
  * Read codex config.toml, extract provider and model info

package/dist/config/codex-config.js

@@ -154,7 +154,8 @@ export function parseCodexModelsOutput(stdout) {
  * （P3-4/P3-15/P3-5）；成功结果 TTL 1h，失败/空结果短 TTL 负缓存；stat 异常时
  * 指纹为空（P1-1/P3-10）。
  */
-export function getCodexCatalogModels(binary, codexHome) {
+export function getCodexCatalogModels(codexHome) {
+    const binary = 'codex';
     const home = resolveCodexHome(codexHome);
     const catalogPath = readModelCatalogJsonPath(home);
     const bundled = catalogPath === undefined || catalogPath === TOML_PARSE_FAILED_SENTINEL;
@@ -217,8 +218,8 @@ export function invalidateCodexBundledCache() {
  * @param codexHome 可选 codex 配置目录覆盖（与 loadCodexConfig 的 codexHome 对齐，
  *   与 loadCodexConfig 的 codexHome 对齐）；省略时走 $CODEX_HOME → ~/.codex。
  */
-export function getReasoningEffortOptions(model, binary = 'codex', codexHome) {
-    const models = getCodexCatalogModels(binary, codexHome);
+export function getReasoningEffortOptions(model, codexHome) {
+    const models = getCodexCatalogModels(codexHome);
     const found = models.find((m) => m.slug === model);
     // 未命中（含未知模型，codex fallback 元数据 supported 为空）→ []，不虚构档位（P1）
     return found?.supportedReasoningLevels ?? [];
@@ -228,8 +229,8 @@ export function getReasoningEffortOptions(model, binary = 'codex', codexHome) {
  * 未声明/未知模型 → undefined（codex 语义：ModelPreset.default_reasoning_effort
  * unwrap_or(ReasoningEffort::None)，即不传 effort；P3-12）。
  */
-export function getDefaultReasoningEffort(model, binary = 'codex', codexHome) {
-    const models = getCodexCatalogModels(binary, codexHome);
+export function getDefaultReasoningEffort(model, codexHome) {
+    const models = getCodexCatalogModels(codexHome);
     return models.find((m) => m.slug === model)?.defaultReasoningLevel;
 }
 /**
@@ -249,13 +250,12 @@ function extractCustomProvider(providers) {
  * - anthropic: bundled models with 'claude-*' prefix
  */
 export function loadCodexConfig(opts = {}) {
-    const binary = opts.binary ?? 'codex';
     const codexHome = resolveCodexHome(opts.codexHome);
     const configFile = path.join(codexHome, 'config.toml');
     const catalogMode = isCodexCatalogMode(codexHome);
     // 统一目录来源：catalog 模式 = 活动目录（model_catalog_json 整体替换内置目录）；
     // 否则 = bundled（与原行为一致）
-    const catalogSlugs = getCodexCatalogModels(binary, codexHome).map((m) => m.slug);
+    const catalogSlugs = getCodexCatalogModels(codexHome).map((m) => m.slug);
     const allModels = catalogSlugs.length > 0 ? catalogSlugs : FALLBACK_MODELS;
     const anthropicModels = allModels.filter((m) => m.startsWith('claude-'));
     if (!fs.existsSync(configFile)) {

package/dist/config/dir.d.ts

@@ -1,6 +1,7 @@
 interface CliArgs {
     configDir?: string;
     settings?: string;
+    dev?: boolean;
     help?: boolean;
     version?: boolean;
 }

package/dist/config/dir.js

@@ -49,6 +49,9 @@ export function parseCliArgs(args = process.argv.slice(2)) {
                 result.settings = args[++i];
             }
         }
+        else if (arg === '--dev') {
+            result.dev = true;
+        }
     }
     return result;
 }
@@ -73,6 +76,7 @@ export function printHelp() {
         'Options:',
         '  --config-dir <path>   自定义配置目录（默认 ~/.lark-remote，可用于同机多实例）',
         '  --settings <path>     指定 Claude 配置文件路径',
+        '  --dev                 开发模式：标记从源码 bun src/index.ts 启动（看门狗据此选择拉起方式）',
         '  -h, --help            显示本帮助信息',
         '  -v, --version         显示版本号',
     ];

package/dist/config/index.d.ts

@@ -15,7 +15,6 @@ export declare const MODEL_ID_TO_ALIAS: Record<string, string>;
 /** alias → model ID 反向映射。 */
 export declare const MODEL_ALIAS_TO_ID: Record<string, string>;
 declare const ClaudeConfigSchema: z.ZodObject<{
-    binary: z.ZodDefault<z.ZodString>;
     model: z.ZodDefault<z.ZodString>;
     effort: z.ZodDefault<z.ZodEnum<{
         medium: "medium";
@@ -28,7 +27,6 @@ declare const ClaudeConfigSchema: z.ZodObject<{
 }, z.core.$strip>;
 /** Codex-specific configuration. */
 export declare const CodexConfigSchema: z.ZodObject<{
-    binary: z.ZodDefault<z.ZodString>;
     model: z.ZodOptional<z.ZodString>;
     modelProvider: z.ZodOptional<z.ZodString>;
     reasoningEffort: z.ZodOptional<z.ZodString>;
@@ -36,13 +34,11 @@ export declare const CodexConfigSchema: z.ZodObject<{
 }, z.core.$strip>;
 /** OpenCode-specific configuration (run mode: opencode run --format json --auto). */
 declare const OpencodeConfigSchema: z.ZodObject<{
-    binary: z.ZodDefault<z.ZodString>;
     providerID: z.ZodDefault<z.ZodString>;
     modelID: z.ZodDefault<z.ZodString>;
 }, z.core.$strip>;
 /** Pi-specific configuration. pi is a spawn-per-message CLI like Claude. */
 declare const PiConfigSchema: z.ZodObject<{
-    binary: z.ZodDefault<z.ZodString>;
     provider: z.ZodDefault<z.ZodString>;
     model: z.ZodDefault<z.ZodString>;
     thinking: z.ZodDefault<z.ZodEnum<{
@@ -57,7 +53,6 @@ declare const PiConfigSchema: z.ZodObject<{
 }, z.core.$strip>;
 /** Kimi-specific configuration. kimi is a spawn-per-message CLI. */
 declare const KimiConfigSchema: z.ZodObject<{
-    binary: z.ZodDefault<z.ZodString>;
     model: z.ZodDefault<z.ZodString>;
     thinkingEffort: z.ZodDefault<z.ZodEnum<{
         max: "max";
@@ -71,7 +66,6 @@ export declare const AppConfigSchema: z.ZodObject<{
         appSecret: z.ZodString;
     }, z.core.$strip>;
     claude: z.ZodDefault<z.ZodObject<{
-        binary: z.ZodDefault<z.ZodString>;
         model: z.ZodDefault<z.ZodString>;
         effort: z.ZodDefault<z.ZodEnum<{
             medium: "medium";
@@ -84,19 +78,16 @@ export declare const AppConfigSchema: z.ZodObject<{
     }, z.core.$strip>>;
     agents: z.ZodOptional<z.ZodObject<{
         codex: z.ZodOptional<z.ZodObject<{
-            binary: z.ZodDefault<z.ZodString>;
             model: z.ZodOptional<z.ZodString>;
             modelProvider: z.ZodOptional<z.ZodString>;
             reasoningEffort: z.ZodOptional<z.ZodString>;
             stopGraceMs: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>>;
         opencode: z.ZodOptional<z.ZodObject<{
-            binary: z.ZodDefault<z.ZodString>;
             providerID: z.ZodDefault<z.ZodString>;
             modelID: z.ZodDefault<z.ZodString>;
         }, z.core.$strip>>;
         pi: z.ZodOptional<z.ZodObject<{
-            binary: z.ZodDefault<z.ZodString>;
             provider: z.ZodDefault<z.ZodString>;
             model: z.ZodDefault<z.ZodString>;
             thinking: z.ZodDefault<z.ZodEnum<{
@@ -110,7 +101,6 @@ export declare const AppConfigSchema: z.ZodObject<{
             tools: z.ZodDefault<z.ZodString>;
         }, z.core.$strip>>;
         kimi: z.ZodOptional<z.ZodObject<{
-            binary: z.ZodDefault<z.ZodString>;
             model: z.ZodDefault<z.ZodString>;
             thinkingEffort: z.ZodDefault<z.ZodEnum<{
                 max: "max";

package/dist/config/index.js

@@ -13,7 +13,6 @@ export const CLAUDE_EFFORTS = ['low', 'medium', 'high', 'xhigh', 'max'];
 export const PI_THINKING_LEVELS = ['off', 'minimal', 'low', 'medium', 'high', 'xhigh'];
 /** 默认值常量：schema 与 template 共享，避免双源不一致（G25 Magic Numbers）。 */
 const DEFAULTS = {
-    CLAUDE_BINARY: 'claude',
     CLAUDE_MODEL: 'claude-opus-4-8',
     STOP_GRACE_MS: 5000,
     IDLE_WATCHDOG_MINUTES: 15,
@@ -43,7 +42,6 @@ const FeishuConfigSchema = z.object({
     appSecret: z.string().min(1),
 });
 const ClaudeConfigSchema = z.object({
-    binary: z.string().default(DEFAULTS.CLAUDE_BINARY),
     model: z.string().default(DEFAULTS.CLAUDE_MODEL),
     effort: z.enum(CLAUDE_EFFORTS).default('medium'),
     // permissionMode 硬编码为 bypassPermissions（runner 内部），不通过 config 配置
@@ -51,8 +49,6 @@ const ClaudeConfigSchema = z.object({
 });
 /** Codex-specific configuration. */
 export const CodexConfigSchema = z.object({
-    /** Path to codex binary. Default: 'codex' (in PATH). */
-    binary: z.string().default('codex'),
     /** model to use. Undefined → codex reads from its config.toml. */
     model: z.string().optional(),
     /** model provider, e.g. 'volcengine-coding-plan'. Undefined → codex reads from its config.toml. */
@@ -70,8 +66,6 @@ export const CodexConfigSchema = z.object({
 });
 /** OpenCode-specific configuration (run mode: opencode run --format json --auto). */
 const OpencodeConfigSchema = z.object({
-    /** Path to opencode binary. Default: 'opencode' (in PATH). */
-    binary: z.string().default('opencode'),
     /** Provider ID for the LLM backend (e.g. 'anthropic'). */
     providerID: z.string().default('anthropic'),
     /** Model ID for the LLM backend (e.g. 'claude-sonnet-4-20250514'). */
@@ -79,8 +73,6 @@ const OpencodeConfigSchema = z.object({
 });
 /** Pi-specific configuration. pi is a spawn-per-message CLI like Claude. */
 const PiConfigSchema = z.object({
-    /** Path to pi binary. Default: 'pi' (in PATH). */
-    binary: z.string().default('pi'),
     /** LLM provider, e.g. 'Volcano', 'anthropic', 'openai'. */
     provider: z.string().default('Volcano'),
     /** Model ID or alias, e.g. 'glm-5.2'. */
@@ -92,8 +84,6 @@ const PiConfigSchema = z.object({
 });
 /** Kimi-specific configuration. kimi is a spawn-per-message CLI. */
 const KimiConfigSchema = z.object({
-    /** Path to kimi binary. Default: 'kimi' (in PATH). */
-    binary: z.string().default('kimi'),
     /** Model ID or alias, e.g. 'kimi-code/k3'. */
     model: z.string().default('kimi-code/k3'),
     /** Thinking effort: 'on', 'max'. */
@@ -169,7 +159,6 @@ const TEMPLATE = `feishu:
   appSecret: ""
 
 claude:
-  binary: ${DEFAULTS.CLAUDE_BINARY}
   model: ${DEFAULTS.CLAUDE_MODEL}
   effort: medium
   stopGraceMs: ${DEFAULTS.STOP_GRACE_MS}

package/dist/connector/index.js

@@ -53,6 +53,14 @@ function shouldRetrySendError(err) {
         return true;
     return false;
 }
+/**
+ * Safely extract the im.v1.message.patch service from a LarkChannel.
+ * Returns undefined when the channel mock omits rawClient (unit tests).
+ */
+function tryGetPatchService(channel) {
+    const c = channel.rawClient;
+    return c?.im?.v1?.message;
+}
 export class FeishuConnector {
     channel;
     onMessage;
@@ -81,6 +89,26 @@ export class FeishuConnector {
                 },
             },
         });
+        // 观测探针（2026-08-11 run 卡定格事故）：飞书业务码错误以 HTTP 200 + {code!=0}
+        // 返回时，lark SDK 正常 resolve、@larksuite/channel 的 patchCard 丢弃返回值，
+        // 导致终态卡 patch 被业务层拒绝时全链路无日志无兜底。这里只观测不改行为——
+        // 不 throw、不重试，返回值原样透传。
+        // 详见 .adversarial-tdd/prompt-patchcard-business-code-observability.md
+        // Guard: unit-test mocks may omit rawClient; skip probe installation in that case.
+        const messageService = tryGetPatchService(this.channel);
+        if (messageService?.patch) {
+            const origPatch = messageService.patch.bind(messageService);
+            messageService.patch = (async (request, options) => {
+                const res = await origPatch(request, options);
+                if (typeof res?.code === 'number' && res.code !== 0) {
+                    const content = request?.data?.content;
+                    const bytes = typeof content === 'string' ? Buffer.byteLength(content, 'utf8') : undefined;
+                    getLogger().warn(`[feishu] message.patch business error code=${res.code} msg=${String(res.msg)} ` +
+                        `messageId=${String(request?.path?.message_id)} bytes=${bytes ?? 'unknown'}`);
+                }
+                return res;
+            });
+        }
         this.channel.on('message', (msg) => {
             if (msg.chatType !== 'p2p')
                 return;