@timurproko/a1 0.2.7-dev.1221 → 0.2.7-dev.1225

package/README.md

@@ -63,6 +63,8 @@ Launch A1 in single agent mode:
 a1 solo
 ```
 
+When a solo session exits, its printed `a1 solo --session <id>` command resumes that same conversation in solo mode; a custom session store is included in the printed command. Resident tabs are different: they keep running after detach, and bare `a1` returns to them.
+
 Show all commands:
 
 ```text
@@ -92,7 +94,7 @@ a1 tabs
 a1 tabs stop <id>
 ```
 
-Stop every tab and the resident host, for example before going back to single agent mode with `a1 solo`:
+Stop every tab and the resident host when you are finished with them (not required to run `a1 solo`):
 
 ```text
 a1 tabs host stop
@@ -145,13 +147,13 @@ Stuck on `0.2.2` and `a1 update` fails? Run the installer once, then use `a1 upd
 npm x -y -- @timurproko/a1-install
 ```
 
-The **Update** setting controls the at-most-daily startup check:
+The **Update** setting controls release discovery:
 
-- **Auto** (default) silently installs a verified update for the running channel, then shows `Update installed · Restart to update`.
-- **Notify** keeps the `Update Available` notice and leaves installation manual.
-- **No** performs no startup update check; updates remain available through the commands above.
+- **Auto** (default) checks the running release's stable or development channel at startup and every 15 minutes while open. It silently installs a verified update, then shows `Update installed · Restart to update`; existing sessions keep running until restarted.
+- **Notify** checks at startup (at most daily), keeps the `Update Available` notice, and leaves installation manual.
+- **No** performs no update check; updates remain available through the commands above.
 
-`A1_SKIP_VERSION_CHECK=1` also disables the startup check. Manual stable, development, and exact-version update commands remain available in every mode.
+`A1_SKIP_VERSION_CHECK=1` disables both Auto and Notify discovery. Manual stable, development, and exact-version update commands remain available in every mode.
 
 <p align="center"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/assets/readme/separator-dark.svg"><img src="docs/assets/readme/separator.svg" alt="" width="280"></picture></p>
 

package/bin/ui.js

