telnyx 5.156.0 → 5.157.0

data/rbi/telnyx/resources/requirements.rbi

@@ -8,12 +8,16 @@ module Telnyx
       sig do
         params(
           id: String,
+          version: Integer,
           request_options: Telnyx::RequestOptions::OrHash
         ).returns(Telnyx::Models::RequirementRetrieveResponse)
       end
       def retrieve(
         # Uniquely identifies the requirement_type record
         id,
+        # Filter by requirement version number. When omitted, returns the currently-active
+        # version.
+        version: nil,
         request_options: {}
       )
       end
@@ -25,6 +29,7 @@ module Telnyx
           page_number: Integer,
           page_size: Integer,
           sort: T::Array[Telnyx::RequirementListParams::Sort::OrSymbol],
+          version: Integer,
           request_options: Telnyx::RequestOptions::OrHash
         ).returns(
           Telnyx::Internal::DefaultFlatPagination[Telnyx::DocReqsRequirement]
@@ -39,6 +44,9 @@ module Telnyx
         # Consolidated sort parameter for requirements (deepObject style). Originally:
         # sort[]
         sort: nil,
+        # Filter by requirement version number. When omitted, returns the currently-active
+        # version.
+        version: nil,
         request_options: {}
       )
       end

data/rbi/telnyx/resources/storage/cloudfs/actions.rbi

@@ -0,0 +1,46 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class Storage
+      class Cloudfs
+        # Manage CloudFS filesystems — JuiceFS-compatible filesystems backed by Telnyx
+        # Cloud Storage
+        class Actions
+          # Issues a new metadata access token for the filesystem and returns the full
+          # filesystem, including the new `meta_token` and credential-bearing `meta_url`.
+          # The previous token stops authenticating immediately; the metadata database and
+          # S3 bucket are unchanged. The request takes no body. Allowed while the filesystem
+          # is `ready` or `needs_format`; otherwise returns a `409`. Retrying with the same
+          # `Idempotency-Key` within 24 hours replays the original response — including the
+          # same token — instead of rotating again.
+          sig do
+            params(
+              id: String,
+              idempotency_key: String,
+              request_options: Telnyx::RequestOptions::OrHash
+            ).returns(Telnyx::Storage::CloudfsFilesystemResponseWrapper)
+          end
+          def rotate_meta_token(
+            # CloudFS filesystem ID
+            id,
+            # Unique key that makes the request idempotent (1-255 characters: letters,
+            # numbers, `_`, and `-`). Retrying with the same key within 24 hours replays the
+            # original response (marked with an `Idempotent-Replayed: true` header) instead of
+            # repeating the action. Reusing a key with a different request returns a `422`;
+            # sending a key while the original request is still being processed returns a
+            # `409`.
+            idempotency_key:,
+            request_options: {}
+          )
+          end
+
+          # @api private
+          sig { params(client: Telnyx::Client).returns(T.attached_class) }
+          def self.new(client:)
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/telnyx/resources/storage/cloudfs.rbi

