@timurproko/a1 0.1.8-dev.151 → 0.1.8-dev.182

package/dist/integrations/pi/engine/workflow-controllers.d.ts

@@ -16,5 +16,5 @@ export declare class PiWorkflowControllerPort implements AgentWorkflowPort {
     listWorkflows(): Promise<readonly AgentWorkflowDescriptor[]>;
     executeWorkflow(workflowId: string, input: AgentJsonValue, signal?: AbortSignal): Promise<AgentJsonValue>;
 }
-export declare const PI_BUILTIN_WORKFLOW_ROUTES: readonly ("name" | "share" | "model" | "login" | "logout" | "settings" | "reload" | "compact" | "new" | "resume" | "scoped-models" | "export" | "import" | "copy" | "session" | "changelog" | "hotkeys" | "fork" | "clone" | "tree" | "trust" | "quit" | "debug" | "arminsayshi" | "dementedelves")[];
+export declare const PI_BUILTIN_WORKFLOW_ROUTES: readonly ("name" | "share" | "model" | "login" | "logout" | "settings" | "reload" | "compact" | "new" | "resume" | "session" | "scoped-models" | "export" | "import" | "copy" | "changelog" | "hotkeys" | "fork" | "clone" | "tree" | "trust" | "quit" | "debug" | "arminsayshi" | "dementedelves")[];
 export declare const PI_WORKFLOW_CAPABILITIES: readonly WorkflowCapability[];

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

@@ -0,0 +1,11 @@
+export interface ClipboardImageData {
+    readonly data: string;
+    readonly mimeType: string;
+}
+/**
+ * Converts valid padded or unpadded standard base64 into its unique padded form.
+ * Clipboard adapters are untrusted at this boundary, so reject representations
+ * that Node's permissive base64 decoder would otherwise partially accept.
+ */
+export declare function canonicalizeClipboardImage(image: ClipboardImageData): ClipboardImageData | null;
+export declare function canonicalizeStandardBase64(value: string): string | null;

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

@@ -0,0 +1,29 @@
+const STANDARD_BASE64 = /^[A-Za-z0-9+/]*={0,2}$/u;
+/**
+ * Converts valid padded or unpadded standard base64 into its unique padded form.
+ * Clipboard adapters are untrusted at this boundary, so reject representations
+ * that Node's permissive base64 decoder would otherwise partially accept.
+ */
+export function canonicalizeClipboardImage(image) {
+    const data = canonicalizeStandardBase64(image.data);
+    return data === null ? null : { data, mimeType: image.mimeType };
+}
+export function canonicalizeStandardBase64(value) {
+    if (value.length === 0 || !STANDARD_BASE64.test(value))
+        return null;
+    const paddingStart = value.indexOf("=");
+    const core = paddingStart < 0 ? value : value.slice(0, paddingStart);
+    const suppliedPadding = value.length - core.length;
+    const remainder = core.length % 4;
+    if (remainder === 1)
+        return null;
+    const requiredPadding = remainder === 0 ? 0 : 4 - remainder;
+    if (suppliedPadding !== 0 && suppliedPadding !== requiredPadding)
+        return null;
+    const padded = `${core}${"=".repeat(requiredPadding)}`;
+    const decoded = Buffer.from(padded, "base64");
+    if (decoded.length === 0)
+        return null;
+    const canonical = decoded.toString("base64");
+    return canonical === padded ? canonical : null;
+}

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

@@ -2,6 +2,7 @@ import { randomBytes } from "node:crypto";
 import { existsSync, statSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import { canonicalizeClipboardImage } from "./clipboard-image.js";
 const CHIP_PATTERN = /\[(?:📷 [^\]]+|📁 [^\]]+|📄 [^\]]+|🖼 {1,2}[^\]]+|🔗 [^\]]+)\]/gu;
 const IMAGE_EXTENSION = /\.(?:jpe?g|png|webp|gif|bmp|tiff?)$/iu;
 const URL_PATTERN = /^https?:\/\/[^\s\u0000-\u001f\u007f]+$/iu;
