cadenya 0.26.0 → 0.27.0

data/rbi/cadenya/models/objective_event_data.rbi

@@ -61,6 +61,17 @@ module Cadenya
       sig { params(memory_read: Cadenya::MemoryRead::OrHash).void }
       attr_writer :memory_read
 
+      # Notice is a non-terminal diagnostic emitted by the runtime when something
+      # noteworthy but non-fatal happens during an objective — for example a
+      # just-in-time tool set failing to load, or a previously loaded tool being dropped
+      # because it was archived. Notices carry no structured payload; they exist to make
+      # the objective timeline self-explanatory.
+      sig { returns(T.nilable(Cadenya::ObjectiveEventData::Notice)) }
+      attr_reader :notice
+
+      sig { params(notice: Cadenya::ObjectiveEventData::Notice::OrHash).void }
+      attr_writer :notice
+
       sig { returns(T.nilable(Cadenya::SubAgentSpawned)) }
       attr_reader :sub_agent_spawned
 
@@ -133,6 +144,7 @@ module Cadenya
           error: Cadenya::ObjectiveError::OrHash,
           finalized: Cadenya::ObjectiveEventData::Finalized::OrHash,
           memory_read: Cadenya::MemoryRead::OrHash,
+          notice: Cadenya::ObjectiveEventData::Notice::OrHash,
           sub_agent_spawned: Cadenya::SubAgentSpawned::OrHash,
           sub_agent_updated: Cadenya::SubAgentUpdated::OrHash,
           tool_approval_requested: Cadenya::ToolApprovalRequested::OrHash,
@@ -161,6 +173,12 @@ module Cadenya
         # cascade and loads an entry. Lookups that miss (key not found in any layer) do
         # not emit this event.
         memory_read: nil,
+        # Notice is a non-terminal diagnostic emitted by the runtime when something
+        # noteworthy but non-fatal happens during an objective — for example a
+        # just-in-time tool set failing to load, or a previously loaded tool being dropped
+        # because it was archived. Notices carry no structured payload; they exist to make
+        # the objective timeline self-explanatory.
+        notice: nil,
         sub_agent_spawned: nil,
         sub_agent_updated: nil,
         tool_approval_requested: nil,
@@ -183,6 +201,7 @@ module Cadenya
             error: Cadenya::ObjectiveError,
             finalized: Cadenya::ObjectiveEventData::Finalized,
             memory_read: Cadenya::MemoryRead,
+            notice: Cadenya::ObjectiveEventData::Notice,
             sub_agent_spawned: Cadenya::SubAgentSpawned,
             sub_agent_updated: Cadenya::SubAgentUpdated,
             tool_approval_requested: Cadenya::ToolApprovalRequested,
@@ -268,6 +287,115 @@ module Cadenya
         def to_hash
         end
       end
