fetch_hive 0.2.6 → 0.2.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7760482919ce2feb3197e4cbe8f73efc81a672668938cb4f9b1b6017c5cea6dc
-  data.tar.gz: 3c251a7fa8e2ddea542d6363db19cd86c31b748fe056614dc13fa0e1a79dd0a2
+  metadata.gz: eb9434ab93e434f4b25afe94d6b79f080645ae4d728df7d0f361b6b9f9bb2799
+  data.tar.gz: ff40c6e5fa1af76eded3851936963413f434ade2d2973dbfa9345033c69ccdc0
 SHA512:
-  metadata.gz: 014e9838b7f7d2d41cad048485d1c02748149ab02be7eaf0408fb544b2d9fc756c8bfec9fa895a4d7791a622b345204bdb676e8011d55f8eb0fb026c76620f7a
-  data.tar.gz: f64c3c03618b44cd73e5d4249d5fa32b247911ab9820d7677e1ce5ef46e8102bfd0f8ad58d4a92f48f6919e5ac57da4de65e7043c22ab542ffff980f02c6cfea
+  metadata.gz: 163396220e9d5a22f61192650659667b2c2a7f2630f91c9107e813b19b7581c32b60673140aaa80b13b6d52784ef75d0082fc95581a1b4f33cb538fc878d67c2
+  data.tar.gz: c15054576375f4fba9946e8c5412f83afbec7ae33de1bc342857724aec7c558ca234ac2cc335ad958b2063f6339cab4920775648b82d77107a4840937f9cc2f1

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.6"
+gem "fetch_hive", "~> 0.2.9"
 ```
 
 Then run:
@@ -149,7 +149,7 @@ client = FetchHive::Client.new  # picks up FETCH_HIVE_API_KEY automatically
 
 ## Version
 
-0.2.6
+0.2.9
 
 ## License
 

data/lib/fetch_hive/client.rb

@@ -48,7 +48,7 @@ module FetchHive
       body[:inputs]  = inputs  if inputs
       body[:user]    = user    if user
       body[:metadata] = metadata if metadata
-      post("/invoke", body)
+      post("/prompt/invoke", body)
     end
 
     # Invoke a prompt deployment and stream SSE events.
@@ -59,7 +59,7 @@ module FetchHive
       body[:inputs]  = inputs  if inputs
       body[:user]    = user    if user
       body[:metadata] = metadata if metadata
-      post_stream("/invoke", body, &block)
+      post_stream("/prompt/invoke", body, &block)
     end
 
     # ── Workflow ────────────────────────────────────────────────────────────────
@@ -81,28 +81,161 @@ 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, metadata: nil, messages: nil, image_urls: nil)
+    def invoke_agent(agent:, message:, thread_id: nil, user: nil, metadata: nil, messages: nil, image_urls: nil, attachments: nil, known_artifact_refs: nil, artifact_refs: nil, async: 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
+      body[:attachments] = attachments || image_urls if attachments || image_urls
+      body[:known_artifact_refs] = known_artifact_refs if known_artifact_refs
+      body[:artifact_refs] = artifact_refs if artifact_refs
+      body[:async] = async if async
       post("/agent/invoke", body)
     end
 
     # 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, metadata: 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, attachments: nil, known_artifact_refs: nil, artifact_refs: 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
+      body[:attachments] = attachments || image_urls if attachments || image_urls
+      body[:known_artifact_refs] = known_artifact_refs if known_artifact_refs
+      body[:artifact_refs] = artifact_refs if artifact_refs
       post_stream("/agent/invoke", body, &block)
     end
 
+    # ── Hive Agent ──────────────────────────────────────────────────────────────
+
+    # Start a Hive Agent run asynchronously. Requires a callback URL.
+    def invoke_hive_agent(hive_agent:, objective:, callback_url:, sources: nil, metadata: nil, unattended: nil, budget_policy: nil)
+      raise ArgumentError, "callback_url is required for Hive Agent invocation" if callback_url.nil? || callback_url.to_s.strip.empty?
+
+      body = {
+        hive_agent: hive_agent,
+        objective: objective,
+        async: { enabled: true, callback_url: callback_url }
+      }
+      body[:sources] = sources if sources
+      body[:metadata] = metadata if metadata
+      body[:unattended] = unattended unless unattended.nil?
+      body[:budget_policy] = budget_policy if budget_policy
+      post("/hive-agent/invoke", body)
+    end
+
+    # ── Public resources ────────────────────────────────────────────────────────
+
+    def get_request(id:)
+      request("GET", "/public/requests/#{id}")
+    end
+
+    def get_agent_delegation(id:)
+      request("GET", "/agent/delegations/#{id}")
+    end
+
+    def cancel_agent_delegation(id:)
+      post("/agent/delegations/#{id}/cancel", {})
+    end
+
+    def list_thread_delegations(thread_id:)
+      request("GET", "/agent/threads/#{thread_id}/delegations")
+    end
+
+    def list_knowledge_bases(workspace_id:)
+      request("GET", "/public/workspaces/#{workspace_id}/knowledge_bases")
+    end
+
+    def get_knowledge_base(workspace_id:, id:)
+      request("GET", "/public/workspaces/#{workspace_id}/knowledge_bases/#{id}")
+    end
+
+    def create_knowledge_base(workspace_id:, knowledge_base:)
+      post("/public/workspaces/#{workspace_id}/knowledge_bases", { knowledge_base: knowledge_base })
+    end
+
+    def update_knowledge_base(workspace_id:, id:, knowledge_base:)
+      request("PATCH", "/public/workspaces/#{workspace_id}/knowledge_bases/#{id}", { knowledge_base: knowledge_base })
+    end
+
+    def delete_knowledge_base(workspace_id:, id:)
+      request("DELETE", "/public/workspaces/#{workspace_id}/knowledge_bases/#{id}")
+    end
+
+    def search_knowledge_base(workspace_id:, id:, **params)
+      post("/public/workspaces/#{workspace_id}/knowledge_bases/#{id}/search", params)
+    end
+
+    def list_knowledge_base_items(workspace_id:, knowledge_base_id:)
+      request("GET", "/public/workspaces/#{workspace_id}/knowledge_bases/#{knowledge_base_id}/items")
+    end
+
+    def get_knowledge_base_item(workspace_id:, knowledge_base_id:, id:)
+      request("GET", "/public/workspaces/#{workspace_id}/knowledge_bases/#{knowledge_base_id}/items/#{id}")
+    end
+
+    def create_knowledge_base_item(workspace_id:, knowledge_base_id:, knowledge_base_item:)
+      post("/public/workspaces/#{workspace_id}/knowledge_bases/#{knowledge_base_id}/items", { knowledge_base_item: knowledge_base_item })
+    end
+
+    def update_knowledge_base_item(workspace_id:, knowledge_base_id:, id:, knowledge_base_item:)
+      request("PATCH", "/public/workspaces/#{workspace_id}/knowledge_bases/#{knowledge_base_id}/items/#{id}", { knowledge_base_item: knowledge_base_item })
+    end
+
+    def delete_knowledge_base_item(workspace_id:, knowledge_base_id:, id:)
+      request("DELETE", "/public/workspaces/#{workspace_id}/knowledge_bases/#{knowledge_base_id}/items/#{id}")
+    end
+
+    def regenerate_knowledge_base_item(workspace_id:, knowledge_base_id:, id:)
+      post("/public/workspaces/#{workspace_id}/knowledge_bases/#{knowledge_base_id}/items/#{id}/regenerate", {})
+    end
+
+    def list_agents(workspace_id:)
+      request("GET", "/public/workspaces/#{workspace_id}/agents")
+    end
+
+    def get_agent(workspace_id:, id:)
+      request("GET", "/public/workspaces/#{workspace_id}/agents/#{id}")
+    end
+
+    def create_agent(workspace_id:, agent:)
+      post("/public/workspaces/#{workspace_id}/agents", { agent: agent })
+    end
+
+    def update_agent(workspace_id:, id:, agent:)
+      request("PATCH", "/public/workspaces/#{workspace_id}/agents/#{id}", { agent: agent })
+    end
+
+    def delete_agent(workspace_id:, id:)
+      request("DELETE", "/public/workspaces/#{workspace_id}/agents/#{id}")
+    end
+
+    def get_agent_chat(workspace_id:, agent_id:, chat_id:)
+      request("GET", "/public/workspaces/#{workspace_id}/agents/#{agent_id}/chats/#{chat_id}")
+    end
+
+    def create_agent_chat(workspace_id:, agent_id:, chat:)
+      post("/public/workspaces/#{workspace_id}/agents/#{agent_id}/chats", { chat: chat })
+    end
+
+    def update_agent_chat(workspace_id:, agent_id:, chat_id:, chat:)
+      request("PATCH", "/public/workspaces/#{workspace_id}/agents/#{agent_id}/chats/#{chat_id}", { chat: chat })
+    end
+
+    def delete_agent_chat(workspace_id:, agent_id:, chat_id:)
+      request("DELETE", "/public/workspaces/#{workspace_id}/agents/#{agent_id}/chats/#{chat_id}")
+    end
+
+    def clear_agent_chat_messages(workspace_id:, agent_id:, chat_id:)
+      request("PATCH", "/public/workspaces/#{workspace_id}/agents/#{agent_id}/chats/#{chat_id}/clear_messages", {})
+    end
+
+    def list_agent_chat_messages(workspace_id:, agent_id:, chat_id:)
+      request("GET", "/public/workspaces/#{workspace_id}/agents/#{agent_id}/chats/#{chat_id}/messages")
+    end
+
     private
 
     def default_headers
@@ -113,17 +246,25 @@ module FetchHive
     end
 
     def connection
-      Faraday.new(url: @base_url, request: { timeout: @timeout }) do |f|
+      # Build Faraday without a url prefix. Absolute paths like `/prompt/invoke`
+      # replace Faraday's prefix path (`/v1`), which would drop `/v1` from the URL.
+      Faraday.new(request: { timeout: @timeout }) do |f|
         f.adapter Faraday.default_adapter
       end
     end
 
+    def full_url(path)
+      "#{@base_url}#{path}"
+    end
+
     def post(path, body)
-      resp = connection.post(path) do |req|
-        req.headers.merge!(default_headers)
-        req.body = JSON.generate(body)
-      end
+      request("POST", path, body)
+    end
+
+    def request(method, path, body = nil)
+      resp = connection.run_request(method.downcase.to_sym, full_url(path), body && JSON.generate(body), default_headers)
       raise "FetchHive API error #{resp.status}: #{resp.body}" unless resp.success?
+      return {} if resp.body.nil? || resp.body.empty?
 
       JSON.parse(resp.body)
     end
@@ -134,11 +275,11 @@ module FetchHive
       io, writer = IO.pipe
 
       thread = Thread.new do
-        conn = Faraday.new(url: @base_url, request: { timeout: @timeout }) do |f|
+        conn = Faraday.new(request: { timeout: @timeout }) do |f|
           f.adapter Faraday.default_adapter
         end
 
-        resp = conn.post(path) do |req|
+        resp = conn.post(full_url(path)) do |req|
           req.headers.merge!(default_headers)
           req.body = JSON.generate(body)
           req.options.on_data = proc do |chunk, _size, env|

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

@@ -0,0 +1,97 @@
+=begin
+#Fetch Hive Public API
+
+#The Fetch Hive public API lets you invoke prompts, workflows, agents, and Hive 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.9
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.22.0
+
+=end
+
+require 'cgi'
+
+module FetchHive::Generated
+  class AgentChatMessagesApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # List messages in a chat
+    # Returns messages in the chat ordered chronologically (oldest first).
+    # @param workspace_id [String] Workspace UUID
+    # @param agent_id [String] Agent UUID
+    # @param chat_id [String] Chat UUID
+    # @param [Hash] opts the optional parameters
+    # @return [GetPublicWorkspacesAgentsChatsMessages200Response]
+    def get_public_workspaces_agents_chats_messages(workspace_id, agent_id, chat_id, opts = {})
+      data, _status_code, _headers = get_public_workspaces_agents_chats_messages_with_http_info(workspace_id, agent_id, chat_id, opts)
+      data
+    end
+
+    # List messages in a chat
+    # Returns messages in the chat ordered chronologically (oldest first).
+    # @param workspace_id [String] Workspace UUID
+    # @param agent_id [String] Agent UUID
+    # @param chat_id [String] Chat UUID
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(GetPublicWorkspacesAgentsChatsMessages200Response, Integer, Hash)>] GetPublicWorkspacesAgentsChatsMessages200Response data, response status code and response headers
+    def get_public_workspaces_agents_chats_messages_with_http_info(workspace_id, agent_id, chat_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AgentChatMessagesApi.get_public_workspaces_agents_chats_messages ...'
+      end
+      # verify the required parameter 'workspace_id' is set
+      if @api_client.config.client_side_validation && workspace_id.nil?
+        fail ArgumentError, "Missing the required parameter 'workspace_id' when calling AgentChatMessagesApi.get_public_workspaces_agents_chats_messages"
+      end
+      # verify the required parameter 'agent_id' is set
+      if @api_client.config.client_side_validation && agent_id.nil?
+        fail ArgumentError, "Missing the required parameter 'agent_id' when calling AgentChatMessagesApi.get_public_workspaces_agents_chats_messages"
+      end
+      # verify the required parameter 'chat_id' is set
+      if @api_client.config.client_side_validation && chat_id.nil?
+        fail ArgumentError, "Missing the required parameter 'chat_id' when calling AgentChatMessagesApi.get_public_workspaces_agents_chats_messages"
+      end
+      # resource path
+      local_var_path = '/public/workspaces/{workspace_id}/agents/{agent_id}/chats/{chat_id}/messages'.sub('{workspace_id}', CGI.escape(workspace_id.to_s)).sub('{agent_id}', CGI.escape(agent_id.to_s)).sub('{chat_id}', CGI.escape(chat_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'GetPublicWorkspacesAgentsChatsMessages200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearer_auth']
+
+      new_options = opts.merge(
+        :operation => :"AgentChatMessagesApi.get_public_workspaces_agents_chats_messages",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AgentChatMessagesApi#get_public_workspaces_agents_chats_messages\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end