zavudev 0.19.0 → 0.21.0

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

data/lib/zavudev/models/agents/sender_connect_response.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    module Agents
+      # @see Zavudev::Resources::Agents::Senders#connect
+      class SenderConnectResponse < 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
+end

data/lib/zavudev/models/agents/sender_disconnect_params.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    module Agents
+      # @see Zavudev::Resources::Agents::Senders#disconnect
+      class SenderDisconnectParams < 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
+        #
+        #   @return [String]
+        required :sender_id, String
+
+        # @!method initialize(agent_id:, sender_id:, request_options: {})
+        #   @param agent_id [String]
+        #   @param sender_id [String]
+        #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/zavudev/models/call_create_params.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Calls#create
+    class CallCreateParams < Zavudev::Internal::Type::BaseModel
+      extend Zavudev::Internal::Type::RequestParameters::Converter
+      include Zavudev::Internal::Type::RequestParameters
+
+      # @!attribute to
+      #   Recipient phone number in E.164 format.
+      #
+      #   @return [String]
+      required :to, String
+
+      # @!attribute greeting
+      #   Overrides the agent's configured greeting for this call only.
+      #
+      #   @return [String, nil]
+      optional :greeting, String
+
+      # @!attribute language
+      #   Language the agent speaks on this call only, as a BCP-47 tag (`en`, `es`,
+      #   `es-ES`, `pt-BR`), or `auto` to detect the caller's language and follow it.
+      #   Overrides the agent's configured language for speech recognition, the agent's
+      #   replies, and the synthesized voice. If the agent uses a custom voice you
+      #   supplied, that voice is kept and only the language changes. When omitted, the
+      #   agent's configured language is used.
+      #
+      #   @return [String, nil]
+      optional :language, String
+
+      # @!attribute max_duration_minutes
+      #   Overrides the agent's maximum call duration for this call only.
+      #
+      #   @return [Integer, nil]
+      optional :max_duration_minutes, Integer, api_name: :maxDurationMinutes
+
+      # @!attribute metadata
+      #   Arbitrary metadata to associate with the call. Returned on the call object and
+      #   included in voice webhooks.
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :metadata, Zavudev::Internal::Type::HashOf[String]
+
+      # @!attribute sender_id
+      #   Sender profile that places the call. Uses the project's default sender if
+      #   omitted. The sender's agent must have voice enabled.
+      #
+      #   @return [String, nil]
+      optional :sender_id, String, api_name: :senderId
+
+      # @!method initialize(to:, greeting: nil, language: nil, max_duration_minutes: nil, metadata: nil, sender_id: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Zavudev::Models::CallCreateParams} for more details.
+      #
+      #   @param to [String] Recipient phone number in E.164 format.
+      #
+      #   @param greeting [String] Overrides the agent's configured greeting for this call only.
+      #
+      #   @param language [String] Language the agent speaks on this call only, as a BCP-47 tag (`en`, `es`, `es-ES
+      #
+      #   @param max_duration_minutes [Integer] Overrides the agent's maximum call duration for this call only.
+      #
+      #   @param metadata [Hash{Symbol=>String}] Arbitrary metadata to associate with the call. Returned on the call object and i
+      #
+      #   @param sender_id [String] Sender profile that places the call. Uses the project's default sender if omitte
+      #
+      #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/zavudev/models/call_create_response.rb

