@timurproko/a1 0.2.6-dev.736 → 0.2.7-dev.746

package/dist/foundation/resident-tabs/settings.d.ts

@@ -0,0 +1,2 @@
+/** Read only the routing flag before any UI or extension module is loaded. */
+export declare function readResidentTabsSetting(configDir: string, profileId?: string): Promise<boolean>;

package/dist/foundation/resident-tabs/settings.js

@@ -0,0 +1,17 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { parseOwnedUiSettingsDocument, resolveResidentTabsSetting } from "../../ui/settings/index.js";
+const MAX_SETTINGS_BYTES = 256 * 1024;
+/** Read only the routing flag before any UI or extension module is loaded. */
+export async function readResidentTabsSetting(configDir, profileId = "a1") {
+    const file = resolve(configDir, "settings", `${profileId}.json`);
+    try {
+        const raw = await readFile(file, "utf8");
+        if (Buffer.byteLength(raw, "utf8") > MAX_SETTINGS_BYTES)
+            return false;
+        return resolveResidentTabsSetting(parseOwnedUiSettingsDocument(raw));
+    }
+    catch {
+        return false;
+    }
+}

package/dist/foundation/terminal-cleanup/index.d.ts

@@ -1,3 +1,3 @@
-export { EMERGENCY_TERMINAL_RESET, boundedCleanup, restoreAfterOwnedExit, restoreProcessTerminal } from "./terminal-reset.js";
+export { CLEAR_EXIT_INTERVAL_MS, EMERGENCY_TERMINAL_RESET, boundedCleanup, restoreAfterOwnedExit, restoreProcessTerminal } from "./terminal-reset.js";
 export { installFatalExit, writeFatalDiagnostic } from "./fatal-exit.js";
 export type { FatalExitOptions } from "./fatal-exit.js";

package/dist/foundation/terminal-cleanup/index.js

@@ -1,2 +1,2 @@
-export { EMERGENCY_TERMINAL_RESET, boundedCleanup, restoreAfterOwnedExit, restoreProcessTerminal } from "./terminal-reset.js";
+export { CLEAR_EXIT_INTERVAL_MS, EMERGENCY_TERMINAL_RESET, boundedCleanup, restoreAfterOwnedExit, restoreProcessTerminal } from "./terminal-reset.js";
 export { installFatalExit, writeFatalDiagnostic } from "./fatal-exit.js";

package/dist/foundation/terminal-cleanup/terminal-reset.d.ts

@@ -1,3 +1,4 @@
+export declare const CLEAR_EXIT_INTERVAL_MS = 500;
 export declare const EMERGENCY_TERMINAL_RESET: string;
 export declare function restoreProcessTerminal(): void;
 export declare function restoreAfterOwnedExit(ownsTerminal: boolean, code: number | null, signal: string | null, restore?: () => void): number;

package/dist/foundation/terminal-cleanup/terminal-reset.js

@@ -1,4 +1,5 @@
 import { writeSync } from "node:fs";
+export const CLEAR_EXIT_INTERVAL_MS = 500;
 // Protocol: reset modes on both screens; setting keyboard flags to zero is idempotent,
 // unlike repeatedly popping a keyboard-protocol stack owned by a parent application.
 // Resetting parent-screen margins homes the cursor, so preserve its restored position.

package/dist/integrations/pi/components/owned-editor-ux.d.ts

