moonbase-sdk 0.1.0.pre.alpha.2 → 0.1.0.pre.alpha.4

data/lib/moonbase/models/call.rb

@@ -10,6 +10,12 @@ module Moonbase
       #   @return [String]
       required :id, String
 
+      # @!attribute created_at
+      #   Time at which the object was created, as an ISO 8601 timestamp in UTC.
+      #
+      #   @return [Time]
+      required :created_at, Time
+
       # @!attribute direction
       #   The direction of the call, either `incoming` or `outgoing`.
       #
@@ -34,38 +40,38 @@ module Moonbase
       #   @return [String]
       required :provider_id, String
 
+      # @!attribute provider_status
+      #   The current status of the call.
+      #
+      #   @return [String]
+      required :provider_status, String
+
       # @!attribute start_at
-      #   The time the call started, as an RFC 3339 timestamp.
+      #   The time the call started, as an ISO 8601 timestamp in UTC.
       #
       #   @return [Time]
       required :start_at, Time
 
-      # @!attribute status
-      #   The current status of the call.
-      #
-      #   @return [Symbol, Moonbase::Models::Call::Status]
-      required :status, enum: -> { Moonbase::Call::Status }
-
       # @!attribute type
       #   String representing the object’s type. Always `call` for this object.
       #
       #   @return [Symbol, :call]
       required :type, const: :call
 
-      # @!attribute answered_at
-      #   The time the call was answered, if available, as an RFC 3339 timestamp.
+      # @!attribute updated_at
+      #   Time at which the object was last updated, as an ISO 8601 timestamp in UTC.
       #
-      #   @return [Time, nil]
-      optional :answered_at, Time
+      #   @return [Time]
+      required :updated_at, Time
 
-      # @!attribute created_at
-      #   Time at which the object was created, as an RFC 3339 timestamp.
+      # @!attribute answered_at
+      #   The time the call was answered, if available, as an ISO 8601 timestamp in UTC.
       #
       #   @return [Time, nil]
-      optional :created_at, Time
+      optional :answered_at, Time
 
       # @!attribute end_at
-      #   The time the call ended, if available, as an RFC 3339 timestamp.
+      #   The time the call ended, if available, as an ISO 8601 timestamp in UTC.
       #
       #   @return [Time, nil]
       optional :end_at, Time
@@ -76,18 +82,14 @@ module Moonbase
       #   @return [Hash{Symbol=>Object}, nil]
       optional :provider_metadata, Moonbase::Internal::Type::HashOf[Moonbase::Internal::Type::Unknown]
 
-      # @!attribute updated_at
-      #   Time at which the object was last updated, as an RFC 3339 timestamp.
-      #
-      #   @return [Time, nil]
-      optional :updated_at, Time
-
-      # @!method initialize(id:, direction:, participants:, provider:, provider_id:, start_at:, status:, answered_at: nil, created_at: nil, end_at: nil, provider_metadata: nil, updated_at: nil, type: :call)
+      # @!method initialize(id:, created_at:, direction:, participants:, provider:, provider_id:, provider_status:, start_at:, updated_at:, answered_at: nil, end_at: nil, provider_metadata: nil, type: :call)
       #   The Call object represents a phone call that has been logged in the system. It
       #   contains details about the participants, timing, and outcome of the call.
       #
       #   @param id [String] Unique identifier for the object.
       #
+      #   @param created_at [Time] Time at which the object was created, as an ISO 8601 timestamp in UTC.
+      #
       #   @param direction [Symbol, Moonbase::Models::Call::Direction] The direction of the call, either `incoming` or `outgoing`.
       #
       #   @param participants [Array<Moonbase::Models::Call::Participant>] The participants involved in the call.
@@ -96,20 +98,18 @@ module Moonbase
       #
       #   @param provider_id [String] The unique identifier for the call from the provider's system.
       #
-      #   @param start_at [Time] The time the call started, as an RFC 3339 timestamp.
+      #   @param provider_status [String] The current status of the call.
       #
-      #   @param status [Symbol, Moonbase::Models::Call::Status] The current status of the call.
+      #   @param start_at [Time] The time the call started, as an ISO 8601 timestamp in UTC.
       #
-      #   @param answered_at [Time] The time the call was answered, if available, as an RFC 3339 timestamp.
+      #   @param updated_at [Time] Time at which the object was last updated, as an ISO 8601 timestamp in UTC.
       #
