@opengeni/artifact-tool 0.2.8 → 0.3.4-canary.0

package/dist/snapshot.js

@@ -5,26 +5,27 @@ import {
   NativeDocumentSession,
   NativePresentationSession,
   NativeSpreadsheetSession
-} from "./chunk-B2ZJRZDA.js";
-import "./chunk-N2IHNWBS.js";
+} from "./chunk-LVPFJH2Z.js";
+import "./chunk-4YYYUZQH.js";
 import "./chunk-VUNV25KB.js";
 
 // src/snapshot.ts
 import {
   COMMITTED_TRANSACTION_PROTOCOL_VERSION,
-  EDITABLE_ARTIFACT_MODEL_SCHEMA_VERSION,
-  EDITABLE_ARTIFACT_SNAPSHOT_VERSION
+  DOCUMENT_ARTIFACT_MODEL_SCHEMA_VERSION,
+  DOCUMENT_ARTIFACT_SNAPSHOT_VERSION,
+  PRESENTATION_ARTIFACT_MODEL_SCHEMA_VERSION,
+  PRESENTATION_ARTIFACT_SNAPSHOT_VERSION,
+  SPREADSHEET_ARTIFACT_MODEL_SCHEMA_VERSION,
+  SPREADSHEET_COLLABORATION_SNAPSHOT_VERSION
 } from "@opengeni/contracts/editable-artifact-versions";
 function createArtifactSnapshot(artifact) {
   const state = requireCompositeState(artifact);
   const native = state.native;
   const common = {
     schemaVersion: 1,
-    modality: state.modality,
     runtimeTarget: native.target,
     kernelVersion: native.buildIdentity,
-    modelSchemaVersion: EDITABLE_ARTIFACT_MODEL_SCHEMA_VERSION,
-    snapshotVersion: EDITABLE_ARTIFACT_SNAPSHOT_VERSION,
     stateHash: native.stateHash(),
     snapshotBytes: Uint8Array.from(native.snapshot())
   };
@@ -35,18 +36,29 @@ function createArtifactSnapshot(artifact) {
     return Object.freeze({
       ...common,
       modality: "spreadsheet",
+      modelSchemaVersion: SPREADSHEET_ARTIFACT_MODEL_SCHEMA_VERSION,
+      snapshotVersion: SPREADSHEET_COLLABORATION_SNAPSHOT_VERSION,
       coveredCausalFrontierBytes: Uint8Array.from(native.frontier()),
       operationProtocolVersion: COMMITTED_TRANSACTION_PROTOCOL_VERSION,
-      crdtStateVersion: EDITABLE_ARTIFACT_SNAPSHOT_VERSION
+      crdtStateVersion: SPREADSHEET_COLLABORATION_SNAPSHOT_VERSION
     });
   }
   if (!(native instanceof NativeDocumentSession) && !(native instanceof NativePresentationSession)) {
     throw new Error("Serialized composite does not own its expected native session");
   }
-  return Object.freeze({
+  const nativeRevision = safeNativeRevision(native.revision());
+  return state.modality === "document" ? Object.freeze({
     ...common,
-    modality: state.modality,
-    nativeRevision: safeNativeRevision(native.revision())
+    modality: "document",
+    modelSchemaVersion: DOCUMENT_ARTIFACT_MODEL_SCHEMA_VERSION,
+    snapshotVersion: DOCUMENT_ARTIFACT_SNAPSHOT_VERSION,
+    nativeRevision
+  }) : Object.freeze({
+    ...common,
+    modality: "presentation",
+    modelSchemaVersion: PRESENTATION_ARTIFACT_MODEL_SCHEMA_VERSION,
+    snapshotVersion: PRESENTATION_ARTIFACT_SNAPSHOT_VERSION,
+    nativeRevision
   });
 }
 function safeNativeRevision(value) {

package/dist/snapshot.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/snapshot.ts"],"sourcesContent":["import {\n  COMMITTED_TRANSACTION_PROTOCOL_VERSION,\n  EDITABLE_ARTIFACT_MODEL_SCHEMA_VERSION,\n  EDITABLE_ARTIFACT_SNAPSHOT_VERSION,\n} from \"@opengeni/contracts/editable-artifact-versions\";\nimport type { Document } from \"./document\";\nimport {\n  NativeDocumentSession,\n  NativePresentationSession,\n  NativeSpreadsheetSession,\n} from \"./native\";\nimport type { Presentation } from \"./presentation\";\nimport { requireCompositeState } from \"./production-composite\";\nimport type { Workbook } from \"./spreadsheet\";\n\ntype ArtifactSnapshotCommon = Readonly<{\n  schemaVersion: 1;\n  modality: \"spreadsheet\" | \"document\" | \"presentation\";\n  runtimeTarget: string;\n  kernelVersion: string;\n  modelSchemaVersion: 1;\n  snapshotVersion: 1;\n  stateHash: string;\n  snapshotBytes: Uint8Array;\n}>;\n\n/** Exact native-canonical state at one durable artifact boundary. */\nexport type ArtifactSnapshot =\n  | (ArtifactSnapshotCommon &\n      Readonly<{\n        modality: \"spreadsheet\";\n        coveredCausalFrontierBytes: Uint8Array;\n        operationProtocolVersion: 1;\n        crdtStateVersion: 1;\n      }>)\n  | (ArtifactSnapshotCommon &\n      Readonly<{\n        modality: \"document\" | \"presentation\";\n        nativeRevision: number;\n      }>);\n\n/** Capture one immutable native snapshot from an open artifact object. */\nexport function createArtifactSnapshot(\n  artifact: Workbook | Document | Presentation,\n): ArtifactSnapshot {\n  const state = requireCompositeState(artifact);\n  const native = state.native;\n  const common = {\n    schemaVersion: 1 as const,\n    modality: state.modality,\n    runtimeTarget: native.target,\n    kernelVersion: native.buildIdentity,\n    modelSchemaVersion: EDITABLE_ARTIFACT_MODEL_SCHEMA_VERSION,\n    snapshotVersion: EDITABLE_ARTIFACT_SNAPSHOT_VERSION,\n    stateHash: native.stateHash(),\n    snapshotBytes: Uint8Array.from(native.snapshot()),\n  };\n  if (state.modality === \"spreadsheet\") {\n    if (!(native instanceof NativeSpreadsheetSession)) {\n      throw new Error(\"Spreadsheet composite does not own a spreadsheet native session\");\n    }\n    return Object.freeze({\n      ...common,\n      modality: \"spreadsheet\" as const,\n      coveredCausalFrontierBytes: Uint8Array.from(native.frontier()),\n      operationProtocolVersion: COMMITTED_TRANSACTION_PROTOCOL_VERSION,\n      crdtStateVersion: EDITABLE_ARTIFACT_SNAPSHOT_VERSION,\n    });\n  }\n  if (\n    !(native instanceof NativeDocumentSession) &&\n    !(native instanceof NativePresentationSession)\n  ) {\n    throw new Error(\"Serialized composite does not own its expected native session\");\n  }\n  return Object.freeze({\n    ...common,\n    modality: state.modality,\n    nativeRevision: safeNativeRevision(native.revision()),\n  });\n}\n\nfunction safeNativeRevision(value: bigint): number {\n  if (value < 0n || value > BigInt(Number.MAX_SAFE_INTEGER)) {\n    throw new RangeError(\"Artifact native revision exceeds the durable range\");\n  }\n  return Number(value);\n}\n"],"mappings":";;;;;;;;;;;;AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAsCA,SAAS,uBACd,UACkB;AAClB,QAAM,QAAQ,sBAAsB,QAAQ;AAC5C,QAAM,SAAS,MAAM;AACrB,QAAM,SAAS;AAAA,IACb,eAAe;AAAA,IACf,UAAU,MAAM;AAAA,IAChB,eAAe,OAAO;AAAA,IACtB,eAAe,OAAO;AAAA,IACtB,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,IACjB,WAAW,OAAO,UAAU;AAAA,IAC5B,eAAe,WAAW,KAAK,OAAO,SAAS,CAAC;AAAA,EAClD;AACA,MAAI,MAAM,aAAa,eAAe;AACpC,QAAI,EAAE,kBAAkB,2BAA2B;AACjD,YAAM,IAAI,MAAM,iEAAiE;AAAA,IACnF;AACA,WAAO,OAAO,OAAO;AAAA,MACnB,GAAG;AAAA,MACH,UAAU;AAAA,MACV,4BAA4B,WAAW,KAAK,OAAO,SAAS,CAAC;AAAA,MAC7D,0BAA0B;AAAA,MAC1B,kBAAkB;AAAA,IACpB,CAAC;AAAA,EACH;AACA,MACE,EAAE,kBAAkB,0BACpB,EAAE,kBAAkB,4BACpB;AACA,UAAM,IAAI,MAAM,+DAA+D;AAAA,EACjF;AACA,SAAO,OAAO,OAAO;AAAA,IACnB,GAAG;AAAA,IACH,UAAU,MAAM;AAAA,IAChB,gBAAgB,mBAAmB,OAAO,SAAS,CAAC;AAAA,EACtD,CAAC;AACH;AAEA,SAAS,mBAAmB,OAAuB;AACjD,MAAI,QAAQ,MAAM,QAAQ,OAAO,OAAO,gBAAgB,GAAG;AACzD,UAAM,IAAI,WAAW,oDAAoD;AAAA,EAC3E;AACA,SAAO,OAAO,KAAK;AACrB;","names":[]}
+{"version":3,"sources":["../src/snapshot.ts"],"sourcesContent":["import {\n  COMMITTED_TRANSACTION_PROTOCOL_VERSION,\n  DOCUMENT_ARTIFACT_MODEL_SCHEMA_VERSION,\n  DOCUMENT_ARTIFACT_SNAPSHOT_VERSION,\n  PRESENTATION_ARTIFACT_MODEL_SCHEMA_VERSION,\n  PRESENTATION_ARTIFACT_SNAPSHOT_VERSION,\n  SPREADSHEET_ARTIFACT_MODEL_SCHEMA_VERSION,\n  SPREADSHEET_COLLABORATION_SNAPSHOT_VERSION,\n} from \"@opengeni/contracts/editable-artifact-versions\";\nimport type { Document } from \"./document\";\nimport {\n  NativeDocumentSession,\n  NativePresentationSession,\n  NativeSpreadsheetSession,\n} from \"./native\";\nimport type { Presentation } from \"./presentation\";\nimport { requireCompositeState } from \"./production-composite\";\nimport type { Workbook } from \"./spreadsheet\";\n\ntype ArtifactSnapshotCommon = Readonly<{\n  schemaVersion: 1;\n  runtimeTarget: string;\n  kernelVersion: string;\n  stateHash: string;\n  snapshotBytes: Uint8Array;\n}>;\n\n/** Exact native-canonical state at one durable artifact boundary. */\nexport type ArtifactSnapshot =\n  | (ArtifactSnapshotCommon &\n      Readonly<{\n        modality: \"spreadsheet\";\n        modelSchemaVersion: typeof SPREADSHEET_ARTIFACT_MODEL_SCHEMA_VERSION;\n        snapshotVersion: typeof SPREADSHEET_COLLABORATION_SNAPSHOT_VERSION;\n        coveredCausalFrontierBytes: Uint8Array;\n        operationProtocolVersion: typeof COMMITTED_TRANSACTION_PROTOCOL_VERSION;\n        crdtStateVersion: typeof SPREADSHEET_COLLABORATION_SNAPSHOT_VERSION;\n      }>)\n  | (ArtifactSnapshotCommon &\n      Readonly<{\n        modality: \"document\";\n        modelSchemaVersion: typeof DOCUMENT_ARTIFACT_MODEL_SCHEMA_VERSION;\n        snapshotVersion: typeof DOCUMENT_ARTIFACT_SNAPSHOT_VERSION;\n        nativeRevision: number;\n      }>)\n  | (ArtifactSnapshotCommon &\n      Readonly<{\n        modality: \"presentation\";\n        modelSchemaVersion: typeof PRESENTATION_ARTIFACT_MODEL_SCHEMA_VERSION;\n        snapshotVersion: typeof PRESENTATION_ARTIFACT_SNAPSHOT_VERSION;\n        nativeRevision: number;\n      }>);\n\n/** Capture one immutable native snapshot from an open artifact object. */\nexport function createArtifactSnapshot(\n  artifact: Workbook | Document | Presentation,\n): ArtifactSnapshot {\n  const state = requireCompositeState(artifact);\n  const native = state.native;\n  const common = {\n    schemaVersion: 1 as const,\n    runtimeTarget: native.target,\n    kernelVersion: native.buildIdentity,\n    stateHash: native.stateHash(),\n    snapshotBytes: Uint8Array.from(native.snapshot()),\n  };\n  if (state.modality === \"spreadsheet\") {\n    if (!(native instanceof NativeSpreadsheetSession)) {\n      throw new Error(\"Spreadsheet composite does not own a spreadsheet native session\");\n    }\n    return Object.freeze({\n      ...common,\n      modality: \"spreadsheet\" as const,\n      modelSchemaVersion: SPREADSHEET_ARTIFACT_MODEL_SCHEMA_VERSION,\n      snapshotVersion: SPREADSHEET_COLLABORATION_SNAPSHOT_VERSION,\n      coveredCausalFrontierBytes: Uint8Array.from(native.frontier()),\n      operationProtocolVersion: COMMITTED_TRANSACTION_PROTOCOL_VERSION,\n      crdtStateVersion: SPREADSHEET_COLLABORATION_SNAPSHOT_VERSION,\n    });\n  }\n  if (\n    !(native instanceof NativeDocumentSession) &&\n    !(native instanceof NativePresentationSession)\n  ) {\n    throw new Error(\"Serialized composite does not own its expected native session\");\n  }\n  const nativeRevision = safeNativeRevision(native.revision());\n  return state.modality === \"document\"\n    ? Object.freeze({\n        ...common,\n        modality: \"document\" as const,\n        modelSchemaVersion: DOCUMENT_ARTIFACT_MODEL_SCHEMA_VERSION,\n        snapshotVersion: DOCUMENT_ARTIFACT_SNAPSHOT_VERSION,\n        nativeRevision,\n      })\n    : Object.freeze({\n        ...common,\n        modality: \"presentation\" as const,\n        modelSchemaVersion: PRESENTATION_ARTIFACT_MODEL_SCHEMA_VERSION,\n        snapshotVersion: PRESENTATION_ARTIFACT_SNAPSHOT_VERSION,\n        nativeRevision,\n      });\n}\n\nfunction safeNativeRevision(value: bigint): number {\n  if (value < 0n || value > BigInt(Number.MAX_SAFE_INTEGER)) {\n    throw new RangeError(\"Artifact native revision exceeds the durable range\");\n  }\n  return Number(value);\n}\n"],"mappings":";;;;;;;;;;;;AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AA8CA,SAAS,uBACd,UACkB;AAClB,QAAM,QAAQ,sBAAsB,QAAQ;AAC5C,QAAM,SAAS,MAAM;AACrB,QAAM,SAAS;AAAA,IACb,eAAe;AAAA,IACf,eAAe,OAAO;AAAA,IACtB,eAAe,OAAO;AAAA,IACtB,WAAW,OAAO,UAAU;AAAA,IAC5B,eAAe,WAAW,KAAK,OAAO,SAAS,CAAC;AAAA,EAClD;AACA,MAAI,MAAM,aAAa,eAAe;AACpC,QAAI,EAAE,kBAAkB,2BAA2B;AACjD,YAAM,IAAI,MAAM,iEAAiE;AAAA,IACnF;AACA,WAAO,OAAO,OAAO;AAAA,MACnB,GAAG;AAAA,MACH,UAAU;AAAA,MACV,oBAAoB;AAAA,MACpB,iBAAiB;AAAA,MACjB,4BAA4B,WAAW,KAAK,OAAO,SAAS,CAAC;AAAA,MAC7D,0BAA0B;AAAA,MAC1B,kBAAkB;AAAA,IACpB,CAAC;AAAA,EACH;AACA,MACE,EAAE,kBAAkB,0BACpB,EAAE,kBAAkB,4BACpB;AACA,UAAM,IAAI,MAAM,+DAA+D;AAAA,EACjF;AACA,QAAM,iBAAiB,mBAAmB,OAAO,SAAS,CAAC;AAC3D,SAAO,MAAM,aAAa,aACtB,OAAO,OAAO;AAAA,IACZ,GAAG;AAAA,IACH,UAAU;AAAA,IACV,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,IACjB;AAAA,EACF,CAAC,IACD,OAAO,OAAO;AAAA,IACZ,GAAG;AAAA,IACH,UAAU;AAAA,IACV,oBAAoB;AAAA,IACpB,iBAAiB;AAAA,IACjB;AAAA,EACF,CAAC;AACP;AAEA,SAAS,mBAAmB,OAAuB;AACjD,MAAI,QAAQ,MAAM,QAAQ,OAAO,OAAO,gBAAgB,GAAG;AACzD,UAAM,IAAI,WAAW,oDAAoD;AAAA,EAC3E;AACA,SAAO,OAAO,KAAK;AACrB;","names":[]}

package/dist/spreadsheet-xlsx-codec.js

@@ -1,8 +1,8 @@
 import {
   SpreadsheetXlsxCodec
-} from "./chunk-QZI5POCC.js";
+} from "./chunk-OVXX4G35.js";
 import "./chunk-J6N7IR44.js";
