@timurproko/a1 0.2.7-dev.1252 → 0.2.7-dev.1264

package/dist/app/session-shell/workflow-output.d.ts

@@ -1,15 +1,16 @@
+import type { OwnedUiShellComponents, OwnedUiShellHotkeysPresentation } from "../../contracts/owned-ui/index.js";
 import type { ImageAttachmentError, OwnedUiWorkflowMessage, OwnedUiWorkflowResult } from "../../contracts/owned-ui/index.js";
-import { type PiShellHotkeysPresentation } from "../../integrations/pi/components/shell-presenters-info.js";
 import type { DockChrome } from "./dock-chrome.js";
 import type { TranscriptDocument } from "./transcript-document.js";
-export interface WorkflowOutputPorts {
+interface WorkflowOutputPorts {
     readonly customViewport: boolean;
+    readonly components: Pick<OwnedUiShellComponents, "info" | "text">;
     readonly document: Pick<TranscriptDocument, "lastId" | "anchorOf" | "invalidate" | "appendAnchored" | "removeAnchored">;
     readonly dock: Pick<DockChrome, "setNotice" | "dismissNotice">;
     /** How many semantic transcript blocks precede new output; workflow output anchors after them. */
     transcriptLength(): number;
     outputPad(): 0 | 1;
-    hotkeysPresentation(): PiShellHotkeysPresentation;
+    hotkeysPresentation(): OwnedUiShellHotkeysPresentation;
     readonly componentRuntime: {
         getColumns(): number;
         getRows(): number;
@@ -31,3 +32,4 @@ export declare class WorkflowOutput {
     /** Drops every anchored output and the status-replacement chain. */
     reset(): void;
 }
+export {};

package/dist/app/session-shell/workflow-output.js

@@ -1,6 +1,3 @@
-import { createPiShellArmin, createPiShellEarendilAnnouncement, } from "../../integrations/pi/components/shell-selectors-dialogs.js";
-import { createPiShellChangelog, createPiShellHotkeys, createPiShellSessionInfo, renderPiShellCommandMessage, renderPiShellStatusText, } from "../../integrations/pi/components/shell-presenters-info.js";
-import { piShellHyperlink } from "../../integrations/pi/components/shell-shared-facade.js";
 /**
  * Presents workflow results: bare A1 answers in the dock notice, the pinned profile appends
  * transcript-anchored output, and consecutive status lines at the same anchor replace each other.
@@ -33,7 +30,7 @@ export class WorkflowOutput {
         }
         const id = this.#appendAnchored(width => [
             "",
-            ...renderPiShellStatusText(this.#statusMessages.get(id) ?? message, width),
+            ...this.#ports.components.info.statusText(this.#statusMessages.get(id) ?? message, width),
         ]);
         this.#statusMessages.set(id, message);
         this.#lastStatusId = id;
@@ -53,7 +50,7 @@ export class WorkflowOutput {
         }
         this.#lastStatusId = undefined;
         const presentation = { kind: message.kind, message: message.message };
-        this.#appendAnchored(width => renderPiShellCommandMessage(presentation, width, this.#ports.outputPad()));
+        this.#appendAnchored(width => this.#ports.components.info.commandMessage(presentation, width, this.#ports.outputPad()));
     }
     appendResult(result, errorCode) {
         if (result.messages !== undefined) {
@@ -86,16 +83,17 @@ export class WorkflowOutput {
         if (result.outcome === "completed" && (result.command === "new" || result.command === "name" || result.command === "debug")) {
             this.#lastStatusId = undefined;
             const presentation = { kind: result.command, message: result.message, ...(result.detail === undefined ? {} : { detail: result.detail }) };
-            this.#appendAnchored(width => renderPiShellCommandMessage(presentation, width, this.#ports.outputPad()));
+            this.#appendAnchored(width => this.#ports.components.info.commandMessage(presentation, width, this.#ports.outputPad()));
             return;
         }
         if (result.outcome === "completed" && this.#appendAnnouncement(result.command))
             return;
         // Rationale: the pinned engine links both share URLs; the workflow result carries the plain URLs.
+        const link = (url) => this.#ports.components.text.hyperlink(url);
         const message = result.command !== "share" ? result.message
-            : result.detail ? `${linkShareUrl(result.message)}\nGist: ${piShellHyperlink(result.detail)}`
+            : result.detail ? `${linkShareUrl(result.message, link)}\nGist: ${link(result.detail)}`
                 // Protocol: Radius shares carry only the artifact URL.
-                : linkShareUrl(result.message);
+                : linkShareUrl(result.message, link);
         this.appendStatus(message);
     }
     /** Drops every anchored output and the status-replacement chain. */
@@ -108,20 +106,20 @@ export class WorkflowOutput {
     #appendPresentation(result) {
         if (result.command === "session" && result.presentation?.kind === "session-info") {
             this.#lastStatusId = undefined;
-            const sessionInfo = createPiShellSessionInfo(result.presentation);
+            const sessionInfo = this.#ports.components.info.sessionInfo(result.presentation);
             this.#appendAnchored(width => sessionInfo.render(width), () => sessionInfo.dispose?.());
             return true;
         }
         if (result.command === "hotkeys") {
             this.#lastStatusId = undefined;
             const presentation = this.#ports.hotkeysPresentation();
-            const hotkeys = createPiShellHotkeys(presentation.bindings, presentation.getShortcuts, presentation.profile);
+            const hotkeys = this.#ports.components.info.hotkeys(presentation.bindings, presentation.getShortcuts, presentation.profile);
             this.#appendAnchored(width => hotkeys.render(width), () => hotkeys.dispose?.());
             return true;
         }
         if (result.command === "changelog") {
             this.#lastStatusId = undefined;
-            const changelog = createPiShellChangelog(result.detail ?? "No changelog entries found.");
+            const changelog = this.#ports.components.info.changelog(result.detail ?? "No changelog entries found.");
             this.#appendAnchored(width => changelog.render(width), () => changelog.dispose?.());
             return true;
         }
@@ -131,13 +129,13 @@ export class WorkflowOutput {
     #appendAnnouncement(command) {
         if (command === "arminsayshi") {
             this.#lastStatusId = undefined;
-            const armin = createPiShellArmin(this.#ports.componentRuntime);
+            const armin = this.#ports.components.info.armin(this.#ports.componentRuntime);
             this.#appendAnchored(width => ["", ...armin.render(width)], () => armin.dispose?.());
             return true;
         }
         if (command === "dementedelves") {
             this.#lastStatusId = undefined;
-            const announcement = createPiShellEarendilAnnouncement();
+            const announcement = this.#ports.components.info.earendilAnnouncement();
             this.#appendAnchored(width => ["", ...announcement.render(width)], () => announcement.dispose?.());
             return true;
         }
@@ -168,7 +166,7 @@ export class WorkflowOutput {
     }
 }
 /** "Share URL: <url>" with the URL made clickable; other share wordings pass through unchanged. */
-function linkShareUrl(message) {
+function linkShareUrl(message, link) {
     const match = /^Share URL: (\S+)$/.exec(message);
-    return match === null ? message : `Share URL: ${piShellHyperlink(match[1])}`;
+    return match === null ? message : `Share URL: ${link(match[1])}`;
 }

package/dist/cli/package-messages.d.ts

@@ -19,7 +19,6 @@ export type PackageSyntaxDiagnostic = {
     readonly message: string;
 };
 type MessageStyle = Pick<typeof chalk, "red" | "dim" | "bold">;
-export declare function packageCommandUsage(verb: PackageCliVerb, namespace?: PackageCommandNamespace): string;
 /** Diagnostic facts stay unstyled until the terminal boundary decides color support. */
 export declare function renderPackageSyntax(diagnostic: PackageSyntaxDiagnostic, namespace?: PackageCommandNamespace, style?: MessageStyle): string;
 /** Pi's help layout, with unsupported options and examples deliberately absent. */

package/dist/cli/package-messages.js

@@ -2,7 +2,7 @@
 // at 914cf1472e715297caa30db4b9535d534a9eb718 (MIT); grammar is restricted to A1's supported subset.
 import chalk from "chalk";
 import { PRODUCT_TEXT } from "../product-identity.js";
-export function packageCommandUsage(verb, namespace = "pi") {
+function packageCommandUsage(verb, namespace = "pi") {
     const command = namespace === "direct"
         ? `${PRODUCT_TEXT.commandName} ${verb}`
         : `${PRODUCT_TEXT.commandName} pi ${verb}`;

package/dist/cli/session-context.d.ts

@@ -1,6 +1,6 @@
 import { type SessionContextRequest } from "../features/launch/index.js";
 export type { SessionContextRequest } from "../features/launch/index.js";
-export interface SessionContextCommandOptions {
+interface SessionContextCommandOptions {
     readonly environment?: NodeJS.ProcessEnv;
     readonly inspectProcess?: (pid: number) => Promise<{
         readonly pid: number;

package/dist/cli/uninstall.d.ts

@@ -1,10 +1,10 @@
-export interface UninstallRequest {
+interface UninstallRequest {
     /** Skips the program-removal question; user data is still kept unless `purge` is set. */
     readonly yes: boolean;
     /** Also removes sessions, settings, sign-ins, and prompt history. */
     readonly purge: boolean;
 }
-export interface UninstallOutput {
+interface UninstallOutput {
     readonly stdout: (message: string) => void;
     readonly stderr: (message: string) => void;
 }
@@ -24,3 +24,4 @@ export interface UninstallDependencies {
  * Sessions and settings live in the profile home and leave only with explicit consent.
  */
 export declare function runUninstall(request: UninstallRequest, dependencies: UninstallDependencies): Promise<number>;
+export {};

package/dist/composition/owned-settings.d.ts

@@ -1,6 +1,6 @@
 import type { AgentSettingsPort } from "../contracts/agent-engine/index.js";
 import { OwnedSettingsManager } from "../ui/settings/manager.js";
-export interface OwnedSettingsManagerFactoryOptions {
+interface OwnedSettingsManagerFactoryOptions {
     readonly profileId: string;
     readonly agent?: AgentSettingsPort | null;
     readonly agentProvider?: () => AgentSettingsPort | null;
@@ -9,3 +9,4 @@ export interface OwnedSettingsManagerFactoryOptions {
 export declare function createOwnedSettingsManager(options: OwnedSettingsManagerFactoryOptions): OwnedSettingsManager;
 /** Rereads the shared settings document whenever its stat changes; returns the stop. */
 export declare function watchSharedSettings(settings: Pick<OwnedSettingsManager, "file" | "refresh">): () => void;
+export {};

package/dist/composition/owned-settings.js

@@ -1,17 +1,14 @@
 import { statSync } from "node:fs";
 import { resolveLaunchProfilePaths } from "../features/launch/profile-paths.js";
-import { resolveProductPaths } from "../foundation/lifecycle/paths.js";
 import { PRODUCT_IDENTITY } from "../product-identity.js";
 import { OwnedSettingsManager } from "../ui/settings/manager.js";
 /** Builds the profile-global settings manager shared by the Agent and slim utility compositions. */
 export function createOwnedSettingsManager(options) {
     const profilePaths = resolveLaunchProfilePaths();
-    const productPaths = resolveProductPaths();
     return new OwnedSettingsManager({
         profileDir: profilePaths.agentProfile,
         profileId: options.profileId,
         namespace: PRODUCT_IDENTITY.commandName,
-        legacyConfigDir: productPaths.configDir,
         ...(options.agent === undefined ? {} : { agent: options.agent }),
         ...(options.agentProvider === undefined ? {} : { agentProvider: options.agentProvider }),
         hiddenAgentSettingIds: ["fullscreenWheelScrollLines"],

package/dist/composition/owned-ui.d.ts

@@ -21,7 +21,7 @@ export interface OwnedUiCompositionOptions {
     /** A1 settings profile; comparison paths omit it. */
     readonly profileId?: string;
     /** `off` withholds A1-specific surfaces from comparison profiles. */
-    readonly ownedSurfaces?: "on" | "off";
+    readonly productMode?: "bare" | "comparison";
     readonly projectTrustPrompt?: PiProjectTrustPreflightPrompt;
     /** Explicit local diagnostic destination; ignored by comparison/settings-free compositions. */
     readonly suggestionDiagnosticsPath?: string;

package/dist/composition/owned-ui.js

@@ -25,9 +25,9 @@ export async function composeOwnedUiApplication(options = {}) {
 }
 export async function composeOwnedUi(options = {}) {
     const cwd = options.cwd ?? process.cwd();
-    const ownedSurfaces = options.ownedSurfaces !== "off";
+    const productMode = options.productMode ?? "bare", bare = productMode === "bare";
     const sessionRuntimes = new SessionRuntimeRegistry({
-        runtimeId: ownedSurfaces ? process.env[PRODUCT_IDENTITY.environment.sessionRuntimeId] : undefined,
+        runtimeId: bare ? process.env[PRODUCT_IDENTITY.environment.sessionRuntimeId] : undefined,
         inspectProcess: options.inspectProcess,
     });
     const productPaths = resolveProductPaths();
@@ -39,17 +39,19 @@ export async function composeOwnedUi(options = {}) {
             profileId: options.profileId,
             agentProvider: () => backend.settingsPort(),
         });
+    // Invariant: bare A1 owns the settings-driven ports; the comparison profile receives none of them.
+    const bareSettings = bare ? settings : null;
     const projectTrustPrompt = options.projectTrustPrompt;
     // Invariant: process-wide engine state has one owner. The host installs the HTTP dispatcher, applies
     // the theme singletons, and announces startup notices once; every session is created through it.
     const host = await (options.createEngineHost ?? (async (hostOptions) => createPiEngineHost(hostOptions)))({
-        productMode: ownedSurfaces ? "bare" : "comparison",
+        productMode,
         availableThemes: () => getAvailablePiThemes().map(theme => theme.name),
-        announceStartupChangelog: !ownedSurfaces,
+        announceStartupChangelog: !bare,
         theme: {
-            base: ownedSurfaces ? "dark" : "engine-configured",
-            accentColor: settings !== null && ownedSurfaces ? settings.value("accentColor") : "purple",
-            packageBorderProjection: ownedSurfaces,
+            base: bare ? "dark" : "engine-configured",
+            accentColor: bareSettings?.value("accentColor") ?? "purple",
+            packageBorderProjection: bare,
             apply: { base: applyConfiguredPiTheme, accentColor: setPiAccentColor, packageBorderProjection: setPiPackageBorderProjectionEnabled },
         },
         ...(projectTrustPrompt === undefined ? {} : { projectTrustPrompt }),
@@ -58,7 +60,7 @@ export async function composeOwnedUi(options = {}) {
     try {
         backend = await host.create({
             cwd,
-            ...(ownedSurfaces ? { repositoryContextReader: sessionRuntimes.readerFor(undefined) } : {}),
+            ...(bare ? { repositoryContextReader: sessionRuntimes.readerFor(undefined) } : {}),
             ...(options.sessionPath === undefined ? {} : { sessionPath: options.sessionPath }),
             ...(options.sessionSelection === undefined ? {} : { sessionSelection: options.sessionSelection }),
             ...(sessionForkPrompt === undefined ? {} : { sessionForkPrompt }),
@@ -69,27 +71,26 @@ export async function composeOwnedUi(options = {}) {
         throw error;
     }
     const releaseNote = await StartupReleaseNote.load({
-        ownedSurfaces,
+        productMode,
         configDir: productPaths.configDir,
         ...(options.releaseNotes === undefined ? {} : { releaseNotes: options.releaseNotes }),
         ...(options.packageVersion === undefined ? {} : { packageVersion: options.packageVersion }),
         ...(options.profileId === undefined ? {} : { profileId: options.profileId }),
     });
-    const unsubscribeAccentChange = settings === null || !ownedSurfaces
+    const unsubscribeAccentChange = bareSettings === null
         ? () => { }
-        : settings.onChange(current => {
+        : bareSettings.onChange(current => {
             const accent = current.value("accentColor");
             host.setAccentColor(accent);
         });
     // Rationale: separate A1 processes share one settings document; a live scope change saved in
     // one reaches the others only by rereading that document.
-    const unwatchSharedSettings = settings === null || !ownedSurfaces
+    const unwatchSharedSettings = bareSettings === null
         ? () => { }
-        : watchSharedSettings(settings);
+        : watchSharedSettings(bareSettings);
     const unsubscribeAccent = () => { unwatchSharedSettings(); unsubscribeAccentChange(); };
     // Invariant: the Settings search and agent prompt borrow the same resolved Pi keybindings.
-    const keybindingsHost = createPiKeybindingsHost({ profile: ownedSurfaces ? "a1" : "pi", agentDir: backend.identity.agentDir });
-    const keybindings = keybindingsHost;
+    const keybindingsHost = createPiKeybindingsHost({ profile: bare ? "a1" : "pi", agentDir: backend.identity.agentDir });
     // Rationale: Routes open only after shell construction.
     const references = {
         changelog: async (input) => {
@@ -105,41 +106,29 @@ export async function composeOwnedUi(options = {}) {
         },
         session: () => import("./session-info-reference.js").then(m => m.loadSessionInfoReference(backend)),
     };
-    const routeHost = settings === null || !ownedSurfaces ? null
-        : createOwnedRouteHost(settings, references, settingsRouteOptions(keybindings, backend.identity.agentDir, cwd));
-    const viewportSettings = settings === null || !ownedSurfaces ? null : {
-        snapshot: () => viewportSettingsSnapshot(settings),
-        onChange: listener => settings.onChange(() => listener(viewportSettingsSnapshot(settings))),
-    };
-    const backgroundSettings = settings === null || !ownedSurfaces ? null : {
-        snapshot: () => settings.value("backgroundStyle"),
-        // Rationale: one manager notification also recomputes an accent-derived canvas after accentColor changes.
-        onChange: listener => settings.onChange(current => listener(current.value("backgroundStyle"))),
-    };
+    const routeHost = bareSettings === null ? null
+        : createOwnedRouteHost(bareSettings, references, settingsRouteOptions(keybindingsHost, backend.identity.agentDir, cwd));
     const diagnosticDestination = options.suggestionDiagnosticsPath ?? process.env[PRODUCT_IDENTITY.environment.suggestionDiagnostics];
-    const suggestionDiagnostics = settings !== null && ownedSurfaces && diagnosticDestination?.trim()
+    const suggestionDiagnostics = bareSettings !== null && diagnosticDestination?.trim()
         ? await import("../features/prompt-suggestions/diagnostics.js").then(module => new module.SuggestionDiagnosticCapture({ enabled: true, destination: diagnosticDestination })) : null;
-    const promptSuggestions = settings === null || !ownedSurfaces ? null : {
-        ...(suggestionDiagnostics === null ? {} : { diagnostics: suggestionDiagnostics }),
-        generator: backend,
-        enabled: () => settings.value("promptSuggestions"),
-        onChange: (listener) => settings.onChange(() => listener(settings.value("promptSuggestions"))),
-    };
-    const promptImages = settings === null || !ownedSurfaces ? null : {
-        limit: () => settings.value("promptImageLimit"),
-        onChange: (listener) => settings.onChange(listener),
-    };
-    const skills = settings === null || !ownedSurfaces ? null : {
-        presentation: () => settings.value("skillsPresentation"),
-        // Rationale: one listener covers both the A1 presentation choice and the engine skill-command toggle.
-        onChange: (listener) => settings.onChange(() => listener()),
-    };
-    const promptHistory = createPromptHistoryConfiguration(settings, backend, ownedSurfaces);
+    const barePorts = bareSettings === null ? null : bareShellPorts(bareSettings, backend, suggestionDiagnostics);
+    const promptHistory = createPromptHistoryConfiguration(settings, backend, bare);
     const clipboardDestination = options.clipboardDiagnosticsPath ?? process.env[PRODUCT_IDENTITY.environment.clipboardDiagnostics];
-    const clipboardDiagnostics = settings !== null && ownedSurfaces && clipboardDestination?.trim()
+    const clipboardDiagnostics = bareSettings !== null && clipboardDestination?.trim()
         ? new ClipboardDiagnosticCapture(clipboardDestination) : null;
     // Invariant: process-wide services are created once here and borrowed by every session shell.
-    const clipboardServices = ownedSurfaces ? createOwnedUiClipboardServices() : null;
+    const clipboardServices = bare ? createOwnedUiClipboardServices() : null;
+    // Invariant: one release order for a failed construction and for dispose. The shared spares outlive every
+    // shell and stop only after the last one is disposed; the host outlives the application and is released last.
+    const releaseShared = async () => {
+        clipboardServices?.dispose();
+        unsubscribeAccent();
+        await sessionRuntimes.dispose();
+        await releaseNote.releaseClaim();
+        suggestionDiagnostics?.dispose();
+        clipboardDiagnostics?.dispose();
+        await host.dispose();
+    };
     let createdTerminalHost;
     let terminalHost;
     let presenter;
@@ -151,25 +140,19 @@ export async function composeOwnedUi(options = {}) {
                 cwd: backend.identity.cwd,
                 ...(routeHost === null ? {} : { routeHost }),
                 ...(releaseNote.startupRoute === undefined ? {} : { startupRoute: releaseNote.startupRoute }),
-                ...(ownedSurfaces ? { sessionLayout: "custom-viewport" } : {}),
+                ...(bare ? { sessionLayout: "custom-viewport" } : {}),
             },
             presentation: {
                 ...(options.terminal === undefined ? {} : { terminal: createPiTerminalBridge(options.terminal) }),
                 ...(clipboardDiagnostics === null ? {} : { input: { onEvent: event => clipboardDiagnostics.runtime(event) } }),
-                ...(viewportSettings === null ? {} : { viewportSettings }),
-                ...(backgroundSettings === null ? {} : { backgroundSettings }),
-                ...(settings === null || !ownedSurfaces ? {} : {
-                    quitOutro: { snapshot: () => quitOutroSettingsSnapshot(settings), interactive: process.stdout.isTTY === true },
-                }),
+                ...barePorts?.presentation,
             },
             ...(clipboardDiagnostics === null ? {} : { diagnostics: {
                     responseCopy: { onEvent: event => clipboardDiagnostics.copy(event) },
                     paste: event => clipboardDiagnostics.paste(event),
                 } }),
-            ...(promptSuggestions === null ? {} : { suggestions: promptSuggestions }),
-            ...(promptImages === null ? {} : { promptImages }),
-            ...(skills === null ? {} : { skills }),
-            shared: { keybindings, ...(clipboardServices === null ? {} : { clipboard: clipboardServices }) },
+            ...(barePorts === null ? {} : { suggestions: barePorts.suggestions, promptImages: barePorts.promptImages, skills: barePorts.skills }),
+            shared: { keybindings: keybindingsHost, ...(clipboardServices === null ? {} : { clipboard: clipboardServices }) },
             ...(promptHistory === null ? {} : { history: {
                     ...promptHistory,
                     editor: await import("../integrations/pi/components/history-editor-loader.js").then(module => module.loadHistoryEditor()),
@@ -183,12 +166,7 @@ export async function composeOwnedUi(options = {}) {
     }
     catch (error) {
         await createdTerminalHost?.dispose().catch(() => undefined);
-        unsubscribeAccent();
-        await releaseNote.releaseClaim();
-        clipboardDiagnostics?.dispose();
-        suggestionDiagnostics?.dispose();
-        clipboardServices?.dispose();
-        await host.dispose();
+        await releaseShared();
         throw error;
     }
     // Rationale: pinned Pi's version check is unreachable because the owned shell never runs its
@@ -197,7 +175,7 @@ export async function composeOwnedUi(options = {}) {
     const releaseUpdates = deferStartupReleaseUpdateObservation({
         backend,
         configDir: productPaths.configDir,
-        mode: settings === null || !ownedSurfaces ? "auto" : settings.value("updateCheck"),
+        mode: bareSettings === null ? "auto" : bareSettings.value("updateCheck"),
         packageVersion: releaseNote.packageVersion, readPackageVersion,
         checkForNewerRelease: options.checkForNewerRelease,
     });
@@ -226,24 +204,50 @@ export async function composeOwnedUi(options = {}) {
                 await releaseNote.settleAcknowledgement();
             }
             finally {
-                // Invariant: the shared spares outlive every shell and stop only after the last one is disposed.
-                clipboardServices?.dispose();
-                unsubscribeAccent();
-                await sessionRuntimes.dispose();
-                await releaseNote.releaseClaim();
-                suggestionDiagnostics?.dispose();
-                clipboardDiagnostics?.dispose();
-                // Invariant: the host outlives the application; disposing it cancels host-level probes last.
-                await host.dispose();
+                await releaseShared();
             }
         },
     };
     return { application, settings };
 }
-function createPromptHistoryConfiguration(settings, backend, ownedSurfaces) {
+/** The settings-driven ports only bare A1 receives: viewport, background, quit outro, suggestions, image limit, and skills. */
+function bareShellPorts(settings, generator, diagnostics) {
+    const viewportSettings = {
+        snapshot: () => viewportSettingsSnapshot(settings),
+        onChange: listener => settings.onChange(() => listener(viewportSettingsSnapshot(settings))),
+    };
+    const backgroundSettings = {
+        snapshot: () => settings.value("backgroundStyle"),
+        // Rationale: one manager notification also recomputes an accent-derived canvas after accentColor changes.
+        onChange: listener => settings.onChange(current => listener(current.value("backgroundStyle"))),
+    };
+    return {
+        presentation: {
+            viewportSettings,
+            backgroundSettings,
+            quitOutro: { snapshot: () => quitOutroSettingsSnapshot(settings), interactive: process.stdout.isTTY === true },
+        },
+        suggestions: {
+            ...(diagnostics === null || diagnostics === undefined ? {} : { diagnostics }),
+            generator,
+            enabled: () => settings.value("promptSuggestions"),
+            onChange: (listener) => settings.onChange(() => listener(settings.value("promptSuggestions"))),
+        },
+        promptImages: {
+            limit: () => settings.value("promptImageLimit"),
+            onChange: (listener) => settings.onChange(listener),
+        },
+        skills: {
+            presentation: () => settings.value("skillsPresentation"),
+            // Rationale: one listener covers both the A1 presentation choice and the engine skill-command toggle.
+            onChange: (listener) => settings.onChange(() => listener()),
+        },
+    };
+}
+function createPromptHistoryConfiguration(settings, backend, bare) {
     const limit = settings?.value("promptHistoryMaxItems") ?? 100;
     const scope = settings?.value("promptHistoryScope") ?? "unique";
-    const enabled = settings !== null && ownedSurfaces && settings.value("promptHistoryEnabled");
+    const enabled = settings !== null && bare && settings.value("promptHistoryEnabled");
     const sessionId = enabled ? backend.identity.currentHistorySessionId() : null;
     if (settings === null || !enabled || (scope === "unique" && sessionId === null))
         return null;

package/dist/composition/reference-selection-options.d.ts

@@ -1,3 +1,3 @@
 import type { ReferenceDocumentSelectionOptions } from "../features/owned-ui/reference-document-selection.js";
-/** Builds the Changelog selection clipboard policy without loading Pi's engine in a utility tab. */
+/** Builds the Changelog selection clipboard policy without loading Pi's engine. */
 export declare function createReferenceSelectionOptions(settingsFile: string, copyText: ((text: string) => boolean | void) | undefined): ReferenceDocumentSelectionOptions;

package/dist/composition/reference-selection-options.js

@@ -1,5 +1,5 @@
 import { readFileSync } from "node:fs";
-/** Builds the Changelog selection clipboard policy without loading Pi's engine in a utility tab. */
+/** Builds the Changelog selection clipboard policy without loading Pi's engine. */
 export function createReferenceSelectionOptions(settingsFile, copyText) {
     return {
         copyOnSelect: () => {

package/dist/composition/session-runtime-registry.d.ts

@@ -1,5 +1,5 @@
 import type { ProcessIdentity } from "../foundation/lifecycle/model.js";
-export interface SessionRuntimeRegistryOptions {
+interface SessionRuntimeRegistryOptions {
     /** Absent outside claim-owning runtimes. */
     readonly runtimeId: string | undefined;
     /** Process liveness inspection; absent SDK seams cannot claim. */
@@ -15,3 +15,4 @@ export declare class SessionRuntimeRegistry {
     /** Drain publication before releasing claims; never republish after disposal. */
     dispose(): Promise<void>;
 }
+export {};

package/dist/composition/settings-route-host.js

@@ -1,6 +1,7 @@
 import { CHANGELOG_ROUTE, HOTKEYS_ROUTE, HOTKEYS_TITLE } from "../features/owned-ui/reference-routes.js";
 import { SETTINGS_APP_ID, SETTINGS_ROUTE } from "../features/owned-ui/settings-route.js";
-import { piTheme, renderPiAccentPreview } from "../integrations/pi/components/upstream/theme/theme.js";
+import { piTheme } from "../integrations/pi/components/upstream/theme/theme.js";
+import { piUiTheme } from "../integrations/pi/components/theme.js";
 import { faint } from "../ui/components/text.js";
 /** Declares settings and lazy document routes. */
 export function createOwnedRouteHost(settings, references, options = {}) {
@@ -145,13 +146,5 @@ async function hostApp(id, route, create, closeOnInterrupt = true, appInputBefor
     };
 }
 function pinnedTheme(panel) {
-    return {
-        fg: (token, text) => piTheme().fg(token, text),
-        bold: (text) => piTheme().bold(text),
-        plain: (text) => text,
-        accentPreview: (color, text) => renderPiAccentPreview(color, text),
-        disabled: (text) => faint(piTheme().fg("dim", text)),
-        highlight: (text) => piTheme().bg("selectedBg", text),
-        panel,
-    };
+    return piUiTheme({ panel, disabled: text => faint(piTheme().fg("dim", text)) });
 }

package/dist/composition/settings-search-input.d.ts

@@ -1,9 +1,10 @@
 import type { SettingsSearchInputFactory } from "../features/owned-ui/settings-search-input.js";
 import { type PiKeybindingsHost } from "../integrations/pi/components/shell-shared-facade.js";
-export interface SettingsSearchInputFactoryOptions {
+interface SettingsSearchInputFactoryOptions {
     readonly keybindings?: PiKeybindingsHost;
     readonly agentDir?: string;
     readonly cwd?: string;
 }
 /** Builds Settings search from the same configurable owned editor used by the agent prompt. */
 export declare function createSettingsSearchInputFactory(options?: SettingsSearchInputFactoryOptions): SettingsSearchInputFactory;
+export {};

package/dist/composition/startup-route.d.ts

@@ -2,8 +2,8 @@ import type { OwnedUiShellEngineOptions } from "../app/session-shell/index.js";
 import type { ReleaseNoteCatalog } from "../features/owned-ui/release-notes.js";
 import type { StartupReleaseUpdateObservationOptions } from "./release-update-observation.js";
 type StartupRoute = NonNullable<OwnedUiShellEngineOptions["startupRoute"]>;
-export interface StartupReleaseNoteOptions {
-    readonly ownedSurfaces: boolean;
+interface StartupReleaseNoteOptions {
+    readonly productMode: "bare" | "comparison";
     /** Deterministic catalog and version seams for composition tests. */
     readonly releaseNotes?: ReleaseNoteCatalog;
     readonly packageVersion?: string;

package/dist/composition/startup-route.js

@@ -40,7 +40,7 @@ export class StartupReleaseNote {
     static async load(options) {
         let catalog = null;
         let failure;
-        if (options.ownedSurfaces) {
+        if (options.productMode === "bare") {
             try {
                 catalog = options.releaseNotes
                     ?? await import("../features/owned-ui/release-notes.js").then(module => module.readPackagedReleaseNotes());
@@ -49,7 +49,7 @@ export class StartupReleaseNote {
                 failure = error;
             }
         }
-        const packageVersion = options.ownedSurfaces ? options.packageVersion ?? await readPackageVersion() : null;
+        const packageVersion = options.productMode === "bare" ? options.packageVersion ?? await readPackageVersion() : null;
         const current = packageVersion === null ? null : catalog?.current(packageVersion) ?? null;
         const profileId = options.profileId;
         const claim = current === null || profileId === undefined

package/dist/contracts/owned-ui/extension-ui.d.ts

@@ -183,7 +183,7 @@ export interface OwnedUiExtensionOverlayHandle {
     /** The most recently rendered terminal-relative rectangle of a visible overlay. */
     getBounds(): OwnedUiExtensionOverlayBounds | undefined;
 }
-export interface OwnedUiExtensionOverlayBounds {
+interface OwnedUiExtensionOverlayBounds {
     readonly row: number;
     readonly col: number;
     readonly width: number;
@@ -308,3 +308,4 @@ export interface OwnedUiExtensionRendererPort {
     }, theme: OwnedUiExtensionThemePort, context: OwnedUiExtensionToolRenderContext): OwnedUiExtensionComponent;
 }
 export declare function assertOwnedUiExtensionUiPort(value: unknown): asserts value is OwnedUiExtensionUiPort;
+export {};

package/dist/contracts/owned-ui/index.d.ts

@@ -17,4 +17,5 @@ export { SUGGESTION_ATTEMPT_TRIGGERS, SUGGESTION_DECISION_REASONS, SUGGESTION_DI
 export type { SuggestionAttemptTrigger, SuggestionDecision, SuggestionDecisionReason, SuggestionDiagnosticEvent, SuggestionDiagnosticObserver, SuggestionDiagnosticRecord, } from "./suggestion-diagnostics.js";
 export { PROMPT_HISTORY_EDITOR_REPLACEMENT, PROMPT_HISTORY_MAX_ENTRY_BYTES, PROMPT_HISTORY_MAX_PENDING, PROMPT_HISTORY_MAX_TEXT_BYTES, assertPromptHistorySubmission, } from "./prompt-history.js";
 export type { PromptHistoryFailure, PromptHistoryImageSidecarAttachment, PromptHistoryImageSidecarPort, PromptHistoryImageSidecarRecord, PromptHistoryKind, PromptHistoryPort, PromptHistoryResult, PromptHistorySnapshot, PromptHistorySubmission, } from "./prompt-history.js";
-export { assertOwnedUiCommand, assertOwnedUiCustomization, assertOwnedUiDiagnostics, assertOwnedUiEditorState, assertOwnedUiEvent, assertOwnedUiPromptSuggestionIdentity, assertOwnedUiPromptSuggestionRequest, assertOwnedUiPromptSuggestionResult, assertOwnedUiPromptSuggestionState, assertOwnedUiSessionViewModel, assertOwnedUiSnapshot, assertOwnedUiStatusView, assertOwnedUiTerminalSurface, assertOwnedUiTranscriptBlock, } from "./validation.js";
+export { assertOwnedUiCommand, assertOwnedUiPromptSuggestionRequest, assertOwnedUiPromptSuggestionResult, assertOwnedUiSnapshot, } from "./validation.js";
+export type { OwnedUiShellAuthProviderOption, OwnedUiShellAutocompleteCommand, OwnedUiShellClipboardContent, OwnedUiShellCommandMessage, OwnedUiShellComponentPort, OwnedUiShellComponents, OwnedUiShellEditorBodyGeometry, OwnedUiShellEditorOptions, OwnedUiShellEditorPointerEvent, OwnedUiShellEditorPort, OwnedUiShellEditorRecall, OwnedUiShellEditorTextRange, OwnedUiShellExtensionRendererResolver, OwnedUiShellExtensionUiBridge, OwnedUiShellExtensionUiBridgeHost, OwnedUiShellHeaderOptions, OwnedUiShellHeaderPort, OwnedUiShellHistoryEditor, OwnedUiShellHotkeysPresentation, OwnedUiShellImageAssetResolver, OwnedUiShellKeybindings, OwnedUiShellKeybindingsHost, OwnedUiShellLazySelectorLoader, OwnedUiShellLoadedResourcesPort, OwnedUiShellLoginDialogPort, OwnedUiShellMermaidRenderingMode, OwnedUiShellOperationLoaderPort, OwnedUiShellPasteReservation, OwnedUiShellProgramStatus, OwnedUiShellProgramStatusBlocked, OwnedUiShellProgramStatusReporter, OwnedUiShellProgressPresentationMode, OwnedUiShellProgressStatusPresentation, OwnedUiShellPromptInputBody, OwnedUiShellPromptInputGeometry, OwnedUiShellPromptInputPresentation, OwnedUiShellQueuedInputPort, OwnedUiShellReleaseUpdate, OwnedUiShellReleaseUpdateBanner, OwnedUiShellResourceEntry, OwnedUiShellResourceSection, OwnedUiShellRuntime, OwnedUiShellSelectorOption, OwnedUiShellSelectorOptions, OwnedUiShellSkillSummary, OwnedUiShellStartupNotice, OwnedUiShellStatusPlacement, OwnedUiShellStatusPort, OwnedUiShellSubmittedPromptComposer, OwnedUiShellThinkingLevel, OwnedUiShellThinkingSelectorOptions, OwnedUiShellTranscriptComponentPort, OwnedUiShellTreeFilterMode, OwnedUiShellTreeSelectorOptions, OwnedUiShellTrustDecision, OwnedUiShellTrustOption, OwnedUiShellTrustSelectorOptions, OwnedUiShellTrustUpdate, OwnedUiShellViewComponentPort, } from "./shell-components.js";

package/dist/contracts/owned-ui/index.js

@@ -7,4 +7,4 @@ export { CONTEXTUAL_PROMPT_SUGGESTION_INSTRUCTION, normalizePromptSuggestionCand
 export { canonicalPromptChipMatches, protectPromptChipWrapping, replaceCanonicalPromptChips } from "./prompt-chips.js";
 export { SUGGESTION_ATTEMPT_TRIGGERS, SUGGESTION_DECISION_REASONS, SUGGESTION_DIAGNOSTIC_EVENTS } from "./suggestion-diagnostics.js";
 export { PROMPT_HISTORY_EDITOR_REPLACEMENT, PROMPT_HISTORY_MAX_ENTRY_BYTES, PROMPT_HISTORY_MAX_PENDING, PROMPT_HISTORY_MAX_TEXT_BYTES, assertPromptHistorySubmission, } from "./prompt-history.js";
-export { assertOwnedUiCommand, assertOwnedUiCustomization, assertOwnedUiDiagnostics, assertOwnedUiEditorState, assertOwnedUiEvent, assertOwnedUiPromptSuggestionIdentity, assertOwnedUiPromptSuggestionRequest, assertOwnedUiPromptSuggestionResult, assertOwnedUiPromptSuggestionState, assertOwnedUiSessionViewModel, assertOwnedUiSnapshot, assertOwnedUiStatusView, assertOwnedUiTerminalSurface, assertOwnedUiTranscriptBlock, } from "./validation.js";
+export { assertOwnedUiCommand, assertOwnedUiPromptSuggestionRequest, assertOwnedUiPromptSuggestionResult, assertOwnedUiSnapshot, } from "./validation.js";

package/dist/contracts/owned-ui/session-presenters.d.ts

@@ -1,3 +1,4 @@
+import type { OwnedUiShellComponents } from "./shell-components.js";
 /**
  * Presenters for the selectors and transcript renderers whose inputs are engine objects. The shell opens them
  * through this port and never holds those objects; the Pi session presenters owner implements it.
@@ -71,6 +72,8 @@ export interface OwnedUiTranscriptRendererPort {
     getShortcuts(bindings: Readonly<Record<string, string | readonly string[] | undefined>>): readonly OwnedUiShortcutDescription[];
 }
 export interface OwnedUiSessionPresenters {
+    /** The vendor components and text helpers the shell renders with. */
+    readonly components: OwnedUiShellComponents;
     transcriptRenderers(): OwnedUiTranscriptRendererPort;
     openModelSelector(host: OwnedUiDialogHost, initialSearchInput?: string): void;
     openSessionSelector(host: OwnedUiDialogHost, onExit: () => void): Promise<void>;