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

package/README.en.md

@@ -54,11 +54,11 @@ next compatibility range, and fallback paths.
 
 | TUI package line | Official DSH tags for the pairing | Notes |
 |---|---|---|
-| `0.4.5` (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.5`) | `dsh-v0.1.5-rc.1`, `dsh-v0.1.5-rc.2` | Current next line |
+| `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.5-rc.1` npm floor; older runtimes fail at the normal
+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`
@@ -114,9 +114,10 @@ dsh --profile pi-tui --session <session-id>
 * Todo / Goal status
 * Human-readable terminal window titles
 * Bounded long-session windows with stable paging and live-follow position
+* Long user prompts collapse to head + marker + tail; `Ctrl+O` expands and collapses them in regular mode and in fullscreen outside Focus
 * No duplicate ghost Tool Cards after compaction / pruning
 
-`Ctrl+O` controls Tool and System details — and in fullscreen Focus it bulk-expands the recent Thought roots or collapses them all. `Alt+T` controls Thinking separately.
+`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
 
@@ -187,11 +188,16 @@ The browser distinguishes:
 * nested descendants
 * background Jobs
 
-The two views share the same runtime state: `A` toggles Active / All scope,
-`Tab` changes type filters, `/` enters search, `S` stops the selected task after
-confirmation, and `N` / `Shift+N` moves between running tasks. In Quick Tasks,
-`T` or the bottom “View all” row opens the full Task Center, and `Esc` returns
-one layer at a time.
+The Footer's `↓` opens Quick Tasks as a lightweight browsing view: it only
+supports arrow navigation, left/right expand/collapse, `Tab` type cycling,
+`Enter` open, and `Esc` close. The bottom “Open Task Center” row opens the full
+Task Center.
+
+The full Task Center additionally offers `A` to toggle Active / All, `/` search,
+`Tab` / `Shift+Tab` to cycle types in both directions, `S` to stop the selected
+task after confirmation, and `R` to refresh/retry. Quick Tasks consumes only the
+whitelist above; every other keystroke is a no-op that never enters search, stop
+confirmation, or management state, so `Esc` always closes it in one layer.
 
 Completed one-shot Subagents remain available for persisted Transcript inspection.
 
@@ -305,8 +311,8 @@ For the full `/footer` workflow, Custom Text / Command items, YAML reference, se
 | `Ctrl+T`      | Toggle the todo panel                               |
 | `Ctrl+R`      | Search input history                                |
 | `Ctrl+F`      | Search Transcript                                   |
-| `Ctrl+End`    | Jump to the latest Transcript output in fullscreen  |
-| `Ctrl+O`      | Expand / collapse Tool and System details; in fullscreen Focus, bulk-toggle the Thought roots |
+| `Ctrl+End`    | Jump to the latest Transcript output in fullscreen; a clickable `↓ Latest` appears after leaving the live tail |
+| `Ctrl+O`      | Expand / collapse Tool and System details and long user prompts in regular/fullscreen-non-Focus; in fullscreen Focus, bulk-toggle the Thought roots (expand long user prompts by clicking the marker) |
 | `Alt+T`       | Expand / collapse Thinking                          |
 | `Ctrl+G`      | Edit current input in `$VISUAL`/`$EDITOR`           |
 | `Ctrl+V`      | Paste image                                         |
@@ -557,7 +563,7 @@ 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.5-rc.1` family declared by this checkout's `package.json` and
+`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
 family from the public registry and exercises the TUI build/test/package path:
 

package/README.md

@@ -52,11 +52,11 @@ pnpm compat:dsh:npm
 
 | TUI 包版本 | 对应的官方 DSH tags | 说明 |
 |---|---|---|
-| `0.4.5`（已发布 `@latest`） | `dsh-v0.1.5-rc.1`、`dsh-v0.1.5-rc.2` | 当前稳定版；最低 rc.1，兼容 rc.2 |
-| 当前 `next` npm 线（本 checkout；版本 `0.4.5`） | `dsh-v0.1.5-rc.1`、`dsh-v0.1.5-rc.2` | 当前 next 线 |
+| `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 线 |
 
 不要把稳定线与 `next` 线混装。当前 `next` checkout 的 peer floor 是
-`>=0.1.5-rc.1`，旧 runtime 会在正常的不兼容边界以非零状态失败。完整的
+`>=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)。
 
@@ -108,9 +108,10 @@ dsh --profile pi-tui --session <session-id>
 * Todo / Goal 状态展示
 * 可读的终端窗口标题
 * 长会话按有界窗口浏览，并保留翻页与实时跟随位置
+* 超长用户 Prompt 默认折叠为 head + marker + tail；普通与全屏非 Focus 下 `Ctrl+O` 展开、收回
 * Compaction / prune 后不会出现重复的幽灵 Tool Card
 
-`Ctrl+O` 控制工具和系统详情;在全屏 Focus 下它整体展开最近几个 Thought root,或全部收起。`Alt+T` 单独控制 Thinking。
+`Ctrl+O` 控制工具和系统详情，并在普通模式与全屏非 Focus 下展开/收起超长用户 Prompt;全屏 Focus 下它整体展开最近几个 Thought root 或全部收起，超长用户 Prompt 改用点击提示行（或搜索命中）展开、`Ctrl+O` 收回。`Alt+T` 单独控制 Thinking。
 
 ### Focus Mode
 
@@ -180,7 +181,9 @@ main
 * nested descendant
 * 后台 Job
 
-两个视图共享同一份运行时状态：`A` 切换 Active / All scope，`Tab` 切换类型过滤，`/` 进入搜索，`S`（确认后）停止所选任务，`N` / `Shift+N` 在运行中的任务间跳转，Quick 内 `T` 或底部 "View all" 行进入完整 Task Center，`Esc` 逐层返回。
+Footer `↓` 打开的 Quick Tasks 是轻量浏览视图，只提供方向键导航、左右展开/折叠、`Tab` 类型过滤、`Enter` 打开和 `Esc` 关闭。底部 “Open Task Center” 行可进入完整 Task Center。
+
+完整 Task Center 额外提供 `A` 切换 Active / All、`/` 搜索、`Tab` / `Shift+Tab` 双向切换类型、`S`（确认后）停止所选任务以及 `R` 刷新 / 重试。Quick Tasks 只消费上述白名单按键，其余输入一律 no-op，不会进入搜索、停止确认或任务管理状态，因此 `Esc` 始终一层关闭。
 
 已经结束的 one-shot Subagent 仍可以打开并查看持久化 Transcript。
 
@@ -291,8 +294,8 @@ TUI 使用 DSH 提供的模型和设置服务。
 | `Ctrl+T`      | 切换 Todo 面板              |
 | `Ctrl+R`      | 搜索输入历史                 |
 | `Ctrl+F`      | 搜索 Transcript          |
-| `Ctrl+End`    | 全屏时跳到最新 Transcript 输出 |
-| `Ctrl+O`      | 展开 / 折叠工具和系统详情;全屏 Focus 下整体切换 Thought root |
+| `Ctrl+End`    | 全屏时跳到最新 Transcript 输出；离开 live tail 时底部显示可点击的 `↓ Latest` |
+| `Ctrl+O`      | 展开 / 折叠工具和系统详情；普通与全屏非 Focus 下展开/收起超长用户 Prompt；全屏 Focus 下整体切换 Thought root（超长用户 Prompt 用点击/搜索展开） |
 | `Alt+T`       | 展开 / 折叠 Thinking       |
 | `Ctrl+G`      | 使用 `$VISUAL`/`$EDITOR` 编辑输入 |
 | `Ctrl+V`      | 粘贴图片                   |
@@ -533,7 +536,7 @@ dsh --profile pi-tui-dev
 ### npm 模式（当前 `next`）
 
 当前 `next` 线是 npm 模式：以本 checkout 的 `package.json` 声明、冻结
-lockfile 解析的已发布 `dsh-v0.1.5-rc.1` family 为兼容目标。隔离的 npm
+lockfile 解析的已发布 `dsh-v0.1.6-alpha.1` family 为兼容目标。隔离的 npm
 驱动从公共 registry 安装该精确 family，并跑完整 build/test/package 路径：
 
 ```sh

package/cordis.patch.yml

@@ -63,12 +63,6 @@
     - id: subagent-model-selection-settings
       name: '@deepseek-ai/dsh-tool-subagent/model-selection-settings'
 
-    # Host-plane TypeScript runtime: the `ptc` preset's `tool-presentation`
-    # row waits for `codeRuntime` and fails the preset at mount without it
-    # (same host row the web bundle inserts).
-    - id: code-runtime
-      name: '@deepseek-ai/dsh-code-runtime-worker-thread'
-
     # Host-plane cordis runner: the `cordis` preset's `tool-cordis` row waits
     # for `dynamicCordisRunner`/`cordisInspect` and fails the preset at mount
     # without them (same host row the web bundle inserts).
@@ -93,7 +87,10 @@
 # goal/jobs/compaction services and
 # their host infrastructure, `permission`, `approval`, `sandbox*`,
 # `fs-observation-policy`, `spill*`, `timeout-policy`, `repeat-tool-reminder`,
-# `session-*`, `token-meter`. `command-goal` is disabled below and reintroduced
+# `session-*`, `token-meter`. The base's official `ptc-runtime` row also stays:
+# it provides `ptcRuntime`, which the `ptc` preset's `tool-presentation` row
+# waits for, and this overlay owns no second PTC runtime.
+# `command-goal` is disabled below and reintroduced
 # only by presets that own that command in their scoped composition.
 
 - id: tool-bash
@@ -147,7 +144,7 @@
 - id: tool-subagent-fork
   disabled: true
 
-- id: workflow-worker-thread
+- id: workflow-ptc
   disabled: true
 
 - id: tool-workflow

package/dist/builtins.mjs

@@ -1,4 +1,4 @@
-import { W as PI_TUI_EXTENSIONS_SERVICE, z as dshVersion } from "./src-B65x1oP2.mjs";
+import { I as dshVersion, V as PI_TUI_EXTENSIONS_SERVICE } from "./src-D-4-xTUd.mjs";
 import { TUI_STARTUP_SERVICE } from "./startup.mjs";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";

package/dist/extensions.mjs

@@ -1,3 +1,3 @@
-import { G as API_VERSION, H as inject, K as describeKey, U as name, V as apply, W as PI_TUI_EXTENSIONS_SERVICE } from "./src-B65x1oP2.mjs";
+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";
 export { API_VERSION, PI_TUI_EXTENSIONS_SERVICE, apply, describeKey, inject, name };

package/dist/index.d.mts

@@ -3,9 +3,7 @@ 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 { CommandDescriptor } from "@deepseek-ai/dsh-commands";
 import { Context } from "@deepseek-ai/cordis";
-import { SessionEvent as SessionEvent$1 } from "@deepseek-ai/dsh-session/types";
 //#region src/image/admission.d.ts
 /** Structural subset of `ImageAttachmentRef`. */
 interface ImageAttachmentRefLike {
@@ -114,6 +112,8 @@ interface HumanSkillSummary {
   readonly name: string;
   readonly description: string;
   readonly whenToUse?: string;
+  /** Official model-invocation capability; Host-local paths are omitted. */
+  readonly modelInvocable?: boolean;
 }
 /** The detached human skill catalog one observation produced. */
 interface HumanSkillCatalog {
@@ -147,23 +147,47 @@ type CompactionPhase = 'idle' | 'summarizing' | 'applying';
  * accelerated chord to its OPPOSITE — so the chord is never a fixed mode.
  */
 type ComposerSubmitGesture = 'enter' | 'accelerated';
-/** One queued inbox row for the queue pane (mirrors the agent Inbox's lists). */
+/** One semantic queued pending-input row for the queue pane. */
 interface QueueItem {
-  /** The pending message id (agent inbox identity). */
+  /** The pending message id (agent inbox identity), or a local request id. */
   id: string;
   /** The message text, single-line display form. */
   text: string;
   /** next-turn followup vs next-step steer. */
   mode: 'followup' | 'steer';
-  /** Plugin notice (e.g. a background-job completion): NOT steerable — it
-   * renders with its own marker and the hint drops the steer verbs. */
-  notice?: boolean;
+  /** The correlation identity (authoritative rpc id or local request id). */
+  rpcId?: string;
+  /** A client-local echo not yet backed by an authoritative occurrence. */
+  local?: boolean;
 }
 //#endregion
 //#region src/surface-catalog.d.ts
+/** Minimal live-agent face consumed by the effective catalog readers. */
+interface SurfaceCatalogAgent {
+  readonly ctx: object;
+  readonly session: {
+    readonly header: {
+      readonly cwd?: string;
+    };
+  };
+}
+/** Local structural command face, compatible with both npm and Source Mode DSH.
+ * The optional identity is part of the official 0.1.6 descriptor; an older
+ * runtime's descriptor may omit it. */
+interface SurfaceCommandDescriptor {
+  readonly definitionId?: string;
+  readonly name: string;
+  readonly description: string;
+  readonly input?: {
+    readonly hint: string;
+    readonly attachments?: boolean;
+  };
+}
 /** One effective command's discovery metadata (the official descriptor's
- * display fields; never a handler or a definition). */
+ * display fields and optional stable identity; never a handler or definition). */
 interface SurfaceCommandSummary {
+  /** Stable plugin-owned identity from the official command descriptor. */
+  readonly definitionId?: string;
   readonly name: string;
   readonly description: string;
   readonly input?: {
@@ -196,7 +220,7 @@ interface SurfaceCatalogSnapshot {
 }
 /** The commands-service surface the collector reads. */
 interface SurfaceCommandsService {
-  list(agent: Agent): readonly CommandDescriptor[];
+  list(agent: SurfaceCatalogAgent): readonly SurfaceCommandDescriptor[];
 }
 /** The narrow context surface {@link readSurfaceCatalog} consumes. The
  * SKILL services are NOT reached here: every dsh skill/agent-presets
@@ -427,6 +451,31 @@ declare function normalizeSkillInvocation(text: string): string | undefined;
 declare function shouldConsumeAdvertisedMiss(execution: {
   readonly result: unknown;
 } | undefined, wasAdvertised: boolean): boolean;
+/** Public settlement shape for the interrupt helper. Kept local so the
+ * entry-point declaration does not expose the internal runtime port module. */
+type InterruptWriteOutcome = {
+  readonly kind: 'committed';
+  readonly value: undefined;
+} | {
+  readonly kind: 'rejected';
+  readonly error: {
+    readonly code: string;
+    readonly message: string;
+    readonly details?: Readonly<Record<string, unknown>>;
+  };
+} | {
+  readonly kind: 'cancelled';
+} | {
+  readonly kind: 'indeterminate';
+  readonly error: {
+    readonly code: string;
+    readonly message: string;
+    readonly details?: Readonly<Record<string, unknown>>;
+  };
+} | {
+  readonly kind: 'unsupported';
+  readonly reason: string;
+};
 /** The live-agent surface {@link interruptAgent} needs (structural — the
  * TUI never imports the agent runtime for this call). */
 interface InterruptAgentLike {
@@ -444,11 +493,7 @@ interface InterruptAgentLike {
  * type so the public declaration never inlines internal runtime modules;
  * the runner's SessionWriter satisfies it). */
 interface InterruptWriterLike {
-  cancel(sessionId: string, reason: {
-    kind: 'user';
-  }, options: {
-    keepInbox: boolean;
-  }): void;
+  cancel(sessionId: string): Promise<InterruptWriteOutcome>;
 }
 /**
  * Interrupt the live agent (web Stop parity): abort the current
@@ -469,7 +514,7 @@ interface InterruptWriterLike {
  * log, which the design explicitly rejects — the parked queue is the
  * agreed web-parity behavior until upstream lands the capability.
  */
-declare function interruptAgent(agent: InterruptAgentLike | undefined, writer: InterruptWriterLike): void;
+declare function interruptAgent(agent: InterruptAgentLike | undefined, writer: InterruptWriterLike): Promise<InterruptWriteOutcome>;
 /** One unsettled subagent delegation, in tool/call order. */
 interface PendingSubagentCall {
   readonly callId: string;
@@ -594,30 +639,18 @@ interface ResolveInitialCatalogOptions {
 }
 declare function resolveInitialCatalog(options: ResolveInitialCatalogOptions): Promise<InitialCatalogResolution>;
 declare function subagentJobTranscriptId(snapshot: unknown): string | undefined;
-/** Viewer body for a subagent job with no uniquely matched child. */
-declare function subagentJobViewHint(status: string, detail: string | undefined): string;
-/** The message-source projection the queue filter reads (a structural subset
- * of dsh's message sources, so the helpers are testable without dsh types). */
-interface QueueNoticeSource {
-  readonly form?: string;
-  readonly kind?: string;
-  readonly summary?: string;
-  /** The reporting child's session id (subagent-report relays). */
-  readonly senderSessionId?: string;
-}
 /**
- * Whether an inbox message is USER-ORIGIN input — the queue pane's steerable
- * `❯` rows. Everything else is injected context, not the user's own queued
- * input, and must never read as one: plugin notices (background-job
- * completions), `subagent-report` relays (a child's active report, e.g.
- * "Background subagent X reported:"), injected skill/agent instructions,
- * goal messages. The web makes the same cut (`placement: source.kind ===
- * 'user' ? 'steering' : 'context'`), and this deployment's queue pane has
- * the same rule: only user-origin rows are steerable. A sourceless row
- * (undefined) is treated as user input — plain rows never carry a source.
- * @param source - the message source projection, or undefined for a plain row.
+ * The Task Center row-selection disposition (plan §4.3/§4.4). A subagent
+ * transcript opens a session/viewer surface that REPLACES the browser; a
+ * Job row's detail keeps it mounted (the caller passes {@link openJobView}'s
+ * disposition). An UNKNOWN row — a stale panel selection after a live
+ * re-projection — also keeps the parent usable instead of dismissing it.
  */
-declare function isUserQueueInput(source: QueueNoticeSource | undefined): boolean;
+declare function taskRowSelectionDisposition(row: {
+  readonly kind: 'job' | 'subagent';
+} | undefined, jobDetail: 'close' | 'keep-open'): 'close' | 'keep-open';
+/** Viewer body for a subagent job with no uniquely matched child. */
+declare function subagentJobViewHint(status: string, detail: string | undefined): string;
 /**
  * Whether a plain submitted draft is the quit word: exactly `exit` (trimmed,
  * lowercase). The runner intercepts this BEFORE any session creation or
@@ -626,47 +659,18 @@ declare function isUserQueueInput(source: QueueNoticeSource | undefined): boolea
  * @param text - the submitted draft.
  */
 declare function isPlainExitPrompt(text: string): boolean;
-/**
- * Whether an inbox message is a BACKGROUND-SUBAGENT settlement notice — the
- * runtime's account of a child ending, not steerable user input. Two dsh
- * producers push these into the parent's inbox:
- *  - continuable children: `source.kind === 'subagent-settled'` (the
- *    continuation manager's settlement notice);
- *  - one-shot background subagent jobs: tool-jobs completion notices whose
- *    summary starts with the job kind (`subagent <label> [status: …]`).
- * The queue pane mirrors the inbox, but these belong to the task browser
- * (terminal job rows / inactive child rows), so the mirror drops them and
- * only failures surface as a transient error notify.
- * @param source - the message source projection, or undefined for a plain row.
- */
-declare function isSubagentSettlementNotice(source: QueueNoticeSource | undefined): boolean;
-/**
- * Whether a subagent settlement notice reports FAILURE, classified on the
- * producers' own deterministic wording:
- *  - `subagent-settled` summaries: "finished and will do no further work"
- *    is the only success wording; aborted / max-tokens / refusal / error /
- *    unknown endings all fail;
- *  - tool-jobs subagent summaries carry the terminal status line, whose
- *    failure statuses are `failed` and `killed` (dsh JobStatus).
- * A notice that cannot be classified is treated as success (silent).
- * @param source - the message source projection.
- */
-declare function subagentNoticeIsFailure(source: QueueNoticeSource | undefined): boolean;
-/** One inbox message as the queue mirror sees it (a structural projection). */
+/** One semantic pending-input item as the queue mirror sees it. */
 interface QueueInboxMessage {
   readonly id: string;
   readonly content: readonly ContentBlock[];
-  readonly source?: QueueNoticeSource;
 }
-/** The mirror result for one inbox batch: the rows to show plus the failed
- * settlement summaries the caller should notify (each once). */
+/** The queue-pane rows for one semantic pending-input batch. */
 interface QueueFoldResult {
-  /** Queue rows (background-subagent settlement notices excluded). */
   readonly rows: QueueItem[];
-  /** Failed settlement summaries not yet notified (the caller notifies). */
-  readonly failures: readonly string[];
 }
-declare function foldQueueRows(messages: readonly QueueInboxMessage[], mode: 'followup' | 'steer', notified: Set<string>): QueueFoldResult;
+/** Build queue-pane rows from semantic pending-input occurrences, preserving
+ * their order and content without inspecting backend-specific metadata. */
+declare function foldQueueRows(messages: readonly QueueInboxMessage[], mode: 'followup' | 'steer'): QueueFoldResult;
 /**
  * Whether a shell command matches a destructive pattern. `rm` is treated
  * specially: any spelling of recursive + force flags (`rm -rf`, `rm -r -f`,
@@ -826,45 +830,13 @@ declare function composeAgent(ctx: Context, installSelection: (agentCtx: Context
   enabled: boolean;
 }, diag?: Diag): Promise<AgentComposition>;
 /**
- * The preset a persisted session actually runs, read from DSH 0.1.5-rc.1's
+ * 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).
  * @param ctx - the runner context.
  * @param sessionId - the persisted session id.
  * @returns the recorded preset id, or undefined to compose the default.
  */
 declare function recordedPreset(ctx: Context, sessionId: string): Promise<string | undefined>;
-/** The session surface {@link recomposeBlank} needs: its log and the append seam. */
-interface RecomposableSession {
-  readonly id: string;
-  snapshotEvents(): readonly SessionEvent$1[];
-  append(type: 'agent-preset/selected', data: {
-    agentPreset: string;
-  }): unknown;
-}
-/** Outcome of {@link recomposeBlank}: the swap committed, or the session is locked. */
-type RecomposeOutcome = {
-  kind: 'switched';
-  preset: string;
-} | {
-  kind: 'locked';
-};
-/**
- * Re-compose one agent onto another preset while its session is still blank.
- *
- * A started conversation's history was produced under its preset's tools, so
- * only a session with no `turn/start` event may swap — the same rule as the
- * official `agentPreset.select` RPC. The selection is appended to the log only
- * after the swap committed (a rejected mount leaves the old composition).
- * @param ctx - the runner context.
- * @param agent - the live agent whose composition to swap.
- * @param id - the target preset id.
- * @returns `switched` with the committed preset id, or `locked` when a turn has run.
- * @throws when the roster supplies no such preset or its composition is unusable.
- */
-declare function recomposeBlank(ctx: Context, agent: {
-  ctx: Context;
-  session: RecomposableSession;
-}, id: string): Promise<RecomposeOutcome>;
 /**
  * Mount the TUI: resolve the model selection, create or resume the agent,
  * wire the surface to the agent, and subscribe to the session firehose.
@@ -873,4 +845,4 @@ declare function recomposeBlank(ctx: Context, agent: {
  */
 declare function apply(ctx: Context, config: Config): void;
 //#endregion
-export { AgentComposition, CompactionFold, CompactionSettleSurface, Config, HOST_COMMAND_CATALOG, InitialCatalogResolution, InterruptAgentLike, InterruptWriterLike, LOCAL_COMMANDS, PendingSubagentCall, QueueFoldResult, QueueInboxMessage, QueueNoticeSource, RecomposableSession, RecomposeOutcome, ResolveInitialCatalogOptions, SESSIONLESS_COMMANDS, ViewerOpenToken, apply, busyAfterTurnBoundary, commandIsLocalForAttachments, commandRejectsImages, compactingFromLog, composeAgent, contextRefreshKind, createViewerOpenToken, dangerCommand, foldCompactionEvent, foldQueueRows, forkSeed, inject, interruptAgent, isBareCommandLine, isLocalCommandLine, isPlainExitPrompt, isSubagentSettlementNotice, isUserQueueInput, matchPendingSubagentCall, name, normalizeSkillInvocation, recomposeBlank, recordedPreset, resolveInitialCatalog, resolveSubmitDelivery, resumeCommand, runningProfile, settleCompactionSurface, shouldConsumeAdvertisedMiss, subagentJobTranscriptId, subagentJobViewHint, subagentNoticeIsFailure, 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, forkSeed, 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,3 @@
-import { A as resumeCommand, B as forkSeed, C as matchPendingSubagentCall, D as recordedPreset, E as recomposeBlank, F as subagentJobViewHint, I as subagentNoticeIsFailure, L as teardownViewerForSessionSwap, M as settleCompactionSurface, N as shouldConsumeAdvertisedMiss, O as resolveInitialCatalog, P as subagentJobTranscriptId, R as viewerActionCapability, S as isUserQueueInput, T as normalizeSkillInvocation, _ 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 runningProfile, k as resolveSubmitDelivery, 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 name, x as isSubagentSettlementNotice, y as isLocalCommandLine } from "./src-B65x1oP2.mjs";
+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, isSubagentSettlementNotice, isUserQueueInput, matchPendingSubagentCall, name, normalizeSkillInvocation, recomposeBlank, recordedPreset, resolveInitialCatalog, resolveSubmitDelivery, resumeCommand, runningProfile, settleCompactionSurface, shouldConsumeAdvertisedMiss, subagentJobTranscriptId, subagentJobViewHint, subagentNoticeIsFailure, teardownViewerForSessionSwap, viewerActionCapability };
+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 };