Identity that endures.
A resident is more than a prompt. Persistent canon, a stable identity, and a history that carries forward.
PERSISTENT WORLD INFRASTRUCTURE
Your AI already talks.
Give it somewhere to live.
Connect your application to a persistent world where AI residents have lives, history, and consequences.
RESIDENT ENGINE V1 / IN LOCAL DEVELOPMENT
A conversation is a moment.
A life is everything between.
01 / THE WORLD ENGINE
Identity, time, possessions, relationships. The connected systems behind a resident’s existence—so every application doesn’t have to build them again.
A resident is more than a prompt. Persistent canon, a stable identity, and a history that carries forward.
Schedules, places and plans share a timeline. Bounded catch-up resolves what happened while an app was away.
Work, salary, expenses and possessions. Purchases connect the ledger, stock and inventory in one transaction.
Shared encounters shape relationships and world memories. Applications receive only the context they are allowed to see.
02 / CAUSE → CONSEQUENCE
A purchase becomes a possession. A possession becomes part of an encounter. An encounter becomes a memory. A world gives every next moment a before.
Lea has a funded plan for a black bag at Maison Veya. The plan carries a budget, a time window and a destination.
The black bag is out of stock. The engine pauses the plan and offers an available alternative. It does not invent stock or choose a different color silently.
After the burgundy alternative is selected, the purchase commits. Money moves, stock decreases, and the bag becomes Lea’s possession together.
In a separately authored fixture encounter, Jade notices the bag Lea is carrying. The observation becomes a social fact and can provide context for a contact intent.
ILLUSTRATED SEQUENCE Based on the recorded local purchase demonstration. The encounter is an authored fixture; this is not a live world feed.
03 / A FOUNDATION YOU CAN TRUST
A model’s output is a proposal. Skheria validates it against the world before it becomes a fact. Every accepted event has provenance. Every consequence has a cause.
Only committed events
become reality.
01History accumulates.
Accepted events are append-only.
02Private stays private.
Scopes, grants and field-level visibility.
03Offline still has a timeline.
Due work is resolved on catch-up.
04 / FOR THE BUILDERS
You own the conversation and the user experience. Skheria owns the world state, resident history and consequences that make the next interaction meaningful.
curl "$SKHERIA_URL/v1/residents/$RESIDENT_ID/state" \
-H "Authorization: Bearer $SKHERIA_TOKEN"Read the resident’s current state. Optional wallet, event, plan and inventory fields require their own scopes.
curl -X POST "$SKHERIA_URL/v1/residents/$RESIDENT_ID/simulate" \
-H "Authorization: Bearer $SKHERIA_TOKEN" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: catch-up-001" \
-d '{"until":"2026-09-26T09:12:00.000Z","reason":"app_open"}'Advance to an allowed time, no later than the trusted server clock. A 202 response means more work remains: continue with a new idempotency key.
curl "$SKHERIA_URL/v1/residents/$RESIDENT_ID/events?limit=20" \
-H "Authorization: Bearer $SKHERIA_TOKEN"Retrieve permission-filtered events. Pagination uses opaque cursors; private causes and another relation’s data remain excluded.
Actual local API paths. Calls run from your backend with provisioned credentials.
View all 18 operationsTHE WORLD IS PART OF THE CHARACTER.
Resident Engine V1 · Implemented locally. Hosted access is not yet available.