@timurproko/a1 0.2.6-dev.727 → 0.2.6-dev.734

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

@@ -0,0 +1,19 @@
+import type { HelperPool } from "./helper-pool.js";
+/**
+ * Process-wide clipboard helper spares. Composition creates one and every session shell borrows it, so N
+ * sessions keep at most one spare paste helper and one spare copy helper instead of 2N. Shells warm the
+ * pools after their first frame; only the creator disposes them.
+ */
+export interface OwnedUiClipboardServices {
+    readonly paste: HelperPool;
+    readonly copy: HelperPool;
+    dispose(): void;
+}
+export interface OwnedUiClipboardServicesOptions {
+    /** Package/fault-test seams for the forked helpers' entries. */
+    readonly pasteHelper?: URL;
+    readonly copyHelper?: URL;
+    /** Idle bound for both spares; production keeps the default. */
+    readonly spareIdleMs?: number;
+}
+export declare function createOwnedUiClipboardServices(options?: OwnedUiClipboardServicesOptions): OwnedUiClipboardServices;

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

@@ -0,0 +1,7 @@
+import { createPasteHelperPool } from "./paste-executor.js";
+import { createCopyHelperPool } from "./response-copy-transport.js";
+export function createOwnedUiClipboardServices(options = {}) {
+    const paste = createPasteHelperPool(options.pasteHelper, options.spareIdleMs);
+    const copy = createCopyHelperPool(options.copyHelper, options.spareIdleMs);
+    return { paste, copy, dispose: () => { paste.dispose(); copy.dispose(); } };
+}

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

