Skip to content

docs: propose durable client-side retain outbox pattern - #3823

Draft
Kosello wants to merge 2 commits into
vectorize-io:mainfrom
Kosello:proposal/hermes-durable-outbox
Draft

docs: propose durable client-side retain outbox pattern#3823
Kosello wants to merge 2 commits into
vectorize-io:mainfrom
Kosello:proposal/hermes-durable-outbox

Conversation

@Kosello

@Kosello Kosello commented Aug 26, 2026

Copy link
Copy Markdown

Summary

This draft proposes a documented client-side durability pattern for Hermes Agent and other Hindsight integrations that must survive temporary Hindsight outages or client restarts.

It adds only:

  • hindsight-integrations/hermes-durable-outbox/README.md

The document describes the contract and validation matrix for a profile-scoped SQLite retain outbox: persist before dispatch, atomic claims, bounded retry, stale-claim recovery, restart replay, stable operation IDs where supported, and explicit at-least-once limitations.

Scope boundary

This PR does not change Hindsight server code, schema, API semantics, extraction, embeddings, reranking, consolidation, recall, or reflect behavior. It does not register a released integration or alter the integration index; it is a reviewable proposal for maintainers to decide whether a common pattern or SDK guidance is useful.

Related work

Questions for review

  1. Should Hindsight document a recommended client-side outbox pattern for integrations?
  2. What operation-ID/idempotency guarantees should the SDK document?
  3. Should a reusable helper live under hindsight-integrations, or should each client own its queue?
  4. What is the canonical interpretation of an operation-status 404 after retention?

This is intentionally a draft and contains no Hindsight server migration.

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.

1 participant