livekit-server-sdk 0.6.6 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 950430d5fc1b522fda62abc8c9707f7de403a17d3353d42d4bb4b15d68bfb695
-  data.tar.gz: 3efddda0ca44ce7a2a83e9f666007a0e0c60db906002a1dadd8d791332c9c24e
+  metadata.gz: ffba3e4bb237a3d72727a1b4f394ee48df1e01ba8979784cd150f5b151b79551
+  data.tar.gz: 5b7800d0bfcd95463df67b3ee20260a690436b46b3fb61dbf33592255fcc42d0
 SHA512:
-  metadata.gz: 9beb92184c2325fa57199e14767e0f05167fec5e013409f720f8d0078b4b8813601142302bdba0cbe0eb51b3126b34f39ac920195d693eef930895ba64e4c23e
-  data.tar.gz: 51b25872d8b0a886bff874a73058f3647e119ddcd14ce8d57b805498f549a7b47918a200167532e3314844065149a66a95ef0283757ba674f7b8a2c7a1b3bf55
+  metadata.gz: 72d3c6b27843214b6d39cb5036c38db4f33edc7ec31cbe0410a42b0cd6d628d0187de991fa1738774b6affbb0e08c55890b7de0427da8044276642a73e439bf9
+  data.tar.gz: f4d6833eccf51dd6270ba9cacd9fbe48404a8ddee94075d5587f15e2dd3fed0f10ccce9a4b9cd9a86f5ca4adb5c172efdc40d694595563ae79c9f4d70016cde9

data/.github/workflows/test.yml

@@ -7,19 +7,19 @@ jobs:
     strategy:
       matrix:
         include:
-          - { os: ubuntu-latest, ruby_version: 2.6 }
-          - { os: ubuntu-latest, ruby_version: 2.7 }
-          - { os: ubuntu-latest, ruby_version: '3.0' }
+          - { os: ubuntu-latest, ruby_version: "3.0" }
+          - { os: ubuntu-latest, ruby_version: "3.3" }
+          - { os: ubuntu-latest, ruby_version: "jruby-9.4" }
     steps:
-    - name: Setup Ruby, JRuby and TruffleRuby
-      uses: ruby/setup-ruby@v1.75.0
-      with:
-        bundler: 1
-        ruby-version: ${{ matrix.ruby_version }}
-    - name: Checkout code
-      uses: actions/checkout@v2
-    - name: Run tests
-      run: |
-        gem install bundler:2.2.25
-        bundle install --jobs 4 --retry 3
-        bundle exec rspec
+      - name: Setup Ruby, JRuby and TruffleRuby
+        uses: ruby/setup-ruby@v1.190.0
+        with:
+          bundler: 1
+          ruby-version: ${{ matrix.ruby_version }}
+      - name: Checkout code
+        uses: actions/checkout@v2
+      - name: Run tests
+        run: |
+          gem install bundler:2.3.7
+          bundle install --jobs 4 --retry 3
+          bundle exec rspec

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    livekit-server-sdk (0.6.5)
+    livekit-server-sdk (0.7.0)
       google-protobuf (>= 3.21.0, < 4.0)
       jwt (>= 2.2.3, < 3.0)
       rack (>= 2.2.3)
@@ -10,22 +10,29 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
+    base64 (0.2.0)
     coderay (1.1.3)
     diff-lcs (1.5.0)
-    faraday (2.7.4)
-      faraday-net_http (>= 2.0, < 3.1)
-      ruby2_keywords (>= 0.0.4)
-    faraday-net_http (3.0.2)
-    google-protobuf (3.22.2)
-    jwt (2.7.0)
+    faraday (2.10.1)
+      faraday-net_http (>= 2.0, < 3.2)
+      logger
+    faraday-net_http (3.1.1)
+      net-http
+    google-protobuf (3.25.4)
+    google-protobuf (3.25.4-x86_64-linux)
+    jwt (2.8.2)
+      base64
+    logger (1.6.0)
     method_source (1.0.0)
+    net-http (0.4.1)
+      uri
     pry (0.14.2)
       coderay (~> 1.1)
       method_source (~> 1.0)
     pry-doc (1.4.0)
       pry (~> 0.11)
       yard (~> 0.9.11)
