a2a.utils.proto_utils module¶

Utilities for working with proto types.

This module provides helper functions for common proto type operations.

class a2a.utils.proto_utils.ValidationDetail¶

Bases: TypedDict

Structured validation error detail.

field: str¶

message: str¶

a2a.utils.proto_utils.bad_request_to_validation_errors(bad_request: BadRequest) → list[ValidationDetail]¶: Convert a gRPC BadRequest proto to validation error details.

a2a.utils.proto_utils.make_dict_serializable(value: Any) → Any¶

Dict pre-processing utility: converts non-serializable values to serializable form.

Use this when you want to normalize a dictionary before dict->Struct conversion.

Parameters:: value – The value to convert.
Returns:: A serializable value.

a2a.utils.proto_utils.normalize_large_integers_to_strings(value: Any, max_safe_digits: int = 15) → Any¶

Integer preprocessing utility: converts large integers to strings.

Use this when you want to convert large integers to strings considering JavaScript’s MAX_SAFE_INTEGER (2^53 - 1) limitation.

Parameters:

value – The value to convert.
max_safe_digits – Maximum safe integer digits (default: 15).

Returns:

A normalized value.

a2a.utils.proto_utils.parse_params(params: QueryParams, message: Message) → None¶

Converts REST query parameters back into a Protobuf message.

Handles A2A-specific pre-processing before calling ParseDict: - Booleans: ‘true’/’false’ -> True/False - Repeated: Supports BOTH repeated keys and comma-separated values. - Others: Handles string->enum/timestamp/number conversion via ParseDict.