dsh-plugin-prompt-tool 0.7.2 → 0.8.0

package/preset/pt-cordis/skills/cordis-plugin-development/references/verification.md

@@ -0,0 +1,5 @@
+# Verify in the available environment
+
+Prefer the authenticated page already connected to Harness. Do not launch a separate browser from shell commands, change `HOME`, inspect personal browser profiles, search for authentication tokens, or alter keychains to obtain a screenshot. For a visual-only request without browser control, limit verification to JavaScript syntax, manifest validation, and the live Client slot, then report that visual verification remains unavailable. Before or after installation, do not search for rasterizers, invoke Quick Look, extract SVG into preview files, emulate React/DOM, or implement a custom renderer to compensate for missing browser control. A screenshot of a mock page is not verification of the running plugin.
+
+For any test subprocess or temporary resource, use a unique owned directory, bound execution, and await cleanup. A failed optional preview must not turn into environment repair or block installation.

package/preset/pt-cordis/skills/cordis-plugin-development/templates/decoration/client.js

@@ -0,0 +1,22 @@
+window.__ModuleLoader__.load({
+  id: '@local/my-decoration',
+  factory(require) {
+    const React = require('react');
+    const h = React.createElement;
+    function Decoration() {
+      return h('svg', {
+        viewBox: '0 0 64 64', width: 48, height: 48,
+        'aria-hidden': true,
+        style: { display: 'block', pointerEvents: 'none' },
+      }, h('circle', { cx: 32, cy: 32, r: 24, fill: '#247bbf' }));
+    }
+    return {
+      inject: ['slots'],
+      apply(ctx) {
+        ctx.slots.inject('conversation.composer.dock', () => ctx.slots.register({
+          name: 'conversation.composer.dock', id: 'my-decoration', order: 5,
+        }, Decoration));
+      },
+    };
+  },
+});

package/preset/pt-cordis/skills/cordis-plugin-development/templates/decoration/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: my-decoration
+      name: '@local/my-decoration'

package/preset/pt-cordis/skills/cordis-plugin-development/templates/decoration/index.js

@@ -0,0 +1,2 @@
+/** Host half of the decoration bundle; the Client module owns the rendering. */
+export function apply() {}

package/preset/pt-cordis/skills/cordis-plugin-development/templates/decoration/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@local/my-decoration",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "exports": { ".": "./index.js", "./client": "./client.js" },
+  "dsh": {
+    "bundle": { "patch": "./cordis.patch.yml" },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": ["@deepseek-ai/dsh-client-ui-conversation"]
+    }
+  }
+}

package/preset/pt-cordis/skills/cordis-plugin-development/templates/mcp/cordis.patch.yml

@@ -0,0 +1,8 @@
+- insert:
+    - id: demo-mcp
+      name: '@deepseek-ai/dsh-mcp-client'
+      config:
+        serverName: demo
+        transport: streamable-http
+        url: http://127.0.0.1:3000/mcp
+        failOnStartupError: true

package/preset/pt-cordis/skills/cordis-plugin-development/templates/mcp/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "@local/demo-mcp",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "dsh": { "bundle": { "patch": "./cordis.patch.yml" } }
+}

package/preset/pt-cordis/skills/editing-cordis-compositions/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: editing-cordis-compositions
+description: Use when creating, changing, or validating an agent preset or other Cordis composition for this harness, including deciding host versus preset placement and checking that an authored preset mounts.
+---
+
+# Editing Cordis compositions
+
+Agent presets are ordinary `@deepseek-ai/dsh-agent-preset` declarations carried by bundle patches. Nothing edits a declaration in place: a preset is created or changed by installing a bundle whose patch declares or overrides it. This file states the declaration format; when it leaves a question open, read the `@deepseek-ai/dsh-agent-preset` README and `lib/types` declarations under the `packageDir` that `cordis_inspect_query` `Config.listConfigs` returns when queried with a `preset-<id>` row's `entry` id, or `packages/preset/agent-preset/src` in a source checkout.
+
+## Where declarations live
+
+The shipped Web presets are `presets/<id>.patch.yml` files of the `@deepseek-ai/dsh-web-app` bundle, ids `standard`, `ptc`, `minimal` and `cordis`. Installed, the bundle resolves from the dsh installation, not the profile; querying `Config.listConfigs` with the `entry` id of any `preset-<id>` row it declares returns that `packageDir`. In a source checkout of DSH it is `packages/bundle/web-app/`. Read one file with the file-read tool when you need a template; `minimal.patch.yml` is the shortest. In Desktop the bundle sits inside `app.asar`, which shell commands cannot open. Load `cordis-composition-reference` for the patch dialect and the list of plugin packages a preset can mount.
+
+A declaration row has these `config` fields: `id` (required, lowercase letters, digits and hyphens), `plugins` (required Cordis entry list), and optional `name`, `description` and `order` (roster position). The Loader row `id` is `preset-<id>` by convention.
+
+## Create a preset
+
+Write a bundle directory in the workspace with exactly two files, then install it.
+
+`review-preset/package.json`:
+
+```json
+{
+  "name": "@local/dsh-review-preset",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "dsh": { "bundle": { "patch": "./cordis.patch.yml" } }
+}
+```
+
+`review-preset/cordis.patch.yml`:
+
+```yaml
+- insert:
+    - id: preset-review
+      name: '@deepseek-ai/dsh-agent-preset'
+      config:
+        id: review
+        name: Review
+        description: Reviews changes with the shell only.
+        order: 10
+        plugins:
+          - id: persona
+            name: '@deepseek-ai/dsh-persona'
+            config:
+              prefix: You review software changes.
+          - id: tool-bash
+            name: '@deepseek-ai/dsh-tool-bash'
+```
+
+Install with `plugin_manager`, `action: install_bundle`, `target` set to the absolute bundle directory. It runs package installation and bundle selection itself; do not reproduce those steps with shell commands.
+
+## Change a shipped preset
+
+Override the declaration by its Loader row id instead of inserting. The override replaces the complete `config`, so restate `id`, `plugins` and every other field the shipped file carries:
+
+```yaml
+- id: preset-standard
+  name: '@deepseek-ai/dsh-agent-preset'
+  config:
+    id: standard
+    order: 1
+    plugins:
+      # the shipped list with your changes
+```
+
+## Migrate a legacy preset
+
+Before declaration rows, a user preset was a directory `$DSH_HOME/.agent-presets/<id>/` holding `preset.yml` (display `name`, `description`, `order`) and `agent.cordis.yml` (the plugin entry list). Nothing reads that directory any more. To migrate one, create a bundle as above whose declaration takes `id` from the directory name, `name`, `description`, and `order` from `preset.yml`, and `plugins` from `agent.cordis.yml` verbatim; check each plugin name against `cordis-composition-reference` because packages renamed since the preset was written fail at activation. Install it, verify the row, then delete the legacy directory.
+
+## Verify
+
+`plugin_manager` `list_bundles` lists the installed bundle; `list_plugins` shows the `preset-<id>` row with its activation state. A declaration whose activation fails stays on the roster with its diagnostic and cannot compose a session until the bundle is fixed and reinstalled. Existing sessions and their children keep the plugin revision they started with; validate changed behavior in a new session. Installing a bundle executes plugin code in the Host process, so it requires Full access or approval.
+
+## Choose plugin placement
+
+Host plugins supply shared services: tools and prompt registries, the Agent loop, sessions, persistence, settings, sandbox policy, model routes, and subagent backends. Preset plugins contribute scoped tools, persona, prompt sections, and policies to those registries. Preset revisions are eagerly activated once and shared by their selecting Agents.
+
+A preset plugin that supplies a service must isolate the provider and all its consumers in the same realm. A service consumed by Host plugins belongs in the Host configuration. Scope controls contributions and event visibility; `isolate` controls service instances. Use ordinary Cordis groups for nested plugin lists. Keep `!!js` expressions only in plugin configuration or `disabled`; the Loader evaluates them when activating the child plugin. Resolve assets from installed packages rather than a preset directory.
+
+## Extend the Host
+
+For new plugin code or profile-wide capabilities, load `cordis-plugin-development`, author a workspace bundle, and install it with `plugin_manager`. Inspect available APIs through `cordis_inspect_list` and `cordis_inspect_query`, including a mounted plugin's Config schema through the Host `Config` provider; those tools do not invoke Remote methods. Verify the installed capability before reporting completion.

