cadenya 0.2.0 → 0.4.0

data/rbi/cadenya/resources/ai_provider_keys.rbi

@@ -0,0 +1,125 @@
+# typed: strong
+
+module Cadenya
+  module Resources
+    class AIProviderKeys
+      # Creates a new customer-provided AI provider key in the workspace
+      sig do
+        params(
+          workspace_id: String,
+          metadata: Cadenya::CreateResourceMetadata::OrHash,
+          spec: Cadenya::AIProviderKeySpec::OrHash,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::AIProviderKey)
+      end
+      def create(
+        # The workspace that will own this key.
+        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:,
+        spec:,
+        request_options: {}
+      )
+      end
+
+      # Retrieves an AI provider key by ID from the workspace
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::AIProviderKey)
+      end
+      def retrieve(
+        # The key to retrieve.
+        id,
+        # The workspace the key belongs to.
+        workspace_id:,
+        request_options: {}
+      )
+      end
+
+      # Updates an AI provider key's name or key value in the workspace
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          metadata: Cadenya::UpdateResourceMetadata::OrHash,
+          spec: Cadenya::AIProviderKeySpec::OrHash,
+          update_mask: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::AIProviderKey)
+      end
+      def update(
+        # Path param: The key to update.
+        id,
+        # Path param: The workspace the key belongs to.
+        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
+        spec: nil,
+        # Body param: Fields to update.
+        update_mask: nil,
+        request_options: {}
+      )
+      end
+
+      # Lists all customer-provided AI provider keys in the workspace
+      sig do
+        params(
+          workspace_id: String,
+          cursor: String,
+          limit: Integer,
+          prefix: String,
+          query: String,
+          sort_order: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Internal::CursorPagination[Cadenya::AIProviderKey])
+      end
+      def list(
+        # The workspace whose keys will be listed.
+        workspace_id,
+        # Pagination cursor from previous response
+        cursor: 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,
+        request_options: {}
+      )
+      end
+
+      # Deletes an AI provider key from the workspace
+      sig do
+        params(
+          id: String,
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).void
+      end
+      def delete(
+        # The key to delete.
+        id,
+        # The workspace the key belongs to.
+        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/tool_sets.rbi

@@ -136,6 +136,24 @@ module Cadenya
       )
       end
 
