Skip to content

Appendix C: Versioning

The SDK follows semantic versioning independently from the AECS-1 spec.

  • @mvrx/mail 0.x — implements AECS-1 1.0.0 core (parser, threading, content levels)
  • @mvrx/mail 1.0.0 — released when the full SDK surface in this document is stable

The spec version implemented is declared in package.json:

{ "aecs": "1.0" }
Version Date Notes
0.5.0-draft 2026-10-05 §3.7 storage now follows AECS-1 Appendix C: a small hot aecs_messages row (with forai) separate from aecs_bodies, side tables for participants, references and thread summaries, mailbox-scoped SHA-256 keys, content.html moved to R2, optional FTS5 search, and idempotent writes. The schema and statements are published as tested files in examples/storage/. §3.8 notes which tiers each query reads.
0.4.0-draft 2026-10-05 Added §6.3 Decision Models: the typed DecisionProvider interface, connectors for TypeSafe Jev and Cloudflare Clef (System One wire format), a text-LLM adapter used until the OpenAI Decisions API publishes a schema, and decideEmail(). Implemented in @mvrx/aecs/decisions. No normative AECS-1 text changed.
0.3.1-draft 2026-10-05 Synced to AECS-1 v1.1.0 (content preservation). §4 now describes the default cleaner accurately: authored lines after quotes are kept, quoted context is bounded, dividers are not quote boundaries, signature removal is size-limited, and an empty result falls back to text. Removed the incorrect claim that content is retained “when confidence is low”. processing.specVersion is "1.1"; adds processing.cleanFallback. A custom cleaner now receives the full text instead of quote-stripped text.
0.3.0-draft 2026-07-03 Synced to AECS-1 v1.0.0 (Final, 2026-07-03). Added the Implementation Status note (near the top of this document) and Status: Roadmap banners on every section that specifies a module not yet implemented in @mvrx/mail, roadmap annotations on the §2.2 setup bindings and §13–§14 examples/extensibility, plus a §11 cross-reference to AECS-1 §7’s security guidance. No normative algorithm text changed.
0.2.0-draft 2026-06-29 Prior draft, written before AECS-1 was finalized.