[Schema] SEP-2106: Support JSON Schema 2020-12 vocabulary in SchemaGenerator (oneOf/anyOf/allOf/if-then-else/$ref)

Implements the vocabulary portion of SEP-2106 for the MCP Spec 2026-07-28 release.

Tracked by umbrella #337.

Spec summary

inputSchema keeps type: "object" required but accepts any JSON Schema 2020-12 vocabulary (oneOf/anyOf/allOf/not, if/then/else, $ref/$defs/$anchor).

PHP SDK changes

• src/Capability/Discovery/SchemaGenerator.php and SchemaValidator.php need to emit/validate full JSON Schema 2020-12 composition, conditionals, $ref (same-document only by default).
• #[Schema] attribute should accept composition keywords.
• Reflection/DocBlock paths today produce simple {type, properties} only — extend to surface union types as oneOf/anyOf.

Related

• Umbrella #337
• Companion sub-issues: non-object outputSchema, $ref hardening

Commencez par l’issue globale #337 et SEP-2106, puis examinez src/Capability/Discovery/SchemaGenerator.php et SchemaValidator.php ainsi que l’attribut #[Schema] et les chemins reflection/DocBlock mentionnés ici. Cartographiez le flux de schéma simple existant avant d’évaluer comment la composition, les conditionnels, les références et les types union devraient être exposés et validés. Le travail est terminé lorsque le vocabulaire JSON Schema 2020-12 indiqué est pris en charge sur ces chemins sans affaiblir les valeurs par défaut de $ref same-document.