@dudoxx/ddx-memory-contract

Single source of truth for every type that crosses a module boundary in the DDX PerpMemory stack — cards, decks, scopes, tiers, kinds, links, the isolation filter, the store interface, and the reconcile / ingest / MCP request–response shapes.

Zero framework imports: zod is the only runtime dependency. Ships a triple build (ESM / CommonJS / types) for Node ≥ 20.19.

Install

npm install @dudoxx/ddx-memory-contract

Usage

import { DDXMemoryCardSchema, MemoryScopeSchema, RECONCILE_PASSES } from "@dudoxx/ddx-memory-contract";

All schemas are Zod v4 and double as runtime validators and type sources:

import { z } from "zod";
const card = DDXMemoryCardSchema.parse(raw);
type Card = z.infer<typeof DDXMemoryCardSchema>;

Contents

| Module | Exports | |---|---| | card | DDXMemoryCardSchema, CardEntitySchema, DDXMemoryCardInputSchema | | deck | DDXMemoryDeckSchema, DeckBindingSchema, DeckFrontmatterSchema | | scope | MemoryScopeSchema, SCOPE_PRECEDENCE | | tier | MemoryTierSchema, TIER_ORDER | | kind | CardKindSchema, KNOWN_CARD_KINDS, CardStatusSchema | | link | LinkRelationSchema, CardLinkSchema | | isolation | IsolationFilterSchema | | store | RecallOptionsSchema, RecallResultSchema, WriteResultSchema, IMemoryCardStore | | reconcile | ReconcilePassSchema, RECONCILE_PASSES, ReconcileBudgetSchema, ReconcileReportSchema | | ingest | IngestSourceKindSchema, INGEST_SOURCE_KINDS, IngestRequestSchema | | mcp | MemoryRecallArgsSchema, MemoryWriteArgsSchema, MemoryDeckArgsSchema, MemoryCurateArgsSchema |

Versioning

Semver. The contract is the stable WS1 layer: 1.x is additive; a breaking type change is a 2.0.0 — consumers on ^1.0.0 are untouched until they choose to move.

License

MIT — © 2026 Dudoxx UG (haftungsbeschränkt) / Acceleate Consulting.