From 928dc696e8839e5545b9f3e909a0f7fae3f79ae7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Nicol=C3=B2=20Boschi?= Date: Fri, 6 Mar 2026 09:55:45 +0100 Subject: [PATCH] doc: document all missing bank config fields in memory-banks.mdx (#508) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Add retain_chunk_size (max chars per chunk for fact extraction) - Rename mission → reflect_mission to match actual API field name - Add mcp_enabled_tools (per-bank MCP tool allowlist) - Add llm_gemini_safety_settings (Gemini/VertexAI content filtering) --- .../docs/developer/api/memory-banks.mdx | 33 +++++++++++++++++-- 1 file changed, 31 insertions(+), 2 deletions(-) diff --git a/hindsight-docs/docs/developer/api/memory-banks.mdx b/hindsight-docs/docs/developer/api/memory-banks.mdx index 85bd477c..bc26faaf 100644 --- a/hindsight-docs/docs/developer/api/memory-banks.mdx +++ b/hindsight-docs/docs/developer/api/memory-banks.mdx @@ -81,6 +81,12 @@ Controls how aggressively facts are extracted: Only active when `retain_extraction_mode` is `custom`. Replaces the built-in extraction rules entirely with your own instructions. +### retain_chunk_size + +Maximum number of characters per chunk when splitting content for fact extraction. Larger chunks mean fewer LLM calls but may reduce extraction quality on long inputs; smaller chunks improve granularity at the cost of more calls. + +Default: `3000` + See [Retain configuration](/developer/configuration#retain) for environment variable names and defaults. ### entity_labels {#entity-labels} @@ -166,7 +172,7 @@ e.g. Observations are stable facts about people and projects. See [Observations configuration](/developer/configuration#observations) for environment variable names and defaults. -### mission +### reflect_mission A first-person narrative that provides identity and framing context for `reflect`. The agent uses this to ground its reasoning and apply a consistent perspective. @@ -216,9 +222,32 @@ How much to weight emotional context when reasoning during `reflect`. Scale 1– | `5` | Empathetic — considers emotional context | :::info -Disposition traits and `mission` only affect the `reflect` operation. `retain_mission` and `observations_mission` are separate per-operation settings. +Disposition traits and `reflect_mission` only affect the `reflect` operation. `retain_mission` and `observations_mission` are separate per-operation settings. ::: +### mcp_enabled_tools + +An allowlist of MCP tool names that are enabled for this bank. When set, only the listed tools can be invoked; any tool not in the list returns an error (tools still appear in the MCP tools list for protocol compatibility). Set to `null` (or omit) to allow all tools. + +```json +["recall", "reflect"] +``` + +Available tool names: `retain`, `recall`, `reflect`, `list_banks`, `create_bank`, `list_mental_models`, `get_mental_model`, `create_mental_model`, `update_mental_model`, `delete_mental_model`, `refresh_mental_model`, `list_directives`, `create_directive`, `delete_directive`, `list_memories`, `get_memory`, `delete_memory`, `list_documents`, `get_document`, `delete_document`, `list_operations`, `get_operation`, `cancel_operation`, `list_tags`, `get_bank`, `get_bank_stats`, `update_bank`, `delete_bank`, `clear_memories`. + +### llm_gemini_safety_settings + +Controls content filtering thresholds for Gemini and VertexAI providers. Accepts a list of safety setting objects in the [Google AI safety settings format](https://ai.google.dev/api/generate-content#v1beta.SafetySetting). When `null` (default), Gemini's built-in safety defaults are used. + +```json +[ + {"category": "HARM_CATEGORY_HARASSMENT", "threshold": "BLOCK_NONE"}, + {"category": "HARM_CATEGORY_HATE_SPEECH", "threshold": "BLOCK_NONE"} +] +``` + +Only applies when `HINDSIGHT_API_LLM_PROVIDER` is `gemini` or `vertexai`. + --- ## Updating Configuration