fix(netsuite): harden integration contracts

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

@@ -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/onepassword.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/sap_concur.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/docs/content/docs/en/integrations/sharepoint.mdx

@@ -31,6 +31,45 @@ describe('Oracle NetSuite block', () => {
     }
   })
 
+  it('covers every operation on canvas and preserves required action targets', () => {
+    const byOperation = NetSuiteBlock.canvasPresentation?.sentences?.byOperation
+    if (!byOperation) throw new Error('NetSuite block must define operation canvas sentences')
+    expect(Object.keys(byOperation)).toEqual([...NETSUITE_TOOL_IDS])
+
+    const coreFields = (operation: keyof typeof byOperation) => {
+      const sentence = byOperation[operation]
+      if (!Array.isArray(sentence)) return []
+      return sentence.flatMap((part) =>
+        typeof part === 'object' && part.core && part.field ? [part.field] : []
+      )
+    }
+
+    expect(coreFields('netsuite_get_subresource')).toEqual([
+      'subresourcePath',
+      'recordType',
+      'recordId',
+    ])
+    expect(coreFields('netsuite_get_select_options')).toEqual(['fields', 'recordType'])
+    expect(coreFields('netsuite_attach_record')).toEqual([
+      'relatedType',
+      'relatedId',
+      'recordType',
+      'recordId',
+    ])
+    expect(coreFields('netsuite_detach_record')).toEqual([
+      'relatedType',
+      'relatedId',
+      'recordType',
+      'recordId',
+    ])
+    expect(coreFields('netsuite_execute_action')).toEqual(['action', 'recordType', 'recordId'])
+    expect(coreFields('netsuite_transform_record')).toEqual([
+      'recordType',
+      'recordId',
+      'targetRecordType',
+    ])
+  })
+
   it('requires the four inline credential fields and masks the private key', () => {
     for (const field of ['accountId', 'clientId', 'certificateId', 'privateKey']) {
       expect(getSubBlock(field).required, field).toBe(true)
@@ -221,6 +260,27 @@ describe('Oracle NetSuite block', () => {
     ]
     expect(Object.keys(NetSuiteBlock.inputs)).toEqual(expectedInputs)
     expect(Object.keys(NetSuiteBlock.outputs)).toEqual(['status', 'data', 'location', 'jobId'])
+    expect(NetSuiteBlock.outputs.location.condition).toEqual({
+      field: 'operation',
+      value: [
+        'netsuite_create_record',
+        'netsuite_batch_get_records',
+        'netsuite_batch_create_records',
+        'netsuite_batch_update_records',
+        'netsuite_batch_upsert_records',
+        'netsuite_batch_delete_records',
+      ],
+    })
+    expect(NetSuiteBlock.outputs.jobId.condition).toEqual({
+      field: 'operation',
+      value: [
+        'netsuite_batch_get_records',
+        'netsuite_batch_create_records',
+        'netsuite_batch_update_records',
+        'netsuite_batch_upsert_records',
+        'netsuite_batch_delete_records',
+      ],
+    })
     for (const input of expectedInputs) {
       if (input !== 'operation' && input !== 'taskId')
         expect(getSubBlock(input), input).toBeDefined()

apps/sim/blocks/blocks/netsuite.test.ts

@@ -111,6 +111,8 @@ const BATCH_OPERATIONS = [
   'netsuite_batch_delete_records',
 ]
 
+const LOCATION_OPERATIONS = ['netsuite_create_record', ...BATCH_OPERATIONS]
+
 const BATCH_WRITE_OPERATIONS = [
   'netsuite_batch_create_records',
   'netsuite_batch_update_records',
@@ -193,8 +195,8 @@ export const NetSuiteBlock: BlockConfig<NetSuiteResponse> = {
         ],
         netsuite_get_subresource: [
           { text: 'Read subresource', field: 'subresourcePath', core: true },
-          { text: 'from', field: 'recordType' },
-          { text: 'record', field: 'recordId' },
+          { text: 'from', field: 'recordType', core: true },
+          { text: 'record', field: 'recordId', core: true },
         ],
         netsuite_get_record_form: [
           { text: 'Get the form for', field: 'recordType', core: true },
@@ -206,7 +208,7 @@ export const NetSuiteBlock: BlockConfig<NetSuiteResponse> = {
         ],
         netsuite_get_select_options: [
           { text: 'Get select options for', field: 'fields', core: true },
-          { text: 'on', field: 'recordType' },
+          { text: 'on', field: 'recordType', core: true },
           { text: 'record', field: 'recordId' },
           { text: ', matching', field: 'q' },
           { text: ', using', field: 'body' },
@@ -216,27 +218,27 @@ export const NetSuiteBlock: BlockConfig<NetSuiteResponse> = {
         netsuite_attach_record: [
           { text: 'Attach', field: 'relatedType', core: true },
           { text: 'ID', field: 'relatedId', core: true },
-          { text: 'to', field: 'recordType' },
-          { text: 'record', field: 'recordId' },
+          { text: 'to', field: 'recordType', core: true },
+          { text: 'record', field: 'recordId', core: true },
           { text: ', with role ID', field: 'roleId' },
           { text: ', or role external ID', field: 'roleExternalId' },
         ],
         netsuite_detach_record: [
           { text: 'Detach', field: 'relatedType', core: true },
           { text: 'ID', field: 'relatedId', core: true },
-          { text: 'from', field: 'recordType' },
-          { text: 'record', field: 'recordId' },
+          { text: 'from', field: 'recordType', core: true },
+          { text: 'record', field: 'recordId', core: true },
         ],
         netsuite_execute_action: [
           { text: 'Run action', field: 'action', core: true },
-          { text: 'on', field: 'recordType' },
-          { text: 'record', field: 'recordId' },
+          { text: 'on', field: 'recordType', core: true },
+          { text: 'record', field: 'recordId', core: true },
           { text: ', with', field: 'body' },
         ],
         netsuite_transform_record: [
           { text: 'Transform', field: 'recordType', core: true },
           { text: 'record', field: 'recordId', core: true },
-          { text: 'into', field: 'targetRecordType' },
+          { text: 'into', field: 'targetRecordType', core: true },
           { text: ', with', field: 'body' },
         ],
         netsuite_batch_get_records: [
@@ -296,8 +298,8 @@ export const NetSuiteBlock: BlockConfig<NetSuiteResponse> = {
           { text: 'Get result from async job', field: 'jobId', core: true },
           { text: 'for task', field: 'resultTaskId', core: true },
         ],
-        netsuite_get_server_time: ['Get NetSuite server time'],
-        netsuite_get_governance_limits: ['Get NetSuite governance limits'],
+        netsuite_get_server_time: ['Get server time'],
+        netsuite_get_governance_limits: ['Get governance limits'],
       },
     },
   },
@@ -828,8 +830,16 @@ Return ONLY the comma-separated sublist IDs - no explanations, no extra text.`,
       description:
         'NetSuite payload: account-specific record fields, collection items and paging fields, metadata, or async task data',
     },
-    location: { type: 'string', description: 'Created resource or async job location' },
-    jobId: { type: 'string', description: 'Async job ID parsed from the Location header' },
+    location: {
+      type: 'string',
+      description: 'Created resource or async job location',
+      condition: { field: 'operation', value: LOCATION_OPERATIONS },
+    },
+    jobId: {
+      type: 'string',
+      description: 'Async job ID parsed from the Location header',
+      condition: { field: 'operation', value: BATCH_OPERATIONS },
+    },
   },
 }
 

apps/sim/blocks/blocks/netsuite.ts

@@ -114,15 +114,5 @@ export const netsuiteAttachRecordTool: ToolConfig<NetSuiteAttachParams, NetSuite
       description: 'NetSuite response body; record fields are account-specific and dynamic',
       nullable: true,
     },
-    location: {
-      type: 'string',
-      description: 'Created resource or asynchronous job location returned by NetSuite',
-      optional: true,
-    },
-    jobId: {
-      type: 'string',
-      description: 'Asynchronous job ID parsed from the Location header',
-      optional: true,
-    },
   },
 }