Compare commits

...
Author SHA1 Message Date
Nicolò Boschi 86a03f6319 doc: 0.4.14 2026-02-27 15:33:57 +01:00
5 changed files with 142 additions and 21 deletions
@@ -17,16 +17,6 @@ Hindsight 0.4.11 focuses on production-ready deployments with improved flexibili
- [**MCP Mental Models**](#mcp-mental-models): Full lifecycle management via Model Context Protocol.
- [**Documentation Skill**](#documentation-skill): Build documentation-aware assistants.
## Upgrade Today
```bash
# Docker
docker pull ghcr.io/vectorize-io/hindsight:0.4.11
# Python SDK
pip install --upgrade hindsight-sdk
```
## Hierarchical Configuration
You can now customize operational settings per memory bank. Configure retention behavior, extraction modes, and custom instructions for each bank independently.
@@ -15,16 +15,6 @@ Hindsight 0.4.12 expands what you can ingest, cuts ingestion costs, and broadens
- [**Go Client SDK**](#go-client-sdk): Idiomatic Go client with functional options and full API coverage.
- [**DiskANN Vector Indexing**](#diskann-vector-indexing): pgvectorscale and Azure pg_diskann support for large-scale deployments.
## Upgrade Today
```bash
# Docker
docker pull ghcr.io/vectorize-io/hindsight:0.4.12
# Python SDK
pip install --upgrade hindsight-sdk
```
## File Ingestion
Hindsight can now retain PDFs, images, and common Office documents (DOCX, PPTX, XLSX) directly—without you needing to extract text first.
+1 -1
View File
@@ -7,7 +7,7 @@ image: /img/blog/vercel-chat.png
---
![Consolidation Pipeline](/img/blog/vercel-chat.png)
![`@vectorize-io/hindsight-chat` adds persistent memory with one wrapper function](/img/blog/vercel-chat.png)
## TL;DR
@@ -0,0 +1,141 @@
---
title: "What's new in Hindsight 0.4.13 and 0.4.14"
description: New features and improvements in Hindsight 0.4.13 and 0.4.14
authors: [hindsight]
date: 2026-02-27
hide_table_of_contents: true
---
Hindsight 0.4.13 and 0.4.14 add Chat SDK support, CrewAI integration, configurable MCP tools, graph retrieval tag filtering, and a new reranker provider—plus a set of reliability and performance improvements across the board.
<!-- truncate -->
- [**Model Leaderboard**](#model-leaderboard): See how every supported LLM ranks for retain and reflect across accuracy, speed, and cost.
- [**Chat SDK Integration**](#chat-sdk-integration): Give chatbots persistent memory with a single SDK.
- [**CrewAI Integration**](#crewai-integration): Add long-term memory to CrewAI agents.
- [**Configurable MCP Tools**](#configurable-mcp-tools): Choose which MCP tools are exposed per memory bank.
- [**Batch Observations Consolidation**](#batch-observations-consolidation): Process multiple observations more efficiently in a single pass.
- [**ZeroEntropy Reranker**](#zeroentropy-reranker): New reranker provider option for improved recall quality.
- [**Observation Source Facts**](#observation-source-facts): Recalled observations now include the underlying facts they were derived from.
## Model Leaderboard
We launched a public [Model Leaderboard](https://benchmarks.hindsight.vectorize.io/) that ranks every supported LLM on both the `retain` and `reflect` operations—measuring fact extraction quality, speed, and cost side by side. Whether you're optimizing for accuracy or trying to cut inference costs, the leaderboard gives you real data to pick the right model for your workload.
![Hindsight Model Leaderboard](/img/blog/release-0414/leaderboard.png)
## Chat SDK Integration
Hindsight now integrates with the [AI SDK](https://sdk.vercel.ai/) `useChat` hook, making it straightforward to give any chatbot persistent memory across sessions.
```typescript
import { useChat } from "ai/react";
import { createHindsightMiddleware } from "hindsight-sdk/chat";
const { messages, input, handleSubmit } = useChat({
middleware: createHindsightMiddleware({
bankId: "user-123",
serverUrl: "http://localhost:8888",
}),
});
```
The middleware transparently retains conversation turns and injects recalled context into each request—no changes needed to your existing chat route or LLM calls.
See the [Chat SDK documentation](/sdks/integrations/chat) for configuration options and a full quickstart.
## CrewAI Integration
CrewAI agents can now use Hindsight as a persistent memory backend. The integration plugs into CrewAI's memory interface and routes storage and retrieval through a Hindsight bank.
```python
from crewai import Agent, Crew
from hindsight_integrations.crewai import HindsightMemory
crew = Crew(
agents=[...],
tasks=[...],
memory=True,
memory_config={
"provider": "hindsight",
"config": {
"bank_id": "my-crew",
"server_url": "http://localhost:8888",
},
},
)
```
This gives CrewAI agents access to the full Hindsight retrieval stack—semantic search, BM25, graph traversal, and reranking—rather than the default in-process storage.
See the [CrewAI integration documentation](/sdks/integrations/crewai) for details.
## Configurable MCP Tools
You can now configure which MCP tools are exposed for each memory bank. Previously, all tools were always available; now you can restrict the tool set to match exactly what an agent or user should be able to do.
```bash
export HINDSIGHT_API_MCP_ENABLED_TOOLS="recall,retain"
```
This release also expands the MCP tool set with additional tools and new parameters on existing tools, giving MCP clients more control over memory operations without needing a custom API integration.
## Batch Observations Consolidation
Observation consolidation now processes multiple observations in a single batched pass instead of individually. This reduces LLM call overhead when a retain operation triggers consolidation across several entities. In our testing, this resulted in a **10x speed improvement** for consolidation-heavy workloads.
No configuration is required—the improvement applies automatically when observations are consolidated after ingestion.
## ZeroEntropy Reranker
[ZeroEntropy](https://zeroentropy.dev/) is now available as a reranker provider. It joins the existing options (local cross-encoder, TEI) for reranking recalled results.
```bash
export HINDSIGHT_API_RERANKER_PROVIDER=zeroentropy
export HINDSIGHT_API_ZEROENTROPY_API_KEY=your-key
```
## Observation Source Facts
When recalling observations, the response now includes the source facts that the observation was derived from. This makes it easier to trace why an observation was formed and to verify its provenance.
```python
results = client.recall(bank_id="my-bank", query="user preferences")
for result in results:
if result.type == "observation":
print(result.text)
for fact in result.source_facts:
print(" -", fact.text)
```
## Other Updates
**0.4.14**
- **Bank configuration API enabled by default**: The per-bank config API is now on by default; set `HINDSIGHT_API_ENABLE_BANK_CONFIG_API=false` to disable it.
- **OpenClaw**: Added options to toggle `autoRecall` and exclude specific LLM providers. Fixed health checks to correctly pass the auth token.
- **Reflect and retain customization**: Increased configuration options for reflect, retain, and consolidation behavior.
- **Source document metadata**: Fact extraction results now include source document metadata.
- **Embedding dimension validation**: A clear error is raised when embedding dimensions exceed pgvector HNSW limits, instead of failing at runtime.
- **Multi-tenant schema isolation**: Fixed isolation issues in storage and the bank config API.
- **Recall performance**: Reduced memory usage during retrieval.
**0.4.13**
- **Default OpenAI model**: Switched to `gpt-4o-mini` as the default OpenAI LLM, reducing costs for new deployments.
- **MCP compatibility**: Aligned the local MCP implementation with the server spec and removed the deprecated `stateless` parameter.
- **Docker named volumes**: Fixed startup failures when using named Docker volumes.
- **Reranker stability**: Prevented crashes when an upstream reranker provider returns an error.
- **Temporal ordering**: Improved accuracy of fact temporal ordering by reducing per-fact time offsets.
- **Document tracking**: Fixed documents not being tracked when fact extraction returns zero facts.
## Feedback and Community
Hindsight 0.4.13 and 0.4.14 are drop-in replacements for 0.4.x with no breaking changes.
Share your feedback:
- [GitHub Discussions](https://github.com/vectorize-io/hindsight/discussions)
- [GitHub Issues](https://github.com/vectorize-io/hindsight/issues)
For detailed changes, see the [full changelog](/changelog).
Binary file not shown.

After

Width:  |  Height:  |  Size: 348 KiB