@commandable/integration-data 0.4.0 → 0.4.1

package/integrations/google-slides/handlers/read_presentation.js

@@ -0,0 +1,51 @@
+async (input) => {
+  const extractSlideText = (slide) => {
+    const lines = []
+    for (const element of slide?.pageElements || []) {
+      const textElements = element?.shape?.text?.textElements || []
+      let combined = ''
+      for (const t of textElements) {
+        combined += t?.textRun?.content || ''
+      }
+      const trimmed = combined
+        .split('\n')
+        .map((line) => line.trim())
+        .filter(Boolean)
+      lines.push(...trimmed)
+    }
+    return lines
+  }
+
+  const { presentationId } = input
+  const path = `/presentations/${encodeURIComponent(presentationId)}`
+  const res = await integration.fetch(path)
+  const presentation = await res.json()
+
+  const title = presentation?.title || 'Untitled presentation'
+  const deckId = presentation?.presentationId || presentationId
+  const slides = presentation?.slides || []
+
+  const lines = [
+    `Presentation: "${title}" (ID: ${deckId})`,
+    `URL: https://docs.google.com/presentation/d/${deckId}/edit`,
+    `Total Slides: ${slides.length}`,
+    '',
+  ]
+
+  for (let i = 0; i < slides.length; i += 1) {
+    const slide = slides[i]
+    const slideId = slide?.objectId || `slide_${i + 1}`
+    const elementCount = (slide?.pageElements || []).length
+    lines.push(`Slide ${i + 1}: ID ${slideId}, ${elementCount} element(s)`)
+
+    const textLines = extractSlideText(slide)
+    if (!textLines.length) {
+      lines.push(' > (No text content)')
+    } else {
+      for (const text of textLines) lines.push(` > ${text}`)
+    }
+    lines.push('')
+  }
+
+  return lines.join('\n').trim()
+}

package/integrations/google-slides/handlers/replace_text_first_match.js

@@ -0,0 +1,9 @@
+async (input) => {
+  const { presentationId, findText, replaceText, matchCase } = input
+  const res = await integration.fetch(`/presentations/${encodeURIComponent(presentationId)}:batchUpdate`, {
+    method: 'POST',
+    body: { requests: [{ replaceAllText: { containsText: { text: findText, matchCase: Boolean(matchCase) }, replaceText } }] },
+  })
+  const out = await res.json()
+  return out?.presentationId ? { ...out, applied: true } : { presentationId, applied: true, replies: out?.replies || [] }
+}

package/integrations/google-slides/handlers/set_background_color_for_slide_index.js

@@ -0,0 +1,15 @@
+async (input) => {
+  const { presentationId, slideIndex, rgbColor } = input
+  const presRes = await integration.fetch(`/presentations/${encodeURIComponent(presentationId)}`)
+  const pres = await presRes.json()
+  const slide = (pres?.slides || [])[slideIndex]
+  if (!slide?.objectId)
+    return { presentationId, applied: false, replies: [] }
+  const color = { color: { rgbColor } }
+  const res = await integration.fetch(`/presentations/${encodeURIComponent(presentationId)}:batchUpdate`, {
+    method: 'POST',
+    body: { requests: [{ updatePageProperties: { objectId: slide.objectId, pageProperties: { pageBackgroundFill: { solidFill: color } }, fields: 'pageBackgroundFill.solidFill.color' } }] },
+  })
+  const out = await res.json()
+  return out?.presentationId ? { ...out, applied: true } : { presentationId, applied: true, replies: out?.replies || [] }
+}

package/integrations/google-slides/handlers/style_text_first_match.js

