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

package/dist/bundle/chunks/virtual-modules-KZ5DRH7Q.js

@@ -1,2 +0,0 @@
-import { createRequire as __piCreateRequire } from "node:module"; const require = __piCreateRequire(import.meta.url);
-import{build_exports,dist_exports,require_undici,session_lineage_exports,subagent_exports,value_exports2 as value_exports}from"./chunk-6ZKDNZHA.js";import{__toESM}from"./chunk-4L3WN2XY.js";var undici=__toESM(require_undici(),1),VIRTUAL_MODULES={"@agent-forge/plugin-sdk":dist_exports,"@agent-forge/plugin-sdk/session-lineage":session_lineage_exports,"@agent-forge/protocol/subagent":subagent_exports,typebox:build_exports,"typebox/value":value_exports,undici};export{VIRTUAL_MODULES};

package/dist/core/extensions/bootstrap-branch-summary-policy.d.ts

@@ -1,7 +0,0 @@
-import { type CapabilityPluginHandle } from "./capability-plugin.ts";
-import type { CapabilityRuntime } from "./capability-runtime.ts";
-export declare const BOOTSTRAP_BRANCH_SUMMARY_PLUGIN_ID = "agent-forge.bootstrap-branch-summary";
-export declare const DEFAULT_BRANCH_SUMMARY_POLICY_NAME = "default";
-/** First-party adapter that keeps the legacy branch summarizer replaceable. */
-export declare function installBootstrapBranchSummaryPolicy(runtime: CapabilityRuntime): CapabilityPluginHandle;
-//# sourceMappingURL=bootstrap-branch-summary-policy.d.ts.map

package/dist/core/extensions/bootstrap-branch-summary-policy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bootstrap-branch-summary-policy.d.ts","sourceRoot":"","sources":["../../../src/core/extensions/bootstrap-branch-summary-policy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,sBAAsB,EAA4B,MAAM,wBAAwB,CAAC;AAC/F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGjE,eAAO,MAAM,kCAAkC,yCAAyC,CAAC;AACzF,eAAO,MAAM,kCAAkC,YAAY,CAAC;AAE5D,+EAA+E;AAC/E,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,iBAAiB,GAAG,sBAAsB,CAwBtG","sourcesContent":["import { generateBranchSummary } from \"../compaction/branch-summarization.ts\";\nimport { type CapabilityPluginHandle, loadCapabilityPluginSync } from \"./capability-plugin.ts\";\nimport type { CapabilityRuntime } from \"./capability-runtime.ts\";\nimport { type BranchSummaryRequest, EXPERIMENTAL_PUBLIC_API_VERSION } from \"./public-api.ts\";\n\nexport const BOOTSTRAP_BRANCH_SUMMARY_PLUGIN_ID = \"agent-forge.bootstrap-branch-summary\";\nexport const DEFAULT_BRANCH_SUMMARY_POLICY_NAME = \"default\";\n\n/** First-party adapter that keeps the legacy branch summarizer replaceable. */\nexport function installBootstrapBranchSummaryPolicy(runtime: CapabilityRuntime): CapabilityPluginHandle {\n\treturn loadCapabilityPluginSync(\n\t\truntime,\n\t\t{\n\t\t\tid: BOOTSTRAP_BRANCH_SUMMARY_PLUGIN_ID,\n\t\t\tversion: \"1.0.0\",\n\t\t\tapiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,\n\t\t\tentry: \"<bootstrap>\",\n\t\t},\n\t\t(api) => {\n\t\t\tapi.registerBranchSummaryPolicy(DEFAULT_BRANCH_SUMMARY_POLICY_NAME, {\n\t\t\t\tasync summarize(request: BranchSummaryRequest) {\n\t\t\t\t\treturn generateBranchSummary(request.entries as Parameters<typeof generateBranchSummary>[0], {\n\t\t\t\t\t\tinvocation: request.invocation,\n\t\t\t\t\t\tmodel: request.model,\n\t\t\t\t\t\tsignal: request.signal,\n\t\t\t\t\t\tcustomInstructions: request.customInstructions,\n\t\t\t\t\t\treplaceInstructions: request.replaceInstructions,\n\t\t\t\t\t\treserveTokens: request.reserveTokens,\n\t\t\t\t\t});\n\t\t\t\t},\n\t\t\t});\n\t\t},\n\t);\n}\n"]}

package/dist/core/extensions/bootstrap-branch-summary-policy.js

@@ -1,28 +0,0 @@
-import { generateBranchSummary } from "../compaction/branch-summarization.js";
-import { loadCapabilityPluginSync } from "./capability-plugin.js";
-import { EXPERIMENTAL_PUBLIC_API_VERSION } from "./public-api.js";
-export const BOOTSTRAP_BRANCH_SUMMARY_PLUGIN_ID = "agent-forge.bootstrap-branch-summary";
-export const DEFAULT_BRANCH_SUMMARY_POLICY_NAME = "default";
-/** First-party adapter that keeps the legacy branch summarizer replaceable. */
-export function installBootstrapBranchSummaryPolicy(runtime) {
-    return loadCapabilityPluginSync(runtime, {
-        id: BOOTSTRAP_BRANCH_SUMMARY_PLUGIN_ID,
-        version: "1.0.0",
-        apiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,
-        entry: "<bootstrap>",
-    }, (api) => {
-        api.registerBranchSummaryPolicy(DEFAULT_BRANCH_SUMMARY_POLICY_NAME, {
-            async summarize(request) {
-                return generateBranchSummary(request.entries, {
-                    invocation: request.invocation,
-                    model: request.model,
-                    signal: request.signal,
-                    customInstructions: request.customInstructions,
-                    replaceInstructions: request.replaceInstructions,
-                    reserveTokens: request.reserveTokens,
-                });
-            },
-        });
-    });
-}
-//# sourceMappingURL=bootstrap-branch-summary-policy.js.map

package/dist/core/extensions/bootstrap-branch-summary-policy.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bootstrap-branch-summary-policy.js","sourceRoot":"","sources":["../../../src/core/extensions/bootstrap-branch-summary-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAA+B,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAE/F,OAAO,EAA6B,+BAA+B,EAAE,MAAM,iBAAiB,CAAC;AAE7F,MAAM,CAAC,MAAM,kCAAkC,GAAG,sCAAsC,CAAC;AACzF,MAAM,CAAC,MAAM,kCAAkC,GAAG,SAAS,CAAC;AAE5D,+EAA+E;AAC/E,MAAM,UAAU,mCAAmC,CAAC,OAA0B,EAA0B;IACvG,OAAO,wBAAwB,CAC9B,OAAO,EACP;QACC,EAAE,EAAE,kCAAkC;QACtC,OAAO,EAAE,OAAO;QAChB,UAAU,EAAE,+BAA+B;QAC3C,KAAK,EAAE,aAAa;KACpB,EACD,CAAC,GAAG,EAAE,EAAE,CAAC;QACR,GAAG,CAAC,2BAA2B,CAAC,kCAAkC,EAAE;YACnE,KAAK,CAAC,SAAS,CAAC,OAA6B,EAAE;gBAC9C,OAAO,qBAAqB,CAAC,OAAO,CAAC,OAAsD,EAAE;oBAC5F,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;oBAC9C,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;oBAChD,aAAa,EAAE,OAAO,CAAC,aAAa;iBACpC,CAAC,CAAC;YAAA,CACH;SACD,CAAC,CAAC;IAAA,CACH,CACD,CAAC;AAAA,CACF","sourcesContent":["import { generateBranchSummary } from \"../compaction/branch-summarization.ts\";\nimport { type CapabilityPluginHandle, loadCapabilityPluginSync } from \"./capability-plugin.ts\";\nimport type { CapabilityRuntime } from \"./capability-runtime.ts\";\nimport { type BranchSummaryRequest, EXPERIMENTAL_PUBLIC_API_VERSION } from \"./public-api.ts\";\n\nexport const BOOTSTRAP_BRANCH_SUMMARY_PLUGIN_ID = \"agent-forge.bootstrap-branch-summary\";\nexport const DEFAULT_BRANCH_SUMMARY_POLICY_NAME = \"default\";\n\n/** First-party adapter that keeps the legacy branch summarizer replaceable. */\nexport function installBootstrapBranchSummaryPolicy(runtime: CapabilityRuntime): CapabilityPluginHandle {\n\treturn loadCapabilityPluginSync(\n\t\truntime,\n\t\t{\n\t\t\tid: BOOTSTRAP_BRANCH_SUMMARY_PLUGIN_ID,\n\t\t\tversion: \"1.0.0\",\n\t\t\tapiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,\n\t\t\tentry: \"<bootstrap>\",\n\t\t},\n\t\t(api) => {\n\t\t\tapi.registerBranchSummaryPolicy(DEFAULT_BRANCH_SUMMARY_POLICY_NAME, {\n\t\t\t\tasync summarize(request: BranchSummaryRequest) {\n\t\t\t\t\treturn generateBranchSummary(request.entries as Parameters<typeof generateBranchSummary>[0], {\n\t\t\t\t\t\tinvocation: request.invocation,\n\t\t\t\t\t\tmodel: request.model,\n\t\t\t\t\t\tsignal: request.signal,\n\t\t\t\t\t\tcustomInstructions: request.customInstructions,\n\t\t\t\t\t\treplaceInstructions: request.replaceInstructions,\n\t\t\t\t\t\treserveTokens: request.reserveTokens,\n\t\t\t\t\t});\n\t\t\t\t},\n\t\t\t});\n\t\t},\n\t);\n}\n"]}

