lark-remote 0.5.19 → 0.5.20

package/dist/config/codex-config.js

@@ -392,6 +392,123 @@ function extractCustomProvider(providers) {
     const keys = Object.keys(providers);
     return keys.find((k) => k !== 'openai' && k !== 'anthropic');
 }
+/**
+ * 管线第 1 段（IO）：读 + 解析 config.toml，不做任何语义解释。
+ * - missing：文件不存在；
+ * - parsed：TOML 解析成功（内容后续由 normalizeProviders 解释）；
+ * - invalid：读取/解析抛错（含 TOCTOU 窗口内的文件损坏）——错误在此分类收口，
+ *   消费方（loadCodexConfig）据此走「解析失败」兜底，绝不向上抛异常。
+ */
+function readCodexToml(codexHome) {
+    const configFile = path.join(codexHome, 'config.toml');
+    if (!fs.existsSync(configFile))
+        return { state: 'missing' };
+    try {
+        const raw = fs.readFileSync(configFile, 'utf-8');
+        return { state: 'parsed', parsed: TOML.parse(raw) };
+    }
+    catch {
+        return { state: 'invalid' };
+    }
+}
+/**
+ * 管线第 2 段（纯转换）：把已解析的 TOML + 目录上下文归一成 provider/model 事实。
+ * Model filtering strategy:
+ * - Custom provider: model from config.toml (single model)
+ * - openai: all bundled models
+ * - anthropic: bundled models with 'claude-*' prefix
+ */
+function normalizeProviders(parsed, ctx) {
+    const { catalogMode, catalogSlugs, allModels, anthropicModels } = ctx;
+    const modelKeyRaw = typeof parsed.model === 'string' && parsed.model.length > 0 ? parsed.model : undefined;
+    const currentProvider = String(parsed.model_provider ?? FALLBACK_PROVIDERS[0]);
+    // Extract model_providers section
+    const modelProviders = (parsed.model_providers ?? {});
+    const rawProviderNames = Object.keys(modelProviders);
+    if (catalogMode) {
+        // catalog 模式：provider 列表 = 内置 openai + [model_providers.*]（对齐 codex
+        // merge_configured_model_providers(built_in_model_providers, cfg.model_providers)，
+        // core/src/config/mod.rs:3655；model_provider 未声明时默认 "openai"，mod.rs:3659）。
+        // anthropic 不是 codex 内置 provider，未显式配置时不得出现。模型列表仍只来自
+        // 活动目录——openai+内置 gpt-5.x 的失效路径不因 provider 合并复活。
+        const providerNames = rawProviderNames.includes('openai')
+            ? rawProviderNames
+            : ['openai', ...rawProviderNames];
+        const providerEnvKeys = { openai: 'OPENAI_API_KEY' };
+        for (const [name, config] of Object.entries(modelProviders)) {
+            if (typeof config.env_key === 'string') {
+                providerEnvKeys[name] = config.env_key;
+            }
+        }
+        // 活动目录全局：codex 运行时 provider 与模型无绑定（StaticModelsManager），
+        // 每个 provider 下拉都展示目录全部 slug
+        // 活动目录不可用（命令失败/空）时回退 [currentModel]——无目录元数据时档位/能力
+        // 不可信；禁止泄漏 FALLBACK_MODELS/内置目录。model 键缺失时不得虚构 'o3'。
+        const catalogCurrentModel = modelKeyRaw ?? catalogSlugs[0] ?? '';
+        const providerModelList = catalogSlugs.length > 0 ? catalogSlugs : modelKeyRaw ? [modelKeyRaw] : [];
+        const providerModels = {};
+        for (const name of providerNames) {
+            providerModels[name] = providerModelList;
+        }
+        const resolvedProvider = typeof parsed.model_provider === 'string' && parsed.model_provider.length > 0
+            ? parsed.model_provider
+            : 'openai';
+        return {
+            currentModel: catalogCurrentModel,
+            currentProvider: resolvedProvider,
+            providerNames,
+            providerEnvKeys,
+            providerModels,
+        };
+    }
+    // fallback 模式：保持原行为（openai/anthropic 内置 + bundled 模型）
+    const currentModel = modelKeyRaw ?? catalogSlugs[0] ?? 'o3';
+    const providerNames = rawProviderNames;
+    if (!providerNames.includes('openai')) {
+        providerNames.unshift('openai');
+    }
+    const customProvider = extractCustomProvider(modelProviders);
+    const providerEnvKeys = {};
+    providerEnvKeys['openai'] = 'OPENAI_API_KEY';
+    for (const [name, config] of Object.entries(modelProviders)) {
+        if (typeof config.env_key === 'string') {
+            providerEnvKeys[name] = config.env_key;
+        }
+    }
+    // anthropic 显式配置但未写 env_key 时保留默认键（恢复旧版无条件映射的
+    // 配置场景行为；未配置时不再虚构）
+    if (rawProviderNames.includes('anthropic') &&
+        !modelProviders['anthropic']?.env_key &&
+        providerEnvKeys['anthropic'] === undefined) {
+        providerEnvKeys['anthropic'] = 'ANTHROPIC_API_KEY';
+    }
+    const providerModels = { openai: allModels };
+    // anthropic 仅在用户显式配置时才存在（非 codex 内置 provider）
+    if (rawProviderNames.includes('anthropic')) {
+        providerModels['anthropic'] = anthropicModels;
+    }
+    if (customProvider) {
+        // Custom provider: use the model from config.toml
+        providerModels[customProvider] = [currentModel];
+    }
+    return {
+        currentModel,
+        currentProvider,
+        providerNames,
+        providerEnvKeys,
+        providerModels,
+    };
+}
+/**
+ * 管线第 3 段（纯装配）：给 provider 事实挂上 modelOptions 查询闭包，产出
+ * 对外的 CodexConfigResult。
+ */
+function applyProfiles(profile) {
+    return {
+        ...profile,
+        modelOptions: (provider) => buildModelOptions(profile.currentModel, profile.currentProvider, provider, profile.providerModels),
+    };
+}
 /**
  * Read codex config.toml, extract provider and model info
  *
@@ -401,8 +518,9 @@ function extractCustomProvider(providers) {
  * - anthropic: bundled models with 'claude-*' prefix
  */
 export function loadCodexConfig(opts = {}) {
+    // 红线：resolveCodexHome 环境变量优先级（codexHome 参数 > $CODEX_HOME > ~/.codex）
+    // 只在此解析一次，下游各段共用同一 codexHome，不得重复解析。
     const codexHome = resolveCodexHome(opts.codexHome);
-    const configFile = path.join(codexHome, 'config.toml');
     const catalogMode = isCodexCatalogMode(codexHome);
     // 统一目录来源：catalog 模式 = 活动目录（model_catalog_json 整体替换内置目录）；
     // 否则 = bundled（与原行为一致）
@@ -413,111 +531,21 @@ export function loadCodexConfig(opts = {}) {
     const anthropicModels = catalogSlugs.length > 0
         ? catalogSlugs.filter((m) => m.startsWith('claude-'))
         : ANTHROPIC_FALLBACK_MODELS;
-    if (!fs.existsSync(configFile)) {
+    const toml = readCodexToml(codexHome);
+    if (toml.state === 'missing') {
         // 无 config.toml：默认模型取目录首个可用模型（codex default_model_from_available），
         // 目录不可用时回退 'o3'（FALLBACK_MODELS 首项，非 catalog 默认）
         const currentModel = allModels[0] ?? 'o3';
         // No config file: only openai has bundled models
-        const providerModels = {
-            openai: allModels,
-        };
-        return {
+        return applyProfiles({
             currentModel,
             currentProvider: FALLBACK_PROVIDERS[0],
             providerNames: FALLBACK_PROVIDERS,
             providerEnvKeys: { openai: 'OPENAI_API_KEY' },
-            providerModels,
-            modelOptions: (provider) => buildModelOptions(currentModel, FALLBACK_PROVIDERS[0], provider, providerModels),
-        };
-    }
-    try {
-        const raw = fs.readFileSync(configFile, 'utf-8');
-        const parsed = TOML.parse(raw);
-        const modelKeyRaw = typeof parsed.model === 'string' && parsed.model.length > 0 ? parsed.model : undefined;
-        const currentProvider = String(parsed.model_provider ?? FALLBACK_PROVIDERS[0]);
-        // Extract model_providers section
-        const modelProviders = (parsed.model_providers ?? {});
-        const rawProviderNames = Object.keys(modelProviders);
-        let providerNames;
-        let providerEnvKeys;
-        let providerModels;
-        if (catalogMode) {
-            // catalog 模式：provider 列表 = 内置 openai + [model_providers.*]（对齐 codex
-            // merge_configured_model_providers(built_in_model_providers, cfg.model_providers)，
-            // core/src/config/mod.rs:3655；model_provider 未声明时默认 "openai"，mod.rs:3659）。
-            // anthropic 不是 codex 内置 provider，未显式配置时不得出现。模型列表仍只来自
-            // 活动目录——openai+内置 gpt-5.x 的失效路径不因 provider 合并复活。
-            providerNames = rawProviderNames.includes('openai')
-                ? rawProviderNames
-                : ['openai', ...rawProviderNames];
-            providerEnvKeys = { openai: 'OPENAI_API_KEY' };
-            for (const [name, config] of Object.entries(modelProviders)) {
-                if (typeof config.env_key === 'string') {
-                    providerEnvKeys[name] = config.env_key;
-                }
-            }
-            // 活动目录全局：codex 运行时 provider 与模型无绑定（StaticModelsManager），
-            // 每个 provider 下拉都展示目录全部 slug
-            // 活动目录不可用（命令失败/空）时回退 [currentModel]——无目录元数据时档位/能力
-            // 不可信；禁止泄漏 FALLBACK_MODELS/内置目录。model 键缺失时不得虚构 'o3'。
-            const catalogCurrentModel = modelKeyRaw ?? catalogSlugs[0] ?? '';
-            const providerModelList = catalogSlugs.length > 0 ? catalogSlugs : modelKeyRaw ? [modelKeyRaw] : [];
-            providerModels = {};
-            for (const name of providerNames) {
-                providerModels[name] = providerModelList;
-            }
-            const resolvedProvider = typeof parsed.model_provider === 'string' && parsed.model_provider.length > 0
-                ? parsed.model_provider
-                : 'openai';
-            return {
-                currentModel: catalogCurrentModel,
-                currentProvider: resolvedProvider,
-                providerNames,
-                providerEnvKeys,
-                providerModels,
-                modelOptions: (provider) => buildModelOptions(catalogCurrentModel, resolvedProvider, provider, providerModels),
-            };
-        }
-        // fallback 模式：保持原行为（openai/anthropic 内置 + bundled 模型）
-        const currentModel = modelKeyRaw ?? catalogSlugs[0] ?? 'o3';
-        providerNames = rawProviderNames;
-        if (!providerNames.includes('openai')) {
-            providerNames.unshift('openai');
-        }
-        const customProvider = extractCustomProvider(modelProviders);
-        providerEnvKeys = {};
-        providerEnvKeys['openai'] = 'OPENAI_API_KEY';
-        for (const [name, config] of Object.entries(modelProviders)) {
-            if (typeof config.env_key === 'string') {
-                providerEnvKeys[name] = config.env_key;
-            }
-        }
-        // anthropic 显式配置但未写 env_key 时保留默认键（恢复旧版无条件映射的
-        // 配置场景行为；未配置时不再虚构）
-        if (rawProviderNames.includes('anthropic') &&
-            !modelProviders['anthropic']?.env_key &&
-            providerEnvKeys['anthropic'] === undefined) {
-            providerEnvKeys['anthropic'] = 'ANTHROPIC_API_KEY';
-        }
-        providerModels = { openai: allModels };
-        // anthropic 仅在用户显式配置时才存在（非 codex 内置 provider）
-        if (rawProviderNames.includes('anthropic')) {
-            providerModels['anthropic'] = anthropicModels;
-        }
-        if (customProvider) {
-            // Custom provider: use the model from config.toml
-            providerModels[customProvider] = [currentModel];
-        }
-        return {
-            currentModel,
-            currentProvider,
-            providerNames,
-            providerEnvKeys,
-            providerModels,
-            modelOptions: (provider) => buildModelOptions(currentModel, currentProvider, provider, providerModels),
-        };
+            providerModels: { openai: allModels },
+        });
     }
-    catch {
+    if (toml.state === 'invalid') {
         // config.toml 读取/解析失败：readModelCatalogJsonPath 对此返回
         // TOML_PARSE_FAILED_SENTINEL（isCodexCatalogMode → false），因此正常路径下
         // catalogMode 恒为 false，下面的 `if (catalogMode)` 分支只在两次读取之间
@@ -533,19 +561,15 @@ export function loadCodexConfig(opts = {}) {
                 modelOptions: () => [],
             };
         }
-        const currentModel = catalogSlugs[0] ?? 'o3';
-        const providerModels = {
-            openai: allModels,
-        };
-        return {
-            currentModel,
+        return applyProfiles({
+            currentModel: catalogSlugs[0] ?? 'o3',
             currentProvider: FALLBACK_PROVIDERS[0],
             providerNames: FALLBACK_PROVIDERS,
             providerEnvKeys: { openai: 'OPENAI_API_KEY' },
-            providerModels,
-            modelOptions: (provider) => buildModelOptions(currentModel, FALLBACK_PROVIDERS[0], provider, providerModels),
-        };
+            providerModels: { openai: allModels },
+        });
     }
+    return applyProfiles(normalizeProviders(toml.parsed, { catalogMode, catalogSlugs, allModels, anthropicModels }));
 }
 /**
  * Build model options for a provider.

package/dist/config/index.d.ts

@@ -4,7 +4,7 @@ export { getConfigDir } from './dir.js';
 export declare const CLAUDE_EFFORTS: readonly ["low", "medium", "high", "xhigh", "max"];
 /**
  * Claude 的权限模式取值：'default' 之外都是 CLI `--permission-mode` 的真实枚举
- * （2026-09-20 实测 claude --help：acceptEdits | auto | bypassPermissions | manual
+ * （claude --help：acceptEdits | auto | bypassPermissions | manual
  * | dontAsk | plan）。
  * 'default' 是本项目自造的值，不是 CLI 的取值 —— 它表示"不传 --permission-mode"，
  * 由 CLI 自己决定默认模式，转换在 runner/claude/session.ts 的 spawn 参数处。
@@ -27,7 +27,7 @@ export declare const DEFAULT_APPROVAL_TIMEOUT_MS: number;
 /**
  * 入站媒体默认配置（schema 默认与 connector 兜底共用，避免双源漂移）。
  *
- * 单文件上限默认 100MB：50MB 对视频偏小（2026-09-15 事故就是 mp4 被丢弃）。
+ * 单文件上限默认 100MB：50MB 对视频偏小（mp4 会被丢弃）。
  * 注意飞书侧 `type=file` 超过 100MB 必须用 Range 分片下载，而 SDK 的
  * `downloadResourceToFile` 不分片（必报 234037），所以 100 是实际可用上限
  * （inbound-message-matrix.md §4 第 4 条）。
@@ -93,6 +93,16 @@ declare const OpencodeConfigSchema: z.ZodObject<{
         turnIdleTimeoutMinutes: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
+/**
+ * pi 默认配置：schema default、src/index.ts 注册兜底与 runner 构造器兜底
+ * 三处共用，避免三抄漂移。
+ */
+export declare const PI_DEFAULTS: {
+    readonly provider: "Volcano";
+    readonly model: "glm-5.2";
+    readonly thinking: "medium";
+    readonly tools: "read,bash,edit,write,grep,find,ls";
+};
 /** Pi-specific configuration. pi is a spawn-per-message CLI like Claude. */
 declare const PiConfigSchema: z.ZodObject<{
     provider: z.ZodDefault<z.ZodString>;
@@ -107,6 +117,10 @@ declare const PiConfigSchema: z.ZodObject<{
     }>>;
     tools: z.ZodDefault<z.ZodString>;
 }, z.core.$strip>;
+/** kimi 默认模型：schema default 与 src/index.ts 注册兜底共用，避免双抄漂移。 */
+export declare const KIMI_DEFAULTS: {
+    readonly model: "kimi-code/k3";
+};
 /** Kimi-specific configuration. Pure ACP mode (persistent `kimi acp` connection). */
 declare const KimiConfigSchema: z.ZodObject<{
     model: z.ZodDefault<z.ZodString>;

package/dist/config/index.js

@@ -4,6 +4,7 @@ import path from 'node:path';
 import YAML from 'yaml';
 import { getLogger } from '../logger/index.js';
 import { atomicWrite } from '../persistence/atomic-write.js';
+import { AGENT_KINDS } from '../agent-kinds.js';
 export { getConfigDir } from './dir.js';
 // Import constants from agent config files (SSOT: Layer 1 source)
 import { KIMI_THINKING_EFFORTS } from './kimi-config.js';
@@ -11,7 +12,7 @@ import { KIMI_THINKING_EFFORTS } from './kimi-config.js';
 export const CLAUDE_EFFORTS = ['low', 'medium', 'high', 'xhigh', 'max'];
 /**
  * Claude 的权限模式取值：'default' 之外都是 CLI `--permission-mode` 的真实枚举
- * （2026-09-20 实测 claude --help：acceptEdits | auto | bypassPermissions | manual
+ * （claude --help：acceptEdits | auto | bypassPermissions | manual
  * | dontAsk | plan）。
  * 'default' 是本项目自造的值，不是 CLI 的取值 —— 它表示"不传 --permission-mode"，
  * 由 CLI 自己决定默认模式，转换在 runner/claude/session.ts 的 spawn 参数处。
@@ -55,7 +56,7 @@ export const DEFAULT_APPROVAL_TIMEOUT_MS = DEFAULTS.APPROVAL_TIMEOUT_MS;
 /**
  * 入站媒体默认配置（schema 默认与 connector 兜底共用，避免双源漂移）。
  *
- * 单文件上限默认 100MB：50MB 对视频偏小（2026-09-15 事故就是 mp4 被丢弃）。
+ * 单文件上限默认 100MB：50MB 对视频偏小（mp4 会被丢弃）。
  * 注意飞书侧 `type=file` 超过 100MB 必须用 Range 分片下载，而 SDK 的
  * `downloadResourceToFile` 不分片（必报 234037），所以 100 是实际可用上限
  * （inbound-message-matrix.md §4 第 4 条）。
@@ -141,21 +142,35 @@ const OpencodeConfigSchema = z.object({
     })
         .optional(),
 });
+/**
+ * pi 默认配置：schema default、src/index.ts 注册兜底与 runner 构造器兜底
+ * 三处共用，避免三抄漂移。
+ */
+export const PI_DEFAULTS = {
+    provider: 'Volcano',
+    model: 'glm-5.2',
+    thinking: 'medium',
+    tools: 'read,bash,edit,write,grep,find,ls',
+};
 /** Pi-specific configuration. pi is a spawn-per-message CLI like Claude. */
 const PiConfigSchema = z.object({
     /** LLM provider, e.g. 'Volcano', 'anthropic', 'openai'. */
-    provider: z.string().default('Volcano'),
+    provider: z.string().default(PI_DEFAULTS.provider),
     /** Model ID or alias, e.g. 'glm-5.2'. */
-    model: z.string().default('glm-5.2'),
+    model: z.string().default(PI_DEFAULTS.model),
     /** Thinking level: off/minimal/low/medium/high/xhigh. */
-    thinking: z.enum(PI_THINKING_LEVELS).default('medium'),
+    thinking: z.enum(PI_THINKING_LEVELS).default(PI_DEFAULTS.thinking),
     /** Comma-separated tool whitelist. */
-    tools: z.string().default('read,bash,edit,write,grep,find,ls'),
+    tools: z.string().default(PI_DEFAULTS.tools),
 });
+/** kimi 默认模型：schema default 与 src/index.ts 注册兜底共用，避免双抄漂移。 */
+export const KIMI_DEFAULTS = {
+    model: 'kimi-code/k3',
+};
 /** Kimi-specific configuration. Pure ACP mode (persistent `kimi acp` connection). */
 const KimiConfigSchema = z.object({
     /** Model ID or alias, e.g. 'kimi-code/k3'. */
-    model: z.string().default('kimi-code/k3'),
+    model: z.string().default(KIMI_DEFAULTS.model),
     /** Thinking effort，取值见 KIMI_THINKING_EFFORTS（'low' | 'high' | 'max'）。 */
     thinkingEffort: z.enum(KIMI_THINKING_EFFORTS).default('max'),
     /** Permission mode: 'manual' (approve each), 'auto' (engine decides), 'yolo' (allow all). */
@@ -307,7 +322,7 @@ export const AppConfigSchema = z.object({
     /** 入站媒体（图片/文件）落盘配置。 */
     inboundMedia: InboundMediaConfigSchema.default(InboundMediaConfigSchema.parse({})),
     /** Default agent for new runs. */
-    defaultAgent: z.enum(['claude', 'codex', 'opencode', 'pi', 'kimi', 'dsh']).default('claude'),
+    defaultAgent: z.enum(AGENT_KINDS).default('claude'),
     /** Check for updates on lark-remote startup (default: false). */
     checkUpdateOnStartup: z.boolean().default(false),
 });

package/dist/connector/index.js

@@ -204,8 +204,8 @@ function isAccessTokenRejected(err) {
  * CardStreamController 经 throttle 延迟触发 —— `controller.update()` 调完
  * `throttle.note()` 就 resolve，不等真正的 patch。失败时是一条脱离 await 链的
  * detached rejection，只能冒泡到 `process.unhandledRejection`，调用方的
- * try/catch 根本挡不住。2026-09-15 00:09 的事故正是如此：卡片 patch 时
- * socket 被关（AxiosError `ERR_SOCKET_CLOSED`），整进程退出，正在跑的 run 陪葬。
+ * try/catch 根本挡不住：卡片 patch 时 socket 被关（AxiosError `ERR_SOCKET_CLOSED`），
+ * 整进程退出，正在跑的 run 陪葬。
  *
  * 这里在唯一的底层 patch 出口上兜住：瞬态错误重试最多 PATCH_MAX_RETRIES 次，
  * 全部失败才把最后一个错误抛出去（此时上层 classifyRejection 也会判为
@@ -287,13 +287,13 @@ export class FeishuConnector {
             },
         });
         // 卡片 patch 的统一出口（观测 + 重试）：
-        // 1) 观测（2026-08-11 run 卡定格事故）：飞书业务码错误以 HTTP 200 + {code!=0}
+        // 1) 观测：飞书业务码错误以 HTTP 200 + {code!=0}
         //    返回时，lark SDK 正常 resolve、@larksuite/channel 的 patchCard 丢弃返回值，
         //    导致终态卡 patch 被业务层拒绝时全链路无日志无兜底。这里把业务码记 warn。
         //    **不在这里抛**：流式卡片的 patch 由 throttle 触发、脱离 await 链
         //    （`Throttle.fireSoon` 丢掉 doFire 的 promise），抛出即成 detached rejection。
         //    恢复链路只覆盖有 await 的调用方：见 `updateCard()` 读业务码后抛。
-        // 2) 重试（2026-09-15 socket-close 事故）：瞬态传输失败就地重试，最多
+        // 2) 重试：瞬态传输失败就地重试，最多
         //    PATCH_MAX_RETRIES 次，不把失败直接落到 unhandledRejection 打死进程。
         //    业务码是确定性失败，不进重试循环。
         // Guard: unit-test mocks may omit rawClient; skip probe installation in that case.
@@ -316,7 +316,7 @@ export class FeishuConnector {
                 return;
             // 判据是「是否携带可下载资源」（`msg.resources`），不是 `msg_type` 白名单：
             // SDK 只为 image/file/audio/video/media/sticker 五类产出非空 resources，
-            // 枚举 msg_type 必然漏（2026-09-15 事故：mp4 被当文本转发给 agent）。
+            // 枚举 msg_type 必然漏（mp4 被当文本转发给 agent）。
             // 一条消息可以**同时**产出资源事件与文本事件（post 既有文字又有图），
             // 由的装配器合并成同一个 turn。
             const hasResources = msg.resources.length > 0;
@@ -398,7 +398,7 @@ export class FeishuConnector {
             });
         }
         catch (err) {
-            getLogger().error('[feishu] inbound media detected handler failed:', err.message);
+            getLogger().error('[feishu] inbound media detected handler failed:', err);
         }
     }
     /**

package/dist/error-classification.js

@@ -44,8 +44,9 @@ export function classifyRejection(reason) {
     if (status !== undefined && status >= 500 && status < 600)
         return 'recoverable';
     // 传输层瞬态失败：连接/socket 级别，与进程状态无关。
-    // 2026-09-15 00:09 的崩溃就是这条漏了 —— AxiosError `ERR_SOCKET_CLOSED`
-    // （卡片 patch 时 socket 被关）落到 fatal → process.exit(1)，正在跑的 agent run 陪葬。
+    // 这条必须先于业务码判定：AxiosError `ERR_SOCKET_CLOSED`（卡片 patch 时
+    // socket 被关）没有 HTTP status，漏判会落到 fatal → process.exit(1)，
+    // 正在跑的 agent run 陪葬。
     if (isTransientTransportError(reason))
         return 'recoverable';
     // 飞书 API 业务错误（如 230027 外部会话无权限）—— 经 SDK throttle detach 路径逃逸的

package/dist/inbound/placeholder.d.ts

@@ -1,7 +1,7 @@
 /**
  * 入站消息结构占位符识别与剥离（纯函数，无 IO，便于表驱动测试）。
  *
- * 背景（事故 2026-09-15）：`@larksuite/channel` 把非文本消息渲染成结构占位符，
+ * 背景：`@larksuite/channel` 把非文本消息渲染成结构占位符，
  * 富文本（`post`）里的图片是 `![image](img_v3_…)` —— 首字符恰好是 `!`，于是被
  * `src/router/index.ts` 的裸前缀判定当成 bash 命令执行了整段消息。
  *

package/dist/inbound/placeholder.js

@@ -1,7 +1,7 @@
 /**
  * 入站消息结构占位符识别与剥离（纯函数，无 IO，便于表驱动测试）。
  *
- * 背景（事故 2026-09-15）：`@larksuite/channel` 把非文本消息渲染成结构占位符，
+ * 背景：`@larksuite/channel` 把非文本消息渲染成结构占位符，
  * 富文本（`post`）里的图片是 `![image](img_v3_…)` —— 首字符恰好是 `!`，于是被
  * `src/router/index.ts` 的裸前缀判定当成 bash 命令执行了整段消息。
  *