@xmoon76/dsh-pi-tui 0.3.6 → 0.4.0-alpha.2

package/dist/extension/unstable.d.mts

@@ -4,15 +4,35 @@ import { D as PiTuiApiInfo, _ as ExtensionTier, ot as TuiOverlayOptions } from "
 /** API level of the unstable tier. Bumped only on unstable breaking changes. */
 declare const UNSTABLE_API_LEVEL: 1;
 /**
- * One raw terminal input chunk (plan §5). The plugin receives the RAW
- * bytes exactly as the terminal delivered them — no decoding, no
- * sanitization. `surfaceId` identifies the surface generation the chunk
- * arrived on.
+ * One normalized terminal input sequence (plan §5). The plugin receives
+ * the input AFTER the terminal pipeline has reassembled and normalized it
+ * — NOT the raw OS byte stream. The Host's input path is:
+ *
+ * ```text
+ * OS stdin
+ *   → ProcessTerminal / StdinBuffer (batched chunks split into individual
+ *     sequences; bracketed-paste content re-wrapped in its markers)
+ *   → keyboard-protocol negotiation (Kitty flags / DA replies filtered)
+ *   → native modifier normalization (Windows / Apple Terminal Return →
+ *     CSI-u Shift+Enter)
+ *   → TUI-owned query replies filtered (OSC11 background, color-scheme
+ *     reports, cell-size responses)
+ *   → TUI input listeners
+ *   → THIS capture (BEFORE Host semantic routing)
+ * ```
+ *
+ * So the sequence is a `preHostInput` event: it can see, consume or
+ * rewrite anything the Host router would otherwise decode — Enter, Esc,
+ * Ctrl+C, bracketed paste (markers preserved), CSI-u sequences — but it
+ * CANNOT see the terminal-negotiation replies the TUI itself consumes
+ * (Kitty/DA, OSC11, color-scheme, cell-size), and it never sees raw
+ * multi-byte chunks mid-sequence. `surfaceId` identifies the surface
+ * generation the sequence arrived on.
  */
 interface UnstableRawInputEvent {
-  /** The raw terminal data (a chunk, not necessarily one key). */
+  /** The normalized terminal input sequence (a sequence, not a raw chunk). */
   readonly data: string;
-  /** The surface generation the chunk arrived on. */
+  /** The surface generation the sequence arrived on. */
   readonly surfaceId: string;
 }
 /** The outcome of one raw interception (plan §5). */
