cadenya 0.1.0

data/lib/cadenya/resources/agents/webhook_deliveries.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Resources
+    class Agents
+      # Manage AI agents within a workspace. Agents define AI behavior and tool access.
+      class WebhookDeliveries
+        # Lists all webhook deliveries for an agent
+        #
+        # @overload list(agent_id, workspace_id:, cursor: nil, event_type: nil, limit: nil, objective_id: nil, request_options: {})
+        #
+        # @param agent_id [String] Path param
+        #
+        # @param workspace_id [String] Path param: Workspace ID.
+        #
+        # @param cursor [String] Query param: Pagination cursor from previous response
+        #
+        # @param event_type [Symbol, Cadenya::Models::Agents::WebhookDeliveryListParams::EventType] Query param: Optional filter by event type
+        #
+        # @param limit [Integer] Query param: Maximum number of results to return
+        #
+        # @param objective_id [String] Query param: Optional filter by objective ID
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Internal::CursorPagination<Cadenya::Models::Agents::WebhookDelivery>]
+        #
+        # @see Cadenya::Models::Agents::WebhookDeliveryListParams
+        def list(agent_id, params)
+          parsed, options = Cadenya::Agents::WebhookDeliveryListParams.dump_request(params)
+          query = Cadenya::Internal::Util.encode_query_params(parsed)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :get,
+            path: ["v1/workspaces/%1$s/agents/%2$s/webhook_deliveries", workspace_id, agent_id],
+            query: query.transform_keys(event_type: "eventType", objective_id: "objectiveId"),
+            page: Cadenya::Internal::CursorPagination,
+            model: Cadenya::Agents::WebhookDelivery,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Cadenya::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/cadenya/resources/agents.rb

