cadenya 0.28.0 → 0.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bf555cd84ae5279087a5b60695fec05f03451abbb21cc910c5e85cb1ed52c56e
-  data.tar.gz: b7662e178b9f76f9e044bdff89f57bb78a75fd58ef92c9f7ac4c75ed45aef3a6
+  metadata.gz: d00d248c33699a4a01039ddd4d6123e9648ff8bc367c20a8e65e4885851cb60e
+  data.tar.gz: 81189360913ae6f04eb92b83ffdad219dade81eeb6eccb400318d39e89bc8e47
 SHA512:
-  metadata.gz: eb71eb5d8238a2f9d63ceadf1ebd77230fbed22f146eada9da0abeb2b578128646b6bbe3feaaf4cc179d5e894cd9c94ab96f413cbf63cbf72ebe94e1b6d42c66
-  data.tar.gz: 4bb21c37969a3c091aa854523f4e45e323ad513f299b384978befb9d975ad442b0ad24c0c064ae1ff41ec9b1cb781c92ce1bd744531504707ec912e79a4f800c
+  metadata.gz: c276b5b5f6499525a452490dc7df6de4ffd9109a666aa712dbcbc201420a9de9ef0cfbffae86174836e055bc31272a72303de43aa6c0ceb4c1de9123f4531ab3
+  data.tar.gz: c2f2abd24fa38008337bda2931e8c27e9e39ca1412a9a523ae3d678766e62f58a855de3373a533e4c9733b327ae40286764161dd2e7ef823cf65fa99cc7b820f

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.29.0 (2026-07-05)
+
+Full Changelog: [v0.28.0...v0.29.0](https://github.com/cadenya/cadenya-ruby/compare/v0.28.0...v0.29.0)
+
+### Features
+
+* **api:** api update ([e14c0d7](https://github.com/cadenya/cadenya-ruby/commit/e14c0d7509075b97bf655215eb5f266e8903b3a6))
+
 ## 0.28.0 (2026-07-04)
 
 Full Changelog: [v0.27.0...v0.28.0](https://github.com/cadenya/cadenya-ruby/compare/v0.27.0...v0.28.0)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "cadenya", "~> 0.28.0"
+gem "cadenya", "~> 0.29.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/cadenya/models/context_lengths.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class ContextLengths < Cadenya::Internal::Type::BaseModel
+      response_only do
+        # @!attribute assistant_messages
+        #   Chat history messages with the assistant role.
+        #
+        #   @return [Integer]
+        required :assistant_messages, Integer, api_name: :assistantMessages
+
+        # @!attribute available_tools
+        #   The discoverable/available-tools appendix attached to the system prompt.
+        #
+        #   @return [Integer]
+        required :available_tools, Integer, api_name: :availableTools
+
+        # @!attribute episodic_memory
+        #   The episodic memory appendix attached to the system prompt.
+        #
+        #   @return [Integer]
+        required :episodic_memory, Integer, api_name: :episodicMemory
+
+        # @!attribute skills_memory
+        #   The skills memory appendix attached to the system prompt.
+        #
+        #   @return [Integer]
+        required :skills_memory, Integer, api_name: :skillsMemory
+
+        # @!attribute system_prompt
+        #   The objective's base system prompt (rendered variation template).
+        #
+        #   @return [Integer]
+        required :system_prompt, Integer, api_name: :systemPrompt
+
+        # @!attribute tool_definitions
+        #   Serialized tool definitions sent with the completion request (names,
+        #   descriptions, and JSON-schema parameters).
+        #
+        #   @return [Integer]
+        required :tool_definitions, Integer, api_name: :toolDefinitions
+
+        # @!attribute tool_results
+        #   Tool results present in the chat history.
+        #
+        #   @return [Integer]
+        required :tool_results, Integer, api_name: :toolResults
+
+        # @!attribute user_messages
+        #   Chat history messages with the user role.
+        #
+        #   @return [Integer]
+        required :user_messages, Integer, api_name: :userMessages
+      end
+
+      # @!method initialize(assistant_messages:, available_tools:, episodic_memory:, skills_memory:, system_prompt:, tool_definitions:, tool_results:, user_messages:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ContextLengths} for more details.
+      #
+      #   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.
+      #
+      #   @param assistant_messages [Integer] Chat history messages with the assistant role.
+      #
+      #   @param available_tools [Integer] The discoverable/available-tools appendix attached to the system prompt.
+      #
+      #   @param episodic_memory [Integer] The episodic memory appendix attached to the system prompt.
+      #
+      #   @param skills_memory [Integer] The skills memory appendix attached to the system prompt.
+      #
+      #   @param system_prompt [Integer] The objective's base system prompt (rendered variation template).
+      #
+      #   @param tool_definitions [Integer] Serialized tool definitions sent with the completion request
+      #
+      #   @param tool_results [Integer] Tool results present in the chat history.
+      #
+      #   @param user_messages [Integer] Chat history messages with the user role.
+    end
+  end
+end

data/lib/cadenya/models/objective_diagnostics.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    class ObjectiveDiagnostics < Cadenya::Internal::Type::BaseModel
+      response_only do
+        # @!attribute cached_input_tokens
+        #   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".
+        #
+        #   @return [Integer]
+        required :cached_input_tokens, Integer, api_name: :cachedInputTokens
+
+        # @!attribute context_lengths
+        #   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.
+        #
+        #   @return [Cadenya::Models::ContextLengths]
+        required :context_lengths, -> { Cadenya::ContextLengths }, api_name: :contextLengths
+
+        # @!attribute input_tokens
+        #   Input tokens reported by the LLM provider for the iteration's completion.
+        #
+        #   @return [Integer]
+        required :input_tokens, Integer, api_name: :inputTokens
+      end
+
+      # @!method initialize(cached_input_tokens:, context_lengths:, input_tokens:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ObjectiveDiagnostics} for more details.
+      #
+      #   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.
+      #
+      #   @param cached_input_tokens [Integer] The portion of input_tokens served from the provider's prompt cache.
+      #
+      #   @param context_lengths [Cadenya::Models::ContextLengths] ContextLengths is the measured character length of each distinct component
+      #
+      #   @param input_tokens [Integer] Input tokens reported by the LLM provider for the iteration's completion.
+    end
+  end
+end

data/lib/cadenya/models/objective_retrieve_diagnostics_params.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Objectives#retrieve_diagnostics
+    class ObjectiveRetrieveDiagnosticsParams < 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 objective_id
+      #
+      #   @return [String]
+      required :objective_id, String
+
+      # @!method initialize(workspace_id:, objective_id:, request_options: {})
+      #   @param workspace_id [String]
+      #   @param objective_id [String]
+      #   @param request_options [Cadenya::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/cadenya/models/objective_retrieve_diagnostics_response.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    # @see Cadenya::Resources::Objectives#retrieve_diagnostics
+    class ObjectiveRetrieveDiagnosticsResponse < Cadenya::Internal::Type::BaseModel
+      response_only do
+        # @!attribute diagnostics
+        #   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.
+        #
+        #   @return [Cadenya::Models::ObjectiveDiagnostics]
+        required :diagnostics, -> { Cadenya::ObjectiveDiagnostics }
+      end
+
+      # @!method initialize(diagnostics:)
+      #   Some parameter documentations has been truncated, see
+      #   {Cadenya::Models::ObjectiveRetrieveDiagnosticsResponse} for more details.
+      #
+      #   @param diagnostics [Cadenya::Models::ObjectiveDiagnostics] ObjectiveDiagnostics is the context-usage breakdown measured for a single
+    end
+  end
+end

data/lib/cadenya/models.rb

@@ -125,6 +125,8 @@ module Cadenya
 
   CallableTool = Cadenya::Models::CallableTool
 
+  ContextLengths = Cadenya::Models::ContextLengths
+
   ContextWindowCompacted = Cadenya::Models::ContextWindowCompacted
 
   CreateOperationMetadata = Cadenya::Models::CreateOperationMetadata
@@ -183,6 +185,8 @@ module Cadenya
 
   ObjectiveCreateParams = Cadenya::Models::ObjectiveCreateParams
 
+  ObjectiveDiagnostics = Cadenya::Models::ObjectiveDiagnostics
+
   ObjectiveError = Cadenya::Models::ObjectiveError
 
   ObjectiveEvent = Cadenya::Models::ObjectiveEvent
@@ -201,6 +205,8 @@ module Cadenya
 
   ObjectiveListParams = Cadenya::Models::ObjectiveListParams
 
+  ObjectiveRetrieveDiagnosticsParams = Cadenya::Models::ObjectiveRetrieveDiagnosticsParams
+
   ObjectiveRetrieveParams = Cadenya::Models::ObjectiveRetrieveParams
 
   Objectives = Cadenya::Models::Objectives

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.29.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"

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.rbi

@@ -89,6 +89,8 @@ module Cadenya
 
   CallableTool = Cadenya::Models::CallableTool
 
+  ContextLengths = Cadenya::Models::ContextLengths
+
   ContextWindowCompacted = Cadenya::Models::ContextWindowCompacted
 
   CreateOperationMetadata = Cadenya::Models::CreateOperationMetadata
@@ -147,6 +149,8 @@ module Cadenya
 
   ObjectiveCreateParams = Cadenya::Models::ObjectiveCreateParams
 
+  ObjectiveDiagnostics = Cadenya::Models::ObjectiveDiagnostics
+
   ObjectiveError = Cadenya::Models::ObjectiveError
 
   ObjectiveEvent = Cadenya::Models::ObjectiveEvent
@@ -166,6 +170,9 @@ module Cadenya
 
   ObjectiveListParams = Cadenya::Models::ObjectiveListParams
 
+  ObjectiveRetrieveDiagnosticsParams =
+    Cadenya::Models::ObjectiveRetrieveDiagnosticsParams
+
   ObjectiveRetrieveParams = Cadenya::Models::ObjectiveRetrieveParams
 
   Objectives = Cadenya::Models::Objectives

data/rbi/cadenya/resources/objectives.rbi

@@ -267,6 +267,25 @@ 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.
+      sig do
+        params(
+          objective_id: String,
+          workspace_id: String,
+          request_options: Cadenya::RequestOptions::OrHash
+        ).returns(Cadenya::Models::ObjectiveRetrieveDiagnosticsResponse)
+      end
+      def retrieve_diagnostics(
+        # The ID of the objective. Supports "external_id:" prefix for external IDs.
+        objective_id,
+        workspace_id:,
+        request_options: {}
+      )
+      end
+
       # Streams events for an objective in real-time using server-sent events (SSE)
       sig do
         params(

data/sig/cadenya/models/context_lengths.rbs

@@ -0,0 +1,55 @@
+module Cadenya
+  module Models
+    type context_lengths =
+      {
+        assistant_messages: Integer,
+        available_tools: Integer,
+        episodic_memory: Integer,
+        skills_memory: Integer,
+        system_prompt: Integer,
+        tool_definitions: Integer,
+        tool_results: Integer,
+        user_messages: Integer
+      }
+
+    class ContextLengths < Cadenya::Internal::Type::BaseModel
+      attr_accessor assistant_messages: Integer
+
+      attr_accessor available_tools: Integer
+
+      attr_accessor episodic_memory: Integer
+
+      attr_accessor skills_memory: Integer
+
+      attr_accessor system_prompt: Integer
+
+      attr_accessor tool_definitions: Integer
+
+      attr_accessor tool_results: Integer
+
+      attr_accessor user_messages: Integer
+
+      def initialize: (
+        assistant_messages: Integer,
+        available_tools: Integer,
+        episodic_memory: Integer,
+        skills_memory: Integer,
+        system_prompt: Integer,
+        tool_definitions: Integer,
+        tool_results: Integer,
+        user_messages: Integer
+      ) -> void
+
+      def to_hash: -> {
+        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
+  end
+end

data/sig/cadenya/models/objective_diagnostics.rbs

@@ -0,0 +1,30 @@
+module Cadenya
+  module Models
+    type objective_diagnostics =
+      {
+        cached_input_tokens: Integer,
+        context_lengths: Cadenya::ContextLengths,
+        input_tokens: Integer
+      }
+
+    class ObjectiveDiagnostics < Cadenya::Internal::Type::BaseModel
+      attr_accessor cached_input_tokens: Integer
+
+      attr_accessor context_lengths: Cadenya::ContextLengths
+
+      attr_accessor input_tokens: Integer
+
+      def initialize: (
+        cached_input_tokens: Integer,
+        context_lengths: Cadenya::ContextLengths,
+        input_tokens: Integer
+      ) -> void
+
+      def to_hash: -> {
+        cached_input_tokens: Integer,
+        context_lengths: Cadenya::ContextLengths,
+        input_tokens: Integer
+      }
+    end
+  end
+end

data/sig/cadenya/models/objective_retrieve_diagnostics_params.rbs

@@ -0,0 +1,28 @@
+module Cadenya
+  module Models
+    type objective_retrieve_diagnostics_params =
+      { workspace_id: String, objective_id: String }
+      & Cadenya::Internal::Type::request_parameters
+
+    class ObjectiveRetrieveDiagnosticsParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      attr_accessor workspace_id: String
+
+      attr_accessor objective_id: String
+
+      def initialize: (
+        workspace_id: String,
+        objective_id: String,
+        ?request_options: Cadenya::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        workspace_id: String,
+        objective_id: String,
+        request_options: Cadenya::RequestOptions
+      }
+    end
+  end
+end

data/sig/cadenya/models/objective_retrieve_diagnostics_response.rbs

@@ -0,0 +1,14 @@
+module Cadenya
+  module Models
+    type objective_retrieve_diagnostics_response =
+      { diagnostics: Cadenya::ObjectiveDiagnostics }
+
+    class ObjectiveRetrieveDiagnosticsResponse < Cadenya::Internal::Type::BaseModel
+      attr_accessor diagnostics: Cadenya::ObjectiveDiagnostics
+
+      def initialize: (diagnostics: Cadenya::ObjectiveDiagnostics) -> void
+
+      def to_hash: -> { diagnostics: Cadenya::ObjectiveDiagnostics }
+    end
+  end
+end

data/sig/cadenya/models.rbs

@@ -85,6 +85,8 @@ module Cadenya
 
   class CallableTool = Cadenya::Models::CallableTool
 
+  class ContextLengths = Cadenya::Models::ContextLengths
+
   class ContextWindowCompacted = Cadenya::Models::ContextWindowCompacted
 
   class CreateOperationMetadata = Cadenya::Models::CreateOperationMetadata
@@ -143,6 +145,8 @@ module Cadenya
 
   class ObjectiveCreateParams = Cadenya::Models::ObjectiveCreateParams
 
+  class ObjectiveDiagnostics = Cadenya::Models::ObjectiveDiagnostics
+
   class ObjectiveError = Cadenya::Models::ObjectiveError
 
   class ObjectiveEvent = Cadenya::Models::ObjectiveEvent
@@ -161,6 +165,8 @@ module Cadenya
 
   class ObjectiveListParams = Cadenya::Models::ObjectiveListParams
 
+  class ObjectiveRetrieveDiagnosticsParams = Cadenya::Models::ObjectiveRetrieveDiagnosticsParams
+
   class ObjectiveRetrieveParams = Cadenya::Models::ObjectiveRetrieveParams
 
   module Objectives = Cadenya::Models::Objectives

data/sig/cadenya/resources/objectives.rbs

@@ -86,6 +86,12 @@ module Cadenya
         ?request_options: Cadenya::request_opts
       ) -> Cadenya::Internal::CursorPagination[Cadenya::ObjectiveEvent]
 
+      def retrieve_diagnostics: (
+        String objective_id,
+        workspace_id: String,
+        ?request_options: Cadenya::request_opts
+      ) -> Cadenya::Models::ObjectiveRetrieveDiagnosticsResponse
+
       def stream_events_streaming: (
         String objective_id,
         workspace_id: String,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cadenya
 version: !ruby/object:Gem::Version
-  version: 0.28.0
+  version: 0.29.0
 platform: ruby
 authors:
 - Cadenya
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-04 00:00:00.000000000 Z
+date: 2026-07-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -170,6 +170,7 @@ files:
 - lib/cadenya/models/attribute_filter.rb
 - lib/cadenya/models/bare_metadata.rb
 - lib/cadenya/models/callable_tool.rb
+- lib/cadenya/models/context_lengths.rb
 - lib/cadenya/models/context_window_compacted.rb
 - lib/cadenya/models/create_operation_metadata.rb
 - lib/cadenya/models/create_resource_metadata.rb
@@ -211,6 +212,7 @@ files:
 - lib/cadenya/models/objective_context_window_data.rb
 - lib/cadenya/models/objective_continue_params.rb
 - lib/cadenya/models/objective_create_params.rb
+- lib/cadenya/models/objective_diagnostics.rb
 - lib/cadenya/models/objective_error.rb
 - lib/cadenya/models/objective_event.rb
 - lib/cadenya/models/objective_event_data.rb
@@ -220,6 +222,8 @@ files:
 - lib/cadenya/models/objective_list_context_windows_params.rb
 - lib/cadenya/models/objective_list_events_params.rb
 - lib/cadenya/models/objective_list_params.rb
+- lib/cadenya/models/objective_retrieve_diagnostics_params.rb
+- lib/cadenya/models/objective_retrieve_diagnostics_response.rb
 - lib/cadenya/models/objective_retrieve_params.rb
 - lib/cadenya/models/objective_secret.rb
 - lib/cadenya/models/objective_stream_events_params.rb
@@ -484,6 +488,7 @@ files:
 - rbi/cadenya/models/attribute_filter.rbi
 - rbi/cadenya/models/bare_metadata.rbi
 - rbi/cadenya/models/callable_tool.rbi
+- rbi/cadenya/models/context_lengths.rbi
 - rbi/cadenya/models/context_window_compacted.rbi
 - rbi/cadenya/models/create_operation_metadata.rbi
 - rbi/cadenya/models/create_resource_metadata.rbi
@@ -525,6 +530,7 @@ files:
 - rbi/cadenya/models/objective_context_window_data.rbi
 - rbi/cadenya/models/objective_continue_params.rbi
 - rbi/cadenya/models/objective_create_params.rbi
+- rbi/cadenya/models/objective_diagnostics.rbi
 - rbi/cadenya/models/objective_error.rbi
 - rbi/cadenya/models/objective_event.rbi
 - rbi/cadenya/models/objective_event_data.rbi
@@ -534,6 +540,8 @@ files:
 - rbi/cadenya/models/objective_list_context_windows_params.rbi
 - rbi/cadenya/models/objective_list_events_params.rbi
 - rbi/cadenya/models/objective_list_params.rbi
+- rbi/cadenya/models/objective_retrieve_diagnostics_params.rbi
+- rbi/cadenya/models/objective_retrieve_diagnostics_response.rbi
 - rbi/cadenya/models/objective_retrieve_params.rbi
 - rbi/cadenya/models/objective_secret.rbi
 - rbi/cadenya/models/objective_stream_events_params.rbi
@@ -797,6 +805,7 @@ files:
 - sig/cadenya/models/attribute_filter.rbs
 - sig/cadenya/models/bare_metadata.rbs
 - sig/cadenya/models/callable_tool.rbs
+- sig/cadenya/models/context_lengths.rbs
 - sig/cadenya/models/context_window_compacted.rbs
 - sig/cadenya/models/create_operation_metadata.rbs
 - sig/cadenya/models/create_resource_metadata.rbs
@@ -838,6 +847,7 @@ files:
 - sig/cadenya/models/objective_context_window_data.rbs
 - sig/cadenya/models/objective_continue_params.rbs
 - sig/cadenya/models/objective_create_params.rbs
+- sig/cadenya/models/objective_diagnostics.rbs
 - sig/cadenya/models/objective_error.rbs
 - sig/cadenya/models/objective_event.rbs
 - sig/cadenya/models/objective_event_data.rbs
@@ -847,6 +857,8 @@ files:
 - sig/cadenya/models/objective_list_context_windows_params.rbs
 - sig/cadenya/models/objective_list_events_params.rbs
 - sig/cadenya/models/objective_list_params.rbs
+- sig/cadenya/models/objective_retrieve_diagnostics_params.rbs
+- sig/cadenya/models/objective_retrieve_diagnostics_response.rbs
 - sig/cadenya/models/objective_retrieve_params.rbs
 - sig/cadenya/models/objective_secret.rbs
 - sig/cadenya/models/objective_stream_events_params.rbs