AECS

AECS-1 (AI Email Consumption Specification) is an open standard for deterministically normalizing raw RFC 5322/MIME email into AI-ready JSON — the schema, the threading algorithm, and the six content levels. It is published under CC0 1.0 (public domain): implement it in any language, without asking permission.

@mvrx/aecs is the framework-agnostic, zero-infrastructure-dependency MIT reference implementation of that spec: parsing, content cleaning, threading, and message normalization, with no Cloudflare or storage assumptions baked in.

• AECS-1 specification — the normative document
• AECS-SDK-1 specification — the target SDK surface for implementations
• JSON Schema — machine-checkable NormalizedEmail shape
• Conformance suite — fixtures + an independent checker (verify.py)
• Docs site — browsable version of the above

Install

npm install @mvrx/aecs

Usage

import { parse } from "@mvrx/aecs";

const email = await parse(rawRfc5322Message);

console.log(email.messageId);       // normalized Message-ID
console.log(email.threadId);        // deterministic thread identifier
console.log(email.content.clean);   // quote-stripped, signature-stripped body
console.log(email.content.forAI);   // wrapped, AI-ready representation

parse() accepts a raw message as a string, ArrayBuffer, Uint8Array, or a ReadableStream<Uint8Array>.

License

MIT. See LICENSE.