@opengeni/agent-proto 0.5.1 → 0.6.0-canary.0

package/dist/gen/opengeni_agent.d.ts

@@ -336,6 +336,11 @@ export interface Capabilities {
      * CPU quota that an older memory-only runner would ignore as an unknown field.
      */
     operationCpuQuota: boolean;
+    /**
+     * Transactional uploads via OpStart.fs_write / WriteChunk / OpQuery / OpCancel.
+     * Independent of op_stream. Absent/false runners MUST NOT receive this path.
+     */
+    transactionalFsWrite: boolean;
 }
 /**
  * Capabilities of one live browser-profile bridge endpoint. This describes the
@@ -1101,21 +1106,34 @@ export interface OpExit_FailureDetailEntry {
     value: string;
 }
 /**
- * The op-begin for a STREAMING fs_write (M7): the target is set up here; the bytes
- * arrive as chunked, idempotent WriteChunk request/replies (no reverse streaming).
+ * Transactional upload begin. Requires transactional_fs_write, not op_stream.
+ * The op_id must use the fsw- namespace; bytes arrive as sequential WriteChunk
+ * requests. This path emits no OpFrames and supports no OpAttach/OpAck.
  */
 export interface FsWriteBegin {
     path: string;
-    /** Create parent directories as needed. */
+    /**
+     * Reserved compatibility field. Transactional writes require existing parent
+     * directories; even true never creates visible directories during staging.
+     */
     createParents: boolean;
     /** POSIX mode for a newly created file (0 => platform default). */
     mode: number;
     /**
-     * Editor safety (M6): the expected blake3 hex digest of the file's CURRENT
-     * content for a read-modify-write; empty for a plain write. On a re-dispatch a
-     * mismatch REFUSES rather than double-applying a diff.
+     * Expected lowercase BLAKE3 hex digest of CURRENT content for replacement.
+     * Required unless expected_absent. Checked with opened inode identity before
+     * commit; optimistic against unrelated writers, NOT an atomic filesystem CAS.
      */
     expectedBaseDigest: string;
+    /** Required lowercase BLAKE3 hex digest of the complete intended content. */
+    contentDigest: string;
+    /** Required presence, including an explicitly present zero for empty content. */
+    contentSize?: string | undefined;
+    /**
+     * Exactly one of expected_absent / expected_base_digest is required.
+     * Creation publishes atomically without replacing a concurrently created file.
+     */
+    expectedAbsent: boolean;
 }
 /**
  * Start an op (server→runner). IDEMPOTENT by op_id (= ControlRequest.request_id):
@@ -1198,20 +1216,28 @@ export interface OpStatus {
     exit: OpExit | undefined;
     /** Present iff state == OP_STATE_LOST. */
     lostReason: OpLostReason;
