mu-agent 0.1.7 → 0.1.10

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

@@ -8,6 +8,7 @@ import { homedir } from "node:os";
 import { join } from "node:path";
 import { pathToFileURL } from "node:url";
 import {
+	dependenciesInstalled,
 	detectWsl,
 	envFilePath,
 	findOnPath,
@@ -17,7 +18,6 @@ import {
 	packageEntries,
 	parseEnvFile,
 	platformName,
-	resolveTsx,
 } from "./mu.mjs";
 
 const [root, link] = process.argv.slice(2);
@@ -68,12 +68,11 @@ if (layout === "package") {
 	});
 	row(onPath ? "ok" : "fix", "command", onPath ? tilde(onPath) : "`mu` is not on PATH: add npm's global bin folder (npm prefix -g) to it");
 } else {
-	// The JavaScript behind tsx, which is what the launcher runs: node_modules/.bin holds a .cmd shim on Windows.
-	const tsx = resolveTsx({ root, platform: process.platform, exists: existsSync, readFile: (path) => readFileSync(path, "utf8") });
+	const installed = dependenciesInstalled({ root, platform: process.platform, exists: existsSync });
 	row(
-		tsx ? "ok" : "fix",
+		installed ? "ok" : "fix",
 		"dependencies",
-		tsx
+		installed
 			? "installed"
 			: `missing: cd ${root} && npm ci --ignore-scripts && npm run hydrate:model-data`,
 	);
@@ -88,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;
@@ -113,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 ?? "shadow";
-row("--", "judges", `${tiers.join(" > ")} · decisions ${mode}${env("JUDGE") ? " (from MU_JUDGE)" : ""}`);
+const mode = env("JUDGE_MODE") ?? config?.modes?.default ?? "active";
+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();
@@ -143,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`,
 		);
 	}
 }
@@ -155,6 +154,21 @@ const JEV_ROUTES = {
 	"jev-openrouter": { type: "typesafe", baseUrl: "https://openrouter.ai/api/v1/systemone", apiKeyEnv: "MU_JUDGE_OPENROUTER_API_KEY" },
 	"jev-gateway": { type: "gateway" },
 	gateway: { type: "gateway" },
+	"jev-opencode": { type: "classifier", model: "opencode/jev-1.13" },
+	"jev-opencode-free": { type: "classifier", model: "opencode/jev-1.13-free" },
+	"jev-cloudflare": { type: "classifier", model: "cloudflare-workers-ai/typesafe/jev" },
+	clef: { type: "classifier", model: "cloudflare-workers-ai/@cf/cloudflare/clef" },
+	"clef-flash": { type: "classifier", model: "cloudflare-workers-ai/@cf/cloudflare/clef-flash" },
+};
+// The variables pi reads a classifier provider's credentials from (packages/ai/src/env-api-keys.ts); a key stored
+// with /login or `mu auth` works as well. llama.cpp on this machine needs none.
+const CLASSIFIER_KEYS = {
+	opencode: ["OPENCODE_API_KEY"],
+	"cloudflare-workers-ai": ["CLOUDFLARE_API_KEY", "CLOUDFLARE_ACCOUNT_ID"],
+	openrouter: ["OPENROUTER_API_KEY"],
+	typesafe: ["TYPESAFE_API_KEY"],
+	"vercel-ai-gateway": ["AI_GATEWAY_API_KEY"],
+	"llama.cpp": [],
 };
 // Parsed the way the launcher parses it (quotes, `export `), and only asked whether a name has a value.
 const fromFile = existsSync(envFile) ? parseEnvFile(readFileSync(envFile, "utf8")).entries : [];
@@ -164,18 +178,21 @@ const jevTier = tiers.find((tier) => ["jev", "typesafe", "gateway"].includes((co
 if (jevTier) {
 	const judge = config?.judges?.[jevTier] ?? JEV_ROUTES[jevTier];
 	if (judge.type === "jev") {
-		// The order the registry tries: TypeSafe directly, Jev on OpenRouter, the Vercel AI Gateway.
+		// The order the registry tries: TypeSafe directly, Jev on OpenRouter, the Vercel AI Gateway, OpenCode Zen,
+		// Cloudflare Workers AI (key and account). With none of them, a gateway key kept with /login, else the free Jev.
 		const route = [
 			["TYPESAFE_API_KEY", "Jev is called directly at api.typesafe.ai"],
 			["MU_JUDGE_OPENROUTER_API_KEY", "Jev is called through OpenRouter"],
 			["AI_GATEWAY_API_KEY", "Jev is called through the Vercel AI Gateway"],
-		].find(([name]) => has(name));
+			["OPENCODE_API_KEY", "Jev is called on OpenCode Zen (jev-1.13)"],
+			["CLOUDFLARE_API_KEY", "Jev is called on Cloudflare Workers AI", "CLOUDFLARE_ACCOUNT_ID"],
+		].find(([name, , also]) => has(name) && (!also || has(also)));
 		row(
-			route ? "ok" : "fix",
+			route ? "ok" : "--",
 			"jev key",
 			route
 				? `${route[0]} is set: ${route[1]} (value not shown)`
-				: `missing: add TYPESAFE_API_KEY (or MU_JUDGE_OPENROUTER_API_KEY, or AI_GATEWAY_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");
@@ -190,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})`,
@@ -198,6 +215,35 @@ if (jevTier) {
 	}
 }
 
+// Classifier models of pi's catalog (Jev on OpenCode Zen or Cloudflare, Clef, …), for the tiers and routes that use them.
+const classifierOf = (tier) =>
+	tier.startsWith("classifier:")
+		? { type: "classifier", model: tier.slice("classifier:".length) }
+		: (config?.judges?.[tier] ?? JEV_ROUTES[tier]);
+const askedTiers = [
+	...tiers,
+	...Object.values(config?.routes ?? {}).flatMap((value) => (Array.isArray(value) ? value : String(value).split(","))),
+].map((tier) => String(tier).trim());
+for (const model of new Set(askedTiers.map(classifierOf).filter((judge) => judge?.type === "classifier").map((judge) => judge.model))) {
+	const provider = String(model ?? "").split("/")[0];
+	// 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 in the form provider/model-id`);
+	} else if (!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 {
+		const unset = names.filter((name) => !has(name));
+		row(
+			authBytes > 8 ? "--" : "fix",
+			"classifier",
+			`${model}: ${unset.join(" and ")} not set${authBytes > 8 ? `; a key stored with /login ${provider} works too (not read here)` : `: add ${unset.join(", ")} ${where}, or store a key with /login ${provider}`}`,
+		);
+	}
+}
+
 // CLM-8B behind `clm-serve` (github.com/Contrastive-LM/CLM), for the tiers and routes that use it.
 /** As packages/kyrn-judge/src/providers/typesafe.ts reads a CLM address: `http://host:8700` is enough. */
 function clmEndpoint(baseUrl) {
@@ -222,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`);
 	}
@@ -271,7 +317,11 @@ row(
 );
 for (const line of moreAdvice) row("--", "", line);
 const canRelate = (tier) =>
-	tier.startsWith("jev") || tier === "gateway" || tier.startsWith("llm:") || ["llm", "clm"].includes(judgeOf(tier)?.type);
+	tier.startsWith("jev") ||
+	tier === "gateway" ||
+	tier.startsWith("llm:") ||
+	tier.startsWith("classifier:") ||
+	["llm", "clm", "classifier"].includes(judgeOf(tier)?.type);
 const browseTiers = config?.routes?.["browser.step"] ?? tiers;
 const routed = Object.entries(config?.routes ?? {});
 if (routed.length > 0) row("--", "routes", routed.map(([id, value]) => `${id} -> ${[value].flat().join(" > ")}`).join(" · "));
@@ -280,7 +330,7 @@ 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-codex/gpt-5.6-luna"] }',
 );
 
 const marks = { ok: "\x1b[32m ok\x1b[0m", fix: "\x1b[33mfix\x1b[0m", "--": "\x1b[2m  ·\x1b[0m" };

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
@@ -41,7 +41,7 @@ require_setup() {
 
 cmd_setup() {
   if [[ "$(uname -s)-$(uname -m)" != "Darwin-arm64" ]]; then
-    echo "laya-coreml needs Apple Silicon and macOS 15+." >&2
+    echo "laya-coreml needs Apple silicon and macOS 15+." >&2
     exit 1
   fi
   command -v uv >/dev/null || { echo "uv is required: https://docs.astral.sh/uv/" >&2; exit 1; }

package/kyrn/bin/kyrn-ledger

@@ -87,4 +87,4 @@ for (const file of files) {
 	}
 }
 
-if (!asJson) console.log(count === 0 ? `No decisions found under ${sessionsDir}` : `\n${count} decisions from ${files.length} sessions`);
+if (!asJson) console.log(count === 0 ? `No verdicts found under ${sessionsDir}` : `\n${count} ${count === 1 ? "verdict" : "verdicts"} from ${files.length} ${files.length === 1 ? "session" : "sessions"}`);