Eve library

@oshun/memory-iris

Other

Revision 1

On this page

Canonical Iris memory adapter contracts for OSHUN.

This package defines the product-facing memory substrate interface that OSHUN surfaces use when they need assistant identity, continuity, consent-aware memory scopes, searchable recall, review/delete controls, and exportability.

It deliberately normalizes the mismatches that already exist across Iris memory packages:

  • @iris/contracts uses core / working / archival / episodic
  • @iris/memory-core uses stm / ltm / episodic / semantic
  • @iris/privacy review tooling uses @iris/memory-core tiers

The adapter contract exposes one canonical tier model, one scope model, one consent rollup, and one review/search/export surface for OSHUN shell and admin integration work.

Scope#

  • canonical assistant-profile, continuity, consent, search, review, deletion, and export DTOs
  • low-level adapter interface for Iris memory, privacy, personalization, and export primitives
  • canonical adapter factory (createCanonicalIrisMemoryAdapter) that wraps an injected low-level Iris adapter
  • normalization helpers that align @iris/* memory tiers and content models with OSHUN contracts

Usage#

ts
import { createCanonicalIrisMemoryAdapter } from '@oshun/memory-iris';

const iris = createCanonicalIrisMemoryAdapter({ apiAdapter });

const continuity = await iris.getContinuityState({
  userId: 'user-123',
  consumer: 'assistant',
  activeDomain: 'nisaba',
});