From fc1de996c831ecc1d0cc7e20047436cb9950ad89 Mon Sep 17 00:00:00 2001
From: smaramwbc <145447586+smaramwbc@users.noreply.github.com>
Date: Tue, 9 Jun 2026 19:30:33 +0100
Subject: [PATCH] =?UTF-8?q?chore:=20bump=20to=201.0.0=20=E2=80=94=20first?=
 =?UTF-8?q?=20stable=20Python=20SDK=20release?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Folds in the never-published 0.10.2 prep (session_id) and the #176
governance helpers (list/promote suggested labels).
---
 CHANGELOG.md          | 16 +++++++++++++++-
 pyproject.toml        |  2 +-
 statewave/__init__.py |  2 +-
 3 files changed, 17 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 774a720..845367e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,20 @@
 # Changelog
 
-## 0.10.2 (2026-05-27)
+## 1.0.0 (2026-06-09)
+
+First **stable** public release of the Statewave Python SDK, cut alongside the Statewave v1.0 server. The typed surface matches the `/v1` REST contract and is semver-stable from 1.0.0 forward. This release supersedes the never-published 0.10.2 prep and folds in its changes.
+
+### Added — governance helpers for suggested-label review (closes [statewave#176](https://github.com/smaramwbc/statewave/issues/176))
+
+- `list_suggested_labels()` → `GET /admin/memories/with-suggested-labels` and `promote_suggested_labels()` → `POST /admin/memories/{id}/promote-labels`, on both `StatewaveClient` and `AsyncStatewaveClient`.
+- New exported typed models: `SuggestedLabelMemory`, `SuggestedLabelsList`, `PromoteLabelsResult`.
+- A bounded SDK-only wrapper over the existing v0.9 admin endpoints — no server change, no new policy semantics. Auto-labeling remains opt-in (`STATEWAVE_AUTO_LABELING_ENABLED`); the default v1.0 user does not hit this surface.
+
+### Added — `session_id` on `create_episode` (closes [statewave#174](https://github.com/smaramwbc/statewave/issues/174))
+
+- `session_id: str | None = None` keyword-only argument on both client classes, forwarded to `POST /v1/episodes` and omitted from the body when `None`. Pure-additive; existing call sites are unaffected. (Originally prepared as 0.10.2, below.)
+
+## 0.10.2 (2026-05-27 — unreleased; folded into 1.0.0)
 
 ### Added — `session_id` on `create_episode` (closes [statewave#174](https://github.com/smaramwbc/statewave/issues/174))
 
diff --git a/pyproject.toml b/pyproject.toml
index c74ac42..2227e3c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "statewave"
-version = "0.10.2"
+version = "1.0.0"
 description = "Official Python SDK for Statewave — the open-source memory runtime for AI agents."
 readme = "README.md"
 license = {text = "Apache-2.0"}
diff --git a/statewave/__init__.py b/statewave/__init__.py
index 2ce1cf0..ba57ebd 100644
--- a/statewave/__init__.py
+++ b/statewave/__init__.py
@@ -1,6 +1,6 @@
 """Statewave Python SDK."""
 
-__version__ = "0.10.2"
+__version__ = "1.0.0"
 
 from statewave.client import AsyncStatewaveClient, StatewaveClient, RetryConfig, DEFAULT_RETRY, NO_RETRY
 from statewave.exceptions import (