made-bridge 0.2.3 → 0.3.0

package/src/jobs.mjs

@@ -2,7 +2,6 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { randomUUID } from 'node:crypto';
 import { SessionStore, validAgentSessionId, VIBE_SESSION_ID } from './sessions.mjs';
-import { builtinAgent } from './agents/index.mjs';
 
 const ACTIVE = new Set(['waiting_confirmation', 'queued', 'running']);
 
@@ -10,9 +9,58 @@ function now() {
   return new Date().toISOString();
 }
 
+const IMAGE_URL_RE = /\.(png|jpg|jpeg|gif|webp|bmp)(\?.*)?$/i;
+const URL_RE = /https?:\/\/[^\s"`<>]+/gi;
+const TRAILING_PUNCT_RE = /[.,;)\]]+$/;
+
+function extractUrlAttachments(text) {
+  const attachments = [];
+  const seen = new Set();
+  for (const match of String(text || '').matchAll(URL_RE)) {
+    let url = match[0];
+    while (TRAILING_PUNCT_RE.test(url)) url = url.replace(TRAILING_PUNCT_RE, '');
+    if (url.length < 8 || seen.has(url)) continue;
+    seen.add(url);
+    attachments.push({
+      type: IMAGE_URL_RE.test(url) ? 'image' : 'link',
+      url,
+      text: '',
+    });
+  }
+  return attachments;
+}
+
+function normalizeAttachments(value) {
+  if (!Array.isArray(value)) return [];
+  return value.map((a) => ({
+    type: a.type === 'image' ? 'image' : 'link',
+    url: String(a.url || ''),
+    text: String(a.text || ''),
+  })).filter((a) => a.url);
+}
+
+function mergeAttachments(result, explicit) {
+  const fromText = extractUrlAttachments(result);
+  const fromExplicit = normalizeAttachments(explicit);
+  const seen = new Set(fromText.map((a) => a.url));
+  for (const a of fromExplicit) {
+    if (!seen.has(a.url)) {
+      fromText.push(a);
+      seen.add(a.url);
+    }
+  }
+  return fromText;
+}
+
 export class JobStore {
   constructor({ file, projects, defaultProject, defaultProvider, workspaceRoot, maxParallel, maxAutoRetries, run, providerAvailable, pluginsRuntime, hooks }) {
-    this.agent = pluginsRuntime ? (id) => pluginsRuntime.agent(id) : run.agent || builtinAgent;
+    // 允许传入 () => config.pluginsRuntime，热加载替换注册表后这里读到的是新插件。
+    this.agent = pluginsRuntime
+      ? (id) => {
+          const runtime = typeof pluginsRuntime === 'function' ? pluginsRuntime() : pluginsRuntime;
+          return runtime?.agent?.(id);
+        }
+      : run.agent;
     this.hooks = hooks || null;
     this.file = file;
     this.projects = projects;
@@ -137,14 +185,51 @@ export class JobStore {
   }
 
   listSessions(provider) {
+    // 单趟找每个会话的最新任务：以前每个会话都全量拷贝+反转 jobs 再线性找，
+    // 会话×任务的 O(n²) 在 /api/state 每次轮询都跑。
+    const latestBySession = new Map();
+    for (let i = this.jobs.length - 1; i >= 0; i -= 1) {
+      const job = this.jobs[i];
+      if (!latestBySession.has(job.vibeSessionId)) latestBySession.set(job.vibeSessionId, job);
+    }
     return this.sessions.list(provider).map((session) => {
-      const latest = [...this.jobs].reverse().find((job) => job.vibeSessionId === session.id);
+      const latest = latestBySession.get(session.id);
       return { ...session, status: latest?.status || 'empty' };
     });
   }
 
+  /** 任务工作目录：workspaceRoot/<会话编号>。编号对不上就不给出路径。 */
+  workspacePath(sessionId) {
+    if (!this.workspaceRoot || !VIBE_SESSION_ID.test(sessionId || '')) return '';
+    const root = path.resolve(this.workspaceRoot);
+    const target = path.resolve(root, sessionId);
+    if (path.dirname(target) !== root) return '';
+    return target;
+  }
+
+  /** 桥接器只建空目录。助手开跑之前这个文件夹已经在。 */
+  ensureWorkspace(sessionId) {
+    const dir = this.workspacePath(sessionId);
+    if (!dir) return '';
+    fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    return dir;
+  }
+
+  removeWorkspace(sessionId) {
+    const dir = this.workspacePath(sessionId);
+    if (!dir) return;
+    fs.rmSync(dir, { recursive: true, force: true });
+  }
+
+  projectFor(job) {
+    const configured = this.projects.find((item) => item.id === job.projectId);
+    const dir = this.workspacePath(job.vibeSessionId);
+    return dir ? { ...configured, path: dir } : configured;
+  }
+
   createSession(payload) {
     const session = this.sessions.create(payload);
+    this.ensureWorkspace(session.id);
     return { ...session, status: 'empty' };
   }
 
@@ -166,6 +251,7 @@ export class JobStore {
       job.status = 'deleted';
       this.progressSavedAt.delete(job.id);
     }
+    this.removeWorkspace(id);
     this.jobs = this.jobs.filter((job) => job.vibeSessionId !== id);
     // Persist jobs first: a crash between files leaves an empty session,
     // rather than an orphan turn that load() would recreate as a new session.
@@ -296,10 +382,8 @@ export class JobStore {
         this.save();
         this.hooks?.notify('started', job);
         try {
-          const configured = this.projects.find((item) => item.id === job.projectId);
-          const project = this.workspaceRoot
-            ? { ...configured, path: path.join(this.workspaceRoot, job.vibeSessionId) }
-            : configured;
+          this.ensureWorkspace(job.vibeSessionId);
+          const project = this.projectFor(job);
           // 回合输入管道：插件可以改写本轮实际执行的指令；存储里的任务原文保持不变。
           const instruction = this.hooks ? await this.hooks.turnIn(job) : job.instruction;
           const effectiveJob = instruction === job.instruction ? job : { ...job, instruction };
@@ -337,6 +421,8 @@ export class JobStore {
             // 回合输出管道：仅在任务完成时调用，插件返回新字符串即改写结果。
             if (job.status === 'completed') result = this.hooks ? await this.hooks.turnOut(job, result) : result;
             job.result = result;
+            // 富内容附件：插件可显式下发 attachments；同时自动从 result 文本解析 URL。
+            job.attachments = mergeAttachments(job.result, outcome.attachments);
             if (outcome.handoff && typeof outcome.handoff === 'object') job.handoff = { ...outcome.handoff };
             if (job.status === 'completed' && typeof outcome.gitSnapshot === 'string') {
               this.sessions.setGitSnapshot(job.vibeSessionId, outcome.gitSnapshot);

package/src/plugin-package.mjs

@@ -76,11 +76,15 @@ export function parseSettingsSpec(raw) {
 export function resolveSettings(fields, raw) {
   if (raw === undefined || raw === null) raw = {};
   if (!raw || typeof raw !== 'object' || Array.isArray(raw)) throw fail('插件配置无效');
+  // 表单字段以插件自己的 plugin.json 为准。settings.json 里开发者另写的键
+  // 不是桥接器的预定义名单，只要键名和值合法就原样收下，不能因此整表失效。
   const known = new Set(fields.map((field) => field.key));
+  const values = {};
   for (const key of Object.keys(raw)) {
-    if (!known.has(key) || typeof raw[key] !== 'string' || Buffer.byteLength(raw[key]) > MAX_VALUE) throw fail('插件配置无效');
+    if (reserved.has(key) || !SETTING_KEY.test(key)) throw fail('插件配置无效');
+    if (typeof raw[key] !== 'string' || Buffer.byteLength(raw[key]) > MAX_VALUE) throw fail('插件配置无效');
+    if (!known.has(key)) values[key] = raw[key];
   }
-  const values = {};
   for (const field of fields) {
     const value = Object.hasOwn(raw, field.key) ? raw[field.key] : (field.default ?? '');
     if (field.required && !value.trim()) throw fail('插件配置无效');
@@ -123,7 +127,13 @@ export function writePackageSettings(dir, values) {
   const current = readPackageSettings(dir);
   if (current.error) throw fail(current.error);
   if (!current.fields.length) throw fail('插件没有可保存的配置');
-  const resolved = resolveSettings(current.fields, values);
+  // 工作台只提交 plugin.json 里的字段。写回时保留开发者另外放在 settings.json 的键。
+  const specKeys = new Set(current.fields.map((field) => field.key));
+  const kept = {};
+  for (const [key, value] of Object.entries(current.values)) {
+    if (!specKeys.has(key)) kept[key] = value;
+  }
+  const resolved = resolveSettings(current.fields, { ...kept, ...values });
   const file = path.join(dir, 'settings.json');
   const temporary = path.join(dir, `.settings-${process.pid}-${randomUUID()}.json`);
   fs.writeFileSync(temporary, `${JSON.stringify(resolved, null, 2)}\n`, { mode: 0o600 });

package/src/plugins/contracts.d.ts

@@ -27,10 +27,30 @@ export interface Job {
   [key: string]: unknown;
 }
 export interface Project { id: string; label: string; path: string }
+/** Streaming JSONL event parser shared by CLI coding agents. */
+export interface CliEventStream {
+  write(chunk: string): void;
+  finish(): { result: string; hasAssistantText: boolean; error: string; rawTail: string };
+}
+/** Per-CLI adapter handed to runCli: command line plus event interpretation. */
+export interface CliAdapter {
+  label: string;
+  createEvents: (onProgress?: (text: string) => void, onSession?: (sessionId: string) => void) => CliEventStream;
+  command: (options: { cwd: string; instruction: string; config: PluginConfig; model?: string; sessionId?: string }) => {
+    command: string; args: string[]; stdin?: string;
+  };
+  classifyExit?: (context: {
+    job: Job; project: Project; stderr: string;
+    output: { result: string; hasAssistantText: boolean; error: string; rawTail: string };
+    startingGitSnapshot: string;
+  }) => Error | void;
+}
 /**
  * Cross-platform helpers the bridge hands to every plugin. Use these instead of
  * hand-rolling PATH lookups or spawning npm: on Windows npm is npm.cmd, which
  * Node 20+ refuses to spawn without a shell, and PATH lookups must walk PATHEXT.
+ * Also includes the CLI toolbox (probeCli/runCli/event parsing) used by CLI
+ * coding-agent plugins; guardrails and the stuck watchdog live in runCli.
  */
 export interface PluginRuntime {
   /** process.platform of the bridge, e.g. 'darwin' | 'linux' | 'win32'. */
@@ -46,6 +66,26 @@ export interface PluginRuntime {
   };
   /** Sync npm run; returns stdout. Throws ENOENT when npm is missing. */
   runNpm: (args?: string[], options?: Record<string, unknown>) => string;
+  /** Sync CLI login probe; loginArgs like ['login', 'status']. */
+  probeCli: (command: string, loginArgs?: string[]) => { available: boolean; mode: string; reason: string };
+  /** Spawn a CLI adapter with guardrails, watchdog, and change-footer handling. */
+  runCli: (context: RunContext, adapter: CliAdapter) => Promise<RunResult>;
+  /** Git working-tree fingerprint for a project directory. */
+  gitState: (cwd: string) => { dirty: boolean; snapshot: string; changed: string };
+  /** JSONL event stream parser; interpret returns {sessionId?, activity?}. */
+  jsonLineEvents: (
+    interpret: (event: Record<string, unknown>, state: Record<string, unknown>) => { sessionId?: string; activity?: string } | void,
+    onProgress?: (text: string) => void,
+    onSession?: (sessionId: string) => void,
+  ) => CliEventStream;
+  /** Update state from assistant/result events (Claude-style stream-json). */
+  assistantEvent: (event: Record<string, unknown>, state: Record<string, unknown>, options?: { append?: boolean }) => void;
+  /** Categorical activity text for Claude/Qoder-style stream events. */
+  streamActivity: (event: Record<string, unknown>) => string;
+  /** Categorical progress text for a tool name. */
+  toolActivity: (name: string, completed?: boolean) => string;
+  /** Concatenated text of string-or-blocks content. */
+  textBlocks: (content: unknown) => string;
 }
 export interface PluginConfig {
   locale?: 'zh-CN' | 'en';
@@ -81,6 +121,8 @@ export interface CodingAgentPlugin {
   capabilities: Capabilities;
   model?: { default: string; required: boolean };
   sessionIdPattern?: RegExp;
+  /** Declare that progress/error/reason strings are bridge-canonical messages; clients localize them at output boundaries. */
+  bridgeStrings?: boolean;
   probe: (config: PluginConfig) => { available: boolean; reason?: string; mode?: string };
   run: (context: RunContext) => Promise<RunResult>;
   readUpdates?: (context: { job: Job; config: PluginConfig }) => Promise<{
@@ -117,6 +159,8 @@ export interface BridgeFacade {
   cancelJob(id: string): Record<string, unknown>;
   themes(): { name: string; title: string; sound: boolean; icon: boolean; background: boolean }[];
   devices(): string[];
+  /** Action system: action names derived from the device command catalog (`action.<name>` entries, decided by the current assistant sprite). Advisory only — the board silently ignores unknown action commands. */
+  deviceActions(deviceId: string): string[];
   /** Enqueue a board command directly; only the board-side catalog constrains the name. */
   send(deviceId: string, command: BoardCommand, audio?: Uint8Array): QueuedBoardCommand;
   pending(deviceId: string): QueuedBoardCommand[];

package/src/plugins/enhance.mjs

@@ -4,7 +4,7 @@
  * 管控插件是"有自主行为能力的增强体"：触发（事件、回合钩子、任务通知）只决定它
  * 何时被唤醒；被唤醒后能做什么，取决于这里露出了多少句柄。接口有两条供给线：
  * - 板侧线：事件与命令，清单由固件上报，桥接器只做清单校验；要新命令（如关机）得改固件。
- * - 桥接器线：本模块露出的句柄（助手、任务、主题、板侧发送），重启桥接器即生效。
+ * - 桥接器线：本模块露出的句柄（助手、任务、主题、板侧发送）。保存插件或安装/停用后热加载即生效。
  *
  * 回合管道是顺序链：每个插件拿到上一环的产物，返回新字符串即 override，最后一个
  * 说话的算数。单个插件超时或出错时沿用上一环的值，绝不阻断任务本身。
@@ -104,6 +104,10 @@ export function createEnhancement(config) {
       cancelJob: (id) => ({ ...wired.jobs.cancel(id) }),
       themes: () => (wired.themes ? wired.themes() : []),
       devices: () => (wired.board ? wired.board.deviceIds() : []),
+      // 行动系统：可用动作从设备命令清单派生（action.<名> 条目，当前助手
+      // 素材决定）；下发直接 send(deviceId, { name: 'action.yawn' })。
+      // 设备对不认识的动作会静默忽略，名单只是参考，不是下发闸门。
+      deviceActions: (deviceId) => (wired.board ? wired.board.actionsOf(deviceId) : []),
       send: (deviceId, command, audio) => {
         if (!wired.board) throw new Error('桥接器尚未就绪');
         return wired.board.send(deviceId, command, audio);

package/src/plugins/hot-reload.mjs

@@ -0,0 +1,189 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { registerHooks } from 'node:module';
+import { packageRoots } from '../config.mjs';
+import { loadConfiguredPlugins } from './registry.mjs';
+
+// 钩子和热加载在同一线程，闭包里的代数对 resolve 可见。
+// 只改写插件目录内的相对导入，给它们带上同一代数，子模块才不会停在旧缓存里。
+let generation = 0;
+let roots = [];
+let generationClock = 0;
+
+function localPath(urlString) {
+  try {
+    const url = new URL(urlString);
+    if (url.protocol !== 'file:') return '';
+    url.search = '';
+    url.hash = '';
+    return fileURLToPath(url);
+  } catch {
+    return '';
+  }
+}
+
+function underRoot(filePath) {
+  if (!filePath) return false;
+  return roots.some((root) => filePath.startsWith(root));
+}
+
+registerHooks({
+  resolve(specifier, context, nextResolve) {
+    if (!generation || !context.parentURL) return nextResolve(specifier, context);
+    const parentPath = localPath(context.parentURL);
+    if (!underRoot(parentPath)) return nextResolve(specifier, context);
+    const resolved = nextResolve(specifier, context);
+    const target = localPath(resolved.url);
+    if (!target || target.includes(`${path.sep}node_modules${path.sep}`)) return resolved;
+    if (!underRoot(target)) return resolved;
+    const url = new URL(resolved.url);
+    url.searchParams.set('hot', String(generation));
+    return { ...resolved, url: url.href };
+  },
+});
+
+function addDir(set, dir) {
+  try {
+    if (!dir || !fs.existsSync(dir) || !fs.statSync(dir).isDirectory()) return;
+    set.add(fs.realpathSync(dir) + path.sep);
+  } catch { /* 目录不可读就跳过，不影响已经加载的插件。 */ }
+}
+
+/** 监视范围：内置与用户 plugins/，以及配置里点名的本地模块所在目录。 */
+export function pluginWatchRoots(config) {
+  const found = new Set();
+  for (const root of packageRoots(config)) addDir(found, path.join(root, 'plugins'));
+  for (const entry of config.plugins || []) {
+    if (typeof entry !== 'string' || !entry || /^[a-z]+:/i.test(entry)) continue;
+    const filename = path.resolve(config.configDirectory || process.cwd(), entry);
+    if (!fs.existsSync(filename)) continue;
+    addDir(found, path.dirname(filename));
+  }
+  return [...found];
+}
+
+function publish(config) {
+  generation = Number(config.pluginReloadGeneration) || 0;
+  roots = pluginWatchRoots(config);
+}
+
+/**
+ * 重新 import 已安装插件并换上注册表。失败时配置和注册表保持热加载前的那一份。
+ * 正在执行的 run() 仍是旧函数；下一轮、下一次目录刷新才用新代码。
+ */
+export async function reloadConfiguredPlugins(config) {
+  const snapshot = {
+    pluginsRuntime: config.pluginsRuntime,
+    pluginPackages: config.pluginPackages,
+    pluginSettings: config.pluginSettings,
+  };
+  config.pluginReloadGeneration = ++generationClock;
+  publish(config);
+  try {
+    config.pluginsRuntime = await loadConfiguredPlugins(config);
+    return config.pluginsRuntime;
+  } catch (error) {
+    config.pluginsRuntime = snapshot.pluginsRuntime;
+    config.pluginPackages = snapshot.pluginPackages;
+    config.pluginSettings = snapshot.pluginSettings;
+    throw error;
+  }
+}
+
+const RELOAD_DELAY_MS = 300;
+
+function relevantChange(filename) {
+  if (!filename) return true;
+  const normalized = filename.split(path.sep).join('/');
+  if (normalized === 'node_modules' || normalized.startsWith('node_modules/') || normalized.includes('/node_modules/')) return false;
+  return /\.(mjs|js|cjs|json|png)$/i.test(normalized);
+}
+
+/**
+ * 监视插件文件。保存后约 300ms 热加载。
+ * onReload 收到 null 表示成功，否则是保留了上一份的错误。
+ */
+export function watchPlugins(config, { onReload } = {}) {
+  const watchers = [];
+  const watched = [];
+  let timer = null;
+  let closed = false;
+  let reloading = false;
+  let pending = false;
+
+  const arm = (target, recursive) => {
+    let real;
+    try { real = fs.realpathSync(target); } catch { return; }
+    if (watched.some((item) => item.path === real && item.recursive === recursive)) return;
+    watched.push({ path: real, recursive });
+    try {
+      watchers.push(fs.watch(target, { recursive }, (_event, filename) => {
+        if (!relevantChange(filename)) return;
+        schedule();
+      }));
+    } catch (error) {
+      console.error(`[plugins] 无法监视 ${target}：${error.message}`);
+    }
+  };
+
+  const covered = (dir) => {
+    let real;
+    try { real = fs.realpathSync(dir); } catch { return false; }
+    return watched.some((item) => item.recursive && (real === item.path || real.startsWith(item.path + path.sep)));
+  };
+
+  async function run() {
+    if (closed) return;
+    if (reloading) { pending = true; return; }
+    reloading = true;
+    try {
+      await reloadConfiguredPlugins(config);
+      const ids = config.pluginsRuntime?.agents?.().map((plugin) => plugin.id) ?? [];
+      console.error(`[plugins] 已热加载${ids.length ? `：${ids.join(', ')}` : ''}`);
+      onReload?.(null);
+    } catch (error) {
+      console.error(`[plugins] 热加载失败，继续使用上一份：${error.message}`);
+      onReload?.(error);
+    } finally {
+      reloading = false;
+      if (pending && !closed) {
+        pending = false;
+        schedule();
+      }
+    }
+  }
+
+  function schedule() {
+    if (closed) return;
+    if (timer) clearTimeout(timer);
+    timer = setTimeout(() => { timer = null; void run(); }, RELOAD_DELAY_MS);
+  }
+
+  for (const root of packageRoots(config)) {
+    const dir = path.join(root, 'plugins');
+    if (fs.existsSync(dir)) arm(dir, true);
+  }
+  for (const entry of config.plugins || []) {
+    if (typeof entry !== 'string' || !entry || /^[a-z]+:/i.test(entry)) continue;
+    const filename = path.resolve(config.configDirectory || process.cwd(), entry);
+    if (!fs.existsSync(filename)) continue;
+    const dir = path.dirname(filename);
+    if (covered(dir)) continue;
+    arm(filename, false);
+    arm(dir, false);
+  }
+  if (watchers.length) console.error('[plugins] 正在监视插件变更');
+
+  return {
+    close() {
+      closed = true;
+      if (timer) clearTimeout(timer);
+      timer = null;
+      for (const watcher of watchers) {
+        try { watcher.close(); } catch { /* 已经关掉。 */ }
+      }
+      watchers.length = 0;
+    },
+  };
+}

package/src/plugins/registry.mjs

@@ -4,7 +4,6 @@ import fs from 'node:fs';
 import { packageRoots } from '../config.mjs';
 import { isPackageEntry, packageDirectories, readPackageSettings } from '../plugin-package.mjs';
 import { MODEL_ID } from '../model-settings.mjs';
-import { builtinAgents } from '../agents/index.mjs';
 import { normalizeAgentIcon } from '../agent-icons.mjs';
 import { readSprite } from '../agent-sprites.mjs';
 import { builtinSpeechRecognizers } from '../speech/index.mjs';
@@ -67,7 +66,7 @@ export function validatePlugin(plugin) {
   return plugin;
 }
 
-export function createPluginRegistry(plugins = [...builtinAgents, ...builtinSpeechRecognizers]) {
+export function createPluginRegistry(plugins = [...builtinSpeechRecognizers]) {
   const entries = new Map();
   for (const raw of plugins) {
     const plugin = validatePlugin(raw);
@@ -90,10 +89,15 @@ export async function loadConfiguredPlugins(config) {
   for (const recognizer of builtinSpeechRecognizers) {
     if (disabled.has(recognizer.id)) throw new Error(`语音识别 ${recognizer.id} 是内置接口，不能通过 disabledPlugins 禁用；请在语音设置中配置`);
   }
-  const plugins = [...builtinAgents.filter(p => !disabled.has(p.id)), ...builtinSpeechRecognizers];
+  // 内置编程助手已插件化为市场包（codex/cursor/qoder/workbuddy），桥接器
+  // 只保留内置语音识别；助手全部来自已安装的插件包。
+  const plugins = [...builtinSpeechRecognizers];
   const loadFile = async (filename, label) => {
     if (!/\.(mjs|js)$/.test(filename) || !fs.statSync(filename).isFile()) throw new Error(`插件模块无效：${label}`);
-    const exported = (await import(pathToFileURL(filename).href)).default;
+    // 热加载时带上代数，避开 ESM 按 URL 缓存的旧模块。首次启动代数为 0，URL 不变。
+    const generation = Number(config.pluginReloadGeneration) || 0;
+    const href = pathToFileURL(filename).href + (generation ? `?hot=${generation}` : '');
+    const exported = (await import(href)).default;
     const bundle = Array.isArray(exported) ? exported : [exported];
     const pack = isPackageEntry(filename) ? readPackageSettings(path.dirname(filename)) : null;
     const packageDir = isPackageEntry(filename) ? path.dirname(filename) : null;

package/src/providers.mjs

@@ -1,37 +1,48 @@
-import { builtinAgents, builtinAgent } from './agents/index.mjs';
 import { normalizeAgentIcon } from './agent-icons.mjs';
 import { translateKnownMessage } from './i18n.mjs';
 
-export { builtinAgents } from './agents/index.mjs';
-
 export function agentFor(config, id) {
-  return config.pluginsRuntime ? config.pluginsRuntime.agent(id) : builtinAgent(id);
+  return config.pluginsRuntime ? config.pluginsRuntime.agent(id) : undefined;
 }
 
-export function isBuiltinAgent(plugin) {
-  const builtin = builtinAgent(plugin?.id);
-  return Boolean(builtin && plugin.run === builtin.run && plugin.probe === builtin.probe);
-}
+// 探针快照缓存：providerStates 每次都重跑全部插件 probe，而 CLI 探针内部是
+// PATH 全量 statSync 扫描 + 60s TTL 的 spawnSync 登录检查。/api/state 是秒级
+// 轮询端点，不缓存会把它放大成每秒上百次 stat、每分钟数次事件循环最长 3s 的
+// 同步冻结。3s TTL 意味着设置变更最迟 3s 可见；调用方只读不写返回值。
+// 按插件运行时实例隔离（WeakMap）：不同注册表（测试/重载）互不串味。
+const PROVIDER_STATES_TTL_MS = 3000;
+const providerStatesCaches = new WeakMap();
 
 export function providerStates(config, locale = config.locale) {
-  const agents = config.pluginsRuntime ? config.pluginsRuntime.agents() : builtinAgents;
-  return agents.map((plugin) => {
+  const runtime = config.pluginsRuntime;
+  if (!runtime) return [];
+  let byLocale = providerStatesCaches.get(runtime);
+  if (!byLocale) {
+    byLocale = new Map();
+    providerStatesCaches.set(runtime, byLocale);
+  }
+  const cached = byLocale.get(locale);
+  if (cached && cached.until > Date.now()) return cached.states;
+  const agents = runtime.agents();
+  const states = agents.map((plugin) => {
     let state;
-    let bridgeReason = isBuiltinAgent(plugin);
     try {
       state = plugin.probe(config);
       if (state?.then) {
         // A mistaken async probe cannot hold up /api/state or produce an
         // unhandled rejection. The plugin contract requires a sync result.
         Promise.resolve(state).catch(() => {});
-        bridgeReason = true;
         state = { available: false, reason: '插件状态检查必须同步返回' };
       }
-    } catch { bridgeReason = true; state = { available: false, reason: `${plugin.label} 状态检查失败` }; }
+    } catch { state = { available: false, reason: `${plugin.label} 状态检查失败` }; }
     return {
       id: plugin.id, label: plugin.label, icon: normalizeAgentIcon(plugin.icon),
       available: state?.available === true,
-      reason: typeof state?.reason === 'string' ? (bridgeReason ? translateKnownMessage(state.reason, locale) : state.reason).slice(0, 512) : '',
+      // 桥接器规范文案（bridgeStrings 插件）在输出边界翻译；第三方插件自有
+      // 提示原样返回，即使碰巧撞上桥接器文案也不改写。
+      reason: typeof state?.reason === 'string'
+        ? (plugin.bridgeStrings === true ? translateKnownMessage(state.reason, locale) : state.reason).slice(0, 512)
+        : '',
       mode: typeof state?.mode === 'string' ? state.mode.slice(0, 64) : 'plugin',
       capabilities: {
         session: plugin.capabilities.session, model: plugin.capabilities.model,
@@ -44,14 +55,8 @@ export function providerStates(config, locale = config.locale) {
       canCancelRunning: plugin.capabilities.cancel,
     };
   });
-}
-
-// Compatibility for existing stream tests and embedders. Actual parsing belongs
-// to each plugin and adding an agent never adds another branch here.
-export function createCliEventStream(provider, onProgress, onSession) {
-  const plugin = builtinAgent(provider);
-  if (!plugin?.createEvents) throw new Error(`编程工具不支持 CLI 事件：${provider}`);
-  return plugin.createEvents(onProgress, onSession);
+  providerStatesCaches.get(runtime).set(locale, { states, until: Date.now() + PROVIDER_STATES_TTL_MS });
+  return states;
 }
 
 export function createRunner(config) {