fetch_hive 0.2.4 → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 37b77a6a159964d561dc379a54c47c8231e235a8f60b2397bed73aaeb79304b3
-  data.tar.gz: a805ca9d930d1ad821b673a84b95a8bf854611eccb619716895b24d256aa6b1e
+  metadata.gz: 42e51d3c63d74fff1f041e1e9f7071ece5a5209825f17a28084ef3d06104552b
+  data.tar.gz: a53eba2263d50961c429130a1fd31d02c5c2c996f8c997bb6ba0b169f1263f56
 SHA512:
-  metadata.gz: ffa21ea91982cf6cbf080b2db47f41688e2b30465f738c6cb8cc166173dfa4efb7ab367195bcd3cff48e22d18a5c88ea38e22ece304020d5cbfb0e5238421591
-  data.tar.gz: e4da47bd790f4fa171613251bd89cf5db5dbc1eb7539ed044e1fb9cd7e5bc0005ef0ea91606353211c8f94f3479c74a0bc09bfacc6c803929ea97f972399a6b9
+  metadata.gz: bf84fa42a8112466fc9fb1f7a8b4b682ce128f15b4c7377b9d2b1d7c70f690c01aa1321ad71e41905e6ae32a12d5fd917889f34f08e00090b58214eea0adf945
+  data.tar.gz: 983b6660e859c97b56c1584d14975a92adfe2d3c4a8e23b6c12b7bf0d7594c515511ccb200974808b2a65e2c998b175f19abdc719f4b8c92f5ab45c4d5dd1038

data/README.md

