@xmoon76/dsh-pi-tui 0.4.7-alpha.2 → 0.4.9

package/dist/index.d.mts

@@ -3,7 +3,7 @@ import z from "@deepseek-ai/schemastery";
 import { Agent, ModelSelectionRef } from "@deepseek-ai/dsh-agent";
 import { ContentBlock } from "@deepseek-ai/dsh-llm";
 import { SessionId } from "@deepseek-ai/dsh-session";
-import { Context } from "@deepseek-ai/cordis";
+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
@@ -265,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;
@@ -279,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>;
 /**
@@ -672,20 +756,43 @@ declare function foldQueueRows(messages: readonly QueueInboxMessage[], mode: 'fo
  */
 declare function dangerCommand(command: string): boolean;
 /**
- * The dsh profile this process was launched with (the `--profile` flag),
- * so the exit-time resume hint names the profile the TUI actually runs
- * under. Falls back to `pi-tui` when the flag is absent (the TUI bundle
- * cannot load without a profile, so this is defensive only).
+ * The dsh profile named by the `--profile` flag in `argv`, in both spellings.
+ * This is the ARGV-ONLY fallback: it cannot see the positional `dsh <name>`
+ * launch form, because the launcher consumes that bare name by synthesizing
+ * `['--profile', ...argv]` for its OWN commander parse and leaves
+ * `process.argv` untouched. Prefer {@link hostRunningProfile}, which reads the
+ * Host's profile identity instead of scraping the command line.
  * @param argv - the process argument vector.
  * @param fallback - the default profile.
  */
 declare function runningProfile(argv?: readonly string[], fallback?: string): string;
+/** The one context read {@link hostRunningProfile} needs (a cordis Context satisfies it). */
+interface ProfileContextReadLike {
+  get(name: string): unknown;
+}
+/**
+ * The profile this process actually runs — the official Host
+ * `profileContext.name` when it is composed, else {@link runningProfile}'s
+ * argv scrape.
+ *
+ * `profileContext.name` is the launcher's own profile identity, so it is
+ * correct for EVERY launch form: `--profile <name>`, `--profile=<name>`, the
+ * positional `dsh <name>`, and `--from-default-profile <name>`. The argv
+ * scrape only knows the flag form, which is why it is the fallback for a
+ * profile-less mount (tests, an embedded surface) rather than the primary
+ * source.
+ * @param ctx - the plugin context (or any structural `get`-only stand-in).
+ * @param argv - the process argument vector for the fallback path.
+ * @param fallback - the default profile for the fallback path.
+ * @returns the running profile name.
+ */
+declare function hostRunningProfile(ctx: ProfileContextReadLike, argv?: readonly string[], fallback?: string): string;
 /**
  * The interactive-quit resume hint (pi parity): `dsh --profile <p>
  * --session <id>`, printed after the terminal restores so the user can
  * re-enter the session later. Returns undefined when there is no session
  * to resume (deferred start never created one).
- * @param profile - the running profile ({@link runningProfile}).
+ * @param profile - the running profile ({@link hostRunningProfile}).
  * @param sessionId - the live session id.
  * @returns the resume command line, or undefined without a session.
  */
@@ -806,23 +913,22 @@ 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 the DSH 0.1.6 V3
  * session projection (header initialization plus the latest selection event).
@@ -839,4 +945,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, 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, ProfileContextReadLike, QueueFoldResult, QueueInboxMessage, ResolveInitialCatalogOptions, SESSIONLESS_COMMANDS, ViewerOpenToken, apply, busyAfterTurnBoundary, commandIsLocalForAttachments, commandRejectsImages, compactingFromLog, composeAgent, contextRefreshKind, createViewerOpenToken, dangerCommand, foldCompactionEvent, foldQueueRows, hostRunningProfile, 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,2 +1,2 @@
-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-5aY9svZj.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 };
+import { A as settleCompactionSurface, C as name, D as resolveSubmitDelivery, E as resolveInitialCatalog, F as teardownViewerForSessionSwap, I as viewerActionCapability, M as subagentJobTranscriptId, N as subagentJobViewHint, O as resumeCommand, P as taskRowSelectionDisposition, S as matchPendingSubagentCall, T as recordedPreset, _ as inject, a as apply, b as isLocalCommandLine, c as commandRejectsImages, d as contextRefreshKind, f as createViewerOpenToken, g as hostRunningProfile, h as foldQueueRows, i as SESSIONLESS_COMMANDS, j as shouldConsumeAdvertisedMiss, k as runningProfile, 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 interruptAgent, w as normalizeSkillInvocation, x as isPlainExitPrompt, y as isBareCommandLine } from "./src-BAwPimrH.mjs";
+export { Config, HOST_COMMAND_CATALOG, LOCAL_COMMANDS, SESSIONLESS_COMMANDS, apply, busyAfterTurnBoundary, commandIsLocalForAttachments, commandRejectsImages, compactingFromLog, composeAgent, contextRefreshKind, createViewerOpenToken, dangerCommand, foldCompactionEvent, foldQueueRows, hostRunningProfile, inject, interruptAgent, isBareCommandLine, isLocalCommandLine, isPlainExitPrompt, matchPendingSubagentCall, name, normalizeSkillInvocation, recordedPreset, resolveInitialCatalog, resolveSubmitDelivery, resumeCommand, runningProfile, settleCompactionSurface, shouldConsumeAdvertisedMiss, subagentJobTranscriptId, subagentJobViewHint, taskRowSelectionDisposition, teardownViewerForSessionSwap, viewerActionCapability };