How letta-ai/letta-agent-sdk works
Letta Agent SDK exposes a shared client for creating stateful agents, resuming sessions, and running one-shot queries across cloud, local App Server, and remote App Server backends. The central workflow initializes a backend-specific session, sends turns, and streams results; distinct branches cover management, repositories, skills, tools, and cloud execution. Edges reflect README behavior and SOURCE INDEX references or shown calls; unsampled implementation details are omitted where wiring is uncertain.
Main entry points: client-base.ts Agent client · cloud-session.ts Cloud session · app-server-session.ts Session lifecycle · management.ts Agent management
Components 24
Client workflows
- Agent client
src/client-base.ts - One-shot query
src/query.ts - Agent creation
src/agent-creation.ts
Session runtime
- Session lifecycle
src/app-server-session.ts - Remote session core
src/remote-client-session-core.ts - Turn coordination
src/remote-turn-coordinator.ts - Session protocol
src/remote-session-protocol.ts - Transcript accumulation
src/transcript-accumulator.ts
Backend connections
- Cloud session
src/cloud-session.ts - Cloud API client
src/cloud-client.ts - Local App Server session
src/local-app-server-session.ts - Local App Server
src/local-app-server.ts
Agent capabilities
- Agent management
src/management.ts - App Server management
src/app-server-management.ts - Cloud management
src/cloud-management.ts - Repositories
src/repositories.ts - Skill loading
src/skill-loading.ts - MCP tools
src/mcp-runtime.ts - Connected computers
src/computers.ts - Cloud sandbox
src/cloud-sandbox.ts
Other components
- SDK caller
- Letta Cloud
- Letta App Server
- Agent assistant
Connections 29
- SDK caller → Agent client: creates or resumes
README.md - Agent client → Agent creation: creates agent
src/client-base.ts - Agent client → Cloud session: opens cloud session
src/client-base.ts - Agent client → Local App Server session: opens local session
src/client.ts - Agent client → One-shot query: runs query
README.md - One-shot query → Session lifecycle: streams turn
src/query.ts - Session lifecycle → Agent assistant: sends messages
README.md - Session lifecycle → MCP tools: connects tools
src/app-server-session.ts - Session lifecycle → Agent creation: builds creation body
src/app-server-session.ts - Cloud session → Cloud API client: uses API client
src/cloud-session.ts - Cloud session → Letta App Server: opens runtime transport
src/cloud-session.ts - Local App Server session → Letta App Server: connects session
src/local-app-server-session.ts - Agent client → Local App Server: starts server
src/client.ts - Remote session core → Session protocol: maps protocol data
src/remote-client-session-core.ts - Remote session core → Turn coordination: coordinates turns
src/remote-client-session-core.ts - Turn coordination → Session protocol: uses protocol helpers
src/remote-turn-coordinator.ts - Transcript accumulation → Session protocol: parses stream messages
src/transcript-accumulator.ts - Agent client → Agent management: exposes management
src/client-base.ts - Agent management → App Server management: dispatches operations
src/app-server-management.ts - Agent management → Cloud management: cloud transport
src/client-base.ts - Agent client → Repositories: provides repository access
src/client-base.ts - Agent client → Skill loading: resolves skills
src/client-base.ts - Agent creation → Skill loading: seeds skill content
src/agent-creation.ts - Cloud session → Skill loading: resolves skills
src/cloud-session.ts - Agent client → Connected computers: computer access
src/client-base.ts - Cloud session → Cloud sandbox: manages sandbox
src/cloud-session.ts - Cloud API client → Letta Cloud: API requests
src/cloud-client.ts - Cloud management → Letta Cloud: manages cloud records
src/cloud-management.ts - Connected computers → Letta App Server: remote connection
src/computers.ts