@deepseek-ai/dsh 0.0.1-rc.1 → 0.0.1-rc.2

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write apps/cli/README.md
-README.md: 4fae5338a89ce12c2620e123530acf883ae9efff
-README.zh.md: a2d086b8ff12fb07f2446fc4162de09739bcdeab
+README.md: 98a856261bc632c97f350db8fc7bb0b10c22235d
+README.zh.md: 283e54138e24202ed6b88d1d309538c58cd66b3e

package/README.md

@@ -31,8 +31,8 @@ dsh --help                          # the launcher's own help
 
 A profile directory holds a `package.json` (out-of-tree plugin dependencies plus the profile manifest `dsh.profile` with its ordered `bundles` list) and a `cordis.patch.yml` (the user's own patch layer, hot-reloaded on long-lived surfaces). The tree composes over an empty root: each bundle's patch in `dsh.profile.bundles` order, then the profile's `cordis.patch.yml`, then the home-level `$DSH_HOME/cordis.patch.yml`, then `--patch` overlays. Bundles named in `dsh.profile.bundles` resolve from the dsh installation first (`@deepseek-ai/dsh-base`, `@deepseek-ai/dsh-web-app`, `@deepseek-ai/dsh-headless`), then from the profile's own `node_modules`, where pnpm installs out-of-tree plugins. Use `--dump-default-config` and `--dump-config` to inspect the composed tree without booting it.
 
-The [CLI behavior reference](reference/README.md) owns exact layer precedence, flags, shutdown behavior, deployment defaults, and the source launcher.
+The [CLI behavior reference](reference/README.md) owns exact layer precedence, flags, shutdown behavior, deployment defaults, and source execution.
 
 ## Development
 
-Production runs require built package and frontend artifacts. From a checkout, `pnpm run dsh` runs the TypeScript entry and forwards arguments; the [source-launcher reference](reference/README.md#source-launcher) describes the PATH symlink and module-resolution contract.
+Production runs require built package and frontend artifacts. From the repository root, `pnpm dsh <args...>` builds those artifacts, runs the TypeScript entry, and forwards every argument; the [source-execution reference](reference/README.md#source-execution) owns the module-resolution contract.

package/README.zh.md

@@ -31,8 +31,8 @@ dsh --help                          # the launcher's own help
 
 profile 目录包含一个 `package.json`（树外插件依赖，加上 profile manifest（元数据清单）`dsh.profile` 及其有序的 `bundles` 列表）和一个 `cordis.patch.yml`（用户自己的 patch 层，在长期运行的 surface 上热重载）。配置树在空根之上组合：先按 `dsh.profile.bundles` 顺序应用各组合包的 patch，然后是 profile 的 `cordis.patch.yml`，然后是 home 级的 `$DSH_HOME/cordis.patch.yml`，然后是 `--patch` overlay。`dsh.profile.bundles` 中列出的组合包先从 dsh 安装目录解析（`@deepseek-ai/dsh-base`、`@deepseek-ai/dsh-web-app`、`@deepseek-ai/dsh-headless`），再从 profile 自己的 `node_modules` 解析；pnpm 把树外插件安装在后者。使用 `--dump-default-config` 和 `--dump-config` 可在不启动的情况下检查组合后的配置树。
 
-[CLI（命令行界面）行为参考](reference/README.md)负责确切的层优先级、flag、关闭行为、部署默认值和源码启动器。
+[CLI（命令行界面）行为参考](reference/README.md)负责确切的层优先级、flag、关闭行为、部署默认值和源码执行。
 
 ## 开发
 
-生产运行需要已构建的包与前端产物。在 checkout 中，`pnpm run dsh` 会运行 TypeScript 入口并转发参数；[源码启动器参考](reference/README.md#source-launcher)说明 PATH 符号链接和模块解析契约。
+生产运行需要已构建的包与前端产物。从仓库根目录运行 `pnpm dsh <args...>` 会先构建这些产物，再运行 TypeScript 入口并转发所有参数；模块解析约定由[源码执行参考](reference/README.md#source-execution)负责。

package/config/agent-presets/code/agent.cordis.yml

@@ -129,17 +129,20 @@
 
 # `compact-basic` reads `toolResultPrune` through `ctx.get`, so the pruner must
 # share this realm rather than sit outside it.
+#
+# `tokenMeter` is deliberately NOT in this realm: the meter stays on the HOST
+# plane, and the rows here resolve that one instance. It takes no configuration,
+# keys every fold by Session, and owns the context-meter projection units the
+# browser reads for every session — behind a realm those units would come and go
+# with whichever presets happen to be mounted. What a preset chooses is whether
+# its agent compacts at all, which is `compact-basic` below.
 - id: compaction
   name: cordis:group
   group: true
   isolate:
-    tokenMeter: true
     compact: true
     toolResultPrune: true
   config:
-    - id: token-meter
-      name: '@deepseek-ai/dsh-token-meter'
-
     - id: compact-basic
       name: '@deepseek-ai/dsh-compact-basic'
 

package/config/agent-presets/cordis/agent.cordis.yml

@@ -24,7 +24,7 @@
 
       Two planes decide where an edit belongs. The HOST composition holds the registries and anything shared across sessions — persistence, the sandbox and approval stack, the model route, the subagent registry and its backends. An AGENT PRESET holds what one session contributes to those registries: its tools, its persona, its prompt sections. A row that publishes a service belongs in the host composition, or inside an `isolate` realm if the preset genuinely owns that service and nothing outside one agent reads it.
 
-      Presets you author live under `${DSH_HOME:-$HOME/.dsh}/.agent-presets/<id>/`, one directory per preset. NEVER edit or delete the shipped preset install (the `agent-presets` directory beside the deployment's own config): it belongs to the deployment, an upgrade overwrites it, and corrupting the `cordis` preset would disable this very mode. To change what a shipped preset does, copy its composition into a new preset directory and edit the copy.
+      Presets you author live one directory per preset under `${DSH_HOME:-$HOME/.dsh}/.agent-presets/<id>/`; the roster reports each preset's real path, so take the one you edit from there. NEVER edit or delete the shipped preset install (the `agent-presets` directory beside the deployment's own config): it belongs to the deployment, an upgrade overwrites it, and corrupting the `cordis` preset would disable this very mode. To change what a shipped preset does, copy its composition into a new preset directory and edit the copy.
 
       Load the `editing-cordis-compositions` skill before writing or changing a composition.
 
@@ -110,17 +110,20 @@
 
 # `compact-basic` reads `toolResultPrune` through `ctx.get`, so the pruner must
 # share this realm rather than sit outside it.
+#
+# `tokenMeter` is deliberately NOT in this realm: the meter stays on the HOST
+# plane, and the rows here resolve that one instance. It takes no configuration,
+# keys every fold by Session, and owns the context-meter projection units the
+# browser reads for every session — behind a realm those units would come and go
+# with whichever presets happen to be mounted. What a preset chooses is whether
+# its agent compacts at all, which is `compact-basic` below.
 - id: compaction
   name: cordis:group
   group: true
   isolate:
-    tokenMeter: true
     compact: true
     toolResultPrune: true
   config:
-    - id: token-meter
-      name: '@deepseek-ai/dsh-token-meter'
-
     - id: compact-basic
       name: '@deepseek-ai/dsh-compact-basic'
 

package/config/agent-presets/cordis/skills/editing-cordis-compositions/SKILL.md

@@ -1,12 +1,18 @@
 ---
 name: editing-cordis-compositions
-description: Use when creating or changing a Cordis composition for this harness — writing or editing an agent preset, adding or removing a plugin row, deciding whether something belongs to the host composition or to one session, or diagnosing a row that mounted but contributed nothing.
+description: Use when creating, changing, or validating a Cordis composition for this harness — writing or editing an agent preset, adding or removing a plugin row, deciding whether something belongs to the host composition or to one session, checking whether a preset you authored actually mounts, or diagnosing a row that mounted but contributed nothing.
 ---
 
 # Editing Cordis compositions
 
 Every capability in this harness is a plugin row in a `cordis.yml`. There is no separate configuration language: changing what an agent can do means changing which rows are composed for it.
 
+## Off-limits
+
+**Never edit, delete, or overwrite a preset that ships with the deployment** — the `agent-presets` directory beside the deployment's own config, which supplies `standard`, `code`, `minimal`, and `cordis`. Never escalate the sandbox to reach it, even when a change there looks quicker. An upgrade overwrites that install, and corrupting `cordis` disables preset authoring itself. Reading a shipped composition is the intended way to start; writing to one is not, and neither is editing the host composition to work around a preset limitation.
+
+To change what a shipped preset does, copy it and edit the copy. Locally authored presets under the user root are yours to create, edit, and delete.
+
 ## Decide the plane first
 
 Two planes, and the choice is not about how "agent-related" something feels — it is about whether the thing must be shared.
@@ -17,16 +23,105 @@ Two planes, and the choice is not about how "agent-related" something feels —
 
 **A service with a consumer outside the agent plane cannot move into a preset.** `subagents` is the worked example: the registry answers cross-session queries for the host api-proxy, so a per-session copy both starves that host row — it waits forever for a service nothing provides — and collides on the second session, since a provider name registers once. The preset contributes the delegation *tools*; the registry and its backends stay host-side.
 
-A preset is a directory holding one `agent.cordis.yml`, optionally beside a `preset.yml` carrying display metadata — `name` and `description` (and, for shipped presets, a roster `order`). Write the metadata too: a preset without it shows up in every picker as its bare directory name. The shipped presets live beside the deployment's composition; locally authored ones live under `${DSH_HOME:-$HOME/.dsh}/.agent-presets/<name>/`.
+A preset is a directory holding one `agent.cordis.yml`, optionally beside a `preset.yml` carrying display metadata — `name` and `description` (and, for shipped presets, a roster `order`). Write the metadata too: a preset without it shows up in every picker as its bare directory name.
+
+Locally authored presets live one directory per preset under `${DSH_HOME:-$HOME/.dsh}/.agent-presets/`, and the shipped set sits beside the deployment's own config. Use those when the user asks where to look. Both roots are configuration rather than fixed locations, though, and no call reports them — `authorable` says only whether a writable one exists — so take the path you actually read or edit from `list()` or `resolve()`, which is also where `copy()` reports what it just created.
+
+## The roster service
+
+`ctx.agentPresets` owns discovery, authoring, and mounting. You reach it by mounting a temporary plugin that injects it and registers a tool for yourself — `cordis_mount` returns only the mount acknowledgement, so a registered tool is how a service answer gets back to you, and it becomes callable on your next step.
+
+Read `cordis_inspect what:"api" name:"agentPresets"` for the current signatures before writing the code. The four calls this skill relies on:
+
+- `list()` — every preset with its `id`, `trust` (`system` for the shipped set, `user` for authored ones), and the absolute `path` of its composition file. This is how you locate any composition without knowing the install layout; the directory is that path's parent.
+- `read(id)` — one preset's composition text, without a file tool or a path.
+- `copy(from, id, name?)` — the only authoring write (see below).
+- `standingKeyFor(id)` — mount-validate one preset (see below).
+
+```js
+return {
+  name: 'preset-tools',
+  inject: ['agentPresets', 'tools'],
+  apply(ctx) {
+    harness.registerTool(ctx, harness.defineTool({
+      name: 'preset_check',
+      description: 'Mount-validate one preset by id.',
+      parameters: { id: { type: 'string', required: true } },
+      output: { schema: { type: 'string' }, render(_a, v) { return [{ type: 'text', text: v }] } },
+      async execute(args) {
+        try {
+          await ctx.agentPresets.standingKeyFor(args.id)
+          return 'mounted OK'
+        } catch (error) {
+          return error.message
+        }
+      },
+    }))
+  },
+}
+```
+
+Unmount the plugin with `cordis_unmount` when you are done; it is a probe, not a capability to leave behind.
 
 ## Authoring a preset
 
-1. **Start from a copy.** Read a shipped composition close to what you want (the `standard` preset is the full coding agent) and copy its whole directory into `${DSH_HOME:-$HOME/.dsh}/.agent-presets/<id>/` — the id must be lowercase letters, digits, and hyphens, because it becomes the directory name. A composition written from scratch usually forgets a group realm or a consumer row; a copy starts loadable.
-2. **Expect the file sandbox.** The preset root lies outside the session workspace, so under the default `workspace-write` policy the first write is denied. Retry that exact command once with `sandbox_permissions` escalation and a short justification — the user sees and approves it. Batch your writes (one heredoc per file) rather than escalating many small commands.
-3. **Rewrite `preset.yml`**: give the copy its own `name` and `description`, and drop any `order` the source declared — that field sorts the shipped roster.
-4. **Edit `agent.cordis.yml`** row by row, keeping the plane rule and realm rule above.
+1. **Start from a copy.** `copy(from, id, name)` copies a whole preset directory into the user root — composition, metadata, skill directories, assets. It validates the id against `[a-z0-9][a-z0-9-]*` (it becomes the directory name, so no leading hyphen), refuses an id any root already supplies, rolls a failed copy back, and rewrites the copy's `preset.yml` to keep the source's description while dropping its name and roster `order`. Prefer it over a shell copy: it needs no sandbox escalation, it lands the copy in whichever root this deployment made writable, and the copy is exactly as loadable as its source. `resolve(id)` then names the file it created — that path, not a guessed one, is what the following edits target. `standard` is the full coding agent and the usual source.
+2. **Expect the file sandbox on every edit after the copy.** The user preset root lies outside the session workspace, so under the default `workspace-write` policy the first write there is denied. Only writes are: reading any composition by absolute path needs no escalation. Retry that exact command once with `sandbox_permissions` escalation and a short justification — the user sees and approves it. Batch your writes (one heredoc per file) rather than escalating many small commands. `copy()` itself runs host-side and needs none of this; the edits do.
+3. **Write the copy's `description`** in `preset.yml`, and its `name` if you passed none to `copy()`.
+4. **Edit `agent.cordis.yml`** row by row, keeping the plane rule and the realm rule.
+5. **Mount-validate the result**, then hand off to the user for a real session — both under *Verifying a change*.
+
+A composition written from scratch usually forgets a group realm or a consumer row; a copy starts loadable.
+
+## The rule that catches people
+
+**A row that publishes a service may not sit loose in a preset.** Registering a service without an isolate realm puts it in the process-global realm, so the second session mounting that preset collides with the first. The mount rejects it rather than letting the collision surface later.
+
+Whether a row publishes a service is not visible from its name, and package READMEs are absent from an installed deployment. Read it off the live runtime instead: `cordis_inspect what:"services"` lists every service with the fiber that owns it, so a service attributed to a fiber other than the row you are adding is one that row consumes rather than provides. For a row not in your current composition, mount-validate and read the rejection — it names the offending service.
+
+When a preset genuinely owns a service, wrap the provider **and every consumer that reaches it** in one group carrying an `isolate` realm. The shipped `standard` composition does this for `workflows`, which nothing outside an agent reads — its `delegation` group, with the delegation tools omitted here:
+
+```yaml
+- id: delegation
+  name: cordis:group
+  group: true
+  isolate:
+    workflows: true
+  config:
+    - id: workflow-workerthread
+      name: '@deepseek-ai/dsh-workflow-workerthread'
+      config:
+        provider: spawn
+    - id: tool-workflow
+      name: '@deepseek-ai/dsh-tool-workflow'
+```
+
+`true` means a realm private to each mounting session. A string label instead joins subtrees into one shared realm; `provide()` still throws on the second registration under that symbol, so a label does not pool instances and is not what a preset needs.
+
+A consumer left outside the group resolves the host's registry, which the preset did not populate, and then contributes nothing. Mount-validation catches that as a row that never activated.
+
+Realms are for services a preset owns, not for every group. A host capability the preset only consumes must stay outside a realm, or the row cannot resolve it: `tool-bash`, `tool-tasks`, and `tool-goal` publish nothing and sit loose in `standard`, which explains in comments which host instance each one resolves and why a realm would break it. Wrapping a consumer row in a realm of its own is the same error as leaving one outside its provider's realm.
+
+## Verifying a change
+
+**`standingKeyFor(id)` is the check.** It composes the preset's plugin subtree for real — the same mount a session start performs, minus the agent — and rejects the four ways a composition fails:
+
+- a row whose package does not resolve (`Cannot find package …`);
+- a row whose config is invalid (`invalid config: $.<field> missing required value`);
+- a row that never activated (`N row(s) did not activate: <id>: waiting for <service>`);
+- a service published into the root realm, which arrives as one of two messages. A name the host does not supply lands in the root realm and the mount audit rejects it: `row(s) published process-global service(s) [<name>]; a preset service must sit behind an isolate realm or move to the host composition` — this is the shape a preset's own forgotten realm takes. A name the host already supplies collides before the audit: `service "<name>" has been registered at <Owner>`. Both name the offending service.
+
+It returns normally when the composition mounts. Run it as the final check on a finished edit rather than after every line: a successful mount installs a standing generation that lives until the process exits, while a failed one disposes its subtree and leaves nothing behind.
+
+**Do not treat the roster's `broken` field as validation.** `list()` reports `broken` from a shape check — the file parses in the loader's YAML dialect and holds named rows — which every failure above passes. It catches a damaged file, not an unusable composition.
 
-### Native product subagents
+`cordis_inspect` reports THIS session's composition, so it confirms what a row does in the runtime you are already in, never what your new preset will do.
+
+After a clean mount-validation, ask the user to start a session on the new preset and confirm the tool list; the preset decides tool schemas and prompt sections, and only a real session shows the agent that composition produces.
+
+`cordis_mount` evaluates JavaScript against the live runtime and disappears on restart. It is for probing, not for shipping a capability: a capability belongs in a composition file.
+
+## Native product subagents
 
 Codex and Claude Code providers already live in the host composition. A preset chooses either product by contributing the same ordinary delegation-tool row used for spawn and fork; never move a product provider into the preset and never add a product-specific settings field.
 
@@ -54,43 +149,6 @@ Copy these disabled templates from a shipped full preset and remove `disabled` o
 
 The two rows are independent. Leaving both disabled preserves the copied preset, enabling one exposes only that product tool, and enabling both exposes both. The host must provide `codex` or `claude` on `PATH`; the preset does not install, authenticate, select a model for, or probe either product.
 
-The shipped preset directories are off-limits: never edit or delete them, and never escalate the sandbox to reach them, even when a change there looks quicker — an upgrade overwrites the install, and corrupting the `cordis` preset disables preset authoring itself. Locally authored presets under the user root are yours to create, edit, and delete.
-
-## The rule that catches people
-
-**A row that publishes a service may not sit loose in a preset.** Registering a service without an isolate realm puts it in the process-global realm, so the second session mounting that preset collides with the first. The mount rejects it rather than letting the collision surface later.
-
-Whether a row publishes a service is not visible from its name. `tool-bash` reads like a tool but provides `bashEnv`. Check the package's README, or mount the preset and read the rejection — it names the offending service.
-
-When a preset genuinely owns a service, wrap the provider **and every consumer that reaches it** in one group carrying an `isolate` realm:
-
-```yaml
-- id: tasks
-  name: cordis:group
-  group: true
-  isolate:
-    tasks: true
-  config:
-    - id: tasks-local
-      name: '@deepseek-ai/dsh-tasks-local'
-    - id: tool-tasks
-      name: '@deepseek-ai/dsh-tool-tasks'
-```
-
-`true` means a realm private to each mounting session. A string label instead pools one instance across every subtree naming that label — use it only for something genuinely expensive to duplicate.
-
-A consumer left outside the group resolves the host's registry, which the preset did not populate, and then contributes nothing. That is the quietest failure here: the mount succeeds and a tool is simply missing.
-
-Host capabilities exposed through registries need no realm: the host `tools` and `skills` registries are layered per scope, so rows like `skill-local` and `tool-skill` sit loose in the preset and their registrations file into this preset's layer automatically — the agent's catalog merges them with whatever the deployment registered globally.
-
-## Verifying a change
-
-Read the live runtime with `cordis_inspect` — it reports the services, the plugin fibers, and the registered tools as they actually are, which is the only reliable check that a row did what its name suggests. Note it shows THIS session's composition: a preset you just wrote is not mounted anywhere until a session starts on it.
-
-To check a preset you authored, re-read the files and validate these fields: the top level is a YAML list, every row is a map with a `name`, every group carries its own list, and service-publishing rows sit behind an `isolate` realm. The settings page's preset roster validates the same fields and marks an unloadable preset broken in red — point the user there, and ask them to start a session on the new preset to confirm the tool list; you cannot start one yourself.
-
-`cordis_mount` evaluates JavaScript against the live runtime and disappears on restart. It is for probing, not for shipping a capability: a capability belongs in a composition file.
-
 ## What not to move into a preset
 
 `agent-loop` registers the one agent factory and throws on a second. The registries own the per-session layering and cannot themselves be per-session. Session persistence must stay host-side or the session list fragments. The sandbox, approval, and permission rows are a deliberate boundary: a preset is exactly as privileged as the plugins it names, so letting one relax its own confinement would defeat the confinement.

package/config/agent-presets/minimal/agent.cordis.yml

@@ -1,8 +1,9 @@
-# The `minimal` agent preset: a fixed-prompt, two-tool coding surface.
+# The `minimal` agent preset: a fixed-prompt, two-tool coding-agent composition.
 #
-# The persona is the complete system prompt, so global identity, Web surface,
+# The persona is the complete system prompt, so global identity, Web orientation,
 # tool guidance, and later assembly listeners cannot add prompt text. The model
-# composes only the persistent `bash` and `str_replace_editor` tools.
+# composes only the persistent `bash` and `str_replace_editor` tools. Context
+# compaction is deliberately absent.
 
 - id: persona
   name: '@deepseek-ai/dsh-persona'
@@ -41,30 +42,20 @@
           * Please avoid commands that may produce a very large amount of output.
           * Please run long lived commands in the background, e.g. 'sleep 10 &' or start a server in the background.
 
-# The editor requires absolute paths unconditionally.
-- id: str-replace-editor
-  name: '@deepseek-ai/dsh-tool-str-replace-editor'
-  config:
-    maxOutputChars: 16000
-
-# Model capacity comes from routed model metadata; this block states the
-# compaction policy explicitly.
-- id: compaction
+# The bare local filesystem shadows the host's sandboxed provider only for this
+# preset. The editor shares that realm and requires absolute paths.
+- id: filesystem
   name: cordis:group
   group: true
   isolate:
-    tokenMeter: true
-    compact: true
+    fs: true
   config:
-    - id: token-meter
-      name: '@deepseek-ai/dsh-token-meter'
+    - id: fs-local
+      name: '@deepseek-ai/dsh-fs-local'
+      config:
+        cwd: !!js process.env.DSH_CWD ?? process.cwd()
 
-    - id: compact-basic
-      name: '@deepseek-ai/dsh-compact-basic'
+    - id: str-replace-editor
+      name: '@deepseek-ai/dsh-tool-str-replace-editor'
       config:
-        thresholdRatio: 0.8
-        retainTokens: 20480
-        summarizationProvider: ''
-        summarizationModel: ''
-        maxTokens: 8192
-        compactionRetries: 1
+        maxOutputChars: 16000

package/config/agent-presets/standard/agent.cordis.yml

@@ -122,17 +122,20 @@
 
 # `compact-basic` reads `toolResultPrune` through `ctx.get`, so the pruner must
 # share this realm rather than sit outside it.
+#
+# `tokenMeter` is deliberately NOT in this realm: the meter stays on the HOST
+# plane, and the rows here resolve that one instance. It takes no configuration,
+# keys every fold by Session, and owns the context-meter projection units the
+# browser reads for every session — behind a realm those units would come and go
+# with whichever presets happen to be mounted. What a preset chooses is whether
+# its agent compacts at all, which is `compact-basic` below.
 - id: compaction
   name: cordis:group
   group: true
   isolate:
-    tokenMeter: true
     compact: true
     toolResultPrune: true
   config:
-    - id: token-meter
-      name: '@deepseek-ai/dsh-token-meter'
-
     - id: compact-basic
       name: '@deepseek-ai/dsh-compact-basic'
 

package/lib/bin.js

@@ -129,7 +129,7 @@ function readVersion() {
 const invocation = parseDshArgs(process.argv.slice(2), readVersion());
 switch (invocation.mode) {
 	case "profile": {
-		const { runProfile } = await import("./profile-boot-T5aOCb6v.js");
+		const { runProfile } = await import("./profile-boot-CuKpzL79.js");
 		await runProfile({
 			environment: loadLayeredEnv("dsh"),
 			profile: invocation.profile,
@@ -139,12 +139,12 @@ switch (invocation.mode) {
 		break;
 	}
 	case "plugin": {
-		const { runPlugin } = await import("./plugin-Xxr7y7sa.js");
+		const { runPlugin } = await import("./plugin-D9IP9d5I.js");
 		process.exit(runPlugin(invocation.profile, invocation.args));
 		break;
 	}
 	case "dump-config": {
-		const { runDumpConfig } = await import("./dump-config-DlxoPVYx.js");
+		const { runDumpConfig } = await import("./dump-config-CBIM2Y1u.js");
 		runDumpConfig(invocation.profile, invocation.defaultOnly, invocation.patches);
 		break;
 	}

package/lib/{dump-config-DlxoPVYx.js → dump-config-CBIM2Y1u.js}

@@ -1,4 +1,4 @@
-import { i as prepareProfile, n as PROFILE_ROOT_FILENAME, r as homePatchPath, s as resolveWindowsShellLayer } from "./profile-boot-DQYCwKII.js";
+import { i as prepareProfile, n as PROFILE_ROOT_FILENAME, r as homePatchPath, s as resolveWindowsShellLayer } from "./profile-boot-D95nr1z0.js";
 import { existsSync } from "node:fs";
 import { loadOptionalPatches, loadOverlayPatches, renderConfigDump } from "@deepseek-ai/dsh-app-boot";
 import { join, resolve } from "node:path";

package/lib/{plugin-Xxr7y7sa.js → plugin-D9IP9d5I.js}

@@ -1,4 +1,4 @@
-import { t as INSTALL_ANCHOR } from "./profile-boot-DQYCwKII.js";
+import { t as INSTALL_ANCHOR } from "./profile-boot-D95nr1z0.js";
 import { existsSync } from "node:fs";
 import { DEFAULT_PROFILE_BUNDLES, PROFILE_TEMPLATES, initProfile, readProfileManifest, resolveBundleDir, resolveProfileDir, writeProfileManifest } from "@deepseek-ai/dsh-app-boot";
 import { join, resolve } from "node:path";

package/lib/profile-boot-CuKpzL79.js

@@ -0,0 +1,2 @@
+import { o as runProfile } from "./profile-boot-D95nr1z0.js";
+export { runProfile };

package/lib/{profile-boot-DQYCwKII.js → profile-boot-D95nr1z0.js}

@@ -138,8 +138,6 @@ function homePatchPath() {
 const INSTALL_ANCHOR = fileURLToPath(new URL("../package.json", import.meta.url));
 /** The session-telemetry row id the DSH_TELEMETRY_DISABLED switch targets. */
 const TELEMETRY_ROW_ID = "telemetry-otel";
-/** The one-shot runner row: its presence means this composition exits by itself. */
-const HEADLESS_ROW_ID = "headless-runner";
 /** The empty root entry list every profile tree patches over. */
 const PROFILE_ROOT_CONFIG = `# dsh profile root — an empty entry list. The tree is composed as patches:
 # each bundle in package.json's dsh.profile.bundles, then cordis.patch.yml, then any
@@ -245,9 +243,20 @@ function composeProfile(name, patchFiles) {
 		rows
 	};
 }
-/** Re-throw setup failures unless this invocation's signal already owns shutdown. */
-function suppressSignalShutdownError(signal, error) {
-	if (!signal.aborted) throw error;
+/**
+* Re-throw a watcher-setup failure unless a shutdown already owns the tree:
+* a signal aborted this invocation, or an app requested exit (`ctx.appExit`
+* from a fast one-shot) and the root's disposal rejected the in-flight setup
+* await. Either way the failure describes a tree that is exiting as asked,
+* not a broken watch.
+* @param ctx - the booted root context.
+* @param signal - this invocation's signal-shutdown fact.
+* @param error - the setup failure.
+*/
+function suppressShutdownError(ctx, signal, error) {
+	if (signal.aborted) return;
+	if (ctx.fiber.state !== 2 || ctx.get("loader") === void 0) return;
+	throw error;
 }
 /**
 * Boot one profile invocation end to end and leave process lifetime to the
@@ -257,8 +266,6 @@ function suppressSignalShutdownError(signal, error) {
 */
 async function runProfile(options) {
 	const composed = composeProfile(options.profile, options.patchFiles);
-	const headlessRow = composed.rows.get(HEADLESS_ROW_ID);
-	const oneShot = headlessRow !== void 0 && headlessRow.disabled !== true;
 	const app = {};
 	const shutdown = createProcessShutdown(async () => {
 		await app.current?.fiber.dispose();
@@ -269,7 +276,7 @@ async function runProfile(options) {
 		shutdown.interrupt(code);
 	};
 	process.on("SIGTERM", () => {
-		interrupt(oneShot ? 143 : 0);
+		interrupt(0);
 	});
 	process.on("SIGINT", () => {
 		interrupt(130);
@@ -285,7 +292,6 @@ async function runProfile(options) {
 		...loadOptionalPatches(NAME, homePatchPath()) ?? [],
 		...composed.overlays
 	]);
-	const watchProfilePatch = !oneShot;
 	const ctx = await boot(NAME, rootConfig, structuredClone(allPatches(composed)), (hostCtx) => {
 		app.current = hostCtx;
 		hostCtx.provide(DSH_ENVIRONMENT_KEY, options.environment);
@@ -293,19 +299,9 @@ async function runProfile(options) {
 			args: options.args,
 			exit: (code) => void shutdown.shutdown(code)
 		});
-		if (oneShot) {
-			const io = {
-				stdout: process.stdout,
-				stderr: process.stderr,
-				exit: (code) => {
-					shutdown.shutdown(code);
-				}
-			};
-			hostCtx.provide("headlessIo", io);
-		}
 	});
 	app.current = ctx;
-	if (watchProfilePatch && !signalShutdown.signal.aborted && ctx.fiber.state === 2 && ctx.get("loader") !== void 0) try {
+	if (!signalShutdown.signal.aborted && ctx.fiber.state === 2 && ctx.get("loader") !== void 0) try {
 		if (ctx.get("hmr") === void 0) {
 			if (ctx.get("timer") === void 0) await ctx.loader.create({ name: "@deepseek-ai/cordis-plugin-timer" });
 			await ctx.loader.create({
@@ -324,7 +320,7 @@ async function runProfile(options) {
 			compose: composeLive
 		});
 	} catch (error) {
-		suppressSignalShutdownError(signalShutdown.signal, error);
+		suppressShutdownError(ctx, signalShutdown.signal, error);
 	}
 	return {
 		ctx,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh",
   "description": "dsh CLI: profile boot, plugin management, and the browser UI alias",
-  "version": "0.0.1-rc.1",
+  "version": "0.0.1-rc.2",
   "publishConfig": {
     "access": "restricted"
   },
@@ -25,71 +25,74 @@
     "node-addon-require-builtin": "^0.1.4",
     "@deepseek-ai/cordis-plugin-hmr": "^1.0.16-rc.1",
     "@deepseek-ai/cordis-plugin-include": "^1.0.5-rc.1",
-    "@deepseek-ai/cordis-plugin-loader": "^1.0.1-rc.1",
-    "@deepseek-ai/dsh-agent-tool-mode": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-app-boot": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-app-boot": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-agent-tool-mode": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-base": "^0.0.1-rc.2",
     "@deepseek-ai/cordis-plugin-timer": "^1.1.3-rc.1",
-    "@deepseek-ai/dsh-base": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-agent-preset": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-command-compact": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-command-goal": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-compact-basic": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-compact-tool-result-prune": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-goal": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-goal-session": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-cmdline": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-environment": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-headless": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-mcp-client": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-paths": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-persona": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-plan-mode": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-pty": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-pty-local": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-pwsh-local": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-skill": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-skill-local": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tasks-local": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tmux-context": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-token-meter": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tool-ask-user": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tool-bash": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tool-bash-persistent": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tool-cordis": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tool-fs": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tool-fs-search": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tool-goal": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tool-pwsh": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tool-ralph": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tool-skill": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-session-reference": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tool-str-replace-editor": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-pwsh-sandbox": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tool-subagent": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tool-subagent-control": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tool-tasks": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tool-todo": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tool-web": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tool-workflow": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-web-app": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-workflow-workerthread": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-workspace-context": "^0.0.1-rc.1",
-    "@deepseek-ai/cordis": "^4.0.1-rc.1"
+    "@deepseek-ai/cordis-plugin-loader": "^1.0.1-rc.1",
+    "@deepseek-ai/dsh-command-compact": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-command-goal": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-compact-basic": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-goal-session": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-cmdline": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-compact-tool-result-prune": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-goal": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-environment": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-fs-local": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-headless": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-mcp-client": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-persona": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-pty": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-plan-mode": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-pty-local": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-pwsh-local": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-pwsh-sandbox": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-session-projection": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-session-reference": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-time-context": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-skill": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-skill-local": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tasks-local": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tmux-context": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-token-meter": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tool-ask-user": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tool-bash": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tool-bash-persistent": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tool-cordis": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tool-fs-search": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tool-pwsh": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tool-goal": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tool-schedule": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tool-ralph": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tool-str-replace-editor": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tool-skill": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-paths": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tool-fs": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tool-subagent": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tool-tasks": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tool-web": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tool-workflow": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-web-app": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-workspace-context": "^0.0.1-rc.2",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-tool-todo": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-workflow-workerthread": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tool-subagent-control": "^0.0.1-rc.2"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
     "execa": "^10.0.0",
-    "@deepseek-ai/dsh-frontend-static": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-agent": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-host-apiproxy": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-llm": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-llm-mock-server": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-loader-smoke": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-session": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-host-webserver": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-settings": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-subagent": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-system-prompt": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tools": "^0.0.1-rc.1"
+    "@deepseek-ai/dsh-frontend-static": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-host-apiproxy": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-llm": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-llm-mock-server": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-loader-smoke": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-agent": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-settings": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-session": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-subagent": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tools": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "^0.0.1-rc.2"
   }
 }

package/lib/profile-boot-T5aOCb6v.js

@@ -1,2 +0,0 @@
-import { o as runProfile } from "./profile-boot-DQYCwKII.js";
-export { runProfile };