Move standalone utility functions to top of file

Author: holtskinner

.github/actions/spelling/allow.txt

@@ -1,36 +1,23 @@
-ACMRTUXB
 ACard
 AClient
+ACMRTUXB
+aconnect
+adk
 AError
 AFast
+agentic
 AGrpc
+aio
+aiomysql
+amannn
+aproject
 ARequest
 ARun
 AServer
 AServers
 AService
 AStarlette
 AUser
-DSNs
-EUR
-GBP
-GVsb
-INR
-JPY
-JSONRPCt
-JWS
-Llm
-POSTGRES
-RUF
-SLF
-Tful
-aconnect
-adk
-agentic
-aio
-aiomysql
-amannn
-aproject
 autouse
 backticks
 cla
@@ -40,23 +27,32 @@ codegen
 coro
 datamodel
 drivername
+DSNs
 dunders
 euo
+EUR
 excinfo
 fernet
 fetchrow
 fetchval
+GBP
 genai
 getkwargs
 gle
+GVsb
 ietf
 initdb
 inmemory
+INR
 isready
+JPY
+JSONRPCt
+JWS
 kwarg
 langgraph
 lifecycles
 linting
+Llm
 lstrips
 mikeas
 mockurl
@@ -66,6 +62,7 @@ oidc
 opensource
 otherurl
 postgres
+POSTGRES
 postgresql
 protoc
 pyi
@@ -75,10 +72,13 @@ pyversions
 redef
 respx
 resub
+RUF
+SLF
 socio
 sse
 tagwords
 taskupdate
 testuuid
+Tful
 typeerror
 vulnz

src/a2a/utils/proto_utils.py

@@ -46,6 +46,88 @@ def dict_to_struct(dictionary: dict[str, Any]) -> struct_pb2.Struct:
     return struct
 
 
+def 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.
+
+    Args:
+        value: The value to convert.
+
+    Returns:
+        A serializable value.
+    """
+    if isinstance(value, dict):
+        return {k: make_dict_serializable(v) for k, v in value.items()}
+    if isinstance(value, list | tuple):
+        return [make_dict_serializable(item) for item in value]
+    if isinstance(value, str | int | float | bool) or value is None:
+        return value
+    return str(value)
+
+
+def 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.
+
+    Args:
+        value: The value to convert.
+        max_safe_digits: Maximum safe integer digits (default: 15).
+
+    Returns:
+        A normalized value.
+    """
+    if isinstance(value, dict):
+        return {
+            k: normalize_large_integers_to_strings(v, max_safe_digits)
+            for k, v in value.items()
+        }
+    if isinstance(value, list | tuple):
+        return [
+            normalize_large_integers_to_strings(item, max_safe_digits)
+            for item in value
+        ]
+    if isinstance(value, int) and abs(value) > (10**max_safe_digits - 1):
+        return str(value)
+    return value
+
+
+def parse_string_integers_in_dict(value: Any, max_safe_digits: int = 15) -> Any:
+    """String post-processing utility: converts large integer strings back to integers.
+
+    Use this when you want to restore large integer strings to integers
+    after Struct->dict conversion.
+
+    Args:
+        value: The value to convert.
+        max_safe_digits: Maximum safe integer digits (default: 15).
+
+    Returns:
+        A parsed value.
+    """
+    if isinstance(value, dict):
+        return {
+            k: parse_string_integers_in_dict(v, max_safe_digits)
+            for k, v in value.items()
+        }
+    if isinstance(value, list | tuple):
+        return [
+            parse_string_integers_in_dict(item, max_safe_digits)
+            for item in value
+        ]
+    if (
+        isinstance(value, str)
+        and value.lstrip('-').isdigit()
+        and len(value.lstrip('-')) > max_safe_digits
+    ):
+        return int(value)
+    return value
+
+
 class ToProto:
     """Converts Python types to proto types."""
 
@@ -980,107 +1062,3 @@ def role(cls, role: a2a_pb2.Role) -> types.Role:
                 return types.Role.agent
             case _:
                 return types.Role.agent
-
-
-def dict_to_struct(dictionary: dict[str, Any]) -> struct_pb2.Struct:
-    """Converts a Python dict to a Struct proto.
-
-    Unfortunately, using `json_format.ParseDict` does not work because this
-    wants the dictionary to be an exact match of the Struct proto with fields
-    and keys and values, not the traditional Python dict structure.
-
-    Args:
-      dictionary: The Python dict to convert.
-
-    Returns:
-      The Struct proto.
-    """
-    struct = struct_pb2.Struct()
-    for key, val in dictionary.items():
-        if isinstance(val, dict):
-            struct[key] = dict_to_struct(val)
-        else:
-            struct[key] = val
-    return struct
-
-
-def make_dict_serializable(value: Any) -> Any:
-    """Dict preprocessing utility: converts non-serializable values to serializable form.
-
-    Use this when you want to normalize a dictionary before dict->Struct conversion.
-
-    Args:
-        value: The value to convert.
-
-    Returns:
-        A serializable value.
-    """
-    if isinstance(value, dict):
-        return {k: make_dict_serializable(v) for k, v in value.items()}
-    if isinstance(value, list | tuple):
-        return [make_dict_serializable(item) for item in value]
-    if isinstance(value, str | int | float | bool) or value is None:
-        return value
-    return str(value)
-
-
-def 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.
-
-    Args:
-        value: The value to convert.
-        max_safe_digits: Maximum safe integer digits (default: 15).
-
-    Returns:
-        A normalized value.
-    """
-    if isinstance(value, dict):
-        return {
-            k: normalize_large_integers_to_strings(v, max_safe_digits)
-            for k, v in value.items()
-        }
-    if isinstance(value, list | tuple):
-        return [
-            normalize_large_integers_to_strings(item, max_safe_digits)
-            for item in value
-        ]
-    if isinstance(value, int) and abs(value) > (10**max_safe_digits - 1):
-        return str(value)
-    return value
-
-
-def parse_string_integers_in_dict(value: Any, max_safe_digits: int = 15) -> Any:
-    """String post-processing utility: converts large integer strings back to integers.
-
-    Use this when you want to restore large integer strings to integers
-    after Struct->dict conversion.
-
-    Args:
-        value: The value to convert.
-        max_safe_digits: Maximum safe integer digits (default: 15).
-
-    Returns:
-        A parsed value.
-    """
-    if isinstance(value, dict):
-        return {
-            k: parse_string_integers_in_dict(v, max_safe_digits)
-            for k, v in value.items()
-        }
-    if isinstance(value, list | tuple):
-        return [
-            parse_string_integers_in_dict(item, max_safe_digits)
-            for item in value
-        ]
-    if (
-        isinstance(value, str)
-        and value.lstrip('-').isdigit()
-        and len(value.lstrip('-')) > max_safe_digits
-    ):
-        return int(value)
-    return value