Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 34 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,40 @@ the stability decision behind it. The `api-surface` CI job stays red until it do

## [Unreleased]

## 0.54.0

### Added

- **observability**: record every run to an OTLP collector by default (#310)
- use stateless MCP discovery (#308)

### Public API surface

- Added: `tesserix_adk.core.RunRecorder`
- Added: `tesserix_adk.core.bound_session`
- Added: `tesserix_adk.core.current_session`
- Added: `tesserix_adk.core.default_recorder`
- Added: `tesserix_adk.core.install_default_recorder`
- Added: `tesserix_adk.core.recording.RunRecorder`
- Added: `tesserix_adk.core.recording.bound_session`
- Added: `tesserix_adk.core.recording.current_session`
- Added: `tesserix_adk.core.recording.default_recorder`
- Added: `tesserix_adk.core.recording.install_default_recorder`
- Added: `tesserix_adk.observability.ENV_PREFIX`
- Added: `tesserix_adk.observability.OtlpRecorder`
- Added: `tesserix_adk.observability.OtlpSettings`
- Added: `tesserix_adk.observability.build_spans`
- Added: `tesserix_adk.observability.install_from_env`
- Added: `tesserix_adk.observability.otlp.ENV_PREFIX`
- Added: `tesserix_adk.observability.otlp.OtlpRecorder`
- Added: `tesserix_adk.observability.otlp.OtlpSettings`
- Added: `tesserix_adk.observability.otlp.build_spans`
- Added: `tesserix_adk.observability.otlp.install_from_env`
- Added: `tesserix_adk.observability.otlp.recorder_from_env`
- Added: `tesserix_adk.observability.otlp.resource_for`
- Added: `tesserix_adk.observability.recorder_from_env`
- Added: `tesserix_adk.observability.resource_for`

## 0.53.1

No consumer-visible changes.
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,21 +38,21 @@ networking, identity, and data.
Python 3.12 or newer is required. Development and release verification use CPython 3.14,
while CI keeps every declared minor from 3.12 through 3.14 compatible.
PyPI trusted publishing is not enabled yet, so install the exact wheel from the public
v0.53.1 release. Standard `pip` and `uv` install the same distribution.
v0.54.0 release. Standard `pip` and `uv` install the same distribution.

With `pip`, create an isolated environment and import the underscore-named Python package:

```bash
python -m venv .venv
.venv/bin/python -m pip install "tesserix-adk @ https://github.com/tesserix/agent-development-kit/releases/download/v0.53.1/tesserix_adk-0.53.1-py3-none-any.whl"
.venv/bin/python -m pip install "tesserix-adk @ https://github.com/tesserix/agent-development-kit/releases/download/v0.54.0/tesserix_adk-0.54.0-py3-none-any.whl"
.venv/bin/python -c "import tesserix_adk; print(tesserix_adk.__version__)"
```

With `uv`, add the same immutable wheel to an application project and commit the generated
lockfile:

```bash
uv add "tesserix-adk @ https://github.com/tesserix/agent-development-kit/releases/download/v0.53.1/tesserix_adk-0.53.1-py3-none-any.whl"
uv add "tesserix-adk @ https://github.com/tesserix/agent-development-kit/releases/download/v0.54.0/tesserix_adk-0.54.0-py3-none-any.whl"
uv run python -c "import tesserix_adk; print(tesserix_adk.__version__)"
```

Expand Down
6 changes: 3 additions & 3 deletions docs/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,22 +7,22 @@ development while testing the full declared 3.12–3.14 range.

## 1. Install

PyPI trusted publishing is not enabled yet. Install the exact tagged v0.53.1 wheel from
PyPI trusted publishing is not enabled yet. Install the exact tagged v0.54.0 wheel from
the public GitHub Release rather than asking an index for a project that is not there.
The distribution name uses a hyphen; the Python import uses an underscore.

With `pip`:

```bash
python -m venv .venv
.venv/bin/python -m pip install "tesserix-adk @ https://github.com/tesserix/agent-development-kit/releases/download/v0.53.1/tesserix_adk-0.53.1-py3-none-any.whl"
.venv/bin/python -m pip install "tesserix-adk @ https://github.com/tesserix/agent-development-kit/releases/download/v0.54.0/tesserix_adk-0.54.0-py3-none-any.whl"
.venv/bin/python -c "import tesserix_adk; print(tesserix_adk.__version__)"
```

With `uv`, from an application project:

```bash
uv add "tesserix-adk @ https://github.com/tesserix/agent-development-kit/releases/download/v0.53.1/tesserix_adk-0.53.1-py3-none-any.whl"
uv add "tesserix-adk @ https://github.com/tesserix/agent-development-kit/releases/download/v0.54.0/tesserix_adk-0.54.0-py3-none-any.whl"
uv run python -c "import tesserix_adk; print(tesserix_adk.__version__)"
```

Expand Down
10 changes: 5 additions & 5 deletions docs/keeping-current.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,28 +28,28 @@ replace both occurrences when a newer stable release is approved.
For a `uv`-managed application:

```bash
uv add "tesserix-adk @ https://github.com/tesserix/agent-development-kit/releases/download/v0.53.1/tesserix_adk-0.53.1-py3-none-any.whl"
uv add "tesserix-adk @ https://github.com/tesserix/agent-development-kit/releases/download/v0.54.0/tesserix_adk-0.54.0-py3-none-any.whl"
git add pyproject.toml uv.lock
```

For a standard virtual environment managed with `pip`:

```bash
python -m pip install "tesserix-adk @ https://github.com/tesserix/agent-development-kit/releases/download/v0.53.1/tesserix_adk-0.53.1-py3-none-any.whl"
python -m pip install "tesserix-adk @ https://github.com/tesserix/agent-development-kit/releases/download/v0.54.0/tesserix_adk-0.54.0-py3-none-any.whl"
python -c "import tesserix_adk; print(tesserix_adk.__version__)"
```

Record that exact direct reference in the application's dependency declaration and commit
the environment's hash-pinned requirements. `pip` installs packages; it does not make an
unlocked environment reproducible by itself. Extras use normal PEP 508 syntax, for example
`tesserix-adk[a2a,mcp] @ https://.../tesserix_adk-0.53.1-py3-none-any.whl`.
`tesserix-adk[a2a,mcp] @ https://.../tesserix_adk-0.54.0-py3-none-any.whl`.

After PyPI trusted publishing is enabled, use a pre-1.0 compatibility window that accepts
patch fixes without silently accepting the next potentially breaking minor release:

```bash
uv add "tesserix-adk~=0.53.1"
python -m pip install "tesserix-adk~=0.53.1"
uv add "tesserix-adk~=0.54.0"
python -m pip install "tesserix-adk~=0.54.0"
```

In the `uv` case, commit `uv.lock` and install with `uv sync --frozen`. In the `pip` case,
Expand Down