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

package/dist/app/session-shell/session-lifecycle.js

@@ -1,8 +1,6 @@
 import { PRODUCT_TEXT } from "../../product-identity.js";
-export function formatSessionResumeCommand(metadata, solo = false) {
+export function formatSessionResumeCommand(metadata) {
     const args = [PRODUCT_TEXT.commandName];
-    if (solo)
-        args.push("solo");
     if (!metadata.usesDefaultSessionDir)
         args.push("--session-dir", quoteCommandArgument(metadata.sessionDir));
     args.push("--session", metadata.sessionId);
@@ -20,7 +18,7 @@ export function quoteCommandArgument(value) {
 export function composeExitText(input) {
     if (input.terminalMode !== "fullscreen")
         return "";
-    const resumeHint = input.resume === null ? "" : `${dim("To resume this session:")} ${formatSessionResumeCommand(input.resume, input.soloResumeHint)}`;
+    const resumeHint = input.resume === null ? "" : `${dim("To resume this session:")} ${formatSessionResumeCommand(input.resume)}`;
     // Invariant: bare A1 leaves only the hint behind; the pinned comparison profile still
     // honors fullscreenExitOutput, including the styled transcript.
     if (input.customViewport || input.exitMode === "resume-hint")

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

@@ -1,31 +1,23 @@
-import { ImageAttachmentError } from "../../contracts/owned-ui/index.js";
-import type { OwnedUiBackgroundSettingsPort, OwnedUiPromptSuggestionGeneratorPort, OwnedUiSessionBackend, OwnedUiSessionPresenters, OwnedUiSessionViewModel, OwnedUiTranscriptRendererPort, OwnedUiWorkflowMessage, OwnedUiWorkflowResult, OwnedUiViewportSettings, OwnedUiViewportSettingsPort, OwnedUiQuitOutroSettingsPort, SuggestionDecision, SuggestionDiagnosticObserver } from "../../contracts/owned-ui/index.js";
-import type { PiTuiPointerSurface } from "../../integrations/pi/tui-runtime/contracts.js";
+import type { OwnedUiShellComponents, OwnedUiShellHotkeysPresentation, OwnedUiShellClipboardContent, OwnedUiShellComponentPort, OwnedUiShellEditorPort, OwnedUiShellHeaderOptions, OwnedUiShellHeaderPort, OwnedUiShellHistoryEditor, OwnedUiShellImageAssetResolver, OwnedUiShellKeybindingsHost, OwnedUiShellLoadedResourcesPort, OwnedUiShellResourceEntry } from "../../contracts/owned-ui/index.js";
+import type { TerminalComponentPort, TerminalInputCoordinationScheduler, TerminalInputDiagnosticsEvent, TerminalInputSurfaceKind, TerminalLayoutNode, TerminalPointerSurface, TerminalPort } from "../../contracts/presentation/index.js";
+import type { ShellPresentationPorts, ThemeSource } from "../../contracts/presentation/index.js";
+import type { OwnedUiBackgroundSettingsPort, OwnedUiPromptSuggestionGeneratorPort, OwnedUiSessionBackend, OwnedUiSessionPresenters, OwnedUiSessionViewModel, OwnedUiTranscriptRendererPort, OwnedUiViewportSettings, OwnedUiViewportSettingsPort, OwnedUiQuitOutroSettingsPort, SuggestionDecision, SuggestionDiagnosticObserver } from "../../contracts/owned-ui/index.js";
 import type { UiRouteHost, UiRouteInput } from "../../ui/apps/contracts.js";
 import type { TranscriptViewportFrame, TranscriptViewportFrameDescriptor } from "../../ui/components/transcript-viewport.js";
-import type { PiShellLazySelectorLoader } from "../../integrations/pi/components/lazy-selectors.js";
-import type { PiShellHotkeysPresentation } from "../../integrations/pi/components/shell-presenters-info.js";
-import { type PiShellClipboardContent, type PiShellComponentPort, type PiKeybindingsHost, type PiShellEditorPort, type PiShellHeaderOptions, type PiShellHeaderPort, type PiShellImageAssetResolver, type PiShellLoadedResourcesPort, type PiShellResourceEntry, type PiShellTranscriptComponentPort } from "../../integrations/pi/components/shell-shared-facade.js";
-import { type PiTuiInputCoordinationScheduler, type PiTuiInputSurfaceKind } from "../../integrations/pi/tui-runtime/input-presentation-coordinator.js";
-import type { PiTuiComponentPort, PiTuiInputDiagnosticsEvent, PiTuiLayoutNode, PiTuiTerminalPort } from "../../integrations/pi/tui-runtime/contracts.js";
 import { type PreparedPrompt } from "./prompt-chips.js";
 import type { PastePreparationClientOptions } from "./paste-preparation-client.js";
 import type { OwnedUiClipboardServices } from "./clipboard-services.js";
+import type { OwnedUiClipboardPort } from "./shell-clipboard.js";
 import { type SessionViewportInputResult } from "./session-viewport-controller.js";
 import type { ResponseCopyExecutor } from "./response-copy-transport.js";
 import type { ResponseCopyEvent } from "./response-copy-protocol.js";
 import type { PasteEvent, PasteSource } from "./paste-protocol.js";
+import { DockChrome } from "./dock-chrome.js";
+import { WorkflowOutput } from "./workflow-output.js";
+import { TranscriptDocument } from "./transcript-document.js";
 import type { StreamPresentationScheduler } from "./stream-presentation-coalescer.js";
-export type OwnedUiTerminalPort = PiTuiTerminalPort;
-type OwnedUiStartupOptions = PiShellHeaderOptions;
-export interface OwnedUiClipboardPort {
-    readText(signal?: AbortSignal): Promise<string | null>;
-    readImage?(signal?: AbortSignal): Promise<{
-        readonly data: string;
-        readonly mimeType: string;
-    } | null>;
-    writeText?(text: string, signal?: AbortSignal): Promise<void>;
-}
+type OwnedUiTerminalPort = TerminalPort;
+type OwnedUiStartupOptions = OwnedUiShellHeaderOptions;
 /** The engine session the shell presents and the composition's decisions about it. */
 export interface OwnedUiShellEngineOptions {
     readonly backend: OwnedUiSessionBackend;
@@ -43,38 +35,10 @@ export interface OwnedUiShellEngineOptions {
     };
     /** Bare A1 selects the owned bounded viewport; comparison profiles stay pinned. */
     readonly sessionLayout?: "pinned" | "custom-viewport";
-    /** Resident tab quit routes detach the outer client without stopping this engine session. */
-    readonly residentTab?: {
-        requestDetach(): Promise<boolean>;
-        closeOwnedRoute?(route: string): void;
-        reportStatus?(status: "working" | "idle"): void;
-        admit?(input: {
-            readonly sessionId: string;
-            readonly sessionFile: string | null;
-            readonly kind: "prompt" | "steer" | "follow-up";
-            readonly text: string;
-        }): Promise<{
-            readonly id: string;
-        }>;
-        dispatched?(): void;
-        correlated?(submissionId: string, entryId: string): Promise<void>;
-        checkpoint?(text: string): void;
-        gracefulStop?(sessionFile: string | null): Promise<void>;
-        readonly recovered?: {
-            readonly prompts: readonly {
-                readonly id: string;
-                readonly text: string;
-            }[];
-            readonly draft: string | null;
-        };
-        readonly unavailableNotice?: string;
-    };
 }
 /** Terminal, startup, viewport, and presentation-cadence seams; production leaves most at their defaults. */
 export interface OwnedUiShellPresentationOptions {
     readonly terminal?: OwnedUiTerminalPort;
-    /** Explicit direct solo launch, not a resident fallback or comparison launch. */
-    readonly soloResumeHint?: boolean;
     readonly startup?: OwnedUiStartupOptions;
     /** Live profile-local settings, supplied only to the bare-A1 composition. */
     readonly viewportSettings?: OwnedUiViewportSettingsPort;
@@ -106,8 +70,8 @@ export interface OwnedUiShellPresentationOptions {
         readonly seed?: number;
     };
     readonly input?: {
-        readonly scheduler?: PiTuiInputCoordinationScheduler;
-        readonly onEvent?: (event: PiTuiInputDiagnosticsEvent) => void;
+        readonly scheduler?: TerminalInputCoordinationScheduler;
+        readonly onEvent?: (event: TerminalInputDiagnosticsEvent) => void;
         readonly now?: () => number;
         /** Evidence-only baseline seam; production leaves coordination enabled. */
         readonly coordination?: boolean;
@@ -126,7 +90,7 @@ export interface OwnedUiShellHistoryOptions {
     readonly forScope?: (scope: "unique" | "shared", sessionId: string | null) => Pick<OwnedUiShellHistoryOptions, "store" | "imageSidecar"> | null;
     readonly onScopeChange?: (listener: (scope: "unique" | "shared") => void) => () => void;
     readonly limit: number;
-    readonly editor: import("../../integrations/pi/components/index.js").HistoryEditorConstructor;
+    readonly editor: OwnedUiShellHistoryEditor;
     /** Optional per-profile filesystem sidecar for image chip payloads. When present, submit
      * writes each referenced attachment and recall reads them back to rehydrate live chips.
      * When absent, image chips silently strip on recall, matching the missing-sidecar path. */
@@ -152,8 +116,6 @@ export interface OwnedUiShellDiagnosticOptions {
     readonly paste?: (event: PasteEvent) => void;
     /** Test seams for isolated paste preparation: an in-process starter, or the forked helper's entry. */
     readonly pastePreparation?: Omit<PastePreparationClientOptions, "onEvent" | "spareIdleMs">;
-    /** Test seam for pending and failed optional selector-module preparation. */
-    readonly lazySelectors?: PiShellLazySelectorLoader;
 }
 /** Live prompt-image admission policy supplied only by the bare-A1 profile. */
 export interface OwnedUiShellPromptImagesOptions {
@@ -169,13 +131,13 @@ export interface OwnedUiShellSkillsOptions {
 export interface OwnedUiShellSharedServices {
     readonly clipboard?: OwnedUiClipboardServices;
     /** Must match the shell's layout: the owned-input profile for the custom viewport, Pi's otherwise. */
-    readonly keybindings?: PiKeybindingsHost;
+    readonly keybindings?: OwnedUiShellKeybindingsHost;
 }
 /** What composes an owned session shell, grouped by the collaborator that provides each part. */
 export interface OwnedUiSessionShellOptions {
     readonly engine: OwnedUiShellEngineOptions;
-    /** Resolves selectors and engine-backed transcript renderers. */
-    readonly presenters: OwnedUiSessionPresenters;
+    /** Resolves selectors, engine-backed transcript renderers, and the vendor presentation ports. */
+    readonly presenters: OwnedUiSessionPresenters & ShellPresentationPorts;
     readonly presentation?: OwnedUiShellPresentationOptions;
     readonly history?: OwnedUiShellHistoryOptions;
     readonly suggestions?: OwnedUiShellSuggestionOptions;
@@ -186,49 +148,56 @@ export interface OwnedUiSessionShellOptions {
     readonly diagnostics?: OwnedUiShellDiagnosticOptions;
     readonly shared?: OwnedUiShellSharedServices;
 }
+/** What the render root needs from its presenter: terminal size and render requests, the theme, and input callbacks. */
+interface OwnedUiSessionShellRootHandlers {
+    readonly presentation: ShellPresentationPorts;
+    readonly components: OwnedUiShellComponents;
+    readonly getColumns: () => number;
+    readonly getRows: () => number;
+    readonly requestRender: (force?: boolean) => void;
+    readonly onViewportFrame?: (frame: TranscriptViewportFrame) => void;
+    readonly requestHyperlinkCleanup?: (rows?: readonly number[]) => void;
+    readonly enableDockInputReuse?: boolean;
+    readonly persistentHistory?: boolean;
+    readonly historyEditor?: OwnedUiShellHistoryEditor;
+    readonly onSubmit: (text: string) => void;
+    readonly onPasteRejected?: (error: unknown) => void;
+    readonly onInterrupt: () => void;
+    readonly onClear?: () => void;
+    readonly onExit: () => void;
+    readonly onModelSelect: () => void;
+    readonly onModelCycle?: (direction: "forward" | "backward") => void;
+    readonly onThinkingCycle: () => void;
+    readonly onThinkingToggle?: () => void;
+    readonly onMessageCopy?: () => void;
+    readonly onFollowUp?: () => void;
+    readonly onDequeue?: () => void;
+    readonly onEditorChange?: (text: string) => void;
+    readonly onPromptSuggestionAccepted?: (text: string) => void;
+    readonly onInputSurfaceChanged?: () => void;
+    readonly onPromptSuggestionEligibilityChanged?: () => void;
+    readonly onCopyText?: (text: string, cut: boolean) => void;
+    readonly readClipboardContent?: (signal?: AbortSignal) => Promise<OwnedUiShellClipboardContent | null>;
+    readonly captureClipboardPaste?: () => PasteSource;
+    readonly pasteDiagnostics?: (event: PasteEvent) => void;
+    readonly pastePreparation?: Omit<PastePreparationClientOptions, "onEvent">;
+    readonly keybindings?: OwnedUiShellKeybindingsHost;
+    readonly promptImageLimit?: () => number;
+    readonly skillsPresentation?: () => "collapse" | "expand";
+}
 /** Composes session state into the owned transcript, viewport, editor, and dock. */
-export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
+export declare class OwnedUiSessionShellRoot implements TerminalComponentPort {
     #private;
-    readonly editor: PiShellEditorPort;
-    readonly header: PiShellHeaderPort;
-    readonly resources: PiShellLoadedResourcesPort;
-    constructor(view: OwnedUiSessionViewModel, cwd: string, handlers: {
-        readonly getColumns: () => number;
-        readonly getRows: () => number;
-        readonly requestRender: (force?: boolean) => void;
-        readonly onViewportFrame?: (frame: TranscriptViewportFrame) => void;
-        readonly requestHyperlinkCleanup?: (rows?: readonly number[]) => void;
-        readonly enableDockInputReuse?: boolean;
-        readonly persistentHistory?: boolean;
-        readonly hideUtilityTabCommands?: boolean;
-        readonly historyEditor?: import("../../integrations/pi/components/index.js").HistoryEditorConstructor;
-        readonly onSubmit: (text: string) => void;
-        readonly onPasteRejected?: (error: unknown) => void;
-        readonly onInterrupt: () => void;
-        readonly onClear?: () => void;
-        readonly onExit: () => void;
-        readonly onModelSelect: () => void;
-        readonly onModelCycle?: (direction: "forward" | "backward") => void;
-        readonly onThinkingCycle: () => void;
-        readonly onThinkingToggle?: () => void;
-        readonly onMessageCopy?: () => void;
-        readonly onFollowUp?: () => void;
-        readonly onDequeue?: () => void;
-        readonly onEditorChange?: (text: string) => void;
-        readonly onPromptSuggestionAccepted?: (text: string) => void;
-        readonly onInputSurfaceChanged?: () => void;
-        readonly onPromptSuggestionEligibilityChanged?: () => void;
-        readonly onCopyText?: (text: string, cut: boolean) => void;
-        readonly readClipboardContent?: (signal?: AbortSignal) => Promise<PiShellClipboardContent | null>;
-        readonly captureClipboardPaste?: () => PasteSource;
-        readonly pasteDiagnostics?: (event: PasteEvent) => void;
-        readonly pastePreparation?: Omit<PastePreparationClientOptions, "onEvent">;
-        readonly keybindings?: PiKeybindingsHost;
-        readonly promptImageLimit?: () => number;
-        readonly skillsPresentation?: () => "collapse" | "expand";
-        /** Resident tab chips already show the session name. */
-        readonly footerSessionName?: boolean;
-    }, startup?: PiShellHeaderOptions, agentDir?: string, extensionRenderers?: OwnedUiTranscriptRendererPort, sessionLayout?: "pinned" | "custom-viewport", imageAssets?: PiShellImageAssetResolver);
+    readonly editor: OwnedUiShellEditorPort;
+    readonly header: OwnedUiShellHeaderPort;
+    readonly resources: OwnedUiShellLoadedResourcesPort;
+    /** The transcript's semantic rows, caches, and engine-backed block renderers. */
+    readonly transcript: TranscriptDocument;
+    /** Workflow results, messages, and status lines appended to the transcript. */
+    readonly workflow: WorkflowOutput;
+    /** The dock's notices, copy acknowledgement, and release banner. */
+    readonly chrome: DockChrome;
+    constructor(view: OwnedUiSessionViewModel, cwd: string, handlers: OwnedUiSessionShellRootHandlers, startup?: OwnedUiShellHeaderOptions, agentDir?: string, extensionRenderers?: OwnedUiTranscriptRendererPort, sessionLayout?: "pinned" | "custom-viewport", imageAssets?: OwnedUiShellImageAssetResolver);
     setEditorPaddingX(padding: number): void;
     setAutocompleteMaxVisible(maxVisible: number): void;
     setOutputPad(padding: 0 | 1): void;
@@ -261,12 +230,6 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
     canPresentPromptSuggestion(): boolean;
     setPromptSuggestion(text: string | null): void;
     update(view: OwnedUiSessionViewModel): void;
-    /**
-     * Applies one block: its component is created or updated in place and the order grows
-     * only when the block is new. A streamed chunk costs one component update rather than a
-     * walk of the whole transcript.
-     */
-    applyTranscriptBlock(block: OwnedUiSessionViewModel["transcript"][number]): void;
     render(width: number): readonly string[];
     viewportFrameDescriptor(): TranscriptViewportFrameDescriptor | null;
     /** Read-only, payload-free evidence; observing a pending frame must never render or repair it. */
@@ -299,58 +262,49 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
     hasActiveSelection(): boolean;
     setViewportConfig(config: OwnedUiViewportSettings): void;
     setFullscreenCopyOnSelect(enabled: boolean): void;
-    showCopyAcknowledgement(message: string): void;
     resumeViewportFollowing(): void;
     noteCompletedAssistantMessage(): void;
-    /** A new session binding owns new mounts even when it reuses semantic invocation ids. */
-    resetTranscript(): void;
     resetViewport(): void;
     clearViewportPointerState(): void;
-    setViewportOverlaySurfaces(surfaces: readonly PiTuiPointerSurface[] | null): void;
+    setViewportOverlaySurfaces(surfaces: readonly TerminalPointerSurface[] | null): void;
     viewportInputGeometryReady(width: number, height: number): boolean;
     handleViewportPreInput(data: string, allowWheel?: boolean, now?: number, editorActive?: boolean): SessionViewportInputResult;
-    dismissNotice(): void;
     /** The pinned-profile layout regions of this session; the terminal host arranges them with `pinnedLayoutRoot`. */
     layoutParts(): PinnedLayoutParts;
-    transcriptComponent(id: string): PiShellTranscriptComponentPort | undefined;
-    exitTranscript(width: number): string;
-    appendWorkflowStatus(message: string): void;
-    appendWorkflowMessage(message: OwnedUiWorkflowMessage, errorCode?: ImageAttachmentError["code"]): void;
-    appendWorkflowResult(result: OwnedUiWorkflowResult, errorCode?: ImageAttachmentError["code"]): void;
     toggleThinkingVisibility(): void;
     get toolsExpanded(): boolean;
     setToolsExpanded(expanded: boolean): void;
-    setExtensionWidget(key: string, component: PiShellComponentPort | null, placement: "aboveEditor" | "belowEditor"): void;
-    setExtensionHeader(component: PiShellComponentPort | null): void;
-    setExtensionFooter(component: PiShellComponentPort | null): void;
+    setExtensionWidget(key: string, component: OwnedUiShellComponentPort | null, placement: "aboveEditor" | "belowEditor"): void;
+    setExtensionHeader(component: OwnedUiShellComponentPort | null): void;
+    setExtensionFooter(component: OwnedUiShellComponentPort | null): void;
     setExtensionStatus(key: string, text: string | undefined): void;
     setExtensionWorking(message: string | undefined, visible?: boolean): void;
     beginImageSubmissionStatus(): () => void;
-    hotkeysPresentation(): PiShellHotkeysPresentation;
+    hotkeysPresentation(): OwnedUiShellHotkeysPresentation;
     resetWorkflowPresentation(): void;
     resetExtensionUi(): void;
     addExtensionNotification(message: string, type: "info" | "warning" | "error"): void;
     extensionFooterData(): unknown;
     usesDefaultInputSurface(): boolean;
-    inputCoordinationSurface(): PiTuiInputSurfaceKind;
+    inputCoordinationSurface(): TerminalInputSurfaceKind;
     viewportCompositionEvidence(): {
         readonly full: number;
         readonly dockOnly: number;
     };
     transcriptRenderCount(): number;
     setFooterLevel(visible: boolean): void;
-    setInputSurface(component: PiShellComponentPort | null, disposePrevious?: boolean, coordination?: Exclude<PiTuiInputSurfaceKind, "editor">): void;
+    setInputSurface(component: OwnedUiShellComponentPort | null, disposePrevious?: boolean, coordination?: Exclude<TerminalInputSurfaceKind, "editor">): void;
     handleInput(data: string): void;
     invalidate(): void;
     setFocused(focused: boolean): void;
     dispose(): void;
 }
 export type PinnedLayoutPart = "document" | "queued" | "aboveWidgets" | "status" | "editor" | "belowWidgets" | "footer";
-export type PinnedLayoutParts = Readonly<Record<PinnedLayoutPart, PiTuiComponentPort>>;
+export type PinnedLayoutParts = Readonly<Record<PinnedLayoutPart, TerminalComponentPort>>;
 /**
  * The pinned-profile screen: a followed transcript scroll above the dock. The runtime mounts one such layout,
  * so its single `transcript` scroll view is shared by whichever session the parts currently resolve to.
  */
-export declare function pinnedLayoutRoot(parts: PinnedLayoutParts): PiTuiLayoutNode;
-export declare function shellResourceEntries(backend: OwnedUiSessionBackend): readonly PiShellResourceEntry[];
+export declare function pinnedLayoutRoot(parts: PinnedLayoutParts, theme: ThemeSource): TerminalLayoutNode;
+export declare function shellResourceEntries(backend: OwnedUiSessionBackend): readonly OwnedUiShellResourceEntry[];
 export {};