@timurproko/a1 0.2.2-dev.611 → 0.2.2

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

@@ -1,4 +1,4 @@
-import { acceptsTranscriptUpdate } from "../../contracts/owned-ui/index.js";
+import { acceptsTranscriptUpdate, ImageAttachmentError } from "../../contracts/owned-ui/index.js";
 import { caretCell } from "../../ui/components/line-input.js";
 import { PromptInput, promptArrow } from "../../ui/components/prompt-input.js";
 import { composeSubmittedPromptRows, formatSubmittedPromptTime, submittedPromptLayout, } from "../../ui/components/submitted-prompt.js";
@@ -10,8 +10,8 @@ import { createPiExtensionUiBridge } from "../../integrations/pi/components/shel
 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, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellExtensionSelector, createPiShellLoginDialog, createPiShellModelSelector, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, } from "../../integrations/pi/components/shell-selectors-dialogs.js";
-import { createPiShellChangelog, createPiShellCollapsedChangelog, createPiShellHotkeys, createPiShellSessionInfo, renderPiShellCommandMessage, renderPiShellStatusText, } from "../../integrations/pi/components/shell-presenters-info.js";
-import { createPiShellTranscriptComponent, isPiPromptStyleCompaction, paintPiSubmittedPromptTimestamp, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellTranscriptBlock, } from "../../integrations/pi/components/shell-presenters-transcript.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";
 import { piShellHyperlink, piShellTruncateToWidth, piShellVisibleWidth, } from "../../integrations/pi/components/shell-shared-facade.js";
 import { classifyPiTuiInput, } from "../../integrations/pi/tui-runtime/input-presentation-coordinator.js";
