@ai-zen/agents-sdk 0.12.0 → 1.0.0-alpha.1

package/dist/config/ConfigManager.js

@@ -54,17 +54,28 @@ export class ConfigManager {
     }
     /**
      * 确保 config.json 存在。不存在时写入出厂默认配置 DSL。
+     *
+     * 已存在时执行「出厂模型清单同步」（见 syncManagedModels）：
+     * models / imageModels 中凡是**没有** `custom: true` 的条目一律视为出厂托管，
+     * 会被移除并替换为 DEFAULT_APP_CONFIG 中的最新定义；标了 `custom: true` 的
+     * 条目视为用户自有，原样保留。同步结果与磁盘内容一致时不写盘。
      */
     async ensureDefaultConfig() {
+        let existing;
         try {
             await fs.access(this.configPath);
-            return await this.read();
+            existing = await this.read();
         }
         catch {
             await this.ensureDirs();
             await this.write(DEFAULT_APP_CONFIG);
             return { ...DEFAULT_APP_CONFIG };
         }
+        const synced = syncManagedModels(existing);
+        if (JSON.stringify(synced) !== JSON.stringify(existing)) {
+            await this.write(synced);
+        }
+        return synced;
     }
     /**
      * 确保 basePath/agents/default.json 存在。
@@ -234,6 +245,38 @@ export class ConfigManager {
         await fs.rename(tmpPath, path);
     }
 }
+/**
+ * 同步出厂托管的模型清单（与默认 Agent 的 custom 机制一致）。
+ *
+ * 规则：
+ * - 未标 `custom: true` 的条目 → 由 SDK 托管，从结果中移除，改用 defaults 中的最新定义；
+ * - 标了 `custom: true` 的条目 → 用户自有，原样保留；与出厂定义同 id 时用户版本优先；
+ * - 默认模型 ID（defaultModel / defaultImageModel / defaultMigrationModel）
+ *   在合并后若已不存在 → 回退到出厂默认，避免悬空引用。
+ *
+ * 端点（endpoints）不参与托管，始终保持用户配置。
+ */
+export function syncManagedModels(config) {
+    const pick = (existing, defaults) => {
+        const kept = (existing ?? []).filter((m) => m.custom === true);
+        const keptIds = new Set(kept.map((m) => m.id));
+        // 出厂定义在前，用户自有条目随后；同 id 时用户版本胜出（出厂侧已剔除）
+        return [...defaults.filter((m) => !keptIds.has(m.id)), ...kept];
+    };
+    const models = pick(config.models, DEFAULT_APP_CONFIG.models);
+    const imageModels = pick(config.imageModels, DEFAULT_APP_CONFIG.imageModels ?? []);
+    const modelIds = new Set(models.map((m) => m.id));
+    const imageIds = new Set(imageModels.map((m) => m.id));
+    const resolve = (id, ids, fallback) => id && ids.has(id) ? id : fallback;
+    return {
+        ...config,
+        models,
+        imageModels,
+        defaultModel: resolve(config.defaultModel, modelIds, DEFAULT_APP_CONFIG.defaultModel),
+        defaultImageModel: resolve(config.defaultImageModel, imageIds, DEFAULT_APP_CONFIG.defaultImageModel),
+        defaultMigrationModel: resolve(config.defaultMigrationModel, modelIds, DEFAULT_APP_CONFIG.defaultMigrationModel),
+    };
+}
 /**
  * 比较两段消息列表的提示词内容是否一致。
  *

package/dist/config/constants.js

@@ -85,71 +85,101 @@ export const DEFAULT_APP_CONFIG = {
             description: "DeepSeek API 端点",
         },
     ],
+    // 模型清单（2026-10-03 依据各厂商官方来源核对）：
+    //   OpenAI   → openai.com 发布公告 / API 目录（platform 文档站对脚本有访问限制）
+    //   智谱     → docs.bigmodel.cn 模型概览/定价 + open.bigmodel.cn/api/paas/v4/models
+    //   DeepSeek → api-docs.deepseek.com 定价页与 News + api.deepseek.com/v1/models
+    //
+    // 更新策略：本清单为「出厂托管」清单。用户 config.json 中凡未标 `custom: true`
+    // 的模型（含 imageModels）在初始化时一律被移除并替换为本清单中的最新定义；
+    // 标了 `custom: true` 的条目视为用户自有，原样保留。实现见
+    // ConfigManager.syncManagedModels。
+    //
+    // maxContextTokens 是「任务迁移（交接）触发阈值」，不是模型的真实上下文窗口：
+    // 迁移判断只看 API 响应返回的 usage.prompt_tokens。窗口 ≥1M 的模型统一取 250K
+    // （约 25%），glm-4.7-flash 窗口仅 200K，取 100K。
     models: [
+        // ---------- OpenAI ----------
         {
-            id: "gpt-5.5",
-            name: "GPT-5.5",
+            id: "gpt-6-astra",
+            name: "GPT-6 Astra",
             endpointId: "openai",
-            modelName: "gpt-5.5",
+            modelName: "gpt-6-astra",
             maxContextTokens: 250_000,
             defaultParams: {},
-            description: "OpenAI 最新旗舰模型，擅长编程与代码调试、在线研究、数据分析",
+            vision: true,
+            description: "OpenAI 最强旗舰（2026-09）：高级分析、软件工程、深度研究与科学工作",
         },
         {
-            id: "glm-5.1",
-            name: "GLM-5.1",
-            endpointId: "bigmodelcn",
-            modelName: "glm-5.1",
+            id: "gpt-6.1-sol",
+            name: "GPT-6.1 Sol",
+            endpointId: "openai",
+            modelName: "gpt-6.1-sol",
             maxContextTokens: 250_000,
             defaultParams: {},
-            description: "智谱AI 最新旗舰模型，支持8小时长程Agent任务",
+            vision: true,
+            description: "OpenAI 最新旗舰（2026-09-29）：Agentic Coding、计算机操作与文档密集型专业任务",
         },
         {
-            id: "glm-5v-turbo",
-            name: "GLM-5V-Turbo",
-            endpointId: "bigmodelcn",
-            modelName: "glm-5v-turbo",
+            id: "gpt-6-luna",
+            name: "GPT-6 Luna",
+            endpointId: "openai",
+            modelName: "gpt-6-luna",
             maxContextTokens: 250_000,
             defaultParams: {},
             vision: true,
-            description: "智谱AI 多模态Coding基座（支持图片输入）",
+            description: "OpenAI GPT-6 系列快速低成本模型：适合高吞吐、低延迟场景",
         },
+        // ---------- 智谱 BigModel ----------
         {
-            id: "glm-4.7-flash",
-            name: "GLM-4.7-Flash",
+            id: "glm-5.3",
+            name: "GLM-5.3",
             endpointId: "bigmodelcn",
-            modelName: "glm-4.7-flash",
+            modelName: "glm-5.3",
             maxContextTokens: 250_000,
-            defaultParams: {},
-            description: "智谱AI 免费轻量模型",
+            defaultParams: { thinking: { type: "enabled" }, reasoning_effort: "max" },
+            description: "智谱最新旗舰：复杂软件工程与长程 Agent 任务（强制开启思考，1M 上下文）",
         },
         {
-            id: "deepseek-v4-pro",
-            name: "DeepSeek-V4-Pro",
-            endpointId: "deepseek",
-            modelName: "deepseek-v4-pro",
+            id: "glm-5.3-flash",
+            name: "GLM-5.3-Flash",
+            endpointId: "bigmodelcn",
+            modelName: "glm-5.3-flash",
             maxContextTokens: 250_000,
-            defaultParams: { thinking: { type: "disabled" } },
-            description: "DeepSeek 旗舰模型，Agentic Coding开源第一",
+            defaultParams: { thinking: { type: "enabled" }, reasoning_effort: "max" },
+            vision: true,
+            description: "智谱原生多模态模型（图片/视频/文件）：视觉 Coding，1M 上下文",
         },
         {
-            id: "deepseek-v4-flash",
-            name: "DeepSeek-V4-Flash",
-            endpointId: "deepseek",
-            modelName: "deepseek-v4-flash",
+            id: "glm-5.3-flashx",
+            name: "GLM-5.3-FlashX",
+            endpointId: "bigmodelcn",
+            modelName: "glm-5.3-flashx",
             maxContextTokens: 250_000,
-            defaultParams: { thinking: { type: "enabled" } },
-            description: "DeepSeek 经济高效模型",
+            defaultParams: { thinking: { type: "enabled" }, reasoning_effort: "max" },
+            vision: true,
+            description: "GLM-5.3-Flash 高速版（200 tokens/s），原生多模态",
+        },
+        {
+            id: "glm-4.7-flash",
+            name: "GLM-4.7-Flash",
+            endpointId: "bigmodelcn",
+            modelName: "glm-4.7-flash",
+            // 该模型真实窗口仅 200K，阈值下调至 100K（约窗口的 50%），留足 response 空间
+            maxContextTokens: 100_000,
+            defaultParams: {},
+            description: "智谱免费文本模型：200K 上下文，适合轻量任务",
         },
+        // ---------- DeepSeek ----------
         {
-            id: "deepseek-v4-flash-vision-exp",
-            name: "DeepSeek-V4-Flash-Vision-Exp",
+            id: "deepseek-flash",
+            name: "DeepSeek-V4.1-Flash",
             endpointId: "deepseek",
-            modelName: "deepseek-v4-flash-vision-exp",
+            modelName: "deepseek-flash",
             maxContextTokens: 250_000,
             defaultParams: { thinking: { type: "enabled" } },
             vision: true,
-            description: "DeepSeek 视觉实验模型（支持图片/文件输入）",
+            description: "DeepSeek 旗舰（2026-09-10）：552B MoE 非对称架构，原生多模态，1M 上下文",
         },
     ],
     imageModels: [
@@ -176,10 +206,10 @@ export const DEFAULT_APP_CONFIG = {
             defaultSize: "1024x1024",
         },
     ],
-    defaultModel: "deepseek-v4-flash",
+    defaultModel: "deepseek-flash",
     defaultImageModel: "cogview-4",
     defaultAgent: "default",
-    defaultMigrationModel: "deepseek-v4-flash",
+    defaultMigrationModel: "deepseek-flash",
     // 工具输出上限（字符数），与 DEFAULT_MAX_TOOL_OUTPUT 保持一致
     maxToolOutput: 32_768,
 };

package/dist/index.d.ts

@@ -1,42 +1,50 @@
 export type { PermissionPolicy, AgentPermissions, Endpoint, Model, ImageModel, AgentDefinition, AppConfig, ToolEnv, McpIcon, McpAnnotations, McpToolDef, McpResourceDef, McpPromptDef, McpServerManifest, McpServerConfig, McpConnectionState, } from "./types/index.js";
-export { PermissionEvaluator } from "./capabilities/PermissionEvaluator.js";
-export type { CandidateSets } from "./capabilities/PermissionEvaluator.js";
-export { createDisclosureParam } from "./capabilities/disclosure.js";
-export type { DisclosureParam } from "./capabilities/disclosure.js";
-export { discoverBuiltinTools } from "./capabilities/discovery/builtin.js";
-export { discoverSubAgents } from "./capabilities/discovery/subagents.js";
-export { discoverSkills, readSkill } from "./capabilities/discovery/skills.js";
-export type { SkillInfo, Frontmatter } from "./capabilities/discovery/skills.js";
-export { discoverMcpServers } from "./capabilities/discovery/mcp.js";
-export { discoverUserTools } from "./capabilities/discovery/usertools.js";
+export { PermissionEvaluator } from "./scope/PermissionEvaluator.js";
+export type { CandidateSets } from "./scope/PermissionEvaluator.js";
+export { createDisclosureParam } from "./scope/disclosure.js";
+export type { DisclosureParam } from "./scope/disclosure.js";
+export { discoverBuiltinTools } from "./scope/plugins/builtin/discover.js";
+export { discoverSubAgents } from "./scope/plugins/subagents/discover.js";
+export { discoverSkills, readSkill } from "./scope/plugins/skills/discover.js";
+export type { SkillInfo, Frontmatter } from "./scope/plugins/skills/discover.js";
+export { discoverMcpServers } from "./scope/plugins/mcp/discover.js";
+export { discoverUserTools } from "./scope/plugins/usertools/discover.js";
+export { Scope } from "./scope/Scope.js";
+export type { FilterOutput, ExcludeOptions, FilterOptions, } from "./scope/Scope.js";
+export type { ScopePlugin, ScopeCandidates } from "./scope/ScopePlugin.js";
+export { BuiltinToolsScopePlugin } from "./scope/plugins/builtin/BuiltinToolsScopePlugin.js";
+export { UserToolsScopePlugin } from "./scope/plugins/usertools/UserToolsScopePlugin.js";
+export { SkillsScopePlugin } from "./scope/plugins/skills/SkillsScopePlugin.js";
+export { McpScopePlugin } from "./scope/plugins/mcp/McpScopePlugin.js";
+export { SubAgentsScopePlugin } from "./scope/plugins/subagents/SubAgentsScopePlugin.js";
+export { allInOne } from "./scope/plugins/allInOne.js";
+export type { AllInOneOptions } from "./scope/plugins/allInOne.js";
 export { ConfigManager, DEFAULT_AGENT_ID, DEFAULT_AGENT_DEFINITION, DEFAULT_SUBAGENT_ID, DEFAULT_SUBAGENT_DEFINITION, DEFAULT_APP_CONFIG, DEFAULT_MCP_CONFIG, CONFIG_SUB_DIRS, } from "./config/ConfigManager.js";
 export { EntityRepository } from "./shared/EntityRepository.js";
 export { AgentRepository } from "./crud/AgentRepository.js";
-export { Provider } from "./runtime/Provider.js";
-export type { FilterOutput, ExcludeOptions } from "./runtime/Provider.js";
 export { createModel } from "./runtime/createModel.js";
 export { SdkAgent } from "./runtime/SdkAgent.js";
 export type { AgentPlugin, SendContext } from "./runtime/SdkAgent.js";
 export { createAgent } from "./runtime/createAgent.js";
-export { McpConnectionManager } from "./runtime/McpConnectionManager.js";
-export type { McpConnectOptions } from "./runtime/McpConnectionManager.js";
-export { SdkCallbackTool } from "./runtime/SdkCallbackTool.js";
-export type { SdkCallbackToolOptions } from "./runtime/SdkCallbackTool.js";
+export { McpConnectionManager } from "./scope/plugins/mcp/McpConnectionManager.js";
+export type { McpConnectOptions } from "./scope/plugins/mcp/McpConnectionManager.js";
+export { SdkCallbackTool } from "./scope/plugins/builtin/SdkCallbackTool.js";
+export type { SdkCallbackToolOptions } from "./scope/plugins/builtin/SdkCallbackTool.js";
 export { TaskMigrationService } from "./runtime/TaskMigrationService.js";
 export type { MigrationContext, MigrationStrategy, TaskMigrationServiceOptions, } from "./runtime/TaskMigrationService.js";
-export { AutoMigratePlugin } from "./plugin/AutoMigratePlugin.js";
-export type { AutoMigrateOptions } from "./plugin/AutoMigratePlugin.js";
-export { AutoRefreshToolsPlugin } from "./plugin/AutoRefreshToolsPlugin.js";
-export { ContextGuardPlugin } from "./plugin/ContextGuardPlugin.js";
-export type { ContextGuardOptions } from "./plugin/ContextGuardPlugin.js";
-export { UnknownToolHintPlugin } from "./plugin/UnknownToolHintPlugin.js";
-export { BUILTIN_TOOL_CLASSES } from "./capabilities/implements/builtin/index.js";
-export { CwdTool, ReadFileTool, InspectFileTool, WriteFileTool, ExecTool, MkdirTool, RmTool, GlobTool, LsTool, ExistTool, FindTextTool, DownloadFileTool, RenameTool, CopyTool, BatchEditTool, EditTool, ExecAsyncTool, SleepTool, } from "./capabilities/implements/builtin/index.js";
-export { GenerateImageTool } from "./capabilities/implements/builtin/GenerateImageTool.js";
-export { ViewImageTool } from "./capabilities/implements/builtin/ViewImageTool.js";
-export { createLoadSkillTool, createCallSkillSubAgentTool } from "./capabilities/implements/skillTools.js";
-export { createLoadMcpTool, createCallMcpTool, createReadMcpResourceTool } from "./capabilities/implements/mcpTools.js";
-export { createSubAgentTool } from "./capabilities/implements/subAgentTools.js";
+export { AutoMigratePlugin } from "./agent-plugins/AutoMigratePlugin.js";
+export type { AutoMigrateOptions } from "./agent-plugins/AutoMigratePlugin.js";
+export { AutoRefreshToolsPlugin } from "./agent-plugins/AutoRefreshToolsPlugin.js";
+export { ContextGuardPlugin } from "./agent-plugins/ContextGuardPlugin.js";
+export type { ContextGuardOptions } from "./agent-plugins/ContextGuardPlugin.js";
+export { UnknownToolHintPlugin } from "./agent-plugins/UnknownToolHintPlugin.js";
+export { BUILTIN_TOOL_CLASSES } from "./scope/plugins/builtin/index.js";
+export { CwdTool, ReadFileTool, InspectFileTool, WriteFileTool, ExecTool, MkdirTool, RmTool, GlobTool, LsTool, ExistTool, FindTextTool, DownloadFileTool, RenameTool, CopyTool, BatchEditTool, EditTool, ExecAsyncTool, SleepTool, } from "./scope/plugins/builtin/index.js";
+export { GenerateImageTool } from "./scope/plugins/builtin/GenerateImageTool.js";
+export { ViewImageTool } from "./scope/plugins/builtin/ViewImageTool.js";
+export { createLoadSkillTool, createCallSkillSubAgentTool } from "./scope/plugins/skills/skillTools.js";
+export { createLoadMcpTool, createCallMcpTool, createReadMcpResourceTool } from "./scope/plugins/mcp/mcpTools.js";
+export { createSubAgentTool } from "./scope/plugins/subagents/subAgentTools.js";
 export { getLogger, setLogger } from "./shared/logger.js";
 export type { Logger, LogFunctions } from "./shared/logger.js";
 export { SdkError, ContextOverflowError } from "./shared/errors.js";

package/dist/index.js

@@ -1,38 +1,45 @@
 // 能力管线
-export { PermissionEvaluator } from "./capabilities/PermissionEvaluator.js";
-export { createDisclosureParam } from "./capabilities/disclosure.js";
+export { PermissionEvaluator } from "./scope/PermissionEvaluator.js";
+export { createDisclosureParam } from "./scope/disclosure.js";
 // 发现
-export { discoverBuiltinTools } from "./capabilities/discovery/builtin.js";
-export { discoverSubAgents } from "./capabilities/discovery/subagents.js";
-export { discoverSkills, readSkill } from "./capabilities/discovery/skills.js";
-export { discoverMcpServers } from "./capabilities/discovery/mcp.js";
-export { discoverUserTools } from "./capabilities/discovery/usertools.js";
+export { discoverBuiltinTools } from "./scope/plugins/builtin/discover.js";
+export { discoverSubAgents } from "./scope/plugins/subagents/discover.js";
+export { discoverSkills, readSkill } from "./scope/plugins/skills/discover.js";
+export { discoverMcpServers } from "./scope/plugins/mcp/discover.js";
+export { discoverUserTools } from "./scope/plugins/usertools/discover.js";
+// Scope — 全局上下文 + 能力装配编排容器
+export { Scope } from "./scope/Scope.js";
+export { BuiltinToolsScopePlugin } from "./scope/plugins/builtin/BuiltinToolsScopePlugin.js";
+export { UserToolsScopePlugin } from "./scope/plugins/usertools/UserToolsScopePlugin.js";
+export { SkillsScopePlugin } from "./scope/plugins/skills/SkillsScopePlugin.js";
+export { McpScopePlugin } from "./scope/plugins/mcp/McpScopePlugin.js";
+export { SubAgentsScopePlugin } from "./scope/plugins/subagents/SubAgentsScopePlugin.js";
+export { allInOne } from "./scope/plugins/allInOne.js";
 // 配置 — ConfigManager
 export { ConfigManager, DEFAULT_AGENT_ID, DEFAULT_AGENT_DEFINITION, DEFAULT_SUBAGENT_ID, DEFAULT_SUBAGENT_DEFINITION, DEFAULT_APP_CONFIG, DEFAULT_MCP_CONFIG, CONFIG_SUB_DIRS, } from "./config/ConfigManager.js";
 // CRUD — 实体仓储（仅 Agent 定义等能力实体）
 export { EntityRepository } from "./shared/EntityRepository.js";
 export { AgentRepository } from "./crud/AgentRepository.js";
 // 运行时
-export { Provider } from "./runtime/Provider.js";
 export { createModel } from "./runtime/createModel.js";
 export { SdkAgent } from "./runtime/SdkAgent.js";
 export { createAgent } from "./runtime/createAgent.js";
-export { McpConnectionManager } from "./runtime/McpConnectionManager.js";
-export { SdkCallbackTool } from "./runtime/SdkCallbackTool.js";
+export { McpConnectionManager } from "./scope/plugins/mcp/McpConnectionManager.js";
+export { SdkCallbackTool } from "./scope/plugins/builtin/SdkCallbackTool.js";
 export { TaskMigrationService } from "./runtime/TaskMigrationService.js";
 // 插件
-export { AutoMigratePlugin } from "./plugin/AutoMigratePlugin.js";
-export { AutoRefreshToolsPlugin } from "./plugin/AutoRefreshToolsPlugin.js";
-export { ContextGuardPlugin } from "./plugin/ContextGuardPlugin.js";
-export { UnknownToolHintPlugin } from "./plugin/UnknownToolHintPlugin.js";
+export { AutoMigratePlugin } from "./agent-plugins/AutoMigratePlugin.js";
+export { AutoRefreshToolsPlugin } from "./agent-plugins/AutoRefreshToolsPlugin.js";
+export { ContextGuardPlugin } from "./agent-plugins/ContextGuardPlugin.js";
+export { UnknownToolHintPlugin } from "./agent-plugins/UnknownToolHintPlugin.js";
 // 工具 — 内置工具类 + 动态工具工厂
-export { BUILTIN_TOOL_CLASSES } from "./capabilities/implements/builtin/index.js";
-export { CwdTool, ReadFileTool, InspectFileTool, WriteFileTool, ExecTool, MkdirTool, RmTool, GlobTool, LsTool, ExistTool, FindTextTool, DownloadFileTool, RenameTool, CopyTool, BatchEditTool, EditTool, ExecAsyncTool, SleepTool, } from "./capabilities/implements/builtin/index.js";
-export { GenerateImageTool } from "./capabilities/implements/builtin/GenerateImageTool.js";
-export { ViewImageTool } from "./capabilities/implements/builtin/ViewImageTool.js";
-export { createLoadSkillTool, createCallSkillSubAgentTool } from "./capabilities/implements/skillTools.js";
-export { createLoadMcpTool, createCallMcpTool, createReadMcpResourceTool } from "./capabilities/implements/mcpTools.js";
-export { createSubAgentTool } from "./capabilities/implements/subAgentTools.js";
+export { BUILTIN_TOOL_CLASSES } from "./scope/plugins/builtin/index.js";
+export { CwdTool, ReadFileTool, InspectFileTool, WriteFileTool, ExecTool, MkdirTool, RmTool, GlobTool, LsTool, ExistTool, FindTextTool, DownloadFileTool, RenameTool, CopyTool, BatchEditTool, EditTool, ExecAsyncTool, SleepTool, } from "./scope/plugins/builtin/index.js";
+export { GenerateImageTool } from "./scope/plugins/builtin/GenerateImageTool.js";
+export { ViewImageTool } from "./scope/plugins/builtin/ViewImageTool.js";
+export { createLoadSkillTool, createCallSkillSubAgentTool } from "./scope/plugins/skills/skillTools.js";
+export { createLoadMcpTool, createCallMcpTool, createReadMcpResourceTool } from "./scope/plugins/mcp/mcpTools.js";
+export { createSubAgentTool } from "./scope/plugins/subagents/subAgentTools.js";
 // 共享
 export { getLogger, setLogger } from "./shared/logger.js";
 export { SdkError, ContextOverflowError } from "./shared/errors.js";

package/dist/runtime/SdkAgent.d.ts

@@ -2,14 +2,14 @@ import type OpenAI from "openai";
 import { Agent } from "@ai-zen/agents-core";
 import type { AgentNS, Tool } from "@ai-zen/agents-core";
 import type { AgentDefinition } from "../types/index.js";
-import type { Provider } from "./Provider.js";
+import type { Scope } from "../scope/Scope.js";
 export type { AgentPlugin, SendContext } from "@ai-zen/agents-core";
 /**
  * SDK Agent — 继承 Core Agent，携带 SDK 层额外信息。
  *
  * Core Agent 不感知权限、文件系统等业务逻辑；
  * SdkAgent 在 Core Agent 基础上增加了 SDK 层需要的元数据：
- *   - provider：全局 Provider 实例
+ *   - scope：全局 Scope 实例
  *   - definition：Agent 原始定义（含权限 permissions）
  *
  * 插件能力（use / init / send 钩子分发）继承自 Core Agent，此处不再重复实现。
@@ -17,12 +17,12 @@ export type { AgentPlugin, SendContext } from "@ai-zen/agents-core";
  * 权限统一从 `definition.permissions` 读取，不再单独持有。
  */
 export declare class SdkAgent extends Agent {
-    /** 全局 Provider 实例 */
-    readonly provider: Provider;
+    /** 全局 Scope 实例 */
+    readonly scope: Scope;
     /** Agent 原始定义 */
     readonly definition: AgentDefinition;
     constructor(params: {
-        provider: Provider;
+        scope: Scope;
         definition: AgentDefinition;
         client: OpenAI;
         model: string;

package/dist/runtime/SdkAgent.js

@@ -4,7 +4,7 @@ import { Agent } from "@ai-zen/agents-core";
  *
  * Core Agent 不感知权限、文件系统等业务逻辑；
  * SdkAgent 在 Core Agent 基础上增加了 SDK 层需要的元数据：
- *   - provider：全局 Provider 实例
+ *   - scope：全局 Scope 实例
  *   - definition：Agent 原始定义（含权限 permissions）
  *
  * 插件能力（use / init / send 钩子分发）继承自 Core Agent，此处不再重复实现。
@@ -12,8 +12,8 @@ import { Agent } from "@ai-zen/agents-core";
  * 权限统一从 `definition.permissions` 读取，不再单独持有。
  */
 export class SdkAgent extends Agent {
-    /** 全局 Provider 实例 */
-    provider;
+    /** 全局 Scope 实例 */
+    scope;
     /** Agent 原始定义 */
     definition;
     constructor(params) {
@@ -25,7 +25,7 @@ export class SdkAgent extends Agent {
             tools: params.tools,
             allowJsonParseError: params.allowJsonParseError,
         });
-        this.provider = params.provider;
+        this.scope = params.scope;
         this.definition = params.definition;
     }
 }

package/dist/runtime/TaskMigrationService.d.ts

@@ -55,7 +55,7 @@ export interface TaskMigrationServiceOptions {
  *
  * 一个服务实例对应一次迁移上下文。它**不持有**任何模型调用——生成交接文档时
  * 默认复用传入 `agent`（`SdkAgent`）自身的 `client` / `model` / `modelConfig`，
- * 因此无需 Provider、无需独立「迁移 Agent」对象，也无需自建 OpenAI 客户端。
+ * 因此无需 Scope、无需独立「迁移 Agent」对象，也无需自建 OpenAI 客户端。
  * 如需用不同模型生成交接文档，可在构造时显式传入 `client` / `model` / `modelConfig`，
  * 未传则 migrate 时回退到 agent 自带的配置。
  *

package/dist/runtime/TaskMigrationService.js

@@ -5,7 +5,7 @@ import { getLogger } from "../shared/logger.js";
  *
  * 一个服务实例对应一次迁移上下文。它**不持有**任何模型调用——生成交接文档时
  * 默认复用传入 `agent`（`SdkAgent`）自身的 `client` / `model` / `modelConfig`，
- * 因此无需 Provider、无需独立「迁移 Agent」对象，也无需自建 OpenAI 客户端。
+ * 因此无需 Scope、无需独立「迁移 Agent」对象，也无需自建 OpenAI 客户端。
  * 如需用不同模型生成交接文档，可在构造时显式传入 `client` / `model` / `modelConfig`，
  * 未传则 migrate 时回退到 agent 自带的配置。
  *
@@ -143,7 +143,7 @@ export class TaskMigrationService {
         const historyText = TaskMigrationService.serializeMessages(agent.messages.filter((m) => !m.omit));
         const messageCountBefore = agent.messages.length;
         // 生成交接文档所用模型调用：优先使用构造时传入的 client/model/modelConfig，
-        // 未传则回退到 agent 自带的（无需 Provider / 独立迁移 Agent）。
+        // 未传则回退到 agent 自带的（无需 Scope / 独立迁移 Agent）。
         const client = this.client ?? agent.client;
         const model = this.model ?? agent.model;
         const modelConfig = this.modelConfig ?? agent.modelConfig;

package/dist/runtime/createAgent.d.ts

@@ -1,13 +1,13 @@
 import { SdkAgent } from "./SdkAgent.js";
-import type { Provider } from "./Provider.js";
+import type { Scope } from "../scope/Scope.js";
 /**
  * 从磁盘创建 Agent。
  *
- * 通过 Provider 获取已发现的能力，读取 Agent 定义，过滤并实例化工具，产出 SdkAgent。
+ * 通过 Scope 获取已发现的能力，读取 Agent 定义，过滤并实例化工具，产出 SdkAgent。
  *
  * ```ts
- * const agent = await createAgent(provider, "my-agent");
+ * const agent = await createAgent(scope, "my-agent");
  * // agent 是 SdkAgent，可直接注册插件、发送消息
  * ```
  */
-export declare function createAgent(provider: Provider, agentId: string): Promise<SdkAgent>;
+export declare function createAgent(scope: Scope, agentId: string): Promise<SdkAgent>;

package/dist/runtime/createAgent.js

@@ -4,22 +4,22 @@ import { createModel } from "./createModel.js";
 /**
  * 从磁盘创建 Agent。
  *
- * 通过 Provider 获取已发现的能力，读取 Agent 定义，过滤并实例化工具，产出 SdkAgent。
+ * 通过 Scope 获取已发现的能力，读取 Agent 定义，过滤并实例化工具，产出 SdkAgent。
  *
  * ```ts
- * const agent = await createAgent(provider, "my-agent");
+ * const agent = await createAgent(scope, "my-agent");
  * // agent 是 SdkAgent，可直接注册插件、发送消息
  * ```
  */
-export async function createAgent(provider, agentId) {
-    const definition = await new AgentRepository(provider.agentsDir).read(agentId);
+export async function createAgent(scope, agentId) {
+    const definition = await new AgentRepository(scope.agentsDir).read(agentId);
     if (!definition)
         throw new Error(`Agent "${agentId}" 不存在`);
-    const modelId = definition.modelId ?? provider.config.defaultModel;
+    const modelId = definition.modelId ?? scope.config.defaultModel;
     if (!modelId)
         throw new Error("未指定模型且无默认模型");
-    const { client, model, modelConfig } = createModel(provider, modelId);
-    const tools = provider.buildTools(definition, {
+    const { client, model, modelConfig } = createModel(scope, modelId);
+    const tools = scope.buildTools(definition, {
         exclude: {
             subagents: definition.function?.name
                 ? [definition.function.name]
@@ -27,7 +27,7 @@ export async function createAgent(provider, agentId) {
         },
     });
     const agent = new SdkAgent({
-        provider,
+        scope,
         definition,
         client,
         model,

package/dist/runtime/createModel.d.ts

@@ -1,5 +1,5 @@
 import OpenAI from "openai";
-import type { Provider } from "./Provider.js";
+import type { Scope } from "../scope/Scope.js";
 /**
  * Agent 模型装配结果：openai SDK client + 模型名 + 模型参数。
  * Agent 构造时直接消费此结构。
@@ -13,9 +13,9 @@ export interface AgentModel {
     modelConfig?: Record<string, unknown>;
 }
 /**
- * 模型工厂 — 根据 modelId 和 Provider 装配 openai SDK client。
+ * 模型工厂 — 根据 modelId 和 Scope 装配 openai SDK client。
  *
  * 端点（baseUrl / apiKey）来自 config.endpoints，发送给 API 的模型名 = modelName || id。
  * 任何 OpenAI 兼容端点（OpenAI / 智谱 BigModel / DeepSeek 等）均可通过 baseURL 接入。
  */
-export declare function createModel(provider: Provider, modelId: string): AgentModel;
+export declare function createModel(scope: Scope, modelId: string): AgentModel;

package/dist/runtime/createModel.js

@@ -1,12 +1,12 @@
 import OpenAI from "openai";
 /**
- * 模型工厂 — 根据 modelId 和 Provider 装配 openai SDK client。
+ * 模型工厂 — 根据 modelId 和 Scope 装配 openai SDK client。
  *
  * 端点（baseUrl / apiKey）来自 config.endpoints，发送给 API 的模型名 = modelName || id。
  * 任何 OpenAI 兼容端点（OpenAI / 智谱 BigModel / DeepSeek 等）均可通过 baseURL 接入。
  */
-export function createModel(provider, modelId) {
-    const config = provider.config;
+export function createModel(scope, modelId) {
+    const config = scope.config;
     const modelConfig = config.models.find((m) => m.id === modelId);
     if (!modelConfig)
         throw new Error(`模型 "${modelId}" 不存在`);