Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

fix(agent-vitals): stop the vitals board from spending tokens on every poll

nirholas0e6c43d2e02d
diff --git a/api/agents/vitals.js b/api/agents/vitals.js
index 8255fe09e..17b0af926 100644
--- a/api/agents/vitals.js
+++ b/api/agents/vitals.js
@@ -19,7 +19,13 @@
//
// Query:
// network=mainnet|devnet (default mainnet)
-// llm=0 skip the model-chain probe (it spends a few tokens)
+// llm=1 also probe the model chain (OFF by default here)
+//
+// The model probe sends a real completion, so it is opt-in over HTTP: this is a
+// board an operator leaves polling, and a token spend per poll is a bill nobody
+// asked for. The CLI defaults the other way, because a human runs it once. With
+// the probe off, an arm that needs a model reports `cognition: unknown`, which
+// keeps its capability `unknown` rather than inventing a pass.
//
// Response: { ok, network, at, shared, summary, arms: [{ name, can, root_causes, ... }] }
@@ -50,7 +56,7 @@ export default wrap(async (req, res) => {
if (!NETWORKS.has(network)) {
return error(res, 400, 'invalid_network', `network must be one of: ${[...NETWORKS].join(', ')}`);
}
- const includeCognition = url.searchParams.get('llm') !== '0';
+ const includeCognition = url.searchParams.get('llm') === '1';
const fleet = await attestFleet({ network, includeCognition });
const summary = summarizeFleet(fleet.arms);
diff --git a/docs/agent-vitals.md b/docs/agent-vitals.md
index c505633a8..490e525e1 100644
--- a/docs/agent-vitals.md
+++ b/docs/agent-vitals.md
@@ -165,10 +165,17 @@ is present, because that reading is the one that closed the case.
## HTTP
-`GET /api/agents/vitals?network=mainnet&llm=1`, gated by `authorizeOps` (admin
-session or `x-ops-secret`, never `CRON_SECRET`). The response names wallet
-addresses, funding deficits and deploy commands, which is an operator view
-rather than a public one.
+`GET /api/agents/vitals?network=mainnet`, gated by `authorizeOps` (admin session
+or `x-ops-secret`, never `CRON_SECRET`). The response names wallet addresses,
+funding deficits and deploy commands, which is an operator view rather than a
+public one.
+
+The model probe sends a real completion, so it is **opt-in over HTTP**: pass
+`llm=1`. This is a board an operator leaves polling, and a token spend per poll
+is a bill nobody asked for. The CLI defaults the other way, because a human runs
+it once. With the probe off, an arm that needs a model reports
+`cognition: unknown`, which keeps its capability `unknown` rather than inventing
+a pass.
## Related