@mnmal-ai/substrate-tui 1.0.0-alpha.1 → 1.0.0-alpha.11

package/README.md

@@ -1,6 +1,6 @@
 # @mnmal-ai/substrate-tui
 
-A terminal UI for Substrate: ask questions in natural language, browse the federated schema, watch service status and metrics, and, with an unlocked admin identity, run admin operations. Install it with `pnpm add -g @mnmal-ai/substrate-tui`, then run `substrate-tui` in an interactive terminal with `SUBSTRATE_URL` set.
+A terminal UI for Substrate: ask questions in natural language, browse the federated schema, watch service status and metrics, and, with an unlocked admin identity, run admin operations. Install it with `pnpm add -g @mnmal-ai/substrate-tui@next`, then run `substrate-tui` in an interactive terminal with `SUBSTRATE_URL` set.
 
 Without an admin identity it is read-only.
 
@@ -25,7 +25,7 @@ Without an admin identity it is read-only.
 
 ## Status row
 
-`● LIVE`, `● OFFLINE` or `● RECONNECTING` (polled from `/health` every 10 s), the service version, the agent kid (`anon` when unauthenticated, `anon?` when whoami fails) and the active namespace.
+`● LIVE`, `● OFFLINE` or `● RECONNECTING` (polled from `/health` every 10 s), the service version, the agent kid (key id; `anon` when unauthenticated, `anon?` when whoami fails) and the active namespace.
 
 ## Environment
 

package/dist/{app-BLOyJcBh.js → app-xXFNoDVu.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { i as isKeyRejection, t as adminCapabilityOf } from "./session-C1D5Ermr.js";
 import { resolve } from "node:path";
-import { AdminBackfillError, AuthError, CURRENT_MARK, NetworkError, STEP_MARKS, adminClaimCapabilities, capabilitiesFor, checkRevocable, checkUpdatable, currentStep, decodeList, describeGrant, diagnose, encodeGrant, flattenGrant, grantEntriesConfer, isActiveAdminKeyRow, isEncryptedKey, makeTokenProvider, parseGrantEntries, planOnboarding, resolveAdminCredential } from "@mnmal-ai/substrate/client";
+import { AdminBackfillError, AuthError, CURRENT_MARK, NetworkError, STEP_MARKS, adminClaimCapabilities, capabilitiesFor, checkRevocable, checkUpdatable, currentStep, decodeList, describeGrant, diagnose, encodeGrant, flattenGrant, grantEntriesConfer, isActiveAdminKeyRow, isEncryptedKey, makeTokenProvider, parseGrantEntries, planOnboarding, resolveAdminCredential, tokenAudience } from "@mnmal-ai/substrate/client";
 import { createApp, defineModule, sanitise } from "@mnmal-ai/surface-core";
 import { marathon } from "@mnmal-ai/surface-theme";
 import { complete } from "@mnmal-ai/substrate-nl/complete";
@@ -76,6 +76,7 @@ function adminModule(deps, io = {}) {
 			kid
 		}, {
 			capabilities: adminClaimCapabilities(deps.adminEnv),
+			audience: tokenAudience(deps.endpoint),
 			...passphrase !== void 0 ? { passphrase } : {}
 		});
 		return verifyAndUnlock(() => `Bearer ${getToken()}`, keyPath, kid, getToken);
@@ -223,6 +224,7 @@ const KIND = {
 	recall: "substrate.recall",
 	clarify: "substrate.clarify",
 	refuse: "substrate.refuse",
+	unknown: "substrate.unknown",
 	error: "substrate.error"
 };
 const str = (v) => v === void 0 || v === null ? "" : sanitise(String(v));
@@ -231,9 +233,10 @@ const errorLines = (errors) => (errors ?? []).map((e) => {
 	const x = e;
 	return sanitise(`${x.code ?? "error"}${x.message !== void 0 ? `: ${x.message}` : ""}`);
 });
