@timurproko/a1 0.2.6 → 0.2.7-dev.1222

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

@@ -0,0 +1,29 @@
+export interface SessionResumeCommandMetadata {
+    readonly sessionId: string;
+    readonly sessionDir: string;
+    readonly usesDefaultSessionDir: boolean;
+}
+export declare function formatSessionResumeCommand(metadata: SessionResumeCommandMetadata): string;
+export declare function quoteCommandArgument(value: string): string;
+export interface ExitTextInput {
+    readonly terminalMode: "regular" | "fullscreen";
+    readonly customViewport: boolean;
+    readonly exitMode: "transcript" | "resume-hint";
+    readonly resume: SessionResumeCommandMetadata | null;
+    /** The styled transcript, rendered only when the pinned profile asks for it. */
+    readonly transcript: () => string;
+}
+/**
+ * What a fullscreen leave prints into the parent terminal: nothing after a regular-screen session,
+ * only the resume hint for bare A1 or when configured, and otherwise the transcript then the hint.
+ */
+export declare function composeExitText(input: ExitTextInput): string;
+/** Resolves once when the session stops, whether it stopped itself, was quit, or was disposed. */
+export declare class SessionStopLatch {
+    #private;
+    readonly stopped: Promise<void>;
+    constructor();
+    resolve(): void;
+    /** The engine stopped on its own: dispose the shell, then resolve whether or not disposal failed. */
+    settleAfter(dispose: () => Promise<void>): void;
+}

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

@@ -0,0 +1,49 @@
+import { PRODUCT_TEXT } from "../../product-identity.js";
+export function formatSessionResumeCommand(metadata) {
+    const args = [PRODUCT_TEXT.commandName];
+    if (!metadata.usesDefaultSessionDir)
+        args.push("--session-dir", quoteCommandArgument(metadata.sessionDir));
+    args.push("--session", metadata.sessionId);
+    return args.join(" ");
+}
+export function quoteCommandArgument(value) {
+    if (value.length > 0 && !/[^a-zA-Z0-9_\-./~:@]/.test(value))
+        return value;
+    return `'${value.replaceAll("'", `'\\''`)}'`;
+}
+/**
+ * What a fullscreen leave prints into the parent terminal: nothing after a regular-screen session,
+ * only the resume hint for bare A1 or when configured, and otherwise the transcript then the hint.
+ */
+export function composeExitText(input) {
+    if (input.terminalMode !== "fullscreen")
+        return "";
+    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")
+        return resumeHint;
+    return [input.transcript(), resumeHint].filter(Boolean).join("\n\n");
+}
+/** Resolves once when the session stops, whether it stopped itself, was quit, or was disposed. */
+export class SessionStopLatch {
+    stopped;
+    #resolve;
+    constructor() {
+        this.stopped = new Promise(resolve => {
+            this.#resolve = resolve;
+        });
+    }
+    resolve() {
+        const resolve = this.#resolve;
+        this.#resolve = undefined;
+        resolve?.();
+    }
+    /** The engine stopped on its own: dispose the shell, then resolve whether or not disposal failed. */
+    settleAfter(dispose) {
+        void dispose().then(() => this.resolve(), () => this.resolve());
+    }
+}
+function dim(value) {
+    return `\u001b[2m${value}\u001b[22m`;
+}

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

@@ -4,7 +4,7 @@ import type { PiTuiPointerSurface } from "../../integrations/pi/tui-runtime/cont
 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 { 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";
@@ -43,6 +43,32 @@ 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 {
@@ -90,6 +116,13 @@ export interface OwnedUiShellPresentationOptions {
 /** Persistent prompt history: its store, its bound, the editor that recalls it, and the image sidecar. */
 export interface OwnedUiShellHistoryOptions {
     readonly store: import("../../contracts/owned-ui/index.js").PromptHistoryPort;
+    /** When present, session replacement selects a new store and sidecar, not the old session's recall. */
+    readonly sessionId?: string;
+    readonly scope?: "unique" | "shared";
+    readonly forSession?: (sessionId: string) => Pick<OwnedUiShellHistoryOptions, "store" | "imageSidecar">;
+    /** A live scope change selects the matching store for this session without copying records. */
+    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;
     /** Optional per-profile filesystem sidecar for image chip payloads. When present, submit
@@ -139,19 +172,19 @@ export interface OwnedUiShellSharedServices {
 /** 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. */
+    /** Resolves selectors and engine-backed transcript renderers. */
     readonly presenters: OwnedUiSessionPresenters;
     readonly presentation?: OwnedUiShellPresentationOptions;
     readonly history?: OwnedUiShellHistoryOptions;
     readonly suggestions?: OwnedUiShellSuggestionOptions;
-    /** Supplied only to bare A1; absent retains the fixed eight-image comparison policy. */
+    /** Bare A1 only; absent keeps the eight-image comparison limit. */
     readonly promptImages?: OwnedUiShellPromptImagesOptions;
-    /** Supplied only to the bare-A1 composition; absent keeps the pinned per-skill command list. */
+    /** Bare A1 only; absent keeps pinned per-skill commands. */
     readonly skills?: OwnedUiShellSkillsOptions;
     readonly diagnostics?: OwnedUiShellDiagnosticOptions;
     readonly shared?: OwnedUiShellSharedServices;
 }
-/** Composes backend session state into the owned transcript, viewport, editor, and dock presentation. */
+/** Composes session state into the owned transcript, viewport, editor, and dock. */
 export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
     #private;
     readonly editor: PiShellEditorPort;
@@ -165,6 +198,7 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
         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;
@@ -182,7 +216,7 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
         readonly onPromptSuggestionAccepted?: (text: string) => void;
         readonly onInputSurfaceChanged?: () => void;
         readonly onPromptSuggestionEligibilityChanged?: () => void;
-        readonly onCopyText?: (text: string) => void;
+        readonly onCopyText?: (text: string, cut: boolean) => void;
         readonly readClipboardContent?: (signal?: AbortSignal) => Promise<PiShellClipboardContent | null>;
         readonly captureClipboardPaste?: () => PasteSource;
         readonly pasteDiagnostics?: (event: PasteEvent) => void;
@@ -190,6 +224,8 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
         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);
     setEditorPaddingX(padding: number): void;
     setAutocompleteMaxVisible(maxVisible: number): void;