@opengeni/artifact-tool 0.2.2

package/dist/chunk-NAG44K67.js

@@ -0,0 +1,549 @@
+import {
+  SpreadsheetXlsxCodec
+} from "./chunk-DCTLTNPW.js";
+import {
+  loadConfiguredArtifactKernelRuntime
+} from "./chunk-U5G2BKM2.js";
+import {
+  NativeSpreadsheetSession
+} from "./chunk-B2ZJRZDA.js";
+import {
+  Workbook
+} from "./chunk-IYFXZQ34.js";
+
+// src/materializer-cli.ts
+import { createHash } from "crypto";
+import { once } from "events";
+import {
+  SPREADSHEET_ARTIFACT_PROJECTION_MAX_BYTES,
+  SPREADSHEET_ARTIFACT_VIEWPORT_MAX_CELLS,
+  decodeSpreadsheetMetadataKernelProjection,
+  decodeSpreadsheetViewportKernelProjection,
+  encodeSpreadsheetMetadataKernelQuery,
+  encodeSpreadsheetViewportKernelQuery
+} from "@opengeni/contracts/editable-artifacts";
+var IDENTITY_ARGUMENT = "--opengeni-materializer-identity-v1";
+var MATERIALIZE_ARGUMENT = "--opengeni-materialize-v1";
+var VERIFY_ARGUMENT = "--opengeni-verify-materialization-v1";
+var INPUT_MAGIC = bytes("OGAMI001");
+var VERIFY_INPUT_MAGIC = bytes("OGAVI001");
+var OUTPUT_MAGIC = bytes("OGAMO001");
+var VERIFY_OUTPUT_MAGIC = bytes("OGAVO001");
+var ERROR_MAGIC = bytes("OGAME001");
+var MAX_METADATA_BYTES = 256 * 1024;
+var MAX_SOURCE_BYTES = 512 * 1024 * 1024;
+var MAX_OUTPUT_BYTES = 512 * 1024 * 1024;
+var MAX_PROJECTED_RECTANGLE_CELLS = 1e6;
+var VIEWPORT_EDGE = 128;
+var XLSX_CODEC_ID = "opengeni.xlsx";
+var EMPTY_FONT_REGISTRY_HASH = sha256(bytes("opengeni:no-font-registry:v1"));
+var POLICY_HASH = sha256(bytes("opengeni:materializer:xlsx-native-projection:v1"));
+async function runArtifactMaterializerCli(args, environment = process.env) {
+  if (args.length !== 1) throw new Error("unsupported materializer command");
+  const command = args[0];
+  if (command === IDENTITY_ARGUMENT) {
+    const capabilities = await loadCapabilities(environment);
+    process.stdout.write(JSON.stringify(capabilities));
+    return;
+  }
+  if (command === MATERIALIZE_ARGUMENT) {
+    try {
+      await materialize(environment);
+    } catch (error) {
+      if (!(error instanceof MaterializerCliError)) throw error;
+      await writeTypedError(error.code, error.diagnosticSubcode);
+    }
+    return;
+  }
+  if (command === VERIFY_ARGUMENT) {
+    try {
+      await verifyMaterialization(environment);
+    } catch (error) {
+      if (!(error instanceof MaterializerCliError)) throw error;
+      await writeTypedError(error.code, error.diagnosticSubcode);
+    }
+    return;
+  }
+  throw new Error("unsupported materializer command");
+}
+async function loadCapabilities(environment) {
+  const loaded = await loadRuntime(environment);
+  return editableArtifactMaterializerCapabilitiesForRuntime(
+    loaded.runtime,
+    loaded.location.artifactTool.packageVersion
+  );
+}
+async function materialize(environment) {
+  let manifest;
+  let source;
+  try {
+    const reader = new InputReader(process.stdin);
+    assertBytes(await reader.readExactly(INPUT_MAGIC.byteLength), INPUT_MAGIC, "input protocol");
+    const header = await reader.readExactly(12);
+    const headerView = new DataView(header.buffer, header.byteOffset, header.byteLength);
+    const metadataLength = headerView.getUint32(0, true);
+    const sourceLength = safeU64(headerView, 4, "source length");
+    if (metadataLength < 2 || metadataLength > MAX_METADATA_BYTES) throw invalidSource();
+    if (sourceLength <= 0 || sourceLength > MAX_SOURCE_BYTES) throw unsupported();
+    manifest = decodeManifest(await reader.readExactly(metadataLength));
+    if (sourceLength !== manifest.sourceByteSize) throw invalidSource();
+    source = await reader.readExactly(sourceLength);
+    await reader.assertEof();
+    if (sha256(source) !== manifest.sourceContentHash) throw invalidSource();
+  } catch (error) {
+    throw classifyInvalidSource(error, "input_framing");
+  }
+  const loaded = await loadRuntime(environment);
+  const capabilities = editableArtifactMaterializerCapabilitiesForRuntime(
+    loaded.runtime,
+    loaded.location.artifactTool.packageVersion
+  );
+  assertManifestCompatibility(manifest, capabilities);
+  if (manifest.modality !== "spreadsheet" || manifest.format !== "xlsx") throw unsupported();
+  const projected = projectSpreadsheet(loaded.runtime, source, manifest);
+  const outputBlob = await SpreadsheetXlsxCodec.exportXlsx(projected.workbook, {
+    unsupportedContent: "error",
+    fileName: "workbook.xlsx"
+  });
+  const output = new Uint8Array(await outputBlob.arrayBuffer());
+  if (output.byteLength <= 0 || output.byteLength > MAX_OUTPUT_BYTES) throw unsupported();
+  const imported = await SpreadsheetXlsxCodec.importXlsx(output, { unsupportedContent: "error" });
+  if (semanticHashForWorkbook(imported) !== projected.semanticHash) throw unsupported();
+  const metadata = canonicalBytes({
+    byteSize: output.byteLength,
+    codecId: manifest.codecId,
+    codecVersion: manifest.codecVersion,
+    contentHash: sha256(output),
+    fontRegistryHash: manifest.fontRegistryHash,
+    format: manifest.format,
+    headSequence: manifest.targetHeadSequence,
+    kernelVersion: manifest.kernelVersion,
+    mimeType: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    policyHash: manifest.policyHash,
+    protocol: "OGAMR001",
+    semanticHash: projected.semanticHash,
+    stateHash: manifest.stateHash
+  });
+  await writeFrame(OUTPUT_MAGIC, metadata, output);
+}
+async function verifyMaterialization(environment) {
+  const reader = new InputReader(process.stdin);
+  assertBytes(
+    await reader.readExactly(VERIFY_INPUT_MAGIC.byteLength),
+    VERIFY_INPUT_MAGIC,
+    "verification protocol"
+  );
+  const header = await reader.readExactly(12);
+  const view = new DataView(header.buffer, header.byteOffset, header.byteLength);
+  const metadataLength = view.getUint32(0, true);
+  const outputLength = safeU64(view, 4, "verification output length");
+  if (metadataLength < 2 || metadataLength > MAX_METADATA_BYTES) throw invalidSource();
+  if (outputLength <= 0 || outputLength > MAX_OUTPUT_BYTES) throw unsupported();
+  const metadata = decodeVerificationManifest(await reader.readExactly(metadataLength));
+  const output = await reader.readExactly(outputLength);
+  await reader.assertEof();
+  const loaded = await loadCapabilities(environment);
+  if (metadata.format !== "xlsx" || metadata.codecId !== XLSX_CODEC_ID || loaded.codecVersions[XLSX_CODEC_ID] !== metadata.codecVersion) {
+    throw unsupported();
+  }
+  let semanticHash;
+  try {
+    const imported = await SpreadsheetXlsxCodec.importXlsx(output, { unsupportedContent: "error" });
+    semanticHash = semanticHashForWorkbook(imported);
+  } catch {
+    throw invalidOutput();
+  }
+  if (semanticHash !== metadata.expectedSemanticHash) throw invalidOutput();
+  await writeFrame(
+    VERIFY_OUTPUT_MAGIC,
+    canonicalBytes({ protocol: "OGAVR001", semanticHash }),
+    new Uint8Array(0)
+  );
+}
+function projectSpreadsheet(runtime, source, manifest) {
+  let session;
+  try {
+    session = NativeSpreadsheetSession.open(runtime, source);
+  } catch {
+    throw invalidSource("snapshot_open");
+  }
+  try {
+    if (session.stateHash() !== manifest.stateHash) throw invalidSource("state_mismatch");
+    const metadataLimit = Math.min(
+      session.capabilities.maxQueryResponseBytes,
+      SPREADSHEET_ARTIFACT_PROJECTION_MAX_BYTES
+    );
+    const metadata = decodeSpreadsheetMetadataKernelProjection(
+      session.query(
+        encodeSpreadsheetMetadataKernelQuery({
+          maxSheets: Math.max(1, session.capabilities.maxMetadataSheets),
+          maxBytes: metadataLimit
+        })
+      ),
+      {
+        maxSheets: Math.max(1, session.capabilities.maxMetadataSheets),
+        maxBytes: metadataLimit
+      }
+    );
+    if (metadata.modeledFeatures.dimensions !== false || metadata.modeledFeatures.hidden !== false || metadata.modeledFeatures.merges !== false) {
+      throw unsupported();
+    }
+    let projectedRectangleCells = 0;
+    const semanticSheets = [];
+    for (const sheet of metadata.sheets) {
+      const cells = [];
+      if (sheet.usedBounds) {
+        const rows = sheet.usedBounds.endRow - sheet.usedBounds.startRow + 1;
+        const columns = sheet.usedBounds.endColumn - sheet.usedBounds.startColumn + 1;
+        const area = rows * columns;
+        if (!Number.isSafeInteger(area) || area <= 0) throw invalidSource();
+        projectedRectangleCells += area;
+        if (projectedRectangleCells > MAX_PROJECTED_RECTANGLE_CELLS) throw unsupported();
+        for (let row = sheet.usedBounds.startRow; row <= sheet.usedBounds.endRow; row += VIEWPORT_EDGE) {
+          const rowCount = Math.min(VIEWPORT_EDGE, sheet.usedBounds.endRow - row + 1);
+          for (let column = sheet.usedBounds.startColumn; column <= sheet.usedBounds.endColumn; column += VIEWPORT_EDGE) {
+            const columnCount = Math.min(VIEWPORT_EDGE, sheet.usedBounds.endColumn - column + 1);
+            const maxCells = rowCount * columnCount;
+            if (maxCells > SPREADSHEET_ARTIFACT_VIEWPORT_MAX_CELLS) throw unsupported();
+            const query = {
+              sheetId: sheet.sheetId,
+              startRow: row,
+              startColumn: column,
+              rowCount,
+              columnCount,
+              maxCells,
+              maxBytes: metadataLimit
+            };
+            const viewport = decodeSpreadsheetViewportKernelProjection(
+              session.query(encodeSpreadsheetViewportKernelQuery(query)),
+              query
+            );
+            for (const cell of viewport.cells) {
+              assertRepresentableValue(cell.value);
+              cells.push({
+                row: cell.row,
+                column: cell.column,
+                formula: cell.formula,
+                value: cell.value
+              });
+            }
+          }
+        }
+      }
+      cells.sort((left, right) => left.row - right.row || left.column - right.column);
+      semanticSheets.push({ name: sheet.name, cells });
+    }
+    const semantic = Object.freeze({ version: 1, sheets: semanticSheets });
+    const workbook = Workbook.fromJSON(toSerializedWorkbook(semantic));
+    const semanticHash = sha256(canonicalBytes(semantic));
+    if (semanticHashForWorkbook(workbook) !== semanticHash) throw unsupported();
+    return Object.freeze({ workbook, semanticHash });
+  } finally {
+    session.dispose();
+  }
+}
+function toSerializedWorkbook(semantic) {
+  return {
+    version: 1,
+    worksheets: semantic.sheets.map((sheet, index) => ({
+      id: `ws/native-${index + 1}`,
+      name: sheet.name,
+      showGridLines: true,
+      freezePanes: { rows: 0, columns: 0 },
+      cells: sheet.cells.map((cell) => ({
+        row: cell.row,
+        col: cell.column,
+        value: cell.formula ? null : hostValue(cell.value),
+        formula: cell.formula,
+        format: {}
+      })),
+      merges: [],
+      columnWidths: [],
+      rowHeights: [],
+      tables: [],
+      charts: [],
+      sparklines: [],
+      dataValidations: [],
+      conditionalFormattings: [],
+      images: []
+    })),
+    comments: []
+  };
+}
+function semanticHashForWorkbook(workbook) {
+  const sheets = workbook.worksheets.items.map((sheet) => {
+    const cells = [];
+    for (const { row, col, data } of sheet.cellEntries()) {
+      const value = data.formula ? workbook.valueAt(sheet, { row, col }) : data.value;
+      cells.push({
+        row,
+        column: col,
+        formula: data.formula,
+        value: semanticValue(value, data.formula !== null)
+      });
+    }
+    cells.sort((left, right) => left.row - right.row || left.column - right.column);
+    return { name: sheet.name, cells };
+  });
+  return sha256(canonicalBytes({ version: 1, sheets }));
+}
+function semanticValue(value, formula) {
+  if (value === null || value === void 0) return { kind: "empty" };
+  if (typeof value === "boolean") return { kind: "boolean", value };
+  if (typeof value === "number" && Number.isFinite(value)) return { kind: "number", value };
+  if (value instanceof Date) {
+    const milliseconds = Date.prototype.getTime.call(value);
+    if (!Number.isSafeInteger(milliseconds)) throw unsupported();
+    return { kind: "date", value: new Date(milliseconds).toISOString() };
+  }
+  if (typeof value === "string") {
+    if (formula) {
+      const error = FORMULA_ERROR_TO_NATIVE[value];
+      if (error) return { kind: "error", value: error };
+      if (value === "#CYCLE!") return { kind: "error", value: { custom: value } };
+    }
+    return { kind: "text", value };
+  }
+  throw unsupported();
+}
+function hostValue(value) {
+  switch (value.kind) {
+    case "empty":
+      return null;
+    case "boolean":
+    case "number":
+    case "text":
+      return value.value;
+    case "date":
+      return new Date(value.value);
+    case "error": {
+      if (typeof value.value === "object") return value.value.custom;
+      const projected = NATIVE_ERROR_TO_FORMULA[value.value];
+      if (!projected) throw unsupported();
+      return projected;
+    }
+  }
+}
+function assertRepresentableValue(value) {
+  hostValue(value);
+}
+var NATIVE_ERROR_TO_FORMULA = Object.freeze({
+  divide_by_zero: "#DIV/0!",
+  value: "#VALUE!",
+  reference: "#REF!",
+  name: "#NAME?",
+  number: "#NUM!",
+  not_available: "#N/A"
+});
+var FORMULA_ERROR_TO_NATIVE = Object.freeze({
+  "#DIV/0!": "divide_by_zero",
+  "#VALUE!": "value",
+  "#REF!": "reference",
+  "#NAME?": "name",
+  "#NUM!": "number",
+  "#N/A": "not_available"
+});
+function editableArtifactMaterializerCapabilitiesForRuntime(runtime, packageVersion) {
+  return Object.freeze({
+    protocol: "OGAMC001",
+    runtimeKind: "native",
+    runtimeTarget: runtime.target,
+    kernelVersion: runtime.buildIdentity,
+    codecVersions: Object.freeze({ [XLSX_CODEC_ID]: codecVersion(packageVersion) }),
+    fontRegistryHash: EMPTY_FONT_REGISTRY_HASH,
+    policyHash: POLICY_HASH,
+    maxOutputBytes: MAX_OUTPUT_BYTES,
+    supportedModelSchemaVersions: Object.freeze([1]),
+    supportedOperationProtocolVersions: Object.freeze([1]),
+    supportedSnapshotProtocolVersions: Object.freeze([1])
+  });
+}
+function assertManifestCompatibility(manifest, capabilities) {
+  if (manifest.modelSchemaVersion !== 1 || manifest.operationProtocolVersion !== 1 || manifest.snapshotProtocolVersion !== 1 || manifest.kernelVersion !== capabilities.kernelVersion || manifest.codecVersion !== capabilities.codecVersions[manifest.codecId] || manifest.fontRegistryHash !== capabilities.fontRegistryHash || manifest.policyHash !== capabilities.policyHash || Object.keys(manifest.normalizedOptions).length !== 0) {
+    throw incompatible();
+  }
+}
+function decodeManifest(value) {
+  const record = strictCanonicalRecord(value, [
+    "artifactId",
+    "codecId",
+    "codecVersion",
+    "fontRegistryHash",
+    "format",
+    "inputSnapshotId",
+    "jobId",
+    "kernelVersion",
+    "modality",
+    "modelSchemaVersion",
+    "normalizedOptions",
+    "operationProtocolVersion",
+    "optionsHash",
+    "policyHash",
+    "protocol",
+    "snapshotProtocolVersion",
+    "sourceByteSize",
+    "sourceContentHash",
+    "stateHash",
+    "targetHeadSequence",
+    "versionId"
+  ]);
+  if (record.protocol !== "OGAMJ001" || !positiveInteger(record.sourceByteSize) || !positiveInteger(record.targetHeadSequence) || !isHash(record.sourceContentHash) || !isHash(record.stateHash) || !isHash(record.optionsHash) || !isHash(record.fontRegistryHash) || !isHash(record.policyHash) || !plainRecord(record.normalizedOptions)) {
+    throw invalidSource();
+  }
+  return record;
+}
+function decodeVerificationManifest(value) {
+  const record = strictCanonicalRecord(value, [
+    "codecId",
+    "codecVersion",
+    "expectedSemanticHash",
+    "format",
+    "protocol"
+  ]);
+  if (record.protocol !== "OGAVJ001" || !isHash(record.expectedSemanticHash)) {
+    throw invalidSource();
+  }
+  return record;
+}
+function strictCanonicalRecord(value, keys) {
+  const text = new TextDecoder("utf-8", { fatal: true }).decode(value);
+  const parsed = JSON.parse(text);
+  if (!plainRecord(parsed) || JSON.stringify(parsed) !== text) throw invalidSource();
+  if (Object.keys(parsed).sort().join("\0") !== [...keys].sort().join("\0")) throw invalidSource();
+  return parsed;
+}
+async function writeTypedError(code, diagnosticSubcode) {
+  await writeFrame(
+    ERROR_MAGIC,
+    canonicalBytes({
+      code,
+      protocol: "OGAMERR1",
+      ...diagnosticSubcode ? { subcode: diagnosticSubcode } : {}
+    }),
+    new Uint8Array(0)
+  );
+}
+async function writeFrame(magic, metadata, payload) {
+  const header = new Uint8Array(12);
+  const view = new DataView(header.buffer);
+  view.setUint32(0, metadata.byteLength, true);
+  view.setBigUint64(4, BigInt(payload.byteLength), true);
+  await writeStdout(magic);
+  await writeStdout(header);
+  await writeStdout(metadata);
+  for (let offset = 0; offset < payload.byteLength; offset += 1024 * 1024) {
+    await writeStdout(payload.subarray(offset, Math.min(payload.byteLength, offset + 1024 * 1024)));
+  }
+}
+async function writeStdout(value) {
+  if (!process.stdout.write(value)) await once(process.stdout, "drain");
+}
+var InputReader = class {
+  #iterator;
+  #buffer = new Uint8Array(0);
+  #done = false;
+  constructor(stream) {
+    this.#iterator = stream[Symbol.asyncIterator]();
+  }
+  async readExactly(length) {
+    if (!Number.isSafeInteger(length) || length < 0 || length > MAX_SOURCE_BYTES)
+      throw invalidSource();
+    const result = new Uint8Array(length);
+    let offset = 0;
+    while (offset < length) {
+      if (this.#buffer.byteLength === 0) await this.#fill();
+      if (this.#buffer.byteLength === 0) throw invalidSource();
+      const count = Math.min(length - offset, this.#buffer.byteLength);
+      result.set(this.#buffer.subarray(0, count), offset);
+      this.#buffer = this.#buffer.subarray(count);
+      offset += count;
+    }
+    return result;
+  }
+  async assertEof() {
+    if (this.#buffer.byteLength > 0) throw invalidSource();
+    if (!this.#done) await this.#fill();
+    if (!this.#done || this.#buffer.byteLength > 0) throw invalidSource();
+  }
+  async #fill() {
+    const next = await this.#iterator.next();
+    if (next.done) {
+      this.#done = true;
+      return;
+    }
+    if (typeof next.value === "string") throw invalidSource();
+    this.#buffer = new Uint8Array(
+      next.value.buffer,
+      next.value.byteOffset,
+      next.value.byteLength
+    ).slice();
+  }
+};
+function codecVersion(packageVersion) {
+  return `xlsx-v1@${packageVersion}`;
+}
+function canonicalBytes(value) {
+  return bytes(JSON.stringify(value));
+}
+function bytes(value) {
+  return new TextEncoder().encode(value);
+}
+function sha256(value) {
+  return `sha256:${createHash("sha256").update(value).digest("hex")}`;
+}
+function safeU64(view, offset, label) {
+  const value = view.getBigUint64(offset, true);
+  if (value > BigInt(Number.MAX_SAFE_INTEGER)) throw new Error(`${label} exceeds safe integer`);
+  return Number(value);
+}
+function assertBytes(actual, expected, label) {
+  if (actual.byteLength !== expected.byteLength || !actual.every((byte, index) => byte === expected[index])) {
+    throw new Error(`${label} is invalid`);
+  }
+}
+function plainRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) && Object.getPrototypeOf(value) === Object.prototype;
+}
+function positiveInteger(value) {
+  return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+function isHash(value) {
+  return typeof value === "string" && /^sha256:[0-9a-f]{64}$/u.test(value);
+}
+var MaterializerCliError = class extends Error {
+  constructor(code, diagnosticSubcode) {
+    super(code);
+    this.diagnosticSubcode = diagnosticSubcode;
+    this.name = "MaterializerCliError";
+    this.code = code;
+  }
+  code;
+};
+function unsupported() {
+  return new MaterializerCliError("unsupported_semantics");
+}
+function invalidSource(diagnosticSubcode) {
+  return new MaterializerCliError("source_identity_mismatch", diagnosticSubcode);
+}
+function incompatible() {
+  return new MaterializerCliError("kernel_incompatible");
+}
+function invalidOutput() {
+  return new MaterializerCliError("output_verification_failed");
+}
+function classifyInvalidSource(error, diagnosticSubcode) {
+  return error instanceof MaterializerCliError && error.code === "source_identity_mismatch" ? invalidSource(error.diagnosticSubcode ?? diagnosticSubcode) : error;
+}
+async function loadRuntime(environment) {
+  try {
+    return await loadConfiguredArtifactKernelRuntime(environment);
+  } catch {
+    throw incompatible();
+  }
+}
+
+export {
+  runArtifactMaterializerCli,
+  editableArtifactMaterializerCapabilitiesForRuntime
+};
+//# sourceMappingURL=chunk-NAG44K67.js.map

package/dist/chunk-NAG44K67.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/materializer-cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { createHash } from \"node:crypto\";\nimport { once } from \"node:events\";\n\nimport {\n  SPREADSHEET_ARTIFACT_PROJECTION_MAX_BYTES,\n  SPREADSHEET_ARTIFACT_VIEWPORT_MAX_CELLS,\n  decodeSpreadsheetMetadataKernelProjection,\n  decodeSpreadsheetViewportKernelProjection,\n  encodeSpreadsheetMetadataKernelQuery,\n  encodeSpreadsheetViewportKernelQuery,\n  type SpreadsheetArtifactProjectedCellValue,\n  type SpreadsheetArtifactFormulaError,\n} from \"@opengeni/contracts/editable-artifacts\";\n\nimport { NativeSpreadsheetSession } from \"./native\";\nimport { SpreadsheetXlsxCodec } from \"./spreadsheet-xlsx-codec\";\nimport { Workbook, type SerializedWorkbook } from \"./spreadsheet\";\nimport { loadConfiguredArtifactKernelRuntime } from \"./runtime-development\";\nimport type { ArtifactKernelRuntime } from \"./runtime\";\n\nconst IDENTITY_ARGUMENT = \"--opengeni-materializer-identity-v1\";\nconst MATERIALIZE_ARGUMENT = \"--opengeni-materialize-v1\";\nconst VERIFY_ARGUMENT = \"--opengeni-verify-materialization-v1\";\nconst INPUT_MAGIC = bytes(\"OGAMI001\");\nconst VERIFY_INPUT_MAGIC = bytes(\"OGAVI001\");\nconst OUTPUT_MAGIC = bytes(\"OGAMO001\");\nconst VERIFY_OUTPUT_MAGIC = bytes(\"OGAVO001\");\nconst ERROR_MAGIC = bytes(\"OGAME001\");\nconst MAX_METADATA_BYTES = 256 * 1024;\nconst MAX_SOURCE_BYTES = 512 * 1024 * 1024;\nconst MAX_OUTPUT_BYTES = 512 * 1024 * 1024;\nconst MAX_PROJECTED_RECTANGLE_CELLS = 1_000_000;\nconst VIEWPORT_EDGE = 128;\nconst XLSX_CODEC_ID = \"opengeni.xlsx\";\nconst EMPTY_FONT_REGISTRY_HASH = sha256(bytes(\"opengeni:no-font-registry:v1\"));\nconst POLICY_HASH = sha256(bytes(\"opengeni:materializer:xlsx-native-projection:v1\"));\n\nexport type EditableArtifactNativeMaterializerCapabilities = Readonly<{\n  protocol: \"OGAMC001\";\n  runtimeKind: \"native\";\n  runtimeTarget: string;\n  kernelVersion: string;\n  codecVersions: Readonly<Record<typeof XLSX_CODEC_ID, string>>;\n  fontRegistryHash: string;\n  policyHash: string;\n  maxOutputBytes: number;\n  supportedModelSchemaVersions: readonly [1];\n  supportedOperationProtocolVersions: readonly [1];\n  supportedSnapshotProtocolVersions: readonly [1];\n}>;\n\ntype MaterializationManifest = Readonly<{\n  protocol: \"OGAMJ001\";\n  artifactId: string;\n  jobId: string;\n  versionId: string;\n  modality: \"spreadsheet\" | \"document\" | \"presentation\";\n  inputSnapshotId: string;\n  targetHeadSequence: number;\n  stateHash: string;\n  sourceByteSize: number;\n  sourceContentHash: string;\n  modelSchemaVersion: number;\n  operationProtocolVersion: number;\n  snapshotProtocolVersion: number;\n  format: \"xlsx\" | \"pptx\" | \"docx\" | \"pdf\" | \"png\" | \"webp\";\n  codecId: string;\n  normalizedOptions: Readonly<Record<string, never>>;\n  optionsHash: string;\n  codecVersion: string;\n  kernelVersion: string;\n  fontRegistryHash: string;\n  policyHash: string;\n}>;\n\ntype SemanticCell = Readonly<{\n  row: number;\n  column: number;\n  formula: string | null;\n  value: SpreadsheetArtifactProjectedCellValue;\n}>;\n\ntype SemanticWorkbook = Readonly<{\n  version: 1;\n  sheets: readonly Readonly<{ name: string; cells: readonly SemanticCell[] }>[];\n}>;\n\ntype ProjectedWorkbook = Readonly<{\n  workbook: Workbook;\n  semanticHash: string;\n}>;\n\ntype NativeSourceDiagnosticSubcode = \"input_framing\" | \"snapshot_open\" | \"state_mismatch\";\n\nexport async function runArtifactMaterializerCli(\n  args: readonly string[],\n  environment: Readonly<Record<string, string | undefined>> = process.env,\n): Promise<void> {\n  if (args.length !== 1) throw new Error(\"unsupported materializer command\");\n  const command = args[0];\n  if (command === IDENTITY_ARGUMENT) {\n    const capabilities = await loadCapabilities(environment);\n    process.stdout.write(JSON.stringify(capabilities));\n    return;\n  }\n  if (command === MATERIALIZE_ARGUMENT) {\n    try {\n      await materialize(environment);\n    } catch (error) {\n      if (!(error instanceof MaterializerCliError)) throw error;\n      await writeTypedError(error.code, error.diagnosticSubcode);\n    }\n    return;\n  }\n  if (command === VERIFY_ARGUMENT) {\n    try {\n      await verifyMaterialization(environment);\n    } catch (error) {\n      if (!(error instanceof MaterializerCliError)) throw error;\n      await writeTypedError(error.code, error.diagnosticSubcode);\n    }\n    return;\n  }\n  throw new Error(\"unsupported materializer command\");\n}\n\nasync function loadCapabilities(\n  environment: Readonly<Record<string, string | undefined>>,\n): Promise<EditableArtifactNativeMaterializerCapabilities> {\n  const loaded = await loadRuntime(environment);\n  return editableArtifactMaterializerCapabilitiesForRuntime(\n    loaded.runtime,\n    loaded.location.artifactTool.packageVersion,\n  );\n}\n\nasync function materialize(\n  environment: Readonly<Record<string, string | undefined>>,\n): Promise<void> {\n  let manifest: MaterializationManifest;\n  let source: Uint8Array;\n  try {\n    const reader = new InputReader(process.stdin);\n    assertBytes(await reader.readExactly(INPUT_MAGIC.byteLength), INPUT_MAGIC, \"input protocol\");\n    const header = await reader.readExactly(12);\n    const headerView = new DataView(header.buffer, header.byteOffset, header.byteLength);\n    const metadataLength = headerView.getUint32(0, true);\n    const sourceLength = safeU64(headerView, 4, \"source length\");\n    if (metadataLength < 2 || metadataLength > MAX_METADATA_BYTES) throw invalidSource();\n    if (sourceLength <= 0 || sourceLength > MAX_SOURCE_BYTES) throw unsupported();\n    manifest = decodeManifest(await reader.readExactly(metadataLength));\n    if (sourceLength !== manifest.sourceByteSize) throw invalidSource();\n    source = await reader.readExactly(sourceLength);\n    await reader.assertEof();\n    if (sha256(source) !== manifest.sourceContentHash) throw invalidSource();\n  } catch (error) {\n    throw classifyInvalidSource(error, \"input_framing\");\n  }\n\n  const loaded = await loadRuntime(environment);\n  const capabilities = editableArtifactMaterializerCapabilitiesForRuntime(\n    loaded.runtime,\n    loaded.location.artifactTool.packageVersion,\n  );\n  assertManifestCompatibility(manifest, capabilities);\n  if (manifest.modality !== \"spreadsheet\" || manifest.format !== \"xlsx\") throw unsupported();\n\n  const projected = projectSpreadsheet(loaded.runtime, source, manifest);\n  const outputBlob = await SpreadsheetXlsxCodec.exportXlsx(projected.workbook, {\n    unsupportedContent: \"error\",\n    fileName: \"workbook.xlsx\",\n  });\n  const output = new Uint8Array(await outputBlob.arrayBuffer());\n  if (output.byteLength <= 0 || output.byteLength > MAX_OUTPUT_BYTES) throw unsupported();\n  // Export/import equivalence is checked here for early failure and again by a\n  // distinct verifier process after immutable object publication.\n  const imported = await SpreadsheetXlsxCodec.importXlsx(output, { unsupportedContent: \"error\" });\n  if (semanticHashForWorkbook(imported) !== projected.semanticHash) throw unsupported();\n\n  const metadata = canonicalBytes({\n    byteSize: output.byteLength,\n    codecId: manifest.codecId,\n    codecVersion: manifest.codecVersion,\n    contentHash: sha256(output),\n    fontRegistryHash: manifest.fontRegistryHash,\n    format: manifest.format,\n    headSequence: manifest.targetHeadSequence,\n    kernelVersion: manifest.kernelVersion,\n    mimeType: \"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\",\n    policyHash: manifest.policyHash,\n    protocol: \"OGAMR001\",\n    semanticHash: projected.semanticHash,\n    stateHash: manifest.stateHash,\n  });\n  await writeFrame(OUTPUT_MAGIC, metadata, output);\n}\n\nasync function verifyMaterialization(\n  environment: Readonly<Record<string, string | undefined>>,\n): Promise<void> {\n  const reader = new InputReader(process.stdin);\n  assertBytes(\n    await reader.readExactly(VERIFY_INPUT_MAGIC.byteLength),\n    VERIFY_INPUT_MAGIC,\n    \"verification protocol\",\n  );\n  const header = await reader.readExactly(12);\n  const view = new DataView(header.buffer, header.byteOffset, header.byteLength);\n  const metadataLength = view.getUint32(0, true);\n  const outputLength = safeU64(view, 4, \"verification output length\");\n  if (metadataLength < 2 || metadataLength > MAX_METADATA_BYTES) throw invalidSource();\n  if (outputLength <= 0 || outputLength > MAX_OUTPUT_BYTES) throw unsupported();\n  const metadata = decodeVerificationManifest(await reader.readExactly(metadataLength));\n  const output = await reader.readExactly(outputLength);\n  await reader.assertEof();\n  const loaded = await loadCapabilities(environment);\n  if (\n    metadata.format !== \"xlsx\" ||\n    metadata.codecId !== XLSX_CODEC_ID ||\n    loaded.codecVersions[XLSX_CODEC_ID] !== metadata.codecVersion\n  ) {\n    throw unsupported();\n  }\n  let semanticHash: string;\n  try {\n    const imported = await SpreadsheetXlsxCodec.importXlsx(output, { unsupportedContent: \"error\" });\n    semanticHash = semanticHashForWorkbook(imported);\n  } catch {\n    throw invalidOutput();\n  }\n  if (semanticHash !== metadata.expectedSemanticHash) throw invalidOutput();\n  await writeFrame(\n    VERIFY_OUTPUT_MAGIC,\n    canonicalBytes({ protocol: \"OGAVR001\", semanticHash }),\n    new Uint8Array(0),\n  );\n}\n\nfunction projectSpreadsheet(\n  runtime: ArtifactKernelRuntime,\n  source: Uint8Array,\n  manifest: MaterializationManifest,\n): ProjectedWorkbook {\n  let session: NativeSpreadsheetSession;\n  try {\n    session = NativeSpreadsheetSession.open(runtime, source);\n  } catch {\n    throw invalidSource(\"snapshot_open\");\n  }\n  try {\n    if (session.stateHash() !== manifest.stateHash) throw invalidSource(\"state_mismatch\");\n    const metadataLimit = Math.min(\n      session.capabilities.maxQueryResponseBytes,\n      SPREADSHEET_ARTIFACT_PROJECTION_MAX_BYTES,\n    );\n    const metadata = decodeSpreadsheetMetadataKernelProjection(\n      session.query(\n        encodeSpreadsheetMetadataKernelQuery({\n          maxSheets: Math.max(1, session.capabilities.maxMetadataSheets),\n          maxBytes: metadataLimit,\n        }),\n      ),\n      {\n        maxSheets: Math.max(1, session.capabilities.maxMetadataSheets),\n        maxBytes: metadataLimit,\n      },\n    );\n    if (\n      metadata.modeledFeatures.dimensions !== false ||\n      metadata.modeledFeatures.hidden !== false ||\n      metadata.modeledFeatures.merges !== false\n    ) {\n      throw unsupported();\n    }\n    let projectedRectangleCells = 0;\n    const semanticSheets: Array<{ name: string; cells: SemanticCell[] }> = [];\n    for (const sheet of metadata.sheets) {\n      const cells: SemanticCell[] = [];\n      if (sheet.usedBounds) {\n        const rows = sheet.usedBounds.endRow - sheet.usedBounds.startRow + 1;\n        const columns = sheet.usedBounds.endColumn - sheet.usedBounds.startColumn + 1;\n        const area = rows * columns;\n        if (!Number.isSafeInteger(area) || area <= 0) throw invalidSource();\n        projectedRectangleCells += area;\n        if (projectedRectangleCells > MAX_PROJECTED_RECTANGLE_CELLS) throw unsupported();\n        for (\n          let row = sheet.usedBounds.startRow;\n          row <= sheet.usedBounds.endRow;\n          row += VIEWPORT_EDGE\n        ) {\n          const rowCount = Math.min(VIEWPORT_EDGE, sheet.usedBounds.endRow - row + 1);\n          for (\n            let column = sheet.usedBounds.startColumn;\n            column <= sheet.usedBounds.endColumn;\n            column += VIEWPORT_EDGE\n          ) {\n            const columnCount = Math.min(VIEWPORT_EDGE, sheet.usedBounds.endColumn - column + 1);\n            const maxCells = rowCount * columnCount;\n            if (maxCells > SPREADSHEET_ARTIFACT_VIEWPORT_MAX_CELLS) throw unsupported();\n            const query = {\n              sheetId: sheet.sheetId,\n              startRow: row,\n              startColumn: column,\n              rowCount,\n              columnCount,\n              maxCells,\n              maxBytes: metadataLimit,\n            } as const;\n            const viewport = decodeSpreadsheetViewportKernelProjection(\n              session.query(encodeSpreadsheetViewportKernelQuery(query)),\n              query,\n            );\n            for (const cell of viewport.cells) {\n              assertRepresentableValue(cell.value);\n              cells.push({\n                row: cell.row,\n                column: cell.column,\n                formula: cell.formula,\n                value: cell.value,\n              });\n            }\n          }\n        }\n      }\n      cells.sort((left, right) => left.row - right.row || left.column - right.column);\n      semanticSheets.push({ name: sheet.name, cells });\n    }\n    const semantic: SemanticWorkbook = Object.freeze({ version: 1, sheets: semanticSheets });\n    const workbook = Workbook.fromJSON(toSerializedWorkbook(semantic));\n    const semanticHash = sha256(canonicalBytes(semantic));\n    // Recalculation through the host projection must agree with every native\n    // formula result before the Office codec is allowed to run.\n    if (semanticHashForWorkbook(workbook) !== semanticHash) throw unsupported();\n    return Object.freeze({ workbook, semanticHash });\n  } finally {\n    session.dispose();\n  }\n}\n\nfunction toSerializedWorkbook(semantic: SemanticWorkbook): SerializedWorkbook {\n  return {\n    version: 1,\n    worksheets: semantic.sheets.map((sheet, index) => ({\n      id: `ws/native-${index + 1}`,\n      name: sheet.name,\n      showGridLines: true,\n      freezePanes: { rows: 0, columns: 0 },\n      cells: sheet.cells.map((cell) => ({\n        row: cell.row,\n        col: cell.column,\n        value: cell.formula ? null : hostValue(cell.value),\n        formula: cell.formula,\n        format: {},\n      })),\n      merges: [],\n      columnWidths: [],\n      rowHeights: [],\n      tables: [],\n      charts: [],\n      sparklines: [],\n      dataValidations: [],\n      conditionalFormattings: [],\n      images: [],\n    })),\n    comments: [],\n  } as SerializedWorkbook;\n}\n\nfunction semanticHashForWorkbook(workbook: Workbook): string {\n  const sheets = workbook.worksheets.items.map((sheet) => {\n    const cells: SemanticCell[] = [];\n    for (const { row, col, data } of sheet.cellEntries()) {\n      const value = data.formula ? workbook.valueAt(sheet, { row, col }) : data.value;\n      cells.push({\n        row,\n        column: col,\n        formula: data.formula,\n        value: semanticValue(value, data.formula !== null),\n      });\n    }\n    cells.sort((left, right) => left.row - right.row || left.column - right.column);\n    return { name: sheet.name, cells };\n  });\n  return sha256(canonicalBytes({ version: 1, sheets } satisfies SemanticWorkbook));\n}\n\nfunction semanticValue(value: unknown, formula: boolean): SpreadsheetArtifactProjectedCellValue {\n  if (value === null || value === undefined) return { kind: \"empty\" };\n  if (typeof value === \"boolean\") return { kind: \"boolean\", value };\n  if (typeof value === \"number\" && Number.isFinite(value)) return { kind: \"number\", value };\n  if (value instanceof Date) {\n    const milliseconds = Date.prototype.getTime.call(value);\n    if (!Number.isSafeInteger(milliseconds)) throw unsupported();\n    return { kind: \"date\", value: new Date(milliseconds).toISOString() };\n  }\n  if (typeof value === \"string\") {\n    if (formula) {\n      const error = FORMULA_ERROR_TO_NATIVE[value];\n      if (error) return { kind: \"error\", value: error };\n      if (value === \"#CYCLE!\") return { kind: \"error\", value: { custom: value } };\n    }\n    return { kind: \"text\", value };\n  }\n  throw unsupported();\n}\n\nfunction hostValue(\n  value: SpreadsheetArtifactProjectedCellValue,\n): string | number | boolean | Date | null {\n  switch (value.kind) {\n    case \"empty\":\n      return null;\n    case \"boolean\":\n    case \"number\":\n    case \"text\":\n      return value.value;\n    case \"date\":\n      return new Date(value.value);\n    case \"error\": {\n      if (typeof value.value === \"object\") return value.value.custom;\n      const projected = NATIVE_ERROR_TO_FORMULA[value.value];\n      if (!projected) throw unsupported();\n      return projected;\n    }\n  }\n}\n\nfunction assertRepresentableValue(value: SpreadsheetArtifactProjectedCellValue): void {\n  hostValue(value);\n}\n\nconst NATIVE_ERROR_TO_FORMULA: Readonly<Record<string, string>> = Object.freeze({\n  divide_by_zero: \"#DIV/0!\",\n  value: \"#VALUE!\",\n  reference: \"#REF!\",\n  name: \"#NAME?\",\n  number: \"#NUM!\",\n  not_available: \"#N/A\",\n});\nconst FORMULA_ERROR_TO_NATIVE: Readonly<Record<string, SpreadsheetArtifactFormulaError>> =\n  Object.freeze({\n    \"#DIV/0!\": \"divide_by_zero\",\n    \"#VALUE!\": \"value\",\n    \"#REF!\": \"reference\",\n    \"#NAME?\": \"name\",\n    \"#NUM!\": \"number\",\n    \"#N/A\": \"not_available\",\n  });\n\n/**\n * Exact producer profile derived from the same verified native runtime used by\n * the materializer child. The API uses this rather than accepting job identity\n * facts from clients.\n */\nexport function editableArtifactMaterializerCapabilitiesForRuntime(\n  runtime: ArtifactKernelRuntime,\n  packageVersion: string,\n): EditableArtifactNativeMaterializerCapabilities {\n  return Object.freeze({\n    protocol: \"OGAMC001\",\n    runtimeKind: \"native\",\n    runtimeTarget: runtime.target,\n    kernelVersion: runtime.buildIdentity,\n    codecVersions: Object.freeze({ [XLSX_CODEC_ID]: codecVersion(packageVersion) }),\n    fontRegistryHash: EMPTY_FONT_REGISTRY_HASH,\n    policyHash: POLICY_HASH,\n    maxOutputBytes: MAX_OUTPUT_BYTES,\n    supportedModelSchemaVersions: Object.freeze([1] as const),\n    supportedOperationProtocolVersions: Object.freeze([1] as const),\n    supportedSnapshotProtocolVersions: Object.freeze([1] as const),\n  });\n}\n\nfunction assertManifestCompatibility(\n  manifest: MaterializationManifest,\n  capabilities: EditableArtifactNativeMaterializerCapabilities,\n): void {\n  if (\n    manifest.modelSchemaVersion !== 1 ||\n    manifest.operationProtocolVersion !== 1 ||\n    manifest.snapshotProtocolVersion !== 1 ||\n    manifest.kernelVersion !== capabilities.kernelVersion ||\n    manifest.codecVersion !==\n      (capabilities.codecVersions as Readonly<Record<string, string>>)[manifest.codecId] ||\n    manifest.fontRegistryHash !== capabilities.fontRegistryHash ||\n    manifest.policyHash !== capabilities.policyHash ||\n    Object.keys(manifest.normalizedOptions).length !== 0\n  ) {\n    throw incompatible();\n  }\n}\n\nfunction decodeManifest(value: Uint8Array): MaterializationManifest {\n  const record = strictCanonicalRecord(value, [\n    \"artifactId\",\n    \"codecId\",\n    \"codecVersion\",\n    \"fontRegistryHash\",\n    \"format\",\n    \"inputSnapshotId\",\n    \"jobId\",\n    \"kernelVersion\",\n    \"modality\",\n    \"modelSchemaVersion\",\n    \"normalizedOptions\",\n    \"operationProtocolVersion\",\n    \"optionsHash\",\n    \"policyHash\",\n    \"protocol\",\n    \"snapshotProtocolVersion\",\n    \"sourceByteSize\",\n    \"sourceContentHash\",\n    \"stateHash\",\n    \"targetHeadSequence\",\n    \"versionId\",\n  ]);\n  if (\n    record.protocol !== \"OGAMJ001\" ||\n    !positiveInteger(record.sourceByteSize) ||\n    !positiveInteger(record.targetHeadSequence) ||\n    !isHash(record.sourceContentHash) ||\n    !isHash(record.stateHash) ||\n    !isHash(record.optionsHash) ||\n    !isHash(record.fontRegistryHash) ||\n    !isHash(record.policyHash) ||\n    !plainRecord(record.normalizedOptions)\n  ) {\n    throw invalidSource();\n  }\n  return record as MaterializationManifest;\n}\n\nfunction decodeVerificationManifest(value: Uint8Array): Readonly<{\n  protocol: \"OGAVJ001\";\n  format: string;\n  codecId: string;\n  codecVersion: string;\n  expectedSemanticHash: string;\n}> {\n  const record = strictCanonicalRecord(value, [\n    \"codecId\",\n    \"codecVersion\",\n    \"expectedSemanticHash\",\n    \"format\",\n    \"protocol\",\n  ]);\n  if (record.protocol !== \"OGAVJ001\" || !isHash(record.expectedSemanticHash)) {\n    throw invalidSource();\n  }\n  return record as never;\n}\n\nfunction strictCanonicalRecord(\n  value: Uint8Array,\n  keys: readonly string[],\n): Record<string, unknown> {\n  const text = new TextDecoder(\"utf-8\", { fatal: true }).decode(value);\n  const parsed = JSON.parse(text) as unknown;\n  if (!plainRecord(parsed) || JSON.stringify(parsed) !== text) throw invalidSource();\n  if (Object.keys(parsed).sort().join(\"\\0\") !== [...keys].sort().join(\"\\0\")) throw invalidSource();\n  return parsed;\n}\n\nasync function writeTypedError(\n  code: string,\n  diagnosticSubcode?: NativeSourceDiagnosticSubcode,\n): Promise<void> {\n  await writeFrame(\n    ERROR_MAGIC,\n    canonicalBytes({\n      code,\n      protocol: \"OGAMERR1\",\n      ...(diagnosticSubcode ? { subcode: diagnosticSubcode } : {}),\n    }),\n    new Uint8Array(0),\n  );\n}\n\nasync function writeFrame(\n  magic: Uint8Array,\n  metadata: Uint8Array,\n  payload: Uint8Array,\n): Promise<void> {\n  const header = new Uint8Array(12);\n  const view = new DataView(header.buffer);\n  view.setUint32(0, metadata.byteLength, true);\n  view.setBigUint64(4, BigInt(payload.byteLength), true);\n  await writeStdout(magic);\n  await writeStdout(header);\n  await writeStdout(metadata);\n  for (let offset = 0; offset < payload.byteLength; offset += 1024 * 1024) {\n    await writeStdout(payload.subarray(offset, Math.min(payload.byteLength, offset + 1024 * 1024)));\n  }\n}\n\nasync function writeStdout(value: Uint8Array): Promise<void> {\n  if (!process.stdout.write(value)) await once(process.stdout, \"drain\");\n}\n\nclass InputReader {\n  readonly #iterator: AsyncIterator<Buffer | string>;\n  #buffer = new Uint8Array(0);\n  #done = false;\n\n  constructor(stream: NodeJS.ReadableStream & AsyncIterable<Buffer | string>) {\n    this.#iterator = stream[Symbol.asyncIterator]();\n  }\n\n  async readExactly(length: number): Promise<Uint8Array> {\n    if (!Number.isSafeInteger(length) || length < 0 || length > MAX_SOURCE_BYTES)\n      throw invalidSource();\n    const result = new Uint8Array(length);\n    let offset = 0;\n    while (offset < length) {\n      if (this.#buffer.byteLength === 0) await this.#fill();\n      if (this.#buffer.byteLength === 0) throw invalidSource();\n      const count = Math.min(length - offset, this.#buffer.byteLength);\n      result.set(this.#buffer.subarray(0, count), offset);\n      this.#buffer = this.#buffer.subarray(count);\n      offset += count;\n    }\n    return result;\n  }\n\n  async assertEof(): Promise<void> {\n    if (this.#buffer.byteLength > 0) throw invalidSource();\n    if (!this.#done) await this.#fill();\n    if (!this.#done || this.#buffer.byteLength > 0) throw invalidSource();\n  }\n\n  async #fill(): Promise<void> {\n    const next = await this.#iterator.next();\n    if (next.done) {\n      this.#done = true;\n      return;\n    }\n    if (typeof next.value === \"string\") throw invalidSource();\n    this.#buffer = new Uint8Array(\n      next.value.buffer,\n      next.value.byteOffset,\n      next.value.byteLength,\n    ).slice();\n  }\n}\n\nfunction codecVersion(packageVersion: string): string {\n  return `xlsx-v1@${packageVersion}`;\n}\n\nfunction canonicalBytes(value: unknown): Uint8Array {\n  return bytes(JSON.stringify(value));\n}\n\nfunction bytes(value: string): Uint8Array {\n  return new TextEncoder().encode(value);\n}\n\nfunction sha256(value: Uint8Array): string {\n  return `sha256:${createHash(\"sha256\").update(value).digest(\"hex\")}`;\n}\n\nfunction safeU64(view: DataView, offset: number, label: string): number {\n  const value = view.getBigUint64(offset, true);\n  if (value > BigInt(Number.MAX_SAFE_INTEGER)) throw new Error(`${label} exceeds safe integer`);\n  return Number(value);\n}\n\nfunction assertBytes(actual: Uint8Array, expected: Uint8Array, label: string): void {\n  if (\n    actual.byteLength !== expected.byteLength ||\n    !actual.every((byte, index) => byte === expected[index])\n  ) {\n    throw new Error(`${label} is invalid`);\n  }\n}\n\nfunction plainRecord(value: unknown): value is Record<string, unknown> {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    !Array.isArray(value) &&\n    Object.getPrototypeOf(value) === Object.prototype\n  );\n}\n\nfunction positiveInteger(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value > 0;\n}\n\nfunction isHash(value: unknown): value is string {\n  return typeof value === \"string\" && /^sha256:[0-9a-f]{64}$/u.test(value);\n}\n\nclass MaterializerCliError extends Error {\n  readonly code:\n    | \"unsupported_semantics\"\n    | \"source_identity_mismatch\"\n    | \"kernel_incompatible\"\n    | \"output_verification_failed\";\n\n  constructor(\n    code: MaterializerCliError[\"code\"],\n    readonly diagnosticSubcode?: NativeSourceDiagnosticSubcode,\n  ) {\n    super(code);\n    this.name = \"MaterializerCliError\";\n    this.code = code;\n  }\n}\n\nfunction unsupported(): MaterializerCliError {\n  return new MaterializerCliError(\"unsupported_semantics\");\n}\nfunction invalidSource(diagnosticSubcode?: NativeSourceDiagnosticSubcode): MaterializerCliError {\n  return new MaterializerCliError(\"source_identity_mismatch\", diagnosticSubcode);\n}\nfunction incompatible(): MaterializerCliError {\n  return new MaterializerCliError(\"kernel_incompatible\");\n}\nfunction invalidOutput(): MaterializerCliError {\n  return new MaterializerCliError(\"output_verification_failed\");\n}\n\nfunction classifyInvalidSource(\n  error: unknown,\n  diagnosticSubcode: NativeSourceDiagnosticSubcode,\n): unknown {\n  return error instanceof MaterializerCliError && error.code === \"source_identity_mismatch\"\n    ? invalidSource(error.diagnosticSubcode ?? diagnosticSubcode)\n    : error;\n}\n\nasync function loadRuntime(\n  environment: Readonly<Record<string, string | undefined>>,\n): Promise<Awaited<ReturnType<typeof loadConfiguredArtifactKernelRuntime>>> {\n  try {\n    return await loadConfiguredArtifactKernelRuntime(environment);\n  } catch {\n    throw incompatible();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAEA,SAAS,kBAAkB;AAC3B,SAAS,YAAY;AAErB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAQP,IAAM,oBAAoB;AAC1B,IAAM,uBAAuB;AAC7B,IAAM,kBAAkB;AACxB,IAAM,cAAc,MAAM,UAAU;AACpC,IAAM,qBAAqB,MAAM,UAAU;AAC3C,IAAM,eAAe,MAAM,UAAU;AACrC,IAAM,sBAAsB,MAAM,UAAU;AAC5C,IAAM,cAAc,MAAM,UAAU;AACpC,IAAM,qBAAqB,MAAM;AACjC,IAAM,mBAAmB,MAAM,OAAO;AACtC,IAAM,mBAAmB,MAAM,OAAO;AACtC,IAAM,gCAAgC;AACtC,IAAM,gBAAgB;AACtB,IAAM,gBAAgB;AACtB,IAAM,2BAA2B,OAAO,MAAM,8BAA8B,CAAC;AAC7E,IAAM,cAAc,OAAO,MAAM,iDAAiD,CAAC;AA2DnF,eAAsB,2BACpB,MACA,cAA4D,QAAQ,KACrD;AACf,MAAI,KAAK,WAAW,EAAG,OAAM,IAAI,MAAM,kCAAkC;AACzE,QAAM,UAAU,KAAK,CAAC;AACtB,MAAI,YAAY,mBAAmB;AACjC,UAAM,eAAe,MAAM,iBAAiB,WAAW;AACvD,YAAQ,OAAO,MAAM,KAAK,UAAU,YAAY,CAAC;AACjD;AAAA,EACF;AACA,MAAI,YAAY,sBAAsB;AACpC,QAAI;AACF,YAAM,YAAY,WAAW;AAAA,IAC/B,SAAS,OAAO;AACd,UAAI,EAAE,iBAAiB,sBAAuB,OAAM;AACpD,YAAM,gBAAgB,MAAM,MAAM,MAAM,iBAAiB;AAAA,IAC3D;AACA;AAAA,EACF;AACA,MAAI,YAAY,iBAAiB;AAC/B,QAAI;AACF,YAAM,sBAAsB,WAAW;AAAA,IACzC,SAAS,OAAO;AACd,UAAI,EAAE,iBAAiB,sBAAuB,OAAM;AACpD,YAAM,gBAAgB,MAAM,MAAM,MAAM,iBAAiB;AAAA,IAC3D;AACA;AAAA,EACF;AACA,QAAM,IAAI,MAAM,kCAAkC;AACpD;AAEA,eAAe,iBACb,aACyD;AACzD,QAAM,SAAS,MAAM,YAAY,WAAW;AAC5C,SAAO;AAAA,IACL,OAAO;AAAA,IACP,OAAO,SAAS,aAAa;AAAA,EAC/B;AACF;AAEA,eAAe,YACb,aACe;AACf,MAAI;AACJ,MAAI;AACJ,MAAI;AACF,UAAM,SAAS,IAAI,YAAY,QAAQ,KAAK;AAC5C,gBAAY,MAAM,OAAO,YAAY,YAAY,UAAU,GAAG,aAAa,gBAAgB;AAC3F,UAAM,SAAS,MAAM,OAAO,YAAY,EAAE;AAC1C,UAAM,aAAa,IAAI,SAAS,OAAO,QAAQ,OAAO,YAAY,OAAO,UAAU;AACnF,UAAM,iBAAiB,WAAW,UAAU,GAAG,IAAI;AACnD,UAAM,eAAe,QAAQ,YAAY,GAAG,eAAe;AAC3D,QAAI,iBAAiB,KAAK,iBAAiB,mBAAoB,OAAM,cAAc;AACnF,QAAI,gBAAgB,KAAK,eAAe,iBAAkB,OAAM,YAAY;AAC5E,eAAW,eAAe,MAAM,OAAO,YAAY,cAAc,CAAC;AAClE,QAAI,iBAAiB,SAAS,eAAgB,OAAM,cAAc;AAClE,aAAS,MAAM,OAAO,YAAY,YAAY;AAC9C,UAAM,OAAO,UAAU;AACvB,QAAI,OAAO,MAAM,MAAM,SAAS,kBAAmB,OAAM,cAAc;AAAA,EACzE,SAAS,OAAO;AACd,UAAM,sBAAsB,OAAO,eAAe;AAAA,EACpD;AAEA,QAAM,SAAS,MAAM,YAAY,WAAW;AAC5C,QAAM,eAAe;AAAA,IACnB,OAAO;AAAA,IACP,OAAO,SAAS,aAAa;AAAA,EAC/B;AACA,8BAA4B,UAAU,YAAY;AAClD,MAAI,SAAS,aAAa,iBAAiB,SAAS,WAAW,OAAQ,OAAM,YAAY;AAEzF,QAAM,YAAY,mBAAmB,OAAO,SAAS,QAAQ,QAAQ;AACrE,QAAM,aAAa,MAAM,qBAAqB,WAAW,UAAU,UAAU;AAAA,IAC3E,oBAAoB;AAAA,IACpB,UAAU;AAAA,EACZ,CAAC;AACD,QAAM,SAAS,IAAI,WAAW,MAAM,WAAW,YAAY,CAAC;AAC5D,MAAI,OAAO,cAAc,KAAK,OAAO,aAAa,iBAAkB,OAAM,YAAY;AAGtF,QAAM,WAAW,MAAM,qBAAqB,WAAW,QAAQ,EAAE,oBAAoB,QAAQ,CAAC;AAC9F,MAAI,wBAAwB,QAAQ,MAAM,UAAU,aAAc,OAAM,YAAY;AAEpF,QAAM,WAAW,eAAe;AAAA,IAC9B,UAAU,OAAO;AAAA,IACjB,SAAS,SAAS;AAAA,IAClB,cAAc,SAAS;AAAA,IACvB,aAAa,OAAO,MAAM;AAAA,IAC1B,kBAAkB,SAAS;AAAA,IAC3B,QAAQ,SAAS;AAAA,IACjB,cAAc,SAAS;AAAA,IACvB,eAAe,SAAS;AAAA,IACxB,UAAU;AAAA,IACV,YAAY,SAAS;AAAA,IACrB,UAAU;AAAA,IACV,cAAc,UAAU;AAAA,IACxB,WAAW,SAAS;AAAA,EACtB,CAAC;AACD,QAAM,WAAW,cAAc,UAAU,MAAM;AACjD;AAEA,eAAe,sBACb,aACe;AACf,QAAM,SAAS,IAAI,YAAY,QAAQ,KAAK;AAC5C;AAAA,IACE,MAAM,OAAO,YAAY,mBAAmB,UAAU;AAAA,IACtD;AAAA,IACA;AAAA,EACF;AACA,QAAM,SAAS,MAAM,OAAO,YAAY,EAAE;AAC1C,QAAM,OAAO,IAAI,SAAS,OAAO,QAAQ,OAAO,YAAY,OAAO,UAAU;AAC7E,QAAM,iBAAiB,KAAK,UAAU,GAAG,IAAI;AAC7C,QAAM,eAAe,QAAQ,MAAM,GAAG,4BAA4B;AAClE,MAAI,iBAAiB,KAAK,iBAAiB,mBAAoB,OAAM,cAAc;AACnF,MAAI,gBAAgB,KAAK,eAAe,iBAAkB,OAAM,YAAY;AAC5E,QAAM,WAAW,2BAA2B,MAAM,OAAO,YAAY,cAAc,CAAC;AACpF,QAAM,SAAS,MAAM,OAAO,YAAY,YAAY;AACpD,QAAM,OAAO,UAAU;AACvB,QAAM,SAAS,MAAM,iBAAiB,WAAW;AACjD,MACE,SAAS,WAAW,UACpB,SAAS,YAAY,iBACrB,OAAO,cAAc,aAAa,MAAM,SAAS,cACjD;AACA,UAAM,YAAY;AAAA,EACpB;AACA,MAAI;AACJ,MAAI;AACF,UAAM,WAAW,MAAM,qBAAqB,WAAW,QAAQ,EAAE,oBAAoB,QAAQ,CAAC;AAC9F,mBAAe,wBAAwB,QAAQ;AAAA,EACjD,QAAQ;AACN,UAAM,cAAc;AAAA,EACtB;AACA,MAAI,iBAAiB,SAAS,qBAAsB,OAAM,cAAc;AACxE,QAAM;AAAA,IACJ;AAAA,IACA,eAAe,EAAE,UAAU,YAAY,aAAa,CAAC;AAAA,IACrD,IAAI,WAAW,CAAC;AAAA,EAClB;AACF;AAEA,SAAS,mBACP,SACA,QACA,UACmB;AACnB,MAAI;AACJ,MAAI;AACF,cAAU,yBAAyB,KAAK,SAAS,MAAM;AAAA,EACzD,QAAQ;AACN,UAAM,cAAc,eAAe;AAAA,EACrC;AACA,MAAI;AACF,QAAI,QAAQ,UAAU,MAAM,SAAS,UAAW,OAAM,cAAc,gBAAgB;AACpF,UAAM,gBAAgB,KAAK;AAAA,MACzB,QAAQ,aAAa;AAAA,MACrB;AAAA,IACF;AACA,UAAM,WAAW;AAAA,MACf,QAAQ;AAAA,QACN,qCAAqC;AAAA,UACnC,WAAW,KAAK,IAAI,GAAG,QAAQ,aAAa,iBAAiB;AAAA,UAC7D,UAAU;AAAA,QACZ,CAAC;AAAA,MACH;AAAA,MACA;AAAA,QACE,WAAW,KAAK,IAAI,GAAG,QAAQ,aAAa,iBAAiB;AAAA,QAC7D,UAAU;AAAA,MACZ;AAAA,IACF;AACA,QACE,SAAS,gBAAgB,eAAe,SACxC,SAAS,gBAAgB,WAAW,SACpC,SAAS,gBAAgB,WAAW,OACpC;AACA,YAAM,YAAY;AAAA,IACpB;AACA,QAAI,0BAA0B;AAC9B,UAAM,iBAAiE,CAAC;AACxE,eAAW,SAAS,SAAS,QAAQ;AACnC,YAAM,QAAwB,CAAC;AAC/B,UAAI,MAAM,YAAY;AACpB,cAAM,OAAO,MAAM,WAAW,SAAS,MAAM,WAAW,WAAW;AACnE,cAAM,UAAU,MAAM,WAAW,YAAY,MAAM,WAAW,cAAc;AAC5E,cAAM,OAAO,OAAO;AACpB,YAAI,CAAC,OAAO,cAAc,IAAI,KAAK,QAAQ,EAAG,OAAM,cAAc;AAClE,mCAA2B;AAC3B,YAAI,0BAA0B,8BAA+B,OAAM,YAAY;AAC/E,iBACM,MAAM,MAAM,WAAW,UAC3B,OAAO,MAAM,WAAW,QACxB,OAAO,eACP;AACA,gBAAM,WAAW,KAAK,IAAI,eAAe,MAAM,WAAW,SAAS,MAAM,CAAC;AAC1E,mBACM,SAAS,MAAM,WAAW,aAC9B,UAAU,MAAM,WAAW,WAC3B,UAAU,eACV;AACA,kBAAM,cAAc,KAAK,IAAI,eAAe,MAAM,WAAW,YAAY,SAAS,CAAC;AACnF,kBAAM,WAAW,WAAW;AAC5B,gBAAI,WAAW,wCAAyC,OAAM,YAAY;AAC1E,kBAAM,QAAQ;AAAA,cACZ,SAAS,MAAM;AAAA,cACf,UAAU;AAAA,cACV,aAAa;AAAA,cACb;AAAA,cACA;AAAA,cACA;AAAA,cACA,UAAU;AAAA,YACZ;AACA,kBAAM,WAAW;AAAA,cACf,QAAQ,MAAM,qCAAqC,KAAK,CAAC;AAAA,cACzD;AAAA,YACF;AACA,uBAAW,QAAQ,SAAS,OAAO;AACjC,uCAAyB,KAAK,KAAK;AACnC,oBAAM,KAAK;AAAA,gBACT,KAAK,KAAK;AAAA,gBACV,QAAQ,KAAK;AAAA,gBACb,SAAS,KAAK;AAAA,gBACd,OAAO,KAAK;AAAA,cACd,CAAC;AAAA,YACH;AAAA,UACF;AAAA,QACF;AAAA,MACF;AACA,YAAM,KAAK,CAAC,MAAM,UAAU,KAAK,MAAM,MAAM,OAAO,KAAK,SAAS,MAAM,MAAM;AAC9E,qBAAe,KAAK,EAAE,MAAM,MAAM,MAAM,MAAM,CAAC;AAAA,IACjD;AACA,UAAM,WAA6B,OAAO,OAAO,EAAE,SAAS,GAAG,QAAQ,eAAe,CAAC;AACvF,UAAM,WAAW,SAAS,SAAS,qBAAqB,QAAQ,CAAC;AACjE,UAAM,eAAe,OAAO,eAAe,QAAQ,CAAC;AAGpD,QAAI,wBAAwB,QAAQ,MAAM,aAAc,OAAM,YAAY;AAC1E,WAAO,OAAO,OAAO,EAAE,UAAU,aAAa,CAAC;AAAA,EACjD,UAAE;AACA,YAAQ,QAAQ;AAAA,EAClB;AACF;AAEA,SAAS,qBAAqB,UAAgD;AAC5E,SAAO;AAAA,IACL,SAAS;AAAA,IACT,YAAY,SAAS,OAAO,IAAI,CAAC,OAAO,WAAW;AAAA,MACjD,IAAI,aAAa,QAAQ,CAAC;AAAA,MAC1B,MAAM,MAAM;AAAA,MACZ,eAAe;AAAA,MACf,aAAa,EAAE,MAAM,GAAG,SAAS,EAAE;AAAA,MACnC,OAAO,MAAM,MAAM,IAAI,CAAC,UAAU;AAAA,QAChC,KAAK,KAAK;AAAA,QACV,KAAK,KAAK;AAAA,QACV,OAAO,KAAK,UAAU,OAAO,UAAU,KAAK,KAAK;AAAA,QACjD,SAAS,KAAK;AAAA,QACd,QAAQ,CAAC;AAAA,MACX,EAAE;AAAA,MACF,QAAQ,CAAC;AAAA,MACT,cAAc,CAAC;AAAA,MACf,YAAY,CAAC;AAAA,MACb,QAAQ,CAAC;AAAA,MACT,QAAQ,CAAC;AAAA,MACT,YAAY,CAAC;AAAA,MACb,iBAAiB,CAAC;AAAA,MAClB,wBAAwB,CAAC;AAAA,MACzB,QAAQ,CAAC;AAAA,IACX,EAAE;AAAA,IACF,UAAU,CAAC;AAAA,EACb;AACF;AAEA,SAAS,wBAAwB,UAA4B;AAC3D,QAAM,SAAS,SAAS,WAAW,MAAM,IAAI,CAAC,UAAU;AACtD,UAAM,QAAwB,CAAC;AAC/B,eAAW,EAAE,KAAK,KAAK,KAAK,KAAK,MAAM,YAAY,GAAG;AACpD,YAAM,QAAQ,KAAK,UAAU,SAAS,QAAQ,OAAO,EAAE,KAAK,IAAI,CAAC,IAAI,KAAK;AAC1E,YAAM,KAAK;AAAA,QACT;AAAA,QACA,QAAQ;AAAA,QACR,SAAS,KAAK;AAAA,QACd,OAAO,cAAc,OAAO,KAAK,YAAY,IAAI;AAAA,MACnD,CAAC;AAAA,IACH;AACA,UAAM,KAAK,CAAC,MAAM,UAAU,KAAK,MAAM,MAAM,OAAO,KAAK,SAAS,MAAM,MAAM;AAC9E,WAAO,EAAE,MAAM,MAAM,MAAM,MAAM;AAAA,EACnC,CAAC;AACD,SAAO,OAAO,eAAe,EAAE,SAAS,GAAG,OAAO,CAA4B,CAAC;AACjF;AAEA,SAAS,cAAc,OAAgB,SAAyD;AAC9F,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO,EAAE,MAAM,QAAQ;AAClE,MAAI,OAAO,UAAU,UAAW,QAAO,EAAE,MAAM,WAAW,MAAM;AAChE,MAAI,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,EAAG,QAAO,EAAE,MAAM,UAAU,MAAM;AACxF,MAAI,iBAAiB,MAAM;AACzB,UAAM,eAAe,KAAK,UAAU,QAAQ,KAAK,KAAK;AACtD,QAAI,CAAC,OAAO,cAAc,YAAY,EAAG,OAAM,YAAY;AAC3D,WAAO,EAAE,MAAM,QAAQ,OAAO,IAAI,KAAK,YAAY,EAAE,YAAY,EAAE;AAAA,EACrE;AACA,MAAI,OAAO,UAAU,UAAU;AAC7B,QAAI,SAAS;AACX,YAAM,QAAQ,wBAAwB,KAAK;AAC3C,UAAI,MAAO,QAAO,EAAE,MAAM,SAAS,OAAO,MAAM;AAChD,UAAI,UAAU,UAAW,QAAO,EAAE,MAAM,SAAS,OAAO,EAAE,QAAQ,MAAM,EAAE;AAAA,IAC5E;AACA,WAAO,EAAE,MAAM,QAAQ,MAAM;AAAA,EAC/B;AACA,QAAM,YAAY;AACpB;AAEA,SAAS,UACP,OACyC;AACzC,UAAQ,MAAM,MAAM;AAAA,IAClB,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO,MAAM;AAAA,IACf,KAAK;AACH,aAAO,IAAI,KAAK,MAAM,KAAK;AAAA,IAC7B,KAAK,SAAS;AACZ,UAAI,OAAO,MAAM,UAAU,SAAU,QAAO,MAAM,MAAM;AACxD,YAAM,YAAY,wBAAwB,MAAM,KAAK;AACrD,UAAI,CAAC,UAAW,OAAM,YAAY;AAClC,aAAO;AAAA,IACT;AAAA,EACF;AACF;AAEA,SAAS,yBAAyB,OAAoD;AACpF,YAAU,KAAK;AACjB;AAEA,IAAM,0BAA4D,OAAO,OAAO;AAAA,EAC9E,gBAAgB;AAAA,EAChB,OAAO;AAAA,EACP,WAAW;AAAA,EACX,MAAM;AAAA,EACN,QAAQ;AAAA,EACR,eAAe;AACjB,CAAC;AACD,IAAM,0BACJ,OAAO,OAAO;AAAA,EACZ,WAAW;AAAA,EACX,WAAW;AAAA,EACX,SAAS;AAAA,EACT,UAAU;AAAA,EACV,SAAS;AAAA,EACT,QAAQ;AACV,CAAC;AAOI,SAAS,mDACd,SACA,gBACgD;AAChD,SAAO,OAAO,OAAO;AAAA,IACnB,UAAU;AAAA,IACV,aAAa;AAAA,IACb,eAAe,QAAQ;AAAA,IACvB,eAAe,QAAQ;AAAA,IACvB,eAAe,OAAO,OAAO,EAAE,CAAC,aAAa,GAAG,aAAa,cAAc,EAAE,CAAC;AAAA,IAC9E,kBAAkB;AAAA,IAClB,YAAY;AAAA,IACZ,gBAAgB;AAAA,IAChB,8BAA8B,OAAO,OAAO,CAAC,CAAC,CAAU;AAAA,IACxD,oCAAoC,OAAO,OAAO,CAAC,CAAC,CAAU;AAAA,IAC9D,mCAAmC,OAAO,OAAO,CAAC,CAAC,CAAU;AAAA,EAC/D,CAAC;AACH;AAEA,SAAS,4BACP,UACA,cACM;AACN,MACE,SAAS,uBAAuB,KAChC,SAAS,6BAA6B,KACtC,SAAS,4BAA4B,KACrC,SAAS,kBAAkB,aAAa,iBACxC,SAAS,iBACN,aAAa,cAAmD,SAAS,OAAO,KACnF,SAAS,qBAAqB,aAAa,oBAC3C,SAAS,eAAe,aAAa,cACrC,OAAO,KAAK,SAAS,iBAAiB,EAAE,WAAW,GACnD;AACA,UAAM,aAAa;AAAA,EACrB;AACF;AAEA,SAAS,eAAe,OAA4C;AAClE,QAAM,SAAS,sBAAsB,OAAO;AAAA,IAC1C;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACD,MACE,OAAO,aAAa,cACpB,CAAC,gBAAgB,OAAO,cAAc,KACtC,CAAC,gBAAgB,OAAO,kBAAkB,KAC1C,CAAC,OAAO,OAAO,iBAAiB,KAChC,CAAC,OAAO,OAAO,SAAS,KACxB,CAAC,OAAO,OAAO,WAAW,KAC1B,CAAC,OAAO,OAAO,gBAAgB,KAC/B,CAAC,OAAO,OAAO,UAAU,KACzB,CAAC,YAAY,OAAO,iBAAiB,GACrC;AACA,UAAM,cAAc;AAAA,EACtB;AACA,SAAO;AACT;AAEA,SAAS,2BAA2B,OAMjC;AACD,QAAM,SAAS,sBAAsB,OAAO;AAAA,IAC1C;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACD,MAAI,OAAO,aAAa,cAAc,CAAC,OAAO,OAAO,oBAAoB,GAAG;AAC1E,UAAM,cAAc;AAAA,EACtB;AACA,SAAO;AACT;AAEA,SAAS,sBACP,OACA,MACyB;AACzB,QAAM,OAAO,IAAI,YAAY,SAAS,EAAE,OAAO,KAAK,CAAC,EAAE,OAAO,KAAK;AACnE,QAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,MAAI,CAAC,YAAY,MAAM,KAAK,KAAK,UAAU,MAAM,MAAM,KAAM,OAAM,cAAc;AACjF,MAAI,OAAO,KAAK,MAAM,EAAE,KAAK,EAAE,KAAK,IAAI,MAAM,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,EAAG,OAAM,cAAc;AAC/F,SAAO;AACT;AAEA,eAAe,gBACb,MACA,mBACe;AACf,QAAM;AAAA,IACJ;AAAA,IACA,eAAe;AAAA,MACb;AAAA,MACA,UAAU;AAAA,MACV,GAAI,oBAAoB,EAAE,SAAS,kBAAkB,IAAI,CAAC;AAAA,IAC5D,CAAC;AAAA,IACD,IAAI,WAAW,CAAC;AAAA,EAClB;AACF;AAEA,eAAe,WACb,OACA,UACA,SACe;AACf,QAAM,SAAS,IAAI,WAAW,EAAE;AAChC,QAAM,OAAO,IAAI,SAAS,OAAO,MAAM;AACvC,OAAK,UAAU,GAAG,SAAS,YAAY,IAAI;AAC3C,OAAK,aAAa,GAAG,OAAO,QAAQ,UAAU,GAAG,IAAI;AACrD,QAAM,YAAY,KAAK;AACvB,QAAM,YAAY,MAAM;AACxB,QAAM,YAAY,QAAQ;AAC1B,WAAS,SAAS,GAAG,SAAS,QAAQ,YAAY,UAAU,OAAO,MAAM;AACvE,UAAM,YAAY,QAAQ,SAAS,QAAQ,KAAK,IAAI,QAAQ,YAAY,SAAS,OAAO,IAAI,CAAC,CAAC;AAAA,EAChG;AACF;AAEA,eAAe,YAAY,OAAkC;AAC3D,MAAI,CAAC,QAAQ,OAAO,MAAM,KAAK,EAAG,OAAM,KAAK,QAAQ,QAAQ,OAAO;AACtE;AAEA,IAAM,cAAN,MAAkB;AAAA,EACP;AAAA,EACT,UAAU,IAAI,WAAW,CAAC;AAAA,EAC1B,QAAQ;AAAA,EAER,YAAY,QAAgE;AAC1E,SAAK,YAAY,OAAO,OAAO,aAAa,EAAE;AAAA,EAChD;AAAA,EAEA,MAAM,YAAY,QAAqC;AACrD,QAAI,CAAC,OAAO,cAAc,MAAM,KAAK,SAAS,KAAK,SAAS;AAC1D,YAAM,cAAc;AACtB,UAAM,SAAS,IAAI,WAAW,MAAM;AACpC,QAAI,SAAS;AACb,WAAO,SAAS,QAAQ;AACtB,UAAI,KAAK,QAAQ,eAAe,EAAG,OAAM,KAAK,MAAM;AACpD,UAAI,KAAK,QAAQ,eAAe,EAAG,OAAM,cAAc;AACvD,YAAM,QAAQ,KAAK,IAAI,SAAS,QAAQ,KAAK,QAAQ,UAAU;AAC/D,aAAO,IAAI,KAAK,QAAQ,SAAS,GAAG,KAAK,GAAG,MAAM;AAClD,WAAK,UAAU,KAAK,QAAQ,SAAS,KAAK;AAC1C,gBAAU;AAAA,IACZ;AACA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,YAA2B;AAC/B,QAAI,KAAK,QAAQ,aAAa,EAAG,OAAM,cAAc;AACrD,QAAI,CAAC,KAAK,MAAO,OAAM,KAAK,MAAM;AAClC,QAAI,CAAC,KAAK,SAAS,KAAK,QAAQ,aAAa,EAAG,OAAM,cAAc;AAAA,EACtE;AAAA,EAEA,MAAM,QAAuB;AAC3B,UAAM,OAAO,MAAM,KAAK,UAAU,KAAK;AACvC,QAAI,KAAK,MAAM;AACb,WAAK,QAAQ;AACb;AAAA,IACF;AACA,QAAI,OAAO,KAAK,UAAU,SAAU,OAAM,cAAc;AACxD,SAAK,UAAU,IAAI;AAAA,MACjB,KAAK,MAAM;AAAA,MACX,KAAK,MAAM;AAAA,MACX,KAAK,MAAM;AAAA,IACb,EAAE,MAAM;AAAA,EACV;AACF;AAEA,SAAS,aAAa,gBAAgC;AACpD,SAAO,WAAW,cAAc;AAClC;AAEA,SAAS,eAAe,OAA4B;AAClD,SAAO,MAAM,KAAK,UAAU,KAAK,CAAC;AACpC;AAEA,SAAS,MAAM,OAA2B;AACxC,SAAO,IAAI,YAAY,EAAE,OAAO,KAAK;AACvC;AAEA,SAAS,OAAO,OAA2B;AACzC,SAAO,UAAU,WAAW,QAAQ,EAAE,OAAO,KAAK,EAAE,OAAO,KAAK,CAAC;AACnE;AAEA,SAAS,QAAQ,MAAgB,QAAgB,OAAuB;AACtE,QAAM,QAAQ,KAAK,aAAa,QAAQ,IAAI;AAC5C,MAAI,QAAQ,OAAO,OAAO,gBAAgB,EAAG,OAAM,IAAI,MAAM,GAAG,KAAK,uBAAuB;AAC5F,SAAO,OAAO,KAAK;AACrB;AAEA,SAAS,YAAY,QAAoB,UAAsB,OAAqB;AAClF,MACE,OAAO,eAAe,SAAS,cAC/B,CAAC,OAAO,MAAM,CAAC,MAAM,UAAU,SAAS,SAAS,KAAK,CAAC,GACvD;AACA,UAAM,IAAI,MAAM,GAAG,KAAK,aAAa;AAAA,EACvC;AACF;AAEA,SAAS,YAAY,OAAkD;AACrE,SACE,OAAO,UAAU,YACjB,UAAU,QACV,CAAC,MAAM,QAAQ,KAAK,KACpB,OAAO,eAAe,KAAK,MAAM,OAAO;AAE5C;AAEA,SAAS,gBAAgB,OAAiC;AACxD,SAAO,OAAO,UAAU,YAAY,OAAO,cAAc,KAAK,KAAK,QAAQ;AAC7E;AAEA,SAAS,OAAO,OAAiC;AAC/C,SAAO,OAAO,UAAU,YAAY,yBAAyB,KAAK,KAAK;AACzE;AAEA,IAAM,uBAAN,cAAmC,MAAM;AAAA,EAOvC,YACE,MACS,mBACT;AACA,UAAM,IAAI;AAFD;AAGT,SAAK,OAAO;AACZ,SAAK,OAAO;AAAA,EACd;AAAA,EAbS;AAcX;AAEA,SAAS,cAAoC;AAC3C,SAAO,IAAI,qBAAqB,uBAAuB;AACzD;AACA,SAAS,cAAc,mBAAyE;AAC9F,SAAO,IAAI,qBAAqB,4BAA4B,iBAAiB;AAC/E;AACA,SAAS,eAAqC;AAC5C,SAAO,IAAI,qBAAqB,qBAAqB;AACvD;AACA,SAAS,gBAAsC;AAC7C,SAAO,IAAI,qBAAqB,4BAA4B;AAC9D;AAEA,SAAS,sBACP,OACA,mBACS;AACT,SAAO,iBAAiB,wBAAwB,MAAM,SAAS,6BAC3D,cAAc,MAAM,qBAAqB,iBAAiB,IAC1D;AACN;AAEA,eAAe,YACb,aAC0E;AAC1E,MAAI;AACF,WAAO,MAAM,oCAAoC,WAAW;AAAA,EAC9D,QAAQ;AACN,UAAM,aAAa;AAAA,EACrB;AACF;","names":[]}

package/dist/chunk-O24KTEGP.js

@@ -0,0 +1,33 @@
+// src/errors.ts
+var UnsupportedArtifactFeatureError = class extends Error {
+  constructor(area, feature, backend) {
+    super(`${feature} is not supported by the ${backend} ${area} backend`);
+    this.area = area;
+    this.feature = feature;
+    this.backend = backend;
+  }
+  name = "UnsupportedArtifactFeatureError";
+};
+var ArtifactLimitError = class extends Error {
+  constructor(limit, actual, maximum) {
+    super(`${limit} exceeds the maximum (${actual} > ${maximum})`);
+    this.limit = limit;
+    this.actual = actual;
+    this.maximum = maximum;
+  }
+  name = "ArtifactLimitError";
+};
+var ArtifactConflictError = class extends Error {
+  constructor(message, objectIds) {
+    super(message);
+    this.objectIds = objectIds;
+  }
+  name = "ArtifactConflictError";
+};
+
+export {
+  UnsupportedArtifactFeatureError,
+  ArtifactLimitError,
+  ArtifactConflictError
+};
+//# sourceMappingURL=chunk-O24KTEGP.js.map

package/dist/chunk-O24KTEGP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts"],"sourcesContent":["export type ArtifactFeatureArea =\n  | \"spreadsheet\"\n  | \"presentation\"\n  | \"document\"\n  | \"codec\"\n  | \"render\"\n  | \"collaboration\";\n\n/** A requested feature cannot be represented faithfully by the active kernel. */\nexport class UnsupportedArtifactFeatureError extends Error {\n  readonly name = \"UnsupportedArtifactFeatureError\";\n\n  constructor(\n    readonly area: ArtifactFeatureArea,\n    readonly feature: string,\n    readonly backend: string,\n  ) {\n    super(`${feature} is not supported by the ${backend} ${area} backend`);\n  }\n}\n\n/** Artifact bytes or commands exceeded a declared safety/resource boundary. */\nexport class ArtifactLimitError extends Error {\n  readonly name = \"ArtifactLimitError\";\n\n  constructor(\n    readonly limit: string,\n    readonly actual: number,\n    readonly maximum: number,\n  ) {\n    super(`${limit} exceeds the maximum (${actual} > ${maximum})`);\n  }\n}\n\n/** A command's structural precondition no longer matches canonical state. */\nexport class ArtifactConflictError extends Error {\n  readonly name = \"ArtifactConflictError\";\n\n  constructor(\n    message: string,\n    readonly objectIds: readonly string[],\n  ) {\n    super(message);\n  }\n}\n"],"mappings":";AASO,IAAM,kCAAN,cAA8C,MAAM;AAAA,EAGzD,YACW,MACA,SACA,SACT;AACA,UAAM,GAAG,OAAO,4BAA4B,OAAO,IAAI,IAAI,UAAU;AAJ5D;AACA;AACA;AAAA,EAGX;AAAA,EARS,OAAO;AASlB;AAGO,IAAM,qBAAN,cAAiC,MAAM;AAAA,EAG5C,YACW,OACA,QACA,SACT;AACA,UAAM,GAAG,KAAK,yBAAyB,MAAM,MAAM,OAAO,GAAG;AAJpD;AACA;AACA;AAAA,EAGX;AAAA,EARS,OAAO;AASlB;AAGO,IAAM,wBAAN,cAAoC,MAAM;AAAA,EAG/C,YACE,SACS,WACT;AACA,UAAM,OAAO;AAFJ;AAAA,EAGX;AAAA,EAPS,OAAO;AAQlB;","names":[]}