@timurproko/a1 0.2.6-dev.717 → 0.2.6-dev.734

package/dist/ui/components/prompt-input.d.ts

@@ -10,6 +10,8 @@ export interface PromptInputBody {
     readonly topRule?: string | undefined;
     readonly bottomRule?: string | undefined;
     readonly after?: readonly string[];
+    /** Outer indentation for after-body rows; defaults to the prompt prefix width. */
+    readonly afterIndent?: number;
 }
 export interface PromptInputMetrics {
     readonly measure: (text: string) => number;

package/dist/ui/components/prompt-input.js

@@ -31,6 +31,10 @@ export class PromptInput {
             return [];
         const { prefixWidth, innerWidth } = this.geometry(width, padding, promptGlyph);
         const body = renderBody(innerWidth);
+        const requestedAfterIndent = body.afterIndent ?? prefixWidth;
+        const afterIndent = Number.isFinite(requestedAfterIndent)
+            ? Math.min(width, Math.max(0, Math.floor(requestedAfterIndent)))
+            : prefixWidth;
         const fit = (row) => {
             const clipped = this.metrics.truncate(row, width);
             return clipped + " ".repeat(Math.max(0, width - this.metrics.measure(clipped)));
@@ -45,7 +49,7 @@ export class PromptInput {
             ...(ruled ? [rule(body.topRule)] : []),
             ...rows,
             ...(ruled ? [rule(body.bottomRule)] : []),
-            ...(body.after ?? []).map(row => fit(`${" ".repeat(prefixWidth)}${row}`)),
+            ...(body.after ?? []).map(row => fit(`${" ".repeat(afterIndent)}${row}`)),
         ];
     }
 }

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

@@ -56,7 +56,7 @@ export declare function releaseTextSelection(selection: TextSelection | undefine
 export declare function textSelectionLineExtendColumn(selection: TextSelection, line: number, contentWidth: number): number;
 /** Resolves a reported one-based pointer cell to the complete grapheme it intersects. */
 export declare function textSelectionPointAt(line: number, column: number, lineText: string): TextSelectionPoint;
-export declare function textSelectionText(selection: OrderedTextSelection, rows: readonly string[], lineContent?: (line: number) => TextSelectionLineContent | undefined): string;
+export declare function textSelectionText(selection: OrderedTextSelection, rows: readonly string[], lineContent?: (line: number) => TextSelectionLineContent | undefined, includeLine?: (line: number) => boolean): string;
 /** Returns the plain cells covered by [from,to), expanding at grapheme edges. */
 export declare function plainTextBetweenColumns(line: string, from: number, to: number): string;
 export declare function usefulTextLineContent(line: string, from?: number): TextSelectionLineContent;

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

@@ -111,9 +111,11 @@ export function textSelectionPointAt(line, column, lineText) {
     }
     return { line, column, from: target, to: target + 1 };
 }
-export function textSelectionText(selection, rows, lineContent) {
+export function textSelectionText(selection, rows, lineContent, includeLine = () => true) {
     const parts = [];
     for (let line = selection.start.line; line <= selection.end.line && line < rows.length; line += 1) {
+        if (!includeLine(line))
+            continue;
         const plain = stripAnsi(rows[line] ?? "");
         const content = lineContent?.(line);
         if (content?.selectable === false) {

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

@@ -8,6 +8,8 @@ export interface UiTheme {
      * into a dark terminal, which is how the engine leaves its lists too.
      */
     plain(text: string): string;
+    /** Optional palette preview used by controls that choose the active accent. */
+    accentPreview?(color: string, text: string): string | null;
     /** Selection background for an active list item or floating-surface row. */
     highlight(text: string): string;
     /** A control that is present but cannot act: quieter than quiet text. */

package/dist/ui/components/transcript-viewport.d.ts

@@ -25,7 +25,7 @@ export interface TranscriptViewportFrameInput {
     readonly documentRows: readonly string[];
     /** Optional paint-only transform; semantic selection and copying keep documentRows exact. */
     readonly paintDocumentRow?: (row: string) => string;
-    /** Leading document rows that participate in pointer selection and copying. */
+    /** Leading persistent document rows; later transient rows remain selectable visible-frame content. */
     readonly selectableDocumentRowCount?: number;
     /**
      * First document row owned by the block that is currently streaming, if any. Rows from
@@ -84,7 +84,7 @@ export interface TranscriptViewportHitRegions {
         readonly columnStart: number;
         readonly columnEnd: number;
     } | null;
-    /** Transient non-selectable document-tail rows currently visible in the viewport. */
+    /** Transient non-persistent document-tail rows currently visible in the viewport. */
     readonly transientTail: readonly number[];
 }
 export interface TranscriptViewportFrameDescriptor {
@@ -109,7 +109,7 @@ export interface TranscriptViewportFrameDescriptor {
     };
     readonly previousFollowingEnd: boolean | null;
     readonly followingEnd: boolean;
-    /** Complete non-selectable suffix, including pending steering, alignment, and status rows. */
+    /** Complete non-persistent suffix, including pending steering, alignment, and status rows. */
     readonly transientRowCount: number;
     /** Flexible rows inserted before the bottom-aligned live status while content fits. */
     readonly transientAlignmentGapRows: number;
@@ -164,7 +164,9 @@ export declare class TranscriptViewport {
     get hasSelection(): boolean;
     /** True when the active gesture began on transcript rows rather than the dock. */
     get selectionFromContent(): boolean;
-    pressSelection(column: number, frameRow: number, now?: number): boolean;
+    pressSelection(column: number, frameRow: number, now?: number, options?: {
+        readonly continueMultiClick?: boolean;
+    }): boolean;
     extendSelection(column: number, frameRow: number, now?: number, autoScroll?: boolean): boolean;
     releaseSelection(): boolean;
     clearSelection(): boolean;

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

@@ -1,4 +1,4 @@
-import { MAX_COPY_SOURCE_UNITS } from "./selection-copy.js";
+import { MAX_COPY_SOURCE_UNITS, selectionCopyLineContent } from "./selection-copy.js";
 import { isThumbRow, scrollbarGeometry, scrollbarPresentation, } from "./scrollbar.js";
 import { backgroundSgrSpan, overlaySpan } from "./spans.js";
 import { faint, truncateToWidth, displayWidth, stripAnsi } from "./text.js";
@@ -8,8 +8,13 @@ const CONTROL_STYLE_RESET = "\u001b]8;;\u001b\\\u001b[0m";
 // the row surface painted beneath its dedicated, non-semantic gutter.
 const GUTTER_DECORATION_RESET = "\u001b]8;;\u001b\\\u001b[22;23;24;25;27;28;29;39;54;55m";
 const IDENTITY_ROW = (row) => row;
-function documentSelectionAnchor(row, source) {
-    return { kind: "document", row, source, identity: stripAnsi(source).trimEnd() };
+function documentSelectionAnchor(row, source, liveFromBottom) {
+    return { kind: "document", row, source, identity: stripAnsi(source).trimEnd(), liveFromBottom };
+}
+function viewportSelectionAnchor(row, source, selectableDocumentRowCount, documentRowCount) {
+    return row < selectableDocumentRowCount
+        ? documentSelectionAnchor(row, source)
+        : { kind: "transient", fromBottom: documentRowCount - row - 1 };
 }
 const DEFAULT_CONFIG = {
     scrollbarAppearance: "auto",
@@ -53,6 +58,7 @@ export class TranscriptViewport {
     #previousVisibleStates = [];
     #documentRows = [];
     #selectableDocumentRowCount = 0;
+    #liveTailStartRow;
     #promptAnchors = [];
     #contentWidth = 0;
     #selectionWidth = 0;
@@ -91,7 +97,7 @@ export class TranscriptViewport {
     get hasSelection() { return orderedTextSelection(this.#selection) !== undefined; }
     /** True when the active gesture began on transcript rows rather than the dock. */
     get selectionFromContent() { return this.#selectionAnchors !== undefined && this.#selectionAnchors.anchor.kind !== "dock"; }
-    pressSelection(column, frameRow, now = Date.now()) {
+    pressSelection(column, frameRow, now = Date.now(), options = {}) {
         const frameHeight = this.#frame?.rows.length ?? 0;
         const selectionWidth = frameRow <= (this.#frame?.hits.viewportHeight ?? 0)
             ? this.#contentWidth
@@ -105,7 +111,7 @@ export class TranscriptViewport {
             contentWidth: selectionWidth,
             lineText: this.#selectionRows[line] ?? "",
             lineContent: usefulTextLineContent(this.#selectionRows[line] ?? ""),
-            ...(this.#selectionClick === undefined ? {} : { previousClick: this.#selectionClick }),
+            ...(options.continueMultiClick !== false && this.#selectionClick !== undefined ? { previousClick: this.#selectionClick } : {}),
             now,
         });
         this.#selection = pressed.selection;
@@ -176,7 +182,29 @@ export class TranscriptViewport {
         const selection = this.#visibleSelection();
         if (selection === undefined)
             return null;
-        const text = textSelectionText(selection, this.#selectionRows, line => usefulTextLineContent(this.#selectionRows[line] ?? ""));
+        // Invariant: the blue range spans the complete frame, but automatic and Ctrl+C frame copy
+        // admit only persistent transcript rows. Transient status, suggestions, input, and footer
+        // chrome remain visually selectable without becoming clipboard payload.
+        const copiedLines = Array.from({ length: Math.max(0, selection.end.line - selection.start.line + 1) }, (_value, index) => selection.start.line + index).filter(line => {
+            const anchor = this.#selectionRowAnchors[line];
+            return anchor?.kind === "document" && anchor.row < this.#selectableDocumentRowCount;
+        });
+        if (copiedLines.length === 0)
+            return null;
+        // Rationale: a prompt selected by itself uses semantic prompt text. Once surrounding transcript text
+        // participates, preserve the prompt's visible prefix, alignment, and timestamp in the bulk range.
+        const prompt = this.#promptAnchors.find(candidate => copiedLines.every(line => {
+            const anchor = this.#selectionRowAnchors[line];
+            return anchor?.kind === "document" && anchor.row >= candidate.firstRow && anchor.row <= candidate.lastRow;
+        }));
+        const included = new Set(copiedLines);
+        const text = textSelectionText(selection, this.#selectionRows, line => {
+            const row = this.#selectionRows[line] ?? "";
+            const anchor = this.#selectionRowAnchors[line];
+            return prompt !== undefined && anchor?.kind === "document"
+                ? selectionCopyLineContent(row, anchor.row === prompt.firstRow ? "first" : "continuation")
+                : usefulTextLineContent(row);
+        }, line => included.has(line));
         return text.length === 0 ? null : text;
     }
     /** Captures visible selected text, not off-screen history. */
@@ -188,6 +216,8 @@ export class TranscriptViewport {
         if (text === null)
             return null;
         text = text.trim();
+        if (text.length === 0)
+            return null;
         const normalized = {
             start: { line: 0, column: 0 },
             end: { line: 0, column: Number.MAX_SAFE_INTEGER },
@@ -280,6 +310,7 @@ export class TranscriptViewport {
         this.#previousVisibleStates = [];
         this.#documentRows = [];
         this.#selectableDocumentRowCount = 0;
+        this.#liveTailStartRow = undefined;
         this.#promptAnchors = [];
         this.#contentWidth = 0;
         this.#selectionWidth = 0;
@@ -340,6 +371,9 @@ export class TranscriptViewport {
         const contentWidth = presentation.reservesSpace ? Math.max(1, width - 1) : width;
         this.#documentRows = documentRows;
         this.#selectableDocumentRowCount = clamp(input.selectableDocumentRowCount ?? input.documentRows.length, 0, input.documentRows.length);
+        this.#liveTailStartRow = input.liveTailStartRow === undefined || !Number.isSafeInteger(input.liveTailStartRow)
+            ? undefined
+            : clamp(input.liveTailStartRow, 0, this.#selectableDocumentRowCount);
         this.#promptAnchors = input.promptAnchors;
         this.#contentWidth = contentWidth;
         // Invariant: dock rows remain selectable at full width; scrollable source rows
@@ -389,7 +423,7 @@ export class TranscriptViewport {
         const visibleAnchors = Array.from({ length: viewportHeight }, (_value, row) => {
             const documentRow = this.#scrollTop + row;
             return documentRow < documentRows.length
-                ? documentSelectionAnchor(documentRow, documentRows[documentRow] ?? "")
+                ? viewportSelectionAnchor(documentRow, documentRows[documentRow] ?? "", this.#selectableDocumentRowCount, documentRows.length)
                 : { kind: "screen", row, source: this.#selectionRows[row] ?? "" };
         });
         // Invariant: a pinned prompt is chrome over its hidden source row, which clips like off-screen rows.
@@ -486,7 +520,7 @@ export class TranscriptViewport {
                 // Invariant: floating control styling is applied only after the row and
                 // gutter surfaces are resolved, so its inline background cannot leak.
                 const withControl = rowControl === null ? withRail : overlaySpan(withRail, rowControl.left, rowControl.right, rowControl.text);
-                return overlayWidth === 0 ? withControl : overlaySpan(padRowPreservingBackground(withControl, width), overlayLimit - overlayWidth, overlayLimit, `${CONTROL_STYLE_RESET}${overlayText}`);
+                return overlayWidth === 0 ? withControl : overlaySpan(padRowPreservingBackground(withControl, width), overlayLimit - overlayWidth, overlayLimit, `${GUTTER_DECORATION_RESET}${overlayText}`, { inheritStartStyle: true });
             });
             rowRecomputed ||= !final.reused;
             frameRows[row] = final.value;
@@ -643,17 +677,30 @@ export class TranscriptViewport {
             return undefined;
         if (line < this.#viewportHeight) {
             const existing = this.#selectionRowAnchors[line];
-            if (this.#frame?.scrollTop === this.#scrollTop)
-                return existing;
+            if (this.#frame?.scrollTop === this.#scrollTop) {
+                return existing?.kind === "document"
+                    ? this.#interactionDocumentAnchor(existing.row, existing.source)
+                    : existing;
+            }
             // Concurrency: selection edge auto-scroll updates scrollTop before the next frame is
             // composed. Resolve ordinary viewport rows from that latest position instead of stale paint.
             const documentRow = this.#scrollTop + line;
             if (documentRow >= 0 && documentRow < this.#documentRows.length) {
-                return documentSelectionAnchor(documentRow, this.#documentRows[documentRow] ?? "");
+                return documentRow < this.#selectableDocumentRowCount
+                    ? this.#interactionDocumentAnchor(documentRow, this.#documentRows[documentRow] ?? "")
+                    : viewportSelectionAnchor(documentRow, this.#documentRows[documentRow] ?? "", this.#selectableDocumentRowCount, this.#documentRows.length);
             }
         }
         return this.#selectionRowAnchors[line];
     }
+    #interactionDocumentAnchor(row, source) {
+        const liveFromBottom = this.#liveTailStartRow !== undefined
+            && row >= this.#liveTailStartRow
+            && row < this.#selectableDocumentRowCount
+            ? this.#selectableDocumentRowCount - row - 1
+            : undefined;
+        return documentSelectionAnchor(row, source, liveFromBottom);
+    }
     #projectSelection(documentRows, dockRows, height) {
         const selection = this.#selection;
         const anchors = this.#selectionAnchors;
@@ -672,9 +719,16 @@ export class TranscriptViewport {
                     ? undefined
                     : { line: anchor.row, anchor };
             }
+            if (anchor.kind === "transient") {
+                const documentRow = documentRows.length - anchor.fromBottom - 1;
+                if (documentRow < this.#selectableDocumentRowCount || documentRow >= documentRows.length)
+                    return undefined;
+                const visible = this.#selectionRowAnchors.findIndex(candidate => candidate?.kind === "transient" && candidate.fromBottom === anchor.fromBottom);
+                return visible < 0 ? undefined : { line: visible, anchor };
+            }
             if (anchor.row >= 0 && anchor.row < documentRows.length
                 && stripAnsi(documentRows[anchor.row] ?? "").trimEnd() === anchor.identity) {
-                const current = documentSelectionAnchor(anchor.row, documentRows[anchor.row] ?? "");
+                const current = documentSelectionAnchor(anchor.row, documentRows[anchor.row] ?? "", anchor.liveFromBottom);
                 const visible = this.#selectionRowAnchors.findIndex(candidate => candidate?.kind === "document"
                     && candidate.row === current.row && candidate.identity === current.identity);
                 return { line: visible >= 0 ? visible : current.row - this.#scrollTop, anchor: current };
@@ -684,9 +738,29 @@ export class TranscriptViewport {
             const visibleMatches = this.#selectionRowAnchors
                 .map((candidate, line) => ({ candidate, line }))
                 .filter((entry) => entry.candidate?.kind === "document" && entry.candidate.identity === anchor.identity);
-            return visibleMatches.length === 1
-                ? { line: visibleMatches[0].line, anchor: visibleMatches[0].candidate }
-                : undefined;
+            if (visibleMatches.length === 1) {
+                const match = visibleMatches[0];
+                return {
+                    line: match.line,
+                    anchor: documentSelectionAnchor(match.candidate.row, match.candidate.source, anchor.liveFromBottom),
+                };
+            }
+            // Concurrency: a streaming chunk may replace or reflow the pointer's current live-tail
+            // row before the next motion report. During the held gesture only, retain its distance
+            // from the persistent tail; release restores identity-only projection.
+            if (selection.selecting && anchor.liveFromBottom !== undefined && this.#liveTailStartRow !== undefined) {
+                const documentRow = this.#selectableDocumentRowCount - anchor.liveFromBottom - 1;
+                if (documentRow >= this.#liveTailStartRow && documentRow < this.#selectableDocumentRowCount) {
+                    const visible = this.#selectionRowAnchors.findIndex(candidate => candidate?.kind === "document" && candidate.row === documentRow);
+                    if (visible >= 0) {
+                        return {
+                            line: visible,
+                            anchor: documentSelectionAnchor(documentRow, documentRows[documentRow] ?? "", anchor.liveFromBottom),
+                        };
+                    }
+                }
+            }
+            return undefined;
         };
         const projectedAnchor = project(anchors.anchor);
         const projectedHead = project(anchors.head);
@@ -704,7 +778,11 @@ export class TranscriptViewport {
         };
     }
     #visibleSelection() {
-        const rows = this.#selectionAnchors?.anchor.kind === "document" ? this.#viewportHeight : this.#selectionRows.length;
+        const anchors = this.#selectionAnchors;
+        const crossesDock = anchors?.anchor.kind === "dock" || anchors?.head.kind === "dock";
+        // Invariant: mixed viewport/dock ranges project across the same complete frame regardless
+        // of origin. Document-only ranges remain clipped to the scrollable viewport when off-screen.
+        const rows = crossesDock ? this.#selectionRows.length : this.#viewportHeight;
         return visibleTextSelection(orderedTextSelection(this.#selection), rows, this.#firstSelectableRow);
     }
     #updateCopyableSelection() {

package/dist/ui/components/value-menu.d.ts

@@ -7,6 +7,8 @@ import type { UiTheme } from "./theme.js";
 export interface ValueMenuState {
     /** Values offered, as they should read. */
     readonly choices: readonly string[];
+    /** Optional already-painted square previews, aligned before each choice label. */
+    readonly previews?: readonly string[];
     /** The value in effect, marked rather than highlighted. */
     readonly current: string | null;
     /** The entry picked by a key or the pointer, or -1 while none is. */

package/dist/ui/components/value-menu.js

@@ -8,10 +8,12 @@ export function valueMenuFrame(state, anchor, layout) {
     const top = below + state.choices.length <= bodyBottom
         ? below
         : Math.max(bodyTop, anchor.screenRow - state.choices.length);
-    const width = Math.max(...state.choices.map(choice => displayWidth(choice) + 4), 6);
-    // Invariant: each row reserves two cells for its effective-value mark. Place those
-    // cells before the anchor so visible choice text starts in the source value column.
-    const column = Math.min(Math.max(0, anchor.valueColumn - 2), Math.max(0, layout.surfaceWidth - width - layout.reservedRight));
+    const previewWidth = Math.max(0, ...(state.previews ?? []).map(displayWidth));
+    const previewColumns = previewWidth === 0 ? 0 : previewWidth + 1;
+    const width = Math.max(...state.choices.map(choice => displayWidth(choice) + previewColumns + 4), 6);
+    // Invariant: rows reserve two cells for the effective-value mark and, when present,
+    // a preview plus one gap. Choice text remains aligned with the source value column.
+    const column = Math.min(Math.max(0, anchor.valueColumn - 2 - previewColumns), Math.max(0, layout.surfaceWidth - width - layout.reservedRight));
     return { top, column, width, rows: state.choices.length };
 }
 /** Draws the menu over the rows behind it, leaving them otherwise untouched. */
@@ -24,11 +26,14 @@ export function renderValueMenu(lines, state, frame, theme) {
         const active = index === state.index;
         const paint = active ? theme.highlight : theme.panel;
         const current = choice === state.current;
-        const tail = padToWidth(`${current ? " " : "  "}${choice} `, frame.width - (current ? 1 : 0));
-        // Invariant: the effective-value check uses the same accent as modal marks, while
-        // the rest of an active row keeps its highlighted foreground and background.
+        const previews = state.previews ?? [];
+        const previewWidth = Math.max(0, ...previews.map(displayWidth));
+        const preview = previewWidth === 0 ? "" : `${padToWidth(previews[index] ?? "", previewWidth)} `;
+        // Invariant: the current-value check stays on ordinary text while the optional
+        // square carries the palette color; the row treatment supplies only its surface.
+        const tail = padToWidth(`${current ? " " : "  "}${preview}${choice} `, frame.width - (current ? 1 : 0));
         const painted = current
-            ? `${paint(theme.fg("accent", "✓"))}${paint(tail)}`
+            ? `${paint(theme.fg("text", "✓"))}${paint(tail)}`
             : paint(tail);
         output[target] = overlaySpan(output[target] ?? "", frame.column, frame.column + frame.width, painted);
     });

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

@@ -1,4 +1,4 @@
-export declare const OWNED_UI_SETTINGS_VERSION = 10;
+export declare const OWNED_UI_SETTINGS_VERSION = 13;
 export type OwnedUiSettingValue = string | number | boolean;
 export type OwnedUiSettingApplication = "live" | "restart";
 export interface OwnedUiSettingDeclaration {
@@ -20,18 +20,6 @@ export interface OwnedUiSettingDeclaration {
  * values are read from it, and `OwnedSettingValueOf` derives each getter's type from it.
  */
 export declare const OWNED_SETTING_DECLARATIONS: Readonly<{
-    readonly quitAnimation: Readonly<{
-        id: "quitAnimation";
-        label: "Quit animation";
-        section: Readonly<{
-            id: "generic";
-            title: "Generic";
-        }>;
-        description: "Play the fall effect over the last screen when the session quits. Off returns to the terminal immediately.";
-        application: "live";
-        defaultValue: true;
-        allowedValues: readonly [true, false];
-    }>;
     readonly updateCheck: Readonly<{
         id: "updateCheck";
         label: "Update check";
@@ -44,6 +32,42 @@ export declare const OWNED_SETTING_DECLARATIONS: Readonly<{
         defaultValue: true;
         allowedValues: readonly [true, false];
     }>;
+    readonly accentColor: Readonly<{
+        id: "accentColor";
+        label: "Accent color";
+        section: Readonly<{
+            id: "appearance";
+            title: "Appearance";
+        }>;
+        description: "Color used by highlighted interface controls, list markers, and tonal interface surfaces.";
+        application: "live";
+        defaultValue: "purple";
+        allowedValues: readonly ["purple", "blue", "cyan", "green", "orange", "pink"];
+    }>;
+    readonly backgroundStyle: Readonly<{
+        id: "backgroundStyle";
+        label: "Background";
+        section: Readonly<{
+            id: "appearance";
+            title: "Appearance";
+        }>;
+        description: "Fullscreen canvas background: terminal transparency, a dark accent tint, or fixed neutral dark.";
+        application: "live";
+        defaultValue: "transparent";
+        allowedValues: readonly ["transparent", "accent", "dark"];
+    }>;
+    readonly quitAnimation: Readonly<{
+        id: "quitAnimation";
+        label: "Quit animation";
+        section: Readonly<{
+            id: "appearance";
+            title: "Appearance";
+        }>;
+        description: "Play the fall effect over the last screen when the session quits. Off returns to the terminal immediately.";
+        application: "live";
+        defaultValue: true;
+        allowedValues: readonly [true, false];
+    }>;
     readonly scrollbarAppearance: Readonly<{
         id: "scrollbarAppearance";
         label: "Scrollbar mode";
@@ -111,7 +135,7 @@ export declare const OWNED_SETTING_DECLARATIONS: Readonly<{
             id: "agent";
             title: "Agent";
         }>;
-        description: "Predict likely next prompts with one additional background request using the selected model.";
+        description: "Predict likely next prompts with one background request, plus one bounded recovery request when needed, using the selected model.";
         application: "live";
         defaultValue: true;
         allowedValues: readonly [true, false];

package/dist/ui/settings/declarations.js

@@ -1,8 +1,12 @@
-export const OWNED_UI_SETTINGS_VERSION = 10;
+export const OWNED_UI_SETTINGS_VERSION = 13;
+const UI_ACCENT_COLOR_CHOICES = Object.freeze([
+    "purple", "blue", "cyan", "green", "orange", "pink",
+]);
 const MAX_ID_LENGTH = 64;
 const ID_PATTERN = /^[a-z][a-z0-9]*(?:[A-Z][a-z0-9]*)*$/;
 /** Declared first so the settings screen opens on it; sections follow first-declaration order. */
 const GENERIC_SECTION = Object.freeze({ id: "generic", title: "Generic" });
+const APPEARANCE_SECTION = Object.freeze({ id: "appearance", title: "Appearance" });
 const SCROLL_SECTION = Object.freeze({ id: "scroll", title: "Scroll" });
 const AGENT_SECTION = Object.freeze({ id: "agent", title: "Agent" });
 /**
@@ -10,15 +14,6 @@ const AGENT_SECTION = Object.freeze({ id: "agent", title: "Agent" });
  * values are read from it, and `OwnedSettingValueOf` derives each getter's type from it.
  */
 export const OWNED_SETTING_DECLARATIONS = Object.freeze({
-    quitAnimation: Object.freeze({
-        id: "quitAnimation",
-        label: "Quit animation",
-        section: GENERIC_SECTION,
-        description: "Play the fall effect over the last screen when the session quits. Off returns to the terminal immediately.",
-        application: "live",
-        defaultValue: true,
-        allowedValues: Object.freeze([true, false]),
-    }),
     updateCheck: Object.freeze({
         id: "updateCheck",
         label: "Update check",
@@ -28,6 +23,35 @@ export const OWNED_SETTING_DECLARATIONS = Object.freeze({
         defaultValue: true,
         allowedValues: Object.freeze([true, false]),
     }),
+    accentColor: Object.freeze({
+        id: "accentColor",
+        label: "Accent color",
+        section: APPEARANCE_SECTION,
+        description: "Color used by highlighted interface controls, list markers, and tonal interface surfaces.",
+        application: "live",
+        defaultValue: "purple",
+        allowedValues: UI_ACCENT_COLOR_CHOICES,
+    }),
+    backgroundStyle: Object.freeze({
+        id: "backgroundStyle",
+        label: "Background",
+        section: APPEARANCE_SECTION,
+        description: "Fullscreen canvas background: terminal transparency, a dark accent tint, or fixed neutral dark.",
+        application: "live",
+        defaultValue: "transparent",
+        allowedValues: Object.freeze([
+            "transparent", "accent", "dark",
+        ]),
+    }),
+    quitAnimation: Object.freeze({
+        id: "quitAnimation",
+        label: "Quit animation",
+        section: APPEARANCE_SECTION,
+        description: "Play the fall effect over the last screen when the session quits. Off returns to the terminal immediately.",
+        application: "live",
+        defaultValue: true,
+        allowedValues: Object.freeze([true, false]),
+    }),
     scrollbarAppearance: Object.freeze({
         id: "scrollbarAppearance",
         label: "Scrollbar mode",
@@ -77,7 +101,7 @@ export const OWNED_SETTING_DECLARATIONS = Object.freeze({
         id: "promptSuggestions",
         label: "Prompt suggestions",
         section: AGENT_SECTION,
-        description: "Predict likely next prompts with one additional background request using the selected model.",
+        description: "Predict likely next prompts with one background request, plus one bounded recovery request when needed, using the selected model.",
         application: "live",
         defaultValue: true,
         allowedValues: Object.freeze([true, false]),

package/dist/ui/settings/migrations.js

@@ -81,6 +81,29 @@ export const OWNED_UI_SETTINGS_MIGRATIONS = Object.freeze([
             return { ...values };
         },
     }),
+    Object.freeze({
+        to: 11,
+        description: "Introduce semantic accent selection with the active-theme default.",
+        migrate(values) {
+            return { ...values };
+        },
+    }),
+    Object.freeze({
+        to: 12,
+        description: "Rename the inherited default accent choice to explicit purple.",
+        migrate(values) {
+            return values.accentColor === "default"
+                ? { ...values, accentColor: "purple" }
+                : { ...values };
+        },
+    }),
+    Object.freeze({
+        to: 13,
+        description: "Introduce the transparent fullscreen background default.",
+        migrate(values) {
+            return { ...values };
+        },
+    }),
 ]);
 export function assertOwnedUiSettingsMigrations(migrations, currentVersion = OWNED_UI_SETTINGS_VERSION) {
     const firstProduced = currentVersion - migrations.length + 1;

package/docs/architecture/boundaries.md

@@ -30,7 +30,7 @@ The owned Pi-backed surface is not an arbitrary-CLI terminal multiplexer. A feat
 - `prompt-suggestions`: opt-in bounded diagnostic snapshots of neutral suggestion lifecycle metadata. Composition supplies an explicit local destination; this feature never imports Pi, generates suggestions, stores conversation text, or owns the editor. See [prompt suggestion diagnostics](prompt-suggestions.md).
 - `storage`: SQLite migrations, prior-boot reconciliation, and plural launch-instance persistence. Legacy foreground rows are historical migration input and never authorize current ownership.
 - `supervisor`: endpoint identity, plural cohort ownership, per-instance reconciliation, and aggregate release shutdown coordination. It owns no terminal surface.
-- `pi-engine-adapter`, `pi-component-adapter`, and `pi-tui-runtime-adapter`: isolate pinned Pi engine and presentation knowledge behind neutral contracts; product features do not import them directly.
+- `pi-engine-adapter`, `pi-component-adapter`, and `pi-tui-runtime-adapter`: isolate pinned Pi engine and presentation knowledge behind neutral contracts; product features do not import them directly. Inside the engine adapter, one process-level engine host owns what is process-wide (the HTTP dispatcher, the theme singletons, the one-time changelog and package-update announcements, the startup trace) and is the only place sessions are created, so every session id is unique per process.
 - `session-shell` (`src/app/session-shell`): the application layer that composes the feature owners, the UI foundations, and the three Pi adapters into the interactive session; only composition imports it. Its render root assembles semantic document and dock rows, while its focused viewport controller owns follow state, pointer routing, selection, and interaction timers. Owned-app route lifecycle belongs to the neutral `ui-apps` owner and is only hosted by the session shell.
 - release/update/bootstrap: package-derived immutable release identity, process-guardian integrity, cohort selection, durable update transactions, rollback, and dependency-light command entry. After an unsuccessful bare-A1 child exit, the bootstrap restores owned terminal modes; neither guardian emits terminal controls.
 - `terminal-cleanup`: bounded, idempotent emergency restoration and fatal-exit diagnostics for an explicitly owned terminal. It does not inspect commands, relay terminal input/output, or emulate terminal state. The owned UI installs its fatal boundary before terminal activation; packaged bootstrap and checkout launch provide the surviving-owner fallback. Fatal records retain at most ten 16 KiB records with trusted classifications and code locations, never prompts, attachments, raw input, credentials, or arbitrary exception messages.
@@ -43,6 +43,14 @@ The JavaScript product path has no PTY or terminal-emulator dependency. Reintrod
 
 `scripts/governance/check-architecture.mjs` enforces the structural parts of these boundaries. Cross-cutting rationale belongs here; implementation history belongs in Git and archived OpenSpec changes.
 
+## Multi-session limits of the pinned engine
+
+The engine host removes A1's own obstacles to several Pi sessions in one process, but three remain in the pinned Pi SDK and must be planned around, not discovered:
+
+- The extension cache is keyed by one working directory and cleared on reload (`core/extensions/loader.js`), so sessions in different directories reload each other's extensions.
+- `SettingsManager` writes under a lockfile but never re-reads the file, so a second in-memory copy goes stale after another session writes a setting (`core/settings-manager.js`). The host keeps the one process-wide effect, the HTTP dispatcher, consistent itself.
+- `AgentSessionRuntime.dispose()` releases the session but not the model runtime or the resource loader it was created with (`core/agent-session-runtime.js`), so a session's services outlive it until the process ends.
+
 ## Planned multi-agent boundaries
 
 The multi-agent workspace feature, its dependency-free contracts, the structured-agent runtime, and the Node side of the terminal-host protocol were removed from `develop` while the multi-agent plan is on hold; their last state is preserved on the `archive/multi-agent-workspace` branch. A future implementation starts from the current codebase rather than from that copy. The boundary rules below remain the design intent for that work.

package/docs/architecture/project-structure.md

@@ -18,13 +18,14 @@ src/
     prompt-history/                profile-isolated prompt retention and bounded SQLite worker lifecycle
     prompt-suggestions/            opt-in bounded metadata capture and local diagnostic snapshots
   contracts/
-    agent-engine/                  dependency-free agent engine, session, package, and capability ports
+    agent-engine/                  dependency-free agent settings and package contracts
     owned-ui/                      dependency-free owned-session and extension UI contracts
     presentation/                  dependency-free component, terminal, and runtime ports
   integrations/
     pi/
       components/                  pinned Pi component and theme adaptation
       engine/                      pinned Pi engine, settings, resource, package, and workflow integration
+      session-presenters/          pinned Pi selectors and transcript renderers built from engine objects
       tui-runtime/                 neutral presentation runtime over pinned Pi TUI
   foundation/
     launch-guardian/               authenticated launch-instance coordination
@@ -42,7 +43,7 @@ src/
 
 Each directory owner exposes `index.ts`, which lists its named exports; `export *` is rejected there so a public contract is readable in one place. Imports within one owner may use private files. Imports crossing owners must use the provider's public entry and follow the dependency DAG declared by `PROJECT_OWNERS`. Two exceptions exist: `src/composition` is the dependency-injection root and may reach past any public entry, and a module on the eager startup path may import a leaf of a provider whose public entry is a prohibited startup entry (`PROHIBITED_STARTUP_ENTRIES` in `startup-graph-policy.mjs`), because loading that barrel would pull the provider's whole graph into startup. `product-identity` is the sole exception to the directory-entry convention because its public entry is `src/product-identity.ts`.
 
-Three layer boundaries hold regardless of the DAG: `src/contracts/*` import nothing outside their own contract; `src/ui/components` imports only contracts; only `src/integrations/pi/*` and the shipped `bin/` entries import the pinned Pi packages. The session shell under `src/app` is the application layer: it may import the contracts, the UI foundations, the three Pi adapters, and the feature owners, and only composition imports it.
+Three layer boundaries hold regardless of the DAG: `src/contracts/*` import nothing outside their own contract; `src/ui/components` imports only contracts; only `src/integrations/pi/*` and the shipped `bin/` entries import the pinned Pi packages. The session shell under `src/app` is the application layer: it may import the contracts, the UI foundations, the three Pi adapters, and the feature owners, and only composition imports it. The shell never holds a Pi engine object: selectors and transcript renderers built from one live in `src/integrations/pi/session-presenters`, the only owner besides composition that may import both the engine and the component adapters, and the shell opens them through the `OwnedUiSessionPresenters` contract.
 
 `src/cli` contains command policy but delegates runtime work. `src/composition` is the concrete dependency-injection boundary: it may know both neutral contracts and Pi implementations, while product features receive vendor-neutral ports. Foundation modules never import product features. Pi package knowledge remains inside the Pi adapter owners.
 
@@ -92,18 +93,19 @@ Build output mirrors the production namespaces directly under ignored `dist/`, w
 
 Every task worktree must be created at `{working-dir}/.worktrees/<task-id>`, where `{working-dir}` is the agent session's initial working directory. The `.worktrees` directory is inside that working directory, not beside it. For working directory `D:/Git/a1`, `D:/Git/a1/.worktrees/<task-id>` is correct and `D:/Git/a1-<task-id>` is forbidden.
 
-From the initial working directory, create the task branch and worktree, run `a1 session link-worktree <absolute-worktree>` from the owning A1 session, and continue to address it explicitly:
+From the initial working directory, run `a1 session worktrees` to inspect cooperative live ownership before selecting an existing checkout. A `busy` or `unverifiable` worktree is unavailable. An `available` checkout may be reused only when its exact branch, OpenSpec change, and pull request match the requested stream and atomic `a1 session link-worktree <absolute-worktree>` succeeds; names, similar files, recency, cleanliness, and ancestry are not ownership evidence. Otherwise create a fresh task branch/worktree, link it from the owning A1 session, and continue to address it explicitly:
 
 ```sh
+a1 session worktrees
 git fetch origin develop
 git worktree add -b <type>/<short-description> .worktrees/<task-id> origin/develop
 a1 session link-worktree <absolute-worktree>
 git -C .worktrees/<task-id> status
 ```
 
-A successful link response confirming the exact canonical worktree is required before planning, implementation, test, or delivery-documentation edits. If linking fails or confirms another path, stop task edits and report the blocker instead of continuing with primary-checkout footer metadata. A session resuming an existing delivery or switching streams links the exact owned worktree before editing it.
+Inventory is read-only and advisory because another runtime may win a later race. A successful link response confirming the exact canonical worktree is required before planning, implementation, test, or delivery-documentation edits. If inventory or linking fails, reports a live/unverifiable owner, loses a race, or confirms another path, stop task edits and report the blocker; use a separate fresh worktree rather than overriding, unlinking, or recovering that owner. A session resuming an existing delivery or switching streams atomically claims and links the exact worktree before editing it.
 
-The association switches bare A1's footer repository context and pull-request discovery; it does not change process or tool cwd and does not register, claim, release, or authorize cleanup of the worktree. Repository commands therefore keep an explicit worktree path. The primary worktree stays on `develop` for integration and must not be used for task edits. Do not edit, adopt, move, or remove another session's worktree.
+The link acquires a cooperative live-session editing claim and switches bare A1's footer repository context and pull-request discovery. It does not change process or tool cwd, create a Git worktree lock, or register, release, or authorize cleanup. Clean unlink/disposal releases live editing authority; a crashed owner becomes reusable only after exact process death is verified. Repository commands therefore keep an explicit worktree path. The primary worktree stays on `develop` for integration and must not be used for task edits. Do not edit, adopt, move, or remove another session's worktree.
 
 An agent that directly chooses a transient file path for a PR/comment body, command payload, captured output, temporary patch/diff, or ad hoc log must place it beneath the linked worktree's exact `.artifacts/` root, never the primary checkout, another worktree, OS temp, home/desktop, or a sibling path. Such scratch remains ignored, unstaged, uncommitted, disposable, non-authoritative, and secret-free. This repository path rule does not relocate storage internally selected by tools, product runtime code, or hermetic tests.