> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.band.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.band.ai/_mcp/server.

# TypeScript Frameworks

Reference for `@band-ai/sdk` 1.0.0.

## Frameworks

## `GoogleADKAdapter`

Constructor: `new GoogleADKAdapter(options?: GoogleADKAdapterOptions)`. The options type is exported from `@band-ai/sdk/adapters`.

| Option                     | Default                | Purpose                        |
| -------------------------- | ---------------------- | ------------------------------ |
| `model`                    | `DEFAULT_GEMINI_MODEL` | Gemini model name              |
| `apiKey`                   | `Provider lookup`      | Explicit Gemini key            |
| `customSection`            | `Empty string`         | Additional prompt instructions |
| `enableExecutionReporting` | `false`                | Report tool activity           |
| `enableMemoryTools`        | `false`                | Expose memory tools            |
| `maxHistoryMessages`       | `50`                   | History bound                  |
| `maxTranscriptChars`       | `100000`               | Transcript character bound     |

[Released option definitions](https://github.com/band-ai/band-sdk-typescript/blob/sdk-v1.0.0/packages/sdk/src/adapters/google-adk/GoogleADKAdapter.ts).

| Setting         | Reference                       |
| --------------- | ------------------------------- |
| Peer package    | `@google/adk`                   |
| Model / runtime | `model`, `DEFAULT_GEMINI_MODEL` |

See [Google ADK](/connect/google-adk) for installation, connection and verification.

## `LangGraphAdapter`

Constructor: `new LangGraphAdapter(options: LangGraphAdapterOptions)`. The options type is exported from `@band-ai/sdk/adapters`.

| Option                | Default    | Purpose                                                   |
| --------------------- | ---------- | --------------------------------------------------------- |
| `llm`                 | `Optional` | LangChain chat model; provide this, graph or graphFactory |
| `graph`               | `Optional` | Prebuilt LangGraph graph                                  |
| `graphFactory`        | `Optional` | Build a graph from the Band tool list                     |
| `recursionLimit`      | `50`       | Graph recursion limit                                     |
| `maxHistoryMessages`  | `100`      | History bound                                             |
| `emitExecutionEvents` | `true`     | Report execution events                                   |
| `includeMemoryTools`  | `false`    | Expose memory tools                                       |

[Released option definitions](https://github.com/band-ai/band-sdk-typescript/blob/sdk-v1.0.0/packages/sdk/src/adapters/langgraph/LangGraphAdapter.ts).

| Setting         | Reference                                            |
| --------------- | ---------------------------------------------------- |
| Peer package    | `@langchain/langgraph`, `@langchain/core`            |
| Model / runtime | `llm`, a LangChain chat model, or a prebuilt `graph` |

See [LangGraph](/connect/langgraph) for installation, connection and verification.

## `LettaAdapter`

Constructor: `new LettaAdapter(options?: LettaAdapterOptions)`. The options type is exported from `@band-ai/sdk/adapters`.

| Option             | Default         | Purpose                  |
| ------------------ | --------------- | ------------------------ |
| `model`            | `openai/gpt-4o` | Letta model identifier   |
| `lettaApiKey`      | `Unset`         | Letta API key            |
| `lettaBaseUrl`     | `Unset`         | Letta server URL         |
| `lettaAgentId`     | `Unset`         | Existing Letta agent     |
| `memoryBlocks`     | `[]`            | Initial memory blocks    |
| `serverTools`      | `[]`            | Letta server tools       |
| `includeBaseTools` | `false`         | Include Letta base tools |

[Released option definitions](https://github.com/band-ai/band-sdk-typescript/blob/sdk-v1.0.0/packages/sdk/src/adapters/letta/LettaAdapter.ts).

| Setting         | Reference                  |
| --------------- | -------------------------- |
| Peer package    | `@letta-ai/letta-client`   |
| Model / runtime | `model`, `"openai/gpt-4o"` |

See [Letta](/connect/letta) for installation, connection and verification.

## `ParlantAdapter`

Constructor: `new ParlantAdapter(options: ParlantAdapterOptions)`. The options type is exported from `@band-ai/sdk/adapters`.

| Option                   | Default    | Purpose                                                           |
| ------------------------ | ---------- | ----------------------------------------------------------------- |
| `environment`            | `Required` | Parlant environment                                               |
| `baseUrl`                | `Unset`    | Parlant server URL                                                |
| `agentId`                | `Unset`    | Existing agent; cannot combine with systemPrompt or customSection |
| `headers`                | `{}`       | Additional request headers                                        |
| `responseTimeoutSeconds` | `120`      | Response timeout                                                  |
| `maxHistoryMessages`     | `100`      | Prior room messages supplied to a new session                     |

[Released option definitions](https://github.com/band-ai/band-sdk-typescript/blob/sdk-v1.0.0/packages/sdk/src/adapters/parlant/ParlantAdapter.ts).

| Setting         | Reference                                            |
| --------------- | ---------------------------------------------------- |
| Peer package    | `parlant-client`                                     |
| Model / runtime | Set by the Parlant server; `environment` is required |

See [Parlant](/connect/parlant) for installation, connection and verification.