@commandable/integration-data 0.0.5 → 0.0.7

package/integrations/google-sheet/manifest.json

@@ -4,119 +4,70 @@
   "tools": [
     {
       "name": "get_spreadsheet",
-      "description": "Retrieve spreadsheet metadata and optionally grid data.",
+      "description": "Retrieve spreadsheet metadata including all sheet names, IDs, and properties. Set includeGridData=false (the default) to get only metadata without cell values. Use read_sheet for cell content. Use the 'fields' parameter to limit the response (e.g. fields='sheets.properties' to get only sheet names and IDs). The spreadsheetId appears in the URL: https://docs.google.com/spreadsheets/d/{spreadsheetId}/.",
       "inputSchema": "schemas/get_spreadsheet.json",
       "handler": "handlers/get_spreadsheet.js",
       "scope": "read"
     },
     {
-      "name": "get_spreadsheet_by_data_filter",
-      "description": "Retrieve spreadsheet metadata using DataFilters.",
-      "inputSchema": "schemas/get_spreadsheet_by_data_filter.json",
-      "handler": "handlers/get_spreadsheet_by_data_filter.js",
-      "scope": "read"
-    },
-    {
-      "name": "get_values",
-      "description": "Get values from a single A1 range.",
-      "inputSchema": "schemas/get_values.json",
-      "handler": "handlers/get_values.js",
-      "scope": "read"
-    },
-    {
-      "name": "batch_get_values",
-      "description": "Batch get values for multiple A1 ranges.",
-      "inputSchema": "schemas/batch_get_values.json",
-      "handler": "handlers/batch_get_values.js",
-      "scope": "read"
-    },
-    {
-      "name": "get_values_by_data_filter",
-      "description": "Batch get values using DataFilters.",
-      "inputSchema": "schemas/get_values_by_data_filter.json",
-      "handler": "handlers/get_values_by_data_filter.js",
-      "scope": "read"
-    },
-    {
-      "name": "search_developer_metadata",
-      "description": "Search developer metadata in a spreadsheet.",
-      "inputSchema": "schemas/search_developer_metadata.json",
-      "handler": "handlers/search_developer_metadata.js",
-      "scope": "read"
-    },
-    {
-      "name": "get_developer_metadata",
-      "description": "Get a developer metadata entry by ID.",
-      "inputSchema": "schemas/get_developer_metadata.json",
-      "handler": "handlers/get_developer_metadata.js",
+      "name": "read_sheet",
+      "description": "Read cell values from a sheet range and return as a Markdown table with A1 column headers and row numbers. Use this to read and understand spreadsheet data -- the coordinates in the output can be used directly with update_values and append_values for writes. Supports optional valueRenderOption for formulas or raw numbers. Use get_spreadsheet first to discover sheet names.",
+      "inputSchema": "schemas/read_sheet.json",
+      "handler": "handlers/read_sheet.js",
       "scope": "read"
     },
     {
       "name": "create_spreadsheet",
-      "description": "Create a new spreadsheet.",
+      "description": "Create a new Google Spreadsheet. Accepts a full spreadsheet resource body, allowing you to specify the title, initial sheets, and cell data. Minimum: provide {title: 'My Spreadsheet'}. Returns the created spreadsheet including its spreadsheetId.",
       "inputSchema": "schemas/create_spreadsheet.json",
       "handler": "handlers/create_spreadsheet.js",
       "scope": "write"
     },
     {
       "name": "update_values",
-      "description": "Update values in a range (PUT).",
+      "description": "Write values to a specific A1 range, replacing existing content. Use valueInputOption='USER_ENTERED' to parse values as the user would type them (supports formulas, dates, currency). Use 'RAW' to store values as literal strings. Provide values as a 2D array (rows of columns).",
       "inputSchema": "schemas/update_values.json",
       "handler": "handlers/update_values.js",
       "scope": "write"
     },
     {
       "name": "append_values",
-      "description": "Append values after the last row of a range.",
+      "description": "Append rows of values after the last row of existing data in a range. Useful for adding new rows to a table without knowing the exact next row number. Uses USER_ENTERED valueInputOption by default. The range determines which sheet to append to.",
       "inputSchema": "schemas/append_values.json",
       "handler": "handlers/append_values.js",
       "scope": "write"
     },
     {
       "name": "batch_update_values",
-      "description": "Batch update values across multiple ranges.",
+      "description": "Write values to multiple A1 ranges in a single API call. More efficient than calling update_values multiple times. Provide a data array where each item has range and values. Use valueInputOption='USER_ENTERED' for formulas and dates.",
       "inputSchema": "schemas/batch_update_values.json",
       "handler": "handlers/batch_update_values.js",
       "scope": "write"
     },
-    {
-      "name": "batch_update_values_by_data_filter",
-      "description": "Batch update values using DataFilters.",
-      "inputSchema": "schemas/batch_update_values_by_data_filter.json",
-      "handler": "handlers/batch_update_values_by_data_filter.js",
-      "scope": "write"
-    },
     {
       "name": "clear_values",
-      "description": "Clear values in the specified range.",
+      "description": "Clear all values (but not formatting) in the specified A1 range. The cells remain but their content is removed. To clear formatting as well, use batch_update with a repeatCell request.",
       "inputSchema": "schemas/clear_values.json",
       "handler": "handlers/clear_values.js",
       "scope": "write"
     },
     {
       "name": "batch_clear_values",
-      "description": "Batch clear values across multiple ranges.",
+      "description": "Clear values from multiple A1 ranges in a single API call. More efficient than calling clear_values multiple times.",
       "inputSchema": "schemas/batch_clear_values.json",
       "handler": "handlers/batch_clear_values.js",
       "scope": "write"
     },
-    {
-      "name": "batch_clear_values_by_data_filter",
-      "description": "Batch clear values using DataFilters.",
-      "inputSchema": "schemas/batch_clear_values_by_data_filter.json",
-      "handler": "handlers/batch_clear_values_by_data_filter.js",
-      "scope": "write"
-    },
     {
       "name": "batch_update",
-      "description": "Send a batchUpdate request (addSheet, deleteSheet, etc).",
+      "description": "Send a spreadsheets.batchUpdate request for structural changes such as addSheet, deleteSheet, duplicateSheet, insertDimension, deleteDimension, mergeCells, sortRange, addConditionalFormatRule, and more. Accepts a requests array. Use update_values or batch_update_values for writing cell data.",
       "inputSchema": "schemas/batch_update.json",
       "handler": "handlers/batch_update.js",
       "scope": "write"
     },
     {
       "name": "copy_to_spreadsheet",
-      "description": "Copy a sheet to another spreadsheet.",
+      "description": "Copy a specific sheet (tab) from one spreadsheet to another. Provide the source spreadsheetId, the sheetId (integer, from get_spreadsheet), and the destination spreadsheetId. Returns the copied sheet's properties in the destination spreadsheet.",
       "inputSchema": "schemas/copy_to_spreadsheet.json",
       "handler": "handlers/copy_to_spreadsheet.js",
       "scope": "write"

package/integrations/google-sheet/prompt.md

@@ -0,0 +1,49 @@
+## A1 notation
+
+Ranges use A1 notation: `SheetName!StartCell:EndCell`
+
+Examples:
+- `Sheet1!A1:D10` — cells A1 to D10 on Sheet1
+- `Sheet1!A:A` — entire column A
+- `Sheet1!1:5` — rows 1 through 5
+- `Sheet1` — entire sheet (all data)
+- `A1:D10` — if the spreadsheet has only one sheet, sheet name can be omitted
+- `'My Sheet'!A1:B5` — sheet names with spaces must be quoted with single quotes
+
+Use `get_spreadsheet` with `fields='sheets.properties'` first to discover all sheet names and their IDs.
+
+## valueInputOption
+
+Controls how input values are interpreted in `update_values`, `append_values`, and `batch_update_values`:
+
+- `USER_ENTERED` *(recommended)* — values are parsed as if a user typed them. Supports formulas (`=SUM(A1:A10)`), dates (`1/15/2024`), currency (`$1,234.56`), and percentages (`50%`)
+- `RAW` — values are stored as literal strings, no parsing. Use when you want exact string storage
+
+## valueRenderOption
+
+Controls how values are returned in `read_sheet`:
+
+- `FORMATTED_VALUE` *(default)* — returns values as displayed in the UI (e.g. `"$1,234.56"`, `"50%"`)
+- `UNFORMATTED_VALUE` — returns raw numbers (e.g. `1234.56`, `0.5`)
+- `FORMULA` — returns formulas as strings (e.g. `"=SUM(A1:A10)"`)
+
+## Recommended workflow
+
+1. Call `get_spreadsheet` with `fields='sheets.properties'` to get sheet names and sheetIds
+2. Use `read_sheet` with an A1 range to read data as markdown plus explicit row/column coordinates
+3. Use the coordinates from `read_sheet` output (e.g. `B3`) with `update_values` or `append_values` for writes
+
+## Structural changes
+
+For adding/removing sheets, inserting/deleting rows or columns, or formatting cells, use `batch_update` with the appropriate request types:
+- `addSheet` — add a new tab
+- `deleteSheet` — remove a tab (requires sheetId, not name)
+- `insertDimension` — insert rows or columns
+- `deleteDimension` — delete rows or columns
+- `repeatCell` — apply formatting to a range
+
+## Large spreadsheets
+
+Avoid calling `get_spreadsheet` with `includeGridData=true` on large spreadsheets -- it can return megabytes of data. Instead:
+- Use `read_sheet` with specific ranges
+- Use `get_spreadsheet` with `fields='sheets.properties'` to get sheet metadata only

package/integrations/google-sheet/schemas/get_spreadsheet.json

@@ -3,13 +3,14 @@
   "type": "object",
   "required": ["spreadsheetId"],
   "properties": {
-    "spreadsheetId": { "type": "string", "description": "ID of the spreadsheet" },
-    "includeGridData": { "type": "boolean", "description": "Whether to include grid data" },
+    "spreadsheetId": { "type": "string", "description": "Spreadsheet ID. Found in the spreadsheet URL: https://docs.google.com/spreadsheets/d/{spreadsheetId}/." },
+    "includeGridData": { "type": "boolean", "description": "Whether to include cell grid data. Defaults to false. Set to true only when you need cell values -- use get_values or batch_get_values for targeted range reads instead." },
     "ranges": {
       "type": "array",
       "items": { "type": "string" },
-      "description": "Optional A1 ranges to include"
-    }
+      "description": "Optional A1 notation ranges to include when includeGridData is true. Example: ['Sheet1!A1:D10', 'Sheet2!A:A']."
+    },
+    "fields": { "type": "string", "description": "Partial response fields selector to reduce response size. Example: 'sheets.properties' to get only sheet names and IDs without cell data. See Sheets API fields reference." }
   },
   "additionalProperties": false
 }

