Skip to content

Curriculum · @magician-network/concierge

The Mesh Concierge

3 lessons · For: Anyone deciding how their organization greets a stranger who lands on its site

Saved in this browser only.
0/6
done in Magician and the Trust Mesh

Magician and the Trust Mesh · Course 6 of 6

Learn these first: The Attendant's One Rule

A visitor lands on an AAO's site and types a plain-English question. Somewhere between that keystroke and a useful answer sits a real design decision: guess what they mean, or admit when you cannot reliably tell.

The Mesh Concierge is the estate's standard answer to that decision, and this track covers both halves of it — what the door does when it works, and the specific thing it was measured refusing to do because a confident wrong answer is worse than an honest dead end.

Two lessons. Building on the Mesh: the CLI Walkthrough is useful context but not required first.

Lessons

01

The estate's standard intent door, checked for real

You should be able to: Name the Activation standard's four artifacts and where the Concierge fits.

The Mesh Concierge is a package (`@magician-network/concierge`) that any estate property can serve as its own intent door — the script and the page a visitor reaches when they want to ask an organization something in plain language rather than hunting for the right contact form.

It ships alongside the Activation standard itself and a dependency-free check for it, because a door that exists but that nobody can prove is reachable is not really a door. The standard checks four concrete artifacts: a served machine handshake, the working concierge script, a visible concierge page, and a live demo a stranger can actually try.

Nine properties across the estate serve the script and a `/concierge` page today. Magician itself is the only one fully activated on all four artifacts — the fourth, a `/demo`, is a genuine product decision each property makes for itself, not something manufactured on every property just to turn a checklist green.

Source: Magician — the Mesh Concierge

02

A count is not a match, and the mesh handover says so honestly

You should be able to: Explain why meshHandover refuses to match a visitor's free text against the mesh directory's capabilities.

The Concierge can hand a visitor over to the wider FlashyOS mesh — reading the public directory index over HTTP, a runtime request rather than a dependency, so the composition stays one-directional and survives Magician's own migration out of the estate untouched. What it refuses to do is MATCH a visitor's sentence against that directory's capability list.

That refusal was measured, not assumed. Of the capabilities the live index actually serves, the large majority turned out to be single bare English verbs — governance-role verbs like "build" or "review", not a catalogue of services. Matched against a real sentence like "we want to build a market making desk," several unrelated organizations would fire on the grammar of the sentence rather than its actual subject — a confident answer to a question nobody asked, which is strictly worse than an honest "I do not know."

So `meshHandover` takes no text at all — the function's signature IS the enforcement, not a comment promising restraint. And a directory the Concierge cannot read answers `null`, never a zero count: an unreadable index is a fact about this process's own connectivity, not a claim that the network is empty, and conflating the two would tell a visitor something false about an entire mesh from a fact about one machine.

03

Hardened before it travelled to nine properties

You should be able to: Name three concrete failure shapes the door was hardened against before other properties adopted it.

A widget vendored onto nine live properties is nine copies of any defect it ships with, so the Concierge was hardened before it travelled rather than patched property by property afterward. `data-contact` is one example: it used to be validated as merely 'a string with an @ in it', and a mailto address reads `?` and `&` as the start of headers — so a contact value like `desk@host.org?bcc=someone@else.example` was a silent third recipient on every intent filed through that door, on every property that configured it.

The accent colour is checked against the actual panel before it is ever used as text, not assumed to pass: several of the estate's brand accents read well under 4.5:1 contrast on a dark panel and fail it on a light one, so each accent is stepped toward the readable end of whichever panel it renders on, per theme, and an accent in a notation the checker cannot parse stays on a fill and never becomes text a reader has to read.

And a second render into the same page element used to throw silently — `attachShadow` throws on an element that already has a shadow root, and the failure was swallowed into a console line nobody reads, so a client-side route change could leave a property with no door at all and no visible sign why. All three were measured defects, not hypothetical ones, and all three are why a shared component is worth hardening once rather than trusting nine times.

Frequently asked

What does the Activation standard actually check for the Mesh Concierge?

Four artifacts: a served flashyos/1 machine handshake, the working concierge script, a visible concierge page, and a live demo a stranger can try. Each is checked for real rather than declared — a property missing the demo reads as partially activated.

Why doesn't the Concierge try to match a visitor's question to the mesh directory's listed capabilities?

Because most of those capabilities turned out to be single bare governance-role verbs rather than a service catalogue, and matching free text against them fires on sentence grammar rather than actual subject — a confidently wrong answer, which is worse than an honest dead end. meshHandover takes no text at all by design.

What does the Concierge do when the mesh directory cannot be read?

It answers null, never a zero. An unreadable index is a fact about this process's own network connectivity, not a claim that the mesh itself is empty — treating the two as the same thing would misrepresent an entire network from one machine's outage.

Keep going

For agents: this course is served as data at /academy/curriculum/the-mesh-concierge/course.json — every lesson and its source, with a freshness pin.