@timurproko/a1 0.2.5 → 0.2.6-dev.727

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

@@ -1,4 +1,4 @@
-import { type WheelScrollLines } from "@earendil-works/pi-tui";
+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";
 export type PiTuiRuntimeErrorStage = "construction" | "start" | "input-drain" | "restoration";
 /** Identifies the Pi TUI lifecycle stage that failed while preserving the original cause. */
@@ -39,6 +39,12 @@ export declare class PiTuiRuntimeAdapter {
      */
     freezePresentation(): void;
     get presentationFrozen(): boolean;
+    /**
+     * Keeps asynchronous replacement-surface construction atomic at the terminal. Renderers may
+     * compose while held, but their writes are dropped until the final forced repaint on release.
+     */
+    beginPresentationHold(): () => void;
+    get presentationHeld(): boolean;
     addPreInputListener(listener: PiTuiPreInputListener): () => void;
     addInputListener(listener: PiTuiInputListener): () => void;
     switchMode(mode: "regular" | "fullscreen"): boolean;
@@ -48,6 +54,7 @@ export declare class PiTuiRuntimeAdapter {
     setWheelScrollLines(lines: WheelScrollLines): void;
     getClearOnShrink(): boolean;
     setTerminalProgress(active: boolean): void;
+    setProgramStatus(status: ProgramStatus): void;
     setTitle(title: string): void;
     /** Shows a bounded fullscreen acknowledgement without changing root layout geometry. */
     showFlash(message: string, durationMs?: number): void;

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

@@ -118,6 +118,7 @@ export class PiTuiRuntimeAdapter {
     #rootDisposed = false;
     #terminalProgress = false;
     #presentationFrozen = false;
+    #presentationHolds = new Set();
     constructor(options) {
         this.#root = options.root;
         this.#overlayGeometry = options.onOverlayGeometry === undefined ? undefined : new OverlayGeometryTracker(options.onOverlayGeometry);
@@ -128,7 +129,7 @@ export class PiTuiRuntimeAdapter {
         // Invariant: the pinned renderer's frames pass through this gate, while writeControl and
         // the stop sequence reach the terminal directly. Freezing drops frames without touching
         // the renderer, so a scheduled repaint cannot land on top of the quit outro.
-        const gatedTerminal = frozenGateTerminal(this.#terminal, () => this.#presentationFrozen);
+        const gatedTerminal = frozenGateTerminal(this.#terminal, () => this.#presentationFrozen || this.#presentationHolds.size > 0);
         const tracedTerminal = options.inputDiagnostics === undefined
             ? gatedTerminal
             : diagnosticTerminal(gatedTerminal, phase => this.#traceRuntimePhase(phase));
@@ -320,6 +321,24 @@ export class PiTuiRuntimeAdapter {
     get presentationFrozen() {
         return this.#presentationFrozen;
     }
+    /**
+     * Keeps asynchronous replacement-surface construction atomic at the terminal. Renderers may
+     * compose while held, but their writes are dropped until the final forced repaint on release.
+     */
+    beginPresentationHold() {
+        this.#assertRunning("presentation hold");
+        const token = Symbol("presentation-hold");
+        this.#presentationHolds.add(token);
+        return () => {
+            if (!this.#presentationHolds.delete(token) || this.#presentationHolds.size > 0)
+                return;
+            if (this.active && !this.#presentationFrozen)
+                this.#tui.requestRender(true);
+        };
+    }
+    get presentationHeld() {
+        return this.#presentationHolds.size > 0;
+    }
     addPreInputListener(listener) {
         if (this.#preInputListeners.has(listener))
             throw new TypeError("Pi TUI pre-input listener is already registered");
@@ -396,6 +415,9 @@ export class PiTuiRuntimeAdapter {
         this.#terminal.setProgress(active);
         this.#terminalProgress = active;
     }
+    setProgramStatus(status) {
+        this.#terminal.setProgramStatus?.(status);
+    }
     setTitle(title) {
         this.#terminal.setTitle(title);
     }
@@ -427,6 +449,7 @@ export class PiTuiRuntimeAdapter {
             return this.#stopPromise;
         if (this.#state === "idle") {
             this.#state = "stopped";
+            this.#presentationHolds.clear();
             this.#clearTerminalProgress();
             this.#preInputListeners.clear();
             this.#disposeRoot();
@@ -462,6 +485,7 @@ export class PiTuiRuntimeAdapter {
             // Invariant: the gate opens only for the synchronous stop sequence, so no render
             // scheduled during the outro can slip in before the alternate screen is left.
             this.#presentationFrozen = false;
+            this.#presentationHolds.clear();
             this.#tui.stop(stopOptions);
         }
         catch (error) {
@@ -599,6 +623,7 @@ export class PiTuiRuntimeAdapter {
     }
     #restoreAfterFailedStart() {
         this.#presentationFrozen = false;
+        this.#presentationHolds.clear();
         try {
             this.#tui.stop();
         }
@@ -615,6 +640,7 @@ export class PiTuiRuntimeAdapter {
     }
     #bestEffortTerminalRestore() {
         this.#presentationFrozen = false;
+        this.#presentationHolds.clear();
         this.#clearTerminalProgress();
         try {
             if (this.mode === "fullscreen")
@@ -681,6 +707,7 @@ function coordinatedInputTerminal(terminal, coordinator, setSink, frameMouse) {
         clearScreen: () => terminal.clearScreen(),
         setTitle: title => terminal.setTitle(title),
         setProgress: active => terminal.setProgress(active),
+        setProgramStatus: status => terminal.setProgramStatus?.(status),
     };
 }
 function diagnosticTerminal(terminal, trace) {
@@ -708,6 +735,7 @@ function diagnosticTerminal(terminal, trace) {
         clearScreen: () => terminal.clearScreen(),
         setTitle: title => terminal.setTitle(title),
         setProgress: active => terminal.setProgress(active),
+        setProgramStatus: status => terminal.setProgramStatus?.(status),
     };
 }
 function frozenGateTerminal(terminal, frozen) {
@@ -734,6 +762,7 @@ function frozenGateTerminal(terminal, frozen) {
             terminal.clearScreen(); },
         setTitle: title => terminal.setTitle(title),
         setProgress: active => terminal.setProgress(active),
+        setProgramStatus: status => terminal.setProgramStatus?.(status),
     };
 }
 function preInputTerminal(terminal, route, frameMouse) {
@@ -765,6 +794,7 @@ function preInputTerminal(terminal, route, frameMouse) {
         clearScreen: () => terminal.clearScreen(),
         setTitle: title => terminal.setTitle(title),
         setProgress: active => terminal.setProgress(active),
+        setProgramStatus: status => terminal.setProgramStatus?.(status),
     };
 }
 function toOverlayOptions(options) {

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

@@ -1,5 +1,5 @@
 import type { PresentationComponentPort, PresentationPointerSurface } from "../../../contracts/presentation/index.js";
-import type { WheelScrollLines } from "@earendil-works/pi-tui";
+import type { ProgramStatus, WheelScrollLines } from "@earendil-works/pi-tui";
 import type { PiTuiInputCoordinationDecision, PiTuiInputCoordinationScheduler, PiTuiInputSurfaceKind } from "./input-presentation-coordinator.js";
 export type PiTuiRuntimeState = "idle" | "running" | "stopping" | "stopped" | "failed";
 export interface PiTuiViewport {
@@ -32,6 +32,8 @@ export interface PiTuiTerminalPort {
     clearScreen(): void;
     setTitle(title: string): void;
     setProgress(active: boolean): void;
+    /** Optional for neutral test/decorator ports; the Pi-facing adapter always supplies it. */
+    setProgramStatus?(status: ProgramStatus): 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.0.4:tui-alt-screen-one-write-v1";
+export declare const PINNED_PI_TUI_DAMAGE_GRAMMAR = "@earendil-works/pi-tui@1.1.0:tui-alt-screen-one-write-v1";
 export interface PiTuiDamageFrameDescriptor {
     readonly frameId: number;
     readonly width: number;

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.0.4:tui-alt-screen-one-write-v1";
+export const PINNED_PI_TUI_DAMAGE_GRAMMAR = "@earendil-works/pi-tui@1.1.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;

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

@@ -5,7 +5,7 @@
   "platform": "darwin",
   "architecture": "arm64",
   "capability": "supported",
-  "builtAt": "2026-10-07T15:54:44.546Z",
+  "builtAt": "2026-10-09T06:37:13.333Z",
   "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-07T15:54:41.381Z",
+  "builtAt": "2026-10-09T06:37:02.979Z",
   "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-07T15:55:19.867Z",
+  "builtAt": "2026-10-09T06:37:43.630Z",
   "artifact": {
     "filename": "process-guardian.exe",
-    "sha256": "0c34b684eab04e6d34b7feb5d1f5668f036e55da0af02b3b23516470bc9a4130",
+    "sha256": "63c2b95f4d07de25f9b25da06e7386f681474967118bf034ef4b02f0259cc9a3",
     "size": 288256
   },
   "provenance": {

package/dist/product-identity.d.ts

@@ -1,6 +1,6 @@
-declare const ENVIRONMENT_KEYS: readonly ["clipboardDiagnostics", "configDir", "dataDir", "databasePath", "developmentInstanceId", "developmentRoot", "endpoint", "exitNoticePath", "paneId", "probeTrace", "processGuardianPath", "prFooterPreview", "profileHome", "runtimeDir", "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", "terminalSessionId"];
 declare const FILESYSTEM_KEYS: readonly ["slug", "windowsDirectory", "unixDirectory", "temporaryPrefix"];
-declare const STATE_KEYS: readonly ["windowsControlDirectory", "unixControlDirectory", "developmentDirectory", "piAgentProfile", "piVanillaProfile", "sessionRepositoryDirectory"];
+declare const STATE_KEYS: readonly ["windowsControlDirectory", "unixControlDirectory", "developmentDirectory", "piAgentProfile", "piVanillaProfile", "sessionRepositoryDirectory", "sessionWorktreeClaimDirectory"];
 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", "promptHistorySchema", "releaseCohortSchema", "updateJournalSchema"];

package/dist/product-identity.js

@@ -1,10 +1,10 @@
 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", "skipVersionCheck", "startupTrace", "suggestionDiagnostics", "terminalSessionId",
+    "paneId", "probeTrace", "processGuardianPath", "prFooterPreview", "profileHome", "runtimeDir", "sessionRuntimeId", "skipVersionCheck", "startupTrace", "suggestionDiagnostics", "terminalSessionId",
 ];
 const FILESYSTEM_KEYS = ["slug", "windowsDirectory", "unixDirectory", "temporaryPrefix"];
-const STATE_KEYS = ["windowsControlDirectory", "unixControlDirectory", "developmentDirectory", "piAgentProfile", "piVanillaProfile", "sessionRepositoryDirectory"];
+const STATE_KEYS = ["windowsControlDirectory", "unixControlDirectory", "developmentDirectory", "piAgentProfile", "piVanillaProfile", "sessionRepositoryDirectory", "sessionWorktreeClaimDirectory"];
 const ENDPOINT_KEYS = ["windowsPipeStem", "unixSocketFilename", "metadataFilename", "supervisorLogFilename", "databaseFilename"];
 const MANIFEST_KEYS = ["releaseFilename", "packageFilename"];
 const PROTOCOL_KEYS = ["namespace", "controlEnvelope", "supervisorSchema", "nativeHostSchema", "structuredAgentSchema", "controlStoreSchema", "promptHistorySchema", "releaseCohortSchema", "updateJournalSchema"];

package/dist/product-identity.json

@@ -24,6 +24,7 @@
         "prFooterPreview": "A1_PR_FOOTER_PREVIEW",
         "profileHome": "A1_PROFILE_HOME",
         "runtimeDir": "A1_RUNTIME_DIR",
+        "sessionRuntimeId": "A1_SESSION_RUNTIME_ID",
         "skipVersionCheck": "A1_SKIP_VERSION_CHECK",
         "startupTrace": "A1_STARTUP_TRACE",
         "suggestionDiagnostics": "A1_SUGGESTION_DIAGNOSTICS",
@@ -35,7 +36,8 @@
         "developmentDirectory": "a1-development",
         "piAgentProfile": ".a1/agent",
         "piVanillaProfile": ".pi/agent",
-        "sessionRepositoryDirectory": "session-repositories"
+        "sessionRepositoryDirectory": "session-repositories",
+        "sessionWorktreeClaimDirectory": "session-worktree-claims"
     },
     "endpoint": {
         "windowsPipeStem": "a1",