telnyx 5.174.0 → 5.175.0

data/rbi/telnyx/models/agent_gateway_retrieve_models_params.rbi

@@ -0,0 +1,38 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    class AgentGatewayRetrieveModelsParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Telnyx::AgentGatewayRetrieveModelsParams,
+            Telnyx::Internal::AnyHash
+          )
+        end
+
+      sig { returns(String) }
+      attr_accessor :instance_id
+
+      sig do
+        params(
+          instance_id: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(instance_id:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          { instance_id: String, request_options: Telnyx::RequestOptions }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/telnyx/models/agent_gateway_retrieve_models_response.rbi

@@ -0,0 +1,194 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    class AgentGatewayRetrieveModelsResponse < Telnyx::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Telnyx::Models::AgentGatewayRetrieveModelsResponse,
+            Telnyx::Internal::AnyHash
+          )
+        end
+
+      sig do
+        returns(
+          T::Array[Telnyx::Models::AgentGatewayRetrieveModelsResponse::Data]
+        )
+      end
+      attr_accessor :data
+
+      sig do
+        params(
+          data:
+            T::Array[
+              Telnyx::Models::AgentGatewayRetrieveModelsResponse::Data::OrHash
+            ]
+        ).returns(T.attached_class)
+      end
+      def self.new(data:)
+      end
+
+      sig do
+        override.returns(
+          {
+            data:
+              T::Array[Telnyx::Models::AgentGatewayRetrieveModelsResponse::Data]
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Data < Telnyx::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Telnyx::Models::AgentGatewayRetrieveModelsResponse::Data,
+              Telnyx::Internal::AnyHash
+            )
+          end
+
+        # The model's ID on the instance.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # The Telnyx Inference model behind it, such as `zai-org/GLM-5.3-Flash`.
+        sig { returns(String) }
+        attr_accessor :model
+
+        # The name a request uses, such as `GLM-5.3-Flash`.
+        sig { returns(String) }
+        attr_accessor :name
+
+        # When the price was last set.
+        sig { returns(T.nilable(Time)) }
+        attr_accessor :priced_at
+
+        # A model's price in USD per million tokens.
+        sig do
+          returns(
+            Telnyx::Models::AgentGatewayRetrieveModelsResponse::Data::Pricing
+          )
+        end
+        attr_reader :pricing
+
+        sig do
+          params(
+            pricing:
+              Telnyx::Models::AgentGatewayRetrieveModelsResponse::Data::Pricing::OrHash
+          ).void
+        end
+        attr_writer :pricing
+
+        # A model an instance serves.
+        sig do
+          params(
+            id: String,
+            model: String,
+            name: String,
+            priced_at: T.nilable(Time),
+            pricing:
+              Telnyx::Models::AgentGatewayRetrieveModelsResponse::Data::Pricing::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The model's ID on the instance.
+          id:,
+          # The Telnyx Inference model behind it, such as `zai-org/GLM-5.3-Flash`.
+          model:,
+          # The name a request uses, such as `GLM-5.3-Flash`.
+          name:,
+          # When the price was last set.
+          priced_at:,
+          # A model's price in USD per million tokens.
+          pricing:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              model: String,
+              name: String,
+              priced_at: T.nilable(Time),
+              pricing:
+                Telnyx::Models::AgentGatewayRetrieveModelsResponse::Data::Pricing
+            }
+          )
+        end
+        def to_hash
+        end
+
+        class Pricing < Telnyx::Internal::Type::BaseModel
+          OrHash =
+            T.type_alias do
+              T.any(
+                Telnyx::Models::AgentGatewayRetrieveModelsResponse::Data::Pricing,
+                Telnyx::Internal::AnyHash
+              )
+            end
+
+          # USD per million cached input tokens.
+          sig { returns(T.nilable(Float)) }
+          attr_accessor :cached_input
+
+          # Always `USD`.
+          sig { returns(String) }
+          attr_accessor :currency
+
+          # USD per million input tokens.
+          sig { returns(Float) }
+          attr_accessor :input
+
+          # USD per million output tokens.
+          sig { returns(Float) }
+          attr_accessor :output
+
+          # Always `1M_tokens`.
+          sig { returns(String) }
+          attr_accessor :unit
+
+          # A model's price in USD per million tokens.
+          sig do
+            params(
+              cached_input: T.nilable(Float),
+              currency: String,
+              input: Float,
+              output: Float,
+              unit: String
+            ).returns(T.attached_class)
+          end
+          def self.new(
+            # USD per million cached input tokens.
+            cached_input:,
+            # Always `USD`.
+            currency:,
+            # USD per million input tokens.
+            input:,
+            # USD per million output tokens.
+            output:,
+            # Always `1M_tokens`.
+            unit:
+          )
+          end
+
+          sig do
+            override.returns(
+              {
+                cached_input: T.nilable(Float),
+                currency: String,
+                input: Float,
+                output: Float,
+                unit: String
+              }
+            )
+          end
+          def to_hash
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/models/agent_gateway_retrieve_params.rbi

@@ -0,0 +1,35 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    class AgentGatewayRetrieveParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Telnyx::AgentGatewayRetrieveParams, Telnyx::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :instance_id
+
+      sig do
+        params(
+          instance_id: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(instance_id:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          { instance_id: String, request_options: Telnyx::RequestOptions }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/telnyx/models/agent_gateway_retrieve_spend_logs_params.rbi

@@ -0,0 +1,112 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    class AgentGatewayRetrieveSpendLogsParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Telnyx::AgentGatewayRetrieveSpendLogsParams,
+            Telnyx::Internal::AnyHash
+          )
+        end
+
+      sig { returns(String) }
+      attr_accessor :instance_id
+
+      # The window's end, an RFC 3339 timestamp with an offset. Defaults to now.
+      sig { returns(T.nilable(Time)) }
+      attr_reader :end_
+
+      sig { params(end_: Time).void }
+      attr_writer :end_
+
+      # Only the requests made with this key.
+      sig { returns(T.nilable(String)) }
+      attr_reader :key_id
+
+      sig { params(key_id: String).void }
+      attr_writer :key_id
+
+      # The page to return, counting from 1.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :page_number
+
+      sig { params(page_number: Integer).void }
+      attr_writer :page_number
+
+      # Results per page.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :page_size
+
+      sig { params(page_size: Integer).void }
+      attr_writer :page_size
+
+      # The window's start, an RFC 3339 timestamp with an offset. Defaults to 24 hours
+      # before `end`.
+      sig { returns(T.nilable(Time)) }
+      attr_reader :start
+
+      sig { params(start: Time).void }
+      attr_writer :start
+
+      # Only the requests made with this team's keys.
+      sig { returns(T.nilable(String)) }
+      attr_reader :team_id
+
+      sig { params(team_id: String).void }
+      attr_writer :team_id
+
+      sig do
+        params(
+          instance_id: String,
+          end_: Time,
+          key_id: String,
+          page_number: Integer,
+          page_size: Integer,
+          start: Time,
+          team_id: String,
+          request_options: Telnyx::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        instance_id:,
+        # The window's end, an RFC 3339 timestamp with an offset. Defaults to now.
+        end_: nil,
+        # Only the requests made with this key.
+        key_id: nil,
+        # The page to return, counting from 1.
+        page_number: nil,
+        # Results per page.
+        page_size: nil,
+        # The window's start, an RFC 3339 timestamp with an offset. Defaults to 24 hours
+        # before `end`.
+        start: nil,
+        # Only the requests made with this team's keys.
+        team_id: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            instance_id: String,
+            end_: Time,
+            key_id: String,
+            page_number: Integer,
+            page_size: Integer,
+            start: Time,
+            team_id: String,
+            request_options: Telnyx::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/telnyx/models/agent_gateway_retrieve_spend_logs_response.rbi

@@ -0,0 +1,269 @@
+# typed: strong
+
+module Telnyx
+  module Models
+    class AgentGatewayRetrieveSpendLogsResponse < Telnyx::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Telnyx::Models::AgentGatewayRetrieveSpendLogsResponse,
+            Telnyx::Internal::AnyHash
+          )
+        end
+
+      sig do
+        returns(
+          T::Array[Telnyx::Models::AgentGatewayRetrieveSpendLogsResponse::Data]
+        )
+      end
+      attr_accessor :data
+
+      sig do
+        returns(Telnyx::Models::AgentGatewayRetrieveSpendLogsResponse::Meta)
+      end
+      attr_reader :meta
+
+      sig do
+        params(
+          meta:
+            Telnyx::Models::AgentGatewayRetrieveSpendLogsResponse::Meta::OrHash
+        ).void
+      end
+      attr_writer :meta
+
+      sig do
+        params(
+          data:
+            T::Array[
+              Telnyx::Models::AgentGatewayRetrieveSpendLogsResponse::Data::OrHash
+            ],
+          meta:
+            Telnyx::Models::AgentGatewayRetrieveSpendLogsResponse::Meta::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(data:, meta:)
+      end
+
+      sig do
+        override.returns(
+          {
+            data:
+              T::Array[
+                Telnyx::Models::AgentGatewayRetrieveSpendLogsResponse::Data
+              ],
+            meta: Telnyx::Models::AgentGatewayRetrieveSpendLogsResponse::Meta
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Data < Telnyx::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Telnyx::Models::AgentGatewayRetrieveSpendLogsResponse::Data,
+              Telnyx::Internal::AnyHash
+            )
+          end
+
+        # The request's ID.
+        sig { returns(String) }
+        attr_accessor :id
+
+        # Output tokens, reasoning included.
+        sig { returns(Integer) }
+        attr_accessor :completion_tokens
+
+        # How long the request took, in milliseconds.
+        sig { returns(T.nilable(Integer)) }
+        attr_accessor :duration_ms
+
+        # When the request ended.
+        sig { returns(T.nilable(Time)) }
+        attr_accessor :ended_at
+
+        # The key the request used.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :key_id
+
+        # The Telnyx Inference model that answered, such as `zai-org/GLM-5.3-Flash`. For
+        # an MCP tool request, `MCP: ` and the tool's name.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :model
+
+        # The request type. `acompletion` is a chat completion, `aresponses` a response,
+        # `anthropic_messages` a message, `call_mcp_tool` an MCP tool request, and
+        # `list_mcp_tools` an MCP tool list.
+        sig { returns(String) }
+        attr_accessor :operation
+
+        # Input tokens.
+        sig { returns(Integer) }
+        attr_accessor :prompt_tokens
+
+        # What the request cost, in USD, with its tokens at Telnyx Inference prices.
+        sig { returns(Float) }
+        attr_accessor :spend
+
+        # When the request started.
+        sig { returns(Time) }
+        attr_accessor :started_at
+
+        # `success` or `failure`.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :status
+
+        # The key's team.
+        sig { returns(T.nilable(String)) }
+        attr_accessor :team_id
+
+        # Input and output tokens.
+        sig { returns(Integer) }
+        attr_accessor :total_tokens
+
+        # One request the instance served.
+        sig do
+          params(
+            id: String,
+            completion_tokens: Integer,
+            duration_ms: T.nilable(Integer),
+            ended_at: T.nilable(Time),
+            key_id: T.nilable(String),
+            model: T.nilable(String),
+            operation: String,
+            prompt_tokens: Integer,
+            spend: Float,
+            started_at: Time,
+            status: T.nilable(String),
+            team_id: T.nilable(String),
+            total_tokens: Integer
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The request's ID.
+          id:,
+          # Output tokens, reasoning included.
+          completion_tokens:,
+          # How long the request took, in milliseconds.
+          duration_ms:,
+          # When the request ended.
+          ended_at:,
+          # The key the request used.
+          key_id:,
+          # The Telnyx Inference model that answered, such as `zai-org/GLM-5.3-Flash`. For
+          # an MCP tool request, `MCP: ` and the tool's name.
+          model:,
+          # The request type. `acompletion` is a chat completion, `aresponses` a response,
+          # `anthropic_messages` a message, `call_mcp_tool` an MCP tool request, and
+          # `list_mcp_tools` an MCP tool list.
+          operation:,
+          # Input tokens.
+          prompt_tokens:,
+          # What the request cost, in USD, with its tokens at Telnyx Inference prices.
+          spend:,
+          # When the request started.
+          started_at:,
+          # `success` or `failure`.
+          status:,
+          # The key's team.
+          team_id:,
+          # Input and output tokens.
+          total_tokens:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              id: String,
+              completion_tokens: Integer,
+              duration_ms: T.nilable(Integer),
+              ended_at: T.nilable(Time),
+              key_id: T.nilable(String),
+              model: T.nilable(String),
+              operation: String,
+              prompt_tokens: Integer,
+              spend: Float,
+              started_at: Time,
+              status: T.nilable(String),
+              team_id: T.nilable(String),
+              total_tokens: Integer
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+
+      class Meta < Telnyx::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Telnyx::Models::AgentGatewayRetrieveSpendLogsResponse::Meta,
+              Telnyx::Internal::AnyHash
+            )
+          end
+
+        # The page returned, counting from 1.
+        sig { returns(Integer) }
+        attr_accessor :page_number
+
+        # Results per page.
+        sig { returns(Integer) }
+        attr_accessor :page_size
+
+        # Pages that can be requested; 0 when nothing matched.
+        sig { returns(Integer) }
+        attr_accessor :total_pages
+
+        # Results across every page.
+        sig { returns(Integer) }
+        attr_accessor :total_results
+
+        # `true` when the window holds more than 10,000 rows. The two totals are then
+        # lower bounds: narrow the window, or page until a page comes back empty.
+        sig { returns(T::Boolean) }
+        attr_accessor :total_results_capped
+
+        sig do
+          params(
+            page_number: Integer,
+            page_size: Integer,
+            total_pages: Integer,
+            total_results: Integer,
+            total_results_capped: T::Boolean
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # The page returned, counting from 1.
+          page_number:,
+          # Results per page.
+          page_size:,
+          # Pages that can be requested; 0 when nothing matched.
+          total_pages:,
+          # Results across every page.
+          total_results:,
+          # `true` when the window holds more than 10,000 rows. The two totals are then
+          # lower bounds: narrow the window, or page until a page comes back empty.
+          total_results_capped:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              page_number: Integer,
+              page_size: Integer,
+              total_pages: Integer,
+              total_results: Integer,
+              total_results_capped: T::Boolean
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end