-import "./chunk-XT2EJFCU.js";
+import "./chunk-SYFNJGH5.js";
 import "./chunk-4FRFNNBM.js";
 import "./chunk-FGZM4FQ6.js";
 import "./chunk-72SYDU4O.js";

package/dist/spreadsheet.js

@@ -26,7 +26,7 @@ import {
   Worksheet,
   WorksheetCollection,
   validateSerializedWorkbook
-} from "./chunk-XT2EJFCU.js";
+} from "./chunk-SYFNJGH5.js";
 import {
   InvalidSpreadsheetImageError
 } from "./chunk-4FRFNNBM.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/artifact-tool",
-  "version": "0.2.8",
+  "version": "0.3.4-canary.0",
   "description": "OpenGeni-owned document, spreadsheet, and presentation engine with skill-compatible authoring APIs.",
   "license": "Apache-2.0",
   "repository": {
@@ -104,18 +104,18 @@
     "bench": "bun bench/run.ts",
     "bench:deep": "bun bench/run.ts --deep",
     "bench:release": "bun bench/release.ts",
-    "test:kernel": "cargo test --manifest-path kernel/Cargo.toml",
+    "test:kernel": "bun ../../scripts/artifact-kernel-rust.ts cargo test --manifest-path kernel/Cargo.toml",
     "test:kernel-packages": "bun ../../scripts/test-artifact-kernel-package-consumers.ts",
     "test:production-native": "bun ../../scripts/run-artifact-native-tests.ts",
-    "bench:kernel": "cargo bench --manifest-path kernel/Cargo.toml --bench kernel",
+    "bench:kernel": "bun ../../scripts/artifact-kernel-rust.ts cargo bench --manifest-path kernel/Cargo.toml --bench kernel",
     "test:perf": "bun test --timeout 30000 test/perf",
-    "fuzz:check": "cargo check --manifest-path kernel/fuzz/Cargo.toml",
+    "fuzz:check": "bun ../../scripts/artifact-kernel-rust.ts cargo check --manifest-path kernel/fuzz/Cargo.toml",
     "fuzz:smoke": "bun kernel/fuzz/smoke.ts",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "bash ../../scripts/prepublish-guard"
   },
   "dependencies": {
-    "@opengeni/contracts": "^0.50.0",
+    "@opengeni/contracts": "^2.2.0-canary.0",
     "@resvg/resvg-js": "^2.6.2",
     "docx": "9.7.1",
     "exceljs": "^4.4.0",

package/src/kernel.ts

@@ -1,4 +1,4 @@
-import { ArtifactLimitError, UnsupportedArtifactFeatureError } from "./errors";
+import { UnsupportedArtifactFeatureError } from "./errors";
 import { FileBlob } from "./file-blob";
 
 export type ArtifactModality = "spreadsheet" | "presentation" | "document";
@@ -124,402 +124,6 @@ export class ArtifactKernelRegistry {
   }
 }
 
