holetron-lab/fleet-memory
1
0
Fork 0
Code Releases Packages Activity Actions

Release v0.4.8

Browse source 
- Update version to 0.4.8 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
- Helm chart
- Sync documentation to version-0.4
This commit is contained in:
Nicolò Boschi 2026-02-03 13:51:30 +01:00
parent 794a7435a9
commit 21b25fe8fe
100 changed files with 346 additions and 125 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
helm/hindsight/Chart.yaml
View file

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

2
hindsight-api/hindsight_api/__init__.py
View file

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

2
hindsight-api/pyproject.toml
View file

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

2
hindsight-cli/Cargo.toml
View file

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

2
hindsight-clients/python/hindsight_client_api/__init__.py
View file

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

2
hindsight-clients/python/hindsight_client_api/api/banks_api.py
View file

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

2
hindsight-clients/python/hindsight_client_api/api/directives_api.py
View file

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

2
hindsight-clients/python/hindsight_client_api/api/documents_api.py
View file

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

2
hindsight-clients/python/hindsight_client_api/api/entities_api.py
View file

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

2
hindsight-clients/python/hindsight_client_api/api/memory_api.py
View file

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

2
hindsight-clients/python/hindsight_client_api/api/mental_models_api.py
View file

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

2
hindsight-clients/python/hindsight_client_api/api/monitoring_api.py
View file

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

2
hindsight-clients/python/hindsight_client_api/api/operations_api.py
View file

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

2
hindsight-clients/python/hindsight_client_api/api_client.py
View file

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

4
hindsight-clients/python/hindsight_client_api/configuration.py
View file

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

2
hindsight-clients/python/hindsight_client_api/exceptions.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/__init__.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/add_background_request.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/async_operation_submit_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/background_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/bank_list_item.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/bank_list_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/bank_profile_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/bank_stats_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/budget.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/cancel_operation_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/chunk_data.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/chunk_include_options.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/chunk_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/consolidation_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/create_bank_request.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/create_directive_request.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/create_mental_model_request.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/create_mental_model_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/delete_document_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/delete_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/directive_list_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/directive_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/disposition_traits.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/document_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/entity_detail_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/entity_include_options.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/entity_input.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/entity_list_item.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/entity_list_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/entity_observation_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/entity_state_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/features_info.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/graph_data_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/http_validation_error.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/include_options.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/list_documents_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/list_memory_units_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/list_tags_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/memory_item.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/mental_model_list_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/mental_model_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/mental_model_trigger.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/operation_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/operation_status_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/operations_list_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/recall_request.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/recall_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/recall_result.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/reflect_based_on.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/reflect_directive.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/reflect_fact.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/reflect_include_options.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/reflect_llm_call.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/reflect_mental_model.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/reflect_request.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/reflect_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/reflect_tool_call.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/reflect_trace.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/retain_request.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/retain_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/tag_item.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/token_usage.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/tool_calls_include_options.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/update_directive_request.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/update_disposition_request.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/update_mental_model_request.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/validation_error.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/validation_error_loc_inner.py
View file

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

2
hindsight-clients/python/hindsight_client_api/models/version_response.py
View file

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

2
hindsight-clients/python/hindsight_client_api/rest.py
View file

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

2
hindsight-clients/python/pyproject.toml
View file

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

2
hindsight-clients/typescript/package.json
View file

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

2
hindsight-control-plane/package.json
View file

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

2
hindsight-dev/pyproject.toml
View file

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

2
hindsight-docs/static/openapi.json
View file

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

16
hindsight-docs/versioned_docs/version-0.4/developer/configuration.md
View file

