cadenya 0.1.0 → 0.3.0

data/lib/cadenya/models/workspace_admin_update_params.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::WorkspaceAdmin#update
+    class WorkspaceAdminUpdateParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      # @!attribute workspace_id
+      #
+      #   @return [String]
+      required :workspace_id, String
+
+      # @!attribute metadata
+      #   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.
+      #
+      #   @return [Cadenya::Models::WorkspaceAdminUpdateParams::Metadata, nil]
+      optional :metadata, -> { Cadenya::WorkspaceAdminUpdateParams::Metadata }
+
+      # @!attribute spec
+      #
+      #   @return [Cadenya::Models::WorkspaceSpec, nil]
+      optional :spec, -> { Cadenya::WorkspaceSpec }
+
+      # @!attribute update_mask
+      #   Fields to update.
+      #
+      #   @return [String, nil]
+      optional :update_mask, String, api_name: :updateMask
+
+      # @!method initialize(workspace_id:, metadata: nil, spec: nil, update_mask: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::WorkspaceAdminUpdateParams} for more details.
+      #
+      #   @param workspace_id [String]
+      #
+      #   @param metadata [Cadenya::Models::WorkspaceAdminUpdateParams::Metadata] UpdateAccountResourceMetadata contains the user-provided fields for updating
+      #
+      #   @param spec [Cadenya::Models::WorkspaceSpec]
+      #
+      #   @param update_mask [String] Fields to update.
+      #
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+
+      class Metadata < Cadenya::Internal::Type::BaseModel
+        # @!attribute name
+        #   Human-readable name for the resource (e.g., "Production API Key", "Staging
+        #   Workspace")
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute external_id
+        #   External ID for the resource (e.g., a workflow ID from an external system)
+        #
+        #   @return [String, nil]
+        optional :external_id, String, api_name: :externalId
+
+        # @!attribute labels
+        #   Arbitrary key-value pairs for categorization and filtering Examples:
+        #   {"environment": "production", "team": "platform", "version": "v2"}
+        #
+        #   @return [Hash{Symbol=>String}, nil]
+        optional :labels, Cadenya::Internal::Type::HashOf[String]
+
+        # @!method initialize(name:, external_id: nil, labels: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::WorkspaceAdminUpdateParams::Metadata} for more details.
+        #
+        #   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.
+        #
+        #   @param name [String] Human-readable name for the resource (e.g., "Production API Key", "Staging Works
+        #
+        #   @param external_id [String] External ID for the resource (e.g., a workflow ID from an external system)
+        #
+        #   @param labels [Hash{Symbol=>String}] Arbitrary key-value pairs for categorization and filtering
+      end
+    end
+  end
+end

data/lib/cadenya/models/workspace_member.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class WorkspaceMember < Cadenya::Internal::Type::BaseModel
+      response_only do
+        # @!attribute actor_id
+        #   The actor row linking the profile to the workspace (the junction record).
+        #
+        #   @return [String]
+        required :actor_id, String, api_name: :actorId
+
+        # @!attribute profile_id
+        #   The account profile that has access to the workspace.
+        #
+        #   @return [String]
+        required :profile_id, String, api_name: :profileId
+
+        # @!attribute added_at
+        #   When the member was added to the workspace.
+        #
+        #   @return [Time, nil]
+        optional :added_at, Time, api_name: :addedAt
+
+        # @!attribute email
+        #   Email address of the member's profile.
+        #
+        #   @return [String, nil]
+        optional :email, String
+
+        # @!attribute name
+        #   Display name of the member's profile.
+        #
+        #   @return [String, nil]
+        optional :name, String
+      end
+
+      # @!method initialize(actor_id:, profile_id:, added_at: nil, email: nil, name: nil)
+      #   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.
+      #
+      #   @param actor_id [String] The actor row linking the profile to the workspace (the junction record).
+      #
+      #   @param profile_id [String] The account profile that has access to the workspace.
+      #
+      #   @param added_at [Time] When the member was added to the workspace.
+      #
+      #   @param email [String] Email address of the member's profile.
+      #
+      #   @param name [String] Display name of the member's profile.
+    end
+  end
+end

data/lib/cadenya/models.rb