@@ -44,7 +44,7 @@ export declare class OwnedEditorUxInterception {
     pasteClipboard(): boolean;
 }
 export interface PromptSelectionUxOptions {
-    readonly copyText: (text: string) => void;
+    readonly copyText: (text: string, cut: boolean) => void;
     readonly readClipboardContent: () => Promise<PiShellClipboardContent | null>;
     readonly beginClipboardPaste?: () => PiShellPasteReservation;
     readonly beginTextPaste?: (text: string) => PiShellPasteReservation;

package/dist/integrations/pi/components/owned-editor-ux.js

@@ -88,12 +88,12 @@ class PromptSelectionInterceptor {
             return;
         }
         if (this.keybindings.matches(data, "tui.input.copy") && this.hasSelection()) {
-            this.options.copyText(this.options.expandCopiedText(this.#selectedText()));
+            this.options.copyText(this.options.expandCopiedText(this.#selectedText()), false);
             this.#collapseCopiedSelection();
             return;
         }
         if (this.keybindings.matches(data, "owned.editor.cut") && this.hasSelection()) {
-            this.options.copyText(this.options.expandCopiedText(this.#selectedText()));
+            this.options.copyText(this.options.expandCopiedText(this.#selectedText()), true);
             if (!this.#deleteSelection())
                 this.#deleteAtomicFocus();
             return;

package/dist/integrations/pi/components/shell-shared-facade.d.ts

@@ -185,7 +185,7 @@ export interface PiShellEditorOptions {
     readonly onFollowUp?: (() => void) | undefined;
     readonly onDequeue?: (() => void) | undefined;
     readonly onPromptSuggestionAccepted?: (text: string) => void;
-    readonly onCopyText?: (text: string) => void;
+    readonly onCopyText?: (text: string, cut: boolean) => void;
     readonly readClipboardContent?: (signal?: AbortSignal) => Promise<PiShellClipboardContent | null>;
     readonly beginClipboardPaste?: () => PiShellPasteReservation;
     readonly beginTextPaste?: (text: string) => PiShellPasteReservation;

package/dist/native/darwin-arm64/manifest.json

@@ -5,7 +5,7 @@
   "platform": "darwin",
   "architecture": "arm64",
   "capability": "supported",
-  "builtAt": "2026-10-10T09:15:37.918Z",
+  "builtAt": "2026-10-12T06:07:21.173Z",
   "artifact": {
     "filename": "process-guardian",
     "sha256": "51b0b2dc1c9ae577f2586c4217066929278726c2c15308d9144eb6f538e118ff",

package/dist/native/linux-x64/manifest.json

@@ -5,7 +5,7 @@
   "platform": "linux",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-10-10T09:15:10.349Z",
+  "builtAt": "2026-10-12T06:06:54.072Z",
   "artifact": {
     "filename": "process-guardian",
     "sha256": "ef62679e83bc1fad3d38f9f21675d9256f08d20e67fd4791571032115ca1b0e9",

package/dist/native/win32-x64/manifest.json

@@ -5,10 +5,10 @@
   "platform": "win32",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-10-10T09:16:06.991Z",
+  "builtAt": "2026-10-12T06:07:34.911Z",
   "artifact": {
     "filename": "process-guardian.exe",
-    "sha256": "c6e2cb23d012d779478fd1bff750f17687a4c5466bad7621b1b3c200a0557101",
+    "sha256": "3f4e2d9c37a775b8a12f15539af5421e64f11149293ab2adc1bf3b06ce85b66d",
     "size": 288256
   },
   "provenance": {

package/dist/product-identity.d.ts

@@ -1,4 +1,4 @@
-declare const ENVIRONMENT_KEYS: readonly ["clipboardDiagnostics", "configDir", "dataDir", "databasePath", "developmentInstanceId", "developmentRoot", "endpoint", "exitNoticePath", "paneId", "probeTrace", "processGuardianPath", "prFooterPreview", "profileHome", "runtimeDir", "sessionRuntimeId", "skipVersionCheck", "startupTrace", "suggestionDiagnostics", "terminalSessionId"];
+declare const ENVIRONMENT_KEYS: readonly ["clipboardDiagnostics", "configDir", "dataDir", "databasePath", "developmentInstanceId", "developmentRoot", "endpoint", "exitNoticePath", "paneId", "probeTrace", "processGuardianPath", "prFooterPreview", "profileHome", "runtimeDir", "sessionRuntimeId", "skipVersionCheck", "startupTrace", "suggestionDiagnostics", "tabEndpoint", "tabId", "tabToken", "tabsEndpoint", "terminalHostPath", "terminalSessionId"];
 declare const FILESYSTEM_KEYS: readonly ["slug", "windowsDirectory", "unixDirectory", "temporaryPrefix"];
 declare const STATE_KEYS: readonly ["windowsControlDirectory", "unixControlDirectory", "developmentDirectory", "piAgentProfile", "piVanillaProfile", "sessionRepositoryDirectory", "sessionWorktreeClaimDirectory"];
 declare const ENDPOINT_KEYS: readonly ["windowsPipeStem", "unixSocketFilename", "metadataFilename", "supervisorLogFilename", "databaseFilename"];

package/dist/product-identity.js

@@ -1,7 +1,7 @@
 import rawIdentity from "./product-identity.json" with { type: "json" };
 const ENVIRONMENT_KEYS = [
     "clipboardDiagnostics", "configDir", "dataDir", "databasePath", "developmentInstanceId", "developmentRoot", "endpoint", "exitNoticePath",
-    "paneId", "probeTrace", "processGuardianPath", "prFooterPreview", "profileHome", "runtimeDir", "sessionRuntimeId", "skipVersionCheck", "startupTrace", "suggestionDiagnostics", "terminalSessionId",
+    "paneId", "probeTrace", "processGuardianPath", "prFooterPreview", "profileHome", "runtimeDir", "sessionRuntimeId", "skipVersionCheck", "startupTrace", "suggestionDiagnostics", "tabEndpoint", "tabId", "tabToken", "tabsEndpoint", "terminalHostPath", "terminalSessionId",
 ];
 const FILESYSTEM_KEYS = ["slug", "windowsDirectory", "unixDirectory", "temporaryPrefix"];
 const STATE_KEYS = ["windowsControlDirectory", "unixControlDirectory", "developmentDirectory", "piAgentProfile", "piVanillaProfile", "sessionRepositoryDirectory", "sessionWorktreeClaimDirectory"];

package/dist/product-identity.json

@@ -28,6 +28,11 @@
         "skipVersionCheck": "A1_SKIP_VERSION_CHECK",
         "startupTrace": "A1_STARTUP_TRACE",
         "suggestionDiagnostics": "A1_SUGGESTION_DIAGNOSTICS",
+        "tabEndpoint": "A1_TAB_ENDPOINT",
+        "tabId": "A1_TAB_ID",
+        "tabToken": "A1_TAB_TOKEN",
+        "tabsEndpoint": "A1_TABS_ENDPOINT",
+        "terminalHostPath": "A1_TERMINAL_HOST_PATH",
         "terminalSessionId": "A1_TERMINAL_SESSION_ID"
     },
     "state": {

package/dist/ui/components/transcript-viewport.d.ts

@@ -36,6 +36,7 @@ export interface TranscriptViewportFrameInput {
     /** Final transient rows to bottom-align with unused viewport space while content fits. */
     readonly bottomAlignedTailRowCount?: number;
     readonly dockRows: readonly string[];
+    readonly explicitCopyDockRows?: number;
     readonly promptAnchors: readonly TranscriptPromptAnchor[];
     readonly width: number;
     readonly height: number;
@@ -141,6 +142,7 @@ export interface TranscriptViewportFrame {
         readonly cacheEntries: number;
     };
 }
+type SelectionCopyIntent = "automatic" | "explicit";
 /**
  * A1-owned viewport state. It knows only rows and semantic prompt anchors; Pi
  * components and transcript payloads remain outside this neutral boundary.
@@ -170,9 +172,9 @@ export declare class TranscriptViewport {
     extendSelection(column: number, frameRow: number, now?: number, autoScroll?: boolean): boolean;
     releaseSelection(): boolean;
     clearSelection(): boolean;
-    selectedText(): string | null;
+    selectedText(intent?: SelectionCopyIntent): string | null;
     /** Captures visible selected text, not off-screen history. */
-    captureSelectedText(): SelectionCopySnapshot | null;
+    captureSelectedText(intent?: SelectionCopyIntent): SelectionCopySnapshot | null;
     scrollBy(lines: number, now?: number): boolean;
     scrollTo(position: number, now?: number): boolean;
     scrollToEnd(now?: number): boolean;
@@ -184,6 +186,7 @@ export declare class TranscriptViewport {
     clearTransient(): void;
     compose(input: TranscriptViewportFrameInput): TranscriptViewportFrame;
     /** Reuses an established transcript frame when only same-height dock rows changed. */
-    composeDockOnly(dockRows: readonly string[], width: number, height: number): TranscriptViewportFrame | null;
+    composeDockOnly(dockRows: readonly string[], width: number, height: number, explicitCopyDockRows?: number): TranscriptViewportFrame | null;
 }
 export declare function assertTranscriptViewportFrameDescriptor(descriptor: TranscriptViewportFrameDescriptor): void;
+export {};

package/dist/ui/components/transcript-viewport.js

@@ -63,6 +63,7 @@ export class TranscriptViewport {
     #contentWidth = 0;
     #selectionWidth = 0;
     #viewportHeight = 0;
+    #explicitCopyDockRows = 0;
     #firstSelectableRow = 0;
     #selectionRowAnchors = [];
     #frameId = 0;
@@ -178,22 +179,19 @@ export class TranscriptViewport {
         this.#selectionRevision += 1;
         return true;
     }
-    selectedText() {
+    selectedText(intent = "automatic") {
         const selection = this.#visibleSelection();
         if (selection === undefined)
             return null;
-        // Invariant: the blue range spans the complete frame, but automatic and Ctrl+C frame copy
-        // admit only persistent transcript rows. Transient status, suggestions, input, and footer
-        // chrome remain visually selectable without becoming clipboard payload.
         const copiedLines = Array.from({ length: Math.max(0, selection.end.line - selection.start.line + 1) }, (_value, index) => selection.start.line + index).filter(line => {
             const anchor = this.#selectionRowAnchors[line];
-            return anchor?.kind === "document" && anchor.row < this.#selectableDocumentRowCount;
+            return anchor?.kind === "document" && anchor.row < this.#selectableDocumentRowCount
+                || intent === "explicit" && anchor?.kind === "dock" && anchor.fromBottom < this.#explicitCopyDockRows;
         });
         if (copiedLines.length === 0)
             return null;
-        // Rationale: a prompt selected by itself uses semantic prompt text. Once surrounding transcript text
-        // participates, preserve the prompt's visible prefix, alignment, and timestamp in the bulk range.
-        const prompt = this.#promptAnchors.find(candidate => copiedLines.every(line => {
+        const transcriptLines = copiedLines.filter(line => this.#selectionRowAnchors[line]?.kind === "document");
+        const prompt = transcriptLines.length === 0 ? undefined : this.#promptAnchors.find(candidate => transcriptLines.every(line => {
             const anchor = this.#selectionRowAnchors[line];
             return anchor?.kind === "document" && anchor.row >= candidate.firstRow && anchor.row <= candidate.lastRow;
         }));
@@ -208,11 +206,11 @@ export class TranscriptViewport {
         return text.length === 0 ? null : text;
     }
     /** Captures visible selected text, not off-screen history. */
-    captureSelectedText() {
-        if (!this.#copyableSelection)
+    captureSelectedText(intent = "automatic") {
+        if (intent === "automatic" && !this.#copyableSelection)
             return null;
         const started = performance.now();
-        let text = this.selectedText();
+        let text = this.selectedText(intent);
         if (text === null)
             return null;
         text = text.trim();
@@ -315,6 +313,7 @@ export class TranscriptViewport {
         this.#contentWidth = 0;
         this.#selectionWidth = 0;
         this.#viewportHeight = 0;
+        this.#explicitCopyDockRows = 0;
         this.clearTransient();
         this.#frame = null;
     }
@@ -330,6 +329,7 @@ export class TranscriptViewport {
         const theme = input.theme ?? PLAIN_THEME;
         const previousDescriptor = this.#frame?.descriptor ?? null;
         const dock = input.dockRows.length > height ? input.dockRows.slice(-height) : [...input.dockRows];
+        this.#explicitCopyDockRows = clamp(input.explicitCopyDockRows ?? 0, 0, dock.length);
         const viewportHeight = Math.max(0, height - dock.length);
         const bottomAlignedTailRowCount = clamp(input.bottomAlignedTailRowCount ?? 0, 0, input.documentRows.length);
         const transientAlignmentGapRows = bottomAlignedTailRowCount > 0
@@ -414,8 +414,6 @@ export class TranscriptViewport {
             visible[0] = quiet && !this.#stickyHovered ? theme.quietSticky(sticky) : sticky;
             visibleSource[0] = sourceRow;
         }
-        // Invariant: selection uses exact visible source rows within the rendered
-        // content boundary; paint-only guards and the rail gutter stay presentation-only.
         this.#selectionRows = [
             ...visibleSource.map(row => truncateToWidth(row, contentWidth)),
             ...dock,
@@ -426,7 +424,6 @@ export class TranscriptViewport {
                 ? viewportSelectionAnchor(documentRow, documentRows[documentRow] ?? "", this.#selectableDocumentRowCount, documentRows.length)
                 : { kind: "screen", row, source: this.#selectionRows[row] ?? "" };
         });
-        // Invariant: a pinned prompt is chrome over its hidden source row, which clips like off-screen rows.
         this.#firstSelectableRow = stickyActive && viewportHeight > 0 ? 1 : 0;
         this.#selectionRowAnchors = [
             ...visibleAnchors,
@@ -609,7 +606,7 @@ export class TranscriptViewport {
         return frame;
     }
     /** Reuses an established transcript frame when only same-height dock rows changed. */
-    composeDockOnly(dockRows, width, height) {
+    composeDockOnly(dockRows, width, height, explicitCopyDockRows = 0) {
         const previous = this.#frame;
         const boundedWidth = Math.max(1, width);
         const boundedHeight = Math.max(0, height);
@@ -645,6 +642,7 @@ export class TranscriptViewport {
         };
         assertTranscriptViewportFrameDescriptor(descriptor);
         this.#selectionRows = [...this.#selectionRows.slice(0, viewportHeight), ...dock].slice(0, boundedHeight);
+        this.#explicitCopyDockRows = clamp(explicitCopyDockRows, 0, dock.length);
         const frame = {
             rows: [...previous.rows.slice(0, viewportHeight), ...dock].slice(0, boundedHeight),
             contentWidth: previous.contentWidth,

package/dist/ui/components/value-menu.d.ts

@@ -1,8 +1,8 @@
 import type { UiTheme } from "./theme.js";
 /**
  * The menu a value opens: anchored to the row it was opened from, marking what
- * is in effect, highlighting nothing until something is picked, and flipping
- * above its anchor only when it would otherwise run off the bottom.
+ * is in effect, highlighting nothing until something is picked, and laid over
+ * its anchor so the value in effect stays where it was read.
  */
 export interface ValueMenuState {
     /** Values offered, as they should read. */
@@ -37,7 +37,10 @@ export interface ValueMenuLayout {
     /** Columns reserved at the right edge, such as a scrollbar rail. */
     readonly reservedRight: number;
 }
-/** Where the menu is placed: below its anchor where there is room, else above. */
+/**
+ * Where the menu is placed: over its anchor, so the value in effect sits on the very
+ * row it was read from, shifted only as far as the body edges require.
+ */
 export declare function valueMenuFrame(state: ValueMenuState, anchor: ValueMenuAnchor, layout: ValueMenuLayout): ValueMenuFrame;
 /** Draws the menu over the rows behind it, leaving them otherwise untouched. */
 export declare function renderValueMenu(lines: readonly string[], state: ValueMenuState, frame: ValueMenuFrame, theme: UiTheme): readonly string[];

package/dist/ui/components/value-menu.js

@@ -1,13 +1,14 @@
 import { overlaySpan } from "./spans.js";
 import { displayWidth, padToWidth } from "./text.js";
-/** Where the menu is placed: below its anchor where there is room, else above. */
+/**
+ * Where the menu is placed: over its anchor, so the value in effect sits on the very
+ * row it was read from, shifted only as far as the body edges require.
+ */
 export function valueMenuFrame(state, anchor, layout) {
     const bodyTop = layout.bodyTop ?? 0;
     const bodyBottom = bodyTop + layout.bodyHeight;
-    const below = anchor.screenRow + 1;
-    const top = below + state.choices.length <= bodyBottom
-        ? below
-        : Math.max(bodyTop, anchor.screenRow - state.choices.length);
+    const currentIndex = Math.max(0, state.current === null ? 0 : state.choices.indexOf(state.current));
+    const top = Math.max(bodyTop, Math.min(anchor.screenRow - currentIndex, bodyBottom - state.choices.length));
     const previewWidth = Math.max(0, ...(state.previews ?? []).map(displayWidth));
     const previewColumns = previewWidth === 0 ? 0 : previewWidth + 1;
     const width = Math.max(...state.choices.map(choice => displayWidth(choice) + previewColumns + 4), 6);

package/dist/ui/settings/declarations.d.ts

@@ -1,4 +1,4 @@
-export declare const OWNED_UI_SETTINGS_VERSION = 13;
+export declare const OWNED_UI_SETTINGS_VERSION = 14;
 export type OwnedUiSettingValue = string | number | boolean;
 export type OwnedUiSettingApplication = "live" | "restart";
 export interface OwnedUiSettingDeclaration {
@@ -164,6 +164,18 @@ export declare const OWNED_SETTING_DECLARATIONS: Readonly<{
         defaultValue: 8;
         allowedValues: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16];
     }>;
+    readonly residentTabs: Readonly<{
+        id: "residentTabs";
+        label: "Resident tabs";
+        section: Readonly<{
+            id: "generic";
+            title: "Generic";
+        }>;
+        description: "Keep bare A1 running when its terminal closes and reattach on the next launch. Resident tabs have no stop command yet; turning this off prevents new resident launches but does not stop an existing tab.";
+        application: "restart";
+        defaultValue: false;
+        allowedValues: readonly [true, false];
+    }>;
 }>;
 export type OwnedSettingId = keyof typeof OWNED_SETTING_DECLARATIONS;
 /** The value type a setting's declaration allows: a literal union for a choice, `number` for a stepped range. */

package/dist/ui/settings/declarations.js

@@ -1,4 +1,4 @@
-export const OWNED_UI_SETTINGS_VERSION = 13;
+export const OWNED_UI_SETTINGS_VERSION = 14;
 const UI_ACCENT_COLOR_CHOICES = Object.freeze([
     "purple", "blue", "cyan", "green", "orange", "pink",
 ]);
@@ -124,6 +124,15 @@ export const OWNED_SETTING_DECLARATIONS = Object.freeze({
         defaultValue: 8,
         allowedValues: Object.freeze([1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16]),
     }),
+    residentTabs: Object.freeze({
+        id: "residentTabs",
+        label: "Resident tabs",
+        section: GENERIC_SECTION,
+        description: "Keep bare A1 running when its terminal closes and reattach on the next launch. Resident tabs have no stop command yet; turning this off prevents new resident launches but does not stop an existing tab.",
+        application: "restart",
+        defaultValue: false,
+        allowedValues: Object.freeze([true, false]),
+    }),
 });
 /** The declarations in declaration order, for resolution, persistence, and the settings screen. */
 export const OWNED_UI_SETTING_DECLARATIONS = Object.freeze(Object.values(OWNED_SETTING_DECLARATIONS));

package/dist/ui/settings/index.d.ts

@@ -2,7 +2,7 @@ export { OWNED_SETTING_DECLARATIONS, OWNED_UI_SETTINGS_VERSION, OWNED_UI_SETTING
 export type { OwnedSettingId, OwnedSettingValueOf, OwnedUiSettingApplication, OwnedUiSettingDeclaration, OwnedUiSettingValue } from "./declarations.js";
 export { OWNED_UI_SETTINGS_MIGRATIONS, assertOwnedUiSettingsMigrations, migrationsFrom } from "./migrations.js";
 export type { OwnedUiSettingsMigration } from "./migrations.js";
-export { documentFrom, parseOwnedUiSettingsDocument, resolveOwnedUiSettings, settingValue } from "./resolution.js";
+export { documentFrom, parseOwnedUiSettingsDocument, resolveOwnedUiSettings, resolveResidentTabsSetting, settingValue } from "./resolution.js";
 export type { OwnedUiResolvedSetting, OwnedUiSettingSource, OwnedUiSettingsDocument, OwnedUiSettingsNotice, OwnedUiSettingsNoticeCode, OwnedUiSettingsResolution, ResolveOwnedUiSettingsInput, } from "./resolution.js";
 export { AGENT_SECTION_ID, buildOwnedUiSettingsSections, findOwnedUiSettingsEntry } from "./sections.js";
 export type { AgentSettingsSnapshot, BuildOwnedUiSettingsSectionsInput, OwnedUiSettingsBackend, OwnedUiSettingsEntry, OwnedUiSettingsSection, } from "./sections.js";

package/dist/ui/settings/index.js

@@ -1,5 +1,5 @@
 export { OWNED_SETTING_DECLARATIONS, OWNED_UI_SETTINGS_VERSION, OWNED_UI_SETTING_DECLARATIONS, assertOwnedUiSettingDeclarations, findOwnedUiSettingDeclaration, isOwnedSettingId, } from "./declarations.js";
 export { OWNED_UI_SETTINGS_MIGRATIONS, assertOwnedUiSettingsMigrations, migrationsFrom } from "./migrations.js";
-export { documentFrom, parseOwnedUiSettingsDocument, resolveOwnedUiSettings, settingValue } from "./resolution.js";
+export { documentFrom, parseOwnedUiSettingsDocument, resolveOwnedUiSettings, resolveResidentTabsSetting, settingValue } from "./resolution.js";
 export { AGENT_SECTION_ID, buildOwnedUiSettingsSections, findOwnedUiSettingsEntry } from "./sections.js";
 export { OwnedSettingsManager } from "./manager.js";

package/dist/ui/settings/migrations.js

@@ -104,6 +104,13 @@ export const OWNED_UI_SETTINGS_MIGRATIONS = Object.freeze([
             return { ...values };
         },
     }),
+    Object.freeze({
+        to: 14,
+        description: "Introduce the opt-in resident tabs preview with a disabled default.",
+        migrate(values) {
+            return { ...values };
+        },
+    }),
 ]);
 export function assertOwnedUiSettingsMigrations(migrations, currentVersion = OWNED_UI_SETTINGS_VERSION) {
     const firstProduced = currentVersion - migrations.length + 1;

package/dist/ui/settings/resolution.d.ts

@@ -42,4 +42,6 @@ export interface ResolveOwnedUiSettingsInput {
  */
 export declare function resolveOwnedUiSettings(input: ResolveOwnedUiSettingsInput): OwnedUiSettingsResolution;
 export declare function settingValue(resolution: OwnedUiSettingsResolution, id: string): OwnedUiSettingValue | null;
+/** Resolve the launch-routing flag without constructing the UI settings manager. */
+export declare function resolveResidentTabsSetting(document: OwnedUiSettingsDocument | null): boolean;
 export declare function documentFrom(resolution: OwnedUiSettingsResolution): OwnedUiSettingsDocument;

package/dist/ui/settings/resolution.js

@@ -1,4 +1,4 @@
-import { OWNED_UI_SETTINGS_VERSION, findOwnedUiSettingDeclaration, } from "./declarations.js";
+import { OWNED_SETTING_DECLARATIONS, OWNED_UI_SETTINGS_VERSION, findOwnedUiSettingDeclaration, } from "./declarations.js";
 import { migrationsFrom } from "./migrations.js";
 export function parseOwnedUiSettingsDocument(raw) {
     let parsed;
@@ -122,6 +122,18 @@ export function resolveOwnedUiSettings(input) {
 export function settingValue(resolution, id) {
     return resolution.settings.find(setting => setting.declaration.id === id)?.value ?? null;
 }
+/** Resolve the launch-routing flag without constructing the UI settings manager. */
+export function resolveResidentTabsSetting(document) {
+    if (document === null || document.version !== OWNED_UI_SETTINGS_VERSION)
+        return false;
+    const resolution = resolveOwnedUiSettings({
+        declarations: [OWNED_SETTING_DECLARATIONS.residentTabs],
+        migrations: [],
+        document,
+        currentVersion: OWNED_UI_SETTINGS_VERSION,
+    });
+    return settingValue(resolution, "residentTabs") === true;
+}
 export function documentFrom(resolution) {
     const values = { ...resolution.preserved };
     for (const setting of resolution.settings) {

package/docs/architecture/boundaries.md

@@ -53,7 +53,7 @@ The engine host removes A1's own obstacles to several Pi sessions in one process
 
 ## Planned multi-agent boundaries
 
-The multi-agent workspace feature, its dependency-free contracts, the structured-agent runtime, and the Node side of the terminal-host protocol were removed from `develop` while the multi-agent plan is on hold; their last state is preserved on the `archive/multi-agent-workspace` branch. A future implementation starts from the current codebase rather than from that copy. The boundary rules below remain the design intent for that work.
+The multi-agent workspace feature, its dependency-free contracts, the structured-agent runtime, and the Node side of the terminal-host protocol were removed from `develop`; their last state is commit `243eb7a7` in `develop` history. That structured-workspace plan was retired on 2026-10-10 in favor of `add-persistent-multi-agent-tabs`, where every tab runs the complete A1 UI under the native terminal host. A future implementation starts from the current codebase rather than from that copy. The boundary rules below remain the design intent for that work.
 
 The workspace feature may depend on workspace contracts and the structured/terminal-host foundations. Those foundations may depend only on dependency-free workspace contracts, never on product features, launch profiles, or each other unless an approved capability adds the dependency. Launch profiles do not import, initialize, launch, or connect to composed terminal-host infrastructure.
 

package/docs/architecture/evidence/terminal-host-spike/manual-one-pane-terminal-host.md

@@ -0,0 +1,70 @@
+# Manual one-pane terminal-host result
+
+## First manual artifact
+
+- Artifact: `native/terminal-host/target/debug/addone-terminal-host.exe`
+- SHA-256: `8d81db199687a9b8f195b4e40cb4b235de3ea00ffeb9cf55f9c64b1b3582cbba`
+- Size: 2,214,912 bytes
+- User-controlled run: one fullscreen `cmd.exe` pane inside Windows Terminal
+
+The user reported that typing commands, cursor movement, colors, Windows Terminal resize, and fast output worked correctly.
+
+The first artifact had one finding: `Ctrl+Shift+Q` did not exit.
+
+## Corrective artifact
+
+- Corrective artifact SHA-256: `1025a0823114477b7ab311ef55098647fc337b98a9194cf389fc124a047360bf`
+- Size: 2,227,712 bytes
+- Correction: accept `Ctrl+Q` or `Ctrl+Shift+Q`, including uppercase key delivery.
+- Correction: resolve Windows command shims through generic PATH/PATHEXT lookup; `pi` resolves to `C:\Users\tprokopiev\AppData\Roaming\npm\pi.cmd`.
+- Automated non-interactive result after correction: build, version/provenance, terminal model, PTY start, process exit, and cleanup passed.
+
+## Follow-up artifact
+
+- Artifact SHA-256: `b083af60eb8c4ca90438e4022c4e6d10b1410dda5554f554a8b814ba2cdee291`
+- Size: 2,238,464 bytes
+- Removed the host-owned quit shortcut so `Ctrl+Q` no longer intercepts input.
+- Added generic calling-shell ancestry detection; this Git Bash environment resolves to `C:\Program Files\Git\usr\bin\bash.exe --login -i`.
+- Disabled mouse capture by default so the outer terminal can provide native selection.
+- Added `Shift+PageUp`/`Shift+PageDown` and `Shift+Up`/`Shift+Down` host scrollback.
+- Non-interactive terminal model and PTY cleanup probes pass.
+
+## Theme-preservation artifact
+
+- Artifact SHA-256: `9989373d1ee28ac42bf7a6b1be02d68b92c23b71f14336db493a93d76df48198`
+- Size: 2,238,464 bytes
+- The frame composer now emits the outer terminal's default foreground/background for unstyled cells instead of forcing black.
+- The automated probe asserts the default-background sequence and passes.
+
+## Palette-preservation artifact
+
+- Artifact SHA-256: `203219f0ee79f3086467dccb5479b5749b09f8bac79623f84682545d374ba2f4`
+- Size: 2,238,976 bytes
+- Palette-indexed child colors are emitted as palette indexes (`38;5;n` / `48;5;n`) instead of being converted through Ghostty's default RGB palette.
+- The automated probe asserts default-background and palette-passthrough sequences and passes.
+
+## Scrollback artifact
+
+- Artifact SHA-256: `6280786d713abe37eb979e309d27b7ed1eb1f1e1e76e485b0bc5f9c357391ca6`
+- Size: 2,246,656 bytes
+- Mouse capture is enabled so wheel events reach the host; wheel and Shift+navigation scroll the retained terminal viewport.
+- Viewport changes mark the frame dirty before composition.
+- The non-interactive probe verifies retained scrollback, viewport movement, and repainted earlier content.
+- Use the outer terminal's modifier-based selection, usually Shift+drag in Windows Terminal, while pointer capture is active.
+
+## Selection and exit artifact
+
+- Artifact SHA-256: `fc6d9d1ecbaae4718b850a42b5e6868758d1f4c8c8e1a7645237115d1f1d883c`
+- Size: 2,266,624 bytes
+- Plain left-drag selects terminal content with one uniform white background and black foreground; release emits an OSC 52 clipboard write.
+- Double-click selects a word; triple-click selects a line.
+- Ctrl+C clears an active host selection before reaching the child; without selection, interrupt keys remain child-owned.
+- Mouse wheel scrolls the retained viewport. Home, End, PageUp, PageDown, and arrow keys remain child-owned; no host keyboard scroll binding is active.
+- PTY output-channel closure exits the host when the child session ends.
+- Non-interactive probes pass for terminal rendering, scrollback, selection, and PTY cleanup.
+
+Manual retest should verify plain drag selection, double/triple click, mouse wheel, and Ctrl+C selection clearing. No terminal was launched or driven by automation on the active workstation.
+
+## User acceptance
+
+The user manually confirmed that the vanilla-Pi terminal-host proof launches and works after the interaction corrections. The accepted one-pane pipeline includes theme/palette preservation, retained scrollback, mouse wheel scrolling, plain drag selection, word/line click selection, selection clearing with Ctrl+C, and child-owned interrupt behavior. Task 5.1 is accepted; the next gate is the 2×2 multi-pane proof.

package/docs/architecture/evidence/terminal-host-spike/manual-two-by-two-basic-terminal-host.md

@@ -0,0 +1,32 @@
+# Manual 2×2 terminal-host basic result
+
+## Exact artifact
+
+- Recorded at: `2026-08-14T16:13:20.217Z`
+- Source commit: `aeb7421ff5cc82bc5da04cfb0d356e8f8041b6cb`
+- Artifact: `native/terminal-host/target/debug/addone-terminal-host.exe`
+- SHA-256: `896e1b5d2e2730dfd8e591fe3bd565a2aa283fb3ec6f64e8345745c6afcf024d`
+- Size: 2,367,488 bytes
+- Invocation: user-controlled `npm run proof:terminal-host`
+- Surface: one existing outer terminal, one fixed tab, four independently PTY-backed Pi sessions
+
+## User-reported result
+
+The user manually confirmed all of the following against the exact artifact:
+
+- all four panes launched Pi;
+- the four-pane presentation worked without observed flicker;
+- pane focus and input routing worked;
+- changing or clicking the focused pane preserved content in every pane after the repaint correction.
+
+The user accepted this basic multi-pane proof result.
+
+## Explicit product disposition
+
+The fixed 2×2 grid and dashed pane outlines are disposable proof scaffolding, not an accepted production layout or UI design. This result proves the native multi-pane pipeline only. It does not approve carrying the fixed geometry, border treatment, or proof interaction model into the product.
+
+Production tabs and panes are expected later to use authoritative arbitrary layouts selected through the AddOne UI. The proof implementation may be removed or replaced after the exact-artifact 2×2 gate is finished; it must not become the default production workspace by inertia.
+
+## Gate scope
+
+This record does not complete the formal tasks 5.3–5.6 acceptance gate. High-rate output, broader terminal modes and interactions, resize/terminal-size measurements, resource observations, abnormal exits, isolated-worker requirements, and the final stop/go decision remain separately required. No automated physical terminal control was performed on the active workstation.