zavudev 0.19.0 → 0.20.0

data/lib/zavudev/models/senders/agent/tool_test_response.rb

@@ -6,13 +6,98 @@ module Zavudev
       module Agent
         # @see Zavudev::Resources::Senders::Agent::Tools#test_
         class ToolTestResponse < Zavudev::Internal::Type::BaseModel
-          # @!attribute scheduled
+          # @!attribute run
+          #   One run of a tool triggered from the test endpoint. Recorded so a test is
+          #   verifiable after the fact rather than only visible in the response.
           #
-          #   @return [Boolean]
-          required :scheduled, Zavudev::Internal::Type::Boolean
+          #   @return [Zavudev::Models::Senders::Agent::ToolTestResponse::Run]
+          required :run, -> { Zavudev::Models::Senders::Agent::ToolTestResponse::Run }
 
-          # @!method initialize(scheduled:)
-          #   @param scheduled [Boolean]
+          # @!method initialize(run:)
+          #   Some parameter documentations has been truncated, see
+          #   {Zavudev::Models::Senders::Agent::ToolTestResponse} for more details.
+          #
+          #   @param run [Zavudev::Models::Senders::Agent::ToolTestResponse::Run] One run of a tool triggered from the test endpoint. Recorded so a test is verifi
+
+          # @see Zavudev::Models::Senders::Agent::ToolTestResponse#run
+          class Run < Zavudev::Internal::Type::BaseModel
+            # @!attribute id
+            #
+            #   @return [String]
+            required :id, String
+
+            # @!attribute created_at
+            #
+            #   @return [Time]
+            required :created_at, Time, api_name: :createdAt
+
+            # @!attribute duration_ms
+            #
+            #   @return [Integer]
+            required :duration_ms, Integer, api_name: :durationMs
+
+            # @!attribute success
+            #   Whether the tool returned without error. A tool that answered with a non-2xx
+            #   status is a failed run, not an error of this endpoint.
+            #
+            #   @return [Boolean]
+            required :success, Zavudev::Internal::Type::Boolean
+
+            # @!attribute tool_id
+            #
+            #   @return [String]
+            required :tool_id, String, api_name: :toolId
+
+            # @!attribute error
+            #   Why the run failed, when it did.
+            #
+            #   @return [String, nil]
+            optional :error, String, nil?: true
+
+            # @!attribute params
+            #   The parameters the tool was called with.
+            #
+            #   @return [Hash{Symbol=>Object}, nil]
+            optional :params, Zavudev::Internal::Type::HashOf[Zavudev::Internal::Type::Unknown]
+
+            # @!attribute response
+            #   The tool's response body, truncated.
+            #
+            #   @return [String, nil]
+            optional :response, String, nil?: true
+
+            # @!attribute status_code
+            #   HTTP status the tool's webhook returned. Absent for tools that do not go over
+            #   HTTP.
+            #
+            #   @return [Integer, nil]
+            optional :status_code, Integer, api_name: :statusCode, nil?: true
+
+            # @!method initialize(id:, created_at:, duration_ms:, success:, tool_id:, error: nil, params: nil, response: nil, status_code: nil)
+            #   Some parameter documentations has been truncated, see
+            #   {Zavudev::Models::Senders::Agent::ToolTestResponse::Run} for more details.
+            #
+            #   One run of a tool triggered from the test endpoint. Recorded so a test is
+            #   verifiable after the fact rather than only visible in the response.
+            #
+            #   @param id [String]
+            #
+            #   @param created_at [Time]
+            #
+            #   @param duration_ms [Integer]
+            #
+            #   @param success [Boolean] Whether the tool returned without error. A tool that answered with a non-2xx sta
+            #
+            #   @param tool_id [String]
+            #
+            #   @param error [String, nil] Why the run failed, when it did.
+            #
+            #   @param params [Hash{Symbol=>Object}] The parameters the tool was called with.
+            #
+            #   @param response [String, nil] The tool's response body, truncated.
+            #
+            #   @param status_code [Integer, nil] HTTP status the tool's webhook returned. Absent for tools that do not go over HT
+          end
         end
       end
     end

