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

# Fiddler Strands Agent SDK

> Fiddler's Strands Agent SDK release history. Contains Strands Agent SDK release highlights, SDK deprecation notices, and more.

[![PyPI](https://img.shields.io/pypi/v/fiddler-strands)](https://pypi.org/project/fiddler-strands/)

## 0.6

<Update label="0.6.0" description="April 14, 2026" tags={["Fiddler Strands Agent SDK"]}>
  * **New Features**
    * **`clear_llm_context()` function**: New convenience function to explicitly remove LLM context from a `Model` instance, preventing faithfulness evaluation on subsequent non-RAG spans. In multi-step agent workflows, context set after a RAG retrieval step previously leaked into later non-RAG LLM calls (tool planning, routing, etc.), causing unintended faithfulness evaluation. `set_llm_context(model, None)` also now clears context.
    * **Python 3.14 support**: Added Python 3.14 to the CI test matrix and PyPI classifiers. All runtime dependencies have compatible wheels.
    * **Fiddler attributes bridged to Strands `trace_attributes`**: Custom span and session attributes set via `set_span_attributes()` and `set_session_attributes()` are now bridged to Strands' native `trace_attributes` mechanism, enabling propagation through the Strands telemetry pipeline without custom hook plumbing for every span type.

  * **Changes**
    * **`strands-agents` floor bumped from `>=1.10.0` to `>=1.19.0`**: Required to align with the Strands telemetry features the SDK now consumes. Users on Strands `1.10.x`–`1.18.x` must upgrade to at least `strands-agents 1.19.0`.
    * **Extended `strands-agents` upper bound to `<=1.33.0`**: Tested compatibility extended to support newer Strands releases.
    * Bumps `fiddler-otel` dependency to `1.1.1` (gains `add_session_attributes()` support for all OTel primitive value types — `str`, `bool`, `int`, `float`, and homogeneous sequences — previously restricted to `str`).

  * **Bug Fixes**
    * **Defensive guard for `trace_attributes` access**: Added a defensive check before accessing `trace_attributes` to prevent attribute errors when bridging Fiddler attributes to Strands telemetry on agents that have not yet initialized the field.
</Update>

## 0.5

<Update label="0.5.0" description="March 26, 2026" tags={["Fiddler Strands Agent SDK"]}>
  * **Initial PyPI Release**
    * First version-tagged build of `fiddler-strands` published to PyPI from the consolidated `fiddler-sdk` monorepo (`pip install fiddler-strands`).
    * Includes all functionality from the 0.4.0 development build (auto-instrumentation, conversation tracking, session and span attributes, LLM context management, and tool-definition tracing). Version 0.4.0 was never published to PyPI.
</Update>

## 0.4

<Update label="0.4.0" description="December 12, 2025" tags={["Fiddler Strands Agent SDK"]}>
  * **Enhancements**
    * **Tool Definition Tracing**: Added `gen_ai.tool.definitions` span attribute to all child spans, providing visibility into tool schemas within agent traces.
</Update>

<Update label="0.3.0" description="November 17, 2025" tags={["Fiddler Strands Agent SDK"]}>
  * **Enhancements**
    * **API Export Fix**: Added `get_llm_context` to module exports — previously available but not importable from the top-level package.
    * **Documentation**: Added comprehensive docstrings to all critical public APIs to support automatic documentation generation.
    * **Examples**: Fixed missing example dependencies and Fiddler configuration setup.
</Update>

<Update label="0.2.0" description="November 11, 2025" tags={["Fiddler Strands Agent SDK"]}>
  * **Enhancements**
    * **LLM Context Management**: New `set_llm_context()` and `get_llm_context()` functions for setting additional context for LLM processing within Strands agent workflows.
    * **System Prompt Telemetry**: System prompts are now included as part of telemetry events for backend processing.
</Update>

<Update label="0.1.0" description="November 10, 2025" tags={["Fiddler Strands Agent SDK"]}>
  * **Initial Release**
    * Core `StrandsAgentInstrumentor` with `instrument()` and `uninstrument()` for automatic OpenTelemetry instrumentation of Strands agents.
    * **Conversation Tracking**: `set_conversation_id()` and `get_conversation_id()` for multi-turn conversation tracking.
    * **Session Attributes**: `set_session_attributes()` and `get_session_attributes()` for adding custom metadata to trace sessions.
    * **Span Attributes**: `set_span_attributes()` and `get_span_attributes()` for adding custom metadata to individual spans.
    * Available as `pip install fiddler-strands`.
</Update>
