cadenya 0.1.0

data/lib/cadenya/internal.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Internal
+    extend Cadenya::Internal::Util::SorbetRuntimeSupport
+
+    OMIT =
+      Object.new.tap do
+        _1.define_singleton_method(:inspect) { "#<#{Cadenya::Internal}::OMIT>" }
+      end
+        .freeze
+
+    define_sorbet_constant!(:AnyHash) do
+      T.type_alias { T::Hash[Symbol, T.anything] }
+    end
+    define_sorbet_constant!(:FileInput) do
+      T.type_alias { T.any(Pathname, StringIO, IO, String, Cadenya::FilePart) }
+    end
+  end
+end

data/lib/cadenya/models/account.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Account#retrieve
+    class AccountAPI < Cadenya::Internal::Type::BaseModel
+      # @!attribute info
+      #   Server-populated information about the account.
+      #
+      #   @return [Cadenya::Models::AccountInfo]
+      required :info, -> { Cadenya::AccountInfo }
+
+      # @!attribute metadata
+      #   AccountResourceMetadata is used to represent a resource that is associated to an
+      #   account but not to a workspace.
+      #
+      #   @return [Cadenya::Models::AccountResourceMetadata]
+      required :metadata, -> { Cadenya::AccountResourceMetadata }
+
+      # @!attribute spec
+      #   Configuration for an account.
+      #
+      #   @return [Cadenya::Models::AccountSpec]
+      required :spec, -> { Cadenya::AccountSpec }
+
+      # @!method initialize(info:, metadata:, spec:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::AccountAPI} for more details.
+      #
+      #   An account, the top-level organizational unit. Contains workspaces and
+      #   account-wide settings such as the webhook signing secret.
+      #
+      #   @param info [Cadenya::Models::AccountInfo] Server-populated information about the account.
+      #
+      #   @param metadata [Cadenya::Models::AccountResourceMetadata] AccountResourceMetadata is used to represent a resource that is associated to an
+      #
+      #   @param spec [Cadenya::Models::AccountSpec] Configuration for an account.
+    end
+  end
+end

data/lib/cadenya/models/account_info.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class AccountInfo < Cadenya::Internal::Type::BaseModel
+      response_only do
+        # @!attribute global_api_key
+        #   An API key for the account. Use workspace-association RPCs to grant the key
+        #   access to specific workspaces; a key with zero workspaces is valid but cannot
+        #   access workspace-scoped resources.
+        #
+        #   @return [Cadenya::Models::APIKey, nil]
+        optional :global_api_key, -> { Cadenya::APIKey }, api_name: :globalApiKey
+
+        # @!attribute webhook_events_hmac_secret
+        #   The generated secret that will sign all webhooks that are sent to your
+        #   configured Webhook URL. Formatted as "wh_asdf1234" per the
+        #   https://www.standardwebhooks.com/ format.
+        #
+        #   @return [String, nil]
+        optional :webhook_events_hmac_secret, String, api_name: :webhookEventsHmacSecret
+      end
+
+      # @!method initialize(global_api_key: nil, webhook_events_hmac_secret: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::AccountInfo} for more details.
+      #
+      #   Server-populated information about the account.
+      #
+      #   @param global_api_key [Cadenya::Models::APIKey] An API key for the account. Use workspace-association RPCs to grant the
+      #
+      #   @param webhook_events_hmac_secret [String] The generated secret that will sign all webhooks that are sent to your configure
+    end
+  end
+end

data/lib/cadenya/models/account_resource_metadata.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class AccountResourceMetadata < Cadenya::Internal::Type::BaseModel
+      # @!attribute name
+      #   Human-readable name for the resource (e.g., "Customer Support Agent", "Email
+      #   Tool") Required for resources that users interact with directly
+      #
+      #   @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]
+
+      response_only do
+        # @!attribute id
+        #   Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...")
+        #
+        #   @return [String]
+        required :id, String
+
+        # @!attribute account_id
+        #   Account this resource belongs to for multi-tenant isolation (prefixed ULID)
+        #
+        #   @return [String]
+        required :account_id, String, api_name: :accountId
+
+        # @!attribute profile_id
+        #
+        #   @return [String]
+        required :profile_id, String, api_name: :profileId
+      end
+
+      # @!method initialize(id:, account_id:, name:, profile_id:, external_id: nil, labels: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::AccountResourceMetadata} for more details.
+      #
+      #   AccountResourceMetadata is used to represent a resource that is associated to an
+      #   account but not to a workspace.
+      #
+      #   @param id [String] Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...")
+      #
+      #   @param account_id [String] Account this resource belongs to for multi-tenant isolation (prefixed ULID)
+      #
+      #   @param name [String] Human-readable name for the resource (e.g., "Customer Support Agent", "Email Too
+      #
+      #   @param profile_id [String]
+      #
+      #   @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

