claude_swarm 1.0.7 → 1.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9c8e0f8bb459a909a37216a620952bf08315a2943216865bee2890cd870bbd1c
-  data.tar.gz: 73315162dc30338385e89423fd9c509ab051b4caf4dbb0ba1d8ebbb681bbc3b2
+  metadata.gz: 1b5d5d686096a33cf7a16511f728091f92e2bb33d9c5eeacdf430718a1a8548e
+  data.tar.gz: 63e3445e6279abc98b4202b582cfc48a4e17b610339241ba0872532a61174697
 SHA512:
-  metadata.gz: 4ca20259cbe8dc8ac5b9a0b7adb2c7454af0e375e6d397e52407a991b0690dffe8c4365c37f9b3653c1f0c38dce7af4bb3afeca0151d5ba3b8185276355ca500
-  data.tar.gz: 97d0b2aa55a3df7178ff0bc25b923403402e6fd08f7b15a517c6aa775bd4dca1c9983a0bcaa392186844d684459f63c357aa1aba92ad09db5e83d791d54d0031
+  metadata.gz: 8521d7386607e3391915dfeb68f82ca9df8361566832724fe8e59357444137530a4b825e9c665f328a6157a0ee6a7202ad536409e59253d4f7fdb909482bc178
+  data.tar.gz: c34358c386fac205277cab662b3041330b5006878520f8c8ae265a316bc239e71d396e5ed4ea77c897bc7bf5b465eddf810cb227be13ba189cc27169496e6d78

data/CHANGELOG.md

@@ -1,3 +1,24 @@
+## [1.0.9]
+
+### Added
+- **Zero Data Retention (ZDR) support for OpenAI Responses API**: Added ZDR mode to disable conversation continuity for privacy-focused use cases
+  - New `zdr` configuration parameter (boolean) that can be set in YAML configuration files
+  - When enabled, sets `previous_response_id` to nil, ensuring each API call is independent
+  - Supported in Configuration, CLI (`--zdr` flag), and MCP generator
+
+## [1.0.8]
+
+### Changed
+- **Removed model-specific parameter restrictions for OpenAI**: Simplified parameter handling by allowing OpenAI's API to validate parameters instead of enforcing client-side restrictions
+  - Removed validation that prevented using `temperature` with o-series models
+  - Removed validation that restricted `reasoning_effort` to only o-series models
+  - Eliminated `O_SERIES_MODEL_PATTERN` constant and related model pattern matching logic
+  - Parameters are now passed to the API as-is when provided, allowing flexibility as OpenAI's model capabilities evolve
+  - Reduces maintenance burden when new models are released
+  - API errors provide authoritative feedback for invalid parameter combinations
+
+### Fixed
+
 ## [1.0.7]
 
 ### Fixed

data/docs/v1/README.md