package/preset/pt-custom/preset.yml

@@ -0,0 +1,15 @@
+# 自定义预设：空白起点（所有参数为空，由引擎与 UI 默认值兜底）。
+# 新建时选择本模板得到一份可自由配置的用户预设；空模块清单生成空组合，
+# 参数、模块和提示词配置都由用户从 UI 按需添加。
+id: pt-custom
+name: 自定义预设
+description: 空白起点：所有参数为空，按需从 UI 配置。
+version: 1.0.0
+engineCompat: ">=0.4.2"
+modules: []
+layerSettings: {}
+# 空白起点不隐式装配任何提示词卡：需要时从 UI 添加。
+# 指令文件正文由独立指令来源（pre-step 协调器 + $DSH_HOME/.prompt-tool/instructions.yml）
+# 按会话现场解析，预设侧不再有 agentsHints 开关。
+promptConfigs: []
+legacyCleanup: []

package/preset/pt-minimal/preset.yml

@@ -0,0 +1,27 @@
+id: pt-minimal
+name: 极简模式
+description: 仅提供持久 shell 的单工具编码 Agent。
+version: 1.0.0
+engineCompat: ">=0.4.2"
+modules:
+  - persistent-shell
+  - prompt-config-engine
+persona:
+  prefix: You are a helpful software engineer assistant.
+  complete: true
+  includeRuntimeContext: false
+promptConfigs: []
+layerSettings:
+  agent-request:
+    modelProvider: ""
+    modelName: ""
+    modelReasoningEffort: ""
+    modelTemperature: ""
+    modelMaxTokens: ""
+  subagent-start:
+    subagentModelProvider: ""
+    subagentModelName: ""
+    subagentReasoningEffort: ""
+    subagentTemperature: ""
+    subagentMaxTokens: ""
+    maxDepth: ""

package/preset/pt-ptc/preset.yml

@@ -0,0 +1,45 @@
+id: pt-ptc
+name: PTC 模式
+description: 功能完整的编码 Agent，但默认不提供 workflow 工具；其他工具通过 PTC 模式 SDK 呈现，让模型用一个
+  TypeScript 程序组合多步操作。
+version: 1.0.0
+engineCompat: ">=0.4.2"
+modules:
+  - agent-instructions
+  - tool-bash
+  - tool-pwsh
+  - tool-fs
+  - tool-fs-search
+  - tool-jobs
+  - skill-filesystem
+  - tool-skill
+  - command-goal
+  - tool-goal
+  - planning
+  - compaction
+  - delegation-ptc
+  - tool-ask-user
+  - tool-todo
+  - tool-web
+  - tool-presentation
+  - tool-present
+  - tool-plugin-manager-disabled
+  - prompt-config-engine
+persona:
+  suffix: Your working directory is {{cwd}}.
+  prefix: You are a coding agent powered by the {{model}} model.
+promptConfigs: []
+layerSettings:
+  agent-request:
+    modelProvider: ""
+    modelName: ""
+    modelReasoningEffort: ""
+    modelTemperature: ""
+    modelMaxTokens: ""
+  subagent-start:
+    subagentModelProvider: ""
+    subagentModelName: ""
+    subagentReasoningEffort: ""
+    subagentTemperature: ""
+    subagentMaxTokens: ""
+    maxDepth: ""

package/preset/pt-standard/preset.yml