@@ -9,7 +9,7 @@ Official Ruby SDK for [Fetch Hive](https://fetchhive.com) — invoke AI prompts,
 Add to your `Gemfile`:
 
 ```ruby
-gem "fetch_hive", "~> 0.2.4"
+gem "fetch_hive", "~> 0.2.5"
 ```
 
 Then run:
@@ -142,7 +142,7 @@ client = FetchHive::Client.new  # picks up FETCH_HIVE_API_KEY automatically
 
 ## Version
 
-0.2.4
+0.2.5
 
 ## License
 

data/lib/fetch_hive/client.rb

@@ -42,32 +42,35 @@ module FetchHive
     # ── Prompt ─────────────────────────────────────────────────────────────────
 
     # Invoke a prompt deployment and return the full response hash.
-    def invoke_prompt(deployment:, variant: nil, inputs: nil, user: nil)
+    def invoke_prompt(deployment:, variant: nil, inputs: nil, user: nil, metadata: nil)
       body = { deployment: deployment, streaming: false }
       body[:variant] = variant if variant
       body[:inputs]  = inputs  if inputs
       body[:user]    = user    if user
+      body[:metadata] = metadata if metadata
       post("/invoke", body)
     end
 
     # Invoke a prompt deployment and stream SSE events.
     # Yields each parsed event hash. Returns an Enumerator when no block given.
-    def invoke_prompt_stream(deployment:, variant: nil, inputs: nil, user: nil, &block)
+    def invoke_prompt_stream(deployment:, variant: nil, inputs: nil, user: nil, metadata: nil, &block)
       body = { deployment: deployment, streaming: true }
       body[:variant] = variant if variant
       body[:inputs]  = inputs  if inputs
       body[:user]    = user    if user
+      body[:metadata] = metadata if metadata
       post_stream("/invoke", body, &block)
     end
 
     # ── Workflow ────────────────────────────────────────────────────────────────
 
     # Invoke a workflow deployment (sync or async).
-    def invoke_workflow(deployment:, variant: nil, inputs: nil, async_mode: false, callback_url: nil, user: nil)
+    def invoke_workflow(deployment:, variant: nil, inputs: nil, async_mode: false, callback_url: nil, user: nil, metadata: nil)
       body = { deployment: deployment }
       body[:variant] = variant if variant
       body[:inputs]  = inputs  if inputs
       body[:user]    = user    if user
+      body[:metadata] = metadata if metadata
       if async_mode
         body[:async] = { enabled: true }
         body[:async][:callback_url] = callback_url if callback_url
@@ -78,10 +81,11 @@ module FetchHive
     # ── Agent ───────────────────────────────────────────────────────────────────
 
     # Send a message to an agent and return the full response hash.
-    def invoke_agent(agent:, message:, thread_id: nil, user: nil, messages: nil, image_urls: nil)
+    def invoke_agent(agent:, message:, thread_id: nil, user: nil, metadata: nil, messages: nil, image_urls: nil)
       body = { agent: agent, message: message, streaming: false }
       body[:thread_id]  = thread_id  if thread_id
       body[:user]       = user       if user
+      body[:metadata] = metadata if metadata
       body[:messages]   = messages   if messages
       body[:image_urls] = image_urls if image_urls
       post("/agent/invoke", body)
@@ -89,10 +93,11 @@ module FetchHive
 
     # Send a message to an agent and stream SSE events.
     # Yields each parsed event hash. Returns an Enumerator when no block given.
-    def invoke_agent_stream(agent:, message:, thread_id: nil, user: nil, messages: nil, image_urls: nil, &block)
+    def invoke_agent_stream(agent:, message:, thread_id: nil, user: nil, metadata: nil, messages: nil, image_urls: nil, &block)
       body = { agent: agent, message: message, streaming: true }
       body[:thread_id]  = thread_id  if thread_id
       body[:user]       = user       if user
+      body[:metadata] = metadata if metadata
       body[:messages]   = messages   if messages
       body[:image_urls] = image_urls if image_urls
       post_stream("/agent/invoke", body, &block)

data/lib/fetch_hive/generated/api/agents_api.rb

@@ -3,7 +3,7 @@
 
 #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.4
+The version of the OpenAPI document: 0.2.5
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.22.0

data/lib/fetch_hive/generated/api/prompts_api.rb

@@ -3,7 +3,7 @@
 
 #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.4
+The version of the OpenAPI document: 0.2.5
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.22.0

data/lib/fetch_hive/generated/api/workflows_api.rb

@@ -3,7 +3,7 @@
 
 #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.4
+The version of the OpenAPI document: 0.2.5
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.22.0

data/lib/fetch_hive/generated/api_client.rb

@@ -3,7 +3,7 @@
 
 #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.4
+The version of the OpenAPI document: 0.2.5
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.22.0

data/lib/fetch_hive/generated/api_error.rb

@@ -3,7 +3,7 @@
 
 #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.4
+The version of the OpenAPI document: 0.2.5
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.22.0

data/lib/fetch_hive/generated/api_model_base.rb

@@ -3,7 +3,7 @@
 
 #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.4
+The version of the OpenAPI document: 0.2.5
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.22.0

data/lib/fetch_hive/generated/configuration.rb

@@ -3,7 +3,7 @@
 
 #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.4
+The version of the OpenAPI document: 0.2.5
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.22.0

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

@@ -3,7 +3,7 @@
 
 #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.4
+The version of the OpenAPI document: 0.2.5
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.22.0

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

@@ -3,7 +3,7 @@
 
 #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.4
+The version of the OpenAPI document: 0.2.5
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.22.0

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

@@ -3,7 +3,7 @@
 
 #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.4
+The version of the OpenAPI document: 0.2.5
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.22.0

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

@@ -3,7 +3,7 @@
 
 #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.4
+The version of the OpenAPI document: 0.2.5
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.22.0
@@ -30,6 +30,9 @@ module FetchHive::Generated
     # Optional opaque caller identifier for audit logging.
     attr_accessor :user
 
+    # Flat caller-defined metadata stored separately from internal metadata for log display and filtering. Keys must be non-empty strings; values must be strings, numbers, booleans, or null.
+    attr_accessor :metadata
+
     # Ephemeral conversation history supplied by the caller. Not stored in the database. Takes precedence over `thread_id` history when both are provided. 
     attr_accessor :messages
 
@@ -44,6 +47,7 @@ module FetchHive::Generated
         :'thread_id' => :'thread_id',
         :'streaming' => :'streaming',
         :'user' => :'user',
+        :'metadata' => :'metadata',
         :'messages' => :'messages',
         :'image_urls' => :'image_urls'
       }
@@ -67,6 +71,7 @@ module FetchHive::Generated
         :'thread_id' => :'String',
         :'streaming' => :'Boolean',
         :'user' => :'String',
+        :'metadata' => :'Hash<String, MetadataValue>',
         :'messages' => :'Array<AgentMessage>',
         :'image_urls' => :'Array<String>'
       }
@@ -122,6 +127,12 @@ module FetchHive::Generated
         self.user = attributes[:'user']
       end
 
+      if attributes.key?(:'metadata')
+        if (value = attributes[:'metadata']).is_a?(Hash)
+          self.metadata = value
+        end
+      end
+
       if attributes.key?(:'messages')
         if (value = attributes[:'messages']).is_a?(Array)
           self.messages = value
@@ -190,6 +201,7 @@ module FetchHive::Generated
           thread_id == o.thread_id &&
           streaming == o.streaming &&
           user == o.user &&
+          metadata == o.metadata &&
           messages == o.messages &&
           image_urls == o.image_urls
     end
