@ai-agent-forge/agent-forge 0.87.0 → 0.88.1

package/dist/core/sdk.js

@@ -1,6 +1,7 @@
 import { existsSync, realpathSync } from "node:fs";
 import { readFile } from "node:fs/promises";
-import { join, resolve } from "node:path";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 import { Agent, setDefaultStreamFn, } from "@agent-forge/agent-core";
 import { clampThinkingLevel, streamSimple, } from "@agent-forge/ai/compat";
 import { createSubagentMailbox } from "@agent-forge/protocol/subagent";
@@ -19,7 +20,7 @@ import { formatNoModelsAvailableMessage } from "./auth-guidance.js";
 import { DEFAULT_THINKING_LEVEL } from "./defaults.js";
 import { discoverCapabilityPluginManifests, parseCapabilityPluginManifest } from "./extensions/capability-plugin.js";
 import { resolvePluginCapabilityOrder } from "./extensions/capability-runtime.js";
-import { installProviderFailoverPlugin, readProviderFailoverSettingsNode } from "./extensions/provider-failover.js";
+import { isPluginConfigValue } from "./extensions/capability-runtime-manifest.js";
 import { createCodingAgentFacade } from "./facade/coding-agent-facade.js";
 import { createCodingAgentRuntimeFacade, } from "./facade/coding-agent-runtime-facade.js";
 import { t } from "./i18n/index.js";
@@ -30,7 +31,6 @@ import { DefaultResourceLoader } from "./resource-loader.js";
 import { getDefaultSessionDir, getTraceFilePathForSession, SessionManager } from "./session-manager.js";
 import { SettingsManager } from "./settings-manager.js";
 import { time } from "./timings.js";
-import { createBashTool, createCodingTools, createEditTool, createFindTool, createGrepTool, createLsTool, createPowerShellTool, createReadOnlyTools, createReadTool, createWriteTool, withFileMutationQueue, } from "./tools/index.js";
 // Preserve the pre-0.81 fallback for extensions that construct Agent instances
 // or invoke low-level agent loops without supplying streamFn. Agent core remains
 // provider-agnostic and does not import pi-ai/compat itself.
@@ -133,6 +133,126 @@ const MEMORY_PACKAGE_ID = "agent-forge.plugin.memory";
  * users keep the final say.
  */
 const IMAGE_GENERATION_PACKAGE_ID = "agent-forge.plugin.image-generation";