@@ -0,0 +1,43 @@
+id: pt-standard
+name: 标准模式
+description: 功能完整的编码 Agent，支持文件编辑、Shell、文件与网页检索、Skills、计划、目标、子代理和工作流。
+version: 1.0.0
+engineCompat: ">=0.4.2"
+modules:
+  - agent-instructions
+  - tool-bash
+  - tool-pwsh
+  - tool-fs
+  - tool-fs-search
+  - tool-jobs
+  - skill-filesystem
+  - tool-skill
+  - command-goal
+  - tool-goal
+  - planning
+  - compaction
+  - delegation
+  - tool-ask-user
+  - tool-todo
+  - tool-web
+  - tool-present
+  - tool-plugin-manager-disabled
+  - prompt-config-engine
+persona:
+  suffix: Your working directory is {{cwd}}.
+  prefix: You are a coding agent powered by the {{model}} model.
+promptConfigs: []
+layerSettings:
+  agent-request:
+    modelProvider: ""
+    modelName: ""
+    modelReasoningEffort: ""
+    modelTemperature: ""
+    modelMaxTokens: ""
+  subagent-start:
+    subagentModelProvider: ""
+    subagentModelName: ""
+    subagentReasoningEffort: ""
+    subagentTemperature: ""
+    subagentMaxTokens: ""
+    maxDepth: ""

package/templates/14-first-turn-anchor.yml

@@ -1,6 +1,6 @@
 # 模板：首句锚点（strategy=first-turn-anchor）
 # 首条真实用户消息后按任务类型（build / inspect / deep）注入锚句，每会话一次。
-# 纯净模板：参数全部留空，由用户自定义；默认锚句与正则见 anchored 预设 params。
+# 纯净模板：参数全部留空，由用户自定义；默认锚句与正则见引擎内置策略默认值。
 # 提示：把本文件放入 promptConfigsDir 目录，或把对象写入 settings.promptConfigs 数组。
 id: example-first-turn-anchor
 name: 示例：首句锚点
@@ -22,6 +22,6 @@ params:
   text: ""                  # 自定义锚文本（useCustom=true 时固定注入）
   buildPattern: ""      # 构建任务正则；留空 = 该分类不生效
   complexPattern: ""    # 复杂任务正则；留空 = 该分类不生效
-  firstTurnBuild: ""    # 构建任务锚句（示例见 anchored preset.yml params.firstTurnBuild）
-  firstTurnInspect: ""  # 排查任务锚句（示例见 anchored preset.yml params.firstTurnInspect）
-  firstTurnDeep: ""     # 复杂设计锚句（示例见 anchored preset.yml params.firstTurnDeep）
+  firstTurnBuild: ""    # 构建任务锚句（留空 = 引擎内置默认锚句）
+  firstTurnInspect: ""  # 排查任务锚句（留空 = 引擎内置默认锚句）
+  firstTurnDeep: ""     # 复杂设计锚句（留空 = 引擎内置默认锚句）

package/templates/15-guide-auto.yml

@@ -1,6 +1,6 @@
 # 模板：每轮引导（strategy=guide-auto）
 # 晋升后每轮用户消息后按复杂度注入弱/深度引导；modelScope=flash 表示仅 flash 模型会话注入。
-# 纯净模板：参数全部留空，由用户自定义；默认引导句文本见 anchored 预设 params。
+# 纯净模板：参数全部留空，由用户自定义；默认引导句文本见引擎内置策略默认值。
 # 提示：把本文件放入 promptConfigsDir 目录，或把对象写入 settings.promptConfigs 数组。
 id: example-guide-auto
 name: 示例：每轮引导
@@ -21,5 +21,5 @@ params:
   useCustom: false
   text: ""
   # 复杂任务判定 fallback 复用锚定卡的 complexPattern；留空 = 仅按文本长度 120 判定深/弱
-  guideWeak: ""             # 简单任务自动引导句（示例见 anchored preset.yml params.guideWeak）
-  guideDeep: ""             # 复杂任务自动引导句（示例见 anchored preset.yml params.guideDeep）
+  guideWeak: ""             # 简单任务自动引导句（留空 = 引擎内置默认引导句）
+  guideDeep: ""             # 复杂任务自动引导句（留空 = 引擎内置默认引导句）

package/templates/16-custom-fallback.yml

