dsh-bare-preset 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-bare-preset contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,37 @@
-# Temporary Holding Version
+# dsh-bare-preset
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+「裸模模式」agent 预设，做成一个**插件**（自己向 `agentPresets` 注册），顺手把宿主强加给 agent 的运行时开销一并剪掉。
+
+## 为什么不用预设目录 + bundle patch
+
+那些坑都踩过：bundle patch 里的行要注册进 registry，而 registry 用它**自己的** baseUrl 解析相对路径（`./persona-file.mjs` 直接 import 失败，预设从选择器里消失）；`id` 必须是字符串；声明归属还要和「预设工作台」的运行时声明抢所有权。
+
+现在这个包自己做主：激活时 `presets.register()`，卸载时注销。组合里的提示词行用包内绝对 file URL，没有任何路径歧义。
+
+## 剪掉的三层
+
+| 层 | 谁加的 | 手段 | 省 |
+|---|---|---|---|
+| 系统提示词 | — | 人设行 `complete: true` + 空文本，`suppressRuntimeContext()` | 全部 |
+| 全局工具 | 宿主各插件 | `tools.restrict({ allow: [] })`（persona 行） | 全部 |
+| agent 作用域工具（Agent Teams 9 个） | `tool-agent-team` 用 `agent.ctx` 注册 | 把注册对象的 `when` 换成恒假，`resolve()` 的 admit 阶段剔除 | ~1.5K token |
+| `team:identity`、`working-directory:current` | 同上 / `working-directory` | `required` 翻 false（全局那条在本层放 `required:false` 的影子） | ~90 token |
+
+最后一项全部滤掉后，`joinContextSections([])` 是空串，`project()` 返回 `undefined`，那条 runtime-context user 消息整条不出现。注意**不能**在 `agent/pre-step` 里删它 —— agent-loop 在 append 之前会 `refreshContext` + `project` 重新算一遍，删的和追加的不是同一份。
+
+## 开关
+
+`lib/index.js` 顶部：
+
+- `PRUNED_TOOL_NAMES` —— 要剪掉的 agent 作用域工具（默认是 Agent Teams 那 9 个，清空数组即可保留）
+- `SUPPRESSED_CONTEXTS` —— 要滤掉的 runtime context 名（清空即保留 cwd / 团队身份）
+- `noTools`（组合里 persona 行的 config）—— 关掉就不做全局工具 restrict
+
+## 预期效果
+
+同一 profile 下 `standard` 会话首步约 19K token；本预设约 **15–20 token**（你的那句话 + 服务端角色标记）。输出 token 不算在内 —— 那是模型自己想的。
+
+## 备注
+
+- `tools.restrict` / `when` / `required` 三处都是改注册对象本身（registry 返回的是真身，不是副本），不落盘；插件重载后由 `agent/created` 与 `turn/start` 重新施加。DSH 升级若改了内部结构，表现是"工具/上下文又冒出来"，不会崩。
+- 预设 id 是 `bare`。

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: bare-preset
+      name: dsh-bare-preset

package/lib/index.js

@@ -0,0 +1,231 @@
+/**
+ * bare-preset（宿主）—— 把「裸模模式」这个 agent 预设置成一个插件。
+ *
+ * 为什么不再用预设目录 + bundle patch：
+ *
+ *   • bundle patch 里的行要注册进 registry，registry 挂载时用的是它自己的
+ *     baseUrl，`./persona-file.mjs` 这类相对路径解析不到（而写死绝对路径又
+ *     绑死目录）；另外 id 必须是字符串、声明归属还要和「预设工作台」的运行时
+ *     声明抢所有权 —— 这一串坑都踩过了。
+ *   • 现在这个包自己做主：激活时直接 `agentPresets.register()`，卸载时注销；
+ *     组合里的提示词行用包内子路径 `dsh-bare-preset/persona`，由 node 自己解析，
+ *     没有任何相对路径问题。
+ *
+ * 顺带一件事：`tools.restrict()` 只裁「继承来的」全局工具，而 Agent Teams 用
+ * `const scoped = agent.ctx` 把 9 个团队工具注册进 agent 自己那一层，按设计不受
+ * restrict 约束、也不能同名遮蔽（同层 duplicate）。但 `view().registrations` 给出
+ * 的是注册表里的真身（不是副本）：把它的 `when` 换成恒假，`resolve()` 在 admit
+ * 阶段就会整个剔除 —— wire 上没有、系统提示的工具目录里也没有。
+ *
+ * 这个剪裁只对本预设的 agent 生效，其他会话（含团队协作）一点都不受影响。
+ */
+
+export const name = 'bare-preset'
+
+/** 预设注册表（必需）；tools / agents 由内层 inject 按可选依赖处理。 */
+export const inject = ['agentPresets']
+
+/** 预设 id。 */
+const PRESET_ID = 'bare'
+
+/** 本预设要剪掉的「agent 作用域工具」——目前就是 Agent Teams 那一套。 */
+const PRUNED_TOOL_NAMES = [
+  'spawn_teammate',
+  'list_agents',
+  'send_message',
+  'wait_agent',
+  'interrupt_agent',
+  'team_task_create',
+  'team_task_get',
+  'team_task_list',
+  'team_task_update',
+]
+
+/**
+ * 要让这个预设"看不到"的 runtime context 名字。
+ *
+ * `team:identity` 由 tool-agent-team 注册进 agent 本层；`working-directory:current`
+ * 由 working-directory 注册在全局层。把本层的条目标成 `required: false`（全局那条
+ * 则在本层放一个 required:false 的影子），装配末尾的
+ * `contexts.filter(entry => requiredContexts.has(entry.name))` 就会把它们整条丢掉。
+ *
+ * 为什么不能像工具那样在 `agent/pre-step` 里事后删消息：agent-loop 在真正 append
+ * 之前会**重新算一遍**（`refreshContext` + `runtimeContext.project`），所以那条
+ * runtime-context 消息根本不是 pre-step 里能摘掉的那一份。必须在装配阶段让它为空。
+ */
+const SUPPRESSED_CONTEXTS = ['team:identity', 'working-directory:current']
+
+/** 恒假的 admit 条件；同一个函数对象也用来做幂等标记。 */
+const DENIED = function () {
+  return false
+}
+
+/** 提示词行的绝对 file URL（组合里的行由 registry 在它自己的 baseUrl 下加载）。 */
+const PERSONA_URL = new URL('../persona.mjs', import.meta.url).href
+
+/** 交给 registry 的预设声明。 */
+const DEFINITION = {
+  id: PRESET_ID,
+  name: '裸模模式',
+  description: '没有任何系统提示词，也看不到任何工具——只剩你说的话和模型本身。想观察模型的原生行为，或当作「从零开始」的底板。',
+  order: 6,
+  plugins: [
+    {
+      id: 'persona',
+      name: PERSONA_URL,
+      config: {
+        complete: true,
+        includeRuntimeContext: false,
+        noTools: true,
+      },
+    },
+    {
+      // 长对话压缩：与 standard / bare 模板同一套栈，避免上下文无限增长。
+      id: 'compaction',
+      name: 'cordis:group',
+      group: true,
+      isolate: {
+        compaction: true,
+      },
+      config: [
+        { id: 'compaction-basic', name: '@deepseek-ai/dsh-compaction-basic' },
+        { id: 'command-compact', name: '@deepseek-ai/dsh-command-compact' },
+      ],
+    },
+  ],
+}
+
+/**
+ * @param ctx - 宿主插件上下文。
+ */
+export function apply(ctx) {
+  const presets = ctx.agentPresets
+  if (presets === undefined) return
+
+  // ── 1. 注册预设（卸载时注销）──────────────────────────────────────────
+  ctx.effect(() => {
+    let alive = true
+    let dispose
+    Promise.resolve()
+      .then(() => presets.register(DEFINITION))
+      .then((undo) => {
+        if (alive) {
+          dispose = undo
+          return
+        }
+        try { Promise.resolve(undo()).catch(() => {}) } catch (_) { /* ignore */ }
+      })
+      .catch((error) => {
+        try {
+          ctx.logger.warn('bare-preset: register failed: ' + (error && error.message ? error.message : String(error)))
+        } catch (_) { /* ignore */ }
+      })
+    return () => {
+      alive = false
+      if (typeof dispose !== 'function') return
+      try { Promise.resolve(dispose()).catch(() => {}) } catch (_) { /* ignore */ }
+    }
+  }, 'bare-preset.register()')
+
+  // ── 2. 剪掉别人塞进 agent 作用域的工具与团队身份行 ──────────────────────
+  ctx.inject(['tools', 'agents', 'systemPrompt'], (sctx) => {
+    const tools = sctx.get('tools')
+    const agentSvc = sctx.get('agents')
+    const prompt = sctx.get('systemPrompt')
+    if (tools === undefined || agentSvc === undefined) return
+
+    const isBare = function (agent) {
+      try {
+        return String(presets.composedPreset(agent.ctx) || '') === PRESET_ID
+      } catch (_) {
+        return false
+      }
+    }
+
+    const prune = function (agent) {
+      if (agent === undefined || agent === null) return
+      if (!isBare(agent)) return
+      let view
+      try { view = tools.view(agent) } catch (_) { return }
+      for (const toolName of PRUNED_TOOL_NAMES) {
+        const registration = view.registrations.get(toolName)
+        if (registration === undefined || registration.when === DENIED) continue
+        registration.when = DENIED
+      }
+      suppressContexts(agent)
+    }
+
+    /** 已经在本层放过影子的 context 名（WeakMap<agent, Set<name>>）。 */
+    const shadowedContexts = new WeakMap()
+
+    /**
+     * 让本 agent 的装配结果里不再出现 SUPPRESSED_CONTEXTS 列出的 runtime context。
+     *
+     * - `team:identity` 由 tool-agent-team 注册在 **agent 本层**：直接把 required 翻 false；
+     * - `working-directory:current` 注册在 **全局层**：不能全局改（会波及所有会话），
+     *   于是在 agent 本层放一个 `required: false` 的影子 —— merge 时本层优先，
+     *   装配末尾 `requiredContexts.has(name)` 就不认它了，working-directory 那条
+     *   assemble 监听器事后补回去的贡献同样会被这一步滤掉。
+     *
+     * 全部被滤掉后，`joinContextSections([])` 得到空串，`project()` 在"从没有过快照"
+     * 的会话里直接返回 undefined —— 那条 runtime-context user 消息就不会出现。
+     */
+    const suppressContexts = function (agent) {
+      const layers = prompt === undefined ? undefined : prompt.layers
+      if (layers === undefined || !(layers.scoped instanceof Map)) return
+      let layer
+      try { layer = layers.peek(agent) } catch (_) { return }
+
+      for (const contextName of SUPPRESSED_CONTEXTS) {
+        const own = layer === undefined || layer.contexts === undefined
+          ? undefined
+          : layer.contexts.get(contextName)
+        if (own !== undefined) {
+          if (own.required !== false) own.required = false
+          continue
+        }
+        const globalEntry = layers.global === undefined || layers.global.contexts === undefined
+          ? undefined
+          : layers.global.contexts.get(contextName)
+        if (globalEntry === undefined) continue
+        let done = shadowedContexts.get(agent)
+        if (done === undefined) {
+          done = new Set()
+          shadowedContexts.set(agent, done)
+        }
+        if (done.has(contextName)) continue
+        done.add(contextName)
+        const actx = agent.ctx
+        if (actx === undefined || actx === null || actx.systemPrompt === undefined) continue
+        actx.effect(() => actx.systemPrompt.context({
+          ...globalEntry,
+          required: false,
+          text: '',
+        }), 'bare-preset.shadowContext(' + contextName + ')')
+      }
+    }
+
+    const pruneAll = function () {
+      let list = []
+      try { list = agentSvc.list() } catch (_) { return }
+      for (const agent of list) prune(agent)
+    }
+
+    pruneAll()
+
+    // 团队工具也挂在 agent/created 上安装：等同步监听器跑完再剪，再补一刀延时兜底。
+    sctx.on('agent/created', function (event) {
+      const agent = event && event.agent
+      queueMicrotask(function () { prune(agent) })
+      setTimeout(function () { prune(agent) }, 120)
+    })
+
+    // 最稳的一刀：turn/start 一定早于本次 step 的 tools.resolve()。
+    sctx.on('session/event', function (subject, event) {
+      if (event === undefined || event.type !== 'turn/start') return
+      let agent
+      try { agent = agentSvc.get(subject.id) } catch (_) { return }
+      prune(agent)
+    })
+  })
+}

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "dsh-bare-preset",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "裸模模式：把「空系统提示词 + 零工具 + 零运行时上下文」这个 agent 预设置成一个插件 —— 自己向 agentPresets 注册，并剪掉宿主塞进 agent 作用域的工具与上下文。",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./persona": "./persona.mjs",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "persona.mjs",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DDDMUC/dsh-bare-preset.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "keywords": [
+    "dsh",
+    "preset",
+    "agent-preset",
+    "bare",
+    "minimal-prompt"
+  ],
+  "dsh": {
+    "engines": {
+      "dsh": ">=0.2.2-rc.1"
+    },
+    "bundle": {
+      "patch": "cordis.patch.yml"
+    }
+  }
+}

