Function safe_serialize

agentops/helpers/serialization.py:109–137

Safely serialize an object to JSON-compatible format This function handles complex objects by: 1. Returning strings untouched (even if they contain JSON) 2. Converting models to dictionaries 3. Using custom JSON encoder to handle special types 4. Falling back to string represent

(obj: Any)

def safe_serialize(obj: Any) -> Any:
    """Safely serialize an object to JSON-compatible format

    This function handles complex objects by:
    1. Returning strings untouched (even if they contain JSON)
    2. Converting models to dictionaries
    3. Using custom JSON encoder to handle special types
    4. Falling back to string representation only when necessary

    Args:
        obj: The object to serialize

    Returns:
        If obj is a string, returns the original string untouched.
        Otherwise, returns a JSON string representation of the object.
    """
    # Return strings untouched
    if isinstance(obj, str):
        return obj

    # Convert any model objects to dictionaries
    if hasattr(obj, "model_dump") or hasattr(obj, "dict") or hasattr(obj, "parse"):
        obj = model_to_dict(obj)

    try:
        return json.dumps(obj, cls=AgentOpsJSONEncoder)
    except (TypeError, ValueError) as e:
        logger.warning(f"Failed to serialize object: {e}")
        return str(obj)