cadenya 0.11.0 → 0.13.0

data/rbi/cadenya/models/objectives/objective_tool_call_result.rbi

@@ -0,0 +1,54 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    ObjectiveToolCallResult = Objectives::ObjectiveToolCallResult
+
+    module Objectives
+      class ObjectiveToolCallResult < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::Objectives::ObjectiveToolCallResult,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        sig do
+          returns(
+            T::Array[Cadenya::Objectives::ObjectiveToolCallResultContentBlock]
+          )
+        end
+        attr_accessor :content
+
+        # ObjectiveToolCallResult is the content a tool returned after execution. Tools
+        # can return multiple content blocks, and blocks can be multi-modal (text, image,
+        # audio). Media blocks are stored by Cadenya and served as short-lived signed URLs
+        # rather than inline bytes.
+        sig do
+          params(
+            content:
+              T::Array[
+                Cadenya::Objectives::ObjectiveToolCallResultContentBlock::OrHash
+              ]
+          ).returns(T.attached_class)
+        end
+        def self.new(content:)
+        end
+
+        sig do
+          override.returns(
+            {
+              content:
+                T::Array[
+                  Cadenya::Objectives::ObjectiveToolCallResultContentBlock
+                ]
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models/objectives/objective_tool_call_result_audio_block.rbi

@@ -0,0 +1,69 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    ObjectiveToolCallResultAudioBlock =
+      Objectives::ObjectiveToolCallResultAudioBlock
+
+    module Objectives
+      class ObjectiveToolCallResultAudioBlock < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::Objectives::ObjectiveToolCallResultAudioBlock,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        # When the signed URL expires.
+        sig { returns(Time) }
+        attr_accessor :expires_at
+
+        # IANA media type of the stored audio, e.g. audio/wav.
+        sig { returns(String) }
+        attr_accessor :mime_type
+
+        # Size of the stored audio in bytes.
+        sig { returns(String) }
+        attr_accessor :size_bytes
+
+        # Short-lived signed URL to download the stored audio.
+        sig { returns(String) }
+        attr_accessor :url
+
+        sig do
+          params(
+            expires_at: Time,
+            mime_type: String,
+            size_bytes: String,
+            url: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # When the signed URL expires.
+          expires_at:,
+          # IANA media type of the stored audio, e.g. audio/wav.
+          mime_type:,
+          # Size of the stored audio in bytes.
+          size_bytes:,
+          # Short-lived signed URL to download the stored audio.
+          url:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              expires_at: Time,
+              mime_type: String,
+              size_bytes: String,
+              url: String
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models/objectives/objective_tool_call_result_content_block.rbi

@@ -0,0 +1,90 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    ObjectiveToolCallResultContentBlock =
+      Objectives::ObjectiveToolCallResultContentBlock
+
+    module Objectives
+      class ObjectiveToolCallResultContentBlock < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::Objectives::ObjectiveToolCallResultContentBlock,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        sig do
+          returns(
+            T.nilable(Cadenya::Objectives::ObjectiveToolCallResultAudioBlock)
+          )
+        end
+        attr_reader :audio
+
+        sig do
+          params(
+            audio:
+              Cadenya::Objectives::ObjectiveToolCallResultAudioBlock::OrHash
+          ).void
+        end
+        attr_writer :audio
+
+        sig do
+          returns(
+            T.nilable(Cadenya::Objectives::ObjectiveToolCallResultImageBlock)
+          )
+        end
+        attr_reader :image
+
+        sig do
+          params(
+            image:
+              Cadenya::Objectives::ObjectiveToolCallResultImageBlock::OrHash
+          ).void
+        end
+        attr_writer :image
+
+        sig do
+          returns(
+            T.nilable(Cadenya::Objectives::ObjectiveToolCallResultTextBlock)
+          )
+        end
+        attr_reader :text
+
+        sig do
+          params(
+            text: Cadenya::Objectives::ObjectiveToolCallResultTextBlock::OrHash
+          ).void
+        end
+        attr_writer :text
+
+        # ContentBlock is a single block of tool result content. Exactly one of the
+        # variants is set.
+        sig do
+          params(
+            audio:
+              Cadenya::Objectives::ObjectiveToolCallResultAudioBlock::OrHash,
+            image:
+              Cadenya::Objectives::ObjectiveToolCallResultImageBlock::OrHash,
+            text: Cadenya::Objectives::ObjectiveToolCallResultTextBlock::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(audio: nil, image: nil, text: nil)
+        end
+
+        sig do
+          override.returns(
+            {
+              audio: Cadenya::Objectives::ObjectiveToolCallResultAudioBlock,
+              image: Cadenya::Objectives::ObjectiveToolCallResultImageBlock,
+              text: Cadenya::Objectives::ObjectiveToolCallResultTextBlock
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models/objectives/objective_tool_call_result_image_block.rbi

@@ -0,0 +1,69 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    ObjectiveToolCallResultImageBlock =
+      Objectives::ObjectiveToolCallResultImageBlock
+
+    module Objectives
+      class ObjectiveToolCallResultImageBlock < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::Objectives::ObjectiveToolCallResultImageBlock,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        # When the signed URL expires.
+        sig { returns(Time) }
+        attr_accessor :expires_at
+
+        # IANA media type of the stored image, e.g. image/png.
+        sig { returns(String) }
+        attr_accessor :mime_type
+
+        # Size of the stored image in bytes.
+        sig { returns(String) }
+        attr_accessor :size_bytes
+
+        # Short-lived signed URL to download the stored image.
+        sig { returns(String) }
+        attr_accessor :url
+
+        sig do
+          params(
+            expires_at: Time,
+            mime_type: String,
+            size_bytes: String,
+            url: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # When the signed URL expires.
+          expires_at:,
+          # IANA media type of the stored image, e.g. image/png.
+          mime_type:,
+          # Size of the stored image in bytes.
+          size_bytes:,
+          # Short-lived signed URL to download the stored image.
+          url:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              expires_at: Time,
+              mime_type: String,
+              size_bytes: String,
+              url: String
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models/objectives/objective_tool_call_result_text_block.rbi

@@ -0,0 +1,31 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    ObjectiveToolCallResultTextBlock =
+      Objectives::ObjectiveToolCallResultTextBlock
+
+    module Objectives
+      class ObjectiveToolCallResultTextBlock < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::Objectives::ObjectiveToolCallResultTextBlock,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        sig { returns(String) }
+        attr_accessor :text
+
+        sig { params(text: String).returns(T.attached_class) }
+        def self.new(text:)
+        end
+
+        sig { override.returns({ text: String }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models/objectives/objective_tool_call_with_result.rbi

@@ -0,0 +1,219 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    ObjectiveToolCallWithResult = Objectives::ObjectiveToolCallWithResult
+
+    module Objectives
+      class ObjectiveToolCallWithResult < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::Objectives::ObjectiveToolCallWithResult,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        sig { returns(Cadenya::Objectives::ObjectiveToolCallData) }
+        attr_reader :data
+
+        sig do
+          params(data: Cadenya::Objectives::ObjectiveToolCallData::OrHash).void
+        end
+        attr_writer :data
+
+        sig { returns(Cadenya::Objectives::ObjectiveToolCallInfo) }
+        attr_reader :info
+
+        sig do
+          params(info: Cadenya::Objectives::ObjectiveToolCallInfo::OrHash).void
+        end
+        attr_writer :info
+
+        # Metadata for ephemeral operations and activities (e.g., objectives, executions,
+        # runs)
+        sig { returns(Cadenya::OperationMetadata) }
+        attr_reader :metadata
+
+        sig { params(metadata: Cadenya::OperationMetadata::OrHash).void }
+        attr_writer :metadata
+
+        # Current status of the tool call
+        sig do
+          returns(
+            Cadenya::Objectives::ObjectiveToolCallWithResult::Status::TaggedSymbol
+          )
+        end
+        attr_accessor :status
+
+        sig do
+          returns(
+            Cadenya::Objectives::ObjectiveToolCallWithResult::ExecutionStatus::TaggedSymbol
+          )
+        end
+        attr_accessor :execution_status
+
+        # ObjectiveToolCallResult is the content a tool returned after execution. Tools
+        # can return multiple content blocks, and blocks can be multi-modal (text, image,
+        # audio). Media blocks are stored by Cadenya and served as short-lived signed URLs
+        # rather than inline bytes.
+        sig { returns(T.nilable(Cadenya::Objectives::ObjectiveToolCallResult)) }
+        attr_reader :result
+
+        sig do
+          params(
+            result: Cadenya::Objectives::ObjectiveToolCallResult::OrHash
+          ).void
+        end
+        attr_writer :result
+
+        # ObjectiveToolCallWithResult is an ObjectiveToolCall plus the content the tool
+        # returned. Returned by GetObjectiveToolCall.
+        sig do
+          params(
+            data: Cadenya::Objectives::ObjectiveToolCallData::OrHash,
+            execution_status:
+              Cadenya::Objectives::ObjectiveToolCallWithResult::ExecutionStatus::OrSymbol,
+            info: Cadenya::Objectives::ObjectiveToolCallInfo::OrHash,
+            metadata: Cadenya::OperationMetadata::OrHash,
+            status:
+              Cadenya::Objectives::ObjectiveToolCallWithResult::Status::OrSymbol,
+            result: Cadenya::Objectives::ObjectiveToolCallResult::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          data:,
+          execution_status:,
+          info:,
+          # Metadata for ephemeral operations and activities (e.g., objectives, executions,
+          # runs)
+          metadata:,
+          # Current status of the tool call
+          status:,
+          # ObjectiveToolCallResult is the content a tool returned after execution. Tools
+          # can return multiple content blocks, and blocks can be multi-modal (text, image,
+          # audio). Media blocks are stored by Cadenya and served as short-lived signed URLs
+          # rather than inline bytes.
+          result: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              data: Cadenya::Objectives::ObjectiveToolCallData,
+              execution_status:
+                Cadenya::Objectives::ObjectiveToolCallWithResult::ExecutionStatus::TaggedSymbol,
+              info: Cadenya::Objectives::ObjectiveToolCallInfo,
+              metadata: Cadenya::OperationMetadata,
+              status:
+                Cadenya::Objectives::ObjectiveToolCallWithResult::Status::TaggedSymbol,
+              result: Cadenya::Objectives::ObjectiveToolCallResult
+            }
+          )
+        end
+        def to_hash
+        end
+
+        module ExecutionStatus
+          extend Cadenya::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Cadenya::Objectives::ObjectiveToolCallWithResult::ExecutionStatus
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          TOOL_CALL_EXECUTION_STATUS_UNSPECIFIED =
+            T.let(
+              :TOOL_CALL_EXECUTION_STATUS_UNSPECIFIED,
+              Cadenya::Objectives::ObjectiveToolCallWithResult::ExecutionStatus::TaggedSymbol
+            )
+          TOOL_CALL_EXECUTION_STATUS_PENDING =
+            T.let(
+              :TOOL_CALL_EXECUTION_STATUS_PENDING,
+              Cadenya::Objectives::ObjectiveToolCallWithResult::ExecutionStatus::TaggedSymbol
+            )
+          TOOL_CALL_EXECUTION_STATUS_RUNNING =
+            T.let(
+              :TOOL_CALL_EXECUTION_STATUS_RUNNING,
+              Cadenya::Objectives::ObjectiveToolCallWithResult::ExecutionStatus::TaggedSymbol
+            )
+          TOOL_CALL_EXECUTION_STATUS_COMPLETED =
+            T.let(
+              :TOOL_CALL_EXECUTION_STATUS_COMPLETED,
+              Cadenya::Objectives::ObjectiveToolCallWithResult::ExecutionStatus::TaggedSymbol
+            )
+          TOOL_CALL_EXECUTION_STATUS_ERRORED =
+            T.let(
+              :TOOL_CALL_EXECUTION_STATUS_ERRORED,
+              Cadenya::Objectives::ObjectiveToolCallWithResult::ExecutionStatus::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Cadenya::Objectives::ObjectiveToolCallWithResult::ExecutionStatus::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        # Current status of the tool call
+        module Status
+          extend Cadenya::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                Cadenya::Objectives::ObjectiveToolCallWithResult::Status
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          TOOL_CALL_STATUS_UNSPECIFIED =
+            T.let(
+              :TOOL_CALL_STATUS_UNSPECIFIED,
+              Cadenya::Objectives::ObjectiveToolCallWithResult::Status::TaggedSymbol
+            )
+          TOOL_CALL_STATUS_AUTO_APPROVED =
+            T.let(
+              :TOOL_CALL_STATUS_AUTO_APPROVED,
+              Cadenya::Objectives::ObjectiveToolCallWithResult::Status::TaggedSymbol
+            )
+          TOOL_CALL_STATUS_WAITING_FOR_APPROVAL =
+            T.let(
+              :TOOL_CALL_STATUS_WAITING_FOR_APPROVAL,
+              Cadenya::Objectives::ObjectiveToolCallWithResult::Status::TaggedSymbol
+            )
+          TOOL_CALL_STATUS_APPROVED =
+            T.let(
+              :TOOL_CALL_STATUS_APPROVED,
+              Cadenya::Objectives::ObjectiveToolCallWithResult::Status::TaggedSymbol
+            )
+          TOOL_CALL_STATUS_DENIED =
+            T.let(
+              :TOOL_CALL_STATUS_DENIED,
+              Cadenya::Objectives::ObjectiveToolCallWithResult::Status::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                Cadenya::Objectives::ObjectiveToolCallWithResult::Status::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models/objectives/tool_call_retrieve_params.rbi

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

data/rbi/cadenya/models/tool_result.rbi

@@ -6,25 +6,47 @@ module Cadenya
       OrHash =
         T.type_alias { T.any(Cadenya::ToolResult, Cadenya::Internal::AnyHash) }
 
-      sig { returns(T.nilable(String)) }
-      attr_reader :content
+      # ObjectiveToolCallResult is the content a tool returned after execution. Tools
+      # can return multiple content blocks, and blocks can be multi-modal (text, image,
+      # audio). Media blocks are stored by Cadenya and served as short-lived signed URLs
+      # rather than inline bytes.
+      sig { returns(Cadenya::Objectives::ObjectiveToolCallResult) }
+      attr_reader :result
 
-      sig { params(content: String).void }
-      attr_writer :content
-
-      sig { returns(T.nilable(String)) }
-      attr_reader :tool_call_id
+      sig do
+        params(
+          result: Cadenya::Objectives::ObjectiveToolCallResult::OrHash
+        ).void
+      end
+      attr_writer :result
 
-      sig { params(tool_call_id: String).void }
-      attr_writer :tool_call_id
+      sig { returns(String) }
+      attr_accessor :tool_call_id
 
       sig do
-        params(content: String, tool_call_id: String).returns(T.attached_class)
+        params(
+          result: Cadenya::Objectives::ObjectiveToolCallResult::OrHash,
+          tool_call_id: String
+        ).returns(T.attached_class)
       end
-      def self.new(content: nil, tool_call_id: nil)
+      def self.new(
+        # ObjectiveToolCallResult is the content a tool returned after execution. Tools
+        # can return multiple content blocks, and blocks can be multi-modal (text, image,
+        # audio). Media blocks are stored by Cadenya and served as short-lived signed URLs
+        # rather than inline bytes.
+        result:,
+        tool_call_id:
+      )
       end
 
-      sig { override.returns({ content: String, tool_call_id: String }) }
+      sig do
+        override.returns(
+          {
+            result: Cadenya::Objectives::ObjectiveToolCallResult,
+            tool_call_id: String
+          }
+        )
+      end
       def to_hash
       end
     end

data/rbi/cadenya/resources/memory_layers.rbi

@@ -84,8 +84,10 @@ module Cadenya
       sig do
         params(
           workspace_id: String,
+          agent_id: String,
           bundle_key: String,
           cursor: String,
+          episodic_key_prefix: String,
           include_info: T::Boolean,
           limit: Integer,
           prefix: String,
@@ -97,10 +99,16 @@ module Cadenya
       end
       def list(
         workspace_id,
+        # Filter to episodic layers belonging to this agent.
+        agent_id: nil,
         # Filter by bundle_key — return only resources owned by this bundle.
         bundle_key: nil,
         # Pagination cursor from previous response
         cursor: nil,
+        # Filter to episodic layers whose episodic key starts with this prefix (e.g.
+        # "customer/" matches "customer/42" and "customer/43"). Useful for namespaced
+        # keys, similar to a redis key scan.
+        episodic_key_prefix: nil,
         # When set to true you may use more of your alloted API rate-limit
         include_info: nil,
         # Maximum number of results to return