Release v0.4.10

- Update version to 0.4.10 in all components
- Regenerate OpenAPI spec and client SDKs
- Python packages: hindsight-api, hindsight-dev, hindsight-all, hindsight-litellm, hindsight-embed
- Python client: hindsight-clients/python
- TypeScript client: hindsight-clients/typescript
- Rust CLI: hindsight-cli
- Control Plane: hindsight-control-plane
- OpenClaw integration: hindsight-integrations/openclaw
- AI SDK integration: hindsight-integrations/ai-sdk
- Helm chart
- Sync documentation to version-0.4
This commit is contained in:
Nicolò Boschi 2026-02-09 11:44:20 +01:00
parent a3a9d7b37d
commit 08f1cda3bf
100 changed files with 2977 additions and 2900 deletions

View file

@ -2,8 +2,8 @@ apiVersion: v2
name: hindsight
description: Hindsight helm chart
type: application
version: 0.4.9
appVersion: "0.4.9"
version: 0.4.10
appVersion: "0.4.10"
keywords:
- ai
- memory

View file

@ -46,4 +46,4 @@ __all__ = [
"RemoteTEICrossEncoder",
"LLMConfig",
]
__version__ = "0.4.9"
__version__ = "0.4.10"

View file

@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "hindsight-api"
version = "0.4.9"
version = "0.4.10"
description = "Hindsight: Agent Memory That Works Like Human Memory"
readme = "README.md"
requires-python = ">=3.11"

View file

@ -1,6 +1,6 @@
[package]
name = "hindsight-cli"
version = "0.4.9"
version = "0.4.10"
edition = "2021"
authors = ["Hindsight Team"]
description = "A beautiful CLI for Hindsight - semantic memory system"

View file

