@talqing/sdk 0.12.0 → 0.13.1

package/dist/cjs/gen/types.gen.d.ts

@@ -182,7 +182,7 @@ export type AgentConfig = {
     /**
      * Greeting
      *
-     * The opening line, spoken on connect and on the way in from a handoff; empty or null makes the agent wait for the caller to speak first. Voice and video only. Supports the same substitutions as the prompt, plus `{{consent.notice}}`, the recording disclosure's place in the line.
+     * The opening line, spoken on connect and on the way in from a handoff; empty or null makes the agent wait for the caller to speak first. Voice and video only. Supports the same substitutions as the prompt, plus `{{recording.notice}}`, the recording notice's place in the line.
      */
     greeting?: string | null;
     /**
@@ -197,6 +197,12 @@ export type AgentConfig = {
      * Where this agent may hand the conversation next. Each entry becomes one tool the model can call, so routing quality lives in its `description`. A target is a stored agent (`agent_id`) or a member of the team defined on the call.
      */
     handoffs?: Array<HandoffTarget>;
+    /**
+     * Inbound Webhook
+     *
+     * Before an inbound call or channel chat starts, ask the workspace's inbound webhook for its vars, secrets, overrides, metadata and userdata. Refused if it does not answer.
+     */
+    inbound_webhook?: boolean;
     keypad_input?: KeypadInputSpec;
     /**
      * Language
@@ -318,7 +324,7 @@ export type AgentOverride = {
     /**
      * Greeting
      *
-     * The opening line, spoken on connect and on the way in from a handoff; empty or null makes the agent wait for the caller to speak first. Voice and video only. Supports the same substitutions as the prompt, plus `{{consent.notice}}`, the recording disclosure's place in the line.
+     * The opening line, spoken on connect and on the way in from a handoff; empty or null makes the agent wait for the caller to speak first. Voice and video only. Supports the same substitutions as the prompt, plus `{{recording.notice}}`, the recording notice's place in the line.
      */
     greeting?: string | null;
     /**
@@ -333,6 +339,12 @@ export type AgentOverride = {
      * Where this agent may hand the conversation next. Each entry becomes one tool the model can call, so routing quality lives in its `description`. A target is a stored agent (`agent_id`) or a member of the team defined on the call.
      */
     handoffs?: Array<HandoffTarget> | null;
+    /**
+     * Inbound Webhook
+     *
+     * Before an inbound call or channel chat starts, ask the workspace's inbound webhook for its vars, secrets, overrides, metadata and userdata. Refused if it does not answer.
+     */
+    inbound_webhook?: boolean | null;
     keypad_input?: KeypadInputSpecOverride | null;
     /**
      * Language
@@ -1169,6 +1181,19 @@ export type BuiltinToolSpec = {
      */
     type: string;
 };
+/**
+ * ButtonTap
+ */
+export type ButtonTap = {
+    /**
+     * Payload
+     */
+    payload?: string | null;
+    /**
+     * Text
+     */
+    text: string;
+};
 /**
  * CallBatchCounts
  */
