@rynx-ai/runtime 0.1.11-beta.37 → 0.1.11-beta.39

package/dist/runner/protocol.d.ts

@@ -16,6 +16,10 @@ export interface WireError {
     code: string;
     statusCode: number;
 }
+/** Parent classification for a mirror write. `ambiguous` means persistence
+ * crossed the bounded response deadline: the
+ * operation may still commit, so retrying it would risk a duplicate. */
+export type MirrorNackClassification = "transient" | "permanent" | "ambiguous";
 /** Capabilities forwarded to a runner (parent serves status/listModels itself). */
 export type CapName = "getGoal" | "setGoal" | "clearGoal" | "forkSession";
 /** A live terminal role: `owner` is read-write, `read-only` a viewer. */
@@ -26,13 +30,46 @@ export type TerminalOpenErrorCode = "terminal_not_live" | "terminal_open_failed"
 /** Parent → child. Raw terminal bytes ride `term.input` base64-encoded so the
  *  NDJSON line framing stays intact (raw bytes contain newlines). */
 export type ToChild = {
+    t: "mirror.ack";
+    deliveryId: string;
+    generation: number;
+} | {
+    t: "mirror.nack";
+    deliveryId: string;
+    generation: number;
+    classification: MirrorNackClassification;
+    message: string;
+} | {
     t: "mirror.image.ack";
     transferId: string;
     seq: number;
+    generation: number;
 } | {
     t: "mirror.image.hold";
     transferId: string;
     seq: number;
+    generation: number;
+} | {
+    t: "mirror.image.nack";
+    transferId: string;
+    seq: number;
+    generation: number;
+    classification: MirrorNackClassification;
+    message: string;
+} | {
+    t: "rotate.ack";
+    rotationId: string;
+    generation: number;
+} | {
+    t: "rotate.nack";
+    rotationId: string;
+    generation: number;
+    classification: MirrorNackClassification;
+    message: string;
+} | {
+    t: "rotate.applied.ack";
+    rotationId: string;
+    generation: number;
 } | {
     t: "cap";
     capId: string;
@@ -217,24 +254,49 @@ export type FromChild = {
     t: "mirror";
     sessionId: string;
     event: SessionEvent;
-    /** Parent-local completion marker used after a chunked image is rebuilt. */
-    transferId?: string;
-    seq?: number;
+    /** Correlates the event with the parent's post-persistence ACK. */
+    deliveryId: string;
+    /** Logical mirror generation. A clear/fork supersedes every pending
+     * delivery from an older generation. */
+    generation: number;
+    /** One-based attempt for the same logical ordinary delivery. Lets the
+     * parent settle process-local projections exactly when the permanent
+     * retry budget is exhausted. */
+    attempt: number;
+}
+/** The child stopped waiting for an ordinary delivery after an ambiguous
+ * outcome or an exhausted permanent budget. The parent keeps the exact
+ * delivery-to-projection association until the listener settles, so a late
+ * persistence failure can retire only the matching optimistic input. */
+ | {
+    t: "mirror.abandon";
+    deliveryId: string;
+    generation: number;
 } | {
     t: "mirror.image.begin";
     transferId: string;
     sessionId: string;
     event: SessionEvent;
     totalChars: number;
+    generation: number;
 } | {
     t: "mirror.image.chunk";
     transferId: string;
     seq: number;
     data: string;
+    generation: number;
 } | {
     t: "mirror.image.commit";
     transferId: string;
     seq: number;
+    generation: number;
+}
+/** Child no longer waits for this transfer (ambiguous handled, permanent
+ * budget exhausted, or generation superseded); parent may release chunks. */
+ | {
+    t: "mirror.image.abandon";
+    transferId: string;
+    generation: number;
 } | {
     t: "terminal.lifecycle.ended";
     localThreadId: string;
@@ -256,11 +318,22 @@ export type FromChild = {
     t: "rotate";
     from: string;
     to: string;
+    rotationId: string;
+    generation: number;
     kind: "clear" | "fork";
     workspace: SessionWorkspaceSnapshot;
     execution: ResolvedExecutionSnapshot;
     parentSessionId?: string;
 }
+/** Child-side terminal/runtime ownership has moved to the durable target.
+ * The parent must not expose the target routing alias before this frame. */
+ | {
+    t: "rotate.applied";
+    rotationId: string;
+    generation: number;
+    from: string;
+    to: string;
+}
 /** Result of a `live.ensure`: for Codex-lineage sessions `ok` means backend
  *  preload and pane launch completed. A resume observer and fresh-thread
  *  discovery may continue in the background. Other Providers retain their

package/dist/runner/transport.d.ts

@@ -18,6 +18,15 @@ export interface RunnerTransport<TSend, TRecv> {
 export type ParentTransport = RunnerTransport<ToChild, FromChild>;
 /** Child-side transport: sends {@link FromChild}, receives {@link ToChild}. */
 export type ChildTransport = RunnerTransport<FromChild, ToChild>;
+/** Structured write failure used by delivery code to distinguish a frame that
+ * definitely never entered the pipe from one whose post-write result is
+ * uncertain. */
+export declare class RunnerTransportWriteError extends Error {
+    readonly delivery: "not-sent" | "ambiguous";
+    constructor(message: string, delivery: "not-sent" | "ambiguous", options?: {
+        cause?: unknown;
+    });
+}
 /**
  * NDJSON-over-streams transport. `input` is line-read for inbound messages;
  * `output` receives one JSON line per {@link send}. Used on both ends:

package/dist/runner/transport.js

@@ -11,6 +11,17 @@
  */
 import readline from "node:readline";
 import { decodeMessage, encodeMessage } from "./protocol.js";
+/** Structured write failure used by delivery code to distinguish a frame that
+ * definitely never entered the pipe from one whose post-write result is
+ * uncertain. */
+export class RunnerTransportWriteError extends Error {
+    delivery;
+    constructor(message, delivery, options) {
+        super(message, options);
+        this.delivery = delivery;
+        this.name = "RunnerTransportWriteError";
+    }
+}
 /**
  * NDJSON-over-streams transport. `input` is line-read for inbound messages;
  * `output` receives one JSON line per {@link send}. Used on both ends:
@@ -77,9 +88,16 @@ export class StdioRunnerTransport {
             handler(error);
     }
     writeMessage(msg) {
-        if (this.closed)
-            return Promise.reject(new Error("runner transport is closed"));
-        const encoded = encodeMessage(msg);
+        if (this.closed) {
+            return Promise.reject(new RunnerTransportWriteError("runner transport is closed before write", "not-sent"));
+        }
+        let encoded;
+        try {
+            encoded = encodeMessage(msg);
+        }
+        catch (error) {
+            return Promise.reject(new RunnerTransportWriteError("runner transport frame could not be encoded", "not-sent", { cause: error }));
+        }
         return new Promise((resolve, reject) => {
             let callbackDone = false;
             let drainDone = false;
@@ -104,17 +122,26 @@ export class StdioRunnerTransport {
                     return;
                 settled = true;
                 cleanup();
-                reject(error);
+                reject(new RunnerTransportWriteError("runner transport write result is uncertain", "ambiguous", { cause: error }));
             };
             this.output.once("error", onError);
-            const accepted = this.output.write(encoded, (error) => {
-                if (error) {
-                    onError(error);
-                    return;
-                }
-                callbackDone = true;
-                finish();
-            });
+            let accepted;
+            try {
+                accepted = this.output.write(encoded, (error) => {
+                    if (error) {
+                        onError(error);
+                        return;
+                    }
+                    callbackDone = true;
+                    finish();
+                });
+            }
+            catch (error) {
+                settled = true;
+                cleanup();
+                reject(new RunnerTransportWriteError("runner transport rejected the frame before write", "not-sent", { cause: error }));
+                return;
+            }
             drainDone = accepted;
             if (!accepted)
                 this.output.once("drain", onDrain);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rynx-ai/runtime",
-  "version": "0.1.11-beta.37",
+  "version": "0.1.11-beta.39",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/rynx-ai/rynx.git",
@@ -26,7 +26,7 @@
   "dependencies": {
     "smol-toml": "1.7.1",
     "ws": "^8.21.0",
-    "@rynx-ai/core": "0.1.11-beta.37"
+    "@rynx-ai/core": "0.1.11-beta.39"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1"