schwarm-cli 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 485f701799de73d084bf43fff3cc0ebf1244a41397775baea03de793b860b4b9
+  data.tar.gz: 6125bc6e805189c3faa9ec3d33ff6545fd77c4c93ab966ccae142a2fc50102a5
+SHA512:
+  metadata.gz: 1ef6550c32124fe3a2125dc2e79d10c05ec918bbabafd17918d1c13274954b33fae413cd679f58e5484c4b02b97bda64c6d495a62fb02d38e1afba389de7ac69
+  data.tar.gz: 2057d8334094ab913ebc115ed3818a54887cafa922688bcc66f54be4035322d51466ccd7610a1aad0b68f59ccb643604551a7b7e791168ba49f3be4a9e83dbf7

data/bin/schwarm

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/schwarm_cli"
+
+begin
+  SchwarmCli::Commands::Main.start(ARGV)
+rescue SchwarmCli::Error => e
+  warn "Error: #{e.message}"
+  exit 1
+rescue Interrupt
+  warn "\nInterrupted"
+  exit 130
+end

data/lib/schwarm_cli/client/agent_sessions.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module SchwarmCli
+  class Client
+    class AgentSessions < Resource
+      def list(source: nil, status: nil, page: nil, per_page: nil)
+        params = { source:, status:, page:, per_page: }.compact
+        get("/api/v2/agent_sessions", params).body
+      end
+
+      def find(id)
+        get("/api/v2/agent_sessions/#{id}").body
+      end
+    end
+  end
+end

data/lib/schwarm_cli/client/recurring_tasks.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module SchwarmCli
+  class Client
+    class RecurringTasks < Resource
+      def list(repository_id: nil, query: nil, page: nil, per_page: nil)
+        params = { repository_id:, q: query, page:, per_page: }.compact
+        get("/api/v2/recurring_tasks", params).body
+      end
+
+      def find(id)
+        get("/api/v2/recurring_tasks/#{id}").body
+      end
+
+      def create(**attributes)
+        post("/api/v2/recurring_tasks", { recurring_task: attributes }).body
+      end
+
+      def update(id, **attributes)
+        patch("/api/v2/recurring_tasks/#{id}", { recurring_task: attributes }).body
+      end
+
+      def destroy(id)
+        delete("/api/v2/recurring_tasks/#{id}")
+        nil
+      end
+
+      def toggle(id)
+        post("/api/v2/recurring_tasks/#{id}/toggle").body
+      end
+    end
+  end
+end

data/lib/schwarm_cli/client/repositories.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module SchwarmCli
+  class Client
+    class Repositories < Resource
+      def list(status: nil, query: nil, page: nil, per_page: nil)
+        params = { status:, q: query, page:, per_page: }.compact
+        get("/api/v2/repositories", params).body
+      end
+
+      def find(id)
+        get("/api/v2/repositories/#{id}").body
+      end
+
+      def create(**attributes)
+        post("/api/v2/repositories", { repository: attributes }).body
+      end
+
+      def update(id, **attributes)
+        patch("/api/v2/repositories/#{id}", { repository: attributes }).body
+      end
+
+      def destroy(id)
+        delete("/api/v2/repositories/#{id}")
+        nil
+      end
+
+      def pause(id)
+        post("/api/v2/repositories/#{id}/pause").body
+      end
+
+      def resume(id)
+        post("/api/v2/repositories/#{id}/resume").body
+      end
+    end
+  end
+end

