From f8559003e629cda80b1ea66da6a6d1131b167152 Mon Sep 17 00:00:00 2001 From: sam123ben Date: Thu, 3 Sep 2026 21:19:33 +1000 Subject: [PATCH 1/2] chore(release): notes for 0.54.0 --- CHANGELOG.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index 923294f..9fc2a67 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -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. From f94a654f1e5769b67a09a9cd4ff793b30f53ddb7 Mon Sep 17 00:00:00 2001 From: sam123ben Date: Thu, 3 Sep 2026 21:54:07 +1000 Subject: [PATCH 2/2] chore(release): point install examples at 0.54.0 --- README.md | 6 +++--- docs/getting-started.md | 6 +++--- docs/keeping-current.md | 10 +++++----- 3 files changed, 11 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 8295796..fbc0a06 100644 --- a/README.md +++ b/README.md @@ -38,13 +38,13 @@ 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__)" ``` @@ -52,7 +52,7 @@ With `uv`, add the same immutable wheel to an application project and commit the 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__)" ``` diff --git a/docs/getting-started.md b/docs/getting-started.md index 7ff829b..a5f2d71 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -7,7 +7,7 @@ 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. @@ -15,14 +15,14 @@ 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__)" ``` diff --git a/docs/keeping-current.md b/docs/keeping-current.md index f2db88e..b44df0e 100644 --- a/docs/keeping-current.md +++ b/docs/keeping-current.md @@ -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,