+    /**
+     * Transactional fs_write only: accepted byte offset. next_seq is the next
+     * chunk sequence, not an output frame sequence. Complete echoes verified
+     * content in exit.digests["content"] / exit.totals["content"]. No OpFrames.
+     */
+    writeOffset: string;
 }
 /**
  * One chunk of a streaming upload (server→runner): plain idempotent request/reply
- * per chunk (≤512 KiB). A duplicate (op_id, seq) is acked WITHOUT re-applying.
+ * per chunk (≤512 KiB). An exact duplicate of the most recently accepted chunk
+ * is acked WITHOUT re-applying (including a lost final ack). Older sequences or
+ * changed duplicate bodies are refused, never silently accepted or re-applied.
  */
 export interface WriteChunk {
     opId: string;
     /** The op-scoped monotonic chunk sequence. */
     seq: string;
     bytes: Uint8Array;
-    /** The final chunk: commit = digest-verify then atomic rename (M7). */
+    /** Final chunk: verify intended size/digest and base, then atomic publication. */
     last: boolean;
     /**
-     * Byte offset this chunk writes at (M7: writes land in an op-scoped temp file,
+     * Byte offset this chunk writes at (writes land in an op-scoped temp file,
      * committed on the last chunk — an aborted transfer leaves no visible file).
      */
     offset: string;

package/dist/index.js

@@ -1274,7 +1274,8 @@ function createBaseCapabilities() {
     opStream: false,
     browserBridge: false,
     operationResourcePolicy: false,
-    operationCpuQuota: false
+    operationCpuQuota: false,
+    transactionalFsWrite: false
   };
 }
 var Capabilities = {
@@ -1318,6 +1319,9 @@ var Capabilities = {
     if (message.operationCpuQuota !== false) {
       writer.uint32(104).bool(message.operationCpuQuota);
     }
+    if (message.transactionalFsWrite !== false) {
+      writer.uint32(112).bool(message.transactionalFsWrite);
+    }
     return writer;
   },
   decode(input, length) {
@@ -1418,6 +1422,13 @@ var Capabilities = {
           message.operationCpuQuota = reader.bool();
           continue;
         }
+        case 14: {
+          if (tag !== 112) {
+            break;
+          }
+          message.transactionalFsWrite = reader.bool();
+          continue;
+        }
       }
       if ((tag & 7) === 4 || tag === 0) {
         break;
@@ -1440,7 +1451,8 @@ var Capabilities = {
       opStream: isSet(object.opStream) ? globalThis.Boolean(object.opStream) : isSet(object.op_stream) ? globalThis.Boolean(object.op_stream) : false,
       browserBridge: isSet(object.browserBridge) ? globalThis.Boolean(object.browserBridge) : isSet(object.browser_bridge) ? globalThis.Boolean(object.browser_bridge) : false,
       operationResourcePolicy: isSet(object.operationResourcePolicy) ? globalThis.Boolean(object.operationResourcePolicy) : isSet(object.operation_resource_policy) ? globalThis.Boolean(object.operation_resource_policy) : false,
-      operationCpuQuota: isSet(object.operationCpuQuota) ? globalThis.Boolean(object.operationCpuQuota) : isSet(object.operation_cpu_quota) ? globalThis.Boolean(object.operation_cpu_quota) : false
+      operationCpuQuota: isSet(object.operationCpuQuota) ? globalThis.Boolean(object.operationCpuQuota) : isSet(object.operation_cpu_quota) ? globalThis.Boolean(object.operation_cpu_quota) : false,
+      transactionalFsWrite: isSet(object.transactionalFsWrite) ? globalThis.Boolean(object.transactionalFsWrite) : isSet(object.transactional_fs_write) ? globalThis.Boolean(object.transactional_fs_write) : false
     };
   },
   toJSON(message) {
@@ -1484,6 +1496,9 @@ var Capabilities = {
     if (message.operationCpuQuota !== false) {
       obj.operationCpuQuota = message.operationCpuQuota;
     }
+    if (message.transactionalFsWrite !== false) {
+      obj.transactionalFsWrite = message.transactionalFsWrite;
+    }
     return obj;
   },
   create(base) {
@@ -1504,6 +1519,7 @@ var Capabilities = {
     message.browserBridge = object.browserBridge ?? false;
     message.operationResourcePolicy = object.operationResourcePolicy ?? false;
     message.operationCpuQuota = object.operationCpuQuota ?? false;
+    message.transactionalFsWrite = object.transactionalFsWrite ?? false;
     return message;
   }
 };
@@ -8937,7 +8953,15 @@ var OpExit_FailureDetailEntry = {
   }
 };
 function createBaseFsWriteBegin() {
-  return { path: "", createParents: false, mode: 0, expectedBaseDigest: "" };
+  return {
+    path: "",
+    createParents: false,
+    mode: 0,
+    expectedBaseDigest: "",
+    contentDigest: "",
+    contentSize: void 0,
+    expectedAbsent: false
+  };
 }
 var FsWriteBegin = {
   encode(message, writer = new BinaryWriter()) {
@@ -8953,6 +8977,15 @@ var FsWriteBegin = {
     if (message.expectedBaseDigest !== "") {
       writer.uint32(34).string(message.expectedBaseDigest);
     }
+    if (message.contentDigest !== "") {
+      writer.uint32(42).string(message.contentDigest);
+    }
+    if (message.contentSize !== void 0) {
+      writer.uint32(48).uint64(message.contentSize);
+    }
+    if (message.expectedAbsent !== false) {
+      writer.uint32(56).bool(message.expectedAbsent);
+    }
     return writer;
   },
   decode(input, length) {
@@ -8990,6 +9023,27 @@ var FsWriteBegin = {
           message.expectedBaseDigest = reader.string();
           continue;
         }
+        case 5: {
+          if (tag !== 42) {
+            break;
+          }
+          message.contentDigest = reader.string();
+          continue;
+        }
+        case 6: {
+          if (tag !== 48) {
+            break;
+          }
+          message.contentSize = reader.uint64().toString();
+          continue;
+        }
+        case 7: {
+          if (tag !== 56) {
+            break;
+          }
+          message.expectedAbsent = reader.bool();
+          continue;
+        }
       }
       if ((tag & 7) === 4 || tag === 0) {
         break;
@@ -9003,7 +9057,10 @@ var FsWriteBegin = {
       path: isSet(object.path) ? globalThis.String(object.path) : "",
       createParents: isSet(object.createParents) ? globalThis.Boolean(object.createParents) : isSet(object.create_parents) ? globalThis.Boolean(object.create_parents) : false,
       mode: isSet(object.mode) ? globalThis.Number(object.mode) : 0,
-      expectedBaseDigest: isSet(object.expectedBaseDigest) ? globalThis.String(object.expectedBaseDigest) : isSet(object.expected_base_digest) ? globalThis.String(object.expected_base_digest) : ""
+      expectedBaseDigest: isSet(object.expectedBaseDigest) ? globalThis.String(object.expectedBaseDigest) : isSet(object.expected_base_digest) ? globalThis.String(object.expected_base_digest) : "",
+      contentDigest: isSet(object.contentDigest) ? globalThis.String(object.contentDigest) : isSet(object.content_digest) ? globalThis.String(object.content_digest) : "",
+      contentSize: isSet(object.contentSize) ? globalThis.String(object.contentSize) : isSet(object.content_size) ? globalThis.String(object.content_size) : void 0,
+      expectedAbsent: isSet(object.expectedAbsent) ? globalThis.Boolean(object.expectedAbsent) : isSet(object.expected_absent) ? globalThis.Boolean(object.expected_absent) : false
     };
   },
   toJSON(message) {
@@ -9020,6 +9077,15 @@ var FsWriteBegin = {
     if (message.expectedBaseDigest !== "") {
       obj.expectedBaseDigest = message.expectedBaseDigest;
     }
+    if (message.contentDigest !== "") {
+      obj.contentDigest = message.contentDigest;
+    }
+    if (message.contentSize !== void 0) {
+      obj.contentSize = message.contentSize;
+    }
+    if (message.expectedAbsent !== false) {
+      obj.expectedAbsent = message.expectedAbsent;
+    }
     return obj;
   },
   create(base) {
@@ -9031,6 +9097,9 @@ var FsWriteBegin = {
     message.createParents = object.createParents ?? false;
     message.mode = object.mode ?? 0;
     message.expectedBaseDigest = object.expectedBaseDigest ?? "";
+    message.contentDigest = object.contentDigest ?? "";
+    message.contentSize = object.contentSize ?? void 0;
+    message.expectedAbsent = object.expectedAbsent ?? false;
     return message;
   }
 };
@@ -9450,7 +9519,7 @@ var OpAttach = {
   }
 };
 function createBaseOpStatus() {
-  return { opId: "", state: 0, nextSeq: "0", exit: void 0, lostReason: 0 };
+  return { opId: "", state: 0, nextSeq: "0", exit: void 0, lostReason: 0, writeOffset: "0" };
 }
 var OpStatus = {
   encode(message, writer = new BinaryWriter()) {
@@ -9469,6 +9538,9 @@ var OpStatus = {
     if (message.lostReason !== 0) {
       writer.uint32(40).int32(message.lostReason);
     }
+    if (message.writeOffset !== "0") {
+      writer.uint32(48).uint64(message.writeOffset);
+    }
     return writer;
   },
   decode(input, length) {
@@ -9513,6 +9585,13 @@ var OpStatus = {
           message.lostReason = reader.int32();
           continue;
         }
+        case 6: {
+          if (tag !== 48) {
+            break;
+          }
+          message.writeOffset = reader.uint64().toString();
+          continue;
+        }
       }
       if ((tag & 7) === 4 || tag === 0) {
         break;
@@ -9527,7 +9606,8 @@ var OpStatus = {
       state: isSet(object.state) ? opStateFromJSON(object.state) : 0,
       nextSeq: isSet(object.nextSeq) ? globalThis.String(object.nextSeq) : isSet(object.next_seq) ? globalThis.String(object.next_seq) : "0",
       exit: isSet(object.exit) ? OpExit.fromJSON(object.exit) : void 0,
-      lostReason: isSet(object.lostReason) ? opLostReasonFromJSON(object.lostReason) : isSet(object.lost_reason) ? opLostReasonFromJSON(object.lost_reason) : 0
+      lostReason: isSet(object.lostReason) ? opLostReasonFromJSON(object.lostReason) : isSet(object.lost_reason) ? opLostReasonFromJSON(object.lost_reason) : 0,
+      writeOffset: isSet(object.writeOffset) ? globalThis.String(object.writeOffset) : isSet(object.write_offset) ? globalThis.String(object.write_offset) : "0"
     };
   },
   toJSON(message) {
@@ -9547,6 +9627,9 @@ var OpStatus = {
     if (message.lostReason !== 0) {
       obj.lostReason = opLostReasonToJSON(message.lostReason);
     }
+    if (message.writeOffset !== "0") {
+      obj.writeOffset = message.writeOffset;
+    }
     return obj;
   },
   create(base) {
@@ -9559,6 +9642,7 @@ var OpStatus = {
     message.nextSeq = object.nextSeq ?? "0";
     message.exit = object.exit !== void 0 && object.exit !== null ? OpExit.fromPartial(object.exit) : void 0;
     message.lostReason = object.lostReason ?? 0;
+    message.writeOffset = object.writeOffset ?? "0";
     return message;
   }
 };