claude_swarm 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4085d9345464dcd7fc7be4c78155aa03f2467f7f089b056f2be0589f5de260f2
-  data.tar.gz: fda22e57619c30b1d9e1efcabb5a8a0b2b74f9f6df2d969944e07d27753adbd9
+  metadata.gz: 4f802dadf6aa3673a354582aed75d8887d8ff83c4d30d700eba89f7f3663eec9
+  data.tar.gz: a2aea35f422333fd2421d078bf336745c61172c900ac96da1d20d50100fef607
 SHA512:
-  metadata.gz: 216ff3a7bfda3f2763195eec1e32821596d7047c155d0757d33da0718ad1dbb3c51f04fe50591c2a99d98da37d53255a9bda11c9bf9b6bf79dff788ac27fc0c9
-  data.tar.gz: 39784e3be63360c32ec3388983a10068f9d8193bde6cebef190aae856a2da9caa47cb63c772e268203a85eb8a8fad2e0717a901401fffbd0ce8e716979cd3f20
+  metadata.gz: 7fb47e9059f561852a81411920dc0a0d568c5c47a2361823ee5425e3820ef21699c26072e1bf330fdfff4514b8fc3c182df59975266f3f62b5e89aeba31dd63a
+  data.tar.gz: dec84ec9eb8b0f95edb1d079fcc7ab155ed754713343f8730f68d248f28db1e9ad0571b734f885cbcc30fbda58a0cde077d5e7d18c960c5a9ad1e5c03df396a6

data/CHANGELOG.md

@@ -1,3 +1,16 @@
+## [0.2.1]
+
+### Added
+- **Ruby-OpenAI version validation**: Added validation to ensure ruby-openai >= 8.0 when using OpenAI provider with `api_version: "responses"`
+  - The responses API requires ruby-openai version 8.0 or higher
+  - Configuration validation now checks the installed version and provides helpful error messages
+  - Gracefully handles cases where ruby-openai is not installed
+
+### Changed
+- **Relaxed ruby-openai dependency**: The gemspec now accepts ruby-openai versions 7.x and 8.x (`>= 7.0, < 9.0`)
+  - Version 7.x works with the default chat_completion API
+  - Version 8.x is required for the responses API
+
 ## [0.2.0]
 
 ### Added

data/README.md

@@ -1,6 +1,6 @@
 # Claude Swarm
 
