diff --git a/hindsight-docs/blog/2026-02-09-resolving-memory-conflicts.md b/hindsight-docs/blog/2026-02-09-resolving-memory-conflicts.md index 93d77dfd..30ef48c9 100644 --- a/hindsight-docs/blog/2026-02-09-resolving-memory-conflicts.md +++ b/hindsight-docs/blog/2026-02-09-resolving-memory-conflicts.md @@ -8,12 +8,14 @@ date: 2026-02-09 # How We Solved Memory Conflicts in Hindsight -One of the hardest problems we tackled in Hindsight was dealing with contradictions. When you're building a memory system for AI agents, reality isn't static. It evolves. +One of the hardest problems we tackled in Hindsight was dealing with contradictions. When you're building a memory system for AI agents, reality isn't static. It evolves. A CRM agent might learn that "Acme Corp is a key prospect" in January, then encounter "Acme Corp is now a paying customer" in March. Naive approaches either lose the history or drown in duplicate facts. We needed a system that could handle this gracefully. Here's how we built it. + + ## **The Core Problem: Facts vs. Knowledge** Early on, we made a distinction that shaped the way we store and receive memories: raw facts aren't the same as consolidated knowledge. Facts are immediate observations; what an agent learns in a single interaction. Knowledge is durable understanding extracted from those facts over time. diff --git a/hindsight-docs/blog/2026-02-13-version-0-4-11.md b/hindsight-docs/blog/2026-02-13-version-0-4-11.md index 1ac37111..daf10b08 100644 --- a/hindsight-docs/blog/2026-02-13-version-0-4-11.md +++ b/hindsight-docs/blog/2026-02-13-version-0-4-11.md @@ -7,6 +7,8 @@ date: 2026-02-13 Hindsight 0.4.11 focuses on production-ready deployments with improved flexibility and observability. + + - [**Hierarchical Configuration**](#hierarchical-configuration): Customize operational settings per memory bank. - [**LiteLLM SDK Integration**](#litellm-sdk-integration): Direct API access without proxy server. - [**Expanded Database Support**](#expanded-database-support): TimescaleDB pg_textsearch and additional Postgres extensions. @@ -14,8 +16,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 diff --git a/hindsight-docs/blog/2026-02-18-version-0-4-12.md b/hindsight-docs/blog/2026-02-18-version-0-4-12.md index c57b4fb6..6b99181d 100644 --- a/hindsight-docs/blog/2026-02-18-version-0-4-12.md +++ b/hindsight-docs/blog/2026-02-18-version-0-4-12.md @@ -7,13 +7,13 @@ date: 2026-02-18 Hindsight 0.4.12 expands what you can ingest, cuts ingestion costs, and broadens where you can run it. + + - [**File Ingestion**](#file-ingestion): Retain PDFs, images, and Office documents directly. - [**Batch API for Async Retain**](#batch-api-for-async-retain): Cut LLM ingestion costs by 50% using OpenAI and Groq Batch APIs. - [**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 diff --git a/hindsight-docs/docs/cookbook/index.mdx b/hindsight-docs/docs/cookbook/index.mdx index f6e63c5b..609488f6 100644 --- a/hindsight-docs/docs/cookbook/index.mdx +++ b/hindsight-docs/docs/cookbook/index.mdx @@ -15,8 +15,8 @@ import RecipeCarousel from '@site/src/components/RecipeCarousel'; Learn how to build with Hindsight through practical examples: -- **[Recipes](#recipes)** - Step-by-step guides and patterns for common use cases -- **[Applications](#applications)** - Complete, runnable applications demonstrating Hindsight integration +- **Recipes** - Step-by-step guides and patterns for common use cases +- **Applications** - Complete, runnable applications demonstrating Hindsight integration ` for per-user scoping, `session:` for session isolation, `room:` for chat rooms, `topic:` for category filtering. The bank also exposes a list-tags endpoint that returns all tags with their memory counts, useful for UI autocomplete or wildcard expansion. -See [Recall API](./recall#filter-by-tags) for filtering by tags during retrieval. +See [Recall API](./recall#tags) for filtering by tags during retrieval. ### Response diff --git a/hindsight-docs/docs/developer/installation.md b/hindsight-docs/docs/developer/installation.md index 7e870023..e30ba8be 100644 --- a/hindsight-docs/docs/developer/installation.md +++ b/hindsight-docs/docs/developer/installation.md @@ -107,7 +107,7 @@ Install it with: pip install sentence-transformers ``` ::: -See [Configuration](./configuration#embeddings-and-reranking) for all embedding provider options. +See [Configuration](./configuration#embeddings) for all embedding provider options. ### Available Tags diff --git a/hindsight-docs/examples/api/memory-banks.mjs b/hindsight-docs/examples/api/memory-banks.mjs index 5abdd9be..bf246186 100644 --- a/hindsight-docs/examples/api/memory-banks.mjs +++ b/hindsight-docs/examples/api/memory-banks.mjs @@ -32,6 +32,22 @@ await client.updateBankConfig('architect-bank', { // [/docs:bank-with-disposition] +// [docs:bank-background] +await client.createBank('my-bank'); +await client.updateBankConfig('my-bank', { + reflectMission: 'I am a research assistant specializing in machine learning.', +}); +// [/docs:bank-background] + + +// [docs:bank-mission] +await client.createBank('my-bank'); +await client.updateBankConfig('my-bank', { + reflectMission: "You're a senior software architect - keep track of system designs, technology decisions, and architectural patterns.", +}); +// [/docs:bank-mission] + + // [docs:update-bank-config] await client.updateBankConfig('my-bank', { retainMission: 'Always include technical decisions, API design choices, and architectural trade-offs. Ignore meeting logistics and social exchanges.', diff --git a/hindsight-docs/examples/api/memory-banks.py b/hindsight-docs/examples/api/memory-banks.py index d7688a34..da4866da 100644 --- a/hindsight-docs/examples/api/memory-banks.py +++ b/hindsight-docs/examples/api/memory-banks.py @@ -37,6 +37,35 @@ client.update_bank_config( # [/docs:bank-with-disposition] +# [docs:bank-background] +client.create_bank(bank_id="my-bank") +client.update_bank_config( + "my-bank", + reflect_mission="I am a research assistant specializing in machine learning.", +) +# [/docs:bank-background] + + +# [docs:bank-mission] +client.create_bank(bank_id="my-bank") +client.update_bank_config( + "my-bank", + reflect_mission="You're a senior software architect - keep track of system designs, " + "technology decisions, and architectural patterns.", +) +# [/docs:bank-mission] + + +# [docs:bank-support-agent] +client.create_bank(bank_id="support-bank") +client.update_bank_config( + "support-bank", + observations_mission="I am a customer support agent. Track customer preferences, " + "recurring issues, and resolution history to provide consistent, personalized support.", +) +# [/docs:bank-support-agent] + + # [docs:update-bank-config] client.update_bank_config( "my-bank", diff --git a/hindsight-docs/versioned_docs/version-0.4/cookbook/index.mdx b/hindsight-docs/versioned_docs/version-0.4/cookbook/index.mdx index f6e63c5b..609488f6 100644 --- a/hindsight-docs/versioned_docs/version-0.4/cookbook/index.mdx +++ b/hindsight-docs/versioned_docs/version-0.4/cookbook/index.mdx @@ -15,8 +15,8 @@ import RecipeCarousel from '@site/src/components/RecipeCarousel'; Learn how to build with Hindsight through practical examples: -- **[Recipes](#recipes)** - Step-by-step guides and patterns for common use cases -- **[Applications](#applications)** - Complete, runnable applications demonstrating Hindsight integration +- **Recipes** - Step-by-step guides and patterns for common use cases +- **Applications** - Complete, runnable applications demonstrating Hindsight integration ` for per-user scoping, `session:` for session isolation, `room:` for chat rooms, `topic:` for category filtering. The bank also exposes a list-tags endpoint that returns all tags with their memory counts, useful for UI autocomplete or wildcard expansion. -See [Recall API](./recall#filter-by-tags) for filtering by tags during retrieval. +See [Recall API](./recall#tags) for filtering by tags during retrieval. ### Response diff --git a/hindsight-docs/versioned_docs/version-0.4/developer/installation.md b/hindsight-docs/versioned_docs/version-0.4/developer/installation.md index 7e870023..e30ba8be 100644 --- a/hindsight-docs/versioned_docs/version-0.4/developer/installation.md +++ b/hindsight-docs/versioned_docs/version-0.4/developer/installation.md @@ -107,7 +107,7 @@ Install it with: pip install sentence-transformers ``` ::: -See [Configuration](./configuration#embeddings-and-reranking) for all embedding provider options. +See [Configuration](./configuration#embeddings) for all embedding provider options. ### Available Tags