~ knotless Search/
↑↓ move↵ open⇧↵ all results

chadtmiller.com/hud

A remote MCP server that shows atproto records as interactive UI inside MCP Apps hosts

0
0
20 lines · 1.5 KB Raw History
{
	"lexicon": 1,
	"id": "place.hud.getWorkspaceEvents",
	"description": "The signed-in person's workspace, live, as server-sent events.",
	"defs": {
		"main": {
			"type": "query",
			"description": "The person's workspace, live: an open stream of server-sent events (text/event-stream), one covering every canvas they have open as a tab, which follows the tabs as they open and close. Each event's data is one JSON object, typed by its $type: place.hud.defs#tileEvent (a tile of an open canvas changed), #presenceEvent (who is on an open canvas: first for each as the stream opens, then as people come and go) or #canvasesEvent (the workspace changed: read getWorkspace again). A comment, ping, comes every 25 seconds when nothing else does. It is a query, not an XRPC subscription: subscriptions are WebSocket with DAG-CBOR frames, sequenced for backfill from a cursor, and this keeps no history to backfill from (what happened while no stream was open is read again from getWorkspace and getCanvas), while a browser's EventSource sends the session's cookie and reconnects by itself. It ends when the session does, or when the reader falls too far behind: connect again and read afresh. Requires auth: the workspace's web session (its cookie, with X-HUD: 1 and the server's own Origin on a procedure) or a HUD access token as Bearer.",
			"output": {
				"encoding": "text/event-stream"
			},
			"errors": [
				{
					"name": "AuthRequired",
					"description": "No live web session or HUD access token: sign in."
				}
			]
		}
	}
}