fleet-memory/hindsight-api/hindsight_api
Bjorn Schliebitz 6b5f593dca
feat(mcp): Add multi-bank access and new MCP tools (#82)
* feat(mcp): Add multi-bank access and new MCP tools

Enables orchestrator agents to access multiple memory banks from a
single MCP connection, with new tools for bank management.

## New MCP Tools
- `reflect` - Thoughtful analysis using bank's personality and memories
- `list_banks` - Discover all available memory banks
- `create_bank` - Create new banks programmatically

## Multi-Bank Access
- Added optional `bank_id` parameter to `retain`, `recall`, `reflect`
- Allows cross-bank operations from a single MCP session
- Defaults to session bank if not specified

## Claude Code Compatibility
- Enabled `stateless_http=True` for proper Claude Code integration
- Responses now include `bank_id` for transparency

## Documentation
- Added docker-compose.example.yml with env var substitution
- Added HINDSIGHT-DOCKER.md setup guide with volume persistence docs
- Updated .gitignore to exclude local docker-compose.yml

## Use Case
Orchestrator agents can now:
- Maintain a private meta-orchestration bank
- Access shared project knowledge banks
- Query across banks for cross-context insights

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Address PR review feedback: remove docker files, improve reflect description

- Remove HINDSIGHT-DOCKER.md and docker-compose.example.yml per reviewer request
- Improve reflect tool description with clearer guidance for AI agents:
  - Added "WHEN TO USE THIS TOOL" section
  - Added "EXAMPLES OF GOOD QUERIES" with concrete use cases
  - Added "HOW IT DIFFERS FROM RECALL" to clarify when to use each tool

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-05 10:06:52 +01:00
..
alembic Feature/graph viz (#85) 2026-01-02 16:27:29 +01:00
api feat(mcp): Add multi-bank access and new MCP tools (#82) 2026-01-05 10:06:52 +01:00
engine feat: Add user-provided entities support to retain endpoint (#91) 2026-01-05 10:05:17 +01:00
extensions Add operation validator extension support with proper HTTP error handling (#86) 2026-01-01 20:19:52 -05:00
__init__.py feat: extensions (#54) 2025-12-22 11:05:23 +01:00
banner.py fix: doc build and lint files (#34) 2025-12-16 13:49:09 +01:00
config.py feat: Add local LLM improvements for reasoning models and Docker startup (#88) 2026-01-05 10:04:58 +01:00
daemon.py feat: refactor hindsight-embed architecture (#66) 2025-12-22 22:02:40 +01:00
main.py Add operation validator extension support with proper HTTP error handling (#86) 2026-01-01 20:19:52 -05:00
mcp_local.py feat: extensions (#54) 2025-12-22 11:05:23 +01:00
metrics.py fix: doc build and lint files (#34) 2025-12-16 13:49:09 +01:00
migrations.py Feature/graph viz (#85) 2026-01-02 16:27:29 +01:00
models.py Add operation validator extension support with proper HTTP error handling (#86) 2026-01-01 20:19:52 -05:00
pg0.py feat: extensions (#54) 2025-12-22 11:05:23 +01:00
server.py fix: doc build and lint files (#34) 2025-12-16 13:49:09 +01:00