fetch_hive 0.2.2

data/lib/fetch_hive/generated/models/sse_chunk.rb

@@ -0,0 +1,228 @@
+=begin
+#Fetch Hive Public API
+
+#The Fetch Hive public API lets you invoke prompts, workflows, and agents programmatically using an API token.  ## Authentication All requests require a Bearer token in the `Authorization` header: ``` Authorization: Bearer <your-api-token> ```  ## Streaming Pass `\"streaming\": true` in the request body to receive a `text/event-stream` response. Each event is a JSON object sent as `data: <json>\\n\\n`. The stream ends with `data: [DONE]\\n\\n`. 
+
+The version of the OpenAPI document: 0.2.2
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.22.0
+
+=end
+
+require 'date'
+require 'time'
+
+module FetchHive::Generated
+  # A single event in a Server-Sent Events stream. The type field is a runtime discriminator. Known values: delta, done, tool_start, tool_end, error. 
+  class SseChunk < ApiModelBase
+    # Event type discriminator.
+    attr_accessor :type
+
+    # Text delta content (present for type \"delta\").
+    attr_accessor :content
+
+    # Present on the final \"done\" event.
+    attr_accessor :request_id
+
+    # Present on the final \"done\" event.
+    attr_accessor :model
+
+    # Tool name (present for \"tool_start\" / \"tool_end\").
+    attr_accessor :tool_name
+
+    # Serialised JSON tool input (present for \"tool_start\").
+    attr_accessor :tool_input
+
+    # Serialised JSON tool result (present for \"tool_end\").
+    attr_accessor :observation
+
+    # Error message (present for \"error\" events).
+    attr_accessor :error
+
+    attr_accessor :usage
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'type' => :'type',
+        :'content' => :'content',
+        :'request_id' => :'request_id',
+        :'model' => :'model',
+        :'tool_name' => :'tool_name',
+        :'tool_input' => :'tool_input',
+        :'observation' => :'observation',
+        :'error' => :'error',
+        :'usage' => :'usage'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'type' => :'String',
+        :'content' => :'String',
+        :'request_id' => :'String',
+        :'model' => :'String',
+        :'tool_name' => :'String',
+        :'tool_input' => :'String',
+        :'observation' => :'String',
+        :'error' => :'String',
+        :'usage' => :'TokenUsage'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `FetchHive::Generated::SseChunk` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `FetchHive::Generated::SseChunk`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'type')
+        self.type = attributes[:'type']
+      end
+
+      if attributes.key?(:'content')
+        self.content = attributes[:'content']
+      end
+
+      if attributes.key?(:'request_id')
+        self.request_id = attributes[:'request_id']
+      end
+
+      if attributes.key?(:'model')
+        self.model = attributes[:'model']
+      end
+
+      if attributes.key?(:'tool_name')
+        self.tool_name = attributes[:'tool_name']
+      end
+
+      if attributes.key?(:'tool_input')
+        self.tool_input = attributes[:'tool_input']
+      end
+
+      if attributes.key?(:'observation')
+        self.observation = attributes[:'observation']
+      end
+
+      if attributes.key?(:'error')
+        self.error = attributes[:'error']
+      end
+
+      if attributes.key?(:'usage')
+        self.usage = attributes[:'usage']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      true
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          type == o.type &&
+          content == o.content &&
+          request_id == o.request_id &&
+          model == o.model &&
+          tool_name == o.tool_name &&
+          tool_input == o.tool_input &&
+          observation == o.observation &&
+          error == o.error &&
+          usage == o.usage
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [type, content, request_id, model, tool_name, tool_input, observation, error, usage].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/fetch_hive/generated/models/token_usage.rb

@@ -0,0 +1,169 @@
+=begin
+#Fetch Hive Public API
+
+#The Fetch Hive public API lets you invoke prompts, workflows, and agents programmatically using an API token.  ## Authentication All requests require a Bearer token in the `Authorization` header: ``` Authorization: Bearer <your-api-token> ```  ## Streaming Pass `\"streaming\": true` in the request body to receive a `text/event-stream` response. Each event is a JSON object sent as `data: <json>\\n\\n`. The stream ends with `data: [DONE]\\n\\n`. 
+
+The version of the OpenAPI document: 0.2.2
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.22.0
+
+=end
+
+require 'date'
+require 'time'
+
+module FetchHive::Generated
+  # Token consumption for this request.
+  class TokenUsage < ApiModelBase
+    # Number of tokens in the prompt / input.
+    attr_accessor :prompt_tokens
+
+    # Number of tokens in the completion / output.
+    attr_accessor :completion_tokens
+
+    # Total tokens consumed.
+    attr_accessor :total_tokens
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'prompt_tokens' => :'prompt_tokens',
+        :'completion_tokens' => :'completion_tokens',
+        :'total_tokens' => :'total_tokens'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'prompt_tokens' => :'Integer',
+        :'completion_tokens' => :'Integer',
+        :'total_tokens' => :'Integer'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `FetchHive::Generated::TokenUsage` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `FetchHive::Generated::TokenUsage`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'prompt_tokens')
+        self.prompt_tokens = attributes[:'prompt_tokens']
+      end
+
+      if attributes.key?(:'completion_tokens')
+        self.completion_tokens = attributes[:'completion_tokens']
+      end
+
+      if attributes.key?(:'total_tokens')
+        self.total_tokens = attributes[:'total_tokens']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      true
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          prompt_tokens == o.prompt_tokens &&
+          completion_tokens == o.completion_tokens &&
+          total_tokens == o.total_tokens
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [prompt_tokens, completion_tokens, total_tokens].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/fetch_hive/generated/models/tool_invocation.rb

