chadtmiller.com/hud
A remote MCP server that shows atproto records as interactive UI inside MCP Apps hosts
place.hud.hudkit 0.3.1 Latest 5 packages
0
0
{
"lexicon": 1,
"id": "place.hud.frame",
"defs": {
"main": {
"type": "object",
"description": "An operator's app file's frame (frame in <HUD_APPS>/<domain>.json): how a client's shell draws the app's navigation, its one primary action, the account's area, footer links and an aside around its screens. An object in a file, not a method, so it needs no auth. hud_core::operator holds a frame to this lexicon, then to its own rules: no key but these, each call drawn by a view, each icon one a shell draws.",
"properties": {
"destinations": { "type": "string", "maxLength": 32, "knownValues": ["tabs"], "description": "What the navigation lists: tabs, the app's tabs, drawn as a bottom bar, a rail or a sidebar by the window's width." },
"action": { "type": "ref", "ref": "#action", "description": "The app's one primary action, drawn signed in." },
"account": { "type": "ref", "ref": "#account", "description": "The account's area." },
"links": { "type": "array", "maxLength": 12, "items": { "type": "ref", "ref": "#link" }, "description": "Links drawn at the navigation's foot." },
"aside": { "type": "ref", "ref": "#aside", "description": "A screen drawn beside the main column where the window has the room." },
"sizes": { "type": "ref", "ref": "#sizes", "description": "The widths of the column a view's measure asks for." },
"bands": { "type": "ref", "ref": "#bands", "description": "The window widths at which the navigation changes." }
}
},
"call": {
"type": "object",
"description": "A tool call, as an app's tabs and routes name one.",
"required": ["name"],
"properties": {
"name": { "type": "string", "maxLength": 64, "description": "The tool's name: query, describe_app, get_record or list_records." },
"args": { "type": "unknown", "description": "The tool's arguments." }
}
},
"action": {
"type": "object",
"description": "The app's one primary action: a filled button in the sidebar, an icon in the rail; not drawn in the bottom bar's band, where the screen's own bar has it.",
"required": ["label", "icon", "call"],
"properties": {
"label": { "type": "string", "minLength": 1, "maxLength": 400, "maxGraphemes": 40, "description": "Its label." },
"icon": { "type": "string", "maxLength": 32, "knownValues": ["feed", "search", "compass", "notification", "people", "settings", "plus", "photo", "imagePlus", "logOut", "logIn", "grid", "heart", "star", "comment", "activity", "repo", "issue", "pull", "release"], "description": "Its icon." },
"call": { "type": "ref", "ref": "#call", "description": "The call it opens, drawn by a view, as a screen on the tab on show." }
}
},
"account": {
"type": "object",
"description": "The account's area: its picture and its items.",
"properties": {
"picture": { "type": "ref", "ref": "#picture", "description": "Where the account's picture is read, and the tab it is drawn on." },
"items": { "type": "array", "maxLength": 8, "items": { "type": "ref", "ref": "#item" }, "description": "What the account's area lists." }
}
},
"picture": {
"type": "object",
"description": "The account's picture: read once from a query's answer (the account's profile, called as each account the app is signed in to), it becomes the icon of a tab, and with its name and handle beside it a row of the accounts the host lists (a view's Accounts).",
"required": ["tab", "call", "at"],
"properties": {
"tab": { "type": "string", "maxLength": 400, "maxGraphemes": 40, "description": "The label of the tab whose icon it becomes." },
"call": { "type": "ref", "ref": "#call", "description": "A query call that reads it." },
"at": { "type": "string", "minLength": 1, "maxLength": 1000, "maxGraphemes": 100, "description": "A dotted path to the picture in the query's answer." },
"name": { "type": "string", "minLength": 1, "maxLength": 1000, "maxGraphemes": 100, "description": "A dotted path to the account's name in the same answer, for its row among the accounts." },
"handle": { "type": "string", "minLength": 1, "maxLength": 1000, "maxGraphemes": 100, "description": "A dotted path to the account's handle in the same answer, for its row among the accounts." }
}
},
"item": {
"type": "object",
"description": "One of the account's items: a screen of the app's (label, icon and call), drawn signed in, or one the host draws (host).",
"properties": {
"label": { "type": "string", "minLength": 1, "maxLength": 400, "maxGraphemes": 40, "description": "Its label." },
"icon": { "type": "string", "maxLength": 32, "knownValues": ["feed", "search", "compass", "notification", "people", "settings", "plus", "photo", "imagePlus", "logOut", "logIn", "grid", "heart", "star", "comment", "activity", "repo", "issue", "pull", "release"], "description": "Its icon." },
"call": { "type": "ref", "ref": "#call", "description": "The screen it opens, drawn by a view." },
"host": { "type": "string", "maxLength": 32, "knownValues": ["signOut", "signIn"], "description": "What the host does: signOut, drawn signed in; signIn, drawn signed out." },
"about": { "type": "string", "minLength": 1, "maxLength": 1000, "maxGraphemes": 100, "description": "A line drawn over a host item." }
}
},
"link": {
"type": "object",
"description": "A link at the navigation's foot.",
"required": ["label", "href"],
"properties": {
"label": { "type": "string", "minLength": 1, "maxLength": 400, "maxGraphemes": 40, "description": "Its label." },
"href": { "type": "string", "maxLength": 2000, "description": "Where it goes: a path starting with / or an https URL." }
}
},
"aside": {
"type": "object",
"description": "A screen drawn right of the main column.",
"required": ["call"],
"properties": {
"call": { "type": "ref", "ref": "#call", "description": "The screen, drawn by a view." },
"width": { "type": "integer", "minimum": 200, "maximum": 480, "default": 320, "description": "Its width in CSS pixels." }
}
},
"sizes": {
"type": "object",
"description": "The widths, in CSS pixels, of the column a view's measure asks for.",
"properties": {
"content": { "type": "integer", "minimum": 320, "maximum": 1600, "default": 600, "description": "The column of a view whose measure is content." },
"wide": { "type": "integer", "minimum": 320, "maximum": 2400, "default": 935, "description": "The column of a view whose measure is wide; no narrower than content." }
}
},
"bands": {
"type": "object",
"description": "The window widths, in CSS pixels, at which the navigation changes.",
"properties": {
"rail": { "type": "integer", "minimum": 320, "maximum": 4000, "default": 600, "description": "From this width, a rail in place of a bottom bar." },
"sidebar": { "type": "integer", "minimum": 320, "maximum": 4000, "default": 1200, "description": "From this width, a labelled sidebar; wider than rail." }
}
}
}
}