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

package/README.md

@@ -53,19 +53,19 @@ The installer needs Node.js 22.19 or later. When npm's global folder is not writ
 
 ## Launch
 
-Launch A1 (profile: `~/.a1/agent`):
+Launch A1, one agent in this terminal (profile: `~/.a1/agent`):
 
 ```text
 a1
 ```
 
-Launch A1 in single agent mode:
+Resume a saved session:
 
 ```text
-a1 solo
+a1 --session <id>
 ```
 
-When a solo session exits, its printed `a1 solo --session <id>` command resumes that same conversation in solo mode; a custom session store is included in the printed command. Resident tabs are different: they keep running after detach, and bare `a1` returns to them.
+When a session exits, A1 prints the `a1 --session <id>` command that resumes it; a custom session store is included in the printed command. Closing the terminal ends the agent, as it does for Pi.
 
 Show all commands:
 
@@ -73,7 +73,7 @@ Show all commands:
 a1 help
 ```
 
-Show the current and latest versions:
+Show the current version and the latest Develop and Release versions, from either installed channel:
 
 ```text
 a1 version
@@ -87,30 +87,6 @@ a1 pi
 
 <p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme/separator-dark.svg"><img src="docs/assets/readme/separator.svg" alt="" width="280"></picture></p>
 
-## Tabs
-
-Tabs keep running after their terminal closes. List them, or stop one; its session stays resumable:
-
-```text
-a1 tabs
-a1 tabs stop <id>
-```
-
-Stop every tab and the resident host when you are finished with them (not required to run `a1 solo`):
-
-```text
-a1 tabs host stop
-```
-
-Show host health, or write a redacted diagnostic bundle:
-
-```text
-a1 tabs host status
-a1 tabs doctor
-```
-
-<p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme/separator-dark.svg"><img src="docs/assets/readme/separator.svg" alt="" width="280"></picture></p>
-
 ## Update
 
 Update on the channel you already use (release stays on release, develop stays on develop):
@@ -157,17 +133,16 @@ npm x -y -- @timurproko/a1-install
 
 The **Update** setting controls release discovery:
 
-- **Auto** (default) checks the running release's stable or development channel at startup and every 15 minutes while open. It silently installs a verified update, then shows `Update installed, restart to update` above the editor; existing sessions keep running until restarted.
-- **Notify** checks at startup (at most daily), keeps the `Update Available` notice, and leaves installation manual.
+- **Auto** (default) checks the running release's stable or development channel at startup and every 15 minutes while open. It silently installs a verified update, then shows `Update installed, restart to update` above the editor; existing sessions keep running on their release, and the next `a1` starts the new one.
 - **No** performs no update check; updates remain available through the commands above.
 
-`A1_SKIP_VERSION_CHECK=1` disables both Auto and Notify discovery. Manual stable, development, and exact-version update commands remain available in every mode.
+`A1_SKIP_VERSION_CHECK=1` disables Auto discovery. Manual stable, development, and exact-version update commands remain available in every mode.
 
 <p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme/separator-dark.svg"><img src="docs/assets/readme/separator.svg" alt="" width="280"></picture></p>
 
 ## Uninstall
 
-Remove A1 from this machine. It stops running tabs and asks before deleting your sessions and settings in `~/.a1`:
+Remove A1 from this machine. It asks before deleting your sessions and settings in `~/.a1`:
 
 ```text
 a1 uninstall
@@ -217,7 +192,7 @@ a1 update npm:pi-mcp-adapter
 
 ## Develop
 
-A source build needs Node.js, npm, git, and Rustup. Windows additionally needs Visual Studio or Visual Studio Build Tools with the **Desktop development with C++** workload, MSVC x64/x86 tools, and a Windows SDK; Visual Studio Code is not required. A1 discovers installed Rustup and Visual Studio tools and initializes them for build children, so Git Bash and ordinary PowerShell do not need manual `PATH` or developer-shell setup. It never installs these tools or accepts their licenses automatically.
+A source build needs Node.js, npm, and git. The product is pure TypeScript; there is no native toolchain to install.
 
 Install exact locked dependencies:
 
@@ -225,7 +200,7 @@ Install exact locked dependencies:
 npm ci
 ```
 
-Compile TypeScript and the native addons into `dist`:
+Compile TypeScript into `dist`:
 
 ```text
 npm run build
@@ -255,7 +230,7 @@ Complete non-physical suite:
 npm run test:full
 ```
 