@@ -62,6 +62,9 @@ export class OwnedUiSessionShellRoot {
     #lastWorkflowStatusId;
     // Invariant: the notice is dock chrome, never transcript content; the custom viewport alone uses it.
     #dockNotice;
+    // Invariant: bare A1 docks the release notice above the live status; closing it lasts for this session only.
+    #releaseNoticeDismissed = false;
+    #releaseCloseTarget;
     #copyAcknowledgement;
     #copyAcknowledgementTimer;
     #inputSurface;
@@ -80,6 +83,7 @@ export class OwnedUiSessionShellRoot {
     #extensionStatuses = new Map();
     #extensionWorkingMessage;
     #extensionWorkingVisible = true;
+    #imageSubmissionsSending = 0;
     constructor(view, cwd, handlers, startup = {}, agentDir, extensionRenderers = {
         getMessageRenderer: () => undefined,
         getToolDefinition: () => undefined,
@@ -88,7 +92,8 @@ export class OwnedUiSessionShellRoot {
         this.#customViewport = sessionLayout === "custom-viewport";
         this.#promptChips = new PromptChipStore({ isolated: this.#customViewport,
             ...(handlers.pasteDiagnostics === undefined ? {} : { onEvent: handlers.pasteDiagnostics }),
-            ...(handlers.pastePreparation === undefined ? {} : { preparation: handlers.pastePreparation }) });
+            ...(handlers.pastePreparation === undefined ? {} : { preparation: handlers.pastePreparation }),
+            ...(handlers.promptImageLimit === undefined ? {} : { imageLimit: handlers.promptImageLimit }) });
         this.#submittedPromptComposer = this.#customViewport
             ? {
                 layout: submittedPromptLayout,
@@ -150,18 +155,19 @@ export class OwnedUiSessionShellRoot {
                 if (rowIndex === 0)
                     this.#editorHyperlinks.reset();
                 const plain = stripAnsi(row);
+                const dimmed = this.#promptChips.unsentRanges(plain).reduce((result, range) => backgroundSgrSpan(result, piShellVisibleWidth(plain.slice(0, range.start)), piShellVisibleWidth(plain.slice(0, range.end)), "\u001b[2m", "\u001b[22m", piShellVisibleWidth), row);
                 const ranges = this.#promptChips.hyperlinkRanges(plain);
                 if (ranges.length === 0 || !this.#editorHyperlinks.takeCleanup())
-                    return row;
-                const linkResetAndTail = `\u001b]8;;\u001b\\\u001b[24m${" ".repeat(Math.max(0, width - piShellVisibleWidth(row)))}`;
+                    return dimmed;
+                const linkResetAndTail = `\u001b]8;;\u001b\\\u001b[24m${" ".repeat(Math.max(0, width - piShellVisibleWidth(dimmed)))}`;
                 // Platform: VS15 is zero-column and default-ignorable. It breaks Windows Terminal's
                 // plain-text URL detector only in the held-button paint; semantic text stays exact.
                 const paintRow = this.#viewportController.editorPointerSelecting
-                    ? row.replaceAll("https://", "https:\uFE0E//").replaceAll("http://", "http:\uFE0E//")
-                    : row;
+                    ? dimmed.replaceAll("https://", "https:\uFE0E//").replaceAll("http://", "http:\uFE0E//")
+                    : dimmed;
                 const decorated = this.#viewportController.editorPointerSelecting
                     ? ranges.reduce((result, range) => backgroundSgrSpan(result, piShellVisibleWidth(plain.slice(0, range.start)), piShellVisibleWidth(plain.slice(0, range.end)), "\u001b[4:4m", "\u001b[24m", piShellVisibleWidth), paintRow)
-                    : ranges.filter(range => this.#editorHyperlinks.take(range.target)).reduce((result, range) => hyperlinkSgrSpan(result, piShellVisibleWidth(plain.slice(0, range.start)), piShellVisibleWidth(plain.slice(0, range.end)), range.target, piShellVisibleWidth), row);
+                    : ranges.filter(range => this.#editorHyperlinks.take(range.target)).reduce((result, range) => hyperlinkSgrSpan(result, piShellVisibleWidth(plain.slice(0, range.start)), piShellVisibleWidth(plain.slice(0, range.end)), range.target, piShellVisibleWidth), dimmed);
                 // Platform: Windows Terminal can retain stale native dotted-link cells when a mutable
                 // prompt replaces a longer URL. Explicit non-link spaces overwrite that tail.
                 return `${decorated}${linkResetAndTail}`;
@@ -265,6 +271,9 @@ export class OwnedUiSessionShellRoot {
     prepareHistoryText(text) {
         return this.#promptChips.prepareHistoryText(text);
     }
+    omitUnsentPromptImages(text) {
+        return this.#promptChips.omitUnsentImages(text);
+    }
     rehydrateHistoryText(text, resolveImage) {
         return this.#promptChips.rehydrateHistoryText(text, resolveImage);
     }
@@ -274,6 +283,12 @@ export class OwnedUiSessionShellRoot {
     preparePromptSubmission(text) {
         return this.#promptChips.prepareSubmission(text);
     }
+    reconcilePromptImageLimitNotice(text = this.editor.getText()) {
+        if (this.#dockNotice?.errorCode !== "image-count" || !this.#promptChips.imageLimitState(text).corrected)
+            return false;
+        this.#dismissDockNotice();
+        return true;
+    }
     hasPendingPastes(text) { return this.#promptChips.hasPending(text); }
     waitForPromptPastes(text, signal) {
         return this.#promptChips.waitForPastes(text, signal, () => this.editor.getText());
@@ -316,7 +331,12 @@ export class OwnedUiSessionShellRoot {
             || view.diagnostics.some((diagnostic, index) => diagnostic.sequence !== this.#view.diagnostics[index]?.sequence)) {
             this.#documentLayouts.clear();
         }
+        const promptAccepted = this.#view.lifecycle !== "busy" && view.lifecycle === "busy";
         this.#view = view;
+        if (promptAccepted && this.#imageSubmissionsSending > 0) {
+            this.#imageSubmissionsSending = 0;
+            this.#syncWorkingOverride();
+        }
         this.#status.update(view);
         this.#footer.update(this.#viewWithExtensionStatuses(view));
         this.#queued.update(view.editor.queuedSubmissions);
@@ -384,7 +404,11 @@ export class OwnedUiSessionShellRoot {
             : Math.max(1, width - 1);
         const document = this.#renderDocumentLayout(documentWidth);
         const steeringRows = this.#renderQueued(documentWidth);
-        const statusRows = this.#renderStatus(documentWidth);
+        const releaseBanner = this.#renderReleaseBanner(documentWidth);
+        // Rationale: the release notice rides the bottom-aligned tail directly above Working, so it
+        // never displaces transcript content and scrolls away with the live status.
+        // Invariant: when idle the banner's last row sits on the line Working would occupy.
+        const statusRows = [...releaseBanner?.rows ?? [], ...this.#renderStatus(documentWidth)];
         const transientSignature = transientRowsSignature(steeringRows, statusRows);
         const snapshot = this.#visibleViewportSnapshot;
         // Invariant: paint-only feedback may cover either viewport or dock cells, so
@@ -459,6 +483,7 @@ export class OwnedUiSessionShellRoot {
         }
         else
             this.#dockOnlyViewportCompositions += 1;
+        this.#locateReleaseClose(frame, releaseBanner, document.rows.length + steeringRows.length + statusRows.length, statusRows.length);
         this.#visibleViewportSnapshot = {
             width,
             height,
@@ -598,6 +623,32 @@ export class OwnedUiSessionShellRoot {
         if (requestRender)
             this.#componentRuntime.requestRender();
     }
+    #renderReleaseBanner(width) {
+        if (this.#releaseNoticeDismissed)
+            return undefined;
+        const diagnostic = this.#view.diagnostics.findLast(item => item.code === "release-update");
+        const release = diagnostic === undefined ? null : parseReleaseUpdateDiagnostic(diagnostic.message);
+        if (release === null)
+            return undefined;
+        return renderPiShellReleaseUpdateBanner(release, width, this.#viewportController.tailControlHovered(this.#releaseCloseTarget));
+    }
+    #locateReleaseClose(frame, banner, tailEnd, tailLength) {
+        // Invariant: the tail is the document suffix, so the control's document row is fixed relative to its
+        // end; alignment gap rows precede it and the viewport scroll decides whether it is on screen.
+        const bannerStart = tailEnd + frame.descriptor.transientAlignmentGapRows - tailLength - frame.scrollTop + 1;
+        const rowStart = banner === undefined ? 0 : Math.max(1, bannerStart + banner.close.rowStart);
+        const rowEnd = banner === undefined ? 0 : Math.min(frame.hits.viewportHeight, bannerStart + banner.close.rowEnd);
+        this.#releaseCloseTarget = banner !== undefined && rowStart <= rowEnd
+            ? { rowStart, rowEnd, columnStart: banner.close.columnStart, columnEnd: banner.close.columnEnd }
+            : undefined;
+        this.#viewportController.setTailControl(this.#releaseCloseTarget === undefined ? undefined : {
+            ...this.#releaseCloseTarget,
+            activate: () => {
+                this.#releaseNoticeDismissed = true;
+                this.#releaseCloseTarget = undefined;
+            },
+        });
+    }
     #renderDockNotice(width) {
         const notice = this.#dockNotice;
         if (notice === undefined)
@@ -734,6 +785,14 @@ export class OwnedUiSessionShellRoot {
                 });
             }
         }
+        // Invariant: the A1 release notice precedes the extension-package notice, matching pinned Pi's order.
+        // Bare A1 docks it in the viewport tail instead of the document.
+        rows.push(...diagnostics
+            .filter(diagnostic => !this.#customViewport && diagnostic.code === "release-update")
+            .flatMap(diagnostic => {
+            const release = parseReleaseUpdateDiagnostic(diagnostic.message);
+            return release === null ? [] : renderPiShellReleaseUpdateNotice(release, width);
+        }));
         rows.push(...diagnostics
             .filter(diagnostic => diagnostic.code === "package-updates")
             .flatMap(diagnostic => renderPiShellPackageUpdateNotice(diagnostic.message.split("\n").filter(line => line.startsWith("- ")).map(line => line.slice(2)), width)));
@@ -748,6 +807,7 @@ export class OwnedUiSessionShellRoot {
                 : createPiShellChangelog(diagnostic.message).render(width)));
         rows.push(...diagnostics
             .filter(diagnostic => diagnostic.code !== "engine-startup" && diagnostic.code !== "project-trust"
+            && diagnostic.code !== "release-update"
             && diagnostic.code !== "package-updates" && diagnostic.code !== "changelog-collapsed"
             && diagnostic.code !== "changelog-expanded")
             .slice(-3)
@@ -842,13 +902,17 @@ export class OwnedUiSessionShellRoot {
         this.#workflowStatusMessages.set(id, message);
         this.#lastWorkflowStatusId = id;
     }
-    appendWorkflowMessage(message) {
+    appendWorkflowMessage(message, errorCode) {
         if (message.kind === "status") {
             this.appendWorkflowStatus(message.message);
             return;
         }
         if (this.#customViewport && (message.kind === "warning" || message.kind === "error")) {
-            this.#dockNotice = { kind: message.kind, message: message.message };
+            this.#dockNotice = {
+                kind: errorCode === "image-count" ? "warning" : message.kind,
+                message: message.message,
+                ...(errorCode === undefined ? {} : { errorCode }),
+            };
             this.#invalidateChrome();
             return;
         }
@@ -856,10 +920,10 @@ export class OwnedUiSessionShellRoot {
         const presentation = { kind: message.kind, message: message.message };
         this.#appendAnchoredWorkflowComponent(width => renderPiShellCommandMessage(presentation, width, this.#outputPad));
     }
-    appendWorkflowResult(result) {
+    appendWorkflowResult(result, errorCode) {
         if (result.messages !== undefined) {
             for (const message of result.messages)
-                this.appendWorkflowMessage(message);
+                this.appendWorkflowMessage(message, errorCode);
             return;
         }
         if (result.messageKind === "silent" || (result.outcome === "cancelled" && result.messageKind === undefined))
@@ -891,7 +955,7 @@ export class OwnedUiSessionShellRoot {
             this.appendWorkflowMessage({
                 kind: result.messageKind === "warning" ? "warning" : "error",
                 message: result.message,
-            });
+            }, errorCode);
             return;
         }
         if (result.outcome === "completed" && (result.command === "quit" || result.command === "compact"))
@@ -968,9 +1032,29 @@ export class OwnedUiSessionShellRoot {
     setExtensionWorking(message, visible = this.#extensionWorkingVisible) {
         this.#extensionWorkingMessage = message;
         this.#extensionWorkingVisible = visible;
-        this.#status.setWorkingOverride(visible ? message : undefined);
+        this.#syncWorkingOverride();
         this.invalidate();
     }
+    beginImageSubmissionStatus() {
+        this.#imageSubmissionsSending++;
+        this.#syncWorkingOverride();
+        this.invalidate();
+        let active = true;
+        return () => {
+            if (!active)
+                return;
+            active = false;
+            this.#imageSubmissionsSending = Math.max(0, this.#imageSubmissionsSending - 1);
+            this.#syncWorkingOverride();
+            this.invalidate();
+        };
+    }
+    #syncWorkingOverride() {
+        const sending = this.#imageSubmissionsSending > 0;
+        this.#status.setWorkingOverride(sending
+            ? "Sending…"
+            : this.#extensionWorkingVisible ? this.#extensionWorkingMessage : undefined, sending);
+    }
     hotkeysPresentation() {
         return {
             bindings: this.editor.keybindingConfig(),
@@ -1002,7 +1086,7 @@ export class OwnedUiSessionShellRoot {
         this.#extensionWidgets.clear();
         this.#extensionStatuses.clear();
         this.#extensionWorkingMessage = undefined;
-        this.#status.setWorkingOverride(undefined);
+        this.#syncWorkingOverride();
         this.#footer.update(this.#viewWithExtensionStatuses(this.#view));
         // Invariant: an extension renderer may have drawn transcript blocks that are now unrendered by it.
         this.#renderedRows.clear();
@@ -1439,6 +1523,15 @@ function isPackageExtensionSource(sourceInfo) {
 function transientRowsSignature(steeringRows, statusRows) {
     return `${steeringRows.length}\u0000${steeringRows.join("\u0000")}\u0001${statusRows.length}\u0000${statusRows.join("\u0000")}`;
 }
+/** The release, command, and optional changelog carried by the adapter's `release-update` diagnostic. */
+function parseReleaseUpdateDiagnostic(message) {
+    const [instruction, changelog] = message.split("\n");
+    const match = /^New version (\S+) is available\. Run (.+)$/.exec(instruction ?? "");
+    if (match === null)
+        return null;
+    const url = changelog === undefined ? null : /^Changelog: (\S+)$/.exec(changelog)?.[1] ?? null;
+    return { version: match[1], command: match[2], changelogUrl: url };
+}
 /** "Share URL: <url>" with the URL made clickable; other share wordings pass through unchanged. */
 function linkShareUrl(message) {
     const match = /^Share URL: (\S+)$/.exec(message);

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

@@ -8,7 +8,7 @@ import { type PiTuiDamageDecision } from "../../integrations/pi/tui-runtime/dama
 import { PiTuiRuntimeAdapter } from "../../integrations/pi/tui-runtime/adapter.js";
 import type { PiTuiOverlayHandle } from "../../integrations/pi/tui-runtime/contracts.js";
 import { OwnedUiSessionShellRoot, type OwnedUiBackendPort, type OwnedUiSessionShellOptions } from "./session-shell-root.js";
-export { OwnedUiSessionShellRoot, type OwnedUiSessionShellOptions, type OwnedUiShellDiagnosticOptions, type OwnedUiShellEngineOptions, type OwnedUiShellHistoryOptions, type OwnedUiShellPresentationOptions, type OwnedUiShellSkillsOptions, type OwnedUiShellSuggestionOptions, } from "./session-shell-root.js";
+export { OwnedUiSessionShellRoot, type OwnedUiSessionShellOptions, type OwnedUiShellDiagnosticOptions, type OwnedUiShellEngineOptions, type OwnedUiShellHistoryOptions, type OwnedUiShellPresentationOptions, type OwnedUiShellPromptImagesOptions, type OwnedUiShellSkillsOptions, type OwnedUiShellSuggestionOptions, } from "./session-shell-root.js";
 /** Coordinates backend, owned presentation, and Pi TUI lifecycles for one interactive session. */
 export declare class OwnedUiSessionShell {
     #private;

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

@@ -15,8 +15,8 @@ import { createPiShellEditor } from "../../integrations/pi/components/shell-edit
 import { SKILLS_COMMAND_NAME, findSkillByArgument, rewriteSkillsTunnelSubmission, skillPrompt, skillsFromCommands, } from "../../integrations/pi/components/skills-command.js";
 import { createPiQueuedInputStatus, createPiShellFooter, createPiShellHeader, createPiShellLoadedResources, createPiShellStatus, } from "../../integrations/pi/components/shell-footer-status.js";
 import { createPiShellArmin, createPiShellAuthProviderSelector, createPiShellDaxnuts, createPiShellDialog, createPiShellEarendilAnnouncement, createPiShellExtensionSelector, createPiShellLoginDialog, createPiShellModelSelector, createPiShellModelsDialog, createPiShellOperationLoader, createPiShellReloadBox, createPiShellScopedModelsSelector, createPiShellSelector, createPiShellSessionSelector, createPiShellSettingsSelector, createPiShellSkillsSelector, createPiShellTreeSelector, createPiShellTrustSelector, createPiShellUserMessageSelector, } from "../../integrations/pi/components/shell-selectors-dialogs.js";
-import { createPiShellChangelog, createPiShellHotkeys, createPiShellSessionInfo, renderPiShellStatusText, } from "../../integrations/pi/components/shell-presenters-info.js";
-import { createPiShellTranscriptComponent, renderPiShellPackageUpdateNotice, renderPiShellStartupDiagnostic, renderPiShellTranscriptBlock, } from "../../integrations/pi/components/shell-presenters-transcript.js";
+import { createPiShellChangelog, createPiShellHotkeys, createPiShellSessionInfo, renderPiShellPackageUpdateNotice, renderPiShellStatusText, } from "../../integrations/pi/components/shell-presenters-info.js";
+import { createPiShellTranscriptComponent, renderPiShellStartupDiagnostic, renderPiShellTranscriptBlock, } from "../../integrations/pi/components/shell-presenters-transcript.js";
 import { onPiThemeChange, piTheme } from "../../integrations/pi/components/upstream/theme/theme.js";
 import { DamageAwareTerminalAdapter } from "../../integrations/pi/tui-runtime/damage-aware-terminal.js";
 import { PiTuiRuntimeAdapter } from "../../integrations/pi/tui-runtime/adapter.js";
@@ -36,7 +36,9 @@ export class OwnedUiSessionShell {
     #unsubscribe;
     #unsubscribePromptSuggestions;
     #promptSuggestions;
+    #promptImages;
     #skills;
+    #unsubscribePromptImages;
     #unsubscribeSkills;
     #installedCommandSignature = "";
     #promptHistory = null;
@@ -47,6 +49,8 @@ export class OwnedUiSessionShell {
     #dialogId;
     #dialogSource;
     #routeHost;
+    #startupRoute;
+    #startupRouteTimer;
     #dialogHandle;
     #sequence = 0;
     #editorRevision = 0;
@@ -56,7 +60,6 @@ export class OwnedUiSessionShell {
     #disposePromise;
     #pointerReporting = false;
     // Invariant: translated startup diagnostics create at most one dock notice per kind per shell.
-    #startupChangelogHandled = false;
     #startupTrustHandled = false;
     #customViewport;
     #responseCopy;
@@ -95,6 +98,7 @@ export class OwnedUiSessionShell {
         this.#suggestionModelKey = modelKey(this.backend.view());
         this.#cwd = cwd;
         this.#routeHost = routeHost ?? null;
+        this.#startupRoute = options.engine.startupRoute;
         this.#customViewport = sessionLayout === "custom-viewport";
         this.#stopped = new Promise(resolve => {
             this.#resolveStopped = resolve;
@@ -104,7 +108,8 @@ export class OwnedUiSessionShell {
         let streamPresentation;
         let pendingClipboardWrite = Promise.resolve();
         let promptSuggestionController = null;
-        // Invariant: the collapsed skills presentation is a bare-A1 replacement; comparison profiles keep the pinned list.
+        // Invariant: owned prompt limits and collapsed skills are bare-A1 replacements; comparison profiles keep pinned behavior.
+        this.#promptImages = this.#customViewport ? options.promptImages ?? null : null;
         this.#skills = this.#customViewport ? options.skills ?? null : null;
         const terminalCopy = terminal !== undefined || hasAsyncClipboardOutput();
         this.#responseCopy = this.#customViewport ? new ResponseCopyCoordinator({
@@ -180,7 +185,11 @@ export class OwnedUiSessionShell {
             onMessageCopy: () => { void this.runWorkflow({ command: "copy", argument: "" }); },
             onFollowUp: () => { void this.queueFollowUp().catch(() => this.#reportSubmissionError()); },
             onDequeue: () => this.restoreQueuedInput(),
-            onEditorChange: () => { this.#editorRevision++; promptSuggestionController?.abortPending(); },
+            onEditorChange: text => {
+                this.#editorRevision++;
+                promptSuggestionController?.abortPending();
+                this.root.reconcilePromptImageLimitNotice(text);
+            },
             onPromptSuggestionAccepted: () => promptSuggestionController?.accept(),
             onInputSurfaceChanged: () => {
                 promptSuggestionController?.invalidate();
@@ -217,6 +226,7 @@ export class OwnedUiSessionShell {
             },
             ...(pasteDiagnostics === undefined ? {} : { pasteDiagnostics: pasteDiagnostics }),
             ...(pastePreparation === undefined ? {} : { pastePreparation }),
+            ...(this.#promptImages === null ? {} : { promptImageLimit: this.#promptImages.limit }),
             skillsPresentation: () => this.#skills?.presentation() ?? "expand",
         }, {
             ...startup,
@@ -302,6 +312,10 @@ export class OwnedUiSessionShell {
         this.#unsubscribePromptSuggestions = promptSuggestionOptions === undefined
             ? () => { }
             : promptSuggestionOptions.onChange(enabled => this.#promptSuggestions?.setEnabled(enabled));
+        this.#unsubscribePromptImages = this.#promptImages === null ? () => { } : this.#promptImages.onChange(() => {
+            if (!this.#disposed && this.root.reconcilePromptImageLimitNotice())
+                this.runtime.requestRender();
+        });
         // Rationale: the same listener refreshes the menu for the A1 presentation choice and for the engine's
         // skill-command registration, both of which the owned settings manager reports through one change.
         this.#unsubscribeSkills = this.#skills === null ? () => { } : this.#skills.onChange(() => {
@@ -586,6 +600,7 @@ export class OwnedUiSessionShell {
         setImmediate(() => {
             if (this.#disposed || !this.#customViewport)
                 return;
+            this.#presentStartupRoute();
             this.root.warmPastePreparation();
             this.#copyExecutor?.warm();
         });
@@ -698,15 +713,21 @@ export class OwnedUiSessionShell {
         // Compatibility: match interactive Pi: input during compaction is queued steering; the engine
         // shows it in the pending rows and delivers it when compaction ends.
         const type = this.view().lifecycle === "busy" ? "steer" : "prompt";
-        this.#rememberInput(displayInput, type);
+        this.#rememberInput(this.root.omitUnsentPromptImages(displayInput).trim(), type);
         this.root.resumeViewportFollowing();
-        return this.#execute({
-            type,
-            correlationId: this.#correlation(type),
-            sessionId: this.backend.sessionId,
-            text: input,
-            ...(prepared.images.length === 0 ? {} : { images: prepared.images }),
-        }, displayInput);
+        const finishSending = prepared.images.length === 0 ? () => { } : this.root.beginImageSubmissionStatus();
+        try {
+            return await this.#execute({
+                type,
+                correlationId: this.#correlation(type),
+                sessionId: this.backend.sessionId,
+                text: input,
+                ...(prepared.images.length === 0 ? {} : { images: prepared.images }),
+            }, displayInput);
+        }
+        finally {
+            finishSending();
+        }
     }
     async clearOrExit(now = Date.now()) {
         this.#promptSuggestions?.abortPending();
@@ -1559,8 +1580,14 @@ export class OwnedUiSessionShell {
         attempt(() => this.#setPointerReporting(false, true));
         attempt(() => this.#removeViewportPreInput());
         attempt(() => this.#streamPresentation.dispose());
+        attempt(() => {
+            if (this.#startupRouteTimer !== undefined)
+                clearTimeout(this.#startupRouteTimer);
+            this.#startupRouteTimer = undefined;
+        });
         attempt(() => this.#promptSuggestions?.dispose());
         attempt(() => this.#unsubscribePromptSuggestions());
+        attempt(() => this.#unsubscribePromptImages());
         attempt(() => this.#unsubscribeSkills());
         attempt(() => this.#unsubscribeSettings());
         let fullscreenExitText = "";
@@ -1706,25 +1733,12 @@ export class OwnedUiSessionShell {
         }
         this.root.update(view);
         this.#syncDialog(view.dialog);
-        this.#presentStartupChangelog(view);
         this.#presentStartupTrustWarning(view);
         this.runtime.requestRender();
         for (const listener of this.#listeners)
             listener(view);
         return view;
     }
-    // Rationale: release details stay one explicit command away; startup needs only the same quiet,
-    // non-transcript acknowledgement that bare A1 uses for model and thinking changes.
-    #presentStartupChangelog(view) {
-        if (this.#startupChangelogHandled || !this.#customViewport)
-            return;
-        const diagnostic = view.diagnostics.find(candidate => candidate.code === "changelog-collapsed" || candidate.code === "changelog-expanded");
-        // Invariant: a view synchronized before the runtime starts is not the moment of arrival; start() replays it.
-        if (diagnostic === undefined || !this.runtime.active)
-            return;
-        this.#startupChangelogHandled = true;
-        this.root.appendWorkflowStatus(STARTUP_CHANGELOG_NOTICE);
-    }
     // Rationale: a cancelled or failed trust choice explains the restricted session where the
     // user will next type, rather than leaving a lone warning at the top of an empty viewport.
     #presentStartupTrustWarning(view) {
@@ -1736,7 +1750,22 @@ export class OwnedUiSessionShell {
         this.#startupTrustHandled = true;
         this.root.appendWorkflowMessage({ kind: "warning", message: diagnostic.message });
     }
-    #openOwnedRoute(route, input) {
+    #presentStartupRoute() {
+        const pending = this.#startupRoute;
+        if (pending === undefined || this.#disposed || !this.runtime.active)
+            return;
+        if (this.runtime.hasOverlay() || !this.root.usesDefaultInputSurface()) {
+            this.#startupRouteTimer = setTimeout(() => {
+                this.#startupRouteTimer = undefined;
+                this.#presentStartupRoute();
+            }, 25);
+            this.#startupRouteTimer.unref?.();
+            return;
+        }
+        this.#startupRoute = undefined;
+        this.#openOwnedRoute(pending.route, pending.input, pending.onClosed);
+    }
+    #openOwnedRoute(route, input, onClosed) {
         const surface = this.#routeHost?.open(route, input) ?? null;
         if (surface === null)
             return { outcome: "failed", diagnostic: `route is unavailable: ${route}` };
@@ -1768,7 +1797,12 @@ export class OwnedUiSessionShell {
             return { consume: true };
         });
         let removeSurfacePreInput = () => { };
+        let rendered = false;
+        let closed = false;
         const closeSurface = () => {
+            if (closed)
+                return;
+            closed = true;
             removeSurfacePreInput();
             removeInterruptWatch();
             this.#setPointerReporting(false);
@@ -1776,6 +1810,12 @@ export class OwnedUiSessionShell {
             this.#dialogHandle = undefined;
             this.#dialogId = undefined;
             this.#dialogSource = undefined;
+            if (rendered) {
+                try {
+                    void onClosed?.()?.catch(() => undefined);
+                }
+                catch { /* Rationale: a failed acknowledgement stays pending. */ }
+            }
         };
         // Compatibility: fullscreen Pi owns a fallback text-selection layer before focused overlay
         // components see pointer input. Route every mouse report to the owned screen
@@ -1795,7 +1835,11 @@ export class OwnedUiSessionShell {
         });
         const rows = () => Math.max(1, this.runtime.viewport().rows);
         const component = {
-            render: (width) => [...surface.render(Math.max(1, width), rows())],
+            render: (width) => {
+                const frame = [...surface.render(Math.max(1, width), rows())];
+                rendered = true;
+                return frame;
+            },
             handleInput: (data) => {
                 const { events, rest } = parseMouseInput(data);
                 for (const event of events)
@@ -2085,14 +2129,16 @@ export class OwnedUiSessionShell {
         if (revision === this.#editorRevision && this.root.editor.getText().length === 0)
             this.root.editor.setText(draft);
         const message = error instanceof ImageAttachmentError ? error.message : "Submission rejected. Check the prompt and attachments.";
-        this.#reportSubmissionError(error, `${message} Press Up to recover the draft.`);
+        this.#reportSubmissionError(error, error instanceof ImageAttachmentError && error.code === "image-count"
+            ? message
+            : `${message} Press Up to recover the draft.`);
         return rejected(message);
     }
     #reportSubmissionError(error, message) {
         // Security: arbitrary provider/extension error messages can contain the entire request.
         try {
             this.root.appendWorkflowResult({ command: "debug", outcome: "failed", message: message
-                    ?? (error instanceof ImageAttachmentError ? error.message : "Submission failed. Check the prompt and try again.") });
+                    ?? (error instanceof ImageAttachmentError ? error.message : "Submission failed. Check the prompt and try again.") }, error instanceof ImageAttachmentError ? error.code : undefined);
             this.runtime.requestRender();
         }
         catch { /* Security: error presentation cannot create another rejected submission callback. */ }
@@ -2158,7 +2204,6 @@ function workflowAdapterResult(result) {
 const INTERRUPT = "\u0003";
 const INTERRUPT_CHORD_MS = 1_500;
 const RELOAD_SURFACE_MIN_VISIBLE_MS = 400;
-const STARTUP_CHANGELOG_NOTICE = "Run /changelog to view the full release notes.";
 // Rationale: the outro is not configurable; the switch only decides whether this plan plays.
 const QUIT_OUTRO_EFFECT = "fall";
 const QUIT_OUTRO_DURATION_MS = 800;

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

@@ -15,6 +15,13 @@ export interface SessionViewportControllerOptions {
     readonly pasteDiagnostics?: (event: PasteEvent) => void;
     readonly nextPasteDiagnosticRequest?: () => number;
 }
+/** One-based, inclusive terminal cells of a clickable viewport-tail control. */
+export interface TailControlRegion {
+    readonly rowStart: number;
+    readonly rowEnd: number;
+    readonly columnStart: number;
+    readonly columnEnd: number;
+}
 export interface SessionViewportInputResult {
     readonly data: string;
     readonly consumed: boolean;
@@ -45,6 +52,12 @@ export declare class SessionViewportController {
         readonly rowStart: number;
         readonly rowEnd: number;
     } | undefined): void;
+    /** The visible close control of a viewport-tail notice, or undefined when none is on screen. */
+    setTailControl(control: (TailControlRegion & {
+        readonly activate: () => void;
+    }) | undefined): void;
+    /** Whether the pointer currently rests on the tail control; drives its hover paint. */
+    tailControlHovered(target: TailControlRegion | undefined): boolean;
     /** Replacement input changed before its new bounds have been painted. */
     invalidateInputSurface(): void;
     setInputSurfaceFrame(surface: PiTuiPointerSurface | undefined): void;

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

@@ -3,6 +3,9 @@ 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";
+function withinTailControl(region, column, row) {
+    return row >= region.rowStart && row <= region.rowEnd && column >= region.columnStart && column <= region.columnEnd;
+}
 /**
  * Owns the stateful interaction policy of the bare-A1 session viewport. The
  * shell root supplies semantic rows and dock geometry; this controller owns
@@ -38,6 +41,8 @@ export class SessionViewportController {
     #pendingEditorClick;
     // Invariant: pointer routing uses the most recently composed editor rows.
     #editorPointerFrame;
+    // Invariant: one clickable region in the viewport tail, located by the most recent composition.
+    #tailControl;
     #selectionAutoScrollTimer;
     #selectionAutoScrollPointer;
     #pointerPosition;
@@ -89,6 +94,15 @@ export class SessionViewportController {
     setEditorPointerFrame(frame) {
         this.#editorPointerFrame = frame;
     }
+    /** The visible close control of a viewport-tail notice, or undefined when none is on screen. */
+    setTailControl(control) {
+        this.#tailControl = control;
+    }
+    /** Whether the pointer currently rests on the tail control; drives its hover paint. */
+    tailControlHovered(target) {
+        const pointer = this.#pointerPosition;
+        return target !== undefined && pointer !== undefined && withinTailControl(target, pointer.column, pointer.row);
+    }
     /** Replacement input changed before its new bounds have been painted. */
     invalidateInputSurface() {
         this.#inputSurfacePending = true;
@@ -360,6 +374,9 @@ export class SessionViewportController {
             const overSticky = overModal === undefined && hits.sticky !== null && event.row === hits.sticky.row && event.column <= hits.sticky.width;
             const overBottom = overModal === undefined && hits.bottom !== null && event.row === hits.bottom.row
                 && event.column >= hits.bottom.columnStart && event.column <= hits.bottom.columnEnd;
+            const tailControl = this.#tailControl;
+            const overTailControl = overModal === undefined && tailControl !== undefined
+                && withinTailControl(tailControl, event.column, event.row);
             const previousPointer = this.#pointerPosition;
             const wasOverBottom = hits.bottom !== null && previousPointer !== undefined
                 && previousPointer.row === hits.bottom.row
@@ -368,6 +385,9 @@ export class SessionViewportController {
             // Keep this location while the control is hidden; composition resolves its next hit region.
             this.#pointerPosition = { column: event.column, row: event.row };
             repaint ||= wasOverBottom !== overBottom;
+            const wasOverTailControl = tailControl !== undefined && previousPointer !== undefined
+                && withinTailControl(tailControl, previousPointer.column, previousPointer.row);
+            repaint ||= wasOverTailControl !== overTailControl;
             if (!this.#viewport.selectionActive && !this.#editorPointerSelecting) {
                 const nextHyperlink = this.#hyperlinkKeyAt(frame, event.column, event.row);
                 if (this.#hoveredHyperlinkKey !== undefined && nextHyperlink !== this.#hoveredHyperlinkKey) {
@@ -408,7 +428,7 @@ export class SessionViewportController {
                     activity = true;
                     return true;
                 }
-                return overRail || overSticky || overBottom;
+                return overRail || overSticky || overBottom || overTailControl;
             }
             if (event.kind === "wheel-up" || event.kind === "wheel-down") {
                 if (!allowWheel || event.row < 1 || event.row > hits.viewportHeight)
@@ -442,6 +462,13 @@ export class SessionViewportController {
                 this.#stopSelectionAutoScroll();
                 if (this.#viewport.clearSelection())
                     repaint = true;
+                if (overTailControl) {
+                    this.#tailControl = undefined;
+                    tailControl.activate();
+                    this.#tailPointerSuppressed = true;
+                    repaint = true;
+                    return true;
+                }
                 if (overBottom) {
                     this.#viewport.scrollToEnd(now);
                     this.#tailPointerSuppressed = true;