@@ -2,6 +2,8 @@
 
 [![Gem Version](https://badge.fury.io/rb/claude_swarm.svg?cache_bust1=1.0.1)](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)
+[![Mentioned in Awesome Claude Code](https://awesome.re/mentioned-badge-flat.svg)](https://github.com/hesreallyhim/awesome-claude-code)
+
 
 > **Note**: This is the documentation for Claude Swarm v1, which uses a multi-process architecture with Claude Code instances. For new projects, we recommend using [SwarmSDK v2](../v2/README.md) which offers a single-process architecture, better performance, and more features.
 
@@ -370,6 +372,7 @@ When using `provider: openai`, the following additional fields are available:
 - **openai_token_env**: Environment variable name for OpenAI API key (default: "OPENAI_API_KEY")
 - **base_url**: Custom base URL for OpenAI API (optional)
 - **reasoning_effort**: Reasoning effort for O-series models only - "low", "medium", or "high"
+- **zdr**: Zero Data Retention mode (boolean) - when set to `true`, disables conversation continuity by setting `previous_response_id` to nil (responses API only)
 
 **Important Notes:**
 
@@ -426,6 +429,15 @@ reasoning_instance:
   reasoning_effort: medium # Only for O-series models
   api_version: responses # Can use either API version
   prompt: "You are a reasoning assistant for complex problem solving"
+
+# Instance with Zero Data Retention mode
+zdr_instance:
+  description: "Privacy-focused assistant with no conversation memory"
+  provider: openai
+  model: gpt-4o
+  api_version: responses # ZDR only works with responses API
+  zdr: true # Disables conversation continuity
+  prompt: "You are a privacy-focused assistant that handles sensitive data"
 ```
 
 ### MCP Server Types

data/lib/claude_swarm/claude_mcp_server.rb

@@ -36,6 +36,7 @@ module ClaudeSwarm
           openai_token_env: instance_config[:openai_token_env],
           base_url: instance_config[:base_url],
           reasoning_effort: instance_config[:reasoning_effort],
+          zdr: instance_config[:zdr],
         )
       else
         # Default Claude behavior - always use SDK

data/lib/claude_swarm/cli.rb

@@ -172,6 +172,10 @@ module ClaudeSwarm
     method_option :reasoning_effort,
       type: :string,
       desc: "Reasoning effort for OpenAI models"
+    method_option :zdr,
+      type: :boolean,
+      default: false,
+      desc: "Enable ZDR for OpenAI models"
     def mcp_serve
       # Validate reasoning_effort if provided
       if options[:reasoning_effort]
@@ -181,14 +185,6 @@ module ClaudeSwarm
           exit(1)
         end
 
-        # Validate it's used with an o-series model
-        model = options[:model]
-        unless model&.match?(ClaudeSwarm::Configuration::O_SERIES_MODEL_PATTERN)
-          error("reasoning_effort is only supported for o-series models (o1, o1 Preview, o1-mini, o1-pro, o3, o3-mini, o3-pro, o3-deep-research, o4-mini, o4-mini-deep-research, etc.)")
-          error("Current model: #{model}")
-          exit(1)
-        end
-
         # Validate the value
         unless ClaudeSwarm::Configuration::VALID_REASONING_EFFORTS.include?(options[:reasoning_effort])
           error("reasoning_effort must be 'low', 'medium', or 'high'")
@@ -196,16 +192,6 @@ module ClaudeSwarm
         end
       end
 
-      # Validate temperature is not used with o-series models
-      if options[:temperature] && options[:provider] == "openai"
-        model = options[:model]
-        if model&.match?(ClaudeSwarm::Configuration::O_SERIES_MODEL_PATTERN)
-          error("temperature parameter is not supported for o-series models (#{model})")
-          error("O-series models use deterministic reasoning and don't accept temperature settings")
-          exit(1)
-        end
-      end
-
       instance_config = {
         name: options[:name],
         directory: options[:directory],
@@ -226,6 +212,7 @@ module ClaudeSwarm
         openai_token_env: options[:openai_token_env],
         base_url: options[:base_url],
         reasoning_effort: options[:reasoning_effort],
+        zdr: options[:zdr],
       }
 
       begin

data/lib/claude_swarm/configuration.rb

@@ -4,15 +4,13 @@ module ClaudeSwarm
   class Configuration
     # Frozen constants for validation
     VALID_PROVIDERS = ["claude", "openai"].freeze
-    OPENAI_SPECIFIC_FIELDS = ["temperature", "api_version", "openai_token_env", "base_url", "reasoning_effort"].freeze
+    OPENAI_SPECIFIC_FIELDS = ["temperature", "api_version", "openai_token_env", "base_url", "reasoning_effort", "zdr"].freeze
     VALID_API_VERSIONS = ["chat_completion", "responses"].freeze
     VALID_REASONING_EFFORTS = ["low", "medium", "high"].freeze
 
     # Regex patterns
     ENV_VAR_PATTERN = /\$\{([^}]+)\}/
     ENV_VAR_WITH_DEFAULT_PATTERN = /\$\{([^:}]+)(:=([^}]*))?\}/
-    O_SERIES_MODEL_PATTERN = /^(o\d+(\s+(Preview|preview))?(-pro|-mini|-deep-research|-mini-deep-research)?|gpt-5(-mini|-nano)?)$/
-
     attr_reader :config, :config_path, :swarm, :swarm_name, :main_instance, :instances, :base_dir
 
     def initialize(config_path, base_dir: nil, options: {})
@@ -165,7 +163,6 @@ module ClaudeSwarm
 
       # Parse provider (optional, defaults to claude)
       provider = config["provider"]
-      model = config["model"]
 
       # Validate provider value if specified
       if provider && !VALID_PROVIDERS.include?(provider)
@@ -183,17 +180,6 @@ module ClaudeSwarm
         unless VALID_REASONING_EFFORTS.include?(config["reasoning_effort"])
           raise Error, "Instance '#{name}' has invalid reasoning_effort '#{config["reasoning_effort"]}'. Must be 'low', 'medium', or 'high'"
         end
-
-        # Validate it's only used with o-series or gpt-5 models
-        # Support patterns like: o1, o1-mini, o1-pro, o1 Preview, o3-deep-research, o4-mini-deep-research, gpt-5, gpt-5-mini, gpt-5-nano, etc.
-        unless model&.match?(O_SERIES_MODEL_PATTERN)
-          raise Error, "Instance '#{name}' has reasoning_effort but model '#{model}' is not an o-series or gpt-5 model (o1, o1 Preview, o1-mini, o1-pro, o3, o3-mini, o3-pro, o3-deep-research, o4-mini, o4-mini-deep-research, gpt-5, gpt-5-mini, gpt-5-nano, etc.)"
-        end
-      end
-
-      # Validate temperature is not used with o-series or gpt-5 models when provider is openai
-      if provider == "openai" && config["temperature"] && model&.match?(O_SERIES_MODEL_PATTERN)
-        raise Error, "Instance '#{name}' has temperature parameter but model '#{model}' is an o-series or gpt-5 model. O-series and gpt-5 models use deterministic reasoning and don't accept temperature settings"
       end
 
       # Validate OpenAI-specific fields only when provider is not "openai"
@@ -246,6 +232,7 @@ module ClaudeSwarm
         instance_config[:openai_token_env] = config["openai_token_env"] || "OPENAI_API_KEY"
         instance_config[:base_url] = config["base_url"]
         instance_config[:reasoning_effort] = config["reasoning_effort"] if config["reasoning_effort"]
+        instance_config[:zdr] = config["zdr"] if config.key?("zdr")
         # Default vibe to true for OpenAI instances if not specified
         instance_config[:vibe] = true if config["vibe"].nil?
       elsif config["vibe"].nil?

data/lib/claude_swarm/mcp_generator.rb

@@ -174,6 +174,7 @@ module ClaudeSwarm
           args.push("--api-version", instance[:api_version]) if instance[:api_version]
           args.push("--openai-token-env", instance[:openai_token_env]) if instance[:openai_token_env]
           args.push("--base-url", instance[:base_url]) if instance[:base_url]
+          args.push("--zdr", instance[:zdr].to_s) if instance.key?(:zdr)
         end
       end
 

data/lib/claude_swarm/openai/chat_completion.rb

@@ -5,7 +5,7 @@ module ClaudeSwarm
     class ChatCompletion
       MAX_TURNS_WITH_TOOLS = 100_000 # virtually infinite
 
-      def initialize(openai_client:, mcp_client:, available_tools:, executor:, instance_name:, model:, temperature: nil, reasoning_effort: nil)
+      def initialize(openai_client:, mcp_client:, available_tools:, executor:, instance_name:, model:, temperature: nil, reasoning_effort: nil, zdr: false)
         @openai_client = openai_client
         @mcp_client = mcp_client
         @available_tools = available_tools
@@ -14,6 +14,7 @@ module ClaudeSwarm
         @model = model
         @temperature = temperature
         @reasoning_effort = reasoning_effort
+        @zdr = zdr # Not used in chat_completion API, but kept for compatibility
         @conversation_messages = []
       end
 
@@ -67,17 +68,8 @@ module ClaudeSwarm
           messages: messages,
         }
 
-        # Only add temperature for non-o-series models
-        # O-series models don't support temperature parameter
-        if @temperature && !@model.match?(ClaudeSwarm::Configuration::O_SERIES_MODEL_PATTERN)
-          parameters[:temperature] = @temperature
-        end
-
-        # Only add reasoning_effort for o-series models
-        # reasoning_effort is only supported by o-series models: o1, o1 Preview, o1-mini, o1-pro, o3, o3-mini, o3-pro, o3-deep-research, o4-mini, o4-mini-deep-research, etc.
-        if @reasoning_effort && @model.match?(ClaudeSwarm::Configuration::O_SERIES_MODEL_PATTERN)
-          parameters[:reasoning_effort] = @reasoning_effort
-        end
+        parameters[:temperature] = @temperature if @temperature
+        parameters[:reasoning_effort] = @reasoning_effort if @reasoning_effort
 
         # Add tools if available
         parameters[:tools] = @mcp_client.to_openai_tools if @available_tools&.any? && @mcp_client

data/lib/claude_swarm/openai/executor.rb

@@ -31,7 +31,7 @@ module ClaudeSwarm
         instance_name: nil, instance_id: nil, calling_instance: nil, calling_instance_id: nil,
         claude_session_id: nil, additional_directories: [], debug: false,
         temperature: nil, api_version: "chat_completion", openai_token_env: "OPENAI_API_KEY",
-        base_url: nil, reasoning_effort: nil)
+        base_url: nil, reasoning_effort: nil, zdr: false)
         # Call parent initializer for common attributes
         super(
           working_directory: working_directory,
@@ -52,6 +52,7 @@ module ClaudeSwarm
         @api_version = api_version
         @base_url = base_url
         @reasoning_effort = reasoning_effort
+        @zdr = zdr
 
         # Conversation state for maintaining context
         @conversation_messages = []
@@ -162,6 +163,7 @@ module ClaudeSwarm
           model: @model,
           temperature: @temperature,
           reasoning_effort: @reasoning_effort,
+          zdr: @zdr,
         }
 
         if @api_version == "responses"

data/lib/claude_swarm/openai/responses.rb

@@ -5,7 +5,7 @@ module ClaudeSwarm
     class Responses
       MAX_TURNS_WITH_TOOLS = 100_000 # virtually infinite
 
-      def initialize(openai_client:, mcp_client:, available_tools:, executor:, instance_name:, model:, temperature: nil, reasoning_effort: nil)
+      def initialize(openai_client:, mcp_client:, available_tools:, executor:, instance_name:, model:, temperature: nil, reasoning_effort: nil, zdr: false)
         @openai_client = openai_client
         @mcp_client = mcp_client
         @available_tools = available_tools
@@ -14,6 +14,7 @@ module ClaudeSwarm
         @model = model
         @temperature = temperature
         @reasoning_effort = reasoning_effort
+        @zdr = zdr
         @system_prompt = nil
       end
 
@@ -46,17 +47,8 @@ module ClaudeSwarm
           model: @model,
         }
 
-        # Only add temperature for non-o-series models
-        # O-series models don't support temperature parameter
-        unless @model.match?(ClaudeSwarm::Configuration::O_SERIES_MODEL_PATTERN)
-          parameters[:temperature] = @temperature
-        end
-
-        # Only add reasoning effort for o-series models
-        # reasoning is only supported by o-series models: o1, o1 Preview, o1-mini, o1-pro, o3, o3-mini, o3-pro, o3-deep-research, o4-mini, o4-mini-deep-research, etc.
-        if @reasoning_effort && @model.match?(ClaudeSwarm::Configuration::O_SERIES_MODEL_PATTERN)
-          parameters[:reasoning] = { effort: @reasoning_effort }
-        end
+        parameters[:temperature] = @temperature if @temperature
+        parameters[:reasoning] = { effort: @reasoning_effort } if @reasoning_effort
 
         # On first call, use string input (can include system prompt)
         # On subsequent calls with function results, use array input
@@ -67,6 +59,7 @@ module ClaudeSwarm
           else
             input
           end
+          conversation_array << { role: "user", content: parameters[:input] }
         else
           # Follow-up call with conversation array (function calls + outputs)
           parameters[:input] = conversation_array
@@ -79,8 +72,8 @@ module ClaudeSwarm
           @executor.logger.info { "Conversation item IDs: #{conversation_ids.inspect}" }
         end
 
-        # Add previous response ID for conversation continuity
-        parameters[:previous_response_id] = previous_response_id if previous_response_id
+        # Add previous response ID for conversation continuity (unless zdr is enabled)
+        parameters[:previous_response_id] = @zdr ? nil : previous_response_id
 
         # Add tools if available
         if @available_tools&.any?
@@ -115,7 +108,7 @@ module ClaudeSwarm
           @executor.logger.error { "Request parameters: #{JsonHandler.pretty_generate!(parameters)}" }
 
           # Try to extract and log the response body for better debugging
-          if e.respond_to?(:response)
+          if e.respond_to?(:response) && e.response
             begin
               error_body = e.response[:body]
               @executor.logger.error { "Error response body: #{error_body}" }
@@ -131,7 +124,7 @@ module ClaudeSwarm
             error: {
               class: e.class.to_s,
               message: e.message,
-              response_body: e.respond_to?(:response) ? e.response[:body] : nil,
+              response_body: e.respond_to?(:response) && e.response ? e.response[:body] : nil,
               backtrace: e.backtrace.first(5),
             },
           })
@@ -155,33 +148,21 @@ module ClaudeSwarm
 
         # Handle response based on output structure
         output = response["output"]
-
         if output.nil?
           @executor.logger.error { "No output in response" }
           return "Error: No output in OpenAI response"
         end
 
         # Check if output is an array (as per documentation)
-        if output.is_a?(Array) && !output.empty?
+        if output.is_a?(Array) && output.any?
+          new_conversation = conversation_array.dup
+          new_conversation.concat(output)
           # Check if there are function calls
           function_calls = output.select { |item| item["type"] == "function_call" }
-
           if function_calls.any?
-            # Check if we already have a conversation going
-            if conversation_array.empty?
-              # First depth - build new conversation
-              new_conversation = build_conversation_with_outputs(function_calls)
-            else
-              # Subsequent depth - append to existing conversation
-              # Don't re-add function calls, just add the new ones and their outputs
-              new_conversation = conversation_array.dup
-              append_new_outputs(function_calls, new_conversation)
-            end
-
-            # Recursively process with updated conversation
+            append_new_outputs(function_calls, new_conversation)
             process_responses_api(nil, new_conversation, response_id, depth + 1)
           else
-            # Look for text response
             extract_text_response(output)
           end
         else

data/lib/claude_swarm/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: claude_swarm
 version: !ruby/object:Gem::Version
-  version: 1.0.7
+  version: 1.0.9
 platform: ruby
 authors:
 - Paulo Arruda