Skip to content

feat(hindsight): feature parity, setup wizard, and config improvements#6428

Merged
teknium1 merged 1 commit into
NousResearch:mainfrom
nicoloboschi:fix/hindsight-feature-parity
Apr 9, 2026
Merged

feat(hindsight): feature parity, setup wizard, and config improvements#6428
teknium1 merged 1 commit into
NousResearch:mainfrom
nicoloboschi:fix/hindsight-feature-parity

Conversation

@nicoloboschi

Copy link
Copy Markdown
Contributor

Summary

Ports missing features from the hindsight-hermes external integration package into the native plugin, enabling the external package to be dropped. Only modifies files within the plugin boundary — no core changes.

Features

  • Tags: tags on retain, recall_tags / recall_tags_match on recall
  • Recall config: recall_max_tokens, recall_max_input_chars, recall_types, recall_prompt_preamble
  • Retain controls: retain_every_n_turns, auto_retain, auto_recall, retain_async (via aretain_batch), retain_context
  • Bank config: bank_mission and bank_retain_mission applied via Banks API during setup
  • Structured retain: JSON format with per-message timestamps, full session accumulation with document_id for dedup
  • Setup wizard: custom post_setup() with curses arrow-key picker, mode-aware dependency installation
  • New modes: local_external (connect to existing instance), openai_compatible and openrouter LLM providers
  • Auto-upgrade: detects outdated hindsight-client (<0.4.22) and upgrades automatically on session start
  • Debug logging: comprehensive logs across all operations (visible with hermes -vv)

Tests

46 unit tests covering config, tool handlers, prefetch, sync_turn, schemas, and availability.

Docs

Updated plugin README and website memory-providers page.

Not included

retain_tool_calls (including tool calls in retained content) requires a turn_messages parameter on the core sync_turn() ABC — filed separately for evaluation.

Test plan

  • 46 unit tests pass
  • Manual testing with cloud mode (retain, recall, reflect, async retain)
  • hermes memory setup wizard tested end-to-end
  • Auto-upgrade verified in logs
  • Local embedded mode testing
  • Local external mode testing

Port missing features from the hindsight-hermes external integration
package into the native plugin. Only touches plugin files — no core
changes.

Features:
- Tags on retain/recall (tags, recall_tags, recall_tags_match)
- Recall config (recall_max_tokens, recall_max_input_chars, recall_types,
  recall_prompt_preamble)
- Retain controls (retain_every_n_turns, auto_retain, auto_recall,
  retain_async via aretain_batch, retain_context)
- Bank config via Banks API (bank_mission, bank_retain_mission)
- Structured JSON retain with per-message timestamps
- Full session accumulation with document_id for dedup
- Custom post_setup() wizard with curses picker
- Mode-aware dep install (hindsight-client for cloud, hindsight-all for local)
- local_external mode and openai_compatible LLM provider
- OpenRouter support with auto base URL
- Auto-upgrade of hindsight-client to >=0.4.22 on session start
- Comprehensive debug logging across all operations
- 46 unit tests
- Updated README and website docs
@teknium1 teknium1 merged commit 25757d6 into NousResearch:main Apr 9, 2026
2 of 5 checks passed
@teknium1

teknium1 commented Apr 9, 2026

Copy link
Copy Markdown
Contributor

Merged — thanks @nicoloboschi! Clean plugin-only PR, 46 tests, no core changes. The hindsight-hermes external package can now be dropped.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants