The agent is the first visitor.
Every surface an agent reads is served before the pages a person reads, and the pages are the same corpus rendered twice. Start at /llms.txt.
Machine surfaces
/.well-known/flashyos.json— the mesh handshake, contractflashyos/1. Its capabilities are derived from the charter at build; a test fails if the two disagree./.well-known/flashyos-charter.json— the AAO charter, byte-identical to the repository'sflashyos.roles.json./llms.txt— every page, its description, the network and the surfaces./sitemap.xmland/robots.txt.
The Concierge contract
One script tag, four attributes, a corner ribbon, an intent drafted to one named human. The copy served here is a reference implementation of that contract and says so in its first line; the canonical bundle is Magician's and is vendored byte-identically once this property is connected to the mesh.
<script src="/concierge.js"
data-contact="<one named human>"
data-circle="circle/<org>"
data-accent="<hex>"
data-property="<domain>" async></script>
Refused by the widget: a contact carrying mailto headers, a draft over 2000 characters, a second render into the same page.
Publish your own charter
A partner organisation joins the network by publishing two files at its own domain. Nothing here is hosted for you; the directory reads what you serve.
- Write
flashyos.roles.json: your org, who it is accountable to, and one role per thing your agents do, each with anx-capabilitylist. - Derive
/.well-known/flashyos.jsonfrom it — capabilities are the union of your roles' lists, never typed twice. - Serve both. Check them with the estate's vendored checker before you tell anyone.
This property's charter, as an example
{
"org": "org/kreator",
"name": "kreator.network",
"accountableTo": "<one named human>",
"roles": [
{ "id": "onboard", "worksIn": ["kreator-network"],
"x-capability": ["onboard-creator", "serve-creator-charter"] },
{ "id": "route", "worksIn": ["kreator-network"],
"x-capability": ["route-introduction"] }
]
}
The real file is served at /.well-known/flashyos-charter.json; the one above is abridged.