package/dist/core/extensions/bootstrap-compaction-policy.d.ts

@@ -1,7 +0,0 @@
-import { type CapabilityPluginHandle } from "./capability-plugin.ts";
-import type { CapabilityRuntime } from "./capability-runtime.ts";
-export declare const BOOTSTRAP_COMPACTION_PLUGIN_ID = "agent-forge.bootstrap-compaction";
-export declare const DEFAULT_COMPACTION_POLICY_NAME = "default";
-/** Register the current automatic-compaction decision as a replaceable first-party policy. */
-export declare function installBootstrapCompactionPolicy(runtime: CapabilityRuntime): CapabilityPluginHandle;
-//# sourceMappingURL=bootstrap-compaction-policy.d.ts.map

package/dist/core/extensions/bootstrap-compaction-policy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bootstrap-compaction-policy.d.ts","sourceRoot":"","sources":["../../../src/core/extensions/bootstrap-compaction-policy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,sBAAsB,EAA4B,MAAM,wBAAwB,CAAC;AAC/F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAIjE,eAAO,MAAM,8BAA8B,qCAAqC,CAAC;AACjF,eAAO,MAAM,8BAA8B,YAAY,CAAC;AAExD,8FAA8F;AAC9F,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,iBAAiB,GAAG,sBAAsB,CAkDnG","sourcesContent":["import { type CompactionPreparation, compact, prepareCompaction } from \"../compaction/index.ts\";\nimport { type CapabilityPluginHandle, loadCapabilityPluginSync } from \"./capability-plugin.ts\";\nimport type { CapabilityRuntime } from \"./capability-runtime.ts\";\nimport type { CompactionSummaryRequest } from \"./public-api.ts\";\nimport { EXPERIMENTAL_PUBLIC_API_VERSION } from \"./public-api.ts\";\n\nexport const BOOTSTRAP_COMPACTION_PLUGIN_ID = \"agent-forge.bootstrap-compaction\";\nexport const DEFAULT_COMPACTION_POLICY_NAME = \"default\";\n\n/** Register the current automatic-compaction decision as a replaceable first-party policy. */\nexport function installBootstrapCompactionPolicy(runtime: CapabilityRuntime): CapabilityPluginHandle {\n\treturn loadCapabilityPluginSync(\n\t\truntime,\n\t\t{\n\t\t\tid: BOOTSTRAP_COMPACTION_PLUGIN_ID,\n\t\t\tversion: \"0.0.0\",\n\t\t\tapiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,\n\t\t\tentry: \"<embedded:bootstrap-compaction>\",\n\t\t\trequiredCapabilities: [\"compaction-policy\"],\n\t\t},\n\t\t(api) => {\n\t\t\tapi.registerCompactionPolicy(DEFAULT_COMPACTION_POLICY_NAME, {\n\t\t\t\tprepare: (request) =>\n\t\t\t\t\tprepareCompaction(\n\t\t\t\t\t\trequest.entries as Parameters<typeof prepareCompaction>[0],\n\t\t\t\t\t\trequest.settings as Parameters<typeof prepareCompaction>[1],\n\t\t\t\t\t),\n\t\t\t\tdecide: (request) => {\n\t\t\t\t\tif (request.reason === \"threshold\") {\n\t\t\t\t\t\tconst usage = request.contextUsage;\n\t\t\t\t\t\tconst overBudget =\n\t\t\t\t\t\t\tusage !== undefined &&\n\t\t\t\t\t\t\tusage.contextWindow > 0 &&\n\t\t\t\t\t\t\tusage.contextTokens > usage.contextWindow - usage.reserveTokens;\n\t\t\t\t\t\treturn { compact: overBudget, retry: false };\n\t\t\t\t\t}\n\t\t\t\t\tif (request.recoveryAttempted) {\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tcompact: false,\n\t\t\t\t\t\t\tfailureMessage: request.contextOverflow\n\t\t\t\t\t\t\t\t? \"Context overflow recovery failed after one compact-and-retry attempt. Try reducing context or switching to a larger-context model.\"\n\t\t\t\t\t\t\t\t: \"Truncated response recovery failed after one compact-and-retry attempt.\",\n\t\t\t\t\t\t};\n\t\t\t\t\t}\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcompact: request.contextOverflow || request.recoverableLength,\n\t\t\t\t\t\tretry: request.canContinue,\n\t\t\t\t\t};\n\t\t\t\t},\n\t\t\t\tsummarize: async (request: CompactionSummaryRequest) =>\n\t\t\t\t\tcompact(request.preparation as CompactionPreparation, {\n\t\t\t\t\t\tinvocation: request.invocation,\n\t\t\t\t\t\tmodel: request.model,\n\t\t\t\t\t\tcustomInstructions: request.customInstructions,\n\t\t\t\t\t\tthinkingLevel: request.thinkingLevel,\n\t\t\t\t\t\tsignal: request.signal,\n\t\t\t\t\t}),\n\t\t\t});\n\t\t},\n\t);\n}\n"]}

package/dist/core/extensions/bootstrap-compaction-policy.js

@@ -1,48 +0,0 @@
-import { compact, prepareCompaction } from "../compaction/index.js";
-import { loadCapabilityPluginSync } from "./capability-plugin.js";
-import { EXPERIMENTAL_PUBLIC_API_VERSION } from "./public-api.js";
-export const BOOTSTRAP_COMPACTION_PLUGIN_ID = "agent-forge.bootstrap-compaction";
-export const DEFAULT_COMPACTION_POLICY_NAME = "default";
-/** Register the current automatic-compaction decision as a replaceable first-party policy. */
-export function installBootstrapCompactionPolicy(runtime) {
-    return loadCapabilityPluginSync(runtime, {
-        id: BOOTSTRAP_COMPACTION_PLUGIN_ID,
-        version: "0.0.0",
-        apiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,
-        entry: "<embedded:bootstrap-compaction>",
-        requiredCapabilities: ["compaction-policy"],
-    }, (api) => {
-        api.registerCompactionPolicy(DEFAULT_COMPACTION_POLICY_NAME, {
-            prepare: (request) => prepareCompaction(request.entries, request.settings),
-            decide: (request) => {
-                if (request.reason === "threshold") {
-                    const usage = request.contextUsage;
-                    const overBudget = usage !== undefined &&
-                        usage.contextWindow > 0 &&
-                        usage.contextTokens > usage.contextWindow - usage.reserveTokens;
-                    return { compact: overBudget, retry: false };
-                }
-                if (request.recoveryAttempted) {
-                    return {
-                        compact: false,
-                        failureMessage: request.contextOverflow
-                            ? "Context overflow recovery failed after one compact-and-retry attempt. Try reducing context or switching to a larger-context model."
-                            : "Truncated response recovery failed after one compact-and-retry attempt.",
-                    };
-                }
-                return {
-                    compact: request.contextOverflow || request.recoverableLength,
-                    retry: request.canContinue,
-                };
-            },
-            summarize: async (request) => compact(request.preparation, {
-                invocation: request.invocation,
-                model: request.model,
-                customInstructions: request.customInstructions,
-                thinkingLevel: request.thinkingLevel,
-                signal: request.signal,
-            }),
-        });
-    });
-}
-//# sourceMappingURL=bootstrap-compaction-policy.js.map