@@ -11,12 +12,15 @@ export class PromptChipStore {
     #chips = new Map();
     transformPastedContent(content) {
         if (content.kind === "image") {
+            const image = canonicalizeClipboardImage(content);
+            if (image === null)
+                return "";
             const id = randomBytes(5).toString("hex");
             const tag = `[📷 screenshot-${id}.png]`;
             this.#chips.set(tag, {
                 kind: "image",
                 tag,
-                image: { type: "image", data: content.data, mimeType: content.mimeType },
+                image: { type: "image", data: image.data, mimeType: image.mimeType },
             });
             return tag;
         }

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

@@ -1,7 +1,7 @@
 import type { OwnedUiSessionViewModel, OwnedUiViewportSettings, OwnedUiViewportSettingsPort } from "../../../contracts/owned-ui/index.js";
 import type { UiRouteHost } from "../../../ui/apps/index.js";
 import { type PiEngineAdapter, type PiWorkflowResult } from "../engine/index.js";
-import { type PiShellClipboardContent, type PiShellComponentPort, type PiShellEditorPort, type PiShellExtensionRendererResolver, type PiShellHeaderOptions, type PiShellHeaderPort, type PiShellLoadedResourcesPort, type PiShellResourceEntry, type PiShellTranscriptComponentPort } from "../components/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 PiTuiLayoutNode, type PiTuiTerminalPort } from "../tui-runtime/index.js";
 import { type PreparedPrompt } from "./prompt-chips.js";
 export type OwnedUiBackendPort = PiEngineAdapter;
@@ -54,7 +54,13 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
         readonly onDequeue?: () => void;
         readonly onCopyText?: (text: string) => void;
         readonly readClipboardContent?: () => Promise<PiShellClipboardContent | null>;
