sveda-ruby-sdk 0.4.0 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2e9c79a05787a6a6af99f8b7bed30c9e8499e67d0452b0f42edc3c9eef452889
-  data.tar.gz: 1c6052da2b8651166262cb980affa9801e66e886466ad05aa7a6dd5edeb0cc3e
+  metadata.gz: 1754fc122354ff157ef4516100f284a86bc448d98201d3dcf3f3419c14e709a9
+  data.tar.gz: c09981f5be6f3329a1e8f92838de1836fea928ca2b5560aa7cff4bf94cdf4fec
 SHA512:
-  metadata.gz: 890fa72b61e9703b7b009b600279ed27a3166594c02efc4277850545f5c904c7508f25f3f28407f1e56a739bc18a0c3fbe05a7ec255442cc88390b9dfd441eb6
-  data.tar.gz: 63966c0d81e55939675d58a5013e2167b5c43e2edbb2372d6b1668b137515cb2e88d7eb42f7b9f2ac199dd182fc74e026cb2ed59209358ba7e07bd9e6b0cb79a
+  metadata.gz: 6760c72e6f547bd8bfe4aff3a1bbab7e71bc88130cd5f4ced49e27f71300fc5c69ea1d38076ba350af4c5647cb440b7fb247672c5f22f3e0aec2c8222876c271
+  data.tar.gz: 7d24e0cdce04ab2844a1950d83ee46b3f6116785865f6338bcfab13590476c4ef87654654357f29fade1bce31f5b15ca34b50d0e75a8391ef51308df2369e760

data/README.md

@@ -72,6 +72,15 @@ session = Sveda::Client.start_host_session(
 )
 ```
 
+## Agent introspection
+
+```ruby
+manifest = server.describe(current_user)
+puts JSON.pretty_generate(manifest)
+```
+
+In Rails apps that assign `config.x.sveda_host`, run `bin/rails sveda:tools` (optional `USER=email@example.com`). Playground apps also expose `GET /sveda/tools` when logged in.
+
 ## License
 
 GNU Affero General Public License v3.0. See [LICENSE](LICENSE).

data/lib/sveda/host/mcp_handler.rb

@@ -60,20 +60,7 @@ module Sveda
       end
 
       def list_tools(user)
-        @server.tools(user).map do |tool|
-          meta = {
-            domain: tool.domain,
-            mode: tool.mode
-          }
-          meta[:confirmation] = "required" if tool.respond_to?(:confirmation) && tool.confirmation == "required"
-          {
-            name: tool.name,
-            title: tool.name,
-            description: tool.description,
-            inputSchema: tool.input_schema,
-            _meta: meta
-          }
-        end
+        @server.mcp_tools(user)
       end
 
       def call_tool(params, user)

data/lib/sveda/host/server.rb

@@ -26,6 +26,7 @@ module Sveda
         @policy_using = nil
         @tools = []
         @mint_token = ->(user = nil) { @token_store.mint(user_id: user_id_for(user)) }
+        @mint_token_custom = false
         @authenticate = ->(token) { @token_store.lookup(token) }
         @authorize = nil
         @after_authenticate = nil
@@ -46,6 +47,7 @@ module Sveda
 
       def mint_token_using(&block)
         @mint_token = block
+        @mint_token_custom = true
       end
 
       def authenticate_using(&block)
@@ -132,6 +134,48 @@ module Sveda
         McpRackHandler.new(self)
       end
 
+      def mcp_tools(user = nil)
+        tools(user).map do |tool|
+          meta = {
+            domain: tool.domain,
+            mode: tool.mode
+          }
+          meta[:confirmation] = "required" if tool.respond_to?(:confirmation) && tool.confirmation == "required"
+          entry = {
+            name: tool.name,
+            title: tool.name,
+            description: tool.description,
+            inputSchema: tool.input_schema,
+            _meta: meta
+          }
+          entry
+        end
+      end
+
+      def registered_hooks
+        {
+          resolve_tools: !@resolve_tools.nil?,
+          policy: !@policy_using.nil?,
+          authorize: !@authorize.nil?,
+          visitor_id: false,
+          mint_token: @mint_token_custom
+        }
+      end
+
+      def describe(user = nil)
+        authenticated = !user.nil?
+        {
+          schema: "sveda.host/v1",
+          sdk: { language: "ruby", version: Sveda::VERSION },
+          subject: {
+            authenticated: authenticated,
+            policy: authenticated ? policy_for(user) : nil
+          },
+          hooks: registered_hooks,
+          tools: mcp_tools(user)
+        }
+      end
+
       private
 
       def invoke_resolve_tools(user)

data/lib/sveda/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Sveda
-  VERSION = "0.4.0"
+  VERSION = "0.5.1"
 end

data/lib/tasks/sveda.rake

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+namespace :sveda do
+  desc "Print the Sveda host tool manifest as JSON"
+  task tools: :environment do
+    host = Rails.application.config.x.sveda_host
+    unless host
+      warn "Sveda host is not configured (config.x.sveda_host)"
+      exit 1
+    end
+
+    user = ENV["USER"] || ENV["SVEDA_USER"]
+    subject = user ? host.describe(user) : host.describe
+    puts JSON.pretty_generate(subject)
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sveda-ruby-sdk
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.1
 platform: ruby
 authors:
 - Neresson
@@ -52,6 +52,7 @@ files:
 - lib/sveda/stream_event.rb
 - lib/sveda/stream_parser.rb
 - lib/sveda/version.rb
+- lib/tasks/sveda.rake
 homepage: https://sveda.dev/docs/hosts/ruby
 licenses:
 - AGPL-3.0-only