Preserve inherited tool versions in generated integration docs

Author: Sg312

apps/docs/content/docs/integrations/github.mdx

@@ -3414,6 +3414,46 @@ List users who have starred a repository
 |   ↳ `repos_url` | string | Repos API URL |
 | `count` | number | Number of stargazers returned |
 
+### GitHub List Review Threads
+
+List one page of a pull request's review threads with their comments, plus the newest submitted review.
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `owner` | string | Yes | Repository owner |
+| `repo` | string | Yes | Repository name |
+| `pullNumber` | number | Yes | Pull request number |
+| `threadsPerPage` | number | No | Review threads to fetch in this page \(1-100\) |
+| `commentsPerThread` | number | No | Comments to fetch per thread \(1-100\) |
+| `cursor` | string | No | Cursor from a previous page \(endCursor\) to continue from |
+| `apiKey` | string | Yes | GitHub API token with pull request read access |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `threads` | array | Review threads in this page |
+|   ↳ `id` | string | Review thread node ID |
+|   ↳ `isResolved` | boolean | Whether the thread is resolved |
+|   ↳ `path` | string | Repository-relative file path |
+|   ↳ `line` | number | Line the thread is anchored to |
+|   ↳ `commentsTotalCount` | number | Total comments on the thread; exceeds the fetched count when the thread was truncated |
+|   ↳ `comments` | array | Fetched comments, oldest first |
+|     ↳ `body` | string | Comment body |
+|     ↳ `authorAssociation` | string | Author's association with the repository \(OWNER, MEMBER, ...\) |
+|     ↳ `authorLogin` | string | Author login |
+|     ↳ `authorType` | string | Author GraphQL type \(User, Bot, Organization\) |
+| `totalCount` | number | Total review threads on the pull request |
+| `hasNextPage` | boolean | Whether more thread pages remain |
+| `endCursor` | string | Cursor to pass as `cursor` for the next page |
+| `latestReview` | object | Newest submitted review on the pull request |
+|   ↳ `state` | string | Review state |
+|   ↳ `submittedAt` | string | Submission timestamp |
+|   ↳ `authorLogin` | string | Reviewer login |
+|   ↳ `authorType` | string | Reviewer GraphQL type \(User, Bot\) |
+
 
 
 ## Triggers

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

@@ -300,6 +300,21 @@ Remove label(s) from a Gmail message. Returns API-aligned fields only.
 | `threadId` | string | Gmail thread ID |
 | `labelIds` | array | Updated email labels |
 
+### Gmail List Labels
+
+List all labels in a Gmail account
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+
+#### Output
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `labels` | json | Array of label objects with id, name, type, and visibility settings |
+
 
 
 ## Triggers

apps/docs/content/docs/integrations/greptile.mdx

@@ -53,35 +53,6 @@ Query repositories in natural language and get answers with relevant code refere
 |   ↳ `summary` | string | Summary of the code section |
 |   ↳ `distance` | number | Similarity score \(lower = more relevant\) |
 
