@xmoon76/dsh-pi-tui 0.3.1 → 0.3.2

package/dist/builtins.mjs

@@ -1,5 +1,5 @@
 import { TUI_STARTUP_SERVICE } from "./startup.mjs";
-import { A as dshVersion, F as PI_TUI_EXTENSIONS_SERVICE } from "./src-ClAKiW0z.mjs";
+import { L as PI_TUI_EXTENSIONS_SERVICE, M as dshVersion } from "./src-oZjot5jQ.mjs";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
 //#region src/builtins.ts

package/dist/extension/advanced.d.mts

@@ -1,4 +1,4 @@
-import { E as PiTuiApiInfo, T as NormalizedKey, _ as ExtensionTier, at as TuiOverlayOptions, h as EditorSnapshot, v as ExtensionView } from "../public-types-2omeXG8d.mjs";
+import { E as PiTuiApiInfo, T as NormalizedKey, _ as ExtensionTier, at as TuiOverlayOptions, h as EditorSnapshot, v as ExtensionView } from "../public-types-CZz5_arj.mjs";
 
 //#region src/extension/advanced-types.d.ts
 /** API level of the advanced tier. Bumped only on advanced breaking changes. */

package/dist/extension/unstable.d.mts

@@ -1,4 +1,4 @@
-import { E as PiTuiApiInfo, _ as ExtensionTier, at as TuiOverlayOptions } from "../public-types-2omeXG8d.mjs";
+import { E as PiTuiApiInfo, _ as ExtensionTier, at as TuiOverlayOptions } from "../public-types-CZz5_arj.mjs";
 
 //#region src/extension/unstable-types.d.ts
 /** API level of the unstable tier. Bumped only on unstable breaking changes. */

package/dist/extensions.d.mts

@@ -1,4 +1,4 @@
-import { $ as TuiKeybindingHandle, A as RegistrationHandle, B as ToolPresentationSnapshot, C as MarkdownView, D as PiTuiCapability, E as PiTuiApiInfo, F as StackView, G as TuiAutocompleteRegistryView, H as TuiAutocompleteItem, I as StyledSpan, J as TuiCommandBridgeSnapshot, K as TuiAutocompleteSuggestions, L as SurfaceSnapshot, M as RowsView, N as SessionSnapshot, O as PiTuiSlotName, P as SpacerView, Q as TuiKeybindingContribution, R as SurfaceStateValues, S as InputWidget, T as NormalizedKey, U as TuiAutocompleteProvider, V as TuiAction, W as TuiAutocompleteQuery, X as TuiCommandContribution, Y as TuiCommandBridgeView, Z as TuiCommandHandle, _t as TuiThemeRegistryView, a as ContributionHealth, at as TuiOverlayOptions, b as FrameView, c as DockItem, ct as TuiRendererRegistryView, d as EditorHost, dt as TuiSettingsRegistrySnapshot, et as TuiKeybindingRegistrySnapshot, f as EditorHostAction, ft as TuiSettingsRegistryView, g as ExtensionEditor, gt as TuiThemeRegistrySnapshot, h as EditorSnapshot, ht as TuiThemeHandle, i as AutocompleteProviderContribution, it as TuiOverlayHandle, j as RegistrationSpec, k as PiTuiSlotSemantic, l as EditorContribution, lt as TuiSettingContribution, m as EditorInputEvent, mt as TuiThemeContribution, n as ActivitySnapshot, nt as TuiLocalCommandHandler, o as ContributionRecord, ot as TuiRendererHandle, p as EditorHostActionResult, pt as TuiSizeValue, q as TuiColorPalette, r as AutocompleteHandle, rt as TuiMessageRendererContribution, s as ContributionState, st as TuiRendererRegistrySnapshot, t as API_VERSION, tt as TuiKeybindingRegistryView, u as EditorHandle, ut as TuiSettingHandle, v as ExtensionView, vt as TuiToolRendererContribution, w as MessagePresentationSnapshot, x as HeaderBadge, y as FooterSegment, yt as describeKey, z as TextView } from "./public-types-2omeXG8d.mjs";
+import { $ as TuiKeybindingHandle, A as RegistrationHandle, B as ToolPresentationSnapshot, C as MarkdownView, D as PiTuiCapability, E as PiTuiApiInfo, F as StackView, G as TuiAutocompleteRegistryView, H as TuiAutocompleteItem, I as StyledSpan, J as TuiCommandBridgeSnapshot, K as TuiAutocompleteSuggestions, L as SurfaceSnapshot, M as RowsView, N as SessionSnapshot, O as PiTuiSlotName, P as SpacerView, Q as TuiKeybindingContribution, R as SurfaceStateValues, S as InputWidget, T as NormalizedKey, U as TuiAutocompleteProvider, V as TuiAction, W as TuiAutocompleteQuery, X as TuiCommandContribution, Y as TuiCommandBridgeView, Z as TuiCommandHandle, _t as TuiThemeRegistryView, a as ContributionHealth, at as TuiOverlayOptions, b as FrameView, c as DockItem, ct as TuiRendererRegistryView, d as EditorHost, dt as TuiSettingsRegistrySnapshot, et as TuiKeybindingRegistrySnapshot, f as EditorHostAction, ft as TuiSettingsRegistryView, g as ExtensionEditor, gt as TuiThemeRegistrySnapshot, h as EditorSnapshot, ht as TuiThemeHandle, i as AutocompleteProviderContribution, it as TuiOverlayHandle, j as RegistrationSpec, k as PiTuiSlotSemantic, l as EditorContribution, lt as TuiSettingContribution, m as EditorInputEvent, mt as TuiThemeContribution, n as ActivitySnapshot, nt as TuiLocalCommandHandler, o as ContributionRecord, ot as TuiRendererHandle, p as EditorHostActionResult, pt as TuiSizeValue, q as TuiColorPalette, r as AutocompleteHandle, rt as TuiMessageRendererContribution, s as ContributionState, st as TuiRendererRegistrySnapshot, t as API_VERSION, tt as TuiKeybindingRegistryView, u as EditorHandle, ut as TuiSettingHandle, v as ExtensionView, vt as TuiToolRendererContribution, w as MessagePresentationSnapshot, x as HeaderBadge, y as FooterSegment, yt as describeKey, z as TextView } from "./public-types-CZz5_arj.mjs";
 import { Context, Service } from "@deepseek-ai/cordis";
 
 //#region src/extension/service.d.ts

