Release v0.4.9

- Update version to 0.4.9 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-04 20:27:05 +01:00
parent 7e339e1677
commit 85b9074f43
101 changed files with 266 additions and 125 deletions

View file

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

View file

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

View file

@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "hindsight-api"
version = "0.4.8"
version = "0.4.9"
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.8"
version = "0.4.9"
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8\n"\
"Version of the API: 0.4.9\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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8
The version of the OpenAPI document: 0.4.9
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.8"
version = "0.4.9"
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.8",
"version": "0.4.9",
"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.8",
"version": "0.4.9",
"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.8"
version = "0.4.9"
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.8"
"version": "0.4.9"
},
"paths": {
"/health": {

View file

@ -230,21 +230,6 @@ rm ~/.hindsight/embed
hindsight-embed configure
```
## Advanced Configuration
While `hindsight-embed` aims to be zero-config, you can customize the underlying API behavior by setting `HINDSIGHT_API_*` variables in `~/.hindsight/embed`:
```bash
# Example: Custom embedding model
HINDSIGHT_API_EMBEDDINGS_PROVIDER=openai
HINDSIGHT_API_EMBEDDINGS_OPENAI_MODEL=text-embedding-3-large
# Example: Verbose extraction
HINDSIGHT_API_RETAIN_EXTRACTION_MODE=verbose
```
See [Configuration](/developer/configuration) for all available `HINDSIGHT_API_*` options.
## When to Use
**Perfect for:**

View file

@ -125,16 +125,70 @@ export HINDSIGHT_API_LLM_BASE_URL=https://openrouter.ai/api/v1
### External API (Advanced)
To use an existing Hindsight API server instead of the local daemon:
Connect to a remote Hindsight API server instead of running a local daemon. This is useful for:
- **Shared memory** across multiple OpenClaw instances
- **Production deployments** with centralized memory storage
- **Team environments** where agents share knowledge
#### Plugin Configuration
Configure in `~/.openclaw/openclaw.json`:
```json
{
"plugins": {
"entries": {
"hindsight-openclaw": {
"enabled": true,
"config": {
"hindsightApiUrl": "https://your-hindsight-server.com",
"hindsightApiToken": "your-api-token"
}
}
}
}
}
```
**Options:**
- `hindsightApiUrl` - Full URL to external Hindsight API (e.g., `https://mcp.hindsight.example.com`)
- `hindsightApiToken` - API token for authentication (optional, only if API requires auth)
#### Environment Variables (Alternative)
You can also configure via environment variables:
```bash
export HINDSIGHT_EMBED_API_URL=http://your-server:8000
export HINDSIGHT_EMBED_API_TOKEN=your-api-token # Optional, if API requires auth
export HINDSIGHT_EMBED_API_URL=https://your-hindsight-server.com
export HINDSIGHT_EMBED_API_TOKEN=your-api-token # Optional
openclaw gateway
```
Useful for shared memory across multiple OpenClaw instances or production deployments.
**Note:** Plugin config takes precedence over environment variables.
#### Behavior
When external API mode is enabled:
- **No local daemon** is started (no hindsight-embed process)
- **Health check** runs on startup to verify API connectivity
- **All memory operations** (retain, recall, reflect) go to the external API
- **Faster startup** since no local PostgreSQL or embedding models are needed
#### Verification
Check OpenClaw logs for external API mode:
```bash
tail -f /tmp/openclaw/openclaw-*.log | grep Hindsight
# Should see on startup:
# [Hindsight] External API mode enabled: https://your-hindsight-server.com
# [Hindsight] External API health check passed
```
If you see daemon startup messages instead, verify your configuration is correct.
## Inspecting Memories

View file

@ -85,17 +85,119 @@ print(answer.text)
</TabItem>
</Tabs>
## Embedded Client (Easiest Option)
`HindsightEmbedded` provides the simplest way to use Hindsight in Python. It automatically manages a background server for you - no manual setup required:
```python
from hindsight import HindsightEmbedded
import os
# Server starts automatically on first use
client = HindsightEmbedded(
profile="myapp", # Profile for data isolation
llm_provider="openai",
llm_model="gpt-4o-mini",
llm_api_key=os.environ["OPENAI_API_KEY"],
)
# Use immediately - no manual server management needed
client.retain(bank_id="my-bank", content="Alice works at Google")
results = client.recall(bank_id="my-bank", query="What does Alice do?")
# Server continues running (auto-stops after idle timeout)
# Or explicitly stop it:
client.close(stop_daemon=True)
```
**What's a Profile?**
A profile is an isolated Hindsight environment. Each profile gets its own PostgreSQL database (stored in `~/.pg0/instances/hindsight-embed-{profile}/`) and its own API server. Use different profiles to separate environments (dev/prod), applications, or users.
**When to Use HindsightEmbedded**
Use `HindsightEmbedded` when you want the server to start automatically and manage itself. Use `HindsightServer` when you need explicit control over server lifecycle (e.g., testing where you want immediate startup/shutdown).
**Advanced Operations**
`HindsightEmbedded` provides organized API namespaces for advanced operations. Each method call automatically ensures the daemon is running:
```python
from hindsight import HindsightEmbedded
import os
embedded = HindsightEmbedded(
profile="myapp",
llm_provider="openai",
llm_api_key=os.environ["OPENAI_API_KEY"],
)
# Core operations (automatically proxied)
embedded.retain(bank_id="test", content="Hello")
results = embedded.recall(bank_id="test", query="Hello")
# Bank management
embedded.banks.create(bank_id="test", name="Test Bank", mission="Help users")
embedded.banks.set_mission(bank_id="test", mission="Updated mission")
embedded.banks.delete(bank_id="test")
# Mental models
embedded.mental_models.create(
bank_id="test",
name="User Preferences",
content="User prefers dark mode"
)
models = embedded.mental_models.list(bank_id="test")
embedded.mental_models.update(bank_id="test", mental_model_id="...", content="New content")
# Directives
embedded.directives.create(
bank_id="test",
name="Response Style",
content="Be concise and friendly"
)
directives = embedded.directives.list(bank_id="test")
# List memories
memories = embedded.memories.list(bank_id="test", type="world", limit=50)
```
**Why Use API Namespaces?**
API namespaces (`banks`, `mental_models`, `directives`, `memories`) ensure the daemon is running before each call. This handles daemon crashes gracefully:
```python
# ✅ GOOD - Uses API namespace (daemon restarts handled)
embedded.banks.create(bank_id="test", name="Test")
# ❌ BAD - Direct client access (daemon crashes NOT handled)
client = embedded.client
client.create_bank(bank_id="test", name="Test") # Fails if daemon crashed
```
## Client Initialization
```python
from hindsight_client import Hindsight
from hindsight import HindsightClient
client = Hindsight(
client = HindsightClient(
base_url="http://localhost:8888", # Hindsight API URL
timeout=30.0, # Request timeout in seconds
)
# Core operations
client.retain(bank_id="test", content="Hello world")
results = client.recall(bank_id="test", query="Hello")
# Organized API access (same as HindsightEmbedded)
client.banks.create(bank_id="test", name="Test Bank")
models = client.mental_models.list(bank_id="test")
directives = client.directives.list(bank_id="test")
memories = client.memories.list(bank_id="test")
```
Both `HindsightClient` and `HindsightEmbedded` provide the same organized API namespaces (`banks`, `mental_models`, `directives`, `memories`) for consistent developer experience.
## Core Operations
### Retain (Store Memory)

View file

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

View file

@ -4,7 +4,7 @@ build-backend = "hatchling.build"
[project]
name = "hindsight-embed"
version = "0.4.8"
version = "0.4.9"
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.8",
"version": "0.4.9",
"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.8"
version = "0.4.9"
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.8",
"version": "0.4.9",
"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.8"
version = "0.4.9"
description = "Hindsight: Agent Memory That Works Like Human Memory - All-in-One Bundle"
readme = "README.md"
requires-python = ">=3.11"

Some files were not shown because too many files have changed in this diff Show more