Resolve an external identity (provider + externalId on a channel) into a friend record, creating one on first contact. Returns { friend, channel, created }.

Explain the trust context for a friend: level, basis (direct/shared_group/unknown), what it permits and constrains.

Fetch a single friend record by uuid or by name.

List friend records, optionally filtered by trust level and kind, optionally limited.

Save a friend's name, a tool preference, or a general note. Use override='true' to overwrite an existing value.

Record a turn with a friend: accumulate token usage and/or append a shared-mission outcome (bumping familiarity).

Upsert shared-group participant context: link each participant to the group, promoting strangers to acquaintances.

Set a friend's trust level (also mirrors it onto the record's role).

Link an external identity to a friend, merging any orphan record that already holds it (cross-channel unification).

Remove an external identity from a friend.

Upsert an agent-peer friend record from already-resolved coordinates (no HTTP card fetch).

Resolve who the machine owner is and which friend record represents the self.

Return the capabilities of a channel (integrations, markdown, streaming, rich cards, max length).

Reserved (P1): share a friend's profile with another agent. Returns { supported: false } until federation lands.