refactor(inference): rename transport format terminology to direct_json - #2130
Merged
Conversation
Rename the "Transport" terminology for the A2UI JSON inference format to "Direct JSON" / "direct_json" (`DirectJsonFormat`, `DirectJsonParser`, `DirectJsonStreamParser`). - Move `a2ui.inference_formats.transport` -> `a2ui.inference_formats.direct_json` - Add backward-compatibility alias module at `a2ui.inference_formats.transport` with deprecation warning - Update SDK references, test suites, evaluation scripts, and sample apps - Update documentation and changelog
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
This comment was marked as resolved.
This comment was marked as resolved.
Sorry, something went wrong.
gspencergoog
force-pushed
the
direct_json
branch
from
July 30, 2026 17:36
b13c82f to
7f00c4d
Compare
- Import DirectJsonParser and DirectJsonFormat from direct_json package root - Remove inline import of DirectJsonParser in tests - Raise A2uiCatalogError instead of ValueError when no supported catalogs configured - Add test verifying A2uiCatalogError for missing supported catalogs
gspencergoog
force-pushed
the
direct_json
branch
from
July 30, 2026 17:44
511caeb to
db8428d
Compare
This comment was marked as resolved.
This comment was marked as resolved.
Sorry, something went wrong.
nan-yu
reviewed
Jul 30, 2026
- Add deprecated submodule stub files (transport/format.py, transport/parser.py, transport/streaming.py, transport/prompt_generator.py) to prevent import errors for legacy code - Replace silent aliases for TransportFormat, TransportParser, TransportStreamParser, A2uiStreamParser, and TransportPromptGenerator with subclasses that emit a DeprecationWarning - Update direct strategy name references in eval package from 'json' to 'direct_json' - Add test_transport_deprecation.py verifying runtime deprecation warnings
…reaming parser - Remove transport compatibility stub directory (inference_formats/transport/) - Remove Transport* and A2uiStreamParser deprecation subclasses and aliases - Remove legacy a2ui.parser.streaming module - Remove test_transport_deprecation.py
gspencergoog
force-pushed
the
direct_json
branch
from
July 30, 2026 18:06
6440f89 to
0c7299a
Compare
This comment was marked as resolved.
This comment was marked as resolved.
Sorry, something went wrong.
gspencergoog
commented
Jul 30, 2026
|
|
||
| class A2uiSchemaManager(TransportFormat): | ||
| """Deprecated compatibility wrapper around TransportFormat.""" | ||
| class A2uiSchemaManager(DirectJsonFormat): |
Collaborator
Author
There was a problem hiding this comment.
I'm wondering if we can nuke this too...
Collaborator
There was a problem hiding this comment.
This is still used by internal customers. Let's keep it for now.
nan-yu
approved these changes
Jul 30, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Renames the A2UI inference format terminology from
Transport(TransportFormat,TransportParser,TransportStreamParser) toDirect JSON(DirectJsonFormat,DirectJsonParser,DirectJsonStreamParser) across the codebase.Changes
TransportFormat->DirectJsonFormatTransportParser->DirectJsonParserTransportStreamParser->DirectJsonStreamParserTransportPromptGenerator->DirectJsonPromptGeneratora2ui.inference_formats.transporttoa2ui.inference_formats.direct_json.a2ui.parser.streamingmodule.eval/strategy resolvers, dataset loaders, task definitions, and baseline paths (eval/baselines/direct_json/).agent_development.md, blueprints) and added a CHANGELOG entry ina2ui_agent.Impact & Risks
a2ui.inference_formats.transportmodule toa2ui.inference_formats.direct_jsonand removes the legacya2ui.parser.streamingmodule. Python SDK consumers must update imports toa2ui.inference_formats.direct_json.Testing
eval/strategy tests and dataset loaders.