cadenya 0.1.0

data/lib/cadenya/models/memory_layer.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::MemoryLayers#create
+    class MemoryLayer < 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
+      #
+      #   @return [Cadenya::Models::MemoryLayerSpec]
+      required :spec, -> { Cadenya::MemoryLayerSpec }
+
+      # @!attribute info
+      #
+      #   @return [Cadenya::Models::MemoryLayerInfo, nil]
+      optional :info, -> { Cadenya::MemoryLayerInfo }
+
+      # @!method initialize(metadata:, spec:, info: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::MemoryLayer} for more details.
+      #
+      #   MemoryLayer is a named container of memory entries that can be composed into an
+      #   objective's memory stack. Layers are workspace-scoped resources. The layer type
+      #   controls how its entries participate in the agent loop — see MemoryLayerType for
+      #   details.
+      #
+      #   See "Memory stack composition" above for how layers compose at lookup time.
+      #
+      #   @param metadata [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+      #
+      #   @param spec [Cadenya::Models::MemoryLayerSpec]
+      #
+      #   @param info [Cadenya::Models::MemoryLayerInfo]
+    end
+  end
+end

data/lib/cadenya/models/memory_layer_create_params.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::MemoryLayers#create
+    class MemoryLayerCreateParams < 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
+      #
+      #   @return [Cadenya::Models::MemoryLayerSpec]
+      required :spec, -> { Cadenya::MemoryLayerSpec }
+
+      # @!method initialize(workspace_id:, metadata:, spec:, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::MemoryLayerCreateParams} for more details.
+      #
+      #   @param workspace_id [String]
+      #
+      #   @param metadata [Cadenya::Models::CreateResourceMetadata] CreateResourceMetadata contains the user-provided fields for creating
+      #
+      #   @param spec [Cadenya::Models::MemoryLayerSpec]
+      #
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cadenya/models/memory_layer_delete_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::MemoryLayers#delete
+    class MemoryLayerDeleteParams < 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/memory_layer_entry.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class MemoryLayerEntry < Cadenya::Internal::Type::BaseModel
+      # @!attribute name
+      #
+      #   @return [String]
+      required :name, String
+
+      # @!attribute spec
+      #
+      #   @return [Cadenya::Models::MemoryLayerSpec]
+      required :spec, -> { Cadenya::MemoryLayerSpec }
+
+      # @!attribute entries
+      #   Memory entries in this layer, keyed by external_id.
+      #
+      #   @return [Hash{Symbol=>Cadenya::Models::MemoryEntryItem}, nil]
+      optional :entries, -> { Cadenya::Internal::Type::HashOf[Cadenya::MemoryEntryItem] }
+
+      # @!attribute labels
+      #
+      #   @return [Hash{Symbol=>String}, nil]
+      optional :labels, Cadenya::Internal::Type::HashOf[String]
+
+      # @!method initialize(name:, spec:, entries: nil, labels: nil)
+      #   @param name [String]
+      #
+      #   @param spec [Cadenya::Models::MemoryLayerSpec]
+      #
+      #   @param entries [Hash{Symbol=>Cadenya::Models::MemoryEntryItem}] Memory entries in this layer, keyed by external_id.
+      #
+      #   @param labels [Hash{Symbol=>String}]
+    end
+  end
+end

data/lib/cadenya/models/memory_layer_info.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class MemoryLayerInfo < 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 entry_count
+        #   Number of entries currently in this layer.
+        #
+        #   @return [Integer, nil]
+        optional :entry_count, Integer, api_name: :entryCount
+
+        # @!attribute last_used_at
+        #   Timestamp of the most recent objective that resolved against this layer. Useful
+        #   for surfacing unused layers in the dashboard.
+        #
+        #   @return [Time, nil]
+        optional :last_used_at, Time, api_name: :lastUsedAt
+      end
+
+      # @!method initialize(created_by: nil, entry_count: nil, last_used_at: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::MemoryLayerInfo} for more details.
+      #
+      #   @param created_by [Cadenya::Models::Profile] A profile identifies a user or non-human principal (such as an API key)
+      #
+      #   @param entry_count [Integer] Number of entries currently in this layer.
+      #
+      #   @param last_used_at [Time] Timestamp of the most recent objective that resolved against this layer.
+    end
+  end
+end

