cadenya 0.28.0 → 0.30.0

data/lib/cadenya/resources/objectives/tool_calls.rb

@@ -43,9 +43,12 @@ module Cadenya
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::Objectives::ToolCallListParams} for more details.
+        #
         # Lists all tool calls for an objective
         #
-        # @overload list(objective_id, workspace_id:, cursor: nil, include_info: nil, limit: nil, status: nil, request_options: {})
+        # @overload list(objective_id, workspace_id:, cursor: nil, execution_status: nil, include_info: nil, limit: nil, status: nil, request_options: {})
         #
         # @param objective_id [String] Path param: The objective ID to return tool calls for
         #
@@ -53,6 +56,8 @@ module Cadenya
         #
         # @param cursor [String] Query param: Pagination cursor from previous response
         #
+        # @param execution_status [Symbol, Cadenya::Models::Objectives::ToolCallListParams::ExecutionStatus] Query param: Filter by tool call execution status. Useful for reverse-harness
+        #
         # @param include_info [Boolean] Query param: When set to true you may use more of your alloted API rate-limit
         #
         # @param limit [Integer] Query param: Maximum number of results to return
@@ -74,7 +79,7 @@ module Cadenya
           @client.request(
             method: :get,
             path: ["v1/workspaces/%1$s/objectives/%2$s/tool_calls", workspace_id, objective_id],
-            query: query.transform_keys(include_info: "includeInfo"),
+            query: query.transform_keys(execution_status: "executionStatus", include_info: "includeInfo"),
             page: Cadenya::Internal::CursorPagination,
             model: Cadenya::Objectives::ObjectiveToolCall,
             options: options
@@ -166,6 +171,52 @@ module Cadenya
           )
         end
 
+        # Some parameter documentations has been truncated, see
+        # {Cadenya::Models::Objectives::ToolCallSetContentParams} for more details.
+        #
+        # For bare tool calls (tool sets with no execution adapter), sets the content an
+        # external API consumer supplies for the call — used for human-in-the-loop tools
+        # and reverse harnesses that execute tools locally and report results back.
+        #
+        # @overload set_content(tool_call_id, workspace_id:, objective_id:, content:, request_options: {})
+        #
+        # @param tool_call_id [String] Path param: The ID of the tool call to set content for
+        #
+        # @param workspace_id [String] Path param
+        #
+        # @param objective_id [String] Path param: The ID of the objective. Supports "external_id:" prefix for external
+        #
+        # @param content [Array<Cadenya::Models::Objectives::SetToolCallContentRequestContentBlock>] Body param: The content to set on the tool call. Mirrors
+        #
+        # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [Cadenya::Models::Objectives::ObjectiveToolCall]
+        #
+        # @see Cadenya::Models::Objectives::ToolCallSetContentParams
+        def set_content(tool_call_id, params)
+          parsed, options = Cadenya::Objectives::ToolCallSetContentParams.dump_request(params)
+          workspace_id =
+            parsed.delete(:workspace_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          objective_id =
+            parsed.delete(:objective_id) do
+              raise ArgumentError.new("missing required path argument #{_1}")
+            end
+          @client.request(
+            method: :post,
+            path: [
+              "v1/workspaces/%1$s/objectives/%2$s/tool_calls/%3$s:setContent",
+              workspace_id,
+              objective_id,
+              tool_call_id
+            ],
+            body: parsed,
+            model: Cadenya::Objectives::ObjectiveToolCall,
+            options: options
+          )
+        end
+
         # @api private
         #
         # @param client [Cadenya::Client]

data/lib/cadenya/resources/objectives.rb

@@ -322,6 +322,36 @@ module Cadenya
         )
       end
 
+      # Returns the context-usage breakdown measured for the objective's most recent
+      # iteration: character lengths per context component (system prompt, memory
+      # appendices, tool definitions, messages by role) alongside the iteration's input
+      # token counts.
+      #
+      # @overload retrieve_diagnostics(objective_id, workspace_id:, request_options: {})
+      #
+      # @param objective_id [String] The ID of the objective. Supports "external_id:" prefix for external IDs.
+      #
+      # @param workspace_id [String]
+      #
+      # @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [Cadenya::Models::ObjectiveRetrieveDiagnosticsResponse]
+      #
+      # @see Cadenya::Models::ObjectiveRetrieveDiagnosticsParams
+      def retrieve_diagnostics(objective_id, params)
+        parsed, options = Cadenya::ObjectiveRetrieveDiagnosticsParams.dump_request(params)
+        workspace_id =
+          parsed.delete(:workspace_id) do
+            raise ArgumentError.new("missing required path argument #{_1}")
+          end
+        @client.request(
+          method: :get,
+          path: ["v1/workspaces/%1$s/objectives/%2$s/diagnostics", workspace_id, objective_id],
+          model: Cadenya::Models::ObjectiveRetrieveDiagnosticsResponse,
+          options: options
+        )
+      end
+
       # Streams events for an objective in real-time using server-sent events (SSE)
       #
       # @overload stream_events_streaming(objective_id, workspace_id:, request_options: {})