+
+      class Notice < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::ObjectiveEventData::Notice,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        # Stable machine-readable identifier for the notice kind (for example
+        # "tool_set_load_failed", "tool_archived"). Clients can switch on it or use it as
+        # an i18n key; the message is the English fallback.
+        sig { returns(T.nilable(String)) }
+        attr_reader :key
+
+        sig { params(key: String).void }
+        attr_writer :key
+
+        sig do
+          returns(
+            T.nilable(Cadenya::ObjectiveEventData::Notice::Level::TaggedSymbol)
+          )
+        end
+        attr_reader :level
+
+        sig do
+          params(
+            level: Cadenya::ObjectiveEventData::Notice::Level::OrSymbol
+          ).void
+        end
+        attr_writer :level
+
+        # Human-readable description of what happened.
+        sig { returns(T.nilable(String)) }
+        attr_reader :message
+
+        sig { params(message: String).void }
+        attr_writer :message
+
+        # Notice is a non-terminal diagnostic emitted by the runtime when something
+        # noteworthy but non-fatal happens during an objective — for example a
+        # just-in-time tool set failing to load, or a previously loaded tool being dropped
+        # because it was archived. Notices carry no structured payload; they exist to make
+        # the objective timeline self-explanatory.
+        sig do
+          params(
+            key: String,
+            level: Cadenya::ObjectiveEventData::Notice::Level::OrSymbol,
+            message: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Stable machine-readable identifier for the notice kind (for example
+          # "tool_set_load_failed", "tool_archived"). Clients can switch on it or use it as
+          # an i18n key; the message is the English fallback.
+          key: nil,
+          level: nil,
+          # Human-readable description of what happened.
+          message: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              key: String,
+              level: Cadenya::ObjectiveEventData::Notice::Level::TaggedSymbol,
+              message: String
+            }
+          )
+        end
+        def to_hash
+        end
+
+        module Level
+          extend Cadenya::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(Symbol, Cadenya::ObjectiveEventData::Notice::Level)
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          LEVEL_UNSPECIFIED =
+            T.let(
+              :LEVEL_UNSPECIFIED,
+              Cadenya::ObjectiveEventData::Notice::Level::TaggedSymbol
+            )
+          LEVEL_INFO =
+            T.let(
+              :LEVEL_INFO,
+              Cadenya::ObjectiveEventData::Notice::Level::TaggedSymbol
+            )
+          LEVEL_WARN =
+            T.let(
+              :LEVEL_WARN,
+              Cadenya::ObjectiveEventData::Notice::Level::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[Cadenya::ObjectiveEventData::Notice::Level::TaggedSymbol]
+            )
+          end
+          def self.values
+          end
+        end
+      end
     end
   end
 end

data/rbi/cadenya/models/rotate_challenge_token_response.rbi

@@ -0,0 +1,30 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    class RotateChallengeTokenResponse < Cadenya::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            Cadenya::RotateChallengeTokenResponse,
+            Cadenya::Internal::AnyHash
+          )
+        end
+
+      sig { returns(T.nilable(String)) }
+      attr_reader :challenge_token
+
+      sig { params(challenge_token: String).void }
+      attr_writer :challenge_token
+
+      # Response containing the newly generated challenge token.
+      sig { params(challenge_token: String).returns(T.attached_class) }
+      def self.new(challenge_token: nil)
+      end
+
+      sig { override.returns({ challenge_token: String }) }
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/cadenya/models/tool_set_adapter_mcp.rbi

@@ -28,6 +28,17 @@ module Cadenya
       sig { params(include_tools: Cadenya::ToolFilter::OrHash).void }
       attr_writer :include_tools
 
+      # Defines behavior for just-in-time capable tool set adapters (IE: MCP).
+      sig { returns(T.nilable(Cadenya::ToolSetAdapterMcp::JustInTime)) }
+      attr_reader :just_in_time
+
+      sig do
+        params(
+          just_in_time: Cadenya::ToolSetAdapterMcp::JustInTime::OrHash
+        ).void
+      end
+      attr_writer :just_in_time
+
       # Approval filters that will automatically set the approval requirement on tools
       # synced from an external source
       sig { returns(T.nilable(Cadenya::ApprovalRequirementFilter)) }
@@ -49,6 +60,7 @@ module Cadenya
           exclude_tools: Cadenya::ToolFilter::OrHash,
           headers: T::Hash[Symbol, String],
           include_tools: Cadenya::ToolFilter::OrHash,
+          just_in_time: Cadenya::ToolSetAdapterMcp::JustInTime::OrHash,
           tool_approvals: Cadenya::ApprovalRequirementFilter::OrHash,
           url: String
         ).returns(T.attached_class)
@@ -59,6 +71,8 @@ module Cadenya
         headers: nil,
         # Top-level filter with simple boolean logic (no nesting)
         include_tools: nil,
+        # Defines behavior for just-in-time capable tool set adapters (IE: MCP).
+        just_in_time: nil,
         # Approval filters that will automatically set the approval requirement on tools
         # synced from an external source
         tool_approvals: nil,
