Skip to content

[bot] Strands Agents TypeScript SDK (@strands-agents/sdk) not instrumented — no tracing for agent invocation, tool execution, or model calls #2115

@braintrust-bot

Description

@braintrust-bot

Summary

AWS's Strands Agents SDK has an official TypeScript package (@strands-agents/sdk, v1.0.0-rc.5, released April 30, 2026) for building production AI agents with tool use and multi-agent orchestration. Braintrust documents a Strands Agent SDK integration, but the docs page covers Python only — there are no TypeScript/JavaScript setup instructions and this JavaScript SDK repository has zero Strands instrumentation. Users who run agents with @strands-agents/sdk in Node.js get no Braintrust spans.

What instrumentation is missing

The @strands-agents/sdk package exposes these execution surfaces, none of which are instrumented:

SDK Method Description
agent.invoke(message) Execute an agent (agentic loop: model reasons → tools called → results fed back → repeat)
agent.stream(prompt) Async-iterator streaming variant of agent execution
Tool callbacks (via tool()) Per-tool execution during the agent loop
Model provider calls (via BedrockModel) Underlying model invocations inside each loop iteration

Users instantiate and run agents as:

import { Agent, tool } from "@strands-agents/sdk";
import { z } from "zod";

const myTool = tool({
  name: "weather",
  description: "Get current weather",
  input: z.object({ location: z.string() }),
  callback: async ({ location }) => `Sunny in ${location}`,
});

const agent = new Agent({ tools: [myTool] });
const result = await agent.invoke("What's the weather in Seattle?");

No coverage in any instrumentation layer:

  • No auto-instrumentation config in js/src/auto-instrumentations/configs/
  • No wrapper function (e.g. wrapStrandsAgent())
  • No channels or plugin in js/src/instrumentation/plugins/
  • No e2e test scenarios for Strands
  • Grep for strands (case-insensitive) across js/src/ — zero matches

Analogous instrumented frameworks in this repo: OpenAI Agents (openai-agents), Google ADK (google-adk), Claude Agent SDK (claude-agent-sdk), Mastra, OpenRouter Agent — all of which are agent-execution frameworks similar in scope to Strands.

Braintrust docs status

supported for Python — unclear for TypeScript. The Braintrust integrations page at https://www.braintrust.dev/docs/integrations lists "Strands Agent SDK" under Agent Frameworks and links to https://www.braintrust.dev/docs/integrations/agent-frameworks/strands-agent, but that page documents Python-only setup (auto-instrumentation via braintrust.auto_instrument() or setup_strands()). No JavaScript or TypeScript instructions exist.

Upstream references

Local files inspected

  • js/src/auto-instrumentations/configs/all.ts — full list of instrumented integrations; no Strands entry
  • js/src/auto-instrumentations/configs/ — no strands.ts config file
  • js/src/instrumentation/plugins/ — no Strands channels or plugin file
  • e2e/scenarios/ — no Strands test scenarios
  • Full repo grep for strands in .ts files — zero matches

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels
    No fields configured for Feature.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions