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

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

@@ -1,8 +1,18 @@
+import { dialogFrameGeometry, insetDialogContent } from "../../contracts/presentation/index.js";
 import { LineInput, renderInputRow } from "./line-input.js";
-import { renderShortcutHints, renderShortcutHintsWithClose, shortcutHintsText } from "./shortcut-hints.js";
+import { renderShortcutHintsWithClose } from "./shortcut-hints.js";
 import { displayWidth, 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. */
+function dialogPanelLayout(width, theme) {
+    const geometry = dialogFrameGeometry(width);
+    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),
+    };
+}
 /** 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))));
@@ -14,11 +24,7 @@ export function dialogValueColumn(rows) {
  */
 export function renderDialogPanel(state, width, theme) {
     const labelColumn = Math.min(LABEL_COLUMN_CAP, Math.max(0, ...state.rows.map(row => displayWidth(row.label))));
-    const rule = theme.fg("border", "─".repeat(Math.max(0, width)));
-    const contentPadding = Math.min(1, Math.max(0, width));
-    const contentWidth = Math.max(0, width - contentPadding);
-    const inset = " ".repeat(contentPadding);
-    const contentRow = (painted, raw) => `${inset}${pad(truncateToWidth(painted, contentWidth), contentWidth, raw)}`;
+    const layout = dialogPanelLayout(width, theme);
     const rows = state.rows.map((row, index) => {
         const selected = index === state.index;
         const padded = `${row.label}${" ".repeat(Math.max(0, labelColumn - displayWidth(row.label)))}`;
@@ -28,31 +34,27 @@ export function renderDialogPanel(state, width, theme) {
             ? `${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 contentRow(painted, raw);
+        return layout.contentRow(painted, raw);
     });
     const description = state.rows[state.index]?.description ?? "";
     const hint = typeof state.hint === "string"
         ? theme.fg("dim", state.hint)
-        : renderShortcutHintsWithClose(state.hint, theme, contentWidth, 0);
+        : renderShortcutHintsWithClose(state.hint, theme, layout.contentWidth, 0);
     const plainHint = typeof state.hint === "string" ? state.hint : " ".repeat(displayWidth(hint));
     return [
-        rule,
-        contentRow(theme.bold(theme.fg("accent", state.title)), state.title),
-        contentRow(theme.fg("dim", description), description),
+        layout.rule,
+        layout.contentRow(theme.bold(theme.fg("accent", state.title)), state.title),
+        layout.contentRow(theme.fg("dim", description), description),
         "",
         ...rows,
         "",
-        contentRow(hint, plainHint),
-        rule,
+        layout.contentRow(hint, plainHint),
+        layout.rule,
     ];
 }
 /** Owned stepped-selector composition for structured settings with nested choices. */
 export function renderSteppedDialogPanel(state, width, theme) {
-    const rule = theme.fg("border", "─".repeat(Math.max(0, width)));
-    const contentPadding = Math.min(1, Math.max(0, width));
-    const contentWidth = Math.max(0, width - contentPadding);
-    const inset = " ".repeat(contentPadding);
-    const contentRow = (painted, raw) => `${inset}${pad(truncateToWidth(painted, contentWidth), contentWidth, raw)}`;
+    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 ?? ""}`))));
     const rows = state.rows.map((row, index) => {
         const selected = index === state.index;
@@ -65,31 +67,34 @@ 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 contentRow(selected ? theme.highlight(content) : content, raw);
+        return layout.contentRow(selected ? theme.highlight(content) : content, raw);
     });
     const input = state.input === undefined
         ? []
-        : [...renderInputRow(state.input, width, { ruled: false, promptGlyph: "", theme }).lines, ""];
+        : [
+            ...renderInputRow(state.input, layout.contentWidth, {
+                ruled: false,
+                promptGlyph: "> ",
+                promptRole: "accent",
+                theme,
+            }).lines.map(row => layout.contentRow(row)),
+            "",
+        ];
     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 [
-        rule,
-        contentRow(paintedTitle, title),
-        contentRow(theme.fg("dim", state.description), state.description),
+        layout.rule,
+        layout.contentRow(paintedTitle, title),
+        layout.contentRow(theme.fg("dim", state.description), state.description),
         "",
         ...input,
         ...rows,
         "",
-        renderSteppedHint(state.hint, width, theme),
-        rule,
+        layout.contentRow(renderShortcutHintsWithClose(state.hint, theme, layout.contentWidth)),
+        layout.rule,
     ];
 }