data/lib/schwarm_cli/client/repository_agents.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module SchwarmCli
+  class Client
+    class RepositoryAgents < Resource
+      def list(repository_id: nil, query: nil, page: nil, per_page: nil)
+        params = { repository_id:, q: query, page:, per_page: }.compact
+        get("/api/v2/repository_agents", params).body
+      end
+
+      def find(id)
+        get("/api/v2/repository_agents/#{id}").body
+      end
+
+      def create(**attributes)
+        post("/api/v2/repository_agents", { repository_agent: attributes }).body
+      end
+
+      def update(id, **attributes)
+        patch("/api/v2/repository_agents/#{id}", { repository_agent: attributes }).body
+      end
+
+      def destroy(id)
+        delete("/api/v2/repository_agents/#{id}")
+        nil
+      end
+
+      def toggle(id)
+        post("/api/v2/repository_agents/#{id}/toggle").body
+      end
+
+      def run_now(id)
+        post("/api/v2/repository_agents/#{id}/run_now").body
+      end
+    end
+  end
+end

data/lib/schwarm_cli/client/repository_skills.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module SchwarmCli
+  class Client
+    class RepositorySkills < Resource
+      def list(repository_id: nil, skill_id: nil, page: nil, per_page: nil)
+        params = { repository_id:, skill_id:, page:, per_page: }.compact
+        get("/api/v2/repository_skills", params).body
+      end
+
+      def find(id)
+        get("/api/v2/repository_skills/#{id}").body
+      end
+
+      def create(**attributes)
+        post("/api/v2/repository_skills", { repository_skill: attributes }).body
+      end
+
+      def destroy(id)
+        delete("/api/v2/repository_skills/#{id}")
+        nil
+      end
+    end
+  end
+end

data/lib/schwarm_cli/client/resource.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module SchwarmCli
+  class Client
+    class Resource
+      def initialize(client:)
+        @client = client
+      end
+
+      private
+
+      attr_reader :client
+
+      def get(...) = client.get(...)
+      def post(...) = client.post(...)
+      def patch(...) = client.patch(...)
+      def delete(...) = client.delete(...)
+    end
+  end
+end

data/lib/schwarm_cli/client/secret_files.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module SchwarmCli
+  class Client
+    class SecretFiles < Resource
+      def list(repository_id: nil, page: nil, per_page: nil)
+        params = { repository_id:, page:, per_page: }.compact
+        get("/api/v2/secret_files", params).body
+      end
+
+      def find(id)
+        get("/api/v2/secret_files/#{id}").body
+      end
+
+      def create(**attributes)
+        post("/api/v2/secret_files", { secret_file: attributes }).body
+      end
+
+      def update(id, **attributes)
+        patch("/api/v2/secret_files/#{id}", { secret_file: attributes }).body
+      end
+
+      def destroy(id)
+        delete("/api/v2/secret_files/#{id}")
+        nil
+      end
+    end
+  end
+end

data/lib/schwarm_cli/client/shared_agents.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module SchwarmCli
+  class Client
+    class SharedAgents < Resource
+      def list(query: nil, page: nil, per_page: nil)
+        params = { q: query, page:, per_page: }.compact
+        get("/api/v2/shared_agents", params).body
+      end
+
+      def find(id)
+        get("/api/v2/shared_agents/#{id}").body
+      end
+
+      def create(**attributes)
+        post("/api/v2/shared_agents", { shared_agent: attributes }).body
+      end
+
+      def update(id, **attributes)
+        patch("/api/v2/shared_agents/#{id}", { shared_agent: attributes }).body
+      end
+
+      def destroy(id)
+        delete("/api/v2/shared_agents/#{id}")
+        nil
+      end
+
+      def toggle(id)
+        post("/api/v2/shared_agents/#{id}/toggle").body
+      end
+    end
+  end
+end

data/lib/schwarm_cli/client/skill_files.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module SchwarmCli
+  class Client
+    class SkillFiles < Resource
+      def list(skill_id:, page: nil, per_page: nil)
+        params = { page:, per_page: }.compact
+        get("/api/v2/skills/#{skill_id}/files", params).body
+      end
+
+      def find(skill_id:, id:)
+        get("/api/v2/skills/#{skill_id}/files/#{id}").body
+      end
+
+      def create(skill_id:, **attributes)
+        post("/api/v2/skills/#{skill_id}/files", { skill_file: attributes }).body
+      end
+
+      def update(skill_id:, id:, **attributes)
+        patch("/api/v2/skills/#{skill_id}/files/#{id}", { skill_file: attributes }).body
+      end
+
+      def destroy(skill_id:, id:)
+        delete("/api/v2/skills/#{skill_id}/files/#{id}")
+        nil
+      end
+    end
+  end
+end

