~ 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

Release 0.3.0

Merged chadtmiller.com asked to merge into main from chadtmiller.com/hud:release/next
.changeset/kits_say_their_version.mddeleted+0−7
@@ -1,7 +0,0 @@
---
default: major
---
# Old builds of an app draw what they can of newer views
HUDKit, hudkit and the web shell say their version as they call HUD (the `place.hud/kit` client capability, and `callTool`'s `kit`), and HUD fits each tree to the kit drawing it: a client that says none is drawn for the oldest kit, 0.2.0. A view may gate a Stack, Pane or Bar on it, `"when": {"$kit": ">=0.3.0"}` or `"unless"`, and give any node a `fallback`: a component newer than the kit is sent as its children, else its fallback, else nothing. A release build of HUDKit, hudkit or the web renderer draws a component it doesn't know the same way, where a debug build still shows it isn't drawn yet. An app file's `"kits": {"oldest": "0.2.0"}` makes `hud check` warn where a view uses a component or prop newer than that with nothing around it for older kits.
android/gradle.properties+1−1
@@ -5,4 +5,4 @@ android.useAndroidX=true
android.nonTransitiveRClass=true
kotlin.code.style=official
# HUD's one version (knope.toml), published as place.hud:hudkit's.
hudVersion=0.2.0
hudVersion=0.3.0
ios/HUDKit/Sources/HUDKit/Support/Kit.swift+1−1
@@ -1,6 +1,6 @@
/// HUDKit as it says itself to HUD's server, so the server resolves views for what this build draws: HUD's one SDK version, which `knope release` bumps with every other package's (knope.toml).
public enum Kit {
public static let version = "0.2.0"
public static let version = "0.3.0"
/// The kit as the `place.hud/kit` extension and `callTool`'s `kit` name it.
public static let kit: JSON = ["platform": "ios", "version": .string(version)]
web/renderer/package.json+42−42
@@ -1,43 +1,43 @@
{
"name": "@hud/renderer",
"version": "0.2.0",
"description": "Svelte 5 components that draw what HUD's tools answer: a view the server resolved against its data, and an account's repository. No MCP in here, so any app can use them.",
"license": "MIT OR Apache-2.0",
"repository": "https://knotless.dev/chadtmiller.com/hud",
"type": "module",
"svelte": "./dist/index.js",
"types": "./dist/index.d.ts",
"exports": {
".": {
"@hud/source": "./src/index.ts",
"types": "./dist/index.d.ts",
"svelte": "./dist/index.js",
"default": "./dist/index.js"
},
"./theme.css": {
"@hud/source": "./src/theme.css",
"default": "./dist/theme.css"
}
},
"files": [
"dist",
"!dist/**/*.test.*"
],
"sideEffects": [
"**/*.css"
],
"scripts": {
"package": "svelte-package -i src -o dist"
},
"publishConfig": {
"registry": "https://knotless.dev/npm/did:plc:bcgltzqazw5tb6k2g3ttenbj/3n2kdckpvmnlo/"
},
"peerDependencies": {
"svelte": "^5.57.2"
},
"dependencies": {
"esm-env": "1.2.2",
"leaflet": "1.9.4",
"protomaps-leaflet": "5.1.0"
}
}
"name": "@hud/renderer",
"version": "0.3.0",
"description": "Svelte 5 components that draw what HUD's tools answer: a view the server resolved against its data, and an account's repository. No MCP in here, so any app can use them.",
"license": "MIT OR Apache-2.0",
"repository": "https://knotless.dev/chadtmiller.com/hud",
"type": "module",
"svelte": "./dist/index.js",
"types": "./dist/index.d.ts",
"exports": {
".": {
"@hud/source": "./src/index.ts",
"types": "./dist/index.d.ts",
"svelte": "./dist/index.js",
"default": "./dist/index.js"
},
"./theme.css": {
"@hud/source": "./src/theme.css",
"default": "./dist/theme.css"
}
},
"files": [
"dist",
"!dist/**/*.test.*"
],
"sideEffects": [
"**/*.css"
],
"scripts": {
"package": "svelte-package -i src -o dist"
},
"publishConfig": {
"registry": "https://knotless.dev/npm/did:plc:bcgltzqazw5tb6k2g3ttenbj/3n2kdckpvmnlo/"
},
"peerDependencies": {
"svelte": "^5.57.2"
},
"dependencies": {
"esm-env": "1.2.2",
"leaflet": "1.9.4",
"protomaps-leaflet": "5.1.0"
}
}
\ No newline at end of file
web/shared/package.json+40−40
@@ -1,41 +1,41 @@
{
"name": "@hud/shared",
"version": "0.2.0",
"description": "What HUD's apps make of a tool result (result.ts: its view, its page, what it acted on) and of what a person does with one (interactions.ts), and Result, a result drawn with @hud/renderer: shared by HUD's view, its workspace and @hud/shell.",
"license": "MIT OR Apache-2.0",
"repository": "https://knotless.dev/chadtmiller.com/hud",
"type": "module",
"exports": {
"./result": {
"@hud/source": "./src/result.ts",
"types": "./dist/result.d.ts",
"default": "./dist/result.js"
},
"./interactions": {
"@hud/source": "./src/interactions.ts",
"types": "./dist/interactions.d.ts",
"default": "./dist/interactions.js"
},
"./Result.svelte": {
"@hud/source": "./src/Result.svelte",
"types": "./dist/Result.svelte.d.ts",
"svelte": "./dist/Result.svelte",
"default": "./dist/Result.svelte"
}
},
"files": [
"dist"
],
"scripts": {
"package": "svelte-package -i src -o dist"
},
"publishConfig": {
"registry": "https://knotless.dev/npm/did:plc:bcgltzqazw5tb6k2g3ttenbj/3n2kdckpvmnlo/"
},
"peerDependencies": {
"svelte": "^5.57.2"
},
"dependencies": {
"@hud/renderer": "0.2.0"
}
}
"name": "@hud/shared",
"version": "0.3.0",
"description": "What HUD's apps make of a tool result (result.ts: its view, its page, what it acted on) and of what a person does with one (interactions.ts), and Result, a result drawn with @hud/renderer: shared by HUD's view, its workspace and @hud/shell.",
"license": "MIT OR Apache-2.0",
"repository": "https://knotless.dev/chadtmiller.com/hud",
"type": "module",
"exports": {
"./result": {
"@hud/source": "./src/result.ts",
"types": "./dist/result.d.ts",
"default": "./dist/result.js"
},
"./interactions": {
"@hud/source": "./src/interactions.ts",
"types": "./dist/interactions.d.ts",
"default": "./dist/interactions.js"
},
"./Result.svelte": {
"@hud/source": "./src/Result.svelte",
"types": "./dist/Result.svelte.d.ts",
"svelte": "./dist/Result.svelte",
"default": "./dist/Result.svelte"
}
},
"files": [
"dist"
],
"scripts": {
"package": "svelte-package -i src -o dist"
},
"publishConfig": {
"registry": "https://knotless.dev/npm/did:plc:bcgltzqazw5tb6k2g3ttenbj/3n2kdckpvmnlo/"
},
"peerDependencies": {
"svelte": "^5.57.2"
},
"dependencies": {
"@hud/renderer": "0.3.0"
}
}
\ No newline at end of file
web/shell/package.json+47−47
@@ -1,48 +1,48 @@
{
"name": "@hud/shell",
"version": "0.2.0",
"description": "An app's frame and screens, drawn from its app file (<domain>.json) as a web app: the tabs as a bottom bar, a rail or a sidebar by the window's width, its action, account and links, each tab a nav stack of HUD's tool results drawn with @hud/renderer, on a server and hydrated. The host gives it its navigation (a router's shallow history) and where its server calls HUD.",
"license": "MIT OR Apache-2.0",
"repository": "https://knotless.dev/chadtmiller.com/hud",
"type": "module",
"svelte": "./dist/index.js",
"types": "./dist/index.d.ts",
"exports": {
".": {
"@hud/source": "./src/index.ts",
"types": "./dist/index.d.ts",
"svelte": "./dist/index.js",
"default": "./dist/index.js"
},
"./server": {
"@hud/source": "./src/server.ts",
"types": "./dist/server.d.ts",
"default": "./dist/server.js"
},
"./shell.css": {
"@hud/source": "./src/shell.css",
"default": "./dist/shell.css"
}
},
"files": [
"dist",
"!dist/**/*.test.*"
],
"sideEffects": [
"**/*.css"
],
"scripts": {
"package": "svelte-package -i src -o dist"
},
"publishConfig": {
"registry": "https://knotless.dev/npm/did:plc:bcgltzqazw5tb6k2g3ttenbj/3n2kdckpvmnlo/"
},
"peerDependencies": {
"svelte": "^5.57.2"
},
"dependencies": {
"@hud/renderer": "0.2.0",
"@hud/shared": "0.2.0",
"esm-env": "1.2.2"
}
}
"name": "@hud/shell",
"version": "0.3.0",
"description": "An app's frame and screens, drawn from its app file (<domain>.json) as a web app: the tabs as a bottom bar, a rail or a sidebar by the window's width, its action, account and links, each tab a nav stack of HUD's tool results drawn with @hud/renderer, on a server and hydrated. The host gives it its navigation (a router's shallow history) and where its server calls HUD.",
"license": "MIT OR Apache-2.0",
"repository": "https://knotless.dev/chadtmiller.com/hud",
"type": "module",
"svelte": "./dist/index.js",
"types": "./dist/index.d.ts",
"exports": {
".": {
"@hud/source": "./src/index.ts",
"types": "./dist/index.d.ts",
"svelte": "./dist/index.js",
"default": "./dist/index.js"
},
"./server": {
"@hud/source": "./src/server.ts",
"types": "./dist/server.d.ts",
"default": "./dist/server.js"
},
"./shell.css": {
"@hud/source": "./src/shell.css",
"default": "./dist/shell.css"
}
},
"files": [
"dist",
"!dist/**/*.test.*"
],
"sideEffects": [
"**/*.css"
],
"scripts": {
"package": "svelte-package -i src -o dist"
},
"publishConfig": {
"registry": "https://knotless.dev/npm/did:plc:bcgltzqazw5tb6k2g3ttenbj/3n2kdckpvmnlo/"
},
"peerDependencies": {
"svelte": "^5.57.2"
},
"dependencies": {
"@hud/renderer": "0.3.0",
"@hud/shared": "0.3.0",
"esm-env": "1.2.2"
}
}
\ No newline at end of file
web/package-lock.json+3124−3124
A large diff, not shown.
web/package.json+50−50
@@ -1,51 +1,51 @@
{
"name": "hud-web",
"version": "0.2.0",
"private": true,
"description": "HUD's view (ui://records/view), workspace (/workspace) and view playground (/playground): each one self-contained HTML file, built into web/dist/index.html, web/dist/workspace.html and web/dist/playground.html and embedded in hud-server",
"type": "module",
"workspaces": [
"renderer",
"shared",
"shell"
],
"scripts": {
"lex": "rm -rf .lexicons && mkdir .lexicons && cp ../schemas/*.json .lexicons/ && rm .lexicons/place.hud.workspace.json && lex build --lexicons .lexicons --out workspace/lib/lexicons --clear --import-ext .ts",
"dev": "npm run build && vite",
"build": "npm run lex && vite build && vite build --mode workspace && vite build --mode playground",
"check": "npm run lex && svelte-check --tsconfig ./tsconfig.json --fail-on-warnings",
"ssr": "node renderer/test/ssr.mjs && node shell/test/ssr.mjs",
"unit": "node --test shell/src/*.test.ts renderer/src/*.test.ts renderer/src/tree/compose/*.test.ts",
"package": "npm run package -w renderer -w shared -w shell"
},
"devDependencies": {
"@atproto/lex": "0.4.8",
"@codemirror/autocomplete": "6.20.4",
"@codemirror/commands": "6.11.1",
"@codemirror/lang-json": "6.0.2",
"@codemirror/language": "6.13.1",
"@codemirror/lint": "6.9.8",
"@codemirror/state": "6.7.6",
"@codemirror/view": "6.43.15",
"@hud/renderer": "0.2.0",
"@hud/shared": "0.2.0",
"@hud/shell": "0.2.0",
"@lezer/common": "1.5.6",
"@lezer/highlight": "1.2.5",
"@modelcontextprotocol/client": "2.4.0",
"@modelcontextprotocol/core": "2.4.0",
"@modelcontextprotocol/ext-apps": "2.0.4",
"@sveltejs/package": "3.0.3",
"@sveltejs/vite-plugin-svelte": "7.3.1",
"@types/leaflet": "1.9.22",
"@types/node": "24.19.2",
"happy-dom": "21.0.4",
"lucide-static": "1.73.0",
"svelte": "5.57.2",
"svelte-check": "4.7.7",
"typescript": "6.0.3",
"vite": "8.3.5",
"vite-plugin-singlefile": "2.3.4",
"zod": "4.6.7"
}
}
"name": "hud-web",
"version": "0.3.0",
"private": true,
"description": "HUD's view (ui://records/view), workspace (/workspace) and view playground (/playground): each one self-contained HTML file, built into web/dist/index.html, web/dist/workspace.html and web/dist/playground.html and embedded in hud-server",
"type": "module",
"workspaces": [
"renderer",
"shared",
"shell"
],
"scripts": {
"lex": "rm -rf .lexicons && mkdir .lexicons && cp ../schemas/*.json .lexicons/ && rm .lexicons/place.hud.workspace.json && lex build --lexicons .lexicons --out workspace/lib/lexicons --clear --import-ext .ts",
"dev": "npm run build && vite",
"build": "npm run lex && vite build && vite build --mode workspace && vite build --mode playground",
"check": "npm run lex && svelte-check --tsconfig ./tsconfig.json --fail-on-warnings",
"ssr": "node renderer/test/ssr.mjs && node shell/test/ssr.mjs",
"unit": "node --test shell/src/*.test.ts renderer/src/*.test.ts renderer/src/tree/compose/*.test.ts",
"package": "npm run package -w renderer -w shared -w shell"
},
"devDependencies": {
"@atproto/lex": "0.4.8",
"@codemirror/autocomplete": "6.20.4",
"@codemirror/commands": "6.11.1",
"@codemirror/lang-json": "6.0.2",
"@codemirror/language": "6.13.1",
"@codemirror/lint": "6.9.8",
"@codemirror/state": "6.7.6",
"@codemirror/view": "6.43.15",
"@hud/renderer": "0.3.0",
"@hud/shared": "0.3.0",
"@hud/shell": "0.3.0",
"@lezer/common": "1.5.6",
"@lezer/highlight": "1.2.5",
"@modelcontextprotocol/client": "2.4.0",
"@modelcontextprotocol/core": "2.4.0",
"@modelcontextprotocol/ext-apps": "2.0.4",
"@sveltejs/package": "3.0.3",
"@sveltejs/vite-plugin-svelte": "7.3.1",
"@types/leaflet": "1.9.22",
"@types/node": "24.19.2",
"happy-dom": "21.0.4",
"lucide-static": "1.73.0",
"svelte": "5.57.2",
"svelte-check": "4.7.7",
"typescript": "6.0.3",
"vite": "8.3.5",
"vite-plugin-singlefile": "2.3.4",
"zod": "4.6.7"
}
}
\ No newline at end of file
Cargo.lock+3−3
@@ -925,7 +925,7 @@ checksum = "df3b46402a9d5adb4c86a0cf463f42e19994e3ee891101b1841f30a545cb49a9"
[[package]]
name = "hud"
version = "0.2.0"
version = "0.3.0"
dependencies = [
"atproto",
"hud-core",
@@ -939,7 +939,7 @@ dependencies = [
[[package]]
name = "hud-core"
version = "0.2.0"
version = "0.3.0"
dependencies = [
"atproto",
"axum",
@@ -964,7 +964,7 @@ dependencies = [
[[package]]
name = "hud-server"
version = "0.2.0"
version = "0.3.0"
dependencies = [
"atproto",
"axum",
Cargo.toml+1−1
@@ -3,7 +3,7 @@ resolver = "3"
members = ["crates/*"]
[workspace.package]
version = "0.2.0"
version = "0.3.0"
edition = "2024"
license = "MIT OR Apache-2.0"
rust-version = "1.89"
CHANGELOG.md+8−0
@@ -5,6 +5,14 @@ web packages (`@hud/renderer`, `@hud/shell`, `@hud/shared`), HUDKit for iOS
and hudkit for Android, which share one version. Written from the change
files in `.changeset/` (see `knope.toml`).
## 0.3.0 (2026-11-22)
### Breaking Changes
#### Old builds of an app draw what they can of newer views
HUDKit, hudkit and the web shell say their version as they call HUD (the `place.hud/kit` client capability, and `callTool`'s `kit`), and HUD fits each tree to the kit drawing it: a client that says none is drawn for the oldest kit, 0.2.0. A view may gate a Stack, Pane or Bar on it, `"when": {"$kit": ">=0.3.0"}` or `"unless"`, and give any node a `fallback`: a component newer than the kit is sent as its children, else its fallback, else nothing. A release build of HUDKit, hudkit or the web renderer draws a component it doesn't know the same way, where a debug build still shows it isn't drawn yet. An app file's `"kits": {"oldest": "0.2.0"}` makes `hud check` warn where a view uses a component or prop newer than that with nothing around it for older kits.
## 0.2.0
### Features