@@ -0,0 +1,262 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Calls#create
+    class CallCreateResponse < Zavudev::Internal::Type::BaseModel
+      # @!attribute call
+      #
+      #   @return [Zavudev::Models::CallCreateResponse::Call]
+      required :call, -> { Zavudev::Models::CallCreateResponse::Call }
+
+      # @!method initialize(call:)
+      #   @param call [Zavudev::Models::CallCreateResponse::Call]
+
+      # @see Zavudev::Models::CallCreateResponse#call
+      class Call < Zavudev::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute created_at
+        #
+        #   @return [Time]
+        required :created_at, Time, api_name: :createdAt
+
+        # @!attribute direction
+        #   Whether the call was placed by Zavu (outbound) or received from a caller
+        #   (inbound).
+        #
+        #   @return [Symbol, Zavudev::Models::CallCreateResponse::Call::Direction]
+        required :direction, enum: -> { Zavudev::Models::CallCreateResponse::Call::Direction }
+
+        # @!attribute from
+        #   Caller phone number in E.164 format. Your sender's number for outbound calls;
+        #   the caller's number for inbound calls.
+        #
+        #   @return [String]
+        required :from, String
+
+        # @!attribute status
+        #   Lifecycle status of a voice call.
+        #
+        #   - `queued`: outbound call created, not yet dialing.
+        #   - `ringing`: dialing (outbound) or received and ringing (inbound).
+        #   - `in_progress`: answered, the agent is connected.
+        #   - `completed`: ended after a conversation.
+        #   - `failed`: could not be completed.
+        #   - `busy`: the line was busy.
+        #   - `no_answer`: rang but was not answered.
+        #   - `canceled`: canceled before it was answered.
+        #
+        #   @return [Symbol, Zavudev::Models::CallCreateResponse::Call::Status]
+        required :status, enum: -> { Zavudev::Models::CallCreateResponse::Call::Status }
+
+        # @!attribute to
+        #   Callee phone number in E.164 format.
+        #
+        #   @return [String]
+        required :to, String
+
+        # @!attribute answered_at
+        #   When the call was answered.
+        #
+        #   @return [Time, nil]
+        optional :answered_at, Time, api_name: :answeredAt, nil?: true
+
+        # @!attribute cost
+        #   Total cost of the call in USD, combining the managed voice pipeline per-minute
+        #   charge and telephony. Available once the call has ended.
+        #
+        #   @return [Float, nil]
+        optional :cost, Float, nil?: true
+
+        # @!attribute duration_seconds
+        #   Billable talk time in seconds, measured from answer to hangup.
+        #
+        #   @return [Integer, nil]
+        optional :duration_seconds, Integer, api_name: :durationSeconds, nil?: true
+
+        # @!attribute ended_at
+        #   When the call ended.
+        #
+        #   @return [Time, nil]
+        optional :ended_at, Time, api_name: :endedAt, nil?: true
+
+        # @!attribute end_reason
+        #   Why the call ended (e.g. `agent_ended`, `max_duration`, `transfer`, `hangup`).
+        #   Present once the call is no longer active.
+        #
+        #   @return [String, nil]
+        optional :end_reason, String, api_name: :endReason, nil?: true
+
+        # @!attribute metadata
+        #   Arbitrary metadata you attached when creating the call.
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :metadata, Zavudev::Internal::Type::HashOf[String]
+
+        # @!attribute transcript
+        #   Ordered transcript of the call. Included when retrieving a single call; omitted
+        #   from list responses.
+        #
+        #   @return [Array<Zavudev::Models::CallCreateResponse::Call::Transcript>, nil]
+        optional :transcript,
+                 -> { Zavudev::Internal::Type::ArrayOf[Zavudev::Models::CallCreateResponse::Call::Transcript] }
+
+        # @!attribute turn_count
+        #   Number of conversation turns exchanged during the call.
+        #
+        #   @return [Integer, nil]
+        optional :turn_count, Integer, api_name: :turnCount, nil?: true
+
+        # @!attribute updated_at
+        #
+        #   @return [Time, nil]
+        optional :updated_at, Time, api_name: :updatedAt
+
+        # @!method initialize(id:, created_at:, direction:, from:, status:, to:, answered_at: nil, cost: nil, duration_seconds: nil, ended_at: nil, end_reason: nil, metadata: nil, transcript: nil, turn_count: nil, updated_at: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Zavudev::Models::CallCreateResponse::Call} for more details.
+        #
+        #   @param id [String]
+        #
+        #   @param created_at [Time]
+        #
+        #   @param direction [Symbol, Zavudev::Models::CallCreateResponse::Call::Direction] Whether the call was placed by Zavu (outbound) or received from a caller (inboun
+        #
+        #   @param from [String] Caller phone number in E.164 format. Your sender's number for outbound calls; th
+        #
+        #   @param status [Symbol, Zavudev::Models::CallCreateResponse::Call::Status] Lifecycle status of a voice call.
+        #
+        #   @param to [String] Callee phone number in E.164 format.
+        #
+        #   @param answered_at [Time, nil] When the call was answered.
+        #
+        #   @param cost [Float, nil] Total cost of the call in USD, combining the managed voice pipeline per-minute c
+        #
+        #   @param duration_seconds [Integer, nil] Billable talk time in seconds, measured from answer to hangup.
+        #
+        #   @param ended_at [Time, nil] When the call ended.
+        #
+        #   @param end_reason [String, nil] Why the call ended (e.g. `agent_ended`, `max_duration`, `transfer`, `hangup`). P
+        #
+        #   @param metadata [Hash{Symbol=>String}] Arbitrary metadata you attached when creating the call.
+        #
+        #   @param transcript [Array<Zavudev::Models::CallCreateResponse::Call::Transcript>] Ordered transcript of the call. Included when retrieving a single call; omitted
+        #
+        #   @param turn_count [Integer, nil] Number of conversation turns exchanged during the call.
+        #
+        #   @param updated_at [Time]
+
+        # Whether the call was placed by Zavu (outbound) or received from a caller
+        # (inbound).
+        #
+        # @see Zavudev::Models::CallCreateResponse::Call#direction
+        module Direction
+          extend Zavudev::Internal::Type::Enum
+
+          INBOUND = :inbound
+          OUTBOUND = :outbound
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # Lifecycle status of a voice call.
+        #
+        # - `queued`: outbound call created, not yet dialing.
+        # - `ringing`: dialing (outbound) or received and ringing (inbound).
+        # - `in_progress`: answered, the agent is connected.
+        # - `completed`: ended after a conversation.
+        # - `failed`: could not be completed.
+        # - `busy`: the line was busy.
+        # - `no_answer`: rang but was not answered.
+        # - `canceled`: canceled before it was answered.
+        #
+        # @see Zavudev::Models::CallCreateResponse::Call#status
+        module Status
+          extend Zavudev::Internal::Type::Enum
+
+          QUEUED = :queued
+          RINGING = :ringing
+          IN_PROGRESS = :in_progress
+          COMPLETED = :completed
+          FAILED = :failed
+          BUSY = :busy
+          NO_ANSWER = :no_answer
+          CANCELED = :canceled
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        class Transcript < Zavudev::Internal::Type::BaseModel
+          # @!attribute role
+          #   Who produced the turn. `tool` records a tool call the agent made during the
+          #   conversation.
+          #
+          #   @return [Symbol, Zavudev::Models::CallCreateResponse::Call::Transcript::Role]
+          required :role, enum: -> { Zavudev::Models::CallCreateResponse::Call::Transcript::Role }
+
+          # @!attribute seq
+          #   Ordinal position of the turn within the call, starting at 0.
+          #
+          #   @return [Integer]
+          required :seq, Integer
+
+          # @!attribute text
+          #   Transcribed speech for `user` and `assistant` turns, or a JSON summary of the
+          #   tool call for `tool` turns.
+          #
+          #   @return [String]
+          required :text, String
+
+          # @!attribute ended_at
+          #   When the turn ended.
+          #
+          #   @return [Time, nil]
+          optional :ended_at, Time, api_name: :endedAt, nil?: true
+
+          # @!attribute started_at
+          #   When the turn started.
+          #
+          #   @return [Time, nil]
+          optional :started_at, Time, api_name: :startedAt, nil?: true
+
+          # @!method initialize(role:, seq:, text:, ended_at: nil, started_at: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Zavudev::Models::CallCreateResponse::Call::Transcript} for more details.
+          #
+          #   A single turn in a voice call transcript.
+          #
+          #   @param role [Symbol, Zavudev::Models::CallCreateResponse::Call::Transcript::Role] Who produced the turn. `tool` records a tool call the agent made during the conv
+          #
+          #   @param seq [Integer] Ordinal position of the turn within the call, starting at 0.
+          #
+          #   @param text [String] Transcribed speech for `user` and `assistant` turns, or a JSON summary of the to
+          #
+          #   @param ended_at [Time, nil] When the turn ended.
+          #
+          #   @param started_at [Time, nil] When the turn started.
+
+          # Who produced the turn. `tool` records a tool call the agent made during the
+          # conversation.
+          #
+          # @see Zavudev::Models::CallCreateResponse::Call::Transcript#role
+          module Role
+            extend Zavudev::Internal::Type::Enum
+
+            USER = :user
+            ASSISTANT = :assistant
+            TOOL = :tool
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+    end
+  end
+end

