@commandable/integration-data 0.0.6 → 0.0.7

package/integrations/google-gmail/README.md

@@ -0,0 +1,49 @@
+# Gmail
+
+**25 tools** across 2 toolsets
+
+![Gmail tests](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/theomccabe/771bd329f303087690c522afa1baa6f3/raw/test-google-gmail.json)
+
+## Credential variants
+
+| Variant | Label |
+|---|---|
+| `service_account` | Service Account (recommended) _(default)_ |
+| `oauth_token` | OAuth Access Token (short-lived) |
+
+## Toolsets
+
+| Toolset | Description |
+|---|---|
+| `email` | Search, read, compose, and send emails and drafts |
+| `organize` | Label, archive, trash, and delete messages and threads |
+
+## Tools
+
+| Tool | Scope | Toolset | Description |
+|---|---|---|---|
+| `get_profile` | read | `email` | Get mailbox profile details for the authenticated user, including email address, messages… |
+| `list_messages` | read | `email` | List message IDs matching a Gmail search query or label filters. Returns only IDs and thr… |
+| `read_email` | read | `email` | Read an email by message ID and return a flat, decoded result with subject, from, to, cc,… |
+| `get_message` | read | `email` | Get the raw Gmail message resource by message ID. Returns the full nested payload includi… |
+| `list_threads` | read | `email` | List thread IDs matching a Gmail search query or label filters. Similar to list_messages … |
+| `get_thread` | read | `email` | Get a full thread resource by thread ID, including all messages in the conversation. Use … |
+| `list_drafts` | read | `email` | List drafts in the mailbox. Returns draft IDs and the nested message ID. Use get_draft to… |
+| `get_draft` | read | `email` | Get a draft by draft ID. Returns the draft object including the nested message resource. … |
+| `send_email` | write | `email` | Send an email by providing flat fields: to, subject, and body. Handles MIME encoding and … |
+| `create_draft_email` | write | `email` | Create a draft email using flat fields: subject, body, and optionally to, cc, bcc. Handle… |
+| `delete_draft` | write | `email` | Permanently delete a draft by its draft ID. Use list_drafts to find draft IDs. This canno… |
+| `send_draft` | write | `email` | Send an existing draft by draft ID, or send a one-off draft payload (provide raw instead … |
+| `list_labels` | read | `organize` | List all labels in the user's mailbox, including system labels (INBOX, SENT, DRAFT, SPAM,… |
+| `get_label` | read | `organize` | Get details for a specific label by its label ID. Returns name, type, visibility settings… |
+| `modify_message` | write | `organize` | Add or remove labels on a single message. Provide addLabelIds, removeLabelIds, or both. C… |
+| `trash_message` | write | `organize` | Move a message to the Trash. The message is not permanently deleted and can be restored w… |
+| `untrash_message` | write | `organize` | Restore a message from Trash back to the Inbox. Use list_messages with labelIds=['TRASH']… |
+| `delete_message` | write | `organize` | Permanently and immediately delete a message by ID. This cannot be undone. For recoverabl… |
+| `modify_thread` | write | `organize` | Add or remove labels on all messages in a thread at once. Provide addLabelIds, removeLabe… |
+| `trash_thread` | write | `organize` | Move an entire thread to Trash. All messages in the thread are trashed. Can be reversed w… |
+| `untrash_thread` | write | `organize` | Restore an entire thread from Trash. Use list_threads with labelIds=['TRASH'] to find tra… |
+| `delete_thread` | write | `organize` | Permanently and immediately delete an entire thread and all its messages. This cannot be … |
+| `create_label` | admin | `organize` | Create a new mailbox label with optional visibility and color settings. Label names must … |
+| `update_label` | admin | `organize` | Update (patch) an existing mailbox label's name, color, or visibility settings by label I… |
+| `delete_label` | admin | `organize` | Permanently delete a mailbox label by label ID. Messages with this label will have it rem… |

package/integrations/google-gmail/handlers/create_draft_email.js

@@ -15,7 +15,7 @@ async (input) => {
     lines.push('Content-Type: text/plain; charset=UTF-8')
     lines.push('', input.body || '')
   }
-  const raw = Buffer.from(lines.join('\r\n')).toString('base64url')
+  const raw = btoa(unescape(encodeURIComponent(lines.join('\r\n')))).replace(/\+/g, '-').replace(/\//g, '_').replace(/=/g, '')
   const message = { raw }
   if (input.threadId) message.threadId = input.threadId
 

package/integrations/google-gmail/handlers/read_email.js

@@ -12,7 +12,7 @@ async (input) => {
   const decodeBase64url = (data) => {
     if (!data) return ''
     try {
-      return Buffer.from(data.replace(/-/g, '+').replace(/_/g, '/'), 'base64').toString('utf-8')
+      return decodeURIComponent(escape(atob(data.replace(/-/g, '+').replace(/_/g, '/'))))
     }
     catch {
       return ''

package/integrations/google-gmail/handlers/send_email.js

@@ -14,7 +14,7 @@ async (input) => {
     lines.push('', input.body)
   }
   const mime = lines.join('\r\n')
-  const raw = Buffer.from(mime).toString('base64url')
+  const raw = btoa(unescape(encodeURIComponent(mime))).replace(/\+/g, '-').replace(/\//g, '_').replace(/=/g, '')
   const body = { raw }
   if (input.threadId) body.threadId = input.threadId
   const res = await integration.fetch(`/users/${userId}/messages/send`, { method: 'POST', body })

package/integrations/google-gmail/manifest.json

@@ -1,33 +1,44 @@
 {
   "name": "google-gmail",
   "version": "0.1.0",
+  "toolsets": {
+    "email": {
+      "label": "Email",
+      "description": "Search, read, compose, and send emails and drafts"
+    },
+    "organize": {
+      "label": "Organize",
+      "description": "Label, archive, trash, and delete messages and threads"
+    }
+  },
   "tools": [
-    { "name": "get_profile", "description": "Get mailbox profile details for the authenticated user, including email address, messages total, threads total, and history ID. Useful for confirming the active account.", "inputSchema": "schemas/get_profile.json", "handler": "handlers/get_profile.js", "scope": "read" },
-    { "name": "list_labels", "description": "List all labels in the user's mailbox, including system labels (INBOX, SENT, DRAFT, SPAM, TRASH, STARRED, IMPORTANT, UNREAD) and user-created labels. Returns label IDs needed for filtering in list_messages and list_threads.", "inputSchema": "schemas/list_labels.json", "handler": "handlers/list_labels.js", "scope": "read" },
-    { "name": "get_label", "description": "Get details for a specific label by its label ID. Returns name, type, visibility settings, and message/thread counts. Use list_labels first to find the label ID.", "inputSchema": "schemas/id_label.json", "handler": "handlers/get_label.js", "scope": "read" },
-    { "name": "list_messages", "description": "List message IDs matching a Gmail search query or label filters. Returns only IDs and threadIds, not full content -- use read_email or get_message to fetch content for specific messages. Supports Gmail query operators: 'is:unread', 'from:user@example.com', 'to:user@example.com', 'subject:keyword', 'has:attachment', 'after:2024/01/01', 'before:2024/12/31', 'newer_than:7d', 'label:INBOX', 'in:sent'. Defaults to 20 results. Use pageToken from the response for the next page.", "inputSchema": "schemas/list_messages.json", "handler": "handlers/list_messages.js", "scope": "read" },
-    { "name": "read_email", "description": "Read an email by message ID and return a flat, decoded result with subject, from, to, cc, date, snippet, body text, labelIds, and threadId. Use this for reading email content -- it handles base64 decoding and header extraction automatically. For raw API access or advanced format options, use get_message instead.", "inputSchema": "schemas/read_email.json", "handler": "handlers/read_email.js", "scope": "read" },
-    { "name": "get_message", "description": "Get the raw Gmail message resource by message ID. Returns the full nested payload including base64url-encoded body parts and all headers. For most use cases, prefer read_email which decodes the response into a flat readable format. Use format='minimal' for lightweight ID+threadId+labelIds only, format='metadata' with metadataHeaders for specific headers only.", "inputSchema": "schemas/get_message.json", "handler": "handlers/get_message.js", "scope": "read" },
-    { "name": "list_threads", "description": "List thread IDs matching a Gmail search query or label filters. Similar to list_messages but grouped by conversation thread. Returns only IDs -- use get_thread to fetch full thread content. Supports the same Gmail query operators as list_messages. Defaults to 20 results. Use pageToken from the response for the next page.", "inputSchema": "schemas/list_threads.json", "handler": "handlers/list_threads.js", "scope": "read" },
-    { "name": "get_thread", "description": "Get a full thread resource by thread ID, including all messages in the conversation. Use list_threads to find thread IDs. Use format='minimal' to get only message IDs within the thread without full content.", "inputSchema": "schemas/get_thread.json", "handler": "handlers/get_thread.js", "scope": "read" },
-    { "name": "list_drafts", "description": "List drafts in the mailbox. Returns draft IDs and the nested message ID. Use get_draft to fetch full draft content. Defaults to 20 results. Use pageToken for the next page.", "inputSchema": "schemas/list_drafts.json", "handler": "handlers/list_drafts.js", "scope": "read" },
-    { "name": "get_draft", "description": "Get a draft by draft ID. Returns the draft object including the nested message resource. Use list_drafts to find draft IDs.", "inputSchema": "schemas/id_draft.json", "handler": "handlers/get_draft.js", "scope": "read" },
+    { "name": "get_profile", "description": "Get mailbox profile details for the authenticated user, including email address, messages total, threads total, and history ID. Useful for confirming the active account.", "inputSchema": "schemas/get_profile.json", "handler": "handlers/get_profile.js", "scope": "read", "toolset": "email" },
+    { "name": "list_messages", "description": "List message IDs matching a Gmail search query or label filters. Returns only IDs and threadIds, not full content -- use read_email or get_message to fetch content for specific messages. Supports Gmail query operators: 'is:unread', 'from:user@example.com', 'to:user@example.com', 'subject:keyword', 'has:attachment', 'after:2024/01/01', 'before:2024/12/31', 'newer_than:7d', 'label:INBOX', 'in:sent'. Defaults to 20 results. Use pageToken from the response for the next page.", "inputSchema": "schemas/list_messages.json", "handler": "handlers/list_messages.js", "scope": "read", "toolset": "email" },
+    { "name": "read_email", "description": "Read an email by message ID and return a flat, decoded result with subject, from, to, cc, date, snippet, body text, labelIds, and threadId. Use this for reading email content -- it handles base64 decoding and header extraction automatically. For raw API access or advanced format options, use get_message instead.", "inputSchema": "schemas/read_email.json", "handler": "handlers/read_email.js", "scope": "read", "toolset": "email" },
+    { "name": "get_message", "description": "Get the raw Gmail message resource by message ID. Returns the full nested payload including base64url-encoded body parts and all headers. For most use cases, prefer read_email which decodes the response into a flat readable format. Use format='minimal' for lightweight ID+threadId+labelIds only, format='metadata' with metadataHeaders for specific headers only.", "inputSchema": "schemas/get_message.json", "handler": "handlers/get_message.js", "scope": "read", "toolset": "email" },
+    { "name": "list_threads", "description": "List thread IDs matching a Gmail search query or label filters. Similar to list_messages but grouped by conversation thread. Returns only IDs -- use get_thread to fetch full thread content. Supports the same Gmail query operators as list_messages. Defaults to 20 results. Use pageToken from the response for the next page.", "inputSchema": "schemas/list_threads.json", "handler": "handlers/list_threads.js", "scope": "read", "toolset": "email" },
+    { "name": "get_thread", "description": "Get a full thread resource by thread ID, including all messages in the conversation. Use list_threads to find thread IDs. Use format='minimal' to get only message IDs within the thread without full content.", "inputSchema": "schemas/get_thread.json", "handler": "handlers/get_thread.js", "scope": "read", "toolset": "email" },
+    { "name": "list_drafts", "description": "List drafts in the mailbox. Returns draft IDs and the nested message ID. Use get_draft to fetch full draft content. Defaults to 20 results. Use pageToken for the next page.", "inputSchema": "schemas/list_drafts.json", "handler": "handlers/list_drafts.js", "scope": "read", "toolset": "email" },
+    { "name": "get_draft", "description": "Get a draft by draft ID. Returns the draft object including the nested message resource. Use list_drafts to find draft IDs.", "inputSchema": "schemas/id_draft.json", "handler": "handlers/get_draft.js", "scope": "read", "toolset": "email" },
 
-    { "name": "send_email", "description": "Send an email by providing flat fields: to, subject, and body. Handles MIME encoding and base64url conversion internally. For replies, provide replyToMessageId (the original message's ID) and threadId to keep the reply in the same conversation thread. Supports plain text and HTML bodies, CC, and BCC.", "inputSchema": "schemas/send_email.json", "handler": "handlers/send_email.js", "scope": "write" },
-    { "name": "create_draft_email", "description": "Create a draft email using flat fields: subject, body, and optionally to, cc, bcc. Handles MIME encoding internally. The draft is saved but not sent -- use send_draft to send it later. For replies, provide replyToMessageId and threadId. Supports plain text and HTML bodies.", "inputSchema": "schemas/create_draft_email.json", "handler": "handlers/create_draft_email.js", "scope": "write" },
-    { "name": "delete_draft", "description": "Permanently delete a draft by its draft ID. Use list_drafts to find draft IDs. This cannot be undone.", "inputSchema": "schemas/id_draft.json", "handler": "handlers/delete_draft.js", "scope": "write" },
-    { "name": "send_draft", "description": "Send an existing draft by draft ID, or send a one-off draft payload (provide raw instead of draftId). One of draftId or raw must be provided. To send a previously created draft, provide only draftId. To send a new message without saving first, use send_email instead.", "inputSchema": "schemas/send_draft.json", "handler": "handlers/send_draft.js", "scope": "write" },
-    { "name": "modify_message", "description": "Add or remove labels on a single message. Provide addLabelIds, removeLabelIds, or both. Common label IDs: 'INBOX', 'UNREAD', 'STARRED', 'IMPORTANT', 'TRASH', 'SPAM'. To archive a message, remove 'INBOX'. To mark as read, remove 'UNREAD'. Use list_labels to find custom label IDs.", "inputSchema": "schemas/modify_message.json", "handler": "handlers/modify_message.js", "scope": "write" },
-    { "name": "trash_message", "description": "Move a message to the Trash. The message is not permanently deleted and can be restored with untrash_message. To permanently delete, use delete_message.", "inputSchema": "schemas/id_message.json", "handler": "handlers/trash_message.js", "scope": "write" },
-    { "name": "untrash_message", "description": "Restore a message from Trash back to the Inbox. Use list_messages with labelIds=['TRASH'] to find trashed message IDs.", "inputSchema": "schemas/id_message.json", "handler": "handlers/untrash_message.js", "scope": "write" },
-    { "name": "delete_message", "description": "Permanently and immediately delete a message by ID. This cannot be undone. For recoverable deletion, use trash_message instead.", "inputSchema": "schemas/id_message.json", "handler": "handlers/delete_message.js", "scope": "write" },
-    { "name": "modify_thread", "description": "Add or remove labels on all messages in a thread at once. Provide addLabelIds, removeLabelIds, or both. Common label IDs: 'INBOX', 'UNREAD', 'STARRED', 'IMPORTANT'. To archive a thread, remove 'INBOX'. Use list_labels to find custom label IDs.", "inputSchema": "schemas/modify_thread.json", "handler": "handlers/modify_thread.js", "scope": "write" },
-    { "name": "trash_thread", "description": "Move an entire thread to Trash. All messages in the thread are trashed. Can be reversed with untrash_thread.", "inputSchema": "schemas/id_thread.json", "handler": "handlers/trash_thread.js", "scope": "write" },
-    { "name": "untrash_thread", "description": "Restore an entire thread from Trash. Use list_threads with labelIds=['TRASH'] to find trashed thread IDs.", "inputSchema": "schemas/id_thread.json", "handler": "handlers/untrash_thread.js", "scope": "write" },
-    { "name": "delete_thread", "description": "Permanently and immediately delete an entire thread and all its messages. This cannot be undone. For recoverable deletion, use trash_thread instead.", "inputSchema": "schemas/id_thread.json", "handler": "handlers/delete_thread.js", "scope": "write" },
+    { "name": "send_email", "description": "Send an email by providing flat fields: to, subject, and body. Handles MIME encoding and base64url conversion internally. For replies, provide replyToMessageId (the original message's ID) and threadId to keep the reply in the same conversation thread. Supports plain text and HTML bodies, CC, and BCC.", "inputSchema": "schemas/send_email.json", "handler": "handlers/send_email.js", "scope": "write", "toolset": "email" },
+    { "name": "create_draft_email", "description": "Create a draft email using flat fields: subject, body, and optionally to, cc, bcc. Handles MIME encoding internally. The draft is saved but not sent -- use send_draft to send it later. For replies, provide replyToMessageId and threadId. Supports plain text and HTML bodies.", "inputSchema": "schemas/create_draft_email.json", "handler": "handlers/create_draft_email.js", "scope": "write", "toolset": "email" },
+    { "name": "delete_draft", "description": "Permanently delete a draft by its draft ID. Use list_drafts to find draft IDs. This cannot be undone.", "inputSchema": "schemas/id_draft.json", "handler": "handlers/delete_draft.js", "scope": "write", "toolset": "email" },
+    { "name": "send_draft", "description": "Send an existing draft by draft ID, or send a one-off draft payload (provide raw instead of draftId). One of draftId or raw must be provided. To send a previously created draft, provide only draftId. To send a new message without saving first, use send_email instead.", "inputSchema": "schemas/send_draft.json", "handler": "handlers/send_draft.js", "scope": "write", "toolset": "email" },
 
-    { "name": "create_label", "description": "Create a new mailbox label with optional visibility and color settings. Label names must be unique. After creating a label, use its returned ID with modify_message or modify_thread to apply it.", "inputSchema": "schemas/create_label.json", "handler": "handlers/create_label.js", "scope": "admin" },
-    { "name": "update_label", "description": "Update (patch) an existing mailbox label's name, color, or visibility settings by label ID. Use list_labels to find label IDs.", "inputSchema": "schemas/update_label.json", "handler": "handlers/update_label.js", "scope": "admin" },
-    { "name": "delete_label", "description": "Permanently delete a mailbox label by label ID. Messages with this label will have it removed but will not be deleted. Use list_labels to find label IDs. System labels (INBOX, SENT, etc.) cannot be deleted.", "inputSchema": "schemas/id_label.json", "handler": "handlers/delete_label.js", "scope": "admin" }
+    { "name": "list_labels", "description": "List all labels in the user's mailbox, including system labels (INBOX, SENT, DRAFT, SPAM, TRASH, STARRED, IMPORTANT, UNREAD) and user-created labels. Returns label IDs needed for filtering in list_messages and list_threads.", "inputSchema": "schemas/list_labels.json", "handler": "handlers/list_labels.js", "scope": "read", "toolset": "organize" },
+    { "name": "get_label", "description": "Get details for a specific label by its label ID. Returns name, type, visibility settings, and message/thread counts. Use list_labels first to find the label ID.", "inputSchema": "schemas/id_label.json", "handler": "handlers/get_label.js", "scope": "read", "toolset": "organize" },
+    { "name": "modify_message", "description": "Add or remove labels on a single message. Provide addLabelIds, removeLabelIds, or both. Common label IDs: 'INBOX', 'UNREAD', 'STARRED', 'IMPORTANT', 'TRASH', 'SPAM'. To archive a message, remove 'INBOX'. To mark as read, remove 'UNREAD'. Use list_labels to find custom label IDs.", "inputSchema": "schemas/modify_message.json", "handler": "handlers/modify_message.js", "scope": "write", "toolset": "organize" },
+    { "name": "trash_message", "description": "Move a message to the Trash. The message is not permanently deleted and can be restored with untrash_message. To permanently delete, use delete_message.", "inputSchema": "schemas/id_message.json", "handler": "handlers/trash_message.js", "scope": "write", "toolset": "organize" },
+    { "name": "untrash_message", "description": "Restore a message from Trash back to the Inbox. Use list_messages with labelIds=['TRASH'] to find trashed message IDs.", "inputSchema": "schemas/id_message.json", "handler": "handlers/untrash_message.js", "scope": "write", "toolset": "organize" },
+    { "name": "delete_message", "description": "Permanently and immediately delete a message by ID. This cannot be undone. For recoverable deletion, use trash_message instead.", "inputSchema": "schemas/id_message.json", "handler": "handlers/delete_message.js", "scope": "write", "toolset": "organize" },
+    { "name": "modify_thread", "description": "Add or remove labels on all messages in a thread at once. Provide addLabelIds, removeLabelIds, or both. Common label IDs: 'INBOX', 'UNREAD', 'STARRED', 'IMPORTANT'. To archive a thread, remove 'INBOX'. Use list_labels to find custom label IDs.", "inputSchema": "schemas/modify_thread.json", "handler": "handlers/modify_thread.js", "scope": "write", "toolset": "organize" },
+    { "name": "trash_thread", "description": "Move an entire thread to Trash. All messages in the thread are trashed. Can be reversed with untrash_thread.", "inputSchema": "schemas/id_thread.json", "handler": "handlers/trash_thread.js", "scope": "write", "toolset": "organize" },
+    { "name": "untrash_thread", "description": "Restore an entire thread from Trash. Use list_threads with labelIds=['TRASH'] to find trashed thread IDs.", "inputSchema": "schemas/id_thread.json", "handler": "handlers/untrash_thread.js", "scope": "write", "toolset": "organize" },
+    { "name": "delete_thread", "description": "Permanently and immediately delete an entire thread and all its messages. This cannot be undone. For recoverable deletion, use trash_thread instead.", "inputSchema": "schemas/id_thread.json", "handler": "handlers/delete_thread.js", "scope": "write", "toolset": "organize" },
+
+    { "name": "create_label", "description": "Create a new mailbox label with optional visibility and color settings. Label names must be unique. After creating a label, use its returned ID with modify_message or modify_thread to apply it.", "inputSchema": "schemas/create_label.json", "handler": "handlers/create_label.js", "scope": "admin", "toolset": "organize" },
+    { "name": "update_label", "description": "Update (patch) an existing mailbox label's name, color, or visibility settings by label ID. Use list_labels to find label IDs.", "inputSchema": "schemas/update_label.json", "handler": "handlers/update_label.js", "scope": "admin", "toolset": "organize" },
+    { "name": "delete_label", "description": "Permanently delete a mailbox label by label ID. Messages with this label will have it removed but will not be deleted. Use list_labels to find label IDs. System labels (INBOX, SENT, etc.) cannot be deleted.", "inputSchema": "schemas/id_label.json", "handler": "handlers/delete_label.js", "scope": "admin", "toolset": "organize" }
   ]
 }

package/integrations/google-sheet/README.md

@@ -0,0 +1,27 @@
+# Google Sheets
+
+**10 tools**
+
+![Google Sheets tests](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/theomccabe/771bd329f303087690c522afa1baa6f3/raw/test-google-sheet.json)
+
+## Credential variants
+
+| Variant | Label |
+|---|---|
+| `service_account` | Service Account (recommended) _(default)_ |
+| `oauth_token` | OAuth Access Token (short-lived) |
+
+## Tools
+
+| Tool | Scope | Description |
+|---|---|---|
+| `get_spreadsheet` | read | Retrieve spreadsheet metadata including all sheet names, IDs, and properties. Set include… |
+| `read_sheet` | read | Read cell values from a sheet range and return as a Markdown table with A1 column headers… |
+| `create_spreadsheet` | write | Create a new Google Spreadsheet. Accepts a full spreadsheet resource body, allowing you t… |
+| `update_values` | write | Write values to a specific A1 range, replacing existing content. Use valueInputOption='US… |
+| `append_values` | write | Append rows of values after the last row of existing data in a range. Useful for adding n… |
+| `batch_update_values` | write | Write values to multiple A1 ranges in a single API call. More efficient than calling upda… |
+| `clear_values` | write | Clear all values (but not formatting) in the specified A1 range. The cells remain but the… |
+| `batch_clear_values` | write | Clear values from multiple A1 ranges in a single API call. More efficient than calling cl… |
+| `batch_update` | write | Send a spreadsheets.batchUpdate request for structural changes such as addSheet, deleteSh… |
+| `copy_to_spreadsheet` | write | Copy a specific sheet (tab) from one spreadsheet to another. Provide the source spreadshe… |

package/integrations/google-slides/README.md

@@ -0,0 +1,28 @@
+# Google Slides
+
+**11 tools**
+
+![Google Slides tests](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/theomccabe/771bd329f303087690c522afa1baa6f3/raw/test-google-slides.json)
+
+## Credential variants
+
+| Variant | Label |
+|---|---|
+| `service_account` | Service Account (recommended) _(default)_ |
+| `oauth_token` | OAuth Access Token (short-lived) |
+
+## Tools
+
+| Tool | Scope | Description |
+|---|---|---|
+| `read_presentation` | read | Read a Google Slides presentation and return a human-readable summary including the title… |
+| `get_page_thumbnail` | read | Generate a thumbnail image URL for a specific slide (page) in a presentation. Requires th… |
+| `create_presentation` | write | Create a new empty Google Slides presentation with an optional title. Returns the created… |
+| `batch_update` | write | Send a presentations.batchUpdate request for low-level slide modifications. Accepts an ar… |
+| `append_text_to_title_of_slide_index` | write | Append text to the title shape of a specific slide by its 0-based index (slideIndex=0 is … |
+| `replace_text_first_match` | write | Replace the first occurrence of text anywhere in the presentation with new text. Note: th… |
+| `style_text_first_match` | write | Find the first occurrence of text in the presentation and apply a text style to it (bold,… |
+| `insert_shape_after_first_match` | write | Find the first slide containing a text match and insert a rectangle shape on that slide a… |
+| `insert_image_after_first_match` | write | Find the first slide containing a text match and insert an image on that slide from a URL… |
+| `create_slide_after_first_match` | write | Find the first slide containing a text match and create a new blank slide immediately aft… |
+| `set_background_color_for_slide_index` | write | Set the background color for a specific slide by its 0-based index (slideIndex=0 is the f… |

package/integrations/hubspot/.env.test.example

@@ -0,0 +1,20 @@
+# HubSpot live integration tests
+#
+# HUBSPOT_TOKEN is a private app access token.
+# Create one at: https://developers.hubspot.com/docs/api/private-apps
+# Required scopes: crm.objects.contacts.read/write, crm.objects.companies.read/write,
+#                  crm.objects.deals.read/write, tickets (read/write), notes (read/write)
+HUBSPOT_TOKEN=
+#
+# Optional: seed IDs for read tests (the suite will discover them automatically if omitted)
+HUBSPOT_TEST_CONTACT_ID=
+HUBSPOT_TEST_COMPANY_ID=
+HUBSPOT_TEST_DEAL_ID=
+HUBSPOT_TEST_TICKET_ID=
+#
+# Optional: pipeline/stage IDs for write tests
+# Find these in HubSpot: Settings → CRM → Deals/Tickets → Pipelines
+HUBSPOT_TEST_DEAL_PIPELINE_ID=
+HUBSPOT_TEST_DEAL_STAGE_ID=
+HUBSPOT_TEST_TICKET_PIPELINE_ID=
+HUBSPOT_TEST_TICKET_STAGE_ID=

package/integrations/hubspot/README.md

@@ -0,0 +1,48 @@
+# HubSpot
+
+**31 tools**
+
+![HubSpot tests](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/theomccabe/771bd329f303087690c522afa1baa6f3/raw/test-hubspot.json)
+
+## Credential variants
+
+| Variant | Label |
+|---|---|
+| `private_app_token` | Private App Token _(default)_ |
+| `oauth_token` | OAuth Access Token |
+
+## Tools
+
+| Tool | Scope | Description |
+|---|---|---|
+| `search_contacts` | read | Search for contacts. Use query for simple free-text search, and filters for precise prope… |
+| `get_contact` | read | Get a contact by ID. Use properties to request specific fields, and associations to inclu… |
+| `create_contact` | write | Create a contact. Provide common fields (firstname/lastname/email) and/or a properties ma… |
+| `update_contact` | write | Update a contact by ID. Provide any fields to update as common fields and/or in the prope… |
+| `archive_contact` | write | Archive (delete) a contact by ID. This moves the record to the recycle bin. |
+| `search_companies` | read | Search for companies. Use query for free-text search and filters for property-based filte… |
+| `get_company` | read | Get a company by ID. Use properties to request specific fields, and associations to inclu… |
+| `create_company` | write | Create a company. Provide name/domain and/or a properties map for other HubSpot company p… |
+| `update_company` | write | Update a company by ID. Provide any fields to update as common fields and/or in the prope… |
+| `archive_company` | write | Archive (delete) a company by ID. This moves the record to the recycle bin. |
+| `list_owners` | read | List CRM owners (users) available in the HubSpot account. Useful for assigning owners to … |
+| `list_properties` | read | List properties for an object type (e.g. contacts, companies, deals, tickets). Use this t… |
+| `list_pipelines` | read | List pipelines and stages for an object type (commonly deals or tickets). Use this to fin… |
+| `get_associations` | read | Get associations from a CRM record to another object type. Returns the associated record … |
+| `create_association` | write | Create a default (unlabeled) association between two CRM records. Example: associate a co… |
+| `remove_association` | write | Remove an association between two CRM records. This uses HubSpot's association batch arch… |
+| `search_deals` | read | Search for deals. Use query for free-text search and filters for property-based filtering… |
+| `get_deal` | read | Get a deal by ID. Use properties to request specific fields, and associations to include … |
+| `create_deal` | write | Create a deal. Provide dealname/amount/pipeline/dealstage and/or a properties map for oth… |
+| `update_deal` | write | Update a deal by ID. Common updates include moving stages via dealstage. Fields not provi… |
+| `archive_deal` | write | Archive (delete) a deal by ID. This moves the record to the recycle bin. |
+| `search_tickets` | read | Search for tickets. Use query for free-text search and filters for property-based filteri… |
+| `get_ticket` | read | Get a ticket by ID. Use properties to request specific fields, and associations to includ… |
+| `create_ticket` | write | Create a ticket. Provide subject/content/pipeline/stage and/or a properties map for other… |
+| `update_ticket` | write | Update a ticket by ID. Common updates include changing hs_pipeline_stage. Fields not prov… |
+| `archive_ticket` | write | Archive (delete) a ticket by ID. This moves the record to the recycle bin. |
+| `search_notes` | read | Search notes. Use query for free-text search and filters for precise property-based filte… |
+| `create_note` | write | Create a note and (optionally) associate it to one or more CRM records (contacts, compani… |
+| `search_tasks` | read | Search tasks. Use query for free-text search and filters for precise property-based filte… |
+| `create_task` | write | Create a task and (optionally) associate it to one or more CRM records. Provide subject/b… |
+| `update_task` | write | Update a task by ID. Common updates include setting hs_task_status to COMPLETED. |

package/integrations/hubspot/__tests__/get_handlers.test.ts

@@ -0,0 +1,151 @@
+import { beforeAll, describe, expect, it } from 'vitest'
+import {
+  createCredentialStore,
+  createIntegrationNode,
+  createProxy,
+  createToolbox,
+  hasEnv,
+} from '../../__tests__/liveHarness.js'
+
+// LIVE HubSpot read tests using credentials
+// Required env vars:
+// - HUBSPOT_TOKEN
+//
+// Optional env vars:
+// - HUBSPOT_TEST_CONTACT_ID
+// - HUBSPOT_TEST_COMPANY_ID
+// - HUBSPOT_TEST_DEAL_ID
+// - HUBSPOT_TEST_TICKET_ID
+
+const env = process.env as Record<string, string | undefined>
+const suite = hasEnv('HUBSPOT_TOKEN') ? describe : describe.skip
+
+suite('hubspot read handlers (live)', () => {
+  const ctx: {
+    contactId?: string
+    companyId?: string
+    dealId?: string
+    ticketId?: string
+  } = {}
+
+  let read: Record<string, (input: any) => Promise<any>>
+
+  beforeAll(async () => {
+    ctx.contactId = env.HUBSPOT_TEST_CONTACT_ID
+    ctx.companyId = env.HUBSPOT_TEST_COMPANY_ID
+    ctx.dealId = env.HUBSPOT_TEST_DEAL_ID
+    ctx.ticketId = env.HUBSPOT_TEST_TICKET_ID
+
+    const credentialStore = createCredentialStore(async () => ({ token: env.HUBSPOT_TOKEN || '' }))
+    const proxy = createProxy(credentialStore)
+    const node = createIntegrationNode('hubspot')
+    const toolbox = createToolbox('hubspot', proxy, node)
+
+    // IMPORTANT: These literal tool-name strings are intentionally present so usage-parity can verify coverage.
+    read = {
+      search_contacts: toolbox.read('search_contacts'),
+      get_contact: toolbox.read('get_contact'),
+      search_companies: toolbox.read('search_companies'),
+      get_company: toolbox.read('get_company'),
+      list_owners: toolbox.read('list_owners'),
+      list_properties: toolbox.read('list_properties'),
+      list_pipelines: toolbox.read('list_pipelines'),
+      get_associations: toolbox.read('get_associations'),
+      search_deals: toolbox.read('search_deals'),
+      get_deal: toolbox.read('get_deal'),
+      search_tickets: toolbox.read('search_tickets'),
+      get_ticket: toolbox.read('get_ticket'),
+      search_notes: toolbox.read('search_notes'),
+      search_tasks: toolbox.read('search_tasks'),
+      // read tools in the manifest are limited to those above; remaining tools are write-scoped
+    }
+
+    expect(read).toBeTruthy()
+  }, 60000)
+
+  it('search_contacts returns results (or empty)', async () => {
+    const result = await read.search_contacts({ limit: 1 })
+    expect(result).toBeTruthy()
+  }, 30000)
+
+  it('search_companies returns results (or empty)', async () => {
+    const result = await read.search_companies({ limit: 1 })
+    expect(result).toBeTruthy()
+  }, 30000)
+
+  it('list_owners returns owners', async () => {
+    const result = await read.list_owners({ limit: 1 })
+    expect(result).toBeTruthy()
+  }, 30000)
+
+  it('list_properties(contacts) returns properties', async () => {
+    const result = await read.list_properties({ objectType: 'contacts' })
+    expect(result).toBeTruthy()
+  }, 30000)
+
+  it('list_pipelines(deals) returns pipelines', async () => {
+    const result = await read.list_pipelines({ objectType: 'deals' })
+    expect(result).toBeTruthy()
+  }, 30000)
+
+  it('get_contact returns a contact when HUBSPOT_TEST_CONTACT_ID is set', async () => {
+    if (!ctx.contactId)
+      return expect(true).toBe(true)
+    const result = await read.get_contact({ id: ctx.contactId })
+    expect(result?.id).toBeTruthy()
+  }, 30000)
+
+  it('get_company returns a company when HUBSPOT_TEST_COMPANY_ID is set', async () => {
+    if (!ctx.companyId)
+      return expect(true).toBe(true)
+    const result = await read.get_company({ id: ctx.companyId })
+    expect(result?.id).toBeTruthy()
+  }, 30000)
+
+  it('get_deal returns a deal when HUBSPOT_TEST_DEAL_ID is set', async () => {
+    if (!ctx.dealId)
+      return expect(true).toBe(true)
+    const result = await read.get_deal({ id: ctx.dealId })
+    expect(result?.id).toBeTruthy()
+  }, 30000)
+
+  it('get_ticket returns a ticket when HUBSPOT_TEST_TICKET_ID is set', async () => {
+    if (!ctx.ticketId)
+      return expect(true).toBe(true)
+    const result = await read.get_ticket({ id: ctx.ticketId })
+    expect(result?.id).toBeTruthy()
+  }, 30000)
+
+  it('search_deals returns results (or empty)', async () => {
+    const result = await read.search_deals({ limit: 1 })
+    expect(result).toBeTruthy()
+  }, 30000)
+
+  it('search_tickets returns results (or empty)', async () => {
+    const result = await read.search_tickets({ limit: 1 })
+    expect(result).toBeTruthy()
+  }, 30000)
+
+  it('search_notes returns results (or empty)', async () => {
+    const result = await read.search_notes({ limit: 1 })
+    expect(result).toBeTruthy()
+  }, 30000)
+
+  it('search_tasks returns results (or empty)', async () => {
+    const result = await read.search_tasks({ limit: 1 })
+    expect(result).toBeTruthy()
+  }, 30000)
+
+  it('get_associations returns associations when HUBSPOT_TEST_CONTACT_ID is set', async () => {
+    if (!ctx.contactId)
+      return expect(true).toBe(true)
+    const result = await read.get_associations({
+      fromObjectType: 'contacts',
+      fromObjectId: ctx.contactId,
+      toObjectType: 'companies',
+      limit: 1,
+    })
+    expect(result).toBeTruthy()
+  }, 30000)
+})
+

package/integrations/hubspot/__tests__/usage_parity.test.ts

@@ -0,0 +1,10 @@
+import { describe, expect, it } from 'vitest'
+import { getMissingToolUsages } from '../../__tests__/usageParity.js'
+
+describe('hubspot static usage parity', () => {
+  it('every manifest tool is referenced in tests', () => {
+    const missing = getMissingToolUsages({ integrationName: 'hubspot', importMetaUrl: import.meta.url })
+    expect(missing, `Missing handler usages in tests: ${missing.join(', ')}`).toEqual([])
+  })
+})
+