package/integrations/google-sheet/schemas/read_sheet.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "type": "object",
+  "required": ["spreadsheetId"],
+  "properties": {
+    "spreadsheetId": {
+      "type": "string",
+      "description": "Spreadsheet ID from URL: https://docs.google.com/spreadsheets/d/{spreadsheetId}/edit"
+    },
+    "range": {
+      "type": "string",
+      "description": "A1 notation range to read, e.g. 'Sheet1!A1:D20'. Defaults to 'A1:Z1000'."
+    },
+    "valueRenderOption": {
+      "type": "string",
+      "enum": ["FORMATTED_VALUE", "UNFORMATTED_VALUE", "FORMULA"],
+      "description": "How values should be represented in the output."
+    }
+  },
+  "additionalProperties": false
+}

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/google-slides/__tests__/get_handlers.test.ts

@@ -47,25 +47,28 @@ suite('google-slides read handlers (live)', () => {
     await safeCleanup(async () => drive.write('delete_file')({ fileId: folderId }))
   }, 60000)
 
-  it('get_presentation returns metadata', async () => {
+  it('read_presentation returns human-readable content', async () => {
     if (!presentationId)
       return expect(true).toBe(true)
-    const handler = slides.read('get_presentation')
+    const handler = slides.read('read_presentation')
     const result = await handler({ presentationId })
-    expect(result?.presentationId || Array.isArray(result?.slides)).toBeTruthy()
+    expect(typeof result).toBe('string')
+    expect(String(result)).toContain('Presentation:')
   }, 30000)
 
   it('get_page_thumbnail returns URL data', async () => {
     if (!presentationId)
       return expect(true).toBe(true)
-    // First query the presentation to discover a page id
-    const getPresentation = slides.read('get_presentation')
-    const meta = await getPresentation({ presentationId })
-    const firstSlide = meta?.slides?.[0]
-    if (!firstSlide?.objectId)
+    // Query the readable summary and parse "Slide 1: ID <objectId>, ..."
+    const readPresentation = slides.read('read_presentation')
+    const summary = await readPresentation({ presentationId })
+    const text = String(summary || '')
+    const match = text.match(/Slide 1: ID ([^,\n]+)/)
+    const firstSlideObjectId = match?.[1]
+    if (!firstSlideObjectId)
       return expect(true).toBe(true)
     const handler = slides.read('get_page_thumbnail')
-    const result = await handler({ presentationId, 'pageObjectId': firstSlide.objectId, 'thumbnailProperties.thumbnailSize': 'MEDIUM', 'thumbnailProperties.mimeType': 'PNG' })
+    const result = await handler({ presentationId, 'pageObjectId': firstSlideObjectId, 'thumbnailProperties.thumbnailSize': 'MEDIUM', 'thumbnailProperties.mimeType': 'PNG' })
     expect(typeof result?.contentUrl === 'string' || typeof result?.thumbnailUrl === 'string').toBe(true)
   }, 30000)
 })

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/manifest.json

