fix(hex,stripe): validate Hex and Stripe against their API docs (#10005)

* fix(hex): keep stale list filters out of other operations, add documented run trigger and pagination fields

- get_project_runs no longer receives the List Projects status filter, and list
  users/groups/collections/data connections drop a stored List Projects sort
  field they reject (valid ones still pass)
- get_queried_tables gains after/before cursors via dedicated subBlocks, plus
  after/before outputs
- list_groups gains the documented userId filter via a dedicated subBlock
- run status and project runs expose runTrigger; elapsedTime is milliseconds
- path ids go through safeUrlPathSegment
- correct documented limit ranges and the create_group createdAt output

* fix(stripe): stop unset Yes/No fields from changing Stripe objects, honor subscription item ids, guard path ids, add pagination

- Yes/No dropdowns (cancel_at_period_end, auto_advance, capture, active, prorate,
  invoice_now, paid_out_of_band) gain a leading Default option that is never sent.
  The UI seeded the first option ("Yes") as soon as advanced options were shown, so
  merely opening them on Update Subscription scheduled a cancellation and on Pay
  Invoice marked the invoice paid out of band. Stored 'true'/'false'/null map exactly
  as before, and every key is now assigned so a raw '' cannot leak past the mapper.
- update_subscription sends items[i][id] (and deleted when true): Stripe adds a new
  item when id is omitted, so changing a price created a duplicate billed item.
- All path ids go through safeUrlPathSegment, so an id cannot traverse to another
  Stripe endpoint with the caller's key.
- create_price no longer sends unit_amount=0 for an empty field; create_subscription
  no longer sends trial_period_days=0 for an empty field.
- starting_after/ending_before on every list tool and page/next_page on every search
  tool, wired through new list_starting_after/list_ending_before/search_page subBlocks.
- Stripe trigger declares the documented account and context event fields.

* chore(docs): regenerate Hex and Stripe tool metadata and docs

* fix(hex,stripe): keep agent-supplied cursors and filters when the block maps dedicated fields

* fix(hex,stripe): type run projectVersion as a string, send zero item quantities, mark nullable event fields

* fix(hex): only fall back to raw run status and user id on agent calls

Author: waleedlatif1

apps/docs/content/docs/integrations/hex.mdx

@@ -87,7 +87,7 @@ Create a new group in the Hex workspace, optionally with initial members.
 | --------- | ---- | ----------- |
 | `id` | string | Newly created group UUID |
 | `name` | string | Group name |
-| `createdAt` | string | Creation timestamp |
+| `createdAt` | string | Creation timestamp \(not returned by the create endpoint, so usually null\) |
 
 </ReferenceDetails>
 
@@ -245,7 +245,7 @@ Get metadata and details for a specific Hex project by its ID.
 
 ### Hex Get Project Runs
 
-Retrieve API-triggered runs for a Hex project with optional filtering by status and pagination.
+Retrieve runs for a Hex project (API-triggered, scheduled, and app refresh runs) with optional filtering by status and trigger, and offset pagination.
 
 <ReferenceDetails>
 
@@ -268,11 +268,12 @@ Retrieve API-triggered runs for a Hex project with optional filtering by status
 |   ↳ `runId` | string | Run UUID |
 |   ↳ `runUrl` | string | URL to view the run |
 |   ↳ `status` | string | Run status \(PENDING, RUNNING, COMPLETED, ERRORED, KILLED, UNABLE_TO_ALLOCATE_KERNEL\) |
+|   ↳ `runTrigger` | string | How the run was triggered \(API, SCHEDULED, APP_REFRESH\) |
 |   ↳ `startTime` | string | Run start time |
 |   ↳ `endTime` | string | Run end time |
-|   ↳ `elapsedTime` | number | Elapsed time in seconds |
+|   ↳ `elapsedTime` | number | Elapsed run time in milliseconds |
 |   ↳ `traceId` | string | Trace ID |
-|   ↳ `projectVersion` | number | Project version number |
+|   ↳ `projectVersion` | string | Project version that was run \("1", "2", ...; "draft" for notebook runs\) |
 | `total` | number | Total number of runs returned |
 | `traceId` | string | Top-level trace ID |
 | `nextPage` | string | Cursor for the next page of runs |
@@ -291,7 +292,9 @@ Return the warehouse tables queried by a Hex project, including data connection
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
 | `projectId` | string | Yes | The UUID of the Hex project |
-| `limit` | number | No | Maximum number of tables to return \(1-100\) |
+| `limit` | number | No | Maximum number of tables to return \(1-100, default: 25\) |
+| `after` | string | No | Cursor to fetch the page of results after this value |
+| `before` | string | No | Cursor to fetch the page of results before this value |
 
 #### Output
 
@@ -302,6 +305,8 @@ Return the warehouse tables queried by a Hex project, including data connection
 |   ↳ `dataConnectionName` | string | Data connection name |
 |   ↳ `tableName` | string | Table name |
 | `total` | number | Total number of tables returned |
+| `after` | string | Cursor for the next page of results |
+| `before` | string | Cursor for the previous page of results |
 
 </ReferenceDetails>
 
@@ -326,11 +331,12 @@ Check the status of a Hex project run by its run ID.
 | `runId` | string | Run UUID |
 | `runUrl` | string | URL to view the run |
 | `status` | string | Run status \(PENDING, RUNNING, COMPLETED, ERRORED, KILLED, UNABLE_TO_ALLOCATE_KERNEL\) |
+| `runTrigger` | string | How the run was triggered \(API, SCHEDULED, APP_REFRESH\) |
 | `startTime` | string | ISO 8601 run start time |
 | `endTime` | string | ISO 8601 run end time |
-| `elapsedTime` | number | Elapsed time in seconds |
+| `elapsedTime` | number | Elapsed run time in milliseconds |
 | `traceId` | string | Trace ID for debugging |
-| `projectVersion` | number | Project version number |
+| `projectVersion` | string | Project version that was run \("1", "2", ...; "draft" for notebook runs\) |
 
 </ReferenceDetails>
 
@@ -344,7 +350,7 @@ List all collections in the Hex workspace.
 
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
-| `limit` | number | No | Maximum number of collections to return \(1-500, default: 25\) |
+| `limit` | number | No | Maximum number of collections to return \(1-100, default: 25\) |
 | `sortBy` | string | No | Sort by field: NAME |
 | `after` | string | No | Cursor to fetch the page of results after this value |
 | `before` | string | No | Cursor to fetch the page of results before this value |
@@ -376,7 +382,7 @@ List all data connections in the Hex workspace (e.g., Snowflake, PostgreSQL, Big
 
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
-| `limit` | number | No | Maximum number of connections to return \(1-500, default: 25\) |
+| `limit` | number | No | Maximum number of connections to return \(1-100, default: 25\) |
 | `sortBy` | string | No | Sort by field: CREATED_AT or NAME |
 | `sortDirection` | string | No | Sort direction: ASC or DESC |
 | `after` | string | No | Cursor to fetch the page of results after this value |
@@ -402,7 +408,7 @@ List all data connections in the Hex workspace (e.g., Snowflake, PostgreSQL, Big
 
 ### Hex List Groups
 
-List all groups in the Hex workspace with optional sorting.
+List all groups in the Hex workspace with optional sorting, or only the groups a user belongs to.
 
 <ReferenceDetails>
 
@@ -413,6 +419,7 @@ List all groups in the Hex workspace with optional sorting.
 | `limit` | number | No | Maximum number of groups to return \(1-500, default: 25\) |
 | `sortBy` | string | No | Sort by field: CREATED_AT or NAME |
 | `sortDirection` | string | No | Sort direction: ASC or DESC |
+| `userId` | string | No | Return only groups this user UUID belongs to |
 | `after` | string | No | Cursor to fetch the page of results after this value |
 | `before` | string | No | Cursor to fetch the page of results before this value |
 
@@ -440,7 +447,7 @@ List all projects in your Hex workspace with optional filtering by status.
 
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
-| `limit` | number | No | Maximum number of projects to return \(1-100\) |
+| `limit` | number | No | Maximum number of projects to return \(1-100, default: 25\) |
 | `includeArchived` | boolean | No | Include archived projects in results |
 | `statusFilter` | string | No | Filter by status: PUBLISHED, DRAFT, or ALL |
 | `includeComponents` | boolean | No | Include components in results |
@@ -473,6 +480,10 @@ List all projects in your Hex workspace with optional filtering by status.
 |   ↳ `lastPublishedAt` | string | Last published timestamp |
 |   ↳ `createdAt` | string | Creation timestamp |
 |   ↳ `archivedAt` | string | Archived timestamp |
+|   ↳ `trashedAt` | string | Trashed timestamp |
+|   ↳ `categories` | array | Project categories |
+|     ↳ `name` | string | Category name |
+|     ↳ `description` | string | Category description |
 | `total` | number | Total number of projects returned |
 | `after` | string | Cursor for the next page of results |
 | `before` | string | Cursor for the previous page of results |
@@ -489,7 +500,7 @@ List all users in the Hex workspace with optional filtering and sorting.
 
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
-| `limit` | number | No | Maximum number of users to return \(1-100, default: 25\) |
+| `limit` | number | No | Maximum number of users to return \(1-500, default: 25\) |
 | `sortBy` | string | No | Sort by field: NAME or EMAIL |
 | `sortDirection` | string | No | Sort direction: ASC or DESC |
 | `groupId` | string | No | Filter users by group UUID |

apps/docs/content/docs/integrations/stripe.mdx

@@ -473,6 +473,8 @@ List all Payment Intents
 | `limit` | number | No | Number of results to return \(default 10, max 100\) |
 | `customer` | string | No | Filter by customer ID |
 | `created` | json | No | Filter by creation date \(e.g., \{"gt": 1633024800\}\) |
+| `starting_after` | string | No | Next-page cursor: last Payment Intent ID from the previous page. Do not combine with ending_before. |
+| `ending_before` | string | No | Previous-page cursor: first Payment Intent ID from the current page. Do not combine with starting_after. |
 
 #### Output
 
@@ -543,6 +545,7 @@ Search for Payment Intents using query syntax
 | --------- | ---- | -------- | ----------- |
 | `query` | string | Yes | Search query \(e.g., "status:'succeeded' AND currency:'usd'"\) |
 | `limit` | number | No | Number of results to return \(default 10, max 100\) |
+| `page` | string | No | Pagination token from metadata.next_page of the previous search; omit for the first page |
 
 #### Output
 
@@ -598,6 +601,7 @@ Search for Payment Intents using query syntax
 | `metadata` | json | Search metadata including count and has_more |
 |   ↳ `count` | number | Number of items returned |
 |   ↳ `has_more` | boolean | Whether more items exist beyond this page |
+|   ↳ `next_page` | string | Token for the next page of search results, or null when there are no more results |
 
 </ReferenceDetails>
 
@@ -830,6 +834,8 @@ List all customers
 | `limit` | number | No | Number of results to return \(default 10, max 100\) |
 | `email` | string | No | Filter by email address |
 | `created` | json | No | Filter by creation date |
+| `starting_after` | string | No | Next-page cursor: last customer ID from the previous page. Do not combine with ending_before. |
+| `ending_before` | string | No | Previous-page cursor: first customer ID from the current page. Do not combine with starting_after. |
 
 #### Output
 
@@ -891,6 +897,7 @@ Search for customers using query syntax
 | --------- | ---- | -------- | ----------- |
 | `query` | string | Yes | Search query \(e.g., "email:'customer@example.com'"\) |
 | `limit` | number | No | Number of results to return \(default 10, max 100\) |
+| `page` | string | No | Pagination token from metadata.next_page of the previous search; omit for the first page |
 
 #### Output
 
@@ -937,6 +944,7 @@ Search for customers using query syntax
 | `metadata` | json | Search metadata |
 |   ↳ `count` | number | Number of items returned |
 |   ↳ `has_more` | boolean | Whether more items exist beyond this page |
+|   ↳ `next_page` | string | Token for the next page of search results, or null when there are no more results |
 
 </ReferenceDetails>
 
@@ -1116,7 +1124,7 @@ Update an existing subscription
 | Parameter | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
 | `id` | string | Yes | Subscription ID \(e.g., sub_1234567890\) |
-| `items` | json | No | Updated array of items with price IDs |
+| `items` | json | No | Subscription items to change, e.g. \[\{"id": "si_123", "price": "price_456"\}\]. Include the existing item "id" to update or delete \(with "deleted": true\) that item; an entry without "id" adds a new item alongside the current ones. |
 | `cancel_at_period_end` | boolean | No | Cancel subscription at period end |
 | `metadata` | json | No | Updated metadata |
 
@@ -2538,6 +2546,8 @@ List all invoices
 | `limit` | number | No | Number of results to return \(default 10, max 100\) |
 | `customer` | string | No | Filter by customer ID |
 | `status` | string | No | Filter by invoice status |
+| `starting_after` | string | No | Next-page cursor: last invoice ID from the previous page. Do not combine with ending_before. |
+| `ending_before` | string | No | Previous-page cursor: first invoice ID from the current page. Do not combine with starting_after. |
 
 #### Output
 
@@ -2562,6 +2572,7 @@ Search for invoices using query syntax
 | --------- | ---- | -------- | ----------- |
 | `query` | string | Yes | Search query \(e.g., "customer:'cus_1234567890'"\) |
 | `limit` | number | No | Number of results to return \(default 10, max 100\) |
+| `page` | string | No | Pagination token from metadata.next_page of the previous search; omit for the first page |
 
 #### Output
 
@@ -2571,6 +2582,7 @@ Search for invoices using query syntax
 | `metadata` | json | Search metadata |
 |   ↳ `count` | number | Number of items returned |
 |   ↳ `has_more` | boolean | Whether more items exist beyond this page |
+|   ↳ `next_page` | string | Token for the next page of search results, or null when there are no more results |
 
 </ReferenceDetails>
 
@@ -2700,6 +2712,8 @@ List all charges
 | `limit` | number | No | Number of results to return \(default 10, max 100\) |
 | `customer` | string | No | Filter by customer ID |
 | `created` | json | No | Filter by creation date \(e.g., \{"gt": 1633024800\}\) |
+| `starting_after` | string | No | Next-page cursor: last charge ID from the previous page. Do not combine with ending_before. |
+| `ending_before` | string | No | Previous-page cursor: first charge ID from the current page. Do not combine with starting_after. |
 
 #### Output
 
@@ -2724,6 +2738,7 @@ Search for charges using query syntax
 | --------- | ---- | -------- | ----------- |
 | `query` | string | Yes | Search query \(e.g., "status:'succeeded' AND currency:'usd'"\) |
 | `limit` | number | No | Number of results to return \(default 10, max 100\) |
+| `page` | string | No | Pagination token from metadata.next_page of the previous search; omit for the first page |
 
 #### Output
 
@@ -2733,6 +2748,7 @@ Search for charges using query syntax
 | `metadata` | json | Search metadata including count and has_more |
 |   ↳ `count` | number | Number of items returned |
 |   ↳ `has_more` | boolean | Whether more items exist beyond this page |
+|   ↳ `next_page` | string | Token for the next page of search results, or null when there are no more results |
 
 </ReferenceDetails>
 
@@ -2850,6 +2866,8 @@ List all products
 | --------- | ---- | -------- | ----------- |
 | `limit` | number | No | Number of results to return \(default 10, max 100\) |
 | `active` | boolean | No | Filter by active status |
+| `starting_after` | string | No | Next-page cursor: last product ID from the previous page. Do not combine with ending_before. |
+| `ending_before` | string | No | Previous-page cursor: first product ID from the current page. Do not combine with starting_after. |
 
 #### Output
 
@@ -2874,6 +2892,7 @@ Search for products using query syntax
 | --------- | ---- | -------- | ----------- |
 | `query` | string | Yes | Search query \(e.g., "name:'shirt'"\) |
 | `limit` | number | No | Number of results to return \(default 10, max 100\) |
+| `page` | string | No | Pagination token from metadata.next_page of the previous search; omit for the first page |
 
 #### Output
 
@@ -2883,6 +2902,7 @@ Search for products using query syntax
 | `metadata` | json | Search metadata |
 |   ↳ `count` | number | Number of items returned |
 |   ↳ `has_more` | boolean | Whether more items exist beyond this page |
+|   ↳ `next_page` | string | Token for the next page of search results, or null when there are no more results |
 
 </ReferenceDetails>
 
@@ -2981,6 +3001,8 @@ List all prices
 | `limit` | number | No | Number of results to return \(default 10, max 100\) |
 | `product` | string | No | Filter by product ID |
 | `active` | boolean | No | Filter by active status |
+| `starting_after` | string | No | Next-page cursor: last price ID from the previous page. Do not combine with ending_before. |
+| `ending_before` | string | No | Previous-page cursor: first price ID from the current page. Do not combine with starting_after. |
 
 #### Output
 
@@ -3005,6 +3027,7 @@ Search for prices using query syntax
 | --------- | ---- | -------- | ----------- |
 | `query` | string | Yes | Search query \(e.g., "active:'true' AND currency:'usd'"\) |
 | `limit` | number | No | Number of results to return \(default 10, max 100\) |
+| `page` | string | No | Pagination token from metadata.next_page of the previous search; omit for the first page |
 
 #### Output
 
@@ -3014,6 +3037,7 @@ Search for prices using query syntax
 | `metadata` | json | Search metadata |
 |   ↳ `count` | number | Number of items returned |
 |   ↳ `has_more` | boolean | Whether more items exist beyond this page |
+|   ↳ `next_page` | string | Token for the next page of search results, or null when there are no more results |
 
 </ReferenceDetails>
 
@@ -3054,6 +3078,8 @@ List all Events
 | `limit` | number | No | Number of results to return \(default 10, max 100\) |
 | `type` | string | No | Filter by event type \(e.g., payment_intent.created\) |
 | `created` | json | No | Filter by creation date \(e.g., \{"gt": 1633024800\}\) |
+| `starting_after` | string | No | Next-page cursor: last event ID from the previous page. Do not combine with ending_before. |
+| `ending_before` | string | No | Previous-page cursor: first event ID from the current page. Do not combine with starting_after. |
 
 #### Output
 
@@ -3092,7 +3118,9 @@ Triggers when Stripe events occur (payments, subscriptions, invoices, etc.)
 | `id` | string | Unique identifier for the event |
 | `type` | string | Event type \(e.g., payment_intent.succeeded, customer.created, invoice.paid\) |
 | `object` | string | Always "event" |
+| `account` | string | Connected account that originated the event \(Connect events only; absent or null otherwise\) |
 | `api_version` | string | Stripe API version used to render the event |
+| `context` | string | Authentication context needed to fetch the event or related object \(null when not applicable\) |
 | `created` | number | Unix timestamp when the event was created |
 | `data` | json | Event data containing the affected Stripe object. Structure varies by event type - access via data.object for the resource \(PaymentIntent, Customer, Invoice, etc.\) |
 | `livemode` | boolean | Whether this event occurred in live mode \(true\) or test mode \(false\) |