swarm_sdk 2.2.0 → 2.4.0

data/lib/swarm_sdk.rb

@@ -17,6 +17,27 @@ require "async/semaphore"
 require "ruby_llm"
 require "ruby_llm/mcp"
 
+# Patch ruby_llm-mcp's Zeitwerk loader to ignore railtie.rb when Rails is not present
+# This prevents NameError when eager loading outside of Rails applications
+# Can be removed once https://github.com/parruda/ruby_llm-mcp/issues/XXX is fixed
+unless defined?(Rails)
+  require "zeitwerk"
+  mcp_loader = nil
+  Zeitwerk::Registry.loaders.each { |l| mcp_loader = l if l.tag == "RubyLLM-mcp" }
+  if mcp_loader
+    mcp_gem_dir = Gem.loaded_specs["ruby_llm-mcp"]&.gem_dir
+    if mcp_gem_dir
+      railtie_path = File.join(mcp_gem_dir, "lib", "ruby_llm", "mcp", "railtie.rb")
+      mcp_loader.ignore(railtie_path)
+    end
+  end
+end
+
+# Configure Faraday to use async-http adapter by default
+# This ensures HTTP requests are fiber-aware and don't block the Async scheduler
+# when SwarmSDK executes LLM requests within Async/Sync blocks
+require "async/http/faraday/default"
+
 require_relative "swarm_sdk/version"
 
 require "zeitwerk"
@@ -42,14 +63,52 @@ module SwarmSDK
   class StateError < Error; end
 
   class << self
-    # Settings for SwarmSDK (global configuration)
-    attr_accessor :settings
+    # Get the global configuration instance
+    #
+    # @return [Config] The singleton Config instance
+    def config
+      Config.instance
+    end
+
+    # Configure SwarmSDK global settings
+    #
+    # @yield [Config] The configuration instance
+    # @return [Config] The configuration instance
+    #
+    # @example
+    #   SwarmSDK.configure do |config|
+    #     config.openai_api_key = "sk-..."
+    #     config.default_model = "claude-sonnet-4"
+    #   end
+    def configure
+      yield(config) if block_given?
+      config
+    end
 
-    # Main entry point for DSL
+    # Reset configuration to defaults
+    #
+    # Clears all configuration including explicit values and cached ENV values.
+    # Use in tests to ensure clean state.
+    #
+    # @return [void]
+    def reset_config!
+      Config.reset!
+    end
+
+    # Main entry point for DSL - builds simple multi-agent swarms
+    #
+    # @return [Swarm] Always returns a Swarm instance
     def build(allow_filesystem_tools: nil, &block)
       Swarm::Builder.build(allow_filesystem_tools: allow_filesystem_tools, &block)
     end
 
+    # Entry point for building multi-stage workflows
+    #
+    # @return [Workflow] Always returns a Workflow instance
+    def workflow(allow_filesystem_tools: nil, &block)
+      Workflow::Builder.build(allow_filesystem_tools: allow_filesystem_tools, &block)
+    end
+
     # Validate YAML configuration without creating a swarm
     #
     # Performs comprehensive validation of YAML configuration including:
@@ -149,7 +208,7 @@ module SwarmSDK
     #
     # @param yaml_content [String] YAML configuration content
     # @param base_dir [String, Pathname] Base directory for resolving agent file paths (default: Dir.pwd)
-    # @return [Swarm, NodeOrchestrator] Configured swarm or orchestrator instance
+    # @return [Swarm, Workflow] Configured swarm or workflow instance
     # @raise [ConfigurationError] If YAML is invalid or configuration is incorrect
     #
     # @example Load from YAML string
@@ -194,7 +253,7 @@ module SwarmSDK
     # loading swarms from configuration files.
     #
     # @param path [String, Pathname] Path to YAML configuration file
-    # @return [Swarm, NodeOrchestrator] Configured swarm or orchestrator instance
+    # @return [Swarm, Workflow] Configured swarm or workflow instance
     # @raise [ConfigurationError] If file not found or configuration invalid
     #
     # @example
@@ -218,21 +277,6 @@ module SwarmSDK
       swarm
     end
 
-    # Configure SwarmSDK global settings
-    def configure
-      self.settings ||= Settings.new
-      yield(settings)
-    end
-
-    # Reset settings to defaults
-    def reset_settings!
-      self.settings = Settings.new
-    end
-
-    # Alias for backward compatibility
-    alias_method :configuration, :settings
-    alias_method :reset_configuration!, :reset_settings!
-
     private
 
     # Check if hooks are configured in the configuration
@@ -407,88 +451,4 @@ module SwarmSDK
       error_hash.compact
     end
   end
