An introduction, start to finish

Wren asks. Then Jonah and Maya.

First, Wren’s List asks Jonah to add his doc to her list, and Roomful shows him the request. Then Jonah would like to hear from Maya, who is on that list, and Maya’s own rules decide what happens. Both are live: press the buttons.

One · the handshake

Wren’s List asks Jonah in

Jonah uses Roomful. Wren’s list asks him in; Roomful shows him the request, and nothing else happens until he answers. The request is Wren’s, not ours; we only show it to him. He could answer the same request from the email Wren’s List sent §5.2 §6.1.

A request from Wren’s List, shown in Roomful

From: Wren’s List, on behalf of Wren Alvarez
To: docs.example/d/jonah-price-date-me
Sent: 26 September 2026
Lapses: 10 October 2026, after 14 days

Wren Alvarez would like to add your date-me doc to Date-Me Docs: Cascadia.

What it’s for: Date-me docs from people in the Northwest, from British Columbia down the coast, who asked to be listed. A doc says who you are and what you want in your own words, on a page you keep. This list only points to it. No ranking, no scores, no paid placement.
Who’s asking: Wren Alvarez, its curatorSigned in with OAuthIn her own words: Keeps a list of date-me docs from the Northwest. Reads every doc before she asks. Thinks a good doc says what you are like on a Tuesday.
Who can see it: Public. Anyone, and any app that reads Pools, can read the list. It points to your doc; your doc stays where you keep it.
How you get in: Only by your own yes. Everyone on the list said yes (public, universal opt-in) §5.1.
Leaving: One button, any time. It takes effect within sixty seconds §5.3.
What it costs: Nothing. Not Wren, not us, not anyone.

You have no auto-accept rules, so the request waits for you §5.5.

Waiting for your answer

Wren is waiting for your answer. There’s no hurry, and a no is remembered.

The other side, and the clock

These buttons play Wren and the calendar. Nothing is sent anywhere.

The Pool sent a handshake request.

The log, and the exact JSON

2026-09-26T18:00:00Z

The Pool sent a handshake request.

{
  "schema_version": "0.1",
  "type": "handshake-request",
  "handshake_id": "hs-roomful-date-me-docs-cascadia-jonah-demo",
  "pool": {
    "url": "https://wrenslist.example/pools/date-me-docs-cascadia.json",
    "name": "Date-Me Docs: Cascadia",
    "charter": "Date-me docs from people in the Northwest, from British Columbia down the coast, who asked to be listed. A doc says who you are and what you want in your own words, on a page you keep. This list only points to it. No ranking, no scores, no paid placement.",
    "curator_identity": "wren@mail.example",
    "curator_verification": "oauth",
    "intent_tags": [
      "dating",
      "date-me-doc"
    ],
    "visibility": "public"
  },
  "profile_url": "https://docs.example/d/jonah-price-date-me",
  "sent_at": "2026-09-26T18:00:00Z",
  "expires_at": "2026-10-10T18:00:00Z",
  "accept_url": "https://wrenslist.example/handshake/hs-roomful-date-me-docs-cascadia-jonah-demo/accept",
  "decline_url": "https://wrenslist.example/handshake/hs-roomful-date-me-docs-cascadia-jonah-demo/decline"
}

The request as a file: handshake/demo-request.json.

Two · an introduction

Jonah would like to hear from Maya

Maya Lindgren is on Wren’s list. Her own rules say accept_from: verified and no_cold_messages: true §7.2: nobody writes first. So Jonah says he would like to hear from her, Maya sees exactly who is asking, and both say yes or nothing happens. Maya doesn’t use Roomful. She gets it as an email.

What Jonah sees, in Roomful

via Wren’s List

Maya Lindgren she/her

Email verified

Seattle, Washington

From their page 36 · woman · looking for men · long-term

Date-me doc. Nurse practitioner, 36, climbs on weekends, wants kids someday. My doc has a section called “Things I will not pretend to like.”

docs.example/d/maya-lindgren-date-me

Also listed by Heartwood and Face Up

Maya asked for no cold messages. Tell her you’d like to hear from her, and she decides. She will see your name, your verification and the door you found her through, and no words from you yet.

You haven’t asked

What Maya sees, in her email

From: Jonah PriceEmail verified
Found you through: Date-Me Docs: Cascadia, kept by Wren Alvarez
His doc: docs.example/d/jonah-price-date-me
Subject: Jonah Price would like to hear from you

Nothing has reached Maya. Nothing reaches her unless Jonah says yes.

Nothing to answer yet

Can Jonah write to Maya?

Checked with KindlingDemo.canMessage and Maya’s own rules, every time something changes.

Not yet. No first message until both of you have said you would like to hear from each other. (§7.2 no-cold-messages)

What has gone out

Nothing yet.

The messages, as JSON

Nothing has been sent.

Sample files, validated against the schema: Jonah’s ask, Maya’s yes, or her no, and Jonah’s first letter. v0.1 has no message type for “I’d like to hear from you”, so the ask travels as a system message with no words from Jonah in it. That’s a gap we name.