@talqing/sdk 0.11.0 → 0.12.0

package/src/gen/types.gen.ts

@@ -3160,7 +3160,7 @@ export type CreateEmailSendRequest = {
     /**
      * From Email
      */
-    from_email?: string | null;
+    from_email?: string;
     /**
      * From Name
      */
@@ -3182,7 +3182,7 @@ export type CreateEmailSendRequest = {
     /**
      * Send Attempts
      */
-    send_attempts?: number | null;
+    send_attempts?: number;
     /**
      * Send Daily Cap
      */
@@ -3194,11 +3194,11 @@ export type CreateEmailSendRequest = {
     /**
      * Send Gap Seconds
      */
-    send_gap_seconds?: number | null;
+    send_gap_seconds?: number;
     /**
      * Send Retry After Minutes
      */
-    send_retry_after_minutes?: number | null;
+    send_retry_after_minutes?: number;
     /**
      * Start At
      */
@@ -3206,7 +3206,7 @@ export type CreateEmailSendRequest = {
     /**
      * Timezone
      */
-    timezone?: string | null;
+    timezone?: string;
     window?: TimeWindow | null;
 };
 
@@ -3371,6 +3371,98 @@ export type CreateTaskRequest = {
     config: TaskConfig;
 };
 
+/**
+ * CreateTaskRunBatchRequest
+ */
+export type CreateTaskRunBatchRequest = {
+    /**
+     * Runs
+     */
+    runs: Array<RunItem>;
+    /**
+     * A complete task definition, run and stored nowhere else.
+     */
+    task?: TaskConfig | null;
+    /**
+     * Task Id
+     *
+     * A task in this workspace. Exclusive with `task`.
+     */
+    task_id?: string | null;
+    /**
+     * Changes for this run only: objects deep-merge, lists replace, null clears.
+     */
+    task_override?: TaskPatch | null;
+    /**
+     * Task Version
+     *
+     * Which version of `task_id` to run. Omit for the published one; `"draft"` runs the unpublished config, held to the publish checks.
+     */
+    task_version?: number | 'draft' | null;
+};
+
+/**
+ * CreateTaskRunRequest
+ */
+export type CreateTaskRunRequest = {
+    /**
+     * Background
+     *
+     * Queue the run and return at once (202) instead of waiting for its result.
+     */
+    background?: boolean;
+    /**
+     * Files
+     *
+     * One PDF per declared `file` input, by name.
+     */
+    files?: {
+        [key: string]: FileInput;
+    };
+    /**
+     * Idempotency Key
+     *
+     * Resending the same key returns the existing run instead of starting another.
+     */
+    idempotency_key?: string | null;
+    /**
+     * Metadata
+     *
+     * Up to 16 string labels of your own, for filtering.
+     */
+    metadata?: {
+        [key: string]: unknown | string;
+    };
+    /**
+     * A complete task definition, run and stored nowhere else.
+     */
+    task?: TaskConfig | null;
+    /**
+     * Task Id
+     *
+     * A task in this workspace. Exclusive with `task`.
+     */
+    task_id?: string | null;
+    /**
+     * Changes for this run only: objects deep-merge, lists replace, null clears.
+     */
+    task_override?: TaskPatch | null;
+    /**
+     * Task Version
+     *
+     * Which version of `task_id` to run. Omit for the published one; `"draft"` runs the unpublished config, held to the publish checks.
+     */
+    task_version?: number | 'draft' | null;
+    /**
+     * Vars
+     *
+     * Values for the task's text inputs, by name. Undeclared names are refused.
+     */
+    vars?: {
+        [key: string]: string;
+    };
+};
+
 /**
  * CreateTelephonyAccountRequest
  */
@@ -3462,11 +3554,11 @@ export type CreateWhatsAppBatchRequest = {
      *
      * Sends per row, the first included, while Meta's per-person limit holds it back.
      */
-    delivery_attempts?: number | null;
+    delivery_attempts?: number;
     /**
      * Delivery Retry After Hours
      */
-    delivery_retry_after_hours?: number | null;
+    delivery_retry_after_hours?: number;
     /**
      * Integration Id
      *
@@ -3494,7 +3586,7 @@ export type CreateWhatsAppBatchRequest = {
     /**
      * Send Gap Seconds
      */
-    send_gap_seconds?: number | null;
+    send_gap_seconds?: number;
     /**
      * Template Id
      *
@@ -3504,7 +3596,7 @@ export type CreateWhatsAppBatchRequest = {
     /**
      * Timezone
      */
-    timezone?: string | null;
+    timezone?: string;
     /**
      * To Column
      *
@@ -3604,6 +3696,14 @@ export type CreditLedgerEntryResponse = {
      * Balance After
      */
     balance_after: number;
+    /**
+     * Channel
+     */
+    channel: 'voice' | 'video' | 'text' | null;
+    /**
+     * Conversation Id
+     */
+    conversation_id: string | null;
     /**
      * Created At
      */
@@ -3662,6 +3762,34 @@ export type DeleteRecipientsRequest = {
     recipient_ids: Array<string>;
 };
 
+/**
+ * DeleteTaskRunsRequest
+ */
+export type DeleteTaskRunsRequest = {
+    /**
+     * Metadata
+     *
+     * Runs whose metadata contains all of these pairs.
+     */
+    metadata: {
+        [key: string]: unknown | string;
+    };
+    /**
+     * Task Id
+     */
+    task_id?: string | null;
+};
+
+/**
+ * DeleteTaskRunsResponse
+ */
+export type DeleteTaskRunsResponse = {
+    /**
+     * Count
+     */
+    count: number;
+};
+
 /**
  * DeliveryError
  *
@@ -4555,6 +4683,30 @@ export type FieldMap = {
     to: string;
 };
 
+/**
+ * FileInput
+ *
+ * One PDF for a `file` input: a public https URL, or the bytes as a data URL.
+ */
+export type FileInput = {
+    /**
+     * Data Url
+     *
+     * `data:application/pdf;base64,<bytes>`, up to 20 MB decoded.
+     */
+    data_url?: string | null;
+    /**
+     * Filename
+     */
+    filename?: string | null;
+    /**
+     * Url
+     *
+     * An https URL the run downloads.
+     */
+    url?: string | null;
+};
+
 /**
  * FixedDailyCap
  *
@@ -7681,9 +7833,9 @@ export type PageTaskResponse = {
 };
 
 /**
- * Page[TaskRunResponse]
+ * Page[TaskRunSummary]
  */
-export type PageTaskRunResponse = {
+export type PageTaskRunSummary = {
     /**
      * Has More
      */
@@ -7691,7 +7843,7 @@ export type PageTaskRunResponse = {
     /**
      * Items
      */
-    items: Array<TaskRunResponse>;
+    items: Array<TaskRunSummary>;
     /**
      * Limit
      */
@@ -7850,7 +8002,7 @@ export type PatchCallBatchRequest = {
     /**
      * Agent Id
      */
-    agent_id?: string | null;
+    agent_id?: string;
     calling_window?: TimeWindow | null;
     /**
      * Dial Daily Cap
@@ -7863,27 +8015,27 @@ export type PatchCallBatchRequest = {
     /**
      * Dial Gap Seconds
      */
-    dial_gap_seconds?: number | null;
+    dial_gap_seconds?: number;
     /**
      * From Phone Number Id
      */
-    from_phone_number_id?: string | null;
+    from_phone_number_id?: string;
     /**
      * Max Attempts
      */
-    max_attempts?: number | null;
+    max_attempts?: number;
     /**
      * Max Concurrency
      */
-    max_concurrency?: number | null;
+    max_concurrency?: number;
     /**
      * Name
      */
-    name?: string | null;
+    name?: string;
     /**
      * Retry After Minutes
      */
-    retry_after_minutes?: number | null;
+    retry_after_minutes?: number;
     /**
      * Start At
      */
@@ -7891,7 +8043,7 @@ export type PatchCallBatchRequest = {
     /**
      * Timezone
      */
-    timezone?: string | null;
+    timezone?: string;
 };
 
 /**
@@ -7903,7 +8055,7 @@ export type PatchConversationRequest = {
      */
     metadata?: {
         [key: string]: unknown;
-    } | null;
+    };
     /**
      * Summary
      */
@@ -7913,7 +8065,7 @@ export type PatchConversationRequest = {
      */
     userdata?: {
         [key: string]: unknown;
-    } | null;
+    };
 };
 
 /**
@@ -7935,28 +8087,31 @@ export type PatchEmailBatchRequest = {
     /**
      * Body Format
      */
-    body_format?: 'text' | 'html' | null;
+    body_format?: 'text' | 'html';
     /**
      * Draft Attempts
      */
-    draft_attempts?: number | null;
+    draft_attempts?: number;
     /**
      * Draft Concurrency
      */
-    draft_concurrency?: number | null;
+    draft_concurrency?: number;
     /**
      * Draft Gap Seconds
      */
-    draft_gap_seconds?: number | null;
+    draft_gap_seconds?: number;
     /**
      * Draft Retry After Minutes
      */
-    draft_retry_after_minutes?: number | null;
-    field_map?: FieldMap | null;
+    draft_retry_after_minutes?: number;
+    /**
+     * Field Map
+     */
+    field_map?: FieldMap;
     /**
      * From Email
      */
-    from_email?: string | null;
+    from_email?: string;
     /**
      * From Name
      */
@@ -7964,7 +8119,7 @@ export type PatchEmailBatchRequest = {
     /**
      * Name
      */
-    name?: string | null;
+    name?: string;
     /**
      * Reply To
      */
@@ -7972,7 +8127,7 @@ export type PatchEmailBatchRequest = {
     /**
      * Send Attempts
      */
-    send_attempts?: number | null;
+    send_attempts?: number;
     /**
      * Send Daily Cap
      */
@@ -7984,11 +8139,11 @@ export type PatchEmailBatchRequest = {
     /**
      * Send Gap Seconds
      */
-    send_gap_seconds?: number | null;
+    send_gap_seconds?: number;
     /**
      * Send Retry After Minutes
      */
-    send_retry_after_minutes?: number | null;
+    send_retry_after_minutes?: number;
     /**
      * Start At
      */
@@ -7996,7 +8151,7 @@ export type PatchEmailBatchRequest = {
     /**
      * Timezone
      */
-    timezone?: string | null;
+    timezone?: string;
     window?: TimeWindow | null;
 };
 
@@ -8033,7 +8188,7 @@ export type PatchEmailSendRequest = {
     /**
      * Send Attempts
      */
-    send_attempts?: number | null;
+    send_attempts?: number;
     /**
      * Send Daily Cap
      */
@@ -8045,11 +8200,11 @@ export type PatchEmailSendRequest = {
     /**
      * Send Gap Seconds
      */
-    send_gap_seconds?: number | null;
+    send_gap_seconds?: number;
     /**
      * Send Retry After Minutes
      */
-    send_retry_after_minutes?: number | null;
+    send_retry_after_minutes?: number;
     /**
      * Start At
      */
@@ -8057,7 +8212,7 @@ export type PatchEmailSendRequest = {
     /**
      * Timezone
      */
-    timezone?: string | null;
+    timezone?: string;
     window?: TimeWindow | null;
 };
 
@@ -8068,47 +8223,47 @@ export type PatchIntegrationRequest = {
     /**
      * Allowed Tools
      */
-    allowed_tools?: Array<string> | null;
+    allowed_tools?: Array<string>;
     /**
      * Credentials Ref
      */
-    credentials_ref?: string | null;
+    credentials_ref?: string;
     /**
      * Display Name
      */
-    display_name?: string | null;
+    display_name?: string;
     /**
      * Mcp Config
      */
     mcp_config?: {
         [key: string]: unknown;
-    } | null;
+    };
     /**
      * Metadata
      */
     metadata?: {
         [key: string]: unknown;
-    } | null;
+    };
     /**
      * Provider Account Info
      */
     provider_account_info?: {
         [key: string]: unknown;
-    } | null;
+    };
     /**
      * Status
      */
-    status?: 'active' | 'disabled' | 'needs_reconnect' | 'error' | null;
+    status?: 'active' | 'disabled' | 'needs_reconnect' | 'error';
     /**
      * Tools Namespace
      */
-    tools_namespace?: string | null;
+    tools_namespace?: string;
     /**
      * Webhook Config
      */
     webhook_config?: {
         [key: string]: unknown;
-    } | null;
+    };
 };
 
 /**
@@ -8122,13 +8277,13 @@ export type PatchIntegrationTriggerRequest = {
     /**
      * Enabled
      */
-    enabled?: boolean | null;
+    enabled?: boolean;
     /**
      * Metadata
      */
     metadata?: {
         [key: string]: unknown;
-    } | null;
+    };
     /**
      * Provider Subscription Ref
      */
@@ -8136,15 +8291,15 @@ export type PatchIntegrationTriggerRequest = {
     /**
      * Reply Mode
      */
-    reply_mode?: 'public_reply' | 'internal_note' | 'none' | null;
+    reply_mode?: 'public_reply' | 'internal_note' | 'none';
     /**
      * Status
      */
-    status?: 'active' | 'disabled' | 'needs_setup' | 'error' | null;
+    status?: 'active' | 'disabled' | 'needs_setup' | 'error';
     /**
      * Trigger Type
      */
-    trigger_type?: 'telegram.message.inbound' | 'whatsapp.message.inbound' | 'whatsapp.call.inbound' | null;
+    trigger_type?: 'telegram.message.inbound' | 'whatsapp.message.inbound' | 'whatsapp.call.inbound';
 };
 
 /**
@@ -8154,11 +8309,11 @@ export type PatchPhoneNumberRequest = {
     /**
      * Can Inbound
      */
-    can_inbound?: boolean | null;
+    can_inbound?: boolean;
     /**
      * Can Outbound
      */
-    can_outbound?: boolean | null;
+    can_outbound?: boolean;
     /**
      * Label
      */
@@ -8166,11 +8321,11 @@ export type PatchPhoneNumberRequest = {
     /**
      * Region
      */
-    region?: 'us' | 'in' | null;
+    region?: 'us' | 'in';
     /**
      * Status
      */
-    status?: 'disabled' | 'pending' | null;
+    status?: 'disabled' | 'pending';
 };
 
 /**
@@ -8180,19 +8335,19 @@ export type PatchStreamConnectionRequest = {
     /**
      * Agent Id
      */
-    agent_id?: string | null;
+    agent_id?: string;
     /**
      * Name
      */
-    name?: string | null;
+    name?: string;
     /**
      * Region
      */
-    region?: 'us' | 'in' | null;
+    region?: 'us' | 'in';
     /**
      * Status
      */
-    status?: 'active' | 'disabled' | null;
+    status?: 'active' | 'disabled';
 };
 
 /**
@@ -8214,29 +8369,29 @@ export type PatchTelephonyAccountRequest = {
      */
     account_info?: {
         [key: string]: unknown;
-    } | null;
+    };
     /**
      * Console Setup Confirmed
      */
-    console_setup_confirmed?: boolean | null;
+    console_setup_confirmed?: boolean;
     /**
      * Console Setup Region
      */
-    console_setup_region?: 'us' | 'in' | null;
+    console_setup_region?: 'us' | 'in';
     /**
      * Credentials
      */
     credentials?: {
         [key: string]: string;
-    } | null;
+    };
     /**
      * Display Name
      */
-    display_name?: string | null;
+    display_name?: string;
     /**
      * Status
      */
-    status?: 'disabled' | 'connected' | null;
+    status?: 'disabled' | 'connected';
 };
 
 /**
@@ -8246,33 +8401,33 @@ export type PatchToolRequest = {
     /**
      * Description
      */
-    description?: string | null;
+    description?: string;
     /**
      * Disable Interruptions
      */
-    disable_interruptions?: boolean | null;
+    disable_interruptions?: boolean;
     /**
      * Json Schema
      */
     json_schema?: {
         [key: string]: unknown;
-    } | null;
+    };
     /**
      * Long Running Task
      */
-    long_running_task?: boolean | null;
+    long_running_task?: boolean;
     /**
      * Name
      */
-    name?: string | null;
+    name?: string;
     /**
      * Operations
      */
-    operations?: Array<HttpOperation | CodeOperation | FrontendRpcOperation | IfOperation | SetVariableOperation | SayOperation | GenerateReplyOperation | AddMessageOperation | EndCallOperation | HandoffOperation | TransferOperation | SendDtmfOperation> | null;
+    operations?: Array<HttpOperation | CodeOperation | FrontendRpcOperation | IfOperation | SetVariableOperation | SayOperation | GenerateReplyOperation | AddMessageOperation | EndCallOperation | HandoffOperation | TransferOperation | SendDtmfOperation>;
     /**
      * Silent
      */
-    silent?: boolean | null;
+    silent?: boolean;
 };
 
 /**
@@ -8282,15 +8437,15 @@ export type PatchWebhookRequest = {
     /**
      * Status
      */
