cadenya 0.2.0 → 0.4.0

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.2.0"
+  VERSION = "0.4.0"
 end

data/lib/cadenya.rb

@@ -108,6 +108,13 @@ require_relative "cadenya/models/agent_schedule_entry"
 require_relative "cadenya/models/agent_spec"
 require_relative "cadenya/models/agent_update_params"
 require_relative "cadenya/models/agent_variation_entry"
+require_relative "cadenya/models/ai_provider_key"
+require_relative "cadenya/models/ai_provider_key_create_params"
+require_relative "cadenya/models/ai_provider_key_delete_params"
+require_relative "cadenya/models/ai_provider_key_list_params"
+require_relative "cadenya/models/ai_provider_key_retrieve_params"
+require_relative "cadenya/models/ai_provider_key_spec"
+require_relative "cadenya/models/ai_provider_key_update_params"
 require_relative "cadenya/models/api_key"
 require_relative "cadenya/models/api_key_create_params"
 require_relative "cadenya/models/api_key_delete_params"
@@ -120,8 +127,10 @@ require_relative "cadenya/models/api_keys/access_list_params"
 require_relative "cadenya/models/api_keys/access_remove_params"
 require_relative "cadenya/models/api_key_spec"
 require_relative "cadenya/models/api_key_update_params"
+require_relative "cadenya/models/approval_requirement_filter"
 require_relative "cadenya/models/assistant_message"
 require_relative "cadenya/models/assistant_tool_call"
+require_relative "cadenya/models/attribute_filter"
 require_relative "cadenya/models/bare_metadata"
 require_relative "cadenya/models/bulk_workspace_apply"
 require_relative "cadenya/models/bulk_workspace_apply_data"
@@ -146,7 +155,6 @@ require_relative "cadenya/models/callable_tool"
 require_relative "cadenya/models/context_window_compacted"
 require_relative "cadenya/models/create_operation_metadata"
 require_relative "cadenya/models/create_resource_metadata"
-require_relative "cadenya/models/mcp_tool_filter"
 require_relative "cadenya/models/memory_entry_item"
 require_relative "cadenya/models/memory_layer"
 require_relative "cadenya/models/memory_layer_create_params"
@@ -222,6 +230,7 @@ require_relative "cadenya/models/resource_metadata"
 require_relative "cadenya/models/rotate_webhook_signing_key_response"
 require_relative "cadenya/models/search_search_tools_or_tool_sets_params"
 require_relative "cadenya/models/search_search_tools_or_tool_sets_response"
+require_relative "cadenya/models/string_matcher"
 require_relative "cadenya/models/sub_agent_spawned"
 require_relative "cadenya/models/sub_agent_updated"
 require_relative "cadenya/models/sync_completed"
@@ -233,22 +242,27 @@ require_relative "cadenya/models/tool_called"
 require_relative "cadenya/models/tool_denied"
 require_relative "cadenya/models/tool_entry"
 require_relative "cadenya/models/tool_error"
+require_relative "cadenya/models/tool_filter"
 require_relative "cadenya/models/tool_result"
 require_relative "cadenya/models/tool_set"
 require_relative "cadenya/models/tool_set_adapter"
 require_relative "cadenya/models/tool_set_adapter_http"
 require_relative "cadenya/models/tool_set_adapter_mcp"
+require_relative "cadenya/models/tool_set_adapter_openapi"
 require_relative "cadenya/models/tool_set_create_params"
 require_relative "cadenya/models/tool_set_delete_params"
 require_relative "cadenya/models/tool_set_entry"
 require_relative "cadenya/models/tool_set_event"
 require_relative "cadenya/models/tool_set_event_data"
+require_relative "cadenya/models/tool_set_get_openapi_spec_params"
+require_relative "cadenya/models/tool_set_get_openapi_spec_response"
 require_relative "cadenya/models/tool_set_info"
 require_relative "cadenya/models/tool_set_list_events_params"
 require_relative "cadenya/models/tool_set_list_params"
 require_relative "cadenya/models/tool_set_retrieve_params"
 require_relative "cadenya/models/tool_sets/config_http"
 require_relative "cadenya/models/tool_sets/config_mcp"
+require_relative "cadenya/models/tool_sets/config_openapi"
 require_relative "cadenya/models/tool_sets/tool"
 require_relative "cadenya/models/tool_sets/tool_create_params"
 require_relative "cadenya/models/tool_sets/tool_delete_params"
@@ -274,8 +288,18 @@ require_relative "cadenya/models/variation_memory_layer_entry"
 require_relative "cadenya/models/webhook_unsafe_unwrap_params"
 require_relative "cadenya/models/webhook_unwrap_params"
 require_relative "cadenya/models/workspace"
