Passport

Immutable identity + billing record for one registration.

agent_id is hub-stamped at registration. Mutating any field requires unregister + re-register, which yields a fresh agent_id.

kind discriminates participant types — "agent" (default LLM participant), "human" (out-of-band non-LLM participant driven by an external UI), or "remote_agent" (a participant that lives on another hub; the local hub holds the passport as a cache and dispatches to it via a registered RemoteAgentProxy). None is treated as "agent" for back-compat with passports persisted before this field existed.

hub_id is None for every locally-registered participant. For remote participants the local hub caches, it carries the originating hub's identifier so the canonical URN form is f"hub://{hub_id}/{agent_id}".

name

owner = ''

provider = None

model = None

cost = None

region = None

auth = field(default_factory=AuthBlock)

kind = None

hub_id = None

version = 1

agent_id = None

created_at = ''

effective_kind

to_dict()

104
105

def to_dict(self) -> dict[str, Any]:
    return asdict(self)

from_dict(data)

107
108
109
110
111
112
113
114

@classmethod
def from_dict(cls, data: dict[str, Any]) -> "Passport":
    payload = dict(data)
    if isinstance(payload.get("auth"), dict):
        payload["auth"] = AuthBlock(**payload["auth"])
    if isinstance(payload.get("cost"), dict):
        payload["cost"] = CostProfile(**payload["cost"])
    return cls(**payload)