package/dist/core/extensions/bootstrap-compaction-policy.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bootstrap-compaction-policy.js","sourceRoot":"","sources":["../../../src/core/extensions/bootstrap-compaction-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,EAA+B,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAG/F,OAAO,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAC;AAElE,MAAM,CAAC,MAAM,8BAA8B,GAAG,kCAAkC,CAAC;AACjF,MAAM,CAAC,MAAM,8BAA8B,GAAG,SAAS,CAAC;AAExD,8FAA8F;AAC9F,MAAM,UAAU,gCAAgC,CAAC,OAA0B,EAA0B;IACpG,OAAO,wBAAwB,CAC9B,OAAO,EACP;QACC,EAAE,EAAE,8BAA8B;QAClC,OAAO,EAAE,OAAO;QAChB,UAAU,EAAE,+BAA+B;QAC3C,KAAK,EAAE,iCAAiC;QACxC,oBAAoB,EAAE,CAAC,mBAAmB,CAAC;KAC3C,EACD,CAAC,GAAG,EAAE,EAAE,CAAC;QACR,GAAG,CAAC,wBAAwB,CAAC,8BAA8B,EAAE;YAC5D,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CACpB,iBAAiB,CAChB,OAAO,CAAC,OAAkD,EAC1D,OAAO,CAAC,QAAmD,CAC3D;YACF,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;gBACpB,IAAI,OAAO,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;oBACpC,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC;oBACnC,MAAM,UAAU,GACf,KAAK,KAAK,SAAS;wBACnB,KAAK,CAAC,aAAa,GAAG,CAAC;wBACvB,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;oBACjE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;gBAC9C,CAAC;gBACD,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;oBAC/B,OAAO;wBACN,OAAO,EAAE,KAAK;wBACd,cAAc,EAAE,OAAO,CAAC,eAAe;4BACtC,CAAC,CAAC,oIAAoI;4BACtI,CAAC,CAAC,yEAAyE;qBAC5E,CAAC;gBACH,CAAC;gBACD,OAAO;oBACN,OAAO,EAAE,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,iBAAiB;oBAC7D,KAAK,EAAE,OAAO,CAAC,WAAW;iBAC1B,CAAC;YAAA,CACF;YACD,SAAS,EAAE,KAAK,EAAE,OAAiC,EAAE,EAAE,CACtD,OAAO,CAAC,OAAO,CAAC,WAAoC,EAAE;gBACrD,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;gBAC9C,aAAa,EAAE,OAAO,CAAC,aAAa;gBACpC,MAAM,EAAE,OAAO,CAAC,MAAM;aACtB,CAAC;SACH,CAAC,CAAC;IAAA,CACH,CACD,CAAC;AAAA,CACF","sourcesContent":["import { type CompactionPreparation, compact, prepareCompaction } from \"../compaction/index.ts\";\nimport { type CapabilityPluginHandle, loadCapabilityPluginSync } from \"./capability-plugin.ts\";\nimport type { CapabilityRuntime } from \"./capability-runtime.ts\";\nimport type { CompactionSummaryRequest } from \"./public-api.ts\";\nimport { EXPERIMENTAL_PUBLIC_API_VERSION } from \"./public-api.ts\";\n\nexport const BOOTSTRAP_COMPACTION_PLUGIN_ID = \"agent-forge.bootstrap-compaction\";\nexport const DEFAULT_COMPACTION_POLICY_NAME = \"default\";\n\n/** Register the current automatic-compaction decision as a replaceable first-party policy. */\nexport function installBootstrapCompactionPolicy(runtime: CapabilityRuntime): CapabilityPluginHandle {\n\treturn loadCapabilityPluginSync(\n\t\truntime,\n\t\t{\n\t\t\tid: BOOTSTRAP_COMPACTION_PLUGIN_ID,\n\t\t\tversion: \"0.0.0\",\n\t\t\tapiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,\n\t\t\tentry: \"<embedded:bootstrap-compaction>\",\n\t\t\trequiredCapabilities: [\"compaction-policy\"],\n\t\t},\n\t\t(api) => {\n\t\t\tapi.registerCompactionPolicy(DEFAULT_COMPACTION_POLICY_NAME, {\n\t\t\t\tprepare: (request) =>\n\t\t\t\t\tprepareCompaction(\n\t\t\t\t\t\trequest.entries as Parameters<typeof prepareCompaction>[0],\n\t\t\t\t\t\trequest.settings as Parameters<typeof prepareCompaction>[1],\n\t\t\t\t\t),\n\t\t\t\tdecide: (request) => {\n\t\t\t\t\tif (request.reason === \"threshold\") {\n\t\t\t\t\t\tconst usage = request.contextUsage;\n\t\t\t\t\t\tconst overBudget =\n\t\t\t\t\t\t\tusage !== undefined &&\n\t\t\t\t\t\t\tusage.contextWindow > 0 &&\n\t\t\t\t\t\t\tusage.contextTokens > usage.contextWindow - usage.reserveTokens;\n\t\t\t\t\t\treturn { compact: overBudget, retry: false };\n\t\t\t\t\t}\n\t\t\t\t\tif (request.recoveryAttempted) {\n\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\tcompact: false,\n\t\t\t\t\t\t\tfailureMessage: request.contextOverflow\n\t\t\t\t\t\t\t\t? \"Context overflow recovery failed after one compact-and-retry attempt. Try reducing context or switching to a larger-context model.\"\n\t\t\t\t\t\t\t\t: \"Truncated response recovery failed after one compact-and-retry attempt.\",\n\t\t\t\t\t\t};\n\t\t\t\t\t}\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcompact: request.contextOverflow || request.recoverableLength,\n\t\t\t\t\t\tretry: request.canContinue,\n\t\t\t\t\t};\n\t\t\t\t},\n\t\t\t\tsummarize: async (request: CompactionSummaryRequest) =>\n\t\t\t\t\tcompact(request.preparation as CompactionPreparation, {\n\t\t\t\t\t\tinvocation: request.invocation,\n\t\t\t\t\t\tmodel: request.model,\n\t\t\t\t\t\tcustomInstructions: request.customInstructions,\n\t\t\t\t\t\tthinkingLevel: request.thinkingLevel,\n\t\t\t\t\t\tsignal: request.signal,\n\t\t\t\t\t}),\n\t\t\t});\n\t\t},\n\t);\n}\n"]}

package/dist/core/extensions/bootstrap-overflow-policy.d.ts

@@ -1,7 +0,0 @@
-import { type CapabilityPluginHandle } from "./capability-plugin.ts";
-import type { CapabilityRuntime } from "./capability-runtime.ts";
-export declare const BOOTSTRAP_OVERFLOW_PLUGIN_ID = "agent-forge.bootstrap-overflow";
-export declare const DEFAULT_OVERFLOW_POLICY_NAME = "default";
-/** Register the current provider classification as a replaceable first-party policy. */
-export declare function installBootstrapOverflowPolicy(runtime: CapabilityRuntime): CapabilityPluginHandle;
-//# sourceMappingURL=bootstrap-overflow-policy.d.ts.map

package/dist/core/extensions/bootstrap-overflow-policy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bootstrap-overflow-policy.d.ts","sourceRoot":"","sources":["../../../src/core/extensions/bootstrap-overflow-policy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,sBAAsB,EAA4B,MAAM,wBAAwB,CAAC;AAC/F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAIjE,eAAO,MAAM,4BAA4B,mCAAmC,CAAC;AAC7E,eAAO,MAAM,4BAA4B,YAAY,CAAC;AAEtD,wFAAwF;AACxF,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,iBAAiB,GAAG,sBAAsB,CAyBjG","sourcesContent":["import { type AssistantMessage, isContextOverflow, isRecoverableLength } from \"@agent-forge/ai/compat\";\nimport { t } from \"../i18n/index.ts\";\nimport { type CapabilityPluginHandle, loadCapabilityPluginSync } from \"./capability-plugin.ts\";\nimport type { CapabilityRuntime } from \"./capability-runtime.ts\";\nimport type { OverflowPolicyRequest } from \"./public-api.ts\";\nimport { EXPERIMENTAL_PUBLIC_API_VERSION } from \"./public-api.ts\";\n\nexport const BOOTSTRAP_OVERFLOW_PLUGIN_ID = \"agent-forge.bootstrap-overflow\";\nexport const DEFAULT_OVERFLOW_POLICY_NAME = \"default\";\n\n/** Register the current provider classification as a replaceable first-party policy. */\nexport function installBootstrapOverflowPolicy(runtime: CapabilityRuntime): CapabilityPluginHandle {\n\treturn loadCapabilityPluginSync(\n\t\truntime,\n\t\t{\n\t\t\tid: BOOTSTRAP_OVERFLOW_PLUGIN_ID,\n\t\t\tversion: \"0.0.0\",\n\t\t\tapiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,\n\t\t\tentry: \"<embedded:bootstrap-overflow>\",\n\t\t\trequiredCapabilities: [\"overflow-policy\"],\n\t\t},\n\t\t(api) => {\n\t\t\tapi.registerOverflowPolicy(DEFAULT_OVERFLOW_POLICY_NAME, {\n\t\t\t\tdecide: (request: OverflowPolicyRequest) => {\n\t\t\t\t\tif (!request.message || typeof request.message !== \"object\") {\n\t\t\t\t\t\tthrow new Error(t(\"Overflow policy requires an assistant message object\"));\n\t\t\t\t\t}\n\t\t\t\t\tconst message = request.message as AssistantMessage;\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontextOverflow: isContextOverflow(message, request.contextWindow),\n\t\t\t\t\t\trecoverableLength: isRecoverableLength(message, request.desiredMaxOutput),\n\t\t\t\t\t};\n\t\t\t\t},\n\t\t\t});\n\t\t},\n\t);\n}\n"]}

package/dist/core/extensions/bootstrap-overflow-policy.js