@@ -0,0 +1,215 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Resources
+    # Manage AI agents within a workspace. Agents define AI behavior and tool access.
+    class Agents
+      # Manage AI agents within a workspace. Agents define AI behavior and tool access.
+      # @return [Cadenya::Resources::Agents::Feedback]
+      attr_reader :feedback
+
+      # Manage AI agents within a workspace. Agents define AI behavior and tool access.
+      # @return [Cadenya::Resources::Agents::WebhookDeliveries]
+      attr_reader :webhook_deliveries
+
+      # Manage variations of an agent and their tool, sub-agent, and memory layer
+      # assignments.
+      # @return [Cadenya::Resources::Agents::Variations]
+      attr_reader :variations
+
+      # Manage recurring schedules attached to agents. Schedules trigger objectives on a
+      # cadence defined by AgentScheduleSpec.Schedule.
+      # @return [Cadenya::Resources::Agents::Schedules]
+      attr_reader :schedules
+
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::AgentCreateParams} for more details.
+      #
+      # Creates a new agent in the workspace
+      #
+      # @overload create(workspace_id, metadata:, spec:, default_variation: nil, request_options: {})
+      #
+      # @param workspace_id [String] Workspace ID.
+      #
+      # @param metadata [Cadenya::Models::CreateResourceMetadata] CreateResourceMetadata contains the user-provided fields for creating
+      #
+      # @param spec [Cadenya::Models::AgentSpec] Agent specification (user-provided configuration)
+      #
+      # @param default_variation [Cadenya::Models::AgentCreateParams::DefaultVariation] Create agent variation request
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::Agent]
+      #
+      # @see Cadenya::Models::AgentCreateParams
+      def create(workspace_id, params)
+        parsed, options = Cadenya::AgentCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: ["v1/workspaces/%1$s/agents", workspace_id],
+          body: parsed,
+          model: Cadenya::Agent,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::AgentRetrieveParams} for more details.
+      #
+      # Retrieves an agent by ID from the workspace
+      #
+      # @overload retrieve(id, workspace_id:, request_options: {})
+      #
+      # @param id [String] Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>` form
+      #
+      # @param workspace_id [String] Workspace ID.
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::Agent]
+      #
+      # @see Cadenya::Models::AgentRetrieveParams
+      def retrieve(id, params)
+        parsed, options = Cadenya::AgentRetrieveParams.dump_request(params)
+        workspace_id =
+          parsed.delete(:workspace_id) do
+            raise ArgumentError.new("missing required path argument #{_1}")
+          end
+        @client.request(
+          method: :get,
+          path: ["v1/workspaces/%1$s/agents/%2$s", workspace_id, id],
+          model: Cadenya::Agent,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::AgentUpdateParams} for more details.
+      #
+      # Updates an agent in the workspace
+      #
+      # @overload update(id, workspace_id:, metadata: nil, spec: nil, update_mask: nil, request_options: {})
+      #
+      # @param id [String] Path param: Agent ID. Accepts the canonical `agent_…` form or the `external_id:<
+      #
+      # @param workspace_id [String] Path param: Workspace ID.
+      #
+      # @param metadata [Cadenya::Models::UpdateResourceMetadata] Body param: UpdateResourceMetadata contains the user-provided fields for updatin
+      #
+      # @param spec [Cadenya::Models::AgentSpec] Body param: Agent specification (user-provided configuration)
+      #
+      # @param update_mask [String] Body param: Fields to update
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::Agent]
+      #
+      # @see Cadenya::Models::AgentUpdateParams
+      def update(id, params)
+        parsed, options = Cadenya::AgentUpdateParams.dump_request(params)
+        workspace_id =
+          parsed.delete(:workspace_id) do
+            raise ArgumentError.new("missing required path argument #{_1}")
+          end
+        @client.request(
+          method: :patch,
+          path: ["v1/workspaces/%1$s/agents/%2$s", workspace_id, id],
+          body: parsed,
+          model: Cadenya::Agent,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::AgentListParams} for more details.
+      #
+      # Lists all agents in the workspace
+      #
+      # @overload list(workspace_id, bundle_key: nil, cursor: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, status: nil, variation_selection_mode: nil, request_options: {})
+      #
+      # @param workspace_id [String] Workspace ID.
+      #
+      # @param bundle_key [String] Filter by bundle_key — return only resources owned by this bundle.
+      #
+      # @param cursor [String] Pagination cursor from previous response
+      #
+      # @param include_info [Boolean] When true, the `info` field on each returned agent is populated. Requests
+      #
+      # @param limit [Integer] Maximum number of results to return
+      #
+      # @param prefix [String] Filter expression (query param: prefix)
+      #
+      # @param query [String] Free-form search query
+      #
+      # @param sort_order [String] Sort order for results (asc or desc by creation time)
+      #
+      # @param status [Symbol, Cadenya::Models::AgentListParams::Status] Filter by agent publication status
+      #
+      # @param variation_selection_mode [Symbol, Cadenya::Models::AgentListParams::VariationSelectionMode] Filter by variation selection mode
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Internal::CursorPagination<Cadenya::Models::Agent>]
+      #
+      # @see Cadenya::Models::AgentListParams
+      def list(workspace_id, params = {})
+        parsed, options = Cadenya::AgentListParams.dump_request(params)
+        query = Cadenya::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: ["v1/workspaces/%1$s/agents", workspace_id],
+          query: query.transform_keys(
+            bundle_key: "bundleKey",
+            include_info: "includeInfo",
+            sort_order: "sortOrder",
+            variation_selection_mode: "variationSelectionMode"
+          ),
+          page: Cadenya::Internal::CursorPagination,
+          model: Cadenya::Agent,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::AgentDeleteParams} for more details.
+      #
+      # Deletes an agent from the workspace
+      #
+      # @overload delete(id, workspace_id:, request_options: {})
+      #
+      # @param id [String] Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>` form
+      #
+      # @param workspace_id [String] Workspace ID.
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see Cadenya::Models::AgentDeleteParams
+      def delete(id, params)
+        parsed, options = Cadenya::AgentDeleteParams.dump_request(params)
+        workspace_id =
+          parsed.delete(:workspace_id) do
+            raise ArgumentError.new("missing required path argument #{_1}")
+          end
+        @client.request(
+          method: :delete,
+          path: ["v1/workspaces/%1$s/agents/%2$s", workspace_id, id],
+          model: NilClass,
+          options: options
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Cadenya::Client]
+      def initialize(client:)
+        @client = client
+        @feedback = Cadenya::Resources::Agents::Feedback.new(client: client)
+        @webhook_deliveries = Cadenya::Resources::Agents::WebhookDeliveries.new(client: client)
+        @variations = Cadenya::Resources::Agents::Variations.new(client: client)
+        @schedules = Cadenya::Resources::Agents::Schedules.new(client: client)
+      end
+    end
+  end
+end

