telnyx 5.174.0 → 5.175.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3fac885ac7ccf74c3f9f991d7dca38d2155d645e1a24cbfb8fa849ff010f78b7
-  data.tar.gz: 75d6ae4f9f701214078d8c9e7a43258b677bb82a29074a26634beaa2c4628738
+  metadata.gz: f357d208801e3a8d7f0ccdc1f6ba2c65fd0f16237a2d44e4bcf1b355cf479fce
+  data.tar.gz: f9118e3971988965b6796b3a5b8901a9317de1ca8306e7579ae17f78b6e03cfa
 SHA512:
-  metadata.gz: 137fadbbd6825fe3335c3dc2aad76145d5c9af2c693023ca98905d63ca5ffd87f71d2b3ea56ae6ba0a744cb5d5c09fd2bf6219aad7ae960ed9bd9e3712feaaf0
-  data.tar.gz: 5b42c035897d4698f6ae5c7e6c20ce6305d8dbd7227927305e5825cc5215c587d73b7c5825432c423ff0517943b71d1b804aa88e5d5bda93ed86fc560ae0f5c5
+  metadata.gz: b5b614d8ca48cc67922c1b0e3154998fe5954c33f57a77ec758681d7134f10a288aa6864ffb1654fe1643d0e5d47cf8b2bf4cb903be6296b38a29050c536e364
+  data.tar.gz: 7702cb2014bc02418d6e29a207bf186b6fa7218291dcc5ca7296de1e6f6f3ded70a921403822e5fcd4d5746a74e13a871d5951635845e051827da1cd0c3da657

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [5.175.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.174.0...v5.175.0) (2026-11-06)
+
+
+### Features
+
+* promote from staging f1eb561 ([ff861fc](https://github.com/team-telnyx/telnyx-ruby/commit/ff861fcca600d7fc83d93e9cea9c1b16a9bdd5ac))
+
 ## [5.174.0](https://github.com/team-telnyx/telnyx-ruby/compare/v5.173.0...v5.174.0) (2026-10-29)
 
 

data/README.md

@@ -24,7 +24,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "telnyx", "~> 5.174.0"
+gem "telnyx", "~> 5.175.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/telnyx/client.rb

@@ -848,6 +848,20 @@ module Telnyx
     # @return [Telnyx::Resources::Tunnels]
     attr_reader :tunnels
 
+    # Read and update the authenticated user's profile and data locality.
+    # @return [Telnyx::Resources::UserProfile]
+    attr_reader :user_profile
+
+    # @return [Telnyx::Resources::AgentGateways]
+    attr_reader :agent_gateways
+
+    # Connect calendars and manage automatic meeting joins.
+    # @return [Telnyx::Resources::CalendarConnections]
+    attr_reader :calendar_connections
+
+    # @return [Telnyx::Resources::MeetingBot]
+    attr_reader :meeting_bot
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -1156,6 +1170,10 @@ module Telnyx
       @network_routes = Telnyx::Resources::NetworkRoutes.new(client: self)
       @pay_connectors = Telnyx::Resources::PayConnectors.new(client: self)
       @tunnels = Telnyx::Resources::Tunnels.new(client: self)
+      @user_profile = Telnyx::Resources::UserProfile.new(client: self)
+      @agent_gateways = Telnyx::Resources::AgentGateways.new(client: self)
+      @calendar_connections = Telnyx::Resources::CalendarConnections.new(client: self)
+      @meeting_bot = Telnyx::Resources::MeetingBot.new(client: self)
     end
   end
 end

data/lib/telnyx/internal/email_events_cursor_pagination.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Internal
+    # @generic Elem
+    #
+    # @example
+    #   if email_events_cursor_pagination.has_next?
+    #     email_events_cursor_pagination = email_events_cursor_pagination.next_page
+    #   end
+    #
+    # @example
+    #   email_events_cursor_pagination.auto_paging_each do |email_event|
+    #     puts(email_event)
+    #   end
+    class EmailEventsCursorPagination
+      include Telnyx::Internal::Type::BasePage
+
+      # @return [Array<generic<Elem>>, nil]
+      attr_accessor :data
+
+      # @return [Meta]
+      attr_accessor :meta
+
+      # @return [Boolean]
+      def next_page?
+        !data.to_a.empty? && !meta&.page_cursor.to_s.empty?
+      end
+
+      # @raise [Telnyx::HTTP::Error]
+      # @return [self]
+      def next_page
+        unless next_page?
+          message = "No more pages available. Please check #next_page? before calling ##{__method__}"
+          raise RuntimeError.new(message)
+        end
+
+        req = Telnyx::Internal::Util.deep_merge(@req, {query: {"page[cursor]": meta&.page_cursor}})
+        @client.request(req)
+      end
+
+      # @param blk [Proc]
+      #
+      # @yieldparam [generic<Elem>]
+      def auto_paging_each(&blk)
+        unless block_given?
+          raise ArgumentError.new("A block must be given to ##{__method__}")
+        end
+
+        page = self
+        loop do
+          page.data&.each(&blk)
+
+          break unless page.next_page?
+          page = page.next_page
+        end
+      end
+
+      # @api private
+      #
+      # @param client [Telnyx::Internal::Transport::BaseClient]
+      # @param req [Hash{Symbol=>Object}]
+      # @param headers [Hash{String=>String}]
+      # @param page_data [Hash{Symbol=>Object}]
+      def initialize(client:, req:, headers:, page_data:)
+        super
+
+        case page_data
+        in {data: Array => data}
+          @data = data.map { Telnyx::Internal::Type::Converter.coerce(@model, _1) }
+        else
+        end
+        case page_data
+        in {meta: Hash | nil => meta}
+          @meta =
+            Telnyx::Internal::Type::Converter.coerce(
+              Telnyx::Internal::EmailEventsCursorPagination::Meta,
+              meta
+            )
+        else
+        end
+      end
+
+      # @api private
+      #
+      # @return [String]
+      def inspect
+        model = Telnyx::Internal::Type::Converter.inspect(@model, depth: 1)
+
+        "#<#{self.class}[#{model}]:0x#{object_id.to_s(16)}>"
+      end
+
+      class Meta < Telnyx::Internal::Type::BaseModel
+        # @!attribute page_cursor
+        #
+        #   @return [String, nil]
+        optional :page_cursor, String
+
+        # @!method initialize(page_cursor: nil)
+        #   @param page_cursor [String]
+      end
+    end
+  end
+end

data/lib/telnyx/models/agent_gateway.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::AgentGateways#list
+    class AgentGateway < Telnyx::Internal::Type::BaseModel
+      # @!attribute id
+      #   Identifies the instance.
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!attribute created_at
+      #   When the instance was created.
+      #
+      #   @return [Time]
+      required :created_at, Time
+
+      # @!attribute engine
+      #   The gateway engine.
+      #
+      #   @return [Symbol, :litellm]
+      required :engine, const: :litellm
+
+      # @!attribute engine_version
+      #   The engine version the instance runs.
+      #
+      #   @return [String]
+      required :engine_version, String
+
+      # @!attribute gateway_url
+      #   The base URL of the instance's API, `http://<address>:4000`, where the address
+      #   is the instance's peer address on the WireGuard Interface. Reachable only from
+      #   hosts on the instance's _Network_, and every request to it carries a key from
+      #   this API. `null` until the instance is `ready`.
+      #
+      #   @return [String, nil]
+      required :gateway_url, String, nil?: true
+
+      # @!attribute name
+      #   A label for people; `null` when none was given.
+      #
+      #   @return [String, nil]
+      required :name, String, nil?: true
+
+      # @!attribute network_id
+      #   The [_Network_](https://developers.telnyx.com/docs/network/overview) the
+      #   WireGuard Interface belongs to.
+      #
+      #   @return [String, nil]
+      required :network_id, String, nil?: true
+
+      # @!attribute status
+      #   Where the instance is in its lifecycle. `pending`: created and waiting to start.
+      #   `provisioning`: starting. `ready`: running, with its `gateway_url` set.
+      #   `failed`: did not start in time; delete it. `deleting`: being removed.
+      #
+      #   @return [Symbol, Telnyx::Models::AgentGateway::Status]
+      required :status, enum: -> { Telnyx::AgentGateway::Status }
+
+      # @!attribute wireguard_interface_id
+      #   The WireGuard Interface the instance joins as a peer.
+      #
+      #   @return [String, nil]
+      required :wireguard_interface_id, String, nil?: true
+
+      # @!method initialize(id:, created_at:, engine_version:, gateway_url:, name:, network_id:, status:, wireguard_interface_id:, engine: :litellm)
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::AgentGateway} for more details.
+      #
+      #   An Agent Gateway instance on a WireGuard Interface.
+      #
+      #   @param id [String] Identifies the instance.
+      #
+      #   @param created_at [Time] When the instance was created.
+      #
+      #   @param engine_version [String] The engine version the instance runs.
+      #
+      #   @param gateway_url [String, nil] The base URL of the instance's API, `http://<address>:4000`, where the address i
+      #
+      #   @param name [String, nil] A label for people; `null` when none was given.
+      #
+      #   @param network_id [String, nil] The [_Network_](https://developers.telnyx.com/docs/network/overview) the WireGua
+      #
+      #   @param status [Symbol, Telnyx::Models::AgentGateway::Status] Where the instance is in its lifecycle. `pending`: created and waiting to start.
+      #
+      #   @param wireguard_interface_id [String, nil] The WireGuard Interface the instance joins as a peer.
+      #
+      #   @param engine [Symbol, :litellm] The gateway engine.
+
+      # Where the instance is in its lifecycle. `pending`: created and waiting to start.
+      # `provisioning`: starting. `ready`: running, with its `gateway_url` set.
+      # `failed`: did not start in time; delete it. `deleting`: being removed.
+      #
+      # @see Telnyx::Models::AgentGateway#status
+      module Status
+        extend Telnyx::Internal::Type::Enum
+
+        PENDING = :pending
+        PROVISIONING = :provisioning
+        READY = :ready
+        FAILED = :failed
+        DELETING = :deleting
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/telnyx/models/agent_gateway_create_params.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::AgentGateways#create
+    class AgentGatewayCreateParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      # @!attribute wireguard_interface_id
+      #   One of the account's WireGuard Interfaces. The instance joins it as a peer, and
+      #   the interface's other peers reach the instance.
+      #
+      #   @return [String]
+      required :wireguard_interface_id, String
+
+      # @!attribute name
+      #   A label for people.
+      #
+      #   @return [String, nil]
+      optional :name, String, nil?: true
+
+      # @!method initialize(wireguard_interface_id:, name: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::AgentGatewayCreateParams} for more details.
+      #
+      #   @param wireguard_interface_id [String] One of the account's WireGuard Interfaces. The instance joins it as a peer, and
+      #
+      #   @param name [String, nil] A label for people.
+      #
+      #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/telnyx/models/agent_gateway_delete_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::AgentGateways#delete
+    class AgentGatewayDeleteParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      # @!attribute instance_id
+      #
+      #   @return [String]
+      required :instance_id, String
+
+      # @!method initialize(instance_id:, request_options: {})
+      #   @param instance_id [String]
+      #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/telnyx/models/agent_gateway_list_params.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::AgentGateways#list
+    class AgentGatewayListParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      # @!attribute page_number
+      #   The page to return, counting from 1.
+      #
+      #   @return [Integer, nil]
+      optional :page_number, Integer
+
+      # @!attribute page_size
+      #   Results per page.
+      #
+      #   @return [Integer, nil]
+      optional :page_size, Integer
+
+      # @!method initialize(page_number: nil, page_size: nil, request_options: {})
+      #   @param page_number [Integer] The page to return, counting from 1.
+      #
+      #   @param page_size [Integer] Results per page.
+      #
+      #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/telnyx/models/agent_gateway_response.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::AgentGateways#create
+    class AgentGatewayResponse < Telnyx::Internal::Type::BaseModel
+      # @!attribute data
+      #   An Agent Gateway instance on a WireGuard Interface.
+      #
+      #   @return [Telnyx::Models::AgentGateway]
+      required :data, -> { Telnyx::AgentGateway }
+
+      # @!method initialize(data:)
+      #   @param data [Telnyx::Models::AgentGateway] An Agent Gateway instance on a WireGuard Interface.
+    end
+  end
+end

data/lib/telnyx/models/agent_gateway_retrieve_models_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::AgentGateways#retrieve_models
+    class AgentGatewayRetrieveModelsParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      # @!attribute instance_id
+      #
+      #   @return [String]
+      required :instance_id, String
+
+      # @!method initialize(instance_id:, request_options: {})
+      #   @param instance_id [String]
+      #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/telnyx/models/agent_gateway_retrieve_models_response.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::AgentGateways#retrieve_models
+    class AgentGatewayRetrieveModelsResponse < Telnyx::Internal::Type::BaseModel
+      # @!attribute data
+      #
+      #   @return [Array<Telnyx::Models::AgentGatewayRetrieveModelsResponse::Data>]
+      required :data,
+               -> { Telnyx::Internal::Type::ArrayOf[Telnyx::Models::AgentGatewayRetrieveModelsResponse::Data] }
+
+      # @!method initialize(data:)
+      #   @param data [Array<Telnyx::Models::AgentGatewayRetrieveModelsResponse::Data>]
+
+      class Data < Telnyx::Internal::Type::BaseModel
+        # @!attribute id
+        #   The model's ID on the instance.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute model
+        #   The Telnyx Inference model behind it, such as `zai-org/GLM-5.3-Flash`.
+        #
+        #   @return [String]
+        required :model, String
+
+        # @!attribute name
+        #   The name a request uses, such as `GLM-5.3-Flash`.
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute priced_at
+        #   When the price was last set.
+        #
+        #   @return [Time, nil]
+        required :priced_at, Time, nil?: true
+
+        # @!attribute pricing
+        #   A model's price in USD per million tokens.
+        #
+        #   @return [Telnyx::Models::AgentGatewayRetrieveModelsResponse::Data::Pricing]
+        required :pricing, -> { Telnyx::Models::AgentGatewayRetrieveModelsResponse::Data::Pricing }
+
+        # @!method initialize(id:, model:, name:, priced_at:, pricing:)
+        #   A model an instance serves.
+        #
+        #   @param id [String] The model's ID on the instance.
+        #
+        #   @param model [String] The Telnyx Inference model behind it, such as `zai-org/GLM-5.3-Flash`.
+        #
+        #   @param name [String] The name a request uses, such as `GLM-5.3-Flash`.
+        #
+        #   @param priced_at [Time, nil] When the price was last set.
+        #
+        #   @param pricing [Telnyx::Models::AgentGatewayRetrieveModelsResponse::Data::Pricing] A model's price in USD per million tokens.
+
+        # @see Telnyx::Models::AgentGatewayRetrieveModelsResponse::Data#pricing
+        class Pricing < Telnyx::Internal::Type::BaseModel
+          # @!attribute cached_input
+          #   USD per million cached input tokens.
+          #
+          #   @return [Float, nil]
+          required :cached_input, Float, nil?: true
+
+          # @!attribute currency
+          #   Always `USD`.
+          #
+          #   @return [String]
+          required :currency, String
+
+          # @!attribute input
+          #   USD per million input tokens.
+          #
+          #   @return [Float]
+          required :input, Float
+
+          # @!attribute output
+          #   USD per million output tokens.
+          #
+          #   @return [Float]
+          required :output, Float
+
+          # @!attribute unit
+          #   Always `1M_tokens`.
+          #
+          #   @return [String]
+          required :unit, String
+
+          # @!method initialize(cached_input:, currency:, input:, output:, unit:)
+          #   A model's price in USD per million tokens.
+          #
+          #   @param cached_input [Float, nil] USD per million cached input tokens.
+          #
+          #   @param currency [String] Always `USD`.
+          #
+          #   @param input [Float] USD per million input tokens.
+          #
+          #   @param output [Float] USD per million output tokens.
+          #
+          #   @param unit [String] Always `1M_tokens`.
+        end
+      end
+    end
+  end
+end

data/lib/telnyx/models/agent_gateway_retrieve_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::AgentGateways#retrieve
+    class AgentGatewayRetrieveParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      # @!attribute instance_id
+      #
+      #   @return [String]
+      required :instance_id, String
+
+      # @!method initialize(instance_id:, request_options: {})
+      #   @param instance_id [String]
+      #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/telnyx/models/agent_gateway_retrieve_spend_logs_params.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::AgentGateways#retrieve_spend_logs
+    class AgentGatewayRetrieveSpendLogsParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      # @!attribute instance_id
+      #
+      #   @return [String]
+      required :instance_id, String
+
+      # @!attribute end_
+      #   The window's end, an RFC 3339 timestamp with an offset. Defaults to now.
+      #
+      #   @return [Time, nil]
+      optional :end_, Time
+
+      # @!attribute key_id
+      #   Only the requests made with this key.
+      #
+      #   @return [String, nil]
+      optional :key_id, String
+
+      # @!attribute page_number
+      #   The page to return, counting from 1.
+      #
+      #   @return [Integer, nil]
+      optional :page_number, Integer
+
+      # @!attribute page_size
+      #   Results per page.
+      #
+      #   @return [Integer, nil]
+      optional :page_size, Integer
+
+      # @!attribute start
+      #   The window's start, an RFC 3339 timestamp with an offset. Defaults to 24 hours
+      #   before `end`.
+      #
+      #   @return [Time, nil]
+      optional :start, Time
+
+      # @!attribute team_id
+      #   Only the requests made with this team's keys.
+      #
+      #   @return [String, nil]
+      optional :team_id, String
+
+      # @!method initialize(instance_id:, end_: nil, key_id: nil, page_number: nil, page_size: nil, start: nil, team_id: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::AgentGatewayRetrieveSpendLogsParams} for more details.
+      #
+      #   @param instance_id [String]
+      #
+      #   @param end_ [Time] The window's end, an RFC 3339 timestamp with an offset. Defaults to now.
+      #
+      #   @param key_id [String] Only the requests made with this key.
+      #
+      #   @param page_number [Integer] The page to return, counting from 1.
+      #
+      #   @param page_size [Integer] Results per page.
+      #
+      #   @param start [Time] The window's start, an RFC 3339 timestamp with an offset. Defaults to 24 hours b
+      #
+      #   @param team_id [String] Only the requests made with this team's keys.
+      #
+      #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end