package/persona.mjs

@@ -0,0 +1,42 @@
+/**
+ * bare-persona —— 裸模模式唯一的一条提示词行。
+ *
+ * 两件事：
+ *
+ * 1. 人设：用一个 `complete: true` 的空段落独占系统提示词，并关掉运行时快照，
+ *    于是渲染出来的系统消息是零个 content block —— 也就是"没有系统提示词"。
+ *
+ * 2. 工具表：`tools.restrict({ allow: [] })` 把继承来的（宿主/全局）工具全挡掉。
+ *    注意它管不到"注册进 agent 自己那一层"的工具（如 Agent Teams 的 9 个），
+ *    那部分由本包的宿主插件 lib/index.js 在每个 agent 创建/每轮开始前剪掉。
+ *
+ * 配置项（组合里传）：complete / includeRuntimeContext / noTools / text。
+ */
+
+export const name = 'bare-persona'
+
+/** 提示词注册表 + 工具视图。 */
+export const inject = ['systemPrompt', 'tools']
+
+/**
+ * @param ctx - 该预设的 agent 作用域。
+ * @param config - complete、includeRuntimeContext、noTools、text。
+ */
+export function apply(ctx, config = {}) {
+  const text = String(config.text ?? '')
+  const complete = config.complete ?? true
+  const includeRuntimeContext = config.includeRuntimeContext ?? false
+  const noTools = config.noTools ?? true
+
+  ctx.effect(() => ctx.systemPrompt.section({
+    name: 'deployment:persona',
+    order: 0,
+    text,
+    ...(complete ? { complete: true } : {}),
+  }), 'bare-persona.section()')
+
+  if (!includeRuntimeContext) ctx.systemPrompt.suppressRuntimeContext()
+
+  // 空 allow = 这个作用域看不到任何继承来的工具；本作用域自己注册的不受影响。
+  if (noTools) ctx.effect(() => ctx.tools.restrict({ allow: [] }), 'bare-persona.restrict()')
+}