dsh-agent-toolkit 0.2.3 → 0.2.5

package/lib/client.js

@@ -67,15 +67,15 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var delegate_card_module_css_default = {
-			"result": "_8wQUq_result",
-			"chip": "_8wQUq_chip",
 			"summary": "_8wQUq_summary",
+			"root": "_8wQUq_root",
+			"body": "_8wQUq_body",
+			"visuallyHidden": "_8wQUq_visuallyHidden",
+			"row": "_8wQUq_row",
 			"childLink": "_8wQUq_childLink",
 			"prompt": "_8wQUq_prompt",
-			"row": "_8wQUq_row",
-			"body": "_8wQUq_body",
-			"root": "_8wQUq_root",
-			"visuallyHidden": "_8wQUq_visuallyHidden"
+			"chip": "_8wQUq_chip",
+			"result": "_8wQUq_result"
 		};
 		//#endregion
 		//#region src/client/delegate/delegate-card.tsx
@@ -411,32 +411,32 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var agents_module_css_default = {
-			"error": "KsfSLW_error",
-			"builtinBadge": "KsfSLW_builtinBadge",
+			"toolGroupTitle": "KsfSLW_toolGroupTitle",
 			"actions": "KsfSLW_actions",
-			"field": "KsfSLW_field",
-			"listPane": "KsfSLW_listPane",
+			"createButton": "KsfSLW_createButton",
 			"toolMode": "KsfSLW_toolMode",
-			"select": "KsfSLW_select",
-			"toolGrid": "KsfSLW_toolGrid",
-			"split": "KsfSLW_split",
-			"block": "KsfSLW_block",
-			"toolGroupTitle": "KsfSLW_toolGroupTitle",
-			"agentDesc": "KsfSLW_agentDesc",
-			"readonlyId": "KsfSLW_readonlyId",
+			"hint": "KsfSLW_hint",
+			"editorPane": "KsfSLW_editorPane",
+			"error": "KsfSLW_error",
 			"dangerButton": "KsfSLW_dangerButton",
-			"textarea": "KsfSLW_textarea",
+			"listPane": "KsfSLW_listPane",
 			"toolGroupSet": "KsfSLW_toolGroupSet",
+			"select": "KsfSLW_select",
+			"textarea": "KsfSLW_textarea",
+			"agentRow": "KsfSLW_agentRow",
+			"builtinBadge": "KsfSLW_builtinBadge",
+			"field": "KsfSLW_field",
+			"agentName": "KsfSLW_agentName",
+			"agentDesc": "KsfSLW_agentDesc",
 			"editor": "KsfSLW_editor",
+			"block": "KsfSLW_block",
 			"input": "KsfSLW_input",
+			"readonlyId": "KsfSLW_readonlyId",
+			"toolGrid": "KsfSLW_toolGrid",
 			"blockTitle": "KsfSLW_blockTitle",
-			"agentRow": "KsfSLW_agentRow",
-			"agentName": "KsfSLW_agentName",
+			"split": "KsfSLW_split",
 			"toolCheck": "KsfSLW_toolCheck",
-			"hint": "KsfSLW_hint",
-			"createButton": "KsfSLW_createButton",
 			"agentRowActive": "KsfSLW_agentRowActive",
-			"editorPane": "KsfSLW_editorPane",
 			"dialog": "KsfSLW_dialog"
 		};
 		//#endregion
@@ -951,24 +951,24 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var prompt_module_css_default = {
-			"field": "VZk1fa_field",
-			"tab": "VZk1fa_tab",
-			"textarea": "VZk1fa_textarea",
+			"tabActive": "VZk1fa_tabActive",
+			"listPane": "VZk1fa_listPane",
+			"editorPane": "VZk1fa_editorPane",
+			"layerName": "VZk1fa_layerName",
+			"actions": "VZk1fa_actions",
 			"hint": "VZk1fa_hint",
 			"layerOrder": "VZk1fa_layerOrder",
+			"readonlyTag": "VZk1fa_readonlyTag",
+			"tab": "VZk1fa_tab",
+			"split": "VZk1fa_split",
 			"layerRow": "VZk1fa_layerRow",
-			"tabs": "VZk1fa_tabs",
-			"actions": "VZk1fa_actions",
-			"tabActive": "VZk1fa_tabActive",
-			"listPane": "VZk1fa_listPane",
-			"layerRowActive": "VZk1fa_layerRowActive",
+			"textarea": "VZk1fa_textarea",
+			"editor": "VZk1fa_editor",
 			"dialog": "VZk1fa_dialog",
-			"split": "VZk1fa_split",
-			"readonlyTag": "VZk1fa_readonlyTag",
-			"editorPane": "VZk1fa_editorPane",
+			"tabs": "VZk1fa_tabs",
 			"error": "VZk1fa_error",
-			"layerName": "VZk1fa_layerName",
-			"editor": "VZk1fa_editor"
+			"layerRowActive": "VZk1fa_layerRowActive",
+			"field": "VZk1fa_field"
 		};
 		//#endregion
 		//#region src/client/prompt/PromptLayersModal.tsx
