fix(docs-gen): preserve apostrophes in tool descriptions when generating docs

waleedlatif1 · waleedlatif1 · commit 701870e5b738 · 2026-06-16T22:53:14.000-07:00
The doc generator extracted tool descriptions with a character class that
excluded both quote types (['"]([^'"]...)['"]), so a double-quoted description
containing an apostrophe (e.g. "Find someone's email") was truncated at the
apostrophe — the generated docs/catalog showed stubs like "Find someone".

Anchor extraction on the actual opening quote (single/double/backtick), matching
the existing extractDescription helper, in both buildToolDescriptionMap and
extractToolInfo. Regenerated docs restore full descriptions across all affected
integrations (Apollo, Ahrefs, LeadMagic, Findymail, OpenAI, Slack, etc.).
diff --git a/apps/docs/content/docs/en/integrations/agentphone.mdx b/apps/docs/content/docs/en/integrations/agentphone.mdx
@@ -568,7 +568,7 @@ Send an outbound SMS or iMessage from an AgentPhone agent
 
 ### `agentphone_update_contact`
 
-Update a contact
+Update a contact's fields
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/ahrefs.mdx b/apps/docs/content/docs/en/integrations/ahrefs.mdx
@@ -35,7 +35,7 @@ Integrate Ahrefs SEO tools into your workflow. Analyze domain ratings, backlinks
 
 ### `ahrefs_domain_rating`
 
-Get the Domain Rating (DR) and Ahrefs Rank for a target domain. Domain Rating shows the strength of a website
+Get the Domain Rating (DR) and Ahrefs Rank for a target domain. Domain Rating shows the strength of a website's backlink profile on a scale from 0 to 100.
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/apollo.mdx b/apps/docs/content/docs/en/integrations/apollo.mdx
@@ -41,7 +41,7 @@ Integrates Apollo.io into the workflow. Search for people and companies, enrich
 
 ### `apollo_people_search`
 
-Search Apollo
+Search Apollo's database for people using demographic filters
 
 #### Input
 
@@ -126,7 +126,7 @@ Enrich data for up to 10 people at once using Apollo
 
 ### `apollo_organization_search`
 
-Search Apollo
+Search Apollo's database for companies using filters
 
 #### Input
 
@@ -263,7 +263,7 @@ Update an existing contact in your Apollo database
 
 ### `apollo_contact_search`
 
-Search your team
+Search your team's contacts in Apollo
 
 #### Input
 
@@ -381,7 +381,7 @@ Update an existing account in your Apollo database
 
 ### `apollo_account_search`
 
-Search your team
+Search your team's accounts in Apollo. Display limit: 50,000 records (100 records per page, 500 pages max). Use filters to narrow results. Master key required.
 
 #### Input
 
@@ -480,7 +480,7 @@ Create a new deal for an account in your Apollo database (master key required)
 
 ### `apollo_opportunity_search`
 
-Search and list all deals/opportunities in your team
+Search and list all deals/opportunities in your team's Apollo account
 
 #### Input
 
@@ -544,7 +544,7 @@ Update an existing deal/opportunity in your Apollo database
 
 ### `apollo_sequence_search`
 
-Search for sequences/campaigns in your team
+Search for sequences/campaigns in your team's Apollo account (master key required)
 
 #### Input
 
@@ -650,7 +650,7 @@ Search for tasks in Apollo
 
 ### `apollo_email_accounts`
 
-Get list of team
+Get list of team's linked email accounts in Apollo
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/azure_devops.mdx b/apps/docs/content/docs/en/integrations/azure_devops.mdx
@@ -373,7 +373,7 @@ Fetch full details of a single work item by ID from Azure DevOps, including titl
 
 ### `azure_devops_get_work_items_batch`
 
