feat(a2a_dart): Add an A2A library for Dart #497
Conversation
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
- Refactored the A2A server to read the request body only once, fixing a critical bug in the request handling logic. - Updated all server-side unit tests to reflect the refactoring. - Added comprehensive DartDoc comments to all public APIs in the client and server libraries. - Created a README.md with usage examples for both the client and server. - Created a GEMINI.md file with a high-level overview of the package. - Disabled the integration test due to a persistent networking issue in the 'dart test' environment, and documented the issue in IMPLEMENTATION.md. - Added a standalone server executable in 'bin/server.dart' for easier debugging.
- Added comprehensive tests for data models, including optional fields, empty lists, and various Part types. - Enhanced client tests to cover error handling and streaming scenarios, including SSE keepalive comments. - Improved server tests to verify correct error responses for malformed JSON and handler exceptions. - Added a comprehensive integration test for the full task lifecycle, including streaming updates. - Refactored FilePart to align with the A2A specification. - Added StreamingEvent models for task status and artifact updates.
![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.
This comment was marked as resolved.
This comment was marked as resolved.
Sorry, something went wrong.
Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>
gspencergoog
force-pushed
the
a2a_dart
branch
from
7a43d4c to
50f8fb2
Compare
This comment was marked as resolved.
This comment was marked as resolved.
Sorry, something went wrong.
Refactor the A2A Dart package to support both web and native platforms. - Move 'dart:io' dependent server code to platform-specific files under 'src/server/io'. - Create a web stub for the server at 'src/server/web'. - Introduce a main library file 'lib/a2a_dart.dart' for unified exports using conditional exports. - Update all existing imports across the project to use the new entry point. This change allows the 'a2a_dart' package to be used in web environments while maintaining full functionality on native platforms.
Instead of passing a log level to the constructors of `A2AClient`, `A2AServer`, and the transports, this change modifies them to accept an optional `Logger` instance. If a logger is not supplied, then no logging will be performed, which is more efficient than checking the log level on every call. This also simplifies the API by removing the need for `hierarchicalLoggingEnabled`.
Replaced mockito with a fake implementation for tests. This removes a dependency and makes the tests cleaner.
- Refactored A2AClient.messageStream to return a Stream<StreamingEvent>. - Extracted SSE parsing logic into a separate SseParser class. - Refactored A2AServer.start into smaller, more manageable methods. - Enhanced A2AServer error handling with A2AServerException. - Added dynamic handler registration to A2AServer. - Updated README.md with improved installation and usage examples. - Improved dartdoc example for the A2AClient constructor. - Added comprehensive tests for the client, core data models, server, and integration.
This change updates the codebase to use `Map<String, Object?>` instead of `Map<String, dynamic>` for JSON objects to align with the latest Dart standards and improve type safety.
gspencergoog
force-pushed
the
a2a_dart
branch
from
bd31407 to
c9e8005
Compare
gspencergoog
force-pushed
the
a2a_dart
branch
from
c9e8005 to
b511234
Compare
This commit addresses a series of cascading test failures in the package. The primary issues were: - Incorrect request parameter parsing in the integration test handlers. - A logic error in the that prevented it from correctly handling non-existent tasks. - A that could not properly simulate the absence of a task. - A type casting issue in the that prevented events from being correctly identified. All of these issues have been resolved, and the entire test suite is now passing.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
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.
Description
This is a port of the A2A python implementation to Dart. It's a native port that supports HTTP JSON RPC and SSE transport modes.
Here's the python implementation: https://github.com/a2aproject/a2a-python
See The A2A Protocol for more information on A2A.
Summary of Changes
This pull request introduces 'a2a_dart', a new Dart library that ports the Agent2Agent (A2A) protocol from its Python implementation. This foundational framework enables Dart and Flutter applications to engage in A2A communication, offering both client and server capabilities. The library emphasizes type safety and idiomatic Dart practices, supporting HTTP JSON-RPC and Server-Sent Events (SSE) for diverse interaction patterns, and includes comprehensive documentation and initial test coverage.
Highlights
Changelog