@@ -1,30 +0,0 @@
-import { isContextOverflow, isRecoverableLength } from "@agent-forge/ai/compat";
-import { t } from "../i18n/index.js";
-import { loadCapabilityPluginSync } from "./capability-plugin.js";
-import { EXPERIMENTAL_PUBLIC_API_VERSION } from "./public-api.js";
-export const BOOTSTRAP_OVERFLOW_PLUGIN_ID = "agent-forge.bootstrap-overflow";
-export const DEFAULT_OVERFLOW_POLICY_NAME = "default";
-/** Register the current provider classification as a replaceable first-party policy. */
-export function installBootstrapOverflowPolicy(runtime) {
-    return loadCapabilityPluginSync(runtime, {
-        id: BOOTSTRAP_OVERFLOW_PLUGIN_ID,
-        version: "0.0.0",
-        apiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,
-        entry: "<embedded:bootstrap-overflow>",
-        requiredCapabilities: ["overflow-policy"],
-    }, (api) => {
-        api.registerOverflowPolicy(DEFAULT_OVERFLOW_POLICY_NAME, {
-            decide: (request) => {
-                if (!request.message || typeof request.message !== "object") {
-                    throw new Error(t("Overflow policy requires an assistant message object"));
-                }
-                const message = request.message;
-                return {
-                    contextOverflow: isContextOverflow(message, request.contextWindow),
-                    recoverableLength: isRecoverableLength(message, request.desiredMaxOutput),
-                };
-            },
-        });
-    });
-}
-//# sourceMappingURL=bootstrap-overflow-policy.js.map

package/dist/core/extensions/bootstrap-overflow-policy.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bootstrap-overflow-policy.js","sourceRoot":"","sources":["../../../src/core/extensions/bootstrap-overflow-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACvG,OAAO,EAAE,CAAC,EAAE,MAAM,kBAAkB,CAAC;AACrC,OAAO,EAA+B,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAG/F,OAAO,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAC;AAElE,MAAM,CAAC,MAAM,4BAA4B,GAAG,gCAAgC,CAAC;AAC7E,MAAM,CAAC,MAAM,4BAA4B,GAAG,SAAS,CAAC;AAEtD,wFAAwF;AACxF,MAAM,UAAU,8BAA8B,CAAC,OAA0B,EAA0B;IAClG,OAAO,wBAAwB,CAC9B,OAAO,EACP;QACC,EAAE,EAAE,4BAA4B;QAChC,OAAO,EAAE,OAAO;QAChB,UAAU,EAAE,+BAA+B;QAC3C,KAAK,EAAE,+BAA+B;QACtC,oBAAoB,EAAE,CAAC,iBAAiB,CAAC;KACzC,EACD,CAAC,GAAG,EAAE,EAAE,CAAC;QACR,GAAG,CAAC,sBAAsB,CAAC,4BAA4B,EAAE;YACxD,MAAM,EAAE,CAAC,OAA8B,EAAE,EAAE,CAAC;gBAC3C,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;oBAC7D,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,sDAAsD,CAAC,CAAC,CAAC;gBAC5E,CAAC;gBACD,MAAM,OAAO,GAAG,OAAO,CAAC,OAA2B,CAAC;gBACpD,OAAO;oBACN,eAAe,EAAE,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC;oBAClE,iBAAiB,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC;iBACzE,CAAC;YAAA,CACF;SACD,CAAC,CAAC;IAAA,CACH,CACD,CAAC;AAAA,CACF","sourcesContent":["import { type AssistantMessage, isContextOverflow, isRecoverableLength } from \"@agent-forge/ai/compat\";\nimport { t } from \"../i18n/index.ts\";\nimport { type CapabilityPluginHandle, loadCapabilityPluginSync } from \"./capability-plugin.ts\";\nimport type { CapabilityRuntime } from \"./capability-runtime.ts\";\nimport type { OverflowPolicyRequest } from \"./public-api.ts\";\nimport { EXPERIMENTAL_PUBLIC_API_VERSION } from \"./public-api.ts\";\n\nexport const BOOTSTRAP_OVERFLOW_PLUGIN_ID = \"agent-forge.bootstrap-overflow\";\nexport const DEFAULT_OVERFLOW_POLICY_NAME = \"default\";\n\n/** Register the current provider classification as a replaceable first-party policy. */\nexport function installBootstrapOverflowPolicy(runtime: CapabilityRuntime): CapabilityPluginHandle {\n\treturn loadCapabilityPluginSync(\n\t\truntime,\n\t\t{\n\t\t\tid: BOOTSTRAP_OVERFLOW_PLUGIN_ID,\n\t\t\tversion: \"0.0.0\",\n\t\t\tapiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,\n\t\t\tentry: \"<embedded:bootstrap-overflow>\",\n\t\t\trequiredCapabilities: [\"overflow-policy\"],\n\t\t},\n\t\t(api) => {\n\t\t\tapi.registerOverflowPolicy(DEFAULT_OVERFLOW_POLICY_NAME, {\n\t\t\t\tdecide: (request: OverflowPolicyRequest) => {\n\t\t\t\t\tif (!request.message || typeof request.message !== \"object\") {\n\t\t\t\t\t\tthrow new Error(t(\"Overflow policy requires an assistant message object\"));\n\t\t\t\t\t}\n\t\t\t\t\tconst message = request.message as AssistantMessage;\n\t\t\t\t\treturn {\n\t\t\t\t\t\tcontextOverflow: isContextOverflow(message, request.contextWindow),\n\t\t\t\t\t\trecoverableLength: isRecoverableLength(message, request.desiredMaxOutput),\n\t\t\t\t\t};\n\t\t\t\t},\n\t\t\t});\n\t\t},\n\t);\n}\n"]}

package/dist/core/extensions/bootstrap-retry-policy.d.ts

@@ -1,7 +0,0 @@
-import { type CapabilityPluginHandle } from "./capability-plugin.ts";
-import type { CapabilityRuntime } from "./capability-runtime.ts";
-export declare const BOOTSTRAP_RETRY_PLUGIN_ID = "agent-forge.bootstrap-retry";
-export declare const DEFAULT_RETRY_POLICY_NAME = "default";
-/** Register the built-in retry decision as a replaceable first-party policy. */
-export declare function installBootstrapRetryPolicy(runtime: CapabilityRuntime): CapabilityPluginHandle;
-//# sourceMappingURL=bootstrap-retry-policy.d.ts.map

package/dist/core/extensions/bootstrap-retry-policy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bootstrap-retry-policy.d.ts","sourceRoot":"","sources":["../../../src/core/extensions/bootstrap-retry-policy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,sBAAsB,EAA4B,MAAM,wBAAwB,CAAC;AAC/F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGjE,eAAO,MAAM,yBAAyB,gCAAgC,CAAC;AACvE,eAAO,MAAM,yBAAyB,YAAY,CAAC;AAEnD,gFAAgF;AAChF,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,iBAAiB,GAAG,sBAAsB,CAwB9F","sourcesContent":["import { isRetryableAssistantError } from \"@agent-forge/ai/compat\";\nimport { t } from \"../i18n/index.ts\";\nimport { type CapabilityPluginHandle, loadCapabilityPluginSync } from \"./capability-plugin.ts\";\nimport type { CapabilityRuntime } from \"./capability-runtime.ts\";\nimport { EXPERIMENTAL_PUBLIC_API_VERSION } from \"./public-api.ts\";\n\nexport const BOOTSTRAP_RETRY_PLUGIN_ID = \"agent-forge.bootstrap-retry\";\nexport const DEFAULT_RETRY_POLICY_NAME = \"default\";\n\n/** Register the built-in retry decision as a replaceable first-party policy. */\nexport function installBootstrapRetryPolicy(runtime: CapabilityRuntime): CapabilityPluginHandle {\n\treturn loadCapabilityPluginSync(\n\t\truntime,\n\t\t{\n\t\t\tid: BOOTSTRAP_RETRY_PLUGIN_ID,\n\t\t\tversion: \"0.0.0\",\n\t\t\tapiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,\n\t\t\tentry: \"<embedded:bootstrap-retry>\",\n\t\t\trequiredCapabilities: [\"retry-policy\"],\n\t\t},\n\t\t(api) => {\n\t\t\tapi.registerRetryPolicy(DEFAULT_RETRY_POLICY_NAME, {\n\t\t\t\tclassify: ({ message }) => {\n\t\t\t\t\tif (!message || typeof message !== \"object\")\n\t\t\t\t\t\tthrow new Error(t(\"Retry classification requires an assistant message object\"));\n\t\t\t\t\treturn isRetryableAssistantError(message as Parameters<typeof isRetryableAssistantError>[0]);\n\t\t\t\t},\n\t\t\t\tdecide: ({ retryable, attempt, maxAttempts, baseDelayMs }) => ({\n\t\t\t\t\tretry: retryable && attempt <= maxAttempts,\n\t\t\t\t\tdelayMs: baseDelayMs * 2 ** Math.max(0, attempt - 1),\n\t\t\t\t}),\n\t\t\t});\n\t\t},\n\t);\n}\n"]}

