fix(docs): render items output properties

Author: Bill Leoutsakos

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

@@ -247,6 +247,7 @@ Retrieve detailed call data including trackers, topics, highlights, and AI spotl
 |       ↳ `section` | string | Outline section name |
 |       ↳ `startTime` | number | Section start in seconds from call start |
 |       ↳ `duration` | number | Section duration in seconds |
+|       ↳ `items` | array | Bullet items within the section |
 |     ↳ `keyPoints` | array | AI-generated key points of the call |
 |       ↳ `text` | string | Key point text |
 |     ↳ `callOutcome` | object | AI-determined call outcome \(Call Spotlight\) |
@@ -273,6 +274,9 @@ Retrieve detailed call data including trackers, topics, highlights, and AI spotl
 |         ↳ `occurrences` | array | Details per occurrence |
 |     ↳ `highlights` | array | AI-generated highlights including next steps, action items, and key moments |
 |       ↳ `title` | string | Title of the highlight |
+|       ↳ `items` | array | Individual highlight items |
+|         ↳ `text` | string | Text of the highlight item |
+|         ↳ `startTimes` | array | Start times in seconds from call start |
 |   ↳ `interaction` | object | Interaction statistics |
 |     ↳ `interactionStats` | array | Interaction stat measurements \(Longest Monologue, Interactivity, Patience, etc.\) |
 |       ↳ `name` | string | Stat name |

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

@@ -146,6 +146,16 @@ Apply multiple updates to a form (add items, update info, change settings, etc.)
 |     ↳ `quizSettings` | object | Quiz settings |
 |       ↳ `isQuiz` | boolean | Whether the form is a quiz |
 |     ↳ `emailCollectionType` | string | Email collection type |
+|   ↳ `items` | array | The form items \(questions, sections, etc.\) |
+|     ↳ `itemId` | string | Item ID |
+|     ↳ `title` | string | Item title |
+|     ↳ `description` | string | Item description |
+|     ↳ `questionItem` | json | Question item configuration |
+|     ↳ `questionGroupItem` | json | Question group configuration |
+|     ↳ `pageBreakItem` | json | Page break configuration |
+|     ↳ `textItem` | json | Text item configuration |
+|     ↳ `imageItem` | json | Image item configuration |
+|     ↳ `videoItem` | json | Video item configuration |
 |   ↳ `revisionId` | string | The revision ID of the form |
 |   ↳ `responderUri` | string | The URI to share with responders |
 |   ↳ `linkedSheetId` | string | The ID of the linked Google Sheet |

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

@@ -68,6 +68,11 @@ List one page of a NetSuite record collection, optionally filtered with a q expr
 |   ↳ `links` | array | Oracle HATEOAS links for the response |
 |     ↳ `rel` | string | Link relationship |
 |     ↳ `href` | string | Link target |
+|   ↳ `items` | array | Matching record references in this page |
+|     ↳ `id` | string | NetSuite record ID |
+|     ↳ `links` | array | Oracle HATEOAS links for the record |
+|       ↳ `rel` | string | Link relationship |
+|       ↳ `href` | string | Link target |
 |   ↳ `count` | number | Number of items in this page |
 |   ↳ `hasMore` | boolean | Whether another page is available |
 |   ↳ `offset` | number | Offset of this page |
@@ -526,6 +531,7 @@ Execute one page of a SuiteQL query through SuiteTalk REST web services.
 |   ↳ `links` | array | Oracle HATEOAS links for the response |
 |     ↳ `rel` | string | Link relationship |
 |     ↳ `href` | string | Link target |
+|   ↳ `items` | array | Items in this page; item fields depend on the record, query, or dataset |
 |   ↳ `count` | number | Number of items in this page |
 |   ↳ `hasMore` | boolean | Whether another page is available |
 |   ↳ `offset` | number | Offset of this page |