data/lib/schwarm_cli/client/skills.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module SchwarmCli
+  class Client
+    class Skills < Resource
+      def list(query: nil, page: nil, per_page: nil)
+        params = { q: query, page:, per_page: }.compact
+        get("/api/v2/skills", params).body
+      end
+
+      def find(id)
+        get("/api/v2/skills/#{id}").body
+      end
+
+      def create(**attributes)
+        post("/api/v2/skills", { skill: attributes }).body
+      end
+
+      def update(id, **attributes)
+        patch("/api/v2/skills/#{id}", { skill: attributes }).body
+      end
+
+      def destroy(id)
+        delete("/api/v2/skills/#{id}")
+        nil
+      end
+    end
+  end
+end

data/lib/schwarm_cli/client/task_templates.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module SchwarmCli
+  class Client
+    class TaskTemplates < Resource
+      def list(query: nil, page: nil, per_page: nil)
+        params = { q: query, page:, per_page: }.compact
+        get("/api/v2/task_templates", params).body
+      end
+
+      def find(id)
+        get("/api/v2/task_templates/#{id}").body
+      end
+
+      def create(**attributes)
+        post("/api/v2/task_templates", { task_template: attributes }).body
+      end
+
+      def update(id, **attributes)
+        patch("/api/v2/task_templates/#{id}", { task_template: attributes }).body
+      end
+
+      def destroy(id)
+        delete("/api/v2/task_templates/#{id}")
+        nil
+      end
+    end
+  end
+end

data/lib/schwarm_cli/client/tasks.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module SchwarmCli
+  class Client
+    class Tasks < Resource
+      def list(status: nil, repository_id: nil, page: nil, per_page: nil, query: nil)
+        params = { status:, repository_id:, page:, per_page:, q: query }.compact
+        get("/api/v2/tasks", params).body
+      end
+
+      def find(id)
+        get("/api/v2/tasks/#{id}").body
+      end
+
+      def create(**attributes)
+        post("/api/v2/tasks", { task: attributes }).body
+      end
+
+      def update(id, **attributes)
+        patch("/api/v2/tasks/#{id}", { task: attributes }).body
+      end
+
+      def destroy(id)
+        delete("/api/v2/tasks/#{id}")
+        nil
+      end
+
+      def start(id)
+        post("/api/v2/tasks/#{id}/start").body
+      end
+
+      def archive(id)
+        post("/api/v2/tasks/#{id}/archive").body
+      end
+
+      def retry(id)
+        post("/api/v2/tasks/#{id}/retry").body
+      end
+
+      def reset(id)
+        post("/api/v2/tasks/#{id}/reset").body
+      end
+
+      def pause(id)
+        post("/api/v2/tasks/#{id}/pause").body
+      end
+    end
+  end
+end

data/lib/schwarm_cli/client/user_messages.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module SchwarmCli
+  class Client
+    class UserMessages < Resource
+      def create(task_id:, content:)
+        post("/api/v2/tasks/#{task_id}/messages", { user_message: { content: } }).body
+      end
+    end
+  end
+end

