minimal-agent 0.10.0 → 0.12.0

package/src/plugins/pluginManifest.js

@@ -0,0 +1,127 @@
+/**
+ * ============================================================
+ *  src/plugins/pluginManifest.ts —— `.claude-plugin/plugin.json` 的唯一解析处
+ * ------------------------------------------------------------
+ *  **中立叶子模块**：只做「读一份 manifest 并校验」，不发现插件、不路由命令、
+ *  不加载执行器。因此谁都可以依赖它而不会顺带拖进插件框架的其余部分 ——
+ *  `commandRouter`（命令发现）与 `vision/appGuide`（说明书发现）就是两个
+ *  互不相干的消费方。
+ *
+ *  ★ 为什么必须只有一处解析：manifest 字段一旦有两份读法就会漂移。本文件出现
+ *    之前，`appGuide` 打算自己 `existsSync(<plugin>/app)` 判断说明书目录，而
+ *    `commandRouter` 另有一套 JSON 读取 —— 同一份文件、两种理解，是那种「改了
+ *    一边、另一边悄悄不同步」的经典种子。
+ *
+ *  ★ 路径字段一律经 `resolveInsidePlugin` 收敛。manifest 是**插件作者写的数据**，
+ *    不是可信输入：`"appManuals": "../../../etc"` 或一个指向 `/` 的软链都必须
+ *    被挡住。宿主读说明书是无条件发生的（不需要用户敲命令），所以这条边界不能
+ *    指望调用方自觉。
+ * ============================================================
+ */
+import { existsSync, readFileSync, realpathSync, statSync } from 'node:fs';
+import { isAbsolute, join, relative, resolve, sep } from 'node:path';
+const MANIFEST_RELATIVE = join('.claude-plugin', 'plugin.json');
+const asString = (value) => typeof value === 'string' && value.trim() ? value.trim() : undefined;
+/**
+ * 把 manifest 里的相对路径收敛到插件目录内部。
+ *
+ * 三道闸门，任一不过即拒：
+ *   ① 不接受绝对路径 —— manifest 描述的是「我这个插件里的哪个子目录」
+ *   ② 不接受任何 `..` 段 —— 在拼接之前就挡掉，不依赖后续 resolve 的结果
+ *   ③ `realpath` 之后仍须在插件目录内 —— 挡住软链逃逸（`app -> /etc`）
+ *
+ * 返回 null 表示拒绝；理由由调用方写进 `issues`。
+ */
+export function resolveInsidePlugin(pluginRoot, candidate) {
+    const raw = candidate.trim();
+    if (!raw || isAbsolute(raw))
+        return null;
+    if (raw.split(/[\\/]/).some((segment) => segment === '..'))
+        return null;
+    const target = resolve(pluginRoot, raw);
+    const rootReal = realpathQuiet(pluginRoot);
+    const targetReal = realpathQuiet(target);
+    if (!rootReal || !targetReal)
+        return null;
+    const inside = relative(rootReal, targetReal);
+    if (inside === '' || inside.startsWith('..') || isAbsolute(inside))
+        return null;
+    // Windows 上 relative 可能返回带盘符的路径；上面 isAbsolute 已挡住，这里只是
+    // 再确认分隔符没被绕过。
+    if (inside.split(sep).some((segment) => segment === '..'))
+        return null;
+    return targetReal;
+}
+function realpathQuiet(path) {
+    try {
+        return realpathSync(path);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 读一个插件目录的 manifest。
+ *
+ * 文件不存在返回 null（那不是错误：声明式插件可以只有 `commands/`）。
+ * JSON 坏了返回带 issue 的空 manifest —— 「这份 manifest 写坏了」和「没有
+ * manifest」是两件事，前者要能被看见。
+ */
+export function readPluginManifest(pluginRoot) {
+    const manifestPath = join(pluginRoot, MANIFEST_RELATIVE);
+    if (!existsSync(manifestPath))
+        return null;
+    const issues = [];
+    let parsed = {};
+    try {
+        const raw = JSON.parse(readFileSync(manifestPath, 'utf8'));
+        if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
+            parsed = raw;
+        }
+        else {
+            issues.push('plugin.json 顶层不是对象，已按空 manifest 处理');
+        }
+    }
+    catch (error) {
+        issues.push(`plugin.json 解析失败：${error instanceof Error ? error.message : String(error)}`);
+    }
+    const appManualDirs = [];
+    const declared = parsed.appManuals;
+    const candidates = Array.isArray(declared)
+        ? declared
+        : declared === undefined ? [] : [declared];
+    for (const candidate of candidates) {
+        const text = asString(candidate);
+        if (!text) {
+            issues.push('appManuals 只接受非空字符串或字符串数组');
+            continue;
+        }
+        const resolved = resolveInsidePlugin(pluginRoot, text);
+        if (!resolved) {
+            issues.push(`appManuals "${text}" 越出插件目录或不存在，已忽略`);
+            continue;
+        }
+        if (!isDirectory(resolved)) {
+            issues.push(`appManuals "${text}" 不是目录，已忽略`);
+            continue;
+        }
+        if (!appManualDirs.includes(resolved))
+            appManualDirs.push(resolved);
+    }
+    return {
+        root: pluginRoot,
+        ...(asString(parsed.name) ? { name: asString(parsed.name) } : {}),
+        ...(asString(parsed.version) ? { version: asString(parsed.version) } : {}),
+        ...(asString(parsed.description) ? { description: asString(parsed.description) } : {}),
+        appManualDirs,
+        issues,
+    };
+}
+function isDirectory(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}

package/src/plugins/pluginManifest.ts

@@ -0,0 +1,152 @@
+/**
+ * ============================================================
+ *  src/plugins/pluginManifest.ts —— `.claude-plugin/plugin.json` 的唯一解析处
+ * ------------------------------------------------------------
+ *  **中立叶子模块**：只做「读一份 manifest 并校验」，不发现插件、不路由命令、
+ *  不加载执行器。因此谁都可以依赖它而不会顺带拖进插件框架的其余部分 ——
+ *  `commandRouter`（命令发现）与 `vision/appGuide`（说明书发现）就是两个
+ *  互不相干的消费方。
+ *
+ *  ★ 为什么必须只有一处解析：manifest 字段一旦有两份读法就会漂移。本文件出现
+ *    之前，`appGuide` 打算自己 `existsSync(<plugin>/app)` 判断说明书目录，而
+ *    `commandRouter` 另有一套 JSON 读取 —— 同一份文件、两种理解，是那种「改了
+ *    一边、另一边悄悄不同步」的经典种子。
+ *
+ *  ★ 路径字段一律经 `resolveInsidePlugin` 收敛。manifest 是**插件作者写的数据**，
+ *    不是可信输入：`"appManuals": "../../../etc"` 或一个指向 `/` 的软链都必须
+ *    被挡住。宿主读说明书是无条件发生的（不需要用户敲命令），所以这条边界不能
+ *    指望调用方自觉。
+ * ============================================================
+ */
+
+import { existsSync, readFileSync, realpathSync, statSync } from 'node:fs';
+import { isAbsolute, join, relative, resolve, sep } from 'node:path';
+
+/** 解析并校验后的 manifest。字段缺失一律 undefined，不造默认值。 */
+export interface PluginManifestFile {
+  /** 插件目录绝对路径 */
+  root: string;
+  /** 声明的名字；缺省由调用方回落到目录名 */
+  name?: string;
+  version?: string;
+  description?: string;
+  /**
+   * 该插件提供的**应用说明书**目录（绝对路径，已做安全收敛且确认存在）。
+   *
+   * manifest 里写相对路径，可以是单个字符串或数组：
+   *   `"appManuals": "app"` / `"appManuals": ["app", "app-extra"]`
+   *
+   * 这是**显式 opt-in**：没声明就不提供说明书。在此之前是纯目录约定
+   * （任何插件目录下的 `app` 子目录自动生效），等于「任意目录自动影响可信内核」。
+   */
+  appManualDirs: string[];
+  /** 校验中发现的问题（作者可见），不影响其余字段可用。 */
+  issues: string[];
+}
+
+const MANIFEST_RELATIVE = join('.claude-plugin', 'plugin.json');
+
+const asString = (value: unknown): string | undefined =>
+  typeof value === 'string' && value.trim() ? value.trim() : undefined;
+
+/**
+ * 把 manifest 里的相对路径收敛到插件目录内部。
+ *
+ * 三道闸门，任一不过即拒：
+ *   ① 不接受绝对路径 —— manifest 描述的是「我这个插件里的哪个子目录」
+ *   ② 不接受任何 `..` 段 —— 在拼接之前就挡掉，不依赖后续 resolve 的结果
+ *   ③ `realpath` 之后仍须在插件目录内 —— 挡住软链逃逸（`app -> /etc`）
+ *
+ * 返回 null 表示拒绝；理由由调用方写进 `issues`。
+ */
+export function resolveInsidePlugin(pluginRoot: string, candidate: string): string | null {
+  const raw = candidate.trim();
+  if (!raw || isAbsolute(raw)) return null;
+  if (raw.split(/[\\/]/).some((segment) => segment === '..')) return null;
+
+  const target = resolve(pluginRoot, raw);
+  const rootReal = realpathQuiet(pluginRoot);
+  const targetReal = realpathQuiet(target);
+  if (!rootReal || !targetReal) return null;
+
+  const inside = relative(rootReal, targetReal);
+  if (inside === '' || inside.startsWith('..') || isAbsolute(inside)) return null;
+  // Windows 上 relative 可能返回带盘符的路径；上面 isAbsolute 已挡住，这里只是
+  // 再确认分隔符没被绕过。
+  if (inside.split(sep).some((segment) => segment === '..')) return null;
+
+  return targetReal;
+}
+
+function realpathQuiet(path: string): string | null {
+  try {
+    return realpathSync(path);
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 读一个插件目录的 manifest。
+ *
+ * 文件不存在返回 null（那不是错误：声明式插件可以只有 `commands/`）。
+ * JSON 坏了返回带 issue 的空 manifest —— 「这份 manifest 写坏了」和「没有
+ * manifest」是两件事，前者要能被看见。
+ */
+export function readPluginManifest(pluginRoot: string): PluginManifestFile | null {
+  const manifestPath = join(pluginRoot, MANIFEST_RELATIVE);
+  if (!existsSync(manifestPath)) return null;
+
+  const issues: string[] = [];
+  let parsed: Record<string, unknown> = {};
+  try {
+    const raw = JSON.parse(readFileSync(manifestPath, 'utf8')) as unknown;
+    if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
+      parsed = raw as Record<string, unknown>;
+    } else {
+      issues.push('plugin.json 顶层不是对象，已按空 manifest 处理');
+    }
+  } catch (error) {
+    issues.push(`plugin.json 解析失败：${error instanceof Error ? error.message : String(error)}`);
+  }
+
+  const appManualDirs: string[] = [];
+  const declared = parsed.appManuals;
+  const candidates = Array.isArray(declared)
+    ? declared
+    : declared === undefined ? [] : [declared];
+  for (const candidate of candidates) {
+    const text = asString(candidate);
+    if (!text) {
+      issues.push('appManuals 只接受非空字符串或字符串数组');
+      continue;
+    }
+    const resolved = resolveInsidePlugin(pluginRoot, text);
+    if (!resolved) {
+      issues.push(`appManuals "${text}" 越出插件目录或不存在，已忽略`);
+      continue;
+    }
+    if (!isDirectory(resolved)) {
+      issues.push(`appManuals "${text}" 不是目录，已忽略`);
+      continue;
+    }
+    if (!appManualDirs.includes(resolved)) appManualDirs.push(resolved);
+  }
+
+  return {
+    root: pluginRoot,
+    ...(asString(parsed.name) ? { name: asString(parsed.name)! } : {}),
+    ...(asString(parsed.version) ? { version: asString(parsed.version)! } : {}),
+    ...(asString(parsed.description) ? { description: asString(parsed.description)! } : {}),
+    appManualDirs,
+    issues,
+  };
+}
+
+function isDirectory(path: string): boolean {
+  try {
+    return statSync(path).isDirectory();
+  } catch {
+    return false;
+  }
+}

package/src/plugins/pluginRunner.js

@@ -13,9 +13,9 @@
  *          未知的 /xxx 当普通用户输入处理，不报错）
  * ============================================================
  */
-import { discoverPlugins, resolveCommand, buildCommandInput, } from './commandRouter.js';
-import { loadPluginApi } from './pluginLoader.js';
 import { runQuery } from '../loop.js';
+import { buildCommandInput, discoverPlugins, resolveCommand, } from './commandRouter.js';
+import { loadPluginApi } from './pluginLoader.js';
 export async function* runWithPlugins(userInput, options) {
     const { provider, history, signal } = options;
     const isSlashCommand = userInput.trimStart().startsWith('/');
@@ -23,14 +23,21 @@ export async function* runWithPlugins(userInput, options) {
         yield* runQuery(userInput, {
             provider,
             history,
+            runtimeContext: options.runtimeContext,
+            allowedTools: options.allowedTools,
             signal,
             maxTurns: options.maxTurns,
             sessionState: options.sessionState,
             chat: options.chat,
             executeTool: options.executeTool,
+            commitFormalDelivery: options.commitFormalDelivery,
             toolGate: options.toolGate,
             transientContext: options.transientContext,
+            transientBundle: options.transientBundle,
+            promptCache: options.promptCache,
             userAttachments: options.userAttachments,
+            userMessageId: options.userMessageId,
+            userBrowserReferences: options.userBrowserReferences,
             imageInputs: options.imageInputs,
             parseInlineImages: options.parseInlineImages,
             imageDetail: options.imageDetail,
@@ -39,6 +46,9 @@ export async function* runWithPlugins(userInput, options) {
             onToolStart: options.onToolStart,
             onToolEnd: options.onToolEnd,
             browserRun: options.browserRun,
+            computerRun: options.computerRun,
+            computerIntervention: options.computerIntervention,
+            memoryContext: options.memoryContext,
         });
         return;
     }
@@ -53,14 +63,21 @@ export async function* runWithPlugins(userInput, options) {
         yield* runQuery(userInput, {
             provider,
             history,
+            runtimeContext: options.runtimeContext,
+            allowedTools: options.allowedTools,
             signal,
             maxTurns: options.maxTurns,
             sessionState: options.sessionState,
             chat: options.chat,
             executeTool: options.executeTool,
+            commitFormalDelivery: options.commitFormalDelivery,
             toolGate: options.toolGate,
             transientContext: options.transientContext,
+            transientBundle: options.transientBundle,
+            promptCache: options.promptCache,
             userAttachments: options.userAttachments,
+            userMessageId: options.userMessageId,
+            userBrowserReferences: options.userBrowserReferences,
             imageInputs: options.imageInputs,
             parseInlineImages: options.parseInlineImages,
             imageDetail: options.imageDetail,
@@ -69,6 +86,9 @@ export async function* runWithPlugins(userInput, options) {
             onToolStart: options.onToolStart,
             onToolEnd: options.onToolEnd,
             browserRun: options.browserRun,
+            computerRun: options.computerRun,
+            computerIntervention: options.computerIntervention,
+            memoryContext: options.memoryContext,
         });
         return;
     }
@@ -82,6 +102,21 @@ export async function* runWithPlugins(userInput, options) {
             sessionState: options.sessionState,
             maxTurns: options.maxTurns,
             transientContext: options.transientContext,
+            transientBundle: options.transientBundle,
+            promptCache: options.promptCache,
+            runtimeContext: options.runtimeContext,
+            allowedTools: options.allowedTools,
+            executeTool: options.executeTool,
+            // ⚠️ 宿主授权上下文**必须**跟着走。这一处曾经漏掉，而下面两条 runQuery 路径
+            // 都带着它 —— 于是富插件成了三条路里唯一拿不到 browserRun/computerRun 的那条。
+            // 后果不是"少个字段"：workflow 里调 ComputerUse 恒返回「当前宿主未启用
+            // Computer Use」，同一个工具在主循环里却好好的，症状完全指不向这里。
+            host: {
+                browserRun: options.browserRun,
+                computerRun: options.computerRun,
+                computerIntervention: options.computerIntervention,
+                toolGate: options.toolGate,
+            },
         });
         return;
     }
@@ -90,14 +125,21 @@ export async function* runWithPlugins(userInput, options) {
     yield* runQuery(promptInput, {
         provider,
         history,
+        runtimeContext: options.runtimeContext,
+        allowedTools: options.allowedTools,
         signal,
         maxTurns: options.maxTurns,
         sessionState: options.sessionState,
         chat: options.chat,
         executeTool: options.executeTool,
+        commitFormalDelivery: options.commitFormalDelivery,
         toolGate: options.toolGate,
         transientContext: options.transientContext,
+        transientBundle: options.transientBundle,
+        promptCache: options.promptCache,
         userAttachments: options.userAttachments,
+        userMessageId: options.userMessageId,
+        userBrowserReferences: options.userBrowserReferences,
         imageInputs: options.imageInputs,
         parseInlineImages: options.parseInlineImages,
         imageDetail: options.imageDetail,
@@ -106,5 +148,8 @@ export async function* runWithPlugins(userInput, options) {
         onToolStart: options.onToolStart,
         onToolEnd: options.onToolEnd,
         browserRun: options.browserRun,
+        computerRun: options.computerRun,
+        computerIntervention: options.computerIntervention,
+        memoryContext: options.memoryContext,
     });
 }

package/src/plugins/pluginRunner.ts

@@ -0,0 +1,207 @@
+/**
+ * ============================================================
+ *  src/plugins/pluginRunner.ts —— 框架级 slash-激活分发器
+ * ------------------------------------------------------------
+ *  通用分发器，**不含任何插件特定逻辑**。
+ *
+ *  执行路径：
+ *    1) 非 / 输入 → 直接透传 runQuery（T-A-O-R 红线，零插件副作用）
+ *    2) / 输入 → discoverPlugins → resolveCommand
+ *       a) 命中插件且其 plugin.ts 暴露 runCommand → 让 plugin.ts 接管
+ *       b) 命中插件但只有声明式 commands/*.md → 把 prompt 拼好喂给 runQuery
+ *       c) 未命中 → 静默透传 runQuery（/ 只是激活前缀，不是严格命令系统；
+ *          未知的 /xxx 当普通用户输入处理，不报错）
+ * ============================================================
+ */
+
+import { type RunQueryOptions, runQuery } from '../loop.js';
+import type { LoopEvent, Message, Provider } from '../types.js';
+import {
+  buildCommandInput,
+  discoverPlugins,
+  resolveCommand,
+} from './commandRouter.js';
+import type { PluginEvent } from './pluginApi.js';
+import { loadPluginApi } from './pluginLoader.js';
+
+export interface PluginRunnerOptions {
+  provider: Provider;
+  history: Message[];
+  runtimeContext?: RunQueryOptions['runtimeContext'];
+  allowedTools?: RunQueryOptions['allowedTools'];
+  signal?: AbortSignal;
+  maxTurns?: number;
+  sessionState?: import('../session/sessionState.js').SessionState;
+  /**
+   * DI：把 chat / executeTool 透传给底层 runQuery（仅测试用，生产不传走默认实现）。
+   * 让测试用显式注入替代 mock.module(loop.js)——后者会全局泄漏污染其它测试文件。
+   */
+  chat?: RunQueryOptions['chat'];
+  executeTool?: RunQueryOptions['executeTool'];
+  commitFormalDelivery?: RunQueryOptions['commitFormalDelivery'];
+  /** 工具执行闸门（生产用）：透传给 runQuery。见 src/toolGate.ts。 */
+  toolGate?: RunQueryOptions['toolGate'];
+  transientContext?: RunQueryOptions['transientContext'];
+  transientBundle?: RunQueryOptions['transientBundle'];
+  promptCache?: RunQueryOptions['promptCache'];
+  userAttachments?: RunQueryOptions['userAttachments'];
+  userMessageId?: RunQueryOptions['userMessageId'];
+  userBrowserReferences?: RunQueryOptions['userBrowserReferences'];
+  imageInputs?: RunQueryOptions['imageInputs'];
+  parseInlineImages?: RunQueryOptions['parseInlineImages'];
+  imageDetail?: RunQueryOptions['imageDetail'];
+  imageMaxLongSidePixel?: RunQueryOptions['imageMaxLongSidePixel'];
+  hasQueuedInput?: RunQueryOptions['hasQueuedInput'];
+  onToolStart?: RunQueryOptions['onToolStart'];
+  onToolEnd?: RunQueryOptions['onToolEnd'];
+  browserRun?: RunQueryOptions['browserRun'];
+  computerRun?: RunQueryOptions['computerRun'];
+  computerIntervention?: RunQueryOptions['computerIntervention'];
+  memoryContext?: RunQueryOptions['memoryContext'];
+}
+
+export async function* runWithPlugins(
+  userInput: string,
+  options: PluginRunnerOptions,
+): AsyncGenerator<LoopEvent | PluginEvent, void, void> {
+  const { provider, history, signal } = options;
+  const isSlashCommand = userInput.trimStart().startsWith('/');
+
+  if (!isSlashCommand) {
+    yield* runQuery(userInput, {
+      provider,
+      history,
+      runtimeContext: options.runtimeContext,
+      allowedTools: options.allowedTools,
+      signal,
+      maxTurns: options.maxTurns,
+      sessionState: options.sessionState,
+      chat: options.chat,
+      executeTool: options.executeTool,
+      commitFormalDelivery: options.commitFormalDelivery,
+      toolGate: options.toolGate,
+      transientContext: options.transientContext,
+      transientBundle: options.transientBundle,
+      promptCache: options.promptCache,
+      userAttachments: options.userAttachments,
+      userMessageId: options.userMessageId,
+      userBrowserReferences: options.userBrowserReferences,
+      imageInputs: options.imageInputs,
+      parseInlineImages: options.parseInlineImages,
+      imageDetail: options.imageDetail,
+      imageMaxLongSidePixel: options.imageMaxLongSidePixel,
+      hasQueuedInput: options.hasQueuedInput,
+      onToolStart: options.onToolStart,
+      onToolEnd: options.onToolEnd,
+      browserRun: options.browserRun,
+      computerRun: options.computerRun,
+      computerIntervention: options.computerIntervention,
+      memoryContext: options.memoryContext,
+    });
+    return;
+  }
+
+  // 确保插件已发现（resolveCommand 依赖 pluginCache）
+  await discoverPlugins();
+  const matched = resolveCommand(userInput);
+
+  if (!matched) {
+    // 未命中任何插件命令 → 静默透传 runQuery。
+    // / 只是激活前缀（类似 Claude Code 的 / 模式），不是严格命令系统。
+    // 用户可能输入 /init、/help、/任何东西 —— 不匹配就当普通对话处理，
+    // 让 LLM 自行理解意图。不报错、不提示、不打断用户体验。
+    yield* runQuery(userInput, {
+      provider,
+      history,
+      runtimeContext: options.runtimeContext,
+      allowedTools: options.allowedTools,
+      signal,
+      maxTurns: options.maxTurns,
+      sessionState: options.sessionState,
+      chat: options.chat,
+      executeTool: options.executeTool,
+      commitFormalDelivery: options.commitFormalDelivery,
+      toolGate: options.toolGate,
+      transientContext: options.transientContext,
+      transientBundle: options.transientBundle,
+      promptCache: options.promptCache,
+      userAttachments: options.userAttachments,
+      userMessageId: options.userMessageId,
+      userBrowserReferences: options.userBrowserReferences,
+      imageInputs: options.imageInputs,
+      parseInlineImages: options.parseInlineImages,
+      imageDetail: options.imageDetail,
+      imageMaxLongSidePixel: options.imageMaxLongSidePixel,
+      hasQueuedInput: options.hasQueuedInput,
+      onToolStart: options.onToolStart,
+      onToolEnd: options.onToolEnd,
+      browserRun: options.browserRun,
+      computerRun: options.computerRun,
+      computerIntervention: options.computerIntervention,
+      memoryContext: options.memoryContext,
+    });
+    return;
+  }
+
+  // 优先 plugin.ts.runCommand（富插件接管）
+  const api = await loadPluginApi(matched.cmd.pluginRoot);
+  if (api?.runCommand) {
+    yield* api.runCommand(matched.cmd.name, matched.arguments, {
+      provider,
+      history,
+      signal,
+      sessionState: options.sessionState,
+      maxTurns: options.maxTurns,
+      transientContext: options.transientContext,
+      transientBundle: options.transientBundle,
+      promptCache: options.promptCache,
+      runtimeContext: options.runtimeContext,
+      allowedTools: options.allowedTools,
+      executeTool: options.executeTool,
+      // ⚠️ 宿主授权上下文**必须**跟着走。这一处曾经漏掉，而下面两条 runQuery 路径
+      // 都带着它 —— 于是富插件成了三条路里唯一拿不到 browserRun/computerRun 的那条。
+      // 后果不是"少个字段"：workflow 里调 ComputerUse 恒返回「当前宿主未启用
+      // Computer Use」，同一个工具在主循环里却好好的，症状完全指不向这里。
+      host: {
+        browserRun: options.browserRun,
+        computerRun: options.computerRun,
+        computerIntervention: options.computerIntervention,
+        toolGate: options.toolGate,
+      },
+    });
+    return;
+  }
+
+  // 声明式 fallback：把 markdown 命令体拼成 prompt 喂 LLM
+  const promptInput = buildCommandInput(matched);
+  yield* runQuery(promptInput, {
+    provider,
+    history,
+    runtimeContext: options.runtimeContext,
+    allowedTools: options.allowedTools,
+    signal,
+    maxTurns: options.maxTurns,
+    sessionState: options.sessionState,
+    chat: options.chat,
+    executeTool: options.executeTool,
+    commitFormalDelivery: options.commitFormalDelivery,
+    toolGate: options.toolGate,
+    transientContext: options.transientContext,
+    transientBundle: options.transientBundle,
+    promptCache: options.promptCache,
+    userAttachments: options.userAttachments,
+    userMessageId: options.userMessageId,
+    userBrowserReferences: options.userBrowserReferences,
+    imageInputs: options.imageInputs,
+    parseInlineImages: options.parseInlineImages,
+    imageDetail: options.imageDetail,
+    imageMaxLongSidePixel: options.imageMaxLongSidePixel,
+    hasQueuedInput: options.hasQueuedInput,
+    onToolStart: options.onToolStart,
+    onToolEnd: options.onToolEnd,
+    browserRun: options.browserRun,
+    computerRun: options.computerRun,
+    computerIntervention: options.computerIntervention,
+    memoryContext: options.memoryContext,
+  });
+}