data/lib/zavudev/models/senders/agent.rb

@@ -73,6 +73,13 @@ module Zavudev
         #   @return [Integer, nil]
         optional :max_tokens, Integer, api_name: :maxTokens, nil?: true
 
+        # @!attribute sender_ids
+        #   Senders this agent answers on. An agent can serve several; `senderId` remains
+        #   the primary one, for compatibility.
+        #
+        #   @return [Array<String>, nil]
+        optional :sender_ids, Zavudev::Internal::Type::ArrayOf[String], api_name: :senderIds
+
         # @!attribute stats
         #
         #   @return [Zavudev::Models::Senders::SendersAgent::Stats, nil]
@@ -98,7 +105,18 @@ module Zavudev
                  Zavudev::Internal::Type::ArrayOf[String],
                  api_name: :triggerOnMessageTypes
 
-        # @!method initialize(id:, created_at:, enabled:, model:, name:, provider:, sender_id:, system_prompt:, updated_at:, context_window_messages: nil, include_contact_metadata: nil, max_tokens: nil, stats: nil, temperature: nil, trigger_on_channels: nil, trigger_on_message_types: nil)
+        # @!attribute voice
+        #   Voice Agent configuration. When present and enabled, the agent can answer
+        #   inbound phone calls and place outbound calls with Zavu's managed voice pipeline.
+        #   Requires the Voice Agents feature to be enabled for your team.
+        #
+        #   @return [Zavudev::Models::Senders::SendersAgent::Voice, nil]
+        optional :voice, -> { Zavudev::Senders::SendersAgent::Voice }
+
+        # @!method initialize(id:, created_at:, enabled:, model:, name:, provider:, sender_id:, system_prompt:, updated_at:, context_window_messages: nil, include_contact_metadata: nil, max_tokens: nil, sender_ids: nil, stats: nil, temperature: nil, trigger_on_channels: nil, trigger_on_message_types: nil, voice: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Zavudev::Models::Senders::SendersAgent} for more details.
+        #
         #   AI Agent configuration for a sender.
         #
         #   @param id [String]
@@ -125,6 +143,8 @@ module Zavudev
         #
         #   @param max_tokens [Integer, nil] Maximum tokens for LLM response.
         #
+        #   @param sender_ids [Array<String>] Senders this agent answers on. An agent can serve several; `senderId` remains th
+        #
         #   @param stats [Zavudev::Models::Senders::SendersAgent::Stats]
         #
         #   @param temperature [Float, nil] LLM temperature (0-2).
@@ -132,6 +152,8 @@ module Zavudev
         #   @param trigger_on_channels [Array<String>] Channels that trigger the agent.
         #
         #   @param trigger_on_message_types [Array<String>] Message types that trigger the agent.
+        #
+        #   @param voice [Zavudev::Models::Senders::SendersAgent::Voice] Voice Agent configuration. When present and enabled, the agent can answer inboun
 
         # @see Zavudev::Models::Senders::SendersAgent#stats
         class Stats < Zavudev::Internal::Type::BaseModel
@@ -158,6 +180,181 @@ module Zavudev
           #
           #   @param total_tokens_used [Integer]
         end
+
+        # @see Zavudev::Models::Senders::SendersAgent#voice
+        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::Senders::SendersAgent::Voice::VoicemailAction, nil]
+          optional :voicemail_action,
+                   enum: -> { Zavudev::Senders::SendersAgent::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::Senders::SendersAgent::Voice} for more details.
+          #
+          #   Voice Agent configuration. When present and enabled, the agent can answer
+          #   inbound phone calls and place outbound calls with Zavu's managed voice pipeline.
+          #   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::Senders::SendersAgent::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::Senders::SendersAgent::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/senders/agent_create_params.rb

@@ -74,7 +74,18 @@ module Zavudev
                  Zavudev::Internal::Type::ArrayOf[String],
                  api_name: :triggerOnMessageTypes
 