@@ -72,6 +86,7 @@ module Cadenya
             exclude_tools: Cadenya::ToolFilter,
             headers: T::Hash[Symbol, String],
             include_tools: Cadenya::ToolFilter,
+            just_in_time: Cadenya::ToolSetAdapterMcp::JustInTime,
             tool_approvals: Cadenya::ApprovalRequirementFilter,
             url: String
           }
@@ -79,6 +94,60 @@ module Cadenya
       end
       def to_hash
       end
+
+      class JustInTime < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              Cadenya::ToolSetAdapterMcp::JustInTime,
+              Cadenya::Internal::AnyHash
+            )
+          end
+
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :enabled
+
+        sig { params(enabled: T::Boolean).void }
+        attr_writer :enabled
+
+        # If set, an objective will automatically be failed if tools cannot be loaded in
+        # the initial stages of an objective being created. Tools are loaded
+        # asynchronously, so this setting is useful for ensuring that an objective
+        # continued any further if tools are not available.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :fail_objective_on_tool_list_error
+
+        sig { params(fail_objective_on_tool_list_error: T::Boolean).void }
+        attr_writer :fail_objective_on_tool_list_error
+
+        # Defines behavior for just-in-time capable tool set adapters (IE: MCP).
+        sig do
+          params(
+            enabled: T::Boolean,
+            fail_objective_on_tool_list_error: T::Boolean
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          enabled: nil,
+          # If set, an objective will automatically be failed if tools cannot be loaded in
+          # the initial stages of an objective being created. Tools are loaded
+          # asynchronously, so this setting is useful for ensuring that an objective
+          # continued any further if tools are not available.
+          fail_objective_on_tool_list_error: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              enabled: T::Boolean,
+              fail_objective_on_tool_list_error: T::Boolean
+            }
+          )
+        end
+        def to_hash
+        end
+      end
     end
   end
 end

data/rbi/cadenya/models/tool_sets/tool_info.rbi

@@ -25,9 +25,20 @@ module Cadenya
         sig { params(tool_set: Cadenya::ResourceMetadata::OrHash).void }
         attr_writer :tool_set
 
+        # Content signature identifying the tool within its tool set: a hash of the
+        # sanitized llm_tool_name, description, and canonical parameters. Two tools with
+        # the same llm_tool_name but different parameters or description (as MCP servers
+        # may return per user) have distinct signatures.
+        sig { returns(T.nilable(String)) }
+        attr_reader :signature
+
+        sig { params(signature: String).void }
+        attr_writer :signature
+
         sig do
           params(
             created_by: Cadenya::Profile::OrHash,
+            signature: String,
             tool_set: Cadenya::ResourceMetadata::OrHash
           ).returns(T.attached_class)
         end
@@ -36,6 +47,11 @@ module Cadenya
           # account level. Profiles are account-scoped and can be granted access to multiple
           # workspaces.
           created_by: nil,
+          # Content signature identifying the tool within its tool set: a hash of the
+          # sanitized llm_tool_name, description, and canonical parameters. Two tools with
+          # the same llm_tool_name but different parameters or description (as MCP servers
+          # may return per user) have distinct signatures.
+          signature: nil,
           # Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
           tool_set: nil
         )
@@ -45,6 +61,7 @@ module Cadenya
           override.returns(
             {
               created_by: Cadenya::Profile,
+              signature: String,
               tool_set: Cadenya::ResourceMetadata
             }
           )

data/rbi/cadenya/models.rbi

@@ -9,6 +9,9 @@ module Cadenya
 
   AccountRetrieveParams = Cadenya::Models::AccountRetrieveParams
 
+  AccountRotateChallengeTokenParams =
+    Cadenya::Models::AccountRotateChallengeTokenParams
+
   AccountRotateWebhookSigningKeyParams =
     Cadenya::Models::AccountRotateWebhookSigningKeyParams
 
