swarm_cli 2.1.13 → 3.0.0.alpha2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: af3e0c037fa25f545dd90fe21908da554c7cb3242d752c58eabec95b7453c840
-  data.tar.gz: 52aee53c8a31b17a0035d95e814f756ae01ca7b895aa94216e77a8a03af14b89
+  metadata.gz: 54f2afe1d7e949a29c1c257d51da1c2356d72093a7dc352795b9b49649ce6068
+  data.tar.gz: c5fc91ff7d7505d7ca44127b62100f8f0e26d92cfe497309f1589fdba6ac7894
 SHA512:
-  metadata.gz: 444bfa6029186f64b6d6fea74c1bf6c7dd1976971a6ea383ac1c49bf128d1c515f074d53266a35414a1cd32f58cdfd2d83b8ecd3a934293d01e691a7b4df8d68
-  data.tar.gz: 05e3f8f1e937f19c916f72fd78f74591df2b2862ad34885010b8b63dd4958e178f7112e1e9227192ef480da2efa53ce6f4d7563be3fba85893ddb086de828b09
+  metadata.gz: cb4ed1132f74f4f010ea4410e64a697e1145558512900565dc1c71e8fdc939b582e8bb7f364b390e999dae46c1e9569616a76c97dade67ce8765c1e5a363f2e5
+  data.tar.gz: 0db61c92971142f794bbbb238f8993aedda89dfa7e3233aa1a83715cb35da82f05bf35307a4b7c66e46cb2e150584e0b2a266e9d9a8b4787154e141b514eb8fc

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present Paulo Arruda
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/exe/swarm3

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# V3 CLI executable
+#
+# This uses the standalone V3 entry point which only loads V3 code
+# and minimal dependencies. Works with swarm_sdk 3.x and swarm_cli 3.x.
+
+require "swarm_cli/v3"
+
+SwarmCLI::V3::CLI.start(ARGV)

data/lib/swarm_cli/v3/activity_indicator.rb