data/lib/cadenya/resources/api_keys/access.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Resources
+    class APIKeys
+      # Issue, rotate, and revoke API keys for the account, and grant or revoke each
+      # key's access to individual workspaces.
+      class Access
+        # Lists the workspaces this API key has access to. Cursor-paginated.
+        #
+        # @overload list(id, cursor: nil, limit: nil, request_options: {})
+        #
+        # @param id [String] The API key whose workspace associations will be listed.
+        #
+        # @param cursor [String] Pagination cursor from previous response.
+        #
+        # @param limit [Integer] Maximum number of results to return.
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Internal::CursorPagination<Cadenya::Models::Workspace>]
+        #
+        # @see Cadenya::Models::APIKeys::AccessListParams
+        def list(id, params = {})
+          parsed, options = Cadenya::APIKeys::AccessListParams.dump_request(params)
+          query = Cadenya::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: ["v1/account/api_keys/%1$s/workspaces", id],
+            query: query,
+            page: Cadenya::Internal::CursorPagination,
+            model: Cadenya::Workspace,
+            options: options
+          )
+        end
+
+        # Grants this API key access to the specified workspace. Idempotent — adding an
+        # already-associated workspace is a no-op. Returns the updated API key with
+        # refreshed workspace preview and total.
+        #
+        # @overload add(id, workspace_id: nil, request_options: {})
+        #
+        # @param id [String] The API key being granted workspace access.
+        #
+        # @param workspace_id [String] The workspace to grant access to.
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Models::APIKey]
+        #
+        # @see Cadenya::Models::APIKeys::AccessAddParams
+        def add(id, params = {})
+          parsed, options = Cadenya::APIKeys::AccessAddParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["v1/account/api_keys/%1$s/workspaces", id],
+            body: parsed,
+            model: Cadenya::APIKey,
+            options: options
+          )
+        end
+
+        # Revokes this API key's access to the specified workspace. Idempotent. A key may
+        # have zero workspaces and remains valid.
+        #
+        # @overload remove(workspace_id, id:, request_options: {})
+        #
+        # @param workspace_id [String] The workspace whose access is being revoked (path).
+        #
+        # @param id [String] The API key losing workspace access (path).
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [nil]
+        #
+        # @see Cadenya::Models::APIKeys::AccessRemoveParams
+        def remove(workspace_id, params)
+          parsed, options = Cadenya::APIKeys::AccessRemoveParams.dump_request(params)
+          id =
+            parsed.delete(:id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :delete,
+            path: ["v1/account/api_keys/%1$s/workspaces/%2$s", id, workspace_id],
+            model: NilClass,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Cadenya::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/cadenya/resources/api_keys.rb

@@ -0,0 +1,190 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Resources
+    # Issue, rotate, and revoke API keys for the account, and grant or revoke each
+    # key's access to individual workspaces.
+    class APIKeys
+      # Issue, rotate, and revoke API keys for the account, and grant or revoke each
+      # key's access to individual workspaces.
+      # @return [Cadenya::Resources::APIKeys::Access]
+      attr_reader :access
+
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::APIKeyCreateParams} for more details.
+      #
+      # Creates a new API key on the account. Optionally grants the key access to one or
+      # more workspaces via initial_workspace_ids.
+      #
+      # @overload create(metadata:, spec:, initial_workspace_ids: nil, request_options: {})
+      #
+      # @param metadata [Cadenya::Models::APIKeyCreateParams::Metadata] CreateAccountResourceMetadata contains the user-provided fields for creating
+      #
+      # @param spec [Cadenya::Models::APIKeySpec] Configuration for an API key.
+      #
+      # @param initial_workspace_ids [Array<String>] Workspaces this API key will have access to on creation. Optional —
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::APIKey]
+      #
+      # @see Cadenya::Models::APIKeyCreateParams
+      def create(params)
+        parsed, options = Cadenya::APIKeyCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "v1/account/api_keys",
+          body: parsed,
+          model: Cadenya::APIKey,
+          options: options
+        )
+      end
+
+      # Retrieves an API key by ID.
+      #
+      # @overload retrieve(id, request_options: {})
+      #
+      # @param id [String] The API key to retrieve.
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::APIKey]
+      #
+      # @see Cadenya::Models::APIKeyRetrieveParams
+      def retrieve(id, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/account/api_keys/%1$s", id],
+          model: Cadenya::APIKey,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::APIKeyUpdateParams} for more details.
+      #
+      # Updates an API key.
+      #
+      # @overload update(id, metadata: nil, spec: nil, update_mask: nil, request_options: {})
+      #
+      # @param id [String] The API key to update.
+      #
+      # @param metadata [Cadenya::Models::APIKeyUpdateParams::Metadata] UpdateAccountResourceMetadata contains the user-provided fields for updating
+      #
+      # @param spec [Cadenya::Models::APIKeySpec] Configuration for an API key.
+      #
+      # @param update_mask [String] Fields to update.
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::APIKey]
+      #
+      # @see Cadenya::Models::APIKeyUpdateParams
+      def update(id, params = {})
+        parsed, options = Cadenya::APIKeyUpdateParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["v1/account/api_keys/%1$s", id],
+          body: parsed,
+          model: Cadenya::APIKey,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::APIKeyListParams} for more details.
+      #
+      # Lists all API keys on the account.
+      #
+      # @overload list(bundle_key: nil, cursor: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, request_options: {})
+      #
+      # @param bundle_key [String] Filter by bundle_key — return only resources owned by this bundle.
+      #
+      # @param cursor [String] Pagination cursor from previous response.
+      #
+      # @param include_info [Boolean] When true, included info fields are populated. Requests with this
+      #
+      # @param limit [Integer] Maximum number of results to return.
+      #
+      # @param prefix [String] Filter by ID prefix.
+      #
+      # @param query [String] Free-form search query.
+      #
+      # @param sort_order [String] Sort order for results (asc or desc by creation time).
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Internal::CursorPagination<Cadenya::Models::APIKey>]
+      #
+      # @see Cadenya::Models::APIKeyListParams
+      def list(params = {})
+        parsed, options = Cadenya::APIKeyListParams.dump_request(params)
+        query = Cadenya::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "v1/account/api_keys",
+          query: query.transform_keys(
+            bundle_key: "bundleKey",
+            include_info: "includeInfo",
+            sort_order: "sortOrder"
+          ),
+          page: Cadenya::Internal::CursorPagination,
+          model: Cadenya::APIKey,
+          options: options
+        )
+      end
+
+      # Deletes an API key.
+      #
+      # @overload delete(id, request_options: {})
+      #
+      # @param id [String] The API key to delete.
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see Cadenya::Models::APIKeyDeleteParams
+      def delete(id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["v1/account/api_keys/%1$s", id],
+          model: NilClass,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::APIKeyRotateParams} for more details.
+      #
+      # Rotates an API key and returns a new token. All previous tokens for this key are
+      # invalidated.
+      #
+      # @overload rotate(id, request_options: {})
+      #
+      # @param id [String] The API key to rotate. A new token is issued and any existing token is
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::APIKey]
+      #
+      # @see Cadenya::Models::APIKeyRotateParams
+      def rotate(id, params = {})
+        @client.request(
+          method: :put,
+          path: ["v1/account/api_keys/%1$s/rotate", id],
+          model: Cadenya::APIKey,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Cadenya::Client]
+      def initialize(client:)
+        @client = client
+        @access = Cadenya::Resources::APIKeys::Access.new(client: client)
+      end
+    end
+  end
+end

