fix: update stale catalogId references broken by #1452 spec restructure

[valentinbeggi]

Summary

PR #1452 moved the basic catalog schema from:

• specification/v{ver}/json/basic_catalog.json

to:

• specification/v{ver}/catalogs/basic/catalog.json

The lit renderer's basicCatalog was correctly updated to the new canonical $id (https://a2ui.org/specification/v{ver}/catalogs/basic/catalog.json), but all downstream consumers were missed, causing a runtime crash:

A2uiStateError: Catalog not found: https://a2ui.org/specification/v0_9/basic_catalog.json

This happens because the agent samples include examples with the old catalogId in the LLM system prompt, so the model generates createSurface messages with the outdated ID — which no longer matches the registered catalog on the client.

Files updated

• samples/agent/adk/restaurant_finder/examples/0.9/*.json — LLM prompt examples
• samples/agent/adk/custom-components-example/examples/0.9/*.json
• samples/agent/adk/rizzcharts/examples/standard_catalog/0.9/*.json + prompt_builder.py
• samples/client/lit/shell/public/samples/*.json — local file loading samples
• samples/client/react/shell/src/mock/restaurantMessages.ts
• samples/mcp/a2ui-over-mcp-recipe/recipe_a2ui.json
• samples/agent/adk/migrate_v08_to_v09.py
• specification/v0_9/eval/src/generation_flow.ts + validator.ts
• specification/v0_10/eval/src/generation_flow.ts + validator.ts
• specification/v0_9/test/cases/*.json + run_tests.py (fixed path to removed basic_catalog.json)
• specification/v0_10/test/cases/*.json + run_tests.py
• agent_sdks/python/tests/schema/test_validator.py
• agent_sdks/python/tests/integration/verify_load_real.py

Test plan

• Run the restaurant finder sample server and verify no Catalog not found error on first message
• Load contact_card.json / workspace_settings.json via the local file upload in the lit shell — should render without error
• Run specification/v0_9/test/run_tests.py — all tests pass
• Run specification/v0_10/test/run_tests.py — all tests pass

[google-cla]

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

[valentinbeggi]

@gspencergoog hey, could you take a look? This fixes stale catalogId references that were broken by #1452 — the spec path changed but the sample examples, eval prompts, and test fixtures weren't updated alongside the renderer.

[gemini-code-assist]

Code Review

This pull request updates catalogId and schema URLs across various files, including Python SDK tests, sample JSON configurations, and specification evaluation tools, to align with a revised directory structure. Additionally, the test runners in the specification directories were updated to simplify catalog aliasing and reflect the new file paths. Feedback from the review highlights a domain inconsistency in a test validator fixture and suggests enhancing error messages in the test suite by including full file paths to improve debuggability.

[ditman]

@valentinbeggi do you mind rebasing the branch? This looks reasonable and I can take a look!

[valentinbeggi]

This has been addressed by #1463 which was merged in the meantime. Closing.

[ditman]

This has been addressed by #1463 which was merged in the meantime. Closing.

Thanks for your contrib @valentinbeggi! Keep them coming!