zavudev 0.0.2

data/lib/zavudev/resources/phone_numbers.rb

@@ -0,0 +1,187 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Resources
+    class PhoneNumbers
+      # Get details of a specific phone number.
+      #
+      # @overload retrieve(phone_number_id, request_options: {})
+      #
+      # @param phone_number_id [String]
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::PhoneNumberRetrieveResponse]
+      #
+      # @see Zavudev::Models::PhoneNumberRetrieveParams
+      def retrieve(phone_number_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/phone-numbers/%1$s", phone_number_id],
+          model: Zavudev::Models::PhoneNumberRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Update a phone number's name or sender assignment.
+      #
+      # @overload update(phone_number_id, name: nil, sender_id: nil, request_options: {})
+      #
+      # @param phone_number_id [String]
+      #
+      # @param name [String, nil] Custom name for the phone number. Set to null to clear.
+      #
+      # @param sender_id [String, nil] Sender ID to assign the phone number to. Set to null to unassign.
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::PhoneNumberUpdateResponse]
+      #
+      # @see Zavudev::Models::PhoneNumberUpdateParams
+      def update(phone_number_id, params = {})
+        parsed, options = Zavudev::PhoneNumberUpdateParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["v1/phone-numbers/%1$s", phone_number_id],
+          body: parsed,
+          model: Zavudev::Models::PhoneNumberUpdateResponse,
+          options: options
+        )
+      end
+
+      # List all phone numbers owned by this project.
+      #
+      # @overload list(cursor: nil, limit: nil, status: nil, request_options: {})
+      #
+      # @param cursor [String] Pagination cursor.
+      #
+      # @param limit [Integer]
+      #
+      # @param status [Symbol, Zavudev::Models::PhoneNumberStatus] Filter by phone number status.
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Internal::Cursor<Zavudev::Models::OwnedPhoneNumber>]
+      #
+      # @see Zavudev::Models::PhoneNumberListParams
+      def list(params = {})
+        parsed, options = Zavudev::PhoneNumberListParams.dump_request(params)
+        query = Zavudev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "v1/phone-numbers",
+          query: query,
+          page: Zavudev::Internal::Cursor,
+          model: Zavudev::OwnedPhoneNumber,
+          options: options
+        )
+      end
+
+      # Purchase an available phone number. The first US phone number is free for each
+      # team.
+      #
+      # @overload purchase(phone_number:, name: nil, request_options: {})
+      #
+      # @param phone_number [String] Phone number in E.164 format.
+      #
+      # @param name [String] Optional custom name for the phone number.
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::PhoneNumberPurchaseResponse]
+      #
+      # @see Zavudev::Models::PhoneNumberPurchaseParams
+      def purchase(params)
+        parsed, options = Zavudev::PhoneNumberPurchaseParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "v1/phone-numbers",
+          body: parsed,
+          model: Zavudev::Models::PhoneNumberPurchaseResponse,
+          options: options
+        )
+      end
+
+      # Release a phone number. The phone number must not be assigned to a sender.
+      #
+      # @overload release(phone_number_id, request_options: {})
+      #
+      # @param phone_number_id [String]
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see Zavudev::Models::PhoneNumberReleaseParams
+      def release(phone_number_id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["v1/phone-numbers/%1$s", phone_number_id],
+          model: NilClass,
+          options: params[:request_options]
+        )
+      end
+
+      # Get regulatory requirements for purchasing phone numbers in a specific country.
+      # Some countries require additional documentation (addresses, identity documents)
+      # before phone numbers can be activated.
+      #
+      # @overload requirements(country_code:, type: nil, request_options: {})
+      #
+      # @param country_code [String] Two-letter ISO country code.
+      #
+      # @param type [Symbol, Zavudev::Models::PhoneNumberType] Type of phone number (local, mobile, tollFree).
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::PhoneNumberRequirementsResponse]
+      #
+      # @see Zavudev::Models::PhoneNumberRequirementsParams
+      def requirements(params)
+        parsed, options = Zavudev::PhoneNumberRequirementsParams.dump_request(params)
+        query = Zavudev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "v1/phone-numbers/requirements",
+          query: query.transform_keys(country_code: "countryCode"),
+          model: Zavudev::Models::PhoneNumberRequirementsResponse,
+          options: options
+        )
+      end
+
+      # Search for available phone numbers to purchase by country and type.
+      #
+      # @overload search_available(country_code:, contains: nil, limit: nil, type: nil, request_options: {})
+      #
+      # @param country_code [String] Two-letter ISO country code.
+      #
+      # @param contains [String] Search for numbers containing this string.
+      #
+      # @param limit [Integer] Maximum number of results to return.
+      #
+      # @param type [Symbol, Zavudev::Models::PhoneNumberType] Type of phone number to search for.
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::PhoneNumberSearchAvailableResponse]
+      #
+      # @see Zavudev::Models::PhoneNumberSearchAvailableParams
+      def search_available(params)
+        parsed, options = Zavudev::PhoneNumberSearchAvailableParams.dump_request(params)
+        query = Zavudev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "v1/phone-numbers/available",
+          query: query.transform_keys(country_code: "countryCode"),
+          model: Zavudev::Models::PhoneNumberSearchAvailableResponse,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Zavudev::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/zavudev/resources/regulatory_documents.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Resources
+    class RegulatoryDocuments
+      # Create a regulatory document record after uploading the file. Use the upload-url
+      # endpoint first to get an upload URL.
+      #
+      # @overload create(document_type:, file_size:, mime_type:, name:, storage_id:, request_options: {})
+      #
+      # @param document_type [Symbol, Zavudev::Models::RegulatoryDocumentCreateParams::DocumentType]
+      #
+      # @param file_size [Integer]
+      #
+      # @param mime_type [String]
+      #
+      # @param name [String]
+      #
+      # @param storage_id [String] Storage ID from the upload-url endpoint.
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::RegulatoryDocumentCreateResponse]
+      #
+      # @see Zavudev::Models::RegulatoryDocumentCreateParams
+      def create(params)
+        parsed, options = Zavudev::RegulatoryDocumentCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "v1/documents",
+          body: parsed,
+          model: Zavudev::Models::RegulatoryDocumentCreateResponse,
+          options: options
+        )
+      end
+
+      # Get a specific regulatory document.
+      #
+      # @overload retrieve(document_id, request_options: {})
+      #
+      # @param document_id [String]
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::RegulatoryDocumentRetrieveResponse]
+      #
+      # @see Zavudev::Models::RegulatoryDocumentRetrieveParams
+      def retrieve(document_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/documents/%1$s", document_id],
+          model: Zavudev::Models::RegulatoryDocumentRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # List regulatory documents for this project.
+      #
+      # @overload list(cursor: nil, limit: nil, request_options: {})
+      #
+      # @param cursor [String]
+      # @param limit [Integer]
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Internal::Cursor<Zavudev::Models::RegulatoryDocument>]
+      #
+      # @see Zavudev::Models::RegulatoryDocumentListParams
+      def list(params = {})
+        parsed, options = Zavudev::RegulatoryDocumentListParams.dump_request(params)
+        query = Zavudev::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "v1/documents",
+          query: query,
+          page: Zavudev::Internal::Cursor,
+          model: Zavudev::RegulatoryDocument,
+          options: options
+        )
+      end
+
+      # Delete a regulatory document. Cannot delete verified documents.
+      #
+      # @overload delete(document_id, request_options: {})
+      #
+      # @param document_id [String]
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see Zavudev::Models::RegulatoryDocumentDeleteParams
+      def delete(document_id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["v1/documents/%1$s", document_id],
+          model: NilClass,
+          options: params[:request_options]
+        )
+      end
+
+      # Get a presigned URL to upload a document file. After uploading, use the
+      # storageId to create the document record.
+      #
+      # @overload upload_url(request_options: {})
+      #
+      # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Zavudev::Models::RegulatoryDocumentUploadURLResponse]
+      #
+      # @see Zavudev::Models::RegulatoryDocumentUploadURLParams
+      def upload_url(params = {})
+        @client.request(
+          method: :post,
+          path: "v1/documents/upload-url",
+          model: Zavudev::Models::RegulatoryDocumentUploadURLResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Zavudev::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

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

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Resources
+    class Senders
+      class Agent
+        class Executions
+          # List recent agent executions with pagination.
+          #
+          # @overload list(sender_id, cursor: nil, limit: nil, status: nil, request_options: {})
+          #
+          # @param sender_id [String]
+          #
+          # @param cursor [String]
+          #
+          # @param limit [Integer]
+          #
+          # @param status [Symbol, Zavudev::Models::Senders::AgentExecutionStatus] Status of an agent execution.
+          #
+          # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Zavudev::Internal::Cursor<Zavudev::Models::Senders::AgentExecution>]
+          #
+          # @see Zavudev::Models::Senders::Agent::ExecutionListParams
+          def list(sender_id, params = {})
+            parsed, options = Zavudev::Senders::Agent::ExecutionListParams.dump_request(params)
+            query = Zavudev::Internal::Util.encode_query_params(parsed)
+            @client.request(
+              method: :get,
+              path: ["v1/senders/%1$s/agent/executions", sender_id],
+              query: query,
+              page: Zavudev::Internal::Cursor,
+              model: Zavudev::Senders::AgentExecution,
+              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/flows.rb

@@ -0,0 +1,191 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Resources
+    class Senders
+      class Agent
+        class Flows
+          # Create a new flow for an agent.
+          #
+          # @overload create(sender_id, name:, steps:, trigger:, description: nil, enabled: nil, priority: nil, request_options: {})
+          #
+          # @param sender_id [String]
+          # @param name [String]
+          # @param steps [Array<Zavudev::Models::Senders::Agent::FlowCreateParams::Step>]
+          # @param trigger [Zavudev::Models::Senders::Agent::FlowCreateParams::Trigger]
+          # @param description [String]
+          # @param enabled [Boolean]
+          # @param priority [Integer]
+          # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Zavudev::Models::Senders::Agent::FlowCreateResponse]
+          #
+          # @see Zavudev::Models::Senders::Agent::FlowCreateParams
+          def create(sender_id, params)
+            parsed, options = Zavudev::Senders::Agent::FlowCreateParams.dump_request(params)
+            @client.request(
+              method: :post,
+              path: ["v1/senders/%1$s/agent/flows", sender_id],
+              body: parsed,
+              model: Zavudev::Models::Senders::Agent::FlowCreateResponse,
+              options: options
+            )
+          end
+
+          # Get a specific flow.
+          #
+          # @overload retrieve(flow_id, sender_id:, request_options: {})
+          #
+          # @param flow_id [String]
+          # @param sender_id [String]
+          # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Zavudev::Models::Senders::Agent::FlowRetrieveResponse]
+          #
+          # @see Zavudev::Models::Senders::Agent::FlowRetrieveParams
+          def retrieve(flow_id, params)
+            parsed, options = Zavudev::Senders::Agent::FlowRetrieveParams.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/flows/%2$s", sender_id, flow_id],
+              model: Zavudev::Models::Senders::Agent::FlowRetrieveResponse,
+              options: options
+            )
+          end
+
+          # Update a flow.
+          #
+          # @overload update(flow_id, sender_id:, description: nil, enabled: nil, name: nil, priority: nil, steps: nil, trigger: nil, request_options: {})
+          #
+          # @param flow_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 priority [Integer] Body param
+          #
+          # @param steps [Array<Zavudev::Models::Senders::Agent::FlowUpdateParams::Step>] Body param
+          #
+          # @param trigger [Zavudev::Models::Senders::Agent::FlowUpdateParams::Trigger] Body param
+          #
+          # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Zavudev::Models::Senders::Agent::FlowUpdateResponse]
+          #
+          # @see Zavudev::Models::Senders::Agent::FlowUpdateParams
+          def update(flow_id, params)
+            parsed, options = Zavudev::Senders::Agent::FlowUpdateParams.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/flows/%2$s", sender_id, flow_id],
+              body: parsed,
+              model: Zavudev::Models::Senders::Agent::FlowUpdateResponse,
+              options: options
+            )
+          end
+
+          # List flows 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::AgentFlow>]
+          #
+          # @see Zavudev::Models::Senders::Agent::FlowListParams
+          def list(sender_id, params = {})
+            parsed, options = Zavudev::Senders::Agent::FlowListParams.dump_request(params)
+            query = Zavudev::Internal::Util.encode_query_params(parsed)
+            @client.request(
+              method: :get,
+              path: ["v1/senders/%1$s/agent/flows", sender_id],
+              query: query,
+              page: Zavudev::Internal::Cursor,
+              model: Zavudev::Senders::Agent::AgentFlow,
+              options: options
+            )
+          end
+
+          # Delete a flow. Cannot delete flows with active sessions.
+          #
+          # @overload delete(flow_id, sender_id:, request_options: {})
+          #
+          # @param flow_id [String]
+          # @param sender_id [String]
+          # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [nil]
+          #
+          # @see Zavudev::Models::Senders::Agent::FlowDeleteParams
+          def delete(flow_id, params)
+            parsed, options = Zavudev::Senders::Agent::FlowDeleteParams.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/flows/%2$s", sender_id, flow_id],
+              model: NilClass,
+              options: options
+            )
+          end
+
+          # Create a copy of an existing flow with a new name.
+          #
+          # @overload duplicate(flow_id, sender_id:, new_name:, request_options: {})
+          #
+          # @param flow_id [String] Path param
+          #
+          # @param sender_id [String] Path param
+          #
+          # @param new_name [String] Body param
+          #
+          # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+          #
+          # @return [Zavudev::Models::Senders::Agent::FlowDuplicateResponse]
+          #
+          # @see Zavudev::Models::Senders::Agent::FlowDuplicateParams
+          def duplicate(flow_id, params)
+            parsed, options = Zavudev::Senders::Agent::FlowDuplicateParams.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/flows/%2$s/duplicate", sender_id, flow_id],
+              body: parsed,
+              model: Zavudev::Models::Senders::Agent::FlowDuplicateResponse,
+              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/knowledge_bases/documents.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+module Zavudev
+  module Resources
+    class Senders
+      class Agent
+        class KnowledgeBases
+          class Documents
+            # Add a document to a knowledge base. The document will be automatically processed
+            # for RAG.
+            #
+            # @overload create(kb_id, sender_id:, content:, title:, request_options: {})
+            #
+            # @param kb_id [String] Path param
+            #
+            # @param sender_id [String] Path param
+            #
+            # @param content [String] Body param
+            #
+            # @param title [String] Body param
+            #
+            # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [Zavudev::Models::Senders::Agent::KnowledgeBases::DocumentCreateResponse]
+            #
+            # @see Zavudev::Models::Senders::Agent::KnowledgeBases::DocumentCreateParams
+            def create(kb_id, params)
+              parsed, options = Zavudev::Senders::Agent::KnowledgeBases::DocumentCreateParams.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/knowledge-bases/%2$s/documents", sender_id, kb_id],
+                body: parsed,
+                model: Zavudev::Models::Senders::Agent::KnowledgeBases::DocumentCreateResponse,
+                options: options
+              )
+            end
+
+            # List documents in a knowledge base.
+            #
+            # @overload list(kb_id, sender_id:, cursor: nil, limit: nil, request_options: {})
+            #
+            # @param kb_id [String] Path param
+            #
+            # @param sender_id [String] Path param
+            #
+            # @param cursor [String] Query param
+            #
+            # @param limit [Integer] Query param
+            #
+            # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [Zavudev::Internal::Cursor<Zavudev::Models::Senders::Agent::AgentDocument>]
+            #
+            # @see Zavudev::Models::Senders::Agent::KnowledgeBases::DocumentListParams
+            def list(kb_id, params)
+              parsed, options = Zavudev::Senders::Agent::KnowledgeBases::DocumentListParams.dump_request(params)
+              query = Zavudev::Internal::Util.encode_query_params(parsed)
+              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/documents", sender_id, kb_id],
+                query: query,
+                page: Zavudev::Internal::Cursor,
+                model: Zavudev::Senders::Agent::AgentDocument,
+                options: options
+              )
+            end
+
+            # Delete a document from a knowledge base.
+            #
+            # @overload delete(doc_id, sender_id:, kb_id:, request_options: {})
+            #
+            # @param doc_id [String]
+            # @param sender_id [String]
+            # @param kb_id [String]
+            # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
+            #
+            # @return [nil]
+            #
+            # @see Zavudev::Models::Senders::Agent::KnowledgeBases::DocumentDeleteParams
+            def delete(doc_id, params)
+              parsed, options = Zavudev::Senders::Agent::KnowledgeBases::DocumentDeleteParams.dump_request(params)
+              sender_id =
+                parsed.delete(:sender_id) do
+                  raise ArgumentError.new("missing required path argument #{_1}")
+                end
+              kb_id =
+                parsed.delete(:kb_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/documents/%3$s", sender_id, kb_id, doc_id],
+                model: NilClass,
+                options: options
+              )
+            end
+
+            # @api private
+            #
+            # @param client [Zavudev::Client]
+            def initialize(client:)
+              @client = client
+            end
+          end
+        end
+      end
+    end
+  end
+end