data/lib/schwarm_cli/client.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+require "faraday"
+require "faraday/net_http_persistent"
+require "faraday/retry"
+
+require_relative "client/resource"
+require_relative "client/tasks"
+require_relative "client/repositories"
+require_relative "client/skills"
+require_relative "client/skill_files"
+require_relative "client/task_templates"
+require_relative "client/recurring_tasks"
+require_relative "client/repository_agents"
+require_relative "client/shared_agents"
+require_relative "client/secret_files"
+require_relative "client/agent_sessions"
+require_relative "client/repository_skills"
+require_relative "client/user_messages"
+
+module SchwarmCli
+  class Client
+    attr_reader :tasks, :repositories, :skills, :skill_files, :templates,
+                :recurring, :agents, :shared_agents, :secrets, :sessions,
+                :repo_skills, :messages
+
+    def get(...) = conn.get(...)
+    def post(...) = conn.post(...)
+    def patch(...) = conn.patch(...)
+    def delete(...) = conn.delete(...)
+
+    def initialize(url: nil, api_key: nil, config_path: Config::DEFAULT_PATH)
+      config = Config.new(url:, api_key:, config_path:)
+      unless config.valid?
+        raise Error,
+              "Schwarm CLI not configured. Run `schwarm configure` or set SCHWARM_URL and SCHWARM_TOKEN."
+      end
+
+      @url = config.url
+      @api_key = config.api_key
+      init_resources
+    end
+
+    private
+
+    attr_reader :url, :api_key
+
+    def init_resources
+      @tasks = Tasks.new(client: self)
+      @repositories = Repositories.new(client: self)
+      @skills = Skills.new(client: self)
+      @skill_files = SkillFiles.new(client: self)
+      @templates = TaskTemplates.new(client: self)
+      @recurring = RecurringTasks.new(client: self)
+      @agents = RepositoryAgents.new(client: self)
+      @shared_agents = SharedAgents.new(client: self)
+      @secrets = SecretFiles.new(client: self)
+      @sessions = AgentSessions.new(client: self)
+      @repo_skills = RepositorySkills.new(client: self)
+      @messages = UserMessages.new(client: self)
+    end
+
+    def conn
+      @conn ||= Faraday.new(url:, headers:, **faraday_options) do |f|
+        f.request :json
+        f.request :authorization, "Bearer", api_key
+        f.request :retry, retry_options
+
+        f.response :json
+        f.response :raise_error
+
+        f.adapter :net_http_persistent
+      end
+    end
+
+    def headers
+      { "User-Agent" => "schwarm-cli/#{VERSION}" }
+    end
+
+    def faraday_options
+      {
+        request: {
+          open_timeout: 5,
+          read_timeout: 30,
+          write_timeout: 30
+        }
+      }
+    end
+
+    def retry_options
+      {
+        max: 3,
+        interval: 0.5,
+        backoff_factor: 2,
+        interval_randomness: 0.5,
+        retry_statuses: [429, 500, 502, 503, 504],
+        methods: %i[get head options]
+      }
+    end
+  end
+end

