@talqing/sdk 0.12.0 → 0.13.0

package/src/gen/types.gen.ts

@@ -195,7 +195,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;
     /**
@@ -210,6 +210,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
@@ -333,7 +339,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;
     /**
@@ -348,6 +354,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
@@ -1215,6 +1227,20 @@ export type BuiltinToolSpec = {
     type: string;
 };
 
+/**
+ * ButtonTap
+ */
+export type ButtonTap = {
+    /**
+     * Payload
+     */
+    payload?: string | null;
+    /**
+     * Text
+     */
+    text: string;
+};
+
 /**
  * CallBatchCounts
  */
@@ -1549,6 +1575,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
      */
@@ -1687,6 +1721,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
      */
@@ -1951,6 +1993,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
      */
@@ -2209,10 +2259,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
      */
@@ -2225,7 +2289,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
      */
@@ -2238,6 +2302,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
@@ -2250,6 +2324,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
      */
@@ -2272,10 +2352,6 @@ export type ConversationItemResponse = {
      * Session Id
      */
     session_id: string | null;
-    /**
-     * Source
-     */
-    source: string | null;
     /**
      * Text
      */
@@ -2312,32 +2388,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;
 };
 
 /**
@@ -2467,6 +2557,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
@@ -2984,7 +3082,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;
@@ -2996,7 +3094,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 = {
     /**
@@ -3027,6 +3126,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
      */
@@ -3036,7 +3143,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;
@@ -3795,9 +3902,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
      */
@@ -4450,9 +4564,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
      */
@@ -5219,6 +5339,16 @@ 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
  */
@@ -5280,6 +5410,25 @@ export type ImportedNumberResult = {
     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
  *
@@ -5296,6 +5445,36 @@ 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
  *
@@ -5788,6 +5967,22 @@ 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
  *
@@ -5806,10 +6001,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
      */
@@ -5822,7 +6031,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
      */
@@ -5839,6 +6048,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
@@ -5851,6 +6070,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
      */
@@ -5873,10 +6098,6 @@ export type ItemCreatedEvent = {
      * Session Id
      */
     session_id: string | null;
-    /**
-     * Source
-     */
-    source: string | null;
     /**
      * Text
      */
@@ -5910,13 +6131,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
      */
@@ -7222,12 +7443,20 @@ 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 = {
     /**
@@ -7258,6 +7487,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
      */
@@ -7271,7 +7508,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;
@@ -8626,6 +8863,78 @@ 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
  *
@@ -9446,30 +9755,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;
 };
 
 /**
@@ -9478,24 +9781,18 @@ 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;
 };
 
 /**
@@ -9503,7 +9800,7 @@ export type RecordingSpecOverride = {
  *
  * 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
@@ -9622,6 +9919,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;
 };
 
 /**
@@ -9744,12 +10049,20 @@ export type RunToolRequest = {
         [key: string]: unknown;
     };
     /**
-     * Timezone
+     * Secrets
      *
-     * The IANA timezone {{system_vars.now}}, {{system_vars.date}} and {{system_vars.time}} resolve against for this run. On a real call this comes from the agent.
+     * Session secrets for this run; override workspace secrets of the same name.
      */
-    timezone?: string;
-    /**
+    secrets?: {
+        [key: string]: string;
+    } | null;
+    /**
+     * Timezone
+     *
+     * The IANA timezone {{system_vars.now}}, {{system_vars.date}} and {{system_vars.time}} resolve against for this run. On a real call this comes from the agent.
+     */
+    timezone?: string;
+    /**
      * Userdata
      */
     userdata?: {
@@ -10351,6 +10664,18 @@ export type SessionUsage = {
     tts: Array<TTSUsage>;
 };
 
+/**
+ * SetInboundWebhookRequest
+ */
+export type SetInboundWebhookRequest = {
+    /**
+     * Url
+     *
+     * An https URL on your server.
+     */
+    url: string;
+};
+
 /**
  * SetProviderKeyRequest
  */
@@ -10647,6 +10972,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
      */
@@ -10659,10 +10990,6 @@ export type SystemVarResponse = {
      * Key
      */
     key: string;
-    /**
-     * Voice Only
-     */
-    voice_only: boolean;
 };
 
 /**
@@ -11965,6 +12292,84 @@ 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
  *
@@ -12003,7 +12408,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 = {
     /**
@@ -12038,6 +12444,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
      */
@@ -12047,7 +12461,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;
@@ -14162,6 +14576,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';
 };
@@ -15673,6 +16093,12 @@ export type ChatsListData = {
          * Status
          */
         status?: 'open' | 'ended' | 'all';
+        /**
+         * Metadata
+         *
+         * `key:value` pairs, all must match.
+         */
+        metadata?: Array<string>;
     };
     url: '/v1/chats';
 };
@@ -16273,6 +16699,55 @@ export type ConversationsListResults = {
 
 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 ConversationsGetData = {
     body?: never;
     path: {
@@ -18454,6 +18929,207 @@ export type FaqsEntriesUpdateResults = {
 
 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;