[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

Comienza con el issue general #337 y SEP-2106, y después inspecciona src/Capability/Discovery/SchemaGenerator.php y SchemaValidator.php, junto con el atributo #[Schema] y las rutas de reflection/DocBlock mencionadas aquí. Mapea el flujo de esquema simple existente antes de evaluar cómo deberían exponerse y validarse la composición, las condicionales, las referencias y los tipos unión. Se considera terminado cuando el vocabulario de JSON Schema 2020-12 indicado sea compatible en estas rutas sin debilitar los valores predeterminados de $ref same-document.