skillrouter 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 86d4927e3c17824677d528040ea63bf5f763f7b981fb64e6d623785bfc34f46f
+  data.tar.gz: e1b61db17c4c136b13d05b4d1bf373e0bff04e2e9e04cb19a1b19de8f38a32f7
+SHA512:
+  metadata.gz: 03bfaca3966c6deb0c74bd72d2c47fcb013ca769dfaeec230c8386d0297aed9af95459a7026b09b1cc632437204b090ffdde54b652f4b5ece014c95d7c10acfc
+  data.tar.gz: 51a4bcb5891e0a52b062767bc4a7ad1b91e404cd934730345285a467fee01270cad2ec43f3ad14381dc09c04178e21e47fff0a34d0095227c01a184e182fd44a

data/lib/skillrouter/client.rb

@@ -0,0 +1,152 @@
+require "net/http"
+require "uri"
+require "json"
+
+module SkillRouter
+  class Client
+    attr_reader :api_key, :base_url, :timeout, :max_retries
+
+    def initialize(api_key: nil, base_url: nil, timeout: nil, max_retries: nil)
+      config     = SkillRouter.configuration
+      @api_key     = api_key     || config.api_key
+      @base_url    = base_url    || config.base_url
+      @timeout     = timeout     || config.timeout
+      @max_retries = max_retries || config.max_retries
+
+      raise AuthenticationError, "API key is required. Set it via SkillRouter.configure or pass api_key:" unless @api_key
+    end
+
+    # List skills with optional filters
+    def skills(category: nil, provider: nil, search: nil, page: 1, per_page: 20)
+      params = { page: page, per_page: per_page }
+      params[:category] = category if category
+      params[:provider] = provider if provider
+      params[:search] = search if search
+      request(:get, "/v1/skills", params: params)
+    end
+
+    # Get a single skill by ID or slug
+    def skill(id)
+      request(:get, "/v1/skills/#{id}")
+    end
+
+    # Discover skills using natural language
+    def discover(query, category: nil, limit: 5)
+      body = { query: query, limit: limit }
+      body[:category] = category if category
+      request(:post, "/v1/skills/discover", body: body)
+    end
+
+    # Execute a skill
+    def execute(skill_id:, params:, async: false, timeout_ms: nil)
+      body = { skill_id: skill_id, params: params }
+      body[:async] = async if async
+      body[:timeout_ms] = timeout_ms if timeout_ms
+      request(:post, "/v1/execute", body: body)
+    end
+
+    # List executions
+    def executions(page: 1, per_page: 20)
+      request(:get, "/v1/executions", params: { page: page, per_page: per_page })
+    end
+
+    # Get a single execution
+    def execution(id)
+      request(:get, "/v1/executions/#{id}")
+    end
+
+    # Get usage stats
+    def usage
+      request(:get, "/v1/usage")
+    end
+
+    # Get account info
+    def account
+      request(:get, "/v1/account")
+    end
+
+    # List skillsets
+    def skillsets
+      request(:get, "/v1/skillsets")
+    end
+
+    # Create a skillset
+    def create_skillset(name:, description: nil, skill_ids: [])
+      body = { name: name, skill_ids: skill_ids }
+      body[:description] = description if description
+      request(:post, "/v1/skillsets", body: body)
+    end
+
+    # Delete a skillset
+    def delete_skillset(id)
+      request(:delete, "/v1/skillsets/#{id}")
+    end
+
+    private
+
+    def request(method, path, params: {}, body: nil)
+      uri = URI("#{@base_url}#{path}")
+      uri.query = URI.encode_www_form(params) unless params.empty?
+
+      retries = 0
+      begin
+        response = make_request(method, uri, body)
+        handle_response(response)
+      rescue RateLimitError, ServerError => e
+        retries += 1
+        raise e if retries > @max_retries
+        sleep(2 ** retries * 0.5)
+        retry
+      end
+    end
+
+    def make_request(method, uri, body)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == "https"
+      http.open_timeout = @timeout
+      http.read_timeout = @timeout
+
+      req = case method
+            when :get    then Net::HTTP::Get.new(uri)
+            when :post   then Net::HTTP::Post.new(uri)
+            when :delete then Net::HTTP::Delete.new(uri)
+            else raise ArgumentError, "Unsupported HTTP method: #{method}"
+            end
+
+      req["Authorization"] = "Bearer #{@api_key}"
+      req["Content-Type"]  = "application/json"
+      req["User-Agent"]    = "skillrouter-ruby/#{VERSION}"
+
+      if body
+        req.body = body.to_json
+      end
+
+      http.request(req)
+    rescue Net::OpenTimeout, Net::ReadTimeout
+      raise TimeoutError, "Request timed out after #{@timeout}s"
+    end
+
+    def handle_response(response)
+      body = response.body ? JSON.parse(response.body, symbolize_names: true) : {}
+
+      case response.code.to_i
+      when 200..299
+        body
+      when 401
+        raise AuthenticationError, body[:error] || "Invalid API key"
+      when 404
+        raise NotFoundError, body[:error] || "Resource not found"
+      when 422
+        raise ValidationError, body[:error] || "Validation failed"
+      when 429
+        raise RateLimitError, body[:error] || "Rate limit exceeded"
+      when 500..599
+        raise ServerError, body[:error] || "Server error (#{response.code})"
+      else
+        raise Error, body[:error] || "Unexpected response (#{response.code})"
+      end
+    rescue JSON::ParserError
+      raise Error, "Invalid JSON response from server"
+    end
+  end
+end