package/dist/extensions.mjs

@@ -1,3 +1,3 @@
 import "./startup.mjs";
-import { F as PI_TUI_EXTENSIONS_SERVICE, I as API_VERSION, L as describeKey, M as apply, N as inject, P as name } from "./src-ClAKiW0z.mjs";
+import { F as inject, I as name, L as PI_TUI_EXTENSIONS_SERVICE, P as apply, R as API_VERSION, z as describeKey } from "./src-oZjot5jQ.mjs";
 export { API_VERSION, PI_TUI_EXTENSIONS_SERVICE, apply, describeKey, inject, name };

package/dist/index.d.mts

@@ -4,6 +4,86 @@ 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";
+//#region src/image/admission.d.ts
+/** Structural subset of `ImageAttachmentRef`. */
+interface ImageAttachmentRefLike {
+  readonly attachmentId: string;
+  readonly mediaType: ImageMediaType;
+  readonly bytes: number;
+  readonly width: number;
+  readonly height: number;
+  readonly name?: string;
+}
+//#endregion
+//#region src/image/types.d.ts
+/**
+ * Image draft vocabulary for the TUI input pipeline (plan M1).
+ *
+ * The draft layer is TUI-owned: it stages clipboard/file bytes until a
+ * submission turns them into durable `ImageAttachmentRef`s through the dsh
+ * attachment service. Nothing in this module persists; the durable boundary
+ * is the harness's `ctx.attachments.saveImages()`.
+ *
+ * The media-type union mirrors `@deepseek-ai/dsh-attachment`'s
+ * `ImageMediaType` structurally, so drafts flow into the harness without a
+ * runtime dependency on the attachment package (AGENTS.md decision 7:
+ * structural typing for dsh services).
+ * @module @xmoon76/dsh-pi-tui/image/types
+ */
+/** Raster media types accepted by the TUI image intake. */
+type ImageMediaType = 'image/png' | 'image/jpeg' | 'image/webp' | 'image/gif';
+/** Per-TUI draft image identity; only meaningful inside one TUI run. */
+type DraftImageId = number;
+/** Where a staged image's bytes came from. */
+type DraftImageSource = {
+  readonly type: 'clipboard';
+} | {
+  readonly type: 'path';
+  readonly path: string;
+}
+/** The image was pulled back from a queued message: its bytes are ALREADY
+ * durable with the harness (the recalled ref) — the draft holds no local
+ * copy and re-submitting reuses the ref instead of re-uploading. */
+| {
+  readonly type: 'recalled';
+};
+/**
+ * One image staged in the editor draft. The draft holds the raw bytes so
+ * clipboard and path entries share one shape and a submit never depends on
+ * the source file still existing (plan §5.1). A RECALLED draft (pulled
+ * back from the queue) instead carries the durable `ImageAttachmentRef`
+ * and NO local bytes — the bytes stay in harness storage and re-submitting
+ * reuses the ref.
+ */
+interface DraftImage {
+  /** Per-TUI draft identity (the `#N` of the placeholder). */
+  readonly id: DraftImageId;
+  readonly kind: 'image';
+  readonly source: DraftImageSource;
+  /** Exact encoded bytes, held only for the draft lifetime. Empty for a
+   * recalled draft (its bytes live in harness storage). */
+  readonly bytes: Uint8Array;
+  readonly mediaType: ImageMediaType;
+  /** Intrinsic encoded width in pixels. */
+  readonly width: number;
+  /** Intrinsic encoded height in pixels. */
+  readonly height: number;
+  /** Exact encoded byte length (`bytes.byteLength` for local drafts; the
+   * durable ref's recorded `bytes` for recalled drafts). */
+  readonly byteLength: number;
+  /** Optional display name (basename for path sources), never a path. */
+  readonly name?: string;
+  /** The canonical editor placeholder text for this draft. */
+  readonly placeholder: string;
+  /** The durable ref this draft reuses on submit; present ONLY for
+   * recalled drafts (already-durable images are never re-uploaded). */
+  readonly recalledRef?: ImageAttachmentRefLike;
+}
+/** The store surface the placeholder expansion needs (structural). */
+interface DraftImageStoreLike {
+  values(): readonly DraftImage[];
+}
+//#endregion
 //#region src/diag.d.ts
 interface Diag {
   debug(message: string, fields?: Record<string, unknown>): void;
@@ -159,6 +239,23 @@ declare const SESSIONLESS_COMMANDS: Set<string>;
  * body — there is no command-execution wire for skills.
  */
 declare const LOCAL_COMMANDS: Set<string>;
+/**
+ * Command semantics matrix (plan §19.3/M12): a LOCAL command line carrying a
+ * staged image placeholder is REJECTED — local commands are pure UI
+ * controls, never LLM prompts. AGENT-FACING input (plain prompts AND
+ * per-skill slash invocations like `/grilling`) SUPPORTS images: the skill
+ * wrapper builds its message through the same prepared-input path, so an
+ * image-bearing skill line is a real multimodal prompt (review finding 4).
+ * There is never a silent drop.
+ * @param parsed - the parsed slash command, undefined for a plain prompt.
+ * @param text - the submission text.
+ * @param store - the live draft store.
+ * @param isLocal - whether the command name is a LOCAL (TUI-owned/UI)
+ *   command; skill names answer false.
+ */
+declare function commandRejectsImages(parsed: {
+  name: string;
+} | undefined, text: string, store: DraftImageStoreLike, isLocal: (name: string) => boolean): boolean;
 /**
  * The AUTHORITATIVE host-owned command catalog (P1-04): every command name
  * the TUI registers itself (registerTuiCommands in commands.ts) plus the
@@ -183,7 +280,23 @@ declare const HOST_COMMAND_CATALOG: ReadonlySet<string>;
  */
 declare function shouldSteerOnEnter(parsed: {
   name: string;
+  rawInput?: string;
 } | undefined, running: boolean, busyEnter: string | undefined, forceQueue: boolean, isDynamicLocal?: (name: string) => boolean): boolean;
+/**
+ * Normalize an explicit `/skill <name> <args>` invocation to the skill's
+ * own slash line `/<name> <args>` (review finding 2). The harness's
+ * explicit skill gesture scans for `/<skill-name>` — it would extract
+ * `skill` from a raw `/skill grilling ...` line and never inject the
+ * grilling body. The command handler already performs this conversion
+ * (`loadSkill` builds `'/' + skill.name + ' ' + args`); the busy-Enter
+ * steer path must use the SAME normalized line so the body injects and
+ * any image placeholders ride along.
+ * @param text - the submitted line.
+ * @returns the normalized `/<name> <args>` line, or undefined when the
+ *   line is not an explicit skill invocation (plain prompt, other
+ *   commands, or the bare `/skill` picker).
+ */
+declare function normalizeSkillInvocation(text: string): string | undefined;
 /**
  * The advertised-claim miss decision (pure, exported for the headless
  * suite): a slash input whose name was advertised by the completion list at
@@ -336,17 +449,6 @@ interface QueueFoldResult {
   /** Failed settlement summaries not yet notified (the caller notifies). */
   readonly failures: readonly string[];
 }
