telnyx 6.48.0 → 6.49.0

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

@@ -21,11 +21,6 @@ export class CanaryDeploys extends APIResource {
    * const canaryDeployResponse =
    *   await client.ai.assistants.canaryDeploys.create(
    *     'assistant_id',
-   *     {
-   *       versions: [
-   *         { percentage: 1, version_id: 'version_id' },
-   *       ],
-   *     },
    *   );
    * ```
    */
@@ -67,11 +62,6 @@ export class CanaryDeploys extends APIResource {
    * const canaryDeployResponse =
    *   await client.ai.assistants.canaryDeploys.update(
    *     'assistant_id',
-   *     {
-   *       versions: [
-   *         { percentage: 1, version_id: 'version_id' },
-   *       ],
-   *     },
    *   );
    * ```
    */
@@ -104,62 +94,321 @@ export class CanaryDeploys extends APIResource {
 }
 
 /**
- * Request model for creating or updating canary deploys.
+ * Create/update request body. Accepts:
+ *
+ * - `rules` — canonical ordered list of routing rules
  */
 export interface CanaryDeploy {
+  rules?: Array<CanaryDeploy.Rule>;
+}
+
+export namespace CanaryDeploy {
   /**
-   * List of version configurations
+   * A targeting rule: `match` clauses (AND) gate `serve`.
+   *
+   * An empty `match` is a catch-all (always fires).
    */
-  versions: Array<VersionConfig>;
+  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>;
+    }
+  }
 }
 
 /**
- * Response model for canary deploy operations.
+ * Response shape.
+ *
+ * Always carries `rules` (canonical).
  */
 export interface CanaryDeployResponse {
   assistant_id: string;
 
   created_at: string;
 
-  updated_at: string;
+  rules: Array<CanaryDeployResponse.Rule>;
 
-  versions: Array<VersionConfig>;
+  updated_at: string;
 }
 
-/**
- * Configuration for a single version in canary deploy.
- */
-export interface VersionConfig {
+export namespace CanaryDeployResponse {
   /**
-   * Percentage of traffic for this version [1-99]
+   * A targeting rule: `match` clauses (AND) gate `serve`.
+   *
+   * An empty `match` is a catch-all (always fires).
    */
-  percentage: number;
+  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;
 
-  /**
-   * Version ID string that references assistant_versions.version_id
-   */
-  version_id: string;
+    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>;
+    }
+  }
 }
 
 export interface CanaryDeployCreateParams {
+  rules?: Array<CanaryDeployCreateParams.Rule>;
+}
+
+export namespace CanaryDeployCreateParams {
   /**
-   * List of version configurations
+   * A targeting rule: `match` clauses (AND) gate `serve`.
+   *
+   * An empty `match` is a catch-all (always fires).
    */
-  versions: Array<VersionConfig>;
+  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>;
+    }
+  }
 }
 
 export interface CanaryDeployUpdateParams {
+  rules?: Array<CanaryDeployUpdateParams.Rule>;
+}
+
+export namespace CanaryDeployUpdateParams {
   /**
-   * List of version configurations
+   * A targeting rule: `match` clauses (AND) gate `serve`.
+   *
+   * An empty `match` is a catch-all (always fires).
    */
-  versions: Array<VersionConfig>;
+  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>;
+    }
+  }
 }
 
 export declare namespace CanaryDeploys {
   export {
     type CanaryDeploy as CanaryDeploy,
     type CanaryDeployResponse as CanaryDeployResponse,
-    type VersionConfig as VersionConfig,
     type CanaryDeployCreateParams as CanaryDeployCreateParams,
     type CanaryDeployUpdateParams as CanaryDeployUpdateParams,
   };

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

@@ -46,7 +46,6 @@ export {
   CanaryDeploys,
   type CanaryDeploy,
   type CanaryDeployResponse,
-  type VersionConfig,
   type CanaryDeployCreateParams,
   type CanaryDeployUpdateParams,
 } from './canary-deploys';

package/src/resources/index.ts

@@ -1242,6 +1242,18 @@ export {
   type TrafficPolicyProfilesDefaultFlatPagination,
   type TrafficPolicyProfileListServicesResponsesDefaultFlatPagination,
 } from './traffic-policy-profiles';
+export {
+  UacConnections,
+  type UacConnectionCreateResponse,
+  type UacConnectionRetrieveResponse,
+  type UacConnectionUpdateResponse,
+  type UacConnectionListResponse,
+  type UacConnectionDeleteResponse,
+  type UacConnectionCreateParams,
+  type UacConnectionUpdateParams,
+  type UacConnectionListParams,
+  type UacConnectionListResponsesDefaultFlatPagination,
+} from './uac-connections/uac-connections';
 export {
   UsageReports,
   type UsageReportListResponse,

package/src/resources/uac-connections/actions.ts

@@ -0,0 +1,83 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+/**
+ * UAC connection operations
+ */
+export class Actions extends APIResource {
+  /**
+   * Checks the registration status for a UAC connection (`registration_status`) as
+   * well as the timestamp for the last SIP registration event
+   * (`registration_status_updated_at`).
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.uacConnections.actions.checkRegistrationStatus(
+   *     'id',
+   *   );
+   * ```
+   */
+  checkRegistrationStatus(
+    id: string,
+    options?: RequestOptions,
+  ): APIPromise<ActionCheckRegistrationStatusResponse> {
+    return this._client.post(path`/uac_connections/${id}/actions/check_registration_status`, options);
+  }
+}
+
+export interface ActionCheckRegistrationStatusResponse {
+  data?: ActionCheckRegistrationStatusResponse.Data;
+}
+
+export namespace ActionCheckRegistrationStatusResponse {
+  export interface Data {
+    /**
+     * The ip used during the SIP connection
+     */
+    ip_address?: string;
+
+    /**
+     * ISO 8601 formatted date indicating when the resource was last updated.
+     */
+    last_registration?: string;
+
+    /**
+     * The port of the SIP connection
+     */
+    port?: number;
+
+    /**
+     * Identifies the type of the resource.
+     */
+    record_type?: string;
+
+    /**
+     * The user name of the SIP connection
+     */
+    sip_username?: string;
+
+    /**
+     * The current registration status of your SIP connection
+     */
+    status?: 'Not Applicable' | 'Not Registered' | 'Failed' | 'Expired' | 'Registered' | 'Unregistered';
+
+    /**
+     * The protocol of the SIP connection
+     */
+    transport?: string;
+
+    /**
+     * The user agent of the SIP connection
+     */
+    user_agent?: string;
+  }
+}
+
+export declare namespace Actions {
+  export { type ActionCheckRegistrationStatusResponse as ActionCheckRegistrationStatusResponse };
+}

package/src/resources/uac-connections/index.ts

@@ -0,0 +1,15 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Actions, type ActionCheckRegistrationStatusResponse } from './actions';
+export {
+  UacConnections,
+  type UacConnectionCreateResponse,
+  type UacConnectionRetrieveResponse,
+  type UacConnectionUpdateResponse,
+  type UacConnectionListResponse,
+  type UacConnectionDeleteResponse,
+  type UacConnectionCreateParams,
+  type UacConnectionUpdateParams,
+  type UacConnectionListParams,
+  type UacConnectionListResponsesDefaultFlatPagination,
+} from './uac-connections';