diff --git a/.changeset/choices-interaction-kind.md b/.changeset/choices-interaction-kind.md deleted file mode 100644 index 4589af54..00000000 --- a/.changeset/choices-interaction-kind.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -'@smooai/smooth-operator': minor ---- - -Add the `choices` Rich Interaction kind (a structured multiple-choice ask, modeled on Claude Code's AskUserQuestion) as the second reference kind in the Rust implementation, plus its shared JSON-Schema contract the other servers + web SDK mirror. - -An agent raises `request_choices` with 1–4 questions, each `{ question, header (short ≤12-char label), options: [{ label, description }] (2–4), multiSelect? }` and a `reason`. On a channel that declared the **`choice_chips`** capability the turn parks and the client renders chips/menus (`interaction_required { kind: "choices" }`); on text/voice channels the same raise degrades to an enumerated conversational directive. Every question carries an implicit free-text `other` escape hatch (mirroring AskUserQuestion's ever-present "Other"), so the visitor can always answer outside the enumerated options. - -Server-side validation (`validate_choices`, shared by the card path's WS handler and the fallback path's `submit_interaction` tool): every question answered, each selected label offered, single-select takes exactly one pick (label XOR `other`), multi-select one or more; invalid submits return retryable per-question `interaction_invalid` errors, never a terminal error. `ChoicesKind` is registered in the default `InteractionRegistry`. The canonical contract lives in `spec/interactions/choices.schema.json` (Spec / Values / Payload) with conformance fixtures; the other-language servers follow as parity work. diff --git a/dotnet/server/aspnetcore/SmooAI.SmoothOperator.Server.AspNetCore.csproj b/dotnet/server/aspnetcore/SmooAI.SmoothOperator.Server.AspNetCore.csproj index 7fa8cd3d..01ed4e75 100644 --- a/dotnet/server/aspnetcore/SmooAI.SmoothOperator.Server.AspNetCore.csproj +++ b/dotnet/server/aspnetcore/SmooAI.SmoothOperator.Server.AspNetCore.csproj @@ -15,7 +15,7 @@ attribute. (Keep the element-form version out of comments: the sync regex replaces the first element-form match in the file.) --> SmooAI.SmoothOperator.Server.AspNetCore - 1.52.3 + 1.53.0 SmooAI ai;agent;llm;chat;smooth-operator;server;aspnetcore;websocket;smooai MIT diff --git a/dotnet/server/postgres/src/SmooAI.SmoothOperator.Server.Postgres.csproj b/dotnet/server/postgres/src/SmooAI.SmoothOperator.Server.Postgres.csproj index 4152734a..f8867e6e 100644 --- a/dotnet/server/postgres/src/SmooAI.SmoothOperator.Server.Postgres.csproj +++ b/dotnet/server/postgres/src/SmooAI.SmoothOperator.Server.Postgres.csproj @@ -15,7 +15,7 @@ attribute. (Keep the element-form version out of comments: the sync regex replaces the first element-form match in the file.) --> SmooAI.SmoothOperator.Server.Postgres - 1.52.3 + 1.53.0 SmooAI ai;agent;llm;chat;smooth-operator;server;postgres;pgvector;smooai MIT diff --git a/dotnet/server/src/SmooAI.SmoothOperator.Server.csproj b/dotnet/server/src/SmooAI.SmoothOperator.Server.csproj index c83b000d..6d3ce17d 100644 --- a/dotnet/server/src/SmooAI.SmoothOperator.Server.csproj +++ b/dotnet/server/src/SmooAI.SmoothOperator.Server.csproj @@ -14,7 +14,7 @@ scripts/sync-versions.mjs (do NOT confuse with the SmooAI.SmoothOperator.Core PackageReference version below, which tracks the separately-published engine). --> SmooAI.SmoothOperator.Server - 1.52.3 + 1.53.0 SmooAI ai;agent;llm;chat;smooth-operator;server;websocket;smooai MIT diff --git a/examples/web-chat/CHANGELOG.md b/examples/web-chat/CHANGELOG.md index 82898c73..2509c6b8 100644 --- a/examples/web-chat/CHANGELOG.md +++ b/examples/web-chat/CHANGELOG.md @@ -1,5 +1,12 @@ # @smooai/smooth-operator-web-chat-example +## 0.0.92 + +### Patch Changes + +- Updated dependencies [0e8f36e] + - @smooai/smooth-operator@1.53.0 + ## 0.0.91 ### Patch Changes diff --git a/examples/web-chat/package.json b/examples/web-chat/package.json index 593e7406..4769c5aa 100644 --- a/examples/web-chat/package.json +++ b/examples/web-chat/package.json @@ -1,6 +1,6 @@ { "name": "@smooai/smooth-operator-web-chat-example", - "version": "0.0.91", + "version": "0.0.92", "private": true, "description": "A smooth-web-like Vite + React chat client that drives a running smooth-operator server over its WebSocket protocol — token streaming, inline tool-call/result blocks, a conversation sidebar, and oldest-first history, all on top of the published @smooai/smooth-operator SDK.", "type": "module", diff --git a/go/version.go b/go/version.go index 799d1fea..780a04ae 100644 --- a/go/version.go +++ b/go/version.go @@ -5,4 +5,4 @@ package e2e // language artifacts. The real Go "publish" is a git tag (go/v); this // constant is the anchor that scripts/sync-versions.mjs keeps in sync with the // canonical npm version on every changeset release. -const Version = "1.52.3" +const Version = "1.53.0" diff --git a/python/pyproject.toml b/python/pyproject.toml index 3fd63471..35c8c6bd 100644 --- a/python/pyproject.toml +++ b/python/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "smooai-smooth-operator" -version = "1.52.3" +version = "1.53.0" description = "Python protocol types and native async WebSocket client for the smooth-operator protocol. Generated from the language-neutral JSON Schemas in spec/." readme = "README.md" license = { text = "MIT" } diff --git a/python/server/pyproject.toml b/python/server/pyproject.toml index 57945893..f11e4a56 100644 --- a/python/server/pyproject.toml +++ b/python/server/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "smooai-smooth-operator-server" -version = "1.52.3" +version = "1.53.0" description = "Native async WebSocket server for the smooth-operator protocol — parity with the Rust and C# reference servers, consuming the in-process smooai-smooth-operator-core engine." readme = "README.md" license = { text = "MIT" } diff --git a/rust/Cargo.lock b/rust/Cargo.lock index e344ba21..2fe16907 100644 --- a/rust/Cargo.lock +++ b/rust/Cargo.lock @@ -4099,7 +4099,7 @@ checksum = "8ed6a63f02c8539c91a8685a86f4099661ba3da017932f6ebbea6de3f0fa7c90" [[package]] name = "smooai-smooth-operator" -version = "1.52.3" +version = "1.53.0" dependencies = [ "anyhow", "async-trait", @@ -4133,7 +4133,7 @@ dependencies = [ [[package]] name = "smooai-smooth-operator-adapter-backplane-nats" -version = "1.52.3" +version = "1.53.0" dependencies = [ "anyhow", "async-nats", @@ -4149,7 +4149,7 @@ dependencies = [ [[package]] name = "smooai-smooth-operator-adapter-backplane-redis" -version = "1.52.3" +version = "1.53.0" dependencies = [ "anyhow", "async-trait", @@ -4165,7 +4165,7 @@ dependencies = [ [[package]] name = "smooai-smooth-operator-adapter-dynamodb" -version = "1.52.3" +version = "1.53.0" dependencies = [ "anyhow", "async-trait", @@ -4186,7 +4186,7 @@ dependencies = [ [[package]] name = "smooai-smooth-operator-adapter-memory" -version = "1.52.3" +version = "1.53.0" dependencies = [ "anyhow", "async-trait", @@ -4199,7 +4199,7 @@ dependencies = [ [[package]] name = "smooai-smooth-operator-adapter-postgres" -version = "1.52.3" +version = "1.53.0" dependencies = [ "anyhow", "async-trait", @@ -4290,7 +4290,7 @@ dependencies = [ [[package]] name = "smooai-smooth-operator-ingestion" -version = "1.52.3" +version = "1.53.0" dependencies = [ "anyhow", "async-trait", @@ -4337,7 +4337,7 @@ dependencies = [ [[package]] name = "smooai-smooth-operator-server" -version = "1.52.3" +version = "1.53.0" dependencies = [ "anyhow", "async-trait", diff --git a/rust/Cargo.toml b/rust/Cargo.toml index e5e6326e..1cf766ff 100644 --- a/rust/Cargo.toml +++ b/rust/Cargo.toml @@ -40,7 +40,7 @@ smooai-smooth-operator-core = "1.8.0" # Intra-workspace dep on the reference lib carries its version so the adapters / # ingestion / server that depend on it are publishable (path = local dev, # version = the crates.io requirement). -smooth-operator = { package = "smooai-smooth-operator", path = "smooth-operator", version = "1.52.3" } +smooth-operator = { package = "smooai-smooth-operator", path = "smooth-operator", version = "1.53.0" } async-trait = "0.1" anyhow = "1" diff --git a/rust/adapters/backplane-nats/Cargo.toml b/rust/adapters/backplane-nats/Cargo.toml index aa8e423f..0a356a86 100644 --- a/rust/adapters/backplane-nats/Cargo.toml +++ b/rust/adapters/backplane-nats/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "smooai-smooth-operator-adapter-backplane-nats" -version = "1.52.3" +version = "1.53.0" edition.workspace = true license.workspace = true repository.workspace = true diff --git a/rust/adapters/backplane-redis/Cargo.toml b/rust/adapters/backplane-redis/Cargo.toml index ca4b80eb..d182bdcd 100644 --- a/rust/adapters/backplane-redis/Cargo.toml +++ b/rust/adapters/backplane-redis/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "smooai-smooth-operator-adapter-backplane-redis" -version = "1.52.3" +version = "1.53.0" edition.workspace = true license.workspace = true repository.workspace = true diff --git a/rust/adapters/dynamodb/Cargo.toml b/rust/adapters/dynamodb/Cargo.toml index fa6ae231..5c241dff 100644 --- a/rust/adapters/dynamodb/Cargo.toml +++ b/rust/adapters/dynamodb/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "smooai-smooth-operator-adapter-dynamodb" -version = "1.52.3" +version = "1.53.0" edition.workspace = true license.workspace = true repository.workspace = true @@ -19,7 +19,7 @@ s3-vectors = ["dep:aws-sdk-s3vectors", "dep:aws-smithy-types"] smooth-operator = { workspace = true } smooai-smooth-operator-core = { workspace = true } # IndexingStore / IndexingRun for the persistent admin indexing-runs store. -smooai-smooth-operator-ingestion = { path = "../../ingestion", version = "1.52.3" } +smooai-smooth-operator-ingestion = { path = "../../ingestion", version = "1.53.0" } async-trait = { workspace = true } anyhow = { workspace = true } chrono = { workspace = true } diff --git a/rust/adapters/in-memory/Cargo.toml b/rust/adapters/in-memory/Cargo.toml index addfcd64..983f3c15 100644 --- a/rust/adapters/in-memory/Cargo.toml +++ b/rust/adapters/in-memory/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "smooai-smooth-operator-adapter-memory" -version = "1.52.3" +version = "1.53.0" edition.workspace = true license.workspace = true repository.workspace = true diff --git a/rust/adapters/postgres/Cargo.toml b/rust/adapters/postgres/Cargo.toml index e1dcbad8..c35c055d 100644 --- a/rust/adapters/postgres/Cargo.toml +++ b/rust/adapters/postgres/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "smooai-smooth-operator-adapter-postgres" -version = "1.52.3" +version = "1.53.0" edition.workspace = true license.workspace = true repository.workspace = true @@ -15,7 +15,7 @@ smooth-operator = { workspace = true } # `postgres` feature pulls in PostgresCheckpointStore (sync r2d2 path). smooai-smooth-operator-core = { workspace = true, features = ["postgres"] } # IndexingStore / IndexingRun for the persistent admin indexing-runs store. -smooai-smooth-operator-ingestion = { path = "../../ingestion", version = "1.52.3" } +smooai-smooth-operator-ingestion = { path = "../../ingestion", version = "1.53.0" } async-trait = { workspace = true } anyhow = { workspace = true } chrono = { workspace = true } diff --git a/rust/ingestion/Cargo.toml b/rust/ingestion/Cargo.toml index bc34491e..de6da7df 100644 --- a/rust/ingestion/Cargo.toml +++ b/rust/ingestion/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "smooai-smooth-operator-ingestion" -version = "1.52.3" +version = "1.53.0" edition.workspace = true license.workspace = true repository.workspace = true diff --git a/rust/smooth-operator-server/Cargo.toml b/rust/smooth-operator-server/Cargo.toml index f1580cc0..97f8e4ef 100644 --- a/rust/smooth-operator-server/Cargo.toml +++ b/rust/smooth-operator-server/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "smooai-smooth-operator-server" -version = "1.52.3" +version = "1.53.0" edition.workspace = true license.workspace = true repository.workspace = true @@ -35,22 +35,22 @@ smooth-operator = { workspace = true } smooai-smooth-operator-core = { workspace = true } # In-memory storage + backplane — ALWAYS included. The local-flavor default and # the lean (`--no-default-features`) build run entirely on these. -smooai-smooth-operator-adapter-memory = { path = "../adapters/in-memory", version = "1.52.3" } +smooai-smooth-operator-adapter-memory = { path = "../adapters/in-memory", version = "1.53.0" } # Persistent storage + admin-store backends, selected at runtime to match the # configured storage backend (Postgres / DynamoDB; default in-memory). Optional: # gated behind the `postgres` / `dynamodb` features so a lean local/embed build # can exclude tokio-postgres / the AWS SDK. The `postgres` crate also provides the # gateway-backed embedder/reranker, so the `postgres` feature additionally enables # the semantic-retrieval path in `embedder.rs` / `reranker.rs`. -smooai-smooth-operator-adapter-postgres = { path = "../adapters/postgres", version = "1.52.3", optional = true } -smooai-smooth-operator-adapter-dynamodb = { path = "../adapters/dynamodb", version = "1.52.3", optional = true } +smooai-smooth-operator-adapter-postgres = { path = "../adapters/postgres", version = "1.53.0", optional = true } +smooai-smooth-operator-adapter-dynamodb = { path = "../adapters/dynamodb", version = "1.53.0", optional = true } # Distributed Backplane backends for horizontal scale-out, selected at runtime # via SMOOTH_AGENT_BACKPLANE (default in-memory / single-process). Optional: gated # behind the `redis` / `nats` features so a lean build excludes their drivers. -smooai-smooth-operator-adapter-backplane-redis = { path = "../adapters/backplane-redis", version = "1.52.3", optional = true } -smooai-smooth-operator-adapter-backplane-nats = { path = "../adapters/backplane-nats", version = "1.52.3", optional = true } +smooai-smooth-operator-adapter-backplane-redis = { path = "../adapters/backplane-redis", version = "1.53.0", optional = true } +smooai-smooth-operator-adapter-backplane-nats = { path = "../adapters/backplane-nats", version = "1.53.0", optional = true } # Admin API surfaces indexing-run status via the ingestion crate's IndexingStore. -smooai-smooth-operator-ingestion = { path = "../ingestion", version = "1.52.3" } +smooai-smooth-operator-ingestion = { path = "../ingestion", version = "1.53.0" } async-trait = { workspace = true } anyhow = { workspace = true } diff --git a/rust/smooth-operator/Cargo.toml b/rust/smooth-operator/Cargo.toml index 96306c1e..24dfc240 100644 --- a/rust/smooth-operator/Cargo.toml +++ b/rust/smooth-operator/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "smooai-smooth-operator" -version = "1.52.3" +version = "1.53.0" edition.workspace = true license.workspace = true repository.workspace = true diff --git a/typescript/CHANGELOG.md b/typescript/CHANGELOG.md index 060074a2..ec9d9ffe 100644 --- a/typescript/CHANGELOG.md +++ b/typescript/CHANGELOG.md @@ -1,5 +1,15 @@ # @smooai/smooth-operator +## 1.53.0 + +### Minor Changes + +- 0e8f36e: Add the `choices` Rich Interaction kind (a structured multiple-choice ask, modeled on Claude Code's AskUserQuestion) as the second reference kind in the Rust implementation, plus its shared JSON-Schema contract the other servers + web SDK mirror. + + An agent raises `request_choices` with 1–4 questions, each `{ question, header (short ≤12-char label), options: [{ label, description }] (2–4), multiSelect? }` and a `reason`. On a channel that declared the **`choice_chips`** capability the turn parks and the client renders chips/menus (`interaction_required { kind: "choices" }`); on text/voice channels the same raise degrades to an enumerated conversational directive. Every question carries an implicit free-text `other` escape hatch (mirroring AskUserQuestion's ever-present "Other"), so the visitor can always answer outside the enumerated options. + + Server-side validation (`validate_choices`, shared by the card path's WS handler and the fallback path's `submit_interaction` tool): every question answered, each selected label offered, single-select takes exactly one pick (label XOR `other`), multi-select one or more; invalid submits return retryable per-question `interaction_invalid` errors, never a terminal error. `ChoicesKind` is registered in the default `InteractionRegistry`. The canonical contract lives in `spec/interactions/choices.schema.json` (Spec / Values / Payload) with conformance fixtures; the other-language servers follow as parity work. + ## 1.52.3 ### Patch Changes diff --git a/typescript/package.json b/typescript/package.json index 91fab558..0b9a8c23 100644 --- a/typescript/package.json +++ b/typescript/package.json @@ -1,6 +1,6 @@ { "name": "@smooai/smooth-operator", - "version": "1.52.3", + "version": "1.53.0", "description": "TypeScript SDK for the smooth-operator WebSocket protocol: the native client (`.`), React bindings (`./react`), and the embeddable web-component chat widget (`./widget`). Generated from the language-neutral JSON Schemas in spec/.", "license": "MIT", "type": "module",