@xmoon76/dsh-pi-tui 0.3.4 → 0.3.5

package/dist/builtins.mjs

@@ -1,5 +1,5 @@
 import { TUI_STARTUP_SERVICE } from "./startup.mjs";
-import { H as PI_TUI_EXTENSIONS_SERVICE, L as dshVersion } from "./src-B1uP5j0d.mjs";
+import { I as dshVersion, V as PI_TUI_EXTENSIONS_SERVICE } from "./src-B93JMbsv.mjs";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
 //#region src/builtins.ts
@@ -36,18 +36,6 @@ function apply(ctx) {
 		text: installedDsh === void 0 ? `tui-v${packageVersion()}` : `dsh-${installedDsh} · tui-v${packageVersion()}`,
 		tone: "info"
 	});
-	const counters = service.register("chrome.footer.status", {
-		id: "builtin-turns-steps",
-		order: 1e3,
-		description: "Completed turns/steps counters (first-party builtin)."
-	}, { spans: [] });
-	const renderCounters = (state) => {
-		const spans = [{ text: `t${state.session.turns}/s${state.session.steps}` }];
-		counters.replace({ spans });
-	};
-	service.subscribeState((state) => {
-		renderCounters(state);
-	});
 	const todoDock = service.register("input.dock.item", {
 		id: "builtin-todo-summary",
 		order: 1e3,

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-CZz5_arj.mjs";
+import { D as PiTuiApiInfo, E as NormalizedKey, _ as ExtensionTier, h as EditorSnapshot, ot as TuiOverlayOptions, v as ExtensionView } from "../public-types-_pe9ZH00.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-CZz5_arj.mjs";
+import { D as PiTuiApiInfo, _ as ExtensionTier, ot as TuiOverlayOptions } from "../public-types-_pe9ZH00.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-CZz5_arj.mjs";
+import { $ as TuiKeybindingContribution, A as PiTuiSlotSemantic, B as TextView, C as InputWidget, D as PiTuiApiInfo, E as NormalizedKey, F as SpacerView, G as TuiAutocompleteQuery, H as TuiAction, I as StackView, J as TuiColorPalette, K as TuiAutocompleteRegistryView, L as StyledSpan, M as RegistrationSpec, N as RowsView, O as PiTuiCapability, P as SessionSnapshot, Q as TuiCommandHandle, R as SurfaceSnapshot, S as HeaderBadge, T as MessagePresentationSnapshot, U as TuiAutocompleteItem, V as ToolPresentationSnapshot, W as TuiAutocompleteProvider, X as TuiCommandBridgeView, Y as TuiCommandBridgeSnapshot, Z as TuiCommandContribution, _t as TuiThemeRegistrySnapshot, a as ContributionHealth, at as TuiOverlayHandle, b as FooterSegment, bt as describeKey, c as DockItem, ct as TuiRendererRegistrySnapshot, d as EditorHost, dt as TuiSettingHandle, et as TuiKeybindingHandle, f as EditorHostAction, ft as TuiSettingsRegistrySnapshot, g as ExtensionEditor, gt as TuiThemeHandle, h as EditorSnapshot, ht as TuiThemeContribution, i as AutocompleteProviderContribution, it as TuiMessageRendererContribution, j as RegistrationHandle, k as PiTuiSlotName, l as EditorContribution, lt as TuiRendererRegistryView, m as EditorInputEvent, mt as TuiSizeValue, n as ActivitySnapshot, nt as TuiKeybindingRegistryView, o as ContributionRecord, ot as TuiOverlayOptions, p as EditorHostActionResult, pt as TuiSettingsRegistryView, q as TuiAutocompleteSuggestions, r as AutocompleteHandle, rt as TuiLocalCommandHandler, s as ContributionState, st as TuiRendererHandle, t as API_VERSION, tt as TuiKeybindingRegistrySnapshot, u as EditorHandle, ut as TuiSettingContribution, v as ExtensionView, vt as TuiThemeRegistryView, w as MarkdownView, x as FrameView, y as FooterItemContribution, yt as TuiToolRendererContribution, z as SurfaceStateValues } from "./public-types-_pe9ZH00.mjs";
 import { Context, Service } from "@deepseek-ai/cordis";
 
 //#region src/extension/service.d.ts
@@ -53,10 +53,13 @@ interface PiTuiExtensionService {
    */
   registerSetting(contribution: TuiSettingContribution): TuiSettingHandle;
   /**
-   * Register a keybinding (M5, metadata only): normalized key → semantic
-   * action. Routing is Host-owned (the InputRouter lands in M6); until
-   * then the binding is recorded and reported. Reserved host keys are
-   * rejected. Owned by the calling fiber.
+   * Register a keybinding (M5): normalized key → public semantic action.
+   * The registry validates the contribution (public TuiAction whitelist,
+   * reserved keys, text-producing keys, editor-owned keys, legacy C0 collisions) and its
+   * records feed the LIVE InputRouter lookups + the runner's
+   * effective-keymap plugin rules (M6); routing precedence stays
+   * Host-owned. Rejections throw loudly; the binding is owned by the
+   * calling fiber.
    * @param contribution - the binding contribution.
    */
   registerKeybinding(contribution: TuiKeybindingContribution): TuiKeybindingHandle;
@@ -129,4 +132,4 @@ declare const inject: string[];
  */
 declare function apply(ctx: Context): void;
 //#endregion
-export { API_VERSION, type ActivitySnapshot, type AutocompleteHandle, type AutocompleteProviderContribution, type ContributionHealth, type ContributionRecord, type ContributionState, type DockItem, type EditorContribution, type EditorHandle, type EditorHost, type EditorHostAction, type EditorHostActionResult, type EditorInputEvent, type EditorSnapshot, type ExtensionEditor, type ExtensionView, type FooterSegment, type FrameView, type HeaderBadge, type InputWidget, type MarkdownView, type MessagePresentationSnapshot, type NormalizedKey, PI_TUI_EXTENSIONS_SERVICE, type PiTuiApiInfo, type PiTuiCapability, type PiTuiExtensionService, type PiTuiSlotName, type PiTuiSlotSemantic, type RegistrationHandle, type RegistrationSpec, type RowsView, type SessionSnapshot, type SpacerView, type StackView, type StyledSpan, type SurfaceSnapshot, type SurfaceStateValues, type TextView, type ToolPresentationSnapshot, type TuiAction, type TuiAutocompleteItem, type TuiAutocompleteProvider, type TuiAutocompleteQuery, type TuiAutocompleteRegistryView, type TuiAutocompleteSuggestions, type TuiColorPalette, type TuiCommandBridgeSnapshot, type TuiCommandBridgeView, type TuiCommandContribution, type TuiCommandHandle, type TuiKeybindingContribution, type TuiKeybindingHandle, type TuiKeybindingRegistrySnapshot, type TuiKeybindingRegistryView, type TuiLocalCommandHandler, type TuiMessageRendererContribution, type TuiOverlayHandle, type TuiOverlayOptions, type TuiRendererHandle, type TuiRendererRegistrySnapshot, type TuiSettingContribution, type TuiSettingHandle, type TuiSettingsRegistrySnapshot, type TuiSettingsRegistryView, type TuiSizeValue, type TuiThemeContribution, type TuiThemeHandle, type TuiThemeRegistrySnapshot, type TuiThemeRegistryView, type TuiToolRendererContribution, apply, describeKey, inject, name };
+export { API_VERSION, type ActivitySnapshot, type AutocompleteHandle, type AutocompleteProviderContribution, type ContributionHealth, type ContributionRecord, type ContributionState, type DockItem, type EditorContribution, type EditorHandle, type EditorHost, type EditorHostAction, type EditorHostActionResult, type EditorInputEvent, type EditorSnapshot, type ExtensionEditor, type ExtensionView, type FooterItemContribution, type FooterSegment, type FrameView, type HeaderBadge, type InputWidget, type MarkdownView, type MessagePresentationSnapshot, type NormalizedKey, PI_TUI_EXTENSIONS_SERVICE, type PiTuiApiInfo, type PiTuiCapability, type PiTuiExtensionService, type PiTuiSlotName, type PiTuiSlotSemantic, type RegistrationHandle, type RegistrationSpec, type RowsView, type SessionSnapshot, type SpacerView, type StackView, type StyledSpan, type SurfaceSnapshot, type SurfaceStateValues, type TextView, type ToolPresentationSnapshot, type TuiAction, type TuiAutocompleteItem, type TuiAutocompleteProvider, type TuiAutocompleteQuery, type TuiAutocompleteRegistryView, type TuiAutocompleteSuggestions, type TuiColorPalette, type TuiCommandBridgeSnapshot, type TuiCommandBridgeView, type TuiCommandContribution, type TuiCommandHandle, type TuiKeybindingContribution, type TuiKeybindingHandle, type TuiKeybindingRegistrySnapshot, type TuiKeybindingRegistryView, type TuiLocalCommandHandler, type TuiMessageRendererContribution, type TuiOverlayHandle, type TuiOverlayOptions, type TuiRendererHandle, type TuiRendererRegistrySnapshot, type TuiSettingContribution, type TuiSettingHandle, type TuiSettingsRegistrySnapshot, type TuiSettingsRegistryView, type TuiSizeValue, type TuiThemeContribution, type TuiThemeHandle, type TuiThemeRegistrySnapshot, type TuiThemeRegistryView, type TuiToolRendererContribution, apply, describeKey, inject, name };

package/dist/extensions.mjs

@@ -1,3 +1,3 @@
 import "./startup.mjs";
-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-B1uP5j0d.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-B93JMbsv.mjs";
 export { API_VERSION, PI_TUI_EXTENSIONS_SERVICE, apply, describeKey, inject, name };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { V as TuiAction } from "./public-types-CZz5_arj.mjs";
+import { H as TuiAction } from "./public-types-_pe9ZH00.mjs";
 import z from "@deepseek-ai/schemastery";
 import { Agent, ModelSelectionRef } from "@deepseek-ai/dsh-agent";
 import { ContentBlock } from "@deepseek-ai/dsh-llm";
@@ -212,16 +212,6 @@ interface Config {
   sessionId?: string;
 }
 declare const Config: z<Config>;
-/**
- * Wire the credential surface refresh to the dsh 0.1.1-rc.1 credential
- * events. The rc.1 release split the credential update event into the
- * reference half and the durable-record half; both change what the footer
- * model row and the welcome card show (a /login /logout, an external
- * .credentials.yaml edit, or an authorization flow committing a record), so
- * they share one best-effort callback. The callback must not read secrets
- * or mutate providers — it only re-reads describe-level state.
- */
-declare function registerCredentialSurfaceRefresh(ctx: Context, refresh: () => void): void;
 /**
  * Slash commands that need no session: before the first user message
  * (deferred start) they run locally without creating one. Everything else
@@ -745,4 +735,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, registerCredentialSurfaceRefresh, 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, 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 "./startup.mjs";
-import { A as shouldConsumeAdvertisedMiss, C as recomposeBlank, 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 normalizeSkillInvocation, T as registerCredentialSurfaceRefresh, _ 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 shouldSteerOnEnter, k as settleCompactionSurface, 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-B1uP5j0d.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, registerCredentialSurfaceRefresh, resolveInitialCatalog, resumeCommand, runningProfile, settleCompactionSurface, shouldConsumeAdvertisedMiss, shouldSteerOnEnter, subagentJobTranscriptId, subagentJobViewHint, subagentNoticeIsFailure, teardownViewerForSessionSwap, viewerActionCapability };
+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-B93JMbsv.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 };

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

@@ -70,9 +70,9 @@ interface TuiAutocompleteProvider {
 /** API version of the extension surface (bumped only on breaking changes). */
 declare const API_VERSION: 1;
 /** Capability identifiers, feature-detected via {@link PiTuiApiInfo}. */
-type PiTuiCapability = 'slot.chrome.header.badge' | 'slot.input.dock.item' | 'slot.chrome.footer.status' | 'slot.input.widget' | 'surface.snapshot' | 'advanced.input.capture' | 'advanced.ui.interactive' | 'advanced.editor.control' | 'unstable.input.raw' | 'unstable.surface.handle';
+type PiTuiCapability = 'slot.chrome.header.badge' | 'slot.input.dock.item' | 'slot.chrome.footer.status' | 'slot.chrome.footer.item' | 'slot.input.widget' | 'surface.snapshot' | 'advanced.input.capture' | 'advanced.ui.interactive' | 'advanced.editor.control' | 'unstable.input.raw' | 'unstable.surface.handle';
 /** Slot identities this bundle knows; unknown names are rejected at registration. */
-type PiTuiSlotName = 'chrome.header.badge' | 'input.dock.item' | 'chrome.footer.status' | 'input.widget.above' | 'input.widget.below';
+type PiTuiSlotName = 'chrome.header.badge' | 'input.dock.item' | 'chrome.footer.status' | 'chrome.footer.item' | 'input.widget.above' | 'input.widget.below';
 /** Slot semantics: how competing contributions resolve. */
 type PiTuiSlotSemantic = 'list' | 'single';
 /** Extension tier metadata shared by every tier entry (plan §4/§5). */
@@ -132,8 +132,14 @@ interface ContributionRecord<T> {
   readonly order: number;
   readonly priority: number;
   readonly description: string | undefined;
-  /** The Cordis fiber name that owns this registration (diagnostics). */
+  /** The Cordis fiber identity that owns this registration, UID-QUALIFIED
+   * (`<uid>:<name>`) — diagnostics, uniqueness and owner-scoped disposal
+   * never conflate two anonymous sibling fibers. */
   readonly owner: string;
+  /** The HMR-STABLE owner identity for slots whose canonical keys are
+   * PERSISTED across reloads (chrome.footer.item). Absent → the key
+   * derives from `owner`. */
+  readonly stableOwner?: string;
   /** The live contribution value. */
   readonly value: T;
 }
@@ -216,6 +222,34 @@ interface FooterSegment {
   readonly minWidth?: number;
   readonly importance?: number;
 }
+/**
+ * M4: one configurable footer item contribution (the `chrome.footer.item`
+ * slot). Plain data only — the host compiles and renders; a plugin never
+ * touches ANSI, width, layout or the terminal. The item becomes a
+ * first-class citizen of the footer configurator: users can show/hide,
+ * reorder and zone-place it like any builtin item. Dynamic updates use the
+ * standard `handle.replace(...)` / `handle.invalidate()` pattern.
+ */
+interface FooterItemContribution {
+  /** The picker label (shown in /footer and /settings). */
+  readonly label: string;
+  readonly description?: string;
+  /** The rendered segment (the LIVE value — replace() swaps it). The
+   * segment's OWN `minWidth` is the item's minimum renderable width
+   * (never truncated below it) and is the AUTHORITY when both are set. */
+  readonly segment: FooterSegment;
+  /** Where the item lands by default in a fresh layout. */
+  readonly defaultZone?: 'left' | 'right';
+  /** Layout weight: lower importance items drop first under pressure. */
+  readonly importance?: number;
+  /**
+   * @deprecated Use `segment.minWidth` — the segment is the single
+   * min-width authority and WINS when both are set. This top-level field
+   * is kept (and still honored when the segment carries none) so earlier
+   * draft code keeps type-checking; new code must set it on the segment.
+   */
+  readonly minWidth?: number;
+}
 /** One styled run of text. The host owns ANSI compilation; plugins supply
  * semantic tokens only (no raw escapes, ever). */
 interface StyledSpan {
@@ -366,7 +400,10 @@ interface TuiCommandBridgeSnapshot {
 /** One registered theme contribution (M5). */
 interface TuiThemeContribution {
   readonly id: string;
-  /** The SELECTABLE name (shown in the theme picker). */
+  /** The DISPLAY name (shown in the theme picker). The selection IDENTITY
+   * is the source-qualified value `plugin:<owner>/<id>` — a display name
+   * is a label only and never round-trips back to an identity (the
+   * review's P2). */
   readonly name: string;
   /** The semantic palette (hex colours; the host maps it at apply time). */
   readonly palette: TuiColorPalette;
@@ -440,10 +477,32 @@ interface TuiCommandBridgeView {
   isLocal(name: string, staticLocal: ReadonlySet<string>): boolean;
   snapshot(): TuiCommandBridgeSnapshot;
 }
-/** The read-side of the theme registry (M5). */
+/** The read-side of the theme registry (M5). Selections are addressed by
+ * SOURCE-QUALIFIED selectable values (`plugin:<owner>/<id>`), never by
+ * the bare display name — the picker/apply/persist protocol (the review's
+ * P2: a bare name shared the custom-FILE namespace, so a persisted value's
+ * meaning depended on which source existed). */
 interface TuiThemeRegistryView {
+  /** The display names (diagnostics / /status counts only). */
   names(): string[];
+  /** DEPRECATED (still functional for the current API version — removal
+   * requires the next breaking API version): the palette behind a bare
+   * display NAME. The bare name is ambiguous now that plugin themes and
+   * custom files can share one (the source-qualified
+   * {@link paletteForSelectable} is the identity-addressed read). Kept as
+   * a source-compatibility shim: the concrete registry never dropped it,
+   * so removing it from this view would break existing Stable plugins'
+   * typecheck without a runtime need (the review's P1/P2). */
   paletteFor(name: string): TuiColorPalette | undefined;
+  /** The source-qualified selectable values (the /settings picker's
+   * plugin section; sorted). */
+  selectableValues(): string[];
+  /** The palette for one source-qualified selectable value. */
+  paletteForSelectable(value: string): TuiColorPalette | undefined;
+  /** The display name behind one source-qualified selectable value. */
+  displayNameForSelectable(value: string): string | undefined;
+  /** Whether one source-qualified selectable value is live. */
+  hasSelectable(value: string): boolean;
   snapshot(): TuiThemeRegistrySnapshot;
 }
 /** The read-side of the settings registry (M5). */
@@ -483,7 +542,11 @@ interface NormalizedKey {
 }
 /** The semantic actions a plugin may bind (plan §2.2 / §11). */
 type TuiAction = 'submit-draft' | 'queue-draft' | 'steer-draft' | 'cancel-activity' | 'open-search' | 'toggle-fullscreen' | 'cycle-permission';
-/** One keybinding contribution (M5 metadata only; routing in M6). */
+/** One keybinding contribution (M5): a normalized key + one of the
+ * PUBLIC semantic actions. The registry validates and canonicalizes it
+ * (action whitelist, reserved keys, text-producing keys, editor-owned keys, legacy C0
+ * collisions); the records feed the LIVE InputRouter lookups and the
+ * runner's effective-keymap plugin rules (M6). */
 interface TuiKeybindingContribution {
   readonly id: string;
   readonly key: NormalizedKey;
@@ -569,7 +632,10 @@ interface TuiRendererHandle {
 }
 /** The read-side of the renderer registry (M7): the host's message cache
  * asks it to present a message/tool through the plugin chain. The
- * concrete registry is host-internal. */
+ * concrete registry is host-internal. The ABI is owner-LESS (the Stable
+ * v1 contract — an existing plugin's `(id, error)` callback must never
+ * receive the host's owner in the error slot); the host's OWNER-scoped
+ * health path uses the concrete registry's *Owned variants. */
 interface TuiRendererRegistryView {
   renderMessage(snapshot: MessagePresentationSnapshot, onError: (id: string, error: unknown) => void, canUse?: (id: string, view: ExtensionView) => boolean): {
     view: ExtensionView;
@@ -740,4 +806,4 @@ interface ExtensionEditor {
   dispose(): void;
 }
 //#endregion
-export { TuiKeybindingHandle as $, RegistrationHandle as A, ToolPresentationSnapshot as B, MarkdownView as C, PiTuiCapability as D, PiTuiApiInfo as E, StackView as F, TuiAutocompleteRegistryView as G, TuiAutocompleteItem as H, StyledSpan as I, TuiCommandBridgeSnapshot as J, TuiAutocompleteSuggestions as K, SurfaceSnapshot as L, RowsView as M, SessionSnapshot as N, PiTuiSlotName as O, SpacerView as P, TuiKeybindingContribution as Q, SurfaceStateValues as R, InputWidget as S, NormalizedKey as T, TuiAutocompleteProvider as U, TuiAction as V, TuiAutocompleteQuery as W, TuiCommandContribution as X, TuiCommandBridgeView as Y, TuiCommandHandle as Z, ExtensionTier as _, TuiThemeRegistryView as _t, ContributionHealth as a, TuiOverlayOptions as at, FrameView as b, DockItem as c, TuiRendererRegistryView as ct, EditorHost as d, TuiSettingsRegistrySnapshot as dt, TuiKeybindingRegistrySnapshot as et, EditorHostAction as f, TuiSettingsRegistryView as ft, ExtensionEditor as g, TuiThemeRegistrySnapshot as gt, EditorSnapshot as h, TuiThemeHandle as ht, AutocompleteProviderContribution as i, TuiOverlayHandle as it, RegistrationSpec as j, PiTuiSlotSemantic as k, EditorContribution as l, TuiSettingContribution as lt, EditorInputEvent as m, TuiThemeContribution as mt, ActivitySnapshot as n, TuiLocalCommandHandler as nt, ContributionRecord as o, TuiRendererHandle as ot, EditorHostActionResult as p, TuiSizeValue as pt, TuiColorPalette as q, AutocompleteHandle as r, TuiMessageRendererContribution as rt, ContributionState as s, TuiRendererRegistrySnapshot as st, API_VERSION as t, TuiKeybindingRegistryView as tt, EditorHandle as u, TuiSettingHandle as ut, ExtensionView as v, TuiToolRendererContribution as vt, MessagePresentationSnapshot as w, HeaderBadge as x, FooterSegment as y, describeKey as yt, TextView as z };
+export { TuiKeybindingContribution as $, PiTuiSlotSemantic as A, TextView as B, InputWidget as C, PiTuiApiInfo as D, NormalizedKey as E, SpacerView as F, TuiAutocompleteQuery as G, TuiAction as H, StackView as I, TuiColorPalette as J, TuiAutocompleteRegistryView as K, StyledSpan as L, RegistrationSpec as M, RowsView as N, PiTuiCapability as O, SessionSnapshot as P, TuiCommandHandle as Q, SurfaceSnapshot as R, HeaderBadge as S, MessagePresentationSnapshot as T, TuiAutocompleteItem as U, ToolPresentationSnapshot as V, TuiAutocompleteProvider as W, TuiCommandBridgeView as X, TuiCommandBridgeSnapshot as Y, TuiCommandContribution as Z, ExtensionTier as _, TuiThemeRegistrySnapshot as _t, ContributionHealth as a, TuiOverlayHandle as at, FooterSegment as b, describeKey as bt, DockItem as c, TuiRendererRegistrySnapshot as ct, EditorHost as d, TuiSettingHandle as dt, TuiKeybindingHandle as et, EditorHostAction as f, TuiSettingsRegistrySnapshot as ft, ExtensionEditor as g, TuiThemeHandle as gt, EditorSnapshot as h, TuiThemeContribution as ht, AutocompleteProviderContribution as i, TuiMessageRendererContribution as it, RegistrationHandle as j, PiTuiSlotName as k, EditorContribution as l, TuiRendererRegistryView as lt, EditorInputEvent as m, TuiSizeValue as mt, ActivitySnapshot as n, TuiKeybindingRegistryView as nt, ContributionRecord as o, TuiOverlayOptions as ot, EditorHostActionResult as p, TuiSettingsRegistryView as pt, TuiAutocompleteSuggestions as q, AutocompleteHandle as r, TuiLocalCommandHandler as rt, ContributionState as s, TuiRendererHandle as st, API_VERSION as t, TuiKeybindingRegistrySnapshot as tt, EditorHandle as u, TuiSettingContribution as ut, ExtensionView as v, TuiThemeRegistryView as vt, MarkdownView as w, FrameView as x, FooterItemContribution as y, TuiToolRendererContribution as yt, SurfaceStateValues as z };