Skip to main content
Release notes and version history for the Switch Trust Python SDK.
October 20, 2026
Licensing update. No code changes.Changed:
  • License - From this release, the package is licensed under Apache 2.0 with a Commons Clause condition, set out in the LICENSE file it includes. Version 1.1.0, and every flintai-sdk-py release, were published under Apache 2.0
October 14, 2026
The SDK is renamed to Switch Trust.Breaking:
  • .env files load only when you ask - Pass load_dotenv=True to read a .env file. The SDK no longer reads one automatically. See configuration
  • Local and wildcard gateways - Any loopback gateway, and the * host wildcard, need allow_insecure_gateway=True in code
Changed:
  • New package and import names - Install switch-trust-sdk-py and import switch_trust. Settings use SWITCH_TRUST_* environment variables. For any one that isn’t set, the SDK still reads the matching FLINTAI_* variable. See installation
  • Default gateway hosts - The SDK now allows api.switchagents.ai, api.flintai.dev, and app.flintai.dev by default
Added:
  • switch_trust.status() - Check at runtime whether traffic is routed through the gateway. client.guardrails_status() does the same for one client
  • dangerously_disable_guardrails - Turn guardrails off explicitly, so unguarded deployments are easy to find
  • One turn ID per agent run in LangChain - The LangChain middleware now gives every model call in one agent run the same turn ID. See integrations
Fixed:
  • Agent identity from wrap() and init() - When AGENT_ID or AGENT_NAME is set, wrap() and init() send it to Switch Trust, so traffic is attributed to your agent. The LangChain middleware now sends AGENT_NAME as well
  • Google ADK plugin - One turn’s session and agent details no longer carry into the next request, and each request now has a turn ID, so Switch Trust attributes and groups ADK traffic correctly
Security:
  • flintai-sdk-py is withdrawn - PyPI marks all its releases yanked for a credential-redirect vulnerability (GHSA-8xp6-6jgm-vcqj), which isn’t fixed in that package. Move to switch-trust-sdk-py
July 17, 2026
Maintenance release.Changed:
  • X-Agent-Id header - The ADK and LangChain plugins now send X-Agent-Id only when the AGENT_ID environment variable is set, instead of falling back to the plugin’s own name. Set AGENT_ID if you rely on this header to identify your agent
July 15, 2026
Maintenance release.
July 15, 2026
Initial public release of the Switch Trust Python SDK.Added:
  • flintai.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
  • Provider integrations - OpenAI, Anthropic, and Google GenAI clients, plus LangChain chat models and a Google ADK plugin. See integrations
  • Provider extras - Install only what you need with flintai-sdk-py[openai], [anthropic], [genai], [adk], [langchain], or [all]. See installation
  • Environment and inline configuration - Set the gateway URL, API key, and optional policy through FLINTAI_* environment variables, a .env file, or arguments to wrap(). See configuration
  • Python 3.10 or later - Supports 3.10, 3.11, 3.12, and 3.13