cadenya 0.11.0 → 0.12.0

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/objectives/tool_calls.rbi

@@ -4,6 +4,26 @@ module Cadenya
   module Resources
     class Objectives
       class ToolCalls
+        # Retrieves a single tool call, including the content the tool returned. Media
+        # content (images, audio) is served as short-lived signed URLs.
+        sig do
+          params(
+            tool_call_id: String,
+            workspace_id: String,
+            objective_id: String,
+            request_options: Cadenya::RequestOptions::OrHash
+          ).returns(Cadenya::Objectives::ObjectiveToolCallWithResult)
+        end
+        def retrieve(
+          # The ID of the tool call to retrieve
+          tool_call_id,
+          workspace_id:,
+          # The ID of the objective. Supports "external_id:" prefix for external IDs.
+          objective_id:,
+          request_options: {}
+        )
+        end
+
         # Lists all tool calls for an objective
         sig do
           params(

data/sig/cadenya/models/objectives/objective_tool_call_data.rbs

@@ -8,7 +8,6 @@ module Cadenya
           callable: Cadenya::CallableTool,
           arguments: ::Hash[Symbol, top],
           memo: String,
-          result: String,
           status_changed_by: Cadenya::Profile
         }
 
@@ -23,10 +22,6 @@ module Cadenya
 
         def memo=: (String) -> String
 
-        attr_reader result: String?
-
-        def result=: (String) -> String
-
         attr_reader status_changed_by: Cadenya::Profile?
 
         def status_changed_by=: (Cadenya::Profile) -> Cadenya::Profile
@@ -35,7 +30,6 @@ module Cadenya
           callable: Cadenya::CallableTool,
           ?arguments: ::Hash[Symbol, top],
           ?memo: String,
-          ?result: String,
           ?status_changed_by: Cadenya::Profile
         ) -> void
 
@@ -43,7 +37,6 @@ module Cadenya
           callable: Cadenya::CallableTool,
           arguments: ::Hash[Symbol, top],
           memo: String,
-          result: String,
           status_changed_by: Cadenya::Profile
         }
       end

data/sig/cadenya/models/objectives/objective_tool_call_result.rbs

@@ -0,0 +1,24 @@
+module Cadenya
+  module Models
+    class ObjectiveToolCallResult = Objectives::ObjectiveToolCallResult
+
+    module Objectives
+      type objective_tool_call_result =
+        {
+          content: ::Array[Cadenya::Objectives::ObjectiveToolCallResultContentBlock]
+        }
+
+      class ObjectiveToolCallResult < Cadenya::Internal::Type::BaseModel
+        attr_accessor content: ::Array[Cadenya::Objectives::ObjectiveToolCallResultContentBlock]
+
+        def initialize: (
+          content: ::Array[Cadenya::Objectives::ObjectiveToolCallResultContentBlock]
+        ) -> void
+
+        def to_hash: -> {
+          content: ::Array[Cadenya::Objectives::ObjectiveToolCallResultContentBlock]
+        }
+      end
+    end
+  end
+end

data/sig/cadenya/models/objectives/objective_tool_call_result_audio_block.rbs

@@ -0,0 +1,34 @@
+module Cadenya
+  module Models
+    class ObjectiveToolCallResultAudioBlock = Objectives::ObjectiveToolCallResultAudioBlock
+
+    module Objectives
+      type objective_tool_call_result_audio_block =
+        { expires_at: Time, mime_type: String, size_bytes: String, url: String }
+
+      class ObjectiveToolCallResultAudioBlock < Cadenya::Internal::Type::BaseModel
+        attr_accessor expires_at: Time
+
+        attr_accessor mime_type: String
+
+        attr_accessor size_bytes: String
+
+        attr_accessor url: String
+
+        def initialize: (
+          expires_at: Time,
+          mime_type: String,
+          size_bytes: String,
+          url: String
+        ) -> void
+
+        def to_hash: -> {
+          expires_at: Time,
+          mime_type: String,
+          size_bytes: String,
+          url: String
+        }
+      end
+    end
+  end
+end

data/sig/cadenya/models/objectives/objective_tool_call_result_content_block.rbs

@@ -0,0 +1,46 @@
+module Cadenya
+  module Models
+    class ObjectiveToolCallResultContentBlock = Objectives::ObjectiveToolCallResultContentBlock
+
+    module Objectives
+      type objective_tool_call_result_content_block =
+        {
+          audio: Cadenya::Objectives::ObjectiveToolCallResultAudioBlock,
+          image: Cadenya::Objectives::ObjectiveToolCallResultImageBlock,
+          text: Cadenya::Objectives::ObjectiveToolCallResultTextBlock
+        }
+
+      class ObjectiveToolCallResultContentBlock < Cadenya::Internal::Type::BaseModel
+        attr_reader audio: Cadenya::Objectives::ObjectiveToolCallResultAudioBlock?
+
+        def audio=: (
+          Cadenya::Objectives::ObjectiveToolCallResultAudioBlock
+        ) -> Cadenya::Objectives::ObjectiveToolCallResultAudioBlock
+
+        attr_reader image: Cadenya::Objectives::ObjectiveToolCallResultImageBlock?
+
+        def image=: (
+          Cadenya::Objectives::ObjectiveToolCallResultImageBlock
+        ) -> Cadenya::Objectives::ObjectiveToolCallResultImageBlock
+
+        attr_reader text: Cadenya::Objectives::ObjectiveToolCallResultTextBlock?
+
+        def text=: (
+          Cadenya::Objectives::ObjectiveToolCallResultTextBlock
+        ) -> Cadenya::Objectives::ObjectiveToolCallResultTextBlock
+
+        def initialize: (
+          ?audio: Cadenya::Objectives::ObjectiveToolCallResultAudioBlock,
+          ?image: Cadenya::Objectives::ObjectiveToolCallResultImageBlock,
+          ?text: Cadenya::Objectives::ObjectiveToolCallResultTextBlock
+        ) -> void
+
+        def to_hash: -> {
+          audio: Cadenya::Objectives::ObjectiveToolCallResultAudioBlock,
+          image: Cadenya::Objectives::ObjectiveToolCallResultImageBlock,
+          text: Cadenya::Objectives::ObjectiveToolCallResultTextBlock
+        }
+      end
+    end
+  end
+end