mu-agent 0.1.4 → 0.1.7

package/kyrn/bin/mu.mjs

@@ -9,7 +9,7 @@
 // - npm's own `mu` command, in the npm package mu-agent (kyrn/npm/build.mjs). The package is laid out like the
 //   repository, so this file is at kyrn/bin/mu.mjs there too, and the root is two folders up in both.
 //
-// No dependency and no TypeScript here: this runs before tsx has been found.
+// No dependency and no TypeScript here: this runs before anything that could run TypeScript has been found.
 //
 // Every decision is an exported function that takes the platform, the environment and the file system as
 // parameters and returns what would be done. There is no Windows machine where this is developed, so the
@@ -46,7 +46,7 @@ import {
 } from "node:fs";
 import { homedir, constants as osConstants } from "node:os";
 import nodePath from "node:path";
-import { fileURLToPath } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 
 /** pi's minimum. */
 export const MIN_NODE = [22, 19];
@@ -100,6 +100,8 @@ export function usage(platform) {
 		'  mu "prompt"              interactive, starting with this prompt',
 		'  mu -p "prompt"           one-shot: print the answer and exit',
 		"  mu -c | -r               continue the last session | pick one to resume",
+		"  mu setup                 connect a model (an API key, or a service from a list) and choose the judge",
+		"                           (mu setup --help: scripts, a key from stdin, the services it knows)",
 		"  mu judge <cmd>           the local judge (Laya): setup | start | stop | status | run",
 		"  mu ledger [n] [--json]   what the judge decided in the last n sessions",
 		"  mu import --list | <file>...   bring Claude Code and Codex conversations into mu (mu import --help)",
@@ -306,7 +308,7 @@ export function ensureAppView({ platform, app, upstream, fs = realFs }) {
 // ---------------------------------------------------------------------------------------------------------
 
 /**
- * Where this mu comes from: "repo", a checkout that runs the TypeScript sources through tsx, or "package", the
+ * Where this mu comes from: "repo", a checkout that runs the TypeScript sources (sourceRuntime), or "package", the
  * npm package mu-agent, which carries pi's bundle (dist/bundle/cli.js) and the judgment layer built to
  * JavaScript (judge/dist/kyrn-judge.js). A checkout without its dependencies is still a checkout.
  */
@@ -316,7 +318,10 @@ export function layoutOf({ root, platform, exists }) {
 	return exists(path.join(root, "dist", "bundle", "cli.js")) ? "package" : "repo";
 }
 
-/** The files the npm package runs: pi, the judgment layer, the sign-in of `mu auth` and the importer of `mu import`. */
+/**
+ * The files the npm package runs: pi, the judgment layer, the sign-in of `mu auth`, the importer of `mu import` and the
+ * wizard of `mu setup`.
+ */
 export function packageEntries({ root, platform }) {
 	const path = pathFor(platform);
 	return {
@@ -324,6 +329,7 @@ export function packageEntries({ root, platform }) {
 		extension: path.join(root, "judge", "dist", "kyrn-judge.js"),
 		auth: path.join(root, "judge", "dist", "auth.js"),
 		import: path.join(root, "judge", "dist", "import.js"),
+		setup: path.join(root, "judge", "dist", "setup.js"),
 	};
 }
 
@@ -370,6 +376,35 @@ export function installHint({ root, platform }) {
 		: `mu's dependencies are not installed. Run:  ${steps.join(" && ")}`;
 }
 
+/**
+ * Node's arguments for running a checkout's TypeScript, up to the entry file. A Node that strips types itself (on
+ * by default from 22.18) runs the sources as they are, with 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). tsx runs its loader on a thread of its
+ * own and hands every file over from there: pi with the judgment layer took 2 s to start that way, about 0.85 s
+ * this way, and a checkout starts mu for every conversation the desktop app opens. A runtime that does not strip
+ * types (`stripsTypes` false; an Electron that runs mu as Node may not), or a checkout from before the resolver,
+ * still goes through tsx. tsx is one of the checkout's dependencies either way: without it they are not installed.
+ */
+export function sourceRuntime({ root, platform, stripsTypes, exists, readFile }) {
+	const path = pathFor(platform);
+	const tsx = resolveTsx({ root, platform, exists, readFile });
+	if (!tsx) return { error: installHint({ root, platform }) };
+	const resolver = path.join(root, "packages", "coding-agent", "src", "experimental", "source-resolver.ts");
+	if (!stripsTypes || !exists(resolver)) return { args: [tsx, "--tsconfig", path.join(root, "tsconfig.json")] };
+	// As URLs: `--import` reads a Windows path such as C:\... as a URL whose scheme is c:.
+	const url = (file) => pathToFileURL(file, { windows: platform === "win32" }).href;
+	return {
+		args: [
+			"--disable-warning=ExperimentalWarning",
+			"--import",
+			url(path.join(root, "kyrn", "bin", "compile-cache.mjs")),
+			"--import",
+			url(resolver),
+		],
+	};
+}
+
 /**
  * pi reads <APP NAME>_CODING_AGENT_DIR and nothing else, so with the app named mu that export decides the
  * home. The pi and KYRN spellings are exported too, for scripts that still read them.
@@ -429,7 +464,18 @@ export function launchStrategy({ platform, env, canExec }) {
  *
  * `fs` is { exists, isDir, readFile }. Returns { error } when pi cannot be started.
  */
-export function planLaunch({ platform, env, argv, root, home, execPath, fs, canExec = false, wsl = false }) {
+export function planLaunch({
+	platform,
+	env,
+	argv,
+	root,
+	home,
+	execPath,
+	fs,
+	canExec = false,
+	wsl = false,
+	stripsTypes = true,
+}) {
 	const path = pathFor(platform);
 	const layout = layoutOf({ root, platform, exists: fs.exists });
 	let entry;
@@ -440,12 +486,10 @@ export function planLaunch({ platform, env, argv, root, home, execPath, fs, canE
 		}
 		entry = [files.cli, "-e", files.extension];
 	} else {
-		const tsx = resolveTsx({ root, platform, exists: fs.exists, readFile: fs.readFile });
-		if (!tsx) return { error: installHint({ root, platform }) };
+		const runtime = sourceRuntime({ root, platform, stripsTypes, exists: fs.exists, readFile: fs.readFile });
+		if (runtime.error) return { error: runtime.error };
 		entry = [
-			tsx,
-			"--tsconfig",
-			path.join(root, "tsconfig.json"),
+			...runtime.args,
 			path.join(root, "packages", "coding-agent", "src", "experimental", "cli.ts"),
 			"-e",
 			path.join(root, "packages", "kyrn-judge", "src", "extension", "kyrn-judge.ts"),
@@ -510,6 +554,101 @@ export function planLaunch({ platform, env, argv, root, home, execPath, fs, canE
 	};
 }
 
+/**
+ * Everything about running pi inside a process of another program, such as the desktop app's runtime host, decided
+ * as planLaunch decides it and without touching anything: the module to import pi's `setupCli` and `main` from, the
+ * Node flags that process starts with, pi's arguments (the judgment layer, then `argv`) and its whole environment.
+ * The app's pi and the command line's are then one: the same files, settings, sign-ins and keys.
+ *
+ * A checkout runs in such a process only on a Node that strips TypeScript types itself, with pi's source resolver:
+ * tsx cannot be put in front of a module another program imports. Returns { error } otherwise.
+ */
+export function planHost({ platform, env, argv, root, home, fs, wsl = false, stripsTypes = true }) {
+	const path = pathFor(platform);
+	const launch = planLaunch({ platform, env, argv, root, home, execPath: "", fs, wsl, stripsTypes });
+	if (launch.error !== undefined) return { error: launch.error };
+	const common = {
+		env: launch.env,
+		layout: launch.layout,
+		muDir: launch.muDir,
+		appDir: launch.appDir,
+		agentDir: launch.agentDir,
+		startJudge: launch.startJudge,
+		notes: launch.notes,
+	};
+	if (launch.layout === "package") {
+		return {
+			...common,
+			module: path.join(root, "dist", "bundle", "index.js"),
+			execArgv: [],
+			args: ["-e", packageEntries({ root, platform }).extension, ...argv],
+		};
+	}
+	const resolver = path.join(root, "packages", "coding-agent", "src", "experimental", "source-resolver.ts");
+	if (!stripsTypes || !fs.exists(resolver)) {
+		return {
+			error: `pi's sources run inside another program only on a Node that strips TypeScript types itself (22.18 or newer), with pi's source resolver (${resolver})`,
+		};
+	}
+	const runtime = sourceRuntime({ root, platform, stripsTypes, exists: fs.exists, readFile: fs.readFile });
+	if (runtime.error) return { error: runtime.error };
+	return {
+		...common,
+		module: path.join(root, "packages", "coding-agent", "src", "index.ts"),
+		execArgv: runtime.args,
+		args: ["-e", path.join(root, "packages", "kyrn-judge", "src", "extension", "kyrn-judge.ts"), ...argv],
+	};
+}
+
+/** What mu says when the local judge does not come up. */
+const LOCAL_JUDGE_NOT_STARTED =
+	"mu: the local judge did not start (mu judge status); decisions fall back to pi's behaviour";
+
+/** The part of the preparation that is files: the app view of a checkout, mu's agent folder, the configuration's notes. */
+function prepareFiles({ plan, platform, root, err }) {
+	const path = pathFor(platform);
+	if (plan.layout === "repo") {
+		ensureAppView({ platform, app: plan.appDir, upstream: path.join(root, "packages", "coding-agent") });
+	}
+	mkdirSync(plan.agentDir, { recursive: true });
+	for (const note of plan.notes) err(note);
+}
+
+/**
+ * What is done before pi starts, for the command line and the desktop app's runtime host alike: the app view that
+ * names a checkout mu, mu's agent folder, the configuration's notes (to `err`), and the local judge when the
+ * configuration asks for it. `bin` is this launcher's folder. The local judge is one shared sidecar: starting it is
+ * idempotent and never blocks pi.
+ */
+export function prepareLaunch({ plan, platform, root, bin, err }) {
+	prepareFiles({ plan, platform, root, err });
+	if (plan.startJudge) {
+		const started = spawnSync(pathFor(platform).join(bin, "kyrn-judge-local"), ["start"], {
+			stdio: "ignore",
+			env: plan.env,
+		});
+		if (started.status !== 0) err(LOCAL_JUDGE_NOT_STARTED);
+	}
+}
+
+/**
+ * prepareLaunch for a program that must not stop while the local judge starts, such as the desktop app's main process:
+ * the same steps and notes, with the local judge started through a child process it waits for without blocking.
+ */
+export async function prepareLaunchAsync({ plan, platform, root, bin, err }) {
+	prepareFiles({ plan, platform, root, err });
+	if (!plan.startJudge) return;
+	const status = await new Promise((resolve) => {
+		const child = spawn(pathFor(platform).join(bin, "kyrn-judge-local"), ["start"], {
+			stdio: "ignore",
+			env: plan.env,
+		});
+		child.once("error", () => resolve(null));
+		child.once("close", (code) => resolve(code));
+	});
+	if (status !== 0) err(LOCAL_JUDGE_NOT_STARTED);
+}
+
 // ---------------------------------------------------------------------------------------------------------
 // mu auth
 // ---------------------------------------------------------------------------------------------------------
@@ -520,9 +659,9 @@ export const AUTH_COMMANDS = ["status", "login", "logout"];
 /**
  * `mu auth status | login <provider> | logout <provider>`: the sign-in the desktop app runs, with pi's own OAuth
  * flows and credential store (packages/kyrn-judge/src/auth). It is pi's code, so it runs the way pi does here:
- * through tsx in a checkout, built in the package. It reads no key, so no .env is read for it.
+ * from its sources in a checkout (sourceRuntime), built in the package. It reads no key, so no .env is read for it.
  */
-export function planAuth({ platform, env, argv, root, home, execPath, fs, canExec = false }) {
+export function planAuth({ platform, env, argv, root, home, execPath, fs, canExec = false, stripsTypes = true }) {
 	const path = pathFor(platform);
 	let entry;
 	if (layoutOf({ root, platform, exists: fs.exists }) === "package") {
@@ -532,10 +671,9 @@ export function planAuth({ platform, env, argv, root, home, execPath, fs, canExe
 		}
 		entry = [auth];
 	} else {
-		const tsx = resolveTsx({ root, platform, exists: fs.exists, readFile: fs.readFile });
-		if (!tsx) return { error: installHint({ root, platform }) };
-		const main = path.join(root, "packages", "kyrn-judge", "src", "auth", "main.ts");
-		entry = [tsx, "--tsconfig", path.join(root, "tsconfig.json"), main];
+		const runtime = sourceRuntime({ root, platform, stripsTypes, exists: fs.exists, readFile: fs.readFile });
+		if (runtime.error) return { error: runtime.error };
+		entry = [...runtime.args, path.join(root, "packages", "kyrn-judge", "src", "auth", "main.ts")];
 	}
 	const agentDir = agentDirFor({ env, muDir: muHome({ home, platform, isDir: fs.isDir }), platform });
 	const childEnv = {};
@@ -598,6 +736,178 @@ export function planImport({ platform, env, argv, root, home, execPath, fs, stri
 	return { command: execPath, args: [...entry, ...argv], env: childEnv, agentDir };
 }
 
+// ---------------------------------------------------------------------------------------------------------
+// mu setup
+// ---------------------------------------------------------------------------------------------------------
+
+/** What a "no" to the first-start question leaves in the agent folder (packages/kyrn-judge/src/setup/wizard.ts). */
+export const SETUP_DECLINED_FILE = "setup-declined";
+
+/** How `mu setup` says: set up, and start a session now. */
+export const SETUP_EXIT_START = 3;
+
+/** How `mu setup` says it was cancelled (ctrl+c): a first start then goes no further. */
+export const SETUP_EXIT_CANCELLED = 130;
+
+/** The options of `mu setup` that take a value (wizard.ts keeps the same list): the word after one is not a key. */
+export const SETUP_VALUE_FLAGS = ["--service", "--model", "--base-url", "--api", "--name", "--judge"];
+
+/**
+ * The environment variables that give pi a model on their own: packages/ai/src/env-api-keys.ts, which a test holds this
+ * list to, and AWS_BEARER_TOKEN_BEDROCK, which is there for nothing else. TYPESAFE_API_KEY is left out, as pi's
+ * typesafe provider has classifiers only (the key is Jev's). So are AWS profiles and Google Cloud's default
+ * credentials: many machines have them for other work.
+ */
+export const MODEL_KEY_VARIABLES = [
+	"COPILOT_GITHUB_TOKEN",
+	"ANTHROPIC_AUTH_TOKEN",
+	"ANTHROPIC_OAUTH_TOKEN",
+	"ANTHROPIC_API_KEY",
+	"ANT_LING_API_KEY",
+	"QWEN_TOKEN_PLAN_API_KEY",
+	"QWEN_TOKEN_PLAN_CN_API_KEY",
+	"OPENAI_API_KEY",
+	"AZURE_OPENAI_API_KEY",
+	"NVIDIA_API_KEY",
+	"DEEPSEEK_API_KEY",
+	"GEMINI_API_KEY",
+	"GOOGLE_CLOUD_API_KEY",
+	"GROQ_API_KEY",
+	"CEREBRAS_API_KEY",
+	"XAI_API_KEY",
+	"RADIUS_API_KEY",
+	"OPENROUTER_API_KEY",
+	"AI_GATEWAY_API_KEY",
+	"ZAI_API_KEY",
+	"ZAI_CODING_CN_API_KEY",
+	"MISTRAL_API_KEY",
+	"MINIMAX_API_KEY",
+	"MINIMAX_CN_API_KEY",
+	"MOONSHOT_API_KEY",
+	"HF_TOKEN",
+	"FIREWORKS_API_KEY",
+	"TOGETHER_API_KEY",
+	"BASETEN_API_KEY",
+	"OPENCODE_API_KEY",
+	"KIMI_API_KEY",
+	"META_API_KEY",
+	"CLOUDFLARE_API_KEY",
+	"XIAOMI_API_KEY",
+	"XIAOMI_TOKEN_PLAN_CN_API_KEY",
+	"XIAOMI_TOKEN_PLAN_AMS_API_KEY",
+	"XIAOMI_TOKEN_PLAN_SGP_API_KEY",
+	"AWS_BEARER_TOKEN_BEDROCK",
+];
+
+/**
+ * `mu setup`: the wizard that connects a model and chooses the judge (packages/kyrn-judge/src/setup). It is pi's code,
+ * so it runs the way `mu auth` runs: from the sources in a checkout, built in the package. A key on the command line
+ * (`mu setup <key>`) goes to the wizard in the environment, MU_SETUP_KEY, never in its argv, which every process on
+ * the machine can read. The launcher waits for the wizard, since a finished setup may go on into a session.
+ */
+export function planSetup({ platform, env, argv, root, home, execPath, fs, stripsTypes = true }) {
+	const path = pathFor(platform);
+	const layout = layoutOf({ root, platform, exists: fs.exists });
+	let entry;
+	if (layout === "package") {
+		const { setup } = packageEntries({ root, platform });
+		if (!fs.exists(setup)) {
+			return { error: `This mu-agent package has no mu setup (${setup} is missing). Update it: npm i -g mu-agent` };
+		}
+		entry = [setup];
+	} else {
+		const runtime = sourceRuntime({ root, platform, stripsTypes, exists: fs.exists, readFile: fs.readFile });
+		if (runtime.error) return { error: runtime.error };
+		entry = [...runtime.args, path.join(root, "packages", "kyrn-judge", "src", "setup", "main.ts")];
+	}
+	const args = [];
+	let key;
+	for (let index = 0; index < argv.length; index++) {
+		const arg = argv[index];
+		if (SETUP_VALUE_FLAGS.includes(arg)) {
+			args.push(arg);
+			if (index + 1 < argv.length) args.push(argv[++index]);
+		} else if (arg.startsWith("-") || arg === "help") args.push(arg);
+		else if (key === undefined) key = arg;
+		else return { error: "mu setup takes one key at most (mu setup --help)", code: 2 };
+	}
+	const muDir = muHome({ home, platform, isDir: fs.isDir });
+	const agentDir = agentDirFor({ env, muDir, platform });
+	const childEnv = {};
+	for (const [name, value] of Object.entries(env)) if (typeof value === "string") childEnv[name] = value;
+	if (key !== undefined) childEnv.MU_SETUP_KEY = key;
+	childEnv.MU_AGENT_DIR = agentDir;
+	childEnv.MU_CODING_AGENT_DIR = agentDir;
+	childEnv.KYRN_CODING_AGENT_DIR = agentDir;
+	childEnv.PI_CODING_AGENT_DIR = agentDir;
+	childEnv.MU_SETUP_HOME = muDir;
+	// The .env a session gets: the wizard writes the Jev key there, and reads a proxy from it.
+	childEnv.MU_SETUP_ENV_FILE = envFilePath({ layout, root, muDir, platform });
+	return { command: execPath, args: [...entry, ...args], env: childEnv, strategy: "spawn", agentDir, keyGiven: key !== undefined };
+}
+
+/** pi's own commands: none of them starts a session. */
+const PI_COMMANDS = new Set(["install", "remove", "uninstall", "update", "list", "config", "auth"]);
+/** Options for a run without a person (-p, --mode rpc), one that ends at once, or one that names its model itself. */
+const NO_SETUP_FLAGS = new Set([
+	"-p",
+	"--print",
+	"--mode",
+	"-h",
+	"--help",
+	"-v",
+	"--version",
+	"--list-models",
+	"--export",
+	"--api-key",
+	"--provider",
+	"--model",
+	"--models",
+]);
+
+/**
+ * Whether `mu` offers to set up a model before a session: only to a person at a terminal (stdin and stdout) who starts
+ * a session, on a machine where nothing gives mu a model yet, and who has not answered no before (SETUP_DECLINED_FILE)
+ * or turned the question off (MU_NO_SETUP=1). Nothing gives a model: no credential in auth.json, no provider in
+ * models.json, no default provider in settings.json, no key of MODEL_KEY_VARIABLES in the environment or the .env.
+ * A file that cannot be read counts as set up: the question is for an empty home, never for a broken one.
+ *
+ * `fs` is { exists, readFile }; `envText` is the .env the launcher reads, when there is one.
+ */
+export function planFirstRun({ platform, env, argv, interactive, agentDir, envText, fs }) {
+	if (!interactive) return false;
+	const off = muEnv("NO_SETUP", env);
+	if (off && off !== "0" && off.toLowerCase() !== "false") return false;
+	if (argv[0] !== undefined && PI_COMMANDS.has(argv[0])) return false;
+	if (argv.some((arg) => NO_SETUP_FLAGS.has(arg.split("=")[0]))) return false;
+	const path = pathFor(platform);
+	if (fs.exists(path.join(agentDir, SETUP_DECLINED_FILE))) return false;
+	const read = (name) => {
+		const file = path.join(agentDir, name);
+		if (!fs.exists(file)) return {};
+		try {
+			const text = fs.readFile(file).replace(/^/, "");
+			const value = text.trim() ? JSON.parse(text) : {};
+			return value && typeof value === "object" && !Array.isArray(value) ? value : undefined;
+		} catch {
+			return undefined;
+		}
+	};
+	const auth = read("auth.json");
+	if (!auth || Object.keys(auth).length > 0) return false;
+	const models = read("models.json");
+	const providers = models?.providers;
+	if (!models || (providers && typeof providers === "object" && Object.keys(providers).length > 0)) return false;
+	const settings = read("settings.json");
+	if (!settings || settings.defaultProvider) return false;
+	if (MODEL_KEY_VARIABLES.some((name) => env[name])) return false;
+	if (envText !== undefined) {
+		const { entries } = parseEnvFile(envText);
+		if (entries.some(([name, value]) => value && MODEL_KEY_VARIABLES.includes(name))) return false;
+	}
+	return true;
+}
+
 // ---------------------------------------------------------------------------------------------------------
 // mu link | unlink
 // ---------------------------------------------------------------------------------------------------------
@@ -1047,6 +1357,7 @@ export async function main(argv = process.argv.slice(2)) {
 			home,
 			execPath: process.execPath,
 			canExec,
+			stripsTypes: Boolean(process.features.typescript),
 			fs: { exists: existsSync, isDir, readFile: readText },
 		});
 		if (plan.error) {
@@ -1124,6 +1435,30 @@ export async function main(argv = process.argv.slice(2)) {
 		}
 		return handOver({ command: plan.command, args: plan.args, env: plan.env, strategy });
 	}
+	// What the session gets, when there is one: after a `mu setup` that ends in "start mu now", a plain session.
+	let sessionArgv = argv;
+	if (command === "setup") {
+		const plan = planSetup({
+			platform,
+			env,
+			argv: rest,
+			root,
+			home,
+			execPath: process.execPath,
+			stripsTypes: Boolean(process.features.typescript),
+			fs: { exists: existsSync, isDir, readFile: readText },
+		});
+		if (plan.error) {
+			err(plan.error);
+			return plan.code ?? 1;
+		}
+		// The key leaves this process's own command line too, as far as the platform lets a process rewrite it.
+		if (plan.keyGiven) process.title = "mu setup";
+		mkdirSync(plan.agentDir, { recursive: true });
+		const code = await handOver(plan);
+		if (code !== SETUP_EXIT_START) return code;
+		sessionArgv = [];
+	}
 	if (command === "doctor") {
 		const link = linkPath({ platform, env, home });
 		return handOver({
@@ -1184,15 +1519,51 @@ export async function main(argv = process.argv.slice(2)) {
 		return 0;
 	}
 
+	// A first start with nothing to work with: one question, and the wizard, before the session (`mu setup`). Never
+	// right after `mu setup` itself: its subscription route leaves nothing written, and the person was just asked.
+	const muDir = muHome({ home, platform, isDir });
+	let envText;
+	try {
+		envText = readText(envFilePath({ layout, root, muDir, platform }));
+	} catch {}
+	const firstRun = command !== "setup" && planFirstRun({
+		platform,
+		env,
+		argv: sessionArgv,
+		interactive: Boolean(process.stdin.isTTY && process.stdout.isTTY),
+		agentDir: agentDirFor({ env, muDir, platform }),
+		envText,
+		fs: { exists: existsSync, readFile: readText },
+	});
+	if (firstRun) {
+		const setup = planSetup({
+			platform,
+			env,
+			argv: ["--first-run"],
+			root,
+			home,
+			execPath: process.execPath,
+			stripsTypes: Boolean(process.features.typescript),
+			fs: { exists: existsSync, isDir, readFile: readText },
+		});
+		if (!setup.error) {
+			mkdirSync(setup.agentDir, { recursive: true });
+			// Whatever the wizard ends with, the session follows (pi says itself when there is no model), unless it was cancelled.
+			if ((await handOver(setup)) === SETUP_EXIT_CANCELLED) return SETUP_EXIT_CANCELLED;
+		}
+	}
+
+	// Planned after the wizard: what it wrote into the .env (the Jev key) goes to the session too.
 	const plan = planLaunch({
 		platform,
 		env,
-		argv,
+		argv: sessionArgv,
 		root,
 		home,
 		execPath: process.execPath,
 		canExec,
 		wsl,
+		stripsTypes: Boolean(process.features.typescript),
 		fs: { exists: existsSync, isDir, readFile: readText },
 	});
 	if (plan.error) {
@@ -1200,18 +1571,7 @@ export async function main(argv = process.argv.slice(2)) {
 		return 1;
 	}
 
-	if (plan.layout === "repo") {
-		ensureAppView({ platform, app: plan.appDir, upstream: path.join(root, "packages", "coding-agent") });
-	}
-	mkdirSync(plan.agentDir, { recursive: true });
-	for (const note of plan.notes) err(note);
-	// The local judge is one shared sidecar; starting it is idempotent and must never block mu.
-	if (plan.startJudge) {
-		const started = spawnSync(path.join(bin, "kyrn-judge-local"), ["start"], { stdio: "ignore", env: plan.env });
-		if (started.status !== 0) {
-			err("mu: the local judge did not start (mu judge status); decisions fall back to pi's behaviour");
-		}
-	}
+	prepareLaunch({ plan, platform, root, bin, err });
 	if (plan.preface) out(plan.preface);
 	return handOver(plan);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mu-agent",
-	"version": "0.1.4",
+	"version": "0.1.7",
 	"description": "mu: a coding agent that thinks before it acts. A small, fast judge makes the routine calls; the big model keeps its attention for the work. Built on pi.",
 	"type": "module",
 	"bin": {
@@ -33,13 +33,13 @@
 		"node": ">=22.19.0"
 	},
 	"dependencies": {
-		"@earendil-works/chord": "0.86.0",
+		"@earendil-works/chord": "0.87.1",
 		"@silvia-odwyer/photon-node": "0.3.4",
 		"jiti": "2.7.0"
 	},
 	"muBuild": {
-		"pi": "0.86.0",
+		"pi": "0.87.1",
 		"judge": "0.1.0",
-		"commit": "206e694c6"
+		"commit": "c645b9c64"
 	}
 }

package/dist/bundle/chunks/anthropic-messages-MYU5ZMRF.js

@@ -1,6 +0,0 @@
-import { createRequire as __piCreateRequire } from "node:module"; const require = __piCreateRequire(import.meta.url);
-import{buildCopilotDynamicHeaders,hasCopilotVisionInput}from"./chunk-PGXDEOVV.js";import{Anthropic}from"./chunk-DTD7JQ7Y.js";import{retryProviderRequest}from"./chunk-XNGRGP62.js";import{adjustMaxTokensForThinking,buildBaseOptions,clampMaxTokensToContext,getJsonSchemaToolParameters,getPiUserAgent,resolveJsonSchemaStrictSampling,transformMessages}from"./chunk-S7SZN6Z3.js";import{sanitizeSurrogates}from"./chunk-L2ZPNLYD.js";import{headersToRecord}from"./chunk-6R7UI4IY.js";import{getProviderEnvValue}from"./chunk-DRQDKNXA.js";import{parseJsonWithRepair,parseStreamingJson}from"./chunk-TRDNDS6A.js";import{calculateCost,getCurrentTools,getDeclaredTools,getInitialSystemMessage,getSystemMessageText,hasToolRedefinitions,renderSystemMessageUpdate,resolveTranscript}from"./chunk-RCZIEVGO.js";import{AssistantMessageEventStream,appendAssistantMessageDiagnostic}from"./chunk-A3JYRWB6.js";import"./chunk-4L3WN2XY.js";function resolveCacheRetention(cacheRetention,env){return cacheRetention||(getProviderEnvValue("PI_CACHE_RETENTION",env)==="long"?"long":"short")}function getCacheControl(model,cacheRetention,env){let retention=resolveCacheRetention(cacheRetention,env);if(retention==="none")return{retention};let ttl=retention==="long"&&getAnthropicCompat(model).supportsLongCacheRetention?"1h":void 0;return{retention,cacheControl:{type:"ephemeral",...ttl&&{ttl}}}}var claudeCodeVersion="2.1.251",claudeCodeTools=["Read","Write","Edit","Bash","Grep","Glob","AskUserQuestion","EnterPlanMode","ExitPlanMode","KillShell","NotebookEdit","Skill","Task","TaskOutput","TodoWrite","WebFetch","WebSearch"],ccToolLookup=new Map(claudeCodeTools.map(t=>[t.toLowerCase(),t])),toClaudeCodeName=name=>ccToolLookup.get(name.toLowerCase())??name,fromClaudeCodeName=(name,tools)=>{if(tools&&tools.length>0){let lowerName=name.toLowerCase(),matchedTool=tools.find(tool=>tool.name.toLowerCase()===lowerName);if(matchedTool)return matchedTool.name}return name};function convertContentBlocks(content){if(!content.some(c=>c.type==="image"))return sanitizeSurrogates(content.map(c=>c.text).join(`
-`));let blocks=content.map(block=>block.type==="text"?{type:"text",text:sanitizeSurrogates(block.text)}:{type:"image",source:{type:"base64",media_type:block.mimeType,data:block.data}});return blocks.some(b=>b.type==="text")||blocks.unshift({type:"text",text:"(see attached image)"}),blocks}var FINE_GRAINED_TOOL_STREAMING_BETA="fine-grained-tool-streaming-2025-05-14",INTERLEAVED_THINKING_BETA="interleaved-thinking-2025-05-14",SERVER_SIDE_FALLBACK_BETA="server-side-fallback-2026-07-01",MID_CONVERSATION_OUTPUT_CONFIG_BETA="mid-conversation-output-config-2026-07-01",THINKING_BINDING_CONTROLS_BETA="thinking-binding-controls-2026-08-01",MID_CONVERSATION_TOOL_CHANGES_BETA="mid-conversation-tool-changes-2026-07-01",DEFERRED_TOOL_PLACEHOLDER={name:"__pi_deferred_placeholder__",description:"Reserved placeholder. Never available. Never call this.",input_schema:{type:"object",properties:{},required:[]},defer_loading:!0};function shouldUseServerSideFallbackBeta(model){return(model.compat?.allowedFallbackModels?.length??0)>0}function getAnthropicCompat(model){let isOpenRouter=model.provider==="openrouter"||model.baseUrl.includes("openrouter.ai");return{supportsEagerToolInputStreaming:model.compat?.supportsEagerToolInputStreaming??!0,supportsLongCacheRetention:model.compat?.supportsLongCacheRetention??!0,sendSessionAffinityHeaders:model.compat?.sendSessionAffinityHeaders??isOpenRouter,sessionAffinityFormat:model.compat?.sessionAffinityFormat??(isOpenRouter?"openrouter":void 0),supportsCacheControlOnTools:model.compat?.supportsCacheControlOnTools??!0,supportsTemperature:model.compat?.supportsTemperature??!0,allowEmptySignature:model.compat?.allowEmptySignature??!1,supportsStrictTools:model.compat?.supportsStrictTools??!1,supportsMidConvoSystemMessages:model.compat?.supportsMidConvoSystemMessages??!1,supportsMidConvoToolChanges:model.compat?.supportsMidConvoToolChanges??!1}}function mergeHeaders(...headerSources){let merged={};for(let headers of headerSources)headers&&Object.assign(merged,headers);return merged}function mergeClientHeaders(...headerSources){return mergeHeaders({"User-Agent":getPiUserAgent()},...headerSources)}function hasHeader(headers,name){if(!headers)return!1;let expected=name.toLowerCase();for(let[key,value]of Object.entries(headers))if(key.toLowerCase()===expected&&value!==null&&value.trim().length>0)return!0;return!1}function assertRequestAuth(provider,apiKey,headers){if(!apiKey&&!(hasHeader(headers,"authorization")||hasHeader(headers,"x-api-key")||hasHeader(headers,"cf-aig-authorization")))throw new Error(`No API key for provider: ${provider}`)}var ANTHROPIC_MESSAGE_EVENTS=new Set(["message_start","message_delta","message_stop","content_block_start","content_block_delta","content_block_stop"]);function flushSseEvent(state){if(!state.event&&state.data.length===0)return null;let event={event:state.event,data:state.data.join(`
-`),raw:[...state.raw]};return state.event=null,state.data=[],state.raw=[],event}function decodeSseLine(line,state){if(line==="")return flushSseEvent(state);if(state.raw.push(line),line.startsWith(":"))return null;let delimiterIndex=line.indexOf(":"),fieldName=delimiterIndex===-1?line:line.slice(0,delimiterIndex),value=delimiterIndex===-1?"":line.slice(delimiterIndex+1);return value.startsWith(" ")&&(value=value.slice(1)),fieldName==="event"?state.event=value:fieldName==="data"&&state.data.push(value),null}function nextLineBreakIndex(text){let carriageReturnIndex=text.indexOf("\r"),newlineIndex=text.indexOf(`
-`);return carriageReturnIndex===-1?newlineIndex:newlineIndex===-1?carriageReturnIndex:Math.min(carriageReturnIndex,newlineIndex)}function consumeLine(text){let lineBreakIndex=nextLineBreakIndex(text);if(lineBreakIndex===-1)return null;let nextIndex=lineBreakIndex+1;return text[lineBreakIndex]==="\r"&&text[nextIndex]===`
-`&&(nextIndex+=1),{line:text.slice(0,lineBreakIndex),rest:text.slice(nextIndex)}}async function*iterateSseMessages(body,signal){let reader=body.getReader(),decoder=new TextDecoder,state={event:null,data:[],raw:[]},buffer="";try{for(;;){if(signal?.aborted)throw new Error("Request was aborted");let{value,done}=await reader.read();if(done)break;buffer+=decoder.decode(value,{stream:!0});let consumed2=consumeLine(buffer);for(;consumed2;){buffer=consumed2.rest;let event=decodeSseLine(consumed2.line,state);event&&(yield event),consumed2=consumeLine(buffer)}}buffer+=decoder.decode();let consumed=consumeLine(buffer);for(;consumed;){buffer=consumed.rest;let event=decodeSseLine(consumed.line,state);event&&(yield event),consumed=consumeLine(buffer)}if(buffer.length>0){let event=decodeSseLine(buffer,state);event&&(yield event)}let trailingEvent=flushSseEvent(state);trailingEvent&&(yield trailingEvent)}finally{reader.releaseLock()}}async function*iterateAnthropicEvents(response,signal){if(!response.body)throw new Error("Attempted to iterate over an Anthropic response with no body");let sawMessageStart=!1,sawMessageEnd=!1;for await(let sse of iterateSseMessages(response.body,signal)){if(sse.event==="error")throw new Error(sse.data);if(ANTHROPIC_MESSAGE_EVENTS.has(sse.event??""))try{let event=parseJsonWithRepair(sse.data);event.type==="message_start"?sawMessageStart=!0:event.type==="message_stop"&&(sawMessageEnd=!0),yield event}catch(error){let message=error instanceof Error?error.message:String(error);throw new Error(`Could not parse Anthropic SSE event ${sse.event}: ${message}; data=${sse.data}; raw=${sse.raw.join("\\n")}`)}}if(sawMessageStart&&!sawMessageEnd)throw new Error("Anthropic stream ended before message_stop")}var stream=(model,context,options)=>{let stream2=new AssistantMessageEventStream,normalizedContext=resolveTranscript(context,getAnthropicCompat(model).supportsMidConvoSystemMessages),currentTools=getCurrentTools(normalizedContext.messages);return(async()=>{let providerThinkingLevel=model.compat?.supportsMidConvoEffort?options?.effort??"high":void 0,output={role:"assistant",content:[],api:model.api,provider:model.provider,model:model.id,...providerThinkingLevel===void 0?{}:{providerThinkingLevel},usage:{input:0,output:0,cacheRead:0,cacheWrite:0,totalTokens:0,cost:{input:0,output:0,cacheRead:0,cacheWrite:0,total:0}},stopReason:"pending",timestamp:Date.now()};try{let client,isOAuth,usageModel=model,inputTransformations;if(options?.client)client=options.client,isOAuth=!1;else{let apiKey=options?.apiKey;assertRequestAuth(model.provider,apiKey,options?.headers);let copilotDynamicHeaders;if(model.provider==="github-copilot"){let hasImages=hasCopilotVisionInput(normalizedContext.messages);copilotDynamicHeaders=buildCopilotDynamicHeaders({messages:normalizedContext.messages,hasImages})}let cacheSessionId=resolveCacheRetention(options?.cacheRetention,options?.env)==="none"?void 0:options?.sessionId,created=createClient(model,apiKey,options?.headers,options?.fetch,copilotDynamicHeaders,cacheSessionId);client=created.client,isOAuth=created.isOAuthToken}let params=buildParams(model,normalizedContext,isOAuth,options),nextParams=await options?.onPayload?.(params,model);nextParams!==void 0&&(params={...nextParams,stream:!0});let requestOptions={...options?.signal?{signal:options.signal}:{},...options?.timeoutMs!==void 0?{timeout:options.timeoutMs}:{},maxRetries:0},response=await retryProviderRequest(()=>client.beta.messages.create(params,requestOptions).asResponse(),{maxRetries:options?.maxRetries,maxRetryDelayMs:options?.maxRetryDelayMs,signal:options?.signal});await options?.onResponse?.({status:response.status,headers:headersToRecord(response.headers)},model),stream2.push({type:"start",partial:output});let blocks=output.content;for await(let event of iterateAnthropicEvents(response,options?.signal))if(event.type==="message_start"){output.responseId=event.message.id;let transformations=event.message.input_transformations;Array.isArray(transformations)&&(inputTransformations=transformations);let responseModel=event.message.model;responseModel!==model.id&&(output.responseModel=responseModel);let fallbackCost=responseModel===model.id?void 0:model.compat?.allowedFallbackModels?.find(fallback=>fallback.provider===model.provider&&fallback.model===responseModel)?.cost;usageModel=fallbackCost?{...model,id:responseModel,cost:fallbackCost}:model,output.usage.input=event.message.usage.input_tokens||0,output.usage.output=event.message.usage.output_tokens||0,output.usage.cacheRead=event.message.usage.cache_read_input_tokens||0,output.usage.cacheWrite=event.message.usage.cache_creation_input_tokens||0,output.usage.cacheWrite1h=event.message.usage.cache_creation?.ephemeral_1h_input_tokens||0,output.usage.totalTokens=output.usage.input+output.usage.output+output.usage.cacheRead+output.usage.cacheWrite,calculateCost(usageModel,output.usage)}else if(event.type==="content_block_start"){if(event.content_block.type==="fallback"){if(output.content.length>0)throw new Error("Anthropic performed an unsupported mid-output model fallback");continue}if(event.content_block.type==="text"){let block={type:"text",text:event.content_block.text??"",index:event.index};output.content.push(block),stream2.push({type:"text_start",contentIndex:output.content.length-1,partial:output})}else if(event.content_block.type==="thinking"){let block={type:"thinking",thinking:event.content_block.thinking??"",thinkingSignature:event.content_block.signature??"",index:event.index};output.content.push(block),stream2.push({type:"thinking_start",contentIndex:output.content.length-1,partial:output})}else if(event.content_block.type==="redacted_thinking"){let block={type:"thinking",thinking:"[Reasoning redacted]",thinkingSignature:event.content_block.data,redacted:!0,index:event.index};output.content.push(block),stream2.push({type:"thinking_start",contentIndex:output.content.length-1,partial:output})}else if(event.content_block.type==="tool_use"){let block={type:"toolCall",id:event.content_block.id,name:isOAuth?fromClaudeCodeName(event.content_block.name,currentTools):event.content_block.name,arguments:event.content_block.input??{},partialJson:"",index:event.index};output.content.push(block),stream2.push({type:"toolcall_start",contentIndex:output.content.length-1,partial:output})}}else if(event.type==="content_block_delta"){if(event.delta.type==="text_delta"){let index=blocks.findIndex(b=>b.index===event.index),block=blocks[index];block&&block.type==="text"&&(block.text+=event.delta.text,stream2.push({type:"text_delta",contentIndex:index,delta:event.delta.text,partial:output}))}else if(event.delta.type==="thinking_delta"){let index=blocks.findIndex(b=>b.index===event.index),block=blocks[index];block&&block.type==="thinking"&&(block.thinking+=event.delta.thinking,stream2.push({type:"thinking_delta",contentIndex:index,delta:event.delta.thinking,partial:output}))}else if(event.delta.type==="input_json_delta"){let index=blocks.findIndex(b=>b.index===event.index),block=blocks[index];block&&block.type==="toolCall"&&(block.partialJson+=event.delta.partial_json,block.arguments=parseStreamingJson(block.partialJson),stream2.push({type:"toolcall_delta",contentIndex:index,delta:event.delta.partial_json,partial:output}))}else if(event.delta.type==="signature_delta"){let index=blocks.findIndex(b=>b.index===event.index),block=blocks[index];block&&block.type==="thinking"&&(block.thinkingSignature=block.thinkingSignature||"",block.thinkingSignature+=event.delta.signature)}}else if(event.type==="content_block_stop"){let index=blocks.findIndex(b=>b.index===event.index),block=blocks[index];block&&(delete block.index,block.type==="text"?stream2.push({type:"text_end",contentIndex:index,content:block.text,partial:output}):block.type==="thinking"?stream2.push({type:"thinking_end",contentIndex:index,content:block.thinking,partial:output}):block.type==="toolCall"&&(block.arguments=parseStreamingJson(block.partialJson),delete block.partialJson,stream2.push({type:"toolcall_end",contentIndex:index,toolCall:block,partial:output})))}else if(event.type==="message_delta"){let transformations=event.input_transformations;if(Array.isArray(transformations)&&(inputTransformations=transformations),event.delta.stop_reason){output.rawStopReason=event.delta.stop_reason;let stopReasonResult=mapStopReason(event.delta.stop_reason,event.delta.stop_details);output.stopReason=stopReasonResult.stopReason,stopReasonResult.errorMessage&&(output.errorMessage=stopReasonResult.errorMessage)}if(event.usage){event.usage.input_tokens!=null&&(output.usage.input=event.usage.input_tokens),event.usage.output_tokens!=null&&(output.usage.output=event.usage.output_tokens),event.usage.cache_read_input_tokens!=null&&(output.usage.cacheRead=event.usage.cache_read_input_tokens),event.usage.cache_creation_input_tokens!=null&&(output.usage.cacheWrite=event.usage.cache_creation_input_tokens);let thinkingTokens=event.usage.output_tokens_details?.thinking_tokens;thinkingTokens!=null&&(output.usage.reasoning=thinkingTokens)}output.usage.totalTokens=output.usage.input+output.usage.output+output.usage.cacheRead+output.usage.cacheWrite,calculateCost(usageModel,output.usage)}if(options?.signal?.aborted)throw new Error("Request was aborted");if(output.stopReason==="pending")throw new Error("Anthropic stream ended without a stop reason");if(output.stopReason==="aborted"||output.stopReason==="error")throw new Error(output.errorMessage||"An unknown error occurred");inputTransformations&&inputTransformations.length>0&&appendAssistantMessageDiagnostic(output,{type:"anthropic_input_transformations",timestamp:Date.now(),details:{transformations:inputTransformations.map(transformation=>({type:transformation.type??void 0,path:transformation.path??void 0,reason:transformation.reason??void 0}))}}),stream2.push({type:"done",reason:output.stopReason,message:output}),stream2.end()}catch(error){for(let block of output.content)delete block.index,delete block.partialJson;output.stopReason=options?.signal?.aborted?"aborted":"error",output.errorMessage=error instanceof Error?error.message:JSON.stringify(error),stream2.push({type:"error",reason:output.stopReason,error:output}),stream2.end()}})(),stream2};function mapThinkingLevelToEffort(model,level){let mapped=level?model.thinkingLevelMap?.[level]:void 0;if(typeof mapped=="string")return mapped;switch(level){case"minimal":case"low":return"low";case"medium":return"medium";case"high":return"high";default:return"high"}}var streamSimple=(model,context,options)=>{assertRequestAuth(model.provider,options?.apiKey,options?.headers);let base={...buildBaseOptions(model,context,options,options?.apiKey),toolChoice:options?.toolChoice};if(!options?.reasoning)return stream(model,context,{...base,thinkingEnabled:!1});if(model.compat?.forceAdaptiveThinking===!0){let effort=mapThinkingLevelToEffort(model,options.reasoning);return stream(model,context,{...base,thinkingEnabled:!0,effort})}let adjusted=adjustMaxTokensForThinking(base.maxTokens,model.maxTokens,options.reasoning,options.thinkingBudgets),maxTokens=clampMaxTokensToContext(model,context,adjusted.maxTokens);return stream(model,context,{...base,maxTokens,thinkingEnabled:!0,thinkingBudgetTokens:Math.min(adjusted.thinkingBudget,Math.max(0,maxTokens-1024))})};function isOAuthToken(apiKey){return apiKey.includes("sk-ant-oat")}function createClient(model,apiKey,optionsHeaders,fetch,dynamicHeaders,sessionId){if(model.provider==="github-copilot")return{client:new Anthropic({apiKey:null,authToken:apiKey??null,baseURL:model.baseUrl,dangerouslyAllowBrowser:!0,fetch,defaultHeaders:mergeClientHeaders({accept:"application/json","anthropic-dangerous-direct-browser-access":"true"},model.headers,dynamicHeaders,optionsHeaders)}),isOAuthToken:!1};if(apiKey&&isOAuthToken(apiKey))return{client:new Anthropic({apiKey:null,authToken:apiKey,baseURL:model.baseUrl,dangerouslyAllowBrowser:!0,fetch,defaultHeaders:mergeClientHeaders({accept:"application/json","anthropic-dangerous-direct-browser-access":"true","user-agent":`claude-cli/${claudeCodeVersion}`,"x-app":"cli"},model.headers,optionsHeaders)}),isOAuthToken:!0};let compat=getAnthropicCompat(model),sessionAffinityHeaders={};if(sessionId&&compat.sendSessionAffinityHeaders){let header=compat.sessionAffinityFormat==="openrouter"?"x-session-id":"x-session-affinity";sessionAffinityHeaders[header]=sessionId}let defaultHeaders=mergeClientHeaders({accept:"application/json","anthropic-dangerous-direct-browser-access":"true"},sessionAffinityHeaders,model.headers,optionsHeaders);return{client:new Anthropic({apiKey:apiKey??null,authToken:null,baseURL:model.baseUrl,dangerouslyAllowBrowser:!0,fetch,defaultHeaders}),isOAuthToken:!1}}function getBetaFeatures(model,context,isOAuthToken2,nativeToolChanges,options){let configuredFeatures;for(let headers of[model.headers,options?.headers])for(let[name,value]of Object.entries(headers??{}))name.toLowerCase()==="anthropic-beta"&&(configuredFeatures=value);if(configuredFeatures===null)return[];if(configuredFeatures!==void 0)return[...new Set(configuredFeatures.split(",").map(feature=>feature.trim()).filter(feature=>feature.length>0))];let features=[];return isOAuthToken2&&features.push("claude-code-20250219","oauth-2025-04-20"),shouldUseFineGrainedToolStreamingBeta(model,context)&&features.push(FINE_GRAINED_TOOL_STREAMING_BETA),model.reasoning&&options?.thinkingEnabled===!0&&(options.interleavedThinking??!0)&&model.compat?.forceAdaptiveThinking!==!0&&features.push(INTERLEAVED_THINKING_BETA),shouldUseServerSideFallbackBeta(model)&&features.push(SERVER_SIDE_FALLBACK_BETA),model.compat?.supportsMidConvoEffort===!0&&features.push(MID_CONVERSATION_OUTPUT_CONFIG_BETA,THINKING_BINDING_CONTROLS_BETA),nativeToolChanges&&features.push(MID_CONVERSATION_TOOL_CHANGES_BETA),[...new Set(features)]}function buildParams(model,context,isOAuthToken2,options){let{cacheControl}=getCacheControl(model,options?.cacheRetention,options?.env),compat=getAnthropicCompat(model),initialSystemMessage=getInitialSystemMessage(context.messages),initialSystemText=initialSystemMessage?getSystemMessageText(initialSystemMessage):"",transformedMessages=transformMessages(context.messages,model,normalizeToolCallId),conversationMessages=initialSystemMessage?transformedMessages.slice(1):transformedMessages,initialTools=initialSystemMessage?.toolsAdded??[],nativeToolChanges=compat.supportsMidConvoSystemMessages&&compat.supportsMidConvoToolChanges&&initialTools.length>0&&!hasToolRedefinitions(context.messages),converted=convertMessages(conversationMessages,isOAuthToken2,cacheControl,compat.allowEmptySignature,model.compat?.supportsMidConvoEffort===!0?model.provider:void 0,nativeToolChanges),activeEffort=options?.effort??"high",betaFeatures=getBetaFeatures(model,context,isOAuthToken2,nativeToolChanges,options),params={model:model.id,messages:model.compat?.supportsMidConvoEffort===!0?insertThinkingLevelMessages(converted,activeEffort):converted.messages,max_tokens:options?.maxTokens??model.maxTokens,stream:!0,...betaFeatures.length>0?{betas:betaFeatures}:{}};isOAuthToken2?(params.system=[{type:"text",text:"You are Claude Code, Anthropic's official CLI for Claude.",...cacheControl?{cache_control:cacheControl}:{}}],initialSystemText&&params.system.push({type:"text",text:sanitizeSurrogates(initialSystemText),...cacheControl?{cache_control:cacheControl}:{}})):initialSystemText&&(params.system=[{type:"text",text:sanitizeSurrogates(initialSystemText),...cacheControl?{cache_control:cacheControl}:{}}]),options?.temperature!==void 0&&!options?.thinkingEnabled&&model.compat?.supportsMidConvoEffort!==!0&&compat.supportsTemperature&&(params.temperature=options.temperature);let toolCacheControl=compat.supportsCacheControlOnTools?cacheControl:void 0;if(nativeToolChanges){let initialNames=new Set(initialTools.map(tool=>tool.name)),laterTools=getDeclaredTools(context.messages).filter(tool=>!initialNames.has(tool.name));params.tools=[...convertTools(initialTools,isOAuthToken2,compat.supportsEagerToolInputStreaming,compat.supportsStrictTools,toolCacheControl),DEFERRED_TOOL_PLACEHOLDER,...convertTools(laterTools,isOAuthToken2,compat.supportsEagerToolInputStreaming,compat.supportsStrictTools).map(tool=>({...tool,defer_loading:!0}))]}else{let tools=getCurrentTools(context.messages);tools.length>0&&(params.tools=convertTools(tools,isOAuthToken2,compat.supportsEagerToolInputStreaming,compat.supportsStrictTools,toolCacheControl))}if(model.compat?.supportsMidConvoEffort===!0)params.thinking={type:"adaptive",display:options?.thinkingDisplay??"summarized",block_binding:{prefix_mismatch_behavior:"drop_block"}},params.output_config={effort:"high"};else if(model.reasoning)if(options?.thinkingEnabled){let display=options.thinkingDisplay??"summarized";model.compat?.forceAdaptiveThinking===!0?(params.thinking={type:"adaptive",display},options.effort&&(params.output_config={effort:options.effort})):params.thinking={type:"enabled",budget_tokens:options.thinkingBudgetTokens||1024,display}}else options?.thinkingEnabled===!1&&model.thinkingLevelMap?.off!==null&&(params.thinking={type:"disabled"});if(options?.metadata){let userId=options.metadata.user_id;typeof userId=="string"&&(params.metadata={user_id:userId})}options?.toolChoice&&(typeof options.toolChoice=="string"?params.tool_choice={type:options.toolChoice}:params.tool_choice=options.toolChoice);let allowedFallbackModels=model.compat?.allowedFallbackModels;return allowedFallbackModels&&allowedFallbackModels.length>0&&(params.fallbacks=allowedFallbackModels.map(fallback=>({model:fallback.model}))),params}function normalizeToolCallId(id){return id.replace(/[^a-zA-Z0-9_-]/g,"_").slice(0,64)}function convertToolResult(msg){return{type:"tool_result",tool_use_id:msg.toolCallId,content:convertContentBlocks(msg.content),is_error:msg.isError}}function convertMessages(transformedMessages,isOAuthToken2,cacheControl,allowEmptySignature=!1,managedProvider,nativeToolChanges=!1){let params=[],assistantLevels=new Map,pendingSystemMessages=[],flushPendingSystemMessages=()=>{params.push(...pendingSystemMessages),pendingSystemMessages.length=0};for(let i=0;i<transformedMessages.length;i++){let msg=transformedMessages[i];if(msg.role==="system"){let text=renderSystemMessageUpdate(msg),blocks=[];if(text.length>0&&blocks.push({type:"text",text:sanitizeSurrogates(text)}),nativeToolChanges){for(let tool of msg.toolsRemoved??[])blocks.push({type:"tool_removal",tool:{type:"tool_reference",name:isOAuthToken2?toClaudeCodeName(tool.name):tool.name}});for(let tool of msg.toolsAdded??[])blocks.push({type:"tool_addition",tool:{type:"tool_reference",name:isOAuthToken2?toClaudeCodeName(tool.name):tool.name}})}blocks.length>0&&pendingSystemMessages.push({role:"system",content:blocks})}else if(msg.role==="user")if(typeof msg.content=="string")msg.content.trim().length>0&&params.push({role:"user",content:sanitizeSurrogates(msg.content)});else{let filteredBlocks=msg.content.map(item=>item.type==="text"?{type:"text",text:sanitizeSurrogates(item.text)}:{type:"image",source:{type:"base64",media_type:item.mimeType,data:item.data}}).filter(b=>b.type==="text"?b.text.trim().length>0:!0);if(filteredBlocks.length===0)continue;params.push({role:"user",content:filteredBlocks})}else if(msg.role==="assistant"){flushPendingSystemMessages();let blocks=[];for(let block of msg.content)if(block.type==="text"){if(block.text.trim().length===0)continue;blocks.push({type:"text",text:sanitizeSurrogates(block.text)})}else if(block.type==="thinking"){if(block.redacted){blocks.push({type:"redacted_thinking",data:block.thinkingSignature});continue}let thinkingSignature=block.thinkingSignature,hasThinkingSignature=!!thinkingSignature&&thinkingSignature.trim().length>0;if(block.thinking.trim().length===0&&!hasThinkingSignature)continue;hasThinkingSignature?blocks.push({type:"thinking",thinking:sanitizeSurrogates(block.thinking),signature:thinkingSignature}):blocks.push(allowEmptySignature?{type:"thinking",thinking:sanitizeSurrogates(block.thinking),signature:""}:{type:"text",text:sanitizeSurrogates(block.thinking)})}else block.type==="toolCall"&&blocks.push({type:"tool_use",id:block.id,name:isOAuthToken2?toClaudeCodeName(block.name):block.name,input:block.arguments??{}});if(blocks.length===0)continue;let messageIndex=params.length;params.push({role:"assistant",content:blocks}),managedProvider!==void 0&&msg.api==="anthropic-messages"&&msg.provider===managedProvider&&isAnthropicEffort(msg.providerThinkingLevel)&&assistantLevels.set(messageIndex,msg.providerThinkingLevel)}else if(msg.role==="toolResult"){let toolResults=[],j=i;for(;j<transformedMessages.length&&transformedMessages[j].role==="toolResult";)toolResults.push(convertToolResult(transformedMessages[j])),j++;i=j-1,params.push({role:"user",content:toolResults})}}if(flushPendingSystemMessages(),cacheControl&&params.length>0){let lastMessage=params[params.length-1];if(lastMessage.role==="user"||lastMessage.role==="system")if(Array.isArray(lastMessage.content)){let lastBlock=lastMessage.content[lastMessage.content.length-1];lastBlock&&(lastBlock.type==="text"||lastBlock.type==="image"||lastBlock.type==="tool_result"||lastBlock.type==="tool_addition"||lastBlock.type==="tool_removal")&&(lastBlock.cache_control=cacheControl)}else typeof lastMessage.content=="string"&&(lastMessage.content=[{type:"text",text:lastMessage.content,cache_control:cacheControl}])}return{messages:params,assistantLevels}}function isAnthropicEffort(value){return value==="low"||value==="medium"||value==="high"||value==="xhigh"||value==="max"}function insertThinkingLevelMessages(converted,activeEffort){let messages=[];for(let index=0;index<converted.messages.length;index++){let historicalEffort=converted.assistantLevels.get(index);historicalEffort!==void 0&&messages.push({role:"system",content:[],output_config:{effort:historicalEffort}}),messages.push(converted.messages[index])}return messages.push({role:"system",content:[],output_config:{effort:activeEffort}}),messages}function shouldUseFineGrainedToolStreamingBeta(model,context){return getCurrentTools(context.messages).length>0&&!getAnthropicCompat(model).supportsEagerToolInputStreaming}function convertTools(tools,isOAuthToken2,supportsEagerToolInputStreaming,supportsStrictTools,cacheControl){return tools?tools.map((tool,index)=>{let strict=resolveJsonSchemaStrictSampling(tool,supportsStrictTools),parameters=getJsonSchemaToolParameters(tool,strict),schema=parameters,legacyInputSchema={type:"object",properties:schema.properties??{},required:schema.required??[]},inputSchema=strict===!0?{...parameters,...legacyInputSchema}:legacyInputSchema;return{name:isOAuthToken2?toClaudeCodeName(tool.name):tool.name,description:tool.description,...supportsEagerToolInputStreaming?{eager_input_streaming:!0}:{},...strict===!0?{strict:!0}:{},input_schema:inputSchema,...cacheControl&&index===tools.length-1?{cache_control:cacheControl}:{}}}):[]}function mapStopReason(reason,stopDetails){switch(reason){case"end_turn":return{stopReason:"stop"};case"max_tokens":return{stopReason:"length"};case"tool_use":return{stopReason:"toolUse"};case"refusal":return{stopReason:"error",errorMessage:stopDetails?.explanation||"The model refused to complete the request"};case"pause_turn":return{stopReason:"stop"};case"stop_sequence":return{stopReason:"stop"};case"sensitive":return{stopReason:"error",errorMessage:"Provider stopped with: sensitive"};default:throw new Error(`Unhandled stop reason: ${reason}`)}}export{stream,streamSimple};