@@ -0,0 +1,48 @@
+async (input) => {
+  const { presentationId, findText, textStyle, fields } = input
+  // Replace first match with a marker to derive objectId/range
+  const marker = `__CMD_MARK_${Date.now()}__`
+  const rep = await integration.fetch(`/presentations/${encodeURIComponent(presentationId)}:batchUpdate`, {
+    method: 'POST',
+    body: { requests: [{ replaceAllText: { containsText: { text: findText, matchCase: false }, replaceText: marker } }] },
+  })
+  await rep.json()
+  // Scan pages for marker and apply style to that range on the text element
+  const presRes = await integration.fetch(`/presentations/${encodeURIComponent(presentationId)}`)
+  const pres = await presRes.json()
+  let targetObjectId = null
+  let startIndex = -1
+  let endIndex = -1
+  for (const slide of (pres?.slides || [])) {
+    for (const el of (slide.pageElements || [])) {
+      const text = el.shape?.text
+      if (!text)
+        continue
+      for (const pe of (text.textElements || [])) {
+        const t = pe.textRun?.content
+        if (!t)
+          continue
+        const idx = t.indexOf(marker)
+        if (idx >= 0) {
+          targetObjectId = el.objectId
+          startIndex = (pe.startIndex || 0) + idx
+          endIndex = startIndex + marker.length
+          break
+        }
+      }
+      if (targetObjectId)
+        break
+    }
+    if (targetObjectId)
+      break
+  }
+  if (!targetObjectId)
+    return { presentationId, applied: false, replies: [] }
+  const requests = [
+    { updateTextStyle: { objectId: targetObjectId, style: textStyle, textRange: { type: 'FIXED_RANGE', startIndex, endIndex }, fields: fields || Object.keys(textStyle || {}).join(',') } },
+    { replaceAllText: { containsText: { text: marker, matchCase: true }, replaceText: findText } },
+  ]
+  const res = await integration.fetch(`/presentations/${encodeURIComponent(presentationId)}:batchUpdate`, { method: 'POST', body: { requests } })
+  const out = await res.json()
+  return out?.presentationId ? { ...out, applied: true } : { presentationId, applied: true, replies: out?.replies || [] }
+}

package/integrations/google-slides/manifest.json

@@ -0,0 +1,42 @@
+{
+  "name": "google-slides",
+  "version": "0.1.0",
+  "baseUrl": "https://slides.googleapis.com/v1",
+  "tools": [
+    {
+      "name": "read_presentation",
+      "description": "Read a Google Slides presentation and return a human-readable summary including the title, slide count, and text content extracted from each slide. Returns the text found in all shapes on each slide with slide IDs for reference. Use this to understand what is in a presentation before editing. For low-level modifications, use batch_update.",
+      "inputSchema": "schemas/get_presentation.json",
+      "handler": "handlers/read_presentation.js",
+      "scope": "read"
+    },
+    {
+      "name": "get_page_thumbnail",
+      "description": "Generate a thumbnail image URL for a specific slide (page) in a presentation. Requires the presentation ID and the slide's objectId (page ID from read_presentation). Returns a contentUrl for the thumbnail image. Useful for previewing slides.",
+      "inputSchema": "schemas/get_page_thumbnail.json",
+      "handler": "handlers/get_page_thumbnail.js",
+      "scope": "read"
+    },
+    {
+      "name": "create_presentation",
+      "description": "Create a new empty Google Slides presentation with an optional title. Returns the created presentation's metadata including its presentationId, which is needed for all subsequent operations.",
+      "inputSchema": "schemas/create_presentation.json",
+      "handler": "handlers/create_presentation.js",
+      "scope": "write"
+    },
+    {
+      "name": "batch_update",
+      "description": "Send a presentations.batchUpdate request for low-level slide modifications. Accepts an array of requests (createSlide, deleteObject, insertText, deleteText, createShape, createTable, replaceAllText, updateTextStyle, updateShapeProperties, etc.). For common text and styling operations, prefer the higher-level tools: replace_text_first_match, style_text_first_match, insert_shape_after_first_match, etc.",
+      "inputSchema": "schemas/batch_update.json",
+      "handler": "handlers/batch_update.js",
+      "scope": "write"
+    },
+    { "name": "append_text_to_title_of_slide_index", "description": "Append text to the title shape of a specific slide by its 0-based index (slideIndex=0 is the first slide, default). Fetches the presentation to find the title shape's objectId then inserts text at the end of its content.", "inputSchema": "schemas/append_text_to_title_of_first_slide.json", "handler": "handlers/append_text_to_title_of_first_slide.js", "scope": "write" },
+    { "name": "replace_text_first_match", "description": "Replace the first occurrence of text anywhere in the presentation with new text. Note: the Slides API replaceAllText always replaces all occurrences; this tool uses replaceAllText internally. For replacing only one instance, use style_text_first_match to locate and style the match, then follow up with batch_update. Returns the API response.", "inputSchema": "schemas/replace_text_first_match.json", "handler": "handlers/replace_text_first_match.js", "scope": "write" },
+    { "name": "style_text_first_match", "description": "Find the first occurrence of text in the presentation and apply a text style to it (bold, italic, fontSize, foregroundColor, etc.). Uses a marker pattern: replaces the text with a unique marker, finds the marker's objectId and range, applies the style, then restores the original text. Returns {applied: true/false}.", "inputSchema": "schemas/style_text_first_match.json", "handler": "handlers/style_text_first_match.js", "scope": "write" },
+    { "name": "insert_shape_after_first_match", "description": "Find the first slide containing a text match and insert a rectangle shape on that slide at the specified position. Positions use EMU units (1 inch = 914400 EMU). Returns {applied: true/false}.", "inputSchema": "schemas/insert_shape_after_first_match.json", "handler": "handlers/insert_shape_after_first_match.js", "scope": "write" },
+    { "name": "insert_image_after_first_match", "description": "Find the first slide containing a text match and insert an image on that slide from a URL. Position and size use EMU units (1 inch = 914400 EMU). Returns {applied: true/false}.", "inputSchema": "schemas/insert_image_after_first_match.json", "handler": "handlers/insert_image_after_first_match.js", "scope": "write" },
+    { "name": "create_slide_after_first_match", "description": "Find the first slide containing a text match and create a new blank slide immediately after it. Useful for inserting slides at a specific position in the deck. Returns {applied: true/false} and the new slide's objectId.", "inputSchema": "schemas/create_slide_after_first_match.json", "handler": "handlers/create_slide_after_first_match.js", "scope": "write" },
+    { "name": "set_background_color_for_slide_index", "description": "Set the background color for a specific slide by its 0-based index (slideIndex=0 is the first slide). Provide r, g, b values in 0.0-1.0 range (e.g. r=1.0, g=0.0, b=0.0 for red). Fetches the presentation first to resolve the slide's objectId from the index.", "inputSchema": "schemas/set_background_color_for_slide_index.json", "handler": "handlers/set_background_color_for_slide_index.js", "scope": "write" }
+  ]
+}