@@ -1,6 +1,7 @@
 # 模板：自定义锚词兜底注入（strategy=custom-fallback）
 # 首轮推理命中锚定确认词后注入一次；未命中最多两轮兜底。确认词集合 anchorWords 由
 # writePreset 从锚句自动派生（firstTurnWord 空时）；显式 firstTurnWord 覆盖派生。
+# 两者都为空 = 不做词确认，只走未命中兜底注入（引擎不内置确认词）。
 # 提示：把本文件放入 promptConfigsDir 目录，或把对象写入 settings.promptConfigs 数组。
 id: example-custom-fallback
 name: 示例：自定义锚词兜底注入

package/templates/18-placeholder-env-facts.yml

@@ -1,7 +1,7 @@
 # 模板：placeholder 动态填充位（fill 下拉可切换三种数据源）
 #   - env-facts（机器事实）：默认输出 Environment facts 列表；envKeys 白名单
 #   - skill-catalog（技能目录）：宿主 skills 服务（按 skillSwitches 过滤）；limit/fields/providers
-#   - instruction-hint（指令文件提示）：等价快捷写法 strategy=instruction-hint；
+#   - instruction-hint（指令文件提示）：fill=instruction-hint；
 #     promotion=include-subagents 子代理晋升后同样注入；sourceKind=instruction-hint + form=hint
 # 可用 text 模板 + {{变量}} 完全自定义。
 id: example-placeholder
@@ -14,9 +14,9 @@ promotion: include-subagents
 text: |-
   
 params:
-  envKeys: ""       # 环境变量白名单（逗号分隔）；留空 = 默认 DSH_HOME,DSH_WORKSPACE
+  envKeys: DSH_HOME,DSH_WORKSPACE  # 环境变量白名单（逗号分隔）；留空 = 只输出 CWD/WORKSPACE
   limit: 20         # skill-catalog：条目数上限
   fields: name,description  # skill-catalog：输出字段
   providers: ''     # skill-catalog：提供方过滤
   emptyBehavior: skip       # skill-catalog：空结果行为
-  emptyText: ""     # skill-catalog：emptyBehavior=text 时的提示；留空 = 空文本
+  emptyText: 当前没有可用技能。  # skill-catalog：emptyBehavior=text 时的提示；留空 = 不注入

package/templates/20-system-section.yml

@@ -1,6 +1,7 @@
 # 模板：system-section 静态 system 段（缓存友好，静态内容优先放这里）
-# order 参考：-100 身份 / 0 persona / 100-199 工具引导。
-# 人设用法：params.sectionName = deployment:persona 时注册为主会话人设段
+# order 参考：-100 身份 / 0 persona-prefix / 100-199 工具引导 / 10200 persona-suffix。
+# 人设用法：params.sectionName = deployment:persona-prefix（第一方指导之前）或
+# deployment:persona-suffix（第一方指导之后）时注册为人设段
 # （同名 shadow 全局 persona，模块列表显示「人设」徽标；子代理经 scope 链继承）。
 #   - complete: true 独占整个 system prompt（预设内互斥，UI 自动收敛，手写冲突官方 fail loud）
 #   - suppressRuntimeContext: true 抑制动态运行时快照（等价官方 includeRuntimeContext:false）

package/templates/65-turn-stop.yml

@@ -0,0 +1,18 @@
+# 模板：turn-stop 轮次停止层（命中条件时阻止本轮停止，强制模型续跑一步）
+# 接入：subject 缺省 assistantText（匹配最后一条 assistant 消息文本）；不写 match
+#       即无条件续跑。续跑上限固定在引擎内——每轮 1 次、每会话 3 次，配置关不掉。
+id: example-turn-stop
+name: 未完成时强制续跑
+layer: turn-stop
+strategy: static
+order: 0
+modelScope: all
+text: |-
+  上一轮还没有给出完整交付。请继续把当前任务做完：不要停在中途，
+  也不要用「接下来我会…」的计划代替实际执行。
+match:
+  keys:
+    - 接下来我会
+    - 稍后继续
+    - 待办如下
+params: {}

package/templates/66-subagent-start.yml