data/lib/cadenya/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Cadenya
-  VERSION = "0.28.0"
+  VERSION = "0.30.0"
 end

data/lib/cadenya.rb

@@ -140,6 +140,7 @@ require_relative "cadenya/models/assistant_tool_call"
 require_relative "cadenya/models/attribute_filter"
 require_relative "cadenya/models/bare_metadata"
 require_relative "cadenya/models/callable_tool"
+require_relative "cadenya/models/context_lengths"
 require_relative "cadenya/models/context_window_compacted"
 require_relative "cadenya/models/create_operation_metadata"
 require_relative "cadenya/models/create_resource_metadata"
@@ -181,6 +182,7 @@ require_relative "cadenya/models/objective_context_window"
 require_relative "cadenya/models/objective_context_window_data"
 require_relative "cadenya/models/objective_continue_params"
 require_relative "cadenya/models/objective_create_params"
+require_relative "cadenya/models/objective_diagnostics"
 require_relative "cadenya/models/objective_error"
 require_relative "cadenya/models/objective_event"
 require_relative "cadenya/models/objective_event_data"
@@ -190,6 +192,8 @@ require_relative "cadenya/models/objective_info"
 require_relative "cadenya/models/objective_list_context_windows_params"
 require_relative "cadenya/models/objective_list_events_params"
 require_relative "cadenya/models/objective_list_params"
+require_relative "cadenya/models/objective_retrieve_diagnostics_params"
+require_relative "cadenya/models/objective_retrieve_diagnostics_response"
 require_relative "cadenya/models/objective_retrieve_params"
 require_relative "cadenya/models/objectives/feedback_create_params"
 require_relative "cadenya/models/objectives/feedback_list_params"
@@ -209,12 +213,17 @@ require_relative "cadenya/models/objectives/objective_tool_call_result_image_blo
 require_relative "cadenya/models/objectives/objective_tool_call_result_text_block"
 require_relative "cadenya/models/objectives/objective_tool_call_with_result"
 require_relative "cadenya/models/objectives/resolved_secret"
+require_relative "cadenya/models/objectives/set_tool_call_content_request_audio_block"
+require_relative "cadenya/models/objectives/set_tool_call_content_request_content_block"
+require_relative "cadenya/models/objectives/set_tool_call_content_request_image_block"
+require_relative "cadenya/models/objectives/set_tool_call_content_request_text_block"
 require_relative "cadenya/models/objectives/task_list_params"
 require_relative "cadenya/models/objectives/task_retrieve_params"
 require_relative "cadenya/models/objectives/tool_call_approve_params"
 require_relative "cadenya/models/objectives/tool_call_deny_params"
 require_relative "cadenya/models/objectives/tool_call_list_params"
 require_relative "cadenya/models/objectives/tool_call_retrieve_params"
+require_relative "cadenya/models/objectives/tool_call_set_content_params"
 require_relative "cadenya/models/objectives/tool_list_params"
 require_relative "cadenya/models/objective_secret"
 require_relative "cadenya/models/objective_stream_events_params"
@@ -243,6 +252,7 @@ require_relative "cadenya/models/tool_filter"
 require_relative "cadenya/models/tool_result"
 require_relative "cadenya/models/tool_set"
 require_relative "cadenya/models/tool_set_adapter"
+require_relative "cadenya/models/tool_set_adapter_bare"
 require_relative "cadenya/models/tool_set_adapter_http"
 require_relative "cadenya/models/tool_set_adapter_mcp"
 require_relative "cadenya/models/tool_set_adapter_openapi"
@@ -257,6 +267,7 @@ require_relative "cadenya/models/tool_set_info"
 require_relative "cadenya/models/tool_set_list_events_params"
 require_relative "cadenya/models/tool_set_list_params"
 require_relative "cadenya/models/tool_set_retrieve_params"
+require_relative "cadenya/models/tool_sets/config_bare"
 require_relative "cadenya/models/tool_sets/config_http"
 require_relative "cadenya/models/tool_sets/config_mcp"
 require_relative "cadenya/models/tool_sets/config_openapi"

data/rbi/cadenya/models/context_lengths.rbi

