[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

Inizia con l’issue ombrello #337 e SEP-2106, quindi esamina src/Capability/Discovery/SchemaGenerator.php e SchemaValidator.php insieme all’attributo #[Schema] e ai percorsi reflection/DocBlock menzionati qui. Mappa il flusso dello schema semplice esistente prima di valutare come dovrebbero essere esposti e convalidati composizione, condizionali, riferimenti e tipi unione. Il lavoro è completato quando il vocabolario JSON Schema 2020-12 elencato è supportato attraverso questi percorsi senza indebolire i valori predefiniti di $ref same-document.