-    status?: 'active' | 'disabled' | null;
+    status?: 'active' | 'disabled';
     /**
      * Subscribed Events
      */
-    subscribed_events?: Array<string> | null;
+    subscribed_events?: Array<string>;
     /**
      * Url
      */
-    url?: string | null;
+    url?: string;
 };
 
 /**
@@ -8304,15 +8459,15 @@ export type PatchWhatsAppBatchRequest = {
      *
      * Sends per row, the first included, while Meta's per-person limit holds it back.
      */
-    delivery_attempts?: number | null;
+    delivery_attempts?: number;
     /**
      * Delivery Retry After Hours
      */
-    delivery_retry_after_hours?: number | null;
+    delivery_retry_after_hours?: number;
     /**
      * Name
      */
-    name?: string | null;
+    name?: string;
     /**
      * Send Daily Cap
      *
@@ -8326,7 +8481,7 @@ export type PatchWhatsAppBatchRequest = {
     /**
      * Send Gap Seconds
      */
-    send_gap_seconds?: number | null;
+    send_gap_seconds?: number;
     /**
      * Start At
      */
@@ -8334,13 +8489,13 @@ export type PatchWhatsAppBatchRequest = {
     /**
      * Timezone
      */
-    timezone?: string | null;
+    timezone?: string;
     /**
      * Variable Map
      */
     variable_map?: {
         [key: string]: string;
-    } | null;
+    };
     window?: TimeWindow | null;
 };
 
@@ -9498,6 +9653,44 @@ export type Routes = {
     tts: RoutedTTS;
 };
 
+/**
+ * RunItem
+ *
+ * One run's inputs and labels.
+ */
+export type RunItem = {
+    /**
+     * Files
+     *
+     * One PDF per declared `file` input, by name.
+     */
+    files?: {
+        [key: string]: FileInput;
+    };
+    /**
+     * Idempotency Key
+     *
+     * Resending the same key returns the existing run instead of starting another.
+     */
+    idempotency_key?: string | null;
+    /**
+     * Metadata
+     *
+     * Up to 16 string labels of your own, for filtering.
+     */
+    metadata?: {
+        [key: string]: unknown | string;
+    };
+    /**
+     * Vars
+     *
+     * Values for the task's text inputs, by name. Undeclared names are refused.
+     */
+    vars?: {
+        [key: string]: string;
+    };
+};
+
 /**
  * RunStepResponse
  *
@@ -9540,26 +9733,6 @@ export type RunStepResponse = {
     status: string;
 };
 
-/**
- * RunTaskRequest
- */
-export type RunTaskRequest = {
-    /**
-     * Vars
-     *
-     * Values for the variables this task declares, by name. A `required` variable with no value and no default is refused before the run starts; a name the task does not declare is refused too, rather than silently dropped.
-     */
-    vars?: {
-        [key: string]: string;
-    };
-    /**
-     * Version
-     *
-     * Which definition to run. Omitted runs the published version. A number runs that frozen version. 'draft' runs the unpublished config, validated and tool-pinned at request time and refused with the publish errors if it does not hold together.
-     */
-    version?: number | 'draft' | null;
-};
-
 /**
  * RunToolRequest
  */
