cadenya 0.1.0 → 0.3.0

data/rbi/cadenya/models/workspace_admin_retrieve_params.rbi

@@ -0,0 +1,38 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class WorkspaceAdminRetrieveParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            Cadenya::WorkspaceAdminRetrieveParams,
+            Cadenya::Internal::AnyHash
+          )
+        end
+
+      sig { returns(String) }
+      attr_accessor :workspace_id
+
+      sig do
+        params(
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(workspace_id:, request_options: {})
+      end
+
+      sig do
+        override.returns(
+          { workspace_id: String, request_options: Cadenya::RequestOptions }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cadenya/models/workspace_admin_update_params.rbi

@@ -0,0 +1,144 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class WorkspaceAdminUpdateParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::WorkspaceAdminUpdateParams, Cadenya::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :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.
+      sig { returns(T.nilable(Cadenya::WorkspaceAdminUpdateParams::Metadata)) }
+      attr_reader :metadata
+
+      sig do
+        params(
+          metadata: Cadenya::WorkspaceAdminUpdateParams::Metadata::OrHash
+        ).void
+      end
+      attr_writer :metadata
+
+      sig { returns(T.nilable(Cadenya::WorkspaceSpec)) }
+      attr_reader :spec
+
+      sig { params(spec: Cadenya::WorkspaceSpec::OrHash).void }
+      attr_writer :spec
+
+      # Fields to update.
+      sig { returns(T.nilable(String)) }
+      attr_reader :update_mask
+
+      sig { params(update_mask: String).void }
+      attr_writer :update_mask
+
+      sig do
+        params(
+          workspace_id: String,
+          metadata: Cadenya::WorkspaceAdminUpdateParams::Metadata::OrHash,
+          spec: Cadenya::WorkspaceSpec::OrHash,
+          update_mask: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        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
+
+      sig do
+        override.returns(
+          {
+            workspace_id: String,
+            metadata: Cadenya::WorkspaceAdminUpdateParams::Metadata,
+            spec: Cadenya::WorkspaceSpec,
+            update_mask: String,
+            request_options: Cadenya::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Metadata < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::WorkspaceAdminUpdateParams::Metadata,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        # Human-readable name for the resource (e.g., "Production API Key", "Staging
+        # Workspace")
+        sig { returns(String) }
+        attr_accessor :name
+
+        # External ID for the resource (e.g., a workflow ID from an external system)
+        sig { returns(T.nilable(String)) }
+        attr_reader :external_id
+
+        sig { params(external_id: String).void }
+        attr_writer :external_id
+
+        # Arbitrary key-value pairs for categorization and filtering Examples:
+        # {"environment": "production", "team": "platform", "version": "v2"}
+        sig { returns(T.nilable(T::Hash[Symbol, String])) }
+        attr_reader :labels
+
+        sig { params(labels: T::Hash[Symbol, String]).void }
+        attr_writer :labels
+
+        # 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.
+        sig do
+          params(
+            name: String,
+            external_id: String,
+            labels: T::Hash[Symbol, String]
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Human-readable name for the resource (e.g., "Production API Key", "Staging
+          # Workspace")
+          name:,
+          # External ID for the resource (e.g., a workflow ID from an external system)
+          external_id: nil,
+          # Arbitrary key-value pairs for categorization and filtering Examples:
+          # {"environment": "production", "team": "platform", "version": "v2"}
+          labels: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              name: String,
+              external_id: String,
+              labels: T::Hash[Symbol, String]
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models/workspace_member.rbi

@@ -0,0 +1,80 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class WorkspaceMember < Cadenya::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::WorkspaceMember, Cadenya::Internal::AnyHash)
+        end
+
+      # The actor row linking the profile to the workspace (the junction record).
+      sig { returns(String) }
+      attr_accessor :actor_id
+
+      # The account profile that has access to the workspace.
+      sig { returns(String) }
+      attr_accessor :profile_id
+
+      # When the member was added to the workspace.
+      sig { returns(T.nilable(Time)) }
+      attr_reader :added_at
+
+      sig { params(added_at: Time).void }
+      attr_writer :added_at
+
+      # Email address of the member's profile.
+      sig { returns(T.nilable(String)) }
+      attr_reader :email
+
+      sig { params(email: String).void }
+      attr_writer :email
+
+      # Display name of the member's profile.
+      sig { returns(T.nilable(String)) }
+      attr_reader :name
+
+      sig { params(name: String).void }
+      attr_writer :name
+
+      # A member of a workspace: the profile granted access plus the actor row that
+      # links it to the workspace. Returned by member list/add operations.
+      sig do
+        params(
+          actor_id: String,
+          profile_id: String,
+          added_at: Time,
+          email: String,
+          name: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The actor row linking the profile to the workspace (the junction record).
+        actor_id:,
+        # The account profile that has access to the workspace.
+        profile_id:,
+        # When the member was added to the workspace.
+        added_at: nil,
+        # Email address of the member's profile.
+        email: nil,
+        # Display name of the member's profile.
+        name: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            actor_id: String,
+            profile_id: String,
+            added_at: Time,
+            email: String,
+            name: String
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cadenya/models.rbi

@@ -58,10 +58,14 @@ module Cadenya
 
   APIKeyUpdateParams = Cadenya::Models::APIKeyUpdateParams
 
+  ApprovalRequirementFilter = Cadenya::Models::ApprovalRequirementFilter
+
   AssistantMessage = Cadenya::Models::AssistantMessage
 
   AssistantToolCall = Cadenya::Models::AssistantToolCall
 
+  AttributeFilter = Cadenya::Models::AttributeFilter
+
   BareMetadata = Cadenya::Models::BareMetadata
 
   BulkWorkspaceApply = Cadenya::Models::BulkWorkspaceApply
@@ -91,8 +95,6 @@ module Cadenya
 
   CreateResourceMetadata = Cadenya::Models::CreateResourceMetadata
 
-  McpToolFilter = Cadenya::Models::McpToolFilter
-
   MemoryEntryItem = Cadenya::Models::MemoryEntryItem
 
   MemoryLayer = Cadenya::Models::MemoryLayer
@@ -186,7 +188,11 @@ module Cadenya
   SearchSearchToolsOrToolSetsParams =
     Cadenya::Models::SearchSearchToolsOrToolSetsParams
 
-  SubObjectiveCreated = Cadenya::Models::SubObjectiveCreated
+  StringMatcher = Cadenya::Models::StringMatcher
+
+  SubAgentSpawned = Cadenya::Models::SubAgentSpawned
+
+  SubAgentUpdated = Cadenya::Models::SubAgentUpdated
 
   SyncCompleted = Cadenya::Models::SyncCompleted
 
@@ -206,6 +212,8 @@ module Cadenya
 
   ToolError = Cadenya::Models::ToolError
 
+  ToolFilter = Cadenya::Models::ToolFilter
+
   ToolResult = Cadenya::Models::ToolResult
 
   ToolSet = Cadenya::Models::ToolSet
@@ -216,6 +224,8 @@ module Cadenya
 
   ToolSetAdapterMcp = Cadenya::Models::ToolSetAdapterMcp
 
+  ToolSetAdapterOpenAPI = Cadenya::Models::ToolSetAdapterOpenAPI
+
   ToolSetCreateParams = Cadenya::Models::ToolSetCreateParams
 
   ToolSetDeleteParams = Cadenya::Models::ToolSetDeleteParams
@@ -226,6 +236,8 @@ module Cadenya
 
   ToolSetEventData = Cadenya::Models::ToolSetEventData
 
+  ToolSetGetOpenAPISpecParams = Cadenya::Models::ToolSetGetOpenAPISpecParams
+
   ToolSetInfo = Cadenya::Models::ToolSetInfo
 
   ToolSetListEventsParams = Cadenya::Models::ToolSetListEventsParams
@@ -268,10 +280,24 @@ module Cadenya
 
   Workspace = Cadenya::Models::Workspace
 
+  WorkspaceAdmin = Cadenya::Models::WorkspaceAdmin
+
+  WorkspaceAdminArchiveParams = Cadenya::Models::WorkspaceAdminArchiveParams
+
+  WorkspaceAdminCreateParams = Cadenya::Models::WorkspaceAdminCreateParams
+
+  WorkspaceAdminListParams = Cadenya::Models::WorkspaceAdminListParams
+
+  WorkspaceAdminRetrieveParams = Cadenya::Models::WorkspaceAdminRetrieveParams
+
+  WorkspaceAdminUpdateParams = Cadenya::Models::WorkspaceAdminUpdateParams
+
   WorkspaceGetParams = Cadenya::Models::WorkspaceGetParams
 
   WorkspaceListParams = Cadenya::Models::WorkspaceListParams
 
+  WorkspaceMember = Cadenya::Models::WorkspaceMember
+
   WorkspaceSecret = Cadenya::Models::WorkspaceSecret
 
   WorkspaceSecretCreateParams = Cadenya::Models::WorkspaceSecretCreateParams

data/rbi/cadenya/resources/objectives.rbi

@@ -33,7 +33,7 @@ module Cadenya
         # CreateOperationMetadata contains the user-provided fields for creating an
         # operation. Read-only fields (id, account_id, workspace_id, created_at,
         # profile_id) are excluded since they are set by the server.
-        metadata:,
+        metadata: nil,
         # Optional explicit variation selection. Overrides the agent's
         # variation_selection_mode.
         variation_id: nil,
@@ -207,6 +207,7 @@ module Cadenya
           cursor: String,
           include_info: T::Boolean,
           limit: Integer,
+          since_event_id: String,
           sort_order: String,
           window_id: String,
           request_options: Cadenya::RequestOptions::OrHash
@@ -227,6 +228,8 @@ module Cadenya
         include_info: nil,
         # Query param: Maximum number of results to return
         limit: nil,
+        # Query param: Optional string to fetch events since an ID
+        since_event_id: nil,
         # Query param: Sort order for results (asc or desc by creation time)
         sort_order: nil,
         # Query param: Optional context window ID to filter events by

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

@@ -34,6 +34,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