@@ -203,7 +215,7 @@ module FetchHive::Generated
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [message, agent, thread_id, streaming, user, messages, image_urls].hash
+      [message, agent, thread_id, streaming, user, metadata, messages, image_urls].hash
     end
 
     # Builds the object from hash

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

@@ -3,7 +3,7 @@
 
 #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.4
+The version of the OpenAPI document: 0.2.5
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.22.0

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

@@ -3,7 +3,7 @@
 
 #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.4
+The version of the OpenAPI document: 0.2.5
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.22.0
@@ -30,6 +30,9 @@ module FetchHive::Generated
     # Optional opaque caller identifier for audit logging.
     attr_accessor :user
 
+    # Flat caller-defined metadata stored separately from internal metadata for log display and filtering. Keys must be non-empty strings; values must be strings, numbers, booleans, or null.
+    attr_accessor :metadata
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
@@ -37,7 +40,8 @@ module FetchHive::Generated
         :'variant' => :'variant',
         :'inputs' => :'inputs',
         :'streaming' => :'streaming',
-        :'user' => :'user'
+        :'user' => :'user',
+        :'metadata' => :'metadata'
       }
     end
 
@@ -58,7 +62,8 @@ module FetchHive::Generated
         :'variant' => :'String',
         :'inputs' => :'Hash<String, Object>',
         :'streaming' => :'Boolean',
-        :'user' => :'String'
+        :'user' => :'String',
+        :'metadata' => :'Hash<String, MetadataValue>'
       }
     end
 
@@ -111,6 +116,12 @@ module FetchHive::Generated
       if attributes.key?(:'user')
         self.user = attributes[:'user']
       end
+
+      if attributes.key?(:'metadata')
+        if (value = attributes[:'metadata']).is_a?(Hash)
+          self.metadata = value
+        end
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -152,7 +163,8 @@ module FetchHive::Generated
           variant == o.variant &&
           inputs == o.inputs &&
           streaming == o.streaming &&
-          user == o.user
+          user == o.user &&
+          metadata == o.metadata
     end
 
     # @see the `==` method
@@ -164,7 +176,7 @@ module FetchHive::Generated
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [deployment, variant, inputs, streaming, user].hash
+      [deployment, variant, inputs, streaming, user, metadata].hash
     end
 
     # Builds the object from hash

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

@@ -3,7 +3,7 @@
 
 #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.4
+The version of the OpenAPI document: 0.2.5
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.22.0

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

@@ -3,7 +3,7 @@
 
 #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.4
+The version of the OpenAPI document: 0.2.5
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.22.0

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

@@ -3,7 +3,7 @@
 
 #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.4
+The version of the OpenAPI document: 0.2.5
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.22.0
@@ -29,6 +29,9 @@ module FetchHive::Generated
     # Optional opaque caller identifier for audit logging.
     attr_accessor :user
 
+    # Flat caller-defined metadata stored separately from internal metadata for log display and filtering. Keys must be non-empty strings; values must be strings, numbers, booleans, or null.
+    attr_accessor :metadata
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
@@ -36,7 +39,8 @@ module FetchHive::Generated
         :'variant' => :'variant',
         :'inputs' => :'inputs',
         :'async' => :'async',
-        :'user' => :'user'
+        :'user' => :'user',
+        :'metadata' => :'metadata'
       }
     end
 
@@ -57,7 +61,8 @@ module FetchHive::Generated
         :'variant' => :'String',
         :'inputs' => :'Hash<String, Object>',
         :'async' => :'AsyncConfig',
-        :'user' => :'String'
+        :'user' => :'String',
+        :'metadata' => :'Hash<String, MetadataValue>'
       }
     end
 
@@ -108,6 +113,12 @@ module FetchHive::Generated
       if attributes.key?(:'user')
         self.user = attributes[:'user']
       end
+
+      if attributes.key?(:'metadata')
+        if (value = attributes[:'metadata']).is_a?(Hash)
+          self.metadata = value
+        end
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -149,7 +160,8 @@ module FetchHive::Generated
           variant == o.variant &&
           inputs == o.inputs &&
           async == o.async &&
-          user == o.user
+          user == o.user &&
+          metadata == o.metadata
     end
 
     # @see the `==` method
@@ -161,7 +173,7 @@ module FetchHive::Generated
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [deployment, variant, inputs, async, user].hash
+      [deployment, variant, inputs, async, user, metadata].hash
     end
 
     # Builds the object from hash

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

@@ -3,7 +3,7 @@
 
 #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.4
+The version of the OpenAPI document: 0.2.5
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.22.0

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