package/integrations/google-slides/prompt.md

@@ -0,0 +1,56 @@
+## Presentation and slide IDs
+
+The presentationId appears in the Google Slides URL:
+`https://docs.google.com/presentation/d/{presentationId}/edit`
+
+Each slide has an `objectId` (a string like `p` or `g12345abcde`). Use `read_presentation` first to discover slide objectIds and extracted text content by slide.
+
+## Slide addressing
+
+The higher-level tools use `slideIndex` (0-based integer):
+- `slideIndex=0` — first slide
+- `slideIndex=1` — second slide
+
+The lower-level `batch_update` requires `objectId` strings. Use `read_presentation` output to map slide order and IDs before editing.
+If you need raw structure details, call `batch_update` only for the operation you are performing.
+
+## First-match tools
+
+The `*_first_match` tools search all slides for text content by JSON-stringifying each slide's content. They use the marker pattern (replace → find → act → restore), making 3 API calls per operation. They return `{applied: true/false}`.
+
+## EMU units
+
+Positions and sizes in the `batch_update` API use EMU (English Metric Units):
+- 1 inch = 914400 EMU
+- 1 cm ≈ 360000 EMU
+- Standard slide dimensions: 9144000 × 5143500 EMU (10 × 5.625 inches, 16:9)
+
+## Common batch_update operations
+
+```json
+{ "requests": [
+  { "createSlide": { "insertionIndex": 1, "slideLayoutReference": { "predefinedLayout": "BLANK" } } },
+  { "insertText": { "objectId": "shapeId", "text": "Hello World", "insertionIndex": 0 } },
+  { "updateTextStyle": {
+      "objectId": "shapeId",
+      "style": { "bold": true, "fontSize": { "magnitude": 24, "unit": "PT" } },
+      "fields": "bold,fontSize",
+      "textRange": { "type": "ALL" }
+  }},
+  { "replaceAllText": {
+      "containsText": { "text": "{{placeholder}}" },
+      "replaceText": "New value"
+  }}
+]}
+```
+
+## Predefined slide layouts
+
+Use with `createSlide`: `BLANK`, `CAPTION_ONLY`, `TITLE`, `TITLE_AND_BODY`, `TITLE_AND_TWO_COLUMNS`, `TITLE_ONLY`, `SECTION_HEADER`, `SECTION_TITLE_AND_DESCRIPTION`, `ONE_COLUMN_TEXT`, `MAIN_POINT`, `BIG_NUMBER`
+
+## Colors
+
+In `batch_update`, colors use RGB values in 0.0–1.0 range:
+```json
+{ "opaqueColor": { "rgbColor": { "red": 1.0, "green": 0.5, "blue": 0.0 } } }
+```