-
-  # Settings class for SwarmSDK global settings (not to be confused with Configuration for YAML loading)
-  class Settings
-    # WebFetch tool LLM processing configuration
-    attr_accessor :webfetch_provider, :webfetch_model, :webfetch_base_url, :webfetch_max_tokens
-
-    # Filesystem tools control
-    attr_accessor :allow_filesystem_tools
-
-    def initialize
-      @webfetch_provider = nil
-      @webfetch_model = nil
-      @webfetch_base_url = nil
-      @webfetch_max_tokens = 4096
-      @allow_filesystem_tools = parse_env_bool("SWARM_SDK_ALLOW_FILESYSTEM_TOOLS", default: true)
-    end
-
-    # Check if WebFetch LLM processing is enabled
-    def webfetch_llm_enabled?
-      !@webfetch_provider.nil? && !@webfetch_model.nil?
-    end
-
-    private
-
-    def parse_env_bool(key, default:)
-      return default unless ENV.key?(key)
-
-      value = ENV[key].to_s.downcase
-      return true if ["true", "yes", "1", "on", "enabled"].include?(value)
-      return false if ["false", "no", "0", "off", "disabled"].include?(value)
-
-      default
-    end
-  end
-
-  # Initialize default settings
-  self.settings = Settings.new
-end
-
-# Automatically configure RubyLLM from environment variables
-# This makes SwarmSDK "just work" when users set standard ENV variables
-RubyLLM.configure do |config|
-  # Only set if config not already set (||= handles nil ENV values gracefully)
-
-  # OpenAI
-  config.openai_api_key ||= ENV["OPENAI_API_KEY"]
-  config.openai_api_base ||= ENV["OPENAI_API_BASE"]
-  config.openai_organization_id ||= ENV["OPENAI_ORG_ID"]
-  config.openai_project_id ||= ENV["OPENAI_PROJECT_ID"]
-
-  # Anthropic
-  config.anthropic_api_key ||= ENV["ANTHROPIC_API_KEY"]
-
-  # Google Gemini
-  config.gemini_api_key ||= ENV["GEMINI_API_KEY"]
-
-  # Google Vertex AI (note: vertexai, not vertex_ai)
-  config.vertexai_project_id ||= ENV["GOOGLE_CLOUD_PROJECT"] || ENV["VERTEXAI_PROJECT_ID"]
-  config.vertexai_location ||= ENV["GOOGLE_CLOUD_LOCATION"] || ENV["VERTEXAI_LOCATION"]
-
-  # DeepSeek
-  config.deepseek_api_key ||= ENV["DEEPSEEK_API_KEY"]
-
-  # Mistral
-  config.mistral_api_key ||= ENV["MISTRAL_API_KEY"]
-
-  # Perplexity
-  config.perplexity_api_key ||= ENV["PERPLEXITY_API_KEY"]
-
-  # OpenRouter
-  config.openrouter_api_key ||= ENV["OPENROUTER_API_KEY"]
-
-  # AWS Bedrock
-  config.bedrock_api_key ||= ENV["AWS_ACCESS_KEY_ID"]
-  config.bedrock_secret_key ||= ENV["AWS_SECRET_ACCESS_KEY"]
-  config.bedrock_region ||= ENV["AWS_REGION"]
-  config.bedrock_session_token ||= ENV["AWS_SESSION_TOKEN"]
-
-  # Ollama (local)
-  config.ollama_api_base ||= ENV["OLLAMA_API_BASE"]
-
-  # GPUStack (local)
-  config.gpustack_api_base ||= ENV["GPUSTACK_API_BASE"]
-  config.gpustack_api_key ||= ENV["GPUSTACK_API_KEY"]
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: swarm_sdk
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 2.4.0
 platform: ruby
 authors:
 - Paulo Arruda
@@ -24,33 +24,61 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: ruby_llm
+  name: async-http-faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.9'
+        version: '0.22'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.9'
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: faraday-follow_redirects
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
 - !ruby/object:Gem::Dependency
   name: ruby_llm-mcp
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: ruby_llm_swarm
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.9.4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: 1.9.4
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
@@ -81,19 +109,36 @@ files:
 - lib/swarm_sdk/agent/RETRY_LOGIC.md
 - lib/swarm_sdk/agent/builder.rb
 - lib/swarm_sdk/agent/chat.rb
