cadenya 0.1.0

data/rbi/cadenya/resources/agents/variations.rbi

@@ -0,0 +1,300 @@
+# typed: strong
+
+module Cadenya
+  module Resources
+    class Agents
+      # Manage variations of an agent and their tool, sub-agent, and memory layer
+      # assignments.
+      class Variations
+        # Creates a new variation for an agent
+        sig do
+          params(
+            agent_id: String,
+            workspace_id: String,
+            metadata: Cadenya::CreateResourceMetadata::OrHash,
+            spec: Cadenya::Agents::AgentVariationSpec::OrHash,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::Agents::AgentVariation)
+        end
+        def create(
+          # Path param: Agent ID. Accepts the canonical `agent_…` form or the
+          # `external_id:<value>` form.
+          agent_id,
+          # Path param: Workspace ID.
+          workspace_id:,
+          # Body param: CreateResourceMetadata contains the user-provided fields for
+          # creating a workspace-scoped resource. Read-only fields (id, account_id,
+          # workspace_id, profile_id, created_at) are excluded since they are set by the
+          # server.
+          metadata:,
+          # Body param: AgentVariationSpec defines the operational configuration for a
+          # variation
+          spec:,
+          request_options: {}
+        )
+        end
+
+        # Retrieves a variation by ID from an agent
+        sig do
+          params(
+            id: String,
+            workspace_id: String,
+            agent_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::Agents::AgentVariation)
+        end
+        def retrieve(
+          # Variation ID. Accepts the canonical `av_…` form or the `external_id:<value>`
+          # form.
+          id,
+          # Workspace ID.
+          workspace_id:,
+          # Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
+          # form.
+          agent_id:,
+          request_options: {}
+        )
+        end
+
+        # Updates a variation for an agent
+        sig do
+          params(
+            id: String,
+            workspace_id: String,
+            agent_id: String,
+            metadata: Cadenya::UpdateResourceMetadata::OrHash,
+            spec: Cadenya::Agents::AgentVariationSpec::OrHash,
+            update_mask: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::Agents::AgentVariation)
+        end
+        def update(
+          # Path param: Variation ID. Accepts the canonical `av_…` form or the
+          # `external_id:<value>` form.
+          id,
+          # Path param: Workspace ID.
+          workspace_id:,
+          # Path param: Agent ID. Accepts the canonical `agent_…` form or the
+          # `external_id:<value>` form.
+          agent_id:,
+          # Body param: UpdateResourceMetadata contains the user-provided fields for
+          # updating a workspace-scoped resource. Read-only fields (id, account_id,
+          # workspace_id, profile_id, created_at) are excluded since they are set by the
+          # server.
+          metadata: nil,
+          # Body param: AgentVariationSpec defines the operational configuration for a
+          # variation
+          spec: nil,
+          # Body param: Fields to update
+          update_mask: nil,
+          request_options: {}
+        )
+        end
+
+        # Lists all variations for an agent
+        sig do
+          params(
+            agent_id: String,
+            workspace_id: String,
+            bundle_key: String,
+            cursor: String,
+            include_info: T::Boolean,
+            limit: Integer,
+            sort_order: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(
+            Cadenya::Internal::CursorPagination[Cadenya::Agents::AgentVariation]
+          )
+        end
+        def list(
+          # Path param: Agent ID. Accepts the canonical `agent_…` form or the
+          # `external_id:<value>` form.
+          agent_id,
+          # Path param: Workspace ID.
+          workspace_id:,
+          # Query param: Filter by bundle_key — return only resources owned by this bundle.
+          bundle_key: nil,
+          # Query param: Pagination cursor from previous response
+          cursor: nil,
+          # Query param: When true, the `info` field on each returned variation is
+          # populated. Requests with this flag count more against your rate limit.
+          include_info: nil,
+          # Query param: Maximum number of results to return
+          limit: nil,
+          # Query param: Sort order for results (asc or desc by creation time)
+          sort_order: nil,
+          request_options: {}
+        )
+        end
+
+        # Deletes a variation from an agent
+        sig do
+          params(
+            id: String,
+            workspace_id: String,
+            agent_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).void
+        end
+        def delete(
+          # Variation ID. Accepts the canonical `av_…` form or the `external_id:<value>`
+          # form.
+          id,
+          # Workspace ID.
+          workspace_id:,
+          # Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
+          # form.
+          agent_id:,
+          request_options: {}
+        )
+        end
+
+        # Assigns a tool, tool set, or sub-agent to a variation. Exactly one target ID
+        # must be set.
+        sig do
+          params(
+            variation_id: String,
+            workspace_id: String,
+            agent_id: String,
+            sub_agent_id: String,
+            tool_id: String,
+            tool_set_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::Agents::VariationAssignment)
+        end
+        def add_assignment(
+          # Path param: Variation ID. Accepts the canonical `av_…` form or the
+          # `external_id:<value>` form.
+          variation_id,
+          # Path param: Workspace ID.
+          workspace_id:,
+          # Path param: Agent ID. Accepts the canonical `agent_…` form or the
+          # `external_id:<value>` form.
+          agent_id:,
+          # Body param
+          sub_agent_id: nil,
+          # Body param
+          tool_id: nil,
+          # Body param
+          tool_set_id: nil,
+          request_options: {}
+        )
+        end
+
+        # Attaches a memory layer to a variation at a given position in the variation's
+        # baseline memory stack.
+        sig do
+          params(
+            variation_id: String,
+            workspace_id: String,
+            agent_id: String,
+            memory_layer_id: String,
+            position: Integer,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::Agents::VariationMemoryLayerAssignment)
+        end
+        def add_memory_layer(
+          # Path param: Variation ID. Accepts the canonical `av_…` form or the
+          # `external_id:<value>` form.
+          variation_id,
+          # Path param: Workspace ID.
+          workspace_id:,
+          # Path param: Agent ID. Accepts the canonical `agent_…` form or the
+          # `external_id:<value>` form.
+          agent_id:,
+          # Body param: Layer to attach. Accepts the canonical `memlyr_…` form or the
+          # `external_id:<value>` form.
+          memory_layer_id: nil,
+          # Body param: Position in the stack. If omitted, server appends (max existing
+          # position + 1).
+          position: nil,
+          request_options: {}
+        )
+        end
+
+        # Detaches an assignment from a variation, identified by the assignment ID
+        # returned when it was added.
+        sig do
+          params(
+            id: String,
+            workspace_id: String,
+            agent_id: String,
+            variation_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).void
+        end
+        def remove_assignment(
+          id,
+          # Workspace ID.
+          workspace_id:,
+          # Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
+          # form.
+          agent_id:,
+          # Variation ID. Accepts the canonical `av_…` form or the `external_id:<value>`
+          # form.
+          variation_id:,
+          request_options: {}
+        )
+        end
+
+        # Detaches a memory layer assignment from a variation, identified by the
+        # assignment id.
+        sig do
+          params(
+            id: String,
+            workspace_id: String,
+            agent_id: String,
+            variation_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).void
+        end
+        def remove_memory_layer(
+          id,
+          # Workspace ID.
+          workspace_id:,
+          # Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
+          # form.
+          agent_id:,
+          # Variation ID. Accepts the canonical `av_…` form or the `external_id:<value>`
+          # form.
+          variation_id:,
+          request_options: {}
+        )
+        end
+
+        # Updates the position of a memory layer assignment on a variation.
+        sig do
+          params(
+            id: String,
+            workspace_id: String,
+            agent_id: String,
+            variation_id: String,
+            position: Integer,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::Agents::VariationMemoryLayerAssignment)
+        end
+        def update_memory_layer(
+          # Path param
+          id,
+          # Path param: Workspace ID.
+          workspace_id:,
+          # Path param: Agent ID. Accepts the canonical `agent_…` form or the
+          # `external_id:<value>` form.
+          agent_id:,
+          # Path param: Variation ID. Accepts the canonical `av_…` form or the
+          # `external_id:<value>` form.
+          variation_id:,
+          # Body param: New position. Only field currently updatable on an assignment.
+          position: nil,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Cadenya::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/resources/agents/webhook_deliveries.rbi

@@ -0,0 +1,49 @@
+# typed: strong
+
+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
+        sig do
+          params(
+            agent_id: String,
+            workspace_id: String,
+            cursor: String,
+            event_type:
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::OrSymbol,
+            limit: Integer,
+            objective_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(
+            Cadenya::Internal::CursorPagination[
+              Cadenya::Agents::WebhookDelivery
+            ]
+          )
+        end
+        def list(
+          # Path param
+          agent_id,
+          # Path param: Workspace ID.
+          workspace_id:,
+          # Query param: Pagination cursor from previous response
+          cursor: nil,
+          # Query param: Optional filter by event type
+          event_type: nil,
+          # Query param: Maximum number of results to return
+          limit: nil,
+          # Query param: Optional filter by objective ID
+          objective_id: nil,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Cadenya::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/resources/agents.rbi

@@ -0,0 +1,166 @@
+# typed: strong
+
+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.
+      sig { returns(Cadenya::Resources::Agents::Feedback) }
+      attr_reader :feedback
+
+      # Manage AI agents within a workspace. Agents define AI behavior and tool access.
+      sig { returns(Cadenya::Resources::Agents::WebhookDeliveries) }
+      attr_reader :webhook_deliveries
+
+      # Manage variations of an agent and their tool, sub-agent, and memory layer
+      # assignments.
+      sig { returns(Cadenya::Resources::Agents::Variations) }
+      attr_reader :variations
+
+      # Manage recurring schedules attached to agents. Schedules trigger objectives on a
+      # cadence defined by AgentScheduleSpec.Schedule.
+      sig { returns(Cadenya::Resources::Agents::Schedules) }
+      attr_reader :schedules
+
+      # Creates a new agent in the workspace
+      sig do
+        params(
+          workspace_id: String,
+          metadata: Cadenya::CreateResourceMetadata::OrHash,
+          spec: Cadenya::AgentSpec::OrHash,
+          default_variation:
+            Cadenya::AgentCreateParams::DefaultVariation::OrHash,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Agent)
+      end
+      def create(
+        # Workspace ID.
+        workspace_id,
+        # CreateResourceMetadata contains the user-provided fields for creating a
+        # workspace-scoped resource. Read-only fields (id, account_id, workspace_id,
+        # profile_id, created_at) are excluded since they are set by the server.
+        metadata:,
+        # Agent specification (user-provided configuration)
+        spec:,
+        # Create agent variation request
+        default_variation: nil,
+        request_options: {}
+      )
+      end
+
+      # Retrieves an agent by ID from the workspace
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Agent)
+      end
+      def retrieve(
+        # Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
+        # form.
+        id,
+        # Workspace ID.
+        workspace_id:,
+        request_options: {}
+      )
+      end
+
+      # Updates an agent in the workspace
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          metadata: Cadenya::UpdateResourceMetadata::OrHash,
+          spec: Cadenya::AgentSpec::OrHash,
+          update_mask: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Agent)
+      end
+      def update(
+        # Path param: Agent ID. Accepts the canonical `agent_…` form or the
+        # `external_id:<value>` form.
+        id,
+        # Path param: Workspace ID.
+        workspace_id:,
+        # Body param: UpdateResourceMetadata contains the user-provided fields for
+        # updating a workspace-scoped resource. Read-only fields (id, account_id,
+        # workspace_id, profile_id, created_at) are excluded since they are set by the
+        # server.
+        metadata: nil,
+        # Body param: Agent specification (user-provided configuration)
+        spec: nil,
+        # Body param: Fields to update
+        update_mask: nil,
+        request_options: {}
+      )
+      end
+
+      # Lists all agents in the workspace
+      sig do
+        params(
+          workspace_id: String,
+          bundle_key: String,
+          cursor: String,
+          include_info: T::Boolean,
+          limit: Integer,
+          prefix: String,
+          query: String,
+          sort_order: String,
+          status: Cadenya::AgentListParams::Status::OrSymbol,
+          variation_selection_mode:
+            Cadenya::AgentListParams::VariationSelectionMode::OrSymbol,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Internal::CursorPagination[Cadenya::Agent])
+      end
+      def list(
+        # Workspace ID.
+        workspace_id,
+        # Filter by bundle_key — return only resources owned by this bundle.
+        bundle_key: nil,
+        # Pagination cursor from previous response
+        cursor: nil,
+        # When true, the `info` field on each returned agent is populated. Requests with
+        # this flag count more against your rate limit.
+        include_info: nil,
+        # Maximum number of results to return
+        limit: nil,
+        # Filter expression (query param: prefix)
+        prefix: nil,
+        # Free-form search query
+        query: nil,
+        # Sort order for results (asc or desc by creation time)
+        sort_order: nil,
+        # Filter by agent publication status
+        status: nil,
+        # Filter by variation selection mode
+        variation_selection_mode: nil,
+        request_options: {}
+      )
+      end
+
+      # Deletes an agent from the workspace
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).void
+      end
+      def delete(
+        # Agent ID. Accepts the canonical `agent_…` form or the `external_id:<value>`
+        # form.
+        id,
+        # Workspace ID.
+        workspace_id:,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Cadenya::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/cadenya/resources/api_keys/access.rbi

@@ -0,0 +1,73 @@
+# typed: strong
+
+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.
+        sig do
+          params(
+            id: String,
+            cursor: String,
+            limit: Integer,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::Internal::CursorPagination[Cadenya::Workspace])
+        end
+        def list(
+          # The API key whose workspace associations will be listed.
+          id,
+          # Pagination cursor from previous response.
+          cursor: nil,
+          # Maximum number of results to return.
+          limit: nil,
+          request_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.
+        sig do
+          params(
+            id: String,
+            workspace_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::APIKey)
+        end
+        def add(
+          # The API key being granted workspace access.
+          id,
+          # The workspace to grant access to.
+          workspace_id: nil,
+          request_options: {}
+        )
+        end
+
+        # Revokes this API key's access to the specified workspace. Idempotent. A key may
+        # have zero workspaces and remains valid.
+        sig do
+          params(
+            workspace_id: String,
+            id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).void
+        end
+        def remove(
+          # The workspace whose access is being revoked (path).
+          workspace_id,
+          # The API key losing workspace access (path).
+          id:,
+          request_options: {}
+        )
+        end
+
+        # @api private
+        sig { params(client: Cadenya::Client).returns(T.attached_class) }
+        def self.new(client:)
+        end
+      end
+    end
+  end
+end