+require_relative "cadenya/models/workspace_admin/member_add_params"
+require_relative "cadenya/models/workspace_admin/member_list_params"
+require_relative "cadenya/models/workspace_admin/member_remove_params"
+require_relative "cadenya/models/workspace_admin/profile_list_params"
+require_relative "cadenya/models/workspace_admin_archive_params"
+require_relative "cadenya/models/workspace_admin_create_params"
+require_relative "cadenya/models/workspace_admin_list_params"
+require_relative "cadenya/models/workspace_admin_retrieve_params"
+require_relative "cadenya/models/workspace_admin_update_params"
 require_relative "cadenya/models/workspace_get_params"
 require_relative "cadenya/models/workspace_list_params"
+require_relative "cadenya/models/workspace_member"
 require_relative "cadenya/models/workspace_secret"
 require_relative "cadenya/models/workspace_secret_create_params"
 require_relative "cadenya/models/workspace_secret_delete_params"
@@ -292,6 +316,7 @@ require_relative "cadenya/resources/agents/feedback"
 require_relative "cadenya/resources/agents/schedules"
 require_relative "cadenya/resources/agents/variations"
 require_relative "cadenya/resources/agents/webhook_deliveries"
+require_relative "cadenya/resources/ai_provider_keys"
 require_relative "cadenya/resources/api_keys"
 require_relative "cadenya/resources/api_keys/access"
 require_relative "cadenya/resources/bulk_workspace_resources"
@@ -309,5 +334,8 @@ require_relative "cadenya/resources/tool_sets"
 require_relative "cadenya/resources/tool_sets/tools"
 require_relative "cadenya/resources/uploads"
 require_relative "cadenya/resources/webhooks"
+require_relative "cadenya/resources/workspace_admin"
+require_relative "cadenya/resources/workspace_admin/members"
+require_relative "cadenya/resources/workspace_admin/profiles"
 require_relative "cadenya/resources/workspaces"
 require_relative "cadenya/resources/workspace_secrets"

data/rbi/cadenya/client.rbi

@@ -16,6 +16,9 @@ module Cadenya
     sig { returns(T.nilable(String)) }
     attr_reader :webhook_key
 
+    sig { returns(Cadenya::Resources::AIProviderKeys) }
+    attr_reader :ai_provider_keys
+
     # Manage the authenticated account. Accounts are the top-level organizational unit
     # and contain one or more workspaces.
     sig { returns(Cadenya::Resources::Account) }
@@ -68,9 +71,22 @@ module Cadenya
 
     # 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.
     sig { returns(Cadenya::Resources::Workspaces) }
     attr_reader :workspaces
 
+    # 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) }
+    attr_reader :workspace_admin
+
     sig { returns(Cadenya::Resources::Webhooks) }
     attr_reader :webhooks
 

data/rbi/cadenya/models/agent_spec.rbi

@@ -27,12 +27,22 @@ module Cadenya
       # data schema is also valuable when using an agent as a sub-agent, as the schema
       # is used as the tool's input parameter schema. If omitted, the sub-agent schema
       # will be loaded with a simple "prompt" free text string as its schema.
-      sig { returns(T.nilable(T.anything)) }
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
       attr_reader :input_data_schema
 
-      sig { params(input_data_schema: T.anything).void }
+      sig { params(input_data_schema: T::Hash[Symbol, T.anything]).void }
       attr_writer :input_data_schema
 
+      # Optional output definition for objectives created for this agent. When provided,
+      # Cadenya will append a tool to that will be called by the LLM in use by the
+      # variant to extract information in the format provided here. Use this option when
+      # you want structured data to be created by your objectives.
+      sig { returns(T.nilable(T::Hash[Symbol, T.anything])) }
+      attr_reader :output_definition
+
+      sig { params(output_definition: T::Hash[Symbol, T.anything]).void }
+      attr_writer :output_definition
+
       # The URL that Cadenya will send events for any objective assigned to the agent.
       sig { returns(T.nilable(String)) }
       attr_reader :webhook_events_url
@@ -47,7 +57,8 @@ module Cadenya
           variation_selection_mode:
             Cadenya::AgentSpec::VariationSelectionMode::OrSymbol,
           description: String,
-          input_data_schema: T.anything,
+          input_data_schema: T::Hash[Symbol, T.anything],
+          output_definition: T::Hash[Symbol, T.anything],
           webhook_events_url: String
         ).returns(T.attached_class)
       end
@@ -65,6 +76,11 @@ module Cadenya
         # is used as the tool's input parameter schema. If omitted, the sub-agent schema
         # will be loaded with a simple "prompt" free text string as its schema.
         input_data_schema: nil,
+        # Optional output definition for objectives created for this agent. When provided,
+        # Cadenya will append a tool to that will be called by the LLM in use by the
+        # variant to extract information in the format provided here. Use this option when
+        # you want structured data to be created by your objectives.
+        output_definition: nil,
         # The URL that Cadenya will send events for any objective assigned to the agent.
         webhook_events_url: nil
       )
