Eve + MemorySync

Overview

eve-memorysync turns Eve’s hook, dynamic-instruction, and channel primitives into a complete memory layer. createMemoryHooks() sends the user’s message from message.received to fact extraction with a deterministic content seed, and message.completed sends nothing (assistant replies are not stored) — Eve delivers hooks at-least-once and re-emits fresh event ids on retries, so the content seed is what lets the server recognise a redelivered message and not extract it again. createMemoryInstructions() resolves on turn.started, consumes the inbound utterance from a hardened stash (Eve’s resolver fires before the user text is visible, so the channel records it first via one stashUtterance() call), and injects a labeled, turn-scoped recall block under a 1.2s fail-open budget. Every handler is fully guarded because a thrown Eve hook fails the whole turn. Identity comes from the session auth principal — never from the model. The incumbent integration is copy-paste boilerplate with an unbounded in-process stash, no truncation, no retry convergence, and a shared demo user id; eve-memorysync is an installed package with bounds, budgets, and seeds — and a stash miss degrades to a profile recall instead of a turn without memory.

Setup status and requirements

Supported version

eve-memorysync 1.1.0 (npm)

Last setup review

2026-10-01

Permissions

A MemorySync API key with read and write scopes.

Limits

Node.js 24+ (Eve’s own minimum). Eve is in public beta, so its APIs may change before general availability.

Capabilities

• The FIRST installable Eve memory package — npm install, three one-line mounts
• Content seeds — an at-least-once redelivery is recognised, never extracted twice
• Turn-scoped recall block — replaced each turn, 1.2s fail-open budget
• Hardened utterance stash: TTL, bounded, create-session queue handoff
• Stash misses degrade to a profile recall — never a memory-less turn by surprise
• A memory failure can never fail the turn — every handler is guarded
• Identity from the session auth principal — the model can never pick the user
• search_memories tool is search-only — no deletes exposed to the model

Quick Start

// agent/hooks/memorysync.ts
import { createMemoryHooks } from 'eve-memorysync'
export default createMemoryHooks()

// agent/instructions/memorysync.ts
import { createMemoryInstructions } from 'eve-memorysync'
export default createMemoryInstructions()

// agent/channels/eve.ts — one line in onMessage:
//   stashUtterance(ctx, message)

Use Cases

Explore More