livekit-server-sdk 0.8.3 → 1.0.0

data/lib/livekit/egress_service_client.rb

@@ -3,6 +3,7 @@
 require "livekit/proto/livekit_egress_twirp"
 require "livekit/auth_mixin"
 require 'livekit/utils'
+require 'livekit/failover'
 
 module LiveKit
   class EgressServiceClient < Twirp::Client
@@ -10,10 +11,11 @@ module LiveKit
     include AuthMixin
     attr_accessor :api_key, :api_secret
 
-    def initialize(base_url, api_key: nil, api_secret: nil)
-      super(File.join(Utils.to_http_url(base_url), "/twirp"))
+    def initialize(base_url, api_key: nil, api_secret: nil, token: nil, failover: true, connection: nil)
+      super(connection || LiveKit::Failover.connection(base_url, failover))
       @api_key = api_key
       @api_secret = api_secret
+      @token = token
     end
 
     def start_room_composite_egress(
@@ -31,7 +33,11 @@ module LiveKit
       # true to record only audio
       audio_only: false,
       # true to record only video
-      video_only: false
+      video_only: false,
+      # DEFAULT_MIXING, DUAL_CHANNEL_AGENT, DUAL_CHANNEL_ALTERNATE
+      audio_mixing: nil,
+      # list of extra webhooks to call for this request
+      webhooks: nil
     )
       request = Proto::RoomCompositeEgressRequest.new(
         room_name: room_name,
@@ -41,9 +47,11 @@ module LiveKit
         custom_base_url: custom_base_url,
         audio_only: audio_only,
         video_only: video_only,
+        audio_mixing: audio_mixing,
+        webhooks: webhooks,
       )
       self.set_output(request, output)
