@timurproko/a1 0.2.7-dev.810 → 0.2.7-dev.828

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

@@ -15,6 +15,19 @@ const IDENTITY_ROW = (row) => row;
 function documentSelectionAnchor(row, source, liveFromBottom) {
     return { kind: "document", row, source, identity: stripAnsi(source).trimEnd(), liveFromBottom };
 }
+function sameSelectionRowAnchor(left, right) {
+    if (left.kind !== right.kind)
+        return false;
+    if (left.kind === "document" && right.kind === "document") {
+        return left.row === right.row && left.source === right.source && left.liveFromBottom === right.liveFromBottom;
+    }
+    if (left.kind === "screen" && right.kind === "screen") {
+        return left.row === right.row && left.source === right.source;
+    }
+    if (left.kind === "transient" && right.kind === "transient")
+        return left.fromBottom === right.fromBottom;
+    return left.kind === "dock" && right.kind === "dock" && left.fromBottom === right.fromBottom;
+}
 function viewportSelectionAnchor(row, source, selectableDocumentRowCount, documentRowCount) {
     return row < selectableDocumentRowCount
         ? documentSelectionAnchor(row, source)
@@ -140,7 +153,12 @@ export class TranscriptViewport {
             this.scrollBy(1, now);
         else if (autoScroll && frameRow <= 1 && this.#scrollTop > 0)
             this.scrollBy(-1, now);
-        const line = clamp(frameRow - 1, 0, this.#selectionRows.length - 1);
+        const pointerLine = clamp(frameRow - 1, 0, this.#selectionRows.length - 1);
+        // Invariant: a pinned prompt alias is chrome; an upward drag reaching it keeps the pointer
+        // column on the first visible content row.
+        const line = pointerLine < this.#firstSelectableRow && pointerLine < selection.anchor.line
+            ? this.#firstSelectableRow
+            : pointerLine;
         const selectionWidth = line < (this.#frame?.hits.viewportHeight ?? 0)
             ? this.#contentWidth
             : this.#selectionWidth;
@@ -151,12 +169,13 @@ export class TranscriptViewport {
             ? { line, column: targetColumn }
             : textSelectionPointAt(line, targetColumn, this.#selectionRows[line] ?? "");
         const next = extendTextSelection(selection, point);
-        if (next !== selection) {
-            const headAnchor = this.#selectionAnchorAt(line);
-            if (headAnchor === undefined || this.#selectionAnchors === undefined) {
-                this.clearSelection();
-                return true;
-            }
+        const headAnchor = this.#selectionAnchorAt(line);
+        if (headAnchor === undefined || this.#selectionAnchors === undefined) {
+            this.clearSelection();
+            return true;
+        }
+        // Invariant: edge auto-scroll changes the document row under a still pointer; that advances the head.
+        if (next !== selection || !sameSelectionRowAnchor(this.#selectionAnchors.head, headAnchor)) {
             this.#selection = next;
             this.#selectionAnchors = { ...this.#selectionAnchors, head: headAnchor };
             this.#selectionRevision += 1;
@@ -184,25 +203,66 @@ export class TranscriptViewport {
         return true;
     }
     selectedText() {
-        const selection = this.#visibleSelection();
-        if (selection === undefined)
+        const visible = this.#visibleSelection();
+        if (visible === undefined)
             return null;
-        const copiedLines = Array.from({ length: Math.max(0, selection.end.line - selection.start.line + 1) }, (_value, index) => selection.start.line + index).filter(line => {
+        const offscreen = offscreenSelectionRows(this.#selection, this.#selectionAnchors, this.#scrollTop, this.#firstSelectableRow, this.#viewportHeight, this.#documentRows.length);
+        // Rationale: edge auto-scroll grows a drag beyond one screen. Paint stays clipped to the
+        // frame, while copy reads the selected document rows past either viewport edge and beneath
+        // the floating bottom control.
+        const selectionRows = [];
+        const rowAnchors = [];
+        const controlLine = (this.#frame?.hits.bottom?.row ?? 0) - 1;
+        const pushDocumentRow = (row) => {
+            const source = this.#documentRows[row] ?? "";
+            selectionRows.push(truncateToWidth(source, this.#contentWidth));
+            rowAnchors.push(documentSelectionAnchor(row, source));
+        };
+        const pushBelow = () => {
+            for (let row = offscreen.below?.from ?? 0; row <= (offscreen.below?.to ?? -1); row += 1)
+                pushDocumentRow(row);
+        };
+        for (let row = offscreen.above?.from ?? 0; row <= (offscreen.above?.to ?? -1); row += 1)
+            pushDocumentRow(row);
+        if (offscreen.belowFirst)
+            pushBelow();
+        for (let line = visible.start.line; line <= visible.end.line; line += 1) {
             const anchor = this.#selectionRowAnchors[line];
+            if (line === controlLine && anchor?.kind === "document")
+                pushDocumentRow(anchor.row);
+            else {
+                selectionRows.push(this.#selectionRows[line] ?? "");
+                rowAnchors.push(anchor);
+            }
+        }
+        if (!offscreen.belowFirst)
+            pushBelow();
+        const offscreenStart = offscreen.above !== undefined || offscreen.belowFirst === true;
+        const offscreenEnd = offscreen.below !== undefined && !offscreen.belowFirst;
+        const selection = {
+            ...visible,
+            start: { line: 0, column: offscreenStart ? offscreen.startColumn ?? 0 : visible.start.column },
+            end: {
+                line: selectionRows.length - 1,
+                column: offscreenEnd ? offscreen.endColumn ?? Number.MAX_SAFE_INTEGER : visible.end.column,
+            },
+        };
+        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 = rowAnchors[line];
             return anchor?.kind === "document" && anchor.row < this.#selectableDocumentRowCount
                 || anchor?.kind === "dock" && this.#copyableDockRows.has(anchor.fromBottom);
         });
         if (copiedLines.length === 0)
             return null;
-        const transcriptLines = copiedLines.filter(line => this.#selectionRowAnchors[line]?.kind === "document");
+        const transcriptLines = copiedLines.filter(line => rowAnchors[line]?.kind === "document");
         const prompt = transcriptLines.length === 0 ? undefined : this.#promptAnchors.find(candidate => transcriptLines.every(line => {
-            const anchor = this.#selectionRowAnchors[line];
+            const anchor = rowAnchors[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];
+        const text = textSelectionText(selection, selectionRows, line => {
+            const row = selectionRows[line] ?? "";
+            const anchor = rowAnchors[line];
             const dock = anchor?.kind === "dock" ? this.#copyableDockRows.get(anchor.fromBottom) : undefined;
             if (prompt !== undefined && anchor?.kind === "document") {
                 const first = anchor.row === prompt.firstRow;
@@ -211,11 +271,12 @@ export class TranscriptViewport {
                     : row;
                 return selectionCopyLineContent(copyRow, first ? "first" : "continuation");
             }
-            return dock?.prompt !== undefined ? selectionCopyLineContent(row, dock.prompt) : usefulTextLineContent(row);
+            // Invariant: the dock editor has no prefix; transcript prompts still carry chrome.
+            return dock?.prompt !== undefined ? usefulTextLineContent(row, 1) : usefulTextLineContent(row);
         }, line => included.has(line));
         return text.length === 0 ? null : text;
     }
-    /** Captures visible selected text, not off-screen history. */
+    /** Captures selected text, including document rows of a visible selection scrolled off-screen. */
     captureSelectedText() {
         if (!this.#copyableSelection)
             return null;
@@ -470,7 +531,7 @@ export class TranscriptViewport {
                 const bottomHovered = pointer !== undefined && pointer.row === bottomHit.row
                     && pointer.column >= bottomHit.columnStart && pointer.column <= bottomHit.columnEnd;
                 control = { row, left, text: `${CONTROL_STYLE_RESET}${theme.bottomControl(label, bottomHovered)}` };
-                // Invariant: the control floats above selection; its cells are never selected or copied.
+                // Invariant: the control floats above selection; copy restores the text beneath it.
                 selectionRows[row] = overlaySpan(padRowPreservingBackground(selectionRows[row] ?? "", width), left, left + labelWidth, " ".repeat(labelWidth));
             }
         }
@@ -701,7 +762,7 @@ export class TranscriptViewport {
         const anchors = this.#selectionAnchors;
         if (selection === undefined || anchors === undefined)
             return;
-        const project = (anchor) => {
+        const project = (anchor, moving) => {
             if (anchor.kind === "dock") {
                 const dockIndex = dockRows.length - anchor.fromBottom - 1;
                 return dockIndex < 0 || dockIndex >= dockRows.length
@@ -743,7 +804,7 @@ export class TranscriptViewport {
             // 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) {
+            if (selection.selecting && moving && 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);
@@ -755,10 +816,18 @@ export class TranscriptViewport {
                     }
                 }
             }
+            // Concurrency: streaming may restyle a held endpoint's row; it keeps its document index.
+            // Following the tail would drag the press row toward the newest output.
+            if (selection.selecting && anchor.row >= 0 && anchor.row < documentRows.length) {
+                return {
+                    line: anchor.row - this.#scrollTop,
+                    anchor: documentSelectionAnchor(anchor.row, documentRows[anchor.row] ?? "", anchor.liveFromBottom),
+                };
+            }
             return undefined;
         };
-        const projectedAnchor = project(anchors.anchor);
-        const projectedHead = project(anchors.head);
+        const projectedAnchor = project(anchors.anchor, false);
+        const projectedHead = project(anchors.head, true);
         if (projectedAnchor === undefined || projectedHead === undefined) {
             this.clearSelection();
             return;
@@ -778,11 +847,59 @@ export class TranscriptViewport {
         // 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);
+        const ordered = orderedTextSelection(dockOrderedSelection(this.#selection, anchors, this.#viewportHeight));
+        return visibleTextSelection(ordered, rows, this.#firstSelectableRow);
     }
     #updateCopyableSelection() {
-        this.#copyableSelection = this.selectedText() !== null;
+        // Performance: off-screen rows count as copyable by range alone; capture trims whitespace later.
+        const offscreen = offscreenSelectionRows(this.#selection, this.#selectionAnchors, this.#scrollTop, this.#firstSelectableRow, this.#viewportHeight, this.#documentRows.length);
+        const selectable = [offscreen.above, offscreen.below]
+            .some(range => range !== undefined && range.from < this.#selectableDocumentRowCount);
+        this.#copyableSelection = selectable && this.#visibleSelection() !== undefined || this.selectedText() !== null;
+    }
+}
+/**
+ * Invariant: dock rows follow the whole transcript, so a document endpoint scrolled below the
+ * viewport orders before every dock row instead of at its numeric frame line among them.
+ */
+function dockOrderedSelection(selection, anchors, viewportHeight) {
+    if (selection === undefined || anchors === undefined || anchors.anchor.kind !== "dock" && anchors.head.kind !== "dock") {
+        return selection;
     }
+    const place = (point, kind) => kind === "document" && point.line >= viewportHeight ? { line: viewportHeight, column: 1, from: 0, to: 0 } : point;
+    return { ...selection, anchor: place(selection.anchor, anchors.anchor.kind), head: place(selection.head, anchors.head.kind) };
+}
+/** Document rows of a selection whose endpoints lie beyond the visible viewport edges. */
+function offscreenSelectionRows(selection, anchors, scrollTop, firstSelectableRow, viewportHeight, documentRowCount) {
+    const ordered = orderedTextSelection(dockOrderedSelection(selection, anchors, viewportHeight));
+    if (selection === undefined || ordered === undefined || anchors === undefined)
+        return {};
+    const placed = dockOrderedSelection(selection, anchors, viewportHeight);
+    const anchorFirst = placed.anchor.line < placed.head.line
+        || placed.anchor.line === placed.head.line && placed.anchor.column <= placed.head.column;
+    const top = anchorFirst ? anchors.anchor : anchors.head;
+    const bottom = anchorFirst ? anchors.head : anchors.anchor;
+    const topPoint = anchorFirst ? selection.anchor : selection.head;
+    const bottomPoint = anchorFirst ? selection.head : selection.anchor;
+    const firstVisibleRow = scrollTop + firstSelectableRow;
+    const pastVisibleRow = scrollTop + viewportHeight;
+    const columns = {
+        startColumn: selection.fullRow ? 0 : topPoint.from ?? Math.max(0, topPoint.column - 1),
+        endColumn: selection.fullRow ? Number.MAX_SAFE_INTEGER : bottomPoint.to ?? bottomPoint.column,
+    };
+    if (top.kind === "document" && bottom.kind === "dock" && top.row >= pastVisibleRow) {
+        return { ...columns, below: { from: top.row, to: documentRowCount - 1 }, belowFirst: true };
+    }
+    return {
+        ...columns,
+        ...(top.kind === "document" && top.row < firstVisibleRow && ordered.start.line < firstSelectableRow
+            ? { above: { from: top.row, to: firstVisibleRow - 1 } }
+            : {}),
+        ...(top.kind === "document" && bottom.kind === "document" && bottom.row >= pastVisibleRow
+            && ordered.end.line >= viewportHeight
+            ? { below: { from: pastVisibleRow, to: bottom.row } }
+            : {}),
+    };
 }
 function visibleTextSelection(selection, rowCount, firstRow) {
     if (selection === undefined || rowCount <= firstRow || selection.end.line < firstRow || selection.start.line >= rowCount)

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

@@ -1,11 +1,9 @@
-export declare const OWNED_UI_SETTINGS_VERSION = 17;
+export declare const OWNED_UI_SETTINGS_VERSION = 19;
 export type OwnedUiSettingValue = string | number | boolean;
 export type OwnedUiSettingApplication = "live" | "restart";
 export interface OwnedUiSettingDeclaration {
     readonly id: string;
-    /** Optional presentation label; the id remains the persistence key. */
     readonly label?: string;
-    /** Optional settings-screen group for related owned controls. */
     readonly section?: {
         readonly id: string;
         readonly title: string;
@@ -14,23 +12,28 @@ export interface OwnedUiSettingDeclaration {
     readonly application: OwnedUiSettingApplication;
     readonly defaultValue: OwnedUiSettingValue;
     readonly allowedValues: readonly OwnedUiSettingValue[];
+    /**
+     * Parts of a structured setting, edited through their own dialog: the value is the comma-separated
+     * keys of the enabled parts in this order.
+     */
+    readonly flags?: readonly {
+        readonly key: string;
+        readonly label: string;
+        readonly description: string;
+    }[];
 }
-/**
- * Every A1 setting, keyed by its id. The table is the one declaration: ids, defaults, and allowed
- * values are read from it, and `OwnedSettingValueOf` derives each getter's type from it.
- */
 export declare const OWNED_SETTING_DECLARATIONS: Readonly<{
     readonly updateCheck: Readonly<{
         id: "updateCheck";
-        label: "Update check";
+        label: "Update";
         section: Readonly<{
             id: "generic";
             title: "Generic";
         }>;
-        description: "Check once a day at startup whether a newer A1 release exists on this channel and show a notice. Uses the public npm registry; applies on next start.";
+        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.";
         application: "restart";
-        defaultValue: true;
-        allowedValues: readonly [true, false];
+        defaultValue: "auto";
+        allowedValues: readonly ["auto", "notify", "no"];
     }>;
     readonly timeFormat: Readonly<{
         id: "timeFormat";
@@ -53,8 +56,8 @@ export declare const OWNED_SETTING_DECLARATIONS: Readonly<{
         }>;
         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"];
+        defaultValue: "blue";
+        allowedValues: readonly ["blue", "purple", "cyan", "green", "orange", "pink"];
     }>;
     readonly backgroundStyle: Readonly<{
         id: "backgroundStyle";
@@ -123,11 +126,23 @@ export declare const OWNED_SETTING_DECLARATIONS: Readonly<{
             id: "history";
             title: "History";
         }>;
-        description: "Retain reusable prompts across sessions. Applies on next start; disabling does not erase saved history or stop existing instances.";
+        description: "Retain reusable prompts after restart. Applies on next start; disabling does not erase saved history or stop existing instances.";
         application: "restart";
         defaultValue: true;
         allowedValues: readonly [true, false];
     }>;
+    readonly promptHistoryScope: Readonly<{
+        id: "promptHistoryScope";
+        label: "History scope";
+        section: Readonly<{
+            id: "history";
+            title: "History";
+        }>;
+        description: "Unique shows each agent session's history; Shared shows the profile-wide history. Switches running agents without moving or erasing saved prompts.";
+        application: "live";
+        defaultValue: "unique";
+        allowedValues: readonly ["unique", "shared"];
+    }>;
     readonly promptHistoryMaxItems: Readonly<{
         id: "promptHistoryMaxItems";
         label: "History limit";
@@ -176,12 +191,49 @@ export declare const OWNED_SETTING_DECLARATIONS: Readonly<{
         defaultValue: 8;
         allowedValues: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16];
     }>;
+    readonly tabsPosition: Readonly<{
+        id: "tabsPosition";
+        label: "Position";
+        section: Readonly<{
+            id: "tabs";
+            title: "Tab Bar";
+        }>;
+        description: "Place the resident tab bar at the top or bottom of the terminal.";
+        application: "live";
+        defaultValue: "top";
+        allowedValues: readonly ["top", "bottom"];
+    }>;
+    readonly tabBarPlusMenu: Readonly<{
+        id: "tabBarPlusMenu";
+        label: "Plus menu";
+        section: Readonly<{
+            id: "tabs";
+            title: "Tab Bar";
+        }>;
+        description: "The tabs + offers. With only Agent, + adds an Agent at once; with more, it opens a menu; with none, + is hidden.";
+        application: "live";
+        defaultValue: "agent";
+        allowedValues: readonly ["", "agent", "settings", "changelog", "agent,settings", "agent,changelog", "settings,changelog", "agent,settings,changelog"];
+        flags: readonly (Readonly<{
+            key: "agent";
+            label: "Agent";
+            description: "Add a new Agent tab every time.";
+        }> | Readonly<{
+            key: "settings";
+            label: "Settings";
+            description: "Show the one Settings tab.";
+        }> | Readonly<{
+            key: "changelog";
+            label: "Changelog";
+            description: "Show the one Changelog tab.";
+        }>)[];
+    }>;
     readonly tabsAutoName: Readonly<{
         id: "tabsAutoName";
         label: "Auto name";
         section: Readonly<{
             id: "tabs";
-            title: "Tabs";
+            title: "Tab Bar";
         }>;
         description: "Automatically name a new tab from its first completed turn with the tab's current model.";
         application: "live";
@@ -190,9 +242,7 @@ export declare const OWNED_SETTING_DECLARATIONS: Readonly<{
     }>;
 }>;
 export type OwnedSettingId = keyof typeof OWNED_SETTING_DECLARATIONS;
-/** The value type a setting's declaration allows: a literal union for a choice, `number` for a stepped range. */
 export type OwnedSettingValueOf<Id extends OwnedSettingId> = (typeof OWNED_SETTING_DECLARATIONS)[Id]["allowedValues"][number];
-/** The declarations in declaration order, for resolution, persistence, and the settings screen. */
 export declare const OWNED_UI_SETTING_DECLARATIONS: readonly OwnedUiSettingDeclaration[];
 export declare function isOwnedSettingId(id: string): id is OwnedSettingId;
 export declare function assertOwnedUiSettingDeclarations(declarations: readonly OwnedUiSettingDeclaration[]): void;

package/dist/ui/settings/declarations.js

@@ -1,28 +1,33 @@
-export const OWNED_UI_SETTINGS_VERSION = 17;
+export const OWNED_UI_SETTINGS_VERSION = 19;
 const UI_ACCENT_COLOR_CHOICES = Object.freeze([
-    "purple", "blue", "cyan", "green", "orange", "pink",
+    "blue", "purple", "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" });
-const TABS_SECTION = Object.freeze({ id: "tabs", title: "Tabs" });
-/**
- * Every A1 setting, keyed by its id. The table is the one declaration: ids, defaults, and allowed
- * values are read from it, and `OwnedSettingValueOf` derives each getter's type from it.
- */
+const TABS_SECTION = Object.freeze({ id: "tabs", title: "Tab Bar" });
+/** The tab kinds the strip's `+` can offer, in the order it shows them. */
+const PLUS_MENU_KINDS = Object.freeze([
+    Object.freeze({ key: "agent", label: "Agent", description: "Add a new Agent tab every time." }),
+    Object.freeze({ key: "settings", label: "Settings", description: "Show the one Settings tab." }),
+    Object.freeze({ key: "changelog", label: "Changelog", description: "Show the one Changelog tab." }),
+]);
+/** Every enabled subset of the plus-menu kinds, each in kind order. */
+const PLUS_MENU_VALUES = Object.freeze([
+    "", "agent", "settings", "changelog", "agent,settings", "agent,changelog", "settings,changelog", "agent,settings,changelog",
+]);
 export const OWNED_SETTING_DECLARATIONS = Object.freeze({
     updateCheck: Object.freeze({
         id: "updateCheck",
-        label: "Update check",
+        label: "Update",
         section: GENERIC_SECTION,
-        description: "Check once a day at startup whether a newer A1 release exists on this channel and show a notice. Uses the public npm registry; applies on next start.",
+        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.",
         application: "restart",
-        defaultValue: true,
-        allowedValues: Object.freeze([true, false]),
+        defaultValue: "auto",
+        allowedValues: Object.freeze(["auto", "notify", "no"]),
     }),
     timeFormat: Object.freeze({
         id: "timeFormat",
@@ -41,7 +46,7 @@ export const OWNED_SETTING_DECLARATIONS = Object.freeze({
         section: APPEARANCE_SECTION,
         description: "Color used by highlighted interface controls, list markers, and tonal interface surfaces.",
         application: "live",
-        defaultValue: "purple",
+        defaultValue: "blue",
         allowedValues: UI_ACCENT_COLOR_CHOICES,
     }),
     backgroundStyle: Object.freeze({
@@ -95,11 +100,20 @@ export const OWNED_SETTING_DECLARATIONS = Object.freeze({
         id: "promptHistoryEnabled",
         label: "Persistent history",
         section: Object.freeze({ id: "history", title: "History" }),
-        description: "Retain reusable prompts across sessions. Applies on next start; disabling does not erase saved history or stop existing instances.",
+        description: "Retain reusable prompts after restart. Applies on next start; disabling does not erase saved history or stop existing instances.",
         application: "restart",
         defaultValue: true,
         allowedValues: Object.freeze([true, false]),
     }),
+    promptHistoryScope: Object.freeze({
+        id: "promptHistoryScope",
+        label: "History scope",
+        section: Object.freeze({ id: "history", title: "History" }),
+        description: "Unique shows each agent session's history; Shared shows the profile-wide history. Switches running agents without moving or erasing saved prompts.",
+        application: "live",
+        defaultValue: "unique",
+        allowedValues: Object.freeze(["unique", "shared"]),
+    }),
     promptHistoryMaxItems: Object.freeze({
         id: "promptHistoryMaxItems",
         label: "History limit",
@@ -136,6 +150,25 @@ export const OWNED_SETTING_DECLARATIONS = Object.freeze({
         defaultValue: 8,
         allowedValues: Object.freeze([1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]),
     }),
+    tabsPosition: Object.freeze({
+        id: "tabsPosition",
+        label: "Position",
+        section: TABS_SECTION,
+        description: "Place the resident tab bar at the top or bottom of the terminal.",
+        application: "live",
+        defaultValue: "top",
+        allowedValues: Object.freeze(["top", "bottom"]),
+    }),
+    tabBarPlusMenu: Object.freeze({
+        id: "tabBarPlusMenu",
+        label: "Plus menu",
+        section: TABS_SECTION,
+        description: "The tabs + offers. With only Agent, + adds an Agent at once; with more, it opens a menu; with none, + is hidden.",
+        application: "live",
+        defaultValue: "agent",
+        allowedValues: PLUS_MENU_VALUES,
+        flags: PLUS_MENU_KINDS,
+    }),
     tabsAutoName: Object.freeze({
         id: "tabsAutoName",
         label: "Auto name",
@@ -146,7 +179,6 @@ export const OWNED_SETTING_DECLARATIONS = Object.freeze({
         allowedValues: Object.freeze([true, false]),
     }),
 });
-/** The declarations in declaration order, for resolution, persistence, and the settings screen. */
 export const OWNED_UI_SETTING_DECLARATIONS = Object.freeze(Object.values(OWNED_SETTING_DECLARATIONS));
 export function isOwnedSettingId(id) {
     return Object.hasOwn(OWNED_SETTING_DECLARATIONS, id);

package/dist/ui/settings/early-accent.d.ts

@@ -0,0 +1,81 @@
+import type { UiAccentColor } from "../../contracts/owned-ui/index.js";
+type Appearance = "dark" | "light";
+type ColorMode = "truecolor" | "256color";
+/** Global settings only: project resources must remain unavailable until trust is resolved. */
+export declare function readPreTrustAccent(environment?: NodeJS.ProcessEnv): UiAccentColor;
+export declare function preTrustPalette(color: UiAccentColor, appearance: Appearance, mode: ColorMode): {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+} | {
+    accent: string;
+    border: string;
+};
+export declare function preTrustTerminalAppearance(environment?: NodeJS.ProcessEnv): Appearance;
+export declare function preTrustTerminalColorMode(environment?: NodeJS.ProcessEnv): ColorMode;
+export {};

package/dist/ui/settings/early-accent.js

@@ -0,0 +1,50 @@
+import { readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { isAbsolute, join } from "node:path";
+import { PRODUCT_IDENTITY } from "../../product-identity.js";
+import { SHARED_PROGRESS_PALETTE } from "./progress-palette.generated.js";
+/** Global settings only: project resources must remain unavailable until trust is resolved. */
+export function readPreTrustAccent(environment = process.env) {
+    try {
+        const home = environment[PRODUCT_IDENTITY.environment.profileHome] ?? homedir();
+        if (!isAbsolute(home) || home.includes("\0"))
+            return "blue";
+        const file = join(home, PRODUCT_IDENTITY.state.piAgentProfile, "settings.json");
+        if (statSync(file).size > 256 * 1024)
+            return "blue";
+        const raw = readFileSync(file, "utf8");
+        if (Buffer.byteLength(raw, "utf8") > 256 * 1024)
+            return "blue";
+        const root = JSON.parse(raw.replace(/^\uFEFF/u, ""));
+        if (root === null || typeof root !== "object" || Array.isArray(root))
+            return "blue";
+        const namespace = root[PRODUCT_IDENTITY.commandName];
+        if (namespace === null || typeof namespace !== "object" || Array.isArray(namespace))
+            return "blue";
+        const value = namespace.accentColor;
+        if (value === "default")
+            return "purple";
+        return typeof value === "string" && Object.hasOwn(SHARED_PROGRESS_PALETTE, value) ? value : "blue";
+    }
+    catch {
+        return "blue";
+    }
+}
+export function preTrustPalette(color, appearance, mode) {
+    return SHARED_PROGRESS_PALETTE[color][appearance][mode];
+}
+export function preTrustTerminalAppearance(environment = process.env) {
+    const index = Number.parseInt((environment.COLORFGBG ?? "").split(";").at(-1) ?? "", 10);
+    return Number.isInteger(index) && (index === 7 || index === 15 || index >= 231) ? "light" : "dark";
+}
+export function preTrustTerminalColorMode(environment = process.env) {
+    if (environment.PI_TRUE_COLOR === "1")
+        return "truecolor";
+    if (environment.PI_TRUE_COLOR === "0")
+        return "256color";
+    const program = (environment.TERM_PROGRAM ?? "").toLowerCase();
+    const known = ["kitty", "ghostty", "wezterm", "rex", "warpterminal", "iterm.app", "alacritty", "vscode", "zed"];
+    return /^(truecolor|24bit)$/iu.test(environment.COLORTERM ?? "") || (environment.TERM ?? "").endsWith("-direct")
+        || process.platform === "win32" || environment.WT_SESSION !== undefined || known.includes(program)
+        ? "truecolor" : "256color";
+}

package/dist/ui/settings/manager.js

@@ -188,9 +188,13 @@ export class OwnedSettingsManager {
         return () => this.#listeners.delete(listener);
     }
     async changeStructured(backend, id, value) {
-        if (backend !== "agent")
-            return failed("only an agent setting holds a structured value");
-        return await this.#changeAgentValue(id, value);
+        if (backend === "agent")
+            return await this.#changeAgentValue(id, value);
+        // Invariant: a flagged A1 setting stores its enabled parts as one value, in declaration order.
+        const flags = findOwnedUiSettingsEntry(this.sections(), id, "a1")?.flags ?? [];
+        if (flags.length === 0)
+            return failed(`${id} holds no structured value`);
+        return await this.change("a1", id, flags.filter(flag => value[flag.key] === true).map(flag => flag.key).join(","));
     }
     async change(backend, id, value) {
         const entry = findOwnedUiSettingsEntry(this.sections(), id, backend);