@@ -0,0 +1,168 @@
+# frozen_string_literal: true
+
+module SwarmCLI
+  module V3
+    # Renders the activity indicator above the separator line.
+    #
+    # Three states: +:idle+, +:working+, +:done+.
+    #
+    # - **idle** — nothing rendered, {#footer_lines} is 0.
+    # - **working** — breathing "Working..." animation, ticker thread running.
+    #   Optionally shows a status suffix (e.g. "🧠 retrieval (133ms)").
+    # - **done** — static "Done (Xs)" message, no ticker. Stays in the footer
+    #   until the next {#start} call clears it.
+    #
+    # The state machine:
+    #   idle → start → working → stop → done → start → working …
+    #
+    # @example
+    #   indicator = ActivityIndicator.new(on_tick: -> { display.redraw })
+    #   indicator.start
+    #   indicator.render     # => "\n⏳ Working... (2s)\n"
+    #   indicator.status = "🧠 retrieval: 133ms"
+    #   indicator.render     # => "\n⏳ Working... (2s • 🧠 retrieval: 133ms)\n"
+    #   indicator.stop
+    #   indicator.render     # => "\n• Done (2s)\n"
+    class ActivityIndicator
+      TICK_INTERVAL = 0.15
+
+      # @param on_tick [#call, nil] callback invoked on every ticker tick
+      def initialize(on_tick: nil)
+        @on_tick = on_tick
+        @state = :idle
+        @work_start_time = nil
+        @done_elapsed = nil
+        @status = nil
+        @ticker_thread = nil
+      end
+
+      # Begin the working state and start the ticker thread.
+      #
+      # Transitions from any state (idle or done) to working.
+      #
+      # @return [void]
+      def start
+        @done_elapsed = nil
+        @status = nil
+        @work_start_time = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+        @state = :working
+        start_ticker
+      end
+
+      # End the working state and transition to done.
+      #
+      # The done state keeps the indicator visible in the footer with
+      # elapsed time until the next {#start} call.
+      #
+      # @return [void]
+      def stop
+        return unless @state == :working
+
+        stop_ticker
+        @done_elapsed = elapsed_seconds
+        @state = :done
+        @status = nil
+        @work_start_time = nil
+      end
+
+      # Set a status suffix shown on the working line.
+      #
+      # @param text [String, nil] status text (e.g. "🧠 retrieval (133ms)")
+      # @return [void]
+      attr_writer :status
+
+      # @return [Boolean] true if currently in the working state
+      def working?
+        @state == :working
+      end
+
+      # @return [Boolean] true if indicator occupies footer space (working or done)
+      def visible?
+        @state != :idle
+      end
+
+      # Render the indicator line for the current state.
+      #
+      # @return [String, nil] rendered indicator, or nil when idle
+      def render
+        case @state
+        when :working
+          render_working
+        when :done
+          render_done
+        end
+      end
+
+      # Number of extra footer lines this indicator contributes.
+      #
+      # @return [Integer] 0 when idle, 2 when working or done
+      def footer_lines
+        @state == :idle ? 0 : 2
+      end
+
+      private
+
+      def render_working
+        return unless @work_start_time
+
+        now = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+        elapsed = (now - @work_start_time).round
+
+        # Sine wave over 256-color grayscale for a smooth breathe.
+        gray = 247 + (Math.sin(now * Math::PI) * 5).round
+        pulse = "\e[38;5;#{gray}m"
+
+        detail = format_duration(elapsed)
+        detail = "#{detail} \u{2022} #{@status}" if @status
+        "\n#{pulse}\u{23F3} Working...\e[0m \e[38;5;243m(#{detail})\e[0m\n"
+      end
+
+      def render_done
+        "\n#{ANSIColors.dim("\u{2022} Done (#{format_duration(@done_elapsed)})")}\n"
+      end
+
+      def elapsed_seconds
+        return 0 unless @work_start_time
+
+        (Process.clock_gettime(Process::CLOCK_MONOTONIC) - @work_start_time).round
+      end
+
+      # Format seconds into a human-readable duration.
+      #
+      # @param seconds [Integer]
+      # @return [String] e.g. "3s", "2m 15s", "1h 5m"
+      def format_duration(seconds)
+        return "#{seconds}s" if seconds < 60
+
+        minutes, secs = seconds.divmod(60)
+        return "#{minutes}m #{secs}s" if minutes < 60
+
+        hours, mins = minutes.divmod(60)
+        return "#{hours}h #{mins}m" if hours < 24
+
+        days, hrs = hours.divmod(24)
+        "#{days}d #{hrs}h"
+      end
+
+      # Start a background thread that invokes +on_tick+ at ~7 fps.
+      def start_ticker
+        stop_ticker
+        @ticker_thread = Thread.new do
+          while @state == :working
+            sleep(TICK_INTERVAL)
+            @on_tick&.call
+          end
+        end
+      end
+
+      # Stop the ticker thread.
+      def stop_ticker
+        return unless @ticker_thread
+
+        @ticker_thread.kill
+        @ticker_thread.join(0.1)
+        @ticker_thread = nil
+      end
+    end
+  end
+end

data/lib/swarm_cli/v3/ansi_colors.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module SwarmCLI
+  module V3
+    # Minimal ANSI escape code helpers for terminal styling.
+    #
+    # Avoids external dependencies (like Pastel) to keep the V3 CLI
+    # lightweight. Each method wraps text in an ANSI escape sequence
+    # and appends the reset code.
+    #
+    # @example
+    #   ANSIColors.bold("hello")  # => "\e[1mhello\e[0m"
+    #   ANSIColors.red("error")   # => "\e[31merror\e[0m"
+    module ANSIColors
+      RESET   = "\e[0m"
+      BOLD    = "\e[1m"
+      DIM     = "\e[2m"
+      ITALIC  = "\e[3m"
+      REVERSE = "\e[7m"
+      GREEN   = "\e[32m"
+      CYAN    = "\e[36m"
+      YELLOW  = "\e[33m"
+      RED     = "\e[31m"
+      BLUE    = "\e[34m"
+      MAGENTA = "\e[35m"
+
+      class << self
+        # @param text [String] text to wrap
+        # @return [String] bold-styled text
+        def bold(text)    = "#{BOLD}#{text}#{RESET}"
+
+        # @param text [String] text to wrap
+        # @return [String] dim-styled text
+        def dim(text)     = "#{DIM}#{text}#{RESET}"
+
+        # @param text [String] text to wrap
+        # @return [String] italic-styled text
+        def italic(text)  = "#{ITALIC}#{text}#{RESET}"
+
+        # @param text [String] text to wrap
+        # @return [String] reverse-video styled text
+        def reverse(text) = "#{REVERSE}#{text}#{RESET}"
+
+        # @param text [String] text to wrap
+        # @return [String] green-colored text
+        def green(text)   = "#{GREEN}#{text}#{RESET}"
+
+        # @param text [String] text to wrap
+        # @return [String] cyan-colored text
+        def cyan(text)    = "#{CYAN}#{text}#{RESET}"
+
+        # @param text [String] text to wrap
+        # @return [String] yellow-colored text
+        def yellow(text)  = "#{YELLOW}#{text}#{RESET}"
+
+        # @param text [String] text to wrap
+        # @return [String] red-colored text
+        def red(text)     = "#{RED}#{text}#{RESET}"
+
+        # @param text [String] text to wrap
+        # @return [String] blue-colored text
+        def blue(text)    = "#{BLUE}#{text}#{RESET}"
+
+        # @param text [String] text to wrap
+        # @return [String] magenta-colored text
+        def magenta(text) = "#{MAGENTA}#{text}#{RESET}"
+      end
+    end
+  end
+end