@@ -0,0 +1,103 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class ContextLengths < Cadenya::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::ContextLengths, Cadenya::Internal::AnyHash)
+        end
+
+      # Chat history messages with the assistant role.
+      sig { returns(Integer) }
+      attr_accessor :assistant_messages
+
+      # The discoverable/available-tools appendix attached to the system prompt.
+      sig { returns(Integer) }
+      attr_accessor :available_tools
+
+      # The episodic memory appendix attached to the system prompt.
+      sig { returns(Integer) }
+      attr_accessor :episodic_memory
+
+      # The skills memory appendix attached to the system prompt.
+      sig { returns(Integer) }
+      attr_accessor :skills_memory
+
+      # The objective's base system prompt (rendered variation template).
+      sig { returns(Integer) }
+      attr_accessor :system_prompt
+
+      # Serialized tool definitions sent with the completion request (names,
+      # descriptions, and JSON-schema parameters).
+      sig { returns(Integer) }
+      attr_accessor :tool_definitions
+
+      # Tool results present in the chat history.
+      sig { returns(Integer) }
+      attr_accessor :tool_results
+
+      # Chat history messages with the user role.
+      sig { returns(Integer) }
+      attr_accessor :user_messages
+
+      # ContextLengths is the measured character length of each distinct component of an
+      # iteration's assembled context window. Values are raw character lengths of the
+      # component as assembled into the request — token estimates are derived by the
+      # client against input_tokens (component share = component length / sum of all
+      # lengths).
+      #
+      # New components are added as new fields — wire-compatible; absent components read
+      # as 0.
+      sig do
+        params(
+          assistant_messages: Integer,
+          available_tools: Integer,
+          episodic_memory: Integer,
+          skills_memory: Integer,
+          system_prompt: Integer,
+          tool_definitions: Integer,
+          tool_results: Integer,
+          user_messages: Integer
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Chat history messages with the assistant role.
+        assistant_messages:,
+        # The discoverable/available-tools appendix attached to the system prompt.
+        available_tools:,
+        # The episodic memory appendix attached to the system prompt.
+        episodic_memory:,
+        # The skills memory appendix attached to the system prompt.
+        skills_memory:,
+        # The objective's base system prompt (rendered variation template).
+        system_prompt:,
+        # Serialized tool definitions sent with the completion request (names,
+        # descriptions, and JSON-schema parameters).
+        tool_definitions:,
+        # Tool results present in the chat history.
+        tool_results:,
+        # Chat history messages with the user role.
+        user_messages:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            assistant_messages: Integer,
+            available_tools: Integer,
+            episodic_memory: Integer,
+            skills_memory: Integer,
+            system_prompt: Integer,
+            tool_definitions: Integer,
+            tool_results: Integer,
+            user_messages: Integer
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cadenya/models/objective_diagnostics.rbi

@@ -0,0 +1,76 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class ObjectiveDiagnostics < Cadenya::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(Cadenya::ObjectiveDiagnostics, Cadenya::Internal::AnyHash)
+        end
+
+      # The portion of input_tokens served from the provider's prompt cache. Lets
+      # clients distinguish "big but cached" from "big and paid fresh every iteration".
+      sig { returns(Integer) }
+      attr_accessor :cached_input_tokens
+
+      # ContextLengths is the measured character length of each distinct component of an
+      # iteration's assembled context window. Values are raw character lengths of the
+      # component as assembled into the request — token estimates are derived by the
+      # client against input_tokens (component share = component length / sum of all
+      # lengths).
+      #
+      # New components are added as new fields — wire-compatible; absent components read
+      # as 0.
+      sig { returns(Cadenya::ContextLengths) }
+      attr_reader :context_lengths
+
+      sig { params(context_lengths: Cadenya::ContextLengths::OrHash).void }
+      attr_writer :context_lengths
+
+      # Input tokens reported by the LLM provider for the iteration's completion.
+      sig { returns(Integer) }
+      attr_accessor :input_tokens
+
+      # ObjectiveDiagnostics is the context-usage breakdown measured for a single
+      # iteration at request-assembly time. It reports how much of the context window
+      # each component occupies so tool parameters, memory cascades, and prompts can be
+      # tuned against real token usage.
+      sig do
+        params(
+          cached_input_tokens: Integer,
+          context_lengths: Cadenya::ContextLengths::OrHash,
+          input_tokens: Integer
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The portion of input_tokens served from the provider's prompt cache. Lets
+        # clients distinguish "big but cached" from "big and paid fresh every iteration".
+        cached_input_tokens:,
+        # ContextLengths is the measured character length of each distinct component of an
+        # iteration's assembled context window. Values are raw character lengths of the
+        # component as assembled into the request — token estimates are derived by the
+        # client against input_tokens (component share = component length / sum of all
+        # lengths).
+        #
+        # New components are added as new fields — wire-compatible; absent components read
+        # as 0.
+        context_lengths:,
+        # Input tokens reported by the LLM provider for the iteration's completion.
+        input_tokens:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            cached_input_tokens: Integer,
+            context_lengths: Cadenya::ContextLengths,
+            input_tokens: Integer
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cadenya/models/objective_retrieve_diagnostics_params.rbi

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

data/rbi/cadenya/models/objective_retrieve_diagnostics_response.rbi

@@ -0,0 +1,43 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class ObjectiveRetrieveDiagnosticsResponse < Cadenya::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Cadenya::Models::ObjectiveRetrieveDiagnosticsResponse,
+            Cadenya::Internal::AnyHash
+          )
+        end
+
+      # ObjectiveDiagnostics is the context-usage breakdown measured for a single
+      # iteration at request-assembly time. It reports how much of the context window
+      # each component occupies so tool parameters, memory cascades, and prompts can be
+      # tuned against real token usage.
+      sig { returns(Cadenya::ObjectiveDiagnostics) }
+      attr_reader :diagnostics
+
+      sig { params(diagnostics: Cadenya::ObjectiveDiagnostics::OrHash).void }
+      attr_writer :diagnostics
+
+      sig do
+        params(diagnostics: Cadenya::ObjectiveDiagnostics::OrHash).returns(
+          T.attached_class
+        )
+      end
+      def self.new(
+        # ObjectiveDiagnostics is the context-usage breakdown measured for a single
+        # iteration at request-assembly time. It reports how much of the context window
+        # each component occupies so tool parameters, memory cascades, and prompts can be
+        # tuned against real token usage.
+        diagnostics:
+      )
+      end
+
+      sig { override.returns({ diagnostics: Cadenya::ObjectiveDiagnostics }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cadenya/models/objectives/objective_tool_call.rbi

@@ -129,6 +129,11 @@ module Cadenya
               :TOOL_CALL_EXECUTION_STATUS_ERRORED,
               Cadenya::Objectives::ObjectiveToolCall::ExecutionStatus::TaggedSymbol
             )
+          TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT =
+            T.let(
+              :TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT,
+              Cadenya::Objectives::ObjectiveToolCall::ExecutionStatus::TaggedSymbol
+            )
 
           sig do
             override.returns(

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

@@ -171,6 +171,11 @@ module Cadenya
               :TOOL_CALL_EXECUTION_STATUS_ERRORED,
               Cadenya::Objectives::ObjectiveToolCallWithResult::ExecutionStatus::TaggedSymbol
             )
+          TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT =
+            T.let(
+              :TOOL_CALL_EXECUTION_STATUS_WAITING_FOR_CONTENT,
+              Cadenya::Objectives::ObjectiveToolCallWithResult::ExecutionStatus::TaggedSymbol
+            )
 
           sig do
             override.returns(

data/rbi/cadenya/models/objectives/set_tool_call_content_request_audio_block.rbi

@@ -0,0 +1,40 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    module Objectives
+      class SetToolCallContentRequestAudioBlock < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::Objectives::SetToolCallContentRequestAudioBlock,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        # Base64-encoded audio bytes.
+        sig { returns(String) }
+        attr_accessor :data
+
+        # IANA media type of the audio, e.g. audio/wav.
+        sig { returns(String) }
+        attr_accessor :mime_type
+
+        sig do
+          params(data: String, mime_type: String).returns(T.attached_class)
+        end
+        def self.new(
+          # Base64-encoded audio bytes.
+          data:,
+          # IANA media type of the audio, e.g. audio/wav.
+          mime_type:
+        )
+        end
+
+        sig { override.returns({ data: String, mime_type: String }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models/objectives/set_tool_call_content_request_content_block.rbi

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

data/rbi/cadenya/models/objectives/set_tool_call_content_request_image_block.rbi

@@ -0,0 +1,40 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    module Objectives
+      class SetToolCallContentRequestImageBlock < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::Objectives::SetToolCallContentRequestImageBlock,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        # Base64-encoded image bytes.
+        sig { returns(String) }
+        attr_accessor :data
+
+        # IANA media type of the image, e.g. image/png.
+        sig { returns(String) }
+        attr_accessor :mime_type
+
+        sig do
+          params(data: String, mime_type: String).returns(T.attached_class)
+        end
+        def self.new(
+          # Base64-encoded image bytes.
+          data:,
+          # IANA media type of the image, e.g. image/png.
+          mime_type:
+        )
+        end
+
+        sig { override.returns({ data: String, mime_type: String }) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models/objectives/set_tool_call_content_request_text_block.rbi

@@ -0,0 +1,28 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    module Objectives
+      class SetToolCallContentRequestTextBlock < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::Objectives::SetToolCallContentRequestTextBlock,
+              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