cadenya 0.1.0

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

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module MemoryLayers
+      # @see Cadenya::Resources::MemoryLayers::Entries#update
+      class EntryUpdateParams < 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
+
+        # @!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
+        #   MemoryEntryUpdateSpec is the input shape for UpdateMemoryEntry. Fields present
+        #   in the request's update_mask are applied; unset fields are left alone. The
+        #   source oneof is optional for updates — omit it to leave the body untouched, or
+        #   set exactly one branch to replace it.
+        #
+        #   @return [Cadenya::Models::MemoryLayers::MemoryEntryUpdateSpec, nil]
+        optional :spec, -> { Cadenya::MemoryLayers::MemoryEntryUpdateSpec }
+
+        # @!attribute update_mask
+        #
+        #   @return [String, nil]
+        optional :update_mask, String, api_name: :updateMask
+
+        # @!method initialize(workspace_id:, memory_layer_id:, id:, metadata: nil, spec: nil, update_mask: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::MemoryLayers::EntryUpdateParams} for more details.
+        #
+        #   @param workspace_id [String]
+        #
+        #   @param memory_layer_id [String]
+        #
+        #   @param id [String]
+        #
+        #   @param metadata [Cadenya::Models::UpdateResourceMetadata] UpdateResourceMetadata contains the user-provided fields for updating
+        #
+        #   @param spec [Cadenya::Models::MemoryLayers::MemoryEntryUpdateSpec] MemoryEntryUpdateSpec is the input shape for UpdateMemoryEntry. Fields
+        #
+        #   @param update_mask [String]
+        #
+        #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module MemoryLayers
+      # @see Cadenya::Resources::MemoryLayers::Entries#list
+      class MemoryEntry < 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
+        #   MemoryEntrySpec is the metadata portion of an entry — the fields that identify
+        #   and describe it, without the body. It appears on both the summary (MemoryEntry)
+        #   and detail (MemoryEntryDetail) views.
+        #
+        #   @return [Cadenya::Models::MemoryLayers::MemoryEntrySpec]
+        required :spec, -> { Cadenya::MemoryLayers::MemoryEntrySpec }
+
+        # @!attribute info
+        #
+        #   @return [Cadenya::Models::MemoryLayers::MemoryEntryInfo, nil]
+        optional :info, -> { Cadenya::MemoryLayers::MemoryEntryInfo }
+
+        # @!method initialize(metadata:, spec:, info: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::MemoryLayers::MemoryEntry} for more details.
+        #
+        #   MemoryEntry is a single keyed value within a MemoryLayer. Entries are addressed
+        #   by their key, which follows the S3 object key safe-character convention (see
+        #   MemoryEntrySpec.key for the full rule). Keys are unique within a single layer;
+        #   the same key may appear in multiple layers, in which case the LIFO stack-walk
+        #   determines which one wins for a given objective.
+        #
+        #   MemoryEntry is the summary shape, returned by ListMemoryEntries. It does not
+        #   carry the entry body — callers that need the body must fetch the entry
+        #   individually via GetMemoryEntry, which returns a MemoryEntryDetail.
+        #
+        #   @param metadata [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+        #
+        #   @param spec [Cadenya::Models::MemoryLayers::MemoryEntrySpec] MemoryEntrySpec is the metadata portion of an entry — the fields that
+        #
+        #   @param info [Cadenya::Models::MemoryLayers::MemoryEntryInfo]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module MemoryLayers
+      class MemoryEntryCreateSpec < Cadenya::Internal::Type::BaseModel
+        # @!attribute key
+        #   See MemoryEntrySpec.key for the full rule set. Same constraints apply here.
+        #
+        #   @return [String]
+        required :key, String
+
+        # @!attribute content
+        #   Inline content, written directly into the entry.
+        #
+        #   @return [String, nil]
+        optional :content, String
+
+        # @!attribute description
+        #
+        #   @return [String, nil]
+        optional :description, String
+
+        # @!attribute upload_id
+        #   ID of a COMPLETE Upload. The server reads the object from storage, copies its
+        #   bytes into the entry, and marks the upload consumed.
+        #
+        #   @return [String, nil]
+        optional :upload_id, String, api_name: :uploadId
+
+        # @!method initialize(key:, content: nil, description: nil, upload_id: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::MemoryLayers::MemoryEntryCreateSpec} for more details.
+        #
+        #   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.
+        #
+        #   @param key [String] See MemoryEntrySpec.key for the full rule set. Same constraints apply
+        #
+        #   @param content [String] Inline content, written directly into the entry.
+        #
+        #   @param description [String]
+        #
+        #   @param upload_id [String] ID of a COMPLETE Upload. The server reads the object from storage,
+      end
+    end
+  end
+end

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

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module MemoryLayers
+      # @see Cadenya::Resources::MemoryLayers::Entries#create
+      class MemoryEntryDetail < Cadenya::Internal::Type::BaseModel
+        # @!attribute content
+        #   The resolved body of the entry. For entries created or updated via an upload_id,
+        #   this is the ingested content, not the original upload handle. May be empty; an
+        #   entry with only a key and description is valid (e.g., a stub skill being
+        #   drafted, or an entry where the frontmatter alone is the payload).
+        #
+        #   @return [String]
+        required :content, String
+
+        # @!attribute metadata
+        #   Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+        #
+        #   @return [Cadenya::Models::ResourceMetadata]
+        required :metadata, -> { Cadenya::ResourceMetadata }
+
+        # @!attribute spec
+        #   MemoryEntrySpec is the metadata portion of an entry — the fields that identify
+        #   and describe it, without the body. It appears on both the summary (MemoryEntry)
+        #   and detail (MemoryEntryDetail) views.
+        #
+        #   @return [Cadenya::Models::MemoryLayers::MemoryEntrySpec]
+        required :spec, -> { Cadenya::MemoryLayers::MemoryEntrySpec }
+
+        # @!attribute info
+        #
+        #   @return [Cadenya::Models::MemoryLayers::MemoryEntryInfo, nil]
+        optional :info, -> { Cadenya::MemoryLayers::MemoryEntryInfo }
+
+        # @!method initialize(content:, metadata:, spec:, info: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::MemoryLayers::MemoryEntryDetail} for more details.
+        #
+        #   MemoryEntryDetail is the full representation of an entry, including the resolved
+        #   content body. Returned by GetMemoryEntry, CreateMemoryEntry, and
+        #   UpdateMemoryEntry.
+        #
+        #   @param content [String] The resolved body of the entry. For entries created or updated via an
+        #
+        #   @param metadata [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+        #
+        #   @param spec [Cadenya::Models::MemoryLayers::MemoryEntrySpec] MemoryEntrySpec is the metadata portion of an entry — the fields that
+        #
+        #   @param info [Cadenya::Models::MemoryLayers::MemoryEntryInfo]
+      end
+    end
+  end
+end

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

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module MemoryLayers
+      class MemoryEntryInfo < 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 memory_layer
+          #   Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+          #
+          #   @return [Cadenya::Models::ResourceMetadata, nil]
+          optional :memory_layer, -> { Cadenya::ResourceMetadata }, api_name: :memoryLayer
+        end
+
+        # @!method initialize(created_by: nil, memory_layer: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::MemoryLayers::MemoryEntryInfo} for more details.
+        #
+        #   @param created_by [Cadenya::Models::Profile] A profile identifies a user or non-human principal (such as an API key)
+        #
+        #   @param memory_layer [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+      end
+    end
+  end
+end

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

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module MemoryLayers
+      class MemoryEntrySpec < Cadenya::Internal::Type::BaseModel
+        # @!attribute key
+        #   The lookup key for this entry within its layer. Must conform to the S3 object
+        #   key safe-characters spec: ASCII alphanumerics and the special characters !, -,
+        #   \_, ., \*, ', (, ), and /. Forward slashes may be used to suggest hierarchy
+        #   (e.g., "skills/postmortem/write"), but lookups are flat — the key is a single
+        #   opaque string, not a path.
+        #
+        #   Additional rules enforced by the service:
+        #
+        #   - May not begin or end with /
+        #   - May not contain consecutive slashes (//)
+        #   - May not begin with reserved prefixes (cadenya/, system/)
+        #   - Case-sensitive
+        #   - Unique within the parent layer
+        #
+        #   For skills entries, this key is also the id the model passes to
+        #   memory_load_skill when it decides to load the entry's content.
+        #
+        #   @return [String]
+        required :key, String
+
+        # @!attribute description
+        #   One-line "when to use this" hint shown in the frontmatter manifest for skills
+        #   entries. The model uses this to decide whether to load the body, so it should be
+        #   written for the model as the audience. Ignored for layer types that do not
+        #   advertise frontmatter.
+        #
+        #   @return [String, nil]
+        optional :description, String
+
+        # @!method initialize(key:, description: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::MemoryLayers::MemoryEntrySpec} for more details.
+        #
+        #   MemoryEntrySpec is the metadata portion of an entry — the fields that identify
+        #   and describe it, without the body. It appears on both the summary (MemoryEntry)
+        #   and detail (MemoryEntryDetail) views.
+        #
+        #   @param key [String] The lookup key for this entry within its layer. Must conform to the S3
+        #
+        #   @param description [String] One-line "when to use this" hint shown in the frontmatter manifest for
+      end
+    end
+  end
+end

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

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module MemoryLayers
+      class MemoryEntryUpdateSpec < Cadenya::Internal::Type::BaseModel
+        # @!attribute content
+        #
+        #   @return [String, nil]
+        optional :content, String
+
+        # @!attribute description
+        #
+        #   @return [String, nil]
+        optional :description, String
+
+        # @!attribute key
+        #
+        #   @return [String, nil]
+        optional :key, String
+
+        # @!attribute upload_id
+        #
+        #   @return [String, nil]
+        optional :upload_id, String, api_name: :uploadId
+
+        # @!method initialize(content: nil, description: nil, key: nil, upload_id: nil)
+        #   MemoryEntryUpdateSpec is the input shape for UpdateMemoryEntry. Fields present
+        #   in the request's update_mask are applied; unset fields are left alone. The
+        #   source oneof is optional for updates — omit it to leave the body untouched, or
+        #   set exactly one branch to replace it.
+        #
+        #   @param content [String]
+        #   @param description [String]
+        #   @param key [String]
+        #   @param upload_id [String]
+      end
+    end
+  end
+end

data/lib/cadenya/models/memory_read.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class MemoryRead < Cadenya::Internal::Type::BaseModel
+      # @!attribute memory_entry_id
+      #   The specific entry that was read.
+      #
+      #   @return [String, nil]
+      optional :memory_entry_id, String, api_name: :memoryEntryId
+
+      # @!attribute memory_layer_id
+      #   The layer the entry resolved to. The top-most layer that contained the key —
+      #   other layers beneath it that also contained the key are shadowed and not
+      #   referenced here.
+      #
+      #   @return [String, nil]
+      optional :memory_layer_id, String, api_name: :memoryLayerId
+
+      # @!attribute message
+      #   Human-readable description of the read, set by the runtime. For example: "Loaded
+      #   skill", "Resolved context key". Not machine-parsed; intended for UI display
+      #   alongside the other events in an objective's timeline.
+      #
+      #   @return [String, nil]
+      optional :message, String
+
+      # @!method initialize(memory_entry_id: nil, memory_layer_id: nil, message: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::MemoryRead} for more details.
+      #
+      #   MemoryRead is emitted each time the agent resolves a key against the memory
+      #   stack and loads an entry. Lookups that miss (key not found in any layer) do not
+      #   emit this event.
+      #
+      #   @param memory_entry_id [String] The specific entry that was read.
+      #
+      #   @param memory_layer_id [String] The layer the entry resolved to. The top-most layer that contained
+      #
+      #   @param message [String] Human-readable description of the read, set by the runtime. For
+    end
+  end
+end

