raix 0.4.4 → 0.4.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 50d0de4d7ec7fdd83776e539dbed2cc73ba3097c96752050eb768163dd5f510a
-  data.tar.gz: c82955632f789a0683e30553ecc8aef8b2f96aa4bc003e0b2e12953e6698adf9
+  metadata.gz: a2ae6f2ed473737e2d208868c2bdd458e12d391ebaae3d0930439267badc4d63
+  data.tar.gz: a93f7985ba809218e2fb7883ab31f0b0d246a769bbc7071fd6d60412bae5fd8d
 SHA512:
-  metadata.gz: 48977e0c2265105f22da2c1508a1aced37337ab1a914c7297bca4995cc94d6839708a51edb9f63222e4531bc0dccce305448ad70f78a858f30d7f581ae289114
-  data.tar.gz: c52f4078787b2570a6a11eb92e0a0f6172a09e083219d0b8562349fee4efc14012674e25591ef2839e41fd2675bfc834361bf1a64d3b74614854ce944b6cf8ab
+  metadata.gz: 3ae8374160c7ffe8f26db849a357b4c3403c58222cee941c90921e1961f1185d191111486b040b07af36c0a8aa54dd0721b11c6128cc2326c19be900a2a2154d
+  data.tar.gz: fa398a36ce224f3f8805f57b95378a5a7c589a45a4bf73f016ace860f7aa24be4680e168f4b51c6cc4dfedf3f80851073350a476779e1a7aeef0a2fd5e75283a

data/CHANGELOG.md

@@ -21,3 +21,13 @@
 
 ## [0.4.3] - 2024-11-11
 - adds support for `Predicate` module
+
+## [0.4.4] - 2024-11-11
+- adds support for multiple tool calls in a single response
+
+## [0.4.5] - 2024-11-11
+- adds support for `ResponseFormat`
+- added some missing requires to support String#squish
+
+## [0.4.6] - 2024-11-12
+- adds missing openai support for `Predicate`

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    raix (0.4.3)
+    raix (0.4.6)
       activesupport (>= 6.0)
       open_router (~> 0.2)
       ruby-openai (~> 7.0)

data/README.md

@@ -101,6 +101,30 @@ RSpec.describe WhatIsTheWeather do
 end
 ```
 
+#### Multiple Tool Calls
+
+Some AI models (like GPT-4) can make multiple tool calls in a single response. When this happens, Raix will automatically handle all the function calls sequentially and return an array of their results. Here's an example:
+
+```ruby
+class MultipleToolExample
+  include Raix::ChatCompletion
+  include Raix::FunctionDispatch
+
+  function :first_tool do |arguments|
+    "Result from first tool"
+  end
+
+  function :second_tool do |arguments|
+    "Result from second tool"
+  end
+end
+
+example = MultipleToolExample.new
+example.transcript << { user: "Please use both tools" }
+results = example.chat_completion(openai: "gpt-4o")
+# => ["Result from first tool", "Result from second tool"]
+```
+
 #### Manually Stopping a Loop
 
 To loop AI components that don't interact with end users, at least one function block should invoke `stop_looping!` whenever you're ready to stop processing.
@@ -309,6 +333,97 @@ question.ask("Any question")
 # => RuntimeError: Please define a yes and/or no block
 ```
 
+## Response Format (Experimental)
+
+The `ResponseFormat` class provides a way to declare a JSON schema for the response format of an AI chat completion. It's particularly useful when you need structured responses from AI models, ensuring the output conforms to your application's requirements.
+
+### Features
+
+- Converts Ruby hashes and arrays into JSON schema format
+- Supports nested structures and arrays
+- Enforces strict validation with `additionalProperties: false`
+- Automatically marks all top-level properties as required
+- Handles both simple type definitions and complex nested schemas
+
+### Basic Usage
+
+```ruby
+# Simple schema with basic types
+format = Raix::ResponseFormat.new("PersonInfo", {
+  name: { type: "string" },
+  age: { type: "integer" }
+})
+
+# Use in chat completion
+my_ai.chat_completion(response_format: format)
+```
+
+### Complex Structures
+
+```ruby
+# Nested structure with arrays
+format = Raix::ResponseFormat.new("CompanyInfo", {
+  company: {
+    name: { type: "string" },
+    employees: [
+      {
+        name: { type: "string" },
+        role: { type: "string" },
+        skills: ["string"]
+      }
+    ],
+    locations: ["string"]
+  }
+})
+```
+
+### Generated Schema
+
+The ResponseFormat class generates a schema that follows this structure:
+
+```json
+{
+  "type": "json_schema",
+  "json_schema": {
+    "name": "SchemaName",
+    "schema": {
+      "type": "object",
+      "properties": {
+        "property1": { "type": "string" },
+        "property2": { "type": "integer" }
+      },
+      "required": ["property1", "property2"],
+      "additionalProperties": false
+    },
+    "strict": true
+  }
+}
+```
+
+### Using with Chat Completion
+
+When used with chat completion, the AI model will format its response according to your schema:
+
+```ruby
+class StructuredResponse
+  include Raix::ChatCompletion
+
+  def analyze_person(name)
+    format = Raix::ResponseFormat.new("PersonAnalysis", {
+      full_name: { type: "string" },
+      age_estimate: { type: "integer" },
+      personality_traits: ["string"]
+    })
+
+    transcript << { user: "Analyze the person named #{name}" }
+    chat_completion(response_format: format)
+  end
+end
+
+response = StructuredResponse.new.analyze_person("Alice")
+# Returns a hash matching the defined schema
+```
+
 ## Installation
 
 Install the gem and add to the application's Gemfile by executing:

data/lib/raix/chat_completion.rb

@@ -2,6 +2,7 @@
 
 require "active_support/concern"
 require "active_support/core_ext/object/blank"
+require "active_support/core_ext/string/filters"
 require "open_router"
 require "openai"
 

data/lib/raix/predicate.rb

@@ -27,13 +27,13 @@ module Raix
       base.extend(ClassMethods)
     end
 
-    def ask(question)
+    def ask(question, openai: false)
       raise "Please define a yes and/or no block" if self.class.yes_block.nil? && self.class.no_block.nil?
 
       transcript << { system: "Always answer 'Yes, ', 'No, ', or 'Maybe, ' followed by a concise explanation!" }
       transcript << { user: question }
 
-      chat_completion.tap do |response|
+      chat_completion(openai:).tap do |response|
         if response.downcase.start_with?("yes,")
           instance_exec(response, &self.class.yes_block) if self.class.yes_block
         elsif response.downcase.start_with?("no,")

data/lib/raix/prompt_declarations.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "ostruct"
+require "active_support/core_ext/string/filters"
 
 module Raix
   # The PromptDeclarations module provides a way to chain prompts and handle

data/lib/raix/response_format.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "active_support/core_ext/object/deep_dup"
+require "active_support/core_ext/string/filters"
 
 module Raix
   # Handles the formatting of responses for AI interactions.

data/lib/raix/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Raix
-  VERSION = "0.4.4"
+  VERSION = "0.4.6"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: raix
 version: !ruby/object:Gem::Version
-  version: 0.4.4
+  version: 0.4.6
 platform: ruby
 authors:
 - Obie Fernandez
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-11-11 00:00:00.000000000 Z
+date: 2024-12-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport