@cloudpdf/contract 3.0.0-next.11 → 3.0.0-next.13

package/dist/index.d.ts

@@ -5560,6 +5560,116 @@ declare const DocFieldParamsSchema: z.ZodObject<{
  * passwords in headers — they use the SDK's password-session flow.
  */
 declare const documentPasswordHeader: AdminOperationHeader;
+declare const DocSigningParamsSchema: z.ZodObject<{
+    docId: z.ZodString;
+} & {
+    layerName: z.ZodString;
+} & {
+    signingId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    docId: string;
+    layerName: string;
+    signingId: string;
+}, {
+    docId: string;
+    layerName: string;
+    signingId: string;
+}>;
+declare const DocVersionParamsSchema: z.ZodObject<{
+    docId: z.ZodString;
+} & {
+    sha: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    docId: string;
+    sha: string;
+}, {
+    docId: string;
+    sha: string;
+}>;
+declare const DocVersionFieldParamsSchema: z.ZodObject<{
+    docId: z.ZodString;
+} & {
+    sha: z.ZodString;
+} & {
+    fieldKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    docId: string;
+    fieldKey: string;
+    sha: string;
+}, {
+    docId: string;
+    fieldKey: string;
+    sha: string;
+}>;
+declare const DocVersionDigestParamsSchema: z.ZodObject<{
+    docId: z.ZodString;
+} & {
+    sha: z.ZodString;
+} & {
+    fieldKey: z.ZodString;
+} & {
+    algorithm: z.ZodEnum<["sha1", "sha256", "sha384", "sha512"]>;
+}, "strip", z.ZodTypeAny, {
+    docId: string;
+    fieldKey: string;
+    sha: string;
+    algorithm: "sha256" | "sha1" | "sha384" | "sha512";
+}, {
+    docId: string;
+    fieldKey: string;
+    sha: string;
+    algorithm: "sha256" | "sha1" | "sha384" | "sha512";
+}>;
+declare const DocVersionRevisionParamsSchema: z.ZodObject<{
+    docId: z.ZodString;
+} & {
+    sha: z.ZodString;
+} & {
+    index: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    docId: string;
+    sha: string;
+    index: number;
+}, {
+    docId: string;
+    sha: string;
+    index: number;
+}>;
+/** The flat analysis query: exactly one `since.*`; `level` only in exploratory mode. */
+declare const LayerSignaturesAnalysisQuerySchema: z.ZodObject<{
+    'since.signature': z.ZodOptional<z.ZodNumber>;
+    'since.revision': z.ZodOptional<z.ZodNumber>;
+    level: z.ZodOptional<z.ZodEnum<["none", "lta", "fill", "annotate"]>>;
+}, "strip", z.ZodTypeAny, {
+    'since.signature'?: number | undefined;
+    'since.revision'?: number | undefined;
+    level?: "fill" | "none" | "lta" | "annotate" | undefined;
+}, {
+    'since.signature'?: number | undefined;
+    'since.revision'?: number | undefined;
+    level?: "fill" | "none" | "lta" | "annotate" | undefined;
+}>;
+declare const VersionAnalysisQuerySchema: z.ZodObject<{
+    'since.signature': z.ZodOptional<z.ZodNumber>;
+    'since.revision': z.ZodOptional<z.ZodNumber>;
+    level: z.ZodOptional<z.ZodEnum<["none", "lta", "fill", "annotate"]>>;
+} & {
+    until: z.ZodOptional<z.ZodNumber>;
+    /** The judging policy version the caller expects — a cache key on this immutable URL, not an input. */
+    policy: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    'since.signature'?: number | undefined;
+    'since.revision'?: number | undefined;
+    level?: "fill" | "none" | "lta" | "annotate" | undefined;
+    until?: number | undefined;
+    policy?: number | undefined;
+}, {
+    'since.signature'?: number | undefined;
+    'since.revision'?: number | undefined;
+    level?: "fill" | "none" | "lta" | "annotate" | undefined;
+    until?: number | undefined;
+    policy?: number | undefined;
+}>;
 declare const docOperations: {
     readonly 'doc.head': {
         readonly operationId: "doc.head";
@@ -5750,123 +5860,98 @@ declare const docOperations: {
             };
         };
     };
-    readonly 'doc.render': {
-        readonly operationId: "doc.render";
-        readonly title: "Render page";
-        readonly summary: "Render one page as an image at the current layer version.";
+    readonly 'doc.signatures.list': {
+        readonly operationId: "doc.signatures.list";
+        readonly title: "List signatures";
+        readonly summary: "The layer view of digital signatures: revisions, every signature field with its signed state, and the protection in force.";
         readonly method: "GET";
-        readonly path: "/v1/docs/:docId/layers/:layerName/render/pages/:pon/data";
+        readonly path: "/v1/docs/:docId/layers/:layerName/signatures";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
-        readonly docCapabilities: readonly ["doc.render"];
+        readonly docCapabilities: readonly ["doc.forms.read"];
         readonly requestHeaders: readonly [AdminOperationHeader];
         readonly params: z.ZodObject<{
             docId: z.ZodString;
         } & {
             layerName: z.ZodString;
-        } & {
-            pon: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
             docId: string;
             layerName: string;
-            pon: number;
         }, {
             docId: string;
             layerName: string;
-            pon: number;
         }>;
-        readonly notes: string;
         readonly responses: {
             readonly 200: {
-                readonly contentType: "image/webp";
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SignatureSnapshot, z.ZodTypeDef, _embedpdf_engine_core_runtime.SignatureSnapshot>;
             };
             readonly 404: {
                 readonly contentType: "application/json";
                 readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
         };
+        readonly notes: string;
     };
-    readonly 'doc.text': {
-        readonly operationId: "doc.text";
-        readonly title: "Extract page text";
-        readonly summary: "Extracted text content for one page.";
+    readonly 'doc.signatures.analysis': {
+        readonly operationId: "doc.signatures.analysis";
+        readonly title: "Analyze layer changes";
+        readonly summary: "What the layer changed after a signature (or after any revision), judged against the restrictions in force.";
         readonly method: "GET";
-        readonly path: "/v1/docs/:docId/layers/:layerName/text/pages/:pon/data";
+        readonly path: "/v1/docs/:docId/layers/:layerName/signatures/analysis";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
-        readonly docCapabilities: readonly ["doc.text.copy"];
+        readonly docCapabilities: readonly ["doc.forms.read"];
         readonly requestHeaders: readonly [AdminOperationHeader];
         readonly params: z.ZodObject<{
             docId: z.ZodString;
         } & {
             layerName: z.ZodString;
-        } & {
-            pon: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
             docId: string;
             layerName: string;
-            pon: number;
         }, {
             docId: string;
             layerName: string;
-            pon: number;
         }>;
-        readonly responses: {
-            readonly 200: {
-                readonly contentType: "application/json";
-                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.PageTextSnapshot, z.ZodTypeDef, _embedpdf_engine_core_runtime.PageTextSnapshot>;
-            };
-            readonly 404: {
-                readonly contentType: "application/json";
-                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
-            };
-        };
-    };
-    readonly 'doc.annotations.list': {
-        readonly operationId: "doc.annotations.list";
-        readonly title: "List annotations";
-        readonly summary: "One page's annotations at the current layer version.";
-        readonly method: "GET";
-        readonly path: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pon/items";
-        readonly credentials: readonly ["api-token", "doc-jwt"];
-        readonly scope: readonly [];
-        readonly docCapabilities: readonly ["doc.annotate.read"];
-        readonly requestHeaders: readonly [AdminOperationHeader];
-        readonly params: z.ZodObject<{
-            docId: z.ZodString;
-        } & {
-            layerName: z.ZodString;
-        } & {
-            pon: z.ZodNumber;
+        readonly query: z.ZodObject<{
+            'since.signature': z.ZodOptional<z.ZodNumber>;
+            'since.revision': z.ZodOptional<z.ZodNumber>;
+            level: z.ZodOptional<z.ZodEnum<["none", "lta", "fill", "annotate"]>>;
         }, "strip", z.ZodTypeAny, {
-            docId: string;
-            layerName: string;
-            pon: number;
+            'since.signature'?: number | undefined;
+            'since.revision'?: number | undefined;
+            level?: "fill" | "none" | "lta" | "annotate" | undefined;
         }, {
-            docId: string;
-            layerName: string;
-            pon: number;
+            'since.signature'?: number | undefined;
+            'since.revision'?: number | undefined;
+            level?: "fill" | "none" | "lta" | "annotate" | undefined;
         }>;
         readonly responses: {
             readonly 200: {
                 readonly contentType: "application/json";
-                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.AnnotationListPageSnapshot, z.ZodTypeDef, _embedpdf_engine_core_runtime.AnnotationListPageSnapshot>;
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.ChangeAnalysis, z.ZodTypeDef, _embedpdf_engine_core_runtime.ChangeAnalysis>;
+            };
+            readonly 400: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
             readonly 404: {
                 readonly contentType: "application/json";
                 readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
         };
+        readonly notes: string;
     };
-    readonly 'doc.annotations.listAll': {
-        readonly operationId: "doc.annotations.listAll";
-        readonly title: "List all annotations";
-        readonly summary: "All pages' annotations as one coherent snapshot at the current layer version.";
-        readonly method: "GET";
-        readonly path: "/v1/docs/:docId/layers/:layerName/annotations/items";
+    readonly 'doc.signatures.prepare': {
+        readonly operationId: "doc.signatures.prepare";
+        readonly title: "Prepare a signature";
+        readonly summary: "Author and seal a signing candidate; returns the digest to sign and the version fences.";
+        readonly method: "POST";
+        readonly path: "/v1/docs/:docId/layers/:layerName/signatures/prepare";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
-        readonly docCapabilities: readonly ["doc.annotate.read"];
+        readonly docCapabilities: readonly ["doc.sign"];
         readonly requestHeaders: readonly [AdminOperationHeader];
         readonly params: z.ZodObject<{
             docId: z.ZodString;
@@ -5879,11 +5964,44 @@ declare const docOperations: {
             docId: string;
             layerName: string;
         }>;
-        readonly notes: "Returns one entry per page plus the audit-log cursor for reconciling subsequent document events. Page order is unspecified; join by `pageState.pageObjectNumber` when display order matters.";
+        readonly body: {
+            readonly contentType: "multipart/form-data";
+        };
         readonly responses: {
             readonly 200: {
                 readonly contentType: "application/json";
-                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.AnnotationListSnapshotAllPages, z.ZodTypeDef, _embedpdf_engine_core_runtime.AnnotationListSnapshotAllPages>;
+                readonly schema: z.ZodObject<{
+                    signingId: z.ZodString;
+                    digest: z.ZodString;
+                    algorithm: z.ZodEnum<["sha256", "sha384", "sha512"]>;
+                    byteRange: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+                    contentsSize: z.ZodNumber;
+                    subFilter: z.ZodString;
+                    expectedVersion: z.ZodType<_embedpdf_engine_core_runtime.DocumentVersionRef, z.ZodTypeDef, _embedpdf_engine_core_runtime.DocumentVersionRef>;
+                    expiresAt: z.ZodNullable<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    expiresAt: string | null;
+                    signingId: string;
+                    digest: string;
+                    algorithm: "sha256" | "sha384" | "sha512";
+                    byteRange: [number, number, number, number];
+                    contentsSize: number;
+                    subFilter: string;
+                    expectedVersion: _embedpdf_engine_core_runtime.DocumentVersionRef;
+                }, {
+                    expiresAt: string | null;
+                    signingId: string;
+                    digest: string;
+                    algorithm: "sha256" | "sha384" | "sha512";
+                    byteRange: [number, number, number, number];
+                    contentsSize: number;
+                    subFilter: string;
+                    expectedVersion: _embedpdf_engine_core_runtime.DocumentVersionRef;
+                }>;
+            };
+            readonly 400: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
             readonly 404: {
                 readonly contentType: "application/json";
@@ -5894,47 +6012,50 @@ declare const docOperations: {
                 readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
         };
+        readonly notes: string;
     };
-    readonly 'doc.annotations.create': {
-        readonly operationId: "doc.annotations.create";
-        readonly title: "Create annotation";
-        readonly summary: "Create an annotation on a page.";
+    readonly 'doc.signatures.complete': {
+        readonly operationId: "doc.signatures.complete";
+        readonly title: "Complete a signature";
+        readonly summary: "Install the CMS into the prepared candidate and publish the sealed bytes as the document's next base version.";
         readonly method: "POST";
-        readonly path: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pon/items";
+        readonly path: "/v1/docs/:docId/layers/:layerName/signatures/:signingId/complete";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
-        readonly docCapabilities: readonly ["doc.annotate.modify"];
+        readonly docCapabilities: readonly ["doc.sign"];
         readonly requestHeaders: readonly [AdminOperationHeader];
         readonly params: z.ZodObject<{
             docId: z.ZodString;
         } & {
             layerName: z.ZodString;
         } & {
-            pon: z.ZodNumber;
+            signingId: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             docId: string;
             layerName: string;
-            pon: number;
+            signingId: string;
         }, {
             docId: string;
             layerName: string;
-            pon: number;
+            signingId: string;
         }>;
         readonly body: {
             readonly contentType: "application/json";
-            readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            readonly schema: z.ZodObject<{
+                cms: z.ZodEffects<z.ZodString, string, string>;
+                expectedVersion: z.ZodType<_embedpdf_engine_core_runtime.DocumentVersionRef, z.ZodTypeDef, _embedpdf_engine_core_runtime.DocumentVersionRef>;
+            }, "strip", z.ZodTypeAny, {
+                expectedVersion: _embedpdf_engine_core_runtime.DocumentVersionRef;
+                cms: string;
+            }, {
+                expectedVersion: _embedpdf_engine_core_runtime.DocumentVersionRef;
+                cms: string;
+            }>;
         };
-        readonly notes: string;
         readonly responses: {
             readonly 200: {
                 readonly contentType: "application/json";
-                readonly schema: z.ZodObject<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, z.ZodTypeAny, "passthrough">>;
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SignatureCompleteResult, z.ZodTypeDef, _embedpdf_engine_core_runtime.SignatureCompleteResult>;
             };
             readonly 400: {
                 readonly contentType: "application/json";
@@ -5944,55 +6065,42 @@ declare const docOperations: {
                 readonly contentType: "application/json";
                 readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
+            readonly 409: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
         };
+        readonly notes: string;
     };
-    readonly 'doc.annotations.update': {
-        readonly operationId: "doc.annotations.update";
-        readonly title: "Update annotation";
-        readonly summary: "Update one annotation by key.";
-        readonly method: "PATCH";
-        readonly path: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pon/items/:annotKey";
+    readonly 'doc.signatures.abort': {
+        readonly operationId: "doc.signatures.abort";
+        readonly title: "Abort a signature";
+        readonly summary: "Discard a pending signing candidate.";
+        readonly method: "DELETE";
+        readonly path: "/v1/docs/:docId/layers/:layerName/signatures/:signingId";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
-        readonly docCapabilities: readonly ["doc.annotate.modify"];
+        readonly docCapabilities: readonly ["doc.sign"];
         readonly requestHeaders: readonly [AdminOperationHeader];
         readonly params: z.ZodObject<{
             docId: z.ZodString;
         } & {
             layerName: z.ZodString;
         } & {
-            pon: z.ZodNumber;
-        } & {
-            annotKey: z.ZodString;
+            signingId: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             docId: string;
             layerName: string;
-            pon: number;
-            annotKey: string;
+            signingId: string;
         }, {
             docId: string;
             layerName: string;
-            pon: number;
-            annotKey: string;
+            signingId: string;
         }>;
-        readonly body: {
-            readonly contentType: "application/json";
-            readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-        };
         readonly responses: {
             readonly 200: {
                 readonly contentType: "application/json";
-                readonly schema: z.ZodObject<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, z.ZodTypeAny, "passthrough">>;
-            };
-            readonly 400: {
-                readonly contentType: "application/json";
-                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SignatureAbortResult, z.ZodTypeDef, _embedpdf_engine_core_runtime.SignatureAbortResult>;
             };
             readonly 404: {
                 readonly contentType: "application/json";
@@ -6000,58 +6108,90 @@ declare const docOperations: {
             };
         };
     };
-    readonly 'doc.annotations.delete': {
-        readonly operationId: "doc.annotations.delete";
-        readonly title: "Delete annotation";
-        readonly summary: "Delete one annotation by key.";
-        readonly method: "DELETE";
-        readonly path: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pon/items/:annotKey";
+    readonly 'doc.versions.list': {
+        readonly operationId: "doc.versions.list";
+        readonly title: "List versions";
+        readonly summary: "The document's base versions, oldest first, and its head.";
+        readonly method: "GET";
+        readonly path: "/v1/docs/:docId/versions";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
-        readonly docCapabilities: readonly ["doc.annotate.modify"];
+        readonly docCapabilities: readonly ["doc.open"];
         readonly requestHeaders: readonly [AdminOperationHeader];
         readonly params: z.ZodObject<{
             docId: z.ZodString;
-        } & {
-            layerName: z.ZodString;
-        } & {
-            pon: z.ZodNumber;
-        } & {
-            annotKey: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             docId: string;
-            layerName: string;
-            pon: number;
-            annotKey: string;
         }, {
             docId: string;
-            layerName: string;
-            pon: number;
-            annotKey: string;
         }>;
         readonly responses: {
             readonly 200: {
                 readonly contentType: "application/json";
                 readonly schema: z.ZodObject<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, z.ZodTypeAny, "passthrough">>;
+                    head: z.ZodString;
+                    versions: z.ZodArray<z.ZodObject<{
+                        sha256: z.ZodString;
+                        byteLength: z.ZodNumber;
+                        number: z.ZodNumber;
+                        parentSha256: z.ZodNullable<z.ZodString>;
+                        producer: z.ZodEnum<["upload", "signature"]>;
+                        signingId: z.ZodNullable<z.ZodString>;
+                        createdAt: z.ZodNumber;
+                    }, "strip", z.ZodTypeAny, {
+                        number: number;
+                        signingId: string | null;
+                        sha256: string;
+                        byteLength: number;
+                        parentSha256: string | null;
+                        producer: "signature" | "upload";
+                        createdAt: number;
+                    }, {
+                        number: number;
+                        signingId: string | null;
+                        sha256: string;
+                        byteLength: number;
+                        parentSha256: string | null;
+                        producer: "signature" | "upload";
+                        createdAt: number;
+                    }>, "many">;
+                }, "strip", z.ZodTypeAny, {
+                    head: string;
+                    versions: {
+                        number: number;
+                        signingId: string | null;
+                        sha256: string;
+                        byteLength: number;
+                        parentSha256: string | null;
+                        producer: "signature" | "upload";
+                        createdAt: number;
+                    }[];
+                }, {
+                    head: string;
+                    versions: {
+                        number: number;
+                        signingId: string | null;
+                        sha256: string;
+                        byteLength: number;
+                        parentSha256: string | null;
+                        producer: "signature" | "upload";
+                        createdAt: number;
+                    }[];
+                }>;
             };
             readonly 404: {
                 readonly contentType: "application/json";
                 readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
         };
+        readonly notes: "Every completed signature publishes a new version. Never cached: the list grows.";
     };
-    readonly 'doc.forms.get': {
-        readonly operationId: "doc.forms.get";
-        readonly title: "Get form snapshot";
-        readonly summary: "Reconciled form snapshot: fields, widgets, values.";
+    readonly 'doc.versions.signatures': {
+        readonly operationId: "doc.versions.signatures";
+        readonly title: "Version signatures";
+        readonly summary: "The signature snapshot of one base version (immutable).";
         readonly method: "GET";
-        readonly path: "/v1/docs/:docId/layers/:layerName/form";
+        readonly path: "/v1/docs/:docId/versions/signatures/:sha";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
         readonly docCapabilities: readonly ["doc.forms.read"];
@@ -6059,18 +6199,18 @@ declare const docOperations: {
         readonly params: z.ZodObject<{
             docId: z.ZodString;
         } & {
-            layerName: z.ZodString;
+            sha: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             docId: string;
-            layerName: string;
+            sha: string;
         }, {
             docId: string;
-            layerName: string;
+            sha: string;
         }>;
         readonly responses: {
             readonly 200: {
                 readonly contentType: "application/json";
-                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.FormSnapshot, z.ZodTypeDef, _embedpdf_engine_core_runtime.FormSnapshot>;
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SignatureSnapshot, z.ZodTypeDef, _embedpdf_engine_core_runtime.SignatureSnapshot>;
             };
             readonly 404: {
                 readonly contentType: "application/json";
@@ -6078,104 +6218,88 @@ declare const docOperations: {
             };
         };
     };
-    readonly 'doc.forms.setValue': {
-        readonly operationId: "doc.forms.setValue";
-        readonly title: "Set form value";
-        readonly summary: "Set one form field's value.";
-        readonly method: "POST";
-        readonly path: "/v1/docs/:docId/layers/:layerName/form/fields/:fieldKey/value";
+    readonly 'doc.versions.signatureContents': {
+        readonly operationId: "doc.versions.signatureContents";
+        readonly title: "Signature contents";
+        readonly summary: "The DER /Contents of a signed field in one base version (immutable).";
+        readonly method: "GET";
+        readonly path: "/v1/docs/:docId/versions/signatures/:sha/:fieldKey/contents";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
-        readonly docCapabilities: readonly ["doc.forms.fill"];
+        readonly docCapabilities: readonly ["doc.forms.read"];
         readonly requestHeaders: readonly [AdminOperationHeader];
         readonly params: z.ZodObject<{
             docId: z.ZodString;
         } & {
-            layerName: z.ZodString;
+            sha: z.ZodString;
         } & {
             fieldKey: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             docId: string;
-            layerName: string;
             fieldKey: string;
+            sha: string;
         }, {
             docId: string;
-            layerName: string;
             fieldKey: string;
+            sha: string;
         }>;
-        readonly body: {
-            readonly contentType: "application/json";
-            readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-        };
         readonly responses: {
             readonly 200: {
-                readonly contentType: "application/json";
-                readonly schema: z.ZodObject<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, z.ZodTypeAny, "passthrough">>;
-            };
-            readonly 400: {
-                readonly contentType: "application/json";
-                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+                readonly contentType: "application/pkcs7-signature";
             };
             readonly 404: {
                 readonly contentType: "application/json";
                 readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
         };
+        readonly notes: "`fieldKey` is the field's fully qualified name, token-text encoded (the same encoding attachment keys use).";
     };
-    readonly 'doc.forms.reset': {
-        readonly operationId: "doc.forms.reset";
-        readonly title: "Reset form field";
-        readonly summary: "Reset one form field to its default value.";
-        readonly method: "POST";
-        readonly path: "/v1/docs/:docId/layers/:layerName/form/fields/:fieldKey/reset";
+    readonly 'doc.versions.signatureDigest': {
+        readonly operationId: "doc.versions.signatureDigest";
+        readonly title: "Signature digest";
+        readonly summary: "The digest of a signed field's /ByteRange in one base version (immutable).";
+        readonly method: "GET";
+        readonly path: "/v1/docs/:docId/versions/signatures/:sha/:fieldKey/digest/:algorithm";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
-        readonly docCapabilities: readonly ["doc.forms.fill"];
+        readonly docCapabilities: readonly ["doc.forms.read"];
         readonly requestHeaders: readonly [AdminOperationHeader];
         readonly params: z.ZodObject<{
             docId: z.ZodString;
         } & {
-            layerName: z.ZodString;
+            sha: z.ZodString;
         } & {
             fieldKey: z.ZodString;
+        } & {
+            algorithm: z.ZodEnum<["sha1", "sha256", "sha384", "sha512"]>;
         }, "strip", z.ZodTypeAny, {
             docId: string;
-            layerName: string;
             fieldKey: string;
+            sha: string;
+            algorithm: "sha256" | "sha1" | "sha384" | "sha512";
         }, {
             docId: string;
-            layerName: string;
             fieldKey: string;
+            sha: string;
+            algorithm: "sha256" | "sha1" | "sha384" | "sha512";
         }>;
         readonly responses: {
             readonly 200: {
-                readonly contentType: "application/json";
-                readonly schema: z.ZodObject<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, z.ZodTypeAny, "passthrough">>;
+                readonly contentType: "application/octet-stream";
             };
             readonly 404: {
                 readonly contentType: "application/json";
                 readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
         };
+        readonly notes: "What a CMS verifier compares its message digest to.";
     };
-    readonly 'doc.forms.exportData': {
-        readonly operationId: "doc.forms.exportData";
-        readonly title: "Export form data";
-        readonly summary: "Export form data as FDF or XFDF.";
+    readonly 'doc.versions.analysis': {
+        readonly operationId: "doc.versions.analysis";
+        readonly title: "Analyze version history";
+        readonly summary: "What changed between two revisions of one base version (immutable).";
         readonly method: "GET";
-        readonly path: "/v1/docs/:docId/layers/:layerName/form/data";
+        readonly path: "/v1/docs/:docId/versions/analysis/:sha";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
         readonly docCapabilities: readonly ["doc.forms.read"];
@@ -6183,116 +6307,146 @@ declare const docOperations: {
         readonly params: z.ZodObject<{
             docId: z.ZodString;
         } & {
-            layerName: z.ZodString;
+            sha: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             docId: string;
-            layerName: string;
+            sha: string;
         }, {
             docId: string;
-            layerName: string;
+            sha: string;
         }>;
         readonly query: z.ZodObject<{
-            format: z.ZodOptional<z.ZodEnum<["fdf", "xfdf"]>>;
+            'since.signature': z.ZodOptional<z.ZodNumber>;
+            'since.revision': z.ZodOptional<z.ZodNumber>;
+            level: z.ZodOptional<z.ZodEnum<["none", "lta", "fill", "annotate"]>>;
+        } & {
+            until: z.ZodOptional<z.ZodNumber>;
+            /** The judging policy version the caller expects — a cache key on this immutable URL, not an input. */
+            policy: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
-            format?: "fdf" | "xfdf" | undefined;
+            'since.signature'?: number | undefined;
+            'since.revision'?: number | undefined;
+            level?: "fill" | "none" | "lta" | "annotate" | undefined;
+            until?: number | undefined;
+            policy?: number | undefined;
         }, {
-            format?: "fdf" | "xfdf" | undefined;
+            'since.signature'?: number | undefined;
+            'since.revision'?: number | undefined;
+            level?: "fill" | "none" | "lta" | "annotate" | undefined;
+            until?: number | undefined;
+            policy?: number | undefined;
         }>;
         readonly responses: {
             readonly 200: {
-                readonly contentType: readonly ["application/vnd.adobe.xfdf", "application/vnd.fdf"];
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.ChangeAnalysis, z.ZodTypeDef, _embedpdf_engine_core_runtime.ChangeAnalysis>;
+            };
+            readonly 400: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
             readonly 404: {
                 readonly contentType: "application/json";
                 readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
         };
+        readonly notes: string;
     };
-    readonly 'doc.forms.importData': {
-        readonly operationId: "doc.forms.importData";
-        readonly title: "Import form data";
-        readonly summary: "Import form data (FDF/XFDF), filling matching fields.";
-        readonly method: "POST";
-        readonly path: "/v1/docs/:docId/layers/:layerName/form/data";
+    readonly 'doc.versions.download': {
+        readonly operationId: "doc.versions.download";
+        readonly title: "Download a version";
+        readonly summary: "The bytes of one base version (immutable).";
+        readonly method: "GET";
+        readonly path: "/v1/docs/:docId/versions/download/:sha";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
-        readonly docCapabilities: readonly ["doc.forms.fill"];
+        readonly docCapabilities: readonly ["doc.download"];
         readonly requestHeaders: readonly [AdminOperationHeader];
         readonly params: z.ZodObject<{
             docId: z.ZodString;
         } & {
-            layerName: z.ZodString;
+            sha: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             docId: string;
-            layerName: string;
+            sha: string;
         }, {
             docId: string;
-            layerName: string;
+            sha: string;
         }>;
-        readonly body: {
-            readonly contentType: "application/json";
-            readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-        };
         readonly responses: {
             readonly 200: {
-                readonly contentType: "application/json";
-                readonly schema: z.ZodObject<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, z.ZodTypeAny, "passthrough">>;
+                readonly contentType: "application/pdf";
             };
-            readonly 400: {
+            readonly 404: {
                 readonly contentType: "application/json";
                 readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
+        };
+    };
+    readonly 'doc.versions.revision': {
+        readonly operationId: "doc.versions.revision";
+        readonly title: "Download a revision";
+        readonly summary: "The byte prefix of one revision of a base version: exactly what a signature over it signed (immutable).";
+        readonly method: "GET";
+        readonly path: "/v1/docs/:docId/versions/revisions/:sha/:index";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.download"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            sha: z.ZodString;
+        } & {
+            index: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            sha: string;
+            index: number;
+        }, {
+            docId: string;
+            sha: string;
+            index: number;
+        }>;
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/pdf";
+            };
             readonly 404: {
                 readonly contentType: "application/json";
                 readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
         };
     };
-    readonly 'doc.pages.move': {
-        readonly operationId: "doc.pages.move";
-        readonly title: "Move pages";
-        readonly summary: "Reorder pages.";
-        readonly method: "POST";
-        readonly path: "/v1/docs/:docId/layers/:layerName/pages/move";
+    readonly 'doc.render': {
+        readonly operationId: "doc.render";
+        readonly title: "Render page";
+        readonly summary: "Render one page as an image at the current layer version.";
+        readonly method: "GET";
+        readonly path: "/v1/docs/:docId/layers/:layerName/render/pages/:pon/data";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
-        readonly docCapabilities: readonly ["doc.pages.assemble"];
+        readonly docCapabilities: readonly ["doc.render"];
         readonly requestHeaders: readonly [AdminOperationHeader];
         readonly params: z.ZodObject<{
             docId: z.ZodString;
         } & {
             layerName: z.ZodString;
+        } & {
+            pon: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
             docId: string;
             layerName: string;
+            pon: number;
         }, {
             docId: string;
             layerName: string;
+            pon: number;
         }>;
-        readonly body: {
-            readonly contentType: "application/json";
-            readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-        };
+        readonly notes: string;
         readonly responses: {
             readonly 200: {
-                readonly contentType: "application/json";
-                readonly schema: z.ZodObject<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, z.ZodTypeAny, "passthrough">>;
-            };
-            readonly 400: {
-                readonly contentType: "application/json";
-                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+                readonly contentType: "image/webp";
             };
             readonly 404: {
                 readonly contentType: "application/json";
@@ -6300,61 +6454,87 @@ declare const docOperations: {
             };
         };
     };
-    readonly 'doc.pages.rotate': {
-        readonly operationId: "doc.pages.rotate";
-        readonly title: "Rotate pages";
-        readonly summary: "Set absolute rotation on pages.";
-        readonly method: "POST";
-        readonly path: "/v1/docs/:docId/layers/:layerName/pages/rotate";
+    readonly 'doc.text': {
+        readonly operationId: "doc.text";
+        readonly title: "Extract page text";
+        readonly summary: "Extracted text content for one page.";
+        readonly method: "GET";
+        readonly path: "/v1/docs/:docId/layers/:layerName/text/pages/:pon/data";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
-        readonly docCapabilities: readonly ["doc.pages.assemble"];
+        readonly docCapabilities: readonly ["doc.text.copy"];
         readonly requestHeaders: readonly [AdminOperationHeader];
         readonly params: z.ZodObject<{
             docId: z.ZodString;
         } & {
             layerName: z.ZodString;
+        } & {
+            pon: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
             docId: string;
             layerName: string;
+            pon: number;
         }, {
             docId: string;
             layerName: string;
+            pon: number;
         }>;
-        readonly body: {
-            readonly contentType: "application/json";
-            readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-        };
         readonly responses: {
             readonly 200: {
                 readonly contentType: "application/json";
-                readonly schema: z.ZodObject<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, z.ZodTypeAny, "passthrough">>;
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.PageTextSnapshot, z.ZodTypeDef, _embedpdf_engine_core_runtime.PageTextSnapshot>;
             };
-            readonly 400: {
+            readonly 404: {
                 readonly contentType: "application/json";
                 readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
+        };
+    };
+    readonly 'doc.annotations.list': {
+        readonly operationId: "doc.annotations.list";
+        readonly title: "List annotations";
+        readonly summary: "One page's annotations at the current layer version.";
+        readonly method: "GET";
+        readonly path: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pon/items";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.annotate.read"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        } & {
+            pon: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+            pon: number;
+        }, {
+            docId: string;
+            layerName: string;
+            pon: number;
+        }>;
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.AnnotationListPageSnapshot, z.ZodTypeDef, _embedpdf_engine_core_runtime.AnnotationListPageSnapshot>;
+            };
             readonly 404: {
                 readonly contentType: "application/json";
                 readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
         };
     };
-    readonly 'doc.pages.delete': {
-        readonly operationId: "doc.pages.delete";
-        readonly title: "Delete pages";
-        readonly summary: "Delete pages.";
-        readonly method: "POST";
-        readonly path: "/v1/docs/:docId/layers/:layerName/pages/delete";
+    readonly 'doc.annotations.listAll': {
+        readonly operationId: "doc.annotations.listAll";
+        readonly title: "List all annotations";
+        readonly summary: "All pages' annotations as one coherent snapshot at the current layer version.";
+        readonly method: "GET";
+        readonly path: "/v1/docs/:docId/layers/:layerName/annotations/items";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
-        readonly docCapabilities: readonly ["doc.pages.assemble"];
+        readonly docCapabilities: readonly ["doc.annotate.read"];
         readonly requestHeaders: readonly [AdminOperationHeader];
         readonly params: z.ZodObject<{
             docId: z.ZodString;
@@ -6367,57 +6547,52 @@ declare const docOperations: {
             docId: string;
             layerName: string;
         }>;
-        readonly body: {
-            readonly contentType: "application/json";
-            readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-        };
+        readonly notes: "Returns one entry per page plus the audit-log cursor for reconciling subsequent document events. Page order is unspecified; join by `pageState.pageObjectNumber` when display order matters.";
         readonly responses: {
             readonly 200: {
                 readonly contentType: "application/json";
-                readonly schema: z.ZodObject<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
-                }, z.ZodTypeAny, "passthrough">>;
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.AnnotationListSnapshotAllPages, z.ZodTypeDef, _embedpdf_engine_core_runtime.AnnotationListSnapshotAllPages>;
             };
-            readonly 400: {
+            readonly 404: {
                 readonly contentType: "application/json";
                 readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
-            readonly 404: {
+            readonly 409: {
                 readonly contentType: "application/json";
                 readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
         };
     };
-    readonly 'doc.pages.flatten': {
-        readonly operationId: "doc.pages.flatten";
-        readonly title: "Flatten pages";
-        readonly summary: "Flatten annotations and form fields into page content.";
+    readonly 'doc.annotations.create': {
+        readonly operationId: "doc.annotations.create";
+        readonly title: "Create annotation";
+        readonly summary: "Create an annotation on a page.";
         readonly method: "POST";
-        readonly path: "/v1/docs/:docId/layers/:layerName/pages/flatten";
+        readonly path: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pon/items";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
-        readonly docCapabilities: readonly ["doc.pages.modify", "doc.annotate.modify"];
+        readonly docCapabilities: readonly ["doc.annotate.modify"];
         readonly requestHeaders: readonly [AdminOperationHeader];
         readonly params: z.ZodObject<{
             docId: z.ZodString;
         } & {
             layerName: z.ZodString;
+        } & {
+            pon: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
             docId: string;
             layerName: string;
+            pon: number;
         }, {
             docId: string;
             layerName: string;
+            pon: number;
         }>;
         readonly body: {
             readonly contentType: "application/json";
             readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-            readonly required: false;
         };
+        readonly notes: string;
         readonly responses: {
             readonly 200: {
                 readonly contentType: "application/json";
@@ -6439,29 +6614,38 @@ declare const docOperations: {
             };
         };
     };
-    readonly 'doc.pages.insert': {
-        readonly operationId: "doc.pages.insert";
-        readonly title: "Insert pages from a PDF";
-        readonly summary: "Copy every page of an uploaded PDF into the document at an index.";
-        readonly method: "POST";
-        readonly path: "/v1/docs/:docId/layers/:layerName/pages/insert";
+    readonly 'doc.annotations.update': {
+        readonly operationId: "doc.annotations.update";
+        readonly title: "Update annotation";
+        readonly summary: "Update one annotation by key.";
+        readonly method: "PATCH";
+        readonly path: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pon/items/:annotKey";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
-        readonly docCapabilities: readonly ["doc.pages.assemble"];
+        readonly docCapabilities: readonly ["doc.annotate.modify"];
         readonly requestHeaders: readonly [AdminOperationHeader];
         readonly params: z.ZodObject<{
             docId: z.ZodString;
         } & {
             layerName: z.ZodString;
+        } & {
+            pon: z.ZodNumber;
+        } & {
+            annotKey: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             docId: string;
             layerName: string;
+            pon: number;
+            annotKey: string;
         }, {
             docId: string;
             layerName: string;
+            pon: number;
+            annotKey: string;
         }>;
         readonly body: {
-            readonly contentType: "multipart/form-data";
+            readonly contentType: "application/json";
+            readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         };
         readonly responses: {
             readonly 200: {
@@ -6483,28 +6667,77 @@ declare const docOperations: {
                 readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
         };
-        readonly notes: "Multipart mutation envelope: a `body` field holding `{\"destIndex\"?: number}` (omitted → append) plus a `resource:source` file part carrying the standalone PDF whose pages are copied in. The inserted copies get fresh page object numbers, returned in insertion order.";
     };
-    readonly 'doc.pages.insertBlank': {
-        readonly operationId: "doc.pages.insertBlank";
-        readonly title: "Insert blank pages";
-        readonly summary: "Create blank pages of an explicit size at an index.";
+    readonly 'doc.annotations.delete': {
+        readonly operationId: "doc.annotations.delete";
+        readonly title: "Delete annotation";
+        readonly summary: "Delete one annotation by key.";
+        readonly method: "DELETE";
+        readonly path: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pon/items/:annotKey";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.annotate.modify"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        } & {
+            pon: z.ZodNumber;
+        } & {
+            annotKey: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+            pon: number;
+            annotKey: string;
+        }, {
+            docId: string;
+            layerName: string;
+            pon: number;
+            annotKey: string;
+        }>;
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodObject<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+    };
+    readonly 'doc.annotations.flatten': {
+        readonly operationId: "doc.annotations.flatten";
+        readonly title: "Flatten annotations";
+        readonly summary: "Flatten a chosen set of one page's annotations into its content — pages.flatten for a selection. Painted annotations are removed; ineligible ones report skipped.";
         readonly method: "POST";
-        readonly path: "/v1/docs/:docId/layers/:layerName/pages/insert-blank";
+        readonly path: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pon/items/flatten";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
-        readonly docCapabilities: readonly ["doc.pages.assemble"];
+        readonly docCapabilities: readonly ["doc.pages.modify", "doc.annotate.modify"];
         readonly requestHeaders: readonly [AdminOperationHeader];
         readonly params: z.ZodObject<{
             docId: z.ZodString;
         } & {
             layerName: z.ZodString;
+        } & {
+            pon: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
             docId: string;
             layerName: string;
+            pon: number;
         }, {
             docId: string;
             layerName: string;
+            pon: number;
         }>;
         readonly body: {
             readonly contentType: "application/json";
@@ -6530,14 +6763,13 @@ declare const docOperations: {
                 readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
         };
-        readonly notes: "Body is `{\"size\": {\"width\", \"height\"}, \"count\"?, \"destIndex\"?}` — size in PDF points, count in [1, 100], destIndex omitted → append.";
     };
-    readonly 'doc.pages.extract': {
-        readonly operationId: "doc.pages.extract";
-        readonly title: "Extract pages";
-        readonly summary: "Export the listed pages, in order, as a standalone PDF.";
+    readonly 'doc.annotations.exportAppearance': {
+        readonly operationId: "doc.annotations.exportAppearance";
+        readonly title: "Export annotation appearances";
+        readonly summary: "The chosen annotations' appearances as one single-page PDF sized to their union rect — vector, positions preserved. A read; the source is untouched.";
         readonly method: "POST";
-        readonly path: "/v1/docs/:docId/layers/:layerName/pages/extract";
+        readonly path: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pon/items/appearance";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
         readonly docCapabilities: readonly ["doc.download"];
@@ -6546,12 +6778,16 @@ declare const docOperations: {
             docId: z.ZodString;
         } & {
             layerName: z.ZodString;
+        } & {
+            pon: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
             docId: string;
             layerName: string;
+            pon: number;
         }, {
             docId: string;
             layerName: string;
+            pon: number;
         }>;
         readonly body: {
             readonly contentType: "application/json";
@@ -6570,33 +6806,67 @@ declare const docOperations: {
                 readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
         };
-        readonly notes: "A read, not a mutation: the source document is untouched and no event is published. Body is `{\"pageObjectNumbers\": number[]}`; the response body is the new PDF.";
     };
-    readonly 'doc.redactions.apply': {
-        readonly operationId: "doc.redactions.apply";
-        readonly title: "Apply redactions";
-        readonly summary: "Apply pending redactions, permanently removing content.";
+    readonly 'doc.forms.get': {
+        readonly operationId: "doc.forms.get";
+        readonly title: "Get form snapshot";
+        readonly summary: "Reconciled form snapshot: fields, widgets, values.";
+        readonly method: "GET";
+        readonly path: "/v1/docs/:docId/layers/:layerName/form";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.forms.read"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+        }, {
+            docId: string;
+            layerName: string;
+        }>;
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.FormSnapshot, z.ZodTypeDef, _embedpdf_engine_core_runtime.FormSnapshot>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+    };
+    readonly 'doc.forms.setValue': {
+        readonly operationId: "doc.forms.setValue";
+        readonly title: "Set form value";
+        readonly summary: "Set one form field's value.";
         readonly method: "POST";
-        readonly path: "/v1/docs/:docId/layers/:layerName/redactions/apply";
+        readonly path: "/v1/docs/:docId/layers/:layerName/form/fields/:fieldKey/value";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
-        readonly docCapabilities: readonly ["doc.pages.modify", "doc.annotate.modify", "doc.redact"];
+        readonly docCapabilities: readonly ["doc.forms.fill"];
         readonly requestHeaders: readonly [AdminOperationHeader];
         readonly params: z.ZodObject<{
             docId: z.ZodString;
         } & {
             layerName: z.ZodString;
+        } & {
+            fieldKey: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             docId: string;
             layerName: string;
+            fieldKey: string;
         }, {
             docId: string;
             layerName: string;
+            fieldKey: string;
         }>;
         readonly body: {
             readonly contentType: "application/json";
             readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-            readonly required: false;
         };
         readonly responses: {
             readonly 200: {
@@ -6619,30 +6889,41 @@ declare const docOperations: {
             };
         };
     };
-    readonly 'doc.download': {
-        readonly operationId: "doc.download";
-        readonly title: "Download PDF";
-        readonly summary: "Download the layer's current PDF (base plus layer edits).";
-        readonly method: "GET";
-        readonly path: "/v1/docs/:docId/layers/:layerName/download";
+    readonly 'doc.forms.reset': {
+        readonly operationId: "doc.forms.reset";
+        readonly title: "Reset form field";
+        readonly summary: "Reset one form field to its default value.";
+        readonly method: "POST";
+        readonly path: "/v1/docs/:docId/layers/:layerName/form/fields/:fieldKey/reset";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
-        readonly docCapabilities: readonly ["doc.download"];
+        readonly docCapabilities: readonly ["doc.forms.fill"];
         readonly requestHeaders: readonly [AdminOperationHeader];
         readonly params: z.ZodObject<{
             docId: z.ZodString;
         } & {
             layerName: z.ZodString;
+        } & {
+            fieldKey: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             docId: string;
             layerName: string;
+            fieldKey: string;
         }, {
             docId: string;
             layerName: string;
+            fieldKey: string;
         }>;
         readonly responses: {
             readonly 200: {
-                readonly contentType: "application/pdf";
+                readonly contentType: "application/json";
+                readonly schema: z.ZodObject<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">>;
             };
             readonly 404: {
                 readonly contentType: "application/json";
@@ -6650,55 +6931,627 @@ declare const docOperations: {
             };
         };
     };
-};
-type DocOperationId = keyof typeof docOperations;
-/** Every operation in the published contract: admin surfaces + doc plane. */
-declare const allOperations: {
-    readonly 'doc.head': {
-        readonly operationId: "doc.head";
-        readonly title: "Open document";
-        readonly summary: "Open a document and return its head (versions, page count, security).";
+    readonly 'doc.forms.exportData': {
+        readonly operationId: "doc.forms.exportData";
+        readonly title: "Export form data";
+        readonly summary: "Export form data as FDF or XFDF.";
         readonly method: "GET";
-        readonly path: "/v1/docs/:docId/head";
+        readonly path: "/v1/docs/:docId/layers/:layerName/form/data";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
-        readonly docCapabilities: readonly ["doc.open"];
+        readonly docCapabilities: readonly ["doc.forms.read"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+        }, {
+            docId: string;
+            layerName: string;
+        }>;
+        readonly query: z.ZodObject<{
+            format: z.ZodOptional<z.ZodEnum<["fdf", "xfdf"]>>;
+        }, "strip", z.ZodTypeAny, {
+            format?: "fdf" | "xfdf" | undefined;
+        }, {
+            format?: "fdf" | "xfdf" | undefined;
+        }>;
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: readonly ["application/vnd.adobe.xfdf", "application/vnd.fdf"];
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+    };
+    readonly 'doc.forms.importData': {
+        readonly operationId: "doc.forms.importData";
+        readonly title: "Import form data";
+        readonly summary: "Import form data (FDF/XFDF), filling matching fields.";
+        readonly method: "POST";
+        readonly path: "/v1/docs/:docId/layers/:layerName/form/data";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.forms.fill"];
         readonly requestHeaders: readonly [AdminOperationHeader];
         readonly params: z.ZodObject<{
             docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             docId: string;
+            layerName: string;
         }, {
             docId: string;
+            layerName: string;
         }>;
+        readonly body: {
+            readonly contentType: "application/json";
+            readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        };
         readonly responses: {
             readonly 200: {
                 readonly contentType: "application/json";
                 readonly schema: z.ZodObject<{
-                    id: z.ZodString;
-                    baseSha: z.ZodString;
-                    storageSizeBytes: z.ZodNumber;
-                    docVersion: z.ZodNumber;
-                    state: z.ZodEnum<["pending", "ready", "failed", "deleting"]>;
-                    encryption: z.ZodObject<{
-                        state: z.ZodEnum<["unknown", "none", "encrypted", "unsupported"]>;
-                        requiresPassword: z.ZodNullable<z.ZodBoolean>;
-                    }, "strip", z.ZodTypeAny, {
-                        state: "unknown" | "none" | "encrypted" | "unsupported";
-                        requiresPassword: boolean | null;
-                    }, {
-                        state: "unknown" | "none" | "encrypted" | "unsupported";
-                        requiresPassword: boolean | null;
-                    }>;
-                    permissions: z.ZodObject<{
-                        known: z.ZodBoolean;
-                        bits: z.ZodNullable<z.ZodNumber>;
-                        allAllowed: z.ZodNullable<z.ZodBoolean>;
-                        openedAs: z.ZodNullable<z.ZodEnum<["none", "user", "owner"]>>;
-                        securityHandlerRevision: z.ZodNullable<z.ZodNumber>;
-                        canUpgradeToOwner: z.ZodBoolean;
-                    }, "strip", z.ZodTypeAny, {
-                        known: boolean;
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">>;
+            };
+            readonly 400: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+    };
+    readonly 'doc.pages.move': {
+        readonly operationId: "doc.pages.move";
+        readonly title: "Move pages";
+        readonly summary: "Reorder pages.";
+        readonly method: "POST";
+        readonly path: "/v1/docs/:docId/layers/:layerName/pages/move";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.pages.assemble"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+        }, {
+            docId: string;
+            layerName: string;
+        }>;
+        readonly body: {
+            readonly contentType: "application/json";
+            readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        };
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodObject<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">>;
+            };
+            readonly 400: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+    };
+    readonly 'doc.pages.rotate': {
+        readonly operationId: "doc.pages.rotate";
+        readonly title: "Rotate pages";
+        readonly summary: "Set absolute rotation on pages.";
+        readonly method: "POST";
+        readonly path: "/v1/docs/:docId/layers/:layerName/pages/rotate";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.pages.assemble"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+        }, {
+            docId: string;
+            layerName: string;
+        }>;
+        readonly body: {
+            readonly contentType: "application/json";
+            readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        };
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodObject<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">>;
+            };
+            readonly 400: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+    };
+    readonly 'doc.pages.delete': {
+        readonly operationId: "doc.pages.delete";
+        readonly title: "Delete pages";
+        readonly summary: "Delete pages.";
+        readonly method: "POST";
+        readonly path: "/v1/docs/:docId/layers/:layerName/pages/delete";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.pages.assemble"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+        }, {
+            docId: string;
+            layerName: string;
+        }>;
+        readonly body: {
+            readonly contentType: "application/json";
+            readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        };
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodObject<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">>;
+            };
+            readonly 400: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+    };
+    readonly 'doc.pages.setName': {
+        readonly operationId: "doc.pages.setName";
+        readonly title: "Set page name";
+        readonly summary: "Register or rename a /Names /Pages entry (a named page). A page-structure mutation: the layout version advances.";
+        readonly method: "POST";
+        readonly path: "/v1/docs/:docId/layers/:layerName/pages/names";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.pages.assemble"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+        }, {
+            docId: string;
+            layerName: string;
+        }>;
+        readonly body: {
+            readonly contentType: "application/json";
+            readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        };
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodObject<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">>;
+            };
+            readonly 400: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+    };
+    readonly 'doc.pages.removeName': {
+        readonly operationId: "doc.pages.removeName";
+        readonly title: "Remove page name";
+        readonly summary: "Remove a /Names /Pages entry; the page itself stays.";
+        readonly method: "POST";
+        readonly path: "/v1/docs/:docId/layers/:layerName/pages/names/delete";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.pages.assemble"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+        }, {
+            docId: string;
+            layerName: string;
+        }>;
+        readonly body: {
+            readonly contentType: "application/json";
+            readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        };
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodObject<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">>;
+            };
+            readonly 400: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+    };
+    readonly 'doc.pages.flatten': {
+        readonly operationId: "doc.pages.flatten";
+        readonly title: "Flatten pages";
+        readonly summary: "Flatten annotations and form fields into page content.";
+        readonly method: "POST";
+        readonly path: "/v1/docs/:docId/layers/:layerName/pages/flatten";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.pages.modify", "doc.annotate.modify"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+        }, {
+            docId: string;
+            layerName: string;
+        }>;
+        readonly body: {
+            readonly contentType: "application/json";
+            readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            readonly required: false;
+        };
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodObject<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">>;
+            };
+            readonly 400: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+    };
+    readonly 'doc.pages.insert': {
+        readonly operationId: "doc.pages.insert";
+        readonly title: "Insert pages from a PDF";
+        readonly summary: "Copy every page of an uploaded PDF into the document at an index.";
+        readonly method: "POST";
+        readonly path: "/v1/docs/:docId/layers/:layerName/pages/insert";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.pages.assemble"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+        }, {
+            docId: string;
+            layerName: string;
+        }>;
+        readonly body: {
+            readonly contentType: "multipart/form-data";
+        };
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodObject<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">>;
+            };
+            readonly 400: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+        readonly notes: "Multipart mutation envelope: a `body` field holding `{\"destIndex\"?: number}` (omitted → append) plus a `resource:source` file part carrying the standalone PDF whose pages are copied in. The inserted copies get fresh page object numbers, returned in insertion order.";
+    };
+    readonly 'doc.pages.insertBlank': {
+        readonly operationId: "doc.pages.insertBlank";
+        readonly title: "Insert blank pages";
+        readonly summary: "Create blank pages of an explicit size at an index.";
+        readonly method: "POST";
+        readonly path: "/v1/docs/:docId/layers/:layerName/pages/insert-blank";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.pages.assemble"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+        }, {
+            docId: string;
+            layerName: string;
+        }>;
+        readonly body: {
+            readonly contentType: "application/json";
+            readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        };
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodObject<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">>;
+            };
+            readonly 400: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+        readonly notes: "Body is `{\"size\": {\"width\", \"height\"}, \"count\"?, \"destIndex\"?}` — size in PDF points, count in [1, 100], destIndex omitted → append.";
+    };
+    readonly 'doc.pages.extract': {
+        readonly operationId: "doc.pages.extract";
+        readonly title: "Extract pages";
+        readonly summary: "Export the listed pages, in order, as a standalone PDF.";
+        readonly method: "POST";
+        readonly path: "/v1/docs/:docId/layers/:layerName/pages/extract";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.download"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+        }, {
+            docId: string;
+            layerName: string;
+        }>;
+        readonly body: {
+            readonly contentType: "application/json";
+            readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        };
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/pdf";
+            };
+            readonly 400: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+        readonly notes: "A read, not a mutation: the source document is untouched and no event is published. Body is `{\"pageObjectNumbers\": number[]}`; the response body is the new PDF.";
+    };
+    readonly 'doc.redactions.apply': {
+        readonly operationId: "doc.redactions.apply";
+        readonly title: "Apply redactions";
+        readonly summary: "Apply pending redactions, permanently removing content.";
+        readonly method: "POST";
+        readonly path: "/v1/docs/:docId/layers/:layerName/redactions/apply";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.pages.modify", "doc.annotate.modify", "doc.redact"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+        }, {
+            docId: string;
+            layerName: string;
+        }>;
+        readonly body: {
+            readonly contentType: "application/json";
+            readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            readonly required: false;
+        };
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodObject<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">>;
+            };
+            readonly 400: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+    };
+    readonly 'doc.download': {
+        readonly operationId: "doc.download";
+        readonly title: "Download PDF";
+        readonly summary: "Download the layer's current PDF (base plus layer edits).";
+        readonly method: "GET";
+        readonly path: "/v1/docs/:docId/layers/:layerName/download";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.download"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+        }, {
+            docId: string;
+            layerName: string;
+        }>;
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/pdf";
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+    };
+};
+type DocOperationId = keyof typeof docOperations;
+/** Every operation in the published contract: admin surfaces + doc plane. */
+declare const allOperations: {
+    readonly 'doc.head': {
+        readonly operationId: "doc.head";
+        readonly title: "Open document";
+        readonly summary: "Open a document and return its head (versions, page count, security).";
+        readonly method: "GET";
+        readonly path: "/v1/docs/:docId/head";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.open"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+        }, {
+            docId: string;
+        }>;
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodObject<{
+                    id: z.ZodString;
+                    baseSha: z.ZodString;
+                    storageSizeBytes: z.ZodNumber;
+                    docVersion: z.ZodNumber;
+                    state: z.ZodEnum<["pending", "ready", "failed", "deleting"]>;
+                    encryption: z.ZodObject<{
+                        state: z.ZodEnum<["unknown", "none", "encrypted", "unsupported"]>;
+                        requiresPassword: z.ZodNullable<z.ZodBoolean>;
+                    }, "strip", z.ZodTypeAny, {
+                        state: "unknown" | "none" | "encrypted" | "unsupported";
+                        requiresPassword: boolean | null;
+                    }, {
+                        state: "unknown" | "none" | "encrypted" | "unsupported";
+                        requiresPassword: boolean | null;
+                    }>;
+                    permissions: z.ZodObject<{
+                        known: z.ZodBoolean;
+                        bits: z.ZodNullable<z.ZodNumber>;
+                        allAllowed: z.ZodNullable<z.ZodBoolean>;
+                        openedAs: z.ZodNullable<z.ZodEnum<["none", "user", "owner"]>>;
+                        securityHandlerRevision: z.ZodNullable<z.ZodNumber>;
+                        canUpgradeToOwner: z.ZodBoolean;
+                    }, "strip", z.ZodTypeAny, {
+                        known: boolean;
                         bits: number | null;
                         allAllowed: boolean | null;
                         openedAs: "none" | "user" | "owner" | null;
@@ -6717,60 +7570,449 @@ declare const allOperations: {
                         reasons: z.ZodArray<z.ZodEnum<["password", "cdn", "permissions-unknown"]>, "many">;
                         endpoint: z.ZodOptional<z.ZodString>;
                     }, "strip", z.ZodTypeAny, {
-                        required: boolean;
-                        reasons: ("password" | "cdn" | "permissions-unknown")[];
-                        endpoint?: string | undefined;
+                        required: boolean;
+                        reasons: ("password" | "cdn" | "permissions-unknown")[];
+                        endpoint?: string | undefined;
+                    }, {
+                        required: boolean;
+                        reasons: ("password" | "cdn" | "permissions-unknown")[];
+                        endpoint?: string | undefined;
+                    }>;
+                }, "strip", z.ZodTypeAny, {
+                    id: string;
+                    baseSha: string;
+                    storageSizeBytes: number;
+                    docVersion: number;
+                    state: "pending" | "ready" | "failed" | "deleting";
+                    encryption: {
+                        state: "unknown" | "none" | "encrypted" | "unsupported";
+                        requiresPassword: boolean | null;
+                    };
+                    permissions: {
+                        known: boolean;
+                        bits: number | null;
+                        allAllowed: boolean | null;
+                        openedAs: "none" | "user" | "owner" | null;
+                        securityHandlerRevision: number | null;
+                        canUpgradeToOwner: boolean;
+                    };
+                    access: {
+                        required: boolean;
+                        reasons: ("password" | "cdn" | "permissions-unknown")[];
+                        endpoint?: string | undefined;
+                    };
+                }, {
+                    id: string;
+                    baseSha: string;
+                    storageSizeBytes: number;
+                    docVersion: number;
+                    state: "pending" | "ready" | "failed" | "deleting";
+                    encryption: {
+                        state: "unknown" | "none" | "encrypted" | "unsupported";
+                        requiresPassword: boolean | null;
+                    };
+                    permissions: {
+                        known: boolean;
+                        bits: number | null;
+                        allAllowed: boolean | null;
+                        openedAs: "none" | "user" | "owner" | null;
+                        securityHandlerRevision: number | null;
+                        canUpgradeToOwner: boolean;
+                    };
+                    access: {
+                        required: boolean;
+                        reasons: ("password" | "cdn" | "permissions-unknown")[];
+                        endpoint?: string | undefined;
+                    };
+                }>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+    };
+    readonly 'doc.manifest': {
+        readonly operationId: "doc.manifest";
+        readonly title: "Get manifest";
+        readonly summary: "Full layer manifest at the layer's current version.";
+        readonly method: "GET";
+        readonly path: "/v1/docs/:docId/layers/:layerName/manifest";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.open"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+        }, {
+            docId: string;
+            layerName: string;
+        }>;
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.DocumentManifest, z.ZodTypeDef, _embedpdf_engine_core_runtime.DocumentManifest>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+    };
+    readonly 'doc.metadata.get': {
+        readonly operationId: "doc.metadata.get";
+        readonly title: "Get metadata";
+        readonly summary: "Document metadata (PDF info dictionary view) for a layer.";
+        readonly method: "GET";
+        readonly path: "/v1/docs/:docId/layers/:layerName/metadata";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.open"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+        }, {
+            docId: string;
+            layerName: string;
+        }>;
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.DocumentMetadata, z.ZodTypeDef, _embedpdf_engine_core_runtime.DocumentMetadata>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+    };
+    readonly 'doc.signatures.list': {
+        readonly operationId: "doc.signatures.list";
+        readonly title: "List signatures";
+        readonly summary: "The layer view of digital signatures: revisions, every signature field with its signed state, and the protection in force.";
+        readonly method: "GET";
+        readonly path: "/v1/docs/:docId/layers/:layerName/signatures";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.forms.read"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+        }, {
+            docId: string;
+            layerName: string;
+        }>;
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SignatureSnapshot, z.ZodTypeDef, _embedpdf_engine_core_runtime.SignatureSnapshot>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+        readonly notes: string;
+    };
+    readonly 'doc.signatures.analysis': {
+        readonly operationId: "doc.signatures.analysis";
+        readonly title: "Analyze layer changes";
+        readonly summary: "What the layer changed after a signature (or after any revision), judged against the restrictions in force.";
+        readonly method: "GET";
+        readonly path: "/v1/docs/:docId/layers/:layerName/signatures/analysis";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.forms.read"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+        }, {
+            docId: string;
+            layerName: string;
+        }>;
+        readonly query: z.ZodObject<{
+            'since.signature': z.ZodOptional<z.ZodNumber>;
+            'since.revision': z.ZodOptional<z.ZodNumber>;
+            level: z.ZodOptional<z.ZodEnum<["none", "lta", "fill", "annotate"]>>;
+        }, "strip", z.ZodTypeAny, {
+            'since.signature'?: number | undefined;
+            'since.revision'?: number | undefined;
+            level?: "fill" | "none" | "lta" | "annotate" | undefined;
+        }, {
+            'since.signature'?: number | undefined;
+            'since.revision'?: number | undefined;
+            level?: "fill" | "none" | "lta" | "annotate" | undefined;
+        }>;
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.ChangeAnalysis, z.ZodTypeDef, _embedpdf_engine_core_runtime.ChangeAnalysis>;
+            };
+            readonly 400: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+        readonly notes: string;
+    };
+    readonly 'doc.signatures.prepare': {
+        readonly operationId: "doc.signatures.prepare";
+        readonly title: "Prepare a signature";
+        readonly summary: "Author and seal a signing candidate; returns the digest to sign and the version fences.";
+        readonly method: "POST";
+        readonly path: "/v1/docs/:docId/layers/:layerName/signatures/prepare";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.sign"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+        }, {
+            docId: string;
+            layerName: string;
+        }>;
+        readonly body: {
+            readonly contentType: "multipart/form-data";
+        };
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodObject<{
+                    signingId: z.ZodString;
+                    digest: z.ZodString;
+                    algorithm: z.ZodEnum<["sha256", "sha384", "sha512"]>;
+                    byteRange: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+                    contentsSize: z.ZodNumber;
+                    subFilter: z.ZodString;
+                    expectedVersion: z.ZodType<_embedpdf_engine_core_runtime.DocumentVersionRef, z.ZodTypeDef, _embedpdf_engine_core_runtime.DocumentVersionRef>;
+                    expiresAt: z.ZodNullable<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    expiresAt: string | null;
+                    signingId: string;
+                    digest: string;
+                    algorithm: "sha256" | "sha384" | "sha512";
+                    byteRange: [number, number, number, number];
+                    contentsSize: number;
+                    subFilter: string;
+                    expectedVersion: _embedpdf_engine_core_runtime.DocumentVersionRef;
+                }, {
+                    expiresAt: string | null;
+                    signingId: string;
+                    digest: string;
+                    algorithm: "sha256" | "sha384" | "sha512";
+                    byteRange: [number, number, number, number];
+                    contentsSize: number;
+                    subFilter: string;
+                    expectedVersion: _embedpdf_engine_core_runtime.DocumentVersionRef;
+                }>;
+            };
+            readonly 400: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+            readonly 409: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+        readonly notes: string;
+    };
+    readonly 'doc.signatures.complete': {
+        readonly operationId: "doc.signatures.complete";
+        readonly title: "Complete a signature";
+        readonly summary: "Install the CMS into the prepared candidate and publish the sealed bytes as the document's next base version.";
+        readonly method: "POST";
+        readonly path: "/v1/docs/:docId/layers/:layerName/signatures/:signingId/complete";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.sign"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        } & {
+            signingId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+            signingId: string;
+        }, {
+            docId: string;
+            layerName: string;
+            signingId: string;
+        }>;
+        readonly body: {
+            readonly contentType: "application/json";
+            readonly schema: z.ZodObject<{
+                cms: z.ZodEffects<z.ZodString, string, string>;
+                expectedVersion: z.ZodType<_embedpdf_engine_core_runtime.DocumentVersionRef, z.ZodTypeDef, _embedpdf_engine_core_runtime.DocumentVersionRef>;
+            }, "strip", z.ZodTypeAny, {
+                expectedVersion: _embedpdf_engine_core_runtime.DocumentVersionRef;
+                cms: string;
+            }, {
+                expectedVersion: _embedpdf_engine_core_runtime.DocumentVersionRef;
+                cms: string;
+            }>;
+        };
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SignatureCompleteResult, z.ZodTypeDef, _embedpdf_engine_core_runtime.SignatureCompleteResult>;
+            };
+            readonly 400: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+            readonly 409: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+        readonly notes: string;
+    };
+    readonly 'doc.signatures.abort': {
+        readonly operationId: "doc.signatures.abort";
+        readonly title: "Abort a signature";
+        readonly summary: "Discard a pending signing candidate.";
+        readonly method: "DELETE";
+        readonly path: "/v1/docs/:docId/layers/:layerName/signatures/:signingId";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.sign"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        } & {
+            signingId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+            signingId: string;
+        }, {
+            docId: string;
+            layerName: string;
+            signingId: string;
+        }>;
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SignatureAbortResult, z.ZodTypeDef, _embedpdf_engine_core_runtime.SignatureAbortResult>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+    };
+    readonly 'doc.versions.list': {
+        readonly operationId: "doc.versions.list";
+        readonly title: "List versions";
+        readonly summary: "The document's base versions, oldest first, and its head.";
+        readonly method: "GET";
+        readonly path: "/v1/docs/:docId/versions";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.open"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+        }, {
+            docId: string;
+        }>;
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodObject<{
+                    head: z.ZodString;
+                    versions: z.ZodArray<z.ZodObject<{
+                        sha256: z.ZodString;
+                        byteLength: z.ZodNumber;
+                        number: z.ZodNumber;
+                        parentSha256: z.ZodNullable<z.ZodString>;
+                        producer: z.ZodEnum<["upload", "signature"]>;
+                        signingId: z.ZodNullable<z.ZodString>;
+                        createdAt: z.ZodNumber;
+                    }, "strip", z.ZodTypeAny, {
+                        number: number;
+                        signingId: string | null;
+                        sha256: string;
+                        byteLength: number;
+                        parentSha256: string | null;
+                        producer: "signature" | "upload";
+                        createdAt: number;
                     }, {
-                        required: boolean;
-                        reasons: ("password" | "cdn" | "permissions-unknown")[];
-                        endpoint?: string | undefined;
-                    }>;
+                        number: number;
+                        signingId: string | null;
+                        sha256: string;
+                        byteLength: number;
+                        parentSha256: string | null;
+                        producer: "signature" | "upload";
+                        createdAt: number;
+                    }>, "many">;
                 }, "strip", z.ZodTypeAny, {
-                    id: string;
-                    baseSha: string;
-                    storageSizeBytes: number;
-                    docVersion: number;
-                    state: "pending" | "ready" | "failed" | "deleting";
-                    encryption: {
-                        state: "unknown" | "none" | "encrypted" | "unsupported";
-                        requiresPassword: boolean | null;
-                    };
-                    permissions: {
-                        known: boolean;
-                        bits: number | null;
-                        allAllowed: boolean | null;
-                        openedAs: "none" | "user" | "owner" | null;
-                        securityHandlerRevision: number | null;
-                        canUpgradeToOwner: boolean;
-                    };
-                    access: {
-                        required: boolean;
-                        reasons: ("password" | "cdn" | "permissions-unknown")[];
-                        endpoint?: string | undefined;
-                    };
+                    head: string;
+                    versions: {
+                        number: number;
+                        signingId: string | null;
+                        sha256: string;
+                        byteLength: number;
+                        parentSha256: string | null;
+                        producer: "signature" | "upload";
+                        createdAt: number;
+                    }[];
                 }, {
-                    id: string;
-                    baseSha: string;
-                    storageSizeBytes: number;
-                    docVersion: number;
-                    state: "pending" | "ready" | "failed" | "deleting";
-                    encryption: {
-                        state: "unknown" | "none" | "encrypted" | "unsupported";
-                        requiresPassword: boolean | null;
-                    };
-                    permissions: {
-                        known: boolean;
-                        bits: number | null;
-                        allAllowed: boolean | null;
-                        openedAs: "none" | "user" | "owner" | null;
-                        securityHandlerRevision: number | null;
-                        canUpgradeToOwner: boolean;
-                    };
-                    access: {
-                        required: boolean;
-                        reasons: ("password" | "cdn" | "permissions-unknown")[];
-                        endpoint?: string | undefined;
-                    };
+                    head: string;
+                    versions: {
+                        number: number;
+                        signingId: string | null;
+                        sha256: string;
+                        byteLength: number;
+                        parentSha256: string | null;
+                        producer: "signature" | "upload";
+                        createdAt: number;
+                    }[];
                 }>;
             };
             readonly 404: {
@@ -6778,64 +8020,233 @@ declare const allOperations: {
                 readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
         };
+        readonly notes: "Every completed signature publishes a new version. Never cached: the list grows.";
+    };
+    readonly 'doc.versions.signatures': {
+        readonly operationId: "doc.versions.signatures";
+        readonly title: "Version signatures";
+        readonly summary: "The signature snapshot of one base version (immutable).";
+        readonly method: "GET";
+        readonly path: "/v1/docs/:docId/versions/signatures/:sha";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.forms.read"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            sha: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            sha: string;
+        }, {
+            docId: string;
+            sha: string;
+        }>;
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SignatureSnapshot, z.ZodTypeDef, _embedpdf_engine_core_runtime.SignatureSnapshot>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+    };
+    readonly 'doc.versions.signatureContents': {
+        readonly operationId: "doc.versions.signatureContents";
+        readonly title: "Signature contents";
+        readonly summary: "The DER /Contents of a signed field in one base version (immutable).";
+        readonly method: "GET";
+        readonly path: "/v1/docs/:docId/versions/signatures/:sha/:fieldKey/contents";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.forms.read"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            sha: z.ZodString;
+        } & {
+            fieldKey: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            fieldKey: string;
+            sha: string;
+        }, {
+            docId: string;
+            fieldKey: string;
+            sha: string;
+        }>;
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/pkcs7-signature";
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+        readonly notes: "`fieldKey` is the field's fully qualified name, token-text encoded (the same encoding attachment keys use).";
     };
-    readonly 'doc.manifest': {
-        readonly operationId: "doc.manifest";
-        readonly title: "Get manifest";
-        readonly summary: "Full layer manifest at the layer's current version.";
+    readonly 'doc.versions.signatureDigest': {
+        readonly operationId: "doc.versions.signatureDigest";
+        readonly title: "Signature digest";
+        readonly summary: "The digest of a signed field's /ByteRange in one base version (immutable).";
         readonly method: "GET";
-        readonly path: "/v1/docs/:docId/layers/:layerName/manifest";
+        readonly path: "/v1/docs/:docId/versions/signatures/:sha/:fieldKey/digest/:algorithm";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
-        readonly docCapabilities: readonly ["doc.open"];
+        readonly docCapabilities: readonly ["doc.forms.read"];
         readonly requestHeaders: readonly [AdminOperationHeader];
         readonly params: z.ZodObject<{
             docId: z.ZodString;
         } & {
-            layerName: z.ZodString;
+            sha: z.ZodString;
+        } & {
+            fieldKey: z.ZodString;
+        } & {
+            algorithm: z.ZodEnum<["sha1", "sha256", "sha384", "sha512"]>;
         }, "strip", z.ZodTypeAny, {
             docId: string;
-            layerName: string;
+            fieldKey: string;
+            sha: string;
+            algorithm: "sha256" | "sha1" | "sha384" | "sha512";
         }, {
             docId: string;
-            layerName: string;
+            fieldKey: string;
+            sha: string;
+            algorithm: "sha256" | "sha1" | "sha384" | "sha512";
         }>;
         readonly responses: {
             readonly 200: {
+                readonly contentType: "application/octet-stream";
+            };
+            readonly 404: {
                 readonly contentType: "application/json";
-                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.DocumentManifest, z.ZodTypeDef, _embedpdf_engine_core_runtime.DocumentManifest>;
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+        readonly notes: "What a CMS verifier compares its message digest to.";
+    };
+    readonly 'doc.versions.analysis': {
+        readonly operationId: "doc.versions.analysis";
+        readonly title: "Analyze version history";
+        readonly summary: "What changed between two revisions of one base version (immutable).";
+        readonly method: "GET";
+        readonly path: "/v1/docs/:docId/versions/analysis/:sha";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.forms.read"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            sha: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            sha: string;
+        }, {
+            docId: string;
+            sha: string;
+        }>;
+        readonly query: z.ZodObject<{
+            'since.signature': z.ZodOptional<z.ZodNumber>;
+            'since.revision': z.ZodOptional<z.ZodNumber>;
+            level: z.ZodOptional<z.ZodEnum<["none", "lta", "fill", "annotate"]>>;
+        } & {
+            until: z.ZodOptional<z.ZodNumber>;
+            /** The judging policy version the caller expects — a cache key on this immutable URL, not an input. */
+            policy: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            'since.signature'?: number | undefined;
+            'since.revision'?: number | undefined;
+            level?: "fill" | "none" | "lta" | "annotate" | undefined;
+            until?: number | undefined;
+            policy?: number | undefined;
+        }, {
+            'since.signature'?: number | undefined;
+            'since.revision'?: number | undefined;
+            level?: "fill" | "none" | "lta" | "annotate" | undefined;
+            until?: number | undefined;
+            policy?: number | undefined;
+        }>;
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.ChangeAnalysis, z.ZodTypeDef, _embedpdf_engine_core_runtime.ChangeAnalysis>;
+            };
+            readonly 400: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
             readonly 404: {
                 readonly contentType: "application/json";
                 readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
             };
         };
+        readonly notes: string;
     };
-    readonly 'doc.metadata.get': {
-        readonly operationId: "doc.metadata.get";
-        readonly title: "Get metadata";
-        readonly summary: "Document metadata (PDF info dictionary view) for a layer.";
+    readonly 'doc.versions.download': {
+        readonly operationId: "doc.versions.download";
+        readonly title: "Download a version";
+        readonly summary: "The bytes of one base version (immutable).";
         readonly method: "GET";
-        readonly path: "/v1/docs/:docId/layers/:layerName/metadata";
+        readonly path: "/v1/docs/:docId/versions/download/:sha";
         readonly credentials: readonly ["api-token", "doc-jwt"];
         readonly scope: readonly [];
-        readonly docCapabilities: readonly ["doc.open"];
+        readonly docCapabilities: readonly ["doc.download"];
         readonly requestHeaders: readonly [AdminOperationHeader];
         readonly params: z.ZodObject<{
             docId: z.ZodString;
         } & {
-            layerName: z.ZodString;
+            sha: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             docId: string;
-            layerName: string;
+            sha: string;
         }, {
             docId: string;
-            layerName: string;
+            sha: string;
         }>;
         readonly responses: {
             readonly 200: {
+                readonly contentType: "application/pdf";
+            };
+            readonly 404: {
                 readonly contentType: "application/json";
-                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.DocumentMetadata, z.ZodTypeDef, _embedpdf_engine_core_runtime.DocumentMetadata>;
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+    };
+    readonly 'doc.versions.revision': {
+        readonly operationId: "doc.versions.revision";
+        readonly title: "Download a revision";
+        readonly summary: "The byte prefix of one revision of a base version: exactly what a signature over it signed (immutable).";
+        readonly method: "GET";
+        readonly path: "/v1/docs/:docId/versions/revisions/:sha/:index";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.download"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            sha: z.ZodString;
+        } & {
+            index: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            sha: string;
+            index: number;
+        }, {
+            docId: string;
+            sha: string;
+            index: number;
+        }>;
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/pdf";
             };
             readonly 404: {
                 readonly contentType: "application/json";
@@ -7139,6 +8550,99 @@ declare const allOperations: {
             };
         };
     };
+    readonly 'doc.annotations.flatten': {
+        readonly operationId: "doc.annotations.flatten";
+        readonly title: "Flatten annotations";
+        readonly summary: "Flatten a chosen set of one page's annotations into its content — pages.flatten for a selection. Painted annotations are removed; ineligible ones report skipped.";
+        readonly method: "POST";
+        readonly path: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pon/items/flatten";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.pages.modify", "doc.annotate.modify"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        } & {
+            pon: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+            pon: number;
+        }, {
+            docId: string;
+            layerName: string;
+            pon: number;
+        }>;
+        readonly body: {
+            readonly contentType: "application/json";
+            readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        };
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodObject<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">>;
+            };
+            readonly 400: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+    };
+    readonly 'doc.annotations.exportAppearance': {
+        readonly operationId: "doc.annotations.exportAppearance";
+        readonly title: "Export annotation appearances";
+        readonly summary: "The chosen annotations' appearances as one single-page PDF sized to their union rect — vector, positions preserved. A read; the source is untouched.";
+        readonly method: "POST";
+        readonly path: "/v1/docs/:docId/layers/:layerName/annotations/pages/:pon/items/appearance";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.download"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        } & {
+            pon: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+            pon: number;
+        }, {
+            docId: string;
+            layerName: string;
+            pon: number;
+        }>;
+        readonly body: {
+            readonly contentType: "application/json";
+            readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        };
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/pdf";
+            };
+            readonly 400: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+    };
     readonly 'doc.forms.get': {
         readonly operationId: "doc.forms.get";
         readonly title: "Get form snapshot";
@@ -7485,6 +8989,98 @@ declare const allOperations: {
             };
         };
     };
+    readonly 'doc.pages.setName': {
+        readonly operationId: "doc.pages.setName";
+        readonly title: "Set page name";
+        readonly summary: "Register or rename a /Names /Pages entry (a named page). A page-structure mutation: the layout version advances.";
+        readonly method: "POST";
+        readonly path: "/v1/docs/:docId/layers/:layerName/pages/names";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.pages.assemble"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+        }, {
+            docId: string;
+            layerName: string;
+        }>;
+        readonly body: {
+            readonly contentType: "application/json";
+            readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        };
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodObject<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">>;
+            };
+            readonly 400: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+    };
+    readonly 'doc.pages.removeName': {
+        readonly operationId: "doc.pages.removeName";
+        readonly title: "Remove page name";
+        readonly summary: "Remove a /Names /Pages entry; the page itself stays.";
+        readonly method: "POST";
+        readonly path: "/v1/docs/:docId/layers/:layerName/pages/names/delete";
+        readonly credentials: readonly ["api-token", "doc-jwt"];
+        readonly scope: readonly [];
+        readonly docCapabilities: readonly ["doc.pages.assemble"];
+        readonly requestHeaders: readonly [AdminOperationHeader];
+        readonly params: z.ZodObject<{
+            docId: z.ZodString;
+        } & {
+            layerName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            docId: string;
+            layerName: string;
+        }, {
+            docId: string;
+            layerName: string;
+        }>;
+        readonly body: {
+            readonly contentType: "application/json";
+            readonly schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        };
+        readonly responses: {
+            readonly 200: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodObject<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+                    meta: z.ZodType<_embedpdf_engine_core_runtime.MutationMeta, z.ZodTypeDef, _embedpdf_engine_core_runtime.MutationMeta>;
+                }, z.ZodTypeAny, "passthrough">>;
+            };
+            readonly 400: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+            readonly 404: {
+                readonly contentType: "application/json";
+                readonly schema: z.ZodType<_embedpdf_engine_core_runtime.SerializedEngineError, z.ZodTypeDef, _embedpdf_engine_core_runtime.SerializedEngineError>;
+            };
+        };
+    };
     readonly 'doc.pages.flatten': {
         readonly operationId: "doc.pages.flatten";
         readonly title: "Flatten pages";
@@ -11156,6 +12752,12 @@ declare const docsGroups: {
     readonly 'doc.redactions': {
         readonly title: "Redactions";
     };
+    readonly 'doc.signatures': {
+        readonly title: "Digital signatures";
+    };
+    readonly 'doc.versions': {
+        readonly title: "Versions";
+    };
 };
 
-export { ADMIN_DOCUMENT_LIST_DEFAULT_LIMIT, ADMIN_DOCUMENT_LIST_MAX_LIMIT, type AdminCredential, type AdminDocumentCommitRequest, AdminDocumentCommitRequestSchema, type AdminDocumentCommitResponse, AdminDocumentCommitResponseSchema, type AdminDocumentImportRequest, AdminDocumentImportRequestSchema, type AdminDocumentImportResponse, AdminDocumentImportResponseSchema, type AdminDocumentInitRequest, AdminDocumentInitRequestSchema, type AdminDocumentInitResponse, AdminDocumentInitResponseSchema, type AdminDocumentListQuery, AdminDocumentListQuerySchema, type AdminDocumentListResponse, AdminDocumentListResponseSchema, type AdminDocumentRecord, AdminDocumentRecordSchema, type AdminDocumentResponse, AdminDocumentResponseSchema, type AdminErrorPayload, AdminErrorPayloadSchema, type AdminImportSource, AdminImportSourceSchema, type AdminInitUpload, AdminInitUploadSchema, type AdminLicenseStatusResponse, AdminLicenseStatusResponseSchema, type AdminOperation, type AdminOperationBody, type AdminOperationHeader, type AdminOperationId, type AdminOperationMethod, type AdminOperationResponse, type AdminPresignedUpload, AdminPresignedUploadSchema, type AdminTenantCreateRequest, AdminTenantCreateRequestSchema, type AdminTenantCreateResponse, AdminTenantCreateResponseSchema, type AdminTenantDocParams, AdminTenantDocParamsSchema, type AdminTenantJtiParams, AdminTenantJtiParamsSchema, type AdminTenantListQuery, AdminTenantListQuerySchema, type AdminTenantListResponse, AdminTenantListResponseSchema, type AdminTenantParams, AdminTenantParamsSchema, type AdminTenantRecord, AdminTenantRecordSchema, type AdminTenantResponse, AdminTenantResponseSchema, type AdminTenantScope, type AdminTenantShareParams, AdminTenantShareParamsSchema, type AdminThumbnailUnavailablePayload, AdminThumbnailUnavailablePayloadSchema, type AdminTokenIssueDocRequest, AdminTokenIssueDocRequestSchema, type AdminTokenIssueRequest, AdminTokenIssueRequestSchema, type AdminTokenIssueResponse, AdminTokenIssueResponseSchema, type AdminTokenIssueTenantRequest, AdminTokenIssueTenantRequestSchema, type AdminTokenRevokeRequest, AdminTokenRevokeRequestSchema, type AdminUploadProxyResponse, AdminUploadProxyResponseSchema, type DedupMode, DedupModeSchema, DocAnnotationParamsSchema, DocFieldParamsSchema, DocIdParamsSchema, DocLayerParamsSchema, type DocOperationId, DocPageParamsSchema, type DocsGroup, type DocumentState, DocumentStateSchema, type ShareExchangeRequest, ShareExchangeRequestSchema, type ShareGrantCreateRequest, ShareGrantCreateRequestSchema, type ShareGrantListQuery, ShareGrantListQuerySchema, type ShareGrantListResponse, ShareGrantListResponseSchema, type ShareGrantRecord, ShareGrantRecordSchema, type ShareGrantResponse, ShareGrantResponseSchema, type ShareGrantUpdateRequest, ShareGrantUpdateRequestSchema, type ShareSessionResponse, ShareSessionResponseSchema, type TenantSuspendRequest, TenantSuspendRequestSchema, type TenantUsageQuery, TenantUsageQuerySchema, type TenantUsageResponse, TenantUsageResponseSchema, type UploadPreference, UploadPreferenceSchema, adminCredentials, adminOperations, adminTenantScopes, adminWirePaths, allOperations, docOperations, docsGroups, documentPasswordHeader, tenantIdPattern };
+export { ADMIN_DOCUMENT_LIST_DEFAULT_LIMIT, ADMIN_DOCUMENT_LIST_MAX_LIMIT, type AdminCredential, type AdminDocumentCommitRequest, AdminDocumentCommitRequestSchema, type AdminDocumentCommitResponse, AdminDocumentCommitResponseSchema, type AdminDocumentImportRequest, AdminDocumentImportRequestSchema, type AdminDocumentImportResponse, AdminDocumentImportResponseSchema, type AdminDocumentInitRequest, AdminDocumentInitRequestSchema, type AdminDocumentInitResponse, AdminDocumentInitResponseSchema, type AdminDocumentListQuery, AdminDocumentListQuerySchema, type AdminDocumentListResponse, AdminDocumentListResponseSchema, type AdminDocumentRecord, AdminDocumentRecordSchema, type AdminDocumentResponse, AdminDocumentResponseSchema, type AdminErrorPayload, AdminErrorPayloadSchema, type AdminImportSource, AdminImportSourceSchema, type AdminInitUpload, AdminInitUploadSchema, type AdminLicenseStatusResponse, AdminLicenseStatusResponseSchema, type AdminOperation, type AdminOperationBody, type AdminOperationHeader, type AdminOperationId, type AdminOperationMethod, type AdminOperationResponse, type AdminPresignedUpload, AdminPresignedUploadSchema, type AdminTenantCreateRequest, AdminTenantCreateRequestSchema, type AdminTenantCreateResponse, AdminTenantCreateResponseSchema, type AdminTenantDocParams, AdminTenantDocParamsSchema, type AdminTenantJtiParams, AdminTenantJtiParamsSchema, type AdminTenantListQuery, AdminTenantListQuerySchema, type AdminTenantListResponse, AdminTenantListResponseSchema, type AdminTenantParams, AdminTenantParamsSchema, type AdminTenantRecord, AdminTenantRecordSchema, type AdminTenantResponse, AdminTenantResponseSchema, type AdminTenantScope, type AdminTenantShareParams, AdminTenantShareParamsSchema, type AdminThumbnailUnavailablePayload, AdminThumbnailUnavailablePayloadSchema, type AdminTokenIssueDocRequest, AdminTokenIssueDocRequestSchema, type AdminTokenIssueRequest, AdminTokenIssueRequestSchema, type AdminTokenIssueResponse, AdminTokenIssueResponseSchema, type AdminTokenIssueTenantRequest, AdminTokenIssueTenantRequestSchema, type AdminTokenRevokeRequest, AdminTokenRevokeRequestSchema, type AdminUploadProxyResponse, AdminUploadProxyResponseSchema, type DedupMode, DedupModeSchema, DocAnnotationParamsSchema, DocFieldParamsSchema, DocIdParamsSchema, DocLayerParamsSchema, type DocOperationId, DocPageParamsSchema, DocSigningParamsSchema, DocVersionDigestParamsSchema, DocVersionFieldParamsSchema, DocVersionParamsSchema, DocVersionRevisionParamsSchema, type DocsGroup, type DocumentState, DocumentStateSchema, LayerSignaturesAnalysisQuerySchema, type ShareExchangeRequest, ShareExchangeRequestSchema, type ShareGrantCreateRequest, ShareGrantCreateRequestSchema, type ShareGrantListQuery, ShareGrantListQuerySchema, type ShareGrantListResponse, ShareGrantListResponseSchema, type ShareGrantRecord, ShareGrantRecordSchema, type ShareGrantResponse, ShareGrantResponseSchema, type ShareGrantUpdateRequest, ShareGrantUpdateRequestSchema, type ShareSessionResponse, ShareSessionResponseSchema, type TenantSuspendRequest, TenantSuspendRequestSchema, type TenantUsageQuery, TenantUsageQuerySchema, type TenantUsageResponse, TenantUsageResponseSchema, type UploadPreference, UploadPreferenceSchema, VersionAnalysisQuerySchema, adminCredentials, adminOperations, adminTenantScopes, adminWirePaths, allOperations, docOperations, docsGroups, documentPasswordHeader, tenantIdPattern };