@@ -1454,11 +1454,11 @@ window.__ModuleLoader__.load({
 		var chart_module_css_default = {
 			"chartTheme": "_8LXSJW_chartTheme",
 			"swatchCached": "_8LXSJW_swatchCached",
-			"swatchFresh": "_8LXSJW_swatchFresh",
 			"tooltipTitle": "_8LXSJW_tooltipTitle",
-			"legend": "_8LXSJW_legend",
+			"swatchFresh": "_8LXSJW_swatchFresh",
 			"tooltip": "_8LXSJW_tooltip",
-			"tooltipTotal": "_8LXSJW_tooltipTotal"
+			"tooltipTotal": "_8LXSJW_tooltipTotal",
+			"legend": "_8LXSJW_legend"
 		};
 		//#endregion
 		//#region \0dsh-css:D:\work\github\dsh\dsh-agent-toolkit\packages\usage\src\client\usage\ActivityHeatmap.module.css.mjs
@@ -1472,14 +1472,14 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var ActivityHeatmap_module_css_default = {
-			"level0": "hjrYrq_level0",
-			"months": "hjrYrq_months",
+			"grid": "hjrYrq_grid",
 			"level3": "hjrYrq_level3",
-			"level2": "hjrYrq_level2",
 			"level4": "hjrYrq_level4",
-			"level1": "hjrYrq_level1",
-			"grid": "hjrYrq_grid",
-			"week": "hjrYrq_week"
+			"months": "hjrYrq_months",
+			"level0": "hjrYrq_level0",
+			"week": "hjrYrq_week",
+			"level2": "hjrYrq_level2",
+			"level1": "hjrYrq_level1"
 		};
 		//#endregion
 		//#region ../usage/src/client/usage/ActivityHeatmap.tsx
@@ -52517,18 +52517,18 @@ ${te.current.stack}
 		}
 		var UsageModal_module_css_default = {
 			"row": "MODeXa_row",
-			"dateLabel": "MODeXa_dateLabel",
-			"pager": "MODeXa_pager",
-			"tab": "MODeXa_tab",
 			"rowName": "MODeXa_rowName",
-			"compaction": "MODeXa_compaction",
-			"tabActive": "MODeXa_tabActive",
-			"sectionTitle": "MODeXa_sectionTitle",
 			"rowCalls": "MODeXa_rowCalls",
 			"dialog": "MODeXa_dialog",
+			"sectionTitle": "MODeXa_sectionTitle",
+			"dateLabel": "MODeXa_dateLabel",
+			"pager": "MODeXa_pager",
+			"compaction": "MODeXa_compaction",
 			"pagerButton": "MODeXa_pagerButton",
 			"tabs": "MODeXa_tabs",
-			"total": "MODeXa_total"
+			"total": "MODeXa_total",
+			"tab": "MODeXa_tab",
+			"tabActive": "MODeXa_tabActive"
 		};
 		//#endregion
 		//#region ../usage/src/client/usage/UsageModal.tsx
@@ -55153,29 +55153,29 @@ ${te.current.stack}
 			document.head.appendChild(tag);
 		}
 		var bots_module_css_default = {
-			"tabActive": "vTbXga_tabActive",
 			"botRow": "vTbXga_botRow",
-			"step": "vTbXga_step",
-			"tabs": "vTbXga_tabs",
-			"select": "vTbXga_select",
-			"hint": "vTbXga_hint",
 			"channelBadge": "vTbXga_channelBadge",
-			"groupTitle": "vTbXga_groupTitle",
 			"field": "vTbXga_field",
-			"formActions": "vTbXga_formActions",
-			"createButton": "vTbXga_createButton",
-			"tab": "vTbXga_tab",
+			"select": "vTbXga_select",
 			"status": "vTbXga_status",
-			"stepActive": "vTbXga_stepActive",
 			"group": "vTbXga_group",
+			"botName": "vTbXga_botName",
+			"textarea": "vTbXga_textarea",
+			"dialog": "vTbXga_dialog",
 			"input": "vTbXga_input",
+			"steps": "vTbXga_steps",
+			"createButton": "vTbXga_createButton",
+			"tab": "vTbXga_tab",
+			"tabActive": "vTbXga_tabActive",
+			"hint": "vTbXga_hint",
+			"step": "vTbXga_step",
+			"stepSeparator": "vTbXga_stepSeparator",
+			"tabs": "vTbXga_tabs",
 			"scanSection": "vTbXga_scanSection",
 			"error": "vTbXga_error",
-			"stepSeparator": "vTbXga_stepSeparator",
-			"dialog": "vTbXga_dialog",
-			"steps": "vTbXga_steps",
-			"botName": "vTbXga_botName",
-			"textarea": "vTbXga_textarea"
+			"stepActive": "vTbXga_stepActive",
+			"formActions": "vTbXga_formActions",
+			"groupTitle": "vTbXga_groupTitle"
 		};
 		//#endregion
 		//#region src/client/bots/BotForm.tsx