-export const ARTIFACT_OPERATION_MAX_BYTES = 1024 * 1024;
-export const ARTIFACT_OPERATION_MAX_COMMANDS = 10_000;
-export const ARTIFACT_OPERATION_MAX_VECTOR_ACTORS = 1_024;
-export const ARTIFACT_OPERATION_MAX_STRING_BYTES = 256 * 1024;
-export const ARTIFACT_OPERATION_MAX_JSON_DEPTH = 64;
-export const ARTIFACT_OPERATION_MAX_JSON_NODES = 100_000;
-const OPERATION_MAGIC = new Uint8Array([0x4f, 0x47, 0x41, 0x52]); // OGAR
-const textEncoder = new TextEncoder();
-const textDecoder = new TextDecoder("utf-8", { fatal: true });
-
-/**
- * Deterministic codec retained only for historical TypeScript conformance
- * fixtures.
- *
- * @deprecated OGAR duplicates authored identity/causality and must never be
- * persisted, submitted, or lowered by a production runtime. Use the canonical
- * OGATX001 envelope with an identity-free OGASC001 command payload from
- * `@opengeni/contracts/editable-artifacts`.
- */
-export const ArtifactCommandBatchCodec = {
-  encode(batch: ArtifactCommandBatch): Uint8Array {
-    validateBatch(batch);
-    const writer = new BinaryWriter(ARTIFACT_OPERATION_MAX_BYTES);
-    writer.bytes(OPERATION_MAGIC);
-    writer.varint(batch.schemaVersion);
-    writer.varint(modalityCode(batch.modality));
-    writer.string(batch.artifactId);
-    writer.string(batch.transactionId);
-    writer.string(batch.actorId);
-    writer.varint(batch.baseSequence);
-    const vector = Object.entries(batch.baseVector).sort(([left], [right]) =>
-      left < right ? -1 : left > right ? 1 : 0,
-    );
-    writer.varint(vector.length);
-    for (const [actor, counter] of vector) {
-      writer.string(actor);
-      writer.varint(counter);
-    }
-    writer.varint(batch.commands.length);
-    for (const command of batch.commands) {
-      writer.string(command.code);
-      writer.string(command.targetId ?? "");
-      let flags = 0;
-      if (command.precondition?.objectRevision !== undefined) flags |= 1;
-      if (command.precondition?.exists !== undefined) flags |= 2;
-      if (command.payload !== undefined) flags |= 4;
-      writer.byte(flags);
-      if ((flags & 1) !== 0) writer.varint(command.precondition!.objectRevision!);
-      if ((flags & 2) !== 0) writer.byte(command.precondition!.exists ? 1 : 0);
-      if ((flags & 4) !== 0) writer.string(canonicalJson(command.payload));
-    }
-    return writer.finish();
-  },
-
-  decode(bytes: Uint8Array): ArtifactCommandBatch {
-    if (bytes.byteLength > ARTIFACT_OPERATION_MAX_BYTES) {
-      throw new ArtifactLimitError(
-        "operation bytes",
-        bytes.byteLength,
-        ARTIFACT_OPERATION_MAX_BYTES,
-      );
-    }
-    const reader = new BinaryReader(bytes);
-    const magic = reader.bytes(OPERATION_MAGIC.length);
-    if (!magic.every((value, index) => value === OPERATION_MAGIC[index])) {
-      throw new Error("Invalid artifact operation magic");
-    }
-    const schemaVersion = reader.varint();
-    if (schemaVersion !== 1)
-      throw new Error(`Unsupported artifact operation schema: ${schemaVersion}`);
-    const modality = modalityFromCode(reader.varint());
-    const artifactId = reader.string();
-    const transactionId = reader.string();
-    const actorId = reader.string();
-    const baseSequence = reader.varint();
-    const vectorCount = reader.varint();
-    if (vectorCount > ARTIFACT_OPERATION_MAX_VECTOR_ACTORS) {
-      throw new ArtifactLimitError(
-        "causal vector actors",
-        vectorCount,
-        ARTIFACT_OPERATION_MAX_VECTOR_ACTORS,
-      );
-    }
-    const vectorEntries: Array<readonly [string, number]> = [];
-    let previousActor = "";
-    for (let index = 0; index < vectorCount; index += 1) {
-      const actor = reader.string();
-      if (actor <= previousActor) {
-        throw new Error("Causal vector actors must be unique and sorted");
-      }
-      previousActor = actor;
-      vectorEntries.push([actor, reader.varint()]);
-    }
-    // Object.fromEntries defines data properties instead of invoking the legacy
-    // `__proto__` setter. Actor identifiers therefore round-trip without
-    // mutating the vector object's prototype or silently losing an entry.
-    const baseVector = Object.fromEntries(vectorEntries);
-    const commandCount = reader.varint();
-    if (commandCount > ARTIFACT_OPERATION_MAX_COMMANDS) {
-      throw new ArtifactLimitError(
-        "operation commands",
-        commandCount,
-        ARTIFACT_OPERATION_MAX_COMMANDS,
-      );
-    }
-    const commands: ArtifactCommand[] = [];
-    for (let index = 0; index < commandCount; index += 1) {
-      const code = reader.string();
-      const targetId = reader.string();
-      const flags = reader.byte();
-      if ((flags & ~7) !== 0) throw new Error("Unknown artifact command flags");
-      const objectRevision = (flags & 1) !== 0 ? reader.varint() : undefined;
-      let exists: boolean | undefined;
-      if ((flags & 2) !== 0) {
-        const encodedExists = reader.byte();
-        if (encodedExists > 1) {
-          throw new Error("Artifact command boolean uses a non-canonical encoding");
-        }
-        exists = encodedExists === 1;
-      }
-      const payload = (flags & 4) !== 0 ? parseCanonicalJson(reader.string()) : undefined;
-      commands.push({
-        code,
-        ...(targetId ? { targetId } : {}),
-        ...(objectRevision !== undefined || exists !== undefined
-          ? {
-              precondition: {
-                ...(objectRevision !== undefined ? { objectRevision } : {}),
-                ...(exists !== undefined ? { exists } : {}),
-              },
-            }
-          : {}),
-        ...(payload !== undefined ? { payload } : {}),
-      });
-    }
-    reader.done();
-    const batch: ArtifactCommandBatch = {
-      schemaVersion: 1,
-      artifactId,
-      modality,
-      transactionId,
-      actorId,
-      baseSequence,
-      baseVector,
-      commands,
-    };
-    validateBatch(batch);
-    return batch;
-  },
-};
-
-function validateBatch(batch: ArtifactCommandBatch): void {
-  if (batch.schemaVersion !== 1) throw new Error("Artifact operation schema must be 1");
-  for (const [label, value] of [
-    ["artifactId", batch.artifactId],
-    ["transactionId", batch.transactionId],
-    ["actorId", batch.actorId],
-  ] as const) {
-    if (!value || value.length > 512) throw new Error(`${label} must contain 1-512 characters`);
-  }
-  assertSafeInteger(batch.baseSequence, "baseSequence");
-  const vector = Object.entries(batch.baseVector);
-  if (vector.length > ARTIFACT_OPERATION_MAX_VECTOR_ACTORS) {
-    throw new ArtifactLimitError(
-      "causal vector actors",
-      vector.length,
-      ARTIFACT_OPERATION_MAX_VECTOR_ACTORS,
-    );
-  }
-  for (const [actor, counter] of vector) {
-    if (!actor || actor.length > 512)
-      throw new Error("Causal vector actor must contain 1-512 characters");
-    assertSafeInteger(counter, `baseVector.${actor}`);
-  }
-  if (batch.commands.length > ARTIFACT_OPERATION_MAX_COMMANDS) {
-    throw new ArtifactLimitError(
-      "operation commands",
-      batch.commands.length,
-      ARTIFACT_OPERATION_MAX_COMMANDS,
-    );
-  }
-  if (batch.commands.length === 0) throw new Error("Artifact command batch must not be empty");
-  for (const command of batch.commands) {
-    if (!/^[a-z][a-z0-9_.-]{0,127}$/.test(command.code))
-      throw new Error(`Invalid artifact command code: ${command.code}`);
-    if (
-      command.targetId !== undefined &&
-      (command.targetId.length === 0 || command.targetId.length > 512)
-    ) {
-      throw new Error("Artifact command target id must contain 1-512 characters");
-    }
-    if (command.precondition?.objectRevision !== undefined) {
-      assertSafeInteger(command.precondition.objectRevision, "objectRevision");
-    }
-  }
-}
-
 function defaultKernelOrder(): readonly ArtifactKernelKind[] {
   return typeof window === "undefined" ? ["native"] : [];
 }
