@timurproko/a1 0.1.8-dev.136 → 0.1.8-dev.139

package/dist/integrations/pi/owned-ui/session-shell.js

@@ -15,12 +15,16 @@ export class OwnedUiSessionShell {
     #stopped;
     #resolveStopped;
     #dialogId;
+    #dialogSource;
     #routeHost;
     #dialogHandle;
     #sequence = 0;
     #started = false;
     #disposed = false;
     #pointerReporting = false;
+    #customViewport;
+    #removeViewportPreInput;
+    #unsubscribeSettings;
     #compactionQueue = [];
     #lastClearTime = 0;
     #activeLoginDialog;
@@ -30,6 +34,7 @@ export class OwnedUiSessionShell {
         this.#sessionGeneration = this.backend.sessionGeneration;
         this.#cwd = options.cwd;
         this.#routeHost = options.routeHost ?? null;
+        this.#customViewport = options.sessionLayout === "custom-viewport";
         this.#stopped = new Promise(resolve => {
             this.#resolveStopped = resolve;
         });
@@ -58,13 +63,50 @@ export class OwnedUiSessionShell {
         }, this.backend.agentDir, {
             getMessageRenderer: customType => this.backend.pinnedMessageRenderer(customType),
             getToolDefinition: toolName => this.backend.pinnedToolDefinition(toolName),
-        });
-        const tuiMode = this.backend.disposed ? "regular" : this.backend.pinnedSettingsSnapshot().tuiMode;
-        const runtimeOptions = options.terminal === undefined
-            ? { root: this.root, mode: tuiMode, layoutRoot: this.root.layoutRoot(), hardwareCursor: this.backend.view().terminal.hardwareCursor }
-            : { root: this.root, mode: tuiMode, layoutRoot: this.root.layoutRoot(), terminal: options.terminal, hardwareCursor: this.backend.view().terminal.hardwareCursor };
+        }, options.sessionLayout);
+        // Bare A1 owns a bounded viewport and therefore always runs on the alternate
+        // fullscreen surface. The pinned comparison profiles still honor Pi's mode.
+        const tuiMode = this.#customViewport
+            ? "fullscreen"
+            : this.backend.disposed ? "regular" : this.backend.pinnedSettingsSnapshot().tuiMode;
+        const runtimeOptions = {
+            root: this.root,
+            mode: tuiMode,
+            ...(this.#customViewport ? {} : { layoutRoot: this.root.layoutRoot() }),
+            ...(options.terminal === undefined ? {} : { terminal: options.terminal }),
+            hardwareCursor: this.backend.view().terminal.hardwareCursor,
+        };
         runtime = new PiTuiRuntimeAdapter(runtimeOptions);
         this.runtime = runtime;
+        this.#removeViewportPreInput = this.#customViewport
+            ? this.runtime.addPreInputListener(data => {
+                // An overlay or editor-replacement screen owns its entire pointer
+                // surface. Letting the transcript pre-router inspect those reports
+                // steals settings value menus and numeric +/- controls before the
+                // settings app can receive them.
+                if (this.runtime.hasOverlay() || !this.root.usesDefaultInputSurface())
+                    return undefined;
+                const routed = this.root.handleViewportPreInput(data, true);
+                if (routed.copyText !== undefined) {
+                    this.runtime.writeControl(`\u001b]52;c;${Buffer.from(routed.copyText, "utf8").toString("base64")}\u0007`);
+                }
+                if (!routed.consumed)
+                    return routed.data === data ? undefined : { data: routed.data };
+                return routed.data.length === 0 ? { consume: true } : { data: routed.data };
+            })
+            : () => { };
+        const applyViewportSettings = () => {
+            const snapshot = options.viewportSettings?.snapshot();
+            this.root.setViewportConfig(snapshot ?? {
+                scrollbarAppearance: "hover",
+                scrollbarStyle: "thin",
+                scrollbarSpeed: "normal",
+            });
+        };
+        applyViewportSettings();
+        this.#unsubscribeSettings = this.#customViewport && options.viewportSettings
+            ? options.viewportSettings.onChange(settings => this.root.setViewportConfig(settings))
+            : () => { };
         this.#extensionBridge = createPiExtensionUiBridge({
             runtime: {
                 getColumns: () => this.runtime.viewport().columns,
@@ -102,9 +144,14 @@ export class OwnedUiSessionShell {
             // A streamed chunk names one block, and touching only that block is what keeps the
             // cost of a chunk the same in a long session as in a new one. Everything else
             // resynchronizes the view, which is cheap next to re-reading the transcript.
+            if (event.type === "agent-run-started")
+                this.root.resumeViewportFollowing();
+            if (event.type === "assistant-message-completed")
+                this.root.noteCompletedAssistantMessage();
+            const semanticOnly = event.type === "agent-run-started" || event.type === "assistant-message-completed";
             const view = event.type === "transcript-block" && this.#sessionGeneration === this.backend.sessionGeneration
                 ? this.#syncBlock(event.block)
-                : this.#syncView();
+                : semanticOnly ? this.view() : this.#syncView();
             if (view.lifecycle === "ready" && this.#compactionQueue.length > 0)
                 void this.#flushCompactionQueue();
             if (event.type === "session-lifecycle" && event.lifecycle === "stopped")
@@ -121,6 +168,8 @@ export class OwnedUiSessionShell {
             return;
         this.#started = true;
         this.runtime.start();
+        if (this.#customViewport)
+            this.#setPointerReporting(true);
         void this.backend.bindExtensionUi(this.#extensionBridge.context, () => { void this.shutdown(); });
         this.#syncView();
     }
@@ -172,6 +221,7 @@ export class OwnedUiSessionShell {
         }
         const type = this.view().lifecycle === "busy" ? "steer" : "prompt";
         this.root.editor.addToHistory(input);
+        this.root.resumeViewportFollowing();
         return this.#execute({
             type,
             correlationId: this.#correlation(type),
@@ -251,6 +301,7 @@ export class OwnedUiSessionShell {
             return rejected("nothing to queue");
         this.root.editor.addToHistory(text);
         this.root.editor.setText("");
+        this.root.resumeViewportFollowing();
         if (this.view().status.workingMessage?.startsWith("Compacting") === true) {
             this.#compactionQueue.push({ text, type: "follow-up" });
             return { outcome: "completed", diagnostic: null };
@@ -272,6 +323,8 @@ export class OwnedUiSessionShell {
     }
     showSelector(title, options, onSelect, onCancel) {
         this.#dialogHandle?.hide();
+        this.#dialogSource = "local";
+        this.#dialogId = undefined;
         const component = createPiShellSelector({
             title,
             options,
@@ -279,10 +332,12 @@ export class OwnedUiSessionShell {
                 onSelect(id);
                 this.#dialogHandle?.hide();
                 this.#dialogHandle = undefined;
+                this.#dialogSource = undefined;
             },
             onCancel: () => {
                 this.#dialogHandle?.hide();
                 this.#dialogHandle = undefined;
+                this.#dialogSource = undefined;
                 onCancel?.();
             },
         });
@@ -486,6 +541,10 @@ export class OwnedUiSessionShell {
                     return;
                 }
                 if (callback === "onTuiModeChange") {
+                    // The custom bare-A1 surface is permanently fullscreen; this callback
+                    // remains available only to pinned comparison profiles.
+                    if (this.#customViewport)
+                        return;
                     if (value !== "regular" && value !== "fullscreen")
                         return;
                     if (!this.runtime.switchMode(value)) {
@@ -493,6 +552,10 @@ export class OwnedUiSessionShell {
                         this.runtime.requestRender();
                         return;
                     }
+                    if (this.#customViewport) {
+                        this.#pointerReporting = false;
+                        this.#setPointerReporting(true);
+                    }
                 }
                 const result = this.backend.applyPinnedSettingValue(callback, value);
                 if (result.outcome === "failed")
@@ -704,19 +767,23 @@ export class OwnedUiSessionShell {
      * button instead of scrolling and selecting itself, so leaving it on outlives the
      * screen that wanted it and takes the terminal's own scrolling and selection with it.
      */
-    #setPointerReporting(enabled) {
-        if (this.#pointerReporting === enabled)
+    #setPointerReporting(enabled, forceOff = false) {
+        const effective = forceOff ? false : this.#customViewport || enabled;
+        if (this.#pointerReporting === effective)
             return;
-        this.#pointerReporting = enabled;
+        this.#pointerReporting = effective;
         if (!this.runtime.active)
             return;
-        this.runtime.writeControl(enabled ? MOUSE_TRACKING_ON : MOUSE_TRACKING_OFF);
+        this.runtime.writeControl(effective ? MOUSE_TRACKING_ON : MOUSE_TRACKING_OFF);
     }
     async dispose() {
         if (this.#disposed)
             return;
         this.#disposed = true;
-        this.#setPointerReporting(false);
+        this.root.clearViewportPointerState();
+        this.#setPointerReporting(false, true);
+        this.#removeViewportPreInput();
+        this.#unsubscribeSettings();
         this.#unsubscribe();
         this.#dialogHandle?.hide();
         await this.backend.unbindExtensionUi();
@@ -741,7 +808,12 @@ export class OwnedUiSessionShell {
             this.#sessionGeneration = this.backend.sessionGeneration;
             this.#activeLoginDialog = undefined;
             this.#extensionBridge.reset();
-            // A replaced session takes its screens with it, pointer reporting included.
+            // A replaced session takes its transient viewport and owned-route state with it.
+            this.root.resetViewport();
+            this.#dialogHandle?.hide();
+            this.#dialogHandle = undefined;
+            this.#dialogId = undefined;
+            this.#dialogSource = undefined;
             this.#setPointerReporting(false);
             this.root.setInputSurface(null);
             this.root.resetExtensionUi();
@@ -761,6 +833,7 @@ export class OwnedUiSessionShell {
         if (!this.runtime.active)
             return { outcome: "failed", diagnostic: "runtime is not active" };
         this.#dialogHandle?.hide();
+        this.#dialogSource = "route";
         // Any-event reporting: hover and drag are what the screen is driven by, and
         // it also stops the terminal treating a drag as a text selection.
         this.#setPointerReporting(true);
@@ -784,13 +857,32 @@ export class OwnedUiSessionShell {
             // stray interrupt while it is up.
             return { consume: true };
         });
+        let removeSurfacePreInput = () => { };
         const closeSurface = () => {
+            removeSurfacePreInput();
             removeInterruptWatch();
             this.#setPointerReporting(false);
             this.#dialogHandle?.hide();
             this.#dialogHandle = undefined;
             this.#dialogId = undefined;
+            this.#dialogSource = undefined;
         };
+        // Fullscreen Pi owns a fallback text-selection layer before focused overlay
+        // components see pointer input. Route every mouse report to the owned screen
+        // at the pre-input boundary so dropdowns, value hover, and numeric +/- work,
+        // and consume even unhandled reports so settings content is never selected.
+        removeSurfacePreInput = this.runtime.addPreInputListener(data => {
+            const { events, rest } = parseMouseInput(data);
+            if (events.length === 0)
+                return undefined;
+            for (const event of events)
+                surface.handleMouse(event);
+            if (surface.isClosed())
+                closeSurface();
+            else
+                this.runtime.requestRender();
+            return rest.length === 0 ? { consume: true } : { data: rest };
+        });
         const rows = () => Math.max(1, this.runtime.viewport().rows);
         const component = {
             render: (width) => [...surface.render(Math.max(1, width), rows())],
@@ -821,22 +913,32 @@ export class OwnedUiSessionShell {
         if (!this.runtime.active)
             return;
         if (dialog === null) {
+            // Locally owned routes (notably /settings) are independent of backend
+            // lifecycle/status events and remain open while an agent is working.
+            if (this.#dialogSource !== "backend")
+                return;
             this.#dialogHandle?.hide();
             this.#dialogHandle = undefined;
             this.#dialogId = undefined;
+            this.#dialogSource = undefined;
             return;
         }
-        if (this.#dialogId === dialog.id)
+        if (this.#dialogSource === "backend" && this.#dialogId === dialog.id)
             return;
         this.#dialogHandle?.hide();
+        this.#dialogSource = "backend";
         const component = createPiShellDialog(dialog, {
             onSelect: () => {
                 this.#dialogHandle?.hide();
                 this.#dialogHandle = undefined;
+                this.#dialogId = undefined;
+                this.#dialogSource = undefined;
             },
             onCancel: () => {
                 this.#dialogHandle?.hide();
                 this.#dialogHandle = undefined;
+                this.#dialogId = undefined;
+                this.#dialogSource = undefined;
             },
         });
         this.#dialogHandle = this.runtime.showOverlay(component, { width: "70%", maxHeight: "80%", anchor: "center" });
@@ -853,6 +955,7 @@ export class OwnedUiSessionShell {
             return this.runWorkflow({ command: name, argument });
         // Unknown slash input, prompt templates, skills, and extension commands remain Pi prompt input.
         this.root.editor.addToHistory(text);
+        this.root.resumeViewportFollowing();
         return this.#execute({
             type: this.view().lifecycle === "busy" ? "steer" : "prompt",
             correlationId: this.#correlation("prompt-command"),

package/dist/integrations/pi/tui-runtime/adapter.d.ts

@@ -1,4 +1,4 @@
-import type { PiTuiComponentPort, PiTuiInputListener, PiTuiOverlayHandle, PiTuiOverlayOptions, PiTuiRuntimeAdapterOptions, PiTuiRuntimeState, PiTuiScrollState, PiTuiStopOptions, PiTuiViewport } from "./contracts.js";
+import type { PiTuiComponentPort, PiTuiInputListener, PiTuiOverlayHandle, PiTuiOverlayOptions, PiTuiPreInputListener, PiTuiRuntimeAdapterOptions, PiTuiRuntimeState, PiTuiScrollState, PiTuiStopOptions, PiTuiViewport } from "./contracts.js";
 export type PiTuiRuntimeErrorStage = "construction" | "start" | "input-drain" | "restoration";
 export declare class PiTuiRuntimeError extends Error {
     readonly stage: PiTuiRuntimeErrorStage;
@@ -26,6 +26,7 @@ export declare class PiTuiRuntimeAdapter {
      * the transparent and pinned paths never call it.
      */
     writeControl(data: string): void;
+    addPreInputListener(listener: PiTuiPreInputListener): () => void;
     addInputListener(listener: PiTuiInputListener): () => void;
     switchMode(mode: "regular" | "fullscreen"): boolean;
     setHardwareCursor(enabled: boolean): void;

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

@@ -81,6 +81,7 @@ class OverlayHandleBridge {
 }
 export class PiTuiRuntimeAdapter {
     #terminal;
+    #tuiTerminal;
     #tui;
     #root;
     #layoutRoot;
@@ -92,12 +93,14 @@ export class PiTuiRuntimeAdapter {
     #scrollViews = new Map();
     #overlayDisposers = new Set();
     #inputListeners = new Map();
+    #preInputListeners = new Set();
     #state = "idle";
     #stopPromise;
     #rootDisposed = false;
     constructor(options) {
         this.#root = options.root;
         this.#terminal = options.terminal ?? new ProcessTerminal();
+        this.#tuiTerminal = preInputTerminal(this.#terminal, data => this.#routePreInput(data));
         this.#layoutRoot = options.layoutRoot;
         this.#logDirectory = options.logDirectory;
         this.#rootBridge = new ComponentBridge(options.root);
@@ -239,6 +242,12 @@ export class PiTuiRuntimeAdapter {
         this.#assertRunning("control sequence");
         this.#terminal.write(data);
     }
+    addPreInputListener(listener) {
+        if (this.#preInputListeners.has(listener))
+            throw new TypeError("Pi TUI pre-input listener is already registered");
+        this.#preInputListeners.add(listener);
+        return () => this.#preInputListeners.delete(listener);
+    }
     addInputListener(listener) {
         this.#assertRunning("input listener");
         if (this.#inputListeners.has(listener))
@@ -313,6 +322,7 @@ export class PiTuiRuntimeAdapter {
             return this.#stopPromise;
         if (this.#state === "idle") {
             this.#state = "stopped";
+            this.#preInputListeners.clear();
             this.#disposeRoot();
             return Promise.resolve();
         }
@@ -352,8 +362,21 @@ export class PiTuiRuntimeAdapter {
     }
     #createTui(mode, hardwareCursor) {
         return mode === "fullscreen"
-            ? new TuiAltScreen(this.#terminal, hardwareCursor, this.#logDirectory, this.#tuiOptions)
-            : new TuiMainScreen(this.#terminal, hardwareCursor, this.#logDirectory);
+            ? new TuiAltScreen(this.#tuiTerminal, hardwareCursor, this.#logDirectory, this.#tuiOptions)
+            : new TuiMainScreen(this.#tuiTerminal, hardwareCursor, this.#logDirectory);
+    }
+    #routePreInput(data) {
+        let current = data;
+        for (const listener of this.#preInputListeners) {
+            if (current.length === 0)
+                break;
+            const result = listener(current);
+            if (result?.data !== undefined)
+                current = result.data;
+            else if (result?.consume === true)
+                current = "";
+        }
+        return current;
     }
     #mountTui(tui) {
         tui.addChild(this.#rootBridge);
@@ -458,11 +481,37 @@ export class PiTuiRuntimeAdapter {
         for (const remove of this.#inputListeners.values())
             remove();
         this.#inputListeners.clear();
+        this.#preInputListeners.clear();
         for (const dispose of [...this.#overlayDisposers])
             dispose();
         this.#disposeRoot();
     }
 }
+function preInputTerminal(terminal, route) {
+    return {
+        get columns() { return terminal.columns; },
+        get rows() { return terminal.rows; },
+        get kittyProtocolActive() { return terminal.kittyProtocolActive; },
+        start(onInput, onResize) {
+            terminal.start(data => {
+                const routed = route(data);
+                if (routed.length > 0)
+                    onInput(routed);
+            }, onResize);
+        },
+        stop: () => terminal.stop(),
+        drainInput: (maxMs, idleMs) => terminal.drainInput(maxMs, idleMs),
+        write: data => terminal.write(data),
+        moveBy: lines => terminal.moveBy(lines),
+        hideCursor: () => terminal.hideCursor(),
+        showCursor: () => terminal.showCursor(),
+        clearLine: () => terminal.clearLine(),
+        clearFromCursor: () => terminal.clearFromCursor(),
+        clearScreen: () => terminal.clearScreen(),
+        setTitle: title => terminal.setTitle(title),
+        setProgress: active => terminal.setProgress(active),
+    };
+}
 function toOverlayOptions(options) {
     if (options === undefined)
         return undefined;

package/dist/integrations/pi/tui-runtime/contracts.d.ts

@@ -71,6 +71,8 @@ export interface PiTuiInputListenerResult {
     readonly data?: string;
 }
 export type PiTuiInputListener = (data: string) => PiTuiInputListenerResult | undefined;
+/** Runs at the terminal bridge before Pi TUI receives physical input. */
+export type PiTuiPreInputListener = PiTuiInputListener;
 export interface PiTuiLayoutEntry {
     readonly node: PiTuiLayoutNode;
     readonly basis?: number | "auto";

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

@@ -5,7 +5,7 @@
   "platform": "darwin",
   "architecture": "arm64",
   "capability": "unsupported",
-  "builtAt": "2026-08-26T05:59:16.405Z",
+  "builtAt": "2026-08-27T09:31:38.156Z",
   "artifact": {
     "filename": "process-guardian",
     "sha256": "7524bf568992517f50ed53196c861c5edeba0d7275633bb4735ab45bd5963a28",

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

@@ -5,7 +5,7 @@
   "platform": "linux",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-08-26T05:59:26.040Z",
+  "builtAt": "2026-08-27T09:31:34.074Z",
   "artifact": {
     "filename": "process-guardian",
     "sha256": "29e22fe29de2828982bc67ef418c4adcaab1490281477b7bea592ec6fe621bcd",

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

@@ -5,10 +5,10 @@
   "platform": "win32",
   "architecture": "x64",
   "capability": "supported",
-  "builtAt": "2026-08-26T05:59:44.317Z",
+  "builtAt": "2026-08-27T09:32:08.840Z",
   "artifact": {
     "filename": "process-guardian.exe",
-    "sha256": "f36f8c76d82ce8e3d163c7671868bd0ab8b7bc1e14a190714aaeb304b2116a5b",
+    "sha256": "41b1b470549052c30109bdbd3187693ce4de9236295d729acc3a1204a2687025",
     "size": 172544
   },
   "provenance": {

package/dist/product-identity.d.ts

@@ -1,6 +1,6 @@
-declare const ENVIRONMENT_KEYS: readonly ["certificationTarball", "configDir", "dataDir", "databasePath", "developmentInstanceId", "developmentRoot", "endpoint", "fixture", "fixtureInput", "fixtureToken", "inputAcknowledgement", "internalPackaging", "launchArgumentsJson", "launchProfile", "nativePi", "paneId", "piParityIntentionalMutation", "piPortRoot", "piSourceLedgerPath", "piSourceScanRoot", "probeTrace", "processGuardianPath", "profileHome", "protocolVersion", "releaseDigest", "releaseId", "releaseRoot", "releaseRunnerLabel", "runtimeDir", "structuredFlowLimits", "terminalArgumentsJson", "terminalExecutable", "terminalSessionId"];
+declare const ENVIRONMENT_KEYS: readonly ["certificationTarball", "configDir", "dataDir", "databasePath", "developmentInstanceId", "developmentRoot", "endpoint", "fixture", "fixtureInput", "fixtureToken", "inputAcknowledgement", "internalPackaging", "launchProfile", "nativePi", "paneId", "piParityIntentionalMutation", "piPortRoot", "piSourceLedgerPath", "piSourceScanRoot", "probeTrace", "processGuardianPath", "profileHome", "protocolVersion", "releaseDigest", "releaseId", "releaseRoot", "releaseRunnerLabel", "runtimeDir", "structuredFlowLimits", "terminalArgumentsJson", "terminalExecutable", "terminalSessionId"];
 declare const FILESYSTEM_KEYS: readonly ["slug", "windowsDirectory", "unixDirectory", "temporaryPrefix"];
-declare const STATE_KEYS: readonly ["windowsControlDirectory", "unixControlDirectory", "developmentDirectory", "piAgentProfile", "piVanillaProfile", "piSandboxProfile"];
+declare const STATE_KEYS: readonly ["windowsControlDirectory", "unixControlDirectory", "developmentDirectory", "piAgentProfile", "piVanillaProfile"];
 declare const ENDPOINT_KEYS: readonly ["windowsPipeStem", "unixSocketFilename", "metadataFilename", "supervisorLogFilename", "databaseFilename"];
 declare const MANIFEST_KEYS: readonly ["releaseFilename", "packageFilename"];
 declare const PROTOCOL_KEYS: readonly ["namespace", "controlEnvelope", "supervisorSchema", "nativeHostSchema", "structuredAgentSchema", "controlStoreSchema", "releaseCohortSchema", "updateJournalSchema"];

package/dist/product-identity.js

@@ -12,7 +12,6 @@ const ENVIRONMENT_KEYS = [
     "fixtureToken",
     "inputAcknowledgement",
     "internalPackaging",
-    "launchArgumentsJson",
     "launchProfile",
     "nativePi",
     "paneId",
@@ -35,7 +34,7 @@ const ENVIRONMENT_KEYS = [
     "terminalSessionId",
 ];
 const FILESYSTEM_KEYS = ["slug", "windowsDirectory", "unixDirectory", "temporaryPrefix"];
-const STATE_KEYS = ["windowsControlDirectory", "unixControlDirectory", "developmentDirectory", "piAgentProfile", "piVanillaProfile", "piSandboxProfile"];
+const STATE_KEYS = ["windowsControlDirectory", "unixControlDirectory", "developmentDirectory", "piAgentProfile", "piVanillaProfile"];
 const ENDPOINT_KEYS = ["windowsPipeStem", "unixSocketFilename", "metadataFilename", "supervisorLogFilename", "databaseFilename"];
 const MANIFEST_KEYS = ["releaseFilename", "packageFilename"];
 const PROTOCOL_KEYS = ["namespace", "controlEnvelope", "supervisorSchema", "nativeHostSchema", "structuredAgentSchema", "controlStoreSchema", "releaseCohortSchema", "updateJournalSchema"];
@@ -64,8 +63,8 @@ export function validateProductIdentity(value) {
         throw new TypeError("product display name must be non-empty without surrounding whitespace");
     if (schema !== `${commandName}-product-identity-v1`)
         throw new TypeError("product identity schema must derive from the command name");
-    if (filesystem.slug !== commandName || filesystem.unixDirectory !== filesystem.slug || filesystem.windowsDirectory !== displayName) {
-        throw new TypeError("product filesystem identity must derive from display and command names");
+    if (filesystem.slug !== commandName || filesystem.unixDirectory !== filesystem.slug || filesystem.windowsDirectory !== filesystem.slug) {
+        throw new TypeError("product filesystem identity must derive from the command name");
     }
     if (filesystem.temporaryPrefix !== `${filesystem.slug}-`)
         throw new TypeError("product temporary prefix must derive from the filesystem slug");

package/dist/product-identity.json

@@ -5,7 +5,7 @@
     "packageName": "@timurproko/a1",
     "filesystem": {
         "slug": "a1",
-        "windowsDirectory": "A1",
+        "windowsDirectory": "a1",
         "unixDirectory": "a1",
         "temporaryPrefix": "a1-"
     },
@@ -22,7 +22,6 @@
         "fixtureToken": "A1_FIXTURE_TOKEN",
         "inputAcknowledgement": "A1_INPUT_ACK",
         "internalPackaging": "A1_INTERNAL_PACKAGING",
-        "launchArgumentsJson": "A1_LAUNCH_ARGUMENTS_JSON",
         "launchProfile": "A1_LAUNCH_PROFILE",
         "nativePi": "A1_NATIVE_PI",
         "paneId": "A1_PANE_ID",
@@ -45,12 +44,11 @@
         "terminalSessionId": "A1_TERMINAL_SESSION_ID"
     },
     "state": {
-        "windowsControlDirectory": "A1",
+        "windowsControlDirectory": "a1",
         "unixControlDirectory": "a1",
         "developmentDirectory": "a1-development",
         "piAgentProfile": ".a1/agent",
-        "piVanillaProfile": ".pi/agent",
-        "piSandboxProfile": ".a1/sandbox"
+        "piVanillaProfile": ".pi/agent"
     },
     "endpoint": {
         "windowsPipeStem": "a1",

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

@@ -11,8 +11,11 @@ export * from "./scrollbar.js";
 export * from "./shortcuts.js";
 export * from "./spans.js";
 export * from "./status-line.js";
+export * from "./submitted-prompt.js";
 export * from "./stepper.js";
+export * from "./transcript-viewport.js";
 export * from "./surface.js";
 export * from "./text.js";
+export * from "./text-selection.js";
 export * from "./theme.js";
 export * from "./value-menu.js";

package/dist/ui/components/index.js

@@ -11,8 +11,11 @@ export * from "./scrollbar.js";
 export * from "./shortcuts.js";
 export * from "./spans.js";
 export * from "./status-line.js";
+export * from "./submitted-prompt.js";
 export * from "./stepper.js";
+export * from "./transcript-viewport.js";
 export * from "./surface.js";
 export * from "./text.js";
+export * from "./text-selection.js";
 export * from "./theme.js";
 export * from "./value-menu.js";

package/dist/ui/components/mouse.d.ts

@@ -13,3 +13,13 @@ export interface ParsedMouseInput {
 }
 /** Extracts SGR mouse reports, leaving any keyboard input untouched. */
 export declare function parseMouseInput(data: string): ParsedMouseInput;
+export interface RoutedMouseInput {
+    /** Input left for the TUI after only claimed reports were removed. */
+    readonly data: string;
+    readonly consumed: boolean;
+}
+/**
+ * Routes every SGR report independently, preserving keyboard bytes and mouse
+ * reports the caller does not claim even when they share one physical chunk.
+ */
+export declare function routeMouseInput(data: string, claim: (event: PaneMouseEvent) => boolean): RoutedMouseInput;

package/dist/ui/components/mouse.js

@@ -30,6 +30,29 @@ export function parseMouseInput(data) {
     rest += data.slice(index);
     return { events: Object.freeze(events), rest };
 }
+/**
+ * Routes every SGR report independently, preserving keyboard bytes and mouse
+ * reports the caller does not claim even when they share one physical chunk.
+ */
+export function routeMouseInput(data, claim) {
+    if (!data.includes("\u001b[<"))
+        return { data, consumed: false };
+    let output = "";
+    let index = 0;
+    let consumed = false;
+    SGR_PATTERN.lastIndex = 0;
+    for (let match = SGR_PATTERN.exec(data); match !== null; match = SGR_PATTERN.exec(data)) {
+        output += data.slice(index, match.index);
+        index = match.index + match[0].length;
+        const event = toEvent(Number.parseInt(match[1] ?? "", 10), Number.parseInt(match[2] ?? "", 10), Number.parseInt(match[3] ?? "", 10), match[4] === "m");
+        if (event !== null && claim(event))
+            consumed = true;
+        else
+            output += match[0];
+    }
+    output += data.slice(index);
+    return { data: output, consumed };
+}
 function toEvent(code, column, row, released) {
     if ((code & 64) !== 0) {
         const kind = (code & 1) === 0 ? "wheel-up" : "wheel-down";

package/dist/ui/components/prompt-row.d.ts

@@ -0,0 +1,14 @@
+export interface TimestampedPromptRowsInput {
+    readonly width: number;
+    readonly sourceTimestamp: number | Date;
+    readonly render: (contentWidth: number) => readonly string[];
+    /** Styles the reserved suffix while keeping policy independent of a vendor theme. */
+    readonly decorateSuffix?: (text: string, firstRow: boolean) => string;
+    readonly minimumWidth?: number;
+}
+export declare function formatPromptTimestamp(source: number | Date): string | null;
+/**
+ * Reserves timestamp columns before wrapping, so the clock never overwrites
+ * prompt content. At narrow widths the same renderer is used without a clock.
+ */
+export declare function composeTimestampedPromptRows(input: TimestampedPromptRowsInput): readonly string[];

package/dist/ui/components/prompt-row.js

@@ -0,0 +1,20 @@
+import { overlaySpan } from "./spans.js";
+export function formatPromptTimestamp(source) {
+    const date = source instanceof Date ? source : new Date(source);
+    if (Number.isNaN(date.getTime()))
+        return null;
+    return `${String(date.getHours()).padStart(2, "0")}:${String(date.getMinutes()).padStart(2, "0")}`;
+}
+/**
+ * Reserves timestamp columns before wrapping, so the clock never overwrites
+ * prompt content. At narrow widths the same renderer is used without a clock.
+ */
+export function composeTimestampedPromptRows(input) {
+    const timestamp = formatPromptTimestamp(input.sourceTimestamp);
+    if (timestamp === null || input.width < (input.minimumWidth ?? 20))
+        return input.render(input.width);
+    const suffixWidth = timestamp.length + 2;
+    const contentWidth = Math.max(1, input.width - suffixWidth);
+    const decorate = input.decorateSuffix ?? ((text) => text);
+    return input.render(contentWidth).map((row, index) => overlaySpan(row, contentWidth, input.width, decorate(index === 0 ? `  ${timestamp}` : " ".repeat(suffixWidth), index === 0)));
+}