@@ -0,0 +1,14 @@
+# 模板：subagent-start 子代理启动层（向该子代理注入一条上下文）
+# 接入：subject 缺省 subagentInfo（事件载荷序列化文本，含子代理 id/runId）；不写
+#       match 即每个子代理都注入。载荷里没有稳定的角色名，按 id 筛选通常不实用——
+#       需要筛的时候再按实际 runId 补 match。
+id: example-subagent-start
+name: 子代理通用守则
+layer: subagent-start
+strategy: static
+order: 0
+modelScope: all
+text: |-
+  开始编辑之前，先确认你改的这条路径在运行时会真的被执行：查调用链，
+  或用探针跑一次看它动。找不到证据就继续查，不要凭「看起来像」就动手。
+params: {}

package/templates/75-subagent-end.yml

@@ -0,0 +1,15 @@
+# 模板：subagent-end 子代理结束层
+# 默认仅记录。将 params.action 改为 inject-main 并填写 text，
+# 通过官方 Agent.inject 向所属主会话投递上下文；不改写子代理结果、不唤醒空闲主会话。
+# 接入：subject 缺省 subagentInfo（事件载荷序列化文本，含子代理 id/runId）；不写 match
+#       即每个子代理结束都记录。载荷里没有稳定角色名，需要筛的时候按实际 runId 补 match。
+# 默认关闭：它只写日志，需要审计子代理收尾时再打开。
+id: example-subagent-end
+name: 子代理结束记录（只观察）
+enabled: false
+layer: subagent-end
+strategy: static
+order: 0
+modelScope: all
+params:
+  action: observe

package/templates/tools/10-shell-command.yml

@@ -1,7 +1,7 @@
 # 自定义工具模板：shell 命令执行器（{{args.x}} 参数插值；env 白名单；cwd=会话工作区）。
 id: shell-command
 name: my_shell
-description: 执行 shell 命令（参数经 {{args.*}} 插值）
+description: 执行 shell 命令（command 支持 {args.x} 模板插值）
 parameters:
   command:
     type: string

package/templates/tools/40-delegate-character.yml

@@ -1,5 +1,5 @@
 # 自定义工具模板：委托内置 character_list（自定义名称/描述/参数面；
-# 内置工具为插件固有注册，原工具仍可用）。
+# 保存该模板时自动装配 character-tools，原工具仍可用）。
 id: delegate-character-list
 name: my_character_list
 description: 查看角色卡库（委托内置工具）

package/templates/tools/50-delegate-worldbook.yml

@@ -1,5 +1,5 @@
 # 自定义工具模板：委托内置 world_book_list（自定义名称/描述/参数面；
-# 内置工具为插件固有注册，原工具仍可用）。
+# 保存该模板时自动装配 world-book-tools，原工具仍可用）。
 id: delegate-worldbook-list
 name: my_worldbook_list
 description: 查看当前预设的世界书条目（委托内置工具）

package/templates/tools/60-delegate-session-var.yml

@@ -1,5 +1,5 @@
 # 自定义工具模板：委托内置 session_var（自定义名称/描述/参数面；
-# 内置工具为插件固有注册，原工具仍可用）。
+# 保存该模板时自动装配 session-var-tools，原工具仍可用）。
 id: delegate-session-var
 name: my_session_var
 description: 会话变量管理（委托内置工具）

package/templates/tools/70-delegate-worldbook-upsert.yml

@@ -1,7 +1,7 @@
 # 自定义工具模板：委托内置 world_book_upsert（有参包装示例）。
 # 模型只见本模板声明的参数（name/content/keys），其余字段走 execute.args 固定映射：
 # constant/order/layer/position 由模板锁定——参数面 = 官方工具定义的 parameters 定制。
-# 内置工具为插件固有注册，原工具仍可用（delegate 仅自定义名称/描述/参数面）。
+# 保存该模板时自动装配 world-book-tools，原工具仍可用（delegate 仅自定义名称/描述/参数面）。
 id: delegate-worldbook-upsert
 name: my_worldbook_upsert
 description: 新增/更新一条世界书条目（委托内置工具，常驻注入）

package/engine/anchor-turn.mjs

