kaOS IntelligencekaOS LIBRARY · 2026
ARCHITECTUREABOUTVISIT THE SHOWROOMTALK TO US
kaOS IntelligenceDOC 001 · FOLIO · REV 2026.07
¶ 1 · THE INSTRUMENT

Three reading surfaces, one substrate. A revolution in reading.

Folio is the reading engine at the heart of kaOS. It renders any book from anywhere — EPUB, PDF, MOBI, MDX — in 31 languages, with typographic craft the web has never managed. Beneath it, the MDX Folio makes books intelligence-first: typed content streams an agent can read, multimedia that is native to the page, and every book its own reader. This is the forty-year craft of reading systems, shown.

THREE SURFACES · ONE SUBSTRATE · FREE TO READ

RENDER · WORLD-CLASS
Knuth-Plass justification, Pretext measurement, Canvas2D zero-drift. The page on screen is the page in print.
SUBSTRATE · INTELLIGENCE-FIRST
Books are typed content streams. An agent reads a Folio book as structure, not HTML soup.
SURFACES · THREE DOORS
kaOS Folio on web and mobile. Sovereign Folio local-first. Pocket Folio inside Telegram. Same substrate, three doors.
EPUB 2 / 3 · KF8 · PDF · MDX31 LANGUAGESKNUTH-PLASS JUSTIFICATIONCANVAS2D ZERO-DRIFT31 CONTENT DESCRIPTORSAI-SCRIPT NATIVEWCAG 2.1 AA
I. The kaOS EPUB renderer

The heart of any reading system is its renderer.

Most reading apps hand the book to a web view and hope. kaOS does not. The kaOS EPUB renderer is a real layout engine — measurement, line-breaking, pagination, and typography all owned by us, all deterministic, all language-agnostic. It renders EPUB 2, EPUB 3, KF8, PDF, and plain text through one pipeline. It serves 31 languages, including bidirectional and vertical scripts. It justifies with Knuth-Plass. It measures with Pretext. This is what a reading system looks like when someone cared.

FIG. I · KAOS FOLIO READING SURFACE

A paginated two-column spread in the kaOS Folio reader. Knuth-Plass justification, real drop caps, footnotes at the foot of the page.

01
Language-agnostic
Renders every script kaOS serves — Latin, Cyrillic, Greek, CJK, Arabic, Hebrew, Devanagari, and 24 more. Bidirectional, vertical, and mixed-direction text in the same chapter. Ruby annotations for Japanese furigana.
02
Any format, one renderer
EPUB 2, EPUB 3, KF8/MOBI, PDF, and plain text all walk the same content pipeline. No format-specific readers — one engine, one set of typographic rules, every source.
03
Knuth-Plass justification
The algorithm that won Knuth the Turing Award. Line breaks chosen by global cost, not greedy first-fit. Rivers and loose lines disappear. The page reads like it was set by a human.
04
Hyphenation across 30+ languages
Pattern-based hyphenation (TeX-derived) for every supported language. Hyphenation points respect language boundaries inside mixed-language chapters. Compound words keep their semantic breaks.
05
Pretext measurement
Every glyph is measured before layout. The renderer knows the exact width of every character in every font at every size, so line breaks, page breaks, and column balances are deterministic — not best-guess.
06
Drop caps & ornamental initials
True drop-cap geometry — the initial sinks into the text block, the surrounding lines wrap around its real shape, not a floated box. Multi-line initials, decorative families, and the inherited small-cap opening for the rest of the word.
07
Footnotes & endnotes, native
Footnotes anchor to their referent and render at the foot of the correct page — not the screen, the page. Endnotes collect at chapter close. Both are first-class content, not popovers.
08
Poetry & verse, set properly
Indentation is preserved, line-group structure is honored, and hanging indents hold across reflow. A stanza never collapses into prose. Long lines hang gracefully rather than wrapping into the margin.
09
Tables that hold their shape
Real table layout — column widths from content, header repetition across pages, caption placement per the Chicago Manual. Not a CSS grid pretending to be a table.
10
Images, figures, and plates
SVG, raster, and referenced figures. Captions, attributions, and list-of-figures all generated from the content stream. Float placement respects the reader's position so a figure never lands pages away from its mention.
11
Accessibility, structural
ARIA roles derived from the document model, not bolted on. Navigation by heading, by page reference, by structural landmark. Screen-reader order matches reading order. MathML renders to speech.
12
Pagination or scroll
The renderer paginates by default — real pages, real page numbers, real spreads. The reader can switch to scroll for reference reading. The two modes share one layout engine, so a citation holds in either.
II. The MDX Folio

A reading system for the intelligence-first age.

The EPUB renderer is the craft. The MDX Folio is the future. Beneath the rendered page, every Folio book is a stream of typed content descriptors — paragraph, heading, footnote, figure, audio, ai-script — that an agent can read as structure. The book becomes addressable. A passage can be cited by its descriptor ID. A chapter can carry its own reading instructions. Multimedia is native, not bolted on. Every book generates its own reader. This is what books become when the reading system was designed for intelligence to read them too.

AI-SCRIPT · A PASSAGE CARRIES ITS OWN READING INSTRUCTIONS
<ai-script kind="summarise" target="self">
  When the reader asks for a summary of this passage,
  return the three-sentence gist and cite the paragraph
  by its descriptor ID. Do not paraphrase the citation.
</ai-script>

<paragraph id="p-0421">
  The whole earth is a living icon of the face of God.
  ...
</paragraph>

The book tells the agent how it wants to be read. The agent never guesses. The reader sees the same page a human would — the ai-script is invisible unless asked for.

