ruby_llm-responses_api 0.5.0 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5eafd14a08ce95dc9637f022c3dcd0b88dc979314efd534ec3a3d5dbb2a6e396
-  data.tar.gz: 6b84beeec2204e791727bb969aac9b9e490e574204c78ab87ec6b69692f1ad7d
+  metadata.gz: '059b94ffc46c9a9505bec39f3c7e11dd55406304b159c9b3e95d37202a085c31'
+  data.tar.gz: 9371bcaa6539cd987d7688a3901ae855f090576f07f7e00ba0d8613157224e19
 SHA512:
-  metadata.gz: 5216a047aa783ed7b221e91f0173fd5785ae003b3006a9dcbcdb07effef569e73cac28fab1129f9e157e15f03a5219d18fdcfcc84c17406f3913fe8cdc1ed761
-  data.tar.gz: 3aa365e82445b4deb9f3b2dcda4ec47f096728f05c3f7a89eb9076be41ba81e873e2f513b4057391b84d6f1e1b8fd630ade743a46b0c2a37f9c2187eb43efbd6
+  metadata.gz: 1cfbb8c9fe68c29e7d32a07cd6f039dedb62eba362d9238ad877e5b10801b313ee8b821971d863dcf18d5d5affd1378e53c1bcbf77887811b41ef2daba834cc4
+  data.tar.gz: 62b356bac7017a796033d7ffd8a7e2ca35650898bbf56a59c18fc6530f00787f57b944932b67a5a5dcedc71922b9056f05057118f50ca6aceeea143eb740b9af

data/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.1] - 2026-03-03
+
+### Added
+
+- `tool_choice` support (`auto`, `required`, `none`, or specific function name)
+- `parallel_tool_calls` support (`:many` / `:one`) via RubyLLM's `tool_prefs`
+
+### Fixed
+
+- Compatibility with RubyLLM v1.13.0 (`tool_prefs:` parameter in `complete` and `render_payload`)
+- Handle new pre-normalized schema format from `Chat.with_schema`
+
 ## [0.5.0] - 2026-02-25
 
 ### Added

data/lib/ruby_llm/providers/openai_responses/chat.rb

@@ -12,10 +12,11 @@ module RubyLLM
 
         module_function
 
-        def render_payload(messages, tools:, temperature:, model:, stream: false, schema: nil, thinking: nil) # rubocop:disable Metrics/ParameterLists,Lint/UnusedMethodArgument
-          # Extract system messages for instructions
-          system_messages = messages.select { |m| m.role == :system }
-          non_system_messages = messages.reject { |m| m.role == :system }
+        # rubocop:disable Metrics/ParameterLists
+        def render_payload(messages, tools:, temperature:, model:, stream: false,
+                           schema: nil, thinking: nil, tool_prefs: nil) # rubocop:disable Lint/UnusedMethodArgument
+          tool_prefs ||= {}
+          system_messages, non_system_messages = messages.partition { |m| m.role == :system }
 
           instructions = system_messages.map { |m| extract_text_content(m.content) }.join("\n\n")
 
@@ -27,27 +28,54 @@ module RubyLLM
 
           payload[:instructions] = instructions unless instructions.empty?
           payload[:temperature] = temperature unless temperature.nil?
+          apply_tools(payload, tools, tool_prefs)
+          payload[:text] = build_schema_format(schema) if schema
 
-          payload[:tools] = tools.map { |_, tool| tool_for(tool) } if tools.any?
-
-          if schema
-            payload[:text] = {
-              format: {
-                type: 'json_schema',
-                name: 'response',
-                schema: schema,
-                strict: schema[:strict] != false
-              }
-            }
-          end
-
-          # Auto-chain conversations: find the last response_id from assistant messages
-          # This enables automatic stateful conversations without manual tracking
           last_response_id = extract_last_response_id(messages)
           payload[:previous_response_id] = last_response_id if last_response_id
 
           payload
         end
+        # rubocop:enable Metrics/ParameterLists
+
+        # Apply tools and tool preferences to the payload.
+        def apply_tools(payload, tools, tool_prefs)
+          return unless tools.any?
+
+          payload[:tools] = tools.map { |_, tool| Tools.tool_for(tool) }
+          payload[:tool_choice] = build_tool_choice(tool_prefs[:choice]) unless tool_prefs[:choice].nil?
+          payload[:parallel_tool_calls] = tool_prefs[:calls] == :many unless tool_prefs[:calls].nil?
+        end
+
+        # Convert a RubyLLM tool choice symbol to the Responses API format.
+        # Responses API accepts "auto", "required", "none", or
+        # { type: "function", name: "fn_name" } for a specific function.
+        def build_tool_choice(choice)
+          case choice
+          when :auto, :none, :required
+            choice.to_s
+          else
+            { type: 'function', name: choice.to_s }
+          end
+        end
+
+        # Build the Responses API text format block from a schema.
+        # Schema arrives pre-normalized as { name:, schema:, strict: } from
+        # RubyLLM::Chat.with_schema (v1.13+), or as a raw hash (legacy).
+        def build_schema_format(schema)
+          schema_name = schema[:name] || 'response'
+          schema_def = schema[:schema] || schema
+          strict = schema.key?(:strict) ? schema[:strict] : true
+
+          {
+            format: {
+              type: 'json_schema',
+              name: schema_name,
+              schema: schema_def,
+              strict: strict
+            }
+          }
+        end
 
         def extract_last_response_id(messages)
           messages

data/lib/ruby_llm/providers/openai_responses.rb

@@ -17,7 +17,9 @@ module RubyLLM
       end
 
       # Override to support WebSocket transport via with_params(transport: :websocket)
-      def complete(messages, tools:, temperature:, model:, params: {}, headers: {}, schema: nil, thinking: nil, &block) # rubocop:disable Metrics/ParameterLists
+      # rubocop:disable Metrics/ParameterLists
+      def complete(messages, tools:, temperature:, model:, params: {}, headers: {},
+                   schema: nil, thinking: nil, tool_prefs: nil, &block)
         if params[:transport]&.to_sym == :websocket
           ws_complete(messages, tools: tools, temperature: temperature, model: model,
                                 params: params.except(:transport), schema: schema,
@@ -26,6 +28,7 @@ module RubyLLM
           super
         end
       end
+      # rubocop:enable Metrics/ParameterLists
 
       def headers
         {

data/lib/rubyllm_responses_api.rb

@@ -39,7 +39,7 @@ RubyLLM::Providers::OpenAIResponses::ModelRegistry.register_all!
 module RubyLLM
   # ResponsesAPI namespace for direct access to helpers and version
   module ResponsesAPI
-    VERSION = '0.5.0'
+    VERSION = '0.5.1'
 
     # Shorthand access to built-in tool helpers
     BuiltInTools = Providers::OpenAIResponses::BuiltInTools

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_llm-responses_api
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.5.1
 platform: ruby
 authors:
 - Chris Hasinski