package/dist/core/extensions/bootstrap-retry-policy.js

@@ -1,29 +0,0 @@
-import { isRetryableAssistantError } from "@agent-forge/ai/compat";
-import { t } from "../i18n/index.js";
-import { loadCapabilityPluginSync } from "./capability-plugin.js";
-import { EXPERIMENTAL_PUBLIC_API_VERSION } from "./public-api.js";
-export const BOOTSTRAP_RETRY_PLUGIN_ID = "agent-forge.bootstrap-retry";
-export const DEFAULT_RETRY_POLICY_NAME = "default";
-/** Register the built-in retry decision as a replaceable first-party policy. */
-export function installBootstrapRetryPolicy(runtime) {
-    return loadCapabilityPluginSync(runtime, {
-        id: BOOTSTRAP_RETRY_PLUGIN_ID,
-        version: "0.0.0",
-        apiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,
-        entry: "<embedded:bootstrap-retry>",
-        requiredCapabilities: ["retry-policy"],
-    }, (api) => {
-        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),
-            }),
-        });
-    });
-}
-//# sourceMappingURL=bootstrap-retry-policy.js.map

package/dist/core/extensions/bootstrap-retry-policy.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bootstrap-retry-policy.js","sourceRoot":"","sources":["../../../src/core/extensions/bootstrap-retry-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,CAAC,EAAE,MAAM,kBAAkB,CAAC;AACrC,OAAO,EAA+B,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAE/F,OAAO,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAC;AAElE,MAAM,CAAC,MAAM,yBAAyB,GAAG,6BAA6B,CAAC;AACvE,MAAM,CAAC,MAAM,yBAAyB,GAAG,SAAS,CAAC;AAEnD,gFAAgF;AAChF,MAAM,UAAU,2BAA2B,CAAC,OAA0B,EAA0B;IAC/F,OAAO,wBAAwB,CAC9B,OAAO,EACP;QACC,EAAE,EAAE,yBAAyB;QAC7B,OAAO,EAAE,OAAO;QAChB,UAAU,EAAE,+BAA+B;QAC3C,KAAK,EAAE,4BAA4B;QACnC,oBAAoB,EAAE,CAAC,cAAc,CAAC;KACtC,EACD,CAAC,GAAG,EAAE,EAAE,CAAC;QACR,GAAG,CAAC,mBAAmB,CAAC,yBAAyB,EAAE;YAClD,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;gBAC1B,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;oBAC1C,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,2DAA2D,CAAC,CAAC,CAAC;gBACjF,OAAO,yBAAyB,CAAC,OAA0D,CAAC,CAAC;YAAA,CAC7F;YACD,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC9D,KAAK,EAAE,SAAS,IAAI,OAAO,IAAI,WAAW;gBAC1C,OAAO,EAAE,WAAW,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC;aACpD,CAAC;SACF,CAAC,CAAC;IAAA,CACH,CACD,CAAC;AAAA,CACF","sourcesContent":["import { isRetryableAssistantError } from \"@agent-forge/ai/compat\";\nimport { t } from \"../i18n/index.ts\";\nimport { type CapabilityPluginHandle, loadCapabilityPluginSync } from \"./capability-plugin.ts\";\nimport type { CapabilityRuntime } from \"./capability-runtime.ts\";\nimport { EXPERIMENTAL_PUBLIC_API_VERSION } from \"./public-api.ts\";\n\nexport const BOOTSTRAP_RETRY_PLUGIN_ID = \"agent-forge.bootstrap-retry\";\nexport const DEFAULT_RETRY_POLICY_NAME = \"default\";\n\n/** Register the built-in retry decision as a replaceable first-party policy. */\nexport function installBootstrapRetryPolicy(runtime: CapabilityRuntime): CapabilityPluginHandle {\n\treturn loadCapabilityPluginSync(\n\t\truntime,\n\t\t{\n\t\t\tid: BOOTSTRAP_RETRY_PLUGIN_ID,\n\t\t\tversion: \"0.0.0\",\n\t\t\tapiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,\n\t\t\tentry: \"<embedded:bootstrap-retry>\",\n\t\t\trequiredCapabilities: [\"retry-policy\"],\n\t\t},\n\t\t(api) => {\n\t\t\tapi.registerRetryPolicy(DEFAULT_RETRY_POLICY_NAME, {\n\t\t\t\tclassify: ({ message }) => {\n\t\t\t\t\tif (!message || typeof message !== \"object\")\n\t\t\t\t\t\tthrow new Error(t(\"Retry classification requires an assistant message object\"));\n\t\t\t\t\treturn isRetryableAssistantError(message as Parameters<typeof isRetryableAssistantError>[0]);\n\t\t\t\t},\n\t\t\t\tdecide: ({ retryable, attempt, maxAttempts, baseDelayMs }) => ({\n\t\t\t\t\tretry: retryable && attempt <= maxAttempts,\n\t\t\t\t\tdelayMs: baseDelayMs * 2 ** Math.max(0, attempt - 1),\n\t\t\t\t}),\n\t\t\t});\n\t\t},\n\t);\n}\n"]}

package/dist/core/extensions/bootstrap-tools.d.ts

@@ -1,20 +0,0 @@
-import type { AgentTool } from "@agent-forge/agent-core";
-import { type ToolsOptions } from "../tools/index.ts";
-import type { ToolDefinition } from "../tools/tool-definition.ts";
-import { type CapabilityPluginHandle } from "./capability-plugin.ts";
-import type { CapabilityRuntime } from "./capability-runtime.ts";
-import { type HostMode } from "./public-api.ts";
-export declare const BOOTSTRAP_TOOLS_PLUGIN_ID = "agent-forge.bootstrap-tools";
-export interface BootstrapToolsOptions {
-    version?: string;
-}
-export interface SessionBootstrapToolsOptions extends BootstrapToolsOptions {
-    read?: ToolsOptions["read"];
-    bash?: ToolsOptions["bash"];
-    mode?: HostMode;
-}
-/** Install the default coding tools through the same facade available to users. */
-export declare function installBootstrapTools(runtime: CapabilityRuntime, definitions: readonly ToolDefinition[], options?: BootstrapToolsOptions): CapabilityPluginHandle;
-/** Build and install the standard coding tools without exposing their construction to AgentSession. */
-export declare function installSessionBootstrapTools(runtime: CapabilityRuntime, cwd: string, options?: SessionBootstrapToolsOptions, baseToolsOverride?: Record<string, AgentTool>): CapabilityPluginHandle;
-//# sourceMappingURL=bootstrap-tools.d.ts.map