data/lib/cadenya/models/account_retrieve_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Account#retrieve
+    class AccountRetrieveParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cadenya/models/account_rotate_webhook_signing_key_params.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Account#rotate_webhook_signing_key
+    class AccountRotateWebhookSigningKeyParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      # @!method initialize(request_options: {})
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cadenya/models/account_spec.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class AccountSpec < Cadenya::Internal::Type::BaseModel
+      # @!attribute billing_email
+      #
+      #   @return [String, nil]
+      optional :billing_email, String, api_name: :billingEmail
+
+      # @!attribute description
+      #
+      #   @return [String, nil]
+      optional :description, String
+
+      # @!attribute domain
+      #
+      #   @return [String, nil]
+      optional :domain, String
+
+      # @!attribute workspaces
+      #
+      #   @return [Array<Cadenya::Models::Workspace>, nil]
+      optional :workspaces, -> { Cadenya::Internal::Type::ArrayOf[Cadenya::Workspace] }
+
+      # @!method initialize(billing_email: nil, description: nil, domain: nil, workspaces: nil)
+      #   Configuration for an account.
+      #
+      #   @param billing_email [String]
+      #   @param description [String]
+      #   @param domain [String]
+      #   @param workspaces [Array<Cadenya::Models::Workspace>]
+    end
+  end
+end

data/lib/cadenya/models/agent.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Agents#create
+    class Agent < Cadenya::Internal::Type::BaseModel
+      # @!attribute metadata
+      #   Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+      #
+      #   @return [Cadenya::Models::ResourceMetadata]
+      required :metadata, -> { Cadenya::ResourceMetadata }
+
+      # @!attribute spec
+      #   Agent specification (user-provided configuration)
+      #
+      #   @return [Cadenya::Models::AgentSpec]
+      required :spec, -> { Cadenya::AgentSpec }
+
+      response_only do
+        # @!attribute info
+        #   AgentInfo contains simple information about an agent for display or quick
+        #   reference
+        #
+        #   @return [Cadenya::Models::AgentInfo, nil]
+        optional :info, -> { Cadenya::AgentInfo }
+      end
+
+      # @!method initialize(metadata:, spec:, info: nil)
+      #   Some parameter documentations has been truncated, see {Cadenya::Models::Agent}
+      #   for more details.
+      #
+      #   Agent resource
+      #
+      #   @param metadata [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+      #
+      #   @param spec [Cadenya::Models::AgentSpec] Agent specification (user-provided configuration)
+      #
+      #   @param info [Cadenya::Models::AgentInfo] AgentInfo contains simple information about an agent for display or quick refere
+    end
+  end
+end

data/lib/cadenya/models/agent_create_params.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Agents#create
+    class AgentCreateParams < 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
+      #   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.
+      #
+      #   @return [Cadenya::Models::CreateResourceMetadata]
+      required :metadata, -> { Cadenya::CreateResourceMetadata }
+
+      # @!attribute spec
+      #   Agent specification (user-provided configuration)
+      #
+      #   @return [Cadenya::Models::AgentSpec]
+      required :spec, -> { Cadenya::AgentSpec }
+
+      # @!attribute default_variation
+      #   Create agent variation request
+      #
+      #   @return [Cadenya::Models::AgentCreateParams::DefaultVariation, nil]
+      optional :default_variation,
+               -> { Cadenya::AgentCreateParams::DefaultVariation },
+               api_name: :defaultVariation
+
+      # @!method initialize(workspace_id:, metadata:, spec:, default_variation: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::AgentCreateParams} for more details.
+      #
+      #   @param workspace_id [String]
+      #
+      #   @param metadata [Cadenya::Models::CreateResourceMetadata] CreateResourceMetadata contains the user-provided fields for creating
+      #
+      #   @param spec [Cadenya::Models::AgentSpec] Agent specification (user-provided configuration)
+      #
+      #   @param default_variation [Cadenya::Models::AgentCreateParams::DefaultVariation] Create agent variation request
+      #
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+
+      class DefaultVariation < Cadenya::Internal::Type::BaseModel
+        # @!attribute metadata
+        #   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.
+        #
+        #   @return [Cadenya::Models::CreateResourceMetadata]
+        required :metadata, -> { Cadenya::CreateResourceMetadata }
+
+        # @!attribute spec
+        #   AgentVariationSpec defines the operational configuration for a variation
+        #
+        #   @return [Cadenya::Models::Agents::AgentVariationSpec]
+        required :spec, -> { Cadenya::Agents::AgentVariationSpec }
+
+        # @!method initialize(metadata:, spec:)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::AgentCreateParams::DefaultVariation} for more details.
+        #
+        #   Create agent variation request
+        #
+        #   @param metadata [Cadenya::Models::CreateResourceMetadata] CreateResourceMetadata contains the user-provided fields for creating
+        #
+        #   @param spec [Cadenya::Models::Agents::AgentVariationSpec] AgentVariationSpec defines the operational configuration for a variation
+      end
+    end
+  end
+end

