zavudev 0.20.0 → 0.21.0

data/lib/zavudev/models/agent_template_retrieve_response.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::AgentTemplates#retrieve
+    class AgentTemplateRetrieveResponse < Zavudev::Internal::Type::BaseModel
+      # @!attribute template
+      #   A fully rendered factory agent: the function files to scaffold plus the secrets
+      #   it needs. Returned by GET /v1/agent-templates/{templateId} and consumed by
+      #   `npx zavudev agents pull`.
+      #
+      #   @return [Zavudev::Models::AgentTemplateRetrieveResponse::Template]
+      required :template, -> { Zavudev::Models::AgentTemplateRetrieveResponse::Template }
+
+      # @!method initialize(template:)
+      #   Some parameter documentations has been truncated, see
+      #   {Zavudev::Models::AgentTemplateRetrieveResponse} for more details.
+      #
+      #   @param template [Zavudev::Models::AgentTemplateRetrieveResponse::Template] A fully rendered factory agent: the function files to scaffold plus the secrets
+
+      # @see Zavudev::Models::AgentTemplateRetrieveResponse#template
+      class Template < Zavudev::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute category
+        #
+        #   @return [Symbol, Zavudev::Models::AgentTemplateRetrieveResponse::Template::Category]
+        required :category, enum: -> { Zavudev::Models::AgentTemplateRetrieveResponse::Template::Category }
+
+        # @!attribute default_slug
+        #
+        #   @return [String]
+        required :default_slug, String, api_name: :defaultSlug
+
+        # @!attribute dependencies
+        #   npm dependencies for the scaffolded function.
+        #
+        #   @return [Hash{Symbol=>String}]
+        required :dependencies, Zavudev::Internal::Type::HashOf[String]
+
+        # @!attribute files
+        #
+        #   @return [Array<Zavudev::Models::AgentTemplateRetrieveResponse::Template::File>]
+        required :files,
+                 -> { Zavudev::Internal::Type::ArrayOf[Zavudev::Models::AgentTemplateRetrieveResponse::Template::File] }
+
+        # @!attribute name
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute required_secrets
+        #
+        #   @return [Array<Zavudev::Models::AgentTemplateRetrieveResponse::Template::RequiredSecret>]
+        required :required_secrets,
+                 -> { Zavudev::Internal::Type::ArrayOf[Zavudev::Models::AgentTemplateRetrieveResponse::Template::RequiredSecret] },
+                 api_name: :requiredSecrets
+
+        # @!attribute summary
+        #
+        #   @return [String]
+        required :summary, String
+
+        # @!attribute voice
+        #
+        #   @return [Boolean]
+        required :voice, Zavudev::Internal::Type::Boolean
+
+        # @!method initialize(id:, category:, default_slug:, dependencies:, files:, name:, required_secrets:, summary:, voice:)
+        #   A fully rendered factory agent: the function files to scaffold plus the secrets
+        #   it needs. Returned by GET /v1/agent-templates/{templateId} and consumed by
+        #   `npx zavudev agents pull`.
+        #
+        #   @param id [String]
+        #
+        #   @param category [Symbol, Zavudev::Models::AgentTemplateRetrieveResponse::Template::Category]
+        #
+        #   @param default_slug [String]
+        #
+        #   @param dependencies [Hash{Symbol=>String}] npm dependencies for the scaffolded function.
+        #
+        #   @param files [Array<Zavudev::Models::AgentTemplateRetrieveResponse::Template::File>]
+        #
+        #   @param name [String]
+        #
+        #   @param required_secrets [Array<Zavudev::Models::AgentTemplateRetrieveResponse::Template::RequiredSecret>]
+        #
+        #   @param summary [String]
+        #
+        #   @param voice [Boolean]
+
+        # @see Zavudev::Models::AgentTemplateRetrieveResponse::Template#category
+        module Category
+          extend Zavudev::Internal::Type::Enum
+
+          SALES = :sales
+          SUPPORT = :support
+          FRONT_DESK = :frontDesk
+          OPS = :ops
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        class File < Zavudev::Internal::Type::BaseModel
+          # @!attribute content
+          #   File contents to write verbatim.
+          #
+          #   @return [String]
+          required :content, String
+
+          # @!attribute path
+          #
+          #   @return [String]
+          required :path, String
+
+          # @!method initialize(content:, path:)
+          #   @param content [String] File contents to write verbatim.
+          #
+          #   @param path [String]
+        end
+
+        class RequiredSecret < Zavudev::Internal::Type::BaseModel
+          # @!attribute hint
+          #
+          #   @return [String]
+          required :hint, String
+
+          # @!attribute key
+          #
+          #   @return [String]
+          required :key, String
+
+          # @!method initialize(hint:, key:)
+          #   @param hint [String]
+          #   @param key [String]
+        end
+      end
+    end
+  end
+end