@@ -555,6 +561,7 @@ List one page of SuiteAnalytics Workbook datasets available to the authenticated
 |   ↳ `links` | array | Oracle HATEOAS links for the response |
 |     ↳ `rel` | string | Link relationship |
 |     ↳ `href` | string | Link target |
+|   ↳ `items` | array | Items in this page; item fields depend on the record, query, or dataset |
 |   ↳ `count` | number | Number of items in this page |
 |   ↳ `hasMore` | boolean | Whether another page is available |
 |   ↳ `offset` | number | Offset of this page |
@@ -585,6 +592,7 @@ Execute one page of a standard or custom SuiteAnalytics Workbook dataset.
 |   ↳ `links` | array | Oracle HATEOAS links for the response |
 |     ↳ `rel` | string | Link relationship |
 |     ↳ `href` | string | Link target |
+|   ↳ `items` | array | Items in this page; item fields depend on the record, query, or dataset |
 |   ↳ `count` | number | Number of items in this page |
 |   ↳ `hasMore` | boolean | Whether another page is available |
 |   ↳ `offset` | number | Offset of this page |
@@ -612,6 +620,11 @@ List record types exposed to the authenticated role by the REST metadata catalog
 |   ↳ `links` | array | Oracle HATEOAS links for the response |
 |     ↳ `rel` | string | Link relationship |
 |     ↳ `href` | string | Link target |
+|   ↳ `items` | array | Record types exposed to the authenticated role |
+|     ↳ `name` | string | REST record type script ID |
+|     ↳ `links` | array | Oracle HATEOAS links for the response |
+|       ↳ `rel` | string | Link relationship |
+|       ↳ `href` | string | Link target |
 
 ### NetSuite Get Record Metadata
 
@@ -663,6 +676,10 @@ List tasks for an asynchronous job or retrieve one task's completion status.
 |   ↳ `progress` | string | Current task progress state |
 |   ↳ `startTime` | string | Task start time |
 |   ↳ `count` | number | Number of returned tasks |
+|   ↳ `items` | array | Asynchronous task entries |
+|     ↳ `links` | array | Links to individual tasks |
+|       ↳ `rel` | string | Link relationship |
+|       ↳ `href` | string | Link target |
 |   ↳ `links` | array | HATEOAS links for the job or task collection |
 |     ↳ `rel` | string | Link relationship |
 |     ↳ `href` | string | Link target |

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

@@ -59,6 +59,7 @@ List all vaults accessible by the Connect token or Service Account
 |   ↳ `description` | string | Vault description |
 |   ↳ `attributeVersion` | number | Vault attribute version |
 |   ↳ `contentVersion` | number | Vault content version |
+|   ↳ `items` | number | Number of items in the vault |
 |   ↳ `type` | string | Vault type \(USER_CREATED, PERSONAL, or EVERYONE\) |
 |   ↳ `createdAt` | string | Creation timestamp |
 |   ↳ `updatedAt` | string | Last update timestamp |

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

