telnyx 7.20.0 → 7.22.0

package/resources/x402/index.js

@@ -2,8 +2,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.X402 = exports.CreditAccount = void 0;
-var credit_account_1 = require("./credit-account.js");
-Object.defineProperty(exports, "CreditAccount", { enumerable: true, get: function () { return credit_account_1.CreditAccount; } });
+var index_1 = require("./credit-account/index.js");
+Object.defineProperty(exports, "CreditAccount", { enumerable: true, get: function () { return index_1.CreditAccount; } });
 var x402_1 = require("./x402.js");
 Object.defineProperty(exports, "X402", { enumerable: true, get: function () { return x402_1.X402; } });
 //# sourceMappingURL=index.js.map

package/resources/x402/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/x402/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,sDAM0B;AALxB,+GAAA,aAAa,OAAA;AAMf,kCAA8B;AAArB,4FAAA,IAAI,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/x402/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,mDAMgC;AAL9B,sGAAA,aAAa,OAAA;AAMf,kCAA8B;AAArB,4FAAA,IAAI,OAAA"}

package/resources/x402/index.mjs

@@ -1,4 +1,4 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-export { CreditAccount, } from "./credit-account.mjs";
+export { CreditAccount, } from "./credit-account/index.mjs";
 export { X402 } from "./x402.mjs";
 //# sourceMappingURL=index.mjs.map

package/resources/x402/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/x402/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EACL,aAAa,GAKd,6BAAyB;AAC1B,OAAO,EAAE,IAAI,EAAE,mBAAe"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/x402/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EACL,aAAa,GAKd,mCAA+B;AAChC,OAAO,EAAE,IAAI,EAAE,mBAAe"}

package/resources/x402/x402.d.mts

@@ -1,6 +1,6 @@
 import { APIResource } from "../../core/resource.mjs";
-import * as CreditAccountAPI from "./credit-account.mjs";
-import { CreditAccount, CreditAccountCreateQuoteParams, CreditAccountCreateQuoteResponse, CreditAccountSettleParams, CreditAccountSettleResponse } from "./credit-account.mjs";
+import * as CreditAccountAPI from "./credit-account/credit-account.mjs";
+import { CreditAccount, CreditAccountCreateQuoteParams, CreditAccountCreateQuoteResponse, CreditAccountSettleParams, CreditAccountSettleResponse } from "./credit-account/credit-account.mjs";
 export declare class X402 extends APIResource {
     creditAccount: CreditAccountAPI.CreditAccount;
 }

