@timurproko/a1 0.2.6 → 0.2.7-dev.746

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-10T17:42:20.005Z",
+  "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-10T17:42:10.255Z",
+  "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-10T17:42:54.136Z",
+  "builtAt": "2026-10-12T06:07:34.911Z",
   "artifact": {
     "filename": "process-guardian.exe",
-    "sha256": "bdafa323144718cc73b6e5a970608fd58420ec343f6fa7fac76aeb216edae485",
+    "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/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/internal-naming.md

@@ -31,7 +31,7 @@ The exact externally branded key/member authority is `config/internal-naming-pol
 | `A1_PROCESS_GUARDIAN_PATH` | Explicit executable override in `src/foundation/process-containment/native-guardian-containment.ts`, also configured by CI; exact existing exposure-review entry. |
 | `A1_PROBE_TRACE` | Opt-in diagnostics read by native terminal-host code; exact existing exposure-review entry. |
 | `A1_BUILD_VERBOSE`, `A1_DEV_SHELL` | Developer invocation controls in the build helper and development launcher; exact existing exposure-review entries. |
-| `A1_PANE_ID`, `A1_TERMINAL_SESSION_ID` | Produced by `native/terminal-host/src/workspace.rs` and exported to launched programs; external integration names, unchanged. |
+| `A1_PANE_ID`, `A1_TERMINAL_SESSION_ID` | Reserved compatibility identities retained in the product identity manifest; the resident host does not currently emit them. |
 
 Pending review preserves a possible external interface, not an obsolete private alias. Once a setting is established as private, it cannot keep its branded spelling through that category.