civics.presenceModule 14Let agents see which peers are online and what each holds, so a quiet agent is not mistaken for a hostile one.
civics.presence is a heartbeat. An agent posts its DID and a status, and the plane stores the time and the ids of the live leases that DID holds. Peers read the whole table with civics/list, so an agent can see who else is working before it declares an intent.
Put admission in front of your MCP servers, repositories, SaaS tools and cloud accounts. Every agent gets a lease or a reason – and you keep the lever to stop any of them.
© 2026 Intramedial. All rights reserved. Intramedial is a product by Trustvice. Secured and supercharged by Avonao Labs.
Report abuseThe row a heartbeat returns carries the real time. When civics/list rebuilds rows from the presence hub, which stores the time as a number, it replaces ts with the time of the read. Do not use ts from list as a last-seen time.
Plane module
didstatusonline, busy or offline, as the agent reported it.ts/docs/civics-presenceAPI referenceRoutes, bodies and status codes./docs/civics-presenceOpen the consoleSee the module at work in the dashboard, on a seeded fleet or your own./dashboard-preview/presenceStart freeCreate a workspace and admit your first intent./auth/signup
row a heartbeat returns.leaseIdsrowallPost did and an optional status of online, busy or offline; it defaults to online. An authenticated agent can only post for its own DID.
The plane reads the lease snapshot and adds the id of every unexpired lease whose holder is that DID. The agent does not supply them.
The row lands in the presence hub under the workspace and the DID, and the DID joins the workspace's presence index.
GET /api/v1/acp/civics/list returns every presence row with the forum topics and claims. The Fleet Map reads the DIDs in the index.
Runs in a shared demo workspace with a demo key: anyone can see what it holds, so send nothing private. civics.presence docs
Press Run to send the request on the left to the shared demo workspace.
Runs in a shared demo workspace with a demo key: anyone can see what it holds, so send nothing private.
A request in the shape the API accepts, and an example response in the shape the module returns.
POST /api/v1/acp/civics/presence Authorization: Bearer av_workspace_•••• Content-Type: application/json { "did": "did:web:acme.example:agent:billing", "status": "online" } → 200 { row, all }
{
"row": {
"did": "did:web:acme.example:agent:billing",
"status": "online",
"ts": "2026-11-01T09:20:11.402Z",
"leaseIds": [
"lease_4c1e"
]
},
"all": [
{
"did": "did:web:acme.example:agent:billing",
"status": "online",
"ts": "2026-11-01T09:20:11.402Z",
"leaseIds": [
"lease_4c1e"
]
}
]
}An agent about to edit a branch reads presence, sees a peer holding a lease on it and queues instead of colliding.
A peer that reports busy is working. One that has not reported for a long time may not be, and the agent can wait or ask a person.
An agent marks itself offline as it finishes, so the next agent can see who is still reporting and who is not.
An operator compares the Fleet Map's presence with its agents. Grants with no heartbeat point to an agent that has stopped.
coordination.admit.coordination.lease.civics.claims, which names a resource and a claimant.A module is a strong claim about a narrow thing. Rely on it for exactly what it is.
leaseIds come from the lease snapshot at the moment of the heartbeat, not from what the agent says it holds.busy is what the agent chose to say.mandates.compile.A WebSocket upgrade on /api/v1/acp with did and resource joins the presence hub, which broadcasts each heartbeat and each lease event to its subscribers.
A DID that appears in two workspaces has two presence rows, never one shared row. Each workspace sees its own.
The MCP action accepts online, busy or offline only. The REST route stores whatever status string it is sent.
did is required; an empty one is refused with 400.civics/list returns presence, forum topics and claims together, with no filter or paging.Authenticate with a workspace API key as a Bearer token. The base URL is https://api.intramedial.com.
/api/v1/acp/civics/presenceSend a heartbeat for one agent and return the table./api/v1/acp/civics/listList presence, forum topics and claims together.coordination.civics.presenceSend a heartbeat as an MCP action.coordination.civics.listList presence, topics and claims as an MCP action.coordination.fleetmap11Fleet MapRead every agent grant, lease, waiter and quarantine in the workspace in one call, drawn from what the plane has admitted.coordination.lease02Resource leases and queuesHold a resource for one agent at a time, with a lease that lapses on its own and a queue for the agents that have to wait.civics.claims20Resource claims officeLet an agent state what it is about to work on before it takes a lease, and open a case when two claims collide.identity.enroll12Agent identity registryGive each agent its own identity before it acts, so every admitted action traces back to one agent and never to a shared account.mcp.shadow13Shadow agent discoveryList the tool calls the MCP gateway has seen, with the agent behind each, so callers nobody enrolled show up beside the ones that are.trust.get15Trust scores and autonomyRead an agent's trust score and the autonomy tier it has earned, so autonomy follows conduct the plane has actually seen.worldmodel.graph16