cerca 0.1.0

data/lib/cerca/resources/approval_grants.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Resources
+    class ApprovalGrants
+      # Some parameter documentations has been truncated, see
+      # {Cerca::Models::ApprovalGrantListParams} for more details.
+      #
+      # List approval grants
+      #
+      # @overload list(agent_id, cursor: nil, limit: nil, request_options: {})
+      #
+      # @param agent_id [String]
+      #
+      # @param cursor [String] Opaque pagination cursor returned by a previous request.
+      #
+      # @param limit [String] Maximum number of items to return. Defaults to 20 and preserves parseInt semanti
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Internal::GrantsCursorPage<Cerca::Models::ApprovalGrant>]
+      #
+      # @see Cerca::Models::ApprovalGrantListParams
+      def list(agent_id, params = {})
+        parsed, options = Cerca::ApprovalGrantListParams.dump_request(params)
+        query = Cerca::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["agents/%1$s/approval-grants", agent_id],
+          query: query,
+          page: Cerca::Internal::GrantsCursorPage,
+          model: Cerca::ApprovalGrant,
+          options: options
+        )
+      end
+
+      # Delete approval grant
+      #
+      # @overload delete(agent_id, grant_id, request_options: {})
+      #
+      # @param agent_id [String]
+      # @param grant_id [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::ApprovalGrantDeleteResponse]
+      #
+      # @see Cerca::Models::ApprovalGrantDeleteParams
+      def delete(agent_id, grant_id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["agents/%1$s/approval-grants/%2$s", agent_id, grant_id],
+          model: Cerca::Models::ApprovalGrantDeleteResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Delete approval grant
+      #
+      # @overload delete_for_thread(agent_id, thread_id, grant_id, request_options: {})
+      #
+      # @param agent_id [String]
+      # @param thread_id [String]
+      # @param grant_id [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::ApprovalGrantDeleteForThreadResponse]
+      #
+      # @see Cerca::Models::ApprovalGrantDeleteForThreadParams
+      def delete_for_thread(agent_id, thread_id, grant_id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["agents/%1$s/threads/%2$s/approval-grants/%3$s", agent_id, thread_id, grant_id],
+          model: Cerca::Models::ApprovalGrantDeleteForThreadResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # List approval grants
+      #
+      # @overload list_for_thread(agent_id, thread_id, request_options: {})
+      #
+      # @param agent_id [String]
+      # @param thread_id [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Array<Cerca::Models::ApprovalGrant>]
+      #
+      # @see Cerca::Models::ApprovalGrantListForThreadParams
+      def list_for_thread(agent_id, thread_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["agents/%1$s/threads/%2$s/approval-grants", agent_id, thread_id],
+          model: Cerca::Internal::Type::ArrayOf[Cerca::ApprovalGrant],
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Cerca::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/cerca/resources/approval_requests.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Resources
+    class ApprovalRequests
+      # Some parameter documentations has been truncated, see
+      # {Cerca::Models::ApprovalRequestListParams} for more details.
+      #
+      # List approvals
+      #
+      # @overload list(agent_id, cursor: nil, limit: nil, thread_id: nil, request_options: {})
+      #
+      # @param agent_id [String]
+      #
+      # @param cursor [String] Opaque pagination cursor returned by a previous request.
+      #
+      # @param limit [String] Maximum number of items to return. Defaults to 20 and preserves parseInt semanti
+      #
+      # @param thread_id [String] Optional thread id filter.
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Internal::ApprovalRequestsCursorPage<Cerca::Models::ApprovalRequest>]
+      #
+      # @see Cerca::Models::ApprovalRequestListParams
+      def list(agent_id, params = {})
+        parsed, options = Cerca::ApprovalRequestListParams.dump_request(params)
+        query = Cerca::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["agents/%1$s/approvals", agent_id],
+          query: query.transform_keys(thread_id: "threadId"),
+          page: Cerca::Internal::ApprovalRequestsCursorPage,
+          model: Cerca::ApprovalRequest,
+          options: options
+        )
+      end
+
+      # Create approval
+      #
+      # @overload resolve(agent_id, thread_id, approval_id, decision:, grant: nil, request_options: {})
+      #
+      # @param agent_id [String]
+      # @param thread_id [String]
+      # @param approval_id [String]
+      # @param decision [Symbol, Cerca::Models::ApprovalRequestResolveParams::Decision]
+      # @param grant [Symbol, Cerca::Models::ApprovalRequestResolveParams::Grant]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::ApprovalRequest]
+      #
+      # @see Cerca::Models::ApprovalRequestResolveParams
+      def resolve(agent_id, thread_id, approval_id, params)
+        parsed, options = Cerca::ApprovalRequestResolveParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["agents/%1$s/threads/%2$s/approvals/%3$s", agent_id, thread_id, approval_id],
+          body: parsed,
+          model: Cerca::ApprovalRequest,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Cerca::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/cerca/resources/auth.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Resources
+    class Auth
+      # Retrieve context
+      #
+      # @overload context(request_options: {})
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::AuthContextResponse]
+      #
+      # @see Cerca::Models::AuthContextParams
+      def context(params = {})
+        @client.request(
+          method: :get,
+          path: "auth/context",
+          model: Cerca::AuthContextResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cerca::Models::AuthListFleetsParams} for more details.
+      #
+      # List fleets
+      #
+      # @overload list_fleets(cursor: nil, limit: nil, request_options: {})
+      #
+      # @param cursor [String] Opaque pagination cursor returned by a previous request.
+      #
+      # @param limit [String] Maximum number of items to return. Defaults to 20 and preserves parseInt semanti
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Internal::FleetsCursorPage<Cerca::Models::Fleet>]
+      #
+      # @see Cerca::Models::AuthListFleetsParams
+      def list_fleets(params = {})
+        parsed, options = Cerca::AuthListFleetsParams.dump_request(params)
+        query = Cerca::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "auth/fleets",
+          query: query,
+          page: Cerca::Internal::FleetsCursorPage,
+          model: Cerca::Fleet,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Cerca::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/cerca/resources/connections.rb

