mu-agent 0.1.8 → 0.1.13

package/judge/themes/mu-dark.json

@@ -0,0 +1,80 @@
+{
+	"$schema": "https://pi.dev/schemas/theme.schema.json",
+	"name": "mu-dark",
+	"appearance": "dark",
+	"vars": {
+		"text": "#e6e6ec",
+		"muted": "#a1a1ad",
+		"dim": "#6e6e7a",
+		"violet": "#b2a4ff",
+		"pink": "#ff8ad8",
+		"blue": "#8fa2ff",
+		"green": "#4ade9b",
+		"red": "#ff6b81",
+		"amber": "#f5b544",
+		"rule": "#3a3a46"
+	},
+	"colors": {
+		"accent": "violet",
+		"border": "rule",
+		"borderAccent": "#8f7cf7",
+		"borderMuted": "#2a2a33",
+		"success": "green",
+		"error": "red",
+		"warning": "amber",
+		"muted": "muted",
+		"dim": "dim",
+		"text": "text",
+		"thinkingText": "#9a9aa6",
+		"selectedBg": "#2a2550",
+		"scrollbarTrack": "#26262e",
+		"scrollbarThumb": "dim",
+		"searchMatchBg": "#4a3a12",
+		"searchMatchText": "text",
+		"userMessageBg": "#17171d",
+		"userMessageText": "text",
+		"customMessageBg": "#1c1119",
+		"customMessageText": "muted",
+		"customMessageLabel": "pink",
+		"toolPendingBg": "#16161c",
+		"toolSuccessBg": "#10201a",
+		"toolErrorBg": "#2a1317",
+		"toolTitle": "text",
+		"toolOutput": "muted",
+		"mdHeading": "#d3caff",
+		"mdLink": "blue",
+		"mdLinkUrl": "dim",
+		"mdCode": "#c9beff",
+		"mdCodeBlock": "#d7d7df",
+		"mdCodeBlockBorder": "rule",
+		"mdQuote": "muted",
+		"mdQuoteBorder": "rule",
+		"mdHr": "rule",
+		"mdListBullet": "violet",
+		"toolDiffAdded": "green",
+		"toolDiffRemoved": "red",
+		"toolDiffContext": "dim",
+		"syntaxComment": "#7a7a86",
+		"syntaxKeyword": "#b9abff",
+		"syntaxFunction": "#9fb0ff",
+		"syntaxVariable": "text",
+		"syntaxString": "#ff9fdf",
+		"syntaxNumber": "#ffbd7a",
+		"syntaxType": "#6fd6d0",
+		"syntaxOperator": "muted",
+		"syntaxPunctuation": "muted",
+		"thinkingOff": "#5c5c66",
+		"thinkingMinimal": "#6e6e8a",
+		"thinkingLow": "#8585b8",
+		"thinkingMedium": "#9d8cff",
+		"thinkingHigh": "#c58cff",
+		"thinkingXhigh": "pink",
+		"thinkingMax": "red",
+		"bashMode": "green"
+	},
+	"export": {
+		"pageBg": "#0b0b0e",
+		"cardBg": "#121217",
+		"infoBg": "#2a2410"
+	}
+}

package/judge/themes/mu-light.json

