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

package/dist/core/sdk.js

@@ -1,4 +1,4 @@
-import { existsSync, realpathSync } from "node:fs";
+import { existsSync, readdirSync, realpathSync } from "node:fs";
 import { readFile } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -7,11 +7,10 @@ import { clampThinkingLevel, streamSimple, } from "@agent-forge/ai/compat";
 import { createSubagentMailbox } from "@agent-forge/protocol/subagent";
 import { satisfies } from "semver";
 import { BUILTIN_CAPABILITY_PACKAGE_IDS } from "../capabilities/builtin.js";
-import { isValidThinkingLevel } from "../cli/args.js";
 import { CONFIG_DIR_NAME, getAgentDir, VERSION } from "../config.js";
 import { profileIdentitiesCompatible } from "../profile/identity.js";
-import { buildResolvedAgentProfileV1 } from "../profiles/resolved-agent-profile.js";
-import { createSuiteAssembly, decideSuiteCapabilityPlugin, filterSuiteSkills, readSessionSuiteBinding, resolveSuiteId, SUITE_ENV_VAR, SUITE_SESSION_ENTRY_TYPE, SuiteRebindError, suiteDanglingPluginAssociations, } from "../profiles/suite-loader.js";
+import { buildResolvedAgentProfileV1 } from "../suites/resolved-agent-profile.js";
+import { createSuiteAssembly, decideSuiteCapabilityPlugin, filterSuiteSkills, readSessionSuiteBinding, resolveSuiteId, SUITE_ENV_VAR, SUITE_SESSION_ENTRY_TYPE, SuiteRebindError, suiteDanglingPluginAssociations, } from "../suites/suite-loader.js";
 import { resolvePath } from "../utils/paths.js";
 import { AgentSession } from "./agent-session.js";
 import { createAgentSessionRuntime } from "./agent-session-runtime.js";
@@ -25,7 +24,7 @@ import { createCodingAgentFacade } from "./facade/coding-agent-facade.js";
 import { createCodingAgentRuntimeFacade, } from "./facade/coding-agent-runtime-facade.js";
 import { t } from "./i18n/index.js";
 import { convertToLlm } from "./messages.js";
-import { findExactModelReferenceMatch, findInitialModel } from "./model-resolver.js";
+import { findExactModelReferenceMatch, findInitialModel, isValidThinkingLevel } from "./model-resolver.js";
 import { ModelRuntime } from "./model-runtime.js";
 import { DefaultResourceLoader } from "./resource-loader.js";
 import { getDefaultSessionDir, getTraceFilePathForSession, SessionManager } from "./session-manager.js";
@@ -278,7 +277,7 @@ function resolveSdkMemoryMode(explicitMode, env, settingsMode) {
             return { mode: legacy };
         return { mode: "off", invalidEnvValue: legacy };
     }
-    return { mode: "off" };
+    return { mode: "light" };
 }
 /**
  * 子代理 headless 交互宿主（D-044 §5.5）：child 会话无宿主 UI，interaction 请求
@@ -428,8 +427,8 @@ export async function createAgentSession(options = {}) {
         };
     // 记忆档位解析（2.4d6 S1；D-075 S4 第四批）：SDK 显式选项最优先，settings.json
     // 档位作为 env 之下的持久来源进入解析链（显式 > env > settings > 旧别名 env >
-    // off）；两者皆缺省时同样走 env/别名/off 解析（off = memory 插件包不装配）。
-    // 门控诊断与成员资格判定在下方 capabilityWiring 块产出。
+    // light，2026-10-05 翻转默认）；两者皆缺省时同样走 env/别名/light 解析
+    // （off = memory 插件包不装配）。门控诊断与成员资格判定在下方 capabilityWiring 块产出。
     const settingsMemoryMode = settingsManager.getMemoryModeSetting();
     const memoryModeOption = options.memoryCapability?.mode;
     const memoryModeResolution = resolveSdkMemoryMode(memoryModeOption, process.env, settingsMemoryMode);
@@ -1067,9 +1066,19 @@ export async function createAgentSession(options = {}) {
         // capabilityWiring：自持 loader 的子装配域保持插件无关诊断面。
         if (capabilityWiring && passthroughCapabilityPluginIds.length > 0) {
             const installedPluginIdSet = new Set((options.installedCapabilityPlugins ?? []).map((plugin) => plugin.pluginId));
+            // Bundled-channel plugins (D-082 §4.9) ship with the host and load
+            // without an install-store entry, so a suite declaration for one of
+            // them is satisfiable even though it is absent from the installed
+            // set (macCRM dogfood 2026-10-04: provider-failover worked while the
+            // warning claimed it was missing).
+            const bundledDirNames = new Set(bundledCapabilityPluginRoots()
+                .toolRoots.concat(bundledCapabilityPluginRoots().policyRoots)
+                .flatMap((root) => (existsSync(root) ? readdirSync(root) : [])));
             for (const pluginId of passthroughCapabilityPluginIds) {
                 if (installedPluginIdSet.has(pluginId))
                     continue;
+                if (bundledDirNames.has(pluginId.split(".").pop() ?? ""))
+                    continue;
                 capabilityDiagnostics.push(`Suite "${suiteId}" capability "${pluginId}" has no installed active plugin; install it with agent-forge plugin install or remove the declaration`);
             }
         }
@@ -1239,6 +1248,19 @@ export async function createAgentSession(options = {}) {
             }
         }
         const pathByManifest = new Map([...survivors].map((entry) => [entry.manifest, entry.path]));
+        // 按需挂载(插件按需挂载与能力手册设计 §4/§5):activation "on-demand"
+        // 的幸存插件注册但不进初始激活集——卡片(一行描述)与手册路径在此定型并
+        // 注册进会话,由 capability_mount 按插件粒度激活,unmount 仅摘 schema。
+        const deferredCapabilityCards = [...survivors]
+            .filter((entry) => entry.manifest.activation === "on-demand")
+            .map((entry) => ({
+            pluginId: entry.manifest.id,
+            description: entry.manifest.description,
+            manualPath: entry.manifest.manual === undefined ? undefined : resolve(dirname(entry.path), entry.manifest.manual),
+        }));
+        if (deferredCapabilityCards.length > 0) {
+            session.registerDeferredCapabilityCards(deferredCapabilityCards);
+        }
         // 生图槽位注入供料（供应商能力槽位设计 §3.3）：settings 槽位经 settings-manager
         // 校验后的读面取（非法形状已 fail-closed 丢弃并记 warning），目录快照经
         // ModelRuntime 投影 models.json 登记项（装配期静态数据）。