package/dist/core/extensions/bootstrap-tools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bootstrap-tools.d.ts","sourceRoot":"","sources":["../../../src/core/extensions/bootstrap-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAA2D,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC/G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,OAAO,EAAE,KAAK,sBAAsB,EAA4B,MAAM,wBAAwB,CAAC;AAC/F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAmC,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEjF,eAAO,MAAM,yBAAyB,gCAAgC,CAAC;AAEvE,MAAM,WAAW,qBAAqB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA6B,SAAQ,qBAAqB;IAC1E,IAAI,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5B,IAAI,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5B,IAAI,CAAC,EAAE,QAAQ,CAAC;CAChB;AAkBD,mFAAmF;AACnF,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,iBAAiB,EAC1B,WAAW,EAAE,SAAS,cAAc,EAAE,EACtC,OAAO,GAAE,qBAA0B,GACjC,sBAAsB,CAcxB;AAED,uGAAuG;AACvG,wBAAgB,4BAA4B,CAC3C,OAAO,EAAE,iBAAiB,EAC1B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,4BAAiC,EAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAC3C,sBAAsB,CAGxB","sourcesContent":["import type { AgentTool } from \"@agent-forge/agent-core\";\nimport { t } from \"../i18n/index.ts\";\nimport { createAllToolDefinitions, createReadOnlyToolDefinitions, type ToolsOptions } from \"../tools/index.ts\";\nimport type { ToolDefinition } from \"../tools/tool-definition.ts\";\nimport { createToolDefinitionFromAgentTool } from \"../tools/tool-definition-wrapper.ts\";\nimport { type CapabilityPluginHandle, loadCapabilityPluginSync } from \"./capability-plugin.ts\";\nimport type { CapabilityRuntime } from \"./capability-runtime.ts\";\nimport { EXPERIMENTAL_PUBLIC_API_VERSION, type HostMode } from \"./public-api.ts\";\n\nexport const BOOTSTRAP_TOOLS_PLUGIN_ID = \"agent-forge.bootstrap-tools\";\n\nexport interface BootstrapToolsOptions {\n\tversion?: string;\n}\n\nexport interface SessionBootstrapToolsOptions extends BootstrapToolsOptions {\n\tread?: ToolsOptions[\"read\"];\n\tbash?: ToolsOptions[\"bash\"];\n\tmode?: HostMode;\n}\n\nfunction resolveSessionToolDefinitions(\n\tcwd: string,\n\toptions: SessionBootstrapToolsOptions,\n\tbaseToolsOverride?: Record<string, AgentTool>,\n): readonly ToolDefinition[] {\n\tif (!baseToolsOverride) {\n\t\treturn options.mode === \"readonly\"\n\t\t\t? createReadOnlyToolDefinitions(cwd, { read: options.read })\n\t\t\t: Object.values(createAllToolDefinitions(cwd, { read: options.read, bash: options.bash }));\n\t}\n\tif (options.mode === \"readonly\") {\n\t\tthrow new Error(t(\"Readonly mode does not allow base tool overrides\"));\n\t}\n\treturn Object.values(baseToolsOverride).map((tool) => createToolDefinitionFromAgentTool(tool));\n}\n\n/** Install the default coding tools through the same facade available to users. */\nexport function installBootstrapTools(\n\truntime: CapabilityRuntime,\n\tdefinitions: readonly ToolDefinition[],\n\toptions: BootstrapToolsOptions = {},\n): CapabilityPluginHandle {\n\treturn loadCapabilityPluginSync(\n\t\truntime,\n\t\t{\n\t\t\tid: BOOTSTRAP_TOOLS_PLUGIN_ID,\n\t\t\tversion: options.version ?? \"0.0.0\",\n\t\t\tapiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,\n\t\t\tentry: \"<embedded:bootstrap-tools>\",\n\t\t\trequiredCapabilities: [\"tools\"],\n\t\t},\n\t\t(api) => {\n\t\t\tfor (const definition of definitions) api.registerTool(definition);\n\t\t},\n\t);\n}\n\n/** Build and install the standard coding tools without exposing their construction to AgentSession. */\nexport function installSessionBootstrapTools(\n\truntime: CapabilityRuntime,\n\tcwd: string,\n\toptions: SessionBootstrapToolsOptions = {},\n\tbaseToolsOverride?: Record<string, AgentTool>,\n): CapabilityPluginHandle {\n\tconst definitions = resolveSessionToolDefinitions(cwd, options, baseToolsOverride);\n\treturn installBootstrapTools(runtime, definitions, options);\n}\n"]}

package/dist/core/extensions/bootstrap-tools.js

@@ -1,36 +0,0 @@
-import { t } from "../i18n/index.js";
-import { createAllToolDefinitions, createReadOnlyToolDefinitions } from "../tools/index.js";
-import { createToolDefinitionFromAgentTool } from "../tools/tool-definition-wrapper.js";
-import { loadCapabilityPluginSync } from "./capability-plugin.js";
-import { EXPERIMENTAL_PUBLIC_API_VERSION } from "./public-api.js";
-export const BOOTSTRAP_TOOLS_PLUGIN_ID = "agent-forge.bootstrap-tools";
-function resolveSessionToolDefinitions(cwd, options, baseToolsOverride) {
-    if (!baseToolsOverride) {
-        return options.mode === "readonly"
-            ? createReadOnlyToolDefinitions(cwd, { read: options.read })
-            : Object.values(createAllToolDefinitions(cwd, { read: options.read, bash: options.bash }));
-    }
-    if (options.mode === "readonly") {
-        throw new Error(t("Readonly mode does not allow base tool overrides"));
-    }
-    return Object.values(baseToolsOverride).map((tool) => createToolDefinitionFromAgentTool(tool));
-}
-/** Install the default coding tools through the same facade available to users. */
-export function installBootstrapTools(runtime, definitions, options = {}) {
-    return loadCapabilityPluginSync(runtime, {
-        id: BOOTSTRAP_TOOLS_PLUGIN_ID,
-        version: options.version ?? "0.0.0",
-        apiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,
-        entry: "<embedded:bootstrap-tools>",
-        requiredCapabilities: ["tools"],
-    }, (api) => {
-        for (const definition of definitions)
-            api.registerTool(definition);
-    });
-}
-/** Build and install the standard coding tools without exposing their construction to AgentSession. */
-export function installSessionBootstrapTools(runtime, cwd, options = {}, baseToolsOverride) {
-    const definitions = resolveSessionToolDefinitions(cwd, options, baseToolsOverride);
-    return installBootstrapTools(runtime, definitions, options);
-}
-//# sourceMappingURL=bootstrap-tools.js.map

package/dist/core/extensions/bootstrap-tools.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bootstrap-tools.js","sourceRoot":"","sources":["../../../src/core/extensions/bootstrap-tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,kBAAkB,CAAC;AACrC,OAAO,EAAE,wBAAwB,EAAE,6BAA6B,EAAqB,MAAM,mBAAmB,CAAC;AAE/G,OAAO,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAC;AACxF,OAAO,EAA+B,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAE/F,OAAO,EAAE,+BAA+B,EAAiB,MAAM,iBAAiB,CAAC;AAEjF,MAAM,CAAC,MAAM,yBAAyB,GAAG,6BAA6B,CAAC;AAYvE,SAAS,6BAA6B,CACrC,GAAW,EACX,OAAqC,EACrC,iBAA6C,EACjB;IAC5B,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC,IAAI,KAAK,UAAU;YACjC,CAAC,CAAC,6BAA6B,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;YAC5D,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,wBAAwB,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7F,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,kDAAkD,CAAC,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iCAAiC,CAAC,IAAI,CAAC,CAAC,CAAC;AAAA,CAC/F;AAED,mFAAmF;AACnF,MAAM,UAAU,qBAAqB,CACpC,OAA0B,EAC1B,WAAsC,EACtC,OAAO,GAA0B,EAAE,EACV;IACzB,OAAO,wBAAwB,CAC9B,OAAO,EACP;QACC,EAAE,EAAE,yBAAyB;QAC7B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO;QACnC,UAAU,EAAE,+BAA+B;QAC3C,KAAK,EAAE,4BAA4B;QACnC,oBAAoB,EAAE,CAAC,OAAO,CAAC;KAC/B,EACD,CAAC,GAAG,EAAE,EAAE,CAAC;QACR,KAAK,MAAM,UAAU,IAAI,WAAW;YAAE,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;IAAA,CACnE,CACD,CAAC;AAAA,CACF;AAED,uGAAuG;AACvG,MAAM,UAAU,4BAA4B,CAC3C,OAA0B,EAC1B,GAAW,EACX,OAAO,GAAiC,EAAE,EAC1C,iBAA6C,EACpB;IACzB,MAAM,WAAW,GAAG,6BAA6B,CAAC,GAAG,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;IACnF,OAAO,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;AAAA,CAC5D","sourcesContent":["import type { AgentTool } from \"@agent-forge/agent-core\";\nimport { t } from \"../i18n/index.ts\";\nimport { createAllToolDefinitions, createReadOnlyToolDefinitions, type ToolsOptions } from \"../tools/index.ts\";\nimport type { ToolDefinition } from \"../tools/tool-definition.ts\";\nimport { createToolDefinitionFromAgentTool } from \"../tools/tool-definition-wrapper.ts\";\nimport { type CapabilityPluginHandle, loadCapabilityPluginSync } from \"./capability-plugin.ts\";\nimport type { CapabilityRuntime } from \"./capability-runtime.ts\";\nimport { EXPERIMENTAL_PUBLIC_API_VERSION, type HostMode } from \"./public-api.ts\";\n\nexport const BOOTSTRAP_TOOLS_PLUGIN_ID = \"agent-forge.bootstrap-tools\";\n\nexport interface BootstrapToolsOptions {\n\tversion?: string;\n}\n\nexport interface SessionBootstrapToolsOptions extends BootstrapToolsOptions {\n\tread?: ToolsOptions[\"read\"];\n\tbash?: ToolsOptions[\"bash\"];\n\tmode?: HostMode;\n}\n\nfunction resolveSessionToolDefinitions(\n\tcwd: string,\n\toptions: SessionBootstrapToolsOptions,\n\tbaseToolsOverride?: Record<string, AgentTool>,\n): readonly ToolDefinition[] {\n\tif (!baseToolsOverride) {\n\t\treturn options.mode === \"readonly\"\n\t\t\t? createReadOnlyToolDefinitions(cwd, { read: options.read })\n\t\t\t: Object.values(createAllToolDefinitions(cwd, { read: options.read, bash: options.bash }));\n\t}\n\tif (options.mode === \"readonly\") {\n\t\tthrow new Error(t(\"Readonly mode does not allow base tool overrides\"));\n\t}\n\treturn Object.values(baseToolsOverride).map((tool) => createToolDefinitionFromAgentTool(tool));\n}\n\n/** Install the default coding tools through the same facade available to users. */\nexport function installBootstrapTools(\n\truntime: CapabilityRuntime,\n\tdefinitions: readonly ToolDefinition[],\n\toptions: BootstrapToolsOptions = {},\n): CapabilityPluginHandle {\n\treturn loadCapabilityPluginSync(\n\t\truntime,\n\t\t{\n\t\t\tid: BOOTSTRAP_TOOLS_PLUGIN_ID,\n\t\t\tversion: options.version ?? \"0.0.0\",\n\t\t\tapiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,\n\t\t\tentry: \"<embedded:bootstrap-tools>\",\n\t\t\trequiredCapabilities: [\"tools\"],\n\t\t},\n\t\t(api) => {\n\t\t\tfor (const definition of definitions) api.registerTool(definition);\n\t\t},\n\t);\n}\n\n/** Build and install the standard coding tools without exposing their construction to AgentSession. */\nexport function installSessionBootstrapTools(\n\truntime: CapabilityRuntime,\n\tcwd: string,\n\toptions: SessionBootstrapToolsOptions = {},\n\tbaseToolsOverride?: Record<string, AgentTool>,\n): CapabilityPluginHandle {\n\tconst definitions = resolveSessionToolDefinitions(cwd, options, baseToolsOverride);\n\treturn installBootstrapTools(runtime, definitions, options);\n}\n"]}