-      #   @param created_at [Time] Time at which the object was created, as an RFC 3339 timestamp.
+      #   @param answered_at [Time] The time the call was answered, if available, as an ISO 8601 timestamp in UTC.
       #
-      #   @param end_at [Time] The time the call ended, if available, as an RFC 3339 timestamp.
+      #   @param end_at [Time] The time the call ended, if available, as an ISO 8601 timestamp in UTC.
       #
       #   @param provider_metadata [Hash{Symbol=>Object}] A hash of additional metadata from the provider.
       #
-      #   @param updated_at [Time] Time at which the object was last updated, as an RFC 3339 timestamp.
-      #
       #   @param type [Symbol, :call] String representing the object’s type. Always `call` for this object.
 
       # The direction of the call, either `incoming` or `outgoing`.
@@ -145,24 +145,28 @@ module Moonbase
         required :role, enum: -> { Moonbase::Call::Participant::Role }
 
         # @!attribute type
-        #   String representing the object’s type. Always `participant` for this object.
+        #   String representing the object’s type. Always `call_participant` for this
+        #   object.
         #
-        #   @return [Symbol, :participant]
-        required :type, const: :participant
+        #   @return [Symbol, :call_participant]
+        required :type, const: :call_participant
 
-        # @!attribute created_at
-        #   Time at which the object was created, as an RFC 3339 timestamp.
+        # @!attribute organization
+        #   A lightweight reference to another resource.
         #
-        #   @return [Time, nil]
-        optional :created_at, Time
+        #   @return [Moonbase::Models::Pointer, nil]
+        optional :organization, -> { Moonbase::Pointer }
 
-        # @!attribute updated_at
-        #   Time at which the object was last updated, as an RFC 3339 timestamp.
+        # @!attribute person
+        #   A lightweight reference to another resource.
         #
-        #   @return [Time, nil]
-        optional :updated_at, Time
+        #   @return [Moonbase::Models::Pointer, nil]
+        optional :person, -> { Moonbase::Pointer }
 
-        # @!method initialize(id:, phone:, role:, created_at: nil, updated_at: nil, type: :participant)
+        # @!method initialize(id:, phone:, role:, organization: nil, person: nil, type: :call_participant)
+        #   Some parameter documentations has been truncated, see
+        #   {Moonbase::Models::Call::Participant} for more details.
+        #
         #   Represents a participant in a call.
         #
         #   @param id [String] Unique identifier for the object.
@@ -171,11 +175,11 @@ module Moonbase
         #
         #   @param role [Symbol, Moonbase::Models::Call::Participant::Role] The role of the participant in the call. Can be `caller`, `callee`, or `other`.
         #
-        #   @param created_at [Time] Time at which the object was created, as an RFC 3339 timestamp.
+        #   @param organization [Moonbase::Models::Pointer] A lightweight reference to another resource.
         #
-        #   @param updated_at [Time] Time at which the object was last updated, as an RFC 3339 timestamp.
+        #   @param person [Moonbase::Models::Pointer] A lightweight reference to another resource.
         #
-        #   @param type [Symbol, :participant] String representing the object’s type. Always `participant` for this object.
+        #   @param type [Symbol, :call_participant] String representing the object’s type. Always `call_participant` for this object
 
         # The role of the participant in the call. Can be `caller`, `callee`, or `other`.
         #
@@ -191,30 +195,6 @@ module Moonbase
           #   @return [Array<Symbol>]
         end
       end
-
-      # The current status of the call.
-      #
-      # @see Moonbase::Models::Call#status
-      module Status
-        extend Moonbase::Internal::Type::Enum
-
-        QUEUED = :queued
-        INITIATED = :initiated
-        RINGING = :ringing
-        IN_PROGRESS = :in_progress
-        COMPLETED = :completed
-        BUSY = :busy
-        FAILED = :failed
-        NO_ANSWER = :no_answer
-        CANCELED = :canceled
-        MISSED = :missed
-        ANSWERED = :answered
-        FORWARDED = :forwarded
-        ABANDONED = :abandoned
-
-        # @!method self.values
-        #   @return [Array<Symbol>]
-      end
     end
   end
 end

data/lib/moonbase/models/call_create_params.rb

