From 76f3ffca2088bc2fa9b75bb33ba3a33d4b089afd Mon Sep 17 00:00:00 2001
From: Renato Byrro <rmbyrro@gmail.com>
Date: Tue, 23 Jun 2026 13:48:26 -0300
Subject: [PATCH] feat(engine): document capability_gap client_names and
 model_names

Add the capability_gap config block to engine config schema 2.0, including
operator-facing client_names and model_names enum override lists.
---
 engine/config/2.0/schema.json | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/engine/config/2.0/schema.json b/engine/config/2.0/schema.json
index dcbe481..883d3b2 100644
--- a/engine/config/2.0/schema.json
+++ b/engine/config/2.0/schema.json
@@ -320,6 +320,39 @@
       "oneOf": [{ "required": ["in_memory"] }, { "required": ["redis"] }],
       "additionalProperties": false
     },
+    "capability_gap": {
+      "type": "object",
+      "description": "Configures the capability gap self-report built-in tool.",
+      "properties": {
+        "enabled": {
+          "description": "Whether the capability gap tool is injected into every gateway's tools/list.",
+          "oneOf": [
+            { "type": "boolean", "default": false },
+            { "$ref": "#/$defs/envVarPattern" },
+            { "$ref": "#/$defs/filePattern" }
+          ]
+        },
+        "instruction": {
+          "type": "string",
+          "description": "Instruction prepended to every gateway's MCP instructions while enabled."
+        },
+        "client_names": {
+          "type": "array",
+          "description": "Optional allowed values for the tool's client_name enum. When omitted, built-in defaults are used. \"other\" is always appended automatically if not already present.",
+          "items": {
+            "type": "string"
+          }
+        },
+        "model_names": {
+          "type": "array",
+          "description": "Optional allowed values for the tool's model_name enum. When omitted, built-in defaults are used. \"other\" is always appended automatically if not already present.",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": true
+    },
     "execution_logging": {
       "type": "object",
       "description": "Configures execution logging for tool calls.",