@@ -183,6 +186,8 @@ module Cadenya
 
   ResourceMetadata = Cadenya::Models::ResourceMetadata
 
+  RotateChallengeTokenResponse = Cadenya::Models::RotateChallengeTokenResponse
+
   RotateWebhookSigningKeyResponse =
     Cadenya::Models::RotateWebhookSigningKeyResponse
 

data/rbi/cadenya/resources/account.rbi

@@ -15,6 +15,16 @@ module Cadenya
       def retrieve(request_options: {})
       end
 
+      # Rotates the challenge token sent in the X-Cadenya-Challenge-Token header on MCP
+      # tools/list requests. Returns only the new token.
+      sig do
+        params(request_options: Cadenya::RequestOptions::OrHash).returns(
+          Cadenya::RotateChallengeTokenResponse
+        )
+      end
+      def rotate_challenge_token(request_options: {})
+      end
+
       # Rotates the webhook signing key for the account. Returns only the new key.
       sig do
         params(request_options: Cadenya::RequestOptions::OrHash).returns(

data/rbi/cadenya/resources/objectives.rbi

@@ -182,7 +182,6 @@ module Cadenya
           workspace_id: String,
           enqueue: T::Boolean,
           message: String,
-          secrets: T::Array[Cadenya::ObjectiveContinueParams::Secret::OrHash],
           request_options: Cadenya::RequestOptions::OrHash
         ).returns(Cadenya::ObjectiveEvent)
       end
@@ -199,10 +198,6 @@ module Cadenya
         # Body param: The message to continue an objective that has completed (or you are
         # enqueing)
         message: nil,
-        # Body param: Secrets that should be included with the message. Helpful for when
-        # you need to update secrets on the objective (IE: A secret expires and needs to
-        # be refreshed)
-        secrets: nil,
         request_options: {}
       )
       end

data/sig/cadenya/models/account_info.rbs

@@ -1,9 +1,17 @@
 module Cadenya
   module Models
     type account_info =
-      { global_api_key: Cadenya::APIKey, webhook_events_hmac_secret: String }
+      {
+        challenge_token: String,
+        global_api_key: Cadenya::APIKey,
+        webhook_events_hmac_secret: String
+      }
 
     class AccountInfo < Cadenya::Internal::Type::BaseModel
+      attr_reader challenge_token: String?
+
+      def challenge_token=: (String) -> String
+
       attr_reader global_api_key: Cadenya::APIKey?
 
       def global_api_key=: (Cadenya::APIKey) -> Cadenya::APIKey
@@ -13,11 +21,13 @@ module Cadenya
       def webhook_events_hmac_secret=: (String) -> String
 
       def initialize: (
+        ?challenge_token: String,
         ?global_api_key: Cadenya::APIKey,
         ?webhook_events_hmac_secret: String
       ) -> void
 
       def to_hash: -> {
+        challenge_token: String,
         global_api_key: Cadenya::APIKey,
         webhook_events_hmac_secret: String
       }

data/sig/cadenya/models/account_rotate_challenge_token_params.rbs

@@ -0,0 +1,15 @@
+module Cadenya
+  module Models
+    type account_rotate_challenge_token_params =
+      {  } & Cadenya::Internal::Type::request_parameters
+
+    class AccountRotateChallengeTokenParams < Cadenya::Internal::Type::BaseModel
+      extend Cadenya::Internal::Type::RequestParameters::Converter
+      include Cadenya::Internal::Type::RequestParameters
+
+      def initialize: (?request_options: Cadenya::request_opts) -> void
+
+      def to_hash: -> { request_options: Cadenya::RequestOptions }
+    end
+  end
+end

data/sig/cadenya/models/agents/webhook_delivery_data.rbs

