dsh-plugin-tool-management 0.8.0 → 0.9.0

package/lib/subagents/tools.js

@@ -16,31 +16,36 @@ export async function filterBySceneBinding(docs, enabledSceneLists) {
     const allowed = live.filter((d) => bound.has(d.name));
     return { allowed, reason: allowed.length ? null : `当前启用场景的子智能体绑定: ${[...bound].join('、')}` };
 }
-export function defineSubagentListTool(subagents) {
+export function defineSubagentManagerListTool(subagents) {
     return {
-        name: 'subagent_list',
-        description: 'List available personas (pre-configured subagent profiles) with their descriptions. Call before subagent_run.',
-        parameters: {
-            scene: { type: 'string', description: 'Optional scene name filter (informational; the tool already reflects scene binding).' },
-        },
+        name: 'subagent_manager_list',
+        description: 'List available personas (pre-configured subagent profiles) with their descriptions. Call before subagent_manager_run.',
+        parameters: {},
         output: {
             schema: { type: 'string' },
             render: (_a, v) => text(String(v)),
         },
-        async execute() {
+        async execute(_args, exec) {
             const { allowed, reason } = await filterBySceneBinding(await subagents.list(), await subagents.sceneLists());
             const lines = allowed.map((p) => '- ' + p.name + ' — ' + (p.description || '(无描述)'));
-            return '人设子智能体（' + allowed.length + '）：\n' + (lines.join('\n') || '(无)') + (reason ? '\n注意：' + reason : '');
+            let notice = '';
+            try {
+                notice = typeof subagents.noticeFor === 'function' ? await subagents.noticeFor(exec) : '';
+            }
+            catch {
+                notice = '';
+            }
+            return '人设子智能体（' + allowed.length + '）：\n' + (lines.join('\n') || '(无)') + (reason ? '\n注意：' + reason : '') + notice;
         },
     };
 }
-export function defineSubagentRunTool(subagents) {
+export function defineSubagentManagerRunTool(subagents) {
     return {
-        name: 'subagent_run',
-        description: 'Run a named persona as a one-shot subagent: it receives the persona as its own system prompt, works on `task` in a fresh context, and returns only its final output. Discover personas with subagent_list first. Each run is stateless and ephemeral; it does not see this conversation.',
+        name: 'subagent_manager_run',
+        description: 'Run a named persona as a one-shot subagent: it gets the persona as its own system prompt, works on `task` in a fresh context, and returns only its final output. Stateless — it does not see this conversation. Expensive: starts a fresh model session, so use it only for self-contained work.',
         parameters: {
-            agent: { type: 'string', required: true, description: 'Persona name from subagent_list.' },
-            task: { type: 'string', required: true, description: 'Complete, self-contained task for the subagent (include all context it needs).' },
+            agent: { type: 'string', required: true, description: 'Persona name from subagent_manager_list.' },
+            task: { type: 'string', required: true, description: 'Self-contained task, with all context the subagent needs.' },
         },
         output: {
             schema: { type: 'string' },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-plugin-tool-management",
-  "version": "0.8.0",
-  "description": "DSH plugin: one settings panel for MCP servers, Skills, AGENTS.md presets, archived sessions and scene memories — plus scene memory injected into the system prompt and one-shot persona subagents. Settings UI + HTTP API + 14 model tools (skill_mcp_manager_*, skill_manager_*, agentsmd_*, rule_manager_*, subagent_*). Install with one command: dsh plugin --profile web add dsh-plugin-tool-management@latest",
+  "version": "0.9.0",
+  "description": "DSH plugin: one settings panel for MCP servers, skills, scenes, memories, subagents, AGENTS.md presets and archived sessions — scene memory injects into the system prompt, scene lock freezes all five domains, deleted workspaces re-register with one click. Settings UI + HTTP API + 14 model tools (mcp_manager_*, skill_manager_*, prompt_manager_*, memory_manager_*, subagent_*). Install with one command: dsh plugin --profile web add dsh-plugin-tool-management@latest",
   "repository": {
     "type": "git",
     "url": "https://github.com/ouli-1242/dsh-plugin-tool-management"
@@ -41,7 +41,8 @@
     "check:host": "node scripts/host-deps.mjs && node scripts/doctor.mjs",
     "host-deps": "node scripts/host-deps.mjs --fix",
     "doctor": "node scripts/doctor.mjs",
-    "test": "npm run build && npm run check:i18n && node --test test/archive.test.mjs test/import.test.mjs test/approval-policy.test.mjs test/subagent-scene.test.mjs test/subagent-persona.test.mjs test/hub-layout.test.mjs test/skills-state.test.mjs test/skills-delete.test.mjs test/skills-source-remove.test.mjs test/client-exports.test.mjs test/client-render.test.mjs test/compat-probe.test.mjs test/compat-fallback.test.mjs test/preset-reach.test.mjs test/rules-toggle-args.test.mjs"
+    "test": "npm run build && npm run check:i18n && node --test test/client-exports.test.mjs test/client-render.test.mjs",
+    "sync:profile": "node scripts/sync-profile.mjs"
   },
   "keywords": [
     "dsh",
@@ -66,12 +67,14 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-tools": ">=0.1.5-rc.2 <0.2.0-0",
-    "@deepseek-ai/dsh-workspace": ">=0.1.5-rc.2 <0.2.0-0",
-    "@deepseek-ai/dsh-spill-local": ">=0.1.5-rc.2 <0.2.0-0",
-    "@deepseek-ai/dsh-session-projection-cache": ">=0.1.5-rc.2 <0.2.0-0",
-    "@deepseek-ai/dsh-storage-domain": ">=0.1.5-rc.2 <0.2.0-0",
-    "@deepseek-ai/dsh-subagent-spawn-in-process": ">=0.1.5-rc.2 <0.2.0-0",
+    "@deepseek-ai/dsh-llm": ">=0.1.5-rc.2",
+    "@deepseek-ai/dsh-session": ">=0.1.5-rc.2",
+    "@deepseek-ai/dsh-session-projection-cache": ">=0.1.5-rc.2",
+    "@deepseek-ai/dsh-spill-local": ">=0.1.5-rc.2",
+    "@deepseek-ai/dsh-storage-domain": ">=0.1.5-rc.2",
+    "@deepseek-ai/dsh-subagent-spawn-in-process": ">=0.1.5-rc.2",
+    "@deepseek-ai/dsh-tools": ">=0.1.5-rc.2",
+    "@deepseek-ai/dsh-workspace": ">=0.1.5-rc.2",
     "react": "^18.2.0"
   },
   "peerDependenciesMeta": {
@@ -81,6 +84,8 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-llm": "^0.1.5-rc.2",
+    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-session-projection-cache": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-spill-local": "^0.1.5-rc.2",
     "@deepseek-ai/dsh-storage-domain": "^0.1.5-rc.2",

package/screenshots.json

@@ -1,10 +1,10 @@
 [
-  "docs/images/1场景.png",
-  "docs/images/2MCP.png",
-  "docs/images/3技能.png",
-  "docs/images/4子智能体.png",
-  "docs/images/5提示词.png",
-  "docs/images/6记忆.png",
-  "docs/images/7会话.png",
-  "docs/images/8兼容.png"
+  "docs/images/1.png",
+  "docs/images/2.png",
+  "docs/images/3.png",
+  "docs/images/4.png",
+  "docs/images/5.png",
+  "docs/images/6.png",
+  "docs/images/7.png",
+  "docs/images/8.png"
 ]

package/lib/prompt-sections.js

@@ -1,148 +0,0 @@
-// dsh-plugin-tool-management —— systemPrompt 段注册（通用骨架）。
-//
-// 本模块是「把插件状态投影为 system prompt 段（自动在场）」的**唯一实现**。
-// 场景记忆段（src/rules/service.ts）、子智能体人设段、MCP 状态段
-// （src/index.ts）都经它注册，避免每个域各抄一份 scope 遍历逻辑。
-//
-// 官方接口语义（@deepseek-ai/dsh-system-prompt）：
-//   - `section({ name, order, text })` 在**调用者的 scope** 注册；scoped 段遮蔽同名全局段。
-//   - `text` 可以是**每次装配时求值的 provider 函数** → 切换启用状态后**下一个请求即生效**，
-//     无需重开会话、无需重载插件。
-//   - `renderPrompt` 会**删除空段** → 无内容时返回 `''`，不产生空标题、零 token 成本。
-//
-// 为什么每个段都注册两处（全局 + per-agent）：
-//   全局注册覆盖所有 agent（含子 agent）；per-agent 注册保证即使插件 ctx 自带 scope
-//   （全局段对某些 agent 不可见）也能命中 —— 两者同名，scoped 遮蔽全局，不会重复注入。
-//
-// 缓存契约（§5.2）：段文本必须**会话级恒定**（只由持久化配置与文件内容决定），
-// 因此前缀逐字节稳定 → 前缀缓存可命中；**禁止**在段里放时间戳/计数/相对时间。
-// 异步数据源（人设目录、MCP 清单）走 stale-while-revalidate：`text()` 同步返回缓存值，
-// 由调用方在写操作后触发重算，绝不在 `text()` 里发起 IO。
-const GLOBAL_KEY = '@global';
-/** 复合 key 的分隔符：NUL 不会出现在 agent id 或段名里。 */
-const KEY_SEP = '\u0000';
-/** 取 scope 上的 systemPrompt 服务（Cordis 的 ctx.get 可能抛错，全部吞掉）。 */
-function systemPromptOf(scope) {
-    if (!scope)
-        return undefined;
-    try {
-        if (typeof scope.get === 'function')
-            return scope.get('systemPrompt');
-        return scope.systemPrompt;
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * 注册一组 systemPrompt 段：全局 scope + 每个活动 agent 的 scope。
- *
- * 任一 scope / 任一段注册失败都只降级为"该段不注入"，不影响其余段与其余 scope。
- */
-export function createPromptSectionRegistrar(ctx, sections) {
-    const registrations = new Map();
-    const install = (scope, scopeKey) => {
-        if (!scope)
-            return;
-        const systemPrompt = systemPromptOf(scope);
-        if (!systemPrompt || typeof systemPrompt.section !== 'function')
-            return;
-        for (const spec of sections) {
-            const key = scopeKey + KEY_SEP + spec.name;
-            if (registrations.has(key))
-                continue;
-            try {
-                const dispose = systemPrompt.section({
-                    name: spec.name,
-                    order: spec.order,
-                    // 每次装配重读 → 切换启用状态后下一个请求即生效。
-                    // 包一层箭头函数：spec.text 自身若被替换（热更新）也能跟上。
-                    text: () => spec.text(),
-                });
-                registrations.set(key, { scope, dispose: typeof dispose === 'function' ? dispose : () => { } });
-            }
-            catch (e) {
-                // 同层重名注册会抛错：降级为"该段不注入"，不影响其余 scope 与其余段。
-                console.error(`[dsh-plugin-tool-management] ${spec.name} section registration failed:`, String((e && e.message) || e));
-            }
-        }
-    };
-    const uninstall = (scopeKey) => {
-        const prefix = scopeKey + KEY_SEP;
-        for (const key of [...registrations.keys()]) {
-            if (!key.startsWith(prefix))
-                continue;
-            const entry = registrations.get(key);
-            registrations.delete(key);
-            try {
-                entry?.dispose();
-            }
-            catch { /* ignore */ }
-        }
-    };
-    // ① 全局：插件 ctx 的 scope（覆盖所有 agent）
-    install(ctx, GLOBAL_KEY);
-    // ② per-agent：与既有 install/uninstall 生命周期一致（agent/created、agent/disposed）
-    const on = ctx && ctx.on;
-    let stopCreated;
-    let stopDisposed;
-    if (typeof on === 'function') {
-        stopCreated = on('agent/created', (payload) => {
-            const agent = payload && payload.agent;
-            if (agent && agent.id != null)
-                install(agent.ctx, String(agent.id));
-        });
-        stopDisposed = on('agent/disposed', (payload) => {
-            const agent = payload && payload.agent;
-            if (agent && agent.id != null)
-                uninstall(String(agent.id));
-        });
-    }
-    // 已存在的 agent（插件热加载场景）：补注册。
-    try {
-        const agents = typeof ctx.get === 'function' ? ctx.get('agents') : undefined;
-        if (agents && typeof agents.list === 'function') {
-            for (const agent of agents.list()) {
-                if (agent && agent.id != null)
-                    install(agent.ctx, String(agent.id));
-            }
-        }
-    }
-    catch { /* agents 服务不可用 → 仅靠事件 */ }
-    return {
-        invalidate: () => {
-            for (const entry of registrations.values()) {
-                try {
-                    entry.scope?.emit?.('system-prompt/change');
-                }
-                catch { /* 宿主无该事件 → 忽略 */ }
-            }
-        },
-        dispose: () => {
-            if (typeof stopCreated === 'function')
-                stopCreated();
-            if (typeof stopDisposed === 'function')
-                stopDisposed();
-            for (const key of [...registrations.keys()]) {
-                const entry = registrations.get(key);
-                registrations.delete(key);
-                try {
-                    entry?.dispose();
-                }
-                catch { /* ignore */ }
-            }
-        },
-    };
-}
-/**
- * 官方 `SECTION_ORDERS` 里 2901–4999 是空档，本插件的段全部落在该区间。
- * 数值本身无外部含义，只决定同一次装配里的相对顺序（小在前）。
- */
-export const SECTION_ORDER = {
-    /** 场景记忆（rules 服务）。 */
-    sceneMemory: 3000,
-    /** 子智能体人设目录。 */
-    subagents: 3010,
-    /** MCP 服务器状态与用户备注。 */
-    mcpState: 3020,
-};