Embeddings capability (prerequisite for surprisal sampling) #943

Closed
opened 2026-10-27 13:38:23 +00:00 by sam · 0 comments
Owner

Surprisal-based sampling (curator epic DESIGN) requires computing vector embeddings of memory content so memories can be scored by how surprising they are. Archie has no embedding capability today; the epic gates any surprisal-style sampling behind adding one. This issue tracks that prerequisite so it can be picked up independently of the curator epic's main work. The consumer is the embedding-backed surprisal sampler (sibling issue 'Surprisal sampling: embedding-backed strategies'). Embedding consumers must degrade gracefully: content with no embedding is skipped, and an embedding failure aborts sampling in favour of free exploration rather than crashing the pass.

Acceptance Criteria

An embedding client exists behind a narrow typed interface usable by in-process daemon components (curators first, other consumers later). Provider/model is config-driven (providers table + a role in [models]). A missing credential degrades per the credential-missing-degrades-not-fatal rule: capability reports unavailable, daemon still starts. Network calls carry timeouts; failures surface as reported errors, never a crash or a failed chat turn. Tests use httptest and never require a live embedding service.

Close reason

Verified landed: internal/domain/embedding contract + internal/infrastructure/embedding implementation, wired as optional capability via boot.setupEmbeddings.


Imported from beads archie-core-1786637500752-415-434e5bb9 · GitHub #436 · type task · priority P2 · created 2026-08-08 · closed 2026-09-11

Surprisal-based sampling (curator epic DESIGN) requires computing vector embeddings of memory content so memories can be scored by how surprising they are. Archie has no embedding capability today; the epic gates any surprisal-style sampling behind adding one. This issue tracks that prerequisite so it can be picked up independently of the curator epic's main work. The consumer is the embedding-backed surprisal sampler (sibling issue 'Surprisal sampling: embedding-backed strategies'). Embedding consumers must degrade gracefully: content with no embedding is skipped, and an embedding failure aborts sampling in favour of free exploration rather than crashing the pass. ### Acceptance Criteria An embedding client exists behind a narrow typed interface usable by in-process daemon components (curators first, other consumers later). Provider/model is config-driven (providers table + a role in [models]). A missing credential degrades per the credential-missing-degrades-not-fatal rule: capability reports unavailable, daemon still starts. Network calls carry timeouts; failures surface as reported errors, never a crash or a failed chat turn. Tests use httptest and never require a live embedding service. ### Close reason Verified landed: internal/domain/embedding contract + internal/infrastructure/embedding implementation, wired as optional capability via boot.setupEmbeddings. --- _Imported from beads `archie-core-1786637500752-415-434e5bb9` · GitHub #436 · type task · priority P2 · created 2026-08-08 · closed 2026-09-11_
sam added the mediumtask labels 2026-10-27 13:38:23 +00:00
sam self-assigned this 2026-10-27 13:38:23 +00:00
sam closed this issue 2026-10-27 13:38:24 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: sam/archie#943