diff --git a/helm/hindsight/Chart.yaml b/helm/hindsight/Chart.yaml
index 02dee833..8dc0da51 100644
--- a/helm/hindsight/Chart.yaml
+++ b/helm/hindsight/Chart.yaml
@@ -2,8 +2,8 @@ apiVersion: v2
 name: hindsight
 description: Hindsight helm chart
 type: application
-version: 0.4.11
-appVersion: "0.4.11"
+version: 0.4.12
+appVersion: "0.4.12"
 keywords:
   - ai
   - memory
diff --git a/hindsight-api/hindsight_api/__init__.py b/hindsight-api/hindsight_api/__init__.py
index dc0a15ef..47f9a843 100644
--- a/hindsight-api/hindsight_api/__init__.py
+++ b/hindsight-api/hindsight_api/__init__.py
@@ -46,4 +46,4 @@ __all__ = [
     "RemoteTEICrossEncoder",
     "LLMConfig",
 ]
-__version__ = "0.4.11"
+__version__ = "0.4.12"
diff --git a/hindsight-api/pyproject.toml b/hindsight-api/pyproject.toml
index 1586edd6..9ae600ea 100644
--- a/hindsight-api/pyproject.toml
+++ b/hindsight-api/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hindsight-api"
-version = "0.4.11"
+version = "0.4.12"
 description = "Hindsight: Agent Memory That Works Like Human Memory"
 readme = "README.md"
 requires-python = ">=3.11"
diff --git a/hindsight-cli/Cargo.toml b/hindsight-cli/Cargo.toml
index 9c901a58..3d301b2c 100644
--- a/hindsight-cli/Cargo.toml
+++ b/hindsight-cli/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "hindsight-cli"
-version = "0.4.11"
+version = "0.4.12"
 edition = "2021"
 authors = ["Hindsight Team"]
 description = "A beautiful CLI for Hindsight - semantic memory system"
diff --git a/hindsight-clients/go/api/openapi.yaml b/hindsight-clients/go/api/openapi.yaml
index 65ec99ce..69f13973 100644
--- a/hindsight-clients/go/api/openapi.yaml
+++ b/hindsight-clients/go/api/openapi.yaml
@@ -7,7 +7,7 @@ info:
     name: Apache 2.0
     url: https://www.apache.org/licenses/LICENSE-2.0.html
   title: Hindsight HTTP API
-  version: 0.4.11
+  version: 0.4.12
 servers:
 - url: /
 paths:
diff --git a/hindsight-clients/go/api_banks.go b/hindsight-clients/go/api_banks.go
index de59b622..51089a18 100644
--- a/hindsight-clients/go/api_banks.go
+++ b/hindsight-clients/go/api_banks.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/api_directives.go b/hindsight-clients/go/api_directives.go
index 602ec0f6..d7a09ced 100644
--- a/hindsight-clients/go/api_directives.go
+++ b/hindsight-clients/go/api_directives.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/api_documents.go b/hindsight-clients/go/api_documents.go
index 077d7143..d8852829 100644
--- a/hindsight-clients/go/api_documents.go
+++ b/hindsight-clients/go/api_documents.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/api_entities.go b/hindsight-clients/go/api_entities.go
index 16145559..f0ce98c2 100644
--- a/hindsight-clients/go/api_entities.go
+++ b/hindsight-clients/go/api_entities.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/api_files.go b/hindsight-clients/go/api_files.go
index be37f1c1..9f3b7b9f 100644
--- a/hindsight-clients/go/api_files.go
+++ b/hindsight-clients/go/api_files.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/api_memory.go b/hindsight-clients/go/api_memory.go
index e1bc1e7d..ebd31a0e 100644
--- a/hindsight-clients/go/api_memory.go
+++ b/hindsight-clients/go/api_memory.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/api_mental_models.go b/hindsight-clients/go/api_mental_models.go
index 5829453b..98c4e2a6 100644
--- a/hindsight-clients/go/api_mental_models.go
+++ b/hindsight-clients/go/api_mental_models.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/api_monitoring.go b/hindsight-clients/go/api_monitoring.go
index cac4b072..d2e48821 100644
--- a/hindsight-clients/go/api_monitoring.go
+++ b/hindsight-clients/go/api_monitoring.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/api_operations.go b/hindsight-clients/go/api_operations.go
index 577bd47c..b5263d0c 100644
--- a/hindsight-clients/go/api_operations.go
+++ b/hindsight-clients/go/api_operations.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/client.go b/hindsight-clients/go/client.go
index 2b426826..97ce35a9 100644
--- a/hindsight-clients/go/client.go
+++ b/hindsight-clients/go/client.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
@@ -41,7 +41,7 @@ var (
 	queryDescape    = strings.NewReplacer( "%5B", "[", "%5D", "]" )
 )
 
