fix(docs): stop truncating quoted descriptions, tighten the cleanup guard

Review findings from round 1.

- parseSubBlockObject read string properties with a single `['"]…[^'"]+…['"]`
  character class, which ends the match at the first quote of either kind. Any
  description holding an apostrophe inside a double-quoted string was cut
  mid-word ("Your app", "Found in your Zoom app"). Matches the opening quote to
  its own closing quote now, reusing the alternation the tool-description
  extractor already used. Restores full text across calendly, gmail,
  google_sheets, hubspot, intercom, whatsapp, and zoom.
- The stale-doc cleanup guard tested for a bare `MANUAL-CONTENT-START`
  substring, so a stray or unterminated marker would pin a stale page that has
  nothing recoverable. It now gates on what extractManualContent actually
  returns.

Author: waleedlatif1

apps/docs/content/docs/en/integrations/calendly.mdx

@@ -306,7 +306,7 @@ Trigger workflow when someone cancels a scheduled event on Calendly
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
 | `apiKey` | string | Yes | Personal Access Token |
-| `organization` | string | Yes | Organization URI for the webhook subscription. Get this from  |
+| `organization` | string | Yes | Organization URI for the webhook subscription. Get this from "Get Current User" operation. |
 
 #### Output
 
@@ -361,7 +361,7 @@ Trigger workflow when someone schedules a new event on Calendly
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
 | `apiKey` | string | Yes | Personal Access Token |
-| `organization` | string | Yes | Organization URI for the webhook subscription. Get this from  |
+| `organization` | string | Yes | Organization URI for the webhook subscription. Get this from "Get Current User" operation. |
 
 #### Output
 
@@ -416,7 +416,7 @@ Trigger workflow when someone submits a Calendly routing form
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
 | `apiKey` | string | Yes | Personal Access Token |
-| `organization` | string | Yes | Organization URI for the webhook subscription. Get this from  |
+| `organization` | string | Yes | Organization URI for the webhook subscription. Get this from "Get Current User" operation. |
 
 #### Output
 
@@ -451,7 +451,7 @@ Trigger workflow from any Calendly webhook event
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
 | `apiKey` | string | Yes | Personal Access Token |
-| `organization` | string | Yes | Organization URI for the webhook subscription. Get this from  |
+| `organization` | string | Yes | Organization URI for the webhook subscription. Get this from "Get Current User" operation. |
 
 #### Output
 

apps/docs/content/docs/en/integrations/gmail.mdx

@@ -333,7 +333,7 @@ Triggers when new emails are received in Gmail (requires Gmail credentials)
 | `triggerCredentials` | string | Yes | This trigger requires google email credentials to access your account. |
 | `labelIds` | string | No | Choose which Gmail labels to monitor. Leave empty to monitor all emails. |
 | `labelFilterBehavior` | string | Yes | Include only emails with selected labels, or exclude emails with selected labels |
