@finueva/drive 0.3.0 → 0.5.0

package/dist/contract.d.ts

@@ -132,12 +132,9 @@ interface operations {
       };
     };
   };
-  listFolderChildren: {
+  getItem: {
     parameters: {
-      query?: {
-        limit?: number;
-        cursor?: string;
-      };
+      query?: never;
       header?: never;
       path: {
         workspaceId: string;
@@ -147,30 +144,33 @@ interface operations {
     };
     requestBody?: never;
     responses: {
-      /** @description At most 50 active children in stable item-ID order. */
+      /** @description The active managed item and current published version metadata. */
       200: {
         headers: {
+          /** @description Strong precondition for the next item mutation. */
+          ETag?: string;
           [name: string]: unknown;
         };
         content: {
           "application/json": {
-            items: {
-              itemId: string;
+            currentVersion: {
+              byteLength: number;
+              mediaType: string;
               /** @enum {string} */
-              kind: "file" | "folder";
-              /**
-               * Format: finueva-safe-filename
-               * @description NFC-normalized filename of at most 255 Unicode code points and 255 UTF-8 bytes. Slash, backslash, control characters, U+2028/U+2029, trailing dot/space, dot entries, and Windows reserved base names are forbidden.
-               */
-              name: string;
-              parentItemId: string;
-              revision: number;
+              protectionClassification: "ordinary" | "opaque-encrypted";
               /** @enum {string} */
-              visibility: "workspace" | "restricted";
-              volumeId: string;
-              workspaceId: string;
-            }[];
-            nextCursor: string | null;
+              state: "current";
+              versionId: string;
+            } | null;
+            itemId: string;
+            /** @enum {string} */
+            lifecycleState: "active";
+            name: string;
+            parentId: string | null;
+            revision: number;
+            /** @enum {string} */
+            type: "file" | "folder";
+            workspaceId: string;
           };
         };
       };
@@ -192,7 +192,7 @@ interface operations {
           };
         };
       };
-      /** @description Managed storage is disabled for the canonical workspace entitlement. */
+      /** @description Managed storage is disabled for the discoverable item. */
       403: {
         headers: {
           [name: string]: unknown;
@@ -210,7 +210,7 @@ interface operations {
           };
         };
       };
-      /** @description The parent is absent or undiscoverable. */
+      /** @description The item is absent, undiscoverable, tombstoned, or unpublished. */
       404: {
         headers: {
           [name: string]: unknown;
@@ -228,7 +228,7 @@ interface operations {
           };
         };
       };
-      /** @description Folder authority changed after preflight. */
+      /** @description Authorization or metadata changed after preflight. */
       409: {
         headers: {
           [name: string]: unknown;
@@ -246,7 +246,7 @@ interface operations {
           };
         };
       };
-      /** @description The path, query, or cursor is invalid. */
+      /** @description The path, query, or unexpected body is invalid. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -261,19 +261,10 @@ interface operations {
               message: "The request is invalid.";
               requestId: string;
             };
-          } | {
-            error: {
-              /** @enum {string} */
-              code: "invalid_pagination_cursor";
-              details: Record<string, never>;
-              /** @enum {string} */
-              message: "The pagination cursor is invalid.";
-              requestId: string;
-            };
           };
         };
       };
-      /** @description Identity authority, D1, authorization evidence, or required cursor keys are unavailable. */
+      /** @description Identity, D1, authorization, capacity, or managed authority is unavailable. */
       503: {
         headers: {
           [name: string]: unknown;
@@ -302,11 +293,12 @@ interface operations {
       };
     };
   };
