diff --git a/apps/sim/blocks/blocks/apify.ts b/apps/sim/blocks/blocks/apify.ts index 14bc2fc9a..39b92f7f2 100644 --- a/apps/sim/blocks/blocks/apify.ts +++ b/apps/sim/blocks/blocks/apify.ts @@ -73,18 +73,25 @@ Return ONLY the valid JSON object - no explanations, no markdown.`, generationType: 'json-object', }, }, + { + id: 'memory', + title: 'Memory (MB)', + type: 'short-input', + placeholder: 'Memory in MB (e.g., 1024 for 1GB, 2048 for 2GB)', + required: false, + }, { id: 'timeout', title: 'Timeout', type: 'short-input', - placeholder: 'Actor timeout in seconds', + placeholder: 'Timeout in seconds (e.g., 300 for 5 min)', required: false, }, { id: 'build', title: 'Build', type: 'short-input', - placeholder: 'Actor build (e.g., "latest", "beta", or build tag)', + placeholder: 'Build version (e.g., "latest", "beta", "1.2.3")', required: false, }, { @@ -126,6 +133,10 @@ Return ONLY the valid JSON object - no explanations, no markdown.`, result.input = rest.input } + if (rest.memory) { + result.memory = Number(rest.memory) + } + if (rest.timeout) { result.timeout = Number(rest.timeout) } @@ -152,6 +163,7 @@ Return ONLY the valid JSON object - no explanations, no markdown.`, apiKey: { type: 'string', description: 'Apify API token' }, actorId: { type: 'string', description: 'Actor ID or username/actor-name' }, input: { type: 'string', description: 'Actor input as JSON string' }, + memory: { type: 'number', description: 'Memory in MB (128-32768)' }, timeout: { type: 'number', description: 'Timeout in seconds' }, build: { type: 'string', description: 'Actor build version' }, waitForFinish: { type: 'number', description: 'Initial wait time in seconds' }, diff --git a/apps/sim/tools/ahrefs/backlinks.ts b/apps/sim/tools/ahrefs/backlinks.ts index e2521bd5c..e5ce15512 100644 --- a/apps/sim/tools/ahrefs/backlinks.ts +++ b/apps/sim/tools/ahrefs/backlinks.ts @@ -13,14 +13,15 @@ export const backlinksTool: ToolConfig type: 'string', required: true, visibility: 'user-or-llm', - description: 'Actor ID or username/actor-name (e.g., "janedoe/my-actor" or actor ID)', + 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', + 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', + 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)', + 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 (default: actor default)', + 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 (e.g., "latest", "beta", or build tag/number)', + description: 'Actor build to run. Examples: "latest", "beta", "1.2.3", "build-tag-name"', }, }, @@ -68,6 +78,9 @@ export const apifyRunActorAsyncTool: ToolConfig const waitTime = Math.max(0, Math.min(params.waitForFinish, 60)) queryParams.set('waitForFinish', waitTime.toString()) } + if (params.memory) { + queryParams.set('memory', params.memory.toString()) + } if (params.timeout) { queryParams.set('timeout', params.timeout.toString()) } diff --git a/apps/sim/tools/apify/run_actor_sync.ts b/apps/sim/tools/apify/run_actor_sync.ts index f7991cfd0..6b4e9b1ac 100644 --- a/apps/sim/tools/apify/run_actor_sync.ts +++ b/apps/sim/tools/apify/run_actor_sync.ts @@ -18,25 +18,35 @@ export const apifyRunActorSyncTool: ToolConfig = type: 'string', required: true, visibility: 'user-or-llm', - description: 'Actor ID or username/actor-name (e.g., "janedoe/my-actor" or actor ID)', + 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. See actor documentation for required fields.', + 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 (default: actor default)', + 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 (e.g., "latest", "beta", or build tag/number)', + description: 'Actor build to run. Examples: "latest", "beta", "1.2.3", "build-tag-name"', }, }, @@ -48,6 +58,9 @@ export const apifyRunActorSyncTool: ToolConfig = queryParams.set('token', params.apiKey) + if (params.memory) { + queryParams.set('memory', params.memory.toString()) + } if (params.timeout) { queryParams.set('timeout', params.timeout.toString()) } diff --git a/apps/sim/tools/apify/types.ts b/apps/sim/tools/apify/types.ts index 4face19c8..b6036a336 100644 --- a/apps/sim/tools/apify/types.ts +++ b/apps/sim/tools/apify/types.ts @@ -16,6 +16,7 @@ export interface RunActorParams { input?: string waitForFinish?: number // For async tool: 0-60 seconds initial wait itemLimit?: number // For async tool: 1-250000 items, default 100 + memory?: number // Memory in MB (128-32768) timeout?: number build?: string // Actor build to run (e.g., "latest", "beta", build tag/number) } diff --git a/apps/sim/tools/apollo/account_create.ts b/apps/sim/tools/apollo/account_create.ts index 7ec84d876..eb3418440 100644 --- a/apps/sim/tools/apollo/account_create.ts +++ b/apps/sim/tools/apollo/account_create.ts @@ -21,7 +21,7 @@ export const apolloAccountCreateTool: ToolConfig< type: 'string', required: true, visibility: 'user-or-llm', - description: 'Company name', + description: 'Company name (e.g., "Acme Corporation")', }, website_url: { type: 'string', diff --git a/apps/sim/tools/apollo/account_search.ts b/apps/sim/tools/apollo/account_search.ts index 2be36218c..78bfa0ce4 100644 --- a/apps/sim/tools/apollo/account_search.ts +++ b/apps/sim/tools/apollo/account_search.ts @@ -40,13 +40,13 @@ export const apolloAccountSearchTool: ToolConfig< type: 'number', required: false, visibility: 'user-or-llm', - description: 'Page number for pagination', + 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)', + description: 'Results per page, max 100 (e.g., 25, 50, 100)', }, }, diff --git a/apps/sim/tools/apollo/account_update.ts b/apps/sim/tools/apollo/account_update.ts index bebe5b55d..996e80cc6 100644 --- a/apps/sim/tools/apollo/account_update.ts +++ b/apps/sim/tools/apollo/account_update.ts @@ -21,13 +21,13 @@ export const apolloAccountUpdateTool: ToolConfig< type: 'string', required: true, visibility: 'user-or-llm', - description: 'ID of the account to update', + description: 'ID of the account to update (e.g., "acc_abc123")', }, name: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'Company name', + description: 'Company name (e.g., "Acme Corporation")', }, website_url: { type: 'string', diff --git a/apps/sim/tools/apollo/contact_create.ts b/apps/sim/tools/apollo/contact_create.ts index ae5a6ea13..ecc61a0b2 100644 --- a/apps/sim/tools/apollo/contact_create.ts +++ b/apps/sim/tools/apollo/contact_create.ts @@ -39,13 +39,13 @@ export const apolloContactCreateTool: ToolConfig< type: 'string', required: false, visibility: 'user-or-llm', - description: 'Job title', + 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', + description: 'Apollo account ID to associate with (e.g., "acc_abc123")', }, owner_id: { type: 'string', diff --git a/apps/sim/tools/apollo/contact_search.ts b/apps/sim/tools/apollo/contact_search.ts index b50b8e21f..e2c806046 100644 --- a/apps/sim/tools/apollo/contact_search.ts +++ b/apps/sim/tools/apollo/contact_search.ts @@ -33,13 +33,13 @@ export const apolloContactSearchTool: ToolConfig< type: 'number', required: false, visibility: 'user-or-llm', - description: 'Page number for pagination', + 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)', + description: 'Results per page, max 100 (e.g., 25, 50, 100)', }, }, diff --git a/apps/sim/tools/apollo/contact_update.ts b/apps/sim/tools/apollo/contact_update.ts index 7a94ac1c1..31ebd0c87 100644 --- a/apps/sim/tools/apollo/contact_update.ts +++ b/apps/sim/tools/apollo/contact_update.ts @@ -21,7 +21,7 @@ export const apolloContactUpdateTool: ToolConfig< type: 'string', required: true, visibility: 'user-or-llm', - description: 'ID of the contact to update', + description: 'ID of the contact to update (e.g., "con_abc123")', }, first_name: { type: 'string', @@ -45,13 +45,13 @@ export const apolloContactUpdateTool: ToolConfig< type: 'string', required: false, visibility: 'user-or-llm', - description: 'Job title', + description: 'Job title (e.g., "VP of Sales", "Software Engineer")', }, account_id: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'Apollo account ID', + description: 'Apollo account ID (e.g., "acc_abc123")', }, owner_id: { type: 'string', diff --git a/apps/sim/tools/apollo/opportunity_create.ts b/apps/sim/tools/apollo/opportunity_create.ts index 45d5d8026..4880609e8 100644 --- a/apps/sim/tools/apollo/opportunity_create.ts +++ b/apps/sim/tools/apollo/opportunity_create.ts @@ -24,13 +24,13 @@ export const apolloOpportunityCreateTool: ToolConfig< type: 'string', required: true, visibility: 'user-or-llm', - description: 'Name of the opportunity/deal', + description: 'Name of the opportunity/deal (e.g., "Enterprise License - Q1")', }, account_id: { type: 'string', required: true, visibility: 'user-or-llm', - description: 'ID of the account this opportunity belongs to', + description: 'ID of the account this opportunity belongs to (e.g., "acc_abc123")', }, amount: { type: 'number', diff --git a/apps/sim/tools/apollo/opportunity_get.ts b/apps/sim/tools/apollo/opportunity_get.ts index 4fb9c2cc7..4ef79fea5 100644 --- a/apps/sim/tools/apollo/opportunity_get.ts +++ b/apps/sim/tools/apollo/opportunity_get.ts @@ -21,7 +21,7 @@ export const apolloOpportunityGetTool: ToolConfig< type: 'string', required: true, visibility: 'user-or-llm', - description: 'ID of the opportunity to retrieve', + description: 'ID of the opportunity to retrieve (e.g., "opp_abc123")', }, }, diff --git a/apps/sim/tools/apollo/opportunity_search.ts b/apps/sim/tools/apollo/opportunity_search.ts index 3a317feda..8f1a6db88 100644 --- a/apps/sim/tools/apollo/opportunity_search.ts +++ b/apps/sim/tools/apollo/opportunity_search.ts @@ -29,8 +29,8 @@ export const apolloOpportunitySearchTool: ToolConfig< account_ids: { type: 'array', required: false, - visibility: 'user-only', - description: 'Filter by specific account IDs', + visibility: 'user-or-llm', + description: 'Filter by specific account IDs (e.g., ["acc_123", "acc_456"])', }, stage_ids: { type: 'array', @@ -48,13 +48,13 @@ export const apolloOpportunitySearchTool: ToolConfig< type: 'number', required: false, visibility: 'user-or-llm', - description: 'Page number for pagination', + 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)', + description: 'Results per page, max 100 (e.g., 25, 50, 100)', }, }, diff --git a/apps/sim/tools/apollo/opportunity_update.ts b/apps/sim/tools/apollo/opportunity_update.ts index a03f83bf0..8bb31c901 100644 --- a/apps/sim/tools/apollo/opportunity_update.ts +++ b/apps/sim/tools/apollo/opportunity_update.ts @@ -24,13 +24,13 @@ export const apolloOpportunityUpdateTool: ToolConfig< type: 'string', required: true, visibility: 'user-or-llm', - description: 'ID of the opportunity to update', + 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', + description: 'Name of the opportunity/deal (e.g., "Enterprise License - Q1")', }, amount: { type: 'number', diff --git a/apps/sim/tools/apollo/organization_enrich.ts b/apps/sim/tools/apollo/organization_enrich.ts index 093048b94..d6c1de4f0 100644 --- a/apps/sim/tools/apollo/organization_enrich.ts +++ b/apps/sim/tools/apollo/organization_enrich.ts @@ -25,14 +25,14 @@ export const apolloOrganizationEnrichTool: ToolConfig< required: false, visibility: 'user-or-llm', description: - 'Name of the organization (at least one of organization_name or domain is required)', + 'Name of the organization (e.g., "Acme Corporation") - at least one of organization_name or domain is required', }, domain: { type: 'string', required: false, visibility: 'user-or-llm', description: - 'Company domain (e.g., apollo.io) (at least one of domain or organization_name is required)', + 'Company domain (e.g., "apollo.io", "acme.com") - at least one of domain or organization_name is required', }, }, diff --git a/apps/sim/tools/apollo/organization_search.ts b/apps/sim/tools/apollo/organization_search.ts index 96b08990b..18f31d376 100644 --- a/apps/sim/tools/apollo/organization_search.ts +++ b/apps/sim/tools/apollo/organization_search.ts @@ -42,19 +42,19 @@ export const apolloOrganizationSearchTool: ToolConfig< type: 'string', required: false, visibility: 'user-or-llm', - description: 'Organization name to search for', + description: 'Organization name to search for (e.g., "Acme", "TechCorp")', }, page: { type: 'number', required: false, visibility: 'user-or-llm', - description: 'Page number for pagination', + 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)', + description: 'Results per page, max 100 (e.g., 25, 50, 100)', }, }, diff --git a/apps/sim/tools/apollo/people_enrich.ts b/apps/sim/tools/apollo/people_enrich.ts index 7e48034af..80e5f0322 100644 --- a/apps/sim/tools/apollo/people_enrich.ts +++ b/apps/sim/tools/apollo/people_enrich.ts @@ -45,7 +45,7 @@ export const apolloPeopleEnrichTool: ToolConfig< type: 'string', required: false, visibility: 'user-or-llm', - description: 'Company domain (e.g., apollo.io)', + description: 'Company domain (e.g., "apollo.io", "acme.com")', }, linkedin_url: { type: 'string', diff --git a/apps/sim/tools/apollo/people_search.ts b/apps/sim/tools/apollo/people_search.ts index f32a59ba6..c4841024e 100644 --- a/apps/sim/tools/apollo/people_search.ts +++ b/apps/sim/tools/apollo/people_search.ts @@ -51,13 +51,13 @@ export const apolloPeopleSearchTool: ToolConfig< type: 'number', required: false, visibility: 'user-or-llm', - description: 'Page number for pagination (default: 1)', + 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)', + description: 'Results per page, default 25, max 100 (e.g., 25, 50, 100)', }, }, diff --git a/apps/sim/tools/apollo/sequence_add_contacts.ts b/apps/sim/tools/apollo/sequence_add_contacts.ts index 3dd5f83f4..652ddca2d 100644 --- a/apps/sim/tools/apollo/sequence_add_contacts.ts +++ b/apps/sim/tools/apollo/sequence_add_contacts.ts @@ -23,14 +23,15 @@ export const apolloSequenceAddContactsTool: ToolConfig< sequence_id: { type: 'string', required: true, - visibility: 'user-only', - description: 'ID of the sequence to add contacts to', + visibility: 'user-or-llm', + description: 'ID of the sequence to add contacts to (e.g., "seq_abc123")', }, contact_ids: { type: 'array', required: true, visibility: 'user-or-llm', - description: 'Array of contact IDs to add to the sequence', + description: + 'Array of contact IDs to add to the sequence (e.g., ["con_abc123", "con_def456"])', }, emailer_campaign_id: { type: 'string', diff --git a/apps/sim/tools/apollo/sequence_search.ts b/apps/sim/tools/apollo/sequence_search.ts index 449bb5939..70c5a474d 100644 --- a/apps/sim/tools/apollo/sequence_search.ts +++ b/apps/sim/tools/apollo/sequence_search.ts @@ -21,7 +21,7 @@ export const apolloSequenceSearchTool: ToolConfig< type: 'string', required: false, visibility: 'user-or-llm', - description: 'Search sequences by name', + description: 'Search sequences by name (e.g., "Outbound Q1", "Follow-up")', }, active: { type: 'boolean', @@ -33,13 +33,13 @@ export const apolloSequenceSearchTool: ToolConfig< type: 'number', required: false, visibility: 'user-or-llm', - description: 'Page number for pagination', + 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)', + description: 'Results per page, max 100 (e.g., 25, 50, 100)', }, }, diff --git a/apps/sim/tools/apollo/task_create.ts b/apps/sim/tools/apollo/task_create.ts index 61b4587df..d835fe675 100644 --- a/apps/sim/tools/apollo/task_create.ts +++ b/apps/sim/tools/apollo/task_create.ts @@ -24,13 +24,13 @@ export const apolloTaskCreateTool: ToolConfig type: 'string', required: false, visibility: 'user-or-llm', - description: 'Host name to associate with this event', + description: 'Host name to associate with this event (e.g., "web-server-01", "prod-api-1")', }, tags: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'Comma-separated list of tags (e.g., "env:production,service:api")', + description: + 'Comma-separated list of tags (e.g., "env:production,service:api", "team:backend,priority:high")', }, aggregationKey: { type: 'string', @@ -62,7 +63,8 @@ export const createEventTool: ToolConfig type: 'number', required: false, visibility: 'user-or-llm', - description: 'Unix timestamp when the event occurred (defaults to now)', + description: + 'Unix timestamp in seconds when the event occurred (e.g., 1705320000, defaults to now)', }, apiKey: { type: 'string', diff --git a/apps/sim/tools/datadog/create_monitor.ts b/apps/sim/tools/datadog/create_monitor.ts index 416e2a731..d08da95ea 100644 --- a/apps/sim/tools/datadog/create_monitor.ts +++ b/apps/sim/tools/datadog/create_monitor.ts @@ -26,7 +26,8 @@ export const createMonitorTool: ToolConfig 100")', }, message: { type: 'string', diff --git a/apps/sim/tools/datadog/get_monitor.ts b/apps/sim/tools/datadog/get_monitor.ts index 1025b93f7..0a65208fc 100644 --- a/apps/sim/tools/datadog/get_monitor.ts +++ b/apps/sim/tools/datadog/get_monitor.ts @@ -12,13 +12,14 @@ export const getMonitorTool: ToolConfig = type: 'string', required: true, visibility: 'user-or-llm', - description: 'The ID of the monitor to retrieve', + description: 'The ID of the monitor to retrieve (e.g., "12345678")', }, groupStates: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'Comma-separated group states to include: alert, warn, no data, ok', + description: + 'Comma-separated group states to include (e.g., "alert,warn", "alert,warn,no data,ok")', }, withDowntimes: { type: 'boolean', diff --git a/apps/sim/tools/datadog/list_downtimes.ts b/apps/sim/tools/datadog/list_downtimes.ts index 7a5de1fe4..430f439e6 100644 --- a/apps/sim/tools/datadog/list_downtimes.ts +++ b/apps/sim/tools/datadog/list_downtimes.ts @@ -18,7 +18,7 @@ export const listDowntimesTool: ToolConfig type: 'string', required: true, visibility: 'user-or-llm', - description: 'The ID of the monitor to mute', + description: 'The ID of the monitor to mute (e.g., "12345678")', }, scope: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'Scope to mute (e.g., "host:myhost"). If not specified, mutes all scopes.', + description: + 'Scope to mute (e.g., "host:myhost", "env:prod"). If not specified, mutes all scopes.', }, end: { type: 'number', required: false, visibility: 'user-or-llm', - description: 'Unix timestamp when the mute should end. If not specified, mutes indefinitely.', + description: + 'Unix timestamp in seconds when the mute should end (e.g., 1705323600). If not specified, mutes indefinitely.', }, apiKey: { type: 'string', diff --git a/apps/sim/tools/datadog/query_logs.ts b/apps/sim/tools/datadog/query_logs.ts index ed6406c54..1443c8077 100644 --- a/apps/sim/tools/datadog/query_logs.ts +++ b/apps/sim/tools/datadog/query_logs.ts @@ -13,31 +13,34 @@ export const queryLogsTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Log search query (e.g., "service:web-app status:error")', + description: + 'Log search query using Datadog query syntax (e.g., "service:web-app status:error", "host:prod-* @http.status_code:500")', }, from: { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Start time in ISO-8601 format or relative (e.g., "now-1h")', + description: + 'Start time in ISO-8601 format or relative time (e.g., "now-1h", "now-15m", "2024-01-15T10:00:00Z")', }, to: { type: 'string', required: true, visibility: 'user-or-llm', - description: 'End time in ISO-8601 format or relative (e.g., "now")', + description: + 'End time in ISO-8601 format or relative time (e.g., "now", "now-5m", "2024-01-15T12:00:00Z")', }, limit: { type: 'number', required: false, visibility: 'user-or-llm', - description: 'Maximum number of logs to return (default: 50, max: 1000)', + description: 'Maximum number of logs to return (e.g., 50, 100, max: 1000)', }, sort: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'Sort order: timestamp (oldest first) or -timestamp (newest first)', + description: 'Sort order: "timestamp" for oldest first, "-timestamp" for newest first', }, indexes: { type: 'string', diff --git a/apps/sim/tools/datadog/query_timeseries.ts b/apps/sim/tools/datadog/query_timeseries.ts index acf57395b..abae9e4a3 100644 --- a/apps/sim/tools/datadog/query_timeseries.ts +++ b/apps/sim/tools/datadog/query_timeseries.ts @@ -13,19 +13,20 @@ export const queryTimeseriesTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'DynamoDB table name', + description: 'DynamoDB table name (e.g., "Users", "Orders")', }, key: { type: 'object', required: true, visibility: 'user-or-llm', - description: 'Primary key of the item to retrieve', + description: + 'Primary key of the item to retrieve (e.g., {"pk": "USER#123"} or {"pk": "ORDER#456", "sk": "ITEM#789"})', }, consistentRead: { type: 'boolean', diff --git a/apps/sim/tools/dynamodb/introspect.ts b/apps/sim/tools/dynamodb/introspect.ts index 70410b10a..e45c1a2ba 100644 --- a/apps/sim/tools/dynamodb/introspect.ts +++ b/apps/sim/tools/dynamodb/introspect.ts @@ -31,7 +31,8 @@ export const introspectTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'DynamoDB table name', + description: 'DynamoDB table name (e.g., "Users", "Orders")', }, item: { type: 'object', required: true, visibility: 'user-or-llm', - description: 'Item to put into the table', + description: + 'Item to put into the table (e.g., {"pk": "USER#123", "name": "John", "email": "john@example.com"})', }, }, diff --git a/apps/sim/tools/dynamodb/query.ts b/apps/sim/tools/dynamodb/query.ts index bedb1f234..f6ed7b2a1 100644 --- a/apps/sim/tools/dynamodb/query.ts +++ b/apps/sim/tools/dynamodb/query.ts @@ -30,43 +30,44 @@ export const queryTool: ToolConfig = type: 'string', required: true, visibility: 'user-or-llm', - description: 'DynamoDB table name', + description: 'DynamoDB table name (e.g., "Users", "Orders")', }, keyConditionExpression: { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Key condition expression (e.g., "pk = :pk")', + description: + 'Key condition expression (e.g., "pk = :pk" or "pk = :pk AND sk BEGINS_WITH :prefix")', }, filterExpression: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'Filter expression for results', + description: 'Filter expression for results (e.g., "age > :minAge AND #status = :status")', }, expressionAttributeNames: { type: 'object', required: false, visibility: 'user-or-llm', - description: 'Attribute name mappings for reserved words', + description: 'Attribute name mappings for reserved words (e.g., {"#status": "status"})', }, expressionAttributeValues: { type: 'object', required: false, visibility: 'user-or-llm', - description: 'Expression attribute values', + description: 'Expression attribute values (e.g., {":pk": "USER#123", ":minAge": 18})', }, indexName: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'Secondary index name to query', + description: 'Secondary index name to query (e.g., "GSI1", "email-index")', }, limit: { type: 'number', required: false, visibility: 'user-or-llm', - description: 'Maximum number of items to return', + description: 'Maximum number of items to return (e.g., 10, 50, 100)', }, }, diff --git a/apps/sim/tools/dynamodb/scan.ts b/apps/sim/tools/dynamodb/scan.ts index 1f1003725..4ee608b01 100644 --- a/apps/sim/tools/dynamodb/scan.ts +++ b/apps/sim/tools/dynamodb/scan.ts @@ -30,37 +30,38 @@ export const scanTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'DynamoDB table name', + description: 'DynamoDB table name (e.g., "Users", "Orders")', }, filterExpression: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'Filter expression for results', + description: 'Filter expression for results (e.g., "age > :minAge AND #status = :status")', }, projectionExpression: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'Attributes to retrieve', + description: 'Attributes to retrieve (e.g., "pk, sk, #name, email")', }, expressionAttributeNames: { type: 'object', required: false, visibility: 'user-or-llm', - description: 'Attribute name mappings for reserved words', + description: + 'Attribute name mappings for reserved words (e.g., {"#name": "name", "#status": "status"})', }, expressionAttributeValues: { type: 'object', required: false, visibility: 'user-or-llm', - description: 'Expression attribute values', + description: 'Expression attribute values (e.g., {":minAge": 18, ":status": "active"})', }, limit: { type: 'number', required: false, visibility: 'user-or-llm', - description: 'Maximum number of items to return', + description: 'Maximum number of items to return (e.g., 10, 50, 100)', }, }, diff --git a/apps/sim/tools/dynamodb/update.ts b/apps/sim/tools/dynamodb/update.ts index 3fb4b2102..6fbd9e39d 100644 --- a/apps/sim/tools/dynamodb/update.ts +++ b/apps/sim/tools/dynamodb/update.ts @@ -30,37 +30,41 @@ export const updateTool: ToolConfig = { numResults: { type: 'number', required: false, - visibility: 'user-only', - description: 'Number of results to return (default: 10, max: 25)', + visibility: 'user-or-llm', + description: 'Number of results to return (e.g., 5, 10, 25). Default: 10, max: 25', }, useAutoprompt: { type: 'boolean', required: false, - visibility: 'user-only', - description: 'Whether to use autoprompt to improve the query (default: false)', + visibility: 'user-or-llm', + description: 'Whether to use autoprompt to improve the query (true or false). Default: false', }, type: { type: 'string', required: false, - visibility: 'user-only', - description: 'Search type: neural, keyword, auto or fast (default: auto)', + visibility: 'user-or-llm', + description: 'Search type: "neural", "keyword", "auto", or "fast". Default: "auto"', }, includeDomains: { type: 'string', required: false, - visibility: 'user-only', - description: 'Comma-separated list of domains to include in results', + visibility: 'user-or-llm', + description: + 'Comma-separated list of domains to include in results (e.g., "github.com, stackoverflow.com")', }, excludeDomains: { type: 'string', required: false, - visibility: 'user-only', - description: 'Comma-separated list of domains to exclude from results', + visibility: 'user-or-llm', + description: + 'Comma-separated list of domains to exclude from results (e.g., "reddit.com, pinterest.com")', }, category: { type: 'string', diff --git a/apps/sim/tools/firecrawl/agent.ts b/apps/sim/tools/firecrawl/agent.ts index 50fe0912f..9b5c2e691 100644 --- a/apps/sim/tools/firecrawl/agent.ts +++ b/apps/sim/tools/firecrawl/agent.ts @@ -25,7 +25,8 @@ export const agentTool: ToolConfig = { type: 'json', required: false, visibility: 'user-or-llm', - description: 'Optional array of URLs to focus the agent on', + description: + 'Optional array of URLs to focus the agent on (e.g., ["https://example.com", "https://docs.example.com"])', }, schema: { type: 'json', diff --git a/apps/sim/tools/firecrawl/crawl.ts b/apps/sim/tools/firecrawl/crawl.ts index 6f2c5031e..d490994ff 100644 --- a/apps/sim/tools/firecrawl/crawl.ts +++ b/apps/sim/tools/firecrawl/crawl.ts @@ -18,13 +18,41 @@ export const crawlTool: ToolConfig type: 'string', required: true, visibility: 'user-or-llm', - description: 'The website URL to crawl', + description: + 'The website URL to crawl (e.g., "https://example.com" or "https://docs.example.com/guide")', }, limit: { type: 'number', required: false, - visibility: 'user-only', - description: 'Maximum number of pages to crawl (default: 100)', + visibility: 'user-or-llm', + description: 'Maximum number of pages to crawl (e.g., 50, 100, 500). Default: 100', + }, + maxDepth: { + type: 'number', + required: false, + visibility: 'user-or-llm', + description: + 'Maximum depth to crawl from the starting URL (e.g., 1, 2, 3). Controls how many levels deep to follow links', + }, + formats: { + type: 'json', + required: false, + visibility: 'user-or-llm', + description: + 'Output formats for scraped content (e.g., ["markdown"], ["markdown", "html"], ["markdown", "links"])', + }, + excludePaths: { + type: 'json', + required: false, + visibility: 'user-or-llm', + description: 'URL paths to exclude from crawling (e.g., ["/blog/*", "/admin/*", "/*.pdf"])', + }, + includePaths: { + type: 'json', + required: false, + visibility: 'user-or-llm', + description: + 'URL paths to include in crawling (e.g., ["/docs/*", "/api/*"]). Only these paths will be crawled', }, onlyMainContent: { type: 'boolean', @@ -51,12 +79,13 @@ export const crawlTool: ToolConfig url: params.url, limit: Number(params.limit) || 100, scrapeOptions: params.scrapeOptions || { - formats: ['markdown'], + formats: params.formats || ['markdown'], onlyMainContent: params.onlyMainContent || false, }, } if (params.prompt) body.prompt = params.prompt + if (params.maxDepth) body.maxDiscoveryDepth = Number(params.maxDepth) if (params.maxDiscoveryDepth) body.maxDiscoveryDepth = Number(params.maxDiscoveryDepth) if (params.sitemap) body.sitemap = params.sitemap if (typeof params.crawlEntireDomain === 'boolean') diff --git a/apps/sim/tools/firecrawl/extract.ts b/apps/sim/tools/firecrawl/extract.ts index 4f3aa9692..86d76d502 100644 --- a/apps/sim/tools/firecrawl/extract.ts +++ b/apps/sim/tools/firecrawl/extract.ts @@ -19,7 +19,8 @@ export const extractTool: ToolConfig = { type: 'json', required: true, visibility: 'user-or-llm', - description: 'Array of URLs to extract data from (supports glob format)', + description: + 'Array of URLs to extract data from (e.g., ["https://example.com/page1", "https://example.com/page2"] or ["https://example.com/*"])', }, prompt: { type: 'string', diff --git a/apps/sim/tools/firecrawl/map.ts b/apps/sim/tools/firecrawl/map.ts index 2ddd82a43..298cb25c1 100644 --- a/apps/sim/tools/firecrawl/map.ts +++ b/apps/sim/tools/firecrawl/map.ts @@ -13,7 +13,7 @@ export const mapTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'The base URL to map and discover links from', + description: 'The base URL to map and discover links from (e.g., "https://example.com")', }, search: { type: 'string', @@ -42,8 +42,9 @@ export const mapTool: ToolConfig = { limit: { type: 'number', required: false, - visibility: 'user-only', - description: 'Maximum number of links to return (max: 100,000, default: 5,000)', + visibility: 'user-or-llm', + description: + 'Maximum number of links to return (e.g., 100, 1000, 5000). Max: 100,000, default: 5,000', }, timeout: { type: 'number', diff --git a/apps/sim/tools/firecrawl/scrape.ts b/apps/sim/tools/firecrawl/scrape.ts index 14ea893d2..6d1bfafa9 100644 --- a/apps/sim/tools/firecrawl/scrape.ts +++ b/apps/sim/tools/firecrawl/scrape.ts @@ -15,7 +15,7 @@ export const scrapeTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'The URL to scrape content from', + description: 'The URL to scrape content from (e.g., "https://example.com/page")', }, scrapeOptions: { type: 'json', diff --git a/apps/sim/tools/firecrawl/types.ts b/apps/sim/tools/firecrawl/types.ts index cdb6d27f0..6fd7e3e5f 100644 --- a/apps/sim/tools/firecrawl/types.ts +++ b/apps/sim/tools/firecrawl/types.ts @@ -367,6 +367,8 @@ export interface FirecrawlCrawlParams { apiKey: string url: string limit?: number + maxDepth?: number + formats?: string[] onlyMainContent?: boolean prompt?: string maxDiscoveryDepth?: number diff --git a/apps/sim/tools/fireflies/create_bite.ts b/apps/sim/tools/fireflies/create_bite.ts index 7c0806f6e..26bb87628 100644 --- a/apps/sim/tools/fireflies/create_bite.ts +++ b/apps/sim/tools/fireflies/create_bite.ts @@ -24,7 +24,7 @@ export const firefliesCreateBiteTool: ToolConfig< type: 'string', required: true, visibility: 'user-or-llm', - description: 'ID of the transcript to create the bite from', + description: 'ID of the transcript to create the bite from (e.g., "abc123def456")', }, startTime: { type: 'number', diff --git a/apps/sim/tools/fireflies/delete_transcript.ts b/apps/sim/tools/fireflies/delete_transcript.ts index 6b292143b..bf5aa4d5c 100644 --- a/apps/sim/tools/fireflies/delete_transcript.ts +++ b/apps/sim/tools/fireflies/delete_transcript.ts @@ -24,7 +24,7 @@ export const firefliesDeleteTranscriptTool: ToolConfig< type: 'string', required: true, visibility: 'user-or-llm', - description: 'The transcript ID to delete', + description: 'The transcript ID to delete (e.g., "abc123def456")', }, }, diff --git a/apps/sim/tools/fireflies/get_transcript.ts b/apps/sim/tools/fireflies/get_transcript.ts index cbb1c162a..1bb7bdefc 100644 --- a/apps/sim/tools/fireflies/get_transcript.ts +++ b/apps/sim/tools/fireflies/get_transcript.ts @@ -25,7 +25,7 @@ export const firefliesGetTranscriptTool: ToolConfig< type: 'string', required: true, visibility: 'user-or-llm', - description: 'The transcript ID to retrieve', + description: 'The transcript ID to retrieve (e.g., "abc123def456")', }, }, diff --git a/apps/sim/tools/fireflies/get_user.ts b/apps/sim/tools/fireflies/get_user.ts index cd0feaa6e..42220153d 100644 --- a/apps/sim/tools/fireflies/get_user.ts +++ b/apps/sim/tools/fireflies/get_user.ts @@ -18,7 +18,7 @@ export const firefliesGetUserTool: ToolConfig = { messageId: { type: 'string', required: false, - visibility: 'user-only', - description: 'ID of the message to read', + visibility: 'user-or-llm', + description: 'Gmail message ID to read (e.g., 18f1a2b3c4d5e6f7)', }, folder: { type: 'string', required: false, - visibility: 'user-only', - description: 'Folder/label to read emails from', + visibility: 'user-or-llm', + description: + 'Folder/label to read emails from (e.g., INBOX, SENT, DRAFT, TRASH, SPAM, or custom label name)', }, unreadOnly: { type: 'boolean', required: false, - visibility: 'user-only', - description: 'Only retrieve unread messages', + visibility: 'user-or-llm', + description: 'Set to true to only retrieve unread messages', }, maxResults: { type: 'number', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Maximum number of messages to retrieve (default: 1, max: 10)', }, includeAttachments: { type: 'boolean', required: false, - visibility: 'user-only', - description: 'Download and include email attachments', + visibility: 'user-or-llm', + description: 'Set to true to download and include email attachments', }, }, diff --git a/apps/sim/tools/gmail/search.ts b/apps/sim/tools/gmail/search.ts index d62cd6502..b8b83b2e7 100644 --- a/apps/sim/tools/gmail/search.ts +++ b/apps/sim/tools/gmail/search.ts @@ -36,8 +36,8 @@ export const gmailSearchTool: ToolConfig = maxResults: { type: 'number', required: false, - visibility: 'user-only', - description: 'Maximum number of results to return', + visibility: 'user-or-llm', + description: 'Maximum number of results to return (e.g., 10, 25, 50)', }, }, diff --git a/apps/sim/tools/google_calendar/create.ts b/apps/sim/tools/google_calendar/create.ts index e712470d2..a8d55604e 100644 --- a/apps/sim/tools/google_calendar/create.ts +++ b/apps/sim/tools/google_calendar/create.ts @@ -28,8 +28,8 @@ export const createTool: ToolConfig documentId: { type: 'string', required: true, - visibility: 'user-only', - description: 'The ID of the document to read', + visibility: 'user-or-llm', + description: 'Google Docs document ID', }, }, diff --git a/apps/sim/tools/google_drive/create_folder.ts b/apps/sim/tools/google_drive/create_folder.ts index 22643350e..eb80cd14b 100644 --- a/apps/sim/tools/google_drive/create_folder.ts +++ b/apps/sim/tools/google_drive/create_folder.ts @@ -32,8 +32,8 @@ export const createFolderTool: ToolConfig = { formId: { type: 'string', required: true, - visibility: 'user-only', - description: 'The ID of the Google Form', + visibility: 'user-or-llm', + description: 'Google Forms form ID', }, responseId: { type: 'string', required: false, - visibility: 'user-only', - description: 'If provided, returns this specific response', + visibility: 'user-or-llm', + description: 'Response ID - if provided, returns this specific response', }, pageSize: { type: 'number', diff --git a/apps/sim/tools/google_forms/list_watches.ts b/apps/sim/tools/google_forms/list_watches.ts index 3442c0afa..b23847319 100644 --- a/apps/sim/tools/google_forms/list_watches.ts +++ b/apps/sim/tools/google_forms/list_watches.ts @@ -34,8 +34,8 @@ export const listWatchesTool: ToolConfig< formId: { type: 'string', required: true, - visibility: 'user-only', - description: 'The ID of the Google Form', + visibility: 'user-or-llm', + description: 'Google Forms form ID', }, }, diff --git a/apps/sim/tools/google_forms/renew_watch.ts b/apps/sim/tools/google_forms/renew_watch.ts index 21a6a9a93..fe81c0867 100644 --- a/apps/sim/tools/google_forms/renew_watch.ts +++ b/apps/sim/tools/google_forms/renew_watch.ts @@ -30,14 +30,14 @@ export const renewWatchTool: ToolConfig< formId: { type: 'string', required: true, - visibility: 'user-only', - description: 'The ID of the Google Form', + visibility: 'user-or-llm', + description: 'Google Forms form ID', }, watchId: { type: 'string', required: true, - visibility: 'user-only', - description: 'The ID of the watch to renew', + visibility: 'user-or-llm', + description: 'Watch ID to renew', }, }, diff --git a/apps/sim/tools/google_forms/set_publish_settings.ts b/apps/sim/tools/google_forms/set_publish_settings.ts index fa3a3b5ad..76f2bbfd4 100644 --- a/apps/sim/tools/google_forms/set_publish_settings.ts +++ b/apps/sim/tools/google_forms/set_publish_settings.ts @@ -35,8 +35,8 @@ export const setPublishSettingsTool: ToolConfig< formId: { type: 'string', required: true, - visibility: 'user-only', - description: 'The ID of the Google Form', + visibility: 'user-or-llm', + description: 'Google Forms form ID', }, isPublished: { type: 'boolean', diff --git a/apps/sim/tools/google_groups/add_alias.ts b/apps/sim/tools/google_groups/add_alias.ts index 6ea8ed30b..f2eaff51c 100644 --- a/apps/sim/tools/google_groups/add_alias.ts +++ b/apps/sim/tools/google_groups/add_alias.ts @@ -23,7 +23,8 @@ export const addAliasTool: ToolConfig = { presentationId: { type: 'string', required: true, - visibility: 'user-only', - description: 'The ID of the presentation', + visibility: 'user-or-llm', + description: 'Google Slides presentation ID', }, pageObjectId: { type: 'string', diff --git a/apps/sim/tools/google_slides/add_slide.ts b/apps/sim/tools/google_slides/add_slide.ts index 7b0b8b852..d5bef81c2 100644 --- a/apps/sim/tools/google_slides/add_slide.ts +++ b/apps/sim/tools/google_slides/add_slide.ts @@ -60,8 +60,8 @@ export const addSlideTool: ToolConfig = { presentationId: { type: 'string', required: true, - visibility: 'user-only', - description: 'The ID of the presentation', + visibility: 'user-or-llm', + description: 'Google Slides presentation ID', }, layout: { type: 'string', diff --git a/apps/sim/tools/google_slides/create.ts b/apps/sim/tools/google_slides/create.ts index f64b08329..7250734ba 100644 --- a/apps/sim/tools/google_slides/create.ts +++ b/apps/sim/tools/google_slides/create.ts @@ -40,8 +40,8 @@ export const createTool: ToolConfig presentationId: { type: 'string', required: true, - visibility: 'user-only', - description: 'The ID of the presentation', + visibility: 'user-or-llm', + description: 'Google Slides presentation ID', }, pageObjectId: { type: 'string', diff --git a/apps/sim/tools/google_slides/create_table.ts b/apps/sim/tools/google_slides/create_table.ts index bb059b6fc..f6f144af8 100644 --- a/apps/sim/tools/google_slides/create_table.ts +++ b/apps/sim/tools/google_slides/create_table.ts @@ -53,8 +53,8 @@ export const createTableTool: ToolConfig presentationId: { type: 'string', required: true, - visibility: 'user-only', - description: 'The ID of the presentation', + visibility: 'user-or-llm', + description: 'Google Slides presentation ID', }, pageObjectId: { type: 'string', diff --git a/apps/sim/tools/google_slides/delete_object.ts b/apps/sim/tools/google_slides/delete_object.ts index 218d7e99b..d37d22f26 100644 --- a/apps/sim/tools/google_slides/delete_object.ts +++ b/apps/sim/tools/google_slides/delete_object.ts @@ -43,8 +43,8 @@ export const deleteObjectTool: ToolConfig = { presentationId: { type: 'string', required: true, - visibility: 'user-only', - description: 'The ID of the presentation', + visibility: 'user-or-llm', + description: 'Google Slides presentation ID', }, pageObjectId: { type: 'string', diff --git a/apps/sim/tools/google_slides/get_thumbnail.ts b/apps/sim/tools/google_slides/get_thumbnail.ts index c1c5f7e4f..1bc496892 100644 --- a/apps/sim/tools/google_slides/get_thumbnail.ts +++ b/apps/sim/tools/google_slides/get_thumbnail.ts @@ -53,8 +53,8 @@ export const getThumbnailTool: ToolConfig = presentationId: { type: 'string', required: true, - visibility: 'user-only', - description: 'The ID of the presentation', + visibility: 'user-or-llm', + description: 'Google Slides presentation ID', }, objectId: { type: 'string', diff --git a/apps/sim/tools/google_slides/read.ts b/apps/sim/tools/google_slides/read.ts index 636a54bba..15224950d 100644 --- a/apps/sim/tools/google_slides/read.ts +++ b/apps/sim/tools/google_slides/read.ts @@ -22,8 +22,8 @@ export const readTool: ToolConfig = { matterId: { type: 'string', required: false, - visibility: 'user-only', - description: 'Optional matter ID to fetch a specific matter', + visibility: 'user-or-llm', + description: 'Optional matter ID to fetch a specific matter (e.g., "12345678901234567890")', }, }, diff --git a/apps/sim/tools/google_vault/list_matters_export.ts b/apps/sim/tools/google_vault/list_matters_export.ts index 4ee064d00..ad0880c6a 100644 --- a/apps/sim/tools/google_vault/list_matters_export.ts +++ b/apps/sim/tools/google_vault/list_matters_export.ts @@ -23,8 +23,8 @@ export const listMattersExportTool: ToolConfig matterId: { type: 'string', required: true, - visibility: 'user-only', - description: 'The matter ID', + visibility: 'user-or-llm', + description: 'The matter ID (e.g., "12345678901234567890")', }, pageSize: { type: 'number', @@ -41,8 +41,8 @@ export const listMattersHoldsTool: ToolConfig holdId: { type: 'string', required: false, - visibility: 'user-only', - description: 'Optional hold ID to fetch a specific hold', + visibility: 'user-or-llm', + description: 'Optional hold ID to fetch a specific hold (e.g., "holdId123456")', }, }, diff --git a/apps/sim/tools/grafana/create_alert_rule.ts b/apps/sim/tools/grafana/create_alert_rule.ts index 24029f093..a1f4fea02 100644 --- a/apps/sim/tools/grafana/create_alert_rule.ts +++ b/apps/sim/tools/grafana/create_alert_rule.ts @@ -29,8 +29,8 @@ export const createAlertRuleTool: ToolConfig< organizationId: { type: 'string', required: false, - visibility: 'user-only', - description: 'Organization ID for multi-org Grafana instances', + visibility: 'user-or-llm', + description: 'Organization ID for multi-org Grafana instances (e.g., 1, 2)', }, title: { type: 'string', @@ -42,7 +42,7 @@ export const createAlertRuleTool: ToolConfig< type: 'string', required: true, visibility: 'user-or-llm', - description: 'The UID of the folder to create the alert in', + description: 'The UID of the folder to create the alert in (e.g., folder-abc123)', }, ruleGroup: { type: 'string', diff --git a/apps/sim/tools/grafana/create_annotation.ts b/apps/sim/tools/grafana/create_annotation.ts index 6f82235a0..dc75e3f58 100644 --- a/apps/sim/tools/grafana/create_annotation.ts +++ b/apps/sim/tools/grafana/create_annotation.ts @@ -29,8 +29,8 @@ export const createAnnotationTool: ToolConfig< organizationId: { type: 'string', required: false, - visibility: 'user-only', - description: 'Organization ID for multi-org Grafana instances', + visibility: 'user-or-llm', + description: 'Organization ID for multi-org Grafana instances (e.g., 1, 2)', }, text: { type: 'string', @@ -48,25 +48,25 @@ export const createAnnotationTool: ToolConfig< type: 'string', required: true, visibility: 'user-or-llm', - description: 'UID of the dashboard to add the annotation to', + description: 'UID of the dashboard to add the annotation to (e.g., abc123def)', }, panelId: { type: 'number', required: false, visibility: 'user-or-llm', - description: 'ID of the panel to add the annotation to', + description: 'ID of the panel to add the annotation to (e.g., 1, 2)', }, time: { type: 'number', required: false, visibility: 'user-or-llm', - description: 'Start time in epoch milliseconds (defaults to now)', + description: 'Start time in epoch milliseconds (e.g., 1704067200000, defaults to now)', }, timeEnd: { type: 'number', required: false, visibility: 'user-or-llm', - description: 'End time in epoch milliseconds (for range annotations)', + description: 'End time in epoch milliseconds for range annotations (e.g., 1704153600000)', }, }, diff --git a/apps/sim/tools/grafana/create_dashboard.ts b/apps/sim/tools/grafana/create_dashboard.ts index 8286ca9ac..ce48358d9 100644 --- a/apps/sim/tools/grafana/create_dashboard.ts +++ b/apps/sim/tools/grafana/create_dashboard.ts @@ -29,8 +29,8 @@ export const createDashboardTool: ToolConfig< organizationId: { type: 'string', required: false, - visibility: 'user-only', - description: 'Organization ID for multi-org Grafana instances', + visibility: 'user-or-llm', + description: 'Organization ID for multi-org Grafana instances (e.g., 1, 2)', }, title: { type: 'string', @@ -42,7 +42,7 @@ export const createDashboardTool: ToolConfig< type: 'string', required: false, visibility: 'user-or-llm', - description: 'The UID of the folder to create the dashboard in', + description: 'The UID of the folder to create the dashboard in (e.g., folder-abc123)', }, tags: { type: 'string', diff --git a/apps/sim/tools/grafana/create_folder.ts b/apps/sim/tools/grafana/create_folder.ts index 08e05e5cc..3231690d3 100644 --- a/apps/sim/tools/grafana/create_folder.ts +++ b/apps/sim/tools/grafana/create_folder.ts @@ -24,8 +24,8 @@ export const createFolderTool: ToolConfig = type: 'string', required: true, visibility: 'user-or-llm', - description: 'Natural language question about the codebase', + description: + 'Natural language question about the codebase. Example: "How does authentication work?" or "Where is the payment processing logic?"', }, repositories: { type: 'string', required: true, - visibility: 'user-only', + visibility: 'user-or-llm', description: - 'Comma-separated list of repositories. Format: "github:branch:owner/repo" or just "owner/repo" (defaults to github:main)', + 'Comma-separated list of repositories. Format: "github:branch:owner/repo" or just "owner/repo" (defaults to github:main). Example: "facebook/react" or "github:main:facebook/react,github:main:facebook/relay"', }, sessionId: { type: 'string', required: false, - visibility: 'user-only', - description: 'Session ID for conversation continuity', + visibility: 'user-or-llm', + description: + 'Session ID for conversation continuity. Use the same sessionId across multiple queries to maintain context. Example: "session-abc123"', }, genius: { type: 'boolean', diff --git a/apps/sim/tools/greptile/search.ts b/apps/sim/tools/greptile/search.ts index fdf1e0633..48028cfef 100644 --- a/apps/sim/tools/greptile/search.ts +++ b/apps/sim/tools/greptile/search.ts @@ -14,20 +14,22 @@ export const searchTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'The URL to read and convert to markdown', + description: 'The URL to read and convert to markdown (e.g., "https://example.com/page")', }, useReaderLMv2: { type: 'boolean', diff --git a/apps/sim/tools/jina/search.ts b/apps/sim/tools/jina/search.ts index 91c96fd34..f1009e355 100644 --- a/apps/sim/tools/jina/search.ts +++ b/apps/sim/tools/jina/search.ts @@ -14,7 +14,7 @@ export const searchTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Search query string', + description: 'Search query string (e.g., "machine learning tutorials")', }, apiKey: { type: 'string', diff --git a/apps/sim/tools/jira/bulk_read.ts b/apps/sim/tools/jira/bulk_read.ts index f90ba2e4b..380700133 100644 --- a/apps/sim/tools/jira/bulk_read.ts +++ b/apps/sim/tools/jira/bulk_read.ts @@ -28,14 +28,15 @@ export const jiraBulkRetrieveTool: ToolConfig = projectId: { type: 'string', required: false, - visibility: 'user-only', - description: - 'Jira project ID to update issues in. If not provided, all issues will be retrieved.', + visibility: 'user-or-llm', + description: 'Jira project key (e.g., PROJ). Optional when updating a single issue.', }, issueKey: { type: 'string', required: true, - visibility: 'user-only', - description: 'Jira issue key to update', + visibility: 'user-or-llm', + description: 'Jira issue key to update (e.g., PROJ-123)', }, summary: { type: 'string', @@ -71,7 +70,7 @@ export const jiraUpdateTool: ToolConfig = cloudId: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'hidden', description: 'Jira Cloud ID for the instance. If not provided, it will be fetched using the domain.', }, diff --git a/apps/sim/tools/jira/write.ts b/apps/sim/tools/jira/write.ts index a9693c2b1..bf2816be0 100644 --- a/apps/sim/tools/jira/write.ts +++ b/apps/sim/tools/jira/write.ts @@ -28,8 +28,8 @@ export const jiraWriteTool: ToolConfig = { projectId: { type: 'string', required: true, - visibility: 'user-only', - description: 'Project ID for the issue', + visibility: 'user-or-llm', + description: 'Jira project key (e.g., PROJ)', }, summary: { type: 'string', diff --git a/apps/sim/tools/jsm/add_comment.ts b/apps/sim/tools/jsm/add_comment.ts index daba0098a..971836eac 100644 --- a/apps/sim/tools/jsm/add_comment.ts +++ b/apps/sim/tools/jsm/add_comment.ts @@ -46,8 +46,8 @@ export const jsmAddCommentTool: ToolConfig = { start: { type: 'number', required: false, - visibility: 'user-only', - description: 'Start index for pagination (default: 0)', + visibility: 'user-or-llm', + description: 'Start index for pagination (e.g., 0, 50, 100)', }, limit: { type: 'number', required: false, - visibility: 'user-only', - description: 'Maximum results to return (default: 50)', + visibility: 'user-or-llm', + description: 'Maximum results to return (e.g., 10, 25, 50)', }, }, diff --git a/apps/sim/tools/kalshi/amend_order.ts b/apps/sim/tools/kalshi/amend_order.ts index 8c5955eac..9db7a78a1 100644 --- a/apps/sim/tools/kalshi/amend_order.ts +++ b/apps/sim/tools/kalshi/amend_order.ts @@ -46,43 +46,43 @@ export const kalshiAmendOrderTool: ToolConfig type: 'string', required: true, visibility: 'user-or-llm', - description: 'Domain name', + description: 'Domain name to retrieve details for (e.g., mg.example.com)', }, }, diff --git a/apps/sim/tools/mailgun/get_mailing_list.ts b/apps/sim/tools/mailgun/get_mailing_list.ts index 509021d8a..ec645ce26 100644 --- a/apps/sim/tools/mailgun/get_mailing_list.ts +++ b/apps/sim/tools/mailgun/get_mailing_list.ts @@ -18,7 +18,7 @@ export const mailgunGetMailingListTool: ToolConfig")', }, to: { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Recipient email address (comma-separated for multiple)', + description: + 'Recipient email address (e.g., user@example.com). Use comma-separated values for multiple recipients', }, subject: { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Email subject', + description: 'Email subject line', }, text: { type: 'string', @@ -48,19 +49,21 @@ export const mailgunSendMessageTool: ToolConfigHello

Message content

")', }, cc: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'CC email address (comma-separated for multiple)', + description: + 'CC recipient email address (e.g., cc@example.com). Use comma-separated values for multiple recipients', }, bcc: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'BCC email address (comma-separated for multiple)', + description: + 'BCC recipient email address (e.g., bcc@example.com). Use comma-separated values for multiple recipients', }, tags: { type: 'string', diff --git a/apps/sim/tools/mem0/add_memories.ts b/apps/sim/tools/mem0/add_memories.ts index db1ccba97..0616e5a2b 100644 --- a/apps/sim/tools/mem0/add_memories.ts +++ b/apps/sim/tools/mem0/add_memories.ts @@ -15,14 +15,15 @@ export const mem0AddMemoriesTool: ToolConfig = { userId: { type: 'string', required: true, - visibility: 'user-only', - description: 'User ID associated with the memory', + visibility: 'user-or-llm', + description: 'User ID associated with the memory (e.g., "user_123", "alice@example.com")', }, messages: { type: 'json', required: true, visibility: 'user-or-llm', - description: 'Array of message objects with role and content', + description: + 'Array of message objects with role and content (e.g., [{"role": "user", "content": "Hello"}])', }, apiKey: { type: 'string', diff --git a/apps/sim/tools/mem0/get_memories.ts b/apps/sim/tools/mem0/get_memories.ts index c8f18feec..c753a25fa 100644 --- a/apps/sim/tools/mem0/get_memories.ts +++ b/apps/sim/tools/mem0/get_memories.ts @@ -15,33 +15,33 @@ export const mem0GetMemoriesTool: ToolConfig = { userId: { type: 'string', required: true, - visibility: 'user-only', - description: 'User ID to retrieve memories for', + visibility: 'user-or-llm', + description: 'User ID to retrieve memories for (e.g., "user_123", "alice@example.com")', }, memoryId: { type: 'string', required: false, - visibility: 'user-only', - description: 'Specific memory ID to retrieve', + visibility: 'user-or-llm', + description: 'Specific memory ID to retrieve (e.g., "mem_abc123")', }, startDate: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'Start date for filtering by created_at (format: YYYY-MM-DD)', + description: 'Start date for filtering by created_at (e.g., "2024-01-15")', }, endDate: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'End date for filtering by created_at (format: YYYY-MM-DD)', + description: 'End date for filtering by created_at (e.g., "2024-12-31")', }, limit: { type: 'number', required: false, default: 10, - visibility: 'hidden', - description: 'Maximum number of results to return', + visibility: 'user-or-llm', + description: 'Maximum number of results to return (e.g., 10, 50, 100)', }, apiKey: { type: 'string', diff --git a/apps/sim/tools/mem0/search_memories.ts b/apps/sim/tools/mem0/search_memories.ts index 5b4e3eb46..c7fc4d3d7 100644 --- a/apps/sim/tools/mem0/search_memories.ts +++ b/apps/sim/tools/mem0/search_memories.ts @@ -16,21 +16,21 @@ export const mem0SearchMemoriesTool: ToolConfig = { userId: { type: 'string', required: true, - visibility: 'user-only', - description: 'User ID to search memories for', + visibility: 'user-or-llm', + description: 'User ID to search memories for (e.g., "user_123", "alice@example.com")', }, query: { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Search query to find relevant memories', + description: 'Search query to find relevant memories (e.g., "What are my favorite foods?")', }, limit: { type: 'number', required: false, default: 10, - visibility: 'user-only', - description: 'Maximum number of results to return', + visibility: 'user-or-llm', + description: 'Maximum number of results to return (e.g., 10, 50, 100)', }, apiKey: { type: 'string', diff --git a/apps/sim/tools/microsoft_excel/read.ts b/apps/sim/tools/microsoft_excel/read.ts index 49e8540ce..b1ffe5f32 100644 --- a/apps/sim/tools/microsoft_excel/read.ts +++ b/apps/sim/tools/microsoft_excel/read.ts @@ -32,8 +32,8 @@ export const readTool: ToolConfig = { database: { type: 'string', required: true, - visibility: 'user-only', - description: 'Database name to connect to', + visibility: 'user-or-llm', + description: 'Database name to connect to (e.g., "mydb")', }, username: { type: 'string', diff --git a/apps/sim/tools/mongodb/execute.ts b/apps/sim/tools/mongodb/execute.ts index ec0b85d95..12e5d42f3 100644 --- a/apps/sim/tools/mongodb/execute.ts +++ b/apps/sim/tools/mongodb/execute.ts @@ -23,8 +23,8 @@ export const executeTool: ToolConfig = { database: { type: 'string', required: true, - visibility: 'user-only', - description: 'Database name to connect to', + visibility: 'user-or-llm', + description: 'Database name to connect to (e.g., "mydb")', }, username: { type: 'string', diff --git a/apps/sim/tools/mongodb/insert.ts b/apps/sim/tools/mongodb/insert.ts index 853414cc2..b129f6539 100644 --- a/apps/sim/tools/mongodb/insert.ts +++ b/apps/sim/tools/mongodb/insert.ts @@ -23,8 +23,8 @@ export const insertTool: ToolConfig = { database: { type: 'string', required: true, - visibility: 'user-only', - description: 'Database name to connect to', + visibility: 'user-or-llm', + description: 'Database name to connect to (e.g., "mydb")', }, username: { type: 'string', diff --git a/apps/sim/tools/mongodb/introspect.ts b/apps/sim/tools/mongodb/introspect.ts index 8452d68e1..045a11107 100644 --- a/apps/sim/tools/mongodb/introspect.ts +++ b/apps/sim/tools/mongodb/introspect.ts @@ -23,8 +23,9 @@ export const introspectTool: ToolConfig = { database: { type: 'string', required: true, - visibility: 'user-only', - description: 'Database name to connect to', + visibility: 'user-or-llm', + description: 'Database name to connect to (e.g., "mydb")', }, username: { type: 'string', diff --git a/apps/sim/tools/mongodb/update.ts b/apps/sim/tools/mongodb/update.ts index 505995ea0..d1812e309 100644 --- a/apps/sim/tools/mongodb/update.ts +++ b/apps/sim/tools/mongodb/update.ts @@ -23,8 +23,8 @@ export const updateTool: ToolConfig = { database: { type: 'string', required: true, - visibility: 'user-only', - description: 'Database name to connect to', + visibility: 'user-or-llm', + description: 'Database name to connect to (e.g., "mydb")', }, username: { type: 'string', diff --git a/apps/sim/tools/mysql/delete.ts b/apps/sim/tools/mysql/delete.ts index 2f4ad28ad..d44608b40 100644 --- a/apps/sim/tools/mysql/delete.ts +++ b/apps/sim/tools/mysql/delete.ts @@ -23,8 +23,8 @@ export const deleteTool: ToolConfig = { database: { type: 'string', required: true, - visibility: 'user-only', - description: 'Database name to connect to', + visibility: 'user-or-llm', + description: 'Database name to connect to (e.g., my_database)', }, username: { type: 'string', @@ -48,7 +48,7 @@ export const deleteTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Table name to delete from', + description: 'Table name to delete from (e.g., users, orders)', }, where: { type: 'string', diff --git a/apps/sim/tools/mysql/execute.ts b/apps/sim/tools/mysql/execute.ts index 5e912ab44..b9994f1bd 100644 --- a/apps/sim/tools/mysql/execute.ts +++ b/apps/sim/tools/mysql/execute.ts @@ -23,8 +23,8 @@ export const executeTool: ToolConfig = { database: { type: 'string', required: true, - visibility: 'user-only', - description: 'Database name to connect to', + visibility: 'user-or-llm', + description: 'Database name to connect to (e.g., my_database)', }, username: { type: 'string', @@ -48,7 +48,8 @@ export const executeTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Raw SQL query to execute', + description: + 'Raw SQL query to execute (e.g., CREATE TABLE users (id INT PRIMARY KEY, name VARCHAR(255)))', }, }, diff --git a/apps/sim/tools/mysql/insert.ts b/apps/sim/tools/mysql/insert.ts index e83724927..cf8d225f4 100644 --- a/apps/sim/tools/mysql/insert.ts +++ b/apps/sim/tools/mysql/insert.ts @@ -23,8 +23,8 @@ export const insertTool: ToolConfig = { database: { type: 'string', required: true, - visibility: 'user-only', - description: 'Database name to connect to', + visibility: 'user-or-llm', + description: 'Database name to connect to (e.g., my_database)', }, username: { type: 'string', @@ -48,7 +48,7 @@ export const insertTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Table name to insert into', + description: 'Table name to insert into (e.g., users, orders)', }, data: { type: 'object', diff --git a/apps/sim/tools/mysql/introspect.ts b/apps/sim/tools/mysql/introspect.ts index 207030b7c..2835ed9df 100644 --- a/apps/sim/tools/mysql/introspect.ts +++ b/apps/sim/tools/mysql/introspect.ts @@ -24,8 +24,8 @@ export const introspectTool: ToolConfig = { database: { type: 'string', required: true, - visibility: 'user-only', - description: 'Database name to connect to', + visibility: 'user-or-llm', + description: 'Database name to connect to (e.g., my_database)', }, username: { type: 'string', @@ -48,7 +48,7 @@ export const queryTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'SQL SELECT query to execute', + description: 'SQL SELECT query to execute (e.g., SELECT * FROM users WHERE active = 1)', }, }, diff --git a/apps/sim/tools/mysql/update.ts b/apps/sim/tools/mysql/update.ts index 4d53a20fa..41d53bf95 100644 --- a/apps/sim/tools/mysql/update.ts +++ b/apps/sim/tools/mysql/update.ts @@ -23,8 +23,8 @@ export const updateTool: ToolConfig = { database: { type: 'string', required: true, - visibility: 'user-only', - description: 'Database name to connect to', + visibility: 'user-or-llm', + description: 'Database name to connect to (e.g., my_database)', }, username: { type: 'string', @@ -48,7 +48,7 @@ export const updateTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Table name to update', + description: 'Table name to update (e.g., users, orders)', }, data: { type: 'object', diff --git a/apps/sim/tools/neo4j/create.ts b/apps/sim/tools/neo4j/create.ts index c8edad701..cd2774754 100644 --- a/apps/sim/tools/neo4j/create.ts +++ b/apps/sim/tools/neo4j/create.ts @@ -24,8 +24,8 @@ export const createTool: ToolConfig = { database: { type: 'string', required: true, - visibility: 'user-only', - description: 'Database name to connect to', + visibility: 'user-or-llm', + description: 'Database name to connect to (e.g., "neo4j", "movies", "social")', }, username: { type: 'string', @@ -49,13 +49,15 @@ export const createTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Cypher CREATE statement to execute', + description: + 'Cypher CREATE statement to execute (e.g., "CREATE (n:Person {name: $name, age: $age})", "CREATE (a)-[:KNOWS]->(b)")', }, parameters: { type: 'object', required: false, visibility: 'user-or-llm', - description: 'Parameters for the Cypher query as a JSON object', + description: + 'Parameters for the Cypher query as a JSON object (e.g., {"name": "Alice", "age": 30})', }, }, diff --git a/apps/sim/tools/neo4j/delete.ts b/apps/sim/tools/neo4j/delete.ts index c745e26bf..96d844193 100644 --- a/apps/sim/tools/neo4j/delete.ts +++ b/apps/sim/tools/neo4j/delete.ts @@ -24,8 +24,8 @@ export const deleteTool: ToolConfig = { database: { type: 'string', required: true, - visibility: 'user-only', - description: 'Database name to connect to', + visibility: 'user-or-llm', + description: 'Database name to connect to (e.g., "neo4j", "movies", "social")', }, username: { type: 'string', @@ -49,13 +49,15 @@ export const deleteTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Cypher query with MATCH and DELETE/DETACH DELETE statements', + description: + 'Cypher query with MATCH and DELETE/DETACH DELETE statements (e.g., "MATCH (n:Person {name: $name}) DELETE n", "MATCH (n) DETACH DELETE n")', }, parameters: { type: 'object', required: false, visibility: 'user-or-llm', - description: 'Parameters for the Cypher query as a JSON object', + description: + 'Parameters for the Cypher query as a JSON object (e.g., {"name": "Alice", "id": 123})', }, detach: { type: 'boolean', diff --git a/apps/sim/tools/neo4j/execute.ts b/apps/sim/tools/neo4j/execute.ts index 2f67ef2c1..0f783ca40 100644 --- a/apps/sim/tools/neo4j/execute.ts +++ b/apps/sim/tools/neo4j/execute.ts @@ -23,8 +23,8 @@ export const executeTool: ToolConfig = { database: { type: 'string', required: true, - visibility: 'user-only', - description: 'Database name to connect to', + visibility: 'user-or-llm', + description: 'Database name to connect to (e.g., "neo4j", "movies", "social")', }, username: { type: 'string', @@ -48,13 +48,15 @@ export const executeTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Cypher query to execute (any valid Cypher statement)', + description: + 'Cypher query to execute (e.g., "CALL db.labels()", "MATCH (n) RETURN count(n)", "CREATE INDEX FOR (n:Person) ON (n.name)")', }, parameters: { type: 'object', required: false, visibility: 'user-or-llm', - description: 'Parameters for the Cypher query as a JSON object', + description: + 'Parameters for the Cypher query as a JSON object (e.g., {"name": "Alice", "limit": 100})', }, }, diff --git a/apps/sim/tools/neo4j/introspect.ts b/apps/sim/tools/neo4j/introspect.ts index fbc9cff22..b1390a2a3 100644 --- a/apps/sim/tools/neo4j/introspect.ts +++ b/apps/sim/tools/neo4j/introspect.ts @@ -24,8 +24,8 @@ export const introspectTool: ToolConfig = { database: { type: 'string', required: true, - visibility: 'user-only', - description: 'Database name to connect to', + visibility: 'user-or-llm', + description: 'Database name to connect to (e.g., "neo4j", "movies", "social")', }, username: { type: 'string', @@ -49,13 +49,15 @@ export const mergeTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Cypher MERGE statement to execute', + description: + 'Cypher MERGE statement to execute (e.g., "MERGE (n:Person {name: $name}) ON CREATE SET n.created = timestamp()", "MERGE (a)-[r:KNOWS]->(b)")', }, parameters: { type: 'object', required: false, visibility: 'user-or-llm', - description: 'Parameters for the Cypher query as a JSON object', + description: + 'Parameters for the Cypher query as a JSON object (e.g., {"name": "Alice", "email": "alice@example.com"})', }, }, diff --git a/apps/sim/tools/neo4j/query.ts b/apps/sim/tools/neo4j/query.ts index 54ee141e7..fd58d87e9 100644 --- a/apps/sim/tools/neo4j/query.ts +++ b/apps/sim/tools/neo4j/query.ts @@ -24,8 +24,8 @@ export const queryTool: ToolConfig = { database: { type: 'string', required: true, - visibility: 'user-only', - description: 'Database name to connect to', + visibility: 'user-or-llm', + description: 'Database name to connect to (e.g., "neo4j", "movies", "social")', }, username: { type: 'string', @@ -49,7 +49,8 @@ export const queryTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Cypher query to execute (typically MATCH statements)', + description: + 'Cypher query to execute (e.g., "MATCH (n:Person) RETURN n LIMIT 10", "MATCH (a)-[r]->(b) WHERE a.name = $name RETURN a, r, b")', }, parameters: { type: 'object', diff --git a/apps/sim/tools/neo4j/update.ts b/apps/sim/tools/neo4j/update.ts index 0482e351e..9fb069ccc 100644 --- a/apps/sim/tools/neo4j/update.ts +++ b/apps/sim/tools/neo4j/update.ts @@ -24,8 +24,8 @@ export const updateTool: ToolConfig = { database: { type: 'string', required: true, - visibility: 'user-only', - description: 'Database name to connect to', + visibility: 'user-or-llm', + description: 'Database name to connect to (e.g., "neo4j", "movies", "social")', }, username: { type: 'string', @@ -49,13 +49,15 @@ export const updateTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Cypher query with MATCH and SET statements to update properties', + description: + 'Cypher query with MATCH and SET statements to update properties (e.g., "MATCH (n:Person {name: $name}) SET n.age = $age", "MATCH (n) WHERE n.id = $id SET n += $props")', }, parameters: { type: 'object', required: false, visibility: 'user-or-llm', - description: 'Parameters for the Cypher query as a JSON object', + description: + 'Parameters for the Cypher query as a JSON object (e.g., {"name": "Alice", "age": 31, "props": {"city": "NYC"}})', }, }, diff --git a/apps/sim/tools/notion/create_page.ts b/apps/sim/tools/notion/create_page.ts index c596ed2ec..409e48f6d 100644 --- a/apps/sim/tools/notion/create_page.ts +++ b/apps/sim/tools/notion/create_page.ts @@ -23,8 +23,8 @@ export const notionCreatePageTool: ToolConfig = { pageId: { type: 'string', required: true, - visibility: 'user-only', - description: 'The ID of the Notion page to read', + visibility: 'user-or-llm', + description: 'The UUID of the Notion page to read', }, }, diff --git a/apps/sim/tools/notion/read_database.ts b/apps/sim/tools/notion/read_database.ts index 47a4f4d73..6db7d8413 100644 --- a/apps/sim/tools/notion/read_database.ts +++ b/apps/sim/tools/notion/read_database.ts @@ -28,8 +28,8 @@ export const notionReadDatabaseTool: ToolConfig = query: { type: 'string', required: false, - visibility: 'user-only', - description: 'Search terms (leave empty to get all pages)', + visibility: 'user-or-llm', + description: 'Search terms to find pages and databases (leave empty to get all pages)', }, filterType: { type: 'string', required: false, - visibility: 'user-only', - description: 'Filter by object type: page, database, or leave empty for all', + visibility: 'user-or-llm', + description: 'Filter by object type: "page", "database", or leave empty for all', }, pageSize: { type: 'number', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Number of results to return (default: 100, max: 100)', }, }, diff --git a/apps/sim/tools/notion/update_page.ts b/apps/sim/tools/notion/update_page.ts index 28d20cd5d..3babd475a 100644 --- a/apps/sim/tools/notion/update_page.ts +++ b/apps/sim/tools/notion/update_page.ts @@ -23,8 +23,8 @@ export const notionUpdatePageTool: ToolConfig = { pageId: { type: 'string', required: true, - visibility: 'user-only', - description: 'The ID of the Notion page to append content to', + visibility: 'user-or-llm', + description: 'The UUID of the Notion page to append content to', }, content: { type: 'string', diff --git a/apps/sim/tools/onedrive/create_folder.ts b/apps/sim/tools/onedrive/create_folder.ts index f30f7351d..1aa799084 100644 --- a/apps/sim/tools/onedrive/create_folder.ts +++ b/apps/sim/tools/onedrive/create_folder.ts @@ -23,13 +23,14 @@ export const createFolderTool: ToolConfig type: 'string', required: true, visibility: 'user-or-llm', - description: 'The ID of the file or folder to delete', + description: + 'The ID of the file or folder to delete (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M")', }, }, diff --git a/apps/sim/tools/onedrive/download.ts b/apps/sim/tools/onedrive/download.ts index fb419151d..275a4bb0d 100644 --- a/apps/sim/tools/onedrive/download.ts +++ b/apps/sim/tools/onedrive/download.ts @@ -25,14 +25,14 @@ export const downloadTool: ToolConfig = { folderSelector: { type: 'string', required: false, - visibility: 'user-only', - description: 'Select the folder to list files from', + visibility: 'user-or-llm', + description: 'Folder ID to list files from (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M")', }, manualFolderId: { type: 'string', @@ -39,13 +39,13 @@ export const listTool: ToolConfig = { type: 'string', required: false, visibility: 'user-or-llm', - description: 'A query to filter the files', + description: 'Filter files by name prefix (e.g., "report", "invoice_2024")', }, pageSize: { type: 'number', required: false, - visibility: 'user-only', - description: 'The number of files to return', + visibility: 'user-or-llm', + description: 'Maximum number of files to return (e.g., 10, 50, 100)', }, }, diff --git a/apps/sim/tools/onedrive/upload.ts b/apps/sim/tools/onedrive/upload.ts index 2d660ad6d..32bd1357e 100644 --- a/apps/sim/tools/onedrive/upload.ts +++ b/apps/sim/tools/onedrive/upload.ts @@ -26,7 +26,7 @@ export const uploadTool: ToolConfig type: 'string', required: true, visibility: 'user-or-llm', - description: 'The name of the file to upload', + description: 'The name of the file to upload (e.g., "report.pdf", "data.xlsx")', }, file: { type: 'file', @@ -50,8 +50,8 @@ export const uploadTool: ToolConfig folderSelector: { type: 'string', required: false, - visibility: 'user-only', - description: 'Select the folder to upload the file to', + visibility: 'user-or-llm', + description: 'Folder ID to upload the file to (e.g., "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36M")', }, manualFolderId: { type: 'string', diff --git a/apps/sim/tools/outlook/forward.ts b/apps/sim/tools/outlook/forward.ts index 47d3a0dba..ea0f5625f 100644 --- a/apps/sim/tools/outlook/forward.ts +++ b/apps/sim/tools/outlook/forward.ts @@ -28,7 +28,7 @@ export const outlookForwardTool: ToolConfig folder: { type: 'string', required: false, - visibility: 'user-only', - description: 'Folder ID to read emails from (default: Inbox)', + visibility: 'user-or-llm', + description: 'Folder ID to read emails from (e.g., "Inbox", "Drafts", or a folder ID)', }, maxResults: { type: 'number', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Maximum number of emails to retrieve (default: 1, max: 10)', }, includeAttachments: { type: 'boolean', required: false, - visibility: 'user-only', - description: 'Download and include email attachments', + visibility: 'user-or-llm', + description: 'Whether to download and include email attachments', }, }, diff --git a/apps/sim/tools/outlook/send.ts b/apps/sim/tools/outlook/send.ts index 731d866ef..f768f45b4 100644 --- a/apps/sim/tools/outlook/send.ts +++ b/apps/sim/tools/outlook/send.ts @@ -22,8 +22,8 @@ export const outlookSendTool: ToolConfig to: { type: 'string', required: true, - visibility: 'user-only', - description: 'Recipient email address', + visibility: 'user-or-llm', + description: 'Recipient email address (comma-separated for multiple recipients)', }, subject: { type: 'string', diff --git a/apps/sim/tools/perplexity/chat.ts b/apps/sim/tools/perplexity/chat.ts index 6edc08479..5985c3354 100644 --- a/apps/sim/tools/perplexity/chat.ts +++ b/apps/sim/tools/perplexity/chat.ts @@ -23,20 +23,22 @@ export const chatTool: ToolConfig model: { type: 'string', required: true, - visibility: 'user-only', - description: 'Model to use for chat completions (e.g., sonar, mistral)', + visibility: 'user-or-llm', + description: + 'Model to use for chat completions (e.g., "sonar", "sonar-pro", "sonar-reasoning")', }, max_tokens: { type: 'number', required: false, - visibility: 'user-only', - description: 'Maximum number of tokens to generate', + visibility: 'user-or-llm', + description: 'Maximum number of tokens to generate (e.g., 1024, 2048, 4096)', }, temperature: { type: 'number', required: false, - visibility: 'user-only', - description: 'Sampling temperature between 0 and 1', + visibility: 'user-or-llm', + description: + 'Sampling temperature between 0 and 1 (e.g., 0.0 for deterministic, 0.7 for creative)', }, apiKey: { type: 'string', diff --git a/apps/sim/tools/perplexity/search.ts b/apps/sim/tools/perplexity/search.ts index e1c4ab5de..bdc4b55f6 100644 --- a/apps/sim/tools/perplexity/search.ts +++ b/apps/sim/tools/perplexity/search.ts @@ -24,8 +24,9 @@ export const searchTool: ToolConfig = { indexHost: { type: 'string', required: true, - visibility: 'user-only', - description: 'Full Pinecone index host URL', + visibility: 'user-or-llm', + description: 'Full Pinecone index host URL (e.g., "https://my-index-abc123.svc.pinecone.io")', }, ids: { type: 'array', required: true, - visibility: 'user-only', - description: 'Array of vector IDs to fetch', + visibility: 'user-or-llm', + description: 'Array of vector IDs to fetch (e.g., ["vec-001", "vec-002"])', }, namespace: { type: 'string', required: false, - visibility: 'user-only', - description: 'Namespace to fetch vectors from', + visibility: 'user-or-llm', + description: 'Namespace to fetch vectors from (e.g., "documents", "embeddings")', }, apiKey: { type: 'string', diff --git a/apps/sim/tools/pinecone/search_text.ts b/apps/sim/tools/pinecone/search_text.ts index 4ef6bb728..d588d5a24 100644 --- a/apps/sim/tools/pinecone/search_text.ts +++ b/apps/sim/tools/pinecone/search_text.ts @@ -15,14 +15,14 @@ export const searchTextTool: ToolConfig = { projectId: { type: 'string', required: true, - visibility: 'user-only', - description: 'PostHog Project ID', + visibility: 'user-or-llm', + description: 'PostHog Project ID (e.g., "12345" or project UUID)', }, query: { type: 'string', diff --git a/apps/sim/tools/posthog/update_event_definition.ts b/apps/sim/tools/posthog/update_event_definition.ts index 8f3a5593c..34ad2fe13 100644 --- a/apps/sim/tools/posthog/update_event_definition.ts +++ b/apps/sim/tools/posthog/update_event_definition.ts @@ -46,8 +46,8 @@ export const updateEventDefinitionTool: ToolConfig< projectId: { type: 'string', required: true, - visibility: 'user-only', - description: 'PostHog Project ID', + visibility: 'user-or-llm', + description: 'PostHog Project ID (e.g., "12345" or project UUID)', }, eventDefinitionId: { type: 'string', diff --git a/apps/sim/tools/posthog/update_feature_flag.ts b/apps/sim/tools/posthog/update_feature_flag.ts index e6b2d4b7d..caef9db2c 100644 --- a/apps/sim/tools/posthog/update_feature_flag.ts +++ b/apps/sim/tools/posthog/update_feature_flag.ts @@ -43,13 +43,13 @@ export const updateFeatureFlagTool: ToolConfig = { type: 'string', required: true, visibility: 'user-only', - description: 'Qdrant base URL', + description: 'Qdrant instance URL (e.g., https://your-cluster.qdrant.io)', }, apiKey: { type: 'string', required: false, visibility: 'user-only', - description: 'Qdrant API key (optional)', + description: 'Qdrant API key for authentication', }, collection: { type: 'string', required: true, - visibility: 'user-only', - description: 'Collection name', + visibility: 'user-or-llm', + description: 'Collection name to fetch from (e.g., "my_collection")', }, ids: { type: 'array', required: true, - visibility: 'user-only', - description: 'Array of point IDs to fetch', + visibility: 'user-or-llm', + description: 'Array of point IDs to fetch (e.g., ["id1", "id2"] or [1, 2])', }, fetch_return_data: { type: 'string', diff --git a/apps/sim/tools/qdrant/search_vector.ts b/apps/sim/tools/qdrant/search_vector.ts index ca0aa9062..cf4dd4643 100644 --- a/apps/sim/tools/qdrant/search_vector.ts +++ b/apps/sim/tools/qdrant/search_vector.ts @@ -16,37 +16,38 @@ export const searchVectorTool: ToolConfig = type: 'string', required: true, visibility: 'user-only', - description: 'Qdrant base URL', + description: 'Qdrant instance URL (e.g., https://your-cluster.qdrant.io)', }, apiKey: { type: 'string', required: false, visibility: 'user-only', - description: 'Qdrant API key (optional)', + description: 'Qdrant API key for authentication', }, collection: { type: 'string', required: true, - visibility: 'user-only', - description: 'Collection name', + visibility: 'user-or-llm', + description: 'Collection name to search (e.g., "my_collection")', }, vector: { type: 'array', required: true, - visibility: 'user-only', - description: 'Vector to search for', + visibility: 'user-or-llm', + description: 'Query vector for similarity search (e.g., [0.1, 0.2, 0.3, ...])', }, limit: { type: 'number', required: false, - visibility: 'user-only', - description: 'Number of results to return', + visibility: 'user-or-llm', + description: 'Maximum number of results to return (e.g., 10)', }, filter: { type: 'object', required: false, - visibility: 'user-only', - description: 'Filter to apply to the search', + visibility: 'user-or-llm', + description: + 'Qdrant filter object (e.g., {"must": [{"key": "field", "match": {"value": "val"}}]})', }, search_return_data: { type: 'string', diff --git a/apps/sim/tools/qdrant/upsert_points.ts b/apps/sim/tools/qdrant/upsert_points.ts index 2d9a7b310..e97698e1f 100644 --- a/apps/sim/tools/qdrant/upsert_points.ts +++ b/apps/sim/tools/qdrant/upsert_points.ts @@ -16,19 +16,19 @@ export const upsertPointsTool: ToolConfig = type: 'string', required: true, visibility: 'user-only', - description: 'Qdrant base URL', + description: 'Qdrant instance URL (e.g., https://your-cluster.qdrant.io)', }, apiKey: { type: 'string', required: false, visibility: 'user-only', - description: 'Qdrant API key (optional)', + description: 'Qdrant API key for authentication', }, collection: { type: 'string', required: true, - visibility: 'user-only', - description: 'Collection name', + visibility: 'user-or-llm', + description: 'Collection name for upsert (e.g., "my_collection")', }, points: { type: 'array', diff --git a/apps/sim/tools/rds/delete.ts b/apps/sim/tools/rds/delete.ts index a46d97c50..8d6322fa6 100644 --- a/apps/sim/tools/rds/delete.ts +++ b/apps/sim/tools/rds/delete.ts @@ -29,8 +29,9 @@ export const deleteTool: ToolConfig = { resourceArn: { type: 'string', required: true, - visibility: 'user-only', - description: 'ARN of the Aurora DB cluster', + visibility: 'user-or-llm', + description: + 'ARN of the Aurora DB cluster (e.g., arn:aws:rds:us-east-1:123456789012:cluster:my-cluster)', }, secretArn: { type: 'string', @@ -41,8 +42,8 @@ export const deleteTool: ToolConfig = { database: { type: 'string', required: false, - visibility: 'user-only', - description: 'Database name (optional)', + visibility: 'user-or-llm', + description: 'Database name to connect to (e.g., mydb, production_db)', }, table: { type: 'string', diff --git a/apps/sim/tools/rds/execute.ts b/apps/sim/tools/rds/execute.ts index b297a4838..afc147d3b 100644 --- a/apps/sim/tools/rds/execute.ts +++ b/apps/sim/tools/rds/execute.ts @@ -29,8 +29,9 @@ export const executeTool: ToolConfig = { resourceArn: { type: 'string', required: true, - visibility: 'user-only', - description: 'ARN of the Aurora DB cluster', + visibility: 'user-or-llm', + description: + 'ARN of the Aurora DB cluster (e.g., arn:aws:rds:us-east-1:123456789012:cluster:my-cluster)', }, secretArn: { type: 'string', @@ -41,14 +42,15 @@ export const executeTool: ToolConfig = { database: { type: 'string', required: false, - visibility: 'user-only', - description: 'Database name (optional)', + visibility: 'user-or-llm', + description: 'Database name to connect to (e.g., mydb, production_db)', }, query: { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Raw SQL query to execute', + description: + 'Raw SQL query to execute (e.g., CREATE TABLE users (id SERIAL PRIMARY KEY, name VARCHAR(255)))', }, }, diff --git a/apps/sim/tools/rds/insert.ts b/apps/sim/tools/rds/insert.ts index fa3bab156..94d53dcc4 100644 --- a/apps/sim/tools/rds/insert.ts +++ b/apps/sim/tools/rds/insert.ts @@ -29,8 +29,9 @@ export const insertTool: ToolConfig = { resourceArn: { type: 'string', required: true, - visibility: 'user-only', - description: 'ARN of the Aurora DB cluster', + visibility: 'user-or-llm', + description: + 'ARN of the Aurora DB cluster (e.g., arn:aws:rds:us-east-1:123456789012:cluster:my-cluster)', }, secretArn: { type: 'string', @@ -41,8 +42,8 @@ export const insertTool: ToolConfig = { database: { type: 'string', required: false, - visibility: 'user-only', - description: 'Database name (optional)', + visibility: 'user-or-llm', + description: 'Database name to connect to (e.g., mydb, production_db)', }, table: { type: 'string', diff --git a/apps/sim/tools/rds/introspect.ts b/apps/sim/tools/rds/introspect.ts index b73474d73..3c0717306 100644 --- a/apps/sim/tools/rds/introspect.ts +++ b/apps/sim/tools/rds/introspect.ts @@ -30,8 +30,9 @@ export const introspectTool: ToolConfig = { resourceArn: { type: 'string', required: true, - visibility: 'user-only', - description: 'ARN of the Aurora DB cluster', + visibility: 'user-or-llm', + description: + 'ARN of the Aurora DB cluster (e.g., arn:aws:rds:us-east-1:123456789012:cluster:my-cluster)', }, secretArn: { type: 'string', @@ -41,14 +42,14 @@ export const queryTool: ToolConfig = { database: { type: 'string', required: false, - visibility: 'user-only', - description: 'Database name (optional)', + visibility: 'user-or-llm', + description: 'Database name to connect to (e.g., mydb, production_db)', }, query: { type: 'string', required: true, visibility: 'user-or-llm', - description: 'SQL SELECT query to execute', + description: 'SQL SELECT query to execute (e.g., SELECT * FROM users WHERE status = :status)', }, }, diff --git a/apps/sim/tools/rds/update.ts b/apps/sim/tools/rds/update.ts index 67cb0ba4d..94c9abf12 100644 --- a/apps/sim/tools/rds/update.ts +++ b/apps/sim/tools/rds/update.ts @@ -29,8 +29,9 @@ export const updateTool: ToolConfig = { resourceArn: { type: 'string', required: true, - visibility: 'user-only', - description: 'ARN of the Aurora DB cluster', + visibility: 'user-or-llm', + description: + 'ARN of the Aurora DB cluster (e.g., arn:aws:rds:us-east-1:123456789012:cluster:my-cluster)', }, secretArn: { type: 'string', @@ -41,8 +42,8 @@ export const updateTool: ToolConfig = { database: { type: 'string', required: false, - visibility: 'user-only', - description: 'Database name (optional)', + visibility: 'user-or-llm', + description: 'Database name to connect to (e.g., mydb, production_db)', }, table: { type: 'string', diff --git a/apps/sim/tools/reddit/delete.ts b/apps/sim/tools/reddit/delete.ts index 6881aa7f6..2f296517d 100644 --- a/apps/sim/tools/reddit/delete.ts +++ b/apps/sim/tools/reddit/delete.ts @@ -23,7 +23,7 @@ export const deleteTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Thing fullname to delete (e.g., t3_xxxxx for post, t1_xxxxx for comment)', + description: 'Thing fullname to delete (e.g., "t3_abc123" for post, "t1_def456" for comment)', }, }, diff --git a/apps/sim/tools/reddit/edit.ts b/apps/sim/tools/reddit/edit.ts index 0287dd0d1..92663e018 100644 --- a/apps/sim/tools/reddit/edit.ts +++ b/apps/sim/tools/reddit/edit.ts @@ -23,13 +23,13 @@ export const editTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Thing fullname to edit (e.g., t3_xxxxx for post, t1_xxxxx for comment)', + description: 'Thing fullname to edit (e.g., "t3_abc123" for post, "t1_def456" for comment)', }, text: { type: 'string', required: true, visibility: 'user-or-llm', - description: 'New text content in markdown format', + description: 'New text content in markdown format (e.g., "Updated **content** here")', }, }, diff --git a/apps/sim/tools/reddit/get_comments.ts b/apps/sim/tools/reddit/get_comments.ts index 63cf66277..83bbfe563 100644 --- a/apps/sim/tools/reddit/get_comments.ts +++ b/apps/sim/tools/reddit/get_comments.ts @@ -23,14 +23,14 @@ export const getCommentsTool: ToolConfig = type: 'string', required: true, visibility: 'user-or-llm', - description: 'The name of the subreddit to fetch posts from (without the r/ prefix)', + description: 'The subreddit to fetch posts from (e.g., "technology", "news")', }, sort: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'Sort method for posts: "hot", "new", "top", or "rising" (default: "hot")', + description: 'Sort method for posts (e.g., "hot", "new", "top", "rising"). Default: "hot"', }, limit: { type: 'number', required: false, - visibility: 'user-only', - description: 'Maximum number of posts to return (default: 10, max: 100)', + visibility: 'user-or-llm', + description: 'Maximum number of posts to return (e.g., 25). Default: 10, max: 100', }, time: { type: 'string', diff --git a/apps/sim/tools/reddit/hot_posts.ts b/apps/sim/tools/reddit/hot_posts.ts index 62ae1b11f..0dfc486ec 100644 --- a/apps/sim/tools/reddit/hot_posts.ts +++ b/apps/sim/tools/reddit/hot_posts.ts @@ -30,13 +30,13 @@ export const hotPostsTool: ToolConfig = type: 'string', required: true, visibility: 'user-or-llm', - description: 'The name of the subreddit to fetch posts from (without the r/ prefix)', + description: 'The subreddit to fetch hot posts from (e.g., "technology", "news")', }, limit: { type: 'number', required: false, - visibility: 'user-only', - description: 'Maximum number of posts to return (default: 10, max: 100)', + visibility: 'user-or-llm', + description: 'Maximum number of posts to return (e.g., 25). Default: 10, max: 100', }, }, diff --git a/apps/sim/tools/reddit/reply.ts b/apps/sim/tools/reddit/reply.ts index e8e6dabc1..d22fceb07 100644 --- a/apps/sim/tools/reddit/reply.ts +++ b/apps/sim/tools/reddit/reply.ts @@ -23,13 +23,14 @@ export const replyTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Thing fullname to reply to (e.g., t3_xxxxx for post, t1_xxxxx for comment)', + description: + 'Thing fullname to reply to (e.g., "t3_abc123" for post, "t1_def456" for comment)', }, text: { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Comment text in markdown format', + description: 'Comment text in markdown format (e.g., "Great post! Here is my **reply**")', }, }, diff --git a/apps/sim/tools/reddit/save.ts b/apps/sim/tools/reddit/save.ts index f6104ad3e..8ebc45a38 100644 --- a/apps/sim/tools/reddit/save.ts +++ b/apps/sim/tools/reddit/save.ts @@ -23,7 +23,7 @@ export const saveTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Thing fullname to save (e.g., t3_xxxxx for post, t1_xxxxx for comment)', + description: 'Thing fullname to save (e.g., "t3_abc123" for post, "t1_def456" for comment)', }, category: { type: 'string', @@ -117,7 +117,7 @@ export const unsaveTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Thing fullname to unsave (e.g., t3_xxxxx for post, t1_xxxxx for comment)', + description: 'Thing fullname to unsave (e.g., "t3_abc123" for post, "t1_def456" for comment)', }, }, diff --git a/apps/sim/tools/reddit/search.ts b/apps/sim/tools/reddit/search.ts index 05f6c1361..c2bcafebe 100644 --- a/apps/sim/tools/reddit/search.ts +++ b/apps/sim/tools/reddit/search.ts @@ -24,20 +24,21 @@ export const searchTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'The name of the subreddit to search in (without the r/ prefix)', + description: 'The subreddit to search in (e.g., "technology", "programming")', }, query: { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Search query text', + description: + 'Search query text (e.g., "artificial intelligence", "machine learning tutorial")', }, sort: { type: 'string', required: false, visibility: 'user-or-llm', description: - 'Sort method for search results: "relevance", "hot", "top", "new", or "comments" (default: "relevance")', + 'Sort method for search results (e.g., "relevance", "hot", "top", "new", "comments"). Default: "relevance"', }, time: { type: 'string', @@ -49,8 +50,8 @@ export const searchTool: ToolConfig = { limit: { type: 'number', required: false, - visibility: 'user-only', - description: 'Maximum number of posts to return (default: 10, max: 100)', + visibility: 'user-or-llm', + description: 'Maximum number of posts to return (e.g., 25). Default: 10, max: 100', }, restrict_sr: { type: 'boolean', diff --git a/apps/sim/tools/reddit/submit_post.ts b/apps/sim/tools/reddit/submit_post.ts index 9fc427314..e08bae50a 100644 --- a/apps/sim/tools/reddit/submit_post.ts +++ b/apps/sim/tools/reddit/submit_post.ts @@ -24,19 +24,21 @@ export const submitPostTool: ToolConfig type: 'string', required: true, visibility: 'user-or-llm', - description: 'The name of the subreddit to post to (without the r/ prefix)', + description: 'The subreddit to post to (e.g., "technology", "programming")', }, title: { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Title of the submission (max 300 characters)', + description: + 'Title of the submission (e.g., "Check out this new AI tool"). Max 300 characters', }, text: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'Text content for a self post (markdown supported)', + description: + 'Text content for a self post in markdown format (e.g., "This is the **body** of my post")', }, url: { type: 'string', diff --git a/apps/sim/tools/reddit/subscribe.ts b/apps/sim/tools/reddit/subscribe.ts index f15c501fe..e96e30716 100644 --- a/apps/sim/tools/reddit/subscribe.ts +++ b/apps/sim/tools/reddit/subscribe.ts @@ -24,7 +24,8 @@ export const subscribeTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Thing fullname to vote on (e.g., t3_xxxxx for post, t1_xxxxx for comment)', + description: + 'Thing fullname to vote on (e.g., "t3_abc123" for post, "t1_def456" for comment)', }, dir: { type: 'number', diff --git a/apps/sim/tools/resend/send.ts b/apps/sim/tools/resend/send.ts index 462e2faa8..d70305c53 100644 --- a/apps/sim/tools/resend/send.ts +++ b/apps/sim/tools/resend/send.ts @@ -11,32 +11,35 @@ export const mailSendTool: ToolConfig = { fromAddress: { type: 'string', required: true, - visibility: 'user-only', - description: 'Email address to send from', + visibility: 'user-or-llm', + description: + 'Email address to send from (e.g., "sender@example.com" or "Sender Name ")', }, to: { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Recipient email address', + description: + 'Recipient email address (e.g., "recipient@example.com" or "Recipient Name ")', }, subject: { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Email subject', + description: 'Email subject line', }, body: { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Email body content', + description: 'Email body content (plain text or HTML based on contentType)', }, contentType: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'Content type for the email body (text or html)', + description: + 'Content type for the email body: "text" for plain text or "html" for HTML content', }, resendApiKey: { type: 'string', diff --git a/apps/sim/tools/s3/copy_object.ts b/apps/sim/tools/s3/copy_object.ts index 339106612..9b3c6d526 100644 --- a/apps/sim/tools/s3/copy_object.ts +++ b/apps/sim/tools/s3/copy_object.ts @@ -28,26 +28,26 @@ export const s3CopyObjectTool: ToolConfig = { sourceBucket: { type: 'string', required: true, - visibility: 'user-only', - description: 'Source bucket name', + visibility: 'user-or-llm', + description: 'Source bucket name (e.g., my-bucket)', }, sourceKey: { type: 'string', required: true, - visibility: 'user-only', - description: 'Source object key/path', + visibility: 'user-or-llm', + description: 'Source object key/path (e.g., folder/file.txt)', }, destinationBucket: { type: 'string', required: true, - visibility: 'user-only', - description: 'Destination bucket name', + visibility: 'user-or-llm', + description: 'Destination bucket name (e.g., my-other-bucket)', }, destinationKey: { type: 'string', required: true, - visibility: 'user-only', - description: 'Destination object key/path', + visibility: 'user-or-llm', + description: 'Destination object key/path (e.g., backup/file.txt)', }, acl: { type: 'string', diff --git a/apps/sim/tools/s3/delete_object.ts b/apps/sim/tools/s3/delete_object.ts index 17f94661d..4f7fec8eb 100644 --- a/apps/sim/tools/s3/delete_object.ts +++ b/apps/sim/tools/s3/delete_object.ts @@ -28,14 +28,14 @@ export const s3DeleteObjectTool: ToolConfig = { bucketName: { type: 'string', required: true, - visibility: 'user-only', - description: 'S3 bucket name', + visibility: 'user-or-llm', + description: 'S3 bucket name (e.g., my-bucket)', }, objectKey: { type: 'string', required: true, - visibility: 'user-only', - description: 'Object key/path to delete', + visibility: 'user-or-llm', + description: 'Object key/path to delete (e.g., folder/file.txt)', }, }, diff --git a/apps/sim/tools/s3/get_object.ts b/apps/sim/tools/s3/get_object.ts index d7b89b359..89f2f4a7b 100644 --- a/apps/sim/tools/s3/get_object.ts +++ b/apps/sim/tools/s3/get_object.ts @@ -29,8 +29,8 @@ export const s3GetObjectTool: ToolConfig = { s3Uri: { type: 'string', required: true, - visibility: 'user-only', - description: 'S3 Object URL', + visibility: 'user-or-llm', + description: 'S3 Object URL (e.g., https://bucket.s3.region.amazonaws.com/path/to/file)', }, }, diff --git a/apps/sim/tools/s3/list_objects.ts b/apps/sim/tools/s3/list_objects.ts index cc5e9a2ae..9d296d9b4 100644 --- a/apps/sim/tools/s3/list_objects.ts +++ b/apps/sim/tools/s3/list_objects.ts @@ -28,26 +28,26 @@ export const s3ListObjectsTool: ToolConfig = { bucketName: { type: 'string', required: true, - visibility: 'user-only', - description: 'S3 bucket name', + visibility: 'user-or-llm', + description: 'S3 bucket name (e.g., my-bucket)', }, prefix: { type: 'string', required: false, - visibility: 'user-only', - description: 'Prefix to filter objects (e.g., folder/)', + visibility: 'user-or-llm', + description: 'Prefix to filter objects (e.g., folder/, images/2024/)', }, maxKeys: { type: 'number', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Maximum number of objects to return (default: 1000)', }, continuationToken: { type: 'string', required: false, - visibility: 'user-only', - description: 'Token for pagination', + visibility: 'user-or-llm', + description: 'Token for pagination from previous list response', }, }, diff --git a/apps/sim/tools/s3/put_object.ts b/apps/sim/tools/s3/put_object.ts index 92ffdf07d..c15f8f4d2 100644 --- a/apps/sim/tools/s3/put_object.ts +++ b/apps/sim/tools/s3/put_object.ts @@ -28,13 +28,13 @@ export const s3PutObjectTool: ToolConfig = { bucketName: { type: 'string', required: true, - visibility: 'user-only', - description: 'S3 bucket name', + visibility: 'user-or-llm', + description: 'S3 bucket name (e.g., my-bucket)', }, objectKey: { type: 'string', required: true, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Object key/path in S3 (e.g., folder/filename.ext)', }, file: { diff --git a/apps/sim/tools/salesforce/create_account.ts b/apps/sim/tools/salesforce/create_account.ts index b9be98ade..275375f53 100644 --- a/apps/sim/tools/salesforce/create_account.ts +++ b/apps/sim/tools/salesforce/create_account.ts @@ -41,80 +41,80 @@ export const salesforceCreateAccountTool: ToolConfig< name: { type: 'string', required: true, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Account name (required)', }, type: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Account type (e.g., Customer, Partner, Prospect)', }, industry: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Industry (e.g., Technology, Healthcare, Finance)', }, phone: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Phone number', }, website: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Website URL', }, billingStreet: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Billing street address', }, billingCity: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Billing city', }, billingState: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Billing state/province', }, billingPostalCode: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Billing postal code', }, billingCountry: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Billing country', }, description: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Account description', }, annualRevenue: { type: 'string', required: false, - visibility: 'user-only', - description: 'Annual revenue (number)', + visibility: 'user-or-llm', + description: 'Annual revenue as a number', }, numberOfEmployees: { type: 'string', required: false, - visibility: 'user-only', - description: 'Number of employees (number)', + visibility: 'user-or-llm', + description: 'Number of employees as an integer', }, }, diff --git a/apps/sim/tools/salesforce/create_case.ts b/apps/sim/tools/salesforce/create_case.ts index 0c9c85748..33e60d0da 100644 --- a/apps/sim/tools/salesforce/create_case.ts +++ b/apps/sim/tools/salesforce/create_case.ts @@ -39,44 +39,44 @@ export const salesforceCreateCaseTool: ToolConfig< subject: { type: 'string', required: true, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Case subject (required)', }, status: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Status (e.g., New, Working, Escalated)', }, priority: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Priority (e.g., Low, Medium, High)', }, origin: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Origin (e.g., Phone, Email, Web)', }, contactId: { type: 'string', required: false, - visibility: 'user-only', - description: 'Contact ID', + visibility: 'user-or-llm', + description: 'Salesforce Contact ID (18-character string starting with 003)', }, accountId: { type: 'string', required: false, - visibility: 'user-only', - description: 'Account ID', + visibility: 'user-or-llm', + description: 'Salesforce Account ID (18-character string starting with 001)', }, description: { type: 'string', required: false, - visibility: 'user-only', - description: 'Description', + visibility: 'user-or-llm', + description: 'Case description', }, }, diff --git a/apps/sim/tools/salesforce/create_contact.ts b/apps/sim/tools/salesforce/create_contact.ts index a8fffb0a5..01c8c4831 100644 --- a/apps/sim/tools/salesforce/create_contact.ts +++ b/apps/sim/tools/salesforce/create_contact.ts @@ -27,74 +27,74 @@ export const salesforceCreateContactTool: ToolConfig< lastName: { type: 'string', required: true, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Last name (required)', }, firstName: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'First name', }, email: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Email address', }, phone: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Phone number', }, accountId: { type: 'string', required: false, - visibility: 'user-only', - description: 'Account ID to associate contact with', + visibility: 'user-or-llm', + description: 'Salesforce Account ID (18-character string starting with 001)', }, - title: { type: 'string', required: false, visibility: 'user-only', description: 'Job title' }, + title: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Job title' }, department: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Department', }, mailingStreet: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Mailing street', }, mailingCity: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Mailing city', }, mailingState: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Mailing state', }, mailingPostalCode: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Mailing postal code', }, mailingCountry: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Mailing country', }, description: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Contact description', }, }, diff --git a/apps/sim/tools/salesforce/create_lead.ts b/apps/sim/tools/salesforce/create_lead.ts index d22815fa4..c6d0d4ed5 100644 --- a/apps/sim/tools/salesforce/create_lead.ts +++ b/apps/sim/tools/salesforce/create_lead.ts @@ -27,41 +27,51 @@ export const salesforceCreateLeadTool: ToolConfig< lastName: { type: 'string', required: true, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Last name (required)', }, company: { type: 'string', required: true, - visibility: 'user-only', - description: 'Company (required)', + visibility: 'user-or-llm', + description: 'Company name (required)', }, firstName: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'First name', }, - email: { type: 'string', required: false, visibility: 'user-only', description: 'Email' }, - phone: { type: 'string', required: false, visibility: 'user-only', description: 'Phone' }, + email: { + type: 'string', + required: false, + visibility: 'user-or-llm', + description: 'Email address', + }, + phone: { + type: 'string', + required: false, + visibility: 'user-or-llm', + description: 'Phone number', + }, status: { type: 'string', required: false, - visibility: 'user-only', - description: 'Lead status', + visibility: 'user-or-llm', + description: 'Lead status (e.g., Open, Working, Closed)', }, leadSource: { type: 'string', required: false, - visibility: 'user-only', - description: 'Lead source', + visibility: 'user-or-llm', + description: 'Lead source (e.g., Web, Referral, Campaign)', }, - title: { type: 'string', required: false, visibility: 'user-only', description: 'Title' }, + title: { type: 'string', required: false, visibility: 'user-or-llm', description: 'Job title' }, description: { type: 'string', required: false, - visibility: 'user-only', - description: 'Description', + visibility: 'user-or-llm', + description: 'Lead description', }, }, diff --git a/apps/sim/tools/salesforce/create_opportunity.ts b/apps/sim/tools/salesforce/create_opportunity.ts index eae79153c..a0d971cdc 100644 --- a/apps/sim/tools/salesforce/create_opportunity.ts +++ b/apps/sim/tools/salesforce/create_opportunity.ts @@ -27,44 +27,44 @@ export const salesforceCreateOpportunityTool: ToolConfig< name: { type: 'string', required: true, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Opportunity name (required)', }, stageName: { type: 'string', required: true, - visibility: 'user-only', - description: 'Stage name (required)', + visibility: 'user-or-llm', + description: 'Stage name (required, e.g., Prospecting, Qualification, Closed Won)', }, closeDate: { type: 'string', required: true, - visibility: 'user-only', - description: 'Close date YYYY-MM-DD (required)', + visibility: 'user-or-llm', + description: 'Close date in YYYY-MM-DD format (required)', }, accountId: { type: 'string', required: false, - visibility: 'user-only', - description: 'Account ID', + visibility: 'user-or-llm', + description: 'Salesforce Account ID (18-character string starting with 001)', }, amount: { type: 'string', required: false, - visibility: 'user-only', - description: 'Amount (number)', + visibility: 'user-or-llm', + description: 'Deal amount as a number', }, probability: { type: 'string', required: false, - visibility: 'user-only', - description: 'Probability (0-100)', + visibility: 'user-or-llm', + description: 'Win probability as integer (0-100)', }, description: { type: 'string', required: false, - visibility: 'user-only', - description: 'Description', + visibility: 'user-or-llm', + description: 'Opportunity description', }, }, diff --git a/apps/sim/tools/salesforce/create_task.ts b/apps/sim/tools/salesforce/create_task.ts index ff5fba44d..40286d0fc 100644 --- a/apps/sim/tools/salesforce/create_task.ts +++ b/apps/sim/tools/salesforce/create_task.ts @@ -39,44 +39,44 @@ export const salesforceCreateTaskTool: ToolConfig< subject: { type: 'string', required: true, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Task subject (required)', }, status: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Status (e.g., Not Started, In Progress, Completed)', }, priority: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Priority (e.g., Low, Normal, High)', }, activityDate: { type: 'string', required: false, - visibility: 'user-only', - description: 'Due date YYYY-MM-DD', + visibility: 'user-or-llm', + description: 'Due date in YYYY-MM-DD format', }, whoId: { type: 'string', required: false, - visibility: 'user-only', - description: 'Related Contact/Lead ID', + visibility: 'user-or-llm', + description: 'Related Contact ID (003...) or Lead ID (00Q...)', }, whatId: { type: 'string', required: false, - visibility: 'user-only', - description: 'Related Account/Opportunity ID', + visibility: 'user-or-llm', + description: 'Related Account ID (001...) or Opportunity ID (006...)', }, description: { type: 'string', required: false, - visibility: 'user-only', - description: 'Description', + visibility: 'user-or-llm', + description: 'Task description', }, }, diff --git a/apps/sim/tools/salesforce/delete_account.ts b/apps/sim/tools/salesforce/delete_account.ts index bdc7d6016..cb691bf56 100644 --- a/apps/sim/tools/salesforce/delete_account.ts +++ b/apps/sim/tools/salesforce/delete_account.ts @@ -41,8 +41,8 @@ export const salesforceDeleteAccountTool: ToolConfig< accountId: { type: 'string', required: true, - visibility: 'user-only', - description: 'Account ID to delete (required)', + visibility: 'user-or-llm', + description: 'Salesforce Account ID to delete (18-character string starting with 001)', }, }, diff --git a/apps/sim/tools/salesforce/delete_case.ts b/apps/sim/tools/salesforce/delete_case.ts index 94ed3179a..ca30065ec 100644 --- a/apps/sim/tools/salesforce/delete_case.ts +++ b/apps/sim/tools/salesforce/delete_case.ts @@ -39,8 +39,8 @@ export const salesforceDeleteCaseTool: ToolConfig< caseId: { type: 'string', required: true, - visibility: 'user-only', - description: 'Case ID (required)', + visibility: 'user-or-llm', + description: 'Salesforce Case ID to delete (18-character string starting with 500)', }, }, diff --git a/apps/sim/tools/salesforce/delete_contact.ts b/apps/sim/tools/salesforce/delete_contact.ts index df48afd2c..49d9026b8 100644 --- a/apps/sim/tools/salesforce/delete_contact.ts +++ b/apps/sim/tools/salesforce/delete_contact.ts @@ -27,8 +27,8 @@ export const salesforceDeleteContactTool: ToolConfig< contactId: { type: 'string', required: true, - visibility: 'user-only', - description: 'Contact ID to delete (required)', + visibility: 'user-or-llm', + description: 'Salesforce Contact ID to delete (18-character string starting with 003)', }, }, diff --git a/apps/sim/tools/salesforce/delete_lead.ts b/apps/sim/tools/salesforce/delete_lead.ts index 2a15011b1..e33822e64 100644 --- a/apps/sim/tools/salesforce/delete_lead.ts +++ b/apps/sim/tools/salesforce/delete_lead.ts @@ -27,8 +27,8 @@ export const salesforceDeleteLeadTool: ToolConfig< leadId: { type: 'string', required: true, - visibility: 'user-only', - description: 'Lead ID (required)', + visibility: 'user-or-llm', + description: 'Salesforce Lead ID to delete (18-character string starting with 00Q)', }, }, diff --git a/apps/sim/tools/salesforce/delete_opportunity.ts b/apps/sim/tools/salesforce/delete_opportunity.ts index a4b5bf9f0..98b136601 100644 --- a/apps/sim/tools/salesforce/delete_opportunity.ts +++ b/apps/sim/tools/salesforce/delete_opportunity.ts @@ -27,8 +27,8 @@ export const salesforceDeleteOpportunityTool: ToolConfig< opportunityId: { type: 'string', required: true, - visibility: 'user-only', - description: 'Opportunity ID (required)', + visibility: 'user-or-llm', + description: 'Salesforce Opportunity ID to delete (18-character string starting with 006)', }, }, diff --git a/apps/sim/tools/salesforce/delete_task.ts b/apps/sim/tools/salesforce/delete_task.ts index 862708fcd..061205529 100644 --- a/apps/sim/tools/salesforce/delete_task.ts +++ b/apps/sim/tools/salesforce/delete_task.ts @@ -39,8 +39,8 @@ export const salesforceDeleteTaskTool: ToolConfig< taskId: { type: 'string', required: true, - visibility: 'user-only', - description: 'Task ID (required)', + visibility: 'user-or-llm', + description: 'Salesforce Task ID to delete (18-character string starting with 00T)', }, }, diff --git a/apps/sim/tools/salesforce/describe_object.ts b/apps/sim/tools/salesforce/describe_object.ts index 95cdcb9a1..6c993706e 100644 --- a/apps/sim/tools/salesforce/describe_object.ts +++ b/apps/sim/tools/salesforce/describe_object.ts @@ -34,8 +34,8 @@ export const salesforceDescribeObjectTool: ToolConfig< objectName: { type: 'string', required: true, - visibility: 'user-only', - description: 'API name of the object (e.g., Account, Contact, Lead, Custom_Object__c)', + visibility: 'user-or-llm', + description: 'Salesforce object API name (e.g., Account, Contact, Lead, Custom_Object__c)', }, }, diff --git a/apps/sim/tools/salesforce/get_accounts.ts b/apps/sim/tools/salesforce/get_accounts.ts index 1710acf0d..c94d899aa 100644 --- a/apps/sim/tools/salesforce/get_accounts.ts +++ b/apps/sim/tools/salesforce/get_accounts.ts @@ -44,20 +44,20 @@ export const salesforceGetAccountsTool: ToolConfig< limit: { type: 'string', required: false, - visibility: 'user-only', - description: 'Number of results to return (default: 100, max: 2000)', + visibility: 'user-or-llm', + description: 'Maximum number of results (default: 100, max: 2000)', }, fields: { type: 'string', required: false, - visibility: 'user-only', - description: 'Comma-separated list of fields to return (e.g., "Id,Name,Industry,Phone")', + visibility: 'user-or-llm', + description: 'Comma-separated field API names (e.g., "Id,Name,Industry,Phone")', }, orderBy: { type: 'string', required: false, - visibility: 'user-only', - description: 'Field to order by (e.g., "Name ASC" or "CreatedDate DESC")', + visibility: 'user-or-llm', + description: 'Field and direction for sorting (e.g., "Name ASC" or "CreatedDate DESC")', }, }, diff --git a/apps/sim/tools/salesforce/get_cases.ts b/apps/sim/tools/salesforce/get_cases.ts index 4d2813ac5..a8e72dd0b 100644 --- a/apps/sim/tools/salesforce/get_cases.ts +++ b/apps/sim/tools/salesforce/get_cases.ts @@ -24,26 +24,27 @@ export const salesforceGetCasesTool: ToolConfig< caseId: { type: 'string', required: false, - visibility: 'user-only', - description: 'Case ID (optional)', + visibility: 'user-or-llm', + description: + 'Salesforce Case ID (18-character string starting with 500) to get a single case', }, limit: { type: 'string', required: false, - visibility: 'user-only', - description: 'Max results (default: 100)', + visibility: 'user-or-llm', + description: 'Maximum number of results to return (default: 100)', }, fields: { type: 'string', required: false, - visibility: 'user-only', - description: 'Comma-separated fields', + visibility: 'user-or-llm', + description: 'Comma-separated list of field API names to return', }, orderBy: { type: 'string', required: false, - visibility: 'user-only', - description: 'Order by field', + visibility: 'user-or-llm', + description: 'Field and direction for sorting (e.g., CreatedDate DESC)', }, }, diff --git a/apps/sim/tools/salesforce/get_contacts.ts b/apps/sim/tools/salesforce/get_contacts.ts index f59dcb8fb..343446307 100644 --- a/apps/sim/tools/salesforce/get_contacts.ts +++ b/apps/sim/tools/salesforce/get_contacts.ts @@ -30,26 +30,27 @@ export const salesforceGetContactsTool: ToolConfig< contactId: { type: 'string', required: false, - visibility: 'user-only', - description: 'Contact ID (if provided, returns single contact)', + visibility: 'user-or-llm', + description: + 'Salesforce Contact ID (18-character string starting with 003) to get a single contact', }, limit: { type: 'string', required: false, - visibility: 'user-only', - description: 'Number of results (default: 100, max: 2000). Only for list query.', + visibility: 'user-or-llm', + description: 'Maximum number of results (default: 100, max: 2000). Only for list query.', }, fields: { type: 'string', required: false, - visibility: 'user-only', - description: 'Comma-separated fields (e.g., "Id,FirstName,LastName,Email,Phone")', + visibility: 'user-or-llm', + description: 'Comma-separated field API names (e.g., "Id,FirstName,LastName,Email,Phone")', }, orderBy: { type: 'string', required: false, - visibility: 'user-only', - description: 'Order by field (e.g., "LastName ASC"). Only for list query.', + visibility: 'user-or-llm', + description: 'Field and direction for sorting (e.g., "LastName ASC"). Only for list query.', }, }, diff --git a/apps/sim/tools/salesforce/get_dashboard.ts b/apps/sim/tools/salesforce/get_dashboard.ts index 9b7da14a0..9bf280107 100644 --- a/apps/sim/tools/salesforce/get_dashboard.ts +++ b/apps/sim/tools/salesforce/get_dashboard.ts @@ -34,8 +34,8 @@ export const salesforceGetDashboardTool: ToolConfig< dashboardId: { type: 'string', required: true, - visibility: 'user-only', - description: 'Dashboard ID (required)', + visibility: 'user-or-llm', + description: 'Salesforce Dashboard ID (18-character string starting with 01Z)', }, }, diff --git a/apps/sim/tools/salesforce/get_leads.ts b/apps/sim/tools/salesforce/get_leads.ts index aeb1950ac..c028ccc5c 100644 --- a/apps/sim/tools/salesforce/get_leads.ts +++ b/apps/sim/tools/salesforce/get_leads.ts @@ -24,26 +24,27 @@ export const salesforceGetLeadsTool: ToolConfig< leadId: { type: 'string', required: false, - visibility: 'user-only', - description: 'Lead ID (optional)', + visibility: 'user-or-llm', + description: + 'Salesforce Lead ID (18-character string starting with 00Q) to get a single lead', }, limit: { type: 'string', required: false, - visibility: 'user-only', - description: 'Max results (default: 100)', + visibility: 'user-or-llm', + description: 'Maximum number of results to return (default: 100)', }, fields: { type: 'string', required: false, - visibility: 'user-only', - description: 'Comma-separated fields', + visibility: 'user-or-llm', + description: 'Comma-separated list of field API names to return', }, orderBy: { type: 'string', required: false, - visibility: 'user-only', - description: 'Order by field', + visibility: 'user-or-llm', + description: 'Field and direction for sorting (e.g., LastName ASC)', }, }, diff --git a/apps/sim/tools/salesforce/get_opportunities.ts b/apps/sim/tools/salesforce/get_opportunities.ts index 5741d8c8d..fd46d97b5 100644 --- a/apps/sim/tools/salesforce/get_opportunities.ts +++ b/apps/sim/tools/salesforce/get_opportunities.ts @@ -27,26 +27,27 @@ export const salesforceGetOpportunitiesTool: ToolConfig< opportunityId: { type: 'string', required: false, - visibility: 'user-only', - description: 'Opportunity ID (optional)', + visibility: 'user-or-llm', + description: + 'Salesforce Opportunity ID (18-character string starting with 006) to get a single opportunity', }, limit: { type: 'string', required: false, - visibility: 'user-only', - description: 'Max results (default: 100)', + visibility: 'user-or-llm', + description: 'Maximum number of results to return (default: 100)', }, fields: { type: 'string', required: false, - visibility: 'user-only', - description: 'Comma-separated fields', + visibility: 'user-or-llm', + description: 'Comma-separated list of field API names to return', }, orderBy: { type: 'string', required: false, - visibility: 'user-only', - description: 'Order by field', + visibility: 'user-or-llm', + description: 'Field and direction for sorting (e.g., CloseDate DESC)', }, }, diff --git a/apps/sim/tools/salesforce/get_report.ts b/apps/sim/tools/salesforce/get_report.ts index 86da52454..48f4eca33 100644 --- a/apps/sim/tools/salesforce/get_report.ts +++ b/apps/sim/tools/salesforce/get_report.ts @@ -34,8 +34,8 @@ export const salesforceGetReportTool: ToolConfig< reportId: { type: 'string', required: true, - visibility: 'user-only', - description: 'Report ID (required)', + visibility: 'user-or-llm', + description: 'Salesforce Report ID (18-character string starting with 00O)', }, }, diff --git a/apps/sim/tools/salesforce/get_tasks.ts b/apps/sim/tools/salesforce/get_tasks.ts index b5bb31a54..36b4bc109 100644 --- a/apps/sim/tools/salesforce/get_tasks.ts +++ b/apps/sim/tools/salesforce/get_tasks.ts @@ -36,26 +36,27 @@ export const salesforceGetTasksTool: ToolConfig< taskId: { type: 'string', required: false, - visibility: 'user-only', - description: 'Task ID (optional)', + visibility: 'user-or-llm', + description: + 'Salesforce Task ID (18-character string starting with 00T) to get a single task', }, limit: { type: 'string', required: false, - visibility: 'user-only', - description: 'Max results (default: 100)', + visibility: 'user-or-llm', + description: 'Maximum number of results to return (default: 100)', }, fields: { type: 'string', required: false, - visibility: 'user-only', - description: 'Comma-separated fields', + visibility: 'user-or-llm', + description: 'Comma-separated list of field API names to return', }, orderBy: { type: 'string', required: false, - visibility: 'user-only', - description: 'Order by field', + visibility: 'user-or-llm', + description: 'Field and direction for sorting (e.g., ActivityDate DESC)', }, }, diff --git a/apps/sim/tools/salesforce/list_dashboards.ts b/apps/sim/tools/salesforce/list_dashboards.ts index 59eff89f2..17f1be166 100644 --- a/apps/sim/tools/salesforce/list_dashboards.ts +++ b/apps/sim/tools/salesforce/list_dashboards.ts @@ -34,8 +34,8 @@ export const salesforceListDashboardsTool: ToolConfig< folderName: { type: 'string', required: false, - visibility: 'user-only', - description: 'Filter by folder name', + visibility: 'user-or-llm', + description: 'Filter dashboards by folder name (case-insensitive partial match)', }, }, diff --git a/apps/sim/tools/salesforce/list_reports.ts b/apps/sim/tools/salesforce/list_reports.ts index 81b62c393..53492a058 100644 --- a/apps/sim/tools/salesforce/list_reports.ts +++ b/apps/sim/tools/salesforce/list_reports.ts @@ -34,14 +34,14 @@ export const salesforceListReportsTool: ToolConfig< folderName: { type: 'string', required: false, - visibility: 'user-only', - description: 'Filter by folder name', + visibility: 'user-or-llm', + description: 'Filter reports by folder name (case-insensitive partial match)', }, searchTerm: { type: 'string', required: false, - visibility: 'user-only', - description: 'Search term to filter reports by name', + visibility: 'user-or-llm', + description: 'Search term to filter reports by name or description', }, }, diff --git a/apps/sim/tools/salesforce/query.ts b/apps/sim/tools/salesforce/query.ts index 1690a65b0..f8906e97d 100644 --- a/apps/sim/tools/salesforce/query.ts +++ b/apps/sim/tools/salesforce/query.ts @@ -28,7 +28,7 @@ export const salesforceQueryTool: ToolConfig = attachments: { type: 'file[]', required: false, - visibility: 'user-only', - description: 'Files to attach to the email', + visibility: 'user-or-llm', + description: 'Files to attach to the email as an array of attachment objects', }, templateId: { type: 'string', diff --git a/apps/sim/tools/sentry/events_get.ts b/apps/sim/tools/sentry/events_get.ts index 8b616ed8e..ec1e123b9 100644 --- a/apps/sim/tools/sentry/events_get.ts +++ b/apps/sim/tools/sentry/events_get.ts @@ -18,20 +18,20 @@ export const getEventTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'The search query', + description: 'The search query (e.g., "latest AI news", "best restaurants in NYC")', }, num: { type: 'number', required: false, - visibility: 'user-only', - description: 'Number of results to return', + visibility: 'user-or-llm', + description: 'Number of results to return (e.g., 10, 20, 50)', }, gl: { type: 'string', required: false, - visibility: 'user-only', - description: 'Country code for search results', + visibility: 'user-or-llm', + description: 'Country code for search results (e.g., "us", "uk", "de", "fr")', }, hl: { type: 'string', required: false, - visibility: 'user-only', - description: 'Language code for search results', + visibility: 'user-or-llm', + description: 'Language code for search results (e.g., "en", "es", "de", "fr")', }, type: { type: 'string', required: false, - visibility: 'user-only', - description: 'Type of search to perform', + visibility: 'user-or-llm', + description: + 'Type of search to perform (e.g., "search", "news", "images", "videos", "places", "shopping")', }, apiKey: { type: 'string', diff --git a/apps/sim/tools/servicenow/create_record.ts b/apps/sim/tools/servicenow/create_record.ts index c5476d1d3..80f8184f0 100644 --- a/apps/sim/tools/servicenow/create_record.ts +++ b/apps/sim/tools/servicenow/create_record.ts @@ -40,7 +40,8 @@ export const createRecordTool: ToolConfig channel: { type: 'string', required: true, - visibility: 'user-only', - description: 'Target Slack channel (e.g., #general)', + visibility: 'user-or-llm', + description: 'Slack channel ID (e.g., C1234567890)', }, title: { type: 'string', diff --git a/apps/sim/tools/slack/delete_message.ts b/apps/sim/tools/slack/delete_message.ts index 403403264..3f2d3d00b 100644 --- a/apps/sim/tools/slack/delete_message.ts +++ b/apps/sim/tools/slack/delete_message.ts @@ -38,7 +38,7 @@ export const slackDeleteMessageTool: ToolConfig< channel: { type: 'string', required: true, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Channel ID where the message was posted (e.g., C1234567890)', }, timestamp: { diff --git a/apps/sim/tools/slack/download.ts b/apps/sim/tools/slack/download.ts index 3076139ab..9a513b692 100644 --- a/apps/sim/tools/slack/download.ts +++ b/apps/sim/tools/slack/download.ts @@ -38,13 +38,13 @@ export const slackDownloadTool: ToolConfig offset: { type: 'number', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Position in context to start playing (0-based index)', }, position_ms: { type: 'number', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Position in track to start from (in milliseconds)', }, }, diff --git a/apps/sim/tools/spotify/reorder_playlist_items.ts b/apps/sim/tools/spotify/reorder_playlist_items.ts index 4564b6351..55f3e6141 100644 --- a/apps/sim/tools/spotify/reorder_playlist_items.ts +++ b/apps/sim/tools/spotify/reorder_playlist_items.ts @@ -52,15 +52,15 @@ export const spotifyReorderPlaylistItemsTool: ToolConfig< range_length: { type: 'number', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', default: 1, description: 'Number of items to reorder', }, snapshot_id: { type: 'string', required: false, - visibility: 'user-only', - description: 'Playlist snapshot ID for concurrency control', + visibility: 'user-or-llm', + description: 'Playlist snapshot ID for concurrency control (22-character base62 string)', }, }, diff --git a/apps/sim/tools/spotify/search.ts b/apps/sim/tools/spotify/search.ts index 56531dad3..b9235847f 100644 --- a/apps/sim/tools/spotify/search.ts +++ b/apps/sim/tools/spotify/search.ts @@ -37,21 +37,21 @@ export const spotifySearchTool: ToolConfig device_id: { type: 'string', required: false, - visibility: 'user-only', - description: 'Device ID to target', + visibility: 'user-or-llm', + description: 'Spotify device ID to target for playback', }, }, diff --git a/apps/sim/tools/spotify/set_repeat.ts b/apps/sim/tools/spotify/set_repeat.ts index 02e85fa50..07cb499d9 100644 --- a/apps/sim/tools/spotify/set_repeat.ts +++ b/apps/sim/tools/spotify/set_repeat.ts @@ -34,8 +34,8 @@ export const spotifySetRepeatTool: ToolConfig queueUrl: { type: 'string', required: true, - visibility: 'user-only', - description: 'Queue URL', + visibility: 'user-or-llm', + description: + 'SQS queue URL (e.g., https://sqs.us-east-1.amazonaws.com/123456789012/my-queue)', }, data: { type: 'object', required: true, visibility: 'user-or-llm', - description: 'Message body to send', + description: + 'Message body to send as JSON object (e.g., { "action": "process", "payload": {...} })', }, messageGroupId: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'Message group ID (optional)', + description: 'Message group ID for FIFO queues (e.g., "order-processing-group")', }, messageDeduplicationId: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'Message deduplication ID (optional)', + description: 'Message deduplication ID for FIFO queues (e.g., "order-12345-v1")', }, }, diff --git a/apps/sim/tools/stt/assemblyai.ts b/apps/sim/tools/stt/assemblyai.ts index 822625698..d005aba2d 100644 --- a/apps/sim/tools/stt/assemblyai.ts +++ b/apps/sim/tools/stt/assemblyai.ts @@ -34,13 +34,13 @@ export const assemblyaiSttTool: ToolConfig = { audioFile: { type: 'file', required: false, - visibility: 'user-or-llm', - description: 'Audio or video file to transcribe', + visibility: 'user-only', + description: 'Audio or video file to transcribe (e.g., MP3, WAV, M4A, WEBM)', }, audioFileReference: { type: 'file', required: false, - visibility: 'user-or-llm', + visibility: 'user-only', description: 'Reference to audio/video file from previous blocks', }, audioUrl: { diff --git a/apps/sim/tools/stt/deepgram.ts b/apps/sim/tools/stt/deepgram.ts index d36b9c948..e198a0561 100644 --- a/apps/sim/tools/stt/deepgram.ts +++ b/apps/sim/tools/stt/deepgram.ts @@ -30,13 +30,13 @@ export const deepgramSttTool: ToolConfig = { audioFile: { type: 'file', required: false, - visibility: 'user-or-llm', - description: 'Audio or video file to transcribe', + visibility: 'user-only', + description: 'Audio or video file to transcribe (e.g., MP3, WAV, M4A, WEBM)', }, audioFileReference: { type: 'file', required: false, - visibility: 'user-or-llm', + visibility: 'user-only', description: 'Reference to audio/video file from previous blocks', }, audioUrl: { diff --git a/apps/sim/tools/stt/elevenlabs.ts b/apps/sim/tools/stt/elevenlabs.ts index 6e143616b..b10124a57 100644 --- a/apps/sim/tools/stt/elevenlabs.ts +++ b/apps/sim/tools/stt/elevenlabs.ts @@ -29,13 +29,13 @@ export const elevenLabsSttTool: ToolConfig = { audioFile: { type: 'file', required: false, - visibility: 'user-or-llm', - description: 'Audio or video file to transcribe', + visibility: 'user-only', + description: 'Audio or video file to transcribe (e.g., MP3, WAV, M4A, WEBM)', }, audioFileReference: { type: 'file', required: false, - visibility: 'user-or-llm', + visibility: 'user-only', description: 'Reference to audio/video file from previous blocks', }, audioUrl: { diff --git a/apps/sim/tools/stt/gemini.ts b/apps/sim/tools/stt/gemini.ts index 8c5bb2c93..781527bdd 100644 --- a/apps/sim/tools/stt/gemini.ts +++ b/apps/sim/tools/stt/gemini.ts @@ -29,13 +29,13 @@ export const geminiSttTool: ToolConfig = { audioFile: { type: 'file', required: false, - visibility: 'user-or-llm', - description: 'Audio or video file to transcribe', + visibility: 'user-only', + description: 'Audio or video file to transcribe (e.g., MP3, WAV, M4A, WEBM)', }, audioFileReference: { type: 'file', required: false, - visibility: 'user-or-llm', + visibility: 'user-only', description: 'Reference to audio/video file from previous blocks', }, audioUrl: { diff --git a/apps/sim/tools/stt/whisper.ts b/apps/sim/tools/stt/whisper.ts index 57300d5fe..5c03d3cbe 100644 --- a/apps/sim/tools/stt/whisper.ts +++ b/apps/sim/tools/stt/whisper.ts @@ -30,13 +30,13 @@ export const whisperSttTool: ToolConfig = { audioFile: { type: 'file', required: false, - visibility: 'user-or-llm', - description: 'Audio or video file to transcribe', + visibility: 'user-only', + description: 'Audio or video file to transcribe (e.g., MP3, WAV, M4A, WEBM)', }, audioFileReference: { type: 'file', required: false, - visibility: 'user-or-llm', + visibility: 'user-only', description: 'Reference to audio/video file from previous blocks', }, audioUrl: { @@ -77,6 +77,13 @@ export const whisperSttTool: ToolConfig = { description: 'Sampling temperature between 0 and 1. Higher values make output more random, lower values more focused and deterministic.', }, + responseFormat: { + type: 'string', + required: false, + visibility: 'user-or-llm', + description: + 'Output format for the transcription (e.g., "json", "text", "srt", "verbose_json", "vtt")', + }, }, request: { @@ -101,6 +108,7 @@ export const whisperSttTool: ToolConfig = { translateToEnglish: params.translateToEnglish || false, prompt: (params as any).prompt, temperature: (params as any).temperature, + responseFormat: (params as any).responseFormat, workspaceId: params._context?.workspaceId, workflowId: params._context?.workflowId, executionId: params._context?.executionId, diff --git a/apps/sim/tools/supabase/storage_download.ts b/apps/sim/tools/supabase/storage_download.ts index 03b252485..d9fc2f9f2 100644 --- a/apps/sim/tools/supabase/storage_download.ts +++ b/apps/sim/tools/supabase/storage_download.ts @@ -39,7 +39,7 @@ export const storageDownloadTool: ToolConfig< fileName: { type: 'string', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Optional filename override', }, apiKey: { diff --git a/apps/sim/tools/tavily/search.ts b/apps/sim/tools/tavily/search.ts index 664072e0a..cf4b78e43 100644 --- a/apps/sim/tools/tavily/search.ts +++ b/apps/sim/tools/tavily/search.ts @@ -17,37 +17,38 @@ export const searchTool: ToolConfig = type: 'string', required: true, visibility: 'user-or-llm', - description: 'The search query to execute', + description: 'The search query to execute (e.g., "latest AI research papers 2024")', }, max_results: { type: 'number', required: false, - visibility: 'user-only', - description: 'Maximum number of results (1-20)', + visibility: 'user-or-llm', + description: 'Maximum number of results (1-20, e.g., 5)', }, topic: { type: 'string', required: false, - visibility: 'user-only', - description: 'Category type: general, news, or finance (default: general)', + visibility: 'user-or-llm', + description: 'Category type: general, news, or finance (e.g., "news")', }, search_depth: { type: 'string', required: false, - visibility: 'user-only', - description: 'Search scope: basic (1 credit) or advanced (2 credits) (default: basic)', + visibility: 'user-or-llm', + description: 'Search scope: basic (1 credit) or advanced (2 credits) (e.g., "advanced")', }, include_answer: { type: 'string', required: false, - visibility: 'user-only', - description: 'LLM-generated response: true/basic for quick answer or advanced for detailed', + visibility: 'user-or-llm', + description: + 'LLM-generated response: true/basic for quick answer or advanced for detailed (e.g., "advanced")', }, include_raw_content: { type: 'string', required: false, - visibility: 'user-only', - description: 'Parsed HTML content: true/markdown or text format', + visibility: 'user-or-llm', + description: 'Parsed HTML content: true/markdown or text format (e.g., "markdown")', }, include_images: { type: 'boolean', @@ -94,14 +95,16 @@ export const searchTool: ToolConfig = include_domains: { type: 'string', required: false, - visibility: 'user-only', - description: 'Comma-separated list of domains to whitelist (max 300)', + visibility: 'user-or-llm', + description: + 'Comma-separated list of domains to whitelist (e.g., "github.com,stackoverflow.com")', }, exclude_domains: { type: 'string', required: false, - visibility: 'user-only', - description: 'Comma-separated list of domains to blacklist (max 150)', + visibility: 'user-or-llm', + description: + 'Comma-separated list of domains to blacklist (e.g., "pinterest.com,reddit.com")', }, country: { type: 'string', diff --git a/apps/sim/tools/telegram/delete_message.ts b/apps/sim/tools/telegram/delete_message.ts index df787654c..e8b995a7b 100644 --- a/apps/sim/tools/telegram/delete_message.ts +++ b/apps/sim/tools/telegram/delete_message.ts @@ -26,14 +26,14 @@ export const telegramDeleteMessageTool: ToolConfig< chatId: { type: 'string', required: true, - visibility: 'user-only', - description: 'Target Telegram chat ID', + visibility: 'user-or-llm', + description: 'Telegram chat ID (numeric, can be negative for groups)', }, messageId: { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Message ID to delete', + description: 'Telegram message ID (numeric identifier of the message to delete)', }, }, diff --git a/apps/sim/tools/telegram/message.ts b/apps/sim/tools/telegram/message.ts index b57a7b533..9d2e57b2b 100644 --- a/apps/sim/tools/telegram/message.ts +++ b/apps/sim/tools/telegram/message.ts @@ -28,8 +28,8 @@ export const telegramMessageTool: ToolConfig< chatId: { type: 'string', required: true, - visibility: 'user-only', - description: 'Target Telegram chat ID', + visibility: 'user-or-llm', + description: 'Telegram chat ID (numeric, can be negative for groups)', }, text: { type: 'string', diff --git a/apps/sim/tools/telegram/send_animation.ts b/apps/sim/tools/telegram/send_animation.ts index 5f5cb7cf3..191dc188d 100644 --- a/apps/sim/tools/telegram/send_animation.ts +++ b/apps/sim/tools/telegram/send_animation.ts @@ -27,8 +27,8 @@ export const telegramSendAnimationTool: ToolConfig< chatId: { type: 'string', required: true, - visibility: 'user-only', - description: 'Target Telegram chat ID', + visibility: 'user-or-llm', + description: 'Telegram chat ID (numeric, can be negative for groups)', }, animation: { type: 'string', diff --git a/apps/sim/tools/telegram/send_audio.ts b/apps/sim/tools/telegram/send_audio.ts index 1d786e629..d539f7f22 100644 --- a/apps/sim/tools/telegram/send_audio.ts +++ b/apps/sim/tools/telegram/send_audio.ts @@ -25,8 +25,8 @@ export const telegramSendAudioTool: ToolConfig = required: true, visibility: 'user-or-llm', description: - 'SQL query to execute. Specify your desired output format (e.g., FORMAT JSON, FORMAT CSV, FORMAT TSV). JSON format provides structured data, while other formats return raw text.', + 'SQL query to execute. Specify your desired output format (e.g., FORMAT JSON, FORMAT CSV, FORMAT TSV). JSON format provides structured data, while other formats return raw text. Example: "SELECT * FROM my_datasource LIMIT 100 FORMAT JSON"', }, pipeline: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'Optional pipe name. When provided, enables SELECT * FROM _ syntax', + description: + 'Optional pipe name. When provided, enables SELECT * FROM _ syntax. Example: "my_pipe", "analytics_pipe"', }, token: { type: 'string', diff --git a/apps/sim/tools/trello/add_comment.ts b/apps/sim/tools/trello/add_comment.ts index a0bc6a015..efd9aefa2 100644 --- a/apps/sim/tools/trello/add_comment.ts +++ b/apps/sim/tools/trello/add_comment.ts @@ -24,7 +24,7 @@ export const trelloAddCommentTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'The text to convert to speech', + description: 'The text content to convert to speech (e.g., "Hello, welcome to our service!")', }, apiKey: { type: 'string', @@ -24,7 +24,8 @@ export const azureTtsTool: ToolConfig = { type: 'string', required: false, visibility: 'user-or-llm', - description: 'Voice ID (e.g., en-US-JennyNeural, en-US-GuyNeural)', + description: + 'Azure voice identifier (e.g., "en-US-JennyNeural", "en-US-GuyNeural", "en-GB-SoniaNeural")', }, region: { type: 'string', diff --git a/apps/sim/tools/tts/cartesia.ts b/apps/sim/tools/tts/cartesia.ts index ec0832fdd..7e5995bf8 100644 --- a/apps/sim/tools/tts/cartesia.ts +++ b/apps/sim/tools/tts/cartesia.ts @@ -12,7 +12,7 @@ export const cartesiaTtsTool: ToolConfig = type: 'string', required: true, visibility: 'user-or-llm', - description: 'The text to convert to speech', + description: 'The text content to convert to speech (e.g., "Hello, welcome to our service!")', }, apiKey: { type: 'string', @@ -23,20 +23,22 @@ export const cartesiaTtsTool: ToolConfig = modelId: { type: 'string', required: false, - visibility: 'user-only', - description: 'Model ID (sonic-english, sonic-multilingual)', + visibility: 'user-or-llm', + description: + 'Cartesia model identifier (e.g., "sonic", "sonic-2", "sonic-3", "sonic-multilingual")', }, voice: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'Voice ID or embedding', + description: + 'Cartesia voice identifier or embedding (e.g., "a0e99841-438c-4a64-b679-ae501e7d6091")', }, language: { type: 'string', required: false, - visibility: 'user-only', - description: 'Language code (en, es, fr, de, it, pt, etc.)', + visibility: 'user-or-llm', + description: 'Language code for speech synthesis (e.g., "en", "es", "fr", "de", "it", "pt")', }, outputFormat: { type: 'json', @@ -47,8 +49,8 @@ export const cartesiaTtsTool: ToolConfig = speed: { type: 'number', required: false, - visibility: 'user-only', - description: 'Speed multiplier', + visibility: 'user-or-llm', + description: 'Speech speed multiplier (e.g., 0.5 for slower, 1.0 for normal, 2.0 for faster)', }, emotion: { type: 'array', diff --git a/apps/sim/tools/tts/deepgram.ts b/apps/sim/tools/tts/deepgram.ts index 3955d2861..63566e912 100644 --- a/apps/sim/tools/tts/deepgram.ts +++ b/apps/sim/tools/tts/deepgram.ts @@ -12,7 +12,7 @@ export const deepgramTtsTool: ToolConfig = type: 'string', required: true, visibility: 'user-or-llm', - description: 'The text to convert to speech', + description: 'The text content to convert to speech (e.g., "Hello, welcome to our service!")', }, apiKey: { type: 'string', @@ -23,14 +23,16 @@ export const deepgramTtsTool: ToolConfig = model: { type: 'string', required: false, - visibility: 'user-only', - description: 'Deepgram model/voice (e.g., aura-asteria-en, aura-luna-en)', + visibility: 'user-or-llm', + description: + 'Deepgram model/voice identifier (e.g., "aura-asteria-en", "aura-luna-en", "aura-2-luna-en")', }, voice: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'Voice identifier (alternative to model param)', + description: + 'Deepgram voice identifier, alternative to model param (e.g., "aura-asteria-en", "aura-orion-en")', }, encoding: { type: 'string', diff --git a/apps/sim/tools/tts/elevenlabs.ts b/apps/sim/tools/tts/elevenlabs.ts index b35741b8b..6a177a5f5 100644 --- a/apps/sim/tools/tts/elevenlabs.ts +++ b/apps/sim/tools/tts/elevenlabs.ts @@ -12,13 +12,14 @@ export const elevenLabsTtsUnifiedTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'The text to convert to speech', + description: 'The text content to convert to speech (e.g., "Hello, welcome to our service!")', }, apiKey: { type: 'string', @@ -24,13 +24,15 @@ export const googleTtsTool: ToolConfig = { type: 'string', required: false, visibility: 'user-or-llm', - description: 'Voice ID (e.g., en-US-Neural2-A, en-US-Wavenet-D)', + description: + 'Google Cloud voice identifier (e.g., "en-US-Neural2-A", "en-US-Wavenet-D", "en-GB-Neural2-B")', }, languageCode: { type: 'string', required: true, - visibility: 'user-only', - description: 'Language code (e.g., en-US, es-ES, fr-FR)', + visibility: 'user-or-llm', + description: + 'BCP-47 language code for speech synthesis (e.g., "en-US", "es-ES", "fr-FR", "de-DE")', }, gender: { type: 'string', @@ -47,8 +49,9 @@ export const googleTtsTool: ToolConfig = { speakingRate: { type: 'number', required: false, - visibility: 'user-only', - description: 'Speaking rate (0.25 to 2.0, default: 1.0)', + visibility: 'user-or-llm', + description: + 'Speaking rate multiplier from 0.25 to 2.0 (e.g., 0.5 for slower, 1.0 for normal, 1.5 for faster)', }, pitch: { type: 'number', diff --git a/apps/sim/tools/tts/openai.ts b/apps/sim/tools/tts/openai.ts index 22dd6b44d..b06663618 100644 --- a/apps/sim/tools/tts/openai.ts +++ b/apps/sim/tools/tts/openai.ts @@ -12,7 +12,7 @@ export const openaiTtsTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'The text to convert to speech', + description: 'The text content to convert to speech (e.g., "Hello, welcome to our service!")', }, apiKey: { type: 'string', @@ -24,14 +24,14 @@ export const openaiTtsTool: ToolConfig = { type: 'string', required: false, visibility: 'user-or-llm', - description: 'TTS model to use (tts-1, tts-1-hd, or gpt-4o-mini-tts)', + description: 'OpenAI TTS model identifier (e.g., "tts-1", "tts-1-hd", "gpt-4o-mini-tts")', }, voice: { type: 'string', required: false, visibility: 'user-or-llm', description: - 'Voice to use (alloy, ash, ballad, cedar, coral, echo, marin, sage, shimmer, verse)', + 'OpenAI voice identifier (e.g., "alloy", "ash", "ballad", "coral", "echo", "sage", "shimmer")', }, responseFormat: { type: 'string', @@ -43,7 +43,8 @@ export const openaiTtsTool: ToolConfig = { type: 'number', required: false, visibility: 'user-or-llm', - description: 'Speech speed (0.25 to 4.0, default: 1.0)', + description: + 'Speech speed multiplier from 0.25 to 4.0 (e.g., 0.5 for slower, 1.0 for normal, 2.0 for faster)', }, }, diff --git a/apps/sim/tools/tts/playht.ts b/apps/sim/tools/tts/playht.ts index 93c20443d..23bff6e3f 100644 --- a/apps/sim/tools/tts/playht.ts +++ b/apps/sim/tools/tts/playht.ts @@ -12,7 +12,7 @@ export const playhtTtsTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'The text to convert to speech', + description: 'The text content to convert to speech (e.g., "Hello, welcome to our service!")', }, apiKey: { type: 'string', @@ -30,7 +30,8 @@ export const playhtTtsTool: ToolConfig = { type: 'string', required: false, visibility: 'user-or-llm', - description: 'Voice ID or manifest URL', + description: + 'PlayHT voice identifier or manifest URL (e.g., "s3://voice-cloning-zero-shot/...")', }, quality: { type: 'string', @@ -47,8 +48,9 @@ export const playhtTtsTool: ToolConfig = { speed: { type: 'number', required: false, - visibility: 'user-only', - description: 'Speed multiplier (0.5 to 2.0)', + visibility: 'user-or-llm', + description: + 'Speech speed multiplier from 0.5 to 2.0 (e.g., 0.5 for slower, 1.0 for normal, 1.5 for faster)', }, temperature: { type: 'number', diff --git a/apps/sim/tools/twilio/send_sms.ts b/apps/sim/tools/twilio/send_sms.ts index 87fdb0208..dbe9c8d49 100644 --- a/apps/sim/tools/twilio/send_sms.ts +++ b/apps/sim/tools/twilio/send_sms.ts @@ -14,8 +14,9 @@ export const sendSMSTool: ToolConfig phoneNumbers: { type: 'string', required: true, - visibility: 'user-only', - description: 'Phone numbers to send the message to, separated by newlines', + visibility: 'user-or-llm', + description: + 'Phone numbers to send the message to in E.164 format (e.g., +15551234567), separated by newlines', }, message: { type: 'string', @@ -38,8 +39,9 @@ export const sendSMSTool: ToolConfig fromNumber: { type: 'string', required: true, - visibility: 'user-only', - description: 'Twilio phone number to send the message from', + visibility: 'user-or-llm', + description: + 'Twilio phone number to send the message from in E.164 format (e.g., +15551234567)', }, }, diff --git a/apps/sim/tools/twilio_voice/get_recording.ts b/apps/sim/tools/twilio_voice/get_recording.ts index 94e6b816b..7573b0d2e 100644 --- a/apps/sim/tools/twilio_voice/get_recording.ts +++ b/apps/sim/tools/twilio_voice/get_recording.ts @@ -15,7 +15,7 @@ export const getRecordingTool: ToolConfig = to: { type: 'string', required: true, - visibility: 'user-only', - description: 'Phone number to call (E.164 format, e.g., +14155551234)', + visibility: 'user-or-llm', + description: 'Phone number to call in E.164 format (e.g., +14155551234)', }, from: { type: 'string', required: true, - visibility: 'user-only', - description: 'Your Twilio phone number to call from (E.164 format)', + visibility: 'user-or-llm', + description: 'Your Twilio phone number to call from in E.164 format (e.g., +14155559876)', }, url: { type: 'string', required: false, visibility: 'user-or-llm', - description: 'URL that returns TwiML instructions for the call', + description: + 'Webhook URL that returns TwiML instructions for the call (e.g., https://example.com/twiml)', }, twiml: { type: 'string', required: false, visibility: 'user-or-llm', description: - 'TwiML instructions to execute (alternative to URL). Use square brackets instead of angle brackets, e.g., [Response][Say]Hello[/Say][/Response]', + 'TwiML instructions to execute. Use square brackets instead of angle brackets (e.g., [Response][Say]Hello[/Say][/Response])', }, statusCallback: { type: 'string', diff --git a/apps/sim/tools/typeform/create_form.ts b/apps/sim/tools/typeform/create_form.ts index cc6220d3e..aba50a9c0 100644 --- a/apps/sim/tools/typeform/create_form.ts +++ b/apps/sim/tools/typeform/create_form.ts @@ -29,8 +29,8 @@ export const createFormTool: ToolConfig = formId: { type: 'string', required: true, - visibility: 'user-only', - description: 'Typeform form ID', + visibility: 'user-or-llm', + description: 'Typeform form ID (e.g., "abc123XYZ")', }, responseId: { type: 'string', required: true, - visibility: 'user-only', - description: 'Response ID containing the files', + visibility: 'user-or-llm', + description: 'Response ID containing the files (e.g., "resp_xyz789")', }, fieldId: { type: 'string', diff --git a/apps/sim/tools/typeform/get_form.ts b/apps/sim/tools/typeform/get_form.ts index 49bc9b81a..f94300bf4 100644 --- a/apps/sim/tools/typeform/get_form.ts +++ b/apps/sim/tools/typeform/get_form.ts @@ -17,8 +17,8 @@ export const getFormTool: ToolConfig = { tweetId: { type: 'string', required: true, - visibility: 'user-only', - description: 'ID of the tweet to read', + visibility: 'user-or-llm', + description: 'ID of the tweet to read (e.g., 1234567890123456789)', }, includeReplies: { type: 'boolean', diff --git a/apps/sim/tools/x/search.ts b/apps/sim/tools/x/search.ts index cf57c65ca..e4590137b 100644 --- a/apps/sim/tools/x/search.ts +++ b/apps/sim/tools/x/search.ts @@ -27,13 +27,14 @@ export const xSearchTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Search query (supports X search operators)', + description: + 'Search query (e.g., "AI news", "#technology", "from:username"). Supports X search operators', }, maxResults: { type: 'number', required: false, - visibility: 'user-only', - description: 'Maximum number of results to return (default: 10, max: 100)', + visibility: 'user-or-llm', + description: 'Maximum number of results to return (e.g., 10, 25, 50). Default: 10, max: 100', }, startTime: { type: 'string', diff --git a/apps/sim/tools/x/user.ts b/apps/sim/tools/x/user.ts index 16dad924d..63918a4d9 100644 --- a/apps/sim/tools/x/user.ts +++ b/apps/sim/tools/x/user.ts @@ -27,7 +27,7 @@ export const xUserTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'Username to look up (without @ symbol)', + description: 'Username to look up without @ symbol (e.g., elonmusk, openai)', }, }, diff --git a/apps/sim/tools/x/write.ts b/apps/sim/tools/x/write.ts index 832a957fd..6e952c9f3 100644 --- a/apps/sim/tools/x/write.ts +++ b/apps/sim/tools/x/write.ts @@ -24,13 +24,13 @@ export const xWriteTool: ToolConfig = { type: 'string', required: true, visibility: 'user-or-llm', - description: 'The text content of your tweet', + description: 'The text content of your tweet (max 280 characters)', }, replyTo: { type: 'string', required: false, - visibility: 'user-only', - description: 'ID of the tweet to reply to', + visibility: 'user-or-llm', + description: 'ID of the tweet to reply to (e.g., 1234567890123456789)', }, mediaIds: { type: 'array', diff --git a/apps/sim/tools/youtube/channel_info.ts b/apps/sim/tools/youtube/channel_info.ts index c4294786b..d8e40bd7f 100644 --- a/apps/sim/tools/youtube/channel_info.ts +++ b/apps/sim/tools/youtube/channel_info.ts @@ -15,7 +15,8 @@ export const youtubeChannelInfoTool: ToolConfig< type: 'string', required: false, visibility: 'user-or-llm', - description: 'YouTube channel ID (use either channelId or username)', + description: + 'YouTube channel ID starting with "UC" (24-character string, use either channelId or username)', }, username: { type: 'string', diff --git a/apps/sim/tools/youtube/channel_playlists.ts b/apps/sim/tools/youtube/channel_playlists.ts index 2f1b5fbc9..57685dcad 100644 --- a/apps/sim/tools/youtube/channel_playlists.ts +++ b/apps/sim/tools/youtube/channel_playlists.ts @@ -17,20 +17,21 @@ export const youtubeChannelPlaylistsTool: ToolConfig< type: 'string', required: true, visibility: 'user-or-llm', - description: 'YouTube channel ID to get playlists from', + description: + 'YouTube channel ID starting with "UC" (24-character string) to get playlists from', }, maxResults: { type: 'number', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', default: 10, description: 'Maximum number of playlists to return (1-50)', }, pageToken: { type: 'string', required: false, - visibility: 'user-only', - description: 'Page token for pagination', + visibility: 'user-or-llm', + description: 'Page token for pagination (from previous response nextPageToken)', }, apiKey: { type: 'string', diff --git a/apps/sim/tools/youtube/channel_videos.ts b/apps/sim/tools/youtube/channel_videos.ts index a44be50ff..9a60998ca 100644 --- a/apps/sim/tools/youtube/channel_videos.ts +++ b/apps/sim/tools/youtube/channel_videos.ts @@ -18,12 +18,12 @@ export const youtubeChannelVideosTool: ToolConfig< type: 'string', required: true, visibility: 'user-or-llm', - description: 'YouTube channel ID to get videos from', + description: 'YouTube channel ID starting with "UC" (24-character string) to get videos from', }, maxResults: { type: 'number', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', default: 10, description: 'Maximum number of videos to return (1-50)', }, @@ -37,8 +37,8 @@ export const youtubeChannelVideosTool: ToolConfig< pageToken: { type: 'string', required: false, - visibility: 'user-only', - description: 'Page token for pagination', + visibility: 'user-or-llm', + description: 'Page token for pagination (from previous response nextPageToken)', }, apiKey: { type: 'string', diff --git a/apps/sim/tools/youtube/comments.ts b/apps/sim/tools/youtube/comments.ts index aaf601bae..8b5a44abf 100644 --- a/apps/sim/tools/youtube/comments.ts +++ b/apps/sim/tools/youtube/comments.ts @@ -11,12 +11,12 @@ export const youtubeCommentsTool: ToolConfig = { threadId: { type: 'string', required: true, - visibility: 'user-only', - description: 'Thread ID to add messages to', + visibility: 'user-or-llm', + description: 'Thread ID to add messages to (e.g., "thread_abc123")', }, messages: { type: 'json', required: true, visibility: 'user-or-llm', - description: 'Array of message objects with role and content', + description: + 'Array of message objects with role and content (e.g., [{"role": "user", "content": "Hello"}])', }, apiKey: { type: 'string', diff --git a/apps/sim/tools/zep/add_user.ts b/apps/sim/tools/zep/add_user.ts index aafcee3f6..6068743d9 100644 --- a/apps/sim/tools/zep/add_user.ts +++ b/apps/sim/tools/zep/add_user.ts @@ -12,8 +12,8 @@ export const zepAddUserTool: ToolConfig = { userId: { type: 'string', required: true, - visibility: 'user-only', - description: 'Unique identifier for the user', + visibility: 'user-or-llm', + description: 'Unique identifier for the user (e.g., "user_123")', }, email: { type: 'string', @@ -36,8 +36,8 @@ export const zepAddUserTool: ToolConfig = { metadata: { type: 'json', required: false, - visibility: 'user-only', - description: 'Additional metadata as JSON object', + visibility: 'user-or-llm', + description: 'Additional metadata as JSON object (e.g., {"key": "value"})', }, apiKey: { type: 'string', diff --git a/apps/sim/tools/zep/create_thread.ts b/apps/sim/tools/zep/create_thread.ts index bea06a93a..fac68a726 100644 --- a/apps/sim/tools/zep/create_thread.ts +++ b/apps/sim/tools/zep/create_thread.ts @@ -12,14 +12,14 @@ export const zepCreateThreadTool: ToolConfig = { threadId: { type: 'string', required: true, - visibility: 'user-only', - description: 'Unique identifier for the thread', + visibility: 'user-or-llm', + description: 'Unique identifier for the thread (e.g., "thread_abc123")', }, userId: { type: 'string', required: true, - visibility: 'user-only', - description: 'User ID associated with the thread', + visibility: 'user-or-llm', + description: 'User ID associated with the thread (e.g., "user_123")', }, apiKey: { type: 'string', diff --git a/apps/sim/tools/zep/delete_thread.ts b/apps/sim/tools/zep/delete_thread.ts index af2117906..2603c79e9 100644 --- a/apps/sim/tools/zep/delete_thread.ts +++ b/apps/sim/tools/zep/delete_thread.ts @@ -11,8 +11,8 @@ export const zepDeleteThreadTool: ToolConfig = { threadId: { type: 'string', required: true, - visibility: 'user-only', - description: 'Thread ID to delete', + visibility: 'user-or-llm', + description: 'Thread ID to delete (e.g., "thread_abc123")', }, apiKey: { type: 'string', diff --git a/apps/sim/tools/zep/get_context.ts b/apps/sim/tools/zep/get_context.ts index b97ce5cb3..acefc5bba 100644 --- a/apps/sim/tools/zep/get_context.ts +++ b/apps/sim/tools/zep/get_context.ts @@ -11,8 +11,8 @@ export const zepGetContextTool: ToolConfig = { threadId: { type: 'string', required: true, - visibility: 'user-only', - description: 'Thread ID to get context from', + visibility: 'user-or-llm', + description: 'Thread ID to get context from (e.g., "thread_abc123")', }, mode: { type: 'string', diff --git a/apps/sim/tools/zep/get_messages.ts b/apps/sim/tools/zep/get_messages.ts index 6e2dffff7..5b9831ab2 100644 --- a/apps/sim/tools/zep/get_messages.ts +++ b/apps/sim/tools/zep/get_messages.ts @@ -12,14 +12,14 @@ export const zepGetMessagesTool: ToolConfig = { threadId: { type: 'string', required: true, - visibility: 'user-only', - description: 'Thread ID to get messages from', + visibility: 'user-or-llm', + description: 'Thread ID to get messages from (e.g., "thread_abc123")', }, limit: { type: 'number', required: false, - visibility: 'user-only', - description: 'Maximum number of messages to return', + visibility: 'user-or-llm', + description: 'Maximum number of messages to return (e.g., 10, 50, 100)', }, cursor: { type: 'string', @@ -30,7 +30,7 @@ export const zepGetMessagesTool: ToolConfig = { lastn: { type: 'number', required: false, - visibility: 'user-only', + visibility: 'user-or-llm', description: 'Number of most recent messages to return (overrides limit and cursor)', }, apiKey: { diff --git a/apps/sim/tools/zep/get_threads.ts b/apps/sim/tools/zep/get_threads.ts index 9a5593e1a..d0a466013 100644 --- a/apps/sim/tools/zep/get_threads.ts +++ b/apps/sim/tools/zep/get_threads.ts @@ -13,15 +13,15 @@ export const zepGetThreadsTool: ToolConfig = { type: 'number', required: false, default: 10, - visibility: 'user-only', - description: 'Number of threads to retrieve per page', + visibility: 'user-or-llm', + description: 'Number of threads to retrieve per page (e.g., 10, 25, 50)', }, pageNumber: { type: 'number', required: false, default: 1, - visibility: 'user-only', - description: 'Page number for pagination', + visibility: 'user-or-llm', + description: 'Page number for pagination (e.g., 1, 2, 3)', }, orderBy: { type: 'string', diff --git a/apps/sim/tools/zep/get_user.ts b/apps/sim/tools/zep/get_user.ts index d60f7c10c..cb0ed7d9d 100644 --- a/apps/sim/tools/zep/get_user.ts +++ b/apps/sim/tools/zep/get_user.ts @@ -12,8 +12,8 @@ export const zepGetUserTool: ToolConfig = { userId: { type: 'string', required: true, - visibility: 'user-only', - description: 'User ID to retrieve', + visibility: 'user-or-llm', + description: 'User ID to retrieve (e.g., "user_123")', }, apiKey: { type: 'string', diff --git a/apps/sim/tools/zep/get_user_threads.ts b/apps/sim/tools/zep/get_user_threads.ts index 9948b02ce..7929b170e 100644 --- a/apps/sim/tools/zep/get_user_threads.ts +++ b/apps/sim/tools/zep/get_user_threads.ts @@ -12,15 +12,15 @@ export const zepGetUserThreadsTool: ToolConfig = { userId: { type: 'string', required: true, - visibility: 'user-only', - description: 'User ID to get threads for', + visibility: 'user-or-llm', + description: 'User ID to get threads for (e.g., "user_123")', }, limit: { type: 'number', required: false, default: 10, - visibility: 'user-only', - description: 'Maximum number of threads to return', + visibility: 'user-or-llm', + description: 'Maximum number of threads to return (e.g., 10, 25, 50)', }, apiKey: { type: 'string', diff --git a/apps/sim/tools/zoom/create_meeting.ts b/apps/sim/tools/zoom/create_meeting.ts index b9452e1f4..0ebba188b 100644 --- a/apps/sim/tools/zoom/create_meeting.ts +++ b/apps/sim/tools/zoom/create_meeting.ts @@ -19,14 +19,15 @@ export const zoomCreateMeetingTool: ToolConfig