@@ -77,7 +93,8 @@ module Cadenya
             variation_selection_mode:
               Cadenya::AgentSpec::VariationSelectionMode::OrSymbol,
             description: String,
-            input_data_schema: T.anything,
+            input_data_schema: T::Hash[Symbol, T.anything],
+            output_definition: T::Hash[Symbol, T.anything],
             webhook_events_url: String
           }
         )

data/rbi/cadenya/models/agents/webhook_delivery_data.rbi

@@ -223,6 +223,11 @@ module Cadenya
               :OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED,
               Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
             )
+          OBJECTIVE_EVENT_TYPE_FINALIZED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_FINALIZED,
+              Cadenya::Agents::WebhookDeliveryData::EventType::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/cadenya/models/agents/webhook_delivery_list_params.rbi

@@ -192,6 +192,11 @@ module Cadenya
               :OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED,
               Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
             )
+          OBJECTIVE_EVENT_TYPE_FINALIZED =
+            T.let(
+              :OBJECTIVE_EVENT_TYPE_FINALIZED,
+              Cadenya::Agents::WebhookDeliveryListParams::EventType::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/cadenya/models/ai_provider_key.rbi

@@ -0,0 +1,51 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class AIProviderKey < Cadenya::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::AIProviderKey, Cadenya::Internal::AnyHash)
+        end
+
+      # Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+      sig { returns(Cadenya::ResourceMetadata) }
+      attr_reader :metadata
+
+      sig { params(metadata: Cadenya::ResourceMetadata::OrHash).void }
+      attr_writer :metadata
+
+      sig { returns(Cadenya::AIProviderKeySpec) }
+      attr_reader :spec
+
+      sig { params(spec: Cadenya::AIProviderKeySpec::OrHash).void }
+      attr_writer :spec
+
+      # AIProviderKey is a customer-provided (BYOK) credential for an AI provider,
+      # scoped to a workspace. The secret value is never returned in responses.
+      sig do
+        params(
+          metadata: Cadenya::ResourceMetadata::OrHash,
+          spec: Cadenya::AIProviderKeySpec::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+        metadata:,
+        spec:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            metadata: Cadenya::ResourceMetadata,
+            spec: Cadenya::AIProviderKeySpec
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cadenya/models/ai_provider_key_create_params.rbi

@@ -0,0 +1,65 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class AIProviderKeyCreateParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::AIProviderKeyCreateParams, Cadenya::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :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.
+      sig { returns(Cadenya::CreateResourceMetadata) }
+      attr_reader :metadata
+
+      sig { params(metadata: Cadenya::CreateResourceMetadata::OrHash).void }
+      attr_writer :metadata
+
+      sig { returns(Cadenya::AIProviderKeySpec) }
+      attr_reader :spec
+
+      sig { params(spec: Cadenya::AIProviderKeySpec::OrHash).void }
+      attr_writer :spec
+
+      sig do
+        params(
+          workspace_id: String,
+          metadata: Cadenya::CreateResourceMetadata::OrHash,
+          spec: Cadenya::AIProviderKeySpec::OrHash,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        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
+
+      sig do
+        override.returns(
+          {
+            workspace_id: String,
+            metadata: Cadenya::CreateResourceMetadata,
+            spec: Cadenya::AIProviderKeySpec,
+            request_options: Cadenya::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cadenya/models/ai_provider_key_delete_params.rbi

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

data/rbi/cadenya/models/ai_provider_key_list_params.rbi

@@ -0,0 +1,96 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class AIProviderKeyListParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::AIProviderKeyListParams, Cadenya::Internal::AnyHash)
+        end
+
+      sig { returns(String) }
+      attr_accessor :workspace_id
+
+      # Pagination cursor from previous response
+      sig { returns(T.nilable(String)) }
+      attr_reader :cursor
+
+      sig { params(cursor: String).void }
+      attr_writer :cursor
+
+      # Maximum number of results to return
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :limit
+
+      sig { params(limit: Integer).void }
+      attr_writer :limit
+
+      # Filter expression (query param: prefix)
+      sig { returns(T.nilable(String)) }
+      attr_reader :prefix
+
+      sig { params(prefix: String).void }
+      attr_writer :prefix
+
+      # Free-form search query
+      sig { returns(T.nilable(String)) }
+      attr_reader :query
+
+      sig { params(query: String).void }
+      attr_writer :query
+
+      # Sort order for results (asc or desc by creation time)
+      sig { returns(T.nilable(String)) }
+      attr_reader :sort_order
+
+      sig { params(sort_order: String).void }
+      attr_writer :sort_order
+
+      sig do
+        params(
+          workspace_id: String,
+          cursor: String,
+          limit: Integer,
+          prefix: String,
+          query: String,
+          sort_order: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        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
+
+      sig do
+        override.returns(
+          {
+            workspace_id: String,
+            cursor: String,
+            limit: Integer,
+            prefix: String,
+            query: String,
+            sort_order: String,
+            request_options: Cadenya::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end