data/lib/cadenya/models/memory_reference.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class MemoryReference < Cadenya::Internal::Type::BaseModel
+      # @!attribute memory_entry_id
+      #   When set, pushes only this entry from memory_layer_id onto the stack — behaves
+      #   as a single-entry layer (only this key resolves at this position). The entry
+      #   must belong to memory_layer_id; mismatches are rejected with InvalidArgument.
+      #
+      #   @return [String, nil]
+      optional :memory_entry_id, String, api_name: :memoryEntryId
+
+      # @!attribute memory_layer_id
+      #
+      #   @return [String, nil]
+      optional :memory_layer_id, String, api_name: :memoryLayerId
+
+      # @!method initialize(memory_entry_id: nil, memory_layer_id: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::MemoryReference} for more details.
+      #
+      #   MemoryReference identifies a memory layer or a specific entry within one, for
+      #   composition into a memory stack. Used on objectives (where entry pinning is
+      #   permitted).
+      #
+      #   memory*layer_id accepts both the canonical form (memlyr*…) and the external-id
+      #   form (external_id:my-custom-id). The same applies to memory_entry_id when set.
+      #
+      #   @param memory_entry_id [String] When set, pushes only this entry from memory_layer_id onto the stack —
+      #
+      #   @param memory_layer_id [String]
+    end
+  end
+end