-/**
- * Build the queue-pane rows for one inbox batch, dropping background-subagent
- * settlement notices (the task browser is their surface) and reporting which
- * FAILED settlements should notify. Pure and injectable so the filter +
- * once-notify semantics are testable without the agent.
- * @param messages - one inbox batch (next-turn or next-step), in order.
- * @param mode - the delivery mode for surviving rows.
- * @param notified - the notify-once guard; failed notices already in it are
- *   skipped, and a newly-reported id is ADDED here so a re-render can never
- *   double-notify.
- */
 declare function foldQueueRows(messages: readonly QueueInboxMessage[], mode: 'followup' | 'steer', notified: Set<string>): QueueFoldResult;
 /**
  * Whether a shell command matches a destructive pattern. `rm` is treated
@@ -508,4 +610,4 @@ declare function recomposeBlank(ctx: Context, agent: {
  */
 declare function apply(ctx: Context, config: Config): void;
 //#endregion
-export { AgentComposition, CompactionFold, Config, HOST_COMMAND_CATALOG, InitialCatalogResolution, LOCAL_COMMANDS, PendingSubagentCall, QueueFoldResult, QueueInboxMessage, QueueNoticeSource, RecomposableSession, RecomposeOutcome, ResolveInitialCatalogOptions, SESSIONLESS_COMMANDS, SessionLockRefusedError, apply, busyAfterTurnBoundary, compactingFromLog, composeAgent, dangerCommand, foldCompactionEvent, foldQueueRows, forkSeed, inject, isPlainExitPrompt, isSubagentSettlementNotice, isUserQueueInput, matchPendingSubagentCall, name, recomposeBlank, recordedPreset, registerCredentialSurfaceRefresh, resolveInitialCatalog, resumeCommand, runningProfile, shouldConsumeAdvertisedMiss, shouldSteerOnEnter, subagentJobTranscriptId, subagentJobViewHint, subagentNoticeIsFailure };
+export { AgentComposition, CompactionFold, Config, HOST_COMMAND_CATALOG, InitialCatalogResolution, LOCAL_COMMANDS, PendingSubagentCall, QueueFoldResult, QueueInboxMessage, QueueNoticeSource, RecomposableSession, RecomposeOutcome, ResolveInitialCatalogOptions, SESSIONLESS_COMMANDS, SessionLockRefusedError, apply, busyAfterTurnBoundary, commandRejectsImages, compactingFromLog, composeAgent, dangerCommand, foldCompactionEvent, foldQueueRows, forkSeed, inject, isPlainExitPrompt, isSubagentSettlementNotice, isUserQueueInput, matchPendingSubagentCall, name, normalizeSkillInvocation, recomposeBlank, recordedPreset, registerCredentialSurfaceRefresh, resolveInitialCatalog, resumeCommand, runningProfile, shouldConsumeAdvertisedMiss, shouldSteerOnEnter, subagentJobTranscriptId, subagentJobViewHint, subagentNoticeIsFailure };

package/dist/index.mjs

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

package/dist/{public-types-2omeXG8d.d.mts → public-types-CZz5_arj.d.mts}

@@ -35,6 +35,9 @@ interface TuiColorPalette {
   diffGutter: string;
   diffMeta: string;
   roleUser: string;
+  /** Optional user-bubble background (dsh-web `--dsw-specific-bubble`
+   * parity); absent = no bubble block. */
+  roleUserBg?: string;
   shellMode: string;
 }
 /** One autocomplete suggestion item (structural — the host maps it onto