-    rack (2.2.6.4)
+    rack (3.1.7)
     rake (13.0.6)
     rspec (3.12.0)
       rspec-core (~> 3.12.0)
@@ -40,10 +47,10 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.12.0)
     rspec-support (3.12.0)
-    ruby2_keywords (0.0.5)
     twirp (1.10.0)
       faraday (< 3)
       google-protobuf (~> 3.0, >= 3.7.0)
+    uri (0.13.0)
     webrick (1.7.0)
     yard (0.9.28)
       webrick (~> 1.7.0)

data/README.md

@@ -11,7 +11,9 @@
 # LiveKit Server API for Ruby
 
 <!--BEGIN_DESCRIPTION-->
-Use this SDK to manage <a href="https://livekit.io/">LiveKit</a> rooms and create access tokens from your Ruby backend.
+
+Use this SDK to interact with <a href="https://livekit.io/">LiveKit</a> server APIs and create access tokens from your Ruby backend.
+
 <!--END_DESCRIPTION-->
 
 This library is designed to work with Ruby 2.6.0 and above.
@@ -46,8 +48,8 @@ require 'livekit'
 token = LiveKit::AccessToken.new(api_key: 'yourkey', api_secret: 'yoursecret')
 token.identity = 'participant-identity'
 token.name = 'participant-name'