-
-function modalityCode(modality: ArtifactModality): number {
-  return { spreadsheet: 1, presentation: 2, document: 3 }[modality];
-}
-
-function modalityFromCode(value: number): ArtifactModality {
-  if (value === 1) return "spreadsheet";
-  if (value === 2) return "presentation";
-  if (value === 3) return "document";
-  throw new Error(`Unknown artifact modality code: ${value}`);
-}
-
-function assertSafeInteger(value: number, label: string): void {
-  if (!Number.isSafeInteger(value) || value < 0)
-    throw new Error(`${label} must be a non-negative safe integer`);
-}
-
-function canonicalJson(value: unknown): string {
-  return JSON.stringify(canonicalValue(value, { nodes: 0 }, 0));
-}
-
-function canonicalValue(value: unknown, state: { nodes: number }, depth: number): unknown {
-  state.nodes += 1;
-  if (state.nodes > ARTIFACT_OPERATION_MAX_JSON_NODES) {
-    throw new ArtifactLimitError(
-      "operation JSON nodes",
-      state.nodes,
-      ARTIFACT_OPERATION_MAX_JSON_NODES,
-    );
-  }
-  if (depth > ARTIFACT_OPERATION_MAX_JSON_DEPTH) {
-    throw new ArtifactLimitError("operation JSON depth", depth, ARTIFACT_OPERATION_MAX_JSON_DEPTH);
-  }
-  if (value === null || typeof value === "string" || typeof value === "boolean") return value;
-  if (typeof value === "number") {
-    if (!Number.isFinite(value))
-      throw new Error("Artifact command JSON cannot contain non-finite numbers");
-    return Object.is(value, -0) ? 0 : value;
-  }
-  if (Array.isArray(value)) {
-    if (Object.keys(value).length !== value.length || Object.getOwnPropertySymbols(value).length) {
-      throw new Error("Artifact command payload arrays must be dense JSON arrays");
-    }
-    const output: unknown[] = [];
-    for (let index = 0; index < value.length; index += 1) {
-      const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
-      if (!descriptor || !("value" in descriptor) || !descriptor.enumerable) {
-        throw new Error("Artifact command payload arrays must contain data properties");
-      }
-      output.push(canonicalValue(descriptor.value, state, depth + 1));
-    }
-    return output;
-  }
-  if (typeof value === "object") {
-    if (Object.getPrototypeOf(value) !== Object.prototype)
-      throw new Error("Artifact command payload must be plain JSON");
-    const record = value as Record<string, unknown>;
-    const keys = Reflect.ownKeys(record);
-    if (keys.some((key) => typeof key !== "string")) {
-      throw new Error("Artifact command payload cannot contain symbol properties");
-    }
-    return Object.fromEntries(
-      (keys as string[]).sort().map((key) => {
-        const descriptor = Object.getOwnPropertyDescriptor(record, key);
-        if (!descriptor || !("value" in descriptor) || !descriptor.enumerable) {
-          throw new Error("Artifact command payload properties must be enumerable data properties");
-        }
-        return [key, canonicalValue(descriptor.value, state, depth + 1)];
-      }),
-    );
-  }
-  throw new Error(`Artifact command payload contains unsupported ${typeof value}`);
-}
-
-function parseCanonicalJson(value: string): unknown {
-  const parsed: unknown = JSON.parse(value);
-  if (canonicalJson(parsed) !== value)
-    throw new Error("Artifact command payload is not canonical JSON");
-  return parsed;
-}
-
-class BinaryWriter {
-  private buffer = new Uint8Array(1_024);
-  private length = 0;
-  constructor(private readonly maximum: number) {}
-
-  byte(value: number): void {
-    this.ensure(1);
-    this.buffer[this.length++] = value;
-  }
-
-  bytes(value: Uint8Array): void {
-    this.ensure(value.byteLength);
-    this.buffer.set(value, this.length);
-    this.length += value.byteLength;
-  }
-
-  varint(value: number): void {
-    assertSafeInteger(value, "varint");
-    let remaining = BigInt(value);
-    do {
-      let byte = Number(remaining & 0x7fn);
-      remaining >>= 7n;
-      if (remaining > 0n) byte |= 0x80;
-      this.byte(byte);
-    } while (remaining > 0n);
-  }
-
-  string(value: string): void {
-    const bytes = textEncoder.encode(value);
-    if (bytes.byteLength > ARTIFACT_OPERATION_MAX_STRING_BYTES) {
-      throw new ArtifactLimitError(
-        "operation string bytes",
-        bytes.byteLength,
-        ARTIFACT_OPERATION_MAX_STRING_BYTES,
-      );
-    }
-    this.varint(bytes.byteLength);
-    this.bytes(bytes);
-  }
-
-  finish(): Uint8Array {
-    return this.buffer.slice(0, this.length);
-  }
-
-  private ensure(extra: number): void {
-    const required = this.length + extra;
-    if (required > this.maximum)
-      throw new ArtifactLimitError("operation bytes", required, this.maximum);
-    if (required <= this.buffer.byteLength) return;
-    let nextSize = this.buffer.byteLength;
-    while (nextSize < required) nextSize = Math.min(this.maximum, nextSize * 2);
-    const next = new Uint8Array(nextSize);
-    next.set(this.buffer);
-    this.buffer = next;
-  }
-}
-
-class BinaryReader {
-  private offset = 0;
-  constructor(private readonly input: Uint8Array) {}
-
-  byte(): number {
-    const value = this.input[this.offset];
-    if (value === undefined) throw new Error("Truncated artifact operation");
-    this.offset += 1;
-    return value;
-  }
-
-  bytes(length: number): Uint8Array {
-    if (
-      !Number.isSafeInteger(length) ||
-      length < 0 ||
-      this.offset + length > this.input.byteLength
-    ) {
-      throw new Error("Truncated artifact operation bytes");
-    }
-    const value = this.input.subarray(this.offset, this.offset + length);
-    this.offset += length;
-    return value;
-  }
-
-  varint(): number {
-    let value = 0n;
-    let shift = 0n;
-    for (let index = 0; index < 10; index += 1) {
-      const byte = this.byte();
-      value |= BigInt(byte & 0x7f) << shift;
-      if ((byte & 0x80) === 0) {
-        if (index > 0 && byte === 0) {
-          throw new Error("Artifact operation varint is non-canonical");
-        }
-        const number = Number(value);
-        if (!Number.isSafeInteger(number))
-          throw new Error("Artifact operation varint exceeds safe integer");
-        return number;
-      }
-      shift += 7n;
-    }
-    throw new Error("Invalid artifact operation varint");
-  }
-
-  string(): string {
-    const length = this.varint();
-    if (length > ARTIFACT_OPERATION_MAX_STRING_BYTES) {
-      throw new ArtifactLimitError(
-        "operation string bytes",
-        length,
-        ARTIFACT_OPERATION_MAX_STRING_BYTES,
-      );
-    }
-    return textDecoder.decode(this.bytes(length));
-  }
-
-  done(): void {
-    if (this.offset !== this.input.byteLength)
-      throw new Error("Artifact operation has trailing bytes");
-  }
-}