+/**
+ * Plugin id of the standalone coding-tools package (D-082 批 1, S6 工具批):
+ * the default coding tools (read/write/edit/bash/powershell/grep/find/ls) live
+ * in the `plugins/coding-tools` package and assemble through the bundled
+ * distribution channel (§4.9) instead of the retired embedded
+ * bootstrap-tools install. At load the assembler merges the
+ * session facts the embedded install used to receive as direct options — the
+ * working directory plus the settings-resolved read/bash options — into the
+ * manifest config (`{version: 1, cwd, read, bash}`), the exact shape the
+ * package's `CodingToolsPluginConfigV1` consumes. The agent-dir config file
+ * still merges over it inside the plugin entry, so users keep the final say.
+ */
+const CODING_TOOLS_PACKAGE_ID = "agent-forge.plugin.coding-tools";
+/**
+ * Plugin id of the provider-failover package (D-082 批 3b): the primary/backup
+ * provider failover (设计 供应商能力槽位与主备切换 §4) lives in the
+ * `plugins/provider-failover` package and assembles through the bundled
+ * distribution channel (§4.9) instead of the retired embedded install. Unlike
+ * the bundled default face it is NOT a default policy: settings `failover`
+ * 节存在时宿主经 configOverride 通道注入 `{version: 1, failover: <节点原样>}`
+ * （节点不存在则不注入，插件工厂自守卫 no-op）——"配置存在即装配"是内嵌时代
+ * 语义，因此它不受 suite capabilities 声明门控（见装配豁免集合）。failover
+ * wrapper 以 priority -100 注册（契约 A），无论装载顺序都在链最外层。
+ */
+const PROVIDER_FAILOVER_PACKAGE_ID = "agent-forge.plugin.provider-failover";
+/**
+ * Bundled 默认面插件 id 集合（D-082 批 3）：随发行物 bundled 分发、不受 suite
+ * capabilities 声明门控的第一方默认插件——内嵌时代的默认工具面（coding-tools，
+ * 批 1）与四个默认策略插件（agent-loop-policy / retry-policy / overflow-policy /
+ * compaction-policy，批 3 退役的内嵌 installBootstrap* 安装）。disabledPluginIds
+ * 仍可逐个禁用其中任何一个。
+ */
+const BUNDLED_DEFAULT_PLUGIN_IDS = new Set([
+    CODING_TOOLS_PACKAGE_ID,
+    "agent-forge.plugin.agent-loop-policy",
+    "agent-forge.plugin.retry-policy",
+    "agent-forge.plugin.overflow-policy",
+    "agent-forge.plugin.compaction-policy",
+]);
+/**
+ * Bundled 装配豁免集合（D-082 批 3b）：bundled 候选中不受 suite capabilities
+ * 声明门控的插件 id——默认面（{@link BUNDLED_DEFAULT_PLUGIN_IDS}，五 id）加上
+ * config 门控可选能力 provider-failover（第六 id，config 门控豁免而非默认策略：
+ * settings `failover` 节存在即装配，与内嵌装配同语义；节点不存在时插件工厂
+ * 自守卫 no-op）。disabledPluginIds 仍可禁用其中任何一个。
+ */
+const BUNDLED_WIRING_EXEMPT_PLUGIN_IDS = new Set([
+    ...BUNDLED_DEFAULT_PLUGIN_IDS,
+    PROVIDER_FAILOVER_PACKAGE_ID,
+]);
+/**
+ * Bundled 默认策略包的目录名（plugins/ 工作副本与发行物 bundled-plugins/ 快照
+ * 同名）。与 {@link BUNDLED_DEFAULT_PLUGIN_IDS} 的四个策略 id 一一对应。
+ */
+const BUNDLED_DEFAULT_POLICY_PACKAGES = [
+    "agent-loop-policy",
+    "retry-policy",
+    "overflow-policy",
+    "compaction-policy",
+];
+/**
+ * Bundled distribution roots (D-082 §4.9 bundled 分发通道)：按工具面与策略面
+ * 分组的插件目录，其 plugin.json 清单加入候选池。两组各自探测两种布局，目录
+ * 不存在即跳过：
+ *
+ * - Released form: the build copies built plugin packages to
+ *   `<packageRoot>/bundled-plugins/<name>/` (data files, not npm deps).
+ * - Dev repository form: the repo-root working copies of the packages this
+ *   batch migrated (`<repoRoot>/plugins/coding-tools` — 批 1；四个策略包 — 批 3；
+ *   provider-failover — 批 3b).
+ *   Sibling first-party packages keep their install-store assembly (D-075
+ *   S4/S5 semantics, pinned by the ecosystem assembly tests) until their own
+ *   migration batch (S7-S9) widens this root.
+ *
+ * 工具面（coding-tools）受 noTools 整层跳过（对照内嵌工具装配的跳过语义）；
+ * 策略面不受 noTools 门控——内嵌 installBootstrap* 时代它们随会话无条件安装。
+ *
+ * The package root is derived from this module's URL: src runs sit at
+ * `src/core/`, unbundled dist runs at `dist/core/` (both two levels up), and
+ * the Node bundle runs at `dist/bundle/` (three levels up). Depth candidates
+ * are tried in order and the first ancestor carrying a `package.json` wins.
+ */
+function bundledCapabilityPluginRoots() {
+    const moduleDir = fileURLToPath(new URL(".", import.meta.url));
+    let packageRoot;
+    for (const depth of [2, 3]) {
+        let candidate = moduleDir;
+        for (let index = 0; index < depth; index++)
+            candidate = dirname(candidate);
+        if (existsSync(join(candidate, "package.json"))) {
+            packageRoot = candidate;
+            break;
+        }
+    }
+    if (packageRoot === undefined)
+        return { toolRoots: [], policyRoots: [] };
+    const toolRoots = [];
+    const policyRoots = [];
+    // Dev repository layout first: the repo-root plugins/ working copies (two
+    // levels above the package root; exist only inside a source checkout).
+    // When both roots exist the fresh working copy must win — the bundled copy
+    // is a build-time snapshot that lags plugin src until the next root build,
+    // and letting it shadow the working copy would silently run stale tool
+    // code in dev (review finding, D-082 批 1). check:plugin-dist-fresh pins
+    // the two copies content-identical so a stale bundled snapshot fails the
+    // gate instead of passing unnoticed.
+    const devPluginsRoot = join(packageRoot, "..", "..", "plugins");
+    toolRoots.push(join(devPluginsRoot, "coding-tools"));
+    for (const name of BUNDLED_DEFAULT_POLICY_PACKAGES)
+        policyRoots.push(join(devPluginsRoot, name));
+    // provider-failover（D-082 批 3b）：config 门控可选能力，随策略面根分发
+    // （不受 noTools 门控，与内嵌装配同语义）。
+    policyRoots.push(join(devPluginsRoot, "provider-failover"));
+    const bundledRoot = join(packageRoot, "bundled-plugins");
+    toolRoots.push(join(bundledRoot, "coding-tools"));
+    for (const name of BUNDLED_DEFAULT_POLICY_PACKAGES)
+        policyRoots.push(join(bundledRoot, name));
+    policyRoots.push(join(bundledRoot, "provider-failover"));
+    return { toolRoots, policyRoots };
+}
 const isMemoryModeV1 = (value) => value === "off" || value === "light" || value === "full";
 function resolveSdkMemoryMode(explicitMode, env, settingsMode) {
     if (explicitMode !== undefined) {
@@ -175,9 +295,7 @@ export const HEADLESS_INTERACTION_HOST = {
 };
 // Re-exports
 export * from "./agent-session-runtime.js";
-export { withFileMutationQueue, 
-// Tool factories (for custom cwd)
-createCodingTools, createReadOnlyTools, createReadTool, createBashTool, createEditTool, createWriteTool, createGrepTool, createFindTool, createLsTool, createPowerShellTool, };
+export { withFileMutationQueue } from "./tools/index.js";
 // Helper Functions
 function getDefaultAgentDir() {
     return getAgentDir();
@@ -626,11 +744,13 @@ export async function createAgentSession(options = {}) {
                     }
                 };
                 // streamFn wrapper 链（provider-failover 家族注册面，设计 供应商能力槽位
-                // 与主备切换 §4.8）：注册的 wrapper 按注册序包在默认闭包外层（先注册者最
-                // 外层），wrapper 拿到的 next 即链上下一个直至底层默认调用。每次请求时从
-                // 会话 capability runtime 读取，使嵌入式 failover 插件（会话构造后装配）与
-                // 后续加载的第三方 wrapper 都进入链中。调用方显式传 options.streamFn 的会话
-                // 整体绕过本装配（含 wrapper），不参与 failover——已知边界。
+                // 与主备切换 §4.8）：getStreamFnWrappers 已按 (priority 升序, 注册序升序)
+                // 稳定排序（D-082 批 3b 契约 A，低值更外层）；从数组末尾向前包裹，首位
+                // wrapper 即最外层，其 next 覆盖其余 wrapper 直至底层默认调用。每次请求
+                // 时从会话 capability runtime 读取，使 bundled failover 插件（随 manifest
+                // 链装载）与第三方 wrapper 都进入链中——failover 以 priority -100 注册，
+                // 无论装载顺序都在最外层。调用方显式传 options.streamFn 的会话整体绕过
+                // 本装配（含 wrapper），不参与 failover——已知边界。
                 const wrappers = agentSessionRef.current?.getCapabilityRuntime().getStreamFnWrappers() ?? [];
                 let chain = baseStreamFn;
                 for (let index = wrappers.length - 1; index >= 0; index -= 1) {
@@ -696,6 +816,10 @@ export async function createAgentSession(options = {}) {
         initialActiveToolNames,
         allowedToolNames,
         excludedToolNames,
+        // 延迟工具（MCP `deferredTools: true`）：services 装配域解析出的插件 id 集
+        // 合在此过线；AgentSession 据此注册 tool_search 并把对应插件的新工具排除出
+        // 默认激活集（agent-session-tools 的默认激活分支）。
+        ...(options.deferredToolPluginIds === undefined ? {} : { deferredToolPluginIds: options.deferredToolPluginIds }),
         sessionStartEvent: options.sessionStartEvent,
         capabilityMode: options.capabilityMode,
         contextStrategyName: options.contextStrategyName,
@@ -839,28 +963,13 @@ export async function createAgentSession(options = {}) {
         ...(capabilitySkillsFilter === undefined ? {} : { capabilitySkillsFilter }),
     });
     agentSessionRef.current = session;
-    // provider-failover 装配（设计 供应商能力槽位与主备切换 §4.8）：嵌入式第一方
-    // 插件经公共 registerStreamFnWrapper 注册面挂进上方默认 streamFn 装配（此处早于
-    // 下方外部插件装载，故 failover wrapper 位于链最外层，观察到的是其余 wrapper 与
-    // 默认闭包之后的最终流）。熔断状态是模块级单例，随进程生命周期跨会话共享（§4.2）。
-    // 配置从 settings `failover` 节原始读出（未配置 / enabled:false / 配置错误则不装配）；
-    // 装配失败只警告——可靠性能力不得阻断会话构造。装载预检（§4.6）随装配同步执行：
-    // 检查面全部为 modelRuntime 静态读取（目录解析/provider 存在/凭据条目快照），
-    // 零网络请求、不触发 OAuth 刷新。
-    try {
-        installProviderFailoverPlugin(session.getCapabilityRuntime(), {
-            failoverSettings: readProviderFailoverSettingsNode(settingsManager),
-            preflight: {
-                resolveModel: (provider, modelId) => modelRuntime.getModel(provider, modelId),
-                hasProvider: (providerId) => modelRuntime.getProvider(providerId) !== undefined,
-                hasConfiguredAuth: (providerId) => modelRuntime.hasConfiguredAuth(providerId),
-            },
-            hostLogger,
-        });
-    }
-    catch (error) {
-        hostLogger?.warn("sdk", "provider failover plugin load failed", { cause: error });
-    }
+    // provider-failover 装配（设计 供应商能力槽位与主备切换 §4.8，D-082 批 3b）：
+    // 内嵌 installProviderFailoverPlugin 退役为 bundled 插件包
+    // （plugins/provider-failover，id agent-forge.plugin.provider-failover），经
+    // 下方 bundled 分发通道装载。配置注入见装载循环的 configOverride 分支
+    // （settings `failover` 节存在时注入 `{version: 1, failover: <节点原样>}`，
+    // 预检读面经 api.host.modelCatalog 契约 B 注入）；wrapper 以 priority -100
+    // 注册（契约 A），无论装载顺序都在链最外层——装配时序不再依赖 manifest 链。
     // Session-suite binding (设计 §10.1): record the suite as session protocol
     // data via the existing custom-entry extension point. New sessions only;
     // resumed sessions keep their original binding.
@@ -975,15 +1084,31 @@ export async function createAgentSession(options = {}) {
         if (skippedInstalledPluginIds.length > 0) {
             capabilityDiagnostics.push(`Installed capability plugins stay unloaded because the active profile did not select them: ${skippedInstalledPluginIds.sort().join(", ")}`);
         }
+        // Bundled 分发通道（D-082 §4.9，批 1 工具批 / 批 3 策略批）：发行物附带的第一方
+        // 插件包作为数据文件随宿主分发，经与安装店完全相同的 manifest/jiti 通道装载；
+        // 优先级在 installed 之后、目录发现之前（安装店显式安装 > bundled >
+        // 目录发现）。这不是用户插件发现通道：内嵌默认面不受
+        // discoverCapabilityPlugins 与 suite capabilities 声明门控——工具面
+        // （coding-tools）沿用内嵌装配的无条件下发语义；策略面（四个默认策略插件，
+        // 内嵌 installBootstrap* 时代随会话无条件安装）同样无条件下发且不受
+        // noTools 门控；其余 bundled 候选按套件成员资格过滤。noTools（"all"/
+        // "builtin"，对照内嵌工具装配的跳过语义）只跳过工具面。
+        const bundledRoots = bundledCapabilityPluginRoots();
+        const bundledToolManifestPaths = options.noTools === undefined ? discoverCapabilityPluginManifests(bundledRoots.toolRoots) : [];
+        const bundledPolicyManifestPaths = discoverCapabilityPluginManifests(bundledRoots.policyRoots);
+        const bundledManifestPaths = [...bundledToolManifestPaths, ...bundledPolicyManifestPaths];
+        const bundledManifestPathSet = new Set(bundledManifestPaths);
         const manifestPaths = [
             ...suiteLocalManifestPaths,
             ...installedPluginManifestPaths,
+            ...bundledManifestPaths,
             ...discoveredManifestPaths,
             ...(options.capabilityPluginPaths ?? []),
         ];
         const explicitCandidatePaths = new Set([
             ...suiteLocalManifestPaths,
             ...installedPluginManifestPaths,
+            ...bundledManifestPaths,
             ...(options.capabilityPluginPaths ?? []),
         ]);
         const loadedManifestPaths = new Set();
@@ -1045,6 +1170,23 @@ export async function createAgentSession(options = {}) {
         const discoveredPluginIds = [];
         for (const entry of manifestEntries) {
             discoveredPluginIds.push(entry.manifest.id);
+            const bundledCandidate = bundledManifestPathSet.has(entry.path);
+            // Bundled 层过滤：bundled 装配豁免集合（coding-tools 工具面 + 四个默认
+            // 策略插件 + config 门控的 provider-failover，BUNDLED_WIRING_EXEMPT_
+            // PLUGIN_IDS）不受 suite capabilities 声明门控，与内嵌装配同语义——
+            // failover 的"配置存在即装配"不是套件声明可关闭的面（disabledPluginIds
+            // 仍可显式禁用）；其余 bundled 候选与 installed 层同法——
+            // capabilityWiring 开启时插件 id 必须命中 capabilityPackageIds（套件
+            // 未选中的包静默缺席），关闭（自持 loader 的宿主）全收，保底拿到产品
+            // 默认面。disabledPluginIds（既有用户面）作用于全部 bundled 候选。
+            if (bundledCandidate) {
+                if (!BUNDLED_WIRING_EXEMPT_PLUGIN_IDS.has(entry.manifest.id) && capabilityWiring) {
+                    if (!capabilityPackageIds.includes(entry.manifest.id))
+                        continue;
+                }
+                if (disabledPluginIdSet.has(entry.manifest.id))
+                    continue;
+            }
             if (poolFilter && !explicitManifestPaths.has(entry.path)) {
                 const decision = poolFilter.decide(entry.manifest.id, entry.path);
                 if (!decision.keep) {
@@ -1054,7 +1196,13 @@ export async function createAgentSession(options = {}) {
                 }
             }
             if (seenPluginIds.has(entry.manifest.id)) {
-                await recordRejection("duplicate_plugin_id", entry.path, entry.manifest.id, `Capability plugin is already loaded: ${entry.manifest.id}; the first manifest in discovery order wins`);
+                // Bundled 候选与更高优先层（suiteLocal/installed/前一根 bundled）同 id
+                // 时按发现优先级静默让位（安装店显式安装 > bundled；产品自带副本被
+                // 遮蔽是设计内的优先级，不是冲突）。目录发现层的重复 id 保持既有
+                // duplicate_plugin_id rejection（第三方同 id 冲突需要显形）。
+                if (!bundledCandidate) {
+                    await recordRejection("duplicate_plugin_id", entry.path, entry.manifest.id, `Capability plugin is already loaded: ${entry.manifest.id}; the first manifest in discovery order wins`);
+                }
                 continue;
             }
             seenPluginIds.add(entry.manifest.id);
@@ -1101,50 +1249,93 @@ export async function createAgentSession(options = {}) {
             // v8 ignore next -- 顺序解析返回的 manifest 均来自同一 survivors 集合，路径恒存在
             if (!manifestPath)
                 throw new Error(t("Capability plugin manifest path is unavailable: {id}", { id: manifest.id }));
+            // 宿主装配事实注入（公共 configOverride 通道）：各插件分支注释记载注入
+            // 内容与取值链；caller 的 capabilityPluginConfigs[插件 id]（D-082 批 1
+            // 新增会话选项）按 configOverride 既有分层合并在宿主事实之上（顶层键
+            // caller 赢），插件入口的 agent-dir 配置文件仍合并在其上，用户显式配置
+            // 保持最终决定权。
+            let hostConfigOverride;
+            // CLI 自动池化（承载退役切片 1，D-075 S4 第三批收敛）：宿主声明自身
+            // 入口可信时改写插件 config 的 runnerEntryAuto（原 builtin 注入链的
+            // selfInvocationPool 旗标退役）；插件入口的 agent-dir 配置文件仍合并
+            // 在其上，用户显式配置保持最终决定权。
+            if (manifest.id === SUBAGENT_DELEGATE_PACKAGE_ID && options.subagentPoolFromSelfInvocation === true) {
+                hostConfigOverride = { runnerEntryAuto: true };
+            }
+            // 记忆档位注入（D-075 S4 第四批）：显式定档与 settings.json 持久档位经
+            // 公共 configOverride 通道合并进 memory 插件包 manifest config——包 entry
+            // 按同一解析链定档（显式 > env > settings > 旧别名 > off）；agent-dir
+            // 配置文件（capabilities/builtin.memory.json）仍合并在其上，用户显式
+            // 配置保持最终决定权。mode=off 的包已在上面的成员资格门控中排除，
+            // 不会走到这里。
+            if (manifest.id === MEMORY_PACKAGE_ID) {
+                hostConfigOverride = {
+                    ...hostConfigOverride,
+                    ...(memoryModeOption === undefined ? {} : { memoryMode: memoryModeOption }),
+                    ...(settingsMemoryMode === undefined ? {} : { memorySettingsMode: settingsMemoryMode }),
+                };
+            }
+            // 生图槽位注入（供应商能力槽位设计 §3.3）：settings 槽位（provider/model，
+            // model 可省）与 models.json 生图目录快照经公共 configOverride 通道注入
+            // image-generation 插件包；插件按六层取值链消费（设计 §3.2）。槽位缺省时
+            // 只注入快照——插件回落到 env/主推断/唯一候选推断。
+            if (manifest.id === IMAGE_GENERATION_PACKAGE_ID) {
+                hostConfigOverride = {
+                    ...hostConfigOverride,
+                    ...(imageGenerationSlot === undefined
+                        ? {}
+                        : {
+                            imageGeneration: {
+                                provider: imageGenerationSlot.provider,
+                                ...(imageGenerationSlot.model === undefined ? {} : { model: imageGenerationSlot.model }),
+                            },
+                        }),
+                    imageModelCatalog,
+                };
+            }
+            // 默认编码工具会话事实注入（D-082 批 1）：cwd 用会话 cwd，read/bash 选项
+            // 取值来源对齐内嵌 installSessionBootstrapTools 时代的 settings 解析链
+            // （SettingsManager.getImageAutoResize/getShellCommandPrefix/getShellPath），
+            // 形状即插件包 CodingToolsPluginConfigV1；未定义的设置键省略（插件侧
+            // 保持自身缺省值，与内嵌时代传 undefined 同语义）。
+            if (manifest.id === CODING_TOOLS_PACKAGE_ID) {
+                const autoResizeImages = settingsManager.getImageAutoResize();
+                const shellCommandPrefix = settingsManager.getShellCommandPrefix();
+                const shellPath = settingsManager.getShellPath();
+                hostConfigOverride = {
+                    ...hostConfigOverride,
+                    version: 1,
+                    cwd,
+                    read: { autoResizeImages },
+                    bash: {
+                        ...(shellCommandPrefix === undefined ? {} : { commandPrefix: shellCommandPrefix }),
+                        ...(shellPath === undefined ? {} : { shellPath }),
+                    },
+                };
+            }
+            // provider-failover 配置注入（D-082 批 3b）：settings `failover` 节存在
+            // 时经 configOverride 通道注入 `{version: 1, failover: <节点原样>}`（节点
+            // 来源与内嵌装配时代同一读面：settingsManager.getFailoverSettings 原样
+            // 透传合并层对象，解析与校验收在插件包内）；节点不存在则不注入——插件
+            // 工厂自守卫 no-op（不注册任何面）。caller 的 capabilityPluginConfigs
+            // 仍按既有分层合并在其上（顶层键 caller 赢），agent-dir 配置文件保持
+            // 用户最终决定权。
+            if (manifest.id === PROVIDER_FAILOVER_PACKAGE_ID) {
+                const failoverSettings = settingsManager.getFailoverSettings();
+                // settings 层合并对象是 JSON 数据，仅静态接口不带索引签名；经公共
+                // 守卫收窄为 PluginConfigValue 后节点原样透传（真实 settings 数据
+                // 恒为 JSON，守卫不构成行为分支），解析与校验收在插件包内。
+                if (failoverSettings !== undefined && isPluginConfigValue(failoverSettings)) {
+                    hostConfigOverride = { version: 1, failover: failoverSettings };
+                }
+            }
+            const callerConfigOverride = options.capabilityPluginConfigs?.[manifest.id];
+            const configOverride = hostConfigOverride === undefined
+                ? callerConfigOverride
+                : { ...hostConfigOverride, ...(callerConfigOverride ?? {}) };
             try {
                 await session.loadCapabilityPluginManifest(manifestPath, {
-                    // CLI 自动池化（承载退役切片 1，D-075 S4 第三批收敛）：宿主声明自身
-                    // 入口可信时改写插件 config 的 runnerEntryAuto（原 builtin 注入链的
-                    // selfInvocationPool 旗标退役）；插件入口的 agent-dir 配置文件仍合并
-                    // 在其上，用户显式配置保持最终决定权。
-                    ...(manifest.id === SUBAGENT_DELEGATE_PACKAGE_ID && options.subagentPoolFromSelfInvocation === true
-                        ? { configOverride: { runnerEntryAuto: true } }
-                        : {}),
-                    // 记忆档位注入（D-075 S4 第四批）：显式定档与 settings.json 持久档位经
-                    // 公共 configOverride 通道合并进 memory 插件包 manifest config——包 entry
-                    // 按同一解析链定档（显式 > env > settings > 旧别名 > off）；agent-dir
-                    // 配置文件（capabilities/builtin.memory.json）仍合并在其上，用户显式
-                    // 配置保持最终决定权。mode=off 的包已在上面的成员资格门控中排除，
-                    // 不会走到这里。
-                    ...(manifest.id === MEMORY_PACKAGE_ID
-                        ? {
-                            configOverride: {
-                                ...(memoryModeOption === undefined ? {} : { memoryMode: memoryModeOption }),
-                                ...(settingsMemoryMode === undefined ? {} : { memorySettingsMode: settingsMemoryMode }),
-                            },
-                        }
-                        : {}),
-                    // 生图槽位注入（供应商能力槽位设计 §3.3）：settings 槽位（provider/model，
-                    // model 可省）与 models.json 生图目录快照经公共 configOverride 通道注入
-                    // image-generation 插件包；插件按六层取值链消费（设计 §3.2）。槽位缺省时
-                    // 只注入快照——插件回落到 env/主推断/唯一候选推断。
-                    ...(manifest.id === IMAGE_GENERATION_PACKAGE_ID
-                        ? {
-                            configOverride: {
-                                ...(imageGenerationSlot === undefined
-                                    ? {}
-                                    : {
-                                        imageGeneration: {
-                                            provider: imageGenerationSlot.provider,
-                                            ...(imageGenerationSlot.model === undefined
-                                                ? {}
-                                                : { model: imageGenerationSlot.model }),
-                                        },
-                                    }),
-                                imageModelCatalog,
-                            },
-                        }
-                        : {}),
+                    ...(configOverride === undefined ? {} : { configOverride }),
                 });
             }
             catch (error) {