@@ -105,6 +105,7 @@ module Cadenya
           | :OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED
           | :OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED
           | :OBJECTIVE_EVENT_TYPE_FINALIZED
+          | :OBJECTIVE_EVENT_TYPE_NOTICE
 
         module EventType
           extend Cadenya::Internal::Type::Enum
@@ -125,6 +126,7 @@ module Cadenya
           OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED: :OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED
           OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED: :OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED
           OBJECTIVE_EVENT_TYPE_FINALIZED: :OBJECTIVE_EVENT_TYPE_FINALIZED
+          OBJECTIVE_EVENT_TYPE_NOTICE: :OBJECTIVE_EVENT_TYPE_NOTICE
 
           def self?.values: -> ::Array[Cadenya::Models::Agents::WebhookDeliveryData::event_type]
         end

data/sig/cadenya/models/agents/webhook_delivery_list_params.rbs

@@ -75,6 +75,7 @@ module Cadenya
           | :OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED
           | :OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED
           | :OBJECTIVE_EVENT_TYPE_FINALIZED
+          | :OBJECTIVE_EVENT_TYPE_NOTICE
 
         module EventType
           extend Cadenya::Internal::Type::Enum
@@ -95,6 +96,7 @@ module Cadenya
           OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED: :OBJECTIVE_EVENT_TYPE_SUB_AGENT_SPAWNED
           OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED: :OBJECTIVE_EVENT_TYPE_SUB_AGENT_UPDATED
           OBJECTIVE_EVENT_TYPE_FINALIZED: :OBJECTIVE_EVENT_TYPE_FINALIZED
+          OBJECTIVE_EVENT_TYPE_NOTICE: :OBJECTIVE_EVENT_TYPE_NOTICE
 
           def self?.values: -> ::Array[Cadenya::Models::Agents::WebhookDeliveryListParams::event_type]
         end

data/sig/cadenya/models/objective_continue_params.rbs

@@ -5,8 +5,7 @@ module Cadenya
         workspace_id: String,
         objective_id: String,
         enqueue: bool,
-        message: String,
-        secrets: ::Array[Cadenya::ObjectiveContinueParams::Secret]
+        message: String
       }
       & Cadenya::Internal::Type::request_parameters
 
@@ -26,18 +25,11 @@ module Cadenya
 
       def message=: (String) -> String
 
-      attr_reader secrets: ::Array[Cadenya::ObjectiveContinueParams::Secret]?
-
-      def secrets=: (
-        ::Array[Cadenya::ObjectiveContinueParams::Secret]
-      ) -> ::Array[Cadenya::ObjectiveContinueParams::Secret]
-
       def initialize: (
         workspace_id: String,
         objective_id: String,
         ?enqueue: bool,
         ?message: String,
-        ?secrets: ::Array[Cadenya::ObjectiveContinueParams::Secret],
         ?request_options: Cadenya::request_opts
       ) -> void
 
@@ -46,25 +38,8 @@ module Cadenya
         objective_id: String,
         enqueue: bool,
         message: String,
-        secrets: ::Array[Cadenya::ObjectiveContinueParams::Secret],
         request_options: Cadenya::RequestOptions
       }
-
-      type secret = { name: String, value: String }
-
-      class Secret < Cadenya::Internal::Type::BaseModel
-        attr_reader name: String?
-
-        def name=: (String) -> String
-
-        attr_reader value: String?
-
-        def value=: (String) -> String
-
-        def initialize: (?name: String, ?value: String) -> void
-
-        def to_hash: -> { name: String, value: String }
-      end
     end
   end
 end

data/sig/cadenya/models/objective_event_data.rbs

@@ -8,6 +8,7 @@ module Cadenya
         error: Cadenya::ObjectiveError,
         finalized: Cadenya::ObjectiveEventData::Finalized,
         memory_read: Cadenya::MemoryRead,