package/src/materializer-cli.ts

@@ -13,6 +13,11 @@ import {
   type SpreadsheetArtifactProjectedCellValue,
   type SpreadsheetArtifactFormulaError,
 } from "@opengeni/contracts/editable-artifacts";
+import {
+  COMMITTED_TRANSACTION_PROTOCOL_VERSION,
+  SPREADSHEET_ARTIFACT_MODEL_SCHEMA_VERSION,
+  SPREADSHEET_COLLABORATION_SNAPSHOT_VERSION,
+} from "@opengeni/contracts/editable-artifact-versions";
 
 import { NativeSpreadsheetSession } from "./native";
 import { SpreadsheetXlsxCodec } from "./spreadsheet-xlsx-codec";
@@ -46,9 +51,9 @@ export type EditableArtifactNativeMaterializerCapabilities = Readonly<{
   fontRegistryHash: string;
   policyHash: string;
   maxOutputBytes: number;
-  supportedModelSchemaVersions: readonly [1];
-  supportedOperationProtocolVersions: readonly [1];
-  supportedSnapshotProtocolVersions: readonly [1];
+  supportedModelSchemaVersions: readonly [typeof SPREADSHEET_ARTIFACT_MODEL_SCHEMA_VERSION];
+  supportedOperationProtocolVersions: readonly [typeof COMMITTED_TRANSACTION_PROTOCOL_VERSION];
+  supportedSnapshotProtocolVersions: readonly [typeof SPREADSHEET_COLLABORATION_SNAPSHOT_VERSION];
 }>;
 
 type MaterializationManifest = Readonly<{
@@ -467,9 +472,15 @@ export function editableArtifactMaterializerCapabilitiesForRuntime(
     fontRegistryHash: EMPTY_FONT_REGISTRY_HASH,
     policyHash: POLICY_HASH,
     maxOutputBytes: MAX_OUTPUT_BYTES,
-    supportedModelSchemaVersions: Object.freeze([1] as const),
-    supportedOperationProtocolVersions: Object.freeze([1] as const),
-    supportedSnapshotProtocolVersions: Object.freeze([1] as const),
+    supportedModelSchemaVersions: Object.freeze([
+      SPREADSHEET_ARTIFACT_MODEL_SCHEMA_VERSION,
+    ] as const),
+    supportedOperationProtocolVersions: Object.freeze([
+      COMMITTED_TRANSACTION_PROTOCOL_VERSION,
+    ] as const),
+    supportedSnapshotProtocolVersions: Object.freeze([
+      SPREADSHEET_COLLABORATION_SNAPSHOT_VERSION,
+    ] as const),
   });
 }
 
