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

package/{dist/core/extensions → bundled-plugins/provider-failover/dist}/provider-failover.js

@@ -1,23 +1,49 @@
 /**
- * 第一方 provider 主备切换插件（设计：docs/design/供应商能力槽位与主备切换设计.md §4）。
+ * 第一方 provider 主备切换插件（设计：docs/design/供应商能力槽位与主备切换设计.md §4；
+ * D-082 批 3b 自内核内嵌实现逐字迁出为独立插件包）。
  *
- * 形态与 bootstrap-retry 同族——嵌入式第一方插件，策略经公共
- * `api.registerStreamFnWrapper` 注册面挂进宿主默认 stream 装配——但熔断状态是
- * **宿主模块级单例**（设计 §4.2）：进程内所有会话与 subagent 共享同一份，不随
- * 会话 dispose，不持久化（重启后全部 CLOSED）。
+ * 形态与 bootstrap-retry 同族——经公共 `api.registerStreamFnWrapper` 注册面挂进
+ * 宿主默认 stream 装配，`{ priority: -100 }` 固定链最外层（与装载顺序无关）——但
+ * 熔断状态是**模块级单例**（设计 §4.2）：进程内所有会话与 subagent 共享同一份，
+ * 不随会话 dispose，不持久化（重启后全部 CLOSED）。
  *
  * 判定哲学（设计 §2）：只看流终态 done/error/aborted 与"是否已向上层释放内容
  * 增量"两个本地事实，不解读错误类型/错误码语义；原始 errorMessage 照透传保留，
  * 只用于事件归因与 diagnostics，不参与机器判定分支。aborted 不计数、不换道、
  * 状态不变。换道从第一次失败即发生；`failureThreshold` 只控制"是否继续先撞主"
  * （连续 N 次后熔断打开，请求直接落备用，冷却期满后以真实请求试探回主）。
+ *
+ * 与内嵌装配的公共面差异（迁移登记，行为等价）：
+ * - 配置不再经 SettingsManager 读取：宿主经 manifest config 通道注入
+ *   `{ version: 1, failover: <settings failover 节原样> }`；`api.config` 无
+ *   failover 节 = 未配置，工厂直接 return（不注册任何面）。
+ * - 装载预检检查面改从 `api.host.modelCatalog`（plugin-sdk `ModelCatalogV1`）
+ *   结构获取；配置了 failover 而宿主未注入 modelCatalog 时 fail-loud 抛错
+ *   （与"settings 有 failover 但宿主不支持"同态，不静默降级）。
+ * - 插件面 `LifecycleAPI` 无 hasLifecycleEvent/dispatchLifecycle（与原内嵌第一参
+ *   `CapabilityRuntime` 的同名方法不同构）：目录 gate 以 `api.lifecycle.get` 的
+ *   抛错/命中等价实现（宿主未定义该事件 = 零派发）；派发走公共 `api.publish`
+ *   事件总线（source 由运行时归属插件 manifest id；Envelope 无 phase 字段——
+ *   本插件的可见性事件全部是 committed 相位）。
+ * - 进程日志走 `api.logger`（plugin-sdk `LoggerAPI`）或工厂注入的同形 deps；
+ *   warn 文案逐字保留。
  */
 import { createAssistantMessageEventStream } from "@agent-forge/ai/compat";
-import { loadCapabilityPluginSync } from "./capability-plugin.js";
-import { PROVIDER_FAILOVER_PROBE_FAILED_EVENT_ID, PROVIDER_FAILOVER_PROBE_FAILED_EVENT_VERSION, PROVIDER_FAILOVER_RECOVERED_EVENT_ID, PROVIDER_FAILOVER_RECOVERED_EVENT_VERSION, PROVIDER_FAILOVER_SWITCHED_EVENT_ID, PROVIDER_FAILOVER_SWITCHED_EVENT_VERSION, } from "./lifecycle-catalog.js";
-import { EXPERIMENTAL_PUBLIC_API_VERSION } from "./public-api.js";
-export const PROVIDER_FAILOVER_PLUGIN_ID = "agent-forge.provider-failover";
+/** plugin.json 的 manifest id（原内嵌形态的 `agent-forge.provider-failover` 随内嵌装配退役）。 */
+export const PROVIDER_FAILOVER_PLUGIN_ID = "agent-forge.plugin.provider-failover";
 export const PROVIDER_FAILOVER_WRAPPER_NAME = "provider-failover";
+/**
+ * 可见性事件的 id/version：与宿主 lifecycle-catalog.ts 的 provider.failover.*
+ * 常量逐字同值。插件包不可 import 宿主内部模块（D-075 §0 边界白名单），此处
+ * 本地声明；宿主未在 lifecycle 目录定义同名事件时 `api.lifecycle.get` 抛错，
+ * gate 关闭、零派发（值漂移因此被发现而不是静默错投）。
+ */
+export const PROVIDER_FAILOVER_SWITCHED_EVENT_ID = "provider.failover.switched";
+export const PROVIDER_FAILOVER_SWITCHED_EVENT_VERSION = 1;
+export const PROVIDER_FAILOVER_RECOVERED_EVENT_ID = "provider.failover.recovered";
+export const PROVIDER_FAILOVER_RECOVERED_EVENT_VERSION = 1;
+export const PROVIDER_FAILOVER_PROBE_FAILED_EVENT_ID = "provider.failover.probe.failed";
+export const PROVIDER_FAILOVER_PROBE_FAILED_EVENT_VERSION = 1;
 /**
  * 会话日志快照通道的 customType（设计 §4.7 Phase 3）：插件经公共
  * `api.session.appendEntry` 在状态转移点写入快照，footer 每帧取最后一条渲染
@@ -162,14 +188,6 @@ export function parseProviderFailoverConfig(raw, warn) {
         return undefined;
     return { cooldownInitialMs, cooldownMaxMs, failureThreshold, backupProviders, chains };
 }
-/**
- * 从 SettingsManager 现有读面取合并后的 `failover` 原始节点（设计 §4.1 配置面）：
- * `getFailoverSettings()`（Phase 1 落地）原样透传合并层对象，本层不做结构收窄
- * ——解析与校验全部收在本模块（见 parseProviderFailoverConfig）。
- */
-export function readProviderFailoverSettingsNode(settingsManager) {
-    return settingsManager.getFailoverSettings();
-}
 const providerBreakerRegistry = new Map();
 /** 预检警告去重集（设计 §4.6：每进程至多一次，与会话重复装载解耦）。 */
 const preflightWarnedMessages = new Set();
@@ -266,7 +284,7 @@ function writeStateSnapshot(deps, snapshot) {
         deps.session.appendEntry(PROVIDER_FAILOVER_STATE_ENTRY_TYPE, snapshot);
     }
     catch (error) {
-        deps.hostLogger?.warn("provider-failover", "failover state snapshot append failed", { cause: error });
+        deps.hostLogger?.warn("failover state snapshot append failed", { cause: error });
     }
 }
 /** OPEN 转移点（阈值打开 / 试探失败重开）共用的 open 快照。 */
