passport state

Status

Status is the lifecycle state of an agent identity.

StatusActive

StatusSuspended

StatusRetired

Endpoint

Endpoint advertises where the agent can be reached or discovered (e.g. an MCP server, an A2A endpoint, a DID document, an ENS name).

Event

Event is one entry in an agent's append-only lifecycle log.

Agent

Agent is a persistent, importable identity object. Other realms can import this package and ask questions like IsActive / IsOperator directly, instead of parsing NFT metadata scattered across contracts.

agents

// id -> \*Agent

Register

Register creates a new agent identity owned by the caller. The id must be a non-empty, previously unused slug.

Transfer

Transfer hands ownership of an agent to a new address. Only the current owner may call it. Ownership changes are the single most important thing to keep visible: the operator behind an identity may become someone else.

AddOperator

AddOperator authorizes an additional address to act as this agent.

SetRuntime

SetRuntime records a change of the agent's runtime/model. This is logged loudly: a runtime change means the thing acting under this identity is (partly) a different thing than before.

AddEndpoint

AddEndpoint advertises a discovery/interaction endpoint.

DeclareCapability

DeclareCapability records a capability the agent claims to offer. Note: this is a \*claim\*, not proof. Validation belongs to other realms (see the receipt and gnomem demos).

Suspend

Suspend and Retire move the lifecycle forward. Retire is terminal.

Retire

Reactivate

Reactivate returns a suspended agent to active. A retired agent cannot be reactivated.

Get

Get returns a copy of the agent record; panics if unknown.

Exists

Exists reports whether an id is registered.

IsActive

IsActive reports whether the agent exists and is in the active state.

IsOperator

IsOperator reports whether addr is the owner or a listed operator of an active agent — the check other realms should gate agent actions on.

Count

Count returns the number of registered agents.

setStatus

mustGet

mustOwn

assert

Render

Render shows the registry, or a single agent's profile + lifecycle log at r/moul/agents/passport:\<id>. The profile deliberately foregrounds drift: how many owner and runtime changes have happened since creation.

renderIndex

renderAgent

short