@@ -1498,6 +1523,14 @@ export type CallSessionResponse = {
      * Livekit Room
      */
     livekit_room: string | null;
+    /**
+     * Metadata
+     *
+     * Your own labels for this session, set by your inbound webhook.
+     */
+    metadata: {
+        [key: string]: string;
+    };
     /**
      * Phone Number Id
      */
@@ -1634,6 +1667,14 @@ export type CallSummaryResponse = {
      * Message Count
      */
     message_count?: number;
+    /**
+     * Metadata
+     *
+     * Your own labels for this session, set by your inbound webhook.
+     */
+    metadata: {
+        [key: string]: string;
+    };
     /**
      * Outcome
      */
@@ -1891,6 +1932,14 @@ export type ChatResponse = {
      * Id
      */
     id: string;
+    /**
+     * Metadata
+     *
+     * Your own labels for this session, set by your inbound webhook.
+     */
+    metadata: {
+        [key: string]: string;
+    };
     /**
      * Started At
      */
@@ -2140,10 +2189,24 @@ export type ConversationItemResponse = {
      * Attachments
      */
     attachments: Array<ConversationAttachment>;
+    /**
+     * Who at your business posted this.
+     */
+    author: ItemAuthor | null;
+    /**
+     * Channel
+     *
+     * How this item reached us or the person; null for notes and instructions.
+     */
+    channel: 'phone_call' | 'whatsapp_call' | 'whatsapp_message' | 'web_call' | 'chat' | 'telegram' | 'stream' | 'copilot' | null;
     /**
      * Client Message Id
      */
     client_message_id: string | null;
+    /**
+     * What the person sent besides text; null for plain text.
+     */
+    content: InboundContent | null;
     /**
      * Conversation Id
      */
@@ -2156,7 +2219,7 @@ export type ConversationItemResponse = {
     /**
      * Delivery Status
      */
-    delivery_status: 'not_applicable' | 'pending' | 'sending' | 'sent' | 'failed' | 'skipped';
+    delivery_status: 'not_applicable' | 'pending' | 'held' | 'sending' | 'queued' | 'sent' | 'delivered' | 'read' | 'undelivered' | 'failed' | 'skipped' | 'expired';
     /**
      * Direction
      */
@@ -2169,6 +2232,16 @@ export type ConversationItemResponse = {
      * Id
      */
     id: string;
+    /**
+     * Idempotency Key
+     */
+    idempotency_key: string | null;
+    /**
+     * Images Not Kept
+     *
+     * Images the person sent that were not stored, and why.
+     */
+    images_not_kept: Array<ImageNotKept>;
     latency: ReplyLatency | null;
     /**
      * Metadata
@@ -2181,6 +2254,12 @@ export type ConversationItemResponse = {
      * Origin
      */
     origin: 'speech' | 'typed' | 'keypad' | null;
+    /**
+     * Post Type
+     *
+     * What was posted through the API; null for everything else.
+     */
+    post_type: 'template' | 'agent_text' | 'note' | 'instruction' | null;
     /**
      * Provider Message Id
      */
@@ -2203,10 +2282,6 @@ export type ConversationItemResponse = {
      * Session Id
      */
     session_id: string | null;
-    /**
-     * Source
-     */
-    source: string | null;
     /**
      * Text
      */
@@ -2242,32 +2317,46 @@ export type ConversationItemResponse = {
  * The contact this conversation belongs to: key, binding, and what we know.
  */
 export type ConversationRefSummary = {
-    /**
-     * Bind Id
-     */
-    bind_id?: string | null;
     /**
      * Contact Key
      */
-    contact_key?: string | null;
+    contact_key: string;
     /**
      * Display Name
      */
-    display_name?: string | null;
+    display_name: string | null;
     /**
      * Integration Id
      */
-    integration_id?: string | null;
+    integration_id: string | null;
     /**
      * Kind
      */
-    kind?: string | null;
+    kind: 'phone' | 'integration' | 'stream' | 'web';
     /**
      * Metadata
      */
-    metadata?: {
+    metadata: {
         [key: string]: unknown;
     };
+    /**
+     * Number
+     *
+     * Your number, on a phone contact.
+     */
+    number: string | null;
+    /**
+     * Peer
+     *
+     * Their number, on a phone contact.
+     */
+    peer: string | null;
+    /**
+     * Whatsapp Window Expires At
+     *
+     * When free-form WhatsApp messages stop being allowed; null if they never contacted you on WhatsApp.
+     */
+    whatsapp_window_expires_at: string | null;
 };
 /**
  * ConversationResponse
@@ -2395,6 +2484,14 @@ export type ConversationSessionResponse = {
      * Integration Id
      */
     integration_id: string | null;
+    /**
+     * Metadata
+     *
+     * Your own labels for this session, set by your inbound webhook.
+     */
+    metadata: {
+        [key: string]: string;
+    };
     metrics: SessionMetrics;
     /**
      * Started At
@@ -2896,7 +2993,7 @@ export type CreateCallBatchRequest = {
     /**
      * Vars
      *
-     * Values for the variables the agents on this session declare, read as {{vars.name}} in a prompt, a greeting and a tool. They override each agent's declared default and reach every agent the session runs, including a handoff target. Unlike `userdata`, which describes the PERSON and is kept on their contact record, these describe THIS session and are gone with it. Strings only; an empty string is a deliberate blank, not a request for the default. The model can see them, so put credentials in a workspace secret and read {{secrets.NAME}} from a tool instead.
+     * Values for the variables the agents on this session declare, read as {{vars.name}} in a prompt, a greeting and a tool. They override each agent's declared default and reach every agent the session runs, including a handoff target. Unlike `userdata`, which describes the PERSON and is kept on their contact record, these describe THIS session and are gone with it. Strings only; an empty string is a deliberate blank, not a request for the default. The model can see them, so credentials go in `secrets` (this session's own, where the request takes them) or a workspace secret, read as {{secrets.NAME}} by a tool.
      */
     vars?: {
         [key: string]: string;
@@ -2907,7 +3004,8 @@ export type CreateCallBatchRequest = {
  *
  * Who the chat is with, what it starts knowing, and what runs.
  *
- * `vars` comes from `AgentPlanRequest` and is fixed for the life of the chat.
+ * `vars` comes from `AgentPlanRequest` and `secrets` from `SessionSecretsField`;
+ * both are fixed for the life of the chat.
  */
 export type CreateChatRequest = {
     /**
@@ -2938,6 +3036,14 @@ export type CreateChatRequest = {
      * Contact Key
      */
     contact_key?: string | null;
+    /**
+     * Secrets
+     *
+     * Secrets for this session only, read by tools as {{secrets.NAME}}; a name here overrides the workspace secret. Never shown to the model or returned.
+     */
+    secrets?: {
+        [key: string]: string;
+    } | null;
     /**
      * Userdata
      */
@@ -2947,7 +3053,7 @@ export type CreateChatRequest = {
     /**
      * Vars
      *
-     * Values for the variables the agents on this session declare, read as {{vars.name}} in a prompt, a greeting and a tool. They override each agent's declared default and reach every agent the session runs, including a handoff target. Unlike `userdata`, which describes the PERSON and is kept on their contact record, these describe THIS session and are gone with it. Strings only; an empty string is a deliberate blank, not a request for the default. The model can see them, so put credentials in a workspace secret and read {{secrets.NAME}} from a tool instead.
+     * Values for the variables the agents on this session declare, read as {{vars.name}} in a prompt, a greeting and a tool. They override each agent's declared default and reach every agent the session runs, including a handoff target. Unlike `userdata`, which describes the PERSON and is kept on their contact record, these describe THIS session and are gone with it. Strings only; an empty string is a deliberate blank, not a request for the default. The model can see them, so credentials go in `secrets` (this session's own, where the request takes them) or a workspace secret, read as {{secrets.NAME}} by a tool.
      */
     vars?: {
         [key: string]: string;
@@ -3682,9 +3788,16 @@ export type DeleteTaskRunsResponse = {
  *
  * Outbound delivery failure detail (provider HTTP / shadow-mode skips).
  *
- * Writers always store `{"message": ...}` (see services.messaging.delivery).
+ * Writers always store `{"message": ...}`, plus the provider's `code` when it
+ * gave one (see services.messaging.delivery).
  */
 export type DeliveryError = {
+    /**
+     * Code
+     *
+     * The provider's error code, if any.
+     */
+    code: string | null;
     /**
      * Message
      */
@@ -4321,9 +4434,15 @@ export type EndpointingSpecOverride = {
  * of individual `errors` (used wherever we surface many problems at once,
  * including tool publish, op-tree checks, and request validation). The global
  * exception handlers normalize every API error to
- * `{detail: {message, errors}}`, so SDKs can parse one shape consistently.
+ * `{detail: {message, errors, code}}`, so SDKs can parse one shape consistently.
  */
 export type ErrorBody = {
+    /**
+     * Code
+     *
+     * A stable identifier for this error, when it has one.
+     */
+    code?: string | null;
     /**
      * Errors
      */
@@ -5061,6 +5180,15 @@ export type IfOperation = {
      */
     then?: Array<HttpOperation | CodeOperation | FrontendRpcOperation | IfOperation | SetVariableOperation | SayOperation | GenerateReplyOperation | AddMessageOperation | EndCallOperation | HandoffOperation | TransferOperation | SendDtmfOperation> | null;
 };
+/**
+ * ImageNotKept
+ */
+export type ImageNotKept = {
+    /**
+     * Reason
+     */
+    reason: string;
+};
 /**
  * ImportPhoneNumbersRequest
  */
@@ -5119,6 +5247,24 @@ export type ImportedNumberResult = {
     ok: boolean;
     phone_number?: PhoneNumberResponse | null;
 };
+/**
+ * InboundContent
+ *
+ * What the person sent besides text.
+ */
+export type InboundContent = {
+    button: ButtonTap;
+    /**
+     * Kind
+     */
+    kind: 'button';
+    /**
+     * Replied To
+     *
+     * Provider id of the message this answers, e.g. the template.
+     */
+    replied_to?: string | null;
+};
 /**
  * InboundImage
  *
@@ -5134,6 +5280,35 @@ export type InboundImage = {
      */
     filename?: string | null;
 };
+/**
+ * InboundWebhookResponse
+ *
+ * The workspace's inbound session webhook.
+ */
+export type InboundWebhookResponse = {
+    /**
+     * Created At
+     */
+    created_at: string;
+    /**
+     * Secret
+     *
+     * The signing secret, only when it was just created or rotated.
+     */
+    secret: string | null;
+    /**
+     * Secret Hint
+     */
+    secret_hint: string;
+    /**
+     * Updated At
+     */
+    updated_at: string;
+    /**
+     * Url
+     */
+    url: string;
+};
 /**
  * InlineFaq
  *
@@ -5612,6 +5787,21 @@ export type InterruptionSpecOverride = {
      */
     resume_false_interruption?: boolean | null;
 };
+/**
+ * ItemAuthor
+ *
+ * Who at your business posted an item.
+ */
+export type ItemAuthor = {
+    /**
+     * Id
+     */
+    id: string;
+    /**
+     * Name
+     */
+    name: string;
+};
 /**
  * ItemCreatedEvent
  *
@@ -5630,10 +5820,24 @@ export type ItemCreatedEvent = {
      * Attachments
      */
     attachments: Array<ConversationAttachment>;
+    /**
+     * Who at your business posted this.
+     */
+    author: ItemAuthor | null;
+    /**
+     * Channel
+     *
+     * How this item reached us or the person; null for notes and instructions.
+     */
+    channel: 'phone_call' | 'whatsapp_call' | 'whatsapp_message' | 'web_call' | 'chat' | 'telegram' | 'stream' | 'copilot' | null;
     /**
      * Client Message Id
      */
     client_message_id: string | null;
+    /**
+     * What the person sent besides text; null for plain text.
+     */
+    content: InboundContent | null;
     /**
      * Conversation Id
      */
@@ -5646,7 +5850,7 @@ export type ItemCreatedEvent = {
     /**
      * Delivery Status
      */
-    delivery_status: 'not_applicable' | 'pending' | 'sending' | 'sent' | 'failed' | 'skipped';
+    delivery_status: 'not_applicable' | 'pending' | 'held' | 'sending' | 'queued' | 'sent' | 'delivered' | 'read' | 'undelivered' | 'failed' | 'skipped' | 'expired';
     /**
      * Direction
      */
@@ -5663,6 +5867,16 @@ export type ItemCreatedEvent = {
      * Id
      */
     id: string;
+    /**
+     * Idempotency Key
+     */
+    idempotency_key: string | null;
+    /**
+     * Images Not Kept
+     *
+     * Images the person sent that were not stored, and why.
+     */
+    images_not_kept: Array<ImageNotKept>;
     latency: ReplyLatency | null;
     /**
      * Metadata
@@ -5675,6 +5889,12 @@ export type ItemCreatedEvent = {
      * Origin
      */
     origin: 'speech' | 'typed' | 'keypad' | null;
+    /**
+     * Post Type
+     *
+     * What was posted through the API; null for everything else.
+     */
+    post_type: 'template' | 'agent_text' | 'note' | 'instruction' | null;
     /**
      * Provider Message Id
      */
@@ -5697,10 +5917,6 @@ export type ItemCreatedEvent = {
      * Session Id
      */
     session_id: string | null;
-    /**
-     * Source
-     */
-    source: string | null;
     /**
      * Text
      */
@@ -5733,13 +5949,13 @@ export type ItemCreatedEvent = {
 /**
  * ItemDeliveryUpdatedEvent
  *
- * An outbound item reached the provider, or failed to.
+ * An outbound item's delivery moved: claimed, sent, held, a receipt, or a failure.
  */
 export type ItemDeliveryUpdatedEvent = {
     /**
      * Delivery Status
      */
-    delivery_status: 'not_applicable' | 'pending' | 'sending' | 'sent' | 'failed' | 'skipped';
+    delivery_status: 'not_applicable' | 'pending' | 'held' | 'sending' | 'queued' | 'sent' | 'delivered' | 'read' | 'undelivered' | 'failed' | 'skipped' | 'expired';
     /**
      * Error
      */
@@ -7002,12 +7218,19 @@ export type OkResponse = {
      */
     ok?: boolean;
 };
+/**
+ * OpenerPolicy
+ */
+export type OpenerPolicy = {
+    opener: TemplateSend;
+};
 /**
  * OutboundCallRequest
  *
  * One phone call: who to dial, from which of your numbers, and what runs.
  *
- * `vars` comes from `AgentPlanRequest` and lasts exactly as long as this call.
+ * `vars` comes from `AgentPlanRequest` and `secrets` from `SessionSecretsField`;
+ * both last exactly as long as this call.
  */
 export type OutboundCallRequest = {
     /**
@@ -7038,6 +7261,14 @@ export type OutboundCallRequest = {
      * From Phone Number Id
      */
     from_phone_number_id: string;
+    /**
+     * Secrets
+     *
+     * Secrets for this session only, read by tools as {{secrets.NAME}}; a name here overrides the workspace secret. Never shown to the model or returned.
+     */
+    secrets?: {
+        [key: string]: string;
+    } | null;
     /**
      * To
      */
@@ -7051,7 +7282,7 @@ export type OutboundCallRequest = {
     /**
      * Vars
      *
-     * Values for the variables the agents on this session declare, read as {{vars.name}} in a prompt, a greeting and a tool. They override each agent's declared default and reach every agent the session runs, including a handoff target. Unlike `userdata`, which describes the PERSON and is kept on their contact record, these describe THIS session and are gone with it. Strings only; an empty string is a deliberate blank, not a request for the default. The model can see them, so put credentials in a workspace secret and read {{secrets.NAME}} from a tool instead.
+     * Values for the variables the agents on this session declare, read as {{vars.name}} in a prompt, a greeting and a tool. They override each agent's declared default and reach every agent the session runs, including a handoff target. Unlike `userdata`, which describes the PERSON and is kept on their contact record, these describe THIS session and are gone with it. Strings only; an empty string is a deliberate blank, not a request for the default. The model can see them, so credentials go in `secrets` (this session's own, where the request takes them) or a workspace secret, read as {{secrets.NAME}} by a tool.
      */
     vars?: {
         [key: string]: string;
@@ -8354,6 +8585,76 @@ export type PlatformFeePerMinute = {
      */
     voice: number;
 };
+/**
+ * PostItemRequest
+ */
+export type PostItemRequest = {
+    /**
+     * Who at your business posted this; shown in transcripts, never sent to the person or shown to the agent.
+     */
+    author?: ItemAuthor | null;
+    /**
+     * Idempotency Key
+     */
+    idempotency_key?: string | null;
+    /**
+     * On Window Closed
+     *
+     * fail refuses free text outside WhatsApp's 24h window; an opener sends that template and holds the message until they reply.
+     */
+    on_window_closed?: 'fail' | OpenerPolicy;
+    /**
+     * For `template` only.
+     */
+    template?: TemplateSend | null;
+    /**
+     * Text
+     *
+     * For the other three types.
+     */
+    text?: string | null;
+    /**
+     * The conversation, or your number and theirs to reach a person with no conversation yet.
+     */
+    to: PostTarget;
+    /**
+     * Type
+     *
+     * template and agent_text are delivered; note is never delivered; instruct has the agent write and send a message.
+     */
+    type: 'template' | 'agent_text' | 'note' | 'instruct';
+    /**
+     * Userdata
+     *
+     * Merged into the person's userdata and given to the agent that answers their reply.
+     */
+    userdata?: {
+        [key: string]: unknown;
+    } | null;
+};
+/**
+ * PostTarget
+ *
+ * `conversation_id`, or `number` and `peer`.
+ */
+export type PostTarget = {
+    /**
+     * Conversation Id
+     */
+    conversation_id?: string | null;
+    /**
+     * Number
+     *
+     * Your business number, E.164.
+     */
+    number?: string | null;
+    /**
+     * Peer
+     *
+     * The person's number.
+     */
+    peer?: string | null;
+};
 /**
  * PreemptiveGenerationSpec
  *
@@ -9148,30 +9449,24 @@ export type RecordingResponse = {
 /**
  * RecordingSpec
  *
- * Whether calls with this agent are recorded, and what the caller is told.
+ * Whether calls with this agent are recorded, and whether the caller is told.
  *
  * On by default: one stereo file per call, kept until the workspace's
  * retention policy deletes it.
  */
 export type RecordingSpec = {
-    /**
-     * Consent
-     *
-     * Set to 'disclosure' to tell the caller the call is recorded. The greeting must then contain `{{consent.notice}}` to say where, and the agent gains a tool to stop recording if the caller objects.
-     */
-    consent?: 'off' | 'disclosure';
-    /**
-     * Consent Notice
-     *
-     * The sentence `{{consent.notice}}` resolves to in the greeting.
-     */
-    consent_notice?: string;
     /**
      * Enabled
      *
      * Record the call audio. Voice and video agents only.
      */
     enabled?: boolean;
+    /**
+     * Notice
+     *
+     * Spoken where the greeting places {{recording.notice}}, uninterruptibly. Null: no notice.
+     */
+    notice?: string | null;
 };
 /**
  * RecordingSpecOverride
@@ -9179,31 +9474,25 @@ export type RecordingSpec = {
  * A partial RecordingSpec: only the fields this call changes. Absent keeps the base value, an explicit null clears it, objects deep-merge and lists replace.
  */
 export type RecordingSpecOverride = {
-    /**
-     * Consent
-     *
-     * Set to 'disclosure' to tell the caller the call is recorded. The greeting must then contain `{{consent.notice}}` to say where, and the agent gains a tool to stop recording if the caller objects.
-     */
-    consent?: 'off' | 'disclosure' | null;
-    /**
-     * Consent Notice
-     *
-     * The sentence `{{consent.notice}}` resolves to in the greeting.
-     */
-    consent_notice?: string | null;
     /**
      * Enabled
      *
      * Record the call audio. Voice and video agents only.
      */
     enabled?: boolean | null;
+    /**
+     * Notice
+     *
+     * Spoken where the greeting places {{recording.notice}}, uninterruptibly. Null: no notice.
+     */
+    notice?: string | null;
 };
 /**
  * RecordingState
  *
  * What a reader should do about it. `available` is the only playable one.
  */
-export type RecordingState = 'none' | 'available' | 'pending' | 'expired' | 'failed' | 'not_shared' | 'consent_withdrawn' | 'deleted';
+export type RecordingState = 'none' | 'available' | 'pending' | 'expired' | 'failed' | 'not_shared' | 'deleted';
 /**
  * RedraftRequest
  *
@@ -9316,6 +9605,14 @@ export type ResumeCallRequest = {
      * Region
      */
     region?: 'us' | 'in';
+    /**
+     * Secrets
+     *
+     * Secrets to add or replace for the resumed call; the dropped call's are kept.
+     */
+    secrets?: {
+        [key: string]: string;
+    } | null;
 };
 /**
  * RoutedTTS
@@ -9432,6 +9729,14 @@ export type RunToolRequest = {
     arguments?: {
         [key: string]: unknown;
     };
+    /**
+     * Secrets
+     *
+     * Session secrets for this run; override workspace secrets of the same name.
+     */
+    secrets?: {
+        [key: string]: string;
+    } | null;
     /**
      * Timezone
      *
@@ -10016,13 +10321,24 @@ export type SessionUsage = {
     tts: Array<TTSUsage>;
 };
 /**
- * SetProviderKeyRequest
+ * SetInboundWebhookRequest
  */
-export type SetProviderKeyRequest = {
+export type SetInboundWebhookRequest = {
     /**
-     * Api Key
+     * Url
+     *
+     * An https URL on your server.
      */
-    api_key: string;
+    url: string;
+};
+/**
+ * SetProviderKeyRequest
+ */
+export type SetProviderKeyRequest = {
+    /**
+     * Api Key
+     */
+    api_key: string;
 };
 /**
  * SetVariableConfig
@@ -10299,6 +10615,12 @@ export type StreamResponse = {
  * One `{{system_vars.*}}` variable the platform fills in.
  */
 export type SystemVarResponse = {
+    /**
+     * Channels
+     *
+     * The session channels this has a value on; empty means every one.
+     */
+    channels: Array<'phone_call' | 'whatsapp_call' | 'whatsapp_message' | 'web_call' | 'chat' | 'telegram' | 'stream'>;
     /**
      * Description
      */
@@ -10311,10 +10633,6 @@ export type SystemVarResponse = {
      * Key
      */
     key: string;
-    /**
-     * Voice Only
-     */
-    voice_only: boolean;
 };
 /**
  * TTSCatalogEntryResponse
@@ -11587,6 +11905,81 @@ export type TelephonySetupStep = {
      */
     user_confirmable: boolean;
 };
+/**
+ * TemplateSend
+ */
+export type TemplateSend = {
+    /**
+     * Id
+     *
+     * Twilio Content SID (HX…) or Gupshup template id.
+     */
+    id: string;
+    /**
+     * Variables
+     *
+     * Every placeholder, button variables included.
+     */
+    variables?: {
+        [key: string]: string;
+    };
+};
+/**
+ * TestInboundWebhookRequest
+ */
+export type TestInboundWebhookRequest = {
+    /**
+     * Channel
+     */
+    channel: 'phone_call' | 'whatsapp_call' | 'whatsapp_message' | 'telegram';
+    /**
+     * Number
+     *
+     * Your number, as `to`.
+     */
+    number: string;
+    /**
+     * Peer
+     *
+     * Theirs, as `from`.
+     */
+    peer: string;
+};
+/**
+ * TestInboundWebhookResponse
+ *
+ * What your server answered to a sample `session.request`.
+ */
+export type TestInboundWebhookResponse = {
+    /**
+     * Duration Ms
+     */
+    duration_ms: number;
+    /**
+     * Errors
+     */
+    errors: Array<string>;
+    /**
+     * Response
+     *
+     * The JSON object your server returned.
+     */
+    response: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Status Code
+     *
+     * Null when no HTTP response arrived.
+     */
+    status_code: number | null;
+    /**
+     * Valid
+     *
+     * Whether a real session would have accepted this answer.
+     */
+    valid: boolean;
+};
 /**
  * TimeWindow
  *
@@ -11624,7 +12017,8 @@ export type TimeWindow = {
  *
  * One browser call: who is on it, what it starts knowing, and what runs.
  *
- * `vars` comes from `AgentPlanRequest` and lasts exactly as long as this call.
+ * `vars` comes from `AgentPlanRequest` and `secrets` from `SessionSecretsField`;
+ * both last exactly as long as this call.
  */
 export type TokenRequest = {
     /**
@@ -11659,6 +12053,14 @@ export type TokenRequest = {
      * Region
      */
     region?: 'us' | 'in';
+    /**
+     * Secrets
+     *
+     * Secrets for this session only, read by tools as {{secrets.NAME}}; a name here overrides the workspace secret. Never shown to the model or returned.
+     */
+    secrets?: {
+        [key: string]: string;
+    } | null;
     /**
      * Userdata
      */
@@ -11668,7 +12070,7 @@ export type TokenRequest = {
     /**
      * Vars
      *
-     * Values for the variables the agents on this session declare, read as {{vars.name}} in a prompt, a greeting and a tool. They override each agent's declared default and reach every agent the session runs, including a handoff target. Unlike `userdata`, which describes the PERSON and is kept on their contact record, these describe THIS session and are gone with it. Strings only; an empty string is a deliberate blank, not a request for the default. The model can see them, so put credentials in a workspace secret and read {{secrets.NAME}} from a tool instead.
+     * Values for the variables the agents on this session declare, read as {{vars.name}} in a prompt, a greeting and a tool. They override each agent's declared default and reach every agent the session runs, including a handoff target. Unlike `userdata`, which describes the PERSON and is kept on their contact record, these describe THIS session and are gone with it. Strings only; an empty string is a deliberate blank, not a request for the default. The model can see them, so credentials go in `secrets` (this session's own, where the request takes them) or a workspace secret, read as {{secrets.NAME}} by a tool.
      */
     vars?: {
         [key: string]: string;
@@ -13660,6 +14062,12 @@ export type CallsListData = {
          * only calls placed by this outbound batch, retries included
          */
         batch_id?: string | null;
+        /**
+         * Metadata
+         *
+         * `key:value` pairs, all must match.
+         */
+        metadata?: Array<string>;
     };
     url: '/v1/calls';
 };
@@ -15022,6 +15430,12 @@ export type ChatsListData = {
          * Status
          */
         status?: 'open' | 'ended' | 'all';
+        /**
+         * Metadata
+         *
+         * `key:value` pairs, all must match.
+         */
+        metadata?: Array<string>;
     };
     url: '/v1/chats';
 };
@@ -15563,6 +15977,98 @@ export type ConversationsListResults = {
     200: PageConversationResponse;
 };
 export type ConversationsListResult = ConversationsListResults[keyof ConversationsListResults];
+export type ConversationsItemsCreateData = {
+    body: PostItemRequest;
+    path?: never;
+    query?: never;
+    url: '/v1/conversations/items';
+};
+export type ConversationsItemsCreateErrors = {
+    /**
+     * 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 ConversationsItemsCreateError = ConversationsItemsCreateErrors[keyof ConversationsItemsCreateErrors];
+export type ConversationsItemsCreateResults = {
+    /**
+     * Idempotent replay.
+     */
+    200: ConversationItemResponse;
+    /**
+     * Successful Response
+     */
+    201: ConversationItemResponse;
+};
+export type ConversationsItemsCreateResult = ConversationsItemsCreateResults[keyof ConversationsItemsCreateResults];
+export type ConversationsDeleteData = {
+    body?: never;
+    path: {
+        /**
+         * Conversation Id
+         */
+        conversation_id: string;
+    };
+    query?: never;
+    url: '/v1/conversations/{conversation_id}';
+};
+export type ConversationsDeleteErrors = {
+    /**
+     * 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.
+     */
+    422: ErrorResponse;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+export type ConversationsDeleteError = ConversationsDeleteErrors[keyof ConversationsDeleteErrors];
+export type ConversationsDeleteResults = {
+    /**
+     * Erase scheduled. No body.
+     */
+    202: unknown;
+};
 export type ConversationsGetData = {
     body?: never;
     path: {
@@ -17534,6 +18040,182 @@ export type FaqsEntriesUpdateResults = {
     200: FaqEntry;
 };
 export type FaqsEntriesUpdateResult = FaqsEntriesUpdateResults[keyof FaqsEntriesUpdateResults];
+export type InboundWebhookDeleteData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/inbound-webhook';
+};
+export type InboundWebhookDeleteErrors = {
+    /**
+     * 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;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+export type InboundWebhookDeleteError = InboundWebhookDeleteErrors[keyof InboundWebhookDeleteErrors];
+export type InboundWebhookDeleteResults = {
+    /**
+     * Successful Response
+     */
+    200: OkResponse;
+};
+export type InboundWebhookDeleteResult = InboundWebhookDeleteResults[keyof InboundWebhookDeleteResults];
+export type InboundWebhookGetData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/inbound-webhook';
+};
+export type InboundWebhookGetErrors = {
+    /**
+     * Missing credential, or one that is revoked or no longer a member of this organization.
+     */
+    401: ErrorResponse;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+export type InboundWebhookGetError = InboundWebhookGetErrors[keyof InboundWebhookGetErrors];
+export type InboundWebhookGetResults = {
+    /**
+     * Successful Response
+     */
+    200: InboundWebhookResponse;
+};
+export type InboundWebhookGetResult = InboundWebhookGetResults[keyof InboundWebhookGetResults];
+export type InboundWebhookSetData = {
+    body: SetInboundWebhookRequest;
+    path?: never;
+    query?: never;
+    url: '/v1/inbound-webhook';
+};
+export type InboundWebhookSetErrors = {
+    /**
+     * 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 InboundWebhookSetError = InboundWebhookSetErrors[keyof InboundWebhookSetErrors];
+export type InboundWebhookSetResults = {
+    /**
+     * Successful Response
+     */
+    200: InboundWebhookResponse;
+};
+export type InboundWebhookSetResult = InboundWebhookSetResults[keyof InboundWebhookSetResults];
+export type InboundWebhookRotateSecretData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/v1/inbound-webhook/rotate-secret';
+};
+export type InboundWebhookRotateSecretErrors = {
+    /**
+     * 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;
+    /**
+     * Unexpected error. Every error this API returns carries this body.
+     */
+    default: ErrorResponse;
+};
+export type InboundWebhookRotateSecretError = InboundWebhookRotateSecretErrors[keyof InboundWebhookRotateSecretErrors];
+export type InboundWebhookRotateSecretResults = {
+    /**
+     * Successful Response
+     */
+    200: InboundWebhookResponse;
+};
+export type InboundWebhookRotateSecretResult = InboundWebhookRotateSecretResults[keyof InboundWebhookRotateSecretResults];
+export type InboundWebhookTestData = {
+    body: TestInboundWebhookRequest;
+    path?: never;
+    query?: never;
+    url: '/v1/inbound-webhook/test';
+};
+export type InboundWebhookTestErrors = {
+    /**
+     * 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 InboundWebhookTestError = InboundWebhookTestErrors[keyof InboundWebhookTestErrors];
+export type InboundWebhookTestResults = {
+    /**
+     * Successful Response
+     */
+    200: TestInboundWebhookResponse;
+};
+export type InboundWebhookTestResult = InboundWebhookTestResults[keyof InboundWebhookTestResults];
 export type IntegrationsListData = {
     body?: never;
     path?: never;