telnyx 6.53.0 → 6.55.0

package/src/resources/ai/assistants/canary-deploys.ts

@@ -99,7 +99,77 @@ export class CanaryDeploys extends APIResource {
  * - `rules` — canonical ordered list of routing rules
  */
 export interface CanaryDeploy {
-  rules?: Array<RuleInput>;
+  rules?: Array<CanaryDeploy.Rule>;
+}
+
+export namespace CanaryDeploy {
+  /**
+   * A targeting rule: `match` clauses (AND) gate `serve`.
+   *
+   * An empty `match` is a catch-all (always fires).
+   */
+  export interface Rule {
+    /**
+     * What a rule serves when matched.
+     *
+     * Exactly one of:
+     *
+     * - `version_id` — serve a specific version
+     * - `rollout` — weighted random across versions; weights must sum to less than
+     *   100, with the leftover routing to the main version
+     */
+    serve: Rule.Serve;
+
+    match?: Array<Rule.Match>;
+  }
+
+  export namespace Rule {
+    /**
+     * What a rule serves when matched.
+     *
+     * Exactly one of:
+     *
+     * - `version_id` — serve a specific version
+     * - `rollout` — weighted random across versions; weights must sum to less than
+     *   100, with the leftover routing to the main version
+     */
+    export interface Serve {
+      rollout?: Array<Serve.Rollout>;
+
+      version_id?: string;
+    }
+
+    export namespace Serve {
+      /**
+       * One slot in a percentage rollout.
+       */
+      export interface Rollout {
+        version_id: string;
+
+        weight: number;
+      }
+    }
+
+    /**
+     * A single attribute/operator/values check.
+     *
+     * A clause matches when the routing context's value for `attribute` satisfies
+     * `operator` against any of `values`.
+     */
+    export interface Match {
+      /**
+       * Attribute name from the routing context
+       */
+      attribute: string;
+
+      /**
+       * Match operator
+       */
+      operator: 'in' | 'not_in' | 'starts_with';
+
+      values: Array<string>;
+    }
+  }
 }
 
 /**
@@ -112,112 +182,233 @@ export interface CanaryDeployResponse {
 
   created_at: string;
 
-  rules: Array<RuleOutput>;
+  rules: Array<CanaryDeployResponse.Rule>;
 
   updated_at: string;
 }
 
-/**
- * A single attribute/operator/values check.
- *
- * A clause matches when the routing context's value for `attribute` satisfies
- * `operator` against any of `values`.
- */
-export interface Clause {
+export namespace CanaryDeployResponse {
   /**
-   * Attribute name from the routing context
+   * A targeting rule: `match` clauses (AND) gate `serve`.
+   *
+   * An empty `match` is a catch-all (always fires).
    */
-  attribute: string;
+  export interface Rule {
+    /**
+     * What a rule serves when matched.
+     *
+     * Exactly one of:
+     *
+     * - `version_id` — serve a specific version
+     * - `rollout` — weighted random across versions; weights must sum to less than
+     *   100, with the leftover routing to the main version
+     */
+    serve: Rule.Serve;
 
-  /**
-   * Match operator
-   */
-  operator: 'in' | 'not_in' | 'starts_with';
+    match?: Array<Rule.Match>;
+  }
 
-  values: Array<string>;
-}
+  export namespace Rule {
+    /**
+     * What a rule serves when matched.
+     *
+     * Exactly one of:
+     *
+     * - `version_id` — serve a specific version
+     * - `rollout` — weighted random across versions; weights must sum to less than
+     *   100, with the leftover routing to the main version
+     */
+    export interface Serve {
+      rollout?: Array<Serve.Rollout>;
 
-/**
- * One slot in a percentage rollout.
- */
-export interface RolloutSlot {
-  version_id: string;
+      version_id?: string;
+    }
+
+    export namespace Serve {
+      /**
+       * One slot in a percentage rollout.
+       */
+      export interface Rollout {
+        version_id: string;
 
-  weight: number;
+        weight: number;
+      }
+    }
+
+    /**
+     * A single attribute/operator/values check.
+     *
+     * A clause matches when the routing context's value for `attribute` satisfies
+     * `operator` against any of `values`.
+     */
+    export interface Match {
+      /**
+       * Attribute name from the routing context
+       */
+      attribute: string;
+
+      /**
+       * Match operator
+       */
+      operator: 'in' | 'not_in' | 'starts_with';
+
+      values: Array<string>;
+    }
+  }
 }
 
-/**
- * A targeting rule: `match` clauses (AND) gate `serve`.
- *
- * An empty `match` is a catch-all (always fires).
- */
-export interface RuleInput {
+export interface CanaryDeployCreateParams {
+  rules?: Array<CanaryDeployCreateParams.Rule>;
+}
+
+export namespace CanaryDeployCreateParams {
   /**
-   * What a rule serves when matched.
-   *
-   * Exactly one of:
+   * A targeting rule: `match` clauses (AND) gate `serve`.
    *
-   * - `version_id` — serve a specific version
-   * - `rollout` — weighted random across versions; weights must sum to less than
-   *   100, with the leftover routing to the main version
+   * An empty `match` is a catch-all (always fires).
    */
-  serve: Serve;
+  export interface Rule {
+    /**
+     * What a rule serves when matched.
+     *
+     * Exactly one of:
+     *
+     * - `version_id` — serve a specific version
+     * - `rollout` — weighted random across versions; weights must sum to less than
+     *   100, with the leftover routing to the main version
+     */
+    serve: Rule.Serve;
+
+    match?: Array<Rule.Match>;
+  }
+
+  export namespace Rule {
+    /**
+     * What a rule serves when matched.
+     *
+     * Exactly one of:
+     *
+     * - `version_id` — serve a specific version
+     * - `rollout` — weighted random across versions; weights must sum to less than
+     *   100, with the leftover routing to the main version
+     */
+    export interface Serve {
+      rollout?: Array<Serve.Rollout>;
+
+      version_id?: string;
+    }
+
+    export namespace Serve {
+      /**
+       * One slot in a percentage rollout.
+       */
+      export interface Rollout {
+        version_id: string;
+
+        weight: number;
+      }
+    }
 
-  match?: Array<Clause>;
+    /**
+     * A single attribute/operator/values check.
+     *
+     * A clause matches when the routing context's value for `attribute` satisfies
+     * `operator` against any of `values`.
+     */
+    export interface Match {
+      /**
+       * Attribute name from the routing context
+       */
+      attribute: string;
+
+      /**
+       * Match operator
+       */
+      operator: 'in' | 'not_in' | 'starts_with';
+
+      values: Array<string>;
+    }
+  }
 }
 
-/**
- * A targeting rule: `match` clauses (AND) gate `serve`.
- *
- * An empty `match` is a catch-all (always fires).
- */
-export interface RuleOutput {
+export interface CanaryDeployUpdateParams {
+  rules?: Array<CanaryDeployUpdateParams.Rule>;
+}
+
+export namespace CanaryDeployUpdateParams {
   /**
-   * What a rule serves when matched.
-   *
-   * Exactly one of:
+   * A targeting rule: `match` clauses (AND) gate `serve`.
    *
-   * - `version_id` — serve a specific version
-   * - `rollout` — weighted random across versions; weights must sum to less than
-   *   100, with the leftover routing to the main version
+   * An empty `match` is a catch-all (always fires).
    */
-  serve: Serve;
+  export interface Rule {
+    /**
+     * What a rule serves when matched.
+     *
+     * Exactly one of:
+     *
+     * - `version_id` — serve a specific version
+     * - `rollout` — weighted random across versions; weights must sum to less than
+     *   100, with the leftover routing to the main version
+     */
+    serve: Rule.Serve;
 
-  match?: Array<Clause>;
-}
+    match?: Array<Rule.Match>;
+  }
 
-/**
- * What a rule serves when matched.
- *
- * Exactly one of:
- *
- * - `version_id` — serve a specific version
- * - `rollout` — weighted random across versions; weights must sum to less than
- *   100, with the leftover routing to the main version
- */
-export interface Serve {
-  rollout?: Array<RolloutSlot>;
+  export namespace Rule {
+    /**
+     * What a rule serves when matched.
+     *
+     * Exactly one of:
+     *
+     * - `version_id` — serve a specific version
+     * - `rollout` — weighted random across versions; weights must sum to less than
+     *   100, with the leftover routing to the main version
+     */
+    export interface Serve {
+      rollout?: Array<Serve.Rollout>;
 
-  version_id?: string;
-}
+      version_id?: string;
+    }
 
-export interface CanaryDeployCreateParams {
-  rules?: Array<RuleInput>;
-}
+    export namespace Serve {
+      /**
+       * One slot in a percentage rollout.
+       */
+      export interface Rollout {
+        version_id: string;
 
-export interface CanaryDeployUpdateParams {
-  rules?: Array<RuleInput>;
+        weight: number;
+      }
+    }
+
+    /**
+     * A single attribute/operator/values check.
+     *
+     * A clause matches when the routing context's value for `attribute` satisfies
+     * `operator` against any of `values`.
+     */
+    export interface Match {
+      /**
+       * Attribute name from the routing context
+       */
+      attribute: string;
+
+      /**
+       * Match operator
+       */
+      operator: 'in' | 'not_in' | 'starts_with';
+
+      values: Array<string>;
+    }
+  }
 }
 
 export declare namespace CanaryDeploys {
   export {
     type CanaryDeploy as CanaryDeploy,
     type CanaryDeployResponse as CanaryDeployResponse,
-    type Clause as Clause,
-    type RolloutSlot as RolloutSlot,
-    type RuleInput as RuleInput,
-    type RuleOutput as RuleOutput,
-    type Serve as Serve,
     type CanaryDeployCreateParams as CanaryDeployCreateParams,
     type CanaryDeployUpdateParams as CanaryDeployUpdateParams,
   };

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

@@ -3,8 +3,6 @@
 export {
   Assistants,
   type Assistant,
-  type AssistantIntegration,
-  type AssistantMcpServer,
   type AssistantTool,
   type AssistantsList,
   type AudioVisualizerConfig,
@@ -17,7 +15,6 @@ export {
   type HangupToolParams,
   type ImportMetadata,
   type InferenceEmbedding,
-  type InferenceEmbeddingInterruptionSettings,
   type InferenceEmbeddingWebhookToolParams,
   type InsightSettings,
   type MessagingSettings,
@@ -27,9 +24,7 @@ export {
   type PostConversationSettingsReq,
   type PrivacySettings,
   type RetrievalTool,
-  type StartSpeakingPlan,
   type TelephonySettings,
-  type TranscriptionEndpointingPlan,
   type TranscriptionSettings,
   type TranscriptionSettingsConfig,
   type TransferTool,
@@ -51,11 +46,6 @@ export {
   CanaryDeploys,
   type CanaryDeploy,
   type CanaryDeployResponse,
-  type Clause,
-  type RolloutSlot,
-  type RuleInput,
-  type RuleOutput,
-  type Serve,
   type CanaryDeployCreateParams,
   type CanaryDeployUpdateParams,
 } from './canary-deploys';

package/src/resources/ai/assistants/scheduled-events.ts

@@ -131,12 +131,29 @@ export interface ScheduledPhoneCallEventResponse {
 
   telnyx_end_user_target: string;
 
+  call_attempts?: Array<ScheduledPhoneCallEventResponse.CallAttempt>;
+
+  /**
+   * Duration of the call in seconds
+   */
+  call_duration?: number;
+
+  /**
+   * Values: busy, canceled, no-answer, ringing, completed, failed, in-progress
+   */
+  call_status?: string;
+
   conversation_id?: string;
 
   conversation_metadata?: { [key: string]: string | number | boolean };
 
   created_at?: string;
 
+  /**
+   * Date time at which call was sent
+   */
+  dispatched_at?: string;
+
   /**
    * A map of dynamic variable names to values. These variables can be referenced in
    * the assistant's instructions and messages using {{variable_name}} syntax.
@@ -145,15 +162,46 @@ export interface ScheduledPhoneCallEventResponse {
 
   errors?: Array<string>;
 
+  /**
+   * Configure number of retries on client errors: busy, no-answer, failed, canceled
+   * (caller hung up before the callee answered)
+   */
+  max_retries_client_errors?: number;
+
   retry_attempts?: number;
 
   retry_count?: number;
 
+  retry_interval_secs?: number;
+
   scheduled_event_id?: string;
 
   status?: EventStatus;
 }
 
+export namespace ScheduledPhoneCallEventResponse {
+  /**
+   * One row in `call_attempts` — captures the terminal outcome of a single dispatch.
+   */
+  export interface CallAttempt {
+    attempt_number: number;
+
+    attempted_at: string;
+
+    /**
+     * Values: busy, canceled, no-answer, ringing, completed, failed, in-progress
+     */
+    call_status: string;
+
+    /**
+     * Duration of the call in seconds
+     */
+    call_duration?: number;
+
+    telnyx_call_control_id?: string;
+  }
+}
+
 export interface ScheduledSMSEventResponse {
   assistant_id: string;
 
@@ -220,6 +268,14 @@ export interface ScheduledEventCreateParams {
    */
   dynamic_variables?: { [key: string]: string };
 
+  /**
+   * Configure number of retries on client errors: busy, no-answer, failed, canceled
+   * (caller hung up before the callee answered)
+   */
+  max_retries_client_errors?: number;
+
+  retry_interval_secs?: number;
+
   /**
    * Required for sms scheduled events. The text to be sent to the end user.
    */