package/lib/index.js

@@ -12,6 +12,7 @@ import { SessionId } from "@deepseek-ai/dsh-session";
 import { credentialRef } from "@deepseek-ai/dsh-credentials";
 import * as lark from "@larksuiteoapi/node-sdk";
 import { randomBytes, randomUUID } from "node:crypto";
+import { bindScopeParent, createScope, scopeOf } from "@deepseek-ai/dsh-scope";
 import { setupUsage } from "@dsh-agent-toolkit/token-usage";
 //#region src/agents/store.ts
 /** agents 注册表存储域声明：记录 schema + domain 布局的单一来源。 */
@@ -1353,6 +1354,15 @@ function createDelegateTool(toolName, deps) {
 /** 团队名册段在 prompt 中的位置：紧随内置 subagent 段（116.5）之后。 */
 const TEAM_SECTION_ORDER = 116.6;
 /**
+* 团队名册段文本：仅当该 agent scope 的可见工具里确有委派工具时渲染，否则空
+* （空段渲染时被丢弃）。工具白名单 restrict 只作用于 tools 视图，名册段必须
+* 自行按 `tools.get(name, scope)` 联动，否则没勾委派的 bot 提示词仍会出现委派段落。
+*/
+function teamSectionText(toolName, roles, toolVisible) {
+	if (!toolVisible) return "";
+	return `你有一组可委派的成员：用 ${toolName} 把自包含的子任务委派给合适的成员，成员结果会作为工具返回值回到本对话。\n可用成员：\n${roles.filter((r) => r.id !== "main").map((r) => `${r.id}: ${r.description ?? r.name}`).join("\n")}`;
+}
+/**
 * 挂载 team_delegate 工具与函数式团队提示段。
 * provider 能力守卫与生命周期镜像同归档 tool-subagent：persona/depthLimit 缺失响亮报错，
 * 工具随 provider 在场与否挂载/摘除。名册来自注册表（main 排除），工具与提示段都经
@@ -1399,10 +1409,7 @@ function setupDelegate(ctx, config, registry, channels) {
 	ctx.systemPrompt.section({
 		name: "plugin:dsh-agent-toolkit:team",
 		order: TEAM_SECTION_ORDER,
-		text: () => {
-			const rosterText = registry.list().filter((r) => r.id !== "main").map((r) => `${r.id}: ${r.description ?? r.name}`).join("\n");
-			return `你有一组可委派的成员：用 ${config.toolName} 把自包含的子任务委派给合适的成员，成员结果会作为工具返回值回到本对话。\n可用成员：\n${rosterText}`;
-		}
+		text: (context) => teamSectionText(config.toolName, registry.list(), ctx.tools.get(config.toolName, context.scope) !== void 0)
 	});
 }
 //#endregion
@@ -1668,18 +1675,15 @@ function setupCreateAgentCommand(ctx, deps) {
 //#region src/channels/agent-setup.ts
 /** bot 会话角色 persona 的 scoped 段名：与全局 persona 层同名，scoped 注册即 shadow 覆盖主 Agent persona。 */
 const TOOLKIT_PERSONA_SECTION = "prompt-stack:persona";
-/** 默认加载器：复刻 preset mount 的模块解析——loader 的 unwrapExports 取 `default ?? 命名导出模块`。 */
-async function loadToolModule(specifier) {
-	const mod = await import(specifier);
-	return mod.default ?? mod;
-}
 /**
-* 组合 agent 作用域：先 scoped 挂载基础工具行（persona/instructions/shell/fs/fs-search，
-* 与原生 UI 会话的 standard preset 同源），再叠 bot 的 persona 与 tools 白名单。
-* 顺序敏感：restrict 必须在工具行挂载之后，否则白名单命中不到挂载带入的工具名。
+* 组合 agent 作用域：先把 agent scope 父链挂到基础工具行 standing scope（工具成为
+* 继承面），再叠 bot 的 persona 与 tools 白名单。
+* 顺序敏感：restrict 必须在 join 之后——宿主 tools.restrict() 只校验并过滤继承面
+* （global + 祖先 scope 层），own 层（agentCtx 直接挂载）的名字既不可 restrict 也
+* 不受 restrict 影响，直接挂进 agentCtx 的白名单会抛 unknown global tools。
 */
-async function setupAgentScope(agentCtx, hooks, loadTool = loadToolModule) {
-	for (const tool of BASIC_TOOLS) await agentCtx.plugin(await loadTool(tool.id), tool.config);
+async function setupAgentScope(agentCtx, hooks, toolsScope) {
+	await toolsScope.join(agentCtx);
 	if (hooks.persona !== void 0) agentCtx.systemPrompt.section({
 		name: TOOLKIT_PERSONA_SECTION,
 		order: 10,
@@ -2747,6 +2751,55 @@ var BotRuntime = class {
 	}
 };
 //#endregion
+//#region src/channels/tool-scope.ts
+/** 默认加载器：复刻 preset mount 的模块解析——loader 的 unwrapExports 取 `default ?? 命名导出模块`。 */
+async function loadToolModule(specifier) {
+	const mod = await import(specifier);
+	return mod.default ?? mod;
+}
+/** 建一个 bot 会话共用的工具行 standing scope（所有 bot 会话挂同一套 BASIC_TOOLS）。 */
+function createToolsScope(ctx, loadTool = loadToolModule) {
+	let scope;
+	let mount;
+	let generation = 0;
+	function ensure() {
+		mount ??= (async () => {
+			const key = {
+				origin: "dsh-agent-toolkit",
+				kind: "bots-tools",
+				gen: ++generation
+			};
+			const created = createScope(ctx, key);
+			scope = created;
+			try {
+				for (const tool of BASIC_TOOLS) await created.ctx.plugin(await loadTool(tool.id), tool.config);
+			} catch (error) {
+				if (scope === created) scope = void 0;
+				mount = void 0;
+				await created.dispose().catch(() => void 0);
+				throw error;
+			}
+			return key;
+		})();
+		return mount;
+	}
+	return {
+		async join(agentCtx) {
+			const agentKey = scopeOf(agentCtx);
+			if (agentKey === void 0) throw new Error("tools-scope: refusing to join an unscoped agent context; per-agent composition requires a scope key");
+			const standing = await ensure();
+			bindScopeParent(agentKey, standing);
+			return standing;
+		},
+		async dispose() {
+			mount = void 0;
+			const current = scope;
+			scope = void 0;
+			await current?.dispose();
+		}
+	};
+}
+//#endregion
 //#region src/bots/api.ts
 /** 浏览器半 RPC：单前缀路由 /dsh-agent-toolkit/api/bots + 内部路径分发。 */
 const MAX_BODY_BYTES = 65536;
@@ -3089,21 +3142,22 @@ function setupBots(ctx, config, deps) {
 		await ctx.credentials.set(credentialRef(ref), secret);
 		return ref;
 	};
-	/** 创作期注入已迁至 agent-setup.ts（基础工具 scoped 挂载 + persona/tools），preset 机制整体移除。 */
+	/** 创作期注入已迁至 agent-setup.ts + tool-scope.ts（基础工具行 standing scope 挂载 + persona/tools），preset 机制整体移除。 */
+	const toolsScope = createToolsScope(ctx);
 	const agentsPort = {
 		async create(input) {
 			return adaptAgent(await ctx.agents.create({
 				sessionId: SessionId(input.sessionId),
 				meta: { cwd: input.cwd },
 				...input.agentOptions !== void 0 ? { agentOptions: input.agentOptions } : {},
-				setup: (agentCtx) => setupAgentScope(agentCtx, input.hooks)
+				setup: (agentCtx) => setupAgentScope(agentCtx, input.hooks, toolsScope)
 			}));
 		},
 		async resume(input) {
 			return adaptAgent(await ctx.agents.resume({
 				resumeSessionId: SessionId(input.sessionId),
 				...input.agentOptions !== void 0 ? { agentOptions: input.agentOptions } : {},
-				setup: (agentCtx) => setupAgentScope(agentCtx, input.hooks)
+				setup: (agentCtx) => setupAgentScope(agentCtx, input.hooks, toolsScope)
 			}));
 		}
 	};
@@ -3207,6 +3261,9 @@ function setupBots(ctx, config, deps) {
 		});
 		return () => dispose();
 	});
+	ctx.effect(() => async () => {
+		await toolsScope.dispose();
+	});
 	ctx.effect(() => async () => {
 		registerAppService.dispose();
 	});