data/lib/cadenya/models/agent_delete_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Agents#delete
+    class AgentDeleteParams < 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 id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(workspace_id:, id:, request_options: {})
+      #   @param workspace_id [String]
+      #   @param id [String]
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cadenya/models/agent_entry.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class AgentEntry < Cadenya::Internal::Type::BaseModel
+      # @!attribute name
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute spec
+      #   Agent specification (user-provided configuration)
+      #
+      #   @return [Cadenya::Models::AgentSpec]
+      required :spec, -> { Cadenya::AgentSpec }
+
+      # @!attribute labels
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :labels, Cadenya::Internal::Type::HashOf[String]
+
+      # @!attribute schedules
+      #   Schedules under this agent, keyed by external_id.
+      #
+      #   @return [Hash{Symbol=>Cadenya::Models::AgentScheduleEntry}, nil]
+      optional :schedules, -> { Cadenya::Internal::Type::HashOf[Cadenya::AgentScheduleEntry] }
+
+      # @!attribute variations
+      #   Variations under this agent, keyed by external_id.
+      #
+      #   @return [Hash{Symbol=>Cadenya::Models::AgentVariationEntry}, nil]
+      optional :variations, -> { Cadenya::Internal::Type::HashOf[Cadenya::AgentVariationEntry] }
+
+      # @!method initialize(name:, spec:, labels: nil, schedules: nil, variations: nil)
+      #   @param name [String]
+      #
+      #   @param spec [Cadenya::Models::AgentSpec] Agent specification (user-provided configuration)
+      #
+      #   @param labels [Hash{Symbol=>String}]
+      #
+      #   @param schedules [Hash{Symbol=>Cadenya::Models::AgentScheduleEntry}] Schedules under this agent, keyed by external_id.
+      #
+      #   @param variations [Hash{Symbol=>Cadenya::Models::AgentVariationEntry}] Variations under this agent, keyed by external_id.
+    end
+  end
+end

data/lib/cadenya/models/agent_info.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class AgentInfo < Cadenya::Internal::Type::BaseModel
+      # @!attribute created_by
+      #   A profile identifies a user or non-human principal (such as an API key) at the
+      #   account level. Profiles are account-scoped and can be granted access to multiple
+      #   workspaces.
+      #
+      #   @return [Cadenya::Models::Profile, nil]
+      optional :created_by, -> { Cadenya::Profile }, api_name: :createdBy
+
+      response_only do
+        # @!attribute variation_count
+        #
+        #   @return [Integer, nil]
+        optional :variation_count, Integer, api_name: :variationCount
+      end
+
+      # @!method initialize(created_by: nil, variation_count: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::AgentInfo} for more details.
+      #
+      #   AgentInfo contains simple information about an agent for display or quick
+      #   reference
+      #
+      #   @param created_by [Cadenya::Models::Profile] A profile identifies a user or non-human principal (such as an API key)
+      #
+      #   @param variation_count [Integer]
+    end
+  end
+end

data/lib/cadenya/models/agent_list_params.rb

