fetch_hive 0.2.3 → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6f27931a3ac0003f9116aa9e5d0fc8a872ace63a0514f5c700cd18df613c56d4
-  data.tar.gz: 0ebadee4a39f04f58af432fee05f8f3398397bf806c520506f9e808e00a4edfc
+  metadata.gz: 42e51d3c63d74fff1f041e1e9f7071ece5a5209825f17a28084ef3d06104552b
+  data.tar.gz: a53eba2263d50961c429130a1fd31d02c5c2c996f8c997bb6ba0b169f1263f56
 SHA512:
-  metadata.gz: 4c3c0e5dc156a36db4bf8fe934f8cd8d65dc4b85e56c03deddb77f10fe7e7118bbf70946ee972fe666cefd40aab9d63e5fc1c6cfb0220876939473e53fa95e45
-  data.tar.gz: e2a222c32d2857f10030aaa90e1aefd1bae8a0cab2e9f3c1a3b0a97e526c3ffbd2473c124e81a4098b54755e0a895f3674eb1d06cd71eb2fa7185bee1a5e9e7e
+  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.3"
+gem "fetch_hive", "~> 0.2.5"
 ```
 
 Then run:
@@ -48,7 +48,10 @@ puts result["response"]
 
 ```ruby
 client.invoke_prompt_stream(deployment: "my-prompt", inputs: { name: "Alice" }) do |chunk|
-  print chunk["content"] if chunk["type"] == "delta"
+  case chunk["type"]
+  when "response" then print chunk["response"]
+  when "usage"    then puts "\nUsage: #{chunk['usage']}"
+  end
 end
 ```
 
@@ -93,8 +96,9 @@ client.invoke_agent_stream(
   thread_id: "session-abc123"  # optional — persist conversation history
 ) do |chunk|
   case chunk["type"]
-  when "delta"  then print chunk["content"]
-  when "tool_start" then puts "\nCalling tool: #{chunk['tool_name']}"
+  when "response" then print chunk["response"]
+  when "tool"     then puts "\nCalling tool: #{chunk['tool']}"
+  when "usage"    then puts "\nUsage: #{chunk['usage']}"
   end
 end
 ```
@@ -138,7 +142,7 @@ client = FetchHive::Client.new  # picks up FETCH_HIVE_API_KEY automatically
 
 ## Version
 
-0.2.3
+0.2.5
 
 ## License
 

data/lib/fetch_hive/client.rb

@@ -17,7 +17,11 @@ module FetchHive
   #
   #   # Streaming agent
   #   client.invoke_agent_stream(agent: "my-agent", message: "Hello") do |chunk|
-  #     print chunk["content"] if chunk["type"] == "delta"
+  #     case chunk["type"]
+  #     when "response" then print chunk["response"]
+  #     when "tool"     then puts "\nCalling tool: #{chunk['tool']}"
+  #     when "usage"    then puts "\nUsage: #{chunk['usage']}"
+  #     end
   #   end
   #
   class Client
@@ -38,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
@@ -74,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)
@@ -85,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.3
+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.3
+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.3
+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.3
+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.3
+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.3
+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.3
+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.3
+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.3
+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.3
+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.3
+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.3
+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.3
+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.3
+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.3
+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.3
+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.3
+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.3
+The version of the OpenAPI document: 0.2.5
 
 Generated by: https://openapi-generator.tech
 Generator version: 7.22.0
@@ -14,30 +14,54 @@ 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. 
+  # A single event in a Server-Sent Events stream. The `type` field is a runtime discriminator. Known values:   - `reasoning` — a reasoning / thinking chunk (prompt and agent streams)   - `response`  — a text chunk (prompt and agent streams)   - `tool`      — a tool invocation result (agent stream only)   - `usage`     — final token usage event; signals end of meaningful stream content   - `summary`   — auto-summarization event emitted before reasoning when a thread                   history was compressed (agent stream only)   - `error`     — server-side error during streaming  The stream is terminated by `data: [DONE]`, which is handled by the SSE parser and never surfaced as a chunk. 
   class SseChunk < ApiModelBase
     # Event type discriminator.
     attr_accessor :type
 
-    # Text delta content (present for type \"delta\").
-    attr_accessor :content
+    # Text content of the chunk. Present for `reasoning` and `response` event types. 
+    attr_accessor :response
 
-    # Present on the final \"done\" event.
+    # Unique request identifier. Present on most events; always present on `usage`.
     attr_accessor :request_id
 
-    # Present on the final \"done\" event.
+    # Model identifier. Present on `response` and `reasoning` events (prompt stream).
     attr_accessor :model
 
-    # Tool name (present for \"tool_start\" / \"tool_end\").
-    attr_accessor :tool_name
+    # Per-chunk boolean flag on `response` and `reasoning` events (agent stream). Not a terminal event type — use the `usage` event to detect end of stream. 
+    attr_accessor :done
 
-    # Serialised JSON tool input (present for \"tool_start\").
+    # Unique tool invocation identifier. Present for `tool` events.
+    attr_accessor :tool_id
+
+    # Tool name. Present for `tool` events (e.g. \"google_search\").
+    attr_accessor :tool
+
+    # Internal tool type identifier. Present for `tool` events.
+    attr_accessor :tool_type
+
+    # Parsed tool input arguments. Present for `tool` events.
     attr_accessor :tool_input
 
-    # Serialised JSON tool result (present for \"tool_end\").
+    # Serialised JSON tool result. Present for `tool` events.
     attr_accessor :observation
 