package/resources/x402/x402.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"x402.d.mts","sourceRoot":"","sources":["../../src/resources/x402/x402.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,gBAAgB,6BAAyB;AACrD,OAAO,EACL,aAAa,EACb,8BAA8B,EAC9B,gCAAgC,EAChC,yBAAyB,EACzB,2BAA2B,EAC5B,6BAAyB;AAE1B,qBAAa,IAAK,SAAQ,WAAW;IACnC,aAAa,EAAE,gBAAgB,CAAC,aAAa,CAAoD;CAClG;AAID,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,OAAO,EACL,aAAa,IAAI,aAAa,EAC9B,KAAK,gCAAgC,IAAI,gCAAgC,EACzE,KAAK,2BAA2B,IAAI,2BAA2B,EAC/D,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,8BAA8B,IAAI,8BAA8B,GACtE,CAAC;CACH"}
+{"version":3,"file":"x402.d.mts","sourceRoot":"","sources":["../../src/resources/x402/x402.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,gBAAgB,4CAAwC;AACpE,OAAO,EACL,aAAa,EACb,8BAA8B,EAC9B,gCAAgC,EAChC,yBAAyB,EACzB,2BAA2B,EAC5B,4CAAwC;AAEzC,qBAAa,IAAK,SAAQ,WAAW;IACnC,aAAa,EAAE,gBAAgB,CAAC,aAAa,CAAoD;CAClG;AAID,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,OAAO,EACL,aAAa,IAAI,aAAa,EAC9B,KAAK,gCAAgC,IAAI,gCAAgC,EACzE,KAAK,2BAA2B,IAAI,2BAA2B,EAC/D,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,8BAA8B,IAAI,8BAA8B,GACtE,CAAC;CACH"}

package/resources/x402/x402.d.ts

@@ -1,6 +1,6 @@
 import { APIResource } from "../../core/resource.js";
-import * as CreditAccountAPI from "./credit-account.js";
-import { CreditAccount, CreditAccountCreateQuoteParams, CreditAccountCreateQuoteResponse, CreditAccountSettleParams, CreditAccountSettleResponse } from "./credit-account.js";
+import * as CreditAccountAPI from "./credit-account/credit-account.js";
+import { CreditAccount, CreditAccountCreateQuoteParams, CreditAccountCreateQuoteResponse, CreditAccountSettleParams, CreditAccountSettleResponse } from "./credit-account/credit-account.js";
 export declare class X402 extends APIResource {
     creditAccount: CreditAccountAPI.CreditAccount;
 }

package/resources/x402/x402.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"x402.d.ts","sourceRoot":"","sources":["../../src/resources/x402/x402.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,KAAK,gBAAgB,4BAAyB;AACrD,OAAO,EACL,aAAa,EACb,8BAA8B,EAC9B,gCAAgC,EAChC,yBAAyB,EACzB,2BAA2B,EAC5B,4BAAyB;AAE1B,qBAAa,IAAK,SAAQ,WAAW;IACnC,aAAa,EAAE,gBAAgB,CAAC,aAAa,CAAoD;CAClG;AAID,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,OAAO,EACL,aAAa,IAAI,aAAa,EAC9B,KAAK,gCAAgC,IAAI,gCAAgC,EACzE,KAAK,2BAA2B,IAAI,2BAA2B,EAC/D,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,8BAA8B,IAAI,8BAA8B,GACtE,CAAC;CACH"}
+{"version":3,"file":"x402.d.ts","sourceRoot":"","sources":["../../src/resources/x402/x402.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,KAAK,gBAAgB,2CAAwC;AACpE,OAAO,EACL,aAAa,EACb,8BAA8B,EAC9B,gCAAgC,EAChC,yBAAyB,EACzB,2BAA2B,EAC5B,2CAAwC;AAEzC,qBAAa,IAAK,SAAQ,WAAW;IACnC,aAAa,EAAE,gBAAgB,CAAC,aAAa,CAAoD;CAClG;AAID,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,OAAO,EACL,aAAa,IAAI,aAAa,EAC9B,KAAK,gCAAgC,IAAI,gCAAgC,EACzE,KAAK,2BAA2B,IAAI,2BAA2B,EAC/D,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,8BAA8B,IAAI,8BAA8B,GACtE,CAAC;CACH"}

package/resources/x402/x402.js

@@ -4,8 +4,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.X402 = void 0;
 const tslib_1 = require("../../internal/tslib.js");
 const resource_1 = require("../../core/resource.js");
-const CreditAccountAPI = tslib_1.__importStar(require("./credit-account.js"));
-const credit_account_1 = require("./credit-account.js");
+const CreditAccountAPI = tslib_1.__importStar(require("./credit-account/credit-account.js"));
+const credit_account_1 = require("./credit-account/credit-account.js");
 class X402 extends resource_1.APIResource {
     constructor() {
         super(...arguments);

package/resources/x402/x402.js.map

@@ -1 +1 @@
-{"version":3,"file":"x402.js","sourceRoot":"","sources":["../../src/resources/x402/x402.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,8EAAqD;AACrD,wDAM0B;AAE1B,MAAa,IAAK,SAAQ,sBAAW;IAArC;;QACE,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnG,CAAC;CAAA;AAFD,oBAEC;AAED,IAAI,CAAC,aAAa,GAAG,8BAAa,CAAC"}
+{"version":3,"file":"x402.js","sourceRoot":"","sources":["../../src/resources/x402/x402.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,6FAAoE;AACpE,uEAMyC;AAEzC,MAAa,IAAK,SAAQ,sBAAW;IAArC;;QACE,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnG,CAAC;CAAA;AAFD,oBAEC;AAED,IAAI,CAAC,aAAa,GAAG,8BAAa,CAAC"}

package/resources/x402/x402.mjs

@@ -1,7 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 import { APIResource } from "../../core/resource.mjs";
-import * as CreditAccountAPI from "./credit-account.mjs";
-import { CreditAccount, } from "./credit-account.mjs";
+import * as CreditAccountAPI from "./credit-account/credit-account.mjs";
+import { CreditAccount, } from "./credit-account/credit-account.mjs";
 export class X402 extends APIResource {
     constructor() {
         super(...arguments);

package/resources/x402/x402.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"x402.mjs","sourceRoot":"","sources":["../../src/resources/x402/x402.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,gBAAgB,6BAAyB;AACrD,OAAO,EACL,aAAa,GAKd,6BAAyB;AAE1B,MAAM,OAAO,IAAK,SAAQ,WAAW;IAArC;;QACE,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnG,CAAC;CAAA;AAED,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC"}
+{"version":3,"file":"x402.mjs","sourceRoot":"","sources":["../../src/resources/x402/x402.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,gBAAgB,4CAAwC;AACpE,OAAO,EACL,aAAa,GAKd,4CAAwC;AAEzC,MAAM,OAAO,IAAK,SAAQ,WAAW;IAArC;;QACE,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnG,CAAC;CAAA;AAED,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC"}

package/src/client.ts

@@ -1145,6 +1145,8 @@ import {
   UnsafeUnwrapWebhookEvent,
   UnwrapWebhookEvent,
   Webhooks,
+  WhatsappAccountUpdate,
+  WhatsappMessageEcho,
 } from './resources/webhooks';
 import {
   WellKnown,
@@ -1240,6 +1242,7 @@ import {
   StreamBidirectionalTargetLegs,
   StreamCodec,
 } from './resources/calls/calls';
+import { Compute } from './resources/compute/compute';
 import {
   Conference,
   ConferenceCreateParams,
@@ -1505,10 +1508,13 @@ import {
   MessagingHostedNumberOrders,
 } from './resources/messaging-hosted-number-orders/messaging-hosted-number-orders';
 import {
+  MessagingMessagingProfile,
+  MessagingMessagingProfilesDefaultFlatPagination,
   MessagingProfile,
   MessagingProfileCreateParams,
   MessagingProfileCreateResponse,
   MessagingProfileDeleteResponse,
+  MessagingProfileFeatures,
   MessagingProfileListAlphanumericSenderIDsParams,
   MessagingProfileListParams,
   MessagingProfileListPhoneNumbersParams,
@@ -1519,7 +1525,6 @@ import {
   MessagingProfileUpdateParams,
   MessagingProfileUpdateResponse,
   MessagingProfiles,
-  MessagingProfilesDefaultFlatPagination,
   NumberPoolSettings,
   URLShortenerSettings,
 } from './resources/messaging-profiles/messaging-profiles';
@@ -3240,6 +3245,7 @@ export class Telnyx {
   webSearch: API.WebSearch = new API.WebSearch(this);
   meetingSessions: API.MeetingSessions = new API.MeetingSessions(this);
   externalRequirements: API.ExternalRequirements = new API.ExternalRequirements(this);
+  compute: API.Compute = new API.Compute(this);
 }
 
 Telnyx.Legacy = Legacy;
@@ -3424,6 +3430,7 @@ Telnyx.Pricing = Pricing;
 Telnyx.WebSearch = WebSearch;
 Telnyx.MeetingSessions = MeetingSessions;
 Telnyx.ExternalRequirements = ExternalRequirements;
+Telnyx.Compute = Compute;
 
 export declare namespace Telnyx {
   export type RequestOptions = Opts.RequestOptions;
@@ -3604,6 +3611,8 @@ export declare namespace Telnyx {
     type OutboundMessage as OutboundMessage,
     type ReplacedLinkClick as ReplacedLinkClick,
     type Transcription as Transcription,
+    type WhatsappAccountUpdate as WhatsappAccountUpdate,
+    type WhatsappMessageEcho as WhatsappMessageEcho,
     type CallAIGatherEndedWebhookEvent as CallAIGatherEndedWebhookEvent,
     type CallAIGatherMessageHistoryUpdatedWebhookEvent as CallAIGatherMessageHistoryUpdatedWebhookEvent,
     type CallAIGatherPartialResultsWebhookEvent as CallAIGatherPartialResultsWebhookEvent,
@@ -4328,7 +4337,9 @@ export declare namespace Telnyx {
 
   export {
     MessagingProfiles as MessagingProfiles,
+    type MessagingMessagingProfile as MessagingMessagingProfile,
     type MessagingProfile as MessagingProfile,
+    type MessagingProfileFeatures as MessagingProfileFeatures,
     type NumberPoolSettings as NumberPoolSettings,
     type URLShortenerSettings as URLShortenerSettings,
     type MessagingProfileCreateResponse as MessagingProfileCreateResponse,
@@ -4336,7 +4347,7 @@ export declare namespace Telnyx {
     type MessagingProfileUpdateResponse as MessagingProfileUpdateResponse,
     type MessagingProfileDeleteResponse as MessagingProfileDeleteResponse,
     type MessagingProfileRetrieveMetricsResponse as MessagingProfileRetrieveMetricsResponse,
-    type MessagingProfilesDefaultFlatPagination as MessagingProfilesDefaultFlatPagination,
+    type MessagingMessagingProfilesDefaultFlatPagination as MessagingMessagingProfilesDefaultFlatPagination,
     type MessagingProfileListParams as MessagingProfileListParams,
     type MessagingProfileCreateParams as MessagingProfileCreateParams,
     type MessagingProfileUpdateParams as MessagingProfileUpdateParams,
@@ -5449,6 +5460,8 @@ export declare namespace Telnyx {
 
   export { ExternalRequirements as ExternalRequirements };
 
+  export { Compute as Compute };
+
   export type APIError = API.APIError;
   export type AvailablePhoneNumbersMetadata = API.AvailablePhoneNumbersMetadata;
   export type AzureVoiceSettings = API.AzureVoiceSettings;

package/src/resources/ai/ai.ts

@@ -45,6 +45,7 @@ import * as AssistantsAPI from './assistants/assistants';
 import {
   ArithmeticExpression,
   Assistant,
+  AssistantA2AAgent,
   AssistantChatParams,
   AssistantChatResponse,
   AssistantCloneParams,
@@ -648,6 +649,7 @@ export declare namespace AI {
     Assistants as Assistants,
     type ArithmeticExpression as ArithmeticExpression,
     type Assistant as Assistant,
+    type AssistantA2AAgent as AssistantA2AAgent,
     type AssistantIntegration as AssistantIntegration,
     type AssistantMcpServer as AssistantMcpServer,
     type AssistantTool as AssistantTool,

package/src/resources/ai/anthropic/v1.ts

@@ -92,6 +92,24 @@ export interface V1MessagesParams {
    */
   metadata?: { [key: string]: unknown };
 
+  /**
+   * How strictly `region` is applied. `preferred` (the default when `region` is set)
+   * tries that region first and falls back to another when the model cannot be
+   * served there, so a request that would have succeeded still succeeds. `strict`
+   * pins the request: it is served from that region or it fails with a 422, never
+   * redirected to another region. Requires `region`.
+   */
+  mode?: 'preferred' | 'strict';
+
+  /**
+   * Optional data-residency region the request should be served from, using the same
+   * vocabulary as your account's Data Locality setting. Behavior depends on `mode`.
+   * Supported for Telnyx-hosted models only: a request routed to an external
+   * provider never passes through Telnyx model routing, so a region cannot be
+   * enforced for it. Omit for today's latency-based routing.
+   */
+  region?: 'USA' | 'EU' | 'AUS' | 'UAE';
+
   /**
    * The service tier to use for this request. Supported values vary by model; use
    * the Telnyx models endpoint and inspect the model's `service_tiers` field. If

package/src/resources/ai/assistants/assistants.ts

@@ -372,6 +372,130 @@ export interface Assistant {
   >;
 }
 
+/**
+ * A remote agent, reachable over the A2A (Agent2Agent) protocol, that an assistant
+ * can delegate to. Tools are not configured here: at the start of every
+ * conversation the agent's card is fetched and one tool is derived per skill the
+ * card advertises.
+ */
+export interface AssistantA2AAgent {
+  /**
+   * Identifies the agent and seeds the names of the tools derived from its card
+   * (`a2a_<name>_<skill_id>`). Characters outside `[A-Za-z0-9_]` are replaced with
+   * `_` before the tool name is built, so two agents whose names differ only in
+   * punctuation collide and are rejected.
+   */
+  name: string;
+
+  /**
+   * The agent's base URL, or the URL of its agent card. At most 2,048 bytes once
+   * UTF-8 encoded. `/.well-known/agent-card.json` is appended to the path unless it
+   * already ends in `.json`. Must be an `http://` or `https://` URL for an
+   * externally reachable host: internal destinations (`localhost`, private and
+   * reserved IP ranges, `.local` domains) are rejected, and the hostname may not
+   * contain a `{{...}}` placeholder. Placeholders in the path are allowed.
+   */
+  url: string;
+
+  /**
+   * When `true`, the assistant hands the turn straight back to the model and the
+   * agent's answer is delivered into the conversation once it arrives, instead of
+   * the caller waiting for it in silence.
+   */
+  async?: boolean;
+
+  /**
+   * Headers sent when fetching this agent's card and on every call made to it. Use
+   * them to authenticate to the agent.
+   */
+  headers?: Array<AssistantA2AAgent.Header>;
+
+  /**
+   * Filler messages spoken while a call to this agent is in progress.
+   * `request_start` messages are spoken immediately when the call begins.
+   * `request_response_delayed` messages are spoken after `timing_ms` has elapsed
+   * only if the agent has not answered yet. Filler messages are not used when
+   * `async` is `true`.
+   */
+  messages?: Array<
+    AssistantA2AAgent.A2AAgentRequestStartMessage | AssistantA2AAgent.A2AAgentRequestResponseDelayedMessage
+  >;
+
+  /**
+   * How often, in milliseconds, to poll an agent task that has not finished yet.
+   * Defaults to 500.
+   */
+  poll_interval_ms?: number;
+
+  /**
+   * Total budget, in milliseconds, for one call to this agent, including any time
+   * spent polling a task that is still running. Omit to inherit the assistant's tool
+   * timeout.
+   */
+  timeout_ms?: number;
+}
+
+export namespace AssistantA2AAgent {
+  /**
+   * A header sent when fetching an A2A agent's card and on every call made to that
+   * agent.
+   */
+  export interface Header {
+    /**
+     * HTTP header name. May only contain alphanumeric characters, hyphens, and
+     * underscores, or a `{{dynamic_variable}}` placeholder surrounded by those
+     * characters.
+     */
+    name: string;
+
+    /**
+     * Header value, stored exactly as written. It may be a literal, a
+     * `{{dynamic_variable}}`, or an
+     * `{{#integration_secret}}identifier{{/integration_secret}}` section that resolves
+     * to a stored integration secret when the conversation starts. Control characters
+     * are not allowed. The encrypted `{{variable | encryption_secret_ref}}` form used
+     * for per-caller credentials is not resolved here and is rejected when the
+     * assistant is saved.
+     */
+    value: string;
+  }
+
+  export interface A2AAgentRequestStartMessage {
+    /**
+     * The text the assistant speaks.
+     */
+    content: string;
+
+    /**
+     * Speak the filler message immediately when the call to the agent begins.
+     */
+    type: 'request_start';
+
+    /**
+     * An optional delay value. This value is ignored for `request_start` messages.
+     */
+    timing_ms?: number;
+  }
+
+  export interface A2AAgentRequestResponseDelayedMessage {
+    /**
+     * The text the assistant speaks.
+     */
+    content: string;
+
+    /**
+     * How long to wait, in milliseconds, before speaking this message.
+     */
+    timing_ms: number;
+
+    /**
+     * Speak the filler message only if the agent has not answered yet after
+     * `timing_ms`.
+     */
+    type: 'request_response_delayed';
+  }
+}
+
 /**
  * Reference to a connected integration attached to an assistant. Discover
  * available integrations with `/ai/integrations` and connected integrations with
@@ -1715,6 +1839,18 @@ export interface InferenceEmbedding {
 
   name: string;
 
+  /**
+   * A2A agents this assistant can delegate to. Tools are not stored here: at the
+   * start of every conversation each agent's card is fetched and one tool is derived
+   * per skill the card advertises, named `a2a_<name>_<skill_id>`. The following
+   * limits are not enforced when the assistant is saved, and anything past them is
+   * dropped when the conversation starts: 64 agents per assistant, 64 skills per
+   * card, 128 derived tools per assistant, and a 6 second budget for all card
+   * fetches combined. An agent whose card cannot be fetched costs the assistant that
+   * capability for the conversation; it does not fail the call.
+   */
+  a2a_agents?: Array<AssistantA2AAgent>;
+
   /**
    * Conversation flow as returned by the API.
    */
@@ -2415,6 +2551,17 @@ export interface TelephonySettings {
    */
   disable_dtmf?: boolean;
 
+  /**
+   * Destination number or SIP URI to transfer the caller to when the AI conversation
+   * ends abnormally, for example because of an assistant-side error, so the caller
+   * is not left in dead air. This only fires for abnormal ends: it does not fire
+   * when the conversation ends on purpose (the caller hung up, the assistant
+   * completed normally, the caller hung up after a relay handoff, or voicemail was
+   * detected), and it does not fire when the assistant already transferred or
+   * bridged the call.
+   */
+  fallback_destination?: string;
+
   /**
    * The noise suppression engine to use. Use 'disabled' to turn off noise
    * suppression.
@@ -3312,6 +3459,18 @@ export interface AssistantCreateParams {
    */
   name: string;
 
+  /**
+   * Body param: A2A agents this assistant can delegate to. Tools are not stored
+   * here: at the start of every conversation each agent's card is fetched and one
+   * tool is derived per skill the card advertises, named `a2a_<name>_<skill_id>`.
+   * The following limits are not enforced when the assistant is saved, and anything
+   * past them is dropped when the conversation starts: 64 agents per assistant, 64
+   * skills per card, 128 derived tools per assistant, and a 6 second budget for all
+   * card fetches combined. An agent whose card cannot be fetched costs the assistant
+   * that capability for the conversation; it does not fail the call.
+   */
+  a2a_agents?: Array<AssistantA2AAgent>;
+
   /**
    * Body param: Conversation flow as supplied by API clients (create / update).
    *
@@ -3557,6 +3716,19 @@ export interface AssistantRetrieveParams {
 }
 
 export interface AssistantUpdateParams {
+  /**
+   * A2A agents this assistant can delegate to. Tools are not stored here: at the
+   * start of every conversation each agent's card is fetched and one tool is derived
+   * per skill the card advertises, named `a2a_<name>_<skill_id>`. The following
+   * limits are not enforced when the assistant is saved, and anything past them is
+   * dropped when the conversation starts: 64 agents per assistant, 64 skills per
+   * card, 128 derived tools per assistant, and a 6 second budget for all card
+   * fetches combined. An agent whose card cannot be fetched costs the assistant that
+   * capability for the conversation; it does not fail the call. Omit this field to
+   * leave the assistant's agents unchanged; send an empty array to remove them all.
+   */
+  a2a_agents?: Array<AssistantA2AAgent>;
+
   /**
    * Conversation flow as supplied by API clients (create / update).
    *
@@ -3811,6 +3983,7 @@ export declare namespace Assistants {
   export {
     type ArithmeticExpression as ArithmeticExpression,
     type Assistant as Assistant,
+    type AssistantA2AAgent as AssistantA2AAgent,
     type AssistantIntegration as AssistantIntegration,
     type AssistantMcpServer as AssistantMcpServer,
     type AssistantTool as AssistantTool,

package/src/resources/ai/assistants/index.ts

@@ -4,6 +4,7 @@ export {
   Assistants,
   type ArithmeticExpression,
   type Assistant,
+  type AssistantA2AAgent,
   type AssistantIntegration,
   type AssistantMcpServer,
   type AssistantTool,

package/src/resources/ai/assistants/versions.ts

@@ -117,6 +117,19 @@ export class Versions extends APIResource {
 }
 
 export interface UpdateAssistant {
+  /**
+   * A2A agents this assistant can delegate to. Tools are not stored here: at the
+   * start of every conversation each agent's card is fetched and one tool is derived
+   * per skill the card advertises, named `a2a_<name>_<skill_id>`. The following
+   * limits are not enforced when the assistant is saved, and anything past them is
+   * dropped when the conversation starts: 64 agents per assistant, 64 skills per
+   * card, 128 derived tools per assistant, and a 6 second budget for all card
+   * fetches combined. An agent whose card cannot be fetched costs the assistant that
+   * capability for the conversation; it does not fail the call. Omit this field to
+   * leave the assistant's agents unchanged; send an empty array to remove them all.
+   */
+  a2a_agents?: Array<AssistantsAPI.AssistantA2AAgent>;
+
   /**
    * Conversation flow as supplied by API clients (create / update).
    *
@@ -299,6 +312,20 @@ export interface VersionUpdateParams {
    */
   assistant_id: string;
 
+  /**
+   * Body param: A2A agents this assistant can delegate to. Tools are not stored
+   * here: at the start of every conversation each agent's card is fetched and one
+   * tool is derived per skill the card advertises, named `a2a_<name>_<skill_id>`.
+   * The following limits are not enforced when the assistant is saved, and anything
+   * past them is dropped when the conversation starts: 64 agents per assistant, 64
+   * skills per card, 128 derived tools per assistant, and a 6 second budget for all
+   * card fetches combined. An agent whose card cannot be fetched costs the assistant
+   * that capability for the conversation; it does not fail the call. Omit this field
+   * to leave the assistant's agents unchanged; send an empty array to remove them
+   * all.
+   */
+  a2a_agents?: Array<AssistantsAPI.AssistantA2AAgent>;
+
   /**
    * Body param: Conversation flow as supplied by API clients (create / update).
    *

package/src/resources/ai/chat.ts

@@ -58,22 +58,6 @@ export interface ChatCompletionRequest {
    */
   frequency_penalty?: number;
 
-  /**
-   * If specified, the output will be exactly one of the choices.
-   */
-  guided_choice?: Array<string>;
-
-  /**
-   * Must be a valid JSON schema. If specified, the output will follow the JSON
-   * schema.
-   */
-  guided_json?: { [key: string]: unknown };
-
-  /**
-   * If specified, the output will follow the regex pattern.
-   */
-  guided_regex?: string;
-
   /**
    * This is used with `use_beam_search` to prefer shorter or longer completions.
    */
@@ -98,6 +82,15 @@ export interface ChatCompletionRequest {
    */
   min_p?: number;
 
+  /**
+   * How strictly `region` is applied. `preferred` (the default when `region` is set)
+   * tries that region first and falls back to another when the model cannot be
+   * served there, so a request that would have succeeded still succeeds. `strict`
+   * pins the request: it is served from that region or it fails with a 422, never
+   * redirected to another region. Requires `region`.
+   */
+  mode?: 'preferred' | 'strict';
+
   /**
    * The language model to chat with.
    */
@@ -123,10 +116,24 @@ export interface ChatCompletionRequest {
   reasoning_effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
 
   /**
-   * Use this is you want to guarantee a JSON output without defining a schema. For
-   * control over the schema, use `guided_json`.
+   * Optional data-residency region the request should be served from, using the same
+   * vocabulary as your account's Data Locality setting. Behavior depends on `mode`.
+   * Supported for Telnyx-hosted models only: a request routed to an external
+   * provider never passes through Telnyx model routing, so a region cannot be
+   * enforced for it. Omit for today's latency-based routing.
+   */
+  region?: 'USA' | 'EU' | 'AUS' | 'UAE';
+
+  /**
+   * Controls the format of the model output. `json_object` guarantees valid JSON
+   * output without defining a schema; `json_schema` constrains the output to the
+   * JSON schema you supply via the `json_schema` property and is the supported way
+   * to get guaranteed structured output on Telnyx-hosted models.
    */
-  response_format?: ChatCompletionRequest.ResponseFormat;
+  response_format?:
+    | ChatCompletionRequest.ResponseFormatText
+    | ChatCompletionRequest.ResponseFormatJsonObject
+    | ChatCompletionRequest.ResponseFormatJsonSchemaParam;
 
   /**
    * If specified, the system will make a best effort to sample deterministically,
@@ -210,11 +217,68 @@ export namespace ChatCompletionRequest {
   }
 
   /**
-   * Use this is you want to guarantee a JSON output without defining a schema. For
-   * control over the schema, use `guided_json`.
+   * Plain text output.
    */
-  export interface ResponseFormat {
-    type: 'text' | 'json_object';
+  export interface ResponseFormatText {
+    type: 'text';
+  }
+
+  /**
+   * JSON mode: the model output is valid JSON, without a schema.
+   */
+  export interface ResponseFormatJsonObject {
+    type: 'json_object';
+  }
+
+  /**
+   * Structured output: the model output is constrained to the JSON schema supplied
+   * in `json_schema`.
+   */
+  export interface ResponseFormatJsonSchemaParam {
+    /**
+     * The JSON schema configuration, required when `type` is `json_schema`. Matches
+     * the
+     * [OpenAI structured outputs](https://platform.openai.com/docs/guides/structured-outputs)
+     * `json_schema` response format.
+     */
+    json_schema: ResponseFormatJsonSchemaParam.JsonSchema;
+
+    type: 'json_schema';
+  }
+
+  export namespace ResponseFormatJsonSchemaParam {
+    /**
+     * The JSON schema configuration, required when `type` is `json_schema`. Matches
+     * the
+     * [OpenAI structured outputs](https://platform.openai.com/docs/guides/structured-outputs)
+     * `json_schema` response format.
+     */
+    export interface JsonSchema {
+      /**
+       * The name of the response format. Used for clarity only.
+       */
+      name: string;
+
+      /**
+       * A description of what the response format is for, typically used to guide the
+       * model.
+       */
+      description?: string;
+
+      /**
+       * The JSON schema the model output must conform to. A valid
+       * [JSON Schema](https://json-schema.org) object, e.g. a Pydantic
+       * `model_json_schema()` export.
+       */
+      schema?: { [key: string]: unknown };
+
+      /**
+       * Enables strict schema adherence when supported by the model. If the generated
+       * output does not match the provided schema, the request fails instead of
+       * returning non-conformant output.
+       */
+      strict?: boolean;
+    }
   }
 
   export interface Function {

package/src/resources/ai/index.ts

@@ -15,6 +15,7 @@ export {
   Assistants,
   type ArithmeticExpression,
   type Assistant,
+  type AssistantA2AAgent,
   type AssistantIntegration,
   type AssistantMcpServer,
   type AssistantTool,