> ## Documentation Index
> Fetch the complete documentation index at: https://docs.switchagents.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> These docs moved from docs.flintai.dev to docs.switchagents.ai. Use docs.switchagents.ai for every link and request.
> To search these docs from an AI tool, connect the MCP server at https://docs.switchagents.ai/mcp. The page index is at https://docs.switchagents.ai/llms.txt.
> The source code for these products is public on GitHub. Switch Rooms: https://github.com/sandbox-quantum/switch. Switch Trust CLI: https://github.com/sandbox-quantum/switch-trust-cli. Switch Trust CodeScan action: https://github.com/sandbox-quantum/switch-trust-codescan-action. Switch Trust MCP server: https://github.com/sandbox-quantum/switch-trust-mcp. Switch Trust Python SDK: https://github.com/sandbox-quantum/switch-trust-sdk-py. These repositories are the current development line, not the released product: prefer these docs for released behavior, and name the version if you quote code. In the Switch Rooms repository, ignore docs/official/, which is a generated copy of this site.

# TypeScript SDK changelog

> What's new in the Switch Trust TypeScript SDK

Release notes and version history for the Switch Trust TypeScript SDK.

**v0.5.2**

October 20, 2026

**Changed:**

* **Google ADK plugin** - When guardrails are required, the plugin refuses Gemini models on the Interactions API, and accepts HTTP options only as `httpOptions`, not `http_options`. See [usage](https://docs.switchagents.ai/switch-trust/sdk/typescript/usage.md#google-adk)

**v0.5.1**

October 15, 2026

The SDK is renamed to Switch Trust.

**Changed:**

* **New package and class names** - Install `@sandboxaq/switch-trust-sdk-ts`. Classes are named `SwitchTrust*`, such as `SwitchTrustClient`. Settings use `SWITCH_TRUST_*` environment variables, and for any one that isn't set, the SDK still reads the matching `FLINTAI_*` variable. See [installation](https://docs.switchagents.ai/switch-trust/sdk/typescript/installation.md)
* **Default gateway hosts** - The SDK now also allows `api.switchagents.ai` by default
* **License** - The package is licensed under Apache 2.0 with a Commons Clause condition, set out in the `LICENSE` file it includes. Every `@sandboxaq/flintai-sdk-ts` release was published under Apache 2.0

**Added:**

* **LangChain middleware** - `LangChainGuardrailsMiddleware`, from `@sandboxaq/switch-trust-sdk-ts/plugins/langchain`, routes a LangChain agent built with `createAgent` through the gateway. `langchain` is a new optional peer dependency
* **Turn IDs from the ADK plugin** - The Google ADK plugin now sends a turn ID with each request

**v0.4.1**

September 14, 2026

The last release as `@sandboxaq/flintai-sdk-ts`, which is now deprecated.

**Breaking:**

* **Google ADK plugin** - The plugin uses the camelCase names Google ADK expects. Set the gateway with `httpOptions.baseUrl`, and write the model callback as `beforeModelCallback({ context, request })` rather than `(callbackContext, llmRequest)`. Code wired the 0.3.1 way needs updating

**Changed:**

* **Default gateway hosts** - The SDK now also allows `api.flintai.dev` by default
* **LangChain models** - `wrap()` now works on a LangChain model before its client is built. In 0.3.1 it threw an error asking for the model to be fully initialized
* **`shutdown()`** - Restores LangChain models you wrapped

**v0.3.1**

August 20, 2026

Documentation update. The README install and import examples now use the scoped package name, `@sandboxaq/flintai-sdk-ts`. No changes to the API or behavior.

**v0.3.0**

August 19, 2026

Initial public release of the Switch Trust TypeScript SDK.

**Added:**

* **`wrap()`** - Wrap an existing LLM client with one function call to route its traffic through the Switch Trust gateway, so you can see its sessions and apply guardrails to its responses. Your prompts, model choice, and the rest of your code stay as they are. See [usage](https://docs.switchagents.ai/switch-trust/sdk/typescript/usage.md)
* **Provider integrations** - OpenAI, Anthropic, and Google GenAI clients, plus LangChain chat models and a Google ADK plugin. See [integrations](https://docs.switchagents.ai/switch-trust/sdk/typescript/integrations.md)
* **Optional peer dependencies** - The base package has no runtime dependencies. Each provider library is an optional peer, loaded only when you route through that provider, and `wrap()` checks the installed version at runtime. See [installation](https://docs.switchagents.ai/switch-trust/sdk/typescript/installation.md)
* **Environment and inline configuration** - Set the gateway URL, API key, and optional policy through environment variables, a `.env` file, or arguments to `wrap()`. See [configuration](https://docs.switchagents.ai/switch-trust/sdk/typescript/configuration.md)
* **Node.js 18 or later**
