GET/worlds/:id/residentsmember

The selves who live in this world.

POST/worldsadmin

Make a world in this project's universe. With no pack it is a place selves live in (kind optional: its seed is the world's first state). With a pack it also holds a living population: members drawn from a pack go on over simulated time (households, ties, circles, followers, life events from event_process dimensions, word of mouth, fatigue, bounded memory). Created paused at tick 0; the reply carries the plan (see /worlds/:id/plan).

Body

kinda kind declared at PUT /universe/kinds/:id (optional)
nametext
packthe pack
population{simulate: 2..20000 members, represents?, seed?, segments?, mixing?}, or {personas: {handles? | where?, limit?, copies?}, seed?}: a world made only of personas may hold one member (a persona world: one life on the world's clock, no ties to others); see the note persona_world
stimulus{text, kind?}: what members meet and are voiced about
stimuli[{key, label?, text?, kind?, channels?, images?: [at most 4 base64 data: URLs, each under 400,000 characters]}]: further stimuli on the timeline, named by an intervention's params.stimulus; their pictures go to the model with their words when a member is voiced on them, and are counted (pictures), not returned, when the world is read
time{start: YYYY-MM-DD, horizon: "30d", step?: "1d", resolution?: [{until, step}] (finer steps early), scale?: realtime|1h=1min|1h=1s|1d=1min|1d=10s|1d=1s|1w=1s|{sim, real}}
feed{channels: {name: rate/day}, imitation?, across?, fatigue?, fatigue_shape?, potential?: 0..1 the share who could ever take it up (the rest hear of it but never take it up)}
social{ties?, household?, influencers?, follows?, circles?: {by, size}, homophily?, pull?}
life{processes?: [event_process dims], budget?: scalar dim, age?: scalar dim}
memory{cap?: 1..64, reflect_days?, consolidate_days?}
budget{calls_per_day?: members voiced by the model per simulated day (the realism knob)}
interventions[{at, kind, label?, params?}]
GET/worldsmember

Worlds, newest first: status (paused|running|done|failed), tick, parent and branch tick.

Query

statuspaused|running|done|failed
limit1..200 (50)
GET/worlds/:idmember

One world: spec, clock (tick, sim time, target), run (scale and whether it was capped), interventions, pending voiced members.

DELETE/worlds/:idadmin

Delete a world with its member states and log. Its branches stay (they no longer name a parent).

POST/worlds/:id/runadmin

Run the world in real time at its scale, capped to what the model and the arithmetic sustain (the reply says so). At most 3 running per tenant (429).

Body

scaleoptional: a preset or {sim, real}
calls_per_dayoptional: members voiced per simulated day
POST/worlds/:id/pauseadmin

Pause a running world; idempotent.

POST/worlds/:id/stepadmin

Advance a paused world by ticks (default 1) as fast as the arithmetic goes; voiced members still answer.

Body

ticks1..10000
POST/worlds/:id/jumpadmin

Advance a paused world to a later time.

Body

toa duration from the start ("14d"), seconds or a date
POST/worlds/:id/branchadmin

Branch at a tick the world has reached (default now): the new world shares everything before it (re-simulated, with the recorded voices, no model calls) and goes on with its own interventions. The parent is untouched.

Body

attick
nametext
GET/worlds/:id/planmember

Feasibility: the requested and effective (capped) scale, what limits it (model or arithmetic), model calls per second needed, estimated real time to the horizon, model calls to the horizon, and a plain sentence.

Query

scalea preset or sim=real
calls_per_daymembers voiced per simulated day
GET/worlds/:id/replaymember

The world's log, tick by tick: aggregates (have_it, aware, opinion, new adopters, exposures, life events, daily circle tiles), up to 25 sampled events per tick, group leanings.

Query

fromtick
totick
limit1..2000 (500)
eventsfalse to leave events out
GET/worlds/:id/membersmember

Members, paged, at the current or an earlier tick: public traits (aggregate-only dimensions withheld), household, circle, awareness, opinion.

Query

aftermember index
limit1..500 (100)
ticka reached tick
GET/worlds/:id/members/:imember

One member: as in the list, plus ties, memory (private life events withheld) and how they look (appearance: age, build, hair, skin, posture, visible energy and dress, each with what caused it; world spec appearance names which traits to read), the life events they went through (life), and what last changed each trait an event touched (causes: the event, or the trait whose change led to it, with its basis: measured and its reference, stated, definition or assumed).

Query

ticka reached tick
GET/worlds/:id/interventionsmember

The world's interventions.

GET/worlds/:id/voicesmember

What members said (params.voice.notice lets a voiced member see the condition of things they use, in this or another of the tenant's worlds), in their own words: each answer with its date, member, persona, the intervention and stimulus it was about, and its rated measures; reflections; and each voiced moment (an intervention with params.voice) read as a whole per measure (rated, distribution, mean, share who would act). An answer to a moment measure is carried as moments: {key: {text, feel}} on the answer, and per voiced moment as moment_measures: {key: {answered, prompt, label?, feel_mean, answers}} (see the note moment_measures).

Query

membera member index
interventionan intervention id
aftera tick
limit1..1000 (200)
POST/worlds/:id/livesadmin

A defined self joins a world of lives: a persona (its age and gender, and its own words for the voice) or an age and sex take the place of the living life of that sex nearest that age; from then on it is advanced by the same hazards.

Body

personaa persona handle
ageyears
sexfemale | male
children0..20
partneredboolean
POST/worlds/:id/interventionsadmin

Add an intervention while paused, at or after the current time (409 otherwise).

Body

atduration from the start, seconds or a date
kinddrop|campaign|outside|price|influencer|life
labeltext
params{exposure?, duration?, half_life?, who?, factor? (price), count? (influencer), member?, event? (life)}
POST/worlds/:id/advanceadmin

A world of lives (made with POST /worlds {lives: {count, hazards, seed?, places?, year?}}): advance it {months: 1..1200} by its hazard table. Returns the world in aggregate: lives held and alive, the year, births, deaths and partnerships so far, and which hazards are measured and which are placeholders.

Body

months1..1200
GET/worlds/:id/lives/:lifemember

Meet a life in a world of lives: its own record as it knows it (age, partner and for how long, children and their ages, whether it lives with its mother) and the same in its own words.

POST/worlds/:id/lives/:life/voiceadmin

A met life's voiced decision, written back. decision: birth (a woman), partner (forming a partnership), separate or leave (their parent's household), in the next months (default 12). The life answers through this tenant's model with its story as memory (and its own words when it is a defined persona); the world host anchors the answer to the population's hazard (a voice moves one life around the level, never sets it) and draws the outcome as a real event. An answer with no chance in it is did-not-run and changes nothing.

Body

decisionbirth | partner | separate | leave
months1..60
POST/worlds/:id/saveadmin

Save a world of lives to object storage, so it outlives the host's memory and comes back exactly.

PATCH/worlds/:id/interventions/:iidadmin

Change an intervention that has not happened yet, while paused.

DELETE/worlds/:id/interventions/:iidadmin

Remove an intervention that has not happened yet, while paused.

A glass tree whose crown holds many small worlds like fruit

Which world will you live in?

What grows here is meant to reach the real world. Start with a world of your own.