@stackbone/cli 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -7,6 +7,153 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.0] - 2026-11-06
+
+### Added
+
+- **`stackbone build` and `dev` record each agent key's `modelRouting`.** The
+  model inventory now carries the `modelRouting` literal an agent and each of
+  its subagents write, so Studio's Models block shows the code's provider
+  routing next to the one an operator picks. A value OpenRouter does not take
+  is warned about, with its file and line.
+- **Recurring jobs hides the platform's own timers.** Studio's Recurring jobs
+  screen now shows only the workflow crons by default; intake link polling and
+  the box's sweeps appear when **System entries** is on, as on Catalog, Runs and
+  Sessions. A banner counts the hidden ones that are overdue, not armed or
+  failed, so a stuck intake poll still shows. `GET /api/recurring-jobs`
+  returns `system` on every row; an older box leaves it out and Studio shows
+  the row (STA3-71).
+- `stackbone dev` and `stackbone build` seed the `rag-extract` managed workflow
+  for Studio's document value proposals. A creator can override the default in
+  `workflows/rag-extract.workflow.ts` (STA3-67).
+- **The box places outbound calls for `placeCall`.** A workflow's `placeCall`
+  opens a LiveKit room, dispatches the voice worker and dials the number
+  through the trunk in the box secret `LIVEKIT_SIP_OUTBOUND_TRUNK_ID`, with
+  `LIVEKIT_SIP_CALLER_ID` as the optional caller id. The agent's model is
+  warmed while the phone rings. An answered call is kept until the worker
+  reports its end, then the box starts the `onEnd` workflow once. A 30-second
+  sweep ends a call as `failed` when its room is gone past a grace period or
+  it outlived its call token; the sweep is a system entry on Recurring jobs.
+  Migration 0118 adds the calls table (STA3-56).
+- **Each turn of a call is timed on the run that answered it.** The voice
+  worker reports the latencies of every answered turn, and the box writes them
+  as `voice` steps on that run (**Wait**, then **End of turn**, **Speech to
+  text**, **Box**, **Model first token**, **Text to speech** and **Audio
+  out**), which Studio draws in the run's trace. Migration 0119 stores the
+  latencies and 0120 adds the `voice` step type. `stackbone dev` prints one
+  `Voice turn` line per answered turn with the same numbers (STA3-56).
+- **Hybrid search hits say which search found them.**
+  `POST /api/rag/collections/{name}/query` returns optional `dense_rank` and
+  `lexical_rank` on each hit of a hybrid `text` query: its 1-based position in
+  the search by meaning and in the exact-term search, before fusion. A search
+  that did not find the hit omits its rank; `hybrid: false`, an `embedding`
+  query and an older box return none. `stackbone rag query --json` shows them,
+  the table output does not change, and Studio's search dialog labels a hit
+  `meaning`, `exact` or `both` (STA3-66).
+- **`rag.previousExchanges` sets how much of the call the knowledge search
+  reads.** A voice agent's knowledge search sends the last N exchanges of the
+  call (caller question and the reply they heard), oldest first, before the
+  caller's sentence. It takes 0 to 5 and defaults to 1, which sends the same
+  query as before; 0 searches the sentence alone. Studio's voice settings
+  override the code (STA3-76).
+
+### Changed
+
+- **A voice turn's knowledge search reads the previous exchange.** A follow-up
+  such as "¿y los plazos?" names nothing on its own, so the search now carries
+  the caller's previous searched question and the reply they heard, after the
+  output guardrails. A filler turn, or one that failed before speaking, keeps
+  the exchange that held the context (STA3-64).
+- **A voice agent with a knowledge collection only states facts it can
+  source.** Every turn of such a call adds a rule to the prompt: a price, date,
+  instalment, name or duration comes from the knowledge found for the turn, the
+  agent's instructions, a tool result, or an earlier fact of the call the
+  caller said or the agent sourced; otherwise the agent tells the caller an
+  advisor will confirm it. The rule
+  applies even when the search found nothing, and a turn resumed after a tool
+  approval keeps it, whether decided in Studio, by the timeout sweep or after a
+  box restart. A call without a collection sends the same prompt as before
+  (STA3-64).
+- **Voice knowledge search fetches 5 passages by default instead of 3.** At 3,
+  a question that asks two things often found the answer to only one
+  (STA3-72).
+- **Phone callers get LiveKit's telephony noise model.** Their audio is 8 kHz,
+  and the full-band model muffled it and held turns back. With Deepgram Flux
+  deciding the turn, the worker now reports how long Flux's decision took to
+  reach it as the end of turn, which LiveKit reports as 0 (STA3-56).
+
+### Fixed
+
+- **A reply blocked by an output guardrail on a voice call speaks the refusal
+  phrase.** The caller used to hear the guardrail's reason read aloud. The
+  call's `refusalPhrase`, the same one an input guardrail speaks, now replaces
+  it; text chat and the run's step keep the reason. A resume with no live call
+  keeps the reason, since nobody hears it (STA3-59).
+
+## [0.7.1] - 2026-11-04
+
+### Added
+
+- `stackbone rag ingest --metadata '<json object>'` sets document values, and
+  `stackbone rag query --filter '<json object>' --ranges '<json array>'` filters
+  retrieval by containment and number/date bounds. Invalid flags fail locally
+  with a suggestion before file reads or requests (STA3-61).
+
+- **`stackbone rag collections create <name> --hybrid`: hybrid search for codes
+  and names.** A hybrid collection answers a text query with a search by
+  meaning and a search for the exact terms of the query, merged by reciprocal
+  rank fusion, so a product code such as `1239asd/OK` finds its product.
+  `--number-format eu|us` sets how the collection reads prices and dates
+  (`eu` by default). An unknown format fails before the request.
+  `stackbone rag query --no-hybrid` searches by meaning only, and with `--json`
+  each hit of a hybrid query carries `mixed_score` next to `score`, which stays
+  the similarity by meaning. A create without the flags sends the same request
+  as before, so an older box still accepts it (STA3-57).
+- **Hybrid search in the box.** `POST /api/rag/collections` accepts
+  `hybrid_enabled` and `number_format`, `GET /api/rag/collections` returns them,
+  and `POST /api/rag/collections/{name}/query` takes `hybrid: false` and returns
+  `mixed_score` on a hybrid search. Migration 0116 adds the columns and the
+  index; hybrid stays off on every existing collection. Studio's new-collection
+  dialog gets a **Hybrid search** toggle and a **Number and date format**
+  select, and says when a box ignored them (STA3-57).
+- **`stackbone rag collections update <name>`: change hybrid search on an
+  existing collection.** `--hybrid` or `--no-hybrid` turns it on or off and
+  `--number-format eu|us` changes the format; a flag left out keeps its value,
+  and a command with none fails before the request. The command prints
+  `Rebuilding collection <name>…` on stderr, waits for the box, and fails when
+  the answer does not confirm the settings sent. A box older than the command
+  answers exit `4` with "update the box" (STA3-57).
+- **Changing hybrid search in the box.** `PATCH /api/rag/collections/{name}`
+  takes `hybrid_enabled`, `number_format` or both. The collection pauses as
+  `rebuilding`, so searches and ingests into it answer 409
+  `rag_collection_unavailable`, while the box recomputes every chunk's exact
+  terms from its stored text, with no embedding call; turning hybrid off clears
+  them. It answers 200 with the settings once the collection is ready, 409 while
+  an embedding rebuild or another change holds it, and 500 when the recompute
+  fails, which leaves the collection failed until the same change is sent
+  again. An embedding rebuild of a hybrid collection now keeps the exact terms.
+  Studio's collection screen gets **Edit search settings**, which shows the
+  collection rebuilding until the box answers (STA3-57).
+- **Hybrid search reads prices and dates by the collection's number format.**
+  On an `eu` collection, `1250 euros` finds `1.250,00 €`,
+  `3 de noviembre de 2026` finds `03/11/2026`, and `3 de noviembre` finds it in
+  any year. On `us`, `03/11/2026` is March 11 and `1,250.00 €` is the amount.
+  Dates with a Spanish or English month name read the same in both formats,
+  and the euro is the only currency read. A number format change with
+  `rag collections update --number-format` now changes which chunks a date or
+  a price finds. A hybrid collection indexed before this release keeps its old
+  exact terms until its search settings are saved again
+  (`rag collections update` with its current settings, or Save in Studio) or
+  its embeddings are rebuilt (STA3-57).
+
+### Changed
+
+- **Connector credentials from before CLI 0.6.1 must be reconnected.**
+  `stackbone dev` no longer moves grants written under the old shared dev key
+  onto the box's own key; it removes them at boot and Studio asks to reconnect
+  them. A box with neither its own Connect keys nor an install identity now
+  refuses to boot (STA3-43).
+
 ## [0.7.0] - 2026-10-30
 
 ### Added