@timurproko/a1 0.2.6-dev.734 → 0.2.6

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

@@ -3,7 +3,7 @@ export { createOwnedUiClipboardServices } from "./clipboard-services.js";
 export type { OwnedUiClipboardServices, OwnedUiClipboardServicesOptions } from "./clipboard-services.js";
 export { ContextualPromptSuggestionController, samePromptSuggestionIdentity } from "./prompt-suggestion-controller.js";
 export type { ContextualPromptSuggestionControllerOptions, ContextualPromptSuggestionSurface } from "./prompt-suggestion-controller.js";
-export { OwnedUiSessionShell, OwnedUiSessionShellRoot, formatSessionResumeCommand, quoteCommandArgument } from "./session-shell.js";
-export type { OwnedUiSessionShellOptions, OwnedUiShellDiagnosticOptions, OwnedUiShellEngineOptions, OwnedUiShellHistoryOptions, OwnedUiShellPresentationOptions, OwnedUiShellPromptImagesOptions, OwnedUiShellSharedServices, OwnedUiShellSkillsOptions, OwnedUiShellSuggestionOptions, SessionResumeCommandMetadata, } from "./session-shell.js";
+export { OwnedUiSessionPresenter, OwnedUiSessionShell, OwnedUiSessionShellRoot, OwnedUiTerminalHost, formatSessionResumeCommand, quoteCommandArgument, sessionTerminalHostOptions, } from "./session-shell.js";
+export type { OwnedUiSessionShellOptions, OwnedUiTerminalHostOptions, OwnedUiShellDiagnosticOptions, OwnedUiShellEngineOptions, OwnedUiShellHistoryOptions, OwnedUiShellPresentationOptions, OwnedUiShellPromptImagesOptions, OwnedUiShellSharedServices, OwnedUiShellSkillsOptions, OwnedUiShellSuggestionOptions, SessionResumeCommandMetadata, } from "./session-shell.js";
 export { STREAM_PRESENTATION_INTERVAL_MS, StreamPresentationCoalescer } from "./stream-presentation-coalescer.js";
 export type { StreamPresentationScheduler } from "./stream-presentation-coalescer.js";

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

@@ -1,5 +1,5 @@
 export { ClipboardDiagnosticCapture } from "./clipboard-diagnostics.js";
 export { createOwnedUiClipboardServices } from "./clipboard-services.js";
 export { ContextualPromptSuggestionController, samePromptSuggestionIdentity } from "./prompt-suggestion-controller.js";
-export { OwnedUiSessionShell, OwnedUiSessionShellRoot, formatSessionResumeCommand, quoteCommandArgument } from "./session-shell.js";
+export { OwnedUiSessionPresenter, OwnedUiSessionShell, OwnedUiSessionShellRoot, OwnedUiTerminalHost, formatSessionResumeCommand, quoteCommandArgument, sessionTerminalHostOptions, } from "./session-shell.js";
 export { STREAM_PRESENTATION_INTERVAL_MS, StreamPresentationCoalescer } from "./stream-presentation-coalescer.js";

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

@@ -272,7 +272,8 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
     viewportInputGeometryReady(width: number, height: number): boolean;
     handleViewportPreInput(data: string, allowWheel?: boolean, now?: number, editorActive?: boolean): SessionViewportInputResult;
     dismissNotice(): void;