data/lib/cadenya/models/memory_layer_list_params.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::MemoryLayers#list
+    class MemoryLayerListParams < 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 set to true you may use more of your alloted API 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 type
+      #   Filter by layer type
+      #
+      #   @return [Symbol, Cadenya::Models::MemoryLayerListParams::Type, nil]
+      optional :type, enum: -> { Cadenya::MemoryLayerListParams::Type }
+
+      # @!method initialize(workspace_id:, bundle_key: nil, cursor: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, type: nil, request_options: {})
+      #   @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 set to true you may use more of your alloted API rate-limit
+      #
+      #   @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 type [Symbol, Cadenya::Models::MemoryLayerListParams::Type] Filter by layer type
+      #
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+
+      # Filter by layer type
+      module Type
+        extend Cadenya::Internal::Type::Enum
+
+        MEMORY_LAYER_TYPE_UNSPECIFIED = :MEMORY_LAYER_TYPE_UNSPECIFIED
+        MEMORY_LAYER_TYPE_EPISODIC = :MEMORY_LAYER_TYPE_EPISODIC
+        MEMORY_LAYER_TYPE_SKILLS = :MEMORY_LAYER_TYPE_SKILLS
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cadenya/models/memory_layer_retrieve_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::MemoryLayers#retrieve
+    class MemoryLayerRetrieveParams < 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/memory_layer_spec.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class MemoryLayerSpec < Cadenya::Internal::Type::BaseModel
+      # @!attribute type
+      #
+      #   @return [Symbol, Cadenya::Models::MemoryLayerSpec::Type]
+      required :type, enum: -> { Cadenya::MemoryLayerSpec::Type }
+
+      # @!attribute description
+      #   Human-readable description of the layer's purpose. Encouraged for user-created
+      #   layers; system-managed layers may have a generated description.
+      #
+      #   @return [String, nil]
+      optional :description, String
+
+      response_only do
+        # @!attribute expires_at
+        #   For layers with a finite lifetime (e.g., episodic), the time at which the layer
+        #   becomes eligible for cleanup. Set by the system; unset for persistent layers.
+        #
+        #   @return [Time, nil]
+        optional :expires_at, Time, api_name: :expiresAt
+
+        # @!attribute system_managed
+        #   Server-set. True for layers managed by the system (e.g., episodic layers created
+        #   automatically when an objective uses an episodic_key). System-managed layers
+        #   cannot be assigned to objective stacks via the API and cannot be mutated by
+        #   clients — their lifecycle is controlled entirely by the runtime.
+        #
+        #   @return [Boolean, nil]
+        optional :system_managed, Cadenya::Internal::Type::Boolean, api_name: :systemManaged
+      end
+
+      # @!method initialize(type:, description: nil, expires_at: nil, system_managed: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::MemoryLayerSpec} for more details.
+      #
+      #   @param type [Symbol, Cadenya::Models::MemoryLayerSpec::Type]
+      #
+      #   @param description [String] Human-readable description of the layer's purpose. Encouraged for
+      #
+      #   @param expires_at [Time] For layers with a finite lifetime (e.g., episodic), the time at which the
+      #
+      #   @param system_managed [Boolean] Server-set. True for layers managed by the system (e.g., episodic layers
+
+      # @see Cadenya::Models::MemoryLayerSpec#type
+      module Type
+        extend Cadenya::Internal::Type::Enum
+
+        MEMORY_LAYER_TYPE_UNSPECIFIED = :MEMORY_LAYER_TYPE_UNSPECIFIED
+        MEMORY_LAYER_TYPE_EPISODIC = :MEMORY_LAYER_TYPE_EPISODIC
+        MEMORY_LAYER_TYPE_SKILLS = :MEMORY_LAYER_TYPE_SKILLS
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cadenya/models/memory_layer_update_params.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::MemoryLayers#update
+    class MemoryLayerUpdateParams < 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
+
+      # @!attribute metadata
+      #   UpdateResourceMetadata contains the user-provided fields for updating 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::UpdateResourceMetadata, nil]
+      optional :metadata, -> { Cadenya::UpdateResourceMetadata }
+
+      # @!attribute spec
+      #
+      #   @return [Cadenya::Models::MemoryLayerSpec, nil]
+      optional :spec, -> { Cadenya::MemoryLayerSpec }
+
+      # @!attribute update_mask
+      #
+      #   @return [String, nil]
+      optional :update_mask, String, api_name: :updateMask
+
+      # @!method initialize(workspace_id:, id:, metadata: nil, spec: nil, update_mask: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::MemoryLayerUpdateParams} for more details.
+      #
+      #   @param workspace_id [String]
+      #
+      #   @param id [String]
+      #
+      #   @param metadata [Cadenya::Models::UpdateResourceMetadata] UpdateResourceMetadata contains the user-provided fields for updating
+      #
+      #   @param spec [Cadenya::Models::MemoryLayerSpec]
+      #
+      #   @param update_mask [String]
+      #
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cadenya/models/memory_layers/entry_create_params.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module MemoryLayers
+      # @see Cadenya::Resources::MemoryLayers::Entries#create
+      class EntryCreateParams < 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 memory_layer_id
+        #
+        #   @return [String]
+        required :memory_layer_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
+        #   MemoryEntryCreateSpec is the input shape for CreateMemoryEntry. It accepts
+        #   either inline content or a reference to a completed Upload; exactly one of the
+        #   two must be set.
+        #
+        #   @return [Cadenya::Models::MemoryLayers::MemoryEntryCreateSpec]
+        required :spec, -> { Cadenya::MemoryLayers::MemoryEntryCreateSpec }
+
+        # @!method initialize(workspace_id:, memory_layer_id:, metadata:, spec:, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::MemoryLayers::EntryCreateParams} for more details.
+        #
+        #   @param workspace_id [String]
+        #
+        #   @param memory_layer_id [String]
+        #
+        #   @param metadata [Cadenya::Models::CreateResourceMetadata] CreateResourceMetadata contains the user-provided fields for creating
+        #
+        #   @param spec [Cadenya::Models::MemoryLayers::MemoryEntryCreateSpec] MemoryEntryCreateSpec is the input shape for CreateMemoryEntry. It accepts
+        #
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/cadenya/models/memory_layers/entry_delete_params.rb

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

data/lib/cadenya/models/memory_layers/entry_list_params.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module MemoryLayers
+      # @see Cadenya::Resources::MemoryLayers::Entries#list
+      class EntryListParams < 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 memory_layer_id
+        #
+        #   @return [String]
+        required :memory_layer_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 set to true you may use more of your alloted API 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 by key prefix (e.g., "skills/postmortem/" to list all entries under that
+        #   hierarchy). Matches against the entry's key, not its name.
+        #
+        #   @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
+
+        # @!method initialize(workspace_id:, memory_layer_id:, bundle_key: nil, cursor: nil, include_info: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::MemoryLayers::EntryListParams} for more details.
+        #
+        #   @param workspace_id [String]
+        #
+        #   @param memory_layer_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 set to true you may use more of your alloted API rate-limit
+        #
+        #   @param limit [Integer] Maximum number of results to return
+        #
+        #   @param prefix [String] Filter by key prefix (e.g., "skills/postmortem/" to list all entries
+        #
+        #   @param query [String] Free-form search query
+        #
+        #   @param sort_order [String] Sort order for results (asc or desc by creation time)
+        #
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

data/lib/cadenya/models/memory_layers/entry_retrieve_params.rb

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