sentdm 0.39.0 → 0.40.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e41c64a8341791db8801e49a4450c5631344d953d37ea8de82e1f734f7cfd06
-  data.tar.gz: c71e0a7f614f260ac4f68e410a49049f0a3315bc2823e32af7413b6d5d484e1c
+  metadata.gz: b0fe2b102d0383035abaeca878cfc21c6ca248654c43cd778b525ebc7c3f2ad5
+  data.tar.gz: f581f11fa8a55d391fcc1ee01958b359fec4562bc58702060db9c598d4d6f1a4
 SHA512:
-  metadata.gz: '0783884c3912784e4b10961fbaf990d3908c1a95949a76b4cdd559c9e08d1d35cc5d4e614249de86f9906cd9954d5bc0e611273fd4a44cd272ba7a22b8b9f329'
-  data.tar.gz: f229587522eb6b177f69ba05866180ab32183d968b52995e51d39e97f77437a457608b720b7e09fbe163d411fac7754c1c40335274e97b6f3c66df98fc0cd9f8
+  metadata.gz: f337dcafa200de5fb45bc924339b2a0b07179a2bf531fee5535ac38ffcea924e35612892a4a9a9c96fc31ebbd2e398a630aa7ef41c67d67179b83c58fa456fc3
+  data.tar.gz: '0878a20b5965654dfcd33ef5a39d34e1631d9d7591b073bf2c75a3ac0a69c49f4868eb169f8fe5d75bce928111c9a0ee4af1f3e14fd2ec0dcc2d6bd7c728c4d5'

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [0.40.0](https://github.com/sentdm/sent-dm-ruby/compare/v0.39.0...v0.40.0) (2026-10-28)
+
+
+### Features
+
+* **api:** add voice agents, the voice catalogue and agent_id ([abd31b9](https://github.com/sentdm/sent-dm-ruby/commit/abd31b96b520c10bd3ac67bb1c2b243c3a75b5fd))
+* **api:** sync generated SDKs from the committed spec ([30477ca](https://github.com/sentdm/sent-dm-ruby/commit/30477cacd760dccdf6ce8c5112267d75197746a6))
+* **api:** sync OpenAPI spec from production ([fa5b9f1](https://github.com/sentdm/sent-dm-ruby/commit/fa5b9f12f44e770a7aa6f2382585755fd9935acf))
+
 ## [0.39.0](https://github.com/sentdm/sent-dm-ruby/compare/v0.38.1...v0.39.0) (2026-10-23)
 
 

data/README.md

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

data/lib/sentdm/internal/voice_agents_page.rb

@@ -0,0 +1,115 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Internal
+    # @generic Elem
+    #
+    # @example
+    #   if voice_agents_page.has_next?
+    #     voice_agents_page = voice_agents_page.next_page
+    #   end
+    #
+    # @example
+    #   voice_agents_page.auto_paging_each do |agent|
+    #     puts(agent)
+    #   end
+    class VoiceAgentsPage
+      include Sentdm::Internal::Type::BasePage
+
+      # @return [Data]
+      attr_accessor :data
+
+      # @return [Boolean]
+      def next_page?
+        data&.pagination&.has_more
+      end
+
+      # @raise [Sentdm::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 = Sentdm::Internal::Util.deep_merge(
+          @req,
+          {query: {page: @req.fetch(:query).fetch(:page, 1).to_i.succ}}
+        )
+        @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&.agents&.each(&blk)
+
+          break unless page.next_page?
+          page = page.next_page
+        end
+      end
+
+      # @api private
+      #
+      # @param client [Sentdm::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: Hash | nil => data}
+          if (agents = data[:agents]).is_a?(Array)
+            data = {**data, agents: agents.map { Sentdm::Internal::Type::Converter.coerce(@model, _1) }}
+          end
+          @data = Sentdm::Internal::Type::Converter.coerce(Sentdm::Internal::VoiceAgentsPage::Data, data)
+        else
+        end
+      end
+
+      # @api private
+      #
+      # @return [String]
+      def inspect
+        model = Sentdm::Internal::Type::Converter.inspect(@model, depth: 1)
+
+        "#<#{self.class}[#{model}]:0x#{object_id.to_s(16)}>"
+      end
+
+      class Data < Sentdm::Internal::Type::BaseModel
+        # @!attribute agents
+        #
+        #   @return [Array<Object>, nil]
+        optional :agents, Sentdm::Internal::Type::ArrayOf[Sentdm::Internal::Type::Unknown]
+
+        # @!attribute pagination
+        #
+        #   @return [Data::Pagination, nil]
+        optional :pagination, -> { Data::Pagination }
+
+        # @!method initialize(agents: nil, pagination: nil)
+        #   @param agents [Array<Object>]
+        #   @param pagination [Data::Pagination]
+
+        # @see Data#pagination
+        class Pagination < Sentdm::Internal::Type::BaseModel
+          # @!attribute has_more
+          #
+          #   @return [Boolean, nil]
+          optional :has_more, Sentdm::Internal::Type::Boolean
+
+          # @!method initialize(has_more: nil)
+          #   @param has_more [Boolean]
+        end
+      end
+    end
+  end
+end

data/lib/sentdm/models/call_event.rb

@@ -19,15 +19,17 @@ module Sentdm
       optional :field, String
 
       # @!attribute payload
-      #   Body of a call.initiated, call.answered, call.completed, call.failed or
-      #   call.recording_ready event. Which of them occurred is the envelope's event.
+      #   Body of a call.initiated, call.answered, call.agent_connected, call.completed,
+      #   call.failed or call.recording_ready event. Which of them occurred is the
+      #   envelope's event.
       #
       #   Shaped like the message, inbound, template and channel payloads: account_id
       #   names the account the event is about, channel names the channel, and updated_at
       #   is when the change happened on the call, in the same yyyy-MM-ddTHH:mm:ssZ form.
-      #   duration_seconds and price are added on call.completed, reason on call.failed
-      #   and recording_id on call.recording_ready; each is omitted rather than sent as
-      #   null when it does not apply.
+      #   Every event says how the call is handled in mode, and an agent call names its
+      #   agent in agent_id. duration_seconds and price are added on call.completed,
+      #   reason on call.failed and recording_id on call.recording_ready; each is omitted
+      #   rather than sent as null when it does not apply.
       #
       #   Casing is snake_case because these ride the same webhook stream customers
       #   already parse message_id from; the question/answer contract is a separate
@@ -62,7 +64,7 @@ module Sentdm
       #
       #   @param field [String] The event family, for example message, templates or contact. Route on
       #
-      #   @param payload [Sentdm::Models::CallEventPayload, nil] Body of a call.initiated, call.answered, call.completed, call.failed
+      #   @param payload [Sentdm::Models::CallEventPayload, nil] Body of a call.initiated, call.answered, call.agent_connected, call.completed,
       #
       #   @param request_id [String, nil] The event-specific body.
       #

data/lib/sentdm/models/call_event_payload.rb

@@ -16,6 +16,12 @@ module Sentdm
       #   @return [String, nil]
       optional :account_id, String
 
+      # @!attribute agent_id
+      #   The voice agent that answers the call, agent\_…. Only on an agent call.
+      #
+      #   @return [String, nil]
+      optional :agent_id, String, nil?: true
+
       # @!attribute channel
       #   Always voice.
       #
@@ -28,6 +34,13 @@ module Sentdm
       #   @return [Integer, nil]
       optional :duration_seconds, Integer, nil?: true
 
+      # @!attribute mode
+      #   inapp, a call routed by the number's callback URL, or agent, a call one of the
+      #   account's voice agents answers. The same value GET /v3/voice/calls returns.
+      #
+      #   @return [String, nil]
+      optional :mode, String
+
       # @!attribute number
       #   The customer number that owns the call, in E.164 format.
       #
@@ -62,19 +75,21 @@ module Sentdm
       #   @return [String, nil]
       optional :updated_at, String
 
-      # @!method initialize(call_id:, account_id: nil, channel: nil, duration_seconds: nil, number: nil, price: nil, reason: nil, recording_id: nil, updated_at: nil)
+      # @!method initialize(call_id:, account_id: nil, agent_id: nil, channel: nil, duration_seconds: nil, mode: nil, number: nil, price: nil, reason: nil, recording_id: nil, updated_at: nil)
       #   Some parameter documentations has been truncated, see
       #   {Sentdm::Models::CallEventPayload} for more details.
       #
-      #   Body of a call.initiated, call.answered, call.completed, call.failed or
-      #   call.recording_ready event. Which of them occurred is the envelope's event.
+      #   Body of a call.initiated, call.answered, call.agent_connected, call.completed,
+      #   call.failed or call.recording_ready event. Which of them occurred is the
+      #   envelope's event.
       #
       #   Shaped like the message, inbound, template and channel payloads: account_id
       #   names the account the event is about, channel names the channel, and updated_at
       #   is when the change happened on the call, in the same yyyy-MM-ddTHH:mm:ssZ form.
-      #   duration_seconds and price are added on call.completed, reason on call.failed
-      #   and recording_id on call.recording_ready; each is omitted rather than sent as
-      #   null when it does not apply.
+      #   Every event says how the call is handled in mode, and an agent call names its
+      #   agent in agent_id. duration_seconds and price are added on call.completed,
+      #   reason on call.failed and recording_id on call.recording_ready; each is omitted
+      #   rather than sent as null when it does not apply.
       #
       #   Casing is snake_case because these ride the same webhook stream customers
       #   already parse message_id from; the question/answer contract is a separate
@@ -85,10 +100,14 @@ module Sentdm
       #
       #   @param account_id [String] The account the call belongs to: the key's own customer, or the sender profile i
       #
+      #   @param agent_id [String, nil] The voice agent that answers the call, agent\_…. Only on an agent call.
+      #
       #   @param channel [String] Always voice.
       #
       #   @param duration_seconds [Integer, nil] How long the call lasted. Only on call.completed.
       #
+      #   @param mode [String] inapp, a call routed by the number's callback URL, or agent, a call one of the a
+      #
       #   @param number [String] The customer number that owns the call, in E.164 format.
       #
       #   @param price [Float, nil] What the call was charged. Only on call.completed, and omitted there until billi

data/lib/sentdm/models/channels/voice_create_params.rb

@@ -8,16 +8,15 @@ module Sentdm
         extend Sentdm::Internal::Type::RequestParameters::Converter
         include Sentdm::Internal::Type::RequestParameters
 
-        # @!attribute callback_url
-        #   Where Sent asks what to do with each call on this number: an absolute HTTP or
-        #   HTTPS URL on a public host. A signed question is POSTed here when a call arrives
-        #   or a caller presses a key, and the answer decides the call. Every question is
-        #   signed with the callback_secret the response returns, the same way your webhooks
-        #   are signed. Turning the number on again with a different URL replaces it and
-        #   keeps the secret.
+        # @!attribute agent_id
+        #   One of your voice agents (GET /v3/voice/agents), such as
+        #   agent_9f2ab000-0000-4000-8000-000000000001, to answer calls to this number. It
+        #   wins over callback_url for calls to the number, and both may be sent; calls your
+        #   app places from the number still follow your app. Send it instead of
+        #   callback_url for a number only an agent answers.
         #
-        #   @return [String]
-        required :callback_url, String
+        #   @return [String, nil]
+        optional :agent_id, String, nil?: true
 
         # @!attribute area_code
         #   The US area code a new number should be in, as 212. Only for a request that
@@ -28,6 +27,17 @@ module Sentdm
         #   @return [String, nil]
         optional :area_code, String, nil?: true
 
+        # @!attribute callback_url
+        #   Where Sent asks what to do with each call on this number: an absolute HTTP or
+        #   HTTPS URL on a public host. A signed question is POSTed here when a call arrives
+        #   or a caller presses a key, and the answer decides the call. Every question is
+        #   signed with the callback_secret the response returns, the same way your webhooks
+        #   are signed. Turning the number on again with a different URL replaces it and
+        #   keeps the secret. Required unless agent_id is sent.
+        #
+        #   @return [String, nil]
+        optional :callback_url, String, nil?: true
+
         # @!attribute default_for_app_calls
         #   Make this the line app-originated calls are placed from when a voice token names
         #   no number. Omit it and your first voice number takes that role; a later one
@@ -61,14 +71,16 @@ module Sentdm
         #   @return [String, nil]
         optional :x_profile_id, String
 
-        # @!method initialize(callback_url:, area_code: nil, default_for_app_calls: nil, number: nil, sandbox: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
+        # @!method initialize(agent_id: nil, area_code: nil, callback_url: nil, default_for_app_calls: nil, number: nil, sandbox: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Sentdm::Models::Channels::VoiceCreateParams} for more details.
         #
-        #   @param callback_url [String] Where Sent asks what to do with each call on this number: an absolute HTTP or HT
+        #   @param agent_id [String, nil] One of your voice agents (GET /v3/voice/agents), such as
         #
         #   @param area_code [String, nil] The US area code a new number should be in, as 212. Only for a request that leav
         #
+        #   @param callback_url [String, nil] Where Sent asks what to do with each call on this number: an absolute HTTP or HT
+        #
         #   @param default_for_app_calls [Boolean, nil] Make this the line app-originated calls are placed from when a voice token names
         #
         #   @param number [String, nil] One of your phone numbers, in E.164 format. Leave the field out entirely to be g

data/lib/sentdm/models/channels/voice_number.rb

@@ -4,6 +4,15 @@ module Sentdm
   module Models
     module Channels
       class VoiceNumber < Sentdm::Internal::Type::BaseModel
+        # @!attribute agent_id
+        #   The voice agent calls to this number go to, such as
+        #   agent_9f2ab000-0000-4000-8000-000000000001. It wins over callback_url for calls
+        #   to the number; calls your app places from the number still follow your app. Null
+        #   when no agent answers the number.
+        #
+        #   @return [String, nil]
+        optional :agent_id, String, nil?: true
+
         # @!attribute callback_url
         #   Where Sent asks what to do with each call on this number: a signed question is
         #   POSTed here when a call arrives or a caller presses a key, and the answer
@@ -32,6 +41,15 @@ module Sentdm
         #   @return [String, nil]
         optional :number, String
 
+        # @!attribute routes_to
+        #   Who answers calls to this number: agent, the voice agent in agent_id;
+        #   agent_pending, that agent once the number has finished moving to it, with calls
+        #   possibly unanswered until then; callback, your callback_url; or none, in which
+        #   case calls to it are declined.
+        #
+        #   @return [String, nil]
+        optional :routes_to, String
+
         # @!attribute status
         #   ACTIVE while the number carries calls, INACTIVE once it was turned off. Nothing
         #   provisions: a number the customer holds can carry calls the moment voice is
@@ -45,12 +63,14 @@ module Sentdm
         #   @return [Time, nil]
         optional :updated_at, Time
 
-        # @!method initialize(callback_url: nil, created_at: nil, default_for_app_calls: nil, number: nil, status: nil, updated_at: nil)
+        # @!method initialize(agent_id: nil, callback_url: nil, created_at: nil, default_for_app_calls: nil, number: nil, routes_to: nil, status: nil, updated_at: nil)
         #   Some parameter documentations has been truncated, see
         #   {Sentdm::Models::Channels::VoiceNumber} for more details.
         #
         #   One number the profile carries phone calls on.
         #
+        #   @param agent_id [String, nil] The voice agent calls to this number go to, such as agent_9f2ab000-0000-4000-800
+        #
         #   @param callback_url [String, nil] Where Sent asks what to do with each call on this number: a signed question is P
         #
         #   @param created_at [Time]
@@ -59,6 +79,8 @@ module Sentdm
         #
         #   @param number [String] The number, in E.164.
         #
+        #   @param routes_to [String] Who answers calls to this number: agent, the voice agent in agent_id;
+        #
         #   @param status [String] ACTIVE while the number carries calls, INACTIVE once it was turned off. Nothing
         #
         #   @param updated_at [Time]

data/lib/sentdm/models/channels/voice_update_params.rb

@@ -13,6 +13,15 @@ module Sentdm
         #   @return [String]
         required :number, String
 
+        # @!attribute agent_id
+        #   One of your voice agents, such as agent_9f2ab000-0000-4000-8000-000000000001, to
+        #   answer calls to the number, or null to unbind it so the callback URL answers
+        #   them again. The agent wins over callback_url for calls to the number; calls your
+        #   app places from it still follow your app.
+        #
+        #   @return [String, nil]
+        optional :agent_id, String, nil?: true
+
         # @!attribute callback_url
         #   A new callback URL for the number, active or not: an absolute HTTP or HTTPS URL
         #   on a public host, where Sent asks what to do with each call. The signing secret
@@ -54,12 +63,14 @@ module Sentdm
         #   @return [String, nil]
         optional :x_profile_id, String
 
-        # @!method initialize(number:, callback_url: nil, default_for_app_calls: nil, sandbox: nil, status: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
+        # @!method initialize(number:, agent_id: nil, callback_url: nil, default_for_app_calls: nil, sandbox: nil, status: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
         #   Some parameter documentations has been truncated, see
         #   {Sentdm::Models::Channels::VoiceUpdateParams} for more details.
         #
         #   @param number [String]
         #
+        #   @param agent_id [String, nil] One of your voice agents, such as agent_9f2ab000-0000-4000-8000-000000000001, to
+        #
         #   @param callback_url [String, nil] A new callback URL for the number, active or not: an absolute HTTP or HTTPS URL
         #
         #   @param default_for_app_calls [Boolean, nil] true makes this the line app-originated calls are placed from when a voice token

data/lib/sentdm/models/voice/agent_create_params.rb

@@ -0,0 +1,142 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    module Voice
+      # @see Sentdm::Resources::Voice::Agents#create
+      class AgentCreateParams < Sentdm::Internal::Type::BaseModel
+        extend Sentdm::Internal::Type::RequestParameters::Converter
+        include Sentdm::Internal::Type::RequestParameters
+
+        # @!attribute audio
+        #   Audio sessions only: the sound format.
+        #
+        #   @return [Sentdm::Models::Voice::VoiceAgentAudioSpec, nil]
+        optional :audio, -> { Sentdm::Voice::VoiceAgentAudioSpec }, nil?: true
+
+        # @!attribute fallback
+        #   Who takes the call when the agent cannot: a phone number (kind: number). Omit it
+        #   and such a call hangs up.
+        #
+        #   @return [Sentdm::Models::Voice::VoiceAgentPartySpec, nil]
+        optional :fallback, -> { Sentdm::Voice::VoiceAgentPartySpec }, nil?: true
+
+        # @!attribute greeting
+        #   Text sessions only: what the caller hears as soon as the call is answered,
+        #   before the agent's first turn. 1 to 4,096 characters. Omit it and the agent
+        #   speaks first.
+        #
+        #   @return [String, nil]
+        optional :greeting, String, nil?: true
+
+        # @!attribute limits
+        #
+        #   @return [Sentdm::Models::Voice::VoiceAgentLimitsSpec, nil]
+        optional :limits, -> { Sentdm::Voice::VoiceAgentLimitsSpec }, nil?: true
+
+        # @!attribute name
+        #   A name for your own reference, 1 to 100 characters.
+        #
+        #   @return [String, nil]
+        optional :name, String, nil?: true
+
+        # @!attribute sandbox
+        #   Sandbox flag - when true, the operation is simulated without side effects Useful
+        #   for testing integrations without actual execution
+        #
+        #   @return [Boolean, nil]
+        optional :sandbox, Sentdm::Internal::Type::Boolean
+
+        # @!attribute session_type
+        #   text: Sent turns the caller's speech into text and the agent's text into speech,
+        #   so the agent exchanges text frames. audio: the agent receives and sends the
+        #   sound itself.
+        #
+        #   @return [String, nil]
+        optional :session_type, String, nil?: true
+
+        # @!attribute speech
+        #   Text sessions only: how the caller is spoken to and listened to.
+        #
+        #   @return [Sentdm::Models::Voice::VoiceAgentSpeechSpec, nil]
+        optional :speech, -> { Sentdm::Voice::VoiceAgentSpeechSpec }, nil?: true
+
+        # @!attribute tools
+        #   What the agent may do to the call: any of transfer, hangup, send_dtmf and hold.
+        #   Default ["hangup"]. transfer needs at least one transfer_targets entry.
+        #
+        #   @return [Array<String>, nil]
+        optional :tools, Sentdm::Internal::Type::ArrayOf[String], nil?: true
+
+        # @!attribute transcripts
+        #
+        #   @return [Sentdm::Models::Voice::VoiceAgentTranscriptsSpec, nil]
+        optional :transcripts, -> { Sentdm::Voice::VoiceAgentTranscriptsSpec }, nil?: true
+
+        # @!attribute transfer_targets
+        #   Where the agent may transfer a call to, up to 20 parties: a phone number (kind:
+        #   number, E.164), one of your app users (kind: user, the identity) or another of
+        #   your agents (kind: agent, its id). The agent can only transfer to a party listed
+        #   here.
+        #
+        #   @return [Array<Sentdm::Models::Voice::VoiceAgentPartySpec>, nil]
+        optional :transfer_targets,
+                 -> { Sentdm::Internal::Type::ArrayOf[Sentdm::Voice::VoiceAgentPartySpec] },
+                 nil?: true
+
+        # @!attribute websocket_url
+        #   Where the gateway connects to the agent for each call: an absolute wss:// URL on
+        #   a public host, at most 2,048 characters. The handshake is signed with the
+        #   agent's signing_secret. Leave it out and the agent dials in instead, connecting
+        #   to the gateway with your API key.
+        #
+        #   @return [String, nil]
+        optional :websocket_url, String, nil?: true
+
+        # @!attribute idempotency_key
+        #
+        #   @return [String, nil]
+        optional :idempotency_key, String
+
+        # @!attribute x_profile_id
+        #
+        #   @return [String, nil]
+        optional :x_profile_id, String
+
+        # @!method initialize(audio: nil, fallback: nil, greeting: nil, limits: nil, name: nil, sandbox: nil, session_type: nil, speech: nil, tools: nil, transcripts: nil, transfer_targets: nil, websocket_url: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Sentdm::Models::Voice::AgentCreateParams} for more details.
+        #
+        #   @param audio [Sentdm::Models::Voice::VoiceAgentAudioSpec, nil] Audio sessions only: the sound format.
+        #
+        #   @param fallback [Sentdm::Models::Voice::VoiceAgentPartySpec, nil] Who takes the call when the agent cannot: a phone number (kind: number). Omit it
+        #
+        #   @param greeting [String, nil] Text sessions only: what the caller hears as soon as the call is answered, befor
+        #
+        #   @param limits [Sentdm::Models::Voice::VoiceAgentLimitsSpec, nil]
+        #
+        #   @param name [String, nil] A name for your own reference, 1 to 100 characters.
+        #
+        #   @param sandbox [Boolean] Sandbox flag - when true, the operation is simulated without side effects
+        #
+        #   @param session_type [String, nil] text: Sent turns the caller's speech into text and the agent's text into speech,
+        #
+        #   @param speech [Sentdm::Models::Voice::VoiceAgentSpeechSpec, nil] Text sessions only: how the caller is spoken to and listened to.
+        #
+        #   @param tools [Array<String>, nil] What the agent may do to the call: any of transfer, hangup, send_dtmf and
+        #
+        #   @param transcripts [Sentdm::Models::Voice::VoiceAgentTranscriptsSpec, nil]
+        #
+        #   @param transfer_targets [Array<Sentdm::Models::Voice::VoiceAgentPartySpec>, nil] Where the agent may transfer a call to, up to 20 parties: a phone number (kind:
+        #
+        #   @param websocket_url [String, nil] Where the gateway connects to the agent for each call: an absolute wss:// URL on
+        #
+        #   @param idempotency_key [String]
+        #
+        #   @param x_profile_id [String]
+        #
+        #   @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/sentdm/models/voice/agent_delete_params.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    module Voice
+      # @see Sentdm::Resources::Voice::Agents#delete
+      class AgentDeleteParams < Sentdm::Models::MutationRequest
+        extend Sentdm::Internal::Type::RequestParameters::Converter
+        include Sentdm::Internal::Type::RequestParameters
+
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute x_profile_id
+        #
+        #   @return [String, nil]
+        optional :x_profile_id, String
+
+        # @!method initialize(id:, x_profile_id: nil, request_options: {})
+        #   @param id [String]
+        #   @param x_profile_id [String]
+        #   @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/sentdm/models/voice/agent_list_params.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    module Voice
+      # @see Sentdm::Resources::Voice::Agents#list
+      class AgentListParams < Sentdm::Internal::Type::BaseModel
+        extend Sentdm::Internal::Type::RequestParameters::Converter
+        include Sentdm::Internal::Type::RequestParameters
+
+        # @!attribute page
+        #   Page number, from 1
+        #
+        #   @return [Integer, nil]
+        optional :page, Integer
+
+        # @!attribute page_size
+        #
+        #   @return [Integer, nil]
+        optional :page_size, Integer
+
+        # @!attribute x_profile_id
+        #
+        #   @return [String, nil]
+        optional :x_profile_id, String
+
+        # @!method initialize(page: nil, page_size: nil, x_profile_id: nil, request_options: {})
+        #   @param page [Integer] Page number, from 1
+        #
+        #   @param page_size [Integer]
+        #
+        #   @param x_profile_id [String]
+        #
+        #   @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/sentdm/models/voice/agent_retrieve_params.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Sentdm
+  module Models
+    module Voice
+      # @see Sentdm::Resources::Voice::Agents#retrieve
+      class AgentRetrieveParams < Sentdm::Internal::Type::BaseModel
+        extend Sentdm::Internal::Type::RequestParameters::Converter
+        include Sentdm::Internal::Type::RequestParameters
+
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute x_profile_id
+        #
+        #   @return [String, nil]
+        optional :x_profile_id, String
+
+        # @!method initialize(id:, x_profile_id: nil, request_options: {})
+        #   @param id [String]
+        #   @param x_profile_id [String]
+        #   @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end