-// APIClient manages communication with the Hindsight HTTP API API v0.4.11
+// APIClient manages communication with the Hindsight HTTP API API v0.4.12
 // In most cases there should be only one, shared, APIClient.
 type APIClient struct {
 	cfg    *Configuration
diff --git a/hindsight-clients/go/configuration.go b/hindsight-clients/go/configuration.go
index 4263a38c..c477b3c9 100644
--- a/hindsight-clients/go/configuration.go
+++ b/hindsight-clients/go/configuration.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_add_background_request.go b/hindsight-clients/go/model_add_background_request.go
index 571a10f1..18d03827 100644
--- a/hindsight-clients/go/model_add_background_request.go
+++ b/hindsight-clients/go/model_add_background_request.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_async_operation_submit_response.go b/hindsight-clients/go/model_async_operation_submit_response.go
index fc2fcd38..17fed483 100644
--- a/hindsight-clients/go/model_async_operation_submit_response.go
+++ b/hindsight-clients/go/model_async_operation_submit_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_background_response.go b/hindsight-clients/go/model_background_response.go
index 30d95876..6967ec76 100644
--- a/hindsight-clients/go/model_background_response.go
+++ b/hindsight-clients/go/model_background_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_bank_config_response.go b/hindsight-clients/go/model_bank_config_response.go
index 09981fa8..ff6f4d73 100644
--- a/hindsight-clients/go/model_bank_config_response.go
+++ b/hindsight-clients/go/model_bank_config_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_bank_config_update.go b/hindsight-clients/go/model_bank_config_update.go
index d061a3a4..e635716b 100644
--- a/hindsight-clients/go/model_bank_config_update.go
+++ b/hindsight-clients/go/model_bank_config_update.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_bank_list_item.go b/hindsight-clients/go/model_bank_list_item.go
index b640a17b..2d6bf496 100644
--- a/hindsight-clients/go/model_bank_list_item.go
+++ b/hindsight-clients/go/model_bank_list_item.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_bank_list_response.go b/hindsight-clients/go/model_bank_list_response.go
index 832390dd..7bafb881 100644
--- a/hindsight-clients/go/model_bank_list_response.go
+++ b/hindsight-clients/go/model_bank_list_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_bank_profile_response.go b/hindsight-clients/go/model_bank_profile_response.go
index a0a1cd9d..3de8f9e3 100644
--- a/hindsight-clients/go/model_bank_profile_response.go
+++ b/hindsight-clients/go/model_bank_profile_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_bank_stats_response.go b/hindsight-clients/go/model_bank_stats_response.go
index d0ef5e14..aa6d2f69 100644
--- a/hindsight-clients/go/model_bank_stats_response.go
+++ b/hindsight-clients/go/model_bank_stats_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_budget.go b/hindsight-clients/go/model_budget.go
index 02dcc432..bcebd837 100644
--- a/hindsight-clients/go/model_budget.go
+++ b/hindsight-clients/go/model_budget.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_cancel_operation_response.go b/hindsight-clients/go/model_cancel_operation_response.go
index 427b6f4d..6f54545f 100644
--- a/hindsight-clients/go/model_cancel_operation_response.go
+++ b/hindsight-clients/go/model_cancel_operation_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_child_operation_status.go b/hindsight-clients/go/model_child_operation_status.go
index 68126dd3..2fbd2ed5 100644
--- a/hindsight-clients/go/model_child_operation_status.go
+++ b/hindsight-clients/go/model_child_operation_status.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_chunk_data.go b/hindsight-clients/go/model_chunk_data.go
index c914680c..6c6cb51b 100644
--- a/hindsight-clients/go/model_chunk_data.go
+++ b/hindsight-clients/go/model_chunk_data.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_chunk_include_options.go b/hindsight-clients/go/model_chunk_include_options.go
index 6050bfc5..5453d97f 100644
--- a/hindsight-clients/go/model_chunk_include_options.go
+++ b/hindsight-clients/go/model_chunk_include_options.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_chunk_response.go b/hindsight-clients/go/model_chunk_response.go
index b43ae6d4..c6506b63 100644
--- a/hindsight-clients/go/model_chunk_response.go
+++ b/hindsight-clients/go/model_chunk_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_consolidation_response.go b/hindsight-clients/go/model_consolidation_response.go
index 05857918..3cbe2acb 100644
--- a/hindsight-clients/go/model_consolidation_response.go
+++ b/hindsight-clients/go/model_consolidation_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_create_bank_request.go b/hindsight-clients/go/model_create_bank_request.go
index 3f1d076e..aff892e9 100644
--- a/hindsight-clients/go/model_create_bank_request.go
+++ b/hindsight-clients/go/model_create_bank_request.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_create_directive_request.go b/hindsight-clients/go/model_create_directive_request.go
index cdbb3a6e..ec3bbfd0 100644
--- a/hindsight-clients/go/model_create_directive_request.go
+++ b/hindsight-clients/go/model_create_directive_request.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_create_mental_model_request.go b/hindsight-clients/go/model_create_mental_model_request.go
index 52fbbfcf..9638a6de 100644
--- a/hindsight-clients/go/model_create_mental_model_request.go
+++ b/hindsight-clients/go/model_create_mental_model_request.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_create_mental_model_response.go b/hindsight-clients/go/model_create_mental_model_response.go
index 9f2500d3..72b7d722 100644
--- a/hindsight-clients/go/model_create_mental_model_response.go
+++ b/hindsight-clients/go/model_create_mental_model_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_delete_document_response.go b/hindsight-clients/go/model_delete_document_response.go
index 7455756a..a87b6c17 100644
--- a/hindsight-clients/go/model_delete_document_response.go
+++ b/hindsight-clients/go/model_delete_document_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_delete_response.go b/hindsight-clients/go/model_delete_response.go
index 6903e90e..1cef7f80 100644
--- a/hindsight-clients/go/model_delete_response.go
+++ b/hindsight-clients/go/model_delete_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_directive_list_response.go b/hindsight-clients/go/model_directive_list_response.go
index c19ccfb3..ad037a42 100644
--- a/hindsight-clients/go/model_directive_list_response.go
+++ b/hindsight-clients/go/model_directive_list_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_directive_response.go b/hindsight-clients/go/model_directive_response.go
index 24da6312..f5873646 100644
--- a/hindsight-clients/go/model_directive_response.go
+++ b/hindsight-clients/go/model_directive_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_disposition_traits.go b/hindsight-clients/go/model_disposition_traits.go
index aafb13c1..d5befb50 100644
--- a/hindsight-clients/go/model_disposition_traits.go
+++ b/hindsight-clients/go/model_disposition_traits.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_document_response.go b/hindsight-clients/go/model_document_response.go
index 9a0aa92d..176c4254 100644
--- a/hindsight-clients/go/model_document_response.go
+++ b/hindsight-clients/go/model_document_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_entity_detail_response.go b/hindsight-clients/go/model_entity_detail_response.go
index 14bc06cb..65c0f16a 100644
--- a/hindsight-clients/go/model_entity_detail_response.go
+++ b/hindsight-clients/go/model_entity_detail_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_entity_include_options.go b/hindsight-clients/go/model_entity_include_options.go
index c82c441d..ab0ab9e3 100644
--- a/hindsight-clients/go/model_entity_include_options.go
+++ b/hindsight-clients/go/model_entity_include_options.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_entity_input.go b/hindsight-clients/go/model_entity_input.go
index b7013b88..0bbb7198 100644
--- a/hindsight-clients/go/model_entity_input.go
+++ b/hindsight-clients/go/model_entity_input.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_entity_list_item.go b/hindsight-clients/go/model_entity_list_item.go
index 93c956d5..444a4bb9 100644
--- a/hindsight-clients/go/model_entity_list_item.go
+++ b/hindsight-clients/go/model_entity_list_item.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_entity_list_response.go b/hindsight-clients/go/model_entity_list_response.go
index 24567e9a..0c2064fc 100644
--- a/hindsight-clients/go/model_entity_list_response.go
+++ b/hindsight-clients/go/model_entity_list_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_entity_observation_response.go b/hindsight-clients/go/model_entity_observation_response.go
index c942d4e0..c00c574a 100644
--- a/hindsight-clients/go/model_entity_observation_response.go
+++ b/hindsight-clients/go/model_entity_observation_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_entity_state_response.go b/hindsight-clients/go/model_entity_state_response.go
index fec26bd4..b1b35678 100644
--- a/hindsight-clients/go/model_entity_state_response.go
+++ b/hindsight-clients/go/model_entity_state_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_features_info.go b/hindsight-clients/go/model_features_info.go
index 81703f68..34f0145b 100644
--- a/hindsight-clients/go/model_features_info.go
+++ b/hindsight-clients/go/model_features_info.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_file_retain_response.go b/hindsight-clients/go/model_file_retain_response.go
index d9515159..ee8f7348 100644
--- a/hindsight-clients/go/model_file_retain_response.go
+++ b/hindsight-clients/go/model_file_retain_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_graph_data_response.go b/hindsight-clients/go/model_graph_data_response.go
index 35240505..7dc79b21 100644
--- a/hindsight-clients/go/model_graph_data_response.go
+++ b/hindsight-clients/go/model_graph_data_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_http_validation_error.go b/hindsight-clients/go/model_http_validation_error.go
index 6e4138da..a87c3bf7 100644
--- a/hindsight-clients/go/model_http_validation_error.go
+++ b/hindsight-clients/go/model_http_validation_error.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_include_options.go b/hindsight-clients/go/model_include_options.go
index ab5e5ac6..aedbd75b 100644
--- a/hindsight-clients/go/model_include_options.go
+++ b/hindsight-clients/go/model_include_options.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_list_documents_response.go b/hindsight-clients/go/model_list_documents_response.go
index 49f0cb9a..b35365b6 100644
--- a/hindsight-clients/go/model_list_documents_response.go
+++ b/hindsight-clients/go/model_list_documents_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_list_memory_units_response.go b/hindsight-clients/go/model_list_memory_units_response.go
index 4680e1f0..88ee45a1 100644
--- a/hindsight-clients/go/model_list_memory_units_response.go
+++ b/hindsight-clients/go/model_list_memory_units_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_list_tags_response.go b/hindsight-clients/go/model_list_tags_response.go
index 1f7e806e..8ebb07e8 100644
--- a/hindsight-clients/go/model_list_tags_response.go
+++ b/hindsight-clients/go/model_list_tags_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_memory_item.go b/hindsight-clients/go/model_memory_item.go
index aa3cfee9..30784b02 100644
--- a/hindsight-clients/go/model_memory_item.go
+++ b/hindsight-clients/go/model_memory_item.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_mental_model_list_response.go b/hindsight-clients/go/model_mental_model_list_response.go
index b4dd1d76..1a6c3802 100644
--- a/hindsight-clients/go/model_mental_model_list_response.go
+++ b/hindsight-clients/go/model_mental_model_list_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_mental_model_response.go b/hindsight-clients/go/model_mental_model_response.go
index 3acbf5d8..23ee8434 100644
--- a/hindsight-clients/go/model_mental_model_response.go
+++ b/hindsight-clients/go/model_mental_model_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_mental_model_trigger.go b/hindsight-clients/go/model_mental_model_trigger.go
index 4c227907..c10314d1 100644
--- a/hindsight-clients/go/model_mental_model_trigger.go
+++ b/hindsight-clients/go/model_mental_model_trigger.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_operation_response.go b/hindsight-clients/go/model_operation_response.go
index f516218f..380fc746 100644
--- a/hindsight-clients/go/model_operation_response.go
+++ b/hindsight-clients/go/model_operation_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_operation_status_response.go b/hindsight-clients/go/model_operation_status_response.go
index a493f087..cd66113e 100644
--- a/hindsight-clients/go/model_operation_status_response.go
+++ b/hindsight-clients/go/model_operation_status_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_operations_list_response.go b/hindsight-clients/go/model_operations_list_response.go
index 07ec76c5..8aaf087c 100644
--- a/hindsight-clients/go/model_operations_list_response.go
+++ b/hindsight-clients/go/model_operations_list_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_recall_request.go b/hindsight-clients/go/model_recall_request.go
index 0bc6ee59..d982f333 100644
--- a/hindsight-clients/go/model_recall_request.go
+++ b/hindsight-clients/go/model_recall_request.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_recall_response.go b/hindsight-clients/go/model_recall_response.go
index d6a7fe3c..cee56169 100644
--- a/hindsight-clients/go/model_recall_response.go
+++ b/hindsight-clients/go/model_recall_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_recall_result.go b/hindsight-clients/go/model_recall_result.go
index cb871fad..af7da4d9 100644
--- a/hindsight-clients/go/model_recall_result.go
+++ b/hindsight-clients/go/model_recall_result.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_reflect_based_on.go b/hindsight-clients/go/model_reflect_based_on.go
index ae6c2d67..a2b9c965 100644
--- a/hindsight-clients/go/model_reflect_based_on.go
+++ b/hindsight-clients/go/model_reflect_based_on.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_reflect_directive.go b/hindsight-clients/go/model_reflect_directive.go
index 52508822..58b54468 100644
--- a/hindsight-clients/go/model_reflect_directive.go
+++ b/hindsight-clients/go/model_reflect_directive.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_reflect_fact.go b/hindsight-clients/go/model_reflect_fact.go
index c3856823..949a3839 100644
--- a/hindsight-clients/go/model_reflect_fact.go
+++ b/hindsight-clients/go/model_reflect_fact.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_reflect_include_options.go b/hindsight-clients/go/model_reflect_include_options.go
index 7a229103..aa26e646 100644
--- a/hindsight-clients/go/model_reflect_include_options.go
+++ b/hindsight-clients/go/model_reflect_include_options.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_reflect_llm_call.go b/hindsight-clients/go/model_reflect_llm_call.go
index 45183c81..bb725506 100644
--- a/hindsight-clients/go/model_reflect_llm_call.go
+++ b/hindsight-clients/go/model_reflect_llm_call.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_reflect_mental_model.go b/hindsight-clients/go/model_reflect_mental_model.go
index 0d9735ef..c27bed48 100644
--- a/hindsight-clients/go/model_reflect_mental_model.go
+++ b/hindsight-clients/go/model_reflect_mental_model.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_reflect_request.go b/hindsight-clients/go/model_reflect_request.go
index f902e75d..9159a0bb 100644
--- a/hindsight-clients/go/model_reflect_request.go
+++ b/hindsight-clients/go/model_reflect_request.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_reflect_response.go b/hindsight-clients/go/model_reflect_response.go
index d09a2718..43a1f925 100644
--- a/hindsight-clients/go/model_reflect_response.go
+++ b/hindsight-clients/go/model_reflect_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_reflect_tool_call.go b/hindsight-clients/go/model_reflect_tool_call.go
index 52266a88..c9e43db1 100644
--- a/hindsight-clients/go/model_reflect_tool_call.go
+++ b/hindsight-clients/go/model_reflect_tool_call.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_reflect_trace.go b/hindsight-clients/go/model_reflect_trace.go
index f25aaae1..eb3d8b61 100644
--- a/hindsight-clients/go/model_reflect_trace.go
+++ b/hindsight-clients/go/model_reflect_trace.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_retain_request.go b/hindsight-clients/go/model_retain_request.go
index e473fbb0..7db1910f 100644
--- a/hindsight-clients/go/model_retain_request.go
+++ b/hindsight-clients/go/model_retain_request.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_retain_response.go b/hindsight-clients/go/model_retain_response.go
index 6aba004e..a7ed04cc 100644
--- a/hindsight-clients/go/model_retain_response.go
+++ b/hindsight-clients/go/model_retain_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_tag_item.go b/hindsight-clients/go/model_tag_item.go
index 019c88cb..9749c5f8 100644
--- a/hindsight-clients/go/model_tag_item.go
+++ b/hindsight-clients/go/model_tag_item.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_token_usage.go b/hindsight-clients/go/model_token_usage.go
index 1834836a..bf6ed0c8 100644
--- a/hindsight-clients/go/model_token_usage.go
+++ b/hindsight-clients/go/model_token_usage.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_tool_calls_include_options.go b/hindsight-clients/go/model_tool_calls_include_options.go
index 3f78475c..49854874 100644
--- a/hindsight-clients/go/model_tool_calls_include_options.go
+++ b/hindsight-clients/go/model_tool_calls_include_options.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_update_directive_request.go b/hindsight-clients/go/model_update_directive_request.go
index dae648ff..41d6d0d2 100644
--- a/hindsight-clients/go/model_update_directive_request.go
+++ b/hindsight-clients/go/model_update_directive_request.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_update_disposition_request.go b/hindsight-clients/go/model_update_disposition_request.go
index af486ce6..e4955cd4 100644
--- a/hindsight-clients/go/model_update_disposition_request.go
+++ b/hindsight-clients/go/model_update_disposition_request.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_update_mental_model_request.go b/hindsight-clients/go/model_update_mental_model_request.go
index e13ae2a8..9c7d9a05 100644
--- a/hindsight-clients/go/model_update_mental_model_request.go
+++ b/hindsight-clients/go/model_update_mental_model_request.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_validation_error.go b/hindsight-clients/go/model_validation_error.go
index a2dd835a..c6371895 100644
--- a/hindsight-clients/go/model_validation_error.go
+++ b/hindsight-clients/go/model_validation_error.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_validation_error_loc_inner.go b/hindsight-clients/go/model_validation_error_loc_inner.go
index d8601e3a..b4ec401a 100644
--- a/hindsight-clients/go/model_validation_error_loc_inner.go
+++ b/hindsight-clients/go/model_validation_error_loc_inner.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/model_version_response.go b/hindsight-clients/go/model_version_response.go
index a8a0f684..c635bf81 100644
--- a/hindsight-clients/go/model_version_response.go
+++ b/hindsight-clients/go/model_version_response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/response.go b/hindsight-clients/go/response.go
index 789350fe..69b5a0f4 100644
--- a/hindsight-clients/go/response.go
+++ b/hindsight-clients/go/response.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/go/utils.go b/hindsight-clients/go/utils.go
index 39c6d5f6..b368ec6a 100644
--- a/hindsight-clients/go/utils.go
+++ b/hindsight-clients/go/utils.go
@@ -3,7 +3,7 @@ Hindsight HTTP API
 
 HTTP API for Hindsight
 
-API version: 0.4.11
+API version: 0.4.12
 */
 
 // Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
diff --git a/hindsight-clients/python/hindsight_client_api/__init__.py b/hindsight-clients/python/hindsight_client_api/__init__.py
index 585aa87e..4e8fd284 100644
--- a/hindsight-clients/python/hindsight_client_api/__init__.py
+++ b/hindsight-clients/python/hindsight_client_api/__init__.py
@@ -7,7 +7,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/api/banks_api.py b/hindsight-clients/python/hindsight_client_api/api/banks_api.py
index 62e97686..7755748b 100644
--- a/hindsight-clients/python/hindsight_client_api/api/banks_api.py
+++ b/hindsight-clients/python/hindsight_client_api/api/banks_api.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/api/directives_api.py b/hindsight-clients/python/hindsight_client_api/api/directives_api.py
index db88c84c..8022c3e8 100644
--- a/hindsight-clients/python/hindsight_client_api/api/directives_api.py
+++ b/hindsight-clients/python/hindsight_client_api/api/directives_api.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/api/documents_api.py b/hindsight-clients/python/hindsight_client_api/api/documents_api.py
index e7073090..03db94fd 100644
--- a/hindsight-clients/python/hindsight_client_api/api/documents_api.py
+++ b/hindsight-clients/python/hindsight_client_api/api/documents_api.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/api/entities_api.py b/hindsight-clients/python/hindsight_client_api/api/entities_api.py
index 0d98f73f..448b9c51 100644
--- a/hindsight-clients/python/hindsight_client_api/api/entities_api.py
+++ b/hindsight-clients/python/hindsight_client_api/api/entities_api.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/api/files_api.py b/hindsight-clients/python/hindsight_client_api/api/files_api.py
index 3c023467..8359a5b6 100644
--- a/hindsight-clients/python/hindsight_client_api/api/files_api.py
+++ b/hindsight-clients/python/hindsight_client_api/api/files_api.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/api/memory_api.py b/hindsight-clients/python/hindsight_client_api/api/memory_api.py
index c4c3e1ac..e2998223 100644
--- a/hindsight-clients/python/hindsight_client_api/api/memory_api.py
+++ b/hindsight-clients/python/hindsight_client_api/api/memory_api.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/api/mental_models_api.py b/hindsight-clients/python/hindsight_client_api/api/mental_models_api.py
index dc383d62..e2096ca7 100644
--- a/hindsight-clients/python/hindsight_client_api/api/mental_models_api.py
+++ b/hindsight-clients/python/hindsight_client_api/api/mental_models_api.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/api/monitoring_api.py b/hindsight-clients/python/hindsight_client_api/api/monitoring_api.py
index a5a289b5..957ae5ae 100644
--- a/hindsight-clients/python/hindsight_client_api/api/monitoring_api.py
+++ b/hindsight-clients/python/hindsight_client_api/api/monitoring_api.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/api/operations_api.py b/hindsight-clients/python/hindsight_client_api/api/operations_api.py
index c747e938..36e61e89 100644
--- a/hindsight-clients/python/hindsight_client_api/api/operations_api.py
+++ b/hindsight-clients/python/hindsight_client_api/api/operations_api.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/api_client.py b/hindsight-clients/python/hindsight_client_api/api_client.py
index 1e793a07..e6f91d8f 100644
--- a/hindsight-clients/python/hindsight_client_api/api_client.py
+++ b/hindsight-clients/python/hindsight_client_api/api_client.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/configuration.py b/hindsight-clients/python/hindsight_client_api/configuration.py
index 494a3d86..b1b80eb0 100644
--- a/hindsight-clients/python/hindsight_client_api/configuration.py
+++ b/hindsight-clients/python/hindsight_client_api/configuration.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     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.11\n"\
+               "Version of the API: 0.4.12\n"\
                "SDK Package Version: 0.0.7".\
                format(env=sys.platform, pyversion=sys.version)
 
diff --git a/hindsight-clients/python/hindsight_client_api/exceptions.py b/hindsight-clients/python/hindsight_client_api/exceptions.py
index fc3b16dd..b705b77a 100644
--- a/hindsight-clients/python/hindsight_client_api/exceptions.py
+++ b/hindsight-clients/python/hindsight_client_api/exceptions.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/__init__.py b/hindsight-clients/python/hindsight_client_api/models/__init__.py
index 030ff1e6..9609d0e8 100644
--- a/hindsight-clients/python/hindsight_client_api/models/__init__.py
+++ b/hindsight-clients/python/hindsight_client_api/models/__init__.py
@@ -6,7 +6,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/add_background_request.py b/hindsight-clients/python/hindsight_client_api/models/add_background_request.py
index c0f44b65..87412ea8 100644
--- a/hindsight-clients/python/hindsight_client_api/models/add_background_request.py
+++ b/hindsight-clients/python/hindsight_client_api/models/add_background_request.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/async_operation_submit_response.py b/hindsight-clients/python/hindsight_client_api/models/async_operation_submit_response.py
index b8e964b8..f14e2bac 100644
--- a/hindsight-clients/python/hindsight_client_api/models/async_operation_submit_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/async_operation_submit_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/background_response.py b/hindsight-clients/python/hindsight_client_api/models/background_response.py
index 54727426..f4ac804c 100644
--- a/hindsight-clients/python/hindsight_client_api/models/background_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/background_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/bank_config_response.py b/hindsight-clients/python/hindsight_client_api/models/bank_config_response.py
index 8ba7b931..ed76fd79 100644
--- a/hindsight-clients/python/hindsight_client_api/models/bank_config_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/bank_config_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/bank_config_update.py b/hindsight-clients/python/hindsight_client_api/models/bank_config_update.py
index f13d7561..0f3421cf 100644
--- a/hindsight-clients/python/hindsight_client_api/models/bank_config_update.py
+++ b/hindsight-clients/python/hindsight_client_api/models/bank_config_update.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/bank_list_item.py b/hindsight-clients/python/hindsight_client_api/models/bank_list_item.py
index 90d35f1e..dabf0e7a 100644
--- a/hindsight-clients/python/hindsight_client_api/models/bank_list_item.py
+++ b/hindsight-clients/python/hindsight_client_api/models/bank_list_item.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/bank_list_response.py b/hindsight-clients/python/hindsight_client_api/models/bank_list_response.py
index 3bf9d678..092785a9 100644
--- a/hindsight-clients/python/hindsight_client_api/models/bank_list_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/bank_list_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/bank_profile_response.py b/hindsight-clients/python/hindsight_client_api/models/bank_profile_response.py
index 45cdcac4..45f95a2d 100644
--- a/hindsight-clients/python/hindsight_client_api/models/bank_profile_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/bank_profile_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/bank_stats_response.py b/hindsight-clients/python/hindsight_client_api/models/bank_stats_response.py
index 81043320..64d73c5b 100644
--- a/hindsight-clients/python/hindsight_client_api/models/bank_stats_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/bank_stats_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/budget.py b/hindsight-clients/python/hindsight_client_api/models/budget.py
index 20f33de3..91db1699 100644
--- a/hindsight-clients/python/hindsight_client_api/models/budget.py
+++ b/hindsight-clients/python/hindsight_client_api/models/budget.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/cancel_operation_response.py b/hindsight-clients/python/hindsight_client_api/models/cancel_operation_response.py
index 4c30abfa..9f21dacf 100644
--- a/hindsight-clients/python/hindsight_client_api/models/cancel_operation_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/cancel_operation_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/child_operation_status.py b/hindsight-clients/python/hindsight_client_api/models/child_operation_status.py
index 42ea31b3..77966a05 100644
--- a/hindsight-clients/python/hindsight_client_api/models/child_operation_status.py
+++ b/hindsight-clients/python/hindsight_client_api/models/child_operation_status.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/chunk_data.py b/hindsight-clients/python/hindsight_client_api/models/chunk_data.py
index ba30458f..cc51ea2c 100644
--- a/hindsight-clients/python/hindsight_client_api/models/chunk_data.py
+++ b/hindsight-clients/python/hindsight_client_api/models/chunk_data.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/chunk_include_options.py b/hindsight-clients/python/hindsight_client_api/models/chunk_include_options.py
index e43e8da3..f84fa17c 100644
--- a/hindsight-clients/python/hindsight_client_api/models/chunk_include_options.py
+++ b/hindsight-clients/python/hindsight_client_api/models/chunk_include_options.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/chunk_response.py b/hindsight-clients/python/hindsight_client_api/models/chunk_response.py
index c3f1d650..e0ea4d0e 100644
--- a/hindsight-clients/python/hindsight_client_api/models/chunk_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/chunk_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/consolidation_response.py b/hindsight-clients/python/hindsight_client_api/models/consolidation_response.py
index df830264..6c5de9a5 100644
--- a/hindsight-clients/python/hindsight_client_api/models/consolidation_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/consolidation_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/create_bank_request.py b/hindsight-clients/python/hindsight_client_api/models/create_bank_request.py
index 6cb0b5f0..07137e1c 100644
--- a/hindsight-clients/python/hindsight_client_api/models/create_bank_request.py
+++ b/hindsight-clients/python/hindsight_client_api/models/create_bank_request.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/create_directive_request.py b/hindsight-clients/python/hindsight_client_api/models/create_directive_request.py
index 2d7b4a96..acae4a77 100644
--- a/hindsight-clients/python/hindsight_client_api/models/create_directive_request.py
+++ b/hindsight-clients/python/hindsight_client_api/models/create_directive_request.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/create_mental_model_request.py b/hindsight-clients/python/hindsight_client_api/models/create_mental_model_request.py
index 7295cb37..96cb176a 100644
--- a/hindsight-clients/python/hindsight_client_api/models/create_mental_model_request.py
+++ b/hindsight-clients/python/hindsight_client_api/models/create_mental_model_request.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/create_mental_model_response.py b/hindsight-clients/python/hindsight_client_api/models/create_mental_model_response.py
index 0527fbb4..8281ac3a 100644
--- a/hindsight-clients/python/hindsight_client_api/models/create_mental_model_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/create_mental_model_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/delete_document_response.py b/hindsight-clients/python/hindsight_client_api/models/delete_document_response.py
index df27b4b5..5324908a 100644
--- a/hindsight-clients/python/hindsight_client_api/models/delete_document_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/delete_document_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/delete_response.py b/hindsight-clients/python/hindsight_client_api/models/delete_response.py
index c4af59b9..a112381a 100644
--- a/hindsight-clients/python/hindsight_client_api/models/delete_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/delete_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/directive_list_response.py b/hindsight-clients/python/hindsight_client_api/models/directive_list_response.py
index 975a0386..9fc743be 100644
--- a/hindsight-clients/python/hindsight_client_api/models/directive_list_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/directive_list_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/directive_response.py b/hindsight-clients/python/hindsight_client_api/models/directive_response.py
index d96aff50..2cdd5870 100644
--- a/hindsight-clients/python/hindsight_client_api/models/directive_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/directive_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/disposition_traits.py b/hindsight-clients/python/hindsight_client_api/models/disposition_traits.py
index 80c671a5..e5b72408 100644
--- a/hindsight-clients/python/hindsight_client_api/models/disposition_traits.py
+++ b/hindsight-clients/python/hindsight_client_api/models/disposition_traits.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/document_response.py b/hindsight-clients/python/hindsight_client_api/models/document_response.py
index 5418386a..8c936694 100644
--- a/hindsight-clients/python/hindsight_client_api/models/document_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/document_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/entity_detail_response.py b/hindsight-clients/python/hindsight_client_api/models/entity_detail_response.py
index 22f4a662..6325715f 100644
--- a/hindsight-clients/python/hindsight_client_api/models/entity_detail_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/entity_detail_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/entity_include_options.py b/hindsight-clients/python/hindsight_client_api/models/entity_include_options.py
index fec254e3..5863c11e 100644
--- a/hindsight-clients/python/hindsight_client_api/models/entity_include_options.py
+++ b/hindsight-clients/python/hindsight_client_api/models/entity_include_options.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/entity_input.py b/hindsight-clients/python/hindsight_client_api/models/entity_input.py
index ef78c20d..2537be18 100644
--- a/hindsight-clients/python/hindsight_client_api/models/entity_input.py
+++ b/hindsight-clients/python/hindsight_client_api/models/entity_input.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/entity_list_item.py b/hindsight-clients/python/hindsight_client_api/models/entity_list_item.py
index 9026510a..0f8a00ca 100644
--- a/hindsight-clients/python/hindsight_client_api/models/entity_list_item.py
+++ b/hindsight-clients/python/hindsight_client_api/models/entity_list_item.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/entity_list_response.py b/hindsight-clients/python/hindsight_client_api/models/entity_list_response.py
index d9a0e851..a6e7a355 100644
--- a/hindsight-clients/python/hindsight_client_api/models/entity_list_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/entity_list_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/entity_observation_response.py b/hindsight-clients/python/hindsight_client_api/models/entity_observation_response.py
index 19db824c..395c8531 100644
--- a/hindsight-clients/python/hindsight_client_api/models/entity_observation_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/entity_observation_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/entity_state_response.py b/hindsight-clients/python/hindsight_client_api/models/entity_state_response.py
index 620ea70b..b205218a 100644
--- a/hindsight-clients/python/hindsight_client_api/models/entity_state_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/entity_state_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/features_info.py b/hindsight-clients/python/hindsight_client_api/models/features_info.py
index 3ddb3526..60f272b6 100644
--- a/hindsight-clients/python/hindsight_client_api/models/features_info.py
+++ b/hindsight-clients/python/hindsight_client_api/models/features_info.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/file_retain_response.py b/hindsight-clients/python/hindsight_client_api/models/file_retain_response.py
index 9630621f..a564a01b 100644
--- a/hindsight-clients/python/hindsight_client_api/models/file_retain_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/file_retain_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/graph_data_response.py b/hindsight-clients/python/hindsight_client_api/models/graph_data_response.py
index f1b6fb6a..14f406c1 100644
--- a/hindsight-clients/python/hindsight_client_api/models/graph_data_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/graph_data_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/http_validation_error.py b/hindsight-clients/python/hindsight_client_api/models/http_validation_error.py
index 19bfe5ca..303d3156 100644
--- a/hindsight-clients/python/hindsight_client_api/models/http_validation_error.py
+++ b/hindsight-clients/python/hindsight_client_api/models/http_validation_error.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/include_options.py b/hindsight-clients/python/hindsight_client_api/models/include_options.py
index 53cca5cb..bf44dd87 100644
--- a/hindsight-clients/python/hindsight_client_api/models/include_options.py
+++ b/hindsight-clients/python/hindsight_client_api/models/include_options.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/list_documents_response.py b/hindsight-clients/python/hindsight_client_api/models/list_documents_response.py
index cef6ab67..0a2d0e95 100644
--- a/hindsight-clients/python/hindsight_client_api/models/list_documents_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/list_documents_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/list_memory_units_response.py b/hindsight-clients/python/hindsight_client_api/models/list_memory_units_response.py
index 35dbd6ca..7834b896 100644
--- a/hindsight-clients/python/hindsight_client_api/models/list_memory_units_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/list_memory_units_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/list_tags_response.py b/hindsight-clients/python/hindsight_client_api/models/list_tags_response.py
index fdcb1195..1a79652d 100644
--- a/hindsight-clients/python/hindsight_client_api/models/list_tags_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/list_tags_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/memory_item.py b/hindsight-clients/python/hindsight_client_api/models/memory_item.py
index 4c987a2f..0d7cbd15 100644
--- a/hindsight-clients/python/hindsight_client_api/models/memory_item.py
+++ b/hindsight-clients/python/hindsight_client_api/models/memory_item.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/mental_model_list_response.py b/hindsight-clients/python/hindsight_client_api/models/mental_model_list_response.py
index fab13497..6149225f 100644
--- a/hindsight-clients/python/hindsight_client_api/models/mental_model_list_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/mental_model_list_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/mental_model_response.py b/hindsight-clients/python/hindsight_client_api/models/mental_model_response.py
index 7d0b9023..a78e75d5 100644
--- a/hindsight-clients/python/hindsight_client_api/models/mental_model_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/mental_model_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/mental_model_trigger.py b/hindsight-clients/python/hindsight_client_api/models/mental_model_trigger.py
index 1de44082..0f96bc42 100644
--- a/hindsight-clients/python/hindsight_client_api/models/mental_model_trigger.py
+++ b/hindsight-clients/python/hindsight_client_api/models/mental_model_trigger.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/operation_response.py b/hindsight-clients/python/hindsight_client_api/models/operation_response.py
index d3ed2ce8..78c4646a 100644
--- a/hindsight-clients/python/hindsight_client_api/models/operation_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/operation_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/operation_status_response.py b/hindsight-clients/python/hindsight_client_api/models/operation_status_response.py
index 52bf4708..c18f15d0 100644
--- a/hindsight-clients/python/hindsight_client_api/models/operation_status_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/operation_status_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/operations_list_response.py b/hindsight-clients/python/hindsight_client_api/models/operations_list_response.py
index 88635768..75cf6bdb 100644
--- a/hindsight-clients/python/hindsight_client_api/models/operations_list_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/operations_list_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/recall_request.py b/hindsight-clients/python/hindsight_client_api/models/recall_request.py
index 957c8b45..8e110d65 100644
--- a/hindsight-clients/python/hindsight_client_api/models/recall_request.py
+++ b/hindsight-clients/python/hindsight_client_api/models/recall_request.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/recall_response.py b/hindsight-clients/python/hindsight_client_api/models/recall_response.py
index 36392304..5146b5bd 100644
--- a/hindsight-clients/python/hindsight_client_api/models/recall_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/recall_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/recall_result.py b/hindsight-clients/python/hindsight_client_api/models/recall_result.py
index 9ca7a96f..536aeb0e 100644
--- a/hindsight-clients/python/hindsight_client_api/models/recall_result.py
+++ b/hindsight-clients/python/hindsight_client_api/models/recall_result.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/reflect_based_on.py b/hindsight-clients/python/hindsight_client_api/models/reflect_based_on.py
index 9454208c..ecb2880a 100644
--- a/hindsight-clients/python/hindsight_client_api/models/reflect_based_on.py
+++ b/hindsight-clients/python/hindsight_client_api/models/reflect_based_on.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/reflect_directive.py b/hindsight-clients/python/hindsight_client_api/models/reflect_directive.py
index c9619a9c..7d33e57f 100644
--- a/hindsight-clients/python/hindsight_client_api/models/reflect_directive.py
+++ b/hindsight-clients/python/hindsight_client_api/models/reflect_directive.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/reflect_fact.py b/hindsight-clients/python/hindsight_client_api/models/reflect_fact.py
index d04b1623..dd33fe37 100644
--- a/hindsight-clients/python/hindsight_client_api/models/reflect_fact.py
+++ b/hindsight-clients/python/hindsight_client_api/models/reflect_fact.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/reflect_include_options.py b/hindsight-clients/python/hindsight_client_api/models/reflect_include_options.py
index ce4839a6..ef280bdf 100644
--- a/hindsight-clients/python/hindsight_client_api/models/reflect_include_options.py
+++ b/hindsight-clients/python/hindsight_client_api/models/reflect_include_options.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/reflect_llm_call.py b/hindsight-clients/python/hindsight_client_api/models/reflect_llm_call.py
index 8f46c43d..f5b32f6f 100644
--- a/hindsight-clients/python/hindsight_client_api/models/reflect_llm_call.py
+++ b/hindsight-clients/python/hindsight_client_api/models/reflect_llm_call.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/reflect_mental_model.py b/hindsight-clients/python/hindsight_client_api/models/reflect_mental_model.py
index 6858d92f..cafa50b3 100644
--- a/hindsight-clients/python/hindsight_client_api/models/reflect_mental_model.py
+++ b/hindsight-clients/python/hindsight_client_api/models/reflect_mental_model.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/reflect_request.py b/hindsight-clients/python/hindsight_client_api/models/reflect_request.py
index c3059cf7..a959587d 100644
--- a/hindsight-clients/python/hindsight_client_api/models/reflect_request.py
+++ b/hindsight-clients/python/hindsight_client_api/models/reflect_request.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/reflect_response.py b/hindsight-clients/python/hindsight_client_api/models/reflect_response.py
index 1359e14d..ab2a83fc 100644
--- a/hindsight-clients/python/hindsight_client_api/models/reflect_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/reflect_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/reflect_tool_call.py b/hindsight-clients/python/hindsight_client_api/models/reflect_tool_call.py
index 1e1acf4f..0c2047c8 100644
--- a/hindsight-clients/python/hindsight_client_api/models/reflect_tool_call.py
+++ b/hindsight-clients/python/hindsight_client_api/models/reflect_tool_call.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/reflect_trace.py b/hindsight-clients/python/hindsight_client_api/models/reflect_trace.py
index 52fde399..e908d954 100644
--- a/hindsight-clients/python/hindsight_client_api/models/reflect_trace.py
+++ b/hindsight-clients/python/hindsight_client_api/models/reflect_trace.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/retain_request.py b/hindsight-clients/python/hindsight_client_api/models/retain_request.py
index e8501e35..11a952c4 100644
--- a/hindsight-clients/python/hindsight_client_api/models/retain_request.py
+++ b/hindsight-clients/python/hindsight_client_api/models/retain_request.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/retain_response.py b/hindsight-clients/python/hindsight_client_api/models/retain_response.py
index f42e5da8..da9fa2a7 100644
--- a/hindsight-clients/python/hindsight_client_api/models/retain_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/retain_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/tag_item.py b/hindsight-clients/python/hindsight_client_api/models/tag_item.py
index 8bafd3fb..9619f928 100644
--- a/hindsight-clients/python/hindsight_client_api/models/tag_item.py
+++ b/hindsight-clients/python/hindsight_client_api/models/tag_item.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/token_usage.py b/hindsight-clients/python/hindsight_client_api/models/token_usage.py
index bdffa86c..568079f2 100644
--- a/hindsight-clients/python/hindsight_client_api/models/token_usage.py
+++ b/hindsight-clients/python/hindsight_client_api/models/token_usage.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/tool_calls_include_options.py b/hindsight-clients/python/hindsight_client_api/models/tool_calls_include_options.py
index b6735e50..6a81406a 100644
--- a/hindsight-clients/python/hindsight_client_api/models/tool_calls_include_options.py
+++ b/hindsight-clients/python/hindsight_client_api/models/tool_calls_include_options.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/update_directive_request.py b/hindsight-clients/python/hindsight_client_api/models/update_directive_request.py
index 486360e2..86952625 100644
--- a/hindsight-clients/python/hindsight_client_api/models/update_directive_request.py
+++ b/hindsight-clients/python/hindsight_client_api/models/update_directive_request.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/update_disposition_request.py b/hindsight-clients/python/hindsight_client_api/models/update_disposition_request.py
index 5e01a129..feb047e8 100644
--- a/hindsight-clients/python/hindsight_client_api/models/update_disposition_request.py
+++ b/hindsight-clients/python/hindsight_client_api/models/update_disposition_request.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/update_mental_model_request.py b/hindsight-clients/python/hindsight_client_api/models/update_mental_model_request.py
index 7b1796df..e0b7ccf2 100644
--- a/hindsight-clients/python/hindsight_client_api/models/update_mental_model_request.py
+++ b/hindsight-clients/python/hindsight_client_api/models/update_mental_model_request.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/validation_error.py b/hindsight-clients/python/hindsight_client_api/models/validation_error.py
index 06c2231e..12ff154f 100644
--- a/hindsight-clients/python/hindsight_client_api/models/validation_error.py
+++ b/hindsight-clients/python/hindsight_client_api/models/validation_error.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/validation_error_loc_inner.py b/hindsight-clients/python/hindsight_client_api/models/validation_error_loc_inner.py
index e2c2252e..9ac62ebd 100644
--- a/hindsight-clients/python/hindsight_client_api/models/validation_error_loc_inner.py
+++ b/hindsight-clients/python/hindsight_client_api/models/validation_error_loc_inner.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/models/version_response.py b/hindsight-clients/python/hindsight_client_api/models/version_response.py
index 4b081f99..d4dc9b09 100644
--- a/hindsight-clients/python/hindsight_client_api/models/version_response.py
+++ b/hindsight-clients/python/hindsight_client_api/models/version_response.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/hindsight_client_api/rest.py b/hindsight-clients/python/hindsight_client_api/rest.py
index 5bf8cc6f..ff952032 100644
--- a/hindsight-clients/python/hindsight_client_api/rest.py
+++ b/hindsight-clients/python/hindsight_client_api/rest.py
@@ -5,7 +5,7 @@
 
     HTTP API for Hindsight
 
-    The version of the OpenAPI document: 0.4.11
+    The version of the OpenAPI document: 0.4.12
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
diff --git a/hindsight-clients/python/pyproject.toml b/hindsight-clients/python/pyproject.toml
index 57ba35a8..be94a9e2 100644
--- a/hindsight-clients/python/pyproject.toml
+++ b/hindsight-clients/python/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "hindsight-client"
-version = "0.4.11"
+version = "0.4.12"
 description = "Python client for Hindsight - Semantic memory system with personality-driven thinking"
 authors = [
     {name = "Hindsight Team"}
diff --git a/hindsight-clients/typescript/package.json b/hindsight-clients/typescript/package.json
index 4292afdb..af26afe0 100644
--- a/hindsight-clients/typescript/package.json
+++ b/hindsight-clients/typescript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@vectorize-io/hindsight-client",
-  "version": "0.4.11",
+  "version": "0.4.12",
   "description": "TypeScript client for Hindsight - Semantic memory system with personality-driven thinking",
   "main": "./dist/src/index.js",
   "types": "./dist/src/index.d.ts",
diff --git a/hindsight-control-plane/package.json b/hindsight-control-plane/package.json
index a56ff0ae..c6385c96 100644
--- a/hindsight-control-plane/package.json
+++ b/hindsight-control-plane/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@vectorize-io/hindsight-control-plane",
-  "version": "0.4.11",
+  "version": "0.4.12",
   "description": "Control plane for Hindsight - Semantic memory system",
   "bin": {
     "hindsight-control-plane": "./bin/cli.js"
diff --git a/hindsight-dev/pyproject.toml b/hindsight-dev/pyproject.toml
index 9df0f48a..de1a2307 100644
--- a/hindsight-dev/pyproject.toml
+++ b/hindsight-dev/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hindsight-dev"
-version = "0.4.11"
+version = "0.4.12"
 description = "Development utilities for Hindsight"
 requires-python = ">=3.11"
 dependencies = [
diff --git a/hindsight-docs/static/openapi.json b/hindsight-docs/static/openapi.json
index 73cc5e5d..e6fe5c47 100644
--- a/hindsight-docs/static/openapi.json
+++ b/hindsight-docs/static/openapi.json
@@ -10,7 +10,7 @@
       "name": "Apache 2.0",
       "url": "https://www.apache.org/licenses/LICENSE-2.0.html"
     },
-    "version": "0.4.11"
+    "version": "0.4.12"
   },
   "paths": {
     "/health": {
diff --git a/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/go-memory-service.md b/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/go-memory-service.md
new file mode 100644
index 00000000..2cc8db82
--- /dev/null
+++ b/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/go-memory-service.md
@@ -0,0 +1,102 @@
+---
+sidebar_position: 3
+---
+
+# Go Memory-Augmented API
+
+
+:::info Complete Application
+This is a complete, runnable application demonstrating Hindsight integration.
+[**View source on GitHub →**](https://github.com/vectorize-io/hindsight-cookbook/tree/main/applications/go-memory-service)
+:::
+
+
+A Go HTTP microservice demonstrating per-user memory isolation with Hindsight. Remembers each user's tech stack, problems solved, and preferences to provide personalized assistance.
+
+## Features
+
+- 🔐 **Per-User Isolation**: Each user gets their own memory bank
+- 🧠 **Context-Aware Responses**: Uses recall + reflect for personalized answers
+- 🏃 **Fire-and-Forget Memory**: Background goroutines store interactions without blocking responses
+- 🏷️ **Tag-Based Partitioning**: Organize memories by type (projects, debugging, preferences)
+
+## Setup
+
+### 1. Start Hindsight
+
+```bash
+export OPENAI_API_KEY=your-key
+
+docker run --rm -it --pull always -p 8888:8888 -p 9999:9999 \
+  -e HINDSIGHT_API_LLM_API_KEY=$OPENAI_API_KEY \
+  -e HINDSIGHT_API_LLM_MODEL=o3-mini \
+  -v $HOME/.hindsight-docker:/home/hindsight/.pg0 \
+  ghcr.io/vectorize-io/hindsight:latest
+```
+
+### 2. Run the service
+
+```bash
+go run main.go
+```
+
+### 3. Try it out
+
+```bash
+# Store memories
+curl -s localhost:8080/learn -d '{
+  "user_id": "alice",
+  "content": "I am building a Go microservice with gRPC and PostgreSQL",
+  "tags": ["project"]
+}'
+
+curl -s localhost:8080/learn -d '{
+  "user_id": "alice",
+  "content": "I prefer structured logging with slog over zerolog",
+  "tags": ["preferences"]
+}'
+
+# Ask questions (uses recall + reflect)
+curl -s localhost:8080/ask -d '{
+  "user_id": "alice",
+  "query": "What tech stack am I using?"
+}' | jq .
+
+# Raw memory recall
+curl -s "localhost:8080/recall/alice?q=database" | jq .
+```
+
+## API Endpoints
+
+- `POST /learn` - Store new information for a user
+- `POST /ask` - Ask a question using the user's memories
+- `GET /recall/{userID}?q=query` - Direct memory recall
+- `GET /health` - Health check
+
+## Key Patterns
+
+**Per-User Banks**: Each user gets an isolated memory bank (`user-alice`, `user-bob`)
+
+**Async Memory Storage**: Interactions are stored in background goroutines:
+
+```go
+go func() {
+    bgCtx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
+    defer cancel()
+
+    retainReq := hindsight.RetainRequest{
+        Items: []hindsight.MemoryItem{{
+            Content: interaction,
+            Context: *hindsight.NewNullableString(hindsight.PtrString("Q&A interaction")),
+        }},
+    }
+    client.MemoryAPI.RetainMemories(bgCtx, bankID).RetainRequest(retainReq).Execute()
+}()
+```
+
+**Tag-Based Filtering**: Partition memories within a bank by type for scoped retrieval
+
+## Learn More
+
+- [Go SDK Documentation](https://hindsight.vectorize.io/sdks/go)
+- [Hindsight Documentation](https://hindsight.vectorize.io)
diff --git a/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/hindsight-litellm-demo.md b/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/hindsight-litellm-demo.md
index ea55cd0e..6ec29c3c 100644
--- a/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/hindsight-litellm-demo.md
+++ b/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/hindsight-litellm-demo.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 3
+sidebar_position: 4
 ---
 
 # Memory Approaches Comparison Demo
diff --git a/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/hindsight-tool-learning-demo.md b/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/hindsight-tool-learning-demo.md
index f8f8cf7b..81d10dbf 100644
--- a/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/hindsight-tool-learning-demo.md
+++ b/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/hindsight-tool-learning-demo.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 4
+sidebar_position: 5
 ---
 
 # Tool Learning Demo
diff --git a/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/openai-fitness-coach.md b/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/openai-fitness-coach.md
index d5bb278f..d0971fc0 100644
--- a/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/openai-fitness-coach.md
+++ b/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/openai-fitness-coach.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 5
+sidebar_position: 6
 ---
 
 # OpenAI Agent + Hindsight Memory Integration
diff --git a/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/sanity-blog-memory.md b/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/sanity-blog-memory.md
index 798ced50..fc555869 100644
--- a/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/sanity-blog-memory.md
+++ b/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/sanity-blog-memory.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 6
+sidebar_position: 7
 ---
 
 # Sanity CMS Blog Memory
diff --git a/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/stancetracker.md b/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/stancetracker.md
index 9e6ce781..5d464017 100644
--- a/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/stancetracker.md
+++ b/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/stancetracker.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 7
+sidebar_position: 8
 ---
 
 # Stance Tracker
diff --git a/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/taste-ai.md b/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/taste-ai.md
index f5c9888d..b6883c16 100644
--- a/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/taste-ai.md
+++ b/hindsight-docs/versioned_docs/version-0.4/cookbook/applications/taste-ai.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 8
+sidebar_position: 9
 ---
 
 # Hindsight AI SDK - Personal Chef
diff --git a/hindsight-docs/versioned_docs/version-0.4/cookbook/index.mdx b/hindsight-docs/versioned_docs/version-0.4/cookbook/index.mdx
index cb22bd4d..f6e63c5b 100644
--- a/hindsight-docs/versioned_docs/version-0.4/cookbook/index.mdx
+++ b/hindsight-docs/versioned_docs/version-0.4/cookbook/index.mdx
@@ -105,6 +105,12 @@ Learn how to build with Hindsight through practical examples:
       description: "Delivery agent simulation demonstrating learning through mental models",
       tags: { sdk: "hindsight-client", topic: "Learning" }
     },
+    {
+      title: "Go Memory-Augmented API",
+      href: "/cookbook/applications/go-memory-service",
+      description: "Go HTTP microservice with per-user memory banks for a developer knowledge assistant",
+      tags: { sdk: "hindsight-go", topic: "Learning" }
+    },
     {
       title: "Memory Approaches Comparison Demo",
       href: "/cookbook/applications/hindsight-litellm-demo",
diff --git a/hindsight-docs/versioned_docs/version-0.4/developer/api/recall.mdx b/hindsight-docs/versioned_docs/version-0.4/developer/api/recall.mdx
index 6f8e6104..a087bd03 100644
--- a/hindsight-docs/versioned_docs/version-0.4/developer/api/recall.mdx
+++ b/hindsight-docs/versioned_docs/version-0.4/developer/api/recall.mdx
@@ -44,10 +44,10 @@ Make sure you've completed the [Quick Start](./quickstart) to install the client
 | `query` | string | required | Natural language query |
 | `types` | list | all | Filter: `world`, `experience`, `observation` |
 | `budget` | string | "mid" | Budget level: `low`, `mid`, `high` |
-| `max_tokens` | int | 4096 | Token budget for results |
+| `max_tokens` | int | 4096 | Token budget for memory facts (text only) |
 | `trace` | bool | false | Enable trace output for debugging |
 | `include_chunks` | bool | false | Include raw text chunks that generated the memories |
-| `max_chunk_tokens` | int | 500 | Token budget for chunks |
+| `max_chunk_tokens` | int | 500 | Token budget for chunks (independent of `max_tokens`) |
 | `tags` | list | None | Filter memories by tags (see [Tag Filtering](#filter-by-tags)) |
 | `tags_match` | string | "any" | How to match tags: `any`, `all`, `any_strict`, `all_strict` |
 
@@ -93,6 +93,15 @@ The `max_tokens` parameter lets you control how much of your agent's context bud
 
 This design means you never have to guess whether 10 results or 50 results will fit your context. Just specify the token budget and Hindsight returns as many relevant memories as will fit.
 
+:::note Chunks are Independent
+When `include_chunks=True`, chunks are fetched **independently** of the `max_tokens` filtering. This means:
+- Setting `max_tokens=0` will return **0 memory facts** but can still return **chunks** (up to `max_chunk_tokens`)
+- Chunks are based on the top-scored (reranked) results **before** token filtering
+- Chunks are fetched in batches (batch size estimated as `(max_chunk_tokens / retain_chunk_size) * 2`) until the token budget is exhausted
+- This batching approach handles varying chunk sizes across documents efficiently
+- This allows you to retrieve raw source text without memory facts when needed
+:::
+
 ## Budget Levels
 
 The `budget` parameter controls graph traversal depth:
diff --git a/hindsight-docs/versioned_docs/version-0.4/developer/api/retain.mdx b/hindsight-docs/versioned_docs/version-0.4/developer/api/retain.mdx
index c9073567..d2d63616 100644
--- a/hindsight-docs/versioned_docs/version-0.4/developer/api/retain.mdx
+++ b/hindsight-docs/versioned_docs/version-0.4/developer/api/retain.mdx
@@ -102,20 +102,47 @@ The `document_id` groups related memories for later management.
 
 ## Store from Files
 
+Upload files directly — Hindsight automatically converts them to text and extracts memories. File processing always runs asynchronously and returns operation IDs for tracking.
+
+**Supported formats:** PDF, DOCX, DOC, PPTX, PPT, XLSX, XLS, images (JPG, PNG, GIF, etc. — OCR), audio (MP3, WAV, FLAC, etc. — transcription), HTML, and plain text formats (TXT, MD, CSV, JSON, YAML, etc.)
+
 <Tabs>
 <TabItem value="cli" label="CLI">
-
-```bash
-# Single file
-hindsight memory retain-files my-bank document.txt
-
-# Directory (recursive by default)
-hindsight memory retain-files my-bank ./documents/
-```
-
+<CodeSnippet code={retainSh} section="retain-files" language="bash" />
+</TabItem>
+<TabItem value="curl" label="HTTP">
+<CodeSnippet code={retainSh} section="retain-files-curl" language="bash" />
+</TabItem>
+<TabItem value="python" label="Python">
+<CodeSnippet code={retainPy} section="retain-files" language="python" />
+</TabItem>
+<TabItem value="node" label="Node.js">
+<CodeSnippet code={retainMjs} section="retain-files" language="javascript" />
 </TabItem>
 </Tabs>
 
+### File Retain Response
+
+The file retain endpoint always returns asynchronously:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `operation_ids` | string[] | One operation ID per uploaded file. Use `GET /v1/default/banks/{bank_id}/operations` to track progress. |
+
+### Batch File Uploads
+
+Upload up to 10 files per request (max 100 MB total). Each file becomes a separate document with optional per-file metadata:
+
+<Tabs>
+<TabItem value="python" label="Python">
+<CodeSnippet code={retainPy} section="retain-files-batch" language="python" />
+</TabItem>
+</Tabs>
+
+:::info File Storage
+Uploaded files are stored server-side (PostgreSQL by default, or S3/GCS/Azure for production). Configure storage via `HINDSIGHT_API_FILE_STORAGE_TYPE`. See [Configuration](../configuration#file-processing) for details.
+:::
+
 
 ## Async Ingestion
 
diff --git a/hindsight-docs/versioned_docs/version-0.4/developer/configuration.md b/hindsight-docs/versioned_docs/version-0.4/developer/configuration.md
index 967fae9b..b5f7032f 100644
--- a/hindsight-docs/versioned_docs/version-0.4/developer/configuration.md
+++ b/hindsight-docs/versioned_docs/version-0.4/developer/configuration.md
@@ -61,31 +61,63 @@ hindsight-admin run-db-migration --schema tenant_acme
 
 | Variable | Description | Default |
 |----------|-------------|---------|
-| `HINDSIGHT_API_VECTOR_EXTENSION` | Vector extension to use: `auto`, `pgvector`, or `vchord` | `auto` |
+| `HINDSIGHT_API_VECTOR_EXTENSION` | Vector index algorithm: `pgvector`, `vchord`, or `pgvectorscale` | `pgvector` |
 
-Hindsight supports two PostgreSQL vector extensions:
-- **pgvector**: Standard extension, works well for most embeddings (up to ~2000 dimensions)
-- **vchord**: Optimized for high-dimensional embeddings (3000+ dimensions), includes BM25 search
+Hindsight supports three PostgreSQL vector extensions:
 
-When set to `auto` (default), Hindsight automatically detects which extension is installed, preferring vchord if both are available.
+#### **pgvector** (HNSW - default)
+- In-memory index using Hierarchical Navigable Small World algorithm
+- Works well for most embeddings and dataset sizes
+- Fast for small-medium datasets (&lt;10M vectors)
+- Higher memory usage for large datasets
+- Most widely deployed and supported
+
+#### **pgvectorscale** (DiskANN - recommended for scale) ⭐
+- Disk-based index using StreamingDiskANN algorithm
+- **28x lower p95 latency** and **16x higher throughput** vs dedicated vector DBs
+- **60-75% cost reduction** at scale (SSDs cheaper than RAM)
+- Superior filtering performance with streaming retrieval model
+- Optimized for large datasets (10M+ vectors)
+- Supports both **pgvectorscale** (open source) and **pg_diskann** (Azure)
+- **Installation:**
+  - Open source/self-hosted: `CREATE EXTENSION vector; CREATE EXTENSION vectorscale CASCADE;`
+  - Azure PostgreSQL: `CREATE EXTENSION vector; CREATE EXTENSION pg_diskann CASCADE;`
+
+#### **vchord** (vchordrq)
+- Alternative high-performance vector index
+- Optimized for high-dimensional embeddings (3000+ dimensions)
+- Includes integrated BM25 search capabilities
+- Requires `vchord` extension
+
+**When to use pgvectorscale (DiskANN):**
+- Large datasets (10M+ vectors) ⭐
+- Complex filtering requirements
+- Cost-sensitive deployments
+- Production workloads requiring high throughput
+- When disk I/O is not a bottleneck
+
+**When to use pgvector (HNSW):**
+- Small-medium datasets (&lt;10M vectors)
+- Maximum query speed when all data fits in memory
+- Simple nearest-neighbor queries without filters
+- Standard PostgreSQL deployment preference
 
 **When to use vchord:**
-- Using high-dimensional embeddings (e.g., `text-embedding-3-large` with 3072 dimensions)
-- Need better performance with large embedding dimensions
-- Want to use vchord's BM25 search capabilities
-
-**When to use pgvector:**
-- Using standard embedding dimensions (384-1536)
-- Prefer the widely-adopted pgvector extension
-- Simpler deployment (pgvector is more commonly available)
+- High-dimensional embeddings (3000+ dimensions)
+- Want integrated BM25 search
+- Already using vchord for text search
 
 **Switching extensions:**
 
 If you need to switch from one extension to another:
-1. Set `HINDSIGHT_API_VECTOR_EXTENSION` to your desired extension (`pgvector` or `vchord`)
+1. Set `HINDSIGHT_API_VECTOR_EXTENSION` to your desired extension (`pgvector`, `vchord`, or `pgvectorscale`)
 2. If your database has existing data, you'll get an error with migration instructions
 3. For empty databases, indexes will be automatically recreated on startup
 
+**Learn more:**
+- [HNSW vs. DiskANN comparison](https://www.tigerdata.com/learn/hnsw-vs-diskann)
+- [pgvectorscale GitHub](https://github.com/timescale/pgvectorscale)
+
 ### Text Search Extension
 
 | Variable | Description | Default |
@@ -136,6 +168,7 @@ To switch between backends:
 | `HINDSIGHT_API_LLM_MAX_BACKOFF` | Max retry backoff cap in seconds | `60.0` |
 | `HINDSIGHT_API_LLM_TIMEOUT` | LLM request timeout in seconds | `120` |
 | `HINDSIGHT_API_LLM_GROQ_SERVICE_TIER` | Groq service tier: `on_demand`, `flex`, `auto` | `auto` |
+| `HINDSIGHT_API_LLM_OPENAI_SERVICE_TIER` | OpenAI service tier: `flex` for 50% cost savings (OpenAI Flex Processing) | None (default) |
 
 **Provider Examples**
 
@@ -151,6 +184,8 @@ export HINDSIGHT_API_LLM_MODEL=openai/gpt-oss-20b
 export HINDSIGHT_API_LLM_PROVIDER=openai
 export HINDSIGHT_API_LLM_API_KEY=sk-xxxxxxxxxxxx
 export HINDSIGHT_API_LLM_MODEL=gpt-4o
+# Optional: Use Flex Processing for 50% cost savings (with variable latency)
+# export HINDSIGHT_API_LLM_OPENAI_SERVICE_TIER=flex
 
 # Gemini
 export HINDSIGHT_API_LLM_PROVIDER=gemini
@@ -558,6 +593,8 @@ Controls the retain (memory ingestion) pipeline.
 | `HINDSIGHT_API_RETAIN_EXTRACTION_MODE` | Fact extraction mode: `concise`, `verbose`, or `custom` | `concise` |
 | `HINDSIGHT_API_RETAIN_CUSTOM_INSTRUCTIONS` | Custom extraction guidelines (only used when mode is `custom`) | - |
 | `HINDSIGHT_API_RETAIN_EXTRACT_CAUSAL_LINKS` | Extract causal relationships between facts | `true` |
+| `HINDSIGHT_API_RETAIN_BATCH_ENABLED` | Use LLM Batch API for fact extraction (50% cost savings, only with async operations) | `false` |
+| `HINDSIGHT_API_RETAIN_BATCH_POLL_INTERVAL_SECONDS` | Batch API polling interval in seconds | `60` |
 
 #### Extraction Modes
 
@@ -592,6 +629,136 @@ CONSOLIDATE related technical discussions into ONE fact when possible.
 Ask yourself: 'Would this technical context be useful in 6 months?' If no, skip it."
 ```
 
+### File Processing
+
+Configuration for the file upload and conversion pipeline (used by `POST /v1/default/banks/{bank_id}/files/retain`).
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `HINDSIGHT_API_ENABLE_FILE_UPLOAD_API` | Enable the file upload API endpoint | `true` |
+| `HINDSIGHT_API_FILE_PARSER` | File parser to use (`markitdown`, `iris`) | `markitdown` |
+| `HINDSIGHT_API_FILE_CONVERSION_MAX_BATCH_SIZE` | Max files per upload request | `10` |
+| `HINDSIGHT_API_FILE_CONVERSION_MAX_BATCH_SIZE_MB` | Max total upload size per request (MB) | `100` |
+| `HINDSIGHT_API_FILE_DELETE_AFTER_RETAIN` | Delete stored files after memory extraction completes | `true` |
+
+#### Parser: markitdown (default)
+
+Local file-to-markdown conversion using [Microsoft's markitdown](https://github.com/microsoft/markitdown). No external service required.
+
+**Supported formats:** PDF, DOCX, DOC, PPTX, PPT, XLSX, XLS, images (JPG, PNG — OCR), audio (MP3, WAV — transcription), HTML, TXT, MD, CSV.
+
+#### Parser: iris
+
+Cloud-based extraction via [Vectorize Iris](https://docs.vectorize.io/build-deploy/extract-information/understanding-iris/). Higher quality extraction for complex documents, powered by a remote AI service.
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `HINDSIGHT_API_FILE_PARSER_IRIS_TOKEN` | Vectorize API token | — |
+| `HINDSIGHT_API_FILE_PARSER_IRIS_ORG_ID` | Vectorize organization ID | — |
+
+**Supported formats:** PDF, DOCX, DOC, PPTX, PPT, XLSX, XLS, images (JPG, JPEG, PNG, GIF, BMP, TIFF, WEBP), HTML, TXT, MD, CSV.
+
+```bash
+# Use iris parser (requires Vectorize account)
+export HINDSIGHT_API_FILE_PARSER=iris
+export HINDSIGHT_API_FILE_PARSER_IRIS_TOKEN=your-vectorize-token
+export HINDSIGHT_API_FILE_PARSER_IRIS_ORG_ID=your-org-id
+```
+
+```bash
+# Increase batch limits for large file imports
+export HINDSIGHT_API_FILE_CONVERSION_MAX_BATCH_SIZE=20
+export HINDSIGHT_API_FILE_CONVERSION_MAX_BATCH_SIZE_MB=500
+
+# Keep files after processing (useful for debugging or re-processing)
+export HINDSIGHT_API_FILE_DELETE_AFTER_RETAIN=false
+```
+
+### File Storage
+
+Files uploaded via the file retain API are stored in an object storage backend before conversion. Choose the backend that fits your infrastructure.
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `HINDSIGHT_API_FILE_STORAGE_TYPE` | Storage backend: `native`, `s3`, `gcs`, or `azure` | `native` |
+
+#### Native (PostgreSQL)
+
+Files are stored as `BYTEA` in the `file_storage` table. No additional infrastructure required. Suitable for development and small deployments.
+
+```bash
+# Native storage is the default — no additional configuration needed
+export HINDSIGHT_API_FILE_STORAGE_TYPE=native
+```
+
+#### S3 / S3-Compatible
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `HINDSIGHT_API_FILE_STORAGE_S3_BUCKET` | S3 bucket name | - |
+| `HINDSIGHT_API_FILE_STORAGE_S3_REGION` | AWS region | - |
+| `HINDSIGHT_API_FILE_STORAGE_S3_ENDPOINT` | Custom endpoint URL (for S3-compatible stores like MinIO, Cloudflare R2) | AWS default |
+| `HINDSIGHT_API_FILE_STORAGE_S3_ACCESS_KEY_ID` | AWS access key ID | - |
+| `HINDSIGHT_API_FILE_STORAGE_S3_SECRET_ACCESS_KEY` | AWS secret access key | - |
+
+```bash
+# AWS S3
+export HINDSIGHT_API_FILE_STORAGE_TYPE=s3
+export HINDSIGHT_API_FILE_STORAGE_S3_BUCKET=my-hindsight-files
+export HINDSIGHT_API_FILE_STORAGE_S3_REGION=us-east-1
+export HINDSIGHT_API_FILE_STORAGE_S3_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
+export HINDSIGHT_API_FILE_STORAGE_S3_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
+
+# S3-compatible (MinIO, Cloudflare R2, etc.)
+export HINDSIGHT_API_FILE_STORAGE_TYPE=s3
+export HINDSIGHT_API_FILE_STORAGE_S3_BUCKET=my-bucket
+export HINDSIGHT_API_FILE_STORAGE_S3_ENDPOINT=https://your-minio.example.com
+export HINDSIGHT_API_FILE_STORAGE_S3_ACCESS_KEY_ID=minioadmin
+export HINDSIGHT_API_FILE_STORAGE_S3_SECRET_ACCESS_KEY=minioadmin
+```
+
+#### Google Cloud Storage
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `HINDSIGHT_API_FILE_STORAGE_GCS_BUCKET` | GCS bucket name | - |
+| `HINDSIGHT_API_FILE_STORAGE_GCS_SERVICE_ACCOUNT_KEY` | Path to service account JSON key file | ADC if not set |
+
+```bash
+export HINDSIGHT_API_FILE_STORAGE_TYPE=gcs
+export HINDSIGHT_API_FILE_STORAGE_GCS_BUCKET=my-hindsight-files
+# Optional: use service account key file (otherwise falls back to ADC)
+export HINDSIGHT_API_FILE_STORAGE_GCS_SERVICE_ACCOUNT_KEY=/path/to/key.json
+```
+
+#### Azure Blob Storage
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `HINDSIGHT_API_FILE_STORAGE_AZURE_CONTAINER` | Azure container name | - |
+| `HINDSIGHT_API_FILE_STORAGE_AZURE_ACCOUNT_NAME` | Azure storage account name | - |
+| `HINDSIGHT_API_FILE_STORAGE_AZURE_ACCOUNT_KEY` | Azure storage account key | - |
+
+```bash
+export HINDSIGHT_API_FILE_STORAGE_TYPE=azure
+export HINDSIGHT_API_FILE_STORAGE_AZURE_CONTAINER=hindsight-files
+export HINDSIGHT_API_FILE_STORAGE_AZURE_ACCOUNT_NAME=mystorageaccount
+export HINDSIGHT_API_FILE_STORAGE_AZURE_ACCOUNT_KEY=base64encodedkey==
+```
+
+#### Storage Backend Comparison
+
+| Backend | Best For | Notes |
+|---------|----------|-------|
+| `native` | Development, small deployments | No extra infrastructure, stored in PostgreSQL |
+| `s3` | Production, AWS deployments | Works with any S3-compatible store |
+| `gcs` | Production, GCP deployments | Supports ADC for keyless auth |
+| `azure` | Production, Azure deployments | Uses account key auth |
+
+:::tip Production Recommendation
+For production deployments, use `s3`, `gcs`, or `azure` to avoid storing large binary files in your PostgreSQL database. Set `HINDSIGHT_API_FILE_DELETE_AFTER_RETAIN=true` (the default) to delete files after memory extraction, which minimizes storage costs.
+:::
+
 ### Observations (Experimental)
 
 Observations are consolidated knowledge synthesized from facts.
@@ -952,6 +1119,13 @@ HINDSIGHT_API_LLM_API_KEY=gsk_xxxxxxxxxxxx
 # HINDSIGHT_API_TENANT_EXTENSION=hindsight_api.extensions.builtin.tenant:ApiKeyTenantExtension
 # HINDSIGHT_API_TENANT_API_KEY=your-secret-api-key
 
+# File storage (optional, defaults to PostgreSQL native storage)
+# HINDSIGHT_API_FILE_STORAGE_TYPE=s3
+# HINDSIGHT_API_FILE_STORAGE_S3_BUCKET=my-hindsight-files
+# HINDSIGHT_API_FILE_STORAGE_S3_REGION=us-east-1
+# HINDSIGHT_API_FILE_STORAGE_S3_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
+# HINDSIGHT_API_FILE_STORAGE_S3_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
+
 # Control Plane
 HINDSIGHT_CP_DATAPLANE_API_URL=http://localhost:8888
 ```
diff --git a/hindsight-docs/versioned_docs/version-0.4/developer/installation.md b/hindsight-docs/versioned_docs/version-0.4/developer/installation.md
index 00acd07e..3a79ec80 100644
--- a/hindsight-docs/versioned_docs/version-0.4/developer/installation.md
+++ b/hindsight-docs/versioned_docs/version-0.4/developer/installation.md
@@ -17,7 +17,8 @@ Hindsight requires PostgreSQL with the **pgvector** extension for vector similar
 **For production**, use an external PostgreSQL with pgvector:
 - **Supabase** — Managed PostgreSQL with pgvector built-in
 - **Neon** — Serverless PostgreSQL with pgvector
-- **AWS RDS** / **Cloud SQL** / **Azure** — With pgvector extension enabled
+- **Azure Database for PostgreSQL** — With pgvector and pg_diskann (DiskANN) support
+- **AWS RDS** / **Cloud SQL** — With pgvector extension enabled
 - **Self-hosted** — PostgreSQL 14+ with pgvector installed
 
 ### LLM Provider
diff --git a/hindsight-docs/versioned_docs/version-0.4/developer/performance.md b/hindsight-docs/versioned_docs/version-0.4/developer/performance.md
index 5e52ca21..5896cc4e 100644
--- a/hindsight-docs/versioned_docs/version-0.4/developer/performance.md
+++ b/hindsight-docs/versioned_docs/version-0.4/developer/performance.md
@@ -53,12 +53,29 @@ To maximize retention throughput:
    - **Fast**: [Groq](https://groq.com) with `gpt-oss-20b` or other openai-oss models, self-hosted models on GPU clusters (vLLM, TGI)
    - **Slow**: Standard cloud LLM providers with rate limits
 
-2. **Batch your operations**: Group related content into batch requests. The only limit is the HTTP payload size — Hindsight automatically splits large batches into smaller, optimized chunks under the hood, so you don't have to worry about it.
+2. **Batch your operations**: Group related content into batch requests. Send as much data as you want in a single request — the only limit is the HTTP payload size.
 
 3. **Use async mode for large datasets**: Queue operations in the background
 
 4. **Parallel processing**: For very large datasets, use multiple concurrent retention requests with different `document_id` values
 
+### Automatic Batch Optimization
+
+**When using async retain, Hindsight automatically handles batch sizing for you.** You don't need to manually tune batch sizes or worry about optimal chunking.
+
+How it works:
+- **Send large batches**: Submit hundreds or thousands of items in a single async retain request
+- **Automatic splitting**: Hindsight automatically splits large batches (>10,000 tokens) into optimized sub-batches
+- **Parallel processing**: Sub-batches are processed concurrently in the background
+- **Status tracking**: Parent operation aggregates status from all sub-batches
+- **Token-based**: Batching uses tiktoken for accurate token counting, not character counts
+
+Benefits:
+- Send entire documents or datasets in one API call
+- Let Hindsight optimize the processing strategy
+- Track overall progress via the parent operation status
+- No need to manually split data into small batches
+
 ### Throughput
 
 Factors affecting throughput:
diff --git a/hindsight-docs/versioned_docs/version-0.4/sdks/go.md b/hindsight-docs/versioned_docs/version-0.4/sdks/go.md
index 3d189f46..ecc833f9 100644
--- a/hindsight-docs/versioned_docs/version-0.4/sdks/go.md
+++ b/hindsight-docs/versioned_docs/version-0.4/sdks/go.md
@@ -4,7 +4,10 @@ sidebar_position: 3
 
 # Go Client
 
-Official Go client for the Hindsight API, built on [ogen](https://github.com/ogen-go/ogen) for strongly-typed code generation from the OpenAPI 3.1 spec.
+Official Go client for the Hindsight API, generated from the OpenAPI 3.1 spec using [OpenAPI Generator](https://github.com/OpenAPITools/openapi-generator).
+
+import CodeSnippet from '@site/src/components/CodeSnippet';
+import quickstartGo from '!!raw-loader!@site/examples/api/quickstart.go';
 
 ## Installation
 
@@ -12,283 +15,37 @@ Official Go client for the Hindsight API, built on [ogen](https://github.com/oge
 go get github.com/vectorize-io/hindsight/hindsight-clients/go
 ```
 
-Requires Go 1.25+.
+Requires Go 1.23+.
 
 ## Quick Start
 
-```go
-package main
+<CodeSnippet code={quickstartGo} section="quickstart-full" language="go" />
 
-import (
-    "context"
-    "fmt"
-    "log"
+## API Structure
 
-    hindsight "github.com/vectorize-io/hindsight/hindsight-clients/go"
-)
+The Go client provides access to all Hindsight API operations through structured namespaces:
 
-func main() {
-    client, err := hindsight.New("http://localhost:8888")
-    if err != nil {
-        log.Fatal(err)
-    }
+- **`client.MemoryAPI`** - Retain, recall, reflect operations
+- **`client.BanksAPI`** - Bank management
+- **`client.DirectivesAPI`** - Directive management
+- **`client.MentalModelsAPI`** - Mental model management
+- **`client.DocumentsAPI`** - Document operations
+- **`client.EntitiesAPI`** - Entity operations
+- **`client.OperationsAPI`** - Async operation monitoring
 
-    ctx := context.Background()
+## Working with Nullable Fields
 
-    // Retain a memory
-    client.Retain(ctx, "my-bank", "Alice works at Google")
+The Go client uses `NullableString`, `NullableTime`, and similar types for optional fields:
 
-    // Recall memories
-    resp, _ := client.Recall(ctx, "my-bank", "What does Alice do?")
-    for _, r := range resp.Results {
-        fmt.Println(r.Text)
-    }
-
-    // Reflect - generate response with disposition
-    answer, _ := client.Reflect(ctx, "my-bank", "Tell me about Alice")
-    fmt.Println(answer.Text)
-}
-```
-
-## Client Initialization
-
-```go
-import hindsight "github.com/vectorize-io/hindsight/hindsight-clients/go"
-
-// Default client
-client, err := hindsight.New("http://localhost:8888")
-
-// With API key authentication
-client, err := hindsight.New("http://localhost:8888",
-    hindsight.WithAPIKey("your-api-key"),
-)
-
-// With custom HTTP client
-client, err := hindsight.New("http://localhost:8888",
-    hindsight.WithHTTPClient(&http.Client{Timeout: 30 * time.Second}),
-)
-```
-
-## Core Operations
-
-### Retain (Store Memory)
-
-```go
-// Simple
-_, err := client.Retain(ctx, "my-bank", "Alice works at Google as a software engineer")
-
-// With options
-_, err := client.Retain(ctx, "my-bank", "Alice got promoted",
-    hindsight.WithContext("career update"),
-    hindsight.WithTimestamp(time.Date(2024, 1, 15, 10, 0, 0, 0, time.UTC)),
-    hindsight.WithDocumentID("conversation_001"),
-    hindsight.WithMetadata(map[string]string{"source": "slack"}),
-    hindsight.WithTags([]string{"career", "updates"}),
-)
-```
-
-### Retain Batch
-
-```go
-items := []hindsight.MemoryItem{
-    {Content: "Alice works at Google"},
-    {Content: "Bob is a data scientist"},
-}
-
-_, err := client.RetainBatch(ctx, "my-bank", items,
-    hindsight.WithDocumentTags([]string{"team-info"}),
-    hindsight.WithAsync(false), // Set true for background processing
-)
-```
-
-### Recall (Search)
-
-```go
-// Simple
-resp, err := client.Recall(ctx, "my-bank", "What does Alice do?")
-
-for _, r := range resp.Results {
-    fmt.Printf("  %s (type: %s)\n", r.Text, r.Type.Or("unknown"))
-}
-
-// With options
-resp, err := client.Recall(ctx, "my-bank", "What does Alice do?",
-    hindsight.WithTypes([]string{"world", "experience"}), // Filter by fact type
-    hindsight.WithMaxTokens(4096),
-    hindsight.WithBudget(hindsight.BudgetHigh), // BudgetLow, BudgetMid, BudgetHigh
-    hindsight.WithTrace(true),                   // Include execution trace
-    hindsight.WithRecallTags([]string{"career"}),
-    hindsight.WithRecallTagsMatch(hindsight.TagsMatchAnyStrict),
-)
-```
-
-### Reflect (Generate Response)
-
-```go
-resp, err := client.Reflect(ctx, "my-bank", "What should I know about Alice?",
-    hindsight.WithReflectBudget(hindsight.BudgetMid),
-    hindsight.WithReflectMaxTokens(2048),
-)
-
-fmt.Println(resp.Text) // Generated markdown response
-```
-
-### Reflect with Structured Output
-
-```go
-resp, err := client.Reflect(ctx, "my-bank",
-    "What programming language should I learn for data science?",
-    hindsight.WithResponseSchema(map[string]any{
-        "type": "object",
-        "properties": map[string]any{
-            "recommendation": map[string]any{"type": "string"},
-            "reasons":        map[string]any{"type": "array", "items": map[string]any{"type": "string"}},
-            "confidence":     map[string]any{"type": "string"},
-        },
-        "required": []any{"recommendation", "reasons"},
-    }),
-    hindsight.WithReflectMaxTokens(4096),
-)
-
-// resp.StructuredOutput contains the parsed JSON schema result
-```
-
-## Bank Management
-
-### Create Bank
-
-```go
-_, err := client.CreateBank(ctx, "my-bank",
-    hindsight.WithBankName("Assistant"),
-    hindsight.WithMission("Helpful AI assistant tracking user preferences."),
-    hindsight.WithDisposition(hindsight.DispositionTraits{
-        Skepticism: 3, // 1-5: trusting to skeptical
-        Literalism: 3, // 1-5: flexible to literal
-        Empathy:    3, // 1-5: detached to empathetic
-    }),
-)
-```
-
-### Other Bank Operations
-
-```go
-// Get bank profile
-profile, err := client.GetBankProfile(ctx, "my-bank")
-fmt.Println(profile.Mission)
-
-// List all banks
-banks, err := client.ListBanks(ctx)
-for _, b := range banks.Banks {
-    fmt.Println(b.BankID)
-}
-
-// Update mission
-_, err = client.SetMission(ctx, "my-bank", "New mission statement")
-
-// Update disposition
-_, err = client.UpdateDisposition(ctx, "my-bank", hindsight.DispositionTraits{
-    Skepticism: 4,
-    Literalism: 2,
-    Empathy:    5,
-})
-
-// Delete bank (destructive, cannot be undone)
-err = client.DeleteBank(ctx, "my-bank")
-```
-
-## Tag Filtering
-
-Tags provide visibility scoping for memories. Use them to partition memories within a bank.
-
-```go
-// Store tagged memories
-client.Retain(ctx, "my-bank", "Project X meeting notes",
-    hindsight.WithTags([]string{"project_x", "meetings"}),
-)
-
-// Recall only project_x memories (strict - excludes untagged)
-resp, _ := client.Recall(ctx, "my-bank", "What happened in meetings?",
-    hindsight.WithRecallTags([]string{"project_x"}),
-    hindsight.WithRecallTagsMatch(hindsight.TagsMatchAnyStrict),
-)
-
-// Reflect scoped to tags
-resp, _ := client.Reflect(ctx, "my-bank", "Summarize project X",
-    hindsight.WithReflectTags([]string{"project_x"}),
-    hindsight.WithReflectTagsMatch(hindsight.TagsMatchAnyStrict),
-)
-```
-
-| Match Mode | Behavior |
-|-----------|----------|
-| `TagsMatchAny` | OR matching, includes untagged memories |
-| `TagsMatchAll` | AND matching, includes untagged memories |
-| `TagsMatchAnyStrict` | OR matching, excludes untagged memories |
-| `TagsMatchAllStrict` | AND matching, excludes untagged memories |
-
-## Advanced Usage (ogen Client)
-
-For operations not covered by the high-level wrapper (documents, entities, mental models, directives, operations), access the generated ogen client directly:
-
-```go
-import "github.com/vectorize-io/hindsight/hindsight-clients/go/internal/ogenapi"
-
-ogen := client.OgenClient()
-
-// List entities
-entities, err := ogen.ListEntities(ctx, ogenapi.ListEntitiesParams{
-    BankID: "my-bank",
-})
-
-// Create a mental model
-model, err := ogen.CreateMentalModel(ctx,
-    &ogenapi.CreateMentalModelRequest{
-        Name:        ogenapi.NewOptString("User Preferences"),
-        SourceQuery: "What are this user's preferences and habits?",
-    },
-    ogenapi.CreateMentalModelParams{BankID: "my-bank"},
-)
-
-// Create a directive
-directive, err := ogen.CreateDirective(ctx,
-    &ogenapi.CreateDirectiveRequest{
-        Name:    "Response Style",
-        Content: "Always respond in a friendly, concise manner",
-    },
-    ogenapi.CreateDirectiveParams{BankID: "my-bank"},
-)
-
-// List operations (async tasks)
-ops, err := ogen.ListOperations(ctx, ogenapi.ListOperationsParams{
-    BankID: "my-bank",
-})
-
-// Get bank stats
-stats, err := ogen.GetAgentStats(ctx, ogenapi.GetAgentStatsParams{
-    BankID: "my-bank",
-})
-```
+<CodeSnippet code={quickstartGo} section="nullable-fields" language="go" />
 
 ## Error Handling
 
-The client returns standard Go errors. HTTP errors from the API are returned as ogen error types:
+<CodeSnippet code={quickstartGo} section="error-handling" language="go" />
 
-```go
-resp, err := client.Recall(ctx, "nonexistent-bank", "query")
-if err != nil {
-    // Handle error - could be network, HTTP 4xx/5xx, etc.
-    log.Printf("recall failed: %v", err)
-}
-```
+## More Examples
 
-## Code Generation
-
-The Go client is built on [ogen](https://github.com/ogen-go/ogen). The generated code lives in `internal/ogenapi/` and provides full type safety with no `interface{}` or reflection.
-
-To regenerate after API changes:
-
-```bash
-cd hindsight-clients/go
-go generate ./...
-go build ./...
-```
+For detailed examples of all operations, see:
+- [Python SDK documentation](./python.md) - API concepts are the same
+- [Node.js SDK documentation](./nodejs.md) - API concepts are the same
+- [OpenAPI specification](https://hindsight.dev/openapi.json) - Complete API reference
diff --git a/hindsight-docs/versioned_docs/version-0.4/sdks/integrations/ai-sdk.md b/hindsight-docs/versioned_docs/version-0.4/sdks/integrations/ai-sdk.md
deleted file mode 100644
index c538fc24..00000000
--- a/hindsight-docs/versioned_docs/version-0.4/sdks/integrations/ai-sdk.md
+++ /dev/null
@@ -1,366 +0,0 @@
----
-sidebar_position: 4
----
-
-# Vercel AI SDK
-
-Official Hindsight integration for the [Vercel AI SDK](https://ai-sdk.dev).
-
-## Features
-
-- **7 Memory Tools**: Core memory operations (retain, recall, reflect), mental models (create, query), documents (get), and directives (create)
-- **AI SDK 6 Native**: Works seamlessly with `generateText`, `streamText`, and `ToolLoopAgent`
-- **Multi-User Support**: Dynamic bank IDs per tool call for multi-user/multi-tenant scenarios
-- **Full Parameter Support**: Complete access to all Hindsight API parameters
-- **Type-Safe**: Full TypeScript support with Zod schemas for validation
-
-## Installation
-
-```bash
-npm install @vectorize-io/hindsight-ai-sdk @vectorize-io/hindsight-client ai zod
-```
-
-## Quick Start
-
-### 1. Set up your Hindsight client
-
-```typescript
-import { HindsightClient } from '@vectorize-io/hindsight-client';
-
-const hindsightClient = new HindsightClient({
-  apiUrl: process.env.HINDSIGHT_API_URL || 'http://localhost:8000',
-});
-```
-
-### 2. Create Hindsight tools
-
-```typescript
-import { createHindsightTools } from '@vectorize-io/hindsight-ai-sdk';
-
-const tools = createHindsightTools({
-  client: hindsightClient,
-});
-```
-
-### 3. Use with AI SDK
-
-```typescript
-import { generateText } from 'ai';
-import { anthropic } from '@ai-sdk/anthropic';
-
-const result = await generateText({
-  model: anthropic('claude-sonnet-4-20250514'),
-  tools,
-  prompt: 'Remember that Alice loves hiking and prefers spicy food',
-});
-
-console.log(result.text);
-```
-
-## Memory Tools
-
-The integration provides seven tools that the AI model can use to manage memory:
-
-### `retain` - Store Information
-
-The model calls this tool to store information for future recall.
-
-**Parameters:**
-- `bankId` (required): Memory bank ID (usually the user ID)
-- `content` (required): Content to store
-- `documentId` (optional): Document ID for grouping/upserting related memories
-- `timestamp` (optional): ISO timestamp for when the memory occurred
-- `context` (optional): Additional context about the memory
-- `metadata` (optional): Key-value metadata for filtering
-
-**Example tool call:**
-```typescript
-{
-  bankId: "user-123",
-  content: "Alice loves hiking and goes to Yosemite every summer",
-  context: "User preferences",
-  timestamp: "2024-01-15T10:30:00Z"
-}
-```
-
-**Returns:**
-```typescript
-{
-  success: true,
-  itemsCount: 1
-}
-```
-
-### `recall` - Search Memories
-
-The model calls this tool to search for relevant information in memory.
-
-**Parameters:**
-- `bankId` (required): Memory bank ID
-- `query` (required): What to search for
-- `types` (optional): Filter by fact types (`['world', 'experience', 'opinion']`)
-- `maxTokens` (optional): Maximum tokens to return (default: 4096)
-- `budget` (optional): Processing budget - `'low'`, `'mid'`, or `'high'`
-- `queryTimestamp` (optional): Query from a specific time (ISO format)
-- `includeEntities` (optional): Include entity observations
-- `includeChunks` (optional): Include raw document chunks
-
-**Example tool call:**
-```typescript
-{
-  bankId: "user-123",
-  query: "What does Alice like to do outdoors?",
-  types: ["world", "experience"],
-  maxTokens: 2048,
-  budget: "mid"
-}
-```
-
-**Returns:**
-```typescript
-{
-  results: [
-    {
-      id: "mem-123",
-      text: "Alice loves hiking",
-      type: "world",
-      entities: ["Alice"],
-      context: "User preferences",
-      occurred_start: "2024-01-15T10:30:00Z",
-      document_id: "doc-456",
-      metadata: { source: "chat" }
-    }
-  ],
-  entities: {
-    "Alice": {
-      canonical_name: "Alice",
-      mention_count: 15,
-      observations: [...]
-    }
-  }
-}
-```
-
-### `reflect` - Synthesize Insights
-
-The model calls this tool to analyze memories and generate contextual insights.
-
-**Parameters:**
-- `bankId` (required): Memory bank ID
-- `query` (required): Question to reflect on
-- `context` (optional): Additional context for reflection
-- `budget` (optional): Processing budget - `'low'`, `'mid'`, or `'high'`
-
-**Example tool call:**
-```typescript
-{
-  bankId: "user-123",
-  query: "What outdoor activities does Alice enjoy?",
-  context: "Planning a weekend trip",
-  budget: "mid"
-}
-```
-
-**Returns:**
-```typescript
-{
-  text: "Alice is an avid hiker who particularly enjoys visiting Yosemite National Park during summer months. She has expressed strong preferences for mountain trails over beach activities.",
-  basedOn: [
-    {
-      id: "mem-123",
-      text: "Alice loves hiking",
-      type: "world",
-      context: "User preferences",
-      occurred_start: "2024-01-15T10:30:00Z"
-    }
-  ]
-}
-```
-
-### `createMentalModel` - Create Knowledge Consolidation
-
-The model calls this tool to create a mental model that automatically consolidates memories into structured knowledge.
-
-**Parameters:**
-- `bankId` (required): Memory bank ID
-- `mentalModelId` (optional): Custom ID for the mental model (auto-generated if not provided)
-- `name` (optional): Name for the mental model
-- `sourceQuery` (optional): Query defining which memories to consolidate
-- `tags` (optional): Tags for organizing mental models
-- `maxTokens` (optional): Maximum tokens for the content
-- `autoRefresh` (optional): Auto-refresh after new consolidations (default: false)
-
-**Example tool call:**
-```typescript
-{
-  bankId: "user-123",
-  name: "User Preferences",
-  sourceQuery: "What are the user's preferences?",
-  tags: ["preferences"],
-  autoRefresh: true
-}
-```
-
-**Returns:**
-```typescript
-{
-  mentalModelId: "mm-456",
-  createdAt: "2024-01-15T10:30:00Z"
-}
-```
-
-### `queryMentalModel` - Retrieve Consolidated Knowledge
-
-The model calls this tool to retrieve synthesized insights from an existing mental model.
-
-**Parameters:**
-- `bankId` (required): Memory bank ID
-- `mentalModelId` (required): ID of the mental model to query
-
-**Example tool call:**
-```typescript
-{
-  bankId: "user-123",
-  mentalModelId: "mm-456"
-}
-```
-
-**Returns:**
-```typescript
-{
-  content: "The user prefers outdoor activities, particularly hiking. They enjoy mountain trails and visit Yosemite regularly during summer.",
-  name: "User Preferences",
-  updatedAt: "2024-01-20T15:45:00Z"
-}
-```
-
-### `getDocument` - Retrieve Stored Document
-
-The model calls this tool to retrieve a stored document by its ID.
-
-**Parameters:**
-- `bankId` (required): Memory bank ID
-- `documentId` (required): ID of the document to retrieve
-
-**Example tool call:**
-```typescript
-{
-  bankId: "user-123",
-  documentId: "doc-789"
-}
-```
-
-**Returns:**
-```typescript
-{
-  originalText: "User profile: Alice, Software Engineer, loves hiking...",
-  id: "doc-789",
-  createdAt: "2024-01-10T09:00:00Z",
-  updatedAt: "2024-01-15T14:30:00Z"
-}
-```
-
-### `createDirective` - Create Behavioral Rule
-
-The model calls this tool to create a directive—a hard rule injected into prompts during reflect operations.
-
-**Parameters:**
-- `bankId` (required): Memory bank ID
-- `name` (required): Human-readable name for the directive
-- `content` (required): The directive text to inject
-- `priority` (optional): Higher priority directives are injected first (default: 0)
-- `isActive` (optional): Whether this directive is active (default: true)
-- `tags` (optional): Tags for filtering (e.g., user-specific directives)
-
-**Example tool call:**
-```typescript
-{
-  bankId: "user-123",
-  name: "Response Format",
-  content: "Always provide responses in bullet-point format",
-  priority: 10,
-  tags: ["formatting"]
-}
-```
-
-**Returns:**
-```typescript
-{
-  id: "dir-321",
-  name: "Response Format",
-  content: "Always provide responses in bullet-point format",
-  tags: ["formatting"],
-  createdAt: "2024-01-15T10:30:00Z"
-}
-```
-
-## Usage Examples
-
-### Using with `generateText`
-
-```typescript
-import { HindsightClient } from '@vectorize-io/hindsight-client';
-import { createHindsightTools } from '@vectorize-io/hindsight-ai-sdk';
-import { generateText } from 'ai';
-import { anthropic } from '@ai-sdk/anthropic';
-
-const hindsightClient = new HindsightClient({
-  apiUrl: 'http://localhost:8000',
-});
-
-const tools = createHindsightTools({ client: hindsightClient });
-
-const result = await generateText({
-  model: anthropic('claude-sonnet-4-20250514'),
-  tools,
-  system: `You are a helpful assistant with long-term memory. Use the recall tool to check for relevant memories before responding.`,
-  prompt: 'Remember that Alice loves hiking and prefers spicy food',
-});
-
-console.log(result.text);
-```
-
-### Using with `streamText`
-
-```typescript
-import { streamText } from 'ai';
-
-const result = streamText({
-  model: anthropic('claude-sonnet-4-20250514'),
-  tools,
-  system: `You have persistent memory. Use retain to store important information and recall to retrieve it.`,
-  prompt: 'What do you know about Alice?',
-});
-
-for await (const chunk of result.textStream) {
-  process.stdout.write(chunk);
-}
-```
-
-### Using with `ToolLoopAgent`
-
-```typescript
-import { ToolLoopAgent, stopWhen, stepCountIs } from 'ai';
-
-const agent = new ToolLoopAgent({
-  model: anthropic('claude-sonnet-4-20250514'),
-  tools,
-  instructions: `You are a personal assistant with long-term memory. Always check recall before responding and use retain to store important information.`,
-  stopWhen: stepCountIs(10),
-});
-
-const result = await agent.generate({
-  prompt: 'What did I say I wanted to work on this week?',
-});
-```
-
-### Multi-User Support
-
-```typescript
-const result = await generateText({
-  model: anthropic('claude-sonnet-4-20250514'),
-  tools,
-  system: `You are a helpful assistant. The user's ID is: ${userId}. Always pass this as the bankId parameter to memory tools.`,
-  prompt: 'Remember that I prefer dark mode',
-});
-```
diff --git a/hindsight-docs/versioned_docs/version-0.4/sdks/integrations/ai-sdk.mdx b/hindsight-docs/versioned_docs/version-0.4/sdks/integrations/ai-sdk.mdx
new file mode 100644
index 00000000..0f9ee62b
--- /dev/null
+++ b/hindsight-docs/versioned_docs/version-0.4/sdks/integrations/ai-sdk.mdx
@@ -0,0 +1,97 @@
+---
+sidebar_position: 4
+---
+
+# Vercel AI SDK
+
+The `@vectorize-io/hindsight-ai-sdk` package integrates [Hindsight](https://hindsight.vectorize.io) memory with the [Vercel AI SDK](https://ai-sdk.dev). It provides five ready-to-use tools for retaining, recalling, and reflecting on long-term memories.
+
+import CodeSnippet from '@site/src/components/CodeSnippet';
+
+import aiSdkTs from '!!raw-loader!@site/examples/integrations/ai-sdk.ts';
+
+## Installation
+
+```bash
+npm install @vectorize-io/hindsight-ai-sdk @vectorize-io/hindsight-client ai
+```
+
+## Setup
+
+Create a Hindsight client and pass it to `createHindsightTools` along with a `bankId`. The `bankId` identifies the memory store for this session—typically a user ID.
+
+<CodeSnippet code={aiSdkTs} section="setup" language="typescript" />
+
+:::tip Per-request bank IDs
+In multi-user applications, create `tools` inside your request handler so each request closes over the correct `bankId`. See the [Next.js example](#in-a-nextjs-route-handler) below.
+:::
+
+## Usage
+
+### With `generateText`
+
+<CodeSnippet code={aiSdkTs} section="generate-text" language="typescript" />
+
+### With `streamText`
+
+<CodeSnippet code={aiSdkTs} section="stream-text" language="typescript" />
+
+### With `ToolLoopAgent`
+
+<CodeSnippet code={aiSdkTs} section="tool-loop-agent" language="typescript" />
+
+### In a Next.js Route Handler
+
+<CodeSnippet code={aiSdkTs} section="next-api-route" language="typescript" />
+
+---
+
+## Tools Reference
+
+Five tools are registered. The `bankId` is fixed at creation time—the agent cannot change it.
+
+| Tool | What the agent provides | What the constructor controls |
+|------|------------------------|-------------------------------|
+| `retain` | `content`, `documentId`, `timestamp`, `context` | `async`, `tags`, `metadata` |
+| `recall` | `query`, `queryTimestamp` | `budget`, `types`, `maxTokens`, `includeEntities`, `includeChunks` |
+| `reflect` | `query`, `context` | `budget` |
+| `getMentalModel` | `mentalModelId` | — |
+| `getDocument` | `documentId` | — |
+
+**Why this split?** Semantic inputs (what to remember, what to search for) belong to the agent. Infrastructure concerns (cost budget, tagging strategy, async mode) belong to the application.
+
+---
+
+## Constructor Options
+
+All options except `client` and `bankId` are optional. Each tool's options are grouped under the tool name.
+
+<CodeSnippet code={aiSdkTs} section="constructor-options" language="typescript" />
+
+### `retain`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `async` | `boolean` | `false` | Fire-and-forget — do not wait for ingestion to complete |
+| `tags` | `string[]` | — | Tags attached to every retained memory |
+| `metadata` | `Record<string, string>` | — | Metadata attached to every retained memory |
+| `description` | `string` | built-in | Override the tool description shown to the model |
+
+### `recall`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `budget` | `'low' \| 'mid' \| 'high'` | `'mid'` | Controls retrieval depth and latency |
+| `types` | `('world' \| 'experience' \| 'observation')[]` | all | Restrict results to these fact types |
+| `maxTokens` | `number` | API default | Cap the total tokens returned |
+| `includeEntities` | `boolean` | `false` | Include entity observations in results |
+| `includeChunks` | `boolean` | `false` | Include raw source chunks in results |
+| `description` | `string` | built-in | Override the tool description shown to the model |
+
+### `reflect`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `budget` | `'low' \| 'mid' \| 'high'` | `'mid'` | Controls synthesis depth and latency |
+| `maxTokens` | `number` | API default | Maximum tokens for the response |
+| `description` | `string` | built-in | Override the tool description shown to the model |
diff --git a/hindsight-docs/versioned_sidebars/version-0.4-sidebars.json b/hindsight-docs/versioned_sidebars/version-0.4-sidebars.json
index 99838774..ea2b08f6 100644
--- a/hindsight-docs/versioned_sidebars/version-0.4-sidebars.json
+++ b/hindsight-docs/versioned_sidebars/version-0.4-sidebars.json
@@ -163,6 +163,14 @@
           "id": "sdks/nodejs",
           "label": "Node.js"
         },
+        {
+          "type": "doc",
+          "id": "sdks/go",
+          "label": "Go",
+          "customProps": {
+            "icon": "/img/icons/golang.png"
+          }
+        },
         {
           "type": "doc",
           "id": "sdks/cli",
diff --git a/hindsight-embed/hindsight_embed/__init__.py b/hindsight-embed/hindsight_embed/__init__.py
index 25fdbc8b..915a9ffc 100644
--- a/hindsight-embed/hindsight_embed/__init__.py
+++ b/hindsight-embed/hindsight_embed/__init__.py
@@ -3,7 +3,7 @@
 from .daemon_embed_manager import DaemonEmbedManager
 from .embed_manager import EmbedManager
 
-__version__ = "0.4.11"
+__version__ = "0.4.12"
 
 __all__ = [
     "EmbedManager",
diff --git a/hindsight-embed/pyproject.toml b/hindsight-embed/pyproject.toml
index f5523662..19ce99fb 100644
--- a/hindsight-embed/pyproject.toml
+++ b/hindsight-embed/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hindsight-embed"
-version = "0.4.11"
+version = "0.4.12"
 description = "Hindsight embedded CLI - local memory operations without a server"
 readme = "README.md"
 requires-python = ">=3.11"
diff --git a/hindsight-integrations/ai-sdk/package.json b/hindsight-integrations/ai-sdk/package.json
index 73c5da17..321b3a76 100644
--- a/hindsight-integrations/ai-sdk/package.json
+++ b/hindsight-integrations/ai-sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@vectorize-io/hindsight-ai-sdk",
-  "version": "0.4.11",
+  "version": "0.4.12",
   "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",
diff --git a/hindsight-integrations/litellm/pyproject.toml b/hindsight-integrations/litellm/pyproject.toml
index 69a88a9d..ca17cad3 100644
--- a/hindsight-integrations/litellm/pyproject.toml
+++ b/hindsight-integrations/litellm/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "hindsight-litellm"
-version = "0.4.11"
+version = "0.4.12"
 description = "Universal LLM memory integration via LiteLLM - works with 100+ providers"
 readme = "README.md"
 requires-python = ">=3.10"
diff --git a/hindsight-integrations/openclaw/package.json b/hindsight-integrations/openclaw/package.json
index 4d555cd3..f455d15b 100644
--- a/hindsight-integrations/openclaw/package.json
+++ b/hindsight-integrations/openclaw/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@vectorize-io/hindsight-openclaw",
-  "version": "0.4.11",
+  "version": "0.4.12",
   "description": "Hindsight memory plugin for OpenClaw - biomimetic long-term memory with fact extraction",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
diff --git a/hindsight/pyproject.toml b/hindsight/pyproject.toml
index bf92efda..23452d47 100644
--- a/hindsight/pyproject.toml
+++ b/hindsight/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hindsight-all"
-version = "0.4.11"
+version = "0.4.12"
 description = "Hindsight: Agent Memory That Works Like Human Memory - All-in-One Bundle"
 readme = "README.md"
 requires-python = ">=3.11"
diff --git a/skills/hindsight-docs/references/cookbook/applications/go-memory-service.md b/skills/hindsight-docs/references/cookbook/applications/go-memory-service.md
new file mode 100644
index 00000000..2cc8db82
--- /dev/null
+++ b/skills/hindsight-docs/references/cookbook/applications/go-memory-service.md
@@ -0,0 +1,102 @@
+---
+sidebar_position: 3
+---
+
+# Go Memory-Augmented API
+
+
+:::info Complete Application
+This is a complete, runnable application demonstrating Hindsight integration.
+[**View source on GitHub →**](https://github.com/vectorize-io/hindsight-cookbook/tree/main/applications/go-memory-service)
+:::
+
+
+A Go HTTP microservice demonstrating per-user memory isolation with Hindsight. Remembers each user's tech stack, problems solved, and preferences to provide personalized assistance.
+
+## Features
+
+- 🔐 **Per-User Isolation**: Each user gets their own memory bank
+- 🧠 **Context-Aware Responses**: Uses recall + reflect for personalized answers
+- 🏃 **Fire-and-Forget Memory**: Background goroutines store interactions without blocking responses
+- 🏷️ **Tag-Based Partitioning**: Organize memories by type (projects, debugging, preferences)
+
+## Setup
+
+### 1. Start Hindsight
+
+```bash
+export OPENAI_API_KEY=your-key
+
+docker run --rm -it --pull always -p 8888:8888 -p 9999:9999 \
+  -e HINDSIGHT_API_LLM_API_KEY=$OPENAI_API_KEY \
+  -e HINDSIGHT_API_LLM_MODEL=o3-mini \
+  -v $HOME/.hindsight-docker:/home/hindsight/.pg0 \
+  ghcr.io/vectorize-io/hindsight:latest
+```
+
+### 2. Run the service
+
+```bash
+go run main.go
+```
+
+### 3. Try it out
+
+```bash
+# Store memories
+curl -s localhost:8080/learn -d '{
+  "user_id": "alice",
+  "content": "I am building a Go microservice with gRPC and PostgreSQL",
+  "tags": ["project"]
+}'
+
+curl -s localhost:8080/learn -d '{
+  "user_id": "alice",
+  "content": "I prefer structured logging with slog over zerolog",
+  "tags": ["preferences"]
+}'
+
+# Ask questions (uses recall + reflect)
+curl -s localhost:8080/ask -d '{
+  "user_id": "alice",
+  "query": "What tech stack am I using?"
+}' | jq .
+
+# Raw memory recall
+curl -s "localhost:8080/recall/alice?q=database" | jq .
+```
+
+## API Endpoints
+
+- `POST /learn` - Store new information for a user
+- `POST /ask` - Ask a question using the user's memories
+- `GET /recall/{userID}?q=query` - Direct memory recall
+- `GET /health` - Health check
+
+## Key Patterns
+
+**Per-User Banks**: Each user gets an isolated memory bank (`user-alice`, `user-bob`)
+
+**Async Memory Storage**: Interactions are stored in background goroutines:
+
+```go
+go func() {
+    bgCtx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
+    defer cancel()
+
+    retainReq := hindsight.RetainRequest{
+        Items: []hindsight.MemoryItem{{
+            Content: interaction,
+            Context: *hindsight.NewNullableString(hindsight.PtrString("Q&A interaction")),
+        }},
+    }
+    client.MemoryAPI.RetainMemories(bgCtx, bankID).RetainRequest(retainReq).Execute()
+}()
+```
+
+**Tag-Based Filtering**: Partition memories within a bank by type for scoped retrieval
+
+## Learn More
+
+- [Go SDK Documentation](https://hindsight.vectorize.io/sdks/go)
+- [Hindsight Documentation](https://hindsight.vectorize.io)
diff --git a/skills/hindsight-docs/references/cookbook/applications/hindsight-litellm-demo.md b/skills/hindsight-docs/references/cookbook/applications/hindsight-litellm-demo.md
index ea55cd0e..6ec29c3c 100644
--- a/skills/hindsight-docs/references/cookbook/applications/hindsight-litellm-demo.md
+++ b/skills/hindsight-docs/references/cookbook/applications/hindsight-litellm-demo.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 3
+sidebar_position: 4
 ---
 
 # Memory Approaches Comparison Demo
diff --git a/skills/hindsight-docs/references/cookbook/applications/hindsight-tool-learning-demo.md b/skills/hindsight-docs/references/cookbook/applications/hindsight-tool-learning-demo.md
index f8f8cf7b..81d10dbf 100644
--- a/skills/hindsight-docs/references/cookbook/applications/hindsight-tool-learning-demo.md
+++ b/skills/hindsight-docs/references/cookbook/applications/hindsight-tool-learning-demo.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 4
+sidebar_position: 5
 ---
 
 # Tool Learning Demo
diff --git a/skills/hindsight-docs/references/cookbook/applications/openai-fitness-coach.md b/skills/hindsight-docs/references/cookbook/applications/openai-fitness-coach.md
index d5bb278f..d0971fc0 100644
--- a/skills/hindsight-docs/references/cookbook/applications/openai-fitness-coach.md
+++ b/skills/hindsight-docs/references/cookbook/applications/openai-fitness-coach.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 5
+sidebar_position: 6
 ---
 
 # OpenAI Agent + Hindsight Memory Integration
diff --git a/skills/hindsight-docs/references/cookbook/applications/sanity-blog-memory.md b/skills/hindsight-docs/references/cookbook/applications/sanity-blog-memory.md
index 798ced50..fc555869 100644
--- a/skills/hindsight-docs/references/cookbook/applications/sanity-blog-memory.md
+++ b/skills/hindsight-docs/references/cookbook/applications/sanity-blog-memory.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 6
+sidebar_position: 7
 ---
 
 # Sanity CMS Blog Memory
diff --git a/skills/hindsight-docs/references/cookbook/applications/stancetracker.md b/skills/hindsight-docs/references/cookbook/applications/stancetracker.md
index 9e6ce781..5d464017 100644
--- a/skills/hindsight-docs/references/cookbook/applications/stancetracker.md
+++ b/skills/hindsight-docs/references/cookbook/applications/stancetracker.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 7
+sidebar_position: 8
 ---
 
 # Stance Tracker
diff --git a/skills/hindsight-docs/references/cookbook/applications/taste-ai.md b/skills/hindsight-docs/references/cookbook/applications/taste-ai.md
index f5c9888d..b6883c16 100644
--- a/skills/hindsight-docs/references/cookbook/applications/taste-ai.md
+++ b/skills/hindsight-docs/references/cookbook/applications/taste-ai.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 8
+sidebar_position: 9
 ---
 
 # Hindsight AI SDK - Personal Chef
diff --git a/skills/hindsight-docs/references/cookbook/index.md b/skills/hindsight-docs/references/cookbook/index.md
index 076aebe3..3d583ac5 100644
--- a/skills/hindsight-docs/references/cookbook/index.md
+++ b/skills/hindsight-docs/references/cookbook/index.md
@@ -96,6 +96,12 @@ Learn how to build with Hindsight through practical examples:
       description: "Delivery agent simulation demonstrating learning through mental models",
       tags: { sdk: "hindsight-client", topic: "Learning" }
     },
+    {
+      title: "Go Memory-Augmented API",
+      href: "/cookbook/applications/go-memory-service",
+      description: "Go HTTP microservice with per-user memory banks for a developer knowledge assistant",
+      tags: { sdk: "hindsight-go", topic: "Learning" }
+    },
     {
       title: "Memory Approaches Comparison Demo",
       href: "/cookbook/applications/hindsight-litellm-demo",
diff --git a/skills/hindsight-docs/references/developer/api/documents.md b/skills/hindsight-docs/references/developer/api/documents.md
index 49f96b94..b9d28177 100644
--- a/skills/hindsight-docs/references/developer/api/documents.md
+++ b/skills/hindsight-docs/references/developer/api/documents.md
@@ -42,15 +42,14 @@ client.retain(
     document_id="meeting-2024-03-15"
 )
 
-# Batch retain for a document
+# Batch retain for a document with different sections
 client.retain_batch(
     bank_id="my-bank",
     items=[
-        {"content": "Item 1: Product launch delayed to Q2"},
-        {"content": "Item 2: New hiring targets announced"},
-        {"content": "Item 3: Budget approved for ML team"}
-    ],
-    document_id="meeting-2024-03-15"
+        {"content": "Item 1: Product launch delayed to Q2", "document_id": "meeting-2024-03-15-section-1"},
+        {"content": "Item 2: New hiring targets announced", "document_id": "meeting-2024-03-15-section-2"},
+        {"content": "Item 3: Budget approved for ML team", "document_id": "meeting-2024-03-15-section-3"}
+    ]
 )
 ```
 
@@ -62,12 +61,12 @@ await client.retain('my-bank', 'Alice presented the Q4 roadmap...', {
     document_id: 'meeting-2024-03-15'
 });
 
-// Batch retain
+// Batch retain for a document with different sections
 await client.retainBatch('my-bank', [
-    { content: 'Item 1: Product launch delayed to Q2' },
-    { content: 'Item 2: New hiring targets announced' },
-    { content: 'Item 3: Budget approved for ML team' }
-], { documentId: 'meeting-2024-03-15' });
+    { content: 'Item 1: Product launch delayed to Q2', document_id: 'meeting-2024-03-15-section-1' },
+    { content: 'Item 2: New hiring targets announced', document_id: 'meeting-2024-03-15-section-2' },
+    { content: 'Item 3: Budget approved for ML team', document_id: 'meeting-2024-03-15-section-3' }
+]);
 ```
 
 ### CLI
@@ -162,11 +161,15 @@ asyncio.run(get_document_example())
 const apiClient = createClient(createConfig({ baseUrl: 'http://localhost:8888' }));
 
 // Get document to expand context from recall results
-const { data: doc } = await sdk.getDocument({
+const { data: doc, error } = await sdk.getDocument({
     client: apiClient,
-    path: { bank_id: 'my-bank', document_id: 'meeting-2024-03-15' }
+    path: { bank_id: 'my-bank', document_id: 'meeting-2024-03-15-section-1' }
 });
 
+if (error) {
+    throw new Error(`Failed to get document: ${JSON.stringify(error)}`);
+}
+
 console.log(`Document: ${doc.id}`);
 console.log(`Original text: ${doc.original_text}`);
 console.log(`Memory count: ${doc.memory_unit_count}`);
@@ -211,7 +214,7 @@ asyncio.run(delete_document_example())
 // Delete document and all its memories
 const { data: deleteResult } = await sdk.deleteDocument({
     client: apiClient,
-    path: { bank_id: 'my-bank', document_id: 'meeting-2024-03-15' }
+    path: { bank_id: 'my-bank', document_id: 'meeting-2024-03-15-section-1' }
 });
 
 console.log(`Deleted ${deleteResult.memory_units_deleted} memories`);
diff --git a/skills/hindsight-docs/references/developer/api/recall.md b/skills/hindsight-docs/references/developer/api/recall.md
index 56868fe1..f22b71ac 100644
--- a/skills/hindsight-docs/references/developer/api/recall.md
+++ b/skills/hindsight-docs/references/developer/api/recall.md
@@ -42,10 +42,10 @@ hindsight memory recall my-bank "What does Alice do?"
 | `query` | string | required | Natural language query |
 | `types` | list | all | Filter: `world`, `experience`, `observation` |
 | `budget` | string | "mid" | Budget level: `low`, `mid`, `high` |
-| `max_tokens` | int | 4096 | Token budget for results |
+| `max_tokens` | int | 4096 | Token budget for memory facts (text only) |
 | `trace` | bool | false | Enable trace output for debugging |
 | `include_chunks` | bool | false | Include raw text chunks that generated the memories |
-| `max_chunk_tokens` | int | 500 | Token budget for chunks |
+| `max_chunk_tokens` | int | 500 | Token budget for chunks (independent of `max_tokens`) |
 | `tags` | list | None | Filter memories by tags (see [Tag Filtering](#filter-by-tags)) |
 | `tags_match` | string | "any" | How to match tags: `any`, `all`, `any_strict`, `all_strict` |
 
@@ -140,6 +140,14 @@ results = client.recall(bank_id="my-bank", query="Alice's email", max_tokens=500
 
 This design means you never have to guess whether 10 results or 50 results will fit your context. Just specify the token budget and Hindsight returns as many relevant memories as will fit.
 
+> **📝 Chunks are Independent**
+> 
+When `include_chunks=True`, chunks are fetched **independently** of the `max_tokens` filtering. This means:
+- Setting `max_tokens=0` will return **0 memory facts** but can still return **chunks** (up to `max_chunk_tokens`)
+- Chunks are based on the top-scored (reranked) results **before** token filtering
+- Chunks are fetched in batches (batch size estimated as `(max_chunk_tokens / retain_chunk_size) * 2`) until the token budget is exhausted
+- This batching approach handles varying chunk sizes across documents efficiently
+- This allows you to retrieve raw source text without memory facts when needed
 ## Budget Levels
 
 The `budget` parameter controls graph traversal depth:
diff --git a/skills/hindsight-docs/references/developer/api/retain.md b/skills/hindsight-docs/references/developer/api/retain.md
index c06fa93b..59b31c1f 100644
--- a/skills/hindsight-docs/references/developer/api/retain.md
+++ b/skills/hindsight-docs/references/developer/api/retain.md
@@ -106,11 +106,10 @@ Store multiple items in a single request. **Batch ingestion is the recommended a
 client.retain_batch(
     bank_id="my-bank",
     items=[
-        {"content": "Alice works at Google", "context": "career"},
-        {"content": "Bob is a data scientist at Meta", "context": "career"},
-        {"content": "Alice and Bob are friends", "context": "relationship"}
-    ],
-    document_id="conversation_001"
+        {"content": "Alice works at Google", "context": "career", "document_id": "conversation_001_msg_1"},
+        {"content": "Bob is a data scientist at Meta", "context": "career", "document_id": "conversation_001_msg_2"},
+        {"content": "Alice and Bob are friends", "context": "relationship", "document_id": "conversation_001_msg_3"}
+    ]
 )
 ```
 
@@ -118,26 +117,109 @@ client.retain_batch(
 
 ```javascript
 await client.retainBatch('my-bank', [
-    { content: 'Alice works at Google', context: 'career' },
-    { content: 'Bob is a data scientist at Meta', context: 'career' },
-    { content: 'Alice and Bob are friends', context: 'relationship' }
-], { documentId: 'conversation_001' });
+    { content: 'Alice works at Google', context: 'career', document_id: 'conversation_001_msg_1' },
+    { content: 'Bob is a data scientist at Meta', context: 'career', document_id: 'conversation_001_msg_2' },
+    { content: 'Alice and Bob are friends', context: 'relationship', document_id: 'conversation_001_msg_3' }
+]);
 ```
 
 The `document_id` groups related memories for later management.
 
 ## Store from Files
 
+Upload files directly — Hindsight automatically converts them to text and extracts memories. File processing always runs asynchronously and returns operation IDs for tracking.
+
+**Supported formats:** PDF, DOCX, DOC, PPTX, PPT, XLSX, XLS, images (JPG, PNG, GIF, etc. — OCR), audio (MP3, WAV, FLAC, etc. — transcription), HTML, and plain text formats (TXT, MD, CSV, JSON, YAML, etc.)
+
 ### CLI
 
 ```bash
-# Single file
-hindsight memory retain-files my-bank document.txt
+# Upload a single file (PDF, DOCX, PPTX, XLSX, images, audio, and more)
+hindsight memory retain-files my-bank report.pdf
 
-# Directory (recursive by default)
+# Upload a directory of files
 hindsight memory retain-files my-bank ./documents/
+
+# Upload and wait for processing to complete (polls until done)
+hindsight memory retain-files my-bank report.pdf
+
+# Queue files for background processing (returns immediately)
+hindsight memory retain-files my-bank ./documents/ --async
 ```
 
+### HTTP
+
+```bash
+# Via HTTP API (multipart/form-data)
+curl -X POST "${HINDSIGHT_URL}/v1/default/banks/my-bank/files/retain" \
+    -F "files=@report.pdf;type=application/octet-stream" \
+    -F "request={\"files_metadata\": [{\"context\": \"quarterly report\"}]}"
+```
+
+### Python
+
+```python
+# Upload files and retain their contents as memories.
+# Supports: PDF, DOCX, PPTX, XLSX, images (OCR), audio (transcription), and text formats.
+# Pass file paths — the client reads and uploads them automatically.
+result = client.retain_files(
+    bank_id="my-bank",
+    files=[EXAMPLES_DIR / "sample.pdf"],
+    context="quarterly report",
+)
+print(result.operation_ids)  # Track processing via the operations endpoint
+```
+
+### Node.js
+
+```javascript
+// Upload files and retain their contents as memories.
+// Supports: PDF, DOCX, PPTX, XLSX, images (OCR), audio (transcription), and text formats.
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pdfBytes = readFileSync(join(__dirname, 'sample.pdf'));
+const result = await client.retainFiles('my-bank', [
+    new File([pdfBytes], 'sample.pdf'),
+], { context: 'quarterly report' });
+console.log(result.operation_ids);  // Track processing via the operations endpoint
+```
+
+### File Retain Response
+
+The file retain endpoint always returns asynchronously:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `operation_ids` | string[] | One operation ID per uploaded file. Use `GET /v1/default/banks/{bank_id}/operations` to track progress. |
+
+### Batch File Uploads
+
+Upload up to 10 files per request (max 100 MB total). Each file becomes a separate document with optional per-file metadata:
+
+### Python
+
+```python
+# Upload multiple files with per-file metadata (up to 10 files per batch).
+# Each file gets its own context, document_id, and tags.
+result = client.retain_files(
+    bank_id="my-bank",
+    files=[
+        EXAMPLES_DIR / "sample.pdf",
+        EXAMPLES_DIR / "sample.pdf",  # Replace with a second file path
+    ],
+    files_metadata=[
+        {"context": "quarterly report", "document_id": "q1-report", "tags": ["project:alpha"]},
+        {"context": "meeting notes", "document_id": "q1-notes", "tags": ["project:alpha"]},
+    ],
+)
+print(result.operation_ids)  # One operation ID per file
+```
+
+:::info File Storage
+Uploaded files are stored server-side (PostgreSQL by default, or S3/GCS/Azure for production). Configure storage via `HINDSIGHT_API_FILE_STORAGE_TYPE`. See [Configuration](../configuration#file-processing) for details.
 ## Async Ingestion
 
 For large batches, use async ingestion to avoid blocking:
@@ -149,10 +231,9 @@ For large batches, use async ingestion to avoid blocking:
 result = client.retain_batch(
     bank_id="my-bank",
     items=[
-        {"content": "Large batch item 1"},
-        {"content": "Large batch item 2"},
+        {"content": "Large batch item 1", "document_id": "large-doc-1"},
+        {"content": "Large batch item 2", "document_id": "large-doc-2"},
     ],
-    document_id="large-doc",
     retain_async=True
 )
 
@@ -165,10 +246,9 @@ print(result.var_async)  # True
 ```javascript
 // Start async ingestion (returns immediately)
 await client.retainBatch('my-bank', [
-    { content: 'Large batch item 1' },
-    { content: 'Large batch item 2' },
+    { content: 'Large batch item 1', document_id: 'large-doc-1' },
+    { content: 'Large batch item 2', document_id: 'large-doc-2' },
 ], {
-    documentId: 'large-doc',
     async: true
 });
 ```
@@ -188,14 +268,15 @@ client.retain_batch(
     items=[
         {
             "content": "User Alice said she loves the new dashboard",
-            "tags": ["user:alice", "feedback"]
+            "tags": ["user:alice", "feedback"],
+            "document_id": "user_feedback_001"
         },
         {
             "content": "User Bob reported a bug in the search feature",
-            "tags": ["user:bob", "bug-report"]
+            "tags": ["user:bob", "bug-report"],
+            "document_id": "user_feedback_002"
         }
-    ],
-    document_id="user_feedback_001"
+    ]
 )
 ```
 
@@ -210,10 +291,9 @@ Use `document_tags` to apply the same tags to all items in a request:
 client.retain_batch(
     bank_id="my-bank",
     items=[
-        {"content": "Alice mentioned she prefers dark mode"},
-        {"content": "Bob asked about keyboard shortcuts"}
+        {"content": "Alice mentioned she prefers dark mode", "document_id": "support_session_123_msg_1"},
+        {"content": "Bob asked about keyboard shortcuts", "document_id": "support_session_123_msg_2"}
     ],
-    document_id="support_session_123",
     document_tags=["session:123", "support"]  # Applied to all items
 )
 ```
diff --git a/skills/hindsight-docs/references/developer/configuration.md b/skills/hindsight-docs/references/developer/configuration.md
index 967fae9b..b5f7032f 100644
--- a/skills/hindsight-docs/references/developer/configuration.md
+++ b/skills/hindsight-docs/references/developer/configuration.md
@@ -61,31 +61,63 @@ hindsight-admin run-db-migration --schema tenant_acme
 
 | Variable | Description | Default |
 |----------|-------------|---------|
-| `HINDSIGHT_API_VECTOR_EXTENSION` | Vector extension to use: `auto`, `pgvector`, or `vchord` | `auto` |
+| `HINDSIGHT_API_VECTOR_EXTENSION` | Vector index algorithm: `pgvector`, `vchord`, or `pgvectorscale` | `pgvector` |
 
-Hindsight supports two PostgreSQL vector extensions:
-- **pgvector**: Standard extension, works well for most embeddings (up to ~2000 dimensions)
-- **vchord**: Optimized for high-dimensional embeddings (3000+ dimensions), includes BM25 search
+Hindsight supports three PostgreSQL vector extensions:
 
-When set to `auto` (default), Hindsight automatically detects which extension is installed, preferring vchord if both are available.
+#### **pgvector** (HNSW - default)
+- In-memory index using Hierarchical Navigable Small World algorithm
+- Works well for most embeddings and dataset sizes
+- Fast for small-medium datasets (&lt;10M vectors)
+- Higher memory usage for large datasets
+- Most widely deployed and supported
+
+#### **pgvectorscale** (DiskANN - recommended for scale) ⭐
+- Disk-based index using StreamingDiskANN algorithm
+- **28x lower p95 latency** and **16x higher throughput** vs dedicated vector DBs
+- **60-75% cost reduction** at scale (SSDs cheaper than RAM)
+- Superior filtering performance with streaming retrieval model
+- Optimized for large datasets (10M+ vectors)
+- Supports both **pgvectorscale** (open source) and **pg_diskann** (Azure)
+- **Installation:**
+  - Open source/self-hosted: `CREATE EXTENSION vector; CREATE EXTENSION vectorscale CASCADE;`
+  - Azure PostgreSQL: `CREATE EXTENSION vector; CREATE EXTENSION pg_diskann CASCADE;`
+
+#### **vchord** (vchordrq)
+- Alternative high-performance vector index
+- Optimized for high-dimensional embeddings (3000+ dimensions)
+- Includes integrated BM25 search capabilities
+- Requires `vchord` extension
+
+**When to use pgvectorscale (DiskANN):**
+- Large datasets (10M+ vectors) ⭐
+- Complex filtering requirements
+- Cost-sensitive deployments
+- Production workloads requiring high throughput
+- When disk I/O is not a bottleneck
+
+**When to use pgvector (HNSW):**
+- Small-medium datasets (&lt;10M vectors)
+- Maximum query speed when all data fits in memory
+- Simple nearest-neighbor queries without filters
+- Standard PostgreSQL deployment preference
 
 **When to use vchord:**
-- Using high-dimensional embeddings (e.g., `text-embedding-3-large` with 3072 dimensions)
-- Need better performance with large embedding dimensions
-- Want to use vchord's BM25 search capabilities
-
-**When to use pgvector:**
-- Using standard embedding dimensions (384-1536)
-- Prefer the widely-adopted pgvector extension
-- Simpler deployment (pgvector is more commonly available)
+- High-dimensional embeddings (3000+ dimensions)
+- Want integrated BM25 search
+- Already using vchord for text search
 
 **Switching extensions:**
 
 If you need to switch from one extension to another:
-1. Set `HINDSIGHT_API_VECTOR_EXTENSION` to your desired extension (`pgvector` or `vchord`)
+1. Set `HINDSIGHT_API_VECTOR_EXTENSION` to your desired extension (`pgvector`, `vchord`, or `pgvectorscale`)
 2. If your database has existing data, you'll get an error with migration instructions
 3. For empty databases, indexes will be automatically recreated on startup
 
+**Learn more:**
+- [HNSW vs. DiskANN comparison](https://www.tigerdata.com/learn/hnsw-vs-diskann)
+- [pgvectorscale GitHub](https://github.com/timescale/pgvectorscale)
+
 ### Text Search Extension
 
 | Variable | Description | Default |
@@ -136,6 +168,7 @@ To switch between backends:
 | `HINDSIGHT_API_LLM_MAX_BACKOFF` | Max retry backoff cap in seconds | `60.0` |
 | `HINDSIGHT_API_LLM_TIMEOUT` | LLM request timeout in seconds | `120` |
 | `HINDSIGHT_API_LLM_GROQ_SERVICE_TIER` | Groq service tier: `on_demand`, `flex`, `auto` | `auto` |
+| `HINDSIGHT_API_LLM_OPENAI_SERVICE_TIER` | OpenAI service tier: `flex` for 50% cost savings (OpenAI Flex Processing) | None (default) |
 
 **Provider Examples**
 
@@ -151,6 +184,8 @@ export HINDSIGHT_API_LLM_MODEL=openai/gpt-oss-20b
 export HINDSIGHT_API_LLM_PROVIDER=openai
 export HINDSIGHT_API_LLM_API_KEY=sk-xxxxxxxxxxxx
 export HINDSIGHT_API_LLM_MODEL=gpt-4o
+# Optional: Use Flex Processing for 50% cost savings (with variable latency)
+# export HINDSIGHT_API_LLM_OPENAI_SERVICE_TIER=flex
 
 # Gemini
 export HINDSIGHT_API_LLM_PROVIDER=gemini
@@ -558,6 +593,8 @@ Controls the retain (memory ingestion) pipeline.
 | `HINDSIGHT_API_RETAIN_EXTRACTION_MODE` | Fact extraction mode: `concise`, `verbose`, or `custom` | `concise` |
 | `HINDSIGHT_API_RETAIN_CUSTOM_INSTRUCTIONS` | Custom extraction guidelines (only used when mode is `custom`) | - |
 | `HINDSIGHT_API_RETAIN_EXTRACT_CAUSAL_LINKS` | Extract causal relationships between facts | `true` |
+| `HINDSIGHT_API_RETAIN_BATCH_ENABLED` | Use LLM Batch API for fact extraction (50% cost savings, only with async operations) | `false` |
+| `HINDSIGHT_API_RETAIN_BATCH_POLL_INTERVAL_SECONDS` | Batch API polling interval in seconds | `60` |
 
 #### Extraction Modes
 
@@ -592,6 +629,136 @@ CONSOLIDATE related technical discussions into ONE fact when possible.
 Ask yourself: 'Would this technical context be useful in 6 months?' If no, skip it."
 ```
 
+### File Processing
+
+Configuration for the file upload and conversion pipeline (used by `POST /v1/default/banks/{bank_id}/files/retain`).
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `HINDSIGHT_API_ENABLE_FILE_UPLOAD_API` | Enable the file upload API endpoint | `true` |
+| `HINDSIGHT_API_FILE_PARSER` | File parser to use (`markitdown`, `iris`) | `markitdown` |
+| `HINDSIGHT_API_FILE_CONVERSION_MAX_BATCH_SIZE` | Max files per upload request | `10` |
+| `HINDSIGHT_API_FILE_CONVERSION_MAX_BATCH_SIZE_MB` | Max total upload size per request (MB) | `100` |
+| `HINDSIGHT_API_FILE_DELETE_AFTER_RETAIN` | Delete stored files after memory extraction completes | `true` |
+
+#### Parser: markitdown (default)
+
+Local file-to-markdown conversion using [Microsoft's markitdown](https://github.com/microsoft/markitdown). No external service required.
+
+**Supported formats:** PDF, DOCX, DOC, PPTX, PPT, XLSX, XLS, images (JPG, PNG — OCR), audio (MP3, WAV — transcription), HTML, TXT, MD, CSV.
+
+#### Parser: iris
+
+Cloud-based extraction via [Vectorize Iris](https://docs.vectorize.io/build-deploy/extract-information/understanding-iris/). Higher quality extraction for complex documents, powered by a remote AI service.
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `HINDSIGHT_API_FILE_PARSER_IRIS_TOKEN` | Vectorize API token | — |
+| `HINDSIGHT_API_FILE_PARSER_IRIS_ORG_ID` | Vectorize organization ID | — |
+
+**Supported formats:** PDF, DOCX, DOC, PPTX, PPT, XLSX, XLS, images (JPG, JPEG, PNG, GIF, BMP, TIFF, WEBP), HTML, TXT, MD, CSV.
+
+```bash
+# Use iris parser (requires Vectorize account)
+export HINDSIGHT_API_FILE_PARSER=iris
+export HINDSIGHT_API_FILE_PARSER_IRIS_TOKEN=your-vectorize-token
+export HINDSIGHT_API_FILE_PARSER_IRIS_ORG_ID=your-org-id
+```
+
+```bash
+# Increase batch limits for large file imports
+export HINDSIGHT_API_FILE_CONVERSION_MAX_BATCH_SIZE=20
+export HINDSIGHT_API_FILE_CONVERSION_MAX_BATCH_SIZE_MB=500
+
+# Keep files after processing (useful for debugging or re-processing)
+export HINDSIGHT_API_FILE_DELETE_AFTER_RETAIN=false
+```
+
+### File Storage
+
+Files uploaded via the file retain API are stored in an object storage backend before conversion. Choose the backend that fits your infrastructure.
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `HINDSIGHT_API_FILE_STORAGE_TYPE` | Storage backend: `native`, `s3`, `gcs`, or `azure` | `native` |
+
+#### Native (PostgreSQL)
+
+Files are stored as `BYTEA` in the `file_storage` table. No additional infrastructure required. Suitable for development and small deployments.
+
+```bash
+# Native storage is the default — no additional configuration needed
+export HINDSIGHT_API_FILE_STORAGE_TYPE=native
+```
+
+#### S3 / S3-Compatible
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `HINDSIGHT_API_FILE_STORAGE_S3_BUCKET` | S3 bucket name | - |
+| `HINDSIGHT_API_FILE_STORAGE_S3_REGION` | AWS region | - |
+| `HINDSIGHT_API_FILE_STORAGE_S3_ENDPOINT` | Custom endpoint URL (for S3-compatible stores like MinIO, Cloudflare R2) | AWS default |
+| `HINDSIGHT_API_FILE_STORAGE_S3_ACCESS_KEY_ID` | AWS access key ID | - |
+| `HINDSIGHT_API_FILE_STORAGE_S3_SECRET_ACCESS_KEY` | AWS secret access key | - |
+
+```bash
+# AWS S3
+export HINDSIGHT_API_FILE_STORAGE_TYPE=s3
+export HINDSIGHT_API_FILE_STORAGE_S3_BUCKET=my-hindsight-files
+export HINDSIGHT_API_FILE_STORAGE_S3_REGION=us-east-1
+export HINDSIGHT_API_FILE_STORAGE_S3_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
+export HINDSIGHT_API_FILE_STORAGE_S3_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
+
+# S3-compatible (MinIO, Cloudflare R2, etc.)
+export HINDSIGHT_API_FILE_STORAGE_TYPE=s3
+export HINDSIGHT_API_FILE_STORAGE_S3_BUCKET=my-bucket
+export HINDSIGHT_API_FILE_STORAGE_S3_ENDPOINT=https://your-minio.example.com
+export HINDSIGHT_API_FILE_STORAGE_S3_ACCESS_KEY_ID=minioadmin
+export HINDSIGHT_API_FILE_STORAGE_S3_SECRET_ACCESS_KEY=minioadmin
+```
+
+#### Google Cloud Storage
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `HINDSIGHT_API_FILE_STORAGE_GCS_BUCKET` | GCS bucket name | - |
+| `HINDSIGHT_API_FILE_STORAGE_GCS_SERVICE_ACCOUNT_KEY` | Path to service account JSON key file | ADC if not set |
+
+```bash
+export HINDSIGHT_API_FILE_STORAGE_TYPE=gcs
+export HINDSIGHT_API_FILE_STORAGE_GCS_BUCKET=my-hindsight-files
+# Optional: use service account key file (otherwise falls back to ADC)
+export HINDSIGHT_API_FILE_STORAGE_GCS_SERVICE_ACCOUNT_KEY=/path/to/key.json
+```
+
+#### Azure Blob Storage
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `HINDSIGHT_API_FILE_STORAGE_AZURE_CONTAINER` | Azure container name | - |
+| `HINDSIGHT_API_FILE_STORAGE_AZURE_ACCOUNT_NAME` | Azure storage account name | - |
+| `HINDSIGHT_API_FILE_STORAGE_AZURE_ACCOUNT_KEY` | Azure storage account key | - |
+
+```bash
+export HINDSIGHT_API_FILE_STORAGE_TYPE=azure
+export HINDSIGHT_API_FILE_STORAGE_AZURE_CONTAINER=hindsight-files
+export HINDSIGHT_API_FILE_STORAGE_AZURE_ACCOUNT_NAME=mystorageaccount
+export HINDSIGHT_API_FILE_STORAGE_AZURE_ACCOUNT_KEY=base64encodedkey==
+```
+
+#### Storage Backend Comparison
+
+| Backend | Best For | Notes |
+|---------|----------|-------|
+| `native` | Development, small deployments | No extra infrastructure, stored in PostgreSQL |
+| `s3` | Production, AWS deployments | Works with any S3-compatible store |
+| `gcs` | Production, GCP deployments | Supports ADC for keyless auth |
+| `azure` | Production, Azure deployments | Uses account key auth |
+
+:::tip Production Recommendation
+For production deployments, use `s3`, `gcs`, or `azure` to avoid storing large binary files in your PostgreSQL database. Set `HINDSIGHT_API_FILE_DELETE_AFTER_RETAIN=true` (the default) to delete files after memory extraction, which minimizes storage costs.
+:::
+
 ### Observations (Experimental)
 
 Observations are consolidated knowledge synthesized from facts.
@@ -952,6 +1119,13 @@ HINDSIGHT_API_LLM_API_KEY=gsk_xxxxxxxxxxxx
 # HINDSIGHT_API_TENANT_EXTENSION=hindsight_api.extensions.builtin.tenant:ApiKeyTenantExtension
 # HINDSIGHT_API_TENANT_API_KEY=your-secret-api-key
 
+# File storage (optional, defaults to PostgreSQL native storage)
+# HINDSIGHT_API_FILE_STORAGE_TYPE=s3
+# HINDSIGHT_API_FILE_STORAGE_S3_BUCKET=my-hindsight-files
+# HINDSIGHT_API_FILE_STORAGE_S3_REGION=us-east-1
+# HINDSIGHT_API_FILE_STORAGE_S3_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
+# HINDSIGHT_API_FILE_STORAGE_S3_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
+
 # Control Plane
 HINDSIGHT_CP_DATAPLANE_API_URL=http://localhost:8888
 ```
diff --git a/skills/hindsight-docs/references/developer/installation.md b/skills/hindsight-docs/references/developer/installation.md
index 00acd07e..3a79ec80 100644
--- a/skills/hindsight-docs/references/developer/installation.md
+++ b/skills/hindsight-docs/references/developer/installation.md
@@ -17,7 +17,8 @@ Hindsight requires PostgreSQL with the **pgvector** extension for vector similar
 **For production**, use an external PostgreSQL with pgvector:
 - **Supabase** — Managed PostgreSQL with pgvector built-in
 - **Neon** — Serverless PostgreSQL with pgvector
-- **AWS RDS** / **Cloud SQL** / **Azure** — With pgvector extension enabled
+- **Azure Database for PostgreSQL** — With pgvector and pg_diskann (DiskANN) support
+- **AWS RDS** / **Cloud SQL** — With pgvector extension enabled
 - **Self-hosted** — PostgreSQL 14+ with pgvector installed
 
 ### LLM Provider
diff --git a/skills/hindsight-docs/references/developer/performance.md b/skills/hindsight-docs/references/developer/performance.md
index 5e52ca21..5896cc4e 100644
--- a/skills/hindsight-docs/references/developer/performance.md
+++ b/skills/hindsight-docs/references/developer/performance.md
@@ -53,12 +53,29 @@ To maximize retention throughput:
    - **Fast**: [Groq](https://groq.com) with `gpt-oss-20b` or other openai-oss models, self-hosted models on GPU clusters (vLLM, TGI)
    - **Slow**: Standard cloud LLM providers with rate limits
 
-2. **Batch your operations**: Group related content into batch requests. The only limit is the HTTP payload size — Hindsight automatically splits large batches into smaller, optimized chunks under the hood, so you don't have to worry about it.
+2. **Batch your operations**: Group related content into batch requests. Send as much data as you want in a single request — the only limit is the HTTP payload size.
 
 3. **Use async mode for large datasets**: Queue operations in the background
 
 4. **Parallel processing**: For very large datasets, use multiple concurrent retention requests with different `document_id` values
 
+### Automatic Batch Optimization
+
+**When using async retain, Hindsight automatically handles batch sizing for you.** You don't need to manually tune batch sizes or worry about optimal chunking.
+
+How it works:
+- **Send large batches**: Submit hundreds or thousands of items in a single async retain request
+- **Automatic splitting**: Hindsight automatically splits large batches (>10,000 tokens) into optimized sub-batches
+- **Parallel processing**: Sub-batches are processed concurrently in the background
+- **Status tracking**: Parent operation aggregates status from all sub-batches
+- **Token-based**: Batching uses tiktoken for accurate token counting, not character counts
+
+Benefits:
+- Send entire documents or datasets in one API call
+- Let Hindsight optimize the processing strategy
+- Track overall progress via the parent operation status
+- No need to manually split data into small batches
+
 ### Throughput
 
 Factors affecting throughput:
diff --git a/skills/hindsight-docs/references/sdks/cli.md b/skills/hindsight-docs/references/sdks/cli.md
index 4578def7..36380ff6 100644
--- a/skills/hindsight-docs/references/sdks/cli.md
+++ b/skills/hindsight-docs/references/sdks/cli.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 3
+sidebar_position: 4
 ---
 
 # CLI Reference
diff --git a/skills/hindsight-docs/references/sdks/embed.md b/skills/hindsight-docs/references/sdks/embed.md
index 3eb5d140..f94dd8e1 100644
--- a/skills/hindsight-docs/references/sdks/embed.md
+++ b/skills/hindsight-docs/references/sdks/embed.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 4
+sidebar_position: 5
 ---
 
 # Embedded SDK (hindsight-embed)
diff --git a/skills/hindsight-docs/references/sdks/go.md b/skills/hindsight-docs/references/sdks/go.md
new file mode 100644
index 00000000..ecc833f9
--- /dev/null
+++ b/skills/hindsight-docs/references/sdks/go.md
@@ -0,0 +1,51 @@
+---
+sidebar_position: 3
+---
+
+# Go Client
+
+Official Go client for the Hindsight API, generated from the OpenAPI 3.1 spec using [OpenAPI Generator](https://github.com/OpenAPITools/openapi-generator).
+
+import CodeSnippet from '@site/src/components/CodeSnippet';
+import quickstartGo from '!!raw-loader!@site/examples/api/quickstart.go';
+
+## Installation
+
+```bash
+go get github.com/vectorize-io/hindsight/hindsight-clients/go
+```
+
+Requires Go 1.23+.
+
+## Quick Start
+
+<CodeSnippet code={quickstartGo} section="quickstart-full" language="go" />
+
+## API Structure
+
+The Go client provides access to all Hindsight API operations through structured namespaces:
+
+- **`client.MemoryAPI`** - Retain, recall, reflect operations
+- **`client.BanksAPI`** - Bank management
+- **`client.DirectivesAPI`** - Directive management
+- **`client.MentalModelsAPI`** - Mental model management
+- **`client.DocumentsAPI`** - Document operations
+- **`client.EntitiesAPI`** - Entity operations
+- **`client.OperationsAPI`** - Async operation monitoring
+
+## Working with Nullable Fields
+
+The Go client uses `NullableString`, `NullableTime`, and similar types for optional fields:
+
+<CodeSnippet code={quickstartGo} section="nullable-fields" language="go" />
+
+## Error Handling
+
+<CodeSnippet code={quickstartGo} section="error-handling" language="go" />
+
+## More Examples
+
+For detailed examples of all operations, see:
+- [Python SDK documentation](./python.md) - API concepts are the same
+- [Node.js SDK documentation](./nodejs.md) - API concepts are the same
+- [OpenAPI specification](https://hindsight.dev/openapi.json) - Complete API reference
diff --git a/skills/hindsight-docs/references/sdks/integrations/ai-sdk.md b/skills/hindsight-docs/references/sdks/integrations/ai-sdk.md
index c538fc24..4a130730 100644
--- a/skills/hindsight-docs/references/sdks/integrations/ai-sdk.md
+++ b/skills/hindsight-docs/references/sdks/integrations/ai-sdk.md
@@ -1,335 +1,61 @@
----
-sidebar_position: 4
----
 
 # Vercel AI SDK
 
-Official Hindsight integration for the [Vercel AI SDK](https://ai-sdk.dev).
-
-## Features
-
-- **7 Memory Tools**: Core memory operations (retain, recall, reflect), mental models (create, query), documents (get), and directives (create)
-- **AI SDK 6 Native**: Works seamlessly with `generateText`, `streamText`, and `ToolLoopAgent`
-- **Multi-User Support**: Dynamic bank IDs per tool call for multi-user/multi-tenant scenarios
-- **Full Parameter Support**: Complete access to all Hindsight API parameters
-- **Type-Safe**: Full TypeScript support with Zod schemas for validation
+The `@vectorize-io/hindsight-ai-sdk` package integrates [Hindsight](https://hindsight.vectorize.io) memory with the [Vercel AI SDK](https://ai-sdk.dev). It provides five ready-to-use tools for retaining, recalling, and reflecting on long-term memories.
 
 ## Installation
 
 ```bash
-npm install @vectorize-io/hindsight-ai-sdk @vectorize-io/hindsight-client ai zod
+npm install @vectorize-io/hindsight-ai-sdk @vectorize-io/hindsight-client ai
 ```
 
-## Quick Start
+## Setup
 
-### 1. Set up your Hindsight client
+Create a Hindsight client and pass it to `createHindsightTools` along with a `bankId`. The `bankId` identifies the memory store for this session—typically a user ID.
 
 ```typescript
 import { HindsightClient } from '@vectorize-io/hindsight-client';
-
-const hindsightClient = new HindsightClient({
-  apiUrl: process.env.HINDSIGHT_API_URL || 'http://localhost:8000',
-});
-```
-
-### 2. Create Hindsight tools
-
-```typescript
 import { createHindsightTools } from '@vectorize-io/hindsight-ai-sdk';
 
+const client = new HindsightClient({ baseUrl: 'http://localhost:8888' });
+
 const tools = createHindsightTools({
-  client: hindsightClient,
+  client,
+  bankId: 'user-123',
 });
 ```
 
-### 3. Use with AI SDK
+> **💡 Per-request bank IDs**
+> 
+In multi-user applications, create `tools` inside your request handler so each request closes over the correct `bankId`. See the [Next.js example](#in-a-nextjs-route-handler) below.
+## Usage
+
+### With `generateText`
 
 ```typescript
 import { generateText } from 'ai';
-import { anthropic } from '@ai-sdk/anthropic';
+import { openai } from '@ai-sdk/openai';
 
-const result = await generateText({
-  model: anthropic('claude-sonnet-4-20250514'),
+const { text } = await generateText({
+  model: openai('gpt-4o'),
   tools,
-  prompt: 'Remember that Alice loves hiking and prefers spicy food',
+  maxSteps: 5,
+  system: 'You are a helpful assistant with long-term memory.',
+  prompt: 'Remember that I prefer dark mode and large fonts.',
 });
-
-console.log(result.text);
 ```
 
-## Memory Tools
-
-The integration provides seven tools that the AI model can use to manage memory:
-
-### `retain` - Store Information
-
-The model calls this tool to store information for future recall.
-
-**Parameters:**
-- `bankId` (required): Memory bank ID (usually the user ID)
-- `content` (required): Content to store
-- `documentId` (optional): Document ID for grouping/upserting related memories
-- `timestamp` (optional): ISO timestamp for when the memory occurred
-- `context` (optional): Additional context about the memory
-- `metadata` (optional): Key-value metadata for filtering
-
-**Example tool call:**
-```typescript
-{
-  bankId: "user-123",
-  content: "Alice loves hiking and goes to Yosemite every summer",
-  context: "User preferences",
-  timestamp: "2024-01-15T10:30:00Z"
-}
-```
-
-**Returns:**
-```typescript
-{
-  success: true,
-  itemsCount: 1
-}
-```
-
-### `recall` - Search Memories
-
-The model calls this tool to search for relevant information in memory.
-
-**Parameters:**
-- `bankId` (required): Memory bank ID
-- `query` (required): What to search for
-- `types` (optional): Filter by fact types (`['world', 'experience', 'opinion']`)
-- `maxTokens` (optional): Maximum tokens to return (default: 4096)
-- `budget` (optional): Processing budget - `'low'`, `'mid'`, or `'high'`
-- `queryTimestamp` (optional): Query from a specific time (ISO format)
-- `includeEntities` (optional): Include entity observations
-- `includeChunks` (optional): Include raw document chunks
-
-**Example tool call:**
-```typescript
-{
-  bankId: "user-123",
-  query: "What does Alice like to do outdoors?",
-  types: ["world", "experience"],
-  maxTokens: 2048,
-  budget: "mid"
-}
-```
-
-**Returns:**
-```typescript
-{
-  results: [
-    {
-      id: "mem-123",
-      text: "Alice loves hiking",
-      type: "world",
-      entities: ["Alice"],
-      context: "User preferences",
-      occurred_start: "2024-01-15T10:30:00Z",
-      document_id: "doc-456",
-      metadata: { source: "chat" }
-    }
-  ],
-  entities: {
-    "Alice": {
-      canonical_name: "Alice",
-      mention_count: 15,
-      observations: [...]
-    }
-  }
-}
-```
-
-### `reflect` - Synthesize Insights
-
-The model calls this tool to analyze memories and generate contextual insights.
-
-**Parameters:**
-- `bankId` (required): Memory bank ID
-- `query` (required): Question to reflect on
-- `context` (optional): Additional context for reflection
-- `budget` (optional): Processing budget - `'low'`, `'mid'`, or `'high'`
-
-**Example tool call:**
-```typescript
-{
-  bankId: "user-123",
-  query: "What outdoor activities does Alice enjoy?",
-  context: "Planning a weekend trip",
-  budget: "mid"
-}
-```
-
-**Returns:**
-```typescript
-{
-  text: "Alice is an avid hiker who particularly enjoys visiting Yosemite National Park during summer months. She has expressed strong preferences for mountain trails over beach activities.",
-  basedOn: [
-    {
-      id: "mem-123",
-      text: "Alice loves hiking",
-      type: "world",
-      context: "User preferences",
-      occurred_start: "2024-01-15T10:30:00Z"
-    }
-  ]
-}
-```
-
-### `createMentalModel` - Create Knowledge Consolidation
-
-The model calls this tool to create a mental model that automatically consolidates memories into structured knowledge.
-
-**Parameters:**
-- `bankId` (required): Memory bank ID
-- `mentalModelId` (optional): Custom ID for the mental model (auto-generated if not provided)
-- `name` (optional): Name for the mental model
-- `sourceQuery` (optional): Query defining which memories to consolidate
-- `tags` (optional): Tags for organizing mental models
-- `maxTokens` (optional): Maximum tokens for the content
-- `autoRefresh` (optional): Auto-refresh after new consolidations (default: false)
-
-**Example tool call:**
-```typescript
-{
-  bankId: "user-123",
-  name: "User Preferences",
-  sourceQuery: "What are the user's preferences?",
-  tags: ["preferences"],
-  autoRefresh: true
-}
-```
-
-**Returns:**
-```typescript
-{
-  mentalModelId: "mm-456",
-  createdAt: "2024-01-15T10:30:00Z"
-}
-```
-
-### `queryMentalModel` - Retrieve Consolidated Knowledge
-
-The model calls this tool to retrieve synthesized insights from an existing mental model.
-
-**Parameters:**
-- `bankId` (required): Memory bank ID
-- `mentalModelId` (required): ID of the mental model to query
-
-**Example tool call:**
-```typescript
-{
-  bankId: "user-123",
-  mentalModelId: "mm-456"
-}
-```
-
-**Returns:**
-```typescript
-{
-  content: "The user prefers outdoor activities, particularly hiking. They enjoy mountain trails and visit Yosemite regularly during summer.",
-  name: "User Preferences",
-  updatedAt: "2024-01-20T15:45:00Z"
-}
-```
-
-### `getDocument` - Retrieve Stored Document
-
-The model calls this tool to retrieve a stored document by its ID.
-
-**Parameters:**
-- `bankId` (required): Memory bank ID
-- `documentId` (required): ID of the document to retrieve
-
-**Example tool call:**
-```typescript
-{
-  bankId: "user-123",
-  documentId: "doc-789"
-}
-```
-
-**Returns:**
-```typescript
-{
-  originalText: "User profile: Alice, Software Engineer, loves hiking...",
-  id: "doc-789",
-  createdAt: "2024-01-10T09:00:00Z",
-  updatedAt: "2024-01-15T14:30:00Z"
-}
-```
-
-### `createDirective` - Create Behavioral Rule
-
-The model calls this tool to create a directive—a hard rule injected into prompts during reflect operations.
-
-**Parameters:**
-- `bankId` (required): Memory bank ID
-- `name` (required): Human-readable name for the directive
-- `content` (required): The directive text to inject
-- `priority` (optional): Higher priority directives are injected first (default: 0)
-- `isActive` (optional): Whether this directive is active (default: true)
-- `tags` (optional): Tags for filtering (e.g., user-specific directives)
-
-**Example tool call:**
-```typescript
-{
-  bankId: "user-123",
-  name: "Response Format",
-  content: "Always provide responses in bullet-point format",
-  priority: 10,
-  tags: ["formatting"]
-}
-```
-
-**Returns:**
-```typescript
-{
-  id: "dir-321",
-  name: "Response Format",
-  content: "Always provide responses in bullet-point format",
-  tags: ["formatting"],
-  createdAt: "2024-01-15T10:30:00Z"
-}
-```
-
-## Usage Examples
-
-### Using with `generateText`
-
-```typescript
-import { HindsightClient } from '@vectorize-io/hindsight-client';
-import { createHindsightTools } from '@vectorize-io/hindsight-ai-sdk';
-import { generateText } from 'ai';
-import { anthropic } from '@ai-sdk/anthropic';
-
-const hindsightClient = new HindsightClient({
-  apiUrl: 'http://localhost:8000',
-});
-
-const tools = createHindsightTools({ client: hindsightClient });
-
-const result = await generateText({
-  model: anthropic('claude-sonnet-4-20250514'),
-  tools,
-  system: `You are a helpful assistant with long-term memory. Use the recall tool to check for relevant memories before responding.`,
-  prompt: 'Remember that Alice loves hiking and prefers spicy food',
-});
-
-console.log(result.text);
-```
-
-### Using with `streamText`
+### With `streamText`
 
 ```typescript
 import { streamText } from 'ai';
 
 const result = streamText({
-  model: anthropic('claude-sonnet-4-20250514'),
+  model: openai('gpt-4o'),
   tools,
-  system: `You have persistent memory. Use retain to store important information and recall to retrieve it.`,
-  prompt: 'What do you know about Alice?',
+  maxSteps: 5,
+  system: 'You are a helpful assistant with long-term memory.',
+  prompt: 'What are my display preferences?',
 });
 
 for await (const chunk of result.textStream) {
@@ -337,30 +63,132 @@ for await (const chunk of result.textStream) {
 }
 ```
 
-### Using with `ToolLoopAgent`
+### With `ToolLoopAgent`
 
 ```typescript
-import { ToolLoopAgent, stopWhen, stepCountIs } from 'ai';
+import { generateText, ToolLoopAgent, stepCountIs } from 'ai';
+import { openai } from '@ai-sdk/openai';
+import { HindsightClient } from '@vectorize-io/hindsight-client';
+import { createHindsightTools } from '@vectorize-io/hindsight-ai-sdk';
+
+const client = new HindsightClient({ baseUrl: process.env.HINDSIGHT_API_URL! });
 
 const agent = new ToolLoopAgent({
-  model: anthropic('claude-sonnet-4-20250514'),
-  tools,
-  instructions: `You are a personal assistant with long-term memory. Always check recall before responding and use retain to store important information.`,
+  model: openai('gpt-4o'),
+  tools: createHindsightTools({ client, bankId: 'user-123' }),
   stopWhen: stepCountIs(10),
+  system: 'You are a helpful assistant with long-term memory.',
 });
 
 const result = await agent.generate({
-  prompt: 'What did I say I wanted to work on this week?',
+  prompt: 'Remember that my favorite editor is Neovim',
 });
 ```
 
-### Multi-User Support
+### In a Next.js Route Handler
 
 ```typescript
-const result = await generateText({
-  model: anthropic('claude-sonnet-4-20250514'),
-  tools,
-  system: `You are a helpful assistant. The user's ID is: ${userId}. Always pass this as the bankId parameter to memory tools.`,
-  prompt: 'Remember that I prefer dark mode',
+// app/api/chat/route.ts
+import { streamText } from 'ai';
+import { openai } from '@ai-sdk/openai';
+import { HindsightClient } from '@vectorize-io/hindsight-client';
+import { createHindsightTools } from '@vectorize-io/hindsight-ai-sdk';
+
+const hindsightClient = new HindsightClient({
+  baseUrl: process.env.HINDSIGHT_API_URL!,
+});
+
+export async function POST(req: Request) {
+  const { messages, userId } = await req.json();
+
+  // Tools are created per-request, closing over the current user's bankId
+  const tools = createHindsightTools({
+    client: hindsightClient,
+    bankId: userId,
+  });
+
+  return streamText({
+    model: openai('gpt-4o'),
+    tools,
+    maxSteps: 5,
+    system: 'You are a helpful assistant with long-term memory.',
+    messages,
+  }).toDataStreamResponse();
+}
+```
+
+---
+
+## Tools Reference
+
+Five tools are registered. The `bankId` is fixed at creation time—the agent cannot change it.
+
+| Tool | What the agent provides | What the constructor controls |
+|------|------------------------|-------------------------------|
+| `retain` | `content`, `documentId`, `timestamp`, `context` | `async`, `tags`, `metadata` |
+| `recall` | `query`, `queryTimestamp` | `budget`, `types`, `maxTokens`, `includeEntities`, `includeChunks` |
+| `reflect` | `query`, `context` | `budget` |
+| `getMentalModel` | `mentalModelId` | — |
+| `getDocument` | `documentId` | — |
+
+**Why this split?** Semantic inputs (what to remember, what to search for) belong to the agent. Infrastructure concerns (cost budget, tagging strategy, async mode) belong to the application.
+
+---
+
+## Constructor Options
+
+All options except `client` and `bankId` are optional. Each tool's options are grouped under the tool name.
+
+```typescript
+const tools = createHindsightTools({
+  client,
+  bankId: userId,
+
+  retain: {
+    async: true,                        // fire-and-forget (default: false)
+    tags: ['env:prod', 'app:support'],  // always attached to every retained memory
+    metadata: { version: '2.0' },       // always attached to every retained memory
+  },
+
+  recall: {
+    budget: 'high',                     // processing depth: low | mid | high (default: 'mid')
+    types: ['experience', 'world'],     // restrict to these fact types (default: all)
+    maxTokens: 2048,                    // cap token budget (default: API default)
+    includeEntities: true,              // include entity observations (default: false)
+    includeChunks: true,                // include raw source chunks (default: false)
+  },
+
+  reflect: {
+    budget: 'mid',                      // processing depth (default: 'mid')
+  },
+
 });
 ```
+
+### `retain`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `async` | `boolean` | `false` | Fire-and-forget — do not wait for ingestion to complete |
+| `tags` | `string[]` | — | Tags attached to every retained memory |
+| `metadata` | `Record<string, string>` | — | Metadata attached to every retained memory |
+| `description` | `string` | built-in | Override the tool description shown to the model |
+
+### `recall`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `budget` | `'low' \| 'mid' \| 'high'` | `'mid'` | Controls retrieval depth and latency |
+| `types` | `('world' \| 'experience' \| 'observation')[]` | all | Restrict results to these fact types |
+| `maxTokens` | `number` | API default | Cap the total tokens returned |
+| `includeEntities` | `boolean` | `false` | Include entity observations in results |
+| `includeChunks` | `boolean` | `false` | Include raw source chunks in results |
+| `description` | `string` | built-in | Override the tool description shown to the model |
+
+### `reflect`
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `budget` | `'low' \| 'mid' \| 'high'` | `'mid'` | Controls synthesis depth and latency |
+| `maxTokens` | `number` | API default | Maximum tokens for the response |
+| `description` | `string` | built-in | Override the tool description shown to the model |
diff --git a/uv.lock b/uv.lock
index 6613fa72..eb196ab2 100644
--- a/uv.lock
+++ b/uv.lock
@@ -1422,7 +1422,7 @@ wheels = [
 
 [[package]]
 name = "hindsight-all"
-version = "0.4.11"
+version = "0.4.12"
 source = { editable = "hindsight" }
 dependencies = [
     { name = "hindsight-api" },
@@ -1448,7 +1448,7 @@ provides-extras = ["test"]
 
 [[package]]
 name = "hindsight-api"
-version = "0.4.11"
+version = "0.4.12"
 source = { editable = "hindsight-api" }
 dependencies = [
     { name = "aiohttp" },
@@ -1596,7 +1596,7 @@ dev = [
 
 [[package]]
 name = "hindsight-client"
-version = "0.4.11"
+version = "0.4.12"
 source = { editable = "hindsight-clients/python" }
 dependencies = [
     { name = "aiohttp" },
@@ -1630,7 +1630,7 @@ provides-extras = ["test"]
 
 [[package]]
 name = "hindsight-dev"
-version = "0.4.11"
+version = "0.4.12"
 source = { editable = "hindsight-dev" }
 dependencies = [
     { name = "hindsight-api" },
@@ -1678,7 +1678,7 @@ dev = [
 
 [[package]]
 name = "hindsight-embed"
-version = "0.4.11"
+version = "0.4.12"
 source = { editable = "hindsight-embed" }
 dependencies = [
     { name = "httpx" },