@@ -1,68 +0,0 @@
-/**
- * anchor-turn — 在用户首条真实消息之前播种一个合成锚定轮（前置锚定）。
- *
- * 移植自 upstream dsh-anchored-standard shared/anchor-turn.mjs (MIT)：
- * 锚定消息 PREPEND 进 `next-turn` inbox 队列、排在真实消息之前；dsh 每轮
- * 只 claim 一条 next-turn 消息，所以首条模型请求 = 固定锚定提示（配合
- * 零工具模式时 = 空工具面上的 "we" 锚定），用户真实消息由下一轮 claim——
- * 彼时 bootstrap 已晋升、目录已开放。
- *
- * 与 near-anchor（first-turn-anchor 策略，消息级追加）正交：本模块是轮级
- * 前置（真实消息延后一轮），near-anchor 是首条真实用户消息后的同轮追加。
- *
- * 在首条消息前（而非会话创建时）锚定，保持空白会话的预设切换器可用。
- * 子代理默认跳过（其 brief 即计划）；includeSubagents: true 让子代理也
- * 走锚定轮。
- *
- * Durability 免费：prepend 经 `agent/inbox/spliced` 事件持久化，崩溃后
- * 队列按序恢复；inbox replay 不触发 `inserted` 通知，锚定永不重注入。
- *
- * Robustness：插件来源消息（含自身锚定）永不再次锚定。
- */
-
-import { booleanOption, validateConfig } from './shared.mjs'
-
-/** Cordis plugin name used by loader diagnostics. */
-export const name = 'anchor-turn'
-
-/** 默认锚定文本（合成首轮展示给模型）。 */
-export const ANCHOR_TEXT = 'This round is a test. Tools are not open yet; all tools will open next round.'
-
-/** Every config key this plugin accepts — anything else is a typo. */
-const ALLOWED_KEYS = new Set(['enabled', 'text', 'includeSubagents'])
-
-/** 全新会话（无任何历史 user/message）才锚定。 */
-function isFreshSession(agent, includeSubagents = false) {
-  if (!includeSubagents && (agent.session.header.delegationDepth ?? 0) > 0) return false
-  return !agent.session.events.some((event) => event.type === 'user/message')
-}
-
-/** 注册首消息锚定注入。 */
-export function apply(ctx, config) {
-  const source = validateConfig(name, config, ALLOWED_KEYS)
-  if (source.enabled === false) return
-  const text = typeof source.text === 'string' && source.text.length > 0
-    ? source.text
-    : ANCHOR_TEXT
-  const includeSubagents = booleanOption(name, source.includeSubagents, 'includeSubagents', false)
-
-  ctx.on('agent/inbox/inserted', ({ agent, message }) => {
-    if (agent?.session === undefined || agent?.inbox?.prepend === undefined) return
-    if (!isFreshSession(agent, includeSubagents)) return
-    // 插件来源消息（包括我们自己的锚定）永不再次锚定。
-    if (message?.source?.kind === 'plugin') return
-    agent.inbox.prepend('next-turn', {
-      id: typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function'
-        ? crypto.randomUUID()
-        : `anchor-turn-${Date.now()}-${Math.random().toString(36).slice(2)}`,
-      role: 'user',
-      content: [{ type: 'text', text }],
-      source: {
-        kind: 'plugin',
-        plugin: name,
-        form: 'notice',
-        summary: 'zero-tool anchor turn',
-      },
-    })
-  })
-}

package/engine/code-presentation.mjs