-    }, startup?: PiShellHeaderOptions, agentDir?: string, extensionRenderers?: PiShellExtensionRendererResolver, sessionLayout?: "pinned" | "custom-viewport");
+    }, startup?: PiShellHeaderOptions, agentDir?: string, extensionRenderers?: PiShellExtensionRendererResolver, sessionLayout?: "pinned" | "custom-viewport", imageAssets?: PiShellImageAssetResolver);
+    setEditorPaddingX(padding: number): void;
+    setAutocompleteMaxVisible(maxVisible: number): void;
+    setOutputPad(padding: 0 | 1): void;
+    setHideThinkingBlock(hidden: boolean): void;
+    setMermaidRenderingMode(mode: "off" | "final" | "streaming"): void;
+    setImagePresentation(showImages: boolean, imageWidthCells: number): void;
     preparePromptSubmission(text: string): PreparedPrompt;
     update(view: OwnedUiSessionViewModel): void;
     /**
@@ -76,6 +82,7 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
     };
     layoutRoot(): PiTuiLayoutNode;
     transcriptComponent(id: string): PiShellTranscriptComponentPort | undefined;
+    exitTranscript(width: number): string;
     appendWorkflowStatus(message: string): void;
     appendWorkflowResult(result: PiWorkflowResult): void;
     appendDaxnuts(): void;

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

@@ -1,6 +1,6 @@
 import { backgroundSgrSpan, composeSubmittedPromptRows, displayWidth, formatSubmittedPromptTime, heldNativeHyperlinkStyle, hyperlinkSgrSpan, nativeHyperlinkStyle, overlaySpan, 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, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellEditor, createPiShellExtensionSelector, createPiShellFooter, createPiShellHeader, createPiShellHotkeys, createPiShellLoadedResources, createPiShellLoginDialog, createPiShellModelSelector, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionInfo, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellStatus, createPiShellTranscriptComponent, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, onPiThemeChange, piShellVisibleWidth, piTheme, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, } from "../components/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, piShellVisibleWidth, piTheme, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellStatusText, renderPiShellTranscriptBlock, } from "../components/index.js";
 import { PiTuiRuntimeAdapter, } from "../tui-runtime/index.js";
 import { PromptChipStore } from "./prompt-chips.js";
 import { SessionViewportController } from "./session-viewport-controller.js";
@@ -21,6 +21,7 @@ export class OwnedUiSessionShellRoot {
     #footer;
     #queued;
     #extensionRenderers;
+    #imageAssets;
     #promptChips = new PromptChipStore();
     #customViewport;
     #submittedPromptComposer;
@@ -28,6 +29,10 @@ export class OwnedUiSessionShellRoot {
     #componentRuntime;
     #toolsExpanded = false;
     #thinkingVisible = true;
+    #mermaidRenderingMode = "off";
+    #showImages = true;
+    #imageWidthCells = 80;
+    #outputPad = 1;
     #workflowTranscriptSequence = 0;
     #workflowStatusAnchors = new Map();
     #workflowStatusMessages = new Map();
@@ -42,7 +47,7 @@ export class OwnedUiSessionShellRoot {
     constructor(view, cwd, handlers, startup = {}, agentDir, extensionRenderers = {
         getMessageRenderer: () => undefined,
         getToolDefinition: () => undefined,
-    }, sessionLayout = "pinned") {
+    }, sessionLayout = "pinned", imageAssets) {
         this.#view = view;
         this.#customViewport = sessionLayout === "custom-viewport";
         this.#submittedPromptComposer = this.#customViewport
@@ -54,6 +59,7 @@ export class OwnedUiSessionShellRoot {
             : undefined;
         this.#cwd = cwd;
         this.#extensionRenderers = extensionRenderers;
+        this.#imageAssets = imageAssets;
         this.#componentRuntime = handlers;
         this.header = createPiShellHeader(startup);
         this.resources = createPiShellLoadedResources(startup.resources ?? [], startup.expanded ?? false);
@@ -109,6 +115,47 @@ export class OwnedUiSessionShellRoot {
             this.#documentLayouts.clear();
         });
     }
+    setEditorPaddingX(padding) {
+        this.editor.setPaddingX(padding);
+        this.#documentLayouts.clear();
+    }
+    setAutocompleteMaxVisible(maxVisible) {
+        this.editor.setAutocompleteMaxVisible(maxVisible);
+    }
+    setOutputPad(padding) {
+        if (this.#outputPad === padding)
+            return;
+        this.#outputPad = padding;
+        this.#status.setOutputPad(padding);
+        for (const component of this.#transcript.values())
+            component.setOutputPad(padding);
+        this.#invalidateTranscriptPresentation();
+    }
+    setHideThinkingBlock(hidden) {
+        if (this.#thinkingVisible === !hidden)
+            return;
+        this.#thinkingVisible = !hidden;
+        for (const component of this.#transcript.values())
+            component.setHideThinkingBlock(hidden);
+        this.#invalidateTranscriptPresentation();
+    }
+    setMermaidRenderingMode(mode) {
+        if (this.#mermaidRenderingMode === mode)
+            return;
+        this.#mermaidRenderingMode = mode;
+        for (const component of this.#transcript.values())
+            component.setMermaidRenderingMode(mode);
+        this.#invalidateTranscriptPresentation();
+    }
+    setImagePresentation(showImages, imageWidthCells) {
+        if (this.#showImages === showImages && this.#imageWidthCells === imageWidthCells)
+            return;
+        this.#showImages = showImages;
+        this.#imageWidthCells = imageWidthCells;
+        for (const component of this.#transcript.values())
+            component.setImagePresentation(showImages, imageWidthCells);
+        this.#invalidateTranscriptPresentation();
+    }
     preparePromptSubmission(text) {
         return this.#promptChips.prepareSubmission(text);
     }
@@ -135,7 +182,7 @@ export class OwnedUiSessionShellRoot {
         this.#blocksById.set(block.id, block);
         const component = this.#transcript.get(block.id);
         if (component === undefined) {
-            const created = createPiShellTranscriptComponent(block, this.#cwd, this.#extensionRenderers, this.#submittedPromptComposer);
+            const created = createPiShellTranscriptComponent(block, this.#cwd, this.#extensionRenderers, this.#submittedPromptComposer, this.#outputPad, !this.#thinkingVisible, this.#mermaidRenderingMode, this.#showImages, this.#imageWidthCells, this.#imageAssets);
             created.setExpanded(this.#toolsExpanded);
             this.#transcript.set(block.id, created);
             this.#transcriptOrder.push(block.id);
@@ -363,7 +410,13 @@ export class OwnedUiSessionShellRoot {
             .filter(diagnostic => diagnostic.code === "package-updates")
             .flatMap(diagnostic => renderPiShellPackageUpdateNotice(diagnostic.message.split("\n").filter(line => line.startsWith("- ")).map(line => line.slice(2)), width)));
         rows.push(...diagnostics
-            .filter(diagnostic => diagnostic.code !== "engine-startup" && diagnostic.code !== "package-updates")
+            .filter(diagnostic => diagnostic.code === "changelog-collapsed" || diagnostic.code === "changelog-expanded")
+            .flatMap(diagnostic => diagnostic.code === "changelog-collapsed"
+            ? createPiShellCollapsedChangelog().render(width)
+            : createPiShellChangelog(diagnostic.message).render(width)));
+        rows.push(...diagnostics
+            .filter(diagnostic => diagnostic.code !== "engine-startup" && diagnostic.code !== "package-updates"
+            && diagnostic.code !== "changelog-collapsed" && diagnostic.code !== "changelog-expanded")
             .slice(-3)
             .flatMap(diagnostic => renderPiShellTranscriptBlock({
             id: `diagnostic-${diagnostic.sequence}`,
@@ -420,6 +473,20 @@ export class OwnedUiSessionShellRoot {
     transcriptComponent(id) {
         return this.#transcript.get(id);
     }
+    exitTranscript(width) {
+        const rows = [];
+        for (const id of this.#transcriptOrder) {
+            const block = this.#blocksById.get(id);
+            if (block === undefined || (!this.#thinkingVisible && block.kind === "thinking"))
+                continue;
+            if (rows.length > 0 && block.kind === "user")
+                rows.push("");
+            rows.push(...this.#blockRows(id, block, width).map(row => stripAnsi(row).trimEnd()));
+        }
+        while (rows.at(-1) === "")
+            rows.pop();
+        return rows.join("\n");
+    }
     appendWorkflowStatus(message) {
         const previousId = this.#lastWorkflowStatusId;
         if (previousId !== undefined
@@ -432,7 +499,7 @@ export class OwnedUiSessionShellRoot {
         }
         const id = this.#appendAnchoredWorkflowComponent(width => [
             "",
-            ...renderPiShellStatusText(this.#workflowStatusMessages.get(id) ?? message, width),
+            ...renderPiShellStatusText(this.#workflowStatusMessages.get(id) ?? message, width, this.#outputPad),
         ]);
         this.#workflowStatusMessages.set(id, message);
         this.#lastWorkflowStatusId = id;
@@ -517,9 +584,7 @@ export class OwnedUiSessionShellRoot {
         this.#appendAnchoredWorkflowComponent(width => ["", ...daxnuts.render(width)], () => daxnuts.dispose?.());
     }
     toggleThinkingVisibility() {
-        this.#thinkingVisible = !this.#thinkingVisible;
-        this.#documentLayouts.clear();
-        this.invalidate();
+        this.setHideThinkingBlock(this.#thinkingVisible);
     }
     get toolsExpanded() {
         return this.#toolsExpanded;
@@ -665,6 +730,11 @@ export class OwnedUiSessionShellRoot {
         this.#footer.dispose?.();
         this.#queued.dispose?.();
     }
+    #invalidateTranscriptPresentation() {
+        this.#renderedRows.clear();
+        this.#documentLayouts.clear();
+        this.invalidate();
+    }
     #syncTranscript(blocks) {
         const previousIds = this.#transcriptOrder.filter(id => !id.startsWith("workflow-status-"));
         const transcriptChanged = previousIds.length !== blocks.length || blocks.some((block, index) => {
@@ -687,7 +757,7 @@ export class OwnedUiSessionShellRoot {
         for (const block of blocks) {
             const component = this.#transcript.get(block.id);
             if (component === undefined) {
-                const created = createPiShellTranscriptComponent(block, this.#cwd, this.#extensionRenderers, this.#submittedPromptComposer);
+                const created = createPiShellTranscriptComponent(block, this.#cwd, this.#extensionRenderers, this.#submittedPromptComposer, this.#outputPad, !this.#thinkingVisible, this.#mermaidRenderingMode, this.#showImages, this.#imageWidthCells, this.#imageAssets);
                 created.setExpanded(this.#toolsExpanded);
                 this.#transcript.set(block.id, created);
             }
@@ -724,6 +794,10 @@ export class OwnedUiSessionShellRoot {
             invalidate() { },
             update() { },
             setExpanded() { },
+            setOutputPad() { },
+            setHideThinkingBlock() { },
+            setMermaidRenderingMode() { },
+            setImagePresentation() { },
             ...(dispose === undefined ? {} : { dispose }),
         };
         this.#transcript.set(id, component);

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

@@ -44,3 +44,5 @@ export declare class OwnedUiSessionShell {
     showScopedModelsSelector(): void;
     dispose(): Promise<void>;
 }
+export declare function formatSessionResumeCommand(sessionFile: string): string;
+export declare function quoteCommandArgument(value: string): string;

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

@@ -1,7 +1,9 @@
+import { PRODUCT_TEXT } from "../../../product-identity.js";
 import { MOUSE_TRACKING_OFF, MOUSE_TRACKING_ON, parseMouseInput } 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 { PiTuiRuntimeAdapter, } from "../tui-runtime/index.js";
+import { canonicalizeClipboardImage } from "./clipboard-image.js";
 import { preloadSystemClipboard, readSystemClipboardContent, writeSystemClipboardText, } from "./system-clipboard.js";
 import { OwnedUiSessionShellRoot, shellResourceEntries, } from "./session-shell-root.js";
 export { OwnedUiSessionShellRoot } from "./session-shell-root.js";
@@ -26,6 +28,13 @@ export class OwnedUiSessionShell {
     #customViewport;
     #removeViewportPreInput;
     #unsubscribeSettings;
+    #unbindPiSettings;
+    #unbindTerminalSettings;
+    #unbindShutdownSettings;
+    #terminalProgressEnabled = false;
+    #showImages = true;
+    #imageWidthCells = 80;
+    #fullscreenExitOutput = "transcript";
     #compactionQueue = [];
     #lastClearTime = 0;
     #lastEscapeTime = 0;
@@ -73,9 +82,17 @@ export class OwnedUiSessionShell {
                 await pendingClipboardWrite;
                 if (options.clipboard === undefined)
                     return readSystemClipboardContent();
-                const image = await options.clipboard.readImage?.();
-                if (image !== null && image !== undefined)
-                    return { kind: "image", ...image };
+                try {
+                    const image = await options.clipboard.readImage?.();
+                    if (image !== null && image !== undefined) {
+                        const canonical = canonicalizeClipboardImage(image);
+                        if (canonical !== null)
+                            return { kind: "image", ...canonical };
+                    }
+                }
+                catch {
+                    // Treat an unavailable or malformed image as text-capable clipboard input.
+                }
                 const text = await options.clipboard.readText();
                 return text === null ? null : { kind: "text", text };
             },
@@ -85,7 +102,9 @@ export class OwnedUiSessionShell {
         }, this.backend.agentDir, {
             getMessageRenderer: customType => this.backend.pinnedMessageRenderer(customType),
             getToolDefinition: toolName => this.backend.pinnedToolDefinition(toolName),
-        }, options.sessionLayout);
+        }, options.sessionLayout, {
+            resolve: assetId => this.backend.resolveTranscriptImage(assetId),
+        });
         // Bare A1 owns a bounded viewport and therefore always runs on the alternate
         // fullscreen surface. The pinned comparison profiles still honor Pi's mode.
         const tuiMode = this.#customViewport
@@ -100,6 +119,32 @@ export class OwnedUiSessionShell {
         };
         runtime = new PiTuiRuntimeAdapter(runtimeOptions);
         this.runtime = runtime;
+        const initialPiSettings = this.backend.pinnedSettingsSnapshot();
+        this.runtime.setHardwareCursor(initialPiSettings.showHardwareCursor);
+        this.runtime.setClearOnShrink(initialPiSettings.clearOnShrink);
+        this.#terminalProgressEnabled = initialPiSettings.showTerminalProgress;
+        this.#fullscreenExitOutput = initialPiSettings.fullscreenExitOutput;
+        this.#unbindShutdownSettings = this.backend.bindSettingsOwner("shutdown", {
+            fullscreenExitOutput: { apply() { } },
+        });
+        this.#unbindTerminalSettings = this.backend.bindSettingsOwner("terminal", {
+            showHardwareCursor: { apply: value => {
+                    if (typeof value !== "boolean")
+                        throw new TypeError("Hardware cursor setting is invalid");
+                    this.runtime.setHardwareCursor(value);
+                } },
+            clearOnShrink: { apply: value => {
+                    if (typeof value !== "boolean")
+                        throw new TypeError("Clear-on-shrink setting is invalid");
+                    this.runtime.setClearOnShrink(value);
+                } },
+            showTerminalProgress: { apply: value => {
+                    if (typeof value !== "boolean")
+                        throw new TypeError("Terminal progress setting is invalid");
+                    this.#terminalProgressEnabled = value;
+                    this.#syncTerminalProgress(this.view());
+                } },
+        });
         this.#removeViewportPreInput = this.#customViewport
             ? this.runtime.addPreInputListener(data => {
                 // An overlay or editor-replacement screen owns its entire pointer
@@ -129,6 +174,53 @@ export class OwnedUiSessionShell {
         this.#unsubscribeSettings = this.#customViewport && options.viewportSettings
             ? options.viewportSettings.onChange(settings => this.root.setViewportConfig(settings))
             : () => { };
+        this.root.setEditorPaddingX(initialPiSettings.editorPaddingX);
+        this.root.setAutocompleteMaxVisible(initialPiSettings.autocompleteMaxVisible);
+        this.root.setOutputPad(initialPiSettings.outputPad);
+        this.root.setHideThinkingBlock(initialPiSettings.hideThinkingBlock);
+        this.root.setMermaidRenderingMode(initialPiSettings.mermaidRenderingMode);
+        this.#showImages = initialPiSettings.showImages;
+        this.#imageWidthCells = initialPiSettings.imageWidthCells;
+        this.root.setImagePresentation(this.#showImages, this.#imageWidthCells);
+        this.#unbindPiSettings = this.backend.bindSettingsOwner("shell", {
+            editorPaddingX: { apply: value => {
+                    if (typeof value !== "number")
+                        throw new TypeError("Editor padding is invalid");
+                    this.root.setEditorPaddingX(value);
+                } },
+            autocompleteMaxVisible: { apply: value => {
+                    if (typeof value !== "number")
+                        throw new TypeError("Autocomplete maximum is invalid");
+                    this.root.setAutocompleteMaxVisible(value);
+                } },
+            outputPad: { apply: value => {
+                    if (value !== 0 && value !== 1)
+                        throw new TypeError("Output padding is invalid");
+                    this.root.setOutputPad(value);
+                } },
+            hideThinkingBlock: { apply: value => {
+                    if (typeof value !== "boolean")
+                        throw new TypeError("Thinking-block visibility is invalid");
+                    this.root.setHideThinkingBlock(value);
+                } },
+            mermaidRenderingMode: { apply: value => {
+                    if (value !== "off" && value !== "final" && value !== "streaming")
+                        throw new TypeError("Mermaid mode is invalid");
+                    this.root.setMermaidRenderingMode(value);
+                } },
+            showImages: { apply: value => {
+                    if (typeof value !== "boolean")
+                        throw new TypeError("Image visibility is invalid");
+                    this.#showImages = value;
+                    this.root.setImagePresentation(this.#showImages, this.#imageWidthCells);
+                } },
+            imageWidthCells: { apply: value => {
+                    if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 1)
+                        throw new TypeError("Image width is invalid");
+                    this.#imageWidthCells = value;
+                    this.root.setImagePresentation(this.#showImages, this.#imageWidthCells);
+                } },
+        });
         this.#extensionBridge = createPiExtensionUiBridge({
             runtime: {
                 getColumns: () => this.runtime.viewport().columns,
@@ -174,6 +266,7 @@ export class OwnedUiSessionShell {
             const view = event.type === "transcript-block" && this.#sessionGeneration === this.backend.sessionGeneration
                 ? this.#syncBlock(event.block)
                 : semanticOnly ? this.view() : this.#syncView();
+            this.#syncTerminalProgress(view);
             if (view.lifecycle === "ready" && this.#compactionQueue.length > 0)
                 void this.#flushCompactionQueue();
             if (event.type === "session-lifecycle" && event.lifecycle === "stopped")
@@ -190,6 +283,7 @@ export class OwnedUiSessionShell {
             return;
         this.#started = true;
         this.runtime.start();
+        this.#syncTerminalProgress(this.view());
         if (this.#customViewport)
             this.#setPointerReporting(true);
         void this.backend.bindExtensionUi(this.#extensionBridge.context, () => { void this.shutdown(); });
@@ -238,7 +332,11 @@ export class OwnedUiSessionShell {
         }
         if (this.view().status.workingMessage?.startsWith("Compacting") === true) {
             this.root.editor.addToHistory(displayInput);
-            this.#compactionQueue.push({ text: input, type: "steer" });
+            this.#compactionQueue.push({
+                text: input,
+                type: "steer",
+                ...(prepared.images.length === 0 ? {} : { images: prepared.images }),
+            });
             this.root.appendWorkflowResult({ command: "compact", outcome: "completed", message: `Queued during compaction: ${input}` });
             this.runtime.requestRender();
             return { outcome: "completed", diagnostic: null };
@@ -336,14 +434,20 @@ export class OwnedUiSessionShell {
         return workflowAdapterResult(result);
     }
     async queueFollowUp() {
-        const text = this.root.editor.getText().trim();
-        if (!text)
+        const displayInput = this.root.editor.getText().trim();
+        if (!displayInput)
             return rejected("nothing to queue");
-        this.root.editor.addToHistory(text);
+        const prepared = this.root.preparePromptSubmission(displayInput);
+        const text = prepared.text.trim();
+        this.root.editor.addToHistory(displayInput);
         this.root.editor.setText("");
         this.root.resumeViewportFollowing();
         if (this.view().status.workingMessage?.startsWith("Compacting") === true) {
-            this.#compactionQueue.push({ text, type: "follow-up" });
+            this.#compactionQueue.push({
+                text,
+                type: "follow-up",
+                ...(prepared.images.length === 0 ? {} : { images: prepared.images }),
+            });
             return { outcome: "completed", diagnostic: null };
         }
         return this.#execute({
@@ -351,6 +455,7 @@ export class OwnedUiSessionShell {
             correlationId: this.#correlation("follow-up"),
             sessionId: this.backend.sessionId,
             text,
+            ...(prepared.images.length === 0 ? {} : { images: prepared.images }),
         });
     }
     restoreQueuedInput() {
@@ -597,12 +702,13 @@ export class OwnedUiSessionShell {
                         this.#setPointerReporting(true);
                     }
                 }
-                const result = this.backend.applyPinnedSettingValue(callback, value);
-                if (result.outcome === "failed")
-                    this.root.appendWorkflowResult(result);
-                else if (callback === "onTuiModeChange")
-                    this.root.appendWorkflowStatus(`TUI mode: ${value}`);
-                this.runtime.requestRender();
+                void this.backend.applyPinnedSettingValue(callback, value).then(result => {
+                    if (result.outcome === "failed")
+                        this.root.appendWorkflowResult(result);
+                    else if (callback === "onTuiModeChange")
+                        this.root.appendWorkflowStatus(`TUI mode: ${value}`);
+                    this.runtime.requestRender();
+                });
             },
             onCancel: close,
         });
@@ -824,11 +930,27 @@ export class OwnedUiSessionShell {
         this.#setPointerReporting(false, true);
         this.#removeViewportPreInput();
         this.#unsubscribeSettings();
+        const exitMode = this.backend.disposed
+            ? this.#fullscreenExitOutput
+            : this.backend.pinnedSettingsSnapshot().fullscreenExitOutput;
+        const exitTranscript = this.root.exitTranscript(this.runtime.viewport().columns);
+        const sessionFile = this.backend.currentSessionFile();
+        const resumeHint = sessionFile === null ? "" : `Resume: ${formatSessionResumeCommand(sessionFile)}`;
+        const fullscreenExitText = this.runtime.mode !== "fullscreen"
+            ? ""
+            : exitMode === "resume-hint"
+                ? resumeHint
+                : [exitTranscript, resumeHint].filter(Boolean).join("\n\n");
+        this.#unbindPiSettings();
+        this.#unbindTerminalSettings();
+        this.#unbindShutdownSettings();
         this.#unsubscribe();
         this.#dialogHandle?.hide();
         await this.backend.unbindExtensionUi();
         this.#extensionBridge.dispose();
         await this.runtime.dispose();
+        if (fullscreenExitText.length > 0)
+            this.runtime.writeAfterStop(`${fullscreenExitText}\n`);
     }
     /**
      * Applies one transcript block without re-reading the session. The listeners still hear
@@ -842,6 +964,11 @@ export class OwnedUiSessionShell {
             listener(view);
         return view;
     }
+    #syncTerminalProgress(view) {
+        if (!this.runtime.active)
+            return;
+        this.runtime.setTerminalProgress(this.#terminalProgressEnabled && view.lifecycle === "busy");
+    }
     #syncView() {
         const view = this.view();
         if (this.backend.sessionGeneration !== this.#sessionGeneration) {
@@ -1117,6 +1244,7 @@ export class OwnedUiSessionShell {
                 correlationId: this.#correlation(`compaction-${item.type}`),
                 sessionId: this.backend.sessionId,
                 text: item.text,
+                ...(item.images === undefined ? {} : { images: item.images }),
             });
         }
     }
@@ -1131,6 +1259,14 @@ export class OwnedUiSessionShell {
         return `pi-shell-${prefix}-${this.#sequence}`;
     }
 }
+export function formatSessionResumeCommand(sessionFile) {
+    return `${PRODUCT_TEXT.commandName} --session ${quoteCommandArgument(sessionFile)}`;
+}
+export function quoteCommandArgument(value) {
+    if (process.platform === "win32")
+        return `"${value.replaceAll("\"", "\"\"")}"`;
+    return `'${value.replaceAll("'", `'\\''`)}'`;
+}
 function modelReference(model) {
     if (typeof model !== "object" || model === null)
         return "";