+      # Retrieves the current OpenAPI specification JSON that has been consumed by the
+      # tool set. Only applicable to tool sets using the OpenAPI adapter.
+      sig do
+        params(
+          tool_set_id: String,
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Models::ToolSetGetOpenAPISpecResponse)
+      end
+      def get_openapi_spec(
+        # Tool set ID. Accepts the canonical ts\_… form or the external_id:<value> form.
+        tool_set_id,
+        # Workspace ID.
+        workspace_id:,
+        request_options: {}
+      )
+      end
+
       # Lists all events (including sync status) for a tool set
       sig do
         params(

data/rbi/cadenya/resources/workspace_admin/members.rbi

@@ -0,0 +1,83 @@
+# typed: strong
+
+module Cadenya
+  module Resources
+    class WorkspaceAdmin
+      # Administer workspaces across the account: create and archive workspaces and
+      # manage their membership. These operations are account-scoped and require the
+      # admin role (a token whose profile holds the WorkOS admin role); they live under
+      # /v1/account/workspaces rather than the workspace-scoped /v1/workspaces tree so
+      # an admin can manage any workspace in the account, including ones they are not
+      # themselves a member of.
+      class Members
+        # Lists the members of a workspace. Admin only.
+        sig do
+          params(
+            workspace_id: String,
+            cursor: String,
+            limit: Integer,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(
+            Cadenya::Internal::CursorPagination[Cadenya::WorkspaceMember]
+          )
+        end
+        def list(
+          # The workspace whose members will be listed (path).
+          workspace_id,
+          # Pagination cursor from previous response
+          cursor: nil,
+          # Maximum number of results to return
+          limit: nil,
+          request_options: {}
+        )
+        end
+
+        # Grants a profile access to the workspace by creating (or reactivating) the actor
+        # that links the profile to the workspace. Accepts either an existing profile_id
+        # or an email to resolve-or-invite. Idempotent for an already-active member. Admin
+        # only.
+        sig do
+          params(
+            workspace_id: String,
+            email: String,
+            profile_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::WorkspaceMember)
+        end
+        def add(
+          # The workspace to add the member to (path).
+          workspace_id,
+          # Email address to add (resolve-or-invite). Mutually exclusive with profile_id.
+          email: nil,
+          # An existing account profile to add. Mutually exclusive with email.
+          profile_id: nil,
+          request_options: {}
+        )
+        end
+
+        # Revokes a member's access by deactivating their actor; the member is immediately
+        # cut off. The underlying profile is not deleted. Admin only.
+        sig do
+          params(
+            profile_id: String,
+            workspace_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).void
+        end
+        def remove(
+          # The profile to remove from the workspace (path).
+          profile_id,
+          # The workspace to remove the member from (path).
+          workspace_id:,
+          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/workspace_admin/profiles.rbi

@@ -0,0 +1,42 @@
+# typed: strong
+
+module Cadenya
+  module Resources
+    class WorkspaceAdmin
+      # Administer workspaces across the account: create and archive workspaces and
+      # manage their membership. These operations are account-scoped and require the
+      # admin role (a token whose profile holds the WorkOS admin role); they live under
+      # /v1/account/workspaces rather than the workspace-scoped /v1/workspaces tree so
+      # an admin can manage any workspace in the account, including ones they are not
+      # themselves a member of.
+      class Profiles
+        # Searches the account's profiles for a member picker, with free-form name/email
+        # search and an optional type filter. Account-scoped; admin only.
+        sig do
+          params(
+            cursor: String,
+            limit: Integer,
+            query: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::Internal::CursorPagination[Cadenya::Profile])
+        end
+        def list(
+          # Pagination cursor from previous response
+          cursor: nil,
+          # Maximum number of results to return
+          limit: nil,
+          # Free-form search over profile name and email. Case-insensitive substring match;
+          # empty returns all profiles.
+          query: 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/workspace_admin.rbi

@@ -0,0 +1,131 @@
+# typed: strong
+
+module Cadenya
+  module Resources
+    # Administer workspaces across the account: create and archive workspaces and
+    # manage their membership. These operations are account-scoped and require the
+    # admin role (a token whose profile holds the WorkOS admin role); they live under
+    # /v1/account/workspaces rather than the workspace-scoped /v1/workspaces tree so
+    # an admin can manage any workspace in the account, including ones they are not
+    # themselves a member of.
+    class WorkspaceAdmin
+      # Administer workspaces across the account: create and archive workspaces and
+      # manage their membership. These operations are account-scoped and require the
+      # admin role (a token whose profile holds the WorkOS admin role); they live under
+      # /v1/account/workspaces rather than the workspace-scoped /v1/workspaces tree so
+      # an admin can manage any workspace in the account, including ones they are not
+      # themselves a member of.
+      sig { returns(Cadenya::Resources::WorkspaceAdmin::Members) }
+      attr_reader :members
+
+      # Administer workspaces across the account: create and archive workspaces and
+      # manage their membership. These operations are account-scoped and require the
+      # admin role (a token whose profile holds the WorkOS admin role); they live under
+      # /v1/account/workspaces rather than the workspace-scoped /v1/workspaces tree so
+      # an admin can manage any workspace in the account, including ones they are not
+      # themselves a member of.
+      sig { returns(Cadenya::Resources::WorkspaceAdmin::Profiles) }
+      attr_reader :profiles
+
+      # Creates a new workspace in the account. Admin only.
+      sig do
+        params(
+          metadata: Cadenya::WorkspaceAdminCreateParams::Metadata::OrHash,
+          spec: Cadenya::WorkspaceSpec::OrHash,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Workspace)
+      end
+      def create(
+        # CreateAccountResourceMetadata contains the user-provided fields for creating an
+        # account-scoped resource. Read-only fields (id, account_id, profile_id) are
+        # excluded since they are set by the server.
+        metadata:,
+        spec:,
+        request_options: {}
+      )
+      end
+
+      # Retrieves a workspace in the account by ID. Admin only.
+      sig do
+        params(
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Workspace)
+      end
+      def retrieve(
+        # Workspace ID to retrieve (path).
+        workspace_id,
+        request_options: {}
+      )
+      end
+
+      # Updates a workspace's metadata (e.g. name) and spec. Admin only.
+      sig do
+        params(
+          workspace_id: String,
+          metadata: Cadenya::WorkspaceAdminUpdateParams::Metadata::OrHash,
+          spec: Cadenya::WorkspaceSpec::OrHash,
+          update_mask: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Workspace)
+      end
+      def update(
+        # Workspace ID to update (path).
+        workspace_id,
+        # UpdateAccountResourceMetadata contains the user-provided fields for updating an
+        # account-scoped resource. Read-only fields (id, account_id, profile_id) are
+        # excluded since they are set by the server.
+        metadata: nil,
+        spec: nil,
+        # Fields to update.
+        update_mask: nil,
+        request_options: {}
+      )
+      end
+
+      # Lists every workspace in the account, optionally including archived ones. Admin
+      # only.
+      sig do
+        params(
+          cursor: String,
+          include_archived: T::Boolean,
+          limit: Integer,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Internal::CursorPagination[Cadenya::Workspace])
+      end
+      def list(
+        # Pagination cursor from previous response
+        cursor: nil,
+        # When true, archived workspaces are included in the results. Defaults to false
+        # (active workspaces only).
+        include_archived: nil,
+        # Maximum number of results to return
+        limit: nil,
+        request_options: {}
+      )
+      end
+
+      # Archives a workspace (soft delete). The workspace is retained, but any
+      # subsequent request scoped to it returns a permission error. Archiving the
+      # account's last active (non-archived) workspace is not allowed and returns
+      # FailedPrecondition. Admin only.
+      sig do
+        params(
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).void
+      end
+      def archive(
+        # Workspace ID to archive (path).
+        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/workspaces.rbi

@@ -4,6 +4,10 @@ module Cadenya
   module Resources
     # Manage workspaces within an account. Workspaces provide organizational grouping
     # and isolation for resources such as agents, tools, and API keys.
+    #
+    # This is the workspace-scoped, end-user surface. Administrative operations
+    # (create / archive workspaces, manage members) live in WorkspaceAdminService
+    # under /v1/account/workspaces and require the admin role.
     class Workspaces
       # Lists all workspaces for the current account
       sig do

data/sig/cadenya/client.rbs

@@ -12,6 +12,8 @@ module Cadenya
 
     attr_reader webhook_key: String?
 
+    attr_reader ai_provider_keys: Cadenya::Resources::AIProviderKeys
+
     attr_reader account: Cadenya::Resources::Account
 
     attr_reader agents: Cadenya::Resources::Agents
@@ -34,6 +36,8 @@ module Cadenya
 
     attr_reader workspaces: Cadenya::Resources::Workspaces
 
+    attr_reader workspace_admin: Cadenya::Resources::WorkspaceAdmin
+
     attr_reader webhooks: Cadenya::Resources::Webhooks
 
     attr_reader bulk_workspace_resources: Cadenya::Resources::BulkWorkspaceResources

data/sig/cadenya/models/agent_spec.rbs

@@ -5,7 +5,8 @@ module Cadenya
         status: Cadenya::Models::AgentSpec::status,
         variation_selection_mode: Cadenya::Models::AgentSpec::variation_selection_mode,
         description: String,
-        input_data_schema: top,
+        input_data_schema: ::Hash[Symbol, top],
+        output_definition: ::Hash[Symbol, top],
         webhook_events_url: String
       }
 
@@ -18,9 +19,13 @@ module Cadenya
 
       def description=: (String) -> String
 
-      attr_reader input_data_schema: top?
+      attr_reader input_data_schema: ::Hash[Symbol, top]?
 
-      def input_data_schema=: (top) -> top
+      def input_data_schema=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
+
+      attr_reader output_definition: ::Hash[Symbol, top]?
+
+      def output_definition=: (::Hash[Symbol, top]) -> ::Hash[Symbol, top]
 
       attr_reader webhook_events_url: String?
 
@@ -30,7 +35,8 @@ module Cadenya
         status: Cadenya::Models::AgentSpec::status,
         variation_selection_mode: Cadenya::Models::AgentSpec::variation_selection_mode,
         ?description: String,
-        ?input_data_schema: top,
+        ?input_data_schema: ::Hash[Symbol, top],
+        ?output_definition: ::Hash[Symbol, top],
         ?webhook_events_url: String
       ) -> void
 
@@ -38,7 +44,8 @@ module Cadenya
         status: Cadenya::Models::AgentSpec::status,
         variation_selection_mode: Cadenya::Models::AgentSpec::variation_selection_mode,
         description: String,
-        input_data_schema: top,
+        input_data_schema: ::Hash[Symbol, top],
+        output_definition: ::Hash[Symbol, top],
         webhook_events_url: String
       }
 

data/sig/cadenya/models/agents/webhook_delivery_data.rbs

@@ -104,6 +104,7 @@ module Cadenya
           | :OBJECTIVE_EVENT_TYPE_CANCELLED
           | :OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED
           | :OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED
+          | :OBJECTIVE_EVENT_TYPE_FINALIZED
 
         module EventType
           extend Cadenya::Internal::Type::Enum
@@ -123,6 +124,7 @@ module Cadenya
           OBJECTIVE_EVENT_TYPE_CANCELLED: :OBJECTIVE_EVENT_TYPE_CANCELLED
           OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED: :OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED
           OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED: :OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED
+          OBJECTIVE_EVENT_TYPE_FINALIZED: :OBJECTIVE_EVENT_TYPE_FINALIZED
 
           def self?.values: -> ::Array[Cadenya::Models::Agents::WebhookDeliveryData::event_type]
         end

data/sig/cadenya/models/agents/webhook_delivery_list_params.rbs

@@ -74,6 +74,7 @@ module Cadenya
           | :OBJECTIVE_EVENT_TYPE_CANCELLED
           | :OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED
           | :OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED
+          | :OBJECTIVE_EVENT_TYPE_FINALIZED
 
         module EventType
           extend Cadenya::Internal::Type::Enum
@@ -93,6 +94,7 @@ module Cadenya
           OBJECTIVE_EVENT_TYPE_CANCELLED: :OBJECTIVE_EVENT_TYPE_CANCELLED
           OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED: :OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED
           OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED: :OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED
+          OBJECTIVE_EVENT_TYPE_FINALIZED: :OBJECTIVE_EVENT_TYPE_FINALIZED
 
           def self?.values: -> ::Array[Cadenya::Models::Agents::WebhookDeliveryListParams::event_type]
         end

data/sig/cadenya/models/ai_provider_key.rbs

@@ -0,0 +1,22 @@
+module Cadenya
+  module Models
+    type ai_provider_key =
+      { metadata: Cadenya::ResourceMetadata, spec: Cadenya::AIProviderKeySpec }
+
+    class AIProviderKey < Cadenya::Internal::Type::BaseModel
+      attr_accessor metadata: Cadenya::ResourceMetadata
+
+      attr_accessor spec: Cadenya::AIProviderKeySpec
+
+      def initialize: (
+        metadata: Cadenya::ResourceMetadata,
+        spec: Cadenya::AIProviderKeySpec
+      ) -> void
+
+      def to_hash: -> {
+        metadata: Cadenya::ResourceMetadata,
+        spec: Cadenya::AIProviderKeySpec
+      }
+    end
+  end
+end

data/sig/cadenya/models/ai_provider_key_create_params.rbs

@@ -0,0 +1,36 @@
+module Cadenya
+  module Models
+    type ai_provider_key_create_params =
+      {
+        workspace_id: String,
+        metadata: Cadenya::CreateResourceMetadata,
+        spec: Cadenya::AIProviderKeySpec
+      }
+      & Cadenya::Internal::Type::request_parameters
+
+    class AIProviderKeyCreateParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      attr_accessor workspace_id: String
+
+      attr_accessor metadata: Cadenya::CreateResourceMetadata
+
+      attr_accessor spec: Cadenya::AIProviderKeySpec
+
+      def initialize: (
+        workspace_id: String,
+        metadata: Cadenya::CreateResourceMetadata,
+        spec: Cadenya::AIProviderKeySpec,
+        ?request_options: Cadenya::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        workspace_id: String,
+        metadata: Cadenya::CreateResourceMetadata,
+        spec: Cadenya::AIProviderKeySpec,
+        request_options: Cadenya::RequestOptions
+      }
+    end
+  end
+end

data/sig/cadenya/models/ai_provider_key_delete_params.rbs

@@ -0,0 +1,28 @@
+module Cadenya
+  module Models
+    type ai_provider_key_delete_params =
+      { workspace_id: String, id: String }
+      & Cadenya::Internal::Type::request_parameters
+
+    class AIProviderKeyDeleteParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      attr_accessor workspace_id: String
+
+      attr_accessor id: String
+
+      def initialize: (
+        workspace_id: String,
+        id: String,
+        ?request_options: Cadenya::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        workspace_id: String,
+        id: String,
+        request_options: Cadenya::RequestOptions
+      }
+    end
+  end
+end

data/sig/cadenya/models/ai_provider_key_list_params.rbs

@@ -0,0 +1,61 @@
+module Cadenya
+  module Models
+    type ai_provider_key_list_params =
+      {
+        workspace_id: String,
+        cursor: String,
+        limit: Integer,
+        prefix: String,
+        query: String,
+        sort_order: String
+      }
+      & Cadenya::Internal::Type::request_parameters
+
+    class AIProviderKeyListParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      attr_accessor workspace_id: String
+
+      attr_reader cursor: String?
+
+      def cursor=: (String) -> String
+
+      attr_reader limit: Integer?
+
+      def limit=: (Integer) -> Integer
+
+      attr_reader prefix: String?
+
+      def prefix=: (String) -> String
+
+      attr_reader query: String?
+
+      def query=: (String) -> String
+
+      attr_reader sort_order: String?
+
+      def sort_order=: (String) -> String
+
+      def initialize: (
+        workspace_id: String,
+        ?cursor: String,
+        ?limit: Integer,
+        ?prefix: String,
+        ?query: String,
+        ?sort_order: String,
+        ?request_options: Cadenya::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        workspace_id: String,
+        cursor: String,
+        limit: Integer,
+        prefix: String,
+        query: String,
+        sort_order: String,
+        request_options: Cadenya::RequestOptions
+      }
+    end
+  end
+end