@timurproko/a1 0.2.7-dev.810 → 0.2.7-dev.831

package/README.md

@@ -145,7 +145,13 @@ Stuck on `0.2.2` and `a1 update` fails? Run the installer once, then use `a1 upd
 npm x -y -- @timurproko/a1-install
 ```
 
-A1 shows an `Update Available` notice at most once a day and never installs anything by itself. Turn it off in Settings (`Update check`) or with `A1_SKIP_VERSION_CHECK=1`.
+The **Update** setting controls the at-most-daily startup check:
+
+- **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.
+
+`A1_SKIP_VERSION_CHECK=1` also disables the startup check. 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/automatic-update.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+
+import("../dist/foundation/release/automatic-update.js").then(async ({ runAutomaticUpdateWorker }) => {
+  process.exitCode = await runAutomaticUpdateWorker(process.argv.slice(2));
+}).catch(() => {
+  process.exitCode = 1;
+});

package/bin/ui.js

@@ -78,6 +78,7 @@ Promise.resolve().then(async () => {
         cwd: process.cwd(),
         profileId,
         ownedSurfaces,
+        notificationVersion: launchContext.updateVersion,
         ...(hidesTabSettings(launchContext) ? { hideTabSettings: true } : {}),
         ...(processInspector === null ? {} : { inspectProcess: pid => processInspector.observe(pid) }),
         projectTrustPrompt: createConsoleProjectTrustPrompt({ presentation: profile === "a1" ? "bare" : "comparison" }),

package/dist/app/session-shell/resident-tab-coordinator.d.ts

@@ -1,18 +1,15 @@
 import type { OwnedUiEvent, PromptHistoryImageSidecarPort } from "../../contracts/owned-ui/index.js";
 import type { SessionConcern } from "./session-concern.js";
 import type { OwnedUiShellEngineOptions, OwnedUiSessionShellRoot } from "./session-shell-root.js";
-import type { OwnedUiPresenterTerminal } from "./shell-host.js";
 export type ResidentTabOptions = NonNullable<OwnedUiShellEngineOptions["residentTab"]>;
 export interface ResidentTabCoordinatorPorts {
     readonly root: Pick<OwnedUiSessionShellRoot, "appendWorkflowStatus" | "rehydrateHistoryText" | "editor">;
-    readonly terminal: Pick<OwnedUiPresenterTerminal, "requestRender">;
-    readonly disposed: () => boolean;
 }
 /**
- * The session presenter's side of a resident tab: recovered input, the progress and stall status
- * it reports to the strip, prompt admission and correlation through the recovery journal, draft
- * checkpoints, detach on quit, and the graceful stop when the presenter is released. Outside a
- * resident tab every operation is a no-op.
+ * The session presenter's side of a resident tab: recovered input, the idle status it reports to
+ * the strip, prompt admission and correlation through the recovery journal, draft checkpoints,
+ * detach on quit, and the graceful stop when the presenter is released. Outside a resident tab
+ * every operation is a no-op.
  */
 export declare class ResidentTabCoordinator implements SessionConcern {
     #private;
@@ -23,8 +20,8 @@ export declare class ResidentTabCoordinator implements SessionConcern {
     closeOwnedRoute(route: string): void;
     /** Puts the prompts and draft a previous tab process left unfinished back into the editor. */
     restoreInput(imageSidecar?: PromptHistoryImageSidecarPort): void;
-    /** Tracks working, idle, and stalled status from session events and arms the stall notice. */
-    observeProgress(event: OwnedUiEvent): void;
+    /** Reports idle to the strip whenever the session leaves its busy lifecycle. */
+    observeLifecycle(event: OwnedUiEvent): void;
     /** Journals a prompt before it is sent; undefined outside a resident tab. Rejects when the journal cannot sync. */
     admit(input: Parameters<NonNullable<ResidentTabOptions["admit"]>>[0]): Promise<{
         readonly id: string;

package/dist/app/session-shell/resident-tab-coordinator.js

@@ -1,18 +1,12 @@
-const PROGRESS_EVENTS = new Set([
-    "transcript-block", "session-view", "assistant-message-completed", "agent-run-started",
-]);
 /**
- * The session presenter's side of a resident tab: recovered input, the progress and stall status
- * it reports to the strip, prompt admission and correlation through the recovery journal, draft
- * checkpoints, detach on quit, and the graceful stop when the presenter is released. Outside a
- * resident tab every operation is a no-op.
+ * The session presenter's side of a resident tab: recovered input, the idle status it reports to
+ * the strip, prompt admission and correlation through the recovery journal, draft checkpoints,
+ * detach on quit, and the graceful stop when the presenter is released. Outside a resident tab
+ * every operation is a no-op.
  */
 export class ResidentTabCoordinator {
     #options;
     #ports;
-    #progressTimer;
-    #working = false;
-    #stalled = false;
     constructor(options, ports) {
         this.#options = options;
         this.#ports = ports;
@@ -51,40 +45,10 @@ export class ResidentTabCoordinator {
             root.appendWorkflowStatus("Recovered the editor draft from the previous tab process.");
         }
     }
-    /** Tracks working, idle, and stalled status from session events and arms the stall notice. */
-    observeProgress(event) {
-        const resident = this.#options;
-        const seconds = resident?.stallNoticeSeconds;
-        if (resident === undefined || seconds === undefined)
-            return;
-        if (event.type === "session-lifecycle") {
-            this.#working = event.lifecycle === "busy";
-            if (!this.#working) {
-                this.#clearTimer();
-                this.#stalled = false;
-                resident.reportStatus?.("idle");
-                return;
-            }
-        }
-        else if (!this.#working || !PROGRESS_EVENTS.has(event.type)) {
-            return;
-        }
-        if (this.#stalled) {
-            this.#stalled = false;
-            resident.reportStatus?.("working");
-        }
-        this.#clearTimer();
-        this.#progressTimer = setTimeout(() => {
-            this.#progressTimer = undefined;
-            if (this.#ports.disposed() || !this.#working)
-                return;
-            this.#stalled = true;
-            resident.reportStatus?.("stalled");
-            const minutes = Math.max(1, Math.round(seconds / 60));
-            this.#ports.root.appendWorkflowStatus(`No progress for ${minutes} min — Esc interrupts · use the tab restart action to restart`);
-            this.#ports.terminal.requestRender();
-        }, seconds * 1_000);
-        this.#progressTimer.unref?.();
+    /** Reports idle to the strip whenever the session leaves its busy lifecycle. */
+    observeLifecycle(event) {
+        if (event.type === "session-lifecycle" && event.lifecycle !== "busy")
+            this.#options?.reportStatus?.("idle");
     }
     /** Journals a prompt before it is sent; undefined outside a resident tab. Rejects when the journal cannot sync. */
     admit(input) {
@@ -109,12 +73,5 @@ export class ResidentTabCoordinator {
     gracefulStop(sessionFile) {
         return this.#options?.gracefulStop?.(sessionFile) ?? Promise.resolve();
     }
-    dispose() {
-        this.#clearTimer();
-    }
-    #clearTimer() {
-        if (this.#progressTimer !== undefined)
-            clearTimeout(this.#progressTimer);
-        this.#progressTimer = undefined;
-    }
+    dispose() { }
 }

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

@@ -47,8 +47,7 @@ export interface OwnedUiShellEngineOptions {
     readonly residentTab?: {
         requestDetach(): Promise<boolean>;
         closeOwnedRoute?(route: string): void;
-        reportStatus?(status: "working" | "idle" | "stalled"): void;
-        readonly stallNoticeSeconds?: number;
+        reportStatus?(status: "working" | "idle"): void;
         admit?(input: {
             readonly sessionId: string;
             readonly sessionFile: string | null;
@@ -117,6 +116,13 @@ export interface OwnedUiShellPresentationOptions {
 /** Persistent prompt history: its store, its bound, the editor that recalls it, and the image sidecar. */
 export interface OwnedUiShellHistoryOptions {
     readonly store: import("../../contracts/owned-ui/index.js").PromptHistoryPort;
+    /** When present, session replacement selects a new store and sidecar, not the old session's recall. */
+    readonly sessionId?: string;
+    readonly scope?: "unique" | "shared";
+    readonly forSession?: (sessionId: string) => Pick<OwnedUiShellHistoryOptions, "store" | "imageSidecar">;
+    /** A live scope change selects the matching store for this session without copying records. */
+    readonly forScope?: (scope: "unique" | "shared", sessionId: string | null) => Pick<OwnedUiShellHistoryOptions, "store" | "imageSidecar"> | null;
+    readonly onScopeChange?: (listener: (scope: "unique" | "shared") => void) => () => void;
     readonly limit: number;
     readonly editor: import("../../integrations/pi/components/index.js").HistoryEditorConstructor;
     /** Optional per-profile filesystem sidecar for image chip payloads. When present, submit
@@ -192,7 +198,7 @@ export declare class OwnedUiSessionShellRoot implements PiTuiComponentPort {
         readonly requestHyperlinkCleanup?: (rows?: readonly number[]) => void;
         readonly enableDockInputReuse?: boolean;
         readonly persistentHistory?: boolean;
-        readonly hideSettingsCommand?: boolean;
+        readonly hideUtilityTabCommands?: boolean;
         readonly historyEditor?: import("../../integrations/pi/components/index.js").HistoryEditorConstructor;
         readonly onSubmit: (text: string) => void;
         readonly onPasteRejected?: (error: unknown) => void;

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

@@ -27,6 +27,12 @@ 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() { } };
+/** 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.",
+    changelog: "The changelog opens as its own tab from the command palette (Alt+/).",
+    name: "Rename the session by renaming its tab (F2).",
+});
 export { OwnedUiSessionShellRoot, } from "./session-shell-root.js";
 export { OwnedUiTerminalHost, sessionTerminalHostOptions } from "./shell-host.js";
 export { formatSessionResumeCommand, quoteCommandArgument } from "./session-lifecycle.js";
@@ -55,7 +61,7 @@ export class OwnedUiSessionPresenter {
     #unsubscribeSkills;
     #installedCommandSignature = "";
     #promptHistory = null;
-    #promptHistoryImageSidecar;
+    #historyBinding;
     #extensionBridge;
     #stop = new SessionStopLatch();
     #dialogs;
@@ -169,7 +175,7 @@ export class OwnedUiSessionPresenter {
                 }),
                 enableDockInputReuse: inputPresentation?.viewportReuse !== false,
                 footerSessionName: options.engine.residentTab === undefined,
-                hideSettingsCommand: options.engine.residentTab !== undefined,
+                hideUtilityTabCommands: options.engine.residentTab !== undefined,
                 persistentHistory: this.#customViewport && promptHistory !== undefined,
                 ...(promptHistory === undefined ? {} : { historyEditor: promptHistory.editor }),
                 onSubmit: text => { void this.submit(text).catch(() => this.#submission.reportError()); },
@@ -251,7 +257,7 @@ export class OwnedUiSessionPresenter {
             // Invariant: the presenter owns its root (theme subscription and helper clients) and disposes it once the
             // terminal no longer renders it.
             constructed.push(() => this.root.dispose());
-            this.#resident = new ResidentTabCoordinator(options.engine.residentTab, { root: this.root, terminal: this.#terminal, disposed: () => this.#disposed });
+            this.#resident = new ResidentTabCoordinator(options.engine.residentTab, { root: this.root });
             constructed.push(() => this.#resident.dispose());
             const startupRoute = options.engine.startupRoute;
             this.#dialogs = new SessionDialogCoordinator({
@@ -316,9 +322,10 @@ export class OwnedUiSessionPresenter {
                 });
             };
             applyViewportSettings();
-            this.#unsubscribeSettings = this.#customViewport && viewportSettings
-                ? viewportSettings.onChange(settings => this.root.setViewportConfig(settings))
-                : () => { };
+            const unsubscribeViewport = this.#customViewport && viewportSettings ? viewportSettings.onChange(settings => this.root.setViewportConfig(settings)) : () => { };
+            const unsubscribeHistoryScope = this.#customViewport && promptHistory?.onScopeChange?.(scope => this.#rebindTranscript(scope));
+            this.#unsubscribeSettings = () => { unsubscribeViewport(); if (unsubscribeHistoryScope)
+                unsubscribeHistoryScope(); };
             constructed.push(this.#unsubscribeSettings);
             this.#unbindSessionSettings = bindSessionSettings(this.backend.settings, initialPiSettings, {
                 terminal: this.#terminal,
@@ -331,8 +338,7 @@ export class OwnedUiSessionPresenter {
             }, { customViewport: this.#customViewport });
             constructed.push(this.#unbindSessionSettings);
             if (this.#customViewport && promptHistory !== undefined) {
-                this.#promptHistoryImageSidecar = promptHistory.imageSidecar;
-                const sidecar = this.#promptHistoryImageSidecar;
+                this.#historyBinding = { options: promptHistory, scope: promptHistory.scope ?? "unique", sessionId: promptHistory.sessionId, imageSidecar: promptHistory.imageSidecar };
                 this.#promptHistory = new PromptHistoryController({
                     editor: this.root.editor,
                     store: promptHistory.store,
@@ -340,7 +346,7 @@ export class OwnedUiSessionPresenter {
                     fallback: this.view().transcript.flatMap(block => block.kind === "user" ? [block.text] : []),
                     active: () => this.root.usesDefaultInputSurface(),
                     render: () => this.#terminal.requestRender(),
-                    rehydrate: value => this.root.rehydrateHistoryText(value, id => sidecar?.readAttachment(id) ?? null),
+                    rehydrate: value => this.root.rehydrateHistoryText(value, id => this.#historyBinding?.imageSidecar?.readAttachment(id) ?? null),
                 });
                 constructed.push(() => { void this.#promptHistory?.close().catch(() => false); });
             }
@@ -366,7 +372,7 @@ export class OwnedUiSessionPresenter {
                         this.#stop.settleAfter(() => this.dispose());
                     return;
                 }
-                this.#resident.observeProgress(event);
+                this.#resident.observeLifecycle(event);
                 // Performance: a streamed chunk names one block, and touching only that block is what keeps the
                 // cost of a chunk the same in a long session as in a new one. Everything else
                 // resynchronizes the view, which is cheap next to re-reading the transcript.
@@ -1154,7 +1160,7 @@ export class OwnedUiSessionPresenter {
             residentTab: this.#resident,
             cwd,
             promptHistory: () => this.#promptHistory,
-            imageSidecar: () => this.#promptHistoryImageSidecar,
+            imageSidecar: () => this.#historyBinding?.imageSidecar,
             disposed: () => this.#disposed,
             correlation: prefix => this.#correlation(prefix),
             lifecycle: () => this.view().lifecycle,
@@ -1183,13 +1189,57 @@ export class OwnedUiSessionPresenter {
             this.#resident,
         ]);
     }
-    // Invariant: delivery recovery invalidates callbacks, not same-session local recall or its draft.
-    #rebindTranscript() {
-        if (this.#sessionBindingGeneration === this.backend.identity.sessionBindingGeneration)
+    // Invariant: delivery recovery does not replace a store; conversation or live scope changes can.
+    #rebindTranscript(scope) {
+        const replaced = this.#sessionBindingGeneration !== this.backend.identity.sessionBindingGeneration;
+        if (!replaced && scope === undefined)
             return;
-        this.#sessionBindingGeneration = this.backend.identity.sessionBindingGeneration;
-        this.root.resetTranscript();
-        this.#promptHistory?.reset(this.view().transcript.flatMap(block => block.kind === "user" ? [block.text] : []));
+        if (replaced) {
+            this.#sessionBindingGeneration = this.backend.identity.sessionBindingGeneration;
+            this.root.resetTranscript();
+        }
+        const binding = this.#historyBinding;
+        if (binding?.options.forSession !== undefined || binding?.options.forScope !== undefined) {
+            const sessionId = this.backend.identity.currentHistorySessionId();
+            const selectedScope = scope ?? binding.scope;
+            if (selectedScope !== binding.scope || sessionId !== binding.sessionId) {
+                if (!replaced)
+                    this.root.editor.recall?.restoreDraft?.();
+                const previous = this.#promptHistory;
+                this.#promptHistory = null;
+                binding.imageSidecar = undefined;
+                binding.scope = selectedScope;
+                binding.sessionId = sessionId ?? undefined;
+                void previous?.close().catch(() => false);
+                const destination = binding.options.forScope !== undefined
+                    ? binding.options.forScope(selectedScope, sessionId)
+                    : sessionId === null ? null : binding.options.forSession(sessionId);
+                if (destination !== null) {
+                    binding.imageSidecar = destination.imageSidecar;
+                    const controller = new PromptHistoryController({
+                        editor: this.root.editor,
+                        store: destination.store,
+                        limit: binding.options.limit,
+                        fallback: replaced ? this.view().transcript.flatMap(block => block.kind === "user" ? [block.text] : []) : [],
+                        active: () => this.root.usesDefaultInputSurface(),
+                        render: () => this.#terminal.requestRender(),
+                        rehydrate: value => this.root.rehydrateHistoryText(value, id => this.#historyBinding?.imageSidecar?.readAttachment(id) ?? null),
+                    });
+                    this.#promptHistory = controller;
+                    if (this.#started)
+                        controller.start();
+                }
+                else {
+                    // Security: missing identity must not reopen Shared or retain another session's recall.
+                    const fallback = replaced ? this.view().transcript.flatMap(block => block.kind === "user" ? [block.text] : []).reverse() : [];
+                    this.root.editor.recall?.reset();
+                    this.root.editor.recall?.replace(fallback);
+                }
+                return;
+            }
+        }
+        if (replaced)
+            this.#promptHistory?.reset(this.view().transcript.flatMap(block => block.kind === "user" ? [block.text] : []));
     }
     #syncTerminalProgress(view) {
         if (!this.#terminal.running)
@@ -1254,9 +1304,9 @@ export class OwnedUiSessionPresenter {
         const separator = body.search(/\s/);
         const name = separator < 0 ? body : body.slice(0, separator);
         const argument = separator < 0 ? "" : body.slice(separator + 1).trimStart();
-        if (name === "settings" && this.#resident.active) {
-            return rejected("Settings is available from the global Settings tab.");
-        }
+        const utilityTab = this.#resident.active ? RESIDENT_UTILITY_TAB_REFUSALS[name] : undefined;
+        if (utilityTab !== undefined)
+            return rejected(utilityTab);
         if (this.#dialogs.claimsRoute(name))
             return this.#dialogs.openRoute(name);
         if (this.#isWorkflowRoute(name))

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

@@ -322,8 +322,8 @@ export class SessionViewportController {
                     this.#requestRender();
             }
         }
-        const previousPrompt = SHIFT_UP_INPUTS.has(data) || this.#editor.matchesTerminalKey(data, "alt+home");
-        if (editorActive && allowWheel && (previousPrompt || SHIFT_DOWN_INPUTS.has(data))) {
+        const previousPrompt = PROMPT_UP_INPUTS.has(data) || this.#editor.matchesTerminalKey(data, "alt+home");
+        if (editorActive && allowWheel && (previousPrompt || PROMPT_DOWN_INPUTS.has(data))) {
             const scrolled = previousPrompt
                 ? this.#viewport.scrollToPreviousPrompt(now)
                 : this.#viewport.scrollToNextPrompt(now);
@@ -670,5 +670,7 @@ export class SessionViewportController {
 }
 const SELECTION_AUTO_SCROLL_INTERVAL_MS = 30;
 const EDITOR_LINK_DELETION_INPUTS = new Set(["\b", "\u007f", "\u001b[3~"]);
-const SHIFT_UP_INPUTS = new Set(["\u001b[1;2A"]);
-const SHIFT_DOWN_INPUTS = new Set(["\u001b[1;2B"]);
+// Platform: Windows Terminal may consume Shift+Arrow for native selection. Ctrl+Arrow matches
+// solo A1's Windows binding while retaining Shift+Arrow whenever the terminal delivers it.
+const PROMPT_UP_INPUTS = new Set(["\u001b[1;2A", "\u001b[1;5A"]);
+const PROMPT_DOWN_INPUTS = new Set(["\u001b[1;2B", "\u001b[1;5B"]);

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

@@ -260,7 +260,7 @@ export class TranscriptDocument {
                 : createPiShellChangelog(diagnostic.message).render(width)));
         rows.push(...diagnostics
             .filter(diagnostic => diagnostic.code !== "engine-startup" && diagnostic.code !== "project-trust"
-            && diagnostic.code !== "release-update"
+            && diagnostic.code !== "release-update" && diagnostic.code !== "release-update-installed"
             && diagnostic.code !== "package-updates" && diagnostic.code !== "changelog-collapsed"
             && diagnostic.code !== "changelog-expanded")
             .slice(-3)

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

@@ -20,17 +20,11 @@ export interface OwnedUiCompositionOptions {
     readonly sessionPath?: string;
     readonly sessionSelection?: SessionSelection;
     readonly sessionForkPrompt?: PiSessionForkPrompt;
-    /**
-     * A1 profile whose settings this session reads and writes. Omitted keeps the
-     * session settings-free, which is what the pinned comparison paths use.
-     */
+    /** A1 settings profile; comparison paths omit it. */
     readonly profileId?: string;
     /** Hide resident-only tab controls for the explicit direct single-agent launch. */
     readonly hideTabSettings?: boolean;
-    /**
-     * Whether A1's product-specific surfaces are reachable. Comparison profiles
-     * use the same composition with those surfaces withheld.
-     */
+    /** `off` withholds A1-specific surfaces from comparison profiles. */
     readonly ownedSurfaces?: "on" | "off";
     readonly projectTrustPrompt?: PiProjectTrustPreflightPrompt;
     /** Explicit local diagnostic destination; ignored by comparison/settings-free compositions. */
@@ -39,18 +33,16 @@ export interface OwnedUiCompositionOptions {
     readonly clipboardDiagnosticsPath?: string;
     /** Deterministic release-note seams for composition tests. */
     readonly packageVersion?: string;
+    readonly notificationVersion?: string | undefined;
     readonly releaseNotes?: ReleaseNoteCatalog;
     /** Startup release-availability seam; defaults to the throttled registry check. */
     readonly checkForNewerRelease?: (options: StartupReleaseCheckOptions) => Promise<AvailableRelease | null>;
-    /** Exact native process inspection injected by the shipped entry; absent SDK seams do not publish claims. */
     readonly inspectProcess?: (pid: number) => Promise<NativeProcessIdentity | null>;
-    /** Private credentials were consumed by the entry before composition or extensions loaded. */
     readonly tab?: {
         readonly bridge: TabBridgeClient;
         readonly dataDir: string;
         readonly incarnation: number;
     };
-    /** One prompt-adjacent notice explaining why a resident launch fell back. */
     readonly residentFallbackNotice?: string;
 }
 export interface OwnedUiComposition {