telnyx 5.170.0 → 5.171.0

data/rbi/telnyx/resources/llm_token_gateway/token_groups.rbi

@@ -0,0 +1,278 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class LlmTokenGateway
+      # Manage and report AI Gateway usage.
+      class TokenGroups
+        # Create gateway token group within the authenticated Telnyx account. Foreign and
+        # unknown resource IDs return the same 404 response.
+        sig do
+          params(
+            allowed_models: T::Array[String],
+            name: String,
+            idempotency_key: String,
+            blocked: T::Boolean,
+            budget_duration:
+              T.nilable(Telnyx::LlmTokenGateway::BudgetDuration::OrSymbol),
+            cache_ttl: T.nilable(Integer),
+            fallbacks: T.nilable(T::Hash[Symbol, T::Array[String]]),
+            guardrails:
+              T.nilable(
+                Telnyx::LlmTokenGateway::TokenGroupCreateParams::Guardrails::OrHash
+              ),
+            max_budget: T.nilable(Float),
+            max_parallel_requests: T.nilable(Integer),
+            provider_key_ids: T::Array[String],
+            retries:
+              T.nilable(
+                Telnyx::LlmTokenGateway::TokenGroupCreateParams::Retries::OrHash
+              ),
+            rpm_limit: T.nilable(Integer),
+            tpm_limit: T.nilable(Integer),
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::LlmTokenGateway::TokenGroupResponse)
+        end
+        def create(
+          # Body param
+          allowed_models:,
+          # Body param
+          name:,
+          # Header param: 24h, scoped by account+method+path. Same key/body returns same
+          # outcome; changed body 409; in-progress 409 with Retry-After. Token-create replay
+          # returns 200 metadata WITHOUT secret.
+          idempotency_key:,
+          # Body param
+          blocked: nil,
+          # Body param
+          budget_duration: nil,
+          # Body param
+          cache_ttl: nil,
+          # Body param: Per-group model fallbacks: primary alias -> ordered list of 1..3
+          # other aliases. Every key and listed alias must be in allowed_models (a PATCH
+          # removing a referenced alias is 400); a chain never lists its own key; wildcards
+          # are rejected. Chains are one level deep (a step's own chain is not expanded).
+          # Fallback is attempted only for managed routes, only before the first provider
+          # event is forwarded, and only to steps the key may use; each attempt is reserved
+          # and recorded. {} and null both disable fallbacks.
+          fallbacks: nil,
+          # Body param: Per-group guardrail policy. Missing actions default to ignore.
+          # profiles may be listed with both dlp actions ignore (staged, inactive) but a
+          # non-ignore dlp action requires at least one profile. streaming defaults to
+          # buffered when any response action is block and passthrough otherwise;
+          # passthrough with a response block is 400. Findings are codes and counts only;
+          # content is never stored. The stored form is echoed back canonicalised (all
+          # actions explicit, profiles sorted); {} is stored as an all-ignore policy, null
+          # disables.
+          guardrails: nil,
+          # Body param: USD, decimal precision at most 6 places; parse exactly to integer
+          # micro-USD, never binary float accounting.
+          max_budget: nil,
+          # Body param: Optional maximum concurrent reserved/dispatched cache misses across
+          # replicas. Null means no concurrency cap. Cache hits do not consume slots;
+          # unknown usage retains its budget hold without a slot.
+          max_parallel_requests: nil,
+          # Body param
+          provider_key_ids: nil,
+          # Body param: Per-group same-route retries. max_attempts counts the first try of
+          # each step (the primary and each fallback) and is the ceiling for the
+          # x-ltg-max-attempts request header. A step is retried only when its attempt
+          # definitely did no provider work (connection failure before dispatch, or 429/529)
+          # before the first provider event; an uncertain failure (timeout,
+          # 408/500/502/503/504) moves to the next fallback step instead. max_attempts x
+          # (1 + the longest fallback chain) must not exceed 8, else 400. The n-th retry
+          # waits retry_delay_ms (constant), retry_delay_ms*n (linear) or
+          # retry_delay_ms*2^(n-1) (exponential), at most 5 s and never past the request
+          # deadline, then jittered uniformly down to half that value so concurrent retries
+          # spread out; a provider Retry-After of at most 5 s is honoured and a longer one
+          # moves to the next step. request_timeout_ms applies to streaming requests only:
+          # it bounds each attempt's time to its first provider event and never applies
+          # after it. Non-stream requests keep the per-attempt hop and idle bounds (their
+          # headers arrive only with the finished completion). retry_delay_ms and backoff
+          # are floors for the request knobs. Each planned attempt is reserved (at most 8
+          # per request); unused reservation is released at settlement. Managed routes only.
+          # The stored form is echoed back with defaults filled in; null disables retries.
+          retries: nil,
+          # Body param
+          rpm_limit: nil,
+          # Body param
+          tpm_limit: nil,
+          request_options: {}
+        )
+        end
+
+        # Get gateway token group within the authenticated Telnyx account. Foreign and
+        # unknown resource IDs return the same 404 response.
+        sig do
+          params(
+            id: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::LlmTokenGateway::TokenGroupResponse)
+        end
+        def retrieve(id, request_options: {})
+        end
+
+        # Update gateway token group within the authenticated Telnyx account. Foreign and
+        # unknown resource IDs return the same 404 response. Omitted fields are preserved.
+        # Null clears the optional concurrency, fallback and retry settings. A stale
+        # If-Match returns 412; read the resource again before updating.
+        sig do
+          params(
+            id: String,
+            idempotency_key: String,
+            if_match: String,
+            allowed_models: T::Array[String],
+            blocked: T::Boolean,
+            budget_duration:
+              T.nilable(Telnyx::LlmTokenGateway::BudgetDuration::OrSymbol),
+            cache_ttl: T.nilable(Integer),
+            fallbacks: T.nilable(T::Hash[Symbol, T::Array[String]]),
+            guardrails:
+              T.nilable(
+                Telnyx::LlmTokenGateway::TokenGroupUpdateParams::Guardrails::OrHash
+              ),
+            max_budget: T.nilable(Float),
+            max_parallel_requests: T.nilable(Integer),
+            name: String,
+            provider_key_ids: T::Array[String],
+            retries:
+              T.nilable(
+                Telnyx::LlmTokenGateway::TokenGroupUpdateParams::Retries::OrHash
+              ),
+            rpm_limit: T.nilable(Integer),
+            tpm_limit: T.nilable(Integer),
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::LlmTokenGateway::TokenGroupResponse)
+        end
+        def update(
+          # Path param
+          id,
+          # Header param: 24h, scoped by account+method+path. Same key/body returns same
+          # outcome; changed body 409; in-progress 409 with Retry-After. Token-create replay
+          # returns 200 metadata WITHOUT secret.
+          idempotency_key:,
+          # Header param: Exact quoted resource-version ETag; an exact intermediary-weakened
+          # echo W/"n" is accepted. Wildcard, combined and malformed validators are
+          # rejected; stale 412; missing 428. HTTP field names are case-insensitive.
+          # Replayed idempotent result is checked first.
+          if_match:,
+          # Body param
+          allowed_models: nil,
+          # Body param
+          blocked: nil,
+          # Body param
+          budget_duration: nil,
+          # Body param
+          cache_ttl: nil,
+          # Body param: Per-group model fallbacks: primary alias -> ordered list of 1..3
+          # other aliases. Every key and listed alias must be in allowed_models (a PATCH
+          # removing a referenced alias is 400); a chain never lists its own key; wildcards
+          # are rejected. Chains are one level deep (a step's own chain is not expanded).
+          # Fallback is attempted only for managed routes, only before the first provider
+          # event is forwarded, and only to steps the key may use; each attempt is reserved
+          # and recorded. {} and null both disable fallbacks.
+          fallbacks: nil,
+          # Body param: Per-group guardrail policy. Missing actions default to ignore.
+          # profiles may be listed with both dlp actions ignore (staged, inactive) but a
+          # non-ignore dlp action requires at least one profile. streaming defaults to
+          # buffered when any response action is block and passthrough otherwise;
+          # passthrough with a response block is 400. Findings are codes and counts only;
+          # content is never stored. The stored form is echoed back canonicalised (all
+          # actions explicit, profiles sorted); {} is stored as an all-ignore policy, null
+          # disables.
+          guardrails: nil,
+          # Body param: USD, decimal precision at most 6 places; parse exactly to integer
+          # micro-USD, never binary float accounting.
+          max_budget: nil,
+          # Body param: Optional maximum concurrent reserved/dispatched cache misses across
+          # replicas. Null means no concurrency cap. Cache hits do not consume slots;
+          # unknown usage retains its budget hold without a slot.
+          max_parallel_requests: nil,
+          # Body param
+          name: nil,
+          # Body param
+          provider_key_ids: nil,
+          # Body param: Per-group same-route retries. max_attempts counts the first try of
+          # each step (the primary and each fallback) and is the ceiling for the
+          # x-ltg-max-attempts request header. A step is retried only when its attempt
+          # definitely did no provider work (connection failure before dispatch, or 429/529)
+          # before the first provider event; an uncertain failure (timeout,
+          # 408/500/502/503/504) moves to the next fallback step instead. max_attempts x
+          # (1 + the longest fallback chain) must not exceed 8, else 400. The n-th retry
+          # waits retry_delay_ms (constant), retry_delay_ms*n (linear) or
+          # retry_delay_ms*2^(n-1) (exponential), at most 5 s and never past the request
+          # deadline, then jittered uniformly down to half that value so concurrent retries
+          # spread out; a provider Retry-After of at most 5 s is honoured and a longer one
+          # moves to the next step. request_timeout_ms applies to streaming requests only:
+          # it bounds each attempt's time to its first provider event and never applies
+          # after it. Non-stream requests keep the per-attempt hop and idle bounds (their
+          # headers arrive only with the finished completion). retry_delay_ms and backoff
+          # are floors for the request knobs. Each planned attempt is reserved (at most 8
+          # per request); unused reservation is released at settlement. Managed routes only.
+          # The stored form is echoed back with defaults filled in; null disables retries.
+          retries: nil,
+          # Body param
+          rpm_limit: nil,
+          # Body param
+          tpm_limit: nil,
+          request_options: {}
+        )
+        end
+
+        # List gateway token groups within the authenticated Telnyx account. Foreign and
+        # unknown resource IDs return the same 404 response.
+        sig do
+          params(
+            page_number: Integer,
+            page_size: Integer,
+            page_snapshot: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(
+            Telnyx::Internal::DefaultFlatPagination[
+              Telnyx::LlmTokenGateway::TokenGroup
+            ]
+          )
+        end
+        def list(
+          page_number: nil,
+          page_size: nil,
+          # Required after page 1; account/filter-bound 15-minute stable snapshot;
+          # expired/mismatch 409.
+          page_snapshot: nil,
+          request_options: {}
+        )
+        end
+
+        # Revoke resource and its keys atomically; retain historical attribution, never
+        # detach into an ungoverned service key.
+        sig do
+          params(
+            id: String,
+            idempotency_key: String,
+            if_match: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).void
+        end
+        def delete(
+          id,
+          # 24h, scoped by account+method+path. Same key/body returns same outcome; changed
+          # body 409; in-progress 409 with Retry-After. Token-create replay returns 200
+          # metadata WITHOUT secret.
+          idempotency_key:,
+          # Exact quoted resource-version ETag; an exact intermediary-weakened echo W/"n" is
+          # accepted. Wildcard, combined and malformed validators are rejected; stale 412;
+          # missing 428. HTTP field names are case-insensitive. Replayed idempotent result
+          # is checked first.
+          if_match:,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Telnyx::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/llm_token_gateway/token_keys.rbi

@@ -0,0 +1,220 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class LlmTokenGateway
+      # Manage and report AI Gateway usage.
+      class TokenKeys
+        # Create gateway token key within the authenticated Telnyx account. Foreign and
+        # unknown resource IDs return the same 404 response. The token secret is returned
+        # only on the original create response. A replay returns metadata without the
+        # secret. Provisioning is advisory; ready is not a guarantee of inference
+        # availability.
+        sig do
+          params(
+            name: String,
+            token_group_id: String,
+            idempotency_key: String,
+            allowed_models: T.nilable(T::Array[String]),
+            blocked: T::Boolean,
+            budget_duration:
+              T.nilable(Telnyx::LlmTokenGateway::BudgetDuration::OrSymbol),
+            expires_at: T.nilable(Time),
+            max_budget: T.nilable(Float),
+            max_parallel_requests: T.nilable(Integer),
+            required_end_user_id: T::Boolean,
+            rpm_limit: T.nilable(Integer),
+            token_user_id: T.nilable(String),
+            tpm_limit: T.nilable(Integer),
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::LlmTokenGateway::TokenKeyResponse)
+        end
+        def create(
+          # Body param
+          name:,
+          # Body param
+          token_group_id:,
+          # Header param: 24h, scoped by account+method+path. Same key/body returns same
+          # outcome; changed body 409; in-progress 409 with Retry-After. Token-create replay
+          # returns 200 metadata WITHOUT secret.
+          idempotency_key:,
+          # Body param
+          allowed_models: nil,
+          # Body param
+          blocked: nil,
+          # Body param
+          budget_duration: nil,
+          # Body param
+          expires_at: nil,
+          # Body param: USD, decimal precision at most 6 places; parse exactly to integer
+          # micro-USD, never binary float accounting.
+          max_budget: nil,
+          # Body param: Optional maximum concurrent reserved/dispatched cache misses across
+          # replicas. Null means no concurrency cap. Cache hits do not consume slots;
+          # unknown usage retains its budget hold without a slot.
+          max_parallel_requests: nil,
+          # Body param: Require a nonempty caller-asserted end-user ID; not proof of
+          # identity.
+          required_end_user_id: nil,
+          # Body param: Omitted or null defaults to the maximum (6000) (on a blocked key,
+          # null is kept until the key is unblocked); a value below the minimum (1) or above
+          # the maximum is rejected with 400 limit_out_of_range; a malformed value
+          # (negative, wrong type or precision) is 400 invalid_request. Block the key
+          # (blocked: true) to deny it; blocking is always accepted.
+          rpm_limit: nil,
+          # Body param
+          token_user_id: nil,
+          # Body param: Omitted or null defaults to the maximum (10000000) (on a blocked
+          # key, null is kept until the key is unblocked); a value below the minimum (1) or
+          # above the maximum is rejected with 400 limit_out_of_range; a malformed value
+          # (negative, wrong type or precision) is 400 invalid_request. Block the key
+          # (blocked: true) to deny it; blocking is always accepted.
+          tpm_limit: nil,
+          request_options: {}
+        )
+        end
+
+        # Get gateway token key within the authenticated Telnyx account. Foreign and
+        # unknown resource IDs return the same 404 response.
+        sig do
+          params(
+            id: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::LlmTokenGateway::TokenKeyResponse)
+        end
+        def retrieve(id, request_options: {})
+        end
+
+        # Update gateway token key within the authenticated Telnyx account. Foreign and
+        # unknown resource IDs return the same 404 response. Omitted fields are preserved.
+        # Null clears max_parallel_requests; null resets budget and rate limits to their
+        # maximum. A stale If-Match returns 412.
+        sig do
+          params(
+            id: String,
+            idempotency_key: String,
+            if_match: String,
+            allowed_models: T.nilable(T::Array[String]),
+            blocked: T::Boolean,
+            budget_duration:
+              T.nilable(Telnyx::LlmTokenGateway::BudgetDuration::OrSymbol),
+            expires_at: T.nilable(Time),
+            max_budget: T.nilable(Float),
+            max_parallel_requests: T.nilable(Integer),
+            name: String,
+            required_end_user_id: T::Boolean,
+            rpm_limit: T.nilable(Integer),
+            tpm_limit: T.nilable(Integer),
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::LlmTokenGateway::TokenKeyResponse)
+        end
+        def update(
+          # Path param
+          id,
+          # Header param: 24h, scoped by account+method+path. Same key/body returns same
+          # outcome; changed body 409; in-progress 409 with Retry-After. Token-create replay
+          # returns 200 metadata WITHOUT secret.
+          idempotency_key:,
+          # Header param: Exact quoted resource-version ETag; an exact intermediary-weakened
+          # echo W/"n" is accepted. Wildcard, combined and malformed validators are
+          # rejected; stale 412; missing 428. HTTP field names are case-insensitive.
+          # Replayed idempotent result is checked first.
+          if_match:,
+          # Body param
+          allowed_models: nil,
+          # Body param
+          blocked: nil,
+          # Body param
+          budget_duration: nil,
+          # Body param
+          expires_at: nil,
+          # Body param: USD, decimal precision at most 6 places; parse exactly to integer
+          # micro-USD, never binary float accounting.
+          max_budget: nil,
+          # Body param: Optional maximum concurrent reserved/dispatched cache misses across
+          # replicas. Null means no concurrency cap. Cache hits do not consume slots;
+          # unknown usage retains its budget hold without a slot.
+          max_parallel_requests: nil,
+          # Body param
+          name: nil,
+          # Body param: Require a nonempty caller-asserted end-user ID; not proof of
+          # identity. Omission preserves the current requirement.
+          required_end_user_id: nil,
+          # Body param: Omitted or null defaults to the maximum (6000) (on a blocked key,
+          # null is kept until the key is unblocked); a value below the minimum (1) or above
+          # the maximum is rejected with 400 limit_out_of_range; a malformed value
+          # (negative, wrong type or precision) is 400 invalid_request. Block the key
+          # (blocked: true) to deny it; blocking is always accepted.
+          rpm_limit: nil,
+          # Body param: Omitted or null defaults to the maximum (10000000) (on a blocked
+          # key, null is kept until the key is unblocked); a value below the minimum (1) or
+          # above the maximum is rejected with 400 limit_out_of_range; a malformed value
+          # (negative, wrong type or precision) is 400 invalid_request. Block the key
+          # (blocked: true) to deny it; blocking is always accepted.
+          tpm_limit: nil,
+          request_options: {}
+        )
+        end
+
+        # List gateway token keys within the authenticated Telnyx account. Foreign and
+        # unknown resource IDs return the same 404 response.
+        sig do
+          params(
+            page_number: Integer,
+            page_size: Integer,
+            page_snapshot: String,
+            token_group_id: String,
+            token_user_id: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(
+            Telnyx::Internal::DefaultFlatPagination[
+              Telnyx::LlmTokenGateway::TokenKey
+            ]
+          )
+        end
+        def list(
+          page_number: nil,
+          page_size: nil,
+          # Required after page 1; account/filter-bound 15-minute stable snapshot;
+          # expired/mismatch 409.
+          page_snapshot: nil,
+          token_group_id: nil,
+          token_user_id: nil,
+          request_options: {}
+        )
+        end
+
+        # Revoke this token key. Acknowledged revocation blocks new admissions with the
+        # key; requests already admitted may complete. Historical usage attribution is
+        # retained. Other keys in the group are unchanged.
+        sig do
+          params(
+            id: String,
+            idempotency_key: String,
+            if_match: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).void
+        end
+        def delete(
+          id,
+          # 24h, scoped by account+method+path. Same key/body returns same outcome; changed
+          # body 409; in-progress 409 with Retry-After. Token-create replay returns 200
+          # metadata WITHOUT secret.
+          idempotency_key:,
+          # Exact quoted resource-version ETag; an exact intermediary-weakened echo W/"n" is
+          # accepted. Wildcard, combined and malformed validators are rejected; stale 412;
+          # missing 428. HTTP field names are case-insensitive. Replayed idempotent result
+          # is checked first.
+          if_match:,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Telnyx::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/llm_token_gateway/usage.rbi

@@ -0,0 +1,90 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class LlmTokenGateway
+      # Manage and report AI Gateway usage.
+      class Usage
+        # Durable, replayable, content-free usage export for customer pipelines. Requires
+        # the dedicated llm_token_gateway.usage_export.read V2 action; spend.read and
+        # usage.read do not grant it. Records are inference.request (one per immutable
+        # ledger revision; a correction adds a new id with supersedes, keep the highest
+        # revision per request_id) and guardrail.evaluation (one per guardrail event,
+        # including blocked prompts with no inference record; correlate on request_id).
+        # Delivery is at least once in commit order: deduplicate on id. Records appear
+        # after settlement and after every older database transaction has finished
+        # (meta.horizon_lag_seconds); keep polling with next_cursor, which is always
+        # returned and is reusable after has_more is false. After a logical database
+        # restore, restart from start_time and deduplicate on id; a cursor from before it
+        # may return 409 cursor_expired (no Retry-After). Retention promise 30 days. No
+        # prompts, responses, provider credentials, supplier or customer rates. Gateway
+        # reference/enforcement usage, not invoice truth or BYOK provider charges.
+        sig do
+          params(
+            cursor: String,
+            limit: Integer,
+            start_time: Time,
+            types: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(
+            Telnyx::Models::LlmTokenGateway::UsageRetrieveExportResponse
+          )
+        end
+        def retrieve_export(
+          # Opaque next_cursor from a previous page; not combinable with start_time. Bound
+          # to the requested types; the account always comes from the credential.
+          cursor: nil,
+          limit: nil,
+          # First page only: RFC 3339 with offset, at most 30 days ago and not in the
+          # future; default now - 24h.
+          start_time: nil,
+          # Comma-separated subset of inference.request,guardrail.evaluation; default both.
+          types: nil,
+          request_options: {}
+        )
+        end
+
+        # Gateway reference/enforcement usage, not invoice truth or BYOK provider charges.
+        # Requires the dedicated llm_token_gateway.usage.read V2 action for combined spend
+        # and guardrail reporting; existing spend.read and guardrail_events.read grants do
+        # not grant this endpoint. All totals, UTC daily buckets, models and latest 20
+        # guardrail events share one database snapshot. UTC half-open dates, at most 31
+        # days. Zero-filled days; at most 1000 models (503 rather than truncation on
+        # overflow/timeout). Known tokens sum independently known categories across latest
+        # attempt evidence, including corrections; unknown spend is excluded and
+        # unknown_requests/reserved_spend remain explicit. Guardrail counts count events,
+        # not distinct requests. No raw spend events, prompts or secrets. This read-only
+        # report creates no pagination snapshot and accepts no pagination parameters.
+        sig do
+          params(
+            end_date: Date,
+            start_date: Date,
+            token_group_id: String,
+            metadata: T::Hash[Symbol, String],
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(
+            Telnyx::Models::LlmTokenGateway::UsageRetrieveSummaryResponse
+          )
+        end
+        def retrieve_summary(
+          end_date:,
+          start_date:,
+          token_group_id:,
+          # Request tag filters as metadata[<key>]=<value>, at most 5, combined with AND. A
+          # value matches the tag's text form exactly (booleans as true/false, integers in
+          # decimal), so metadata[flag]=true matches both boolean true and the string
+          # "true". Keys are case-sensitive; reserved-prefix keys are rejected. Unindexed:
+          # bounded by the account, the date range and the report timeout.
+          metadata: nil,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Telnyx::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/llm_token_gateway.rbi

@@ -0,0 +1,28 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class LlmTokenGateway
+      # Manage and report AI Gateway usage.
+      sig { returns(Telnyx::Resources::LlmTokenGateway::Usage) }
+      attr_reader :usage
+
+      # Manage and report AI Gateway usage.
+      sig { returns(Telnyx::Resources::LlmTokenGateway::Spend) }
+      attr_reader :spend
+
+      # Manage and report AI Gateway usage.
+      sig { returns(Telnyx::Resources::LlmTokenGateway::TokenGroups) }
+      attr_reader :token_groups
+
+      # Manage and report AI Gateway usage.
+      sig { returns(Telnyx::Resources::LlmTokenGateway::TokenKeys) }
+      attr_reader :token_keys
+
+      # @api private
+      sig { params(client: Telnyx::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/meeting_sessions.rbi

@@ -171,12 +171,12 @@ module Telnyx
       )
       end
 
-      # Irreversibly requests deletion of provider-hosted aggregate recording media
-      # under the provider contract. The operation retains the Telnyx-local Meeting
-      # session, transcript segments, events, artifacts, and usage records. It is
-      # separate from `DELETE /meeting_sessions/{id}`, which stops or cancels
-      # participation without deleting the persisted session. A missing/foreign session
-      # returns 404; provider deletion failures return 502.
+      # Irreversibly requests deletion of the aggregate recording media for the session.
+      # The operation retains the Telnyx-local Meeting session, transcript segments,
+      # events, artifacts, and usage records. It is separate from
+      # `DELETE /meeting_sessions/{id}`, which stops or cancels participation without
+      # deleting the persisted session. A missing/foreign session returns 404; provider
+      # deletion failures return 502.
       sig do
         params(
           id: String,

data/rbi/telnyx/resources/phone_numbers/jobs.rbi

@@ -21,9 +21,10 @@ module Telnyx
         end
 
         # Returns background jobs that operate on phone numbers. Filter by job type,
-        # target phone numbers, or job status, and sort by creation time. Multiple
-        # phone-number or status values use OR semantics within that filter; different
-        # filter categories use AND semantics. Results include pagination metadata.
+        # target phone numbers, job status, or creation-time customer reference, and sort
+        # by creation time. Multiple phone-number or status values use OR semantics within
+        # that filter; different filter categories use AND semantics. Results include
+        # pagination metadata.
         sig do
           params(
             filter: Telnyx::PhoneNumbers::JobListParams::Filter::OrHash,
@@ -39,7 +40,8 @@ module Telnyx
         end
         def list(
           # Consolidated filter parameter (deepObject style). Originally: filter[type],
-          # filter[phone_number], filter[phone_number][], filter[status][]
+          # filter[phone_number], filter[phone_number][], filter[status][],
+          # filter[customer_reference]
           filter: nil,
           page_number: nil,
           page_size: nil,