@@ -0,0 +1,80 @@
+{
+	"$schema": "https://pi.dev/schemas/theme.schema.json",
+	"name": "mu-light",
+	"appearance": "light",
+	"vars": {
+		"text": "#18181c",
+		"muted": "#55555f",
+		"dim": "#85858f",
+		"violet": "#5b45db",
+		"pink": "#b42d86",
+		"blue": "#3d55c9",
+		"green": "#0e7f55",
+		"red": "#cc2f55",
+		"amber": "#9a5a06",
+		"rule": "#d4d4da"
+	},
+	"colors": {
+		"accent": "violet",
+		"border": "rule",
+		"borderAccent": "#7f6af0",
+		"borderMuted": "#e6e6ea",
+		"success": "green",
+		"error": "red",
+		"warning": "amber",
+		"muted": "muted",
+		"dim": "dim",
+		"text": "text",
+		"thinkingText": "#6a6a74",
+		"selectedBg": "#e6e1ff",
+		"scrollbarTrack": "#ececf0",
+		"scrollbarThumb": "#a6a6b0",
+		"searchMatchBg": "#fff0c2",
+		"searchMatchText": "text",
+		"userMessageBg": "#f3f3f0",
+		"userMessageText": "text",
+		"customMessageBg": "#fff4fb",
+		"customMessageText": "muted",
+		"customMessageLabel": "pink",
+		"toolPendingBg": "#f6f6f4",
+		"toolSuccessBg": "#eef8f2",
+		"toolErrorBg": "#fdf0f2",
+		"toolTitle": "text",
+		"toolOutput": "muted",
+		"mdHeading": "#3a2a96",
+		"mdLink": "blue",
+		"mdLinkUrl": "dim",
+		"mdCode": "violet",
+		"mdCodeBlock": "#2a2a30",
+		"mdCodeBlockBorder": "rule",
+		"mdQuote": "muted",
+		"mdQuoteBorder": "rule",
+		"mdHr": "rule",
+		"mdListBullet": "violet",
+		"toolDiffAdded": "green",
+		"toolDiffRemoved": "red",
+		"toolDiffContext": "dim",
+		"syntaxComment": "#6a6a73",
+		"syntaxKeyword": "violet",
+		"syntaxFunction": "#3f4dc0",
+		"syntaxVariable": "text",
+		"syntaxString": "pink",
+		"syntaxNumber": "#9a5208",
+		"syntaxType": "#0b767c",
+		"syntaxOperator": "muted",
+		"syntaxPunctuation": "muted",
+		"thinkingOff": "#a6a6b0",
+		"thinkingMinimal": "#8a8ab0",
+		"thinkingLow": "#6a6ad0",
+		"thinkingMedium": "violet",
+		"thinkingHigh": "#8a2fc0",
+		"thinkingXhigh": "pink",
+		"thinkingMax": "red",
+		"bashMode": "green"
+	},
+	"export": {
+		"pageBg": "#ffffff",
+		"cardBg": "#f7f7f5",
+		"infoBg": "#fff6dc"
+	}
+}

package/kyrn/bin/kyrn-doctor

@@ -87,13 +87,13 @@ if (layout === "package") {
 	row(
 		linked ? "ok" : "--",
 		"command",
-		linked ? linked.replaceAll(homedir(), "~") : `not on PATH yet: ${join(root, "kyrn", "bin", process.platform === "win32" ? "mu.cmd" : "mu")} link`,
+		linked ? linked.replaceAll(homedir(), "~") : `not on your PATH yet: run ${join(root, "kyrn", "bin", process.platform === "win32" ? "mu.cmd" : "mu")} link`,
 	);
 }
 
 row("--", "home", tilde(agentDir));
 if (home === ".kyrn" && agentDir.startsWith(join(homedir(), ".kyrn"))) {
-	row("--", "", "this home is from before the rename: `mu migrate` moves it to ~/.mu (`--dry-run` to look first)");
+	row("--", "", "this home folder predates the rename: `mu migrate` moves it to ~/.mu (add `--dry-run` to preview)");
 }
 // Only the size is looked at: pi writes an empty `{}` at its first start, and any stored login is far longer.
 let authBytes = 0;
@@ -112,23 +112,23 @@ row(
 	"model",
 	settings.defaultModel
 		? `${settings.defaultProvider ?? "?"}/${settings.defaultModel}${settings.defaultThinkingLevel ? ` · thinking ${settings.defaultThinkingLevel}` : ""}`
-		: "no default: the first provider with credentials is used. Pick one with /model, save with ctrl+s",
+		: "no default: mu uses the first provider with credentials. Pick one with /model and save it with ctrl+s",
 );
 
 const config = readJson(join(agentDir, "mu.json")) ?? readJson(join(agentDir, "kyrn.json"));
 const tiers = (env("JUDGE") ? env("JUDGE").split(",") : (config?.tiers ?? ["jev"])).map((tier) => tier.trim());
 const mode = env("JUDGE_MODE") ?? config?.modes?.default ?? "active";
