From 699ae3b38ee878bf7c09dfaf7e019a1eadf36ca8 Mon Sep 17 00:00:00 2001
From: banteg <4562643+banteg@users.noreply.github.com>
Date: Wed, 14 Jan 2026 01:58:36 +0400
Subject: [PATCH] chore: release v0.18.0 (#131)

---
 changelog.md                          | 17 +++++++++++++++++
 docs/reference/specification.md       | 10 +++++++---
 docs/tutorials/install-and-onboard.md |  2 +-
 pyproject.toml                        |  2 +-
 scripts/docs_build_cf.sh              |  2 +-
 src/takopi/__init__.py                |  2 +-
 uv.lock                               |  2 +-
 7 files changed, 29 insertions(+), 8 deletions(-)

diff --git a/changelog.md b/changelog.md
index 523d9d1..6d7c3c0 100644
--- a/changelog.md
+++ b/changelog.md
@@ -1,5 +1,22 @@
 # changelog
 
+## v0.18.0 (2026-01-13)
+
+### changes
+
+- add per-chat and per-topic default agent via `/agent set` command [#109](https://github.com/banteg/takopi/pull/109)
+- add session resume shorthand for pi runner [#113](https://github.com/banteg/takopi/pull/113)
+- expose `sender_id` and `raw` fields on `MessageRef` for plugins [#112](https://github.com/banteg/takopi/pull/112)
+
+### fixes
+
+- recreate stale topic bindings when topic is deleted and recreated [#127](https://github.com/banteg/takopi/pull/127)
+- use stdout session header for pi runner [#126](https://github.com/banteg/takopi/pull/126)
+
+### docs
+
+- restructure docs into diataxis format and switch to zensical [#121](https://github.com/banteg/takopi/pull/121) [#125](https://github.com/banteg/takopi/pull/125)
+
 ## v0.17.1 (2026-01-12)
 
 ### fixes
diff --git a/docs/reference/specification.md b/docs/reference/specification.md
index c07b581..cc13ddc 100644
--- a/docs/reference/specification.md
+++ b/docs/reference/specification.md
@@ -1,10 +1,10 @@
-# Takopi Specification v0.17.1 [2026-01-12]
+# Takopi Specification v0.18.0 [2026-01-13]
 
 This document is **normative**. The words **MUST**, **SHOULD**, and **MAY** express requirements.
 
 ## 1. Scope
 
-Takopi v0.17.1 specifies:
+Takopi v0.18.0 specifies:
 
 - A **Telegram** bot bridge that runs an agent **Runner** and posts:
   - a throttled, edited **progress message**
@@ -15,7 +15,7 @@ Takopi v0.17.1 specifies:
 - **Automatic runner selection** among multiple engines based on ResumeLine (with a configurable default for new threads)
 - A Takopi-owned **normalized event model** produced by runners and consumed by renderers/bridge
 
-Out of scope for v0.17.1:
+Out of scope for v0.18.0:
 
 - Non-Telegram clients (Slack/Discord/etc.)
 - Token-by-token streaming of the assistant’s final answer
@@ -444,6 +444,10 @@ The lock file SHOULD be removed on clean shutdown. Stale locks from crashed proc
 
 ## 11. Changelog
 
+### v0.18.0 (2026-01-13)
+
+- No normative changes; align spec version with the v0.18.0 release.
+
 ### v0.17.1 (2026-01-12)
 
 - No normative changes; align spec version with the v0.17.1 release.
diff --git a/docs/tutorials/install-and-onboard.md b/docs/tutorials/install-and-onboard.md
index c372e34..6cc4dd9 100644
--- a/docs/tutorials/install-and-onboard.md
+++ b/docs/tutorials/install-and-onboard.md
@@ -30,7 +30,7 @@ Verify it's installed:
 takopi --version
 ```
 
-You should see something like `0.17.1`.
+You should see something like `0.18.0`.
 
 ## 3. Install agent CLIs
 
diff --git a/pyproject.toml b/pyproject.toml
index feafa9d..90cfea4 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,7 +1,7 @@
 [project]
 name = "takopi"
 authors = [{name = "banteg"}]
-version = "0.17.1"
+version = "0.18.0"
 description = "Telegram bridge for Codex, Claude Code, and other agent CLIs."
 readme = "readme.md"
 license = { file = "LICENSE" }
diff --git a/scripts/docs_build_cf.sh b/scripts/docs_build_cf.sh
index 2da4669..01a21b9 100755
--- a/scripts/docs_build_cf.sh
+++ b/scripts/docs_build_cf.sh
@@ -3,6 +3,6 @@ set -euo pipefail
 
 pip install uv
 uv python install 3.14
-uv sync --frozen --no-install-project --group docs
+uv sync --frozen --only-group docs
 uv run --no-sync python scripts/docs_prebuild.py
 uv run --no-sync zensical build --clean
diff --git a/src/takopi/__init__.py b/src/takopi/__init__.py
index c6eae9f..1317d75 100644
--- a/src/takopi/__init__.py
+++ b/src/takopi/__init__.py
@@ -1 +1 @@
-__version__ = "0.17.1"
+__version__ = "0.18.0"
diff --git a/uv.lock b/uv.lock
index 7ac1245..82946cb 100644
--- a/uv.lock
+++ b/uv.lock
@@ -824,7 +824,7 @@ wheels = [
 
 [[package]]
 name = "takopi"
-version = "0.17.1"
+version = "0.18.0"
 source = { editable = "." }
 dependencies = [
     { name = "anyio" },