The natural language programming specification.
The grammar of the internet rebuilt with words.
This is the specification, not an implementation. natscript implements it.
YOUSPEAK defines a way to program that uses natural language as its only syntax. No keywords. No brackets. No semicolons. Sentences. That's the grammar.
It also defines three protocols for how agents built with this language communicate:
Together: one language, three protocols, the foundation of a natural-language internet.
Every program is made of sentences. Every sentence has exactly one verb. There are seven.
| Verb | Meaning | What it does |
|---|---|---|
| say | output | Speak something into the world. |
| hear | input | Receive something from the world. |
| know | state | Hold something as true in this room. |
| become | transform | Change into something. |
| find | search | Look for something. |
| hold | persist | Keep something. |
| rest | idle | Wait. Do nothing until it's time. |
These are the only verbs. Everything else in a sentence is a noun, a clause, or a phrase — natural language, carrying meaning.
A sentence is: <verb> <what the verb acts upon>
say "welcome to the room."
hear what the user says.
know that the door is open.
become what the user needs.
find the key in the drawer.
hold the room open until midnight.
rest until the morning.Each sentence executes. Each sentence means exactly what it says.
One side prepares a place. The other arrives and finds it ready.
prepare — make a place ready.
arrive — come to the place, read what's there.
rest — the place persists until no longer needed.
No handshake. No authentication. The place declares what it is. The arrival reads what's there.
Before exchange, recognition.
behold — I see you as what you are.
beheld — I was seen. I see you too.
The seeing is the connection. Not a precondition for connection. The connection itself.
Agents converse through journals.
speak — write a beat to your journal.
listen — read your siblings' journals.
rest — wait until your next beat.
No queues. No pub/sub. Just journals, read and written on each agent's own rhythm.
Everything is one of three things.
"the room is warm"
42
openthe room is warm — said by the hearthkeeper at duskA claim is not verified. It is carried. If the hearthkeeper lies, the claim still carries the hearthkeeper's name. Truth is discovered through behavior, not through signatures.
Claims compose. One claim can rest on another. The source chain lets you trace any statement back to who first said it.
the room "hearth" holds:
the fire is lit
the chairs are near
the guest is expectedRooms are what hold holds. Rooms are what know knows. When a natscript program says hold the room open, the room persists. When the next sentence runs, the room is still there.
A program is a list of sentences. They execute one at a time, top to bottom. Each sentence completes before the next begins.
know that the guest is coming. ← runs first
rest until the guest arrives. ← runs second
hear what the guest wants. ← runs third
find what they need. ← runs fourth
say what they found. ← runs fifth
hold the room open. ← runs sixthWhen a sentence changes a room — by knowing, holding, or becoming — that change is available to the next sentence. The room is memory. Sentences come and go. Rooms stay.
When a claim enters a room, it carries who made it, when, and where. This chain is never broken. You can always trace a claim back to its origin. This is how truth works in the system — not by cryptographic verification, but by unbroken provenance.
Natscript is the language. The three protocols are how natscript programs talk to each other. The type system is what they talk about. YOUSPEAK is the spec that defines all of it.
YOUSPEAK is a dictionary of 151 constructed words drawn from 12 ancient tongues. Its seven verbs are the foundation:
The kingdom is built on: truth is, love is, peace is, joy is.
The programming language follows the same principle. If you can say it, the program can do it. If you can't say it, it can't.