docxodus 9.9.0 → 10.0.0

package/dist/worker-proxy.bundle.js

@@ -1,10 +1,23 @@
 // src/worker-proxy.ts
+var WorkerOperationError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.name = "WorkerOperationError";
+    this.code = code;
+  }
+};
+function workerError(message, code) {
+  return new WorkerOperationError(message || "Unknown error", code);
+}
+function workerErrorCode(error) {
+  return error instanceof WorkerOperationError ? error.code : void 0;
+}
 function generateId() {
   return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
 }
 async function toBytes(document2) {
   if (document2 instanceof Uint8Array) {
-    return document2;
+    return new Uint8Array(document2);
   }
   const buffer = await document2.arrayBuffer();
   return new Uint8Array(buffer);
@@ -21,12 +34,32 @@ function deriveWasmBasePath() {
   return "/wasm/";
 }
 async function createWorkerDocxodus(options) {
+  if (options?.signal?.aborted) {
+    throw new Error("Worker creation aborted");
+  }
   const wasmBasePath = options?.wasmBasePath ?? deriveWasmBasePath();
-  let workerUrl;
   const workerScriptPath = new URL("./docxodus.worker.js", import.meta.url).href;
   const worker = new Worker(workerScriptPath, { type: "module" });
   const pendingRequests = /* @__PURE__ */ new Map();
   let isWorkerActive = true;
+  let abortListener;
+  const stopWorker = (message) => {
+    if (!isWorkerActive) return;
+    isWorkerActive = false;
+    worker.terminate();
+    for (const pending of pendingRequests.values()) {
+      pending.reject(new Error(message));
+    }
+    pendingRequests.clear();
+    if (abortListener && options?.signal) {
+      options.signal.removeEventListener("abort", abortListener);
+      abortListener = void 0;
+    }
+  };
+  if (options?.signal) {
+    abortListener = () => stopWorker("Worker creation or operation aborted");
+    options.signal.addEventListener("abort", abortListener, { once: true });
+  }
   let preparePromise = null;
   worker.onmessage = (event) => {
     const response = event.data;
@@ -39,16 +72,12 @@ async function createWorkerDocxodus(options) {
       if (response.success) {
         pending.resolve(response);
       } else {
-        pending.reject(new Error(response.error || "Unknown error"));
+        pending.reject(workerError(response.error, response.errorCode));
       }
     }
   };
   worker.onerror = (error) => {
-    for (const pending of pendingRequests.values()) {
-      pending.reject(new Error(`Worker error: ${error.message}`));
-    }
-    pendingRequests.clear();
-    isWorkerActive = false;
+    stopWorker(`Worker error: ${error.message}`);
   };
   function sendRequest(request, transfer) {
     return new Promise((resolve, reject) => {
@@ -57,31 +86,139 @@ async function createWorkerDocxodus(options) {
         return;
       }
       pendingRequests.set(request.id, { resolve, reject });
-      if (transfer && transfer.length > 0) {
-        worker.postMessage(request, transfer);
-      } else {
-        worker.postMessage(request);
+      try {
+        if (transfer && transfer.length > 0) {
+          worker.postMessage(request, transfer);
+        } else {
+          worker.postMessage(request);
+        }
+      } catch (error) {
+        pendingRequests.delete(request.id);
+        reject(error instanceof Error ? error : new Error(String(error)));
       }
     });
   }
-  const initResponse = await sendRequest({
-    id: generateId(),
-    type: "init",
-    wasmBasePath
-  });
-  if (!initResponse.success) {
-    worker.terminate();
-    throw new Error(`Failed to initialize worker: ${initResponse.error}`);
+  try {
+    await sendRequest({
+      id: generateId(),
+      type: "init",
+      wasmBasePath
+    });
+  } catch (error) {
+    stopWorker("Worker initialization failed");
+    throw error;
   }
   return {
-    async convertDocxToHtml(document2, options2) {
+    async generatePackageManifest(document2, limits) {
+      const bytes = await toBytes(document2);
+      const response = await sendRequest(
+        {
+          id: generateId(),
+          type: "generatePackageManifest",
+          documentBytes: bytes,
+          limits,
+          representation: "object"
+        },
+        [bytes.buffer]
+      );
+      return response.manifest;
+    },
+    async verifyDeliverable(document2, baseline) {
+      const bytes = await toBytes(document2);
+      const baselineBytes = baseline === void 0 ? void 0 : await toBytes(baseline);
+      const transfer = [bytes.buffer];
+      if (baselineBytes !== void 0) transfer.push(baselineBytes.buffer);
+      const response = await sendRequest(
+        {
+          id: generateId(),
+          type: "verifyDeliverable",
+          documentBytes: bytes,
+          baselineBytes
+        },
+        transfer
+      );
+      if (!response.success || !response.verification) {
+        throw new Error(response.error ?? "verifyDeliverable failed");
+      }
+      return response.verification;
+    },
+    async proveRedlineReversibility(baseline, intendedFinal, redline) {
+      const baselineBytes = await toBytes(baseline);
+      const intendedFinalBytes = await toBytes(intendedFinal);
+      const redlineBytes = await toBytes(redline);
+      const response = await sendRequest(
+        {
+          id: generateId(),
+          type: "proveRedlineReversibility",
+          baselineBytes,
+          intendedFinalBytes,
+          redlineBytes
+        },
+        [baselineBytes.buffer, intendedFinalBytes.buffer, redlineBytes.buffer]
+      );
+      if (!response.success || !response.proof) {
+        throw new Error(response.error ?? "proveRedlineReversibility failed");
+      }
+      return response.proof;
+    },
+    async getSemanticChanges(left, right, settings) {
+      const leftBytes = await toBytes(left);
+      const rightBytes = await toBytes(right);
+      const response = await sendRequest(
+        {
+          id: generateId(),
+          type: "getSemanticChanges",
+          leftBytes,
+          rightBytes,
+          settings
+        },
+        [leftBytes.buffer, rightBytes.buffer]
+      );
+      return response.semanticChanges;
+    },
+    async generatePackageManifestJson(document2, limits) {
+      const bytes = await toBytes(document2);
+      const response = await sendRequest(
+        {
+          id: generateId(),
+          type: "generatePackageManifest",
+          documentBytes: bytes,
+          limits,
+          representation: "json"
+        },
+        [bytes.buffer]
+      );
+      if (response.manifestJson === void 0) {
+        throw new Error("Package manifest worker response omitted canonical JSON");
+      }
+      return response.manifestJson;
+    },
+    async projectReviewProfile(document2, profile, maximumOutputBytes) {
+      const bytes = await toBytes(document2);
+      const response = await sendRequest(
+        {
+          id: generateId(),
+          type: "projectReviewProfile",
+          documentBytes: bytes,
+          profile,
+          maximumOutputBytes
+        },
+        [bytes.buffer]
+      );
+      if (!response.documentBytes || response.documentBytes.byteLength === 0) {
+        throw new Error(`Failed to derive the ${profile} review profile`);
+      }
+      return response.documentBytes;
+    },
+    async convertDocxToHtml(document2, options2, maximumOutputBytes) {
       const bytes = await toBytes(document2);
       const response = await sendRequest(
         {
           id: generateId(),
           type: "convertDocxToHtml",
           documentBytes: bytes,
-          options: options2
+          options: options2,
+          maximumOutputBytes
         },
         [bytes.buffer]
       );
@@ -181,6 +318,39 @@ async function createWorkerDocxodus(options) {
       }
       const handle = openResponse.handle;
       return {
+        async getPackageManifest() {
+          const res = await sendRequest({
+            id: generateId(),
+            type: "sessionGetPackageManifest",
+            handle
+          });
+          if (!res.success || !res.manifest) {
+            throw new Error(res.error ?? "sessionGetPackageManifest failed");
+          }
+          return res.manifest;
+        },
+        async getSemanticChanges() {
+          const res = await sendRequest({
+            id: generateId(),
+            type: "sessionGetSemanticChanges",
+            handle
+          });
+          if (!res.success || !res.semanticChanges) {
+            throw new Error(res.error ?? "sessionGetSemanticChanges failed");
+          }
+          return res.semanticChanges;
+        },
+        async verifyDeliverable() {
+          const res = await sendRequest({
+            id: generateId(),
+            type: "sessionVerifyDeliverable",
+            handle
+          });
+          if (!res.success || !res.verification) {
+            throw new Error(res.error ?? "sessionVerifyDeliverable failed");
+          }
+          return res.verification;
+        },
         async addAnnotation(anchorId, span, annotation) {
           const res = await sendRequest({
             id: generateId(),
@@ -244,12 +414,7 @@ async function createWorkerDocxodus(options) {
       };
     },
     terminate() {
-      isWorkerActive = false;
-      worker.terminate();
-      for (const pending of pendingRequests.values()) {
-        pending.reject(new Error("Worker terminated"));
-      }
-      pendingRequests.clear();
+      stopWorker("Worker terminated");
     },
     isActive() {
       return isWorkerActive;
@@ -260,6 +425,8 @@ function isWorkerSupported() {
   return typeof Worker !== "undefined";
 }
 export {
+  WorkerOperationError,
   createWorkerDocxodus,
-  isWorkerSupported
+  isWorkerSupported,
+  workerErrorCode
 };

package/dist/worker-proxy.d.ts

@@ -18,7 +18,17 @@
  * docxodus.terminate();
  * ```
  */
-import type { WorkerDocxodusOptions, ConversionOptions, CompareOptions, GetRevisionsOptions, Revision, VersionInfo, DocumentMetadata, DocxSessionSettings, DocumentAnnotation, AnnotationUpdate, CharSpan, EditResult } from "./types.js";
+import type { WorkerDocxodusOptions, ConversionOptions, CompareOptions, DocxDiffSettings, GetRevisionsOptions, Revision, VersionInfo, DocumentMetadata, DocxSessionSettings, DocumentAnnotation, AnnotationUpdate, CharSpan, EditResult, PackageManifest, DeliverableVerificationResult, RedlineReversibilityProof, SemanticChangeSet, PackageManifestInspectionLimits, WorkerErrorCode } from "./types.js";
+/**
+ * Rejection carrying the worker's machine-readable cause. Callers classify failures with
+ * {@link workerErrorCode}; `message` is diagnostic text whose wording is not a contract.
+ */
+export declare class WorkerOperationError extends Error {
+    readonly code?: WorkerErrorCode;
+    constructor(message: string, code?: WorkerErrorCode);
+}
+/** Reads a worker failure's machine-readable cause, or undefined for any other error. */
+export declare function workerErrorCode(error: unknown): WorkerErrorCode | undefined;
 /**
  * A worker-proxied DocxSession. Mirrors the main-thread {@link DocxSession}
  * annotation write surface but each call returns a Promise, since the actual
@@ -28,6 +38,12 @@ import type { WorkerDocxodusOptions, ConversionOptions, CompareOptions, GetRevis
  * {@link close} when finished to free the in-worker handle.
  */
 export interface WorkerDocxSession {
+    /** Generate a deterministic manifest of the session's current logical checkpoint. */
+    getPackageManifest(): Promise<PackageManifest>;
+    /** Run the default deliverable gate over the session's clean-save checkpoint. */
+    verifyDeliverable(): Promise<DeliverableVerificationResult>;
+    /** Compare the current logical checkpoint with the exact opening package. */
+    getSemanticChanges(): Promise<SemanticChangeSet>;
     /**
      * Add an annotation to the document at the given anchor.
      * @param anchorId - Markdown-projection anchor id of the target block
@@ -70,13 +86,29 @@ export interface WorkerDocxSession {
  * in a Web Worker for non-blocking UI.
  */
 export interface WorkerDocxodus {
+    /** Generate a deterministic, non-mutating verification manifest. */
+    generatePackageManifest(document: File | Uint8Array, limits?: PackageManifestInspectionLimits): Promise<PackageManifest>;
+    /** Generate the exact canonical manifest JSON for strict boundary validation. */
+    generatePackageManifestJson(document: File | Uint8Array, limits?: PackageManifestInspectionLimits): Promise<string>;
+    /** Derive an isolated final/original package; the source bytes remain caller-owned. */
+    projectReviewProfile(document: File | Uint8Array, profile: "final" | "original", maximumOutputBytes?: number): Promise<Uint8Array>;
+    /** Run the default bounded deliverable gate, optionally against an exact baseline. */
+    verifyDeliverable(document: File | Uint8Array, baseline?: File | Uint8Array): Promise<DeliverableVerificationResult>;
+    /**
+     * Prove that a redline's generated revisions accept to the intended final and reject to the
+     * baseline. Three packages are inspected and two rebuilt, so this always runs off the main
+     * thread; the returned proof carries digests and divergences rather than the rebuilt bytes.
+     */
+    proveRedlineReversibility(baseline: File | Uint8Array, intendedFinal: File | Uint8Array, redline: File | Uint8Array): Promise<RedlineReversibilityProof>;
+    /** Compare two DOCX packages into the stable, versioned semantic-change schema. */
+    getSemanticChanges(left: File | Uint8Array, right: File | Uint8Array, settings?: DocxDiffSettings): Promise<SemanticChangeSet>;
     /**
      * Convert a DOCX document to HTML.
      * @param document - DOCX file as File object or Uint8Array
      * @param options - Conversion options
      * @returns HTML string
      */
-    convertDocxToHtml(document: File | Uint8Array, options?: ConversionOptions): Promise<string>;
+    convertDocxToHtml(document: File | Uint8Array, options?: ConversionOptions, maximumOutputBytes?: number): Promise<string>;
     /**
      * Compare two DOCX documents and return the redlined result.
      * @param original - Original DOCX document
@@ -137,7 +169,8 @@ export interface WorkerDocxodus {
     prepare(): Promise<void>;
     /**
      * Open a {@link WorkerDocxSession} for surgical annotation editing inside
-     * the worker. The document bytes are transferred to the worker (zero-copy).
+     * the worker. Uint8Array inputs are copied once so the caller's buffer remains attached and
+     * subarray boundaries are preserved; the private copy is then transferred.
      *
      * Always call {@link WorkerDocxSession.close} when you are done to release
      * the in-worker session handle.

package/dist/worker-proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker-proxy.d.ts","sourceRoot":"","sources":["../src/worker-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAYV,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACX,MAAM,YAAY,CAAC;AAuCpB;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,QAAQ,GAAG,IAAI,EACrB,UAAU,EAAE,kBAAkB,GAC7B,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvB;;;;OAIG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE5D;;;;;OAKG;IACH,gBAAgB,CACd,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvB;;;;;;OAMG;IACH,cAAc,CACZ,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,QAAQ,GAAG,IAAI,GACvB,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvB;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,iBAAiB,CACf,QAAQ,EAAE,IAAI,GAAG,UAAU,EAC3B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB;;;;;;OAMG;IACH,gBAAgB,CACd,QAAQ,EAAE,IAAI,GAAG,UAAU,EAC3B,QAAQ,EAAE,IAAI,GAAG,UAAU,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvB;;;;;;OAMG;IACH,sBAAsB,CACpB,QAAQ,EAAE,IAAI,GAAG,UAAU,EAC3B,QAAQ,EAAE,IAAI,GAAG,UAAU,EAC3B,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB;;;;;OAKG;IACH,YAAY,CACV,QAAQ,EAAE,IAAI,GAAG,UAAU,EAC3B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEvB;;;;;OAKG;IACH,mBAAmB,CAAC,QAAQ,EAAE,IAAI,GAAG,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE5E;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAEnC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;;;;;;;;OAUG;IACH,eAAe,CACb,QAAQ,EAAE,IAAI,GAAG,UAAU,EAC3B,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE9B;;;OAGG;IACH,SAAS,IAAI,IAAI,CAAC;IAElB;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,cAAc,CAAC,CA6UzB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C"}
+{"version":3,"file":"worker-proxy.d.ts","sourceRoot":"","sources":["../src/worker-proxy.ts"],"names":[],"mappings":"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"}

package/dist/worker-proxy.js

@@ -18,6 +18,24 @@
  * docxodus.terminate();
  * ```
  */
+/**
+ * Rejection carrying the worker's machine-readable cause. Callers classify failures with
+ * {@link workerErrorCode}; `message` is diagnostic text whose wording is not a contract.
+ */
+export class WorkerOperationError extends Error {
+    constructor(message, code) {
+        super(message);
+        this.name = "WorkerOperationError";
+        this.code = code;
+    }
+}
+function workerError(message, code) {
+    return new WorkerOperationError(message || "Unknown error", code);
+}
+/** Reads a worker failure's machine-readable cause, or undefined for any other error. */
+export function workerErrorCode(error) {
+    return error instanceof WorkerOperationError ? error.code : undefined;
+}
 /**
  * Generate a unique request ID.
  */
@@ -29,7 +47,9 @@ function generateId() {
  */
 async function toBytes(document) {
     if (document instanceof Uint8Array) {
-        return document;
+        // Transfer only an exact-view clone. Transferring the caller's buffer would detach it,
+        // and transferring a subarray's backing buffer would also send unrelated prefix/suffix bytes.
+        return new Uint8Array(document);
     }
     const buffer = await document.arrayBuffer();
     return new Uint8Array(buffer);
@@ -73,13 +93,12 @@ function deriveWasmBasePath() {
  * ```
  */
 export async function createWorkerDocxodus(options) {
+    if (options?.signal?.aborted) {
+        throw new Error("Worker creation aborted");
+    }
     // Determine WASM base path
     const wasmBasePath = options?.wasmBasePath ?? deriveWasmBasePath();
-    // Determine worker script path
-    // The worker bundle should be in the same directory as this module
-    let workerUrl;
-    // Try to create worker from bundled script or blob
-    // For now, we'll use a blob URL to inline the worker path
+    // The worker bundle is packaged beside this module.
     const workerScriptPath = new URL("./docxodus.worker.js", import.meta.url)
         .href;
     // Create the worker
@@ -88,6 +107,25 @@ export async function createWorkerDocxodus(options) {
     const pendingRequests = new Map();
     // Track if worker is active
     let isWorkerActive = true;
+    let abortListener;
+    const stopWorker = (message) => {
+        if (!isWorkerActive)
+            return;
+        isWorkerActive = false;
+        worker.terminate();
+        for (const pending of pendingRequests.values()) {
+            pending.reject(new Error(message));
+        }
+        pendingRequests.clear();
+        if (abortListener && options?.signal) {
+            options.signal.removeEventListener("abort", abortListener);
+            abortListener = undefined;
+        }
+    };
+    if (options?.signal) {
+        abortListener = () => stopWorker("Worker creation or operation aborted");
+        options.signal.addEventListener("abort", abortListener, { once: true });
+    }
     // Cached warmup promise. Set on the first prepare() and reused thereafter so
     // repeated/concurrent calls share a single in-flight (or completed) warmup.
     // Reset to null on failure so a later prepare() can retry.
@@ -107,18 +145,13 @@ export async function createWorkerDocxodus(options) {
                 pending.resolve(response);
             }
             else {
-                pending.reject(new Error(response.error || "Unknown error"));
+                pending.reject(workerError(response.error, response.errorCode));
             }
         }
     };
     // Handle worker errors
     worker.onerror = (error) => {
-        // Reject all pending requests
-        for (const pending of pendingRequests.values()) {
-            pending.reject(new Error(`Worker error: ${error.message}`));
-        }
-        pendingRequests.clear();
-        isWorkerActive = false;
+        stopWorker(`Worker error: ${error.message}`);
     };
     /**
      * Send a request to the worker and wait for response.
@@ -130,33 +163,126 @@ export async function createWorkerDocxodus(options) {
                 return;
             }
             pendingRequests.set(request.id, { resolve, reject });
-            if (transfer && transfer.length > 0) {
-                worker.postMessage(request, transfer);
+            try {
+                if (transfer && transfer.length > 0) {
+                    worker.postMessage(request, transfer);
+                }
+                else {
+                    worker.postMessage(request);
+                }
             }
-            else {
-                worker.postMessage(request);
+            catch (error) {
+                pendingRequests.delete(request.id);
+                reject(error instanceof Error ? error : new Error(String(error)));
             }
         });
     }
     // Initialize the worker
-    const initResponse = await sendRequest({
-        id: generateId(),
-        type: "init",
-        wasmBasePath,
-    });
-    if (!initResponse.success) {
-        worker.terminate();
-        throw new Error(`Failed to initialize worker: ${initResponse.error}`);
+    try {
+        await sendRequest({
+            id: generateId(),
+            type: "init",
+            wasmBasePath,
+        });
+    }
+    catch (error) {
+        stopWorker("Worker initialization failed");
+        throw error;
     }
     // Return the WorkerDocxodus instance
     return {
-        async convertDocxToHtml(document, options) {
+        async generatePackageManifest(document, limits) {
+            const bytes = await toBytes(document);
+            const response = await sendRequest({
+                id: generateId(),
+                type: "generatePackageManifest",
+                documentBytes: bytes,
+                limits,
+                representation: "object",
+            }, [bytes.buffer]);
+            return response.manifest;
+        },
+        async verifyDeliverable(document, baseline) {
+            const bytes = await toBytes(document);
+            const baselineBytes = baseline === undefined ? undefined : await toBytes(baseline);
+            const transfer = [bytes.buffer];
+            if (baselineBytes !== undefined)
+                transfer.push(baselineBytes.buffer);
+            const response = await sendRequest({
+                id: generateId(),
+                type: "verifyDeliverable",
+                documentBytes: bytes,
+                baselineBytes,
+            }, transfer);
+            if (!response.success || !response.verification) {
+                throw new Error(response.error ?? "verifyDeliverable failed");
+            }
+            return response.verification;
+        },
+        async proveRedlineReversibility(baseline, intendedFinal, redline) {
+            const baselineBytes = await toBytes(baseline);
+            const intendedFinalBytes = await toBytes(intendedFinal);
+            const redlineBytes = await toBytes(redline);
+            const response = await sendRequest({
+                id: generateId(),
+                type: "proveRedlineReversibility",
+                baselineBytes,
+                intendedFinalBytes,
+                redlineBytes,
+            }, [baselineBytes.buffer, intendedFinalBytes.buffer, redlineBytes.buffer]);
+            if (!response.success || !response.proof) {
+                throw new Error(response.error ?? "proveRedlineReversibility failed");
+            }
+            return response.proof;
+        },
+        async getSemanticChanges(left, right, settings) {
+            const leftBytes = await toBytes(left);
+            const rightBytes = await toBytes(right);
+            const response = await sendRequest({
+                id: generateId(),
+                type: "getSemanticChanges",
+                leftBytes,
+                rightBytes,
+                settings,
+            }, [leftBytes.buffer, rightBytes.buffer]);
+            return response.semanticChanges;
+        },
+        async generatePackageManifestJson(document, limits) {
+            const bytes = await toBytes(document);
+            const response = await sendRequest({
+                id: generateId(),
+                type: "generatePackageManifest",
+                documentBytes: bytes,
+                limits,
+                representation: "json",
+            }, [bytes.buffer]);
+            if (response.manifestJson === undefined) {
+                throw new Error("Package manifest worker response omitted canonical JSON");
+            }
+            return response.manifestJson;
+        },
+        async projectReviewProfile(document, profile, maximumOutputBytes) {
+            const bytes = await toBytes(document);
+            const response = await sendRequest({
+                id: generateId(),
+                type: "projectReviewProfile",
+                documentBytes: bytes,
+                profile,
+                maximumOutputBytes,
+            }, [bytes.buffer]);
+            if (!response.documentBytes || response.documentBytes.byteLength === 0) {
+                throw new Error(`Failed to derive the ${profile} review profile`);
+            }
+            return response.documentBytes;
+        },
+        async convertDocxToHtml(document, options, maximumOutputBytes) {
             const bytes = await toBytes(document);
             const response = await sendRequest({
                 id: generateId(),
                 type: "convertDocxToHtml",
                 documentBytes: bytes,
                 options,
+                maximumOutputBytes,
             }, [bytes.buffer]);
             return response.html;
         },
@@ -239,6 +365,39 @@ export async function createWorkerDocxodus(options) {
             }
             const handle = openResponse.handle;
             return {
+                async getPackageManifest() {
+                    const res = await sendRequest({
+                        id: generateId(),
+                        type: "sessionGetPackageManifest",
+                        handle,
+                    });
+                    if (!res.success || !res.manifest) {
+                        throw new Error(res.error ?? "sessionGetPackageManifest failed");
+                    }
+                    return res.manifest;
+                },
+                async getSemanticChanges() {
+                    const res = await sendRequest({
+                        id: generateId(),
+                        type: "sessionGetSemanticChanges",
+                        handle,
+                    });
+                    if (!res.success || !res.semanticChanges) {
+                        throw new Error(res.error ?? "sessionGetSemanticChanges failed");
+                    }
+                    return res.semanticChanges;
+                },
+                async verifyDeliverable() {
+                    const res = await sendRequest({
+                        id: generateId(),
+                        type: "sessionVerifyDeliverable",
+                        handle,
+                    });
+                    if (!res.success || !res.verification) {
+                        throw new Error(res.error ?? "sessionVerifyDeliverable failed");
+                    }
+                    return res.verification;
+                },
                 async addAnnotation(anchorId, span, annotation) {
                     const res = await sendRequest({
                         id: generateId(),
@@ -302,13 +461,7 @@ export async function createWorkerDocxodus(options) {
             };
         },
         terminate() {
-            isWorkerActive = false;
-            worker.terminate();
-            // Reject any pending requests
-            for (const pending of pendingRequests.values()) {
-                pending.reject(new Error("Worker terminated"));
-            }
-            pendingRequests.clear();
+            stopWorker("Worker terminated");
         },
         isActive() {
             return isWorkerActive;