@@ -282,11 +300,9 @@ function writeOpenStateSnapshot(deps, chainId, breaker, backupReference) {
 }
 function dispatchFailoverEvent(deps, request) {
     try {
-        if (!deps.runtime.hasLifecycleEvent(request.type, request.version))
+        if (!deps.hasLifecycleEvent(request.type, request.version))
             return;
-        void deps.runtime.dispatchLifecycle(request).catch(() => {
-            // 可见性事件失败不打断换道判定（宪法 §8 的尽力通道）。
-        });
+        deps.dispatchLifecycleEvent(request);
     }
     catch {
         // 同上：派发入口同步抛错也不影响请求路径。
@@ -353,6 +369,8 @@ async function driveFailoverStream(deps, outer, model, context, options, next, r
                         version: PROVIDER_FAILOVER_RECOVERED_EVENT_VERSION,
                         phase: "committed",
                         source: PROVIDER_FAILOVER_PLUGIN_ID,
+                        // 事件总线 correlationId 取链引用（workflow.changed 同款领域键模式）。
+                        correlationId: chainId,
                         data: { version: 1, chainId, provider: model.provider },
                     });
                     // HALF_OPEN → CLOSED 转移点：footer 摘要行随最后一条 closed 快照消失。
@@ -392,6 +410,8 @@ async function driveFailoverStream(deps, outer, model, context, options, next, r
                 version: PROVIDER_FAILOVER_SWITCHED_EVENT_VERSION,
                 phase: "committed",
                 source: PROVIDER_FAILOVER_PLUGIN_ID,
+                // 事件总线 correlationId 取链引用（workflow.changed 同款领域键模式）。
+                correlationId: chainId,
                 data: {
                     version: 1,
                     chainId,
@@ -461,6 +481,8 @@ function openAfterFailedProbe(deps, breaker, config, chainId, message, backupRef
         version: PROVIDER_FAILOVER_PROBE_FAILED_EVENT_VERSION,
         phase: "committed",
         source: PROVIDER_FAILOVER_PLUGIN_ID,
+        // 事件总线 correlationId 取链引用（workflow.changed 同款领域键模式）。
+        correlationId: chainId,
         data: {
             version: 1,
             chainId,
@@ -627,7 +649,7 @@ function preflightBackupProviders(providerIds, checks, warn) {
 }
 /**
  * 装载预检主体：返回过滤后的派生配置（预检失败条目已从候选源剔除）。不改变
- * 运行时换道判定——过滤只发生在装载期，运行时候选解析逻辑不变。
+ * 运行时候选解析逻辑——过滤只发生在装载期，运行时候选解析逻辑不变。
  */
 function runProviderFailoverPreflight(config, checks, warn) {
     const backupProviders = preflightBackupProviders(config.backupProviders, checks, warn);
@@ -639,55 +661,120 @@ function runProviderFailoverPreflight(config, checks, warn) {
     }
     return { ...config, backupProviders, chains };
 }
+/** wrapper 注册优先级：低值更外层；-100 保证 failover 恒在链最外层（与装载顺序无关）。 */
+const PROVIDER_FAILOVER_WRAPPER_PRIORITY = -100;
+/** 适配 `api.logger`（plugin-sdk LoggerAPI）为插件的进程日志警告面；未声明 logger-v1 时缺席。 */
+function hostLoggerFromApi(api) {
+    const logger = api.logger;
+    if (logger === undefined)
+        return undefined;
+    return {
+        warn: (message, context) => {
+            const cause = context?.cause;
+            // LoggerAPI.warn 不带 cause 形参：cause 归一为单行文本进 fields。
+            logger.warn(message, cause === undefined ? undefined : { cause: describeCause(cause) });
+        },
+    };
+}
+function describeCause(cause) {
+    if (cause instanceof Error)
+        return cause.message === "" ? cause.name : `${cause.name}: ${cause.message}`;
+    return String(cause);
+}
 /**
- * 装配嵌入式 provider-failover 插件（设计 §4.8）。
+ * 把插件装配进一个已构建的 `CapabilityAPI`（公共面；工厂与测试共用同一代码路径）：
  *
- * - 未配置 / 无有效 backupProviders 与 chains / 配置错误（已警告）→ 返回
- *   undefined，不注册任何面；残留 `failover.enabled` 键只警告并忽略（已移除，
- *   2026-10-03 D-079），节点按其余字段正常解析装配。
+ * - `api.config` 无 `failover` 节（宿主未注入）→ 直接 return，不注册任何面；
+ *   残留 `failover.enabled` 键只警告并忽略（已移除，2026-10-03 D-079），节点按
+ *   其余字段正常解析装配。
+ * - 配置了解析后：宿主必须注入 `api.host.modelCatalog`（装载预检检查面来源），
+ *   缺席 = "settings 有 failover 但宿主不支持"——fail-loud 抛错，不静默降级。
  * - 配置解析完成后同步执行装载预检（设计 §4.6）：失败条目从候选源剔除并警告，
  *   警告经模块级去重每进程至多一次；预检不阻断其余条目与主 provider 的正常使用。
- * - 宿主侧装配失败由调用方兜底（failover 是可靠性能力，装载失败不得阻断会话）。
- * - 熔断状态是模块级单例：本函数跨会话重复调用注册的是新包装器实例，但共享
+ * - 熔断状态是模块级单例：本工厂跨会话重复调用注册的是新包装器实例，但共享
  *   同一份状态（设计 §4.2）。
  */
-export function installProviderFailoverPlugin(runtime, options) {
-    const warn = options.hostLogger === undefined
+function installProviderFailoverIntoApi(api, deps) {
+    const logger = deps.hostLogger ?? hostLoggerFromApi(api);
+    const warn = logger === undefined
         ? (_message) => { }
         : (message) => {
-            options.hostLogger?.warn("provider-failover", message);
+            logger.warn(message);
         };
-    const config = parseProviderFailoverConfig(options.failoverSettings, warn);
+    // 注入契约：`{ version: 1, failover: <settings failover 节原样> }`；failover
+    // 键缺席 = 未配置（no-op）。
+    const config = parseProviderFailoverConfig(api.config.failover, warn);
     if (config === undefined)
-        return undefined;
+        return;
+    const catalog = api.host.modelCatalog;
+    if (catalog === undefined) {
+        throw new Error("provider failover is configured but the host does not provide the modelCatalog capability service (api.host.modelCatalog); the plugin refuses to assemble without install-time preflight");
+    }
+    // P1 契约：ModelCatalogV1 的检查面（resolveModel/hasProvider/hasConfiguredAuth）
+    // 与预检 checks 同构，直接结构绑定；契约漂移在此处显式报型。
+    const preflight = catalog;
     const warnPreflightOnce = (message) => {
         if (preflightWarnedMessages.has(message))
             return;
         preflightWarnedMessages.add(message);
         warn(message);
     };
-    const preflighted = runProviderFailoverPreflight(config, options.preflight, warnPreflightOnce);
-    const now = options.now ?? (() => Date.now());
-    return loadCapabilityPluginSync(runtime, {
-        id: PROVIDER_FAILOVER_PLUGIN_ID,
-        version: "0.0.0",
-        apiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,
-        entry: "<embedded:provider-failover>",
-    }, (api) => {
-        // 快照通道绑定本会话的公共 session 面（宿主声明 session feature 时在场）：
-        // 会话 A 触发的熔断只写进 A 的日志，footer 可见性是会话局部的（设计 §4.7
-        // 保真度限制）。deps 须在此构建——api 只在工厂内可得。
-        const deps = {
-            runtime,
-            config: preflighted,
-            now,
-            session: api.session,
-            ...(options.hostLogger === undefined ? {} : { hostLogger: options.hostLogger }),
-        };
-        api.registerStreamFnWrapper(PROVIDER_FAILOVER_WRAPPER_NAME, createFailoverWrapper(deps));
-        // 装配期初始快照（status closed）覆盖恢复会话里的陈旧 open 残留：熔断
-        // 状态不持久化，新进程恒 CLOSED（设计 §4.2/§4.7）。无链上下文 → chainId 空。
-        writeStateSnapshot(deps, { version: 1, chainId: "", status: "closed", probeAtMs: 0, now: deps.now() });
+    const preflighted = runProviderFailoverPreflight(config, preflight, warnPreflightOnce);
+    const now = deps.now ?? (() => Date.now());
+    // deps 须在此构建——api 只在工厂内可得。
+    const runtimeDeps = {
+        config: preflighted,
+        now,
+        ...(api.session === undefined ? {} : { session: api.session }),
+        ...(logger === undefined ? {} : { hostLogger: logger }),
+        hasLifecycleEvent: (type, version) => {
+            try {
+                api.lifecycle.get(type, version);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        dispatchLifecycleEvent: (request) => {
+            // LifecycleAPI 无 dispatchLifecycle（模块头差异登记）：等价公共面 =
+            // api.publish。source 由运行时归属本插件 manifest id；phase 不入
+            // EventEnvelope（本插件的可见性事件全部是 committed 相位）；所有派发点
+            // 都带 correlationId = chainId，兜底项仅为满足 LifecycleDispatchRequest
+            // 的可选键型。
+            void api
+                .publish({
+                type: request.type,
+                version: request.version,
+                correlationId: request.correlationId ?? request.type,
+                data: request.data,
+            })
+                .catch(() => {
+                // 可见性事件失败不打断换道判定（宪法 §8 的尽力通道）。
+            });
+        },
+    };
+    api.registerStreamFnWrapper(PROVIDER_FAILOVER_WRAPPER_NAME, createFailoverWrapper(runtimeDeps), {
+        priority: PROVIDER_FAILOVER_WRAPPER_PRIORITY,
+    });
+    // 装配期初始快照（status closed）覆盖恢复会话里的陈旧 open 残留：熔断
+    // 状态不持久化，新进程恒 CLOSED（设计 §4.2/§4.7）。无链上下文 → chainId 空。
+    writeStateSnapshot(runtimeDeps, {
+        version: 1,
+        chainId: "",
+        status: "closed",
+        probeAtMs: 0,
+        now: runtimeDeps.now(),
     });
 }
+/**
+ * 构建 provider-failover 插件工厂（设计 §4.8 的插件包形态）：
+ * `(api: CapabilityAPI) => void`，经公共 `loadCapabilityPlugin`/manifest 通道装载。
+ * deps 仅用于测试注入时钟与进程日志；生产入口（entry.ts 默认导出）零参调用。
+ */
+export function createProviderFailoverPluginFactory(deps = {}) {
+    return (api) => {
+        installProviderFailoverIntoApi(api, deps);
+    };
+}
 //# sourceMappingURL=provider-failover.js.map

package/bundled-plugins/provider-failover/dist/provider-failover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-failover.js","sourceRoot":"","sources":["../src/provider-failover.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 第一方 provider 主备切换插件（设计：docs/design/供应商能力槽位与主备切换设计.md §4；\n * D-082 批 3b 自内核内嵌实现逐字迁出为独立插件包）。\n *\n * 形态与 bootstrap-retry 同族——经公共 `api.registerStreamFnWrapper` 注册面挂进\n * 宿主默认 stream 装配，`{ priority: -100 }` 固定链最外层（与装载顺序无关）——但\n * 熔断状态是**模块级单例**（设计 §4.2）：进程内所有会话与 subagent 共享同一份，\n * 不随会话 dispose，不持久化（重启后全部 CLOSED）。\n *\n * 判定哲学（设计 §2）：只看流终态 done/error/aborted 与\"是否已向上层释放内容\n * 增量\"两个本地事实，不解读错误类型/错误码语义；原始 errorMessage 照透传保留，\n * 只用于事件归因与 diagnostics，不参与机器判定分支。aborted 不计数、不换道、\n * 状态不变。换道从第一次失败即发生；`failureThreshold` 只控制\"是否继续先撞主\"\n * （连续 N 次后熔断打开，请求直接落备用，冷却期满后以真实请求试探回主）。\n *\n * 与内嵌装配的公共面差异（迁移登记，行为等价）：\n * - 配置不再经 SettingsManager 读取：宿主经 manifest config 通道注入\n *   `{ version: 1, failover: <settings failover 节原样> }`；`api.config` 无\n *   failover 节 = 未配置，工厂直接 return（不注册任何面）。\n * - 装载预检检查面改从 `api.host.modelCatalog`（plugin-sdk `ModelCatalogV1`）\n *   结构获取；配置了 failover 而宿主未注入 modelCatalog 时 fail-loud 抛错\n *   （与\"settings 有 failover 但宿主不支持\"同态，不静默降级）。\n * - 插件面 `LifecycleAPI` 无 hasLifecycleEvent/dispatchLifecycle（与原内嵌第一参\n *   `CapabilityRuntime` 的同名方法不同构）：目录 gate 以 `api.lifecycle.get` 的\n *   抛错/命中等价实现（宿主未定义该事件 = 零派发）；派发走公共 `api.publish`\n *   事件总线（source 由运行时归属插件 manifest id；Envelope 无 phase 字段——\n *   本插件的可见性事件全部是 committed 相位）。\n * - 进程日志走 `api.logger`（plugin-sdk `LoggerAPI`）或工厂注入的同形 deps；\n *   warn 文案逐字保留。\n */\n\nimport type {\n\tApi,\n\tAssistantMessage,\n\tAssistantMessageDiagnostic,\n\tAssistantMessageEvent,\n\tAssistantMessageEventStream,\n\tContext,\n\tModel,\n\tSimpleStreamOptions,\n} from \"@agent-forge/ai/compat\";\nimport { createAssistantMessageEventStream } from \"@agent-forge/ai/compat\";\nimport type {\n\tCapabilityAPI,\n\tCapabilityPluginSyncFactory,\n\tLifecycleDispatchRequest,\n\tLoggerAPI,\n\tModelCatalogModelViewV1,\n\tSessionAPI,\n\tStreamFnWrapper,\n} from \"@agent-forge/plugin-sdk\";\n\n/** plugin.json 的 manifest id（原内嵌形态的 `agent-forge.provider-failover` 随内嵌装配退役）。 */\nexport const PROVIDER_FAILOVER_PLUGIN_ID = \"agent-forge.plugin.provider-failover\";\nexport const PROVIDER_FAILOVER_WRAPPER_NAME = \"provider-failover\";\n\n/**\n * 可见性事件的 id/version：与宿主 lifecycle-catalog.ts 的 provider.failover.*\n * 常量逐字同值。插件包不可 import 宿主内部模块（D-075 §0 边界白名单），此处\n * 本地声明；宿主未在 lifecycle 目录定义同名事件时 `api.lifecycle.get` 抛错，\n * gate 关闭、零派发（值漂移因此被发现而不是静默错投）。\n */\nexport const PROVIDER_FAILOVER_SWITCHED_EVENT_ID = \"provider.failover.switched\";\nexport const PROVIDER_FAILOVER_SWITCHED_EVENT_VERSION = 1;\nexport const PROVIDER_FAILOVER_RECOVERED_EVENT_ID = \"provider.failover.recovered\";\nexport const PROVIDER_FAILOVER_RECOVERED_EVENT_VERSION = 1;\nexport const PROVIDER_FAILOVER_PROBE_FAILED_EVENT_ID = \"provider.failover.probe.failed\";\nexport const PROVIDER_FAILOVER_PROBE_FAILED_EVENT_VERSION = 1;\n\n/**\n * 会话日志快照通道的 customType（设计 §4.7 Phase 3）：插件经公共\n * `api.session.appendEntry` 在状态转移点写入快照，footer 每帧取最后一条渲染\n * 摘要行——与 goal.state / todo.state / workflow.state 同构，零新公共面。\n */\nexport const PROVIDER_FAILOVER_STATE_ENTRY_TYPE = \"provider.failover.state\";\n\n/** `provider.failover.state` 快照负载（footer 按最后一条渲染）。 */\nexport interface ProviderFailoverStateSnapshot {\n\treadonly version: 1;\n\t/** 主链引用 `provider/modelId`；装配期初始快照无链上下文，为空串。 */\n\treadonly chainId: string;\n\treadonly status: \"closed\" | \"open\" | \"half-open\";\n\t/** 当前换道目标引用 `provider/modelId`（OPEN 期请求从链头重走）；closed 省略。 */\n\treadonly backupProvider?: string;\n\t/** 下次试探时间戳 = open 时刻 + 当前冷却；closed 为 0。 */\n\treadonly probeAtMs: number;\n\t/** 快照写入时刻（注入时钟友好）。 */\n\treadonly now: number;\n}\n\n/** 链默认阈值/冷却（设计 §4.1：默认值全部可省）。 */\nconst DEFAULT_FAILURE_THRESHOLD = 2;\nconst DEFAULT_COOLDOWN_INITIAL_MS = 60_000;\nconst DEFAULT_COOLDOWN_MAX_MS = 15 * 60_000;\n/** 事件负载与 diagnostics 里的原始错误文本截断上限（只影响展示，不影响判定）。 */\nconst RAW_ERROR_MAX_LENGTH = 500;\n\n// ---------------------------------------------------------------------------\n// 配置解析（局部类型声明：settings `failover` 节不是 settings-manager 的已知面，\n// 解析与校验全部收在本模块内，宿主只递交原始节点）\n// ---------------------------------------------------------------------------\n\ninterface FailoverChainDeclaration {\n\treadonly primary: string;\n\treadonly backups: readonly string[];\n}\n\ninterface ResolvedFailoverConfig {\n\t/** 试探失败冷却起点（也是回 CLOSED 后的重置值）。 */\n\treadonly cooldownInitialMs: number;\n\treadonly cooldownMaxMs: number;\n\treadonly failureThreshold: number;\n\treadonly backupProviders: readonly string[];\n\treadonly chains: readonly FailoverChainDeclaration[];\n}\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> =>\n\ttypeof value === \"object\" && value !== null && !Array.isArray(value);\n\nfunction parseModelReference(reference: string): { provider: string; modelId: string } | undefined {\n\tconst separator = reference.indexOf(\"/\");\n\tif (separator <= 0 || separator === reference.length - 1) return undefined;\n\treturn { provider: reference.slice(0, separator), modelId: reference.slice(separator + 1) };\n}\n\nfunction parseModelReferenceList(value: unknown, label: string, warn: (message: string) => void): string[] | undefined {\n\tif (value === undefined) return undefined;\n\tif (!Array.isArray(value)) {\n\t\twarn(`failover ${label} must be an array of \"provider/modelId\" strings; ignoring it`);\n\t\treturn undefined;\n\t}\n\tconst references: string[] = [];\n\tfor (const entry of value) {\n\t\tif (typeof entry !== \"string\" || parseModelReference(entry) === undefined) {\n\t\t\twarn(`failover ${label} contains a non-\"provider/modelId\" entry; skipping it`);\n\t\t\tcontinue;\n\t\t}\n\t\treferences.push(entry);\n\t}\n\treturn references;\n}\n\n/** `backupProviders` 是纯 provider id 列表（设计 §4.1：`[\"proxy-a\", \"proxy-b\"]`），匹配运行时做。 */\nfunction parseProviderIdList(value: unknown, warn: (message: string) => void): string[] | undefined {\n\tif (value === undefined) return undefined;\n\tif (!Array.isArray(value)) {\n\t\twarn(\"failover.backupProviders must be an array of provider id strings; ignoring it\");\n\t\treturn undefined;\n\t}\n\tconst providerIds: string[] = [];\n\tfor (const entry of value) {\n\t\tif (typeof entry !== \"string\" || entry.trim() === \"\") {\n\t\t\twarn(\"failover.backupProviders contains a non-string entry; skipping it\");\n\t\t\tcontinue;\n\t\t}\n\t\tproviderIds.push(entry);\n\t}\n\treturn providerIds;\n}\n\n/**\n * 解析 settings `failover` 节。返回 undefined = 无 failover（未配置 / 无有效\n * backupProviders 与 chains / 配置错误拒绝加载——后者附带一条警告，设计 §4.1\n * \"重复 primary 拒绝加载并警告\"）。`failover.enabled` 开关已移除（2026-10-03\n * D-079）：节点存在即装配，残留 `enabled` 键只警告并忽略，按其余字段正常解析。\n */\nexport function parseProviderFailoverConfig(\n\traw: unknown,\n\twarn: (message: string) => void,\n): ResolvedFailoverConfig | undefined {\n\tif (raw === undefined || raw === null) return undefined;\n\tif (!isPlainObject(raw)) {\n\t\twarn(\"failover settings must be an object; provider failover stays disabled\");\n\t\treturn undefined;\n\t}\n\tif (raw.enabled !== undefined) {\n\t\twarn(\"failover.enabled was removed (2026-10-03): the failover node installs whenever configured; remove the key\");\n\t}\n\n\tlet failureThreshold = DEFAULT_FAILURE_THRESHOLD;\n\tif (raw.failureThreshold !== undefined) {\n\t\tif (\n\t\t\ttypeof raw.failureThreshold !== \"number\" ||\n\t\t\t!Number.isSafeInteger(raw.failureThreshold) ||\n\t\t\traw.failureThreshold < 1\n\t\t) {\n\t\t\twarn(\"failover.failureThreshold must be a positive integer; using the default (2)\");\n\t\t} else {\n\t\t\tfailureThreshold = raw.failureThreshold;\n\t\t}\n\t}\n\n\tlet cooldownInitialMs = DEFAULT_COOLDOWN_INITIAL_MS;\n\tlet cooldownMaxMs = DEFAULT_COOLDOWN_MAX_MS;\n\tif (raw.cooldown !== undefined) {\n\t\tif (!isPlainObject(raw.cooldown)) {\n\t\t\twarn(\"failover.cooldown must be an object { initialMs?, maxMs? }; using the defaults\");\n\t\t} else {\n\t\t\tconst initialMs = raw.cooldown.initialMs;\n\t\t\tconst maxMs = raw.cooldown.maxMs;\n\t\t\tif (\n\t\t\t\tinitialMs !== undefined &&\n\t\t\t\t(typeof initialMs !== \"number\" || !Number.isSafeInteger(initialMs) || initialMs < 1)\n\t\t\t) {\n\t\t\t\twarn(\"failover.cooldown.initialMs must be a positive integer; using the default (60000)\");\n\t\t\t} else if (initialMs !== undefined) {\n\t\t\t\tcooldownInitialMs = initialMs;\n\t\t\t}\n\t\t\tif (maxMs !== undefined && (typeof maxMs !== \"number\" || !Number.isSafeInteger(maxMs) || maxMs < 1)) {\n\t\t\t\twarn(\"failover.cooldown.maxMs must be a positive integer; using the default (900000)\");\n\t\t\t} else if (maxMs !== undefined) {\n\t\t\t\tcooldownMaxMs = maxMs;\n\t\t\t}\n\t\t}\n\t}\n\tif (cooldownMaxMs < cooldownInitialMs) {\n\t\twarn(\"failover.cooldown.maxMs is below initialMs; clamping maxMs to initialMs\");\n\t\tcooldownMaxMs = cooldownInitialMs;\n\t}\n\n\tconst backupProviders = parseProviderIdList(raw.backupProviders, warn) ?? [];\n\n\tconst chains: FailoverChainDeclaration[] = [];\n\tif (raw.chains !== undefined) {\n\t\tif (!Array.isArray(raw.chains)) {\n\t\t\twarn(\"failover.chains must be an array; ignoring explicit chains\");\n\t\t} else {\n\t\t\tconst seenPrimaries = new Set<string>();\n\t\t\tfor (const entry of raw.chains) {\n\t\t\t\tif (!isPlainObject(entry)) {\n\t\t\t\t\twarn(\"failover.chains entries must be objects; skipping one\");\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tif (typeof entry.primary !== \"string\" || parseModelReference(entry.primary) === undefined) {\n\t\t\t\t\twarn('failover.chains entry is missing a valid \"provider/modelId\" primary; skipping it');\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tconst backups = parseModelReferenceList(entry.backups, `chains[${entry.primary}].backups`, warn) ?? [];\n\t\t\t\tif (seenPrimaries.has(entry.primary)) {\n\t\t\t\t\t// 设计 §4.1：同一 primary 出现在多条显式链 → 配置错误拒绝加载。\n\t\t\t\t\twarn(\n\t\t\t\t\t\t`failover.chains declares primary \"${entry.primary}\" more than once; provider failover stays disabled`,\n\t\t\t\t\t);\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\t\t\t\tseenPrimaries.add(entry.primary);\n\t\t\t\tif (backups.length > 2) {\n\t\t\t\t\twarn(\n\t\t\t\t\t\t`failover chain \"${entry.primary}\" declares ${backups.length} backups; the worst-case retry budget grows with chain length (recommended: at most 2)`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tchains.push({ primary: entry.primary, backups });\n\t\t\t}\n\t\t}\n\t}\n\n\tif (backupProviders.length === 0 && chains.length === 0) return undefined;\n\treturn { cooldownInitialMs, cooldownMaxMs, failureThreshold, backupProviders, chains };\n}\n\n// ---------------------------------------------------------------------------\n// 熔断状态机（模块级单例，设计 §4.2：进程内所有会话共享，不持久化）\n// ---------------------------------------------------------------------------\n\ntype ProviderBreakerStatus = \"closed\" | \"open\" | \"half-open\";\n\ninterface ProviderBreakerState {\n\tstatus: ProviderBreakerStatus;\n\t/** CLOSED 期主连续失败计数；任一主 done 清零（设计 §4.2）。 */\n\tconsecutiveFailures: number;\n\t/** 当前冷却时长：打开时取 initialMs，每次试探失败 ×2 封顶 maxMs。 */\n\tcooldownMs: number;\n\topenedAtMs: number;\n}\n\nconst providerBreakerRegistry = new Map<string, ProviderBreakerState>();\n\n/** 预检警告去重集（设计 §4.6：每进程至多一次，与会话重复装载解耦）。 */\nconst preflightWarnedMessages = new Set<string>();\n\n/** 测试隔离钩子：清空模块级熔断单例与预检警告去重集（仅测试使用）。 */\nexport function resetProviderFailoverStateForTests(): void {\n\tproviderBreakerRegistry.clear();\n\tpreflightWarnedMessages.clear();\n}\n\nfunction getBreaker(chainId: string, config: ResolvedFailoverConfig): ProviderBreakerState {\n\tlet breaker = providerBreakerRegistry.get(chainId);\n\tif (breaker === undefined) {\n\t\tbreaker = {\n\t\t\tstatus: \"closed\",\n\t\t\tconsecutiveFailures: 0,\n\t\t\tcooldownMs: config.cooldownInitialMs,\n\t\t\topenedAtMs: 0,\n\t\t};\n\t\tproviderBreakerRegistry.set(chainId, breaker);\n\t}\n\treturn breaker;\n}\n\n// ---------------------------------------------------------------------------\n// 换道主体\n// ---------------------------------------------------------------------------\n\ninterface FailoverAttempt {\n\treadonly model: Model<Api>;\n\treadonly role: \"primary\" | \"backup\";\n}\n\ninterface AttemptFailure {\n\treadonly model: Model<Api>;\n\t/** 失败尝试的原始错误消息（照透传；诊断与事件只做展示截断）。 */\n\treadonly message: AssistantMessage;\n}\n\ntype AttemptOutcome =\n\t| { readonly outcome: \"done\"; readonly message: AssistantMessage }\n\t| { readonly outcome: \"aborted\"; readonly message: AssistantMessage }\n\t/** 已过提交边界（内容增量已释放）的 error：终态已转发，不可换道。 */\n\t| { readonly outcome: \"failed-forwarded\"; readonly message: AssistantMessage }\n\t/** 未过提交边界的 error：上层尚未看到任何事件，可安全重放。 */\n\t| { readonly outcome: \"failed-switchable\"; readonly failure: AttemptFailure };\n\nconst isCommittedDelta = (event: { type: string }): boolean =>\n\tevent.type === \"text_delta\" || event.type === \"thinking_delta\" || event.type === \"toolcall_delta\";\n\nfunction truncateRawError(text: string | undefined): string {\n\tconst value = text === undefined || text === \"\" ? \"unknown error\" : text;\n\treturn value.length > RAW_ERROR_MAX_LENGTH ? `${value.slice(0, RAW_ERROR_MAX_LENGTH)}…[truncated]` : value;\n}\n\nfunction createThrownErrorMessage(model: Model<Api>, error: unknown, nowMs: number): AssistantMessage {\n\treturn {\n\t\trole: \"assistant\",\n\t\tcontent: [],\n\t\tapi: model.api,\n\t\tprovider: model.provider,\n\t\tmodel: model.id,\n\t\tusage: {\n\t\t\tinput: 0,\n\t\t\toutput: 0,\n\t\t\tcacheRead: 0,\n\t\t\tcacheWrite: 0,\n\t\t\ttotalTokens: 0,\n\t\t\tcost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },\n\t\t},\n\t\tstopReason: \"error\",\n\t\terrorMessage: error instanceof Error ? error.message : String(error),\n\t\ttimestamp: nowMs,\n\t};\n}\n\n/**\n * 换道重放的凭据剔除（设计 §4.4）：apiKey/headers/env 是主 provider 的预解析\n * 凭据，照抄重放会把主的 key 发给备用 provider——剔除后由目标 provider 经\n * 宿主 auth 解析重新注入。其余 options（signal、预算、缓存策略等）原样保留。\n */\nfunction stripCredentialOptions(options: SimpleStreamOptions | undefined): SimpleStreamOptions | undefined {\n\tif (options === undefined) return undefined;\n\tconst { apiKey: _apiKey, headers: _headers, env: _env, ...rest } = options;\n\treturn rest;\n}\n\n/** 候选序列解析（设计 §4.1）：显式链优先，否则 backupProviders 按声明顺序同 id 匹配。 */\nfunction resolveFailoverCandidates(\n\tmodel: Model<Api>,\n\tconfig: ResolvedFailoverConfig,\n\tresolveModel: (provider: string, modelId: string) => Model<Api> | undefined,\n): Model<Api>[] {\n\tconst reference = `${model.provider}/${model.id}`;\n\tconst chain = config.chains.find((entry) => entry.primary === reference);\n\tif (chain !== undefined) {\n\t\tconst candidates: Model<Api>[] = [];\n\t\tfor (const backup of chain.backups) {\n\t\t\tconst parsed = parseModelReference(backup);\n\t\t\tconst resolved = parsed === undefined ? undefined : resolveModel(parsed.provider, parsed.modelId);\n\t\t\tif (resolved === undefined) continue;\n\t\t\tif (resolved.provider === model.provider && resolved.id === model.id) continue;\n\t\t\tcandidates.push(resolved);\n\t\t}\n\t\treturn candidates;\n\t}\n\tconst candidates: Model<Api>[] = [];\n\tfor (const providerId of config.backupProviders) {\n\t\t// 含主 provider 自身 → 忽略该项（设计 §4.1）。\n\t\tif (providerId === model.provider) continue;\n\t\tconst resolved = resolveModel(providerId, model.id);\n\t\tif (resolved !== undefined) candidates.push(resolved);\n\t}\n\treturn candidates;\n}\n\n/** 进程日志警告面（插件局部形状）：工厂 deps 可注入（测试确定性），缺省适配 `api.logger`。 */\nexport interface ProviderFailoverHostLogger {\n\twarn(message: string, context?: { readonly cause?: unknown }): void;\n}\n\ninterface ProviderFailoverRuntimeDeps {\n\treadonly config: ResolvedFailoverConfig;\n\treadonly now: () => number;\n\t/**\n\t * 会话日志快照通道（宿主声明 `session` feature 时在场；最小宿主可缺席）。\n\t * 缺席只损失 footer 可见性，不影响换道判定。\n\t */\n\treadonly session?: Pick<SessionAPI, \"appendEntry\">;\n\t/** 快照写入失败的警告通道；缺省静默（与 lifecycle 事件通道同级）。 */\n\treadonly hostLogger?: ProviderFailoverHostLogger;\n\t/**\n\t * 事件目录 gate（`api.lifecycle.get` 命中/抛错等价原 hasLifecycleEvent）：\n\t * 宿主未在 lifecycle 目录定义该事件 = 零派发。\n\t */\n\treadonly hasLifecycleEvent: (type: string, version: number) => boolean;\n\t/** 尽力派发（`api.publish` 等价面；失败只吞掉，不打断换道判定）。 */\n\treadonly dispatchLifecycleEvent: (request: LifecycleDispatchRequest) => void;\n}\n\n/**\n * 写一条熔断状态快照进会话日志（设计 §4.7 Phase 3）。尽力通道：失败不打断\n * 换道判定，但经进程日志警告保持失败可见。\n */\nfunction writeStateSnapshot(deps: ProviderFailoverRuntimeDeps, snapshot: ProviderFailoverStateSnapshot): void {\n\tif (deps.session === undefined) return;\n\ttry {\n\t\tdeps.session.appendEntry(PROVIDER_FAILOVER_STATE_ENTRY_TYPE, snapshot);\n\t} catch (error) {\n\t\tdeps.hostLogger?.warn(\"failover state snapshot append failed\", { cause: error });\n\t}\n}\n\n/** OPEN 转移点（阈值打开 / 试探失败重开）共用的 open 快照。 */\nfunction writeOpenStateSnapshot(\n\tdeps: ProviderFailoverRuntimeDeps,\n\tchainId: string,\n\tbreaker: ProviderBreakerState,\n\tbackupReference: string | undefined,\n): void {\n\twriteStateSnapshot(deps, {\n\t\tversion: 1,\n\t\tchainId,\n\t\tstatus: \"open\",\n\t\t...(backupReference === undefined ? {} : { backupProvider: backupReference }),\n\t\tprobeAtMs: breaker.openedAtMs + breaker.cooldownMs,\n\t\tnow: breaker.openedAtMs,\n\t});\n}\n\nfunction dispatchFailoverEvent(deps: ProviderFailoverRuntimeDeps, request: LifecycleDispatchRequest): void {\n\ttry {\n\t\tif (!deps.hasLifecycleEvent(request.type, request.version)) return;\n\t\tdeps.dispatchLifecycleEvent(request);\n\t} catch {\n\t\t// 同上：派发入口同步抛错也不影响请求路径。\n\t}\n}\n\nfunction createFailoverWrapper(deps: ProviderFailoverRuntimeDeps): StreamFnWrapper {\n\treturn (modelArgument, contextArgument, optionsArgument, next, host) => {\n\t\tconst model = modelArgument as Model<Api>;\n\t\tconst context = contextArgument as Context;\n\t\tconst options = optionsArgument as SimpleStreamOptions | undefined;\n\t\tconst outer = createAssistantMessageEventStream();\n\t\tconst resolveModel = (provider: string, modelId: string): Model<Api> | undefined =>\n\t\t\thost.resolveModel(provider, modelId) as Model<Api> | undefined;\n\t\tvoid driveFailoverStream(deps, outer, model, context, options, next, resolveModel);\n\t\treturn outer;\n\t};\n}\n\nasync function driveFailoverStream(\n\tdeps: ProviderFailoverRuntimeDeps,\n\touter: AssistantMessageEventStream,\n\tmodel: Model<Api>,\n\tcontext: Context,\n\toptions: SimpleStreamOptions | undefined,\n\tnext: (model: unknown, context: unknown, options: unknown) => unknown,\n\tresolveModel: (provider: string, modelId: string) => Model<Api> | undefined,\n): Promise<void> {\n\tconst { config } = deps;\n\tconst nowMs = deps.now();\n\tconst chainId = `${model.provider}/${model.id}`;\n\tconst breaker = getBreaker(chainId, config);\n\n\t// 入场判定（设计 §4.3 判定表）：CLOSED/HALF_OPEN 撞主，OPEN 且冷却未满落备用。\n\tlet attemptPrimary = true;\n\tlet isProbe = false;\n\tif (breaker.status === \"open\") {\n\t\tif (nowMs - breaker.openedAtMs >= breaker.cooldownMs) {\n\t\t\t// 冷却期满：下一个真实请求改道回主作试探（HALF_OPEN 并发放行）。\n\t\t\tbreaker.status = \"half-open\";\n\t\t\tisProbe = true;\n\t\t} else {\n\t\t\tattemptPrimary = false;\n\t\t}\n\t} else if (breaker.status === \"half-open\") {\n\t\tisProbe = true;\n\t}\n\n\tconst candidates = resolveFailoverCandidates(model, config, resolveModel);\n\t// OPEN 期请求从链头重走（设计 §4.3），快照披露的换道目标 = 链头候选。\n\tconst backupReference = candidates[0] === undefined ? undefined : `${candidates[0].provider}/${candidates[0].id}`;\n\n\tconst attempts: FailoverAttempt[] = [];\n\tif (attemptPrimary) attempts.push({ model, role: \"primary\" });\n\tfor (const candidate of candidates) attempts.push({ model: candidate, role: \"backup\" });\n\tif (attempts.length === 0) {\n\t\t// OPEN 且候选为空：无别处可去，直发主（按普通主请求计账，不作试探）。\n\t\tattempts.push({ model, role: \"primary\" });\n\t}\n\n\tconst failures: AttemptFailure[] = [];\n\tlet switchOrdinal = 0;\n\tfor (let index = 0; index < attempts.length; index++) {\n\t\tconst attempt = attempts[index];\n\t\tconst attemptOptions = attempt.role === \"backup\" ? stripCredentialOptions(options) : options;\n\t\tconst result = await runFailoverAttempt(outer, next, attempt.model, context, attemptOptions, deps.now);\n\n\t\tif (result.outcome === \"done\") {\n\t\t\tif (attempt.role === \"primary\") {\n\t\t\t\tbreaker.status = \"closed\";\n\t\t\t\tbreaker.consecutiveFailures = 0;\n\t\t\t\tbreaker.cooldownMs = config.cooldownInitialMs;\n\t\t\t\tif (isProbe) {\n\t\t\t\t\tdispatchFailoverEvent(deps, {\n\t\t\t\t\t\ttype: PROVIDER_FAILOVER_RECOVERED_EVENT_ID,\n\t\t\t\t\t\tversion: PROVIDER_FAILOVER_RECOVERED_EVENT_VERSION,\n\t\t\t\t\t\tphase: \"committed\",\n\t\t\t\t\t\tsource: PROVIDER_FAILOVER_PLUGIN_ID,\n\t\t\t\t\t\t// 事件总线 correlationId 取链引用（workflow.changed 同款领域键模式）。\n\t\t\t\t\t\tcorrelationId: chainId,\n\t\t\t\t\t\tdata: { version: 1, chainId, provider: model.provider },\n\t\t\t\t\t});\n\t\t\t\t\t// HALF_OPEN → CLOSED 转移点：footer 摘要行随最后一条 closed 快照消失。\n\t\t\t\t\twriteStateSnapshot(deps, {\n\t\t\t\t\t\tversion: 1,\n\t\t\t\t\t\tchainId,\n\t\t\t\t\t\tstatus: \"closed\",\n\t\t\t\t\t\tprobeAtMs: 0,\n\t\t\t\t\t\tnow: deps.now(),\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\t\t\t// 备用成败不影响 primary 熔断状态（设计 §4.2）。\n\t\t\treturn;\n\t\t}\n\n\t\tif (result.outcome === \"aborted\") {\n\t\t\t// 用户本地取消：不计数、不换道、状态不变（设计 §2/§4.3）。\n\t\t\treturn;\n\t\t}\n\n\t\tif (result.outcome === \"failed-forwarded\") {\n\t\t\t// 已过提交边界：不可重放，交回合级重试；主失败照常计数。\n\t\t\tif (attempt.role === \"primary\") {\n\t\t\t\trecordPrimaryFailure(deps, breaker, config, chainId, result.message, isProbe, backupReference);\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\t// failed-switchable：无可见内容，可换道重放。\n\t\tfailures.push(result.failure);\n\t\tif (attempt.role === \"primary\") {\n\t\t\trecordPrimaryFailure(deps, breaker, config, chainId, result.failure.message, isProbe, backupReference);\n\t\t}\n\n\t\tif (index + 1 < attempts.length) {\n\t\t\tswitchOrdinal += 1;\n\t\t\tconst target = attempts[index + 1];\n\t\t\tdispatchFailoverEvent(deps, {\n\t\t\t\ttype: PROVIDER_FAILOVER_SWITCHED_EVENT_ID,\n\t\t\t\tversion: PROVIDER_FAILOVER_SWITCHED_EVENT_VERSION,\n\t\t\t\tphase: \"committed\",\n\t\t\t\tsource: PROVIDER_FAILOVER_PLUGIN_ID,\n\t\t\t\t// 事件总线 correlationId 取链引用（workflow.changed 同款领域键模式）。\n\t\t\t\tcorrelationId: chainId,\n\t\t\t\tdata: {\n\t\t\t\t\tversion: 1,\n\t\t\t\t\tchainId,\n\t\t\t\t\tfrom: `${attempt.model.provider}/${attempt.model.id}`,\n\t\t\t\t\tto: `${target.model.provider}/${target.model.id}`,\n\t\t\t\t\tattempt: switchOrdinal,\n\t\t\t\t\trawError: truncateRawError(result.failure.message.errorMessage),\n\t\t\t\t},\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\t\tbreak;\n\t}\n\n\t// 全链尽：报链内最后一次实际失败的原始错误 + 整链摘要进 diagnostics（设计 §4.3）。\n\tconst lastFailure = failures[failures.length - 1];\n\tif (lastFailure === undefined) {\n\t\t// 不可达（至少一次 failed-switchable 才会走到这里）；保守以合成错误收尾。\n\t\tconst message = createThrownErrorMessage(model, new Error(\"provider failover exhausted the chain\"), deps.now());\n\t\touter.push({ type: \"error\", reason: \"error\", error: message });\n\t\touter.end();\n\t\treturn;\n\t}\n\tconst diagnostic: AssistantMessageDiagnostic = {\n\t\ttype: \"provider-failover\",\n\t\ttimestamp: deps.now(),\n\t\tdetails: {\n\t\t\tchainId,\n\t\t\tattempts: failures.map((failure) => ({\n\t\t\t\tprovider: failure.model.provider,\n\t\t\t\tmodel: failure.model.id,\n\t\t\t\terror: truncateRawError(failure.message.errorMessage),\n\t\t\t})),\n\t\t},\n\t};\n\tconst finalMessage: AssistantMessage = {\n\t\t...lastFailure.message,\n\t\tdiagnostics: [...(lastFailure.message.diagnostics ?? []), diagnostic],\n\t};\n\touter.push({ type: \"error\", reason: \"error\", error: finalMessage });\n\touter.end();\n}\n\n/**\n * 主失败计账（设计 §4.2/§4.3）：CLOSED 期连续 N 次达到阈值 → OPEN（冷却取\n * initialMs）；HALF_OPEN 试探失败 → OPEN 且冷却 ×2 封顶 maxMs（经 probe.failed\n * 事件可见）。backup 的成败永远不进这里。\n */\nfunction recordPrimaryFailure(\n\tdeps: ProviderFailoverRuntimeDeps,\n\tbreaker: ProviderBreakerState,\n\tconfig: ResolvedFailoverConfig,\n\tchainId: string,\n\tmessage: AssistantMessage,\n\tisProbe: boolean,\n\tbackupReference: string | undefined,\n): void {\n\tif (isProbe) {\n\t\topenAfterFailedProbe(deps, breaker, config, chainId, message, backupReference);\n\t\treturn;\n\t}\n\tbreaker.consecutiveFailures += 1;\n\tif (breaker.consecutiveFailures >= config.failureThreshold) {\n\t\tbreaker.status = \"open\";\n\t\tbreaker.cooldownMs = config.cooldownInitialMs;\n\t\tbreaker.openedAtMs = deps.now();\n\t\twriteOpenStateSnapshot(deps, chainId, breaker, backupReference);\n\t}\n}\n\n/** HALF_OPEN 试探失败：回 OPEN，冷却 ×2 封顶 maxMs，并派发 probe.failed（设计 §4.2）。 */\nfunction openAfterFailedProbe(\n\tdeps: ProviderFailoverRuntimeDeps,\n\tbreaker: ProviderBreakerState,\n\tconfig: ResolvedFailoverConfig,\n\tchainId: string,\n\tmessage: AssistantMessage,\n\tbackupReference: string | undefined,\n): void {\n\tbreaker.status = \"open\";\n\tbreaker.cooldownMs = Math.min(breaker.cooldownMs * 2, config.cooldownMaxMs);\n\tbreaker.openedAtMs = deps.now();\n\tdispatchFailoverEvent(deps, {\n\t\ttype: PROVIDER_FAILOVER_PROBE_FAILED_EVENT_ID,\n\t\tversion: PROVIDER_FAILOVER_PROBE_FAILED_EVENT_VERSION,\n\t\tphase: \"committed\",\n\t\tsource: PROVIDER_FAILOVER_PLUGIN_ID,\n\t\t// 事件总线 correlationId 取链引用（workflow.changed 同款领域键模式）。\n\t\tcorrelationId: chainId,\n\t\tdata: {\n\t\t\tversion: 1,\n\t\t\tchainId,\n\t\t\tprovider: message.provider,\n\t\t\trawError: truncateRawError(message.errorMessage),\n\t\t\tnextCooldownMs: breaker.cooldownMs,\n\t\t},\n\t});\n\twriteOpenStateSnapshot(deps, chainId, breaker, backupReference);\n}\n\nasync function runFailoverAttempt(\n\touter: AssistantMessageEventStream,\n\tnext: (model: unknown, context: unknown, options: unknown) => unknown,\n\tattemptModel: Model<Api>,\n\tcontext: Context,\n\toptions: SimpleStreamOptions | undefined,\n\tnow: () => number,\n): Promise<AttemptOutcome> {\n\tlet inner: AssistantMessageEventStream;\n\ttry {\n\t\tinner = (await next(attemptModel, context, options)) as AssistantMessageEventStream;\n\t} catch (error) {\n\t\tconst message = createThrownErrorMessage(attemptModel, error, now());\n\t\treturn { outcome: \"failed-switchable\", failure: { model: attemptModel, message } };\n\t}\n\n\t// 前奏事件缓冲（设计 §4.4）：提交边界（首个内容增量）或正常完成前不释放，\n\t// 使\"无可见内容\"的失败可以整段丢弃后无感重放。非增量、非终态事件（start、\n\t// *_start、*_end 及未知扩展事件）一律入缓冲——保守归入前奏，重放安全性优先。\n\tconst buffered: AssistantMessageEvent[] = [];\n\tlet committed = false;\n\tconst flushBuffer = (): void => {\n\t\tfor (const event of buffered) outer.push(event);\n\t\tbuffered.length = 0;\n\t};\n\ttry {\n\t\tfor await (const event of inner) {\n\t\t\tif (event.type === \"done\") {\n\t\t\t\tflushBuffer();\n\t\t\t\touter.push(event);\n\t\t\t\touter.end();\n\t\t\t\treturn { outcome: \"done\", message: event.message };\n\t\t\t}\n\t\t\tif (event.type === \"error\") {\n\t\t\t\tif (event.reason === \"aborted\") {\n\t\t\t\t\t// 不重放的终态：丢弃缓冲只发终态，避免上层收到孤立 start。\n\t\t\t\t\touter.push(event);\n\t\t\t\t\touter.end();\n\t\t\t\t\treturn { outcome: \"aborted\", message: event.error };\n\t\t\t\t}\n\t\t\t\tif (committed) {\n\t\t\t\t\touter.push(event);\n\t\t\t\t\touter.end();\n\t\t\t\t\treturn { outcome: \"failed-forwarded\", message: event.error };\n\t\t\t\t}\n\t\t\t\treturn { outcome: \"failed-switchable\", failure: { model: attemptModel, message: event.error } };\n\t\t\t}\n\t\t\tif (isCommittedDelta(event)) {\n\t\t\t\tif (!committed) {\n\t\t\t\t\tcommitted = true;\n\t\t\t\t\tflushBuffer();\n\t\t\t\t}\n\t\t\t\touter.push(event);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (committed) outer.push(event);\n\t\t\telse buffered.push(event);\n\t\t}\n\t} catch (error) {\n\t\tconst message = createThrownErrorMessage(attemptModel, error, now());\n\t\tif (committed) {\n\t\t\tconst errorEvent = { type: \"error\" as const, reason: \"error\" as const, error: message };\n\t\t\touter.push(errorEvent);\n\t\t\touter.end();\n\t\t\treturn { outcome: \"failed-forwarded\", message };\n\t\t}\n\t\treturn { outcome: \"failed-switchable\", failure: { model: attemptModel, message } };\n\t}\n\n\t// 流自然结束但没有终止信号：按设计 §2 的归一哲学视作 error 终态。\n\tconst message = createThrownErrorMessage(attemptModel, new Error(\"stream ended without a terminal event\"), now());\n\tif (committed) {\n\t\touter.push({ type: \"error\", reason: \"error\", error: message });\n\t\touter.end();\n\t\treturn { outcome: \"failed-forwarded\", message };\n\t}\n\treturn { outcome: \"failed-switchable\", failure: { model: attemptModel, message } };\n}\n\n// ---------------------------------------------------------------------------\n// 装载预检（设计 §4.6：插件安装时同步执行的静态检查，零网络请求）\n// ---------------------------------------------------------------------------\n\n/**\n * 装载预检的宿主静态检查面（设计 §4.6）。全部为目录/凭据快照读取：不发网络\n * 请求、不触发 OAuth 刷新（凭据检查与原内嵌装配的 ModelRuntime.hasConfiguredAuth\n * 同构——只读\"该 provider 是否有凭据条目\"，不做可用性探测）。与原内嵌形态的\n * 类型差异：resolveModel 返回 plugin-sdk `ModelCatalogModelViewV1`（provider/\n * contextWindow/maxTokens/compat/thinkingLevelMap 五字段视图）而非 `Model<Api>`，\n * 即 P1 契约 `ModelCatalogV1` 的对应面。\n */\nexport interface ProviderFailoverPreflightChecks {\n\t/** 目录解析，与运行时换道候选解析同一面。 */\n\treadonly resolveModel: (provider: string, modelId: string) => ModelCatalogModelViewV1 | undefined;\n\t/** provider 在组合目录（builtin + models.json + 扩展）中存在（backupProviders 层预检）。 */\n\treadonly hasProvider: (providerId: string) => boolean;\n\t/** provider 有凭据条目（静态；不触发 OAuth 刷新）。 */\n\treadonly hasConfiguredAuth: (providerId: string) => boolean;\n}\n\n/**\n * 稳定序列化（键排序、剔除 undefined）：compat/thinkingLevelMap 的派生差异按\n * 值比较，不依赖对象键序。\n */\nfunction stableStringify(value: unknown): string {\n\tif (value === undefined) return \"∅\";\n\tif (value === null || typeof value !== \"object\") return JSON.stringify(value) ?? String(value);\n\tif (Array.isArray(value)) return `[${value.map(stableStringify).join(\",\")}]`;\n\tconst entries = Object.entries(value as Record<string, unknown>)\n\t\t.filter(([, entryValue]) => entryValue !== undefined)\n\t\t.sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0));\n\treturn `{${entries.map(([key, entryValue]) => `${JSON.stringify(key)}:${stableStringify(entryValue)}`).join(\",\")}}`;\n}\n\n/**\n * 显式链全量预检（设计 §4.6）：每个 backup 逐一检查，失败条目从链中剔除并\n * 警告；主不可解析 → 整链跳过。contextWindow/compat/thinkingLevelMap/maxTokens\n * 差异只进警告清单、不硬拦——实施裁量：contextWindow 低于主的备用对小上下文\n * 请求仍可成功，剔除条目会静默损失兜底；只有上下文逼近主窗口的请求才必失败，\n * 该情形运行时走链内下一候选，有界。\n */\nfunction preflightExplicitChain(\n\tchain: FailoverChainDeclaration,\n\tchecks: ProviderFailoverPreflightChecks,\n\twarn: (message: string) => void,\n): FailoverChainDeclaration | undefined {\n\tconst parsedPrimary = parseModelReference(chain.primary);\n\tconst primaryModel =\n\t\tparsedPrimary === undefined ? undefined : checks.resolveModel(parsedPrimary.provider, parsedPrimary.modelId);\n\tif (parsedPrimary === undefined || primaryModel === undefined) {\n\t\twarn(`failover chain \"${chain.primary}\" primary does not resolve in the model catalog; skipping the chain`);\n\t\treturn undefined;\n\t}\n\tconst backups: string[] = [];\n\tfor (const backup of chain.backups) {\n\t\tconst parsed = parseModelReference(backup);\n\t\tconst backupModel = parsed === undefined ? undefined : checks.resolveModel(parsed.provider, parsed.modelId);\n\t\tif (parsed === undefined || backupModel === undefined) {\n\t\t\twarn(\n\t\t\t\t`failover chain \"${chain.primary}\" backup \"${backup}\" does not resolve in the model catalog; skipping it`,\n\t\t\t);\n\t\t\tcontinue;\n\t\t}\n\t\tif (!checks.hasConfiguredAuth(backupModel.provider)) {\n\t\t\twarn(\n\t\t\t\t`failover chain \"${chain.primary}\" backup provider \"${backupModel.provider}\" has no configured credentials; skipping \"${backup}\"`,\n\t\t\t);\n\t\t\tcontinue;\n\t\t}\n\t\tif (backupModel.contextWindow < primaryModel.contextWindow) {\n\t\t\twarn(\n\t\t\t\t`failover chain \"${chain.primary}\" backup \"${backup}\" context window (${backupModel.contextWindow}) is below the primary's (${primaryModel.contextWindow}); contexts sized for the primary may fail on this backup (entry kept)`,\n\t\t\t);\n\t\t}\n\t\tif (backupModel.maxTokens !== primaryModel.maxTokens) {\n\t\t\twarn(\n\t\t\t\t`failover chain \"${chain.primary}\" backup \"${backup}\" maxTokens (${backupModel.maxTokens}) differs from the primary's (${primaryModel.maxTokens}); output budget may change after switching`,\n\t\t\t);\n\t\t}\n\t\tif (stableStringify(backupModel.compat) !== stableStringify(primaryModel.compat)) {\n\t\t\twarn(\n\t\t\t\t`failover chain \"${chain.primary}\" backup \"${backup}\" compat differs from the primary's; request derivation may change after switching`,\n\t\t\t);\n\t\t}\n\t\tif (stableStringify(backupModel.thinkingLevelMap) !== stableStringify(primaryModel.thinkingLevelMap)) {\n\t\t\twarn(\n\t\t\t\t`failover chain \"${chain.primary}\" backup \"${backup}\" thinkingLevelMap differs from the primary's; reasoning level mapping may change after switching`,\n\t\t\t);\n\t\t}\n\t\tbackups.push(backup);\n\t}\n\tif (backups.length === 0 && chain.backups.length > 0) {\n\t\twarn(\n\t\t\t`failover chain \"${chain.primary}\" has no usable backups left after preflight; the primary keeps no failover candidates from this chain`,\n\t\t);\n\t}\n\treturn { primary: chain.primary, backups };\n}\n\n/**\n * backupProviders 层预检（设计 §4.6）：仅检 provider 存在 + 凭据条目；模型匹配\n * 留运行时（目录同 id 匹配不到时静默跳过，不算失败）。\n */\nfunction preflightBackupProviders(\n\tproviderIds: readonly string[],\n\tchecks: ProviderFailoverPreflightChecks,\n\twarn: (message: string) => void,\n): string[] {\n\tconst retained: string[] = [];\n\tfor (const providerId of providerIds) {\n\t\tif (!checks.hasProvider(providerId)) {\n\t\t\twarn(`failover.backupProviders entry \"${providerId}\" is not a known provider; skipping it`);\n\t\t\tcontinue;\n\t\t}\n\t\tif (!checks.hasConfiguredAuth(providerId)) {\n\t\t\twarn(`failover.backupProviders entry \"${providerId}\" has no configured credentials; skipping it`);\n\t\t\tcontinue;\n\t\t}\n\t\tretained.push(providerId);\n\t}\n\treturn retained;\n}\n\n/**\n * 装载预检主体：返回过滤后的派生配置（预检失败条目已从候选源剔除）。不改变\n * 运行时候选解析逻辑——过滤只发生在装载期，运行时候选解析逻辑不变。\n */\nfunction runProviderFailoverPreflight(\n\tconfig: ResolvedFailoverConfig,\n\tchecks: ProviderFailoverPreflightChecks,\n\twarn: (message: string) => void,\n): ResolvedFailoverConfig {\n\tconst backupProviders = preflightBackupProviders(config.backupProviders, checks, warn);\n\tconst chains: FailoverChainDeclaration[] = [];\n\tfor (const chain of config.chains) {\n\t\tconst preflighted = preflightExplicitChain(chain, checks, warn);\n\t\tif (preflighted !== undefined) chains.push(preflighted);\n\t}\n\treturn { ...config, backupProviders, chains };\n}\n\n// ---------------------------------------------------------------------------\n// 装配（插件工厂）\n// ---------------------------------------------------------------------------\n\nexport interface ProviderFailoverPluginFactoryDeps {\n\t/** 注入时钟（测试用确定性时间）；缺省 Date.now。 */\n\treadonly now?: () => number;\n\t/** 进程日志；缺省适配 `api.logger`（宿主未声明 logger-v1 时配置警告静默丢弃）。 */\n\treadonly hostLogger?: ProviderFailoverHostLogger;\n}\n\n/** wrapper 注册优先级：低值更外层；-100 保证 failover 恒在链最外层（与装载顺序无关）。 */\nconst PROVIDER_FAILOVER_WRAPPER_PRIORITY = -100;\n\n/** 适配 `api.logger`（plugin-sdk LoggerAPI）为插件的进程日志警告面；未声明 logger-v1 时缺席。 */\nfunction hostLoggerFromApi(api: CapabilityAPI): ProviderFailoverHostLogger | undefined {\n\tconst logger: LoggerAPI | undefined = api.logger;\n\tif (logger === undefined) return undefined;\n\treturn {\n\t\twarn: (message, context) => {\n\t\t\tconst cause = context?.cause;\n\t\t\t// LoggerAPI.warn 不带 cause 形参：cause 归一为单行文本进 fields。\n\t\t\tlogger.warn(message, cause === undefined ? undefined : { cause: describeCause(cause) });\n\t\t},\n\t};\n}\n\nfunction describeCause(cause: unknown): string {\n\tif (cause instanceof Error) return cause.message === \"\" ? cause.name : `${cause.name}: ${cause.message}`;\n\treturn String(cause);\n}\n\n/**\n * 把插件装配进一个已构建的 `CapabilityAPI`（公共面；工厂与测试共用同一代码路径）：\n *\n * - `api.config` 无 `failover` 节（宿主未注入）→ 直接 return，不注册任何面；\n *   残留 `failover.enabled` 键只警告并忽略（已移除，2026-10-03 D-079），节点按\n *   其余字段正常解析装配。\n * - 配置了解析后：宿主必须注入 `api.host.modelCatalog`（装载预检检查面来源），\n *   缺席 = \"settings 有 failover 但宿主不支持\"——fail-loud 抛错，不静默降级。\n * - 配置解析完成后同步执行装载预检（设计 §4.6）：失败条目从候选源剔除并警告，\n *   警告经模块级去重每进程至多一次；预检不阻断其余条目与主 provider 的正常使用。\n * - 熔断状态是模块级单例：本工厂跨会话重复调用注册的是新包装器实例，但共享\n *   同一份状态（设计 §4.2）。\n */\nfunction installProviderFailoverIntoApi(api: CapabilityAPI, deps: ProviderFailoverPluginFactoryDeps): void {\n\tconst logger = deps.hostLogger ?? hostLoggerFromApi(api);\n\tconst warn =\n\t\tlogger === undefined\n\t\t\t? (_message: string) => {}\n\t\t\t: (message: string) => {\n\t\t\t\t\tlogger.warn(message);\n\t\t\t\t};\n\t// 注入契约：`{ version: 1, failover: <settings failover 节原样> }`；failover\n\t// 键缺席 = 未配置（no-op）。\n\tconst config = parseProviderFailoverConfig(api.config.failover, warn);\n\tif (config === undefined) return;\n\tconst catalog = api.host.modelCatalog;\n\tif (catalog === undefined) {\n\t\tthrow new Error(\n\t\t\t\"provider failover is configured but the host does not provide the modelCatalog capability service (api.host.modelCatalog); the plugin refuses to assemble without install-time preflight\",\n\t\t);\n\t}\n\t// P1 契约：ModelCatalogV1 的检查面（resolveModel/hasProvider/hasConfiguredAuth）\n\t// 与预检 checks 同构，直接结构绑定；契约漂移在此处显式报型。\n\tconst preflight: ProviderFailoverPreflightChecks = catalog;\n\tconst warnPreflightOnce = (message: string): void => {\n\t\tif (preflightWarnedMessages.has(message)) return;\n\t\tpreflightWarnedMessages.add(message);\n\t\twarn(message);\n\t};\n\tconst preflighted = runProviderFailoverPreflight(config, preflight, warnPreflightOnce);\n\tconst now = deps.now ?? (() => Date.now());\n\t// deps 须在此构建——api 只在工厂内可得。\n\tconst runtimeDeps: ProviderFailoverRuntimeDeps = {\n\t\tconfig: preflighted,\n\t\tnow,\n\t\t...(api.session === undefined ? {} : { session: api.session }),\n\t\t...(logger === undefined ? {} : { hostLogger: logger }),\n\t\thasLifecycleEvent: (type, version) => {\n\t\t\ttry {\n\t\t\t\tapi.lifecycle.get(type, version);\n\t\t\t\treturn true;\n\t\t\t} catch {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t},\n\t\tdispatchLifecycleEvent: (request) => {\n\t\t\t// LifecycleAPI 无 dispatchLifecycle（模块头差异登记）：等价公共面 =\n\t\t\t// api.publish。source 由运行时归属本插件 manifest id；phase 不入\n\t\t\t// EventEnvelope（本插件的可见性事件全部是 committed 相位）；所有派发点\n\t\t\t// 都带 correlationId = chainId，兜底项仅为满足 LifecycleDispatchRequest\n\t\t\t// 的可选键型。\n\t\t\tvoid api\n\t\t\t\t.publish({\n\t\t\t\t\ttype: request.type,\n\t\t\t\t\tversion: request.version,\n\t\t\t\t\tcorrelationId: request.correlationId ?? request.type,\n\t\t\t\t\tdata: request.data,\n\t\t\t\t})\n\t\t\t\t.catch(() => {\n\t\t\t\t\t// 可见性事件失败不打断换道判定（宪法 §8 的尽力通道）。\n\t\t\t\t});\n\t\t},\n\t};\n\tapi.registerStreamFnWrapper(PROVIDER_FAILOVER_WRAPPER_NAME, createFailoverWrapper(runtimeDeps), {\n\t\tpriority: PROVIDER_FAILOVER_WRAPPER_PRIORITY,\n\t});\n\t// 装配期初始快照（status closed）覆盖恢复会话里的陈旧 open 残留：熔断\n\t// 状态不持久化，新进程恒 CLOSED（设计 §4.2/§4.7）。无链上下文 → chainId 空。\n\twriteStateSnapshot(runtimeDeps, {\n\t\tversion: 1,\n\t\tchainId: \"\",\n\t\tstatus: \"closed\",\n\t\tprobeAtMs: 0,\n\t\tnow: runtimeDeps.now(),\n\t});\n}\n\n/**\n * 构建 provider-failover 插件工厂（设计 §4.8 的插件包形态）：\n * `(api: CapabilityAPI) => void`，经公共 `loadCapabilityPlugin`/manifest 通道装载。\n * deps 仅用于测试注入时钟与进程日志；生产入口（entry.ts 默认导出）零参调用。\n */\nexport function createProviderFailoverPluginFactory(\n\tdeps: ProviderFailoverPluginFactoryDeps = {},\n): CapabilityPluginSyncFactory {\n\treturn (api: CapabilityAPI): void => {\n\t\tinstallProviderFailoverIntoApi(api, deps);\n\t};\n}\n"]}

package/bundled-plugins/provider-failover/plugin.json

@@ -0,0 +1,7 @@
+{
+	"id": "agent-forge.plugin.provider-failover",
+	"version": "0.88.1",
+	"apiVersion": "1-draft",
+	"entry": "./dist/entry.js",
+	"hostVersion": ">=0.88.0"
+}

package/bundled-plugins/retry-policy/agent-forge.json

@@ -0,0 +1,19 @@
+{
+	"packageFormatVersion": 1,
+	"id": "agent-forge.plugin.retry-policy",
+	"pluginVersion": "0.88.1",
+	"apiVersion": "1",
+	"minHostVersion": "0.88.0",
+	"platform": {
+		"os": [
+			"windows",
+			"macos",
+			"linux"
+		],
+		"runtime": [
+			{
+				"name": "node"
+			}
+		]
+	}
+}

package/bundled-plugins/retry-policy/dist/entry.d.ts

@@ -0,0 +1,16 @@
+import type { CapabilityAPI } from "@agent-forge/plugin-sdk";
+/** Policy name under the `retry-policy` capability; matches the host's embedded default name. */
+export declare const DEFAULT_RETRY_POLICY_NAME = "default";
+/**
+ * Default-export factory consumed by the host's manifest plugin loader.
+ *
+ * Registers the built-in retry decision (classification and exponential-backoff
+ * logic migrated verbatim from the host's embedded `bootstrap-retry-policy.ts`,
+ * D-082 batch 3) under the fixed default name: rerouting via retryPolicyName
+ * config selects a different policy, while a same-name registration competes by
+ * load order — it is not a replacement mechanism.
+ */
+export default function createRetryPolicyPluginEntry(api: CapabilityAPI): Promise<{
+    dispose: () => void;
+}>;
+//# sourceMappingURL=entry.d.ts.map

package/bundled-plugins/retry-policy/dist/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,iGAAiG;AACjG,eAAO,MAAM,yBAAyB,YAAY,CAAC;AAEnD;;;;;;;;GAQG;AACH,wBAA8B,4BAA4B,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC,CAmB/G","sourcesContent":["import { isRetryableAssistantError } from \"@agent-forge/ai/compat\";\nimport { t } from \"@agent-forge/host/i18n\";\nimport type { CapabilityAPI } from \"@agent-forge/plugin-sdk\";\n\n/** Policy name under the `retry-policy` capability; matches the host's embedded default name. */\nexport const DEFAULT_RETRY_POLICY_NAME = \"default\";\n\n/**\n * Default-export factory consumed by the host's manifest plugin loader.\n *\n * Registers the built-in retry decision (classification and exponential-backoff\n * logic migrated verbatim from the host's embedded `bootstrap-retry-policy.ts`,\n * D-082 batch 3) under the fixed default name: rerouting via retryPolicyName\n * config selects a different policy, while a same-name registration competes by\n * load order — it is not a replacement mechanism.\n */\nexport default async function createRetryPolicyPluginEntry(api: CapabilityAPI): Promise<{ dispose: () => void }> {\n\tconst registration = api.registerRetryPolicy(DEFAULT_RETRY_POLICY_NAME, {\n\t\tclassify: ({ message }) => {\n\t\t\tif (!message || typeof message !== \"object\")\n\t\t\t\tthrow new Error(t(\"Retry classification requires an assistant message object\"));\n\t\t\treturn isRetryableAssistantError(message as Parameters<typeof isRetryableAssistantError>[0]);\n\t\t},\n\t\tdecide: ({ retryable, attempt, maxAttempts, baseDelayMs }) => ({\n\t\t\tretry: retryable && attempt <= maxAttempts,\n\t\t\tdelayMs: baseDelayMs * 2 ** Math.max(0, attempt - 1),\n\t\t}),\n\t});\n\treturn {\n\t\tdispose: () => {\n\t\t\t// Registration disposal in the capability runtime is synchronous;\n\t\t\t// void consumes the declared Promise possibility of the contract.\n\t\t\tvoid registration.dispose();\n\t\t},\n\t};\n}\n"]}

package/bundled-plugins/retry-policy/dist/entry.js

@@ -0,0 +1,34 @@
+import { isRetryableAssistantError } from "@agent-forge/ai/compat";
+import { t } from "@agent-forge/host/i18n";
+/** Policy name under the `retry-policy` capability; matches the host's embedded default name. */
+export const DEFAULT_RETRY_POLICY_NAME = "default";
+/**
+ * Default-export factory consumed by the host's manifest plugin loader.
+ *
+ * Registers the built-in retry decision (classification and exponential-backoff
+ * logic migrated verbatim from the host's embedded `bootstrap-retry-policy.ts`,
+ * D-082 batch 3) under the fixed default name: rerouting via retryPolicyName
+ * config selects a different policy, while a same-name registration competes by
+ * load order — it is not a replacement mechanism.
+ */
+export default async function createRetryPolicyPluginEntry(api) {
+    const registration = api.registerRetryPolicy(DEFAULT_RETRY_POLICY_NAME, {
+        classify: ({ message }) => {
+            if (!message || typeof message !== "object")
+                throw new Error(t("Retry classification requires an assistant message object"));
+            return isRetryableAssistantError(message);
+        },
+        decide: ({ retryable, attempt, maxAttempts, baseDelayMs }) => ({
+            retry: retryable && attempt <= maxAttempts,
+            delayMs: baseDelayMs * 2 ** Math.max(0, attempt - 1),
+        }),
+    });
+    return {
+        dispose: () => {
+            // Registration disposal in the capability runtime is synchronous;
+            // void consumes the declared Promise possibility of the contract.
+            void registration.dispose();
+        },
+    };
+}
+//# sourceMappingURL=entry.js.map

package/bundled-plugins/retry-policy/dist/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAG3C,iGAAiG;AACjG,MAAM,CAAC,MAAM,yBAAyB,GAAG,SAAS,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,4BAA4B,CAAC,GAAkB,EAAoC;IAChH,MAAM,YAAY,GAAG,GAAG,CAAC,mBAAmB,CAAC,yBAAyB,EAAE;QACvE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;gBAC1C,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,2DAA2D,CAAC,CAAC,CAAC;YACjF,OAAO,yBAAyB,CAAC,OAA0D,CAAC,CAAC;QAAA,CAC7F;QACD,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;YAC9D,KAAK,EAAE,SAAS,IAAI,OAAO,IAAI,WAAW;YAC1C,OAAO,EAAE,WAAW,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC;SACpD,CAAC;KACF,CAAC,CAAC;IACH,OAAO;QACN,OAAO,EAAE,GAAG,EAAE,CAAC;YACd,kEAAkE;YAClE,kEAAkE;YAClE,KAAK,YAAY,CAAC,OAAO,EAAE,CAAC;QAAA,CAC5B;KACD,CAAC;AAAA,CACF","sourcesContent":["import { isRetryableAssistantError } from \"@agent-forge/ai/compat\";\nimport { t } from \"@agent-forge/host/i18n\";\nimport type { CapabilityAPI } from \"@agent-forge/plugin-sdk\";\n\n/** Policy name under the `retry-policy` capability; matches the host's embedded default name. */\nexport const DEFAULT_RETRY_POLICY_NAME = \"default\";\n\n/**\n * Default-export factory consumed by the host's manifest plugin loader.\n *\n * Registers the built-in retry decision (classification and exponential-backoff\n * logic migrated verbatim from the host's embedded `bootstrap-retry-policy.ts`,\n * D-082 batch 3) under the fixed default name: rerouting via retryPolicyName\n * config selects a different policy, while a same-name registration competes by\n * load order — it is not a replacement mechanism.\n */\nexport default async function createRetryPolicyPluginEntry(api: CapabilityAPI): Promise<{ dispose: () => void }> {\n\tconst registration = api.registerRetryPolicy(DEFAULT_RETRY_POLICY_NAME, {\n\t\tclassify: ({ message }) => {\n\t\t\tif (!message || typeof message !== \"object\")\n\t\t\t\tthrow new Error(t(\"Retry classification requires an assistant message object\"));\n\t\t\treturn isRetryableAssistantError(message as Parameters<typeof isRetryableAssistantError>[0]);\n\t\t},\n\t\tdecide: ({ retryable, attempt, maxAttempts, baseDelayMs }) => ({\n\t\t\tretry: retryable && attempt <= maxAttempts,\n\t\t\tdelayMs: baseDelayMs * 2 ** Math.max(0, attempt - 1),\n\t\t}),\n\t});\n\treturn {\n\t\tdispose: () => {\n\t\t\t// Registration disposal in the capability runtime is synchronous;\n\t\t\t// void consumes the declared Promise possibility of the contract.\n\t\t\tvoid registration.dispose();\n\t\t},\n\t};\n}\n"]}

package/bundled-plugins/retry-policy/plugin.json

@@ -0,0 +1,10 @@
+{
+	"id": "agent-forge.plugin.retry-policy",
+	"version": "0.88.1",
+	"apiVersion": "1-draft",
+	"entry": "./dist/entry.js",
+	"hostVersion": ">=0.88.0",
+	"requiredCapabilities": [
+		"retry-policy"
+	]
+}