zavudev 0.0.2

data/lib/zavudev/resources/senders/agent/knowledge_bases.rb

@@ -0,0 +1,152 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Resources
+    class Senders
+      class Agent
+        class KnowledgeBases
+          # @return [Zavudev::Resources::Senders::Agent::KnowledgeBases::Documents]
+          attr_reader :documents
+
+          # Create a new knowledge base for an agent.
+          #
+          # @overload create(sender_id, name:, description: nil, request_options: {})
+          #
+          # @param sender_id [String]
+          # @param name [String]
+          # @param description [String]
+          # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Zavudev::Models::Senders::Agent::KnowledgeBaseCreateResponse]
+          #
+          # @see Zavudev::Models::Senders::Agent::KnowledgeBaseCreateParams
+          def create(sender_id, params)
+            parsed, options = Zavudev::Senders::Agent::KnowledgeBaseCreateParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: ["v1/senders/%1$s/agent/knowledge-bases", sender_id],
+              body: parsed,
+              model: Zavudev::Models::Senders::Agent::KnowledgeBaseCreateResponse,
+              options: options
+            )
+          end
+
+          # Get a specific knowledge base.
+          #
+          # @overload retrieve(kb_id, sender_id:, request_options: {})
+          #
+          # @param kb_id [String]
+          # @param sender_id [String]
+          # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Zavudev::Models::Senders::Agent::KnowledgeBaseRetrieveResponse]
+          #
+          # @see Zavudev::Models::Senders::Agent::KnowledgeBaseRetrieveParams
+          def retrieve(kb_id, params)
+            parsed, options = Zavudev::Senders::Agent::KnowledgeBaseRetrieveParams.dump_request(params)
+            sender_id =
+              parsed.delete(:sender_id) do
+                raise ArgumentError.new("missing required path argument #{_1}")
+              end
+            @client.request(
+              method: :get,
+              path: ["v1/senders/%1$s/agent/knowledge-bases/%2$s", sender_id, kb_id],
+              model: Zavudev::Models::Senders::Agent::KnowledgeBaseRetrieveResponse,
+              options: options
+            )
+          end
+
+          # Update a knowledge base.
+          #
+          # @overload update(kb_id, sender_id:, description: nil, name: nil, request_options: {})
+          #
+          # @param kb_id [String] Path param
+          #
+          # @param sender_id [String] Path param
+          #
+          # @param description [String, nil] Body param
+          #
+          # @param name [String] Body param
+          #
+          # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Zavudev::Models::Senders::Agent::KnowledgeBaseUpdateResponse]
+          #
+          # @see Zavudev::Models::Senders::Agent::KnowledgeBaseUpdateParams
+          def update(kb_id, params)
+            parsed, options = Zavudev::Senders::Agent::KnowledgeBaseUpdateParams.dump_request(params)
+            sender_id =
+              parsed.delete(:sender_id) do
+                raise ArgumentError.new("missing required path argument #{_1}")
+              end
+            @client.request(
+              method: :patch,
+              path: ["v1/senders/%1$s/agent/knowledge-bases/%2$s", sender_id, kb_id],
+              body: parsed,
+              model: Zavudev::Models::Senders::Agent::KnowledgeBaseUpdateResponse,
+              options: options
+            )
+          end
+
+          # List knowledge bases for an agent.
+          #
+          # @overload list(sender_id, cursor: nil, limit: nil, request_options: {})
+          #
+          # @param sender_id [String]
+          # @param cursor [String]
+          # @param limit [Integer]
+          # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Zavudev::Internal::Cursor<Zavudev::Models::Senders::Agent::AgentKnowledgeBase>]
+          #
+          # @see Zavudev::Models::Senders::Agent::KnowledgeBaseListParams
+          def list(sender_id, params = {})
+            parsed, options = Zavudev::Senders::Agent::KnowledgeBaseListParams.dump_request(params)
+            query = Zavudev::Internal::Util.encode_query_params(parsed)
+            @client.request(
+              method: :get,
+              path: ["v1/senders/%1$s/agent/knowledge-bases", sender_id],
+              query: query,
+              page: Zavudev::Internal::Cursor,
+              model: Zavudev::Senders::Agent::AgentKnowledgeBase,
+              options: options
+            )
+          end
+
+          # Delete a knowledge base and all its documents.
+          #
+          # @overload delete(kb_id, sender_id:, request_options: {})
+          #
+          # @param kb_id [String]
+          # @param sender_id [String]
+          # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [nil]
+          #
+          # @see Zavudev::Models::Senders::Agent::KnowledgeBaseDeleteParams
+          def delete(kb_id, params)
+            parsed, options = Zavudev::Senders::Agent::KnowledgeBaseDeleteParams.dump_request(params)
+            sender_id =
+              parsed.delete(:sender_id) do
+                raise ArgumentError.new("missing required path argument #{_1}")
+              end
+            @client.request(
+              method: :delete,
+              path: ["v1/senders/%1$s/agent/knowledge-bases/%2$s", sender_id, kb_id],
+              model: NilClass,
+              options: options
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Zavudev::Client]
+          def initialize(client:)
+            @client = client
+            @documents = Zavudev::Resources::Senders::Agent::KnowledgeBases::Documents.new(client: client)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/zavudev/resources/senders/agent/tools.rb