data/lib/zavudev/models/call_hangup_params.rb

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

data/lib/zavudev/models/call_hangup_response.rb

@@ -0,0 +1,262 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Models
+    # @see Zavudev::Resources::Calls#hangup
+    class CallHangupResponse < Zavudev::Internal::Type::BaseModel
+      # @!attribute call
+      #
+      #   @return [Zavudev::Models::CallHangupResponse::Call]
+      required :call, -> { Zavudev::Models::CallHangupResponse::Call }
+
+      # @!method initialize(call:)
+      #   @param call [Zavudev::Models::CallHangupResponse::Call]
+
+      # @see Zavudev::Models::CallHangupResponse#call
+      class Call < Zavudev::Internal::Type::BaseModel
+        # @!attribute id
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute created_at
+        #
+        #   @return [Time]
+        required :created_at, Time, api_name: :createdAt
+
+        # @!attribute direction
+        #   Whether the call was placed by Zavu (outbound) or received from a caller
+        #   (inbound).
+        #
+        #   @return [Symbol, Zavudev::Models::CallHangupResponse::Call::Direction]
+        required :direction, enum: -> { Zavudev::Models::CallHangupResponse::Call::Direction }
+
+        # @!attribute from
+        #   Caller phone number in E.164 format. Your sender's number for outbound calls;
+        #   the caller's number for inbound calls.
+        #
+        #   @return [String]
+        required :from, String
+
+        # @!attribute status
+        #   Lifecycle status of a voice call.
+        #
+        #   - `queued`: outbound call created, not yet dialing.
+        #   - `ringing`: dialing (outbound) or received and ringing (inbound).
+        #   - `in_progress`: answered, the agent is connected.
+        #   - `completed`: ended after a conversation.
+        #   - `failed`: could not be completed.
+        #   - `busy`: the line was busy.
+        #   - `no_answer`: rang but was not answered.
+        #   - `canceled`: canceled before it was answered.
+        #
+        #   @return [Symbol, Zavudev::Models::CallHangupResponse::Call::Status]
+        required :status, enum: -> { Zavudev::Models::CallHangupResponse::Call::Status }
+
+        # @!attribute to
+        #   Callee phone number in E.164 format.
+        #
+        #   @return [String]
+        required :to, String
+
+        # @!attribute answered_at
+        #   When the call was answered.
+        #
+        #   @return [Time, nil]
+        optional :answered_at, Time, api_name: :answeredAt, nil?: true
+
+        # @!attribute cost
+        #   Total cost of the call in USD, combining the managed voice pipeline per-minute
+        #   charge and telephony. Available once the call has ended.
+        #
+        #   @return [Float, nil]
+        optional :cost, Float, nil?: true
+
+        # @!attribute duration_seconds
+        #   Billable talk time in seconds, measured from answer to hangup.
+        #
+        #   @return [Integer, nil]
+        optional :duration_seconds, Integer, api_name: :durationSeconds, nil?: true
+
+        # @!attribute ended_at
+        #   When the call ended.
+        #
+        #   @return [Time, nil]
+        optional :ended_at, Time, api_name: :endedAt, nil?: true
+
+        # @!attribute end_reason
+        #   Why the call ended (e.g. `agent_ended`, `max_duration`, `transfer`, `hangup`).
+        #   Present once the call is no longer active.
+        #
+        #   @return [String, nil]
+        optional :end_reason, String, api_name: :endReason, nil?: true
+
+        # @!attribute metadata
+        #   Arbitrary metadata you attached when creating the call.
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :metadata, Zavudev::Internal::Type::HashOf[String]
+
+        # @!attribute transcript
+        #   Ordered transcript of the call. Included when retrieving a single call; omitted
+        #   from list responses.
+        #
+        #   @return [Array<Zavudev::Models::CallHangupResponse::Call::Transcript>, nil]
+        optional :transcript,
+                 -> { Zavudev::Internal::Type::ArrayOf[Zavudev::Models::CallHangupResponse::Call::Transcript] }
+
+        # @!attribute turn_count
+        #   Number of conversation turns exchanged during the call.
+        #
+        #   @return [Integer, nil]
+        optional :turn_count, Integer, api_name: :turnCount, nil?: true
+
+        # @!attribute updated_at
+        #
+        #   @return [Time, nil]
+        optional :updated_at, Time, api_name: :updatedAt
+
+        # @!method initialize(id:, created_at:, direction:, from:, status:, to:, answered_at: nil, cost: nil, duration_seconds: nil, ended_at: nil, end_reason: nil, metadata: nil, transcript: nil, turn_count: nil, updated_at: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Zavudev::Models::CallHangupResponse::Call} for more details.
+        #
+        #   @param id [String]
+        #
+        #   @param created_at [Time]
+        #
+        #   @param direction [Symbol, Zavudev::Models::CallHangupResponse::Call::Direction] Whether the call was placed by Zavu (outbound) or received from a caller (inboun
+        #
+        #   @param from [String] Caller phone number in E.164 format. Your sender's number for outbound calls; th
+        #
+        #   @param status [Symbol, Zavudev::Models::CallHangupResponse::Call::Status] Lifecycle status of a voice call.
+        #
+        #   @param to [String] Callee phone number in E.164 format.
+        #
+        #   @param answered_at [Time, nil] When the call was answered.
+        #
+        #   @param cost [Float, nil] Total cost of the call in USD, combining the managed voice pipeline per-minute c
+        #
+        #   @param duration_seconds [Integer, nil] Billable talk time in seconds, measured from answer to hangup.
+        #
+        #   @param ended_at [Time, nil] When the call ended.
+        #
+        #   @param end_reason [String, nil] Why the call ended (e.g. `agent_ended`, `max_duration`, `transfer`, `hangup`). P
+        #
+        #   @param metadata [Hash{Symbol=>String}] Arbitrary metadata you attached when creating the call.
+        #
+        #   @param transcript [Array<Zavudev::Models::CallHangupResponse::Call::Transcript>] Ordered transcript of the call. Included when retrieving a single call; omitted
+        #
+        #   @param turn_count [Integer, nil] Number of conversation turns exchanged during the call.
+        #
+        #   @param updated_at [Time]
+
+        # Whether the call was placed by Zavu (outbound) or received from a caller
+        # (inbound).
+        #
+        # @see Zavudev::Models::CallHangupResponse::Call#direction
+        module Direction
+          extend Zavudev::Internal::Type::Enum
+
+          INBOUND = :inbound
+          OUTBOUND = :outbound
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # Lifecycle status of a voice call.
+        #
+        # - `queued`: outbound call created, not yet dialing.
+        # - `ringing`: dialing (outbound) or received and ringing (inbound).
+        # - `in_progress`: answered, the agent is connected.
+        # - `completed`: ended after a conversation.
+        # - `failed`: could not be completed.
+        # - `busy`: the line was busy.
+        # - `no_answer`: rang but was not answered.
+        # - `canceled`: canceled before it was answered.
+        #
+        # @see Zavudev::Models::CallHangupResponse::Call#status
+        module Status
+          extend Zavudev::Internal::Type::Enum
+
+          QUEUED = :queued
+          RINGING = :ringing
+          IN_PROGRESS = :in_progress
+          COMPLETED = :completed
+          FAILED = :failed
+          BUSY = :busy
+          NO_ANSWER = :no_answer
+          CANCELED = :canceled
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        class Transcript < Zavudev::Internal::Type::BaseModel
+          # @!attribute role
+          #   Who produced the turn. `tool` records a tool call the agent made during the
+          #   conversation.
+          #
+          #   @return [Symbol, Zavudev::Models::CallHangupResponse::Call::Transcript::Role]
+          required :role, enum: -> { Zavudev::Models::CallHangupResponse::Call::Transcript::Role }
+
+          # @!attribute seq
+          #   Ordinal position of the turn within the call, starting at 0.
+          #
+          #   @return [Integer]
+          required :seq, Integer
+
+          # @!attribute text
+          #   Transcribed speech for `user` and `assistant` turns, or a JSON summary of the
+          #   tool call for `tool` turns.
+          #
+          #   @return [String]
+          required :text, String
+
+          # @!attribute ended_at
+          #   When the turn ended.
+          #
+          #   @return [Time, nil]
+          optional :ended_at, Time, api_name: :endedAt, nil?: true
+
+          # @!attribute started_at
+          #   When the turn started.
+          #
+          #   @return [Time, nil]
+          optional :started_at, Time, api_name: :startedAt, nil?: true
+
+          # @!method initialize(role:, seq:, text:, ended_at: nil, started_at: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Zavudev::Models::CallHangupResponse::Call::Transcript} for more details.
+          #
+          #   A single turn in a voice call transcript.
+          #
+          #   @param role [Symbol, Zavudev::Models::CallHangupResponse::Call::Transcript::Role] Who produced the turn. `tool` records a tool call the agent made during the conv
+          #
+          #   @param seq [Integer] Ordinal position of the turn within the call, starting at 0.
+          #
+          #   @param text [String] Transcribed speech for `user` and `assistant` turns, or a JSON summary of the to
+          #
+          #   @param ended_at [Time, nil] When the turn ended.
+          #
+          #   @param started_at [Time, nil] When the turn started.
+
+          # Who produced the turn. `tool` records a tool call the agent made during the
+          # conversation.
+          #
+          # @see Zavudev::Models::CallHangupResponse::Call::Transcript#role
+          module Role
+            extend Zavudev::Internal::Type::Enum
+
+            USER = :user
+            ASSISTANT = :assistant
+            TOOL = :tool
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
+      end
+    end
+  end
+end