Description

Fixes traces when non-serializable data (like bytes from images, videos, audio, etc.) are present.

Before fixes (output incorrectly shows <replaced>): https://us.cloud.langfuse.com/project/cmaoqkqd901afad07ui6ndt1v/traces/36829363ba6e9f5177322c5edaf3b0fc?timestamp=2025-05-17T17:03:02.274Z&display=details

After fixes (only the image_reader tool output bytes show <replaced>, which is correct): https://us.cloud.langfuse.com/project/cmaoqkqd901afad07ui6ndt1v/traces/0ee3d42598ab472721c884a23caf36fa?timestamp=2025-05-17T21%3A17%3A17.318Z&display=details

Type of Change

• Bug fix

Testing

• hatch fmt --linter
• hatch fmt --formatter
• hatch test --all
• hatch run test-integ
• Verify that the changes do not break functionality or introduce warnings in consuming repositories: agents-docs, agents-tools, agents-cli
• Ran manually with this script:

#!/usr/bin/env python

import logging
import os
from strands import Agent, tool
from strands_tools import calculator, http_request, image_reader

logging.getLogger("strands.telemetry.tracer").setLevel(logging.DEBUG)
logging.basicConfig(
    format="%(levelname)s | %(name)s | %(message)s",
    handlers=[logging.StreamHandler()]
)

os.environ["OTEL_EXPORTER_OTLP_ENDPOINT"] = "https://us.cloud.langfuse.com/api/public/otel"
os.environ["OTEL_EXPORTER_OTLP_HEADERS"] = "Authorization=Basic REDACTED"

agent = Agent(
    system_prompt="You are a helpful assistant that provides concise responses.",
    tools=[http_request, calculator, image_reader],
    trace_attributes={
        "session.id": "abc-1234",
        "user.id": "[email protected]",
        "langfuse.tags": [
            "Agent-SDK",
            "Okatank-Project",
            "Observability-Tags",
        ]
    },
)

agent("Describe the image at /Users/arron/agents-samples/01-getting-started/00-first-agent/images/architecture.png")

Checklist

• I have read the CONTRIBUTING document
• I have added tests that prove my fix is effective or my feature works
• I have updated the documentation accordingly
• I have added an appropriate example to the documentation to outline the feature
• My changes generate no new warnings
• Any dependent changes have been merged and published

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.