@@ -1,103 +0,0 @@
-/**
- * code-presentation - 晋升后 PTC mode wire 呈现。
- *
- * 从 tool-bootstrap 拆出的独立关注点：bootstrap 负责首轮工具目录窄化，
- * 本模块只负责晋升后把工具呈现切换为 PTC mode（单 run_code，由
- * tools.presentAs('ptc') 提供）。"只要 PTC 不要 bootstrap" = 组合只挂本行；
- * PTC+bootstrap = 同时挂两行（行序：tool-bootstrap 在前，本行在后）。
- *
- * 相位与 tool-bootstrap / context-gate 同源：epoch-aware promotion
- * （compaction-epoch.mjs）。晋升后（tool/call 或 assistant/message，按
- * promoteOn，默认 either）应用 PTC mode；compaction/end 释放（压缩后回到
- * 受控相位，重新晋升再应用）。
- *
- * SUBAGENTS: includeSubagents=false（默认）时子代理（delegationDepth > 0）
- * 首次请求即应用呈现（继承完整目录语义）；true 时子代理跟随主会话相位。
- *
- * Robustness: 应用/释放失败降级（绝不 brick 会话）；invalid config fail at
- * apply time，即 preset 挂载处可见可修。
- */
-
-import { createEpochPromotion } from './compaction-epoch.mjs'
-import { booleanOption, parsePromoteOn, validateConfig } from './shared.mjs'
-
-/** Cordis plugin name used by loader diagnostics. */
-export const name = 'code-presentation'
-
-/** 无 inject：监听器只在使用时触碰 ctx 服务（同 tool-bootstrap 纪律）。 */
-export const inject = []
-
-/** Every config key this plugin accepts — anything else is a typo. */
-const ALLOWED_KEYS = new Set(['usePtcMode', 'includeSubagents', 'promoteOn'])
-
-/** Register the post-promotion Code Mode presentation. */
-export function apply(ctx, config) {
-  const source = validateConfig(name, config, ALLOWED_KEYS)
-  // 默认 false：PTC mode 呈现是 opt-in，未声明 = 原生完整工具目录。
-  const usePtcMode = booleanOption(name, source.usePtcMode, 'usePtcMode', false)
-  if (!usePtcMode) return
-  const includeSubagents = booleanOption(name, source.includeSubagents, 'includeSubagents', false)
-  const promoteEvents = parsePromoteOn(name, source.promoteOn)
-  const promotion = createEpochPromotion(promoteEvents, { includeSubagents })
-
-  const presentationBySession = new WeakMap()
-  const agentBySession = new WeakMap()
-  const presentationState = (session) => {
-    let state = presentationBySession.get(session)
-    if (state === undefined) {
-      state = { applied: false, disposer: undefined }
-      presentationBySession.set(session, state)
-    }
-    return state
-  }
-  const applyCodePresentation = (agent) => {
-    const session = agent?.session
-    if (session === undefined) return
-    const state = presentationState(session)
-    if (state.applied) return
-    const tools = agent.ctx?.tools
-    if (tools === undefined || typeof tools.presentAs !== 'function') return
-    state.disposer = tools.presentAs('ptc')
-    state.applied = true
-  }
-  const releaseCodePresentation = (session) => {
-    const state = presentationBySession.get(session)
-    if (state === undefined) return
-    if (typeof state.disposer === 'function') {
-      try { state.disposer() } catch { /* never brick the session */ }
-    }
-    state.disposer = undefined
-    state.applied = false
-  }
-
-  ctx.on('session/event', (session, event) => promotion.observe(session, event))
-  ctx.on('session/event', (session, event) => {
-    if (event.type === 'compaction/end') {
-      releaseCodePresentation(session)
-      return
-    }
-    if (event.type !== 'step/end' && event.type !== 'turn/end') return
-    const agent = agentBySession.get(session)
-    if (agent !== undefined && promotion.status(agent).promoted) applyCodePresentation(agent)
-  })
-
-  ctx.on('system-prompt/assemble', async (_assembly, context, next) => {
-    // Downstream errors propagate untouched; only this filter's own logic is guarded.
-    const assembled = await next()
-    try {
-      const agent = context.agent
-      if (agent === undefined || agent.session === undefined) return assembled
-      agentBySession.set(agent.session, agent)
-      if ((agent.session?.header?.delegationDepth ?? 0) > 0 && !includeSubagents) {
-        // 默认：子代理继承完整目录 → 直接应用呈现。
-        applyCodePresentation(agent)
-        return assembled
-      }
-      if (promotion.status(agent).promoted) applyCodePresentation(agent)
-      return assembled
-    } catch {
-      // 呈现失败不阻断会话：保持原样。
-      return assembled
-    }
-  })
-}