-  createFolder: {
+  deleteItem: {
     parameters: {
       query?: never;
       header: {
         "Idempotency-Key": string;
+        "If-Match": string;
       };
       path: {
         workspaceId: string;
@@ -314,21 +306,13 @@ interface operations {
       };
       cookie?: never;
     };
-    requestBody: {
-      content: {
-        "application/json": {
-          /**
-           * Format: finueva-safe-filename
-           * @description NFC-normalized filename of at most 255 Unicode code points and 255 UTF-8 bytes. Slash, backslash, control characters, U+2028/U+2029, trailing dot/space, dot entries, and Windows reserved base names are forbidden.
-           */
-          name: string;
-        };
-      };
-    };
+    requestBody?: never;
     responses: {
-      /** @description The exact committed folder is replayed. */
+      /** @description The retained deletion result was exactly replayed. */
       200: {
         headers: {
+          /** @description Strong precondition for the next item mutation. */
+          ETag?: string;
           [name: string]: unknown;
         };
         content: {
@@ -336,23 +320,22 @@ interface operations {
             itemId: string;
             /** @enum {string} */
             kind: "file" | "folder";
-            /**
-             * Format: finueva-safe-filename
-             * @description NFC-normalized filename of at most 255 Unicode code points and 255 UTF-8 bytes. Slash, backslash, control characters, U+2028/U+2029, trailing dot/space, dot entries, and Windows reserved base names are forbidden.
-             */
             name: string;
             parentItemId: string;
+            purgeAfterEpochMilliseconds: number | null;
             revision: number;
             /** @enum {string} */
-            visibility: "workspace" | "restricted";
+            state: "active" | "trashed" | "deleting";
             volumeId: string;
             workspaceId: string;
           };
         };
       };
-      /** @description The folder is committed. */
-      201: {
+      /** @description Deletion was retained and bounded reconciliation was attempted. */
+      202: {
         headers: {
+          /** @description Strong precondition for the next item mutation. */
+          ETag?: string;
           [name: string]: unknown;
         };
         content: {
@@ -360,15 +343,12 @@ interface operations {
             itemId: string;
             /** @enum {string} */
             kind: "file" | "folder";
-            /**
-             * Format: finueva-safe-filename
-             * @description NFC-normalized filename of at most 255 Unicode code points and 255 UTF-8 bytes. Slash, backslash, control characters, U+2028/U+2029, trailing dot/space, dot entries, and Windows reserved base names are forbidden.
-             */
             name: string;
             parentItemId: string;
+            purgeAfterEpochMilliseconds: number | null;
             revision: number;
             /** @enum {string} */
-            visibility: "workspace" | "restricted";
+            state: "active" | "trashed" | "deleting";
             volumeId: string;
             workspaceId: string;
           };
@@ -392,7 +372,7 @@ interface operations {
           };
         };
       };
-      /** @description The discoverable parent does not permit folder creation. */
+      /** @description The discoverable item does not permit this lifecycle action. */
       403: {
         headers: {
           [name: string]: unknown;
@@ -410,7 +390,7 @@ interface operations {
           };
         };
       };
-      /** @description The parent is absent or undiscoverable. */
+      /** @description The item or destination is absent or undiscoverable. */
       404: {
         headers: {
           [name: string]: unknown;
@@ -428,7 +408,7 @@ interface operations {
           };
         };
       };
-      /** @description The idempotency key conflicts or folder authority changed after preflight. */
+      /** @description The key conflicts, the precondition is stale, or lifecycle authority changed. */
       409: {
         headers: {
           [name: string]: unknown;
@@ -455,7 +435,7 @@ interface operations {
           };
         };
       };
-      /** @description The path, idempotency key, body, or name is invalid. */
+      /** @description The path, query, headers, key, or strict body is invalid. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -482,7 +462,7 @@ interface operations {
           };
         };
       };
-      /** @description Identity authority, D1, authorization evidence, or trusted capacity evidence is unavailable. */
+      /** @description Identity, D1, authorization, capacity, or archive authority is unavailable. */
       503: {
         headers: {
           [name: string]: unknown;
@@ -511,56 +491,48 @@ interface operations {
       };
     };
   };
-  listItemPermissions: {
+  updateItem: {
     parameters: {
-      query?: {
-        limit?: number;
-        cursor?: string;
+      query?: never;
+      header: {
+        "Idempotency-Key": string;
+        "If-Match": string;
       };
-      header?: never;
       path: {
         workspaceId: string;
         itemId: string;
       };
       cookie?: never;
     };
-    requestBody?: never;
+    requestBody: {
+      content: {
+        "application/json": {
+          name: string;
+          parentItemId: string;
+        };
+      };
+    };
     responses: {
-      /** @description A stable permission page. */
+      /** @description The managed item was updated or exactly replayed. */
       200: {
         headers: {
-          /** @description Current direct collection precondition for POST on this item. */
-          "Drive-Permission-Collection-ETag"?: string;
-          /** @description Strong validator for the exact returned permission-list representation. */
+          /** @description Strong precondition for the next item mutation. */
           ETag?: string;
           [name: string]: unknown;
         };
         content: {
           "application/json": {
-            collectionEtag: string;
-            collectionRevision: number;
-            items: {
-              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
-              /** @enum {string} */
-              availability: "active" | "expired" | "revoked";
-              etag: string;
-              expiresAtEpochMilliseconds: number | null;
-              grantId: string;
-              grantee: {
-                /** @enum {string} */
-                type: "user";
-                userId: string;
-              } | {
-                teamId: string;
-                /** @enum {string} */
-                type: "team";
-              };
-              revision: number;
-              /** @enum {string} */
-              source: "direct" | "inherited";
-              sourceItemId: string;
-            }[];
-            nextCursor: string | null;
+            itemId: string;
+            /** @enum {string} */
+            kind: "file" | "folder";
+            name: string;
+            parentItemId: string;
+            purgeAfterEpochMilliseconds: number | null;
+            revision: number;
+            /** @enum {string} */
+            state: "active" | "trashed" | "deleting";
+            volumeId: string;
+            workspaceId: string;
           };
         };
       };
@@ -582,7 +554,7 @@ interface operations {
           };
         };
       };
-      /** @description The discoverable item does not permit this permission operation. */
+      /** @description The discoverable item does not permit this lifecycle action. */
       403: {
         headers: {
           [name: string]: unknown;
@@ -600,7 +572,7 @@ interface operations {
           };
         };
       };
-      /** @description The item, principal, or direct grant is absent or undiscoverable. */
+      /** @description The item or destination is absent or undiscoverable. */
       404: {
         headers: {
           [name: string]: unknown;
@@ -618,13 +590,22 @@ interface operations {
           };
         };
       };
-      /** @description The supplied revision or post-preflight authority is stale. */
-      412: {
+      /** @description The key conflicts, the precondition is stale, or lifecycle authority changed. */
+      409: {
         headers: {
           [name: string]: unknown;
         };
         content: {
           "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "idempotency_conflict";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The idempotency key conflicts with an earlier request.";
+              requestId: string;
+            };
+          } | {
             error: {
               /** @enum {string} */
               code: "precondition_failed";
@@ -636,7 +617,7 @@ interface operations {
           };
         };
       };
-      /** @description The path, query, headers, or pagination cursor are invalid. */
+      /** @description The path, query, headers, key, or strict body is invalid. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -654,16 +635,16 @@ interface operations {
           } | {
             error: {
               /** @enum {string} */
-              code: "invalid_pagination_cursor";
+              code: "invalid_idempotency_key";
               details: Record<string, never>;
               /** @enum {string} */
-              message: "The pagination cursor is invalid.";
+              message: "The idempotency key is invalid.";
               requestId: string;
             };
           };
         };
       };
-      /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
+      /** @description Identity, D1, authorization, capacity, or archive authority is unavailable. */
       503: {
         headers: {
           [name: string]: unknown;
@@ -692,108 +673,1992 @@ interface operations {
       };
     };
   };
-  createItemPermission: {
+  listFolderChildren: {
     parameters: {
-      query?: never;
-      header: {
-        "Idempotency-Key": string;
-        "If-Match": string;
+      query?: {
+        limit?: number;
+        cursor?: string;
       };
+      header?: never;
       path: {
         workspaceId: string;
         itemId: string;
       };
       cookie?: never;
     };
-    requestBody: {
-      content: {
-        "application/json": {
-          actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
-          expiresAtEpochMilliseconds: number | null;
-          grantee: {
-            /** @enum {string} */
-            type: "user";
-            userId: string;
-          } | {
-            teamId: string;
-            /** @enum {string} */
-            type: "team";
-          };
-        };
-      };
-    };
+    requestBody?: never;
     responses: {
-      /** @description The exact committed result was replayed. */
+      /** @description At most 50 active children in stable item-ID order. */
       200: {
         headers: {
-          /** @description Current direct collection precondition for the next POST. */
-          "Drive-Permission-Collection-ETag"?: string;
-          /** @description Current direct-grant precondition for PATCH or DELETE; omitted when the current row is not mutable. */
-          "Drive-Permission-Grant-ETag"?: string;
           [name: string]: unknown;
         };
         content: {
           "application/json": {
-            collectionRevision: number;
-            grant: {
-              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+            items: {
+              itemId: string;
               /** @enum {string} */
-              availability: "active" | "expired" | "revoked";
-              expiresAtEpochMilliseconds: number | null;
-              grantId: string;
-              grantee: {
-                /** @enum {string} */
-                type: "user";
-                userId: string;
-              } | {
-                teamId: string;
-                /** @enum {string} */
-                type: "team";
-              };
+              kind: "file" | "folder";
+              /**
+               * Format: finueva-safe-filename
+               * @description NFC-normalized filename of at most 255 Unicode code points and 255 UTF-8 bytes. Slash, backslash, control characters, U+2028/U+2029, trailing dot/space, dot entries, and Windows reserved base names are forbidden.
+               */
+              name: string;
+              parentItemId: string;
               revision: number;
               /** @enum {string} */
-              source: "direct";
-              sourceItemId: string;
+              visibility: "workspace" | "restricted";
+              volumeId: string;
+              workspaceId: string;
+            }[];
+            nextCursor: string | null;
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is required.";
+              requestId: string;
             };
-            /** @enum {string} */
-            outcome: "committed" | "replayed";
           };
         };
       };
-      /** @description The direct grant was committed. */
-      201: {
+      /** @description Managed storage is disabled for the canonical workspace entitlement. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "permission_denied";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested action is not permitted.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The parent is absent or undiscoverable. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "resource_not_found";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested resource was not found.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Folder authority changed after preflight. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, query, or cursor is invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "invalid_request";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request is invalid.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "invalid_pagination_cursor";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The pagination cursor is invalid.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity authority, D1, authorization evidence, or required cursor keys are unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "identity_authority_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is temporarily unavailable.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "service_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The service is temporarily unavailable.";
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
+  createFolder: {
+    parameters: {
+      query?: never;
+      header: {
+        "Idempotency-Key": string;
+      };
+      path: {
+        workspaceId: string;
+        itemId: string;
+      };
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          /**
+           * Format: finueva-safe-filename
+           * @description NFC-normalized filename of at most 255 Unicode code points and 255 UTF-8 bytes. Slash, backslash, control characters, U+2028/U+2029, trailing dot/space, dot entries, and Windows reserved base names are forbidden.
+           */
+          name: string;
+        };
+      };
+    };
+    responses: {
+      /** @description The exact committed folder is replayed. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            itemId: string;
+            /** @enum {string} */
+            kind: "file" | "folder";
+            /**
+             * Format: finueva-safe-filename
+             * @description NFC-normalized filename of at most 255 Unicode code points and 255 UTF-8 bytes. Slash, backslash, control characters, U+2028/U+2029, trailing dot/space, dot entries, and Windows reserved base names are forbidden.
+             */
+            name: string;
+            parentItemId: string;
+            revision: number;
+            /** @enum {string} */
+            visibility: "workspace" | "restricted";
+            volumeId: string;
+            workspaceId: string;
+          };
+        };
+      };
+      /** @description The folder is committed. */
+      201: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            itemId: string;
+            /** @enum {string} */
+            kind: "file" | "folder";
+            /**
+             * Format: finueva-safe-filename
+             * @description NFC-normalized filename of at most 255 Unicode code points and 255 UTF-8 bytes. Slash, backslash, control characters, U+2028/U+2029, trailing dot/space, dot entries, and Windows reserved base names are forbidden.
+             */
+            name: string;
+            parentItemId: string;
+            revision: number;
+            /** @enum {string} */
+            visibility: "workspace" | "restricted";
+            volumeId: string;
+            workspaceId: string;
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is required.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The discoverable parent does not permit folder creation. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "permission_denied";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested action is not permitted.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The parent is absent or undiscoverable. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "resource_not_found";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested resource was not found.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The idempotency key conflicts or folder authority changed after preflight. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "idempotency_conflict";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The idempotency key conflicts with an earlier request.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, idempotency key, body, or name is invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "invalid_request";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request is invalid.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "invalid_idempotency_key";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The idempotency key is invalid.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity authority, D1, authorization evidence, or trusted capacity evidence is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "identity_authority_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is temporarily unavailable.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "service_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The service is temporarily unavailable.";
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
+  createDownload: {
+    parameters: {
+      query?: {
+        versionId?: string;
+      };
+      header: {
+        "Idempotency-Key": string;
+        "Download-Method"?: string;
+        Range?: string;
+        "If-Match"?: string;
+        "If-None-Match"?: string;
+        "If-Range"?: string;
+      };
+      path: {
+        workspaceId: string;
+        itemId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description A short-lived immutable archive capability. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            expiresAtEpochMilliseconds: number;
+            headers: {
+              [key: string]: string;
+            };
+            /** @enum {string} */
+            method: "GET" | "HEAD";
+            /** @enum {string} */
+            mode: "presigned-single";
+            response: {
+              /** @enum {string} */
+              acceptRanges: "bytes";
+              byteLength: number;
+              contentDisposition: string;
+              contentLength: number;
+              contentRange: string | null;
+              contentType: string;
+              etag: string;
+              status: 200 | 206;
+              versionId: string;
+            };
+            /** Format: uri */
+            url: string;
+          };
+        };
+      };
+      /** @description One idempotent cold archive retrieval operation. */
+      202: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            /** @enum {string} */
+            mode: "restore-pending";
+            operationId: string;
+            pollAfterSeconds: number;
+            /** @enum {string} */
+            state: "pending" | "restoring";
+            versionId: string;
+          };
+        };
+      };
+      /** @description The selected immutable representation is not modified. */
+      304: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The visible file cannot be downloaded under current authority. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "permission_denied";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The file or selected version is absent or undiscoverable. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "resource_not_found";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The retrieval key conflicts or immutable authority changed after preflight. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "idempotency_conflict";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description A content entity-tag precondition failed. */
+      412: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The valid single range does not overlap the representation. */
+      416: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "range_not_satisfiable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, query, headers, or unexpected body is invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "invalid_request";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity, D1, authorization, capacity, or archive authority is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "identity_authority_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
+  listItemPermissions: {
+    parameters: {
+      query?: {
+        limit?: number;
+        cursor?: string;
+      };
+      header?: never;
+      path: {
+        workspaceId: string;
+        itemId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description A stable permission page. */
+      200: {
+        headers: {
+          /** @description Current direct collection precondition for POST on this item. */
+          "Drive-Permission-Collection-ETag"?: string;
+          /** @description Strong validator for the exact returned permission-list representation. */
+          ETag?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            collectionEtag: string;
+            collectionRevision: number;
+            items: {
+              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+              /** @enum {string} */
+              availability: "active" | "expired" | "revoked";
+              etag: string;
+              expiresAtEpochMilliseconds: number | null;
+              grantId: string;
+              grantee: {
+                /** @enum {string} */
+                type: "user";
+                userId: string;
+              } | {
+                teamId: string;
+                /** @enum {string} */
+                type: "team";
+              };
+              revision: number;
+              /** @enum {string} */
+              source: "direct" | "inherited";
+              sourceItemId: string;
+            }[];
+            nextCursor: string | null;
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is required.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The discoverable item does not permit this permission operation. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "permission_denied";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested action is not permitted.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The item, principal, or direct grant is absent or undiscoverable. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "resource_not_found";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested resource was not found.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The supplied revision or post-preflight authority is stale. */
+      412: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, query, headers, or pagination cursor are invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "invalid_request";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request is invalid.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "invalid_pagination_cursor";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The pagination cursor is invalid.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "identity_authority_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is temporarily unavailable.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "service_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The service is temporarily unavailable.";
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
+  createItemPermission: {
+    parameters: {
+      query?: never;
+      header: {
+        "Idempotency-Key": string;
+        "If-Match": string;
+      };
+      path: {
+        workspaceId: string;
+        itemId: string;
+      };
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+          expiresAtEpochMilliseconds: number | null;
+          grantee: {
+            /** @enum {string} */
+            type: "user";
+            userId: string;
+          } | {
+            teamId: string;
+            /** @enum {string} */
+            type: "team";
+          };
+        };
+      };
+    };
+    responses: {
+      /** @description The exact committed result was replayed. */
+      200: {
+        headers: {
+          /** @description Current direct collection precondition for the next POST. */
+          "Drive-Permission-Collection-ETag"?: string;
+          /** @description Current direct-grant precondition for PATCH or DELETE; omitted when the current row is not mutable. */
+          "Drive-Permission-Grant-ETag"?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            collectionRevision: number;
+            grant: {
+              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+              /** @enum {string} */
+              availability: "active" | "expired" | "revoked";
+              expiresAtEpochMilliseconds: number | null;
+              grantId: string;
+              grantee: {
+                /** @enum {string} */
+                type: "user";
+                userId: string;
+              } | {
+                teamId: string;
+                /** @enum {string} */
+                type: "team";
+              };
+              revision: number;
+              /** @enum {string} */
+              source: "direct";
+              sourceItemId: string;
+            };
+            /** @enum {string} */
+            outcome: "committed" | "replayed";
+          };
+        };
+      };
+      /** @description The direct grant was committed. */
+      201: {
+        headers: {
+          /** @description Current direct collection precondition for the next POST. */
+          "Drive-Permission-Collection-ETag"?: string;
+          /** @description Current direct-grant precondition for PATCH or DELETE; omitted when the current row is not mutable. */
+          "Drive-Permission-Grant-ETag"?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            collectionRevision: number;
+            grant: {
+              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+              /** @enum {string} */
+              availability: "active" | "expired" | "revoked";
+              expiresAtEpochMilliseconds: number | null;
+              grantId: string;
+              grantee: {
+                /** @enum {string} */
+                type: "user";
+                userId: string;
+              } | {
+                teamId: string;
+                /** @enum {string} */
+                type: "team";
+              };
+              revision: number;
+              /** @enum {string} */
+              source: "direct";
+              sourceItemId: string;
+            };
+            /** @enum {string} */
+            outcome: "committed" | "replayed";
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is required.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The discoverable item does not permit this permission operation. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "permission_denied";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested action is not permitted.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The item, principal, or direct grant is absent or undiscoverable. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "resource_not_found";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested resource was not found.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The idempotency key was reused for a different semantic request. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "idempotency_conflict";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The idempotency key conflicts with an earlier request.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The supplied revision or post-preflight authority is stale. */
+      412: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, query, headers, idempotency key, or body are invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "invalid_request";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request is invalid.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "invalid_idempotency_key";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The idempotency key is invalid.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "identity_authority_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is temporarily unavailable.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "service_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The service is temporarily unavailable.";
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
+  readEffectiveItemPermissions: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        workspaceId: string;
+        itemId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description All seven caller-specific item actions. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            actions: {
+              /** @enum {string} */
+              action: "items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:manage" | "items:permissions:read" | "items:update";
+              allowed: boolean;
+              /** @enum {string|null} */
+              basis: "workspace_visibility" | "restricted_administrator_bypass" | "direct_grant" | "inherited_grant" | null;
+              grantId: string | null;
+              sourceItemId: string | null;
+            }[] & (unknown & unknown & unknown & unknown & unknown & unknown & unknown);
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is required.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The discoverable item does not permit this permission operation. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "permission_denied";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested action is not permitted.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The item, principal, or direct grant is absent or undiscoverable. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "resource_not_found";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested resource was not found.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The supplied revision or post-preflight authority is stale. */
+      412: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, query, headers, or body are invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "invalid_request";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request is invalid.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "identity_authority_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is temporarily unavailable.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "service_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The service is temporarily unavailable.";
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
+  revokeItemPermission: {
+    parameters: {
+      query?: never;
+      header: {
+        "Idempotency-Key": string;
+        "If-Match": string;
+      };
+      path: {
+        workspaceId: string;
+        itemId: string;
+        grantId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description The retained revoked grant was committed, replayed, or unchanged. */
+      200: {
+        headers: {
+          /** @description Current direct collection precondition for POST. */
+          "Drive-Permission-Collection-ETag"?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            collectionRevision: number;
+            grant: {
+              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+              /** @enum {string} */
+              availability: "active" | "expired" | "revoked";
+              expiresAtEpochMilliseconds: number | null;
+              grantId: string;
+              grantee: {
+                /** @enum {string} */
+                type: "user";
+                userId: string;
+              } | {
+                teamId: string;
+                /** @enum {string} */
+                type: "team";
+              };
+              revision: number;
+              /** @enum {string} */
+              source: "direct";
+              sourceItemId: string;
+            };
+            /** @enum {string} */
+            outcome: "committed" | "replayed";
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is required.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The discoverable item does not permit this permission operation. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "permission_denied";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested action is not permitted.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The item, principal, or direct grant is absent or undiscoverable. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "resource_not_found";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested resource was not found.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The idempotency key was reused for a different semantic request. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "idempotency_conflict";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The idempotency key conflicts with an earlier request.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The supplied revision or post-preflight authority is stale. */
+      412: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, query, headers, idempotency key, or body are invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "invalid_request";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request is invalid.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "invalid_idempotency_key";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The idempotency key is invalid.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "identity_authority_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is temporarily unavailable.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "service_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The service is temporarily unavailable.";
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
+  updateItemPermission: {
+    parameters: {
+      query?: never;
+      header: {
+        "Idempotency-Key": string;
+        "If-Match": string;
+      };
+      path: {
+        workspaceId: string;
+        itemId: string;
+        grantId: string;
+      };
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          actions?: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+          expiresAtEpochMilliseconds?: number | null;
+        };
+      };
+    };
+    responses: {
+      /** @description The direct grant was committed or replayed. */
+      200: {
+        headers: {
+          /** @description Current direct collection precondition for POST. */
+          "Drive-Permission-Collection-ETag"?: string;
+          /** @description Current direct-grant precondition for the next PATCH or DELETE; omitted when the current row is not mutable. */
+          "Drive-Permission-Grant-ETag"?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            collectionRevision: number;
+            grant: {
+              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+              /** @enum {string} */
+              availability: "active" | "expired" | "revoked";
+              expiresAtEpochMilliseconds: number | null;
+              grantId: string;
+              grantee: {
+                /** @enum {string} */
+                type: "user";
+                userId: string;
+              } | {
+                teamId: string;
+                /** @enum {string} */
+                type: "team";
+              };
+              revision: number;
+              /** @enum {string} */
+              source: "direct";
+              sourceItemId: string;
+            };
+            /** @enum {string} */
+            outcome: "committed" | "replayed";
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is required.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The discoverable item does not permit this permission operation. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "permission_denied";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested action is not permitted.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The item, principal, or direct grant is absent or undiscoverable. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "resource_not_found";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested resource was not found.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The idempotency key was reused for a different semantic request. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "idempotency_conflict";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The idempotency key conflicts with an earlier request.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The supplied revision or post-preflight authority is stale. */
+      412: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, query, headers, idempotency key, or body are invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "invalid_request";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request is invalid.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "invalid_idempotency_key";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The idempotency key is invalid.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "identity_authority_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is temporarily unavailable.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "service_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The service is temporarily unavailable.";
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
+  restoreItem: {
+    parameters: {
+      query?: never;
+      header: {
+        "Idempotency-Key": string;
+        "If-Match": string;
+      };
+      path: {
+        workspaceId: string;
+        itemId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description The managed item was restored or exactly replayed. */
+      200: {
+        headers: {
+          /** @description Strong precondition for the next item mutation. */
+          ETag?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            itemId: string;
+            /** @enum {string} */
+            kind: "file" | "folder";
+            name: string;
+            parentItemId: string;
+            purgeAfterEpochMilliseconds: number | null;
+            revision: number;
+            /** @enum {string} */
+            state: "active" | "trashed" | "deleting";
+            volumeId: string;
+            workspaceId: string;
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is required.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The discoverable item does not permit this lifecycle action. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "permission_denied";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested action is not permitted.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The item or destination is absent or undiscoverable. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "resource_not_found";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested resource was not found.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The key conflicts, the precondition is stale, or lifecycle authority changed. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "idempotency_conflict";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The idempotency key conflicts with an earlier request.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, query, headers, key, or strict body is invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "invalid_request";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request is invalid.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "invalid_idempotency_key";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The idempotency key is invalid.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity, D1, authorization, capacity, or archive authority is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "identity_authority_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is temporarily unavailable.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "service_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The service is temporarily unavailable.";
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
+  trashItem: {
+    parameters: {
+      query?: never;
+      header: {
+        "Idempotency-Key": string;
+        "If-Match": string;
+      };
+      path: {
+        workspaceId: string;
+        itemId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description The managed item was trashed or exactly replayed. */
+      200: {
+        headers: {
+          /** @description Strong precondition for the next item mutation. */
+          ETag?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            itemId: string;
+            /** @enum {string} */
+            kind: "file" | "folder";
+            name: string;
+            parentItemId: string;
+            purgeAfterEpochMilliseconds: number | null;
+            revision: number;
+            /** @enum {string} */
+            state: "active" | "trashed" | "deleting";
+            volumeId: string;
+            workspaceId: string;
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is required.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The discoverable item does not permit this lifecycle action. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "permission_denied";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested action is not permitted.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The item or destination is absent or undiscoverable. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "resource_not_found";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested resource was not found.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The key conflicts, the precondition is stale, or lifecycle authority changed. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "idempotency_conflict";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The idempotency key conflicts with an earlier request.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, query, headers, key, or strict body is invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "invalid_request";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request is invalid.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "invalid_idempotency_key";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The idempotency key is invalid.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity, D1, authorization, capacity, or archive authority is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "identity_authority_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is temporarily unavailable.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "service_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The service is temporarily unavailable.";
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
+  listItemVersions: {
+    parameters: {
+      query?: {
+        limit?: number;
+        cursor?: string;
+      };
+      header?: never;
+      path: {
+        workspaceId: string;
+        itemId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description At most 50 versions in version-ID order with an opaque 15-minute continuation cursor. */
+      200: {
         headers: {
-          /** @description Current direct collection precondition for the next POST. */
-          "Drive-Permission-Collection-ETag"?: string;
-          /** @description Current direct-grant precondition for PATCH or DELETE; omitted when the current row is not mutable. */
-          "Drive-Permission-Grant-ETag"?: string;
           [name: string]: unknown;
         };
         content: {
           "application/json": {
-            collectionRevision: number;
-            grant: {
-              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+            items: {
               /** @enum {string} */
-              availability: "active" | "expired" | "revoked";
-              expiresAtEpochMilliseconds: number | null;
-              grantId: string;
-              grantee: {
-                /** @enum {string} */
-                type: "user";
-                userId: string;
-              } | {
-                teamId: string;
-                /** @enum {string} */
-                type: "team";
-              };
+              archiveState: "available" | "cold" | "restoring" | "unavailable" | "corrupt";
+              byteLength: number;
+              contentDigest: string;
+              /**
+               * Format: finueva-safe-filename
+               * @description Custom format finueva-safe-filename requires NFC normalization and at most 255 UTF-8 bytes in addition to the structural pattern and maxLength constraints. Dot entries and Windows reserved base names are forbidden. Generated JSON Schema constraints are a necessary structural subset and do not independently enforce normalization or UTF-8 byte length.
+               */
+              displayFilename: string;
+              mediaType: string;
+              /** @enum {string} */
+              protectionClassification: "ordinary" | "opaque-encrypted";
               revision: number;
               /** @enum {string} */
-              source: "direct";
-              sourceItemId: string;
-            };
-            /** @enum {string} */
-            outcome: "committed" | "replayed";
+              state: "current" | "superseded";
+              versionId: string;
+            }[];
+            nextCursor: string | null;
           };
         };
       };
@@ -815,7 +2680,7 @@ interface operations {
           };
         };
       };
-      /** @description The discoverable item does not permit this permission operation. */
+      /** @description The discoverable item does not permit metadata reads. */
       403: {
         headers: {
           [name: string]: unknown;
@@ -833,7 +2698,7 @@ interface operations {
           };
         };
       };
-      /** @description The item, principal, or direct grant is absent or undiscoverable. */
+      /** @description The file is absent or undiscoverable. */
       404: {
         headers: {
           [name: string]: unknown;
@@ -851,26 +2716,8 @@ interface operations {
           };
         };
       };
-      /** @description The idempotency key was reused for a different semantic request. */
+      /** @description Authorization changed after preflight. */
       409: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": {
-            error: {
-              /** @enum {string} */
-              code: "idempotency_conflict";
-              details: Record<string, never>;
-              /** @enum {string} */
-              message: "The idempotency key conflicts with an earlier request.";
-              requestId: string;
-            };
-          };
-        };
-      };
-      /** @description The supplied revision or post-preflight authority is stale. */
-      412: {
         headers: {
           [name: string]: unknown;
         };
@@ -887,7 +2734,7 @@ interface operations {
           };
         };
       };
-      /** @description The path, query, headers, idempotency key, or body are invalid. */
+      /** @description The path, query, duplicate query key, or unexpected body is invalid. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -902,19 +2749,10 @@ interface operations {
               message: "The request is invalid.";
               requestId: string;
             };
-          } | {
-            error: {
-              /** @enum {string} */
-              code: "invalid_idempotency_key";
-              details: Record<string, never>;
-              /** @enum {string} */
-              message: "The idempotency key is invalid.";
-              requestId: string;
-            };
           };
         };
       };
-      /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
+      /** @description Identity, D1, or authorization authority is unavailable. */
       503: {
         headers: {
           [name: string]: unknown;
@@ -943,34 +2781,44 @@ interface operations {
       };
     };
   };
-  readEffectiveItemPermissions: {
+  getItemVersion: {
     parameters: {
       query?: never;
       header?: never;
       path: {
         workspaceId: string;
         itemId: string;
+        versionId: string;
       };
       cookie?: never;
     };
     requestBody?: never;
     responses: {
-      /** @description All seven caller-specific item actions. */
+      /** @description The exact workspace/item-bound immutable managed file version. */
       200: {
         headers: {
           [name: string]: unknown;
         };
         content: {
           "application/json": {
-            actions: {
-              /** @enum {string} */
-              action: "items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:manage" | "items:permissions:read" | "items:update";
-              allowed: boolean;
-              /** @enum {string|null} */
-              basis: "workspace_visibility" | "restricted_administrator_bypass" | "direct_grant" | "inherited_grant" | null;
-              grantId: string | null;
-              sourceItemId: string | null;
-            }[] & (unknown & unknown & unknown & unknown & unknown & unknown & unknown);
+            /** @enum {string} */
+            archiveState: "available" | "cold" | "restoring" | "unavailable" | "corrupt";
+            byteLength: number;
+            contentDigest: string;
+            /**
+             * Format: finueva-safe-filename
+             * @description Custom format finueva-safe-filename requires NFC normalization and at most 255 UTF-8 bytes in addition to the structural pattern and maxLength constraints. Dot entries and Windows reserved base names are forbidden. Generated JSON Schema constraints are a necessary structural subset and do not independently enforce normalization or UTF-8 byte length.
+             */
+            displayFilename: string;
+            itemId: string;
+            mediaType: string;
+            /** @enum {string} */
+            protectionClassification: "ordinary" | "opaque-encrypted";
+            revision: number;
+            /** @enum {string} */
+            state: "current" | "superseded";
+            versionId: string;
+            workspaceId: string;
           };
         };
       };
@@ -992,7 +2840,7 @@ interface operations {
           };
         };
       };
-      /** @description The discoverable item does not permit this permission operation. */
+      /** @description Managed storage is disabled for the discoverable file. */
       403: {
         headers: {
           [name: string]: unknown;
@@ -1010,7 +2858,7 @@ interface operations {
           };
         };
       };
-      /** @description The item, principal, or direct grant is absent or undiscoverable. */
+      /** @description The file or version is absent, undiscoverable, unpublished, or deleting. */
       404: {
         headers: {
           [name: string]: unknown;
@@ -1028,8 +2876,8 @@ interface operations {
           };
         };
       };
-      /** @description The supplied revision or post-preflight authority is stale. */
-      412: {
+      /** @description Authorization or version metadata changed after preflight. */
+      409: {
         headers: {
           [name: string]: unknown;
         };
@@ -1046,7 +2894,7 @@ interface operations {
           };
         };
       };
-      /** @description The path, query, headers, or body are invalid. */
+      /** @description The path, query, or unexpected body is invalid. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -1064,7 +2912,7 @@ interface operations {
           };
         };
       };
-      /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
+      /** @description Identity, D1, authorization, capacity, or managed authority is unavailable. */
       503: {
         headers: {
           [name: string]: unknown;
@@ -1093,7 +2941,7 @@ interface operations {
       };
     };
   };
-  revokeItemPermission: {
+  restoreItemVersion: {
     parameters: {
       query?: never;
       header: {
@@ -1103,44 +2951,23 @@ interface operations {
       path: {
         workspaceId: string;
         itemId: string;
-        grantId: string;
+        versionId: string;
       };
       cookie?: never;
     };
     requestBody?: never;
     responses: {
-      /** @description The retained revoked grant was committed, replayed, or unchanged. */
+      /** @description The selected version is current or the exact result was replayed. */
       200: {
         headers: {
-          /** @description Current direct collection precondition for POST. */
-          "Drive-Permission-Collection-ETag"?: string;
+          /** @description Strong precondition for the next item mutation. */
+          ETag?: string;
           [name: string]: unknown;
         };
         content: {
           "application/json": {
-            collectionRevision: number;
-            grant: {
-              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
-              /** @enum {string} */
-              availability: "active" | "expired" | "revoked";
-              expiresAtEpochMilliseconds: number | null;
-              grantId: string;
-              grantee: {
-                /** @enum {string} */
-                type: "user";
-                userId: string;
-              } | {
-                teamId: string;
-                /** @enum {string} */
-                type: "team";
-              };
-              revision: number;
-              /** @enum {string} */
-              source: "direct";
-              sourceItemId: string;
-            };
-            /** @enum {string} */
-            outcome: "committed" | "replayed";
+            currentVersionId: string;
+            itemRevision: number;
           };
         };
       };
@@ -1162,7 +2989,7 @@ interface operations {
           };
         };
       };
-      /** @description The discoverable item does not permit this permission operation. */
+      /** @description The discoverable item does not permit this lifecycle action. */
       403: {
         headers: {
           [name: string]: unknown;
@@ -1180,7 +3007,7 @@ interface operations {
           };
         };
       };
-      /** @description The item, principal, or direct grant is absent or undiscoverable. */
+      /** @description The item or destination is absent or undiscoverable. */
       404: {
         headers: {
           [name: string]: unknown;
@@ -1198,7 +3025,7 @@ interface operations {
           };
         };
       };
-      /** @description The idempotency key was reused for a different semantic request. */
+      /** @description The key conflicts, the precondition is stale, or lifecycle authority changed. */
       409: {
         headers: {
           [name: string]: unknown;
@@ -1213,16 +3040,7 @@ interface operations {
               message: "The idempotency key conflicts with an earlier request.";
               requestId: string;
             };
-          };
-        };
-      };
-      /** @description The supplied revision or post-preflight authority is stale. */
-      412: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": {
+          } | {
             error: {
               /** @enum {string} */
               code: "precondition_failed";
@@ -1234,7 +3052,7 @@ interface operations {
           };
         };
       };
-      /** @description The path, query, headers, idempotency key, or body are invalid. */
+      /** @description The path, query, headers, key, or strict body is invalid. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -1261,7 +3079,7 @@ interface operations {
           };
         };
       };
-      /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
+      /** @description Identity, D1, authorization, capacity, or archive authority is unavailable. */
       503: {
         headers: {
           [name: string]: unknown;
@@ -1290,63 +3108,53 @@ interface operations {
       };
     };
   };
-  updateItemPermission: {
+  searchWorkspaceItems: {
     parameters: {
-      query?: never;
-      header: {
-        "Idempotency-Key": string;
-        "If-Match": string;
+      query: {
+        /** @description NFC, case-sensitive display-name prefix of at most 64 Unicode code points and 255 UTF-8 bytes. */
+        query: string;
+        limit?: number;
+        cursor?: string;
       };
+      header?: never;
       path: {
         workspaceId: string;
-        itemId: string;
-        grantId: string;
       };
       cookie?: never;
     };
-    requestBody: {
-      content: {
-        "application/json": {
-          actions?: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
-          expiresAtEpochMilliseconds?: number | null;
-        };
-      };
-    };
+    requestBody?: never;
     responses: {
-      /** @description The direct grant was committed or replayed. */
+      /** @description At most 50 authorized managed items in binary display-name and item-ID order. */
       200: {
         headers: {
-          /** @description Current direct collection precondition for POST. */
-          "Drive-Permission-Collection-ETag"?: string;
-          /** @description Current direct-grant precondition for the next PATCH or DELETE; omitted when the current row is not mutable. */
-          "Drive-Permission-Grant-ETag"?: string;
           [name: string]: unknown;
         };
         content: {
           "application/json": {
-            collectionRevision: number;
-            grant: {
-              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
-              /** @enum {string} */
-              availability: "active" | "expired" | "revoked";
-              expiresAtEpochMilliseconds: number | null;
-              grantId: string;
-              grantee: {
+            items: {
+              currentVersion: {
+                byteLength: number;
+                mediaType: string;
                 /** @enum {string} */
-                type: "user";
-                userId: string;
-              } | {
-                teamId: string;
+                protectionClassification: "ordinary" | "opaque-encrypted";
                 /** @enum {string} */
-                type: "team";
-              };
+                state: "current";
+                versionId: string;
+              } | null;
+              itemId: string;
+              /** @enum {string} */
+              lifecycleState: "active";
+              name: string;
+              parentId: string | null;
+              /** @enum {string} */
+              provider: "managed";
               revision: number;
               /** @enum {string} */
-              source: "direct";
-              sourceItemId: string;
-            };
-            /** @enum {string} */
-            outcome: "committed" | "replayed";
+              type: "file" | "folder";
+              volumeId: string;
+              workspaceId: string;
+            }[];
+            nextCursor: string | null;
           };
         };
       };
@@ -1368,7 +3176,7 @@ interface operations {
           };
         };
       };
-      /** @description The discoverable item does not permit this permission operation. */
+      /** @description Managed storage is disabled for the selected workspace. */
       403: {
         headers: {
           [name: string]: unknown;
@@ -1386,7 +3194,7 @@ interface operations {
           };
         };
       };
-      /** @description The item, principal, or direct grant is absent or undiscoverable. */
+      /** @description The selected workspace is absent or undiscoverable. */
       404: {
         headers: {
           [name: string]: unknown;
@@ -1404,26 +3212,8 @@ interface operations {
           };
         };
       };
-      /** @description The idempotency key was reused for a different semantic request. */
+      /** @description Workspace, cursor anchor, or item authority changed during the search. */
       409: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": {
-            error: {
-              /** @enum {string} */
-              code: "idempotency_conflict";
-              details: Record<string, never>;
-              /** @enum {string} */
-              message: "The idempotency key conflicts with an earlier request.";
-              requestId: string;
-            };
-          };
-        };
-      };
-      /** @description The supplied revision or post-preflight authority is stale. */
-      412: {
         headers: {
           [name: string]: unknown;
         };
@@ -1440,7 +3230,7 @@ interface operations {
           };
         };
       };
-      /** @description The path, query, headers, idempotency key, or body are invalid. */
+      /** @description The path, query, body, or cursor is invalid. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -1458,16 +3248,16 @@ interface operations {
           } | {
             error: {
               /** @enum {string} */
-              code: "invalid_idempotency_key";
+              code: "invalid_pagination_cursor";
               details: Record<string, never>;
               /** @enum {string} */
-              message: "The idempotency key is invalid.";
+              message: "The pagination cursor is invalid.";
               requestId: string;
             };
           };
         };
       };
-      /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
+      /** @description Identity authority, D1, exact authorization, audit capacity, or cursor keys are unavailable. */
       503: {
         headers: {
           [name: string]: unknown;
@@ -2540,6 +4330,8 @@ type JsonRequest<Name extends keyof operations> = operations[Name] extends {
 } ? Body : never;
 type ResourcePath = operations["listFolderChildren"]["parameters"]["path"];
 type PageQuery = NonNullable<operations["listFolderChildren"]["parameters"]["query"]>;
+type SearchWorkspaceItemsPath = operations["searchWorkspaceItems"]["parameters"]["path"];
+type SearchWorkspaceItemsQuery = NonNullable<operations["searchWorkspaceItems"]["parameters"]["query"]>;
 type CreateFolderBody = JsonRequest<"createFolder">;
 type CreatePermissionBody = JsonRequest<"createItemPermission">;
 type UpdatePermissionBody = JsonRequest<"updateItemPermission">;
@@ -2557,6 +4349,17 @@ type RecordUploadPartPath = operations["recordUploadPart"]["parameters"]["path"]
 type RecordUploadPartBody = JsonRequest<"recordUploadPart">;
 type CompleteUploadHeaders = operations["completeUpload"]["parameters"]["header"];
 type AbortUploadPath = operations["abortUpload"]["parameters"]["path"];
+type UpdateItemPath = operations["updateItem"]["parameters"]["path"];
+type UpdateItemHeaders = operations["updateItem"]["parameters"]["header"];
+type UpdateItemBody = JsonRequest<"updateItem">;
+type ListItemVersionsPath = operations["listItemVersions"]["parameters"]["path"];
+type ListItemVersionsQuery = NonNullable<operations["listItemVersions"]["parameters"]["query"]>;
+type GetItemVersionPath = operations["getItemVersion"]["parameters"]["path"];
+type RestoreItemVersionPath = operations["restoreItemVersion"]["parameters"]["path"];
+type RestoreItemVersionHeaders = operations["restoreItemVersion"]["parameters"]["header"];
+type CreateDownloadPath = operations["createDownload"]["parameters"]["path"];
+type CreateDownloadQuery = NonNullable<operations["createDownload"]["parameters"]["query"]>;
+type CreateDownloadHeaders = operations["createDownload"]["parameters"]["header"];
 type GeneratedCurrentWorkspace = JsonResponse<"getCurrentWorkspace", 200>;
 type CurrentWorkspace = Readonly<Omit<GeneratedCurrentWorkspace, "workspaceReference"> & {
   readonly workspaceReference: Readonly<GeneratedCurrentWorkspace["workspaceReference"]>;
@@ -2568,6 +4371,30 @@ type UploadPartDescriptor = Readonly<Omit<JsonResponse<"createUploadPartDescript
 }>;
 type UploadPartResult = Readonly<JsonResponse<"recordUploadPart", 200>>;
 type ReadyUpload = Readonly<JsonResponse<"completeUpload", 200>>;
+type ManagedLifecycleItem = Readonly<JsonResponse<"updateItem", 200>>;
+type GeneratedManagedItemMetadata = JsonResponse<"getItem", 200>;
+type ManagedItemMetadata = Readonly<Omit<GeneratedManagedItemMetadata, "currentVersion"> & {
+  readonly currentVersion: Readonly<NonNullable<GeneratedManagedItemMetadata["currentVersion"]>> | null;
+}>;
+type GeneratedWorkspaceItemSearchPage = JsonResponse<"searchWorkspaceItems", 200>;
+type WorkspaceItemSearchItem = Readonly<Omit<GeneratedWorkspaceItemSearchPage["items"][number], "currentVersion"> & {
+  readonly currentVersion: Readonly<NonNullable<GeneratedWorkspaceItemSearchPage["items"][number]["currentVersion"]>> | null;
+}>;
+type WorkspaceItemSearchPage = Readonly<Omit<GeneratedWorkspaceItemSearchPage, "items"> & {
+  readonly items: readonly WorkspaceItemSearchItem[];
+}>;
+type GeneratedManagedItemVersionPage = JsonResponse<"listItemVersions", 200>;
+type ManagedItemVersion = Readonly<GeneratedManagedItemVersionPage["items"][number]>;
+type ManagedItemVersionResource = Readonly<JsonResponse<"getItemVersion", 200>>;
+type ManagedItemVersionPage = Readonly<Omit<GeneratedManagedItemVersionPage, "items"> & {
+  readonly items: readonly ManagedItemVersion[];
+}>;
+type ManagedItemVersionRestoreResult = Readonly<JsonResponse<"restoreItemVersion", 200>>;
+type ManagedDownloadDescriptor = Readonly<Omit<JsonResponse<"createDownload", 200>, "headers" | "response"> & {
+  readonly headers: Readonly<JsonResponse<"createDownload", 200>["headers"]>;
+  readonly response: Readonly<JsonResponse<"createDownload", 200>["response"]>;
+}>;
+type ManagedDownloadRestorePending = Readonly<JsonResponse<"createDownload", 202>>;
 type GeneratedUploadStatus = JsonResponse<"getUploadStatus", 200>;
 type UploadConfirmedPart = Readonly<GeneratedUploadStatus["confirmedParts"][number]>;
 type UploadStatus = Readonly<Omit<GeneratedUploadStatus, "confirmedParts" | "partPolicy" | "ready"> & {
@@ -2633,6 +4460,10 @@ type ResourceInput = Readonly<ResourcePath> & {
 };
 type PageInput = ResourceInput & Readonly<PageQuery>;
 type ListFolderChildrenInput = PageInput;
+type GetItemInput = ResourceInput;
+type SearchWorkspaceItemsInput = Readonly<SearchWorkspaceItemsPath> & Readonly<SearchWorkspaceItemsQuery> & {
+  readonly signal?: AbortSignal;
+};
 type CreateFolderInput = ResourceInput & Readonly<CreateFolderBody> & {
   readonly idempotencyKey: CreateFolderHeaders["Idempotency-Key"];
 };
@@ -2675,6 +4506,40 @@ type CompleteUploadInput = Readonly<UploadPath> & {
 type AbortUploadInput = Readonly<AbortUploadPath> & {
   readonly signal?: AbortSignal;
 };
+type UpdateItemInput = Readonly<UpdateItemPath> & Readonly<UpdateItemBody> & {
+  readonly idempotencyKey: UpdateItemHeaders["Idempotency-Key"];
+  readonly ifMatch: UpdateItemHeaders["If-Match"];
+  readonly signal?: AbortSignal;
+};
+type LifecycleMutationInput<Name extends "trashItem" | "restoreItem" | "deleteItem"> = Readonly<operations[Name]["parameters"]["path"]> & {
+  readonly idempotencyKey: operations[Name]["parameters"]["header"]["Idempotency-Key"];
+  readonly ifMatch: operations[Name]["parameters"]["header"]["If-Match"];
+  readonly signal?: AbortSignal;
+};
+type TrashItemInput = LifecycleMutationInput<"trashItem">;
+type RestoreItemInput = LifecycleMutationInput<"restoreItem">;
+type DeleteItemInput = LifecycleMutationInput<"deleteItem">;
+type ListItemVersionsInput = Readonly<ListItemVersionsPath> & Readonly<ListItemVersionsQuery> & {
+  readonly signal?: AbortSignal;
+};
+type GetItemVersionInput = Readonly<GetItemVersionPath> & {
+  readonly signal?: AbortSignal;
+};
+type RestoreItemVersionInput = Readonly<RestoreItemVersionPath> & {
+  readonly idempotencyKey: RestoreItemVersionHeaders["Idempotency-Key"];
+  readonly ifMatch: RestoreItemVersionHeaders["If-Match"];
+  readonly signal?: AbortSignal;
+};
+type CreateDownloadInput = Readonly<CreateDownloadPath> & Readonly<CreateDownloadQuery> & {
+  readonly idempotencyKey: CreateDownloadHeaders["Idempotency-Key"];
+  readonly method?: "GET" | "HEAD";
+  readonly range?: string;
+  readonly ifMatch?: string;
+  readonly ifNoneMatch?: string;
+  readonly ifRange?: string;
+  readonly signal?: AbortSignal;
+};
+type DownloadItemResult = Response | DriveOperationResult<ManagedDownloadRestorePending, 202> | DriveOperationResult<undefined, 304>;
 type UploadFilePhase = "preparing" | "uploading" | "completing";
 interface UploadFileProgress {
   readonly phase: UploadFilePhase;
@@ -2701,8 +4566,19 @@ interface GetCurrentWorkspaceInput {
 }
 interface DriveOperations {
   getCurrentWorkspace(input?: GetCurrentWorkspaceInput): Promise<DriveOperationResult<CurrentWorkspace, 200>>;
+  getItem(input: GetItemInput): Promise<DriveOperationResult<ManagedItemMetadata, 200>>;
+  searchWorkspaceItems(input: SearchWorkspaceItemsInput): Promise<DriveOperationResult<WorkspaceItemSearchPage, 200>>;
   listFolderChildren(input: ListFolderChildrenInput): Promise<DriveOperationResult<FolderPage, 200>>;
   createFolder(input: CreateFolderInput): Promise<DriveOperationResult<FolderItem, 200 | 201>>;
+  updateItem(input: UpdateItemInput): Promise<DriveOperationResult<ManagedLifecycleItem, 200>>;
+  trashItem(input: TrashItemInput): Promise<DriveOperationResult<ManagedLifecycleItem, 200>>;
+  restoreItem(input: RestoreItemInput): Promise<DriveOperationResult<ManagedLifecycleItem, 200>>;
+  deleteItem(input: DeleteItemInput): Promise<DriveOperationResult<ManagedLifecycleItem, 200 | 202>>;
+  listItemVersions(input: ListItemVersionsInput): Promise<DriveOperationResult<ManagedItemVersionPage, 200>>;
+  getItemVersion(input: GetItemVersionInput): Promise<DriveOperationResult<ManagedItemVersionResource, 200>>;
+  restoreItemVersion(input: RestoreItemVersionInput): Promise<DriveOperationResult<ManagedItemVersionRestoreResult, 200>>;
+  createDownload(input: CreateDownloadInput): Promise<DriveOperationResult<ManagedDownloadDescriptor, 200> | DriveOperationResult<ManagedDownloadRestorePending, 202> | DriveOperationResult<undefined, 304>>;
+  downloadItem(input: CreateDownloadInput): Promise<DownloadItemResult>;
   listItemPermissions(input: ListItemPermissionsInput): Promise<DriveOperationResult<PermissionPage, 200>>;
   readEffectiveItemPermissions(input: ReadEffectiveItemPermissionsInput): Promise<DriveOperationResult<EffectivePermissionResponse, 200>>;
   createItemPermission(input: CreateItemPermissionInput): Promise<DriveOperationResult<PermissionMutation, 200 | 201>>;
@@ -2720,4 +4596,4 @@ interface DriveClient extends DriveOperations {
   uploadFile(input: UploadFileInput): Promise<DriveOperationResult<ReadyUpload, 200>>;
 }
 //#endregion
-export { ProtectionClassification as A, UploadFileProgressCallback as B, ListFolderChildrenInput as C, PermissionGrantee as D, PermissionGrant as E, UpdateItemPermissionInput as F, UploadPartResult as H, UploadConfirmedPart as I, UploadFileInput as L, ReadyUpload as M, RecordUploadPartInput as N, PermissionMutation as O, RevokeItemPermissionInput as P, UploadFilePhase as R, GetUploadStatusInput as S, PermissionAction as T, UploadSession as U, UploadPartDescriptor as V, UploadStatus as W, EffectivePermissionAction as _, CreateUploadInput as a, FolderPage as b, DriveClient as c, DriveCredentialProvider as d, DriveOperationResult as f, DriveServerClientConfig as g, DriveServerClient as h, CreateItemPermissionInput as i, ReadEffectiveItemPermissionsInput as j, PermissionPage as k, DriveClientConfig as l, DriveResponseValidators as m, CompleteUploadInput as n, CreateUploadPartDescriptorInput as o, DriveOperations as p, CreateFolderInput as r, CurrentWorkspace as s, AbortUploadInput as t, DriveCredentialContext as u, EffectivePermissionResponse as v, ListItemPermissionsInput as w, GetCurrentWorkspaceInput as x, FolderItem as y, UploadFileProgress as z };
+export { UpdateItemInput as $, ListItemVersionsInput as A, PermissionGrant as B, FolderPage as C, GetUploadStatusInput as D, GetItemVersionInput as E, ManagedItemVersionPage as F, ReadEffectiveItemPermissionsInput as G, PermissionMutation as H, ManagedItemVersionResource as I, RestoreItemInput as J, ReadyUpload as K, ManagedItemVersionRestoreResult as L, ManagedDownloadRestorePending as M, ManagedItemMetadata as N, ListFolderChildrenInput as O, ManagedItemVersion as P, TrashItemInput as Q, ManagedLifecycleItem as R, FolderItem as S, GetItemInput as T, PermissionPage as U, PermissionGrantee as V, ProtectionClassification as W, RevokeItemPermissionInput as X, RestoreItemVersionInput as Y, SearchWorkspaceItemsInput as Z, DriveResponseValidators as _, CreateItemPermissionInput as a, UploadFileProgressCallback as at, EffectivePermissionAction as b, CurrentWorkspace as c, UploadSession as ct, DriveClient as d, WorkspaceItemSearchPage as dt, UpdateItemPermissionInput as et, DriveClientConfig as f, DriveOperations as g, DriveOperationResult as h, CreateFolderInput as i, UploadFileProgress as it, ManagedDownloadDescriptor as j, ListItemPermissionsInput as k, DeleteItemInput as l, UploadStatus as lt, DriveCredentialProvider as m, CompleteUploadInput as n, UploadFileInput as nt, CreateUploadInput as o, UploadPartDescriptor as ot, DriveCredentialContext as p, RecordUploadPartInput as q, CreateDownloadInput as r, UploadFilePhase as rt, CreateUploadPartDescriptorInput as s, UploadPartResult as st, AbortUploadInput as t, UploadConfirmedPart as tt, DownloadItemResult as u, WorkspaceItemSearchItem as ut, DriveServerClient as v, GetCurrentWorkspaceInput as w, EffectivePermissionResponse as x, DriveServerClientConfig as y, PermissionAction as z };