lark-remote 0.1.2 → 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.js

@@ -652,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;
@@ -825,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;
@@ -858,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
@@ -871,6 +873,7 @@ export class Bridge {
                     resultSubtype: finalState.resultSubtype,
                     errorMsg: finalState.errorMsg,
                     contextLength: finalContextLength,
+                    contextLimit: finalContextLimit,
                     compactCount: finalCompactCount,
                     cacheReadTokens: finalCacheReadTokens,
                     cacheCreationTokens: finalCacheCreationTokens,
@@ -887,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,
@@ -906,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,
@@ -937,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,
@@ -954,6 +960,7 @@ export class Bridge {
                 if (sawResult) {
                     await cardSession.finish(catchTerminal, {
                         contextLength: finalContextLength,
+                        contextLimit: finalContextLimit,
                         compactCount: finalCompactCount,
                         cacheReadTokens: finalCacheReadTokens,
                         cacheCreationTokens: finalCacheCreationTokens,
@@ -1048,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,

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/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;

package/dist/index.js

@@ -5,6 +5,7 @@ import { parseCliArgs, resolveConfigDir, setConfigDir, printHelp, printVersion,
 import { FeishuConnector } from './connector/index.js';
 import { ClaudeRunner, CodexExecRunner, OpencodeExecRunner, PiRunner, KimiRunner, } from './runner/index.js';
 import { AgentRegistry } from './runner/registry.js';
+import { probeAllAgents } from './runner/probe.js';
 import { SessionReaderRegistry, SessionStore } from './session/index.js';
 import { ClaudeSessionReader, CodexSessionReader, OpencodeSessionReader, PiSessionReader, KimiSessionReader, } from './session/index.js';
 import { CommandRouter, isImmediateAction, formatUsageStats, } from './router/index.js';
@@ -21,6 +22,7 @@ import { markdownDiv } from './card/collapsible.js';
 import { sessionEventPanel } from './router/card-helpers.js';
 import { newSessionButton, agentDisplayName } from './card/card-shared.js';
 import path from 'node:path';
+import fs from 'node:fs';
 /** Send auto-resume card for a restored session */
 async function sendAutoResumeCard(connector, contact, cwd, session, state) {
     if (!contact.userId)
@@ -145,14 +147,13 @@ function setupInstanceLockAndHandlers(instanceLock, logger, configDir) {
 function initializeRunner(config, configDir, cliArgs) {
     const agentRegistry = new AgentRegistry();
     // P1-15: Claude factory reads from configContainer (not closure) so runtime
-    // config changes (binary, model, effort, stopGraceMs) take effect after
+    // config changes (model, effort, stopGraceMs) take effect after
     // bridge.setConfig() + clearRunners(). Same pattern as codex/pi/kimi.
     agentRegistry.register('claude', (ws) => {
         const container = agentRegistry.getConfigContainer();
         const latestConfig = container?.current ?? config;
         const claudeConfig = latestConfig.claude;
         return new ClaudeRunner({
-            binary: claudeConfig.binary,
             model: claudeConfig.model,
             effort: claudeConfig.effort,
             stopGraceMs: claudeConfig.stopGraceMs,
@@ -170,7 +171,6 @@ function initializeRunner(config, configDir, cliArgs) {
         const latestConfig = container?.current ?? config;
         const codexConfig = getAgentConfig(latestConfig, 'codex');
         return new CodexExecRunner({
-            binary: codexConfig?.binary ?? 'codex',
             model: codexConfig?.model,
             modelProvider: codexConfig?.modelProvider,
             reasoningEffort: codexConfig?.reasoningEffort,
@@ -182,20 +182,17 @@ function initializeRunner(config, configDir, cliArgs) {
     });
     // Register OpencodeExecRunner (run mode)
     // Using `opencode run --format json --auto` instead of HTTP+SSE server mode
-    const opencodeConfig = getAgentConfig(config, 'opencode');
     // Register session reader (same instance as used by runner)
     const sessionReaderRegistry = new SessionReaderRegistry();
     sessionReaderRegistry.register('claude', new ClaudeSessionReader());
     sessionReaderRegistry.register('codex', codexSessionReader);
     // Register OpencodeSessionReader (CLI version)
     // Using `opencode session list` and `opencode export` instead of HTTP API
-    const opencodeSessionReader = new OpencodeSessionReader({
-        binary: opencodeConfig?.binary ?? 'opencode',
-    });
+    const opencodeSessionReader = new OpencodeSessionReader();
     agentRegistry.register('opencode', (ws) => {
         // Get latest config from container (set below for pi)
         const container = agentRegistry.getConfigContainer();
-        const latestConfig = container?.current;
+        const latestConfig = container?.current ?? config;
         const ocConfig = getAgentConfig(latestConfig, 'opencode');
         // Build model string with validation: provider/model format
         let model;
@@ -210,7 +207,6 @@ function initializeRunner(config, configDir, cliArgs) {
             }
         }
         return new OpencodeExecRunner({
-            binary: ocConfig?.binary ?? 'opencode',
             model,
             // P1-15: read stopGraceMs from latestConfig (not startup closure)
             stopGraceMs: latestConfig.claude?.stopGraceMs ?? DEFAULT_STOP_GRACE_MS,
@@ -230,10 +226,9 @@ function initializeRunner(config, configDir, cliArgs) {
     agentRegistry.register('pi', (ws) => {
         // 每次 factory 调用时从 registry 获取最新 config
         const container = agentRegistry.getConfigContainer();
-        const latestConfig = container?.current;
+        const latestConfig = container?.current ?? config;
         const piConf = getAgentConfig(latestConfig, 'pi');
         return new PiRunner({
-            binary: piConf?.binary ?? 'pi',
             provider: piConf?.provider ?? 'Volcano',
             model: piConf?.model ?? 'glm-5.2',
             thinking: piConf?.thinking ?? 'medium',
@@ -252,12 +247,12 @@ function initializeRunner(config, configDir, cliArgs) {
     agentRegistry.register('kimi', (ws) => {
         // 每次 factory 调用时从 registry 获取最新 config
         const container = agentRegistry.getConfigContainer();
-        const latestConfig = container?.current;
+        const latestConfig = container?.current ?? config;
         const kimiConf = getAgentConfig(latestConfig, 'kimi');
         return new KimiRunner({
-            binary: kimiConf?.binary ?? 'kimi',
             model: kimiConf?.model ?? 'kimi-code/k3',
             thinkingEffort: kimiConf?.thinkingEffort ?? 'max',
+            // P1-15: read stopGraceMs from latestConfig (not startup closure)
             stopGraceMs: latestConfig.claude?.stopGraceMs ?? DEFAULT_STOP_GRACE_MS,
             pidDir: configDir,
             workspace: ws,
@@ -273,10 +268,25 @@ function initializeRunner(config, configDir, cliArgs) {
     agentRegistry.registerDisplayName('kimi', 'Kimi');
     // 设置全局 registry，供 agentDisplayName 等全局函数使用
     AgentRegistry.setGlobalInstance(agentRegistry);
+    // Probe agent CLI availability (fire-and-forget, populates cache for /config card).
+    // Don't block startup — log unavailable agents as warnings.
+    probeAllAgents()
+        .then((availability) => {
+        const unavailable = [...availability.entries()].filter(([, ok]) => !ok).map(([kind]) => kind);
+        if (unavailable.length > 0) {
+            getLogger().warn(`[probe] agent CLI not found or not functional: ${unavailable.join(', ')}`);
+        }
+        else {
+            getLogger().info('[probe] all agent CLIs available');
+        }
+    })
+        .catch(() => {
+        // Probe failure is non-fatal; /config card will retry on open.
+    });
     return { agentRegistry, sessionReaderRegistry };
 }
 /** Setup message and card action handlers. */
-function setupMessageHandlers(connector, router, bridge, sessionStore, workspaceStore, binder, logger) {
+function setupMessageHandlers(connector, router, bridge, sessionStore, workspaceStore, binder, logger, config) {
     connector.setMessageHandler((msg) => {
         // 绑定/授权闸门：仅 owner 放行；非 owner 静默丢弃；未绑定时要求 PIN 认领
         const decision = binder.classify(msg.userId, msg.content, msg.chatId);
@@ -286,9 +296,50 @@ function setupMessageHandlers(connector, router, bridge, sessionStore, workspace
         if (decision.kind === 'pin_wrong')
             return;
         if (decision.kind === 'bind_success') {
-            void connector
-                .sendWithRetry(msg.chatId, { text: '✅ 已绑定到本账号，此后仅你可使用本应用' })
-                .catch((err) => logger.error('[binder] bind-success reply failed:', err));
+            // First-run onboarding: set default cwd + send welcome + Help card.
+            // setCwd is synchronous (outside the async closure) so that the user's
+            // next message — which will hit the `owner` branch now that
+            // startup-contact.json has been written — finds cwd already set.
+            // process.cwd() is the only sensible default: the user started
+            // lark-remote in the directory they want to work in.
+            // setCwd only when no cwd is set yet (e.g. fresh start after bind).
+            // Don't overwrite an existing cwd — the user may have already set one
+            // via /cd or a previous bind. Use realpath for canonical form (matching
+            // Claude JSONL cwd, e.g. /tmp → /private/tmp on macOS).
+            let resolvedCwd;
+            try {
+                resolvedCwd = fs.realpathSync(process.cwd());
+            }
+            catch {
+                resolvedCwd = process.cwd();
+            }
+            if (!sessionStore.getCwd(msg.userId)) {
+                sessionStore.setCwd(msg.userId, resolvedCwd);
+            }
+            void (async () => {
+                try {
+                    // Message 1: bind confirmation + status (combined to avoid
+                    // Feishu out-of-order delivery across three separate messages).
+                    await connector.sendWithRetry(msg.chatId, {
+                        text: `✅ 已绑定到本账号，此后仅你可使用本应用\n` +
+                            `📂 当前工作目录: \`${resolvedCwd}\`\n` +
+                            `🤖 默认 Agent: ${agentDisplayName(config.defaultAgent)}\n` +
+                            `💡 直接输入消息即可开始对话，或 /cd 切换目录`,
+                    });
+                    // Message 2: Help card.
+                    // Use router.cmdHelp() + manual send (without replyTo) so the Help
+                    // card appears as an independent message, not a reply to the PIN
+                    // message. router.handle('/help') would set replyTo=msg.messageId
+                    // (the PIN), causing the card to nest under the PIN in Feishu UI.
+                    const helpResult = router.cmdHelp();
+                    if (helpResult.card) {
+                        await connector.sendWithRetry(msg.chatId, { card: helpResult.card });
+                    }
+                }
+                catch (err) {
+                    logger.error('[binder] onboarding send failed:', err);
+                }
+            })();
             return;
         }
         // decision.kind === 'owner'：正常处理（不再每条覆盖 startup-contact）
@@ -486,7 +537,7 @@ async function main() {
     logger.info('config loaded');
     logger.info(`configDir = ${configDir}`);
     logger.info(`feishu.appId = ${config.feishu.appId}`);
-    logger.info(`claude.binary = ${config.claude.binary}`);
+    logger.info(`claude.model = ${config.claude.model}`);
     if (cliArgs.settings) {
         logger.info(`claude.settings = ${cliArgs.settings}`);
     }
@@ -522,7 +573,7 @@ async function main() {
         restartSpawner: () => spawnReplacementBridge(path.join(configDir, 'logs')),
         sessionReaderRegistry,
     });
-    setupMessageHandlers(connector, router, bridge, sessionStore, workspaceStore, binder, logger);
+    setupMessageHandlers(connector, router, bridge, sessionStore, workspaceStore, binder, logger, config);
     try {
         await connector.connect();
     }
@@ -532,7 +583,7 @@ async function main() {
     }
     if (binder.isBound()) {
         // 仅已绑定时发送启动通知；未绑定时不打扰（PIN 引导已在控制台输出）
-        await sendStartupHello(connector, startupContactStore);
+        await sendStartupHello(connector, startupContactStore, { dev: cliArgs.dev });
     }
     // Auto-restore: resume the persisted sessionId if available
     const restoredContact = startupContactStore.getContact();