schwarm-cli 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 485f701799de73d084bf43fff3cc0ebf1244a41397775baea03de793b860b4b9
-  data.tar.gz: 6125bc6e805189c3faa9ec3d33ff6545fd77c4c93ab966ccae142a2fc50102a5
+  metadata.gz: 407d8cf7c33a697ed71a0bd8b3345d278fa34705ec04fdc2ee358d55c7c549c2
+  data.tar.gz: 2949bbaf855be804caec35e0a25df038850c2bd4e7885421651f3cc48c4cbbe3
 SHA512:
-  metadata.gz: 1ef6550c32124fe3a2125dc2e79d10c05ec918bbabafd17918d1c13274954b33fae413cd679f58e5484c4b02b97bda64c6d495a62fb02d38e1afba389de7ac69
-  data.tar.gz: 2057d8334094ab913ebc115ed3818a54887cafa922688bcc66f54be4035322d51466ccd7610a1aad0b68f59ccb643604551a7b7e791168ba49f3be4a9e83dbf7
+  metadata.gz: d3841fa2204bac7b1ee9debab270e7509925388563d49a72dcfbbfb61d8c7ab593ccc14a6c6ec978925c43c0a83f46603e0607a28a4e5d4696f50b87f1f7e8c4
+  data.tar.gz: cffebca5659d080e7b05ddd386e254acc3870b40678a59ee3e76acf5e5ee82119643ecd7390df00b7102768b5f8e11703900927a4ba035e211b0314e33a3fb5b

data/lib/schwarm_cli/client/agent_sessions.rb

@@ -3,8 +3,9 @@
 module SchwarmCli
   class Client
     class AgentSessions < Resource
-      def list(source: nil, status: nil, page: nil, per_page: nil)
+      def list(source: nil, status: nil, page: nil, per_page: nil, active: nil)
         params = { source:, status:, page:, per_page: }.compact
+        params[:active] = active unless active.nil?
         get("/api/v2/agent_sessions", params).body
       end
 

data/lib/schwarm_cli/client/tasks.rb

@@ -3,8 +3,9 @@
 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
+      def list(query: nil, **filters)
+        params = filters.compact
+        params[:q] = query if query
         get("/api/v2/tasks", params).body
       end
 

data/lib/schwarm_cli/commands/agents.rb

@@ -6,10 +6,13 @@ module SchwarmCli
       desc "list", "List repository agents"
       option :repo, type: :string, desc: "Filter by repository ID"
       option :query, type: :string, desc: "Search by name"
+      pagination_options
       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],
+          data = fetch_paged do |page_params|
+            client.agents.list(repository_id: options[:repo], query: options[:query], **page_params)
+          end
+          output_list(data, columns: [%w[ID id], %w[NAME name], %w[REPO github_repository_name],
                                       %w[ENABLED enabled], %w[SCHEDULE schedule]])
         end
       end

data/lib/schwarm_cli/commands/base.rb

@@ -9,6 +9,16 @@ module SchwarmCli
       class_option :url, type: :string, desc: "Schwarm server URL (overrides config)"
       class_option :token, type: :string, desc: "API key (overrides config)"
 
+      DEFAULT_LIST_LIMIT = 20
+
+      # Declares --limit, --page, --all options for the next method.
+      def self.pagination_options
+        method_option :limit, type: :numeric,
+                              desc: "Max results per page (default: #{DEFAULT_LIST_LIMIT})"
+        method_option :page, type: :numeric, desc: "Page number (1-indexed)"
+        method_option :all, type: :boolean, default: false, desc: "Fetch all pages (no cap)"
+      end
+
       private
 
       def client
@@ -19,8 +29,36 @@ module SchwarmCli
         if options[:json]
           Formatters::Json.format(data)
         else
-          Formatters::Table.format_list(data["data"], columns:)
+          Formatters::Table.format_list(data["data"], columns:, meta: data["meta"])
+        end
+      end
+
+      # Yields pagination params to the block (once per page). With --all, pages
+      # through all results; otherwise a single call using --limit/--page (or the
+      # CLI default limit). Returns the merged payload.
+      def fetch_paged(&block)
+        if options[:all]
+          fetch_all_pages(&block)
+        else
+          per_page = options[:limit] || DEFAULT_LIST_LIMIT
+          block.call({ page: options[:page], per_page: }.compact)
+        end
+      end
+
+      def fetch_all_pages
+        merged_data = []
+        page = 1
+        per_page = options[:limit] || 200
+        meta = nil
+        loop do
+          response = yield({ page:, per_page: })
+          merged_data.concat(response["data"] || [])
+          meta = response["meta"]
+          break unless meta && page < meta["total_pages"].to_i
+
+          page += 1
         end