-- lib/swarm_sdk/agent/chat/context_tracker.rb
-- lib/swarm_sdk/agent/chat/hook_integration.rb
-- lib/swarm_sdk/agent/chat/logging_helpers.rb
-- lib/swarm_sdk/agent/chat/system_reminder_injector.rb
+- lib/swarm_sdk/agent/chat_helpers/context_tracker.rb
+- lib/swarm_sdk/agent/chat_helpers/event_emitter.rb
+- lib/swarm_sdk/agent/chat_helpers/hook_integration.rb
+- lib/swarm_sdk/agent/chat_helpers/instrumentation.rb
+- lib/swarm_sdk/agent/chat_helpers/llm_configuration.rb
+- lib/swarm_sdk/agent/chat_helpers/logging_helpers.rb
+- lib/swarm_sdk/agent/chat_helpers/serialization.rb
+- lib/swarm_sdk/agent/chat_helpers/system_reminder_injector.rb
+- lib/swarm_sdk/agent/chat_helpers/system_reminders.rb
+- lib/swarm_sdk/agent/chat_helpers/token_tracking.rb
 - lib/swarm_sdk/agent/context.rb
 - lib/swarm_sdk/agent/context_manager.rb
 - lib/swarm_sdk/agent/definition.rb
 - lib/swarm_sdk/agent/llm_instrumentation_middleware.rb
+- lib/swarm_sdk/agent/system_prompt_builder.rb
+- lib/swarm_sdk/builders/base_builder.rb
 - lib/swarm_sdk/claude_code_agent_adapter.rb
+- lib/swarm_sdk/concerns/cleanupable.rb
+- lib/swarm_sdk/concerns/snapshotable.rb
+- lib/swarm_sdk/concerns/validatable.rb
+- lib/swarm_sdk/config.rb
 - lib/swarm_sdk/configuration.rb
+- lib/swarm_sdk/configuration/parser.rb
+- lib/swarm_sdk/configuration/translator.rb
 - lib/swarm_sdk/context_compactor.rb
 - lib/swarm_sdk/context_compactor/metrics.rb
 - lib/swarm_sdk/context_compactor/token_counter.rb
+- lib/swarm_sdk/context_management/builder.rb
+- lib/swarm_sdk/context_management/context.rb
+- lib/swarm_sdk/defaults.rb
 - lib/swarm_sdk/events_to_messages.rb
 - lib/swarm_sdk/hooks/adapter.rb
 - lib/swarm_sdk/hooks/context.rb
@@ -111,11 +156,11 @@ files:
 - lib/swarm_sdk/model_aliases.json
 - lib/swarm_sdk/models.json
 - lib/swarm_sdk/models.rb
-- lib/swarm_sdk/node/agent_config.rb
-- lib/swarm_sdk/node/builder.rb
-- lib/swarm_sdk/node/transformer_executor.rb
 - lib/swarm_sdk/node_context.rb
-- lib/swarm_sdk/node_orchestrator.rb
+- lib/swarm_sdk/observer/builder.rb
+- lib/swarm_sdk/observer/config.rb
+- lib/swarm_sdk/observer/manager.rb
+- lib/swarm_sdk/patterns/agent_observer.rb
 - lib/swarm_sdk/permissions/config.rb
 - lib/swarm_sdk/permissions/error_formatter.rb
 - lib/swarm_sdk/permissions/path_matcher.rb
@@ -125,7 +170,6 @@ files:
 - lib/swarm_sdk/plugin_registry.rb
 - lib/swarm_sdk/proc_helpers.rb
 - lib/swarm_sdk/prompts/base_system_prompt.md.erb
-- lib/swarm_sdk/providers/openai_with_responses.rb
 - lib/swarm_sdk/restore_result.rb
 - lib/swarm_sdk/result.rb
 - lib/swarm_sdk/snapshot.rb
@@ -136,6 +180,9 @@ files:
 - lib/swarm_sdk/swarm/agent_initializer.rb
 - lib/swarm_sdk/swarm/all_agents_builder.rb
 - lib/swarm_sdk/swarm/builder.rb
+- lib/swarm_sdk/swarm/executor.rb
+- lib/swarm_sdk/swarm/hook_triggers.rb
+- lib/swarm_sdk/swarm/logging_callbacks.rb
 - lib/swarm_sdk/swarm/mcp_configurator.rb
 - lib/swarm_sdk/swarm/swarm_registry_builder.rb
 - lib/swarm_sdk/swarm/tool_configurator.rb
@@ -173,6 +220,12 @@ files:
 - lib/swarm_sdk/utils.rb
 - lib/swarm_sdk/validation_result.rb
 - lib/swarm_sdk/version.rb
+- lib/swarm_sdk/workflow.rb
+- lib/swarm_sdk/workflow/agent_config.rb
+- lib/swarm_sdk/workflow/builder.rb
+- lib/swarm_sdk/workflow/executor.rb
+- lib/swarm_sdk/workflow/node_builder.rb
+- lib/swarm_sdk/workflow/transformer_executor.rb
 homepage: https://github.com/parruda/claude-swarm
 licenses:
 - MIT