activeagent 1.0.0.rc1 → 1.0.0

data/lib/active_agent/providers/open_ai/chat/requests/messages/content/file.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-require_relative "files/_types"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Chat
-        module Requests
-          module Messages
-            module Content
-              # File content part
-              class File < Base
-                attribute :type, :string, as: "file"
-                attribute :file, Files::DetailsType.new
-
-                validates :file, presence: true
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/chat/requests/messages/content/files/_types.rb

@@ -1,60 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "details"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Chat
-        module Requests
-          module Messages
-            module Content
-              module Files
-                # Type for the nested file object
-                class DetailsType < ActiveModel::Type::Value
-                  def cast(value)
-                    case value
-                    when Details
-                      value
-                    when Hash
-                      Details.new(**value.deep_symbolize_keys)
-                    when String
-                      if value.start_with?("data:")
-                        Details.new(file_data: value)
-                      elsif value.match?(%r{\Ahttps?://})
-                        raise ArgumentError, "HTTP/S URLs are not supported. Use a base64 data instead"
-                      else
-                        Details.new(file_data: value)
-                      end
-                    when nil
-                      nil
-                    else
-                      raise ArgumentError, "Cannot cast #{value.class} to File::Details"
-                    end
-                  end
-
-                  def serialize(value)
-                    case value
-                    when Details
-                      value.serialize
-                    when Hash
-                      value
-                    when nil
-                      nil
-                    else
-                      raise ArgumentError, "Cannot serialize #{value.class}"
-                    end
-                  end
-
-                  def deserialize(value)
-                    cast(value)
-                  end
-                end
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/chat/requests/messages/content/files/details.rb

@@ -1,41 +0,0 @@
-# frozen_string_literal: true
-
-require "active_agent/providers/common/model"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Chat
-        module Requests
-          module Messages
-            module Content
-              module Files
-                # Represents the nested file object within File content part
-                class Details < Common::BaseModel
-                  # The base64 encoded file data, used when passing the file to the model as a string
-                  attribute :file_data, :string
-
-                  # The ID of an uploaded file to use as input
-                  attribute :file_id, :string
-
-                  # The name of the file, used when passing the file to the model as a string
-                  attribute :filename, :string
-
-                  # Override serialize to strip data URI prefix from file_data
-                  def file_data=(value)
-                    # Strip data URI prefix from file_data if present
-                    if value&.match?(/\Adata:[^;]+;base64,/)
-                      value = value.sub(/\Adata:[^;]+;base64,/, "")
-                    end
-
-                    super(value)
-                  end
-                end
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/chat/requests/messages/content/image.rb

@@ -1,37 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Chat
-        module Requests
-          module Messages
-            module Content
-              # Image content part
-              class Image < Base
-                attribute :type, :string, as: "image_url"
-                attribute :image_url, default: -> { {} }
-
-                validates :image_url, presence: true
-
-                # Nested image_url object
-                def image_url=(value)
-                  case value
-                  when Hash
-                    super(value.symbolize_keys)
-                  when String
-                    super({ url: value })
-                  else
-                    super(value)
-                  end
-                end
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/chat/requests/messages/content/refusal.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Chat
-        module Requests
-          module Messages
-            module Content
-              # Refusal content part (used in assistant messages)
-              class Refusal < Base
-                attribute :type, :string, as: "refusal"
-                attribute :refusal, :string
-
-                validates :refusal, presence: true
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/chat/requests/messages/content/text.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Chat
-        module Requests
-          module Messages
-            module Content
-              # Text content part
-              class Text < Base
-                attribute :type, :string, as: "text"
-                attribute :text, :string
-
-                validates :text, presence: true
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/chat/requests/messages/developer.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-require_relative "content/_types"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Chat
-        module Requests
-          module Messages
-            # Developer message - instructions that the model should follow (o1 models and newer)
-            class Developer < Base
-              attribute :role, :string, as: "developer"
-              attribute :content, Content::ContentsType.new # String or array of content parts
-              attribute :name, :string # Optional name for the participant
-
-              validates :content, presence: true
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/chat/requests/messages/function.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Chat
-        module Requests
-          module Messages
-            # Function message - result from a function call (deprecated)
-            class Function < Base
-              attribute :role, :string, as: "function"
-              attribute :content, :string # Result of the function call
-              attribute :name, :string # Name of the function that was called
-
-              validates :content, presence: true
-              validates :name, presence: true
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/chat/requests/messages/system.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-require_relative "content/_types"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Chat
-        module Requests
-          module Messages
-            # System message - instructions that the model should follow (older models)
-            class System < Base
-              attribute :role, :string, as: "system"
-              attribute :content, Content::ContentsType.new # String or array of content parts
-              attribute :name, :string # Optional name for the participant
-
-              validates :content, presence: true
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/chat/requests/messages/tool.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-require_relative "content/_types"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Chat
-        module Requests
-          module Messages
-            # Tool message - result from a tool call
-            class Tool < Base
-              attribute :role, :string, as: "tool"
-              attribute :content, Content::ContentsType.new # String or array of content parts
-              attribute :tool_call_id, :string # ID of the tool call this is a response to
-
-              validates :content, presence: true
-              validates :tool_call_id, presence: true
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/chat/requests/messages/user.rb

@@ -1,32 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-require_relative "content/_types"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Chat
-        module Requests
-          module Messages
-            # User message - messages sent by an end user
-            class User < Base
-              attribute :role, :string, as: "user"
-              attribute :content, Content::ContentsType.new # String or array of content parts
-              attribute :name, :string # Optional name for the participant
-
-              validates :content, presence: true
-
-              %i[text image document].each do |content_type|
-                define_method(:"#{content_type}=") do |value|
-                  self.content ||= []
-                  self.content += [ { content_type => value } ]
-                end
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/chat/requests/prediction.rb

@@ -1,46 +0,0 @@
-# frozen_string_literal: true
-
-require "active_agent/providers/common/model"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Chat
-        module Requests
-          class Prediction < Common::BaseModel
-            # Type of predicted content (always "content")
-            attribute :type, :string, default: "content"
-
-            # Content that should be matched (string or array of content parts)
-            attribute :content
-
-            validates :type, inclusion: { in: %w[content] }, allow_nil: true
-
-            # Validate content is present and in correct format
-            validate :validate_content_format
-
-            private
-
-            def validate_content_format
-              if content.blank?
-                errors.add(:content, "must be present")
-                return
-              end
-
-              # Content can be a string or an array of content parts
-              if content.is_a?(Array)
-                content.each do |part|
-                  unless part.is_a?(Hash) && part[:type].present?
-                    errors.add(:content, "array elements must be hashes with a 'type' field")
-                  end
-                end
-              elsif !content.is_a?(String)
-                errors.add(:content, "must be a string or array of content parts")
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/chat/requests/response_format.rb

@@ -1,53 +0,0 @@
-# frozen_string_literal: true
-
-require "active_agent/providers/common/model"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Chat
-        module Requests
-          class ResponseFormat < Common::BaseModel
-            # Type of response format (text, json_schema, json_object)
-            attribute :type, :string
-
-            # JSON schema configuration (only for json_schema type)
-            attribute :json_schema # Hash with name, description, schema, strict
-
-            validates :type, inclusion: { in: %w[text json_schema json_object] }, allow_nil: true
-
-            # Validate that json_schema is present when type is json_schema
-            validate :validate_json_schema_presence
-
-            private
-
-            def validate_json_schema_presence
-              if type == "json_schema" && json_schema.blank?
-                errors.add(:json_schema, "must be present when type is 'json_schema'")
-              end
-
-              if json_schema.present? && json_schema.is_a?(Hash)
-                validate_json_schema_structure
-              end
-            end
-
-            def validate_json_schema_structure
-              unless json_schema[:name].present?
-                errors.add(:json_schema, "must include 'name' field")
-              end
-
-              if json_schema[:name].present? && json_schema[:name].length > 64
-                errors.add(:json_schema, "name must be 64 characters or less")
-              end
-
-              # Name must match pattern: a-z, A-Z, 0-9, underscores and dashes
-              if json_schema[:name].present? && json_schema[:name] !~ /^[a-zA-Z0-9_-]+$/
-                errors.add(:json_schema, "name must contain only a-z, A-Z, 0-9, underscores and dashes")
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/chat/requests/stream_options.rb

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-require "active_agent/providers/common/model"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Chat
-        module Requests
-          class StreamOptions < Common::BaseModel
-            # Include usage information in the stream
-            attribute :include_usage, :boolean
-
-            # Include obfuscation in the stream
-            attribute :include_obfuscation, :boolean
-
-            validates :include_usage, inclusion: { in: [ true, false ] }, allow_nil: true
-            validates :include_obfuscation, inclusion: { in: [ true, false ] }, allow_nil: true
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/chat/requests/tool_choice.rb

@@ -1,26 +0,0 @@
-# frozen_string_literal: true
-
-require "active_agent/providers/common/model"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Chat
-        module Requests
-          # Tool choice configuration
-          class ToolChoice < Common::BaseModel
-            # Can be string ("none", "auto", "required") or object
-            attribute :mode, :string
-            attribute :type, :string
-            attribute :function # Hash with name
-            attribute :custom # Hash with name
-            attribute :allowed_tools # Hash with mode and tools array
-
-            validates :mode, inclusion: { in: %w[none auto required] }, allow_nil: true
-            validates :type, inclusion: { in: %w[function custom allowed_tools] }, allow_nil: true
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/chat/requests/tools/_types.rb

@@ -1,5 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-require_relative "custom_tool"
-require_relative "function_tool"

data/lib/active_agent/providers/open_ai/chat/requests/tools/base.rb

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-require "active_agent/providers/common/model"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Chat
-        module Requests
-          module Tools
-            # Base class for tools
-            class Base < Common::BaseModel
-              attribute :type, :string
-
-              validates :type, inclusion: { in: %w[function custom] }
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/chat/requests/tools/custom_tool.rb

@@ -1,41 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Chat
-        module Requests
-          module Tools
-            # Custom tool
-            class CustomTool < Base
-              attribute :type, :string, as: "custom"
-              attribute :custom # Hash with name, description, format
-
-              validate :validate_custom_structure
-
-              private
-
-              def validate_custom_structure
-                if custom.blank?
-                  errors.add(:custom, "must be present")
-                  return
-                end
-
-                unless custom.is_a?(Hash)
-                  errors.add(:custom, "must be a hash")
-                  return
-                end
-
-                unless custom[:name].present?
-                  errors.add(:custom, "must include 'name' field")
-                end
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/chat/requests/tools/function_tool.rb

@@ -1,51 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Chat
-        module Requests
-          module Tools
-            # Function tool
-            class FunctionTool < Base
-              attribute :type, :string, as: "function"
-              attribute :function # Hash with name, description, parameters, strict
-
-              validate :validate_function_structure
-
-              private
-
-              def validate_function_structure
-                if function.blank?
-                  errors.add(:function, "must be present")
-                  return
-                end
-
-                unless function.is_a?(Hash)
-                  errors.add(:function, "must be a hash")
-                  return
-                end
-
-                unless function[:name].present?
-                  errors.add(:function, "must include 'name' field")
-                end
-
-                if function[:name].present?
-                  if function[:name].length > 64
-                    errors.add(:function, "name must be 64 characters or less")
-                  end
-
-                  unless function[:name] =~ /^[a-zA-Z0-9_-]+$/
-                    errors.add(:function, "name must contain only a-z, A-Z, 0-9, underscores and dashes")
-                  end
-                end
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/chat/requests/web_search_options.rb

@@ -1,45 +0,0 @@
-# frozen_string_literal: true
-
-require "active_agent/providers/common/model"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Chat
-        module Requests
-          class WebSearchOptions < Common::BaseModel
-            # Search context size (low, medium, high)
-            attribute :search_context_size, :string
-
-            # User location for search
-            attribute :user_location # Hash with type and approximate
-
-            validates :search_context_size, inclusion: { in: %w[low medium high] }, allow_nil: true
-
-            # Validate user_location format
-            validate :validate_user_location_format
-
-            private
-
-            def validate_user_location_format
-              return if user_location.nil?
-
-              unless user_location.is_a?(Hash)
-                errors.add(:user_location, "must be a hash")
-                return
-              end
-
-              unless user_location[:type] == "approximate"
-                errors.add(:user_location, "type must be 'approximate'")
-              end
-
-              unless user_location[:approximate].is_a?(Hash)
-                errors.add(:user_location, "must include 'approximate' hash")
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end