@xmoon76/dsh-pi-tui 0.4.7-alpha.1 → 0.4.8

package/README.en.md

@@ -54,23 +54,27 @@ next compatibility range, and fallback paths.
 
 | TUI package line | Official DSH tags for the pairing | Notes |
 |---|---|---|
-| `0.4.6` (published `@latest`) | `dsh-v0.1.5-rc.1`, `dsh-v0.1.5-rc.2` | Current stable line; rc.1 minimum, rc.2 compatible |
-| Current `next` npm line (this checkout; version `0.4.7-alpha.1`) | `dsh-v0.1.6-alpha.1` | Current next line |
-
-Do not mix the stable and `next` lines. The current `next` checkout declares
-the published `0.1.6-alpha.1` npm floor; older runtimes fail at the normal
-incompatible-runtime boundary. The startup notice is best-effort rather than a
-Loader startup-order guarantee. See the [full historical compatibility matrix](docs/dsh-compatibility.md)
-for official-tag pairings and fallback commands, and see the [latest `next`
+| `0.4.8` (stable / `@latest`) | `dsh-v0.1.7-rc.1` | Current stable line; 0.1.7-rc.1 minimum |
+| `0.4.6` (stable, previous) | `dsh-v0.1.5-rc.1`, `dsh-v0.1.5-rc.2` | Previous stable; the compatible TUI for a 0.1.5 runtime |
+| `0.4.7-alpha.2` (next, previous) | `dsh-v0.1.6-alpha.2` | Previous next line; the compatible TUI for a 0.1.6-alpha.2 runtime |
+
+Do not mix the stable and `@next` prerelease lines. The `0.4.8` line unifies its
+whole DSH peer floor at `>=0.1.7-rc.1` (the rc.1 preset registry peers
+`dsh-agent` exactly, so a wider legacy floor no longer satisfies a standalone
+tarball install); older runtimes fail at the normal incompatible-runtime
+boundary, so install the paired TUI line from the table above. The startup notice
+is best-effort rather than a Loader startup-order guarantee. See the [full
+historical compatibility matrix](docs/dsh-compatibility.md) for official-tag
+pairings and fallback commands, and see the [latest `next`
 README](https://github.com/XMoon/dsh-pi-tui/blob/next/README.md) for the current
 integration status.
 
 New agent sessions use the official roster's selected preset id. A custom DSH
 preset literally named `code` is valid and remains `code` when it exists in the
 current roster. DSH V3 migration owns historical session `code -> ptc`
-conversion, while the current projection preserves a legal custom `code`. Only
-an omitted legacy settings default `code` falls back to `ptc` after the roster
-proves that no custom `code` preset exists.
+conversion, while the current projection preserves a legal custom `code`. An
+omitted legacy settings default is never aliased: with no matching declaration
+in the current roster it is simply an invalid preference.
 
 ### Profile management
 
@@ -119,11 +123,15 @@ dsh --profile pi-tui --session <session-id>
 
 `Ctrl+O` controls Tool and System details and expands/collapses long user prompts in regular mode and in fullscreen outside Focus — in fullscreen Focus it bulk-expands the recent Thought roots or collapses them all, while long user prompts are expanded by clicking the marker (or by a search hit) and collapsed with `Ctrl+O`. `Alt+T` controls Thinking separately.
 
-### Focus Mode
+### Conversation display
 
-`/focus` groups the current turn's Thinking, Tool Calls, and intermediate replies into a live Thought block.
+`/display focus` groups the current turn's Thinking, Tool Calls, and intermediate replies into a live Thought block; `/display full` restores the normal Transcript projection. `/focus` remains available as a compatibility command. The Compact preset is reserved and `/display compact` is rejected until its projection ships.
 
-The full process can still be expanded when needed. In fullscreen Focus, Thought roots can be expanded/collapsed in bulk or opened with an individual card click, and the viewport survives switches and resizes. Disabling Focus restores the normal Transcript projection. Focus only changes presentation; it does not modify Session events.
+The full process can still be expanded when needed. In fullscreen Focus, Thought roots can be expanded/collapsed in bulk or opened with an individual card click, and the viewport survives switches and resizes. Display presets only change presentation; they do not modify Session events.
+
+### Communication policy
+
+`/settings` exposes two independent communication controls. **Progress updates** owns the mid-turn update cadence: `milestones` (default) posts a brief update only when a substantial phase completes, the direction materially changes, or required user input blocks progress — never for a freshly discovered partial finding; `frequent` keeps the user actively informed through longer multi-step work; `off` suppresses progress narration entirely. **Response style** owns the visible answer's density: `default` adds no extra guidance, `concise` is compact and result-first, `explanatory` adds rationale, architecture, and tradeoffs. Changes apply on the next prompt assembly without restarting the agent and are saved across sessions. Focus is a surface capability, not a third preference: while Focus is active the progress section is simply ineffective (progress-only intermediate messages are not generated) and the saved cadence is untouched; the response style stays active in Focus.
 
 ### Sessions
 
@@ -328,20 +336,22 @@ Use `/help` inside the TUI for the current command and keybinding list. The tabl
 Host shortcuts are semantic actions (`app.*`) resolved through a
 context-aware keymap — the UI (footer hints, `/help`, `/keybindings`)
 always shows the EFFECTIVE keys, so a remap updates every hint. Configure
-them in the `dsh-pi-tui` settings namespace; apply with `/keybindings
-reload` (explicit — a settings edit takes effect after the reload, no
-restart):
+them through the in-TUI `/keybindings` panel (it writes the `keybindings`
+field of the `tui-app` plugin's profile-owned configuration — since DSH
+0.1.7 TUI preferences live on the profile Config, not the retired
+`dsh-pi-tui` settings namespace); apply with `/keybindings reload`
+(explicit — a configuration edit takes effect after the reload, no
+restart). Field shape:
 
 ```yaml
-dsh-pi-tui:
-  keybindings:
-    app.input.steer: ctrl+s          # one key
-    app.permission.cycle: [shift+tab, ctrl+shift+p]   # several keys
-    app.history.search: ctrl+r
-    app.transcript.toggleThinking: false   # disable the action's keys
-    leader: ctrl+x                    # M6: leader sequences
-    bindings:
-      app.tasks.open: <leader>t
+keybindings:
+  app.input.steer: ctrl+s          # one key
+  app.permission.cycle: [shift+tab, ctrl+shift+p]   # several keys
+  app.history.search: ctrl+r
+  app.transcript.toggleThinking: false   # disable the action's keys
+  leader: ctrl+x                    # M6: leader sequences
+  bindings:
+    app.tasks.open: <leader>t
 ```
 
 - A plain printable key can never be bound to a Host action (it would
@@ -562,9 +572,9 @@ This section contains DSH compatibility and CI validation details only; ordinary
 
 ### npm mode (current `next`)
 
-The current `next` line is npm mode: it targets the published
-`dsh-v0.1.6-alpha.1` family declared by this checkout's `package.json` and
-resolved by its frozen lockfile. The isolated npm driver installs that exact
+The current compatibility-train line is npm mode: it targets the published
+`dsh-v0.1.7-rc.1` family declared by this checkout's `package.json` and
+resolved by its lockfile. The isolated npm driver installs that exact
 family from the public registry and exercises the TUI build/test/package path:
 
 ```sh

package/README.md

@@ -52,19 +52,22 @@ pnpm compat:dsh:npm
 
 | TUI 包版本 | 对应的官方 DSH tags | 说明 |
 |---|---|---|
-| `0.4.6`（已发布 `@latest`） | `dsh-v0.1.5-rc.1`、`dsh-v0.1.5-rc.2` | 当前稳定版；最低 rc.1，兼容 rc.2 |
-| 当前 `next` npm 线（本 checkout；版本 `0.4.7-alpha.1`） | `dsh-v0.1.6-alpha.1` | 当前 next 线 |
+| `0.4.8`（stable / `@latest`） | `dsh-v0.1.7-rc.1` | 当前稳定版；最低 0.1.7-rc.1 |
+| `0.4.6`（stable，历史） | `dsh-v0.1.5-rc.1`、`dsh-v0.1.5-rc.2` | 上一稳定版；0.1.5 runtime 的兼容 TUI |
+| `0.4.7-alpha.2`（next，历史） | `dsh-v0.1.6-alpha.2` | 上一条 next 线；0.1.6-alpha.2 runtime 的兼容 TUI |
 
-不要把稳定线与 `next` 线混装。当前 `next` checkout 的 peer floor 是
-`>=0.1.6-alpha.1`，旧 runtime 会在正常的不兼容边界以非零状态失败。完整的
-历史兼容矩阵和 fallback 命令见 [兼容性文档](docs/dsh-compatibility.md)；
-要查看 next 的最新集成状态，请看 [next 分支 README](https://github.com/XMoon/dsh-pi-tui/blob/next/README.md)。
+不要把稳定线与 `@next` 预发布线混装。`0.4.8` 的整个 DSH peer floor 统一为
+`>=0.1.7-rc.1`（rc.1 的 preset registry 精确 peer `dsh-agent`，更宽的旧
+floor 已无法满足独立 tarball 安装）；旧 runtime 会在正常的不兼容边界以非零状态失败，
+请按上表安装配对的 TUI 线。完整的历史兼容矩阵和 fallback 命令见
+[兼容性文档](docs/dsh-compatibility.md)；要查看 `@next` 的最新集成状态，请看
+[next 分支 README](https://github.com/XMoon/dsh-pi-tui/blob/next/README.md)。
 
 新的 Agent preset 使用当前 roster 中选定的 id。DSH 允许合法的自定义
 `code` preset；只要当前 roster 存在它，显式输入和持久化状态都会保留 `code`。
 DSH V3 migration 负责历史 session header/selection 的 `code -> ptc` 转换；
-当前 projection 会原样保留合法的自定义 `code`。只有省略请求的 legacy
-settings default `code` 才会在确认 roster 不含 `code` 后回退到 `ptc`。
+当前 projection 会原样保留合法的自定义 `code`。省略请求的 legacy settings
+default 不再做任何别名映射：当前 roster 没有声明就是无效偏好。
 
 ### Profile management
 
@@ -113,11 +116,15 @@ dsh --profile pi-tui --session <session-id>
 
 `Ctrl+O` 控制工具和系统详情，并在普通模式与全屏非 Focus 下展开/收起超长用户 Prompt;全屏 Focus 下它整体展开最近几个 Thought root 或全部收起，超长用户 Prompt 改用点击提示行（或搜索命中）展开、`Ctrl+O` 收回。`Alt+T` 单独控制 Thinking。
 
-### Focus Mode
+### Conversation display
 
-`/focus` 可以把运行中的 Thinking、Tool Call 和中间回复聚合为一个实时更新的 Thought 区块。
+`/display focus` 将运行中的 Thinking、Tool Call 和中间回复聚合为一个实时更新的 Thought 区块；`/display full` 恢复普通 Transcript 展示。`/focus` 仍作为兼容命令保留。Compact 预设尚未开放，`/display compact` 会明确拒绝。
 
-需要查看过程时可以展开，关闭 Focus 后恢复普通 Transcript 展示。全屏 Focus 中可以按 Thought root 批量展开/收起,也可以单独点击卡片;切换或缩放时会保留 viewport。Focus 只影响界面投影，不修改 Session 中保存的事件。
+需要查看过程时可以展开，关闭 Focus 后恢复普通 Transcript 展示。全屏 Focus 中可以按 Thought root 批量展开/收起,也可以单独点击卡片;切换或缩放时会保留 viewport。展示预设只影响界面投影，不修改 Session 中保存的事件。
+
+### 沟通策略
+
+`/settings` 提供两个独立的沟通设置。**Progress updates** 控制 Agent 工作时的中途更新节奏：`milestones`（默认）只在完整的阶段结束、方向实质变化或需要用户输入时简短汇报，不为「刚发现一个局部结论」而打断；`frequent` 在较长的多步工作中持续带用户跟进；`off` 完全不做过程叙述。**Response style** 控制可见回复的密度：`default` 不附加表达指导，`concise` 紧凑且结果优先，`explanatory` 补充原理、架构与取舍。两项切换都在下一次提示词组装时生效，无需重启 Agent，并跨会话保存。Focus 是展示能力而非第三个偏好：进入 Focus 时进度更新节只是暂时失效（不生成只含进度的中间消息），保存的节奏偏好不变，Response style 在 Focus 下仍然生效。
 
 ### Session
 
@@ -310,20 +317,21 @@ TUI 使用 DSH 提供的模型和设置服务。
 
 Host 快捷键是语义 action(`app.*`),通过 context-aware keymap 解析——
 UI(页脚提示、`/help`、`/keybindings`)始终显示**生效**的按键,因此
-改键后所有提示自动更新。在 `dsh-pi-tui` settings 命名空间中配置,
-然后用 `/keybindings reload` 应用(显式 reload——改设置后执行 reload
-即生效,无需重启):
+改键后所有提示自动更新。配置入口是 TUI 里的 `/keybindings` 面板
+(写入 `tui-app` 插件的 profile 配置的 `keybindings` 字段——DSH 0.1.7
+起 TUI 偏好保存在 profile-owned Config,不再使用旧 `dsh-pi-tui`
+settings 命名空间);保存后用 `/keybindings reload` 应用(显式
+reload——配置变更后执行 reload 即生效,无需重启)。字段形状:
 
 ```yaml
-dsh-pi-tui:
-  keybindings:
-    app.input.steer: ctrl+s          # 单个按键
-    app.permission.cycle: [shift+tab, ctrl+shift+p]   # 多个按键
-    app.history.search: ctrl+r
-    app.transcript.toggleThinking: false   # 禁用该 action 的按键
-    leader: ctrl+x                    # M6:leader 序列
-    bindings:
-      app.tasks.open: <leader>t
+keybindings:
+  app.input.steer: ctrl+s          # 单个按键
+  app.permission.cycle: [shift+tab, ctrl+shift+p]   # 多个按键
+  app.history.search: ctrl+r
+  app.transcript.toggleThinking: false   # 禁用该 action 的按键
+  leader: ctrl+x                    # M6:leader 序列
+  bindings:
+    app.tasks.open: <leader>t
 ```
 
 - 普通可打印键永远不能绑定到 Host action(会吞掉输入);坏配置只是
@@ -535,8 +543,8 @@ dsh --profile pi-tui-dev
 
 ### npm 模式（当前 `next`）
 
-当前 `next` 线是 npm 模式：以本 checkout 的 `package.json` 声明、冻结
-lockfile 解析的已发布 `dsh-v0.1.6-alpha.1` family 为兼容目标。隔离的 npm
+当前兼容列车线是 npm 模式：以本 checkout 的 `package.json` 声明、
+lockfile 解析的已发布 `dsh-v0.1.7-rc.1` family 为兼容目标。隔离的 npm
 驱动从公共 registry 安装该精确 family，并跑完整 build/test/package 路径：
 
 ```sh

package/cordis.patch.yml

@@ -26,10 +26,29 @@
 
     - id: tui-app
       name: '@xmoon76/dsh-pi-tui'
-      inject: [tuiStartup, piTuiExtensions, authorization]
+      # `workspaceRegistry` is injected, not merely looked up: D2.4 Direct fork
+      # must observe the official workspace membership, and Cordis must have
+      # finished the registry's one-time history bootstrap before the surface
+      # can fork. The row below is this bundle's own, so the dependency is
+      # self-contained and a profile that disables it fails loud instead of
+      # silently forking without workspace inheritance.
+      inject: [tuiStartup, piTuiExtensions, authorization, workspaceRegistry]
       config:
         sessionId: ''
 
+    # Host-owned workspace membership (`ctx.workspaceRegistry`): D2.4 Direct
+    # fork mirrors the official Host rule (use the source's directly owning
+    # workspace, else the nearest ancestor workspace of a subagent source) and
+    # attaches the child after publication. That association only exists while
+    # this service is mounted, so the TUI inserts the same official row the web
+    # bundle does (the DSH installation already ships the package). Activating
+    # it also performs the official one-time history bootstrap that groups
+    # stored Session headers by canonical cwd into durable workspace records —
+    # an upstream migration, not a TUI invention, and the reason the row is
+    # documented in docs/client-server-coupling.md.
+    - id: workspace
+      name: '@deepseek-ai/dsh-workspace'
+
     # The authorization seam (`ctx.authorization`): plugin-owned credential-
     # obtaining flows, one attempt per key, transport-neutral notices and
     # prompts. The dsh host does NOT mount it anywhere (the base layer ships
@@ -42,14 +61,16 @@
     - id: authorization
       name: '@deepseek-ai/dsh-authorization'
 
-    # Official shipped presets are the composition authority. The upstream
-    # service defaults includeShippedRoot/includeUserRoot to true, so this
-    # bundle deliberately owns no duplicate standard/ptc/minimal/cordis root.
-    # DSH's V2→V3 format migration owns historical session preset conversion;
-    # the settings/default compatibility shim is kept separately at the TUI
-    # request boundary and does not add another preset row.
-    - id: agent-presets
-      name: '@deepseek-ai/dsh-agent-presets'
+    # The 0.1.7 declarative preset registry: preset identity, revisions and
+    # default/selection policy are registry-owned (deployment `default` here;
+    # the user's `selectedDefault` rides the profile form). The four shipped
+    # preset declarations follow as separate patch files under
+    # generated/dsh-presets/, listed after this file in package.json
+    # `dsh.bundle.patch` — a generated, parity-gated byte-exact mirror of
+    # @deepseek-ai/dsh-web-app's exported preset assets (0.1.7
+    # dsh.bundle.patch cannot reference another package's files).
+    - id: agent-preset-registry
+      name: '@deepseek-ai/dsh-agent-preset-registry'
       config:
         default: standard
 
@@ -75,7 +96,8 @@
 # its tools, its prompt sections, its delegation backends. The base keeps them
 # for single-session surfaces that compose their agent process-wide; the TUI
 # now composes one preset per session, so these rows are disabled here and the
-# `agent-presets` row above lets each session mount a preset instead.
+# official `agent-preset-registry` row above, plus the declarations it resolves,
+# lets each session mount a preset instead.
 #
 # Disabling rather than deleting is deliberate: the base is shared, and a row
 # absent from a surface overlay would silently reappear the day someone

package/dist/builtins.mjs

@@ -1,5 +1,5 @@
-import { I as dshVersion, V as PI_TUI_EXTENSIONS_SERVICE } from "./src-D-4-xTUd.mjs";
-import { TUI_STARTUP_SERVICE } from "./startup.mjs";
+import { B as PI_TUI_EXTENSIONS_SERVICE, I as dshVersion } from "./src-R8SVGB-L.mjs";
+import { n as TUI_STARTUP_SERVICE } from "./startup-Cd07dCyh.mjs";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
 //#region src/builtins.ts

package/dist/extension/advanced.d.mts

@@ -302,7 +302,12 @@ interface AdvancedHostState {
   setTitle(title: string | undefined): void;
   /** Override the working-indicator message (undefined clears). */
   setWorkingMessage(message: string | undefined): void;
-  /** Set the tool-output expansion master switch. */
+  /** Set the transcript-detail bulk-expansion master switch (recent
+   * collapsible transcript content). */
+  setTranscriptDetailExpanded(expanded: boolean): void;
+  /** Set the transcript-detail bulk-expansion master switch.
+   * @deprecated Use {@link setTranscriptDetailExpanded} — the same runtime
+   * state under its canonical name (post-F6 plan §5.6). */
   setToolsExpanded(expanded: boolean): void;
 }
 /** The full advanced facade (plan §4: `advanced(service)`). */

package/dist/extensions.mjs

@@ -1,3 +1,2 @@
-import { B as name, H as API_VERSION, R as apply, U as describeKey, V as PI_TUI_EXTENSIONS_SERVICE, z as inject } from "./src-D-4-xTUd.mjs";
-import "./startup.mjs";
+import { B as PI_TUI_EXTENSIONS_SERVICE, H as describeKey, L as apply, R as inject, V as API_VERSION, z as name } from "./src-R8SVGB-L.mjs";
 export { API_VERSION, PI_TUI_EXTENSIONS_SERVICE, apply, describeKey, inject, name };

package/dist/index.d.mts

@@ -2,8 +2,8 @@ import { H as TuiAction } from "./public-types-YbB5Rhku.mjs";
 import z from "@deepseek-ai/schemastery";
 import { Agent, ModelSelectionRef } from "@deepseek-ai/dsh-agent";
 import { ContentBlock } from "@deepseek-ai/dsh-llm";
-import { SessionEvent, SessionId } from "@deepseek-ai/dsh-session";
-import { Context } from "@deepseek-ai/cordis";
+import { SessionId } from "@deepseek-ai/dsh-session";
+import { Context, Volatile } from "@deepseek-ai/cordis";
 //#region src/image/admission.d.ts
 /** Structural subset of `ImageAttachmentRef`. */
 interface ImageAttachmentRefLike {
@@ -84,6 +84,43 @@ interface DraftImageStoreLike {
   values(): readonly DraftImage[];
 }
 //#endregion
+//#region src/display-preset.d.ts
+/**
+ * Canonical transcript display presets and their layered disclosure policy.
+ *
+ * DisplayPreset is the one runtime vocabulary for presentation state. Every
+ * preset whose projection exists in this build is available; the availability
+ * gate exists so a future preset can never be claimed by another preset's
+ * renderer before its own projection ships.
+ * @module @xmoon76/dsh-pi-tui/display-preset
+ */
+/** The complete display vocabulary. */
+type DisplayPreset = 'focus' | 'compact' | 'full';
+/** The shared mutable display authority passed between the runner, prompt and UI. */
+interface DisplayState {
+  preset: DisplayPreset;
+}
+//#endregion
+//#region src/diag.d.ts
+interface Diag {
+  debug(message: string, fields?: Record<string, unknown>): void;
+  info(message: string, fields?: Record<string, unknown>): void;
+  warn(message: string, fields?: Record<string, unknown>): void;
+  error(message: string, fields?: Record<string, unknown>): void;
+  /** Release the file handle, if one is open. */
+  dispose(): void;
+}
+//#endregion
+//#region src/communication-policy.d.ts
+type ProgressUpdates = 'off' | 'milestones' | 'frequent';
+type ResponseStyle = 'default' | 'concise' | 'explanatory';
+interface ProgressUpdatesState {
+  mode: ProgressUpdates;
+}
+interface ResponseStyleState {
+  style: ResponseStyle;
+}
+//#endregion
 //#region src/skill-catalog.d.ts
 /**
  * The standing-scope skill catalog adapter: the SINGLE narrow seam between
@@ -123,16 +160,6 @@ interface HumanSkillCatalog {
   readonly complete: boolean;
 }
 //#endregion
-//#region src/diag.d.ts
-interface Diag {
-  debug(message: string, fields?: Record<string, unknown>): void;
-  info(message: string, fields?: Record<string, unknown>): void;
-  warn(message: string, fields?: Record<string, unknown>): void;
-  error(message: string, fields?: Record<string, unknown>): void;
-  /** Release the file handle, if one is open. */
-  dispose(): void;
-}
-//#endregion
 //#region src/tui-app.d.ts
 /** The compaction lifecycle phase the working row advertises: idle (no
  * compaction), summarizing (compaction/start seen, the summary is being
@@ -231,12 +258,6 @@ interface SurfaceCatalogContext {
 }
 //#endregion
 //#region src/commands.d.ts
-/** A balanced completed-turn prefix for forking: the log up to (and including)
- * the last `turn/end`. Undefined when no turn has completed yet.
- * @param events - the session log.
- * @returns the fork seed events, or undefined.
- */
-declare function forkSeed(events: readonly SessionEvent[]): readonly SessionEvent[] | undefined;
 /**
  * The effective mode ONE submission resolved at the submit boundary: whether
  * an agent-facing delivery steers into the running turn or queues behind it
@@ -271,7 +292,12 @@ type HostCommandClaim = {
 declare const name = "tui-runner";
 /** Core services required before the TUI can mount. */
 declare const inject: string[];
-/** Plugin config: the session to resume, resolved from the startup service. */
+/** Plugin config: the session to resume, resolved from the startup service,
+ * plus the DSH 0.1.7 profile-owned live TUI preferences. Every preference
+ * field is a schemastery `.volatile()` reference (PR A): the `tui-app`
+ * plugin's Config is the ONE runtime authority, Loader commits live updates
+ * into the references without remounting, and the Settings service projects
+ * these fields into editable forms keyed by the `tui-app` profile entry. */
 interface Config {
   /** Resumed session id; a fresh session is created when absent. */
   sessionId?: string;
@@ -285,6 +311,58 @@ interface Config {
     readonly isTTY?: boolean;
     write(text: string): unknown;
   };
+  /** Theme values: auto | dark | light | custom:<name>. */
+  readonly theme: Volatile<string>;
+  readonly iconStyle: Volatile<string>;
+  readonly footer: Volatile<string>;
+  /** The user's LAST NATIVE footer mode ('default' | 'compact' | 'custom'):
+   * persisted separately because `footer` itself is overwritten by
+   * 'command' when the command surface arms — the command surface's failure
+   * fallback resolves from THIS, so a compact user's fallback survives a
+   * restart. */
+  readonly footerFallbackMode: Volatile<string>;
+  /** The M2 versioned custom footer layout (a nested object, never a JSON
+   * string). No schema default: parseFooterLayout is the authority on the
+   * persisted value and resolves absence to the builtin default layout. */
+  readonly footerLayout: Volatile<unknown>;
+  /** PR C: the Custom Text/Command definition collection, retained as raw
+   * data — the fail-soft parser (footer/custom-items.ts) owns validation. */
+  readonly footerCustomItems: Volatile<unknown>;
+  /** M5: the trusted command status-line config (armed ONLY while the USER
+   * profile layer owns it — see resolveTrustedFooterCommand). */
+  readonly footerCommand: Volatile<unknown>;
+  readonly fullscreen: Volatile<string>;
+  /** Busy-Enter delivery for plain Enter while the agent runs: 'queue'
+   * (default) or 'steer'. */
+  readonly busyEnter: Volatile<string>;
+  /** Local-shell sandbox for user-typed `!`/`!!` commands: 'bypass'
+   * (default) runs them outside the dsh sandbox, 'sandbox' routes them
+   * through the dsh shell capability's policy. */
+  readonly localShellSandbox: Volatile<string>;
+  /** Home/End navigation behavior (issue #9): 'input' (default) moves
+   * within the input, 'viewport' keeps Home/End scrolling. */
+  readonly homeEndKeys: Volatile<string>;
+  /** Canonical transcript display preset (focus | compact | full). */
+  readonly displayPreset: Volatile<string>;
+  /** Mid-turn progress-update cadence (off | milestones | frequent). */
+  readonly progressUpdates: Volatile<string>;
+  /** Visible-answer density guidance (default | concise | explanatory). */
+  readonly responseStyle: Volatile<string>;
+  /** Completion-notification mode ('unfocused' | 'always' | 'off'). */
+  readonly notificationMode: Volatile<string>;
+  /** Completion-notification method ('auto' | 'osc9' | 'osc777' | 'bell'). */
+  readonly notificationMethod: Volatile<string>;
+  /** Fullscreen mouse-wheel step ('1' | '2' | '3' | '5' | '8'). */
+  readonly wheelScrollLines: Volatile<string>;
+  /** The user keybinding overrides as a whole-value RAW field. The
+   * keybindings parser (src/keybindings/config.ts) is the only
+   * validation/parsing authority — the keybinding business schema
+   * deliberately stays out of the plugin Config. */
+  readonly keybindings: Volatile<unknown>;
+  /** Internal one-shot legacy-migration marker (PR A §8.3): never a
+   * product row, never a behavior switch — it only keeps the retired
+   * settings.yaml(.imported) from re-overwriting newer user values. */
+  readonly legacySettingsMigrationVersion: Volatile<number>;
 }
 declare const Config: z<Config>;
 /**
@@ -812,26 +890,25 @@ interface LegacyAgentComposition {
  *   standalone composition callers; that branch installs the caller-owned ref
  *   and does not require an Agent.
  * @param presetId - the requested preset, or `undefined` for the default.
- * @param focusState - the shared Focus runtime state (STRUCTURAL on
- *   purpose: the public declaration bundle must not inline src/focus.ts —
- *   the parameter only ever carries the runner's FocusState object, so a
- *   bare `{ enabled: boolean }` keeps the shipped .d.mts clean); when
- *   provided, the setup ALSO installs the dynamic Focus system-prompt
+ * @param displayState - the shared canonical DisplayState. When provided, the
+ *   setup also installs the dynamic Focus system-prompt
  *   section exactly once per composed agent (plan §9 — every composed
  *   root TUI agent gets it; /focus toggles never re-register).
  * @param diag - the diagnostics channel, when the caller has one.
+ * @param progressUpdatesState - optional live mid-turn update cadence. The
+ *   effective text is derived from this state AND `displayState` (Focus
+ *   suppresses the progress section without mutating this state), so a
+ *   progress state without a display state is not installable.
+ * @param responseStyleState - optional live visible-answer style guidance,
+ *   independent of display.
  * @returns the id to record on the header (absent without a roster) and the setup callback.
  * @throws when the roster supplies no such preset.
  */
-declare function composeAgent(ctx: Context, installSelection: ModelSelectionRef, presetId?: string, focusState?: {
-  enabled: boolean;
-}, diag?: Diag): Promise<LegacyAgentComposition>;
-declare function composeAgent(ctx: Context, installSelection: (agentCtx: Context, agent: Agent) => void, presetId?: string, focusState?: {
-  enabled: boolean;
-}, diag?: Diag): Promise<AgentComposition>;
+declare function composeAgent(ctx: Context, installSelection: ModelSelectionRef, presetId?: string, displayState?: DisplayState, diag?: Diag, progressUpdatesState?: ProgressUpdatesState, responseStyleState?: ResponseStyleState): Promise<LegacyAgentComposition>;
+declare function composeAgent(ctx: Context, installSelection: (agentCtx: Context, agent: Agent) => void, presetId?: string, displayState?: DisplayState, diag?: Diag, progressUpdatesState?: ProgressUpdatesState, responseStyleState?: ResponseStyleState): Promise<AgentComposition>;
 /**
- * The preset a persisted session actually runs, read from DSH 0.1.6-alpha.1's
- * V3 session projection (header initialization plus the latest selection event).
+ * The preset a persisted session actually runs, read from the DSH 0.1.6 V3
+ * session projection (header initialization plus the latest selection event).
  * @param ctx - the runner context.
  * @param sessionId - the persisted session id.
  * @returns the recorded preset id, or undefined to compose the default.
@@ -845,4 +922,4 @@ declare function recordedPreset(ctx: Context, sessionId: string): Promise<string
  */
 declare function apply(ctx: Context, config: Config): void;
 //#endregion
-export { AgentComposition, CompactionFold, CompactionSettleSurface, Config, HOST_COMMAND_CATALOG, InitialCatalogResolution, InterruptAgentLike, InterruptWriteOutcome, InterruptWriterLike, LOCAL_COMMANDS, PendingSubagentCall, QueueFoldResult, QueueInboxMessage, ResolveInitialCatalogOptions, SESSIONLESS_COMMANDS, ViewerOpenToken, apply, busyAfterTurnBoundary, commandIsLocalForAttachments, commandRejectsImages, compactingFromLog, composeAgent, contextRefreshKind, createViewerOpenToken, dangerCommand, foldCompactionEvent, foldQueueRows, forkSeed, inject, interruptAgent, isBareCommandLine, isLocalCommandLine, isPlainExitPrompt, matchPendingSubagentCall, name, normalizeSkillInvocation, recordedPreset, resolveInitialCatalog, resolveSubmitDelivery, resumeCommand, runningProfile, settleCompactionSurface, shouldConsumeAdvertisedMiss, subagentJobTranscriptId, subagentJobViewHint, taskRowSelectionDisposition, teardownViewerForSessionSwap, viewerActionCapability };
+export { AgentComposition, CompactionFold, CompactionSettleSurface, Config, HOST_COMMAND_CATALOG, InitialCatalogResolution, InterruptAgentLike, InterruptWriteOutcome, InterruptWriterLike, LOCAL_COMMANDS, PendingSubagentCall, QueueFoldResult, QueueInboxMessage, ResolveInitialCatalogOptions, SESSIONLESS_COMMANDS, ViewerOpenToken, apply, busyAfterTurnBoundary, commandIsLocalForAttachments, commandRejectsImages, compactingFromLog, composeAgent, contextRefreshKind, createViewerOpenToken, dangerCommand, foldCompactionEvent, foldQueueRows, inject, interruptAgent, isBareCommandLine, isLocalCommandLine, isPlainExitPrompt, matchPendingSubagentCall, name, normalizeSkillInvocation, recordedPreset, resolveInitialCatalog, resolveSubmitDelivery, resumeCommand, runningProfile, settleCompactionSurface, shouldConsumeAdvertisedMiss, subagentJobTranscriptId, subagentJobViewHint, taskRowSelectionDisposition, teardownViewerForSessionSwap, viewerActionCapability };

package/dist/index.mjs

@@ -1,3 +1,2 @@
-import { A as shouldConsumeAdvertisedMiss, C as normalizeSkillInvocation, D as resumeCommand, E as resolveSubmitDelivery, F as viewerActionCapability, L as forkSeed, M as subagentJobViewHint, N as taskRowSelectionDisposition, O as runningProfile, P as teardownViewerForSessionSwap, S as name, T as resolveInitialCatalog, _ as interruptAgent, a as apply, b as isPlainExitPrompt, c as commandRejectsImages, d as contextRefreshKind, f as createViewerOpenToken, g as inject, h as foldQueueRows, i as SESSIONLESS_COMMANDS, j as subagentJobTranscriptId, k as settleCompactionSurface, l as compactingFromLog, m as foldCompactionEvent, n as HOST_COMMAND_CATALOG, o as busyAfterTurnBoundary, p as dangerCommand, r as LOCAL_COMMANDS, s as commandIsLocalForAttachments, t as Config, u as composeAgent, v as isBareCommandLine, w as recordedPreset, x as matchPendingSubagentCall, y as isLocalCommandLine } from "./src-D-4-xTUd.mjs";
-import "./startup.mjs";
-export { Config, HOST_COMMAND_CATALOG, LOCAL_COMMANDS, SESSIONLESS_COMMANDS, apply, busyAfterTurnBoundary, commandIsLocalForAttachments, commandRejectsImages, compactingFromLog, composeAgent, contextRefreshKind, createViewerOpenToken, dangerCommand, foldCompactionEvent, foldQueueRows, forkSeed, inject, interruptAgent, isBareCommandLine, isLocalCommandLine, isPlainExitPrompt, matchPendingSubagentCall, name, normalizeSkillInvocation, recordedPreset, resolveInitialCatalog, resolveSubmitDelivery, resumeCommand, runningProfile, settleCompactionSurface, shouldConsumeAdvertisedMiss, subagentJobTranscriptId, subagentJobViewHint, taskRowSelectionDisposition, teardownViewerForSessionSwap, viewerActionCapability };
+import { A as shouldConsumeAdvertisedMiss, C as normalizeSkillInvocation, D as resumeCommand, E as resolveSubmitDelivery, F as viewerActionCapability, M as subagentJobViewHint, N as taskRowSelectionDisposition, O as runningProfile, P as teardownViewerForSessionSwap, S as name, T as resolveInitialCatalog, _ as interruptAgent, a as apply, b as isPlainExitPrompt, c as commandRejectsImages, d as contextRefreshKind, f as createViewerOpenToken, g as inject, h as foldQueueRows, i as SESSIONLESS_COMMANDS, j as subagentJobTranscriptId, k as settleCompactionSurface, l as compactingFromLog, m as foldCompactionEvent, n as HOST_COMMAND_CATALOG, o as busyAfterTurnBoundary, p as dangerCommand, r as LOCAL_COMMANDS, s as commandIsLocalForAttachments, t as Config, u as composeAgent, v as isBareCommandLine, w as recordedPreset, x as matchPendingSubagentCall, y as isLocalCommandLine } from "./src-R8SVGB-L.mjs";
+export { Config, HOST_COMMAND_CATALOG, LOCAL_COMMANDS, SESSIONLESS_COMMANDS, apply, busyAfterTurnBoundary, commandIsLocalForAttachments, commandRejectsImages, compactingFromLog, composeAgent, contextRefreshKind, createViewerOpenToken, dangerCommand, foldCompactionEvent, foldQueueRows, inject, interruptAgent, isBareCommandLine, isLocalCommandLine, isPlainExitPrompt, matchPendingSubagentCall, name, normalizeSkillInvocation, recordedPreset, resolveInitialCatalog, resolveSubmitDelivery, resumeCommand, runningProfile, settleCompactionSurface, shouldConsumeAdvertisedMiss, subagentJobTranscriptId, subagentJobViewHint, taskRowSelectionDisposition, teardownViewerForSessionSwap, viewerActionCapability };