@ -7,7 +7,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.
@ -489,7 +489,7 @@ class Configuration:
return "Python SDK Debug Report:\n"\
"OS: {env}\n"\
"Python Version: {pyversion}\n"\
"Version of the API: 0.4.9\n"\
"Version of the API: 0.4.10\n"\
"SDK Package Version: 0.0.7".\
format(env=sys.platform, pyversion=sys.version)

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -6,7 +6,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -5,7 +5,7 @@
HTTP API for Hindsight
The version of the OpenAPI document: 0.4.9
The version of the OpenAPI document: 0.4.10
Generated by OpenAPI Generator (https://openapi-generator.tech)
Do not edit the class manually.

View file

@ -1,6 +1,6 @@
[project]
name = "hindsight-client"
version = "0.4.9"
version = "0.4.10"
description = "Python client for Hindsight - Semantic memory system with personality-driven thinking"
authors = [
{name = "Hindsight Team"}

View file

@ -1,6 +1,6 @@
{
"name": "@vectorize-io/hindsight-client",
"version": "0.4.9",
"version": "0.4.10",
"description": "TypeScript client for Hindsight - Semantic memory system with personality-driven thinking",
"main": "./dist/src/index.js",
"types": "./dist/src/index.d.ts",

View file

@ -1,6 +1,6 @@
{
"name": "@vectorize-io/hindsight-control-plane",
"version": "0.4.9",
"version": "0.4.10",
"description": "Control plane for Hindsight - Semantic memory system",
"bin": {
"hindsight-control-plane": "./bin/cli.js"

View file

@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "hindsight-dev"
version = "0.4.9"
version = "0.4.10"
description = "Development utilities for Hindsight"
requires-python = ">=3.11"
dependencies = [

View file

@ -10,7 +10,7 @@
"name": "Apache 2.0",
"url": "https://www.apache.org/licenses/LICENSE-2.0.html"
},
"version": "0.4.9"
"version": "0.4.10"
},
"paths": {
"/health": {

View file

@ -19,7 +19,20 @@ HINDSIGHT_API_TENANT_EXTENSION=hindsight_api.extensions.builtin.tenant:ApiKeyTen
HINDSIGHT_API_TENANT_API_KEY=your-secret-key
```
For multi-tenant setups with separate schemas per tenant (e.g., JWT-based auth with per-tenant schemas), implement a custom `TenantExtension`.
**Built-in: SupabaseTenantExtension**
Validates [Supabase](https://supabase.com) JWTs and provides multi-tenant memory isolation. Each authenticated user gets their own PostgreSQL schema (`{prefix}_{user_id}`), ensuring complete data separation. Performs local JWT verification using JWKS for optimal performance (no network call per request).
```bash
HINDSIGHT_API_TENANT_EXTENSION=hindsight_api.extensions.builtin.supabase_tenant:SupabaseTenantExtension
HINDSIGHT_API_TENANT_SUPABASE_URL=https://your-project.supabase.co
# Optional - only needed for legacy HS256 projects or health check
HINDSIGHT_API_TENANT_SUPABASE_SERVICE_KEY=your-service-role-key
```
See the [source code](https://github.com/vectorize-io/hindsight/blob/main/hindsight-api/hindsight_api/extensions/builtin/supabase_tenant.py) for complete configuration options and implementation details.
For other multi-tenant setups with separate schemas per tenant (e.g., custom JWT-based auth), implement a custom `TenantExtension`.
---
@ -51,6 +64,18 @@ HINDSIGHT_API_OPERATION_VALIDATOR_EXTENSION=mypackage.validators:MyValidator
---
### MCPExtension
Registers additional MCP (Model Context Protocol) tools on the Hindsight MCP server. Enables external packages to add custom tools without modifying core code.
**No built-in implementation** - implement your own to add custom MCP tools.
```bash
HINDSIGHT_API_MCP_EXTENSION=mypackage.mcp:MyMCPExtension
```
---
## Writing Custom Extensions
### Extension Basics
@ -161,6 +186,24 @@ class MyValidator(OperationValidatorExtension):
pass
```
### Example: Custom MCPExtension
```python
from mcp.server.fastmcp import FastMCP
from hindsight_api.extensions import MCPExtension
from hindsight_api.engine import MemoryEngine
class MyMCPExtension(MCPExtension):
async def register_tools(self, mcp: FastMCP, memory: MemoryEngine) -> None:
@mcp.tool()
async def custom_search(query: str) -> str:
"""Custom MCP tool for specialized search."""
# Access memory engine for operations
pool = await memory._get_pool()
# ... custom logic
return f"Results for: {query}"
```
---
## Deploying Custom Extensions

View file

@ -27,44 +27,62 @@ export HINDSIGHT_API_MCP_ENABLED=false
## Authentication
By default, the MCP endpoint is **open** for local development. For production deployments, enable authentication with a Bearer token:
By default, the MCP endpoint is **open** (no authentication required).
To enable authentication, configure the API key tenant extension:
```bash
export HINDSIGHT_API_MCP_AUTH_TOKEN=your-secret-token
export HINDSIGHT_API_TENANT_EXTENSION=hindsight_api.extensions.builtin.tenant:ApiKeyTenantExtension
export HINDSIGHT_API_TENANT_API_KEY=your-secret-key
```
When authentication is enabled, all MCP requests must include a valid `Authorization` header:
When authentication is enabled, include your API key in the `Authorization` header:
### Claude Code
```bash
claude mcp add --transport http hindsight http://localhost:8888/mcp \
--header "Authorization: Bearer your-secret-key" \
--header "X-Bank-Id: my-bank"
```
### Claude Desktop
Add to `~/.claude_desktop_config.json`:
**Claude Desktop config** (`.claude_desktop_config.json`):
```json
{
"mcpServers": {
"hindsight": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-http-client", "http://localhost:8888/mcp/alice/"],
"env": {
"HTTP_HEADERS": "{\"Authorization\": \"Bearer your-secret-token\"}"
"url": "http://localhost:8888/mcp",
"headers": {
"Authorization": "Bearer your-secret-key",
"X-Bank-Id": "my-bank"
}
}
}
}
```
**Claude Code config:**
```bash
claude mcp add --transport http hindsight http://localhost:8888/mcp/alice/ \
--header "Authorization: Bearer your-secret-token"
```
### Direct HTTP Request
**Direct HTTP request:**
```bash
curl -X POST http://localhost:8888/mcp/alice/ \
-H "Authorization: Bearer your-secret-token" \
curl -X POST http://localhost:8888/mcp \
-H "Authorization: Bearer your-secret-key" \
-H "X-Bank-Id: my-bank" \
-H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'
```
If the token is missing or invalid, requests will receive a `401 Unauthorized` response.
If the key is missing or invalid, requests will receive a `401 Unauthorized` response.
## Bank Selection
Specify the memory bank via:
1. **X-Bank-Id header** (recommended): `--header "X-Bank-Id: my-bank"`
2. **URL path**: `http://localhost:8888/mcp/my-bank/`
3. **Default**: Uses `HINDSIGHT_MCP_BANK_ID` env var (default: "default")
## Per-Bank Endpoints
@ -149,22 +167,38 @@ Search memories to provide personalized responses.
---
## Integration with AI Assistants
### reflect
The MCP server can be used with any MCP-compatible AI assistant.
Generate thoughtful analysis by synthesizing stored memories with the bank's personality.
### Claude Desktop Configuration
To connect Claude Desktop to a specific memory bank:
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | The question or topic to reflect on |
| `context` | string | No | Optional context about why this reflection is needed |
| `budget` | string | No | Search budget: `low`, `mid`, or `high` (default: `low`) |
**Example:**
```json
{
"mcpServers": {
"hindsight-alice": {
"url": "http://localhost:8888/mcp/alice/"
}
"name": "reflect",
"arguments": {
"query": "Based on my past decisions, what architectural style do I prefer?",
"budget": "mid"
}
}
```
Each user can have their own MCP server configuration pointing to their personal memory bank.
**When to use:**
- When reasoned analysis is needed, not just fact retrieval
- Questions like "What should I do?" rather than "What did I say?"
- Synthesizing patterns across multiple memories
---
## Integration with AI Assistants
The MCP server can be used with any MCP-compatible AI assistant. See the [Authentication](#authentication) section above for Claude Code and Claude Desktop configuration examples.
Each user can have their own configuration pointing to their personal memory bank using either:
- The `X-Bank-Id` header (recommended)
- A bank-specific URL path like `/mcp/alice/`

View file

@ -3,7 +3,7 @@
from .daemon_embed_manager import DaemonEmbedManager
from .embed_manager import EmbedManager
__version__ = "0.4.9"
__version__ = "0.4.10"
__all__ = [
"EmbedManager",

View file

@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "hindsight-embed"
version = "0.4.9"
version = "0.4.10"
description = "Hindsight embedded CLI - local memory operations without a server"
readme = "README.md"
requires-python = ">=3.11"

View file

@ -1,6 +1,6 @@
{
"name": "@vectorize-io/hindsight-ai-sdk",
"version": "0.4.9",
"version": "0.4.10",
"description": "Hindsight memory integration for Vercel AI SDK - Give your AI agents persistent, human-like memory",
"main": "dist/index.js",
"types": "dist/index.d.ts",

View file

@ -1,6 +1,6 @@
[project]
name = "hindsight-litellm"
version = "0.4.9"
version = "0.4.10"
description = "Universal LLM memory integration via LiteLLM - works with 100+ providers"
readme = "README.md"
requires-python = ">=3.10"

View file

@ -1,6 +1,6 @@
{
"name": "@vectorize-io/hindsight-openclaw",
"version": "0.4.9",
"version": "0.4.10",
"description": "Hindsight memory plugin for OpenClaw - biomimetic long-term memory with fact extraction",
"main": "dist/index.js",
"types": "dist/index.d.ts",

View file

@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "hindsight-all"
version = "0.4.9"
version = "0.4.10"
description = "Hindsight: Agent Memory That Works Like Human Memory - All-in-One Bundle"
readme = "README.md"
requires-python = ">=3.11"

5546
uv.lock

File diff suppressed because it is too large Load diff