@@ -0,0 +1,122 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Agents#list
+    class AgentListParams < 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 bundle_key
+      #   Filter by bundle_key — return only resources owned by this bundle.
+      #
+      #   @return [String, nil]
+      optional :bundle_key, String
+
+      # @!attribute cursor
+      #   Pagination cursor from previous response
+      #
+      #   @return [String, nil]
+      optional :cursor, String
+
+      # @!attribute include_info
+      #   When true, the `info` field on each returned agent is populated. Requests with
+      #   this flag count more against your rate limit.
+      #
+      #   @return [Boolean, nil]
+      optional :include_info, Cadenya::Internal::Type::Boolean
+
+      # @!attribute limit
+      #   Maximum number of results to return
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!attribute prefix
+      #   Filter expression (query param: prefix)
+      #
+      #   @return [String, nil]
+      optional :prefix, String
+
+      # @!attribute query
+      #   Free-form search query
+      #
+      #   @return [String, nil]
+      optional :query, String
+
+      # @!attribute sort_order
+      #   Sort order for results (asc or desc by creation time)
+      #
+      #   @return [String, nil]
+      optional :sort_order, String
+
+      # @!attribute status
+      #   Filter by agent publication status
+      #
+      #   @return [Symbol, Cadenya::Models::AgentListParams::Status, nil]
+      optional :status, enum: -> { Cadenya::AgentListParams::Status }
+
+      # @!attribute variation_selection_mode
+      #   Filter by variation selection mode
+      #
+      #   @return [Symbol, Cadenya::Models::AgentListParams::VariationSelectionMode, nil]
+      optional :variation_selection_mode, enum: -> { Cadenya::AgentListParams::VariationSelectionMode }
+
+      # @!method initialize(workspace_id:, bundle_key: nil, cursor: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, status: nil, variation_selection_mode: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::AgentListParams} for more details.
+      #
+      #   @param workspace_id [String]
+      #
+      #   @param bundle_key [String] Filter by bundle_key — return only resources owned by this bundle.
+      #
+      #   @param cursor [String] Pagination cursor from previous response
+      #
+      #   @param include_info [Boolean] When true, the `info` field on each returned agent is populated. Requests
+      #
+      #   @param limit [Integer] Maximum number of results to return
+      #
+      #   @param prefix [String] Filter expression (query param: prefix)
+      #
+      #   @param query [String] Free-form search query
+      #
+      #   @param sort_order [String] Sort order for results (asc or desc by creation time)
+      #
+      #   @param status [Symbol, Cadenya::Models::AgentListParams::Status] Filter by agent publication status
+      #
+      #   @param variation_selection_mode [Symbol, Cadenya::Models::AgentListParams::VariationSelectionMode] Filter by variation selection mode
+      #
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+
+      # Filter by agent publication status
+      module Status
+        extend Cadenya::Internal::Type::Enum
+
+        AGENT_STATUS_UNSPECIFIED = :AGENT_STATUS_UNSPECIFIED
+        AGENT_STATUS_DRAFT = :AGENT_STATUS_DRAFT
+        AGENT_STATUS_PUBLISHED = :AGENT_STATUS_PUBLISHED
+        AGENT_STATUS_ARCHIVED = :AGENT_STATUS_ARCHIVED
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # Filter by variation selection mode
+      module VariationSelectionMode
+        extend Cadenya::Internal::Type::Enum
+
+        VARIATION_SELECTION_MODE_UNSPECIFIED = :VARIATION_SELECTION_MODE_UNSPECIFIED
+        VARIATION_SELECTION_MODE_RANDOM = :VARIATION_SELECTION_MODE_RANDOM
+        VARIATION_SELECTION_MODE_WEIGHTED = :VARIATION_SELECTION_MODE_WEIGHTED
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cadenya/models/agent_retrieve_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Agents#retrieve
+    class AgentRetrieveParams < 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 id
+      #
+      #   @return [String]
+      required :id, String
+
+      # @!method initialize(workspace_id:, id:, request_options: {})
+      #   @param workspace_id [String]
+      #   @param id [String]
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cadenya/models/agent_schedule_entry.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class AgentScheduleEntry < Cadenya::Internal::Type::BaseModel
+      # @!attribute name
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute spec
+      #   AgentScheduleSpec is the user-provided configuration for a schedule.
+      #
+      #   @return [Cadenya::Models::Agents::AgentScheduleSpec]
+      required :spec, -> { Cadenya::Agents::AgentScheduleSpec }
+
+      # @!attribute labels
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :labels, Cadenya::Internal::Type::HashOf[String]
+
+      # @!method initialize(name:, spec:, labels: nil)
+      #   @param name [String]
+      #
+      #   @param spec [Cadenya::Models::Agents::AgentScheduleSpec] AgentScheduleSpec is the user-provided configuration for a schedule.
+      #
+      #   @param labels [Hash{Symbol=>String}]
+    end
+  end
+end