-Fetch full details for multiple work items by ID from Azure DevOps. Pass comma-separated IDs (e.g. 
+Fetch full details for multiple work items by ID from Azure DevOps. Pass comma-separated IDs (e.g. "123,456,789"). Requests with more than 200 IDs are automatically split into chunks.
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/context_dev.mdx b/apps/docs/content/docs/en/integrations/context_dev.mdx
@@ -275,7 +275,7 @@ Detect and extract structured product details from a single product page URL.
 
 ### `context_dev_extract_products`
 
-Extract the product catalog from a brand
+Extract the product catalog from a brand's website by domain (beta).
 
 #### Input
 
@@ -338,7 +338,7 @@ Extract the font families, usage stats, and font files used by a domain.
 
 ### `context_dev_scrape_styleguide`
 
-Extract a domain
+Extract a domain's design system: colors, typography, spacing, shadows, and UI components.
 
 #### Input
 
@@ -657,7 +657,7 @@ Queue a domain for brand-data prefetching to reduce latency on later requests (s
 
 ### `context_dev_prefetch_by_email`
 
-Queue an email
+Queue an email's domain for brand-data prefetching to reduce later latency (subscribers; 0 credits). Free/disposable emails are rejected.
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/datagma.mdx b/apps/docs/content/docs/en/integrations/datagma.mdx
@@ -35,7 +35,7 @@ Integrate Datagma to find verified work emails from a name and company, enrich p
 
 ### `datagma_find_email`
 
-Find a verified work email from a person
+Find a verified work email from a person's full name and company. Uses 1 credit when a verified email is found.
 
 #### Input
 
@@ -61,7 +61,7 @@ Find a verified work email from a person
 
 ### `datagma_enrich_person`
 
-Enrich a person
+Enrich a person's profile using their email, LinkedIn URL, or full name and company. Returns job title, company, location, and social data. Uses 2 credits per match; add 30 credits when a phone number is found.
 
 #### Input
 
@@ -125,7 +125,7 @@ Enrich a company profile using a domain, company name, or SIREN number (France).
 
 ### `datagma_find_phone`
 
-Find a mobile phone number from a person
+Find a mobile phone number from a person's LinkedIn URL. Optionally supply an email to improve match accuracy. Uses 30 credits when a number is found.
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/enrich.mdx b/apps/docs/content/docs/en/integrations/enrich.mdx
@@ -181,7 +181,7 @@ Enrich a LinkedIn profile URL with detailed information including positions, edu
 
 ### `enrich_find_email`
 
-Find a person
+Find a person's work email address using their full name and company domain.
 
 #### Input
 
@@ -922,7 +922,7 @@ Get comments on a LinkedIn post by its URL.
 
 ### `enrich_search_people_activities`
 
-Get a person
+Get a person's LinkedIn activities (posts, comments, or articles) by profile ID.
 
 #### Input
 
@@ -957,7 +957,7 @@ Get a person
 
 ### `enrich_search_company_activities`
 
-Get a company
+Get a company's LinkedIn activities (posts, comments, or articles) by company ID.
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/file.mdx b/apps/docs/content/docs/en/integrations/file.mdx
@@ -77,7 +77,7 @@ Read workspace file objects, extract the text content of files, fetch and parse
 
 ### `file_write`
 
-Create a new workspace file. If a file with the same name already exists, a numeric suffix is added (e.g., 
+Create a new workspace file. If a file with the same name already exists, a numeric suffix is added (e.g., "data (1).csv").
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/findymail.mdx b/apps/docs/content/docs/en/integrations/findymail.mdx
@@ -57,7 +57,7 @@ Verifies the deliverability of an email address. Uses one verifier credit.
 
 ### `findymail_find_email_from_name`
 
-Find someone
+Find someone's email from their name and a company domain or company name. Uses one finder credit when a verified email is found.
 
 #### Input
 
@@ -99,7 +99,7 @@ Find verified contacts at a given domain matching one or more target roles (max
 
 ### `findymail_find_email_from_linkedin`
 
-Find someone
+Find someone's email from a LinkedIn profile URL or username. Uses one finder credit when a verified email is found.
 
 #### Input
 
@@ -203,7 +203,7 @@ Find employees at a company by website and target job titles. Uses 1 credit per
 
 ### `findymail_find_phone`
 
-Find someone
+Find someone's phone number from a LinkedIn profile URL. Uses 10 finder credits if a phone is found. EU citizens are excluded for legal reasons.
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/google_calendar.mdx b/apps/docs/content/docs/en/integrations/google_calendar.mdx
@@ -239,7 +239,7 @@ Get instances of a recurring event from Google Calendar. Returns API-aligned fie
 
 ### `google_calendar_list_calendars`
 
-List all calendars in the user
+List all calendars in the user's calendar list. Returns API-aligned fields only.
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/google_groups.mdx b/apps/docs/content/docs/en/integrations/google_groups.mdx
@@ -199,7 +199,7 @@ Remove a member from a Google Group
 
 ### `google_groups_update_member`
 
-Update a member
+Update a member's role in a Google Group (promote or demote)
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/google_slides.mdx b/apps/docs/content/docs/en/integrations/google_slides.mdx
@@ -539,7 +539,7 @@ Remove bullets/numbering from paragraphs in a shape or table cell.
 
 ### `google_slides_replace_all_shapes_with_image`
 
-Find every shape whose text matches the given token (e.g. \{\{cover-image\}\}) and replace it with an image, preserving the shape
+Find every shape whose text matches the given token (e.g. \{\{cover-image\}\}) and replace it with an image, preserving the shape's position and bounds.
 
 #### Input
 
@@ -565,7 +565,7 @@ Find every shape whose text matches the given token (e.g. \{\{cover-image\}\}) a
 
 ### `google_slides_replace_image`
 
-Replace the source of an existing image with a new image URL, preserving the image
+Replace the source of an existing image with a new image URL, preserving the image's position, size, and properties.
 
 #### Input
 
@@ -625,7 +625,7 @@ Update image properties — brightness, contrast, transparency, crop, outline, l
 
 ### `google_slides_update_shape_properties`
 
-Update a shape
+Update a shape's appearance — background fill color, outline, link, content alignment, autofit. Pass only the properties you want to change.
 
 #### Input
 
@@ -887,7 +887,7 @@ Update line appearance — color, weight, dash style, arrows, link.
 
 ### `google_slides_update_line_category`
 
-Change a connector line
+Change a connector line's category (STRAIGHT, BENT, or CURVED).
 
 #### Input
 
@@ -1243,7 +1243,7 @@ Refresh an embedded linked Sheets chart so it reflects the latest spreadsheet da
 
 ### `google_slides_replace_all_shapes_with_sheets_chart`
 
-Find every shape matching a text token (e.g. \{\{revenue-chart\}\}) and replace each with the same embedded Sheets chart, preserving the shape
+Find every shape matching a text token (e.g. \{\{revenue-chart\}\}) and replace each with the same embedded Sheets chart, preserving the shape's position and bounds.
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/jira_service_management.mdx b/apps/docs/content/docs/en/integrations/jira_service_management.mdx
@@ -1109,7 +1109,7 @@ Get the attribute definitions for an Assets (Insight/CMDB) object type. Use the
 
 ### `jsm_search_objects_aql`
 
-Search Assets (Insight/CMDB) objects using AQL (Assets Query Language), e.g. objectType = 
+Search Assets (Insight/CMDB) objects using AQL (Assets Query Language), e.g. objectType = "Host" AND Status = "Running". Supports pagination.
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/kalshi.mdx b/apps/docs/content/docs/en/integrations/kalshi.mdx
@@ -458,7 +458,7 @@ Retrieve OHLC candlestick data aggregated across all markets in an event (V2 - f
 
 ### `kalshi_get_fills`
 
-Retrieve your portfolio
+Retrieve your portfolio's fills/trades from Kalshi (V2 - exact API response)
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/leadmagic.mdx b/apps/docs/content/docs/en/integrations/leadmagic.mdx
@@ -63,7 +63,7 @@ Verify an email address for deliverability. Charges 0.25 credits for definitive
 
 ### `leadmagic_find_email`
 
-Find someone
+Find someone's verified work email from their name and company domain. Charges 1 credit when a valid email is found; free when no result.
 
 #### Input
 
@@ -95,7 +95,7 @@ Find someone
 
 ### `leadmagic_find_mobile`
 
-Find a person
+Find a person's direct mobile number from their LinkedIn profile URL or email. Charges 5 credits when a number is found; free when no result.
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/luma.mdx b/apps/docs/content/docs/en/integrations/luma.mdx
@@ -295,7 +295,7 @@ Retrieve the guest list for a Luma event with optional filtering by approval sta
 
 ### `luma_get_guest`
 
-Retrieve a single guest
+Retrieve a single guest's details on a Luma event, including approval status, registration timestamps, and contact info.
 
 #### Input
 
@@ -361,7 +361,7 @@ Send email invitations to guests for a Luma event. Unlike Add Guests (which regi
 
 ### `luma_update_guest_status`
 
-Update a guest
+Update a guest's approval status on a Luma event — approve, decline, waitlist, or set to pending. Identify the guest by email or guest ID.
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/neo4j.mdx b/apps/docs/content/docs/en/integrations/neo4j.mdx
@@ -36,7 +36,7 @@ Integrate Neo4j graph database into the workflow. Can query, create, merge, upda
 
 ### `neo4j_query`
 
-Execute MATCH queries to read nodes and relationships from Neo4j graph database. For best performance and to prevent large result sets, include LIMIT in your query (e.g., 
+Execute MATCH queries to read nodes and relationships from Neo4j graph database. For best performance and to prevent large result sets, include LIMIT in your query (e.g., "MATCH (n:User) RETURN n LIMIT 100") or use LIMIT $limit with a limit parameter.
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/openai.mdx b/apps/docs/content/docs/en/integrations/openai.mdx
@@ -37,7 +37,7 @@ Integrate Embeddings into the workflow. Can generate embeddings from text.
 
 ### `openai_embeddings`
 
-Generate embeddings from text using OpenAI
+Generate embeddings from text using OpenAI's embedding models
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/perplexity.mdx b/apps/docs/content/docs/en/integrations/perplexity.mdx
@@ -65,7 +65,7 @@ Generate completions using Perplexity AI chat models
 
 ### `perplexity_search`
 
-Get ranked search results from Perplexity
+Get ranked search results from Perplexity's continuously refreshed index with advanced filtering and customization options
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/pinecone.mdx b/apps/docs/content/docs/en/integrations/pinecone.mdx
@@ -37,7 +37,7 @@ Integrate Pinecone into the workflow. Can generate embeddings, upsert text, sear
 
 ### `pinecone_generate_embeddings`
 
-Generate embeddings from text using Pinecone
+Generate embeddings from text using Pinecone's hosted models
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/posthog.mdx b/apps/docs/content/docs/en/integrations/posthog.mdx
@@ -152,7 +152,7 @@ Delete a person from PostHog. This will remove all associated events and data. U
 
 ### `posthog_query`
 
-Execute a HogQL query in PostHog. HogQL is PostHog
+Execute a HogQL query in PostHog. HogQL is PostHog's SQL-like query language for analytics. Use this for advanced data retrieval and analysis.
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/redis.mdx b/apps/docs/content/docs/en/integrations/redis.mdx
@@ -111,7 +111,7 @@ List all keys matching a pattern in Redis. Avoid using on large databases in pro
 
 ### `redis_command`
 
-Execute a raw Redis command as a JSON array (e.g. [
+Execute a raw Redis command as a JSON array (e.g. ["HSET", "key", "field", "value"]).
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/sap_s4hana.mdx b/apps/docs/content/docs/en/integrations/sap_s4hana.mdx
@@ -338,7 +338,7 @@ Retrieve a single customer by Customer key from SAP S/4HANA Cloud (API_BUSINESS_
 
 ### `sap_s4hana_update_customer`
 
-Update fields on an A_Customer entity in SAP S/4HANA Cloud (API_BUSINESS_PARTNER). Uses HTTP MERGE (OData v2 partial update) — only the fields you provide are written; existing values are preserved. A_Customer is limited to modifiable fields such as OrderIsBlockedForCustomer, DeliveryIsBlocked, BillingIsBlockedForCustomer (Edm.String reason codes like 
+Update fields on an A_Customer entity in SAP S/4HANA Cloud (API_BUSINESS_PARTNER). Uses HTTP MERGE (OData v2 partial update) — only the fields you provide are written; existing values are preserved. A_Customer is limited to modifiable fields such as OrderIsBlockedForCustomer, DeliveryIsBlocked, BillingIsBlockedForCustomer (Edm.String reason codes like "01"), PostingIsBlocked, and DeletionIndicator (Edm.Boolean). If-Match defaults to a wildcard - for safe concurrent updates pass the ETag from a prior GET to avoid lost updates.
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/slack.mdx b/apps/docs/content/docs/en/integrations/slack.mdx
@@ -1642,7 +1642,7 @@ Push a new view onto an existing modal stack in Slack. Limited to 2 additional v
 
 ### `slack_publish_view`
 
-Publish a static view to a user
+Publish a static view to a user's Home tab in Slack. Used to create or update the app's Home tab experience.
 
 #### Input
 
diff --git a/apps/docs/content/docs/en/integrations/table.mdx b/apps/docs/content/docs/en/integrations/table.mdx
diff --git a/apps/docs/content/docs/en/integrations/tavily.mdx b/apps/docs/content/docs/en/integrations/tavily.mdx
diff --git a/apps/docs/content/docs/en/integrations/upstash.mdx b/apps/docs/content/docs/en/integrations/upstash.mdx
diff --git a/apps/docs/content/docs/en/integrations/vercel.mdx b/apps/docs/content/docs/en/integrations/vercel.mdx
diff --git a/apps/docs/content/docs/en/integrations/wiza.mdx b/apps/docs/content/docs/en/integrations/wiza.mdx
diff --git a/apps/docs/content/docs/en/integrations/x.mdx b/apps/docs/content/docs/en/integrations/x.mdx
diff --git a/apps/sim/lib/integrations/integrations.json b/apps/sim/lib/integrations/integrations.json
diff --git a/scripts/generate-docs.ts b/scripts/generate-docs.ts