@@ -17,10 +17,7 @@ module Moonbase
       #   An array of participants involved in the call.
       #
       #   @return [Array<Moonbase::Models::CallCreateParams::Participant>]
-      required :participants,
-               -> {
-                 Moonbase::Internal::Type::ArrayOf[Moonbase::CallCreateParams::Participant]
-               }
+      required :participants, -> { Moonbase::Internal::Type::ArrayOf[Moonbase::CallCreateParams::Participant] }
 
       # @!attribute provider
       #   The name of the phone provider that handled the call (e.g., `openphone`).
@@ -34,26 +31,26 @@ module Moonbase
       #   @return [String]
       required :provider_id, String
 
+      # @!attribute provider_status
+      #   The status of the call.
+      #
+      #   @return [String]
+      required :provider_status, String
+
       # @!attribute start_at
-      #   The time the call started, as an RFC 3339 timestamp.
+      #   The time the call started, as an ISO 8601 timestamp in UTC.
       #
       #   @return [Time]
       required :start_at, Time
 
-      # @!attribute status
-      #   The status of the call.
-      #
-      #   @return [Symbol, Moonbase::Models::CallCreateParams::Status]
-      required :status, enum: -> { Moonbase::CallCreateParams::Status }
-
       # @!attribute answered_at
-      #   The time the call was answered, as an RFC 3339 timestamp.
+      #   The time the call was answered, as an ISO 8601 timestamp in UTC.
       #
       #   @return [Time, nil]
       optional :answered_at, Time
 
       # @!attribute end_at
-      #   The time the call ended, as an RFC 3339 timestamp.
+      #   The time the call ended, as an ISO 8601 timestamp in UTC.
       #
       #   @return [Time, nil]
       optional :end_at, Time
@@ -64,7 +61,19 @@ module Moonbase
       #   @return [Hash{Symbol=>Object}, nil]
       optional :provider_metadata, Moonbase::Internal::Type::HashOf[Moonbase::Internal::Type::Unknown]
 
-      # @!method initialize(direction:, participants:, provider:, provider_id:, start_at:, status:, answered_at: nil, end_at: nil, provider_metadata: nil, request_options: {})
+      # @!attribute recordings
+      #   Any recordings associated with the call.
+      #
+      #   @return [Array<Moonbase::Models::CallCreateParams::Recording>, nil]
+      optional :recordings, -> { Moonbase::Internal::Type::ArrayOf[Moonbase::CallCreateParams::Recording] }
+
+      # @!attribute transcript
+      #   A transcript of the call.
+      #
+      #   @return [Moonbase::Models::CallCreateParams::Transcript, nil]
+      optional :transcript, -> { Moonbase::CallCreateParams::Transcript }
+
+      # @!method initialize(direction:, participants:, provider:, provider_id:, provider_status:, start_at:, answered_at: nil, end_at: nil, provider_metadata: nil, recordings: nil, transcript: nil, request_options: {})
       #   @param direction [Symbol, Moonbase::Models::CallCreateParams::Direction] The direction of the call, either `incoming` or `outgoing`.
       #
       #   @param participants [Array<Moonbase::Models::CallCreateParams::Participant>] An array of participants involved in the call.
@@ -73,16 +82,20 @@ module Moonbase
       #
       #   @param provider_id [String] The unique identifier for the call from the provider's system.
       #
-      #   @param start_at [Time] The time the call started, as an RFC 3339 timestamp.
+      #   @param provider_status [String] The status of the call.
       #
-      #   @param status [Symbol, Moonbase::Models::CallCreateParams::Status] The status of the call.
+      #   @param start_at [Time] The time the call started, as an ISO 8601 timestamp in UTC.
       #
-      #   @param answered_at [Time] The time the call was answered, as an RFC 3339 timestamp.
+      #   @param answered_at [Time] The time the call was answered, as an ISO 8601 timestamp in UTC.
       #
-      #   @param end_at [Time] The time the call ended, as an RFC 3339 timestamp.
+      #   @param end_at [Time] The time the call ended, as an ISO 8601 timestamp in UTC.
       #
       #   @param provider_metadata [Hash{Symbol=>Object}] A hash of additional metadata from the provider.
       #
