Changelog

All notable changes to the Trustwise SDK will be documented in this file.

v4.5.0 (2026-04-30)

Agents are now project-scoped — all client.agents methods now require a project_id as the first argument. The old /v1alpha/agents/ endpoints have been removed from the API.
``ProjectResource`` — list_components, assign_component, and unassign_component methods removed (endpoints removed from the API).
``EvaluationResource.update`` — now uses PATCH instead of PUT.
``GuardrailResource.provider_schemas`` — no longer accepts a provider argument; returns schemas for all providers.

Events (client.events) — list, get, and dismiss platform event notifications with filtering by severity, status, type, and project.
Subscriptions (client.subscriptions) — full CRUD for event subscriptions; supports webhook, email, Slack, and Teams handlers.
Runtime Providers (client.runtime_providers) — browse available agent runtime provider types and their auth schemas.
Organization Logo (client.organizations) — upload_logo, get_logo, update_logo, delete_logo methods added.
Guardrail Provider extensions (client.guardrails) — provider_guardrails() and provider_regions() for browsing guardrails and regions available from external providers (e.g. AWS Bedrock).
Policy batch evaluate (client.policies) — new evaluate_batch() method evaluates content against multiple policies in a single API call.
``PlatformHTTP`` — added patch() method.

TrustwiseClient – New unified platform client providing access to all Trustwise APIs through a single interface: agents, guardrails, policies, evaluations, risk engine, red-team generation, and all v4 metrics.
Platform API resources – 11 resource classes covering 80+ API endpoints with typed return values and raw=True envelope access.

TrustwiseSDK is deprecated with a FutureWarning. Migrate to TrustwiseClient. See Migrating from TrustwiseSDK to TrustwiseClient for details.

V3 Metrics Deprecation: V3 metrics are now deprecated and will be removed in a future version. Please migrate to V4 metrics for continued support and enhanced features.
Future Default Behavior: V4 metrics will become the default when calling metrics.* without version specification once V3 is fully deprecated.

Initial release of Trustwise Python SDK
Unified interface for evaluating AI-generated content across 14+ metrics: - Faithfulness - Answer Relevancy - Context Relevancy - Summarization - Prompt Injection Detection - PII Detection - Clarity - Helpfulness - Toxicity - Tone - Formality - Simplicity - Sensitivity - Cost Estimation - Carbon Emissions
Experimental guardrails system for multi-metric validation, threshold configuration, and block-on-failure functionality
Cost and carbon emissions estimation for model runs
Flexible configuration via environment variables or direct instantiation (API key, base URL, etc.)
Strong type definitions for all request and response objects
Serialization support: all responses can be converted to JSON and Python dicts for easy integration
Explicit and default API versioning with version switching and fallback
Designed for extensibility to support future metrics and features
Comprehensive documentation, including quickstart, usage, and API reference
Added async SDK (TrustwiseSDKAsync) for full asynchronous metric evaluation.
Added support for inline explanations for each metric evaluation call.

Added support for context-based faithfulness, answer relevancy, and other metrics
Implemented query-response alignment scoring
Added cost and carbon evaluation for model runs
Added support for stability, adherence, completion and refusal metrics