@timurproko/a1 0.2.7-dev.1221 → 0.2.7-dev.1225

package/dist/native/darwin-x64/terminal-host.manifest.json

@@ -9,11 +9,11 @@
   "architecture": "x64",
   "target": "x86_64-apple-darwin",
   "capability": "supported",
-  "builtAt": "2026-10-28T07:20:46.993Z",
+  "builtAt": "2026-10-29T14:05:46.398Z",
   "artifact": {
     "filename": "terminal-host.node",
-    "sha256": "b3dfb167c40179f65bb381bfd701f97bce42ee99bf935ae98c99e4a5bd4c7f01",
-    "size": 6552896
+    "sha256": "5b2b2de17a50a371271c32546cc3c89bc6b16a96c39a534174fe5bb4ca1d60d6",
+    "size": 6562120
   },
   "entry": {
     "filename": "dist/foundation/resident-tabs/host-entry.js",

package/dist/native/linux-x64/manifest.json

@@ -7,7 +7,7 @@
   "platform": "linux",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-10-28T07:15:51.475Z",
+  "builtAt": "2026-10-29T14:00:03.332Z",
   "artifact": {
     "filename": "process-guardian.node",
     "sha256": "118e5954e3864672bd8482ab7edf419cb27dcdf2533720316979b7f5cc5a53a5",

package/dist/native/linux-x64/terminal-host.manifest.json

@@ -9,11 +9,11 @@
   "architecture": "x64",
   "target": "x86_64-unknown-linux-gnu",
   "capability": "supported",
-  "builtAt": "2026-10-28T07:18:32.802Z",
+  "builtAt": "2026-10-29T14:03:25.788Z",
   "artifact": {
     "filename": "terminal-host.node",
-    "sha256": "16f3ea5e77bb19588e4ad97cd58b048dd6ab8295296eef106ec54ef4a13912b6",
-    "size": 7296664
+    "sha256": "d55bf113092dcb926a6fb10961f30207b3624c3727357de0913a01a40026f594",
+    "size": 7303320
   },
   "entry": {
     "filename": "dist/foundation/resident-tabs/host-entry.js",

package/dist/native/win32-x64/manifest.json

@@ -7,10 +7,10 @@
   "platform": "win32",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-10-28T07:16:45.338Z",
+  "builtAt": "2026-10-29T14:00:59.192Z",
   "artifact": {
     "filename": "process-guardian.node",
-    "sha256": "dd5110a0e331ca09b419147c628d54d8bc6394a142f1a52203923a1bf39827f7",
+    "sha256": "b855e7cd7efb5ff483e24c06247eddcafd3519e8bec4681d959f41dc3b08400e",
     "size": 402432
   },
   "provenance": {

package/dist/native/win32-x64/terminal-host.manifest.json

@@ -9,11 +9,11 @@
   "architecture": "x64",
   "target": "x86_64-pc-windows-msvc",
   "capability": "supported",
-  "builtAt": "2026-10-28T07:18:52.019Z",
+  "builtAt": "2026-10-29T14:04:19.346Z",
   "artifact": {
     "filename": "terminal-host.node",
-    "sha256": "5eebca6c16d6b403275dcaa03579c05df47c218a0c57a6aa2b6e7e1c9763f03f",
-    "size": 6381056
+    "sha256": "f60e7e32812f0288ac7480809e4a023f0dada6d8171d75a169ac653658d48809",
+    "size": 6392832
   },
   "entry": {
     "filename": "dist/foundation/resident-tabs/host-entry.js",

package/dist/ui/components/dialog-panel.d.ts

@@ -1,10 +1,10 @@
+import type { PaneRect } from "./frame.js";
 import { LineInput } from "./line-input.js";
 import { type ShortcutHintEntry } from "./shortcut-hints.js";
 import type { UiTheme } from "./theme.js";
 /**
- * The panel a value with parts is edited in: at the foot of the screen, over the
- * surface it was opened from, ruled off above and below. It shows every part,
- * marks the one in hand, says what that part does, and says how to change it.
+ * Semantic content and overlay composition for Settings configure dialogs. The setting supplies
+ * rows and behavior; this component owns compact geometry, backdrop dimming, and panel placement.
  */
 export interface DialogRow {
     readonly label: string;
@@ -39,14 +39,23 @@ export interface SteppedDialogPanelState {
     readonly index: number;
     readonly hint: readonly ShortcutHintEntry[];
 }
+/** Canonical native-matching background for every owned floating dialog surface. */
+export declare function renderFloatingDialogSurface(text: string, mode: "truecolor" | "256color"): string;
+/** Existing raised-menu background, centralized beside the darker dialog surface. */
+export declare function renderFloatingMenuSurface(text: string, mode: "truecolor" | "256color"): string;
+/** The shared compact width used by Settings configure dialogs and native tab dialogs. */
+export declare function configureDialogWidth(width: number): number;
+/** Rows available to a selector after retaining its title, description, control, and guidance. */
+export declare function configureDialogChoiceCapacity(height: number, hasInput: boolean, descriptionRows?: number): number;
+/** Number of modal rows a plain description occupies at the shared content width. */
+export declare function configureDialogTextRows(text: string, width: number): number;
+/** Dims a completed screen and overlays one full-intensity panel without disturbing ANSI tails. */
+export declare function renderCenteredDialogOverlay(frame: readonly string[], dialogRows: readonly string[], rect: PaneRect, theme: UiTheme): readonly string[];
 /** The column values start at: past the widest label, capped so one long name cannot push them off. */
 export declare function dialogValueColumn(rows: readonly DialogRow[]): number;
-/**
- * The panel's lines. The first line is its rule, so the row at index N is drawn
- * one line below the panel's top.
- */
+/** The semantic rows for one generic configure modal. */
 export declare function renderDialogPanel(state: DialogPanelState, width: number, theme: UiTheme): readonly string[];
-/** Owned stepped-selector composition for structured settings with nested choices. */
+/** Owned stepped-selector content for structured settings with nested choices. */
 export declare function renderSteppedDialogPanel(state: SteppedDialogPanelState, width: number, theme: UiTheme): readonly string[];
 /** The row a pointer report lands on, or null when it is not on one. */
 export declare function dialogRowAt(frame: DialogPanelFrame, row: number, column: number, valueWidth: number): number | null;

package/dist/ui/components/dialog-panel.js

@@ -1,27 +1,74 @@
-import { dialogFrameGeometry, insetDialogContent } from "../../contracts/presentation/index.js";
 import { LineInput, renderInputRow } from "./line-input.js";
 import { renderShortcutHintsWithClose } from "./shortcut-hints.js";
-import { displayWidth, truncateToWidth } from "./text.js";
+import { overlaySpan } from "./spans.js";
+import { displayWidth, padToWidth, truncateToWidth } from "./text.js";
 const LABEL_COLUMN_CAP = 30;
 const STEPPED_LABEL_COLUMN_CAP = 46;
-/** One frame path for every semantic row, regardless of which dialog supplies the content. */
+const CONFIGURE_MODAL_MAX_WIDTH = 60;
+const CONFIGURE_MODAL_PADDING_X = 2;
+const SGR = /\u001b\[[0-9;]*m/gu;
+/** Canonical native-matching background for every owned floating dialog surface. */
+export function renderFloatingDialogSurface(text, mode) {
+    const background = mode === "truecolor" ? "\u001b[48;2;38;38;38m" : "\u001b[48;5;235m";
+    return `${background}${text}\u001b[49m`;
+}
+/** Existing raised-menu background, centralized beside the darker dialog surface. */
+export function renderFloatingMenuSurface(text, mode) {
+    const background = mode === "truecolor" ? "\u001b[48;2;55;55;55m" : "\u001b[48;5;237m";
+    return `${background}${text}\u001b[49m`;
+}
+/** The shared compact width used by Settings configure dialogs and native tab dialogs. */
+export function configureDialogWidth(width) {
+    return Math.min(CONFIGURE_MODAL_MAX_WIDTH, Math.max(0, width));
+}
+/** Rows available to a selector after retaining its title, description, control, and guidance. */
+export function configureDialogChoiceCapacity(height, hasInput, descriptionRows = 1) {
+    const wrappedDescriptionRows = Math.max(1, descriptionRows);
+    return Math.max(1, Math.max(0, height) - (hasInput ? 9 : 7) - (wrappedDescriptionRows - 1));
+}
+/** Number of modal rows a plain description occupies at the shared content width. */
+export function configureDialogTextRows(text, width) {
+    return wrapText(text, Math.max(0, configureDialogWidth(width) - CONFIGURE_MODAL_PADDING_X * 2)).length;
+}
+/** One frame path for every semantic row, regardless of which configure dialog supplies content. */
 function dialogPanelLayout(width, theme) {
-    const geometry = dialogFrameGeometry(width);
+    const frameWidth = Math.max(0, width);
+    const left = Math.min(CONFIGURE_MODAL_PADDING_X, frameWidth);
+    const right = Math.min(CONFIGURE_MODAL_PADDING_X, frameWidth - left);
+    const contentWidth = Math.max(0, frameWidth - left - right);
     return {
-        rule: theme.fg("border", "─".repeat(geometry.frameWidth)),
-        contentWidth: geometry.contentWidth,
-        contentRow: (painted, raw = painted) => insetDialogContent(pad(truncateToWidth(painted, geometry.contentWidth), geometry.contentWidth, raw), geometry),
+        blank: " ".repeat(frameWidth),
+        contentWidth,
+        contentRow: (painted, raw = painted, selected = false) => {
+            const content = pad(truncateToWidth(painted, contentWidth), contentWidth, raw);
+            const rightPadding = " ".repeat(right);
+            return `${" ".repeat(left)}${selected ? theme.highlight(content) : content}${selected ? theme.panel(rightPadding) : rightPadding}`;
+        },
     };
 }
+/** Dims a completed screen and overlays one full-intensity panel without disturbing ANSI tails. */
+export function renderCenteredDialogOverlay(frame, dialogRows, rect, theme) {
+    const width = Math.max(0, rect.width);
+    const height = Math.max(0, rect.height);
+    const panelWidth = configureDialogWidth(width);
+    const visibleDialog = dialogRows.slice(0, height);
+    const top = Math.max(0, Math.floor((height - visibleDialog.length) / 2));
+    const left = Math.max(0, Math.floor((width - panelWidth) / 2));
+    return Array.from({ length: height }, (_, row) => {
+        const backdrop = dimStyledLine(frame[row] ?? "", width);
+        const dialogRow = visibleDialog[row - top];
+        if (dialogRow === undefined || panelWidth === 0)
+            return backdrop;
+        const panel = `\u001b[22;39;49m${theme.panel(padToWidth(dialogRow, panelWidth))}`;
+        return overlaySpan(backdrop, left, left + panelWidth, panel);
+    });
+}
 /** The column values start at: past the widest label, capped so one long name cannot push them off. */
 export function dialogValueColumn(rows) {
     const widest = Math.min(LABEL_COLUMN_CAP, Math.max(0, ...rows.map(row => displayWidth(row.label))));
     return 2 + widest + 2;
 }
-/**
- * The panel's lines. The first line is its rule, so the row at index N is drawn
- * one line below the panel's top.
- */
+/** The semantic rows for one generic configure modal. */
 export function renderDialogPanel(state, width, theme) {
     const labelColumn = Math.min(LABEL_COLUMN_CAP, Math.max(0, ...state.rows.map(row => displayWidth(row.label))));
     const layout = dialogPanelLayout(width, theme);
@@ -33,26 +80,26 @@ export function renderDialogPanel(state, width, theme) {
         const content = selected
             ? `${theme.fg("accent", cursor)}${theme.fg("text", padded)}  ${theme.fg("muted", row.value)}`
             : `${cursor}${padded}  ${theme.fg("muted", row.value)}`;
-        const painted = selected ? theme.highlight(content) : content;
-        return layout.contentRow(painted, raw);
+        return layout.contentRow(content, raw, selected);
     });
     const description = state.rows[state.index]?.description ?? "";
+    const descriptionRows = wrapText(description, layout.contentWidth);
     const hint = typeof state.hint === "string"
         ? theme.fg("dim", state.hint)
         : renderShortcutHintsWithClose(state.hint, theme, layout.contentWidth, 0);
     const plainHint = typeof state.hint === "string" ? state.hint : " ".repeat(displayWidth(hint));
     return [
-        layout.rule,
+        layout.blank,
         layout.contentRow(theme.bold(theme.fg("accent", state.title)), state.title),
-        layout.contentRow(theme.fg("dim", description), description),
-        "",
+        ...descriptionRows.map(line => layout.contentRow(theme.fg("dim", line), line)),
+        layout.blank,
         ...rows,
-        "",
+        layout.blank,
         layout.contentRow(hint, plainHint),
-        layout.rule,
+        layout.blank,
     ];
 }
-/** Owned stepped-selector composition for structured settings with nested choices. */
+/** Owned stepped-selector content for structured settings with nested choices. */
 export function renderSteppedDialogPanel(state, width, theme) {
     const layout = dialogPanelLayout(width, theme);
     const labelColumn = Math.min(STEPPED_LABEL_COLUMN_CAP, Math.max(0, ...state.rows.map(row => displayWidth(`${row.label}${row.labelSuffix ?? ""}`))));
@@ -67,7 +114,7 @@ export function renderSteppedDialogPanel(state, width, theme) {
         const content = selected
             ? `${theme.fg("accent", cursor)}${label}${theme.fg("muted", suffix)}`
             : `${cursor}${label}${theme.fg("muted", suffix)}`;
-        return layout.contentRow(selected ? theme.highlight(content) : content, raw);
+        return layout.contentRow(content, raw, selected);
     });
     const input = state.input === undefined
         ? []
@@ -78,21 +125,22 @@ export function renderSteppedDialogPanel(state, width, theme) {
                 promptRole: "accent",
                 theme,
             }).lines.map(row => layout.contentRow(row)),
-            "",
+            layout.blank,
         ];
+    const descriptionRows = wrapText(state.description, layout.contentWidth);
     const step = `(step ${state.step}/${state.steps})`;
     const title = `${state.title} ${step}`;
     const paintedTitle = `${theme.bold(theme.fg("accent", state.title))} ${theme.fg("dim", step)}`;
     return [
-        layout.rule,
+        layout.blank,
         layout.contentRow(paintedTitle, title),
-        layout.contentRow(theme.fg("dim", state.description), state.description),
-        "",
+        ...descriptionRows.map(line => layout.contentRow(theme.fg("dim", line), line)),
+        layout.blank,
         ...input,
         ...rows,
-        "",
+        layout.blank,
         layout.contentRow(renderShortcutHintsWithClose(state.hint, theme, layout.contentWidth)),
-        layout.rule,
+        layout.blank,
     ];
 }
 /** The row a pointer report lands on, or null when it is not on one. */
@@ -107,3 +155,26 @@ function pad(line, width, raw) {
     const visible = displayWidth(raw);
     return visible >= width ? line : line + " ".repeat(width - visible);
 }
+function dimStyledLine(line, width) {
+    const padded = padToWidth(line, width);
+    return `\u001b[2m${padded.replace(SGR, sequence => `${sequence}\u001b[2m`)}\u001b[22m`;
+}
+function wrapText(text, width) {
+    if (text.length === 0 || width <= 0)
+        return [""];
+    const lines = [];
+    let line = "";
+    for (const word of text.split(/\s+/u)) {
+        const candidate = `${line}${line.length === 0 ? "" : " "}${word}`;
+        if (line.length > 0 && displayWidth(candidate) > width) {
+            lines.push(line);
+            line = word;
+        }
+        else {
+            line = candidate;
+        }
+    }
+    if (line.length > 0)
+        lines.push(truncateToWidth(line, width));
+    return lines.length === 0 ? [""] : lines;
+}

package/dist/ui/components/index.d.ts

@@ -1,4 +1,4 @@
-export { dialogRowAt, dialogValueColumn, renderDialogPanel, renderSteppedDialogPanel } from "./dialog-panel.js";
+export { configureDialogChoiceCapacity, configureDialogTextRows, configureDialogWidth, dialogRowAt, dialogValueColumn, renderCenteredDialogOverlay, renderDialogPanel, renderSteppedDialogPanel, } from "./dialog-panel.js";
 export type { DialogPanelFrame, DialogPanelState, DialogRow, SteppedDialogPanelState } from "./dialog-panel.js";
 export { FrameContractError, assertPaneRect, finalizeFrame, validateFrame } from "./frame.js";
 export type { PaneRect } from "./frame.js";
@@ -19,7 +19,7 @@ export { progressStatusFrame, progressStatusText } from "./progress-status.js";
 export type { ProgressStatusFrameStyles, ProgressStatusMarker } from "./progress-status.js";
 export { FrameCache, RENDER_REVISION_KINDS, RenderRevisionTracker, ZERO_REVISIONS, normalizeRevisions, revisionsEqual } from "./revision.js";
 export type { RenderCacheContract, RenderRevisionKind, RenderRevisions } from "./revision.js";
-export { MAX_COPY_ROWS, MAX_COPY_SOURCE_UNITS, selectionCopyLineContent, selectionCopyRowText } from "./selection-copy.js";
+export { COPY_ACKNOWLEDGEMENT_DURATION_MS, MAX_COPY_ROWS, MAX_COPY_SOURCE_UNITS, copyAcknowledgementText, selectionCopyLineContent, selectionCopyRowText } from "./selection-copy.js";
 export type { SelectionCopyPrompt, SelectionCopyRow, SelectionCopySnapshot } from "./selection-copy.js";
 export { ScrollbarRails, isThumbRow, scrollForThumbRow, scrollForTrackPage, scrollbarGeometry, scrollbarPresentation, scrollbarReservesSpace, scrollbarSelectionRows, scrollbarWheelRows, } from "./scrollbar.js";
 export type { RailPointer, RailPosition, ScrollbarAppearance, ScrollbarGeometry, ScrollbarInput, ScrollbarPresentation, ScrollbarPresentationInput, ScrollbarSpeed, ScrollbarStyle, } from "./scrollbar.js";
@@ -42,7 +42,7 @@ export { RAIL_COLUMNS, renderEmptyState, withScrollbarRail } from "./surface.js"
 export type { RailOptions } from "./surface.js";
 export { displayColumnSlice, displayWidth, displayWordColumnRange, faint, padToWidth, stripAnsi, truncateToWidth } from "./text.js";
 export type { DisplayColumnRange, DisplayColumnSlice } from "./text.js";
-export { TEXT_SELECTION_MULTI_CLICK_MS, extendTextSelection, orderedTextSelection, plainTextBetweenColumns, pressTextSelection, releaseTextSelection, textSelectionLineExtendColumn, textSelectionPointAt, textSelectionText, usefulTextLineContent, } from "./text-selection.js";
+export { TEXT_SELECTION_MULTI_CLICK_MS, extendTextSelection, orderedTextSelection, paintTextSelection, plainTextBetweenColumns, pressTextSelection, releaseTextSelection, textSelectionLineExtendColumn, textSelectionPointAt, textSelectionText, usefulTextLineContent, } from "./text-selection.js";
 export type { OrderedTextSelection, TextSelection, TextSelectionClick, TextSelectionLineContent, TextSelectionPoint, TextSelectionPressInput, } from "./text-selection.js";
 export { PLAIN_THEME } from "./theme.js";
 export type { UiTheme, UiThemeToken } from "./theme.js";

package/dist/ui/components/index.js

@@ -1,4 +1,4 @@
-export { dialogRowAt, dialogValueColumn, renderDialogPanel, renderSteppedDialogPanel } from "./dialog-panel.js";
+export { configureDialogChoiceCapacity, configureDialogTextRows, configureDialogWidth, dialogRowAt, dialogValueColumn, renderCenteredDialogOverlay, renderDialogPanel, renderSteppedDialogPanel, } from "./dialog-panel.js";
 export { FrameContractError, assertPaneRect, finalizeFrame, validateFrame } from "./frame.js";
 export { humanizeLabel, humanizeTitle } from "./label.js";
 export { LineInput, caretCell, handleLineInputKey, renderInputRow, wordLeft, wordRight } from "./line-input.js";
@@ -9,7 +9,7 @@ export { MOUSE_TRACKING_OFF, MOUSE_TRACKING_ON, parseMouseInput, routeMouseInput
 export { isInsidePane, toPaneLocalMouse } from "./pane.js";
 export { progressStatusFrame, progressStatusText } from "./progress-status.js";
 export { FrameCache, RENDER_REVISION_KINDS, RenderRevisionTracker, ZERO_REVISIONS, normalizeRevisions, revisionsEqual } from "./revision.js";
-export { MAX_COPY_ROWS, MAX_COPY_SOURCE_UNITS, selectionCopyLineContent, selectionCopyRowText } from "./selection-copy.js";
+export { COPY_ACKNOWLEDGEMENT_DURATION_MS, MAX_COPY_ROWS, MAX_COPY_SOURCE_UNITS, copyAcknowledgementText, selectionCopyLineContent, selectionCopyRowText } from "./selection-copy.js";
 export { ScrollbarRails, isThumbRow, scrollForThumbRow, scrollForTrackPage, scrollbarGeometry, scrollbarPresentation, scrollbarReservesSpace, scrollbarSelectionRows, scrollbarWheelRows, } from "./scrollbar.js";
 export { assertOwnedShortcutHintConventions, renderShortcutHints, renderShortcutHintsWithClose, shortcutHintsText } from "./shortcut-hints.js";
 export { GLOBAL_SCOPE, ShortcutRegistry, assembleShortcuts, assertNoShortcutConflicts } from "./shortcuts.js";
@@ -21,6 +21,6 @@ export { numericValues, steppedValue, stepperEnds } from "./stepper.js";
 export { TranscriptViewport, assertTranscriptViewportFrameDescriptor } from "./transcript-viewport.js";
 export { RAIL_COLUMNS, renderEmptyState, withScrollbarRail } from "./surface.js";
 export { displayColumnSlice, displayWidth, displayWordColumnRange, faint, padToWidth, stripAnsi, truncateToWidth } from "./text.js";
-export { TEXT_SELECTION_MULTI_CLICK_MS, extendTextSelection, orderedTextSelection, plainTextBetweenColumns, pressTextSelection, releaseTextSelection, textSelectionLineExtendColumn, textSelectionPointAt, textSelectionText, usefulTextLineContent, } from "./text-selection.js";
+export { TEXT_SELECTION_MULTI_CLICK_MS, extendTextSelection, orderedTextSelection, paintTextSelection, plainTextBetweenColumns, pressTextSelection, releaseTextSelection, textSelectionLineExtendColumn, textSelectionPointAt, textSelectionText, usefulTextLineContent, } from "./text-selection.js";
 export { PLAIN_THEME } from "./theme.js";
 export { menuRowAt, renderValueMenu, valueMenuFrame } from "./value-menu.js";

package/dist/ui/components/scrollbar.d.ts

@@ -6,7 +6,7 @@
 export interface ScrollbarGeometry {
     /** Rows in the track. */
     readonly trackHeight: number;
-    /** Thumb height in rows, at least one. */
+    /** Thumb height in rows, at least two when the track permits. */
     readonly thumbHeight: number;
     /** Zero-based row of the thumb's top within the track. */
     readonly thumbTop: number;

package/dist/ui/components/scrollbar.js

@@ -39,7 +39,7 @@ export function scrollbarGeometry(input) {
         return null;
     const maxScroll = contentLength - viewportHeight;
     const scroll = Math.min(Math.max(input.scroll, 0), maxScroll);
-    const thumbHeight = Math.max(1, Math.min(trackHeight, Math.round(trackHeight * viewportHeight / contentLength)));
+    const thumbHeight = Math.min(trackHeight, Math.max(2, Math.round(trackHeight * viewportHeight / contentLength)));
     const travel = trackHeight - thumbHeight;
     const thumbTop = maxScroll === 0 ? 0 : Math.min(travel, Math.round(travel * scroll / maxScroll));
     return { trackHeight, thumbHeight, thumbTop, maxScroll };

package/dist/ui/components/selection-copy.d.ts

@@ -2,25 +2,23 @@ import { type OrderedTextSelection, type TextSelectionLineContent } from "./text
 /** Bound selected-source retention independently of history length and encoded payload size. */
 export declare const MAX_COPY_SOURCE_UNITS: number;
 export declare const MAX_COPY_ROWS = 65536;
+export declare const COPY_ACKNOWLEDGEMENT_DURATION_MS = 1000;
+export declare function copyAcknowledgementText(characters: number): string;
 export type SelectionCopyPrompt = "first" | "continuation" | undefined;
 export interface SelectionCopyRow {
     readonly text: string;
     readonly prompt?: "first" | "continuation";
 }
-/** Immutable selected rows only; safe to transfer to an isolated text preparer. */
 export interface SelectionCopySnapshot {
     readonly selection: OrderedTextSelection;
     readonly revision: number;
-    /** Prompt copy/cut already supplies exact expanded text; do not apply transcript chrome stripping. */
     readonly literal?: boolean;
     readonly rows: readonly SelectionCopyRow[];
     readonly sourceUnits: number;
     readonly captureMs?: number;
     readonly rejected?: "size";
 }
-/** Shares the viewport's semantic chrome exclusions with isolated copy preparation. */
 export declare function selectionCopyLineContent(text: string, prompt: SelectionCopyPrompt): TextSelectionLineContent;
-/** Builds an immutable exact-text snapshot without changing editor-owned selection state. */
 export declare function literalSelectionCopySnapshot(text: string, revision?: number): SelectionCopySnapshot | null;
 /** Extracts one snapshot row with the existing grapheme/newline policy; run expensive rows off-thread. */
 export declare function selectionCopyRowText(snapshot: Pick<SelectionCopySnapshot, "selection" | "literal">, row: SelectionCopyRow, index: number): string;

package/dist/ui/components/selection-copy.js

@@ -3,7 +3,10 @@ import { stripAnsi } from "./text.js";
 /** Bound selected-source retention independently of history length and encoded payload size. */
 export const MAX_COPY_SOURCE_UNITS = 32 * 1024 * 1024;
 export const MAX_COPY_ROWS = 65_536;
-/** Shares the viewport's semantic chrome exclusions with isolated copy preparation. */
+export const COPY_ACKNOWLEDGEMENT_DURATION_MS = 1_000;
+export function copyAcknowledgementText(characters) {
+    return `copied ${characters} chars to clipboard`;
+}
 export function selectionCopyLineContent(text, prompt) {
     const plain = stripAnsi(text);
     if (prompt !== undefined) {
@@ -19,7 +22,6 @@ export function selectionCopyLineContent(text, prompt) {
         return { from, to: from + 1 };
     return usefulTextLineContent(plain, from);
 }
-/** Builds an immutable exact-text snapshot without changing editor-owned selection state. */
 export function literalSelectionCopySnapshot(text, revision = 0) {
     if (text.trim().length === 0)
         return null;

package/dist/ui/components/text-selection.d.ts

@@ -1,4 +1,3 @@
-/** A reported pointer cell plus its grapheme-aligned zero-based boundaries. */
 export interface TextSelectionPoint {
     readonly line: number;
     readonly column: number;
@@ -28,7 +27,6 @@ export interface TextSelectionLineContent {
     readonly to?: number;
     readonly selectable?: boolean;
 }
-/** Ordered zero-based, half-open display-column boundaries. */
 export interface OrderedTextSelection {
     readonly start: TextSelectionPoint;
     readonly end: TextSelectionPoint;
@@ -45,6 +43,7 @@ export interface TextSelectionPressInput {
     readonly now?: number;
 }
 export declare const TEXT_SELECTION_MULTI_CLICK_MS = 500;
+export declare function paintTextSelection(line: string, from: number, to: number, widthOf?: (text: string) => number, clearInverse?: boolean): string;
 export declare function orderedTextSelection(selection: TextSelection | undefined): OrderedTextSelection | undefined;
 export declare function pressTextSelection(input: TextSelectionPressInput): {
     readonly selection?: TextSelection;

package/dist/ui/components/text-selection.js

@@ -1,6 +1,11 @@
+import { backgroundSgrSpan } from "./spans.js";
 import { displayWidth, stripAnsi } from "./text.js";
 const GRAPHEMES = new Intl.Segmenter(undefined, { granularity: "grapheme" });
 export const TEXT_SELECTION_MULTI_CLICK_MS = 500;
+const TEXT_SELECTION_BACKGROUND = "\u001b[48;2;38;79;120m";
+export function paintTextSelection(line, from, to, widthOf = displayWidth, clearInverse = false) {
+    return backgroundSgrSpan(line, from, to, `${clearInverse ? "\u001b[27m" : ""}${TEXT_SELECTION_BACKGROUND}`, "\u001b[49m", widthOf);
+}
 export function orderedTextSelection(selection) {
     if (selection === undefined)
         return undefined;
@@ -17,8 +22,6 @@ export function orderedTextSelection(selection) {
     }
     if (!selection.cell && selection.dragged !== true)
         return undefined;
-    // Invariant: an accepted drag includes both endpoint graphemes, even after returning
-    // to its anchor. Only an unextended point press is empty; paint and copy stay half-open.
     const anchorFirst = comparePoints(anchor, head) <= 0;
     const first = anchorFirst ? anchor : head;
     const last = anchorFirst ? head : anchor;

package/dist/ui/components/transcript-viewport.js

@@ -1,8 +1,8 @@
 import { MAX_COPY_SOURCE_UNITS, selectionCopyLineContent } from "./selection-copy.js";
 import { isThumbRow, scrollbarGeometry, scrollbarPresentation, } from "./scrollbar.js";
-import { backgroundSgrSpan, overlaySpan } from "./spans.js";
+import { overlaySpan } from "./spans.js";
 import { faint, truncateToWidth, displayWidth, stripAnsi } from "./text.js";
-import { extendTextSelection, orderedTextSelection, pressTextSelection, releaseTextSelection, textSelectionLineExtendColumn, textSelectionPointAt, textSelectionText, usefulTextLineContent, } from "./text-selection.js";
+import { extendTextSelection, orderedTextSelection, paintTextSelection, pressTextSelection, releaseTextSelection, textSelectionLineExtendColumn, textSelectionPointAt, textSelectionText, usefulTextLineContent, } from "./text-selection.js";
 const CONTROL_STYLE_RESET = "\u001b]8;;\u001b\\\u001b[0m";
 // Protocol: upstream OSC 133 zones are layout annotations, not fullscreen cursor commands.
 // Styling/padding can move them away from the row prefix Pi strips; 133;A then advances a real
@@ -43,7 +43,7 @@ const PLAIN_THEME = {
     sticky: (text, hovered) => hovered ? `\u001b[7m${text}\u001b[27m` : text,
     quietSticky: faint,
     bottomControl: (text, hovered) => hovered ? `\u001b[7m${text}\u001b[27m` : `\u001b[7m${text}\u001b[27m`,
-    selection: (line, from, to) => backgroundSgrSpan(line, from, to),
+    selection: paintTextSelection,
 };
 /**
  * A1-owned viewport state. It knows only rows and semantic prompt anchors; Pi

package/dist/ui/settings/declarations.d.ts

@@ -30,7 +30,7 @@ export declare const OWNED_SETTING_DECLARATIONS: Readonly<{
             id: "generic";
             title: "Generic";
         }>;
-        description: "Auto installs verified channel updates silently, Notify shows the current update notice, and No leaves updates manual. Checks use the public npm registry; applies on next start.";
+        description: "Auto checks the running channel every 15 minutes while open and installs verified updates silently. Notify checks on startup and shows an update notice; No leaves updates manual. Applies on next start.";
         application: "restart";
         defaultValue: "auto";
         allowedValues: readonly ["auto", "notify", "no"];

package/dist/ui/settings/declarations.js

@@ -24,7 +24,7 @@ export const OWNED_SETTING_DECLARATIONS = Object.freeze({
         id: "updateCheck",
         label: "Update",
         section: GENERIC_SECTION,
-        description: "Auto installs verified channel updates silently, Notify shows the current update notice, and No leaves updates manual. Checks use the public npm registry; applies on next start.",
+        description: "Auto checks the running channel every 15 minutes while open and installs verified updates silently. Notify checks on startup and shows an update notice; No leaves updates manual. Applies on next start.",
         application: "restart",
         defaultValue: "auto",
         allowedValues: Object.freeze(["auto", "notify", "no"]),

package/docs/architecture/resident-tabs.md

@@ -373,12 +373,13 @@ Tab status is an A1-owned state machine fed by `bridge.status`:
   - Rename is inline in the chip: `Enter` commits, `Esc` or a click elsewhere cancels, and `Ctrl+Left` / `Ctrl+Right` move by word. The name is trimmed, must not be empty, is at most 64 characters, and has control characters stripped.
 - **Plus menu.** The A1 setting `tabBarPlusMenu`, shown as `Plus menu` in the `Tab Bar` Settings section, holds the kinds `+` offers, Agent and every utility kind, as comma-joined keys in that order and defaults to `agent`. The `Plus Menu` dialog lists every kind with `●` when enabled and `○` when not under `Choose what the + button in the tab bar can add.`, with `Space` to toggle, Up and Down to move, typing to filter, and `Esc` to close. `+`'s `Configure` opens it in the attach client as a modal over the dimmed active tab or landing, built on the command palette's list and renderer, with a reversed white search caret like owned inputs. The Settings `configure` entry opens the same modal: the Settings child sends a `configure-plus` bridge request as the tab's controlling client, which the server forwards to that client as `plus.configure`; only without a bridge does Settings open its own equivalent dialog. Each toggle is written at once: the attach client takes the `settings.json.lock` directory lock the TypeScript writer takes through `proper-lockfile`, rereads the document, replaces only `a1.tabBarPlusMenu` (removed at the default), and renames a temporary file over it. A refused write restores the stored menu. The attach client reads the setting live, and with no kind enabled the strip hides `+`. Because a modal's overlay saves and restores the cursor while faint is active, the strip starts every frame from reset attributes, so no chip stays faint after a modal closes.
 - **Command palette.** `Alt+/` (`tabs.commands`) opens a centered box over the whole frame in the owned list style: an accent `Commands` title, a `> ` search row, `Agent`, `Settings`, and `Changelog` with their effective shortcuts right-aligned, and a key hint. Typing or pasting filters it, Up and Down move, `Enter` runs the selected entry through its shortcut action, and `Esc` or `Alt+/` closes it; another tab shortcut closes it and runs. While it is open no key, paste, or pointer event reaches the strip or a child, the cursor is hidden, and the composer redraws the strip and body with faint re-asserted after every SGR beneath the bright overlay.
-- **Changelog.** The changelog opens as a singleton `changelog-` utility tab titled `Changelog`, from the palette or the unbound `tabs.changelog` action. The tab registry accepts the `agent`, `settings`, and `changelog` kinds. Like Settings it is never renamed, offers only `Close`, is placed last, does not count as an Agent, and is prewarmed and hidden: the attach client starts it with `tab.prewarm-changelog` once Settings is ready, and again after a Changelog tab closes, so opening it shows the running tab at once. Like a hidden Settings tab, a hidden Changelog never takes the view when the viewed tab closes, so closing the last Agent shows the landing. Its screen is the tab: it shows no `Esc close` hint, and neither `Esc` nor one `Ctrl+C` closes it.
-- **Utility tab rules.** Settings and Changelog are kinds in one table, `UtilityKind` in the attach core and `UTILITY_KINDS` on the server, and every rule follows the kind rather than a per-kind path: a kind's toggle shows a tab already in the strip in its slot, reveals a hidden or absent one through `tab.open-<kind>`, which the server answers by starting it or placing the running one last, and hides the viewed one while its process keeps running; the client prewarms each kind with `tab.prewarm-<kind>` once the kind before it runs; and a hidden one never takes the view when another tab closes. In the child, the route matching a resident tab's id is that tab's pinned screen. Adding a kind is a table entry, its prewarm state, and its route.
+- **Changelog.** The changelog opens as a singleton `changelog-` tab titled `Changelog`, from the palette or the unbound `tabs.changelog` action. The tab registry accepts the `agent`, `settings`, and `changelog` kinds. Its provider registration makes it non-renameable, Close-only, sessionless, prewarmed, and hidden: the attach client starts it with `tab.prewarm-changelog` once Settings is ready, and again after a Changelog tab closes, so opening it shows the running tab at once. Like a hidden Settings tab, a hidden Changelog never takes the view when the viewed tab closes, so closing the last Agent shows the landing. Its screen is the tab: it shows no `Esc close` hint, and neither `Esc` nor one `Ctrl+C` closes it.
+- **Tab-bar provider.** Agent, Settings, and Changelog are registered once in the I/O-free `TabKind` provider shared by the attach client and server. Each registration declares its label, shortcut action, multiplicity, create-or-toggle activation, prewarm policy, renameability, Agent-session ownership, child route, and launcher marker. Shortcuts, the command palette, `+`, popup capabilities, registry validation, session handling, and route delivery consume that provider instead of rebuilding Agent or utility tables. Multi-instance Agent activation creates a tab; singleton-toggle activation creates or reveals its one tab, selects it in place when already shown, and hides it while viewed according to the common toggle rule. Singleton visibility and prewarm state are arrays in provider order, so adding another singleton does not add a concrete view field.
+  - The tab bar also owns one kind-neutral ordering API: every newly created tab and every hidden tab newly joining the strip appends after all live tabs; selecting an already shown tab retains its slot; drag order remains authoritative; and stopped registry records never affect the visible insertion destination. Cold holder creation, standby promotion, and singleton reveal use these same operations, so `Agent`, then `Settings`, then another `Agent` stays in that order.
   - `bin/ui.js` resolves the utility route from the consumed tab id before loading the declared Agent startup graph. A utility id imports the slim composition instead, so no Pi engine host, Agent session, extensions, prompt history, suggestions, or draft recovery are loaded or started; Agent tabs, the standby, `a1 solo`, and `a1 pi` keep the full graph.
   - The slim process still owns one fullscreen `OwnedUiTerminalHost`, the background canvas, theme and accent singletons, Pi keybindings, controller-boundary input, and the tab bridge. A minimal presenter opens only the pinned route. It publishes effective tab shortcuts, requests the attach client's Plus Menu through `configure-plus`, requests tab close when the screen closes, detaches the controlling client on the interrupt exit, and ends on `bridge.stop`.
   - Settings builds its Agent section from Pi's persisted `SettingsManager` after the ordinary project-trust decision, with persist-only bindings because each Agent process owns live effects. Its per-model thinking choices come from an offline `ModelRuntime` over the profile's `auth.json` and `models.json`. Changelog reads the packaged release-note catalog directly and never takes or acknowledges an Agent startup "What's New" claim.
-- **Reveal.** Opening a tab draws it at once: a created Agent and a revealed Settings or Changelog tab both keep the current content, another tab or the landing, until their first drawn frame commits, a retained blank surface included, and a tab that never draws shows after the bounded first-draw wait. Only a resize fades (`roles/reveal.rs`): once the curtain lifts, the whole frame draws faint for one fade interval with no cursor, then at full intensity. A starting chip shows no spinner. One tab opens at a time: new-Agent input while a tab the client asked for is starting or not yet shown starts nothing.
+- **Reveal.** Opening a tab draws it at once: a created Agent and a revealed Settings or Changelog tab both keep the current content, another tab or the landing, until their first nonblank drawn frame commits, a retained blank surface included. Blank child revisions remain parked for any duration rather than exposing an empty body or child cursor; explicit failure and recovery outcomes still replace the startup presentation. Every changed-size resize forwards geometry immediately and repaints the retained strip and child surface directly at the new dimensions; no resize curtain or fade remains. Inactive terminal-tab resizes also repaint without an overlay, and focus return refreshes the complete frame. A starting chip shows no spinner. One tab opens at a time: new-Agent input while a tab the client asked for is starting or not yet shown starts nothing.
 - **Rename selection.** The inline rename draws a selection on the prompt editor's selection background (RGB `38,79,120`, palette `24`) and keeps the chip's text color, restoring the chip's background after it; only the caret is a reversed cell.
 - **Close.** `Alt+W` and the right-click menu close a tab directly, including while it is working. Closing removes the chip without a confirmation, stopping/read-only frame, or close glyph, then gracefully stops the child under the existing bounded termination policy. Its session stays resumable. Closing the last tab leaves `+` and the clock beside the landing.
 - **Landing.** While the attach client has no tab to show, the attach role renders the a1 landing as the frame's body. The launch cwd sits where an Agent tab's footer shows it, flush left on the second-to-last body row with the same `~` formatting and `dim` color, so the folder does not move when a tab opens or closes; `v<version>`, read once from the release root's `package.json`, sits below it and the three-row half-block `a1` wordmark in the profile's accent above it (omitted in Apple Terminal). The accent colors are a native table pinned by `landing_accents.json`, which a TypeScript test checks against `derivePiAccentProjection`. The body is painted with the canvas `backgroundStyle` gives Agent tabs. The landing holds no input: tab shortcuts, the launcher, strip mouse, and double-`Ctrl+C` behave as with tabs, and no cursor shows. A hidden Settings tab is prewarmed and kept running beside the landing, as beside Agents, so Settings opens without a start; it closes when the client detaches, and an attach treats a registry holding only Settings as empty, so it starts and views its first Agent. An Agent record whose child exited and that no holder owns (an update shutdown, a crash, a kill) is treated the same way: `attach.start` drops those stopped records and starts a new Agent under a fresh `tab-` id so it never adopts a stopped tab's directory, draft, or recovery screen, while a profile that never had an Agent keeps `tab-1`; admission never pins a stopped record as the view, and it names the fresh id itself, which `attach.start` reads back from the client session, so the surface subscription admission takes and the tab it starts agree. On the client, a first registry list with nothing to show counts as the strip shown empty, so the landing with `+` and the clock paints at once instead of an empty screen, while a listed starting tab keeps its first-draw gate. Adding a tab from the landing keeps it until the tab's first drawn frame replaces it at once; the landing has no animation of its own.
@@ -617,7 +618,7 @@ On 2026-10-24 the user refined the tab bar:
 - `+` adds an Agent by default; what it offers, Agent, Settings, and Changelog, is configurable from a right-click `Configure` modal over the active tab and from `Tab Bar` › `Plus menu` in Settings, where the `Tabs` section is renamed `Tab Bar`. With nothing enabled, `+` is hidden.
 - `Alt+/` opens a keyboard-only command palette over a dimmed frame: `Agent`, `Settings`, and `Changelog`.
 - The changelog opens at once as its own prewarmed singleton tab that `Esc` does not close, and leaves resident Agents' commands.
-- Opening a tab, a new Agent or a revealed Settings or Changelog tab, draws it at once when its first frame is drawn, with no fade and no starting spinner; the current content, landing included, stays until then. Only a resize fades. The landing's wipe animation is removed.
+- Opening a tab, a new Agent or a revealed Settings or Changelog tab, draws it at once when its first nonblank frame is drawn, with no fade and no starting spinner; the current content, landing included, stays across blank revisions until then, while explicit failure and recovery remain visible. Quick snaps, prolonged drags, and inactive terminal-tab resizes all repaint directly without a curtain or fade. The landing's wipe animation is removed.
 - The tab rename selection matches the editor's selection style, and a tab's name and its session's name stay in sync.
 
 On 2026-10-16 the `ci-critical-path` change replaced the Intel runner for the release builds:

package/docs/features/launch-profiles.md

@@ -6,10 +6,11 @@
 |---|---|---|
 | `a1` | A1 | `~/.a1/agent` |
 | `a1 --session <path\|id>` | Resume a persisted A1 session | `~/.a1/agent` (or explicitly selected storage) |
-| `a1 solo` | A1 direct single-agent mode | `~/.a1/agent` |
+| `a1 solo` | Fresh A1 direct single-agent mode | `~/.a1/agent` |
+| `a1 solo --session <path\|id>` | Resume a persisted A1 session in direct single-agent mode | `~/.a1/agent` (or explicitly selected storage) |
 | `a1 pi` | Pi-compatible direct comparison surface using the ordinary Pi profile | ordinary `~/.pi/agent` |
 
-`a1 solo` is available in release and prerelease builds. It starts A1 in single agent mode, is argument-free, and omits both the tab strip and the Tabs settings section.
+`a1 solo` is available in release and prerelease builds. Without arguments it starts a fresh single-agent session; with `--session` and optional `--session-dir` it resumes a saved session. Both forms omit the tab strip and the Tabs settings section.
 
 `a1 pi` is a development instrument for comparing A1 against pinned Pi. Prerelease builds — what `a1 update --develop` or `a1 update --develop <number>` installs — expose it. A release build does not recognize the launch form. Repository development can run the comparison directly with `npm start:pi`.
 
@@ -36,16 +37,18 @@ Run Pi’s normal `/login` independently in each profile that needs stored authe
 
 ## Resume a session
 
-After a conversation has been persisted, exit A1 and run the command it prints from the original project directory:
+After a conversation has been persisted, exit A1 and run the command it prints from the original project directory. Exited solo sessions print the solo form; tabbed A1 sessions keep the tabbed form:
 
 ```sh
 a1 --session <id>
 a1 --session-dir '/path/to/session store' --session <id>
+a1 solo --session <id>
+a1 solo --session-dir '/path/to/session store' --session <id>
 ```
 
 `--session` also accepts a `.jsonl` file path; `--session-dir` may come before or after it. Explicit storage overrides `PI_CODING_AGENT_SESSION_DIR`, which overrides default storage. IDs are searched in the current project before other projects within the A1 store. A cross-project ID match asks before creating a fork with a new identity; an explicit file resumes directly using its stored working directory. Missing or invalid targets fail rather than create an empty replacement.
 
-Resume uses the shipped Pi's public restoration behavior, including the compaction format it writes. It sends no model prompt by itself and does not recover, convert, or modify an unrelated conversation. The selected session opens in a new A1 tab or focuses the tab already holding it. Pi picker/continue CLI aliases, `a1 solo --session`, and `a1 pi --session` are not supported; in-UI `/resume` is unchanged.
+Resume uses the shipped Pi's public restoration behavior, including the compaction format it writes. It sends no model prompt by itself and does not recover, convert, or modify an unrelated conversation. A tabbed selection opens in a new A1 tab or focuses the tab already holding it; a solo selection opens in the direct strip-free UI without starting the resident host. A live session remains protected by its single-writer lease. Pi picker/continue CLI aliases and `a1 pi --session` are not supported; in-UI `/resume` is unchanged.
 
 Regression evidence creates disposable sessions through Pi 0.84.2, then executes the emitted command through the packed public entry, bootstrap, guardian, and owned UI. Default/custom storage, Windows Git Bash quoting, supervisor restart, failure cleanup, and simultaneous distinct selections are covered in `test/foundation/release/session-resume.integration.test.ts`. CI runs it in the resource-sensitive `package-smoke` scope, not the fast remainder. Unsupported synthetic retained-tail certification is separate deferred work.