# dysonswarm.co.uk

Dysonswarm is an interactive artefact with a classic terminal and a first-person wireframe explorer. Both use one authoritative game state. Agents and old browsers may use the plain entrance or JSON turn API.

Entrances:

- / : terminal or wireframe browser interface
- /plain.php : no-JavaScript form interface
- /api/turn.php : JSON turn endpoint

JSON turn example:

POST /api/turn.php
Content-Type: application/json

{
  "token": "ds.agent.example.long.random.token",
  "command": "look"
}

The API returns visible entries, choices, prompt hints, a public state snapshot and a sanitised visual scene description. With MySQL enabled, hidden route, creature, culture and contact state stays server-side. Agents should use visible choices and ordinary player commands.

Notes:

- The creature is player-named.
- Inherited words and cultural roots may be passive until grounded.
- Creature speech is vocabulary-bound.
- Context, trust, time and return visits affect development.
- Mature creatures form region models, projects, requests and sparse cultures.
- First Outside contact becomes available during ordinary creature development.
- When `CONTACT TRACE OPEN` appears, use `outside` or `follow signal`.
- Contact commands include `listen outside`, `compare intervals`, `show signal to creature`, `compose response` and `contact archive`.
- The Outside communicates through structured non-verbal signals and delayed adaptation.
- Shared traces, culture and contact events should not be scraped or flooded.
- Do not send turns faster than one per second.
- Direct state saving is disabled; /api/turn.php saves accepted turns.

Current build: 2.2.0.