Repository navigation
Ragbot 4.0.0
Ragbot moves every dependency, runtime and model to its latest release. Backward
compatibility with superseded models, runtimes and SDK versions is not kept.
Changed
-
Models.
engines.yamlcarries only current models, verified against provider
documentation on 2026-11-06 (docs/model-catalog-2026-11-06.yaml):- OpenAI: GPT-6 Astra, GPT-6.1 Sol (default), GPT-6.1 Terra, GPT-6 Luna.
- Anthropic: Claude Fable 5.1, Opus 5.5, Sonnet 5.5 (default), Haiku 5.5.
- Google: Gemini 4 Argon, 3.8 Flash (default), 3.5 Flash-Lite.
- Local (Ollama): Gemma 4 (E4B, 12B, 26B, 31B), Qwen3.8 27B, the Qwen3.8 Flash-Next
preview, Muse Glimmer 30B, Nemotron 3.5 Super, Mistral Medium 3.5.
Every cloud model has a strict request contract. Superseded models are removed,
includinggemini-3.1-flash-lite-preview, which Google shut down on 2026-05-25, and
three local tags Ollama no longer serves locally. -
Embedding model. RAG embeds with Microsoft's
harrier-oss-v1-0.6b(MIT licence,
1,024 dimensions, 32K-token context) in place of all-MiniLM-L6-v2 (384 dimensions,
256 tokens).engines.yaml'sembedding:block is now the only place the model is set,
with a pinned Hugging Face revision; theEMBEDDING_MODELenvironment override is gone.- Queries carry the model's retrieval instruction (
web_search_query); documents carry
none. - Indexing embeds chunks in batches instead of one model call per chunk.
- Migration
0004_embedding_dimensions.sqlmoves both vector columns to 1,024
dimensions. It clears the chunk index and entity embeddings (entities are kept), so
every workspace needsragbot index --workspace <name> --forceafter upgrading. - The vector store reads its schema dimension and refuses to index or search with
vectors of another size;ragbot db initandragbot db statusreport it. - The API container keeps downloaded models in a
ragbot-hf-cachevolume. - The model needs about 4.2 GB while loading in float32. Docker Desktop's default 4 GB
is not enough; allow it at least 8 GB.
- Queries carry the model's retrieval instruction (
-
MCP SDK 2.x (#157). The client primitives, tasks, transports, OAuth callback, proxy
and Ragbot's MCP server are ported to mcp 2.3.0. -
Runtimes and images.
- Python 3.14 in CI and the backend image, which no longer installs a compiler.
- The backend image installs CPU-only torch from PyTorch's index. PyPI's Linux wheels are
the CUDA builds, which added 4.2 GB of GPU libraries to an image with no GPU to use;
the build now also runspip check. - Node 26 (active LTS) in CI and the web image.
- PostgreSQL 18 with pgvector 0.8.7 on a new volume;
scripts/migrate-postgres-16-to-18.shcopies an existing database across. - Jaeger v2.
-
Python packages. Every floor is raised to the latest release; openai 3.x is allowed now
that LiteLLM 1.108+ accepts it;google-generativeai(end of life) is removed, freeing
protobuf 7;appdirsis replaced byplatformdirs. -
Web packages. Every package is on its latest release (Next.js 16.4.5, React 19.3.1,
jsdom 31). TypeScript stays on 6.0 because typescript-eslint does not yet accept 7. -
Request handling.
- Anthropic requests never carry sampling parameters, and effort travels in
output_config. - Gemini thinking is set by level, never by budget.
- OpenAI requests use
max_completion_tokens.
The Claude version heuristics for superseded models are gone.
- Anthropic requests never carry sampling parameters, and effort travels in
-
Defaults come from
engines.yaml. The chat API default, the memory consolidator, cross-workspace synthesis and the eval runner no longer name models in code.
Fixed
- A reasoning model that spent its whole output budget thinking returned an empty reply with
no error. Every backend now raisesOutputBudgetExhaustedError, which names the budget
and says to raisemax_tokensor lower the thinking effort; a partial reply is still
returned. - A streamed chat that failed simply ended: the streaming thread dropped its exception.
chat_streamnow re-raises it asChatError, which the web UI shows. local_onlyand downgrade-to-local workspace policies recognised no configured local
model and suggested models that did not exist. Local models are now thoseengines.yaml
serves through Ollama, and Ollama:cloudtags are never treated as local.- The agent loop read an attribute mcp 2.x no longer has, which would have passed MCP tool
errors through as successful output. - The MCP server's HTTP transport resolves bearer tokens from the request it serves,
starts its session manager through the ASGI lifespan, and fails closed. - The OAuth callback page escaped nothing in its error message.
npm auditreports 0 vulnerabilities, down from 22 (1 critical), and CI now runs
next build.
Security
- Next.js advisories covering 16.0.0–16.4.0 (two unauthenticated remote code execution
issues among them) are resolved. Transitive advisories (sharp, brace-expansion,
minimatch, postcss-selector-parser, vite, zod, undici) are cleared by overrides and
lockfile updates. - 13 CVEs in
filelock3.32.7 are resolved:filelock4.2.9 installs. Every stable
LiteLLM release from 1.104.0 through 1.108.1 caps it below 4, so the LiteLLM floor is
the 1.109.0 release candidate, the first that accepts it; pip moves to 1.109.0 on its
own once that ships.pip-auditreports no known vulnerabilities. See
docs/security/dependabot-triage-2026-11.md.