[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

包括的な issue #337 と SEP-2106 から始め、次に src/Capability/Discovery/SchemaGenerator.php と SchemaValidator.php、およびここで言及されている #[Schema] 属性と reflection/DocBlock パスを調査します。構成、条件分岐、参照、ユニオン型をどのように表面化して検証すべきかを評価する前に、既存の単純なスキーマフローを把握してください。完了条件は、same-document $ref のデフォルトを弱めることなく、列挙された JSON Schema 2020-12 語彙がこれらのパス全体でサポートされることです。