@@ -0,0 +1,169 @@
+=begin
+#Fetch Hive Public API
+
+#The Fetch Hive public API lets you invoke prompts, workflows, and agents programmatically using an API token.  ## Authentication All requests require a Bearer token in the `Authorization` header: ``` Authorization: Bearer <your-api-token> ```  ## Streaming Pass `\"streaming\": true` in the request body to receive a `text/event-stream` response. Each event is a JSON object sent as `data: <json>\\n\\n`. The stream ends with `data: [DONE]\\n\\n`. 
+
+The version of the OpenAPI document: 0.2.2
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.22.0
+
+=end
+
+require 'date'
+require 'time'
+
+module FetchHive::Generated
+  # A single tool call made by the agent during execution.
+  class ToolInvocation < ApiModelBase
+    # Name of the tool that was called.
+    attr_accessor :tool_name
+
+    # Arguments passed to the tool. Contains serialised JSON; parse client-side as needed. 
+    attr_accessor :tool_input
+
+    # The tool's return value. Contains serialised JSON; parse client-side as needed. 
+    attr_accessor :observation
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'tool_name' => :'tool_name',
+        :'tool_input' => :'tool_input',
+        :'observation' => :'observation'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'tool_name' => :'String',
+        :'tool_input' => :'String',
+        :'observation' => :'String'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `FetchHive::Generated::ToolInvocation` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `FetchHive::Generated::ToolInvocation`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'tool_name')
+        self.tool_name = attributes[:'tool_name']
+      end
+
+      if attributes.key?(:'tool_input')
+        self.tool_input = attributes[:'tool_input']
+      end
+
+      if attributes.key?(:'observation')
+        self.observation = attributes[:'observation']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      true
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          tool_name == o.tool_name &&
+          tool_input == o.tool_input &&
+          observation == o.observation
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [tool_name, tool_input, observation].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/fetch_hive/generated/version.rb

@@ -0,0 +1,15 @@
+=begin
+#Fetch Hive Public API
+
+#The Fetch Hive public API lets you invoke prompts, workflows, and agents programmatically using an API token.  ## Authentication All requests require a Bearer token in the `Authorization` header: ``` Authorization: Bearer <your-api-token> ```  ## Streaming Pass `\"streaming\": true` in the request body to receive a `text/event-stream` response. Each event is a JSON object sent as `data: <json>\\n\\n`. The stream ends with `data: [DONE]\\n\\n`. 
+
+The version of the OpenAPI document: 0.2.2
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.22.0
+
+=end
+
+module FetchHive::Generated
+  VERSION = '{{VERSION}}'
+end

data/lib/fetch_hive/streaming.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require "json"
+
+module FetchHive
+  # Lightweight Server-Sent Events (SSE) parser for streaming Fetch Hive responses.
+  #
+  # Sync example:
+  #
+  #   io = response.body  # any IO or string
+  #   FetchHive::Streaming.parse_sse(io) do |event|
+  #     puts event["content"] if event["type"] == "delta"
+  #   end
+  #
+  module Streaming
+    # Yields each parsed SSE event hash from +io_or_string+.
+    # Stops when it encounters +data: [DONE]+ or the stream is exhausted.
+    # Non-data lines, blank lines, and malformed JSON are silently skipped.
+    #
+    # @param io_or_string [String, IO, #each_line] the SSE response body
+    # @yield [Hash] parsed JSON event
+    def self.parse_sse(io_or_string, &block)
+      return enum_for(:parse_sse, io_or_string) unless block
+
+      buf = +""
+      reader = io_or_string.respond_to?(:read) ? io_or_string : StringIO.new(io_or_string)
+
+      loop do
+        chunk = reader.read(4096)
+        break if chunk.nil? || chunk.empty?
+
+        buf << chunk
+
+        while (idx = buf.index("\n"))
+          line = buf.slice!(0, idx + 1).chomp
+          next unless line.start_with?("data: ")
+
+          payload = line[6..]
+          return if payload.strip == "[DONE]"
+
+          begin
+            yield JSON.parse(payload)
+          rescue JSON::ParserError
+            # skip malformed lines
+          end
+        end
+      end
+
+      # Process any remaining buffer content after stream ends
+      buf.each_line do |line|
+        line = line.chomp
+        next unless line.start_with?("data: ")
+
+        payload = line[6..]
+        next if payload.strip == "[DONE]"
+
+        begin
+          yield JSON.parse(payload)
+        rescue JSON::ParserError
+          # skip malformed lines
+        end
+      end
+    end
+  end
+end

data/lib/fetch_hive/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module FetchHive
+  VERSION = "{{VERSION}}"
+end

data/lib/fetch_hive.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require_relative "fetch_hive/version"
+require_relative "fetch_hive/streaming"
+require_relative "fetch_hive/client"
+
+module FetchHive
+  # Generated API constants are loaded from lib/fetch_hive/generated/ after assembly.
+  # autoload :Generated, "fetch_hive/generated"
+end