@timurproko/a1 0.2.6 → 0.2.7-dev.1222

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;
@@ -154,6 +181,10 @@ export class PiTuiRuntimeAdapter {
         this.#tuiTerminal = this.#inputCoordinator === undefined
             ? preInputTerminal(decoratedTerminal, data => this.#routePreInput(data), this.#overlayGeometry !== undefined)
             : coordinatedInputTerminal(decoratedTerminal, this.#inputCoordinator, sink => { this.#inputSink = sink; }, this.#overlayGeometry !== undefined);
+        // Invariant: Pi TUI's exit-time restore reaches the undecorated terminal directly. Decorators only shape
+        // presentation, and the frozen gate must not swallow the last-resort mode reset when the process exits.
+        const exitTerminal = this.#terminal;
+        this.#tuiTerminal.restoreOnExit = (before, after) => exitTerminal.restoreOnExit?.(before, after);
         this.#layoutRoot = options.layoutRoot;
         this.#logDirectory = options.logDirectory;
         this.#rootBridge = new ComponentBridge(options.root, options.inputDiagnostics === undefined

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

@@ -34,6 +34,11 @@ export interface PiTuiTerminalPort {
     setProgress(active: boolean): void;
     /** Optional for neutral test/decorator ports; the Pi-facing adapter always supplies it. */
     setProgramStatus?(status: ProgramStatus): void;
+    /**
+     * Optional synchronous last-resort mode restore that Pi TUI invokes from a process `exit` handler when
+     * `stop()` did not run; the runtime adapter binds it to the undecorated terminal, so decorators need not forward it.
+     */
+    restoreOnExit?(before: string, after: string): void;
 }
 export type PiTuiSizeValue = number | `${number}%`;
 export type PiTuiOverlayAnchor = "center" | "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top-center" | "bottom-center" | "left-center" | "right-center";

package/dist/integrations/pi/tui-runtime/damage-aware-terminal.d.ts

@@ -1,5 +1,5 @@
 import type { PiTuiTerminalPort } from "./contracts.js";
-export declare const PINNED_PI_TUI_DAMAGE_GRAMMAR = "@earendil-works/pi-tui@1.1.0:tui-alt-screen-one-write-v1";
+export declare const PINNED_PI_TUI_DAMAGE_GRAMMAR = "@earendil-works/pi-tui@1.4.0:tui-alt-screen-one-write-v1";
 export interface PiTuiDamageFrameDescriptor {
     /**
      * Frame ids are compared only within one presentation epoch; absent means the current epoch. A
@@ -52,6 +52,17 @@ export interface DamageAwareTerminalOptions {
     };
     readonly onResize?: () => void;
     readonly onHyperlinkCleanupRequired?: () => void;
+    /** Exact-artifact fault controls evaluated before physical writes; absent in ordinary sessions. */
+    readonly allowWrite?: () => boolean;
+    readonly writeChunks?: (data: string) => readonly string[];
+    /** Optional payload-free observation after a terminal write returns. */
+    readonly onWrite?: (metadata: {
+        readonly bytes: number;
+        readonly fragments: number;
+        readonly transaction: "synchronized-output" | "ordinary";
+        readonly frameId?: number;
+        readonly cause?: string;
+    }) => void;
 }
 /**
  * A fail-closed adapter for one pinned Pi fullscreen write grammar. Semantic

package/dist/integrations/pi/tui-runtime/damage-aware-terminal.js

@@ -1,4 +1,4 @@
-export const PINNED_PI_TUI_DAMAGE_GRAMMAR = "@earendil-works/pi-tui@1.1.0:tui-alt-screen-one-write-v1";
+export const PINNED_PI_TUI_DAMAGE_GRAMMAR = "@earendil-works/pi-tui@1.4.0:tui-alt-screen-one-write-v1";
 const BEGIN_SYNCHRONIZED_OUTPUT = "\u001b[?2026h";
 const END_SYNCHRONIZED_OUTPUT = "\u001b[?2026l";
 const ROW_MARKER = /\u001b\[(\d+);1H\u001b\[2K/gu;
@@ -166,7 +166,36 @@ export class DamageAwareTerminalAdapter {
         const forwarded = this.#canvasBackgroundAnsi === null
             ? output
             : paintTerminalCanvasFrame(output, this.#canvasBackgroundAnsi);
-        this.inner.write(forwarded);
+        let writeAllowed = true;
+        try {
+            writeAllowed = this.options.allowWrite?.() ?? true;
+        }
+        catch { /* Invariant: fixture controls fail open. */ }
+        if (!writeAllowed)
+            return;
+        let chunks = [forwarded];
+        try {
+            const controlled = this.options.writeChunks?.(forwarded);
+            if (controlled !== undefined && controlled.length > 0 && controlled.length <= 4_096
+                && controlled.join("") === forwarded)
+                chunks = controlled;
+        }
+        catch { /* Invariant: fixture controls fail open without corrupting the renderer write. */ }
+        for (const chunk of chunks)
+            this.inner.write(chunk);
+        try {
+            this.options.onWrite?.({
+                bytes: Buffer.byteLength(forwarded),
+                fragments: chunks.length,
+                transaction: forwarded.startsWith(BEGIN_SYNCHRONIZED_OUTPUT) && forwarded.endsWith(END_SYNCHRONIZED_OUTPUT)
+                    ? "synchronized-output" : "ordinary",
+                ...(armed === undefined ? {} : {
+                    frameId: armed.descriptor.frameId,
+                    cause: armed.descriptor.cause,
+                }),
+            });
+        }
+        catch { /* Invariant: observation never changes rendering or write completion. */ }
         if (epoch !== this.#epoch
             || (armed !== undefined && this.#lastConsumedFrameId !== armed.descriptor.frameId))
             return;

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

@@ -1,20 +1,23 @@
 {
-  "schema": "a1-process-guardian-artifact-v1",
-  "protocolVersion": 1,
+  "schema": "a1-process-guardian-artifact-v2",
+  "kind": "node-addon",
+  "nodeApi": 9,
+  "protocolVersion": 2,
   "crateVersion": "0.1.0-dev",
   "platform": "darwin",
   "architecture": "arm64",
   "capability": "supported",
-  "builtAt": "2026-10-10T17:42:20.005Z",
+  "builtAt": "2026-10-28T17:55:49.435Z",
   "artifact": {
-    "filename": "process-guardian",
-    "sha256": "51b0b2dc1c9ae577f2586c4217066929278726c2c15308d9144eb6f538e118ff",
-    "size": 410368
+    "filename": "process-guardian.node",
+    "sha256": "a87eaaffcd986b624c8b044b756446cc1bdaf4334a1775b97820542fe34f9fb7",
+    "size": 456080
   },
   "provenance": {
     "language": "Rust",
     "cargoLock": "native/process-guardian/Cargo.lock",
     "sourceRoot": "native/process-guardian",
-    "signatureStatus": "ci-attestation-required"
+    "signatureStatus": "ci-attestation-required",
+    "identityCheck": "executed"
   }
 }