@@ -478,9 +489,9 @@ function assertManifestCompatibility(
   capabilities: EditableArtifactNativeMaterializerCapabilities,
 ): void {
   if (
-    manifest.modelSchemaVersion !== 1 ||
-    manifest.operationProtocolVersion !== 1 ||
-    manifest.snapshotProtocolVersion !== 1 ||
+    manifest.modelSchemaVersion !== SPREADSHEET_ARTIFACT_MODEL_SCHEMA_VERSION ||
+    manifest.operationProtocolVersion !== COMMITTED_TRANSACTION_PROTOCOL_VERSION ||
+    manifest.snapshotProtocolVersion !== SPREADSHEET_COLLABORATION_SNAPSHOT_VERSION ||
     manifest.kernelVersion !== capabilities.kernelVersion ||
     manifest.codecVersion !==
       (capabilities.codecVersions as Readonly<Record<string, string>>)[manifest.codecId] ||

package/src/native.ts

@@ -1,5 +1,6 @@
 import {
   EDITABLE_ARTIFACT_INTENT_VERSION,
+  EDITABLE_ARTIFACT_INTENT_PROTOCOL_VERSION,
   SPREADSHEET_ARTIFACT_COMMAND_VERSION,
   assertCanonicalSpreadsheetArtifactCommandBytes,
   decodeEditableArtifactMutationIntent,
@@ -9,6 +10,7 @@ import {
   type EditableArtifactMutationIntent,
   type SpreadsheetArtifactCommandBatch,
 } from "@opengeni/contracts/editable-artifacts";
+import { SPREADSHEET_ARTIFACT_MODEL_SCHEMA_VERSION } from "@opengeni/contracts/editable-artifact-versions";
 import {
   ArtifactCollaborationSession,
   ArtifactDocumentSession,
@@ -61,7 +63,7 @@ export type NativeSpreadsheetAuthoredTransaction = Readonly<{
   /** Exact canonical OGATX001 bytes passed to Rust. */
   intentBytes: Uint8Array;
   requestHash: string;
-  /** One whole canonical OGACO001 transaction returned by Rust. */
+  /** One whole canonical OGACO002 transaction returned by Rust. */
   committedTransactionBytes: Uint8Array;
 }>;
 
@@ -137,8 +139,8 @@ export class NativeSpreadsheetSession {
     const intentBytes = encodeEditableArtifactMutationIntent({
       ...input.intent,
       envelopeVersion: EDITABLE_ARTIFACT_INTENT_VERSION,
-      protocolVersion: 1,
-      modelSchemaVersion: 1,
+      protocolVersion: EDITABLE_ARTIFACT_INTENT_PROTOCOL_VERSION,
+      modelSchemaVersion: SPREADSHEET_ARTIFACT_MODEL_SCHEMA_VERSION,
       commandProtocolVersion: SPREADSHEET_ARTIFACT_COMMAND_VERSION,
       commandBytes,
     });
@@ -361,8 +363,8 @@ function assertSpreadsheetIntent(intentBytes: Uint8Array): void {
   const intent = decodeEditableArtifactMutationIntent(intentBytes);
   if (
     intent.envelopeVersion !== EDITABLE_ARTIFACT_INTENT_VERSION ||
-    intent.protocolVersion !== 1 ||
-    intent.modelSchemaVersion !== 1 ||
+    intent.protocolVersion !== EDITABLE_ARTIFACT_INTENT_PROTOCOL_VERSION ||
+    intent.modelSchemaVersion !== SPREADSHEET_ARTIFACT_MODEL_SCHEMA_VERSION ||
     intent.commandProtocolVersion !== SPREADSHEET_ARTIFACT_COMMAND_VERSION
   ) {
     throw new ArtifactRuntimeError(