-    layoutRoot(): PiTuiLayoutNode;
+    /** 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;
@@ -306,5 +307,12 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
     setFocused(focused: boolean): void;
     dispose(): void;
 }
+export type PinnedLayoutPart = "document" | "queued" | "aboveWidgets" | "status" | "editor" | "belowWidgets" | "footer";
+export type PinnedLayoutParts = Readonly<Record<PinnedLayoutPart, PiTuiComponentPort>>;
+/**
+ * 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 {};

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

@@ -680,54 +680,16 @@ export class OwnedUiSessionShellRoot {
     #renderQueued(width) {
         return this.#view.editor.queuedSubmissions.length === 0 ? [] : this.#queued.render(width);
     }
-    layoutRoot() {
-        const document = layoutPort(width => this.#renderDocument(width), () => this.invalidate());
-        const queued = layoutPort(width => this.#view.editor.queuedSubmissions.length === 0 ? [] : this.#queued.render(width), () => this.#queued.invalidate());
-        const aboveWidgets = layoutPort(width => this.#renderWidgets("aboveEditor", width), () => this.#invalidateExtensions());
-        const status = layoutPort(width => this.#renderStatus(width), () => this.#status.invalidate());
-        const editor = layoutPort(width => this.#inputSurface.render(width), () => this.#inputSurface.invalidate(), data => this.#inputSurface.handleInput?.(data));
-        const belowWidgets = layoutPort(width => this.#renderWidgets("belowEditor", width), () => this.#invalidateExtensions());
-        const footer = layoutPort(width => this.#renderFooter(width), () => (this.#extensionFooter ?? this.#footer).invalidate());
+    /** The pinned-profile layout regions of this session; the terminal host arranges them with `pinnedLayoutRoot`. */
+    layoutParts() {
         return {
-            type: "stack",
-            direction: "vertical",
-            children: [
-                {
-                    basis: 0,
-                    grow: 1,
-                    shrink: 1,
-                    minSize: 1,
-                    node: {
-                        type: "scroll",
-                        id: "transcript",
-                        follow: "end",
-                        primary: true,
-                        overscroll: "chain",
-                        scrollbar: "auto",
-                        scrollbarTrackStyle: text => piTheme().fg("scrollbarTrack", text),
-                        scrollbarThumbStyle: text => piTheme().fg("scrollbarThumb", text),
-                        child: { type: "component", component: document },
-                    },
-                },
-                {
-                    basis: "auto",
-                    grow: 0,
-                    shrink: 1,
-                    minSize: 1,
-                    node: {
-                        type: "stack",
-                        direction: "vertical",
-                        children: [
-                            { shrink: 1, minSize: 0, node: { type: "component", component: queued } },
-                            { shrink: 1, minSize: 0, node: { type: "component", component: status } },
-                            { shrink: 1, minSize: 0, node: { type: "component", component: aboveWidgets } },
-                            { shrink: 1, minSize: 3, node: { type: "component", component: editor } },
-                            { shrink: 1, minSize: 0, node: { type: "component", component: belowWidgets } },
-                            { shrink: 1, minSize: 1, node: { type: "component", component: footer } },
-                        ],
-                    },
-                },
-            ],
+            document: layoutPort(width => this.#renderDocument(width), () => this.invalidate()),
+            queued: layoutPort(width => this.#view.editor.queuedSubmissions.length === 0 ? [] : this.#queued.render(width), () => this.#queued.invalidate()),
+            aboveWidgets: layoutPort(width => this.#renderWidgets("aboveEditor", width), () => this.#invalidateExtensions()),
+            status: layoutPort(width => this.#renderStatus(width), () => this.#status.invalidate()),
+            editor: layoutPort(width => this.#inputSurface.render(width), () => this.#inputSurface.invalidate(), data => this.#inputSurface.handleInput?.(data)),
+            belowWidgets: layoutPort(width => this.#renderWidgets("belowEditor", width), () => this.#invalidateExtensions()),
+            footer: layoutPort(width => this.#renderFooter(width), () => (this.#extensionFooter ?? this.#footer).invalidate()),
         };
     }
     #renderDocument(width) {
@@ -1373,6 +1335,53 @@ function pinnedPromptSourceRow(block, sourceRow, width) {
         return sourceRow;
     return overlaySpan(sourceRow, rowWidth - timestampWidth, rowWidth, paintPiSubmittedPromptTimestamp(timestamp));
 }
+/**
+ * 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 function pinnedLayoutRoot(parts) {
+    return {
+        type: "stack",
+        direction: "vertical",
+        children: [
+            {
+                basis: 0,
+                grow: 1,
+                shrink: 1,
+                minSize: 1,
+                node: {
+                    type: "scroll",
+                    id: "transcript",
+                    follow: "end",
+                    primary: true,
+                    overscroll: "chain",
+                    scrollbar: "auto",
+                    scrollbarTrackStyle: text => piTheme().fg("scrollbarTrack", text),
+                    scrollbarThumbStyle: text => piTheme().fg("scrollbarThumb", text),
+                    child: { type: "component", component: parts.document },
+                },
+            },
+            {
+                basis: "auto",
+                grow: 0,
+                shrink: 1,
+                minSize: 1,
+                node: {
+                    type: "stack",
+                    direction: "vertical",
+                    children: [
+                        { shrink: 1, minSize: 0, node: { type: "component", component: parts.queued } },
+                        { shrink: 1, minSize: 0, node: { type: "component", component: parts.status } },
+                        { shrink: 1, minSize: 0, node: { type: "component", component: parts.aboveWidgets } },
+                        { shrink: 1, minSize: 3, node: { type: "component", component: parts.editor } },
+                        { shrink: 1, minSize: 0, node: { type: "component", component: parts.belowWidgets } },
+                        { shrink: 1, minSize: 1, node: { type: "component", component: parts.footer } },
+                    ],
+                },
+            },
+        ],
+    };
+}
 function layoutPort(render, invalidate, handleInput) {
     return {
         render,

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

@@ -2,20 +2,35 @@ import type { OwnedUiCommandResult, OwnedUiSessionBackend, OwnedUiSessionViewMod
 import { type PiShellSkillSummary } from "../../integrations/pi/components/skills-command.js";
 import { type PiShellHotkeysPresentation } from "../../integrations/pi/components/shell-presenters-info.js";
 import type { PiShellSelectorOption } from "../../integrations/pi/components/shell-shared-facade.js";
-import { type PiTuiDamageDecision } from "../../integrations/pi/tui-runtime/damage-aware-terminal.js";
-import { PiTuiRuntimeAdapter } from "../../integrations/pi/tui-runtime/adapter.js";
-import type { PiTuiOverlayHandle } from "../../integrations/pi/tui-runtime/contracts.js";
-import { OwnedUiSessionShellRoot, type OwnedUiSessionShellOptions } from "./session-shell-root.js";
+import type { PiTuiDamageDecision } from "../../integrations/pi/tui-runtime/damage-aware-terminal.js";
+import type { PiTuiRuntimeAdapter } from "../../integrations/pi/tui-runtime/adapter.js";
+import type { PiTuiInputSurfaceKind } from "../../integrations/pi/tui-runtime/input-presentation-coordinator.js";
+import type { PiTuiComponentPort, PiTuiInputListenerResult, PiTuiOverlayHandle, PiTuiPointerSurface } from "../../integrations/pi/tui-runtime/contracts.js";
+import { OwnedUiTerminalHost, type OwnedUiHostedPresenter, type OwnedUiPresenterRelease } from "./shell-host.js";
+import { OwnedUiSessionShellRoot, type OwnedUiSessionShellOptions, type PinnedLayoutPart } from "./session-shell-root.js";
 export { OwnedUiSessionShellRoot, type OwnedUiSessionShellOptions, type OwnedUiShellDiagnosticOptions, type OwnedUiShellEngineOptions, type OwnedUiShellHistoryOptions, type OwnedUiShellPresentationOptions, type OwnedUiShellPromptImagesOptions, type OwnedUiShellSharedServices, type OwnedUiShellSkillsOptions, type OwnedUiShellSuggestionOptions, } from "./session-shell-root.js";
-/** Coordinates backend, owned presentation, and Pi TUI lifecycles for one interactive session. */
-export declare class OwnedUiSessionShell {
+export { OwnedUiTerminalHost, sessionTerminalHostOptions, type OwnedUiTerminalHostOptions } from "./shell-host.js";
+/**
+ * Presents one engine session: its transcript root, editor, controllers, submission, workflows, and dialogs.
+ * It reaches the terminal only through its terminal host's handle, and paints only while it is attached.
+ */
+export declare class OwnedUiSessionPresenter implements OwnedUiHostedPresenter {
     #private;
     readonly backend: OwnedUiSessionBackend;
     readonly root: OwnedUiSessionShellRoot;
-    readonly runtime: PiTuiRuntimeAdapter;
-    constructor(options: OwnedUiSessionShellOptions);
+    constructor(host: OwnedUiTerminalHost, options: OwnedUiSessionShellOptions);
     view(): OwnedUiSessionViewModel;
-    damagePresentationDecision(): PiTuiDamageDecision | null;
+    get terminalHost(): OwnedUiTerminalHost;
+    render(width: number): readonly string[];
+    handleInput(data: string): void;
+    invalidate(): void;
+    setFocused(focused: boolean): void;
+    inputCoordinationSurface(): PiTuiInputSurfaceKind;
+    setOverlaySurfaces(surfaces: readonly PiTuiPointerSurface[] | null): void;
+    noteImmediatePresentation(): void;
+    layoutPart(part: PinnedLayoutPart): PiTuiComponentPort;
+    activated(): void;
+    handleViewportInput(data: string): PiTuiInputListenerResult | undefined;
     start(): void;
     onView(listener: (view: OwnedUiSessionViewModel) => void): () => void;
     waitUntilStopped(): Promise<void>;
@@ -53,8 +68,21 @@ export declare class OwnedUiSessionShell {
     /** The bare-A1 unified Models dialog: switch on Enter, scope on Space, persist on Ctrl+S, all through the engine. */
     showModelsDialog(initialQuery?: string): void;
     dispose(): Promise<void>;
+    release(terminal: {
+        readonly mode: "regular" | "fullscreen";
+        readonly columns: number;
+    }): OwnedUiPresenterRelease;
     hotkeysPresentation(): PiShellHotkeysPresentation;
 }
+/**
+ * One session on a terminal of its own: a terminal host with this presenter attached. Disposing it ends the
+ * terminal, as quitting the single-session product does.
+ */
+export declare class OwnedUiSessionShell extends OwnedUiSessionPresenter {
+    constructor(options: OwnedUiSessionShellOptions);
+    get runtime(): PiTuiRuntimeAdapter;
+    damagePresentationDecision(): PiTuiDamageDecision | null;
+}
 export interface SessionResumeCommandMetadata {
     readonly sessionId: string;
     readonly sessionDir: string;