From 22ba22a898d9940f4fd0a5906c209fdcde91a039 Mon Sep 17 00:00:00 2001 From: Evo Date: Sun, 21 Jun 2026 08:51:34 +0800 Subject: [PATCH] docs(integrations): drop removed 'opinion' fact type from recall_types/fact_types The 'opinion' fact type was removed in v0.8.0 (#1917). The recall API now rejects it: - response_models.py: VALID_RECALL_FACT_TYPES = frozenset(['world', 'experience', 'observation']) - http.py (recall + reflect): fact_types: list[Literal['world', 'experience', 'observation']] | None - models.py: CheckConstraint("fact_type IN ('world', 'experience', 'observation')") Ten integration SDK packages still advertised 'opinion' as a valid recall_types/fact_types value in public tool docstrings, one inline comment, and two README tables, so an agent copying them passes a value the API 422-rejects. Completes the ripple started by #2198 / #2302 / #2323 across the hindsight-integrations/* tail (text only, no logic change). --- hindsight-integrations/ag2/hindsight_ag2/tools.py | 2 +- hindsight-integrations/autogen/README.md | 2 +- hindsight-integrations/autogen/hindsight_autogen/tools.py | 2 +- .../claude-agent-sdk/hindsight_claude_agent_sdk/tools.py | 2 +- .../continue/hindsight_continue/config.py | 2 +- .../google-adk/hindsight_google_adk/tools.py | 2 +- .../haystack/hindsight_haystack/tools.py | 2 +- .../langgraph/hindsight_langgraph/nodes.py | 2 +- .../langgraph/hindsight_langgraph/tools.py | 2 +- .../litellm/hindsight_litellm/config.py | 8 ++++---- .../llamaindex/hindsight_llamaindex/tools.py | 4 ++-- hindsight-integrations/openai-agents/README.md | 2 +- .../openai-agents/hindsight_openai_agents/tools.py | 2 +- 13 files changed, 17 insertions(+), 17 deletions(-) diff --git a/hindsight-integrations/ag2/hindsight_ag2/tools.py b/hindsight-integrations/ag2/hindsight_ag2/tools.py index 1608d1987..ae1d70ec0 100644 --- a/hindsight-integrations/ag2/hindsight_ag2/tools.py +++ b/hindsight-integrations/ag2/hindsight_ag2/tools.py @@ -64,7 +64,7 @@ def create_hindsight_tools( recall_tags_match: Tag matching mode (any/all/any_strict/all_strict). retain_metadata: Default metadata dict for retain operations. retain_document_id: Default document_id for retain (groups/upserts memories). - recall_types: Fact types to filter (world, experience, opinion, observation). + recall_types: Fact types to filter (world, experience, observation). recall_include_entities: Include entity information in recall results. reflect_context: Additional context for reflect operations. reflect_max_tokens: Max tokens for reflect results (defaults to max_tokens). diff --git a/hindsight-integrations/autogen/README.md b/hindsight-integrations/autogen/README.md index b713c6e36..05165d165 100644 --- a/hindsight-integrations/autogen/README.md +++ b/hindsight-integrations/autogen/README.md @@ -131,7 +131,7 @@ tools = create_hindsight_tools( | `recall_tags_match` | `"any"` | Tag matching mode (any/all/any\_strict/all\_strict) | | `retain_metadata` | `None` | Default metadata dict for retain operations | | `retain_document_id` | `None` | Default document\_id for retain (groups/upserts memories) | -| `recall_types` | `None` | Fact types to filter (world, experience, opinion, observation) | +| `recall_types` | `None` | Fact types to filter (world, experience, observation) | | `recall_include_entities` | `False` | Include entity information in recall results | | `reflect_context` | `None` | Additional context for reflect operations | | `reflect_max_tokens` | `None` | Max tokens for reflect results (defaults to `max_tokens`) | diff --git a/hindsight-integrations/autogen/hindsight_autogen/tools.py b/hindsight-integrations/autogen/hindsight_autogen/tools.py index dae05e3eb..b064ddce9 100644 --- a/hindsight-integrations/autogen/hindsight_autogen/tools.py +++ b/hindsight-integrations/autogen/hindsight_autogen/tools.py @@ -71,7 +71,7 @@ def create_hindsight_tools( recall_tags_match: Tag matching mode (any/all/any_strict/all_strict). retain_metadata: Default metadata dict for retain operations. retain_document_id: Default document_id for retain (groups/upserts memories). - recall_types: Fact types to filter (world, experience, opinion, observation). + recall_types: Fact types to filter (world, experience, observation). recall_include_entities: Include entity information in recall results. reflect_context: Additional context for reflect operations. reflect_max_tokens: Max tokens for reflect results (defaults to max_tokens). diff --git a/hindsight-integrations/claude-agent-sdk/hindsight_claude_agent_sdk/tools.py b/hindsight-integrations/claude-agent-sdk/hindsight_claude_agent_sdk/tools.py index 88d81b334..828f2ac54 100644 --- a/hindsight-integrations/claude-agent-sdk/hindsight_claude_agent_sdk/tools.py +++ b/hindsight-integrations/claude-agent-sdk/hindsight_claude_agent_sdk/tools.py @@ -71,7 +71,7 @@ def create_hindsight_tools( recall_tags_match: Tag matching mode (any/all/any_strict/all_strict). retain_metadata: Default metadata dict for retain operations. retain_document_id: Default document_id for retain (groups/upserts memories). - recall_types: Fact types to filter (world, experience, opinion, observation). + recall_types: Fact types to filter (world, experience, observation). recall_include_entities: Include entity information in recall results. reflect_context: Additional context for reflect operations. reflect_max_tokens: Max tokens for reflect results (defaults to max_tokens). diff --git a/hindsight-integrations/continue/hindsight_continue/config.py b/hindsight-integrations/continue/hindsight_continue/config.py index 0f8c30a4b..49261c8cf 100644 --- a/hindsight-integrations/continue/hindsight_continue/config.py +++ b/hindsight-integrations/continue/hindsight_continue/config.py @@ -44,7 +44,7 @@ class HindsightContinueConfig: it via ``options.bankId``). budget: Recall budget level (low/mid/high). max_tokens: Maximum tokens for recall results. - recall_types: Fact types to filter (world, experience, opinion, observation). + recall_types: Fact types to filter (world, experience, observation). recall_tags: Tags to filter recalled memories. recall_tags_match: Tag matching mode (any/all/any_strict/all_strict). item_name: Title shown for the injected context item in Continue. diff --git a/hindsight-integrations/google-adk/hindsight_google_adk/tools.py b/hindsight-integrations/google-adk/hindsight_google_adk/tools.py index 1dea7cc7b..94f21dc37 100644 --- a/hindsight-integrations/google-adk/hindsight_google_adk/tools.py +++ b/hindsight-integrations/google-adk/hindsight_google_adk/tools.py @@ -58,7 +58,7 @@ def create_hindsight_tools( recall_tags_match: Tag matching mode (``any``/``all``/``any_strict``/``all_strict``). retain_metadata: Default metadata dict for retain operations. retain_document_id: Default document_id for retain (groups/upserts memories). - recall_types: Fact types to filter (``world``, ``experience``, ``opinion``, ``observation``). + recall_types: Fact types to filter (``world``, ``experience``, ``observation``). recall_include_entities: Include entity information in recall results. reflect_context: Additional context for reflect operations. reflect_max_tokens: Max tokens for reflect results (defaults to ``max_tokens``). diff --git a/hindsight-integrations/haystack/hindsight_haystack/tools.py b/hindsight-integrations/haystack/hindsight_haystack/tools.py index ad85a34b4..1fa6de75b 100644 --- a/hindsight-integrations/haystack/hindsight_haystack/tools.py +++ b/hindsight-integrations/haystack/hindsight_haystack/tools.py @@ -565,7 +565,7 @@ def create_hindsight_tools( retain_document_id: Default document_id for retain. If None, auto-generates per call. retain_context: Source label for retain operations. - recall_types: Fact types to filter (world, experience, opinion, observation). + recall_types: Fact types to filter (world, experience, observation). recall_include_entities: Include entity information in recall results. reflect_context: Additional context for reflect operations. reflect_max_tokens: Max tokens for reflect results (defaults to max_tokens). diff --git a/hindsight-integrations/langgraph/hindsight_langgraph/nodes.py b/hindsight-integrations/langgraph/hindsight_langgraph/nodes.py index 7d5b93834..7212b8a7b 100644 --- a/hindsight-integrations/langgraph/hindsight_langgraph/nodes.py +++ b/hindsight-integrations/langgraph/hindsight_langgraph/nodes.py @@ -96,7 +96,7 @@ class AgentState(MessagesState): max_results: Maximum number of memories to inject. tags: Tags to filter recall results. tags_match: Tag matching mode. - recall_types: Fact types to filter (world, experience, opinion, observation). + recall_types: Fact types to filter (world, experience, observation). recall_include_entities: Include entity information in recall results. bank_id_from_config: Config key to read bank_id from at runtime. Looked up in ``config["configurable"][bank_id_from_config]``. diff --git a/hindsight-integrations/langgraph/hindsight_langgraph/tools.py b/hindsight-integrations/langgraph/hindsight_langgraph/tools.py index 808d729c4..076de8b5f 100644 --- a/hindsight-integrations/langgraph/hindsight_langgraph/tools.py +++ b/hindsight-integrations/langgraph/hindsight_langgraph/tools.py @@ -63,7 +63,7 @@ def create_hindsight_tools( recall_tags_match: Tag matching mode (any/all/any_strict/all_strict). retain_metadata: Default metadata dict for retain operations. retain_document_id: Default document_id for retain (groups/upserts memories). - recall_types: Fact types to filter (world, experience, opinion, observation). + recall_types: Fact types to filter (world, experience, observation). recall_include_entities: Include entity information in recall results. reflect_context: Additional context for reflect operations. reflect_max_tokens: Max tokens for reflect results (defaults to max_tokens). diff --git a/hindsight-integrations/litellm/hindsight_litellm/config.py b/hindsight-integrations/litellm/hindsight_litellm/config.py index a5c597b38..846dd7134 100644 --- a/hindsight-integrations/litellm/hindsight_litellm/config.py +++ b/hindsight-integrations/litellm/hindsight_litellm/config.py @@ -72,7 +72,7 @@ class HindsightCallSettings: injection_mode: How to inject memories (system_message or prepend_user) budget: Budget level for memory recall (low, mid, high) - fact_types: Filter by fact types (world, experience, opinion, observation) + fact_types: Filter by fact types (world, experience, observation) max_memories: Maximum memories to inject (None = no limit) max_memory_tokens: Maximum tokens for memory context include_entities: Include entity observations in recall results @@ -109,7 +109,7 @@ class HindsightCallSettings: # Recall settings budget: str = "mid" # low, mid, high - fact_types: Optional[List[str]] = None # world, experience, opinion, observation + fact_types: Optional[List[str]] = None # world, experience, observation max_memories: Optional[int] = None # None = no limit max_memory_tokens: int = 4096 include_entities: bool = True @@ -282,7 +282,7 @@ def configure( inject_memories: Whether to inject memories (default: True) injection_mode: How to inject memories (system_message or prepend_user) budget: Recall budget level - low/mid/high (default: "mid") - fact_types: Filter by fact types (world/experience/opinion/observation) + fact_types: Filter by fact types (world/experience/observation) max_memories: Max memories to inject (None = no limit) max_memory_tokens: Max tokens for memory context (default: 4096) include_entities: Include entity observations in recall (default: True) @@ -423,7 +423,7 @@ def set_defaults( inject_memories: Whether to inject memories injection_mode: How to inject memories (system_message or prepend_user) budget: Budget level for memory recall (low, mid, high) - fact_types: Fact types to filter (world, experience, opinion, observation) + fact_types: Fact types to filter (world, experience, observation) max_memories: Max number of memories to inject max_memory_tokens: Max tokens for memory context include_entities: Include entity observations in recall diff --git a/hindsight-integrations/llamaindex/hindsight_llamaindex/tools.py b/hindsight-integrations/llamaindex/hindsight_llamaindex/tools.py index e6e5f1584..ae67c47cd 100644 --- a/hindsight-integrations/llamaindex/hindsight_llamaindex/tools.py +++ b/hindsight-integrations/llamaindex/hindsight_llamaindex/tools.py @@ -37,7 +37,7 @@ class HindsightToolSpec(BaseToolSpec): retain_document_id: Default document_id for retain. If None, auto-generates ``{session_id}-{timestamp_ms}`` per call. retain_context: Source label for retain operations (default: "llamaindex"). - recall_types: Fact types to filter (world, experience, opinion, observation). + recall_types: Fact types to filter (world, experience, observation). recall_include_entities: Include entity information in recall results. reflect_context: Additional context for reflect operations. reflect_max_tokens: Max tokens for reflect results (defaults to max_tokens). @@ -386,7 +386,7 @@ def create_hindsight_tools( retain_document_id: Default document_id for retain. If None, auto-generates per call. retain_context: Source label for retain operations. - recall_types: Fact types to filter (world, experience, opinion, observation). + recall_types: Fact types to filter (world, experience, observation). recall_include_entities: Include entity information in recall results. reflect_context: Additional context for reflect operations. reflect_max_tokens: Max tokens for reflect results (defaults to max_tokens). diff --git a/hindsight-integrations/openai-agents/README.md b/hindsight-integrations/openai-agents/README.md index ce45f705a..baa275ec9 100644 --- a/hindsight-integrations/openai-agents/README.md +++ b/hindsight-integrations/openai-agents/README.md @@ -152,7 +152,7 @@ tools = create_hindsight_tools( | `recall_tags_match` | `"any"` | Tag matching mode (any/all/any\_strict/all\_strict) | | `retain_metadata` | `None` | Default metadata dict for retain operations | | `retain_document_id` | `None` | Default document\_id for retain (groups/upserts memories) | -| `recall_types` | `None` | Fact types to filter (world, experience, opinion, observation) | +| `recall_types` | `None` | Fact types to filter (world, experience, observation) | | `recall_include_entities` | `False` | Include entity information in recall results | | `reflect_context` | `None` | Additional context for reflect operations | | `reflect_max_tokens` | `None` | Max tokens for reflect results (defaults to `max_tokens`) | diff --git a/hindsight-integrations/openai-agents/hindsight_openai_agents/tools.py b/hindsight-integrations/openai-agents/hindsight_openai_agents/tools.py index 2f32f33ab..3c1f8c556 100644 --- a/hindsight-integrations/openai-agents/hindsight_openai_agents/tools.py +++ b/hindsight-integrations/openai-agents/hindsight_openai_agents/tools.py @@ -74,7 +74,7 @@ def create_hindsight_tools( recall_tags_match: Tag matching mode (any/all/any_strict/all_strict). retain_metadata: Default metadata dict for retain operations. retain_document_id: Default document_id for retain (groups/upserts memories). - recall_types: Fact types to filter (world, experience, opinion, observation). + recall_types: Fact types to filter (world, experience, observation). recall_include_entities: Include entity information in recall results. reflect_context: Additional context for reflect operations. reflect_max_tokens: Max tokens for reflect results (defaults to max_tokens).