@ -61,7 +61,7 @@ hindsight-admin run-db-migration --schema tenant_acme
| Variable | Description | Default | | Variable | Description | Default |
|----------|-------------|---------| |----------|-------------|---------|
| `HINDSIGHT_API_LLM_PROVIDER` | Provider: `openai`, `anthropic`, `gemini`, `groq`, `ollama`, `lmstudio`, `vertexai` | `openai` | | `HINDSIGHT_API_LLM_PROVIDER` | Provider: `openai`, `openai-codex`, `claude-code`, `anthropic`, `gemini`, `groq`, `ollama`, `lmstudio`, `vertexai` | `openai` |
| `HINDSIGHT_API_LLM_API_KEY` | API key for LLM provider | - | | `HINDSIGHT_API_LLM_API_KEY` | API key for LLM provider | - |
| `HINDSIGHT_API_LLM_MODEL` | Model name | `gpt-5-mini` | | `HINDSIGHT_API_LLM_MODEL` | Model name | `gpt-5-mini` |
| `HINDSIGHT_API_LLM_BASE_URL` | Custom LLM endpoint | Provider default | | `HINDSIGHT_API_LLM_BASE_URL` | Custom LLM endpoint | Provider default |
@ -120,8 +120,22 @@ export HINDSIGHT_API_LLM_PROVIDER=openai
export HINDSIGHT_API_LLM_BASE_URL=https://your-endpoint.com/v1 export HINDSIGHT_API_LLM_BASE_URL=https://your-endpoint.com/v1
export HINDSIGHT_API_LLM_API_KEY=your-api-key export HINDSIGHT_API_LLM_API_KEY=your-api-key
export HINDSIGHT_API_LLM_MODEL=your-model-name export HINDSIGHT_API_LLM_MODEL=your-model-name
# OpenAI Codex (ChatGPT Plus/Pro subscription - uses OAuth, no API key needed)
export HINDSIGHT_API_LLM_PROVIDER=openai-codex
export HINDSIGHT_API_LLM_MODEL=gpt-5.2-codex
# No API key needed - uses OAuth tokens from ~/.codex/auth.json
# Claude Code (Claude Pro/Max subscription - uses OAuth, no API key needed)
export HINDSIGHT_API_LLM_PROVIDER=claude-code
export HINDSIGHT_API_LLM_MODEL=claude-sonnet-4-5-20250929
# No API key needed - uses claude auth login credentials
``` ```
:::tip OpenAI Codex & Claude Code Setup
For detailed setup instructions for **OpenAI Codex** (ChatGPT Plus/Pro) and **Claude Code** (Claude Pro/Max), see the [Models documentation](./models#openai-codex-setup-chatgpt-pluspro).
:::
#### Vertex AI Setup #### Vertex AI Setup
Google Cloud's Vertex AI provides access to Gemini models via the native Google GenAI SDK. Hindsight supports two authentication methods: Google Cloud's Vertex AI provides access to Gemini models via the native Google GenAI SDK. Hindsight supports two authentication methods:

182
hindsight-docs/versioned_docs/version-0.4/developer/models.md
View file

@ -47,6 +47,46 @@ The following models have been tested and verified to work correctly with Hindsi
| **Groq** | `openai/gpt-oss-120b` | | **Groq** | `openai/gpt-oss-120b` |
| **Groq** | `openai/gpt-oss-20b` | | **Groq** | `openai/gpt-oss-20b` |
### Provider Default Models
Each provider has a recommended default model that's used when `HINDSIGHT_API_LLM_MODEL` is not explicitly set. This makes configuration simpler - just specify the provider and get a sensible default:
| Provider | Default Model |
|----------|--------------|
| `openai` | `o3-mini` |
| `anthropic` | `claude-haiku-4-5-20251001` |
| `gemini` | `gemini-2.5-flash` |
| `groq` | `openai/gpt-oss-120b` |
| `ollama` | `gemma3:12b` |
| `lmstudio` | `local-model` |
| `vertexai` | `gemini-2.0-flash-001` |
| `openai-codex` | `gpt-5.2-codex` |
| `claude-code` | `claude-sonnet-4-5-20250929` |
**Example:** Setting just the provider uses its default model:
```bash
# Uses claude-haiku-4-5-20251001 automatically
export HINDSIGHT_API_LLM_PROVIDER=anthropic
export HINDSIGHT_API_LLM_API_KEY=sk-ant-xxxxxxxxxxxx
```
You can override the default by explicitly setting `HINDSIGHT_API_LLM_MODEL`:
```bash
# Override to use Sonnet instead
export HINDSIGHT_API_LLM_PROVIDER=anthropic
export HINDSIGHT_API_LLM_API_KEY=sk-ant-xxxxxxxxxxxx
export HINDSIGHT_API_LLM_MODEL=claude-sonnet-4-5-20250929
```
This also applies to per-operation overrides:
```bash
# Global: OpenAI o3-mini (default)
export HINDSIGHT_API_LLM_PROVIDER=openai
# Retain: Anthropic claude-haiku-4-5-20251001 (default)
export HINDSIGHT_API_RETAIN_LLM_PROVIDER=anthropic
```
### Using Other Models ### Using Other Models
Other LLM models not listed above may work with Hindsight, but they must support **at least 65,000 output tokens** to ensure reliable fact extraction. If you need support for a specific model that doesn't meet this requirement, please [open an issue](https://github.com/hindsight-ai/hindsight/issues) to request an exception. Other LLM models not listed above may work with Hindsight, but they must support **at least 65,000 output tokens** to ensure reliable fact extraction. If you need support for a specific model that doesn't meet this requirement, please [open an issue](https://github.com/hindsight-ai/hindsight/issues) to request an exception.
@ -89,6 +129,148 @@ export HINDSIGHT_API_LLM_MODEL=your-local-model
--- ---
### OpenAI Codex Setup (ChatGPT Plus/Pro)
Use your ChatGPT Plus or Pro subscription for Hindsight without separate OpenAI Platform API costs.
**Prerequisites:**
- Active ChatGPT Plus or Pro subscription
- Node.js/npm installed (for Codex CLI)
**Setup Steps:**
1. **Install Codex CLI:**
```bash
npm install -g @openai/codex
```
2. **Login with ChatGPT credentials:**
```bash
codex auth login
```
This opens a browser window to authenticate with your ChatGPT account and saves OAuth tokens to `~/.codex/auth.json`.
3. **Verify authentication:**
```bash
ls ~/.codex/auth.json # Should show the auth file exists
```
4. **Configure Hindsight:**
```bash
export HINDSIGHT_API_LLM_PROVIDER=openai-codex
export HINDSIGHT_API_LLM_MODEL=gpt-5.2-codex # or gpt-5.1-codex
# No API key needed - reads from ~/.codex/auth.json automatically
```
5. **Start Hindsight:**
```bash
./scripts/dev/start-api.sh
```
**Available Models:**
- `gpt-5.2-codex` - Latest frontier agentic coding model (default)
- `gpt-5.2` - Latest frontier model
- `gpt-5.1-codex` - Previous generation coding model
- `gpt-5.1-codex-max` - Maximum context variant
- `gpt-5.1-codex-mini` - Lightweight variant
**Important Notes:**
- OAuth tokens are stored in `~/.codex/auth.json`
- Tokens refresh automatically when needed
- Usage is billed to your ChatGPT subscription (not separate API costs)
- For personal development use only (see ChatGPT Terms of Service)
**Troubleshooting:**
If authentication fails:
```bash
# Re-login to refresh tokens
codex auth login
# Check auth file exists and has correct format
cat ~/.codex/auth.json | python3 -c "import json, sys; d=json.load(sys.stdin); print('auth_mode:', d.get('auth_mode')); print('has tokens:', 'tokens' in d)"
```
---
### Claude Code Setup (Claude Pro/Max)
Use your Claude Pro or Max subscription for Hindsight without separate Anthropic API costs.
**Prerequisites:**
- Active Claude Pro or Max subscription
- Claude Code CLI installed
**Setup Steps:**
1. **Install Claude Code CLI:**
```bash
npm install -g @anthropics/claude-code
# Or via Homebrew
brew install anthropics/claude-code/claude-code
```
2. **Login with Claude credentials:**
```bash
claude auth login
```
This opens a browser window to authenticate with your Claude account. Authentication is automatically managed by the Claude Agent SDK.
3. **Verify authentication:**
```bash
claude --version
# Should show version without errors
```
4. **Configure Hindsight:**
```bash
export HINDSIGHT_API_LLM_PROVIDER=claude-code
export HINDSIGHT_API_LLM_MODEL=claude-sonnet-4-5-20250929
# No API key needed - uses claude auth login credentials
```
5. **Start Hindsight:**
```bash
./scripts/dev/start-api.sh
```
**Available Models:**
- `claude-sonnet-4-5-20250929` - Latest Claude Sonnet (default)
- `claude-opus-4-20250514` - Claude Opus for complex tasks
- `claude-sonnet-3-5-20241022` - Previous generation Sonnet
- Any model supported by Claude Code CLI
**Important Notes:**
- Authentication handled by Claude Agent SDK (uses bundled CLI)
- Credentials managed securely by Claude Code
- Usage billed to your Claude subscription (not separate API costs)
- Includes Claude Agent SDK as dependency (auto-installed)
- For personal development use only (see Claude Terms of Service)
**Troubleshooting:**
If authentication fails:
```bash
# Re-login to refresh credentials
claude auth login
# Check Claude CLI is working
claude --version
# Test authentication directly
claude query "test"
```
If the SDK is not found:
```bash
# Install Claude Agent SDK
pip install claude-agent-sdk
# Or with uv
uv add claude-agent-sdk
```
---
## Embedding Model ## Embedding Model
Converts text into dense vector representations for semantic similarity search. Converts text into dense vector representations for semantic similarity search.

67
hindsight-docs/versioned_docs/version-0.4/sdks/integrations/openclaw.md
View file

@ -26,6 +26,12 @@ export GEMINI_API_KEY="your-key"
# Option D: Groq (uses openai/gpt-oss-20b for memory extraction) # Option D: Groq (uses openai/gpt-oss-20b for memory extraction)
export GROQ_API_KEY="your-key" export GROQ_API_KEY="your-key"
# Option E: Claude Code (uses claude-sonnet-4-20250514, no API key needed)
export HINDSIGHT_API_LLM_PROVIDER=claude-code
# Option F: OpenAI Codex (uses o3-mini, no API key needed)
export HINDSIGHT_API_LLM_PROVIDER=openai-codex
``` ```
**Step 2: Install the plugin** **Step 2: Install the plugin**
@ -41,7 +47,7 @@ openclaw gateway
``` ```
The plugin will automatically: The plugin will automatically:
- Start a local Hindsight daemon (port 8888) - Start a local Hindsight daemon (port 9077)
- Capture conversations after each turn - Capture conversations after each turn
- Inject relevant memories before agent responses - Inject relevant memories before agent responses
@ -68,6 +74,7 @@ Optional settings in `~/.openclaw/openclaw.json`:
"hindsight-openclaw": { "hindsight-openclaw": {
"enabled": true, "enabled": true,
"config": { "config": {
"apiPort": 9077,
"daemonIdleTimeout": 0, "daemonIdleTimeout": 0,
"embedVersion": "latest" "embedVersion": "latest"
} }
@ -78,6 +85,7 @@ Optional settings in `~/.openclaw/openclaw.json`:
``` ```
**Options:** **Options:**
- `apiPort` - Port for the openclaw profile daemon (default: `9077`)
- `daemonIdleTimeout` - Seconds before daemon shuts down from inactivity (default: `0` = never) - `daemonIdleTimeout` - Seconds before daemon shuts down from inactivity (default: `0` = never)
- `embedVersion` - hindsight-embed version (default: `"latest"`) - `embedVersion` - hindsight-embed version (default: `"latest"`)
- `bankMission` - Custom context for the memory bank (optional) - `bankMission` - Custom context for the memory bank (optional)
@ -86,12 +94,14 @@ Optional settings in `~/.openclaw/openclaw.json`:
The plugin auto-detects your LLM provider from these environment variables: The plugin auto-detects your LLM provider from these environment variables:
| Provider | Env Var | Default Model | | Provider | Env Var | Default Model | Notes |
|----------|---------|---------------| |----------|---------|---------------|-------|
| OpenAI | `OPENAI_API_KEY` | `gpt-4o-mini` | | OpenAI | `OPENAI_API_KEY` | `gpt-4o-mini` | |
| Anthropic | `ANTHROPIC_API_KEY` | `claude-3-5-haiku-20241022` | | Anthropic | `ANTHROPIC_API_KEY` | `claude-3-5-haiku-20241022` | |
| Gemini | `GEMINI_API_KEY` | `gemini-2.5-flash` | | Gemini | `GEMINI_API_KEY` | `gemini-2.5-flash` | |
| Groq | `GROQ_API_KEY` | `openai/gpt-oss-20b` | | Groq | `GROQ_API_KEY` | `openai/gpt-oss-20b` | |
| Claude Code | `HINDSIGHT_API_LLM_PROVIDER=claude-code` | `claude-sonnet-4-20250514` | No API key needed |
| OpenAI Codex | `HINDSIGHT_API_LLM_PROVIDER=openai-codex` | `o3-mini` | No API key needed |
**Override with explicit config:** **Override with explicit config:**
@ -133,32 +143,32 @@ Useful for shared memory across multiple OpenClaw instances or production deploy
View the daemon config that was written by the plugin: View the daemon config that was written by the plugin:
```bash ```bash
cat ~/.hindsight/embed cat ~/.hindsight/profiles/openclaw.env
``` ```
This shows the LLM provider, model, and other settings the daemon is using. This shows the LLM provider, model, port, and other settings the daemon is using.
### Check Daemon Status ### Check Daemon Status
```bash ```bash
# Check if daemon is running # Check if daemon is running
uvx hindsight-embed@latest daemon status uvx hindsight-embed@latest -p openclaw daemon status
# View daemon logs # View daemon logs
tail -f ~/.hindsight/daemon.log tail -f ~/.hindsight/profiles/openclaw.log
``` ```
### Query Memories ### Query Memories
```bash ```bash
# Search memories # Search memories
uvx hindsight-embed@latest memory recall openclaw "user preferences" uvx hindsight-embed@latest -p openclaw memory recall openclaw "user preferences"
# View recent memories # View recent memories
uvx hindsight-embed@latest memory list openclaw --limit 10 uvx hindsight-embed@latest -p openclaw memory list openclaw --limit 10
# Open web UI # Open web UI (uses openclaw profile's daemon)
uvx hindsight-embed@latest ui uvx hindsight-embed@latest -p openclaw ui
``` ```
## Troubleshooting ## Troubleshooting
@ -176,27 +186,40 @@ openclaw plugins install @vectorize-io/hindsight-openclaw
### Daemon not starting ### Daemon not starting
```bash ```bash
# Check daemon status # Check daemon status (note: -p openclaw uses the openclaw profile)
uvx hindsight-embed@latest daemon status uvx hindsight-embed@latest -p openclaw daemon status
# View logs for errors # View logs for errors
tail -f ~/.hindsight/daemon.log tail -f ~/.hindsight/profiles/openclaw.log
# Check configuration # Check configuration
cat ~/.hindsight/embed cat ~/.hindsight/profiles/openclaw.env
# List all profiles
uvx hindsight-embed@latest profile list
``` ```
### No API key error ### No API key error
Make sure you've set one of the provider API keys: Make sure you've set one of the provider API keys (or use a provider that doesn't require one):
```bash ```bash
# Option 1: OpenAI
export OPENAI_API_KEY="sk-your-key" export OPENAI_API_KEY="sk-your-key"
# or
# Option 2: Anthropic
export ANTHROPIC_API_KEY="your-key" export ANTHROPIC_API_KEY="your-key"
# Option 3: Claude Code (no API key needed)
export HINDSIGHT_API_LLM_PROVIDER=claude-code
# Option 4: OpenAI Codex (no API key needed)
export HINDSIGHT_API_LLM_PROVIDER=openai-codex
# Verify it's set # Verify it's set
echo $OPENAI_API_KEY echo $OPENAI_API_KEY
# or
echo $HINDSIGHT_API_LLM_PROVIDER
``` ```
### Verify it's working ### Verify it's working
@ -208,6 +231,8 @@ tail -f /tmp/openclaw/openclaw-*.log | grep Hindsight
# Should see on startup: # Should see on startup:
# [Hindsight] ✓ Using provider: openai, model: gpt-4o-mini # [Hindsight] ✓ Using provider: openai, model: gpt-4o-mini
# or
# [Hindsight] ✓ Using provider: claude-code, model: claude-sonnet-4-20250514
# Should see after conversations: # Should see after conversations:
# [Hindsight] Retained X messages for session ... # [Hindsight] Retained X messages for session ...

2
hindsight-embed/hindsight_embed/__init__.py
View file

@ -1,3 +1,3 @@
"""Hindsight embedded CLI - local memory operations without a server.""" """Hindsight embedded CLI - local memory operations without a server."""
__version__ = "0.4.7" __version__ = "0.4.8"

2
hindsight-embed/pyproject.toml
View file

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

2
hindsight-integrations/litellm/pyproject.toml
View file

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

2
hindsight-integrations/openclaw/package.json
View file

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

2
hindsight/pyproject.toml
View file

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

10
uv.lock
View file

@ -1448,7 +1448,7 @@ wheels = [
[[package]] [[package]]
name = "hindsight-all" name = "hindsight-all"
version = "0.4.7" version = "0.4.8"
source = { editable = "hindsight" } source = { editable = "hindsight" }
dependencies = [ dependencies = [
{ name = "hindsight-api" }, { name = "hindsight-api" },
@ -1472,7 +1472,7 @@ provides-extras = ["test"]
[[package]] [[package]]
name = "hindsight-api" name = "hindsight-api"
version = "0.4.7" version = "0.4.8"
source = { editable = "hindsight-api" } source = { editable = "hindsight-api" }
dependencies = [ dependencies = [
{ name = "aiohttp" }, { name = "aiohttp" },
@ -1604,7 +1604,7 @@ dev = [
[[package]] [[package]]
name = "hindsight-client" name = "hindsight-client"
version = "0.4.7" version = "0.4.8"
source = { editable = "hindsight-clients/python" } source = { editable = "hindsight-clients/python" }
dependencies = [ dependencies = [
{ name = "aiohttp" }, { name = "aiohttp" },
@ -1638,7 +1638,7 @@ provides-extras = ["test"]
[[package]] [[package]]
name = "hindsight-dev" name = "hindsight-dev"
version = "0.4.7" version = "0.4.8"
source = { editable = "hindsight-dev" } source = { editable = "hindsight-dev" }
dependencies = [ dependencies = [
{ name = "hindsight-api" }, { name = "hindsight-api" },
@ -1684,7 +1684,7 @@ dev = [
[[package]] [[package]]
name = "hindsight-embed" name = "hindsight-embed"
version = "0.4.7" version = "0.4.8"
source = { editable = "hindsight-embed" } source = { editable = "hindsight-embed" }
dependencies = [ dependencies = [
{ name = "httpx" }, { name = "httpx" },