cadenya 0.24.0 → 0.25.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 56345beed04805e02e3d9160438370098e235277a458b4d99964df96d689d1fa
-  data.tar.gz: 48e4a95347381ea29f7f4523d1098af4aab96e1a9a43e5187a6c115120848087
+  metadata.gz: 85a23df17834062235e1de7898d6d6c30f688f8a42a0cb899446c44b860625cf
+  data.tar.gz: fb33b235dc855b0bf55c8ef4a968db692d3a06f652997d9c572a00627c7c544a
 SHA512:
-  metadata.gz: 9e343691120327cdd8c6c1d14df4f15d77344f9a625ec59fff2d743999330aacecb0fad0fe0290ebd8bd2094bce006b60e95e225ef4c1f403700542bfe03feff
-  data.tar.gz: 218de860735ffcfcc65da64a9ca06675bfee2a54f45c5588ec400e5d330d9cedd7e9730a3078592ad4924d4698a291c2a26fe0baf79f181bbdc527c6b58d540b
+  metadata.gz: c8439ad320e591096765d4ea8b9a4537999afc841fcbf55b4ff0d6e09c5f9693f8faf48eadd8f373a56aa805c80347bab004b64db484f81a2498bd8efd605a8d
+  data.tar.gz: e65efdeaabac43576f78ad4e2f32c96de41cd4674679eeffaa815c7222de795b34f3b758b40137da6302aabee78b0efe0ac2f2dc918fd33abd75866fa90e6efa

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.25.0 (2026-07-02)
+
+Full Changelog: [v0.24.0...v0.25.0](https://github.com/cadenya/cadenya-ruby/compare/v0.24.0...v0.25.0)
+
+### Features
+
+* **api:** api update ([9adf4ad](https://github.com/cadenya/cadenya-ruby/commit/9adf4adeaf93b4774163acaad8ad941d55e6e3d0))
+
 ## 0.24.0 (2026-07-01)
 
 Full Changelog: [v0.23.0...v0.24.0](https://github.com/cadenya/cadenya-ruby/compare/v0.23.0...v0.24.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.24.0"
+gem "cadenya", "~> 0.25.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/cadenya/models/tool_sets/config_mcp.rb

@@ -3,8 +3,23 @@
 module Cadenya
   module Models
     module ToolSets
-      # @type [Cadenya::Internal::Type::Converter]
-      ConfigMcp = Cadenya::Internal::Type::Unknown
+      class ConfigMcp < Cadenya::Internal::Type::BaseModel
+        # @!attribute annotations
+        #   Behavior hints synced from the MCP server's tool definition (ToolAnnotations in
+        #   the MCP specification). All hints are advisory: servers are not required to send
+        #   them, and clients should not rely on them for security decisions. Absent hints
+        #   keep the MCP spec defaults (destructiveHint and openWorldHint default to true;
+        #   readOnlyHint and idempotentHint default to false).
+        #
+        #   @return [Cadenya::Models::ToolSets::McpAnnotations, nil]
+        optional :annotations, -> { Cadenya::ToolSets::McpAnnotations }
+
+        # @!method initialize(annotations: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::ToolSets::ConfigMcp} for more details.
+        #
+        #   @param annotations [Cadenya::Models::ToolSets::McpAnnotations] Behavior hints synced from the MCP server's tool definition
+      end
     end
   end
 end

data/lib/cadenya/models/tool_sets/mcp_annotations.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Cadenya
+  module Models
+    module ToolSets
+      class McpAnnotations < Cadenya::Internal::Type::BaseModel
+        # @!attribute destructive_hint
+        #   If true, the tool may perform destructive updates to its environment. Only
+        #   meaningful when read_only_hint is false.
+        #
+        #   @return [Boolean, nil]
+        optional :destructive_hint, Cadenya::Internal::Type::Boolean, api_name: :destructiveHint
+
+        # @!attribute idempotent_hint
+        #   If true, calling the tool repeatedly with the same arguments has no additional
+        #   effect. Only meaningful when read_only_hint is false.
+        #
+        #   @return [Boolean, nil]
+        optional :idempotent_hint, Cadenya::Internal::Type::Boolean, api_name: :idempotentHint
+
+        # @!attribute open_world_hint
+        #   If true, the tool may interact with an "open world" of external entities (e.g.
+        #   web search); if false, its domain is closed.
+        #
+        #   @return [Boolean, nil]
+        optional :open_world_hint, Cadenya::Internal::Type::Boolean, api_name: :openWorldHint
+
+        # @!attribute read_only_hint
+        #   If true, the tool does not modify its environment.
+        #
+        #   @return [Boolean, nil]
+        optional :read_only_hint, Cadenya::Internal::Type::Boolean, api_name: :readOnlyHint
+
+        # @!attribute title
+        #   A human-readable title for the tool.
+        #
+        #   @return [String, nil]
+        optional :title, String
+
+        # @!method initialize(destructive_hint: nil, idempotent_hint: nil, open_world_hint: nil, read_only_hint: nil, title: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Cadenya::Models::ToolSets::McpAnnotations} for more details.
+        #
+        #   Behavior hints synced from the MCP server's tool definition (ToolAnnotations in
+        #   the MCP specification). All hints are advisory: servers are not required to send
+        #   them, and clients should not rely on them for security decisions. Absent hints
+        #   keep the MCP spec defaults (destructiveHint and openWorldHint default to true;
+        #   readOnlyHint and idempotentHint default to false).
+        #
+        #   @param destructive_hint [Boolean] If true, the tool may perform destructive updates to its environment.
+        #
+        #   @param idempotent_hint [Boolean] If true, calling the tool repeatedly with the same arguments has no
+        #
+        #   @param open_world_hint [Boolean] If true, the tool may interact with an "open world" of external
+        #
+        #   @param read_only_hint [Boolean] If true, the tool does not modify its environment.
+        #
+        #   @param title [String] A human-readable title for the tool.
+      end
+    end
+  end
+end

data/lib/cadenya/models/tool_sets/tool_spec_config.rb

@@ -11,8 +11,8 @@ module Cadenya
 
         # @!attribute mcp
         #
-        #   @return [Object, nil]
-        optional :mcp, Cadenya::Internal::Type::Unknown
+        #   @return [Cadenya::Models::ToolSets::ConfigMcp, nil]
+        optional :mcp, -> { Cadenya::ToolSets::ConfigMcp }
 
         # @!attribute openapi
         #
@@ -25,7 +25,7 @@ module Cadenya
         #   be Http. If the tool is an inline tool, the adapter will be Inline.
         #
         #   @param http [Cadenya::Models::ToolSets::ConfigHTTP]
-        #   @param mcp [Object]
+        #   @param mcp [Cadenya::Models::ToolSets::ConfigMcp]
         #   @param openapi [Cadenya::Models::ToolSets::ConfigOpenAPI]
       end
     end

data/lib/cadenya/version.rb

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

data/lib/cadenya.rb

@@ -258,6 +258,7 @@ require_relative "cadenya/models/tool_set_retrieve_params"
 require_relative "cadenya/models/tool_sets/config_http"
 require_relative "cadenya/models/tool_sets/config_mcp"
 require_relative "cadenya/models/tool_sets/config_openapi"
+require_relative "cadenya/models/tool_sets/mcp_annotations"
 require_relative "cadenya/models/tool_sets/secret_create_params"
 require_relative "cadenya/models/tool_sets/secret_delete_params"
 require_relative "cadenya/models/tool_sets/secret_list_params"

data/rbi/cadenya/models/tool_sets/config_mcp.rbi

@@ -3,7 +3,46 @@
 module Cadenya
   module Models
     module ToolSets
-      ConfigMcp = T.let(T.anything, Cadenya::Internal::Type::Converter)
+      class ConfigMcp < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Cadenya::ToolSets::ConfigMcp, Cadenya::Internal::AnyHash)
+          end
+
+        # Behavior hints synced from the MCP server's tool definition (ToolAnnotations in
+        # the MCP specification). All hints are advisory: servers are not required to send
+        # them, and clients should not rely on them for security decisions. Absent hints
+        # keep the MCP spec defaults (destructiveHint and openWorldHint default to true;
+        # readOnlyHint and idempotentHint default to false).
+        sig { returns(T.nilable(Cadenya::ToolSets::McpAnnotations)) }
+        attr_reader :annotations
+
+        sig do
+          params(annotations: Cadenya::ToolSets::McpAnnotations::OrHash).void
+        end
+        attr_writer :annotations
+
+        sig do
+          params(
+            annotations: Cadenya::ToolSets::McpAnnotations::OrHash
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Behavior hints synced from the MCP server's tool definition (ToolAnnotations in
+          # the MCP specification). All hints are advisory: servers are not required to send
+          # them, and clients should not rely on them for security decisions. Absent hints
+          # keep the MCP spec defaults (destructiveHint and openWorldHint default to true;
+          # readOnlyHint and idempotentHint default to false).
+          annotations: nil
+        )
+        end
+
+        sig do
+          override.returns({ annotations: Cadenya::ToolSets::McpAnnotations })
+        end
+        def to_hash
+        end
+      end
     end
   end
 end

data/rbi/cadenya/models/tool_sets/mcp_annotations.rbi

@@ -0,0 +1,97 @@
+# typed: strong
+
+module Cadenya
+  module Models
+    module ToolSets
+      class McpAnnotations < Cadenya::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(Cadenya::ToolSets::McpAnnotations, Cadenya::Internal::AnyHash)
+          end
+
+        # If true, the tool may perform destructive updates to its environment. Only
+        # meaningful when read_only_hint is false.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :destructive_hint
+
+        sig { params(destructive_hint: T::Boolean).void }
+        attr_writer :destructive_hint
+
+        # If true, calling the tool repeatedly with the same arguments has no additional
+        # effect. Only meaningful when read_only_hint is false.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :idempotent_hint
+
+        sig { params(idempotent_hint: T::Boolean).void }
+        attr_writer :idempotent_hint
+
+        # If true, the tool may interact with an "open world" of external entities (e.g.
+        # web search); if false, its domain is closed.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :open_world_hint
+
+        sig { params(open_world_hint: T::Boolean).void }
+        attr_writer :open_world_hint
+
+        # If true, the tool does not modify its environment.
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :read_only_hint
+
+        sig { params(read_only_hint: T::Boolean).void }
+        attr_writer :read_only_hint
+
+        # A human-readable title for the tool.
+        sig { returns(T.nilable(String)) }
+        attr_reader :title
+
+        sig { params(title: String).void }
+        attr_writer :title
+
+        # Behavior hints synced from the MCP server's tool definition (ToolAnnotations in
+        # the MCP specification). All hints are advisory: servers are not required to send
+        # them, and clients should not rely on them for security decisions. Absent hints
+        # keep the MCP spec defaults (destructiveHint and openWorldHint default to true;
+        # readOnlyHint and idempotentHint default to false).
+        sig do
+          params(
+            destructive_hint: T::Boolean,
+            idempotent_hint: T::Boolean,
+            open_world_hint: T::Boolean,
+            read_only_hint: T::Boolean,
+            title: String
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # If true, the tool may perform destructive updates to its environment. Only
+          # meaningful when read_only_hint is false.
+          destructive_hint: nil,
+          # If true, calling the tool repeatedly with the same arguments has no additional
+          # effect. Only meaningful when read_only_hint is false.
+          idempotent_hint: nil,
+          # If true, the tool may interact with an "open world" of external entities (e.g.
+          # web search); if false, its domain is closed.
+          open_world_hint: nil,
+          # If true, the tool does not modify its environment.
+          read_only_hint: nil,
+          # A human-readable title for the tool.
+          title: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              destructive_hint: T::Boolean,
+              idempotent_hint: T::Boolean,
+              open_world_hint: T::Boolean,
+              read_only_hint: T::Boolean,
+              title: String
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/cadenya/models/tool_sets/tool_spec_config.rbi

@@ -15,10 +15,10 @@ module Cadenya
         sig { params(http: Cadenya::ToolSets::ConfigHTTP::OrHash).void }
         attr_writer :http
 
-        sig { returns(T.nilable(T.anything)) }
+        sig { returns(T.nilable(Cadenya::ToolSets::ConfigMcp)) }
         attr_reader :mcp
 
-        sig { params(mcp: T.anything).void }
+        sig { params(mcp: Cadenya::ToolSets::ConfigMcp::OrHash).void }
         attr_writer :mcp
 
         sig { returns(T.nilable(Cadenya::ToolSets::ConfigOpenAPI)) }
@@ -33,7 +33,7 @@ module Cadenya
         sig do
           params(
             http: Cadenya::ToolSets::ConfigHTTP::OrHash,
-            mcp: T.anything,
+            mcp: Cadenya::ToolSets::ConfigMcp::OrHash,
             openapi: Cadenya::ToolSets::ConfigOpenAPI::OrHash
           ).returns(T.attached_class)
         end
@@ -44,7 +44,7 @@ module Cadenya
           override.returns(
             {
               http: Cadenya::ToolSets::ConfigHTTP,
-              mcp: T.anything,
+              mcp: Cadenya::ToolSets::ConfigMcp,
               openapi: Cadenya::ToolSets::ConfigOpenAPI
             }
           )

data/sig/cadenya/models/tool_sets/config_mcp.rbs

@@ -1,7 +1,21 @@
 module Cadenya
   module Models
     module ToolSets
-      ConfigMcp: Cadenya::Internal::Type::Converter
+      type config_mcp = { annotations: Cadenya::ToolSets::McpAnnotations }
+
+      class ConfigMcp < Cadenya::Internal::Type::BaseModel
+        attr_reader annotations: Cadenya::ToolSets::McpAnnotations?
+
+        def annotations=: (
+          Cadenya::ToolSets::McpAnnotations
+        ) -> Cadenya::ToolSets::McpAnnotations
+
+        def initialize: (
+          ?annotations: Cadenya::ToolSets::McpAnnotations
+        ) -> void
+
+        def to_hash: -> { annotations: Cadenya::ToolSets::McpAnnotations }
+      end
     end
   end
 end

data/sig/cadenya/models/tool_sets/mcp_annotations.rbs

@@ -0,0 +1,52 @@
+module Cadenya
+  module Models
+    module ToolSets
+      type mcp_annotations =
+        {
+          destructive_hint: bool,
+          idempotent_hint: bool,
+          open_world_hint: bool,
+          read_only_hint: bool,
+          title: String
+        }
+
+      class McpAnnotations < Cadenya::Internal::Type::BaseModel
+        attr_reader destructive_hint: bool?
+
+        def destructive_hint=: (bool) -> bool
+
+        attr_reader idempotent_hint: bool?
+
+        def idempotent_hint=: (bool) -> bool
+
+        attr_reader open_world_hint: bool?
+
+        def open_world_hint=: (bool) -> bool
+
+        attr_reader read_only_hint: bool?
+
+        def read_only_hint=: (bool) -> bool
+
+        attr_reader title: String?
+
+        def title=: (String) -> String
+
+        def initialize: (
+          ?destructive_hint: bool,
+          ?idempotent_hint: bool,
+          ?open_world_hint: bool,
+          ?read_only_hint: bool,
+          ?title: String
+        ) -> void
+
+        def to_hash: -> {
+          destructive_hint: bool,
+          idempotent_hint: bool,
+          open_world_hint: bool,
+          read_only_hint: bool,
+          title: String
+        }
+      end
+    end
+  end
+end

data/sig/cadenya/models/tool_sets/tool_spec_config.rbs

@@ -4,7 +4,7 @@ module Cadenya
       type tool_spec_config =
         {
           http: Cadenya::ToolSets::ConfigHTTP,
-          mcp: top,
+          mcp: Cadenya::ToolSets::ConfigMcp,
           openapi: Cadenya::ToolSets::ConfigOpenAPI
         }
 
@@ -15,9 +15,9 @@ module Cadenya
           Cadenya::ToolSets::ConfigHTTP
         ) -> Cadenya::ToolSets::ConfigHTTP
 
-        attr_reader mcp: top?
+        attr_reader mcp: Cadenya::ToolSets::ConfigMcp?
 
-        def mcp=: (top) -> top
+        def mcp=: (Cadenya::ToolSets::ConfigMcp) -> Cadenya::ToolSets::ConfigMcp
 
         attr_reader openapi: Cadenya::ToolSets::ConfigOpenAPI?
 
@@ -27,13 +27,13 @@ module Cadenya
 
         def initialize: (
           ?http: Cadenya::ToolSets::ConfigHTTP,
-          ?mcp: top,
+          ?mcp: Cadenya::ToolSets::ConfigMcp,
           ?openapi: Cadenya::ToolSets::ConfigOpenAPI
         ) -> void
 
         def to_hash: -> {
           http: Cadenya::ToolSets::ConfigHTTP,
-          mcp: top,
+          mcp: Cadenya::ToolSets::ConfigMcp,
           openapi: Cadenya::ToolSets::ConfigOpenAPI
         }
       end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cadenya
 version: !ruby/object:Gem::Version
-  version: 0.24.0
+  version: 0.25.0
 platform: ruby
 authors:
 - Cadenya
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-01 00:00:00.000000000 Z
+date: 2026-07-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -291,6 +291,7 @@ files:
 - lib/cadenya/models/tool_sets/config_http.rb
 - lib/cadenya/models/tool_sets/config_mcp.rb
 - lib/cadenya/models/tool_sets/config_openapi.rb
+- lib/cadenya/models/tool_sets/mcp_annotations.rb
 - lib/cadenya/models/tool_sets/secret_create_params.rb
 - lib/cadenya/models/tool_sets/secret_delete_params.rb
 - lib/cadenya/models/tool_sets/secret_list_params.rb
@@ -602,6 +603,7 @@ files:
 - rbi/cadenya/models/tool_sets/config_http.rbi
 - rbi/cadenya/models/tool_sets/config_mcp.rbi
 - rbi/cadenya/models/tool_sets/config_openapi.rbi
+- rbi/cadenya/models/tool_sets/mcp_annotations.rbi
 - rbi/cadenya/models/tool_sets/secret_create_params.rbi
 - rbi/cadenya/models/tool_sets/secret_delete_params.rbi
 - rbi/cadenya/models/tool_sets/secret_list_params.rbi
@@ -912,6 +914,7 @@ files:
 - sig/cadenya/models/tool_sets/config_http.rbs
 - sig/cadenya/models/tool_sets/config_mcp.rbs
 - sig/cadenya/models/tool_sets/config_openapi.rbs
+- sig/cadenya/models/tool_sets/mcp_annotations.rbs
 - sig/cadenya/models/tool_sets/secret_create_params.rbs
 - sig/cadenya/models/tool_sets/secret_delete_params.rbs
 - sig/cadenya/models/tool_sets/secret_list_params.rbs