@@ -0,0 +1,198 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Resources
+    class Senders
+      class Agent
+        class Tools
+          # Create a new tool for an agent. Tools allow the agent to call external webhooks.
+          #
+          # @overload create(sender_id, description:, name:, parameters:, webhook_url:, enabled: nil, webhook_secret: nil, request_options: {})
+          #
+          # @param sender_id [String]
+          #
+          # @param description [String]
+          #
+          # @param name [String]
+          #
+          # @param parameters [Zavudev::Models::Senders::Agent::ToolCreateParams::Parameters]
+          #
+          # @param webhook_url [String] Must be HTTPS.
+          #
+          # @param enabled [Boolean]
+          #
+          # @param webhook_secret [String] Optional secret for webhook signature verification.
+          #
+          # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Zavudev::Models::Senders::Agent::ToolCreateResponse]
+          #
+          # @see Zavudev::Models::Senders::Agent::ToolCreateParams
+          def create(sender_id, params)
+            parsed, options = Zavudev::Senders::Agent::ToolCreateParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: ["v1/senders/%1$s/agent/tools", sender_id],
+              body: parsed,
+              model: Zavudev::Models::Senders::Agent::ToolCreateResponse,
+              options: options
+            )
+          end
+
+          # Get a specific tool.
+          #
+          # @overload retrieve(tool_id, sender_id:, request_options: {})
+          #
+          # @param tool_id [String]
+          # @param sender_id [String]
+          # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Zavudev::Models::Senders::Agent::ToolRetrieveResponse]
+          #
+          # @see Zavudev::Models::Senders::Agent::ToolRetrieveParams
+          def retrieve(tool_id, params)
+            parsed, options = Zavudev::Senders::Agent::ToolRetrieveParams.dump_request(params)
+            sender_id =
+              parsed.delete(:sender_id) do
+                raise ArgumentError.new("missing required path argument #{_1}")
+              end
+            @client.request(
+              method: :get,
+              path: ["v1/senders/%1$s/agent/tools/%2$s", sender_id, tool_id],
+              model: Zavudev::Models::Senders::Agent::ToolRetrieveResponse,
+              options: options
+            )
+          end
+
+          # Update a tool.
+          #
+          # @overload update(tool_id, sender_id:, description: nil, enabled: nil, name: nil, parameters: nil, webhook_secret: nil, webhook_url: nil, request_options: {})
+          #
+          # @param tool_id [String] Path param
+          #
+          # @param sender_id [String] Path param
+          #
+          # @param description [String] Body param
+          #
+          # @param enabled [Boolean] Body param
+          #
+          # @param name [String] Body param
+          #
+          # @param parameters [Zavudev::Models::Senders::Agent::ToolUpdateParams::Parameters] Body param
+          #
+          # @param webhook_secret [String, nil] Body param
+          #
+          # @param webhook_url [String] Body param
+          #
+          # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Zavudev::Models::Senders::Agent::ToolUpdateResponse]
+          #
+          # @see Zavudev::Models::Senders::Agent::ToolUpdateParams
+          def update(tool_id, params)
+            parsed, options = Zavudev::Senders::Agent::ToolUpdateParams.dump_request(params)
+            sender_id =
+              parsed.delete(:sender_id) do
+                raise ArgumentError.new("missing required path argument #{_1}")
+              end
+            @client.request(
+              method: :patch,
+              path: ["v1/senders/%1$s/agent/tools/%2$s", sender_id, tool_id],
+              body: parsed,
+              model: Zavudev::Models::Senders::Agent::ToolUpdateResponse,
+              options: options
+            )
+          end
+
+          # List tools for an agent.
+          #
+          # @overload list(sender_id, cursor: nil, enabled: nil, limit: nil, request_options: {})
+          #
+          # @param sender_id [String]
+          # @param cursor [String]
+          # @param enabled [Boolean]
+          # @param limit [Integer]
+          # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Zavudev::Internal::Cursor<Zavudev::Models::Senders::Agent::AgentTool>]
+          #
+          # @see Zavudev::Models::Senders::Agent::ToolListParams
+          def list(sender_id, params = {})
+            parsed, options = Zavudev::Senders::Agent::ToolListParams.dump_request(params)
+            query = Zavudev::Internal::Util.encode_query_params(parsed)
+            @client.request(
+              method: :get,
+              path: ["v1/senders/%1$s/agent/tools", sender_id],
+              query: query,
+              page: Zavudev::Internal::Cursor,
+              model: Zavudev::Senders::Agent::AgentTool,
+              options: options
+            )
+          end
+
+          # Delete a tool.
+          #
+          # @overload delete(tool_id, sender_id:, request_options: {})
+          #
+          # @param tool_id [String]
+          # @param sender_id [String]
+          # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [nil]
+          #
+          # @see Zavudev::Models::Senders::Agent::ToolDeleteParams
+          def delete(tool_id, params)
+            parsed, options = Zavudev::Senders::Agent::ToolDeleteParams.dump_request(params)
+            sender_id =
+              parsed.delete(:sender_id) do
+                raise ArgumentError.new("missing required path argument #{_1}")
+              end
+            @client.request(
+              method: :delete,
+              path: ["v1/senders/%1$s/agent/tools/%2$s", sender_id, tool_id],
+              model: NilClass,
+              options: options
+            )
+          end
+
+          # Test a tool by triggering its webhook with test parameters.
+          #
+          # @overload test_(tool_id, sender_id:, test_params:, request_options: {})
+          #
+          # @param tool_id [String] Path param
+          #
+          # @param sender_id [String] Path param
+          #
+          # @param test_params [Hash{Symbol=>Object}] Body param: Parameters to pass to the tool for testing.
+          #
+          # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Zavudev::Models::Senders::Agent::ToolTestResponse]
+          #
+          # @see Zavudev::Models::Senders::Agent::ToolTestParams
+          def test_(tool_id, params)
+            parsed, options = Zavudev::Senders::Agent::ToolTestParams.dump_request(params)
+            sender_id =
+              parsed.delete(:sender_id) do
+                raise ArgumentError.new("missing required path argument #{_1}")
+              end
+            @client.request(
+              method: :post,
+              path: ["v1/senders/%1$s/agent/tools/%2$s/test", sender_id, tool_id],
+              body: parsed,
+              model: Zavudev::Models::Senders::Agent::ToolTestResponse,
+              options: options
+            )
+          end
+
+          # @api private
+          #
+          # @param client [Zavudev::Client]
+          def initialize(client:)
+            @client = client
+          end
+        end
+      end
+    end
+  end
+end