+        { "data" => merged_data, "meta" => meta&.merge("page" => 1, "per_page" => merged_data.size) }
       end
 
       def output_record(data, fields:)

data/lib/schwarm_cli/commands/recurring.rb

@@ -6,10 +6,13 @@ module SchwarmCli
       desc "list", "List recurring tasks"
       option :repo, type: :string, desc: "Filter by repository ID"
       option :query, type: :string, desc: "Search by name"
+      pagination_options
       def list
         handle_errors do
-          data = client.recurring.list(repository_id: options[:repo], query: options[:query])
-          output_list(data, columns: [%w[ID id], %w[NAME name], %w[REPO github_repository_id],
+          data = fetch_paged do |page_params|
+            client.recurring.list(repository_id: options[:repo], query: options[:query], **page_params)
+          end
+          output_list(data, columns: [%w[ID id], %w[NAME name], %w[REPO github_repository_name],
                                       %w[ENABLED enabled], %w[SCHEDULE schedule]])
         end
       end

data/lib/schwarm_cli/commands/repo_skills.rb

@@ -6,11 +6,14 @@ module SchwarmCli
       desc "list", "List repository-skill associations"
       option :repo, type: :string, desc: "Filter by repository ID"
       option :skill, type: :string, desc: "Filter by skill ID"
+      pagination_options
       def list
         handle_errors do
-          data = client.repo_skills.list(repository_id: options[:repo], skill_id: options[:skill])
-          output_list(data, columns: [%w[ID id], %w[REPO github_repository_id],
-                                      %w[SKILL skill_id]])
+          data = fetch_paged do |page_params|
+            client.repo_skills.list(repository_id: options[:repo], skill_id: options[:skill], **page_params)
+          end
+          output_list(data, columns: [%w[ID id], %w[REPO github_repository_name],
+                                      %w[SKILL skill_name]])
         end
       end
 

data/lib/schwarm_cli/commands/repos.rb

@@ -6,9 +6,12 @@ module SchwarmCli
       desc "list", "List repositories"
       option :status, type: :string, desc: "Filter by status"
       option :query, type: :string, desc: "Search by name"
+      pagination_options
       def list
         handle_errors do
-          data = client.repositories.list(status: options[:status], query: options[:query])
+          data = fetch_paged do |page_params|
+            client.repositories.list(status: options[:status], query: options[:query], **page_params)
+          end
           output_list(data, columns: [%w[ID id], %w[NAME name], %w[STATUS status]])
         end
       end

data/lib/schwarm_cli/commands/secrets.rb

@@ -5,10 +5,13 @@ module SchwarmCli
     class Secrets < Base
       desc "list", "List secret files"
       option :repo, type: :string, desc: "Filter by repository ID"
+      pagination_options
       def list
         handle_errors do
-          data = client.secrets.list(repository_id: options[:repo])
-          output_list(data, columns: [%w[ID id], %w[NAME name], %w[REPO github_repository_id],
+          data = fetch_paged do |page_params|
+            client.secrets.list(repository_id: options[:repo], **page_params)
+          end
+          output_list(data, columns: [%w[ID id], %w[NAME name], %w[REPO github_repository_name],
                                       %w[PATH path]])
         end
       end

data/lib/schwarm_cli/commands/sessions.rb

@@ -3,12 +3,19 @@
 module SchwarmCli
   module Commands
     class Sessions < Base
-      desc "list", "List agent sessions"
+      desc "list", "List agent sessions (shows active ones by default)"
       option :source, type: :string, desc: "Filter by source"
       option :status, type: :string, desc: "Filter by status"
+      pagination_options
       def list
         handle_errors do
-          data = client.sessions.list(source: options[:source], status: options[:status])
+          active_only = options[:status].nil? && !options[:all]
+          data = fetch_paged do |page_params|
+            client.sessions.list(
+              source: options[:source], status: options[:status],
+              active: active_only ? true : nil, **page_params
+            )
+          end
           output_list(data, columns: [%w[ID id], %w[SOURCE source], %w[STATUS status],
                                       %w[CREATED created_at]])
         end

data/lib/schwarm_cli/commands/shared_agents.rb

@@ -5,9 +5,12 @@ module SchwarmCli
     class SharedAgentsCmd < Base
       desc "list", "List shared agents"
       option :query, type: :string, desc: "Search by name"
+      pagination_options
       def list
         handle_errors do
-          data = client.shared_agents.list(query: options[:query])
+          data = fetch_paged do |page_params|
+            client.shared_agents.list(query: options[:query], **page_params)
+          end
           output_list(data, columns: [%w[ID id], %w[NAME name], %w[ENABLED enabled],
                                       %w[SCHEDULE schedule]])
         end

data/lib/schwarm_cli/commands/skill_files.rb

@@ -6,9 +6,12 @@ module SchwarmCli
       class_option :skill, type: :string, required: true, desc: "Skill ID"
 
       desc "list", "List skill files"
+      pagination_options
       def list
         handle_errors do
-          data = client.skill_files.list(skill_id: options[:skill])
+          data = fetch_paged do |page_params|
+            client.skill_files.list(skill_id: options[:skill], **page_params)
+          end
           output_list(data, columns: [%w[ID id], %w[PATH path], %w[CREATED created_at]])
         end
       end

data/lib/schwarm_cli/commands/skills.rb

@@ -5,9 +5,12 @@ module SchwarmCli
     class SkillsCmd < Base
       desc "list", "List skills"
       option :query, type: :string, desc: "Search by name"
+      pagination_options
       def list
         handle_errors do
-          data = client.skills.list(query: options[:query])
+          data = fetch_paged do |page_params|
+            client.skills.list(query: options[:query], **page_params)
+          end
           output_list(data, columns: [%w[ID id], %w[NAME name], %w[GLOBAL global]])
         end
       end

data/lib/schwarm_cli/commands/tasks.rb

@@ -3,15 +3,16 @@
 module SchwarmCli
   module Commands
     class Tasks < Base
-      desc "list", "List tasks"
+      desc "list", "List tasks (excludes archived by default)"
       option :status, type: :string, desc: "Filter by status"
       option :repo, type: :string, desc: "Filter by repository ID"
       option :query, type: :string, desc: "Search by name"
+      pagination_options
       def list
         handle_errors do
-          data = client.tasks.list(status: options[:status], repository_id: options[:repo], query: options[:query])
+          data = fetch_paged { |page_params| client.tasks.list(**list_attrs, **page_params) }
           output_list(data, columns: [%w[ID id], %w[NAME name], %w[STATUS status],
-                                      %w[REPO github_repository_id], %w[CREATED created_at]])
+                                      %w[REPO github_repository_name], %w[CREATED created_at]])
         end
       end
 
@@ -115,6 +116,14 @@ module SchwarmCli
 
       private
 
+      def list_attrs
+        exclude_archived = options[:status].nil? && !options[:all]
+        {
+          status: options[:status], repository_id: options[:repo], query: options[:query],
+          archived: exclude_archived ? false : nil
+        }
+      end
+
       def create_attrs
         {
           name: options[:name], prompt: read_prompt,

data/lib/schwarm_cli/commands/templates.rb

@@ -5,9 +5,12 @@ module SchwarmCli
     class Templates < Base
       desc "list", "List task templates"
       option :query, type: :string, desc: "Search by name"
+      pagination_options
       def list
         handle_errors do
-          data = client.templates.list(query: options[:query])
+          data = fetch_paged do |page_params|
+            client.templates.list(query: options[:query], **page_params)
+          end
           output_list(data, columns: [%w[ID id], %w[NAME name], %w[CREATED created_at]])
         end
       end

data/lib/schwarm_cli/formatters/table.rb

@@ -3,7 +3,7 @@
 module SchwarmCli
   module Formatters
     module Table
-      def self.format_list(records, columns:)
+      def self.format_list(records, columns:, meta: nil)
         if records.empty?
           puts "No results found."
           return
@@ -14,6 +14,18 @@ module SchwarmCli
         records.each do |record|
           puts format_row(columns.map { |_, key| record[key].to_s }, columns, widths)
         end
+        footer = pagination_footer(records, meta)
+        puts "\n#{footer}" if footer
+      end
+
+      def self.pagination_footer(records, meta)
+        meta = meta&.transform_keys(&:to_s)
+        total = meta && meta["total_count"]
+        return nil if total.nil? || total <= records.size
+
+        parts = ["showing #{records.size} of #{total}"]
+        parts << "page #{meta['page']} of #{meta['total_pages']}" if meta["total_pages"].to_i > 1
+        "#{parts.join(' · ')} — use --all or --page/--limit to see more"
       end
 
       def self.format_record(record, fields:)
@@ -33,7 +45,7 @@ module SchwarmCli
         values.zip(columns).map { |val, (_, key)| val.ljust(widths[key]) }.join("  ")
       end
 
-      private_class_method :column_widths, :format_row
+      private_class_method :column_widths, :format_row, :pagination_footer
     end
   end
 end

data/lib/schwarm_cli/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SchwarmCli
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: schwarm-cli
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Vincent Garrigues