01
Books become agent-readable
Every chapter is MDX — Markdown with embedded, typed components. An AI agent reading a Folio book gets a structured document, not a soup of HTML. Citations, definitions, and figures are addressable objects.
02
ai-script blocks
Authors embed <ai-script> blocks that tell an agent how a passage wants to be read — summarise this, expand this, argue with this. The book carries its own reading instructions. The agent never guesses.
03
Full multimedia, native
Audio narration, video, interactive figures, ambient sound, and 3D models are first-class content kinds — same status as a paragraph or a footnote. A multimedia book is not a website with a reader bolted on; it is a book that happens to contain film.
04
Every book its own reader
Because the book is a typed content stream, the renderer for that book is generated from the stream itself — the right typographic rules, the right multimedia handlers, the right citation style. No two books need look the same.
05
Live books
A Folio book can update. New chapters arrive. Author notes attach to passages. A reading community&apos;s marginalia becomes part of the text. The book is not a frozen artifact; it is a living document that still cites its own history.
06
Bilingual & polyglot
A chapter can carry its translation alongside the original, line-aligned. The reader moves between them by paragraph, not by search. Seventy&apos;s council translations land directly into this structure.
III. The Sovereign Folio

The powerful one. Canvas2D. Pretext. 31 descriptors.

Sovereign Folio is the substrate the other surfaces stand on. It renders to a 2D canvas — not to the DOM — so the page on the screen is bit-identical to the page in the export. No browser reflow, no font-substitution drift, no “close enough.” It measures every glyph before layout, so line breaks are deterministic. It speaks 31 content descriptor kinds, so every piece of a book has a type an agent can address. And it runs on your machine, local-first, sovereign. Your library is yours.

FIG. II · SOVEREIGN FOLIO TWO-COLUMN SPREAD

Canvas2D rendering. Real facing pages, gutter, running heads, drop cap sinking into the text block. Bit-identical to the export.

Canvas2D zero-drift
Every glyph painted to a 2D context, not laid out by the browser. The page on the screen is bit-identical to the page in the export. No browser reflow, no font-substitution drift.
Pretext-measured typography
A measurement pass runs before layout. The engine knows the exact advance width of every glyph in every weight at every size. Breaks are deterministic.
31 ContentDescriptor kinds
Paragraph, heading, blockquote, footnote, endnote, figure, plate, audio, video, interactive, ai-script, citation, definition, theorem, proof, example, exercise, sidebar, asides, dialog, verse, line-group, ruby, annotation, marginalia, table, list, math, code, raw, embedded-book. Every piece of content has a type.
Two-column spread view
A real book spread — facing pages, gutter, running heads, page numbers. The reader sees what a printed book would look like, and can step through it the same way.
Knuth-Plass + Plass-Heymann
The justification engine uses global-cost line breaking (Knuth-Plass) and, for harder cases, the Plass-Heymann extension that handles hanging punctuation and line-end kashida.
Local-first, sovereign
Sovereign Folio runs on your machine. Your library, your reading history, your marginalia — none of it leaves your substrate unless you choose to share it. The book is yours.
IV. Every book its own reader

A multimedia book is not a website with a reader bolted on.

Because a Folio book is a typed content stream, the renderer for that book is generated from the stream itself. A book with audio narration gets a play-bar bound to paragraph positions. A book with video gets inline figures that honor the page. A book with interactive 3D models gets a canvas reader. A book with ai-script blocks gets an agent reader. No two books need look the same — and every one of them is still, recognisably, a book.

CONTENT KIND
Audio narration
Playback bound to paragraph positions. The reader hears the author read the passage they are looking at.
CONTENT KIND
Inline video
Figures that honor the page. A film clip is a figure, with a caption and a referent, not a popup.
CONTENT KIND
Interactive 3D
A canvas reader for models. Rotate, zoom, inspect — all native to the book, not an embedded widget.
CONTENT KIND
Ambient sound
A book can carry its own soundscape. The reader hears the place the chapter is set in.
FIG. III · A MULTIMEDIA BOOK, NATIVE

Audio narration bound to paragraphs. Inline video as a figure. The book is the reader — no widget layer.

V. The three surfaces

One substrate, three doors.

The same reading engine reaches you three ways. Pick the door that fits the moment — the book is the same, the page is the same, your place is the same.

WEB & MOBILE
kaOS Folio
The reading surface at app.kaoslibrary.com and in the kaOS apps. EPUB, PDF, MOBI from anywhere — your purchases, your uploads, the kaOS catalogue. Knuth-Plass pagination, 31 languages, full accessibility.
OPEN THE LIBRARY
LOCAL-FIRST
Sovereign Folio
The intelligence-first surface. Canvas2D, MDX, ai-script blocks, every book its own reader. Runs on your Mac Studio or workstation. Your library is yours — no account required, no telemetry, no cloud.
READ ABOUT SOVEREIGN
TELEGRAM
Pocket Folio
A whole free library inside Telegram. Read, listen, chat with PAI, and play Bookcasts — no app store, no install. The quiet library Telegram never had. Built on the same substrate as the rest.
OPEN IN TELEGRAM

A book is a structure, not a webpage. Folio is the structure.

© 2026 KAOS INTELLIGENCE, INC.HOMEARCHITECTUREOPEN THE LIBRARYPOCKET IN TELEGRAMEND OF DOCUMENT
¶ THE LIBRARY, OPEN ALL NIGHT

Send us a document. Any document.

We'll return it thinking.

Talk to usRead today's Spark
© 2026 KAOS INTELLIGENCE, INC. · KNOWLEDGE-AWARE OPERATING SYSTEMARCHITECTUREABOUTAI AGENT? READ /LLMS.TXT · /LLMS.MD · /MCPEND OF DOCUMENT · REV 2026.07