activeagent 1.0.0.rc1 → 1.0.0

data/lib/active_agent/providers/open_ai/responses/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 Responses
-        module Requests
-          # Tool choice configuration for Responses API
-          # Controls how the model should select which tool (or tools) to use when generating a response.
-          class ToolChoice < Common::BaseModel
-            # Can be string ("none", "auto", "required") or object with type and tool details
-            attribute :mode, :string
-            attribute :type, :string
-            attribute :function # Hash with name
-            attribute :custom # Hash with name
-
-            validates :mode, inclusion: { in: %w[none auto required] }, allow_nil: true
-            validates :type, inclusion: { in: %w[function custom] }, allow_nil: true
-          end
-        end
-      end
-    end
-  end
-end

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

@@ -1,112 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-require_relative "code_interpreter_tool"
-require_relative "computer_tool"
-require_relative "custom_tool"
-require_relative "file_search_tool"
-require_relative "function_tool"
-require_relative "image_generation_tool"
-require_relative "local_shell_tool"
-require_relative "mcp_tool"
-require_relative "web_search_preview_tool"
-require_relative "web_search_tool"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Responses
-        module Requests
-          module Tools
-            # Type for collection of tools
-            class ToolsType < ActiveModel::Type::Value
-              def initialize
-                super
-                @tool_type = ToolType.new
-              end
-
-              def cast(value)
-                return nil if value.nil?
-                return [] if value == []
-
-                array = Array(value)
-                array.map { |tool| @tool_type.cast(tool) }
-              end
-
-              def serialize(value)
-                return nil if value.nil?
-                return [] if value == []
-
-                array = Array(value)
-                array.map { |tool| @tool_type.serialize(tool) }
-              end
-
-              def deserialize(value)
-                cast(value)
-              end
-            end
-
-            # Type for individual tool
-            class ToolType < ActiveModel::Type::Value
-              def cast(value)
-                case value
-                when Base
-                  value
-                when Hash
-                  hash = value.deep_symbolize_keys
-                  type = hash[:type]&.to_sym
-
-                  case type
-                  when :function
-                    FunctionTool.new(**hash)
-                  when :custom
-                    CustomTool.new(**hash)
-                  when :web_search, :web_search_2025_08_26
-                    WebSearchTool.new(**hash)
-                  when :web_search_preview, :web_search_preview_2025_03_11
-                    WebSearchPreviewTool.new(**hash)
-                  when :code_interpreter
-                    CodeInterpreterTool.new(**hash)
-                  when :file_search
-                    FileSearchTool.new(**hash)
-                  when :computer_use_preview
-                    ComputerTool.new(**hash)
-                  when :mcp
-                    McpTool.new(**hash)
-                  when :image_generation
-                    ImageGenerationTool.new(**hash)
-                  when :local_shell
-                    LocalShellTool.new(**hash)
-                  else
-                    raise ArgumentError, "Unknown tool type: #{type.inspect}"
-                  end
-                when nil
-                  nil
-                else
-                  raise ArgumentError, "Cannot cast #{value.class} to Tool (expected Base, Hash, or nil)"
-                end
-              end
-
-              def serialize(value)
-                case value
-                when Base
-                  value.serialize
-                when Hash
-                  value
-                when nil
-                  nil
-                else
-                  raise ArgumentError, "Cannot serialize #{value.class} as Tool"
-                end
-              end
-
-              def deserialize(value)
-                cast(value)
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

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

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-require "active_agent/providers/common/model"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Responses
-        module Requests
-          module Tools
-            # Base class for tools in Responses API
-            class Base < Common::BaseModel
-              attribute :type, :string
-
-              validates :type, inclusion: {
-                in: %w[function custom web_search web_search_2025_08_26 code_interpreter file_search computer_use_preview mcp image_generation local_shell web_search_preview web_search_preview_2025_03_11],
-                allow_nil: true
-              }
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/responses/requests/tools/code_interpreter_tool.rb

