@timurproko/a1 0.2.7-dev.779 → 0.2.7-dev.792

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

@@ -53,7 +53,6 @@ export interface OwnedUiShellEngineOptions {
             readonly sessionFile: string | null;
             readonly kind: "prompt" | "steer" | "follow-up";
             readonly text: string;
-            readonly images?: readonly unknown[];
         }): Promise<{
             readonly id: string;
         }>;

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

@@ -96,9 +96,8 @@ export class OwnedUiSessionShellRoot {
             ...(handlers.promptImageLimit === undefined ? {} : { imageLimit: handlers.promptImageLimit }) });
         this.#submittedPromptComposer = this.#customViewport
             ? {
-                layout: submittedPromptLayout,
-                compose: (rows, width, source, style) => composeSubmittedPromptRows(rows, width, source, { ...style, prefix: text => promptArrow(text, piTheme()) })
-                    .map(row => nativeHyperlinkStyle(row, nativeTranscriptLinkColor)),
+                layout: (width, source) => submittedPromptLayout(width, source, this.#viewportController.config.timeFormat ?? "8:00 PM"),
+                compose: (rows, width, source, style) => composeSubmittedPromptRows(rows, width, source, { ...style, prefix: text => promptArrow(text, piTheme()) }, this.#viewportController.config.timeFormat ?? "8:00 PM").map(row => nativeHyperlinkStyle(row, nativeTranscriptLinkColor)),
             }
             : undefined;
         this.#cwd = cwd;
@@ -430,6 +429,23 @@ export class OwnedUiSessionShellRoot {
         const selectableDocumentRowCount = document.rows.length;
         const dockStartRow = height - dockRows.length + 1;
         const editorOffset = dock.editorOffset;
+        // Rationale: rendered chip tags are lossy presentation (truncated labels), so a frame drag over
+        // a draft holding chips stays visual-only; editor-owned word/line selection still copies the
+        // expanded chip text through its semantic route.
+        const draft = this.usesDefaultInputSurface() ? this.editor.getText() : "";
+        const promptCopyRows = draft.length > 0
+            && !draft.split("\n").some(line => this.#promptChips.atomicRanges(line).length > 0)
+            ? Math.max(0, dock.inputRows - 2)
+            : 0;
+        const copyableDockRows = [
+            ...Array.from({ length: promptCopyRows }, (_value, index) => ({
+                row: editorOffset + index + 1,
+                prompt: index === 0 ? "first" : "continuation",
+            })),
+            ...Array.from({ length: dock.footerRows }, (_value, index) => ({
+                row: dockRows.length - dock.footerRows + index,
+            })),
+        ];
         this.#viewportController.setInputSurfaceFrame(this.usesDefaultInputSurface() ? undefined : {
             component: this.#inputSurface,
             columnStart: 1,
@@ -458,7 +474,7 @@ export class OwnedUiSessionShellRoot {
             && snapshot.inputSurface === inputSurface
             && snapshot.viewportRevision === viewportRevision
             && snapshot.selectionRevision === selectionRevision
-            ? this.#viewportController.composeDockOnly(dockRows, width, height, dock.footerRows)
+            ? this.#viewportController.composeDockOnly(dockRows, width, height, copyableDockRows)
             : null;
         if (frame === null) {
             frame = this.#viewportController.compose({
@@ -474,7 +490,7 @@ export class OwnedUiSessionShellRoot {
                 ...(document.liveTailStartRow === undefined ? {} : { liveTailStartRow: document.liveTailStartRow }),
                 bottomAlignedTailRowCount: steeringRows.length + statusRows.length,
                 dockRows,
-                explicitCopyDockRows: dock.footerRows,
+                copyableDockRows,
                 promptAnchors: document.promptAnchors,
                 width,
                 height,
@@ -541,8 +557,11 @@ export class OwnedUiSessionShellRoot {
         return this.#viewportController.hasSelection || this.editor.hasSelection();
     }
     setViewportConfig(config) {
-        if (this.#viewportController.setConfig(config))
+        if (this.#viewportController.setConfig(config)) {
+            this.#renderedRows.clear();
             this.#documentLayouts.clear();
+            this.#visibleViewportSnapshot = undefined;
+        }
     }
     setFullscreenCopyOnSelect(enabled) {
         this.#viewportController.setCopyOnSelect(enabled);
@@ -751,11 +770,13 @@ export class OwnedUiSessionShellRoot {
             }
             rows.push(...blockRows);
             if (promptLike && blockRows[0] !== undefined) {
+                const source = pinnedPromptSource(block, blockRows[0], blockWidth, this.#viewportController.config.timeFormat);
                 promptAnchors.push({
                     id: block.id,
                     firstRow,
                     lastRow: Math.max(firstRow, rows.length - 1),
-                    sourceRow: pinnedPromptSourceRow(block, blockRows[0], blockWidth),
+                    sourceRow: source.row,
+                    copySuffixWidth: source.copySuffixWidth,
                     prominentSourceRow: blockRows[0],
                 });
             }
@@ -960,9 +981,10 @@ export class OwnedUiSessionShellRoot {
             return;
         }
         // Rationale: the pinned engine links both share URLs; the workflow result carries the plain URLs.
-        const message = result.command === "share" && result.detail
-            ? `${linkShareUrl(result.message)}\nGist: ${piShellHyperlink(result.detail)}`
-            : result.message;
+        const message = result.command !== "share" ? result.message
+            : result.detail ? `${linkShareUrl(result.message)}\nGist: ${piShellHyperlink(result.detail)}`
+                // Protocol: Radius shares carry only the artifact URL.
+                : linkShareUrl(result.message);
         this.appendWorkflowStatus(message);
     }
     toggleThinkingVisibility() {
@@ -1321,20 +1343,25 @@ function withoutTerminalBackground(text) {
     return text.replace(TERMINAL_BACKGROUND, "");
 }
 /** Preserve the stable metadata-grey foreground for every pinned timestamp state. */
-function pinnedPromptSourceRow(block, sourceRow, width) {
+function pinnedPromptSource(block, sourceRow, width, timeFormat) {
+    const unchanged = { row: sourceRow, copySuffixWidth: 0 };
     if (typeof block.payload !== "object" || block.payload === null)
-        return sourceRow;
+        return unchanged;
     const value = block.payload.timestamp;
     if (typeof value !== "number" || !Number.isFinite(value))
-        return sourceRow;
-    const timestamp = formatSubmittedPromptTime(value);
-    if (timestamp === null || submittedPromptLayout(width, value).timestamp === null)
-        return sourceRow;
+        return unchanged;
+    const format = timeFormat ?? "8:00 PM";
+    const timestamp = formatSubmittedPromptTime(value, format);
+    if (timestamp === null || submittedPromptLayout(width, value, format).timestamp === null)
+        return unchanged;
     const rowWidth = displayWidth(sourceRow);
     const timestampWidth = displayWidth(timestamp);
     if (rowWidth < timestampWidth)
-        return sourceRow;
-    return overlaySpan(sourceRow, rowWidth - timestampWidth, rowWidth, paintPiSubmittedPromptTimestamp(timestamp));
+        return unchanged;
+    return {
+        row: overlaySpan(sourceRow, rowWidth - timestampWidth, rowWidth, paintPiSubmittedPromptTimestamp(timestamp)),
+        copySuffixWidth: timestampWidth,
+    };
 }
 /**
  * The pinned-profile screen: a followed transcript scroll above the dock. The runtime mounts one such layout,

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

@@ -270,7 +270,7 @@ export class OwnedUiSessionPresenter {
             // Invariant: the presenter owns its root (theme subscription and helper clients) and disposes it once the
             // terminal no longer renders it.
             constructed.push(() => this.root.dispose());
-            this.#restoreResidentInput();
+            this.#restoreResidentInput(options.history?.imageSidecar);
             const initialPiSettings = this.backend.settings.snapshot();
             this.#programStatus = new ProgramStatusReporter(status => this.#terminal.setProgramStatus(status), () => this.view().status.footer?.sessionName ?? undefined);
             this.#reloadPresentation = reloadPresentation;
@@ -802,7 +802,6 @@ export class OwnedUiSessionPresenter {
                 sessionFile: this.#currentSessionFile(),
                 kind: type,
                 text: input,
-                ...(prepared.images.length === 0 ? {} : { images: prepared.images }),
             });
         }
         catch {
@@ -1213,11 +1212,13 @@ export class OwnedUiSessionPresenter {
             this.#resolveStoppedLifecycle();
         }
     }
-    #restoreResidentInput() {
+    #restoreResidentInput(imageSidecar) {
         const recovered = this.#residentTabOptions?.recovered;
         if (recovered === undefined)
             return;
-        const prompts = recovered.prompts.map(prompt => prompt.text).filter(Boolean);
+        const prompts = recovered.prompts
+            .map(prompt => this.root.rehydrateHistoryText(prompt.text, id => imageSidecar?.readAttachment(id) ?? null))
+            .filter(Boolean);
         if (prompts.length > 0) {
             this.root.editor.setText(prompts[0]);
             if (recovered.draft)
@@ -1391,7 +1392,11 @@ export class OwnedUiSessionPresenter {
         }
         let result;
         try {
-            result = await this.backend.workflows.executeWorkflow(shareSurface === undefined ? request : { ...request, signal: shareSurface.signal });
+            result = await this.backend.workflows.executeWorkflow(shareSurface === undefined ? request : {
+                ...request,
+                signal: shareSurface.signal,
+                onProgress: message => { shareSurface.setMessage?.(message); this.#terminal.requestRender(); },
+            });
         }
         finally {
             if (operationSurface) {

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

@@ -1,7 +1,7 @@
 import type { PiTuiPointerSurface } from "../../integrations/pi/tui-runtime/contracts.js";
 import type { OwnedUiViewportSettings } from "../../contracts/owned-ui/index.js";
 import { type TranscriptViewportFrame, type TranscriptViewportFrameInput } from "../../ui/components/transcript-viewport.js";
-import type { SelectionCopySnapshot } from "../../ui/components/selection-copy.js";
+import { type SelectionCopySnapshot } from "../../ui/components/selection-copy.js";
 import type { PiShellEditorPort } from "../../integrations/pi/components/shell-shared-facade.js";
 import type { PasteEvent } from "./paste-protocol.js";
 export interface SessionViewportControllerOptions {
@@ -64,7 +64,7 @@ export declare class SessionViewportController {
     setOverlaySurfaces(surfaces: readonly PiTuiPointerSurface[] | null): void;
     get inputGeometryReady(): boolean;
     compose(input: Omit<TranscriptViewportFrameInput, "pointerPosition">): TranscriptViewportFrame;
-    composeDockOnly(dockRows: readonly string[], width: number, height: number, explicitCopyDockRows?: number): TranscriptViewportFrame | null;
+    composeDockOnly(dockRows: readonly string[], width: number, height: number, copyableDockRows?: TranscriptViewportFrameInput["copyableDockRows"]): TranscriptViewportFrame | null;
     /** Returns true when document wrapping may have changed. */
     setConfig(config: OwnedUiViewportSettings): boolean;
     resumeFollowing(): void;

package/dist/app/session-shell/session-viewport-controller.js

@@ -3,6 +3,7 @@ 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";
+import { literalSelectionCopySnapshot } from "../../ui/components/selection-copy.js";
 function withinTailControl(region, column, row) {
     return row >= region.rowStart && row <= region.rowEnd && column >= region.columnStart && column <= region.columnEnd;
 }
@@ -22,6 +23,7 @@ export class SessionViewportController {
     #pasteDiagnosticRequest = 0;
     #viewport = new TranscriptViewport();
     #config = {
+        timeFormat: "8:00 PM",
         scrollbarAppearance: "auto",
         scrollbarStyle: "thin",
         scrollbarSpeed: "normal",
@@ -165,16 +167,18 @@ export class SessionViewportController {
         }
         return frame;
     }
-    composeDockOnly(dockRows, width, height, explicitCopyDockRows = 0) {
-        return this.#viewport.composeDockOnly(dockRows, width, height, explicitCopyDockRows);
+    composeDockOnly(dockRows, width, height, copyableDockRows = []) {
+        return this.#viewport.composeDockOnly(dockRows, width, height, copyableDockRows);
     }
     /** Returns true when document wrapping may have changed. */
     setConfig(config) {
-        const appearanceChanged = config.scrollbarAppearance !== this.#config.scrollbarAppearance;
-        this.#config = config;
-        this.#viewport.setConfig(config);
+        const normalized = { ...config, timeFormat: config.timeFormat ?? "8:00 PM" };
+        const layoutChanged = normalized.scrollbarAppearance !== this.#config.scrollbarAppearance
+            || normalized.timeFormat !== this.#config.timeFormat;
+        this.#config = normalized;
+        this.#viewport.setConfig(normalized);
         this.#requestRender();
-        return appearanceChanged;
+        return layoutChanged;
     }
     resumeFollowing() {
         if (!this.#enabled)
@@ -302,12 +306,10 @@ export class SessionViewportController {
             });
         }
         if (data === "\u0003") {
-            if (editorActive && this.#editor.hasSelection()) {
-                if (this.#viewport.clearSelection())
-                    this.#requestRender();
-            }
-            else if (this.#viewport.hasSelection) {
-                const copySelection = this.#viewport.captureSelectedText("explicit");
+            // Invariant: the newest complete-frame gesture owns explicit copy even if an
+            // older editor word/line selection remains painted beneath it.
+            if (this.#viewport.hasSelection) {
+                const copySelection = this.#viewport.captureSelectedText();
                 this.#viewport.clearSelection();
                 this.#stopSelectionAutoScroll();
                 this.#requestRender();
@@ -315,6 +317,10 @@ export class SessionViewportController {
                     ? { data: "", consumed: true }
                     : { data: "", consumed: true, copySelection };
             }
+            if (editorActive && this.#editor.hasSelection()) {
+                if (this.#viewport.clearSelection())
+                    this.#requestRender();
+            }
         }
         const previousPrompt = SHIFT_UP_INPUTS.has(data) || this.#editor.matchesTerminalKey(data, "alt+home");
         if (editorActive && allowWheel && (previousPrompt || SHIFT_DOWN_INPUTS.has(data))) {
@@ -541,6 +547,12 @@ export class SessionViewportController {
                         const editorRow = pendingEditorClick.row - this.#editorPointerFrame.rowStart + 1;
                         this.#editor.handlePointer({ kind: "press", button: 0, column: pendingEditorClick.column, row: editorRow });
                         this.#editor.handlePointer({ kind: "release", button: 0, column: pendingEditorClick.column, row: editorRow });
+                        if (this.#copyOnSelect) {
+                            const selected = this.#editor.selectedText?.();
+                            if (selected !== undefined) {
+                                completedCopy = literalSelectionCopySnapshot(selected, this.#viewport.selectionRevision) ?? undefined;
+                            }
+                        }
                     }
                     forceRepaint = true;
                     repaint = true;

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

@@ -98,8 +98,6 @@ export declare class OwnedUiTerminalHost implements OwnedUiTerminalHostContract<
     active(): OwnedUiHostedPresenter | null;
     requestRender(from: OwnedUiHostedPresenter, force?: boolean): void;
     start(): void;
-    /** Hidden resident tabs retain engine/status work but stop producing terminal animation frames. */
-    setPresentationVisible(visible: boolean): void;
     /** Closes one presenter. Closing the last one ends the terminal. */
     close(presenter: OwnedUiHostedPresenter): Promise<void>;
     dispose(): Promise<void>;

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

@@ -42,8 +42,6 @@ export class OwnedUiTerminalHost {
     #focused = false;
     #pointerReporting = false;
     #started = false;
-    #presentationVisible = true;
-    #releaseVisibilityHold;
     #ending;
     constructor(options) {
         this.#customViewport = options.layout === "custom-viewport";
@@ -148,8 +146,10 @@ export class OwnedUiTerminalHost {
     active() {
         return this.#active;
     }
+    // Invariant: resident tab visibility never gates rendering here; a hidden tab keeps painting into its
+    // resident terminal, and the native holder alone withholds inactive surfaces from attach clients.
     requestRender(from, force = false) {
-        if (this.#presentationVisible && from === this.#active)
+        if (from === this.#active)
             this.runtime.requestRender(force);
     }
     start() {
@@ -157,26 +157,9 @@ export class OwnedUiTerminalHost {
             return;
         this.#started = true;
         this.runtime.start();
-        if (!this.#presentationVisible)
-            this.#releaseVisibilityHold = this.runtime.beginPresentationHold();
         if (this.#customViewport)
             this.#setPointerReporting(true);
     }
-    /** Hidden resident tabs retain engine/status work but stop producing terminal animation frames. */
-    setPresentationVisible(visible) {
-        if (this.#presentationVisible === visible)
-            return;
-        this.#presentationVisible = visible;
-        if (!this.#started || this.#ending !== undefined)
-            return;
-        if (visible) {
-            this.#releaseVisibilityHold?.();
-            this.#releaseVisibilityHold = undefined;
-        }
-        else if (this.#releaseVisibilityHold === undefined) {
-            this.#releaseVisibilityHold = this.runtime.beginPresentationHold();
-        }
-    }
     /** Closes one presenter. Closing the last one ends the terminal. */
     close(presenter) {
         if (this.#ending !== undefined || !this.#presenters.has(presenter))

package/dist/cli/tabs.js

@@ -132,9 +132,24 @@ function status(result) {
         `detachment: ${String(result.detachmentMode ?? "unknown")}${result.detachmentVerified === false ? " (not verified)" : ""}`,
         `tabs: ${String(result.tabs ?? 0)}${Object.keys(byStatus).length > 0 ? ` (${Object.entries(byStatus).map(([key, value]) => `${key} ${String(value)}`).join(", ")})` : ""}`,
         `clients: ${String(result.clients ?? 0)}`,
+        ...startsAndLifecycle(result),
         `limits: ${Object.entries(limits).map(([key, value]) => `${key} ${String(value)}`).join(", ")}`,
         `counters: ${Object.entries(counters).map(([key, value]) => `${key} ${String(value)}`).join(", ")}`,
         ...(Array.isArray(result.logs) ? result.logs.map(path => `log: ${String(path)}`) : []),
     ];
     return `${lines.join("\n")}\n`;
 }
+/** Lifecycle work running this long means a terminal's tab requests are stuck. */
+const LIFECYCLE_STALL_MS = 10_000;
+function startsAndLifecycle(result) {
+    const lines = [];
+    const starts = result.starts;
+    if (starts)
+        lines.push(`starts: active ${String(starts.active ?? 0)}, waiting ${String(starts.interactiveWaiting ?? 0)}, recovering ${String(starts.recoverySlots ?? 0)}`);
+    const lifecycle = result.lifecycle;
+    if (lifecycle) {
+        const oldest = typeof lifecycle.oldestMs === "number" ? lifecycle.oldestMs : 0;
+        lines.push(`lifecycle: pending ${String(lifecycle.pending ?? 0)}, oldest ${oldest}ms${oldest > LIFECYCLE_STALL_MS ? " (stalled)" : ""}`);
+    }
+    return lines;
+}

package/dist/composition/owned-ui.d.ts

@@ -87,5 +87,5 @@ export declare function composeOwnedUiApplication(options?: OwnedUiCompositionOp
 export declare function composeOwnedUi(options?: OwnedUiCompositionOptions): Promise<OwnedUiComposition>;
 export declare function bindResidentTabBridge(tabBridge: TabBridgeClient, backend: Pick<ComposedSessionBackend, "identity" | "session" | "workflows" | "generateResidentTabName">, recovery?: Pick<ResidentTabRecovery, "settled"> | null, options?: {
     readonly autoName?: boolean;
-    readonly onVisibility?: (visible: boolean) => void;
 }): Promise<() => void>;
+export declare function correlateResidentTabSubmission(recovery: Pick<ResidentTabRecovery, "correlated" | "settled">, backend: Pick<ComposedSessionBackend, "identity" | "session">, submissionId: string, entryId: string): Promise<void>;

package/dist/composition/owned-ui.js

@@ -12,6 +12,8 @@ import { createPiSessionPresenters } from "../integrations/pi/session-presenters
 import { ClipboardDiagnosticCapture } from "../app/session-shell/clipboard-diagnostics.js";
 import { createOwnedUiClipboardServices } from "../app/session-shell/clipboard-services.js";
 import { createPiKeybindingsHost } from "../integrations/pi/components/shell-shared-facade.js";
+import { projectResidentTabShortcuts } from "../features/resident-tab/shortcut-projection.js";
+import { readShortcutBindingsFile } from "../features/resident-tab/shortcut-bindings-file.js";
 import { OwnedUiSessionPresenter, OwnedUiTerminalHost, sessionTerminalHostOptions, } from "../app/session-shell/session-shell.js";
 import { OwnedSettingsManager } from "../ui/settings/manager.js";
 import { createPiTerminalBridge } from "../integrations/pi/tui-runtime/presentation-adapter.js";
@@ -164,13 +166,8 @@ export async function composeOwnedUi(options = {}) {
     const recoveredTabInput = await tabRecovery?.initialize(currentBackendSessionFile(backend), backend.identity.sessionId);
     if (tabBridge !== null && settings !== null && ownedSurfaces)
         tabBridge.accent(settings.value("accentColor"));
-    let residentTabVisible = true;
-    let applyResidentTabVisibility = () => { };
     let removeControllerBoundaryInput = () => { };
-    const unsubscribeTabBridge = tabBridge === null ? () => { } : await bindResidentTabBridge(tabBridge, backend, tabRecovery, {
-        autoName: settings?.value("tabsAutoName") ?? true,
-        onVisibility: visible => { residentTabVisible = visible; applyResidentTabVisibility(); },
-    });
+    const unsubscribeTabBridge = tabBridge === null ? () => { } : await bindResidentTabBridge(tabBridge, backend, tabRecovery, { autoName: settings?.value("tabsAutoName") ?? true });
     let releaseNotes = null;
     let releaseNotesFailure;
     if (ownedSurfaces) {
@@ -259,7 +256,18 @@ export async function composeOwnedUi(options = {}) {
         ? new ClipboardDiagnosticCapture(clipboardDestination) : null;
     // Invariant: process-wide services are created once here and borrowed by every session shell. The
     // keybinding registry is applied before any presenter is built, so none of them reads Pi's defaults.
-    const keybindings = createPiKeybindingsHost({ profile: ownedSurfaces ? "a1" : "pi", agentDir: backend.identity.agentDir });
+    const keybindingsHost = createPiKeybindingsHost({ profile: ownedSurfaces ? "a1" : "pi", agentDir: backend.identity.agentDir });
+    // Invariant: the resident host dispatches and labels the tab shortcuts this child projects
+    // from its effective declarations, so a customization reload republishes the projection.
+    const publishTabShortcuts = () => tabBridge?.shortcuts(projectResidentTabShortcuts({
+        configured: readShortcutBindingsFile(backend.identity.agentDir),
+        reserved: keybindingsHost.manager.getEffectiveConfig(),
+    }).assignments);
+    const keybindings = tabBridge === null ? keybindingsHost : {
+        ...keybindingsHost,
+        reload: () => { keybindingsHost.reload(); publishTabShortcuts(); },
+    };
+    publishTabShortcuts();
     const clipboardServices = ownedSurfaces ? createOwnedUiClipboardServices() : null;
     let createdTerminalHost;
     let terminalHost;
@@ -289,7 +297,7 @@ export async function composeOwnedUi(options = {}) {
                         stallNoticeSeconds: 300,
                         admit: input => tabRecovery.admit({ ...input, incarnation: options.tab.incarnation }),
                         dispatched: () => tabRecovery.dispatched(),
-                        correlated: (submissionId, entryId) => tabRecovery.correlated(submissionId, entryId),
+                        correlated: (submissionId, entryId) => correlateResidentTabSubmission(tabRecovery, backend, submissionId, entryId),
                         checkpoint: text => tabRecovery.checkpoint(text),
                         gracefulStop: sessionFile => tabRecovery.gracefulStop(sessionFile),
                         ...(recoveredTabInput === undefined ? {} : { recovered: recoveredTabInput }),
@@ -322,7 +330,6 @@ export async function composeOwnedUi(options = {}) {
         // the host and paints once attached.
         terminalHost = createdTerminalHost = new OwnedUiTerminalHost(sessionTerminalHostOptions(presenterOptions));
         if (tabBridge !== null) {
-            applyResidentTabVisibility = () => terminalHost.setPresentationVisible(residentTabVisible);
             removeControllerBoundaryInput = terminalHost.runtime.addPreInputListener(data => ({
                 data: tabBridge.consumeControllerBoundaryInput(data),
             }));
@@ -375,7 +382,6 @@ export async function composeOwnedUi(options = {}) {
                 exitNotice = import("../app/session-shell/exit-notice.js")
                     .then(module => module.armExitNotice(backend, exitNoticePath), () => null);
             presenter.start();
-            applyResidentTabVisibility();
             void announceNewerRelease().catch(() => undefined);
         },
         flush: () => backend.session.flushEvents(),
@@ -420,14 +426,38 @@ export async function bindResidentTabBridge(tabBridge, backend, recovery = null,
     tabBridge.status("starting");
     const currentSessionFile = () => currentBackendSessionFile(backend);
     let pendingAutoName = null;
+    const isDefaultName = (name) => name == null || /^agent(?: \d+)?$/i.test(name);
+    const currentSessionName = () => backend.session.view().status.footer?.sessionName ?? null;
     const announceSession = () => {
-        const name = backend.session.view().status.footer?.sessionName ?? null;
-        const nameSource = name === pendingAutoName ? "auto" : name === null || /^agent(?: \d+)?$/i.test(name) ? "default" : "user";
+        const name = currentSessionName();
+        const nameSource = name === pendingAutoName ? "auto" : isDefaultName(name) ? "default" : "user";
         tabBridge.session(currentSessionFile(), name, nameSource);
     };
     let working = false;
     let lastTurnFailed = false;
     let autoNameAttempted = false;
+    let autoNameArmed = false;
+    // Invariant: naming launches once per tab during an agent run, as soon as its prompt is projected,
+    // and runs beside the turn instead of waiting for it to settle.
+    const launchAutoName = () => {
+        if (!autoNameArmed || autoNameAttempted || options.autoName !== true || !isDefaultName(currentSessionName()))
+            return;
+        const prompt = backend.session.view().transcript.find(block => block.kind === "user")?.text.trim();
+        if (!prompt)
+            return;
+        autoNameAttempted = true;
+        void import("../features/resident-tab/index.js").then(({ generateAutoName }) => generateAutoName(prompt, request => backend.generateResidentTabName(request.prompt, request.maxTokens, request.signal))).then(async (name) => {
+            // Invariant: a manual rename made while generation was pending owns both the session and the tab.
+            if (!isDefaultName(currentSessionName()))
+                return;
+            pendingAutoName = name;
+            const result = await backend.workflows.executeWorkflow({ command: "name", argument: name });
+            if (result.outcome === "completed")
+                tabBridge.session(currentSessionFile(), name, "auto");
+            else if (pendingAutoName === name)
+                pendingAutoName = null;
+        }).catch(() => { pendingAutoName = null; });
+    };
     const reportStatus = (lifecycle) => {
         const view = backend.session.view();
         const pendingRequests = view.dialog == null ? 0 : 1;
@@ -441,12 +471,14 @@ export async function bindResidentTabBridge(tabBridge, backend, recovery = null,
     };
     announceSession();
     const unsubscribeCommands = typeof tabBridge.onCommand === "function" ? tabBridge.onCommand(command => {
-        if (command.type === "visibility") {
-            options.onVisibility?.(command.visible);
-        }
-        else if (command.type === "rename") {
+        // Invariant: visibility stays decoded for generation-1 peers but never pauses rendering; a hidden tab
+        // keeps its resident terminal current while the holder withholds only its client surfaces.
+        if (command.type === "rename") {
             void backend.workflows.executeWorkflow({ command: "name", argument: command.name }).catch(() => { });
         }
+        else if (command.type === "route") {
+            void backend.workflows.executeWorkflow({ command: command.route, argument: "" }).catch(() => { });
+        }
         else if (command.type === "stop") {
             void backend.session.dispose().catch(() => { });
         }
@@ -461,24 +493,17 @@ export async function bindResidentTabBridge(tabBridge, backend, recovery = null,
             if (wasWorking && !working && recovery !== null) {
                 void recovery.settled(currentSessionFile()).catch(() => tabBridge.degraded(true));
             }
-            if (wasWorking && !working && options.autoName === true && !autoNameAttempted) {
-                autoNameAttempted = true;
-                const view = backend.session.view();
-                const currentName = view.status.footer?.sessionName;
-                const prompt = view.transcript.find(block => block.kind === "user")?.text.trim();
-                if (prompt && (currentName == null || /^agent(?: \d+)?$/i.test(currentName))) {
-                    void import("../features/resident-tab/index.js").then(({ generateAutoName }) => generateAutoName(prompt, request => backend.generateResidentTabName(request.prompt, request.maxTokens, request.signal))).then(async (name) => {
-                        pendingAutoName = name;
-                        const result = await backend.workflows.executeWorkflow({ command: "name", argument: name });
-                        if (result.outcome === "completed")
-                            tabBridge.session(currentSessionFile(), name, "auto");
-                        else if (pendingAutoName === name)
-                            pendingAutoName = null;
-                    }).catch(() => { pendingAutoName = null; });
-                }
-            }
         }
+        if (event.type === "agent-run-started") {
+            autoNameArmed = true;
+            launchAutoName();
+        }
+        // Rationale: Pi starts the run before it projects the user message, so the prompt may arrive later.
+        if (event.type === "transcript-block" || event.type === "session-view")
+            launchAutoName();
         if (event.type === "agent-run-settled") {
+            launchAutoName();
+            autoNameArmed = false;
             lastTurnFailed = !event.successful && !event.aborted;
             tabBridge.prompt(event.aborted);
             reportStatus();
@@ -493,6 +518,14 @@ export async function bindResidentTabBridge(tabBridge, backend, recovery = null,
         unsubscribeEvents();
     };
 }
+export async function correlateResidentTabSubmission(recovery, backend, submissionId, entryId) {
+    await recovery.correlated(submissionId, entryId);
+    // Concurrency: a normal prompt command can resolve after the ready transition already fired.
+    // Re-read lifecycle only after correlation is active; a concurrent ready observer and this path
+    // safely race because recovery consumes the active entry once and retirement is idempotent.
+    if (backend.session.view().lifecycle !== "busy")
+        await recovery.settled(currentBackendSessionFile(backend));
+}
 function currentBackendSessionFile(backend) {
     const direct = backend.identity.currentSessionFile?.();
     if (direct !== undefined && direct !== null)
@@ -514,6 +547,7 @@ function quitOutroSettingsSnapshot(settings) {
 }
 function viewportSettingsSnapshot(settings) {
     return {
+        timeFormat: settings.value("timeFormat"),
         scrollbarAppearance: settings.value("scrollbarAppearance"),
         scrollbarStyle: settings.value("scrollbarStyle"),
         scrollbarSpeed: settings.value("scrollbarSpeed"),

package/dist/contracts/owned-ui/index.d.ts

@@ -3,7 +3,7 @@ export type UiAccentColor = "purple" | "blue" | "cyan" | "green" | "orange" | "p
 export { OWNED_UI_EXTENSION_CONTRACT_VERSION, OWNED_UI_EXTENSION_RENDER_CALLBACKS, OWNED_UI_EXTENSION_UI_CALLBACKS, OWNED_UI_EXTENSION_UI_PROPERTIES, assertOwnedUiExtensionUiPort, } from "./extension-ui.js";
 export type { OwnedUiExtensionAutocompleteItem, OwnedUiExtensionAutocompleteProvider, OwnedUiExtensionAutocompleteProviderFactory, OwnedUiExtensionAutocompleteSuggestions, OwnedUiExtensionComponent, OwnedUiExtensionComponentFactory, OwnedUiExtensionComponentFactoryContext, OwnedUiExtensionCustomFactory, OwnedUiExtensionCustomOptions, OwnedUiExtensionDialogOptions, OwnedUiExtensionEditorComponent, OwnedUiExtensionEditorFactory, OwnedUiExtensionEditorThemePort, OwnedUiExtensionEntryRenderInput, OwnedUiExtensionFooterDataPort, OwnedUiExtensionFooterFactory, OwnedUiExtensionInputListener, OwnedUiExtensionKeybindingsPort, OwnedUiExtensionMessageRenderInput, OwnedUiExtensionNotificationSeverity, OwnedUiExtensionOverlayAnchor, OwnedUiExtensionOverlayHandle, OwnedUiExtensionOverlayMargin, OwnedUiExtensionOverlayOptions, OwnedUiExtensionRenderCallback, OwnedUiExtensionRendererPort, OwnedUiExtensionRuntimePort, OwnedUiExtensionSelectListThemePort, OwnedUiExtensionSizeValue, OwnedUiExtensionTerminalPort, OwnedUiExtensionThemeBackground, OwnedUiExtensionThemeColor, OwnedUiExtensionThemeInfo, OwnedUiExtensionThemePort, OwnedUiExtensionToolRenderContext, OwnedUiExtensionUiCallback, OwnedUiExtensionUiPort, OwnedUiExtensionUiProperty, OwnedUiExtensionWidgetOptions, OwnedUiExtensionWidgetPlacement, OwnedUiExtensionWorkingIndicatorOptions, } from "./extension-ui.js";
 export { OWNED_UI_CONTRACT_VERSION } from "./model.js";
-export type { OwnedUiBackgroundSettingsPort, OwnedUiBackgroundStyle, OwnedUiBlockStatus, OwnedUiCommand, OwnedUiCommandOutcome, OwnedUiCorrelationId, OwnedUiCustomization, OwnedUiDiagnostics, OwnedUiDialog, OwnedUiEditorState, OwnedUiEntityId, OwnedUiEvent, OwnedUiFooterView, OwnedUiImageAttachment, OwnedUiLifecycle, OwnedUiModelInfo, OwnedUiOverlay, OwnedUiPromptSuggestionGeneratorPort, OwnedUiPromptSuggestionIdentity, OwnedUiPromptSuggestionReasoning, OwnedUiPromptSuggestionRequest, OwnedUiPromptSuggestionResult, OwnedUiPromptSuggestionState, OwnedUiQuitOutroSettings, OwnedUiQuitOutroSettingsPort, OwnedUiSessionId, OwnedUiSessionViewModel, OwnedUiSeverity, OwnedUiSlotId, OwnedUiSnapshot, OwnedUiStatusView, OwnedUiTerminalSurface, OwnedUiThinkingLevel, OwnedUiToolRendering, OwnedUiToolResultPart, OwnedUiToolState, OwnedUiTranscriptBlock, OwnedUiTranscriptBlockKind, OwnedUiTranscriptImageReference, OwnedUiUsageView, OwnedUiViewportSettings, OwnedUiViewportSettingsPort, } from "./model.js";
+export type { OwnedUiBackgroundSettingsPort, OwnedUiBackgroundStyle, OwnedUiBlockStatus, OwnedUiCommand, OwnedUiCommandOutcome, OwnedUiCorrelationId, OwnedUiCustomization, OwnedUiDiagnostics, OwnedUiDialog, OwnedUiEditorState, OwnedUiEntityId, OwnedUiEvent, OwnedUiFooterView, OwnedUiImageAttachment, OwnedUiLifecycle, OwnedUiModelInfo, OwnedUiOverlay, OwnedUiPromptSuggestionGeneratorPort, OwnedUiPromptSuggestionIdentity, OwnedUiPromptSuggestionReasoning, OwnedUiPromptSuggestionRequest, OwnedUiPromptSuggestionResult, OwnedUiPromptSuggestionState, OwnedUiQuitOutroSettings, OwnedUiQuitOutroSettingsPort, OwnedUiSessionId, OwnedUiSessionViewModel, OwnedUiSeverity, OwnedUiSlotId, OwnedUiSnapshot, OwnedUiStatusView, OwnedUiTerminalSurface, OwnedUiThinkingLevel, OwnedUiTimeFormat, OwnedUiToolRendering, OwnedUiToolResultPart, OwnedUiToolState, OwnedUiTranscriptBlock, OwnedUiTranscriptBlockKind, OwnedUiTranscriptImageReference, OwnedUiUsageView, OwnedUiViewportSettings, OwnedUiViewportSettingsPort, } from "./model.js";
 export type { OwnedUiExtensionPort, OwnedUiSessionBackend, OwnedUiSessionCatalogPort, OwnedUiSessionFactory, OwnedUiSessionIdentityPort, OwnedUiSessionPort, OwnedUiSessionRequest, OwnedUiSessionSettingsPort, OwnedUiWorkflowPort, } from "./session-backend.js";
 export type { OwnedUiDialogHost, OwnedUiInputSurface, OwnedUiPresenterHost, OwnedUiSessionPresenter, OwnedUiSessionPresenters, OwnedUiShortcutDescription, OwnedUiTerminalHost, OwnedUiTranscriptRendererPort, } from "./session-presenters.js";
 export { OWNED_UI_HIDDEN_COMMAND_NAMES, OWNED_UI_MODELS_COMMAND_NAME, OWNED_UI_WORKFLOW_COMMAND_NAMES, } from "./session-workflows.js";

package/dist/contracts/owned-ui/model.d.ts

@@ -53,7 +53,10 @@ export interface OwnedUiPromptSuggestionGeneratorPort {
     generate(request: OwnedUiPromptSuggestionRequest): Promise<OwnedUiPromptSuggestionResult>;
 }
 export type OwnedUiThinkingLevel = "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
+export type OwnedUiTimeFormat = "20:00" | "8:00 PM";
 export interface OwnedUiViewportSettings {
+    /** Omitted by older SDK callers; bare A1 composition always supplies the owned default. */
+    readonly timeFormat?: OwnedUiTimeFormat;
     readonly scrollbarAppearance: "auto" | "always" | "hidden";
     readonly scrollbarStyle: "thin" | "thick";
     /** normal is baseline; fast is 2x normal; high is normal plus fast. */

package/dist/contracts/owned-ui/session-workflows.d.ts

@@ -49,6 +49,8 @@ export interface OwnedUiWorkflowRequest {
     readonly cwdOverride?: string;
     /** Cancellation for an owned operation surface such as `/share`. */
     readonly signal?: AbortSignal;
+    /** Progress label for that operation surface, e.g. when `/share` picks its upload destination. */
+    readonly onProgress?: (message: string) => void;
     readonly treeSummary?: {
         readonly summarize: boolean;
         readonly customInstructions?: string;
@@ -272,6 +274,7 @@ export interface OwnedUiSessionSettingsSnapshot {
     readonly autocompleteMaxVisible: number;
     readonly quietStartup: boolean | "header";
     readonly defaultProjectTrust: "ask" | "always" | "never";
+    readonly sessionShareDestination: "auto" | "gist" | "radius";
     readonly clearOnShrink: boolean;
     readonly showTerminalProgress: boolean;
     readonly tuiMode: "regular" | "fullscreen";
@@ -289,7 +292,7 @@ export type OwnedUiJsonValue = null | boolean | number | string | readonly Owned
 /** The layer that installs a setting's live effect. */
 export type OwnedUiSettingOwner = "agent" | "shell" | "terminal" | "startup" | "shutdown" | "installation";
 /** Engine settings whose live effect an owner may bind. */
-export type OwnedUiSessionSettingKey = "autoCompact" | "showImages" | "imageWidthCells" | "autoResizeImages" | "blockImages" | "enableSkillCommands" | "steeringMode" | "followUpMode" | "transport" | "httpIdleTimeoutMs" | "cacheWarmingMode" | "modelThinkingLevels" | "theme" | "hideThinkingBlock" | "mermaidRenderingMode" | "showCacheMissNotices" | "collapseChangelog" | "enableInstallTelemetry" | "quietStartup" | "defaultProjectTrust" | "doubleEscapeAction" | "treeFilterMode" | "showHardwareCursor" | "editorPaddingX" | "outputPad" | "autocompleteMaxVisible" | "clearOnShrink" | "showTerminalProgress" | "tuiMode" | "fullscreenExitOutput" | "fullscreenScrollbar" | "fullscreenCopyOnSelect" | "fullscreenWheelScrollLines" | "warnings";
+export type OwnedUiSessionSettingKey = "autoCompact" | "showImages" | "imageWidthCells" | "autoResizeImages" | "blockImages" | "enableSkillCommands" | "steeringMode" | "followUpMode" | "transport" | "httpIdleTimeoutMs" | "cacheWarmingMode" | "modelThinkingLevels" | "theme" | "hideThinkingBlock" | "mermaidRenderingMode" | "showCacheMissNotices" | "collapseChangelog" | "enableInstallTelemetry" | "quietStartup" | "defaultProjectTrust" | "sessionShareDestination" | "doubleEscapeAction" | "treeFilterMode" | "showHardwareCursor" | "editorPaddingX" | "outputPad" | "autocompleteMaxVisible" | "clearOnShrink" | "showTerminalProgress" | "tuiMode" | "fullscreenExitOutput" | "fullscreenScrollbar" | "fullscreenCopyOnSelect" | "fullscreenWheelScrollLines" | "warnings";
 export interface OwnedUiSettingEffectHandler {
     /** Install one value in the active owner. Handlers must be idempotent and reversible. */
     apply(value: OwnedUiJsonValue): void | Promise<void>;