OlonJS v1.3.0
Open source · MIT License

The Contract Layer
for the Agentic Web

AI agents are becoming operational actors in commerce, marketing, and support. OlonJS introduces a deterministic machine contract for websites — so agents can reliably read and operate any site, without custom glue.

GET /homepage.json
{ "slug": "homepage", "meta": { "title": "Acme Corp" }, "sections": [ { "type": "hero", "data": { "title": "Ship faster with agents", "cta": "Get started" } }, { "type": "features", /* ... */ } ] }
The problem

Websites aren't built for agents

  • Agentic workflows are growing, but integration is mostly custom glue — rebuilt tenant by tenant
  • Every site has a different content structure, routing assumptions, and edge cases
  • HTML-heavy, CMS-fragmented, inconsistent across properties — slow, brittle, expensive
Our solution

A standard machine contract across tenants

  • Predictable page endpoints for agents — /{slug}.json including nested paths
  • Typed, schema-driven content contracts — validated, versioned, auditable
  • Repeatable governance and deployment patterns across every tenant

Built for enterprise scale

Every layer is designed for determinism — from file system layout to component contracts to Studio UX.

📐

Modular Type Registry

Core defines empty registries; tenants inject types via module augmentation. Full TypeScript safety, zero Core changes.

🧱

Tenant Block Protocol

Self-contained capsules (View + schema + types) enable automated ingestion and consistent editor generation.

⚙️

Deterministic CLI

@olonjs/cli projects new tenants from a canonical script — reproducible across every environment.

🎯

ICE Data Contract

Mandatory DOM attributes bind the Studio canvas to Inspector fields without coupling to tenant DOM structure.

📦

Base Schema Fragments

Shared BaseSectionData and BaseArrayItem enforce anchor IDs and stable React keys across all capsules.

🔗

Path-Based Selection

v1.3 strict path semantics eliminate nested array ambiguity. Studio selection is root-to-leaf, always deterministic.

Why this
matters now

Agentic commerce is live

Operational standards are missing. Without a contract layer, teams face high integration cost and low reliability.

Enterprises need governance

A contract layer you can audit, version, and scale — not a one-off adapter for every new agent workflow.

AI tooling is ready

Deterministic structure means AI can scaffold, validate, and evolve tenants with less prompt ambiguity.

Speed compounds

Teams that standardize now ship new experiences in hours while others rebuild integration logic repeatedly.

AI-native advantage,
from day one

OlonJS dramatically increases AI-assisted development speed. Because structure is deterministic, agents scaffold and evolve tenants faster — with lower regression risk.

  • AI scaffolds and evolves tenants faster because structure is deterministic
  • Shared conventions reduce prompt ambiguity and implementation drift
  • Ship new tenant experiences in hours, not weeks
10×Faster scaffolding
Glue per tenant
100%Type-safe contracts
canonical endpoints GET
/homepage.json200 OK
/products/shoes.json200 OK
/blog/ai-agents.json200 OK
/contact.json200 OK

Ready to give your site
a machine contract?

Read the full specification or explore the source on GitHub. Zero dependencies to start — one JSON endpoint per page.