dynamic_modules: add bool metadata, metadata keys/namespaces, and bool attribute ABI (http) (#43537)

**Commit Message**: dynamic_modules: add bool metadata, metadata
keys/namespaces, and bool attribute ABI
**Additional Description**: Extends the dynamic modules ABI and SDK (Go
+ C++) with:
  - `GetMetadataBool` / `SetMetadataBool` — bool metadata getter/setter
  - `GetMetadataKeys` — Get all keys a metadata namespace
  - `GetMetadataNamespaces` — Get all metadata namespace names
  - `GetAttributeBool` — bool attribute getter (e.g. ConnectionMtls)

  **Risk Level**: Low
**Testing**: Added C++ unit tests for all new ABI functions + Go
integration test extensions. Manually tested with a Go dynamic module
against envoy build
  **Docs Changes**: N/A
  **Release Notes**: N/A
  Platform Specific Features: N/A
  [Optional Runtime guard:] N/A
  [Optional Fixes #Issue]: N/A
  [Optional Fixes commit #PR or SHA]: N/A
  [Optional Deprecated:]: N/A
[Optional [API
Considerations](https://github.com/envoyproxy/envoy/blob/main/api/review_checklist.md):]
N/A

---------

Signed-off-by: Anurag Aggarwal <kanurag94@gmail.com>

Author: kanurag94

source/extensions/dynamic_modules/abi/abi.h

@@ -1575,6 +1575,120 @@ bool envoy_dynamic_module_callback_http_get_metadata_string(
     envoy_dynamic_module_type_module_buffer ns, envoy_dynamic_module_type_module_buffer key,
     envoy_dynamic_module_type_envoy_buffer* result);
 
+/**
+ * envoy_dynamic_module_callback_http_set_dynamic_metadata_bool is called by the module to set
+ * the bool value of the dynamic metadata with the given namespace and key. If the metadata is
+ * existing, it will be overwritten.
+ *
+ * @param filter_envoy_ptr is the pointer to the DynamicModuleHttpFilter object of the
+ * corresponding HTTP filter.
+ * @param ns is the namespace of the dynamic metadata.
+ * @param key is the key of the dynamic metadata.
+ * @param value is the bool value of the dynamic metadata to be set.
+ */
+void envoy_dynamic_module_callback_http_set_dynamic_metadata_bool(
+    envoy_dynamic_module_type_http_filter_envoy_ptr filter_envoy_ptr,
+    envoy_dynamic_module_type_module_buffer ns, envoy_dynamic_module_type_module_buffer key,
+    bool value);
+
+/**
+ * envoy_dynamic_module_callback_http_get_metadata_bool is called by the module to get
+ * the bool value of the dynamic metadata with the given namespace and key. If the metadata is not
+ * accessible, the namespace does not exist, the key does not exist or the value is not a bool,
+ * this returns false.
+ *
+ * @param filter_envoy_ptr is the pointer to the DynamicModuleHttpFilter object of the
+ * corresponding HTTP filter.
+ * @param metadata_source is the source of the metadata.
+ * @param ns is the namespace of the dynamic metadata.
+ * @param key is the key of the dynamic metadata.
+ * @param result is the pointer to the variable where the bool value of the dynamic metadata will
+ * be stored.
+ * @return true if the operation is successful, false otherwise.
+ */
+bool envoy_dynamic_module_callback_http_get_metadata_bool(
+    envoy_dynamic_module_type_http_filter_envoy_ptr filter_envoy_ptr,
+    envoy_dynamic_module_type_metadata_source metadata_source,
+    envoy_dynamic_module_type_module_buffer ns, envoy_dynamic_module_type_module_buffer key,
+    bool* result);
+
+/**
+ * envoy_dynamic_module_callback_http_get_metadata_keys_count is called by the module to get the
+ * number of keys in the metadata namespace. If the metadata is not accessible or the namespace
+ * does not exist, this returns 0.
+ *
+ * @param filter_envoy_ptr is the pointer to the DynamicModuleHttpFilter object of the
+ * corresponding HTTP filter.
+ * @param metadata_source is the source of the metadata.
+ * @param ns is the namespace of the dynamic metadata.
+ * @return the number of keys in the metadata namespace.
+ */
+size_t envoy_dynamic_module_callback_http_get_metadata_keys_count(
+    envoy_dynamic_module_type_http_filter_envoy_ptr filter_envoy_ptr,
+    envoy_dynamic_module_type_metadata_source metadata_source,
+    envoy_dynamic_module_type_module_buffer ns);
+
+/**
+ * envoy_dynamic_module_callback_http_get_metadata_keys is called by the module to get all keys
+ * in the metadata namespace. The keys are returned as an array of
+ * envoy_dynamic_module_type_envoy_buffer.
+ *
+ * PRECONDITION: The module must ensure that the result_buffer_vector is valid and has enough length
+ * to store all the keys. The module can use
+ * envoy_dynamic_module_callback_http_get_metadata_keys_count to get the number of
+ * keys before calling this function.
+ *
+ * @param filter_envoy_ptr is the pointer to the DynamicModuleHttpFilter object of the
+ * corresponding HTTP filter.
+ * @param metadata_source is the source of the metadata.
+ * @param ns is the namespace of the dynamic metadata.
+ * @param result_buffer_vector is the pointer to the array of envoy_dynamic_module_type_envoy_buffer
+ * where the key strings will be stored. The lifetime of the buffer is guaranteed until the
+ * end of the current event hook unless the setter callback is called.
+ * @return true if the operation is successful, false otherwise.
+ */
+bool envoy_dynamic_module_callback_http_get_metadata_keys(
+    envoy_dynamic_module_type_http_filter_envoy_ptr filter_envoy_ptr,
+    envoy_dynamic_module_type_metadata_source metadata_source,
+    envoy_dynamic_module_type_module_buffer ns,
+    envoy_dynamic_module_type_envoy_buffer* result_buffer_vector);
+
+/**
+ * envoy_dynamic_module_callback_http_get_metadata_namespaces_count is called by the module to get
+ * the number of namespaces in the metadata. If the metadata is not accessible, this returns 0.
+ *
+ * @param filter_envoy_ptr is the pointer to the DynamicModuleHttpFilter object of the
+ * corresponding HTTP filter.
+ * @param metadata_source is the source of the metadata.
+ * @return the number of namespaces in the metadata.
+ */
+size_t envoy_dynamic_module_callback_http_get_metadata_namespaces_count(
+    envoy_dynamic_module_type_http_filter_envoy_ptr filter_envoy_ptr,
+    envoy_dynamic_module_type_metadata_source metadata_source);
+
+/**
+ * envoy_dynamic_module_callback_http_get_metadata_namespaces is called by the module to get all
+ * namespace names in the metadata. The namespaces are returned as an array of
+ * envoy_dynamic_module_type_envoy_buffer.
+ *
+ * PRECONDITION: The module must ensure that the result_buffer_vector is valid and has enough length
+ * to store all the namespaces. The module can use
+ * envoy_dynamic_module_callback_http_get_metadata_namespaces_count to get the number of
+ * namespaces before calling this function.
+ *
+ * @param filter_envoy_ptr is the pointer to the DynamicModuleHttpFilter object of the
+ * corresponding HTTP filter.
+ * @param metadata_source is the source of the metadata.
+ * @param result_buffer_vector is the pointer to the array of envoy_dynamic_module_type_envoy_buffer
+ * where the namespace strings will be stored. The lifetime of the buffer is guaranteed until the
+ * end of the current event hook unless the setter callback is called.
+ * @return true if the operation is successful, false otherwise.
+ */
+bool envoy_dynamic_module_callback_http_get_metadata_namespaces(
+    envoy_dynamic_module_type_http_filter_envoy_ptr filter_envoy_ptr,
+    envoy_dynamic_module_type_metadata_source metadata_source,
+    envoy_dynamic_module_type_envoy_buffer* result_buffer_vector);
+
 // -------------------------- Filter State Callbacks ---------------------------
 
 /**
@@ -1773,6 +1887,24 @@ bool envoy_dynamic_module_callback_http_filter_get_attribute_int(
     envoy_dynamic_module_type_http_filter_envoy_ptr filter_envoy_ptr,
     envoy_dynamic_module_type_attribute_id attribute_id, uint64_t* result);
 
+/**
+ * envoy_dynamic_module_callback_http_filter_get_attribute_bool is called by the module to get
+ * a boolean attribute value. If the attribute is not accessible or the
+ * value is not a boolean, this returns false.
+ *
+ * @param filter_envoy_ptr is the pointer to the DynamicModuleHttpFilter object of the
+ * corresponding HTTP filter.
+ * @param attribute_id is the ID of the attribute.
+ * @param result is the pointer to the variable where the bool value of the attribute will be
+ * stored.
+ * @return true if the operation is successful, false otherwise.
+ *
+ * Note: currently, not all attributes are implemented.
+ */
+bool envoy_dynamic_module_callback_http_filter_get_attribute_bool(
+    envoy_dynamic_module_type_http_filter_envoy_ptr filter_envoy_ptr,
+    envoy_dynamic_module_type_attribute_id attribute_id, bool* result);
+
 /**
  * envoy_dynamic_module_callback_http_filter_http_callout is called by the module to initiate
  * an HTTP callout. The callout is initiated by the HTTP filter and the response is received in

source/extensions/dynamic_modules/sdk/cpp/sdk.h

@@ -3,6 +3,8 @@
 #include <cassert>
 #include <cstddef>
 #include <memory>
+#include <string>
+#include <vector>
 
 #include "absl/container/flat_hash_map.h"
 #include "absl/types/optional.h"
@@ -378,6 +380,27 @@ class HttpFilterHandle {
    */
   virtual absl::optional<double> getMetadataNumber(absl::string_view ns, absl::string_view key) = 0;
 
+  /**
+   * Retrieves a bool metadata value by namespace and key.
+   * @param ns The metadata namespace.
+   * @param key The metadata key.
+   * @return The bool value if found, otherwise nullopt.
+   */
+  virtual absl::optional<bool> getMetadataBool(absl::string_view ns, absl::string_view key) = 0;
+
+  /**
+   * Retrieves all keys in a metadata namespace.
+   * @param ns The metadata namespace.
+   * @return Vector of key strings.
+   */
+  virtual std::vector<absl::string_view> getMetadataKeys(absl::string_view ns) = 0;
+
+  /**
+   * Retrieves all namespace names in the metadata.
+   * @return Vector of namespace name strings.
+   */
+  virtual std::vector<absl::string_view> getMetadataNamespaces() = 0;
+
   /**
    * Sets a string metadata value.
    * @param ns The metadata namespace.
@@ -395,6 +418,19 @@ class HttpFilterHandle {
    */
   virtual void setMetadata(absl::string_view ns, absl::string_view key, double value) = 0;
 
+  /**
+   * Sets a bool metadata value.
+   * @param ns The metadata namespace.
+   * @param key The metadata key.
+   * @param value The bool value to set.
+   */
+  virtual void setMetadata(absl::string_view ns, absl::string_view key, bool value) = 0;
+
+  // Prevent const char* from implicitly converting to bool instead of string_view.
+  void setMetadata(absl::string_view ns, absl::string_view key, const char* value) {
+    setMetadata(ns, key, absl::string_view(value));
+  }
+
   /**
    * Retrieves the serialized filter state value of the stream.
    * @param key The filter state key.
@@ -423,6 +459,13 @@ class HttpFilterHandle {
    */
   virtual absl::optional<uint64_t> getAttributeNumber(AttributeID id) = 0;
 
+  /**
+   * Retrieves a boolean attribute value.
+   * @param id The attribute ID.
+   * @return The bool value if found, otherwise nullopt.
+   */
+  virtual absl::optional<bool> getAttributeBool(AttributeID id) = 0;
+
   /**
    * Sends a local response with status code, body, and detail.
    * @param status The HTTP status code.

source/extensions/dynamic_modules/sdk/cpp/sdk_internal.cc

@@ -225,6 +225,61 @@ class HttpFilterHandleImpl : public HttpFilterHandle {
     return value;
   }
 
+  absl::optional<bool> getMetadataBool(absl::string_view ns, absl::string_view key) override {
+    bool value = false;
+    const bool ret = envoy_dynamic_module_callback_http_get_metadata_bool(
+        host_plugin_ptr_, envoy_dynamic_module_type_metadata_source_Dynamic,
+        envoy_dynamic_module_type_module_buffer{ns.data(), ns.size()},
+        envoy_dynamic_module_type_module_buffer{key.data(), key.size()}, &value);
+
+    if (!ret) {
+      return {};
+    }
+    return value;
+  }
+
+  std::vector<absl::string_view> getMetadataKeys(absl::string_view ns) override {
+    size_t count = envoy_dynamic_module_callback_http_get_metadata_keys_count(
+        host_plugin_ptr_, envoy_dynamic_module_type_metadata_source_Dynamic,
+        envoy_dynamic_module_type_module_buffer{ns.data(), ns.size()});
+    if (count == 0) {
+      return {};
+    }
+    std::vector<envoy_dynamic_module_type_envoy_buffer> buffers(count);
+    const bool ret = envoy_dynamic_module_callback_http_get_metadata_keys(
+        host_plugin_ptr_, envoy_dynamic_module_type_metadata_source_Dynamic,
+        envoy_dynamic_module_type_module_buffer{ns.data(), ns.size()}, buffers.data());
+    if (!ret) {
+      return {};
+    }
+    std::vector<absl::string_view> keys;
+    keys.reserve(count);
+    for (size_t i = 0; i < count; i++) {
+      keys.emplace_back(buffers[i].ptr, buffers[i].length);
+    }
+    return keys;
+  }
+
+  std::vector<absl::string_view> getMetadataNamespaces() override {
+    size_t count = envoy_dynamic_module_callback_http_get_metadata_namespaces_count(
+        host_plugin_ptr_, envoy_dynamic_module_type_metadata_source_Dynamic);
+    if (count == 0) {
+      return {};
+    }
+    std::vector<envoy_dynamic_module_type_envoy_buffer> buffers(count);
+    const bool ret = envoy_dynamic_module_callback_http_get_metadata_namespaces(
+        host_plugin_ptr_, envoy_dynamic_module_type_metadata_source_Dynamic, buffers.data());
+    if (!ret) {
+      return {};
+    }
+    std::vector<absl::string_view> namespaces;
+    namespaces.reserve(count);
+    for (size_t i = 0; i < count; i++) {
+      namespaces.emplace_back(buffers[i].ptr, buffers[i].length);
+    }
+    return namespaces;
+  }
+
   void setMetadata(absl::string_view ns, absl::string_view key, absl::string_view value) override {
     envoy_dynamic_module_callback_http_set_dynamic_metadata_string(
         host_plugin_ptr_, envoy_dynamic_module_type_module_buffer{ns.data(), ns.size()},
@@ -238,6 +293,12 @@ class HttpFilterHandleImpl : public HttpFilterHandle {
         envoy_dynamic_module_type_module_buffer{key.data(), key.size()}, value);
   }
 
+  void setMetadata(absl::string_view ns, absl::string_view key, bool value) override {
+    envoy_dynamic_module_callback_http_set_dynamic_metadata_bool(
+        host_plugin_ptr_, envoy_dynamic_module_type_module_buffer{ns.data(), ns.size()},
+        envoy_dynamic_module_type_module_buffer{key.data(), key.size()}, value);
+  }
+
   absl::optional<absl::string_view> getFilterState(absl::string_view key) override {
     BufferView value{nullptr, 0};
 
@@ -281,6 +342,17 @@ class HttpFilterHandleImpl : public HttpFilterHandle {
     return value;
   }
 
+  absl::optional<bool> getAttributeBool(AttributeID id) override {
+    bool value = false;
+    const bool ret = envoy_dynamic_module_callback_http_filter_get_attribute_bool(
+        host_plugin_ptr_, static_cast<envoy_dynamic_module_type_attribute_id>(id), &value);
+
+    if (!ret) {
+      return {};
+    }
+    return value;
+  }
+
   void sendLocalResponse(uint32_t status, absl::Span<const HeaderView> headers,
                          absl::string_view body, absl::string_view detail) override {
     envoy_dynamic_module_callback_http_send_response(