Skip to content

improvement(tools): validate integrations, add Gong activity tools, regenerate docs #4937

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
waleedlatif1 merged 7 commits into from
Jun 10, 2026
Merged

improvement(tools): validate integrations, add Gong activity tools, regenerate docs #4937

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
d651fce
improvement(tools): validate integrations, add Gong activity tools, r…
waleedlatif1 Jun 10, 2026
5beb971
fix(servicenow): give list-attachments limit a unique subBlock id
waleedlatif1 Jun 10, 2026
584c5ca
fix(servicenow): type upload-attachment response json to fix build ty…
waleedlatif1 Jun 10, 2026
4615046
refactor(servicenow): type upload-attachment response per file-route …
waleedlatif1 Jun 10, 2026
ff42c41
fix(servicenow): remove invalid 'custom' generationType from groupBy …
waleedlatif1 Jun 10, 2026
86e259d
fix(servicenow): drop redundant hidden fileContent param from upload …
waleedlatif1 Jun 10, 2026
e5cd4f8
fix(dub): require a link selector for bulk update links
waleedlatif1 Jun 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions apps/docs/components/icons.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4987,7 +4987,7 @@ export function IntercomIcon(props: SVGProps<SVGSVGElement>) {
<g>
<path
d='M221.66,144.56 C221.66,146.9 220.76,149.15 219.17,150.8 C217.57,152.46 215.4,153.39 213.15,153.39 C210.89,153.39 208.72,152.46 207.12,150.8 C205.53,149.15 204.63,146.9 204.63,144.56 L204.63,65.68 C204.63,63.34 205.53,61.09 207.12,59.43 C208.72,57.78 210.89,56.85 213.15,56.85 C215.4,56.85 217.57,57.78 219.17,59.43 C220.76,61.09 221.66,63.34 221.66,65.68 L221.66,144.56 Z M218.7,199.22 C217.58,200.39 185.91,227.75 127.86,227.75 C69.81,227.75 38.35,200.53 37.01,199.36 C36.17,198.63 35.48,197.73 34.97,196.71 C34.47,195.69 34.16,194.59 34.07,193.45 C33.98,192.31 34.1,191.16 34.44,190.07 C34.77,188.98 35.32,187.98 36.03,187.1 C37.5,185.34 39.58,184.25 41.82,184.07 C44.06,183.9 46.28,184.64 47.99,186.16 C48.48,186.52 76.77,210.31 127.79,210.31 C178.81,210.31 207.3,186.37 207.59,186.16 C209.32,184.66 211.54,183.92 213.79,184.1 C216.04,184.27 218.13,185.35 219.62,187.1 C221.06,188.84 221.77,191.1 221.61,193.38 C221.46,195.66 220.44,197.78 218.78,199.29 L218.7,199.22 Z M33.99,65.68 C34.12,63.33 35.13,61.13 36.82,59.55 C38.51,57.98 40.73,57.17 43,57.29 C45.1,57.41 47.08,58.33 48.56,59.88 C50.04,61.43 50.92,63.5 51.02,65.68 L51.02,144.42 C51.02,146.76 50.12,149 48.52,150.66 C46.93,152.31 44.76,153.24 42.5,153.24 C40.24,153.24 38.08,152.31 36.48,150.66 C34.88,149 33.99,146.76 33.99,144.42 L33.99,65.68 Z M76.7,48.16 C76.83,45.81 77.85,43.61 79.54,42.04 C81.22,40.47 83.44,39.65 85.71,39.77 C87.81,39.9 89.79,40.82 91.27,42.37 C92.75,43.92 93.63,45.98 93.73,48.16 L93.73,164.92 C93.73,167.26 92.83,169.51 91.24,171.16 C89.64,172.82 87.47,173.75 85.22,173.75 C82.96,173.75 80.79,172.82 79.2,171.16 C77.6,169.51 76.7,167.26 76.7,164.92 L76.7,48.16 Z M119.63,43.79 C119.63,41.44 120.52,39.2 122.12,37.54 C123.72,35.89 125.88,34.96 128.14,34.96 C130.4,34.96 132.56,35.89 134.16,37.54 C135.76,39.2 136.66,41.44 136.66,43.79 L136.66,170.76 C136.66,173.1 135.76,175.35 134.16,177 C132.56,178.66 130.4,179.59 128.14,179.59 C125.88,179.59 123.72,178.66 122.12,177 C120.52,175.35 119.63,173.1 119.63,170.76 L119.63,43.79 Z M161.85,48.16 C161.85,45.82 162.74,43.58 164.34,41.92 C165.94,40.26 168.1,39.33 170.36,39.33 C172.62,39.33 174.79,40.26 176.38,41.92 C177.98,43.58 178.88,45.82 178.88,48.16 L178.88,164.92 C178.88,167.26 177.98,169.51 176.38,171.16 C174.79,172.82 172.62,173.75 170.36,173.75 C168.1,173.75 165.94,172.82 164.34,171.16 C162.74,169.51 161.85,167.26 161.85,164.92 L161.85,48.16 Z M223.98,0 L32.02,0 C27.83,-0.03 23.69,0.8 19.81,2.44 C15.94,4.07 12.41,6.48 9.44,9.53 C6.47,12.58 4.1,16.21 2.48,20.21 C0.86,24.21 0.02,28.5 0,32.84 L0,229.87 C0.02,234.2 0.86,238.5 2.48,242.49 C4.1,246.49 6.47,250.12 9.44,253.17 C12.41,256.22 15.94,258.64 19.81,260.27 C23.69,261.91 27.83,262.73 32.02,262.71 L223.98,262.71 C228.16,262.73 232.3,261.91 236.17,260.28 C240.04,258.65 243.56,256.24 246.53,253.2 C249.51,250.16 251.87,246.54 253.5,242.55 C255.12,238.55 255.97,234.27 256,229.94 L256,32.84 C255.98,28.51 255.14,24.22 253.52,20.23 C251.91,16.23 249.55,12.61 246.58,9.56 C243.62,6.51 240.1,4.1 236.24,2.46 C232.37,0.82 228.23,-0.02 224.05,0'
fill='currentColor'
fill='#000000'
/>
</g>
</svg>
Expand Down Expand Up @@ -5028,7 +5028,7 @@ export function MailchimpIcon(props: SVGProps<SVGSVGElement>) {
y='0px'
viewBox='0 0 230.81 244.96'
xmlSpace='preserve'
fill='currentColor'
fill='#000000'
>
<g>
<g>
Expand Down
2 changes: 1 addition & 1 deletion apps/docs/content/docs/en/tools/brightdata.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard
type="brightdata"
color="#0F4C81"
color="#FFFFFF"
/>

## Usage Instructions
Expand Down
116 changes: 116 additions & 0 deletions apps/docs/content/docs/en/tools/databricks.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,61 @@ Execute a SQL statement against a Databricks SQL warehouse and return results in
| `totalRows` | number | Total number of rows in the result |
| `truncated` | boolean | Whether the result set was truncated due to row_limit or byte_limit |

### `databricks_get_statement`

Poll a SQL statement by its ID to retrieve status and results. Use this after Execute SQL when a query runs longer than the wait timeout.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `host` | string | Yes | Databricks workspace host \(e.g., dbc-abc123.cloud.databricks.com\) |
| `apiKey` | string | Yes | Databricks Personal Access Token |
| `statementId` | string | Yes | The ID of the statement to fetch \(returned by Execute SQL\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `statementId` | string | Unique identifier for the statement |
| `status` | string | Execution status \(SUCCEEDED, PENDING, RUNNING, FAILED, CANCELED, CLOSED\) |
| `columns` | array | Column schema of the result set |
| ↳ `name` | string | Column name |
| ↳ `position` | number | Column position \(0-based\) |
| ↳ `typeName` | string | Column type \(STRING, INT, LONG, DOUBLE, BOOLEAN, TIMESTAMP, DATE, DECIMAL, etc.\) |
| `data` | array | Result rows as a 2D array of strings where each inner array is a row of column values |
| `totalRows` | number | Total number of rows in the result |
| `truncated` | boolean | Whether the result set was truncated due to row_limit or byte_limit |

### `databricks_list_warehouses`

List all SQL warehouses in a Databricks workspace including their size, state, and type. Use this to discover the warehouse ID needed for Execute SQL.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `host` | string | Yes | Databricks workspace host \(e.g., dbc-abc123.cloud.databricks.com\) |
| `apiKey` | string | Yes | Databricks Personal Access Token |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `warehouses` | array | List of SQL warehouses in the workspace |
| ↳ `warehouseId` | string | Unique warehouse identifier |
| ↳ `name` | string | Warehouse display name |
| ↳ `clusterSize` | string | Warehouse size \(e.g., 2X-Small, Small, Medium, Large\) |
| ↳ `state` | string | Current state \(STARTING, RUNNING, STOPPING, STOPPED, DELETING, DELETED\) |
| ↳ `warehouseType` | string | Warehouse type \(CLASSIC, PRO\) |
| ↳ `creatorName` | string | Email of the warehouse creator |
| ↳ `autoStopMinutes` | number | Minutes of inactivity before auto-stop \(0 = disabled\) |
| ↳ `numClusters` | number | Current number of running clusters |
| ↳ `minNumClusters` | number | Minimum cluster count for scaling |
| ↳ `maxNumClusters` | number | Maximum cluster count for scaling |
| ↳ `numActiveSessions` | number | Number of active sessions |
| ↳ `enableServerlessCompute` | boolean | Whether serverless compute is enabled |

### `databricks_list_jobs`

List all jobs in a Databricks workspace with optional filtering by name.
Expand Down Expand Up @@ -93,6 +148,34 @@ List all jobs in a Databricks workspace with optional filtering by name.
| `hasMore` | boolean | Whether more jobs are available for pagination |
| `nextPageToken` | string | Token for fetching the next page of results |

### `databricks_get_job`

Get the full definition and settings of a single Databricks job by its job ID.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `host` | string | Yes | Databricks workspace host \(e.g., dbc-abc123.cloud.databricks.com\) |
| `apiKey` | string | Yes | Databricks Personal Access Token |
| `jobId` | number | Yes | The canonical identifier of the job to retrieve |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `jobId` | number | The job ID |
| `name` | string | Job name |
| `creatorUserName` | string | Email of the job creator |
| `runAsUserName` | string | User the job runs as |
| `createdTime` | number | Job creation timestamp \(epoch ms\) |
| `format` | string | Job format \(SINGLE_TASK or MULTI_TASK\) |
| `maxConcurrentRuns` | number | Maximum number of concurrent runs |
| `timeoutSeconds` | number | Job-level timeout in seconds \(0 or null means no timeout\) |
| `schedule` | object | Cron schedule configuration \(quartz_cron_expression, timezone_id, pause_status\) |
| `tags` | object | Key-value tags applied to the job |
| `tasks` | array | Task definitions for the job \(empty for single-task jobs\) |

### `databricks_run_job`

Trigger an existing Databricks job to run immediately with optional job-level or notebook parameters.
Expand Down Expand Up @@ -264,4 +347,37 @@ List all clusters in a Databricks workspace including their state, configuration
| ↳ `autoterminationMinutes` | number | Minutes of inactivity before auto-termination \(0 = disabled\) |
| ↳ `startTime` | number | Cluster start timestamp \(epoch ms\) |

### `databricks_get_cluster`

Get the state, configuration, and resource details of a single Databricks cluster by its cluster ID.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `host` | string | Yes | Databricks workspace host \(e.g., dbc-abc123.cloud.databricks.com\) |
| `apiKey` | string | Yes | Databricks Personal Access Token |
| `clusterId` | string | Yes | The ID of the cluster to retrieve |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `cluster` | object | Cluster detail |
| ↳ `clusterId` | string | Unique cluster identifier |
| ↳ `clusterName` | string | Cluster display name |
| ↳ `state` | string | Current state \(PENDING, RUNNING, RESTARTING, RESIZING, TERMINATING, TERMINATED, ERROR, UNKNOWN\) |
| ↳ `stateMessage` | string | Human-readable state description |
| ↳ `creatorUserName` | string | Email of the cluster creator |
| ↳ `sparkVersion` | string | Spark runtime version \(e.g., 13.3.x-scala2.12\) |
| ↳ `nodeTypeId` | string | Worker node type identifier |
| ↳ `driverNodeTypeId` | string | Driver node type identifier |
| ↳ `numWorkers` | number | Number of worker nodes \(for fixed-size clusters\) |
| ↳ `autoscale` | object | Autoscaling configuration \(null for fixed-size clusters\) |
| ↳ `minWorkers` | number | Minimum number of workers |
| ↳ `maxWorkers` | number | Maximum number of workers |
| ↳ `clusterSource` | string | Origin \(API, UI, JOB, MODELS, PIPELINE, PIPELINE_MAINTENANCE, SQL\) |
| ↳ `autoterminationMinutes` | number | Minutes of inactivity before auto-termination \(0 = disabled\) |
| ↳ `startTime` | number | Cluster start timestamp \(epoch ms\) |


135 changes: 133 additions & 2 deletions apps/docs/content/docs/en/tools/dub.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -273,8 +273,6 @@ Retrieve a paginated list of short links for the authenticated workspace. Suppor
| `search` | string | No | Search query matched against the short link slug and destination URL |
| `tagIds` | string | No | Comma-separated tag IDs to filter by |
| `showArchived` | boolean | No | Whether to include archived links \(defaults to false\) |
| `sortBy` | string | No | Sort by field: createdAt, clicks, saleAmount, or lastClicked |
| `sortOrder` | string | No | Sort order: asc or desc |
| `page` | number | No | Page number \(default: 1\) |
| `pageSize` | number | No | Number of links per page \(default: 100, max: 100\) |

Expand All @@ -285,6 +283,86 @@ Retrieve a paginated list of short links for the authenticated workspace. Suppor
| `links` | json | Array of link objects \(id, domain, key, url, shortLink, clicks, tags, createdAt\) |
| `count` | number | Number of links returned |

### `dub_get_links_count`

Retrieve the number of short links for the authenticated workspace, optionally filtered and grouped by domain, tag, user, or folder.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Dub API key |
| `domain` | string | No | Filter by domain |
| `search` | string | No | Search query matched against the short link slug and destination URL |
| `tagIds` | string | No | Comma-separated tag IDs to filter by |
| `tagNames` | string | No | Comma-separated tag names to filter by \(case-insensitive\) |
| `folderId` | string | No | Filter by folder ID |
| `showArchived` | boolean | No | Whether to include archived links \(defaults to false\) |
| `groupBy` | string | No | Group counts by: domain, tagId, userId, or folderId |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `count` | number | Total number of links matching the filters |
| `groups` | json | Per-group counts when groupBy is set \(e.g. \[\{ domain, count \}\]\) |

### `dub_bulk_create_links`

Create up to 100 short links in a single request. Returns the created links alongside any per-link errors.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Dub API key |
| `links` | json | Yes | JSON array of link objects to create. Each object requires a "url" and may include domain, key, tagIds, and other link fields \(max 100\). |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `created` | json | Array of successfully created link objects |
| `errors` | json | Array of per-link errors \(\{ link, error, code \}\) for links that failed |
| `count` | number | Number of links successfully created |

### `dub_bulk_update_links`

Apply the same set of field updates to up to 100 links at once, selected by link IDs or external IDs.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Dub API key |
| `linkIds` | string | No | Comma-separated link IDs to update \(max 100, takes precedence over externalIds\) |
| `externalIds` | string | No | Comma-separated external IDs to update \(max 100\) |
| `data` | json | Yes | JSON object of fields to apply to every selected link \(e.g. \{ "archived": true, "tagIds": \["..."\] \}\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `updated` | json | Array of updated link objects |
| `count` | number | Number of links updated |

### `dub_bulk_delete_links`

Delete up to 100 short links in a single request by their link IDs. Non-existing IDs are ignored.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Dub API key |
| `linkIds` | string | Yes | Comma-separated link IDs to delete \(max 100\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `deletedCount` | number | Number of links that were deleted |

### `dub_get_analytics`

Retrieve analytics for links including clicks, leads, and sales. Supports filtering by link, time range, and grouping by various dimensions.
Expand Down Expand Up @@ -315,4 +393,57 @@ Retrieve analytics for links including clicks, leads, and sales. Supports filter
| `saleAmount` | number | Total sale amount in cents |
| `data` | json | Grouped analytics data \(timeseries, countries, devices, etc.\) |

### `dub_get_events`

Retrieve a paginated stream of individual click, lead, and sale events for links, with filtering by link, time range, and location.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Dub API key |
| `event` | string | No | Event type: clicks \(default\), leads, or sales |
| `linkId` | string | No | Filter by link ID |
| `externalId` | string | No | Filter by external ID \(prefix with ext_\) |
| `domain` | string | No | Filter by domain |
| `interval` | string | No | Time interval: 24h \(default\), 7d, 30d, 90d, 1y, mtd, qtd, ytd, or all |
| `start` | string | No | Start date/time in ISO 8601 format \(overrides interval\) |
| `end` | string | No | End date/time in ISO 8601 format \(defaults to now\) |
| `country` | string | No | Filter by country \(ISO 3166-1 alpha-2 code\) |
| `timezone` | string | No | IANA timezone for event timestamps \(defaults to UTC\) |
| `page` | number | No | Page number \(default: 1\) |
| `limit` | number | No | Number of events per page \(default: 100, max: 1000\) |
| `sortOrder` | string | No | Sort order: desc \(default\) or asc |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `events` | json | Array of event objects \(event, timestamp, click, link, and customer/sale data when applicable\) |
| `count` | number | Number of events returned |

### `dub_get_qr_code`

Generate a customizable QR code (PNG) for a short link, with control over size, error correction, colors, and margin.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Dub API key |
| `url` | string | Yes | The short link URL to encode in the QR code |
| `size` | number | No | QR code size in pixels \(default: 600\) |
| `level` | string | No | Error correction level: L \(default\), M, Q, or H |
| `fgColor` | string | No | Foreground color in hex \(default: #000000\) |
| `bgColor` | string | No | Background color in hex \(default: #FFFFFF\) |
| `hideLogo` | boolean | No | Whether to hide the logo in the center of the QR code \(default: false\) |
| `margin` | number | No | Margin \(quiet zone\) around the QR code \(default: 2\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `file` | file | Generated QR code image stored in execution files |
| `content` | string | Base64-encoded PNG image data |


4 changes: 4 additions & 0 deletions apps/docs/content/docs/en/tools/duckduckgo.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,10 +54,14 @@ Search the web using DuckDuckGo Instant Answers API. Returns instant answers, ab
| `abstractText` | string | Plain text version of the abstract |
| `abstractSource` | string | The source of the abstract \(e.g., Wikipedia\) |
| `abstractURL` | string | URL to the source of the abstract |
| `definition` | string | Dictionary-style definition if available |
| `definitionSource` | string | The source of the definition |
| `definitionURL` | string | URL to the source of the definition |
| `image` | string | URL to an image related to the topic |
| `answer` | string | Direct answer if available \(e.g., for calculations\) |
| `answerType` | string | Type of the answer \(e.g., calc, ip, etc.\) |
| `type` | string | Response type: A \(article\), D \(disambiguation\), C \(category\), N \(name\), E \(exclusive\) |
| `redirect` | string | !bang redirect URL, populated only for bang queries |
| `relatedTopics` | array | Array of related topics with URLs and descriptions |
| ↳ `FirstURL` | string | URL to the related topic |
| ↳ `Text` | string | Description of the related topic |
Expand Down
Loading
Loading