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

package/dist/app/session-shell/shell-layout.d.ts

@@ -1,6 +1,6 @@
+import type { OwnedUiShellEditorPort } from "../../contracts/owned-ui/index.js";
 import type { OwnedUiSessionViewModel } from "../../contracts/owned-ui/index.js";
 import type { TranscriptViewportFrame, TranscriptViewportFrameInput, TranscriptViewportTheme } from "../../ui/components/transcript-viewport.js";
-import type { PiShellEditorPort } from "../../integrations/pi/components/shell-shared-facade.js";
 import type { DockChrome } from "./dock-chrome.js";
 import type { InputSurfaceSwitch } from "./input-surface-switch.js";
 import type { PromptChipStore } from "./prompt-chips.js";
@@ -20,7 +20,7 @@ export interface DockLayout {
 export interface ShellLayoutPorts {
     readonly viewport: SessionViewportController;
     readonly input: InputSurfaceSwitch;
-    readonly editor: Pick<PiShellEditorPort, "getText">;
+    readonly editor: Pick<OwnedUiShellEditorPort, "getText">;
     readonly promptChips: Pick<PromptChipStore, "atomicRanges">;
     readonly dockChrome: Pick<DockChrome, "renderPromptOverlay" | "renderReleaseBanner" | "locateReleaseClose">;
     readonly theme: TranscriptViewportTheme;

package/dist/app/session-shell/shell-prompt-suggestions.d.ts

@@ -0,0 +1,26 @@
+import type { OwnedUiEvent, OwnedUiSessionViewModel, SuggestionDecision } from "../../contracts/owned-ui/index.js";
+import { type ContextualPromptSuggestionSurface } from "./prompt-suggestion-controller.js";
+import type { SessionConcern } from "./session-concern.js";
+import type { OwnedUiShellSuggestionOptions } from "./session-shell-root.js";
+type ResponseEvent = Extract<OwnedUiEvent, {
+    readonly type: "assistant-message-completed" | "agent-run-settled";
+}>;
+/**
+ * One shell's contextual prompt suggestions: the controller, its live enablement, and the model key that
+ * invalidates a pending suggestion. Without suggestion options every call is a no-op.
+ */
+export declare class ShellPromptSuggestions implements SessionConcern {
+    #private;
+    constructor(options: OwnedUiShellSuggestionOptions | undefined, surface: ContextualPromptSuggestionSurface, view: OwnedUiSessionViewModel);
+    invalidate(): void;
+    abortPending(): void;
+    accept(): void;
+    restoreAvailable(): void;
+    /** Hands a completed or settled response to the controller. */
+    route(event: ResponseEvent, prepareBlockReason: () => SuggestionDecision): void;
+    /** Invalidates a pending suggestion when the session was replaced or the active model changed. */
+    noteView(view: OwnedUiSessionViewModel, sessionReplaced: boolean): void;
+    onSessionReplaced(): void;
+    dispose(): void;
+}
+export {};

package/dist/app/session-shell/shell-prompt-suggestions.js

@@ -0,0 +1,48 @@
+import { ContextualPromptSuggestionController } from "./prompt-suggestion-controller.js";
+import { routeResponseToSuggestions, suggestionModelKey } from "./suggestion-surface.js";
+/**
+ * One shell's contextual prompt suggestions: the controller, its live enablement, and the model key that
+ * invalidates a pending suggestion. Without suggestion options every call is a no-op.
+ */
+export class ShellPromptSuggestions {
+    #controller;
+    #unsubscribe;
+    #modelKey;
+    constructor(options, surface, view) {
+        this.#modelKey = suggestionModelKey(view);
+        this.#controller = options === undefined ? null : new ContextualPromptSuggestionController({
+            generator: options.generator,
+            enabled: options.enabled(),
+            ...(options.diagnostics === undefined ? {} : { diagnostics: options.diagnostics }),
+            surface,
+        });
+        try {
+            this.#unsubscribe = options === undefined ? () => { } : options.onChange(enabled => this.#controller?.setEnabled(enabled));
+        }
+        catch (error) {
+            this.#controller?.dispose();
+            throw error;
+        }
+    }
+    invalidate() { this.#controller?.invalidate(); }
+    abortPending() { this.#controller?.abortPending(); }
+    accept() { this.#controller?.accept(); }
+    restoreAvailable() { this.#controller?.restoreAvailable(); }
+    /** Hands a completed or settled response to the controller. */
+    route(event, prepareBlockReason) {
+        routeResponseToSuggestions(this.#controller, event, prepareBlockReason);
+    }
+    /** Invalidates a pending suggestion when the session was replaced or the active model changed. */
+    noteView(view, sessionReplaced) {
+        const key = suggestionModelKey(view);
+        if (!sessionReplaced && key === this.#modelKey)
+            return;
+        this.#controller?.invalidate();
+        this.#modelKey = key;
+    }
+    onSessionReplaced() { this.invalidate(); }
+    dispose() {
+        this.#controller?.dispose();
+        this.#unsubscribe();
+    }
+}

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

@@ -6,14 +6,9 @@ type ResponseEvent = Extract<OwnedUiEvent, {
 }>;
 /** The provider/model key a suggestion identity and the session view are compared by; empty without a model. */
 export declare function suggestionModelKey(view: Pick<OwnedUiSessionViewModel, "activeModel">): string;
-/**
- * Why a completed response cannot seed a suggestion, checked in order; `prepareBlockReason` is asked
- * only when the response itself qualifies.
- */
-export declare function responseSuggestionDecision(event: ResponseEvent, prepareBlockReason: () => SuggestionDecision): SuggestionDecision;
 /** Hands one completed or settled response to the controller: skipped without a model, otherwise considered or settled. */
 export declare function routeResponseToSuggestions(controller: Pick<ContextualPromptSuggestionController, "skip" | "consider" | "settle"> | null, event: ResponseEvent, prepareBlockReason: () => SuggestionDecision): void;
-export interface SuggestionPresentationState {
+interface SuggestionPresentationState {
     readonly disposed: boolean;
     readonly view: Pick<OwnedUiSessionViewModel, "sessionId" | "activeModel">;
     readonly sessionGeneration: number;

package/dist/app/session-shell/suggestion-surface.js

@@ -6,7 +6,7 @@ export function suggestionModelKey(view) {
  * Why a completed response cannot seed a suggestion, checked in order; `prepareBlockReason` is asked
  * only when the response itself qualifies.
  */
-export function responseSuggestionDecision(event, prepareBlockReason) {
+function responseSuggestionDecision(event, prepareBlockReason) {
     if (!event.successful)
         return "failed-response";
     if (event.toolContinuation || event.stopReason === "toolUse")

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

@@ -1,20 +1,8 @@
-import type { PiShellClipboardContent } from "../../integrations/pi/components/shell-shared-facade.js";
-export interface SystemClipboardImageReader {
-    hasImage(): boolean;
-    getImageBinary?(): Promise<readonly number[]>;
-    getImageBase64?(): Promise<string>;
-}
-/** Load the native adapter during shell startup so the first paste is warm. */
-export declare function preloadSystemClipboard(): void;
+import type { OwnedUiShellClipboardContent } from "../../contracts/owned-ui/index.js";
 /**
  * Reads plain text through platform clipboard commands without importing Pi's
  * private clipboard module. Failures are deliberately non-fatal: a denied or
  * unavailable clipboard simply makes the paste action a no-op.
  */
-export declare function readSystemClipboardContent(signal?: AbortSignal, strict?: boolean): Promise<PiShellClipboardContent | null>;
-export declare function readSystemClipboardImage(reader: SystemClipboardImageReader): Promise<{
-    readonly data: string;
-    readonly mimeType: string;
-} | null>;
-export declare function readSystemClipboardText(signal?: AbortSignal, strict?: boolean): Promise<string | null>;
+export declare function readSystemClipboardContent(signal?: AbortSignal, strict?: boolean): Promise<OwnedUiShellClipboardContent | null>;
 export declare function writeSystemClipboardText(text: string): Promise<void>;

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

@@ -5,11 +5,6 @@ import { assertSourceBytes } from "./image-source.js";
 const MAX_CLIPBOARD_BYTES = 16 * 1024 * 1024;
 let nativeClipboardPromise;
 let pendingClipboardWrite = Promise.resolve();
-/** Load the native adapter during shell startup so the first paste is warm. */
-export function preloadSystemClipboard() {
-    if (process.platform === "win32" || process.platform === "darwin")
-        void nativeClipboard();
-}
 /**
  * Reads plain text through platform clipboard commands without importing Pi's
  * private clipboard module. Failures are deliberately non-fatal: a denied or
@@ -38,7 +33,7 @@ export async function readSystemClipboardContent(signal, strict = false) {
     const text = await readSystemClipboardText(signal, strict);
     return text === null ? null : { kind: "text", text };
 }
-export async function readSystemClipboardImage(reader) {
+async function readSystemClipboardImage(reader) {
     if (!reader.hasImage())
         return null;
     if (reader.getImageBinary !== undefined) {
@@ -74,7 +69,7 @@ export async function readSystemClipboardImage(reader) {
     }
     return null;
 }
-export async function readSystemClipboardText(signal, strict = false) {
+async function readSystemClipboardText(signal, strict = false) {
     // Concurrency: Ctrl+C/Ctrl+X and Ctrl+V can arrive in adjacent input turns. Serialize the
     // read behind our native write so paste never observes the previous value.
     await pendingClipboardWrite;

package/dist/app/session-shell/transcript-document.d.ts

@@ -1,6 +1,7 @@
+import type { OwnedUiShellComponents, OwnedUiShellTranscriptComponentPort } from "../../contracts/owned-ui/index.js";
 import type { OwnedUiSessionViewModel } from "../../contracts/owned-ui/index.js";
+import type { ThemeSource } from "../../contracts/presentation/index.js";
 import type { TranscriptPromptAnchor } from "../../ui/components/transcript-viewport.js";
-import type { PiShellTranscriptComponentPort } from "../../integrations/pi/components/shell-shared-facade.js";
 type TranscriptBlock = OwnedUiSessionViewModel["transcript"][number];
 export interface TranscriptDocumentLayout {
     readonly rows: readonly string[];
@@ -13,7 +14,7 @@ export interface TranscriptDocumentLayout {
  */
 export type TranscriptInvalidation = "editor-padding" | "diagnostics" | "workflow-status" | "extension-header" | "viewport-config" | "extension-renderers" | "block-presentation" | "tools-expanded" | "repaint";
 /** What the document reads from the shell around it on every uncached layout. */
-export interface TranscriptDocumentChrome {
+interface TranscriptDocumentChrome {
     diagnostics(): OwnedUiSessionViewModel["diagnostics"];
     /** The extension header's rows when one is set, else the built-in header's rows for this layout. */
     headerRows(width: number): readonly string[];
@@ -23,11 +24,13 @@ export interface TranscriptDocumentChrome {
     hasExtensionHeader(): boolean;
     thinkingVisible(): boolean;
 }
-export interface TranscriptDocumentOptions {
+interface TranscriptDocumentOptions {
+    readonly theme: ThemeSource;
+    readonly components: Pick<OwnedUiShellComponents, "info" | "transcript">;
     readonly customViewport: boolean;
     readonly cwd: string;
     /** Creates the component for a newly seen block; its change callback should call `blockChanged`. */
-    mount(block: TranscriptBlock): PiShellTranscriptComponentPort;
+    mount(block: TranscriptBlock): OwnedUiShellTranscriptComponentPort;
     readonly chrome: TranscriptDocumentChrome;
 }
 /**
@@ -40,8 +43,8 @@ export declare class TranscriptDocument {
     /** Block component renders since construction, for rendering evidence. */
     get renderCount(): number;
     get lastId(): string | undefined;
-    component(id: string): PiShellTranscriptComponentPort | undefined;
-    components(): IterableIterator<PiShellTranscriptComponentPort>;
+    component(id: string): OwnedUiShellTranscriptComponentPort | undefined;
+    components(): IterableIterator<OwnedUiShellTranscriptComponentPort>;
     anchorOf(id: string): number | undefined;
     /**
      * Applies one block: its component is created or updated in place and the order grows
@@ -52,7 +55,7 @@ export declare class TranscriptDocument {
     /** Replaces the whole transcript with the view's blocks, keeping anchored workflow output in place. */
     sync(blocks: OwnedUiSessionViewModel["transcript"]): void;
     /** Appends workflow output anchored after the transcript's first `anchor` blocks. */
-    appendAnchored(id: string, component: PiShellTranscriptComponentPort, anchor: number): void;
+    appendAnchored(id: string, component: OwnedUiShellTranscriptComponentPort, anchor: number): void;
     /** Disposes every anchored workflow output and drops it from the order. */
     removeAnchored(): void;
     /** One block's component drew something new: drop its rows and every layout that contains them. */
@@ -73,5 +76,5 @@ export declare function parseReleaseUpdateDiagnostic(message: string): {
     changelogUrl: string | null;
 } | null;
 /** Web URLs use link blue; file targets retain A1's cyan interactive accent. */
-export declare function nativeTranscriptLinkColor(text: string, target: string): string;
+export declare function transcriptLinkColor(theme: ThemeSource): (text: string, target: string) => string;
 export {};

package/dist/app/session-shell/transcript-document.js

@@ -1,8 +1,5 @@
 import { acceptsTranscriptUpdate } from "../../contracts/owned-ui/index.js";
 import { nativeHyperlinkStyle } from "../../ui/components/spans.js";
-import { createPiShellChangelog, createPiShellCollapsedChangelog, renderPiShellPackageUpdateNotice, renderPiShellReleaseUpdateNotice, } from "../../integrations/pi/components/shell-presenters-info.js";
-import { isPiPromptStyleCompaction, renderPiShellStartupDiagnostic, renderPiShellTranscriptBlock, } from "../../integrations/pi/components/shell-presenters-transcript.js";
-import { piTheme } from "../../integrations/pi/components/upstream/theme/theme.js";
 const LAYOUT_ONLY = new Set(["editor-padding", "diagnostics", "workflow-status", "extension-header"]);
 const WORKFLOW_STATUS_PREFIX = "workflow-status-";
 /**
@@ -19,8 +16,10 @@ export class TranscriptDocument {
     // Performance: document layouts are shared by wheel, rail, jump, and selection frames.
     #layouts = new Map();
     #renders = 0;
+    #linkColor;
     constructor(options) {
         this.#options = options;
+        this.#linkColor = transcriptLinkColor(options.theme);
     }
     /** Block component renders since construction, for rendering evidence. */
     get renderCount() {
@@ -171,7 +170,7 @@ export class TranscriptDocument {
             // bare A1 presents them in its prompt-adjacent notice dock instead.
             .filter(diagnostic => diagnostic.code === "engine-startup"
             || !customViewport && diagnostic.code === "project-trust")
-            .flatMap(diagnostic => renderPiShellStartupDiagnostic(diagnostic, width));
+            .flatMap(diagnostic => this.#options.components.transcript.renderStartupDiagnostic(diagnostic, width));
         const resourceRows = [...chrome.resourceRows(width)];
         if (resourceRows.at(-1) === "")
             resourceRows.pop();
@@ -191,7 +190,7 @@ export class TranscriptDocument {
             if (!thinkingVisible && block?.kind === "thinking")
                 continue;
             const promptLike = block !== undefined
-                && (block.kind === "user" || customViewport && isPiPromptStyleCompaction(block));
+                && (block.kind === "user" || customViewport && this.#options.components.transcript.isPromptStyleCompaction(block));
             // Invariant: the custom viewport has already removed its rail gutter from this width.
             // Prompt-like and ordinary blocks therefore share one right content edge.
             const blockWidth = width;
@@ -240,11 +239,11 @@ export class TranscriptDocument {
             .filter(diagnostic => !customViewport && diagnostic.code === "release-update")
             .flatMap(diagnostic => {
             const release = parseReleaseUpdateDiagnostic(diagnostic.message);
-            return release === null ? [] : renderPiShellReleaseUpdateNotice(release, width);
+            return release === null ? [] : this.#options.components.info.releaseUpdateNotice(release, width);
         }));
         rows.push(...diagnostics
             .filter(diagnostic => diagnostic.code === "package-updates")
-            .flatMap(diagnostic => renderPiShellPackageUpdateNotice(diagnostic.message.split("\n").filter(line => line.startsWith("- ")).map(line => line.slice(2)), width)));
+            .flatMap(diagnostic => this.#options.components.info.packageUpdateNotice(diagnostic.message.split("\n").filter(line => line.startsWith("- ")).map(line => line.slice(2)), width)));
         rows.push(...diagnostics
             .filter(diagnostic => diagnostic.code === "changelog-collapsed" || diagnostic.code === "changelog-expanded")
             // Rationale: bare A1 translates either startup diagnostic into transient dock chrome;
@@ -252,8 +251,8 @@ export class TranscriptDocument {
             .flatMap(diagnostic => customViewport
             ? []
             : diagnostic.code === "changelog-collapsed"
-                ? createPiShellCollapsedChangelog().render(width)
-                : createPiShellChangelog(diagnostic.message).render(width)));
+                ? this.#options.components.info.collapsedChangelog().render(width)
+                : this.#options.components.info.changelog(diagnostic.message).render(width)));
         rows.push(...diagnostics
             .filter(diagnostic => diagnostic.code !== "engine-startup" && diagnostic.code !== "project-trust"
             && diagnostic.code !== "release-update" && diagnostic.code !== "release-update-installed"
@@ -261,7 +260,7 @@ export class TranscriptDocument {
             && diagnostic.code !== "package-updates" && diagnostic.code !== "changelog-collapsed"
             && diagnostic.code !== "changelog-expanded")
             .slice(-3)
-            .flatMap(diagnostic => renderPiShellTranscriptBlock({
+            .flatMap(diagnostic => this.#options.components.transcript.renderBlock({
             id: `diagnostic-${diagnostic.sequence}`,
             kind: diagnostic.severity === "error" ? "error" : "system",
             status: "finalized",
@@ -280,7 +279,7 @@ export class TranscriptDocument {
             const block = this.#blocks.get(id);
             if (block === undefined || (!thinkingVisible && block.kind === "thinking"))
                 continue;
-            if (rows.length > 0 && (block.kind === "user" || this.#options.customViewport && isPiPromptStyleCompaction(block)))
+            if (rows.length > 0 && (block.kind === "user" || this.#options.customViewport && this.#options.components.transcript.isPromptStyleCompaction(block)))
                 rows.push("");
             rows.push(...this.#blockRows(id, block, width).map(sanitizeExitTranscriptRow));
         }
@@ -298,7 +297,7 @@ export class TranscriptDocument {
             const rows = component.render(width);
             if (!this.#options.customViewport || block?.kind === "user")
                 return rows;
-            return rows.map(row => nativeHyperlinkStyle(row, nativeTranscriptLinkColor));
+            return rows.map(row => nativeHyperlinkStyle(row, this.#linkColor));
         };
         if (block === undefined || block.status !== "finalized")
             return render();
@@ -336,6 +335,6 @@ function sanitizeExitTranscriptRow(row) {
     return row.replace(KITTY_IMAGE_CONTROL, "").replace(ITERM_IMAGE_CONTROL, "");
 }
 /** Web URLs use link blue; file targets retain A1's cyan interactive accent. */
-export function nativeTranscriptLinkColor(text, target) {
-    return piTheme().fg(/^file:/iu.test(target) ? "accent" : "mdLink", text);
+export function transcriptLinkColor(theme) {
+    return (text, target) => theme.current().fg(/^file:/iu.test(target) ? "accent" : "mdLink", text);
 }

package/dist/app/session-shell/viewport-layout.d.ts

@@ -1,5 +1,5 @@
+import type { OwnedUiShellComponentPort } from "../../contracts/owned-ui/index.js";
 import type { TranscriptPromptAnchor, TranscriptViewportFrameInput } from "../../ui/components/transcript-viewport.js";
-import type { PiShellComponentPort } from "../../integrations/pi/components/shell-shared-facade.js";
 import type { ShellLayout, ShellLayoutPorts } from "./shell-layout.js";
 interface VisibleViewportSnapshot {
     readonly width: number;
@@ -8,7 +8,7 @@ interface VisibleViewportSnapshot {
     readonly transientSignature: string;
     readonly promptAnchors: readonly TranscriptPromptAnchor[];
     readonly dockLength: number;
-    readonly inputSurface: PiShellComponentPort;
+    readonly inputSurface: OwnedUiShellComponentPort;
     readonly viewportRevision: number;
     readonly selectionRevision: number;
     readonly pointerPosition: TranscriptViewportFrameInput["pointerPosition"];

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;