From 4c55f8244637a0ae9b734c9a028962a85ee2276f Mon Sep 17 00:00:00 2001
From: LeanAgent <leanagent@webmakers.local>
Date: Mon, 12 Oct 2026 16:12:01 +0000
Subject: [PATCH] =?UTF-8?q?feat(schema):=20meta.query=20in=20Collection-Me?=
 =?UTF-8?q?ta=20+=20designGuide-Einr=C3=BCckung?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Hooks lesen oft zusätzliche Query-Parameter (ctx.request().query(name)).
Mit meta.query werden sie deklariert, für Agenten dokumentiert
(REST _meta/OpenAPI, MCP collection_describe) und bei MCP-Calls
validiert. Vergleiche docs 04-collections (meta.query).
---
 schemas/config/collection-meta.schema.json | 37 +++++++++++++++++++++-
 1 file changed, 36 insertions(+), 1 deletion(-)

diff --git a/schemas/config/collection-meta.schema.json b/schemas/config/collection-meta.schema.json
index 770bbe6..4dac512 100644
--- a/schemas/config/collection-meta.schema.json
+++ b/schemas/config/collection-meta.schema.json
@@ -50,7 +50,7 @@
         ]
       }
     },
-"designGuide": {
+    "designGuide": {
       "$ref": "defs.schema.json#/definitions/i18nText"
     },
     "imageUrl": {
@@ -465,6 +465,41 @@
     "openapi": {
       "$ref": "openapi.schema.json"
     },
+    "query": {
+      "description": "Additional query parameters hooks may read (ctx.request().query(name)). Documented for agents (REST _meta/OpenAPI, MCP collection_describe + extra argument) and validated on MCP calls. Credential-like keys (permission token names, auth headers) and core query keys are never allowed.",
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "type": {
+            "type": "string",
+            "enum": [
+              "string",
+              "number",
+              "boolean"
+            ]
+          },
+          "enum": {
+            "type": "array",
+            "items": {
+              "type": [
+                "string",
+                "number",
+                "boolean"
+              ]
+            }
+          },
+          "maxLength": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "description": {
+            "$ref": "defs.schema.json#/definitions/i18nText"
+          }
+        }
+      }
+    },
     "agent": {
       "description": "Editor- und Agenten-Dokumentation (Zweck, Workflows, Gotchas). Freiform-Doku, wird u.a. ueber MCP/REST _meta ausgespielt.",
       "type": "object",