swarm_sdk 2.7.11 → 2.7.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bcabd24d5d88debcf61b86803b61996a60a8d56dac5ca56c1952478df8725079
-  data.tar.gz: 1c661fd7c839822ce4cddcfbb499ed8700b3311b45d6f791e94e3b4fb9965dd3
+  metadata.gz: 700ee5f9b81c58e030024d664a7c3e27db84c705c876493678c89371f803158a
+  data.tar.gz: b2a4e2d7dc72208bff64b9c8d5f72dbe9d2772ae5f2f61d8abf3973d5855867c
 SHA512:
-  metadata.gz: eec76f06fd85bbfe4bfc124473760ef9a3a84dd69aae3abb3de018b18b817882b5b1d23e1708cd9dce7f04abff433bec60eb436d7e5939a8925ef84f44a88005
-  data.tar.gz: 5b71b6839d87d0010525a5dcf708424a8a585ed59472a384af0d13b5e2992e760f9ee15e9707c63ce0023e3aef3e19c373e333fa1d6dfd3bcb87dc59b9dd76c3
+  metadata.gz: 7e375f31f8419422c3b93065f0fa525d63ae063865b2dd62032ac42ff4e9f827111f5cf1dc13cc18e27e215e9e1a0924965791155f553d5af9261f53580680e4
+  data.tar.gz: f44a0e73852254048fe7219efed8db620bc41f4d274bfd938997ac5281a79c6cfa575e3be7631e404bbd84acfc3dd25649130a06fa10b85d4cac6a0099007d11

data/lib/swarm_sdk/agent/builder.rb

@@ -62,6 +62,7 @@ module SwarmSDK
         @memory_config = nil
         @shared_across_delegations = nil # nil = not set (will default to false in Definition)
         @streaming = nil # nil = not set (will use global config default)
+        @thinking = nil # nil = not set (extended thinking disabled)
         @context_management_config = nil # Context management DSL hooks
       end
 
@@ -372,6 +373,38 @@ module SwarmSDK
         !@streaming.nil?
       end
 
+      # Configure extended thinking for this agent
+      #
+      # Extended thinking allows models to reason through complex problems before responding.
+      # For Anthropic models, specify a budget (token count). For OpenAI models, specify effort.
+      # Both can be specified for cross-provider compatibility.
+      #
+      # @param effort [Symbol, String, nil] Reasoning effort level (:low, :medium, :high) — used by OpenAI
+      # @param budget [Integer, nil] Token budget for thinking — used by Anthropic
+      # @return [self] Returns self for method chaining
+      #
+      # @example Anthropic thinking with budget
+      #   thinking budget: 10_000
+      #
+      # @example OpenAI reasoning effort
+      #   thinking effort: :high
+      #
+      # @example Cross-provider (both)
+      #   thinking effort: :high, budget: 10_000
+      def thinking(effort: nil, budget: nil)
+        raise ArgumentError, "thinking requires :effort or :budget" if effort.nil? && budget.nil?
+
+        @thinking = { effort: effort, budget: budget }.compact
+        self
+      end
+
+      # Check if thinking has been explicitly set
+      #
+      # @return [Boolean] true if thinking was explicitly configured
+      def thinking_set?
+        !@thinking.nil?
+      end
+
       # Configure context management handlers
       #
       # Define custom handlers for context warning thresholds (60%, 80%, 90%).
@@ -552,6 +585,7 @@ module SwarmSDK
         agent_config[:memory] = @memory_config if @memory_config
         agent_config[:shared_across_delegations] = @shared_across_delegations unless @shared_across_delegations.nil?
         agent_config[:streaming] = @streaming unless @streaming.nil?
+        agent_config[:thinking] = @thinking if @thinking
 
         # Convert DSL hooks to HookDefinition format
         agent_config[:hooks] = convert_hooks_to_definitions if @hooks.any?

data/lib/swarm_sdk/agent/chat.rb

@@ -189,10 +189,11 @@ module SwarmSDK
         # Try to fetch real model info for accurate context tracking
         fetch_real_model_info(model_id)
 
-        # Configure system prompt, parameters, and headers
+        # Configure system prompt, parameters, headers, and thinking
         configure_system_prompt(system_prompt) if system_prompt
         configure_parameters(parameters)
         configure_headers(custom_headers)
+        configure_thinking(definition[:thinking])
 
         # Setup around_tool_execution hook for SwarmSDK orchestration
         setup_tool_execution_hook
@@ -986,6 +987,12 @@ module SwarmSDK
             emit_non_retryable_error(e, "UnknownAPIError")
             return build_error_message(e)
 
+          # === CATEGORY A (CONTINUED): PROGRAMMING ERRORS ===
+          rescue ArgumentError, TypeError, NameError => e
+            # Programming errors (wrong keywords, type mismatches) - won't fix by retrying
+            emit_non_retryable_error(e, e.class.name)
+            return build_error_message(e)
+
           # === CATEGORY C: NETWORK/OTHER ERRORS ===
           rescue StandardError => e
             # Network errors, timeouts, unknown errors - retry with delays

data/lib/swarm_sdk/agent/chat_helpers/llm_configuration.rb

@@ -224,6 +224,22 @@ module SwarmSDK
           RubyLLM.logger.debug("SwarmSDK: Enabled native Responses API support")
         end
 