@@ -1479,6 +1479,7 @@ List allocations on an expense (GET /expensereports/v4/users/\{userId\}/context/
 | --------- | ---- | ----------- |
 | `status` | number | HTTP status code returned by Concur |
 | `data` | json | Allocations list payload |
+|   ↳ `items` | array | Array of allocation objects \(allocationId, accountCode, percentage, allocationAmount, approvedAmount, claimedAmount, customData, expenseId, isSystemAllocation, isPercentEdited, overLimitAccountCode\) |
 
 ### SAP Concur List Attendee Associations
 
@@ -1547,6 +1548,12 @@ List budget categories (GET /budget/v4/budgetCategory).
 | --------- | ---- | ----------- |
 | `status` | number | HTTP status code returned by Concur |
 | `data` | json | Budget categories collection payload |
+|   ↳ `items` | array | Array of budget category objects |
+|     ↳ `id` | string | Category ID |
+|     ↳ `name` | string | Admin-facing category name |
+|     ↳ `description` | string | Friendly name |
+|     ↳ `statusType` | string | Status: OPEN or REMOVED |
+|     ↳ `expenseTypes` | array | Expense types in this category \(id, featureTypeCode, expenseTypeCode, name\) |
 
 ### SAP Concur List Budgets
 
@@ -1573,6 +1580,7 @@ List budget item headers (GET /budget/v4/budgetItemHeader).
 | --------- | ---- | ----------- |
 | `status` | number | HTTP status code returned by Concur |
 | `data` | json | Budget headers collection payload |
+|   ↳ `items` | array | Array of budget item header summaries \(id, name, description, budgetItemStatusType, budgetType, currencyCode, fiscalYear, budgetAmounts, owner, ...\) |
 |   ↳ `offset` | number | Page offset |
 |   ↳ `limit` | number | Page size |
 |   ↳ `totalCount` | number | Total result count |

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

@@ -267,6 +267,9 @@ Get metadata (and optionally columns/items) for a SharePoint list
 |   ↳ `lastModifiedDateTime` | string | When the list was last modified |
 |   ↳ `list` | object | List properties \(e.g., template\) |
 |   ↳ `columns` | array | List column definitions |
+|   ↳ `items` | array | List items \(with fields when expanded\) |
+|     ↳ `id` | string | Item ID |
+|     ↳ `fields` | object | Field values for the item |
 | `lists` | array | All lists in the site when no listId/title provided |
 | `items` | array | List items with expanded fields when reading list items |
 |   ↳ `id` | string | Item ID |

apps/sim/tools/netsuite/netsuite.test.ts

@@ -2,6 +2,7 @@
  * @vitest-environment node
  */
 import { generateKeyPairSync } from 'node:crypto'
+import { readFileSync } from 'node:fs'
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
 import {
   netsuiteAttachRecordTool,
@@ -668,6 +669,26 @@ describe('NetSuite operation contracts', () => {
     }
   })
 
+  it('renders every declared collection items output in the generated integration docs', () => {
+    const docs = readFileSync(
+      new URL('../../../docs/content/docs/en/integrations/netsuite.mdx', import.meta.url),
+      'utf8'
+    )
+    const operationHeadings = [
+      'NetSuite List/Search Records',
+      'NetSuite Execute SuiteQL',
+      'NetSuite List SuiteAnalytics Datasets',
+      'NetSuite Execute SuiteAnalytics Dataset',
+      'NetSuite List Record Types',
+      'NetSuite Get Async Task Status',
+    ]
+
+    for (const heading of operationHeadings) {
+      const section = docs.split(`### ${heading}\n`, 2)[1]?.split('\n### ', 1)[0]
+      expect(section, heading).toContain('|   ↳ `items` | array |')
+    }
+  })
+
   it('lists async tasks and requires a task ID for the documented task-status endpoint', async () => {
     const calls: string[] = []
     vi.stubGlobal(

scripts/generate-docs.ts

@@ -2602,7 +2602,7 @@ function parsePropertiesContent(
       const propName = constMatch[1]
       const constName = constMatch[2]
 
-      if (propName === 'items' || propName === 'properties' || propName === 'type') {
+      if (propName === 'properties' || propName === 'type') {
         continue
       }
 
@@ -2627,7 +2627,7 @@ function parsePropertiesContent(
       const constName = propAccessMatch[2]
       const accessedProp = propAccessMatch[3]
 
-      if (propName === 'items' || propName === 'properties' || propName === 'type') {
+      if (propName === 'properties' || propName === 'type') {
         continue
       }
 
@@ -2675,7 +2675,9 @@ function parsePropertiesContent(
   while ((match = propStartRegex.exec(propertiesContent)) !== null) {
     const propName = match[1]
 
-    if (propName === 'items' || propName === 'properties') {
+    // `items` can be an API response field. Nested array-schema `items` entries are
+    // excluded by the depth check below, so only the schema container itself is reserved here.
+    if (propName === 'properties') {
       continue
     }