@@ -33,12 +53,17 @@ type UnstableRawInputResult = /** Pass the chunk through unchanged (the Host con
 type UnstableRawCaptureMode = 'observe' | 'capture' | 'exclusive';
 /**
  * One raw input capture registration (plan §5/§8). The capture is
- * consulted by the Host BEFORE terminal protocol decoding — it can see,
- * consume or rewrite ANY raw chunk, including Enter, Esc, Ctrl+C, paste,
- * CSI-u sequences and terminal-specific protocols. This is the Unstable
- * contract: a broken capture can make Host shortcuts stop working. The
- * ONLY Host-owned recovery is the emergency fail-safe (triple-Esc), which
- * the Unstable API cannot rewrite.
+ * consulted by the Host BEFORE semantic routing — after the terminal
+ * pipeline has reassembled and normalized the input (see
+ * {@link UnstableRawInputEvent}): it can see, consume or rewrite any
+ * sequence that would otherwise reach the Host router, including Enter,
+ * Esc, Ctrl+C, paste and CSI-u sequences. It is NOT consulted before
+ * terminal protocol decoding: the TUI's own negotiation replies (Kitty
+ * flags, DA, OSC11, color-scheme, cell-size) never reach a capture, and
+ * a capture cannot break the terminal negotiation. This is the Unstable
+ * contract: a broken capture can still make Host shortcuts stop working.
+ * The ONLY Host-owned recovery is the emergency fail-safe (triple-Esc),
+ * which the Unstable API cannot rewrite.
  *
  * Modes:
  * - `observe` — never consumes or rewrites; a pure observer.
@@ -48,8 +73,8 @@ type UnstableRawCaptureMode = 'observe' | 'capture' | 'exclusive';
  *   registration is an explicit error, never a load-order winner.
  *
  * Ordering is deterministic: `priority` ASC, then `id` ASC. A throwing
- * handler is isolated (health ledger) and FAILS OPEN — the chunk passes
- * through, so a broken capture can never stall the TUI.
+ * handler is isolated (health ledger) and FAILS OPEN — the sequence
+ * passes through, so a broken capture can never stall the TUI.
  */
 interface UnstableRawInputSpec {
   /** Stable diagnostic identity, unique per owner. */
@@ -83,7 +108,9 @@ interface UnstableRawInputHandle {
 interface UnstableMountedComponent {
   /** Render the current state as raw terminal lines at the given width. */
   render(width: number): string[];
-  /** Receive one raw input chunk while this component owns focus. */
+  /** Receive one normalized terminal input sequence while this component
+   * owns focus (the same preHostInput contract as
+   * {@link UnstableRawInputEvent} — never raw OS bytes). */
   handleInput?(raw: string): void;
   /** The component was disposed (mount closed / surface died). */
   dispose?(): void;
@@ -133,9 +160,10 @@ interface UnstableSurfaceHandle {
   requestRender(): void;
   /**
    * Mount a low-level component (plan §9 option A) as a capturing overlay.
-   * The plugin renders RAW lines and receives RAW input; the Host owns
-   * the physical mount, focus, stacking, fullscreen migration and
-   * teardown. Caller-fiber-owned lease.
+   * The plugin renders RAW lines and receives the normalized input
+   * sequence (the preHostInput contract — see UnstableRawInputEvent;
+   * never raw OS bytes); the Host owns the physical mount, focus,
+   * stacking, fullscreen migration and teardown. Caller-fiber-owned lease.
    */
   mountComponent(component: UnstableMountedComponent, options?: TuiOverlayOptions): UnstableMountLease;
 }

package/dist/extensions.mjs

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

package/dist/index.d.mts

@@ -5,6 +5,7 @@ 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 {
@@ -210,6 +211,16 @@ declare const inject: string[];
 interface Config {
   /** Resumed session id; a fresh session is created when absent. */
   sessionId?: string;
+  /** Test seam: the pre-mount status output (defaults to process.stdout,
+   * TTY-gated). Injectable so the runner tests capture the status writes
+   * without patching the global stdout (which would fight the test
+   * reporter's own writes). STRUCTURAL on purpose: the public Config type
+   * must not reference the internal startup-status module (the public
+   * .d.mts leak gate). */
+  startupStatusOutput?: {
+    readonly isTTY?: boolean;
+    write(text: string): unknown;
+  };
 }
 declare const Config: z<Config>;
 /**
@@ -467,6 +478,11 @@ interface ResolveInitialCatalogOptions {
   /** The context surface the collectors read services from. */
   readonly ctx: SurfaceCatalogContext;
   readonly diag: Diag;
+  /** Suspend the pre-mount startup status before an ordinary log write
+   * (the status owns the current terminal line; a TTY shares one cursor
+   * between stdout and stderr). Called right before every diag.warn this
+   * function may emit. */
+  readonly onLog?: () => void;
 }
 declare function resolveInitialCatalog(options: ResolveInitialCatalogOptions): Promise<InitialCatalogResolution>;
 declare function subagentJobTranscriptId(snapshot: unknown): string | undefined;
@@ -635,6 +651,15 @@ declare function settleCompactionSurface(app: CompactionSettleSurface, refreshSt
  * turn can close (turn/end) before its compaction settles, and the
  * single-Esc cancel must stay armed until compaction/end. */
 declare function busyAfterTurnBoundary(eventType: 'turn/start' | 'turn/end', compacting: boolean): boolean;
+/** PR D2 test seam: whether a session event type marks the model-visible
+ * context dirty (re-measure through the SessionReader port) or only
+ * repaints cheaply (cached measurement). The firehose routes every event
+ * through this classification — the single source of truth for the
+ * status/measurement split. `compaction/end` is classified 'measure' but
+ * the firehose deliberately SKIPS it here: a matched compaction settle
+ * re-measures through the fold-outcome path (settleCompactionSurface), so
+ * a STALE compaction/end can never trigger a measurement. */
+declare function contextRefreshKind(eventType: string): 'measure' | 'cheap';
 /**
  * The in-flight compaction state a resumed session log implies: the newest
  * compaction bracket decides. A `session/end-seed` boundary makes any
@@ -670,7 +695,10 @@ interface AgentComposition {
  * A deployment with no roster composes nothing and every session shares the
  * host composition, which is the behavior before presets existed.
  * @param ctx - the runner context (services read through `ctx.get`).
- * @param selected - the mutable model selection every setup installs.
+ * @param installSelection - installs a fresh Agent-local model selection ref
+ *   during setup. A ModelSelectionRef is still accepted for source
+ *   compatibility with standalone composition callers; the runner always
+ *   supplies the Agent-local installer.
  * @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 —
@@ -683,13 +711,12 @@ interface AgentComposition {
  * @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, selected: ModelSelectionRef, presetId?: string, focusState?: {
+declare function composeAgent(ctx: Context, installSelection: ((agentCtx: Context) => void) | ModelSelectionRef, presetId?: string, focusState?: {
   enabled: boolean;
 }, diag?: Diag): Promise<AgentComposition>;
 /**
- * The preset a persisted session actually runs, from its log (newest
- * selection winning), or undefined when persistence is absent, the session is
- * unknown, or its log predates the roster.
+ * The preset a persisted session actually runs, resolved by the DSH 0.1.2+
+ * 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.
@@ -698,7 +725,7 @@ declare function recordedPreset(ctx: Context, sessionId: string): Promise<string
 /** The session surface {@link recomposeBlank} needs: its log and the append seam. */
 interface RecomposableSession {
   readonly id: string;
-  readonly events: readonly SessionEvent[];
+  snapshotEvents(): readonly SessionEvent$1[];
   append(type: 'agent-preset/selected', data: {
     agentPreset: string;
   }): unknown;
@@ -735,4 +762,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, SessionLockRefusedError, ViewerOpenToken, apply, busyAfterTurnBoundary, commandRejectsImages, compactingFromLog, composeAgent, createViewerOpenToken, dangerCommand, foldCompactionEvent, foldQueueRows, forkSeed, inject, interruptAgent, isPlainExitPrompt, isSubagentSettlementNotice, isUserQueueInput, matchPendingSubagentCall, name, normalizeSkillInvocation, recomposeBlank, recordedPreset, resolveInitialCatalog, resumeCommand, runningProfile, settleCompactionSurface, shouldConsumeAdvertisedMiss, shouldSteerOnEnter, subagentJobTranscriptId, subagentJobViewHint, subagentNoticeIsFailure, teardownViewerForSessionSwap, viewerActionCapability };
+export { AgentComposition, CompactionFold, CompactionSettleSurface, Config, HOST_COMMAND_CATALOG, InitialCatalogResolution, InterruptAgentLike, InterruptWriterLike, LOCAL_COMMANDS, PendingSubagentCall, QueueFoldResult, QueueInboxMessage, QueueNoticeSource, RecomposableSession, RecomposeOutcome, ResolveInitialCatalogOptions, SESSIONLESS_COMMANDS, SessionLockRefusedError, ViewerOpenToken, apply, busyAfterTurnBoundary, commandRejectsImages, compactingFromLog, composeAgent, contextRefreshKind, createViewerOpenToken, dangerCommand, foldCompactionEvent, foldQueueRows, forkSeed, inject, interruptAgent, isPlainExitPrompt, isSubagentSettlementNotice, isUserQueueInput, matchPendingSubagentCall, name, normalizeSkillInvocation, recomposeBlank, recordedPreset, resolveInitialCatalog, resumeCommand, runningProfile, settleCompactionSurface, shouldConsumeAdvertisedMiss, shouldSteerOnEnter, subagentJobTranscriptId, subagentJobViewHint, subagentNoticeIsFailure, teardownViewerForSessionSwap, viewerActionCapability };

package/dist/index.mjs

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