data/lib/zavudev/models/agent_test_params.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Agents#test_
+    class AgentTestParams < Zavudev::Internal::Type::BaseModel
+      extend Zavudev::Internal::Type::RequestParameters::Converter
+      include Zavudev::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!attribute message
+      #   What to say to the agent.
+      #
+      #   @return [String]
+      required :message, String
+
+      # @!attribute execute_tools
+      #   Run the tools the agent calls instead of reporting the choice and stopping.
+      #
+      #   Off by default because a tool handler talks to the outside world: a rehearsal
+      #   that charges a card is not a rehearsal. Turn it on to exercise the loop that
+      #   actually matters — the model picks a tool, the handler answers, the model
+      #   replies with the result — without sending a message to anyone. What ran comes
+      #   back in `executedToolCalls`.
+      #
+      #   @return [Boolean, nil]
+      optional :execute_tools, Zavudev::Internal::Type::Boolean, api_name: :executeTools
+
+      # @!attribute history
+      #   Prior turns, oldest first, to exercise multi-turn behaviour without persisting a
+      #   thread. Trimmed to the agent's context window.
+      #
+      #   @return [Array<Zavudev::Models::AgentTestParams::History>, nil]
+      optional :history, -> { Zavudev::Internal::Type::ArrayOf[Zavudev::AgentTestParams::History] }
+
+      # @!attribute use_knowledge_base
+      #   Set false to skip retrieval and isolate prompt behaviour from the knowledge
+      #   base.
+      #
+      #   @return [Boolean, nil]
+      optional :use_knowledge_base, Zavudev::Internal::Type::Boolean, api_name: :useKnowledgeBase
+
+      # @!method initialize(agent_id:, message:, execute_tools: nil, history: nil, use_knowledge_base: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Zavudev::Models::AgentTestParams} for more details.
+      #
+      #   @param agent_id [String]
+      #
+      #   @param message [String] What to say to the agent.
+      #
+      #   @param execute_tools [Boolean] Run the tools the agent calls instead of reporting the choice and stopping.
+      #
+      #   @param history [Array<Zavudev::Models::AgentTestParams::History>] Prior turns, oldest first, to exercise multi-turn behaviour without persisting a
+      #
+      #   @param use_knowledge_base [Boolean] Set false to skip retrieval and isolate prompt behaviour from the knowledge base
+      #
+      #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
+
+      class History < Zavudev::Internal::Type::BaseModel
+        # @!attribute content
+        #
+        #   @return [String]
+        required :content, String
+
+        # @!attribute role
+        #
+        #   @return [Symbol, Zavudev::Models::AgentTestParams::History::Role]
+        required :role, enum: -> { Zavudev::AgentTestParams::History::Role }
+
+        # @!method initialize(content:, role:)
+        #   @param content [String]
+        #   @param role [Symbol, Zavudev::Models::AgentTestParams::History::Role]
+
+        # @see Zavudev::Models::AgentTestParams::History#role
+        module Role
+          extend Zavudev::Internal::Type::Enum
+
+          USER = :user
+          ASSISTANT = :assistant
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/zavudev/models/agent_test_response.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Agents#test_
+    class AgentTestResponse < Zavudev::Internal::Type::BaseModel
+      # @!attribute error
+      #
+      #   @return [String, nil]
+      required :error, String, nil?: true
+
+      # @!attribute input_tokens
+      #
+      #   @return [Integer]
+      required :input_tokens, Integer, api_name: :inputTokens
+
+      # @!attribute knowledge_chunks_used
+      #   Knowledge-base chunks retrieved for this message. Zero means the answer was not
+      #   grounded in your documents.
+      #
+      #   @return [Integer]
+      required :knowledge_chunks_used, Integer, api_name: :knowledgeChunksUsed
+
+      # @!attribute latency_ms
+      #
+      #   @return [Integer]
+      required :latency_ms, Integer, api_name: :latencyMs
+
+      # @!attribute output_tokens
+      #
+      #   @return [Integer]
+      required :output_tokens, Integer, api_name: :outputTokens
+
+      # @!attribute success
+      #
+      #   @return [Boolean]
+      required :success, Zavudev::Internal::Type::Boolean
+
+      # @!attribute text
+      #   What the agent would reply.
+      #
+      #   @return [String, nil]
+      required :text, String, nil?: true
+
+      # @!attribute warnings
+      #   Things that are true of this agent but that a dry run cannot prove. Surfaced so
+      #   a passing dry run is never mistaken for proof that the agent works live.
+      #
+      #   - The agent being disabled.
+      #   - Enabled tools that were **not offered to the model** here — the model never
+      #     saw them, so a reply that looks like a lookup was invented. Live conversations
+      #     on every channel do offer them; running them here would cause real side
+      #     effects.
+      #   - An agent whose sender has none of the channels it triggers on, which answers
+      #     every dry run and no real message.
+      #   - Contact metadata that exists on a real conversation but not here.
+      #
+      #   @return [Array<String>]
+      required :warnings, Zavudev::Internal::Type::ArrayOf[String]
+
+      # @!attribute executed_tool_calls
+      #   Tools that actually ran, in order, when the request set `executeTools`. Empty on
+      #   a normal dry run, where nothing is executed. An entry with `ok: false` means the
+      #   agent saw an error and answered around it, which is what a customer would have
+      #   received.
+      #
+      #   @return [Array<Zavudev::Models::AgentTestResponse::ExecutedToolCall>, nil]
+      optional :executed_tool_calls,
+               -> { Zavudev::Internal::Type::ArrayOf[Zavudev::Models::AgentTestResponse::ExecutedToolCall] },
+               api_name: :executedToolCalls
+
+      # @!method initialize(error:, input_tokens:, knowledge_chunks_used:, latency_ms:, output_tokens:, success:, text:, warnings:, executed_tool_calls: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Zavudev::Models::AgentTestResponse} for more details.
+      #
+      #   @param error [String, nil]
+      #
+      #   @param input_tokens [Integer]
+      #
+      #   @param knowledge_chunks_used [Integer] Knowledge-base chunks retrieved for this message. Zero means the answer was not
+      #
+      #   @param latency_ms [Integer]
+      #
+      #   @param output_tokens [Integer]
+      #
+      #   @param success [Boolean]
+      #
+      #   @param text [String, nil] What the agent would reply.
+      #
+      #   @param warnings [Array<String>] Things that are true of this agent but that a dry run cannot prove. Surfaced so
+      #
+      #   @param executed_tool_calls [Array<Zavudev::Models::AgentTestResponse::ExecutedToolCall>] Tools that actually ran, in order, when the request set `executeTools`. Empty on
+
+      class ExecutedToolCall < Zavudev::Internal::Type::BaseModel
+        # @!attribute name
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute ok
+        #
+        #   @return [Boolean]
+        required :ok, Zavudev::Internal::Type::Boolean
+
+        # @!attribute error
+        #
+        #   @return [String, nil]
+        optional :error, String, nil?: true
+
+        # @!method initialize(name:, ok:, error: nil)
+        #   @param name [String]
+        #   @param ok [Boolean]
+        #   @param error [String, nil]
+      end
+    end
+  end
+end