-[![Gem Version](https://badge.fury.io/rb/claude_swarm.svg?cache_bust=0.1.17)](https://badge.fury.io/rb/claude_swarm)
+[![Gem Version](https://badge.fury.io/rb/claude_swarm.svg?cache_bust=0.2.0)](https://badge.fury.io/rb/claude_swarm)
 [![CI](https://github.com/parruda/claude-swarm/actions/workflows/ci.yml/badge.svg)](https://github.com/parruda/claude-swarm/actions/workflows/ci.yml)
 
 Claude Swarm orchestrates multiple Claude Code instances as a collaborative AI development team. It enables running AI agents with specialized roles, tools, and directory contexts, communicating via MCP (Model Context Protocol) in a tree-like hierarchy. Define your swarm topology in simple YAML and let Claude instances delegate tasks through connected instances. Perfect for complex projects requiring specialized AI agents for frontend, backend, testing, DevOps, or research tasks.
@@ -320,6 +320,7 @@ When using `provider: openai`, the following additional fields are available:
 - GPT models support `temperature` but not `reasoning_effort`
 - OpenAI instances default to and ONLY operate as `vibe: true` and use MCP for tool access
 - By default it comes with Claude Code tools, connected with MCP to `claude mcp serve`
+- **Using the responses API requires ruby-openai >= 8.0** - the gem will validate this requirement at runtime
 
 ```yaml
 instance_name:

data/lib/claude_swarm/configuration.rb

@@ -119,6 +119,7 @@ module ClaudeSwarm
       validate_connections
       detect_circular_dependencies
       validate_openai_env_vars
+      validate_openai_responses_api_compatibility
     end
 
     def parse_instance(name, config)
@@ -330,5 +331,28 @@ module ClaudeSwarm
         raise Error, "Main instance '#{@main_instance}' cannot have a provider setting in interactive mode"
       end
     end
+
+    def validate_openai_responses_api_compatibility
+      # Check if any instance uses OpenAI provider with responses API
+      responses_api_instances = @instances.select do |_name, instance|
+        instance[:provider] == "openai" && instance[:api_version] == "responses"
+      end
+
+      return if responses_api_instances.empty?
+
+      # Check ruby-openai version
+      begin
+        require "openai/version"
+        openai_version = Gem::Version.new(::OpenAI::VERSION)
+        required_version = Gem::Version.new("8.0.0")
+
+        if openai_version < required_version
+          instance_names = responses_api_instances.keys.join(", ")
+          raise Error, "Instances #{instance_names} use OpenAI provider with api_version 'responses', which requires ruby-openai >= 8.0. Current version is #{openai_version}. Please update your Gemfile or run: gem install ruby-openai -v '>= 8.0'"
+        end
+      rescue LoadError
+        # ruby-openai is not installed, which is fine - it will be caught later when trying to use it
+      end
+    end
   end
 end

data/lib/claude_swarm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ClaudeSwarm
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

data/lib/claude_swarm/worktree_manager.rb

@@ -16,6 +16,8 @@ module ClaudeSwarm
       end
       @created_worktrees = {} # Maps "repo_root:worktree_name" to worktree_path
       @instance_worktree_configs = {} # Stores per-instance worktree settings
+      @instance_directories = {} # Stores original resolved directories for each instance
+      @instance_worktree_paths = {} # Stores worktree paths for each instance
     end
 
     def setup_worktrees(instances)
@@ -40,12 +42,23 @@ module ClaudeSwarm
           puts "Debug [WorktreeManager]: Worktree config: #{worktree_config.inspect}"
         end
 
-        next if worktree_config[:skip]
+        # Store original directories (resolved)
+        original_dirs = instance[:directories] || [instance[:directory]]
+        resolved_dirs = original_dirs.map { |dir| dir ? File.expand_path(dir) : nil }.compact
+        @instance_directories[instance[:name]] = resolved_dirs
+
+        if worktree_config[:skip]
+          # No worktree, paths remain the same
+          @instance_worktree_paths[instance[:name]] = resolved_dirs
+          next
+        end
 
         worktree_name = worktree_config[:name]
-        original_dirs = instance[:directories] || [instance[:directory]]
         mapped_dirs = original_dirs.map { |dir| map_to_worktree_path(dir, worktree_name) }
 
+        # Store the worktree paths
+        @instance_worktree_paths[instance[:name]] = mapped_dirs
+
         if ENV["CLAUDE_SWARM_DEBUG"]
           puts "Debug [WorktreeManager]: Original dirs: #{original_dirs.inspect}"
           puts "Debug [WorktreeManager]: Mapped dirs: #{mapped_dirs.inspect}"
@@ -166,11 +179,22 @@ module ClaudeSwarm
     end
 
     def session_metadata
+      # Build instance details with resolved paths and worktree mappings
+      instance_details = {}
+
+      @instance_worktree_configs.each do |instance_name, worktree_config|
+        instance_details[instance_name] = {
+          worktree_config: worktree_config,
+          directories: @instance_directories[instance_name] || {},
+          worktree_paths: @instance_worktree_paths[instance_name] || {},
+        }
+      end
+
       {
         enabled: true,
         shared_name: @shared_worktree_name,
         created_paths: @created_worktrees.dup,
-        instance_configs: @instance_worktree_configs.dup,
+        instance_configs: instance_details,
       }
     end
 

data/single.yml

@@ -313,7 +313,6 @@ swarm:
         5. IDENTIFY PATTERNS: Look for repeated code patterns across tests
         6. CREATE NEW HELPERS: When you find repeated patterns, create or suggest new helper methods
         7. RUN TESTS to check coverage: `bundle exec rake test`
-        8. VIEW COVERAGE REPORT: Open coverage/index.html after running tests
         
         The codebase typically provides helpers for:
         - File operations (temporary directories, config files)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: claude_swarm
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Paulo Arruda
@@ -69,16 +69,22 @@ dependencies:
   name: ruby-openai
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '8.1'
+        version: '9.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '8.1'
+        version: '9.0'
 description: |
   Claude Swarm enables you to run multiple Claude Code instances that communicate with each other
   via MCP (Model Context Protocol). Create AI development teams where each instance has specialized