Investigate Cloudflare Agents and determine whether they provide OTel support or internal hooks that we can leverage

[RulaKhaled]

[linear]

JS-1504

[RulaKhaled]

Here's the ideal span hierarchy:

Agent Invocation (root)
└─ Tool Execution (agent.tool)
     └─ HTTP to MCP server (http.client)
└─ AI Generation (gen_ai.chat)
    └─ HTTP to OpenAI/Anthropic (http.client)

The Key Question: What should be the "invoke" root span?

Option A: Wrap routeAgentRequest()

• ✅ Captures all requests that go through the router
• ❌ Users might bypass it and call agents directly
• Span name: routeAgentRequest

Option B: Wrap Agent DO fetch() (Current approach)

• ✅ Captures ALL agent invocations (regardless of routing)
• ✅ Works with instrumentDurableObjectWithSentry
• Span name: POST /message, POST /schedule, etc. (HTTP endpoint)

We will go with option B, default to option A if there are technical limitations