ui operations

The exact fields each ui.* operation takes and returns.

Every op is POST /v1/<op> over HTTP and the MCP tool loom_<op>. The identity fields (org, namespace, agent, user_id, session_id) are filled from the token and the MCP session when a transport can; for an HTTP call with no token on a single-user server, the install's org on every op but code.* and tracker.* (which keep their plane's), and on some ops its namespace and agent; see identities and namespaces. The operations index explains role, kind and the MCP all listing. Unknown input fields are served and named in ignored_args.

ui.vitals

Record one dashboard page's web vitals; the per-op ledger row the transport writes carries the fields.

POST /v1/ui.vitals · MCP loom_ui_vitals · role viewer · idempotent · not listed under the MCP all toolset

Input field	Type	Default	Meaning
org	str	required	The tenant (first element of the identity tuple).
namespace	str	required	The namespace the op reads or writes.
agent	str	'loom-ui'	The writing or reading agent; '-' or '*' means any agent where the op allows it.
route	str	required	The dashboard route id (memories, knowledge, admin/usage...).
lcp_ms	int \| None	None	Largest contentful paint of the first view of the session, ms; None on a client-side navigation (the browser reports LCP once per document).
long_task_ms	int	0	Main-thread long tasks (>50 ms) summed over the view, ms.
inp_ms	int \| None	None	The longest interaction of the view (an event-timing entry's duration — input delay + processing + presentation), ms; None when none reached the client's threshold.
dom_nodes	int	0	Elements in the document when the view was flushed (the count of *).
api_calls	int	0	/v1 calls the view issued and the span from the first request's start to the last response's end, ms.
api_ms	int	0	A view held open for an hour of polls spans more than 600 s.
build	str	''	The server build the bundle was served by (health's build_commit).
cold	bool	True	True for the first view of the session (a document load), False for a navigation inside the SPA.

Output field	Type	Meaning
recorded	bool	Always true: the vitals ride the ledger row the transport writes for the call.
route	str	The route id the call reported (echoes the request).