@@ -95,10 +95,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
@@ -125,8 +129,6 @@ module Cadenya
 
   CreateResourceMetadata = Cadenya::Models::CreateResourceMetadata
 
-  McpToolFilter = Cadenya::Models::McpToolFilter
-
   MemoryEntryItem = Cadenya::Models::MemoryEntryItem
 
   MemoryLayer = Cadenya::Models::MemoryLayer
@@ -217,7 +219,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
 
@@ -237,6 +243,8 @@ module Cadenya
 
   ToolError = Cadenya::Models::ToolError
 
+  ToolFilter = Cadenya::Models::ToolFilter
+
   ToolResult = Cadenya::Models::ToolResult
 
   ToolSet = Cadenya::Models::ToolSet
@@ -247,6 +255,8 @@ module Cadenya
 
   ToolSetAdapterMcp = Cadenya::Models::ToolSetAdapterMcp
 
+  ToolSetAdapterOpenAPI = Cadenya::Models::ToolSetAdapterOpenAPI
+
   ToolSetCreateParams = Cadenya::Models::ToolSetCreateParams
 
   ToolSetDeleteParams = Cadenya::Models::ToolSetDeleteParams
@@ -257,6 +267,8 @@ module Cadenya
 
   ToolSetEventData = Cadenya::Models::ToolSetEventData
 
+  ToolSetGetOpenAPISpecParams = Cadenya::Models::ToolSetGetOpenAPISpecParams
+
   ToolSetInfo = Cadenya::Models::ToolSetInfo
 
   ToolSetListEventsParams = Cadenya::Models::ToolSetListEventsParams
@@ -299,10 +311,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/lib/cadenya/resources/objectives.rb

@@ -20,7 +20,7 @@ module Cadenya
       #
       # Creates a new objective in the workspace
       #
-      # @overload create(workspace_id, agent_id:, data:, metadata:, variation_id: nil, request_options: {})
+      # @overload create(workspace_id, agent_id:, data:, metadata: nil, variation_id: nil, request_options: {})
       #
       # @param workspace_id [String]
       #
@@ -269,7 +269,7 @@ module Cadenya
 
       # Lists all events for an objective
       #
-      # @overload list_events(objective_id, workspace_id:, cursor: nil, include_info: nil, limit: nil, sort_order: nil, window_id: nil, request_options: {})
+      # @overload list_events(objective_id, workspace_id:, cursor: nil, include_info: nil, limit: nil, since_event_id: nil, sort_order: nil, window_id: nil, request_options: {})
       #
       # @param objective_id [String] Path param: Objective ID for filtering
       #
@@ -281,6 +281,8 @@ module Cadenya
       #
       # @param limit [Integer] Query param: Maximum number of results to return
       #
+      # @param since_event_id [String] Query param: Optional string to fetch events since an ID
+      #
       # @param sort_order [String] Query param: Sort order for results (asc or desc by creation time)
       #
       # @param window_id [String] Query param: Optional context window ID to filter events by
@@ -302,6 +304,7 @@ module Cadenya
           path: ["v1/workspaces/%1$s/objectives/%2$s/events", workspace_id, objective_id],
           query: query.transform_keys(
             include_info: "includeInfo",
+            since_event_id: "sinceEventId",
             sort_order: "sortOrder",
             window_id: "windowId"
           ),

data/lib/cadenya/resources/tool_sets.rb

@@ -184,6 +184,37 @@ module Cadenya
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::ToolSetGetOpenAPISpecParams} for more details.
+      #
+      # Retrieves the current OpenAPI specification JSON that has been consumed by the
+      # tool set. Only applicable to tool sets using the OpenAPI adapter.
+      #
+      # @overload get_openapi_spec(tool_set_id, workspace_id:, request_options: {})
+      #
+      # @param tool_set_id [String] Tool set ID. Accepts the canonical ts\_… form or the
+      #
+      # @param workspace_id [String] Workspace ID.
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::ToolSetGetOpenAPISpecResponse]
+      #
+      # @see Cadenya::Models::ToolSetGetOpenAPISpecParams
+      def get_openapi_spec(tool_set_id, params)
+        parsed, options = Cadenya::ToolSetGetOpenAPISpecParams.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/tool_sets/%2$s/openapi_spec", workspace_id, tool_set_id],
+          model: Cadenya::Models::ToolSetGetOpenAPISpecResponse,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {Cadenya::Models::ToolSetListEventsParams} for more details.
       #

