@finueva/drive 0.7.0 → 0.10.0

package/dist/contract.d.ts

@@ -223,6 +223,70 @@ interface operations {
       };
     };
   };
+  listIncomingShares: {
+    parameters: {
+      query?: {
+        limit?: number;
+        cursor?: string;
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Exact opaque item contexts; no owner root or membership. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            items: {
+              itemId: string;
+              workspaceId: string;
+            }[];
+            nextCursor: string | null;
+          };
+        };
+      };
+      /** @description Authentication required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Personal workspace not found. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Authority changed. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Invalid request or cursor. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Service unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+    };
+  };
   getCurrentWorkspace: {
     parameters: {
       query?: never;
@@ -355,45 +419,47 @@ interface operations {
       };
     };
   };
-  getItem: {
+  getCurrentWorkspaceSources: {
     parameters: {
       query?: never;
       header?: never;
-      path: {
-        workspaceId: string;
-        itemId: string;
-      };
+      path?: never;
       cookie?: never;
     };
     requestBody?: never;
     responses: {
-      /** @description The active managed item and current published version metadata. */
+      /** @description One canonical managed volume. Known providers are not connections or health evidence. */
       200: {
         headers: {
-          /** @description Strong precondition for the next item mutation. */
-          ETag?: string;
           [name: string]: unknown;
         };
         content: {
           "application/json": {
-            currentVersion: {
-              byteLength: number;
-              mediaType: string;
+            /** @enum {boolean} */
+            externalConnectionsSupported: false;
+            knownProviders: ("managed" | "google-drive" | "onedrive" | "dropbox" | "s3-compatible")[];
+            volumes: {
               /** @enum {string} */
-              protectionClassification: "ordinary" | "opaque-encrypted";
+              name: "Files";
               /** @enum {string} */
-              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;
+              provider: "managed";
+              rootItemId: string;
+              volumeId: string;
+            }[];
+            workspace: {
+              rootItemId: string;
+              rootVolumeId: string;
+              workspaceId: string;
+              workspaceReference: {
+                /** @enum {string} */
+                type: "personal";
+                userId: string;
+              } | {
+                organizationId: string;
+                /** @enum {string} */
+                type: "organization";
+              };
+            };
           };
         };
       };
@@ -415,7 +481,7 @@ interface operations {
           };
         };
       };
-      /** @description Managed storage is disabled for the discoverable item. */
+      /** @description Managed storage is disabled. */
       403: {
         headers: {
           [name: string]: unknown;
@@ -433,7 +499,7 @@ interface operations {
           };
         };
       };
-      /** @description The item is absent, undiscoverable, tombstoned, or unpublished. */
+      /** @description The current workspace is not provisioned or accessible. */
       404: {
         headers: {
           [name: string]: unknown;
@@ -451,25 +517,7 @@ interface operations {
           };
         };
       };
-      /** @description Authorization or metadata 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 unexpected body is invalid. */
+      /** @description Unsupported query input. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -487,7 +535,7 @@ interface operations {
           };
         };
       };
-      /** @description Identity, D1, authorization, capacity, or managed authority is unavailable. */
+      /** @description Identity authority, D1, or canonical managed root is unavailable. */
       503: {
         headers: {
           [name: string]: unknown;
@@ -516,68 +564,64 @@ interface operations {
       };
     };
   };