data/lib/cadenya/resources/bulk_workspace_resources/results.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Resources
+    class BulkWorkspaceResources
+      # Apply a declarative bundle of workspace resources — tool sets, memory layers,
+      # agents, variations, assignments, and schedules — in a single asynchronous
+      # operation.
+      class Results
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::BulkWorkspaceResources::ResultListParams} for more details.
+        #
+        # Lists each resource action recorded by a bulk workspace apply operation.
+        #
+        # @overload list(bulk_workspace_apply_id, workspace_id:, action: nil, cursor: nil, limit: nil, sort_order: nil, type: nil, request_options: {})
+        #
+        # @param bulk_workspace_apply_id [String] Path param: Apply ID in canonical apply\_… form.
+        #
+        # @param workspace_id [String] Path param: Workspace ID.
+        #
+        # @param action [Symbol, Cadenya::Models::BulkWorkspaceResources::ResultListParams::Action] Query param: Filter by action.
+        #
+        # @param cursor [String] Query param: Pagination cursor from previous response
+        #
+        # @param limit [Integer] Query param: Maximum number of results to return
+        #
+        # @param sort_order [String] Query param: Sort order for results (asc or desc by creation time)
+        #
+        # @param type [String] Query param: Filter by data.type discriminator (e.g., "toolSet", "memoryEntry").
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Internal::CursorPagination<Cadenya::Models::BulkWorkspaceResources::BulkWorkspaceApplyResult>]
+        #
+        # @see Cadenya::Models::BulkWorkspaceResources::ResultListParams
+        def list(bulk_workspace_apply_id, params)
+          parsed, options = Cadenya::BulkWorkspaceResources::ResultListParams.dump_request(params)
+          query = Cadenya::Internal::Util.encode_query_params(parsed)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :get,
+            path: [
+              "v1/workspaces/%1$s/bulk_workspace_applies/%2$s/results",
+              workspace_id,
+              bulk_workspace_apply_id
+            ],
+            query: query.transform_keys(sort_order: "sortOrder"),
+            page: Cadenya::Internal::CursorPagination,
+            model: Cadenya::BulkWorkspaceResources::BulkWorkspaceApplyResult,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Cadenya::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end