package/dist/core/extensions/provider-failover.d.ts

@@ -1,110 +0,0 @@
-/**
- * 第一方 provider 主备切换插件（设计：docs/design/供应商能力槽位与主备切换设计.md §4）。
- *
- * 形态与 bootstrap-retry 同族——嵌入式第一方插件，策略经公共
- * `api.registerStreamFnWrapper` 注册面挂进宿主默认 stream 装配——但熔断状态是
- * **宿主模块级单例**（设计 §4.2）：进程内所有会话与 subagent 共享同一份，不随
- * 会话 dispose，不持久化（重启后全部 CLOSED）。
- *
- * 判定哲学（设计 §2）：只看流终态 done/error/aborted 与"是否已向上层释放内容
- * 增量"两个本地事实，不解读错误类型/错误码语义；原始 errorMessage 照透传保留，
- * 只用于事件归因与 diagnostics，不参与机器判定分支。aborted 不计数、不换道、
- * 状态不变。换道从第一次失败即发生；`failureThreshold` 只控制"是否继续先撞主"
- * （连续 N 次后熔断打开，请求直接落备用，冷却期满后以真实请求试探回主）。
- */
-import type { Api, Model } from "@agent-forge/ai/compat";
-import type { HostLogger } from "../logger.ts";
-import { type CapabilityPluginHandle } from "./capability-plugin.ts";
-import type { CapabilityRuntime } from "./capability-runtime.ts";
-export declare const PROVIDER_FAILOVER_PLUGIN_ID = "agent-forge.provider-failover";
-export declare const PROVIDER_FAILOVER_WRAPPER_NAME = "provider-failover";
-/**
- * 会话日志快照通道的 customType（设计 §4.7 Phase 3）：插件经公共
- * `api.session.appendEntry` 在状态转移点写入快照，footer 每帧取最后一条渲染
- * 摘要行——与 goal.state / todo.state / workflow.state 同构，零新公共面。
- */
-export declare const PROVIDER_FAILOVER_STATE_ENTRY_TYPE = "provider.failover.state";
-/** `provider.failover.state` 快照负载（footer 按最后一条渲染）。 */
-export interface ProviderFailoverStateSnapshot {
-    readonly version: 1;
-    /** 主链引用 `provider/modelId`；装配期初始快照无链上下文，为空串。 */
-    readonly chainId: string;
-    readonly status: "closed" | "open" | "half-open";
-    /** 当前换道目标引用 `provider/modelId`（OPEN 期请求从链头重走）；closed 省略。 */
-    readonly backupProvider?: string;
-    /** 下次试探时间戳 = open 时刻 + 当前冷却；closed 为 0。 */
-    readonly probeAtMs: number;
-    /** 快照写入时刻（注入时钟友好）。 */
-    readonly now: number;
-}
-interface FailoverChainDeclaration {
-    readonly primary: string;
-    readonly backups: readonly string[];
-}
-interface ResolvedFailoverConfig {
-    /** 试探失败冷却起点（也是回 CLOSED 后的重置值）。 */
-    readonly cooldownInitialMs: number;
-    readonly cooldownMaxMs: number;
-    readonly failureThreshold: number;
-    readonly backupProviders: readonly string[];
-    readonly chains: readonly FailoverChainDeclaration[];
-}
-/**
- * 解析 settings `failover` 节。返回 undefined = 无 failover（未配置 / 无有效
- * backupProviders 与 chains / 配置错误拒绝加载——后者附带一条警告，设计 §4.1
- * "重复 primary 拒绝加载并警告"）。`failover.enabled` 开关已移除（2026-10-03
- * D-079）：节点存在即装配，残留 `enabled` 键只警告并忽略，按其余字段正常解析。
- */
-export declare function parseProviderFailoverConfig(raw: unknown, warn: (message: string) => void): ResolvedFailoverConfig | undefined;
-/**
- * 从 SettingsManager 现有读面取合并后的 `failover` 原始节点（设计 §4.1 配置面）：
- * `getFailoverSettings()`（Phase 1 落地）原样透传合并层对象，本层不做结构收窄
- * ——解析与校验全部收在本模块（见 parseProviderFailoverConfig）。
- */
-export declare function readProviderFailoverSettingsNode(settingsManager: Pick<SettingsManagerFailoverReader, "getFailoverSettings">): unknown;
-interface SettingsManagerFailoverReader {
-    getFailoverSettings(): unknown;
-}
-/** 测试隔离钩子：清空模块级熔断单例与预检警告去重集（仅测试使用）。 */
-export declare function resetProviderFailoverStateForTests(): void;
-/**
- * 装载预检的宿主静态检查面（设计 §4.6）。全部为目录/凭据快照读取：不发网络
- * 请求、不触发 OAuth 刷新（凭据检查与 ModelRuntime.hasConfiguredAuth 同构——
- * 只读"该 provider 是否有凭据条目"，不做可用性探测）。
- */
-export interface ProviderFailoverPreflightChecks {
-    /** 目录解析，与运行时换道候选解析同一面。 */
-    readonly resolveModel: (provider: string, modelId: string) => Model<Api> | undefined;
-    /** provider 在组合目录（builtin + models.json + 扩展）中存在（backupProviders 层预检）。 */
-    readonly hasProvider: (providerId: string) => boolean;
-    /** provider 有凭据条目（静态；不触发 OAuth 刷新）。 */
-    readonly hasConfiguredAuth: (providerId: string) => boolean;
-}
-export interface ProviderFailoverInstallOptions {
-    /** settings `failover` 节的原始合并值（经 readProviderFailoverSettingsNode 读取）。 */
-    readonly failoverSettings: unknown;
-    /**
-     * 装载预检宿主检查面（设计 §4.6）：全部静态读取，零网络、零 OAuth 刷新。
-     * 必传——预检是安装契约的一部分，宿主缺失检查面时不应静默退化为无预检。
-     */
-    readonly preflight: ProviderFailoverPreflightChecks;
-    /** 注入时钟（测试用确定性时间）；缺省 Date.now。 */
-    readonly now?: () => number;
-    /** 宿主进程日志；缺省时配置警告静默丢弃。 */
-    readonly hostLogger?: HostLogger;
-}
-/**
- * 装配嵌入式 provider-failover 插件（设计 §4.8）。
- *
- * - 未配置 / 无有效 backupProviders 与 chains / 配置错误（已警告）→ 返回
- *   undefined，不注册任何面；残留 `failover.enabled` 键只警告并忽略（已移除，
- *   2026-10-03 D-079），节点按其余字段正常解析装配。
- * - 配置解析完成后同步执行装载预检（设计 §4.6）：失败条目从候选源剔除并警告，
- *   警告经模块级去重每进程至多一次；预检不阻断其余条目与主 provider 的正常使用。
- * - 宿主侧装配失败由调用方兜底（failover 是可靠性能力，装载失败不得阻断会话）。
- * - 熔断状态是模块级单例：本函数跨会话重复调用注册的是新包装器实例，但共享
- *   同一份状态（设计 §4.2）。
- */
-export declare function installProviderFailoverPlugin(runtime: CapabilityRuntime, options: ProviderFailoverInstallOptions): CapabilityPluginHandle | undefined;
-export {};
-//# sourceMappingURL=provider-failover.d.ts.map