@@ -10035,11 +10208,11 @@ export type SendWhatsAppBatchRequest = {
      *
      * Sends per row, the first included, while Meta's per-person limit holds it back.
      */
-    delivery_attempts?: number | null;
+    delivery_attempts?: number;
     /**
      * Delivery Retry After Hours
      */
-    delivery_retry_after_hours?: number | null;
+    delivery_retry_after_hours?: number;
     /**
      * Send Daily Cap
      *
@@ -10053,7 +10226,7 @@ export type SendWhatsAppBatchRequest = {
     /**
      * Send Gap Seconds
      */
-    send_gap_seconds?: number | null;
+    send_gap_seconds?: number;
     /**
      * Start At
      */
@@ -10061,7 +10234,7 @@ export type SendWhatsAppBatchRequest = {
     /**
      * Timezone
      */
-    timezone?: string | null;
+    timezone?: string;
     window?: TimeWindow | null;
 };
 
@@ -10876,7 +11049,7 @@ export type TTSUsageResponse = {
  *
  * It declares no channel, no media and no greeting. Entered by an agent it
  * speaks with that call's voice and hears with its ears; run on its own from
- * `POST /tasks/{id}/run` it is an LLM with tools and nobody to talk to. Which
+ * `POST /task-runs` it is an LLM with tools and nobody to talk to. Which
  * of the two happens is the caller's, never the task's.
  */
 export type TaskConfig = {
@@ -10917,7 +11090,7 @@ export type TaskConfig = {
     /**
      * Output
      *
-     * The typed value this task produces. The model is given a `submit_result` tool built from these fields and told that calling it is how the run finishes. Publishing needs at least one; a draft may be empty.
+     * The typed value this task produces: up to 25 top-level fields, nesting up to 4 levels and 100 fields in all. The model finishes by calling a `submit_result` tool built from them. Publishing needs at least one.
      */
     output?: Array<TaskOutputField>;
     /**
@@ -10961,9 +11134,7 @@ export type TaskConfig = {
 /**
  * TaskOutputField
  *
- * One value the model must produce.
- *
- * Flat scalars only — no arrays and no nested objects.
+ * One value the model must produce: a scalar, an object of named fields, or an array.
  */
 export type TaskOutputField = {
     /**
@@ -10972,6 +11143,22 @@ export type TaskOutputField = {
      * What the model should put here, and what to send when it cannot find out. This is the field's description in the tool schema, so it is literally the prompt for this value.
      */
     description: string;
+    /**
+     * Enum
+     *
+     * Allowed values. Strings only.
+     */
+    enum?: Array<string> | null;
+    /**
+     * Fields
+     *
+     * An object's fields.
+     */
+    fields?: Array<TaskOutputField> | null;
+    /**
+     * An array's element.
+     */
+    items?: TaskOutputItem | null;
     /**
      * Name
      *
@@ -10987,23 +11174,57 @@ export type TaskOutputField = {
     /**
      * Type
      *
-     * The shape of the value. Anything that is not a number or a yes/no is a string.
+     * The shape of the value. `object` takes `fields`; `array` takes `items`.
      */
-    type?: 'string' | 'boolean' | 'integer' | 'number';
+    type?: 'string' | 'boolean' | 'integer' | 'number' | 'object' | 'array';
 };
 
 /**
- * TaskPatch
+ * TaskOutputItem
  *
- * A partial TaskConfig: only the fields this call changes. Absent keeps the base value, an explicit null clears it, objects deep-merge and lists replace.
+ * What an array holds: one element's shape. Unnamed, and never null.
  */
-export type TaskPatch = {
+export type TaskOutputItem = {
     /**
-     * Faqs
+     * Description
      *
-     * FAQs the agent answers from: questions go in the prompt, answers are fetched on demand.
+     * What one element is.
      */
-    faqs?: Array<FaqSelection> | null;
+    description?: string;
+    /**
+     * Enum
+     *
+     * Allowed values. Strings only.
+     */
+    enum?: Array<string> | null;
+    /**
+     * Fields
+     *
+     * An object element's fields.
+     */
+    fields?: Array<TaskOutputField> | null;
+    /**
+     * A nested array's element.
+     */
+    items?: TaskOutputItem | null;
+    /**
+     * Type
+     */
+    type?: 'string' | 'boolean' | 'integer' | 'number' | 'object' | 'array';
+};
+
+/**
+ * TaskPatch
+ *
+ * A partial TaskConfig: only the fields this call changes. Absent keeps the base value, an explicit null clears it, objects deep-merge and lists replace.
+ */
+export type TaskPatch = {
+    /**
+     * Faqs
+     *
+     * FAQs the agent answers from: questions go in the prompt, answers are fetched on demand.
+     */
+    faqs?: Array<FaqSelection> | null;
     /**
      * Finish Without Result Description
      *
@@ -11035,7 +11256,7 @@ export type TaskPatch = {
     /**
      * Output
      *
-     * The typed value this task produces. The model is given a `submit_result` tool built from these fields and told that calling it is how the run finishes. Publishing needs at least one; a draft may be empty.
+     * The typed value this task produces: up to 25 top-level fields, nesting up to 4 levels and 100 fields in all. The model finishes by calling a `submit_result` tool built from them. Publishing needs at least one.
      */
     output?: Array<TaskOutputField> | null;
     /**
@@ -11112,6 +11333,38 @@ export type TaskResponse = {
     versions: Array<TaskVersionResponse> | null;
 };
 
+/**
+ * TaskRunBatchItem
+ */
+export type TaskRunBatchItem = {
+    /**
+     * Deduplicated
+     */
+    deduplicated: boolean;
+    /**
+     * Id
+     */
+    id: string;
+    /**
+     * Idempotency Key
+     */
+    idempotency_key: string | null;
+    /**
+     * Status
+     */
+    status: 'queued' | 'running' | 'completed' | 'failed' | 'canceled';
+};
+
+/**
+ * TaskRunBatchResponse
+ */
+export type TaskRunBatchResponse = {
+    /**
+     * Runs
+     */
+    runs: Array<TaskRunBatchItem>;
+};
+
 /**
  * TaskRunError
  */
@@ -11123,21 +11376,104 @@ export type TaskRunError = {
     /**
      * Type
      */
-    type: 'missing_vars' | 'no_output' | 'step_limit' | 'timeout' | 'provider_error' | 'configuration' | 'platform' | 'canceled';
+    type: 'invalid_input' | 'no_output' | 'step_limit' | 'timeout' | 'provider_error' | 'configuration' | 'platform' | 'canceled';
+};
+
+/**
+ * TaskRunFile
+ *
+ * What one PDF input turned into before the model read it.
+ */
+export type TaskRunFile = {
+    /**
+     * Bytes
+     */
+    bytes: number;
+    /**
+     * Filename
+     */
+    filename: string | null;
+    /**
+     * Images
+     */
+    images: Array<TaskRunImage>;
+    /**
+     * Input
+     */
+    input: string;
+    /**
+     * Pages
+     */
+    pages: number;
+    /**
+     * Text
+     */
+    text: string;
+};
+
+/**
+ * TaskRunImage
+ *
+ * A scanned page, as the model saw it.
+ */
+export type TaskRunImage = {
+    /**
+     * Height
+     */
+    height: number;
+    /**
+     * Page
+     */
+    page: number;
+    /**
+     * Url
+     */
+    url: string;
+    /**
+     * Url Expires At
+     */
+    url_expires_at: string;
+    /**
+     * Width
+     */
+    width: number;
 };
 
 /**
  * TaskRunResponse
+ *
+ * One run in full: the config it ran, its inputs, its trace and its usage.
  */
 export type TaskRunResponse = {
     /**
      * Attempts
      */
     attempts: number;
+    /**
+     * Background
+     */
+    background: boolean;
     /**
      * Billing Status
      */
     billing_status: string;
+    /**
+     * Cancel Requested At
+     */
+    cancel_requested_at: string | null;
+    config: TaskConfig | null;
+    /**
+     * Content Deleted At
+     */
+    content_deleted_at: string | null;
+    /**
+     * Content Expires At
+     */
+    content_expires_at: string | null;
+    /**
+     * Created At
+     */
+    created_at: string;
     /**
      * Duration Ms
      */
@@ -11147,14 +11483,28 @@ export type TaskRunResponse = {
      */
     ended_at: string | null;
     error: TaskRunError | null;
+    /**
+     * Files
+     */
+    files: Array<TaskRunFile>;
     /**
      * Id
      */
     id: string;
+    /**
+     * Idempotency Key
+     */
+    idempotency_key: string | null;
     /**
      * Max Steps
      */
     max_steps: number;
+    /**
+     * Metadata
+     */
+    metadata: {
+        [key: string]: string;
+    };
     /**
      * Output
      */
@@ -11168,11 +11518,11 @@ export type TaskRunResponse = {
     /**
      * Started At
      */
-    started_at: string;
+    started_at: string | null;
     /**
      * Status
      */
-    status: 'running' | 'completed' | 'failed';
+    status: 'queued' | 'running' | 'completed' | 'failed' | 'canceled';
     /**
      * Steps Used
      */
@@ -11193,6 +11543,10 @@ export type TaskRunResponse = {
      * Trace
      */
     trace: Array<TraceStepResponse>;
+    /**
+     * Tries
+     */
+    tries: number;
     /**
      * Usage
      */
@@ -11208,34 +11562,90 @@ export type TaskRunResponse = {
 /**
  * TaskRunSummary
  *
- * A run, as the list page shows it: what happened, when, and what it cost.
+ * A run without its trace, config or inputs: the list item, the
+ * `task_run.completed` webhook body and a task's `last_run`, one shape for all three.
  *
  * `error` is the same object a full run carries rather than a bare type, so
- * one reader answers "how did it go" for both — a summary that spelled the
- * same fact differently would be two shapes for one question.
+ * one reader answers "how did it go" for both.
  */
 export type TaskRunSummary = {
+    /**
+     * Background
+     */
+    background: boolean;
+    /**
+     * Billing Status
+     */
+    billing_status: string;
+    /**
+     * Content Deleted At
+     */
+    content_deleted_at: string | null;
+    /**
+     * Content Expires At
+     */
+    content_expires_at: string | null;
+    /**
+     * Created At
+     */
+    created_at: string;
     /**
      * Duration Ms
      */
-    duration_ms?: number | null;
-    error?: TaskRunError | null;
+    duration_ms: number | null;
+    /**
+     * Ended At
+     */
+    ended_at: string | null;
+    error: TaskRunError | null;
     /**
      * Id
      */
     id: string;
+    /**
+     * Idempotency Key
+     */
+    idempotency_key: string | null;
+    /**
+     * Metadata
+     */
+    metadata: {
+        [key: string]: string;
+    };
+    /**
+     * Output
+     */
+    output: {
+        [key: string]: unknown;
+    } | null;
     /**
      * Provider Cost
      */
-    provider_cost?: number | null;
+    provider_cost: number | null;
     /**
      * Started At
      */
-    started_at: string;
+    started_at: string | null;
     /**
      * Status
      */
-    status: 'running' | 'completed' | 'failed';
+    status: 'queued' | 'running' | 'completed' | 'failed' | 'canceled';
+    /**
+     * Task Id
+     */
+    task_id: string | null;
+    /**
+     * Task Name
+     */
+    task_name: string | null;
+    /**
+     * Task Version
+     */
+    task_version: number | null;
+    /**
+     * Tries
+     */
+    tries: number;
 };
 
 /**
@@ -12159,11 +12569,11 @@ export type UpdateFaqEntryRequest = {
     /**
      * Answer
      */
-    answer?: string | null;
+    answer?: string;
     /**
      * Question
      */
-    question?: string | null;
+    question?: string;
 };
 
 /**
@@ -12248,6 +12658,18 @@ export type VarDeclaration = {
      * Refuse the session rather than resolve this to nothing; a `default` satisfies it. An inbound phone call carries no request to supply values, so a voice agent requiring a variable with no default cannot be assigned to a phone number.
      */
     required?: boolean;
+    /**
+     * Type
+     *
+     * 'file' takes a PDF on a task run. Tasks only.
+     */
+    type?: 'text' | 'file';
+    /**
+     * Untrusted
+     *
+     * Third-party content: given to the model as data, never templated. Tasks only.
+     */
+    untrusted?: boolean;
 };
 
 /**
@@ -19090,10 +19512,32 @@ export type TelephonyStreamsUpdateResults = {
 
 export type TelephonyStreamsUpdateResult = TelephonyStreamsUpdateResults[keyof TelephonyStreamsUpdateResults];
 
-export type TasksListData = {
+export type TaskRunsListData = {
     body?: never;
     path?: never;
     query?: {
+        /**
+         * Task Id
+         */
+        task_id?: string | null;
+        /**
+         * Status
+         */
+        status?: 'queued' | 'running' | 'completed' | 'failed' | 'canceled' | null;
+        /**
+         * Metadata
+         *
+         * `key:value` pairs, all must match.
+         */
+        metadata?: Array<string>;
+        /**
+         * Created After
+         */
+        created_after?: string | null;
+        /**
+         * Created Before
+         */
+        created_before?: string | null;
         /**
          * Limit
          */
@@ -19103,10 +19547,10 @@ export type TasksListData = {
          */
         offset?: number;
     };
-    url: '/v1/tasks';
+    url: '/v1/task-runs';
 };
 
-export type TasksListErrors = {
+export type TaskRunsListErrors = {
     /**
      * Missing credential, or one that is revoked or no longer a member of this organization.
      */
@@ -19121,25 +19565,25 @@ export type TasksListErrors = {
     default: ErrorResponse;
 };
 
-export type TasksListError = TasksListErrors[keyof TasksListErrors];
+export type TaskRunsListError = TaskRunsListErrors[keyof TaskRunsListErrors];
 
-export type TasksListResults = {
+export type TaskRunsListResults = {
     /**
      * Successful Response
      */
-    200: PageTaskResponse;
+    200: PageTaskRunSummary;
 };
 
-export type TasksListResult = TasksListResults[keyof TasksListResults];
+export type TaskRunsListResult = TaskRunsListResults[keyof TaskRunsListResults];
 
-export type TasksCreateData = {
-    body: CreateTaskRequest;
+export type TaskRunsCreateData = {
+    body: CreateTaskRunRequest;
     path?: never;
     query?: never;
-    url: '/v1/tasks';
+    url: '/v1/task-runs';
 };
 
-export type TasksCreateErrors = {
+export type TaskRunsCreateErrors = {
     /**
      * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
      */
@@ -19166,30 +19610,124 @@ export type TasksCreateErrors = {
     default: ErrorResponse;
 };
 
-export type TasksCreateError = TasksCreateErrors[keyof TasksCreateErrors];
+export type TaskRunsCreateError = TaskRunsCreateErrors[keyof TaskRunsCreateErrors];
 
-export type TasksCreateResults = {
+export type TaskRunsCreateResults = {
     /**
      * Successful Response
      */
-    201: TaskResponse;
+    200: TaskRunResponse;
+    /**
+     * Queued (`background: true`).
+     */
+    202: TaskRunResponse;
 };
 
-export type TasksCreateResult = TasksCreateResults[keyof TasksCreateResults];
+export type TaskRunsCreateResult = TaskRunsCreateResults[keyof TaskRunsCreateResults];
 
-export type TasksDeleteData = {
+export type TaskRunsCreateBatchData = {
+    body: CreateTaskRunBatchRequest;
+    path?: never;
+    query?: never;
+    url: '/v1/task-runs/batch';
+};
+
+export type TaskRunsCreateBatchErrors = {
+    /**
+     * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
+     */
+    400: ErrorResponse;
+    /**
+     * Missing credential, or one that is revoked or no longer a member of this organization.
+     */
+    401: ErrorResponse;
+    /**
+     * Authenticated, but this organization role may not perform the operation.
+     */
+    403: ErrorResponse;
+    /**
+     * The resource's current state forbids this — a name already taken, a job already running.
+     */
+    409: ErrorResponse;
+    /**
+     * The request did not match this operation's schema; `detail.errors` lists each field.
+     */
+    422: ErrorResponse;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+
+export type TaskRunsCreateBatchError = TaskRunsCreateBatchErrors[keyof TaskRunsCreateBatchErrors];
+
+export type TaskRunsCreateBatchResults = {
+    /**
+     * Successful Response
+     */
+    202: TaskRunBatchResponse;
+};
+
+export type TaskRunsCreateBatchResult = TaskRunsCreateBatchResults[keyof TaskRunsCreateBatchResults];
+
+export type TaskRunsDeleteManyData = {
+    body: DeleteTaskRunsRequest;
+    path?: never;
+    query?: never;
+    url: '/v1/task-runs/delete';
+};
+
+export type TaskRunsDeleteManyErrors = {
+    /**
+     * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
+     */
+    400: ErrorResponse;
+    /**
+     * Missing credential, or one that is revoked or no longer a member of this organization.
+     */
+    401: ErrorResponse;
+    /**
+     * Authenticated, but this organization role may not perform the operation.
+     */
+    403: ErrorResponse;
+    /**
+     * The resource's current state forbids this — a name already taken, a job already running.
+     */
+    409: ErrorResponse;
+    /**
+     * The request did not match this operation's schema; `detail.errors` lists each field.
+     */
+    422: ErrorResponse;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+
+export type TaskRunsDeleteManyError = TaskRunsDeleteManyErrors[keyof TaskRunsDeleteManyErrors];
+
+export type TaskRunsDeleteManyResults = {
+    /**
+     * Successful Response
+     */
+    202: DeleteTaskRunsResponse;
+};
+
+export type TaskRunsDeleteManyResult = TaskRunsDeleteManyResults[keyof TaskRunsDeleteManyResults];
+
+export type TaskRunsDeleteData = {
     body?: never;
     path: {
         /**
-         * Task Id
+         * Run Id
          */
-        task_id: string;
+        run_id: string;
     };
     query?: never;
-    url: '/v1/tasks/{task_id}';
+    url: '/v1/task-runs/{run_id}';
 };
 
-export type TasksDeleteErrors = {
+export type TaskRunsDeleteErrors = {
     /**
      * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
      */
@@ -19220,30 +19758,28 @@ export type TasksDeleteErrors = {
     default: ErrorResponse;
 };
 
-export type TasksDeleteError = TasksDeleteErrors[keyof TasksDeleteErrors];
+export type TaskRunsDeleteError = TaskRunsDeleteErrors[keyof TaskRunsDeleteErrors];
 
-export type TasksDeleteResults = {
+export type TaskRunsDeleteResults = {
     /**
-     * Successful Response
+     * Deletion scheduled. No body.
      */
-    200: OkResponse;
+    202: unknown;
 };
 
-export type TasksDeleteResult = TasksDeleteResults[keyof TasksDeleteResults];
-
-export type TasksGetData = {
+export type TaskRunsGetData = {
     body?: never;
     path: {
         /**
-         * Task Id
+         * Run Id
          */
-        task_id: string;
+        run_id: string;
     };
     query?: never;
-    url: '/v1/tasks/{task_id}';
+    url: '/v1/task-runs/{run_id}';
 };
 
-export type TasksGetErrors = {
+export type TaskRunsGetErrors = {
     /**
      * Missing credential, or one that is revoked or no longer a member of this organization.
      */
@@ -19262,30 +19798,30 @@ export type TasksGetErrors = {
     default: ErrorResponse;
 };
 
-export type TasksGetError = TasksGetErrors[keyof TasksGetErrors];
+export type TaskRunsGetError = TaskRunsGetErrors[keyof TaskRunsGetErrors];
 
-export type TasksGetResults = {
+export type TaskRunsGetResults = {
     /**
      * Successful Response
      */
-    200: TaskResponse;
+    200: TaskRunResponse;
 };
 
-export type TasksGetResult = TasksGetResults[keyof TasksGetResults];
+export type TaskRunsGetResult = TaskRunsGetResults[keyof TaskRunsGetResults];
 
-export type TasksUpdateData = {
-    body: PatchTaskRequest;
+export type TaskRunsCancelData = {
+    body?: never;
     path: {
         /**
-         * Task Id
+         * Run Id
          */
-        task_id: string;
+        run_id: string;
     };
     query?: never;
-    url: '/v1/tasks/{task_id}';
+    url: '/v1/task-runs/{run_id}/cancel';
 };
 
-export type TasksUpdateErrors = {
+export type TaskRunsCancelErrors = {
     /**
      * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
      */
@@ -19316,18 +19852,105 @@ export type TasksUpdateErrors = {
     default: ErrorResponse;
 };
 
-export type TasksUpdateError = TasksUpdateErrors[keyof TasksUpdateErrors];
+export type TaskRunsCancelError = TaskRunsCancelErrors[keyof TaskRunsCancelErrors];
 
-export type TasksUpdateResults = {
+export type TaskRunsCancelResults = {
     /**
      * Successful Response
      */
-    200: TaskResponse;
+    200: TaskRunResponse;
 };
 
-export type TasksUpdateResult = TasksUpdateResults[keyof TasksUpdateResults];
+export type TaskRunsCancelResult = TaskRunsCancelResults[keyof TaskRunsCancelResults];
 
-export type TasksPublishData = {
+export type TasksListData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Limit
+         */
+        limit?: number;
+        /**
+         * Offset
+         */
+        offset?: number;
+    };
+    url: '/v1/tasks';
+};
+
+export type TasksListErrors = {
+    /**
+     * Missing credential, or one that is revoked or no longer a member of this organization.
+     */
+    401: ErrorResponse;
+    /**
+     * The request did not match this operation's schema; `detail.errors` lists each field.
+     */
+    422: ErrorResponse;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+
+export type TasksListError = TasksListErrors[keyof TasksListErrors];
+
+export type TasksListResults = {
+    /**
+     * Successful Response
+     */
+    200: PageTaskResponse;
+};
+
+export type TasksListResult = TasksListResults[keyof TasksListResults];
+
+export type TasksCreateData = {
+    body: CreateTaskRequest;
+    path?: never;
+    query?: never;
+    url: '/v1/tasks';
+};
+
+export type TasksCreateErrors = {
+    /**
+     * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
+     */
+    400: ErrorResponse;
+    /**
+     * Missing credential, or one that is revoked or no longer a member of this organization.
+     */
+    401: ErrorResponse;
+    /**
+     * Authenticated, but this organization role may not perform the operation.
+     */
+    403: ErrorResponse;
+    /**
+     * The resource's current state forbids this — a name already taken, a job already running.
+     */
+    409: ErrorResponse;
+    /**
+     * The request did not match this operation's schema; `detail.errors` lists each field.
+     */
+    422: ErrorResponse;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+
+export type TasksCreateError = TasksCreateErrors[keyof TasksCreateErrors];
+
+export type TasksCreateResults = {
+    /**
+     * Successful Response
+     */
+    201: TaskResponse;
+};
+
+export type TasksCreateResult = TasksCreateResults[keyof TasksCreateResults];
+
+export type TasksDeleteData = {
     body?: never;
     path: {
         /**
@@ -19336,10 +19959,10 @@ export type TasksPublishData = {
         task_id: string;
     };
     query?: never;
-    url: '/v1/tasks/{task_id}/publish';
+    url: '/v1/tasks/{task_id}';
 };
 
-export type TasksPublishErrors = {
+export type TasksDeleteErrors = {
     /**
      * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
      */
@@ -19370,18 +19993,18 @@ export type TasksPublishErrors = {
     default: ErrorResponse;
 };
 
-export type TasksPublishError = TasksPublishErrors[keyof TasksPublishErrors];
+export type TasksDeleteError = TasksDeleteErrors[keyof TasksDeleteErrors];
 
-export type TasksPublishResults = {
+export type TasksDeleteResults = {
     /**
      * Successful Response
      */
-    200: PublishTaskResponse;
+    200: OkResponse;
 };
 
-export type TasksPublishResult = TasksPublishResults[keyof TasksPublishResults];
+export type TasksDeleteResult = TasksDeleteResults[keyof TasksDeleteResults];
 
-export type TasksRunsListData = {
+export type TasksGetData = {
     body?: never;
     path: {
         /**
@@ -19389,20 +20012,11 @@ export type TasksRunsListData = {
          */
         task_id: string;
     };
-    query?: {
-        /**
-         * Limit
-         */
-        limit?: number;
-        /**
-         * Offset
-         */
-        offset?: number;
-    };
-    url: '/v1/tasks/{task_id}/runs';
+    query?: never;
+    url: '/v1/tasks/{task_id}';
 };
 
-export type TasksRunsListErrors = {
+export type TasksGetErrors = {
     /**
      * Missing credential, or one that is revoked or no longer a member of this organization.
      */
@@ -19421,19 +20035,19 @@ export type TasksRunsListErrors = {
     default: ErrorResponse;
 };
 
-export type TasksRunsListError = TasksRunsListErrors[keyof TasksRunsListErrors];
+export type TasksGetError = TasksGetErrors[keyof TasksGetErrors];
 
-export type TasksRunsListResults = {
+export type TasksGetResults = {
     /**
      * Successful Response
      */
-    200: PageTaskRunResponse;
+    200: TaskResponse;
 };
 
-export type TasksRunsListResult = TasksRunsListResults[keyof TasksRunsListResults];
+export type TasksGetResult = TasksGetResults[keyof TasksGetResults];
 
-export type TasksRunsCreateData = {
-    body: RunTaskRequest;
+export type TasksUpdateData = {
+    body: PatchTaskRequest;
     path: {
         /**
          * Task Id
@@ -19441,10 +20055,10 @@ export type TasksRunsCreateData = {
         task_id: string;
     };
     query?: never;
-    url: '/v1/tasks/{task_id}/runs';
+    url: '/v1/tasks/{task_id}';
 };
 
-export type TasksRunsCreateErrors = {
+export type TasksUpdateErrors = {
     /**
      * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
      */
@@ -19475,42 +20089,50 @@ export type TasksRunsCreateErrors = {
     default: ErrorResponse;
 };
 
-export type TasksRunsCreateError = TasksRunsCreateErrors[keyof TasksRunsCreateErrors];
+export type TasksUpdateError = TasksUpdateErrors[keyof TasksUpdateErrors];
 
-export type TasksRunsCreateResults = {
+export type TasksUpdateResults = {
     /**
      * Successful Response
      */
-    200: TaskRunResponse;
+    200: TaskResponse;
 };
 
-export type TasksRunsCreateResult = TasksRunsCreateResults[keyof TasksRunsCreateResults];
+export type TasksUpdateResult = TasksUpdateResults[keyof TasksUpdateResults];
 
-export type TasksRunsGetData = {
+export type TasksPublishData = {
     body?: never;
     path: {
         /**
          * Task Id
          */
         task_id: string;
-        /**
-         * Run Id
-         */
-        run_id: string;
     };
     query?: never;
-    url: '/v1/tasks/{task_id}/runs/{run_id}';
+    url: '/v1/tasks/{task_id}/publish';
 };
 
-export type TasksRunsGetErrors = {
+export type TasksPublishErrors = {
+    /**
+     * Well-formed, but rejected by a rule; `detail.errors` lists each problem.
+     */
+    400: ErrorResponse;
     /**
      * Missing credential, or one that is revoked or no longer a member of this organization.
      */
     401: ErrorResponse;
+    /**
+     * Authenticated, but this organization role may not perform the operation.
+     */
+    403: ErrorResponse;
     /**
      * No such resource in this organization.
      */
     404: ErrorResponse;
+    /**
+     * The resource's current state forbids this — a name already taken, a job already running.
+     */
+    409: ErrorResponse;
     /**
      * The request did not match this operation's schema; `detail.errors` lists each field.
      */
@@ -19521,16 +20143,16 @@ export type TasksRunsGetErrors = {
     default: ErrorResponse;
 };
 
-export type TasksRunsGetError = TasksRunsGetErrors[keyof TasksRunsGetErrors];
+export type TasksPublishError = TasksPublishErrors[keyof TasksPublishErrors];
 
-export type TasksRunsGetResults = {
+export type TasksPublishResults = {
     /**
      * Successful Response
      */
-    200: TaskRunResponse;
+    200: PublishTaskResponse;
 };
 
-export type TasksRunsGetResult = TasksRunsGetResults[keyof TasksRunsGetResults];
+export type TasksPublishResult = TasksPublishResults[keyof TasksPublishResults];
 
 export type TasksValidateData = {
     body?: never;