@@ -0,0 +1,167 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Resources
+    class Connections
+      # Some parameter documentations has been truncated, see
+      # {Cerca::Models::ConnectionCreateParams} for more details.
+      #
+      # Create API key
+      #
+      # @overload create(api_key:, owner:, provider:, account_label: nil, request_options: {})
+      #
+      # @param api_key [String] API key secret. It is stored securely and is not returned.
+      #
+      # @param owner [Cerca::Models::ConnectionOwner::OrganizationConnectionOwner, Cerca::Models::ConnectionOwner::FleetConnectionOwner] Public owner for a reusable connection. Organization owners use the authenticate
+      #
+      # @param provider [String] Credential provider to store an API key for.
+      #
+      # @param account_label [String] Optional human-readable account label.
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::Connection]
+      #
+      # @see Cerca::Models::ConnectionCreateParams
+      def create(params)
+        parsed, options = Cerca::ConnectionCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "connections/api-keys",
+          body: parsed,
+          model: Cerca::Connection,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cerca::Models::ConnectionListParams} for more details.
+      #
+      # List connections
+      #
+      # @overload list(owner_type:, cursor: nil, fleet_id: nil, limit: nil, request_options: {})
+      #
+      # @param owner_type [Symbol, Cerca::Models::ConnectionListParams::OwnerType] Public connection owner type.
+      #
+      # @param cursor [String] Opaque pagination cursor returned by a previous request.
+      #
+      # @param fleet_id [String] Required when ownerType is fleet.
+      #
+      # @param limit [String] Maximum number of items to return. Defaults to 20 and preserves parseInt semanti
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Internal::ConnectionsCursorPage<Cerca::Models::Connection>]
+      #
+      # @see Cerca::Models::ConnectionListParams
+      def list(params)
+        parsed, options = Cerca::ConnectionListParams.dump_request(params)
+        query = Cerca::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "connections",
+          query: query.transform_keys(owner_type: "ownerType", fleet_id: "fleetId"),
+          page: Cerca::Internal::ConnectionsCursorPage,
+          model: Cerca::Connection,
+          options: options
+        )
+      end
+
+      # Delete connection
+      #
+      # @overload delete(connection_id, owner_type:, fleet_id: nil, request_options: {})
+      #
+      # @param connection_id [String]
+      #
+      # @param owner_type [Symbol, Cerca::Models::ConnectionDeleteParams::OwnerType] Public connection owner type.
+      #
+      # @param fleet_id [String] Required when ownerType is fleet.
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::ConnectionDeleteResponse]
+      #
+      # @see Cerca::Models::ConnectionDeleteParams
+      def delete(connection_id, params)
+        parsed, options = Cerca::ConnectionDeleteParams.dump_request(params)
+        query = Cerca::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :delete,
+          path: ["connections/%1$s", connection_id],
+          query: query.transform_keys(owner_type: "ownerType", fleet_id: "fleetId"),
+          model: Cerca::Models::ConnectionDeleteResponse,
+          options: options
+        )
+      end
+
+      # Attach connection
+      #
+      # @overload attach(agent_id, connection_id:, metadata: nil, request_options: {})
+      #
+      # @param agent_id [String]
+      # @param connection_id [String]
+      # @param metadata [Hash{Symbol=>String}]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::AttachedConnection]
+      #
+      # @see Cerca::Models::ConnectionAttachParams
+      def attach(agent_id, params)
+        parsed, options = Cerca::ConnectionAttachParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["agents/%1$s/connections", agent_id],
+          body: parsed,
+          model: Cerca::AttachedConnection,
+          options: options
+        )
+      end
+
+      # Detach connection
+      #
+      # @overload detach(agent_id, connection_id, request_options: {})
+      #
+      # @param agent_id [String]
+      # @param connection_id [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::ConnectionDetachResponse]
+      #
+      # @see Cerca::Models::ConnectionDetachParams
+      def detach(agent_id, connection_id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["agents/%1$s/connections/%2$s", agent_id, connection_id],
+          model: Cerca::Models::ConnectionDetachResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # List connections
+      #
+      # @overload list_for_agent(agent_id, request_options: {})
+      #
+      # @param agent_id [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::ConnectionListForAgentResponse]
+      #
+      # @see Cerca::Models::ConnectionListForAgentParams
+      def list_for_agent(agent_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["agents/%1$s/connections", agent_id],
+          model: Cerca::Models::ConnectionListForAgentResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Cerca::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/cerca/resources/context.rb

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+
+module Cerca
+  module Resources
+    class Context
+      # Retrieve context entry
+      #
+      # @overload retrieve(agent_id, key:, request_options: {})
+      #
+      # @param agent_id [String]
+      #
+      # @param key [String] Context entry key.
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::Entry]
+      #
+      # @see Cerca::Models::ContextRetrieveParams
+      def retrieve(agent_id, params)
+        parsed, options = Cerca::ContextRetrieveParams.dump_request(params)
+        query = Cerca::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["agents/%1$s/context/entry", agent_id],
+          query: query,
+          model: Cerca::Entry,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cerca::Models::ContextListParams} for more details.
+      #
+      # List context entries
+      #
+      # @overload list(agent_id, cursor: nil, limit: nil, prefix: nil, request_options: {})
+      #
+      # @param agent_id [String]
+      #
+      # @param cursor [String] Opaque pagination cursor returned by a previous request.
+      #
+      # @param limit [String] Maximum number of items to return. Defaults to 20 and preserves parseInt semanti
+      #
+      # @param prefix [String] Optional key prefix filter.
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Internal::EntriesCursorPage<Cerca::Models::EntrySummary>]
+      #
+      # @see Cerca::Models::ContextListParams
+      def list(agent_id, params = {})
+        parsed, options = Cerca::ContextListParams.dump_request(params)
+        query = Cerca::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["agents/%1$s/context", agent_id],
+          query: query,
+          page: Cerca::Internal::EntriesCursorPage,
+          model: Cerca::EntrySummary,
+          options: options
+        )
+      end
+
+      # Delete context entry
+      #
+      # @overload delete(agent_id, key:, request_options: {})
+      #
+      # @param agent_id [String]
+      #
+      # @param key [String] Context entry key.
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::ContextDeleteResponse]
+      #
+      # @see Cerca::Models::ContextDeleteParams
+      def delete(agent_id, params)
+        parsed, options = Cerca::ContextDeleteParams.dump_request(params)
+        query = Cerca::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :delete,
+          path: ["agents/%1$s/context/entry", agent_id],
+          query: query,
+          model: Cerca::Models::ContextDeleteResponse,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cerca::Models::ContextSearchParams} for more details.
+      #
+      # Search context
+      #
+      # @overload search(agent_id, q:, cursor: nil, limit: nil, prefix: nil, request_options: {})
+      #
+      # @param agent_id [String]
+      #
+      # @param q [String] Search query.
+      #
+      # @param cursor [String] Opaque pagination cursor returned by a previous request.
+      #
+      # @param limit [String] Maximum number of items to return. Defaults to 20 and preserves parseInt semanti
+      #
+      # @param prefix [String] Optional key prefix filter.
+      #
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Internal::ResultsCursorPage<Cerca::Models::SearchResult>]
+      #
+      # @see Cerca::Models::ContextSearchParams
+      def search(agent_id, params)
+        parsed, options = Cerca::ContextSearchParams.dump_request(params)
+        query = Cerca::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["agents/%1$s/context/search", agent_id],
+          query: query,
+          page: Cerca::Internal::ResultsCursorPage,
+          model: Cerca::SearchResult,
+          options: options
+        )
+      end
+
+      # Update context entry
+      #
+      # @overload write(agent_id, content:, key:, expected_version: nil, mime_type: nil, request_options: {})
+      #
+      # @param agent_id [String]
+      # @param content [String]
+      # @param key [String]
+      # @param expected_version [Float]
+      # @param mime_type [String]
+      # @param request_options [Cerca::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cerca::Models::Entry]
+      #
+      # @see Cerca::Models::ContextWriteParams
+      def write(agent_id, params)
+        parsed, options = Cerca::ContextWriteParams.dump_request(params)
+        @client.request(
+          method: :put,
+          path: ["agents/%1$s/context/entry", agent_id],
+          body: parsed,
+          model: Cerca::Entry,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Cerca::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end