@@ -1,10 +1,14 @@
 import { type SessionResumeCommandMetadata } from "./session-shell.js";
 export interface ExitNoticeSource {
-    readonly sessionGeneration: number;
-    currentSessionResumeMetadata(): SessionResumeCommandMetadata | null;
-    onEvent(listener: (event: {
-        readonly type: string;
-    }) => void): () => void;
+    readonly identity: {
+        readonly sessionGeneration: number;
+        currentSessionResumeMetadata(): SessionResumeCommandMetadata | null;
+    };
+    readonly session: {
+        onEvent(listener: (event: {
+            readonly type: string;
+        }) => void): () => void;
+    };
 }
 export interface ArmedExitNotice {
     clear(): void;

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

@@ -17,12 +17,12 @@ export function uncleanExitNoticeLines(resume) {
 export function armExitNotice(source, path) {
     let current = null;
     let cleared = false;
-    let generation = source.sessionGeneration;
+    let generation = source.identity.sessionGeneration;
     const write = () => {
         if (cleared)
             return;
         // Protocol: plain text only; the guardian strips control characters, so styling would be lost.
-        const text = `${uncleanExitNoticeLines(source.currentSessionResumeMetadata()).join("\n")}\n`;
+        const text = `${uncleanExitNoticeLines(source.identity.currentSessionResumeMetadata()).join("\n")}\n`;
         if (text === current)
             return;
         try {
@@ -35,13 +35,13 @@ export function armExitNotice(source, path) {
         catch { }
     };
     write();
-    const unsubscribe = source.onEvent(event => {
+    const unsubscribe = source.session.onEvent(event => {
         // Rationale: a session is persisted by its first response and replaced by /new or /resume;
         // these events cover both without touching the per-chunk stream.
-        const replaced = source.sessionGeneration !== generation;
+        const replaced = source.identity.sessionGeneration !== generation;
         if (!replaced && event.type !== "session-lifecycle" && event.type !== "assistant-message-completed")
             return;
-        generation = source.sessionGeneration;
+        generation = source.identity.sessionGeneration;
         write();
     });
     return {

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

@@ -1,7 +1,9 @@
 export { ClipboardDiagnosticCapture } from "./clipboard-diagnostics.js";
+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, OwnedUiShellSkillsOptions, OwnedUiShellSuggestionOptions, SessionResumeCommandMetadata, } from "./session-shell.js";
+export type { OwnedUiSessionShellOptions, 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,4 +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 { STREAM_PRESENTATION_INTERVAL_MS, StreamPresentationCoalescer } from "./stream-presentation-coalescer.js";

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

@@ -1,4 +1,5 @@
 import { startPasteExecutor } from "./paste-executor.js";
+import type { HelperPool } from "./helper-pool.js";
 import { type PasteEvent, type PasteSource, type PreparedPaste } from "./paste-protocol.js";
 export interface PreparedPasteJob<T> {
     readonly result: Promise<T>;
@@ -16,6 +17,8 @@ export interface PastePreparationClientOptions {
     readonly helper?: URL;
     /** Idle bound for the spare helper; production keeps the default. */
     readonly spareIdleMs?: number;
+    /** Process-wide spare pool shared across sessions; the client warms it but never disposes it. */
+    readonly pool?: HelperPool;
 }
 /** Keeps eight distinct paste transactions alive through insertion; canceled executors retain capacity until fenced. */
 export declare class PastePreparationClient {

package/dist/app/session-shell/paste-preparation-client.js

@@ -8,13 +8,15 @@ export class PastePreparationClient {
     #execute;
     #helper;
     #pool;
+    #ownsPool;
     #sequence = 0;
     #disposed = false;
     constructor(options = {}) {
         this.#onEvent = options.onEvent;
         this.#execute = options.execute ?? startPasteExecutor;
         this.#helper = options.helper;
-        this.#pool = options.execute === undefined ? createPasteHelperPool(options.helper, options.spareIdleMs) : undefined;
+        this.#pool = options.execute === undefined ? options.pool ?? createPasteHelperPool(options.helper, options.spareIdleMs) : undefined;
+        this.#ownsPool = options.pool === undefined;
     }
     /** Forks the spare helper now so the first paste takes a live child; later pastes rewarm it themselves. */
     warm() { this.#pool?.warm(); }
@@ -160,7 +162,8 @@ export class PastePreparationClient {
     async dispose() {
         this.#disposed = true;
         this.reset();
-        this.#pool?.dispose();
+        if (this.#ownsPool)
+            this.#pool?.dispose();
         let timer;
         await Promise.race([Promise.all([...this.#active].map(active => active.stopped)),
             new Promise(resolve => { timer = setTimeout(resolve, PASTE_STOP_MS); timer.unref(); })]);

package/dist/app/session-shell/path-chip-presentation.d.ts

@@ -1,7 +1,14 @@
 import type { ClipboardPath, PreparedPasteText } from "./paste-types.js";
 export declare const PATH_CHIP_PRESENTATION_UNITS = 4096;
-export declare const PATH_CHIP_SUFFIX_UNITS = 20;
-/** Shared base tag for presentation budgeting and actual chip adoption, including image-file spacing. */
-export declare function pathChipTag(item: ClipboardPath): string;
+/** Normalizes a path for host-filesystem identity comparisons. */
+export declare function normalizedPathIdentity(fullPath: string): string;
+/** Yields labels from the basename through the normalized rooted path, shortest first. */
+export declare function pathChipLabelCandidates(fullPath: string): Iterable<string>;
+/** Formats one path label with the established folder/file/image-file icon. */
+export declare function pathChipTag(item: ClipboardPath, label?: string): string;
+/** Yields complete deterministic tags lazily for path collision adoption. */
+export declare function pathChipTagCandidates(item: ClipboardPath): Iterable<string>;
+/** Returns the conservative UTF-16 presentation cost for one path occurrence. */
+export declare function pathChipPresentationUnits(item: ClipboardPath): number;
 /** Run in the isolated preparer: compact before path arrays become an oversized editor presentation. */
 export declare function preparePathPresentation(paths: readonly ClipboardPath[]): PreparedPasteText;

package/dist/app/session-shell/path-chip-presentation.js

@@ -1,19 +1,52 @@
 import path from "node:path";
 export const PATH_CHIP_PRESENTATION_UNITS = 4096;
-// Invariant: a collision suffix containing any safe-integer index fits this per-occurrence reserve.
-export const PATH_CHIP_SUFFIX_UNITS = 20;
 const IMAGE_EXTENSION = /\.(?:jpe?g|png|webp|gif|bmp|tiff?)$/iu;
-/** Shared base tag for presentation budgeting and actual chip adoption, including image-file spacing. */
-export function pathChipTag(item) {
-    const label = path.basename(item.fullPath) || path.parse(item.fullPath).root.replace(/[\\/]+$/u, "") || item.fullPath;
+/** Normalizes a path for host-filesystem identity comparisons. */
+export function normalizedPathIdentity(fullPath) {
+    const normalized = path.normalize(fullPath.trim());
+    return process.platform === "win32" ? normalized.toLowerCase() : normalized;
+}
+/** Yields labels from the basename through the normalized rooted path, shortest first. */
+export function* pathChipLabelCandidates(fullPath) {
+    const normalized = path.normalize(fullPath.trim());
+    const parsed = path.parse(normalized);
+    const relative = normalized.slice(parsed.root.length);
+    const segments = relative.split(path.sep).filter(segment => segment.length > 0);
+    let previous = "";
+    for (let depth = 1; depth <= segments.length; depth++) {
+        previous = segments.slice(-depth).join("/");
+        yield previous;
+    }
+    const rooted = displayPath(normalized);
+    if (segments.length === 0) {
+        const root = displayPath(parsed.root).replace(/\/$/u, "");
+        if (root.length > 0) {
+            previous = root;
+            yield root;
+        }
+    }
+    if (rooted.length > 0 && rooted !== previous)
+        yield rooted;
+}
+/** Formats one path label with the established folder/file/image-file icon. */
+export function pathChipTag(item, label = basePathLabel(item.fullPath)) {
     const icon = item.kind === "folder" ? "📁" : IMAGE_EXTENSION.test(item.fullPath) ? "🖼 " : "📄";
     return `[${icon} ${label}]`;
 }
+/** Yields complete deterministic tags lazily for path collision adoption. */
+export function* pathChipTagCandidates(item) {
+    for (const label of pathChipLabelCandidates(item.fullPath))
+        yield pathChipTag(item, label);
+}
+/** Returns the conservative UTF-16 presentation cost for one path occurrence. */
+export function pathChipPresentationUnits(item) {
+    return pathChipTag(item, displayPath(path.normalize(item.fullPath.trim()))).length;
+}
 /** Run in the isolated preparer: compact before path arrays become an oversized editor presentation. */
 export function preparePathPresentation(paths) {
     let units = 0;
     for (const item of paths) {
-        units += pathChipTag(item).length + PATH_CHIP_SUFFIX_UNITS;
+        units += pathChipPresentationUnits(item);
         if (units > PATH_CHIP_PRESENTATION_UNITS) {
             // Compatibility: individual adjacent chips expand without inserted separators or text re-normalization.
             const text = paths.map(value => value.fullPath).join("");
@@ -22,3 +55,12 @@ export function preparePathPresentation(paths) {
     }
     return { kind: "paths", paths };
 }
+function basePathLabel(fullPath) {
+    const normalized = path.normalize(fullPath.trim());
+    return path.basename(normalized)
+        || displayPath(path.parse(normalized).root).replace(/\/$/u, "")
+        || displayPath(normalized);
+}
+function displayPath(value) {
+    return path.sep === "\\" ? value.replaceAll("\\", "/") : value;
+}

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

@@ -1,10 +1,9 @@
 import { randomBytes } from "node:crypto";
-import path from "node:path";
 import { canonicalizeClipboardImage } from "./clipboard-image.js";
 import { assertImageEncodedSize, assertPromptImages, canonicalPromptChipMatches, DEFAULT_PROMPT_IMAGE_LIMIT, ImageAttachmentError, replaceCanonicalPromptChips, } from "../../contracts/owned-ui/index.js";
 import { ImagePreparationClient } from "./image-preparation-client.js";
 import { preparePasteText } from "./paste-text-preparation.js";
-import { pathChipTag } from "./path-chip-presentation.js";
+import { normalizedPathIdentity, pathChipTagCandidates } from "./path-chip-presentation.js";
 import { PastePreparationClient } from "./paste-preparation-client.js";
 const URL_SUBSTRING_PATTERN = /https?:\/\/[^\s\u0000-\u001f\u007f\]]+/giu;
 const IMAGE_CHIP_IDENTIFIER_PATTERN = /^\[📷 screenshot-([a-f0-9]+)(?:-resized)?\]$/u;
@@ -23,6 +22,7 @@ function referencesPasteMarker(text, entry) {
 /** Owns semantic chips and bounded pending paste references; cancels background work on reset or disposal. */
 export class PromptChipStore {
     #chips = new Map();
+    #pathTags = new Map();
     // Invariant: clearing the editor never recycles a recoverable text chip's identity.
     #textCounter = 0;
     #pending = new Map();
@@ -199,6 +199,7 @@ export class PromptChipStore {
     async dispose() {
         await Promise.all([this.#preparation.dispose(), this.#isolated?.dispose(), ...this.#stopping]);
         this.#chips.clear();
+        this.#pathTags.clear();
         this.#pending.clear();
         this.#countRejectedImages.clear();
         this.#provisionalOwners.clear();
@@ -269,7 +270,26 @@ export class PromptChipStore {
             this.#claimChip(tag, owner, true);
             return tag;
         }
-        return paste.paths.map(item => this.#recordUnique({ kind: item.kind, tag: pathChipTag(item), path: item.fullPath }, owner)).join("");
+        return paste.paths.map(item => this.#recordPath(item, owner)).join("");
+    }
+    #recordPath(item, owner) {
+        const key = pathChipKey(item);
+        const establishedTag = this.#pathTags.get(key);
+        if (establishedTag !== undefined && this.#chips.has(establishedTag)) {
+            this.#claimChip(establishedTag, owner, false);
+            return establishedTag;
+        }
+        for (const tag of pathChipTagCandidates(item)) {
+            const chip = { kind: item.kind, tag, path: item.fullPath };
+            const existing = this.#chips.get(tag);
+            if (existing !== undefined && !sameChipValue(existing, chip))
+                continue;
+            this.#chips.set(tag, chip);
+            this.#pathTags.set(key, tag);
+            this.#claimChip(tag, owner, existing === undefined);
+            return tag;
+        }
+        throw new Error("Path chip labels could not distinguish normalized paths");
     }
     /** Hide provisional clipboard identities until the read identifies an actual image. */
     hiddenRanges(line) {
@@ -501,7 +521,10 @@ export class PromptChipStore {
                 owners.delete(owner);
                 if (owners.size === 0) {
                     this.#provisionalOwners.delete(tag);
+                    const chip = this.#chips.get(tag);
                     this.#chips.delete(tag);
+                    if (chip?.kind === "file" || chip?.kind === "folder")
+                        this.#pathTags.delete(pathChipKey(chip));
                 }
             }
         }
@@ -522,13 +545,16 @@ export class PromptChipStore {
         return uniqueTag;
     }
 }
+function pathChipKey(item) {
+    return `${item.kind}\0${normalizedPathIdentity("fullPath" in item ? item.fullPath : item.path)}`;
+}
 function sameChipValue(left, right) {
     if (left.kind !== right.kind)
         return false;
     if (left.kind === "url" && right.kind === "url")
         return left.url === right.url;
     if ((left.kind === "file" || left.kind === "folder") && (right.kind === "file" || right.kind === "folder")) {
-        return path.normalize(left.path) === path.normalize(right.path);
+        return normalizedPathIdentity(left.path) === normalizedPathIdentity(right.path);
     }
     if (left.kind === "image" && right.kind === "image")
         return left.image.data === right.image.data;

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

@@ -15,6 +15,8 @@ export interface QuitOutroPlayback {
     sleep?(ms: number): Promise<void>;
     /** Plan seed; defaults to a time- and geometry-derived value. */
     readonly seed?: number;
+    /** Active bare-A1 canvas; omitted preserves transparent playback bytes. */
+    readonly canvasBackgroundAnsi?: string;
 }
 export declare const QUIT_OUTRO_MIN_MS = 300;
 export declare const QUIT_OUTRO_MAX_MS = 2000;
@@ -29,7 +31,7 @@ export declare function clampQuitOutroDuration(durationMs: number): number;
  */
 export declare function captureQuitOutroFrame(presented: readonly string[], columns: number, rows: number): QuitOutroFrame | null;
 /** The clear-and-repaint block that seeds the animation surface with the captured frame. */
-export declare function createQuitOutroSurfaceFrame(frame: QuitOutroFrame): string;
+export declare function createQuitOutroSurfaceFrame(frame: QuitOutroFrame, canvasBackgroundAnsi?: string): string;
 /**
  * Plays the effect over the frame. Resolves true when the plan was played to
  * completion or abandoned at its guard, false when there was nothing to play.

package/dist/app/session-shell/quit-outro.js

@@ -6,6 +6,7 @@
  * terminal cannot delay restoration past the configured clamp.
  */
 import { displayWidth, truncateToWidth } from "../../ui/components/index.js";
+import { rebaseTerminalDefaultBackground } from "../../integrations/pi/tui-runtime/index.js";
 import { createQuitOutroPlan } from "./quit-outro-effects.js";
 export const QUIT_OUTRO_MIN_MS = 300;
 export const QUIT_OUTRO_MAX_MS = 2000;
@@ -44,14 +45,25 @@ export function captureQuitOutroFrame(presented, columns, rows) {
     return { lines, columns: width, rows: height, rowWidths };
 }
 /** The clear-and-repaint block that seeds the animation surface with the captured frame. */
-export function createQuitOutroSurfaceFrame(frame) {
-    let output = `${SYNC_BEGIN}${HIDE_CURSOR}${CLEAR_SCREEN}${HOME}${RESET}`;
+export function createQuitOutroSurfaceFrame(frame, canvasBackgroundAnsi) {
+    if (canvasBackgroundAnsi === undefined) {
+        let output = `${SYNC_BEGIN}${HIDE_CURSOR}${CLEAR_SCREEN}${HOME}${RESET}`;
+        for (let row = 0; row < frame.rows; row++) {
+            const line = frame.lines[row] ?? "";
+            if (frame.rowWidths[row] > 0)
+                output += `${cursorAt(row, 0)}${line}${RESET}`;
+        }
+        return `${output}${SYNC_END}`;
+    }
+    let output = `${SYNC_BEGIN}${HIDE_CURSOR}${RESET}${canvasBackgroundAnsi}${CLEAR_SCREEN}${HOME}`;
     for (let row = 0; row < frame.rows; row++) {
         const line = frame.lines[row] ?? "";
-        if (frame.rowWidths[row] > 0)
-            output += `${cursorAt(row, 0)}${line}${RESET}`;
+        if (frame.rowWidths[row] > 0) {
+            output += `${cursorAt(row, 0)}${canvasBackgroundAnsi}`
+                + `${rebaseTerminalDefaultBackground(line, canvasBackgroundAnsi)}${RESET}${canvasBackgroundAnsi}`;
+        }
     }
-    return `${output}${SYNC_END}`;
+    return `${output}${RESET}${SYNC_END}`;
 }
 /**
  * Plays the effect over the frame. Resolves true when the plan was played to
@@ -69,20 +81,23 @@ export async function playQuitOutro(frame, effect, durationMs, playback) {
     let sparkleIndex = 0;
     let clearIndex = 0;
     let ticks = 0;
-    playback.write(createQuitOutroSurfaceFrame(frame));
+    const canvas = playback.canvasBackgroundAnsi;
+    playback.write(createQuitOutroSurfaceFrame(frame, canvas));
     const startedAt = now();
     for (;;) {
         ticks += 1;
         const elapsed = now() - startedAt;
         const progress = Math.min(1, elapsed / duration);
-        let output = `${SYNC_BEGIN}${RESET}`;
+        let output = canvas === undefined ? `${SYNC_BEGIN}${RESET}` : `${SYNC_BEGIN}${RESET}${canvas}`;
         while (sparkleIndex < plan.sparkles.length && plan.sparkles[sparkleIndex].start <= progress) {
             const cell = plan.sparkles[sparkleIndex++];
             output += `${cursorAt(cell.row, cell.col)}${cell.color}${cell.glyph}`;
         }
         while (clearIndex < plan.clears.length && plan.clears[clearIndex].end <= progress) {
             const cell = plan.clears[clearIndex++];
-            output += `${cursorAt(cell.row, cell.col)}${RESET} `;
+            output += canvas === undefined
+                ? `${cursorAt(cell.row, cell.col)}${RESET} `
+                : `${cursorAt(cell.row, cell.col)}${RESET}${canvas} `;
         }
         const finished = clearIndex >= plan.clears.length || progress >= 1
             || elapsed > duration + QUIT_OUTRO_GUARD_MS || ticks >= QUIT_OUTRO_MAX_TICKS;

package/dist/app/session-shell/response-copy-transport.d.ts

@@ -1,3 +1,4 @@
+import { HelperPool } from "./helper-pool.js";
 import type { SelectionCopySnapshot } from "../../ui/components/selection-copy.js";
 import { type CopyResult } from "./response-copy-protocol.js";
 export interface ResponseCopyJob {
@@ -8,7 +9,7 @@ export interface ResponseCopyJob {
 }
 export type CopyPhaseObserver = (phase: "extracted" | "encoded" | "submitting", bytes: number, transport: "native" | "terminal" | "injected") => void;
 export type ResponseCopyExecutor = (snapshot: SelectionCopySnapshot, phase: CopyPhaseObserver) => ResponseCopyJob;
-/** The production executor also owns a spare helper; the owner warms it at start and disposes it at shutdown. */
+/** The production executor also holds a spare helper; the owner warms it at start and disposes it at shutdown unless the pool is shared. */
 export interface OwnedResponseCopyExecutor extends ResponseCopyExecutor {
     warm(): void;
     dispose(): void;
@@ -36,4 +37,8 @@ export declare function createResponseCopyExecutor(options?: {
     readonly helper?: URL;
     /** Idle bound for the spare helper; production keeps the default. */
     readonly spareIdleMs?: number;
+    /** Process-wide spare pool shared across sessions; the executor warms it but never disposes it. */
+    readonly pool?: HelperPool;
 }): OwnedResponseCopyExecutor;
+/** A spare-of-one pool of copy helpers; `createResponseCopyExecutor` takes its child and warms the next one after each copy. */
+export declare function createCopyHelperPool(helper?: URL, idleMs?: number): HelperPool;

package/dist/app/session-shell/response-copy-transport.js

@@ -23,7 +23,8 @@ export function hasAsyncClipboardOutput(platform = process.platform, stdout = pr
 }
 /** Isolates preparation and native clipboard access; only the owner may submit terminal controls. */
 export function createResponseCopyExecutor(options = {}) {
-    const pool = new HelperPool({ fork: () => forkCopyHelper(options.helper), stop: stopCopyHelper, ...(options.spareIdleMs === undefined ? {} : { idleMs: options.spareIdleMs }) });
+    const pool = options.pool ?? createCopyHelperPool(options.helper, options.spareIdleMs);
+    const ownsPool = options.pool === undefined;
     const execute = (snapshot, phase) => {
         const controller = new AbortController();
         let active;
@@ -70,10 +71,15 @@ export function createResponseCopyExecutor(options = {}) {
     // Rationale: `Object.assign` would copy the getter's value once; the accessor must read the pool each time.
     return Object.defineProperties(execute, {
         warm: { value: () => pool.warm() },
-        dispose: { value: () => pool.dispose() },
+        dispose: { value: () => { if (ownsPool)
+                pool.dispose(); } },
         warmed: { get: () => pool.warmed },
     });
 }
+/** A spare-of-one pool of copy helpers; `createResponseCopyExecutor` takes its child and warms the next one after each copy. */
+export function createCopyHelperPool(helper, idleMs) {
+    return new HelperPool({ fork: () => forkCopyHelper(helper), stop: stopCopyHelper, ...(idleMs === undefined ? {} : { idleMs }) });
+}
 /** Forks one copy helper: bounded IPC only, no clipboard payload in argv or temp files, no inherited terminal descriptors. */
 function forkCopyHelper(helper) {
     const source = new URL(import.meta.url).pathname.endsWith(".ts");

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

@@ -1,23 +1,21 @@
 import { ImageAttachmentError } from "../../contracts/owned-ui/index.js";
-import type { OwnedUiPromptSuggestionGeneratorPort, OwnedUiSessionViewModel, OwnedUiViewportSettings, OwnedUiViewportSettingsPort, OwnedUiQuitOutroSettingsPort, SuggestionDecision, SuggestionDiagnosticObserver } 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 { UiRouteHost, UiRouteInput } from "../../ui/apps/contracts.js";
 import type { TranscriptViewportFrame, TranscriptViewportFrameDescriptor } from "../../ui/components/transcript-viewport.js";
-import type { PiEngineAdapter } from "../../integrations/pi/engine/adapter.js";
-import type { PiWorkflowMessage, PiWorkflowResult } from "../../integrations/pi/engine/workflows.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 PiShellEditorPort, type PiShellExtensionRendererResolver, type PiShellHeaderOptions, type PiShellHeaderPort, type PiShellImageAssetResolver, type PiShellLoadedResourcesPort, type PiShellResourceEntry, type PiShellTranscriptComponentPort } from "../../integrations/pi/components/shell-shared-facade.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 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 type { StreamPresentationScheduler } from "./stream-presentation-coalescer.js";
-export type OwnedUiBackendPort = PiEngineAdapter;
 export type OwnedUiTerminalPort = PiTuiTerminalPort;
 type OwnedUiStartupOptions = PiShellHeaderOptions;
 export interface OwnedUiClipboardPort {
@@ -30,7 +28,7 @@ export interface OwnedUiClipboardPort {
 }
 /** The engine session the shell presents and the composition's decisions about it. */
 export interface OwnedUiShellEngineOptions {
-    readonly backend: OwnedUiBackendPort;
+    readonly backend: OwnedUiSessionBackend;
     readonly cwd: string;
     /**
      * Declared A1-owned routes. A route this host claims resolves to its app;
@@ -52,6 +50,8 @@ export interface OwnedUiShellPresentationOptions {
     readonly startup?: OwnedUiStartupOptions;
     /** Live profile-local settings, supplied only to the bare-A1 composition. */
     readonly viewportSettings?: OwnedUiViewportSettingsPort;
+    /** Live fullscreen canvas choice, supplied only to the bare-A1 composition. */
+    readonly backgroundSettings?: OwnedUiBackgroundSettingsPort;
     /** Deterministic scheduling seam for presentation-cadence tests. */
     readonly stream?: {
         readonly intervalMs?: number;
@@ -130,9 +130,17 @@ export interface OwnedUiShellSkillsOptions {
     readonly presentation: () => "collapse" | "expand";
     readonly onChange: (listener: () => void) => () => void;
 }
+/** Process-wide services composition creates once and every session shell borrows; absent, a shell keeps private ones. */
+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;
+}
 /** What composes an owned session shell, grouped by the collaborator that provides each part. */
 export interface OwnedUiSessionShellOptions {
     readonly engine: OwnedUiShellEngineOptions;
+    /** Opens the selectors and resolves the transcript renderers whose inputs are engine objects. */
+    readonly presenters: OwnedUiSessionPresenters;
     readonly presentation?: OwnedUiShellPresentationOptions;
     readonly history?: OwnedUiShellHistoryOptions;
     readonly suggestions?: OwnedUiShellSuggestionOptions;
@@ -141,6 +149,7 @@ export interface OwnedUiSessionShellOptions {
     /** Supplied only to the bare-A1 composition; absent keeps the pinned per-skill command list. */
     readonly skills?: OwnedUiShellSkillsOptions;
     readonly diagnostics?: OwnedUiShellDiagnosticOptions;
+    readonly shared?: OwnedUiShellSharedServices;
 }
 /** Composes backend session state into the owned transcript, viewport, editor, and dock presentation. */
 export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
@@ -178,9 +187,10 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
         readonly captureClipboardPaste?: () => PasteSource;
         readonly pasteDiagnostics?: (event: PasteEvent) => void;
         readonly pastePreparation?: Omit<PastePreparationClientOptions, "onEvent">;
+        readonly keybindings?: PiKeybindingsHost;
         readonly promptImageLimit?: () => number;
         readonly skillsPresentation?: () => "collapse" | "expand";
-    }, startup?: PiShellHeaderOptions, agentDir?: string, extensionRenderers?: PiShellExtensionRendererResolver, sessionLayout?: "pinned" | "custom-viewport", imageAssets?: PiShellImageAssetResolver);
+    }, startup?: PiShellHeaderOptions, agentDir?: string, extensionRenderers?: OwnedUiTranscriptRendererPort, sessionLayout?: "pinned" | "custom-viewport", imageAssets?: PiShellImageAssetResolver);
     setEditorPaddingX(padding: number): void;
     setAutocompleteMaxVisible(maxVisible: number): void;
     setOutputPad(padding: 0 | 1): void;
@@ -266,8 +276,8 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
     transcriptComponent(id: string): PiShellTranscriptComponentPort | undefined;
     exitTranscript(width: number): string;
     appendWorkflowStatus(message: string): void;
-    appendWorkflowMessage(message: PiWorkflowMessage, errorCode?: ImageAttachmentError["code"]): void;
-    appendWorkflowResult(result: PiWorkflowResult, errorCode?: ImageAttachmentError["code"]): void;
+    appendWorkflowMessage(message: OwnedUiWorkflowMessage, errorCode?: ImageAttachmentError["code"]): void;
+    appendWorkflowResult(result: OwnedUiWorkflowResult, errorCode?: ImageAttachmentError["code"]): void;
     toggleThinkingVisibility(): void;
     get toolsExpanded(): boolean;
     setToolsExpanded(expanded: boolean): void;
@@ -296,5 +306,5 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
     setFocused(focused: boolean): void;
     dispose(): void;
 }
-export declare function shellResourceEntries(backend: OwnedUiBackendPort): readonly PiShellResourceEntry[];
+export declare function shellResourceEntries(backend: OwnedUiSessionBackend): readonly PiShellResourceEntry[];
 export {};

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

@@ -5,11 +5,9 @@ import { composeSubmittedPromptRows, formatSubmittedPromptTime, submittedPromptL
 import { backgroundSgrSpan, heldNativeHyperlinkStyle, hyperlinkSgrSpan, nativeHyperlinkStyle, overlaySpan, } from "../../ui/components/spans.js";
 import { progressStatusFrame, 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 "../../integrations/pi/engine/workflows.js";
-import { createPiExtensionUiBridge } from "../../integrations/pi/components/shell-extension-ui.js";
 import { createPiShellEditor } from "../../integrations/pi/components/shell-editor-autocomplete.js";
 import { createPiQueuedInputStatus, createPiShellFooter, createPiShellHeader, createPiShellLoadedResources, createPiShellStatus, } from "../../integrations/pi/components/shell-footer-status.js";
-import { createPiShellArmin, createPiShellAuthProviderSelector, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellExtensionSelector, createPiShellLoginDialog, createPiShellModelSelector, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, } from "../../integrations/pi/components/shell-selectors-dialogs.js";
+import { createPiShellArmin, createPiShellEarendilAnnouncement, } from "../../integrations/pi/components/shell-selectors-dialogs.js";
 import { createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellHotkeys, createPiShellSessionInfo, renderPiShellCommandMessage, renderPiShellPackageUpdateNotice, renderPiShellReleaseUpdateBanner, renderPiShellReleaseUpdateNotice, renderPiShellStatusText, } from "../../integrations/pi/components/shell-presenters-info.js";
 import { createPiShellTranscriptComponent, isPiPromptStyleCompaction, paintPiSubmittedPromptTimestamp, renderPiShellStartupDiagnostic, renderPiShellTranscriptBlock, } from "../../integrations/pi/components/shell-presenters-transcript.js";
 import { onPiThemeChange, PINNED_PI_LAYOUT, piTheme } from "../../integrations/pi/components/upstream/theme/theme.js";
@@ -88,6 +86,7 @@ export class OwnedUiSessionShellRoot {
     constructor(view, cwd, handlers, startup = {}, agentDir, extensionRenderers = {
         getMessageRenderer: () => undefined,
         getToolRenderers: () => undefined,
+        getShortcuts: () => [],
     }, sessionLayout = "pinned", imageAssets) {
         this.#view = view;
         this.#customViewport = sessionLayout === "custom-viewport";
@@ -124,6 +123,7 @@ export class OwnedUiSessionShellRoot {
         this.editor = createPiShellEditor({
             ...handlers,
             keybindingProfile: this.#customViewport ? "a1" : "pi",
+            ...(handlers.keybindings === undefined ? {} : { keybindings: handlers.keybindings }),
             paintEditorSelection: (line, from, to, atomic) => backgroundSgrSpan(line, from, to, atomic ? "\u001b[7m" : "\u001b[27m\u001b[48;2;38;79;120m", atomic ? "\u001b[27m" : "\u001b[49m", piShellVisibleWidth),
             transformPastedContent: content => {
                 try {
@@ -1071,7 +1071,7 @@ export class OwnedUiSessionShellRoot {
     hotkeysPresentation() {
         return {
             bindings: this.editor.keybindingConfig(),
-            getShortcuts: bindings => this.#extensionRenderers.getShortcuts?.(bindings) ?? [],
+            getShortcuts: bindings => this.#extensionRenderers.getShortcuts(bindings),
             profile: this.#customViewport ? "a1" : "pi",
         };
     }
@@ -1381,7 +1381,7 @@ function layoutPort(render, invalidate, handleInput) {
     };
 }
 export function shellResourceEntries(backend) {
-    const resources = backend.nonVisualResources().map(resource => ({
+    const resources = backend.extensions.nonVisualResources().map(resource => ({
         section: resource.kind === "skill"
             ? "Skills"
             : resource.kind === "prompt-template"
@@ -1397,7 +1397,7 @@ export function shellResourceEntries(backend) {
         sourcePath: resource.sourcePath,
         diagnostic: resource.diagnostic,
     }));
-    const extensions = backend.extensionResources().filter(extension => !extension.hidden);
+    const extensions = backend.extensions.extensionResources().filter(extension => !extension.hidden);
     const loadedExtensions = extensions.filter(extension => extension.diagnostic === null);
     const extensionLabels = compactExtensionLabels(loadedExtensions);
     for (const extension of extensions) {