+      #   @param recordings [Array<Moonbase::Models::CallCreateParams::Recording>] Any recordings associated with the call.
+      #
+      #   @param transcript [Moonbase::Models::CallCreateParams::Transcript] A transcript of the call.
+      #
       #   @param request_options [Moonbase::RequestOptions, Hash{Symbol=>Object}]
 
       # The direction of the call, either `incoming` or `outgoing`.
@@ -131,26 +144,92 @@ module Moonbase
         end
       end
 
-      # The status of the call.
-      module Status
-        extend Moonbase::Internal::Type::Enum
+      class Recording < Moonbase::Internal::Type::BaseModel
+        # @!attribute content_type
+        #   The content type of the recording. Note that only `audio/mpeg` is supported at
+        #   this time.
+        #
+        #   @return [String]
+        required :content_type, String
+
+        # @!attribute provider_id
+        #   The unique identifier for the recording from the provider's system.
+        #
+        #   @return [String]
+        required :provider_id, String
 
-        QUEUED = :queued
-        INITIATED = :initiated
-        RINGING = :ringing
-        IN_PROGRESS = :in_progress
-        COMPLETED = :completed
-        BUSY = :busy
-        FAILED = :failed
-        NO_ANSWER = :no_answer
-        CANCELED = :canceled
-        MISSED = :missed
-        ANSWERED = :answered
-        FORWARDED = :forwarded
-        ABANDONED = :abandoned
+        # @!attribute url
+        #   The URL pointing to the recording.
+        #
+        #   @return [String]
+        required :url, String
 
-        # @!method self.values
-        #   @return [Array<Symbol>]
+        # @!method initialize(content_type:, provider_id:, url:)
+        #   Some parameter documentations has been truncated, see
+        #   {Moonbase::Models::CallCreateParams::Recording} for more details.
+        #
+        #   Parameters for creating a `CallRecording` object.
+        #
+        #   @param content_type [String] The content type of the recording. Note that only `audio/mpeg` is supported at t
+        #
+        #   @param provider_id [String] The unique identifier for the recording from the provider's system.
+        #
+        #   @param url [String] The URL pointing to the recording.
+      end
+
+      class Transcript < Moonbase::Internal::Type::BaseModel
+        # @!attribute cues
+        #   A list of cues that identify the text spoken in specific time slices of the
+        #   call.
+        #
+        #   @return [Array<Moonbase::Models::CallCreateParams::Transcript::Cue>]
+        required :cues, -> { Moonbase::Internal::Type::ArrayOf[Moonbase::CallCreateParams::Transcript::Cue] }
+
+        # @!method initialize(cues:)
+        #   Some parameter documentations has been truncated, see
+        #   {Moonbase::Models::CallCreateParams::Transcript} for more details.
+        #
+        #   A transcript of the call.
+        #
+        #   @param cues [Array<Moonbase::Models::CallCreateParams::Transcript::Cue>] A list of cues that identify the text spoken in specific time slices of the call
+
+        class Cue < Moonbase::Internal::Type::BaseModel
+          # @!attribute from
+          #   The start time of the slice, in fractional seconds from the start of the call.
+          #
+          #   @return [Float]
+          required :from, Float
+
+          # @!attribute speaker
+          #   The E.164 formatted phone number of the speaker.
+          #
+          #   @return [String]
+          required :speaker, String
+
+          # @!attribute text
+          #   The text spoken during the slice.
+          #
+          #   @return [String]
+          required :text, String
+
+          # @!attribute to
+          #   The end time of the slice, in fractional seconds from the start of the call.
+          #
+          #   @return [Float]
+          required :to, Float
+
+          # @!method initialize(from:, speaker:, text:, to:)
+          #   Parameters for creating a `CallTranscriptCue` object to capture the text spoken
+          #   in a specific time slice.
+          #
+          #   @param from [Float] The start time of the slice, in fractional seconds from the start of the call.
+          #
+          #   @param speaker [String] The E.164 formatted phone number of the speaker.
+          #
+          #   @param text [String] The text spoken during the slice.
+          #
+          #   @param to [Float] The end time of the slice, in fractional seconds from the start of the call.
+        end
       end
     end
   end

data/lib/moonbase/models/call_upsert_params.rb