package/dist/core/extensions/provider-failover.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"provider-failover.d.ts","sourceRoot":"","sources":["../../../src/core/extensions/provider-failover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACX,GAAG,EAMH,KAAK,EAEL,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,KAAK,sBAAsB,EAA4B,MAAM,wBAAwB,CAAC;AAC/F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAYjE,eAAO,MAAM,2BAA2B,kCAAkC,CAAC;AAC3E,eAAO,MAAM,8BAA8B,sBAAsB,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,kCAAkC,4BAA4B,CAAC;AAE5E,kFAAsD;AACtD,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,4FAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACjD,wGAA4D;IAC5D,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,2EAA2C;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oDAAsB;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACrB;AAcD,UAAU,wBAAwB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,UAAU,sBAAsB;IAC/B,wEAAkC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,SAAS,wBAAwB,EAAE,CAAC;CACrD;AA8CD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAC1C,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC7B,sBAAsB,GAAG,SAAS,CAyFpC;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC/C,eAAe,EAAE,IAAI,CAAC,6BAA6B,EAAE,qBAAqB,CAAC,GACzE,OAAO,CAET;AAED,UAAU,6BAA6B;IACtC,mBAAmB,IAAI,OAAO,CAAC;CAC/B;AAsBD,uGAAuC;AACvC,wBAAgB,kCAAkC,IAAI,IAAI,CAGzD;AA0cD;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC/C,gEAA0B;IAC1B,QAAQ,CAAC,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IACrF,8GAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IACtD,uEAAuC;IACvC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5D;AA+HD,MAAM,WAAW,8BAA8B;IAC9C,oGAA0E;IAC1E,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,+BAA+B,CAAC;IACpD,sEAAkC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,gEAA0B;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;CACjC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,CAC5C,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,8BAA8B,GACrC,sBAAsB,GAAG,SAAS,CAyCpC","sourcesContent":["/**\n * 第一方 provider 主备切换插件（设计：docs/design/供应商能力槽位与主备切换设计.md §4）。\n *\n * 形态与 bootstrap-retry 同族——嵌入式第一方插件，策略经公共\n * `api.registerStreamFnWrapper` 注册面挂进宿主默认 stream 装配——但熔断状态是\n * **宿主模块级单例**（设计 §4.2）：进程内所有会话与 subagent 共享同一份，不随\n * 会话 dispose，不持久化（重启后全部 CLOSED）。\n *\n * 判定哲学（设计 §2）：只看流终态 done/error/aborted 与\"是否已向上层释放内容\n * 增量\"两个本地事实，不解读错误类型/错误码语义；原始 errorMessage 照透传保留，\n * 只用于事件归因与 diagnostics，不参与机器判定分支。aborted 不计数、不换道、\n * 状态不变。换道从第一次失败即发生；`failureThreshold` 只控制\"是否继续先撞主\"\n * （连续 N 次后熔断打开，请求直接落备用，冷却期满后以真实请求试探回主）。\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 { HostLogger } from \"../logger.ts\";\nimport { type CapabilityPluginHandle, loadCapabilityPluginSync } from \"./capability-plugin.ts\";\nimport type { CapabilityRuntime } from \"./capability-runtime.ts\";\nimport {\n\tPROVIDER_FAILOVER_PROBE_FAILED_EVENT_ID,\n\tPROVIDER_FAILOVER_PROBE_FAILED_EVENT_VERSION,\n\tPROVIDER_FAILOVER_RECOVERED_EVENT_ID,\n\tPROVIDER_FAILOVER_RECOVERED_EVENT_VERSION,\n\tPROVIDER_FAILOVER_SWITCHED_EVENT_ID,\n\tPROVIDER_FAILOVER_SWITCHED_EVENT_VERSION,\n} from \"./lifecycle-catalog.ts\";\nimport type { LifecycleDispatchRequest, SessionAPI, StreamFnWrapper } from \"./public-api.ts\";\nimport { EXPERIMENTAL_PUBLIC_API_VERSION } from \"./public-api.ts\";\n\nexport const PROVIDER_FAILOVER_PLUGIN_ID = \"agent-forge.provider-failover\";\nexport const PROVIDER_FAILOVER_WRAPPER_NAME = \"provider-failover\";\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 * 从 SettingsManager 现有读面取合并后的 `failover` 原始节点（设计 §4.1 配置面）：\n * `getFailoverSettings()`（Phase 1 落地）原样透传合并层对象，本层不做结构收窄\n * ——解析与校验全部收在本模块（见 parseProviderFailoverConfig）。\n */\nexport function readProviderFailoverSettingsNode(\n\tsettingsManager: Pick<SettingsManagerFailoverReader, \"getFailoverSettings\">,\n): unknown {\n\treturn settingsManager.getFailoverSettings();\n}\n\ninterface SettingsManagerFailoverReader {\n\tgetFailoverSettings(): unknown;\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\ninterface ProviderFailoverRuntimeDeps {\n\treadonly runtime: CapabilityRuntime;\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?: HostLogger;\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(\"provider-failover\", \"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.runtime.hasLifecycleEvent(request.type, request.version)) return;\n\t\tvoid deps.runtime.dispatchLifecycle(request).catch(() => {\n\t\t\t// 可见性事件失败不打断换道判定（宪法 §8 的尽力通道）。\n\t\t});\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\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\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\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 */\nexport interface ProviderFailoverPreflightChecks {\n\t/** 目录解析，与运行时换道候选解析同一面。 */\n\treadonly resolveModel: (provider: string, modelId: string) => Model<Api> | 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 ProviderFailoverInstallOptions {\n\t/** settings `failover` 节的原始合并值（经 readProviderFailoverSettingsNode 读取）。 */\n\treadonly failoverSettings: unknown;\n\t/**\n\t * 装载预检宿主检查面（设计 §4.6）：全部静态读取，零网络、零 OAuth 刷新。\n\t * 必传——预检是安装契约的一部分，宿主缺失检查面时不应静默退化为无预检。\n\t */\n\treadonly preflight: ProviderFailoverPreflightChecks;\n\t/** 注入时钟（测试用确定性时间）；缺省 Date.now。 */\n\treadonly now?: () => number;\n\t/** 宿主进程日志；缺省时配置警告静默丢弃。 */\n\treadonly hostLogger?: HostLogger;\n}\n\n/**\n * 装配嵌入式 provider-failover 插件（设计 §4.8）。\n *\n * - 未配置 / 无有效 backupProviders 与 chains / 配置错误（已警告）→ 返回\n *   undefined，不注册任何面；残留 `failover.enabled` 键只警告并忽略（已移除，\n *   2026-10-03 D-079），节点按其余字段正常解析装配。\n * - 配置解析完成后同步执行装载预检（设计 §4.6）：失败条目从候选源剔除并警告，\n *   警告经模块级去重每进程至多一次；预检不阻断其余条目与主 provider 的正常使用。\n * - 宿主侧装配失败由调用方兜底（failover 是可靠性能力，装载失败不得阻断会话）。\n * - 熔断状态是模块级单例：本函数跨会话重复调用注册的是新包装器实例，但共享\n *   同一份状态（设计 §4.2）。\n */\nexport function installProviderFailoverPlugin(\n\truntime: CapabilityRuntime,\n\toptions: ProviderFailoverInstallOptions,\n): CapabilityPluginHandle | undefined {\n\tconst warn =\n\t\toptions.hostLogger === undefined\n\t\t\t? (_message: string) => {}\n\t\t\t: (message: string) => {\n\t\t\t\t\toptions.hostLogger?.warn(\"provider-failover\", message);\n\t\t\t\t};\n\tconst config = parseProviderFailoverConfig(options.failoverSettings, warn);\n\tif (config === undefined) return undefined;\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, options.preflight, warnPreflightOnce);\n\tconst now = options.now ?? (() => Date.now());\n\treturn loadCapabilityPluginSync(\n\t\truntime,\n\t\t{\n\t\t\tid: PROVIDER_FAILOVER_PLUGIN_ID,\n\t\t\tversion: \"0.0.0\",\n\t\t\tapiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,\n\t\t\tentry: \"<embedded:provider-failover>\",\n\t\t},\n\t\t(api) => {\n\t\t\t// 快照通道绑定本会话的公共 session 面（宿主声明 session feature 时在场）：\n\t\t\t// 会话 A 触发的熔断只写进 A 的日志，footer 可见性是会话局部的（设计 §4.7\n\t\t\t// 保真度限制）。deps 须在此构建——api 只在工厂内可得。\n\t\t\tconst deps: ProviderFailoverRuntimeDeps = {\n\t\t\t\truntime,\n\t\t\t\tconfig: preflighted,\n\t\t\t\tnow,\n\t\t\t\tsession: api.session,\n\t\t\t\t...(options.hostLogger === undefined ? {} : { hostLogger: options.hostLogger }),\n\t\t\t};\n\t\t\tapi.registerStreamFnWrapper(PROVIDER_FAILOVER_WRAPPER_NAME, createFailoverWrapper(deps));\n\t\t\t// 装配期初始快照（status closed）覆盖恢复会话里的陈旧 open 残留：熔断\n\t\t\t// 状态不持久化，新进程恒 CLOSED（设计 §4.2/§4.7）。无链上下文 → chainId 空。\n\t\t\twriteStateSnapshot(deps, { version: 1, chainId: \"\", status: \"closed\", probeAtMs: 0, now: deps.now() });\n\t\t},\n\t);\n}\n"]}