isorite 0.14.0 → 0.15.0

package/dist/main.js

@@ -2865,7 +2865,7 @@ var Conflict = class extends EngineError {
 };
 //#endregion
 //#region packages/engine/src/lookup.ts
-const str$1 = { type: "string" };
+const str$2 = { type: "string" };
 const fn$1 = (name, description, properties, required) => ({
 	type: "function",
 	function: {
@@ -2881,9 +2881,9 @@ const fn$1 = (name, description, properties, required) => ({
 });
 const TOOLS = [
 	fn$1("search_notes", "Keyword search over the knowledge base. Returns note ids, titles, types, one-sentence descriptions and a one-line snippet. Search by the words a note would use.", {
-		query: str$1,
+		query: str$2,
 		under: {
-			...str$1,
+			...str$2,
 			description: "Only notes in this folder."
 		},
 		limit: {
@@ -2892,24 +2892,24 @@ const TOOLS = [
 		}
 	}, ["query"]),
 	fn$1("outline_note", "A note's description, its headings, the notes it links to and the notes that link to it, without its body. Use it to choose a section to read.", { id: {
-		...str$1,
+		...str$2,
 		description: "The note's id or path: basics/entropy or /basics/entropy.md."
 	} }, ["id"]),
 	fn$1("read_note", "Read one section of a note, by its heading, or the whole note when no section is named. Prefer a section. A picture in it is ![what it shows](path): you have its words, not the picture.", {
-		id: str$1,
+		id: str$2,
 		section: {
-			...str$1,
+			...str$2,
 			description: "A heading's text, as outline_note gives it."
 		}
 	}, ["id"])
 ];
 const FIND_SIMILAR = fn$1("find_similar", "Find notes by meaning: notes that say something like the text you give, even in quite other words. Slower and vaguer than search_notes: use it after search_notes and the links of the notes in hand have not found what you need, or when you cannot guess the words a note would use. Give a question or a sentence, not keywords. Returns each note's nearest section, with how alike it is (0 to 1).", {
 	text: {
-		...str$1,
+		...str$2,
 		description: "A question, or a sentence saying what you are looking for."
 	},
 	under: {
-		...str$1,
+		...str$2,
 		description: "Only notes in this folder."
 	},
 	limit: {
@@ -3279,7 +3279,7 @@ or try; not for what an answer or a note says as well.
    problem, fix that and write the whole file again.
 4. Say in a sentence what it shows, linked: [what it shows](/folder/name.html).
    Link it from the note it belongs to if they want it there.`;
-const str = { type: "string" };
+const str$1 = { type: "string" };
 const fn = (name, description, properties, required) => ({
 	type: "function",
 	function: {
@@ -3295,16 +3295,16 @@ const fn = (name, description, properties, required) => ({
 });
 const ASK_QUESTION = fn("ask_question", "Ask them a question back, kept as an open question in their base, about one or more of their notes.", {
 	title: {
-		...str,
+		...str$1,
 		description: "The question, short, ending in a question mark."
 	},
 	text: {
-		...str,
+		...str$1,
 		description: "A line or two on what is asked, or empty."
 	},
 	about: {
 		type: "array",
-		items: str,
+		items: str$1,
 		description: "The ids of the notes it is about."
 	}
 }, [
@@ -3313,7 +3313,7 @@ const ASK_QUESTION = fn("ask_question", "Ask them a question back, kept as an op
 	"about"
 ]);
 const READ_DATA = fn("read_data", "A data file's shape: its columns with their types and ranges, the row count and the first rows. Read it before writing anything that uses the file, so the column names are real.", { path: {
-	...str,
+	...str$1,
 	description: "The file's path in the base: folder/name.csv."
 } }, ["path"]);
 const ARTIFACT_RECIPE = fn("artifact_recipe", "A recipe for an artifact: a complete working one to start from, the kit's reference, and the rules write_artifact checks. dashboard: numbers, charts and a table of one data file. compare: two data files side by side. simulation: a model with parameters and play. explorable: inputs, derived numbers and linked views. viewer: a 3D model.", { name: {
@@ -3328,21 +3328,21 @@ const ARTIFACT_RECIPE = fn("artifact_recipe", "A recipe for an artifact: a compl
 } }, ["name"]);
 const WRITE_ARTIFACT = fn("write_artifact", "Write an artifact: a whole HTML file on the kit. The title, description and uses given here are written into it. It is checked, and run where it can be; the result says what to fix. Nothing is written while a rule is broken.", {
 	path: {
-		...str,
+		...str$1,
 		description: "Where: folder/name.html, beside the notes it belongs to."
 	},
-	title: str,
+	title: str$1,
 	description: {
-		...str,
+		...str$1,
 		description: "One sentence: what it shows, and what can be done with it."
 	},
 	uses: {
 		type: "array",
-		items: str,
+		items: str$1,
 		description: "The data or model files it reads, relative to it (runs.csv). Those its markup and script name are added."
 	},
 	html: {
-		...str,
+		...str$1,
 		description: "The whole file."
 	}
 }, [
@@ -3353,16 +3353,16 @@ const WRITE_ARTIFACT = fn("write_artifact", "Write an artifact: a whole HTML fil
 	"html"
 ]);
 const READ_ARTIFACT = fn("read_artifact", "An artifact's whole file, to change it and write it again.", { path: {
-	...str,
+	...str$1,
 	description: "folder/name.html"
 } }, ["path"]);
 const OFFER_TEXT = fn("offer_text", "Offer them their own answers, lightly joined, to insert at the end of a note as their writing. Only their words.", {
 	id: {
-		...str,
+		...str$1,
 		description: "The note's id, or AGENTS.md for a line of their instructions for the base."
 	},
 	text: {
-		...str,
+		...str$1,
 		description: "The passage, in Markdown."
 	}
 }, ["id", "text"]);
@@ -4232,6 +4232,10 @@ var Engine = class Engine {
 			return null;
 		}
 	}
+	async deleteAgentRecord(agent, session) {
+		if (!AGENT_ID.test(agent) || !session || session.length > 200) throw new EngineError("an agent's session is named by the agent and its session's id");
+		await this.opts.own.remove(agentRecordPath(agent, session));
+	}
 	async agentRecords() {
 		const own = this.opts.own, all = [];
 		for (const a of await own.list(AGENTS_DIR).catch(() => [])) {
@@ -4648,6 +4652,10 @@ var Engine = class Engine {
 			turns: readTurns(text)
 		};
 	}
+	async deleteConversation(id) {
+		if (!TURN_ID.test(id)) throw new EngineError("not a conversation's id");
+		await this.opts.own.remove(conversationPath(id));
+	}
 	async conversations() {
 		const study = this.opts.own;
 		const names = await study.list(CONVERSATIONS_DIR).catch(() => []);
@@ -5320,6 +5328,47 @@ const EMPTY = {
 const textOf = (blocks) => (Array.isArray(blocks) ? blocks : [blocks]).map((b) => b?.type === "text" ? b.text ?? "" : b?.type === "resource_link" ? `@${b.name ?? b.uri ?? ""}` : "").join("");
 const lines = (v) => v ? v.replace(/\n$/, "").split("\n") : [];
 const keyOf = (agent, session) => `${agent}\u0000${session}`;
+const str = (v) => typeof v === "string" ? v : "";
+/** The agent's slash commands, from available_commands_update. */
+const commandsOf = (v) => (Array.isArray(v) ? v : []).filter((c) => str(c.name)).map((c) => {
+	const hint = str(c.input?.hint);
+	return {
+		name: str(c.name).replace(/^\//, ""),
+		description: str(c.description),
+		...hint ? { hint } : {}
+	};
+});
+/** The agent's modes, from a session's answer or a current_mode_update. */
+const modesOf = (v) => {
+	const m = v;
+	const options = (m?.availableModes ?? []).filter((o) => str(o.id)).map((o) => ({
+		value: str(o.id),
+		name: str(o.name) || str(o.id),
+		...str(o.description) ? { description: str(o.description) } : {}
+	}));
+	return options.length ? {
+		kind: "mode",
+		id: "mode",
+		name: "Mode",
+		current: str(m?.currentModeId),
+		options
+	} : null;
+};
+/** The agent's options (the model, say), whose choices may be grouped. */
+const configsOf = (v) => (Array.isArray(v) ? v : []).filter((o) => str(o.id) && Array.isArray(o.options)).flatMap((o) => {
+	const options = o.options.flatMap((x) => Array.isArray(x.options) ? x.options : [x]).filter((x) => str(x.value)).map((x) => ({
+		value: str(x.value),
+		name: str(x.name) || str(x.value),
+		...str(x.description) ? { description: str(x.description) } : {}
+	}));
+	return options.length ? [{
+		kind: "config",
+		id: str(o.id),
+		name: str(o.name) || str(o.id),
+		current: str(o.currentValue),
+		options
+	}] : [];
+});
 /** The sessions the wrappers carry, as the pane draws them. One is shown: the one you chose, else the last to start. */
 var AcpFollower = class {
 	#links = /* @__PURE__ */ new Map();
@@ -5402,6 +5451,8 @@ var AcpFollower = class {
 			size: live.size,
 			ours: this.#ours,
 			sessions: this.#sessions(),
+			commands: live.commands,
+			settings: [...live.modes ? [live.modes] : [], ...live.configs],
 			...problem
 		};
 		else if (read) this.#view = {
@@ -5635,6 +5686,42 @@ var AcpFollower = class {
 		link.opening = "";
 		link.send({ type: "open" });
 	}
+	/** Set a mode or option of the session shown (the agent's own: its model, its plan mode). Optimistic: the agent's
+	*  answer or update settles it. */
+	set(kind, id, value) {
+		const live = this.#need();
+		const setting = kind === "mode" ? live.modes : live.configs.find((c) => c.id === id);
+		if (!setting || !setting.options.some((o) => o.value === value)) throw new Error(`${live.link.name || "The agent"} offers no such choice`);
+		if (kind === "mode") live.modes = {
+			...setting,
+			current: value
+		};
+		else live.configs = live.configs.map((c) => c.id === id ? {
+			...c,
+			current: value
+		} : c);
+		live.link.send({
+			type: "set",
+			session: live.session,
+			kind,
+			id,
+			value
+		});
+		this.#tell();
+	}
+	/** Remove what isorite kept of a session that is not live. What the agent keeps of its own is not touched. */
+	async forget(agent, session) {
+		const key = keyOf(agent, session);
+		if (this.#lives.has(key)) throw new Error("that session is live: stop it before removing what is kept of it");
+		if (!this.#api?.deleteAgentRecord) throw new Error("nothing is kept here");
+		await this.#api.deleteAgentRecord(agent, session);
+		if (this.#shown === key) {
+			this.#shown = null;
+			this.#chosen = false;
+			this.#reading = null;
+		}
+		await this.#readKept();
+	}
 	/** Ask the attached agents for their sessions again: the drawer is being looked at. */
 	refresh() {
 		for (const link of this.#links.values()) if (link.can.list) link.send({ type: "list" });
@@ -5713,7 +5800,11 @@ var AcpFollower = class {
 					break;
 				}
 				case "session/new":
-					if (typeof m.result?.sessionId === "string") this.#open(link, m.result.sessionId, key.startsWith("isorite-") ? "ours" : "in", typeof params.cwd === "string" ? params.cwd : "");
+					if (typeof m.result?.sessionId === "string") {
+						const opened = this.#open(link, m.result.sessionId, key.startsWith("isorite-") ? "ours" : "in", typeof params.cwd === "string" ? params.cwd : "");
+						opened.modes = modesOf(m.result.modes);
+						opened.configs = configsOf(m.result.configOptions);
+					}
 					break;
 				case "session/load":
 				case "session/resume":
@@ -5722,9 +5813,20 @@ var AcpFollower = class {
 							this.#lives.delete(keyOf(link.agent, live.session));
 							break;
 						}
+						if (m.result?.modes) live.modes = modesOf(m.result.modes);
+						if (m.result?.configOptions) live.configs = configsOf(m.result.configOptions);
 						this.#loaded(live);
 					}
 					break;
+				case "session/set_mode":
+					if (live && !m.error && live.modes) live.modes = {
+						...live.modes,
+						current: str(params.modeId)
+					};
+					break;
+				case "session/set_config_option":
+					if (live && !m.error && m.result?.configOptions) live.configs = configsOf(m.result.configOptions);
+					break;
 				case "session/prompt":
 					if (live) {
 						const stop = m.error ? "failed" : m.result?.stopReason === "cancelled" ? "stopped" : m.result?.stopReason === "end_turn" ? "done" : "failed";
@@ -5788,7 +5890,10 @@ var AcpFollower = class {
 			loading: false,
 			replaying: false,
 			pending: null,
-			given: /* @__PURE__ */ new Set()
+			given: /* @__PURE__ */ new Set(),
+			commands: [],
+			modes: null,
+			configs: []
 		};
 		live.link = link;
 		if (cwd) live.cwd = cwd;
@@ -5978,7 +6083,19 @@ var AcpFollower = class {
 				if (typeof cost === "number") live.cost = cost;
 				break;
 			}
-			case "session_info_update": if (typeof u.title === "string") live.title = u.title;
+			case "session_info_update":
+				if (typeof u.title === "string") live.title = u.title;
+				break;
+			case "available_commands_update":
+				live.commands = commandsOf(u.availableCommands);
+				break;
+			case "current_mode_update":
+				if (live.modes && typeof u.currentModeId === "string") live.modes = {
+					...live.modes,
+					current: u.currentModeId
+				};
+				break;
+			case "config_option_update": live.configs = configsOf(u.configOptions);
 		}
 	}
 	/** The note a path names, if it is a Markdown file of the base (relative paths read from the session's folder). */
@@ -6038,7 +6155,7 @@ var AcpFollower = class {
 };
 //#endregion
 //#region packages/server/src/version.ts
-const VERSION = "0.14.0";
+const VERSION = "0.15.0";
 //#endregion
 //#region packages/server/src/connect.ts
 const HARNESSES = [{
@@ -6310,6 +6427,27 @@ function detectAgents(env = process.env) {
 		}];
 	});
 }
+function listAgents(env = process.env) {
+	const found = detectAgents(env).map((d) => ({
+		...d,
+		found: true
+	}));
+	const have = new Set(found.map((d) => d.id));
+	const rest = KNOWN.filter((k) => !have.has(k.id)).map((k) => ({
+		id: k.id,
+		name: k.name,
+		command: k.command,
+		path: "",
+		keys: k.keys,
+		keySet: false,
+		ready: false,
+		found: false,
+		note: `${k.name} isn't on this machine's PATH.`
+	}));
+	return [...found, ...rest];
+}
+/** The ACP command of an agent known by name (`isorite acp omp`), or null. */
+const knownCommand = (id) => KNOWN.find((k) => k.id === id)?.command ?? null;
 /** Why an agent that stopped may have: the key it reads isn't set where isorite was started, for the command run. */
 function missingKey(command, env = process.env) {
 	const k = KNOWN.find((x) => x.command === command);
@@ -6563,6 +6701,108 @@ var AgentRunner = class {
 	}
 };
 //#endregion
+//#region packages/server/src/own-repo.ts
+const q = (s) => /^[\w@%+=:,./-]+$/.test(s) ? s : `"${s.replace(/(["\\$`])/g, "\\$1")}"`;
+const slashes = (p) => p.split("\\").join("/");
+function git(cwd, args, env) {
+	return execFileSync("git", args, {
+		cwd,
+		env: plainGitEnv(env),
+		timeout: 1e4,
+		killSignal: "SIGKILL",
+		encoding: "utf8",
+		stdio: [
+			"ignore",
+			"pipe",
+			"pipe"
+		]
+	});
+}
+/** What this machine chose for a base, from bases.toml. */
+function historyChoice(base, config) {
+	const v = table(readConfig(basesPath(config))[base]).history;
+	return v === "project" || v === "separate" ? v : null;
+}
+function setHistoryChoice(base, choice, config) {
+	const bases = readConfig(basesPath(config));
+	if (!bases[base]) throw new Error(`${base} is not among the bases`);
+	bases[base] = {
+		...table(bases[base]),
+		history: choice
+	};
+	writeConfig(bases, basesPath(config));
+}
+/** Where isorite's own folder is kept, and the commands for the person to run. Runs `git ls-files`, `remote` and
+*  `rev-parse`, which only read. */
+function ownRepoInfo(own, choice = null, env = process.env) {
+	const project = repoOf(dirname(own));
+	const base = {
+		state: "none",
+		path: own,
+		project,
+		remotes: [],
+		choice,
+		ask: false,
+		commands: [],
+		problem: ""
+	};
+	try {
+		if (existsSync(join(own, ".git"))) {
+			const remotes = git(own, ["remote"], env).split("\n").filter(Boolean);
+			return {
+				...base,
+				state: "own",
+				remotes,
+				commands: remotes.length ? [`git -C ${q(own)} push`] : [`git -C ${q(own)} remote add origin <the address of your private repository>`, `git -C ${q(own)} push -u origin HEAD`]
+			};
+		}
+		if (!project) return base;
+		const rel = slashes(relative(project, own));
+		const tracked = git(project, [
+			"ls-files",
+			"--",
+			rel
+		], env).trim() !== "";
+		const path = git(project, [
+			"rev-parse",
+			"--git-path",
+			"info/exclude"
+		], env).trim();
+		const exclude = isAbsolute(path) ? path : resolve(project, path);
+		const apart = [
+			`git -C ${q(own)} init`,
+			`echo ${q(rel + "/")} >> ${q(exclude)}`,
+			`git -C ${q(own)} add -A`,
+			`git -C ${q(own)} commit -m "isorite: start"`
+		];
+		return {
+			...base,
+			state: tracked ? "tracked" : "shared",
+			ask: choice === null,
+			commands: tracked ? [
+				`git -C ${q(project)} rm -r --cached ${q(rel)}`,
+				...apart,
+				`git -C ${q(project)} commit -m "stop tracking isorite's own files"`
+			] : apart
+		};
+	} catch (e) {
+		return {
+			...base,
+			state: "unavailable",
+			problem: e.message.split("\n")[0] ?? "git did not answer"
+		};
+	}
+}
+/** For a base just made in a git project: ask whether its own files stay with the project or apart, keep the answer
+*  for this machine, and say the commands for apart. Asks nothing outside a project. isorite runs none of it. */
+async function askWhereFilesLive(notes, ask, out, config, env = process.env) {
+	if (!repoOf(notes)) return null;
+	const choice = (await ask(`${notes} is in a git project. isorite's own files (.isorite/: journals, kept sessions, settings) can be committed with the project, or kept apart from it, so the people sharing it don't have them.\nKeep them [p]roject / [a]part? (p) `)).trim().toLowerCase().startsWith("a") ? "separate" : "project";
+	setHistoryChoice(rememberBase(notes, { path: config }), choice, config);
+	if (choice === "separate") out(`\nTo keep them apart, run these (isorite runs no git itself):\n${ownRepoInfo(join(notes, ".isorite"), "separate", env).commands.map((c) => `  ${c}`).join("\n")}\n`);
+	return choice;
+}
+//#endregion
 //#region packages/server/src/http.ts
 const LOOPBACK = /* @__PURE__ */ new Set([
 	"localhost",
@@ -6639,7 +6879,7 @@ const AgentStatus = z.object({
 	session: z.string().min(1).max(200),
 	busy: z.boolean()
 }).strict();
-function createApp({ api, token, loopback, web, allowHosts = [], notes, acp, bases, base, agents }) {
+function createApp({ api, token, loopback, web, allowHosts = [], notes, acp, bases, base, agents, config }) {
 	const app = new Hono();
 	const allowed = new Set([...allowHosts].map((h) => h.toLowerCase()));
 	const reply = (c, status, value) => c.body(JSON.stringify(value), status, {
@@ -6773,6 +7013,7 @@ function createApp({ api, token, loopback, web, allowHosts = [], notes, acp, bas
 	app.get("/api/agents/notes", (c) => answer(c, () => api.agentNotes()));
 	post("/api/agents/notes", z.object({ may: z.boolean() }).strict(), (_c, b) => api.setAgentNotes(b.may));
 	app.get("/api/conversations", (c) => answer(c, () => api.conversations()));
+	post("/api/conversation/delete", z.object({ id: z.string().max(64) }).strict(), (_c, b) => api.deleteConversation(b.id));
 	app.get("/api/conversation", (c) => answer(c, async () => await api.conversation(c.req.query("id") || void 0) ?? {
 		id: "",
 		turns: []
@@ -6851,6 +7092,16 @@ function createApp({ api, token, loopback, web, allowHosts = [], notes, acp, bas
 	}).strict(), (_c, b) => api.agentReceived(b.id, b.agent));
 	post("/api/agent/status", AgentStatus, (_c, b) => api.agentStatus(b.agent, b.session, b.busy));
 	post("/api/agent/take", z.object({ id: z.string().max(64) }).strict(), (_c, b) => api.agentTake(b.id));
+	if (notes) {
+		const configFile = config ?? configPath();
+		app.get("/api/own/repo", (c) => answer(c, async () => local(c) ? ownRepoInfo(join(notes, ".isorite"), base ? historyChoice(base, configFile) : null) : null));
+		post("/api/own/choose", z.object({ choice: z.enum(["project", "separate"]) }).strict(), async (c, b) => {
+			if (!local(c)) throw new EngineError("this is chosen only from this machine", 403);
+			if (!base) throw new EngineError("this base has no name here", 409);
+			setHistoryChoice(base, b.choice, configFile);
+			return ownRepoInfo(join(notes, ".isorite"), b.choice);
+		});
+	}
 	if (notes) {
 		app.get("/api/connect", (c) => answer(c, async () => proposal(notes)));
 		post("/api/connect", z.object({ files: z.array(z.string().max(200)).max(10).optional() }).strict(), async (c, b) => {
@@ -6862,7 +7113,7 @@ function createApp({ api, token, loopback, web, allowHosts = [], notes, acp, bas
 		app.get("/api/acp/agent", (c) => answer(c, async () => agents.state()));
 		app.get("/api/acp/detected", (c) => answer(c, async () => {
 			if (!local(c)) throw new EngineError("agents are looked for only from this machine", 403);
-			return detectAgents();
+			return listAgents();
 		}));
 		app.get("/api/acp/registry", (c) => answer(c, async () => registryAgents().catch((e) => {
 			throw new EngineError(e.message, 502);
@@ -6967,6 +7218,23 @@ function createApp({ api, token, loopback, web, allowHosts = [], notes, acp, bas
 		}).strict(), async (_c, b) => {
 			await acp.follow(b.agent, b.session).catch(refused);
 		});
+		post("/api/acp/forget", z.object({
+			agent: z.string().max(40),
+			session: z.string().min(1).max(200)
+		}).strict(), async (_c, b) => {
+			await acp.forget(b.agent, b.session).catch(refused);
+		});
+		post("/api/acp/set", z.object({
+			kind: z.enum(["mode", "config"]),
+			id: z.string().max(100),
+			value: z.string().max(200)
+		}).strict(), async (_c, b) => {
+			try {
+				acp.set(b.kind, b.id, b.value);
+			} catch (e) {
+				throw new EngineError(e.message, 409);
+			}
+		});
 		post("/api/acp/new", z.object({ agent: z.string().max(40) }).strict(), async (_c, b) => {
 			await acp.fresh(b.agent).catch(refused);
 		});
@@ -7457,7 +7725,8 @@ async function openServer(path, { host = "127.0.0.1", port = 4767, allowHosts =
 					acp,
 					bases,
 					base: known.name,
-					...loopback ? { agents } : {}
+					...loopback ? { agents } : {},
+					config
 				}).fetch
 			};
 		}
@@ -7614,6 +7883,8 @@ async function doctor(folder, o = {}) {
 			const errors = issues.filter((i) => i.level === "error");
 			say("links", errors.length ? "fail" : issues.length || cycles.length ? "warn" : "ok", `${bundle.concepts.size} notes; ${errors.length} errors, ${issues.length - errors.length} warnings, ${cycles.length} requires cycles${issues.length ? `: ${issues.slice(0, 3).map((i) => `${i.path}: ${i.message}`).join("; ")}${issues.length > 3 ? `; and ${issues.length - 3} more (isorite check ${notes})` : ""}` : ""}`);
 		}
+		const kept = ownRepoInfo(own, null, env);
+		if (existsSync(own)) say("history", kept.state === "own" ? "ok" : kept.state === "unavailable" ? "skip" : kept.state === "none" ? "skip" : "ok", kept.state === "own" ? `${OWN_DIR}/ is a repository of its own${kept.remotes.length ? `, remote ${kept.remotes.join(", ")}` : `; to keep it elsewhere: git -C ${own} remote add origin <address>`}` : kept.state === "tracked" ? `${OWN_DIR}/ is tracked by the project's repository, so everyone sharing it has isorite's files; to keep them apart, run:\n    ${kept.commands.join("\n    ")}` : kept.state === "shared" ? `${OWN_DIR}/ is in the project's folder, to be committed with it; to keep it apart, run:\n    ${kept.commands.join("\n    ")}` : kept.state === "unavailable" ? `${OWN_DIR}/: git did not answer (${kept.problem})` : `${OWN_DIR}/ is in no git repository`);
 		const repository = existsSync(settings) ? parseSettings(readFileSync(settings, "utf8")).repository : void 0;
 		const found = repoOf(notes);
 		if (!repository && found) say("repository", "ok", `${found}: code links point here`);
@@ -8244,6 +8515,14 @@ async function acp(path, { agent, port = 4767, input, output, env = process.env,
 			toAgent(m);
 		}
 		if (c.type === "list" && can.list) ask("session/list", { cwd });
+		if (c.type === "set") ask(c.kind === "mode" ? "session/set_mode" : "session/set_config_option", c.kind === "mode" ? {
+			sessionId: c.session,
+			modeId: c.value
+		} : {
+			sessionId: c.session,
+			configId: c.id,
+			value: c.value
+		});
 		if (c.type === "open") {
 			const params = {
 				cwd,
@@ -9303,6 +9582,11 @@ function label(b, all) {
 }
 /** The choice `isorite` makes, and what it says. */
 async function start(io) {
+	const make = async (folder) => {
+		const notes = io.make(folder);
+		await io.made?.(notes);
+		return notes;
+	};
 	const found = findBase(io.cwd);
 	if (found.kind === "base") return io.open(found.notes);
 	if (found.kind === "several") {
@@ -9314,7 +9598,7 @@ async function start(io) {
 	if (found.kind === "repo") {
 		const notes = join(found.repo, "notes");
 		io.out(`isorite: no base in ${found.repo} yet.`);
-		if (!existsSync(notes) && await io.confirm(`Make one at ${notes}?`)) return io.open(io.make(notes));
+		if (!existsSync(notes) && await io.confirm(`Make one at ${notes}?`)) return io.open(await make(notes));
 		if (existsSync(notes)) io.out(`  ${notes} is there already: open it as it is with  isorite serve ${notes}`);
 	}
 	const known = recent(io.config);
@@ -9332,7 +9616,7 @@ async function start(io) {
 	const pick = await io.choose("Open which?", rows.length);
 	if (pick === null) return 2;
 	if (pick < known.length) return io.open(known[pick].path);
-	if (pick === known.length) return io.open(io.make(join(io.cwd, "notes")));
+	if (pick === known.length) return io.open(await make(join(io.cwd, "notes")));
 	return io.guide();
 }
 /** The model for search by meaning, offered on the first start without one (M26): asked once, fetched on a yes,
@@ -9495,6 +9779,9 @@ async function terminalStart({ port, noOpen }) {
 			console.log(`  made ${made}`);
 			return made;
 		},
+		made: async (notes) => {
+			await askWhereFilesLive(notes, ask, console.log, configPath());
+		},
 		guide: async () => {
 			await model();
 			await guide(void 0, { port: port ?? await freePort() });
@@ -9519,7 +9806,22 @@ function main(argv) {
 		if (command === "check" && rest.find((r) => !r.startsWith("--"))) return check(rest.find((r) => !r.startsWith("--")), console.log, rest.includes("--unused"));
 		if (command === "new" && rest[0]) {
 			const made = newBase(rest[0]);
-			console.log(`${made}: a knowledge base, empty. Open it in the browser, and attach your agent from Iso's pane:\n  isorite serve ${made}`);
+			const next = `${made}: a knowledge base, empty. Open it in the browser, and attach your agent from Iso's pane:\n  isorite serve ${made}`;
+			if (process.stdin.isTTY && process.stdout.isTTY && repoOf(made)) return (async () => {
+				const { createInterface } = await import("node:readline/promises");
+				const rl = createInterface({
+					input: process.stdin,
+					output: process.stdout
+				});
+				try {
+					await askWhereFilesLive(made, (q) => rl.question(q), console.log, configPath());
+				} finally {
+					rl.close();
+				}
+				console.log(next);
+				return 0;
+			})();
+			console.log(next);
 			return 0;
 		}
 		if (command === "serve" && rest[0]) {
@@ -9586,9 +9888,15 @@ function main(argv) {
 				const at = rest.indexOf(name);
 				return at < 0 ? void 0 : rest[at + 1];
 			};
-			const agent = flag("--agent"), port = flag("--port") === void 0 ? void 0 : Number(flag("--port"));
+			const positional = rest.filter((a, i) => !a.startsWith("--") && ![
+				"--port",
+				"--agent",
+				"--url"
+			].includes(rest[i - 1] ?? ""));
+			const named = !flag("--agent") && positional[0] && !existsSync(positional[0]) ? knownCommand(positional[0]) : null;
+			const agent = flag("--agent") ?? named ?? void 0, port = flag("--port") === void 0 ? void 0 : Number(flag("--port"));
 			if (!agent) {
-				console.error("isorite acp --agent \"<the agent's ACP command>\" [<notes>] [--port <n>] [--pane]");
+				console.error("isorite acp <omp|opencode|claude|codex|hermes> [<notes>] [--port <n>]\nisorite acp --agent \"<the agent's ACP command>\" [<notes>] [--port <n>] [--pane]");
 				return 2;
 			}
 			if (port !== void 0 && !(Number.isInteger(port) && port > 0 && port < 65536)) {
@@ -9600,11 +9908,7 @@ function main(argv) {
 				console.error("--url takes a base's address on this machine");
 				return 2;
 			}
-			return acp(rest.find((a, i) => !a.startsWith("--") && ![
-				"--port",
-				"--agent",
-				"--url"
-			].includes(rest[i - 1] ?? "")), {
+			return acp(named ? positional[1] : positional[0], {
 				agent,
 				pane,
 				...port === void 0 ? {} : { port },

package/docs/terminal.md

@@ -16,7 +16,7 @@ isorite          # in the project: finds its base, opens the browser (isorite se
 
 ### In Iso's pane
 
-With no agent attached, Iso's pane says how to attach one. *Here, in this pane*: choose an agent of the [ACP registry](https://agentclientprotocol.com/get-started/registry), or give the command of one it doesn't list (`hermes acp`). isorite starts it for the base, behind `isorite acp --pane`, in the repository the base is in, with the server's environment, and starts it again when the base is next opened. It runs a program, so it is chosen from this machine only; the choice is kept in `~/.config/isorite/bases.toml` (`agent`, or `agent_command`). The drawer's *stop it* stops it.
+With no agent attached, Iso's pane offers a card for each agent isorite knows (Claude Code, OpenCode, omp, Codex, Hermes), saying whether it is found on this machine's PATH and, for those that read a key, whether it is set where isorite was started (by name; no key is read or kept). *Use in this pane* starts it for the base; *in my terminal* gives isorite's MCP address and, to share the session live with the pane, the `isorite acp <agent>` line to run in an ACP front end such as Toad. *Another agent* takes one of the [ACP registry](https://agentclientprotocol.com/get-started/registry), or the command of one it doesn't list (`hermes acp`). The drawer's *change agent* is the same choice later. isorite starts it for the base, behind `isorite acp --pane`, in the repository the base is in, with the server's environment, and starts it again when the base is next opened. It runs a program, so it is chosen from this machine only; the choice is kept in `~/.config/isorite/bases.toml` (`agent`, or `agent_command`). The drawer's *stop it* stops it. A session isorite kept can be removed from the drawer (*remove*): that deletes isorite's copy only, never the agent's own history, and a live session is not removed.
 
 A registry agent is run as the registry says: its program for this platform, fetched once into `~/.local/share/isorite/agents/<id>/<version>/` and checked against its SHA-256; else with `npx -y` or `uvx`. `ISORITE_ACP_REGISTRY` names another registry, an address or a file.
 
@@ -28,6 +28,8 @@ Toad in the terminal, Zed, or JetBrains: give it isorite as its agent, with the
 isorite acp --agent "npx -y @agentclientprotocol/claude-agent-acp" ~/code/my-project/notes
 ```
 
+For an agent isorite knows by name there is a shorter form: `isorite acp omp`, `opencode`, `claude`, `codex` or `hermes` (the pane's cards show the line for each). A folder of that name here is taken as the notes instead.
+
 Run in a folder with a base in it or under it, the notes can be left out. This starts the isorite server for the notes, unless one is running on port 4767 (`--port <n>` for another), and the agent behind it. Every message passes through: the session is live in the front end and in the pane at once, asked from either. isorite's MCP is added to each session the agent opens, so the agent needs no config of its own for it.
 
 ### In the agent's own terminal