data/lib/zavudev/models/agent_update_params.rb

@@ -0,0 +1,295 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Agents#update
+    class AgentUpdateParams < Zavudev::Internal::Type::BaseModel
+      extend Zavudev::Internal::Type::RequestParameters::Converter
+      include Zavudev::Internal::Type::RequestParameters
+
+      # @!attribute agent_id
+      #
+      #   @return [String]
+      required :agent_id, String
+
+      # @!attribute api_key
+      #
+      #   @return [String, nil]
+      optional :api_key, String, api_name: :apiKey
+
+      # @!attribute context_window_messages
+      #
+      #   @return [Integer, nil]
+      optional :context_window_messages, Integer, api_name: :contextWindowMessages
+
+      # @!attribute enabled
+      #
+      #   @return [Boolean, nil]
+      optional :enabled, Zavudev::Internal::Type::Boolean
+
+      # @!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, nil?: true
+
+      # @!attribute model
+      #
+      #   @return [String, nil]
+      optional :model, String
+
+      # @!attribute name
+      #
+      #   @return [String, nil]
+      optional :name, String
+
+      # @!attribute provider
+      #   LLM provider for the AI agent.
+      #
+      #   @return [Symbol, Zavudev::Models::Senders::AgentProvider, nil]
+      optional :provider, enum: -> { Zavudev::Senders::AgentProvider }
+
+      # @!attribute system_prompt
+      #
+      #   @return [String, nil]
+      optional :system_prompt, String, api_name: :systemPrompt
+
+      # @!attribute temperature
+      #
+      #   @return [Float, nil]
+      optional :temperature, Float, nil?: true
+
+      # @!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. Patch this object to enable voice, change the
+      #   greeting, or adjust call limits. Requires the Voice Agents feature to be enabled
+      #   for your team.
+      #
+      #   @return [Zavudev::Models::AgentUpdateParams::Voice, nil]
+      optional :voice, -> { Zavudev::AgentUpdateParams::Voice }
+
+      # @!method initialize(agent_id:, api_key: nil, context_window_messages: nil, enabled: nil, include_contact_metadata: nil, max_tokens: nil, model: nil, name: nil, provider: nil, system_prompt: 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::AgentUpdateParams} for more details.
+      #
+      #   @param agent_id [String]
+      #
+      #   @param api_key [String]
+      #
+      #   @param context_window_messages [Integer]
+      #
+      #   @param enabled [Boolean]
+      #
+      #   @param include_contact_metadata [Boolean]
+      #
+      #   @param max_tokens [Integer, nil]
+      #
+      #   @param model [String]
+      #
+      #   @param name [String]
+      #
+      #   @param provider [Symbol, Zavudev::Models::Senders::AgentProvider] LLM provider for the AI agent.
+      #
+      #   @param system_prompt [String]
+      #
+      #   @param temperature [Float, nil]
+      #
+      #   @param trigger_on_channels [Array<String>]
+      #
+      #   @param trigger_on_message_types [Array<String>]
+      #
+      #   @param voice [Zavudev::Models::AgentUpdateParams::Voice] Voice Agent configuration. Patch this object to enable voice, change the greetin
+      #
+      #   @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::AgentUpdateParams::Voice::VoicemailAction, nil]
+        optional :voicemail_action,
+                 enum: -> { Zavudev::AgentUpdateParams::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::AgentUpdateParams::Voice} for more details.
+        #
+        #   Voice Agent configuration. Patch this object to enable voice, change the
+        #   greeting, or adjust call limits. 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::AgentUpdateParams::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::AgentUpdateParams::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_update_response.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Agents#update
+    class AgentUpdateResponse < 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/agents/sender_connect_params.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    module Agents
+      # @see Zavudev::Resources::Agents::Senders#connect
+      class SenderConnectParams < Zavudev::Internal::Type::BaseModel
+        extend Zavudev::Internal::Type::RequestParameters::Converter
+        include Zavudev::Internal::Type::RequestParameters
+
+        # @!attribute agent_id
+        #
+        #   @return [String]
+        required :agent_id, String
+
+        # @!attribute sender_id
+        #   Sender to connect.
+        #
+        #   @return [String]
+        required :sender_id, String, api_name: :senderId
+
+        # @!method initialize(agent_id:, sender_id:, request_options: {})
+        #   @param agent_id [String]
+        #
+        #   @param sender_id [String] Sender to connect.
+        #
+        #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end