-  deleteItem: {
+  listWorkspaceItems: {
     parameters: {
-      query?: never;
-      header: {
-        "Idempotency-Key": string;
-        "If-Match": string;
+      query?: {
+        view?: "recent" | "shared" | "trash";
+        kind?: "file" | "folder";
+        creatorUserId?: string;
+        limit?: number;
+        cursor?: string;
       };
+      header?: never;
       path: {
         workspaceId: string;
-        itemId: string;
       };
       cookie?: never;
     };
     requestBody?: never;
     responses: {
-      /** @description The retained deletion result was exactly replayed. */
+      /** @description Authorized items and an authenticated continuation; no total count. */
       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 Deletion was retained and bounded reconciliation was attempted. */
-      202: {
-        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;
+            items: {
+              createdAtEpochMilliseconds: number | null;
+              creatorUserId: string | null;
+              currentVersion: {
+                byteLength: number;
+                mediaType: string;
+                /** @enum {string} */
+                protectionClassification: "ordinary" | "opaque-encrypted";
+                /** @enum {string} */
+                state: "current";
+                versionId: string;
+              } | null;
+              etag: string;
+              itemId: string;
+              /** @enum {string} */
+              lifecycleState: "active" | "trashed";
+              modifiedAtEpochMilliseconds: number | null;
+              name: string;
+              parentId: string | null;
+              /** @enum {string} */
+              provider: "managed";
+              purgeAfterEpochMilliseconds: number | null;
+              revision: number;
+              trashedAtEpochMilliseconds: number | null;
+              /** @enum {string} */
+              type: "file" | "folder";
+              volumeId: string;
+              workspaceId: string;
+            }[];
+            nextCursor: string | null;
           };
         };
       };
-      /** @description A valid Drive user bearer credential is required. */
+      /** @description Authentication required. */
       401: {
         headers: {
           [name: string]: unknown;
@@ -586,16 +630,15 @@ interface operations {
           "application/json": {
             error: {
               /** @enum {string} */
-              code: "authentication_required";
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
               details: Record<string, never>;
-              /** @enum {string} */
-              message: "Authentication is required.";
+              message: string;
               requestId: string;
             };
           };
         };
       };
-      /** @description The discoverable item does not permit this lifecycle action. */
+      /** @description The action is not permitted. */
       403: {
         headers: {
           [name: string]: unknown;
@@ -604,16 +647,15 @@ interface operations {
           "application/json": {
             error: {
               /** @enum {string} */
-              code: "permission_denied";
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
               details: Record<string, never>;
-              /** @enum {string} */
-              message: "The requested action is not permitted.";
+              message: string;
               requestId: string;
             };
           };
         };
       };
-      /** @description The item or destination is absent or undiscoverable. */
+      /** @description Workspace not found. */
       404: {
         headers: {
           [name: string]: unknown;
@@ -622,16 +664,15 @@ interface operations {
           "application/json": {
             error: {
               /** @enum {string} */
-              code: "resource_not_found";
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
               details: Record<string, never>;
-              /** @enum {string} */
-              message: "The requested resource was not found.";
+              message: string;
               requestId: string;
             };
           };
         };
       };
-      /** @description The key conflicts, the precondition is stale, or lifecycle authority changed. */
+      /** @description The selected authority or page changed; restart the query. */
       409: {
         headers: {
           [name: string]: unknown;
@@ -640,25 +681,15 @@ interface operations {
           "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";
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
               details: Record<string, never>;
-              /** @enum {string} */
-              message: "The request precondition failed.";
+              message: string;
               requestId: string;
             };
           };
         };
       };
-      /** @description The path, query, headers, key, or strict body is invalid. */
+      /** @description Invalid request or cursor. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -667,25 +698,15 @@ interface operations {
           "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";
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
               details: Record<string, never>;
-              /** @enum {string} */
-              message: "The idempotency key is invalid.";
+              message: string;
               requestId: string;
             };
           };
         };
       };
-      /** @description Identity, D1, authorization, capacity, or archive authority is unavailable. */
+      /** @description Authoritative state is unavailable. */
       503: {
         headers: {
           [name: string]: unknown;
@@ -694,19 +715,9 @@ interface operations {
           "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";
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
               details: Record<string, never>;
-              /** @enum {string} */
-              message: "The service is temporarily unavailable.";
+              message: string;
               requestId: string;
             };
           };
@@ -714,29 +725,19 @@ interface operations {
       };
     };
   };