data/lib/schwarm_cli/commands/agents.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+module SchwarmCli
+  module Commands
+    class Agents < Base
+      desc "list", "List repository agents"
+      option :repo, type: :string, desc: "Filter by repository ID"
+      option :query, type: :string, desc: "Search by name"
+      def list
+        handle_errors do
+          data = client.agents.list(repository_id: options[:repo], query: options[:query])
+          output_list(data, columns: [%w[ID id], %w[NAME name], %w[REPO github_repository_id],
+                                      %w[ENABLED enabled], %w[SCHEDULE schedule]])
+        end
+      end
+
+      desc "show ID", "Show agent details"
+      def show(id)
+        handle_errors do
+          data = client.agents.find(id)
+          output_record(data, fields: {
+                          "ID" => "id", "Name" => "name", "Repository" => "github_repository_id",
+                          "Enabled" => "enabled", "Schedule" => "schedule", "Prompt" => "prompt",
+                          "Created" => "created_at", "Updated" => "updated_at"
+                        })
+        end
+      end
+
+      desc "create", "Create a repository agent"
+      option :name, type: :string, required: true, desc: "Agent name"
+      option :repo, type: :string, required: true, desc: "Repository ID"
+      option :prompt, type: :string, required: true, desc: "Agent prompt"
+      option :schedule, type: :string, desc: "Cron schedule"
+      def create
+        handle_errors do
+          attrs = { name: options[:name], github_repository_id: options[:repo], prompt: options[:prompt] }
+          attrs[:schedule] = options[:schedule] if options[:schedule]
+
+          data = client.agents.create(**attrs)
+          output_record(data, fields: { "ID" => "id", "Name" => "name", "Enabled" => "enabled" })
+        end
+      end
+
+      desc "update ID", "Update a repository agent"
+      option :name, type: :string, desc: "Agent name"
+      option :prompt, type: :string, desc: "Agent prompt"
+      option :schedule, type: :string, desc: "Cron schedule"
+      def update(id)
+        handle_errors do
+          data = client.agents.update(id, **update_attrs)
+          output_record(data, fields: { "ID" => "id", "Name" => "name", "Enabled" => "enabled" })
+        end
+      end
+
+      desc "delete ID", "Delete a repository agent"
+      def delete(id)
+        handle_errors do
+          client.agents.destroy(id)
+          puts "Agent #{id} deleted."
+        end
+      end
+
+      desc "toggle ID", "Toggle agent enabled/disabled"
+      def toggle(id)
+        handle_errors do
+          data = client.agents.toggle(id)
+          status = data.dig("data", "enabled") ? "enabled" : "disabled"
+          puts "Agent #{id} #{status}."
+        end
+      end
+
+      desc "run-now ID", "Trigger agent to run immediately"
+      map "run-now" => :run_now
+      def run_now(id)
+        handle_errors do
+          client.agents.run_now(id)
+          puts "Agent #{id} triggered."
+        end
+      end
+
+      private
+
+      def update_attrs
+        {}.tap do |attrs|
+          attrs[:name] = options[:name] if options[:name]
+          attrs[:prompt] = options[:prompt] if options[:prompt]
+          attrs[:schedule] = options[:schedule] if options[:schedule]
+        end
+      end
+    end
+  end
+end

data/lib/schwarm_cli/commands/base.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require "thor"
+
+module SchwarmCli
+  module Commands
+    class Base < Thor
+      class_option :json, type: :boolean, default: false, desc: "Output as JSON"
+      class_option :url, type: :string, desc: "Schwarm server URL (overrides config)"
+      class_option :token, type: :string, desc: "API key (overrides config)"
+
+      private
+
+      def client
+        @client ||= SchwarmCli::Client.new(url: options[:url], api_key: options[:token])
+      end
+
+      def output_list(data, columns:)
+        if options[:json]
+          Formatters::Json.format(data)
+        else
+          Formatters::Table.format_list(data["data"], columns:)
+        end
+      end
+
+      def output_record(data, fields:)
+        if options[:json]
+          Formatters::Json.format(data)
+        else
+          Formatters::Table.format_record(data["data"], fields:)
+        end
+      end
+
+      def handle_errors
+        yield
+      rescue Faraday::UnauthorizedError
+        abort "Error: Unauthorized. Check your API key or run `schwarm configure`."
+      rescue Faraday::ResourceNotFound
+        abort "Error: Not found."
+      rescue Faraday::UnprocessableEntityError => e
+        abort "Error: #{parse_error_body(e)}"
+      rescue Faraday::ClientError => e
+        abort "Error: #{e.message}"
+      rescue Faraday::ServerError
+        abort "Error: Server error. Try again later."
+      rescue Faraday::ConnectionFailed
+        abort "Error: Could not connect to Schwarm server."
+      rescue Faraday::TimeoutError
+        abort "Error: Request timed out."
+      end
+
+      def parse_error_body(error)
+        body = error.response&.dig(:body)
+        return "Validation failed" unless body.is_a?(String)
+
+        parsed = JSON.parse(body)
+        parsed.dig("error", "message") || "Validation failed"
+      rescue JSON::ParserError
+        "Validation failed"
+      end
+    end
+  end
+end