-row("--", "judges", `${tiers.join(" > ")} · decisions ${mode}${env("JUDGE") ? " (from MU_JUDGE)" : ""}`);
+row("--", "judges", `${tiers.join(" > ")} · default mode ${mode}${env("JUDGE") ? " (from MU_JUDGE)" : ""}`);
 const overrides = Object.entries(config?.modes ?? {}).filter(([id]) => id !== "default");
 if (overrides.length > 0) row("--", "modes", overrides.map(([id, value]) => `${id}=${value}`).join(" "));
 const ladder = config?.features?.swarm?.models ?? [];
-row("--", "sub-agents", ladder.length > 0 ? `model ladder ${ladder.join(" < ")}` : "use the session's model (no ladder configured)");
+row("--", "subagents", ladder.length > 0 ? `model ladder ${ladder.join(" < ")}` : "use the session's model (no ladder configured)");
 
 const judgeSupport = localJudgeSupport({ platform: process.platform, env: process.env, wsl });
 if (tiers.some((tier) => tier.startsWith("laya")) && !judgeSupport.runs && !judgeSupport.url) {
 	// Not a failure of this installation: the sidecar is Core ML, and there is none for this platform.
-	row("--", "local judge", `not available on ${platformName({ platform: process.platform, wsl })}: the Laya sidecar is Core ML (macOS, Apple Silicon).`);
-	row("--", "", "laya's decisions fall back to the next judge or to pi's behaviour. Use jev, an llm judge, or MU_LOCAL_JUDGE_URL=<a server with the same contract>");
+	row("--", "local judge", `not available on ${platformName({ platform: process.platform, wsl })}: the Laya sidecar needs Core ML (macOS on Apple silicon)`);
+	row("--", "", "Laya's decision points use the next judge or their fallbacks. Use Jev, an LLM judge or MU_LOCAL_JUDGE_URL=<a server with the same API>");
 } else if (tiers.some((tier) => tier.startsWith("laya"))) {
 	const base = env("LOCAL_JUDGE_URL") ?? `http://127.0.0.1:${env("LOCAL_JUDGE_PORT") ?? 47823}`;
 	const startedAt = performance.now();
@@ -142,8 +142,8 @@ if (tiers.some((tier) => tier.startsWith("laya")) && !judgeSupport.runs && !judg
 			"fix",
 			"local judge",
 			judgeSupport.runs
-				? `${base} does not answer: mu judge start   (first time: mu judge setup)`
-				: `${base} (MU_LOCAL_JUDGE_URL) does not answer`,
+				? `${base} isn't answering: run mu judge start   (first time: mu judge setup)`
+				: `${base} (MU_LOCAL_JUDGE_URL) isn't answering`,
 		);
 	}
 }
