Changelog

Breaking Changes

Embedding failures are surfaced, not masked. Ingestion now reports embedding failures instead of returning success. Content that previously showed completed may now show failed or partial — those ingests were always incomplete, they were only reported as successful. The ContentStatus enum in the API (/openapi.json) gains partial, changing from ["processing","completed","failed"] to ["processing","completed","partial","failed"]. No schema migration is required (the status column is already varchar).
Embedders raise EmbeddingError instead of returning an empty vector on failure. Calling a vector DB's search() directly now raises where it previously returned []; Knowledge.search() is unaffected and still returns no results.
AWS Bedrock embedding failures raise EmbeddingError, not ModelProviderError. Existing except ModelProviderError handlers around Bedrock embedding will stop catching — switch to except EmbeddingError.
GET /knowledge/content/{id}/status returns 404 for missing/non-owned content instead of 200 with status: "failed".
skip_if_exists=True no longer skips content recorded as failed or partial, so incomplete content is re-embedded rather than silently marked complete.

partial content status: new ContentStatus.PARTIAL for files where some chunks embedded and others did not — searchable but incomplete, so neither completed nor failed. (#9814)
Optional embedding retry during ingestion (off by default): enable with Knowledge(max_embedding_retries=3, embedding_retry_backoff=1.0). Authentication failures ignore both settings and fail on the first attempt (the same credential is rejected every time). Note: each retry re-embeds the whole document.
GandrTools: new text-to-speech toolkit for the Gandr TTS API.
llmman model provider: new model provider.

Actionable embedding failure messages: failure messages now name the chunk count, embedder, reason and recovery step, instead of "Could not insert embedding".
Re-ingest no longer destroys searchable chunks: an embed_before_replace guard embeds documents before deleting existing ones, so a failing re-ingest aborts before anything is removed (previously a failed re-embed could leave a document with zero chunks).
MCPTools accepts static headers=: connect-time auth headers can be passed directly on the url= path for Streamable HTTP and SSE, without constructing StreamableHTTPClientParams.

feat: add headers= argument to MCPTools for connect-time auth by @LHMQ878 in #9444
chore: re-enable litellm and crawl4ai extras by @RayST3 with @Copilot in #9868
feat: Add GandrTools text to speech toolkit for the Gandr TTS API by @AALG123 in #9852
[feat] Add llmman model provider by @ericcurtin in #9863
fix: repair broken cookbook models, imports, and image URL by @Himanshu040604 in #9889
fix: surface embedding failures during knowledge ingestion by @sannya-singal in #9814
chore: Release v3.0.5 by @kausmeows in #9888

Full Changelog: v3.0.4...v3.0.5