@@ -1,23 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Responses
-        module Requests
-          module Tools
-            # Built-in code interpreter tool
-            class CodeInterpreterTool < Base
-              attribute :type, :string, as: "code_interpreter"
-              attribute :container # Required: can be string (container ID) or hash { type: "auto", file_ids: [] }
-
-              validates :container, presence: true
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/responses/requests/tools/computer_tool.rb

@@ -1,27 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Responses
-        module Requests
-          module Tools
-            # Built-in computer tool (note: type should be "computer_use_preview" per schema)
-            class ComputerTool < Base
-              attribute :type, :string, as: "computer_use_preview"
-              attribute :display_height, :integer # Required: height of the computer display
-              attribute :display_width, :integer # Required: width of the computer display
-              attribute :environment, :string # Required: type of computer environment to control
-
-              validates :display_height, presence: true, numericality: { greater_than: 0 }
-              validates :display_width, presence: true, numericality: { greater_than: 0 }
-              validates :environment, presence: true
-            end
-          end
-        end
-      end
-    end
-  end
-end

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

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Responses
-        module Requests
-          module Tools
-            # Custom tool
-            class CustomTool < Base
-              attribute :type, :string, as: "custom"
-              attribute :name, :string # Required: name of the custom tool
-              attribute :description, :string # Optional: description
-              attribute :format # Optional: hash with input format
-              # Can be { type: "text" } for unconstrained text
-              # Or { type: "grammar", definition: string, syntax: "lark"|"regex" }
-
-              validates :name, presence: true, length: { maximum: 64 }
-              validates :name, format: { with: /\A[a-zA-Z0-9_-]+\z/, message: "must contain only a-z, A-Z, 0-9, underscores and dashes" }, if: -> { name.present? }
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/responses/requests/tools/file_search_tool.rb

@@ -1,27 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Responses
-        module Requests
-          module Tools
-            # Built-in file search tool
-            class FileSearchTool < Base
-              attribute :type, :string, as: "file_search"
-              attribute :vector_store_ids # Array - required: The IDs of the vector stores to search
-              attribute :filters # Hash - optional: A filter to apply
-              attribute :max_num_results, :integer # Optional: maximum number of results (1-50)
-              attribute :ranking_options # Hash - optional: { ranker: string, score_threshold: number }
-
-              validates :vector_store_ids, presence: true
-              validates :max_num_results, numericality: { greater_than_or_equal_to: 1, less_than_or_equal_to: 50 }, allow_nil: true
-            end
-          end
-        end
-      end
-    end
-  end
-end

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

@@ -1,29 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Responses
-        module Requests
-          module Tools
-            # Function tool for custom function calling
-            class FunctionTool < Base
-              attribute :type, :string, as: "function"
-              attribute :name, :string
-              attribute :parameters # Hash - JSON Schema object (required)
-              attribute :strict, :boolean # Required - whether to enforce strict parameter validation (default true)
-              attribute :description, :string # Optional description
-
-              validates :name, presence: true, length: { maximum: 64 }
-              validates :name, format: { with: /\A[a-zA-Z0-9_-]+\z/, message: "must contain only a-z, A-Z, 0-9, underscores and dashes" }, if: -> { name.present? }
-              validates :parameters, presence: true
-              validates :strict, inclusion: { in: [ true, false ] }, allow_nil: false
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/responses/requests/tools/image_generation_tool.rb

