Eve + MemorySync

Overview

eve-memorysync turns Eve’s hook, dynamic-instruction, and channel primitives into a complete memory layer. createMemoryHooks() persists both sides of every turn from message.received and message.completed with deterministic idempotency seeds — Eve delivers hooks at-least-once and re-emits fresh event ids on retries, so seed convergence is the difference between one stored row and duplicates. 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.0.0 (npm)

Last setup review

2026-08-25

Permissions

A MemorySync API key with read and write scopes.

Limits

Node.js 24+ (Eve’s own minimum). Eve is in public beta; the package pins the eve version it is tested against.

Capabilities

• The FIRST installable Eve memory package — npm install, three one-line mounts
• Idempotent seeds — Eve’s at-least-once hook retries converge, never duplicate
• 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