@timurproko/a1 0.2.6-dev.717 → 0.2.6-dev.734

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. */
@@ -54,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

@@ -95,7 +95,6 @@ export class PiTuiRuntimeAdapter {
     #terminal;
     #tuiTerminal;
     #tui;
-    #root;
     #layoutRoot;
     #tuiOptions;
     #logDirectory;
@@ -120,7 +119,6 @@ export class PiTuiRuntimeAdapter {
     #presentationFrozen = false;
     #presentationHolds = new Set();
     constructor(options) {
-        this.#root = options.root;
         this.#overlayGeometry = options.onOverlayGeometry === undefined ? undefined : new OverlayGeometryTracker(options.onOverlayGeometry);
         this.#terminal = options.terminal ?? new ProcessTerminal();
         this.#consumeUnhandledMouse = options.consumeUnhandledMouse ?? false;
@@ -415,6 +413,9 @@ export class PiTuiRuntimeAdapter {
         this.#terminal.setProgress(active);
         this.#terminalProgress = active;
     }
+    setProgramStatus(status) {
+        this.#terminal.setProgramStatus?.(status);
+    }
     setTitle(title) {
         this.#terminal.setTitle(title);
     }
@@ -704,6 +705,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) {
@@ -731,6 +733,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) {
@@ -757,6 +760,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) {
@@ -788,6 +792,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;
@@ -63,6 +63,9 @@ export declare class DamageAwareTerminalAdapter implements PiTuiTerminalPort {
     get kittyProtocolActive(): boolean;
     get lastDecision(): PiTuiDamageDecision;
     get hyperlinkCleanupPending(): boolean;
+    get canvasBackgroundAnsi(): string | null;
+    /** Invalidates remembered terminal cells before the shell forces one complete canvas repaint. */
+    setCanvasBackground(ansi: string | null): boolean;
     /**
      * The rows as last forwarded to the terminal, top to bottom, with styling
      * intact. A row the adapter has not seen since its last invalidation is empty.
@@ -86,3 +89,7 @@ export declare class DamageAwareTerminalAdapter implements PiTuiTerminalPort {
     setTitle(title: string): void;
     setProgress(active: boolean): void;
 }
+/** Makes SGR background resets return to A1's canvas while preserving explicit backgrounds. */
+export declare function rebaseTerminalDefaultBackground(content: string, backgroundAnsi: string): string;
+/** Paints only synchronized fullscreen rows; clipboard/title/progress controls remain byte-identical. */
+export declare function paintTerminalCanvasFrame(data: string, backgroundAnsi: string): string;

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;
@@ -8,6 +8,7 @@ const ROW_MARKER = /\u001b\[(\d+);1H\u001b\[2K/gu;
 const ROW_CONTENT_CURSOR = /\u001b\[\d+;1H/u;
 const CURSOR_SUFFIX = /(?:\u001b\[(\d+);(\d+)H)?\u001b\[\?25[hl]\u001b\[\?2026l$/u;
 const OUT_OF_BAND = /^(?:\u001b\](?:0|2|9|52);[^\u0007\u001b]*(?:\u0007|\u001b\\)|\u001b\[\?25[hl])+$/u;
+const SGR_SEQUENCE = /\u001b\[([0-9:;]*)m/gu;
 /**
  * A fail-closed adapter for one pinned Pi fullscreen write grammar. Semantic
  * viewport metadata authorizes a shift; bytes are inspected only to validate
@@ -26,6 +27,7 @@ export class DamageAwareTerminalAdapter {
     #lastConsumedFrameId = 0;
     #cacheWidth = 0;
     #cacheHeight = 0;
+    #canvasBackgroundAnsi = null;
     #decision = {
         frameId: null,
         transformed: false,
@@ -41,6 +43,15 @@ export class DamageAwareTerminalAdapter {
     get kittyProtocolActive() { return this.inner.kittyProtocolActive; }
     get lastDecision() { return this.#decision; }
     get hyperlinkCleanupPending() { return this.#cleanupRevision > this.#cleanedRevision; }
+    get canvasBackgroundAnsi() { return this.#canvasBackgroundAnsi; }
+    /** Invalidates remembered terminal cells before the shell forces one complete canvas repaint. */
+    setCanvasBackground(ansi) {
+        if (this.#canvasBackgroundAnsi === ansi)
+            return false;
+        this.#canvasBackgroundAnsi = ansi;
+        this.#invalidatePresentation();
+        return true;
+    }
     /**
      * The rows as last forwarded to the terminal, top to bottom, with styling
      * intact. A row the adapter has not seen since its last invalidation is empty.
@@ -140,7 +151,10 @@ export class DamageAwareTerminalAdapter {
                 output = buildDamageWrite(parsed, armed.descriptor, new Set(decision.paintedRows), this.#rows);
             }
         }
-        this.inner.write(output);
+        const forwarded = this.#canvasBackgroundAnsi === null
+            ? output
+            : paintTerminalCanvasFrame(output, this.#canvasBackgroundAnsi);
+        this.inner.write(forwarded);
         if (epoch !== this.#epoch
             || (armed !== undefined && this.#lastConsumedFrameId !== armed.descriptor.frameId))
             return;
@@ -363,6 +377,57 @@ export class DamageAwareTerminalAdapter {
         this.#cacheHeight = 0;
     }
 }
+/** Makes SGR background resets return to A1's canvas while preserving explicit backgrounds. */
+export function rebaseTerminalDefaultBackground(content, backgroundAnsi) {
+    return content.replace(SGR_SEQUENCE, (sequence, parameters) => (sgrLeavesDefaultBackground(parameters) ? `${sequence}${backgroundAnsi}` : sequence));
+}
+/** Paints only synchronized fullscreen rows; clipboard/title/progress controls remain byte-identical. */
+export function paintTerminalCanvasFrame(data, backgroundAnsi) {
+    if (!data.startsWith(BEGIN_SYNCHRONIZED_OUTPUT) || !data.endsWith(END_SYNCHRONIZED_OUTPUT)
+        || !ROW_MARKER.test(data)) {
+        ROW_MARKER.lastIndex = 0;
+        return data;
+    }
+    ROW_MARKER.lastIndex = 0;
+    const rows = data.replace(ROW_MARKER, (_marker, row) => (`\u001b[${row};1H${backgroundAnsi}\u001b[2K${backgroundAnsi}`));
+    ROW_MARKER.lastIndex = 0;
+    const rebased = rebaseTerminalDefaultBackground(rows, backgroundAnsi);
+    return `${rebased.slice(0, -END_SYNCHRONIZED_OUTPUT.length)}\u001b[49m${END_SYNCHRONIZED_OUTPUT}`;
+}
+function sgrLeavesDefaultBackground(parameters) {
+    if (parameters.length === 0)
+        return true;
+    const values = parameters.split(";");
+    let defaultBackground;
+    for (let index = 0; index < values.length; index += 1) {
+        const token = values[index];
+        const code = Number.parseInt(token.split(":", 1)[0] || "0", 10);
+        if (!Number.isFinite(code))
+            continue;
+        if (code === 0 || code === 49) {
+            defaultBackground = true;
+            continue;
+        }
+        if (code >= 40 && code <= 47 || code >= 100 && code <= 107) {
+            defaultBackground = false;
+            continue;
+        }
+        if (code !== 38 && code !== 48 && code !== 58)
+            continue;
+        if (code === 48)
+            defaultBackground = false;
+        if (token.includes(":"))
+            continue;
+        const mode = Number.parseInt(values[index + 1] ?? "", 10);
+        if (mode === 5)
+            index += 2;
+        else if (mode === 2)
+            index += 4;
+        else
+            index += 1;
+    }
+    return defaultBackground === true;
+}
 function parsePinnedFullscreenWrite(data) {
     if (!data.startsWith(BEGIN_SYNCHRONIZED_OUTPUT) || !data.endsWith(END_SYNCHRONIZED_OUTPUT))
         return null;

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

@@ -1,6 +1,6 @@
 export type { PiTuiComponentPort, PiTuiInputDiagnosticsEvent, PiTuiInputDiagnosticsPhase, PiTuiInputListener, PiTuiInputListenerResult, PiTuiLayoutEntry, PiTuiLayoutNode, PiTuiOverlayAnchor, PiTuiOverlayHandle, PiTuiOverlayMargin, PiTuiOverlayOptions, PiTuiOverlayUnfocusOptions, PiTuiPointerSurface, PiTuiPreInputListener, PiTuiRuntimeAdapterOptions, PiTuiRuntimeState, PiTuiScrollState, PiTuiSizeValue, PiTuiStopOptions, PiTuiTerminalPort, PiTuiViewport, } from "./contracts.js";
 export { samePointerSurfaces } from "./overlay-geometry.js";
-export { DamageAwareTerminalAdapter, PINNED_PI_TUI_DAMAGE_GRAMMAR } from "./damage-aware-terminal.js";
+export { DamageAwareTerminalAdapter, PINNED_PI_TUI_DAMAGE_GRAMMAR, paintTerminalCanvasFrame, rebaseTerminalDefaultBackground, } from "./damage-aware-terminal.js";
 export type { DamageAwareTerminalOptions, PiTuiDamageDecision, PiTuiDamageDecisionReason, PiTuiDamageFrameDescriptor, PiTuiDamageFrameSafety, } from "./damage-aware-terminal.js";
 export { InputPresentationCoordinator, classifyPiTuiInput } from "./input-presentation-coordinator.js";
 export type { InputPresentationCoordinatorOptions, PiTuiInputCoordinationDecision, PiTuiInputCoordinationScheduler, PiTuiInputCoordinationTrace, PiTuiInputSurfaceKind, } from "./input-presentation-coordinator.js";

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

@@ -1,5 +1,5 @@
 export { samePointerSurfaces } from "./overlay-geometry.js";
-export { DamageAwareTerminalAdapter, PINNED_PI_TUI_DAMAGE_GRAMMAR } from "./damage-aware-terminal.js";
+export { DamageAwareTerminalAdapter, PINNED_PI_TUI_DAMAGE_GRAMMAR, paintTerminalCanvasFrame, rebaseTerminalDefaultBackground, } from "./damage-aware-terminal.js";
 export { InputPresentationCoordinator, classifyPiTuiInput } from "./input-presentation-coordinator.js";
 export { PiTuiRuntimeAdapter, PiTuiRuntimeError } from "./adapter.js";
 export { createPiPresentationRuntime, createPiTerminalBridge } from "./presentation-adapter.js";

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

@@ -5,7 +5,7 @@
   "platform": "darwin",
   "architecture": "arm64",
   "capability": "supported",
-  "builtAt": "2026-10-08T10:43:26.855Z",
+  "builtAt": "2026-10-10T06:00:13.890Z",
   "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-08T10:43:15.921Z",
+  "builtAt": "2026-10-10T06:00:04.832Z",
   "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-08T10:43:54.524Z",
+  "builtAt": "2026-10-10T06:00:51.067Z",
   "artifact": {
     "filename": "process-guardian.exe",
-    "sha256": "4c84729bd86ecee969b71895ccf86021af1f4b4e86e0906ff9ef78dbad03e6d7",
+    "sha256": "e9c6d7e4596a7cd2634bb74b67925499fe6817cbfb667b574d27ff1b7cb33d93",
     "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",