-      self.rpc(
+      rpc!(
         :StartRoomCompositeEgress,
         request,
         headers:auth_header(video_grant: VideoGrant.new(roomRecord: true)),
@@ -60,7 +68,9 @@ module LiveKit
       # EncodingOptionsPreset, only one of preset or advanced could be set
       preset: nil,
       # EncodingOptions, only one of preset or advanced could be set
-      advanced: nil
+      advanced: nil,
+      # list of extra webhooks to call for this request
+      webhooks: nil
     )
       request = Proto::ParticipantEgressRequest.new(
         room_name: room_name,
@@ -68,9 +78,10 @@ module LiveKit
         screen_share: screen_share,
         preset: preset,
         advanced: advanced,
+        webhooks: webhooks,
       )
       self.set_output(request, output)
-      self.rpc(
+      rpc!(
         :StartParticipantEgress,
         request,
         headers:auth_header(video_grant: VideoGrant.new(roomRecord: true)),
@@ -88,7 +99,9 @@ module LiveKit
       # EncodingOptionsPreset, only one of preset or advanced could be set
       preset: nil,
       # EncodingOptions, only one of preset or advanced could be set
-      advanced: nil
+      advanced: nil,
+      # list of extra webhooks to call for this request
+      webhooks: nil
     )
       request = Proto::TrackCompositeEgressRequest.new(
         room_name: room_name,
@@ -96,9 +109,10 @@ module LiveKit
         advanced: advanced,
         audio_track_id: audio_track_id,
         video_track_id: video_track_id,
+        webhooks: webhooks,
       )
       self.set_output(request, output)
-      self.rpc(
+      rpc!(
         :StartTrackCompositeEgress,
         request,
         headers:auth_header(video_grant: VideoGrant.new(roomRecord: true)),
@@ -109,18 +123,21 @@ module LiveKit
       room_name,
       # either a DirectFileOutput - egress to storage or string - egress to WebSocket URL
       output,
-      track_id
+      track_id,
+      # list of extra webhooks to call for this request
+      webhooks: nil
     )
       request = Proto::TrackEgressRequest.new(
         room_name: room_name,
         track_id: track_id,
+        webhooks: webhooks,
       )
       if output.filepath
         request.file = output
       else
         request.websocket_url = output
       end
-      self.rpc(
+      rpc!(
         :StartTrackEgress,
         request,
         headers:auth_header(video_grant: VideoGrant.new(roomRecord: true)),
@@ -140,7 +157,9 @@ module LiveKit
       # true to record only video
       video_only: false,
       # true to await START_RECORDING chrome log
-      await_start_signal: false
+      await_start_signal: false,
+      # list of extra webhooks to call for this request
+      webhooks: nil
     )
       request = Proto::WebEgressRequest.new(
         url: url,
@@ -149,9 +168,10 @@ module LiveKit
         audio_only: audio_only,
         video_only: video_only,
         await_start_signal: await_start_signal,
+        webhooks: webhooks,
       )
       self.set_output(request, output)
-      self.rpc(
+      rpc!(
         :StartWebEgress,
         request,
         headers:auth_header(video_grant: VideoGrant.new(roomRecord: true)),
@@ -159,7 +179,7 @@ module LiveKit
     end
 
     def update_layout(egress_id, layout)
-      self.rpc(
+      rpc!(
         :UpdateLayout,
         Proto::UpdateLayoutRequest.new(
           egress_id: egress_id,
@@ -173,7 +193,7 @@ module LiveKit
       add_output_urls: [],
       remove_output_urls: []
     )
-      self.rpc(
+      rpc!(
         :UpdateStream,
         Proto::UpdateStreamRequest.new(
           egress_id: egress_id,
@@ -190,7 +210,7 @@ module LiveKit
       egress_id: nil,
       active: false
     )
-      self.rpc(
+      rpc!(
         :ListEgress,
         Proto::ListEgressRequest.new(
           room_name: room_name,
@@ -202,7 +222,7 @@ module LiveKit
     end
 
     def stop_egress(egress_id)
-      self.rpc(
+      rpc!(
         :StopEgress,
         Proto::StopEgressRequest.new(egress_id: egress_id),
         headers:auth_header(video_grant: VideoGrant.new(roomRecord: true)),
@@ -234,13 +254,15 @@ module LiveKit
           end
         end
       elsif output.is_a? LiveKit::Proto::EncodedFileOutput
-        request.file = output
+        # The singular field is deprecated and absent on some requests (e.g.
+        # ParticipantEgressRequest); the plural *_outputs is the current field.
+        request.file = output if request.respond_to?(:file=)
         request.file_outputs = Google::Protobuf::RepeatedField.new(:message, Proto::EncodedFileOutput, [output])
       elsif output.is_a? LiveKit::Proto::SegmentedFileOutput
-        request.segments = output
+        request.segments = output if request.respond_to?(:segments=)
         request.segment_outputs = Google::Protobuf::RepeatedField.new(:message, Proto::SegmentedFileOutput, [output])
       elsif output.is_a? LiveKit::Proto::StreamOutput
-        request.stream = output
+        request.stream = output if request.respond_to?(:stream=)
         request.stream_outputs = Google::Protobuf::RepeatedField.new(:message, Proto::StreamOutput, [output])
       elsif output.is_a? LiveKit::Proto::ImageOutput
         request.image_outputs = Google::Protobuf::RepeatedField.new(:message, Proto::ImageOutput, [output])

data/lib/livekit/errors.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module LiveKit
+  # Raised when a LiveKit server API call fails. Exposes the error code, message,
+  # and any metadata the server attached.
+  class ServerError < StandardError
+    # @return [String] the error code, e.g. "not_found" or "permission_denied"
+    attr_reader :code
+    # @return [Hash{String=>String}] error metadata returned by the server
+    attr_reader :metadata
+
+    def initialize(code, message, metadata: {})
+      @code = code
+      @metadata = metadata || {}
+      super(message)
+    end
+
+    # Builds a ServerError (or SipCallError) from the underlying error. Returns nil
+    # when +err+ is nil, so it can be called directly on a response's error.
+    # @return [LiveKit::ServerError, nil]
+    def self.from(err)
+      return nil if err.nil?
+
+      meta = err.meta || {}
+      klass = meta.key?("sip_status_code") ? SipCallError : self
+      klass.new(err.code.to_s, err.msg, metadata: meta)
+    end
+  end
+
+  # Raised when a SIP dialing call (create_sip_participant / transfer_sip_participant)
+  # fails with a SIP response status. The SIP code and reason are exposed
+  # directly; any other metadata remains available via {#metadata}.
+  class SipCallError < ServerError
+    # @return [Integer, nil] the SIP response code, e.g. 486 (Busy Here)
+    def sip_status_code
+      raw = metadata["sip_status_code"]
+      raw && raw.to_i
+    end
+
+    # @return [String, nil] the SIP reason phrase, e.g. "Busy Here"
+    def sip_status
+      metadata["sip_status"]
+    end
+
+    # A clear, SIP-specific representation, including any extra metadata.
+    def message
+      code_str = metadata["sip_status_code"]
+      return super if code_str.nil?
+
+      reason = metadata["sip_status"]
+      result = "SIP call failed: #{code_str}"
+      result += " #{reason}" if reason && !reason.empty?
+      result += " (#{code})"
+      extra = metadata.reject { |k, _| %w[sip_status_code sip_status error_details].include?(k) }
+      result += " [#{extra.map { |k, v| "#{k}=#{v}" }.join(", ")}]" unless extra.empty?
+      result
+    end
+    alias to_s message
+  end
+end

data/lib/livekit/failover.rb

@@ -0,0 +1,215 @@
+# frozen_string_literal: true
+
+require 'faraday'
+require 'json'
+require 'set'
+require 'uri'
+require 'livekit/utils'
+require 'livekit/version'
+
+module LiveKit
+  # Region failover for the Twirp API clients.
+  #
+  # On a retryable failure (any transport error or HTTP 5xx) the client
+  # discovers alternative LiveKit Cloud regions via /settings/regions and
+  # replays the request against the next region, with exponential backoff. 4xx
+  # responses are returned immediately.
+  #
+  # The +failover+ argument accepted by the service clients is a boolean
+  # (default true). When enabled, failover engages for LiveKit Cloud hosts only.
+  # The total attempt count and backoff are fixed (not user-configurable) so
+  # retries can't be tuned to values that could overwhelm the server.
+  module Failover
+    MAX_ATTEMPTS = 3
+    BACKOFF_BASE = 0.2
+    # Default per-request timeout (seconds). Calls that dial a phone override it
+    # via TIMEOUT_HEADER (see SIPServiceClient).
+    DEFAULT_TIMEOUT = 10
+    # Below this per-request timeout a retry is unlikely to help and many clients
+    # would retry in lockstep across regions, so a short request gets a single
+    # attempt (thundering-herd guard).
+    MIN_FAILOVER_TIMEOUT = 5
+    # Internal header carrying a per-request timeout override (seconds). Consumed
+    # by the middleware and not sent to the server.
+    TIMEOUT_HEADER = 'X-Lk-Request-Timeout'
+
+    # Total request attempts including the initial one; 1 means no failover.
+    # Failover only engages when enabled, the host is a LiveKit Cloud domain, and
+    # the request timeout is long enough to retry. +force+ bypasses the
+    # cloud-host check and is for internal testing only.
+    def self.attempts(enabled, host, force, timeout)
+      return 1 unless enabled && (force || cloud?(host))
+      return 1 if timeout && timeout < MIN_FAILOVER_TIMEOUT
+
+      MAX_ATTEMPTS
+    end
+
+    # Builds a Faraday connection wired with the region-failover middleware and
+    # the LiveKit Twirp base URL. Passed to Twirp::Client in place of a URL.
+    def self.connection(base_url, failover)
+      url = File.join(Utils.to_http_url(base_url), '/twirp')
+      Faraday.new(url: url) do |f|
+        f.headers['User-Agent'] = "livekit-server-sdk-ruby/#{VERSION}"
+        f.options.timeout = DEFAULT_TIMEOUT
+        f.use RegionFailoverMiddleware, failover: failover
+        f.adapter Faraday.default_adapter
+      end
+    end
+
+    # Failover only engages for LiveKit Cloud project domains.
+    def self.cloud?(host)
+      !host.nil? && host.end_with?('.livekit.cloud')
+    end
+
+    # Normalizes a region URL to an http(s) scheme (ws -> http, wss -> https).
+    def self.to_http(url)
+      url.start_with?('ws') ? "http#{url[2..]}" : url
+    end
+
+    def self.host_key(uri)
+      "#{uri.host}:#{uri.port}".downcase
+    end
+
+    # Returns the first region whose host has not yet been attempted.
+    def self.pick_next(regions, attempted)
+      regions.find { |uri| !attempted.include?(host_key(uri)) }
+    end
+
+    @cache = {}
+    @cache_mutex = Mutex.new
+
+    # Returns alternative region origins (URIs) for the given origin, fetching
+    # /settings/regions if the cache is stale. Best-effort: on a fetch failure
+    # it serves a stale cached list when available, otherwise an empty list.
+    # Forwards headers so a valid token — and any test directives — reach the
+    # discovery endpoint.
+    def self.region_uris(origin, headers)
+      key = host_key(origin)
+      @cache_mutex.synchronize do
+        entry = @cache[key]
+        return entry[:uris] if entry && (Time.now - entry[:fetched_at]) < entry[:ttl]
+      end
+
+      begin
+        uris, ttl = fetch(origin, headers)
+      rescue StandardError
+        return @cache_mutex.synchronize { @cache[key]&.fetch(:uris, nil) } || []
+      end
+
+      # A zero TTL (e.g. Cache-Control: max-age=0) means "do not cache".
+      if ttl.positive?
+        @cache_mutex.synchronize do
+          @cache[key] = { uris: uris, fetched_at: Time.now, ttl: ttl }
+        end
+      end
+      uris
+    end
+
+    def self.fetch(origin, headers)
+      forward = headers.reject { |k, _| %w[content-type content-length].include?(k.to_s.downcase) }
+      url = "#{origin.scheme}://#{origin.host}:#{origin.port}/settings/regions"
+      resp = Faraday.get(url) do |req|
+        # Short timeout so a slow/unreachable discovery endpoint doesn't stall
+        # the failover path.
+        req.options.timeout = 2
+        forward.each { |k, v| req.headers[k] = v }
+      end
+      raise "region discovery failed: #{resp.status}" unless resp.status == 200
+
+      ttl = parse_max_age(resp.headers['cache-control'])
+      body = JSON.parse(resp.body || '{}')
+      uris = (body['regions'] || [])
+             .map { |r| r['url'] }
+             .reject { |u| u.nil? || u.empty? }
+             .map { |u| URI.parse(to_http(u)) }
+      [uris, ttl]
+    end
+
+    def self.parse_max_age(cache_control)
+      return 0 if cache_control.nil? || cache_control.empty?
+
+      cache_control.split(',').each do |directive|
+        directive = directive.strip.downcase
+        if directive.start_with?('max-age=')
+          secs = directive.sub('max-age=', '').to_i
+          return secs.positive? ? secs : 0
+        end
+      end
+      0
+    end
+  end
+
+  # Faraday middleware that fails over to alternative LiveKit Cloud regions on a
+  # retryable error: any transport error or HTTP 5xx. A 4xx is returned
+  # immediately. The request body and headers are replayed intact against the
+  # next untried region, with exponential backoff.
+  class RegionFailoverMiddleware < Faraday::Middleware
+    def initialize(app, options = {})
+      super(app)
+      @failover = options.fetch(:failover, true)
+      # +force+ / +backoff_base+ are internal test-only knobs.
+      @force = options.fetch(:force, false)
+      @backoff_base = options.fetch(:backoff_base, Failover::BACKOFF_BASE)
+    end
+
+    def call(env)
+      original_url = env.url.dup
+      request_body = env.body
+
+      # A per-request timeout override (e.g. for SIP dialing) travels as an
+      # internal header; consume it so it isn't sent to the server. Otherwise
+      # use the connection's configured timeout.
+      timeout = env.request_headers.delete(Failover::TIMEOUT_HEADER)&.to_f
+      timeout ||= env.request.timeout
+      env.request.timeout = timeout if timeout
+
+      request_headers = env.request_headers.dup
+      max_attempts = Failover.attempts(@failover, original_url.host, @force, timeout)
+
+      attempted = [Failover.host_key(original_url)]
+      regions = nil
+      current_url = original_url
+      attempt = 0
+
+      loop do
+        is_last = attempt + 1 >= max_attempts
+        env.url = current_url
+        env.body = request_body
+
+        response = nil
+        error = nil
+        begin
+          response = @app.call(env)
+        rescue Faraday::Error => e
+          error = e
+        end
+
+        # Success or a non-retryable 4xx is terminal.
+        return response if response && response.status < 500
+
+        nxt = nil
+        unless is_last
+          regions ||= Failover.region_uris(original_url, request_headers)
+          nxt = Failover.pick_next(regions, attempted)
+        end
+
+        if nxt.nil?
+          return response if response
+          raise error
+        end
+
+        reason = response ? "status #{response.status}" : (error&.message || 'error')
+        warn("livekit API request to #{current_url.host} failed (#{reason}), " \
+             "retrying with fallback url #{nxt}")
+        sleep(@backoff_base * (2**attempt))
+        attempted << Failover.host_key(nxt)
+        # Swap only the region's scheme/host/port, preserving the request path.
+        current_url = original_url.dup
+        current_url.scheme = nxt.scheme
+        current_url.host = nxt.host
+        current_url.port = nxt.port
+        attempt += 1
+      end
+    end
+  end
+end

data/lib/livekit/grants.rb

@@ -62,8 +62,8 @@ module LiveKit
     using LiveKit::Utils::StringifyKeysRefinement
 
     attr_accessor :roomCreate, :roomJoin, :roomList, :roomRecord, :roomAdmin,
-      :room, :canPublish, :canPublishSources, :canSubscribe, :canPublishData,
-      :canUpdateOwnMetadata, :hidden, :recorder, :ingressAdmin
+      :room, :destinationRoom, :canPublish, :canPublishSources, :canSubscribe,
+      :canPublishData, :canUpdateOwnMetadata, :hidden, :recorder, :ingressAdmin
 
     def initialize(
       # true if can create or delete rooms
@@ -78,6 +78,8 @@ module LiveKit
       roomAdmin: nil,
       # name of the room for join or admin permissions
       room: nil,
+      # destination room a participant may be forwarded or moved to
+      destinationRoom: nil,
       # for join tokens, can participant publish, true by default
       canPublish: nil,
       # TrackSource types that a participant may publish
@@ -101,6 +103,7 @@ module LiveKit
       @roomRecord = roomRecord
       @roomAdmin = roomAdmin
       @room = room
+      @destinationRoom = destinationRoom
       @canPublish = canPublish
       @canPublishSources = canPublishSources
       @canSubscribe = canSubscribe
@@ -123,6 +126,7 @@ module LiveKit
         roomRecord: hash["roomRecord"],
         roomAdmin: hash["roomAdmin"],
         room: hash["room"],
+        destinationRoom: hash["destinationRoom"],
         canPublish: hash["canPublish"],
         canPublishSources: hash["canPublishSources"],
         canSubscribe: hash["canSubscribe"],

data/lib/livekit/ingress_service_client.rb

@@ -1,6 +1,7 @@
 require "livekit/proto/livekit_ingress_twirp"
 require "livekit/auth_mixin"
 require 'livekit/utils'
+require 'livekit/failover'
 
 module LiveKit
   class IngressServiceClient < Twirp::Client
@@ -8,10 +9,11 @@ module LiveKit
     include AuthMixin
     attr_accessor :api_key, :api_secret
 
-    def initialize(base_url, api_key: nil, api_secret: nil)
-      super(File.join(Utils.to_http_url(base_url), "/twirp"))
+    def initialize(base_url, api_key: nil, api_secret: nil, token: nil, failover: true, connection: nil)
+      super(connection || LiveKit::Failover.connection(base_url, failover))
       @api_key = api_key
       @api_secret = api_secret
+      @token = token
     end
 
     def create_ingress(
@@ -48,7 +50,7 @@ module LiveKit
         enable_transcoding: enable_transcoding,
         url: url,
       )
-      self.rpc(
+      rpc!(
         :CreateIngress,
         request,
         headers:auth_header(video_grant: VideoGrant.new(ingressAdmin: true)),
@@ -86,7 +88,7 @@ module LiveKit
         bypass_transcoding: bypass_transcoding,
         enable_transcoding: enable_transcoding,
       )
-      self.rpc(
+      rpc!(
         :UpdateIngress,
         request,
         headers:auth_header(video_grant: VideoGrant.new(ingressAdmin: true)),
@@ -103,7 +105,7 @@ module LiveKit
         room_name: room_name,
         ingress_id: ingress_id,
       )
-      self.rpc(
+      rpc!(
         :ListIngress,
         request,
         headers:auth_header(video_grant: VideoGrant.new(ingressAdmin: true)),
@@ -114,7 +116,7 @@ module LiveKit
       request = Proto::DeleteIngressRequest.new(
         ingress_id: ingress_id
       )
-      self.rpc(
+      rpc!(
         :DeleteIngress,
         request,
         headers:auth_header(video_grant: VideoGrant.new(ingressAdmin: true)),

data/lib/livekit/livekit_api.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require "livekit/room_service_client"
+require "livekit/egress_service_client"
+require "livekit/ingress_service_client"
+require "livekit/sip_service_client"
+require "livekit/agent_dispatch_service_client"
+require "livekit/connector_service_client"
+require "livekit/failover"
+
+module LiveKit
+  # A single entry point to every LiveKit server API, exposing each service
+  # through a reader.
+  #
+  # @example
+  #   api = LiveKit::LiveKitAPI.new("https://my.livekit.host", api_key: k, api_secret: s)
+  #   api.room.create_room("my-room")
+  class LiveKitAPI
+    # @return [RoomServiceClient]
+    attr_reader :room
+    # @return [EgressServiceClient]
+    attr_reader :egress
+    # @return [IngressServiceClient]
+    attr_reader :ingress
+    # @return [SIPServiceClient]
+    attr_reader :sip
+    # @return [AgentDispatchServiceClient]
+    attr_reader :agent_dispatch
+    # @return [ConnectorServiceClient]
+    attr_reader :connector
+
+    # Authenticate with either an API key and secret (recommended for backend
+    # use), or a pre-signed +token+ (for client-side use, where the API secret
+    # must not be exposed). Any omitted value falls back to its environment
+    # variable: +LIVEKIT_URL+, +LIVEKIT_TOKEN+, +LIVEKIT_API_KEY+, +LIVEKIT_API_SECRET+.
+    def initialize(url = nil, api_key: nil, api_secret: nil, token: nil, failover: true)
+      url ||= ENV["LIVEKIT_URL"]
+
+      # Only fall back to environment credentials when none were provided
+      # explicitly, so an ambient LIVEKIT_TOKEN can't silently override an
+      # explicit api_key/secret (or vice versa).
+      if token.nil? && api_key.nil? && api_secret.nil?
+        token = ENV["LIVEKIT_TOKEN"]
+      end
+      if token.nil? && api_key.nil? && api_secret.nil?
+        api_key = ENV["LIVEKIT_API_KEY"]
+        api_secret = ENV["LIVEKIT_API_SECRET"]
+      end
+
+      raise ArgumentError, "url is required (pass it or set LIVEKIT_URL)" if url.nil? || url.empty?
+      if token.nil? && (api_key.nil? || api_secret.nil?)
+        raise ArgumentError, "either a token, or api_key and api_secret, are required"
+      end
+
+      # Share one Faraday connection (and its adapter/middleware) across every
+      # service instead of letting each open its own.
+      connection = LiveKit::Failover.connection(url, failover)
+      opts = { api_key: api_key, api_secret: api_secret, token: token, failover: failover, connection: connection }
+      @room = RoomServiceClient.new(url, **opts)
+      @egress = EgressServiceClient.new(url, **opts)
+      @ingress = IngressServiceClient.new(url, **opts)
+      @sip = SIPServiceClient.new(url, **opts)
+      @agent_dispatch = AgentDispatchServiceClient.new(url, **opts)
+      @connector = ConnectorServiceClient.new(url, **opts)
+    end
+  end
+end

data/lib/livekit/proto/livekit_agent_dispatch_pb.rb

@@ -5,9 +5,10 @@
 require 'google/protobuf'
 
 require 'livekit_agent_pb'
+require 'logger/options_pb'
 
 
-descriptor_data = "\n\x1clivekit_agent_dispatch.proto\x12\x07livekit\x1a\x13livekit_agent.proto\"P\n\x1a\x43reateAgentDispatchRequest\x12\x12\n\nagent_name\x18\x01 \x01(\t\x12\x0c\n\x04room\x18\x02 \x01(\t\x12\x10\n\x08metadata\x18\x03 \x01(\t\"9\n\x11RoomAgentDispatch\x12\x12\n\nagent_name\x18\x01 \x01(\t\x12\x10\n\x08metadata\x18\x02 \x01(\t\"?\n\x1a\x44\x65leteAgentDispatchRequest\x12\x13\n\x0b\x64ispatch_id\x18\x01 \x01(\t\x12\x0c\n\x04room\x18\x02 \x01(\t\"=\n\x18ListAgentDispatchRequest\x12\x13\n\x0b\x64ispatch_id\x18\x01 \x01(\t\x12\x0c\n\x04room\x18\x02 \x01(\t\"M\n\x19ListAgentDispatchResponse\x12\x30\n\x10\x61gent_dispatches\x18\x01 \x03(\x0b\x32\x16.livekit.AgentDispatch\"{\n\rAgentDispatch\x12\n\n\x02id\x18\x01 \x01(\t\x12\x12\n\nagent_name\x18\x02 \x01(\t\x12\x0c\n\x04room\x18\x03 \x01(\t\x12\x10\n\x08metadata\x18\x04 \x01(\t\x12*\n\x05state\x18\x05 \x01(\x0b\x32\x1b.livekit.AgentDispatchState\"X\n\x12\x41gentDispatchState\x12\x1a\n\x04jobs\x18\x01 \x03(\x0b\x32\x0c.livekit.Job\x12\x12\n\ncreated_at\x18\x02 \x01(\x03\x12\x12\n\ndeleted_at\x18\x03 \x01(\x03\x32\x8b\x02\n\x14\x41gentDispatchService\x12M\n\x0e\x43reateDispatch\x12#.livekit.CreateAgentDispatchRequest\x1a\x16.livekit.AgentDispatch\x12M\n\x0e\x44\x65leteDispatch\x12#.livekit.DeleteAgentDispatchRequest\x1a\x16.livekit.AgentDispatch\x12U\n\x0cListDispatch\x12!.livekit.ListAgentDispatchRequest\x1a\".livekit.ListAgentDispatchResponseBFZ#github.com/livekit/protocol/livekit\xaa\x02\rLiveKit.Proto\xea\x02\x0eLiveKit::Protob\x06proto3"
+descriptor_data = "\n\x1clivekit_agent_dispatch.proto\x12\x07livekit\x1a\x13livekit_agent.proto\x1a\x14logger/options.proto\"\x9d\x02\n\x1a\x43reateAgentDispatchRequest\x12\x12\n\nagent_name\x18\x01 \x01(\t\x12\x0c\n\x04room\x18\x02 \x01(\t\x12\x15\n\x08metadata\x18\x03 \x01(\tB\x03\xc0P\x01\x12\x31\n\x0erestart_policy\x18\x04 \x01(\x0e\x32\x19.livekit.JobRestartPolicy\x12\x12\n\ndeployment\x18\x05 \x01(\t\x12L\n\nattributes\x18\x06 \x03(\x0b\x32\x33.livekit.CreateAgentDispatchRequest.AttributesEntryB\x03\xc0P\x01\x1a\x31\n\x0f\x41ttributesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xfd\x01\n\x11RoomAgentDispatch\x12\x12\n\nagent_name\x18\x01 \x01(\t\x12\x15\n\x08metadata\x18\x02 \x01(\tB\x03\xc0P\x01\x12\x31\n\x0erestart_policy\x18\x03 \x01(\x0e\x32\x19.livekit.JobRestartPolicy\x12\x12\n\ndeployment\x18\x04 \x01(\t\x12\x43\n\nattributes\x18\x05 \x03(\x0b\x32*.livekit.RoomAgentDispatch.AttributesEntryB\x03\xc0P\x01\x1a\x31\n\x0f\x41ttributesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"N\n\x1a\x44\x65leteAgentDispatchRequest\x12\"\n\x0b\x64ispatch_id\x18\x01 \x01(\tB\r\xbaP\ndispatchID\x12\x0c\n\x04room\x18\x02 \x01(\t\"L\n\x18ListAgentDispatchRequest\x12\"\n\x0b\x64ispatch_id\x18\x01 \x01(\tB\r\xbaP\ndispatchID\x12\x0c\n\x04room\x18\x02 \x01(\t\"M\n\x19ListAgentDispatchResponse\x12\x30\n\x10\x61gent_dispatches\x18\x01 \x03(\x0b\x32\x16.livekit.AgentDispatch\"\xbb\x02\n\rAgentDispatch\x12\n\n\x02id\x18\x01 \x01(\t\x12\x12\n\nagent_name\x18\x02 \x01(\t\x12\x0c\n\x04room\x18\x03 \x01(\t\x12\x15\n\x08metadata\x18\x04 \x01(\tB\x03\xc0P\x01\x12*\n\x05state\x18\x05 \x01(\x0b\x32\x1b.livekit.AgentDispatchState\x12\x31\n\x0erestart_policy\x18\x06 \x01(\x0e\x32\x19.livekit.JobRestartPolicy\x12\x12\n\ndeployment\x18\x07 \x01(\t\x12?\n\nattributes\x18\x08 \x03(\x0b\x32&.livekit.AgentDispatch.AttributesEntryB\x03\xc0P\x01\x1a\x31\n\x0f\x41ttributesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"X\n\x12\x41gentDispatchState\x12\x1a\n\x04jobs\x18\x01 \x03(\x0b\x32\x0c.livekit.Job\x12\x12\n\ncreated_at\x18\x02 \x01(\x03\x12\x12\n\ndeleted_at\x18\x03 \x01(\x03*5\n\x10JobRestartPolicy\x12\x12\n\x0eJRP_ON_FAILURE\x10\x00\x12\r\n\tJRP_NEVER\x10\x01\x32\x8b\x02\n\x14\x41gentDispatchService\x12M\n\x0e\x43reateDispatch\x12#.livekit.CreateAgentDispatchRequest\x1a\x16.livekit.AgentDispatch\x12M\n\x0e\x44\x65leteDispatch\x12#.livekit.DeleteAgentDispatchRequest\x1a\x16.livekit.AgentDispatch\x12U\n\x0cListDispatch\x12!.livekit.ListAgentDispatchRequest\x1a\".livekit.ListAgentDispatchResponseBFZ#github.com/livekit/protocol/livekit\xaa\x02\rLiveKit.Proto\xea\x02\x0eLiveKit::Protob\x06proto3"
 
 pool = Google::Protobuf::DescriptorPool.generated_pool
 pool.add_serialized_file(descriptor_data)
@@ -21,5 +22,6 @@ module LiveKit
     ListAgentDispatchResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.ListAgentDispatchResponse").msgclass
     AgentDispatch = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.AgentDispatch").msgclass
     AgentDispatchState = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.AgentDispatchState").msgclass
+    JobRestartPolicy = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.JobRestartPolicy").enummodule
   end
 end

data/lib/livekit/proto/livekit_agent_dispatch_twirp.rb

@@ -1,4 +1,4 @@
-# Code generated by protoc-gen-twirp_ruby 1.10.0, DO NOT EDIT.
+# Code generated by protoc-gen-twirp_ruby 1.14.1, DO NOT EDIT.
 require 'twirp'
 require_relative 'livekit_agent_dispatch_pb.rb'