From c332ddaca47ea553c20b55458baf2de0a337ae35 Mon Sep 17 00:00:00 2001 From: Bill Leoutsakos Date: Thu, 30 Jul 2026 11:58:02 -0700 Subject: [PATCH 01/12] feat(quickbooks): add read-only procurement integration --- apps/docs/components/icons.tsx | 19 + apps/docs/components/ui/icon-mapping.ts | 2 + .../content/docs/en/integrations/meta.json | 1 + .../docs/en/integrations/quickbooks.mdx | 177 +++++++ .../app/api/auth/oauth/token/route.test.ts | 62 +++ apps/sim/app/api/auth/oauth/token/route.ts | 37 ++ apps/sim/blocks/blocks/quickbooks.ts | 290 ++++++++++++ apps/sim/blocks/registry-maps.ts | 3 + apps/sim/components/icons.tsx | 19 + .../lib/api/contracts/oauth-connections.ts | 1 + apps/sim/lib/api/contracts/selectors/oauth.ts | 1 + apps/sim/lib/auth/auth.ts | 79 ++++ apps/sim/lib/core/config/env.ts | 3 + apps/sim/lib/integrations/icon-mapping.ts | 2 + apps/sim/lib/integrations/integrations.json | 36 ++ apps/sim/lib/oauth/oauth.test.ts | 132 ++++-- apps/sim/lib/oauth/oauth.ts | 93 +++- apps/sim/lib/oauth/quickbooks.test.ts | 197 ++++++++ apps/sim/lib/oauth/quickbooks.ts | 138 ++++++ apps/sim/lib/oauth/types.ts | 2 + apps/sim/lib/oauth/utils.test.ts | 20 + apps/sim/lib/oauth/utils.ts | 2 + apps/sim/lib/quickbooks/client.ts | 119 +++++ apps/sim/lib/quickbooks/fault.ts | 40 ++ apps/sim/tools/error-extractors.ts | 45 ++ apps/sim/tools/index.test.ts | 111 +++++ apps/sim/tools/index.ts | 39 +- .../tools/quickbooks/error-extractor.test.ts | 71 +++ apps/sim/tools/quickbooks/get_company_info.ts | 92 ++++ apps/sim/tools/quickbooks/index.ts | 5 + apps/sim/tools/quickbooks/list_bills.ts | 128 +++++ .../tools/quickbooks/list_purchase_orders.ts | 132 ++++++ apps/sim/tools/quickbooks/list_vendors.ts | 130 ++++++ apps/sim/tools/quickbooks/quickbooks.test.ts | 440 ++++++++++++++++++ apps/sim/tools/quickbooks/types.ts | 224 +++++++++ apps/sim/tools/quickbooks/utils.ts | 118 +++++ apps/sim/tools/registry.ts | 10 + apps/sim/tools/types.ts | 2 + scripts/generate-docs.ts | 7 +- 39 files changed, 2960 insertions(+), 69 deletions(-) create mode 100644 apps/docs/content/docs/en/integrations/quickbooks.mdx create mode 100644 apps/sim/blocks/blocks/quickbooks.ts create mode 100644 apps/sim/lib/oauth/quickbooks.test.ts create mode 100644 apps/sim/lib/oauth/quickbooks.ts create mode 100644 apps/sim/lib/quickbooks/client.ts create mode 100644 apps/sim/lib/quickbooks/fault.ts create mode 100644 apps/sim/tools/quickbooks/error-extractor.test.ts create mode 100644 apps/sim/tools/quickbooks/get_company_info.ts create mode 100644 apps/sim/tools/quickbooks/index.ts create mode 100644 apps/sim/tools/quickbooks/list_bills.ts create mode 100644 apps/sim/tools/quickbooks/list_purchase_orders.ts create mode 100644 apps/sim/tools/quickbooks/list_vendors.ts create mode 100644 apps/sim/tools/quickbooks/quickbooks.test.ts create mode 100644 apps/sim/tools/quickbooks/types.ts create mode 100644 apps/sim/tools/quickbooks/utils.ts diff --git a/apps/docs/components/icons.tsx b/apps/docs/components/icons.tsx index efedba2000d..d2bc5089e04 100644 --- a/apps/docs/components/icons.tsx +++ b/apps/docs/components/icons.tsx @@ -2494,6 +2494,25 @@ export function BrexIcon(props: SVGProps) { ) } +/** + * Official QuickBooks circular mark, cropped from the user-supplied + * Intuit_QuickBooks_logo.svg wordmark. + */ +export function QuickBooksIcon(props: SVGProps) { + return ( + + + + + ) +} + export function BrightDataIcon(props: SVGProps) { return ( = { pulse_v2: PulseIcon, qdrant: QdrantIcon, quartr: QuartrIcon, + quickbooks: QuickBooksIcon, quiver: QuiverIcon, railway: RailwayIcon, rb2b: RB2BIcon, diff --git a/apps/docs/content/docs/en/integrations/meta.json b/apps/docs/content/docs/en/integrations/meta.json index 56235d7d9c2..2acc26542c6 100644 --- a/apps/docs/content/docs/en/integrations/meta.json +++ b/apps/docs/content/docs/en/integrations/meta.json @@ -187,6 +187,7 @@ "pulse", "qdrant", "quartr", + "quickbooks", "quiver", "railway", "rb2b", diff --git a/apps/docs/content/docs/en/integrations/quickbooks.mdx b/apps/docs/content/docs/en/integrations/quickbooks.mdx new file mode 100644 index 00000000000..c01e83658ab --- /dev/null +++ b/apps/docs/content/docs/en/integrations/quickbooks.mdx @@ -0,0 +1,177 @@ +--- +title: QuickBooks +description: Read procurement data from QuickBooks Online +--- + +import { BlockInfoCard } from "@/components/ui/block-info-card" + + + +## Usage Instructions + +Connect one QuickBooks Online company and read its company profile, vendors, purchase orders, and bills. The connected company is selected during OAuth and cannot be overridden by workflow input. + + + +## Actions + +### `quickbooks_get_company_info` + +Get information about the connected QuickBooks Online company + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `company` | json | Verified QuickBooks CompanyInfo object, including Id, CompanyName, LegalName, addresses, contact details, NameValue settings, and MetaData when populated | +| ↳ `Id` | string | Connected QuickBooks company ID | +| ↳ `SyncToken` | string | CompanyInfo sync token | +| ↳ `CompanyName` | string | Company display name | +| ↳ `LegalName` | string | Company legal name | +| ↳ `CompanyAddr` | json | Company address | +| ↳ `CustomerCommunicationAddr` | json | Customer communication address | +| ↳ `LegalAddr` | json | Company legal address | +| ↳ `PrimaryPhone` | json | Primary phone details | +| ↳ `Email` | json | Company email details | +| ↳ `WebAddr` | json | Company website details | +| ↳ `CompanyStartDate` | string | Company start date | +| ↳ `Country` | string | Company country code | +| ↳ `FiscalYearStartMonth` | string | Fiscal year starting month | +| ↳ `DefaultTimeZone` | string | Company default time zone | +| ↳ `NameValue` | array | QuickBooks company settings represented as name/value entries | +| ↳ `MetaData` | json | CompanyInfo creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | +| `time` | string | QuickBooks response timestamp | + +### `quickbooks_list_bills` + +List bills in the connected QuickBooks Online company + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `startPosition` | number | Yes | One-based position of the first bill to return | +| `maxResults` | number | Yes | Number of bills to request \(1–100\) | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `startPosition` | number | One-based position of the first item in this response | +| `maxResults` | number | Actual number of items reported for this response | +| `nextStartPosition` | number | Position to use when explicitly requesting the next page | +| `hasMore` | boolean | Conservative indication that another page may exist | +| `time` | string | QuickBooks response timestamp | +| `items` | array | Bill objects returned by QuickBooks | +| ↳ `Id` | string | Bill ID | +| ↳ `SyncToken` | string | Bill sync token | +| ↳ `DocNumber` | string | Bill reference number | +| ↳ `TxnDate` | string | Bill transaction date | +| ↳ `DueDate` | string | Bill due date | +| ↳ `VendorRef` | json | Bill vendor reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `APAccountRef` | json | Accounts payable account reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `CurrencyRef` | json | Bill currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `ExchangeRate` | number | Bill exchange rate | +| ↳ `Line` | array | Bill line items and their detail objects | +| ↳ `TotalAmt` | number | Bill total amount | +| ↳ `Balance` | number | Unpaid bill balance | +| ↳ `PrivateNote` | string | Private bill note | +| ↳ `MetaData` | json | Bill creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_list_purchase_orders` + +List purchase orders in the connected QuickBooks Online company + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `startPosition` | number | Yes | One-based position of the first purchase order to return | +| `maxResults` | number | Yes | Number of purchase orders to request \(1–100\) | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `startPosition` | number | One-based position of the first item in this response | +| `maxResults` | number | Actual number of items reported for this response | +| `nextStartPosition` | number | Position to use when explicitly requesting the next page | +| `hasMore` | boolean | Conservative indication that another page may exist | +| `time` | string | QuickBooks response timestamp | +| `items` | array | PurchaseOrder objects returned by QuickBooks | +| ↳ `Id` | string | Purchase order ID | +| ↳ `SyncToken` | string | Purchase order sync token | +| ↳ `DocNumber` | string | Purchase order number | +| ↳ `TxnDate` | string | Purchase order date | +| ↳ `VendorRef` | json | Purchase order vendor reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `CurrencyRef` | json | Purchase order currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `ExchangeRate` | number | Purchase order exchange rate | +| ↳ `Line` | array | Purchase order line items and their detail objects | +| ↳ `TotalAmt` | number | Purchase order total amount | +| ↳ `PrivateNote` | string | Private purchase order note | +| ↳ `MetaData` | json | Purchase order creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | + +### `quickbooks_list_vendors` + +List vendors in the connected QuickBooks Online company + +#### Input + +| Parameter | Type | Required | Description | +| --------- | ---- | -------- | ----------- | +| `startPosition` | number | Yes | One-based position of the first vendor to return | +| `maxResults` | number | Yes | Number of vendors to request \(1–100\) | + +#### Output + +| Parameter | Type | Description | +| --------- | ---- | ----------- | +| `startPosition` | number | One-based position of the first item in this response | +| `maxResults` | number | Actual number of items reported for this response | +| `nextStartPosition` | number | Position to use when explicitly requesting the next page | +| `hasMore` | boolean | Conservative indication that another page may exist | +| `time` | string | QuickBooks response timestamp | +| `items` | array | Vendor objects returned by QuickBooks | +| ↳ `Id` | string | Vendor ID | +| ↳ `SyncToken` | string | Vendor sync token | +| ↳ `DisplayName` | string | Vendor display name | +| ↳ `CompanyName` | string | Vendor company name | +| ↳ `GivenName` | string | Vendor given name | +| ↳ `FamilyName` | string | Vendor family name | +| ↳ `PrintOnCheckName` | string | Name printed on checks | +| ↳ `Active` | boolean | Whether the vendor is active | +| ↳ `Vendor1099` | boolean | Whether the vendor is tracked for 1099 reporting | +| ↳ `BillAddr` | json | Vendor billing address | +| ↳ `PrimaryPhone` | json | Vendor primary phone details | +| ↳ `PrimaryEmailAddr` | json | Vendor primary email details | +| ↳ `Balance` | number | Vendor balance | +| ↳ `CurrencyRef` | json | Vendor currency reference | +| ↳ `value` | string | QuickBooks entity ID | +| ↳ `name` | string | QuickBooks entity display name | +| ↳ `MetaData` | json | Vendor creation and update timestamps | +| ↳ `CreateTime` | string | Entity creation timestamp | +| ↳ `LastUpdatedTime` | string | Entity last-updated timestamp | diff --git a/apps/sim/app/api/auth/oauth/token/route.test.ts b/apps/sim/app/api/auth/oauth/token/route.test.ts index e1ef6105675..57246576a2c 100644 --- a/apps/sim/app/api/auth/oauth/token/route.test.ts +++ b/apps/sim/app/api/auth/oauth/token/route.test.ts @@ -67,12 +67,74 @@ describe('OAuth Token API Routes', () => { expect(response.status).toBe(200) expect(data).toHaveProperty('accessToken', 'fresh-token') + expect(data).not.toHaveProperty('realmId') expect(mockAuthorizeCredentialUse).toHaveBeenCalled() expect(authOAuthUtilsMockFns.mockGetCredential).toHaveBeenCalled() expect(authOAuthUtilsMockFns.mockRefreshTokenIfNeeded).toHaveBeenCalled() }) + it('returns realmId only for QuickBooks credentials', async () => { + mockAuthorizeCredentialUse.mockResolvedValueOnce({ + ok: true, + authType: 'session', + requesterUserId: 'test-user-id', + credentialOwnerUserId: 'owner-user-id', + }) + authOAuthUtilsMockFns.mockGetCredential.mockResolvedValueOnce({ + id: 'credential-id', + accountId: 'quickbooks:123456789:intuit-subject-01234567-89ab-4def-8abc-0123456789ab', + accessToken: 'test-token', + refreshToken: 'refresh-token', + accessTokenExpiresAt: new Date(Date.now() + 3600 * 1000), + providerId: 'quickbooks', + }) + authOAuthUtilsMockFns.mockRefreshTokenIfNeeded.mockResolvedValueOnce({ + accessToken: 'fresh-token', + refreshed: false, + }) + + const response = await POST( + createMockRequest('POST', { + credentialId: 'credential-id', + }) + ) + + expect(response.status).toBe(200) + expect(await response.json()).toEqual({ + accessToken: 'fresh-token', + realmId: '123456789', + }) + }) + + it('rejects a malformed QuickBooks company identity with reconnect guidance', async () => { + mockAuthorizeCredentialUse.mockResolvedValueOnce({ + ok: true, + authType: 'session', + requesterUserId: 'test-user-id', + credentialOwnerUserId: 'owner-user-id', + }) + authOAuthUtilsMockFns.mockGetCredential.mockResolvedValueOnce({ + id: 'credential-id', + accountId: 'malformed', + accessToken: 'test-token', + refreshToken: 'refresh-token', + accessTokenExpiresAt: new Date(Date.now() + 3600 * 1000), + providerId: 'quickbooks', + }) + + const response = await POST( + createMockRequest('POST', { + credentialId: 'credential-id', + }) + ) + const data = await response.json() + + expect(response.status).toBe(401) + expect(data.error).toMatch(/Reconnect the QuickBooks credential/) + expect(authOAuthUtilsMockFns.mockRefreshTokenIfNeeded).not.toHaveBeenCalled() + }) + it('should handle workflowId for server-side authentication', async () => { mockAuthorizeCredentialUse.mockResolvedValueOnce({ ok: true, diff --git a/apps/sim/app/api/auth/oauth/token/route.ts b/apps/sim/app/api/auth/oauth/token/route.ts index 6b5c2adad6d..dc9c805a279 100644 --- a/apps/sim/app/api/auth/oauth/token/route.ts +++ b/apps/sim/app/api/auth/oauth/token/route.ts @@ -12,6 +12,7 @@ import { AuthType, checkSessionOrInternalAuth } from '@/lib/auth/hybrid' import { generateRequestId } from '@/lib/core/utils/request' import { withRouteHandler } from '@/lib/core/utils/with-route-handler' import { TokenServiceAccountValidationError } from '@/lib/credentials/token-service-accounts/errors' +import { parseQuickBooksAccountId } from '@/lib/oauth/quickbooks' import { captureServerEvent } from '@/lib/posthog/server' import { getCredential, @@ -249,6 +250,23 @@ export const POST = withRouteHandler(async (request: NextRequest) => { const oauthActorId = authz.requesterUserId const oauthWorkspaceId = authz.workspaceId ?? null + let realmId: string | undefined + if (credential.providerId === 'quickbooks') { + try { + realmId = parseQuickBooksAccountId(credential.accountId).realmId + } catch (error) { + return NextResponse.json( + { + error: getErrorMessage( + error, + 'QuickBooks company identity is invalid. Reconnect the QuickBooks credential.' + ), + }, + { status: 401 } + ) + } + } + try { const { accessToken } = await refreshTokenIfNeeded( requestId, @@ -295,6 +313,7 @@ export const POST = withRouteHandler(async (request: NextRequest) => { accessToken, idToken: credential.idToken || undefined, ...(instanceUrl && { instanceUrl }), + ...(realmId && { realmId }), }, { status: 200 } ) @@ -360,6 +379,23 @@ export const GET = withRouteHandler(async (request: NextRequest) => { const actorId = authz.requesterUserId const workspaceId = authz.workspaceId ?? null + let realmId: string | undefined + if (credential.providerId === 'quickbooks') { + try { + realmId = parseQuickBooksAccountId(credential.accountId).realmId + } catch (error) { + return NextResponse.json( + { + error: getErrorMessage( + error, + 'QuickBooks company identity is invalid. Reconnect the QuickBooks credential.' + ), + }, + { status: 401 } + ) + } + } + try { const { accessToken } = await refreshTokenIfNeeded( requestId, @@ -407,6 +443,7 @@ export const GET = withRouteHandler(async (request: NextRequest) => { accessToken, idToken: credential.idToken || undefined, ...(instanceUrl && { instanceUrl }), + ...(realmId && { realmId }), }, { status: 200 } ) diff --git a/apps/sim/blocks/blocks/quickbooks.ts b/apps/sim/blocks/blocks/quickbooks.ts new file mode 100644 index 00000000000..e0727dd560f --- /dev/null +++ b/apps/sim/blocks/blocks/quickbooks.ts @@ -0,0 +1,290 @@ +import { QuickBooksIcon } from '@/components/icons' +import { getScopesForService } from '@/lib/oauth/utils' +import type { BlockConfig, BlockMeta } from '@/blocks/types' +import { AuthMode, IntegrationType } from '@/blocks/types' +import type { QuickBooksResponse } from '@/tools/quickbooks/types' + +const LIST_OPERATIONS = [ + 'quickbooks_list_vendors', + 'quickbooks_list_purchase_orders', + 'quickbooks_list_bills', +] as const + +function parsePaginationInteger( + value: unknown, + fieldName: 'startPosition' | 'maxResults', + fallback: number +): number { + if (value == null || (typeof value === 'string' && value.trim() === '')) return fallback + const parsed = typeof value === 'number' ? value : Number(value) + if (!Number.isInteger(parsed)) { + throw new Error(`${fieldName} must be an integer`) + } + if (fieldName === 'startPosition' && parsed < 1) { + throw new Error('startPosition must be a positive integer') + } + if (fieldName === 'maxResults' && (parsed < 1 || parsed > 100)) { + throw new Error('maxResults must be an integer from 1 through 100') + } + return parsed +} + +export const QuickBooksBlock: BlockConfig = { + type: 'quickbooks', + name: 'QuickBooks', + description: 'Read procurement data from QuickBooks Online', + authMode: AuthMode.OAuth, + longDescription: + 'Connect one QuickBooks Online company and read its company profile, vendors, purchase orders, and bills. The connected company is selected during OAuth and cannot be overridden by workflow input.', + docsLink: 'https://docs.sim.ai/integrations/quickbooks', + category: 'tools', + integrationType: IntegrationType.Commerce, + bgColor: '#2CA01C', + icon: QuickBooksIcon, + subBlocks: [ + { + id: 'operation', + title: 'Operation', + type: 'dropdown', + options: [ + { label: 'Get Company Info', id: 'quickbooks_get_company_info' }, + { label: 'List Vendors', id: 'quickbooks_list_vendors' }, + { label: 'List Purchase Orders', id: 'quickbooks_list_purchase_orders' }, + { label: 'List Bills', id: 'quickbooks_list_bills' }, + ], + value: () => 'quickbooks_get_company_info', + }, + { + id: 'credential', + title: 'QuickBooks Account', + type: 'oauth-input', + canonicalParamId: 'oauthCredential', + serviceId: 'quickbooks', + requiredScopes: getScopesForService('quickbooks'), + placeholder: 'Select QuickBooks company', + required: true, + }, + { + id: 'startPosition', + title: 'Start Position', + type: 'short-input', + placeholder: '1', + mode: 'advanced', + condition: { field: 'operation', value: [...LIST_OPERATIONS] }, + value: () => '1', + }, + { + id: 'maxResults', + title: 'Max Results', + type: 'short-input', + placeholder: '25', + mode: 'advanced', + condition: { field: 'operation', value: [...LIST_OPERATIONS] }, + value: () => '25', + }, + ], + tools: { + access: [ + 'quickbooks_get_company_info', + 'quickbooks_list_bills', + 'quickbooks_list_purchase_orders', + 'quickbooks_list_vendors', + ], + config: { + tool: (params) => { + const operation = String(params.operation) + if ( + operation !== 'quickbooks_get_company_info' && + operation !== 'quickbooks_list_vendors' && + operation !== 'quickbooks_list_purchase_orders' && + operation !== 'quickbooks_list_bills' + ) { + throw new Error(`Unknown QuickBooks operation: ${operation}`) + } + return operation + }, + params: (params) => { + const operation = String(params.operation) + if (!LIST_OPERATIONS.includes(operation as (typeof LIST_OPERATIONS)[number])) { + return { credential: params.oauthCredential } + } + return { + credential: params.oauthCredential, + startPosition: parsePaginationInteger(params.startPosition, 'startPosition', 1), + maxResults: parsePaginationInteger(params.maxResults, 'maxResults', 25), + } + }, + }, + }, + inputs: { + operation: { type: 'string', description: 'QuickBooks read operation to perform' }, + oauthCredential: { + type: 'string', + description: 'OAuth credential bound to one QuickBooks company', + }, + startPosition: { + type: 'number', + description: 'One-based position of the first list item to request', + }, + maxResults: { + type: 'number', + description: 'Number of list items to request, from 1 through 100', + }, + }, + outputs: { + company: { + type: 'json', + description: + 'CompanyInfo with Id, CompanyName, LegalName, addresses, contact details, company settings, and MetaData', + condition: { field: 'operation', value: 'quickbooks_get_company_info' }, + }, + items: { + type: 'array', + description: + 'Vendor, PurchaseOrder, or Bill objects with their native QuickBooks fields, references, lines, balances, and MetaData when populated', + condition: { field: 'operation', value: [...LIST_OPERATIONS] }, + }, + startPosition: { + type: 'number', + description: 'One-based position of the first returned list item', + condition: { field: 'operation', value: [...LIST_OPERATIONS] }, + }, + maxResults: { + type: 'number', + description: 'Actual number of items reported for the list response', + condition: { field: 'operation', value: [...LIST_OPERATIONS] }, + }, + nextStartPosition: { + type: 'number', + description: 'Position to pass into an explicit next-page request', + condition: { field: 'operation', value: [...LIST_OPERATIONS] }, + }, + hasMore: { + type: 'boolean', + description: 'Conservative indication that another list page may exist', + condition: { field: 'operation', value: [...LIST_OPERATIONS] }, + }, + time: { + type: 'string', + description: 'QuickBooks response timestamp', + }, + }, +} + +export const QuickBooksBlockMeta = { + tags: ['payments', 'automation', 'data-analytics'], + url: 'https://quickbooks.intuit.com', + templates: [ + { + icon: QuickBooksIcon, + title: 'QuickBooks vendor directory audit', + prompt: + 'Build a scheduled workflow that lists every QuickBooks vendor page, identifies incomplete or inactive vendor records, and writes a read-only audit report to a Sim table.', + modules: ['scheduled', 'tables', 'agent', 'workflows'], + category: 'operations', + tags: ['finance', 'audit', 'procurement'], + }, + { + icon: QuickBooksIcon, + title: 'QuickBooks duplicate vendor review', + prompt: + 'Create a workflow that lists QuickBooks vendors page by page, detects likely duplicates using names and contact details, and produces a review queue without changing vendor records.', + modules: ['tables', 'agent', 'workflows'], + category: 'operations', + tags: ['finance', 'data-quality', 'procurement'], + }, + { + icon: QuickBooksIcon, + title: 'QuickBooks purchase order digest', + prompt: + 'Create a scheduled workflow that lists recent QuickBooks purchase orders, summarizes vendors, dates, lines, and totals, and posts a procurement digest to Slack.', + modules: ['scheduled', 'agent', 'workflows'], + category: 'operations', + tags: ['finance', 'reporting', 'procurement'], + alsoIntegrations: ['slack'], + }, + { + icon: QuickBooksIcon, + title: 'QuickBooks PO-to-bill reconciliation', + prompt: + 'Build a workflow that lists QuickBooks purchase orders and bills, compares vendor references, dates, line details, and totals, and writes suspected mismatches to a review table.', + modules: ['tables', 'agent', 'workflows'], + category: 'operations', + tags: ['finance', 'reconciliation', 'procurement'], + }, + { + icon: QuickBooksIcon, + title: 'QuickBooks unpaid bill report', + prompt: + 'Build a scheduled workflow that lists QuickBooks bills, filters records with a remaining balance, groups them by vendor and due date, and writes an unpaid-payables report.', + modules: ['scheduled', 'tables', 'agent', 'workflows'], + category: 'operations', + tags: ['finance', 'reporting', 'payables'], + }, + { + icon: QuickBooksIcon, + title: 'QuickBooks overdue payable alert', + prompt: + 'Create a daily workflow that lists QuickBooks bills, identifies unpaid balances past their due date, summarizes the urgent items, and posts a read-only alert to Slack.', + modules: ['scheduled', 'agent', 'workflows'], + category: 'operations', + tags: ['finance', 'alerts', 'payables'], + alsoIntegrations: ['slack'], + }, + { + icon: QuickBooksIcon, + title: 'QuickBooks vendor spend summary', + prompt: + 'Create a monthly workflow that lists QuickBooks bills, aggregates bill totals by vendor and currency, compares the current period with prior table snapshots, and produces a vendor-spend summary.', + modules: ['scheduled', 'tables', 'agent', 'workflows'], + category: 'operations', + tags: ['finance', 'analytics', 'procurement'], + }, + ], + skills: [ + { + name: 'audit-vendor-directory', + description: + 'List QuickBooks vendors and report incomplete, inactive, or inconsistent directory records.', + content: + '# Audit a QuickBooks Vendor Directory\n\nReview vendor records without modifying them.\n\n## Steps\n1. Use List Vendors with the default page size.\n2. Continue with `nextStartPosition` while `hasMore` is true.\n3. Check populated vendor identity, contact, address, active-status, currency, and metadata fields.\n4. Report incomplete or inconsistent records for human review.\n\n## Output\nReturn a vendor-audit table with the vendor ID, display name, issue, and supporting field values. Do not claim to merge or update vendors.', + }, + { + name: 'review-duplicate-vendors', + description: 'Find likely duplicate QuickBooks vendors using the read-only vendor directory.', + content: + '# Review Possible Duplicate QuickBooks Vendors\n\nIdentify likely duplicates for human review.\n\n## Steps\n1. List all Vendor pages using `nextStartPosition`.\n2. Compare normalized display names, company names, emails, phones, and addresses.\n3. Rank possible matches by evidence and retain both vendor IDs.\n\n## Output\nReturn duplicate candidates with match evidence and confidence. Do not merge or edit vendor records.', + }, + { + name: 'summarize-purchase-orders', + description: 'Build a digest from QuickBooks purchase order pages.', + content: + '# Summarize QuickBooks Purchase Orders\n\nCreate a read-only procurement digest.\n\n## Steps\n1. Use List Purchase Orders for the requested page.\n2. Continue only when the workflow explicitly needs more pages.\n3. Summarize document number, date, vendor reference, lines, currency, and total where populated.\n\n## Output\nReturn a concise purchase-order digest and include source purchase-order IDs.', + }, + { + name: 'reconcile-pos-to-bills', + description: + 'Compare QuickBooks purchase orders and bills and flag likely reconciliation exceptions.', + content: + '# Reconcile QuickBooks Purchase Orders to Bills\n\nCompare read-only procurement records.\n\n## Steps\n1. List Purchase Orders and Bills for the target period or explicit pages.\n2. Match records using vendor references, document numbers, dates, line descriptions, and amounts.\n3. Flag missing matches, amount differences, currency differences, and duplicate candidates.\n\n## Output\nReturn a reconciliation report with QuickBooks IDs and supporting values. Do not modify bills or close purchase orders.', + }, + { + name: 'report-unpaid-bills', + description: 'Report QuickBooks bills that retain an unpaid balance.', + content: + '# Report Unpaid QuickBooks Bills\n\nCreate a read-only accounts-payable report.\n\n## Steps\n1. List Bills page by page as needed.\n2. Keep bills whose populated `Balance` is greater than zero.\n3. Group by vendor, currency, and due date while retaining bill IDs.\n\n## Output\nReturn unpaid bill details and subtotals. Do not mark bills paid or change due dates.', + }, + { + name: 'alert-overdue-payables', + description: 'Identify overdue QuickBooks bill balances for an alert.', + content: + '# Alert on Overdue QuickBooks Payables\n\nFind overdue items without changing accounting data.\n\n## Steps\n1. List Bills and retain records with a positive balance and a due date before today.\n2. Sort the result by days overdue and balance.\n3. Include vendor reference, document number, due date, currency, balance, and bill ID where populated.\n\n## Output\nReturn an urgency-ranked alert ready for delivery. Do not modify or pay bills.', + }, + { + name: 'summarize-vendor-spend', + description: 'Aggregate QuickBooks bill totals into a vendor-spend summary.', + content: + '# Summarize QuickBooks Vendor Spend\n\nAnalyze bill totals from read-only data.\n\n## Steps\n1. List the required Bill pages.\n2. Group populated totals by vendor reference and currency.\n3. Keep bill IDs so every aggregate can be traced to source records.\n4. State any limitations caused by missing fields or partial pagination.\n\n## Output\nReturn vendor totals, bill counts, currencies, and source coverage. Do not present the result as a general-ledger or payment report.', + }, + ], +} as const satisfies BlockMeta diff --git a/apps/sim/blocks/registry-maps.ts b/apps/sim/blocks/registry-maps.ts index aa4dfac717f..e50b8c1f293 100644 --- a/apps/sim/blocks/registry-maps.ts +++ b/apps/sim/blocks/registry-maps.ts @@ -245,6 +245,7 @@ import { ProspeoBlock, ProspeoBlockMeta } from '@/blocks/blocks/prospeo' import { PulseBlock, PulseBlockMeta, PulseV2Block } from '@/blocks/blocks/pulse' import { QdrantBlock, QdrantBlockMeta } from '@/blocks/blocks/qdrant' import { QuartrBlock, QuartrBlockMeta } from '@/blocks/blocks/quartr' +import { QuickBooksBlock, QuickBooksBlockMeta } from '@/blocks/blocks/quickbooks' import { QuiverBlock, QuiverBlockMeta } from '@/blocks/blocks/quiver' import { RailwayBlock, RailwayBlockMeta } from '@/blocks/blocks/railway' import { RB2BBlock, RB2BBlockMeta } from '@/blocks/blocks/rb2b' @@ -560,6 +561,7 @@ export const BLOCK_REGISTRY: Record = { pulse_v2: PulseV2Block, qdrant: QdrantBlock, quartr: QuartrBlock, + quickbooks: QuickBooksBlock, quiver: QuiverBlock, railway: RailwayBlock, rb2b: RB2BBlock, @@ -853,6 +855,7 @@ export const BLOCK_META_REGISTRY: Record = { pulse: PulseBlockMeta, qdrant: QdrantBlockMeta, quartr: QuartrBlockMeta, + quickbooks: QuickBooksBlockMeta, quiver: QuiverBlockMeta, railway: RailwayBlockMeta, rb2b: RB2BBlockMeta, diff --git a/apps/sim/components/icons.tsx b/apps/sim/components/icons.tsx index efedba2000d..d2bc5089e04 100644 --- a/apps/sim/components/icons.tsx +++ b/apps/sim/components/icons.tsx @@ -2494,6 +2494,25 @@ export function BrexIcon(props: SVGProps) { ) } +/** + * Official QuickBooks circular mark, cropped from the user-supplied + * Intuit_QuickBooks_logo.svg wordmark. + */ +export function QuickBooksIcon(props: SVGProps) { + return ( + + + + + ) +} + export function BrightDataIcon(props: SVGProps) { return ( { + const clientId = env.QUICKBOOKS_CLIENT_ID + const clientSecret = env.QUICKBOOKS_CLIENT_SECRET + if (!clientId || !clientSecret) { + throw new Error('QuickBooks OAuth client credentials are not configured') + } + + const response = await fetch(QUICKBOOKS_TOKEN_URL, { + method: 'POST', + headers: { + Authorization: `Basic ${Buffer.from(`${clientId}:${clientSecret}`).toString('base64')}`, + 'Content-Type': 'application/x-www-form-urlencoded', + }, + body: new URLSearchParams({ + code, + grant_type: 'authorization_code', + redirect_uri: redirectURI, + }), + }) + const data = await readResponseJsonWithLimit>(response, { + maxBytes: QUICKBOOKS_MAX_USER_INFO_BYTES, + label: 'QuickBooks OAuth token response', + }) + + if (!response.ok || !data || typeof data !== 'object' || Array.isArray(data)) { + throw new Error(`QuickBooks OAuth token exchange failed with HTTP ${response.status}`) + } + + const tokens = getOAuth2Tokens(data) + if (!tokens.accessToken || !tokens.refreshToken) { + throw new Error( + 'QuickBooks OAuth token response did not include access and refresh tokens' + ) + } + if (typeof data.scope === 'string') { + tokens.scopes = data.scope.split(/\s+/).filter(Boolean) + } + return tokens + }, + getUserInfo: async (tokens) => { + if (!tokens.accessToken) { + throw new Error('QuickBooks OAuth did not issue an access token') + } + + const profile = await fetchQuickBooksConnectionProfile(tokens.accessToken) + + const now = new Date() + return { + id: profile.accountId, + name: profile.name, + email: profile.email, + emailVerified: profile.emailVerified, + createdAt: now, + updatedAt: now, + } + }, + }, + // Cal.com provider { providerId: 'calcom', diff --git a/apps/sim/lib/core/config/env.ts b/apps/sim/lib/core/config/env.ts index 8c28ba643f8..36e303d32d6 100644 --- a/apps/sim/lib/core/config/env.ts +++ b/apps/sim/lib/core/config/env.ts @@ -412,6 +412,9 @@ export const env = createEnv({ WEALTHBOX_CLIENT_SECRET: z.string().optional(), // WealthBox OAuth client secret PIPEDRIVE_CLIENT_ID: z.string().optional(), // Pipedrive OAuth client ID PIPEDRIVE_CLIENT_SECRET: z.string().optional(), // Pipedrive OAuth client secret + QUICKBOOKS_CLIENT_ID: z.string().optional(), // QuickBooks Online OAuth client ID + QUICKBOOKS_CLIENT_SECRET: z.string().optional(), // QuickBooks Online OAuth client secret + QUICKBOOKS_ENV: z.enum(['sandbox', 'production']).optional(), // QuickBooks Online API environment (defaults to sandbox) LINEAR_CLIENT_ID: z.string().optional(), // Linear OAuth client ID LINEAR_CLIENT_SECRET: z.string().optional(), // Linear OAuth client secret CLICKUP_CLIENT_ID: z.string().optional(), // ClickUp OAuth client ID diff --git a/apps/sim/lib/integrations/icon-mapping.ts b/apps/sim/lib/integrations/icon-mapping.ts index ff7c8965ac8..a926df143d4 100644 --- a/apps/sim/lib/integrations/icon-mapping.ts +++ b/apps/sim/lib/integrations/icon-mapping.ts @@ -175,6 +175,7 @@ import { PulseIcon, QdrantIcon, QuartrIcon, + QuickBooksIcon, QuiverIcon, RailwayIcon, RB2BIcon, @@ -439,6 +440,7 @@ export const blockTypeToIconMap: Record = { pulse_v2: PulseIcon, qdrant: QdrantIcon, quartr: QuartrIcon, + quickbooks: QuickBooksIcon, quiver: QuiverIcon, railway: RailwayIcon, rb2b: RB2BIcon, diff --git a/apps/sim/lib/integrations/integrations.json b/apps/sim/lib/integrations/integrations.json index deadb0012bc..bb832c5e1d4 100644 --- a/apps/sim/lib/integrations/integrations.json +++ b/apps/sim/lib/integrations/integrations.json @@ -14515,6 +14515,42 @@ "integrationType": "analytics", "tags": ["data-analytics", "enrichment", "document-processing"] }, + { + "type": "quickbooks", + "slug": "quickbooks", + "name": "QuickBooks", + "description": "Read procurement data from QuickBooks Online", + "longDescription": "Connect one QuickBooks Online company and read its company profile, vendors, purchase orders, and bills. The connected company is selected during OAuth and cannot be overridden by workflow input.", + "bgColor": "#2CA01C", + "iconName": "QuickBooksIcon", + "docsUrl": "https://docs.sim.ai/integrations/quickbooks", + "operations": [ + { + "name": "Get Company Info", + "description": "Get information about the connected QuickBooks Online company" + }, + { + "name": "List Vendors", + "description": "List vendors in the connected QuickBooks Online company" + }, + { + "name": "List Purchase Orders", + "description": "List purchase orders in the connected QuickBooks Online company" + }, + { + "name": "List Bills", + "description": "List bills in the connected QuickBooks Online company" + } + ], + "operationCount": 4, + "triggers": [], + "triggerCount": 0, + "authType": "oauth", + "oauthServiceId": "quickbooks", + "category": "tools", + "integrationType": "commerce", + "tags": ["payments", "automation", "data-analytics"] + }, { "type": "quiver", "slug": "quiver", diff --git a/apps/sim/lib/oauth/oauth.test.ts b/apps/sim/lib/oauth/oauth.test.ts index d6273e5af40..d930e8f0ca2 100644 --- a/apps/sim/lib/oauth/oauth.test.ts +++ b/apps/sim/lib/oauth/oauth.test.ts @@ -39,6 +39,8 @@ beforeAll(() => { ASANA_CLIENT_SECRET: 'asana_client_secret', PIPEDRIVE_CLIENT_ID: 'pipedrive_client_id', PIPEDRIVE_CLIENT_SECRET: 'pipedrive_client_secret', + QUICKBOOKS_CLIENT_ID: 'quickbooks_client_id', + QUICKBOOKS_CLIENT_SECRET: 'quickbooks_client_secret', HUBSPOT_CLIENT_ID: 'hubspot_client_id', HUBSPOT_CLIENT_SECRET: 'hubspot_client_secret', LINKEDIN_CLIENT_ID: 'linkedin_client_id', @@ -105,6 +107,11 @@ describe('OAuth Token Refresh', () => { providerId: 'reddit', endpoint: 'https://www.reddit.com/api/v1/access_token', }, + { + name: 'QuickBooks', + providerId: 'quickbooks', + endpoint: 'https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer', + }, { name: 'Asana', providerId: 'asana', @@ -380,13 +387,57 @@ describe('OAuth Token Refresh', () => { } }) - it.concurrent('should return failure for Slack-style body errors', async () => { - const mockFetch = vi.fn().mockResolvedValue({ - ok: true, - status: 200, - statusText: 'OK', - json: async () => ({ ok: false, error: 'invalid_refresh_token' }), + it.concurrent('should not expose provider error details or refresh tokens', async () => { + const sensitiveDetail = 'provider-secret-account-detail' + const refreshToken = 'sensitive-refresh-token' + const mockFetch = vi.fn().mockResolvedValue( + Response.json( + { + error: 'invalid_grant', + error_description: sensitiveDetail, + }, + { status: 400 } + ) + ) + + const result = await withMockFetch(mockFetch, () => + refreshOAuthToken('quickbooks', refreshToken) + ) + + expect(result).toEqual({ + ok: false, + errorCode: 'invalid_grant', + message: 'Failed to refresh token: 400 (invalid_grant)', }) + expect(JSON.stringify(result)).not.toContain(sensitiveDetail) + expect(JSON.stringify(result)).not.toContain(refreshToken) + }) + + it.concurrent('should reject oversized token refresh responses', async () => { + const mockFetch = vi.fn().mockResolvedValue( + new Response( + JSON.stringify({ + access_token: 'new_access_token', + padding: 'x'.repeat(DEFAULT_MAX_ERROR_BODY_BYTES), + }) + ) + ) + + const result = await withMockFetch(mockFetch, () => + refreshOAuthToken('quickbooks', 'old_refresh_token') + ) + + expect(result.ok).toBe(false) + if (!result.ok) { + expect(result.message).toContain('exceeds maximum size') + expect(result.message).not.toContain('new_access_token') + } + }) + + it.concurrent('should return failure for Slack-style body errors', async () => { + const mockFetch = vi + .fn() + .mockResolvedValue(Response.json({ ok: false, error: 'invalid_refresh_token' })) const refreshToken = 'test_refresh_token' const result = await withMockFetch(mockFetch, () => refreshOAuthToken('slack', refreshToken)) @@ -408,18 +459,41 @@ describe('OAuth Token Refresh', () => { }) describe('Token Response Handling', () => { + it.concurrent( + 'should preserve QuickBooks one-hour expiry and rotating refresh token', + async () => { + const mockFetch = vi.fn().mockResolvedValue( + Response.json({ + access_token: 'new_quickbooks_access_token', + expires_in: 3600, + refresh_token: 'rotated_quickbooks_refresh_token', + }) + ) + + const result = await withMockFetch(mockFetch, () => + refreshOAuthToken('quickbooks', 'old_quickbooks_refresh_token') + ) + + expect(result).toEqual({ + ok: true, + accessToken: 'new_quickbooks_access_token', + expiresIn: 3600, + refreshToken: 'rotated_quickbooks_refresh_token', + }) + } + ) + it.concurrent('should handle providers that return new refresh tokens', async () => { const refreshToken = 'old_refresh_token' const newRefreshToken = 'new_refresh_token' - const mockFetch = vi.fn().mockResolvedValue({ - ok: true, - json: async () => ({ + const mockFetch = vi.fn().mockResolvedValue( + Response.json({ access_token: 'new_access_token', expires_in: 3600, refresh_token: newRefreshToken, - }), - }) + }) + ) const result = await withMockFetch(mockFetch, () => refreshOAuthToken('airtable', refreshToken) @@ -451,14 +525,13 @@ describe('OAuth Token Refresh', () => { const rotatedRefreshToken = 'rotated_microsoft_refresh_token' for (const providerId of microsoftProviders) { - const mockFetch = vi.fn().mockResolvedValue({ - ok: true, - json: async () => ({ + const mockFetch = vi.fn().mockResolvedValue( + Response.json({ access_token: 'new_access_token', expires_in: 3600, refresh_token: rotatedRefreshToken, - }), - }) + }) + ) const result = await withMockFetch(mockFetch, () => refreshOAuthToken(providerId, oldRefreshToken) @@ -477,13 +550,12 @@ describe('OAuth Token Refresh', () => { it.concurrent('should use original refresh token when new one is not provided', async () => { const refreshToken = 'original_refresh_token' - const mockFetch = vi.fn().mockResolvedValue({ - ok: true, - json: async () => ({ + const mockFetch = vi.fn().mockResolvedValue( + Response.json({ access_token: 'new_access_token', expires_in: 3600, - }), - }) + }) + ) const result = await withMockFetch(mockFetch, () => refreshOAuthToken('google', refreshToken)) @@ -498,12 +570,11 @@ describe('OAuth Token Refresh', () => { it.concurrent('should return failure when access token is missing', async () => { const refreshToken = 'test_refresh_token' - const mockFetch = vi.fn().mockResolvedValue({ - ok: true, - json: async () => ({ + const mockFetch = vi.fn().mockResolvedValue( + Response.json({ expires_in: 3600, - }), - }) + }) + ) const result = await withMockFetch(mockFetch, () => refreshOAuthToken('google', refreshToken)) @@ -513,12 +584,9 @@ describe('OAuth Token Refresh', () => { it.concurrent('should use default expiration when not provided', async () => { const refreshToken = 'test_refresh_token' - const mockFetch = vi.fn().mockResolvedValue({ - ok: true, - json: async () => ({ - access_token: 'new_access_token', - }), - }) + const mockFetch = vi + .fn() + .mockResolvedValue(Response.json({ access_token: 'new_access_token' })) const result = await withMockFetch(mockFetch, () => refreshOAuthToken('google', refreshToken)) diff --git a/apps/sim/lib/oauth/oauth.ts b/apps/sim/lib/oauth/oauth.ts index fc3c6bc7064..f9d76752e65 100644 --- a/apps/sim/lib/oauth/oauth.ts +++ b/apps/sim/lib/oauth/oauth.ts @@ -42,6 +42,7 @@ import { NotionIcon, OutlookIcon, PipedriveIcon, + QuickBooksIcon, RedditIcon, SalesforceIcon, ShopifyIcon, @@ -1008,6 +1009,21 @@ export const OAUTH_PROVIDERS: Record = { }, defaultService: 'pipedrive', }, + quickbooks: { + name: 'QuickBooks', + icon: QuickBooksIcon, + services: { + quickbooks: { + name: 'QuickBooks', + description: 'Read company, vendor, purchase order, and bill data from QuickBooks Online.', + providerId: 'quickbooks', + icon: QuickBooksIcon, + baseProviderIcon: QuickBooksIcon, + scopes: ['openid', 'profile', 'email', 'com.intuit.quickbooks.accounting'], + }, + }, + defaultService: 'quickbooks', + }, hubspot: { name: 'HubSpot', icon: HubspotIcon, @@ -1488,6 +1504,19 @@ function getProviderAuthConfig(provider: string): ProviderAuthConfig { supportsRefreshTokenRotation: true, } } + case 'quickbooks': { + const { clientId, clientSecret } = getCredentials( + env.QUICKBOOKS_CLIENT_ID, + env.QUICKBOOKS_CLIENT_SECRET + ) + return { + tokenEndpoint: 'https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer', + clientId, + clientSecret, + useBasicAuth: true, + supportsRefreshTokenRotation: true, + } + } case 'hubspot': { const { clientId, clientSecret } = getCredentials( env.HUBSPOT_CLIENT_ID, @@ -1788,43 +1817,52 @@ export async function refreshOAuthToken( signal: AbortSignal.timeout(TOKEN_REFRESH_TIMEOUT_MS), }) - if (!response.ok) { - const errorText = await response.text() - let errorData: unknown = errorText - - try { - errorData = JSON.parse(errorText) - } catch (_e) { - // Not JSON, keep as text - } + const responseText = await readResponseTextWithLimit(response, { + maxBytes: DEFAULT_MAX_ERROR_BODY_BYTES, + label: `${provider} token refresh response`, + }) + let responseData: unknown + try { + responseData = JSON.parse(responseText) + } catch { + responseData = null + } + const errorCode = extractErrorCode(responseData) + if (!response.ok) { logger.error('Token refresh failed:', { status: response.status, statusText: response.statusText, - error: errorText, - parsedError: errorData, + errorCode, providerId, tokenEndpoint: config.tokenEndpoint, hasClientId: !!config.clientId, hasClientSecret: !!config.clientSecret, hasRefreshToken: !!refreshToken, - refreshTokenPrefix: refreshToken ? `${refreshToken.substring(0, 10)}...` : 'none', }) return { ok: false, - errorCode: extractErrorCode(errorData), - message: `Failed to refresh token: ${response.status} ${errorText}`, + errorCode, + message: `Failed to refresh token: ${response.status}${errorCode ? ` (${errorCode})` : ''}`, } } - const data = await response.json() + if (!responseData || typeof responseData !== 'object' || Array.isArray(responseData)) { + logger.error('Token refresh returned an invalid response:', { + status: response.status, + providerId, + tokenEndpoint: config.tokenEndpoint, + }) + return { ok: false, message: 'Token refresh returned an invalid response' } + } + const data = responseData as Record - if (data && typeof data === 'object' && data.ok === false) { + if (data.ok === false) { + const providerErrorCode = extractErrorCode(data) logger.error('Token refresh failed:', { status: response.status, statusText: response.statusText, - error: data.error, - parsedError: data, + errorCode: providerErrorCode, providerId, tokenEndpoint: config.tokenEndpoint, hasClientId: !!config.clientId, @@ -1833,23 +1871,30 @@ export async function refreshOAuthToken( }) return { ok: false, - errorCode: typeof data.error === 'string' ? data.error : undefined, - message: `Failed to refresh token: ${data.error ?? 'unknown'}`, + errorCode: providerErrorCode, + message: `Failed to refresh token${providerErrorCode ? `: ${providerErrorCode}` : ''}`, } } - const accessToken = data.access_token + const accessToken = typeof data.access_token === 'string' ? data.access_token : null let newRefreshToken = null - if (config.supportsRefreshTokenRotation && data.refresh_token) { + if (config.supportsRefreshTokenRotation && typeof data.refresh_token === 'string') { newRefreshToken = data.refresh_token logger.info(`Received new refresh token from ${provider}`) } - const expiresIn = data.expires_in || data.expiresIn || 3600 + const expiresInCandidate = data.expires_in ?? data.expiresIn + const expiresIn = + typeof expiresInCandidate === 'number' && Number.isFinite(expiresInCandidate) + ? expiresInCandidate + : 3600 if (!accessToken) { - logger.warn('No access token found in refresh response', { providerId, response: data }) + logger.warn('No access token found in refresh response', { + providerId, + tokenEndpoint: config.tokenEndpoint, + }) return { ok: false, message: 'No access token in refresh response' } } diff --git a/apps/sim/lib/oauth/quickbooks.test.ts b/apps/sim/lib/oauth/quickbooks.test.ts new file mode 100644 index 00000000000..a95c8e296c2 --- /dev/null +++ b/apps/sim/lib/oauth/quickbooks.test.ts @@ -0,0 +1,197 @@ +import { afterEach, describe, expect, it, vi } from 'vitest' +import { + createQuickBooksAccountId, + fetchQuickBooksConnectionProfile, + parseQuickBooksAccountId, + QUICKBOOKS_AUTHORIZATION_URL, + QUICKBOOKS_OIDC_CLAIMS, + QUICKBOOKS_TOKEN_URL, +} from '@/lib/oauth/quickbooks' +import { QUICKBOOKS_MAX_USER_INFO_BYTES } from '@/lib/quickbooks/client' + +const TEST_UUID = '01234567-89ab-4def-8abc-0123456789ab' +const originalFetch = global.fetch + +afterEach(() => { + global.fetch = originalFetch +}) + +describe('QuickBooks account identity', () => { + it('pins the Intuit authorization, token, and realm claim contracts', () => { + expect(QUICKBOOKS_AUTHORIZATION_URL).toBe('https://appcenter.intuit.com/connect/oauth2') + expect(QUICKBOOKS_TOKEN_URL).toBe('https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer') + expect(QUICKBOOKS_OIDC_CLAIMS).toEqual({ + id_token: { realmId: null }, + userinfo: { realmId: null }, + }) + }) + + it('creates and parses the company-scoped external account identity', () => { + const accountId = createQuickBooksAccountId(' 123456789 ', 'intuit-subject', TEST_UUID) + + expect(accountId).toBe(`quickbooks:123456789:intuit-subject-${TEST_UUID}`) + expect(parseQuickBooksAccountId(accountId)).toEqual({ + realmId: '123456789', + subject: 'intuit-subject', + }) + }) + + it('keeps two companies connected by the same Intuit subject distinct', () => { + const first = createQuickBooksAccountId('111', 'same-subject', TEST_UUID) + const second = createQuickBooksAccountId('222', 'same-subject', TEST_UUID) + + expect(first).not.toBe(second) + expect(parseQuickBooksAccountId(first).realmId).toBe('111') + expect(parseQuickBooksAccountId(second).realmId).toBe('222') + }) + + it.each([ + 'quickbooks:123:subject', + 'quickbooks:not-numeric:subject-01234567-89ab-4def-8abc-0123456789ab', + 'other:123:subject-01234567-89ab-4def-8abc-0123456789ab', + 'quickbooks:123:-01234567-89ab-4def-8abc-0123456789ab', + ])('rejects malformed identities with reconnect guidance: %s', (accountId) => { + expect(() => parseQuickBooksAccountId(accountId)).toThrow(/Reconnect the QuickBooks credential/) + }) +}) + +describe('QuickBooks connection profile', () => { + it('uses bounded UserInfo claims and validates the same company before binding', async () => { + const fetchMock = vi + .fn() + .mockResolvedValueOnce( + new Response( + JSON.stringify({ + sub: 'intuit-subject', + realmId: '123456789', + email: 'verified@example.test', + emailVerified: true, + givenName: 'Sanitized', + familyName: 'User', + }) + ) + ) + .mockResolvedValueOnce( + new Response( + JSON.stringify({ + CompanyInfo: { Id: '123456789', CompanyName: 'Sanitized Company' }, + }) + ) + ) + global.fetch = fetchMock + + const result = await fetchQuickBooksConnectionProfile('fresh-access-token') + + expect(result).toMatchObject({ + realmId: '123456789', + subject: 'intuit-subject', + name: 'Sanitized User', + email: 'verified@example.test', + emailVerified: true, + }) + expect(result.accountId).toMatch(/^quickbooks:123456789:intuit-subject-[0-9a-f-]{36}$/i) + expect(fetchMock).toHaveBeenCalledTimes(2) + expect(fetchMock.mock.calls[0][0]).toBe( + 'https://sandbox-accounts.platform.intuit.com/v1/openid_connect/userinfo' + ) + expect(fetchMock.mock.calls[1][0].toString()).toContain( + '/v3/company/123456789/companyinfo/123456789?minorversion=75' + ) + }) + + it('rejects missing realmId without falling back to the callback or ID token', async () => { + const fetchMock = vi.fn().mockResolvedValue( + new Response( + JSON.stringify({ + sub: 'intuit-subject', + email: 'verified@example.test', + emailVerified: true, + givenName: 'Sanitized', + familyName: 'User', + }) + ) + ) + global.fetch = fetchMock + + await expect(fetchQuickBooksConnectionProfile('fresh-access-token')).rejects.toThrow( + 'required user and company identity' + ) + expect(fetchMock).toHaveBeenCalledTimes(1) + }) + + it('rejects a QuickBooks Fault returned with HTTP 200 during company validation', async () => { + const fetchMock = vi + .fn() + .mockResolvedValueOnce( + new Response( + JSON.stringify({ + sub: 'intuit-subject', + realmId: '123456789', + email: 'verified@example.test', + emailVerified: true, + givenName: 'Sanitized', + familyName: 'User', + }) + ) + ) + .mockResolvedValueOnce( + Response.json({ + Fault: { + Error: [ + { + code: '3200', + Message: 'message=ApplicationAuthenticationFailed; errorCode=003200;', + Detail: 'Token expired or invalid', + ignored: 'must not be surfaced', + }, + ], + }, + }) + ) + global.fetch = fetchMock + + await expect(fetchQuickBooksConnectionProfile('fresh-access-token')).rejects.toThrow( + /QuickBooks company validation failed.*3200.*Token expired or invalid.*Reconnect/ + ) + expect(fetchMock).toHaveBeenCalledTimes(2) + }) + + it('requires Intuit to verify the returned email address', async () => { + const fetchMock = vi.fn().mockResolvedValue( + new Response( + JSON.stringify({ + sub: 'intuit-subject', + realmId: '123456789', + email: 'unverified@example.test', + emailVerified: false, + givenName: 'Sanitized', + familyName: 'User', + }) + ) + ) + global.fetch = fetchMock + + await expect(fetchQuickBooksConnectionProfile('fresh-access-token')).rejects.toThrow( + 'verified email address' + ) + expect(fetchMock).toHaveBeenCalledTimes(1) + }) + + it('rejects UserInfo larger than 1 MiB before parsing or company validation', async () => { + const fetchMock = vi.fn().mockResolvedValue( + new Response( + JSON.stringify({ + sub: 'intuit-subject', + realmId: '123456789', + padding: 'x'.repeat(QUICKBOOKS_MAX_USER_INFO_BYTES), + }) + ) + ) + global.fetch = fetchMock + + await expect(fetchQuickBooksConnectionProfile('fresh-access-token')).rejects.toThrow( + /exceeds maximum size/ + ) + expect(fetchMock).toHaveBeenCalledTimes(1) + }) +}) diff --git a/apps/sim/lib/oauth/quickbooks.ts b/apps/sim/lib/oauth/quickbooks.ts new file mode 100644 index 00000000000..b47b516fe62 --- /dev/null +++ b/apps/sim/lib/oauth/quickbooks.ts @@ -0,0 +1,138 @@ +import { generateId } from '@sim/utils/id' +import { + readResponseJsonWithLimit, + readResponseTextWithLimit, +} from '@/lib/core/utils/stream-limits' +import { + fetchValidatedQuickBooksCompanyInfo, + getQuickBooksUserInfoUrl, + QUICKBOOKS_MAX_USER_INFO_BYTES, +} from '@/lib/quickbooks/client' + +const QUICKBOOKS_ACCOUNT_PREFIX = 'quickbooks:' +const QUICKBOOKS_REALM_ID_PATTERN = /^[1-9]\d*$/ +const UUID_SUFFIX_PATTERN = + /-([0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})$/i + +export const QUICKBOOKS_AUTHORIZATION_URL = 'https://appcenter.intuit.com/connect/oauth2' +export const QUICKBOOKS_TOKEN_URL = 'https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer' +export const QUICKBOOKS_OIDC_CLAIMS = { + id_token: { realmId: null }, + userinfo: { realmId: null }, +} as const + +export interface QuickBooksAccountIdentity { + realmId: string + subject: string +} + +export interface QuickBooksConnectionProfile extends QuickBooksAccountIdentity { + accountId: string + name: string + email: string + emailVerified: true +} + +function normalizeRealmId(realmId: string): string { + const normalized = realmId.trim() + if (!QUICKBOOKS_REALM_ID_PATTERN.test(normalized)) { + throw new Error('QuickBooks company identity is invalid. Reconnect the QuickBooks credential.') + } + return normalized +} + +function normalizeSubject(subject: string): string { + const normalized = subject.trim() + if (!normalized || normalized.includes(':')) { + throw new Error('QuickBooks user identity is invalid. Reconnect the QuickBooks credential.') + } + return normalized +} + +export function createQuickBooksAccountId( + realmId: string, + subject: string, + uniqueId = generateId() +): string { + return `${QUICKBOOKS_ACCOUNT_PREFIX}${normalizeRealmId(realmId)}:${normalizeSubject(subject)}-${uniqueId}` +} + +export function parseQuickBooksAccountId(accountId: string): QuickBooksAccountIdentity { + if (!accountId.startsWith(QUICKBOOKS_ACCOUNT_PREFIX)) { + throw new Error('QuickBooks company identity is missing. Reconnect the QuickBooks credential.') + } + + const value = accountId.slice(QUICKBOOKS_ACCOUNT_PREFIX.length) + const separatorIndex = value.indexOf(':') + if (separatorIndex <= 0) { + throw new Error('QuickBooks company identity is invalid. Reconnect the QuickBooks credential.') + } + + const realmId = normalizeRealmId(value.slice(0, separatorIndex)) + const subjectWithUuid = value.slice(separatorIndex + 1) + const uuidMatch = subjectWithUuid.match(UUID_SUFFIX_PATTERN) + if (!uuidMatch) { + throw new Error('QuickBooks company identity is invalid. Reconnect the QuickBooks credential.') + } + + const subject = normalizeSubject(subjectWithUuid.slice(0, -uuidMatch[0].length)) + return { realmId, subject } +} + +export async function fetchQuickBooksConnectionProfile( + accessToken: string +): Promise { + const response = await fetch(getQuickBooksUserInfoUrl(), { + headers: { Authorization: `Bearer ${accessToken}` }, + }) + if (!response.ok) { + await readResponseTextWithLimit(response, { + maxBytes: QUICKBOOKS_MAX_USER_INFO_BYTES, + label: 'QuickBooks UserInfo error response', + }).catch(() => {}) + throw new Error(`QuickBooks UserInfo request failed with HTTP ${response.status}`) + } + + const profile = await readResponseJsonWithLimit<{ + sub?: string + realmId?: string + realmid?: string + name?: string + givenName?: string + familyName?: string + given_name?: string + family_name?: string + email?: string + emailVerified?: boolean + email_verified?: boolean + }>(response, { + maxBytes: QUICKBOOKS_MAX_USER_INFO_BYTES, + label: 'QuickBooks UserInfo response', + }) + + const subject = profile.sub?.trim() + const realmId = (profile.realmId ?? profile.realmid)?.trim() + const email = profile.email?.trim() + const givenName = (profile.givenName ?? profile.given_name)?.trim() + const familyName = (profile.familyName ?? profile.family_name)?.trim() + const name = profile.name?.trim() || [givenName, familyName].filter(Boolean).join(' ') + const emailVerified = profile.emailVerified ?? profile.email_verified ?? false + + if (!subject || !realmId || !email || !name) { + throw new Error('QuickBooks UserInfo did not return the required user and company identity') + } + if (!emailVerified) { + throw new Error('QuickBooks UserInfo did not return a verified email address') + } + + await fetchValidatedQuickBooksCompanyInfo(accessToken, realmId) + + return { + accountId: createQuickBooksAccountId(realmId, subject), + realmId: normalizeRealmId(realmId), + subject: normalizeSubject(subject), + name, + email, + emailVerified: true, + } +} diff --git a/apps/sim/lib/oauth/types.ts b/apps/sim/lib/oauth/types.ts index 40c24fe8547..0a94b1c72c2 100644 --- a/apps/sim/lib/oauth/types.ts +++ b/apps/sim/lib/oauth/types.ts @@ -75,6 +75,7 @@ export type OAuthProvider = | 'asana' | 'attio' | 'pipedrive' + | 'quickbooks' | 'hubspot' | 'salesforce' | 'linkedin' @@ -129,6 +130,7 @@ export type OAuthService = | 'asana' | 'attio' | 'pipedrive' + | 'quickbooks' | 'hubspot' | 'salesforce' | 'linkedin' diff --git a/apps/sim/lib/oauth/utils.test.ts b/apps/sim/lib/oauth/utils.test.ts index acc0945270e..bc5e438c04e 100644 --- a/apps/sim/lib/oauth/utils.test.ts +++ b/apps/sim/lib/oauth/utils.test.ts @@ -71,6 +71,11 @@ describe('getAllOAuthServices', () => { expect(slackService).toBeDefined() expect(slackService?.name).toBe('Slack') expect(slackService?.baseProvider).toBe('slack') + + const quickbooksService = services.find((s) => s.providerId === 'quickbooks') + expect(quickbooksService).toBeDefined() + expect(quickbooksService?.name).toBe('QuickBooks') + expect(quickbooksService?.baseProvider).toBe('quickbooks') }) it.concurrent('should not include duplicate services', () => { @@ -252,6 +257,14 @@ describe('getServiceConfigByProviderId', () => { expect(service?.name).toBe('Slack') }) + it.concurrent('should work for QuickBooks', () => { + const service = getServiceConfigByProviderId('quickbooks') + + expect(service).toBeDefined() + expect(service?.providerId).toBe('quickbooks') + expect(service?.name).toBe('QuickBooks') + }) + it.concurrent('should return service with scopes', () => { const service = getServiceConfigByProviderId('google-drive') @@ -346,6 +359,13 @@ describe('getCanonicalScopesForProvider', () => { expect(excelScopes).toContain('Files.Read') }) + it.concurrent('should return the exact canonical QuickBooks scopes', () => { + const expected = ['openid', 'profile', 'email', 'com.intuit.quickbooks.accounting'] + + expect(getCanonicalScopesForProvider('quickbooks')).toEqual(expected) + expect(getScopesForService('quickbooks')).toEqual(expected) + }) + it.concurrent('should handle providers with empty scopes array', () => { const scopes = getCanonicalScopesForProvider('notion') diff --git a/apps/sim/lib/oauth/utils.ts b/apps/sim/lib/oauth/utils.ts index ce4e754d727..183a0f4e6f2 100644 --- a/apps/sim/lib/oauth/utils.ts +++ b/apps/sim/lib/oauth/utils.ts @@ -86,6 +86,8 @@ export const SCOPE_DESCRIPTIONS: Record = { openid: 'Standard authentication', profile: 'Access profile information', email: 'Access email address', + 'com.intuit.quickbooks.accounting': + 'Read accounting data from the connected QuickBooks Online company', // Notion scopes 'database.read': 'Read database', diff --git a/apps/sim/lib/quickbooks/client.ts b/apps/sim/lib/quickbooks/client.ts new file mode 100644 index 00000000000..2f1e40d09ce --- /dev/null +++ b/apps/sim/lib/quickbooks/client.ts @@ -0,0 +1,119 @@ +import { env } from '@/lib/core/config/env' +import { + readResponseJsonWithLimit, + readResponseTextWithLimit, +} from '@/lib/core/utils/stream-limits' +import { formatQuickBooksFaultDetail, sanitizeQuickBooksFaultData } from '@/lib/quickbooks/fault' + +export const QUICKBOOKS_MINOR_VERSION = '75' +export const QUICKBOOKS_MAX_RESPONSE_BYTES = 8 * 1024 * 1024 +export const QUICKBOOKS_MAX_USER_INFO_BYTES = 1024 * 1024 + +export type QuickBooksEnvironment = 'sandbox' | 'production' + +export function getQuickBooksEnvironment(): QuickBooksEnvironment { + const value = env.QUICKBOOKS_ENV ?? 'sandbox' + if (value !== 'sandbox' && value !== 'production') { + throw new Error('QUICKBOOKS_ENV must be either "sandbox" or "production"') + } + return value +} + +export function getQuickBooksApiBaseUrl(): string { + return getQuickBooksEnvironment() === 'sandbox' + ? 'https://sandbox-quickbooks.api.intuit.com' + : 'https://quickbooks.api.intuit.com' +} + +export function getQuickBooksUserInfoUrl(): string { + return getQuickBooksEnvironment() === 'sandbox' + ? 'https://sandbox-accounts.platform.intuit.com/v1/openid_connect/userinfo' + : 'https://accounts.platform.intuit.com/v1/openid_connect/userinfo' +} + +export function normalizeQuickBooksRealmId(realmId: string): string { + const normalized = realmId.trim() + if (!/^[1-9]\d*$/.test(normalized)) { + throw new Error('QuickBooks company identity is invalid. Reconnect the QuickBooks credential.') + } + return normalized +} + +export function buildQuickBooksCompanyUrl(realmId: string, resource: string): URL { + const normalizedRealmId = normalizeQuickBooksRealmId(realmId) + const url = new URL( + `/v3/company/${encodeURIComponent(normalizedRealmId)}/${resource}`, + getQuickBooksApiBaseUrl() + ) + url.searchParams.set('minorversion', QUICKBOOKS_MINOR_VERSION) + return url +} + +export function buildQuickBooksHeaders(accessToken: string): Record { + const normalizedToken = accessToken.trim() + if (!normalizedToken) { + throw new Error('QuickBooks access token is missing. Reconnect the QuickBooks credential.') + } + return { + Accept: 'application/json', + Authorization: `Bearer ${normalizedToken}`, + } +} + +export interface QuickBooksCompanyInfoEnvelope { + CompanyInfo?: { + Id?: string + CompanyName?: string + LegalName?: string + [key: string]: unknown + } + time?: string +} + +export async function fetchValidatedQuickBooksCompanyInfo( + accessToken: string, + realmId: string +): Promise { + const normalizedRealmId = normalizeQuickBooksRealmId(realmId) + const response = await fetch( + buildQuickBooksCompanyUrl( + normalizedRealmId, + `companyinfo/${encodeURIComponent(normalizedRealmId)}` + ), + { + method: 'GET', + headers: buildQuickBooksHeaders(accessToken), + } + ) + + if (!response.ok) { + await readResponseTextWithLimit(response, { + maxBytes: 64 * 1024, + label: 'QuickBooks CompanyInfo error response', + }).catch(() => {}) + throw new Error(`QuickBooks company validation failed with HTTP ${response.status}`) + } + + const data = await readResponseJsonWithLimit(response, { + maxBytes: QUICKBOOKS_MAX_RESPONSE_BYTES, + label: 'QuickBooks CompanyInfo response', + }) + + const fault = sanitizeQuickBooksFaultData(data) + if (fault) { + const detail = formatQuickBooksFaultDetail(fault) + throw new Error( + ['QuickBooks company validation failed.', detail, 'Reconnect the QuickBooks credential.'] + .filter(Boolean) + .join(' ') + ) + } + + if (!data.CompanyInfo || String(data.CompanyInfo.Id ?? '').trim() !== normalizedRealmId) { + throw new Error( + 'QuickBooks company validation returned a different company. Reconnect the QuickBooks credential.' + ) + } + + return data +} diff --git a/apps/sim/lib/quickbooks/fault.ts b/apps/sim/lib/quickbooks/fault.ts new file mode 100644 index 00000000000..cfcd5aea5f6 --- /dev/null +++ b/apps/sim/lib/quickbooks/fault.ts @@ -0,0 +1,40 @@ +export interface SanitizedQuickBooksFault { + Fault: { + Error: Array> + } +} + +export function sanitizeQuickBooksFaultData(data: unknown): SanitizedQuickBooksFault | null { + if (!data || typeof data !== 'object' || Array.isArray(data)) return null + const fault = (data as Record).Fault + if (!fault || typeof fault !== 'object' || Array.isArray(fault)) return null + const errors = (fault as Record).Error + if (!Array.isArray(errors)) return null + + return { + Fault: { + Error: errors.flatMap((entry) => { + if (!entry || typeof entry !== 'object' || Array.isArray(entry)) return [] + const value = entry as Record + const sanitized = Object.fromEntries( + ['code', 'Message', 'Detail', 'element'].flatMap((key) => + typeof value[key] === 'string' ? [[key, value[key]]] : [] + ) + ) + return Object.keys(sanitized).length > 0 ? [sanitized] : [] + }), + }, + } +} + +export function formatQuickBooksFaultDetail(fault: SanitizedQuickBooksFault): string { + return fault.Fault.Error.map((error) => { + const code = error.code?.trim() ?? '' + const message = error.Message?.trim() ?? '' + const detail = error.Detail?.trim() ?? '' + const text = [message, detail].filter(Boolean).join(': ') + return text ? (code ? `${code}: ${text}` : text) : '' + }) + .filter(Boolean) + .join('; ') +} diff --git a/apps/sim/tools/error-extractors.ts b/apps/sim/tools/error-extractors.ts index 1f1590a9053..8f04bc1b60d 100644 --- a/apps/sim/tools/error-extractors.ts +++ b/apps/sim/tools/error-extractors.ts @@ -25,6 +25,7 @@ export interface ErrorInfo { status?: number statusText?: string data?: any + headers?: { get(name: string): string | null } } export type ErrorExtractor = (errorInfo?: ErrorInfo) => string | null | undefined @@ -36,6 +37,8 @@ interface ErrorExtractorConfig { description: string /** Example APIs that use this pattern */ examples?: string[] + /** Whether this extractor may run in the legacy provider-agnostic fallback chain. */ + useInFallback?: boolean /** The extraction function */ extract: ErrorExtractor } @@ -254,6 +257,44 @@ const ERROR_EXTRACTORS: ErrorExtractorConfig[] = [ return typeof attr === 'string' && attr ? `${detail} (${attr})` : detail }, }, + { + id: 'quickbooks-fault', + description: 'QuickBooks Online Fault.Error[] responses with authentication and rate guidance', + examples: ['QuickBooks Online Accounting API'], + useInFallback: false, + extract: (errorInfo) => { + const status = errorInfo?.status + const fault = sanitizeQuickBooksFaultData(errorInfo?.data) + const faultMessage = fault ? formatQuickBooksFaultDetail(fault) : '' + + const guidance = + status === 401 + ? 'Reconnect the QuickBooks credential.' + : status === 403 + ? 'Confirm the QuickBooks accounting scope and access to this company.' + : status === 429 + ? 'QuickBooks rate limit reached; retry after the indicated delay.' + : '' + const trackingId = + errorInfo?.headers?.get('intuit_tid') ?? + errorInfo?.headers?.get('x-request-id') ?? + errorInfo?.headers?.get('request-id') + const retryAfter = status === 429 ? errorInfo?.headers?.get('retry-after') : null + + const context = [ + trackingId ? `Intuit tracking ID: ${trackingId}` : '', + retryAfter ? `Retry-After: ${retryAfter}` : '', + ] + .filter(Boolean) + .join('; ') + const statusMessage = + typeof status === 'number' + ? `QuickBooks request failed with HTTP ${status}.` + : 'QuickBooks request failed.' + const message = [statusMessage, guidance, faultMessage].filter(Boolean).join(' ') + return context ? `${message} (${context})` : message + }, + }, { id: 'plain-text-data', description: 'Plain text error response', @@ -303,6 +344,7 @@ export function extractErrorMessage(errorInfo?: ErrorInfo, extractorId?: string) // Backwards compatibility for (const extractor of ERROR_EXTRACTORS) { + if (extractor.useInFallback === false) continue try { const message = extractor.extract(errorInfo) if (message?.trim()) { @@ -332,6 +374,9 @@ export const ErrorExtractorId = { OAUTH_ERROR_DESCRIPTION: 'oauth-error-description', NESTED_ERROR_OBJECT: 'nested-error-object', POSTHOG_ERRORS: 'posthog-errors', + QUICKBOOKS_FAULT: 'quickbooks-fault', PLAIN_TEXT_DATA: 'plain-text-data', HTTP_STATUS_TEXT: 'http-status-text', } as const + +import { formatQuickBooksFaultDetail, sanitizeQuickBooksFaultData } from '@/lib/quickbooks/fault' diff --git a/apps/sim/tools/index.test.ts b/apps/sim/tools/index.test.ts index b50f66cfc81..1c9b0e70a66 100644 --- a/apps/sim/tools/index.test.ts +++ b/apps/sim/tools/index.test.ts @@ -198,6 +198,31 @@ const mockRegistryTools: Record = { params: {}, request: { url: '/api/tools/gmail/send', method: 'POST' }, }, + test_quickbooks_context: { + id: 'test_quickbooks_context', + name: 'Test QuickBooks Context', + description: 'Verifies provider context propagation', + version: '1.0.0', + oauth: { required: true, provider: 'quickbooks' }, + errorExtractor: 'quickbooks-fault', + params: { + accessToken: { type: 'string', required: true, visibility: 'hidden' }, + realmId: { type: 'string', required: true, visibility: 'hidden' }, + }, + request: { + url: '/api/tools/test/quickbooks-context', + method: 'POST', + headers: () => ({ 'Content-Type': 'application/json' }), + body: (params: any) => ({ + accessToken: params.accessToken, + realmId: params.realmId, + }), + }, + transformResponse: async (response: Response) => ({ + success: true, + output: await response.json(), + }), + }, test_single_file_tool: { id: 'test_single_file_tool', name: 'Test Single File Tool', @@ -1451,6 +1476,92 @@ describe('Copilot OAuth Credential Enforcement', () => { }) }) +describe('OAuth provider context propagation', () => { + it('copies the QuickBooks realm from the token response into tool parameters', async () => { + mockGenerateInternalToken.mockResolvedValue('internal-token') + const fetchMock = vi.fn().mockImplementation(async (url: string, options?: RequestInit) => { + if (url.includes('/api/auth/oauth/token')) { + return new Response( + JSON.stringify({ + accessToken: 'fresh-access-token', + realmId: '123456789', + }), + { headers: { 'Content-Type': 'application/json' } } + ) + } + + return new Response(options?.body, { + headers: { 'Content-Type': 'application/json' }, + }) + }) + global.fetch = Object.assign(fetchMock, { preconnect: vi.fn() }) as typeof fetch + + const result = await executeTool( + 'test_quickbooks_context', + { credential: 'quickbooks-credential' }, + { + executionContext: createToolExecutionContext({ + userId: 'user-123', + workflowId: 'workflow-123', + }), + } + ) + + expect(result).toMatchObject({ + success: true, + output: { + accessToken: 'fresh-access-token', + realmId: '123456789', + }, + }) + expect(fetchMock).toHaveBeenCalledTimes(2) + }) + + it('does not expose a non-JSON QuickBooks failure body in tool output', async () => { + mockGenerateInternalToken.mockResolvedValue('internal-token') + const fetchMock = vi.fn().mockImplementation(async (url: string) => { + if (url.includes('/api/auth/oauth/token')) { + return new Response( + JSON.stringify({ + accessToken: 'fresh-access-token', + realmId: '123456789', + }), + { headers: { 'Content-Type': 'application/json' } } + ) + } + + return new Response('sensitive gateway body', { + status: 502, + statusText: 'Bad Gateway', + headers: { 'Content-Type': 'text/html' }, + }) + }) + global.fetch = Object.assign(fetchMock, { preconnect: vi.fn() }) as typeof fetch + + const result = await executeTool( + 'test_quickbooks_context', + { credential: 'quickbooks-credential' }, + { + executionContext: createToolExecutionContext({ + userId: 'user-123', + workflowId: 'workflow-123', + }), + } + ) + + expect(result).toMatchObject({ + success: false, + error: 'QuickBooks request failed with HTTP 502.', + output: { + status: 502, + statusText: 'Bad Gateway', + data: null, + }, + }) + expect(JSON.stringify(result)).not.toContain('sensitive gateway body') + }) +}) + describe('Copilot Env Variable Reference Resolution', () => { let cleanupEnvVars: () => void diff --git a/apps/sim/tools/index.ts b/apps/sim/tools/index.ts index f19c4537d88..44dd442b22e 100644 --- a/apps/sim/tools/index.ts +++ b/apps/sim/tools/index.ts @@ -29,6 +29,7 @@ import { isSameOrigin } from '@/lib/core/utils/validation' import { SIM_VIA_HEADER, serializeCallChain } from '@/lib/execution/call-chain' import { parseMcpToolId } from '@/lib/mcp/utils' import { hostedKeyMetrics } from '@/lib/monitoring/metrics' +import { sanitizeQuickBooksFaultData } from '@/lib/quickbooks/fault' import { resolveWorkspaceFileReference } from '@/lib/uploads/contexts/workspace/workspace-file-manager' import { assertPermissionsAllowed } from '@/ee/access-control/utils/permission-check' import { isCustomTool, isMcpTool } from '@/executor/constants' @@ -36,7 +37,7 @@ import { resolveSkillContent } from '@/executor/handlers/agent/skills-resolver' import type { ExecutionContext, UserFile } from '@/executor/types' import { resolveEnvVarReferences } from '@/executor/utils/reference-validation' import type { ErrorInfo } from '@/tools/error-extractors' -import { extractErrorMessage } from '@/tools/error-extractors' +import { ErrorExtractorId, extractErrorMessage } from '@/tools/error-extractors' import type { BYOKProviderId, OAuthTokenPayload, @@ -801,9 +802,6 @@ const MAX_TOOL_RESPONSE_BODY_BYTES = 10 * 1024 * 1024 // 10MB const BODY_SIZE_LIMIT_ERROR_MESSAGE = 'Request body size limit exceeded (10MB). The workflow data is too large to process. Try reducing the size of variables, inputs, or data being passed between blocks.' -const RESPONSE_SIZE_LIMIT_ERROR_MESSAGE = - 'Tool response size limit exceeded (10MB). The response is too large to keep in workflow data. Reduce the response size or return a file reference instead.' - /** * Validates request body size and throws a user-friendly error if exceeded * @param body - The request body string to check @@ -878,7 +876,12 @@ function handleResponseSizeLimitError(error: unknown, requestId: string, context maxBytes: error.maxBytes, observedBytes: error.observedBytes, }) - throw new Error(RESPONSE_SIZE_LIMIT_ERROR_MESSAGE) + const maxSizeMB = (error.maxBytes / (1024 * 1024)).toFixed( + error.maxBytes % (1024 * 1024) === 0 ? 0 : 2 + ) + throw new Error( + `Tool response size limit exceeded (${maxSizeMB}MB). The response is too large to keep in workflow data. Reduce the response size or return a file reference instead.` + ) } function cloneResponseHeaders(headers: Headers | HeadersInit | undefined): Headers { @@ -906,12 +909,13 @@ async function readToolResponseBody( options: { requestId: string toolId: string + maxBytes: number signal?: AbortSignal } ): Promise { try { return await readResponseToBufferWithLimit(response, { - maxBytes: MAX_TOOL_RESPONSE_BODY_BYTES, + maxBytes: options.maxBytes, label: `${options.toolId} response body`, signal: options.signal, allowNoBodyFallback: true, @@ -953,12 +957,16 @@ const MCP_SYSTEM_PARAMETERS = new Set([ * Uses the error extractor registry to find the best error message */ function createTransformedErrorFromErrorInfo(errorInfo?: ErrorInfo, extractorId?: string): Error { - const message = extractErrorMessage(errorInfo, extractorId) + const safeErrorInfo = + extractorId === ErrorExtractorId.QUICKBOOKS_FAULT && errorInfo + ? { ...errorInfo, data: sanitizeQuickBooksFaultData(errorInfo.data) } + : errorInfo + const message = extractErrorMessage(safeErrorInfo, extractorId) const transformed = new Error(message) Object.assign(transformed, { - status: errorInfo?.status, - statusText: errorInfo?.statusText, - data: errorInfo?.data, + status: safeErrorInfo?.status, + statusText: safeErrorInfo?.statusText, + data: safeErrorInfo?.data, }) return transformed } @@ -1240,6 +1248,9 @@ export async function executeTool( if (data.domain && !contextParams.domain) { contextParams.domain = data.domain } + if (data.realmId) { + contextParams.realmId = data.realmId + } if (data.authStyle && !contextParams.authStyle) { contextParams.authStyle = data.authStyle } @@ -1666,6 +1677,7 @@ async function executeToolRequest( const requestId = generateRequestId() const requestParams = formatRequestParams(tool, params) + const maxResponseBytes = tool.request.maxResponseBytes ?? MAX_TOOL_RESPONSE_BODY_BYTES try { const endpointUrl = @@ -1808,6 +1820,7 @@ async function executeToolRequest( const bodyBuffer = await readToolResponseBody(internalResponse, { requestId, toolId, + maxBytes: maxResponseBytes, signal: controller.signal, }) response = new Response(new Uint8Array(bodyBuffer), { @@ -1852,7 +1865,7 @@ async function executeToolRequest( headers: headersRecord, body: requestParams.body ?? undefined, timeout: requestParams.timeout, - maxResponseBytes: MAX_TOOL_RESPONSE_BODY_BYTES, + maxResponseBytes, signal, proxyUrl: proxyOption, stripAuthOnRedirect: requestParams.stripAuthOnRedirect, @@ -1879,6 +1892,7 @@ async function executeToolRequest( const bodyBuffer = await readToolResponseBody(secureResponse, { requestId, toolId, + maxBytes: maxResponseBytes, signal, }) response = new Response(new Uint8Array(bodyBuffer), { @@ -1964,6 +1978,7 @@ async function executeToolRequest( status: response.status, statusText: response.statusText, data: errorData, + headers: response.headers, } const errorToTransform = createTransformedErrorFromErrorInfo(errorInfo, tool.errorExtractor) @@ -1984,7 +1999,7 @@ async function executeToolRequest( logger.error(`[${requestId}] Internal API error for ${toolId}:`, { status: errorInfo.status, - errorData: errorInfo.data, + errorData: (errorToTransform as Error & { data?: unknown }).data, }) throw errorToTransform diff --git a/apps/sim/tools/quickbooks/error-extractor.test.ts b/apps/sim/tools/quickbooks/error-extractor.test.ts new file mode 100644 index 00000000000..40f7fe21e8a --- /dev/null +++ b/apps/sim/tools/quickbooks/error-extractor.test.ts @@ -0,0 +1,71 @@ +import { describe, expect, it } from 'vitest' +import { ErrorExtractorId, extractErrorMessage } from '@/tools/error-extractors' + +describe('QuickBooks fault extraction', () => { + it('parses Fault.Error entries with HTTP and tracking guidance', () => { + const headers = new Headers({ + intuit_tid: 'tracking-id', + }) + + expect( + extractErrorMessage( + { + status: 401, + headers, + data: { + Fault: { + Error: [ + { + code: '3200', + Message: 'Authentication failed', + Detail: 'Token expired', + }, + ], + }, + }, + }, + ErrorExtractorId.QUICKBOOKS_FAULT + ) + ).toBe( + 'QuickBooks request failed with HTTP 401. Reconnect the QuickBooks credential. 3200: Authentication failed: Token expired (Intuit tracking ID: tracking-id)' + ) + }) + + it('preserves Retry-After without exposing a non-JSON response body', () => { + const headers = new Headers({ 'retry-after': '30' }) + + expect( + extractErrorMessage( + { + status: 429, + headers, + data: 'sensitive gateway body', + }, + ErrorExtractorId.QUICKBOOKS_FAULT + ) + ).toBe( + 'QuickBooks request failed with HTTP 429. QuickBooks rate limit reached; retry after the indicated delay. (Retry-After: 30)' + ) + }) + + it('maps forbidden responses to scope and company-access guidance', () => { + expect( + extractErrorMessage({ status: 403, data: null }, ErrorExtractorId.QUICKBOOKS_FAULT) + ).toBe( + 'QuickBooks request failed with HTTP 403. Confirm the QuickBooks accounting scope and access to this company.' + ) + }) + + it('handles empty and non-JSON faults without exposing response bodies', () => { + expect( + extractErrorMessage( + { status: 500, data: 'sensitive gateway body' }, + ErrorExtractorId.QUICKBOOKS_FAULT + ) + ).toBe('QuickBooks request failed with HTTP 500.') + + expect( + extractErrorMessage({ status: 502, data: null }, ErrorExtractorId.QUICKBOOKS_FAULT) + ).toBe('QuickBooks request failed with HTTP 502.') + }) +}) diff --git a/apps/sim/tools/quickbooks/get_company_info.ts b/apps/sim/tools/quickbooks/get_company_info.ts new file mode 100644 index 00000000000..138df409239 --- /dev/null +++ b/apps/sim/tools/quickbooks/get_company_info.ts @@ -0,0 +1,92 @@ +import { + buildQuickBooksCompanyUrl, + normalizeQuickBooksRealmId, + QUICKBOOKS_MAX_RESPONSE_BYTES, +} from '@/lib/quickbooks/client' +import { ErrorExtractorId } from '@/tools/error-extractors' +import type { + QuickBooksAuthParams, + QuickBooksCompanyInfo, + QuickBooksCompanyInfoResponse, +} from '@/tools/quickbooks/types' +import { QUICKBOOKS_COMPANY_INFO_PROPERTIES } from '@/tools/quickbooks/types' +import { getQuickBooksToolHeaders, parseQuickBooksJson } from '@/tools/quickbooks/utils' +import type { ToolConfig } from '@/tools/types' + +interface CompanyInfoEnvelope { + CompanyInfo?: QuickBooksCompanyInfo + time?: string +} + +export const quickbooksGetCompanyInfoTool: ToolConfig< + QuickBooksAuthParams, + QuickBooksCompanyInfoResponse +> = { + id: 'quickbooks_get_company_info', + name: 'QuickBooks Get Company Info', + description: 'Get information about the connected QuickBooks Online company', + version: '1.0.0', + params: { + accessToken: { + type: 'string', + required: true, + visibility: 'hidden', + description: 'QuickBooks OAuth access token', + }, + realmId: { + type: 'string', + required: true, + visibility: 'hidden', + description: 'QuickBooks company ID derived from the connected credential', + }, + }, + oauth: { + required: true, + provider: 'quickbooks', + requiredScopes: ['com.intuit.quickbooks.accounting'], + }, + errorExtractor: ErrorExtractorId.QUICKBOOKS_FAULT, + request: { + url: (params) => { + const realmId = normalizeQuickBooksRealmId(params.realmId) + return buildQuickBooksCompanyUrl( + realmId, + `companyinfo/${encodeURIComponent(realmId)}` + ).toString() + }, + method: 'GET', + headers: (params) => getQuickBooksToolHeaders(params.accessToken), + retry: { enabled: false }, + maxResponseBytes: QUICKBOOKS_MAX_RESPONSE_BYTES, + }, + transformResponse: async (response) => { + const data = await parseQuickBooksJson( + response, + 'QuickBooks CompanyInfo response' + ) + if (!data.CompanyInfo || typeof data.CompanyInfo !== 'object') { + throw new Error('QuickBooks CompanyInfo response is missing CompanyInfo') + } + return { + success: true, + output: { + company: data.CompanyInfo, + time: typeof data.time === 'string' ? data.time : null, + }, + } + }, + outputs: { + company: { + type: 'json', + description: + 'Verified QuickBooks CompanyInfo object, including Id, CompanyName, LegalName, addresses, contact details, NameValue settings, and MetaData when populated', + properties: QUICKBOOKS_COMPANY_INFO_PROPERTIES, + }, + time: { + type: 'string', + description: 'QuickBooks response timestamp', + optional: true, + nullable: true, + }, + }, +} diff --git a/apps/sim/tools/quickbooks/index.ts b/apps/sim/tools/quickbooks/index.ts new file mode 100644 index 00000000000..d2e05a6efcf --- /dev/null +++ b/apps/sim/tools/quickbooks/index.ts @@ -0,0 +1,5 @@ +export { quickbooksGetCompanyInfoTool } from '@/tools/quickbooks/get_company_info' +export { quickbooksListBillsTool } from '@/tools/quickbooks/list_bills' +export { quickbooksListPurchaseOrdersTool } from '@/tools/quickbooks/list_purchase_orders' +export { quickbooksListVendorsTool } from '@/tools/quickbooks/list_vendors' +export * from '@/tools/quickbooks/types' diff --git a/apps/sim/tools/quickbooks/list_bills.ts b/apps/sim/tools/quickbooks/list_bills.ts new file mode 100644 index 00000000000..8fbfbfb4b28 --- /dev/null +++ b/apps/sim/tools/quickbooks/list_bills.ts @@ -0,0 +1,128 @@ +import { QUICKBOOKS_MAX_RESPONSE_BYTES } from '@/lib/quickbooks/client' +import { ErrorExtractorId } from '@/tools/error-extractors' +import type { + QuickBooksBill, + QuickBooksListResponse, + QuickBooksPaginationParams, +} from '@/tools/quickbooks/types' +import { + QUICKBOOKS_LIST_OUTPUTS, + QUICKBOOKS_METADATA_PROPERTIES, + QUICKBOOKS_REFERENCE_PROPERTIES, +} from '@/tools/quickbooks/types' +import { + buildQuickBooksQueryUrl, + getQuickBooksToolHeaders, + transformQuickBooksListResponse, +} from '@/tools/quickbooks/utils' +import type { ToolConfig } from '@/tools/types' + +export const quickbooksListBillsTool: ToolConfig< + QuickBooksPaginationParams, + QuickBooksListResponse +> = { + id: 'quickbooks_list_bills', + name: 'QuickBooks List Bills', + description: 'List bills in the connected QuickBooks Online company', + version: '1.0.0', + params: { + accessToken: { + type: 'string', + required: true, + visibility: 'hidden', + description: 'QuickBooks OAuth access token', + }, + realmId: { + type: 'string', + required: true, + visibility: 'hidden', + description: 'QuickBooks company ID derived from the connected credential', + }, + startPosition: { + type: 'number', + required: true, + visibility: 'user-or-llm', + default: 1, + description: 'One-based position of the first bill to return', + }, + maxResults: { + type: 'number', + required: true, + visibility: 'user-or-llm', + default: 25, + description: 'Number of bills to request (1–100)', + }, + }, + oauth: { + required: true, + provider: 'quickbooks', + requiredScopes: ['com.intuit.quickbooks.accounting'], + }, + errorExtractor: ErrorExtractorId.QUICKBOOKS_FAULT, + request: { + url: (params) => + buildQuickBooksQueryUrl( + params.realmId, + 'Bill', + params.startPosition, + params.maxResults + ).toString(), + method: 'GET', + headers: (params) => getQuickBooksToolHeaders(params.accessToken), + retry: { enabled: false }, + maxResponseBytes: QUICKBOOKS_MAX_RESPONSE_BYTES, + }, + transformResponse: (response, params) => + transformQuickBooksListResponse(response, params!, 'Bill'), + outputs: { + items: { + type: 'array', + description: 'Bill objects returned by QuickBooks', + items: { + type: 'json', + properties: { + Id: { type: 'string', description: 'Bill ID' }, + SyncToken: { type: 'string', description: 'Bill sync token', optional: true }, + DocNumber: { type: 'string', description: 'Bill reference number', optional: true }, + TxnDate: { type: 'string', description: 'Bill transaction date', optional: true }, + DueDate: { type: 'string', description: 'Bill due date', optional: true }, + VendorRef: { + type: 'json', + description: 'Bill vendor reference', + optional: true, + properties: QUICKBOOKS_REFERENCE_PROPERTIES, + }, + APAccountRef: { + type: 'json', + description: 'Accounts payable account reference', + optional: true, + properties: QUICKBOOKS_REFERENCE_PROPERTIES, + }, + CurrencyRef: { + type: 'json', + description: 'Bill currency reference', + optional: true, + properties: QUICKBOOKS_REFERENCE_PROPERTIES, + }, + ExchangeRate: { type: 'number', description: 'Bill exchange rate', optional: true }, + Line: { + type: 'array', + description: 'Bill line items and their detail objects', + optional: true, + items: { type: 'json' }, + }, + TotalAmt: { type: 'number', description: 'Bill total amount', optional: true }, + Balance: { type: 'number', description: 'Unpaid bill balance', optional: true }, + PrivateNote: { type: 'string', description: 'Private bill note', optional: true }, + MetaData: { + type: 'json', + description: 'Bill creation and update timestamps', + optional: true, + properties: QUICKBOOKS_METADATA_PROPERTIES, + }, + }, + }, + }, + ...QUICKBOOKS_LIST_OUTPUTS, + }, +} diff --git a/apps/sim/tools/quickbooks/list_purchase_orders.ts b/apps/sim/tools/quickbooks/list_purchase_orders.ts new file mode 100644 index 00000000000..a21efa4d879 --- /dev/null +++ b/apps/sim/tools/quickbooks/list_purchase_orders.ts @@ -0,0 +1,132 @@ +import { QUICKBOOKS_MAX_RESPONSE_BYTES } from '@/lib/quickbooks/client' +import { ErrorExtractorId } from '@/tools/error-extractors' +import type { + QuickBooksListResponse, + QuickBooksPaginationParams, + QuickBooksPurchaseOrder, +} from '@/tools/quickbooks/types' +import { + QUICKBOOKS_LIST_OUTPUTS, + QUICKBOOKS_METADATA_PROPERTIES, + QUICKBOOKS_REFERENCE_PROPERTIES, +} from '@/tools/quickbooks/types' +import { + buildQuickBooksQueryUrl, + getQuickBooksToolHeaders, + transformQuickBooksListResponse, +} from '@/tools/quickbooks/utils' +import type { ToolConfig } from '@/tools/types' + +export const quickbooksListPurchaseOrdersTool: ToolConfig< + QuickBooksPaginationParams, + QuickBooksListResponse +> = { + id: 'quickbooks_list_purchase_orders', + name: 'QuickBooks List Purchase Orders', + description: 'List purchase orders in the connected QuickBooks Online company', + version: '1.0.0', + params: { + accessToken: { + type: 'string', + required: true, + visibility: 'hidden', + description: 'QuickBooks OAuth access token', + }, + realmId: { + type: 'string', + required: true, + visibility: 'hidden', + description: 'QuickBooks company ID derived from the connected credential', + }, + startPosition: { + type: 'number', + required: true, + visibility: 'user-or-llm', + default: 1, + description: 'One-based position of the first purchase order to return', + }, + maxResults: { + type: 'number', + required: true, + visibility: 'user-or-llm', + default: 25, + description: 'Number of purchase orders to request (1–100)', + }, + }, + oauth: { + required: true, + provider: 'quickbooks', + requiredScopes: ['com.intuit.quickbooks.accounting'], + }, + errorExtractor: ErrorExtractorId.QUICKBOOKS_FAULT, + request: { + url: (params) => + buildQuickBooksQueryUrl( + params.realmId, + 'PurchaseOrder', + params.startPosition, + params.maxResults + ).toString(), + method: 'GET', + headers: (params) => getQuickBooksToolHeaders(params.accessToken), + retry: { enabled: false }, + maxResponseBytes: QUICKBOOKS_MAX_RESPONSE_BYTES, + }, + transformResponse: (response, params) => + transformQuickBooksListResponse(response, params!, 'PurchaseOrder'), + outputs: { + items: { + type: 'array', + description: 'PurchaseOrder objects returned by QuickBooks', + items: { + type: 'json', + properties: { + Id: { type: 'string', description: 'Purchase order ID' }, + SyncToken: { type: 'string', description: 'Purchase order sync token', optional: true }, + DocNumber: { type: 'string', description: 'Purchase order number', optional: true }, + TxnDate: { type: 'string', description: 'Purchase order date', optional: true }, + VendorRef: { + type: 'json', + description: 'Purchase order vendor reference', + optional: true, + properties: QUICKBOOKS_REFERENCE_PROPERTIES, + }, + CurrencyRef: { + type: 'json', + description: 'Purchase order currency reference', + optional: true, + properties: QUICKBOOKS_REFERENCE_PROPERTIES, + }, + ExchangeRate: { + type: 'number', + description: 'Purchase order exchange rate', + optional: true, + }, + Line: { + type: 'array', + description: 'Purchase order line items and their detail objects', + optional: true, + items: { type: 'json' }, + }, + TotalAmt: { + type: 'number', + description: 'Purchase order total amount', + optional: true, + }, + PrivateNote: { + type: 'string', + description: 'Private purchase order note', + optional: true, + }, + MetaData: { + type: 'json', + description: 'Purchase order creation and update timestamps', + optional: true, + properties: QUICKBOOKS_METADATA_PROPERTIES, + }, + }, + }, + }, + ...QUICKBOOKS_LIST_OUTPUTS, + }, +} diff --git a/apps/sim/tools/quickbooks/list_vendors.ts b/apps/sim/tools/quickbooks/list_vendors.ts new file mode 100644 index 00000000000..6ffc26ec3a0 --- /dev/null +++ b/apps/sim/tools/quickbooks/list_vendors.ts @@ -0,0 +1,130 @@ +import { QUICKBOOKS_MAX_RESPONSE_BYTES } from '@/lib/quickbooks/client' +import { ErrorExtractorId } from '@/tools/error-extractors' +import type { + QuickBooksListResponse, + QuickBooksPaginationParams, + QuickBooksVendor, +} from '@/tools/quickbooks/types' +import { + QUICKBOOKS_LIST_OUTPUTS, + QUICKBOOKS_METADATA_PROPERTIES, + QUICKBOOKS_REFERENCE_PROPERTIES, +} from '@/tools/quickbooks/types' +import { + buildQuickBooksQueryUrl, + getQuickBooksToolHeaders, + transformQuickBooksListResponse, +} from '@/tools/quickbooks/utils' +import type { ToolConfig } from '@/tools/types' + +export const quickbooksListVendorsTool: ToolConfig< + QuickBooksPaginationParams, + QuickBooksListResponse +> = { + id: 'quickbooks_list_vendors', + name: 'QuickBooks List Vendors', + description: 'List vendors in the connected QuickBooks Online company', + version: '1.0.0', + params: { + accessToken: { + type: 'string', + required: true, + visibility: 'hidden', + description: 'QuickBooks OAuth access token', + }, + realmId: { + type: 'string', + required: true, + visibility: 'hidden', + description: 'QuickBooks company ID derived from the connected credential', + }, + startPosition: { + type: 'number', + required: true, + visibility: 'user-or-llm', + default: 1, + description: 'One-based position of the first vendor to return', + }, + maxResults: { + type: 'number', + required: true, + visibility: 'user-or-llm', + default: 25, + description: 'Number of vendors to request (1–100)', + }, + }, + oauth: { + required: true, + provider: 'quickbooks', + requiredScopes: ['com.intuit.quickbooks.accounting'], + }, + errorExtractor: ErrorExtractorId.QUICKBOOKS_FAULT, + request: { + url: (params) => + buildQuickBooksQueryUrl( + params.realmId, + 'Vendor', + params.startPosition, + params.maxResults + ).toString(), + method: 'GET', + headers: (params) => getQuickBooksToolHeaders(params.accessToken), + retry: { enabled: false }, + maxResponseBytes: QUICKBOOKS_MAX_RESPONSE_BYTES, + }, + transformResponse: (response, params) => + transformQuickBooksListResponse(response, params!, 'Vendor'), + outputs: { + items: { + type: 'array', + description: 'Vendor objects returned by QuickBooks', + items: { + type: 'json', + properties: { + Id: { type: 'string', description: 'Vendor ID' }, + SyncToken: { type: 'string', description: 'Vendor sync token', optional: true }, + DisplayName: { type: 'string', description: 'Vendor display name', optional: true }, + CompanyName: { type: 'string', description: 'Vendor company name', optional: true }, + GivenName: { type: 'string', description: 'Vendor given name', optional: true }, + FamilyName: { type: 'string', description: 'Vendor family name', optional: true }, + PrintOnCheckName: { + type: 'string', + description: 'Name printed on checks', + optional: true, + }, + Active: { type: 'boolean', description: 'Whether the vendor is active', optional: true }, + Vendor1099: { + type: 'boolean', + description: 'Whether the vendor is tracked for 1099 reporting', + optional: true, + }, + BillAddr: { type: 'json', description: 'Vendor billing address', optional: true }, + PrimaryPhone: { + type: 'json', + description: 'Vendor primary phone details', + optional: true, + }, + PrimaryEmailAddr: { + type: 'json', + description: 'Vendor primary email details', + optional: true, + }, + Balance: { type: 'number', description: 'Vendor balance', optional: true }, + CurrencyRef: { + type: 'json', + description: 'Vendor currency reference', + optional: true, + properties: QUICKBOOKS_REFERENCE_PROPERTIES, + }, + MetaData: { + type: 'json', + description: 'Vendor creation and update timestamps', + optional: true, + properties: QUICKBOOKS_METADATA_PROPERTIES, + }, + }, + }, + }, + ...QUICKBOOKS_LIST_OUTPUTS, + }, +} diff --git a/apps/sim/tools/quickbooks/quickbooks.test.ts b/apps/sim/tools/quickbooks/quickbooks.test.ts new file mode 100644 index 00000000000..fd3fbdc9ed7 --- /dev/null +++ b/apps/sim/tools/quickbooks/quickbooks.test.ts @@ -0,0 +1,440 @@ +import { resetEnvMock, setEnv } from '@sim/testing' +import { afterEach, beforeEach, describe, expect, it } from 'vitest' +import { + fetchValidatedQuickBooksCompanyInfo, + getQuickBooksEnvironment, + getQuickBooksUserInfoUrl, + QUICKBOOKS_MAX_RESPONSE_BYTES, +} from '@/lib/quickbooks/client' +import { QuickBooksBlock } from '@/blocks/blocks/quickbooks' +import { quickbooksGetCompanyInfoTool } from '@/tools/quickbooks/get_company_info' +import { quickbooksListBillsTool } from '@/tools/quickbooks/list_bills' +import { quickbooksListPurchaseOrdersTool } from '@/tools/quickbooks/list_purchase_orders' +import { quickbooksListVendorsTool } from '@/tools/quickbooks/list_vendors' +import { + buildQuickBooksQueryUrl, + transformQuickBooksListResponse, + validateQuickBooksPagination, +} from '@/tools/quickbooks/utils' + +const authParams = { + accessToken: 'access-token', + realmId: '123456789', +} + +beforeEach(() => { + setEnv({ QUICKBOOKS_ENV: 'sandbox' }) +}) + +afterEach(resetEnvMock) + +describe('QuickBooks request construction', () => { + it('selects the sandbox and production hosts only from QUICKBOOKS_ENV', () => { + const sandboxUrl = buildQuickBooksQueryUrl('123', 'Vendor', 1, 25) + expect(sandboxUrl.origin).toBe('https://sandbox-quickbooks.api.intuit.com') + + setEnv({ QUICKBOOKS_ENV: 'production' }) + const productionUrl = buildQuickBooksQueryUrl('123', 'Vendor', 1, 25) + expect(productionUrl.origin).toBe('https://quickbooks.api.intuit.com') + expect(getQuickBooksUserInfoUrl()).toBe( + 'https://accounts.platform.intuit.com/v1/openid_connect/userinfo' + ) + }) + + it('defaults to sandbox and rejects an invalid environment at the API boundary', () => { + setEnv({ QUICKBOOKS_ENV: undefined }) + expect(getQuickBooksEnvironment()).toBe('sandbox') + + setEnv({ QUICKBOOKS_ENV: 'staging' }) + expect(() => getQuickBooksEnvironment()).toThrow( + 'QUICKBOOKS_ENV must be either "sandbox" or "production"' + ) + }) + + it('encodes the fixed query and pins minor version 75', () => { + const url = buildQuickBooksQueryUrl(' 123456789 ', 'PurchaseOrder', 4, 50) + + expect(url.pathname).toBe('/v3/company/123456789/query') + expect(url.searchParams.get('minorversion')).toBe('75') + expect(url.searchParams.get('query')).toBe( + 'SELECT * FROM PurchaseOrder STARTPOSITION 4 MAXRESULTS 50' + ) + }) + + it.each([ + [0, 25], + [-1, 25], + [1.5, 25], + [1, 0], + [1, -1], + [1, 100.5], + [1, 101], + ])('rejects invalid pagination (%s, %s)', (startPosition, maxResults) => { + expect(() => validateQuickBooksPagination(startPosition, maxResults)).toThrow() + }) + + it.each([ + [1, 1], + [1, 100], + [42, 25], + ])('accepts bounded integer pagination (%s, %s)', (startPosition, maxResults) => { + expect(validateQuickBooksPagination(startPosition, maxResults)).toEqual({ + startPosition, + maxResults, + }) + }) +}) + +describe('QuickBooks response contracts', () => { + it('validates CompanyInfo against the requested realm before accepting a connection', async () => { + const originalFetch = global.fetch + global.fetch = async () => + new Response( + JSON.stringify({ + CompanyInfo: { Id: '123456789', CompanyName: 'Sanitized Company' }, + time: 'test-time', + }) + ) + + try { + await expect( + fetchValidatedQuickBooksCompanyInfo('access-token', '123456789') + ).resolves.toMatchObject({ + CompanyInfo: { Id: '123456789' }, + }) + await expect(fetchValidatedQuickBooksCompanyInfo('access-token', '999')).rejects.toThrow( + 'different company' + ) + } finally { + global.fetch = originalFetch + } + }) + + it('preserves populated entity objects and derives conservative pagination', async () => { + const response = new Response( + JSON.stringify({ + QueryResponse: { + Vendor: [ + { + Id: '7', + DisplayName: 'Sanitized Vendor', + PrimaryEmailAddr: { Address: 'vendor@example.test' }, + }, + ], + startPosition: 2, + maxResults: 1, + }, + time: '2026-01-01T00:00:00.000Z', + }) + ) + + const result = await transformQuickBooksListResponse( + response, + { ...authParams, startPosition: 2, maxResults: 1 }, + 'Vendor' + ) + + expect(result.output).toEqual({ + items: [ + { + Id: '7', + DisplayName: 'Sanitized Vendor', + PrimaryEmailAddr: { Address: 'vendor@example.test' }, + }, + ], + startPosition: 2, + maxResults: 1, + nextStartPosition: 3, + hasMore: true, + time: '2026-01-01T00:00:00.000Z', + }) + }) + + it.each([ + ['Vendor', { Id: '7', DisplayName: 'Sanitized Vendor' }], + ['PurchaseOrder', { Id: '8', DocNumber: 'PO-SANITIZED', TotalAmt: 42 }], + ['Bill', { Id: '9', DocNumber: 'BILL-SANITIZED', Balance: 12 }], + ] as const)( + 'preserves a populated %s wrapper with optional fields absent', + async (entity, item) => { + const result = await transformQuickBooksListResponse( + new Response( + JSON.stringify({ + QueryResponse: { + [entity]: [item], + startPosition: 1, + maxResults: 1, + }, + }) + ), + { ...authParams, startPosition: 1, maxResults: 1 }, + entity + ) + + expect(result.output.items).toEqual([item]) + expect(result.output.hasMore).toBe(true) + expect(result.output.time).toBeNull() + } + ) + + it.each(['Vendor', 'PurchaseOrder', 'Bill'] as const)( + 'handles an empty %s page without inventing a total count', + async (entity) => { + const result = await transformQuickBooksListResponse( + new Response(JSON.stringify({ QueryResponse: {}, time: 'test-time' })), + { ...authParams, startPosition: 11, maxResults: 25 }, + entity + ) + + expect(result.output).toEqual({ + items: [], + startPosition: 11, + maxResults: 0, + nextStartPosition: 11, + hasMore: false, + time: 'test-time', + }) + expect(result.output).not.toHaveProperty('totalCount') + } + ) + + it('handles an empty QueryResponse without inventing a total count', async () => { + const response = new Response(JSON.stringify({ QueryResponse: {}, time: 'test-time' })) + const result = await transformQuickBooksListResponse( + response, + { ...authParams, startPosition: 11, maxResults: 25 }, + 'Bill' + ) + + expect(result.output).toEqual({ + items: [], + startPosition: 11, + maxResults: 0, + nextStartPosition: 11, + hasMore: false, + time: 'test-time', + }) + expect(result.output).not.toHaveProperty('totalCount') + }) + + it('rejects malformed wrappers and entity lists', async () => { + await expect( + transformQuickBooksListResponse( + new Response(JSON.stringify({})), + { ...authParams, startPosition: 1, maxResults: 25 }, + 'Vendor' + ) + ).rejects.toThrow('missing QueryResponse') + + await expect( + transformQuickBooksListResponse( + new Response(JSON.stringify({ QueryResponse: { Vendor: {} } })), + { ...authParams, startPosition: 1, maxResults: 25 }, + 'Vendor' + ) + ).rejects.toThrow('malformed entity list') + }) + + it('rejects a success body over the 8 MiB cap before JSON parsing', async () => { + const oversized = JSON.stringify({ + QueryResponse: { Vendor: [{ Id: '1', padding: 'x'.repeat(QUICKBOOKS_MAX_RESPONSE_BYTES) }] }, + }) + + await expect( + transformQuickBooksListResponse( + new Response(oversized), + { ...authParams, startPosition: 1, maxResults: 25 }, + 'Vendor' + ) + ).rejects.toThrow(/exceeds maximum size/) + }) + + it.each(['Vendor', 'PurchaseOrder', 'Bill'] as const)( + 'recognizes a QuickBooks Fault in an HTTP 200 %s response', + async (entity) => { + const response = new Response( + JSON.stringify({ + Fault: { + Error: [ + { + code: '6000', + Message: 'A business validation error occurred', + Detail: 'Sanitized fault detail', + }, + ], + }, + }), + { + status: 200, + headers: { intuit_tid: 'tracking-id' }, + } + ) + + await expect( + transformQuickBooksListResponse( + response, + { ...authParams, startPosition: 1, maxResults: 25 }, + entity + ) + ).rejects.toThrow( + 'QuickBooks request failed with HTTP 200. 6000: A business validation error occurred: Sanitized fault detail (Intuit tracking ID: tracking-id)' + ) + } + ) +}) + +describe('QuickBooks tool boundaries', () => { + const tools = [ + quickbooksGetCompanyInfoTool, + quickbooksListBillsTool, + quickbooksListPurchaseOrdersTool, + quickbooksListVendorsTool, + ] + + it('declares exactly four read-only tools with hidden company credentials and no retries', () => { + expect(tools.map((tool) => tool.id).sort()).toEqual([ + 'quickbooks_get_company_info', + 'quickbooks_list_bills', + 'quickbooks_list_purchase_orders', + 'quickbooks_list_vendors', + ]) + for (const tool of tools) { + expect(tool.params.accessToken).toMatchObject({ required: true, visibility: 'hidden' }) + expect(tool.params.realmId).toMatchObject({ required: true, visibility: 'hidden' }) + expect(tool.request.method).toBe('GET') + expect(tool.request.retry).toEqual({ enabled: false }) + expect(tool.request.maxResponseBytes).toBe(QUICKBOOKS_MAX_RESPONSE_BYTES) + expect(tool.postProcess).toBeUndefined() + } + }) + + it('uses the connected realm for CompanyInfo and preserves its native object', async () => { + const url = quickbooksGetCompanyInfoTool.request.url + expect(typeof url).toBe('function') + expect((url as (params: typeof authParams) => string)(authParams)).toBe( + 'https://sandbox-quickbooks.api.intuit.com/v3/company/123456789/companyinfo/123456789?minorversion=75' + ) + + const result = await quickbooksGetCompanyInfoTool.transformResponse!( + new Response( + JSON.stringify({ + CompanyInfo: { Id: '123456789', CompanyName: 'Sanitized Company' }, + time: 'test-time', + }) + ) + ) + expect(result.output).toEqual({ + company: { Id: '123456789', CompanyName: 'Sanitized Company' }, + time: 'test-time', + }) + }) + + it('rejects an empty CompanyInfo wrapper', async () => { + await expect( + quickbooksGetCompanyInfoTool.transformResponse!( + new Response(JSON.stringify({ time: 'test-time' })) + ) + ).rejects.toThrow('missing CompanyInfo') + }) + + it('recognizes a QuickBooks Fault in an HTTP 200 CompanyInfo response', async () => { + await expect( + quickbooksGetCompanyInfoTool.transformResponse!( + new Response( + JSON.stringify({ + Fault: { + Error: [ + { + code: '3200', + Message: 'Authentication failed', + Detail: 'Sanitized fault detail', + }, + ], + }, + }), + { status: 200 } + ) + ) + ).rejects.toThrow( + 'QuickBooks request failed with HTTP 200. 3200: Authentication failed: Sanitized fault detail' + ) + }) + + it('constructs one fixed query for each list tool', () => { + const listParams = { ...authParams, startPosition: 3, maxResults: 25 } + const cases = [ + [quickbooksListVendorsTool, 'Vendor'], + [quickbooksListPurchaseOrdersTool, 'PurchaseOrder'], + [quickbooksListBillsTool, 'Bill'], + ] as const + + for (const [tool, entity] of cases) { + const requestUrl = tool.request.url as (params: typeof listParams) => string + const url = new URL(requestUrl(listParams)) + expect(url.pathname).toBe('/v3/company/123456789/query') + expect(url.searchParams.get('query')).toBe( + `SELECT * FROM ${entity} STARTPOSITION 3 MAXRESULTS 25` + ) + expect(url.searchParams.get('minorversion')).toBe('75') + } + }) +}) + +describe('QuickBooks block mapping', () => { + it('exposes only the four fixed actions and their OAuth credential', () => { + const operation = QuickBooksBlock.subBlocks.find((subBlock) => subBlock.id === 'operation') + const credentialInputs = QuickBooksBlock.subBlocks.filter((subBlock) => + ['oauth-input', 'short-input'].includes(subBlock.type) + ) + + expect(operation?.options).toEqual([ + { label: 'Get Company Info', id: 'quickbooks_get_company_info' }, + { label: 'List Vendors', id: 'quickbooks_list_vendors' }, + { label: 'List Purchase Orders', id: 'quickbooks_list_purchase_orders' }, + { label: 'List Bills', id: 'quickbooks_list_bills' }, + ]) + expect(credentialInputs.filter((input) => input.id === 'credential')).toHaveLength(1) + expect(QuickBooksBlock.subBlocks.some((input) => input.id === 'realmId')).toBe(false) + expect(QuickBooksBlock.tools.access).toHaveLength(4) + }) + + it('coerces list pagination after parameter resolution and omits it for CompanyInfo', () => { + expect( + QuickBooksBlock.tools.config!.params!({ + operation: 'quickbooks_list_bills', + oauthCredential: 'credential-id', + startPosition: '3', + maxResults: '100', + }) + ).toEqual({ + credential: 'credential-id', + startPosition: 3, + maxResults: 100, + }) + + expect( + QuickBooksBlock.tools.config!.params!({ + operation: 'quickbooks_get_company_info', + oauthCredential: 'credential-id', + startPosition: 'invalid', + maxResults: 'invalid', + }) + ).toEqual({ credential: 'credential-id' }) + }) + + it.each([ + ['1.5', '25'], + ['0', '25'], + ['1', '101'], + ['1', '-1'], + ])('rejects invalid resolved pagination (%s, %s)', (startPosition, maxResults) => { + expect(() => + QuickBooksBlock.tools.config!.params!({ + operation: 'quickbooks_list_vendors', + oauthCredential: 'credential-id', + startPosition, + maxResults, + }) + ).toThrow() + }) +}) diff --git a/apps/sim/tools/quickbooks/types.ts b/apps/sim/tools/quickbooks/types.ts new file mode 100644 index 00000000000..336c3a433a2 --- /dev/null +++ b/apps/sim/tools/quickbooks/types.ts @@ -0,0 +1,224 @@ +import type { OutputProperty, ToolResponse } from '@/tools/types' + +export interface QuickBooksReference { + value?: string + name?: string +} + +export interface QuickBooksAddress { + Id?: string + Line1?: string + Line2?: string + Line3?: string + Line4?: string + Line5?: string + City?: string + Country?: string + CountrySubDivisionCode?: string + PostalCode?: string + Lat?: string + Long?: string +} + +export interface QuickBooksEmailAddress { + Address?: string +} + +export interface QuickBooksPhoneNumber { + FreeFormNumber?: string +} + +export interface QuickBooksMetaData { + CreateTime?: string + LastUpdatedTime?: string +} + +export interface QuickBooksCompanyInfo { + Id: string + SyncToken?: string + CompanyName?: string + LegalName?: string + CompanyAddr?: QuickBooksAddress + CustomerCommunicationAddr?: QuickBooksAddress + LegalAddr?: QuickBooksAddress + PrimaryPhone?: QuickBooksPhoneNumber + Email?: QuickBooksEmailAddress + WebAddr?: { URI?: string } + CompanyStartDate?: string + Country?: string + FiscalYearStartMonth?: string + SupportedLanguages?: string + DefaultTimeZone?: string + NameValue?: Array<{ Name?: string; Value?: string }> + MetaData?: QuickBooksMetaData + [key: string]: unknown +} + +export interface QuickBooksVendor { + Id: string + SyncToken?: string + DisplayName?: string + CompanyName?: string + GivenName?: string + MiddleName?: string + FamilyName?: string + Suffix?: string + Title?: string + PrintOnCheckName?: string + Active?: boolean + Vendor1099?: boolean + BillAddr?: QuickBooksAddress + PrimaryPhone?: QuickBooksPhoneNumber + Mobile?: QuickBooksPhoneNumber + Fax?: QuickBooksPhoneNumber + AlternatePhone?: QuickBooksPhoneNumber + PrimaryEmailAddr?: QuickBooksEmailAddress + WebAddr?: { URI?: string } + Balance?: number + CurrencyRef?: QuickBooksReference + AcctNum?: string + TaxIdentifier?: string + TermRef?: QuickBooksReference + MetaData?: QuickBooksMetaData + sparse?: boolean + [key: string]: unknown +} + +export interface QuickBooksTransaction { + Id: string + SyncToken?: string + DocNumber?: string + TxnDate?: string + DueDate?: string + VendorRef?: QuickBooksReference + APAccountRef?: QuickBooksReference + CurrencyRef?: QuickBooksReference + ExchangeRate?: number + Line?: Array> + TotalAmt?: number + Balance?: number + PrivateNote?: string + TxnTaxDetail?: Record + MetaData?: QuickBooksMetaData + sparse?: boolean + [key: string]: unknown +} + +export type QuickBooksPurchaseOrder = QuickBooksTransaction +export type QuickBooksBill = QuickBooksTransaction + +export interface QuickBooksAuthParams { + accessToken: string + realmId: string +} + +export interface QuickBooksPaginationParams extends QuickBooksAuthParams { + startPosition: number + maxResults: number +} + +export interface QuickBooksCompanyInfoResponse extends ToolResponse { + output: { + company: QuickBooksCompanyInfo + time: string | null + } +} + +export interface QuickBooksListResponse extends ToolResponse { + output: { + items: T[] + startPosition: number + maxResults: number + nextStartPosition: number + hasMore: boolean + time: string | null + } +} + +export type QuickBooksResponse = + | QuickBooksCompanyInfoResponse + | QuickBooksListResponse + +export const QUICKBOOKS_REFERENCE_PROPERTIES: Record = { + value: { type: 'string', description: 'QuickBooks entity ID', optional: true }, + name: { type: 'string', description: 'QuickBooks entity display name', optional: true }, +} + +export const QUICKBOOKS_METADATA_PROPERTIES: Record = { + CreateTime: { type: 'string', description: 'Entity creation timestamp', optional: true }, + LastUpdatedTime: { + type: 'string', + description: 'Entity last-updated timestamp', + optional: true, + }, +} + +export const QUICKBOOKS_COMPANY_INFO_PROPERTIES: Record = { + Id: { type: 'string', description: 'Connected QuickBooks company ID' }, + SyncToken: { type: 'string', description: 'CompanyInfo sync token', optional: true }, + CompanyName: { type: 'string', description: 'Company display name', optional: true }, + LegalName: { type: 'string', description: 'Company legal name', optional: true }, + CompanyAddr: { type: 'json', description: 'Company address', optional: true }, + CustomerCommunicationAddr: { + type: 'json', + description: 'Customer communication address', + optional: true, + }, + LegalAddr: { type: 'json', description: 'Company legal address', optional: true }, + PrimaryPhone: { type: 'json', description: 'Primary phone details', optional: true }, + Email: { type: 'json', description: 'Company email details', optional: true }, + WebAddr: { type: 'json', description: 'Company website details', optional: true }, + CompanyStartDate: { + type: 'string', + description: 'Company start date', + optional: true, + }, + Country: { type: 'string', description: 'Company country code', optional: true }, + FiscalYearStartMonth: { + type: 'string', + description: 'Fiscal year starting month', + optional: true, + }, + DefaultTimeZone: { + type: 'string', + description: 'Company default time zone', + optional: true, + }, + NameValue: { + type: 'array', + description: 'QuickBooks company settings represented as name/value entries', + optional: true, + items: { type: 'json' }, + }, + MetaData: { + type: 'json', + description: 'CompanyInfo creation and update timestamps', + optional: true, + properties: QUICKBOOKS_METADATA_PROPERTIES, + }, +} + +export const QUICKBOOKS_LIST_OUTPUTS: Record = { + startPosition: { + type: 'number', + description: 'One-based position of the first item in this response', + }, + maxResults: { + type: 'number', + description: 'Actual number of items reported for this response', + }, + nextStartPosition: { + type: 'number', + description: 'Position to use when explicitly requesting the next page', + }, + hasMore: { + type: 'boolean', + description: 'Conservative indication that another page may exist', + }, + time: { + type: 'string', + description: 'QuickBooks response timestamp', + optional: true, + nullable: true, + }, +} diff --git a/apps/sim/tools/quickbooks/utils.ts b/apps/sim/tools/quickbooks/utils.ts new file mode 100644 index 00000000000..87a3a99f1a2 --- /dev/null +++ b/apps/sim/tools/quickbooks/utils.ts @@ -0,0 +1,118 @@ +import { readResponseJsonWithLimit } from '@/lib/core/utils/stream-limits' +import { + buildQuickBooksCompanyUrl, + buildQuickBooksHeaders, + QUICKBOOKS_MAX_RESPONSE_BYTES, +} from '@/lib/quickbooks/client' +import { sanitizeQuickBooksFaultData } from '@/lib/quickbooks/fault' +import { ErrorExtractorId, extractErrorMessage } from '@/tools/error-extractors' +import type { QuickBooksListResponse, QuickBooksPaginationParams } from '@/tools/quickbooks/types' + +export type QuickBooksQueryEntity = 'Bill' | 'PurchaseOrder' | 'Vendor' + +interface QuickBooksQueryResponse { + QueryResponse?: { + Bill?: T[] + PurchaseOrder?: T[] + Vendor?: T[] + startPosition?: number + maxResults?: number + } + time?: string +} + +export function validateQuickBooksPagination( + startPosition: number, + maxResults: number +): { startPosition: number; maxResults: number } { + if (!Number.isInteger(startPosition) || startPosition < 1) { + throw new Error('startPosition must be a positive integer') + } + if (!Number.isInteger(maxResults) || maxResults < 1 || maxResults > 100) { + throw new Error('maxResults must be an integer from 1 through 100') + } + return { startPosition, maxResults } +} + +export function buildQuickBooksQueryUrl( + realmId: string, + entity: QuickBooksQueryEntity, + startPosition: number, + maxResults: number +): URL { + const pagination = validateQuickBooksPagination(startPosition, maxResults) + const url = buildQuickBooksCompanyUrl(realmId, 'query') + url.searchParams.set( + 'query', + `SELECT * FROM ${entity} STARTPOSITION ${pagination.startPosition} MAXRESULTS ${pagination.maxResults}` + ) + return url +} + +export async function parseQuickBooksJson(response: Response, label: string): Promise { + if (!response.ok) { + throw new Error(`QuickBooks request failed with HTTP ${response.status}`) + } + const data = await readResponseJsonWithLimit(response, { + maxBytes: QUICKBOOKS_MAX_RESPONSE_BYTES, + label, + }) + const faultData = sanitizeQuickBooksFaultData(data) + if (faultData) { + const errorInfo = { + status: response.status, + statusText: response.statusText, + data: faultData, + headers: response.headers, + } + throw Object.assign( + new Error(extractErrorMessage(errorInfo, ErrorExtractorId.QUICKBOOKS_FAULT)), + errorInfo + ) + } + return data +} + +export async function transformQuickBooksListResponse( + response: Response, + params: QuickBooksPaginationParams, + entity: QuickBooksQueryEntity +): Promise> { + const data = await parseQuickBooksJson>( + response, + `QuickBooks ${entity} query response` + ) + const queryResponse = data.QueryResponse + if (!queryResponse || typeof queryResponse !== 'object' || Array.isArray(queryResponse)) { + throw new Error(`QuickBooks ${entity} response is missing QueryResponse`) + } + + const candidate = queryResponse[entity] + if (candidate !== undefined && !Array.isArray(candidate)) { + throw new Error(`QuickBooks ${entity} response contains a malformed entity list`) + } + + const items = (candidate ?? []) as T[] + const startPosition = Number.isInteger(queryResponse.startPosition) + ? (queryResponse.startPosition as number) + : params.startPosition + const maxResults = Number.isInteger(queryResponse.maxResults) + ? (queryResponse.maxResults as number) + : items.length + + return { + success: true, + output: { + items, + startPosition, + maxResults, + nextStartPosition: startPosition + items.length, + hasMore: items.length === params.maxResults, + time: typeof data.time === 'string' ? data.time : null, + }, + } +} + +export function getQuickBooksToolHeaders(accessToken: string): Record { + return buildQuickBooksHeaders(accessToken) +} diff --git a/apps/sim/tools/registry.ts b/apps/sim/tools/registry.ts index 06fdf3eb441..2f2c6a6df89 100644 --- a/apps/sim/tools/registry.ts +++ b/apps/sim/tools/registry.ts @@ -2981,6 +2981,12 @@ import { quartrListSlideDecksTool, quartrListTranscriptsTool, } from '@/tools/quartr' +import { + quickbooksGetCompanyInfoTool, + quickbooksListBillsTool, + quickbooksListPurchaseOrdersTool, + quickbooksListVendorsTool, +} from '@/tools/quickbooks' import { quiverImageToSvgTool, quiverListModelsTool, quiverTextToSvgTool } from '@/tools/quiver' import { railwayCreateEnvironmentTool, @@ -6021,6 +6027,10 @@ export const tools: Record = { postgresql_delete: postgresDeleteTool, postgresql_execute: postgresExecuteTool, postgresql_introspect: postgresIntrospectTool, + quickbooks_get_company_info: quickbooksGetCompanyInfoTool, + quickbooks_list_bills: quickbooksListBillsTool, + quickbooks_list_purchase_orders: quickbooksListPurchaseOrdersTool, + quickbooks_list_vendors: quickbooksListVendorsTool, rds_query: rdsQueryTool, rds_insert: rdsInsertTool, rds_update: rdsUpdateTool, diff --git a/apps/sim/tools/types.ts b/apps/sim/tools/types.ts index c3a190fa630..009332ecd63 100644 --- a/apps/sim/tools/types.ts +++ b/apps/sim/tools/types.ts @@ -170,6 +170,8 @@ export interface ToolConfig

{ headers: (params: P) => Record body?: (params: P) => Record | string | FormData | undefined retry?: ToolRetryConfig + /** Maximum response body size accepted before parsing. Defaults to the executor's 10 MiB cap. */ + maxResponseBytes?: number /** * Drop the `Authorization` header when following a redirect. Set this on any * tool whose endpoint redirects to a different origin carrying its own diff --git a/scripts/generate-docs.ts b/scripts/generate-docs.ts index d3b72ac44c9..eb1ab87e758 100755 --- a/scripts/generate-docs.ts +++ b/scripts/generate-docs.ts @@ -2109,7 +2109,12 @@ function extractToolInfo( const paramName = param.name const paramBlock = param.content - if (paramName === 'accessToken' || paramName === 'params' || paramName === 'tools') { + if ( + paramName === 'accessToken' || + paramName === 'realmId' || + paramName === 'params' || + paramName === 'tools' + ) { continue } From 33d9afbb7d362a7022ee2308b2f61d07456875d0 Mon Sep 17 00:00:00 2001 From: Bill Leoutsakos Date: Thu, 30 Jul 2026 12:21:10 -0700 Subject: [PATCH 02/12] fix(quickbooks): address BugBot findings --- .../app/api/auth/oauth/token/route.test.ts | 27 ++++++++++++++ apps/sim/app/api/auth/oauth/token/route.ts | 10 +++--- apps/sim/lib/quickbooks/fault.ts | 24 +++++++------ apps/sim/tools/index.test.ts | 36 +++++++++++++++++++ apps/sim/tools/index.ts | 11 ++++-- .../tools/quickbooks/error-extractor.test.ts | 12 +++++++ apps/sim/tools/quickbooks/quickbooks.test.ts | 17 +++++++++ 7 files changed, 120 insertions(+), 17 deletions(-) diff --git a/apps/sim/app/api/auth/oauth/token/route.test.ts b/apps/sim/app/api/auth/oauth/token/route.test.ts index 57246576a2c..67a36cb7558 100644 --- a/apps/sim/app/api/auth/oauth/token/route.test.ts +++ b/apps/sim/app/api/auth/oauth/token/route.test.ts @@ -579,6 +579,33 @@ describe('OAuth Token API Routes', () => { expect(data).toHaveProperty('error') }) + it('rejects a malformed QuickBooks identity before reporting a missing token', async () => { + mockAuthorizeCredentialUse.mockResolvedValueOnce({ + ok: true, + authType: 'session', + requesterUserId: 'test-user-id', + credentialOwnerUserId: 'test-user-id', + }) + authOAuthUtilsMockFns.mockGetCredential.mockResolvedValueOnce({ + id: 'credential-id', + accountId: 'malformed', + accessToken: null, + refreshToken: 'refresh-token', + providerId: 'quickbooks', + }) + + const response = await GET( + new NextRequest( + 'http://localhost:3000/api/auth/oauth/token?credentialId=credential-id' + ) as any + ) + const data = await response.json() + + expect(response.status).toBe(401) + expect(data.error).toMatch(/Reconnect the QuickBooks credential/) + expect(authOAuthUtilsMockFns.mockRefreshTokenIfNeeded).not.toHaveBeenCalled() + }) + it('should handle token refresh failure', async () => { mockAuthorizeCredentialUse.mockResolvedValueOnce({ ok: true, diff --git a/apps/sim/app/api/auth/oauth/token/route.ts b/apps/sim/app/api/auth/oauth/token/route.ts index dc9c805a279..cdd4f08a139 100644 --- a/apps/sim/app/api/auth/oauth/token/route.ts +++ b/apps/sim/app/api/auth/oauth/token/route.ts @@ -371,11 +371,6 @@ export const GET = withRouteHandler(async (request: NextRequest) => { return NextResponse.json({ error: 'Credential not found' }, { status: 404 }) } - if (!credential.accessToken) { - logger.warn(`[${requestId}] No access token available for credential`) - return NextResponse.json({ error: 'No access token available' }, { status: 400 }) - } - const actorId = authz.requesterUserId const workspaceId = authz.workspaceId ?? null @@ -396,6 +391,11 @@ export const GET = withRouteHandler(async (request: NextRequest) => { } } + if (!credential.accessToken) { + logger.warn(`[${requestId}] No access token available for credential`) + return NextResponse.json({ error: 'No access token available' }, { status: 400 }) + } + try { const { accessToken } = await refreshTokenIfNeeded( requestId, diff --git a/apps/sim/lib/quickbooks/fault.ts b/apps/sim/lib/quickbooks/fault.ts index cfcd5aea5f6..d3a27eef9be 100644 --- a/apps/sim/lib/quickbooks/fault.ts +++ b/apps/sim/lib/quickbooks/fault.ts @@ -11,18 +11,22 @@ export function sanitizeQuickBooksFaultData(data: unknown): SanitizedQuickBooksF const errors = (fault as Record).Error if (!Array.isArray(errors)) return null + const sanitizedErrors = errors.flatMap((entry) => { + if (!entry || typeof entry !== 'object' || Array.isArray(entry)) return [] + const value = entry as Record + const sanitized = Object.fromEntries( + ['code', 'Message', 'Detail', 'element'].flatMap((key) => { + const field = typeof value[key] === 'string' ? value[key].trim() : '' + return field ? [[key, field]] : [] + }) + ) + return Object.keys(sanitized).length > 0 ? [sanitized] : [] + }) + if (sanitizedErrors.length === 0) return null + return { Fault: { - Error: errors.flatMap((entry) => { - if (!entry || typeof entry !== 'object' || Array.isArray(entry)) return [] - const value = entry as Record - const sanitized = Object.fromEntries( - ['code', 'Message', 'Detail', 'element'].flatMap((key) => - typeof value[key] === 'string' ? [[key, value[key]]] : [] - ) - ) - return Object.keys(sanitized).length > 0 ? [sanitized] : [] - }), + Error: sanitizedErrors, }, } } diff --git a/apps/sim/tools/index.test.ts b/apps/sim/tools/index.test.ts index 1c9b0e70a66..731c7f262cb 100644 --- a/apps/sim/tools/index.test.ts +++ b/apps/sim/tools/index.test.ts @@ -1517,6 +1517,42 @@ describe('OAuth provider context propagation', () => { expect(fetchMock).toHaveBeenCalledTimes(2) }) + it('rejects a stale QuickBooks realm when the credential response omits its binding', async () => { + mockGenerateInternalToken.mockResolvedValue('internal-token') + const fetchMock = vi.fn().mockImplementation(async (url: string) => { + if (url.includes('/api/auth/oauth/token')) { + return new Response(JSON.stringify({ accessToken: 'fresh-access-token' }), { + headers: { 'Content-Type': 'application/json' }, + }) + } + + throw new Error('QuickBooks API must not be called with an unbound realm') + }) + global.fetch = Object.assign(fetchMock, { preconnect: vi.fn() }) as typeof fetch + + const result = await executeTool( + 'test_quickbooks_context', + { + credential: 'quickbooks-credential', + realmId: 'workflow-supplied-company', + }, + { + executionContext: createToolExecutionContext({ + userId: 'user-123', + workflowId: 'workflow-123', + }), + } + ) + + expect(result).toMatchObject({ + success: false, + error: expect.stringContaining( + 'QuickBooks company identity is missing. Reconnect the QuickBooks credential.' + ), + }) + expect(fetchMock).toHaveBeenCalledTimes(1) + }) + it('does not expose a non-JSON QuickBooks failure body in tool output', async () => { mockGenerateInternalToken.mockResolvedValue('internal-token') const fetchMock = vi.fn().mockImplementation(async (url: string) => { diff --git a/apps/sim/tools/index.ts b/apps/sim/tools/index.ts index 44dd442b22e..28fc1b836cd 100644 --- a/apps/sim/tools/index.ts +++ b/apps/sim/tools/index.ts @@ -1248,8 +1248,15 @@ export async function executeTool( if (data.domain && !contextParams.domain) { contextParams.domain = data.domain } - if (data.realmId) { - contextParams.realmId = data.realmId + if (tool?.oauth?.provider === 'quickbooks') { + const credentialRealmId = typeof data.realmId === 'string' ? data.realmId.trim() : '' + contextParams.realmId = undefined + if (!credentialRealmId) { + throw new Error( + 'QuickBooks company identity is missing. Reconnect the QuickBooks credential.' + ) + } + contextParams.realmId = credentialRealmId } if (data.authStyle && !contextParams.authStyle) { contextParams.authStyle = data.authStyle diff --git a/apps/sim/tools/quickbooks/error-extractor.test.ts b/apps/sim/tools/quickbooks/error-extractor.test.ts index 40f7fe21e8a..2eaca1756bb 100644 --- a/apps/sim/tools/quickbooks/error-extractor.test.ts +++ b/apps/sim/tools/quickbooks/error-extractor.test.ts @@ -1,4 +1,5 @@ import { describe, expect, it } from 'vitest' +import { sanitizeQuickBooksFaultData } from '@/lib/quickbooks/fault' import { ErrorExtractorId, extractErrorMessage } from '@/tools/error-extractors' describe('QuickBooks fault extraction', () => { @@ -68,4 +69,15 @@ describe('QuickBooks fault extraction', () => { extractErrorMessage({ status: 502, data: null }, ErrorExtractorId.QUICKBOOKS_FAULT) ).toBe('QuickBooks request failed with HTTP 502.') }) + + it('ignores fault envelopes without a usable error entry', () => { + expect(sanitizeQuickBooksFaultData({ Fault: { Error: [] } })).toBeNull() + expect( + sanitizeQuickBooksFaultData({ + Fault: { + Error: [{ code: ' ', Message: '', ignored: 'not a documented fault field' }, null], + }, + }) + ).toBeNull() + }) }) diff --git a/apps/sim/tools/quickbooks/quickbooks.test.ts b/apps/sim/tools/quickbooks/quickbooks.test.ts index fd3fbdc9ed7..0e5d409c6b4 100644 --- a/apps/sim/tools/quickbooks/quickbooks.test.ts +++ b/apps/sim/tools/quickbooks/quickbooks.test.ts @@ -150,6 +150,23 @@ describe('QuickBooks response contracts', () => { }) }) + it('accepts a usable query response alongside an empty fault envelope', async () => { + const result = await transformQuickBooksListResponse( + Response.json({ + Fault: { Error: [] }, + QueryResponse: { + Vendor: [{ Id: '7', DisplayName: 'Sanitized Vendor' }], + startPosition: 1, + maxResults: 1, + }, + }), + { ...authParams, startPosition: 1, maxResults: 1 }, + 'Vendor' + ) + + expect(result.output.items).toEqual([{ Id: '7', DisplayName: 'Sanitized Vendor' }]) + }) + it.each([ ['Vendor', { Id: '7', DisplayName: 'Sanitized Vendor' }], ['PurchaseOrder', { Id: '8', DocNumber: 'PO-SANITIZED', TotalAmt: 42 }], From 29bfcc5491f79747d27d65ef243553421329d088 Mon Sep 17 00:00:00 2001 From: Bill Leoutsakos Date: Thu, 30 Jul 2026 18:19:25 -0700 Subject: [PATCH 03/12] fix(quickbooks): require explicit API environment --- apps/sim/.env.example | 5 +++++ apps/sim/lib/oauth/quickbooks.test.ts | 8 +++++++- apps/sim/lib/quickbooks/client.ts | 7 ++++++- apps/sim/tools/quickbooks/quickbooks.test.ts | 6 ++++-- 4 files changed, 22 insertions(+), 4 deletions(-) diff --git a/apps/sim/.env.example b/apps/sim/.env.example index ef123188499..6807fdb7a67 100644 --- a/apps/sim/.env.example +++ b/apps/sim/.env.example @@ -112,6 +112,11 @@ API_ENCRYPTION_KEY=your_api_encryption_key # Use `openssl rand -hex 32` to gener # TIKTOK_CLIENT_ID= # TIKTOK_CLIENT_SECRET= +# QuickBooks Online OAuth (Optional - credentials from the Intuit Developer Portal) +# QUICKBOOKS_CLIENT_ID= +# QUICKBOOKS_CLIENT_SECRET= +# QUICKBOOKS_ENV=sandbox # Required when QuickBooks is configured: sandbox or production + # Azure Blob Storage takes precedence over S3 if both are configured # AZURE_ACCOUNT_NAME= # Azure storage account name # AZURE_ACCOUNT_KEY= # Azure storage account key diff --git a/apps/sim/lib/oauth/quickbooks.test.ts b/apps/sim/lib/oauth/quickbooks.test.ts index a95c8e296c2..0bc6ffd3c95 100644 --- a/apps/sim/lib/oauth/quickbooks.test.ts +++ b/apps/sim/lib/oauth/quickbooks.test.ts @@ -1,4 +1,5 @@ -import { afterEach, describe, expect, it, vi } from 'vitest' +import { resetEnvMock, setEnv } from '@sim/testing' +import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest' import { createQuickBooksAccountId, fetchQuickBooksConnectionProfile, @@ -12,8 +13,13 @@ import { QUICKBOOKS_MAX_USER_INFO_BYTES } from '@/lib/quickbooks/client' const TEST_UUID = '01234567-89ab-4def-8abc-0123456789ab' const originalFetch = global.fetch +beforeEach(() => { + setEnv({ QUICKBOOKS_ENV: 'sandbox' }) +}) + afterEach(() => { global.fetch = originalFetch + resetEnvMock() }) describe('QuickBooks account identity', () => { diff --git a/apps/sim/lib/quickbooks/client.ts b/apps/sim/lib/quickbooks/client.ts index 2f1e40d09ce..8d1bfba2688 100644 --- a/apps/sim/lib/quickbooks/client.ts +++ b/apps/sim/lib/quickbooks/client.ts @@ -12,7 +12,12 @@ export const QUICKBOOKS_MAX_USER_INFO_BYTES = 1024 * 1024 export type QuickBooksEnvironment = 'sandbox' | 'production' export function getQuickBooksEnvironment(): QuickBooksEnvironment { - const value = env.QUICKBOOKS_ENV ?? 'sandbox' + const value = env.QUICKBOOKS_ENV + if (!value) { + throw new Error( + 'QUICKBOOKS_ENV must be explicitly configured as either "sandbox" or "production"' + ) + } if (value !== 'sandbox' && value !== 'production') { throw new Error('QUICKBOOKS_ENV must be either "sandbox" or "production"') } diff --git a/apps/sim/tools/quickbooks/quickbooks.test.ts b/apps/sim/tools/quickbooks/quickbooks.test.ts index 0e5d409c6b4..134b9d91998 100644 --- a/apps/sim/tools/quickbooks/quickbooks.test.ts +++ b/apps/sim/tools/quickbooks/quickbooks.test.ts @@ -41,9 +41,11 @@ describe('QuickBooks request construction', () => { ) }) - it('defaults to sandbox and rejects an invalid environment at the API boundary', () => { + it('requires an explicit valid environment at the API boundary', () => { setEnv({ QUICKBOOKS_ENV: undefined }) - expect(getQuickBooksEnvironment()).toBe('sandbox') + expect(() => getQuickBooksEnvironment()).toThrow( + 'QUICKBOOKS_ENV must be explicitly configured as either "sandbox" or "production"' + ) setEnv({ QUICKBOOKS_ENV: 'staging' }) expect(() => getQuickBooksEnvironment()).toThrow( From cbc74bf163abd3d741237bef927afa3f918c16f5 Mon Sep 17 00:00:00 2001 From: Bill Leoutsakos Date: Thu, 30 Jul 2026 18:26:06 -0700 Subject: [PATCH 04/12] fix(quickbooks): validate refreshed execution context --- apps/sim/lib/oauth/oauth.test.ts | 20 +++++++++++++++++ apps/sim/lib/oauth/oauth.ts | 9 +++++--- apps/sim/tools/quickbooks/get_company_info.ts | 8 ++++++- apps/sim/tools/quickbooks/quickbooks.test.ts | 22 ++++++++++++++++--- 4 files changed, 52 insertions(+), 7 deletions(-) diff --git a/apps/sim/lib/oauth/oauth.test.ts b/apps/sim/lib/oauth/oauth.test.ts index d930e8f0ca2..1cea14b66ac 100644 --- a/apps/sim/lib/oauth/oauth.test.ts +++ b/apps/sim/lib/oauth/oauth.test.ts @@ -483,6 +483,26 @@ describe('OAuth Token Refresh', () => { } ) + it.concurrent('should preserve numeric string token expiry values', async () => { + const mockFetch = vi.fn().mockResolvedValue( + Response.json({ + access_token: 'new_access_token', + expires_in: '7200', + }) + ) + + const result = await withMockFetch(mockFetch, () => + refreshOAuthToken('google', 'old_refresh_token') + ) + + expect(result).toEqual({ + ok: true, + accessToken: 'new_access_token', + expiresIn: 7200, + refreshToken: 'old_refresh_token', + }) + }) + it.concurrent('should handle providers that return new refresh tokens', async () => { const refreshToken = 'old_refresh_token' const newRefreshToken = 'new_refresh_token' diff --git a/apps/sim/lib/oauth/oauth.ts b/apps/sim/lib/oauth/oauth.ts index f9d76752e65..988044e096d 100644 --- a/apps/sim/lib/oauth/oauth.ts +++ b/apps/sim/lib/oauth/oauth.ts @@ -1885,10 +1885,13 @@ export async function refreshOAuthToken( } const expiresInCandidate = data.expires_in ?? data.expiresIn - const expiresIn = - typeof expiresInCandidate === 'number' && Number.isFinite(expiresInCandidate) + const parsedExpiresIn = + typeof expiresInCandidate === 'number' ? expiresInCandidate - : 3600 + : typeof expiresInCandidate === 'string' && expiresInCandidate.trim() + ? Number(expiresInCandidate) + : Number.NaN + const expiresIn = Number.isFinite(parsedExpiresIn) ? parsedExpiresIn : 3600 if (!accessToken) { logger.warn('No access token found in refresh response', { diff --git a/apps/sim/tools/quickbooks/get_company_info.ts b/apps/sim/tools/quickbooks/get_company_info.ts index 138df409239..6dbf88f050c 100644 --- a/apps/sim/tools/quickbooks/get_company_info.ts +++ b/apps/sim/tools/quickbooks/get_company_info.ts @@ -59,7 +59,8 @@ export const quickbooksGetCompanyInfoTool: ToolConfig< retry: { enabled: false }, maxResponseBytes: QUICKBOOKS_MAX_RESPONSE_BYTES, }, - transformResponse: async (response) => { + transformResponse: async (response, params) => { + const realmId = normalizeQuickBooksRealmId(params?.realmId ?? '') const data = await parseQuickBooksJson( response, 'QuickBooks CompanyInfo response' @@ -67,6 +68,11 @@ export const quickbooksGetCompanyInfoTool: ToolConfig< if (!data.CompanyInfo || typeof data.CompanyInfo !== 'object') { throw new Error('QuickBooks CompanyInfo response is missing CompanyInfo') } + if (String(data.CompanyInfo.Id ?? '').trim() !== realmId) { + throw new Error( + 'QuickBooks CompanyInfo response returned a different company. Reconnect the QuickBooks credential.' + ) + } return { success: true, output: { diff --git a/apps/sim/tools/quickbooks/quickbooks.test.ts b/apps/sim/tools/quickbooks/quickbooks.test.ts index 134b9d91998..d466dd3f9f7 100644 --- a/apps/sim/tools/quickbooks/quickbooks.test.ts +++ b/apps/sim/tools/quickbooks/quickbooks.test.ts @@ -340,7 +340,8 @@ describe('QuickBooks tool boundaries', () => { CompanyInfo: { Id: '123456789', CompanyName: 'Sanitized Company' }, time: 'test-time', }) - ) + ), + authParams ) expect(result.output).toEqual({ company: { Id: '123456789', CompanyName: 'Sanitized Company' }, @@ -351,11 +352,25 @@ describe('QuickBooks tool boundaries', () => { it('rejects an empty CompanyInfo wrapper', async () => { await expect( quickbooksGetCompanyInfoTool.transformResponse!( - new Response(JSON.stringify({ time: 'test-time' })) + new Response(JSON.stringify({ time: 'test-time' })), + authParams ) ).rejects.toThrow('missing CompanyInfo') }) + it('rejects CompanyInfo for a different realm', async () => { + await expect( + quickbooksGetCompanyInfoTool.transformResponse!( + new Response( + JSON.stringify({ + CompanyInfo: { Id: '999', CompanyName: 'Different Sanitized Company' }, + }) + ), + authParams + ) + ).rejects.toThrow('different company') + }) + it('recognizes a QuickBooks Fault in an HTTP 200 CompanyInfo response', async () => { await expect( quickbooksGetCompanyInfoTool.transformResponse!( @@ -372,7 +387,8 @@ describe('QuickBooks tool boundaries', () => { }, }), { status: 200 } - ) + ), + authParams ) ).rejects.toThrow( 'QuickBooks request failed with HTTP 200. 3200: Authentication failed: Sanitized fault detail' From 311d32e56058620ab46ab0daf51210baf8e28bf7 Mon Sep 17 00:00:00 2001 From: Bill Leoutsakos Date: Thu, 30 Jul 2026 18:30:57 -0700 Subject: [PATCH 05/12] fix(oauth): reject invalid refresh lifetimes --- apps/sim/lib/oauth/oauth.test.ts | 21 +++++++++++++++++++++ apps/sim/lib/oauth/oauth.ts | 3 ++- 2 files changed, 23 insertions(+), 1 deletion(-) diff --git a/apps/sim/lib/oauth/oauth.test.ts b/apps/sim/lib/oauth/oauth.test.ts index 1cea14b66ac..776d207e6a2 100644 --- a/apps/sim/lib/oauth/oauth.test.ts +++ b/apps/sim/lib/oauth/oauth.test.ts @@ -503,6 +503,27 @@ describe('OAuth Token Refresh', () => { }) }) + it.concurrent.each([0, -1, '0', '-1'])( + 'should fall back when token expiry is not positive: %s', + async (expiresIn) => { + const mockFetch = vi.fn().mockResolvedValue( + Response.json({ + access_token: 'new_access_token', + expires_in: expiresIn, + }) + ) + + const result = await withMockFetch(mockFetch, () => + refreshOAuthToken('google', 'old_refresh_token') + ) + + expect(result).toMatchObject({ + ok: true, + expiresIn: 3600, + }) + } + ) + it.concurrent('should handle providers that return new refresh tokens', async () => { const refreshToken = 'old_refresh_token' const newRefreshToken = 'new_refresh_token' diff --git a/apps/sim/lib/oauth/oauth.ts b/apps/sim/lib/oauth/oauth.ts index 988044e096d..f30670fd39b 100644 --- a/apps/sim/lib/oauth/oauth.ts +++ b/apps/sim/lib/oauth/oauth.ts @@ -1891,7 +1891,8 @@ export async function refreshOAuthToken( : typeof expiresInCandidate === 'string' && expiresInCandidate.trim() ? Number(expiresInCandidate) : Number.NaN - const expiresIn = Number.isFinite(parsedExpiresIn) ? parsedExpiresIn : 3600 + const expiresIn = + Number.isFinite(parsedExpiresIn) && parsedExpiresIn > 0 ? parsedExpiresIn : 3600 if (!accessToken) { logger.warn('No access token found in refresh response', { From 19e00eb7fbbd758e15822105a80cdfd4d251bd29 Mon Sep 17 00:00:00 2001 From: Bill Leoutsakos Date: Thu, 30 Jul 2026 18:37:30 -0700 Subject: [PATCH 06/12] fix(quickbooks): bound initial token exchange --- apps/sim/lib/auth/auth.ts | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/apps/sim/lib/auth/auth.ts b/apps/sim/lib/auth/auth.ts index ab408ed688b..18c669a772b 100644 --- a/apps/sim/lib/auth/auth.ts +++ b/apps/sim/lib/auth/auth.ts @@ -87,6 +87,7 @@ import { } from '@/lib/core/config/env-flags' import { PlatformEvents } from '@/lib/core/telemetry' import { + DEFAULT_MAX_ERROR_BODY_BYTES, readResponseJsonWithLimit, readResponseTextWithLimit, } from '@/lib/core/utils/stream-limits' @@ -113,7 +114,6 @@ import { clearDeadFlag } from '@/lib/oauth/terminal-errors' import { getCanonicalScopesForProvider } from '@/lib/oauth/utils' import { joinInstanceOrganization } from '@/lib/organizations/instance-org' import { captureServerEvent, getPostHogClient } from '@/lib/posthog/server' -import { QUICKBOOKS_MAX_USER_INFO_BYTES } from '@/lib/quickbooks/client' import { disableUserResources } from '@/lib/workflows/lifecycle' import { SSO_TRUSTED_PROVIDERS } from '@/ee/sso/constants' @@ -3242,7 +3242,7 @@ export const auth = betterAuth({ }), }) const data = await readResponseJsonWithLimit>(response, { - maxBytes: QUICKBOOKS_MAX_USER_INFO_BYTES, + maxBytes: DEFAULT_MAX_ERROR_BODY_BYTES, label: 'QuickBooks OAuth token response', }) From 25e5420b0f0619110c463e678036abc828ee0e11 Mon Sep 17 00:00:00 2001 From: Bill Leoutsakos Date: Thu, 30 Jul 2026 19:48:12 -0700 Subject: [PATCH 07/12] fix(quickbooks): harden OAuth company binding --- .../docs/en/integrations/quickbooks.mdx | 2 +- apps/sim/app/api/auth/[...all]/route.test.ts | 65 ++++++++++ apps/sim/app/api/auth/[...all]/route.ts | 27 ++++ apps/sim/lib/auth/auth.ts | 8 +- apps/sim/lib/core/config/env.ts | 2 +- .../lib/credentials/draft-processor.test.ts | 113 +++++++++++++++++ apps/sim/lib/credentials/draft-processor.ts | 15 ++- apps/sim/lib/oauth/quickbooks.test.ts | 119 ++++++++++++++---- apps/sim/lib/oauth/quickbooks.ts | 48 ++++--- apps/sim/lib/quickbooks/client.ts | 69 ++++++++-- apps/sim/tools/quickbooks/get_company_info.ts | 7 +- apps/sim/tools/quickbooks/quickbooks.test.ts | 102 +++++++++++---- apps/sim/tools/quickbooks/types.ts | 5 +- 13 files changed, 496 insertions(+), 86 deletions(-) create mode 100644 apps/sim/lib/credentials/draft-processor.test.ts diff --git a/apps/docs/content/docs/en/integrations/quickbooks.mdx b/apps/docs/content/docs/en/integrations/quickbooks.mdx index c01e83658ab..ac93fd6ff6d 100644 --- a/apps/docs/content/docs/en/integrations/quickbooks.mdx +++ b/apps/docs/content/docs/en/integrations/quickbooks.mdx @@ -32,7 +32,7 @@ Get information about the connected QuickBooks Online company | Parameter | Type | Description | | --------- | ---- | ----------- | | `company` | json | Verified QuickBooks CompanyInfo object, including Id, CompanyName, LegalName, addresses, contact details, NameValue settings, and MetaData when populated | -| ↳ `Id` | string | Connected QuickBooks company ID | +| ↳ `Id` | string | QuickBooks CompanyInfo entity ID \(commonly "1"\); this is not the OAuth realmId | | ↳ `SyncToken` | string | CompanyInfo sync token | | ↳ `CompanyName` | string | Company display name | | ↳ `LegalName` | string | Company legal name | diff --git a/apps/sim/app/api/auth/[...all]/route.test.ts b/apps/sim/app/api/auth/[...all]/route.test.ts index 4c577409990..29c3cc27425 100644 --- a/apps/sim/app/api/auth/[...all]/route.test.ts +++ b/apps/sim/app/api/auth/[...all]/route.test.ts @@ -30,6 +30,7 @@ vi.mock('@/lib/auth/anonymous', () => ({ createAnonymousSession: handlerMocks.createAnonymousSession, })) +import { getQuickBooksCallbackRealm } from '@/lib/oauth/quickbooks' import { GET, POST } from '@/app/api/auth/[...all]/route' afterAll(resetEnvFlagsMock) @@ -132,3 +133,67 @@ describe('auth catch-all route organization mutations', () => { expect(json).toEqual({ data: { ok: true } }) }) }) + +describe('auth catch-all route QuickBooks callback', () => { + beforeEach(() => { + vi.clearAllMocks() + setEnvFlags({ isAuthDisabled: false }) + }) + + it('binds the callback realm only while Better Auth processes the OAuth response', async () => { + const { NextResponse } = await import('next/server') + handlerMocks.betterAuthGET.mockImplementationOnce(async () => { + await Promise.resolve() + expect(getQuickBooksCallbackRealm()).toBe('123456789') + return new NextResponse(null, { status: 302 }) + }) + + const req = createMockRequest( + 'GET', + undefined, + {}, + 'http://localhost:3000/api/auth/oauth2/callback/quickbooks?code=test&state=test&realmId=123456789' + ) + + const res = await GET(req as any) + + expect(res.status).toBe(302) + expect(handlerMocks.betterAuthGET).toHaveBeenCalledTimes(1) + expect(() => getQuickBooksCallbackRealm()).toThrow(/did not include a company identity/) + }) + + it('delegates a denied callback without requiring a realm', async () => { + const { NextResponse } = await import('next/server') + handlerMocks.betterAuthGET.mockImplementationOnce(async () => { + expect(() => getQuickBooksCallbackRealm()).toThrow(/did not include a company identity/) + return new NextResponse(null, { status: 302 }) + }) + + const req = createMockRequest( + 'GET', + undefined, + {}, + 'http://localhost:3000/api/auth/oauth2/callback/quickbooks?error=access_denied&state=test' + ) + + const res = await GET(req as any) + + expect(res.status).toBe(302) + expect(handlerMocks.betterAuthGET).toHaveBeenCalledTimes(1) + }) + + it.each([ + ['missing', 'http://localhost:3000/api/auth/oauth2/callback/quickbooks?code=test&state=test'], + [ + 'invalid', + 'http://localhost:3000/api/auth/oauth2/callback/quickbooks?code=test&state=test&realmId=not-a-company', + ], + ])('rejects a %s callback realm before Better Auth exchanges the code', async (_, url) => { + const req = createMockRequest('GET', undefined, {}, url) + + const res = await GET(req as any) + + expect(res.status).toBe(400) + expect(handlerMocks.betterAuthGET).not.toHaveBeenCalled() + }) +}) diff --git a/apps/sim/app/api/auth/[...all]/route.ts b/apps/sim/app/api/auth/[...all]/route.ts index 8456afff4cf..68a94468967 100644 --- a/apps/sim/app/api/auth/[...all]/route.ts +++ b/apps/sim/app/api/auth/[...all]/route.ts @@ -4,6 +4,7 @@ import { auth } from '@/lib/auth' import { createAnonymousSession, ensureAnonymousUserExists } from '@/lib/auth/anonymous' import { isAuthDisabled } from '@/lib/core/config/env-flags' import { withRouteHandler } from '@/lib/core/utils/with-route-handler' +import { normalizeQuickBooksRealmId, withQuickBooksCallbackRealm } from '@/lib/oauth/quickbooks' export const dynamic = 'force-dynamic' @@ -27,6 +28,32 @@ export const GET = withRouteHandler(async (request: NextRequest) => { return NextResponse.json(createAnonymousSession()) } + if (path === 'oauth2/callback/quickbooks') { + const authorizationCode = request.nextUrl.searchParams.get('code') + if (!authorizationCode) { + return betterAuthGET(request) + } + + const realmId = request.nextUrl.searchParams.get('realmId') + if (!realmId) { + return NextResponse.json( + { error: 'QuickBooks callback did not include a company identity.' }, + { status: 400 } + ) + } + + try { + normalizeQuickBooksRealmId(realmId) + } catch { + return NextResponse.json( + { error: 'QuickBooks callback included an invalid company identity.' }, + { status: 400 } + ) + } + + return withQuickBooksCallbackRealm(realmId, () => betterAuthGET(request)) + } + return betterAuthGET(request) }) diff --git a/apps/sim/lib/auth/auth.ts b/apps/sim/lib/auth/auth.ts index 18c669a772b..d515cbb3b60 100644 --- a/apps/sim/lib/auth/auth.ts +++ b/apps/sim/lib/auth/auth.ts @@ -105,6 +105,7 @@ import { } from '@/lib/oauth/microsoft' import { fetchQuickBooksConnectionProfile, + getQuickBooksCallbackRealm, QUICKBOOKS_AUTHORIZATION_URL, QUICKBOOKS_OIDC_CLAIMS, QUICKBOOKS_TOKEN_URL, @@ -114,6 +115,7 @@ import { clearDeadFlag } from '@/lib/oauth/terminal-errors' import { getCanonicalScopesForProvider } from '@/lib/oauth/utils' import { joinInstanceOrganization } from '@/lib/organizations/instance-org' import { captureServerEvent, getPostHogClient } from '@/lib/posthog/server' +import { QUICKBOOKS_OAUTH_REQUEST_TIMEOUT_MS } from '@/lib/quickbooks/client' import { disableUserResources } from '@/lib/workflows/lifecycle' import { SSO_TRUSTED_PROVIDERS } from '@/ee/sso/constants' @@ -3240,6 +3242,7 @@ export const auth = betterAuth({ grant_type: 'authorization_code', redirect_uri: redirectURI, }), + signal: AbortSignal.timeout(QUICKBOOKS_OAUTH_REQUEST_TIMEOUT_MS), }) const data = await readResponseJsonWithLimit>(response, { maxBytes: DEFAULT_MAX_ERROR_BODY_BYTES, @@ -3266,7 +3269,10 @@ export const auth = betterAuth({ throw new Error('QuickBooks OAuth did not issue an access token') } - const profile = await fetchQuickBooksConnectionProfile(tokens.accessToken) + const profile = await fetchQuickBooksConnectionProfile( + tokens.accessToken, + getQuickBooksCallbackRealm() + ) const now = new Date() return { diff --git a/apps/sim/lib/core/config/env.ts b/apps/sim/lib/core/config/env.ts index 1b8329ede10..ff40f916336 100644 --- a/apps/sim/lib/core/config/env.ts +++ b/apps/sim/lib/core/config/env.ts @@ -417,7 +417,7 @@ export const env = createEnv({ PIPEDRIVE_CLIENT_SECRET: z.string().optional(), // Pipedrive OAuth client secret QUICKBOOKS_CLIENT_ID: z.string().optional(), // QuickBooks Online OAuth client ID QUICKBOOKS_CLIENT_SECRET: z.string().optional(), // QuickBooks Online OAuth client secret - QUICKBOOKS_ENV: z.enum(['sandbox', 'production']).optional(), // QuickBooks Online API environment (defaults to sandbox) + QUICKBOOKS_ENV: z.enum(['sandbox', 'production']).optional(), // QuickBooks Online API environment (must be configured explicitly) LINEAR_CLIENT_ID: z.string().optional(), // Linear OAuth client ID LINEAR_CLIENT_SECRET: z.string().optional(), // Linear OAuth client secret CLICKUP_CLIENT_ID: z.string().optional(), // ClickUp OAuth client ID diff --git a/apps/sim/lib/credentials/draft-processor.test.ts b/apps/sim/lib/credentials/draft-processor.test.ts new file mode 100644 index 00000000000..7239215f26f --- /dev/null +++ b/apps/sim/lib/credentials/draft-processor.test.ts @@ -0,0 +1,113 @@ +import { beforeEach, describe, expect, it, vi } from 'vitest' + +const mocks = vi.hoisted(() => ({ + limit: vi.fn(), + deleteWhere: vi.fn(), + handleCreate: vi.fn(), + handleReconnect: vi.fn(), + loggerError: vi.fn(), + loggerInfo: vi.fn(), +})) + +vi.mock('@sim/db', () => ({ + db: { + select: vi.fn(() => ({ + from: vi.fn(() => ({ + where: vi.fn(() => ({ + limit: mocks.limit, + })), + })), + })), + delete: vi.fn(() => ({ + where: mocks.deleteWhere, + })), + }, +})) + +vi.mock('@sim/logger', () => ({ + createLogger: () => ({ + error: mocks.loggerError, + info: mocks.loggerInfo, + }), +})) + +vi.mock('@/lib/credentials/draft-hooks', () => ({ + handleCreateCredentialFromDraft: mocks.handleCreate, + handleReconnectCredential: mocks.handleReconnect, +})) + +import { processCredentialDraft } from '@/lib/credentials/draft-processor' + +const draft = { + id: 'draft-1', + userId: 'user-1', + workspaceId: 'workspace-1', + providerId: 'quickbooks', + displayName: 'QuickBooks', + description: null, + credentialId: null, + expiresAt: new Date(Date.now() + 60_000), + createdAt: new Date(), +} + +describe('processCredentialDraft', () => { + beforeEach(() => { + vi.clearAllMocks() + }) + + it('does nothing when no matching draft exists', async () => { + mocks.limit.mockResolvedValueOnce([]) + + await processCredentialDraft({ + userId: 'user-1', + providerId: 'quickbooks', + accountId: 'account-1', + }) + + expect(mocks.limit).toHaveBeenCalledWith(2) + expect(mocks.handleCreate).not.toHaveBeenCalled() + expect(mocks.handleReconnect).not.toHaveBeenCalled() + expect(mocks.deleteWhere).not.toHaveBeenCalled() + }) + + it('creates a credential when exactly one matching draft exists', async () => { + mocks.limit.mockResolvedValueOnce([draft]) + + await processCredentialDraft({ + userId: 'user-1', + providerId: 'quickbooks', + accountId: 'account-1', + }) + + expect(mocks.handleCreate).toHaveBeenCalledWith( + expect.objectContaining({ + draft, + accountId: 'account-1', + providerId: 'quickbooks', + userId: 'user-1', + }) + ) + expect(mocks.deleteWhere).toHaveBeenCalledTimes(1) + }) + + it('fails closed instead of binding an account when multiple workspaces have drafts', async () => { + mocks.limit.mockResolvedValueOnce([ + draft, + { ...draft, id: 'draft-2', workspaceId: 'workspace-2' }, + ]) + + await processCredentialDraft({ + userId: 'user-1', + providerId: 'quickbooks', + accountId: 'account-1', + }) + + expect(mocks.handleCreate).not.toHaveBeenCalled() + expect(mocks.handleReconnect).not.toHaveBeenCalled() + expect(mocks.deleteWhere).not.toHaveBeenCalled() + expect(mocks.loggerError).toHaveBeenCalledWith( + 'Refusing to process ambiguous credential drafts', + expect.objectContaining({ userId: 'user-1', providerId: 'quickbooks', draftCount: 2 }) + ) + }) +}) diff --git a/apps/sim/lib/credentials/draft-processor.ts b/apps/sim/lib/credentials/draft-processor.ts index b7b9f5cd931..fed14353f6b 100644 --- a/apps/sim/lib/credentials/draft-processor.ts +++ b/apps/sim/lib/credentials/draft-processor.ts @@ -18,12 +18,14 @@ interface ProcessCredentialDraftParams { /** * Looks up a pending credential draft for the given user/provider and processes it. * Creates a new credential or reconnects an existing one depending on the draft state. + * If more than one workspace has a matching draft, fail closed: an uncorrelated + * OAuth callback cannot safely determine which workspace initiated the connection. * Used by Better Auth's `account.create.after` hook and custom OAuth flows (Shopify, Trello). */ export async function processCredentialDraft(params: ProcessCredentialDraftParams): Promise { const { userId, providerId, accountId } = params - const [draft] = await db + const drafts = await db .select() .from(schema.pendingCredentialDraft) .where( @@ -33,9 +35,18 @@ export async function processCredentialDraft(params: ProcessCredentialDraftParam sql`${schema.pendingCredentialDraft.expiresAt} > NOW()` ) ) - .limit(1) + .limit(2) + const [draft] = drafts if (!draft) return + if (drafts.length > 1) { + logger.error('Refusing to process ambiguous credential drafts', { + userId, + providerId, + draftCount: drafts.length, + }) + return + } const now = new Date() diff --git a/apps/sim/lib/oauth/quickbooks.test.ts b/apps/sim/lib/oauth/quickbooks.test.ts index 0bc6ffd3c95..0219bd58811 100644 --- a/apps/sim/lib/oauth/quickbooks.test.ts +++ b/apps/sim/lib/oauth/quickbooks.test.ts @@ -3,10 +3,13 @@ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest' import { createQuickBooksAccountId, fetchQuickBooksConnectionProfile, + getQuickBooksCallbackRealm, + normalizeQuickBooksRealmId, parseQuickBooksAccountId, QUICKBOOKS_AUTHORIZATION_URL, QUICKBOOKS_OIDC_CLAIMS, QUICKBOOKS_TOKEN_URL, + withQuickBooksCallbackRealm, } from '@/lib/oauth/quickbooks' import { QUICKBOOKS_MAX_USER_INFO_BYTES } from '@/lib/quickbooks/client' @@ -51,6 +54,28 @@ describe('QuickBooks account identity', () => { expect(parseQuickBooksAccountId(second).realmId).toBe('222') }) + it('keeps callback company identity isolated to the current async OAuth request', async () => { + expect(() => getQuickBooksCallbackRealm()).toThrow(/did not include a company identity/) + + const realms = await Promise.all([ + withQuickBooksCallbackRealm('111', async () => { + await Promise.resolve() + return getQuickBooksCallbackRealm() + }), + withQuickBooksCallbackRealm('222', async () => { + await Promise.resolve() + return getQuickBooksCallbackRealm() + }), + ]) + + expect(realms).toEqual(['111', '222']) + expect(() => getQuickBooksCallbackRealm()).toThrow(/did not include a company identity/) + }) + + it.each(['', '0', '-1', 'abc', '1:2'])('rejects an invalid callback realm: %s', (realmId) => { + expect(() => normalizeQuickBooksRealmId(realmId)).toThrow(/Reconnect the QuickBooks credential/) + }) + it.each([ 'quickbooks:123:subject', 'quickbooks:not-numeric:subject-01234567-89ab-4def-8abc-0123456789ab', @@ -80,13 +105,13 @@ describe('QuickBooks connection profile', () => { .mockResolvedValueOnce( new Response( JSON.stringify({ - CompanyInfo: { Id: '123456789', CompanyName: 'Sanitized Company' }, + CompanyInfo: { Id: '1', CompanyName: 'Sanitized Company' }, }) ) ) global.fetch = fetchMock - const result = await fetchQuickBooksConnectionProfile('fresh-access-token') + const result = await fetchQuickBooksConnectionProfile('fresh-access-token', '123456789') expect(result).toMatchObject({ realmId: '123456789', @@ -100,16 +125,48 @@ describe('QuickBooks connection profile', () => { expect(fetchMock.mock.calls[0][0]).toBe( 'https://sandbox-accounts.platform.intuit.com/v1/openid_connect/userinfo' ) + expect(fetchMock.mock.calls[0][1]?.signal).toBeInstanceOf(AbortSignal) expect(fetchMock.mock.calls[1][0].toString()).toContain( '/v3/company/123456789/companyinfo/123456789?minorversion=75' ) + expect(fetchMock.mock.calls[1][1]?.signal).toBeInstanceOf(AbortSignal) + }) + + it('binds the callback realm when UserInfo omits realmId', async () => { + const fetchMock = vi + .fn() + .mockResolvedValueOnce( + new Response( + JSON.stringify({ + sub: 'intuit-subject', + email: 'verified@example.test', + emailVerified: true, + givenName: 'Sanitized', + familyName: 'User', + }) + ) + ) + .mockResolvedValueOnce( + new Response( + JSON.stringify({ + CompanyInfo: { Id: '1', CompanyName: 'Sanitized Company' }, + }) + ) + ) + global.fetch = fetchMock + + const result = await fetchQuickBooksConnectionProfile('fresh-access-token', '123456789') + + expect(result.realmId).toBe('123456789') + expect(fetchMock).toHaveBeenCalledTimes(2) }) - it('rejects missing realmId without falling back to the callback or ID token', async () => { + it('rejects conflicting callback and UserInfo company identities', async () => { const fetchMock = vi.fn().mockResolvedValue( new Response( JSON.stringify({ sub: 'intuit-subject', + realmId: '987654321', email: 'verified@example.test', emailVerified: true, givenName: 'Sanitized', @@ -119,9 +176,9 @@ describe('QuickBooks connection profile', () => { ) global.fetch = fetchMock - await expect(fetchQuickBooksConnectionProfile('fresh-access-token')).rejects.toThrow( - 'required user and company identity' - ) + await expect( + fetchQuickBooksConnectionProfile('fresh-access-token', '123456789') + ).rejects.toThrow('different company identities') expect(fetchMock).toHaveBeenCalledTimes(1) }) @@ -156,31 +213,41 @@ describe('QuickBooks connection profile', () => { ) global.fetch = fetchMock - await expect(fetchQuickBooksConnectionProfile('fresh-access-token')).rejects.toThrow( + await expect( + fetchQuickBooksConnectionProfile('fresh-access-token', '123456789') + ).rejects.toThrow( /QuickBooks company validation failed.*3200.*Token expired or invalid.*Reconnect/ ) expect(fetchMock).toHaveBeenCalledTimes(2) }) - it('requires Intuit to verify the returned email address', async () => { - const fetchMock = vi.fn().mockResolvedValue( - new Response( - JSON.stringify({ - sub: 'intuit-subject', - realmId: '123456789', - email: 'unverified@example.test', - emailVerified: false, - givenName: 'Sanitized', - familyName: 'User', - }) + it('preserves an unverified UserInfo email without treating it as a Sim login identity', async () => { + const fetchMock = vi + .fn() + .mockResolvedValueOnce( + new Response( + JSON.stringify({ + sub: 'intuit-subject', + realmId: '123456789', + email: 'unverified@example.test', + givenName: 'Sanitized', + familyName: 'User', + }) + ) + ) + .mockResolvedValueOnce( + new Response( + JSON.stringify({ + CompanyInfo: { Id: '1', CompanyName: 'Sanitized Company' }, + }) + ) ) - ) global.fetch = fetchMock - await expect(fetchQuickBooksConnectionProfile('fresh-access-token')).rejects.toThrow( - 'verified email address' - ) - expect(fetchMock).toHaveBeenCalledTimes(1) + const result = await fetchQuickBooksConnectionProfile('fresh-access-token', '123456789') + + expect(result.emailVerified).toBe(false) + expect(fetchMock).toHaveBeenCalledTimes(2) }) it('rejects UserInfo larger than 1 MiB before parsing or company validation', async () => { @@ -195,9 +262,9 @@ describe('QuickBooks connection profile', () => { ) global.fetch = fetchMock - await expect(fetchQuickBooksConnectionProfile('fresh-access-token')).rejects.toThrow( - /exceeds maximum size/ - ) + await expect( + fetchQuickBooksConnectionProfile('fresh-access-token', '123456789') + ).rejects.toThrow(/exceeds maximum size/) expect(fetchMock).toHaveBeenCalledTimes(1) }) }) diff --git a/apps/sim/lib/oauth/quickbooks.ts b/apps/sim/lib/oauth/quickbooks.ts index b47b516fe62..442690b0bc4 100644 --- a/apps/sim/lib/oauth/quickbooks.ts +++ b/apps/sim/lib/oauth/quickbooks.ts @@ -1,3 +1,4 @@ +import { AsyncLocalStorage } from 'node:async_hooks' import { generateId } from '@sim/utils/id' import { readResponseJsonWithLimit, @@ -6,13 +7,15 @@ import { import { fetchValidatedQuickBooksCompanyInfo, getQuickBooksUserInfoUrl, + normalizeQuickBooksRealmId as normalizeRealmId, QUICKBOOKS_MAX_USER_INFO_BYTES, + QUICKBOOKS_OAUTH_REQUEST_TIMEOUT_MS, } from '@/lib/quickbooks/client' const QUICKBOOKS_ACCOUNT_PREFIX = 'quickbooks:' -const QUICKBOOKS_REALM_ID_PATTERN = /^[1-9]\d*$/ const UUID_SUFFIX_PATTERN = /-([0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})$/i +const quickBooksCallbackRealmStorage = new AsyncLocalStorage() export const QUICKBOOKS_AUTHORIZATION_URL = 'https://appcenter.intuit.com/connect/oauth2' export const QUICKBOOKS_TOKEN_URL = 'https://oauth.platform.intuit.com/oauth2/v1/tokens/bearer' @@ -30,15 +33,23 @@ export interface QuickBooksConnectionProfile extends QuickBooksAccountIdentity { accountId: string name: string email: string - emailVerified: true + emailVerified: boolean } -function normalizeRealmId(realmId: string): string { - const normalized = realmId.trim() - if (!QUICKBOOKS_REALM_ID_PATTERN.test(normalized)) { - throw new Error('QuickBooks company identity is invalid. Reconnect the QuickBooks credential.') +export const normalizeQuickBooksRealmId = normalizeRealmId + +export function withQuickBooksCallbackRealm(realmId: string, callback: () => T): T { + return quickBooksCallbackRealmStorage.run(normalizeQuickBooksRealmId(realmId), callback) +} + +export function getQuickBooksCallbackRealm(): string { + const realmId = quickBooksCallbackRealmStorage.getStore() + if (!realmId) { + throw new Error( + 'QuickBooks callback did not include a company identity. Reconnect the QuickBooks credential.' + ) } - return normalized + return realmId } function normalizeSubject(subject: string): string { @@ -54,7 +65,7 @@ export function createQuickBooksAccountId( subject: string, uniqueId = generateId() ): string { - return `${QUICKBOOKS_ACCOUNT_PREFIX}${normalizeRealmId(realmId)}:${normalizeSubject(subject)}-${uniqueId}` + return `${QUICKBOOKS_ACCOUNT_PREFIX}${normalizeQuickBooksRealmId(realmId)}:${normalizeSubject(subject)}-${uniqueId}` } export function parseQuickBooksAccountId(accountId: string): QuickBooksAccountIdentity { @@ -68,7 +79,7 @@ export function parseQuickBooksAccountId(accountId: string): QuickBooksAccountId throw new Error('QuickBooks company identity is invalid. Reconnect the QuickBooks credential.') } - const realmId = normalizeRealmId(value.slice(0, separatorIndex)) + const realmId = normalizeQuickBooksRealmId(value.slice(0, separatorIndex)) const subjectWithUuid = value.slice(separatorIndex + 1) const uuidMatch = subjectWithUuid.match(UUID_SUFFIX_PATTERN) if (!uuidMatch) { @@ -80,10 +91,13 @@ export function parseQuickBooksAccountId(accountId: string): QuickBooksAccountId } export async function fetchQuickBooksConnectionProfile( - accessToken: string + accessToken: string, + callbackRealmId: string ): Promise { + const realmId = normalizeQuickBooksRealmId(callbackRealmId) const response = await fetch(getQuickBooksUserInfoUrl(), { headers: { Authorization: `Bearer ${accessToken}` }, + signal: AbortSignal.timeout(QUICKBOOKS_OAUTH_REQUEST_TIMEOUT_MS), }) if (!response.ok) { await readResponseTextWithLimit(response, { @@ -111,28 +125,28 @@ export async function fetchQuickBooksConnectionProfile( }) const subject = profile.sub?.trim() - const realmId = (profile.realmId ?? profile.realmid)?.trim() + const claimedRealmId = (profile.realmId ?? profile.realmid)?.trim() const email = profile.email?.trim() const givenName = (profile.givenName ?? profile.given_name)?.trim() const familyName = (profile.familyName ?? profile.family_name)?.trim() const name = profile.name?.trim() || [givenName, familyName].filter(Boolean).join(' ') const emailVerified = profile.emailVerified ?? profile.email_verified ?? false - if (!subject || !realmId || !email || !name) { - throw new Error('QuickBooks UserInfo did not return the required user and company identity') + if (!subject || !email || !name) { + throw new Error('QuickBooks UserInfo did not return the required user identity') } - if (!emailVerified) { - throw new Error('QuickBooks UserInfo did not return a verified email address') + if (claimedRealmId && normalizeQuickBooksRealmId(claimedRealmId) !== realmId) { + throw new Error('QuickBooks callback and UserInfo returned different company identities') } await fetchValidatedQuickBooksCompanyInfo(accessToken, realmId) return { accountId: createQuickBooksAccountId(realmId, subject), - realmId: normalizeRealmId(realmId), + realmId, subject: normalizeSubject(subject), name, email, - emailVerified: true, + emailVerified, } } diff --git a/apps/sim/lib/quickbooks/client.ts b/apps/sim/lib/quickbooks/client.ts index 8d1bfba2688..b12a27ad120 100644 --- a/apps/sim/lib/quickbooks/client.ts +++ b/apps/sim/lib/quickbooks/client.ts @@ -8,6 +8,8 @@ import { formatQuickBooksFaultDetail, sanitizeQuickBooksFaultData } from '@/lib/ export const QUICKBOOKS_MINOR_VERSION = '75' export const QUICKBOOKS_MAX_RESPONSE_BYTES = 8 * 1024 * 1024 export const QUICKBOOKS_MAX_USER_INFO_BYTES = 1024 * 1024 +export const QUICKBOOKS_OAUTH_REQUEST_TIMEOUT_MS = 15_000 +const QUICKBOOKS_MAX_VALIDATION_ERROR_BYTES = 64 * 1024 export type QuickBooksEnvironment = 'sandbox' | 'production' @@ -75,6 +77,49 @@ export interface QuickBooksCompanyInfoEnvelope { time?: string } +function getQuickBooksTrackingId(headers: Headers): string | null { + return ( + headers.get('intuit_tid') ?? headers.get('intuit-tid') ?? headers.get('x-request-id') ?? null + ) +} + +function getQuickBooksCompanyValidationGuidance(status: number): string | null { + if (status === 401) return 'Reconnect the QuickBooks credential.' + if (status === 403) { + return 'Confirm the QuickBooks accounting scope and access to this company.' + } + if (status === 429) { + return 'QuickBooks rate limit reached; retry after the indicated delay.' + } + return null +} + +function createQuickBooksCompanyValidationError(response: Response, responseText: string): Error { + let faultDetail = '' + if (responseText) { + try { + const fault = sanitizeQuickBooksFaultData(JSON.parse(responseText)) + if (fault) faultDetail = formatQuickBooksFaultDetail(fault) + } catch { + // Intuit can return HTML or an empty response for gateway failures. + } + } + + const trackingId = getQuickBooksTrackingId(response.headers) + const retryAfter = response.headers.get('retry-after') + return new Error( + [ + `QuickBooks company validation failed with HTTP ${response.status}.`, + getQuickBooksCompanyValidationGuidance(response.status), + faultDetail, + trackingId ? `(Intuit tracking ID: ${trackingId})` : null, + response.status === 429 && retryAfter ? `(Retry-After: ${retryAfter})` : null, + ] + .filter(Boolean) + .join(' ') + ) +} + export async function fetchValidatedQuickBooksCompanyInfo( accessToken: string, realmId: string @@ -88,15 +133,23 @@ export async function fetchValidatedQuickBooksCompanyInfo( { method: 'GET', headers: buildQuickBooksHeaders(accessToken), + signal: AbortSignal.timeout(QUICKBOOKS_OAUTH_REQUEST_TIMEOUT_MS), } ) if (!response.ok) { - await readResponseTextWithLimit(response, { - maxBytes: 64 * 1024, - label: 'QuickBooks CompanyInfo error response', - }).catch(() => {}) - throw new Error(`QuickBooks company validation failed with HTTP ${response.status}`) + let responseText = '' + try { + responseText = await readResponseTextWithLimit(response, { + maxBytes: QUICKBOOKS_MAX_VALIDATION_ERROR_BYTES, + label: 'QuickBooks CompanyInfo error response', + }) + } catch { + throw new Error( + `QuickBooks company validation failed with HTTP ${response.status}. The error response exceeded the safe size limit.` + ) + } + throw createQuickBooksCompanyValidationError(response, responseText) } const data = await readResponseJsonWithLimit(response, { @@ -114,10 +167,8 @@ export async function fetchValidatedQuickBooksCompanyInfo( ) } - if (!data.CompanyInfo || String(data.CompanyInfo.Id ?? '').trim() !== normalizedRealmId) { - throw new Error( - 'QuickBooks company validation returned a different company. Reconnect the QuickBooks credential.' - ) + if (!data.CompanyInfo || typeof data.CompanyInfo !== 'object') { + throw new Error('QuickBooks company validation response is missing CompanyInfo') } return data diff --git a/apps/sim/tools/quickbooks/get_company_info.ts b/apps/sim/tools/quickbooks/get_company_info.ts index 6dbf88f050c..35f4e5f4a98 100644 --- a/apps/sim/tools/quickbooks/get_company_info.ts +++ b/apps/sim/tools/quickbooks/get_company_info.ts @@ -60,7 +60,7 @@ export const quickbooksGetCompanyInfoTool: ToolConfig< maxResponseBytes: QUICKBOOKS_MAX_RESPONSE_BYTES, }, transformResponse: async (response, params) => { - const realmId = normalizeQuickBooksRealmId(params?.realmId ?? '') + normalizeQuickBooksRealmId(params?.realmId ?? '') const data = await parseQuickBooksJson( response, 'QuickBooks CompanyInfo response' @@ -68,11 +68,6 @@ export const quickbooksGetCompanyInfoTool: ToolConfig< if (!data.CompanyInfo || typeof data.CompanyInfo !== 'object') { throw new Error('QuickBooks CompanyInfo response is missing CompanyInfo') } - if (String(data.CompanyInfo.Id ?? '').trim() !== realmId) { - throw new Error( - 'QuickBooks CompanyInfo response returned a different company. Reconnect the QuickBooks credential.' - ) - } return { success: true, output: { diff --git a/apps/sim/tools/quickbooks/quickbooks.test.ts b/apps/sim/tools/quickbooks/quickbooks.test.ts index d466dd3f9f7..ef2e3740569 100644 --- a/apps/sim/tools/quickbooks/quickbooks.test.ts +++ b/apps/sim/tools/quickbooks/quickbooks.test.ts @@ -88,30 +88,101 @@ describe('QuickBooks request construction', () => { }) describe('QuickBooks response contracts', () => { - it('validates CompanyInfo against the requested realm before accepting a connection', async () => { + it('validates the requested realm by successfully reading its CompanyInfo resource', async () => { const originalFetch = global.fetch - global.fetch = async () => - new Response( + const requestedUrls: string[] = [] + const requestSignals: Array = [] + global.fetch = async (input, init) => { + requestedUrls.push(input.toString()) + requestSignals.push(init?.signal) + return new Response( JSON.stringify({ - CompanyInfo: { Id: '123456789', CompanyName: 'Sanitized Company' }, + CompanyInfo: { Id: '1', CompanyName: 'Sanitized Company' }, time: 'test-time', }) ) + } try { await expect( fetchValidatedQuickBooksCompanyInfo('access-token', '123456789') ).resolves.toMatchObject({ - CompanyInfo: { Id: '123456789' }, + CompanyInfo: { Id: '1' }, }) - await expect(fetchValidatedQuickBooksCompanyInfo('access-token', '999')).rejects.toThrow( - 'different company' + expect(requestedUrls).toEqual([ + 'https://sandbox-quickbooks.api.intuit.com/v3/company/123456789/companyinfo/123456789?minorversion=75', + ]) + expect(requestSignals[0]).toBeInstanceOf(AbortSignal) + } finally { + global.fetch = originalFetch + } + }) + + it('preserves sanitized Intuit fault context for failed company validation', async () => { + const originalFetch = global.fetch + global.fetch = async () => + Response.json( + { + Fault: { + Error: [ + { + code: '3200', + Message: 'Authentication failed', + Detail: 'Token expired', + ignored: 'must not be surfaced', + }, + ], + }, + }, + { + status: 401, + headers: { intuit_tid: 'tracking-id' }, + } + ) + + try { + await expect( + fetchValidatedQuickBooksCompanyInfo('access-token', '123456789') + ).rejects.toThrow( + 'QuickBooks company validation failed with HTTP 401. Reconnect the QuickBooks credential. 3200: Authentication failed: Token expired (Intuit tracking ID: tracking-id)' ) } finally { global.fetch = originalFetch } }) + it('preserves Retry-After without exposing a non-JSON company validation body', async () => { + const originalFetch = global.fetch + global.fetch = async () => + new Response('sensitive gateway response', { + status: 429, + headers: { 'retry-after': '30' }, + }) + + try { + await expect( + fetchValidatedQuickBooksCompanyInfo('access-token', '123456789') + ).rejects.toThrow( + 'QuickBooks company validation failed with HTTP 429. QuickBooks rate limit reached; retry after the indicated delay. (Retry-After: 30)' + ) + } finally { + global.fetch = originalFetch + } + }) + + it('rejects a successful response without a CompanyInfo wrapper', async () => { + const originalFetch = global.fetch + global.fetch = async () => new Response(JSON.stringify({ time: 'test-time' })) + + try { + await expect( + fetchValidatedQuickBooksCompanyInfo('access-token', '123456789') + ).rejects.toThrow('missing CompanyInfo') + } finally { + global.fetch = originalFetch + } + }) + it('preserves populated entity objects and derives conservative pagination', async () => { const response = new Response( JSON.stringify({ @@ -337,14 +408,14 @@ describe('QuickBooks tool boundaries', () => { const result = await quickbooksGetCompanyInfoTool.transformResponse!( new Response( JSON.stringify({ - CompanyInfo: { Id: '123456789', CompanyName: 'Sanitized Company' }, + CompanyInfo: { Id: '1', CompanyName: 'Sanitized Company' }, time: 'test-time', }) ), authParams ) expect(result.output).toEqual({ - company: { Id: '123456789', CompanyName: 'Sanitized Company' }, + company: { Id: '1', CompanyName: 'Sanitized Company' }, time: 'test-time', }) }) @@ -358,19 +429,6 @@ describe('QuickBooks tool boundaries', () => { ).rejects.toThrow('missing CompanyInfo') }) - it('rejects CompanyInfo for a different realm', async () => { - await expect( - quickbooksGetCompanyInfoTool.transformResponse!( - new Response( - JSON.stringify({ - CompanyInfo: { Id: '999', CompanyName: 'Different Sanitized Company' }, - }) - ), - authParams - ) - ).rejects.toThrow('different company') - }) - it('recognizes a QuickBooks Fault in an HTTP 200 CompanyInfo response', async () => { await expect( quickbooksGetCompanyInfoTool.transformResponse!( diff --git a/apps/sim/tools/quickbooks/types.ts b/apps/sim/tools/quickbooks/types.ts index 336c3a433a2..3aa86c5eb36 100644 --- a/apps/sim/tools/quickbooks/types.ts +++ b/apps/sim/tools/quickbooks/types.ts @@ -154,7 +154,10 @@ export const QUICKBOOKS_METADATA_PROPERTIES: Record = { } export const QUICKBOOKS_COMPANY_INFO_PROPERTIES: Record = { - Id: { type: 'string', description: 'Connected QuickBooks company ID' }, + Id: { + type: 'string', + description: 'QuickBooks CompanyInfo entity ID (commonly "1"); this is not the OAuth realmId', + }, SyncToken: { type: 'string', description: 'CompanyInfo sync token', optional: true }, CompanyName: { type: 'string', description: 'Company display name', optional: true }, LegalName: { type: 'string', description: 'Company legal name', optional: true }, From 970d3b1e443dbc7915d23caede40e03e2b006e64 Mon Sep 17 00:00:00 2001 From: Bill Leoutsakos Date: Thu, 30 Jul 2026 19:52:44 -0700 Subject: [PATCH 08/12] fix(quickbooks): handle non-json token errors --- apps/sim/lib/auth/auth.ts | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/apps/sim/lib/auth/auth.ts b/apps/sim/lib/auth/auth.ts index d515cbb3b60..eecd0763a30 100644 --- a/apps/sim/lib/auth/auth.ts +++ b/apps/sim/lib/auth/auth.ts @@ -3244,13 +3244,21 @@ export const auth = betterAuth({ }), signal: AbortSignal.timeout(QUICKBOOKS_OAUTH_REQUEST_TIMEOUT_MS), }) + if (!response.ok) { + await readResponseTextWithLimit(response, { + maxBytes: DEFAULT_MAX_ERROR_BODY_BYTES, + label: 'QuickBooks OAuth token error response', + }).catch(() => {}) + throw new Error(`QuickBooks OAuth token exchange failed with HTTP ${response.status}`) + } + const data = await readResponseJsonWithLimit>(response, { maxBytes: DEFAULT_MAX_ERROR_BODY_BYTES, label: 'QuickBooks OAuth token response', }) - if (!response.ok || !data || typeof data !== 'object' || Array.isArray(data)) { - throw new Error(`QuickBooks OAuth token exchange failed with HTTP ${response.status}`) + if (!data || typeof data !== 'object' || Array.isArray(data)) { + throw new Error('QuickBooks OAuth token exchange returned an invalid response') } const tokens = getOAuth2Tokens(data) From 6df18b0d2162b6577de27a50253eca09800f5449 Mon Sep 17 00:00:00 2001 From: Bill Leoutsakos Date: Fri, 31 Jul 2026 18:27:38 -0700 Subject: [PATCH 09/12] refactor(quickbooks): align integration architecture --- apps/sim/lib/auth/auth.ts | 2 +- apps/sim/lib/oauth/quickbooks.test.ts | 2 +- apps/sim/lib/oauth/quickbooks.ts | 2 +- apps/sim/tools/error-extractors.ts | 2 +- apps/sim/tools/index.ts | 2 +- apps/sim/{lib => tools}/quickbooks/client.ts | 2 +- apps/sim/tools/quickbooks/error-extractor.test.ts | 2 +- apps/sim/{lib => tools}/quickbooks/fault.ts | 0 apps/sim/tools/quickbooks/get_company_info.ts | 4 ++-- apps/sim/tools/quickbooks/list_bills.ts | 2 +- apps/sim/tools/quickbooks/list_purchase_orders.ts | 2 +- apps/sim/tools/quickbooks/list_vendors.ts | 2 +- apps/sim/tools/quickbooks/quickbooks.test.ts | 4 ++-- apps/sim/tools/quickbooks/utils.ts | 6 +++--- 14 files changed, 17 insertions(+), 17 deletions(-) rename apps/sim/{lib => tools}/quickbooks/client.ts (99%) rename apps/sim/{lib => tools}/quickbooks/fault.ts (100%) diff --git a/apps/sim/lib/auth/auth.ts b/apps/sim/lib/auth/auth.ts index eecd0763a30..472b58af4b1 100644 --- a/apps/sim/lib/auth/auth.ts +++ b/apps/sim/lib/auth/auth.ts @@ -115,9 +115,9 @@ import { clearDeadFlag } from '@/lib/oauth/terminal-errors' import { getCanonicalScopesForProvider } from '@/lib/oauth/utils' import { joinInstanceOrganization } from '@/lib/organizations/instance-org' import { captureServerEvent, getPostHogClient } from '@/lib/posthog/server' -import { QUICKBOOKS_OAUTH_REQUEST_TIMEOUT_MS } from '@/lib/quickbooks/client' import { disableUserResources } from '@/lib/workflows/lifecycle' import { SSO_TRUSTED_PROVIDERS } from '@/ee/sso/constants' +import { QUICKBOOKS_OAUTH_REQUEST_TIMEOUT_MS } from '@/tools/quickbooks/client' const logger = createLogger('Auth') diff --git a/apps/sim/lib/oauth/quickbooks.test.ts b/apps/sim/lib/oauth/quickbooks.test.ts index 0219bd58811..178385e67b6 100644 --- a/apps/sim/lib/oauth/quickbooks.test.ts +++ b/apps/sim/lib/oauth/quickbooks.test.ts @@ -11,7 +11,7 @@ import { QUICKBOOKS_TOKEN_URL, withQuickBooksCallbackRealm, } from '@/lib/oauth/quickbooks' -import { QUICKBOOKS_MAX_USER_INFO_BYTES } from '@/lib/quickbooks/client' +import { QUICKBOOKS_MAX_USER_INFO_BYTES } from '@/tools/quickbooks/client' const TEST_UUID = '01234567-89ab-4def-8abc-0123456789ab' const originalFetch = global.fetch diff --git a/apps/sim/lib/oauth/quickbooks.ts b/apps/sim/lib/oauth/quickbooks.ts index 442690b0bc4..9b0550f2933 100644 --- a/apps/sim/lib/oauth/quickbooks.ts +++ b/apps/sim/lib/oauth/quickbooks.ts @@ -10,7 +10,7 @@ import { normalizeQuickBooksRealmId as normalizeRealmId, QUICKBOOKS_MAX_USER_INFO_BYTES, QUICKBOOKS_OAUTH_REQUEST_TIMEOUT_MS, -} from '@/lib/quickbooks/client' +} from '@/tools/quickbooks/client' const QUICKBOOKS_ACCOUNT_PREFIX = 'quickbooks:' const UUID_SUFFIX_PATTERN = diff --git a/apps/sim/tools/error-extractors.ts b/apps/sim/tools/error-extractors.ts index 8f04bc1b60d..a4ca876f44a 100644 --- a/apps/sim/tools/error-extractors.ts +++ b/apps/sim/tools/error-extractors.ts @@ -379,4 +379,4 @@ export const ErrorExtractorId = { HTTP_STATUS_TEXT: 'http-status-text', } as const -import { formatQuickBooksFaultDetail, sanitizeQuickBooksFaultData } from '@/lib/quickbooks/fault' +import { formatQuickBooksFaultDetail, sanitizeQuickBooksFaultData } from '@/tools/quickbooks/fault' diff --git a/apps/sim/tools/index.ts b/apps/sim/tools/index.ts index 55dc440a93d..dceb0ca9a09 100644 --- a/apps/sim/tools/index.ts +++ b/apps/sim/tools/index.ts @@ -30,7 +30,6 @@ import { isSameOrigin } from '@/lib/core/utils/validation' import { SIM_VIA_HEADER, serializeCallChain } from '@/lib/execution/call-chain' import { parseMcpToolId } from '@/lib/mcp/utils' import { hostedKeyMetrics } from '@/lib/monitoring/metrics' -import { sanitizeQuickBooksFaultData } from '@/lib/quickbooks/fault' import { resolveWorkspaceFileReference } from '@/lib/uploads/contexts/workspace/workspace-file-manager' import { assertPermissionsAllowed } from '@/ee/access-control/utils/permission-check' import { isCustomTool, isMcpTool } from '@/executor/constants' @@ -40,6 +39,7 @@ import { resolveEnvVarReferences } from '@/executor/utils/reference-validation' import type { ErrorInfo } from '@/tools/error-extractors' import { ErrorExtractorId, extractErrorMessage } from '@/tools/error-extractors' import { HostedKeyRateLimitedError, HostedKeyUnavailableError } from '@/tools/errors' +import { sanitizeQuickBooksFaultData } from '@/tools/quickbooks/fault' import type { BYOKProviderId, OAuthTokenPayload, diff --git a/apps/sim/lib/quickbooks/client.ts b/apps/sim/tools/quickbooks/client.ts similarity index 99% rename from apps/sim/lib/quickbooks/client.ts rename to apps/sim/tools/quickbooks/client.ts index b12a27ad120..20ccfd384d5 100644 --- a/apps/sim/lib/quickbooks/client.ts +++ b/apps/sim/tools/quickbooks/client.ts @@ -3,7 +3,7 @@ import { readResponseJsonWithLimit, readResponseTextWithLimit, } from '@/lib/core/utils/stream-limits' -import { formatQuickBooksFaultDetail, sanitizeQuickBooksFaultData } from '@/lib/quickbooks/fault' +import { formatQuickBooksFaultDetail, sanitizeQuickBooksFaultData } from '@/tools/quickbooks/fault' export const QUICKBOOKS_MINOR_VERSION = '75' export const QUICKBOOKS_MAX_RESPONSE_BYTES = 8 * 1024 * 1024 diff --git a/apps/sim/tools/quickbooks/error-extractor.test.ts b/apps/sim/tools/quickbooks/error-extractor.test.ts index 2eaca1756bb..b3e0aeca546 100644 --- a/apps/sim/tools/quickbooks/error-extractor.test.ts +++ b/apps/sim/tools/quickbooks/error-extractor.test.ts @@ -1,6 +1,6 @@ import { describe, expect, it } from 'vitest' -import { sanitizeQuickBooksFaultData } from '@/lib/quickbooks/fault' import { ErrorExtractorId, extractErrorMessage } from '@/tools/error-extractors' +import { sanitizeQuickBooksFaultData } from '@/tools/quickbooks/fault' describe('QuickBooks fault extraction', () => { it('parses Fault.Error entries with HTTP and tracking guidance', () => { diff --git a/apps/sim/lib/quickbooks/fault.ts b/apps/sim/tools/quickbooks/fault.ts similarity index 100% rename from apps/sim/lib/quickbooks/fault.ts rename to apps/sim/tools/quickbooks/fault.ts diff --git a/apps/sim/tools/quickbooks/get_company_info.ts b/apps/sim/tools/quickbooks/get_company_info.ts index 35f4e5f4a98..2a5f514d712 100644 --- a/apps/sim/tools/quickbooks/get_company_info.ts +++ b/apps/sim/tools/quickbooks/get_company_info.ts @@ -1,9 +1,9 @@ +import { ErrorExtractorId } from '@/tools/error-extractors' import { buildQuickBooksCompanyUrl, normalizeQuickBooksRealmId, QUICKBOOKS_MAX_RESPONSE_BYTES, -} from '@/lib/quickbooks/client' -import { ErrorExtractorId } from '@/tools/error-extractors' +} from '@/tools/quickbooks/client' import type { QuickBooksAuthParams, QuickBooksCompanyInfo, diff --git a/apps/sim/tools/quickbooks/list_bills.ts b/apps/sim/tools/quickbooks/list_bills.ts index 8fbfbfb4b28..94ccad97916 100644 --- a/apps/sim/tools/quickbooks/list_bills.ts +++ b/apps/sim/tools/quickbooks/list_bills.ts @@ -1,5 +1,5 @@ -import { QUICKBOOKS_MAX_RESPONSE_BYTES } from '@/lib/quickbooks/client' import { ErrorExtractorId } from '@/tools/error-extractors' +import { QUICKBOOKS_MAX_RESPONSE_BYTES } from '@/tools/quickbooks/client' import type { QuickBooksBill, QuickBooksListResponse, diff --git a/apps/sim/tools/quickbooks/list_purchase_orders.ts b/apps/sim/tools/quickbooks/list_purchase_orders.ts index a21efa4d879..babb8aa2d43 100644 --- a/apps/sim/tools/quickbooks/list_purchase_orders.ts +++ b/apps/sim/tools/quickbooks/list_purchase_orders.ts @@ -1,5 +1,5 @@ -import { QUICKBOOKS_MAX_RESPONSE_BYTES } from '@/lib/quickbooks/client' import { ErrorExtractorId } from '@/tools/error-extractors' +import { QUICKBOOKS_MAX_RESPONSE_BYTES } from '@/tools/quickbooks/client' import type { QuickBooksListResponse, QuickBooksPaginationParams, diff --git a/apps/sim/tools/quickbooks/list_vendors.ts b/apps/sim/tools/quickbooks/list_vendors.ts index 6ffc26ec3a0..051a48335df 100644 --- a/apps/sim/tools/quickbooks/list_vendors.ts +++ b/apps/sim/tools/quickbooks/list_vendors.ts @@ -1,5 +1,5 @@ -import { QUICKBOOKS_MAX_RESPONSE_BYTES } from '@/lib/quickbooks/client' import { ErrorExtractorId } from '@/tools/error-extractors' +import { QUICKBOOKS_MAX_RESPONSE_BYTES } from '@/tools/quickbooks/client' import type { QuickBooksListResponse, QuickBooksPaginationParams, diff --git a/apps/sim/tools/quickbooks/quickbooks.test.ts b/apps/sim/tools/quickbooks/quickbooks.test.ts index ef2e3740569..e054ef910ed 100644 --- a/apps/sim/tools/quickbooks/quickbooks.test.ts +++ b/apps/sim/tools/quickbooks/quickbooks.test.ts @@ -1,12 +1,12 @@ import { resetEnvMock, setEnv } from '@sim/testing' import { afterEach, beforeEach, describe, expect, it } from 'vitest' +import { QuickBooksBlock } from '@/blocks/blocks/quickbooks' import { fetchValidatedQuickBooksCompanyInfo, getQuickBooksEnvironment, getQuickBooksUserInfoUrl, QUICKBOOKS_MAX_RESPONSE_BYTES, -} from '@/lib/quickbooks/client' -import { QuickBooksBlock } from '@/blocks/blocks/quickbooks' +} from '@/tools/quickbooks/client' import { quickbooksGetCompanyInfoTool } from '@/tools/quickbooks/get_company_info' import { quickbooksListBillsTool } from '@/tools/quickbooks/list_bills' import { quickbooksListPurchaseOrdersTool } from '@/tools/quickbooks/list_purchase_orders' diff --git a/apps/sim/tools/quickbooks/utils.ts b/apps/sim/tools/quickbooks/utils.ts index 87a3a99f1a2..8db0725dc90 100644 --- a/apps/sim/tools/quickbooks/utils.ts +++ b/apps/sim/tools/quickbooks/utils.ts @@ -1,11 +1,11 @@ import { readResponseJsonWithLimit } from '@/lib/core/utils/stream-limits' +import { ErrorExtractorId, extractErrorMessage } from '@/tools/error-extractors' import { buildQuickBooksCompanyUrl, buildQuickBooksHeaders, QUICKBOOKS_MAX_RESPONSE_BYTES, -} from '@/lib/quickbooks/client' -import { sanitizeQuickBooksFaultData } from '@/lib/quickbooks/fault' -import { ErrorExtractorId, extractErrorMessage } from '@/tools/error-extractors' +} from '@/tools/quickbooks/client' +import { sanitizeQuickBooksFaultData } from '@/tools/quickbooks/fault' import type { QuickBooksListResponse, QuickBooksPaginationParams } from '@/tools/quickbooks/types' export type QuickBooksQueryEntity = 'Bill' | 'PurchaseOrder' | 'Vendor' From 23b30ac7cb547b6f30ac6675074ae2173d8a6e33 Mon Sep 17 00:00:00 2001 From: Bill Leoutsakos Date: Sat, 1 Aug 2026 11:14:37 -0700 Subject: [PATCH 10/12] fix(serializer): preserve singleton canonical values --- apps/sim/serializer/field-analysis.test.ts | 34 ++++++++++++++++++++++ apps/sim/serializer/index.ts | 2 +- 2 files changed, 35 insertions(+), 1 deletion(-) diff --git a/apps/sim/serializer/field-analysis.test.ts b/apps/sim/serializer/field-analysis.test.ts index 41d8dd6f201..7fe294d6807 100644 --- a/apps/sim/serializer/field-analysis.test.ts +++ b/apps/sim/serializer/field-analysis.test.ts @@ -213,4 +213,38 @@ describe('extractBlockParams', () => { expect(params.credential).toBeUndefined() expect(params.manualCredential).toBeUndefined() }) + + it('preserves a singleton canonical credential when additional fields are open', () => { + svcConfig.value = config([ + { + id: 'credential', + title: 'QuickBooks Account', + type: 'oauth-input', + canonicalParamId: 'oauthCredential', + required: true, + }, + { + id: 'privateNote', + title: 'Private Note', + type: 'long-input', + mode: 'advanced', + }, + ]) + + const state = block({ + type: 'svc', + advancedMode: true, + subBlocks: { + credential: { value: 'credential-id' }, + privateNote: { value: 'Updated through Sim' }, + }, + }) + const params = extractBlockParams(state) + const issues = collectBlockFieldIssues(state, svcConfig.value, params) + + expect(params.oauthCredential).toBe('credential-id') + expect(params.credential).toBeUndefined() + expect(params.privateNote).toBe('Updated through Sim') + expect(issues.missingRequiredFields).toEqual([]) + }) }) diff --git a/apps/sim/serializer/index.ts b/apps/sim/serializer/index.ts index 73c2b9f145b..8ef45da5c7a 100644 --- a/apps/sim/serializer/index.ts +++ b/apps/sim/serializer/index.ts @@ -569,7 +569,7 @@ export function extractBlockParams(block: BlockState): Record { const { basicValue, advancedValue } = getCanonicalValues(group, params) const hasExplicitOverride = canonicalModeOverrides?.[group.canonicalId] != null const pairMode = - hasExplicitOverride || !legacyAdvancedMode + !isCanonicalPair(group) || hasExplicitOverride || !legacyAdvancedMode ? resolveCanonicalMode(group, allValues, canonicalModeOverrides) : 'advanced' const chosen = pairMode === 'advanced' ? advancedValue : basicValue From 7f2dd272a1a26cf123e7ed5e19c047a00c0af253 Mon Sep 17 00:00:00 2001 From: Bill Leoutsakos Date: Sat, 1 Aug 2026 12:47:19 -0700 Subject: [PATCH 11/12] revert(credentials): defer ambiguous draft handling --- .../lib/credentials/draft-processor.test.ts | 113 ------------------ apps/sim/lib/credentials/draft-processor.ts | 15 +-- 2 files changed, 2 insertions(+), 126 deletions(-) delete mode 100644 apps/sim/lib/credentials/draft-processor.test.ts diff --git a/apps/sim/lib/credentials/draft-processor.test.ts b/apps/sim/lib/credentials/draft-processor.test.ts deleted file mode 100644 index 7239215f26f..00000000000 --- a/apps/sim/lib/credentials/draft-processor.test.ts +++ /dev/null @@ -1,113 +0,0 @@ -import { beforeEach, describe, expect, it, vi } from 'vitest' - -const mocks = vi.hoisted(() => ({ - limit: vi.fn(), - deleteWhere: vi.fn(), - handleCreate: vi.fn(), - handleReconnect: vi.fn(), - loggerError: vi.fn(), - loggerInfo: vi.fn(), -})) - -vi.mock('@sim/db', () => ({ - db: { - select: vi.fn(() => ({ - from: vi.fn(() => ({ - where: vi.fn(() => ({ - limit: mocks.limit, - })), - })), - })), - delete: vi.fn(() => ({ - where: mocks.deleteWhere, - })), - }, -})) - -vi.mock('@sim/logger', () => ({ - createLogger: () => ({ - error: mocks.loggerError, - info: mocks.loggerInfo, - }), -})) - -vi.mock('@/lib/credentials/draft-hooks', () => ({ - handleCreateCredentialFromDraft: mocks.handleCreate, - handleReconnectCredential: mocks.handleReconnect, -})) - -import { processCredentialDraft } from '@/lib/credentials/draft-processor' - -const draft = { - id: 'draft-1', - userId: 'user-1', - workspaceId: 'workspace-1', - providerId: 'quickbooks', - displayName: 'QuickBooks', - description: null, - credentialId: null, - expiresAt: new Date(Date.now() + 60_000), - createdAt: new Date(), -} - -describe('processCredentialDraft', () => { - beforeEach(() => { - vi.clearAllMocks() - }) - - it('does nothing when no matching draft exists', async () => { - mocks.limit.mockResolvedValueOnce([]) - - await processCredentialDraft({ - userId: 'user-1', - providerId: 'quickbooks', - accountId: 'account-1', - }) - - expect(mocks.limit).toHaveBeenCalledWith(2) - expect(mocks.handleCreate).not.toHaveBeenCalled() - expect(mocks.handleReconnect).not.toHaveBeenCalled() - expect(mocks.deleteWhere).not.toHaveBeenCalled() - }) - - it('creates a credential when exactly one matching draft exists', async () => { - mocks.limit.mockResolvedValueOnce([draft]) - - await processCredentialDraft({ - userId: 'user-1', - providerId: 'quickbooks', - accountId: 'account-1', - }) - - expect(mocks.handleCreate).toHaveBeenCalledWith( - expect.objectContaining({ - draft, - accountId: 'account-1', - providerId: 'quickbooks', - userId: 'user-1', - }) - ) - expect(mocks.deleteWhere).toHaveBeenCalledTimes(1) - }) - - it('fails closed instead of binding an account when multiple workspaces have drafts', async () => { - mocks.limit.mockResolvedValueOnce([ - draft, - { ...draft, id: 'draft-2', workspaceId: 'workspace-2' }, - ]) - - await processCredentialDraft({ - userId: 'user-1', - providerId: 'quickbooks', - accountId: 'account-1', - }) - - expect(mocks.handleCreate).not.toHaveBeenCalled() - expect(mocks.handleReconnect).not.toHaveBeenCalled() - expect(mocks.deleteWhere).not.toHaveBeenCalled() - expect(mocks.loggerError).toHaveBeenCalledWith( - 'Refusing to process ambiguous credential drafts', - expect.objectContaining({ userId: 'user-1', providerId: 'quickbooks', draftCount: 2 }) - ) - }) -}) diff --git a/apps/sim/lib/credentials/draft-processor.ts b/apps/sim/lib/credentials/draft-processor.ts index fed14353f6b..b7b9f5cd931 100644 --- a/apps/sim/lib/credentials/draft-processor.ts +++ b/apps/sim/lib/credentials/draft-processor.ts @@ -18,14 +18,12 @@ interface ProcessCredentialDraftParams { /** * Looks up a pending credential draft for the given user/provider and processes it. * Creates a new credential or reconnects an existing one depending on the draft state. - * If more than one workspace has a matching draft, fail closed: an uncorrelated - * OAuth callback cannot safely determine which workspace initiated the connection. * Used by Better Auth's `account.create.after` hook and custom OAuth flows (Shopify, Trello). */ export async function processCredentialDraft(params: ProcessCredentialDraftParams): Promise { const { userId, providerId, accountId } = params - const drafts = await db + const [draft] = await db .select() .from(schema.pendingCredentialDraft) .where( @@ -35,18 +33,9 @@ export async function processCredentialDraft(params: ProcessCredentialDraftParam sql`${schema.pendingCredentialDraft.expiresAt} > NOW()` ) ) - .limit(2) + .limit(1) - const [draft] = drafts if (!draft) return - if (drafts.length > 1) { - logger.error('Refusing to process ambiguous credential drafts', { - userId, - providerId, - draftCount: drafts.length, - }) - return - } const now = new Date() From 25a7532977ea1162ad0567e1b83b2a3faa963346 Mon Sep 17 00:00:00 2001 From: Bill Leoutsakos Date: Sat, 1 Aug 2026 12:53:14 -0700 Subject: [PATCH 12/12] chore(tools): sync QuickBooks metadata --- apps/sim/tools/generated/tool-ids.ts | 9 +++++++++ apps/sim/tools/generated/tool-metadata.ts | 9 +++++++++ apps/sim/tools/generated/tool-outputs.ts | 9 +++++++++ 3 files changed, 27 insertions(+) create mode 100644 apps/sim/tools/generated/tool-ids.ts create mode 100644 apps/sim/tools/generated/tool-metadata.ts create mode 100644 apps/sim/tools/generated/tool-outputs.ts diff --git a/apps/sim/tools/generated/tool-ids.ts b/apps/sim/tools/generated/tool-ids.ts new file mode 100644 index 00000000000..541416cff7e --- /dev/null +++ b/apps/sim/tools/generated/tool-ids.ts @@ -0,0 +1,9 @@ +// Generated by scripts/sync-tool-metadata.ts — do not edit. +// Regenerate with: bun run tool-metadata:generate + +/** Every registered tool id, including versioned variants. */ +const toolIds: string[] = JSON.parse( + '["a2a_cancel_task","a2a_get_agent_card","a2a_get_task","a2a_send_message","agentmail_create_draft","agentmail_create_inbox","agentmail_delete_draft","agentmail_delete_inbox","agentmail_delete_thread","agentmail_forward_message","agentmail_get_draft","agentmail_get_inbox","agentmail_get_message","agentmail_get_thread","agentmail_list_drafts","agentmail_list_inboxes","agentmail_list_messages","agentmail_list_threads","agentmail_reply_message","agentmail_send_draft","agentmail_send_message","agentmail_update_draft","agentmail_update_inbox","agentmail_update_message","agentmail_update_thread","agentphone_create_call","agentphone_create_contact","agentphone_create_number","agentphone_delete_contact","agentphone_get_call","agentphone_get_call_transcript","agentphone_get_contact","agentphone_get_conversation","agentphone_get_conversation_messages","agentphone_get_number_messages","agentphone_get_usage","agentphone_get_usage_daily","agentphone_get_usage_monthly","agentphone_list_calls","agentphone_list_contacts","agentphone_list_conversations","agentphone_list_numbers","agentphone_react_to_message","agentphone_release_number","agentphone_send_message","agentphone_update_contact","agentphone_update_conversation","agiloft_attach_file","agiloft_attachment_info","agiloft_create_record","agiloft_delete_record","agiloft_get_choice_line_id","agiloft_lock_record","agiloft_read_record","agiloft_remove_attachment","agiloft_retrieve_attachment","agiloft_saved_search","agiloft_search_records","agiloft_select_records","agiloft_update_record","ahrefs_anchors","ahrefs_backlinks","ahrefs_backlinks_stats","ahrefs_batch_analysis","ahrefs_broken_backlinks","ahrefs_domain_rating","ahrefs_domain_rating_history","ahrefs_keyword_overview","ahrefs_keywords_history","ahrefs_metrics","ahrefs_metrics_history","ahrefs_organic_competitors","ahrefs_organic_keywords","ahrefs_paid_pages","ahrefs_rank_tracker_competitors_overview","ahrefs_rank_tracker_competitors_stats","ahrefs_rank_tracker_overview","ahrefs_rank_tracker_serp_overview","ahrefs_refdomains_history","ahrefs_referring_domains","ahrefs_related_terms","ahrefs_site_audit_page_explorer","ahrefs_top_pages","airtable_create_records","airtable_delete_records","airtable_get_base_schema","airtable_get_record","airtable_list_bases","airtable_list_records","airtable_list_tables","airtable_update_multiple_records","airtable_update_record","airtable_upsert_records","airweave_search","algolia_add_record","algolia_batch_operations","algolia_browse_records","algolia_clear_records","algolia_copy_move_index","algolia_delete_by_filter","algolia_delete_index","algolia_delete_record","algolia_get_record","algolia_get_records","algolia_get_settings","algolia_get_task_status","algolia_list_indices","algolia_partial_update_record","algolia_search","algolia_update_settings","amplitude_event_segmentation","amplitude_funnels","amplitude_get_active_users","amplitude_get_revenue","amplitude_group_identify","amplitude_identify_user","amplitude_list_events","amplitude_realtime_active_users","amplitude_retention","amplitude_send_event","amplitude_user_activity","amplitude_user_profile","amplitude_user_search","apify_get_dataset_items","apify_get_run","apify_run_actor_async","apify_run_actor_sync","apify_run_task","apollo_account_bulk_create","apollo_account_bulk_update","apollo_account_create","apollo_account_search","apollo_account_update","apollo_contact_bulk_create","apollo_contact_bulk_update","apollo_contact_create","apollo_contact_search","apollo_contact_update","apollo_email_accounts","apollo_opportunity_create","apollo_opportunity_get","apollo_opportunity_search","apollo_opportunity_update","apollo_organization_bulk_enrich","apollo_organization_enrich","apollo_organization_search","apollo_people_bulk_enrich","apollo_people_enrich","apollo_people_search","apollo_sequence_add_contacts","apollo_sequence_search","apollo_task_create","apollo_task_search","appconfig_create_application","appconfig_create_configuration_profile","appconfig_create_environment","appconfig_create_hosted_configuration_version","appconfig_delete_application","appconfig_delete_configuration_profile","appconfig_delete_environment","appconfig_delete_hosted_configuration_version","appconfig_get_application","appconfig_get_configuration","appconfig_get_configuration_profile","appconfig_get_deployment","appconfig_get_environment","appconfig_get_hosted_configuration_version","appconfig_list_applications","appconfig_list_configuration_profiles","appconfig_list_deployment_strategies","appconfig_list_deployments","appconfig_list_environments","appconfig_list_hosted_configuration_versions","appconfig_start_deployment","appconfig_stop_deployment","appconfig_update_application","appconfig_update_configuration_profile","appconfig_update_environment","arxiv_get_author_papers","arxiv_get_paper","arxiv_search","asana_add_comment","asana_add_followers","asana_create_project","asana_create_section","asana_create_subtask","asana_create_task","asana_delete_task","asana_get_project","asana_get_projects","asana_get_task","asana_list_sections","asana_list_workspaces","asana_search_tasks","asana_update_task","ashby_add_candidate_tag","ashby_change_application_stage","ashby_create_application","ashby_create_candidate","ashby_create_note","ashby_get_application","ashby_get_candidate","ashby_get_job","ashby_get_job_posting","ashby_get_offer","ashby_list_applications","ashby_list_archive_reasons","ashby_list_candidate_tags","ashby_list_candidates","ashby_list_custom_fields","ashby_list_departments","ashby_list_interviews","ashby_list_job_postings","ashby_list_jobs","ashby_list_locations","ashby_list_notes","ashby_list_offers","ashby_list_openings","ashby_list_sources","ashby_list_users","ashby_remove_candidate_tag","ashby_search_candidates","ashby_update_candidate","athena_batch_get_query_execution","athena_create_named_query","athena_delete_named_query","athena_get_named_query","athena_get_query_execution","athena_get_query_results","athena_list_databases","athena_list_named_queries","athena_list_query_executions","athena_list_table_metadata","athena_start_query","athena_stop_query","attio_assert_record","attio_create_attribute","attio_create_comment","attio_create_list","attio_create_list_entry","attio_create_note","attio_create_object","attio_create_record","attio_create_task","attio_create_webhook","attio_delete_comment","attio_delete_list_entry","attio_delete_note","attio_delete_record","attio_delete_task","attio_delete_webhook","attio_get_attribute","attio_get_comment","attio_get_list","attio_get_list_entry","attio_get_member","attio_get_note","attio_get_object","attio_get_record","attio_get_task","attio_get_thread","attio_get_webhook","attio_list_attributes","attio_list_lists","attio_list_members","attio_list_notes","attio_list_objects","attio_list_records","attio_list_tasks","attio_list_threads","attio_list_webhooks","attio_query_list_entries","attio_search_records","attio_update_attribute","attio_update_list","attio_update_list_entry","attio_update_object","attio_update_record","attio_update_task","attio_update_webhook","azure_devops_add_comment","azure_devops_create_work_item","azure_devops_get_build_log","azure_devops_get_build_timeline","azure_devops_get_comments","azure_devops_get_pipeline","azure_devops_get_pipeline_run","azure_devops_get_work_item","azure_devops_get_work_items_batch","azure_devops_get_work_items_between_builds","azure_devops_list_build_logs","azure_devops_list_builds","azure_devops_list_pipeline_runs","azure_devops_list_pipelines","azure_devops_query_work_items","azure_devops_update_work_item","box_copy_file","box_create_folder","box_delete_file","box_delete_folder","box_download_file","box_get_file_info","box_list_folder_items","box_search","box_sign_cancel_request","box_sign_create_request","box_sign_get_request","box_sign_list_requests","box_sign_resend_request","box_update_file","box_upload_file","brandfetch_get_brand","brandfetch_search","brex_archive_budget","brex_create_budget","brex_create_spend_limit","brex_create_transfer","brex_create_vendor","brex_get_budget","brex_get_cash_account","brex_get_company","brex_get_current_user","brex_get_expense","brex_get_spend_limit","brex_get_transfer","brex_get_user","brex_get_vendor","brex_list_budgets","brex_list_card_accounts","brex_list_card_statements","brex_list_card_transactions","brex_list_cards","brex_list_cash_accounts","brex_list_cash_statements","brex_list_cash_transactions","brex_list_departments","brex_list_expenses","brex_list_locations","brex_list_spend_limits","brex_list_titles","brex_list_transfers","brex_list_users","brex_list_vendors","brex_match_receipt","brex_update_expense","brex_update_vendor","brex_upload_receipt","brightdata_cancel_snapshot","brightdata_discover","brightdata_download_snapshot","brightdata_scrape_dataset","brightdata_scrape_url","brightdata_serp_search","brightdata_snapshot_status","brightdata_sync_scrape","browser_use_run_task","buffer_create_idea","buffer_create_post","buffer_delete_post","buffer_edit_post","buffer_get_account","buffer_get_channels","buffer_get_idea_groups","buffer_get_ideas","buffer_get_post","buffer_get_posts","calcom_cancel_booking","calcom_confirm_booking","calcom_create_booking","calcom_create_event_type","calcom_create_schedule","calcom_decline_booking","calcom_delete_event_type","calcom_delete_schedule","calcom_get_booking","calcom_get_default_schedule","calcom_get_event_type","calcom_get_schedule","calcom_get_slots","calcom_list_bookings","calcom_list_event_types","calcom_list_schedules","calcom_reschedule_booking","calcom_update_event_type","calcom_update_schedule","calendly_cancel_event","calendly_create_webhook","calendly_delete_webhook","calendly_get_current_user","calendly_get_event_type","calendly_get_scheduled_event","calendly_list_event_invitees","calendly_list_event_types","calendly_list_scheduled_events","calendly_list_webhooks","clay_populate","clerk_add_organization_member","clerk_ban_user","clerk_create_actor_token","clerk_create_allowlist_identifier","clerk_create_blocklist_identifier","clerk_create_organization","clerk_create_organization_invitation","clerk_create_user","clerk_delete_allowlist_identifier","clerk_delete_blocklist_identifier","clerk_delete_organization","clerk_delete_user","clerk_get_jwt_template","clerk_get_organization","clerk_get_session","clerk_get_user","clerk_get_user_oauth_token","clerk_list_allowlist_identifiers","clerk_list_blocklist_identifiers","clerk_list_jwt_templates","clerk_list_organization_invitations","clerk_list_organization_memberships","clerk_list_organizations","clerk_list_sessions","clerk_list_users","clerk_lock_user","clerk_remove_organization_member","clerk_revoke_actor_token","clerk_revoke_session","clerk_unban_user","clerk_unlock_user","clerk_update_organization","clerk_update_organization_membership","clerk_update_user","clickhouse_count_rows","clickhouse_create_database","clickhouse_create_table","clickhouse_delete","clickhouse_describe_table","clickhouse_drop_database","clickhouse_drop_partition","clickhouse_drop_table","clickhouse_execute","clickhouse_insert","clickhouse_insert_rows","clickhouse_introspect","clickhouse_kill_query","clickhouse_list_clusters","clickhouse_list_databases","clickhouse_list_mutations","clickhouse_list_partitions","clickhouse_list_running_queries","clickhouse_list_tables","clickhouse_optimize_table","clickhouse_query","clickhouse_rename_table","clickhouse_show_create_table","clickhouse_table_stats","clickhouse_truncate_table","clickhouse_update","clickup_add_tag_to_task","clickup_create_checklist","clickup_create_checklist_item","clickup_create_comment","clickup_create_folder","clickup_create_list","clickup_create_task","clickup_create_time_entry","clickup_delete_checklist","clickup_delete_checklist_item","clickup_delete_comment","clickup_delete_task","clickup_delete_time_entry","clickup_get_comments","clickup_get_custom_fields","clickup_get_folders","clickup_get_list_members","clickup_get_lists","clickup_get_running_timer","clickup_get_space_tags","clickup_get_spaces","clickup_get_task","clickup_get_task_members","clickup_get_tasks","clickup_get_time_entries","clickup_get_workspaces","clickup_remove_custom_field_value","clickup_remove_tag_from_task","clickup_search_tasks","clickup_set_custom_field_value","clickup_start_timer","clickup_stop_timer","clickup_update_checklist","clickup_update_checklist_item","clickup_update_comment","clickup_update_task","clickup_update_time_entry","clickup_upload_attachment","cloudflare_create_dns_record","cloudflare_create_zone","cloudflare_delete_dns_record","cloudflare_delete_zone","cloudflare_dns_analytics","cloudflare_get_zone","cloudflare_get_zone_settings","cloudflare_list_certificates","cloudflare_list_dns_records","cloudflare_list_zones","cloudflare_purge_cache","cloudflare_update_dns_record","cloudflare_update_zone_setting","cloudformation_cancel_update_stack","cloudformation_create_change_set","cloudformation_create_stack","cloudformation_delete_stack","cloudformation_describe_change_set","cloudformation_describe_stack_drift_detection_status","cloudformation_describe_stack_events","cloudformation_describe_stacks","cloudformation_detect_stack_drift","cloudformation_execute_change_set","cloudformation_get_template","cloudformation_get_template_summary","cloudformation_list_stack_resources","cloudformation_update_stack","cloudformation_validate_template","cloudwatch_describe_alarm_history","cloudwatch_describe_alarms","cloudwatch_describe_log_groups","cloudwatch_describe_log_streams","cloudwatch_filter_log_events","cloudwatch_get_log_events","cloudwatch_get_metric_statistics","cloudwatch_list_metrics","cloudwatch_mute_alarm","cloudwatch_put_log_group_retention","cloudwatch_put_metric_data","cloudwatch_query_logs","cloudwatch_unmute_alarm","codepipeline_disable_stage_transition","codepipeline_enable_stage_transition","codepipeline_get_pipeline","codepipeline_get_pipeline_execution","codepipeline_get_pipeline_state","codepipeline_list_action_executions","codepipeline_list_pipeline_executions","codepipeline_list_pipelines","codepipeline_put_approval_result","codepipeline_retry_stage_execution","codepipeline_start_execution","codepipeline_stop_execution","confluence_add_label","confluence_create_blogpost","confluence_create_comment","confluence_create_page","confluence_create_page_property","confluence_create_space","confluence_create_space_property","confluence_delete_attachment","confluence_delete_blogpost","confluence_delete_comment","confluence_delete_label","confluence_delete_page","confluence_delete_page_property","confluence_delete_space","confluence_delete_space_property","confluence_get_blogpost","confluence_get_page_ancestors","confluence_get_page_children","confluence_get_page_descendants","confluence_get_page_version","confluence_get_pages_by_label","confluence_get_space","confluence_get_task","confluence_get_user","confluence_list_attachments","confluence_list_blogposts","confluence_list_blogposts_in_space","confluence_list_comments","confluence_list_labels","confluence_list_page_properties","confluence_list_page_versions","confluence_list_pages_in_space","confluence_list_space_labels","confluence_list_space_permissions","confluence_list_space_properties","confluence_list_spaces","confluence_list_tasks","confluence_retrieve","confluence_search","confluence_search_in_space","confluence_update","confluence_update_blogpost","confluence_update_comment","confluence_update_space","confluence_update_task","confluence_upload_attachment","context_dev_classify_naics","context_dev_classify_sic","context_dev_crawl","context_dev_extract","context_dev_extract_product","context_dev_extract_products","context_dev_get_brand","context_dev_get_brand_by_email","context_dev_get_brand_by_name","context_dev_get_brand_by_ticker","context_dev_identify_transaction","context_dev_map","context_dev_scrape_fonts","context_dev_scrape_html","context_dev_scrape_images","context_dev_scrape_markdown","context_dev_scrape_styleguide","context_dev_screenshot","context_dev_search","convex_action","convex_document_deltas","convex_list_documents","convex_list_tables","convex_mutation","convex_query","convex_run_function","crowdstrike_get_sensor_aggregates","crowdstrike_get_sensor_details","crowdstrike_query_sensors","cursor_add_followup","cursor_add_followup_v2","cursor_delete_agent","cursor_delete_agent_v2","cursor_download_artifact","cursor_download_artifact_v2","cursor_get_agent","cursor_get_agent_v2","cursor_get_api_key_info","cursor_get_api_key_info_v2","cursor_get_conversation","cursor_get_conversation_v2","cursor_launch_agent","cursor_launch_agent_v2","cursor_list_agents","cursor_list_agents_v2","cursor_list_artifacts","cursor_list_artifacts_v2","cursor_list_models","cursor_list_models_v2","cursor_list_repositories","cursor_list_repositories_v2","cursor_stop_agent","cursor_stop_agent_v2","dagster_delete_run","dagster_get_asset","dagster_get_run","dagster_get_run_logs","dagster_launch_run","dagster_list_assets","dagster_list_jobs","dagster_list_runs","dagster_list_schedules","dagster_list_sensors","dagster_materialize_assets","dagster_reexecute_run","dagster_report_asset_materialization","dagster_start_schedule","dagster_start_sensor","dagster_stop_schedule","dagster_stop_sensor","dagster_terminate_run","dagster_wipe_asset","databricks_cancel_run","databricks_execute_sql","databricks_get_cluster","databricks_get_job","databricks_get_run","databricks_get_run_output","databricks_get_statement","databricks_list_clusters","databricks_list_jobs","databricks_list_runs","databricks_list_warehouses","databricks_run_job","datadog_cancel_downtime","datadog_create_downtime","datadog_create_event","datadog_create_monitor","datadog_get_monitor","datadog_list_downtimes","datadog_list_monitors","datadog_mute_monitor","datadog_query_logs","datadog_query_timeseries","datadog_send_logs","datadog_submit_metrics","datagma_enrich_company","datagma_enrich_person","datagma_find_email","datagma_find_phone","datagma_get_credits","daytona_create_sandbox","daytona_delete_sandbox","daytona_download_file","daytona_execute_command","daytona_get_sandbox","daytona_git_clone","daytona_list_files","daytona_list_sandboxes","daytona_run_code","daytona_start_sandbox","daytona_stop_sandbox","daytona_upload_file","deployed_block_executor","deployments_deploy","deployments_get_version","deployments_list_versions","deployments_promote","deployments_undeploy","devin_append_session_tags","devin_archive_session","devin_create_session","devin_get_session","devin_get_session_tags","devin_list_session_attachments","devin_list_session_messages","devin_list_sessions","devin_replace_session_tags","devin_send_message","devin_terminate_session","discord_add_reaction","discord_archive_thread","discord_assign_role","discord_ban_member","discord_bulk_delete_messages","discord_create_channel","discord_create_invite","discord_create_role","discord_create_thread","discord_create_webhook","discord_delete_channel","discord_delete_invite","discord_delete_message","discord_delete_role","discord_delete_webhook","discord_edit_message","discord_execute_webhook","discord_get_channel","discord_get_invite","discord_get_member","discord_get_messages","discord_get_pinned_messages","discord_get_server","discord_get_user","discord_get_webhook","discord_join_thread","discord_kick_member","discord_leave_thread","discord_list_channels","discord_list_roles","discord_pin_message","discord_remove_reaction","discord_remove_role","discord_send_message","discord_unban_member","discord_unpin_message","discord_update_channel","discord_update_member","discord_update_role","docusign_create_from_template","docusign_download_document","docusign_get_envelope","docusign_list_envelopes","docusign_list_recipients","docusign_list_templates","docusign_send_envelope","docusign_void_envelope","downdetector_get_company","downdetector_get_company_attribution","downdetector_get_company_baseline","downdetector_get_company_events","downdetector_get_company_incidents","downdetector_get_company_indicators","downdetector_get_company_last_15","downdetector_get_company_status","downdetector_get_provider","downdetector_get_reports","downdetector_get_site_companies","downdetector_list_categories","downdetector_list_incidents","downdetector_list_sites","downdetector_search_companies","dropbox_copy","dropbox_create_folder","dropbox_create_shared_link","dropbox_delete","dropbox_download","dropbox_get_metadata","dropbox_list_folder","dropbox_list_revisions","dropbox_list_shared_links","dropbox_move","dropbox_restore","dropbox_search","dropbox_upload","dropcontact_enrich_contact","dspy_chain_of_thought","dspy_predict","dspy_react","dub_bulk_create_links","dub_bulk_delete_links","dub_bulk_update_links","dub_create_link","dub_create_tag","dub_delete_link","dub_get_analytics","dub_get_events","dub_get_link","dub_get_links_count","dub_get_qr_code","dub_list_domains","dub_list_folders","dub_list_links","dub_list_tags","dub_update_link","dub_upsert_link","duckduckgo_search","dynamodb_delete","dynamodb_get","dynamodb_introspect","dynamodb_put","dynamodb_query","dynamodb_scan","dynamodb_update","elasticsearch_bulk","elasticsearch_cluster_health","elasticsearch_cluster_stats","elasticsearch_count","elasticsearch_create_index","elasticsearch_delete_document","elasticsearch_delete_index","elasticsearch_get_document","elasticsearch_get_index","elasticsearch_index_document","elasticsearch_list_indices","elasticsearch_search","elasticsearch_update_document","elevenlabs_audio_isolation","elevenlabs_edit_voice_settings","elevenlabs_get_user","elevenlabs_get_voice","elevenlabs_get_voice_settings","elevenlabs_list_models","elevenlabs_list_voices","elevenlabs_sound_effects","elevenlabs_speech_to_speech","elevenlabs_tts","emailbison_attach_leads_to_campaign","emailbison_attach_tags_to_leads","emailbison_create_campaign","emailbison_create_lead","emailbison_create_tag","emailbison_get_lead","emailbison_list_campaigns","emailbison_list_leads","emailbison_list_replies","emailbison_list_tags","emailbison_update_campaign","emailbison_update_campaign_status","emailbison_update_lead","enrich_check_credits","enrich_company_funding","enrich_company_lookup","enrich_company_revenue","enrich_disposable_email_check","enrich_email_to_ip","enrich_email_to_person_lite","enrich_email_to_phone","enrich_email_to_profile","enrich_find_email","enrich_get_post_details","enrich_ip_to_company","enrich_linkedin_profile","enrich_linkedin_to_personal_email","enrich_linkedin_to_work_email","enrich_phone_finder","enrich_reverse_hash_lookup","enrich_sales_pointer_people","enrich_search_company","enrich_search_company_activities","enrich_search_company_employees","enrich_search_jobs","enrich_search_logo","enrich_search_people","enrich_search_people_activities","enrich_search_post_comments","enrich_search_post_comments_by_url","enrich_search_post_reactions","enrich_search_post_reactions_by_url","enrich_search_posts","enrich_search_similar_companies","enrich_verify_email","enrichment_run","enrow_find_email","enrow_verify_email","evernote_copy_note","evernote_create_note","evernote_create_notebook","evernote_create_tag","evernote_delete_note","evernote_get_note","evernote_get_notebook","evernote_list_notebooks","evernote_list_tags","evernote_search_notes","evernote_update_note","exa_agent","exa_answer","exa_find_similar_links","exa_get_contents","exa_search","extend_parser","extend_parser_v2","fathom_get_summary","fathom_get_transcript","fathom_list_meeting_types","fathom_list_meetings","fathom_list_team_members","fathom_list_teams","file_append","file_compress","file_decompress","file_fetch","file_get","file_get_content","file_manage_sharing","file_parser","file_parser_v2","file_parser_v3","file_read","file_write","findymail_find_email_from_linkedin","findymail_find_email_from_name","findymail_find_emails_by_domain","findymail_find_employees","findymail_find_phone","findymail_get_company","findymail_get_credits","findymail_lookup_technologies","findymail_reverse_email_lookup","findymail_search_technologies","findymail_verify_email","firecrawl_agent","firecrawl_batch_scrape","firecrawl_batch_scrape_status","firecrawl_cancel_crawl","firecrawl_crawl","firecrawl_crawl_status","firecrawl_credit_usage","firecrawl_extract","firecrawl_extract_status","firecrawl_map","firecrawl_parse","firecrawl_scrape","firecrawl_search","fireflies_add_to_live_meeting","fireflies_create_bite","fireflies_delete_transcript","fireflies_get_transcript","fireflies_get_user","fireflies_list_bites","fireflies_list_contacts","fireflies_list_transcripts","fireflies_list_users","fireflies_upload_audio","flint_create_task","flint_generate_pages","flint_get_task","function_execute","gamma_check_status","gamma_generate","gamma_generate_from_template","gamma_list_folders","gamma_list_themes","github_add_assignees","github_add_assignees_v2","github_add_labels","github_add_labels_v2","github_cancel_workflow_run","github_cancel_workflow_run_v2","github_check_star","github_check_star_v2","github_close_issue","github_close_issue_v2","github_close_pr","github_close_pr_v2","github_comment","github_comment_v2","github_compare_commits","github_compare_commits_v2","github_create_branch","github_create_branch_v2","github_create_comment_reaction","github_create_comment_reaction_v2","github_create_file","github_create_file_v2","github_create_gist","github_create_gist_v2","github_create_issue","github_create_issue_reaction","github_create_issue_reaction_v2","github_create_issue_v2","github_create_milestone","github_create_milestone_v2","github_create_pr","github_create_pr_review","github_create_pr_review_v2","github_create_pr_v2","github_create_project","github_create_project_v2","github_create_release","github_create_release_v2","github_delete_branch","github_delete_branch_v2","github_delete_comment","github_delete_comment_reaction","github_delete_comment_reaction_v2","github_delete_comment_v2","github_delete_file","github_delete_file_v2","github_delete_gist","github_delete_gist_v2","github_delete_issue_reaction","github_delete_issue_reaction_v2","github_delete_milestone","github_delete_milestone_v2","github_delete_project","github_delete_project_v2","github_delete_release","github_delete_release_v2","github_fork_gist","github_fork_gist_v2","github_fork_repo","github_fork_repo_v2","github_get_branch","github_get_branch_protection","github_get_branch_protection_v2","github_get_branch_v2","github_get_commit","github_get_commit_v2","github_get_file_content","github_get_file_content_v2","github_get_gist","github_get_gist_v2","github_get_issue","github_get_issue_v2","github_get_latest_release","github_get_latest_release_v2","github_get_milestone","github_get_milestone_v2","github_get_pr_files","github_get_pr_files_v2","github_get_project","github_get_project_v2","github_get_readme","github_get_readme_v2","github_get_release","github_get_release_v2","github_get_tree","github_get_tree_v2","github_get_workflow","github_get_workflow_run","github_get_workflow_run_v2","github_get_workflow_v2","github_issue_comment","github_issue_comment_v2","github_job_logs","github_latest_commit","github_latest_commit_v2","github_list_branches","github_list_branches_v2","github_list_commits","github_list_commits_v2","github_list_forks","github_list_forks_v2","github_list_gists","github_list_gists_v2","github_list_issue_comments","github_list_issue_comments_v2","github_list_issues","github_list_issues_v2","github_list_milestones","github_list_milestones_v2","github_list_pr_comments","github_list_pr_comments_v2","github_list_projects","github_list_projects_v2","github_list_prs","github_list_prs_v2","github_list_releases","github_list_releases_v2","github_list_review_threads","github_list_stargazers","github_list_stargazers_v2","github_list_tags","github_list_tags_v2","github_list_workflow_runs","github_list_workflow_runs_v2","github_list_workflows","github_list_workflows_v2","github_merge_pr","github_merge_pr_v2","github_pr","github_pr_v2","github_remove_label","github_remove_label_v2","github_reply_review_thread","github_repo_info","github_repo_info_v2","github_request_reviewers","github_request_reviewers_v2","github_rerun_workflow","github_rerun_workflow_v2","github_resolve_review_thread","github_search_code","github_search_code_v2","github_search_commits","github_search_commits_v2","github_search_issues","github_search_issues_v2","github_search_repos","github_search_repos_v2","github_search_users","github_search_users_v2","github_star_gist","github_star_gist_v2","github_star_repo","github_star_repo_v2","github_status_check_rollup","github_trigger_workflow","github_trigger_workflow_v2","github_unstar_gist","github_unstar_gist_v2","github_unstar_repo","github_unstar_repo_v2","github_update_branch_protection","github_update_branch_protection_v2","github_update_comment","github_update_comment_v2","github_update_file","github_update_file_v2","github_update_gist","github_update_gist_v2","github_update_issue","github_update_issue_v2","github_update_milestone","github_update_milestone_v2","github_update_pr","github_update_pr_v2","github_update_project","github_update_project_v2","github_update_release","github_update_release_v2","gitlab_activate_user","gitlab_add_member","gitlab_add_saml_group_link","gitlab_approve_access_request","gitlab_approve_merge_request","gitlab_approve_user","gitlab_ban_user","gitlab_block_user","gitlab_cancel_pipeline","gitlab_compare_branches","gitlab_create_branch","gitlab_create_file","gitlab_create_issue","gitlab_create_issue_note","gitlab_create_merge_request","gitlab_create_merge_request_note","gitlab_create_pipeline","gitlab_create_release","gitlab_create_user","gitlab_deactivate_user","gitlab_delete_branch","gitlab_delete_issue","gitlab_delete_saml_group_link","gitlab_delete_user","gitlab_delete_user_identity","gitlab_deny_access_request","gitlab_get_file","gitlab_get_group","gitlab_get_issue","gitlab_get_job_log","gitlab_get_merge_request","gitlab_get_merge_request_changes","gitlab_get_pipeline","gitlab_get_project","gitlab_invite_member","gitlab_list_access_requests","gitlab_list_branches","gitlab_list_commits","gitlab_list_groups","gitlab_list_invitations","gitlab_list_issues","gitlab_list_members","gitlab_list_merge_requests","gitlab_list_pipeline_jobs","gitlab_list_pipelines","gitlab_list_projects","gitlab_list_releases","gitlab_list_repository_tree","gitlab_list_saml_group_links","gitlab_list_user_memberships","gitlab_merge_merge_request","gitlab_play_job","gitlab_reject_user","gitlab_remove_member","gitlab_retry_pipeline","gitlab_revoke_invitation","gitlab_search_users","gitlab_unban_user","gitlab_unblock_user","gitlab_update_file","gitlab_update_invitation","gitlab_update_issue","gitlab_update_member","gitlab_update_merge_request","gitlab_update_user","gmail_add_label","gmail_add_label_v2","gmail_archive","gmail_archive_v2","gmail_create_label_v2","gmail_delete","gmail_delete_draft_v2","gmail_delete_label_v2","gmail_delete_v2","gmail_draft","gmail_draft_v2","gmail_edit_draft_v2","gmail_get_draft_v2","gmail_get_thread_v2","gmail_list_drafts_v2","gmail_list_labels_v2","gmail_list_threads_v2","gmail_mark_read","gmail_mark_read_v2","gmail_mark_unread","gmail_mark_unread_v2","gmail_move","gmail_move_v2","gmail_read","gmail_read_v2","gmail_remove_label","gmail_remove_label_v2","gmail_search","gmail_search_v2","gmail_send","gmail_send_v2","gmail_trash_thread_v2","gmail_unarchive","gmail_unarchive_v2","gmail_untrash_thread_v2","gmail_update_label_v2","gong_aggregate_activity","gong_aggregate_by_period","gong_answered_scorecards","gong_ask_anything","gong_assign_flow_prospects","gong_create_call","gong_day_by_day_activity","gong_get_brief","gong_get_call","gong_get_call_transcript","gong_get_coaching","gong_get_extensive_calls","gong_get_folder_content","gong_get_logs","gong_get_prospect_flows","gong_get_user","gong_interaction_stats","gong_list_calls","gong_list_flows","gong_list_library_folders","gong_list_scorecards","gong_list_trackers","gong_list_users","gong_list_workspaces","gong_lookup_email","gong_lookup_phone","gong_purge_email_address","gong_purge_phone_number","gong_unassign_flow_prospects","google_ads_ad_performance","google_ads_campaign_performance","google_ads_list_ad_groups","google_ads_list_campaigns","google_ads_list_customers","google_ads_search","google_appsheet_add_rows","google_appsheet_delete_rows","google_appsheet_edit_rows","google_appsheet_find_rows","google_bigquery_create_dataset","google_bigquery_create_table","google_bigquery_delete_dataset","google_bigquery_delete_table","google_bigquery_get_query_results","google_bigquery_get_table","google_bigquery_insert_rows","google_bigquery_list_datasets","google_bigquery_list_table_data","google_bigquery_list_tables","google_bigquery_query","google_books_volume_details","google_books_volume_search","google_calendar_create","google_calendar_create_calendar","google_calendar_create_calendar_v2","google_calendar_create_v2","google_calendar_delete","google_calendar_delete_calendar","google_calendar_delete_calendar_v2","google_calendar_delete_v2","google_calendar_freebusy","google_calendar_freebusy_v2","google_calendar_get","google_calendar_get_v2","google_calendar_instances","google_calendar_instances_v2","google_calendar_invite","google_calendar_invite_v2","google_calendar_list","google_calendar_list_acl","google_calendar_list_acl_v2","google_calendar_list_calendars","google_calendar_list_calendars_v2","google_calendar_list_v2","google_calendar_move","google_calendar_move_v2","google_calendar_quick_add","google_calendar_quick_add_v2","google_calendar_share_calendar","google_calendar_share_calendar_v2","google_calendar_unshare_calendar","google_calendar_unshare_calendar_v2","google_calendar_update","google_calendar_update_acl","google_calendar_update_acl_v2","google_calendar_update_calendar","google_calendar_update_calendar_v2","google_calendar_update_v2","google_contacts_create","google_contacts_delete","google_contacts_get","google_contacts_list","google_contacts_search","google_contacts_update","google_docs_create","google_docs_create_named_range","google_docs_create_paragraph_bullets","google_docs_delete_content_range","google_docs_delete_named_range","google_docs_delete_paragraph_bullets","google_docs_insert_image","google_docs_insert_page_break","google_docs_insert_table","google_docs_insert_text","google_docs_read","google_docs_replace_text","google_docs_update_paragraph_style","google_docs_update_text_style","google_docs_write","google_drive_copy","google_drive_create_comment","google_drive_create_folder","google_drive_delete","google_drive_delete_comment","google_drive_download","google_drive_export","google_drive_get_about","google_drive_get_content","google_drive_get_file","google_drive_get_revision","google_drive_list","google_drive_list_comments","google_drive_list_permissions","google_drive_list_revisions","google_drive_move","google_drive_search","google_drive_share","google_drive_trash","google_drive_unshare","google_drive_untrash","google_drive_update","google_drive_upload","google_forms_batch_update","google_forms_create_form","google_forms_create_watch","google_forms_delete_watch","google_forms_get_form","google_forms_get_responses","google_forms_list_watches","google_forms_renew_watch","google_forms_set_publish_settings","google_groups_add_alias","google_groups_add_member","google_groups_create_group","google_groups_delete_group","google_groups_get_group","google_groups_get_member","google_groups_get_settings","google_groups_has_member","google_groups_list_aliases","google_groups_list_groups","google_groups_list_members","google_groups_remove_alias","google_groups_remove_member","google_groups_update_group","google_groups_update_member","google_groups_update_settings","google_maps_air_quality","google_maps_directions","google_maps_distance_matrix","google_maps_elevation","google_maps_geocode","google_maps_geolocate","google_maps_place_details","google_maps_places_nearby","google_maps_places_search","google_maps_pollen","google_maps_reverse_geocode","google_maps_snap_to_roads","google_maps_solar","google_maps_speed_limits","google_maps_timezone","google_maps_validate_address","google_meet_create_space","google_meet_end_conference","google_meet_get_conference_record","google_meet_get_space","google_meet_list_conference_records","google_meet_list_participants","google_pagespeed_analyze","google_search","google_sheets_append","google_sheets_append_v2","google_sheets_batch_clear_v2","google_sheets_batch_get_v2","google_sheets_batch_update_v2","google_sheets_clear_v2","google_sheets_copy_sheet_v2","google_sheets_create_spreadsheet_v2","google_sheets_delete_rows_v2","google_sheets_delete_sheet_v2","google_sheets_delete_spreadsheet_v2","google_sheets_get_spreadsheet_v2","google_sheets_read","google_sheets_read_v2","google_sheets_update","google_sheets_update_v2","google_sheets_write","google_sheets_write_v2","google_slides_add_image","google_slides_add_slide","google_slides_batch_update","google_slides_copy_presentation","google_slides_create","google_slides_create_line","google_slides_create_paragraph_bullets","google_slides_create_shape","google_slides_create_sheets_chart","google_slides_create_table","google_slides_create_video","google_slides_delete_object","google_slides_delete_paragraph_bullets","google_slides_delete_table_column","google_slides_delete_table_row","google_slides_delete_text","google_slides_duplicate_object","google_slides_export_presentation","google_slides_get_page","google_slides_get_thumbnail","google_slides_group_objects","google_slides_insert_table_columns","google_slides_insert_table_rows","google_slides_insert_text","google_slides_merge_table_cells","google_slides_read","google_slides_refresh_sheets_chart","google_slides_replace_all_shapes_with_image","google_slides_replace_all_shapes_with_sheets_chart","google_slides_replace_all_text","google_slides_replace_image","google_slides_reroute_line","google_slides_ungroup_objects","google_slides_unmerge_table_cells","google_slides_update_image_properties","google_slides_update_line_category","google_slides_update_line_properties","google_slides_update_page_element_alt_text","google_slides_update_page_element_transform","google_slides_update_page_elements_z_order","google_slides_update_page_properties","google_slides_update_paragraph_style","google_slides_update_shape_properties","google_slides_update_slide_properties","google_slides_update_slides_position","google_slides_update_table_border_properties","google_slides_update_table_cell_properties","google_slides_update_table_column_properties","google_slides_update_table_row_properties","google_slides_update_text_style","google_slides_update_video_properties","google_slides_write","google_tasks_create","google_tasks_delete","google_tasks_get","google_tasks_list","google_tasks_list_task_lists","google_tasks_update","google_translate_detect","google_translate_text","google_vault_add_held_accounts","google_vault_add_matters_permissions","google_vault_close_matters","google_vault_create_matters","google_vault_create_matters_export","google_vault_create_matters_holds","google_vault_create_saved_query","google_vault_delete_matters","google_vault_delete_matters_export","google_vault_delete_matters_holds","google_vault_delete_saved_query","google_vault_download_export_file","google_vault_list_matters","google_vault_list_matters_export","google_vault_list_matters_holds","google_vault_list_saved_queries","google_vault_remove_held_accounts","google_vault_remove_matters_permissions","google_vault_reopen_matters","google_vault_undelete_matters","google_vault_update_matters","google_vault_update_matters_holds","grafana_check_data_source_health","grafana_create_alert_rule","grafana_create_annotation","grafana_create_contact_point","grafana_create_dashboard","grafana_create_folder","grafana_delete_alert_rule","grafana_delete_annotation","grafana_delete_dashboard","grafana_delete_folder","grafana_get_alert_rule","grafana_get_dashboard","grafana_get_data_source","grafana_get_folder","grafana_get_health","grafana_list_alert_rules","grafana_list_annotations","grafana_list_contact_points","grafana_list_dashboards","grafana_list_data_sources","grafana_list_folders","grafana_update_alert_rule","grafana_update_annotation","grafana_update_dashboard","grafana_update_folder","grain_create_hook","grain_create_hook_v2","grain_delete_hook","grain_delete_hook_v2","grain_get_recording","grain_get_transcript","grain_list_hooks","grain_list_hooks_v2","grain_list_meeting_types","grain_list_recordings","grain_list_teams","grain_list_views","granola_get_note","granola_list_folders","granola_list_notes","greenhouse_get_application","greenhouse_get_candidate","greenhouse_get_job","greenhouse_get_user","greenhouse_list_applications","greenhouse_list_candidates","greenhouse_list_departments","greenhouse_list_job_stages","greenhouse_list_jobs","greenhouse_list_offices","greenhouse_list_users","greptile_index_repo","greptile_query","greptile_search","greptile_status","guardrails_validate","hex_cancel_run","hex_create_collection","hex_create_group","hex_deactivate_user","hex_delete_group","hex_get_collection","hex_get_data_connection","hex_get_group","hex_get_project","hex_get_project_runs","hex_get_queried_tables","hex_get_run_status","hex_list_collections","hex_list_data_connections","hex_list_groups","hex_list_projects","hex_list_users","hex_run_project","hex_update_collection","hex_update_group","hex_update_project","http_request","hubspot_add_list_memberships","hubspot_create_appointment","hubspot_create_association","hubspot_create_company","hubspot_create_contact","hubspot_create_deal","hubspot_create_email","hubspot_create_line_item","hubspot_create_list","hubspot_create_note","hubspot_create_ticket","hubspot_delete_association","hubspot_delete_company","hubspot_delete_contact","hubspot_delete_deal","hubspot_delete_line_item","hubspot_delete_ticket","hubspot_get_appointment","hubspot_get_association_labels","hubspot_get_cart","hubspot_get_company","hubspot_get_contact","hubspot_get_deal","hubspot_get_email","hubspot_get_line_item","hubspot_get_list","hubspot_get_list_memberships","hubspot_get_marketing_event","hubspot_get_note","hubspot_get_properties","hubspot_get_quote","hubspot_get_ticket","hubspot_get_users","hubspot_list_appointments","hubspot_list_associations","hubspot_list_carts","hubspot_list_companies","hubspot_list_contacts","hubspot_list_deals","hubspot_list_emails","hubspot_list_line_items","hubspot_list_lists","hubspot_list_marketing_events","hubspot_list_notes","hubspot_list_owners","hubspot_list_quotes","hubspot_list_tickets","hubspot_remove_list_memberships","hubspot_search_companies","hubspot_search_contacts","hubspot_search_deals","hubspot_search_emails","hubspot_search_line_items","hubspot_search_notes","hubspot_search_quotes","hubspot_search_tickets","hubspot_update_appointment","hubspot_update_company","hubspot_update_contact","hubspot_update_deal","hubspot_update_line_item","hubspot_update_ticket","huggingface_chat","hunter_companies_find","hunter_discover","hunter_domain_search","hunter_email_count","hunter_email_finder","hunter_email_verifier","iam_add_user_to_group","iam_attach_role_policy","iam_attach_user_policy","iam_create_access_key","iam_create_role","iam_create_user","iam_delete_access_key","iam_delete_role","iam_delete_user","iam_detach_role_policy","iam_detach_user_policy","iam_get_role","iam_get_user","iam_list_attached_role_policies","iam_list_attached_user_policies","iam_list_groups","iam_list_policies","iam_list_roles","iam_list_users","iam_remove_user_from_group","iam_simulate_principal_policy","icypeas_find_email","icypeas_verify_email","identity_center_check_assignment_deletion_status","identity_center_check_assignment_status","identity_center_create_account_assignment","identity_center_delete_account_assignment","identity_center_describe_account","identity_center_get_group","identity_center_get_user","identity_center_list_account_assignments","identity_center_list_accounts","identity_center_list_groups","identity_center_list_instances","identity_center_list_permission_sets","image_generate","incidentio_actions_list","incidentio_actions_show","incidentio_custom_fields_create","incidentio_custom_fields_delete","incidentio_custom_fields_list","incidentio_custom_fields_show","incidentio_custom_fields_update","incidentio_escalation_paths_create","incidentio_escalation_paths_delete","incidentio_escalation_paths_list","incidentio_escalation_paths_show","incidentio_escalation_paths_update","incidentio_escalations_create","incidentio_escalations_list","incidentio_escalations_show","incidentio_follow_ups_list","incidentio_follow_ups_show","incidentio_incident_roles_create","incidentio_incident_roles_delete","incidentio_incident_roles_list","incidentio_incident_roles_show","incidentio_incident_roles_update","incidentio_incident_statuses_list","incidentio_incident_timestamps_list","incidentio_incident_timestamps_show","incidentio_incident_types_list","incidentio_incident_updates_list","incidentio_incidents_create","incidentio_incidents_list","incidentio_incidents_show","incidentio_incidents_update","incidentio_schedule_entries_list","incidentio_schedule_overrides_create","incidentio_schedules_create","incidentio_schedules_delete","incidentio_schedules_list","incidentio_schedules_show","incidentio_schedules_update","incidentio_severities_list","incidentio_users_list","incidentio_users_show","incidentio_workflows_create","incidentio_workflows_delete","incidentio_workflows_list","incidentio_workflows_show","incidentio_workflows_update","infisical_create_secret","infisical_delete_secret","infisical_get_secret","infisical_list_secrets","infisical_update_secret","instagram_delete_comment","instagram_download_media","instagram_get_account_insights","instagram_get_container_status","instagram_get_conversation_messages","instagram_get_media","instagram_get_media_insights","instagram_get_message","instagram_get_profile","instagram_get_publishing_limit","instagram_hide_comment","instagram_list_comments","instagram_list_conversations","instagram_list_media","instagram_list_stories","instagram_private_reply","instagram_publish_carousel","instagram_publish_image","instagram_publish_reel","instagram_publish_story","instagram_publish_video","instagram_reply_to_comment","instagram_send_text_message","instagram_set_comments_enabled","instantly_activate_campaign","instantly_create_campaign","instantly_create_lead","instantly_create_lead_list","instantly_delete_campaign","instantly_delete_leads","instantly_get_lead","instantly_list_campaigns","instantly_list_emails","instantly_list_lead_lists","instantly_list_leads","instantly_patch_campaign","instantly_patch_lead","instantly_pause_campaign","instantly_reply_to_email","instantly_update_lead_interest_status","intercom_assign_conversation_v2","intercom_attach_contact_to_company_v2","intercom_close_conversation_v2","intercom_create_company","intercom_create_company_v2","intercom_create_contact","intercom_create_contact_v2","intercom_create_event_v2","intercom_create_message","intercom_create_message_v2","intercom_create_note_v2","intercom_create_tag_v2","intercom_create_ticket","intercom_create_ticket_v2","intercom_delete_contact","intercom_delete_contact_v2","intercom_detach_contact_from_company_v2","intercom_get_company","intercom_get_company_v2","intercom_get_contact","intercom_get_contact_v2","intercom_get_conversation","intercom_get_conversation_v2","intercom_get_ticket","intercom_get_ticket_v2","intercom_list_admins_v2","intercom_list_companies","intercom_list_companies_v2","intercom_list_contacts","intercom_list_contacts_v2","intercom_list_conversations","intercom_list_conversations_v2","intercom_list_tags_v2","intercom_open_conversation_v2","intercom_reply_conversation","intercom_reply_conversation_v2","intercom_search_contacts","intercom_search_contacts_v2","intercom_search_conversations","intercom_search_conversations_v2","intercom_snooze_conversation_v2","intercom_tag_contact_v2","intercom_tag_conversation_v2","intercom_untag_contact_v2","intercom_update_contact","intercom_update_contact_v2","intercom_update_ticket_v2","jina_read_url","jina_search","jira_add_attachment","jira_add_comment","jira_add_watcher","jira_add_worklog","jira_assign_issue","jira_bulk_read","jira_create_issue_link","jira_delete_attachment","jira_delete_comment","jira_delete_issue","jira_delete_issue_link","jira_delete_worklog","jira_get_attachments","jira_get_comments","jira_get_fields","jira_get_project","jira_get_transitions","jira_get_users","jira_get_worklogs","jira_list_issue_types","jira_list_projects","jira_remove_watcher","jira_retrieve","jira_search_issues","jira_search_users","jira_transition_issue","jira_update","jira_update_comment","jira_update_worklog","jira_write","jsm_add_comment","jsm_add_customer","jsm_add_organization","jsm_add_participants","jsm_answer_approval","jsm_attach_form","jsm_copy_forms","jsm_create_object","jsm_create_organization","jsm_create_request","jsm_delete_form","jsm_delete_object","jsm_externalise_form","jsm_get_approvals","jsm_get_comments","jsm_get_customers","jsm_get_form","jsm_get_form_answers","jsm_get_form_structure","jsm_get_form_templates","jsm_get_issue_forms","jsm_get_object","jsm_get_object_schema","jsm_get_object_type_attributes","jsm_get_organizations","jsm_get_participants","jsm_get_queues","jsm_get_request","jsm_get_request_type_fields","jsm_get_request_types","jsm_get_requests","jsm_get_service_desks","jsm_get_sla","jsm_get_transitions","jsm_internalise_form","jsm_list_object_schemas","jsm_list_object_types","jsm_reopen_form","jsm_save_form_answers","jsm_search_objects_aql","jsm_submit_form","jsm_transition_request","jsm_update_object","jupyter_copy_content","jupyter_create_file","jupyter_create_session","jupyter_delete_content","jupyter_delete_session","jupyter_get_content","jupyter_interrupt_kernel","jupyter_list_contents","jupyter_list_kernels","jupyter_list_kernelspecs","jupyter_list_sessions","jupyter_rename_content","jupyter_restart_kernel","jupyter_start_kernel","jupyter_stop_kernel","jupyter_upload_file","kalshi_amend_order","kalshi_amend_order_v2","kalshi_cancel_order","kalshi_cancel_order_v2","kalshi_create_order","kalshi_create_order_v2","kalshi_get_balance","kalshi_get_balance_v2","kalshi_get_candlesticks","kalshi_get_candlesticks_v2","kalshi_get_event","kalshi_get_event_candlesticks","kalshi_get_event_candlesticks_v2","kalshi_get_event_v2","kalshi_get_events","kalshi_get_events_v2","kalshi_get_exchange_announcements","kalshi_get_exchange_announcements_v2","kalshi_get_exchange_schedule","kalshi_get_exchange_schedule_v2","kalshi_get_exchange_status","kalshi_get_exchange_status_v2","kalshi_get_fills","kalshi_get_fills_v2","kalshi_get_market","kalshi_get_market_v2","kalshi_get_markets","kalshi_get_markets_v2","kalshi_get_order","kalshi_get_order_v2","kalshi_get_orderbook","kalshi_get_orderbook_v2","kalshi_get_orders","kalshi_get_orders_v2","kalshi_get_positions","kalshi_get_positions_v2","kalshi_get_series_by_ticker","kalshi_get_series_by_ticker_v2","kalshi_get_series_list","kalshi_get_series_list_v2","kalshi_get_settlements","kalshi_get_settlements_v2","kalshi_get_trades","kalshi_get_trades_v2","ketch_get_consent","ketch_get_subscriptions","ketch_invoke_right","ketch_set_consent","ketch_set_subscriptions","knowledge_create_document","knowledge_delete_chunk","knowledge_delete_document","knowledge_get_connector","knowledge_get_document","knowledge_list_chunks","knowledge_list_connectors","knowledge_list_documents","knowledge_list_tags","knowledge_search","knowledge_trigger_sync","knowledge_update_chunk","knowledge_upload_chunk","knowledge_upsert_document","langsmith_create_feedback","langsmith_create_run","langsmith_create_runs_batch","langsmith_get_run","langsmith_update_run","latex_compile","latex_get_package","latex_list_fonts","latex_search_packages","launchdarkly_create_flag","launchdarkly_delete_flag","launchdarkly_get_audit_log","launchdarkly_get_flag","launchdarkly_get_flag_status","launchdarkly_list_environments","launchdarkly_list_flags","launchdarkly_list_members","launchdarkly_list_projects","launchdarkly_list_segments","launchdarkly_toggle_flag","launchdarkly_update_flag","leadmagic_company_search","leadmagic_email_to_profile","leadmagic_find_email","leadmagic_find_mobile","leadmagic_get_credits","leadmagic_profile_search","leadmagic_profile_to_email","leadmagic_role_finder","leadmagic_validate_email","lemlist_get_activities","lemlist_get_lead","lemlist_send_email","linear_add_label_to_issue","linear_add_label_to_project","linear_archive_issue","linear_archive_label","linear_archive_project","linear_create_attachment","linear_create_comment","linear_create_customer","linear_create_customer_request","linear_create_customer_status","linear_create_customer_tier","linear_create_cycle","linear_create_favorite","linear_create_issue","linear_create_issue_relation","linear_create_label","linear_create_project","linear_create_project_label","linear_create_project_milestone","linear_create_project_status","linear_create_project_update","linear_create_workflow_state","linear_delete_attachment","linear_delete_comment","linear_delete_customer","linear_delete_customer_status","linear_delete_customer_tier","linear_delete_issue","linear_delete_issue_relation","linear_delete_project","linear_delete_project_label","linear_delete_project_milestone","linear_delete_project_status","linear_get_active_cycle","linear_get_customer","linear_get_cycle","linear_get_issue","linear_get_project","linear_get_viewer","linear_list_attachments","linear_list_comments","linear_list_customer_requests","linear_list_customer_statuses","linear_list_customer_tiers","linear_list_customers","linear_list_cycles","linear_list_favorites","linear_list_issue_relations","linear_list_labels","linear_list_notifications","linear_list_project_labels","linear_list_project_milestones","linear_list_project_statuses","linear_list_project_updates","linear_list_projects","linear_list_teams","linear_list_users","linear_list_workflow_states","linear_merge_customers","linear_read_issues","linear_remove_label_from_issue","linear_remove_label_from_project","linear_search_issues","linear_unarchive_issue","linear_update_attachment","linear_update_comment","linear_update_customer","linear_update_customer_request","linear_update_customer_status","linear_update_customer_tier","linear_update_issue","linear_update_label","linear_update_notification","linear_update_project","linear_update_project_label","linear_update_project_milestone","linear_update_project_status","linear_update_workflow_state","linkedin_get_profile","linkedin_share_post","linkup_search","linq_add_participant","linq_check_imessage","linq_check_rcs","linq_create_attachment","linq_create_chat","linq_create_contact_card","linq_create_webhook_subscription","linq_delete_attachment","linq_delete_message","linq_delete_webhook_subscription","linq_edit_message","linq_get_attachment","linq_get_chat","linq_get_contact_card","linq_get_message","linq_get_webhook_subscription","linq_leave_chat","linq_list_chats","linq_list_messages","linq_list_phone_numbers","linq_list_thread","linq_list_webhook_events","linq_list_webhook_subscriptions","linq_mark_chat_read","linq_react_to_message","linq_remove_participant","linq_send_message","linq_send_voice_memo","linq_share_contact_card","linq_start_typing","linq_stop_typing","linq_update_chat","linq_update_contact_card","linq_update_webhook_subscription","llm_chat","logfire_get_token_info","logfire_get_trace","logfire_query","logfire_search_records","logs_get","logs_get_execution","logs_get_run_details","logs_query","logs_query_runs","loops_check_contact_suppression","loops_create_contact","loops_create_contact_property","loops_delete_contact","loops_find_contact","loops_get_transactional_email","loops_list_contact_properties","loops_list_mailing_lists","loops_list_transactional_emails","loops_remove_contact_suppression","loops_send_event","loops_send_transactional_email","loops_update_contact","luma_add_guests","luma_cancel_event","luma_create_event","luma_get_event","luma_get_guest","luma_get_guests","luma_list_events","luma_lookup_event","luma_send_invites","luma_update_event","luma_update_guest_status","mailchimp_add_member","mailchimp_add_member_tags","mailchimp_add_or_update_member","mailchimp_add_segment_member","mailchimp_add_subscriber_to_automation","mailchimp_archive_member","mailchimp_create_audience","mailchimp_create_batch_operation","mailchimp_create_campaign","mailchimp_create_interest","mailchimp_create_interest_category","mailchimp_create_landing_page","mailchimp_create_merge_field","mailchimp_create_segment","mailchimp_create_template","mailchimp_delete_audience","mailchimp_delete_batch_operation","mailchimp_delete_campaign","mailchimp_delete_interest","mailchimp_delete_interest_category","mailchimp_delete_landing_page","mailchimp_delete_member","mailchimp_delete_merge_field","mailchimp_delete_segment","mailchimp_delete_template","mailchimp_get_audience","mailchimp_get_audiences","mailchimp_get_automation","mailchimp_get_automations","mailchimp_get_batch_operation","mailchimp_get_batch_operations","mailchimp_get_campaign","mailchimp_get_campaign_content","mailchimp_get_campaign_report","mailchimp_get_campaign_reports","mailchimp_get_campaigns","mailchimp_get_interest","mailchimp_get_interest_categories","mailchimp_get_interest_category","mailchimp_get_interests","mailchimp_get_landing_page","mailchimp_get_landing_pages","mailchimp_get_member","mailchimp_get_member_tags","mailchimp_get_members","mailchimp_get_merge_field","mailchimp_get_merge_fields","mailchimp_get_segment","mailchimp_get_segment_members","mailchimp_get_segments","mailchimp_get_template","mailchimp_get_templates","mailchimp_pause_automation","mailchimp_publish_landing_page","mailchimp_remove_member_tags","mailchimp_remove_segment_member","mailchimp_replicate_campaign","mailchimp_schedule_campaign","mailchimp_send_campaign","mailchimp_set_campaign_content","mailchimp_start_automation","mailchimp_unarchive_member","mailchimp_unpublish_landing_page","mailchimp_unschedule_campaign","mailchimp_update_audience","mailchimp_update_campaign","mailchimp_update_interest","mailchimp_update_interest_category","mailchimp_update_landing_page","mailchimp_update_member","mailchimp_update_merge_field","mailchimp_update_segment","mailchimp_update_template","mailgun_add_list_member","mailgun_create_mailing_list","mailgun_get_domain","mailgun_get_mailing_list","mailgun_get_message","mailgun_list_domains","mailgun_list_messages","mailgun_send_message","managed_agent_archive_session","managed_agent_create_session","managed_agent_delete_session","managed_agent_get_session","managed_agent_interrupt_session","managed_agent_list_events","managed_agent_respond_custom_tool","managed_agent_respond_tool_confirmation","managed_agent_run_session","managed_agent_send_message","managed_agent_update_session","mem0_add_memories","mem0_get_memories","mem0_search_memories","memory_add","memory_delete","memory_get","memory_get_all","microsoft_ad_add_group_member","microsoft_ad_create_group","microsoft_ad_create_user","microsoft_ad_delete_group","microsoft_ad_delete_user","microsoft_ad_get_group","microsoft_ad_get_user","microsoft_ad_list_group_members","microsoft_ad_list_groups","microsoft_ad_list_users","microsoft_ad_remove_group_member","microsoft_ad_update_group","microsoft_ad_update_user","microsoft_dataverse_associate","microsoft_dataverse_create_multiple","microsoft_dataverse_create_record","microsoft_dataverse_delete_record","microsoft_dataverse_disassociate","microsoft_dataverse_download_file","microsoft_dataverse_execute_action","microsoft_dataverse_execute_function","microsoft_dataverse_fetchxml_query","microsoft_dataverse_get_entity_metadata","microsoft_dataverse_get_record","microsoft_dataverse_list_records","microsoft_dataverse_search","microsoft_dataverse_update_multiple","microsoft_dataverse_update_record","microsoft_dataverse_upload_file","microsoft_dataverse_upsert_record","microsoft_dataverse_whoami","microsoft_excel_clear_range","microsoft_excel_create_table","microsoft_excel_delete_worksheet","microsoft_excel_format_range","microsoft_excel_read","microsoft_excel_read_v2","microsoft_excel_sort_range","microsoft_excel_table_add","microsoft_excel_worksheet_add","microsoft_excel_write","microsoft_excel_write_v2","microsoft_planner_create_bucket","microsoft_planner_create_plan","microsoft_planner_create_task","microsoft_planner_delete_bucket","microsoft_planner_delete_plan","microsoft_planner_delete_task","microsoft_planner_get_plan_details","microsoft_planner_get_task_details","microsoft_planner_list_buckets","microsoft_planner_list_plans","microsoft_planner_read_bucket","microsoft_planner_read_plan","microsoft_planner_read_task","microsoft_planner_update_bucket","microsoft_planner_update_plan","microsoft_planner_update_plan_details","microsoft_planner_update_task","microsoft_planner_update_task_details","microsoft_teams_delete_channel_message","microsoft_teams_delete_chat_message","microsoft_teams_get_message","microsoft_teams_list_channel_members","microsoft_teams_list_channels","microsoft_teams_list_chat_members","microsoft_teams_list_chats","microsoft_teams_list_team_members","microsoft_teams_list_teams","microsoft_teams_read_channel","microsoft_teams_read_chat","microsoft_teams_reply_to_message","microsoft_teams_set_reaction","microsoft_teams_unset_reaction","microsoft_teams_update_channel_message","microsoft_teams_update_chat_message","microsoft_teams_write_channel","microsoft_teams_write_chat","millionverifier_get_credits","millionverifier_verify_email","mistral_parser","mistral_parser_v2","mistral_parser_v3","monday_archive_item","monday_change_column_value","monday_create_board","monday_create_column","monday_create_group","monday_create_item","monday_create_subitem","monday_create_update","monday_delete_item","monday_duplicate_item","monday_get_board","monday_get_groups","monday_get_item","monday_get_items","monday_list_boards","monday_move_item_to_group","monday_search_items","monday_update_item","mongodb_delete","mongodb_execute","mongodb_insert","mongodb_introspect","mongodb_query","mongodb_update","mysql_delete","mysql_execute","mysql_insert","mysql_introspect","mysql_query","mysql_update","neo4j_create","neo4j_delete","neo4j_execute","neo4j_introspect","neo4j_merge","neo4j_query","neo4j_update","neverbounce_get_credits","neverbounce_verify_email","new_relic_create_deployment_event","new_relic_get_entity","new_relic_nrql_query","new_relic_search_entities","notion_add_database_row","notion_add_database_row_v2","notion_append_blocks","notion_append_blocks_v2","notion_create_comment","notion_create_comment_v2","notion_create_database","notion_create_database_v2","notion_create_page","notion_create_page_v2","notion_delete_block","notion_delete_block_v2","notion_list_comments","notion_list_comments_v2","notion_list_users","notion_list_users_v2","notion_query_database","notion_query_database_v2","notion_read","notion_read_database","notion_read_database_v2","notion_read_v2","notion_retrieve_block","notion_retrieve_block_children","notion_retrieve_block_children_v2","notion_retrieve_block_v2","notion_retrieve_user","notion_retrieve_user_v2","notion_search","notion_search_v2","notion_update_block","notion_update_block_v2","notion_update_page","notion_update_page_v2","notion_write","notion_write_v2","obsidian_append_active","obsidian_append_note","obsidian_append_periodic_note","obsidian_create_note","obsidian_delete_note","obsidian_execute_command","obsidian_get_active","obsidian_get_note","obsidian_get_periodic_note","obsidian_list_commands","obsidian_list_files","obsidian_open_file","obsidian_patch_active","obsidian_patch_note","obsidian_search","okta_activate_user","okta_add_user_to_group","okta_create_group","okta_create_user","okta_deactivate_user","okta_delete_group","okta_delete_user","okta_get_group","okta_get_user","okta_list_group_members","okta_list_groups","okta_list_users","okta_remove_user_from_group","okta_reset_password","okta_suspend_user","okta_unsuspend_user","okta_update_group","okta_update_user","onedrive_copy","onedrive_create_folder","onedrive_create_share_link","onedrive_delete","onedrive_download","onedrive_get_drive_info","onedrive_get_item","onedrive_list","onedrive_move","onedrive_search","onedrive_upload","onepassword_create_item","onepassword_delete_item","onepassword_get_item","onepassword_get_item_file","onepassword_get_vault","onepassword_list_items","onepassword_list_vaults","onepassword_replace_item","onepassword_resolve_secret","onepassword_update_item","openai_embeddings","openai_image","outlook_calendar_create_event","outlook_calendar_delete_event","outlook_calendar_get_event","outlook_calendar_list_events","outlook_calendar_respond","outlook_calendar_update_event","outlook_copy","outlook_create_folder","outlook_delete","outlook_draft","outlook_forward","outlook_get_attachment","outlook_list_attachments","outlook_list_folders","outlook_mark_read","outlook_mark_unread","outlook_move","outlook_read","outlook_reply","outlook_reply_all","outlook_search","outlook_send","outlook_update_message","pagerduty_add_note","pagerduty_create_incident","pagerduty_get_incident","pagerduty_get_service","pagerduty_list_escalation_policies","pagerduty_list_incident_alerts","pagerduty_list_incidents","pagerduty_list_oncalls","pagerduty_list_schedules","pagerduty_list_services","pagerduty_list_users","pagerduty_merge_incidents","pagerduty_send_event","pagerduty_snooze_incident","pagerduty_update_incident","parallel_deep_research","parallel_extract","parallel_search","pdl_autocomplete","pdl_bulk_company_enrich","pdl_bulk_person_enrich","pdl_clean_company","pdl_clean_location","pdl_clean_school","pdl_company_enrich","pdl_company_search","pdl_person_enrich","pdl_person_identify","pdl_person_search","perplexity_chat","perplexity_search","persona_approve_inquiry","persona_create_account","persona_create_inquiry","persona_create_report","persona_decline_inquiry","persona_expire_inquiry","persona_generate_inquiry_link","persona_get_account","persona_get_case","persona_get_document","persona_get_inquiry","persona_get_report","persona_get_verification","persona_import_accounts","persona_list_accounts","persona_list_cases","persona_list_inquiries","persona_list_inquiry_templates","persona_list_reports","persona_mark_inquiry_for_review","persona_print_inquiry_pdf","persona_redact_account","persona_redact_inquiry","persona_resume_inquiry","persona_update_account","persona_update_inquiry","pinecone_delete_vectors","pinecone_describe_index","pinecone_describe_index_stats","pinecone_fetch","pinecone_generate_embeddings","pinecone_list_indexes","pinecone_list_vector_ids","pinecone_search_text","pinecone_search_vector","pinecone_update_vector","pinecone_upsert_text","pipedrive_create_activity","pipedrive_create_deal","pipedrive_create_lead","pipedrive_create_project","pipedrive_delete_lead","pipedrive_get_activities","pipedrive_get_all_deals","pipedrive_get_deal","pipedrive_get_files","pipedrive_get_leads","pipedrive_get_mail_messages","pipedrive_get_mail_thread","pipedrive_get_pipeline_deals","pipedrive_get_pipelines","pipedrive_get_projects","pipedrive_update_activity","pipedrive_update_deal","pipedrive_update_lead","polymarket_get_activity","polymarket_get_event","polymarket_get_events","polymarket_get_holders","polymarket_get_last_trade_price","polymarket_get_leaderboard","polymarket_get_market","polymarket_get_markets","polymarket_get_midpoint","polymarket_get_orderbook","polymarket_get_positions","polymarket_get_price","polymarket_get_price_history","polymarket_get_series","polymarket_get_series_by_id","polymarket_get_spread","polymarket_get_tags","polymarket_get_tick_size","polymarket_get_trades","polymarket_search","postgresql_delete","postgresql_execute","postgresql_insert","postgresql_introspect","postgresql_query","postgresql_update","posthog_batch_events","posthog_capture_event","posthog_create_annotation","posthog_create_cohort","posthog_create_dashboard","posthog_create_experiment","posthog_create_feature_flag","posthog_create_insight","posthog_create_survey","posthog_delete_feature_flag","posthog_delete_person","posthog_delete_survey","posthog_evaluate_flags","posthog_get_cohort","posthog_get_dashboard","posthog_get_event_definition","posthog_get_experiment","posthog_get_feature_flag","posthog_get_insight","posthog_get_organization","posthog_get_person","posthog_get_project","posthog_get_property_definition","posthog_get_session_recording","posthog_get_survey","posthog_list_actions","posthog_list_annotations","posthog_list_cohorts","posthog_list_dashboards","posthog_list_event_definitions","posthog_list_experiments","posthog_list_feature_flags","posthog_list_insights","posthog_list_organizations","posthog_list_persons","posthog_list_projects","posthog_list_property_definitions","posthog_list_recording_playlists","posthog_list_session_recordings","posthog_list_surveys","posthog_query","posthog_update_cohort","posthog_update_event_definition","posthog_update_experiment","posthog_update_feature_flag","posthog_update_insight","posthog_update_property_definition","posthog_update_survey","profound_bot_logs","profound_bots_report","profound_category_assets","profound_category_personas","profound_category_prompts","profound_category_tags","profound_category_topics","profound_citation_prompts","profound_citations_report","profound_list_assets","profound_list_categories","profound_list_domains","profound_list_models","profound_list_optimizations","profound_list_personas","profound_list_regions","profound_optimization_analysis","profound_prompt_answers","profound_prompt_volume","profound_query_fanouts","profound_raw_logs","profound_referrals_report","profound_sentiment_report","profound_visibility_report","prospeo_account_information","prospeo_bulk_enrich_company","prospeo_bulk_enrich_person","prospeo_enrich_company","prospeo_enrich_person","prospeo_search_company","prospeo_search_person","prospeo_search_suggestions","pulse_parser","pulse_parser_v2","qdrant_fetch_points","qdrant_search_vector","qdrant_upsert_points","quartr_get_audio","quartr_get_company","quartr_get_event","quartr_get_event_summary","quartr_get_report","quartr_get_slide_deck","quartr_get_transcript","quartr_list_audio","quartr_list_companies","quartr_list_document_types","quartr_list_documents","quartr_list_event_types","quartr_list_events","quartr_list_live_events","quartr_list_reports","quartr_list_slide_decks","quartr_list_transcripts","quickbooks_get_company_info","quickbooks_list_bills","quickbooks_list_purchase_orders","quickbooks_list_vendors","quiver_image_to_svg","quiver_list_models","quiver_text_to_svg","railway_create_environment","railway_create_project","railway_create_service","railway_delete_environment","railway_delete_project","railway_delete_service","railway_delete_variable","railway_deploy_service","railway_get_deployment","railway_get_deployment_logs","railway_get_project","railway_list_deployments","railway_list_project_members","railway_list_projects","railway_list_variables","railway_restart_deployment","railway_rollback_deployment","railway_transfer_project","railway_update_project","railway_upsert_variable","rb2b_credit_check","rb2b_email_to_activity","rb2b_hem_to_best_linkedin","rb2b_hem_to_business_profile","rb2b_hem_to_linkedin","rb2b_hem_to_maid","rb2b_ip_to_company","rb2b_ip_to_hem","rb2b_ip_to_maid","rb2b_linkedin_slug_search","rb2b_linkedin_to_best_personal_email","rb2b_linkedin_to_business_profile","rb2b_linkedin_to_hashed_emails","rb2b_linkedin_to_mobile_phone","rb2b_linkedin_to_personal_email","rds_delete","rds_execute","rds_insert","rds_introspect","rds_query","rds_update","reddit_delete","reddit_edit","reddit_get_comments","reddit_get_controversial","reddit_get_info","reddit_get_me","reddit_get_messages","reddit_get_posts","reddit_get_saved","reddit_get_subreddit_info","reddit_get_subreddit_rules","reddit_get_user","reddit_get_user_comments","reddit_get_user_posts","reddit_hide","reddit_hot_posts","reddit_list_my_subreddits","reddit_lock","reddit_mark_all_read","reddit_mark_read","reddit_marknsfw","reddit_mod_approve","reddit_mod_distinguish","reddit_mod_remove","reddit_mod_sticky","reddit_reply","reddit_report","reddit_save","reddit_search","reddit_search_subreddits","reddit_send_message","reddit_submit_post","reddit_subscribe","reddit_unhide","reddit_unlock","reddit_unmarknsfw","reddit_unsave","reddit_vote","redis_command","redis_delete","redis_exists","redis_expire","redis_get","redis_hdel","redis_hget","redis_hgetall","redis_hset","redis_incr","redis_incrby","redis_keys","redis_llen","redis_lpop","redis_lpush","redis_lrange","redis_persist","redis_rpop","redis_rpush","redis_set","redis_setnx","redis_ttl","reducto_parser","reducto_parser_v2","resend_cancel_email","resend_create_audience","resend_create_broadcast","resend_create_contact","resend_delete_audience","resend_delete_contact","resend_get_audience","resend_get_broadcast","resend_get_contact","resend_get_email","resend_list_audiences","resend_list_contacts","resend_list_domains","resend_send","resend_send_broadcast","resend_update_contact","revenuecat_create_purchase","revenuecat_defer_google_subscription","revenuecat_delete_customer","revenuecat_get_customer","revenuecat_grant_entitlement","revenuecat_list_offerings","revenuecat_refund_google_subscription","revenuecat_revoke_entitlement","revenuecat_revoke_google_subscription","revenuecat_update_subscriber_attributes","rippling_bulk_create_custom_object_records","rippling_bulk_delete_custom_object_records","rippling_bulk_update_custom_object_records","rippling_create_business_partner","rippling_create_business_partner_group","rippling_create_custom_app","rippling_create_custom_object","rippling_create_custom_object_field","rippling_create_custom_object_record","rippling_create_custom_page","rippling_create_custom_setting","rippling_create_department","rippling_create_draft_hires","rippling_create_object_category","rippling_create_title","rippling_create_work_location","rippling_delete_business_partner","rippling_delete_business_partner_group","rippling_delete_custom_app","rippling_delete_custom_object","rippling_delete_custom_object_field","rippling_delete_custom_object_record","rippling_delete_custom_page","rippling_delete_custom_setting","rippling_delete_object_category","rippling_delete_title","rippling_delete_work_location","rippling_get_business_partner","rippling_get_business_partner_group","rippling_get_current_user","rippling_get_custom_app","rippling_get_custom_object","rippling_get_custom_object_field","rippling_get_custom_object_record","rippling_get_custom_object_record_by_external_id","rippling_get_custom_page","rippling_get_custom_setting","rippling_get_department","rippling_get_employment_type","rippling_get_job_function","rippling_get_object_category","rippling_get_report_run","rippling_get_supergroup","rippling_get_team","rippling_get_title","rippling_get_user","rippling_get_work_location","rippling_get_worker","rippling_list_business_partner_groups","rippling_list_business_partners","rippling_list_companies","rippling_list_custom_apps","rippling_list_custom_fields","rippling_list_custom_object_fields","rippling_list_custom_object_records","rippling_list_custom_objects","rippling_list_custom_pages","rippling_list_custom_settings","rippling_list_departments","rippling_list_employment_types","rippling_list_entitlements","rippling_list_job_functions","rippling_list_object_categories","rippling_list_supergroup_exclusion_members","rippling_list_supergroup_inclusion_members","rippling_list_supergroup_members","rippling_list_supergroups","rippling_list_teams","rippling_list_titles","rippling_list_users","rippling_list_work_locations","rippling_list_workers","rippling_query_custom_object_records","rippling_trigger_report_run","rippling_update_custom_app","rippling_update_custom_object","rippling_update_custom_object_field","rippling_update_custom_object_record","rippling_update_custom_page","rippling_update_custom_setting","rippling_update_department","rippling_update_object_category","rippling_update_supergroup_exclusion_members","rippling_update_supergroup_inclusion_members","rippling_update_title","rippling_update_work_location","rocketlane_add_field_option","rocketlane_add_project_members","rocketlane_add_task_assignees","rocketlane_add_task_dependencies","rocketlane_add_task_followers","rocketlane_archive_project","rocketlane_assign_placeholders","rocketlane_create_field","rocketlane_create_phase","rocketlane_create_project","rocketlane_create_space","rocketlane_create_space_document","rocketlane_create_task","rocketlane_create_time_entry","rocketlane_create_time_off","rocketlane_delete_field","rocketlane_delete_phase","rocketlane_delete_project","rocketlane_delete_space","rocketlane_delete_space_document","rocketlane_delete_task","rocketlane_delete_time_entry","rocketlane_delete_time_off","rocketlane_get_field","rocketlane_get_invoice","rocketlane_get_invoice_line_items","rocketlane_get_invoice_payments","rocketlane_get_phase","rocketlane_get_project","rocketlane_get_space","rocketlane_get_space_document","rocketlane_get_task","rocketlane_get_time_entry","rocketlane_get_time_off","rocketlane_get_user","rocketlane_import_template","rocketlane_list_fields","rocketlane_list_invoices","rocketlane_list_phases","rocketlane_list_placeholders","rocketlane_list_projects","rocketlane_list_resource_allocations","rocketlane_list_space_documents","rocketlane_list_spaces","rocketlane_list_tasks","rocketlane_list_time_entries","rocketlane_list_time_entry_categories","rocketlane_list_time_offs","rocketlane_list_users","rocketlane_move_task_to_phase","rocketlane_remove_project_members","rocketlane_remove_task_assignees","rocketlane_remove_task_dependencies","rocketlane_remove_task_followers","rocketlane_search_time_entries","rocketlane_unassign_placeholders","rocketlane_update_field","rocketlane_update_field_option","rocketlane_update_phase","rocketlane_update_project","rocketlane_update_space","rocketlane_update_space_document","rocketlane_update_task","rocketlane_update_time_entry","rootly_acknowledge_alert","rootly_add_incident_event","rootly_add_subscribers","rootly_assign_incident_role","rootly_create_action_item","rootly_create_alert","rootly_create_incident","rootly_create_status_page_event","rootly_delete_action_item","rootly_delete_incident","rootly_escalate_alert","rootly_get_alert","rootly_get_incident","rootly_list_action_items","rootly_list_alerts","rootly_list_causes","rootly_list_environments","rootly_list_escalation_policies","rootly_list_functionalities","rootly_list_incident_events","rootly_list_incident_roles","rootly_list_incident_types","rootly_list_incidents","rootly_list_on_calls","rootly_list_playbooks","rootly_list_retrospectives","rootly_list_schedules","rootly_list_services","rootly_list_severities","rootly_list_teams","rootly_list_users","rootly_mitigate_incident","rootly_remove_subscribers","rootly_resolve_alert","rootly_resolve_incident","rootly_run_workflow","rootly_snooze_alert","rootly_unassign_incident_role","rootly_update_action_item","rootly_update_alert","rootly_update_incident","s3_copy_object","s3_create_bucket","s3_delete_bucket","s3_delete_object","s3_delete_objects","s3_get_object","s3_head_object","s3_list_buckets","s3_list_objects","s3_presigned_url","s3_put_object","salesforce_create_account","salesforce_create_case","salesforce_create_contact","salesforce_create_custom_field","salesforce_create_custom_object","salesforce_create_lead","salesforce_create_opportunity","salesforce_create_task","salesforce_delete_account","salesforce_delete_case","salesforce_delete_contact","salesforce_delete_custom_field","salesforce_delete_lead","salesforce_delete_opportunity","salesforce_delete_task","salesforce_describe_object","salesforce_get_accounts","salesforce_get_cases","salesforce_get_contacts","salesforce_get_dashboard","salesforce_get_leads","salesforce_get_opportunities","salesforce_get_report","salesforce_get_tasks","salesforce_list_dashboards","salesforce_list_objects","salesforce_list_report_types","salesforce_list_reports","salesforce_query","salesforce_query_more","salesforce_refresh_dashboard","salesforce_run_report","salesforce_tooling_query","salesforce_update_account","salesforce_update_case","salesforce_update_contact","salesforce_update_custom_field","salesforce_update_lead","salesforce_update_opportunity","salesforce_update_task","sap_concur_approve_expense_report","sap_concur_associate_attendees","sap_concur_create_cash_advance","sap_concur_create_expected_expense","sap_concur_create_expense_report","sap_concur_create_list_item","sap_concur_create_purchase_request","sap_concur_create_quick_expense","sap_concur_create_quick_expense_with_image","sap_concur_create_report_comment","sap_concur_create_travel_request","sap_concur_create_user","sap_concur_delete_expected_expense","sap_concur_delete_expense","sap_concur_delete_expense_report","sap_concur_delete_list_item","sap_concur_delete_travel_request","sap_concur_delete_user","sap_concur_get_allocation","sap_concur_get_budget","sap_concur_get_cash_advance","sap_concur_get_expected_expense","sap_concur_get_expense","sap_concur_get_expense_report","sap_concur_get_itemizations","sap_concur_get_itinerary","sap_concur_get_list","sap_concur_get_list_item","sap_concur_get_purchase_request","sap_concur_get_receipt","sap_concur_get_receipt_status","sap_concur_get_request_cash_advance","sap_concur_get_travel_profile","sap_concur_get_travel_request","sap_concur_get_user","sap_concur_issue_cash_advance","sap_concur_list_allocations","sap_concur_list_attendee_associations","sap_concur_list_budget_categories","sap_concur_list_budgets","sap_concur_list_exceptions","sap_concur_list_expected_expenses","sap_concur_list_expense_reports","sap_concur_list_expenses","sap_concur_list_itineraries","sap_concur_list_list_items","sap_concur_list_lists","sap_concur_list_receipts","sap_concur_list_report_comments","sap_concur_list_reports_to_approve","sap_concur_list_travel_profiles_summary","sap_concur_list_travel_request_comments","sap_concur_list_travel_requests","sap_concur_list_users","sap_concur_move_travel_request","sap_concur_recall_expense_report","sap_concur_remove_all_attendees","sap_concur_search_locations","sap_concur_search_users","sap_concur_send_back_expense_report","sap_concur_submit_expense_report","sap_concur_update_allocation","sap_concur_update_expected_expense","sap_concur_update_expense","sap_concur_update_expense_report","sap_concur_update_list_item","sap_concur_update_travel_request","sap_concur_update_user","sap_concur_upload_exchange_rates","sap_concur_upload_receipt_image","sap_s4hana_create_business_partner","sap_s4hana_create_purchase_order","sap_s4hana_create_purchase_requisition","sap_s4hana_create_sales_order","sap_s4hana_delete_sales_order","sap_s4hana_get_billing_document","sap_s4hana_get_business_partner","sap_s4hana_get_customer","sap_s4hana_get_inbound_delivery","sap_s4hana_get_material_document","sap_s4hana_get_outbound_delivery","sap_s4hana_get_product","sap_s4hana_get_purchase_order","sap_s4hana_get_purchase_requisition","sap_s4hana_get_sales_order","sap_s4hana_get_supplier","sap_s4hana_get_supplier_invoice","sap_s4hana_list_billing_documents","sap_s4hana_list_business_partners","sap_s4hana_list_customers","sap_s4hana_list_inbound_deliveries","sap_s4hana_list_material_documents","sap_s4hana_list_material_stock","sap_s4hana_list_outbound_deliveries","sap_s4hana_list_products","sap_s4hana_list_purchase_orders","sap_s4hana_list_purchase_requisitions","sap_s4hana_list_sales_orders","sap_s4hana_list_supplier_invoices","sap_s4hana_list_suppliers","sap_s4hana_odata_query","sap_s4hana_update_business_partner","sap_s4hana_update_customer","sap_s4hana_update_product","sap_s4hana_update_purchase_order","sap_s4hana_update_purchase_requisition","sap_s4hana_update_sales_order","sap_s4hana_update_supplier","search_tool","secrets_manager_create_secret","secrets_manager_delete_secret","secrets_manager_describe_secret","secrets_manager_get_secret","secrets_manager_list_secrets","secrets_manager_restore_secret","secrets_manager_rotate_secret","secrets_manager_tag_resource","secrets_manager_untag_resource","secrets_manager_update_secret","sendblue_evaluate_service","sendblue_get_message","sendblue_send_group_message","sendblue_send_message","sendblue_send_typing_indicator","sendgrid_add_contact","sendgrid_add_contacts_to_list","sendgrid_create_list","sendgrid_create_template","sendgrid_create_template_version","sendgrid_delete_contacts","sendgrid_delete_list","sendgrid_delete_template","sendgrid_get_contact","sendgrid_get_list","sendgrid_get_template","sendgrid_list_all_lists","sendgrid_list_templates","sendgrid_remove_contacts_from_list","sendgrid_search_contacts","sendgrid_send_mail","sentry_events_get","sentry_events_list","sentry_issues_get","sentry_issues_list","sentry_issues_update","sentry_projects_create","sentry_projects_get","sentry_projects_list","sentry_projects_update","sentry_releases_create","sentry_releases_deploy","sentry_releases_list","sentry_teams_list","serper_search","servicenow_aggregate","servicenow_create_record","servicenow_delete_record","servicenow_download_attachment","servicenow_list_attachments","servicenow_read_record","servicenow_update_record","servicenow_upload_attachment","ses_create_configuration_set","ses_create_email_identity","ses_create_template","ses_delete_email_identity","ses_delete_suppressed_destination","ses_delete_template","ses_get_account","ses_get_email_identity","ses_get_suppressed_destination","ses_get_template","ses_list_identities","ses_list_suppressed_destinations","ses_list_templates","ses_put_suppressed_destination","ses_send_bulk_email","ses_send_custom_verification_email","ses_send_email","ses_send_templated_email","ses_update_template","sftp_delete","sftp_download","sftp_list","sftp_mkdir","sftp_upload","sharepoint_add_list_items","sharepoint_create_list","sharepoint_create_page","sharepoint_delete_file","sharepoint_delete_list_item","sharepoint_delete_page","sharepoint_download_file","sharepoint_get_drive_item","sharepoint_get_list","sharepoint_get_list_item","sharepoint_list_sites","sharepoint_publish_page","sharepoint_read_page","sharepoint_update_list","sharepoint_update_page","sharepoint_upload_file","shopify_adjust_inventory","shopify_cancel_order","shopify_create_customer","shopify_create_fulfillment","shopify_create_product","shopify_delete_customer","shopify_delete_product","shopify_get_collection","shopify_get_customer","shopify_get_inventory_level","shopify_get_order","shopify_get_product","shopify_list_collections","shopify_list_customers","shopify_list_inventory_items","shopify_list_locations","shopify_list_orders","shopify_list_products","shopify_update_customer","shopify_update_order","shopify_update_product","similarweb_bounce_rate","similarweb_page_views","similarweb_pages_per_visit","similarweb_traffic_visits","similarweb_visit_duration","similarweb_website_overview","sixtyfour_enrich_company","sixtyfour_enrich_lead","sixtyfour_find_email","sixtyfour_find_phone","slack_add_reaction","slack_archive_conversation","slack_canvas","slack_create_channel_canvas","slack_create_conversation","slack_delete_canvas","slack_delete_message","slack_delete_scheduled_message","slack_download","slack_edit_canvas","slack_ephemeral_message","slack_get_canvas","slack_get_channel_history","slack_get_channel_info","slack_get_message","slack_get_permalink","slack_get_thread","slack_get_thread_replies","slack_get_user","slack_get_user_presence","slack_invite_to_conversation","slack_list_canvases","slack_list_channels","slack_list_members","slack_list_scheduled_messages","slack_list_users","slack_lookup_canvas_sections","slack_message","slack_message_reader","slack_open_view","slack_publish_view","slack_push_view","slack_remove_reaction","slack_rename_conversation","slack_schedule_message","slack_set_conversation_purpose","slack_set_conversation_topic","slack_set_status","slack_set_suggested_prompts","slack_set_title","slack_update_message","slack_update_view","sms_send","smtp_send_mail","sportmonks_core_get_cities","sportmonks_core_get_city","sportmonks_core_get_continent","sportmonks_core_get_continents","sportmonks_core_get_countries","sportmonks_core_get_country","sportmonks_core_get_entity_filters","sportmonks_core_get_my_usage","sportmonks_core_get_region","sportmonks_core_get_regions","sportmonks_core_get_timezones","sportmonks_core_get_type","sportmonks_core_get_type_by_entity","sportmonks_core_get_types","sportmonks_core_search_cities","sportmonks_core_search_countries","sportmonks_core_search_regions","sportmonks_football_expected_by_player","sportmonks_football_expected_by_team","sportmonks_football_get_all_commentaries","sportmonks_football_get_all_fixtures","sportmonks_football_get_all_players","sportmonks_football_get_all_rivals","sportmonks_football_get_all_teams","sportmonks_football_get_all_transfer_rumours","sportmonks_football_get_all_transfers","sportmonks_football_get_brackets_by_season","sportmonks_football_get_coach","sportmonks_football_get_coaches","sportmonks_football_get_coaches_by_country","sportmonks_football_get_commentaries_by_fixture","sportmonks_football_get_current_leagues_by_team","sportmonks_football_get_expected_lineups_by_player","sportmonks_football_get_expected_lineups_by_team","sportmonks_football_get_extended_team_squad","sportmonks_football_get_fixture","sportmonks_football_get_fixtures_by_date","sportmonks_football_get_fixtures_by_date_range","sportmonks_football_get_fixtures_by_date_range_for_team","sportmonks_football_get_fixtures_by_ids","sportmonks_football_get_grouped_standings_by_round","sportmonks_football_get_head_to_head","sportmonks_football_get_inplay_livescores","sportmonks_football_get_latest_coaches","sportmonks_football_get_latest_fixtures","sportmonks_football_get_latest_livescores","sportmonks_football_get_latest_players","sportmonks_football_get_latest_totw","sportmonks_football_get_latest_transfers","sportmonks_football_get_league","sportmonks_football_get_leagues","sportmonks_football_get_leagues_by_country","sportmonks_football_get_leagues_by_date","sportmonks_football_get_leagues_by_team","sportmonks_football_get_live_leagues","sportmonks_football_get_live_probabilities","sportmonks_football_get_live_probabilities_by_fixture","sportmonks_football_get_live_standings_by_league","sportmonks_football_get_livescores","sportmonks_football_get_match_facts","sportmonks_football_get_match_facts_by_date_range","sportmonks_football_get_match_facts_by_fixture","sportmonks_football_get_match_facts_by_league","sportmonks_football_get_past_fixtures_by_tv_station","sportmonks_football_get_player","sportmonks_football_get_players_by_country","sportmonks_football_get_postmatch_news","sportmonks_football_get_postmatch_news_by_season","sportmonks_football_get_predictability_by_league","sportmonks_football_get_prematch_news","sportmonks_football_get_prematch_news_by_season","sportmonks_football_get_prematch_news_upcoming","sportmonks_football_get_probabilities","sportmonks_football_get_probabilities_by_fixture","sportmonks_football_get_referee","sportmonks_football_get_referees","sportmonks_football_get_referees_by_country","sportmonks_football_get_referees_by_season","sportmonks_football_get_rivals_by_team","sportmonks_football_get_round","sportmonks_football_get_round_statistics","sportmonks_football_get_rounds","sportmonks_football_get_rounds_by_season","sportmonks_football_get_schedules_by_season","sportmonks_football_get_schedules_by_season_and_team","sportmonks_football_get_schedules_by_team","sportmonks_football_get_season","sportmonks_football_get_seasons","sportmonks_football_get_seasons_by_team","sportmonks_football_get_stage","sportmonks_football_get_stage_statistics","sportmonks_football_get_stages","sportmonks_football_get_stages_by_season","sportmonks_football_get_standing_corrections_by_season","sportmonks_football_get_standings","sportmonks_football_get_standings_by_round","sportmonks_football_get_standings_by_season","sportmonks_football_get_state","sportmonks_football_get_states","sportmonks_football_get_team","sportmonks_football_get_team_rankings","sportmonks_football_get_team_rankings_by_date","sportmonks_football_get_team_rankings_by_team","sportmonks_football_get_team_squad","sportmonks_football_get_team_squad_by_season","sportmonks_football_get_teams_by_country","sportmonks_football_get_teams_by_season","sportmonks_football_get_topscorers_by_season","sportmonks_football_get_topscorers_by_stage","sportmonks_football_get_totw","sportmonks_football_get_totw_by_round","sportmonks_football_get_transfer","sportmonks_football_get_transfer_rumour","sportmonks_football_get_transfer_rumours_between_dates","sportmonks_football_get_transfer_rumours_by_player","sportmonks_football_get_transfer_rumours_by_team","sportmonks_football_get_transfers_between_dates","sportmonks_football_get_transfers_by_player","sportmonks_football_get_transfers_by_team","sportmonks_football_get_tv_station","sportmonks_football_get_tv_stations","sportmonks_football_get_tv_stations_by_fixture","sportmonks_football_get_upcoming_fixtures_by_market","sportmonks_football_get_upcoming_fixtures_by_tv_station","sportmonks_football_get_value_bets","sportmonks_football_get_value_bets_by_fixture","sportmonks_football_get_venue","sportmonks_football_get_venues","sportmonks_football_get_venues_by_season","sportmonks_football_search_coaches","sportmonks_football_search_fixtures","sportmonks_football_search_leagues","sportmonks_football_search_players","sportmonks_football_search_referees","sportmonks_football_search_rounds","sportmonks_football_search_seasons","sportmonks_football_search_stages","sportmonks_football_search_teams","sportmonks_football_search_venues","sportmonks_motorsport_get_all_fixtures","sportmonks_motorsport_get_current_leagues_by_team","sportmonks_motorsport_get_driver","sportmonks_motorsport_get_driver_standings","sportmonks_motorsport_get_driver_standings_by_season","sportmonks_motorsport_get_drivers","sportmonks_motorsport_get_drivers_by_country","sportmonks_motorsport_get_drivers_by_season","sportmonks_motorsport_get_fixture","sportmonks_motorsport_get_fixtures_by_date","sportmonks_motorsport_get_fixtures_by_date_range","sportmonks_motorsport_get_fixtures_by_ids","sportmonks_motorsport_get_laps_by_fixture","sportmonks_motorsport_get_laps_by_fixture_and_driver","sportmonks_motorsport_get_laps_by_fixture_and_lap","sportmonks_motorsport_get_latest_laps_by_fixture","sportmonks_motorsport_get_latest_pitstops_by_fixture","sportmonks_motorsport_get_latest_stints_by_fixture","sportmonks_motorsport_get_latest_updated_drivers","sportmonks_motorsport_get_latest_updated_fixtures","sportmonks_motorsport_get_league","sportmonks_motorsport_get_leagues","sportmonks_motorsport_get_leagues_by_country","sportmonks_motorsport_get_leagues_by_date","sportmonks_motorsport_get_leagues_by_live","sportmonks_motorsport_get_leagues_by_team","sportmonks_motorsport_get_livescores","sportmonks_motorsport_get_pitstops_by_fixture","sportmonks_motorsport_get_pitstops_by_fixture_and_driver","sportmonks_motorsport_get_pitstops_by_fixture_and_lap","sportmonks_motorsport_get_race_results_by_season_and_driver","sportmonks_motorsport_get_race_results_by_season_and_team","sportmonks_motorsport_get_schedules_by_season","sportmonks_motorsport_get_season","sportmonks_motorsport_get_seasons","sportmonks_motorsport_get_stage","sportmonks_motorsport_get_stages","sportmonks_motorsport_get_stages_by_season","sportmonks_motorsport_get_state","sportmonks_motorsport_get_states","sportmonks_motorsport_get_stints_by_fixture","sportmonks_motorsport_get_stints_by_fixture_and_driver","sportmonks_motorsport_get_stints_by_fixture_and_stint","sportmonks_motorsport_get_team","sportmonks_motorsport_get_team_standings","sportmonks_motorsport_get_team_standings_by_season","sportmonks_motorsport_get_teams","sportmonks_motorsport_get_teams_by_country","sportmonks_motorsport_get_teams_by_season","sportmonks_motorsport_get_venue","sportmonks_motorsport_get_venues","sportmonks_motorsport_get_venues_by_season","sportmonks_motorsport_search_drivers","sportmonks_motorsport_search_leagues","sportmonks_motorsport_search_stages","sportmonks_motorsport_search_teams","sportmonks_motorsport_search_venues","sportmonks_odds_get_all_historical_odds","sportmonks_odds_get_all_inplay_odds","sportmonks_odds_get_all_pre_match_odds","sportmonks_odds_get_all_premium_odds","sportmonks_odds_get_bookmaker","sportmonks_odds_get_bookmaker_event_ids_by_fixture","sportmonks_odds_get_bookmakers","sportmonks_odds_get_bookmakers_by_fixture","sportmonks_odds_get_inplay_odds_by_fixture","sportmonks_odds_get_inplay_odds_by_fixture_and_bookmaker","sportmonks_odds_get_inplay_odds_by_fixture_and_market","sportmonks_odds_get_last_updated_inplay_odds","sportmonks_odds_get_last_updated_pre_match_odds","sportmonks_odds_get_market","sportmonks_odds_get_markets","sportmonks_odds_get_pre_match_odds_by_fixture","sportmonks_odds_get_pre_match_odds_by_fixture_and_bookmaker","sportmonks_odds_get_pre_match_odds_by_fixture_and_market","sportmonks_odds_get_premium_odds_by_fixture","sportmonks_odds_get_premium_odds_by_fixture_and_bookmaker","sportmonks_odds_get_premium_odds_by_fixture_and_market","sportmonks_odds_get_updated_historical_odds_between","sportmonks_odds_get_updated_premium_odds_between","sportmonks_odds_search_bookmakers","sportmonks_odds_search_markets","spotify_add_playlist_cover","spotify_add_to_queue","spotify_add_tracks_to_playlist","spotify_check_following","spotify_check_playlist_followers","spotify_check_saved_albums","spotify_check_saved_audiobooks","spotify_check_saved_episodes","spotify_check_saved_shows","spotify_check_saved_tracks","spotify_create_playlist","spotify_follow_artists","spotify_follow_playlist","spotify_get_album","spotify_get_album_tracks","spotify_get_albums","spotify_get_artist","spotify_get_artist_albums","spotify_get_artist_top_tracks","spotify_get_artists","spotify_get_audiobook","spotify_get_audiobook_chapters","spotify_get_audiobooks","spotify_get_categories","spotify_get_current_user","spotify_get_currently_playing","spotify_get_devices","spotify_get_episode","spotify_get_episodes","spotify_get_followed_artists","spotify_get_markets","spotify_get_new_releases","spotify_get_playback_state","spotify_get_playlist","spotify_get_playlist_cover","spotify_get_playlist_tracks","spotify_get_queue","spotify_get_recently_played","spotify_get_saved_albums","spotify_get_saved_audiobooks","spotify_get_saved_episodes","spotify_get_saved_shows","spotify_get_saved_tracks","spotify_get_show","spotify_get_show_episodes","spotify_get_shows","spotify_get_top_artists","spotify_get_top_tracks","spotify_get_track","spotify_get_tracks","spotify_get_user_playlists","spotify_get_user_profile","spotify_pause","spotify_play","spotify_remove_saved_albums","spotify_remove_saved_audiobooks","spotify_remove_saved_episodes","spotify_remove_saved_shows","spotify_remove_saved_tracks","spotify_remove_tracks_from_playlist","spotify_reorder_playlist_items","spotify_replace_playlist_items","spotify_save_albums","spotify_save_audiobooks","spotify_save_episodes","spotify_save_shows","spotify_save_tracks","spotify_search","spotify_seek","spotify_set_repeat","spotify_set_shuffle","spotify_set_volume","spotify_skip_next","spotify_skip_previous","spotify_transfer_playback","spotify_unfollow_artists","spotify_unfollow_playlist","spotify_update_playlist","sqs_send","square_batch_retrieve_inventory_counts","square_cancel_invoice","square_cancel_payment","square_complete_payment","square_create_catalog_image","square_create_customer","square_create_invoice","square_create_order","square_create_payment","square_delete_catalog_object","square_delete_customer","square_delete_invoice","square_get_catalog_object","square_get_customer","square_get_invoice","square_get_location","square_get_order","square_get_payment","square_get_refund","square_list_catalog","square_list_customers","square_list_invoices","square_list_locations","square_list_payments","square_list_refunds","square_pay_order","square_publish_invoice","square_refund_payment","square_search_catalog_objects","square_search_customers","square_search_invoices","square_search_orders","square_update_customer","square_upsert_catalog_object","ssh_check_command_exists","ssh_check_file_exists","ssh_create_directory","ssh_delete_file","ssh_download_file","ssh_execute_command","ssh_execute_script","ssh_get_system_info","ssh_list_directory","ssh_move_rename","ssh_read_file_content","ssh_upload_file","ssh_write_file_content","stagehand_agent","stagehand_extract","stripe_cancel_payment_intent","stripe_cancel_subscription","stripe_capture_charge","stripe_capture_payment_intent","stripe_confirm_payment_intent","stripe_create_charge","stripe_create_customer","stripe_create_invoice","stripe_create_payment_intent","stripe_create_price","stripe_create_product","stripe_create_subscription","stripe_delete_customer","stripe_delete_invoice","stripe_delete_product","stripe_finalize_invoice","stripe_list_charges","stripe_list_customers","stripe_list_events","stripe_list_invoices","stripe_list_payment_intents","stripe_list_prices","stripe_list_products","stripe_list_subscriptions","stripe_pay_invoice","stripe_resume_subscription","stripe_retrieve_charge","stripe_retrieve_customer","stripe_retrieve_event","stripe_retrieve_invoice","stripe_retrieve_payment_intent","stripe_retrieve_price","stripe_retrieve_product","stripe_retrieve_subscription","stripe_search_charges","stripe_search_customers","stripe_search_invoices","stripe_search_payment_intents","stripe_search_prices","stripe_search_products","stripe_search_subscriptions","stripe_send_invoice","stripe_update_charge","stripe_update_customer","stripe_update_invoice","stripe_update_payment_intent","stripe_update_price","stripe_update_product","stripe_update_subscription","stripe_void_invoice","sts_assume_role","sts_assume_role_with_saml","sts_assume_role_with_web_identity","sts_get_access_key_info","sts_get_caller_identity","sts_get_session_token","stt_assemblyai","stt_assemblyai_v2","stt_deepgram","stt_deepgram_v2","stt_elevenlabs","stt_elevenlabs_v2","stt_gemini","stt_gemini_v2","stt_whisper","stt_whisper_v2","supabase_count","supabase_delete","supabase_get_row","supabase_insert","supabase_introspect","supabase_invoke_function","supabase_query","supabase_rpc","supabase_storage_copy","supabase_storage_create_bucket","supabase_storage_create_signed_upload_url","supabase_storage_create_signed_url","supabase_storage_delete","supabase_storage_delete_bucket","supabase_storage_download","supabase_storage_empty_bucket","supabase_storage_get_public_url","supabase_storage_list","supabase_storage_list_buckets","supabase_storage_move","supabase_storage_update_bucket","supabase_storage_upload","supabase_text_search","supabase_update","supabase_upsert","supabase_vector_search","table_batch_insert_rows","table_create","table_delete_row","table_delete_rows_by_filter","table_get_row","table_get_schema","table_insert_row","table_list","table_query_rows","table_query_rows_v2","table_update_row","table_update_rows_by_filter","table_upsert_row","tailscale_authorize_device","tailscale_create_auth_key","tailscale_delete_auth_key","tailscale_delete_device","tailscale_delete_user","tailscale_expire_device_key","tailscale_get_acl","tailscale_get_auth_key","tailscale_get_device","tailscale_get_device_routes","tailscale_get_dns_preferences","tailscale_get_dns_searchpaths","tailscale_list_auth_keys","tailscale_list_devices","tailscale_list_dns_nameservers","tailscale_list_users","tailscale_set_acl","tailscale_set_device_routes","tailscale_set_device_tags","tailscale_set_dns_nameservers","tailscale_set_dns_preferences","tailscale_set_dns_searchpaths","tailscale_suspend_user","tailscale_update_device_key","tavily_crawl","tavily_extract","tavily_map","tavily_search","telegram_copy_message","telegram_delete_message","telegram_edit_message_text","telegram_forward_message","telegram_get_chat","telegram_get_chat_member","telegram_message","telegram_pin_message","telegram_send_animation","telegram_send_audio","telegram_send_chat_action","telegram_send_contact","telegram_send_document","telegram_send_location","telegram_send_photo","telegram_send_poll","telegram_send_video","telegram_set_message_reaction","telegram_unpin_message","temporal_cancel_workflow","temporal_count_workflows","temporal_create_schedule","temporal_delete_schedule","temporal_describe_schedule","temporal_describe_task_queue","temporal_describe_workflow","temporal_get_workflow_history","temporal_list_schedules","temporal_list_workflows","temporal_pause_schedule","temporal_query_workflow","temporal_reset_workflow","temporal_signal_with_start","temporal_signal_workflow","temporal_start_workflow","temporal_terminate_workflow","temporal_trigger_schedule","temporal_unpause_schedule","temporal_update_workflow","textract_analyze_expense","textract_analyze_id","textract_parser","textract_parser_v2","thinking_tool","thrive_add_audience_managers","thrive_add_audience_members","thrive_add_user_tags","thrive_create_assignment","thrive_create_audience","thrive_create_completion","thrive_create_user","thrive_delete_assignment","thrive_delete_audience","thrive_delete_user","thrive_get_activity","thrive_get_assignment","thrive_get_audience","thrive_get_completion","thrive_get_content","thrive_get_cpd_category","thrive_get_cpd_entry","thrive_get_cpd_requirement","thrive_get_enrolment","thrive_get_skill_levels","thrive_get_tag","thrive_get_user_by_id","thrive_get_user_by_ref","thrive_list_assignments","thrive_list_audience_managers","thrive_list_audience_members","thrive_list_audiences","thrive_list_completions","thrive_list_enrolments","thrive_list_tags","thrive_query_activities","thrive_query_content","thrive_query_cpd_categories","thrive_query_cpd_entries","thrive_query_cpd_requirements","thrive_query_cpd_user_summaries","thrive_remove_audience_manager","thrive_remove_audience_member","thrive_remove_user_tags","thrive_replace_audience_managers","thrive_replace_audience_members","thrive_search_users","thrive_suspend_user","thrive_update_assignment","thrive_update_audience","thrive_update_user","thrive_update_user_skills","tiktok_get_post_status","tiktok_get_user","tiktok_list_videos","tiktok_query_videos","tiktok_upload_video_draft","tinybird_append_datasource","tinybird_delete_datasource_rows","tinybird_events","tinybird_get_job","tinybird_query","tinybird_query_pipe","tinybird_truncate_datasource","trello_add_checklist","trello_add_checklist_item","trello_add_comment","trello_add_label","trello_add_member","trello_create_board","trello_create_card","trello_create_list","trello_delete_card","trello_get_actions","trello_get_board","trello_get_card","trello_list_cards","trello_list_lists","trello_list_members","trello_remove_label","trello_remove_member","trello_search","trello_update_card","trello_update_checklist_item","trello_update_list","trigger_dev_activate_schedule","trigger_dev_add_run_tags","trigger_dev_batch_trigger_task","trigger_dev_cancel_run","trigger_dev_complete_waitpoint_token","trigger_dev_create_env_var","trigger_dev_create_schedule","trigger_dev_create_waitpoint_token","trigger_dev_deactivate_schedule","trigger_dev_delete_env_var","trigger_dev_delete_schedule","trigger_dev_execute_query","trigger_dev_get_batch","trigger_dev_get_batch_results","trigger_dev_get_deployment","trigger_dev_get_env_var","trigger_dev_get_latest_deployment","trigger_dev_get_query_schema","trigger_dev_get_queue","trigger_dev_get_run","trigger_dev_get_run_events","trigger_dev_get_run_result","trigger_dev_get_run_trace","trigger_dev_get_schedule","trigger_dev_get_waitpoint_token","trigger_dev_import_env_vars","trigger_dev_list_deployments","trigger_dev_list_env_vars","trigger_dev_list_queues","trigger_dev_list_runs","trigger_dev_list_schedules","trigger_dev_list_timezones","trigger_dev_list_waitpoint_tokens","trigger_dev_override_queue_concurrency","trigger_dev_pause_queue","trigger_dev_promote_deployment","trigger_dev_replay_run","trigger_dev_reschedule_run","trigger_dev_reset_queue_concurrency","trigger_dev_resume_queue","trigger_dev_trigger_task","trigger_dev_update_env_var","trigger_dev_update_run_metadata","trigger_dev_update_schedule","tts_azure","tts_cartesia","tts_deepgram","tts_elevenlabs","tts_google","tts_openai","tts_playht","twilio_send_sms","twilio_voice_get_recording","twilio_voice_list_calls","twilio_voice_make_call","typeform_create_form","typeform_delete_form","typeform_files","typeform_get_form","typeform_insights","typeform_list_forms","typeform_responses","typeform_update_form","upstash_redis_command","upstash_redis_delete","upstash_redis_exists","upstash_redis_expire","upstash_redis_get","upstash_redis_hget","upstash_redis_hgetall","upstash_redis_hset","upstash_redis_incr","upstash_redis_incrby","upstash_redis_keys","upstash_redis_lpush","upstash_redis_lrange","upstash_redis_set","upstash_redis_setnx","upstash_redis_ttl","uptimerobot_create_alert_contact","uptimerobot_create_maintenance_window","uptimerobot_create_monitor","uptimerobot_create_psp","uptimerobot_delete_alert_contact","uptimerobot_delete_maintenance_window","uptimerobot_delete_monitor","uptimerobot_delete_psp","uptimerobot_get_account","uptimerobot_get_alert_contact","uptimerobot_get_incident","uptimerobot_get_maintenance_window","uptimerobot_get_monitor","uptimerobot_get_psp","uptimerobot_list_alert_contacts","uptimerobot_list_incidents","uptimerobot_list_maintenance_windows","uptimerobot_list_monitors","uptimerobot_list_psps","uptimerobot_pause_monitor","uptimerobot_start_monitor","uptimerobot_update_maintenance_window","uptimerobot_update_monitor","uptimerobot_update_psp","vanta_download_document_file","vanta_get_control","vanta_get_document","vanta_get_framework","vanta_get_person","vanta_get_policy","vanta_get_risk_scenario","vanta_get_test","vanta_get_vendor","vanta_get_vulnerable_asset","vanta_list_control_documents","vanta_list_control_tests","vanta_list_controls","vanta_list_document_uploads","vanta_list_documents","vanta_list_framework_controls","vanta_list_frameworks","vanta_list_monitored_computers","vanta_list_people","vanta_list_policies","vanta_list_risk_scenarios","vanta_list_test_entities","vanta_list_tests","vanta_list_vendors","vanta_list_vulnerabilities","vanta_list_vulnerability_remediations","vanta_list_vulnerable_assets","vanta_submit_document","vanta_upload_document_file","vercel_add_domain","vercel_add_project_domain","vercel_cancel_deployment","vercel_create_alias","vercel_create_check","vercel_create_deployment","vercel_create_dns_record","vercel_create_edge_config","vercel_create_env_var","vercel_create_project","vercel_create_webhook","vercel_delete_alias","vercel_delete_deployment","vercel_delete_dns_record","vercel_delete_domain","vercel_delete_edge_config","vercel_delete_env_var","vercel_delete_project","vercel_delete_webhook","vercel_get_alias","vercel_get_check","vercel_get_deployment","vercel_get_deployment_events","vercel_get_domain","vercel_get_domain_config","vercel_get_edge_config","vercel_get_edge_config_items","vercel_get_env_vars","vercel_get_project","vercel_get_team","vercel_get_user","vercel_get_webhook","vercel_list_aliases","vercel_list_checks","vercel_list_deployment_files","vercel_list_deployments","vercel_list_dns_records","vercel_list_domains","vercel_list_edge_configs","vercel_list_project_domains","vercel_list_projects","vercel_list_team_members","vercel_list_teams","vercel_list_webhooks","vercel_pause_project","vercel_promote_deployment","vercel_remove_project_domain","vercel_rerequest_check","vercel_unpause_project","vercel_update_check","vercel_update_dns_record","vercel_update_edge_config_items","vercel_update_env_var","vercel_update_project","vercel_update_project_domain","vercel_verify_project_domain","video_falai","video_luma","video_minimax","video_runway","video_veo","vision_tool","vision_tool_v2","wealthbox_read_contact","wealthbox_read_note","wealthbox_read_task","wealthbox_write_contact","wealthbox_write_note","wealthbox_write_task","webflow_create_item","webflow_delete_item","webflow_get_item","webflow_list_items","webflow_update_item","webhook_request","whatsapp_get_media","whatsapp_mark_read","whatsapp_send_interactive","whatsapp_send_media","whatsapp_send_message","whatsapp_send_reaction","whatsapp_send_template","whatsapp_upload_media","wikipedia_content","wikipedia_random","wikipedia_search","wikipedia_summary","wiza_company_enrichment","wiza_get_credits","wiza_individual_reveal","wiza_prospect_search","wordpress_create_category","wordpress_create_comment","wordpress_create_page","wordpress_create_post","wordpress_create_tag","wordpress_delete_category","wordpress_delete_comment","wordpress_delete_media","wordpress_delete_page","wordpress_delete_post","wordpress_delete_tag","wordpress_get_category","wordpress_get_current_user","wordpress_get_media","wordpress_get_page","wordpress_get_post","wordpress_get_tag","wordpress_get_user","wordpress_list_categories","wordpress_list_comments","wordpress_list_media","wordpress_list_pages","wordpress_list_posts","wordpress_list_tags","wordpress_list_users","wordpress_search_content","wordpress_update_category","wordpress_update_comment","wordpress_update_page","wordpress_update_post","wordpress_update_tag","wordpress_upload_media","workday_assign_onboarding","workday_change_job","workday_create_prehire","workday_get_compensation","workday_get_organizations","workday_get_worker","workday_hire_employee","workday_list_workers","workday_terminate_worker","workday_update_worker","workflow_executor","x_create_bookmark","x_create_tweet","x_delete_bookmark","x_delete_tweet","x_get_blocking","x_get_bookmarks","x_get_followers","x_get_following","x_get_liked_tweets","x_get_liking_users","x_get_me","x_get_personalized_trends","x_get_quote_tweets","x_get_retweeted_by","x_get_trends_by_woeid","x_get_tweets_by_ids","x_get_usage","x_get_user_mentions","x_get_user_timeline","x_get_user_tweets","x_hide_reply","x_manage_block","x_manage_follow","x_manage_like","x_manage_mute","x_manage_retweet","x_read","x_search","x_search_tweets","x_search_users","x_user","x_write","youtube_channel_info","youtube_channel_playlists","youtube_channel_videos","youtube_comments","youtube_playlist_items","youtube_search","youtube_trending","youtube_video_categories","youtube_video_details","zendesk_autocomplete_organizations","zendesk_create_organization","zendesk_create_organizations_bulk","zendesk_create_ticket","zendesk_create_tickets_bulk","zendesk_create_user","zendesk_create_users_bulk","zendesk_delete_organization","zendesk_delete_ticket","zendesk_delete_user","zendesk_get_current_user","zendesk_get_organization","zendesk_get_organizations","zendesk_get_ticket","zendesk_get_tickets","zendesk_get_user","zendesk_get_users","zendesk_merge_tickets","zendesk_search","zendesk_search_count","zendesk_search_users","zendesk_update_organization","zendesk_update_ticket","zendesk_update_tickets_bulk","zendesk_update_user","zendesk_update_users_bulk","zep_add_messages","zep_add_user","zep_create_thread","zep_delete_thread","zep_get_context","zep_get_messages","zep_get_threads","zep_get_user","zep_get_user_threads","zerobounce_get_credits","zerobounce_verify_email","zoom_create_meeting","zoom_delete_meeting","zoom_delete_recording","zoom_get_meeting","zoom_get_meeting_invitation","zoom_get_meeting_recordings","zoom_list_meetings","zoom_list_past_participants","zoom_list_recordings","zoom_update_meeting","zoominfo_enrich_companies","zoominfo_enrich_contacts","zoominfo_search_companies","zoominfo_search_contacts","zoominfo_search_intent","zoominfo_search_news"]' +) + +export default toolIds diff --git a/apps/sim/tools/generated/tool-metadata.ts b/apps/sim/tools/generated/tool-metadata.ts new file mode 100644 index 00000000000..0c334cc8aa6 --- /dev/null +++ b/apps/sim/tools/generated/tool-metadata.ts @@ -0,0 +1,9 @@ +// Generated by scripts/sync-tool-metadata.ts — do not edit. +// Regenerate with: bun run tool-metadata:generate + +/** Serializable metadata for every built-in tool, keyed by tool id. */ +const toolMetadata: Record = JSON.parse( + '{"a2a_cancel_task":{"id":"a2a_cancel_task","name":"A2A Cancel Task","description":"Request cancellation of an in-progress A2A task.","version":"1.0.0","params":{"agentUrl":{"type":"string","required":true,"visibility":"user-only","description":"The A2A agent endpoint URL"},"taskId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The task ID to cancel"},"apiKey":{"type":"string","required":false,"visibility":"user-only","description":"API key for authentication (if required)"}}},"a2a_get_agent_card":{"id":"a2a_get_agent_card","name":"A2A Get Agent Card","description":"Fetch the Agent Card (discovery document) for an external A2A agent.","version":"1.0.0","params":{"agentUrl":{"type":"string","required":true,"visibility":"user-only","description":"The A2A agent endpoint URL"},"apiKey":{"type":"string","required":false,"visibility":"user-only","description":"API key for authentication (if required)"}}},"a2a_get_task":{"id":"a2a_get_task","name":"A2A Get Task","description":"Retrieve the current state and result of an A2A task.","version":"1.0.0","params":{"agentUrl":{"type":"string","required":true,"visibility":"user-only","description":"The A2A agent endpoint URL"},"taskId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The task ID to retrieve"},"historyLength":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of history messages to include"},"apiKey":{"type":"string","required":false,"visibility":"user-only","description":"API key for authentication (if required)"}}},"a2a_send_message":{"id":"a2a_send_message","name":"A2A Send Message","description":"Send a message to an external A2A agent and return its response.","version":"1.0.0","params":{"agentUrl":{"type":"string","required":true,"visibility":"user-only","description":"The A2A agent endpoint URL"},"message":{"type":"string","required":true,"visibility":"user-or-llm","description":"The message text to send"},"data":{"type":"json","required":false,"visibility":"user-or-llm","description":"Optional structured JSON data to attach"},"files":{"type":"json","required":false,"visibility":"user-or-llm","description":"Optional files to attach"},"taskId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Existing task ID to continue"},"contextId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Conversation context ID to continue"},"apiKey":{"type":"string","required":false,"visibility":"user-only","description":"API key for authentication (if required)"}}},"agentmail_create_draft":{"id":"agentmail_create_draft","name":"Create Draft","description":"Create a new email draft in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox to create the draft in"},"to":{"type":"string","required":false,"visibility":"user-or-llm","description":"Recipient email addresses (comma-separated)"},"subject":{"type":"string","required":false,"visibility":"user-or-llm","description":"Draft subject line"},"text":{"type":"string","required":false,"visibility":"user-or-llm","description":"Plain text draft body"},"html":{"type":"string","required":false,"visibility":"user-or-llm","description":"HTML draft body"},"cc":{"type":"string","required":false,"visibility":"user-or-llm","description":"CC recipient email addresses (comma-separated)"},"bcc":{"type":"string","required":false,"visibility":"user-or-llm","description":"BCC recipient email addresses (comma-separated)"},"inReplyTo":{"type":"string","required":false,"visibility":"user-or-llm","description":"ID of message being replied to"},"sendAt":{"type":"string","required":false,"visibility":"user-or-llm","description":"ISO 8601 timestamp to schedule sending"}}},"agentmail_create_inbox":{"id":"agentmail_create_inbox","name":"Create Inbox","description":"Create a new email inbox with AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"username":{"type":"string","required":false,"visibility":"user-or-llm","description":"Username for the inbox email address"},"domain":{"type":"string","required":false,"visibility":"user-or-llm","description":"Domain for the inbox email address"},"displayName":{"type":"string","required":false,"visibility":"user-or-llm","description":"Display name for the inbox"}}},"agentmail_delete_draft":{"id":"agentmail_delete_draft","name":"Delete Draft","description":"Delete an email draft in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox containing the draft"},"draftId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the draft to delete"}}},"agentmail_delete_inbox":{"id":"agentmail_delete_inbox","name":"Delete Inbox","description":"Delete an email inbox in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox to delete"}}},"agentmail_delete_thread":{"id":"agentmail_delete_thread","name":"Delete Thread","description":"Delete an email thread in AgentMail (moves to trash, or permanently deletes if already in trash)","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox containing the thread"},"threadId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the thread to delete"},"permanent":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Force permanent deletion instead of moving to trash"}}},"agentmail_forward_message":{"id":"agentmail_forward_message","name":"Forward Message","description":"Forward an email message to new recipients in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox containing the message"},"messageId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the message to forward"},"to":{"type":"string","required":true,"visibility":"user-or-llm","description":"Recipient email addresses (comma-separated)"},"subject":{"type":"string","required":false,"visibility":"user-or-llm","description":"Override subject line"},"text":{"type":"string","required":false,"visibility":"user-or-llm","description":"Additional plain text to prepend"},"html":{"type":"string","required":false,"visibility":"user-or-llm","description":"Additional HTML to prepend"},"cc":{"type":"string","required":false,"visibility":"user-or-llm","description":"CC recipient email addresses (comma-separated)"},"bcc":{"type":"string","required":false,"visibility":"user-or-llm","description":"BCC recipient email addresses (comma-separated)"}}},"agentmail_get_draft":{"id":"agentmail_get_draft","name":"Get Draft","description":"Get details of a specific email draft in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox the draft belongs to"},"draftId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the draft to retrieve"}}},"agentmail_get_inbox":{"id":"agentmail_get_inbox","name":"Get Inbox","description":"Get details of a specific email inbox in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox to retrieve"}}},"agentmail_get_message":{"id":"agentmail_get_message","name":"Get Message","description":"Get details of a specific email message in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox containing the message"},"messageId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the message to retrieve"}}},"agentmail_get_thread":{"id":"agentmail_get_thread","name":"Get Thread","description":"Get details of a specific email thread including messages in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox containing the thread"},"threadId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the thread to retrieve"}}},"agentmail_list_drafts":{"id":"agentmail_list_drafts","name":"List Drafts","description":"List email drafts in an inbox in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox to list drafts from"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of drafts to return"},"pageToken":{"type":"string","required":false,"visibility":"user-or-llm","description":"Pagination token for next page of results"}}},"agentmail_list_inboxes":{"id":"agentmail_list_inboxes","name":"List Inboxes","description":"List all email inboxes in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of inboxes to return"},"pageToken":{"type":"string","required":false,"visibility":"user-or-llm","description":"Pagination token for next page of results"}}},"agentmail_list_messages":{"id":"agentmail_list_messages","name":"List Messages","description":"List messages in an inbox in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox to list messages from"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of messages to return"},"pageToken":{"type":"string","required":false,"visibility":"user-or-llm","description":"Pagination token for next page of results"}}},"agentmail_list_threads":{"id":"agentmail_list_threads","name":"List Threads","description":"List email threads in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox to list threads from"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of threads to return"},"pageToken":{"type":"string","required":false,"visibility":"user-or-llm","description":"Pagination token for next page of results"},"labels":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated labels to filter threads by"},"before":{"type":"string","required":false,"visibility":"user-or-llm","description":"Filter threads before this ISO 8601 timestamp"},"after":{"type":"string","required":false,"visibility":"user-or-llm","description":"Filter threads after this ISO 8601 timestamp"}}},"agentmail_reply_message":{"id":"agentmail_reply_message","name":"Reply to Message","description":"Reply to an existing email message in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox to reply from"},"messageId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the message to reply to"},"text":{"type":"string","required":false,"visibility":"user-or-llm","description":"Plain text reply body"},"html":{"type":"string","required":false,"visibility":"user-or-llm","description":"HTML reply body"},"to":{"type":"string","required":false,"visibility":"user-or-llm","description":"Override recipient email addresses (comma-separated)"},"cc":{"type":"string","required":false,"visibility":"user-or-llm","description":"CC email addresses (comma-separated)"},"bcc":{"type":"string","required":false,"visibility":"user-or-llm","description":"BCC email addresses (comma-separated)"},"replyAll":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Reply to all recipients of the original message"}}},"agentmail_send_draft":{"id":"agentmail_send_draft","name":"Send Draft","description":"Send an existing email draft in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox containing the draft"},"draftId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the draft to send"}}},"agentmail_send_message":{"id":"agentmail_send_message","name":"Send Message","description":"Send an email message from an AgentMail inbox","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox to send from"},"to":{"type":"string","required":true,"visibility":"user-or-llm","description":"Recipient email address (comma-separated for multiple)"},"subject":{"type":"string","required":true,"visibility":"user-or-llm","description":"Email subject line"},"text":{"type":"string","required":false,"visibility":"user-or-llm","description":"Plain text email body"},"html":{"type":"string","required":false,"visibility":"user-or-llm","description":"HTML email body"},"cc":{"type":"string","required":false,"visibility":"user-or-llm","description":"CC recipient email addresses (comma-separated)"},"bcc":{"type":"string","required":false,"visibility":"user-or-llm","description":"BCC recipient email addresses (comma-separated)"}}},"agentmail_update_draft":{"id":"agentmail_update_draft","name":"Update Draft","description":"Update an existing email draft in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox containing the draft"},"draftId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the draft to update"},"to":{"type":"string","required":false,"visibility":"user-or-llm","description":"Recipient email addresses (comma-separated)"},"subject":{"type":"string","required":false,"visibility":"user-or-llm","description":"Draft subject line"},"text":{"type":"string","required":false,"visibility":"user-or-llm","description":"Plain text draft body"},"html":{"type":"string","required":false,"visibility":"user-or-llm","description":"HTML draft body"},"cc":{"type":"string","required":false,"visibility":"user-or-llm","description":"CC recipient email addresses (comma-separated)"},"bcc":{"type":"string","required":false,"visibility":"user-or-llm","description":"BCC recipient email addresses (comma-separated)"},"sendAt":{"type":"string","required":false,"visibility":"user-or-llm","description":"ISO 8601 timestamp to schedule sending"}}},"agentmail_update_inbox":{"id":"agentmail_update_inbox","name":"Update Inbox","description":"Update the display name of an email inbox in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox to update"},"displayName":{"type":"string","required":true,"visibility":"user-or-llm","description":"New display name for the inbox"}}},"agentmail_update_message":{"id":"agentmail_update_message","name":"Update Message","description":"Add or remove labels on an email message in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox containing the message"},"messageId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the message to update"},"addLabels":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated labels to add to the message"},"removeLabels":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated labels to remove from the message"}}},"agentmail_update_thread":{"id":"agentmail_update_thread","name":"Update Thread Labels","description":"Add or remove labels on an email thread in AgentMail","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentMail API key"},"inboxId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the inbox containing the thread"},"threadId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the thread to update"},"addLabels":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated labels to add to the thread"},"removeLabels":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated labels to remove from the thread"}}},"agentphone_create_call":{"id":"agentphone_create_call","name":"Create Outbound Call","description":"Initiate an outbound voice call from an AgentPhone agent","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"agentId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Agent that will handle the call"},"toNumber":{"type":"string","required":true,"visibility":"user-or-llm","description":"Phone number to call in E.164 format (e.g. +14155551234)"},"fromNumberId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Phone number ID to use as caller ID. Must belong to the agent. If omitted, the agent\'s first assigned number is used."},"initialGreeting":{"type":"string","required":false,"visibility":"user-or-llm","description":"Optional greeting spoken when the recipient answers"},"voice":{"type":"string","required":false,"visibility":"user-or-llm","description":"Voice ID override for this call (defaults to the agent\'s configured voice)"},"systemPrompt":{"type":"string","required":false,"visibility":"user-or-llm","description":"When provided, uses a built-in LLM for the conversation instead of forwarding to your webhook"}}},"agentphone_create_contact":{"id":"agentphone_create_contact","name":"Create Contact","description":"Create a new contact in AgentPhone","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"phoneNumber":{"type":"string","required":true,"visibility":"user-or-llm","description":"Phone number in E.164 format (e.g. +14155551234)"},"name":{"type":"string","required":true,"visibility":"user-or-llm","description":"Contact\'s full name"},"email":{"type":"string","required":false,"visibility":"user-or-llm","description":"Contact\'s email address"},"notes":{"type":"string","required":false,"visibility":"user-or-llm","description":"Freeform notes stored on the contact"}}},"agentphone_create_number":{"id":"agentphone_create_number","name":"Create Phone Number","description":"Provision a new SMS- and voice-enabled phone number","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Two-letter country code (e.g. US, CA). Defaults to US."},"areaCode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Preferred area code (US/CA only, e.g. \\"415\\"). Best-effort — may be ignored if unavailable."},"agentId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Optionally attach the number to an agent immediately"}}},"agentphone_delete_contact":{"id":"agentphone_delete_contact","name":"Delete Contact","description":"Delete a contact by ID","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"contactId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Contact ID"}}},"agentphone_get_call":{"id":"agentphone_get_call","name":"Get Call","description":"Fetch a call and its full transcript","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"callId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the call to retrieve"}}},"agentphone_get_call_transcript":{"id":"agentphone_get_call_transcript","name":"Get Call Transcript","description":"Get the full ordered transcript for a call","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"callId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the call to retrieve the transcript for"}}},"agentphone_get_contact":{"id":"agentphone_get_contact","name":"Get Contact","description":"Fetch a single contact by ID","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"contactId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Contact ID"}}},"agentphone_get_conversation":{"id":"agentphone_get_conversation","name":"Get Conversation","description":"Get a conversation along with its recent messages","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"conversationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Conversation ID"},"messageLimit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of recent messages to include (default 50, max 100)"}}},"agentphone_get_conversation_messages":{"id":"agentphone_get_conversation_messages","name":"Get Conversation Messages","description":"Get paginated messages for a conversation","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"conversationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Conversation ID"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of messages to return (default 50, max 200)"},"before":{"type":"string","required":false,"visibility":"user-or-llm","description":"Return messages received before this ISO 8601 timestamp"},"after":{"type":"string","required":false,"visibility":"user-or-llm","description":"Return messages received after this ISO 8601 timestamp"}}},"agentphone_get_number_messages":{"id":"agentphone_get_number_messages","name":"Get Phone Number Messages","description":"Fetch messages received on a specific phone number","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"numberId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the phone number"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of messages to return (default 50, max 200)"},"before":{"type":"string","required":false,"visibility":"user-or-llm","description":"Return messages received before this ISO 8601 timestamp"},"after":{"type":"string","required":false,"visibility":"user-or-llm","description":"Return messages received after this ISO 8601 timestamp"}}},"agentphone_get_usage":{"id":"agentphone_get_usage","name":"Get Usage","description":"Retrieve current usage statistics for the AgentPhone account","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"}}},"agentphone_get_usage_daily":{"id":"agentphone_get_usage_daily","name":"Get Daily Usage","description":"Get a daily breakdown of usage (messages, calls, webhooks) for the last N days","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"days":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of days to return (1-365, default 30)"}}},"agentphone_get_usage_monthly":{"id":"agentphone_get_usage_monthly","name":"Get Monthly Usage","description":"Get monthly usage aggregation (messages, calls, webhooks) for the last N months","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"months":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of months to return (1-24, default 6)"}}},"agentphone_list_calls":{"id":"agentphone_list_calls","name":"List Calls","description":"List voice calls for this AgentPhone account","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of results to return (default 20, max 100)"},"offset":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of results to skip (min 0)"},"status":{"type":"string","required":false,"visibility":"user-or-llm","description":"Filter by status (completed, in-progress, failed)"},"direction":{"type":"string","required":false,"visibility":"user-or-llm","description":"Filter by direction (inbound, outbound)"},"type":{"type":"string","required":false,"visibility":"user-or-llm","description":"Filter by call type (pstn, web)"},"search":{"type":"string","required":false,"visibility":"user-or-llm","description":"Search by phone number (matches fromNumber or toNumber)"}}},"agentphone_list_contacts":{"id":"agentphone_list_contacts","name":"List Contacts","description":"List contacts for this AgentPhone account","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"search":{"type":"string","required":false,"visibility":"user-or-llm","description":"Filter by name or phone number (case-insensitive contains)"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of results to return (default 50, max 200)"},"offset":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of results to skip (min 0)"}}},"agentphone_list_conversations":{"id":"agentphone_list_conversations","name":"List Conversations","description":"List conversations (message threads) for this AgentPhone account","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of results to return (default 20, max 100)"},"offset":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of results to skip (min 0)"}}},"agentphone_list_numbers":{"id":"agentphone_list_numbers","name":"List Phone Numbers","description":"List all phone numbers provisioned for this AgentPhone account","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of results to return (default 20, max 100)"},"offset":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of results to skip (min 0)"}}},"agentphone_react_to_message":{"id":"agentphone_react_to_message","name":"React to Message","description":"Send an iMessage tapback reaction to a message (iMessage only)","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"messageId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the message to react to"},"reaction":{"type":"string","required":true,"visibility":"user-or-llm","description":"Reaction type: love, like, dislike, laugh, emphasize, or question"}}},"agentphone_release_number":{"id":"agentphone_release_number","name":"Release Phone Number","description":"Release (delete) a phone number. This action is irreversible.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"numberId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the phone number to release"}}},"agentphone_send_message":{"id":"agentphone_send_message","name":"Send Message","description":"Send an outbound SMS or iMessage from an AgentPhone agent","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"agentId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Agent sending the message"},"toNumber":{"type":"string","required":true,"visibility":"user-or-llm","description":"Recipient phone number in E.164 format (e.g. +14155551234)"},"body":{"type":"string","required":true,"visibility":"user-or-llm","description":"Message text to send"},"mediaUrl":{"type":"string","required":false,"visibility":"user-or-llm","description":"Optional URL of an image, video, or file to attach"},"numberId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Phone number ID to send from. If omitted, the agent\'s first assigned number is used."}}},"agentphone_update_contact":{"id":"agentphone_update_contact","name":"Update Contact","description":"Update a contact\'s fields","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"contactId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Contact ID"},"phoneNumber":{"type":"string","required":false,"visibility":"user-or-llm","description":"New phone number in E.164 format"},"name":{"type":"string","required":false,"visibility":"user-or-llm","description":"New contact name"},"email":{"type":"string","required":false,"visibility":"user-or-llm","description":"New email address"},"notes":{"type":"string","required":false,"visibility":"user-or-llm","description":"New freeform notes"}}},"agentphone_update_conversation":{"id":"agentphone_update_conversation","name":"Update Conversation","description":"Update conversation metadata (stored state). Pass null to clear existing metadata.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"AgentPhone API key"},"conversationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Conversation ID"},"metadata":{"type":"json","required":false,"visibility":"user-or-llm","description":"Custom key-value metadata to store on the conversation. Pass null to clear existing metadata."}}},"agiloft_attach_file":{"id":"agiloft_attach_file","name":"Agiloft Attach File","description":"Attach a file to a field in an Agiloft record.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name (e.g., \\"contracts\\")"},"recordId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the record to attach the file to"},"fieldName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the attachment field"},"file":{"type":"file","required":false,"visibility":"user-or-llm","description":"File to attach"},"fileName":{"type":"string","required":false,"visibility":"user-or-llm","description":"Name to assign to the file (defaults to original file name)"}}},"agiloft_attachment_info":{"id":"agiloft_attachment_info","name":"Agiloft Attachment Info","description":"Get information about file attachments on a record field.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name (e.g., \\"contracts\\")"},"recordId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the record to check attachments on"},"fieldName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the attachment field to inspect"}}},"agiloft_create_record":{"id":"agiloft_create_record","name":"Agiloft Create Record","description":"Create a new record in an Agiloft table.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name (e.g., \\"contracts\\", \\"contacts.employees\\")"},"data":{"type":"string","required":true,"visibility":"user-or-llm","description":"Record field values as a JSON object (e.g., {\\"first_name\\": \\"John\\", \\"status\\": \\"Active\\"})"}}},"agiloft_delete_record":{"id":"agiloft_delete_record","name":"Agiloft Delete Record","description":"Delete a record from an Agiloft table.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name (e.g., \\"contracts\\", \\"contacts.employees\\")"},"recordId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the record to delete"}}},"agiloft_get_choice_line_id":{"id":"agiloft_get_choice_line_id","name":"Agiloft Get Choice Line ID","description":"Resolve the internal numeric ID of a choice-list value, for use in EWSelect WHERE clauses against choice fields.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name (e.g., \\"case\\", \\"contracts\\")"},"fieldName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Choice field name (e.g., \\"priority\\", \\"status\\")"},"value":{"type":"string","required":true,"visibility":"user-or-llm","description":"Choice display value to resolve (e.g., \\"High\\", \\"Active\\")"}}},"agiloft_lock_record":{"id":"agiloft_lock_record","name":"Agiloft Lock Record","description":"Lock, unlock, or check the lock status of an Agiloft record.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name (e.g., \\"contracts\\")"},"recordId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the record to lock, unlock, or check"},"lockAction":{"type":"string","required":true,"visibility":"user-or-llm","description":"Action to perform: \\"lock\\", \\"unlock\\", or \\"check\\""}}},"agiloft_read_record":{"id":"agiloft_read_record","name":"Agiloft Read Record","description":"Read a record by ID from an Agiloft table.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name (e.g., \\"contracts\\", \\"contacts.employees\\")"},"recordId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the record to read"},"fields":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated list of field names to include in the response"}}},"agiloft_remove_attachment":{"id":"agiloft_remove_attachment","name":"Agiloft Remove Attachment","description":"Remove an attached file from a field in an Agiloft record.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name (e.g., \\"contracts\\")"},"recordId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the record containing the attachment"},"fieldName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the attachment field"},"position":{"type":"string","required":true,"visibility":"user-or-llm","description":"Position index of the file to remove (starting from 0)"}}},"agiloft_retrieve_attachment":{"id":"agiloft_retrieve_attachment","name":"Agiloft Retrieve Attachment","description":"Download an attached file from an Agiloft record field.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name (e.g., \\"contracts\\")"},"recordId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the record containing the attachment"},"fieldName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the attachment field"},"position":{"type":"string","required":true,"visibility":"user-or-llm","description":"Position index of the file in the field (starting from 0)"}}},"agiloft_saved_search":{"id":"agiloft_saved_search","name":"Agiloft Saved Search","description":"List saved searches defined for an Agiloft table.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name to list saved searches for (e.g., \\"contracts\\")"}}},"agiloft_search_records":{"id":"agiloft_search_records","name":"Agiloft Search Records","description":"Search for records in an Agiloft table using a query.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name to search in (e.g., \\"contracts\\", \\"contacts.employees\\")"},"query":{"type":"string","required":true,"visibility":"user-or-llm","description":"Search query using Agiloft query syntax (e.g., \\"status=\'Active\'\\" or \\"company_name~=\'Acme\'\\")"},"fields":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated list of field names to include in the results"},"page":{"type":"string","required":false,"visibility":"user-or-llm","description":"Page number for paginated results (starting from 0)"},"limit":{"type":"string","required":false,"visibility":"user-or-llm","description":"Maximum number of records to return per page"}}},"agiloft_select_records":{"id":"agiloft_select_records","name":"Agiloft Select Records","description":"Select record IDs matching a SQL WHERE clause from an Agiloft table.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name (e.g., \\"contracts\\", \\"contacts.employees\\")"},"where":{"type":"string","required":true,"visibility":"user-or-llm","description":"SQL WHERE clause using database column names (e.g., \\"summary like \'%new%\'\\" or \\"assigned_person=\'John Doe\'\\")"}}},"agiloft_update_record":{"id":"agiloft_update_record","name":"Agiloft Update Record","description":"Update an existing record in an Agiloft table.","version":"1.0.0","params":{"instanceUrl":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft instance URL (e.g., https://mycompany.agiloft.com)"},"knowledgeBase":{"type":"string","required":true,"visibility":"user-only","description":"Knowledge base name"},"login":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft username"},"password":{"type":"string","required":true,"visibility":"user-only","description":"Agiloft password"},"table":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table name (e.g., \\"contracts\\", \\"contacts.employees\\")"},"recordId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the record to update"},"data":{"type":"string","required":true,"visibility":"user-or-llm","description":"Updated field values as a JSON object (e.g., {\\"status\\": \\"Active\\", \\"priority\\": \\"High\\"})"}}},"ahrefs_anchors":{"id":"ahrefs_anchors","name":"Ahrefs Anchors","description":"Get the anchor text distribution for a target domain or URL\'s backlinks, showing how many links and referring domains use each anchor text.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\" or \\"https://example.com/page\\""},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match)"},"history":{"type":"string","required":false,"visibility":"user-or-llm","description":"Historical scope: \\"live\\" (currently live), \\"all_time\\" (default, includes lost backlinks), or \\"since:YYYY-MM-DD\\" (backlinks found since a date)"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_backlinks":{"id":"ahrefs_backlinks","name":"Ahrefs Backlinks","description":"Get a list of backlinks pointing to a target domain or URL. Returns details about each backlink including source URL, anchor text, and domain rating.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\" or \\"https://example.com/page\\""},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: \\"domain\\""},"history":{"type":"string","required":false,"visibility":"user-or-llm","description":"Historical scope: \\"live\\" (currently live backlinks), \\"all_time\\" (default, includes lost backlinks), or \\"since:YYYY-MM-DD\\" (backlinks found since a date)."},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_backlinks_stats":{"id":"ahrefs_backlinks_stats","name":"Ahrefs Backlinks Stats","description":"Get backlink and referring domain totals for a target domain or URL, both currently live and across all time.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\" or \\"https://example.com/page\\""},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: \\"domain\\""},"date":{"type":"string","required":false,"visibility":"user-only","description":"Date to report metrics on, in YYYY-MM-DD format (defaults to today)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_batch_analysis":{"id":"ahrefs_batch_analysis","name":"Ahrefs Batch Analysis","description":"Get bulk SEO metrics (Domain Rating, backlinks, referring domains, organic traffic, and more) for multiple domains or URLs in a single request. Useful for comparing many competitors at once.","version":"1.0.0","params":{"targets":{"type":"string","required":true,"visibility":"user-or-llm","description":"Comma-separated list of domains or URLs to analyze. Example: \\"example.com,competitor.com\\""},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode applied to every target: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match)"},"protocol":{"type":"string","required":false,"visibility":"user-or-llm","description":"Protocol applied to every target: \\"both\\" (default), \\"http\\", or \\"https\\""},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Country code for traffic data. Example: \\"us\\", \\"gb\\", \\"de\\" (default: \\"us\\")"},"volumeMode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Search volume calculation: \\"monthly\\" or \\"average\\" (default: \\"monthly\\")"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_broken_backlinks":{"id":"ahrefs_broken_backlinks","name":"Ahrefs Broken Backlinks","description":"Get a list of broken backlinks pointing to a target domain or URL. Useful for identifying link reclamation opportunities.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\" or \\"https://example.com/page\\""},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: \\"domain\\""},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_domain_rating":{"id":"ahrefs_domain_rating","name":"Ahrefs Domain Rating","description":"Get the Domain Rating (DR) and Ahrefs Rank for a target domain. Domain Rating shows the strength of a website\'s backlink profile on a scale from 0 to 100.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain to analyze (e.g., example.com)"},"date":{"type":"string","required":false,"visibility":"user-only","description":"Date for historical data in YYYY-MM-DD format (defaults to today)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_domain_rating_history":{"id":"ahrefs_domain_rating_history","name":"Ahrefs Domain Rating History","description":"Get the historical Domain Rating (DR) trend for a target domain or URL over a date range, grouped daily, weekly, or monthly.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\""},"dateFrom":{"type":"string","required":true,"visibility":"user-only","description":"Start date of the historical period, in YYYY-MM-DD format"},"dateTo":{"type":"string","required":false,"visibility":"user-only","description":"End date of the historical period, in YYYY-MM-DD format (defaults to today)"},"historyGrouping":{"type":"string","required":false,"visibility":"user-or-llm","description":"Time interval for grouping data points: \\"daily\\", \\"weekly\\", or \\"monthly\\" (default: \\"monthly\\")"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_keyword_overview":{"id":"ahrefs_keyword_overview","name":"Ahrefs Keyword Overview","description":"Get detailed metrics for a keyword including search volume, keyword difficulty, CPC, clicks, and traffic potential.","version":"1.0.0","params":{"keyword":{"type":"string","required":true,"visibility":"user-or-llm","description":"The keyword to analyze"},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Country code for keyword data. Example: \\"us\\", \\"gb\\", \\"de\\" (default: \\"us\\")"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_keywords_history":{"id":"ahrefs_keywords_history","name":"Ahrefs Keywords History","description":"Get the historical organic keyword ranking distribution for a target domain or URL over a date range: how many keywords rank in each position bucket at each point in time.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\""},"dateFrom":{"type":"string","required":true,"visibility":"user-only","description":"Start date of the historical period, in YYYY-MM-DD format"},"dateTo":{"type":"string","required":false,"visibility":"user-only","description":"End date of the historical period, in YYYY-MM-DD format (defaults to today)"},"historyGrouping":{"type":"string","required":false,"visibility":"user-or-llm","description":"Time interval for grouping data points: \\"daily\\", \\"weekly\\", or \\"monthly\\" (default: \\"monthly\\")"},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Country code for search results. Example: \\"us\\", \\"gb\\", \\"de\\" (default: \\"us\\")"},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_metrics":{"id":"ahrefs_metrics","name":"Ahrefs Metrics","description":"Get a one-call organic and paid search overview for a target domain or URL: organic traffic, organic keywords, paid traffic, paid keywords, and estimated traffic cost.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\""},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Country code for traffic data. Example: \\"us\\", \\"gb\\", \\"de\\""},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: \\"domain\\""},"date":{"type":"string","required":false,"visibility":"user-only","description":"Date to report metrics on, in YYYY-MM-DD format (defaults to today)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_metrics_history":{"id":"ahrefs_metrics_history","name":"Ahrefs Metrics History","description":"Get the historical organic and paid traffic trend for a target domain or URL over a date range: organic traffic/cost and paid traffic/cost at each point in time.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\""},"dateFrom":{"type":"string","required":true,"visibility":"user-only","description":"Start date of the historical period, in YYYY-MM-DD format"},"dateTo":{"type":"string","required":false,"visibility":"user-only","description":"End date of the historical period, in YYYY-MM-DD format (defaults to today)"},"volumeMode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Search volume calculation: \\"monthly\\" or \\"average\\" (default: \\"monthly\\")"},"historyGrouping":{"type":"string","required":false,"visibility":"user-or-llm","description":"Time interval for grouping data points: \\"daily\\", \\"weekly\\", or \\"monthly\\" (default: \\"monthly\\")"},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Country code for traffic data. Example: \\"us\\", \\"gb\\", \\"de\\" (default: \\"us\\")"},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_organic_competitors":{"id":"ahrefs_organic_competitors","name":"Ahrefs Organic Competitors","description":"Get domains that compete with a target domain or URL for the same organic keywords, ranked by keyword overlap.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\""},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Country code for search results. Example: \\"us\\", \\"gb\\", \\"de\\" (default: \\"us\\")"},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: \\"domain\\""},"date":{"type":"string","required":false,"visibility":"user-only","description":"Date to report metrics on, in YYYY-MM-DD format (defaults to today)"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_organic_keywords":{"id":"ahrefs_organic_keywords","name":"Ahrefs Organic Keywords","description":"Get organic keywords that a target domain or URL ranks for in Google search results. Returns keyword details including search volume, ranking position, and estimated traffic.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\" or \\"https://example.com/page\\""},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Country code for search results. Example: \\"us\\", \\"gb\\", \\"de\\" (default: \\"us\\")"},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: \\"domain\\""},"date":{"type":"string","required":false,"visibility":"user-only","description":"Date to report metrics on, in YYYY-MM-DD format (defaults to today)"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_paid_pages":{"id":"ahrefs_paid_pages","name":"Ahrefs Paid Pages","description":"Get a target domain\'s pages that receive paid search traffic, sorted by estimated paid traffic. Returns page URLs with their paid traffic, keyword counts, and estimated spend.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\""},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Country code for traffic data. Example: \\"us\\", \\"gb\\", \\"de\\" (default: \\"us\\")"},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match)"},"date":{"type":"string","required":false,"visibility":"user-only","description":"Date to report metrics on, in YYYY-MM-DD format (defaults to today)"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_rank_tracker_competitors_overview":{"id":"ahrefs_rank_tracker_competitors_overview","name":"Ahrefs Rank Tracker Competitors Overview","description":"Get competitor rankings for the keywords tracked in an Ahrefs Rank Tracker project: each tracked keyword\'s volume and difficulty alongside every competitor\'s position, traffic, and traffic value. This endpoint is free and does not consume API units.","version":"1.0.0","params":{"projectId":{"type":"number","required":true,"visibility":"user-or-llm","description":"The Rank Tracker project ID (found in the project URL in Ahrefs)"},"date":{"type":"string","required":true,"visibility":"user-only","description":"Date to report rankings for, in YYYY-MM-DD format"},"device":{"type":"string","required":true,"visibility":"user-or-llm","description":"Rankings device type: \\"desktop\\" or \\"mobile\\""},"dateCompared":{"type":"string","required":false,"visibility":"user-only","description":"Comparison date in YYYY-MM-DD format, to compute position/traffic deltas"},"volumeMode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Search volume calculation: \\"monthly\\" or \\"average\\" (default: \\"monthly\\")"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_rank_tracker_competitors_stats":{"id":"ahrefs_rank_tracker_competitors_stats","name":"Ahrefs Rank Tracker Competitors Stats","description":"Get aggregate competitor stats for an Ahrefs Rank Tracker project: each competitor\'s traffic, traffic value, average position, and share of voice across all tracked keywords. This endpoint is free and does not consume API units.","version":"1.0.0","params":{"projectId":{"type":"number","required":true,"visibility":"user-or-llm","description":"The Rank Tracker project ID (found in the project URL in Ahrefs)"},"date":{"type":"string","required":true,"visibility":"user-only","description":"Date to report metrics for, in YYYY-MM-DD format"},"device":{"type":"string","required":true,"visibility":"user-or-llm","description":"Rankings device type: \\"desktop\\" or \\"mobile\\""},"volumeMode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Search volume calculation: \\"monthly\\" or \\"average\\" (default: \\"monthly\\")"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_rank_tracker_overview":{"id":"ahrefs_rank_tracker_overview","name":"Ahrefs Rank Tracker Overview","description":"Get ranking overview metrics for the keywords tracked in an Ahrefs Rank Tracker project: position, search volume, keyword difficulty, and estimated traffic. This endpoint is free and does not consume API units.","version":"1.0.0","params":{"projectId":{"type":"number","required":true,"visibility":"user-or-llm","description":"The Rank Tracker project ID (found in the project URL in Ahrefs)"},"date":{"type":"string","required":true,"visibility":"user-only","description":"Date to report rankings for, in YYYY-MM-DD format"},"device":{"type":"string","required":true,"visibility":"user-or-llm","description":"Rankings device type: \\"desktop\\" or \\"mobile\\""},"dateCompared":{"type":"string","required":false,"visibility":"user-only","description":"Comparison date in YYYY-MM-DD format, to compute position/traffic deltas"},"volumeMode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Search volume calculation: \\"monthly\\" or \\"average\\" (default: \\"monthly\\")"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_rank_tracker_serp_overview":{"id":"ahrefs_rank_tracker_serp_overview","name":"Ahrefs Rank Tracker SERP Overview","description":"Get the full SERP (search engine results page) for a keyword tracked in an Ahrefs Rank Tracker project, including every ranking URL with its position, title, and authority metrics. This endpoint is free and does not consume API units.","version":"1.0.0","params":{"projectId":{"type":"number","required":true,"visibility":"user-or-llm","description":"The Rank Tracker project ID (found in the project URL in Ahrefs)"},"keyword":{"type":"string","required":true,"visibility":"user-or-llm","description":"The tracked keyword to retrieve SERP data for"},"country":{"type":"string","required":true,"visibility":"user-or-llm","description":"Country code for the tracked keyword. Example: \\"us\\", \\"gb\\", \\"de\\""},"device":{"type":"string","required":true,"visibility":"user-or-llm","description":"Rankings device type: \\"desktop\\" or \\"mobile\\""},"topPositions":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of top organic positions to return (defaults to all available)"},"date":{"type":"string","required":false,"visibility":"user-only","description":"Timestamp to return the last available SERP Overview at, in YYYY-MM-DDThh:mm:ss format"},"locationId":{"type":"number","required":false,"visibility":"user-or-llm","description":"Location ID of the tracked keyword, if tracked at a specific location"},"languageCode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Language code of the tracked keyword"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_refdomains_history":{"id":"ahrefs_refdomains_history","name":"Ahrefs Referring Domains History","description":"Get the historical referring domains trend for a target domain or URL over a date range, grouped daily, weekly, or monthly.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\""},"dateFrom":{"type":"string","required":true,"visibility":"user-only","description":"Start date of the historical period, in YYYY-MM-DD format"},"dateTo":{"type":"string","required":false,"visibility":"user-only","description":"End date of the historical period, in YYYY-MM-DD format (defaults to today)"},"historyGrouping":{"type":"string","required":false,"visibility":"user-or-llm","description":"Time interval for grouping data points: \\"daily\\", \\"weekly\\", or \\"monthly\\" (default: \\"monthly\\")"},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_referring_domains":{"id":"ahrefs_referring_domains","name":"Ahrefs Referring Domains","description":"Get a list of domains that link to a target domain or URL. Returns unique referring domains with their domain rating, backlink counts, and discovery dates.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain or URL to analyze. Example: \\"example.com\\" or \\"https://example.com/page\\""},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: \\"domain\\""},"history":{"type":"string","required":false,"visibility":"user-or-llm","description":"Historical scope: \\"live\\" (currently live), \\"all_time\\" (default, includes lost domains), or \\"since:YYYY-MM-DD\\" (domains found since a date)."},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_related_terms":{"id":"ahrefs_related_terms","name":"Ahrefs Related Terms","description":"Get keyword ideas related to a seed keyword: terms the same top-ranking pages also rank for (\\"also rank for\\") or also discuss (\\"also talk about\\"), with volume, difficulty, and CPC.","version":"1.0.0","params":{"keyword":{"type":"string","required":true,"visibility":"user-or-llm","description":"The seed keyword to find related terms for"},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Country code for keyword data. Example: \\"us\\", \\"gb\\", \\"de\\" (default: \\"us\\")"},"terms":{"type":"string","required":false,"visibility":"user-or-llm","description":"Type of related keywords to return: \\"also_rank_for\\", \\"also_talk_about\\", or \\"all\\" (default: \\"all\\")"},"viewFor":{"type":"string","required":false,"visibility":"user-or-llm","description":"Whether to derive related terms from the top 10 or top 100 ranking pages (default: \\"top_10\\")"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_site_audit_page_explorer":{"id":"ahrefs_site_audit_page_explorer","name":"Ahrefs Site Audit Page Explorer","description":"Get crawled pages from an Ahrefs Site Audit project with health and SEO metrics: HTTP status, title, link counts, backlinks, indexability, and traffic. Optionally filter to pages affected by a specific issue.","version":"1.0.0","params":{"projectId":{"type":"number","required":true,"visibility":"user-or-llm","description":"The Site Audit project ID (found in the project URL in Ahrefs)"},"date":{"type":"string","required":false,"visibility":"user-only","description":"Crawl date in YYYY-MM-DDThh:mm:ss format (defaults to the most recent crawl)"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"offset":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of results to skip, for pagination"},"issueId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Only return pages affected by this issue ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"ahrefs_top_pages":{"id":"ahrefs_top_pages","name":"Ahrefs Top Pages","description":"Get the top pages of a target domain sorted by organic traffic. Returns page URLs with their traffic, keyword counts, and estimated traffic value.","version":"1.0.0","params":{"target":{"type":"string","required":true,"visibility":"user-or-llm","description":"The target domain to analyze. Example: \\"example.com\\""},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Country code for traffic data. Example: \\"us\\", \\"gb\\", \\"de\\" (default: \\"us\\")"},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Analysis mode: domain (entire domain), prefix (URL prefix), subdomains (include all subdomains, default), exact (exact URL match). Example: \\"domain\\""},"date":{"type":"string","required":false,"visibility":"user-only","description":"Date to report metrics on, in YYYY-MM-DD format (defaults to today)"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of results to return. Example: 50 (default: 1000)"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ahrefs API Key"}}},"airtable_create_records":{"id":"airtable_create_records","name":"Airtable Create Records","description":"Write new records to an Airtable table","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token"},"baseId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Airtable base ID (starts with \\"app\\", e.g., \\"appXXXXXXXXXXXXXX\\")"},"tableId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table ID (starts with \\"tbl\\") or table name"},"records":{"type":"json","required":true,"visibility":"user-or-llm","description":"Array of records to create, each with a `fields` object"},"typecast":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"When true, Airtable automatically converts string values to the field type"}},"oauth":{"required":true,"provider":"airtable"}},"airtable_delete_records":{"id":"airtable_delete_records","name":"Airtable Delete Records","description":"Delete one or more records from an Airtable table by ID","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token"},"baseId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Airtable base ID (starts with \\"app\\", e.g., \\"appXXXXXXXXXXXXXX\\")"},"tableId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table ID (starts with \\"tbl\\") or table name"},"recordIds":{"type":"json","required":true,"visibility":"user-or-llm","description":"Array of record IDs to delete (each starts with \\"rec\\", e.g., [\\"recXXXXXXXXXXXXXX\\"]). Pass a single-element array to delete one record."}},"oauth":{"required":true,"provider":"airtable"}},"airtable_get_base_schema":{"id":"airtable_get_base_schema","name":"Airtable Get Base Schema","description":"Get the schema of all tables, fields, and views in an Airtable base","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token"},"baseId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Airtable base ID (starts with \\"app\\", e.g., \\"appXXXXXXXXXXXXXX\\")"}},"oauth":{"required":true,"provider":"airtable"}},"airtable_get_record":{"id":"airtable_get_record","name":"Airtable Get Record","description":"Retrieve a single record from an Airtable table by its ID","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token"},"baseId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Airtable base ID (starts with \\"app\\", e.g., \\"appXXXXXXXXXXXXXX\\")"},"tableId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table ID (starts with \\"tbl\\") or table name"},"recordId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Record ID to retrieve (starts with \\"rec\\", e.g., \\"recXXXXXXXXXXXXXX\\")"}},"oauth":{"required":true,"provider":"airtable"}},"airtable_list_bases":{"id":"airtable_list_bases","name":"Airtable List Bases","description":"List all bases the authenticated user has access to","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token"},"offset":{"type":"string","required":false,"visibility":"user-or-llm","description":"Pagination offset for retrieving additional bases"}},"oauth":{"required":true,"provider":"airtable"}},"airtable_list_records":{"id":"airtable_list_records","name":"Airtable List Records","description":"Read records from an Airtable table","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token"},"baseId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Airtable base ID (starts with \\"app\\", e.g., \\"appXXXXXXXXXXXXXX\\")"},"tableId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table ID (starts with \\"tbl\\") or table name"},"maxRecords":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of records to return (default: all records)"},"filterFormula":{"type":"string","required":false,"visibility":"user-or-llm","description":"Formula to filter records (e.g., \\"({Field Name} = \'Value\')\\")"}},"oauth":{"required":true,"provider":"airtable"}},"airtable_list_tables":{"id":"airtable_list_tables","name":"Airtable List Tables","description":"List all tables and their schema in an Airtable base","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token"},"baseId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Airtable base ID (starts with \\"app\\", e.g., \\"appXXXXXXXXXXXXXX\\")"}},"oauth":{"required":true,"provider":"airtable"}},"airtable_update_multiple_records":{"id":"airtable_update_multiple_records","name":"Airtable Update Multiple Records","description":"Update multiple existing records in an Airtable table","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token"},"baseId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Airtable base ID (starts with \\"app\\", e.g., \\"appXXXXXXXXXXXXXX\\")"},"tableId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table ID (starts with \\"tbl\\") or table name"},"records":{"type":"json","required":true,"visibility":"user-or-llm","description":"Array of records to update, each with an `id` and a `fields` object"},"typecast":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"When true, Airtable automatically converts string values to the field type"}},"oauth":{"required":true,"provider":"airtable"}},"airtable_update_record":{"id":"airtable_update_record","name":"Airtable Update Record","description":"Update an existing record in an Airtable table by ID","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token"},"baseId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Airtable base ID (starts with \\"app\\", e.g., \\"appXXXXXXXXXXXXXX\\")"},"tableId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table ID (starts with \\"tbl\\") or table name"},"recordId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Record ID to update (starts with \\"rec\\", e.g., \\"recXXXXXXXXXXXXXX\\")"},"fields":{"type":"json","required":true,"visibility":"user-or-llm","description":"An object containing the field names and their new values"},"typecast":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"When true, Airtable automatically converts string values to the field type"}},"oauth":{"required":true,"provider":"airtable"}},"airtable_upsert_records":{"id":"airtable_upsert_records","name":"Airtable Upsert Records","description":"Update existing records or create new ones in an Airtable table, matching on the specified merge fields","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token"},"baseId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Airtable base ID (starts with \\"app\\", e.g., \\"appXXXXXXXXXXXXXX\\")"},"tableId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Table ID (starts with \\"tbl\\") or table name"},"records":{"type":"json","required":true,"visibility":"user-or-llm","description":"Array of records to upsert, each with a `fields` object"},"fieldsToMergeOn":{"type":"json","required":true,"visibility":"user-or-llm","description":"Array of field names used to match existing records (max 3). A record is updated when all merge fields match, otherwise it is created. Example: [\\"Name\\"]"},"typecast":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"When true, Airtable automatically converts string values to the field type"}},"oauth":{"required":true,"provider":"airtable"}},"airweave_search":{"id":"airweave_search","name":"Airweave Search","description":"Search your synced data collections using Airweave. Supports semantic search with hybrid, neural, or keyword retrieval strategies. Optionally generate AI-powered answers from search results.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Airweave API Key for authentication"},"collectionId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The readable ID of the collection to search"},"query":{"type":"string","required":true,"visibility":"user-or-llm","description":"The search query text"},"limit":{"type":"number","required":false,"visibility":"user-only","description":"Maximum number of results to return (default: 100)"},"retrievalStrategy":{"type":"string","required":false,"visibility":"user-or-llm","description":"Retrieval strategy: hybrid (default), neural, or keyword"},"expandQuery":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Generate query variations to improve recall"},"rerank":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Reorder results for improved relevance using LLM"},"generateAnswer":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Generate a natural-language answer to the query"}}},"algolia_add_record":{"id":"algolia_add_record","name":"Algolia Add Record","description":"Add or replace a record in an Algolia index","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Admin API Key"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index"},"objectID":{"type":"string","required":false,"visibility":"user-or-llm","description":"Object ID for the record (auto-generated if not provided)"},"record":{"type":"json","required":true,"visibility":"user-or-llm","description":"JSON object representing the record to add"}}},"algolia_batch_operations":{"id":"algolia_batch_operations","name":"Algolia Batch Operations","description":"Perform batch add, update, partial update, or delete operations on records in an Algolia index","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Admin API Key"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index"},"requests":{"type":"json","required":true,"visibility":"user-or-llm","description":"Array of batch operations. Each item has \\"action\\" (addObject, updateObject, partialUpdateObject, partialUpdateObjectNoCreate, deleteObject, delete, clear) and \\"body\\" (the record data; must include objectID for update/delete; use an empty object {} for the index-level delete/clear actions)"}}},"algolia_browse_records":{"id":"algolia_browse_records","name":"Algolia Browse Records","description":"Browse and iterate over all records in an Algolia index using cursor pagination","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia API Key (must have browse ACL)"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index to browse"},"query":{"type":"string","required":false,"visibility":"user-or-llm","description":"Search query to filter browsed records"},"filters":{"type":"string","required":false,"visibility":"user-or-llm","description":"Filter string to narrow down results"},"attributesToRetrieve":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated list of attributes to retrieve"},"hitsPerPage":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of hits per page (default: 1000, max: 1000)"},"cursor":{"type":"string","required":false,"visibility":"user-or-llm","description":"Cursor from a previous browse response for pagination"},"aroundLatLng":{"type":"string","required":false,"visibility":"user-or-llm","description":"Coordinates for geo-search (e.g., \\"40.71,-74.01\\")"},"aroundRadius":{"type":"string","required":false,"visibility":"user-or-llm","description":"Maximum radius in meters for geo-search, or \\"all\\" for unlimited"},"insideBoundingBox":{"type":"json","required":false,"visibility":"user-or-llm","description":"Bounding box coordinates as [[lat1, lng1, lat2, lng2]] for geo-search"},"insidePolygon":{"type":"json","required":false,"visibility":"user-or-llm","description":"Polygon coordinates as [[lat1, lng1, lat2, lng2, lat3, lng3, ...]] for geo-search"}}},"algolia_clear_records":{"id":"algolia_clear_records","name":"Algolia Clear Records","description":"Clear all records from an Algolia index while keeping settings, synonyms, and rules","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Admin API Key (must have deleteIndex ACL)"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index to clear"}}},"algolia_copy_move_index":{"id":"algolia_copy_move_index","name":"Algolia Copy/Move Index","description":"Copy or move an Algolia index to a new destination","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Admin API Key"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the source index"},"operation":{"type":"string","required":true,"visibility":"user-or-llm","description":"Operation to perform: \\"copy\\" or \\"move\\""},"destination":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the destination index"},"scope":{"type":"json","required":false,"visibility":"user-or-llm","description":"Array of scopes to copy (only for \\"copy\\" operation): [\\"settings\\", \\"synonyms\\", \\"rules\\"]. Omit to copy everything including records."}}},"algolia_delete_by_filter":{"id":"algolia_delete_by_filter","name":"Algolia Delete By Filter","description":"Delete all records matching a filter from an Algolia index","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Admin API Key (must have deleteIndex ACL)"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index"},"filters":{"type":"string","required":false,"visibility":"user-or-llm","description":"Filter expression to match records for deletion (e.g., \\"category:outdated\\")"},"facetFilters":{"type":"json","required":false,"visibility":"user-or-llm","description":"Array of facet filters (e.g., [\\"brand:Acme\\"])"},"numericFilters":{"type":"json","required":false,"visibility":"user-or-llm","description":"Array of numeric filters (e.g., [\\"price > 100\\"])"},"tagFilters":{"type":"json","required":false,"visibility":"user-or-llm","description":"Array of tag filters using the _tags attribute (e.g., [\\"published\\"])"},"aroundLatLng":{"type":"string","required":false,"visibility":"user-or-llm","description":"Coordinates for geo-search filter (e.g., \\"40.71,-74.01\\")"},"aroundRadius":{"type":"string","required":false,"visibility":"user-or-llm","description":"Maximum radius in meters for geo-search, or \\"all\\" for unlimited"},"insideBoundingBox":{"type":"json","required":false,"visibility":"user-or-llm","description":"Bounding box coordinates as [[lat1, lng1, lat2, lng2]] for geo-search filter"},"insidePolygon":{"type":"json","required":false,"visibility":"user-or-llm","description":"Polygon coordinates as [[lat1, lng1, lat2, lng2, lat3, lng3, ...]] for geo-search filter"}}},"algolia_delete_index":{"id":"algolia_delete_index","name":"Algolia Delete Index","description":"Delete an entire Algolia index and all its records","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Admin API Key (must have deleteIndex ACL)"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index to delete"}}},"algolia_delete_record":{"id":"algolia_delete_record","name":"Algolia Delete Record","description":"Delete a record by objectID from an Algolia index","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Admin API Key"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index"},"objectID":{"type":"string","required":true,"visibility":"user-or-llm","description":"The objectID of the record to delete"}}},"algolia_get_record":{"id":"algolia_get_record","name":"Algolia Get Record","description":"Get a record by objectID from an Algolia index","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia API Key"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index"},"objectID":{"type":"string","required":true,"visibility":"user-or-llm","description":"The objectID of the record to retrieve"},"attributesToRetrieve":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated list of attributes to retrieve"}}},"algolia_get_records":{"id":"algolia_get_records","name":"Algolia Get Records","description":"Retrieve multiple records by objectID from one or more Algolia indices","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia API Key"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Default index name for all requests"},"requests":{"type":"json","required":true,"visibility":"user-or-llm","description":"Array of objects specifying records to retrieve. Each must have \\"objectID\\" and optionally \\"indexName\\" and \\"attributesToRetrieve\\"."}}},"algolia_get_settings":{"id":"algolia_get_settings","name":"Algolia Get Settings","description":"Retrieve the settings of an Algolia index","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia API Key"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index"}}},"algolia_get_task_status":{"id":"algolia_get_task_status","name":"Algolia Get Task Status","description":"Check whether an Algolia indexing task has finished publishing","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia API Key"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index the task ran against"},"taskID":{"type":"number","required":true,"visibility":"user-or-llm","description":"The taskID returned by a previous write operation"}}},"algolia_list_indices":{"id":"algolia_list_indices","name":"Algolia List Indices","description":"List all indices in an Algolia application","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia API Key"},"page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Page number for paginating indices (default: not paginated)"},"hitsPerPage":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of indices per page (default: 100)"}}},"algolia_partial_update_record":{"id":"algolia_partial_update_record","name":"Algolia Partial Update Record","description":"Partially update a record in an Algolia index without replacing it entirely","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Admin API Key"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index"},"objectID":{"type":"string","required":true,"visibility":"user-or-llm","description":"The objectID of the record to update"},"attributes":{"type":"json","required":true,"visibility":"user-or-llm","description":"JSON object with attributes to update. Supports built-in operations like {\\"stock\\": {\\"_operation\\": \\"Decrement\\", \\"value\\": 1}}"},"createIfNotExists":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Whether to create the record if it does not exist (default: true)"}}},"algolia_search":{"id":"algolia_search","name":"Algolia Search","description":"Search an Algolia index","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia API Key"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index to search"},"query":{"type":"string","required":true,"visibility":"user-or-llm","description":"Search query text"},"hitsPerPage":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of hits per page (default: 20)"},"page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Page number to retrieve (default: 0)"},"filters":{"type":"string","required":false,"visibility":"user-or-llm","description":"Filter string (e.g., \\"category:electronics AND price < 100\\")"},"attributesToRetrieve":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated list of attributes to retrieve"},"facets":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated list of facet attribute names to retrieve counts for (use \\"*\\" for all)"},"getRankingInfo":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Whether to include detailed ranking information in each hit"},"aroundLatLng":{"type":"string","required":false,"visibility":"user-or-llm","description":"Coordinates for geo-search (e.g., \\"40.71,-74.01\\")"},"aroundRadius":{"type":"string","required":false,"visibility":"user-or-llm","description":"Maximum radius in meters for geo-search, or \\"all\\" for unlimited"},"insideBoundingBox":{"type":"json","required":false,"visibility":"user-or-llm","description":"Bounding box coordinates as [[lat1, lng1, lat2, lng2]] for geo-search"},"insidePolygon":{"type":"json","required":false,"visibility":"user-or-llm","description":"Polygon coordinates as [[lat1, lng1, lat2, lng2, lat3, lng3, ...]] for geo-search"}}},"algolia_update_settings":{"id":"algolia_update_settings","name":"Algolia Update Settings","description":"Update the settings of an Algolia index","version":"1.0","params":{"applicationId":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Application ID"},"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Algolia Admin API Key (must have editSettings ACL)"},"indexName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the Algolia index"},"settings":{"type":"json","required":true,"visibility":"user-or-llm","description":"JSON object with settings to update (e.g., {\\"searchableAttributes\\": [\\"name\\", \\"description\\"], \\"customRanking\\": [\\"desc(popularity)\\"]})"},"forwardToReplicas":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Whether to apply changes to replica indices (default: false)"}}},"amplitude_event_segmentation":{"id":"amplitude_event_segmentation","name":"Amplitude Event Segmentation","description":"Query event analytics data with segmentation. Get event counts, uniques, averages, and more.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"secretKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude Secret Key"},"eventType":{"type":"string","required":true,"visibility":"user-or-llm","description":"Event type name to analyze"},"start":{"type":"string","required":true,"visibility":"user-or-llm","description":"Start date in YYYYMMDD format"},"end":{"type":"string","required":true,"visibility":"user-or-llm","description":"End date in YYYYMMDD format"},"metric":{"type":"string","required":false,"visibility":"user-or-llm","description":"Metric type: uniques, totals, pct_dau, average, histogram, sums, value_avg, or formula (default: uniques)"},"interval":{"type":"string","required":false,"visibility":"user-or-llm","description":"Time interval: 1 (daily), 7 (weekly), or 30 (monthly)"},"groupBy":{"type":"string","required":false,"visibility":"user-or-llm","description":"Property name to group by (prefix custom user properties with \\"gp:\\")"},"groupBy2":{"type":"string","required":false,"visibility":"user-or-llm","description":"Second property name to group by (prefix custom user properties with \\"gp:\\")"},"limit":{"type":"string","required":false,"visibility":"user-or-llm","description":"Maximum number of group-by values (max 1000)"},"filters":{"type":"string","required":false,"visibility":"user-or-llm","description":"JSON array of filter objects applied to the event, e.g. [{\\"subprop_type\\":\\"event\\",\\"subprop_key\\":\\"city\\",\\"subprop_op\\":\\"is\\",\\"subprop_value\\":[\\"San Francisco\\"]}]"},"formula":{"type":"string","required":false,"visibility":"user-or-llm","description":"Required when metric is \\"formula\\", e.g. \\"UNIQUES(A)/UNIQUES(B)\\""},"segment":{"type":"string","required":false,"visibility":"user-or-llm","description":"JSON segment definition(s) applied to the query"},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"amplitude_funnels":{"id":"amplitude_funnels","name":"Amplitude Funnels","description":"Analyze conversion rates and drop-off between a sequence of events.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"secretKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude Secret Key"},"events":{"type":"string","required":true,"visibility":"user-or-llm","description":"JSON array of event objects, one per funnel step in order, e.g. [{\\"event_type\\":\\"signup\\"},{\\"event_type\\":\\"purchase\\"}]"},"start":{"type":"string","required":true,"visibility":"user-or-llm","description":"Start date in YYYYMMDD format"},"end":{"type":"string","required":true,"visibility":"user-or-llm","description":"End date in YYYYMMDD format"},"mode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Funnel ordering: \\"ordered\\", \\"unordered\\", or \\"sequential\\" (default: ordered)"},"userType":{"type":"string","required":false,"visibility":"user-or-llm","description":"User type: \\"new\\" or \\"active\\" (default: active)"},"interval":{"type":"string","required":false,"visibility":"user-or-llm","description":"Time interval: -300000 (real-time), -3600000 (hourly), 1 (daily), 7 (weekly), or 30 (monthly)"},"conversionWindowSeconds":{"type":"string","required":false,"visibility":"user-or-llm","description":"Conversion window in seconds (default: 2592000, i.e. 30 days)"},"groupBy":{"type":"string","required":false,"visibility":"user-or-llm","description":"Property to group by (limit: one; prefix custom properties with \\"gp:\\")"},"limit":{"type":"string","required":false,"visibility":"user-or-llm","description":"Maximum number of group-by values (default: 100, max: 1000)"},"segment":{"type":"string","required":false,"visibility":"user-or-llm","description":"JSON segment definition(s) applied to the query"},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"amplitude_get_active_users":{"id":"amplitude_get_active_users","name":"Amplitude Get Active Users","description":"Get active or new user counts over a date range from the Dashboard REST API.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"secretKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude Secret Key"},"start":{"type":"string","required":true,"visibility":"user-or-llm","description":"Start date in YYYYMMDD format"},"end":{"type":"string","required":true,"visibility":"user-or-llm","description":"End date in YYYYMMDD format"},"metric":{"type":"string","required":false,"visibility":"user-or-llm","description":"Metric type: \\"active\\" or \\"new\\" (default: active)"},"interval":{"type":"string","required":false,"visibility":"user-or-llm","description":"Time interval: 1 (daily), 7 (weekly), or 30 (monthly)"},"groupBy":{"type":"string","required":false,"visibility":"user-or-llm","description":"Property name to group by"},"segment":{"type":"string","required":false,"visibility":"user-or-llm","description":"JSON segment definition(s) applied to the query"},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"amplitude_get_revenue":{"id":"amplitude_get_revenue","name":"Amplitude Get Revenue","description":"Get revenue LTV data including ARPU, ARPPU, total revenue, and paying user counts.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"secretKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude Secret Key"},"start":{"type":"string","required":true,"visibility":"user-or-llm","description":"Start date in YYYYMMDD format"},"end":{"type":"string","required":true,"visibility":"user-or-llm","description":"End date in YYYYMMDD format"},"metric":{"type":"string","required":false,"visibility":"user-or-llm","description":"Metric: 0 (ARPU), 1 (ARPPU), 2 (Total Revenue), 3 (Paying Users)"},"interval":{"type":"string","required":false,"visibility":"user-or-llm","description":"Time interval: 1 (daily), 7 (weekly), or 30 (monthly)"},"groupBy":{"type":"string","required":false,"visibility":"user-or-llm","description":"Property name to group by (limit: one)"},"segment":{"type":"string","required":false,"visibility":"user-or-llm","description":"JSON segment definition(s) applied to the query"},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"amplitude_group_identify":{"id":"amplitude_group_identify","name":"Amplitude Group Identify","description":"Set group-level properties in Amplitude. Supports $set, $setOnce, $add, $append, $unset operations.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"groupType":{"type":"string","required":true,"visibility":"user-or-llm","description":"Group classification (e.g., \\"company\\", \\"org_id\\")"},"groupValue":{"type":"string","required":true,"visibility":"user-or-llm","description":"Specific group identifier (e.g., \\"Acme Corp\\")"},"groupProperties":{"type":"string","required":true,"visibility":"user-or-llm","description":"JSON object of group properties. Use operations like $set, $setOnce, $add, $append, $unset."},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"amplitude_identify_user":{"id":"amplitude_identify_user","name":"Amplitude Identify User","description":"Set user properties in Amplitude using the Identify API. Supports $set, $setOnce, $add, $append, $unset operations.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"userId":{"type":"string","required":false,"visibility":"user-or-llm","description":"User ID (required if no device_id)"},"deviceId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Device ID (required if no user_id)"},"userProperties":{"type":"string","required":true,"visibility":"user-or-llm","description":"JSON object of user properties. Use operations like $set, $setOnce, $add, $append, $unset."},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"amplitude_list_events":{"id":"amplitude_list_events","name":"Amplitude List Events","description":"List all event types in the Amplitude project with their weekly totals and unique counts.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"secretKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude Secret Key"},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"amplitude_realtime_active_users":{"id":"amplitude_realtime_active_users","name":"Amplitude Real-time Active Users","description":"Get real-time active user counts at 5-minute granularity for the last 2 days.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"secretKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude Secret Key"},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"amplitude_retention":{"id":"amplitude_retention","name":"Amplitude Retention","description":"Measure how many users return to perform an action after a starting action.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"secretKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude Secret Key"},"startEvent":{"type":"string","required":true,"visibility":"user-or-llm","description":"JSON starting event object, e.g. {\\"event_type\\":\\"_new\\"} or {\\"event_type\\":\\"_active\\"}"},"returnEvent":{"type":"string","required":true,"visibility":"user-or-llm","description":"JSON returning event object, e.g. {\\"event_type\\":\\"_all\\"} or {\\"event_type\\":\\"_active\\"}"},"start":{"type":"string","required":true,"visibility":"user-or-llm","description":"Start date in YYYYMMDD format"},"end":{"type":"string","required":true,"visibility":"user-or-llm","description":"End date in YYYYMMDD format"},"retentionMode":{"type":"string","required":false,"visibility":"user-or-llm","description":"Retention type: \\"bracket\\", \\"rolling\\", or \\"n-day\\" (default: n-day)"},"retentionBrackets":{"type":"string","required":false,"visibility":"user-or-llm","description":"Required when Retention Mode is \\"bracket\\". Day ranges, e.g. [[0,4]]"},"interval":{"type":"string","required":false,"visibility":"user-or-llm","description":"Time interval: 1 (daily), 7 (weekly), or 30 (monthly)"},"groupBy":{"type":"string","required":false,"visibility":"user-or-llm","description":"Property to group by (limit: one; prefix custom properties with \\"gp:\\")"},"segment":{"type":"string","required":false,"visibility":"user-or-llm","description":"JSON segment definition(s) applied to the query"},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"amplitude_send_event":{"id":"amplitude_send_event","name":"Amplitude Send Event","description":"Track an event in Amplitude using the HTTP V2 API.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"userId":{"type":"string","required":false,"visibility":"user-or-llm","description":"User ID (required if no device_id)"},"deviceId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Device ID (required if no user_id)"},"eventType":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the event (e.g., \\"page_view\\", \\"purchase\\")"},"eventProperties":{"type":"string","required":false,"visibility":"user-or-llm","description":"JSON object of custom event properties"},"userProperties":{"type":"string","required":false,"visibility":"user-or-llm","description":"JSON object of user properties to set (supports $set, $setOnce, $add, $append, $unset)"},"time":{"type":"string","required":false,"visibility":"user-or-llm","description":"Event timestamp in milliseconds since epoch"},"sessionId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Session start time in milliseconds since epoch"},"insertId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Unique ID for deduplication (within 7-day window)"},"appVersion":{"type":"string","required":false,"visibility":"user-or-llm","description":"Application version string"},"platform":{"type":"string","required":false,"visibility":"user-or-llm","description":"Platform (e.g., \\"Web\\", \\"iOS\\", \\"Android\\")"},"country":{"type":"string","required":false,"visibility":"user-or-llm","description":"Two-letter country code"},"language":{"type":"string","required":false,"visibility":"user-or-llm","description":"Language code (e.g., \\"en\\")"},"ip":{"type":"string","required":false,"visibility":"user-or-llm","description":"IP address for geo-location"},"price":{"type":"string","required":false,"visibility":"user-or-llm","description":"Price of the item purchased"},"quantity":{"type":"string","required":false,"visibility":"user-or-llm","description":"Quantity of items purchased"},"revenue":{"type":"string","required":false,"visibility":"user-or-llm","description":"Revenue amount"},"productId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Product identifier"},"revenueType":{"type":"string","required":false,"visibility":"user-or-llm","description":"Revenue type (e.g., \\"purchase\\", \\"refund\\")"},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"amplitude_user_activity":{"id":"amplitude_user_activity","name":"Amplitude User Activity","description":"Get the event stream for a specific user by their Amplitude ID.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"secretKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude Secret Key"},"amplitudeId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Amplitude internal user ID"},"offset":{"type":"string","required":false,"visibility":"user-or-llm","description":"Offset for pagination (default 0)"},"limit":{"type":"string","required":false,"visibility":"user-or-llm","description":"Maximum number of events to return (default 1000, max 1000)"},"direction":{"type":"string","required":false,"visibility":"user-or-llm","description":"Sort direction: \\"latest\\" or \\"earliest\\" (default: latest)"},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"amplitude_user_profile":{"id":"amplitude_user_profile","name":"Amplitude User Profile","description":"Get a user profile including properties, cohort memberships, and computed properties. Not available for EU data-residency projects.","version":"1.0.0","params":{"secretKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude Secret Key"},"userId":{"type":"string","required":false,"visibility":"user-or-llm","description":"External user ID (required if no device_id)"},"deviceId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Device ID (required if no user_id)"},"getAmpProps":{"type":"string","required":false,"visibility":"user-or-llm","description":"Include Amplitude user properties (true/false, default: false)"},"getCohortIds":{"type":"string","required":false,"visibility":"user-or-llm","description":"Include cohort IDs the user belongs to (true/false, default: false)"},"getComputations":{"type":"string","required":false,"visibility":"user-or-llm","description":"Include computed user properties (true/false, default: false)"}}},"amplitude_user_search":{"id":"amplitude_user_search","name":"Amplitude User Search","description":"Search for a user by User ID, Device ID, or Amplitude ID using the Dashboard REST API.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude API Key"},"secretKey":{"type":"string","required":true,"visibility":"user-only","description":"Amplitude Secret Key"},"user":{"type":"string","required":true,"visibility":"user-or-llm","description":"User ID, Device ID, or Amplitude ID to search for"},"dataResidency":{"type":"string","required":false,"visibility":"user-or-llm","description":"Data residency region: \\"us\\" (default) or \\"eu\\""}}},"apify_get_dataset_items":{"id":"apify_get_dataset_items","name":"APIFY Get Dataset Items","description":"Retrieve items stored in an APIFY dataset","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"APIFY API token from console.apify.com/account#/integrations"},"datasetId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Dataset ID to read items from. Example: \\"9RnD3Pql2vGZkc5H5\\""},"itemLimit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Max items to return (1-250000). Default: all items. Example: 500"},"offset":{"type":"number","required":false,"visibility":"user-or-llm","description":"Number of items to skip at the start. Default: 0"},"fields":{"type":"string","required":false,"visibility":"user-or-llm","description":"Comma-separated list of fields to include. Example: \\"title,url,price\\""}}},"apify_get_run":{"id":"apify_get_run","name":"APIFY Get Run","description":"Get the status and details of an APIFY actor run","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"APIFY API token from console.apify.com/account#/integrations"},"runId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Actor run ID to fetch. Example: \\"HG7ML7M8z78YcAPEB\\""}}},"apify_run_actor_async":{"id":"apify_run_actor_async","name":"APIFY Run Actor (Async)","description":"Run an APIFY actor asynchronously with polling for long-running tasks","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"APIFY API token from console.apify.com/account#/integrations"},"actorId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Actor ID or username/actor-name. Examples: \\"apify/web-scraper\\", \\"janedoe/my-actor\\", \\"moJRLRc85AitArpNN\\""},"input":{"type":"string","required":false,"visibility":"user-or-llm","description":"Actor input as JSON string. Example: {\\"startUrls\\": [{\\"url\\": \\"https://example.com\\"}], \\"maxPages\\": 10}"},"waitForFinish":{"type":"number","required":false,"visibility":"user-or-llm","description":"Initial wait time in seconds (0-60) before polling starts. Example: 30"},"itemLimit":{"type":"number","required":false,"default":100,"visibility":"user-or-llm","description":"Max dataset items to fetch (1-250000). Default: 100. Example: 500"},"memory":{"type":"number","required":false,"visibility":"user-or-llm","description":"Memory in megabytes allocated for the actor run (128-32768). Example: 1024 for 1GB, 2048 for 2GB"},"timeout":{"type":"number","required":false,"visibility":"user-or-llm","description":"Timeout in seconds for the actor run. Example: 300 for 5 minutes, 3600 for 1 hour"},"build":{"type":"string","required":false,"visibility":"user-or-llm","description":"Actor build to run. Examples: \\"latest\\", \\"beta\\", \\"1.2.3\\", \\"build-tag-name\\""}}},"apify_run_actor_sync":{"id":"apify_run_actor_sync","name":"APIFY Run Actor (Sync)","description":"Run an APIFY actor synchronously and get results (max 5 minutes)","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"APIFY API token from console.apify.com/account#/integrations"},"actorId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Actor ID or username/actor-name. Examples: \\"apify/web-scraper\\", \\"janedoe/my-actor\\", \\"moJRLRc85AitArpNN\\""},"input":{"type":"string","required":false,"visibility":"user-or-llm","description":"Actor input as JSON string. Example: {\\"startUrls\\": [{\\"url\\": \\"https://example.com\\"}], \\"maxPages\\": 10}"},"memory":{"type":"number","required":false,"visibility":"user-or-llm","description":"Memory in megabytes allocated for the actor run (128-32768). Example: 1024 for 1GB, 2048 for 2GB"},"timeout":{"type":"number","required":false,"visibility":"user-or-llm","description":"Timeout in seconds for the actor run. Example: 300 for 5 minutes, 3600 for 1 hour"},"build":{"type":"string","required":false,"visibility":"user-or-llm","description":"Actor build to run. Examples: \\"latest\\", \\"beta\\", \\"1.2.3\\", \\"build-tag-name\\""}}},"apify_run_task":{"id":"apify_run_task","name":"APIFY Run Task","description":"Run a saved APIFY actor task synchronously and get dataset items (max 5 minutes)","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"APIFY API token from console.apify.com/account#/integrations"},"taskId":{"type":"string","required":true,"visibility":"user-or-llm","description":"Task ID or username/task-name. Examples: \\"janedoe/my-task\\", \\"moJRLRc85AitArpNN\\""},"input":{"type":"string","required":false,"visibility":"user-or-llm","description":"JSON string that overrides the task\'s saved input. Example: {\\"startUrls\\": [{\\"url\\": \\"https://example.com\\"}]}"},"itemLimit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Max dataset items to return (1-250000). Example: 500"},"memory":{"type":"number","required":false,"visibility":"user-or-llm","description":"Memory in megabytes allocated for the run (128-32768). Example: 1024 for 1GB"},"timeout":{"type":"number","required":false,"visibility":"user-or-llm","description":"Timeout in seconds for the run. Example: 300 for 5 minutes"},"build":{"type":"string","required":false,"visibility":"user-or-llm","description":"Actor build to run. Examples: \\"latest\\", \\"beta\\", \\"1.2.3\\""}}},"apollo_account_bulk_create":{"id":"apollo_account_bulk_create","name":"Apollo Bulk Create Accounts","description":"Create up to 100 accounts at once in your Apollo database. Set run_dedupe=true to deduplicate by domain, organization_id, and name. Master key required.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"},"accounts":{"type":"array","required":true,"visibility":"user-or-llm","description":"Array of accounts to create (max 100). Each account should include a name, and may optionally include domain, phone, phone_status_cd, raw_address, owner_id, linkedin_url, facebook_url, twitter_url, salesforce_id, and hubspot_id."},"append_label_names":{"type":"array","required":false,"visibility":"user-only","description":"Array of label names to add to ALL accounts in this request"},"run_dedupe":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"When true, performs aggressive deduplication by domain, organization_id, and name (defaults to false)"}}},"apollo_account_bulk_update":{"id":"apollo_account_bulk_update","name":"Apollo Bulk Update Accounts","description":"Update up to 1000 existing accounts at once in your Apollo database (higher limit than contacts!). Each account must include an id field. Master key required.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"},"account_ids":{"type":"array","required":false,"visibility":"user-or-llm","description":"Array of account IDs to update with the same values (max 1000). Use with name/owner_id for uniform updates. Use either this OR account_attributes."},"name":{"type":"string","required":false,"visibility":"user-or-llm","description":"When using account_ids, apply this name to all accounts"},"owner_id":{"type":"string","required":false,"visibility":"user-or-llm","description":"When using account_ids, apply this owner to all accounts"},"account_stage_id":{"type":"string","required":false,"visibility":"user-or-llm","description":"When using account_ids, apply this account stage to all accounts"},"account_attributes":{"type":"json","required":false,"visibility":"user-or-llm","description":"Array of account objects with individual updates (each must include id). Example: [{\\"id\\": \\"acc1\\", \\"name\\": \\"Acme\\", \\"owner_id\\": \\"u1\\", \\"account_stage_id\\": \\"s1\\", \\"typed_custom_fields\\": {\\"field_id\\": \\"value\\"}}]"},"async":{"type":"boolean","required":false,"visibility":"user-only","description":"When true, processes the update asynchronously. Only supported when using account_ids; returns 422 if used with account_attributes."}}},"apollo_account_create":{"id":"apollo_account_create","name":"Apollo Create Account","description":"Create a new account (company) in your Apollo database","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"},"name":{"type":"string","required":true,"visibility":"user-or-llm","description":"Company name (e.g., \\"Acme Corporation\\")"},"domain":{"type":"string","required":false,"visibility":"user-or-llm","description":"Company domain without www. prefix (e.g., \\"acme.com\\")"},"phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Primary phone number for the account"},"owner_id":{"type":"string","required":false,"visibility":"user-only","description":"Apollo user ID of the account owner"},"account_stage_id":{"type":"string","required":false,"visibility":"user-only","description":"Apollo ID for the account stage to assign this account to"},"raw_address":{"type":"string","required":false,"visibility":"user-or-llm","description":"Corporate location (e.g., \\"San Francisco, CA, USA\\")"},"typed_custom_fields":{"type":"json","required":false,"visibility":"user-only","description":"Custom field values as { custom_field_id: value } map"}}},"apollo_account_search":{"id":"apollo_account_search","name":"Apollo Search Accounts","description":"Search your team\'s accounts in Apollo. Display limit: 50,000 records (100 records per page, 500 pages max). Use filters to narrow results. Master key required.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"},"q_organization_name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Filter accounts by organization name (partial-match search)"},"account_stage_ids":{"type":"array","required":false,"visibility":"user-only","description":"Filter by account stage IDs"},"account_label_ids":{"type":"array","required":false,"visibility":"user-only","description":"Filter by account label IDs"},"sort_by_field":{"type":"string","required":false,"visibility":"user-or-llm","description":"Sort field: \\"account_last_activity_date\\", \\"account_created_at\\", or \\"account_updated_at\\""},"sort_ascending":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Sort ascending when true. Defaults to descending."},"page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Page number for pagination (e.g., 1, 2, 3)"},"per_page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Results per page, max 100 (e.g., 25, 50, 100)"}}},"apollo_account_update":{"id":"apollo_account_update","name":"Apollo Update Account","description":"Update an existing account in your Apollo database","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"account_id":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the account to update (e.g., \\"acc_abc123\\")"},"name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Company name (e.g., \\"Acme Corporation\\")"},"domain":{"type":"string","required":false,"visibility":"user-or-llm","description":"Company domain (e.g., \\"acme.com\\")"},"phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Company phone number"},"owner_id":{"type":"string","required":false,"visibility":"user-only","description":"Apollo user ID of the account owner"},"account_stage_id":{"type":"string","required":false,"visibility":"user-only","description":"Apollo ID for the account stage to assign this account to"},"raw_address":{"type":"string","required":false,"visibility":"user-or-llm","description":"Corporate location (e.g., \\"San Francisco, CA, USA\\")"},"typed_custom_fields":{"type":"json","required":false,"visibility":"user-only","description":"Custom field values as { custom_field_id: value } map"}}},"apollo_contact_bulk_create":{"id":"apollo_contact_bulk_create","name":"Apollo Bulk Create Contacts","description":"Create up to 100 contacts at once in your Apollo database. Supports deduplication to prevent creating duplicate contacts. Master key required.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"},"contacts":{"type":"array","required":true,"visibility":"user-or-llm","description":"Array of contacts to create (max 100). Each contact may include first_name, last_name, email, title, organization_name, account_id, owner_id, contact_stage_id, linkedin_url, phone (single string) or phone_numbers (array of {raw_number, position}), contact_emails, typed_custom_fields, and CRM IDs (salesforce_contact_id, hubspot_id, team_id) for cross-system matching"},"append_label_names":{"type":"array","required":false,"visibility":"user-or-llm","description":"Label names to add to all contacts in this request (e.g., [\\"Hot Lead\\"])"},"run_dedupe":{"type":"boolean","required":false,"visibility":"user-only","description":"Enable deduplication to prevent creating duplicate contacts. When true, existing contacts are returned without modification"}}},"apollo_contact_bulk_update":{"id":"apollo_contact_bulk_update","name":"Apollo Bulk Update Contacts","description":"Update up to 100 existing contacts at once in your Apollo database. Each contact must include an id field. Master key required.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"},"contact_ids":{"type":"array","required":false,"visibility":"user-or-llm","description":"Array of contact IDs to update. Must be paired with an object-form contact_attributes specifying the fields to apply uniformly to all listed contacts."},"contact_attributes":{"type":"json","required":false,"visibility":"user-or-llm","description":"Required. Either an array of per-contact updates (each with id) — used standalone — or a single object of attributes to apply to all contact_ids. Supported fields: owner_id, email, organization_name, title, first_name, last_name, account_id, present_raw_address, linkedin_url, typed_custom_fields"},"async":{"type":"boolean","required":false,"visibility":"user-only","description":"Force asynchronous processing. Automatically enabled for >100 contacts"}}},"apollo_contact_create":{"id":"apollo_contact_create","name":"Apollo Create Contact","description":"Create a new contact in your Apollo database","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"first_name":{"type":"string","required":true,"visibility":"user-or-llm","description":"First name of the contact"},"last_name":{"type":"string","required":true,"visibility":"user-or-llm","description":"Last name of the contact"},"email":{"type":"string","required":false,"visibility":"user-or-llm","description":"Email address of the contact"},"title":{"type":"string","required":false,"visibility":"user-or-llm","description":"Job title (e.g., \\"VP of Sales\\", \\"Software Engineer\\")"},"account_id":{"type":"string","required":false,"visibility":"user-or-llm","description":"Apollo account ID to associate with (e.g., \\"acc_abc123\\")"},"owner_id":{"type":"string","required":false,"visibility":"user-only","description":"User ID of the contact owner (accepted by Apollo but not officially documented for POST /contacts)"},"organization_name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Name of the contact\'s employer (e.g., \\"Apollo\\")"},"website_url":{"type":"string","required":false,"visibility":"user-or-llm","description":"Corporate website URL (e.g., \\"https://www.apollo.io/\\")"},"label_names":{"type":"array","required":false,"visibility":"user-or-llm","description":"Lists/labels to add the contact to (e.g., [\\"Prospects\\"])"},"contact_stage_id":{"type":"string","required":false,"visibility":"user-or-llm","description":"Apollo ID for the contact stage"},"present_raw_address":{"type":"string","required":false,"visibility":"user-or-llm","description":"Personal location for the contact (e.g., \\"Atlanta, United States\\")"},"direct_phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Primary phone number"},"corporate_phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Work/office phone number"},"mobile_phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Mobile phone number"},"home_phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Home phone number"},"other_phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Alternative phone number"},"typed_custom_fields":{"type":"json","required":false,"visibility":"user-or-llm","description":"Custom field values keyed by custom field ID"},"run_dedupe":{"type":"boolean","required":false,"visibility":"user-only","description":"When true, Apollo deduplicates against existing contacts"}}},"apollo_contact_search":{"id":"apollo_contact_search","name":"Apollo Search Contacts","description":"Search your team\'s contacts in Apollo","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"q_keywords":{"type":"string","required":false,"visibility":"user-or-llm","description":"Keywords to search for"},"contact_stage_ids":{"type":"array","required":false,"visibility":"user-only","description":"Filter by contact stage IDs"},"contact_label_ids":{"type":"array","required":false,"visibility":"user-only","description":"Filter by Apollo label IDs (lists)"},"sort_by_field":{"type":"string","required":false,"visibility":"user-only","description":"Sort field: contact_last_activity_date, contact_email_last_opened_at, contact_email_last_clicked_at, contact_created_at, or contact_updated_at"},"sort_ascending":{"type":"boolean","required":false,"visibility":"user-only","description":"When true, sort ascending. Must be used together with sort_by_field"},"page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Page number for pagination (e.g., 1, 2, 3)"},"per_page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Results per page, max 100 (e.g., 25, 50, 100)"}}},"apollo_contact_update":{"id":"apollo_contact_update","name":"Apollo Update Contact","description":"Update an existing contact in your Apollo database","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"contact_id":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the contact to update (e.g., \\"con_abc123\\")"},"first_name":{"type":"string","required":false,"visibility":"user-or-llm","description":"First name of the contact"},"last_name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Last name of the contact"},"email":{"type":"string","required":false,"visibility":"user-or-llm","description":"Email address"},"title":{"type":"string","required":false,"visibility":"user-or-llm","description":"Job title (e.g., \\"VP of Sales\\", \\"Software Engineer\\")"},"account_id":{"type":"string","required":false,"visibility":"user-or-llm","description":"Apollo account ID (e.g., \\"acc_abc123\\")"},"owner_id":{"type":"string","required":false,"visibility":"user-only","description":"User ID of the contact owner (accepted by Apollo but not officially documented for PATCH /contacts/{id})"},"organization_name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Name of the contact\'s employer (e.g., \\"Apollo\\")"},"website_url":{"type":"string","required":false,"visibility":"user-or-llm","description":"Corporate website URL (e.g., \\"https://www.apollo.io/\\")"},"label_names":{"type":"array","required":false,"visibility":"user-or-llm","description":"Lists/labels to add the contact to (e.g., [\\"Prospects\\"])"},"contact_stage_id":{"type":"string","required":false,"visibility":"user-or-llm","description":"Apollo ID for the contact stage"},"present_raw_address":{"type":"string","required":false,"visibility":"user-or-llm","description":"Personal location for the contact (e.g., \\"Atlanta, United States\\")"},"direct_phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Primary phone number"},"corporate_phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Work/office phone number"},"mobile_phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Mobile phone number"},"home_phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Home phone number"},"other_phone":{"type":"string","required":false,"visibility":"user-or-llm","description":"Alternative phone number"},"typed_custom_fields":{"type":"json","required":false,"visibility":"user-or-llm","description":"Custom field values keyed by custom field ID"}}},"apollo_email_accounts":{"id":"apollo_email_accounts","name":"Apollo Get Email Accounts","description":"Get list of team\'s linked email accounts in Apollo","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"}}},"apollo_opportunity_create":{"id":"apollo_opportunity_create","name":"Apollo Create Opportunity","description":"Create a new deal for an account in your Apollo database (master key required)","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"},"name":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the opportunity/deal (e.g., \\"Enterprise License - Q1\\")"},"account_id":{"type":"string","required":false,"visibility":"user-or-llm","description":"ID of the account this opportunity belongs to (e.g., \\"acc_abc123\\")"},"amount":{"type":"string","required":false,"visibility":"user-or-llm","description":"Monetary value as a plain number string with no commas or currency symbols"},"opportunity_stage_id":{"type":"string","required":false,"visibility":"user-only","description":"ID of the opportunity stage"},"owner_id":{"type":"string","required":false,"visibility":"user-only","description":"User ID of the opportunity owner"},"closed_date":{"type":"string","required":false,"visibility":"user-or-llm","description":"Expected close date in YYYY-MM-DD format"},"typed_custom_fields":{"type":"json","required":false,"visibility":"user-only","description":"Custom field values as { custom_field_id: value } map"}}},"apollo_opportunity_get":{"id":"apollo_opportunity_get","name":"Apollo Get Opportunity","description":"Retrieve complete details of a specific deal/opportunity by ID","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"opportunity_id":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the opportunity to retrieve (e.g., \\"opp_abc123\\")"}}},"apollo_opportunity_search":{"id":"apollo_opportunity_search","name":"Apollo Search Opportunities","description":"Search and list all deals/opportunities in your team\'s Apollo account","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"sort_by_field":{"type":"string","required":false,"visibility":"user-or-llm","description":"Sort field: \\"amount\\", \\"is_closed\\", or \\"is_won\\""},"page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Page number for pagination (e.g., 1, 2, 3)"},"per_page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Results per page, max 100 (e.g., 25, 50, 100)"}}},"apollo_opportunity_update":{"id":"apollo_opportunity_update","name":"Apollo Update Opportunity","description":"Update an existing deal/opportunity in your Apollo database","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"opportunity_id":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the opportunity to update (e.g., \\"opp_abc123\\")"},"name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Name of the opportunity/deal (e.g., \\"Enterprise License - Q1\\")"},"amount":{"type":"string","required":false,"visibility":"user-or-llm","description":"Monetary value as a plain number string with no commas or currency symbols"},"opportunity_stage_id":{"type":"string","required":false,"visibility":"user-only","description":"ID of the opportunity stage"},"owner_id":{"type":"string","required":false,"visibility":"user-only","description":"User ID of the opportunity owner"},"closed_date":{"type":"string","required":false,"visibility":"user-or-llm","description":"Expected close date in YYYY-MM-DD format"},"typed_custom_fields":{"type":"json","required":false,"visibility":"user-only","description":"Custom field values as { custom_field_id: value } map"}}},"apollo_organization_bulk_enrich":{"id":"apollo_organization_bulk_enrich","name":"Apollo Bulk Organization Enrichment","description":"Enrich data for up to 10 organizations at once using Apollo","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"domains":{"type":"array","required":true,"visibility":"user-or-llm","description":"Array of company domains to enrich (max 10, no www. or @, e.g., [\\"apollo.io\\", \\"stripe.com\\"])"}}},"apollo_organization_enrich":{"id":"apollo_organization_enrich","name":"Apollo Organization Enrichment","description":"Enrich data for a single organization using Apollo","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"domain":{"type":"string","required":true,"visibility":"user-or-llm","description":"Company domain (e.g., \\"apollo.io\\", \\"acme.com\\")"}}},"apollo_organization_search":{"id":"apollo_organization_search","name":"Apollo Organization Search","description":"Search Apollo\'s database for companies using filters","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"organization_locations":{"type":"array","required":false,"visibility":"user-or-llm","description":"Company HQ locations (cities, US states, or countries)"},"organization_not_locations":{"type":"array","required":false,"visibility":"user-or-llm","description":"Exclude companies whose HQ is in these locations"},"organization_num_employees_ranges":{"type":"array","required":false,"visibility":"user-or-llm","description":"Employee count ranges as \\"min,max\\" strings (e.g., [\\"1,10\\", \\"250,500\\", \\"10000,20000\\"])"},"q_organization_keyword_tags":{"type":"array","required":false,"visibility":"user-or-llm","description":"Industry or keyword tags"},"q_organization_name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Organization name to search for (e.g., \\"Acme\\", \\"TechCorp\\")"},"organization_ids":{"type":"array","required":false,"visibility":"user-or-llm","description":"Apollo organization IDs to include (e.g., [\\"5e66b6381e05b4008c8331b8\\"])"},"q_organization_domains_list":{"type":"array","required":false,"visibility":"user-or-llm","description":"Domain names to filter by (no www. or @, up to 1,000)"},"page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Page number for pagination (e.g., 1, 2, 3)"},"per_page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Results per page, max 100 (e.g., 25, 50, 100)"}}},"apollo_people_bulk_enrich":{"id":"apollo_people_bulk_enrich","name":"Apollo Bulk People Enrichment","description":"Enrich data for up to 10 people at once using Apollo","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"people":{"type":"array","required":true,"visibility":"user-or-llm","description":"Array of people to enrich (max 10)"},"reveal_personal_emails":{"type":"boolean","required":false,"visibility":"user-only","description":"Reveal personal email addresses (uses credits)"},"reveal_phone_number":{"type":"boolean","required":false,"visibility":"user-only","description":"Reveal phone numbers (uses credits, requires webhook_url)"},"webhook_url":{"type":"string","required":false,"visibility":"user-only","description":"Webhook URL for async phone number delivery (required when reveal_phone_number is true)"}}},"apollo_people_enrich":{"id":"apollo_people_enrich","name":"Apollo People Enrichment","description":"Enrich data for a single person using Apollo","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"first_name":{"type":"string","required":false,"visibility":"user-or-llm","description":"First name of the person"},"last_name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Last name of the person"},"name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Full name of the person (alternative to first_name/last_name)"},"id":{"type":"string","required":false,"visibility":"user-or-llm","description":"Apollo ID for the person"},"hashed_email":{"type":"string","required":false,"visibility":"user-or-llm","description":"MD5 or SHA-256 hashed email"},"email":{"type":"string","required":false,"visibility":"user-or-llm","description":"Email address of the person"},"organization_name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Company name where the person works"},"domain":{"type":"string","required":false,"visibility":"user-or-llm","description":"Company domain (e.g., \\"apollo.io\\", \\"acme.com\\")"},"linkedin_url":{"type":"string","required":false,"visibility":"user-or-llm","description":"LinkedIn profile URL"},"reveal_personal_emails":{"type":"boolean","required":false,"visibility":"user-only","description":"Reveal personal email addresses (uses credits)"},"reveal_phone_number":{"type":"boolean","required":false,"visibility":"user-only","description":"Reveal phone numbers (uses credits, requires webhook_url)"},"webhook_url":{"type":"string","required":false,"visibility":"user-only","description":"Webhook URL for async phone number delivery (required when reveal_phone_number is true)"}}},"apollo_people_search":{"id":"apollo_people_search","name":"Apollo People Search","description":"Search Apollo\'s database for people using demographic filters","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key"},"person_titles":{"type":"array","required":false,"visibility":"user-or-llm","description":"Job titles to search for (e.g., [\\"CEO\\", \\"VP of Sales\\"])"},"include_similar_titles":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Whether to return people with job titles similar to person_titles"},"person_locations":{"type":"array","required":false,"visibility":"user-or-llm","description":"Locations to search in (e.g., [\\"San Francisco, CA\\", \\"New York, NY\\"])"},"person_seniorities":{"type":"array","required":false,"visibility":"user-or-llm","description":"Seniority levels (one of: owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern)"},"organization_ids":{"type":"array","required":false,"visibility":"user-or-llm","description":"Apollo organization IDs to filter by (e.g., [\\"5e66b6381e05b4008c8331b8\\"])"},"organization_names":{"type":"array","required":false,"visibility":"user-or-llm","description":"Company names to search within (legacy filter)"},"organization_locations":{"type":"array","required":false,"visibility":"user-or-llm","description":"Headquarters locations of the people\'s current employer (e.g., [\'texas\', \'tokyo\', \'spain\'])"},"q_organization_domains_list":{"type":"array","required":false,"visibility":"user-or-llm","description":"Employer domain names (e.g., [\\"apollo.io\\", \\"microsoft.com\\"]) — up to 1,000, no www. or @"},"organization_num_employees_ranges":{"type":"array","required":false,"visibility":"user-or-llm","description":"Employee count ranges for the person\'s current employer. Each entry is \\"min,max\\" (e.g., [\\"1,10\\", \\"250,500\\", \\"10000,20000\\"])"},"contact_email_status":{"type":"array","required":false,"visibility":"user-or-llm","description":"Email statuses to filter by: \\"verified\\", \\"unverified\\", \\"likely to engage\\", \\"unavailable\\""},"q_keywords":{"type":"string","required":false,"visibility":"user-or-llm","description":"Keywords to search for"},"page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Page number for pagination, default 1 (e.g., 1, 2, 3)"},"per_page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Results per page, default 25, max 100 (e.g., 25, 50, 100)"}}},"apollo_sequence_add_contacts":{"id":"apollo_sequence_add_contacts","name":"Apollo Add Contacts to Sequence","description":"Add contacts to an Apollo sequence","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"},"sequence_id":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the sequence to add contacts to (e.g., \\"seq_abc123\\")"},"contact_ids":{"type":"array","required":false,"visibility":"user-or-llm","description":"Array of contact IDs to add to the sequence (e.g., [\\"con_abc123\\", \\"con_def456\\"]). Either contact_ids or label_names must be provided."},"label_names":{"type":"array","required":false,"visibility":"user-or-llm","description":"Array of label names to identify contacts to add to the sequence. Either contact_ids or label_names must be provided."},"send_email_from_email_account_id":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the email account to send from. Use the Get Email Accounts operation to look this up."},"send_email_from_email_address":{"type":"string","required":false,"visibility":"user-only","description":"Specific email address to send from within the email account."},"sequence_no_email":{"type":"boolean","required":false,"visibility":"user-only","description":"Add contacts even if they have no email address"},"sequence_unverified_email":{"type":"boolean","required":false,"visibility":"user-only","description":"Add contacts with unverified email addresses"},"sequence_job_change":{"type":"boolean","required":false,"visibility":"user-only","description":"Add contacts who recently changed jobs"},"sequence_active_in_other_campaigns":{"type":"boolean","required":false,"visibility":"user-only","description":"Add contacts active in other campaigns"},"sequence_finished_in_other_campaigns":{"type":"boolean","required":false,"visibility":"user-only","description":"Add contacts who finished other campaigns"},"sequence_same_company_in_same_campaign":{"type":"boolean","required":false,"visibility":"user-only","description":"Add contacts even if others from the same company are in the sequence"},"contacts_without_ownership_permission":{"type":"boolean","required":false,"visibility":"user-only","description":"Add contacts without ownership permission"},"add_if_in_queue":{"type":"boolean","required":false,"visibility":"user-only","description":"Add contacts even if they are in the queue"},"contact_verification_skipped":{"type":"boolean","required":false,"visibility":"user-only","description":"Skip contact verification when adding"},"user_id":{"type":"string","required":false,"visibility":"user-only","description":"ID of the user performing the action"},"status":{"type":"string","required":false,"visibility":"user-only","description":"Initial status for added contacts: \\"active\\" or \\"paused\\""},"auto_unpause_at":{"type":"string","required":false,"visibility":"user-only","description":"ISO 8601 datetime to automatically unpause contacts"}}},"apollo_sequence_search":{"id":"apollo_sequence_search","name":"Apollo Search Sequences","description":"Search for sequences/campaigns in your team\'s Apollo account (master key required)","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"},"q_name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Search sequences by name (e.g., \\"Outbound Q1\\", \\"Follow-up\\")"},"page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Page number for pagination (e.g., 1, 2, 3)"},"per_page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Results per page, max 100 (e.g., 25, 50, 100)"}}},"apollo_task_create":{"id":"apollo_task_create","name":"Apollo Create Task","description":"Create one or more tasks in Apollo (one task per contact_id, master key required)","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"},"user_id":{"type":"string","required":true,"visibility":"user-or-llm","description":"ID of the Apollo user the task is assigned to"},"contact_ids":{"type":"array","required":true,"visibility":"user-or-llm","description":"Array of contact IDs. One task is created per contact."},"priority":{"type":"string","required":false,"visibility":"user-or-llm","description":"Task priority: \\"high\\", \\"medium\\", or \\"low\\" (defaults to \\"medium\\")"},"due_at":{"type":"string","required":true,"visibility":"user-or-llm","description":"Due date/time in ISO 8601 format (e.g., \\"2024-12-31T23:59:59Z\\")"},"type":{"type":"string","required":true,"visibility":"user-or-llm","description":"Task type: \\"call\\", \\"outreach_manual_email\\", \\"linkedin_step_connect\\", \\"linkedin_step_message\\", \\"linkedin_step_view_profile\\", \\"linkedin_step_interact_post\\", or \\"action_item\\""},"status":{"type":"string","required":true,"visibility":"user-or-llm","description":"Task status: \\"scheduled\\", \\"completed\\", or \\"skipped\\""},"note":{"type":"string","required":false,"visibility":"user-or-llm","description":"Free-form note providing context for the task"}}},"apollo_task_search":{"id":"apollo_task_search","name":"Apollo Search Tasks","description":"Search for tasks in Apollo","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Apollo API key (master key required)"},"sort_by_field":{"type":"string","required":false,"visibility":"user-or-llm","description":"Sort field: \\"task_due_at\\" or \\"task_priority\\""},"open_factor_names":{"type":"array","required":false,"visibility":"user-or-llm","description":"Filter by status. Common values: [\\"task_types\\"] for open tasks, [\\"task_completed_at\\"] for completed tasks."},"page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Page number for pagination (e.g., 1, 2, 3)"},"per_page":{"type":"number","required":false,"visibility":"user-or-llm","description":"Results per page, max 100 (e.g., 25, 50, 100)"}}},"appconfig_create_application":{"id":"appconfig_create_application","name":"AppConfig Create Application","description":"Create an application in AWS AppConfig","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"name":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the application to create"},"description":{"type":"string","required":false,"visibility":"user-or-llm","description":"Description of the application"}}},"appconfig_create_configuration_profile":{"id":"appconfig_create_configuration_profile","name":"AppConfig Create Configuration Profile","description":"Create a configuration profile in an AWS AppConfig application","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID to create the configuration profile in"},"name":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the configuration profile"},"locationUri":{"type":"string","required":true,"visibility":"user-or-llm","description":"Where the configuration is stored. Use \\"hosted\\" for AppConfig-hosted configurations, or an SSM/S3 URI"},"description":{"type":"string","required":false,"visibility":"user-or-llm","description":"Description of the configuration profile"},"retrievalRoleArn":{"type":"string","required":false,"visibility":"user-or-llm","description":"ARN of an IAM role to retrieve the configuration (required for non-hosted URIs)"},"type":{"type":"string","required":false,"visibility":"user-or-llm","description":"Profile type: AWS.Freeform (default) or AWS.AppConfig.FeatureFlags"}}},"appconfig_create_environment":{"id":"appconfig_create_environment","name":"AppConfig Create Environment","description":"Create an environment for an AWS AppConfig application","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID to create the environment in"},"name":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the environment to create"},"description":{"type":"string","required":false,"visibility":"user-or-llm","description":"Description of the environment"}}},"appconfig_create_hosted_configuration_version":{"id":"appconfig_create_hosted_configuration_version","name":"AppConfig Create Hosted Configuration Version","description":"Create a new hosted configuration version for an AppConfig configuration profile","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the configuration profile"},"configurationProfileId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The configuration profile ID to add the version to"},"content":{"type":"string","required":true,"visibility":"user-or-llm","description":"The configuration content (e.g., a JSON or YAML document)"},"contentType":{"type":"string","required":true,"visibility":"user-or-llm","description":"Content type of the configuration (e.g., application/json, text/plain)"},"description":{"type":"string","required":false,"visibility":"user-or-llm","description":"Description of the configuration version"},"latestVersionNumber":{"type":"number","required":false,"visibility":"user-or-llm","description":"The version number of the latest version, used for optimistic concurrency"},"versionLabel":{"type":"string","required":false,"visibility":"user-or-llm","description":"A user-defined label for the configuration version"}}},"appconfig_delete_application":{"id":"appconfig_delete_application","name":"AppConfig Delete Application","description":"Delete an AWS AppConfig application","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID to delete"}}},"appconfig_delete_configuration_profile":{"id":"appconfig_delete_configuration_profile","name":"AppConfig Delete Configuration Profile","description":"Delete an AWS AppConfig configuration profile","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the configuration profile"},"configurationProfileId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The configuration profile ID to delete"}}},"appconfig_delete_environment":{"id":"appconfig_delete_environment","name":"AppConfig Delete Environment","description":"Delete an AWS AppConfig environment","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the environment"},"environmentId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The environment ID to delete"}}},"appconfig_delete_hosted_configuration_version":{"id":"appconfig_delete_hosted_configuration_version","name":"AppConfig Delete Hosted Configuration Version","description":"Delete a specific hosted configuration version from an AppConfig profile","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the configuration profile"},"configurationProfileId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The configuration profile ID that owns the version"},"versionNumber":{"type":"number","required":true,"visibility":"user-or-llm","description":"The version number to delete"}}},"appconfig_get_application":{"id":"appconfig_get_application","name":"AppConfig Get Application","description":"Get details about a single AWS AppConfig application","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID to retrieve"}}},"appconfig_get_configuration":{"id":"appconfig_get_configuration","name":"AppConfig Get Configuration","description":"Retrieve the latest deployed configuration for an AppConfig application, environment, and profile","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID or name to retrieve configuration for"},"environmentId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The environment ID or name to retrieve configuration for"},"configurationProfileId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The configuration profile ID or name to retrieve"}}},"appconfig_get_configuration_profile":{"id":"appconfig_get_configuration_profile","name":"AppConfig Get Configuration Profile","description":"Get details about a single AWS AppConfig configuration profile","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the configuration profile"},"configurationProfileId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The configuration profile ID to retrieve"}}},"appconfig_get_deployment":{"id":"appconfig_get_deployment","name":"AppConfig Get Deployment","description":"Get details about a specific AWS AppConfig deployment","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID of the deployment"},"environmentId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The environment ID of the deployment"},"deploymentNumber":{"type":"number","required":true,"visibility":"user-or-llm","description":"The sequence number of the deployment"}}},"appconfig_get_environment":{"id":"appconfig_get_environment","name":"AppConfig Get Environment","description":"Get details about a single AWS AppConfig environment","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the environment"},"environmentId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The environment ID to retrieve"}}},"appconfig_get_hosted_configuration_version":{"id":"appconfig_get_hosted_configuration_version","name":"AppConfig Get Hosted Configuration Version","description":"Retrieve a specific hosted configuration version from an AppConfig profile","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the configuration profile"},"configurationProfileId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The configuration profile ID to read the version from"},"versionNumber":{"type":"number","required":true,"visibility":"user-or-llm","description":"The version number to retrieve"}}},"appconfig_list_applications":{"id":"appconfig_list_applications","name":"AppConfig List Applications","description":"List applications in AWS AppConfig","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"maxResults":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of applications to return (1-50)"},"nextToken":{"type":"string","required":false,"visibility":"user-or-llm","description":"Pagination token from a previous response"}}},"appconfig_list_configuration_profiles":{"id":"appconfig_list_configuration_profiles","name":"AppConfig List Configuration Profiles","description":"List configuration profiles for an AWS AppConfig application","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the configuration profiles"},"maxResults":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of configuration profiles to return (1-50)"},"nextToken":{"type":"string","required":false,"visibility":"user-or-llm","description":"Pagination token from a previous response"}}},"appconfig_list_deployment_strategies":{"id":"appconfig_list_deployment_strategies","name":"AppConfig List Deployment Strategies","description":"List deployment strategies available in AWS AppConfig","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"maxResults":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of deployment strategies to return (1-50)"},"nextToken":{"type":"string","required":false,"visibility":"user-or-llm","description":"Pagination token from a previous response"}}},"appconfig_list_deployments":{"id":"appconfig_list_deployments","name":"AppConfig List Deployments","description":"List deployments for an AWS AppConfig environment","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID of the deployments"},"environmentId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The environment ID of the deployments"},"maxResults":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of deployments to return (1-50)"},"nextToken":{"type":"string","required":false,"visibility":"user-or-llm","description":"Pagination token from a previous response"}}},"appconfig_list_environments":{"id":"appconfig_list_environments","name":"AppConfig List Environments","description":"List environments for an AWS AppConfig application","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the environments"},"maxResults":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of environments to return (1-50)"},"nextToken":{"type":"string","required":false,"visibility":"user-or-llm","description":"Pagination token from a previous response"}}},"appconfig_list_hosted_configuration_versions":{"id":"appconfig_list_hosted_configuration_versions","name":"AppConfig List Hosted Configuration Versions","description":"List hosted configuration versions for an AWS AppConfig configuration profile","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the configuration profile"},"configurationProfileId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The configuration profile ID to list versions for"},"maxResults":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of versions to return (1-50)"},"nextToken":{"type":"string","required":false,"visibility":"user-or-llm","description":"Pagination token from a previous response"}}},"appconfig_start_deployment":{"id":"appconfig_start_deployment","name":"AppConfig Start Deployment","description":"Start deploying a configuration version to an AWS AppConfig environment","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID to deploy in"},"environmentId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The environment ID to deploy to"},"deploymentStrategyId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The deployment strategy ID to use"},"configurationProfileId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The configuration profile ID to deploy"},"configurationVersion":{"type":"string","required":true,"visibility":"user-or-llm","description":"The configuration version to deploy"},"description":{"type":"string","required":false,"visibility":"user-or-llm","description":"Description of the deployment"}}},"appconfig_stop_deployment":{"id":"appconfig_stop_deployment","name":"AppConfig Stop Deployment","description":"Stop an in-progress AWS AppConfig deployment","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID of the deployment"},"environmentId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The environment ID of the deployment"},"deploymentNumber":{"type":"number","required":true,"visibility":"user-or-llm","description":"The sequence number of the deployment to stop"}}},"appconfig_update_application":{"id":"appconfig_update_application","name":"AppConfig Update Application","description":"Update the name or description of an AWS AppConfig application","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID to update"},"name":{"type":"string","required":false,"visibility":"user-or-llm","description":"New name for the application"},"description":{"type":"string","required":false,"visibility":"user-or-llm","description":"New description for the application"}}},"appconfig_update_configuration_profile":{"id":"appconfig_update_configuration_profile","name":"AppConfig Update Configuration Profile","description":"Update the name, description, or retrieval role of an AppConfig configuration profile","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the configuration profile"},"configurationProfileId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The configuration profile ID to update"},"name":{"type":"string","required":false,"visibility":"user-or-llm","description":"New name for the configuration profile"},"description":{"type":"string","required":false,"visibility":"user-or-llm","description":"New description for the configuration profile"},"retrievalRoleArn":{"type":"string","required":false,"visibility":"user-or-llm","description":"New ARN of the IAM role used to retrieve the configuration"}}},"appconfig_update_environment":{"id":"appconfig_update_environment","name":"AppConfig Update Environment","description":"Update the name or description of an AWS AppConfig environment","version":"1.0","params":{"region":{"type":"string","required":true,"visibility":"user-only","description":"AWS region (e.g., us-east-1)"},"accessKeyId":{"type":"string","required":true,"visibility":"user-only","description":"AWS access key ID"},"secretAccessKey":{"type":"string","required":true,"visibility":"user-only","description":"AWS secret access key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The application ID that owns the environment"},"environmentId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The environment ID to update"},"name":{"type":"string","required":false,"visibility":"user-or-llm","description":"New name for the environment"},"description":{"type":"string","required":false,"visibility":"user-or-llm","description":"New description for the environment"}}},"arxiv_get_author_papers":{"id":"arxiv_get_author_papers","name":"ArXiv Get Author Papers","description":"Search for papers by a specific author on ArXiv.","version":"1.0.0","params":{"authorName":{"type":"string","required":true,"visibility":"user-or-llm","description":"Author name to search for"},"maxResults":{"type":"number","required":false,"visibility":"user-only","description":"Maximum number of results to return (default: 10, max: 2000)"}}},"arxiv_get_paper":{"id":"arxiv_get_paper","name":"ArXiv Get Paper","description":"Get detailed information about a specific ArXiv paper by its ID.","version":"1.0.0","params":{"paperId":{"type":"string","required":true,"visibility":"user-or-llm","description":"ArXiv paper ID (e.g., \\"1706.03762\\")"}}},"arxiv_search":{"id":"arxiv_search","name":"ArXiv Search","description":"Search for academic papers on ArXiv by keywords, authors, titles, or other fields.","version":"1.0.0","params":{"searchQuery":{"type":"string","required":true,"visibility":"user-or-llm","description":"The search query to execute"},"searchField":{"type":"string","required":false,"visibility":"user-only","description":"Field to search in: all, ti (title), au (author), abs (abstract), co (comment), jr (journal), cat (category), rn (report number)"},"maxResults":{"type":"number","required":false,"visibility":"user-only","description":"Maximum number of results to return (default: 10, max: 2000)"},"sortBy":{"type":"string","required":false,"visibility":"user-only","description":"Sort by: relevance, lastUpdatedDate, submittedDate (default: relevance)"},"sortOrder":{"type":"string","required":false,"visibility":"user-only","description":"Sort order: ascending, descending (default: descending)"}}},"asana_add_comment":{"id":"asana_add_comment","name":"Asana Add Comment","description":"Add a comment (story) to an Asana task","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"taskGid":{"type":"string","required":true,"visibility":"user-or-llm","description":"Asana task GID (numeric string)"},"text":{"type":"string","required":true,"visibility":"user-or-llm","description":"The text content of the comment"}},"oauth":{"required":true,"provider":"asana"}},"asana_add_followers":{"id":"asana_add_followers","name":"Asana Add Followers","description":"Add one or more followers to an Asana task","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"taskGid":{"type":"string","required":true,"visibility":"user-or-llm","description":"GID of the Asana task (numeric string)"},"followers":{"type":"array","required":true,"visibility":"user-or-llm","description":"Array of user GIDs to add as followers to the task"}},"oauth":{"required":true,"provider":"asana"}},"asana_create_project":{"id":"asana_create_project","name":"Asana Create Project","description":"Create a new project in an Asana workspace","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"workspace":{"type":"string","required":true,"visibility":"user-or-llm","description":"Asana workspace GID (numeric string) where the project will be created"},"name":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the project"},"notes":{"type":"string","required":false,"visibility":"user-or-llm","description":"Notes or description for the project"}},"oauth":{"required":true,"provider":"asana"}},"asana_create_section":{"id":"asana_create_section","name":"Asana Create Section","description":"Create a new section in an Asana project","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"projectGid":{"type":"string","required":true,"visibility":"user-or-llm","description":"GID of the Asana project (numeric string) to add the section to"},"name":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the section"}},"oauth":{"required":true,"provider":"asana"}},"asana_create_subtask":{"id":"asana_create_subtask","name":"Asana Create Subtask","description":"Create a subtask under an existing Asana task","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"taskGid":{"type":"string","required":true,"visibility":"user-or-llm","description":"GID of the parent Asana task (numeric string)"},"name":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the subtask"},"notes":{"type":"string","required":false,"visibility":"user-or-llm","description":"Notes or description for the subtask"},"assignee":{"type":"string","required":false,"visibility":"user-or-llm","description":"User GID to assign the subtask to"},"due_on":{"type":"string","required":false,"visibility":"user-or-llm","description":"Due date in YYYY-MM-DD format"}},"oauth":{"required":true,"provider":"asana"}},"asana_create_task":{"id":"asana_create_task","name":"Asana Create Task","description":"Create a new task in Asana","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"workspace":{"type":"string","required":true,"visibility":"user-or-llm","description":"Asana workspace GID (numeric string) where the task will be created"},"name":{"type":"string","required":true,"visibility":"user-or-llm","description":"Name of the task"},"notes":{"type":"string","required":false,"visibility":"user-or-llm","description":"Notes or description for the task"},"assignee":{"type":"string","required":false,"visibility":"user-or-llm","description":"User GID to assign the task to"},"due_on":{"type":"string","required":false,"visibility":"user-or-llm","description":"Due date in YYYY-MM-DD format"}},"oauth":{"required":true,"provider":"asana"}},"asana_delete_task":{"id":"asana_delete_task","name":"Asana Delete Task","description":"Delete an Asana task by its GID (moves it to the trash)","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"taskGid":{"type":"string","required":true,"visibility":"user-or-llm","description":"GID of the Asana task to delete (numeric string)"}},"oauth":{"required":true,"provider":"asana"}},"asana_get_project":{"id":"asana_get_project","name":"Asana Get Project","description":"Retrieve a single Asana project by its GID","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"projectGid":{"type":"string","required":true,"visibility":"user-or-llm","description":"Asana project GID (numeric string) to retrieve"}},"oauth":{"required":true,"provider":"asana"}},"asana_get_projects":{"id":"asana_get_projects","name":"Asana Get Projects","description":"Retrieve all projects from an Asana workspace","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"workspace":{"type":"string","required":true,"visibility":"user-or-llm","description":"Asana workspace GID (numeric string) to retrieve projects from"}},"oauth":{"required":true,"provider":"asana"}},"asana_get_task":{"id":"asana_get_task","name":"Asana Get Task","description":"Retrieve a single task by GID or get multiple tasks with filters","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"taskGid":{"type":"string","required":false,"visibility":"user-or-llm","description":"The globally unique identifier (GID) of the task. If not provided, will get multiple tasks."},"workspace":{"type":"string","required":false,"visibility":"user-or-llm","description":"Asana workspace GID (numeric string) to filter tasks (required when not using taskGid)"},"project":{"type":"string","required":false,"visibility":"user-or-llm","description":"Asana project GID (numeric string) to filter tasks"},"limit":{"type":"number","required":false,"visibility":"user-or-llm","description":"Maximum number of tasks to return (default: 50)"}},"oauth":{"required":true,"provider":"asana"}},"asana_list_sections":{"id":"asana_list_sections","name":"Asana List Sections","description":"List all sections in an Asana project","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"projectGid":{"type":"string","required":true,"visibility":"user-or-llm","description":"GID of the Asana project (numeric string) to list sections from"}},"oauth":{"required":true,"provider":"asana"}},"asana_list_workspaces":{"id":"asana_list_workspaces","name":"Asana List Workspaces","description":"List all Asana workspaces and organizations the authenticated user belongs to","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"}},"oauth":{"required":true,"provider":"asana"}},"asana_search_tasks":{"id":"asana_search_tasks","name":"Asana Search Tasks","description":"Search for tasks in an Asana workspace","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"workspace":{"type":"string","required":true,"visibility":"user-or-llm","description":"Asana workspace GID (numeric string) to search tasks in"},"text":{"type":"string","required":false,"visibility":"user-or-llm","description":"Text to search for in task names"},"assignee":{"type":"string","required":false,"visibility":"user-or-llm","description":"Filter tasks by assignee user GID"},"projects":{"type":"array","required":false,"visibility":"user-or-llm","description":"Array of Asana project GIDs (numeric strings) to filter tasks by"},"completed":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Filter by completion status"}},"oauth":{"required":true,"provider":"asana"}},"asana_update_task":{"id":"asana_update_task","name":"Asana Update Task","description":"Update an existing task in Asana","version":"1.0.0","params":{"accessToken":{"type":"string","required":true,"visibility":"hidden","description":"OAuth access token for Asana"},"taskGid":{"type":"string","required":true,"visibility":"user-or-llm","description":"Asana task GID (numeric string) of the task to update"},"name":{"type":"string","required":false,"visibility":"user-or-llm","description":"Updated name for the task"},"notes":{"type":"string","required":false,"visibility":"user-or-llm","description":"Updated notes or description for the task"},"assignee":{"type":"string","required":false,"visibility":"user-or-llm","description":"Updated assignee user GID"},"completed":{"type":"boolean","required":false,"visibility":"user-or-llm","description":"Mark task as completed or not completed"},"due_on":{"type":"string","required":false,"visibility":"user-or-llm","description":"Updated due date in YYYY-MM-DD format"}},"oauth":{"required":true,"provider":"asana"}},"ashby_add_candidate_tag":{"id":"ashby_add_candidate_tag","name":"Ashby Add Candidate Tag","description":"Adds a tag to a candidate in Ashby and returns the updated candidate.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ashby API Key"},"candidateId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The UUID of the candidate to add the tag to"},"tagId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The UUID of the tag to add"}}},"ashby_change_application_stage":{"id":"ashby_change_application_stage","name":"Ashby Change Application Stage","description":"Moves an application to a different interview stage. Requires an archive reason when moving to an Archived stage.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ashby API Key"},"applicationId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The UUID of the application to update the stage of"},"interviewStageId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The UUID of the interview stage to move the application to"},"archiveReasonId":{"type":"string","required":false,"visibility":"user-or-llm","description":"Archive reason UUID. Required when moving to an Archived stage, ignored otherwise"}}},"ashby_create_application":{"id":"ashby_create_application","name":"Ashby Create Application","description":"Creates a new application for a candidate on a job. Optionally specify interview plan, stage, source, and credited user.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ashby API Key"},"candidateId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The UUID of the candidate to consider for the job"},"jobId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The UUID of the job to consider the candidate for"},"interviewPlanId":{"type":"string","required":false,"visibility":"user-or-llm","description":"UUID of the interview plan to use (defaults to the job default plan)"},"interviewStageId":{"type":"string","required":false,"visibility":"user-or-llm","description":"UUID of the interview stage to place the application in (defaults to first Lead stage)"},"sourceId":{"type":"string","required":false,"visibility":"user-or-llm","description":"UUID of the source to set on the application"},"creditedToUserId":{"type":"string","required":false,"visibility":"user-or-llm","description":"UUID of the user the application is credited to"},"createdAt":{"type":"string","required":false,"visibility":"user-or-llm","description":"ISO 8601 timestamp to set as the application creation date (defaults to now)"}}},"ashby_create_candidate":{"id":"ashby_create_candidate","name":"Ashby Create Candidate","description":"Creates a new candidate record in Ashby.","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ashby API Key"},"name":{"type":"string","required":true,"visibility":"user-or-llm","description":"The candidate full name"},"email":{"type":"string","required":false,"visibility":"user-or-llm","description":"Primary email address for the candidate"},"phoneNumber":{"type":"string","required":false,"visibility":"user-or-llm","description":"Primary phone number for the candidate"},"linkedInUrl":{"type":"string","required":false,"visibility":"user-or-llm","description":"LinkedIn profile URL"},"githubUrl":{"type":"string","required":false,"visibility":"user-or-llm","description":"GitHub profile URL"},"website":{"type":"string","required":false,"visibility":"user-or-llm","description":"Personal website URL"},"sourceId":{"type":"string","required":false,"visibility":"user-or-llm","description":"UUID of the source to attribute the candidate to"},"creditedToUserId":{"type":"string","required":false,"visibility":"user-or-llm","description":"UUID of the Ashby user to credit with sourcing this candidate"},"createdAt":{"type":"string","required":false,"visibility":"user-or-llm","description":"Backdated creation timestamp in ISO 8601 (e.g. 2024-01-01T00:00:00Z). Defaults to now."},"alternateEmailAddresses":{"type":"json","required":false,"visibility":"user-or-llm","description":"Array of additional email address strings to add to the candidate, e.g. [\\"a@x.com\\",\\"b@y.com\\"]"}}},"ashby_create_note":{"id":"ashby_create_note","name":"Ashby Create Note","description":"Creates a note on a candidate in Ashby. Supports plain text and HTML content (bold, italic, underline, links, lists, code).","version":"1.0.0","params":{"apiKey":{"type":"string","required":true,"visibility":"user-only","description":"Ashby API Key"},"candidateId":{"type":"string","required":true,"visibility":"user-or-llm","description":"The UUID of the candidate to add the note to"},"note":{"type":"string","required":true,"visibility":"user-or-llm","description":"The note content. If noteType is text/html, supports: , , , ,