-### Greptile Search
-
-Search repositories in natural language and get relevant code references without generating an answer. Useful for finding specific code locations.
-
-#### Input
-
-| Parameter | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `query` | string | Yes | Natural language search query to find relevant code. Example: "authentication middleware" or "database connection handling" |
-| `repositories` | string | Yes | 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` | string | No | Session ID for conversation continuity. Use the same sessionId across multiple searches to maintain context. Example: "session-abc123" |
-| `genius` | boolean | No | Enable genius mode for more thorough search \(slower but more accurate\) |
-| `apiKey` | string | Yes | Greptile API key |
-| `githubToken` | string | Yes | GitHub Personal Access Token with repo read access |
-
-#### Output
-
-| Parameter | Type | Description |
-| --------- | ---- | ----------- |
-| `sources` | array | Relevant code references matching the search query |
-|   ↳ `repository` | string | Repository name \(owner/repo\) |
-|   ↳ `remote` | string | Git remote \(github/gitlab\) |
-|   ↳ `branch` | string | Branch name |
-|   ↳ `filepath` | string | Path to the file |
-|   ↳ `linestart` | number | Starting line number |
-|   ↳ `lineend` | number | Ending line number |
-|   ↳ `summary` | string | Summary of the code section |
-|   ↳ `distance` | number | Similarity score \(lower = more relevant\) |
-
 ### Greptile Index Repository
 
 Submit a repository to be indexed by Greptile. Indexing must complete before the repository can be queried. Small repos take 3-5 minutes, larger ones can take over an hour.

scripts/generate-docs.test.ts

@@ -50,6 +50,23 @@ describe('documentation editor icon metadata', () => {
 })
 
 describe('documentation tool metadata', () => {
+  it('preserves versioned inherited tools when the access array appends another operation', () => {
+    const [block] = extractAllBlockConfigs(`
+      export const ExampleBlock: BlockConfig = {
+        type: 'example', name: 'Example', category: 'tools', hideFromToolbar: true,
+        tools: { access: ['example_read', 'example_list'] },
+      }
+      export const ExampleV2Block: BlockConfig = {
+        ...ExampleBlock, type: 'example_v2', hideFromToolbar: false,
+        tools: { access: [
+          ...(ExampleBlock.tools?.access || []).map((toolId) => \`\${toolId}_v2\`),
+          'example_comments',
+        ] },
+      }
+    `)
+    expect(block.tools?.access).toEqual(['example_read_v2', 'example_list_v2', 'example_comments'])
+  })
+
   it('preserves a satisfies block and replaces only the versioned download operation', () => {
     const [block] = extractAllBlockConfigs(`
       export const DownloadBlock = ({

scripts/generate-docs.ts

@@ -2279,17 +2279,20 @@ function extractBlockConfigFromContent(
         : ownOutputs
     const toolsAccess = extractToolsAccessFromContent(blockContent)
 
-    // For tools.access, if not found directly, check if it's derived from base via map
+    /** Versioned mapped spreads retain their base tools alongside explicit additions. */
     let finalToolsAccess = toolsAccess
-    if (toolsAccess.length === 0 && baseConfig?.tools?.access) {
+    if (baseConfig?.tools?.access) {
       // Check if there's a map operation on base tools
       // Pattern: access: (SomeBlock.tools?.access || []).map((toolId) => `${toolId}_v2`)
       const mapMatch = blockContent.match(
-        /access\s*:\s*\(\s*\w+Block\.tools\?\.access\s*\|\|\s*\[\]\s*\)\.map\s*\(\s*\(\s*\w+\s*\)\s*=>\s*`\$\{\s*\w+\s*\}_v(\d+)`\s*\)/
+        /access\s*:\s*(?:\[\s*\.\.\.)?\(\s*\w+Block\.tools\?\.access\s*\|\|\s*\[\]\s*\)\.map\s*\(\s*\(\s*\w+\s*\)\s*=>\s*`\$\{\s*\w+\s*\}_v(\d+)`\s*\)/
       )
       if (mapMatch) {
         const versionSuffix = `_v${mapMatch[1]}`
-        finalToolsAccess = baseConfig.tools.access.map((tool) => `${tool}${versionSuffix}`)
+        finalToolsAccess = [
+          ...baseConfig.tools.access.map((tool) => `${tool}${versionSuffix}`),
+          ...toolsAccess,
+        ]
       }
       const replacement = blockContent.match(
         /access\s*:\s*\w+Block\.tools\.access\.map\s*\(\s*\(\s*(\w+)\s*\)\s*=>\s*\1\s*===\s*['"]([^'"]+)['"]\s*\?\s*['"]([^'"]+)['"]\s*:\s*\1\s*\)/
@@ -2698,9 +2701,22 @@ function extractToolsAccessFromContent(content: string): string[] {
   if (toolsEnd === -1) return []
 
   const toolsContent = content.substring(toolsStart, toolsEnd)
-  const accessMatch = toolsContent.match(/access\s*:\s*\[\s*([^\]]+)\s*\]/)
+  const accessMatch = /access\s*:\s*\[/.exec(toolsContent)
   if (!accessMatch) return []
-  return [...accessMatch[1].matchAll(/['"]([^'"]+)['"]/g)].map((m) => m[1])
+  const start = accessMatch.index + accessMatch[0].lastIndexOf('[')
+  const end = findMatchingClose(toolsContent, start, '[', ']')
+  if (end === -1) return []
+  const source = ts.createSourceFile(
+    'tool-access.ts',
+    `const access = ${toolsContent.slice(start, end)}`,
+    ts.ScriptTarget.Latest,
+    true
+  )
+  const statement = source.statements[0]
+  if (!statement || !ts.isVariableStatement(statement)) return []
+  const array = statement.declarationList.declarations[0]?.initializer
+  if (!array || !ts.isArrayLiteralExpression(array)) return []
+  return array.elements.flatMap((element) => (ts.isStringLiteral(element) ? [element.text] : []))
 }
 
 /**