data/lib/zavudev/resources/senders/agent.rb

@@ -0,0 +1,179 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Resources
+    class Senders
+      class Agent
+        # @return [Zavudev::Resources::Senders::Agent::Executions]
+        attr_reader :executions
+
+        # @return [Zavudev::Resources::Senders::Agent::Flows]
+        attr_reader :flows
+
+        # @return [Zavudev::Resources::Senders::Agent::Tools]
+        attr_reader :tools
+
+        # @return [Zavudev::Resources::Senders::Agent::KnowledgeBases]
+        attr_reader :knowledge_bases
+
+        # Create an AI agent for a sender. Each sender can have at most one agent.
+        #
+        # @overload create(sender_id, model:, name:, provider:, system_prompt:, api_key: nil, context_window_messages: nil, include_contact_metadata: nil, max_tokens: nil, temperature: nil, trigger_on_channels: nil, trigger_on_message_types: nil, request_options: {})
+        #
+        # @param sender_id [String]
+        #
+        # @param model [String]
+        #
+        # @param name [String]
+        #
+        # @param provider [Symbol, Zavudev::Models::Senders::AgentProvider] LLM provider for the AI agent.
+        #
+        # @param system_prompt [String]
+        #
+        # @param api_key [String] API key for the LLM provider. Required unless provider is 'zavu'.
+        #
+        # @param context_window_messages [Integer]
+        #
+        # @param include_contact_metadata [Boolean]
+        #
+        # @param max_tokens [Integer]
+        #
+        # @param temperature [Float]
+        #
+        # @param trigger_on_channels [Array<String>]
+        #
+        # @param trigger_on_message_types [Array<String>]
+        #
+        # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Zavudev::Models::Senders::AgentResponse]
+        #
+        # @see Zavudev::Models::Senders::AgentCreateParams
+        def create(sender_id, params)
+          parsed, options = Zavudev::Senders::AgentCreateParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["v1/senders/%1$s/agent", sender_id],
+            body: parsed,
+            model: Zavudev::Senders::AgentResponse,
+            options: options
+          )
+        end
+
+        # Get the AI agent configuration for a sender.
+        #
+        # @overload retrieve(sender_id, request_options: {})
+        #
+        # @param sender_id [String]
+        # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Zavudev::Models::Senders::AgentResponse]
+        #
+        # @see Zavudev::Models::Senders::AgentRetrieveParams
+        def retrieve(sender_id, params = {})
+          @client.request(
+            method: :get,
+            path: ["v1/senders/%1$s/agent", sender_id],
+            model: Zavudev::Senders::AgentResponse,
+            options: params[:request_options]
+          )
+        end
+
+        # Update an AI agent's configuration.
+        #
+        # @overload update(sender_id, api_key: nil, context_window_messages: nil, enabled: nil, include_contact_metadata: nil, max_tokens: nil, model: nil, name: nil, provider: nil, system_prompt: nil, temperature: nil, trigger_on_channels: nil, trigger_on_message_types: nil, request_options: {})
+        #
+        # @param sender_id [String]
+        #
+        # @param api_key [String]
+        #
+        # @param context_window_messages [Integer]
+        #
+        # @param enabled [Boolean]
+        #
+        # @param include_contact_metadata [Boolean]
+        #
+        # @param max_tokens [Integer, nil]
+        #
+        # @param model [String]
+        #
+        # @param name [String]
+        #
+        # @param provider [Symbol, Zavudev::Models::Senders::AgentProvider] LLM provider for the AI agent.
+        #
+        # @param system_prompt [String]
+        #
+        # @param temperature [Float, nil]
+        #
+        # @param trigger_on_channels [Array<String>]
+        #
+        # @param trigger_on_message_types [Array<String>]
+        #
+        # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Zavudev::Models::Senders::AgentResponse]
+        #
+        # @see Zavudev::Models::Senders::AgentUpdateParams
+        def update(sender_id, params = {})
+          parsed, options = Zavudev::Senders::AgentUpdateParams.dump_request(params)
+          @client.request(
+            method: :patch,
+            path: ["v1/senders/%1$s/agent", sender_id],
+            body: parsed,
+            model: Zavudev::Senders::AgentResponse,
+            options: options
+          )
+        end
+
+        # Delete an AI agent.
+        #
+        # @overload delete(sender_id, request_options: {})
+        #
+        # @param sender_id [String]
+        # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [nil]
+        #
+        # @see Zavudev::Models::Senders::AgentDeleteParams
+        def delete(sender_id, params = {})
+          @client.request(
+            method: :delete,
+            path: ["v1/senders/%1$s/agent", sender_id],
+            model: NilClass,
+            options: params[:request_options]
+          )
+        end
+
+        # Get statistics for an AI agent including invocations, tokens, and costs.
+        #
+        # @overload stats(sender_id, request_options: {})
+        #
+        # @param sender_id [String]
+        # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Zavudev::Models::Senders::AgentStats]
+        #
+        # @see Zavudev::Models::Senders::AgentStatsParams
+        def stats(sender_id, params = {})
+          @client.request(
+            method: :get,
+            path: ["v1/senders/%1$s/agent/stats", sender_id],
+            model: Zavudev::Senders::AgentStats,
+            options: params[:request_options]
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Zavudev::Client]
+        def initialize(client:)
+          @client = client
+          @executions = Zavudev::Resources::Senders::Agent::Executions.new(client: client)
+          @flows = Zavudev::Resources::Senders::Agent::Flows.new(client: client)
+          @tools = Zavudev::Resources::Senders::Agent::Tools.new(client: client)
+          @knowledge_bases = Zavudev::Resources::Senders::Agent::KnowledgeBases.new(client: client)
+        end
+      end
+    end
+  end
+end