-token.add_grant(roomJoin: true, room: 'room-name')
-
+token.set_video_grant(LiveKit::VideoGrant.new(roomJoin: true, room: 'room-name'))
+token.attributes = { "mykey" => "myvalue" }
 puts token.to_jwt
 ```
 
@@ -136,15 +138,16 @@ You may store credentials in environment variables. If api-key or api-secret is
 The gem is available as open source under the terms of Apache 2.0 License.
 
 <!--BEGIN_REPO_NAV-->
+
 <br/><table>
+
 <thead><tr><th colspan="2">LiveKit Ecosystem</th></tr></thead>
 <tbody>
-<tr><td>Real-time SDKs</td><td><a href="https://github.com/livekit/components-js">React Components</a> · <a href="https://github.com/livekit/client-sdk-js">JavaScript</a> · <a href="https://github.com/livekit/client-sdk-swift">iOS/macOS</a> · <a href="https://github.com/livekit/client-sdk-android">Android</a> · <a href="https://github.com/livekit/client-sdk-flutter">Flutter</a> · <a href="https://github.com/livekit/client-sdk-react-native">React Native</a> · <a href="https://github.com/livekit/client-sdk-rust">Rust</a> · <a href="https://github.com/livekit/client-sdk-python">Python</a> · <a href="https://github.com/livekit/client-sdk-unity-web">Unity (web)</a> · <a href="https://github.com/livekit/client-sdk-unity">Unity (beta)</a></td></tr><tr></tr>
-<tr><td>Server APIs</td><td><a href="https://github.com/livekit/server-sdk-js">Node.js</a> · <a href="https://github.com/livekit/server-sdk-go">Golang</a> · <b>Ruby</b> · <a href="https://github.com/livekit/server-sdk-kotlin">Java/Kotlin</a> · <a href="https://github.com/livekit/client-sdk-python">Python</a> · <a href="https://github.com/livekit/client-sdk-rust">Rust</a> · <a href="https://github.com/agence104/livekit-server-sdk-php">PHP (community)</a></td></tr><tr></tr>
+<tr><td>Realtime SDKs</td><td><a href="https://github.com/livekit/components-js">React Components</a> · <a href="https://github.com/livekit/client-sdk-js">Browser</a> · <a href="https://github.com/livekit/components-swift">Swift Components</a> · <a href="https://github.com/livekit/client-sdk-swift">iOS/macOS/visionOS</a> · <a href="https://github.com/livekit/client-sdk-android">Android</a> · <a href="https://github.com/livekit/client-sdk-flutter">Flutter</a> · <a href="https://github.com/livekit/client-sdk-react-native">React Native</a> · <a href="https://github.com/livekit/rust-sdks">Rust</a> · <a href="https://github.com/livekit/node-sdks">Node.js</a> · <a href="https://github.com/livekit/python-sdks">Python</a> · <a href="https://github.com/livekit/client-sdk-unity-web">Unity (web)</a> · <a href="https://github.com/livekit/client-sdk-unity">Unity (beta)</a></td></tr><tr></tr>
+<tr><td>Server APIs</td><td><a href="https://github.com/livekit/node-sdks">Node.js</a> · <a href="https://github.com/livekit/server-sdk-go">Golang</a> · <b>Ruby</b> · <a href="https://github.com/livekit/server-sdk-kotlin">Java/Kotlin</a> · <a href="https://github.com/livekit/python-sdks">Python</a> · <a href="https://github.com/livekit/rust-sdks">Rust</a> · <a href="https://github.com/agence104/livekit-server-sdk-php">PHP (community)</a></td></tr><tr></tr>
 <tr><td>Agents Frameworks</td><td><a href="https://github.com/livekit/agents">Python</a> · <a href="https://github.com/livekit/agent-playground">Playground</a></td></tr><tr></tr>
-<tr><td>Services</td><td><a href="https://github.com/livekit/livekit">Livekit server</a> · <a href="https://github.com/livekit/egress">Egress</a> · <a href="https://github.com/livekit/ingress">Ingress</a> · <a href="https://github.com/livekit/sip">SIP</a></td></tr><tr></tr>
-<tr><td>Resources</td><td><a href="https://docs.livekit.io">Docs</a> · <a href="https://github.com/livekit-examples">Example apps</a> · <a href="https://livekit.io/cloud">Cloud</a> · <a href="https://docs.livekit.io/oss/deployment">Self-hosting</a> · <a href="https://github.com/livekit/livekit-cli">CLI</a></td></tr>
+<tr><td>Services</td><td><a href="https://github.com/livekit/livekit">LiveKit server</a> · <a href="https://github.com/livekit/egress">Egress</a> · <a href="https://github.com/livekit/ingress">Ingress</a> · <a href="https://github.com/livekit/sip">SIP</a></td></tr><tr></tr>
+<tr><td>Resources</td><td><a href="https://docs.livekit.io">Docs</a> · <a href="https://github.com/livekit-examples">Example apps</a> · <a href="https://livekit.io/cloud">Cloud</a> · <a href="https://docs.livekit.io/home/self-hosting/deployment">Self-hosting</a> · <a href="https://github.com/livekit/livekit-cli">CLI</a></td></tr>
 </tbody>
 </table>
 <!--END_REPO_NAV-->
-

data/Rakefile

@@ -12,9 +12,12 @@ task :proto do
          "--ruby_out=lib/livekit/proto",
          "--twirp_ruby_out=lib/livekit/proto",
          "-Iprotocol",
+         "./protocol/protobufs/livekit_agent.proto",
+         "./protocol/protobufs/livekit_agent_dispatch.proto",
          "./protocol/protobufs/livekit_egress.proto",
          "./protocol/protobufs/livekit_ingress.proto",
          "./protocol/protobufs/livekit_sip.proto",
+         "./protocol/protobufs/livekit_metrics.proto",
          "./protocol/protobufs/livekit_models.proto",
          "./protocol/protobufs/livekit_room.proto",
          "./protocol/protobufs/livekit_webhook.proto")

data/lib/livekit/access_token.rb

@@ -4,35 +4,65 @@ require "jwt"
 
 module LiveKit
   class AccessToken
-    # 6 hours in seconds; how long the access token to the server is good for
-    DEFAULT_TTL = 14_400
+    # 10 minutes in seconds; how long the access token to the server is good for
+    DEFAULT_TTL = 600
 
     # The signing algorithm used by the {jwt} gem internals
     SIGNING_ALGORITHM = "HS256"
 
     attr_accessor :grants, :identity
 
-    def initialize(api_key: nil, api_secret: nil, identity: nil, ttl: DEFAULT_TTL, name: nil, metadata: nil)
+    def initialize(
+        api_key: nil,
+        api_secret: nil,
+        identity: nil,
+        ttl: DEFAULT_TTL,
+        name: nil,
+        metadata: nil,
+        attributes: nil
+      )
       @api_key = api_key || ENV["LIVEKIT_API_KEY"]
       @api_secret = api_secret || ENV["LIVEKIT_API_SECRET"]
       @grants = ClaimGrant.new
       @grants.name = name
       @grants.metadata = metadata
+      @grants.attributes = attributes
       @identity = identity
       @ttl = ttl
     end
 
+    # Deprecated, use set_video_grant instead
     def add_grant(video_grant)
       if video_grant.is_a?(Hash)
         video_grant = VideoGrant.from_hash(video_grant)
       end
+      self.set_video_grant(video_grant)
+    end
+
+    def set_video_grant(video_grant)
       @grants.video = video_grant
     end
 
+    # Deprecated, use set_sip_grant instead
+    def add_sip_grant(sip_grant)
+      if sip_grant.is_a?(Hash)
+        sip_grant = SIPGrant.from_hash(sip_grant)
+      end
+      self.set_sip_grant(sip_grant)
+    end
+
+    def set_sip_grant(sip_grant)
+      @grants.sip = sip_grant
+    end
+
     def metadata=(participant_md)
       @grants.metadata = participant_md
     end
 
+    def attributes=(participant_attributes)
+      @grants.attributes = participant_attributes
+    end
+
     def name=(participant_name)
       @grants.name = participant_name
     end
@@ -46,8 +76,8 @@ module LiveKit
     end
 
     def to_jwt
-      if @grants.video.nil?
-        raise ArgumentError, "VideoGrant is required"
+      if @grants.video.nil? && @grants.sip.nil?
+        raise ArgumentError, "VideoGrant or SIPGrant is required"
       end
 
       jwt_timestamp = Time.now.to_i
@@ -59,6 +89,7 @@ module LiveKit
         iss: @api_key,
         sub: @identity,
       })
+      payload.compact!
 
       return JWT.encode(payload, @api_secret, SIGNING_ALGORITHM)
     end

data/lib/livekit/auth_mixin.rb

@@ -3,10 +3,18 @@
 module LiveKit
   # Create authenticated headers when keys are provided
   module AuthMixin
-    def auth_header(video_grant)
+    def auth_header(
+      video_grant: nil,
+      sip_grant: nil
+    )
       headers = {}
       t = ::LiveKit::AccessToken.new(api_key: @api_key, api_secret: @api_secret)
-      t.add_grant(video_grant)
+      if video_grant != nil
+        t.set_video_grant(video_grant)
+      end
+      if sip_grant != nil
+        t.set_sip_grant(sip_grant)
+      end
       headers["Authorization"] = "Bearer #{t.to_jwt}"
       headers["User-Agent"] = "LiveKit Ruby SDK"
       headers

data/lib/livekit/egress_service_client.rb

@@ -46,7 +46,7 @@ module LiveKit
       self.rpc(
         :StartRoomCompositeEgress,
         request,
-        headers: auth_header(roomRecord: true),
+        headers:auth_header(video_grant: VideoGrant.new(roomRecord: true)),
       )
     end
 
@@ -73,7 +73,7 @@ module LiveKit
       self.rpc(
         :StartParticipantEgress,
         request,
-        headers: auth_header(roomRecord: true),
+        headers:auth_header(video_grant: VideoGrant.new(roomRecord: true)),
       )
     end
 
@@ -101,7 +101,7 @@ module LiveKit
       self.rpc(
         :StartTrackCompositeEgress,
         request,
-        headers: auth_header(roomRecord: true),
+        headers:auth_header(video_grant: VideoGrant.new(roomRecord: true)),
       )
     end
 
@@ -123,7 +123,7 @@ module LiveKit
       self.rpc(
         :StartTrackEgress,
         request,
-        headers: auth_header(roomRecord: true),
+        headers:auth_header(video_grant: VideoGrant.new(roomRecord: true)),
       )
     end
 
@@ -154,7 +154,7 @@ module LiveKit
       self.rpc(
         :StartWebEgress,
         request,
-        headers: auth_header(roomRecord: true),
+        headers:auth_header(video_grant: VideoGrant.new(roomRecord: true)),
       )
     end
 
@@ -165,7 +165,7 @@ module LiveKit
           egress_id: egress_id,
           layout: layout,
         ),
-        headers: auth_header(roomRecord: true),
+        headers:auth_header(video_grant: VideoGrant.new(roomRecord: true)),
       )
     end
 
@@ -180,7 +180,7 @@ module LiveKit
           add_output_urls: add_output_urls,
           remove_output_urls: remove_output_urls,
         ),
-        headers: auth_header(roomRecord: true),
+        headers:auth_header(video_grant: VideoGrant.new(roomRecord: true)),
       )
     end
 
@@ -197,7 +197,7 @@ module LiveKit
           active: active,
           egress_id: egress_id,
         ),
-        headers: auth_header(roomRecord: true),
+        headers:auth_header(video_grant: VideoGrant.new(roomRecord: true)),
       )
     end
 
@@ -205,7 +205,7 @@ module LiveKit
       self.rpc(
         :StopEgress,
         Proto::StopEgressRequest.new(egress_id: egress_id),
-        headers: auth_header(roomRecord: true),
+        headers:auth_header(video_grant: VideoGrant.new(roomRecord: true)),
       )
     end
 
@@ -225,7 +225,7 @@ module LiveKit
           elsif out.is_a? LiveKit::Proto::SegmentedFileOutput
             raise "cannot add multiple segmented file outputs" if request.segment_outputs.any?
             request.segment_outputs = Google::Protobuf::RepeatedField.new(:message, Proto::SegmentedFileOutput, [out])
-          elsif out.is_a? Livekit::Proto::StreamOutput
+          elsif out.is_a? LiveKit::Proto::StreamOutput
             raise "cannot add multiple stream outputs" if request.stream_outputs.any?
             request.stream_outputs = Google::Protobuf::RepeatedField.new(:message, Proto::StreamOutput, [out])
           elsif out.is_a? LiveKit::Proto::ImageOutput

data/lib/livekit/grants.rb

@@ -2,7 +2,7 @@
 
 module LiveKit
   class ClaimGrant
-    attr_accessor :identity, :name, :metadata, :sha256, :video
+    attr_accessor :identity, :name, :metadata, :sha256, :video, :sip, :attributes
 
     def self.from_hash(hash)
       return nil if hash.nil?
@@ -11,8 +11,10 @@ module LiveKit
       claim_grant.identity = hash["sub"]
       claim_grant.name = hash["name"]
       claim_grant.metadata = hash["metadata"]
+      claim_grant.attributes = hash["attributes"]
       claim_grant.sha256 = hash["sha256"]
       claim_grant.video = VideoGrant.from_hash(hash["video"])
+      claim_grant.sip = SIPGrant.from_hash(hash["sip"])
       return claim_grant
     end
 
@@ -22,15 +24,24 @@ module LiveKit
       @metadata = nil
       @sha256 = nil
       @video = nil
+      @sip = nil
+      @attributes = nil
     end
 
     def to_hash
-      {
+      val = {
         name: @name,
         metadata: @metadata,
+        attributes: @attributes,
         sha256: @sha256,
-        video: @video.to_hash,
       }
+      if @video
+        val[:video] = @video.to_hash
+      end
+      if @sip
+        val[:sip] = @sip.to_hash
+      end
+      return val
     end
   end
 
@@ -121,4 +132,42 @@ module LiveKit
       hash
     end
   end
+
+  class SIPGrant
+    using LiveKit::Utils::StringifyKeysRefinement
+
+    attr_accessor :admin, :call
+
+    def initialize(
+      # true if can access SIP features
+      admin: nil,
+      # true if can make outgoing call
+      call: nil
+    )
+      @admin = admin
+      @call = call
+    end
+
+    def self.from_hash(hash)
+      return nil if hash.nil?
+
+      hash = hash.stringify_keys
+
+      SIPGrant.new(
+        admin: hash["admin"],
+        call: hash["call"]
+      )
+    end
+
+    def to_hash
+      hash = {}
+      instance_variables.each { |var|
+        val = instance_variable_get(var)
+        if val != nil
+          hash[var.to_s.delete("@")] = val
+        end
+      }
+      hash
+    end
+  end
 end

data/lib/livekit/ingress_service_client.rb

@@ -51,7 +51,7 @@ module LiveKit
       self.rpc(
         :CreateIngress,
         request,
-        headers: auth_header(ingressAdmin: true),
+        headers:auth_header(video_grant: VideoGrant.new(ingressAdmin: true)),
       )
     end
 
@@ -89,7 +89,7 @@ module LiveKit
       self.rpc(
         :UpdateIngress,
         request,
-        headers: auth_header(ingressAdmin: true),
+        headers:auth_header(video_grant: VideoGrant.new(ingressAdmin: true)),
       )
     end
 
@@ -106,7 +106,7 @@ module LiveKit
       self.rpc(
         :ListIngress,
         request,
-        headers: auth_header(ingressAdmin: true),
+        headers:auth_header(video_grant: VideoGrant.new(ingressAdmin: true)),
       )
     end
 
@@ -117,7 +117,7 @@ module LiveKit
       self.rpc(
         :DeleteIngress,
         request,
-        headers: auth_header(ingressAdmin: true),
+        headers:auth_header(video_grant: VideoGrant.new(ingressAdmin: true)),
       )
     end
   end

data/lib/livekit/proto/livekit_agent_dispatch_pb.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: livekit_agent_dispatch.proto
+
+require 'google/protobuf'
+
+require 'livekit_agent_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"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+pool.add_serialized_file(descriptor_data)
+
+module LiveKit
+  module Proto
+    CreateAgentDispatchRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.CreateAgentDispatchRequest").msgclass
+    RoomAgentDispatch = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.RoomAgentDispatch").msgclass
+    DeleteAgentDispatchRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.DeleteAgentDispatchRequest").msgclass
+    ListAgentDispatchRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.ListAgentDispatchRequest").msgclass
+    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
+  end
+end

data/lib/livekit/proto/livekit_agent_dispatch_twirp.rb

@@ -0,0 +1,19 @@
+# Code generated by protoc-gen-twirp_ruby 1.11.0, DO NOT EDIT.
+require 'twirp'
+require_relative 'livekit_agent_dispatch_pb.rb'
+
+module LiveKit
+  module Proto
+    class AgentDispatchServiceService < ::Twirp::Service
+      package 'livekit'
+      service 'AgentDispatchService'
+      rpc :CreateDispatch, CreateAgentDispatchRequest, AgentDispatch, :ruby_method => :create_dispatch
+      rpc :DeleteDispatch, DeleteAgentDispatchRequest, AgentDispatch, :ruby_method => :delete_dispatch
+      rpc :ListDispatch, ListAgentDispatchRequest, ListAgentDispatchResponse, :ruby_method => :list_dispatch
+    end
+
+    class AgentDispatchServiceClient < ::Twirp::Client
+      client_for AgentDispatchServiceService
+    end
+  end
+end

data/lib/livekit/proto/livekit_agent_pb.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: livekit_agent.proto
+
+require 'google/protobuf'
+
+require 'livekit_models_pb'
+
+
+descriptor_data = "\n\x13livekit_agent.proto\x12\x07livekit\x1a\x14livekit_models.proto\"\x86\x02\n\x03Job\x12\n\n\x02id\x18\x01 \x01(\t\x12\x13\n\x0b\x64ispatch_id\x18\t \x01(\t\x12\x1e\n\x04type\x18\x02 \x01(\x0e\x32\x10.livekit.JobType\x12\x1b\n\x04room\x18\x03 \x01(\x0b\x32\r.livekit.Room\x12\x32\n\x0bparticipant\x18\x04 \x01(\x0b\x32\x18.livekit.ParticipantInfoH\x00\x88\x01\x01\x12\x15\n\tnamespace\x18\x05 \x01(\tB\x02\x18\x01\x12\x10\n\x08metadata\x18\x06 \x01(\t\x12\x12\n\nagent_name\x18\x07 \x01(\t\x12 \n\x05state\x18\x08 \x01(\x0b\x32\x11.livekit.JobStateB\x0e\n\x0c_participant\"\x95\x01\n\x08JobState\x12\"\n\x06status\x18\x01 \x01(\x0e\x32\x12.livekit.JobStatus\x12\r\n\x05\x65rror\x18\x02 \x01(\t\x12\x12\n\nstarted_at\x18\x03 \x01(\x03\x12\x10\n\x08\x65nded_at\x18\x04 \x01(\x03\x12\x12\n\nupdated_at\x18\x05 \x01(\x03\x12\x1c\n\x14participant_identity\x18\x06 \x01(\t\"\xf8\x02\n\rWorkerMessage\x12\x32\n\x08register\x18\x01 \x01(\x0b\x32\x1e.livekit.RegisterWorkerRequestH\x00\x12\x35\n\x0c\x61vailability\x18\x02 \x01(\x0b\x32\x1d.livekit.AvailabilityResponseH\x00\x12\x34\n\rupdate_worker\x18\x03 \x01(\x0b\x32\x1b.livekit.UpdateWorkerStatusH\x00\x12.\n\nupdate_job\x18\x04 \x01(\x0b\x32\x18.livekit.UpdateJobStatusH\x00\x12#\n\x04ping\x18\x05 \x01(\x0b\x32\x13.livekit.WorkerPingH\x00\x12\x33\n\x0csimulate_job\x18\x06 \x01(\x0b\x32\x1b.livekit.SimulateJobRequestH\x00\x12\x31\n\x0bmigrate_job\x18\x07 \x01(\x0b\x32\x1a.livekit.MigrateJobRequestH\x00\x42\t\n\x07message\"\x88\x02\n\rServerMessage\x12\x33\n\x08register\x18\x01 \x01(\x0b\x32\x1f.livekit.RegisterWorkerResponseH\x00\x12\x34\n\x0c\x61vailability\x18\x02 \x01(\x0b\x32\x1c.livekit.AvailabilityRequestH\x00\x12,\n\nassignment\x18\x03 \x01(\x0b\x32\x16.livekit.JobAssignmentH\x00\x12.\n\x0btermination\x18\x05 \x01(\x0b\x32\x17.livekit.JobTerminationH\x00\x12#\n\x04pong\x18\x04 \x01(\x0b\x32\x13.livekit.WorkerPongH\x00\x42\t\n\x07message\"\x80\x01\n\x12SimulateJobRequest\x12\x1e\n\x04type\x18\x01 \x01(\x0e\x32\x10.livekit.JobType\x12\x1b\n\x04room\x18\x02 \x01(\x0b\x32\r.livekit.Room\x12-\n\x0bparticipant\x18\x03 \x01(\x0b\x32\x18.livekit.ParticipantInfo\"\x1f\n\nWorkerPing\x12\x11\n\ttimestamp\x18\x01 \x01(\x03\"7\n\nWorkerPong\x12\x16\n\x0elast_timestamp\x18\x01 \x01(\x03\x12\x11\n\ttimestamp\x18\x02 \x01(\x03\"\xd6\x01\n\x15RegisterWorkerRequest\x12\x1e\n\x04type\x18\x01 \x01(\x0e\x32\x10.livekit.JobType\x12\x12\n\nagent_name\x18\x08 \x01(\t\x12\x0f\n\x07version\x18\x03 \x01(\t\x12\x15\n\rping_interval\x18\x05 \x01(\r\x12\x16\n\tnamespace\x18\x06 \x01(\tH\x00\x88\x01\x01\x12;\n\x13\x61llowed_permissions\x18\x07 \x01(\x0b\x32\x1e.livekit.ParticipantPermissionB\x0c\n\n_namespace\"U\n\x16RegisterWorkerResponse\x12\x11\n\tworker_id\x18\x01 \x01(\t\x12(\n\x0bserver_info\x18\x03 \x01(\x0b\x32\x13.livekit.ServerInfo\"$\n\x11MigrateJobRequest\x12\x0f\n\x07job_ids\x18\x02 \x03(\t\"B\n\x13\x41vailabilityRequest\x12\x19\n\x03job\x18\x01 \x01(\x0b\x32\x0c.livekit.Job\x12\x10\n\x08resuming\x18\x02 \x01(\x08\"\xc0\x02\n\x14\x41vailabilityResponse\x12\x0e\n\x06job_id\x18\x01 \x01(\t\x12\x11\n\tavailable\x18\x02 \x01(\x08\x12\x17\n\x0fsupports_resume\x18\x03 \x01(\x08\x12\x18\n\x10participant_name\x18\x04 \x01(\t\x12\x1c\n\x14participant_identity\x18\x05 \x01(\t\x12\x1c\n\x14participant_metadata\x18\x06 \x01(\t\x12X\n\x16participant_attributes\x18\x07 \x03(\x0b\x32\x38.livekit.AvailabilityResponse.ParticipantAttributesEntry\x1a<\n\x1aParticipantAttributesEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"T\n\x0fUpdateJobStatus\x12\x0e\n\x06job_id\x18\x01 \x01(\t\x12\"\n\x06status\x18\x02 \x01(\x0e\x32\x12.livekit.JobStatus\x12\r\n\x05\x65rror\x18\x03 \x01(\t\"l\n\x12UpdateWorkerStatus\x12*\n\x06status\x18\x01 \x01(\x0e\x32\x15.livekit.WorkerStatusH\x00\x88\x01\x01\x12\x0c\n\x04load\x18\x03 \x01(\x02\x12\x11\n\tjob_count\x18\x04 \x01(\rB\t\n\x07_status\"S\n\rJobAssignment\x12\x19\n\x03job\x18\x01 \x01(\x0b\x32\x0c.livekit.Job\x12\x10\n\x03url\x18\x02 \x01(\tH\x00\x88\x01\x01\x12\r\n\x05token\x18\x03 \x01(\tB\x06\n\x04_url\" \n\x0eJobTermination\x12\x0e\n\x06job_id\x18\x01 \x01(\t*(\n\x07JobType\x12\x0b\n\x07JT_ROOM\x10\x00\x12\x10\n\x0cJT_PUBLISHER\x10\x01*-\n\x0cWorkerStatus\x12\x10\n\x0cWS_AVAILABLE\x10\x00\x12\x0b\n\x07WS_FULL\x10\x01*J\n\tJobStatus\x12\x0e\n\nJS_PENDING\x10\x00\x12\x0e\n\nJS_RUNNING\x10\x01\x12\x0e\n\nJS_SUCCESS\x10\x02\x12\r\n\tJS_FAILED\x10\x03\x42\x46Z#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)
+
+module LiveKit
+  module Proto
+    Job = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.Job").msgclass
+    JobState = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.JobState").msgclass
+    WorkerMessage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.WorkerMessage").msgclass
+    ServerMessage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.ServerMessage").msgclass
+    SimulateJobRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.SimulateJobRequest").msgclass
+    WorkerPing = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.WorkerPing").msgclass
+    WorkerPong = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.WorkerPong").msgclass
+    RegisterWorkerRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.RegisterWorkerRequest").msgclass
+    RegisterWorkerResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.RegisterWorkerResponse").msgclass
+    MigrateJobRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.MigrateJobRequest").msgclass
+    AvailabilityRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.AvailabilityRequest").msgclass
+    AvailabilityResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.AvailabilityResponse").msgclass
+    UpdateJobStatus = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.UpdateJobStatus").msgclass
+    UpdateWorkerStatus = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.UpdateWorkerStatus").msgclass
+    JobAssignment = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.JobAssignment").msgclass
+    JobTermination = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.JobTermination").msgclass
+    JobType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.JobType").enummodule
+    WorkerStatus = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.WorkerStatus").enummodule
+    JobStatus = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("livekit.JobStatus").enummodule
+  end
+end

data/lib/livekit/proto/livekit_agent_twirp.rb

@@ -0,0 +1,8 @@
+# Code generated by protoc-gen-twirp_ruby 1.11.0, DO NOT EDIT.
+require 'twirp'
+require_relative 'livekit_agent_pb.rb'
+
+module LiveKit
+  module Proto
+  end
+end