@@ -103,6 +103,7 @@ if (utilityRoute !== null) {
           ownedSurfaces,
           notificationVersion: launchContext.updateVersion,
           ...(hidesTabSettings(launchContext) ? { hideTabSettings: true } : {}),
+          soloResumeHint: profile === "a1" && launchContext.launchMode === "solo",
           ...(processInspector === null ? {} : { inspectProcess: pid => processInspector.observe(pid) }),
           projectTrustPrompt: createConsoleProjectTrustPrompt({ presentation: profile === "a1" ? "bare" : "comparison" }),
           sessionForkPrompt: createConsoleSessionForkPrompt(),

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

@@ -1,8 +1,8 @@
+import { COPY_ACKNOWLEDGEMENT_DURATION_MS } from "../../ui/components/selection-copy.js";
 import { renderPiShellCommandMessage, renderPiShellReleaseUpdateBanner, renderPiShellStatusText, } from "../../integrations/pi/components/shell-presenters-info.js";
 import { PINNED_PI_LAYOUT, piTheme } from "../../integrations/pi/components/upstream/theme/theme.js";
 import { piShellTruncateToWidth } from "../../integrations/pi/components/shell-shared-facade.js";
 import { parseReleaseUpdateDiagnostic } from "./transcript-document.js";
-const COPY_ACKNOWLEDGEMENT_DURATION_MS = 1_000;
 /**
  * The transient chrome around bare A1's dock: the one command notice above the editor, the release
  * banner above Working with its close control, and the short copy acknowledgement.

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

@@ -13,6 +13,6 @@ export interface ExitNoticeSource {
 export interface ArmedExitNotice {
     clear(): void;
 }
-export declare function uncleanExitNoticeLines(resume: SessionResumeCommandMetadata | null): string[];
+export declare function uncleanExitNoticeLines(resume: SessionResumeCommandMetadata | null, soloResumeHint?: boolean): string[];
 /** Arms the notice and keeps its resume command following the bound session until cleared. */
-export declare function armExitNotice(source: ExitNoticeSource, path: string): ArmedExitNotice;
+export declare function armExitNotice(source: ExitNoticeSource, path: string, soloResumeHint?: boolean): ArmedExitNotice;

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

@@ -7,14 +7,14 @@
 import { renameSync, rmSync, writeFileSync } from "node:fs";
 import { PRODUCT_IDENTITY } from "../../product-identity.js";
 import { formatSessionResumeCommand } from "./session-lifecycle.js";
-export function uncleanExitNoticeLines(resume) {
+export function uncleanExitNoticeLines(resume, soloResumeHint = false) {
     return [
         `${PRODUCT_IDENTITY.displayName} was stopped unexpectedly.`,
-        ...(resume === null ? [] : [`To resume this session: ${formatSessionResumeCommand(resume)}`]),
+        ...(resume === null ? [] : [`To resume this session: ${formatSessionResumeCommand(resume, soloResumeHint)}`]),
     ];
 }
 /** Arms the notice and keeps its resume command following the bound session until cleared. */
-export function armExitNotice(source, path) {
+export function armExitNotice(source, path, soloResumeHint = false) {
     let current = null;
     let cleared = false;
     let generation = source.identity.sessionGeneration;
@@ -22,7 +22,7 @@ export function armExitNotice(source, path) {
         if (cleared)
             return;
         // Protocol: plain text only; the guardian strips control characters, so styling would be lost.
-        const text = `${uncleanExitNoticeLines(source.identity.currentSessionResumeMetadata()).join("\n")}\n`;
+        const text = `${uncleanExitNoticeLines(source.identity.currentSessionResumeMetadata(), soloResumeHint).join("\n")}\n`;
         if (text === current)
             return;
         try {

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

@@ -3,13 +3,14 @@ export interface SessionResumeCommandMetadata {
     readonly sessionDir: string;
     readonly usesDefaultSessionDir: boolean;
 }
-export declare function formatSessionResumeCommand(metadata: SessionResumeCommandMetadata): string;
+export declare function formatSessionResumeCommand(metadata: SessionResumeCommandMetadata, solo?: boolean): string;
 export declare function quoteCommandArgument(value: string): string;
 export interface ExitTextInput {
     readonly terminalMode: "regular" | "fullscreen";
     readonly customViewport: boolean;
     readonly exitMode: "transcript" | "resume-hint";
     readonly resume: SessionResumeCommandMetadata | null;
+    readonly soloResumeHint?: boolean;
     /** The styled transcript, rendered only when the pinned profile asks for it. */
     readonly transcript: () => string;
 }

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

@@ -1,6 +1,8 @@
 import { PRODUCT_TEXT } from "../../product-identity.js";
-export function formatSessionResumeCommand(metadata) {
+export function formatSessionResumeCommand(metadata, solo = false) {
     const args = [PRODUCT_TEXT.commandName];
+    if (solo)
+        args.push("solo");
     if (!metadata.usesDefaultSessionDir)
         args.push("--session-dir", quoteCommandArgument(metadata.sessionDir));
     args.push("--session", metadata.sessionId);
@@ -18,7 +20,7 @@ export function quoteCommandArgument(value) {
 export function composeExitText(input) {
     if (input.terminalMode !== "fullscreen")
         return "";
-    const resumeHint = input.resume === null ? "" : `${dim("To resume this session:")} ${formatSessionResumeCommand(input.resume)}`;
+    const resumeHint = input.resume === null ? "" : `${dim("To resume this session:")} ${formatSessionResumeCommand(input.resume, input.soloResumeHint)}`;
     // Invariant: bare A1 leaves only the hint behind; the pinned comparison profile still
     // honors fullscreenExitOutput, including the styled transcript.
     if (input.customViewport || input.exitMode === "resume-hint")

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

@@ -73,6 +73,8 @@ export interface OwnedUiShellEngineOptions {
 /** Terminal, startup, viewport, and presentation-cadence seams; production leaves most at their defaults. */
 export interface OwnedUiShellPresentationOptions {
     readonly terminal?: OwnedUiTerminalPort;
+    /** Explicit direct solo launch, not a resident fallback or comparison launch. */
+    readonly soloResumeHint?: boolean;
     readonly startup?: OwnedUiStartupOptions;
     /** Live profile-local settings, supplied only to the bare-A1 composition. */
     readonly viewportSettings?: OwnedUiViewportSettingsPort;

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

@@ -1,7 +1,8 @@
 import { ImageAttachmentError } from "../../contracts/owned-ui/index.js";
 import { promptArrow } from "../../ui/components/prompt-input.js";
 import { composeSubmittedPromptRows, submittedPromptLayout, } from "../../ui/components/submitted-prompt.js";
-import { backgroundSgrSpan, nativeHyperlinkStyle, } from "../../ui/components/spans.js";
+import { nativeHyperlinkStyle } from "../../ui/components/spans.js";
+import { paintTextSelection } from "../../ui/components/text-selection.js";
 import { progressStatusFrame, progressStatusText } from "../../ui/components/progress-status.js";
 import { createPiQueuedInputStatus, createPiShellFooter, createPiShellHeader, createPiShellLoadedResources, createPiShellStatus, } from "../../integrations/pi/components/shell-footer-status.js";
 import { createPiShellTranscriptComponent, } from "../../integrations/pi/components/shell-presenters-transcript.js";
@@ -847,5 +848,5 @@ const VIEWPORT_THEME = {
     sticky: (text, hovered) => piTheme().bg(hovered ? "selectedBg" : "toolPendingBg", piTheme().fg("text", withoutTerminalBackground(text))),
     quietSticky: text => `\u001b[2m${text.replace(/\u001b\[(?:0|22)m/g, "$&\u001b[2m")}\u001b[22m`,
     bottomControl: (text, hovered) => piTheme().bg(hovered ? "selectedBg" : "toolPendingBg", piTheme().fg("text", text)),
-    selection: (line, from, to) => backgroundSgrSpan(line, from, to, "\u001b[48;2;38;79;120m", "\u001b[49m"),
+    selection: paintTextSelection,
 };

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

@@ -14,6 +14,7 @@ import { promptSuggestionSurface, routeResponseToSuggestions, suggestionModelKey
 import { CLEAR_EXIT_INTERVAL_MS, boundedCleanup } from "../../foundation/terminal-cleanup/terminal-reset.js";
 import { OWNED_UI_HIDDEN_COMMAND_NAMES } from "../../contracts/owned-ui/index.js";
 import { ImageAttachmentError } from "../../contracts/owned-ui/index.js";
+import { copyAcknowledgementText } from "../../ui/components/selection-copy.js";
 import { ContextualPromptSuggestionController } from "./prompt-suggestion-controller.js";
 import { workflowCommandNames } from "../../integrations/pi/engine/workflows.js";
 import { createPiExtensionUiBridge } from "../../integrations/pi/components/shell-extension-ui.js";
@@ -27,6 +28,8 @@ import { writeSystemClipboardText, } from "./system-clipboard.js";
 import { OwnedUiSessionShellRoot, shellResourceEntries, } from "./session-shell-root.js";
 // Invariant: a disposed shell leaves the engine a host that holds no reference back to it.
 const DETACHED_WORKFLOW_INTERACTION = { prompt: async () => null, notify() { } };
+// Invariant: the resume mode belongs to the presenter instance, not the persisted session or profile.
+const SOLO_RESUME_HINTS = new WeakSet();
 /** Resident Agents refuse the commands their tab bar serves instead, naming where they live. */
 const RESIDENT_UTILITY_TAB_REFUSALS = Object.freeze({
     settings: "Settings is available from the global Settings tab.",
@@ -108,6 +111,8 @@ export class OwnedUiSessionPresenter {
         this.#sessionBindingGeneration = this.backend.identity.sessionBindingGeneration;
         this.#suggestionModelKey = suggestionModelKey(this.backend.session.view());
         this.#customViewport = sessionLayout === "custom-viewport";
+        if (options.presentation?.soloResumeHint)
+            SOLO_RESUME_HINTS.add(this);
         this.#inputCoordination = inputPresentation?.coordination !== false;
         this.#host = host;
         this.#terminal = host.connect(this);
@@ -499,6 +504,8 @@ export class OwnedUiSessionPresenter {
             const snapshot = routed.copySelection;
             this.#trackCopy(this.#responseCopy?.submit(snapshot, this.#pendingClipboardWrite), copyCharacters(snapshot));
         }
+        if (routed.copyLastMessage)
+            void this.runWorkflow({ command: "copy", argument: "" });
         if (!routed.consumed)
             return routed.data === data ? undefined : { data: routed.data };
         return routed.data.length === 0 ? { consume: true } : { data: routed.data };
@@ -509,7 +516,7 @@ export class OwnedUiSessionPresenter {
             if (count === undefined || this.#disposed || !this.#terminal.running || intent !== this.#copyIntentSequence
                 || outcome !== "delivered" && outcome !== "submitted-unverified")
                 return;
-            this.root.showCopyAcknowledgement(`copied ${count} chars to clipboard`);
+            this.root.showCopyAcknowledgement(copyAcknowledgementText(count));
         });
     }
     #promptSuggestionPresentationBlockReason(identity) {
@@ -1081,6 +1088,7 @@ export class OwnedUiSessionPresenter {
                 customViewport: this.#customViewport,
                 exitMode: this.backend.identity.disposed ? this.#fullscreenExitOutput : this.backend.settings.snapshot().fullscreenExitOutput,
                 resume: this.backend.identity.currentSessionResumeMetadata(),
+                soloResumeHint: SOLO_RESUME_HINTS.has(this),
                 transcript: () => this.root.exitTranscript(terminal.columns),
             });
         });

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 {
@@ -26,6 +26,7 @@ export interface SessionViewportInputResult {
     readonly data: string;
     readonly consumed: boolean;
     readonly copySelection?: SelectionCopySnapshot;
+    readonly copyLastMessage?: true;
 }
 /**
  * Owns the stateful interaction policy of the bare-A1 session viewport. The

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

@@ -3,7 +3,6 @@ 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;
 }
@@ -254,15 +253,13 @@ export class SessionViewportController {
             pasteRequest = this.#nextPasteDiagnosticRequest();
             this.#emitPasteRoute(pasteRequest, "shortcut-received");
         }
-        // Compatibility: Pi components share one keybinding manager. Restore bare A1's aliases
-        // before the focused vanilla editor handles this input.
+        // Invariant: activate A1 aliases before editor input.
         if (editorActive)
             this.#editor.activateKeybindings();
         // Protocol: bracketed paste is opaque input, even if its text resembles mouse reports.
         if (data.startsWith("\u001b[200~"))
             return { data, consumed: false };
-        // Platform: handle the physical paste chord at the pre-input boundary. Windows
-        // terminals vary between forwarding Ctrl+V and terminal-owned bracketed paste.
+        // Platform: Windows terminals may forward Ctrl+V or terminal-owned paste.
         if (editorActive && this.#editor.matchesTerminalKey(data, "ctrl+v")) {
             pasteRequest ??= this.#nextPasteDiagnosticRequest();
             if (data !== "\u0016")
@@ -278,8 +275,7 @@ export class SessionViewportController {
             this.#requestHyperlinkCleanup();
             this.#requestRender();
         }
-        // Invariant: content shortcuts never reach the prompt, even before the first frame
-        // or when scrolling is a no-op. Plain Home/End remain editor line navigation.
+        // Invariant: viewport shortcuts skip the prompt; Home/End do not.
         if (editorActive && allowWheel && this.#editor.matchesTerminalKey(data, "ctrl+home")) {
             if (this.#viewport.scrollTo(0, now)) {
                 this.#scheduleActivityExpiry();
@@ -295,6 +291,9 @@ export class SessionViewportController {
             }
             return { data: "", consumed: true };
         }
+        if (data === "\u0018" && editorActive && !this.#viewport.hasSelection && !this.#editor.hasSelection()) {
+            return { data: "", consumed: true, copyLastMessage: true };
+        }
         if (this.#viewport.frame === null) {
             // Invariant: a not-yet-painted A1 screen is not Pi's selection surface.
             return routeMouseInput(data, event => {
@@ -305,22 +304,15 @@ export class SessionViewportController {
                 return event.kind === "motion" || event.kind === "release" || (event.kind === "press" && event.button === 0);
             });
         }
-        if (data === "\u0003") {
-            // 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();
-                return copySelection === null
-                    ? { data: "", consumed: true }
-                    : { data: "", consumed: true, copySelection };
-            }
-            if (editorActive && this.#editor.hasSelection()) {
-                if (this.#viewport.clearSelection())
-                    this.#requestRender();
-            }
+        if ((data === "\u0003" || data === "\u0018") && this.#viewport.hasSelection) {
+            // Invariant: the newest frame selection wins over an older editor selection.
+            const copySelection = this.#viewport.captureSelectedText();
+            this.#viewport.clearSelection();
+            this.#stopSelectionAutoScroll();
+            this.#requestRender();
+            return copySelection === null
+                ? { data: "", consumed: true }
+                : { data: "", consumed: true, copySelection };
         }
         const previousPrompt = PROMPT_UP_INPUTS.has(data) || this.#editor.matchesTerminalKey(data, "alt+home");
         if (editorActive && allowWheel && (previousPrompt || PROMPT_DOWN_INPUTS.has(data))) {
@@ -345,8 +337,7 @@ export class SessionViewportController {
             const hits = frame.hits;
             const overModal = this.#modalAt(event.column, event.row);
             const wheel = event.kind === "wheel-up" || event.kind === "wheel-down";
-            // Invariant: ownership is latched for a complete gesture. Modal reports bypass the outer
-            // fullscreen selection layer without ever invoking the hidden ordinary editor.
+            // Invariant: latch each gesture to one surface.
             if (this.#pointerOwner === "drain" || !this.inputGeometryReady) {
                 if (event.kind === "release")
                     this.#pointerOwner = undefined;
@@ -387,8 +378,7 @@ export class SessionViewportController {
             const wasOverBottom = hits.bottom !== null && previousPointer !== undefined
                 && previousPointer.row === hits.bottom.row
                 && previousPointer.column >= hits.bottom.columnStart && previousPointer.column <= hits.bottom.columnEnd;
-            // Invariant: every report locates the pointer, independently of which surface owns the action.
-            // Keep this location while the control is hidden; composition resolves its next hit region.
+            // Invariant: every report updates the pointer position.
             this.#pointerPosition = { column: event.column, row: event.row };
             repaint ||= wasOverBottom !== overBottom;
             const wasOverTailControl = tailControl !== undefined && previousPointer !== undefined
@@ -407,7 +397,7 @@ export class SessionViewportController {
                 this.#viewport.setRailHovered(overRail);
                 this.#viewport.setStickyHovered(overSticky);
                 repaint = true;
-                if (editorActive && this.#editor.ownsPointer() && this.#editorPointerFrame !== undefined) {
+                if (editorActive && this.#editorPointerSelecting && this.#editorPointerFrame !== undefined) {
                     this.#editor.handlePointer({
                         kind: "motion",
                         button: event.button,
@@ -423,6 +413,12 @@ export class SessionViewportController {
                     if (event.column === pendingEditorClick.column && event.row === pendingEditorClick.row)
                         return true;
                     this.#pendingEditorClick = undefined;
+                    const editorFrame = editorActive ? this.#editorPointerFrame : undefined;
+                    if (editorFrame !== undefined && this.#editor.handlePointer({ kind: "press", button: 0, column: pendingEditorClick.column, row: pendingEditorClick.row - editorFrame.rowStart + 1 })) {
+                        this.#editorPointerSelecting = true;
+                        this.#editor.handlePointer({ kind: "motion", button: event.button, column: event.column, row: event.row - editorFrame.rowStart + 1 });
+                        return true;
+                    }
                     this.#viewport.pressSelection(pendingEditorClick.column, pendingEditorClick.row, now, { continueMultiClick: false });
                     this.#viewport.extendSelection(event.column, event.row, now, false);
                     this.#updateSelectionAutoScroll(event.column, event.row, hits.viewportHeight, frame.rows.length);
@@ -513,8 +509,7 @@ export class SessionViewportController {
                 }
                 if (event.row >= 1 && event.row <= frame.rows.length && event.column <= frame.descriptor.width) {
                     if (editorFrame !== undefined && event.row >= editorFrame.rowStart && event.row <= editorFrame.rowEnd) {
-                        // Invariant: no-drag prompt clicks remain visually editor-owned. Distinct
-                        // motion promotes from this exact origin into complete-frame selection.
+                        // Invariant: no-drag clicks remain editor-owned; first motion latches an editor drag.
                         this.#pendingEditorClick = { column: event.column, row: event.row };
                     }
                     else {
@@ -527,7 +522,7 @@ export class SessionViewportController {
                 return true;
             }
             if (event.kind === "release") {
-                if (editorActive && this.#editor.ownsPointer() && this.#editorPointerFrame !== undefined) {
+                if (editorActive && this.#editorPointerSelecting && this.#editorPointerFrame !== undefined) {
                     const wasEditorSelecting = this.#editorPointerSelecting;
                     this.#editor.handlePointer({
                         kind: "release",
@@ -547,12 +542,6 @@ 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-editor-factory.js

@@ -2,6 +2,7 @@ import { caretCell } from "../../ui/components/line-input.js";
 import { PromptInput } from "../../ui/components/prompt-input.js";
 import { backgroundSgrSpan, hyperlinkSgrSpan } from "../../ui/components/spans.js";
 import { faint, stripAnsi } from "../../ui/components/text.js";
+import { paintTextSelection } from "../../ui/components/text-selection.js";
 import { createPiShellEditor } from "../../integrations/pi/components/shell-editor-autocomplete.js";
 import { piTheme } from "../../integrations/pi/components/upstream/theme/theme.js";
 import { piShellTruncateToWidth, piShellVisibleWidth, } from "../../integrations/pi/components/shell-shared-facade.js";
@@ -18,7 +19,9 @@ export function createShellEditor(ports) {
         ...handlers,
         keybindingProfile: customViewport ? "a1" : "pi",
         ...(handlers.keybindings === undefined ? {} : { keybindings: handlers.keybindings }),
-        paintEditorSelection: (line, from, to, atomic) => backgroundSgrSpan(line, from, to, atomic ? "\u001b[7m" : "\u001b[27m\u001b[48;2;38;79;120m", atomic ? "\u001b[27m" : "\u001b[49m", piShellVisibleWidth),
+        paintEditorSelection: (line, from, to, atomic) => atomic
+            ? backgroundSgrSpan(line, from, to, "\u001b[7m", "\u001b[27m", piShellVisibleWidth)
+            : paintTextSelection(line, from, to, piShellVisibleWidth, true),
         transformPastedContent: content => {
             try {
                 return promptChips.transformPastedContent(content, editor.getText());

package/dist/cli/dispatch.js

@@ -7,6 +7,8 @@ export function cliUsage(capabilities) {
         "--session <path|id>",
         "--session-dir <dir> --session <path|id>",
         "solo",
+        "solo --session <path|id>",
+        "solo --session-dir <dir> --session <path|id>",
         ...(capabilities.developmentComparison ? ["pi"] : []),
         "help",
         "version",
@@ -36,6 +38,8 @@ export function cliHelp(capabilities) {
         `  ${command} --session <path|id>`,
         `  ${command} --session-dir <dir> --session <path|id>`,
         `  ${command} solo`,
+        `  ${command} solo --session <path|id>`,
+        `  ${command} solo --session-dir <dir> --session <path|id>`,
         ...(capabilities.developmentComparison ? [`  ${command} pi`] : []),
         `  ${command} help`,
         `  ${command} version`,
@@ -145,8 +149,17 @@ export function parseCliCommand(arguments_, capabilities) {
             return parsePackageCommand(rest, "pi");
         return capabilities.developmentComparison ? { kind: "launch", profileId: "pi", launchMode: "solo" } : { kind: "noop" };
     }
-    if (command === "solo")
-        return withoutArguments(rest, { kind: "launch", profileId: "a1", launchMode: "solo" });
+    if (command === "solo") {
+        if (rest.length === 0)
+            return { kind: "launch", profileId: "a1", launchMode: "solo" };
+        try {
+            const sessionSelection = parseSessionSelection(rest);
+            return { kind: "launch", profileId: "a1", launchMode: "solo", ...(sessionSelection === undefined ? {} : { sessionSelection }) };
+        }
+        catch (error) {
+            return { kind: "error", message: PRODUCT_TEXT.diagnostic(`could not parse solo session launch: ${error instanceof Error ? error.message : String(error)}`) };
+        }
+    }
     if (command === "update")
         return parseUpdate(rest);
     if (command === "session")

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

@@ -24,6 +24,8 @@ export interface OwnedUiCompositionOptions {
     readonly profileId?: string;
     /** Hide resident-only tab controls for the explicit direct single-agent launch. */
     readonly hideTabSettings?: boolean;
+    /** The explicit solo launch owns a mode-specific resume hint; resident fallback keeps the tabbed form. */
+    readonly soloResumeHint?: boolean;
     /** `off` withholds A1-specific surfaces from comparison profiles. */
     readonly ownedSurfaces?: "on" | "off";
     readonly projectTrustPrompt?: PiProjectTrustPreflightPrompt;

package/dist/composition/owned-ui.js

@@ -210,7 +210,7 @@ export async function composeOwnedUi(options = {}) {
             },
             presentation: {
                 ...(options.terminal === undefined ? {} : { terminal: createPiTerminalBridge(options.terminal) }),
-                ...residentStartupPresentation(tabBridge !== null, options.residentFallbackNotice),
+                ...residentStartupPresentation(tabBridge !== null, options.residentFallbackNotice), soloResumeHint: options.soloResumeHint === true && tabBridge === null,
                 ...(clipboardDiagnostics === null ? {} : { input: { onEvent: event => clipboardDiagnostics.runtime(event) } }),
                 ...(viewportSettings === null ? {} : { viewportSettings }),
                 ...(backgroundSettings === null ? {} : { backgroundSettings }),
@@ -286,7 +286,7 @@ export async function composeOwnedUi(options = {}) {
             // Performance: the guardian notice loads beside first paint, never on the startup path.
             if (exitNoticePath)
                 exitNotice = import("../app/session-shell/exit-notice.js")
-                    .then(module => module.armExitNotice(backend, exitNoticePath), () => null);
+                    .then(module => module.armExitNotice(backend, exitNoticePath, options.soloResumeHint === true && tabBridge === null), () => null);
             presenter.start();
             releaseUpdates.start();
         },
@@ -345,17 +345,34 @@ function createPromptHistoryConfiguration(settings, backend, ownedSurfaces) {
 }
 function createStartupReleaseUpdateObservation(input) {
     const controller = new AbortController();
+    let timer;
+    let announcedVersion = null;
+    let eligible = input.mode === "auto";
+    let cadence = null;
+    let nextDelay = null;
+    let started = false;
     const observe = async () => {
-        const check = input.checkForNewerRelease
-            ?? (await import("../foundation/release/latest-release.js")).checkForNewerRelease;
+        // Performance: registry code and its locks stay outside the first-frame startup graph.
+        const releases = await import("../foundation/release/latest-release.js");
+        cadence = releases.UPDATE_CHECK_INTERVAL_MS;
+        nextDelay = cadence;
+        const check = input.checkForNewerRelease ?? releases.checkForNewerRelease;
         const runningVersion = input.packageVersion ?? await readPackageVersion();
         const discoveryVersion = input.mode === "notify" ? input.notificationVersion ?? runningVersion : runningVersion;
-        const release = await check({
+        const options = {
             runningVersion: discoveryVersion,
             configDir: input.configDir,
             interactive: process.stdout.isTTY === true,
             settingMode: input.mode,
-        });
+            signal: controller.signal,
+            onNextCheckDelay: milliseconds => { nextDelay = milliseconds; },
+        };
+        // Invariant: opt-outs never arm a recurring timer, nor read the cache or probe the registry.
+        if (input.checkForNewerRelease === undefined && releases.startupReleaseCheckSkipReason(options) !== null) {
+            eligible = false;
+            return;
+        }
+        const release = await check(options);
         if (release === null || controller.signal.aborted)
             return;
         if (input.mode === "notify") {
@@ -365,14 +382,27 @@ function createStartupReleaseUpdateObservation(input) {
         if (input.mode === "auto") {
             const installed = await import("../foundation/release/automatic-update.js")
                 .then(module => module.requestAutomaticUpdate({ release, runningVersion, signal: controller.signal }));
-            if (installed !== null && !controller.signal.aborted) {
+            if (installed !== null && installed !== announcedVersion && !controller.signal.aborted) {
+                announcedVersion = installed;
                 input.backend.extensions.announceReleaseUpdate({ status: "installed", version: installed });
             }
         }
     };
+    const run = async () => {
+        try {
+            await observe();
+        }
+        catch { /* Rationale: best effort; retry on the next interval. */ }
+        if (eligible && cadence !== null && !controller.signal.aborted) {
+            timer = setTimeout(() => { void run(); }, nextDelay ?? cadence);
+            timer.unref?.();
+        }
+    };
     return {
-        start() { void observe().catch(() => undefined); },
-        stop() { controller.abort(); },
+        start() { if (started || controller.signal.aborted)
+            return; started = true; void run(); },
+        stop() { controller.abort(); if (timer !== undefined)
+            clearTimeout(timer); },
     };
 }
 export { watchSharedSettings } from "./owned-settings.js";
@@ -383,8 +413,10 @@ function settingsRouteOptions(tabBridge, keybindings, agentDir, cwd) {
         agentDir,
         cwd,
         copyText: text => {
-            if (Buffer.byteLength(text) <= MAX_CLIPBOARD_TEXT_BYTES)
-                void writeSystemClipboardText(text).catch(() => { });
+            if (Buffer.byteLength(text) > MAX_CLIPBOARD_TEXT_BYTES)
+                return false;
+            void writeSystemClipboardText(text).catch(() => { });
+            return true;
         },
     };
 }

package/dist/composition/reference-selection-options.d.ts

@@ -0,0 +1,3 @@
+import type { ReferenceDocumentSelectionOptions } from "../features/owned-ui/reference-document-selection.js";
+/** Builds the Changelog selection clipboard policy without loading Pi's engine in a utility tab. */
+export declare function createReferenceSelectionOptions(settingsFile: string, copyText: ((text: string) => boolean | void) | undefined): ReferenceDocumentSelectionOptions;

package/dist/composition/reference-selection-options.js

@@ -0,0 +1,16 @@
+import { readFileSync } from "node:fs";
+/** Builds the Changelog selection clipboard policy without loading Pi's engine in a utility tab. */
+export function createReferenceSelectionOptions(settingsFile, copyText) {
+    return {
+        copyOnSelect: () => {
+            try {
+                const document = JSON.parse(readFileSync(settingsFile, "utf8"));
+                return typeof document.fullscreenCopyOnSelect === "boolean" ? document.fullscreenCopyOnSelect : true;
+            }
+            catch {
+                return true;
+            }
+        },
+        copyText: copyText ?? (() => false),
+    };
+}

package/dist/composition/settings-route-host.d.ts

@@ -2,7 +2,6 @@ import type { ReferenceDocumentProvider } from "../features/owned-ui/reference-s
 import type { OwnedSettingsManager } from "../ui/settings/manager.js";
 import type { UiRouteHost, UiRouteInput } from "../ui/apps/contracts.js";
 import type { PiKeybindingsHost } from "../integrations/pi/components/shell-shared-facade.js";
-/** Styled document rows for one content width. */
 export type OwnedReferenceRows = NonNullable<ReferenceDocumentProvider["rows"]>;
 /** Documents supplied by composition so the route host never reads shell data itself. */
 export interface OwnedReferenceProviders {
@@ -22,7 +21,7 @@ export interface OwnedRouteHostOptions {
     readonly keybindings?: PiKeybindingsHost;
     readonly agentDir?: string;
     readonly cwd?: string;
-    readonly copyText?: (text: string) => void;
+    readonly copyText?: (text: string) => boolean | void;
 }
 /** Declares settings and lazy document routes. */
 export declare function createOwnedRouteHost(settings: OwnedSettingsManager, references?: OwnedReferenceProviders, options?: OwnedRouteHostOptions): UiRouteHost;