@timurproko/a1 0.1.8-dev.407 → 0.1.8-dev.436

package/dist/integrations/pi/engine/windows-filesystem-hygiene.js

@@ -1,4 +1,4 @@
-import { isBashToolResult, isEditToolResult, isWriteToolResult, } from "@earendil-works/pi-coding-agent";
+import { isBashToolResult, isEditToolResult, isWriteToolResult, } from "../startup-public.js";
 import { lstat, unlink } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
 const DEFAULT_FILE_SYSTEM = { lstat, unlink };

package/dist/integrations/pi/session-ui/clipboard-diagnostics.d.ts

@@ -1,4 +1,4 @@
-import type { PiTuiInputDiagnosticsEvent } from "../tui-runtime/index.js";
+import type { PiTuiInputDiagnosticsEvent } from "../tui-runtime/contracts.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. */

package/dist/integrations/pi/session-ui/clipboard-diagnostics.js

@@ -1,6 +1,6 @@
 import { writeFile } from "node:fs/promises";
 const PHASES = new Set(["capture", "selection-clear", "queued", "preparing", "extracted", "encoded", "submitting", "settled", "cleanup",
-    "framing", "admitted", "predecessor", "acquiring", "acquired-text", "acquired-image", "classifying", "path-fallback", "prepared", "inserting",
+    "shortcut-received", "shortcut-matched", "shortcut-admitted", "pointer-admitted", "framing", "admitted", "predecessor", "acquiring", "acquired-text", "acquired-image", "classifying", "path-fallback", "prepared", "inserting",
     "receipt", "semantic-start", "semantic-end", "composition-start", "composition-end", "write-start", "write-end", "heartbeat"]);
 /** Opt-in scalar-only snapshots, bounded to 128 rows and one pending asynchronous write. */
 export class ClipboardDiagnosticCapture {

package/dist/integrations/pi/session-ui/paste-executor.d.ts

@@ -1,4 +1,4 @@
-import type { PiShellClipboardContent } from "../components/index.js";
+import type { PiShellClipboardContent } from "../components/shell-shared-facade.js";
 import { type PreparedPaste, type PasteEvent } from "./paste-protocol.js";
 export interface PasteExecutorJob {
     readonly result: Promise<PreparedPaste>;

package/dist/integrations/pi/session-ui/paste-executor.js

@@ -1,5 +1,5 @@
 import { fork } from "node:child_process";
-import { ImageAttachmentError } from "../../../contracts/owned-ui/index.js";
+import { ImageAttachmentError } from "../../../contracts/owned-ui/image-attachments.js";
 import { MAX_SOURCE_IMAGE_BYTES } from "./image-source.js";
 import { PASTE_CHUNK_UNITS, PASTE_REQUESTS, PASTE_STOP_MS, PASTE_TEXT_BYTES, pasteFragments } from "./paste-protocol.js";
 const live = new Set();

package/dist/integrations/pi/session-ui/paste-protocol.d.ts

@@ -24,7 +24,7 @@ export type PasteSource = {
 };
 export interface PasteEvent {
     readonly request: number;
-    readonly phase: "receipt" | "framing" | "admitted" | "predecessor" | "acquiring" | "acquired-text" | "acquired-image" | "classifying" | "path-fallback" | "prepared" | "inserting" | "settled" | "cleanup";
+    readonly phase: "receipt" | "shortcut-received" | "shortcut-matched" | "shortcut-admitted" | "pointer-admitted" | "framing" | "admitted" | "predecessor" | "acquiring" | "acquired-text" | "acquired-image" | "classifying" | "path-fallback" | "prepared" | "inserting" | "settled" | "cleanup";
     readonly atMs: number;
     readonly elapsedMs?: number;
     readonly pending: number;

package/dist/integrations/pi/session-ui/prompt-chips.d.ts

@@ -1,4 +1,4 @@
-import type { PiShellClipboardContent, PiShellEditorTextRange } from "../components/index.js";
+import type { PiShellClipboardContent, PiShellEditorTextRange } from "../components/shell-shared-facade.js";
 import type { PasteEvent, PasteSource } from "./paste-protocol.js";
 export interface PromptImageAttachment {
     readonly type: "image";

package/dist/integrations/pi/session-ui/prompt-chips.js

@@ -1,7 +1,7 @@
 import { randomBytes } from "node:crypto";
 import path from "node:path";
 import { canonicalizeClipboardImage } from "./clipboard-image.js";
-import { assertImageEncodedSize, assertPromptImages, ImageAttachmentError } from "../../../contracts/owned-ui/index.js";
+import { assertImageEncodedSize, assertPromptImages, ImageAttachmentError } from "../../../contracts/owned-ui/image-attachments.js";
 import { ImagePreparationClient } from "./image-preparation-client.js";
 import { preparePasteText } from "./paste-text-preparation.js";
 import { pathChipTag } from "./path-chip-presentation.js";

package/dist/integrations/pi/session-ui/response-copy-coordinator.d.ts

@@ -1,4 +1,4 @@
-import { type SelectionCopySnapshot } from "../../../ui/components/index.js";
+import { type SelectionCopySnapshot } from "../../../ui/components/selection-copy.js";
 import { type CopyResult, type ResponseCopyEvent } from "./response-copy-protocol.js";
 import type { ResponseCopyExecutor } from "./response-copy-transport.js";
 /** Owns one delivery and one newest pending copy, including expiry and side-effect fencing. */

package/dist/integrations/pi/session-ui/response-copy-coordinator.js

@@ -1,4 +1,4 @@
-import { MAX_COPY_SOURCE_UNITS } from "../../../ui/components/index.js";
+import { MAX_COPY_SOURCE_UNITS } from "../../../ui/components/selection-copy.js";
 import { COPY_CLEANUP_MS, COPY_DEADLINE_MS } from "./response-copy-protocol.js";
 /** Owns one delivery and one newest pending copy, including expiry and side-effect fencing. */
 export class ResponseCopyCoordinator {

package/dist/integrations/pi/session-ui/response-copy-transport.d.ts

@@ -1,4 +1,4 @@
-import type { SelectionCopySnapshot } from "../../../ui/components/index.js";
+import type { SelectionCopySnapshot } from "../../../ui/components/selection-copy.js";
 import { type CopyResult } from "./response-copy-protocol.js";
 export interface ResponseCopyJob {
     readonly result: Promise<CopyResult>;

package/dist/integrations/pi/session-ui/session-shell-root.d.ts

@@ -1,10 +1,12 @@
 import type { OwnedUiPromptSuggestionGeneratorPort, OwnedUiSessionViewModel, OwnedUiViewportSettings, OwnedUiViewportSettingsPort, SuggestionDecision, SuggestionDiagnosticObserver } from "../../../contracts/owned-ui/index.js";
-import type { PiTuiPointerSurface } from "../tui-runtime/index.js";
-import type { UiRouteHost } from "../../../ui/apps/index.js";
-import { type TranscriptViewportFrame, type TranscriptViewportFrameDescriptor } from "../../../ui/components/index.js";
-import { type PiEngineAdapter, type PiWorkflowMessage, type PiWorkflowResult } from "../engine/index.js";
-import { type PiShellClipboardContent, type PiShellComponentPort, type PiShellEditorPort, type PiShellExtensionRendererResolver, type PiShellHeaderOptions, type PiShellHeaderPort, type PiShellImageAssetResolver, type PiShellLoadedResourcesPort, type PiShellResourceEntry, type PiShellTranscriptComponentPort } from "../components/index.js";
-import { type PiTuiComponentPort, type PiTuiInputSurfaceKind, type PiTuiInputCoordinationScheduler, type PiTuiInputDiagnosticsEvent, type PiTuiLayoutNode, type PiTuiTerminalPort } from "../tui-runtime/index.js";
+import type { PiTuiPointerSurface } from "../tui-runtime/contracts.js";
+import type { UiRouteHost } from "../../../ui/apps/contracts.js";
+import type { TranscriptViewportFrame, TranscriptViewportFrameDescriptor } from "../../../ui/components/transcript-viewport.js";
+import type { PiEngineAdapter } from "../engine/adapter.js";
+import type { PiWorkflowMessage, PiWorkflowResult } from "../engine/workflows.js";
+import { type PiShellClipboardContent, type PiShellComponentPort, type PiShellEditorPort, type PiShellExtensionRendererResolver, type PiShellHeaderOptions, type PiShellHeaderPort, type PiShellImageAssetResolver, type PiShellLoadedResourcesPort, type PiShellResourceEntry, type PiShellTranscriptComponentPort } from "../components/shell-shared-facade.js";
+import { type PiTuiInputCoordinationScheduler, type PiTuiInputSurfaceKind } from "../tui-runtime/input-presentation-coordinator.js";
+import type { PiTuiComponentPort, PiTuiInputDiagnosticsEvent, PiTuiLayoutNode, PiTuiTerminalPort } from "../tui-runtime/contracts.js";
 import { type PreparedPrompt } from "./prompt-chips.js";
 import { type SessionViewportInputResult } from "./session-viewport-controller.js";
 import type { ResponseCopyExecutor } from "./response-copy-transport.js";

package/dist/integrations/pi/session-ui/session-shell-root.js

@@ -1,8 +1,20 @@
-import { acceptsTranscriptUpdate } from "../../../contracts/owned-ui/index.js";
-import { backgroundSgrSpan, caretCell, composeSubmittedPromptRows, PromptInput, promptArrow, displayWidth, faint, formatSubmittedPromptTime, heldNativeHyperlinkStyle, hyperlinkSgrSpan, nativeHyperlinkStyle, overlaySpan, progressStatusText, submittedPromptLayout, stripAnsi, } from "../../../ui/components/index.js";
-import { PINNED_PI_HIDDEN_COMMAND_NAMES, PINNED_PI_WORKFLOW_COMMAND_NAMES, } from "../engine/index.js";
-import { createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellStatus, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, onPiThemeChange, isPiPromptStyleCompaction, piShellVisibleWidth, piShellTruncateToWidth, piTheme, renderPiShellCommandMessage, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, } from "../components/index.js";
-import { PiTuiRuntimeAdapter, classifyPiTuiInput, } from "../tui-runtime/index.js";
+import { acceptsTranscriptUpdate } from "../../../contracts/owned-ui/transcript-lifecycle.js";
+import { caretCell } from "../../../ui/components/line-input.js";
+import { PromptInput, promptArrow } from "../../../ui/components/prompt-input.js";
+import { composeSubmittedPromptRows, formatSubmittedPromptTime, submittedPromptLayout, } from "../../../ui/components/submitted-prompt.js";
+import { backgroundSgrSpan, heldNativeHyperlinkStyle, hyperlinkSgrSpan, nativeHyperlinkStyle, overlaySpan, } from "../../../ui/components/spans.js";
+import { progressStatusText } from "../../../ui/components/progress-status.js";
+import { displayWidth, faint, stripAnsi } from "../../../ui/components/text.js";
+import { PINNED_PI_HIDDEN_COMMAND_NAMES, PINNED_PI_WORKFLOW_COMMAND_NAMES } from "../engine/workflows.js";
+import { createPiExtensionUiBridge } from "../components/shell-extension-ui.js";
+import { createPiShellEditor } from "../components/shell-editor-autocomplete.js";
+import { createPiQueuedInputStatus, createPiShellFooter, createPiShellHeader, createPiShellLoadedResources, createPiShellStatus, } from "../components/shell-footer-status.js";
+import { createPiShellArmin, createPiShellAuthProviderSelector, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellExtensionSelector, createPiShellLoginDialog, createPiShellModelSelector, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, } from "../components/shell-selectors-dialogs.js";
+import { createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellHotkeys, createPiShellSessionInfo, renderPiShellCommandMessage, renderPiShellStatusText, } from "../components/shell-presenters-info.js";
+import { createPiShellTranscriptComponent, isPiPromptStyleCompaction, paintPiSubmittedPromptTimestamp, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellTranscriptBlock, } from "../components/shell-presenters-transcript.js";
+import { onPiThemeChange, piTheme } from "../components/upstream/theme/theme.js";
+import { piShellTruncateToWidth, piShellVisibleWidth, } from "../components/shell-shared-facade.js";
+import { classifyPiTuiInput, } from "../tui-runtime/input-presentation-coordinator.js";
 import { PromptChipStore } from "./prompt-chips.js";
 import { EditorHyperlinkBudget } from "./editor-hyperlink-budget.js";
 import { SessionViewportController } from "./session-viewport-controller.js";
@@ -28,7 +40,8 @@ export class OwnedUiSessionShellRoot {
     #imageAssets;
     #promptChips;
     #editorHyperlinks = new EditorHyperlinkBudget();
-    #pasteFramingId = 0;
+    #pasteDiagnosticId = 0;
+    #terminalPasteDiagnosticRequest;
     #customViewport;
     #submittedPromptComposer;
     #viewportController;
@@ -107,9 +120,15 @@ export class OwnedUiSessionShellRoot {
             },
             ...(this.#customViewport ? {
                 beginClipboardPaste: () => this.#promptChips.beginPaste(this.editor.getText(), handlers.captureClipboardPaste?.() ?? { kind: "provided", read: signal => handlers.readClipboardContent?.(signal) ?? Promise.resolve(null) }, error => handlers.onPasteRejected?.(error), () => handlers.requestRender()),
-                onPasteInput: bytes => {
+                onPasteInput: (bytes, phase) => {
                     try {
-                        handlers.pasteDiagnostics?.({ request: --this.#pasteFramingId, phase: "framing", bytes, atMs: performance.now(), pending: 0, transport: "terminal" });
+                        if (phase === "framing")
+                            this.#terminalPasteDiagnosticRequest = --this.#pasteDiagnosticId;
+                        const request = this.#terminalPasteDiagnosticRequest ?? --this.#pasteDiagnosticId;
+                        handlers.pasteDiagnostics?.({ request, phase, bytes, atMs: performance.now(), pending: 0, transport: "terminal",
+                            ...(phase === "settled" ? { outcome: "ready" } : {}) });
+                        if (phase === "settled")
+                            this.#terminalPasteDiagnosticRequest = undefined;
                     }
                     catch { /* Invariant: payload-free diagnostics cannot interfere with the input path. */ }
                 },
@@ -165,6 +184,8 @@ export class OwnedUiSessionShellRoot {
             requestRender: force => this.#componentRuntime.requestRender(force),
             requestHyperlinkCleanup: rows => handlers.requestHyperlinkCleanup?.(rows),
             hasEditorLinks: () => this.#promptChips.hyperlinkRanges(this.editor.getText()).length > 0,
+            ...(handlers.pasteDiagnostics === undefined ? {} : { pasteDiagnostics: handlers.pasteDiagnostics }),
+            nextPasteDiagnosticRequest: () => --this.#pasteDiagnosticId,
         });
         // Performance: stable painter identities let the neutral viewport retain row-level
         // selection variants while each callback still resolves the live Pi theme.
@@ -1122,7 +1143,7 @@ function nativeTranscriptLinkColor(text, target) {
 function withoutTerminalBackground(text) {
     return text.replace(TERMINAL_BACKGROUND, "");
 }
-/** Preserve the established prompt foreground for quiet and hovered pinned timestamps. */
+/** Preserve the stable metadata-grey foreground for every pinned timestamp state. */
 function pinnedPromptSourceRow(block, sourceRow, width) {
     if (typeof block.payload !== "object" || block.payload === null)
         return sourceRow;
@@ -1136,7 +1157,7 @@ function pinnedPromptSourceRow(block, sourceRow, width) {
     const timestampWidth = displayWidth(timestamp);
     if (rowWidth < timestampWidth)
         return sourceRow;
-    return overlaySpan(sourceRow, rowWidth - timestampWidth, rowWidth, piTheme().fg("userMessageText", timestamp));
+    return overlaySpan(sourceRow, rowWidth - timestampWidth, rowWidth, paintPiSubmittedPromptTimestamp(timestamp));
 }
 function layoutPort(render, invalidate, handleInput) {
     return {

package/dist/integrations/pi/session-ui/session-shell.d.ts

@@ -1,7 +1,10 @@
 import type { OwnedUiSessionViewModel, OwnedUiThinkingLevel } from "../../../contracts/owned-ui/index.js";
-import { type AdapterCommandResult, type PiWorkflowRequest } from "../engine/index.js";
-import { type PiShellSelectorOption } from "../components/index.js";
-import { PiTuiRuntimeAdapter, type PiTuiDamageDecision, type PiTuiOverlayHandle } from "../tui-runtime/index.js";
+import type { AdapterCommandResult } from "../engine/adapter.js";
+import type { PiWorkflowRequest } from "../engine/workflows.js";
+import type { PiShellSelectorOption } from "../components/shell-shared-facade.js";
+import { type PiTuiDamageDecision } from "../tui-runtime/damage-aware-terminal.js";
+import { PiTuiRuntimeAdapter } from "../tui-runtime/adapter.js";
+import type { PiTuiOverlayHandle } from "../tui-runtime/contracts.js";
 import { OwnedUiSessionShellRoot, type OwnedUiBackendPort, type OwnedUiSessionShellOptions } from "./session-shell-root.js";
 export { OwnedUiSessionShellRoot, type OwnedUiSessionShellOptions } from "./session-shell-root.js";
 /** Coordinates backend, owned presentation, and Pi TUI lifecycles for one interactive session. */

package/dist/integrations/pi/session-ui/session-shell.js

@@ -3,13 +3,23 @@ import { createResponseCopyExecutor, hasAsyncClipboardOutput, responseCopyDestin
 import { MAX_COPY_CONTROL_BYTES } from "./response-copy-protocol.js";
 import { PromptHistoryController } from "./prompt-history-controller.js";
 import { PRODUCT_TEXT } from "../../../product-identity.js";
-import { boundedCleanup } from "../../../foundation/terminal-cleanup/index.js";
-import { assertOwnedUiCommand, assertPromptImages, ImageAttachmentError } from "../../../contracts/owned-ui/index.js";
+import { boundedCleanup } from "../../../foundation/terminal-cleanup/terminal-reset.js";
+import { assertOwnedUiCommand } from "../../../contracts/owned-ui/validation.js";
+import { assertPromptImages, ImageAttachmentError } from "../../../contracts/owned-ui/image-attachments.js";
 import { ContextualPromptSuggestionController } from "./prompt-suggestion-controller.js";
-import { MOUSE_TRACKING_OFF, MOUSE_TRACKING_ON, parseMouseInput, readVisibleHyperlinks } from "../../../ui/components/index.js";
-import { PINNED_PI_HIDDEN_COMMAND_NAMES, PINNED_PI_WORKFLOW_COMMAND_NAMES, } from "../engine/index.js";
-import { createPiExtensionUiBridge, createPiQueuedInputStatus, createPiShellArmin, createPiShellAuthProviderSelector, createPiShellChangelog, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellStatus, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, onPiThemeChange, piTheme, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, } from "../components/index.js";
-import { DamageAwareTerminalAdapter, PiTuiRuntimeAdapter, classifyPiTuiInput, } from "../tui-runtime/index.js";
+import { MOUSE_TRACKING_OFF, MOUSE_TRACKING_ON, parseMouseInput } from "../../../ui/components/mouse.js";
+import { readVisibleHyperlinks } from "../../../ui/components/visible-hyperlinks.js";
+import { PINNED_PI_HIDDEN_COMMAND_NAMES, PINNED_PI_WORKFLOW_COMMAND_NAMES } from "../engine/workflows.js";
+import { createPiExtensionUiBridge } from "../components/shell-extension-ui.js";
+import { createPiShellEditor } from "../components/shell-editor-autocomplete.js";
+import { createPiQueuedInputStatus, createPiShellFooter, createPiShellHeader, createPiShellLoadedResources, createPiShellStatus, } from "../components/shell-footer-status.js";
+import { createPiShellArmin, createPiShellAuthProviderSelector, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellExtensionSelector, createPiShellLoginDialog, createPiShellModelSelector, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, } from "../components/shell-selectors-dialogs.js";
+import { createPiShellChangelog, createPiShellHotkeys, createPiShellSessionInfo, renderPiShellStatusText, } from "../components/shell-presenters-info.js";
+import { createPiShellTranscriptComponent, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellTranscriptBlock, } from "../components/shell-presenters-transcript.js";
+import { onPiThemeChange, piTheme } from "../components/upstream/theme/theme.js";
+import { DamageAwareTerminalAdapter } from "../tui-runtime/damage-aware-terminal.js";
+import { PiTuiRuntimeAdapter } from "../tui-runtime/adapter.js";
+import { classifyPiTuiInput } from "../tui-runtime/input-presentation-coordinator.js";
 import { runImageWorker } from "./image-preparation-client.js";
 import { STREAM_PRESENTATION_INTERVAL_MS, StreamPresentationCoalescer, } from "./stream-presentation-coalescer.js";
 import { writeSystemClipboardText, } from "./system-clipboard.js";
@@ -38,6 +48,8 @@ export class OwnedUiSessionShell {
     #editorRevision = 0;
     #started = false;
     #disposed = false;
+    #shutdownPromise;
+    #disposePromise;
     #pointerReporting = false;
     #customViewport;
     #responseCopy;
@@ -481,7 +493,7 @@ export class OwnedUiSessionShell {
             if (view.lifecycle === "ready" && this.#compactionQueue.length > 0)
                 void this.#flushCompactionQueue();
             if (event.type === "session-lifecycle" && event.lifecycle === "stopped")
-                this.#resolveStopped?.();
+                this.#settleStoppedLifecycle();
         });
         this.#unbindClipboardWriter = this.#responseCopy === null ? () => { } : this.backend.bindClipboardWriter(async (text) => {
             const result = await this.#responseCopy.submitText(text);
@@ -1068,10 +1080,23 @@ export class OwnedUiSessionShell {
         this.root.setInputSurface(component);
         this.runtime.requestRender();
     }
-    async shutdown() {
-        return this.runWorkflow({ command: "quit", argument: "" });
+    shutdown() {
+        this.#shutdownPromise ??= this.#shutdown();
+        return this.#shutdownPromise;
+    }
+    async #shutdown() {
+        try {
+            const result = await this.backend.executeWorkflow({ command: "quit", argument: "" });
+            await this.dispose();
+            return workflowAdapterResult(result);
+        }
+        finally {
+            this.#resolveStoppedLifecycle();
+        }
     }
     async runWorkflow(request) {
+        if (request.command === "quit")
+            return this.shutdown();
         const copyGeneration = request.command === "copy" ? this.backend.sessionBindingGeneration : undefined;
         if (request.command === "login" && request.selection !== undefined) {
             const setup = this.backend.pinnedAmbientAuthentication(request.selection);
@@ -1311,9 +1336,19 @@ export class OwnedUiSessionShell {
             return;
         this.runtime.writeControl(effective ? MOUSE_TRACKING_ON : MOUSE_TRACKING_OFF);
     }
-    async dispose() {
+    dispose() {
+        if (this.#disposePromise !== undefined)
+            return this.#disposePromise;
         if (this.#disposed)
-            return;
+            return Promise.resolve();
+        const pending = Promise.resolve().then(() => this.#dispose());
+        this.#disposePromise = pending;
+        const clear = () => { if (this.#disposePromise === pending)
+            this.#disposePromise = undefined; };
+        void pending.then(clear, clear);
+        return pending;
+    }
+    async #dispose() {
         this.#disposed = true;
         this.#responseCopy?.dispose();
         this.#cancelWaitingImages();
@@ -1361,6 +1396,14 @@ export class OwnedUiSessionShell {
         if (fullscreenExitText.length > 0)
             this.runtime.writeAfterStop(`${fullscreenExitText}\n`);
     }
+    #settleStoppedLifecycle() {
+        void this.dispose().then(() => this.#resolveStoppedLifecycle(), () => this.#resolveStoppedLifecycle());
+    }
+    #resolveStoppedLifecycle() {
+        const resolve = this.#resolveStopped;
+        this.#resolveStopped = undefined;
+        resolve?.();
+    }
     // Invariant: incremental block updates notify listeners with the same complete view contract.
     #syncBlock(block) {
         this.root.applyTranscriptBlock(block);

package/dist/integrations/pi/session-ui/session-viewport-controller.d.ts

@@ -1,7 +1,9 @@
-import { type PiTuiPointerSurface } from "../tui-runtime/index.js";
+import type { PiTuiPointerSurface } from "../tui-runtime/contracts.js";
 import type { OwnedUiViewportSettings } from "../../../contracts/owned-ui/index.js";
-import { type SelectionCopySnapshot, type TranscriptViewportFrame, type TranscriptViewportFrameInput } from "../../../ui/components/index.js";
-import type { PiShellEditorPort } from "../components/index.js";
+import { type TranscriptViewportFrame, type TranscriptViewportFrameInput } from "../../../ui/components/transcript-viewport.js";
+import type { SelectionCopySnapshot } from "../../../ui/components/selection-copy.js";
+import type { PiShellEditorPort } from "../components/shell-shared-facade.js";
+import type { PasteEvent } from "./paste-protocol.js";
 export interface SessionViewportControllerOptions {
     readonly enabled: boolean;
     readonly editor: PiShellEditorPort;
@@ -9,6 +11,9 @@ export interface SessionViewportControllerOptions {
     readonly requestHyperlinkCleanup?: (rows?: readonly number[]) => void;
     /** Whether mutable editor URL chips need targeted link-cell cleanup on deletion. */
     readonly hasEditorLinks?: () => boolean;
+    /** Payload-free first-use paste routing observations. */
+    readonly pasteDiagnostics?: (event: PasteEvent) => void;
+    readonly nextPasteDiagnosticRequest?: () => number;
 }
 export interface SessionViewportInputResult {
     readonly data: string;

package/dist/integrations/pi/session-ui/session-viewport-controller.js

@@ -1,5 +1,8 @@
-import { samePointerSurfaces } from "../tui-runtime/index.js";
-import { TranscriptViewport, readVisibleHyperlinks, routeMouseInput, scrollForTrackPage, scrollForThumbRow, scrollbarSelectionRows, scrollbarWheelRows, } from "../../../ui/components/index.js";
+import { samePointerSurfaces } from "../tui-runtime/overlay-geometry.js";
+import { TranscriptViewport } from "../../../ui/components/transcript-viewport.js";
+import { readVisibleHyperlinks } from "../../../ui/components/visible-hyperlinks.js";
+import { routeMouseInput } from "../../../ui/components/mouse.js";
+import { scrollForTrackPage, scrollForThumbRow, scrollbarSelectionRows, scrollbarWheelRows } from "../../../ui/components/scrollbar.js";
 /**
  * Owns the stateful interaction policy of the bare-A1 session viewport. The
  * shell root supplies semantic rows and dock geometry; this controller owns
@@ -11,6 +14,9 @@ export class SessionViewportController {
     #requestRender;
     #hasEditorLinks;
     #requestHyperlinkCleanup;
+    #pasteDiagnostics;
+    #nextPasteDiagnosticRequest;
+    #pasteDiagnosticRequest = 0;
     #viewport = new TranscriptViewport();
     #config = {
         scrollbarAppearance: "auto",
@@ -46,6 +52,8 @@ export class SessionViewportController {
         };
         this.#hasEditorLinks = options.hasEditorLinks ?? (() => false);
         this.#requestHyperlinkCleanup = options.requestHyperlinkCleanup ?? (() => { });
+        this.#pasteDiagnostics = options.pasteDiagnostics;
+        this.#nextPasteDiagnosticRequest = options.nextPasteDiagnosticRequest ?? (() => --this.#pasteDiagnosticRequest);
     }
     get config() {
         return this.#config;
@@ -183,6 +191,12 @@ export class SessionViewportController {
         this.#viewport.clearTransient();
         this.#pointerOwner = undefined;
     }
+    #emitPasteRoute(request, phase) {
+        try {
+            this.#pasteDiagnostics?.({ request, phase, atMs: performance.now(), pending: 0 });
+        }
+        catch { /* Invariant: payload-free diagnostics cannot interfere with input routing. */ }
+    }
     #cancelGesture() {
         const held = this.#pointerOwner !== undefined || this.#viewport.selectionActive || this.#editorPointerSelecting;
         const repaint = this.#viewport.hasSelection || held;
@@ -199,6 +213,11 @@ export class SessionViewportController {
     handlePreInput(data, allowWheel = true, now = Date.now(), editorActive = true) {
         if (!this.#enabled)
             return { data, consumed: false };
+        let pasteRequest;
+        if (editorActive && data === "\u0016") {
+            pasteRequest = this.#nextPasteDiagnosticRequest();
+            this.#emitPasteRoute(pasteRequest, "shortcut-received");
+        }
         // Compatibility: Pi components share one keybinding manager. Restore bare A1's aliases
         // before the focused vanilla editor handles this input.
         if (editorActive)
@@ -208,8 +227,15 @@ export class SessionViewportController {
             return { data, consumed: false };
         // Platform: handle the physical paste chord at the pre-input boundary. Windows
         // terminals vary between forwarding Ctrl+V and terminal-owned bracketed paste.
-        if (editorActive && this.#editor.matchesTerminalKey(data, "ctrl+v") && this.#editor.pasteClipboard()) {
-            return { data: "", consumed: true };
+        if (editorActive && this.#editor.matchesTerminalKey(data, "ctrl+v")) {
+            pasteRequest ??= this.#nextPasteDiagnosticRequest();
+            if (data !== "\u0016")
+                this.#emitPasteRoute(pasteRequest, "shortcut-received");
+            this.#emitPasteRoute(pasteRequest, "shortcut-matched");
+            if (this.#editor.pasteClipboard()) {
+                this.#emitPasteRoute(pasteRequest, "shortcut-admitted");
+                return { data: "", consumed: true };
+            }
         }
         // Platform: URL chip deletion must overwrite terminal link cells in the same frame.
         if (editorActive && EDITOR_LINK_DELETION_INPUTS.has(data) && this.#hasEditorLinks()) {
@@ -378,7 +404,9 @@ export class SessionViewportController {
                     this.#stopSelectionAutoScroll();
                     if (this.#viewport.clearSelection())
                         repaint = true;
-                    this.#editor.pasteClipboard();
+                    const request = this.#nextPasteDiagnosticRequest();
+                    if (this.#editor.pasteClipboard())
+                        this.#emitPasteRoute(request, "pointer-admitted");
                     this.#dockPointerSuppressed = true;
                     repaint = true;
                     return true;

package/dist/integrations/pi/session-ui/system-clipboard.d.ts

@@ -1,4 +1,4 @@
-import type { PiShellClipboardContent } from "../components/index.js";
+import type { PiShellClipboardContent } from "../components/shell-shared-facade.js";
 export interface SystemClipboardImageReader {
     hasImage(): boolean;
     getImageBinary?(): Promise<readonly number[]>;

package/dist/integrations/pi/session-ui/system-clipboard.js

@@ -1,6 +1,6 @@
 import { execFile } from "node:child_process";
 import { canonicalizeClipboardImage } from "./clipboard-image.js";
-import { ImageAttachmentError } from "../../../contracts/owned-ui/index.js";
+import { ImageAttachmentError } from "../../../contracts/owned-ui/image-attachments.js";
 import { assertSourceBytes } from "./image-source.js";
 const MAX_CLIPBOARD_BYTES = 16 * 1024 * 1024;
 let nativeClipboardPromise;
@@ -85,8 +85,9 @@ export async function readSystemClipboardText(signal, strict = false) {
                 const text = await native.getText();
                 if (text.length > 0)
                     return text;
-                if (strict)
-                    return null;
+                // Compatibility: a cold native adapter can report empty before the platform
+                // command can observe the existing clipboard. Treat empty as inconclusive
+                // and continue within this request's existing abort/deadline boundary.
             }
             catch {
                 // Compatibility: fall through to the platform command.
@@ -105,7 +106,9 @@ export async function readSystemClipboardText(signal, strict = false) {
         return execClipboard("pbpaste", [], signal, strict);
     try {
         const value = await execClipboard("wl-paste", ["--no-newline", "--type", "text"], signal, strict);
-        if (strict || value !== null)
+        // Compatibility: an empty Wayland result does not prove that the X11
+        // clipboard is empty on mixed sessions. Let the existing fallback decide.
+        if (value !== null)
             return value;
     }
     catch { /* Compatibility: X11 may be available when the Wayland command is not. */ }

package/dist/integrations/pi/startup-public.d.ts

@@ -0,0 +1,2 @@
+export { ArminComponent, AssistantMessageComponent, BashExecutionComponent, BorderedLoader, CompactionSummaryMessageComponent, CredentialSynchronizationError, CustomMessageComponent, DefaultPackageManager, DynamicBorder, ExtensionInputComponent, ExtensionSelectorComponent, LoginDialogComponent, ModelRuntime, ModelSelectorComponent, OAuthSelectorComponent, ProjectTrustStore, SessionManager, SettingsManager, SettingsSelectorComponent, ShowImagesSelectorComponent, Theme, ThemeSelectorComponent, ThinkingSelectorComponent, ToolExecutionComponent, UserMessageComponent, UserMessageSelectorComponent, VERSION, convertToPng, copyToClipboard, createAgentSessionFromServices, createAgentSessionRuntime, createAgentSessionServices, createBashToolDefinition, createEditToolDefinition, createFindToolDefinition, createGrepToolDefinition, createLsToolDefinition, createReadToolDefinition, createWriteToolDefinition, getAgentDir, getMarkdownTheme, getSelectListTheme, hasTrustRequiringProjectResources, initTheme, isBashToolResult, isEditToolResult, isWriteToolResult, keyHint, keyText, parseSkillBlock, rawKeyHint, resolveModelScopeWithDiagnostics, } from "@earendil-works/pi-coding-agent";
+export type * from "@earendil-works/pi-coding-agent";