-function renderSteppedHint(entries, width, theme) {
-    const raw = shortcutHintsText(entries, 1, " · ");
-    const painted = renderShortcutHints(entries, theme, 1, theme.fg("dim", " · "));
-    return `${truncateToWidth(painted, width)}${" ".repeat(Math.max(0, width - displayWidth(raw)))}`;
-}
 /** The row a pointer report lands on, or null when it is not on one. */
 export function dialogRowAt(frame, row, column, valueWidth) {
     const at = row - frame.firstRow;

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

@@ -1,3 +1,4 @@
+import { type PromptMarkerRole } from "./prompt-input.js";
 import type { UiTheme } from "./theme.js";
 export type LineInputOutcome = {
     readonly kind: "editing";
@@ -60,6 +61,8 @@ export interface InputRowOptions {
     readonly ruled?: boolean;
     /** Prompt marker including any following spacing. Defaults to the shared prompt glyph. */
     readonly promptGlyph?: string;
+    /** Semantic foreground for a configured prompt marker. */
+    readonly promptRole?: PromptMarkerRole;
     readonly theme?: Pick<UiTheme, "fg">;
 }
 export interface InputRow {

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

@@ -220,5 +220,7 @@ export function renderInputRow(input, width, options = {}) {
     const body = empty
         ? `${caretCell(placeholder.slice(0, 1))}${faint(placeholder.slice(1))}`
         : `${before}${caretCell(under)}${after}`;
-    return { lines: presentation.render(width, () => ({ rows: [body] }), options.ruled, 0, options.promptGlyph) };
+    return {
+        lines: presentation.render(width, () => ({ rows: [body] }), options.ruled, 0, options.promptGlyph, options.promptRole),
+    };
 }

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

@@ -4,7 +4,8 @@ export declare const PROMPT_PREFIX_WIDTH = 0;
 type RuleTheme = Pick<UiTheme, "fg">;
 export declare function promptRuleText(text: string, theme: RuleTheme): string;
 export declare function promptRule(width: number, theme: RuleTheme): string;
-export declare function promptArrow(text: string, theme: RuleTheme): string;
+export type PromptMarkerRole = "muted" | "accent";
+export declare function promptArrow(text: string, theme: RuleTheme, role?: PromptMarkerRole): string;
 export interface PromptInputBody {
     readonly rows: readonly string[];
     /** Semantic border fragments retain editor history and scroll annotations. */
@@ -31,6 +32,6 @@ export declare class PromptInput {
         contentWidth: number;
         layoutWidth: number;
     };
-    render(width: number, renderBody: (innerWidth: number) => PromptInputBody, ruled?: boolean, padding?: number, promptGlyph?: string): string[];
+    render(width: number, renderBody: (innerWidth: number) => PromptInputBody, ruled?: boolean, padding?: number, promptGlyph?: string, promptRole?: PromptMarkerRole): string[];
 }
 export {};

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

@@ -8,8 +8,10 @@ export function promptRuleText(text, theme) {
 export function promptRule(width, theme) {
     return promptRuleText("─".repeat(Math.max(0, width)), theme);
 }
-export function promptArrow(text, theme) {
-    return theme.fg("muted", text);
+export function promptArrow(text, theme, role = "muted") {
+    if (role === "accent" && text.startsWith(">"))
+        return `${theme.fg(role, ">")}${text.slice(1)}`;
+    return theme.fg(role, text);
 }
 /** Composes shared input chrome around controller-owned body rows without owning editing state. */
 export class PromptInput {
@@ -26,7 +28,7 @@ export class PromptInput {
         const contentWidth = Math.max(1, innerWidth - paddingX * 2);
         return { prefixWidth, innerWidth, paddingX, contentWidth, layoutWidth: Math.max(1, contentWidth - (paddingX ? 0 : 1)) };
     }
-    render(width, renderBody, ruled = true, padding = 0, promptGlyph = PROMPT_GLYPH) {
+    render(width, renderBody, ruled = true, padding = 0, promptGlyph = PROMPT_GLYPH, promptRole = "muted") {
         if (width <= 0)
             return [];
         const { prefixWidth, innerWidth } = this.geometry(width, padding, promptGlyph);
@@ -40,7 +42,7 @@ export class PromptInput {
             return clipped + " ".repeat(Math.max(0, width - this.metrics.measure(clipped)));
         };
         const rows = body.rows.map((row, index) => fit(`${index === 0
-            ? promptArrow(promptGlyph, this.theme)
+            ? promptArrow(promptGlyph, this.theme, promptRole)
             : " ".repeat(prefixWidth)}${row}`));
         const rule = (fragment) => fragment === undefined
             ? promptRule(width, this.theme)

package/dist/ui/components/spans.js

@@ -1,4 +1,4 @@
-import { displayWidth } from "./text.js";
+import { displayWidth, graphemeWidth } from "./text.js";
 /**
  * Ported from the A1 UI reference implementation (`core/presentation/spans.ts`).
  * Writing over part of a rendered row is not string slicing: the row carries
@@ -53,7 +53,7 @@ export function overlaySpan(line, from, to, span, options = {}) {
             continue;
         }
         for (const { segment } of GRAPHEMES.segment(token)) {
-            const width = displayWidth(segment);
+            const width = graphemeWidth(segment);
             if (column + width <= from)
                 head += segment;
             else if (column >= to)

package/dist/ui/components/surface.js

@@ -29,10 +29,12 @@ export function withScrollbarRail(lines, geometry, contentWidth, theme, options
  */
 export function renderEmptyState(message, mark, height, width, theme) {
     const middle = Math.floor(height / 2);
+    const messageRow = Math.min(Math.max(0, height - 1), middle + 1);
+    const markRow = messageRow - 1;
     return Array.from({ length: Math.max(0, height) }, (_line, index) => {
-        if (index === middle - 1)
+        if (index === markRow)
             return centre(theme.fg("muted", mark), mark, width);
-        return index === middle ? centre(theme.fg("muted", message), message, width) : "";
+        return index === messageRow ? centre(theme.fg("muted", message), message, width) : "";
     });
 }
 function centre(painted, raw, width) {

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

@@ -1,11 +1,8 @@
-/**
- * Display-width text handling. Terminals lay out by column, not by code unit,
- * so measuring with `String.length` mis-sizes CJK, emoji, and combining marks,
- * and counting styling escapes as visible width breaks every layout that uses
- * colour.
- */
+/** Terminal-column geometry: preserve graphemes, Unicode cell widths and ANSI styling. */
 /** Removes styling sequences so only visible characters remain. */
 export declare function stripAnsi(text: string): string;
+/** Width of one grapheme cluster: two for emoji, else the widest code point it contains. */
+export declare function graphemeWidth(grapheme: string): number;
 export interface DisplayColumnRange {
     readonly from: number;
     readonly to: number;

package/dist/ui/components/text.js

@@ -1,9 +1,4 @@
-/**
- * Display-width text handling. Terminals lay out by column, not by code unit,
- * so measuring with `String.length` mis-sizes CJK, emoji, and combining marks,
- * and counting styling escapes as visible width breaks every layout that uses
- * colour.
- */
+/** Terminal-column geometry: preserve graphemes, Unicode cell widths and ANSI styling. */
 const ANSI_PATTERN = /\[[0-9;:?]*[ -/]*[@-~]|[\]_][^]*(?:|\\)|[@-Z\\-_]/g;
 const SEGMENTER = new Intl.Segmenter(undefined, { granularity: "grapheme" });
 const WORD_SEGMENTER = new Intl.Segmenter(undefined, { granularity: "word" });
@@ -76,7 +71,7 @@ function couldBeEmoji(grapheme) {
         grapheme.length > 1);
 }
 /** Width of one grapheme cluster: two for emoji, else the widest code point it contains. */
-function graphemeWidth(grapheme) {
+export function graphemeWidth(grapheme) {
     if (couldBeEmoji(grapheme) && RGI_EMOJI_PATTERN.test(grapheme))
         return 2;
     let width = 0;
@@ -126,8 +121,11 @@ export function displayColumnSlice(text, requestedFrom, requestedTo) {
 }
 /** Columns this text occupies once styling is removed. */
 export function displayWidth(text) {
+    const plain = stripAnsi(text);
+    if (!/[^\x20-\x7e]/u.test(plain))
+        return plain.length;
     let width = 0;
-    for (const { segment } of SEGMENTER.segment(stripAnsi(text)))
+    for (const { segment } of SEGMENTER.segment(plain))
         width += graphemeWidth(segment);
     return width;
 }

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

@@ -1,4 +1,4 @@
-export declare const OWNED_UI_SETTINGS_VERSION = 18;
+export declare const OWNED_UI_SETTINGS_VERSION = 19;
 export type OwnedUiSettingValue = string | number | boolean;
 export type OwnedUiSettingApplication = "live" | "restart";
 export interface OwnedUiSettingDeclaration {
@@ -12,19 +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;
+    }[];
 }
 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";
@@ -47,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";
@@ -117,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";
@@ -175,19 +196,44 @@ export declare const OWNED_SETTING_DECLARATIONS: Readonly<{
         label: "Position";
         section: Readonly<{
             id: "tabs";
-            title: "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";

package/dist/ui/settings/declarations.js

@@ -1,6 +1,6 @@
-export const OWNED_UI_SETTINGS_VERSION = 18;
+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]*)*$/;
@@ -8,16 +8,26 @@ 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" });
+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",
@@ -36,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({
@@ -90,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",
@@ -140,6 +159,16 @@ export const OWNED_SETTING_DECLARATIONS = Object.freeze({
         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",

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);