@timurproko/a1 0.2.6 → 0.2.7-dev.1222

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

@@ -1,11 +1,9 @@
-export declare const OWNED_UI_SETTINGS_VERSION = 13;
+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,40 @@ 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";
+        label: "Time format";
+        section: Readonly<{
+            id: "generic";
+            title: "Generic";
+        }>;
+        description: "Format used by submitted-prompt timestamps and the resident tab clock.";
+        application: "live";
+        defaultValue: "8:00 PM";
+        allowedValues: readonly ["20:00", "8:00 PM"];
     }>;
     readonly accentColor: Readonly<{
         id: "accentColor";
@@ -41,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";
@@ -111,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";
@@ -164,11 +191,58 @@ 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: "Tab Bar";
+        }>;
+        description: "Automatically name a new tab from its first completed turn with the tab's current model.";
+        application: "live";
+        defaultValue: true;
+        allowedValues: readonly [true, false];
+    }>;
 }>;
 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,27 +1,44 @@
-export const OWNED_UI_SETTINGS_VERSION = 13;
+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" });
-/**
- * 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",
+        label: "Time format",
+        section: GENERIC_SECTION,
+        description: "Format used by submitted-prompt timestamps and the resident tab clock.",
+        application: "live",
+        defaultValue: "8:00 PM",
+        allowedValues: Object.freeze([
+            "20:00", "8:00 PM",
+        ]),
     }),
     accentColor: Object.freeze({
         id: "accentColor",
@@ -29,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({
@@ -83,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",
@@ -124,8 +150,35 @@ 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",
+        section: TABS_SECTION,
+        description: "Automatically name a new tab from its first completed turn with the tab's current model.",
+        application: "live",
+        defaultValue: true,
+        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/index.d.ts

@@ -1,10 +1,12 @@
 export { OWNED_SETTING_DECLARATIONS, OWNED_UI_SETTINGS_VERSION, OWNED_UI_SETTING_DECLARATIONS, assertOwnedUiSettingDeclarations, findOwnedUiSettingDeclaration, isOwnedSettingId, } from "./declarations.js";
 export type { OwnedSettingId, OwnedSettingValueOf, OwnedUiSettingApplication, OwnedUiSettingDeclaration, OwnedUiSettingValue } from "./declarations.js";
-export { OWNED_UI_SETTINGS_MIGRATIONS, assertOwnedUiSettingsMigrations, migrationsFrom } from "./migrations.js";
-export type { OwnedUiSettingsMigration } from "./migrations.js";
+export { OWNED_UI_SETTINGS_MIGRATIONS, assertOwnedUiSettingsMigrations, migrationsFrom, normalizeOwnedUiSettingsValues, } from "./migrations.js";
+export type { OwnedUiSettingsCompatibilityResult, OwnedUiSettingsMigration } from "./migrations.js";
 export { documentFrom, parseOwnedUiSettingsDocument, resolveOwnedUiSettings, settingValue } from "./resolution.js";
 export type { OwnedUiResolvedSetting, OwnedUiSettingSource, OwnedUiSettingsDocument, OwnedUiSettingsNotice, OwnedUiSettingsNoticeCode, OwnedUiSettingsResolution, ResolveOwnedUiSettingsInput, } from "./resolution.js";
 export { AGENT_SECTION_ID, buildOwnedUiSettingsSections, findOwnedUiSettingsEntry } from "./sections.js";
 export type { AgentSettingsSnapshot, BuildOwnedUiSettingsSectionsInput, OwnedUiSettingsBackend, OwnedUiSettingsEntry, OwnedUiSettingsSection, } from "./sections.js";
 export { OwnedSettingsManager } from "./manager.js";
 export type { OwnedSettingsManagerOptions, OwnedUiSettingsChangeOutcome, OwnedUiSettingsListener } from "./manager.js";
+export { assertProfileSettingsNamespaceAvailable, readProfileSettingsNamespace, repairProfileSettingsDocument, updateProfileSettingsNamespace, } from "./profile-document.js";
+export type { ProfileSettingsNamespaceRead, ProfileSettingsNamespaceUpdate } from "./profile-document.js";

package/dist/ui/settings/index.js

@@ -1,5 +1,6 @@
 export { OWNED_SETTING_DECLARATIONS, OWNED_UI_SETTINGS_VERSION, OWNED_UI_SETTING_DECLARATIONS, assertOwnedUiSettingDeclarations, findOwnedUiSettingDeclaration, isOwnedSettingId, } from "./declarations.js";
-export { OWNED_UI_SETTINGS_MIGRATIONS, assertOwnedUiSettingsMigrations, migrationsFrom } from "./migrations.js";
+export { OWNED_UI_SETTINGS_MIGRATIONS, assertOwnedUiSettingsMigrations, migrationsFrom, normalizeOwnedUiSettingsValues, } from "./migrations.js";
 export { documentFrom, parseOwnedUiSettingsDocument, resolveOwnedUiSettings, settingValue } from "./resolution.js";
 export { AGENT_SECTION_ID, buildOwnedUiSettingsSections, findOwnedUiSettingsEntry } from "./sections.js";
 export { OwnedSettingsManager } from "./manager.js";
+export { assertProfileSettingsNamespaceAvailable, readProfileSettingsNamespace, repairProfileSettingsDocument, updateProfileSettingsNamespace, } from "./profile-document.js";

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

@@ -4,13 +4,20 @@ import { type OwnedUiSettingsMigration } from "./migrations.js";
 import { type OwnedUiSettingsResolution } from "./resolution.js";
 import { type OwnedUiSettingsBackend, type OwnedUiSettingsSection } from "./sections.js";
 export interface OwnedSettingsManagerOptions {
-    /** A1 configuration root. Settings live under `<configDir>/settings/`. */
-    readonly configDir: string;
+    /** Selected global agent profile containing the shared `settings.json`. */
+    readonly profileDir?: string;
+    /** Compatibility alias for SDK/tests that supplied the former root option. */
+    readonly configDir?: string;
     readonly profileId: string;
+    /** Product namespace; defaults to profileId for generic and hermetic consumers. */
+    readonly namespace?: string;
+    /** Former product configuration root, consulted only while the namespace is absent. */
+    readonly legacyConfigDir?: string;
     readonly declarations?: readonly OwnedUiSettingDeclaration[];
     readonly migrations?: readonly OwnedUiSettingsMigration[];
     readonly agent?: AgentSettingsPort | null;
     readonly agentProvider?: () => AgentSettingsPort | null;
+    readonly hiddenOwnedSettingIds?: readonly string[];
     readonly hiddenAgentSettingIds?: readonly string[];
     readonly agentSettingLabelOverrides?: Readonly<Record<string, string>>;
 }
@@ -37,9 +44,15 @@ export declare class OwnedSettingsManager {
     constructor(options: OwnedSettingsManagerOptions);
     get file(): string;
     get resolution(): OwnedUiSettingsResolution;
-    /** Reads and resolves the stored document. Never throws: every failure becomes a notice. */
+    /** Reads and resolves the product namespace. Never throws: every failure becomes a notice. */
     read(): OwnedUiSettingsResolution;
     load(): Promise<void>;
+    /**
+     * Adopts values another process stored in the shared document. Notifies only when a
+     * resolved value differs, so a peer's own write echo stays silent. Restart-bound values
+     * keep their session-start effect and surface as pending instead.
+     */
+    refresh(): boolean;
     sections(): readonly OwnedUiSettingsSection[];
     /**
      * The value in effect for a declared setting, typed by its declaration. A restart-bound