-Report Node, npm, git, Rust, dependency, and Windows C++ readiness. Missing Windows tools are listed in setup order; after installing them, rerun the same build command:
+Report Node, npm, git, GitHub CLI, and dependency readiness; after fixing anything it lists, rerun the same build command:
 
 ```text
 npm run doctor

package/bin/cli.js

@@ -55,23 +55,8 @@ process.exitCode = await dispatchCli(process.argv.slice(2), {
     return await runPackageCommand(request, { createPort: createPiPackagesPort });
   },
   sessionContext: async request => {
-    const [{ runSessionContextCommand }, { createNativeProcessInspector }, { readLaunchContext }] = await Promise.all([
-      import("../dist/cli/session-context.js"),
-      import("../dist/foundation/process-containment/native-process-inspector.js"),
-      import("../dist/foundation/launch-context/index.js"),
-    ]);
-    const launch = readLaunchContext(process.env);
-    let inspector;
-    return await runSessionContextCommand(request, {
-      inspectProcess: async pid => {
-        inspector ??= createNativeProcessInspector(process.env, process.platform, launch.releaseRoot);
-        return (await inspector).observe(pid);
-      },
-    });
-  },
-  tabs: async request => {
-    const { runTabsCommand } = await import("../dist/cli/tabs.js");
-    return await runTabsCommand(request, { packageRoot: fileURLToPath(packageRoot) });
+    const { runSessionContextCommand } = await import("../dist/cli/session-context.js");
+    return await runSessionContextCommand(request);
   },
   uninstall: async request => {
     const [{ runUninstall }, { createInterface }] = await Promise.all([

package/bin/ui.js

@@ -1,18 +1,11 @@
 #!/usr/bin/env node
 
-// Security: this helper has no A1, Pi, tool, or extension dependency and erases credentials before those modules load.
-const { assignFreshSessionRuntimeId, consumeTabLaunchContext, formatResidentFallbackNotice, waitForStandbyPromotion } = await import("./tab-launch-context.js");
-const { uiArguments, tabCredentials, tabDataDir, tabIncarnation, tabStandby } = consumeTabLaunchContext(process.argv.slice(2), process.env);
-
 // Invariant: one terminal module identity per process, decided before any A1 or Pi module loads.
 const { installPinnedPiTuiResolver } = await import("./module-resolver.js");
 installPinnedPiTuiResolver(new URL("..", import.meta.url).pathname.replace(/^\/(.:)/, "$1").replace(/\/$/, ""));
-const utilityRoute = tabCredentials === undefined
-  ? null
-  : (await import("../dist/foundation/resident-tabs/routes.js")).residentUtilityRoute(tabCredentials.tabId);
 const startup = await import("../dist/foundation/startup/startup-runtime.js");
 startup.enableEnvironmentCompileCache(process.env);
-const { hidesTabSettings, readLaunchContext } = await import("../dist/foundation/launch-context/index.js");
+const { readLaunchContext } = await import("../dist/foundation/launch-context/index.js");
 const launchContext = readLaunchContext(process.env, "profile");
 const profile = launchContext.launchProfile;
 if (profile === undefined) throw new Error("A1 launch profile is missing");
@@ -21,17 +14,16 @@ if (profile === "a1") {
     import("node:crypto"),
     import("../dist/product-identity.js"),
   ]);
-  assignFreshSessionRuntimeId(process.env, PRODUCT_IDENTITY.environment.sessionRuntimeId, randomUUID);
+  // Invariant: every UI process is its own session runtime, never one inherited from a parent shell.
+  process.env[PRODUCT_IDENTITY.environment.sessionRuntimeId] = randomUUID();
 }
 const { installFatalExit } = await import("../dist/foundation/terminal-cleanup/fatal-exit.js");
 const { resolveProductPaths } = await import("../dist/foundation/lifecycle/paths.js");
-const { dirname, join } = await import("node:path");
+const { join } = await import("node:path");
 /** @type {{ dispose(): void | Promise<unknown> } | undefined} */
 let runningApplication;
 const fatal = profile === "a1" ? installFatalExit({
-  directory: tabDataDir === undefined
-    ? join(resolveProductPaths().runtimeDir, "crashes")
-    : join(dirname(tabDataDir), "diagnostics"),
+  directory: join(resolveProductPaths().runtimeDir, "crashes"),
   ...(launchContext.releaseId === undefined ? {} : { releaseId: launchContext.releaseId }),
   dispose: () => runningApplication?.dispose(),
 }) : undefined;
@@ -49,21 +41,7 @@ const assertPiTuiIdentity = () => identity.assertSinglePiTuiModuleAtLaunch(
   (/** @type {string} */ message) => process.stderr.write(message),
 );
 
-if (utilityRoute !== null) {
-  if (profile !== "a1" || tabCredentials === undefined) throw new Error("utility tabs require the normal A1 tab profile");
-  await startup.markStartupPhase(process.env, "ui-entry");
-  assertPiTuiIdentity();
-  const utility = await import("../dist/composition/utility-tab.js");
-  await startup.markStartupPhase(process.env, "ui-modules-loaded");
-  const bridge = new (await import("../dist/foundation/resident-tabs/bridge-client.js")).TabBridgeClient({ credentials: tabCredentials });
-  completeRun(utility.runUtilityTab({
-    route: utilityRoute,
-    bridge,
-    cwd: process.cwd(),
-    profileId: profile,
-    onApplication: application => { runningApplication = application; },
-  }), utility.terminateOwnedUiProcess);
-} else {
+{
   const descriptor = await import("../dist/foundation/startup/startup-descriptor.js");
   // Performance: begin the exact Agent launch graph together while the trace write is pending.
   // Direct owned-module entries avoid evaluating unrelated barrel exports before first paint.
@@ -78,40 +56,21 @@ if (utilityRoute !== null) {
     { composeOwnedUi },
   ] = await modules;
 
-  if (tabStandby) await waitForStandbyPromotion(process.stdin, tabDataDir === undefined ? undefined : join(tabDataDir, "standby-promote"));
   assertPiTuiIdentity();
   await startup.markStartupPhase(process.env, "ui-modules-loaded");
 
-  const sessionSelection = parseSessionSelection(uiArguments);
+  const sessionSelection = parseSessionSelection(process.argv.slice(2));
   completeRun(Promise.resolve().then(async () => {
-    const tab = tabCredentials === undefined ? undefined : {
-      bridge: new (await import("../dist/foundation/resident-tabs/bridge-client.js")).TabBridgeClient({ credentials: tabCredentials }),
-      dataDir: /** @type {string} */ (tabDataDir),
-      incarnation: /** @type {number} */ (tabIncarnation),
-    };
     if (sessionSelection && profile !== "a1") throw new Error("session selection requires the normal A1 profile");
     return runSelectedInteractiveRuntime(profile, {
-      ownedUi: async (profileId, ownedSurfaces) => {
-        const processInspector = ownedSurfaces
-          ? await import("../dist/foundation/process-containment/native-process-inspector.js")
-            .then(module => module.createNativeProcessInspector(process.env, process.platform, launchContext.releaseRoot))
-            .catch(() => null)
-          : null;
+      ownedUi: async (profileId, productMode) => {
         const { application, settings } = await composeOwnedUi({
           cwd: process.cwd(),
           profileId,
-          ownedSurfaces,
-          notificationVersion: launchContext.updateVersion,
-          ...(hidesTabSettings(launchContext) ? { hideTabSettings: true } : {}),
-          soloResumeHint: profile === "a1" && launchContext.launchMode === "solo",
-          ...(processInspector === null ? {} : { inspectProcess: pid => processInspector.observe(pid) }),
-          projectTrustPrompt: createConsoleProjectTrustPrompt({ presentation: profile === "a1" ? "bare" : "comparison" }),
+          productMode,
+          projectTrustPrompt: createConsoleProjectTrustPrompt({ productMode }),
           sessionForkPrompt: createConsoleSessionForkPrompt(),
           ...(sessionSelection === undefined ? {} : { sessionSelection }),
-          ...(tab === undefined ? {} : { tab }),
-          ...(launchContext.residentFallback === undefined ? {} : {
-            residentFallbackNotice: formatResidentFallbackNotice(launchContext.residentFallback),
-          }),
         });
         runningApplication = application;
         return await runOwnedUi({ application, ...(settings === null ? {} : { settings }) });

package/dist/app/session-shell/clipboard-diagnostics.d.ts

@@ -1,4 +1,4 @@
-import type { PiTuiInputDiagnosticsEvent } from "../../integrations/pi/tui-runtime/contracts.js";
+import type { TerminalInputDiagnosticsEvent } from "../../contracts/presentation/index.js";
 import type { ResponseCopyEvent } from "./response-copy-protocol.js";
 import type { PasteEvent } from "./paste-protocol.js";
 /** Opt-in scalar-only snapshots, bounded to 128 rows and one pending asynchronous write. */
@@ -9,7 +9,7 @@ export declare class ClipboardDiagnosticCapture {
     constructor(destination: string, write?: (file: string, data: string) => Promise<void>);
     copy(event: ResponseCopyEvent): void;
     paste(event: PasteEvent): void;
-    runtime(event: PiTuiInputDiagnosticsEvent): void;
+    runtime(event: TerminalInputDiagnosticsEvent): void;
     /** Explicit test/evidence boundary; the interactive UI never waits for disk diagnostics. */
     flush(): Promise<void>;
     dispose(): void;

package/dist/app/session-shell/clipboard-image.d.ts

@@ -8,4 +8,3 @@ export interface ClipboardImageData {
  * that Node's permissive base64 decoder would otherwise partially accept.
  */
 export declare function canonicalizeClipboardImage(image: ClipboardImageData, source?: boolean): ClipboardImageData | null;
-export declare function canonicalizeStandardBase64(value: string, source?: boolean): string | null;

package/dist/app/session-shell/clipboard-image.js

@@ -10,7 +10,7 @@ export function canonicalizeClipboardImage(image, source = false) {
     const data = canonicalizeStandardBase64(image.data, source);
     return data === null ? null : { data, mimeType: image.mimeType };
 }
-export function canonicalizeStandardBase64(value, source = false) {
+function canonicalizeStandardBase64(value, source = false) {
     if (typeof value !== "string" || value.length === 0)
         return null;
     const maximum = source ? Math.ceil(MAX_SOURCE_IMAGE_BYTES / 3) * 4 : MAX_IMAGE_DATA_BYTES;

package/dist/app/session-shell/dialog-coordinator.d.ts

@@ -1,14 +1,15 @@
+import type { OwnedUiShellComponents, OwnedUiShellSelectorOption } from "../../contracts/owned-ui/index.js";
+import type { TerminalOverlayHandle } from "../../contracts/presentation/index.js";
 import type { OwnedUiCommandResult, OwnedUiDialog } from "../../contracts/owned-ui/index.js";
 import type { UiRouteHost, UiRouteInput } from "../../ui/apps/contracts.js";
-import type { PiShellSelectorOption } from "../../integrations/pi/components/shell-shared-facade.js";
-import type { PiTuiOverlayHandle } from "../../integrations/pi/tui-runtime/contracts.js";
 import type { OwnedUiPresenterTerminal } from "./shell-host.js";
 import type { OwnedUiSessionShellOptions, OwnedUiSessionShellRoot } from "./session-shell-root.js";
 type StartupRoute = NonNullable<OwnedUiSessionShellOptions["engine"]["startupRoute"]>;
-export interface SessionDialogPorts {
+interface SessionDialogPorts {
     readonly terminal: Pick<OwnedUiPresenterTerminal, "running" | "hasOverlay" | "showOverlay" | "openRoute" | "requestRender">;
-    readonly root: Pick<OwnedUiSessionShellRoot, "dismissNotice" | "setInputSurface" | "usesDefaultInputSurface">;
+    readonly root: Pick<OwnedUiSessionShellRoot, "chrome" | "setInputSurface" | "usesDefaultInputSurface">;
     readonly routeHost: UiRouteHost | null;
+    readonly dialogs: Pick<OwnedUiShellComponents["dialogs"], "dialog" | "selector">;
     readonly disposed: () => boolean;
     /** A route, or the interrupt chord over it, asked to leave A1. */
     readonly exit: () => void;
@@ -26,7 +27,7 @@ export declare class SessionDialogCoordinator {
     constructor(ports: SessionDialogPorts);
     /** Clears the replacement input surface a selector put in the dock; the shared close action of every dock selector. */
     readonly closeInputSurface: () => void;
-    showSelector(title: string, options: readonly PiShellSelectorOption[], onSelect: (id: string) => void, onCancel?: () => void): PiTuiOverlayHandle;
+    showSelector(title: string, options: readonly OwnedUiShellSelectorOption[], onSelect: (id: string) => void, onCancel?: () => void): TerminalOverlayHandle;
     /** Mirrors the backend's pending dialog; locally owned routes and selectors are left alone when it has none. */
     syncBackend(dialog: OwnedUiDialog | null): void;
     openRoute(route: string, input?: UiRouteInput, onClosed?: () => void | Promise<void>): OwnedUiCommandResult;

package/dist/app/session-shell/dialog-coordinator.js

@@ -1,4 +1,3 @@
-import { createPiShellDialog, createPiShellSelector } from "../../integrations/pi/components/shell-selectors-dialogs.js";
 const OVERLAY_OPTIONS = { width: "70%", maxHeight: "80%", anchor: "center", inputCoordination: "owned" };
 const STARTUP_ROUTE_RETRY_MS = 25;
 /**
@@ -26,7 +25,7 @@ export class SessionDialogCoordinator {
         this.#handle?.hide();
         this.#source = "local";
         this.#id = undefined;
-        const component = createPiShellSelector({
+        const component = this.#ports.dialogs.selector({
             title,
             options,
             onSelect: id => {
@@ -57,7 +56,7 @@ export class SessionDialogCoordinator {
             return;
         this.#handle?.hide();
         this.#source = "backend";
-        const component = createPiShellDialog(dialog, { onSelect: () => this.#close(), onCancel: () => this.#close() });
+        const component = this.#ports.dialogs.dialog(dialog, { onSelect: () => this.#close(), onCancel: () => this.#close() });
         this.#handle = this.#ports.terminal.showOverlay(component, OVERLAY_OPTIONS);
         this.#id = dialog.id;
     }
@@ -67,7 +66,7 @@ export class SessionDialogCoordinator {
             return { outcome: "failed", diagnostic: `route is unavailable: ${route}` };
         if (!this.#ports.terminal.running)
             return { outcome: "failed", diagnostic: "runtime is not active" };
-        this.#ports.root.dismissNotice();
+        this.#ports.root.chrome.dismissNotice();
         this.#handle?.hide();
         this.#source = "route";
         const handle = this.#ports.terminal.openRoute(surface, {

package/dist/app/session-shell/dock-chrome.d.ts

@@ -1,13 +1,17 @@
-import type { ImageAttachmentError, OwnedUiSessionViewModel } from "../../contracts/owned-ui/index.js";
+import type { ImageAttachmentError, OwnedUiSessionViewModel, OwnedUiShellComponents, OwnedUiShellReleaseUpdateBanner } from "../../contracts/owned-ui/index.js";
+import type { ThemeSource } from "../../contracts/presentation/index.js";
 import type { TranscriptViewportFrame } from "../../ui/components/transcript-viewport.js";
-import { type PiShellReleaseUpdateBanner } from "../../integrations/pi/components/shell-presenters-info.js";
 import type { SessionViewportController } from "./session-viewport-controller.js";
-export interface DockNotice {
+interface DockNotice {
     readonly kind: "status" | "warning" | "error" | "new-session";
     readonly message: string;
     readonly errorCode?: ImageAttachmentError["code"];
 }
-export interface DockChromePorts {
+interface DockChromePorts {
+    readonly theme: ThemeSource;
+    readonly components: Pick<OwnedUiShellComponents, "chrome" | "info" | "text">;
+    /** Columns the pinned layout pads command output with. */
+    readonly outputPad: 0 | 1;
     /** Chrome changed; the root invalidates its chrome components. */
     readonly invalidateChrome: () => void;
     readonly requestRender: () => void;
@@ -30,6 +34,7 @@ export declare class DockChrome {
     clearCopyAcknowledgement(requestRender: boolean): void;
     renderCopyAcknowledgement(width: number): string | undefined;
     renderPromptOverlay(diagnostics: OwnedUiSessionViewModel["diagnostics"], width: number): string | undefined;
-    renderReleaseBanner(diagnostics: OwnedUiSessionViewModel["diagnostics"], width: number): PiShellReleaseUpdateBanner | undefined;
-    locateReleaseClose(frame: TranscriptViewportFrame, banner: PiShellReleaseUpdateBanner | undefined, tailEnd: number, tailLength: number): void;
+    renderReleaseBanner(diagnostics: OwnedUiSessionViewModel["diagnostics"], width: number): OwnedUiShellReleaseUpdateBanner | undefined;
+    locateReleaseClose(frame: TranscriptViewportFrame, banner: OwnedUiShellReleaseUpdateBanner | undefined, tailEnd: number, tailLength: number): void;
 }
+export {};

package/dist/app/session-shell/dock-chrome.js

@@ -1,7 +1,4 @@
 import { COPY_ACKNOWLEDGEMENT_DURATION_MS } from "../../ui/components/selection-copy.js";
-import { renderPiShellCommandMessage, renderPiShellReleaseUpdateBanner, renderPiShellStatusText, } from "../../integrations/pi/components/shell-presenters-info.js";
-import { PINNED_PI_LAYOUT, piTheme } from "../../integrations/pi/components/upstream/theme/theme.js";
-import { piShellTruncateToWidth, renderPiShellInstalledUpdateStatus } from "../../integrations/pi/components/shell-shared-facade.js";
 import { parseReleaseUpdateDiagnostic } from "./transcript-document.js";
 /**
  * The transient chrome around bare A1's dock: the one command notice above the editor, the release
@@ -41,9 +38,9 @@ export class DockChrome {
             return [];
         if (notice.kind === "status") {
             // Compatibility: Pi pads its status text by one cell regardless of the output pad setting.
-            return ["", ...renderPiShellStatusText(notice.message, width, PINNED_PI_LAYOUT.outputPad)];
+            return ["", ...this.#ports.components.info.statusText(notice.message, width, this.#ports.outputPad)];
         }
-        return renderPiShellCommandMessage({
+        return this.#ports.components.info.commandMessage({
             kind: notice.kind === "new-session" ? "accent" : notice.kind,
             message: notice.message,
         }, width, outputPad);
@@ -78,14 +75,14 @@ export class DockChrome {
     renderCopyAcknowledgement(width) {
         if (this.#copyAcknowledgement === undefined || width <= 0)
             return undefined;
-        return piTheme().fg("accent", piShellTruncateToWidth(this.#copyAcknowledgement, width));
+        return this.#ports.theme.current().fg("accent", this.#ports.components.text.truncateToWidth(this.#copyAcknowledgement, width));
     }
     renderPromptOverlay(diagnostics, width) {
         const acknowledgement = this.renderCopyAcknowledgement(width);
         if (acknowledgement !== undefined)
             return acknowledgement;
         if (diagnostics.some(diagnostic => diagnostic.code === "release-update-installed")) {
-            return renderPiShellInstalledUpdateStatus(width) || undefined;
+            return this.#ports.components.chrome.installedUpdateStatus(width) || undefined;
         }
         return undefined;
     }
@@ -96,7 +93,7 @@ export class DockChrome {
         const release = diagnostic === undefined ? null : parseReleaseUpdateDiagnostic(diagnostic.message);
         if (release === null)
             return undefined;
-        return renderPiShellReleaseUpdateBanner(release, width, this.#ports.viewport.tailControlHovered(this.#releaseCloseTarget));
+        return this.#ports.components.chrome.releaseUpdateBanner(release, width, this.#ports.viewport.tailControlHovered(this.#releaseCloseTarget));
     }
     locateReleaseClose(frame, banner, tailEnd, tailLength) {
         // Invariant: the tail is the document suffix, so the control's document row is fixed relative to its

package/dist/app/session-shell/editor-hyperlink-budget.d.ts

@@ -1,5 +1,3 @@
-/** Aggregate explicit URL-chip metadata allowance for one owned editor decoration pass. */
-export declare const EDITOR_HYPERLINK_METADATA_BYTES: number;
 /** Accounts complete OSC 8 controls before construction, without scanning oversized backing URLs. */
 export declare class EditorHyperlinkBudget {
     #private;

package/dist/app/session-shell/editor-hyperlink-budget.js

@@ -1,5 +1,5 @@
 /** Aggregate explicit URL-chip metadata allowance for one owned editor decoration pass. */
-export const EDITOR_HYPERLINK_METADATA_BYTES = 64 * 1024;
+const EDITOR_HYPERLINK_METADATA_BYTES = 64 * 1024;
 const CLOSE_BYTES = 7;
 const PAIR_BYTES = CLOSE_BYTES * 2;
 /** Accounts complete OSC 8 controls before construction, without scanning oversized backing URLs. */

package/dist/app/session-shell/exit-notice.d.ts

@@ -10,9 +10,9 @@ export interface ExitNoticeSource {
         }) => void): () => void;
     };
 }
-export interface ArmedExitNotice {
+interface ArmedExitNotice {
     clear(): void;
 }
-export declare function uncleanExitNoticeLines(resume: SessionResumeCommandMetadata | null, soloResumeHint?: boolean): string[];
 /** Arms the notice and keeps its resume command following the bound session until cleared. */
-export declare function armExitNotice(source: ExitNoticeSource, path: string, soloResumeHint?: boolean): ArmedExitNotice;
+export declare function armExitNotice(source: ExitNoticeSource, path: string): ArmedExitNotice;
+export {};

package/dist/app/session-shell/exit-notice.js

@@ -1,32 +1,32 @@
 /**
- * The runtime's half of the unclean-exit protocol with the native process guardian. While the
- * notice is armed, the guardian treats the runtime's end as unclean: it restores the terminal and
- * prints these lines, so a killed session still leaves its resume command behind. A clean shutdown
- * clears the notice after the terminal is restored.
+ * The runtime's half of the unclean-exit protocol with the launcher. While the notice is armed,
+ * the launcher treats the runtime's end as unclean: it restores the terminal and prints these
+ * lines, so a killed session still leaves its resume command behind. A clean shutdown clears the
+ * notice after the terminal is restored.
  */
 import { renameSync, rmSync, writeFileSync } from "node:fs";
 import { PRODUCT_IDENTITY } from "../../product-identity.js";
 import { formatSessionResumeCommand } from "./session-lifecycle.js";
-export function uncleanExitNoticeLines(resume, soloResumeHint = false) {
+function uncleanExitNoticeLines(resume) {
     return [
         `${PRODUCT_IDENTITY.displayName} was stopped unexpectedly.`,
-        ...(resume === null ? [] : [`To resume this session: ${formatSessionResumeCommand(resume, soloResumeHint)}`]),
+        ...(resume === null ? [] : [`To resume this session: ${formatSessionResumeCommand(resume)}`]),
     ];
 }
 /** Arms the notice and keeps its resume command following the bound session until cleared. */
-export function armExitNotice(source, path, soloResumeHint = false) {
+export function armExitNotice(source, path) {
     let current = null;
     let cleared = false;
     let generation = source.identity.sessionGeneration;
     const write = () => {
         if (cleared)
             return;
-        // Protocol: plain text only; the guardian strips control characters, so styling would be lost.
-        const text = `${uncleanExitNoticeLines(source.identity.currentSessionResumeMetadata(), soloResumeHint).join("\n")}\n`;
+        // Protocol: plain text only; the launcher strips control characters, so styling would be lost.
+        const text = `${uncleanExitNoticeLines(source.identity.currentSessionResumeMetadata()).join("\n")}\n`;
         if (text === current)
             return;
         try {
-            // Invariant: the guardian may read at any instant, so it sees the previous or the next notice, never half of one.
+            // Invariant: the launcher may read at any instant, so it sees the previous or the next notice, never half of one.
             const temporary = `${path}.${process.pid}.tmp`;
             writeFileSync(temporary, text, { mode: 0o600 });
             renameSync(temporary, path);

package/dist/app/session-shell/extension-surface.d.ts

@@ -1,6 +1,6 @@
+import type { OwnedUiShellComponentPort } from "../../contracts/owned-ui/index.js";
 import type { OwnedUiSessionViewModel } from "../../contracts/owned-ui/index.js";
-import type { PiShellComponentPort } from "../../integrations/pi/components/shell-shared-facade.js";
-export type ExtensionWidgetPlacement = "aboveEditor" | "belowEditor";
+type ExtensionWidgetPlacement = "aboveEditor" | "belowEditor";
 /**
  * What extensions draw into the shell: a header that replaces the built-in one, a footer, widgets
  * above and below the editor, footer statuses, and a working message. It owns those components and
@@ -8,15 +8,15 @@ export type ExtensionWidgetPlacement = "aboveEditor" | "belowEditor";
  */
 export declare class ExtensionSurface {
     #private;
-    get header(): PiShellComponentPort | null;
-    get footer(): PiShellComponentPort | null;
+    get header(): OwnedUiShellComponentPort | null;
+    get footer(): OwnedUiShellComponentPort | null;
     get working(): {
         readonly message: string | undefined;
         readonly visible: boolean;
     };
-    placeWidget(key: string, component: PiShellComponentPort | null, placement: ExtensionWidgetPlacement): void;
-    replaceHeader(component: PiShellComponentPort | null): void;
-    replaceFooter(component: PiShellComponentPort | null): void;
+    placeWidget(key: string, component: OwnedUiShellComponentPort | null, placement: ExtensionWidgetPlacement): void;
+    replaceHeader(component: OwnedUiShellComponentPort | null): void;
+    replaceFooter(component: OwnedUiShellComponentPort | null): void;
     setStatus(key: string, text: string | undefined): void;
     setWorking(message: string | undefined, visible: boolean): void;
     statuses(): Map<string, string>;
@@ -28,3 +28,4 @@ export declare class ExtensionSurface {
     reset(): void;
     dispose(): void;
 }
+export {};

package/dist/app/session-shell/helper-pool.d.ts

@@ -1,12 +1,10 @@
 import type { ChildProcess } from "node:child_process";
-/** How long an unused spare helper may idle before it is stopped so a background session holds no extra process. */
-export declare const HELPER_SPARE_IDLE_MS: number;
-export interface SpareHelper {
+interface SpareHelper {
     readonly child: ChildProcess;
     /** Whether the helper already announced itself; the taker must then send the first request itself. */
     readonly ready: boolean;
 }
-export interface HelperPoolOptions {
+interface HelperPoolOptions {
     readonly fork: () => ChildProcess;
     /** Stops a spare that is no longer wanted; the paste helper needs its process group killed on POSIX. */
     readonly stop: (child: ChildProcess) => void;
@@ -29,3 +27,4 @@ export declare class HelperPool {
     /** Stops the held spare and refuses further warming. */
     dispose(): void;
 }
+export {};

package/dist/app/session-shell/helper-pool.js

@@ -1,5 +1,5 @@
 /** How long an unused spare helper may idle before it is stopped so a background session holds no extra process. */
-export const HELPER_SPARE_IDLE_MS = 5 * 60_000;
+const HELPER_SPARE_IDLE_MS = 5 * 60_000;
 /** Holds one idle IPC helper; requests take it, and exits, expiry, or use trigger replacement. */
 export class HelperPool {
     #fork;

package/dist/app/session-shell/image-preparation-client.d.ts

@@ -1,7 +1,7 @@
-import type { PiShellClipboardContent } from "../../integrations/pi/components/index.js";
+import type { OwnedUiShellClipboardContent } from "../../contracts/owned-ui/index.js";
 import type { ImagePreparationLimits, PreparedImage } from "./image-preparation.js";
 import type { ImageWorkerRequest } from "./image-worker.js";
-export type PreparedClipboardContent = {
+type PreparedClipboardContent = {
     readonly kind: "text";
     readonly text: string;
 } | ({
@@ -14,7 +14,8 @@ export interface ImagePasteJob {
 /** Owns bounded paste acquisition and one off-thread conversion, canceled on session disposal. */
 export declare class ImagePreparationClient {
     #private;
-    start(read?: (signal: AbortSignal) => Promise<PiShellClipboardContent | null>, limits?: ImagePreparationLimits): ImagePasteJob;
+    start(read?: (signal: AbortSignal) => Promise<OwnedUiShellClipboardContent | null>, limits?: ImagePreparationLimits): ImagePasteJob;
     dispose(): Promise<void>;
 }
 export declare function runImageWorker<T>(request: ImageWorkerRequest, signal: AbortSignal): Promise<T>;
+export {};

package/dist/app/session-shell/image-preparation.d.ts

@@ -10,8 +10,6 @@ export interface PreparedImage {
     readonly height: number;
     readonly transformed: boolean;
 }
-export declare const IMAGE_TARGET_BASE64_BYTES: number;
-export declare const IMAGE_TARGET_DECODED_BYTES: number;
 export declare function prepareImage(source: {
     readonly data: string;
     readonly mimeType: string;

package/dist/app/session-shell/image-preparation.js

@@ -2,8 +2,8 @@ import { isMainThread } from "node:worker_threads";
 import { ImageAttachmentError } from "../../contracts/owned-ui/index.js";
 import { canonicalizeClipboardImage } from "./clipboard-image.js";
 import { sourceImageInfo } from "./image-source.js";
-export const IMAGE_TARGET_BASE64_BYTES = 4.5 * 1024 * 1024;
-export const IMAGE_TARGET_DECODED_BYTES = 5 * 1024 * 1024;
+const IMAGE_TARGET_BASE64_BYTES = 4.5 * 1024 * 1024;
+const IMAGE_TARGET_DECODED_BYTES = 5 * 1024 * 1024;
 export async function prepareImage(source, limits = {}) {
     // Performance: an async signature does not move synchronous WASM work off the interactive thread.
     if (isMainThread)

package/dist/app/session-shell/image-source.d.ts

@@ -1,8 +1,6 @@
 export declare const MAX_SOURCE_IMAGE_BYTES: number;
-export declare const MAX_SOURCE_PIXELS = 40000000;
-export declare const MAX_SOURCE_DIMENSION = 32768;
 export declare const IMAGE_PREPARATION_MS = 15000;
-export interface ImageSourceInfo {
+interface ImageSourceInfo {
     readonly width: number;
     readonly height: number;
     readonly mimeType: string;
@@ -11,3 +9,4 @@ export interface ImageSourceInfo {
 }
 export declare function assertSourceBytes(length: number): void;
 export declare function sourceImageInfo(bytes: Uint8Array, mimeType: string): ImageSourceInfo;
+export {};

package/dist/app/session-shell/image-source.js

@@ -1,7 +1,7 @@
 import { ImageAttachmentError } from "../../contracts/owned-ui/index.js";
 export const MAX_SOURCE_IMAGE_BYTES = 20 * 1024 * 1024;
-export const MAX_SOURCE_PIXELS = 40_000_000;
-export const MAX_SOURCE_DIMENSION = 32_768;
+const MAX_SOURCE_PIXELS = 40_000_000;
+const MAX_SOURCE_DIMENSION = 32_768;
 export const IMAGE_PREPARATION_MS = 15_000;
 export function assertSourceBytes(length) {
     if (length > MAX_SOURCE_IMAGE_BYTES)