@lessly/sdk-app 96.0.0 → 96.0.1

package/src/gen/organization/queryOptions.gen.ts

@@ -3,11 +3,10 @@ import type { GeneratedClient } from '../client.gen';
 import type {
   OrganizationAuthMeInput,
   OrganizationAuthMeOutput,
-  OrganizationBillingBudgetClearInput,
-  OrganizationBillingBudgetResumeInput,
-  OrganizationBillingBudgetSetInput,
   OrganizationBillingBudgetsGetInput,
   OrganizationBillingBudgetsGetOutput,
+  OrganizationBillingCapsClearInput,
+  OrganizationBillingCapsSetInput,
   OrganizationBindingsListInput,
   OrganizationBindingsListOutput,
   OrganizationClickupInstallInput,
@@ -133,24 +132,19 @@ export const organizationAuthMeQueryOptions = (sdk: GeneratedClient, input: Orga
   queryFn: () => sdk['organization']['auth']['me'](input),
 });
 
-export const organizationBillingBudgetClearMutationOptions = (sdk: GeneratedClient) => ({
-  mutationKey: ['organization', 'billing-budget', 'clear'],
-  mutationFn: (input: OrganizationBillingBudgetClearInput) => sdk['organization']['billing-budget']['clear'](input),
-});
-
-export const organizationBillingBudgetResumeMutationOptions = (sdk: GeneratedClient) => ({
-  mutationKey: ['organization', 'billing-budget', 'resume'],
-  mutationFn: (input: OrganizationBillingBudgetResumeInput) => sdk['organization']['billing-budget']['resume'](input),
+export const organizationBillingBudgetsGetQueryOptions = (sdk: GeneratedClient, input: OrganizationBillingBudgetsGetInput) => ({
+  queryKey: ['organization', 'billing-budgets', 'get', input] as const,
+  queryFn: () => sdk['organization']['billing-budgets']['get'](input),
 });
 
-export const organizationBillingBudgetSetMutationOptions = (sdk: GeneratedClient) => ({
-  mutationKey: ['organization', 'billing-budget', 'set'],
-  mutationFn: (input: OrganizationBillingBudgetSetInput) => sdk['organization']['billing-budget']['set'](input),
+export const organizationBillingCapsClearMutationOptions = (sdk: GeneratedClient) => ({
+  mutationKey: ['organization', 'billing-caps', 'clear'],
+  mutationFn: (input: OrganizationBillingCapsClearInput) => sdk['organization']['billing-caps']['clear'](input),
 });
 
-export const organizationBillingBudgetsGetQueryOptions = (sdk: GeneratedClient, input: OrganizationBillingBudgetsGetInput) => ({
-  queryKey: ['organization', 'billing-budgets', 'get', input] as const,
-  queryFn: () => sdk['organization']['billing-budgets']['get'](input),
+export const organizationBillingCapsSetMutationOptions = (sdk: GeneratedClient) => ({
+  mutationKey: ['organization', 'billing-caps', 'set'],
+  mutationFn: (input: OrganizationBillingCapsSetInput) => sdk['organization']['billing-caps']['set'](input),
 });
 
 export const organizationBindingsListQueryOptions = (sdk: GeneratedClient, input: OrganizationBindingsListInput) => ({

package/src/gen/playground/connect.gen.ts

@@ -0,0 +1,9 @@
+// AUTOGENERATED by scripts/generate.ts — do not edit.
+import { wsBindings } from '../bindings.gen';
+import type { LesslyStream, LesslyStreamOpener } from '../../runtime/types';
+import type {
+  PlaygroundWsEchoInput,
+} from '../types.gen';
+
+export const playgroundWsEchoConnect = (sdk: LesslyStreamOpener, input: PlaygroundWsEchoInput): LesslyStream =>
+  sdk.openStream(wsBindings['playground']!['ws']!['echo']!, input as Record<string, unknown>);

package/src/gen/playground/index.ts

@@ -0,0 +1,4 @@
+// AUTOGENERATED by scripts/generate.ts — do not edit.
+export * from './queryOptions.gen';
+export * from './connect.gen';
+export type { PlaygroundAnalyticsOverviewInput, PlaygroundAnalyticsOverviewOutput, PlaygroundBillingEntitlementsInput, PlaygroundBillingEntitlementsOutput, PlaygroundBillingRecordUsageInput, PlaygroundBillingRecordUsageOutput, PlaygroundClickupCreateTaskInput, PlaygroundClickupCreateTaskOutput, PlaygroundClickupGetLastWebhookInput, PlaygroundClickupGetLastWebhookOutput, PlaygroundClickupGetOverviewInput, PlaygroundClickupGetOverviewOutput, PlaygroundEchoPingInput, PlaygroundEchoPingOutput, PlaygroundGdriveGetLastChangeInput, PlaygroundGdriveGetLastChangeOutput, PlaygroundGdriveReadFileInput, PlaygroundGdriveReadFileOutput, PlaygroundGoogleadsReadCustomerInput, PlaygroundGoogleadsReadCustomerOutput, PlaygroundLifecycleGetStateInput, PlaygroundLifecycleGetStateOutput, PlaygroundLifecycleListEventsInput, PlaygroundLifecycleListEventsOutput, PlaygroundWebhookGetLastInput, PlaygroundWebhookGetLastOutput, PlaygroundWorkflowEchoInput, PlaygroundWorkflowEchoListInput, PlaygroundWorkflowEchoListOutput, PlaygroundWorkflowEchoOutput, PlaygroundWorkflowPingInput, PlaygroundWorkflowPingOutput, PlaygroundWorkflowSubjectsListInput, PlaygroundWorkflowSubjectsListOutput, PlaygroundWsEchoInput } from '../types.gen';

package/src/gen/playground/queryOptions.gen.ts

@@ -0,0 +1,119 @@
+// AUTOGENERATED by scripts/generate.ts — do not edit.
+import type { GeneratedClient } from '../client.gen';
+import type {
+  PlaygroundAnalyticsOverviewInput,
+  PlaygroundAnalyticsOverviewOutput,
+  PlaygroundBillingEntitlementsInput,
+  PlaygroundBillingEntitlementsOutput,
+  PlaygroundBillingRecordUsageInput,
+  PlaygroundClickupCreateTaskInput,
+  PlaygroundClickupGetLastWebhookInput,
+  PlaygroundClickupGetLastWebhookOutput,
+  PlaygroundClickupGetOverviewInput,
+  PlaygroundClickupGetOverviewOutput,
+  PlaygroundEchoPingInput,
+  PlaygroundEchoPingOutput,
+  PlaygroundGdriveGetLastChangeInput,
+  PlaygroundGdriveGetLastChangeOutput,
+  PlaygroundGdriveReadFileInput,
+  PlaygroundGdriveReadFileOutput,
+  PlaygroundGoogleadsReadCustomerInput,
+  PlaygroundGoogleadsReadCustomerOutput,
+  PlaygroundLifecycleGetStateInput,
+  PlaygroundLifecycleGetStateOutput,
+  PlaygroundLifecycleListEventsInput,
+  PlaygroundLifecycleListEventsOutput,
+  PlaygroundWebhookGetLastInput,
+  PlaygroundWebhookGetLastOutput,
+  PlaygroundWorkflowEchoInput,
+  PlaygroundWorkflowEchoListInput,
+  PlaygroundWorkflowEchoListOutput,
+  PlaygroundWorkflowPingInput,
+  PlaygroundWorkflowSubjectsListInput,
+  PlaygroundWorkflowSubjectsListOutput,
+} from '../types.gen';
+
+export const playgroundAnalyticsOverviewQueryOptions = (sdk: GeneratedClient, input: PlaygroundAnalyticsOverviewInput) => ({
+  queryKey: ['playground', 'analytics', 'overview', input] as const,
+  queryFn: () => sdk['playground']['analytics']['overview'](input),
+});
+
+export const playgroundBillingEntitlementsQueryOptions = (sdk: GeneratedClient, input: PlaygroundBillingEntitlementsInput) => ({
+  queryKey: ['playground', 'billing', 'entitlements', input] as const,
+  queryFn: () => sdk['playground']['billing']['entitlements'](input),
+});
+
+export const playgroundBillingRecordUsageMutationOptions = (sdk: GeneratedClient) => ({
+  mutationKey: ['playground', 'billing', 'record-usage'],
+  mutationFn: (input: PlaygroundBillingRecordUsageInput) => sdk['playground']['billing']['record-usage'](input),
+});
+
+export const playgroundClickupCreateTaskMutationOptions = (sdk: GeneratedClient) => ({
+  mutationKey: ['playground', 'clickup', 'create-task'],
+  mutationFn: (input: PlaygroundClickupCreateTaskInput) => sdk['playground']['clickup']['create-task'](input),
+});
+
+export const playgroundClickupGetLastWebhookQueryOptions = (sdk: GeneratedClient, input: PlaygroundClickupGetLastWebhookInput) => ({
+  queryKey: ['playground', 'clickup', 'get-last-webhook', input] as const,
+  queryFn: () => sdk['playground']['clickup']['get-last-webhook'](input),
+});
+
+export const playgroundClickupGetOverviewQueryOptions = (sdk: GeneratedClient, input: PlaygroundClickupGetOverviewInput) => ({
+  queryKey: ['playground', 'clickup', 'get-overview', input] as const,
+  queryFn: () => sdk['playground']['clickup']['get-overview'](input),
+});
+
+export const playgroundEchoPingQueryOptions = (sdk: GeneratedClient, input: PlaygroundEchoPingInput) => ({
+  queryKey: ['playground', 'echo', 'ping', input] as const,
+  queryFn: () => sdk['playground']['echo']['ping'](input),
+});
+
+export const playgroundGdriveGetLastChangeQueryOptions = (sdk: GeneratedClient, input: PlaygroundGdriveGetLastChangeInput) => ({
+  queryKey: ['playground', 'gdrive', 'get-last-change', input] as const,
+  queryFn: () => sdk['playground']['gdrive']['get-last-change'](input),
+});
+
+export const playgroundGdriveReadFileQueryOptions = (sdk: GeneratedClient, input: PlaygroundGdriveReadFileInput) => ({
+  queryKey: ['playground', 'gdrive', 'read-file', input] as const,
+  queryFn: () => sdk['playground']['gdrive']['read-file'](input),
+});
+
+export const playgroundGoogleadsReadCustomerQueryOptions = (sdk: GeneratedClient, input: PlaygroundGoogleadsReadCustomerInput) => ({
+  queryKey: ['playground', 'googleads', 'read-customer', input] as const,
+  queryFn: () => sdk['playground']['googleads']['read-customer'](input),
+});
+
+export const playgroundLifecycleGetStateQueryOptions = (sdk: GeneratedClient, input: PlaygroundLifecycleGetStateInput) => ({
+  queryKey: ['playground', 'lifecycle', 'get-state', input] as const,
+  queryFn: () => sdk['playground']['lifecycle']['get-state'](input),
+});
+
+export const playgroundLifecycleListEventsQueryOptions = (sdk: GeneratedClient, input: PlaygroundLifecycleListEventsInput) => ({
+  queryKey: ['playground', 'lifecycle', 'list-events', input] as const,
+  queryFn: () => sdk['playground']['lifecycle']['list-events'](input),
+});
+
+export const playgroundWebhookGetLastQueryOptions = (sdk: GeneratedClient, input: PlaygroundWebhookGetLastInput) => ({
+  queryKey: ['playground', 'webhook', 'get-last', input] as const,
+  queryFn: () => sdk['playground']['webhook']['get-last'](input),
+});
+
+export const playgroundWorkflowEchoMutationOptions = (sdk: GeneratedClient) => ({
+  mutationKey: ['playground', 'workflow', 'echo'],
+  mutationFn: (input: PlaygroundWorkflowEchoInput) => sdk['playground']['workflow']['echo'](input),
+});
+
+export const playgroundWorkflowEchoListQueryOptions = (sdk: GeneratedClient, input: PlaygroundWorkflowEchoListInput) => ({
+  queryKey: ['playground', 'workflow', 'echo-list', input] as const,
+  queryFn: () => sdk['playground']['workflow']['echo-list'](input),
+});
+
+export const playgroundWorkflowPingMutationOptions = (sdk: GeneratedClient) => ({
+  mutationKey: ['playground', 'workflow', 'ping'],
+  mutationFn: (input: PlaygroundWorkflowPingInput) => sdk['playground']['workflow']['ping'](input),
+});
+
+export const playgroundWorkflowSubjectsListQueryOptions = (sdk: GeneratedClient, input: PlaygroundWorkflowSubjectsListInput) => ({
+  queryKey: ['playground', 'workflow', 'subjects-list', input] as const,
+  queryFn: () => sdk['playground']['workflow']['subjects-list'](input),
+});

package/src/gen/types.gen.ts

@@ -95554,42 +95554,28 @@ displayName: string
 identityType: string
 }
 
-export interface OrganizationBillingBudgetClearInput {
-
-}
-
-export interface OrganizationBillingBudgetClearOutput {
-[k: string]: unknown
-}
-
-export interface OrganizationBillingBudgetResumeInput {
+export interface OrganizationBillingBudgetsGetInput {
 
 }
 
-export interface OrganizationBillingBudgetResumeOutput {
+export interface OrganizationBillingBudgetsGetOutput {
 [k: string]: unknown
 }
 
-export interface OrganizationBillingBudgetSetInput {
-/**
- * At 100%: "pause" stops chargeable compute and blocks new chargeable work until Resume; "alerts_only" only notifies. Default: "pause".
- */
-action?: ("pause" | "alerts_only")
-/**
- * Monthly limit for extra charges, in integer minor units of the organization currency. Example: 50000 = EUR 500.00.
- */
-amount_minor: number
+export interface OrganizationBillingCapsClearInput {
+productId: string
 }
 
-export interface OrganizationBillingBudgetSetOutput {
+export interface OrganizationBillingCapsClearOutput {
 [k: string]: unknown
 }
 
-export interface OrganizationBillingBudgetsGetInput {
-
+export interface OrganizationBillingCapsSetInput {
+cap_minor: number
+productId: string
 }
 
-export interface OrganizationBillingBudgetsGetOutput {
+export interface OrganizationBillingCapsSetOutput {
 [k: string]: unknown
 }
 
@@ -98827,6 +98813,378 @@ export interface OrganizationYoutubeInstallOutput {
 url: string
 }
 
+export interface PlaygroundAnalyticsOverviewInput {
+/**
+ * Max records per entity in recent[]; omit for the endpoint default
+ */
+limit?: number
+}
+
+export interface PlaygroundAnalyticsOverviewOutput {
+ok: boolean
+minted: boolean
+overview?: unknown
+http_status: number
+}
+
+export interface PlaygroundBillingEntitlementsInput {
+
+}
+
+export interface PlaygroundBillingEntitlementsOutput {
+ok: boolean
+minted: boolean
+http_status: number
+entitlements?: unknown
+}
+
+export interface PlaygroundBillingRecordUsageInput {
+/**
+ * Quantity of events to record against playground-events (SUM); defaults to 1
+ */
+value?: number
+}
+
+export interface PlaygroundBillingRecordUsageOutput {
+minted: boolean
+accepted: (number | null)
+recorded: boolean
+duplicates: (number | null)
+http_status: number
+}
+
+export interface PlaygroundClickupCreateTaskInput {
+/**
+ * Task title; defaults to a fixture label
+ */
+name?: string
+/**
+ * ClickUp list id; falls back to CLICKUP_TEST_LIST_ID
+ */
+listId?: string
+}
+
+export interface PlaygroundClickupCreateTaskOutput {
+minted: boolean
+task_id: (string | null)
+list_status: number
+vend_status: number
+clickup_status: number
+installation_count: number
+}
+
+export interface PlaygroundClickupGetLastWebhookInput {
+
+}
+
+export type PlaygroundClickupGetLastWebhookOutput = ({
+payload: string
+event_id: string
+provider: string
+verified: boolean
+product_id: string
+occurred_at: string
+connector_id: string
+clickup_event: (string | null)
+receipt_count: number
+} | {
+found: false
+})
+
+export interface PlaygroundClickupGetOverviewInput {
+
+}
+
+export interface PlaygroundClickupGetOverviewOutput {
+team: ({
+teamId: string
+teamName: string
+} | null)
+lists: PlaygroundClickupGetOverviewOutputItems[]
+tasks: {
+id: string
+name: string
+status: (string | null)
+}[]
+minted: boolean
+spaces: PlaygroundClickupGetOverviewOutputItems[]
+list_status: number
+vend_status: number
+lists_status: number
+tasks_status: number
+spaces_status: number
+folders_status: number
+installation_count: number
+}
+export interface PlaygroundClickupGetOverviewOutputItems {
+id: string
+name: string
+}
+
+export interface PlaygroundEchoPingInput {
+/**
+ * The text to echo back, 1–1024 characters
+ */
+message: string
+}
+
+export interface PlaygroundEchoPingOutput {
+/**
+ * The message exactly as it was received
+ */
+message: string
+/**
+ * The product the call was resolved to
+ */
+productId: string
+/**
+ * ISO-8601 instant (UTC) at which the call reached the service
+ */
+receivedAt: string
+}
+
+export interface PlaygroundGdriveGetLastChangeInput {
+
+}
+
+export type PlaygroundGdriveGetLastChangeOutput = ({
+file_id: string
+removed: boolean
+file_name: (string | null)
+mime_type: (string | null)
+product_id: string
+occurred_at: string
+connector_id: string
+resource_state: string
+} | {
+found: false
+})
+
+export interface PlaygroundGdriveReadFileInput {
+/**
+ * Drive file id; falls back to GDRIVE_TEST_FILE_ID, then the first picked file
+ */
+fileId?: string
+}
+
+export interface PlaygroundGdriveReadFileOutput {
+minted: boolean
+file_id: (string | null)
+file_name: (string | null)
+mime_type: (string | null)
+file_count: number
+get_status: number
+list_status: number
+vend_status: number
+content_bytes: (number | null)
+}
+
+export interface PlaygroundGoogleadsReadCustomerInput {
+
+}
+
+export interface PlaygroundGoogleadsReadCustomerOutput {
+minted: boolean
+vended: boolean
+customer_id: (string | null)
+vend_status: number
+result_count: number
+search_status: number
+login_customer_id: (string | null)
+}
+
+export interface PlaygroundLifecycleGetStateInput {
+
+}
+
+export interface PlaygroundLifecycleGetStateOutput {
+blocked: boolean
+archived: boolean
+productId: string
+lastBlockTransition: ({
+eventId: string
+eventName: string
+productId: string
+occurredAt: string
+recordedAt: string
+receiptCount: number
+organizationId: string
+cascadedFromOrg: boolean
+} | null)
+lastArchiveTransition: ({
+eventId: string
+eventName: string
+productId: string
+occurredAt: string
+recordedAt: string
+receiptCount: number
+organizationId: string
+cascadedFromOrg: boolean
+} | null)
+}
+
+export interface PlaygroundLifecycleListEventsInput {
+
+}
+
+export type PlaygroundLifecycleListEventsOutput = {
+eventId: string
+eventName: string
+productId: string
+occurredAt: string
+recordedAt: string
+receiptCount: number
+organizationId: string
+cascadedFromOrg: boolean
+}[]
+
+export interface PlaygroundWebhookGetLastInput {
+
+}
+
+export type PlaygroundWebhookGetLastOutput = ({
+payload?: unknown
+event_id: string
+provider: string
+verified: boolean
+product_id: string
+occurred_at: string
+connector_id: string
+delivery_count: number
+} | {
+found: false
+})
+
+export interface PlaygroundWorkflowEchoInput {
+/**
+ * The text to store, 1–1024 characters
+ */
+note: string
+/**
+ * Optional labels stored alongside the note, at most 20
+ * 
+ * @maxItems 20
+ */
+tags?: []|[string]|[string, string]|[string, string, string]|[string, string, string, string]|[string, string, string, string, string]|[string, string, string, string, string, string]|[string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]|[string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string, string]
+}
+
+export interface PlaygroundWorkflowEchoOutput {
+/**
+ * Identifier of the stored echo
+ */
+id: string
+/**
+ * The note exactly as it was received
+ */
+note: string
+/**
+ * The tags exactly as they were received
+ */
+tags: string[]
+/**
+ * Correlation id for this echo. The playground/workflow.echoed event published about two seconds later repeats it, which is how a composer matches the completion back to this step.
+ */
+echo_id: string
+/**
+ * ISO-8601 instant (UTC) at which the echo was stored
+ */
+received_at: string
+}
+
+export interface PlaygroundWorkflowEchoListInput {
+
+}
+
+export type PlaygroundWorkflowEchoListOutput = {
+/**
+ * Identifier of the stored echo
+ */
+id: string
+/**
+ * The note exactly as it was received
+ */
+note: string
+/**
+ * The tags exactly as they were received
+ */
+tags: string[]
+/**
+ * ISO-8601 instant (UTC) at which the echo was stored
+ */
+received_at: string
+}[]
+
+export interface PlaygroundWorkflowPingInput {
+/**
+ * Class of ping, echoed on the emitted event and filterable on the trigger. Defaults to 'manual'.
+ */
+kind?: string
+}
+
+export interface PlaygroundWorkflowPingOutput {
+/**
+ * Correlation id for this ping. The emitted playground/workflow.ping event repeats it, which is how a composer matches the event back to this step.
+ */
+id: string
+/**
+ * The name of the event that was published
+ */
+event: string
+}
+
+export interface PlaygroundWorkflowSubjectsListInput {
+/**
+ * How many subjects to return, 1–100. Defaults to 25.
+ */
+limit?: number
+/**
+ * The next_cursor of the previous page. Opaque — pass it back unchanged. Omit for the first page.
+ */
+cursor?: string
+/**
+ * ISO-8601 UTC instant. Return only subjects whose last_activity_at is AT OR AFTER this — the opposite question, the recently active population. Omit for no lower bound.
+ */
+last_activity_after?: string
+/**
+ * ISO-8601 UTC instant. Return only subjects whose last_activity_at is AT OR BEFORE this — the "inactive for N days" question: pass now minus N days. Omit for no upper bound.
+ */
+last_activity_before?: string
+}
+
+export interface PlaygroundWorkflowSubjectsListOutput {
+/**
+ * This page of subjects, most recently active first
+ */
+items: {
+/**
+ * Stable identifier for the subject. This is the field a batch trigger keys on, so a subject already served in an earlier run is skipped rather than served twice.
+ */
+subject_key: string
+/**
+ * Human-readable name of the subject
+ */
+display_name: string
+/**
+ * ISO-8601 instant (UTC) of the subject last activity
+ */
+last_activity_at: string
+}[]
+/**
+ * Whether another page follows. False and a null next_cursor both mark the last page, so a consumer that loops on either terminates.
+ */
+has_more: boolean
+/**
+ * Pass back as `cursor` to fetch the next page; null on the last page. Always null when has_more is false.
+ */
+next_cursor: (string | null)
+}
+
+export interface PlaygroundWsEchoInput {
+
+}
+
+export type PlaygroundWsEchoOutput = unknown;
+
 export interface RealtimeArchiveExportInput {
 /**
  * Only entries with ts <= to_ts (epoch ms)
@@ -128996,7 +129354,7 @@ ended_at: (string | null)
 created_at: string
 started_at: (string | null)
 /**
- * Structured `{ code, tool|name, hint }` while `status` is `held`; null otherwise.
+ * Why the run is held; null otherwise. Either `{ code, tool|name, nodeId, hint }` — a grant, a principal, an unsupported or missing capability — or, when billing refused, `{ code: "entitlement", error, reason, meter, pool, upgrade_url, nodeId, tool }`: `upgrade_url` is the way out, and `nodeId`/`tool` are null when the run was refused before any node ran.
  */
 held_reason?: {
 [k: string]: unknown
@@ -129027,7 +129385,7 @@ ended_at: (string | null)
 created_at: string
 started_at: (string | null)
 /**
- * Structured `{ code, tool|name, hint }` while `status` is `held`; null otherwise.
+ * Why the run is held; null otherwise. Either `{ code, tool|name, nodeId, hint }` — a grant, a principal, an unsupported or missing capability — or, when billing refused, `{ code: "entitlement", error, reason, meter, pool, upgrade_url, nodeId, tool }`: `upgrade_url` is the way out, and `nodeId`/`tool` are null when the run was refused before any node ran.
  */
 held_reason?: {
 [k: string]: unknown
@@ -129116,7 +129474,7 @@ ended_at: (string | null)
 created_at: string
 started_at: (string | null)
 /**
- * Structured `{ code, tool|name, hint }` while `status` is `held`; null otherwise.
+ * Why the run is held; null otherwise. Either `{ code, tool|name, nodeId, hint }` — a grant, a principal, an unsupported or missing capability — or, when billing refused, `{ code: "entitlement", error, reason, meter, pool, upgrade_url, nodeId, tool }`: `upgrade_url` is the way out, and `nodeId`/`tool` are null when the run was refused before any node ran.
  */
 held_reason?: {
 [k: string]: unknown
@@ -129152,7 +129510,7 @@ ended_at: (string | null)
 created_at: string
 started_at: (string | null)
 /**
- * Structured `{ code, tool|name, hint }` while `status` is `held`; null otherwise.
+ * Why the run is held; null otherwise. Either `{ code, tool|name, nodeId, hint }` — a grant, a principal, an unsupported or missing capability — or, when billing refused, `{ code: "entitlement", error, reason, meter, pool, upgrade_url, nodeId, tool }`: `upgrade_url` is the way out, and `nodeId`/`tool` are null when the run was refused before any node ran.
  */
 held_reason?: {
 [k: string]: unknown
@@ -129296,7 +129654,7 @@ ended_at: (string | null)
 created_at: string
 started_at: (string | null)
 /**
- * Structured `{ code, tool|name, hint }` while `status` is `held`; null otherwise.
+ * Why the run is held; null otherwise. Either `{ code, tool|name, nodeId, hint }` — a grant, a principal, an unsupported or missing capability — or, when billing refused, `{ code: "entitlement", error, reason, meter, pool, upgrade_url, nodeId, tool }`: `upgrade_url` is the way out, and `nodeId`/`tool` are null when the run was refused before any node ran.
  */
 held_reason?: {
 [k: string]: unknown