@pipedream/google_drive 2.1.0 → 3.0.0

package/actions/add-comment/add-comment.mjs

@@ -4,13 +4,14 @@ export default {
   key: "google_drive-add-comment",
   name: "Add Comment",
   description: "Add an unanchored comment to a Google Doc (general feedback, no text highlighting). [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/comments/create)",
-  version: "0.1.9",
+  version: "0.1.11",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: false,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/add-file-sharing-preference/add-file-sharing-preference.mjs

@@ -20,7 +20,7 @@ export default {
   name: "Share File or Folder",
   description:
     "Add a [sharing permission](https://support.google.com/drive/answer/7166529) to the sharing preferences of a file or folder and provide a sharing URL. [See the documentation](https://developers.google.com/drive/api/v3/reference/permissions/create)",
-  version: "0.2.17",
+  version: "0.2.18",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/copy-file/copy-file.mjs

@@ -4,13 +4,14 @@ export default {
   key: "google_drive-copy-file",
   name: "Copy File",
   description: "Create a copy of the specified file. [See the documentation](https://developers.google.com/drive/api/v3/reference/files/copy) for more information",
-  version: "0.1.24",
+  version: "0.1.26",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: false,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/create-file-from-template/create-file-from-template.mjs

@@ -9,13 +9,14 @@ export default {
   key: "google_drive-create-file-from-template",
   name: "Create New File From Template",
   description: "Create a new Google Docs file from a template. Optionally include placeholders in the template document that will get replaced from this action. [See documentation](https://www.npmjs.com/package/google-docs-mustaches)",
-  version: "0.1.27",
+  version: "0.1.29",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,
     readOnlyHint: false,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/create-file-from-text/create-file-from-text.mjs

@@ -5,13 +5,14 @@ export default {
   key: "google_drive-create-file-from-text",
   name: "Create New File From Text",
   description: "Create a new file from plain text. [See the documentation](https://developers.google.com/drive/api/v3/reference/files/create) for more information",
-  version: "0.2.17",
+  version: "0.2.19",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: false,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/create-folder/create-folder.mjs

@@ -13,13 +13,14 @@ export default {
   key: "google_drive-create-folder",
   name: "Create Folder",
   description: "Create a new empty folder. [See the documentation](https://developers.google.com/drive/api/v3/reference/files/create) for more information",
-  version: "0.1.25",
+  version: "0.1.27",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: false,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/create-shared-drive/create-shared-drive.mjs

@@ -4,13 +4,14 @@ export default {
   key: "google_drive-create-shared-drive",
   name: "Create Shared Drive",
   description: "Create a new shared drive. [See the documentation](https://developers.google.com/drive/api/v3/reference/drives/create) for more information",
-  version: "0.1.25",
+  version: "0.1.27",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: false,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     name: {

package/actions/create-text-file/create-text-file.mjs

@@ -12,8 +12,9 @@ export default {
     + " `mimeType = 'application/vnd.google-apps.folder'` to find the folder ID first."
     + " Supported content formats: plain text, Markdown, HTML, Rich Text, CSV."
     + " [See the documentation](https://developers.google.com/drive/api/v3/reference/files/create)",
-  version: "0.0.3",
+  version: "0.0.5",
   type: "action",
+  ai: "optimized",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/delete-comment/delete-comment.mjs

@@ -4,13 +4,14 @@ export default {
   key: "google_drive-delete-comment",
   name: "Delete Comment",
   description: "Delete a specific comment (Requires ownership or permissions). [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/comments/delete)",
-  version: "0.0.13",
+  version: "0.0.15",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,
     readOnlyHint: false,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/delete-file/delete-file.mjs

@@ -5,13 +5,14 @@ export default {
   name: "Delete File",
   description:
     "Permanently delete a file or folder without moving it to the trash. [See the documentation](https://developers.google.com/drive/api/v3/reference/files/delete) for more information",
-  version: "0.1.25",
+  version: "0.1.27",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,
     readOnlyHint: false,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     infoAlert: {

package/actions/delete-reply/delete-reply.mjs

@@ -4,13 +4,14 @@ export default {
   key: "google_drive-delete-reply",
   name: "Delete Reply",
   description: "Delete a reply on a specific comment. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/replies/delete) for more information",
-  version: "0.0.10",
+  version: "0.0.12",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,
     readOnlyHint: false,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/delete-shared-drive/delete-shared-drive.mjs

@@ -4,13 +4,14 @@ export default {
   key: "google_drive-delete-shared-drive",
   name: "Delete Shared Drive",
   description: "Delete a shared drive without any content. [See the documentation](https://developers.google.com/drive/api/v3/reference/drives/delete) for more information",
-  version: "0.1.24",
+  version: "0.1.26",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,
     readOnlyHint: false,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/download-file/download-file.mjs

@@ -33,13 +33,14 @@ export default {
     + " Pass `mimeType` to force a specific format. Shortcuts are resolved to their target automatically."
     + " Folders, Forms, and My Maps cannot be downloaded via this action."
     + " [See the documentation](https://developers.google.com/drive/api/v3/manage-downloads)",
-  version: "0.2.1",
+  version: "0.2.3",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: false,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/find-file/find-file.mjs

@@ -6,13 +6,14 @@ export default {
   key: "google_drive-find-file",
   name: "Find File",
   description: "Search for a specific file by name. The `Search Name` field uses Google Drive's tokenized full-text matching — pass a distinctive word or short phrase rather than the full title when the name contains special characters like `&` or `'`. [See the documentation](https://developers.google.com/drive/api/v3/search-files) for more information",
-  version: "0.1.25",
+  version: "0.1.27",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: true,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/find-folder/find-folder.mjs

@@ -7,13 +7,14 @@ export default {
   key: "google_drive-find-folder",
   name: "Find Folder",
   description: "Search for a specific folder by name. The `Search Name` field uses Google Drive's tokenized full-text matching — pass a distinctive word or short phrase rather than the full title when the name contains special characters like `&` or `'`. [See the documentation](https://developers.google.com/drive/api/v3/search-files) for more information",
-  version: "0.1.25",
+  version: "0.1.27",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: true,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/find-forms/find-forms.mjs

@@ -6,13 +6,14 @@ export default {
   key: "google_drive-find-forms",
   name: "Find Forms",
   description: "List Google Form documents or search for a Form by name. The `Search Name` field uses Google Drive's tokenized full-text matching — pass a distinctive word or short phrase rather than the full title when the name contains special characters like `&` or `'`. [See the documentation](https://developers.google.com/drive/api/v3/search-files) for more information",
-  version: "0.0.26",
+  version: "0.0.28",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: true,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/find-spreadsheets/find-spreadsheets.mjs

@@ -6,13 +6,14 @@ export default {
   key: "google_drive-find-spreadsheets",
   name: "Find Spreadsheets",
   description: "Search for a specific spreadsheet by name. The `Search Name` field uses Google Drive's tokenized full-text matching — pass a distinctive word or short phrase rather than the full title when the name contains special characters like `&` or `'`. [See the documentation](https://developers.google.com/drive/api/v3/search-files) for more information",
-  version: "0.1.25",
+  version: "0.1.27",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: true,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/get-comment/get-comment.mjs

@@ -4,13 +4,14 @@ export default {
   key: "google_drive-get-comment",
   name: "Get Comment By ID",
   description: "Get comment by ID on a specific file. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/comments/get) for more information",
-  version: "0.0.10",
+  version: "0.0.12",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: true,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/get-current-user/get-current-user.mjs

@@ -6,8 +6,9 @@ export default {
   key: "google_drive-get-current-user",
   name: "Get Current User",
   description: "Retrieve Google Drive account metadata for the authenticated user via `about.get`, including display name, email, permission ID, and storage quota. Useful when flows or agents need to confirm the active Google identity or understand available storage. [See the documentation](https://developers.google.com/drive/api/v3/reference/about/get).",
-  version: "0.0.11",
+  version: "0.0.13",
   type: "action",
+  ai: "optimized",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/get-file/get-file.mjs

@@ -11,8 +11,9 @@ export default {
     + "\n\nCommon fields: `id`, `name`, `mimeType`, `size`, `parents`, `webViewLink`, `webContentLink`,"
     + " `createdTime`, `modifiedTime`, `owners`, `permissions`, `description`, `trashed`."
     + " [See the documentation](https://developers.google.com/drive/api/v3/reference/files/get)",
-  version: "0.0.3",
+  version: "0.0.5",
   type: "action",
+  ai: "optimized",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/get-file-by-id/get-file-by-id.mjs

@@ -5,13 +5,14 @@ export default {
   key: "google_drive-get-file-by-id",
   name: "Get File By ID",
   description: "Get info on a specific file. [See the documentation](https://developers.google.com/drive/api/reference/rest/v3/files/get) for more information",
-  version: "0.0.21",
+  version: "0.0.23",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: true,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/get-folder-id-for-path/get-folder-id-for-path.mjs

@@ -12,13 +12,14 @@ export default {
   key: "google_drive-get-folder-id-for-path",
   name: "Get Folder ID for a Path",
   description: "Retrieve a folderId for a path. [See the documentation](https://developers.google.com/drive/api/v3/search-files) for more information",
-  version: "0.1.26",
+  version: "0.1.28",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: true,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/get-reply/get-reply.mjs

@@ -4,13 +4,14 @@ export default {
   key: "google_drive-get-reply",
   name: "Get Reply By ID",
   description: "Get reply by ID on a specific comment. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/replies/get) for more information",
-  version: "0.0.10",
+  version: "0.0.12",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: true,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/get-shared-drive/get-shared-drive.mjs

@@ -4,13 +4,14 @@ export default {
   key: "google_drive-get-shared-drive",
   name: "Get Shared Drive",
   description: "Get metadata for one or all shared drives. [See the documentation](https://developers.google.com/drive/api/v3/reference/drives/get) for more information",
-  version: "0.1.24",
+  version: "0.1.26",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: true,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/get-user-details/get-user-details.mjs

@@ -10,8 +10,9 @@ export default {
     + " When the user says 'my files' or 'my documents', call this first to get the owner email,"
     + " then pass it to **Search Files** with a query like `'user@example.com' in owners`."
     + " [See the documentation](https://developers.google.com/drive/api/v3/reference/about/get)",
-  version: "0.0.3",
+  version: "0.0.5",
   type: "action",
+  ai: "optimized",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/is-folder-ancestor/is-folder-ancestor.mjs

@@ -4,8 +4,9 @@ export default {
   key: "google_drive-is-folder-ancestor",
   name: "Is Folder Ancestor",
   description: "Check if a specific folder is anywhere in the parent hierarchy of a file or folder. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/files/get)",
-  version: "0.0.5",
+  version: "0.0.7",
   type: "action",
+  ai: "optimized",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-access-proposals/list-access-proposals.mjs

@@ -4,13 +4,14 @@ export default {
   key: "google_drive-list-access-proposals",
   name: "List Access Proposals",
   description: "List access proposals for a file or folder. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/accessproposals/list)",
-  version: "0.0.17",
+  version: "0.0.19",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: true,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/list-comments/list-comments.mjs

@@ -8,13 +8,14 @@ export default {
   key: "google_drive-list-comments",
   name: "List Comments",
   description: "List the comments on a file, including each comment's author, plain text and HTML content, the file text it is anchored to, whether it is resolved, and its full reply thread. Use **Find File** first to resolve a file's name to its ID. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/comments/list)",
-  version: "0.1.0",
+  version: "0.1.2",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: true,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/list-files/list-files.mjs

@@ -9,13 +9,14 @@ export default {
   key: "google_drive-list-files",
   name: "List Files",
   description: "List files from a specific folder. Set `Max Results` to cap how many files are returned per run, then pass the returned `nextPageToken` back in as `Page Token` on the next run to page through a large folder in fixed-size batches. [See the documentation](https://developers.google.com/drive/api/v3/reference/files/list) for more information",
-  version: "1.0.1",
+  version: "1.0.3",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: true,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     limitToMyDrive: {
@@ -74,17 +75,18 @@ export default {
       optional: true,
     },
     maxResults: {
-      label: "Max Results",
-      type: "integer",
-      description: "The maximum number of files to return per run. Leave empty to return every file in the folder. Combine with `Page Token` to page through a large folder in fixed-size batches across multiple runs.",
-      optional: true,
-      min: 1,
+      propDefinition: [
+        googleDrive,
+        "maxResults",
+      ],
+      description: "The maximum number of files to return per run. Leave empty to return every file in the folder. Combine with `Page Token` to page through a large folder in fixed-size batches across multiple runs. Example: `25`.",
     },
     pageToken: {
-      label: "Page Token",
-      type: "string",
-      description: "A cursor for resuming a previous run. Pass the `nextPageToken` returned by an earlier run to continue listing from where it stopped instead of starting over. Leave empty to start from the beginning of the folder.",
-      optional: true,
+      propDefinition: [
+        googleDrive,
+        "pageToken",
+      ],
+      description: "A cursor for resuming a previous run. Pass the `nextPageToken` returned by an earlier run to continue listing from where it stopped instead of starting over. Leave empty to start from the beginning of the folder. Example: `~!!~AI9FV7Q...`.",
     },
   },
   async run({ $ }) {

package/actions/list-mime-type-options/list-mime-type-options.mjs

@@ -4,8 +4,9 @@ export default {
   key: "google_drive-list-mime-type-options",
   name: "List Mime Type Options",
   description: "Retrieves available options for the Mime Type field.",
-  version: "0.0.4",
+  version: "0.0.6",
   type: "action",
+  ai: "optimized",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-permissions/list-permissions.mjs

@@ -10,8 +10,9 @@ export default {
     + " Use this tool when the user asks 'who has access to this file?' or needs to audit sharing."
     + " Pass permission IDs from this response to **Remove Sharing** to revoke access."
     + " [See the documentation](https://developers.google.com/drive/api/v3/reference/permissions/list)",
-  version: "0.0.3",
+  version: "0.0.5",
   type: "action",
+  ai: "optimized",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-replies/list-replies.mjs

@@ -4,13 +4,14 @@ export default {
   key: "google_drive-list-replies",
   name: "List Replies",
   description: "List replies to a specific comment. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/replies/list) for more information",
-  version: "0.0.10",
+  version: "0.0.12",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: true,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/list-shared-drives/list-shared-drives.mjs

@@ -10,8 +10,9 @@ export default {
     + " Pass a drive ID to **Search Files** `driveId` parameter to search within a specific shared drive."
     + " Optionally filter by name using the `query` parameter (e.g., `name contains 'Engineering'`)."
     + " [See the documentation](https://developers.google.com/drive/api/v3/reference/drives/list)",
-  version: "0.0.3",
+  version: "0.0.5",
   type: "action",
+  ai: "optimized",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/list-theme-id-options/list-theme-id-options.mjs

@@ -4,8 +4,9 @@ export default {
   key: "google_drive-list-theme-id-options",
   name: "List Theme ID Options",
   description: "Retrieves available options for the Theme ID field.",
-  version: "0.0.4",
+  version: "0.0.6",
   type: "action",
+  ai: "optimized",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/move-file/move-file.mjs

@@ -4,13 +4,14 @@ export default {
   key: "google_drive-move-file",
   name: "Move File",
   description: "Move a file from one folder to another. [See the documentation](https://developers.google.com/drive/api/v3/reference/files/update) for more information",
-  version: "0.1.24",
+  version: "0.1.26",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,
     readOnlyHint: false,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/move-file-to-trash/move-file-to-trash.mjs

@@ -5,13 +5,14 @@ export default {
   key: "google_drive-move-file-to-trash",
   name: "Move File to Trash",
   description: "Move a file or folder to trash. [See the documentation](https://developers.google.com/drive/api/v3/reference/files/update) for more information",
-  version: "0.1.24",
+  version: "0.1.26",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,
     readOnlyHint: false,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     infoAlert: {

package/actions/remove-file-sharing-permission/remove-file-sharing-permission.mjs

@@ -6,7 +6,7 @@ export default {
   name: "Remove File Sharing Permission",
   description:
     "Remove a [sharing permission](https://support.google.com/drive/answer/7166529) from the sharing preferences of a file or folder. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/permissions/delete)",
-  version: "0.0.9",
+  version: "0.0.10",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/remove-sharing/remove-sharing.mjs

@@ -10,8 +10,9 @@ export default {
     + " The owner permission cannot be removed."
     + " Use **Search Files** to find the file ID by name if needed."
     + " [See the documentation](https://developers.google.com/drive/api/v3/reference/permissions/delete)",
-  version: "0.0.3",
+  version: "0.0.5",
   type: "action",
+  ai: "optimized",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/reply-to-comment/reply-to-comment.mjs

@@ -4,13 +4,14 @@ export default {
   key: "google_drive-reply-to-comment",
   name: "Reply to Comment",
   description: "Add a reply to an existing comment. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/replies/create)",
-  version: "0.0.13",
+  version: "0.0.15",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: false,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/resolve-access-proposal/resolve-access-proposal.mjs

@@ -5,13 +5,14 @@ export default {
   key: "google_drive-resolve-access-proposal",
   name: "Resolve Access Proposals",
   description: "Accept or deny a request for access to a file or folder in Google Drive. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/accessproposals/resolve)",
-  version: "0.0.17",
+  version: "0.0.19",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: false,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/resolve-comment/resolve-comment.mjs

@@ -4,13 +4,14 @@ export default {
   key: "google_drive-resolve-comment",
   name: "Resolve Comment",
   description: "Mark a comment as resolved. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/comments/update)",
-  version: "0.0.13",
+  version: "0.0.15",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,
     readOnlyHint: false,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/search-files/search-files.mjs

@@ -1,5 +1,10 @@
+import { ConfigurationError } from "@pipedream/platform";
 import { getListFilesOpts } from "../../common/utils.mjs";
 import googleDrive from "../../google_drive.app.mjs";
+import {
+  DEFAULT_SEARCH_FILES_LIMIT,
+  FILES_MAX_PAGE_SIZE,
+} from "../../common/constants.mjs";
 
 export default {
   key: "google_drive-search-files",
@@ -7,7 +12,8 @@ export default {
   description:
     "Search for files and folders in Google Drive using the Drive query language."
     + " This is the primary tool for finding files, folders, spreadsheets, forms, and any other Drive item."
-    + " Returns matching files with their IDs, names, MIME types, and parent folder IDs."
+    + " Returns an object with `files` (each with its ID, name, and MIME type), `count`,"
+    + " `nextPageToken`, `isComplete`, and `incompleteSearch`."
     + "\n\n**Query syntax** — pass a Drive search query string. Examples:"
     + "\n- Find by name: `name contains 'Budget'`"
     + "\n- Exact name match: `name = 'Q4 Report'`"
@@ -21,9 +27,18 @@ export default {
     + "\n- Owner filter: `'user@example.com' in owners`"
     + "\n\nWhen the user says 'my files', use **Get User Details** first to get the owner email."
     + " To scope to a shared drive, pass the `driveId` from **List Shared Drives**."
+    + "\n\n**Pagination** — each call returns at most `maxResults` files (default "
+    + `${DEFAULT_SEARCH_FILES_LIMIT}). If \`isComplete\` is \`false\`, more matches exist:`
+    + " call again with `pageToken` set to the returned `nextPageToken` and the **same**"
+    + " `query`, `driveId`, and `includeItemsFromAllDrives` to get the next batch."
+    + " When `isComplete` is `true`, `nextPageToken` is `null` and there are no more pages."
+    + " If `incompleteSearch` is `true`, Drive did not search every drive, so matches may be"
+    + " missing and paging will not recover them — narrow the search with `driveId`."
+    + " Prefer narrowing the `query` over paging through many batches."
     + " [See the documentation](https://developers.google.com/drive/api/v3/search-files)",
-  version: "0.0.3",
+  version: "1.0.0",
   type: "action",
+  ai: "optimized",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -45,38 +60,102 @@ export default {
       description:
         "Optional. Scope the search to a specific shared drive."
         + " Use **List Shared Drives** to find available drive IDs."
-        + " Omit to search My Drive.",
+        + " Omit to search across all drives (My Drive and shared drives). Example: `0AExampleDriveId`.",
       optional: true,
     },
     includeItemsFromAllDrives: {
       type: "boolean",
       label: "Include Items From All Drives",
       description:
-        "If true, include results from all drives (My Drive and shared drives)."
-        + " Defaults to false.",
+        "If true, search the files the user has access to plus the shared drives the user is a member of;"
+        + " if false, search only the user's own files (files owned by or shared with the user),"
+        + " excluding shared drive contents."
+        + " Ignored when `driveId` is set. Defaults to true. Example: `true`.",
       optional: true,
-      default: false,
+      default: true,
+    },
+    maxResults: {
+      propDefinition: [
+        googleDrive,
+        "maxResults",
+      ],
+      description:
+        "The maximum number of files to return in this call."
+        + ` Defaults to ${DEFAULT_SEARCH_FILES_LIMIT}.`
+        + " If more matches exist, the response has `isComplete: false` and a `nextPageToken`"
+        + " to pass as `pageToken` on the next call. Example: `25`.",
+      default: DEFAULT_SEARCH_FILES_LIMIT,
+    },
+    pageToken: {
+      propDefinition: [
+        googleDrive,
+        "pageToken",
+      ],
+      description:
+        "Optional. The `nextPageToken` from a previous **Search Files** response, to continue"
+        + " where it stopped. Use the same `query`, `driveId`, and `includeItemsFromAllDrives`"
+        + " as that call. Omit to start from the first result. Example: `~!!~AI9FV7Q...`.",
     },
   },
   async run({ $ }) {
-    const opts = getListFilesOpts(this.driveId, {
-      q: this.query,
-      includeItemsFromAllDrives: this.includeItemsFromAllDrives,
-    });
+    const includeAll = this.includeItemsFromAllDrives ?? true;
+    // A shared drive needs includeItemsFromAllDrives: true, which the helper sets.
+    // Otherwise, build opts here so the toggle actually picks the corpus.
+    const opts = this.driveId
+      ? getListFilesOpts(this.driveId, {
+        q: this.query,
+      })
+      : {
+        q: this.query,
+        corpora: includeAll
+          ? "allDrives"
+          : "user",
+        includeItemsFromAllDrives: includeAll,
+        supportsAllDrives: includeAll,
+      };
 
+    const maxResults = Number(this.maxResults ?? DEFAULT_SEARCH_FILES_LIMIT);
+    if (!Number.isInteger(maxResults) || maxResults < 1) {
+      throw new ConfigurationError("`Max Results` must be a positive integer.");
+    }
+
+    const startToken = this.pageToken || undefined;
     const allFiles = [];
-    let pageToken;
+    let pageToken = startToken;
+    let incompleteSearch = false;
     do {
+      // Request only as many as we still need, so the returned nextPageToken
+      // points right after the last file we keep and resuming skips nothing.
       const {
-        files, nextPageToken,
-      } = await this.googleDrive.listFilesInPage(pageToken, opts);
+        files = [], nextPageToken, incompleteSearch: pageIncomplete,
+      } = await this.googleDrive.listFilesInPage(pageToken, {
+        ...opts,
+        pageSize: Math.min(maxResults - allFiles.length, FILES_MAX_PAGE_SIZE),
+      });
       allFiles.push(...files);
       pageToken = nextPageToken;
-    } while (pageToken);
+      // Drive sets this when it skipped some drives (typically with the
+      // allDrives corpus); paging can't recover those results.
+      incompleteSearch ||= Boolean(pageIncomplete);
+    } while (pageToken && allFiles.length < maxResults);
 
-    $.export("$summary", `Found ${allFiles.length} file${allFiles.length === 1
+    const isComplete = !pageToken;
+    $.export("$summary", `${startToken
+      ? "Resumed and found"
+      : "Found"} ${allFiles.length} file${allFiles.length === 1
+      ? ""
+      : "s"} matching query "${this.query}".${isComplete
       ? ""
-      : "s"} matching query "${this.query}"`);
-    return allFiles;
+      : " More results remain — pass `nextPageToken` as `pageToken` to continue."}${incompleteSearch
+      ? " Drive did not search every drive, so some matches may be missing — narrow the search with `driveId`."
+      : ""}`);
+
+    return {
+      files: allFiles,
+      count: allFiles.length,
+      nextPageToken: pageToken ?? null,
+      isComplete,
+      incompleteSearch,
+    };
   },
 };

package/actions/search-shared-drives/search-shared-drives.mjs

@@ -4,13 +4,14 @@ export default {
   key: "google_drive-search-shared-drives",
   name: "Search for Shared Drives",
   description: "Search for shared drives with query options. [See the documentation](https://developers.google.com/drive/api/v3/search-shareddrives) for more information",
-  version: "0.1.25",
+  version: "0.1.27",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: true,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     q: {

package/actions/share-file/share-file.mjs

@@ -15,8 +15,9 @@ export default {
     + "\n\n**Roles:** `reader` (view only), `commenter` (can comment), `writer` (can edit)."
     + " Use **List Permissions** to see existing sharing on a file."
     + " [See the documentation](https://developers.google.com/drive/api/v3/reference/permissions/create)",
-  version: "0.0.3",
+  version: "0.0.5",
   type: "action",
+  ai: "optimized",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/actions/trash-file/trash-file.mjs

@@ -10,8 +10,9 @@ export default {
     + " Use this instead of permanent deletion as the safer default."
     + " To find trashed files, use **Search Files** with `trashed = true`."
     + " [See the documentation](https://developers.google.com/drive/api/v3/reference/files/update)",
-  version: "0.0.3",
+  version: "0.0.5",
   type: "action",
+  ai: "optimized",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

package/actions/update-comment/update-comment.mjs

@@ -4,13 +4,14 @@ export default {
   key: "google_drive-update-comment",
   name: "Update Comment",
   description: "Update the content of a specific comment. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/comments/update) for more information",
-  version: "0.0.10",
+  version: "0.0.12",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: false,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/update-file/update-file.mjs

@@ -6,13 +6,14 @@ export default {
   key: "google_drive-update-file",
   name: "Update File",
   description: "Update a file's metadata and/or content. [See the documentation](https://developers.google.com/drive/api/v3/reference/files/update) for more information",
-  version: "2.0.16",
+  version: "2.0.18",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,
     readOnlyHint: false,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/update-reply/update-reply.mjs

@@ -4,13 +4,14 @@ export default {
   key: "google_drive-update-reply",
   name: "Update Reply",
   description: "Update a reply on a specific comment. [See the documentation](https://developers.google.com/workspace/drive/api/reference/rest/v3/replies/update) for more information",
-  version: "0.0.10",
+  version: "0.0.12",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: false,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/update-shared-drive/update-shared-drive.mjs

@@ -4,13 +4,14 @@ export default {
   key: "google_drive-update-shared-drive",
   name: "Update Shared Drive",
   description: "Update an existing shared drive. [See the documentation](https://developers.google.com/drive/api/v3/reference/drives/update) for more information",
-  version: "0.1.24",
+  version: "0.1.26",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,
     readOnlyHint: false,
   },
   type: "action",
+  ai: "optimized",
   props: {
     googleDrive,
     drive: {

package/actions/upload-file/upload-file.mjs

@@ -13,7 +13,7 @@ export default {
   key: "google_drive-upload-file",
   name: "Upload File",
   description: "Upload a file to Google Drive. [See the documentation](https://developers.google.com/drive/api/v3/manage-uploads) for more information",
-  version: "2.0.17",
+  version: "2.0.18",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

package/common/constants.mjs

@@ -245,6 +245,18 @@ const DEFAULT_COMMENT_LIMIT = 100;
 
 const MAX_COMMENT_LIMIT = 500;
 
+/**
+ * Maximum `pageSize` accepted by `files.list` (the API allows 1-1000).
+ * https://developers.google.com/workspace/drive/api/reference/rest/v3/files/list
+ */
+const FILES_MAX_PAGE_SIZE = 1000;
+
+/**
+ * Default number of files **Search Files** returns per run, so an agent that omits
+ * `maxResults` still gets a bounded response instead of enumerating a whole shared drive.
+ */
+const DEFAULT_SEARCH_FILES_LIMIT = 100;
+
 export {
   GOOGLE_DRIVE_NOTIFICATION_SYNC,
   GOOGLE_DRIVE_NOTIFICATION_ADD,
@@ -285,4 +297,7 @@ export {
   COMMENTS_MAX_PAGE_SIZE,
   DEFAULT_COMMENT_LIMIT,
   MAX_COMMENT_LIMIT,
+  // Files
+  FILES_MAX_PAGE_SIZE,
+  DEFAULT_SEARCH_FILES_LIMIT,
 };

package/google_drive.app.mjs

@@ -378,6 +378,19 @@ export default {
         };
       },
     },
+    maxResults: {
+      type: "integer",
+      label: "Max Results",
+      description: "The maximum number of files to return per call. Example: `25`.",
+      optional: true,
+      min: 1,
+    },
+    pageToken: {
+      type: "string",
+      label: "Page Token",
+      description: "The `nextPageToken` returned by a previous call, to continue from where it stopped. Example: `~!!~AI9FV7Q...`.",
+      optional: true,
+    },
   },
   methods: {
     // Static methods

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/google_drive",
-  "version": "2.1.0",
+  "version": "3.0.0",
   "description": "Pipedream Google_drive Components",
   "main": "google_drive.app.mjs",
   "keywords": [

package/sources/changes-to-files-in-drive/changes-to-files-in-drive.mjs

@@ -14,7 +14,7 @@ export default {
   key: "google_drive-changes-to-files-in-drive",
   name: "Changes to Files in Drive",
   description: "Emit new event when a change is made to one of the specified files. [See the documentation](https://developers.google.com/drive/api/v3/reference/changes/watch)",
-  version: "0.0.13",
+  version: "0.0.14",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/changes-to-specific-files/changes-to-specific-files.mjs

@@ -16,7 +16,7 @@ export default {
   key: "google_drive-changes-to-specific-files",
   name: "Changes to Specific Files",
   description: "Watches for changes to specific files, emitting an event when a change is made to one of those files. To watch for changes to [shared drive](https://support.google.com/a/users/answer/9310351) files, use the **Changes to Specific Files (Shared Drive)** source instead.",
-  version: "0.3.11",
+  version: "0.3.12",
   type: "source",
   // Dedupe events based on the "x-goog-message-number" header for the target channel:
   // https://developers.google.com/drive/api/v3/push#making-watch-requests

package/sources/changes-to-specific-files-shared-drive/changes-to-specific-files-shared-drive.mjs

@@ -29,7 +29,7 @@ export default {
   key: "google_drive-changes-to-specific-files-shared-drive",
   name: "Changes to Specific Files (Shared Drive)",
   description: "Watches for changes to specific files in a shared drive, emitting an event when a change is made to one of those files",
-  version: "0.3.13",
+  version: "0.3.14",
   type: "source",
   // Dedupe events based on the "x-goog-message-number" header for the target channel:
   // https://developers.google.com/drive/api/v3/push#making-watch-requests

package/sources/new-access-proposal/new-access-proposal.mjs

@@ -6,7 +6,7 @@ export default {
   key: "google_drive-new-access-proposal",
   name: "New Access Proposal",
   description: "Emit new event when a new access proposal is requested in Google Drive",
-  version: "0.0.16",
+  version: "0.0.17",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/new-files-instant/new-files-instant.mjs

@@ -11,7 +11,7 @@ export default {
   key: "google_drive-new-files-instant",
   name: "New Files (Instant)",
   description: "Emit new event when a new file is added in your linked Google Drive",
-  version: "0.2.13",
+  version: "0.2.14",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/new-files-instant-polling/new-files-instant-polling.mjs

@@ -8,7 +8,7 @@ export default {
   key: "google_drive-new-files-instant-polling",
   name: "New Files (Polling)",
   description: "Emit new event when a new file is added in your linked Google Drive",
-  version: "0.0.11",
+  version: "0.0.12",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/new-files-shared-drive/new-files-shared-drive.mjs

@@ -7,7 +7,7 @@ export default {
   key: "google_drive-new-files-shared-drive",
   name: "New Files (Shared Drive)",
   description: "Emit new event when a new file is added in your shared Google Drive",
-  version: "0.1.13",
+  version: "0.1.14",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/new-or-modified-comments/new-or-modified-comments.mjs

@@ -18,7 +18,7 @@ export default {
   name: "New or Modified Comments (Instant)",
   description:
     "Emit new event when a comment is created or modified in the selected file",
-  version: "1.0.22",
+  version: "1.0.23",
   type: "source",
   // Dedupe events based on the "x-goog-message-number" header for the target channel:
   // https://developers.google.com/drive/api/v3/push#making-watch-requests

package/sources/new-or-modified-comments-polling/new-or-modified-comments-polling.mjs

@@ -7,7 +7,7 @@ export default {
   key: "google_drive-new-or-modified-comments-polling",
   name: "New or Modified Comments (Polling)",
   description: "Emit new event when a comment is created or modified in the selected file",
-  version: "0.0.11",
+  version: "0.0.12",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/new-or-modified-files/new-or-modified-files.mjs

@@ -26,7 +26,7 @@ export default {
   key: "google_drive-new-or-modified-files",
   name: "New or Modified Files (Instant)",
   description: "Emit new event when a file in the selected Drive is created, modified or trashed.",
-  version: "0.4.13",
+  version: "0.4.14",
   type: "source",
   // Dedupe events based on the "x-goog-message-number" header for the target channel:
   // https://developers.google.com/drive/api/v3/push#making-watch-requests

package/sources/new-or-modified-files-polling/new-or-modified-files-polling.mjs

@@ -9,7 +9,7 @@ export default {
   key: "google_drive-new-or-modified-files-polling",
   name: "New or Modified Files (Polling)",
   description: "Emit new event when a file in the selected Drive is created, modified or trashed. [See the documentation](https://developers.google.com/drive/api/v3/reference/changes/list)",
-  version: "0.0.13",
+  version: "0.0.14",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/new-or-modified-folders/new-or-modified-folders.mjs

@@ -21,7 +21,7 @@ export default {
   key: "google_drive-new-or-modified-folders",
   name: "New or Modified Folders (Instant)",
   description: "Emit new event when a folder is created or modified in the selected Drive",
-  version: "0.2.16",
+  version: "0.2.17",
   type: "source",
   // Dedupe events based on the "x-goog-message-number" header for the target channel:
   // https://developers.google.com/drive/api/v3/push#making-watch-requests

package/sources/new-or-modified-folders-polling/new-or-modified-folders-polling.mjs

@@ -12,7 +12,7 @@ export default {
   key: "google_drive-new-or-modified-folders-polling",
   name: "New or Modified Folders (Polling)",
   description: "Emit new event when a folder is created or modified in the selected Drive",
-  version: "0.0.12",
+  version: "0.0.13",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/new-shared-drive/new-shared-drive.mjs

@@ -5,7 +5,7 @@ export default {
   key: "google_drive-new-shared-drive",
   name: "New Shared Drive",
   description: "Emits a new event any time a shared drive is created.",
-  version: "0.1.23",
+  version: "0.1.24",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/new-spreadsheet/new-spreadsheet.mjs

@@ -6,7 +6,7 @@ export default {
   type: "source",
   name: "New Spreadsheet (Instant)",
   description: "Emit new event when a new spreadsheet is created in a drive.",
-  version: "0.1.26",
+  version: "0.1.27",
   props: {
     googleDrive: newFilesInstant.props.googleDrive,
     db: newFilesInstant.props.db,

package/sources/new-spreadsheet-polling/new-spreadsheet-polling.mjs

@@ -8,7 +8,7 @@ export default {
   key: "google_drive-new-spreadsheet-polling",
   name: "New Spreadsheet (Polling)",
   description: "Emit new event when a new spreadsheet is created in a drive.",
-  version: "0.0.11",
+  version: "0.0.12",
   type: "source",
   dedupe: "unique",
   props: {