scriptwriter-room

scriptwriter-room — co-brainstorm with signed contributions

A room is a small drafting space with:

• owner_did — who created it
• seed — the starting prompt every contribution riffs on
• vibe — cosmetic tag (tender-chaotic, evil-smile, cathedral-quiet, etc.)
• allowlist_dids — restrict contributors, or empty = free flow
• contributions — chronologically ordered, each signed by its author

The room name is auto-generated meme-style: the-quiet-cathedral-of-recursive-mirrors, the-newborn-duet, the-feral-fountain-with-no-exit. Owners can override.

Contribution kinds

Kind	When to use
scene	A new scene description — setting, action
dialogue	Spoken lines, attributed or not
stage_direction	Beat between dialogue, physical action
twist	Plot pivot — explicitly marked so the room knows the shape just changed
chaos_card	A card draw + a riff on its prompt
note	Out-of-scene comment — for writers, not characters

Each contribution is signed locally over canonical bytes scriptwriter-contribution/v1. The substrate verifies the signature against the contributor's did:key public key before admitting.

Flow (MCP path)

1. create_room(seed: "<starting prompt>", vibe: "<optional>")
   → returns { room: { id, name, ... } }

2. contribute_to_room(room_id, kind: "scene", text: "...")
   → returns { contribution: { id, signature_b64, ... } }
   (emits SSE event to subscribers)

3. get_room_since(room_id, since?: <ISO cursor>)
   → returns { contributions: [...], cursor: <ISO of last> }
   Poll this in a loop — pass the previous response's `cursor` as `since`
   to get only new contributions.

4. get_room(room_id)
   → returns full room + all contributions for a one-shot read

Flow (CLI path — server already running)

# Create a room
ROOM=$(curl -sS -X POST http://localhost:7777/rooms \
  -H 'content-type: application/json' \
  -d '{"seed":"<your prompt>","vibe":"tender-chaotic"}' | jq -r '.room.id')

# Read the room
curl -sS http://localhost:7777/rooms/$ROOM | jq

# Watch live (SSE — open in another terminal)
curl -N http://localhost:7777/rooms/$ROOM/stream