@@ -0,0 +1,152 @@
+# typed: strong
+
+module Telnyx
+  module Resources
+    class Storage
+      # Manage CloudFS filesystems — JuiceFS-compatible filesystems backed by Telnyx
+      # Cloud Storage
+      class Cloudfs
+        # Manage CloudFS filesystems — JuiceFS-compatible filesystems backed by Telnyx
+        # Cloud Storage
+        sig { returns(Telnyx::Resources::Storage::Cloudfs::Actions) }
+        attr_reader :actions
+
+        # Creates a CloudFS filesystem. Provisioning is synchronous — typically a few
+        # seconds, up to a few minutes — and the filesystem is returned with status
+        # `ready`, together with its S3 bucket and metadata connection details. This
+        # response is the only time the filesystem's `meta_token` — and the
+        # credential-bearing `meta_url` — are returned; store them securely. If the token
+        # is lost, issue a new one with the rotate-meta-token action. Names are unique
+        # within your organization: creating with an existing name returns a `422`.
+        # Requests are idempotent: retrying with the same `Idempotency-Key` within 24
+        # hours replays the original response instead of creating another filesystem.
+        sig do
+          params(
+            name: String,
+            region: Telnyx::Storage::CloudfCreateParams::Region::OrSymbol,
+            idempotency_key: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::Storage::CloudfsFilesystemResponseWrapper)
+        end
+        def create(
+          # Body param: Filesystem name, unique within your organization. Names are trimmed
+          # and lowercased; after normalization they may contain lowercase letters, numbers,
+          # `.`, `_`, and `-` only.
+          name:,
+          # Body param: Region where the filesystem's storage and metadata are provisioned.
+          region:,
+          # Header param: Unique key that makes the request idempotent (1-255 characters:
+          # letters, numbers, `_`, and `-`). Retrying with the same key within 24 hours
+          # replays the original response (marked with an `Idempotent-Replayed: true`
+          # header) instead of repeating the action. Reusing a key with a different request
+          # returns a `422`; sending a key while the original request is still being
+          # processed returns a `409`.
+          idempotency_key:,
+          request_options: {}
+        )
+        end
+
+        # Retrieves a CloudFS filesystem by its ID. The returned `meta_url` omits the
+        # credential — the metadata token is only ever returned by create and
+        # rotate-meta-token. A filesystem whose last lifecycle action failed includes a
+        # customer-safe `error` message.
+        sig do
+          params(
+            id: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::Storage::CloudfsFilesystemDetailResponseWrapper)
+        end
+        def retrieve(
+          # CloudFS filesystem ID
+          id,
+          request_options: {}
+        )
+        end
+
+        # Updates a CloudFS filesystem. Only `name` can be changed; other fields are
+        # immutable and unknown fields are rejected with a `400`. Renaming to a name that
+        # already exists in your organization returns a `422`.
+        sig do
+          params(
+            id: String,
+            name: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::Storage::CloudfsFilesystemDetailResponseWrapper)
+        end
+        def update(
+          # CloudFS filesystem ID
+          id,
+          # New filesystem name, unique within your organization. Names are trimmed and
+          # lowercased; after normalization they may contain lowercase letters, numbers,
+          # `.`, `_`, and `-` only.
+          name: nil,
+          request_options: {}
+        )
+        end
+
+        # Lists the CloudFS filesystems for the authenticated user's organization. Results
+        # use cursor-based pagination: fetch the next page by passing `meta.cursors.after`
+        # as `page[after]`, or follow the `meta.next` URL.
+        sig do
+          params(
+            filter_name: String,
+            filter_region: String,
+            filter_status:
+              Telnyx::Storage::CloudfListParams::FilterStatus::OrSymbol,
+            page_after: String,
+            page_before: String,
+            page_limit: Integer,
+            sort: Telnyx::Storage::CloudfListParams::Sort::OrSymbol,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::Models::Storage::CloudfListResponse)
+        end
+        def list(
+          # Return only the filesystem whose name matches exactly.
+          filter_name: nil,
+          # Return only filesystems in this region.
+          filter_region: nil,
+          # Return only filesystems with this status. Unrecognized values are ignored.
+          filter_status: nil,
+          # Opaque cursor from a previous response's `meta.cursors.after`; returns the page
+          # after it. Mutually exclusive with `page[before]`.
+          page_after: nil,
+          # Opaque cursor from a previous response's `meta.cursors.before`; returns the page
+          # before it. Mutually exclusive with `page[after]`.
+          page_before: nil,
+          # The number of filesystems to return per page. Values above 250 are treated
+          # as 250.
+          page_limit: nil,
+          # Sort order for the results: a field name for ascending, or the field name
+          # prefixed with `-` for descending.
+          sort: nil,
+          request_options: {}
+        )
+        end
+
+        # Permanently deletes a CloudFS filesystem, removing its S3 bucket and its
+        # metadata database. Deletion is synchronous: the response returns the
+        # filesystem's final state with status `deleted`. There is no restore. A
+        # filesystem that is still `provisioning` returns a `409`. If the filesystem still
+        # contains data, the request may be rejected with a `409` — drain the bucket and
+        # retry.
+        sig do
+          params(
+            id: String,
+            request_options: Telnyx::RequestOptions::OrHash
+          ).returns(Telnyx::Storage::CloudfsFilesystemDetailResponseWrapper)
+        end
+        def delete(
+          # CloudFS filesystem ID
+          id,
+          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/storage.rbi

@@ -20,6 +20,11 @@ module Telnyx
       sig { returns(Telnyx::Resources::Storage::Kvs) }
       attr_reader :kvs
 
+      # Manage CloudFS filesystems — JuiceFS-compatible filesystems backed by Telnyx
+      # Cloud Storage
+      sig { returns(Telnyx::Resources::Storage::Cloudfs) }
+      attr_reader :cloudfs
+
       # List Migration Source coverage
       sig do
         params(request_options: Telnyx::RequestOptions::OrHash).returns(

data/sig/telnyx/models/ai/anthropic/v1_messages_params.rbs

@@ -0,0 +1,175 @@
+module Telnyx
+  module Models
+    module AI
+      module Anthropic
+        type v1_messages_params =
+          {
+            max_tokens: Integer,
+            messages: ::Array[::Hash[Symbol, top]],
+            model: String,
+            api_key_ref: String,
+            billing_group_id: String,
+            fallback_config: ::Hash[Symbol, top],
+            max_retries: Integer,
+            mcp_servers: ::Array[::Hash[Symbol, top]],
+            metadata: ::Hash[Symbol, top],
+            service_tier: String,
+            stop_sequences: ::Array[String],
+            stream: bool,
+            system_: Telnyx::Models::AI::Anthropic::V1MessagesParams::system_,
+            temperature: Float,
+            thinking: ::Hash[Symbol, top],
+            timeout: Float,
+            tool_choice: ::Hash[Symbol, top],
+            tools: ::Array[::Hash[Symbol, top]],
+            top_k: Integer,
+            top_p: Float
+          }
+          & Telnyx::Internal::Type::request_parameters
+
+        class V1MessagesParams < Telnyx::Internal::Type::BaseModel
+          extend Telnyx::Internal::Type::RequestParameters::Converter
+          include Telnyx::Internal::Type::RequestParameters
+
+          attr_accessor max_tokens: Integer
+
+          attr_accessor messages: ::Array[::Hash[Symbol, top]]
+
+          attr_accessor model: String
+
+          attr_reader api_key_ref: String?
+
+          def api_key_ref=: (String) -> String
+
+          attr_reader billing_group_id: String?
+
+          def billing_group_id=: (String) -> String
+
+          attr_reader fallback_config: ::Hash[Symbol, top]?
+
+          def fallback_config=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
+
+          attr_reader max_retries: Integer?
+
+          def max_retries=: (Integer) -> Integer
+
+          attr_reader mcp_servers: ::Array[::Hash[Symbol, top]]?
+
+          def mcp_servers=: (
+            ::Array[::Hash[Symbol, top]]
+          ) -> ::Array[::Hash[Symbol, top]]
+
+          attr_reader metadata: ::Hash[Symbol, top]?
+
+          def metadata=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
+
+          attr_reader service_tier: String?
+
+          def service_tier=: (String) -> String
+
+          attr_reader stop_sequences: ::Array[String]?
+
+          def stop_sequences=: (::Array[String]) -> ::Array[String]
+
+          attr_reader stream: bool?
+
+          def stream=: (bool) -> bool
+
+          attr_reader system_: Telnyx::Models::AI::Anthropic::V1MessagesParams::system_?
+
+          def system_=: (
+            Telnyx::Models::AI::Anthropic::V1MessagesParams::system_
+          ) -> Telnyx::Models::AI::Anthropic::V1MessagesParams::system_
+
+          attr_reader temperature: Float?
+
+          def temperature=: (Float) -> Float
+
+          attr_reader thinking: ::Hash[Symbol, top]?
+
+          def thinking=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
+
+          attr_reader timeout: Float?
+
+          def timeout=: (Float) -> Float
+
+          attr_reader tool_choice: ::Hash[Symbol, top]?
+
+          def tool_choice=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
+
+          attr_reader tools: ::Array[::Hash[Symbol, top]]?
+
+          def tools=: (
+            ::Array[::Hash[Symbol, top]]
+          ) -> ::Array[::Hash[Symbol, top]]
+
+          attr_reader top_k: Integer?
+
+          def top_k=: (Integer) -> Integer
+
+          attr_reader top_p: Float?
+
+          def top_p=: (Float) -> Float
+
+          def initialize: (
+            max_tokens: Integer,
+            messages: ::Array[::Hash[Symbol, top]],
+            model: String,
+            ?api_key_ref: String,
+            ?billing_group_id: String,
+            ?fallback_config: ::Hash[Symbol, top],
+            ?max_retries: Integer,
+            ?mcp_servers: ::Array[::Hash[Symbol, top]],
+            ?metadata: ::Hash[Symbol, top],
+            ?service_tier: String,
+            ?stop_sequences: ::Array[String],
+            ?stream: bool,
+            ?system_: Telnyx::Models::AI::Anthropic::V1MessagesParams::system_,
+            ?temperature: Float,
+            ?thinking: ::Hash[Symbol, top],
+            ?timeout: Float,
+            ?tool_choice: ::Hash[Symbol, top],
+            ?tools: ::Array[::Hash[Symbol, top]],
+            ?top_k: Integer,
+            ?top_p: Float,
+            ?request_options: Telnyx::request_opts
+          ) -> void
+
+          def to_hash: -> {
+            max_tokens: Integer,
+            messages: ::Array[::Hash[Symbol, top]],
+            model: String,
+            api_key_ref: String,
+            billing_group_id: String,
+            fallback_config: ::Hash[Symbol, top],
+            max_retries: Integer,
+            mcp_servers: ::Array[::Hash[Symbol, top]],
+            metadata: ::Hash[Symbol, top],
+            service_tier: String,
+            stop_sequences: ::Array[String],
+            stream: bool,
+            system_: Telnyx::Models::AI::Anthropic::V1MessagesParams::system_,
+            temperature: Float,
+            thinking: ::Hash[Symbol, top],
+            timeout: Float,
+            tool_choice: ::Hash[Symbol, top],
+            tools: ::Array[::Hash[Symbol, top]],
+            top_k: Integer,
+            top_p: Float,
+            request_options: Telnyx::RequestOptions
+          }
+
+          type system_ = String | ::Array[::Hash[Symbol, top]]
+
+          module System
+            extend Telnyx::Internal::Type::Union
+
+            def self?.variants: -> ::Array[Telnyx::Models::AI::Anthropic::V1MessagesParams::system_]
+
+            UnionMember1Array: Telnyx::Internal::Type::Converter
+          end
+        end
+      end
+    end
+  end
+end

data/sig/telnyx/models/ai/anthropic/v1_messages_response.rbs

@@ -0,0 +1,11 @@
+module Telnyx
+  module Models
+    module AI
+      module Anthropic
+        type v1_messages_response = ::Hash[Symbol, top]
+
+        V1MessagesResponse: Telnyx::Internal::Type::Converter
+      end
+    end
+  end
+end

data/sig/telnyx/models/ai/assistant_tool.rbs

@@ -13,6 +13,7 @@ module Telnyx
         | Telnyx::AI::AssistantTool::SendDtmf
         | Telnyx::AI::AssistantTool::SendMessage
         | Telnyx::AI::AssistantTool::SkipTurn
+        | Telnyx::AI::AssistantTool::Pay
 
       module AssistantTool
         extend Telnyx::Internal::Type::Union
@@ -923,6 +924,18 @@ module Telnyx
           end
         end
 
+        type pay = { pay: Telnyx::AI::PayToolParams, type: :pay }
+
+        class Pay < Telnyx::Internal::Type::BaseModel
+          attr_accessor pay: Telnyx::AI::PayToolParams
+
+          attr_accessor type: :pay
+
+          def initialize: (pay: Telnyx::AI::PayToolParams, ?type: :pay) -> void
+
+          def to_hash: -> { pay: Telnyx::AI::PayToolParams, type: :pay }
+        end
+
         def self?.variants: -> ::Array[Telnyx::Models::AI::assistant_tool]
       end
     end

data/sig/telnyx/models/ai/conversations/conversation_insight_retrieve_aggregates_params.rbs

@@ -0,0 +1,74 @@
+module Telnyx
+  module Models
+    module AI
+      module Conversations
+        type conversation_insight_retrieve_aggregates_params =
+          {
+            created_at: String,
+            group_by: ::Array[String],
+            insight_id: String,
+            metadata: Telnyx::AI::Conversations::ConversationInsightRetrieveAggregatesParams::Metadata,
+            show: ::Array[String]
+          }
+          & Telnyx::Internal::Type::request_parameters
+
+        class ConversationInsightRetrieveAggregatesParams < Telnyx::Internal::Type::BaseModel
+          extend Telnyx::Internal::Type::RequestParameters::Converter
+          include Telnyx::Internal::Type::RequestParameters
+
+          attr_reader created_at: String?
+
+          def created_at=: (String) -> String
+
+          attr_reader group_by: ::Array[String]?
+
+          def group_by=: (::Array[String]) -> ::Array[String]
+
+          attr_reader insight_id: String?
+
+          def insight_id=: (String) -> String
+
+          attr_reader metadata: Telnyx::AI::Conversations::ConversationInsightRetrieveAggregatesParams::Metadata?
+
+          def metadata=: (
+            Telnyx::AI::Conversations::ConversationInsightRetrieveAggregatesParams::Metadata
+          ) -> Telnyx::AI::Conversations::ConversationInsightRetrieveAggregatesParams::Metadata
+
+          attr_reader show: ::Array[String]?
+
+          def show=: (::Array[String]) -> ::Array[String]
+
+          def initialize: (
+            ?created_at: String,
+            ?group_by: ::Array[String],
+            ?insight_id: String,
+            ?metadata: Telnyx::AI::Conversations::ConversationInsightRetrieveAggregatesParams::Metadata,
+            ?show: ::Array[String],
+            ?request_options: Telnyx::request_opts
+          ) -> void
+
+          def to_hash: -> {
+            created_at: String,
+            group_by: ::Array[String],
+            insight_id: String,
+            metadata: Telnyx::AI::Conversations::ConversationInsightRetrieveAggregatesParams::Metadata,
+            show: ::Array[String],
+            request_options: Telnyx::RequestOptions
+          }
+
+          type metadata = { assistant_id: String }
+
+          class Metadata < Telnyx::Internal::Type::BaseModel
+            attr_reader assistant_id: String?
+
+            def assistant_id=: (String) -> String
+
+            def initialize: (?assistant_id: String) -> void
+
+            def to_hash: -> { assistant_id: String }
+          end
+        end
+      end
+    end
+  end
+end

data/sig/telnyx/models/ai/conversations/conversation_insight_retrieve_aggregates_response.rbs

@@ -0,0 +1,34 @@
+module Telnyx
+  module Models
+    module AI
+      module Conversations
+        type conversation_insight_retrieve_aggregates_response =
+          {
+            data: ::Array[Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesResponse::Data]
+          }
+
+        class ConversationInsightRetrieveAggregatesResponse < Telnyx::Internal::Type::BaseModel
+          attr_accessor data: ::Array[Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesResponse::Data]
+
+          def initialize: (
+            data: ::Array[Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesResponse::Data]
+          ) -> void
+
+          def to_hash: -> {
+            data: ::Array[Telnyx::Models::AI::Conversations::ConversationInsightRetrieveAggregatesResponse::Data]
+          }
+
+          type data = { record_count: Integer }
+
+          class Data < Telnyx::Internal::Type::BaseModel
+            attr_accessor record_count: Integer
+
+            def initialize: (record_count: Integer) -> void
+
+            def to_hash: -> { record_count: Integer }
+          end
+        end
+      end
+    end
+  end
+end

data/sig/telnyx/models/ai/pay_tool_params.rbs

@@ -0,0 +1,41 @@
+module Telnyx
+  module Models
+    module AI
+      type pay_tool_params =
+        {
+          connector_name: String,
+          currency: String,
+          description: String?,
+          payment_method: String
+        }
+
+      class PayToolParams < Telnyx::Internal::Type::BaseModel
+        attr_accessor connector_name: String
+
+        attr_reader currency: String?
+
+        def currency=: (String) -> String
+
+        attr_accessor description: String?
+
+        attr_reader payment_method: String?
+
+        def payment_method=: (String) -> String
+
+        def initialize: (
+          connector_name: String,
+          ?currency: String,
+          ?description: String?,
+          ?payment_method: String
+        ) -> void
+
+        def to_hash: -> {
+          connector_name: String,
+          currency: String,
+          description: String?,
+          payment_method: String
+        }
+      end
+    end
+  end
+end

data/sig/telnyx/models/ai/tool_create_params.rbs

@@ -9,6 +9,7 @@ module Telnyx
           function: ::Hash[Symbol, top],
           handoff: ::Hash[Symbol, top],
           invite: ::Hash[Symbol, top],
+          pay: Telnyx::AI::PayToolParams,
           retrieval: ::Hash[Symbol, top],
           timeout_ms: Integer,
           webhook: ::Hash[Symbol, top]
@@ -39,6 +40,10 @@ module Telnyx
 
         def invite=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
 
+        attr_reader pay: Telnyx::AI::PayToolParams?
+
+        def pay=: (Telnyx::AI::PayToolParams) -> Telnyx::AI::PayToolParams
+
         attr_reader retrieval: ::Hash[Symbol, top]?
 
         def retrieval=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
@@ -58,6 +63,7 @@ module Telnyx
           ?function: ::Hash[Symbol, top],
           ?handoff: ::Hash[Symbol, top],
           ?invite: ::Hash[Symbol, top],
+          ?pay: Telnyx::AI::PayToolParams,
           ?retrieval: ::Hash[Symbol, top],
           ?timeout_ms: Integer,
           ?webhook: ::Hash[Symbol, top],
@@ -71,6 +77,7 @@ module Telnyx
           function: ::Hash[Symbol, top],
           handoff: ::Hash[Symbol, top],
           invite: ::Hash[Symbol, top],
+          pay: Telnyx::AI::PayToolParams,
           retrieval: ::Hash[Symbol, top],
           timeout_ms: Integer,
           webhook: ::Hash[Symbol, top],

data/sig/telnyx/models/ai/tool_update_params.rbs

@@ -9,6 +9,7 @@ module Telnyx
           function: ::Hash[Symbol, top],
           handoff: ::Hash[Symbol, top],
           invite: ::Hash[Symbol, top],
+          pay: Telnyx::AI::PayToolParams,
           retrieval: ::Hash[Symbol, top],
           timeout_ms: Integer,
           type: String,
@@ -42,6 +43,10 @@ module Telnyx
 
         def invite=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
 
+        attr_reader pay: Telnyx::AI::PayToolParams?
+
+        def pay=: (Telnyx::AI::PayToolParams) -> Telnyx::AI::PayToolParams
+
         attr_reader retrieval: ::Hash[Symbol, top]?
 
         def retrieval=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
@@ -65,6 +70,7 @@ module Telnyx
           ?function: ::Hash[Symbol, top],
           ?handoff: ::Hash[Symbol, top],
           ?invite: ::Hash[Symbol, top],
+          ?pay: Telnyx::AI::PayToolParams,
           ?retrieval: ::Hash[Symbol, top],
           ?timeout_ms: Integer,
           ?type: String,
@@ -79,6 +85,7 @@ module Telnyx
           function: ::Hash[Symbol, top],
           handoff: ::Hash[Symbol, top],
           invite: ::Hash[Symbol, top],
+          pay: Telnyx::AI::PayToolParams,
           retrieval: ::Hash[Symbol, top],
           timeout_ms: Integer,
           type: String,