zavudev 0.20.0 → 0.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c816f9f292a722353051f15021fa10ecd35fa46e4c9875dd7233413793fe35b8
-  data.tar.gz: 06105ce64497bd6c8880a5faba2149ae0e666a931eab453bd89461bb133a97e2
+  metadata.gz: b6c0046a2e3e6d5ef6c75f49f376be617b8cc23977d31cde1354f3867de7611d
+  data.tar.gz: 9fe46905d1076d2566e428d32979f572f948846b163f7bb228186cf6c279f6b7
 SHA512:
-  metadata.gz: acad7a45105f7224f636557539bddd3d1de2906b5ba7fc5b8986aeae84dc939507d44649d4f7c79f1c03a137e9d3170f76418c12a9eb5df41c118b174abc0c4c
-  data.tar.gz: 3c894b958050647adc91b001bbec1b21212f9de083f7211a4cdbf04cac3b108b11436fc892fa3aa790b879dea34f1c649ceca890828e6df7dec4daf91b270438
+  metadata.gz: 9aecd6968d8709ac8d5339e0ed5c180bd2d988d555373391ebea5c2a434ff6409ad517c4a2c78c57e83f856055cbb43a2bf0a8439acd9b74d1fc2c2c78852dbb
+  data.tar.gz: 3ae35d71a8b181f3ff0b820c64374b1bfcff7ae89a467fe0e73e1a701b34130ddc49d815491f74521b9822469cc607c5ebcb40cf6dda5e53705aa6aee8d96613

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.21.0 (2026-09-08)
+
+Full Changelog: [v0.20.0...v0.21.0](https://github.com/zavudev/sdk-ruby/compare/v0.20.0...v0.21.0)
+
+### Features
+
+* **api:** api update ([db09b0f](https://github.com/zavudev/sdk-ruby/commit/db09b0f45fa26cdc9ef2ba1424ce5842523dc93d))
+* **api:** api update ([4770bcf](https://github.com/zavudev/sdk-ruby/commit/4770bcfeaac29d10aee8c07e912a852e20b7586c))
+* **api:** api update ([4dd9bd1](https://github.com/zavudev/sdk-ruby/commit/4dd9bd16d0984ca18b228ad0e857db573a5cd444))
+* **api:** api update ([c22d5f2](https://github.com/zavudev/sdk-ruby/commit/c22d5f2e1830e823b653b8ff46eb4abb4021832f))
+* **api:** api update ([7dd2286](https://github.com/zavudev/sdk-ruby/commit/7dd2286c0d534729ba105579ccfa2910368de335))
+* **api:** api update ([0a81358](https://github.com/zavudev/sdk-ruby/commit/0a813584f16f93728514cab57cd3c1e814f45044))
+* **api:** api update ([8f1f608](https://github.com/zavudev/sdk-ruby/commit/8f1f6083aff8b3568b7b7841f496e6dcd7076475))
+* **api:** api update ([c919d2a](https://github.com/zavudev/sdk-ruby/commit/c919d2a0db7c65ce8e53dfa329b42111e0afa123))
+* **api:** manual updates ([83ed616](https://github.com/zavudev/sdk-ruby/commit/83ed616d532968a4b64a248b6efeb870c383c417))
+
 ## 0.20.0 (2026-08-11)
 
 Full Changelog: [v0.19.0...v0.20.0](https://github.com/zavudev/sdk-ruby/compare/v0.19.0...v0.20.0)

data/README.md

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

data/lib/zavudev/client.rb

@@ -66,6 +66,21 @@ module Zavudev
     # @return [Zavudev::Resources::Functions]
     attr_reader :functions
 
+    # @return [Zavudev::Resources::Conversations]
+    attr_reader :conversations
+
+    # @return [Zavudev::Resources::Calls]
+    attr_reader :calls
+
+    # @return [Zavudev::Resources::AgentTemplates]
+    attr_reader :agent_templates
+
+    # @return [Zavudev::Resources::EmailDomains]
+    attr_reader :email_domains
+
+    # @return [Zavudev::Resources::Agents]
+    attr_reader :agents
+
     # @api private
     #
     # @return [Hash{String=>String}]
@@ -143,6 +158,11 @@ module Zavudev
       @number_10dlc = Zavudev::Resources::Number10dlc.new(client: self)
       @me = Zavudev::Resources::Me.new(client: self)
       @functions = Zavudev::Resources::Functions.new(client: self)
+      @conversations = Zavudev::Resources::Conversations.new(client: self)
+      @calls = Zavudev::Resources::Calls.new(client: self)
+      @agent_templates = Zavudev::Resources::AgentTemplates.new(client: self)
+      @email_domains = Zavudev::Resources::EmailDomains.new(client: self)
+      @agents = Zavudev::Resources::Agents.new(client: self)
     end
   end
 end

data/lib/zavudev/models/agent_create_params.rb

@@ -0,0 +1,278 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Agents#create
+    class AgentCreateParams < Zavudev::Internal::Type::BaseModel
+      extend Zavudev::Internal::Type::RequestParameters::Converter
+      include Zavudev::Internal::Type::RequestParameters
+
+      # @!attribute model
+      #
+      #   @return [String]
+      required :model, String
+
+      # @!attribute name
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute provider
+      #   LLM provider for the AI agent.
+      #
+      #   @return [Symbol, Zavudev::Models::Senders::AgentProvider]
+      required :provider, enum: -> { Zavudev::Senders::AgentProvider }
+
+      # @!attribute system_prompt
+      #
+      #   @return [String]
+      required :system_prompt, String, api_name: :systemPrompt
+
+      # @!attribute context_window_messages
+      #
+      #   @return [Integer, nil]
+      optional :context_window_messages, Integer, api_name: :contextWindowMessages
+
+      # @!attribute include_contact_metadata
+      #
+      #   @return [Boolean, nil]
+      optional :include_contact_metadata, Zavudev::Internal::Type::Boolean, api_name: :includeContactMetadata
+
+      # @!attribute max_tokens
+      #
+      #   @return [Integer, nil]
+      optional :max_tokens, Integer, api_name: :maxTokens
+
+      # @!attribute temperature
+      #
+      #   @return [Float, nil]
+      optional :temperature, Float
+
+      # @!attribute trigger_on_channels
+      #
+      #   @return [Array<String>, nil]
+      optional :trigger_on_channels, Zavudev::Internal::Type::ArrayOf[String], api_name: :triggerOnChannels
+
+      # @!attribute trigger_on_message_types
+      #
+      #   @return [Array<String>, nil]
+      optional :trigger_on_message_types,
+               Zavudev::Internal::Type::ArrayOf[String],
+               api_name: :triggerOnMessageTypes
+
+      # @!attribute voice
+      #   Voice Agent configuration on a sender's AI agent. Controls how the agent behaves
+      #   on inbound and outbound phone calls through Zavu's managed voice pipeline
+      #   (speech recognition, the agent's LLM, and speech synthesis, with real-time
+      #   interruption handling). Requires the Voice Agents feature to be enabled for your
+      #   team.
+      #
+      #   @return [Zavudev::Models::AgentCreateParams::Voice, nil]
+      optional :voice, -> { Zavudev::AgentCreateParams::Voice }
+
+      # @!method initialize(model:, name:, provider:, system_prompt:, context_window_messages: nil, include_contact_metadata: nil, max_tokens: nil, temperature: nil, trigger_on_channels: nil, trigger_on_message_types: nil, voice: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Zavudev::Models::AgentCreateParams} for more details.
+      #
+      #   @param model [String]
+      #
+      #   @param name [String]
+      #
+      #   @param provider [Symbol, Zavudev::Models::Senders::AgentProvider] LLM provider for the AI agent.
+      #
+      #   @param system_prompt [String]
+      #
+      #   @param context_window_messages [Integer]
+      #
+      #   @param include_contact_metadata [Boolean]
+      #
+      #   @param max_tokens [Integer]
+      #
+      #   @param temperature [Float]
+      #
+      #   @param trigger_on_channels [Array<String>]
+      #
+      #   @param trigger_on_message_types [Array<String>]
+      #
+      #   @param voice [Zavudev::Models::AgentCreateParams::Voice] Voice Agent configuration on a sender's AI agent. Controls how the agent behaves
+      #
+      #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
+
+      class Voice < Zavudev::Internal::Type::BaseModel
+        # @!attribute enabled
+        #   Whether the agent handles voice calls. When false, the sender's number is not
+        #   answered by the voice agent and outbound calls are rejected.
+        #
+        #   @return [Boolean]
+        required :enabled, Zavudev::Internal::Type::Boolean
+
+        # @!attribute greeting
+        #   Opening line the agent speaks when the call connects. If omitted, the agent
+        #   waits for the caller to speak first.
+        #
+        #   @return [String, nil]
+        optional :greeting, String
+
+        # @!attribute greetings
+        #   Greeting per language, keyed by language code. Used when the caller's language
+        #   differs from the one `greeting` is written in.
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :greetings, Zavudev::Internal::Type::HashOf[String]
+
+        # @!attribute interruptible
+        #   Whether the caller can interrupt the agent while it is speaking (barge-in). When
+        #   true, the agent stops talking as soon as the caller starts.
+        #
+        #   @return [Boolean, nil]
+        optional :interruptible, Zavudev::Internal::Type::Boolean
+
+        # @!attribute language
+        #   BCP-47 language code used for both speech recognition and speech synthesis (e.g.
+        #   `en`, `es`, `pt-BR`). Auto-detected from the recipient when omitted.
+        #
+        #   @return [String, nil]
+        optional :language, String
+
+        # @!attribute max_call_duration_minutes
+        #   Hard limit on call length in minutes. The call ends automatically when reached.
+        #
+        #   @return [Integer, nil]
+        optional :max_call_duration_minutes, Integer, api_name: :maxCallDurationMinutes
+
+        # @!attribute max_idle_seconds
+        #   How long the agent waits during silence before ending the call.
+        #
+        #   @return [Integer, nil]
+        optional :max_idle_seconds, Integer, api_name: :maxIdleSeconds
+
+        # @!attribute model
+        #   Model that runs the conversation, co-located in the voice network for lowest
+        #   latency. Independent of the model used for text messaging. Derived from the
+        #   agent's text model when omitted.
+        #
+        #   @return [String, nil]
+        optional :model, String
+
+        # @!attribute record_calls
+        #   Whether the call audio is recorded.
+        #
+        #   @return [Boolean, nil]
+        optional :record_calls, Zavudev::Internal::Type::Boolean, api_name: :recordCalls
+
+        # @!attribute stt_model
+        #   Speech-recognition model. Uses the default when omitted.
+        #
+        #   @return [String, nil]
+        optional :stt_model, String, api_name: :sttModel
+
+        # @!attribute stt_provider
+        #   Speech-recognition provider. Uses the default when omitted.
+        #
+        #   @return [String, nil]
+        optional :stt_provider, String, api_name: :sttProvider
+
+        # @!attribute transfer_phone_number
+        #   E.164 phone number the agent can transfer the call to. When set, the agent is
+        #   given a transfer tool it can use to hand the call to a human.
+        #
+        #   @return [String, nil]
+        optional :transfer_phone_number, String, api_name: :transferPhoneNumber
+
+        # @!attribute tts_provider
+        #   Speech-synthesis provider. Uses the default when omitted.
+        #
+        #   @return [String, nil]
+        optional :tts_provider, String, api_name: :ttsProvider
+
+        # @!attribute tts_voice_id
+        #   Identifier of the synthesized voice that speaks. Choose from the voices
+        #   available in the dashboard. Uses a neutral default when omitted.
+        #
+        #   @return [String, nil]
+        optional :tts_voice_id, String, api_name: :ttsVoiceId
+
+        # @!attribute voicemail_action
+        #   What the agent does when an answering machine or voicemail is detected on an
+        #   outbound call.
+        #
+        #   @return [Symbol, Zavudev::Models::AgentCreateParams::Voice::VoicemailAction, nil]
+        optional :voicemail_action,
+                 enum: -> { Zavudev::AgentCreateParams::Voice::VoicemailAction },
+                 api_name: :voicemailAction
+
+        # @!attribute voicemail_message
+        #   Message spoken when `voicemailAction` is `leave_message`. Falls back to
+        #   `greeting` when omitted.
+        #
+        #   @return [String, nil]
+        optional :voicemail_message, String, api_name: :voicemailMessage
+
+        # @!attribute voice_speed
+        #   Speech rate. 1.0 is natural. Only honoured by voices that support rate control;
+        #   ignored by the others.
+        #
+        #   @return [Float, nil]
+        optional :voice_speed, Float, api_name: :voiceSpeed
+
+        # @!method initialize(enabled:, greeting: nil, greetings: nil, interruptible: nil, language: nil, max_call_duration_minutes: nil, max_idle_seconds: nil, model: nil, record_calls: nil, stt_model: nil, stt_provider: nil, transfer_phone_number: nil, tts_provider: nil, tts_voice_id: nil, voicemail_action: nil, voicemail_message: nil, voice_speed: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Zavudev::Models::AgentCreateParams::Voice} for more details.
+        #
+        #   Voice Agent configuration on a sender's AI agent. Controls how the agent behaves
+        #   on inbound and outbound phone calls through Zavu's managed voice pipeline
+        #   (speech recognition, the agent's LLM, and speech synthesis, with real-time
+        #   interruption handling). Requires the Voice Agents feature to be enabled for your
+        #   team.
+        #
+        #   @param enabled [Boolean] Whether the agent handles voice calls. When false, the sender's number is not an
+        #
+        #   @param greeting [String] Opening line the agent speaks when the call connects. If omitted, the agent wait
+        #
+        #   @param greetings [Hash{Symbol=>String}] Greeting per language, keyed by language code. Used when the caller's language d
+        #
+        #   @param interruptible [Boolean] Whether the caller can interrupt the agent while it is speaking (barge-in). When
+        #
+        #   @param language [String] BCP-47 language code used for both speech recognition and speech synthesis (e.g.
+        #
+        #   @param max_call_duration_minutes [Integer] Hard limit on call length in minutes. The call ends automatically when reached.
+        #
+        #   @param max_idle_seconds [Integer] How long the agent waits during silence before ending the call.
+        #
+        #   @param model [String] Model that runs the conversation, co-located in the voice network for lowest lat
+        #
+        #   @param record_calls [Boolean] Whether the call audio is recorded.
+        #
+        #   @param stt_model [String] Speech-recognition model. Uses the default when omitted.
+        #
+        #   @param stt_provider [String] Speech-recognition provider. Uses the default when omitted.
+        #
+        #   @param transfer_phone_number [String] E.164 phone number the agent can transfer the call to. When set, the agent is gi
+        #
+        #   @param tts_provider [String] Speech-synthesis provider. Uses the default when omitted.
+        #
+        #   @param tts_voice_id [String] Identifier of the synthesized voice that speaks. Choose from the voices availabl
+        #
+        #   @param voicemail_action [Symbol, Zavudev::Models::AgentCreateParams::Voice::VoicemailAction] What the agent does when an answering machine or voicemail is detected on an out
+        #
+        #   @param voicemail_message [String] Message spoken when `voicemailAction` is `leave_message`. Falls back to `greetin
+        #
+        #   @param voice_speed [Float] Speech rate. 1.0 is natural. Only honoured by voices that support rate control;
+
+        # What the agent does when an answering machine or voicemail is detected on an
+        # outbound call.
+        #
+        # @see Zavudev::Models::AgentCreateParams::Voice#voicemail_action
+        module VoicemailAction
+          extend Zavudev::Internal::Type::Enum
+
+          HANGUP = :hangup
+          LEAVE_MESSAGE = :leave_message
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/zavudev/models/agent_create_response.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Agents#create
+    class AgentCreateResponse < Zavudev::Internal::Type::BaseModel
+      # @!attribute agent
+      #   AI Agent configuration for a sender.
+      #
+      #   @return [Zavudev::Models::Senders::SendersAgent]
+      required :agent, -> { Zavudev::Senders::SendersAgent }
+
+      # @!method initialize(agent:)
+      #   @param agent [Zavudev::Models::Senders::SendersAgent] AI Agent configuration for a sender.
+    end
+  end
+end

data/lib/zavudev/models/{contact_dismiss_merge_suggestion_params.rb → agent_delete_params.rb}

@@ -2,18 +2,18 @@
 
 module Zavudev
   module Models
-    # @see Zavudev::Resources::Contacts#dismiss_merge_suggestion
-    class ContactDismissMergeSuggestionParams < Zavudev::Internal::Type::BaseModel
+    # @see Zavudev::Resources::Agents#delete
+    class AgentDeleteParams < Zavudev::Internal::Type::BaseModel
       extend Zavudev::Internal::Type::RequestParameters::Converter
       include Zavudev::Internal::Type::RequestParameters
 
-      # @!attribute contact_id
+      # @!attribute agent_id
       #
       #   @return [String]
-      required :contact_id, String
+      required :agent_id, String
 
-      # @!method initialize(contact_id:, request_options: {})
-      #   @param contact_id [String]
+      # @!method initialize(agent_id:, request_options: {})
+      #   @param agent_id [String]
       #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
     end
   end

data/lib/zavudev/models/agent_list_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Agents#list
+    class AgentListParams < Zavudev::Internal::Type::BaseModel
+      extend Zavudev::Internal::Type::RequestParameters::Converter
+      include Zavudev::Internal::Type::RequestParameters
+
+      # @!attribute cursor
+      #
+      #   @return [String, nil]
+      optional :cursor, String
+
+      # @!attribute limit
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!method initialize(cursor: nil, limit: nil, request_options: {})
+      #   @param cursor [String]
+      #   @param limit [Integer]
+      #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/zavudev/models/agent_list_voices_params.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Agents#list_voices
+    class AgentListVoicesParams < Zavudev::Internal::Type::BaseModel
+      extend Zavudev::Internal::Type::RequestParameters::Converter
+      include Zavudev::Internal::Type::RequestParameters
+
+      # @!attribute language
+      #   BCP-47 tag (`en`, `es`, `pt-BR`). Omit, or pass `auto`, for every voice.
+      #
+      #   @return [String, nil]
+      optional :language, String
+
+      # @!method initialize(language: nil, request_options: {})
+      #   @param language [String] BCP-47 tag (`en`, `es`, `pt-BR`). Omit, or pass `auto`, for every voice.
+      #
+      #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/zavudev/models/agent_list_voices_response.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Agents#list_voices
+    class AgentListVoicesResponse < Zavudev::Internal::Type::BaseModel
+      # @!attribute items
+      #
+      #   @return [Array<Zavudev::Models::AgentListVoicesResponse::Item>]
+      required :items, -> { Zavudev::Internal::Type::ArrayOf[Zavudev::Models::AgentListVoicesResponse::Item] }
+
+      # @!attribute languages
+      #   Languages an agent can be pinned to. `auto` follows the caller.
+      #
+      #   @return [Array<String>]
+      required :languages, Zavudev::Internal::Type::ArrayOf[String]
+
+      # @!attribute total
+      #   Voices in the catalog, before filtering.
+      #
+      #   @return [Integer, nil]
+      optional :total, Integer
+
+      # @!method initialize(items:, languages:, total: nil)
+      #   @param items [Array<Zavudev::Models::AgentListVoicesResponse::Item>]
+      #
+      #   @param languages [Array<String>] Languages an agent can be pinned to. `auto` follows the caller.
+      #
+      #   @param total [Integer] Voices in the catalog, before filtering.
+
+      class Item < Zavudev::Internal::Type::BaseModel
+        # @!attribute id
+        #   Value for `voice.ttsVoiceId`.
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute language
+        #
+        #   @return [String]
+        required :language, String
+
+        # @!attribute name
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!method initialize(id:, language:, name:)
+        #   @param id [String] Value for `voice.ttsVoiceId`.
+        #
+        #   @param language [String]
+        #
+        #   @param name [String]
+      end
+    end
+  end
+end

data/lib/zavudev/models/agent_retrieve_params.rb

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

data/lib/zavudev/models/agent_retrieve_response.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Agents#retrieve
+    class AgentRetrieveResponse < Zavudev::Internal::Type::BaseModel
+      # @!attribute agent
+      #   AI Agent configuration for a sender.
+      #
+      #   @return [Zavudev::Models::Senders::SendersAgent]
+      required :agent, -> { Zavudev::Senders::SendersAgent }
+
+      # @!method initialize(agent:)
+      #   @param agent [Zavudev::Models::Senders::SendersAgent] AI Agent configuration for a sender.
+    end
+  end
+end

data/lib/zavudev/models/agent_template_list_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::AgentTemplates#list
+    class AgentTemplateListParams < Zavudev::Internal::Type::BaseModel
+      extend Zavudev::Internal::Type::RequestParameters::Converter
+      include Zavudev::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/zavudev/models/agent_template_list_response.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::AgentTemplates#list
+    class AgentTemplateListResponse < Zavudev::Internal::Type::BaseModel
+      # @!attribute items
+      #
+      #   @return [Array<Zavudev::Models::AgentTemplateListResponse::Item>]
+      required :items, -> { Zavudev::Internal::Type::ArrayOf[Zavudev::Models::AgentTemplateListResponse::Item] }
+
+      # @!method initialize(items:)
+      #   @param items [Array<Zavudev::Models::AgentTemplateListResponse::Item>]
+
+      class Item < Zavudev::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute category
+        #
+        #   @return [Symbol, Zavudev::Models::AgentTemplateListResponse::Item::Category]
+        required :category, enum: -> { Zavudev::Models::AgentTemplateListResponse::Item::Category }
+
+        # @!attribute name
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute summary
+        #
+        #   @return [String]
+        required :summary, String
+
+        # @!attribute tool_count
+        #
+        #   @return [Integer]
+        required :tool_count, Integer, api_name: :toolCount
+
+        # @!attribute voice
+        #   Whether this agent answers phone calls.
+        #
+        #   @return [Boolean]
+        required :voice, Zavudev::Internal::Type::Boolean
+
+        # @!method initialize(id:, category:, name:, summary:, tool_count:, voice:)
+        #   Compact catalog entry for a factory agent.
+        #
+        #   @param id [String]
+        #
+        #   @param category [Symbol, Zavudev::Models::AgentTemplateListResponse::Item::Category]
+        #
+        #   @param name [String]
+        #
+        #   @param summary [String]
+        #
+        #   @param tool_count [Integer]
+        #
+        #   @param voice [Boolean] Whether this agent answers phone calls.
+
+        # @see Zavudev::Models::AgentTemplateListResponse::Item#category
+        module Category
+          extend Zavudev::Internal::Type::Enum
+
+          SALES = :sales
+          SUPPORT = :support
+          FRONT_DESK = :frontDesk
+          OPS = :ops
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/zavudev/models/agent_template_retrieve_params.rb

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