cadenya 0.2.0 → 0.3.0

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

data/lib/cadenya.rb

@@ -120,8 +120,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 +148,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 +223,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 +235,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 +281,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"
@@ -309,5 +326,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

@@ -68,9 +68,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/approval_requirement_filter.rbi

@@ -0,0 +1,45 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class ApprovalRequirementFilter < Cadenya::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::ApprovalRequirementFilter, Cadenya::Internal::AnyHash)
+        end
+
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :always
+
+      sig { params(always: T::Boolean).void }
+      attr_writer :always
+
+      # Top-level filter with simple boolean logic (no nesting)
+      sig { returns(T.nilable(Cadenya::ToolFilter)) }
+      attr_reader :only
+
+      sig { params(only: Cadenya::ToolFilter::OrHash).void }
+      attr_writer :only
+
+      # Approval filters that will automatically set the approval requirement on tools
+      # synced from an external source
+      sig do
+        params(always: T::Boolean, only: Cadenya::ToolFilter::OrHash).returns(
+          T.attached_class
+        )
+      end
+      def self.new(
+        always: nil,
+        # Top-level filter with simple boolean logic (no nesting)
+        only: nil
+      )
+      end
+
+      sig do
+        override.returns({ always: T::Boolean, only: Cadenya::ToolFilter })
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cadenya/models/attribute_filter.rbi

@@ -0,0 +1,84 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class AttributeFilter < Cadenya::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::AttributeFilter, Cadenya::Internal::AnyHash)
+        end
+
+      sig { returns(Cadenya::AttributeFilter::Attribute::OrSymbol) }
+      attr_accessor :attribute
+
+      # String matching operations
+      sig { returns(T.nilable(Cadenya::StringMatcher)) }
+      attr_reader :matcher
+
+      sig { params(matcher: Cadenya::StringMatcher::OrHash).void }
+      attr_writer :matcher
+
+      # Single attribute filter
+      sig do
+        params(
+          attribute: Cadenya::AttributeFilter::Attribute::OrSymbol,
+          matcher: Cadenya::StringMatcher::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        attribute:,
+        # String matching operations
+        matcher: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            attribute: Cadenya::AttributeFilter::Attribute::OrSymbol,
+            matcher: Cadenya::StringMatcher
+          }
+        )
+      end
+      def to_hash
+      end
+
+      module Attribute
+        extend Cadenya::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, Cadenya::AttributeFilter::Attribute) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ATTRIBUTE_UNSPECIFIED =
+          T.let(
+            :ATTRIBUTE_UNSPECIFIED,
+            Cadenya::AttributeFilter::Attribute::TaggedSymbol
+          )
+        ATTRIBUTE_NAME =
+          T.let(
+            :ATTRIBUTE_NAME,
+            Cadenya::AttributeFilter::Attribute::TaggedSymbol
+          )
+        ATTRIBUTE_TITLE =
+          T.let(
+            :ATTRIBUTE_TITLE,
+            Cadenya::AttributeFilter::Attribute::TaggedSymbol
+          )
+        ATTRIBUTE_DESCRIPTION =
+          T.let(
+            :ATTRIBUTE_DESCRIPTION,
+            Cadenya::AttributeFilter::Attribute::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[Cadenya::AttributeFilter::Attribute::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end