mu-agent 0.1.13 → 0.1.14

package/kyrn/bin/kyrn-doctor

@@ -74,8 +74,12 @@ if (layout === "package") {
 		"dependencies",
 		installed
 			? "installed"
-			: `missing: cd ${root} && npm ci --ignore-scripts && npm run hydrate:model-data`,
+			: `missing: cd ${root} && npm ci --ignore-scripts && npm run hydrate:model-catalog`,
 	);
+	// The model list pi reads at its start is generated, not committed (installHint in mu.mjs).
+	if (installed && !existsSync(join(root, "packages", "ai", "src", "providers", "data", ".manifest.json"))) {
+		row("fix", "model list", `not generated: cd ${root} && npm run hydrate:model-catalog`);
+	}
 
 	// A link on POSIX, a small mu.cmd on Windows, where a link to a script cannot be run.
 	const linked = linkState({
@@ -118,14 +122,32 @@ row(
 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(" > ")} · default mode ${mode}${env("JUDGE") ? " (from MU_JUDGE)" : ""}`);
 const overrides = Object.entries(config?.modes ?? {}).filter(([id]) => id !== "default");
+// The modes mu sets out of the box besides the default, as packages/kyrn-judge/src/config.ts has them: one of these in
+// mu.json gives way to a default of off (DecisionEngine.getMode).
+const BUILT_IN_MODES = {
+	"swarm.patch": "off",
+	"capability.disclosure": "off",
+	"notify.routing": "shadow",
+	"input.interjection": "shadow",
+	"turn.drift": "shadow",
+};
+// Whether any decision point asks a judge (DecisionEngine.asksJudge). With none, nothing is sent to one, and the rows
+// about keys and judges that answer would only mislead.
+const asksJudge = mode !== "off" || overrides.some(([id, value]) => value !== "off" && BUILT_IN_MODES[id] !== value);
+row(
+	"--",
+	"judges",
+	`${tiers.join(" > ")} · default mode ${mode}${env("JUDGE") ? " (from MU_JUDGE)" : ""}${asksJudge ? "" : " · no decision point asks a judge, so nothing is sent to one"}`,
+);
 if (overrides.length > 0) row("--", "modes", overrides.map(([id, value]) => `${id}=${value}`).join(" "));
 const ladder = config?.features?.swarm?.models ?? [];
 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) {
+if (!asksJudge) {
+	// Nothing asks the local judge either: whether it is up does not matter.
+} else 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 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>");
@@ -175,7 +197,7 @@ const fromFile = existsSync(envFile) ? parseEnvFile(readFileSync(envFile, "utf8"
 const has = (name) => Boolean(process.env[name]) || fromFile.some(([key, value]) => key === name && value !== "");
 const where = `to ${tilde(envFile)} or to your environment`;
 const jevTier = tiers.find((tier) => ["jev", "typesafe", "gateway"].includes((config?.judges?.[tier] ?? JEV_ROUTES[tier])?.type));
-if (jevTier) {
+if (jevTier && asksJudge) {
 	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, OpenCode Zen,
@@ -220,10 +242,12 @@ 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());
+const askedTiers = asksJudge
+	? [
+			...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).
@@ -325,12 +349,16 @@ const canRelate = (tier) =>
 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(" · "));
+// mu's browser runs on the judge: with browser.step off it is switched off (src/extension/features/browser.ts).
+const browseMode = config?.modes?.["browser.step"] ?? mode;
 row(
-	[browseTiers].flat().some(canRelate) ? "ok" : "--",
+	browseMode !== "off" && [browseTiers].flat().some(canRelate) ? "ok" : "--",
 	"browse",
-	[browseTiers].flat().some(canRelate)
-		? `driven by ${[browseTiers].flat().join(" > ")}`
-		: 'needs a judge that can match a goal to a page. In mu.json: "routes": { "browser.step": ["llm:openai/gpt-5.6-luna"] }',
+	browseMode === "off"
+		? "off: mu's browser runs on the judge, and browser.step is off"
+		: [browseTiers].flat().some(canRelate)
+			? `driven by ${[browseTiers].flat().join(" > ")}`
+			: '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" };

package/kyrn/bin/mu.mjs

@@ -354,12 +354,26 @@ export function dependenciesInstalled({ root, platform, exists }) {
 	}
 }
 
-export function installHint({ root, platform }) {
-	const steps = [`cd ${root}`, "npm ci --ignore-scripts", "npm run hydrate:model-data"];
-	// Windows PowerShell 5 has no `&&`.
+/**
+ * Writes the model list pi reads at its start (packages/ai/src/providers/data, not committed) from the pinned catalog in
+ * the repository: offline and the same every time, as CI builds it.
+ */
+const HYDRATE = "npm run hydrate:model-catalog";
+
+/** A problem and the commands that fix it, one line to paste; Windows PowerShell 5 has no `&&`, so a list there. */
+function stepsHint(problem, steps, platform) {
 	return platform === "win32"
-		? `mu's dependencies aren't installed. Run:\n${steps.map((step) => `  ${step}`).join("\n")}`
-		: `mu's dependencies aren't installed. Run:  ${steps.join(" && ")}`;
+		? `${problem}. Run:\n${steps.map((step) => `  ${step}`).join("\n")}`
+		: `${problem}. Run:  ${steps.join(" && ")}`;
+}
+
+export function installHint({ root, platform }) {
+	return stepsHint("mu's dependencies aren't installed", [`cd ${root}`, "npm ci --ignore-scripts", HYDRATE], platform);
+}
+
+/** A checkout whose dependencies are in but whose model list was never written: a clone right after npm install. */
+export function modelDataHint({ root, platform }) {
+	return stepsHint("mu's list of models isn't generated in this checkout yet", [`cd ${root}`, HYDRATE], platform);
 }
 
 /** What mu says on a Node that does not strip TypeScript types, which a checkout cannot run on. */
@@ -372,12 +386,16 @@ const NO_TYPE_STRIPPING =
  * pi's own source resolver (packages/coding-agent/src/experimental/source-resolver.ts: each workspace package
  * resolves to its sources, as tsconfig.json's paths say) and Node's compile cache (compile-cache.mjs), the way pi
  * runs its own checkout (pi-test.sh). A runtime that does not strip types, a checkout whose dependencies are not
- * installed and one without the resolver are each said, not left to a failed import.
+ * installed or whose model list is not generated, and one without the resolver are each said, not left to a failed
+ * import.
  */
 export function sourceRuntime({ root, platform, stripsTypes, exists }) {
 	const path = pathFor(platform);
 	if (!stripsTypes) return { error: NO_TYPE_STRIPPING };
 	if (!dependenciesInstalled({ root, platform, exists })) return { error: installHint({ root, platform }) };
+	// Without it pi fails at its first import with ERR_MODULE_NOT_FOUND for a provider's .json.
+	if (!exists(path.join(root, "packages", "ai", "src", "providers", "data", ".manifest.json")))
+		return { error: modelDataHint({ root, platform }) };
 	const resolver = path.join(root, "packages", "coding-agent", "src", "experimental", "source-resolver.ts");
 	if (!exists(resolver)) return { error: `pi's source resolver is missing from this checkout (${resolver})` };
 	// As URLs: `--import` reads a Windows path such as C:\... as a URL whose scheme is c:.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mu-agent",
-	"version": "0.1.13",
+	"version": "0.1.14",
 	"description": "mu: a coding agent that hands its routine decisions to a small, fast judge model, so the main model can keep its attention on the work. Built on pi.",
 	"type": "module",
 	"bin": {
@@ -42,6 +42,6 @@
 	"muBuild": {
 		"pi": "1.3.0",
 		"judge": "0.1.0",
-		"commit": "47bdfac19"
+		"commit": "36ffdd935"
 	}
 }