-        # @!method initialize(sender_id:, model:, name:, provider:, system_prompt:, api_key: nil, context_window_messages: nil, include_contact_metadata: nil, max_tokens: nil, temperature: nil, trigger_on_channels: nil, trigger_on_message_types: nil, request_options: {})
+        # @!attribute voice
+        #   Voice Agent configuration. Enable this to let the agent answer and place phone
+        #   calls with Zavu's managed voice pipeline. Requires the Voice Agents feature to
+        #   be enabled for your team.
+        #
+        #   @return [Zavudev::Models::Senders::AgentCreateParams::Voice, nil]
+        optional :voice, -> { Zavudev::Senders::AgentCreateParams::Voice }
+
+        # @!method initialize(sender_id:, model:, name:, provider:, system_prompt:, api_key: nil, 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::Senders::AgentCreateParams} for more details.
+        #
         #   @param sender_id [String]
         #
         #   @param model [String]
@@ -99,7 +110,183 @@ module Zavudev
         #
         #   @param trigger_on_message_types [Array<String>]
         #
+        #   @param voice [Zavudev::Models::Senders::AgentCreateParams::Voice] Voice Agent configuration. Enable this to let the agent answer and place phone c
+        #
         #   @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::Senders::AgentCreateParams::Voice::VoicemailAction, nil]
+          optional :voicemail_action,
+                   enum: -> { Zavudev::Senders::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::Senders::AgentCreateParams::Voice} for more details.
+          #
+          #   Voice Agent configuration. Enable this to let the agent answer and place phone
+          #   calls with Zavu's managed voice pipeline. 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::Senders::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::Senders::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/senders/agent_execution.rb

@@ -56,6 +56,15 @@ module Zavudev
         #   @return [String, nil]
         optional :inbound_message_id, String, api_name: :inboundMessageId
 
+        # @!attribute knowledge_chunks_used
+        #   Knowledge-base chunks retrieved for this answer. Zero on an agent that has
+        #   documents attached means the reply was not grounded in them, which is otherwise
+        #   indistinguishable from a correct answer in this record. Absent on executions
+        #   recorded before this field existed, which is not the same as zero.
+        #
+        #   @return [Integer, nil]
+        optional :knowledge_chunks_used, Integer, api_name: :knowledgeChunksUsed, nil?: true
+
         # @!attribute response_message_id
         #
         #   @return [String, nil]
@@ -66,7 +75,19 @@ module Zavudev
         #   @return [String, nil]
         optional :response_text, String, api_name: :responseText, nil?: true
 
-        # @!method initialize(id:, agent_id:, cost:, created_at:, input_tokens:, latency_ms:, output_tokens:, status:, error_message: nil, inbound_message_id: nil, response_message_id: nil, response_text: nil)
+        # @!attribute tool_calls
+        #   Tools the agent called while producing this reply. Zero on an agent that has
+        #   tools configured means it answered without calling any — the case where a reply
+        #   says it will look something up and nothing ever reaches your endpoint. Absent on
+        #   executions recorded before this field existed, which is not the same as zero.
+        #
+        #   @return [Integer, nil]
+        optional :tool_calls, Integer, api_name: :toolCalls, nil?: true
+
+        # @!method initialize(id:, agent_id:, cost:, created_at:, input_tokens:, latency_ms:, output_tokens:, status:, error_message: nil, inbound_message_id: nil, knowledge_chunks_used: nil, response_message_id: nil, response_text: nil, tool_calls: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Zavudev::Models::Senders::AgentExecution} for more details.
+        #
         #   @param id [String]
         #
         #   @param agent_id [String]
@@ -87,9 +108,13 @@ module Zavudev
         #
         #   @param inbound_message_id [String]
         #
+        #   @param knowledge_chunks_used [Integer, nil] Knowledge-base chunks retrieved for this answer. Zero on an agent that has docum
+        #
         #   @param response_message_id [String, nil]
         #
         #   @param response_text [String, nil]
+        #
+        #   @param tool_calls [Integer, nil] Tools the agent called while producing this reply. Zero on an agent that has too
       end
     end
   end