@@ -0,0 +1,236 @@
+# frozen_string_literal: true
+
+module Moonbase
+  module Models
+    # @see Moonbase::Resources::Calls#upsert
+    class CallUpsertParams < Moonbase::Internal::Type::BaseModel
+      extend Moonbase::Internal::Type::RequestParameters::Converter
+      include Moonbase::Internal::Type::RequestParameters
+
+      # @!attribute direction
+      #   The direction of the call, either `incoming` or `outgoing`.
+      #
+      #   @return [Symbol, Moonbase::Models::CallUpsertParams::Direction]
+      required :direction, enum: -> { Moonbase::CallUpsertParams::Direction }
+
+      # @!attribute participants
+      #   An array of participants involved in the call.
+      #
+      #   @return [Array<Moonbase::Models::CallUpsertParams::Participant>]
+      required :participants, -> { Moonbase::Internal::Type::ArrayOf[Moonbase::CallUpsertParams::Participant] }
+
+      # @!attribute provider
+      #   The name of the phone provider that handled the call (e.g., `openphone`).
+      #
+      #   @return [String]
+      required :provider, String
+
+      # @!attribute provider_id
+      #   The unique identifier for the call from the provider's system.
+      #
+      #   @return [String]
+      required :provider_id, String
+
+      # @!attribute provider_status
+      #   The status of the call.
+      #
+      #   @return [String]
+      required :provider_status, String
+
+      # @!attribute start_at
+      #   The time the call started, as an ISO 8601 timestamp in UTC.
+      #
+      #   @return [Time]
+      required :start_at, Time
+
+      # @!attribute answered_at
+      #   The time the call was answered, as an ISO 8601 timestamp in UTC.
+      #
+      #   @return [Time, nil]
+      optional :answered_at, Time
+
+      # @!attribute end_at
+      #   The time the call ended, as an ISO 8601 timestamp in UTC.
+      #
+      #   @return [Time, nil]
+      optional :end_at, Time
+
+      # @!attribute provider_metadata
+      #   A hash of additional metadata from the provider.
+      #
+      #   @return [Hash{Symbol=>Object}, nil]
+      optional :provider_metadata, Moonbase::Internal::Type::HashOf[Moonbase::Internal::Type::Unknown]
+
+      # @!attribute recordings
+      #   Any recordings associated with the call.
+      #
+      #   @return [Array<Moonbase::Models::CallUpsertParams::Recording>, nil]
+      optional :recordings, -> { Moonbase::Internal::Type::ArrayOf[Moonbase::CallUpsertParams::Recording] }
+
+      # @!attribute transcript
+      #   A transcript of the call.
+      #
+      #   @return [Moonbase::Models::CallUpsertParams::Transcript, nil]
+      optional :transcript, -> { Moonbase::CallUpsertParams::Transcript }
+
+      # @!method initialize(direction:, participants:, provider:, provider_id:, provider_status:, start_at:, answered_at: nil, end_at: nil, provider_metadata: nil, recordings: nil, transcript: nil, request_options: {})
+      #   @param direction [Symbol, Moonbase::Models::CallUpsertParams::Direction] The direction of the call, either `incoming` or `outgoing`.
+      #
+      #   @param participants [Array<Moonbase::Models::CallUpsertParams::Participant>] An array of participants involved in the call.
+      #
+      #   @param provider [String] The name of the phone provider that handled the call (e.g., `openphone`).
+      #
+      #   @param provider_id [String] The unique identifier for the call from the provider's system.
+      #
+      #   @param provider_status [String] The status of the call.
+      #
+      #   @param start_at [Time] The time the call started, as an ISO 8601 timestamp in UTC.
+      #
+      #   @param answered_at [Time] The time the call was answered, as an ISO 8601 timestamp in UTC.
+      #
+      #   @param end_at [Time] The time the call ended, as an ISO 8601 timestamp in UTC.
+      #
+      #   @param provider_metadata [Hash{Symbol=>Object}] A hash of additional metadata from the provider.
+      #
+      #   @param recordings [Array<Moonbase::Models::CallUpsertParams::Recording>] Any recordings associated with the call.
+      #
+      #   @param transcript [Moonbase::Models::CallUpsertParams::Transcript] A transcript of the call.
+      #
+      #   @param request_options [Moonbase::RequestOptions, Hash{Symbol=>Object}]
+
+      # The direction of the call, either `incoming` or `outgoing`.
+      module Direction
+        extend Moonbase::Internal::Type::Enum
+
+        INCOMING = :incoming
+        OUTGOING = :outgoing
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      class Participant < Moonbase::Internal::Type::BaseModel
+        # @!attribute phone
+        #   The E.164 formatted phone number of the participant.
+        #
+        #   @return [String]
+        required :phone, String
+
+        # @!attribute role
+        #   The role of the participant in the call. Can be `caller`, `callee`, or `other`.
+        #
+        #   @return [Symbol, Moonbase::Models::CallUpsertParams::Participant::Role]
+        required :role, enum: -> { Moonbase::CallUpsertParams::Participant::Role }
+
+        # @!method initialize(phone:, role:)
+        #   Parameters for creating a `Participant` object.
+        #
+        #   @param phone [String] The E.164 formatted phone number of the participant.
+        #
+        #   @param role [Symbol, Moonbase::Models::CallUpsertParams::Participant::Role] The role of the participant in the call. Can be `caller`, `callee`, or `other`.
+
+        # The role of the participant in the call. Can be `caller`, `callee`, or `other`.
+        #
+        # @see Moonbase::Models::CallUpsertParams::Participant#role
+        module Role
+          extend Moonbase::Internal::Type::Enum
+
+          CALLER = :caller
+          CALLEE = :callee
+          OTHER = :other
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+
+      class Recording < Moonbase::Internal::Type::BaseModel
+        # @!attribute content_type
+        #   The content type of the recording. Note that only `audio/mpeg` is supported at
+        #   this time.
+        #
+        #   @return [String]
+        required :content_type, String
+
+        # @!attribute provider_id
+        #   The unique identifier for the recording from the provider's system.
+        #
+        #   @return [String]
+        required :provider_id, String
+
+        # @!attribute url
+        #   The URL pointing to the recording.
+        #
+        #   @return [String]
+        required :url, String
+
+        # @!method initialize(content_type:, provider_id:, url:)
+        #   Some parameter documentations has been truncated, see
+        #   {Moonbase::Models::CallUpsertParams::Recording} for more details.
+        #
+        #   Parameters for creating a `CallRecording` object.
+        #
+        #   @param content_type [String] The content type of the recording. Note that only `audio/mpeg` is supported at t
+        #
+        #   @param provider_id [String] The unique identifier for the recording from the provider's system.
+        #
+        #   @param url [String] The URL pointing to the recording.
+      end
+
+      class Transcript < Moonbase::Internal::Type::BaseModel
+        # @!attribute cues
+        #   A list of cues that identify the text spoken in specific time slices of the
+        #   call.
+        #
+        #   @return [Array<Moonbase::Models::CallUpsertParams::Transcript::Cue>]
+        required :cues, -> { Moonbase::Internal::Type::ArrayOf[Moonbase::CallUpsertParams::Transcript::Cue] }
+
+        # @!method initialize(cues:)
+        #   Some parameter documentations has been truncated, see
+        #   {Moonbase::Models::CallUpsertParams::Transcript} for more details.
+        #
+        #   A transcript of the call.
+        #
+        #   @param cues [Array<Moonbase::Models::CallUpsertParams::Transcript::Cue>] A list of cues that identify the text spoken in specific time slices of the call
+
+        class Cue < Moonbase::Internal::Type::BaseModel
+          # @!attribute from
+          #   The start time of the slice, in fractional seconds from the start of the call.
+          #
+          #   @return [Float]
+          required :from, Float
+
+          # @!attribute speaker
+          #   The E.164 formatted phone number of the speaker.
+          #
+          #   @return [String]
+          required :speaker, String
+
+          # @!attribute text
+          #   The text spoken during the slice.
+          #
+          #   @return [String]
+          required :text, String
+
+          # @!attribute to
+          #   The end time of the slice, in fractional seconds from the start of the call.
+          #
+          #   @return [Float]
+          required :to, Float
+
+          # @!method initialize(from:, speaker:, text:, to:)
+          #   Parameters for creating a `CallTranscriptCue` object to capture the text spoken
+          #   in a specific time slice.
+          #
+          #   @param from [Float] The start time of the slice, in fractional seconds from the start of the call.
+          #
+          #   @param speaker [String] The E.164 formatted phone number of the speaker.
+          #
+          #   @param text [String] The text spoken during the slice.
+          #
+          #   @param to [Float] The end time of the slice, in fractional seconds from the start of the call.
+        end
+      end
+    end
+  end
+end