@finueva/drive 0.29.0 → 0.31.0

package/dist/contract.d.ts

@@ -1886,6 +1886,156 @@ interface operations {
       };
     };
   };
+  getWorkspaceCounts: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        workspaceId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description Bounded counts; never a count of items the caller cannot list. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            /** @enum {number} */
+            ceiling: 999;
+            counts: {
+              allItems?: {
+                capped: boolean;
+                value: number;
+              };
+              favorites?: {
+                capped: boolean;
+                value: number;
+              };
+              media?: {
+                capped: boolean;
+                value: number;
+              };
+              sharedWithMe?: {
+                capped: boolean;
+                value: number;
+              };
+              trash?: {
+                capped: boolean;
+                value: number;
+              };
+            };
+            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;
+            };
+          };
+        };
+      };
+    };
+  };
   changeEditingSession: {
     parameters: {
       query?: never;
@@ -1973,14 +2123,9 @@ interface operations {
       };
     };
   };
-  listWorkspaceItems: {
+  listFavoriteItems: {
     parameters: {
       query?: {
-        view?: "recent" | "shared" | "trash";
-        kind?: "file" | "folder";
-        creatorUserId?: string;
-        /** @description Comma-separated exact lowercase media types (1–32 unique values). Matches published current file versions, not filename extensions. */
-        mediaTypes?: string;
         limit?: number;
         cursor?: string;
       };
@@ -1992,7 +2137,7 @@ interface operations {
     };
     requestBody?: never;
     responses: {
-      /** @description Authorized items and an authenticated continuation; no total count. */
+      /** @description Starred items in item order with an authenticated continuation; every item carries `favorite: true`. */
       200: {
         headers: {
           [name: string]: unknown;
@@ -2012,6 +2157,8 @@ interface operations {
                 versionId: string;
               } | null;
               etag: string;
+              /** @description Whether the caller starred the item. Present only when requested with `include=favorite` and always on favorite pages. */
+              favorite?: boolean;
               itemId: string;
               /** @enum {string} */
               lifecycleState: "active" | "trashed";
@@ -2136,49 +2283,70 @@ interface operations {
       };
     };
   };
-  getItem: {
+  listWorkspaceItems: {
     parameters: {
-      query?: never;
+      query?: {
+        view?: "recent" | "shared" | "trash";
+        kind?: "file" | "folder";
+        creatorUserId?: string;
+        /** @description Comma-separated exact lowercase media types (1–32 unique values). Matches published current file versions, not filename extensions. */
+        mediaTypes?: string;
+        /** @description Project the caller's private star on each item. */
+        include?: "favorite";
+        limit?: number;
+        cursor?: string;
+      };
       header?: never;
       path: {
         workspaceId: string;
-        itemId: string;
       };
       cookie?: never;
     };
     requestBody?: never;
     responses: {
-      /** @description The active managed item and current published version metadata. */
+      /** @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": {
-            currentVersion: {
-              byteLength: number;
-              mediaType: 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;
+              /** @description Whether the caller starred the item. Present only when requested with `include=favorite` and always on favorite pages. */
+              favorite?: boolean;
+              itemId: string;
               /** @enum {string} */
-              protectionClassification: "ordinary" | "opaque-encrypted";
+              lifecycleState: "active" | "trashed";
+              modifiedAtEpochMilliseconds: number | null;
+              name: string;
+              parentId: string | null;
               /** @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";
+              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;
@@ -2187,16 +2355,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 Managed storage is disabled for the discoverable item. */
+      /** @description The action is not permitted. */
       403: {
         headers: {
           [name: string]: unknown;
@@ -2205,16 +2372,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 is absent, undiscoverable, tombstoned, or unpublished. */
+      /** @description Workspace not found. */
       404: {
         headers: {
           [name: string]: unknown;
@@ -2223,16 +2389,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 Authorization or metadata changed after preflight. */
+      /** @description The selected authority or page changed; restart the query. */
       409: {
         headers: {
           [name: string]: unknown;
@@ -2241,16 +2406,15 @@ interface operations {
           "application/json": {
             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, or unexpected body is invalid. */
+      /** @description Invalid request or cursor. */
       422: {
         headers: {
           [name: string]: unknown;
@@ -2259,16 +2423,15 @@ interface operations {
           "application/json": {
             error: {
               /** @enum {string} */
-              code: "invalid_request";
+              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 is invalid.";
+              message: string;
               requestId: string;
             };
           };
         };
       };
-      /** @description Identity, D1, authorization, capacity, or managed authority is unavailable. */
+      /** @description Authoritative state is unavailable. */
       503: {
         headers: {
           [name: string]: unknown;
@@ -2277,19 +2440,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;
             };
           };
@@ -2297,13 +2450,174 @@ interface operations {
       };
     };
   };
-  deleteItem: {
+  getItem: {
     parameters: {
       query?: never;
-      header: {
-        "Idempotency-Key": string;
-        "If-Match": string;
-      };
+      header?: never;
+      path: {
+        workspaceId: string;
+        itemId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description The active managed item and current published version metadata. */
+      200: {
+        headers: {
+          /** @description Strong precondition for the next item mutation. */
+          ETag?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            currentVersion: {
+              byteLength: number;
+              mediaType: string;
+              /** @enum {string} */
+              protectionClassification: "ordinary" | "opaque-encrypted";
+              /** @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;
+          };
+        };
+      };
+      /** @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 Managed storage is disabled for the discoverable item. */
+      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 is absent, undiscoverable, tombstoned, or unpublished. */
+      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 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. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "invalid_request";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request is invalid.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity, D1, authorization, capacity, or managed 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;
+            };
+          };
+        };
+      };
+    };
+  };
+  deleteItem: {
+    parameters: {
+      query?: never;
+      header: {
+        "Idempotency-Key": string;
+        "If-Match": string;
+      };
       path: {
         workspaceId: string;
         itemId: string;
@@ -2915,8 +3229,8 @@ interface operations {
       query?: {
         limit?: number;
         cursor?: string;
-        /** @description Opt in to current version size and type, creation and modification time, creator, and effective owner on every item. Absent keeps the minimal item shape. */
-        include?: "metadata";
+        /** @description Opt in to current version size and type, creation and modification time, creator, and effective owner (`metadata`) and to the caller's private star (`favorite`) on every item. Absent keeps the minimal item shape. */
+        include?: "metadata" | "favorite" | "favorite,metadata" | "metadata,favorite";
       };
       header?: never;
       path: {
@@ -2946,6 +3260,8 @@ interface operations {
                 state: "current";
                 versionId: string;
               } | null;
+              /** @description The caller's private star; present with `include=favorite`. */
+              favorite?: boolean;
               itemId: string;
               /** @enum {string} */
               kind: "file" | "folder";
@@ -3624,52 +3940,32 @@ interface operations {
       };
     };
   };
-  transferItemOwnership: {
+  starItem: {
     parameters: {
       query?: never;
-      header: {
-        "Idempotency-Key": string;
-        "If-Match": string;
-      };
+      header?: never;
       path: {
         workspaceId: string;
         itemId: string;
       };
       cookie?: never;
     };
-    requestBody: {
-      content: {
-        "application/json": {
-          includeDescendants: boolean;
-          ownerUserId: string;
-          revokeVisitorGrants: boolean;
-        };
-      };
-    };
+    requestBody?: never;
     responses: {
-      /** @description Ownership was transferred or the exact result was replayed. */
+      /** @description The item is starred. */
       200: {
         headers: {
-          /** @description Strong precondition for the next item mutation. */
-          ETag?: string;
           [name: string]: unknown;
         };
         content: {
           "application/json": {
+            favorite: boolean;
             itemId: string;
-            /** @enum {string} */
-            kind: "file" | "folder";
-            ownerUserId: string;
-            previousOwnerUserId: string | null;
-            revision: number;
-            revokedVisitorGrantCount: number;
-            transferredItemCount: number;
-            volumeId: string;
             workspaceId: string;
           };
         };
       };
-      /** @description A valid Drive user bearer credential is required. */
+      /** @description Authentication required. */
       401: {
         headers: {
           [name: string]: unknown;
@@ -3678,16 +3974,19 @@ interface operations {
           "application/json": {
             error: {
               /** @enum {string} */
-              code: "authentication_required";
-              details: Record<string, never>;
+              code: "authentication_required" | "identity_authority_unavailable" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: {
+                /** @enum {string} */
+                reason?: "favorite_limit_reached";
+              };
               message: string;
               requestId: string;
             };
           };
         };
       };
-      /** @description The caller is not an owner or administrator of this organization workspace, or managed storage is disabled. */
-      403: {
+      /** @description Workspace not found, or the item is not one the caller can list. */
+      404: {
         headers: {
           [name: string]: unknown;
         };
@@ -3695,16 +3994,19 @@ interface operations {
           "application/json": {
             error: {
               /** @enum {string} */
-              code: "permission_denied";
-              details: Record<string, never>;
+              code: "authentication_required" | "identity_authority_unavailable" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: {
+                /** @enum {string} */
+                reason?: "favorite_limit_reached";
+              };
               message: string;
               requestId: string;
             };
           };
         };
       };
-      /** @description The workspace or item is absent or undiscoverable. */
-      404: {
+      /** @description The captured authority changed; retry. `favorite_limit_reached` means the caller keeps the maximum number of stars. */
+      409: {
         headers: {
           [name: string]: unknown;
         };
@@ -3712,16 +4014,19 @@ interface operations {
           "application/json": {
             error: {
               /** @enum {string} */
-              code: "resource_not_found";
-              details: Record<string, never>;
+              code: "authentication_required" | "identity_authority_unavailable" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: {
+                /** @enum {string} */
+                reason?: "favorite_limit_reached";
+              };
               message: string;
               requestId: string;
             };
           };
         };
       };
-      /** @description The key conflicts, the precondition is stale, or the transfer was refused with a reason. */
-      409: {
+      /** @description Invalid request. */
+      422: {
         headers: {
           [name: string]: unknown;
         };
@@ -3729,10 +4034,30 @@ interface operations {
           "application/json": {
             error: {
               /** @enum {string} */
-              code: "idempotency_conflict" | "precondition_failed";
+              code: "authentication_required" | "identity_authority_unavailable" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
               details: {
                 /** @enum {string} */
-                reason?: "ownership_unchanged" | "ownership_successor_not_member" | "ownership_restricted_items" | "ownership_subtree_too_large";
+                reason?: "favorite_limit_reached";
+              };
+              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" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: {
+                /** @enum {string} */
+                reason?: "favorite_limit_reached";
               };
               message: string;
               requestId: string;
@@ -3740,8 +4065,676 @@ interface operations {
           };
         };
       };
-      /** @description The path, query, headers, key or strict body is invalid. */
-      422: {
+    };
+  };
+  unstarItem: {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        workspaceId: string;
+        itemId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description The item is not starred. */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            favorite: boolean;
+            itemId: string;
+            workspaceId: string;
+          };
+        };
+      };
+      /** @description Authentication required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: {
+                /** @enum {string} */
+                reason?: "favorite_limit_reached";
+              };
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Workspace not found, or the item is not one the caller can list. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: {
+                /** @enum {string} */
+                reason?: "favorite_limit_reached";
+              };
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The captured authority changed; retry. `favorite_limit_reached` means the caller keeps the maximum number of stars. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: {
+                /** @enum {string} */
+                reason?: "favorite_limit_reached";
+              };
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Invalid request. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required" | "identity_authority_unavailable" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: {
+                /** @enum {string} */
+                reason?: "favorite_limit_reached";
+              };
+              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" | "resource_not_found" | "invalid_request" | "precondition_failed" | "service_unavailable";
+              details: {
+                /** @enum {string} */
+                reason?: "favorite_limit_reached";
+              };
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
+  transferItemOwnership: {
+    parameters: {
+      query?: never;
+      header: {
+        "Idempotency-Key": string;
+        "If-Match": string;
+      };
+      path: {
+        workspaceId: string;
+        itemId: string;
+      };
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          includeDescendants: boolean;
+          ownerUserId: string;
+          revokeVisitorGrants: boolean;
+        };
+      };
+    };
+    responses: {
+      /** @description Ownership was transferred or the exact result was replayed. */
+      200: {
+        headers: {
+          /** @description Strong precondition for the next item mutation. */
+          ETag?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            itemId: string;
+            /** @enum {string} */
+            kind: "file" | "folder";
+            ownerUserId: string;
+            previousOwnerUserId: string | null;
+            revision: number;
+            revokedVisitorGrantCount: number;
+            transferredItemCount: number;
+            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>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The caller is not an owner or administrator of this organization workspace, or managed storage is disabled. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "permission_denied";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The workspace or item 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 key conflicts, the precondition is stale, or the transfer was refused with a reason. */
+      409: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "idempotency_conflict" | "precondition_failed";
+              details: {
+                /** @enum {string} */
+                reason?: "ownership_unchanged" | "ownership_successor_not_member" | "ownership_restricted_items" | "ownership_subtree_too_large";
+              };
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, query, headers, key or strict body is invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "invalid_request" | "invalid_idempotency_key";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Auth membership resolution is temporarily limited; retry after the indicated delay. */
+      429: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "rate_limited";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity, Auth membership, D1, authorization or capacity authority is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "identity_authority_unavailable" | "service_unavailable";
+              details: Record<string, never>;
+              message: string;
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
+  listItemPermissions: {
+    parameters: {
+      query?: {
+        limit?: number;
+        cursor?: string;
+      };
+      header?: never;
+      path: {
+        workspaceId: string;
+        itemId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description A stable permission page. */
+      200: {
+        headers: {
+          /** @description Current direct collection precondition for POST on this item. */
+          "Drive-Permission-Collection-ETag"?: string;
+          /** @description Strong validator for the exact returned permission-list representation. */
+          ETag?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            collectionEtag: string;
+            collectionRevision: number;
+            items: {
+              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+              /** @enum {string} */
+              availability: "active" | "expired" | "revoked";
+              etag: string;
+              expiresAtEpochMilliseconds: number | null;
+              grantId: string;
+              grantee: {
+                /** @enum {string} */
+                type: "user";
+                userId: string;
+              } | {
+                teamId: string;
+                /** @enum {string} */
+                type: "team";
+              };
+              revision: number;
+              /** @enum {string} */
+              source: "direct" | "inherited";
+              sourceItemId: string;
+            }[];
+            nextCursor: string | null;
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is required.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The discoverable item does not permit this permission operation. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "permission_denied";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested action is not permitted.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The item, principal, or direct grant is absent or undiscoverable. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "resource_not_found";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested resource was not found.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The supplied revision or post-preflight authority is stale. */
+      412: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The path, query, headers, or pagination cursor are invalid. */
+      422: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "invalid_request";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The request is invalid.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "invalid_pagination_cursor";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The pagination cursor is invalid.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
+      503: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "identity_authority_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is temporarily unavailable.";
+              requestId: string;
+            };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "service_unavailable";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The service is temporarily unavailable.";
+              requestId: string;
+            };
+          };
+        };
+      };
+    };
+  };
+  createItemPermission: {
+    parameters: {
+      query?: never;
+      header: {
+        "Idempotency-Key": string;
+        "If-Match": string;
+      };
+      path: {
+        workspaceId: string;
+        itemId: string;
+      };
+      cookie?: never;
+    };
+    requestBody: {
+      content: {
+        "application/json": {
+          actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+          expiresAtEpochMilliseconds: number | null;
+          grantee: {
+            /** @enum {string} */
+            type: "user";
+            userId: string;
+          } | {
+            teamId: string;
+            /** @enum {string} */
+            type: "team";
+          };
+        };
+      };
+    };
+    responses: {
+      /** @description The exact committed result was replayed. */
+      200: {
+        headers: {
+          /** @description Current direct collection precondition for the next POST. */
+          "Drive-Permission-Collection-ETag"?: string;
+          /** @description Current direct-grant precondition for PATCH or DELETE; omitted when the current row is not mutable. */
+          "Drive-Permission-Grant-ETag"?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            collectionRevision: number;
+            grant: {
+              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+              /** @enum {string} */
+              availability: "active" | "expired" | "revoked";
+              expiresAtEpochMilliseconds: number | null;
+              grantId: string;
+              grantee: {
+                /** @enum {string} */
+                type: "user";
+                userId: string;
+              } | {
+                teamId: string;
+                /** @enum {string} */
+                type: "team";
+              };
+              revision: number;
+              /** @enum {string} */
+              source: "direct";
+              sourceItemId: string;
+            };
+            /** @enum {string} */
+            outcome: "committed" | "replayed";
+          };
+        };
+      };
+      /** @description The direct grant was committed. */
+      201: {
+        headers: {
+          /** @description Current direct collection precondition for the next POST. */
+          "Drive-Permission-Collection-ETag"?: string;
+          /** @description Current direct-grant precondition for PATCH or DELETE; omitted when the current row is not mutable. */
+          "Drive-Permission-Grant-ETag"?: string;
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            collectionRevision: number;
+            grant: {
+              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
+              /** @enum {string} */
+              availability: "active" | "expired" | "revoked";
+              expiresAtEpochMilliseconds: number | null;
+              grantId: string;
+              grantee: {
+                /** @enum {string} */
+                type: "user";
+                userId: string;
+              } | {
+                teamId: string;
+                /** @enum {string} */
+                type: "team";
+              };
+              revision: number;
+              /** @enum {string} */
+              source: "direct";
+              sourceItemId: string;
+            };
+            /** @enum {string} */
+            outcome: "committed" | "replayed";
+          };
+        };
+      };
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "authentication_required";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "Authentication is required.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The discoverable item does not permit this permission operation. */
+      403: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "permission_denied";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested action is not permitted.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The item, principal, or direct grant is absent or undiscoverable. */
+      404: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            error: {
+              /** @enum {string} */
+              code: "resource_not_found";
+              details: Record<string, never>;
+              /** @enum {string} */
+              message: "The requested resource was not found.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The idempotency key conflicts, or a permanent workspace sharing limit was reached. Sharing limit reasons are nonretryable. */
+      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: {
+                /** @enum {string} */
+                reason: "sharing_grant_limit_reached" | "sharing_history_limit_reached";
+              };
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          };
+        };
+      };
+      /** @description The supplied revision or post-preflight authority is stale. */
+      412: {
         headers: {
           [name: string]: unknown;
         };
@@ -3749,16 +4742,17 @@ interface operations {
           "application/json": {
             error: {
               /** @enum {string} */
-              code: "invalid_request" | "invalid_idempotency_key";
+              code: "precondition_failed";
               details: Record<string, never>;
-              message: string;
+              /** @enum {string} */
+              message: "The request precondition failed.";
               requestId: string;
             };
           };
         };
       };
-      /** @description Auth membership resolution is temporarily limited; retry after the indicated delay. */
-      429: {
+      /** @description The path, query, headers, idempotency key, or body are invalid. */
+      422: {
         headers: {
           [name: string]: unknown;
         };
@@ -3766,15 +4760,25 @@ interface operations {
           "application/json": {
             error: {
               /** @enum {string} */
-              code: "rate_limited";
+              code: "invalid_request";
               details: Record<string, never>;
-              message: string;
+              /** @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, Auth membership, D1, authorization or capacity authority is unavailable. */
+      /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
       503: {
         headers: {
           [name: string]: unknown;
@@ -3783,9 +4787,19 @@ interface operations {
           "application/json": {
             error: {
               /** @enum {string} */
-              code: "identity_authority_unavailable" | "service_unavailable";
+              code: "identity_authority_unavailable";
               details: Record<string, never>;
-              message: string;
+              /** @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;
             };
           };
@@ -3793,12 +4807,9 @@ interface operations {
       };
     };
   };
-  listItemPermissions: {
+  readEffectiveItemPermissions: {
     parameters: {
-      query?: {
-        limit?: number;
-        cursor?: string;
-      };
+      query?: never;
       header?: never;
       path: {
         workspaceId: string;
@@ -3808,41 +4819,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" | "item_owner" | "direct_grant" | "inherited_grant" | null;
+              grantId: string | null;
+              sourceItemId: string | null;
+            }[] & (unknown & unknown & unknown & unknown & unknown & unknown & unknown);
           };
         };
       };
@@ -3918,7 +4910,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;
@@ -3933,15 +4925,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;
-            };
           };
         };
       };
@@ -3974,7 +4957,7 @@ interface operations {
       };
     };
   };
-  createItemPermission: {
+  createInternalItemPermission: {
     parameters: {
       query?: never;
       header: {
@@ -4133,7 +5116,7 @@ interface operations {
           };
         };
       };
-      /** @description The idempotency key was reused for a different semantic request. */
+      /** @description The idempotency key conflicts, or a permanent workspace sharing limit was reached. Sharing limit reasons are nonretryable. */
       409: {
         headers: {
           [name: string]: unknown;
@@ -4148,6 +5131,18 @@ interface operations {
               message: "The idempotency key conflicts with an earlier request.";
               requestId: string;
             };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: {
+                /** @enum {string} */
+                reason: "sharing_grant_limit_reached" | "sharing_history_limit_reached";
+              };
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
           };
         };
       };
@@ -4225,34 +5220,54 @@ interface operations {
       };
     };
   };
-  readEffectiveItemPermissions: {
+  revokeInternalItemPermission: {
     parameters: {
       query?: never;
-      header?: never;
+      header: {
+        "Idempotency-Key": string;
+        "If-Match": string;
+      };
       path: {
         workspaceId: string;
         itemId: string;
+        grantId: string;
       };
       cookie?: never;
     };
     requestBody?: never;
     responses: {
-      /** @description All seven caller-specific item actions. */
+      /** @description The retained revoked grant was committed, replayed, or unchanged. */
       200: {
         headers: {
+          /** @description Current direct collection precondition for POST. */
+          "Drive-Permission-Collection-ETag"?: string;
           [name: string]: unknown;
         };
         content: {
           "application/json": {
-            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" | "item_owner" | "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";
           };
         };
       };
@@ -4310,6 +5325,36 @@ interface operations {
           };
         };
       };
+      /** @description The idempotency key conflicts, or a permanent workspace sharing limit was reached. Sharing limit reasons are nonretryable. */
+      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: {
+                /** @enum {string} */
+                reason: "sharing_grant_limit_reached" | "sharing_history_limit_reached";
+              };
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
+          };
+        };
+      };
       /** @description The supplied revision or post-preflight authority is stale. */
       412: {
         headers: {
@@ -4328,7 +5373,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;
@@ -4343,6 +5388,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;
+            };
           };
         };
       };
@@ -4375,81 +5429,27 @@ interface operations {
       };
     };
   };
-  createInternalItemPermission: {
+  revokeItemPermission: {
     parameters: {
       query?: never;
       header: {
         "Idempotency-Key": string;
-        "If-Match": string;
-      };
-      path: {
-        workspaceId: string;
-        itemId: string;
-      };
-      cookie?: never;
-    };
-    requestBody: {
-      content: {
-        "application/json": {
-          actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
-          expiresAtEpochMilliseconds: number | null;
-          grantee: {
-            /** @enum {string} */
-            type: "user";
-            userId: string;
-          } | {
-            teamId: string;
-            /** @enum {string} */
-            type: "team";
-          };
-        };
-      };
-    };
-    responses: {
-      /** @description The exact committed result was replayed. */
-      200: {
-        headers: {
-          /** @description Current direct collection precondition for the next POST. */
-          "Drive-Permission-Collection-ETag"?: string;
-          /** @description Current direct-grant precondition for PATCH or DELETE; omitted when the current row is not mutable. */
-          "Drive-Permission-Grant-ETag"?: string;
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": {
-            collectionRevision: number;
-            grant: {
-              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
-              /** @enum {string} */
-              availability: "active" | "expired" | "revoked";
-              expiresAtEpochMilliseconds: number | null;
-              grantId: string;
-              grantee: {
-                /** @enum {string} */
-                type: "user";
-                userId: string;
-              } | {
-                teamId: string;
-                /** @enum {string} */
-                type: "team";
-              };
-              revision: number;
-              /** @enum {string} */
-              source: "direct";
-              sourceItemId: string;
-            };
-            /** @enum {string} */
-            outcome: "committed" | "replayed";
-          };
-        };
+        "If-Match": string;
       };
-      /** @description The direct grant was committed. */
-      201: {
+      path: {
+        workspaceId: string;
+        itemId: string;
+        grantId: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description The retained revoked grant was committed, replayed, or unchanged. */
+      200: {
         headers: {
-          /** @description Current direct collection precondition for 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: {
@@ -4534,7 +5534,7 @@ interface operations {
           };
         };
       };
-      /** @description The idempotency key was reused for a different semantic request. */
+      /** @description The idempotency key conflicts, or a permanent workspace sharing limit was reached. Sharing limit reasons are nonretryable. */
       409: {
         headers: {
           [name: string]: unknown;
@@ -4549,6 +5549,18 @@ interface operations {
               message: "The idempotency key conflicts with an earlier request.";
               requestId: string;
             };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: {
+                /** @enum {string} */
+                reason: "sharing_grant_limit_reached" | "sharing_history_limit_reached";
+              };
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
           };
         };
       };
@@ -4626,7 +5638,7 @@ interface operations {
       };
     };
   };
-  revokeInternalItemPermission: {
+  updateItemPermission: {
     parameters: {
       query?: never;
       header: {
@@ -4640,13 +5652,22 @@ interface operations {
       };
       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 The retained revoked grant was committed, replayed, or unchanged. */
+      /** @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: {
@@ -4695,7 +5716,7 @@ interface operations {
           };
         };
       };
-      /** @description The discoverable item does not permit this permission operation. */
+      /** @description The item does not permit this permission operation, or the organization turned external sharing off (reason external_sharing_disabled). */
       403: {
         headers: {
           [name: string]: unknown;
@@ -4710,6 +5731,18 @@ interface operations {
               message: "The requested action is not permitted.";
               requestId: string;
             };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "permission_denied";
+              details: {
+                /** @enum {string} */
+                reason: "external_sharing_disabled";
+              };
+              /** @enum {string} */
+              message: "The requested action is not permitted.";
+              requestId: string;
+            };
           };
         };
       };
@@ -4731,7 +5764,7 @@ interface operations {
           };
         };
       };
-      /** @description The idempotency key was reused for a different semantic request. */
+      /** @description The idempotency key conflicts, or a permanent workspace sharing limit was reached. Sharing limit reasons are nonretryable. */
       409: {
         headers: {
           [name: string]: unknown;
@@ -4746,6 +5779,18 @@ interface operations {
               message: "The idempotency key conflicts with an earlier request.";
               requestId: string;
             };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: {
+                /** @enum {string} */
+                reason: "sharing_grant_limit_reached" | "sharing_history_limit_reached";
+              };
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
           };
         };
       };
@@ -4823,7 +5868,7 @@ interface operations {
       };
     };
   };
-  revokeItemPermission: {
+  restoreItem: {
     parameters: {
       query?: never;
       header: {
@@ -4833,44 +5878,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;
           };
         };
       };
@@ -4892,7 +5924,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;
@@ -4910,7 +5942,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;
@@ -4928,7 +5960,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;
@@ -4943,16 +5975,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";
@@ -4964,7 +5987,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;
@@ -4991,7 +6014,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;
@@ -5020,7 +6043,7 @@ interface operations {
       };
     };
   };
-  updateItemPermission: {
+  registerItemRecipient: {
     parameters: {
       query?: never;
       header: {
@@ -5030,26 +6053,27 @@ 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;
+          /** @description Require the freshly resolved Auth user ID to match before creating a grant. A mismatch returns registration_conflict without mutation. */
+          expectedRecipientUserId?: string;
+          /** @enum {string} */
+          role: "viewer" | "editor";
+          /** @description Exact canonical Auth User ID; Auth verifies current recipient eligibility. */
+          userId?: string;
+        } & (unknown | unknown);
       };
     };
     responses: {
-      /** @description The direct grant was committed or replayed. */
+      /** @description Exact grant replay. */
       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: {
@@ -5080,110 +6104,41 @@ interface operations {
           };
         };
       };
-      /** @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 item does not permit this permission operation, or the organization turned external sharing off (reason external_sharing_disabled). */
-      403: {
+      /** @description Registered recipient grant created. */
+      201: {
         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;
-            };
-          } | {
-            error: {
+            collectionRevision: number;
+            grant: {
+              actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
               /** @enum {string} */
-              code: "permission_denied";
-              details: {
+              availability: "active" | "expired" | "revoked";
+              expiresAtEpochMilliseconds: number | null;
+              grantId: string;
+              grantee: {
                 /** @enum {string} */
-                reason: "external_sharing_disabled";
+                type: "user";
+                userId: string;
+              } | {
+                teamId: string;
+                /** @enum {string} */
+                type: "team";
               };
-              /** @enum {string} */
-              message: "The requested action is not permitted.";
-              requestId: string;
-            };
-          };
-        };
-      };
-      /** @description The item, principal, or direct grant is absent or undiscoverable. */
-      404: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": {
-            error: {
-              /** @enum {string} */
-              code: "resource_not_found";
-              details: Record<string, never>;
-              /** @enum {string} */
-              message: "The requested resource was not found.";
-              requestId: string;
-            };
-          };
-        };
-      };
-      /** @description The idempotency key was reused for a different semantic request. */
-      409: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": {
-            error: {
-              /** @enum {string} */
-              code: "idempotency_conflict";
-              details: Record<string, never>;
-              /** @enum {string} */
-              message: "The idempotency key conflicts with an earlier request.";
-              requestId: string;
-            };
-          };
-        };
-      };
-      /** @description The supplied revision or post-preflight authority is stale. */
-      412: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": {
-            error: {
-              /** @enum {string} */
-              code: "precondition_failed";
-              details: Record<string, never>;
-              /** @enum {string} */
-              message: "The request precondition failed.";
-              requestId: string;
+              revision: number;
+              /** @enum {string} */
+              source: "direct";
+              sourceItemId: string;
             };
+            /** @enum {string} */
+            outcome: "committed" | "replayed";
           };
         };
       };
-      /** @description The path, query, headers, idempotency key, or body are invalid. */
-      422: {
+      /** @description A valid Drive user bearer credential is required. */
+      401: {
         headers: {
           [name: string]: unknown;
         };
@@ -5191,26 +6146,17 @@ 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";
               details: Record<string, never>;
               /** @enum {string} */
-              message: "The idempotency key is invalid.";
+              message: "Authentication is required.";
               requestId: string;
             };
           };
         };
       };
-      /** @description Identity, D1, authorization, audit, cursor, or capacity authority is unavailable. */
-      503: {
+      /** @description The item does not permit this permission operation, or the organization turned external sharing off (reason external_sharing_disabled). */
+      403: {
         headers: {
           [name: string]: unknown;
         };
@@ -5218,66 +6164,36 @@ interface operations {
           "application/json": {
             error: {
               /** @enum {string} */
-              code: "identity_authority_unavailable";
+              code: "permission_denied";
               details: Record<string, never>;
               /** @enum {string} */
-              message: "Authentication is temporarily unavailable.";
+              message: "The requested action is not permitted.";
               requestId: string;
             };
           } | {
             error: {
               /** @enum {string} */
-              code: "service_unavailable";
-              details: Record<string, never>;
+              code: "permission_denied";
+              details: {
+                /** @enum {string} */
+                reason: "external_sharing_disabled";
+              };
               /** @enum {string} */
-              message: "The service is temporarily unavailable.";
+              message: "The requested action is not permitted.";
               requestId: string;
             };
           };
         };
       };
-    };
-  };
-  restoreItem: {
-    parameters: {
-      query?: never;
-      header: {
-        "Idempotency-Key": string;
-        "If-Match": string;
-      };
-      path: {
-        workspaceId: string;
-        itemId: string;
-      };
-      cookie?: never;
-    };
-    requestBody?: never;
-    responses: {
-      /** @description The managed item was restored or exactly replayed. */
-      200: {
+      /** @description The item or registered recipient is unavailable. */
+      404: {
         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;
-          };
-        };
+        content?: never;
       };
-      /** @description A valid Drive user bearer credential is required. */
-      401: {
+      /** @description Idempotency conflict, a nonretryable sharing limit, or registration_conflict: the resolved recipient does not match the expected user. */
+      409: {
         headers: {
           [name: string]: unknown;
         };
@@ -5285,67 +6201,43 @@ interface operations {
           "application/json": {
             error: {
               /** @enum {string} */
-              code: "authentication_required";
+              code: "idempotency_conflict";
               details: Record<string, never>;
               /** @enum {string} */
-              message: "Authentication is required.";
+              message: "The idempotency key conflicts with an earlier request.";
               requestId: string;
             };
-          };
-        };
-      };
-      /** @description The discoverable item does not permit this lifecycle action. */
-      403: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": {
+          } | {
             error: {
               /** @enum {string} */
-              code: "permission_denied";
-              details: Record<string, never>;
+              code: "precondition_failed";
+              details: {
+                /** @enum {string} */
+                reason: "sharing_grant_limit_reached" | "sharing_history_limit_reached";
+              };
               /** @enum {string} */
-              message: "The requested action is not permitted.";
+              message: "The request precondition failed.";
               requestId: string;
             };
-          };
-        };
-      };
-      /** @description The item or destination is absent or undiscoverable. */
-      404: {
-        headers: {
-          [name: string]: unknown;
-        };
-        content: {
-          "application/json": {
+          } | {
             error: {
               /** @enum {string} */
-              code: "resource_not_found";
+              code: "registration_conflict";
               details: Record<string, never>;
               /** @enum {string} */
-              message: "The requested resource was not found.";
+              message: "The recipient could not be confirmed.";
               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";
@@ -5357,7 +6249,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;
@@ -5384,7 +6276,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;
@@ -5413,7 +6312,7 @@ interface operations {
       };
     };
   };
-  registerItemRecipient: {
+  registerItemRecipients: {
     parameters: {
       query?: never;
       header: {
@@ -5429,81 +6328,154 @@ interface operations {
     requestBody: {
       content: {
         "application/json": {
-          /** @description Normalized email, at most 320 UTF-8 bytes. */
-          email?: string;
-          /** @description Require the freshly resolved Auth user ID to match before creating a grant. A mismatch returns registration_conflict without mutation. */
-          expectedRecipientUserId?: string;
-          /** @enum {string} */
-          role: "viewer" | "editor";
-          /** @description Exact canonical Auth User ID; Auth verifies current recipient eligibility. */
-          userId?: string;
-        } & (unknown | unknown);
+          /** @description Distinct recipients in result order. Each entry has the registerItemRecipient body shape; a repeated selector is invalid. */
+          recipients: ({
+            /** @description Normalized email, at most 320 UTF-8 bytes. */
+            email?: string;
+            /** @description Require the freshly resolved Auth user ID to match before creating a grant. A mismatch returns registration_conflict without mutation. */
+            expectedRecipientUserId?: string;
+            /** @enum {string} */
+            role: "viewer" | "editor";
+            /** @description Exact canonical Auth User ID; Auth verifies current recipient eligibility. */
+            userId?: string;
+          } & (unknown | unknown))[];
+        };
       };
     };
     responses: {
-      /** @description Exact grant replay. */
+      /** @description No new grant was committed: every recipient was replayed, already present or refused individually. */
       200: {
         headers: {
           [name: string]: unknown;
         };
         content: {
           "application/json": {
+            collectionEtag: string;
             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: {
+            results: ({
+              grant: {
+                actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
                 /** @enum {string} */
-                type: "user";
-                userId: string;
-              } | {
-                teamId: 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} */
-                type: "team";
+                source: "direct";
+                sourceItemId: string;
               };
-              revision: number;
+              grantEtag: string | null;
               /** @enum {string} */
-              source: "direct";
-              sourceItemId: string;
-            };
-            /** @enum {string} */
-            outcome: "committed" | "replayed";
+              outcome: "added";
+              /** @description True when an exact retry returns the grant this batch created earlier. */
+              replayed: boolean;
+            } | {
+              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;
+              } & unknown;
+              grantEtag: string | null;
+              /** @enum {string} */
+              outcome: "already_present";
+            } | {
+              /** @enum {string} */
+              outcome: "refused";
+              /** @enum {string} */
+              reason: "recipient_unavailable" | "registration_conflict" | "duplicate_recipient";
+            })[];
           };
         };
       };
-      /** @description Registered recipient grant created. */
+      /** @description Every new grant committed together under the collection precondition. */
       201: {
         headers: {
           [name: string]: unknown;
         };
         content: {
           "application/json": {
+            collectionEtag: string;
             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: {
+            results: ({
+              grant: {
+                actions: ("items:content:read" | "items:create" | "items:delete" | "items:metadata:read" | "items:permissions:read" | "items:update")[];
                 /** @enum {string} */
-                type: "user";
-                userId: string;
-              } | {
-                teamId: 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} */
-                type: "team";
+                source: "direct";
+                sourceItemId: string;
               };
-              revision: number;
+              grantEtag: string | null;
               /** @enum {string} */
-              source: "direct";
-              sourceItemId: string;
-            };
-            /** @enum {string} */
-            outcome: "committed" | "replayed";
+              outcome: "added";
+              /** @description True when an exact retry returns the grant this batch created earlier. */
+              replayed: boolean;
+            } | {
+              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;
+              } & unknown;
+              grantEtag: string | null;
+              /** @enum {string} */
+              outcome: "already_present";
+            } | {
+              /** @enum {string} */
+              outcome: "refused";
+              /** @enum {string} */
+              reason: "recipient_unavailable" | "registration_conflict" | "duplicate_recipient";
+            })[];
           };
         };
       };
@@ -5555,14 +6527,14 @@ interface operations {
           };
         };
       };
-      /** @description The item or registered recipient is unavailable. */
+      /** @description The item is unavailable. */
       404: {
         headers: {
           [name: string]: unknown;
         };
         content?: never;
       };
-      /** @description Idempotency conflict or registration_conflict: the resolved recipient does not match the expected user. */
+      /** @description The idempotency key conflicts, or the whole batch exceeds a permanent workspace sharing limit and nothing was written. A sharing limit reason is nonretryable for this request; a smaller batch may still fit. */
       409: {
         headers: {
           [name: string]: unknown;
@@ -5580,10 +6552,13 @@ interface operations {
           } | {
             error: {
               /** @enum {string} */
-              code: "registration_conflict";
-              details: Record<string, never>;
+              code: "precondition_failed";
+              details: {
+                /** @enum {string} */
+                reason: "sharing_grant_limit_reached" | "sharing_history_limit_reached";
+              };
               /** @enum {string} */
-              message: "The recipient could not be confirmed.";
+              message: "The request precondition failed.";
               requestId: string;
             };
           };
@@ -5634,7 +6609,7 @@ interface operations {
           };
         };
       };
-      /** @description Recipient resolution rate limit exceeded. */
+      /** @description Recipient resolution rate limit exceeded; nothing was written. */
       429: {
         headers: {
           [name: string]: unknown;
@@ -5772,7 +6747,7 @@ interface operations {
         };
         content?: never;
       };
-      /** @description The idempotency key was reused for a different semantic request. */
+      /** @description The idempotency key conflicts, or a permanent workspace sharing limit was reached. Sharing limit reasons are nonretryable. */
       409: {
         headers: {
           [name: string]: unknown;
@@ -5787,6 +6762,18 @@ interface operations {
               message: "The idempotency key conflicts with an earlier request.";
               requestId: string;
             };
+          } | {
+            error: {
+              /** @enum {string} */
+              code: "precondition_failed";
+              details: {
+                /** @enum {string} */
+                reason: "sharing_grant_limit_reached" | "sharing_history_limit_reached";
+              };
+              /** @enum {string} */
+              message: "The request precondition failed.";
+              requestId: string;
+            };
           };
         };
       };
@@ -7788,6 +8775,45 @@ type RegisterItemRecipientInput = {
   readonly userId: string;
   readonly email?: never;
 });
+type ItemRecipientBatchEntry = {
+  /** Assert the freshly resolved Auth identity before this recipient's grant is created. */
+  readonly expectedRecipientUserId?: string;
+  readonly role: "viewer" | "editor";
+} & ({
+  readonly email: string;
+  readonly userId?: never;
+} | {
+  readonly userId: string;
+  readonly email?: never;
+});
+type RegisterItemRecipientsInput = {
+  readonly workspaceId: string;
+  readonly itemId: string;
+  /** One to 15 distinct recipients; results keep this order. */
+  readonly recipients: readonly ItemRecipientBatchEntry[];
+  readonly ifMatch: string;
+  readonly idempotencyKey: string;
+  readonly signal?: AbortSignal;
+};
+type ItemSharingBatchResult = Readonly<{
+  outcome: "added";
+  /** True when an exact retry returns the grant this batch created earlier. */
+  replayed: boolean;
+  grant: PermissionMutation["grant"];
+  grantEtag: string | null;
+}> | Readonly<{
+  outcome: "already_present";
+  grant: PermissionMutation["grant"];
+  grantEtag: string | null;
+}> | Readonly<{
+  outcome: "refused";
+  reason: "recipient_unavailable" | "registration_conflict" | "duplicate_recipient";
+}>;
+type ItemSharingBatch = Readonly<{
+  collectionRevision: number;
+  collectionEtag: string;
+  results: readonly ItemSharingBatchResult[];
+}>;
 type ListItemSharingPeopleInput = ListItemPermissionsInput;
 type GeneratedIncomingItemPage = JsonResponse<"listIncomingItems", 200>;
 type IncomingItemMetadata = Readonly<GeneratedIncomingItemPage["items"][number]>;
@@ -7838,9 +8864,27 @@ interface ListWorkspaceItemsInput extends GetWorkspaceUsageInput {
   readonly view?: "recent" | "shared" | "trash";
   readonly kind?: "file" | "folder";
   readonly creatorUserId?: string;
+  /** Present from SDK 0.31. Adds the caller's private `favorite` star to every returned item. */
+  readonly includeFavorite?: boolean;
+  readonly limit?: number;
+  readonly cursor?: string;
+}
+/** The caller's private star on one item after a star or unstar request. */
+type ItemFavorite = Readonly<JsonResponse<"starItem", 200>>;
+type StarItemInput = ResourceInput;
+type UnstarItemInput = ResourceInput;
+interface ListFavoriteItemsInput extends GetWorkspaceUsageInput {
   readonly limit?: number;
   readonly cursor?: string;
 }
+type GeneratedWorkspaceCounts = JsonResponse<"getWorkspaceCounts", 200>;
+/** One sidebar count; a value above the server ceiling arrives as the ceiling with `capped: true`. */
+type WorkspaceCount = Readonly<NonNullable<GeneratedWorkspaceCounts["counts"]["allItems"]>>;
+/** Sidebar counts for the caller; a count Drive cannot compute exactly and cheaply is omitted. */
+type WorkspaceCounts = Readonly<Omit<GeneratedWorkspaceCounts, "counts"> & {
+  readonly counts: Readonly<{ [Name in keyof GeneratedWorkspaceCounts["counts"]]?: WorkspaceCount; }>;
+}>;
+type WorkspaceCountsInput = GetWorkspaceUsageInput;
 type GeneratedOwnedItemPage = JsonResponse<"listOwnedItems", 200>;
 /** One item a member effectively owns: an assigned owner, otherwise its recorded creator. */
 type OwnedItem = Readonly<Omit<GeneratedOwnedItemPage["items"][number], "currentVersion"> & {
@@ -7909,9 +8953,12 @@ type CurrentWorkspace = Readonly<Omit<GeneratedCurrentWorkspace, "workspaceRefer
 }>;
 type FolderItem = Readonly<JsonResponse<"createFolder", 201>>;
 type GeneratedFolderPage = JsonResponse<"listFolderChildren", 200>;
-/** `metadata` adds current version size and type, timestamps, creator and effective owner to every listed item. */
+/**
+ * `metadata` adds current version size and type, timestamps, creator and effective owner to every listed item;
+ * `favorite` adds the caller's private star. `favorite,metadata` or `metadata,favorite` requests both.
+ */
 type FolderListInclude = NonNullable<FolderChildrenQuery["include"]>;
-/** A listed child. Detail fields are present exactly when the listing requested `include: "metadata"`. */
+/** A listed child. Detail fields are present exactly when the listing requested them through `include`. */
 type FolderListedItem = Readonly<GeneratedFolderPage["items"][number]>;
 type ManagedLifecycleItem = Readonly<JsonResponse<"updateItem", 200>>;
 type GeneratedManagedItemMetadata = JsonResponse<"getItem", 200>;
@@ -8130,10 +9177,20 @@ interface DriveOperations {
   listVisitorGrants(input: GetItemInput): Promise<DriveOperationResult<VisitorGrantPage, 200>>;
   revokeVisitorGrant(input: RevokeVisitorGrantInput): Promise<DriveOperationResult<VisitorGrant, 200>>;
   registerItemRecipient(input: RegisterItemRecipientInput): Promise<DriveOperationResult<PermissionMutation, 200 | 201>>;
+  /** Shares one item with up to 15 registered recipients under one collection precondition and atomic commit. */
+  registerItemRecipients(input: RegisterItemRecipientsInput): Promise<DriveOperationResult<ItemSharingBatch, 200 | 201>>;
   listItemSharingPeople(input: ListItemSharingPeopleInput): Promise<DriveOperationResult<ItemSharingPeoplePage, 200>>;
   listIncomingShares(input?: ListIncomingSharesInput): Promise<DriveOperationResult<IncomingSharePage, 200>>;
   listIncomingItems(input?: ListIncomingItemsInput): Promise<DriveOperationResult<IncomingItemPage, 200>>;
   listWorkspaceItems(input: ListWorkspaceItemsInput): Promise<DriveOperationResult<WorkspaceDiscoveryPage, 200>>;
+  /** Present from SDK 0.31. Stars an item the caller can list; private and idempotent. */
+  starItem(input: StarItemInput): Promise<DriveOperationResult<ItemFavorite, 200>>;
+  /** Present from SDK 0.31. Removes the caller's own star; idempotent. */
+  unstarItem(input: UnstarItemInput): Promise<DriveOperationResult<ItemFavorite, 200>>;
+  /** Present from SDK 0.31. The caller's starred items they can still list, in item order. */
+  listFavoriteItems(input: ListFavoriteItemsInput): Promise<DriveOperationResult<WorkspaceDiscoveryPage, 200>>;
+  /** Present from SDK 0.31. Bounded sidebar counts, each authorized exactly like its listing. */
+  getWorkspaceCounts(input: WorkspaceCountsInput): Promise<DriveOperationResult<WorkspaceCounts, 200>>;
   getCurrentUserWorkspaceUsage(input: GetWorkspaceUsageInput): Promise<DriveOperationResult<CurrentUserWorkspaceUsage, 200>>;
   getWorkspaceUsage(input: GetWorkspaceUsageInput): Promise<DriveOperationResult<WorkspaceUsage, 200>>;
   listOwnedItems(input: ListOwnedItemsInput): Promise<DriveOperationResult<OwnedItemPage, 200>>;
@@ -8220,4 +9277,4 @@ interface DriveClient extends DriveOperations, VerifiedTransferOperations {
   uploadVerifiedFile(input: UploadVerifiedFileInput): Promise<DriveOperationResult<PublishedVerifiedTransfer, 200>>;
 }
 //#endregion
-export { ListFolderChildrenInput as $, VisitorEditingSession as $t, DriveUploadConfig as A, RecoverVerifiedTransferInput as At, FolderListedItem as B, UpdateItemInput as Bt, DriveEditingClientConfig as C, PermissionPage as Ct, DriveResponseValidators as D, PublishVerifiedTransferInput as Dt, DriveOperations as E, ProtectionClassification as Et, EffectivePermissionAction as F, RevokeItemPermissionInput as Ft, GetVisitorGrantInput as G, UploadFileProgressCallback as Gt, GetCurrentWorkspaceInput as H, UpdateWorkspaceSharingPolicyInput as Ht, EffectivePermissionResponse as I, RevokeVisitorGrantInput as It, IncomingItemPage as J, UploadVerifiedFileInput as Jt, GetWorkspaceUsageInput as K, UploadFileStage as Kt, FileAccessContext as L, SearchWorkspaceItemsInput as Lt, DriveVisitorClientConfig as M, RegisteredRecipientDisplay as Mt, EditingSession as N, RestoreItemInput as Nt, DriveServerClient as O, PublishedVerifiedTransfer as Ot, EditingSessionCreation as P, RestoreItemVersionInput as Pt, ItemSharingPeoplePage as Q, VisitorDownloadInput as Qt, FolderItem as R, TransferItemOwnershipInput as Rt, DriveEditingClient as S, PermissionMutation as St, DriveOperationResult as T, PreparedVerifiedTransfer as Tt, GetItemInput as U, UploadFilePhase as Ut, FolderPage as V, UpdateItemPermissionInput as Vt, GetItemVersionInput as W, UploadFileProgress as Wt, IncomingSharePage as X, VisitorChildren as Xt, IncomingShareContext as Y, VerifiedTransferOperations as Yt, ItemOwnershipTransfer as Z, VisitorChildrenInput as Zt, DownloadItemResult as _, OwnedItem as _t, CollectOwnedItemsInput as a, VisitorSession as an, ListOwnedItemsInput as at, DriveCredentialContext as b, PermissionGrant as bt, CreateEditingSessionInput as c, WorkspaceItemSearchItem as cn, ManagedDownloadRestorePending as ct, CreateVisitorEditingSessionInput as d, WorkspaceUsage as dn, ManagedItemVersionPage as dt, VisitorGrant as en, ListIncomingItemsInput as et, CreateVisitorGrantInput as f, operations as fn, ManagedItemVersionResource as ft, DeleteItemInput as g, OrganizationMemberStorageUsageInput as gt, CurrentWorkspaceSources as h, OrganizationMemberStorageUsage as ht, ChangeEditingSessionInput as i, VisitorReadInput as in, ListItemVersionsInput as it, DriveVisitorClient as j, RegisterItemRecipientInput as jt, DriveServerClientConfig as k, ReadEffectiveItemPermissionsInput as kt, CreateFolderInput as l, WorkspaceItemSearchPage as ln, ManagedItemMetadata as lt, CurrentWorkspace as m, ManagedLifecycleItem as mt, ArchiveItemInput as n, VisitorGrantPage as nn, ListItemPermissionsInput as nt, CollectedOwnedItems as o, WorkspaceDiscoveryItem as on, ListWorkspaceItemsInput as ot, CurrentUserWorkspaceUsage as p, ManagedItemVersionRestoreResult as pt, IncomingItemMetadata as q, UploadSmallVerifiedFileInput as qt, ArchivedItem as r, VisitorItem as rn, ListItemSharingPeopleInput as rt, CreateDownloadInput as s, WorkspaceDiscoveryPage as sn, ManagedDownloadDescriptor as st, AdmittedVerifiedTransfer as t, VisitorGrantCreation as tn, ListIncomingSharesInput as tt, CreateItemPermissionInput as u, WorkspaceSharingPolicy as un, ManagedItemVersion as ut, DriveClient as v, OwnedItemPage as vt, DriveEditingServerClient as w, PrepareVerifiedTransferInput as wt, DriveCredentialProvider as x, PermissionGrantee as xt, DriveClientConfig as y, PermissionAction as yt, FolderListInclude as z, TrashItemInput as zt };
+export { ItemRecipientBatchEntry as $, UploadFileProgressCallback as $t, DriveUploadConfig as A, PreparedVerifiedTransfer as At, FolderListedItem as B, RestoreItemVersionInput as Bt, DriveEditingClientConfig as C, operations as Cn, OwnedItemPage as Ct, DriveResponseValidators as D, PermissionMutation as Dt, DriveOperations as E, PermissionGrantee as Et, EffectivePermissionAction as F, RecoverVerifiedTransferInput as Ft, GetVisitorGrantInput as G, TransferItemOwnershipInput as Gt, GetCurrentWorkspaceInput as H, RevokeVisitorGrantInput as Ht, EffectivePermissionResponse as I, RegisterItemRecipientInput as It, IncomingItemPage as J, UpdateItemInput as Jt, GetWorkspaceUsageInput as K, TrashItemInput as Kt, FileAccessContext as L, RegisterItemRecipientsInput as Lt, DriveVisitorClientConfig as M, PublishVerifiedTransferInput as Mt, EditingSession as N, PublishedVerifiedTransfer as Nt, DriveServerClient as O, PermissionPage as Ot, EditingSessionCreation as P, ReadEffectiveItemPermissionsInput as Pt, ItemOwnershipTransfer as Q, UploadFileProgress as Qt, FolderItem as R, RegisteredRecipientDisplay as Rt, DriveEditingClient as S, WorkspaceUsage as Sn, OwnedItem as St, DriveOperationResult as T, PermissionGrant as Tt, GetItemInput as U, SearchWorkspaceItemsInput as Ut, FolderPage as V, RevokeItemPermissionInput as Vt, GetItemVersionInput as W, StarItemInput as Wt, IncomingSharePage as X, UpdateWorkspaceSharingPolicyInput as Xt, IncomingShareContext as Y, UpdateItemPermissionInput as Yt, ItemFavorite as Z, UploadFilePhase as Zt, DownloadItemResult as _, WorkspaceDiscoveryItem as _n, ManagedItemVersionResource as _t, CollectOwnedItemsInput as a, VisitorChildrenInput as an, ListIncomingItemsInput as at, DriveCredentialContext as b, WorkspaceItemSearchPage as bn, OrganizationMemberStorageUsage as bt, CreateEditingSessionInput as c, VisitorGrant as cn, ListItemSharingPeopleInput as ct, CreateVisitorEditingSessionInput as d, VisitorItem as dn, ListWorkspaceItemsInput as dt, UploadFileStage as en, ItemSharingBatch as et, CreateVisitorGrantInput as f, VisitorReadInput as fn, ManagedDownloadDescriptor as ft, DeleteItemInput as g, WorkspaceCountsInput as gn, ManagedItemVersionPage as gt, CurrentWorkspaceSources as h, WorkspaceCounts as hn, ManagedItemVersion as ht, ChangeEditingSessionInput as i, VisitorChildren as in, ListFolderChildrenInput as it, DriveVisitorClient as j, ProtectionClassification as jt, DriveServerClientConfig as k, PrepareVerifiedTransferInput as kt, CreateFolderInput as l, VisitorGrantCreation as ln, ListItemVersionsInput as lt, CurrentWorkspace as m, WorkspaceCount as mn, ManagedItemMetadata as mt, ArchiveItemInput as n, UploadVerifiedFileInput as nn, ItemSharingPeoplePage as nt, CollectedOwnedItems as o, VisitorDownloadInput as on, ListIncomingSharesInput as ot, CurrentUserWorkspaceUsage as p, VisitorSession as pn, ManagedDownloadRestorePending as pt, IncomingItemMetadata as q, UnstarItemInput as qt, ArchivedItem as r, VerifiedTransferOperations as rn, ListFavoriteItemsInput as rt, CreateDownloadInput as s, VisitorEditingSession as sn, ListItemPermissionsInput as st, AdmittedVerifiedTransfer as t, UploadSmallVerifiedFileInput as tn, ItemSharingBatchResult as tt, CreateItemPermissionInput as u, VisitorGrantPage as un, ListOwnedItemsInput as ut, DriveClient as v, WorkspaceDiscoveryPage as vn, ManagedItemVersionRestoreResult as vt, DriveEditingServerClient as w, PermissionAction as wt, DriveCredentialProvider as x, WorkspaceSharingPolicy as xn, OrganizationMemberStorageUsageInput as xt, DriveClientConfig as y, WorkspaceItemSearchItem as yn, ManagedLifecycleItem as yt, FolderListInclude as z, RestoreItemInput as zt };