@@ -1,37 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Responses
-        module Requests
-          module Tools
-            # Image generation tool
-            class ImageGenerationTool < Base
-              attribute :type, :string, as: "image_generation"
-              attribute :background, :string, default: "auto" # Optional: "transparent", "opaque", or "auto"
-              attribute :input_fidelity, :string, default: "low" # Optional: "high" or "low"
-              attribute :input_image_mask # Optional: hash with image_url and/or file_id
-              attribute :model, :string, default: "gpt-image-1" # Optional: model to use
-              attribute :moderation, :string, default: "auto" # Optional: moderation level
-              attribute :output_compression, :integer, default: 100 # Optional: compression level
-              attribute :output_format, :string, default: "png" # Optional: "png", "webp", or "jpeg"
-              attribute :partial_images, :integer, default: 0 # Optional: 0-3
-              attribute :quality, :string, default: "auto" # Optional: "low", "medium", "high", or "auto"
-              attribute :size, :string, default: "auto" # Optional: "1024x1024", "1024x1536", "1536x1024", or "auto"
-
-              validates :background, inclusion: { in: %w[transparent opaque auto] }, allow_nil: true
-              validates :input_fidelity, inclusion: { in: %w[high low] }, allow_nil: true
-              validates :output_format, inclusion: { in: %w[png webp jpeg] }, allow_nil: true
-              validates :partial_images, numericality: { greater_than_or_equal_to: 0, less_than_or_equal_to: 3 }, allow_nil: true
-              validates :quality, inclusion: { in: %w[low medium high auto] }, allow_nil: true
-              validates :size, inclusion: { in: %w[1024x1024 1024x1536 1536x1024 auto] }, allow_nil: true
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/responses/requests/tools/local_shell_tool.rb

@@ -1,21 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Responses
-        module Requests
-          module Tools
-            # Local shell tool
-            class LocalShellTool < Base
-              attribute :type, :string, as: "local_shell"
-              attribute :local_shell # Hash with optional configuration
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/responses/requests/tools/mcp_tool.rb

@@ -1,41 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Responses
-        module Requests
-          module Tools
-            # MCP (Model Context Protocol) tool
-            class McpTool < Base
-              attribute :type, :string, as: "mcp"
-              attribute :server_label, :string # Required: label for this MCP server
-              attribute :allowed_tools # Optional: array of tool names or filter object
-              attribute :authorization, :string # Optional: OAuth access token
-              attribute :connector_id, :string # Optional: service connector ID (e.g., "connector_googledrive")
-              attribute :headers # Optional: hash of HTTP headers
-              attribute :require_approval # Optional: string ("always"/"never") or object with approval filters
-              attribute :server_description, :string # Optional: description of the MCP server
-              attribute :server_url, :string # Optional: URL for the MCP server
-
-              validates :server_label, presence: true
-
-              # Either server_url or connector_id must be provided
-              validate :validate_server_url_or_connector_id
-
-              private
-
-              def validate_server_url_or_connector_id
-                if server_url.blank? && connector_id.blank?
-                  errors.add(:base, "Either server_url or connector_id must be provided")
-                end
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/responses/requests/tools/web_search_preview_tool.rb

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Responses
-        module Requests
-          module Tools
-            # Web search preview tool (older version)
-            class WebSearchPreviewTool < Base
-              attribute :type, :string, as: "web_search_preview" # Can be "web_search_preview" or "web_search_preview_2025_03_11"
-              attribute :search_context_size, :string # Optional: "low", "medium", or "high"
-              attribute :user_location # Hash - optional: { type: "approximate", city, country, region, timezone }
-
-              validates :search_context_size, inclusion: { in: %w[low medium high] }, allow_nil: true
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/active_agent/providers/open_ai/responses/requests/tools/web_search_tool.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module ActiveAgent
-  module Providers
-    module OpenAI
-      module Responses
-        module Requests
-          module Tools
-            # Built-in web search tool
-            class WebSearchTool < Base
-              attribute :type, :string, as: "web_search" # Can be "web_search" or "web_search_2025_08_26"
-              attribute :filters # Hash - optional: { allowed_domains: [] }
-              attribute :search_context_size, :string, default: "medium" # Optional: "low", "medium", or "high"
-              attribute :user_location # Hash - optional: { type: "approximate", city, country, region, timezone }
-
-              validates :search_context_size, inclusion: { in: %w[low medium high] }, allow_nil: true
-            end
-          end
-        end
-      end
-    end
-  end
-end