+const droppedLines = (dropped) => (dropped ?? []).map((d) => sanitise(`dropped "${d.span}": ${d.reason}`));
 function outcomeChips(o) {
 	if (o.kind !== "rows") return [];
-	const rejected = !Array.isArray(o.data);
+	const rejected = o.data === void 0;
 	return [
 		{
 			label: `▸ ${frameKey(o)}`,
@@ -244,7 +247,7 @@ function outcomeChips(o) {
 			tone: o.source === "handoff" ? "warn" : "dim"
 		},
 		{
-			label: rejected ? "rejected" : `${o.data.length} rows`,
+			label: rejected ? "rejected" : `${o.count ?? (Array.isArray(o.data) ? o.data.length : 0)} rows`,
 			tone: rejected ? "error" : "dim"
 		}
 	];
@@ -260,6 +263,17 @@ const titleWidth = (columns) => Math.max(COLS.minTitle, columns - (COLS.id + COL
 const rows = ({ data, theme, size }) => {
 	const titleCols = titleWidth(size.columns);
 	const o = data;
+	const lost = droppedLines(o.dropped).map((l, i) => /* @__PURE__ */ jsx(Text, {
+		color: theme.color.warn,
+		children: `  ${l}`
+	}, `d${i}`));
+	if (!Array.isArray(o.data) && typeof o.count === "number") return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [/* @__PURE__ */ jsx(Text, {
+			color: theme.color.text,
+			children: o.count
+		}), lost]
+	});
 	if (!Array.isArray(o.data)) return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		children: [/* @__PURE__ */ jsxs(Text, {
@@ -271,33 +285,53 @@ const rows = ({ data, theme, size }) => {
 		}, i))]
 	});
 	const list = o.data;
-	if (list.length === 0) return /* @__PURE__ */ jsx(Text, {
+	if (list.length === 0 && lost.length === 0) return /* @__PURE__ */ jsx(Text, {
 		color: theme.color.dim,
 		children: "no rows"
 	});
-	return /* @__PURE__ */ jsx(Box, {
+	return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
-		children: list.map((r, i) => /* @__PURE__ */ jsxs(Text, { children: [
-			/* @__PURE__ */ jsx(Text, {
+		children: [
+			list.length === 0 ? /* @__PURE__ */ jsx(Text, {
 				color: theme.color.dim,
-				children: padCells(str(r.shortId ?? r.id), COLS.id, true)
-			}),
-			"  ",
-			/* @__PURE__ */ jsx(Text, {
-				color: theme.color.text,
-				children: padCells(str(r.title ?? r.synopsis ?? r.name ?? r.topic ?? r.subject), titleCols)
-			}),
-			"  ",
-			/* @__PURE__ */ jsx(Text, {
-				color: theme.color.info,
-				children: padCells(str(r.status), COLS.status)
-			}),
-			"  ",
-			/* @__PURE__ */ jsx(Text, {
-				color: theme.color.dimMid,
-				children: padCells(str(r.project), COLS.project)
-			})
-		] }, i))
+				children: "no rows"
+			}) : null,
+			list.map((r, i) => /* @__PURE__ */ jsxs(Text, { children: [
+				/* @__PURE__ */ jsx(Text, {
+					color: theme.color.dim,
+					children: padCells(str(r.shortId ?? r.id), COLS.id, true)
+				}),
+				"  ",
+				/* @__PURE__ */ jsx(Text, {
+					color: theme.color.text,
+					children: padCells(str(r.title ?? r.synopsis ?? r.name ?? r.topic ?? r.subject), titleCols)
+				}),
+				"  ",
+				/* @__PURE__ */ jsx(Text, {
+					color: theme.color.info,
+					children: padCells(str(r.status), COLS.status)
+				}),
+				"  ",
+				/* @__PURE__ */ jsx(Text, {
+					color: theme.color.dimMid,
+					children: padCells(str(r.project), COLS.project)
+				})
+			] }, i)),
+			lost
+		]
+	});
+};
+const unknown = ({ data, theme }) => {
+	const o = data;
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [/* @__PURE__ */ jsx(Text, {
+			color: theme.color.warn,
+			children: "? unknown: not answered, because part of it was dropped"
+		}), droppedLines(o.dropped).map((l, i) => /* @__PURE__ */ jsx(Text, {
+			color: theme.color.warn,
+			children: `  ${l}`
+		}, i))]
 	});
 };
 const recall = ({ data, theme }) => {
@@ -385,6 +419,7 @@ const renderers = {
 	[KIND.recall]: recall,
 	[KIND.clarify]: clarify,
 	[KIND.refuse]: refuse,
+	[KIND.unknown]: unknown,
 	[KIND.error]: error
 };
 
@@ -524,6 +559,7 @@ function askModule(deps) {
 						case "recall":
 						case "clarify":
 						case "refuse":
+						case "unknown":
 							last = { lines };
 							if (ev.event === "clarify" && ev.data.options.length > 0) ctx.open("clarify", ev.data);
 							else ctx.close();
@@ -3660,6 +3696,14 @@ function surgeryModule(deps, io = {}) {
 
 //#endregion
 //#region src/app.ts
+/** marathon with no overlay fill: an empty `raised` means Ink paints no background, so panels sit on the ground. */
+const substrateTheme = {
+	...marathon,
+	color: {
+		...marathon.color,
+		raised: ""
+	}
+};
 function buildModules(deps, opts = {}) {
 	return [
 		statusModule(deps, opts),
@@ -3674,11 +3718,12 @@ function buildModules(deps, opts = {}) {
 }
 function substrateAppOptions(deps, opts = {}) {
 	return {
-		theme: marathon,
+		theme: substrateTheme,
 		modules: buildModules(deps, opts),
 		defaultTurn: "substrate.ask:ask",
 		band: true,
 		gutter: 2,
+		anchored: true,
 		terminal: false
 	};
 }
@@ -3687,4 +3732,4 @@ function createTui(deps, opts = {}) {
 }
 
 //#endregion
-export { buildModules, createTui, substrateAppOptions };
+export { buildModules, createTui, substrateAppOptions, substrateTheme };

package/dist/bin/substrate-tui.js

@@ -1,12 +1,13 @@
 #!/usr/bin/env node
 import { t as colorDepthEnv } from "../terminal-XfKFiD7r.js";
 import { basename } from "node:path";
-import { DEFAULT_CAPABILITIES, makeTokenProvider } from "@mnmal-ai/substrate/client";
+import { DEFAULT_CAPABILITIES, makeTokenProvider, tokenAudience } from "@mnmal-ai/substrate/client";
+import { trimTrailingSlashes } from "@mnmal-ai/substrate/sdk";
 
 //#region src/config.ts
 const message = (err) => err instanceof Error ? err.message : String(err);
 function readConfig(env, cwd) {
-	const endpoint = (env.SUBSTRATE_URL ?? "").replace(/\/+$/, "");
+	const endpoint = trimTrailingSlashes(env.SUBSTRATE_URL ?? "");
 	if (endpoint === "") return { error: "SUBSTRATE_URL is required (e.g. https://substrate.example.com:3100)" };
 	const namespace = env.SUBSTRATE_NAMESPACE ?? "";
 	if (namespace === "") return { error: "SUBSTRATE_NAMESPACE is required (the namespace to watch)" };
@@ -19,7 +20,10 @@ function readConfig(env, cwd) {
 			token = makeTokenProvider({
 				keyPath,
 				kid
-			}, { capabilities: raw !== void 0 && raw.length > 0 ? raw : DEFAULT_CAPABILITIES });
+			}, {
+				capabilities: raw !== void 0 && raw.length > 0 ? raw : DEFAULT_CAPABILITIES,
+				audience: tokenAudience(endpoint)
+			});
 		} catch (err) {
 			return { error: `agent identity: ${message(err)}` };
 		}
@@ -47,7 +51,7 @@ async function main() {
 	}
 	Object.assign(process.env, colorDepthEnv(process.env));
 	const [{ createTui }, { makeDeps }, { prepareTerminal }, { terminalOptions }] = await Promise.all([
-		import("../app-BLOyJcBh.js"),
+		import("../app-xXFNoDVu.js"),
 		import("../deps-WzqsHHiC.js"),
 		import("@mnmal-ai/surface-core/pure"),
 		import("../terminal-CVX2CKWu.js")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mnmal-ai/substrate-tui",
-  "version": "1.0.0-alpha.1",
+  "version": "1.0.0-alpha.11",
   "description": "Terminal UI for Substrate: ask in natural language, browse the schema, see the service status.",
   "license": "Apache-2.0",
   "repository": {
@@ -10,7 +10,7 @@
   },
   "type": "module",
   "bin": {
-    "substrate-tui": "dist/bin/tui.js"
+    "substrate-tui": "dist/bin/substrate-tui.js"
   },
   "files": [
     "dist"
@@ -20,17 +20,17 @@
     "access": "public"
   },
   "dependencies": {
-    "@mnmal-ai/substrate": "1.0.0-alpha.1",
-    "@mnmal-ai/substrate-nl": "1.0.0-alpha.1",
-    "@mnmal-ai/surface-core": "0.14.5",
-    "@mnmal-ai/surface-kit": "0.14.5",
-    "@mnmal-ai/surface-theme": "0.14.5",
-    "ink": "^7.1.1",
+    "@mnmal-ai/substrate": "1.0.0-alpha.11",
+    "@mnmal-ai/substrate-nl": "1.0.0-alpha.11",
+    "@mnmal-ai/surface-core": "0.15.0",
+    "@mnmal-ai/surface-kit": "0.15.0",
+    "@mnmal-ai/surface-theme": "0.15.0",
+    "ink": "^8.0.0",
     "react": "^19.3.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.5.15",
-    "@mnmal-ai/substrate-config": "1.0.0-alpha.1",
+    "@biomejs/biome": "2.6.4",
+    "@mnmal-ai/substrate-config": "1.0.0-alpha.11",
     "@types/node": "^26.6.4",
     "@types/react": "^19.2.0",
     "ink-testing-library": "^4.0.0",
@@ -40,7 +40,7 @@
     "vitest": "^5.0.3"
   },
   "engines": {
-    "node": ">=26.2.0"
+    "node": ">=26.12.1"
   },
   "scripts": {
     "build": "tsdown",