package/integrations/google-slides/schemas/append_text_to_title_of_first_slide.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "presentationId": { "type": "string" },
+    "text": { "type": "string" },
+    "slideIndex": { "type": "number", "minimum": 0, "description": "Zero-based slide index to target (default 0)." }
+  },
+  "required": ["presentationId", "text"],
+  "additionalProperties": false
+}

package/integrations/google-slides/schemas/batch_update.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["presentationId", "requests"],
+  "properties": {
+    "presentationId": { "type": "string", "description": "ID of the presentation." },
+    "requests": { "type": "array", "items": { "type": "object" }, "description": "Array of Slides API requests." },
+    "writeControl": { "type": "object", "description": "Optional write control object." },
+    "includePresentationInResponse": { "type": "boolean" },
+    "responsePageObjectIds": { "type": "array", "items": { "type": "string" } }
+  },
+  "additionalProperties": false
+}

package/integrations/google-slides/schemas/create_presentation.json

@@ -0,0 +1,8 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "title": { "type": "string", "description": "Optional title for the new presentation." }
+  },
+  "additionalProperties": false
+}

package/integrations/google-slides/schemas/create_slide_after_first_match.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "presentationId": { "type": "string" },
+    "findText": { "type": "string" },
+    "layout": { "type": "string", "default": "BLANK" }
+  },
+  "required": ["presentationId", "findText"],
+  "additionalProperties": false
+}

package/integrations/google-slides/schemas/get_page_thumbnail.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["presentationId", "pageObjectId"],
+  "properties": {
+    "presentationId": { "type": "string", "description": "ID of the presentation." },
+    "pageObjectId": { "type": "string", "description": "Object ID of the page (slide)." },
+    "thumbnailProperties.thumbnailSize": { "type": "string", "enum": ["THUMBNAIL_SIZE_UNSPECIFIED", "LARGE", "MEDIUM", "SMALL"], "description": "Requested size hint for the thumbnail." },
+    "thumbnailProperties.mimeType": { "type": "string", "enum": ["PNG", "JPEG"], "description": "Requested image MIME type." }
+  },
+  "additionalProperties": false
+}

package/integrations/google-slides/schemas/get_presentation.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["presentationId"],
+  "properties": {
+    "presentationId": { "type": "string", "description": "ID of the presentation." }
+  },
+  "additionalProperties": false
+}

package/integrations/google-slides/schemas/insert_image_after_first_match.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "presentationId": { "type": "string" },
+    "findText": { "type": "string" },
+    "uri": { "type": "string" },
+    "width": { "type": "number", "default": 2000000 },
+    "height": { "type": "number", "default": 2000000 }
+  },
+  "required": ["presentationId", "findText", "uri"],
+  "additionalProperties": false
+}

package/integrations/google-slides/schemas/insert_shape_after_first_match.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "presentationId": { "type": "string" },
+    "findText": { "type": "string" },
+    "shapeType": { "type": "string", "default": "RECTANGLE" },
+    "width": { "type": "number", "default": 2000000 },
+    "height": { "type": "number", "default": 1000000 }
+  },
+  "required": ["presentationId", "findText"],
+  "additionalProperties": false
+}

package/integrations/google-slides/schemas/replace_text_first_match.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "presentationId": { "type": "string" },
+    "findText": { "type": "string" },
+    "replaceText": { "type": "string" },
+    "matchCase": { "type": "boolean" }
+  },
+  "required": ["presentationId", "findText", "replaceText"],
+  "additionalProperties": false
+}

package/integrations/google-slides/schemas/set_background_color_for_slide_index.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "presentationId": { "type": "string" },
+    "slideIndex": { "type": "number", "minimum": 0 },
+    "rgbColor": { "type": "object", "properties": { "red": { "type": "number" }, "green": { "type": "number" }, "blue": { "type": "number" } }, "required": ["red", "green", "blue"] }
+  },
+  "required": ["presentationId", "slideIndex", "rgbColor"],
+  "additionalProperties": false
+}

package/integrations/google-slides/schemas/style_text_first_match.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "properties": {
+    "presentationId": { "type": "string" },
+    "findText": { "type": "string" },
+    "textStyle": { "type": "object" },
+    "fields": { "type": "string" }
+  },
+  "required": ["presentationId", "findText", "textStyle"],
+  "additionalProperties": false
+}

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([])
+  })
+})
+