@timurproko/a1 0.2.7-dev.801 → 0.2.7-dev.808

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

@@ -1762,7 +1762,18 @@ export class OwnedUiSessionPresenter {
         this.#dialogId = dialog.id;
     }
     openOwnedRoute(route) {
-        this.#openOwnedRoute(route);
+        if (this.#disposed)
+            return;
+        // Invariant: a route requested before the runtime runs (the resident Settings bridge route arrives
+        // before start()) is retained, latest wins, and presented through the startup-route path once started.
+        if (!this.#terminal.running) {
+            this.#startupRoute = { route };
+            return;
+        }
+        const result = this.#openOwnedRoute(route);
+        if (result.outcome !== "completed" && result.diagnostic !== null) {
+            this.root.appendWorkflowMessage({ kind: "warning", message: result.diagnostic });
+        }
     }
     hotkeysPresentation() {
         const presentation = this.root.hotkeysPresentation();

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

@@ -4,7 +4,7 @@ import { piCanvasBackgroundAnsi } from "../../integrations/pi/components/theme.j
 import { residentFixtureControl } from "../../foundation/resident-tabs/fixture-control.js";
 import { residentProgressObserver } from "../../foundation/resident-tabs/progress-observation.js";
 import { DamageAwareTerminalAdapter, } from "../../integrations/pi/tui-runtime/damage-aware-terminal.js";
-import { PiTuiRuntimeAdapter } from "../../integrations/pi/tui-runtime/adapter.js";
+import { PiTuiRuntimeAdapter, legacyKeyInput } from "../../integrations/pi/tui-runtime/adapter.js";
 import { classifyPiTuiInput } from "../../integrations/pi/tui-runtime/input-presentation-coordinator.js";
 import { pinnedLayoutRoot, } from "./session-shell-root.js";
 /** The terminal a session's shell options call for: its layout, TUI mode, cursor, and presentation seams. */
@@ -348,7 +348,8 @@ export class OwnedUiTerminalHost {
                 callbacks.closed(rendered);
         };
         removeInterruptWatch = runtime.addInputListener(data => {
-            if (!attached() || !data.includes(INTERRUPT))
+            // Compatibility: a kitty-keyboard child reports Ctrl+C as a CSI-u sequence rather than the byte.
+            if (!attached() || !data.includes(INTERRUPT) && legacyKeyInput(data) !== INTERRUPT)
                 return undefined;
             // Protocol: route hosts decide whether one interrupt closes their app. Raw-input forwarding
             // is required because Pi handles Ctrl+C before the fullscreen overlay receives normal input.
@@ -406,8 +407,10 @@ export class OwnedUiTerminalHost {
                 const { events, rest } = parseMouseInput(data);
                 for (const event of events)
                     surface.handleMouse(event);
-                if (rest.length > 0)
-                    surface.handleInput(rest);
+                // Invariant: owned screens see legacy key bytes whether the terminal reports legacy or kitty keys.
+                const key = rest.length > 0 ? legacyKeyInput(rest) : "";
+                if (key.length > 0)
+                    surface.handleInput(key);
                 if (surface.isClosed()) {
                     closeSurface(true);
                     return;

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

@@ -90,3 +90,5 @@ export declare function bindResidentTabBridge(tabBridge: TabBridgeClient, backen
     readonly openRoute?: (route: "settings") => void;
 }): Promise<() => void>;
 export declare function correlateResidentTabSubmission(recovery: Pick<ResidentTabRecovery, "correlated" | "settled">, backend: Pick<ComposedSessionBackend, "identity" | "session">, submissionId: string, entryId: string): Promise<void>;
+/** Rereads the shared settings document whenever its stat changes; returns the stop. */
+export declare function watchSharedSettings(settings: Pick<OwnedSettingsManager, "file" | "refresh">): () => void;

package/dist/composition/owned-ui.js

@@ -1,3 +1,4 @@
+import { unwatchFile, watchFile } from "node:fs";
 import { readFile } from "node:fs/promises";
 import { SuggestionDiagnosticCapture } from "../features/prompt-suggestions/diagnostics.js";
 import { PRODUCT_IDENTITY } from "../product-identity.js";
@@ -188,13 +189,19 @@ export async function composeOwnedUi(options = {}) {
         : await import("../features/owned-ui/release-note-state.js").then(module => module.claimReleaseNote({
             configDir: productPaths.configDir, profileId: options.profileId, version: currentReleaseNote.version,
         }));
-    const unsubscribeAccent = settings === null || !ownedSurfaces
+    const unsubscribeAccentChange = settings === null || !ownedSurfaces
         ? () => { }
         : settings.onChange(current => {
             const accent = current.value("accentColor");
             host.setAccentColor(accent);
             tabBridge?.accent(accent);
         });
+    // Rationale: every resident tab is its own process over one shared settings document, so a
+    // change saved in any tab reaches the others only by rereading that document.
+    const unwatchSharedSettings = settings === null || !ownedSurfaces || tabBridge === null
+        ? () => { }
+        : watchSharedSettings(settings);
+    const unsubscribeAccent = () => { unwatchSharedSettings(); unsubscribeAccentChange(); };
     // Rationale: Routes open only after shell construction.
     const references = {
         changelog: async (input) => {
@@ -210,7 +217,9 @@ export async function composeOwnedUi(options = {}) {
         },
         session: () => import("./session-info-reference.js").then(m => m.loadSessionInfoReference(backend)),
     };
-    const routeHost = settings === null || !ownedSurfaces ? null : createOwnedRouteHost(settings, references);
+    const routeHost = settings === null || !ownedSurfaces ? null : createOwnedRouteHost(settings, references, {
+        settingsPinned: tabBridge?.tabId.startsWith("settings-") === true,
+    });
     const viewportSettings = settings === null || !ownedSurfaces ? null : {
         snapshot: () => viewportSettingsSnapshot(settings),
         onChange: listener => settings.onChange(() => listener(viewportSettingsSnapshot(settings))),
@@ -436,15 +445,27 @@ export async function bindResidentTabBridge(tabBridge, backend, recovery = null,
     tabBridge.status("starting");
     const currentSessionFile = () => currentBackendSessionFile(backend);
     let pendingAutoName = null;
+    // Invariant: while a generated name is being applied, the session name it produces is automatic
+    // even if the session normalizes it; reporting it as `user` would block the strip's title
+    // animation and every later automatic rename.
+    let applyingAutoName = false;
     const isDefaultName = (name) => name == null || /^agent(?: \d+)?$/i.test(name);
     const currentSessionName = () => backend.session.view().status.footer?.sessionName ?? null;
     const announceSession = () => {
         const name = currentSessionName();
-        const nameSource = name === pendingAutoName ? "auto" : isDefaultName(name) ? "default" : "user";
+        // Invariant: the session may announce the applied name after the workflow resolves; the
+        // first non-default name announced for a pending auto-name is that automatic name.
+        if (applyingAutoName && !isDefaultName(name)) {
+            pendingAutoName = name;
+            applyingAutoName = false;
+        }
+        const automatic = name === pendingAutoName;
+        const nameSource = automatic ? "auto" : isDefaultName(name) ? "default" : "user";
         tabBridge.session(currentSessionFile(), name, nameSource);
     };
     let working = false;
-    let lastTurnFailed = false;
+    // Invariant: the last turn's settlement stays reported until the next turn starts.
+    let lastTurn;
     let autoNameAttempted = false;
     let autoNameArmed = false;
     // Invariant: naming launches once per tab during an agent run, as soon as its prompt is projected,
@@ -461,12 +482,26 @@ export async function bindResidentTabBridge(tabBridge, backend, recovery = null,
             if (!isDefaultName(currentSessionName()))
                 return;
             pendingAutoName = name;
+            applyingAutoName = true;
             const result = await backend.workflows.executeWorkflow({ command: "name", argument: name });
-            if (result.outcome === "completed")
+            if (result.outcome !== "completed") {
+                applyingAutoName = false;
+                if (pendingAutoName === name)
+                    pendingAutoName = null;
+                return;
+            }
+            const current = currentSessionName();
+            if (current !== null && !isDefaultName(current)) {
+                // Invariant: The session already holds the applied name; report it as automatic now.
+                pendingAutoName = current;
+                applyingAutoName = false;
+                tabBridge.session(currentSessionFile(), current, "auto");
+            }
+            else {
+                // Invariant: The session announces later; show the generated name meanwhile, still automatic.
                 tabBridge.session(currentSessionFile(), name, "auto");
-            else if (pendingAutoName === name)
-                pendingAutoName = null;
-        }).catch(() => { pendingAutoName = null; });
+            }
+        }).catch(() => { pendingAutoName = null; applyingAutoName = false; });
     };
     const reportStatus = (lifecycle) => {
         const view = backend.session.view();
@@ -476,7 +511,7 @@ export async function bindResidentTabBridge(tabBridge, backend, recovery = null,
             lifecycle: lifecycle ?? view.lifecycle,
             pendingRequests,
             queuedInput,
-            ...(lastTurnFailed ? { stopReason: "error" } : {}),
+            ...(lastTurn === undefined ? {} : { lastTurn }),
         }), false, pendingRequests, queuedInput);
     };
     announceSession();
@@ -501,7 +536,7 @@ export async function bindResidentTabBridge(tabBridge, backend, recovery = null,
             const wasWorking = working;
             working = event.lifecycle === "busy";
             if (working)
-                lastTurnFailed = false;
+                lastTurn = undefined;
             reportStatus(event.lifecycle);
             if (wasWorking && !working && recovery !== null) {
                 void recovery.settled(currentSessionFile()).catch(() => tabBridge.degraded(true));
@@ -517,7 +552,7 @@ export async function bindResidentTabBridge(tabBridge, backend, recovery = null,
         if (event.type === "agent-run-settled") {
             launchAutoName();
             autoNameArmed = false;
-            lastTurnFailed = !event.successful && !event.aborted;
+            lastTurn = event.aborted ? "aborted" : event.successful ? "done" : "error";
             tabBridge.prompt(event.aborted);
             reportStatus();
         }
@@ -546,6 +581,21 @@ function currentBackendSessionFile(backend) {
     const resume = backend.identity.currentSessionResumeMetadata();
     return resume === null ? null : `${resume.sessionDir}/${resume.sessionId}`;
 }
+const SHARED_SETTINGS_POLL_MS = 250;
+/** Rereads the shared settings document whenever its stat changes; returns the stop. */
+export function watchSharedSettings(settings) {
+    const file = settings.file;
+    const listener = () => {
+        try {
+            settings.refresh();
+        }
+        catch {
+            // Compatibility: an unreadable peer write resolves on the next stat change.
+        }
+    };
+    watchFile(file, { interval: SHARED_SETTINGS_POLL_MS, persistent: false }, listener);
+    return () => unwatchFile(file, listener);
+}
 async function readPackageVersion() {
     const manifest = JSON.parse(await readFile(new URL("../../package.json", import.meta.url), "utf8"));
     const version = manifest?.version;

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

@@ -9,5 +9,10 @@ export interface OwnedReferenceProviders {
     hotkeys(): Promise<ReferenceDocumentProvider>;
     session(): Promise<ReferenceDocumentProvider>;
 }
+/** How the settings route is presented. */
+export interface OwnedRouteHostOptions {
+    /** The resident Settings tab: the screen is the tab, so it offers no screen-level close. */
+    readonly settingsPinned?: boolean;
+}
 /** Declares settings and lazy document routes. */
-export declare function createOwnedRouteHost(settings: OwnedSettingsManager, references?: OwnedReferenceProviders): UiRouteHost;
+export declare function createOwnedRouteHost(settings: OwnedSettingsManager, references?: OwnedReferenceProviders, options?: OwnedRouteHostOptions): UiRouteHost;

package/dist/composition/settings-route-host.js

@@ -3,7 +3,7 @@ import { SETTINGS_APP_ID, SETTINGS_ROUTE } from "../features/owned-ui/settings-r
 import { piTheme, renderPiAccentPreview } from "../integrations/pi/components/upstream/theme/theme.js";
 import { faint } from "../ui/components/text.js";
 /** Declares settings and lazy document routes. */
-export function createOwnedRouteHost(settings, references) {
+export function createOwnedRouteHost(settings, references, options = {}) {
     const routes = new Set([SETTINGS_ROUTE, ...(references === undefined ? [] : [CHANGELOG_ROUTE, HOTKEYS_ROUTE, "session"])]);
     return {
         claims: route => routes.has(route),
@@ -11,7 +11,7 @@ export function createOwnedRouteHost(settings, references) {
             if (!routes.has(route))
                 return null;
             if (route === SETTINGS_ROUTE) {
-                return deferredSurface(SETTINGS_APP_ID, "settings", () => loadSettingsSurface(settings));
+                return deferredSurface(SETTINGS_APP_ID, "settings", () => loadSettingsSurface(settings, options.settingsPinned === true));
             }
             const changelog = route === CHANGELOG_ROUTE;
             const session = route === "session";
@@ -61,9 +61,10 @@ function deferredSurface(id, label, load) {
         onExitRequested: listener => { onExit = listener; },
     };
 }
-async function loadSettingsSurface(settings) {
+async function loadSettingsSurface(settings, pinned) {
     const { SettingsApp } = await import("../features/owned-ui/settings-app.js");
-    return hostApp(SETTINGS_APP_ID, SETTINGS_ROUTE, () => new SettingsApp(settings));
+    // Invariant: a pinned Settings tab closes as a tab; neither Esc nor one Ctrl+C dismisses its screen.
+    return hostApp(SETTINGS_APP_ID, SETTINGS_ROUTE, () => new SettingsApp(settings, { pinned }), !pinned);
 }
 async function loadReferenceSurface(settings, id, route, title, document) {
     // Rationale: the app module and the document load together, so a document that fails
@@ -80,7 +81,7 @@ async function loadReferenceSurface(settings, id, route, title, document) {
         }),
     }));
 }
-async function hostApp(id, route, create) {
+async function hostApp(id, route, create, closeOnInterrupt = true) {
     const [{ UiAppHost }, { UiAppRegistry }] = await Promise.all([
         import("../ui/apps/host.js"),
         import("../ui/apps/registry.js"),
@@ -94,7 +95,7 @@ async function hostApp(id, route, create) {
     let onExit = () => undefined;
     const host = new UiAppHost({
         registry,
-        closeOnInterrupt: true,
+        closeOnInterrupt,
         theme: pinnedTheme(),
         surface: {
             size: () => size,

package/dist/features/owned-ui/settings-app.d.ts

@@ -12,7 +12,10 @@ export declare const SETTINGS_SHORTCUTS: ShortcutRegistry<Action>;
 export declare class SettingsApp implements UiApp {
     #private;
     readonly id = "settings";
-    constructor(session: OwnedSettingsManager);
+    /** `pinned` presents the screen as a resident Settings tab, which offers no screen-level close. */
+    constructor(session: OwnedSettingsManager, options?: {
+        readonly pinned?: boolean;
+    });
     onActivate(host: AppHostServices): void;
     onClose(_host: AppHostServices): void;
     render(rect: PaneRect, host: AppHostServices): readonly string[];

package/dist/features/owned-ui/settings-app.js

@@ -120,8 +120,11 @@ export class SettingsApp {
     #activeUntil = 0;
     #activityTimer;
     #renderedScroll;
-    constructor(session) {
+    #pinned;
+    /** `pinned` presents the screen as a resident Settings tab, which offers no screen-level close. */
+    constructor(session, options = {}) {
         this.#session = session;
+        this.#pinned = options.pinned === true;
     }
     onActivate(host) {
         this.#closed = false;
@@ -251,7 +254,8 @@ export class SettingsApp {
         const selected = indexOfKey(rows, this.#selectedKey);
         switch (action) {
             case "close":
-                host.close();
+                if (!this.#pinned)
+                    host.close();
                 return { consumed: true };
             case "open-filter":
                 this.#scrollBeforeFilter = this.#scroll;
@@ -1016,7 +1020,9 @@ export class SettingsApp {
             return this.#dialogLines(open, width, theme);
         // Rationale: standing guidance is more useful than transient feedback; failures still
         // roll back without displacing the Settings interaction contract.
-        const status = renderShortcutHintsWithClose(SETTINGS_SHORTCUTS.hintEntries(SCOPE), theme, width, width > 0 ? 1 : 0);
+        const entries = SETTINGS_SHORTCUTS.hintEntries(SCOPE).filter(entry => !this.#pinned
+            || entry.key !== DIALOG_CLOSE_SHORTCUT_HINT.key || entry.action !== DIALOG_CLOSE_SHORTCUT_HINT.action);
+        const status = renderShortcutHintsWithClose(entries, theme, width, width > 0 ? 1 : 0);
         const input = this.#filter;
         if (input === null)
             return [status];

package/dist/features/resident-tab/shortcut-declarations.js

@@ -13,7 +13,7 @@ export const RESIDENT_TAB_SHORTCUTS = Object.freeze([
     { id: "tabs.new", defaultKey: "alt+a", scope: "global", description: "New A1 tab" },
     { id: "tabs.close", defaultKey: "alt+w", scope: "global", description: "Close A1 tab" },
     { id: "tabs.rename", defaultKey: "f2", scope: "global", description: "Rename A1 tab" },
-    { id: "tabs.settings", defaultKey: "alt+.", scope: "global", description: "Open Settings tab" },
+    { id: "tabs.settings", defaultKey: "alt+,", scope: "global", description: "Open Settings tab" },
     ...jumps,
     { id: "tabs.next", defaultKey: null, scope: "global", description: "View next A1 tab" },
     { id: "tabs.previous", defaultKey: null, scope: "global", description: "View previous A1 tab" },

package/dist/features/resident-tab/status-deriver.d.ts

@@ -1,9 +1,10 @@
-export type ResidentTabDerivedStatus = "starting" | "working" | "needs-input" | "done-unseen" | "idle" | "failed";
+/** How the tab's last agent turn settled; it persists until the next turn starts. */
+export type ResidentTabTurnSettlement = "done" | "aborted" | "error";
+export type ResidentTabDerivedStatus = "starting" | "working" | "needs-input" | "idle" | "failed" | ResidentTabTurnSettlement;
 export interface ResidentTabFacts {
     readonly lifecycle: string;
     readonly pendingRequests: number;
     readonly queuedInput: number;
-    readonly stopReason?: string;
-    readonly settledUnseen?: boolean;
+    readonly lastTurn?: ResidentTabTurnSettlement;
 }
 export declare function deriveResidentTabStatus(facts: ResidentTabFacts): ResidentTabDerivedStatus;

package/dist/features/resident-tab/status-deriver.js

@@ -1,3 +1,4 @@
+// Invariant: `failed` is reserved for a failed tab lifecycle; a turn that errored reports `error`.
 export function deriveResidentTabStatus(facts) {
     if (facts.lifecycle === "failed")
         return "failed";
@@ -7,9 +8,5 @@ export function deriveResidentTabStatus(facts) {
         return "working";
     if (facts.lifecycle === "starting")
         return "starting";
-    if (facts.stopReason === "error")
-        return "failed";
-    if (facts.settledUnseen === true)
-        return "done-unseen";
-    return "idle";
+    return facts.lastTurn ?? "idle";
 }

package/dist/foundation/release/bootstrap.js

@@ -1,5 +1,5 @@
 import { spawn } from "node:child_process";
-import { CLEAR_EXIT_INTERVAL_MS, restoreAfterOwnedExit } from "../terminal-cleanup/index.js";
+import { RESIDENT_DETACH_INTERVAL_MS, restoreAfterOwnedExit } from "../terminal-cleanup/index.js";
 import { chmod, mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import { connect } from "node:net";
 import { resolve } from "node:path";
@@ -64,7 +64,7 @@ async function runBootstrapAttempt(options, retriesRemaining) {
                 residentRootExecutable: resident.executable.executable,
                 residentRootArguments: JSON.stringify([
                     resident.executable.entry,
-                    "attach", "--endpoint", resident.endpoint, "--cwd", process.cwd(), "--clear-exit-ms", String(CLEAR_EXIT_INTERVAL_MS),
+                    "attach", "--endpoint", resident.endpoint, "--cwd", process.cwd(), "--clear-exit-ms", String(RESIDENT_DETACH_INTERVAL_MS),
                     "--profile", environment[PRODUCT_IDENTITY.environment.profileHome] ?? paths.configDir,
                     "--settings-file", resolve(agentProfileDir, "settings.json"),
                     "--data-dir", paths.dataDir, "--runtime-dir", paths.runtimeDir,

package/dist/foundation/resident-tabs/bridge-client.d.ts

@@ -1,4 +1,4 @@
-export type ResidentTabStatus = "starting" | "working" | "needs-input" | "done-unseen" | "idle" | "unresponsive" | "stalled" | "crashed" | "restarting" | "failed";
+export type ResidentTabStatus = "starting" | "working" | "needs-input" | "done-unseen" | "done" | "aborted" | "error" | "idle" | "unresponsive" | "stalled" | "crashed" | "restarting" | "failed";
 export interface TabBridgeCredentials {
     readonly tabId: string;
     readonly token: string;

package/dist/foundation/resident-tabs/bridge-client.js

@@ -137,7 +137,8 @@ export class TabBridgeClient {
             if (start === -1) {
                 let retained = 0;
                 const maximum = Math.min(prefix.length - 1, pending.length);
-                for (let length = maximum; length > 0; length--) {
+                // Invariant: a lone trailing Esc is a user key and passes at once; only `\x1bP` or more is withheld.
+                for (let length = maximum; length > 1; length--) {
                     if (pending.endsWith(prefix.slice(0, length))) {
                         retained = length;
                         break;

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

@@ -1,3 +1,3 @@
-export { CLEAR_EXIT_INTERVAL_MS, EMERGENCY_TERMINAL_RESET, boundedCleanup, restoreAfterOwnedExit, restoreProcessTerminal } from "./terminal-reset.js";
+export { CLEAR_EXIT_INTERVAL_MS, EMERGENCY_TERMINAL_RESET, RESIDENT_DETACH_INTERVAL_MS, 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 { CLEAR_EXIT_INTERVAL_MS, EMERGENCY_TERMINAL_RESET, boundedCleanup, restoreAfterOwnedExit, restoreProcessTerminal } from "./terminal-reset.js";
+export { CLEAR_EXIT_INTERVAL_MS, EMERGENCY_TERMINAL_RESET, RESIDENT_DETACH_INTERVAL_MS, boundedCleanup, restoreAfterOwnedExit, restoreProcessTerminal } from "./terminal-reset.js";
 export { installFatalExit, writeFatalDiagnostic } from "./fatal-exit.js";

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

@@ -1,4 +1,9 @@
 export declare const CLEAR_EXIT_INTERVAL_MS = 500;
+/**
+ * How long a first `Ctrl+C` keeps the resident attach client's detach chord armed. It matches the
+ * owned dialogs' interrupt chord so an unhurried double press leaves resident tabs from any tab.
+ */
+export declare const RESIDENT_DETACH_INTERVAL_MS = 1500;
 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,5 +1,10 @@
 import { writeSync } from "node:fs";
 export const CLEAR_EXIT_INTERVAL_MS = 500;
+/**
+ * How long a first `Ctrl+C` keeps the resident attach client's detach chord armed. It matches the
+ * owned dialogs' interrupt chord so an unhurried double press leaves resident tabs from any tab.
+ */
+export const RESIDENT_DETACH_INTERVAL_MS = 1_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/tui-runtime/adapter.d.ts

@@ -1,5 +1,11 @@
 import { type ProgramStatus, type WheelScrollLines } from "@earendil-works/pi-tui";
 import type { PiTuiComponentPort, PiTuiInputListener, PiTuiOverlayHandle, PiTuiOverlayOptions, PiTuiPreInputListener, PiTuiRuntimeAdapterOptions, PiTuiRuntimeState, PiTuiScrollState, PiTuiStopOptions, PiTuiViewport } from "./contracts.js";
+/**
+ * Re-encodes one key report decoded by pi-tui in the legacy form, so a kitty-keyboard child
+ * (resident tabs) and a legacy terminal produce the same owned-screen action. Releases decode
+ * to nothing; mouse reports, paste, and unknown sequences pass through unchanged.
+ */
+export declare function legacyKeyInput(data: string): string;
 export type PiTuiRuntimeErrorStage = "construction" | "start" | "input-drain" | "restoration";
 /** Identifies the Pi TUI lifecycle stage that failed while preserving the original cause. */
 export declare class PiTuiRuntimeError extends Error {

package/dist/integrations/pi/tui-runtime/adapter.js

@@ -1,8 +1,35 @@
-import { HStack, ProcessTerminal, ScrollView, TuiAltScreen, TuiMainScreen, VStack, visibleWidth, } from "@earendil-works/pi-tui";
+import { HStack, ProcessTerminal, ScrollView, TuiAltScreen, TuiMainScreen, VStack, decodeKittyPrintable, isKeyRelease, parseKey, visibleWidth, } from "@earendil-works/pi-tui";
 import { MouseReportInput, stripSgrMouseReports } from "./mouse-report-input.js";
 import { GeometryObservedAltScreen, OverlayGeometryTracker } from "./overlay-geometry.js";
 import { boundedCleanup, EMERGENCY_TERMINAL_RESET } from "../../../foundation/terminal-cleanup/terminal-reset.js";
 import { InputPresentationCoordinator, } from "./input-presentation-coordinator.js";
+// Protocol: the legacy bytes owned screens and their key tables compare against.
+const LEGACY_KEY_BYTES = {
+    escape: "\u001b", up: "\u001b[A", down: "\u001b[B", right: "\u001b[C", left: "\u001b[D",
+    "shift+up": "\u001b[1;2A", "shift+down": "\u001b[1;2B", pageUp: "\u001b[5~", pageDown: "\u001b[6~",
+    home: "\u001b[H", end: "\u001b[F", "ctrl+home": "\u001b[1;5H", "ctrl+end": "\u001b[1;5F",
+    enter: "\r", tab: "\t", "shift+tab": "\u001b[Z", backspace: "\u007f", delete: "\u001b[3~",
+    space: " ", "ctrl+c": "\u0003", "ctrl+z": "\u001a",
+};
+/**
+ * Re-encodes one key report decoded by pi-tui in the legacy form, so a kitty-keyboard child
+ * (resident tabs) and a legacy terminal produce the same owned-screen action. Releases decode
+ * to nothing; mouse reports, paste, and unknown sequences pass through unchanged.
+ */
+export function legacyKeyInput(data) {
+    if (data.length <= 1 || !data.startsWith("\u001b"))
+        return data;
+    const key = parseKey(data);
+    if (key === undefined)
+        return data;
+    if (isKeyRelease(data))
+        return "";
+    const legacy = LEGACY_KEY_BYTES[key];
+    if (legacy !== undefined)
+        return legacy;
+    const printable = decodeKittyPrintable(data);
+    return printable !== undefined && printable >= " " && printable !== "\u007f" ? printable : data;
+}
 /** Identifies the Pi TUI lifecycle stage that failed while preserving the original cause. */
 export class PiTuiRuntimeError extends Error {
     stage;

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

@@ -7,7 +7,7 @@
   "platform": "darwin",
   "architecture": "arm64",
   "capability": "supported",
-  "builtAt": "2026-10-19T06:24:29.067Z",
+  "builtAt": "2026-10-19T14:46:40.019Z",
   "artifact": {
     "filename": "process-guardian.node",
     "sha256": "a87eaaffcd986b624c8b044b756446cc1bdaf4334a1775b97820542fe34f9fb7",

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

@@ -9,11 +9,11 @@
   "architecture": "arm64",
   "target": "aarch64-apple-darwin",
   "capability": "supported",
-  "builtAt": "2026-10-19T06:27:25.061Z",
+  "builtAt": "2026-10-19T14:50:21.966Z",
   "artifact": {
     "filename": "terminal-host.node",
-    "sha256": "54b4a6c6f4b8abf76afd0a65053dd9916653dcf7990639c716bdd0d0ee735ad2",
-    "size": 5710496
+    "sha256": "12b73c5b9c2023badcdcbea9f2c3cca018cbb1704c0cb452303f59a551b0c407",
+    "size": 5813520
   },
   "entry": {
     "filename": "dist/foundation/resident-tabs/host-entry.js",

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

@@ -7,7 +7,7 @@
   "platform": "darwin",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-10-19T06:24:37.379Z",
+  "builtAt": "2026-10-19T14:46:46.372Z",
   "artifact": {
     "filename": "process-guardian.node",
     "sha256": "783a65f0de287a1c02cd5429dbe97bc8633f4cc8a7b92e3e961180b9bdcff814",

package/dist/native/darwin-x64/terminal-host.manifest.json

@@ -9,11 +9,11 @@
   "architecture": "x64",
   "target": "x86_64-apple-darwin",
   "capability": "supported",
-  "builtAt": "2026-10-19T06:30:00.884Z",
+  "builtAt": "2026-10-19T14:53:04.323Z",
   "artifact": {
     "filename": "terminal-host.node",
-    "sha256": "c4c070744e7dd382532d11759533d5cc93acd53befd999e993b85ad17e848cd4",
-    "size": 6226880
+    "sha256": "aea613cb66de9d7f87018ee32aba7d30d695a86752301e1dde771bdeb7dad724",
+    "size": 6349264
   },
   "entry": {
     "filename": "dist/foundation/resident-tabs/host-entry.js",

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

@@ -7,7 +7,7 @@
   "platform": "linux",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-10-19T06:24:11.933Z",
+  "builtAt": "2026-10-19T14:46:32.168Z",
   "artifact": {
     "filename": "process-guardian.node",
     "sha256": "118e5954e3864672bd8482ab7edf419cb27dcdf2533720316979b7f5cc5a53a5",

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

@@ -9,11 +9,11 @@
   "architecture": "x64",
   "target": "x86_64-unknown-linux-gnu",
   "capability": "supported",
-  "builtAt": "2026-10-19T06:27:20.231Z",
+  "builtAt": "2026-10-19T14:49:27.044Z",
   "artifact": {
     "filename": "terminal-host.node",
-    "sha256": "1e2d6d37ee740ee716aa67f5d37aaac6c193739eeae14ce19320fc8b34939d16",
-    "size": 6981672
+    "sha256": "890d87b2fccecb4956243c40da97c461e180a40ace6b340d5c9f808ab9f4b586",
+    "size": 7099552
   },
   "entry": {
     "filename": "dist/foundation/resident-tabs/host-entry.js",

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

@@ -7,10 +7,10 @@
   "platform": "win32",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-10-19T06:24:34.859Z",
+  "builtAt": "2026-10-19T14:46:55.773Z",
   "artifact": {
     "filename": "process-guardian.node",
-    "sha256": "24685c41544bb8e90fb5162f9ab9545cb698204530cf131644aaf6ee97159c6e",
+    "sha256": "e8b39eb8c589c028024164c021a08183021574d06b48fbefc34fb3fb55636c62",
     "size": 402432
   },
   "provenance": {

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

@@ -9,11 +9,11 @@
   "architecture": "x64",
   "target": "x86_64-pc-windows-msvc",
   "capability": "supported",
-  "builtAt": "2026-10-19T06:28:49.237Z",
+  "builtAt": "2026-10-19T14:49:14.794Z",
   "artifact": {
     "filename": "terminal-host.node",
-    "sha256": "a4d34ff27229603c8f354607c2bff377506d34ac72f90886ffe6abea37fd2f88",
-    "size": 6212608
+    "sha256": "7661bc29672ef40853a94bcfe367fd6ed5c03b9e6e3e3ac4ac4bbea4c2aad891",
+    "size": 6323712
   },
   "entry": {
     "filename": "dist/foundation/resident-tabs/host-entry.js",

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

@@ -47,6 +47,12 @@ export declare class OwnedSettingsManager {
     /** Reads and resolves the product namespace. Never throws: every failure becomes a notice. */
     read(): OwnedUiSettingsResolution;
     load(): Promise<void>;
+    /**
+     * Adopts values another process stored in the shared document. Notifies only when a
+     * resolved value differs, so a peer's own write echo stays silent. Restart-bound values
+     * keep their session-start effect and surface as pending instead.
+     */
+    refresh(): boolean;
     sections(): readonly OwnedUiSettingsSection[];
     /**
      * The value in effect for a declared setting, typed by its declaration. A restart-bound

package/dist/ui/settings/manager.js

@@ -129,6 +129,28 @@ export class OwnedSettingsManager {
         this.#agentSnapshot = agent === null ? null : await snapshotOf(agent, this.#hiddenAgentSettingIds);
         this.#notify();
     }
+    /**
+     * Adopts values another process stored in the shared document. Notifies only when a
+     * resolved value differs, so a peer's own write echo stays silent. Restart-bound values
+     * keep their session-start effect and surface as pending instead.
+     */
+    refresh() {
+        const next = this.read();
+        if (resolvedValuesKey(next) === resolvedValuesKey(this.#resolution))
+            return false;
+        this.#resolution = next;
+        for (const setting of next.settings) {
+            const id = setting.declaration.id;
+            if (!this.#restartEffective.has(id))
+                continue;
+            if (setting.value === this.#restartEffective.get(id))
+                this.#pending.delete(id);
+            else
+                this.#pending.set(id, setting.value);
+        }
+        this.#notify();
+        return true;
+    }
     sections() {
         const resolution = this.#hiddenOwnedSettingIds.size === 0
             ? this.#resolution
@@ -270,6 +292,9 @@ async function snapshotOf(agent, hidden) {
         return { descriptors: [], writeAdvertised: false, failure: describe(error) };
     }
 }
+function resolvedValuesKey(resolution) {
+    return JSON.stringify(resolution.settings.map(setting => [setting.declaration.id, setting.value]));
+}
 function failed(failure) {
     return {
         status: "failed",

package/docs/architecture/resident-tabs.md

@@ -262,11 +262,12 @@ Tab status is an A1-owned state machine fed by `bridge.status`:
 | `idle` | settled idle | none |
 | `working` | agent or turn start, tool execution, compaction | shared progress frames |
 | `needs-input` | an extension UI, trust, or permission request is pending | yellow `?` (warning) |
-| `done-unseen` | the turn settled while no client viewed the tab | `✓` success |
-| `error` | the last turn's `stopReason` was error | `✗` error |
-| `crashed` / `restarting` / `failed` | holder or child exit | `✗` error plus a banner |
+| `done` | the last turn finished successfully | green `✓` success |
+| `aborted` | the last turn was aborted | red `✗` error |
+| `error` | the last turn ended with an error | red `✗` error |
+| `crashed` / `restarting` / `failed` | holder or child exit, or a failed tab lifecycle (never a failed turn) | `✗` error plus a banner |
 
-- `seen` is tracked server-side, so viewing a tab in any client clears `✓` everywhere.
+- A `done`, `aborted`, or `error` marker stays on the chip, including after any client views the tab, until that tab's next turn starts.
 - A tab with a broken bridge shows only process-level states.
 - Future CLI tabs will derive status from process state, and may use BEL or OSC 9/777 from the program as an attention input.
 - The glyph set is the same in every client. A working spinner uses the resolved A1 accent reported by that specific tab.
@@ -335,7 +336,7 @@ Tab status is an A1-owned state machine fed by `bridge.status`:
   | `Alt+A` | new tab |
   | `Alt+W` | close |
   | `F2` | rename |
-  | `Alt+.` | create or activate the global Settings tab |
+  | `Alt+,` | open the global Settings tab, or close it while it is viewed |
   | `Alt+1`…`Alt+9`, `Alt+0` | jump to a tab |
   | unbound (`tabs.next` / `tabs.previous`) | next / previous, wrapping |
   | unbound (`tabs.moveRight` / `tabs.moveLeft`) | move the tab right / left |
@@ -349,7 +350,7 @@ Tab status is an A1-owned state machine fed by `bridge.status`:
   - right-click opens `Rename`/`Close` (`Close` only for Settings);
   - dragging reorders, with a `│` drop marker, after 250 ms or once the pointer moves;
   - `+` opens a persistent dark v2 menu with `+ Agent`, a separator, and `Settings`; hover and click remain active through the opening release.
-- **Settings.** The strip owns one profile-global `Settings` tab. The grouped launcher and `Alt+.` create or activate it; closing the screen or tab removes it. Resident Agent autocomplete omits `/settings`, and manually entering it does not open a per-Agent screen. `a1 solo` and `a1 pi` retain their existing Settings routes.
+- **Settings.** The strip owns one profile-global `Settings` tab. The grouped launcher creates or activates it; `Alt+,` does the same from another tab and closes it while it is viewed. Esc does not close the Settings tab; closing the tab removes it. Resident Agent autocomplete omits `/settings`, and manually entering it does not open a per-Agent screen. `a1 solo` and `a1 pi` retain their existing Settings routes.
 - **Commands inside A1 tabs:** existing `/name <name>` also renames the tab. Milestone 5 adds no tab-management slash commands: `/new-tab`, `/close`, `/tabs`, `/quit-all`, and `/restart-tab` are not exposed.
 - **Naming:**
   - Default names are `agent` or `agent N`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timurproko/a1",
-  "version": "0.2.7-dev.801",
+  "version": "0.2.7-dev.808",
   "description": "Standalone terminal workspace for supervised native and managed agents",
   "type": "module",
   "privateLaunchContract": "neutral-launch-v1",