@timurproko/a1 0.2.7-dev.1249 → 0.2.7-dev.1255

package/dist/composition/owned-ui.js

@@ -17,25 +17,17 @@ import { createPiTerminalBridge } from "../integrations/pi/tui-runtime/presentat
 import { createOwnedRouteHost } from "./settings-route-host.js";
 import { renderPiShellChangelogLines } from "../integrations/pi/components/shell-presenters-info.js";
 import { nativeHyperlinkStyle } from "../ui/components/spans.js";
-import { ResidentTabRecovery } from "../foundation/resident-tabs/recovery.js";
-import { bindResidentPresentation, createResidentClientIdentity, closeResidentUtilityRoute, correlateResidentTabSubmission, currentBackendSessionFile, residentRouteHostOptions, residentTabKeybindings } from "./resident-tab-bridge.js";
 import { SessionRuntimeRegistry } from "./session-runtime-registry.js";
 import { deferStartupReleaseUpdateObservation, readPackageVersion, StartupReleaseNote } from "./startup-route.js";
 import { createOwnedSettingsManager, watchSharedSettings } from "./owned-settings.js";
-export { bindResidentTabBridge, correlateResidentTabSubmission } from "./resident-tab-bridge.js";
-export function residentStartupPresentation(resident, fallbackNotice) {
-    if (resident)
-        return { startup: { quiet: true } };
-    return fallbackNotice === undefined ? {} : { startup: { notices: [{ kind: "warning", message: fallbackNotice }] } };
-}
 export async function composeOwnedUiApplication(options = {}) {
     return (await composeOwnedUi(options)).application;
 }
 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();
@@ -46,47 +38,27 @@ export async function composeOwnedUi(options = {}) {
         : createOwnedSettingsManager({
             profileId: options.profileId,
             agentProvider: () => backend.settingsPort(),
-            ...(options.hideTabSettings ? { hideTabSettings: true } : {}),
         });
-    const tabBridge = options.tab?.bridge ?? null;
-    if (tabBridge !== null)
-        await tabBridge.start().catch(() => false);
-    const projectTrustPrompt = options.projectTrustPrompt === undefined ? undefined : async (request) => {
-        tabBridge?.status("needs-input", false, 1, 0);
-        try {
-            return await options.projectTrustPrompt(request);
-        }
-        finally {
-            tabBridge?.status("starting");
-        }
-    };
+    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: settings !== null && bare ? settings.value("accentColor") : "purple",
+            packageBorderProjection: bare,
             apply: { base: applyConfiguredPiTheme, accentColor: setPiAccentColor, packageBorderProjection: setPiPackageBorderProjectionEnabled },
         },
         ...(projectTrustPrompt === undefined ? {} : { projectTrustPrompt }),
     });
-    const sessionForkPrompt = options.sessionForkPrompt === undefined ? undefined : async (request) => {
-        tabBridge?.status("needs-input", false, 1, 0);
-        try {
-            return await options.sessionForkPrompt(request);
-        }
-        finally {
-            tabBridge?.status("starting");
-        }
-    };
+    const sessionForkPrompt = options.sessionForkPrompt;
     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 }),
@@ -96,44 +68,28 @@ export async function composeOwnedUi(options = {}) {
         await host.dispose();
         throw error;
     }
-    const clientIdentity = createResidentClientIdentity(update => backend.extensions.announceReleaseUpdate(update));
-    let recoveryDegraded = false;
-    let presentRecoveryDegraded = (_degraded) => { };
-    const tabRecovery = options.tab === undefined ? null : new ResidentTabRecovery(options.tab.dataDir, {
-        onDegraded: degraded => {
-            recoveryDegraded = degraded;
-            options.tab.bridge.degraded(degraded);
-            presentRecoveryDegraded(degraded);
-        },
-    });
-    const recoveredTabInput = await tabRecovery?.initialize(currentBackendSessionFile(backend), backend.identity.sessionId);
-    if (tabBridge !== null && settings !== null && ownedSurfaces)
-        tabBridge.accent(settings.value("accentColor"));
-    let removeControllerBoundaryInput = () => { };
-    let unsubscribeTabBridge = () => { };
     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 = settings === null || !bare
         ? () => { }
         : settings.onChange(current => {
             const accent = current.value("accentColor");
             host.setAccentColor(accent);
-            tabBridge?.accent(accent);
         });