-| `searchQuery` | string | No | Optional Gmail search query to filter emails. Use the same format as Gmail search box \(e.g.,  |
+| `searchQuery` | string | No | Optional Gmail search query to filter emails. Use the same format as Gmail search box \(e.g., "subject:invoice", "from:boss@company.com", "has:attachment"\). Leave empty to search all emails. |
 | `markAsRead` | boolean | No | Automatically mark emails as read after processing |
 | `includeAttachments` | boolean | No | Download and include email attachments in the trigger payload |
 

apps/docs/content/docs/en/integrations/google_sheets.mdx

@@ -404,7 +404,7 @@ Triggers when new rows are added to a Google Sheet
 | `sheetName` | sheet-selector | Yes | The sheet tab to monitor for new rows. |
 | `manualSheetName` | string | Yes | The sheet tab to monitor for new rows. |
 | `valueRenderOption` | string | No | How values are rendered. Formatted returns display strings, Unformatted returns raw numbers/booleans, Formula returns the formula text. |
-| `dateTimeRenderOption` | string | No | How dates and times are rendered. Only applies when Value Render is not  |
+| `dateTimeRenderOption` | string | No | How dates and times are rendered. Only applies when Value Render is not "Formatted Value". |
 
 #### Output
 

apps/docs/content/docs/en/integrations/hubspot.mdx

@@ -2060,15 +2060,15 @@ Triggers when HubSpot CRM records (contacts, companies, deals, tickets, custom o
 | --------- | ---- | -------- | ----------- |
 | `triggerCredentials` | string | Yes | Connect a HubSpot account so Sim can poll your CRM on your behalf. |
 | `objectType` | string | Yes | What you want to watch. |
-| `customObjectTypeId` | string | No | HubSpot custom object type ID \(e.g.  |
+| `customObjectTypeId` | string | No | HubSpot custom object type ID \(e.g. "2-12345"\). Find it in HubSpot Settings → Objects → Custom Objects. |
 | `listId` | string | No | The HubSpot list to watch for new members. |
 | `eventType` | string | No | Created fires once per new record. Updated fires on any modification. Property Changed fires only when the chosen property changes value. |
 | `targetPropertyName` | string | No | Fires only when this specific property changes value on a record. |
 | `properties` | string | No | Properties to include on each record. Leave empty to use sensible defaults. Sim always includes the timestamps it needs internally. |
 | `pipelineId` | string | No | Restrict to a single pipeline. |
 | `stageId` | string | No | Restrict to a single stage within the selected pipeline. |
 | `ownerId` | string | No | Restrict to records owned by a specific HubSpot user. |
-| `filters` | string | No | JSON array of HubSpot search filters, AND-combined. Each item: \{ |
+| `filters` | string | No | JSON array of HubSpot search filters, AND-combined. Each item: \{"propertyName":"...","operator":"EQ","value":"..."\}. Operators: EQ, NEQ, CONTAINS_TOKEN, NOT_CONTAINS_TOKEN, GT, GTE, LT, LTE, BETWEEN, IN, NOT_IN, HAS_PROPERTY, NOT_HAS_PROPERTY. |
 | `maxRecordsPerPoll` | string | No | Soft cap on records emitted per poll \(default 50, max 1000\). Excess rolls over to the next poll. |
 
 #### Output

apps/docs/content/docs/en/integrations/intercom.mdx

@@ -1101,7 +1101,7 @@ Trigger workflow when a new lead is created in Intercom
 
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
-| `webhookSecret` | string | No | Your app |
+| `webhookSecret` | string | No | Your app's Client Secret from the Developer Hub. Used to verify webhook authenticity via X-Hub-Signature. |
 
 #### Output
 
@@ -1126,7 +1126,7 @@ Trigger workflow when a conversation is closed in Intercom
 
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
-| `webhookSecret` | string | No | Your app |
+| `webhookSecret` | string | No | Your app's Client Secret from the Developer Hub. Used to verify webhook authenticity via X-Hub-Signature. |
 
 #### Output
 
@@ -1151,7 +1151,7 @@ Trigger workflow when a new conversation is created in Intercom
 
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
-| `webhookSecret` | string | No | Your app |
+| `webhookSecret` | string | No | Your app's Client Secret from the Developer Hub. Used to verify webhook authenticity via X-Hub-Signature. |
 
 #### Output
 
@@ -1176,7 +1176,7 @@ Trigger workflow when someone replies to an Intercom conversation
 
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
-| `webhookSecret` | string | No | Your app |
+| `webhookSecret` | string | No | Your app's Client Secret from the Developer Hub. Used to verify webhook authenticity via X-Hub-Signature. |
 
 #### Output
 
@@ -1201,7 +1201,7 @@ Trigger workflow when a new user is created in Intercom
 
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
-| `webhookSecret` | string | No | Your app |
+| `webhookSecret` | string | No | Your app's Client Secret from the Developer Hub. Used to verify webhook authenticity via X-Hub-Signature. |
 
 #### Output
 
@@ -1226,7 +1226,7 @@ Trigger workflow on any Intercom webhook event
 
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
-| `webhookSecret` | string | No | Your app |
+| `webhookSecret` | string | No | Your app's Client Secret from the Developer Hub. Used to verify webhook authenticity via X-Hub-Signature. |
 
 #### Output
 

apps/docs/content/docs/en/integrations/whatsapp.mdx

@@ -369,7 +369,7 @@ Trigger workflow from WhatsApp incoming messages and message status webhooks
 
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
-| `verificationToken` | string | Yes | Enter any secure token here. You |
+| `verificationToken` | string | Yes | Enter any secure token here. You'll need to provide the same token in your WhatsApp Business Platform dashboard. |
 | `appSecret` | string | Yes | Required for WhatsApp POST signature verification. Sim uses it to validate the X-Hub-Signature-256 header on every webhook delivery. |
 
 #### Output

apps/docs/content/docs/en/integrations/zoom.mdx

@@ -431,7 +431,7 @@ Trigger workflow when a Zoom meeting ends
 
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
-| `secretToken` | string | Yes | Found in your Zoom app |
+| `secretToken` | string | Yes | Found in your Zoom app's Features page. Required for endpoint validation and webhook signature verification. |
 
 #### Output
 
@@ -454,7 +454,7 @@ Trigger workflow when a Zoom meeting starts
 
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
-| `secretToken` | string | Yes | Found in your Zoom app |
+| `secretToken` | string | Yes | Found in your Zoom app's Features page. Required for endpoint validation and webhook signature verification. |
 
 #### Output
 
@@ -477,7 +477,7 @@ Trigger workflow when a participant joins a Zoom meeting
 
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
-| `secretToken` | string | Yes | Found in your Zoom app |
+| `secretToken` | string | Yes | Found in your Zoom app's Features page. Required for endpoint validation and webhook signature verification. |
 
 #### Output
 
@@ -500,7 +500,7 @@ Trigger workflow when a participant leaves a Zoom meeting
 
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
-| `secretToken` | string | Yes | Found in your Zoom app |
+| `secretToken` | string | Yes | Found in your Zoom app's Features page. Required for endpoint validation and webhook signature verification. |
 
 #### Output
 
@@ -523,7 +523,7 @@ Trigger workflow when a Zoom cloud recording is completed
 
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
-| `secretToken` | string | Yes | Found in your Zoom app |
+| `secretToken` | string | Yes | Found in your Zoom app's Features page. Required for endpoint validation and webhook signature verification. |
 
 #### Output
 
@@ -546,7 +546,7 @@ Trigger workflow on any Zoom webhook event
 
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
-| `secretToken` | string | Yes | Found in your Zoom app |
+| `secretToken` | string | Yes | Found in your Zoom app's Features page. Required for endpoint validation and webhook signature verification. |
 
 #### Output
 

scripts/generate-docs.ts

@@ -3237,7 +3237,10 @@ function cleanupStaleToolDocs(validToolDocs: Set<string>): void {
     // MANUAL-CONTENT blocks: the writer merges against the file on disk, and a
     // deleted file reads as "no manual content". Whenever the two filters
     // disagree, keep the prose and let the mismatch be fixed deliberately.
-    if (/MANUAL-CONTENT-START/.test(fs.readFileSync(docPath, 'utf-8'))) {
+    // Gate on what `extractManualContent` can actually recover — a stray or
+    // unterminated start marker preserves nothing, so it must not pin the page.
+    const manualSections = extractManualContent(fs.readFileSync(docPath, 'utf-8'))
+    if (Object.values(manualSections).some((section) => section.length > 0)) {
       console.warn(
         `⚠ Keeping ${blockType}.mdx: considered stale but holds MANUAL-CONTENT. ` +
           `Add it to a doc-emitting set or delete it by hand once the content is migrated.`
@@ -3558,12 +3561,26 @@ function resolveConstStringValue(constName: string, content: string): string | n
  * Returns null for blocks that should be skipped (UI-only IDs, text type, readOnly).
  * Accepts optional `resolverContent` to resolve const-reference field IDs.
  */
+/**
+ * Read a quoted string property, matching the opening quote to its own closing
+ * quote. A single `['"]…[^'"]+…['"]` character class ends the match at the
+ * first quote of *either* kind, so an apostrophe inside a double-quoted string
+ * ("Doesn't fire…") truncates the value mid-word.
+ */
+function matchQuotedProperty(content: string, propName: string): string | undefined {
+  const match = new RegExp(`\\b${propName}\\s*:\\s*(?:'([^']*)'|"([^"]*)"|\`([^\`]*)\`)`).exec(
+    content
+  )
+  if (!match) return undefined
+  return match[1] ?? match[2] ?? match[3]
+}
+
 function parseSubBlockObject(
   obj: string,
   uiOnlyIds: Set<string>,
   resolverContent?: string
 ): TriggerConfigField | null {
-  let id: string | undefined = /\bid\s*:\s*['"]([^'"]+)['"]/.exec(obj)?.[1]
+  let id: string | undefined = matchQuotedProperty(obj, 'id')
 
   // Handle const-reference ids: `id: SCREAMING_CASE_IDENTIFIER`
   if (!id) {
@@ -3575,25 +3592,24 @@ function parseSubBlockObject(
 
   if (!id || uiOnlyIds.has(id)) return null
 
-  const typeMatch = /\btype\s*:\s*['"]([^'"]+)['"]/.exec(obj)
-  if (typeMatch?.[1] === 'text') return null
+  const type = matchQuotedProperty(obj, 'type')
+  if (type === 'text') return null
   if (/\breadOnly\s*:\s*true/.test(obj)) return null
 
-  const titleMatch = /\btitle\s*:\s*['"]([^'"]+)['"]/.exec(obj)
+  const title = matchQuotedProperty(obj, 'title')
   const requiredMatch = /\brequired\s*:\s*(true)/.exec(obj)
-  const placeholderMatch = /\bplaceholder\s*:\s*['"]([^'"]+)['"]/.exec(obj)
-  const descMatch = /\bdescription\s*:\s*['"]([^'"]+)['"]/.exec(obj)
+  const placeholder = matchQuotedProperty(obj, 'placeholder')
 
   // Use title as description fallback so oauth-input and other fields without
   // an explicit description still show something meaningful in the docs table.
-  const description = descMatch?.[1] ?? (titleMatch ? `${titleMatch[1]}` : undefined)
+  const description = matchQuotedProperty(obj, 'description') ?? title
 
   return {
     id,
-    title: titleMatch?.[1] ?? id,
-    type: typeMatch?.[1] ?? 'short-input',
+    title: title ?? id,
+    type: type ?? 'short-input',
     required: Boolean(requiredMatch),
-    placeholder: placeholderMatch?.[1],
+    placeholder,
     description,
   }
 }