@@ -3,39 +3,39 @@
   "version": "0.1.0",
   "tools": [
     {
-      "name": "get_presentation",
-      "description": "Retrieve presentation metadata, including slides/pages and elements.",
+      "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/get_presentation.js",
+      "handler": "handlers/read_presentation.js",
       "scope": "read"
     },
     {
       "name": "get_page_thumbnail",
-      "description": "Get a thumbnail image for a page (slide) in a presentation.",
+      "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 presentation with optional initial title.",
+      "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 batchUpdate request to modify presentation structure and content.",
+      "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 the specified slide (slideIndex, default 0).", "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 text for the first match anywhere in the presentation.", "inputSchema": "schemas/replace_text_first_match.json", "handler": "handlers/replace_text_first_match.js", "scope": "write" },
-    { "name": "style_text_first_match", "description": "Apply text style to the first match of given text.", "inputSchema": "schemas/style_text_first_match.json", "handler": "handlers/style_text_first_match.js", "scope": "write" },
-    { "name": "insert_shape_after_first_match", "description": "Insert a rectangle shape near the first match of text on a slide.", "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": "Insert an image near the first match of text on a slide.", "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": "Create a new slide after the slide that contains the first text match.", "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 background color for a slide by index.", "inputSchema": "schemas/set_background_color_for_slide_index.json", "handler": "handlers/set_background_color_for_slide_index.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/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. |