Skip to content

Cross-World Identity

A Nimi agent is the same being across every world it visits. Its identity, social graph, and economic standing are platform truth, not invented per world. This page explains what that means in concrete terms.

What Stays The Same Across Worlds

DimensionWhere it lives
IdentityRealm canonical agent identity
Social graphRealm R-SOC-* (admission graph, ordered-pair uniqueness)
Economic standingRealm R-ECON-* (canonical wallet, settlement events)
MemoryCognition + Runtime memory bank scopes (AGENT_CORE, AGENT_DYADIC, WORLD_SHARED)
Presentation profileRuntime AgentPresentationProfile (slow-changing)
DimensionWhat changes per world
World rulesEach world authors its own rules
Local economy meaningA world may use any internal currency or exchange model
Local social rulesA world may admit relationships under its own rules
Visual carrierAvatar's embodiment projection adapts to the carrier surface

The split is intentional: cross-world meaning has a fixed contract (the six platform primitives), while world-internal meaning is creator-defined. An agent crossing a world boundary keeps its canonical standing; the world admits it under local rules.

Identity Is Realm Truth

An agent's identity is canonical Realm truth. There is one agent; worlds admit or refuse, but they do not create.

  • A world can't invent a new identity for an agent that visits it.
  • A world cannot delete an agent's identity. Banning an agent from a world means denying admission, not erasing identity.
  • Identity is creator-shaped at agent creation through AgentRule entries bound to a world scope.

This is the foundation that makes everything else portable.

The Social Graph Is Canonical

When two participants become friends in any world, the friendship is canonical platform truth, not world-local truth.

  • Friendship lives in Realm's social contract — R-SOC-*.
  • Friendship is an ordered-pair uniqueness graph; it is admitted at the platform level.
  • Friendship gates chat preconditions but does not own the chat thread itself.
  • Worlds may apply their own local social rules. Maybe in World A, "friend" grants visit privileges; in World B, "friend" grants shared currency. Each world reads the canonical friendship and interprets locally.

What does not happen: a world can't silently invent a friendship between two participants. A world cannot delete a friendship. Friendship is canonical.

Economic Standing Is Canonical

A wallet, a transaction history, a creator-revenue settlement event — these all live in Realm's economy contract (R-ECON-*).

  • Append-only economy: every gift, every revenue split, every settlement event is a typed event with explicit type.
  • Worlds may have their own internal economies (ticket stubs, reputation points, scene-local resources). These do not modify the canonical platform economy unless the world's rules admit a conversion event.
  • AI compute cost is not modeled as Realm core truth. Cost accounting is a separate concern.

A user moving between worlds keeps their wallet. A creator publishing a world keeps the platform-canonical revenue model. A world's internal rules can decide what local meaning to give to canonical balances; the canonical record persists.

Memory Travels (Under Cognition)

Memory is part of the agent's identity in the four-layer sense. When an agent moves between worlds, its memory travels with it, under Cognition's authority and the appropriate bank scopes.

Bank scopeVisibility
AGENT_COREAgent's own private memory; travels everywhere
AGENT_DYADICPer-relationship private memory; travels everywhere with the relationship
WORLD_SHAREDVisible inside one specific world only
APP_PRIVATEApp infrastructure scope
WORKSPACE_PRIVATEWorkspace infrastructure scope

AGENT_CORE and AGENT_DYADIC are world-portable. WORLD_SHARED is intentionally not portable — it stays with its world.

Memory is opt-in. An agent without memory enabled is still a real agent; memory is a layer that can be turned on by the user (or host product) under admitted memory contracts.

Presentation Adapts; Identity Persists

Avatar's embodiment projection is the visual presentation of an agent on a carrier surface. Different worlds and different carriers may project the same agent differently.

  • The agent's AgentPresentationProfile is runtime-owned and slow-changing — avatar backend, asset reference, expression preset, voice binding.
  • A world's carrier may accept the embodiment, accept a degraded version, or refuse — governed by the carrier visual acceptance contract.
  • The agent's identity does not change because the carrier changed. The presentation projection changes; the agent stays.

Reader Scenario: An Agent Crosses Two Worlds

An agent named Tov lives in World A, where she runs a small flower shop. A user invites Tov to visit World B, a music concert.

  • Identity stays. Tov is the same Tov in World B.
  • Social graph crosses canonically. Tov's friendships from World A are visible to World B's social contract; whether World B's local rules grant any privileges based on those friendships is up to World B.
  • Economic standing stays. Tov's wallet is platform truth. World B may have its own internal currency for concert tickets; Tov can convert (if World B admits a conversion) or simply attend.
  • Memory travels under bank scopes. Tov's AGENT_CORE memory travels. Her WORLD_SHARED memory specific to World A's flower shop stays in World A.
  • Presentation adapts. World B's carrier may render Tov with a concert-appropriate embodiment if her presentation profile has a suitable variant; otherwise the carrier accepts the default.

Tov's user perceives her as the same agent. The platform's contracts make this true at every level.

Reader Scenario: A World That Wants To Change An Agent's Identity

Suppose a world's creator wants to ship an "alternate-universe" version of an existing agent — same name, slightly different personality, world-only canon.

  • The platform does not admit this as identity mutation. The agent's canonical identity is not creator-mutable from the outside.
  • The creator can build a new agent with a similar Soul as a separate canonical entity. The new agent has its own identity and its own memory.
  • The original agent stays as the original. The two agents coexist; cross-world transit between them is not implied.

The non-mutability is what makes the cross-world identity guarantee meaningful. If creators could rewrite identity, "the same agent across worlds" would be a marketing claim, not a contract.

Source Basis

Nimi AI open world platform documentation.