+        notice: Cadenya::ObjectiveEventData::Notice,
         sub_agent_spawned: Cadenya::SubAgentSpawned,
         sub_agent_updated: Cadenya::SubAgentUpdated,
         tool_approval_requested: Cadenya::ToolApprovalRequested,
@@ -53,6 +54,12 @@ module Cadenya
 
       def memory_read=: (Cadenya::MemoryRead) -> Cadenya::MemoryRead
 
+      attr_reader notice: Cadenya::ObjectiveEventData::Notice?
+
+      def notice=: (
+        Cadenya::ObjectiveEventData::Notice
+      ) -> Cadenya::ObjectiveEventData::Notice
+
       attr_reader sub_agent_spawned: Cadenya::SubAgentSpawned?
 
       def sub_agent_spawned=: (
@@ -106,6 +113,7 @@ module Cadenya
         ?error: Cadenya::ObjectiveError,
         ?finalized: Cadenya::ObjectiveEventData::Finalized,
         ?memory_read: Cadenya::MemoryRead,
+        ?notice: Cadenya::ObjectiveEventData::Notice,
         ?sub_agent_spawned: Cadenya::SubAgentSpawned,
         ?sub_agent_updated: Cadenya::SubAgentUpdated,
         ?tool_approval_requested: Cadenya::ToolApprovalRequested,
@@ -125,6 +133,7 @@ module Cadenya
         error: Cadenya::ObjectiveError,
         finalized: Cadenya::ObjectiveEventData::Finalized,
         memory_read: Cadenya::MemoryRead,
+        notice: Cadenya::ObjectiveEventData::Notice,
         sub_agent_spawned: Cadenya::SubAgentSpawned,
         sub_agent_updated: Cadenya::SubAgentUpdated,
         tool_approval_requested: Cadenya::ToolApprovalRequested,
@@ -160,6 +169,53 @@ module Cadenya
 
         def to_hash: -> { output: top }
       end
+
+      type notice =
+        {
+          key: String,
+          level: Cadenya::Models::ObjectiveEventData::Notice::level,
+          message: String
+        }
+
+      class Notice < Cadenya::Internal::Type::BaseModel
+        attr_reader key: String?
+
+        def key=: (String) -> String
+
+        attr_reader level: Cadenya::Models::ObjectiveEventData::Notice::level?
+
+        def level=: (
+          Cadenya::Models::ObjectiveEventData::Notice::level
+        ) -> Cadenya::Models::ObjectiveEventData::Notice::level
+
+        attr_reader message: String?
+
+        def message=: (String) -> String
+
+        def initialize: (
+          ?key: String,
+          ?level: Cadenya::Models::ObjectiveEventData::Notice::level,
+          ?message: String
+        ) -> void
+
+        def to_hash: -> {
+          key: String,
+          level: Cadenya::Models::ObjectiveEventData::Notice::level,
+          message: String
+        }
+
+        type level = :LEVEL_UNSPECIFIED | :LEVEL_INFO | :LEVEL_WARN
+
+        module Level
+          extend Cadenya::Internal::Type::Enum
+
+          LEVEL_UNSPECIFIED: :LEVEL_UNSPECIFIED
+          LEVEL_INFO: :LEVEL_INFO
+          LEVEL_WARN: :LEVEL_WARN
+
+          def self?.values: -> ::Array[Cadenya::Models::ObjectiveEventData::Notice::level]
+        end
+      end
     end
   end
 end

data/sig/cadenya/models/rotate_challenge_token_response.rbs

@@ -0,0 +1,15 @@
+module Cadenya
+  module Models
+    type rotate_challenge_token_response = { challenge_token: String }
+
+    class RotateChallengeTokenResponse < Cadenya::Internal::Type::BaseModel
+      attr_reader challenge_token: String?
+
+      def challenge_token=: (String) -> String
+
+      def initialize: (?challenge_token: String) -> void
+
+      def to_hash: -> { challenge_token: String }
+    end
+  end
+end