-    // Rationale: resident tabs and separate solo agents share a settings document; a live scope
-    // change saved in either reaches the others only by rereading that document.
-    const unwatchSharedSettings = settings === null || !ownedSurfaces
+    // 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 || !bare
         ? () => { }
         : watchSharedSettings(settings);
     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 = residentTabKeybindings(tabBridge, backend.identity.agentDir, keybindingsHost);
+    const keybindingsHost = createPiKeybindingsHost({ profile: bare ? "a1" : "pi", agentDir: backend.identity.agentDir });
+    const keybindings = keybindingsHost;
     // Rationale: Routes open only after shell construction.
     const references = {
         changelog: async (input) => {
@@ -149,41 +105,41 @@ 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(tabBridge, keybindings, backend.identity.agentDir, cwd));
-    const viewportSettings = settings === null || !ownedSurfaces ? null : {
+    const routeHost = settings === null || !bare ? null
+        : createOwnedRouteHost(settings, references, settingsRouteOptions(keybindings, backend.identity.agentDir, cwd));
+    const viewportSettings = settings === null || !bare ? null : {
         snapshot: () => viewportSettingsSnapshot(settings),
         onChange: listener => settings.onChange(() => listener(viewportSettingsSnapshot(settings))),
     };
-    const backgroundSettings = settings === null || !ownedSurfaces ? null : {
+    const backgroundSettings = settings === null || !bare ? 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 diagnosticDestination = options.suggestionDiagnosticsPath ?? process.env[PRODUCT_IDENTITY.environment.suggestionDiagnostics];
-    const suggestionDiagnostics = settings !== null && ownedSurfaces && diagnosticDestination?.trim()
+    const suggestionDiagnostics = settings !== null && bare && 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 : {
+    const promptSuggestions = settings === null || !bare ? 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 : {
+    const promptImages = settings === null || !bare ? null : {
         limit: () => settings.value("promptImageLimit"),
         onChange: (listener) => settings.onChange(listener),
     };
-    const skills = settings === null || !ownedSurfaces ? null : {
+    const skills = settings === null || !bare ? 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 promptHistory = createPromptHistoryConfiguration(settings, backend, bare);
     const clipboardDestination = options.clipboardDiagnosticsPath ?? process.env[PRODUCT_IDENTITY.environment.clipboardDiagnostics];
-    const clipboardDiagnostics = settings !== null && ownedSurfaces && clipboardDestination?.trim()
+    const clipboardDiagnostics = settings !== null && bare && 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;
     let createdTerminalHost;
     let terminalHost;
     let presenter;
@@ -195,26 +151,14 @@ export async function composeOwnedUi(options = {}) {
                 cwd: backend.identity.cwd,
                 ...(routeHost === null ? {} : { routeHost }),
                 ...(releaseNote.startupRoute === undefined ? {} : { startupRoute: releaseNote.startupRoute }),
-                ...(ownedSurfaces ? { sessionLayout: "custom-viewport" } : {}),
-                ...(tabBridge === null || tabRecovery === null ? {} : { residentTab: {
-                        requestDetach: () => tabBridge.requestDetach(),
-                        closeOwnedRoute: route => closeResidentUtilityRoute(tabBridge, route),
-                        reportStatus: status => tabBridge.status(status),
-                        admit: input => tabRecovery.admit({ ...input, incarnation: options.tab.incarnation }),
-                        dispatched: () => tabRecovery.dispatched(),
-                        correlated: (submissionId, entryId) => correlateResidentTabSubmission(tabRecovery, backend, submissionId, entryId),
-                        checkpoint: text => tabRecovery.checkpoint(text),
-                        gracefulStop: sessionFile => tabRecovery.gracefulStop(sessionFile),
-                        ...(recoveredTabInput === undefined ? {} : { recovered: recoveredTabInput }),
-                    } }),
+                ...(bare ? { sessionLayout: "custom-viewport" } : {}),
             },
             presentation: {
                 ...(options.terminal === undefined ? {} : { terminal: createPiTerminalBridge(options.terminal) }),
-                ...residentStartupPresentation(tabBridge !== null, options.residentFallbackNotice), soloResumeHint: options.soloResumeHint === true && tabBridge === null,
                 ...(clipboardDiagnostics === null ? {} : { input: { onEvent: event => clipboardDiagnostics.runtime(event) } }),
                 ...(viewportSettings === null ? {} : { viewportSettings }),
                 ...(backgroundSettings === null ? {} : { backgroundSettings }),
-                ...(settings === null || !ownedSurfaces || tabBridge !== null ? {} : {
+                ...(settings === null || !bare ? {} : {
                     quitOutro: { snapshot: () => quitOutroSettingsSnapshot(settings), interactive: process.stdout.isTTY === true },
                 }),
             },
@@ -235,20 +179,7 @@ export async function composeOwnedUi(options = {}) {
         // the host and paints once attached.
         terminalHost = createdTerminalHost = new OwnedUiTerminalHost(sessionTerminalHostOptions(presenterOptions));
         presenter = new OwnedUiSessionPresenter(terminalHost, presenterOptions);
-        presentRecoveryDegraded = degraded => {
-            if (!degraded)
-                return;
-            presenter.root.appendWorkflowStatus("draft recovery degraded");
-            terminalHost.runtime.requestRender();
-        };
-        if (recoveryDegraded)
-            presentRecoveryDegraded(true);
         terminalHost.attach(presenter);
-        ({ unsubscribeTabBridge, removeControllerBoundaryInput } = await bindResidentPresentation(tabBridge, backend, tabRecovery, {
-            autoName: settings?.value("tabsAutoName") ?? true,
-            openRoute: route => presenter.openOwnedRoute(route),
-            onClientVersion: clientIdentity.observe,
-        }, terminalHost.runtime));
     }
     catch (error) {
         await createdTerminalHost?.dispose().catch(() => undefined);
@@ -266,12 +197,10 @@ export async function composeOwnedUi(options = {}) {
     const releaseUpdates = deferStartupReleaseUpdateObservation({
         backend,
         configDir: productPaths.configDir,
-        mode: settings === null || !ownedSurfaces ? "auto" : settings.value("updateCheck"),
-        packageVersion: releaseNote.packageVersion, readPackageVersion, notificationVersion: options.notificationVersion,
+        mode: settings === null || !bare ? "auto" : settings.value("updateCheck"),
+        packageVersion: releaseNote.packageVersion, readPackageVersion,
         checkForNewerRelease: options.checkForNewerRelease,
-        clientVersion: clientIdentity.current,
     });
-    clientIdentity.onChange(releaseUpdates.clientChanged);
     const exitNoticePath = process.env[PRODUCT_IDENTITY.environment.exitNoticePath];
     // Security: tools the agent runs must never see, or rewrite, this instance's notice.
     delete process.env[PRODUCT_IDENTITY.environment.exitNoticePath];
@@ -279,10 +208,10 @@ export async function composeOwnedUi(options = {}) {
     const application = {
         get disposed() { return backend.identity.disposed; },
         start: () => {
-            // Performance: the guardian notice loads beside first paint, never on the startup path.
+            // Performance: the launcher's exit notice loads beside first paint, never on the startup path.
             if (exitNoticePath)
                 exitNotice = import("../app/session-shell/exit-notice.js")
-                    .then(module => module.armExitNotice(backend, exitNoticePath, options.soloResumeHint === true && tabBridge === null), () => null);
+                    .then(module => module.armExitNotice(backend, exitNoticePath), () => null);
             presenter.start();
             releaseUpdates.start();
         },
@@ -299,14 +228,11 @@ export async function composeOwnedUi(options = {}) {
             finally {
                 // Invariant: the shared spares outlive every shell and stop only after the last one is disposed.
                 clipboardServices?.dispose();
-                removeControllerBoundaryInput();
                 unsubscribeAccent();
                 await sessionRuntimes.dispose();
                 await releaseNote.releaseClaim();
                 suggestionDiagnostics?.dispose();
                 clipboardDiagnostics?.dispose();
-                unsubscribeTabBridge();
-                tabBridge?.close();
                 // Invariant: the host outlives the application; disposing it cancels host-level probes last.
                 await host.dispose();
             }
@@ -314,10 +240,10 @@ export async function composeOwnedUi(options = {}) {
     };
     return { application, settings };
 }
-function createPromptHistoryConfiguration(settings, backend, ownedSurfaces) {
+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;
@@ -340,9 +266,8 @@ function createPromptHistoryConfiguration(settings, backend, ownedSurfaces) {
     };
 }
 export { watchSharedSettings } from "./owned-settings.js";
-function settingsRouteOptions(tabBridge, keybindings, agentDir, cwd) {
+function settingsRouteOptions(keybindings, agentDir, cwd) {
     return {
-        ...residentRouteHostOptions(tabBridge),
         keybindings,
         agentDir,
         cwd,
@@ -361,7 +286,6 @@ function quitOutroSettingsSnapshot(settings) {
 }
 function viewportSettingsSnapshot(settings) {
     return {
-        timeFormat: settings.value("timeFormat"),
         scrollbarAppearance: settings.value("scrollbarAppearance"),
         scrollbarStyle: settings.value("scrollbarStyle"),
         scrollbarSpeed: settings.value("scrollbarSpeed"),

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/release-update-observation.d.ts

@@ -6,17 +6,17 @@ export interface StartupReleaseUpdateObservationOptions {
     readonly mode: StartupUpdateMode;
     readonly packageVersion: string | null;
     readonly readPackageVersion: () => Promise<string>;
-    readonly notificationVersion: string | undefined;
     readonly checkForNewerRelease: ((options: StartupReleaseCheckOptions) => Promise<AvailableRelease | null>) | undefined;
-    readonly clientVersion?: () => string | null;
 }
-/** Client readiness is unrelated to the retained Agent's engine version or execution lifecycle. */
+/**
+ * `Auto` installs a verified newer release in the background; the only thing the user sees is the
+ * installed status once the approved active release is newer than the one running here.
+ */
 declare class ReleaseUpdateObservation {
     #private;
     constructor(input: StartupReleaseUpdateObservationOptions);
     start(): void;
     stop(): void;
-    clientChanged(): void;
 }
 export declare function createStartupReleaseUpdateObservation(input: StartupReleaseUpdateObservationOptions): ReleaseUpdateObservation;
 export {};

package/dist/composition/release-update-observation.js

@@ -1,9 +1,11 @@
-/** Client readiness is unrelated to the retained Agent's engine version or execution lifecycle. */
+/**
+ * `Auto` installs a verified newer release in the background; the only thing the user sees is the
+ * installed status once the approved active release is newer than the one running here.
+ */
 class ReleaseUpdateObservation {
     #input;
     #controller = new AbortController();
     #timer;
-    #announced = null;
     #installedAnnounced = false;
     #eligible;
     #cadence = null;
@@ -13,18 +15,14 @@ class ReleaseUpdateObservation {
     #refresh = false;
     #stopActiveReleaseObservation = () => { };
     constructor(input) { this.#input = input; this.#eligible = input.mode === "auto"; }
-    #announce(status, version) {
-        const key = `${status}:${version}`;
-        if (key === this.#announced || (status === "installed" && this.#installedAnnounced) || this.#controller.signal.aborted)
+    #announceInstalled(version) {
+        if (this.#installedAnnounced || this.#controller.signal.aborted)
             return;
-        this.#announced = key;
-        if (status === "installed") {
-            this.#installedAnnounced = true;
-            this.#eligible = false;
-            if (this.#timer !== undefined)
-                clearTimeout(this.#timer);
-        }
-        this.#input.backend.extensions.announceReleaseUpdate({ status, version });
+        this.#installedAnnounced = true;
+        this.#eligible = false;
+        if (this.#timer !== undefined)
+            clearTimeout(this.#timer);
+        this.#input.backend.extensions.announceReleaseUpdate({ status: "installed", version });
     }
     async #startActiveReleaseObservation() {
         const runningVersion = this.#input.packageVersion ?? await this.#input.readPackageVersion();
@@ -36,7 +34,7 @@ class ReleaseUpdateObservation {
         this.#stopActiveReleaseObservation = module.observeNewerActiveRelease({
             runningVersion,
             signal: this.#controller.signal,
-            onNewer: version => this.#announce("installed", version),
+            onNewer: version => this.#announceInstalled(version),
         });
     }
     async #observe() {
@@ -46,10 +44,9 @@ class ReleaseUpdateObservation {
         this.#nextDelay = this.#cadence;
         const input = this.#input;
         const check = input.checkForNewerRelease ?? releases.checkForNewerRelease;
-        const client = input.clientVersion?.();
-        const runningVersion = client ?? input.packageVersion ?? await input.readPackageVersion();
+        const runningVersion = input.packageVersion ?? await input.readPackageVersion();
         const options = {
-            runningVersion: client ?? (input.mode === "notify" ? input.notificationVersion ?? runningVersion : runningVersion),
+            runningVersion,
             configDir: input.configDir, interactive: process.stdout.isTTY === true, settingMode: input.mode,
             signal: this.#controller.signal, onNextCheckDelay: delay => { this.#nextDelay = delay; },
         };
@@ -58,31 +55,12 @@ class ReleaseUpdateObservation {
             return;
         }
         const release = await check(options);
-        if (release === null || this.#controller.signal.aborted)
-            return;
-        const current = input.clientVersion?.();
-        if (current && !releases.isNewerRelease(release.version, current))
-            return;
-        if (input.mode === "notify") {
-            input.backend.extensions.announceReleaseUpdate(release);
-            return;
-        }
-        if (input.mode !== "auto")
+        if (release === null || this.#controller.signal.aborted || input.mode !== "auto")
             return;
         const installed = await import("../foundation/release/automatic-update.js")
-            .then(module => module.requestAutomaticUpdate({
-            release, runningVersion, signal: this.#controller.signal,
-            onActivationBlocked: version => {
-                const clientVersion = input.clientVersion?.();
-                if (version !== null && clientVersion && !releases.isNewerRelease(version, clientVersion))
-                    return;
-                if (version !== null)
-                    this.#nextDelay = module.AUTOMATIC_UPDATE_ACTIVATION_RETRY_MS;
-                this.#announce(version === null ? "blocked-cleared" : "blocked", version ?? release.version);
-            },
-        }));
+            .then(module => module.requestAutomaticUpdate({ release, runningVersion, signal: this.#controller.signal }));
         if (installed !== null)
-            this.#announce("installed", installed);
+            this.#announceInstalled(installed);
     }
     async #run() {
         if (this.#running) {
@@ -118,13 +96,5 @@ class ReleaseUpdateObservation {
         if (this.#timer !== undefined)
             clearTimeout(this.#timer);
     }
-    clientChanged() {
-        this.#announced = null;
-        if (!this.#started || this.#controller.signal.aborted || this.#installedAnnounced || this.#input.mode === "no")
-            return;
-        if (this.#timer !== undefined)
-            clearTimeout(this.#timer);
-        void this.#run();
-    }
 }
 export function createStartupReleaseUpdateObservation(input) { return new ReleaseUpdateObservation(input); }

package/dist/composition/session-backend.d.ts

@@ -9,7 +9,6 @@ import type { PiSessionPresenterBackend } from "../integrations/pi/session-prese
  */
 export interface ComposedSessionBackend extends PiSessionPresenterBackend, OwnedUiPromptSuggestionGeneratorPort {
     settingsPort(): AgentSettingsPort | null;
-    generateResidentTabName(instruction: string, maxTokens: number, signal: AbortSignal): Promise<string | null>;
 }
 /** The process-level engine host as composition drives it: sessions, the live accent, and disposal. */
 export interface ComposedEngineHost {

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

@@ -1,9 +1,9 @@
-import type { NativeProcessIdentity } from "../foundation/lifecycle/model.js";
-export interface SessionRuntimeRegistryOptions {
+import type { ProcessIdentity } from "../foundation/lifecycle/model.js";
+interface SessionRuntimeRegistryOptions {
     /** Absent outside claim-owning runtimes. */
     readonly runtimeId: string | undefined;
-    /** Exact native inspection; absent SDK seams cannot claim. */
-    readonly inspectProcess: ((pid: number) => Promise<NativeProcessIdentity | null>) | undefined;
+    /** Process liveness inspection; absent SDK seams cannot claim. */
+    readonly inspectProcess: ((pid: number) => Promise<ProcessIdentity | null>) | undefined;
     readonly refreshMs?: number;
 }
 /** Lifecycle-owned publication and retries for each agent's current session, serialized with disposal. */
@@ -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.d.ts

@@ -11,13 +11,6 @@ export interface OwnedReferenceProviders {
 }
 /** How the settings route is presented. */
 export interface OwnedRouteHostOptions {
-    /**
-     * The route whose screen is this resident utility tab. That screen is the tab, so it offers no
-     * screen-level close: neither Esc nor one Ctrl+C dismisses it, and it shows no close hint.
-     */
-    readonly tabRoute?: string | null;
-    /** Opens the tab bar's own Plus Menu dialog; false when no tab bar can show it. */
-    readonly configurePlusMenu?: () => boolean;
     readonly keybindings?: PiKeybindingsHost;
     readonly agentDir?: string;
     readonly cwd?: string;

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 = {}) {
@@ -17,8 +18,7 @@ export function createOwnedRouteHost(settings, references, options = {}) {
             const session = route === "session";
             const title = session ? "Session Info" : changelog ? input ? "What's New" : "Changelog" : HOTKEYS_TITLE;
             const document = session ? references.session() : changelog ? references.changelog(input) : references.hotkeys();
-            const pinned = options.tabRoute === route;
-            return deferredSurface(route, title, () => loadReferenceSurface(settings, route, title, document, pinned, options));
+            return deferredSurface(route, title, () => loadReferenceSurface(settings, route, title, document, options));
         },
     };
 }
@@ -68,22 +68,18 @@ async function loadSettingsSurface(settings, options) {
         import("./settings-search-input.js"),
         import("../ui/components/dialog-panel.js"),
     ]);
-    const pinned = options.tabRoute === SETTINGS_ROUTE;
     const searchInputFactory = createSettingsSearchInputFactory({
         ...(options.keybindings === undefined ? {} : { keybindings: options.keybindings }),
         ...(options.agentDir === undefined ? {} : { agentDir: options.agentDir }),
         ...(options.cwd === undefined ? {} : { cwd: options.cwd }),
     });
-    // Invariant: a pinned Settings tab closes as a tab; neither Esc nor one unclaimed Ctrl+C dismisses its screen.
     return hostApp(SETTINGS_APP_ID, SETTINGS_ROUTE, () => new SettingsApp(settings, {
-        pinned,
         searchInputFactory,
-        configurePlusMenu: options.configurePlusMenu ?? null,
         dialogPanel: text => renderFloatingDialogSurface(text, piTheme().getColorMode()),
         ...(options.copyText === undefined ? {} : { copyText: options.copyText }),
-    }), !pinned, true, text => renderFloatingMenuSurface(text, piTheme().getColorMode()));
+    }), true, true, text => renderFloatingMenuSurface(text, piTheme().getColorMode()));
 }
-async function loadReferenceSurface(settings, route, title, document, pinned, options) {
+async function loadReferenceSurface(settings, route, title, document, options) {
     const id = route;
     const [{ ReferenceScreenApp }, content, selection] = await Promise.all([
         import("../features/owned-ui/reference-screen-app.js"),
@@ -101,9 +97,8 @@ async function loadReferenceSurface(settings, route, title, document, pinned, op
             scrollbarStyle: settings.value("scrollbarStyle"),
             scrollbarSpeed: settings.value("scrollbarSpeed"),
         }),
-        pinned,
         ...(selection === undefined ? {} : { selection }),
-    }), !pinned, selection !== undefined);
+    }), true, selection !== undefined);
 }
 async function hostApp(id, route, create, closeOnInterrupt = true, appInputBeforeInterrupt = false, panel = text => text) {
     const [{ UiAppHost }, { UiAppRegistry }] = await Promise.all([
@@ -151,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;
@@ -17,7 +17,6 @@ type UpdateObservationModule = Pick<typeof import("./release-update-observation.
 export declare function deferStartupReleaseUpdateObservation(options: StartupReleaseUpdateObservationOptions, load?: () => Promise<UpdateObservationModule>): {
     start(): void;
     stop(): void;
-    clientChanged(): void;
 };
 /**
  * The release notes bare A1 ships and the one note this version shows once per profile on startup:

package/dist/composition/startup-route.js

@@ -23,7 +23,6 @@ export function deferStartupReleaseUpdateObservation(options, load = () => impor
             }).catch(() => { });
         },
         stop() { stopped = true; observation?.stop(); },
-        clientChanged() { observation?.clientChanged(); },
     };
 }
 /**
@@ -41,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());
@@ -50,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