data/lib/cadenya/resources/workspace_admin/members.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+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.
+        #
+        # @overload list(workspace_id, cursor: nil, limit: nil, request_options: {})
+        #
+        # @param workspace_id [String] The workspace whose members will be listed (path).
+        #
+        # @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::WorkspaceMember>]
+        #
+        # @see Cadenya::Models::WorkspaceAdmin::MemberListParams
+        def list(workspace_id, params = {})
+          parsed, options = Cadenya::WorkspaceAdmin::MemberListParams.dump_request(params)
+          query = Cadenya::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: ["v1/account/workspaces/%1$s/members", workspace_id],
+            query: query,
+            page: Cadenya::Internal::CursorPagination,
+            model: Cadenya::WorkspaceMember,
+            options: 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.
+        #
+        # @overload add(workspace_id, email: nil, profile_id: nil, request_options: {})
+        #
+        # @param workspace_id [String] The workspace to add the member to (path).
+        #
+        # @param email [String] Email address to add (resolve-or-invite). Mutually exclusive with profile_id.
+        #
+        # @param profile_id [String] An existing account profile to add. Mutually exclusive with email.
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Models::WorkspaceMember]
+        #
+        # @see Cadenya::Models::WorkspaceAdmin::MemberAddParams
+        def add(workspace_id, params = {})
+          parsed, options = Cadenya::WorkspaceAdmin::MemberAddParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: ["v1/account/workspaces/%1$s/members", workspace_id],
+            body: parsed,
+            model: Cadenya::WorkspaceMember,
+            options: 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.
+        #
+        # @overload remove(profile_id, workspace_id:, request_options: {})
+        #
+        # @param profile_id [String] The profile to remove from the workspace (path).
+        #
+        # @param workspace_id [String] The workspace to remove the member from (path).
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [nil]
+        #
+        # @see Cadenya::Models::WorkspaceAdmin::MemberRemoveParams
+        def remove(profile_id, params)
+          parsed, options = Cadenya::WorkspaceAdmin::MemberRemoveParams.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/account/workspaces/%1$s/members/%2$s", workspace_id, profile_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/workspace_admin/profiles.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+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
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::WorkspaceAdmin::ProfileListParams} for more details.
+        #
+        # Searches the account's profiles for a member picker, with free-form name/email
+        # search and an optional type filter. Account-scoped; admin only.
+        #
+        # @overload list(cursor: nil, limit: nil, query: nil, request_options: {})
+        #
+        # @param cursor [String] Pagination cursor from previous response
+        #
+        # @param limit [Integer] Maximum number of results to return
+        #
+        # @param query [String] Free-form search over profile name and email. Case-insensitive substring
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Internal::CursorPagination<Cadenya::Models::Profile>]
+        #
+        # @see Cadenya::Models::WorkspaceAdmin::ProfileListParams
+        def list(params = {})
+          parsed, options = Cadenya::WorkspaceAdmin::ProfileListParams.dump_request(params)
+          query = Cadenya::Internal::Util.encode_query_params(parsed)
+          @client.request(
+            method: :get,
+            path: "v1/account/profiles",
+            query: query,
+            page: Cadenya::Internal::CursorPagination,
+            model: Cadenya::Profile,
+            options: options
+          )
+        end
+
+        # @api private
+        #
+        # @param client [Cadenya::Client]
+        def initialize(client:)
+          @client = client
+        end
+      end
+    end
+  end
+end

data/lib/cadenya/resources/workspace_admin.rb