@@ -192,7 +192,7 @@ if (jevTier) {
 			"jev key",
 			route
 				? `${route[0]} is set: ${route[1]} (value not shown)`
-				: `none set: Jev 1.13 on OpenCode Zen answers, free for a limited time (what it judges goes to OpenCode). For your own key, add TYPESAFE_API_KEY (or MU_JUDGE_OPENROUTER_API_KEY, AI_GATEWAY_API_KEY, OPENCODE_API_KEY) ${where}`,
+				: `none set: using Jev 1.13 on OpenCode Zen, free for a limited time (what the judge reads goes to OpenCode). To use your own key, add TYPESAFE_API_KEY (or MU_JUDGE_OPENROUTER_API_KEY, AI_GATEWAY_API_KEY, OPENCODE_API_KEY) ${where}`,
 		);
 	} else {
 		const name = judge.apiKeyEnv ?? (judge.type === "gateway" ? "AI_GATEWAY_API_KEY" : "TYPESAFE_API_KEY");
@@ -207,7 +207,7 @@ if (jevTier) {
 			has(name) && !unsent ? "ok" : "fix",
 			"jev key",
 			unsent
-				? `${jevTier} has no baseUrl: its key ${name} is only sent to the address it was set up for`
+				? `${jevTier} has no baseUrl, so its key ${name} isn't sent anywhere: add the address the key is for`
 				: has(name)
 					? `${name} is set: Jev is called ${via} (value not shown)`
 					: `missing: add ${name} ${where} (Jev is called ${via})`,
@@ -229,9 +229,9 @@ for (const model of new Set(askedTiers.map(classifierOf).filter((judge) => judge
 	// OpenCode's free models answer without a key (the client sends "public", as OpenCode's own does).
 	const names = provider === "opencode" && String(model).endsWith("-free") ? [] : CLASSIFIER_KEYS[provider];
 	if (!model?.includes("/")) {
-		row("fix", "classifier", `${model ?? "a classifier judge"} needs a model written "provider/model-id"`);
+		row("fix", "classifier", `${model ?? "a classifier judge"} needs a model in the form provider/model-id`);
 	} else if (!names) {
-		row("--", "classifier", `${model}: a provider of your own; its key is the one models.json names`);
+		row("--", "classifier", `${model}: a provider of your own: mu uses the key models.json names for it`);
 	} else if (names.every(has)) {
 		row("ok", "classifier", `${model}: ${names.length > 0 ? `${names.join(", ")} set (value not shown)` : "no key needed"}`);
 	} else {
@@ -268,15 +268,15 @@ for (const endpoint of new Set(clmJudges.map((judge) => clmEndpoint(judge.baseUr
 	} catch {}
 	const ms = Math.round(performance.now() - startedAt);
 	if (health?.ok !== true) {
-		row("fix", "clm", `${base} does not answer: start clm-serve there, or point the judge's baseUrl in mu.json at one`);
+		row("fix", "clm", `${base} isn't answering: start clm-serve there, or point the judge's baseUrl in mu.json at a running one`);
 		continue;
 	}
 	const served = Array.isArray(health.models) ? health.models : [];
 	const missing = [...new Set(judges.map((judge) => judge.model || "clm-latest"))].filter((model) => !served.includes(model));
 	if (health.embedder === false) {
-		row("fix", "clm", `${host} answers, but its encoder does not: every question fails until the embedding server is up`);
+		row("fix", "clm", `${host} answers, but its encoder doesn't: every question fails until the embedding server is up`);
 	} else if (missing.length > 0) {
-		row("fix", "clm", `${host} does not serve ${missing.join(", ")} (it serves ${served.join(", ")})`);
+		row("fix", "clm", `${host} doesn't serve ${missing.join(", ")} (it serves ${served.join(", ")})`);
 	} else {
 		row("ok", "clm", `${host} · ${served.join(", ")} · ${ms} ms`);
 	}
@@ -330,12 +330,37 @@ row(
 	"browse",
 	[browseTiers].flat().some(canRelate)
 		? `driven by ${[browseTiers].flat().join(" > ")}`
-		: 'needs a judge that can relate a goal to a page. In mu.json: "routes": { "browser.step": ["luna"] }',
+		: 'needs a judge that can match a goal to a page. In mu.json: "routes": { "browser.step": ["llm:openai/gpt-5.6-luna"] }',
 );
 
 const marks = { ok: "\x1b[32m ok\x1b[0m", fix: "\x1b[33mfix\x1b[0m", "--": "\x1b[2m  ·\x1b[0m" };
 const plain = !process.stdout.isTTY;
+/** Where a row's text starts: the mark, two spaces, the name's column. */
+const TEXT_COLUMN = 18;
+/** `text` broken between words into lines at most `size` wide; without a terminal, one line. */
+function wrap(text, size) {
+	if (!size || size < 20) return [text];
+	const lines = [];
+	let line = "";
+	for (const word of text.split(" ")) {
+		if (line && line.length + 1 + word.length > size) {
+			lines.push(line);
+			line = word;
+		} else line = line ? `${line} ${word}` : word;
+	}
+	return [...lines, line];
+}
+// In a terminal, what needs doing comes first, as in /doctor inside mu; piped, every line is a row.
+const fixes = rows.filter(([state]) => state === "fix").length;
+if (!plain) {
+	console.log(
+		fixes > 0 ? `mu doctor found ${fixes} ${fixes === 1 ? "thing" : "things"} to fix` : "mu doctor: everything is set up",
+	);
+}
 for (const [state, name, text] of rows) {
-	console.log(`${plain ? state.padStart(3) : marks[state]}  ${name.padEnd(13)}${text}`);
+	// In a terminal, a long row continues under its own text rather than at the left edge.
+	const [first, ...rest] = wrap(text, plain ? undefined : process.stdout.columns - TEXT_COLUMN - 1);
+	console.log(`${plain ? state.padStart(3) : marks[state]}  ${name.padEnd(13)}${first}`);
+	for (const line of rest) console.log(`${" ".repeat(TEXT_COLUMN)}${line}`);
 }
-process.exit(rows.some(([state]) => state === "fix") ? 1 : 0);
+process.exit(fixes > 0 ? 1 : 0);

package/kyrn/bin/kyrn-judge-local

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Manage the mu local judge sidecar (Laya on Core ML, Apple Silicon only).
+# Manage the mu local judge sidecar (Laya on Core ML, Apple silicon only).
 #
 #   kyrn/bin/kyrn-judge-local setup    create the venv, install pinned deps, download the weights (~680 MB)
 #   kyrn/bin/kyrn-judge-local start    start in the background if it is not already running
@@ -34,17 +34,17 @@ is_up() { [[ "$(health)" == *'"status"'* ]]; }
 
 require_setup() {
   if [[ ! -x "$PYTHON" || ! -f "$MODEL_DIR/coreml_config.json" ]]; then
-    echo "The local judge is not installed. Run: mu judge setup" >&2
+    echo "The local judge isn't installed yet. Run: mu judge setup" >&2
     exit 1
   fi
 }
 
 cmd_setup() {
   if [[ "$(uname -s)-$(uname -m)" != "Darwin-arm64" ]]; then
-    echo "laya-coreml needs Apple Silicon and macOS 15+." >&2
+    echo "The local judge needs a Mac with Apple silicon and macOS 15 or later." >&2
     exit 1
   fi
-  command -v uv >/dev/null || { echo "uv is required: https://docs.astral.sh/uv/" >&2; exit 1; }
+  command -v uv >/dev/null || { echo "mu judge setup needs uv: https://docs.astral.sh/uv/" >&2; exit 1; }
   mkdir -p "$STATE_DIR"
   [[ -x "$PYTHON" ]] || uv venv --python 3.12 "$STATE_DIR/.venv"
   # The official index on purpose: mirrors lag behind new releases.
@@ -72,7 +72,7 @@ from laya_coreml.artifacts import verify_files
 directory = Path(sys.argv[1])
 manifest = json.loads((directory / "coreml_config.json").read_text())
 verify_files(directory, manifest["files"])
-print(f"weights verified against the bundle manifest ({len(manifest['files'])} files)")
+print(f"Weights checked against the bundle's manifest ({len(manifest['files'])} files).")
 PY
 }
 
@@ -84,7 +84,7 @@ cmd_run() {
 cmd_start() {
   require_setup
   if is_up; then
-    echo "local judge already running at $URL"
+    echo "The local judge is already running at $URL."
     return 0
   fi
   mkdir -p "$RUN_DIR"
@@ -92,25 +92,25 @@ cmd_start() {
   echo $! >"$PID_FILE"
   for _ in $(seq 1 120); do
     if is_ready; then
-      echo "local judge ready at $URL (pid $(cat "$PID_FILE"), log $LOG_FILE)"
+      echo "The local judge is ready at $URL (pid $(cat "$PID_FILE"), log $LOG_FILE)."
       return 0
     fi
     if ! kill -0 "$(cat "$PID_FILE")" 2>/dev/null; then
-      echo "local judge exited during startup; see $LOG_FILE" >&2
+      echo "The local judge stopped while starting; see $LOG_FILE" >&2
       tail -5 "$LOG_FILE" >&2 || true
       return 1
     fi
     sleep 0.5
   done
-  echo "local judge is still warming up; see $LOG_FILE" >&2
+  echo "The local judge is still warming up; see $LOG_FILE" >&2
 }
 
 cmd_stop() {
   if [[ -f "$PID_FILE" ]] && kill -0 "$(cat "$PID_FILE")" 2>/dev/null; then
     kill "$(cat "$PID_FILE")"
-    echo "stopped local judge (pid $(cat "$PID_FILE"))"
+    echo "Stopped the local judge (pid $(cat "$PID_FILE"))."
   else
-    echo "local judge is not running"
+    echo "The local judge isn't running."
   fi
   rm -f "$PID_FILE"
 }
@@ -118,7 +118,35 @@ cmd_stop() {
 cmd_status() {
   local body
   body="$(health)"
-  if [[ -n "$body" ]]; then echo "$body"; else echo "local judge is not running at $URL"; return 1; fi
+  if [[ -z "$body" ]]; then echo "The local judge isn't running at $URL."; return 1; fi
+  # --json: the server's own answer, for scripts.
+  if [[ "${1:-}" == "--json" ]]; then echo "$body"; return 0; fi
+  URL="$URL" node -e '
+    let text = "";
+    process.stdin.on("data", (chunk) => (text += chunk)).on("end", () => {
+      let health;
+      try { health = JSON.parse(text); } catch { console.log(text.trim()); return; }
+      const up = Math.round((health.uptimeSeconds ?? 0) / 60);
+      const uptime = up < 60 ? `${up} min` : `${Math.floor(up / 60)} h ${up % 60} min`;
+      const state = health.status === "ok" ? "running" : `starting (${health.status})`;
+      const model = String(health.model ?? "").split("/").pop();
+      console.log(`The local judge is ${state} at ${process.env.URL}: ${model} on ${health.computeUnits}, pid ${health.pid}, up ${uptime}, ${health.requests} requests.`);
+    });' <<<"$body"
+}
+
+usage() {
+  cat <<'USAGE'
+mu judge: the local judge, Laya, on Core ML (macOS on Apple silicon).
+
+  mu judge setup           install it: a Python environment and the weights (about 680 MB)
+  mu judge start           start it in the background, unless it's already running
+  mu judge stop            stop it
+  mu judge status [--json] whether it's running, and what it serves
+  mu judge run             run it in the foreground
+
+One local judge serves every mu session on this machine. To have mu ask it, add "laya" to "tiers" in
+mu.json, or start mu with MU_JUDGE=laya.
+USAGE
 }
 
 case "${1:-status}" in
@@ -126,6 +154,7 @@ case "${1:-status}" in
   run) shift; cmd_run "$@" ;;
   start) cmd_start ;;
   stop) cmd_stop ;;
-  status) cmd_status ;;
-  *) echo "usage: mu judge setup|start|stop|status|run" >&2; exit 2 ;;
+  status) shift; cmd_status "$@" ;;
+  help | -h | --help) usage ;;
+  *) usage >&2; exit 2 ;;
 esac

package/kyrn/bin/kyrn-ledger

@@ -12,6 +12,20 @@ import { homedir } from "node:os";
 import { join } from "node:path";
 
 const args = process.argv.slice(2);
+if (args.includes("--help") || args.includes("-h")) {
+	console.log(
+		[
+			"mu ledger: the judge's verdicts from your recent sessions, each with the message it judged.",
+			"",
+			"  mu ledger            verdicts from the 5 most recent sessions",
+			"  mu ledger <n>        from the n most recent",
+			"  mu ledger --json     one JSON object per verdict, for scripts",
+			"",
+			"It reads the session files mu keeps on this machine; nothing is sent anywhere.",
+		].join("\n"),
+	);
+	process.exit(0);
+}
 const asJson = args.includes("--json");
 const limit = Number(args.find((arg) => /^\d+$/.test(arg)) ?? 5);
 /** `MU_<name>`, or the `KYRN_<name>` spelling from before the rename. */
@@ -87,4 +101,5 @@ for (const file of files) {
 	}
 }
 
-if (!asJson) console.log(count === 0 ? `No decisions found under ${sessionsDir}` : `\n${count} decisions from ${files.length} sessions`);
+const tilde = (path) => (path.startsWith(homedir()) ? `~${path.slice(homedir().length)}` : path);
+if (!asJson) console.log(count === 0 ? `No verdicts found under ${tilde(sessionsDir)}` : `\n${count} ${count === 1 ? "verdict" : "verdicts"} from ${files.length} ${files.length === 1 ? "session" : "sessions"}`);