-  updateItem: {
+  getItem: {
     parameters: {
       query?: never;
-      header: {
-        "Idempotency-Key": string;
-        "If-Match": string;
-      };
+      header?: never;
       path: {
         workspaceId: string;
         itemId: string;
       };
       cookie?: never;
     };
-    requestBody: {
-      content: {
-        "application/json": {
-          name: string;
-          parentItemId: string;
-        };
-      };
-    };
+    requestBody?: never;
     responses: {
-      /** @description The managed item was updated or exactly replayed. */
+      /** @description The active managed item and current published version metadata. */
       200: {
         headers: {
           /** @description Strong precondition for the next item mutation. */
@@ -745,16 +746,23 @@ interface operations {
         };
         content: {
           "application/json": {
+            currentVersion: {
+              byteLength: number;
+              mediaType: string;
+              /** @enum {string} */
+              protectionClassification: "ordinary" | "opaque-encrypted";
+              /** @enum {string} */
+              state: "current";
+              versionId: string;
+            } | null;
             itemId: string;
             /** @enum {string} */
-            kind: "file" | "folder";
+            lifecycleState: "active";
             name: string;
-            parentItemId: string;
-            purgeAfterEpochMilliseconds: number | null;
+            parentId: string | null;
             revision: number;
             /** @enum {string} */
-            state: "active" | "trashed" | "deleting";
-            volumeId: string;
+            type: "file" | "folder";
             workspaceId: string;
           };
         };
@@ -777,7 +785,7 @@ interface operations {
           };
         };
       };
-      /** @description The discoverable item does not permit this lifecycle action. */
+      /** @description Managed storage is disabled for the discoverable item. */
       403: {
         headers: {
           [name: string]: unknown;
@@ -795,7 +803,7 @@ interface operations {
           };
         };
       };
-      /** @description The item or destination is absent or undiscoverable. */
+      /** @description The item is absent, undiscoverable, tombstoned, or unpublished. */
       404: {
         headers: {
           [name: string]: unknown;
@@ -813,22 +821,13 @@ interface operations {
           };
         };
       };
-      /** @description The key conflicts, the precondition is stale, or lifecycle authority changed. */
+      /** @description Authorization or metadata 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";
@@ -840,7 +839,7 @@ interface operations {
           };
         };
       };
-      /** @description The path, query, headers, key, or strict body is invalid. */
+      /** @description The path, query, or unexpected body is invalid. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -855,19 +854,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, capacity, or archive authority is unavailable. */
+      /** @description Identity, D1, authorization, capacity, or managed authority is unavailable. */
       503: {
         headers: {
           [name: string]: unknown;
@@ -896,13 +886,13 @@ interface operations {
       };
     };
   };
-  listFolderChildren: {
+  deleteItem: {
     parameters: {
-      query?: {
-        limit?: number;
-        cursor?: string;
+      query?: never;
+      header: {
+        "Idempotency-Key": string;
+        "If-Match": string;
       };
-      header?: never;
       path: {
         workspaceId: string;
         itemId: string;
@@ -911,30 +901,49 @@ interface operations {
     };
     requestBody?: never;
     responses: {
-      /** @description At most 50 active children in stable item-ID order. */
+      /** @description The retained deletion result was exactly replayed. */
       200: {
         headers: {
+          /** @description Strong precondition for the next item mutation. */
+          ETag?: string;
           [name: string]: unknown;
         };
         content: {
           "application/json": {
-            items: {
-              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;
-            }[];
-            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;
+          };
+        };
+      };
+      /** @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: {
+          "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;
           };
         };
       };
@@ -956,7 +965,7 @@ interface operations {
           };
         };
       };
-      /** @description Managed storage is disabled for the canonical workspace entitlement. */
+      /** @description The discoverable item does not permit this lifecycle action. */
       403: {
         headers: {
           [name: string]: unknown;
@@ -974,7 +983,7 @@ interface operations {
           };
         };
       };
-      /** @description The parent is absent or undiscoverable. */
+      /** @description The item or destination is absent or undiscoverable. */
       404: {
         headers: {
           [name: string]: unknown;
@@ -992,13 +1001,22 @@ interface operations {
           };
         };
       };
-      /** @description Folder authority changed after preflight. */
+      /** @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";
@@ -1010,7 +1028,7 @@ interface operations {
           };
         };
       };
-      /** @description The path, query, or cursor is invalid. */
+      /** @description The path, query, headers, key, or strict body is invalid. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -1028,16 +1046,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 authority, D1, authorization evidence, or required cursor keys are unavailable. */
+      /** @description Identity, D1, authorization, capacity, or archive authority is unavailable. */
       503: {
         headers: {
           [name: string]: unknown;
@@ -1066,11 +1084,12 @@ interface operations {
       };
     };
   };
-  createFolder: {
+  updateItem: {
     parameters: {
       query?: never;
       header: {
         "Idempotency-Key": string;
+        "If-Match": string;
       };
       path: {
         workspaceId: string;
@@ -1081,18 +1100,17 @@ interface operations {
     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;
+          parentItemId: string;
         };
       };
     };
     responses: {
-      /** @description The exact committed folder is replayed. */
+      /** @description The managed item was updated or exactly replayed. */
       200: {
         headers: {
+          /** @description Strong precondition for the next item mutation. */
+          ETag?: string;
           [name: string]: unknown;
         };
         content: {
@@ -1100,39 +1118,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;
-            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;
+            purgeAfterEpochMilliseconds: number | null;
             revision: number;
             /** @enum {string} */
-            visibility: "workspace" | "restricted";
+            state: "active" | "trashed" | "deleting";
             volumeId: string;
             workspaceId: string;
           };
@@ -1156,7 +1147,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;
@@ -1174,7 +1165,7 @@ interface operations {
           };
         };
       };
-      /** @description The parent is absent or undiscoverable. */
+      /** @description The item or destination is absent or undiscoverable. */
       404: {
         headers: {
           [name: string]: unknown;
@@ -1192,7 +1183,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;
@@ -1219,7 +1210,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;
@@ -1246,7 +1237,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;
@@ -1275,19 +1266,13 @@ interface operations {
       };
     };
   };
-  createDownload: {
+  listFolderChildren: {
     parameters: {
       query?: {
-        versionId?: string;
-      };
-      header: {
-        "Idempotency-Key": string;
-        "Download-Method"?: string;
-        Range?: string;
-        "If-Match"?: string;
-        "If-None-Match"?: string;
-        "If-Range"?: string;
+        limit?: number;
+        cursor?: string;
       };
+      header?: never;
       path: {
         workspaceId: string;
         itemId: string;
@@ -1296,61 +1281,886 @@ interface operations {
     };
     requestBody?: never;
     responses: {
-      /** @description A short-lived immutable archive capability. */
+      /** @description At most 50 active children in stable item-ID order. */
       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: {
+            items: {
+              itemId: string;
               /** @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;
+              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;
+            }[];
+            nextCursor: string | null;
           };
         };
       };
-      /** @description One idempotent cold archive retrieval operation. */
-      202: {
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
         headers: {
           [name: string]: unknown;
         };
         content: {
           "application/json": {
-            /** @enum {string} */
+            error: {
+              /** @enum {string} */
+              code: "authentication_required";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is required.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @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;
+            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";
           };
         };
       };
-      /** @description The selected immutable representation is not modified. */
-      304: {
+    };
+    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?: never;
+        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: {
@@ -1363,13 +2173,14 @@ interface operations {
               /** @enum {string} */
               code: "authentication_required";
               details: Record<string, never>;
-              message: string;
+              /** @enum {string} */
+              message: "Authentication is required.";
               requestId: string;
             };
           };
         };
       };
-      /** @description The visible file cannot be downloaded under current authority. */
+      /** @description The discoverable item does not permit this permission operation. */
       403: {
         headers: {
           [name: string]: unknown;
@@ -1380,13 +2191,14 @@ interface operations {
               /** @enum {string} */
               code: "permission_denied";
               details: Record<string, never>;
-              message: string;
+              /** @enum {string} */
+              message: "The requested action is not permitted.";
               requestId: string;
             };
           };
         };
       };
-      /** @description The file or selected version is absent or undiscoverable. */
+      /** @description The item, principal, or direct grant is absent or undiscoverable. */
       404: {
         headers: {
           [name: string]: unknown;
@@ -1397,13 +2209,14 @@ interface operations {
               /** @enum {string} */
               code: "resource_not_found";
               details: Record<string, never>;
-              message: string;
+              /** @enum {string} */
+              message: "The requested resource was not found.";
               requestId: string;
             };
           };
         };
       };
-      /** @description The retrieval key conflicts or immutable authority changed after preflight. */
+      /** @description The idempotency key was reused for a different semantic request. */
       409: {
         headers: {
           [name: string]: unknown;
@@ -1414,21 +2227,14 @@ interface operations {
               /** @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;
+              message: "The idempotency key conflicts with an earlier request.";
               requestId: string;
             };
           };
         };
       };
-      /** @description A content entity-tag precondition failed. */
+      /** @description The supplied revision or post-preflight authority is stale. */
       412: {
         headers: {
           [name: string]: unknown;
@@ -1439,14 +2245,15 @@ interface operations {
               /** @enum {string} */
               code: "precondition_failed";
               details: Record<string, never>;
-              message: string;
+              /** @enum {string} */
+              message: "The request precondition failed.";
               requestId: string;
             };
           };
         };
       };
-      /** @description The valid single range does not overlap the representation. */
-      416: {
+      /** @description The path, query, headers, idempotency key, or body are invalid. */
+      422: {
         headers: {
           [name: string]: unknown;
         };
@@ -1454,32 +2261,25 @@ interface operations {
           "application/json": {
             error: {
               /** @enum {string} */
-              code: "range_not_satisfiable";
+              code: "invalid_request";
               details: Record<string, never>;
-              message: string;
+              /** @enum {string} */
+              message: "The request is invalid.";
               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";
+              code: "invalid_idempotency_key";
               details: Record<string, never>;
-              message: string;
+              /** @enum {string} */
+              message: "The idempotency key is invalid.";
               requestId: string;
             };
           };
         };
       };
-      /** @description Identity, D1, authorization, capacity, or archive authority is unavailable. */
+      /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
       503: {
         headers: {
           [name: string]: unknown;
@@ -1490,7 +2290,8 @@ interface operations {
               /** @enum {string} */
               code: "identity_authority_unavailable";
               details: Record<string, never>;
-              message: string;
+              /** @enum {string} */
+              message: "Authentication is temporarily unavailable.";
               requestId: string;
             };
           } | {
@@ -1498,7 +2299,8 @@ interface operations {
               /** @enum {string} */
               code: "service_unavailable";
               details: Record<string, never>;
-              message: string;
+              /** @enum {string} */
+              message: "The service is temporarily unavailable.";
               requestId: string;
             };
           };
@@ -1506,12 +2308,9 @@ interface operations {
       };
     };
   };
-  listItemPermissions: {
+  readEffectiveItemPermissions: {
     parameters: {
-      query?: {
-        limit?: number;
-        cursor?: string;
-      };
+      query?: never;
       header?: never;
       path: {
         workspaceId: string;
@@ -1521,41 +2320,22 @@ interface operations {
     };
     requestBody?: never;
     responses: {
-      /** @description A stable permission page. */
+      /** @description All seven caller-specific item actions. */
       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;
+            actions: {
               /** @enum {string} */
-              source: "direct" | "inherited";
-              sourceItemId: string;
-            }[];
-            nextCursor: string | null;
+              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);
           };
         };
       };
@@ -1631,7 +2411,7 @@ interface operations {
           };
         };
       };
-      /** @description The path, query, headers, or pagination cursor are invalid. */
+      /** @description The path, query, headers, or body are invalid. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -1646,15 +2426,6 @@ 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;
-            };
           };
         };
       };
@@ -1687,7 +2458,7 @@ interface operations {
       };
     };
   };
-  createItemPermission: {
+  revokeItemPermission: {
     parameters: {
       query?: never;
       header: {
@@ -1697,71 +2468,17 @@ interface operations {
       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;
-          grantee: {
-            /** @enum {string} */
-            type: "user";
-            userId: string;
-          } | {
-            teamId: string;
-            /** @enum {string} */
-            type: "team";
-          };
-        };
-      };
-    };
+    requestBody?: never;
     responses: {
-      /** @description The exact committed result was replayed. */
+      /** @description The retained revoked grant was committed, replayed, or unchanged. */
       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. */
+          /** @description Current direct collection precondition for 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: {
@@ -1938,34 +2655,63 @@ interface operations {
       };
     };
   };
-  readEffectiveItemPermissions: {
+  updateItemPermission: {
     parameters: {
       query?: never;
-      header?: never;
+      header: {
+        "Idempotency-Key": string;
+        "If-Match": string;
+      };
       path: {
         workspaceId: string;
         itemId: string;
+        grantId: string;
       };
       cookie?: never;
     };
-    requestBody?: 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 All seven caller-specific item actions. */
+      /** @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": {
-            actions: {
+            collectionRevision: number;
+            grant: {
+              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
               /** @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);
+              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";
           };
         };
       };
@@ -2023,6 +2769,24 @@ interface operations {
           };
         };
       };
+      /** @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: {
@@ -2041,7 +2805,7 @@ interface operations {
           };
         };
       };
-      /** @description The path, query, headers, or body are invalid. */
+      /** @description The path, query, headers, idempotency key, or body are invalid. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -2056,6 +2820,15 @@ 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;
+            };
           };
         };
       };
@@ -2088,7 +2861,7 @@ interface operations {
       };
     };
   };
-  revokeItemPermission: {
+  restoreItem: {
     parameters: {
       query?: never;
       header: {
@@ -2098,44 +2871,31 @@ interface operations {
       path: {
         workspaceId: string;
         itemId: string;
-        grantId: string;
       };
       cookie?: never;
     };
     requestBody?: never;
     responses: {
-      /** @description The retained revoked grant was committed, replayed, or unchanged. */
+      /** @description The managed item was restored or exactly 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;
-            };
+            itemId: string;
             /** @enum {string} */
-            outcome: "committed" | "replayed";
+            kind: "file" | "folder";
+            name: string;
+            parentItemId: string;
+            purgeAfterEpochMilliseconds: number | null;
+            revision: number;
+            /** @enum {string} */
+            state: "active" | "trashed" | "deleting";
+            volumeId: string;
+            workspaceId: string;
           };
         };
       };
@@ -2157,7 +2917,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;
@@ -2175,7 +2935,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;
@@ -2193,7 +2953,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;
@@ -2208,16 +2968,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";
@@ -2229,7 +2980,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;
@@ -2256,7 +3007,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;
@@ -2285,7 +3036,7 @@ interface operations {
       };
     };
   };
-  updateItemPermission: {
+  registerItemRecipient: {
     parameters: {
       query?: never;
       header: {
@@ -2295,26 +3046,56 @@ interface operations {
       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;
+          /** @description Normalized email, at most 320 UTF-8 bytes. */
+          email: string;
+          /** @enum {string} */
+          role: "viewer" | "editor";
+        };
+      };
+    };
+    responses: {
+      /** @description Exact grant replay. */
+      200: {
+        headers: {
+          [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";
+          };
         };
       };
-    };
-    responses: {
-      /** @description The direct grant was committed or replayed. */
-      200: {
+      /** @description Registered recipient grant created. */
+      201: {
         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: {
@@ -2381,23 +3162,12 @@ interface operations {
           };
         };
       };
-      /** @description The item, principal, or direct grant is absent or undiscoverable. */
+      /** @description The item or registered recipient is unavailable. */
       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;
-            };
-          };
-        };
+        content?: never;
       };
       /** @description The idempotency key was reused for a different semantic request. */
       409: {
@@ -2462,6 +3232,13 @@ interface operations {
           };
         };
       };
+      /** @description Recipient resolution rate limit exceeded. */
+      429: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
       /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
       503: {
         headers: {
@@ -2491,13 +3268,13 @@ interface operations {
       };
     };
   };
-  restoreItem: {
+  listItemSharingPeople: {
     parameters: {
-      query?: never;
-      header: {
-        "Idempotency-Key": string;
-        "If-Match": string;
+      query?: {
+        limit?: number;
+        cursor?: string;
       };
+      header?: never;
       path: {
         workspaceId: string;
         itemId: string;
@@ -2506,26 +3283,47 @@ interface operations {
     };
     requestBody?: never;
     responses: {
-      /** @description The managed item was restored or exactly replayed. */
+      /** @description Canonical grant page; unavailable display is null and never authority. */
       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;
+            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;
+            } & {
+              recipient: {
+                /** @description At most 320 UTF-8 bytes. */
+                email: string;
+                expiresAt: number;
+                /** @description At most 1024 UTF-8 bytes. */
+                name: string;
+                resolvedAt: number;
+                userId: string;
+              } | null;
+            })[];
+            nextCursor: string | null;
           };
         };
       };
@@ -2547,7 +3345,7 @@ interface operations {
           };
         };
       };
-      /** @description The discoverable item does not permit this lifecycle action. */
+      /** @description The discoverable item does not permit this permission operation. */
       403: {
         headers: {
           [name: string]: unknown;
@@ -2565,8 +3363,15 @@ interface operations {
           };
         };
       };
-      /** @description The item or destination is absent or undiscoverable. */
+      /** @description The item or registered recipient is unavailable. */
       404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description The idempotency key was reused for a different semantic request. */
+      409: {
         headers: {
           [name: string]: unknown;
         };
@@ -2574,31 +3379,22 @@ interface operations {
           "application/json": {
             error: {
               /** @enum {string} */
-              code: "resource_not_found";
+              code: "idempotency_conflict";
               details: Record<string, never>;
               /** @enum {string} */
-              message: "The requested resource was not found.";
+              message: "The idempotency key conflicts with an earlier request.";
               requestId: string;
             };
           };
         };
       };
-      /** @description The key conflicts, the precondition is stale, or lifecycle authority changed. */
-      409: {
+      /** @description The supplied revision or post-preflight authority is stale. */
+      412: {
         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";
@@ -2610,7 +3406,7 @@ interface operations {
           };
         };
       };
-      /** @description The path, query, headers, key, or strict body is invalid. */
+      /** @description The path, query, headers, idempotency key, or body are invalid. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -2637,7 +3433,14 @@ interface operations {
           };
         };
       };
-      /** @description Identity, D1, authorization, capacity, or archive authority is unavailable. */
+      /** @description Recipient resolution rate limit exceeded. */
+      429: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content?: never;
+      };
+      /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
       503: {
         headers: {
           [name: string]: unknown;
@@ -4562,6 +5365,144 @@ interface operations {
       };
     };
   };
+  getWorkspaceUsage: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        workspaceId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Current committed and retained reserved bytes, not physical archive usage. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            /** @enum {string} */
+            accounting: "current-versions-and-reservations";
+            availableBytes: string;
+            limitBytes: string;
+            /** @enum {string} */
+            provider: "managed";
+            reservedBytes: string;
+            /** @enum {boolean} */
+            reservedBytesIncludeUnresolvedUploads: true;
+            unresolvedReservedBytes: string;
+            usedBytes: string;
+            warnings: "unresolved-archive-ownership"[];
+            workspaceId: string;
+          };
+        };
+      };
+      /** @description Authentication required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The action is not permitted. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Workspace not found. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The selected authority or page changed; restart the query. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Invalid request or cursor. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Authoritative state is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "permission_denied" | "resource_not_found" | "invalid_request" | "invalid_pagination_cursor" | "precondition_failed" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
 }
 //#endregion
 //#region src/types.d.ts
@@ -4610,6 +5551,62 @@ 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 RegisteredRecipientDisplay = Readonly<NonNullable<JsonResponse<"listItemSharingPeople", 200>["items"][number]["recipient"]>>;
+type ItemSharingPeoplePage = Readonly<Omit<JsonResponse<"listItemSharingPeople", 200>, "items"> & {
+  items: readonly (PermissionGrant & {
+    readonly recipient: RegisteredRecipientDisplay | null;
+  })[];
+}>;
+interface RegisterItemRecipientInput {
+  readonly workspaceId: string;
+  readonly itemId: string;
+  readonly email: string;
+  readonly role: "viewer" | "editor";
+  readonly ifMatch: string;
+  readonly idempotencyKey: string;
+  readonly signal?: AbortSignal;
+}
+type ListItemSharingPeopleInput = ListItemPermissionsInput;
+type GeneratedIncomingPage = JsonResponse<"listIncomingShares", 200>;
+type IncomingShareContext = Readonly<GeneratedIncomingPage["items"][number]>;
+type IncomingSharePage = Readonly<{
+  items: readonly IncomingShareContext[];
+  nextCursor: string | null;
+}>;
+interface ListIncomingSharesInput {
+  readonly limit?: number;
+  readonly cursor?: string;
+  readonly signal?: AbortSignal;
+}
+type GeneratedDiscoveryPage = JsonResponse<"listWorkspaceItems", 200>;
+type WorkspaceDiscoveryItem = Readonly<Omit<GeneratedDiscoveryPage["items"][number], "currentVersion"> & {
+  readonly currentVersion: ManagedItemMetadata["currentVersion"];
+}>;
+type WorkspaceDiscoveryPage = Readonly<{
+  items: readonly WorkspaceDiscoveryItem[];
+  nextCursor: string | null;
+}>;
+type GeneratedWorkspaceUsage = JsonResponse<"getWorkspaceUsage", 200>;
+type WorkspaceUsage = Readonly<Omit<GeneratedWorkspaceUsage, "warnings"> & {
+  readonly warnings: readonly GeneratedWorkspaceUsage["warnings"][number][];
+}>;
+interface GetWorkspaceUsageInput {
+  readonly workspaceId: string;
+  readonly signal?: AbortSignal;
+}
+interface ListWorkspaceItemsInput extends GetWorkspaceUsageInput {
+  readonly view?: "recent" | "shared" | "trash";
+  readonly kind?: "file" | "folder";
+  readonly creatorUserId?: string;
+  readonly limit?: number;
+  readonly cursor?: string;
+}
+type GeneratedCurrentWorkspaceSources = JsonResponse<"getCurrentWorkspaceSources", 200>;
+type CurrentWorkspaceSources = Readonly<Omit<GeneratedCurrentWorkspaceSources, "workspace" | "volumes" | "knownProviders"> & {
+  readonly workspace: CurrentWorkspace;
+  readonly volumes: readonly Readonly<GeneratedCurrentWorkspaceSources["volumes"][number]>[];
+  readonly knownProviders: readonly GeneratedCurrentWorkspaceSources["knownProviders"][number][];
+}>;
 type CurrentWorkspace = Readonly<Omit<GeneratedCurrentWorkspace, "workspaceReference"> & {
   readonly workspaceReference: Readonly<GeneratedCurrentWorkspace["workspaceReference"]>;
 }>;
@@ -4817,6 +5814,12 @@ interface GetCurrentWorkspaceInput {
   readonly signal?: AbortSignal;
 }
 interface DriveOperations {
+  registerItemRecipient(input: RegisterItemRecipientInput): Promise<DriveOperationResult<PermissionMutation, 200 | 201>>;
+  listItemSharingPeople(input: ListItemSharingPeopleInput): Promise<DriveOperationResult<ItemSharingPeoplePage, 200>>;
+  listIncomingShares(input?: ListIncomingSharesInput): Promise<DriveOperationResult<IncomingSharePage, 200>>;
+  listWorkspaceItems(input: ListWorkspaceItemsInput): Promise<DriveOperationResult<WorkspaceDiscoveryPage, 200>>;
+  getWorkspaceUsage(input: GetWorkspaceUsageInput): Promise<DriveOperationResult<WorkspaceUsage, 200>>;
+  getCurrentWorkspaceSources(input?: GetCurrentWorkspaceInput): Promise<DriveOperationResult<CurrentWorkspaceSources, 200>>;
   getCurrentWorkspace(input?: GetCurrentWorkspaceInput): Promise<DriveOperationResult<CurrentWorkspace, 200>>;
   getItem(input: GetItemInput): Promise<DriveOperationResult<ManagedItemMetadata, 200>>;
   searchWorkspaceItems(input: SearchWorkspaceItemsInput): Promise<DriveOperationResult<WorkspaceItemSearchPage, 200>>;
@@ -4848,4 +5851,4 @@ interface DriveClient extends DriveOperations {
   uploadFile(input: UploadFileInput): Promise<DriveOperationResult<UploadCompletion, 200 | 202>>;
 }
 //#endregion
-export { TrashItemInput as $, ListItemVersionsInput as A, PermissionAction as B, FolderPage as C, GetUploadStatusInput as D, GetItemVersionInput as E, ManagedItemVersionPage as F, ProtectionClassification as G, PermissionGrantee as H, ManagedItemVersionResource as I, RecordUploadPartInput as J, ReadEffectiveItemPermissionsInput as K, ManagedItemVersionRestoreResult as L, ManagedDownloadRestorePending as M, ManagedItemMetadata as N, ListFolderChildrenInput as O, ManagedItemVersion as P, SearchWorkspaceItemsInput as Q, ManagedLifecycleItem as R, FolderItem as S, GetItemInput as T, PermissionMutation as U, PermissionGrant as V, PermissionPage as W, RestoreItemVersionInput as X, RestoreItemInput as Y, RevokeItemPermissionInput as Z, DriveResponseValidators as _, CreateItemPermissionInput as a, UploadFilePhase as at, EffectivePermissionAction as b, CurrentWorkspace as c, UploadPartDescriptor as ct, DriveClient as d, UploadStatus as dt, UpdateItemInput as et, DriveClientConfig as f, WorkspaceItemSearchItem as ft, DriveOperations as g, DriveOperationResult as h, CreateFolderInput as i, UploadFileInput as it, ManagedDownloadDescriptor as j, ListItemPermissionsInput as k, DeleteItemInput as l, UploadPartResult as lt, DriveCredentialProvider as m, operations as mt, CompleteUploadInput as n, UploadCompletion as nt, CreateUploadInput as o, UploadFileProgress as ot, DriveCredentialContext as p, WorkspaceItemSearchPage as pt, ReadyUpload as q, CreateDownloadInput as r, UploadConfirmedPart as rt, CreateUploadPartDescriptorInput as s, UploadFileProgressCallback as st, AbortUploadInput as t, UpdateItemPermissionInput as tt, DownloadItemResult as u, UploadSession as ut, DriveServerClient as v, GetCurrentWorkspaceInput as w, EffectivePermissionResponse as x, DriveServerClientConfig as y, PendingUpload as z };
+export { ProtectionClassification as $, IncomingShareContext as A, ManagedDownloadRestorePending as B, FolderItem as C, WorkspaceDiscoveryPage as Ct, GetItemVersionInput as D, operations as Dt, GetItemInput as E, WorkspaceUsage as Et, ListItemPermissionsInput as F, ManagedItemVersionRestoreResult as G, ManagedItemVersion as H, ListItemSharingPeopleInput as I, PermissionAction as J, ManagedLifecycleItem as K, ListItemVersionsInput as L, ItemSharingPeoplePage as M, ListFolderChildrenInput as N, GetUploadStatusInput as O, ListIncomingSharesInput as P, PermissionPage as Q, ListWorkspaceItemsInput as R, EffectivePermissionResponse as S, WorkspaceDiscoveryItem as St, GetCurrentWorkspaceInput as T, WorkspaceItemSearchPage as Tt, ManagedItemVersionPage as U, ManagedItemMetadata as V, ManagedItemVersionResource as W, PermissionGrantee as X, PermissionGrant as Y, PermissionMutation as Z, DriveOperations as _, UploadFileProgressCallback as _t, CreateItemPermissionInput as a, RestoreItemInput as at, DriveServerClientConfig as b, UploadSession as bt, CurrentWorkspace as c, SearchWorkspaceItemsInput as ct, DownloadItemResult as d, UpdateItemPermissionInput as dt, ReadEffectiveItemPermissionsInput as et, DriveClient as f, UploadCompletion as ft, DriveOperationResult as g, UploadFileProgress as gt, DriveCredentialProvider as h, UploadFilePhase as ht, CreateFolderInput as i, RegisteredRecipientDisplay as it, IncomingSharePage as j, GetWorkspaceUsageInput as k, CurrentWorkspaceSources as l, TrashItemInput as lt, DriveCredentialContext as m, UploadFileInput as mt, CompleteUploadInput as n, RecordUploadPartInput as nt, CreateUploadInput as o, RestoreItemVersionInput as ot, DriveClientConfig as p, UploadConfirmedPart as pt, PendingUpload as q, CreateDownloadInput as r, RegisterItemRecipientInput as rt, CreateUploadPartDescriptorInput as s, RevokeItemPermissionInput as st, AbortUploadInput as t, ReadyUpload as tt, DeleteItemInput as u, UpdateItemInput as ut, DriveResponseValidators as v, UploadPartDescriptor as vt, FolderPage as w, WorkspaceItemSearchItem as wt, EffectivePermissionAction as x, UploadStatus as xt, DriveServerClient as y, UploadPartResult as yt, ManagedDownloadDescriptor as z };