@@ -0,0 +1,173 @@
+# frozen_string_literal: true
+
+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.
+      # @return [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.
+      # @return [Cadenya::Resources::WorkspaceAdmin::Profiles]
+      attr_reader :profiles
+
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::WorkspaceAdminCreateParams} for more details.
+      #
+      # Creates a new workspace in the account. Admin only.
+      #
+      # @overload create(metadata:, spec:, request_options: {})
+      #
+      # @param metadata [Cadenya::Models::WorkspaceAdminCreateParams::Metadata] CreateAccountResourceMetadata contains the user-provided fields for creating
+      #
+      # @param spec [Cadenya::Models::WorkspaceSpec]
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::Workspace]
+      #
+      # @see Cadenya::Models::WorkspaceAdminCreateParams
+      def create(params)
+        parsed, options = Cadenya::WorkspaceAdminCreateParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "v1/account/workspaces",
+          body: parsed,
+          model: Cadenya::Workspace,
+          options: options
+        )
+      end
+
+      # Retrieves a workspace in the account by ID. Admin only.
+      #
+      # @overload retrieve(workspace_id, request_options: {})
+      #
+      # @param workspace_id [String] Workspace ID to retrieve (path).
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::Workspace]
+      #
+      # @see Cadenya::Models::WorkspaceAdminRetrieveParams
+      def retrieve(workspace_id, params = {})
+        @client.request(
+          method: :get,
+          path: ["v1/account/workspaces/%1$s", workspace_id],
+          model: Cadenya::Workspace,
+          options: params[:request_options]
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::WorkspaceAdminUpdateParams} for more details.
+      #
+      # Updates a workspace's metadata (e.g. name) and spec. Admin only.
+      #
+      # @overload update(workspace_id, metadata: nil, spec: nil, update_mask: nil, request_options: {})
+      #
+      # @param workspace_id [String] Workspace ID to update (path).
+      #
+      # @param metadata [Cadenya::Models::WorkspaceAdminUpdateParams::Metadata] UpdateAccountResourceMetadata contains the user-provided fields for updating
+      #
+      # @param spec [Cadenya::Models::WorkspaceSpec]
+      #
+      # @param update_mask [String] Fields to update.
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::Workspace]
+      #
+      # @see Cadenya::Models::WorkspaceAdminUpdateParams
+      def update(workspace_id, params = {})
+        parsed, options = Cadenya::WorkspaceAdminUpdateParams.dump_request(params)
+        @client.request(
+          method: :patch,
+          path: ["v1/account/workspaces/%1$s", workspace_id],
+          body: parsed,
+          model: Cadenya::Workspace,
+          options: options
+        )
+      end
+
+      # Some parameter documentations has been truncated, see
+      # {Cadenya::Models::WorkspaceAdminListParams} for more details.
+      #
+      # Lists every workspace in the account, optionally including archived ones. Admin
+      # only.
+      #
+      # @overload list(cursor: nil, include_archived: nil, limit: nil, request_options: {})
+      #
+      # @param cursor [String] Pagination cursor from previous response
+      #
+      # @param include_archived [Boolean] When true, archived workspaces are included in the results. Defaults to
+      #
+      # @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::WorkspaceAdminListParams
+      def list(params = {})
+        parsed, options = Cadenya::WorkspaceAdminListParams.dump_request(params)
+        query = Cadenya::Internal::Util.encode_query_params(parsed)
+        @client.request(
+          method: :get,
+          path: "v1/account/workspaces",
+          query: query.transform_keys(include_archived: "includeArchived"),
+          page: Cadenya::Internal::CursorPagination,
+          model: Cadenya::Workspace,
+          options: 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.
+      #
+      # @overload archive(workspace_id, request_options: {})
+      #
+      # @param workspace_id [String] Workspace ID to archive (path).
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [nil]
+      #
+      # @see Cadenya::Models::WorkspaceAdminArchiveParams
+      def archive(workspace_id, params = {})
+        @client.request(
+          method: :delete,
+          path: ["v1/account/workspaces/%1$s", workspace_id],
+          model: NilClass,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [Cadenya::Client]
+      def initialize(client:)
+        @client = client
+        @members = Cadenya::Resources::WorkspaceAdmin::Members.new(client: client)
+        @profiles = Cadenya::Resources::WorkspaceAdmin::Profiles.new(client: client)
+      end
+    end
+  end
+end

data/lib/cadenya/resources/workspaces.rb

@@ -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
       #

data/lib/cadenya/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Cadenya
-  VERSION = "0.1.0"
+  VERSION = "0.3.0"
 end