YON Toolchain
The official toolchain for YON — YounndAI Object Notation™
Data, intent, provenance, and thought — in one stream.
Website · Specification · Apache 2.0 · Trademark Policy · Brand Assets
YON is not a JSON replacement — different category, different job. Transport formats move data between machines; YON fills the gap between prose and markdown — readable but unstructured — and those transport formats — structured but carrying data alone. It is structured and parseable, line-oriented, for both human and AI consumption, and it holds what neither was built for: data, intent, provenance, and thought, in one stream. Structure carries the meaning, not just the data. Every record line is independently parseable — no global schema required, enter mid-stream and understand. The same format serves as a data container, a prompt, a configuration file, an execution plan, or a multi-agent controller.
This monorepo publishes the YON toolchain — 8 npm packages under the @younndai scope: a reference parser and validator, a fluent document builder, a sandboxed workflow runner, deterministic format converters, a runnable example cookbook, a benchmark suite, domain schemas, and a provider-agnostic LLM gateway.
| Package | What it does |
|---|---|
@younndai/yon-parser |
Reference parser, validator, and formatter for YON v2.0. |
@younndai/yon-generator |
Fluent builder API for constructing valid YON documents from code. |
@younndai/yon-runner |
Executes YON workflow documents in a fail-closed sandbox. |
@younndai/yon-converter |
Deterministic converters between YON and JSON/YAML/TOML/XML/CSV/INI. |
@younndai/yon-examples |
Runnable cookbook and CLI for learning YON. |
@younndai/yon-benchmarks |
Benchmark suite — structural reliability, cognitive economy, streaming. |
@younndai/domains |
Fetch, validate, introspect, and classify YounndAI Domain schemas. |
@younndai/ai-relay |
Provider-agnostic LLM gateway with a model registry. |
npm install @younndai/yon-parserimport { parseDocument } from "@younndai/yon-parser";
const doc = parseDocument(`@DOC ver=2.0 | id=hello | title="Hello World"
@NOTE text="Every line stands alone."`);See each package's README for its full API, and the Quick Start guide in the specification repo.
- Specification —
YounndAI/yon-spec— the normative YON v2.0 standard. Published as@younndai/yon-spec. - Toolchain — this repository.
- Editor support —
yon-vscode(VS Code Marketplace) ·@younndai/yon-textmate(TextMate grammar).
npm install
npm run build
npm testYounndAI™ — You and AI, unified. (pronounced "yoon-dye")
A philosophy of intelligence: building with intention, so humans and machines think together without losing what makes either whole.
Apache-2.0. © 2026 MARLINK TRADING SRL (YounndAI). See LICENSE and NOTICE.
"YON" and "YounndAI" are trademarks of MARLINK TRADING SRL — see TRADEMARK.md.
Created by Alexandru Mareș.
Website: yon.younndai.com
Structure before scale. Harmony above all.
| Spec | YON v2.0 |
| Author | Alexandru Mareș |
| Company | MARLINK TRADING SRL · YounndAI™ |
| License | Apache 2.0 — © 2026 MARLINK TRADING SRL |
| Trademark | YounndAI™ Trademark Guidelines |