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/contractsusescore/working/archival/episodic@iris/memory-coreusesstm/ltm/episodic/semantic@iris/privacyreview tooling uses@iris/memory-coretiers
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',
});