-    # Error message (present for \"error\" events).
+    # Reason the stream ended. Present on `usage` events (e.g. \"completed\").
+    attr_accessor :stop_reason
+
+    # Compressed summary of the prior conversation. Present for `summary` events.
+    attr_accessor :summary_text
+
+    # Token count before summarization. Present for `summary` events.
+    attr_accessor :original_token_count
+
+    # Model context window size. Present for `summary` events.
+    attr_accessor :context_limit
+
+    # LLM provider used for summarization. Present for `summary` events.
+    attr_accessor :provider
+
+    # Error message. Present for `error` events.
     attr_accessor :error
 
     attr_accessor :usage
@@ -46,12 +70,20 @@ module FetchHive::Generated
     def self.attribute_map
       {
         :'type' => :'type',
-        :'content' => :'content',
+        :'response' => :'response',
         :'request_id' => :'request_id',
         :'model' => :'model',
-        :'tool_name' => :'tool_name',
+        :'done' => :'done',
+        :'tool_id' => :'tool_id',
+        :'tool' => :'tool',
+        :'tool_type' => :'tool_type',
         :'tool_input' => :'tool_input',
         :'observation' => :'observation',
+        :'stop_reason' => :'stop_reason',
+        :'summary_text' => :'summary_text',
+        :'original_token_count' => :'original_token_count',
+        :'context_limit' => :'context_limit',
+        :'provider' => :'provider',
         :'error' => :'error',
         :'usage' => :'usage'
       }
@@ -71,12 +103,20 @@ module FetchHive::Generated
     def self.openapi_types
       {
         :'type' => :'String',
-        :'content' => :'String',
+        :'response' => :'String',
         :'request_id' => :'String',
         :'model' => :'String',
-        :'tool_name' => :'String',
-        :'tool_input' => :'String',
+        :'done' => :'Boolean',
+        :'tool_id' => :'String',
+        :'tool' => :'String',
+        :'tool_type' => :'String',
+        :'tool_input' => :'Hash<String, Object>',
         :'observation' => :'String',
+        :'stop_reason' => :'String',
+        :'summary_text' => :'String',
+        :'original_token_count' => :'Integer',
+        :'context_limit' => :'Integer',
+        :'provider' => :'String',
         :'error' => :'String',
         :'usage' => :'TokenUsage'
       }
@@ -108,8 +148,8 @@ module FetchHive::Generated
         self.type = attributes[:'type']
       end
 
-      if attributes.key?(:'content')
-        self.content = attributes[:'content']
+      if attributes.key?(:'response')
+        self.response = attributes[:'response']
       end
 
       if attributes.key?(:'request_id')
@@ -120,18 +160,52 @@ module FetchHive::Generated
         self.model = attributes[:'model']
       end
 
-      if attributes.key?(:'tool_name')
-        self.tool_name = attributes[:'tool_name']
+      if attributes.key?(:'done')
+        self.done = attributes[:'done']
+      end
+
+      if attributes.key?(:'tool_id')
+        self.tool_id = attributes[:'tool_id']
+      end
+
+      if attributes.key?(:'tool')
+        self.tool = attributes[:'tool']
+      end
+
+      if attributes.key?(:'tool_type')
+        self.tool_type = attributes[:'tool_type']
       end
 
       if attributes.key?(:'tool_input')
-        self.tool_input = attributes[:'tool_input']
+        if (value = attributes[:'tool_input']).is_a?(Hash)
+          self.tool_input = value
+        end
       end
 
       if attributes.key?(:'observation')
         self.observation = attributes[:'observation']
       end
 
+      if attributes.key?(:'stop_reason')
+        self.stop_reason = attributes[:'stop_reason']
+      end
+
+      if attributes.key?(:'summary_text')
+        self.summary_text = attributes[:'summary_text']
+      end
+
+      if attributes.key?(:'original_token_count')
+        self.original_token_count = attributes[:'original_token_count']
+      end
+
+      if attributes.key?(:'context_limit')
+        self.context_limit = attributes[:'context_limit']
+      end
+
+      if attributes.key?(:'provider')
+        self.provider = attributes[:'provider']
+      end
+
       if attributes.key?(:'error')
         self.error = attributes[:'error']
       end
@@ -162,12 +236,20 @@ module FetchHive::Generated
       return true if self.equal?(o)
       self.class == o.class &&
           type == o.type &&
-          content == o.content &&
+          response == o.response &&
           request_id == o.request_id &&
           model == o.model &&
-          tool_name == o.tool_name &&
+          done == o.done &&
+          tool_id == o.tool_id &&
+          tool == o.tool &&
+          tool_type == o.tool_type &&
           tool_input == o.tool_input &&
           observation == o.observation &&
+          stop_reason == o.stop_reason &&
+          summary_text == o.summary_text &&
+          original_token_count == o.original_token_count &&
+          context_limit == o.context_limit &&
+          provider == o.provider &&
           error == o.error &&
           usage == o.usage
     end
@@ -181,7 +263,7 @@ module FetchHive::Generated
     # 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
+      [type, response, request_id, model, done, tool_id, tool, tool_type, tool_input, observation, stop_reason, summary_text, original_token_count, context_limit, provider, error, usage].hash
     end
 
     # Builds the object from hash

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

data/lib/fetch_hive/streaming.rb

@@ -9,7 +9,10 @@ module FetchHive
   #
   #   io = response.body  # any IO or string
   #   FetchHive::Streaming.parse_sse(io) do |event|
-  #     puts event["content"] if event["type"] == "delta"
+  #     case event["type"]
+  #     when "response" then print event["response"]
+  #     when "usage"    then puts "\nUsage: #{event['usage']}"
+  #     end
   #   end
   #
   module Streaming

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fetch_hive
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  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