data/lib/skillrouter/configuration.rb

@@ -0,0 +1,12 @@
+module SkillRouter
+  class Configuration
+    attr_accessor :api_key, :base_url, :timeout, :max_retries
+
+    def initialize
+      @api_key     = ENV["SKILLROUTER_API_KEY"]
+      @base_url    = "https://api.skillrouter.dev"
+      @timeout     = 30
+      @max_retries = 2
+    end
+  end
+end

data/lib/skillrouter/errors.rb

@@ -0,0 +1,9 @@
+module SkillRouter
+  class Error < StandardError; end
+  class AuthenticationError < Error; end
+  class RateLimitError < Error; end
+  class NotFoundError < Error; end
+  class ValidationError < Error; end
+  class ServerError < Error; end
+  class TimeoutError < Error; end
+end

data/lib/skillrouter/version.rb

@@ -0,0 +1,3 @@
+module SkillRouter
+  VERSION = "0.1.0"
+end

data/lib/skillrouter.rb

@@ -0,0 +1,22 @@
+require_relative "skillrouter/version"
+require_relative "skillrouter/configuration"
+require_relative "skillrouter/client"
+require_relative "skillrouter/errors"
+
+module SkillRouter
+  class << self
+    attr_writer :configuration
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield(configuration)
+    end
+
+    def reset!
+      @configuration = Configuration.new
+    end
+  end
+end

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification
+name: skillrouter
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- SkillRouter
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: Discover, validate, and execute skills for AI agents via the SkillRouter
+  API. One API to give your agents access to 1,000+ tools.
+email: developers@skillrouter.dev
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/skillrouter.rb
+- lib/skillrouter/client.rb
+- lib/skillrouter/configuration.rb
+- lib/skillrouter/errors.rb
+- lib/skillrouter/version.rb
+homepage: https://skillrouter.dev
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://skillrouter.dev
+  source_code_uri: https://github.com/skillrouter/ruby-sdk
+  documentation_uri: https://skillrouter.dev/docs/sdk/ruby
+  bug_tracker_uri: https://github.com/skillrouter/ruby-sdk/issues
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.8
+specification_version: 4
+summary: Official Ruby client for the SkillRouter API
+test_files: []