@stackbone/cli 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -7,6 +7,75 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.9.0] - 2026-11-10
+
+### Added
+
+- **The query rewrite is a card on Studio's System screen.**
+  `GET /api/internal-prompts` lists the query rewrite that
+  `stackbone.rag.retrieve({ rewrite })` runs, with its built-in prompt and the
+  model it falls back to: the `defaultModel` workspace setting, else
+  `openai/gpt-4o-mini`. Its prompt is edited and published through
+  `/api/prompts` like the other System prompts, and `/api/settings` takes
+  `rewriteModel` and `rewriteModelProviderId` (STA3-90).
+- **Voice calls play background audio.** The box sends each call's
+  `backgroundAudio` voice setting to the voice worker, and the worker, the one
+  `stackbone dev` runs too, plays an ambience under the whole call and a
+  thinking sound while the agent works on a reply: the knowledge search, the
+  wait for the model's first token and any box tool call. Before, only a chime
+  played, and only during tool calls. By default a call plays
+  `office-ambience` at 0.7 and `keyboard-typing` at 0.6. Studio's Voice tab
+  gets a **Background audio** group. Deploy the worker on LiveKit Cloud before
+  the boxes: an older worker refuses every call from a box on this release,
+  while the new worker takes calls from an older box and plays the defaults.
+
+### Changed
+
+- **A long hybrid query finds the chunks that hold several of its words.**
+  `stackbone rag query`, Studio's search dialog and
+  `POST /api/rag/collections/{name}/query` used to need every word of the
+  query in one chunk, so a long query found nothing by its exact terms. A query
+  of up to 3 words still needs all of them. From 4 words on, a chunk needs at
+  least 2 of them, `eur` and greetings or sign-offs (`hola`, `gracias`,
+  `saludo`, `regards`…) aside, and the chunks that hold more words rank first.
+  The response shape does not change. Splitting a text into one search per
+  question is an SDK option, `stackbone.rag.retrieve({ rewrite })`, that the box
+  route does not take (STA3-79).
+- **On an OpenRouter box a decision model rules on the input guardrails.**
+  The content moderation, denied topics and prompt injection checks on a user
+  message (chat, voice and workflow input) are decided by `jev-1.13` in one
+  request to OpenRouter's `/systemone` endpoint. Each of these rules takes a
+  `threshold` from 0 to 1, default 0.7, that a score must reach to stop the
+  message; a lower value stops more. A value outside 0 to 1 fails the check.
+  The agent's reply is still judged by the checking model, which ignores the
+  threshold. When the decision model errors, takes longer than 1.5 seconds or
+  leaves a question unscored, the checking model decides and the box log says
+  why. A message the decision model stops carries the reason
+  `the decision model flagged it`, with no scores. A box on another provider,
+  or with no OpenRouter key, checks as before (STA3-58).
+- **The box's own models follow the model provider when nobody picked one.**
+  The box lists the models its provider serves at boot and after every
+  provider save. The guardrail, eval judge and persona simulator models nobody
+  picked run on their code default while the provider serves it or the listing
+  has not answered, and on the `defaultModel` workspace setting when the
+  provider does not serve it. Studio's System screen shows that default, and the
+  memory card shows the one `memory.add` resolves the same way.
+  `POST /api/rag/collections` with no embedding model saves
+  `openai/text-embedding-3-small` as before, unless the provider does not serve
+  it: then the collection gets the first embedding model the provider serves,
+  probed for its dimension, and a provider that lists no embedding model
+  answers 400 `rag_embedding_model_required`. `stackbone rag collections create`
+  sends no embedding model, so it gets the same answer. An OpenRouter box keeps
+  today's models, and a model someone picked is never replaced (STA3-82).
+
+### Fixed
+
+- **Rerank works from creator code in a box.** `retrieve({ rerank })` and
+  `client.ai.rerank.create` call the model through the box's model provider
+  proxy, which had no `rerank` route and answered 404, so every rerank fell
+  back to search order. The proxy now forwards it to the provider's `/rerank`,
+  and a model pinned to a provider goes to that provider (STA3-79).
+
 ## [0.8.0] - 2026-11-06
 
 ### Added