+        # Configure extended thinking on the RubyLLM chat instance
+        #
+        # @param thinking_config [Hash, nil] Thinking configuration with :effort and/or :budget
+        # @return [self]
+        #
+        # @example
+        #   configure_thinking(budget: 10_000)
+        #   configure_thinking(effort: :high)
+        #   configure_thinking(effort: :high, budget: 10_000)
+        def configure_thinking(thinking_config)
+          return self unless thinking_config
+
+          @llm_chat.with_thinking(**thinking_config)
+          self
+        end
+
         # Configure LLM parameters with proper temperature normalization
         #
         # @param params [Hash] Parameter hash

data/lib/swarm_sdk/agent/definition.rb

@@ -42,7 +42,8 @@ module SwarmSDK
         :hooks,
         :plugin_configs,
         :shared_across_delegations,
-        :streaming
+        :streaming,
+        :thinking
 
       attr_accessor :bypass_permissions, :max_concurrent_tools
 
@@ -114,6 +115,9 @@ module SwarmSDK
         # Streaming configuration (default: true from global config)
         @streaming = config.fetch(:streaming, SwarmSDK.config.streaming)
 
+        # Extended thinking configuration (nil = disabled)
+        @thinking = config[:thinking]
+
         # Build system prompt after directory and memory are set
         @system_prompt = build_full_system_prompt(config[:system_prompt])
 

data/lib/swarm_sdk/builders/base_builder.rb

@@ -450,6 +450,10 @@ module SwarmSDK
         if !all_agents_hash[:streaming].nil? && !agent_builder.streaming_set?
           agent_builder.streaming(all_agents_hash[:streaming])
         end
+
+        if all_agents_hash[:thinking] && !agent_builder.thinking_set?
+          agent_builder.thinking(**all_agents_hash[:thinking])
+        end
       end
 
       # Validate all_agents filesystem tools

data/lib/swarm_sdk/configuration/translator.rb

@@ -100,6 +100,7 @@ module SwarmSDK
           coding_agent(all_agents_cfg[:coding_agent]) unless all_agents_cfg[:coding_agent].nil?
           disable_default_tools(all_agents_cfg[:disable_default_tools]) unless all_agents_cfg[:disable_default_tools].nil?
           streaming(all_agents_cfg[:streaming]) unless all_agents_cfg[:streaming].nil?
+          thinking(**all_agents_cfg[:thinking]) if all_agents_cfg[:thinking]
 
           if all_agents_hks.any?
             all_agents_hks.each do |event, hook_specs|
@@ -164,6 +165,7 @@ module SwarmSDK
           disable_default_tools(config[:disable_default_tools]) unless config[:disable_default_tools].nil?
           shared_across_delegations(config[:shared_across_delegations]) unless config[:shared_across_delegations].nil?
           streaming(config[:streaming]) unless config[:streaming].nil?
+          thinking(**config[:thinking]) if config[:thinking]
 
           if config[:tools]&.any?
             tool_names = config[:tools].map { |t| t.is_a?(Hash) ? t[:name] : t }

data/lib/swarm_sdk/ruby_llm_patches/chat_callbacks_patch.rb

@@ -207,17 +207,19 @@ module RubyLLM
 
       # Perform the actual LLM request
       def perform_llm_request(messages_to_send, &block)
-        @provider.complete(
-          messages_to_send,
+        kwargs = {
           tools: @tools,
           temperature: @temperature,
           model: @model,
           params: @params,
           headers: @headers,
           schema: @schema,
-          thinking: @thinking,
-          &wrap_streaming_block(&block)
-        )
+        }
+        # Only pass thinking when explicitly configured via with_thinking
+        # to maintain compatibility with providers that don't support this keyword
+        kwargs[:thinking] = @thinking if @thinking
+
+        @provider.complete(messages_to_send, **kwargs, &wrap_streaming_block(&block))
       rescue ArgumentError => e
         raise ArgumentError,
           "#{e.message} — provider #{@provider.class.name} does not support this parameter " \

data/lib/swarm_sdk/swarm/all_agents_builder.rb

@@ -36,6 +36,7 @@ module SwarmSDK
         @coding_agent = nil
         @disable_default_tools = nil
         @streaming = nil
+        @thinking = nil
       end
 
       # Set model for all agents
@@ -99,6 +100,16 @@ module SwarmSDK
         @streaming = value
       end
 
+      # Configure extended thinking for all agents
+      #
+      # @param effort [Symbol, String, nil] Reasoning effort (:low, :medium, :high) — OpenAI
+      # @param budget [Integer, nil] Token budget for thinking — Anthropic
+      def thinking(effort: nil, budget: nil)
+        raise ArgumentError, "thinking requires :effort or :budget" if effort.nil? && budget.nil?
+
+        @thinking = { effort: effort, budget: budget }.compact
+      end
+
       # Add tools that all agents will have
       def tools(*tool_names)
         @tools_list.concat(tool_names)
@@ -174,6 +185,7 @@ module SwarmSDK
           coding_agent: @coding_agent,
           disable_default_tools: @disable_default_tools,
           streaming: @streaming,
+          thinking: @thinking,
           tools: @tools_list,
           permissions: @permissions_config,
         }.compact

data/lib/swarm_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SwarmSDK
-  VERSION = "2.7.11"
+  VERSION = "2.7.12"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: swarm_sdk
 version: !ruby/object:Gem::Version
-  version: 2.7.11
+  version: 2.7.12
 platform: ruby
 authors:
 - Paulo Arruda