fleet-memory/hindsight-docs/examples/api/recall.sh
Nicolò Boschi 5b52a84fff
chore: internal renames (#204)
This commit renames the terminology across the entire codebase:
- "mental models" (fact_type='mental_model' in memory_units) → "observations"
- "reflections" table (stored reflect responses) → "mental_models"

Changes include:
- Database migration to rename tables, indexes, and constraints
- API endpoints: /reflections → /mental-models, /mental-models → /observations
- Config: ENABLE_MENTAL_MODELS → ENABLE_OBSERVATIONS
- Response models and Pydantic classes
- Reflect agent tools and prompts
- Control plane UI and routes
- Documentation and examples
- Regenerated OpenAPI spec and client SDKs (Python, TypeScript)
- Rust CLI: reflection commands → mental-model commands
- LiteLLM: updated fact_types documentation
2026-01-27 09:53:28 +01:00

46 lines
1.4 KiB
Bash
Executable file

#!/bin/bash
# Recall API examples for Hindsight CLI
# Run: bash examples/api/recall.sh
set -e
HINDSIGHT_URL="${HINDSIGHT_API_URL:-http://localhost:8888}"
# =============================================================================
# Setup (not shown in docs)
# =============================================================================
hindsight memory retain my-bank "Alice works at Google as a software engineer"
hindsight memory retain my-bank "Alice loves hiking on weekends"
# =============================================================================
# Doc Examples
# =============================================================================
# [docs:recall-basic]
hindsight memory recall my-bank "What does Alice do?"
# [/docs:recall-basic]
# [docs:recall-with-options]
hindsight memory recall my-bank "hiking recommendations" \
--budget high \
--max-tokens 8192
# [/docs:recall-with-options]
# [docs:recall-fact-type]
hindsight memory recall my-bank "query" --fact-type world,observation
# [/docs:recall-fact-type]
# [docs:recall-trace]
hindsight memory recall my-bank "query" --trace
# [/docs:recall-trace]
# =============================================================================
# Cleanup (not shown in docs)
# =============================================================================
curl -s -X DELETE "${HINDSIGHT_URL}/v1/default/banks/my-bank" > /dev/null
echo "recall.sh: All examples passed"