@@ -0,0 +1,105 @@
+=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.5
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.22.0
+
+=end
+
+require 'date'
+require 'time'
+
+module FetchHive::Generated
+  module MetadataValue
+    class << self
+      # List of class defined in oneOf (OpenAPI v3)
+      def openapi_one_of
+        [
+          :'Boolean',
+          :'Float',
+          :'String'
+        ]
+      end
+
+      # Builds the object
+      # @param [Mixed] Data to be matched against the list of oneOf items
+      # @return [Object] Returns the model or the data itself
+      def build(data)
+        # Go through the list of oneOf items and attempt to identify the appropriate one.
+        # Note:
+        # - We do not attempt to check whether exactly one item matches.
+        # - No advanced validation of types in some cases (e.g. "x: { type: string }" will happily match { x: 123 })
+        #   due to the way the deserialization is made in the base_object template (it just casts without verifying).
+        # - TODO: scalar values are de facto behaving as if they were nullable.
+        # - TODO: logging when debugging is set.
+        openapi_one_of.each do |klass|
+          begin
+            next if klass == :AnyType # "nullable: true"
+            return find_and_cast_into_type(klass, data)
+          rescue # rescue all errors so we keep iterating even if the current item lookup raises
+          end
+        end
+
+        openapi_one_of.include?(:AnyType) ? data : nil
+      end
+
+      private
+
+      SchemaMismatchError = Class.new(StandardError)
+
+      # Note: 'File' is missing here because in the regular case we get the data _after_ a call to JSON.parse.
+      def find_and_cast_into_type(klass, data)
+        return if data.nil?
+
+        case klass.to_s
+        when 'Boolean'
+          return data if data.instance_of?(TrueClass) || data.instance_of?(FalseClass)
+        when 'Float'
+          return data if data.instance_of?(Float)
+        when 'Integer'
+          return data if data.instance_of?(Integer)
+        when 'Time'
+          return Time.parse(data)
+        when 'Date'
+          return Date.iso8601(data)
+        when 'String'
+          return data if data.instance_of?(String)
+        when 'Object' # "type: object"
+          return data if data.instance_of?(Hash)
+        when /\AArray<(?<sub_type>.+)>\z/ # "type: array"
+          if data.instance_of?(Array)
+            sub_type = Regexp.last_match[:sub_type]
+            return data.map { |item| find_and_cast_into_type(sub_type, item) }
+          end
+        when /\AHash<String, (?<sub_type>.+)>\z/ # "type: object" with "additionalProperties: { ... }"
+          if data.instance_of?(Hash) && data.keys.all? { |k| k.instance_of?(Symbol) || k.instance_of?(String) }
+            sub_type = Regexp.last_match[:sub_type]
+            return data.each_with_object({}) { |(k, v), hsh| hsh[k] = find_and_cast_into_type(sub_type, v) }
+          end
+        else # model
+          const = FetchHive::Generated.const_get(klass)
+          if const
+            if const.respond_to?(:openapi_one_of) # nested oneOf model
+              model = const.build(data)
+              return model if model
+            else
+              # raise if data contains keys that are not known to the model
+              raise if const.respond_to?(:acceptable_attributes) && !(data.keys - const.acceptable_attributes).empty?
+              model = const.build_from_hash(data)
+              return model if model
+            end
+          end
+        end
+
+        raise # if no match by now, raise
+      rescue
+        raise SchemaMismatchError, "#{data} doesn't match the #{klass} type"
+      end
+    end
+  end
+
+end

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

@@ -3,7 +3,7 @@
 
 #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.4
+The version of the OpenAPI document: 0.2.5
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.22.0

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

@@ -3,7 +3,7 @@
 
 #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.4
+The version of the OpenAPI document: 0.2.5
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.22.0

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

@@ -3,7 +3,7 @@
 
 #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.4
+The version of the OpenAPI document: 0.2.5
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.22.0

data/lib/fetch_hive/generated/version.rb

@@ -3,7 +3,7 @@
 
 #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.4
+The version of the OpenAPI document: 0.2.5
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.22.0

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fetch_hive
 version: !ruby/object:Gem::Version
-  version: 0.2.4
+  version: 0.2.5
 platform: ruby
 authors:
 - Fetch Hive
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-17 00:00:00.000000000 Z
+date: 2026-05-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -66,6 +66,7 @@ files:
 - lib/fetch_hive/generated/models/invoke_workflow_async_response.rb
 - lib/fetch_hive/generated/models/invoke_workflow_request.rb
 - lib/fetch_hive/generated/models/invoke_workflow_response.rb
+- lib/fetch_hive/generated/models/metadata_value.rb
 - lib/fetch_hive/generated/models/sse_chunk.rb
 - lib/fetch_hive/generated/models/token_usage.rb
 - lib/fetch_hive/generated/models/tool_invocation.rb