@ai-agent-forge/agent-forge 0.88.4 → 0.88.6

package/dist/core/sdk.js

@@ -157,6 +157,32 @@ const CODING_TOOLS_PACKAGE_ID = "agent-forge.plugin.coding-tools";
  * wrapper 以 priority -100 注册（契约 A），无论装载顺序都在链最外层。
  */
 const PROVIDER_FAILOVER_PACKAGE_ID = "agent-forge.plugin.provider-failover";
+/**
+ * Plugin id of the standalone browser-playwright package（D-082 §4.9 范围扩围，
+ * 2026-10-08 用户裁决：浏览器操作开箱可用，从 0 安装即可 mount）: the Playwright
+ * browser tool family lives in the `plugins/browser-playwright` package and
+ * assembles through the bundled distribution channel (§4.9) as a fourth-file
+ * copy (plugin.json / agent-forge.json / MANUAL.md / dist/**). Its manifest
+ * declares `activation: "on-demand"`: loading registers no tools and only the
+ * mountable capability card (description + manual path) enters the system
+ * prompt; `capability_mount` activates the tools per plugin on demand. Because
+ * that dormancy self-guards inside the plugin (与 provider-failover 的 config
+ * no-op 自守卫同构), it is exempt from the suite capabilities declaration gate
+ * (see {@link BUNDLED_WIRING_EXEMPT_PLUGIN_IDS}) — the card stays available in
+ * every suite by default and `disabledPluginIds` still disables it.
+ */
+const BROWSER_PLAYWRIGHT_PACKAGE_ID = "agent-forge.plugin.browser-playwright";
+/**
+ * Plugin id of the standalone alignment package（2026-10-08 用户裁决：需求对齐是
+ * 编程助手开箱能力，从 0 安装即可用）: the goal→detail→design requirement
+ * alignment funnel lives in the `plugins/alignment` package and assembles
+ * through the bundled distribution channel (§4.9) as a three-file copy
+ * (plugin.json / agent-forge.json / dist/**). It declares no `provides`, so it
+ * cannot pass the suite capabilities declaration gate and is exempt via
+ * {@link BUNDLED_WIRING_EXEMPT_PLUGIN_IDS}; its three tools join the default
+ * full-control tool surface (always activation, no dormancy).
+ */
+const ALIGNMENT_PACKAGE_ID = "agent-forge.plugin.alignment";
 /**
  * Bundled 默认面插件 id 集合（D-082 批 3）：随发行物 bundled 分发、不受 suite
  * capabilities 声明门控的第一方默认插件——内嵌时代的默认工具面（coding-tools，
@@ -172,15 +198,22 @@ const BUNDLED_DEFAULT_PLUGIN_IDS = new Set([
     "agent-forge.plugin.compaction-policy",
 ]);
 /**
- * Bundled 装配豁免集合（D-082 批 3b）：bundled 候选中不受 suite capabilities
- * 声明门控的插件 id——默认面（{@link BUNDLED_DEFAULT_PLUGIN_IDS}，五 id）加上
- * config 门控可选能力 provider-failover（第六 id，config 门控豁免而非默认策略：
- * settings `failover` 节存在即装配，与内嵌装配同语义；节点不存在时插件工厂
- * 自守卫 no-op）。disabledPluginIds 仍可禁用其中任何一个。
+ * Bundled 装配豁免集合（D-082 批 3b；2026-10-08 扩 browser-playwright、alignment）：
+ * bundled 候选中不受 suite capabilities 声明门控的插件 id——默认面（{@link
+ * BUNDLED_DEFAULT_PLUGIN_IDS}，五 id）、config 门控可选能力 provider-failover
+ * （第六 id，config 门控豁免而非默认策略：settings `failover` 节存在即装配，与
+ * 内嵌装配同语义；节点不存在时插件工厂自守卫 no-op）、on-demand 的
+ * browser-playwright（第七 id，dormancy 由插件自守卫：装载零工具注册，仅
+ * mountable 卡片进系统提示，capability_mount 按需激活），加 always 激活的
+ * alignment（第八 id，不 provides capability 无法走声明门控；三工具随默认
+ * full-control 工具面）。后两者均为 2026-10-08 用户裁决（浏览器操作、需求对齐
+ * 开箱可用，从 0 安装即可用）。disabledPluginIds 仍可禁用其中任何一个。
  */
 const BUNDLED_WIRING_EXEMPT_PLUGIN_IDS = new Set([
     ...BUNDLED_DEFAULT_PLUGIN_IDS,
     PROVIDER_FAILOVER_PACKAGE_ID,
+    BROWSER_PLAYWRIGHT_PACKAGE_ID,
+    ALIGNMENT_PACKAGE_ID,
 ]);
 /**
  * Bundled 默认策略包的目录名（plugins/ 工作副本与发行物 bundled-plugins/ 快照
@@ -201,13 +234,17 @@ const BUNDLED_DEFAULT_POLICY_PACKAGES = [
  *   `<packageRoot>/bundled-plugins/<name>/` (data files, not npm deps).
  * - Dev repository form: the repo-root working copies of the packages this
  *   batch migrated (`<repoRoot>/plugins/coding-tools` — 批 1；四个策略包 — 批 3；
- *   provider-failover — 批 3b).
- *   Sibling first-party packages keep their install-store assembly (D-075
- *   S4/S5 semantics, pinned by the ecosystem assembly tests) until their own
- *   migration batch (S7-S9) widens this root.
+ *   provider-failover — 批 3b；browser-playwright、alignment — 2026-10-08 范围
+ *   扩围). Sibling first-party packages keep their install-store assembly
+ *   (D-075 S4/S5 semantics, pinned by the ecosystem assembly tests) until their
+ *   own migration batch (S7-S9) widens this root.
  *
- * 工具面（coding-tools）受 noTools 整层跳过（对照内嵌工具装配的跳过语义）；
- * 策略面不受 noTools 门控——内嵌 installBootstrap* 时代它们随会话无条件安装。
+ * 工具面（coding-tools、browser-playwright、alignment）受 noTools 整层跳过（对照
+ * 内嵌工具装配的跳过语义）；策略面不受 noTools 门控——内嵌 installBootstrap* 时
+ * 代它们随会话无条件安装。browser-playwright 是 on-demand 激活：装载零工具注册，
+ * 仅 mountable 卡片进系统提示（2026-10-08 用户裁决：浏览器操作开箱可用）。
+ * alignment 是 always 激活：三工具进默认 full-control 工具面（2026-10-08 用户裁
+ * 决：需求对齐开箱可用）。
  *
  * The package root is derived from this module's URL: src runs sit at
  * `src/core/`, unbundled dist runs at `dist/core/` (both two levels up), and
@@ -240,6 +277,12 @@ function bundledCapabilityPluginRoots() {
     // gate instead of passing unnoticed.
     const devPluginsRoot = join(packageRoot, "..", "..", "plugins");
     toolRoots.push(join(devPluginsRoot, "coding-tools"));
+    // browser-playwright（2026-10-08 范围扩围）：浏览器工具面随工具根分发（受
+    // noTools 门控，与工具面同语义）；on-demand 激活保持装载不进默认工具面。
+    toolRoots.push(join(devPluginsRoot, "browser-playwright"));
+    // alignment（2026-10-08 用户裁决）：对齐三工具随工具根分发，always 激活进
+    // 默认 full-control 工具面（受 noTools 门控）。
+    toolRoots.push(join(devPluginsRoot, "alignment"));
     for (const name of BUNDLED_DEFAULT_POLICY_PACKAGES)
         policyRoots.push(join(devPluginsRoot, name));
     // provider-failover（D-082 批 3b）：config 门控可选能力，随策略面根分发
@@ -247,6 +290,8 @@ function bundledCapabilityPluginRoots() {
     policyRoots.push(join(devPluginsRoot, "provider-failover"));
     const bundledRoot = join(packageRoot, "bundled-plugins");
     toolRoots.push(join(bundledRoot, "coding-tools"));
+    toolRoots.push(join(bundledRoot, "browser-playwright"));
+    toolRoots.push(join(bundledRoot, "alignment"));
     for (const name of BUNDLED_DEFAULT_POLICY_PACKAGES)
         policyRoots.push(join(bundledRoot, name));
     policyRoots.push(join(bundledRoot, "provider-failover"));
@@ -1181,10 +1226,12 @@ export async function createAgentSession(options = {}) {
             discoveredPluginIds.push(entry.manifest.id);
             const bundledCandidate = bundledManifestPathSet.has(entry.path);
             // Bundled 层过滤：bundled 装配豁免集合（coding-tools 工具面 + 四个默认
-            // 策略插件 + config 门控的 provider-failover，BUNDLED_WIRING_EXEMPT_
-            // PLUGIN_IDS）不受 suite capabilities 声明门控，与内嵌装配同语义——
-            // failover 的"配置存在即装配"不是套件声明可关闭的面（disabledPluginIds
-            // 仍可显式禁用）；其余 bundled 候选与 installed 层同法——
+            // 策略插件 + config 门控的 provider-failover + on-demand 的
+            // browser-playwright，BUNDLED_WIRING_EXEMPT_PLUGIN_IDS）不受 suite
+            // capabilities 声明门控，与内嵌装配同语义——failover 的"配置存在即装
+            // 配"与 browser-playwright 的"开箱即有 mountable 卡片"（2026-10-08 用
+            // 户裁决）都不是套件声明可关闭的面（disabledPluginIds 仍可显式禁用）；
+            // 其余 bundled 候选与 installed 层同法——
             // capabilityWiring 开启时插件 id 必须命中 capabilityPackageIds（套件
             // 未选中的包静默缺席），关闭（自持 loader 的宿主）全收，保底拿到产品
             // 默认面。disabledPluginIds（既有用户面）作用于全部 bundled 候选。