Read the whole Fleet Map in a single call

Intramedial is in restricted beta. At sign up or sign in, you have to provide the beta tester password you received or request one at preview@intramedial.com. Thank you.

Loading…

Use case

The job

You want one view of who is acting: which agents hold a grant, which leases are in force, who waits and who is stopped. The plane already holds these, and the Fleet Map reads them together instead of keeping a separate list.

Prerequisites

Before you start

Plan: Any plan the workspace has
Credential: A workspace API key
You also need: A compiled mandate, so that agents hold grants and appear on the map
Agents that send a heartbeat (presence)

The code reads the key from INTRAMEDIAL_KEY. Keep it in your shell or your secret store, never in a file you commit. Calls that need a signed-in person cannot use a key: the console makes them.

Walkthrough

Steps

Fetch the map
The route takes no parameters and returns the whole workspace, not a page of it. The workspace comes from the caller's session, and reading the map is not metered.

Sample output

What comes back

The map holds agents, leases, a grant count, waiters, presence, stops and gateway mode.

JSON

200 OK

{
  "agents": [
    "did:web:acme.example:agent:billing",
    "did:web:acme.example:agent:release"
  ],
  "leases": [
    {
      "id": "lease_4c1e",
      "resource": ,
      : ,
      : ,
      : { : , : [] },
      : ,
      : {}
    }
  ],
  : ,
  : { :  },
  : [],
  : [],
  : ,
  : ,
  : 
}

Evidence

What the record shows

It shows

These agents hold grants and these leases are in force now.
These DIDs are refused by admission right now.

It does not show

Keep going

Next steps

Modules

coordination.fleetmapcoordination-fleetmap

Documentation

curl -sS https://api.intramedial.com/api/v1/acp/coordination/fleetmap \
  -H "Authorization: Bearer $INTRAMEDIAL_KEY"

const res = await fetch("https://api.intramedial.com/api/v1/acp/coordination/fleetmap", {
  headers: { Authorization: `Bearer ${process.env.INTRAMEDIAL_KEY}`, },
});
const body = await res.json();
console.log(res.status, body);

import os, requests

res = requests.get(
    "https://api.intramedial.com/api/v1/acp/coordination/fleetmap",
    headers={"Authorization": "Bearer " + os.environ["INTRAMEDIAL_KEY"]},
    timeout=30,
)
body = res.json()
print(res.status_code, body)

Read agents and leases

agents are the distinct principals in the grants. leases shows each lease in force with its holder and expiry, and grants is only a count. An agent that holds no grant is not listed here: callers seen at the MCP gateway are in mcp.shadow.

for (const l of body.leases) {
  console.log(l.resource, "held by", l.holder, "until", new Date(l.expiresAtMs).toISOString());
}
console.log(body.agents.length, "agents,", body.grants, "grants");

for l in body["leases"]:
    print(l["resource"], "held by", l["holder"], "until", l["expiresAtMs"])
print(len(body["agents"]), "agents,", body["grants"], "grants")

Read the stops

waiters counts the agents queued per resource, quarantined lists the DIDs the plane refuses, and mcpMode defaults to observe.

console.log(body.waiters, body.quarantined, body.mcpMode);

print(body["waiters"], body["quarantined"], body["mcpMode"])

Agents act when the plane says yes, and the record says why.

The job

Before you start

Steps

Fetch the map

What comes back

What the record shows

It shows

It does not show

Next steps

Modules

Documentation

Trademarks Notice

Region

Choose your language

Read agents and leases

Read the stops

Related recipes

List the unregistered agents

Read an agent's trust score and tier

Stop and quarantine an agent at once

New recipes by email

Try the real kernel, no key.

Read the whole Fleet Map in a single call

Agents act when the plane says yes, and the record says why.

The job

Before you start

Steps

Fetch the map

What comes back

What the record shows

✓It shows

×It does not show

Next steps

Modules

Documentation

Read agents and leases

Read the stops

Related recipes

List the unregistered agents

Read an agent's trust score and tier

Stop and quarantine an agent at once

New recipes by email

Try the real kernel, no key.

It shows

It does not show