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

package/dist/core/agent-session.js

@@ -32,7 +32,7 @@ import { getAllTools, getCapabilitySkills, getToolDefinition, normalizePromptGui
 import { formatNoApiKeyFoundMessage, formatNoModelSelectedMessage } from "./auth-guidance.js";
 import { THINKING_LEVEL_OPTIONS } from "./defaults.js";
 import { definitionSnapshot, detachedSnapshot } from "./extensions/capability-runtime-snapshot.js";
-import { BOOTSTRAP_AGENT_LOOP_PLUGIN_ID, BOOTSTRAP_BRANCH_SUMMARY_PLUGIN_ID, BOOTSTRAP_COMPACTION_PLUGIN_ID, BOOTSTRAP_LIFECYCLE_PLUGIN_ID, BOOTSTRAP_OVERFLOW_PLUGIN_ID, BOOTSTRAP_RETRY_PLUGIN_ID, BOOTSTRAP_SKILLS_PLUGIN_ID, BOOTSTRAP_TOOLS_PLUGIN_ID, createCapabilityRuntime, DEFAULT_BRANCH_SUMMARY_POLICY_NAME, DEFAULT_COMPACTION_POLICY_NAME, DEFAULT_OVERFLOW_POLICY_NAME, DEFAULT_RETRY_POLICY_NAME, DEFAULT_RUN_LOOP_STRATEGY_NAME, EXPERIMENTAL_PUBLIC_API_VERSION, installBootstrapAgentLoop, installBootstrapBranchSummaryPolicy, installBootstrapCompactionPolicy, installBootstrapLifecycle, installBootstrapOverflowPolicy, installBootstrapRetryPolicy, installSessionBootstrapSkills, installSessionBootstrapTools, loadCapabilityPluginFromManifest, loadCapabilityPlugin as loadCapabilityPluginRuntime, } from "./extensions/index.js";
+import { BOOTSTRAP_AGENT_LOOP_PLUGIN_ID, BOOTSTRAP_LIFECYCLE_PLUGIN_ID, BOOTSTRAP_SKILLS_PLUGIN_ID, createCapabilityRuntime, DEFAULT_BRANCH_SUMMARY_POLICY_NAME, DEFAULT_COMPACTION_POLICY_NAME, DEFAULT_OVERFLOW_POLICY_NAME, DEFAULT_RETRY_POLICY_NAME, DEFAULT_RUN_LOOP_STRATEGY_NAME, EXPERIMENTAL_PUBLIC_API_VERSION, installBootstrapAgentLoop, installBootstrapLifecycle, installSessionBootstrapSkills, loadCapabilityPluginFromManifest, loadCapabilityPlugin as loadCapabilityPluginRuntime, } from "./extensions/index.js";
 import { t } from "./i18n/index.js";
 import { expandPromptTemplate } from "./prompt-templates.js";
 import { createSessionJsonlArtifact } from "./session-export.js";
@@ -104,14 +104,6 @@ export class AgentSession {
     _overflowRecoveryAttempted = false;
     // biome-ignore lint/correctness/noUnusedPrivateClassMembers: read and written via the agent-session-* submodule facade
     _overflowTrimStage = 0;
-    /**
-     * microcompact 冷却（按模型请求计数，0 = 不冷却）：relief 落地时置
-     * MICROCOMPACT_COOLDOWN_ASSISTANT_RESPONSES，此后每次 assistant message_end
-     * （无论 stopReason）减 1、下限 0；user message_start 不复位。冷却期内阈值
-     * decide 以 microcompactEnabled:false 关闭便宜缓解。微观经济动机见
-     * agent-session-compaction.ts 的常量注释（中部历史改写 × 不稳定前缀缓存）。
-     */
-    _microcompactCooldown = 0;
     // Branch summarization state
     _branchSummaryAbortController = undefined;
     _branchSummaryPromise = undefined;
@@ -182,7 +174,6 @@ export class AgentSession {
         for (const listener of [...this._outputArtifactCommitListeners])
             listener(artifact);
     };
-    _bootstrapToolsHandle;
     _bootstrapSkillsHandle;
     _bootstrapRetryHandle;
     _bootstrapCompactionHandle;
@@ -192,6 +183,12 @@ export class AgentSession {
     _bootstrapLifecycleHandle;
     _capabilityPlugins = new Map();
     _inlineCapabilityPlugins = new Map();
+    /**
+     * 宿主装配链经 loadCapabilityPluginManifest 声明的 configOverride（按解析后
+     * manifest 路径）。reload 重装载循环据此回放 sdk 注入的会话事实（D-082 批 1：
+     * coding-tools 的 cwd/read/bash 等），会话生命周期内随同路径显式装载覆盖。
+     */
+    _capabilityPluginConfigOverrides = new Map();
     _isDisposingCapabilityPlugins = false;
     /**
      * 工具表变更钩子的两道门（见 _buildRuntime 的 onToolRegistryChange）：
@@ -212,7 +209,6 @@ export class AgentSession {
     _allowedToolNames;
     // biome-ignore lint/correctness/noUnusedPrivateClassMembers: read and written via the agent-session-* submodule facade
     _excludedToolNames;
-    _baseToolsOverride;
     _disabledBootstrapPlugins;
     _sessionStartEvent;
     _capabilityMode;
@@ -303,7 +299,6 @@ export class AgentSession {
         this._initialActiveToolNames = config.initialActiveToolNames;
         this._allowedToolNames = config.allowedToolNames ? new Set(config.allowedToolNames) : undefined;
         this._excludedToolNames = config.excludedToolNames ? new Set(config.excludedToolNames) : undefined;
-        this._baseToolsOverride = config.baseToolsOverride;
         this._disabledBootstrapPlugins = config.disabledBootstrapPlugins;
         this._sessionStartEvent = config.sessionStartEvent ?? { reason: "startup" };
         this._capabilityMode = config.capabilityMode ?? "full-control";
@@ -526,11 +521,6 @@ export class AgentSession {
                     this._overflowRecoveryAttempted = false;
                     this._overflowTrimStage = 0;
                 }
-                // microcompact 冷却按模型请求计数：每个完成的 assistant 响应（无论
-                // stopReason）释放一档，下限 0；冷却期内的阈值 decide 不做便宜缓解。
-                if (this._microcompactCooldown > 0) {
-                    this._microcompactCooldown -= 1;
-                }
                 // Reset retry counter immediately on successful assistant response
                 // This prevents accumulation across multiple LLM calls within a turn
                 if (assistantMsg.stopReason !== "error" && this._retryAttempt > 0) {
@@ -673,7 +663,6 @@ export class AgentSession {
                     const interactionHost = this._interactionHost;
                     return interactionHost?.dispose?.();
                 },
-                () => this._bootstrapToolsHandle?.dispose(),
                 () => this._bootstrapSkillsHandle?.dispose(),
                 () => this._bootstrapRetryHandle?.dispose(),
                 () => this._bootstrapCompactionHandle?.dispose(),
@@ -693,7 +682,6 @@ export class AgentSession {
             this._capabilityRuntime?.revokeAllAPIs();
             this._capabilityPlugins.clear();
             this._inlineCapabilityPlugins.clear();
-            this._bootstrapToolsHandle = undefined;
             this._bootstrapSkillsHandle = undefined;
             this._bootstrapRetryHandle = undefined;
             this._bootstrapCompactionHandle = undefined;
@@ -892,7 +880,6 @@ export class AgentSession {
     getCapabilityPlugins() {
         const handles = Array.from(this._capabilityPlugins.values());
         for (const handle of [
-            this._bootstrapToolsHandle,
             this._bootstrapSkillsHandle,
             this._bootstrapRetryHandle,
             this._bootstrapCompactionHandle,
@@ -1022,6 +1009,11 @@ export class AgentSession {
             .filter((tool) => this._capabilityMode !== "readonly" ||
             (!tool.source.startsWith("agent-forge.builtin.") && !tool.source.startsWith("agent-forge.plugin.")) ||
             tool.readonlySafe === true)
+            // Deferred plugin tools register but stay out of the active set on
+            // this explicit-activation path too, until tool_search or
+            // setActiveTools names them (same contract as the default path in
+            // agent-session-tools.ts).
+            .filter((tool) => !this._deferredToolPluginIds.has(tool.source))
             .map((tool) => tool.name)
             .filter((name) => !previousToolNames.has(name));
         this._refreshToolRegistry({
@@ -1039,6 +1031,13 @@ export class AgentSession {
         if (this._capabilityPlugins.has(resolvedManifestPath)) {
             throw new Error(t("Capability plugin manifest is already loaded: {path}", { path: resolvedManifestPath }));
         }
+        // 宿主装配声明的 configOverride 按路径记录（D-082 批 1）：sdk 装配链注入的
+        // 会话事实（coding-tools 的 cwd/read/bash 等）在 reload 重装载时经此回放，
+        // 否则插件会退回 manifest 缺省值（cwd 缺失即退回 process.cwd()）。同路径的
+        // 后续显式装载覆盖旧值。
+        if (options?.configOverride !== undefined) {
+            this._capabilityPluginConfigOverrides.set(resolvedManifestPath, options.configOverride);
+        }
         const previousToolNames = new Set(runtime.listTools().map((tool) => tool.name));
         const loaded = await loadCapabilityPluginFromManifest(runtime, resolvedManifestPath, options);
         return this._trackCapabilityPlugin(resolvedManifestPath, loaded, previousToolNames);
@@ -2019,16 +2018,6 @@ export class AgentSession {
     _runAutoCompaction(reason, willRetry) {
         return runAutoCompaction(this._internal, reason, willRetry);
     }
-    /**
-     * Toggle auto-compaction setting.
-     */
-    setAutoCompactionEnabled(enabled) {
-        this.settingsManager.setCompactionEnabled(enabled);
-    }
-    /** Whether auto-compaction is enabled */
-    get autoCompactionEnabled() {
-        return this.settingsManager.getCompactionEnabled();
-    }
     /**
      * Run the session-start boundary: dispatch session.start@1 to the capability
      * runtime and run the resource discovery pass (contributed skills/prompts/
@@ -2127,9 +2116,6 @@ export class AgentSession {
         // 对齐 context transition 控制器的替换模式：runtime 重建时刷新 parent
         // 取消栅栏，防止 reload 后新 runtime 的任务绑到旧 spent 信号被立即取消。
         this._agentTaskScopeAbortController = new AbortController();
-        const autoResizeImages = this.settingsManager.getImageAutoResize();
-        const shellCommandPrefix = this.settingsManager.getShellCommandPrefix();
-        const shellPath = this.settingsManager.getShellPath();
         this._capabilityRuntime = createCapabilityRuntime({
             apiVersion: EXPERIMENTAL_PUBLIC_API_VERSION,
             mode: this._capabilityMode,
@@ -2150,6 +2136,27 @@ export class AgentSession {
             // The session working directory rides the public HostCapabilities as a host
             // service so workspace-bound plugins (LSP real host) resolve their adapters.
             workspaceDirectory: this._cwd,
+            // 模型目录宿主服务（D-082 批 3b，契约 B）：provider-failover 装载预检/
+            // 目录快照读面（api.host.modelCatalog）。全部是 ModelRuntime 静态目录
+            // 与凭据条目的即时读投影，零网络、零 OAuth；resolveModel 返回结构视图
+            // （provider/contextWindow/maxTokens/compat/thinkingLevelMap 五字段），
+            // 不透出内部 Model 对象，未知 provider/model 对返回 undefined。
+            modelCatalog: {
+                resolveModel: (provider, modelId) => {
+                    const model = this._modelRuntime.getModel(provider, modelId);
+                    if (!model)
+                        return undefined;
+                    return {
+                        provider: model.provider,
+                        contextWindow: model.contextWindow,
+                        maxTokens: model.maxTokens,
+                        ...(model.compat === undefined ? {} : { compat: model.compat }),
+                        ...(model.thinkingLevelMap === undefined ? {} : { thinkingLevelMap: model.thinkingLevelMap }),
+                    };
+                },
+                hasProvider: (providerId) => this._modelRuntime.getProvider(providerId) !== undefined,
+                hasConfiguredAuth: (providerId) => this._modelRuntime.hasConfiguredAuth(providerId),
+            },
             features: [
                 "tools",
                 "skills",
@@ -2339,22 +2346,20 @@ export class AgentSession {
         };
         installBootstrap(BOOTSTRAP_LIFECYCLE_PLUGIN_ID, () => installBootstrapLifecycle(capabilityRuntime));
         installBootstrap(BOOTSTRAP_AGENT_LOOP_PLUGIN_ID, () => installBootstrapAgentLoop(capabilityRuntime, this._createLoopWiring()));
-        installBootstrap(BOOTSTRAP_TOOLS_PLUGIN_ID, () => installSessionBootstrapTools(capabilityRuntime, this._cwd, {
-            read: { autoResizeImages },
-            bash: { commandPrefix: shellCommandPrefix, shellPath },
-            mode: this._capabilityMode,
-        }, this._baseToolsOverride));
-        this._syncCapabilityTools();
+        // 默认编码工具不再由内嵌 bootstrap-tools 注册（D-082 批 1，S6 工具批）：
+        // 实现体迁出为 plugins/coding-tools 独立包，sdk 装配链经 bundled 分发通道
+        // （manifest/jiti）装载，禁用面平移到 options.disabledPluginIds。
+        // 默认策略家族（retry / overflow / compaction / branch summary）自 D-082
+        // 批 3 起不再内嵌安装：实现体迁出为 plugins/{retry,overflow,compaction}-policy
+        // 独立包（branch summary 随 compaction 包），sdk 装配链经 bundled 分发通道
+        // （manifest/jiti）装载，禁用面平移到 options.disabledPluginIds；四个缺省
+        // 策略名（DEFAULT_*_POLICY_NAME）仍由宿主持有。
         installBootstrap(BOOTSTRAP_SKILLS_PLUGIN_ID, () => {
             // refreshBootstrapSkills keys off this handle to decide refresh vs
             // install; dropping it would double-install on the first refresh.
             this._bootstrapSkillsHandle = installSessionBootstrapSkills(capabilityRuntime, this._resourceLoader.getSkills().skills);
             return this._bootstrapSkillsHandle;
         });
-        installBootstrap(BOOTSTRAP_RETRY_PLUGIN_ID, () => installBootstrapRetryPolicy(capabilityRuntime));
-        installBootstrap(BOOTSTRAP_OVERFLOW_PLUGIN_ID, () => installBootstrapOverflowPolicy(capabilityRuntime));
-        installBootstrap(BOOTSTRAP_COMPACTION_PLUGIN_ID, () => installBootstrapCompactionPolicy(capabilityRuntime));
-        installBootstrap(BOOTSTRAP_BRANCH_SUMMARY_PLUGIN_ID, () => installBootstrapBranchSummaryPolicy(capabilityRuntime));
         // The embedded builtin capability channel (方案系统 M3) is retired: the
         // last embedded capability (memory) moved to its own package in D-075
         // S4 fourth batch, so every suite capability now assembles through the
@@ -2380,17 +2385,15 @@ export class AgentSession {
             !tool.source.startsWith("agent-forge.plugin.") ||
             tool.readonlySafe === true)
             .map((tool) => tool.name);
-        const defaultActiveToolNames = this._baseToolsOverride
-            ? Object.keys(this._baseToolsOverride)
-            : this._capabilityMode === "readonly"
-                ? // Derive from declarations: the readonly install path registers
-                    // exactly the declared-safe definitions, so the kernel carries no
-                    // per-tool name knowledge for the readonly face.
-                    this._capabilityRuntime
-                        .listTools()
-                        .filter((tool) => tool.readonlySafe)
-                        .map((tool) => tool.name)
-                : ["read", "bash", "edit", "write"];
+        const defaultActiveToolNames = this._capabilityMode === "readonly"
+            ? // Derive from declarations: the readonly install path registers
+                // exactly the declared-safe definitions, so the kernel carries no
+                // per-tool name knowledge for the readonly face.
+                this._capabilityRuntime
+                    .listTools()
+                    .filter((tool) => tool.readonlySafe)
+                    .map((tool) => tool.name)
+            : ["read", "bash", "edit", "write"];
         // Builtin capability tools join the active surface like externally
         // loaded plugin tools do (_trackCapabilityPlugin); the allowlist /
         // denylist filters below still gate them.
@@ -2432,8 +2435,6 @@ export class AgentSession {
             await agentTaskAdapter?.dispose?.();
             const interactionHost = this._interactionHost;
             await interactionHost?.dispose?.();
-            await this._bootstrapToolsHandle?.dispose();
-            this._bootstrapToolsHandle = undefined;
             await this._bootstrapSkillsHandle?.dispose();
             this._bootstrapSkillsHandle = undefined;
             await this._bootstrapRetryHandle?.dispose();
@@ -2459,7 +2460,10 @@ export class AgentSession {
                 includeAllExtensionTools: true,
             });
             for (const manifestPath of capabilityPluginPaths) {
-                await this.loadCapabilityPluginManifest(manifestPath);
+                // 宿主装配注入的 configOverride 按路径回放（D-082 批 1），重装载不退
+                // 回 manifest 缺省值。
+                const configOverride = this._capabilityPluginConfigOverrides.get(manifestPath);
+                await this.loadCapabilityPluginManifest(manifestPath, ...(configOverride === undefined ? [] : [{ configOverride }]));
             }
             for (const { manifest, factory } of inlineCapabilityPlugins) {
                 await this.loadCapabilityPlugin(manifest, factory);
@@ -2515,16 +2519,6 @@ export class AgentSession {
     get isRetrying() {
         return this._retryAbortController !== undefined;
     }
-    /** Whether auto-retry is enabled */
-    get autoRetryEnabled() {
-        return this.settingsManager.getRetryEnabled();
-    }
-    /**
-     * Toggle auto-retry setting.
-     */
-    setAutoRetryEnabled(enabled) {
-        this.settingsManager.setRetryEnabled(enabled);
-    }
     // =========================================================================
     // Bash Execution
     // =========================================================================