data/lib/cadenya/models/model.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Models#retrieve
+    class Model < 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
+      #   Model specification
+      #
+      #   @return [Cadenya::Models::ModelSpec]
+      required :spec, -> { Cadenya::ModelSpec }
+
+      # @!method initialize(metadata:, spec:)
+      #   Some parameter documentations has been truncated, see {Cadenya::Models::Model}
+      #   for more details.
+      #
+      #   @param metadata [Cadenya::Models::ResourceMetadata] Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
+      #
+      #   @param spec [Cadenya::Models::ModelSpec] Model specification
+    end
+  end
+end

data/lib/cadenya/models/model_list_params.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Models#list
+    class ModelListParams < 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 limit
+      #   Maximum number of results to return
+      #
+      #   @return [Integer, nil]
+      optional :limit, Integer
+
+      # @!attribute prefix
+      #   Filter by name 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 model status
+      #
+      #   @return [Symbol, Cadenya::Models::ModelListParams::Status, nil]
+      optional :status, enum: -> { Cadenya::ModelListParams::Status }
+
+      # @!method initialize(workspace_id:, bundle_key: nil, cursor: nil, limit: nil, prefix: nil, query: nil, sort_order: nil, status: 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 limit [Integer] Maximum number of results to return
+      #
+      #   @param prefix [String] Filter by name 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::ModelListParams::Status] Filter by model status
+      #
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+
+      # Filter by model status
+      module Status
+        extend Cadenya::Internal::Type::Enum
+
+        MODEL_STATUS_UNSPECIFIED = :MODEL_STATUS_UNSPECIFIED
+        MODEL_STATUS_ENABLED = :MODEL_STATUS_ENABLED
+        MODEL_STATUS_DISABLED = :MODEL_STATUS_DISABLED
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end

data/lib/cadenya/models/model_retrieve_params.rb

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

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Models#set_status
+    class ModelSetStatusParams < 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 status
+      #   The new status for the model
+      #
+      #   @return [Symbol, Cadenya::Models::ModelSetStatusParams::Status, nil]
+      optional :status, enum: -> { Cadenya::ModelSetStatusParams::Status }
+
+      # @!method initialize(workspace_id:, id:, status: nil, request_options: {})
+      #   @param workspace_id [String]
+      #
+      #   @param id [String]
+      #
+      #   @param status [Symbol, Cadenya::Models::ModelSetStatusParams::Status] The new status for the model
+      #
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+
+      # The new status for the model
+      module Status
+        extend Cadenya::Internal::Type::Enum
+
+        MODEL_STATUS_UNSPECIFIED = :MODEL_STATUS_UNSPECIFIED
+        MODEL_STATUS_ENABLED = :MODEL_STATUS_ENABLED
+        MODEL_STATUS_DISABLED = :MODEL_STATUS_DISABLED
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end