Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[bot] Instrument Letta Agent SDK (143,425 weekly downloads)

Open
#2,577 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
55/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
typescript
Domain
observability

Research direction

Start with js/src/auto-instrumentations/configs/all.ts and js/src/span-origin.ts, then compare existing agent integrations such as claude-agent-sdk, openai-agents, and strands-agent-sdk. Inspect the e2e/scenarios/ directory and the Letta Agent SDK documentation to map the client, session, send, and streaming entry points. Done means Letta appears in the registry and instrumentation names with coverage for its agent execution surface and an end-to-end scenario.

Written by the indexing model from the issue text.

Description

typescript

Summary

Letta Agent SDK (@letta-ai/letta-agent-sdk) is the official, actively-maintained TypeScript/JavaScript SDK for Letta's stateful agents — agents with persistent identity, long-term memory, and tool/model state that survives across conversations, models, and machines. Its core agent-execution surface (client.createAgent(), client.resumeSession(), session.send()/streaming) is not instrumented anywhere in this repository.

Note: Letta also publishes an older, now-deprecated REST client, @letta-ai/letta-client (repo letta-ai/letta-node), whose README explicitly states "This package is deprecated... unmaintained and receives no new features," directing users to the Agent SDK instead. This gap report is about the current, supported @letta-ai/letta-agent-sdk, not the deprecated client.

What's missing

  • new LettaAgentClient(...) / client.createAgent(...) — creates a stateful agent.
  • client.resumeSession(agentId) / session.send(...) and its streaming variant — the agent-run execution surface, analogous to other already-instrumented agent frameworks (e.g. claude-agent-sdk, openai-agents, strands-agent-sdk).

None of @letta-ai/letta-agent-sdk, letta-agent-sdk, LettaAgentClient, or letta (case-insensitive) appear anywhere in js/src/, js/src/auto-instrumentations/configs/all.ts (the instrumentation registry), js/src/span-origin.ts (INSTRUMENTATION_NAMES), or any e2e/scenarios/* directory.

Weekly downloads

Weekly downloads: 143,425 (as of 2026-10-03; window 2026-09-27–2026-10-03; source https://api.npmjs.org/downloads/point/last-week/@letta-ai/letta-agent-sdk)

Braintrust docs status

not_found — Letta does not appear in Braintrust's integrations catalog. Checked https://www.braintrust.dev/docs/guides/traces/integrations (enumerated tracing/agent-framework/testing integration cards — Letta is absent) and https://www.braintrust.dev/docs (no mention of "Letta" or stateful-agent SDKs).

Upstream sources

Local repo files inspected

  • js/src/auto-instrumentations/configs/all.ts (full instrumentation registry — no Letta entry)
  • js/src/span-origin.ts (INSTRUMENTATION_NAMES — no Letta entry)
  • Repo-wide case-insensitive search for letta across the working tree (zero matches)
  • e2e/scenarios/ directory listing (no letta-named scenario)
Dominant language
TypeScript
Stars
28
Forks
15
Avg merge
1d 20h
Merged PRs (30d)
73

Getting set up

  • Ships a Dockerfile or Docker Compose file
  • No pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from braintrustdata/braintrust-sdk-javascript

All issues in braintrustdata/braintrust-sdk-javascript

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.