@tiagojct/subsub 0.10.0 → 0.11.0

package/src/subsub.ts

@@ -1,15 +1,14 @@
 /**
  * Sub-Sub: a Zotero librarian and research assistant for pi.
  *
- * - One assistant: it reads the library, searches PubMed, Europe PMC and
- *   OpenAlex, writes notes in the Sub-Sub folder and, with library changes on,
- *   changes the library. /library on|off is the switch (saved in the settings).
+ * - Two modes: the Librarian manages the library (Zotero tools only); the
+ *   Researcher does the same and also searches PubMed, Europe PMC and OpenAlex
+ *   and writes notes. Each mode can have its own model.
  * - An approval gate: every library change is previewed by the server (dry run)
  *   and shown to the user; nothing is applied without a yes.
  * - Profiles (reader, scholar, author, editor) set what Sub-Sub writes and which
  *   tools it offers; /profile changes it.
- * - Commands: /library, /profile, /subsub, /history, /undo. /librarian and
- *   /researcher (the two modes before 0.10) turn library changes on and off.
+ * - Commands: /librarian, /researcher, /profile, /subsub, /history, /undo.
  * - Add-on: with "addons": ["starbuck"], Starbuck runs as a third server
  *   ("verify") for reference checks.
  *
@@ -29,6 +28,7 @@ import {
 	loadConfig,
 	parseEnvFile,
 	type Profile,
+	type Mode,
 	saveConfig,
 	serverCommand,
 	starbuckCommand,
@@ -45,6 +45,8 @@ import { headerLines, type LibraryState, paintPreview, QUOTES, type Scheme, sche
 import { systemAddition } from "./prompt.ts";
 import { gateKind, SERVER_PREFIXES, toolsFor, unavailableReason } from "./roles.ts";
 
+const MODE_ENTRY = "subsub-mode";
+
 export interface SubsubDeps {
 	config?: SubsubConfig;
 	/** A ready bridge (tests). When given, Sub-Sub does not start or stop servers. */
@@ -127,12 +129,11 @@ export async function createSubsub(pi: ExtensionAPI, deps: SubsubDeps = {}): Pro
 
 	if (deps.bridge) registerTools(deps.bridge);
 
-	pi.registerFlag("read-only", { description: "Start Sub-Sub with library changes off (this run only)", type: "boolean", default: false });
-	pi.registerFlag("librarian", { description: "Start Sub-Sub with library changes on (this run only)", type: "boolean", default: false });
+	pi.registerFlag("librarian", { description: "Start Sub-Sub in the Librarian mode", type: "boolean", default: false });
 
-	let libraryChanges = cfg.libraryChanges;
+	let mode: Mode = cfg.defaultMode;
 	const benchRun = Boolean(process.env.SUBSUB_BENCH_OUT);
-	const toolOpts = () => ({ libraryChanges, profile, bench: benchRun });
+	const toolOpts = () => ({ profile, bench: benchRun });
 	let profile: Profile = cfg.profile;
 	const user = who(cfg);
 	/** True when started with the `subsub` command (not as a package inside plain pi). */
@@ -154,7 +155,7 @@ export async function createSubsub(pi: ExtensionAPI, deps: SubsubDeps = {}): Pro
 		if (!webView || !ctx || ctx.mode !== "rpc") return;
 		const down = bridge ? Object.keys(bridge.errors) : ["zotero", "scholar"];
 		const state = {
-			libraryChanges,
+			mode,
 			profile,
 			profileLabel: profileSpec(profile).label,
 			model: ctx.model ? { provider: ctx.model.provider, id: ctx.model.id } : null,
@@ -221,7 +222,7 @@ export async function createSubsub(pi: ExtensionAPI, deps: SubsubDeps = {}): Pro
 					const th = ctx.ui.theme;
 					return headerLines({
 						version,
-						libraryChanges,
+						mode,
 						profile: profileSpec(profile).label,
 						model: modelId,
 						library,
@@ -244,37 +245,27 @@ export async function createSubsub(pi: ExtensionAPI, deps: SubsubDeps = {}): Pro
 	function status(ctx: ExtensionContext): void {
 		modelId = ctx.model ? `${ctx.model.id}` : "no model";
 		const down = bridge ? Object.keys(bridge.errors) : ["zotero", "scholar"];
-		const lib = libraryChanges ? "library changes on" : "read only";
-		ctx.ui.setStatus("subsub", `Sub-Sub: ${lib} | ${profileSpec(profile).label} | ${modelId}${down.length ? ` | not running: ${down.join(", ")}` : ""}`);
-		if (standalone) ctx.ui.setTitle(libraryChanges ? "Sub-Sub" : "Sub-Sub (read only)");
+		ctx.ui.setStatus("subsub", `Sub-Sub: ${mode} | ${profileSpec(profile).label} | ${modelId}${down.length ? ` | not running: ${down.join(", ")}` : ""}`);
+		if (standalone) ctx.ui.setTitle(`Sub-Sub: ${mode}`);
 		headerTui?.requestRender();
 		webCtx = ctx;
 		emitWeb();
 	}
 
-	/** Set the tools for the switch and the profile; save the switch when asked. */
-	function applyLibrary(ctx: ExtensionContext, on: boolean, save: boolean): void {
-		libraryChanges = on;
-		pi.setActiveTools(toolsFor(registered(), toolOpts()));
-		if (save) {
-			try {
-				saveConfig({ libraryChanges: on });
-			} catch (err) {
-				ctx.ui.notify(`Sub-Sub: the setting was not saved: ${(err as Error).message}`, "warning");
-			}
+	async function applyMode(ctx: ExtensionContext, next: Mode, remember: boolean): Promise<void> {
+		mode = next;
+		pi.setActiveTools(toolsFor(mode, registered(), toolOpts()));
+		const spec = cfg.models[mode];
+		if (spec) {
+			const i = spec.indexOf("/");
+			const model = i > 0 ? ctx.modelRegistry.find(spec.slice(0, i), spec.slice(i + 1)) : undefined;
+			const ok = model ? await pi.setModel(model) : false;
+			if (!ok) ctx.ui.notify(`Sub-Sub: cannot use ${spec} (unknown model or no key); keeping the current model.`, "warning");
 		}
+		if (remember) pi.appendEntry(MODE_ENTRY, { mode });
 		status(ctx);
 	}
 
-	async function applyModel(ctx: ExtensionContext): Promise<void> {
-		const spec = cfg.model;
-		if (!spec) return;
-		const i = spec.indexOf("/");
-		const model = i > 0 ? ctx.modelRegistry.find(spec.slice(0, i), spec.slice(i + 1)) : undefined;
-		const ok = model ? await pi.setModel(model) : false;
-		if (!ok) ctx.ui.notify(`Sub-Sub: cannot use ${spec} (unknown model or no key); keeping the current model.`, "warning");
-	}
-
 	pi.on("session_start", async (_event, ctx) => {
 		if (!bridge) {
 			const b = new Bridge();
@@ -282,12 +273,15 @@ export async function createSubsub(pi: ExtensionAPI, deps: SubsubDeps = {}): Pro
 			bridge = b;
 			registerTools(b);
 		}
+		let restored: Mode | undefined;
+		for (const e of ctx.sessionManager.getBranch() as Array<{ customType?: string; data?: { mode?: unknown } }>) {
+			const m = e.customType === MODE_ENTRY ? e.data?.mode : undefined;
+			if (m === "librarian" || m === "researcher") restored = m;
+		}
 		// Judge light or dark before Sub-Sub changes the theme.
 		if (lookOn(ctx)) scheme ??= schemeFromAnsi(ctx.ui.theme.getFgAnsi("text"), ctx.ui.theme.name);
-		await applyModel(ctx);
 		applyTheme(ctx);
-		// The flags change this run only; the saved setting stays.
-		applyLibrary(ctx, pi.getFlag("read-only") ? false : pi.getFlag("librarian") ? true : cfg.libraryChanges, false);
+		await applyMode(ctx, restored ?? (pi.getFlag("librarian") ? "librarian" : cfg.defaultMode), false);
 		if (lookOn(ctx)) {
 			setHeader(ctx);
 			void refreshLibrary();
@@ -318,7 +312,7 @@ export async function createSubsub(pi: ExtensionAPI, deps: SubsubDeps = {}): Pro
 	});
 
 	pi.on("before_agent_start", async (event, ctx) => ({
-		systemPrompt: `${event.systemPrompt}\n\n${systemAddition({ ...cfg, profile }, ctx.cwd, libraryChanges)}`,
+		systemPrompt: `${event.systemPrompt}\n\n${systemAddition(mode, { ...cfg, profile }, ctx.cwd)}`,
 	}));
 
 	/** Model test (subsub-bench): record every change instead of asking, and apply none. */
@@ -333,7 +327,7 @@ export async function createSubsub(pi: ExtensionAPI, deps: SubsubDeps = {}): Pro
 		if (schema) coerceArgs(schema, input);
 		resolvePathArgs(name, input, (p) => normalizeToolPath(p, ctx.cwd));
 		if (SERVER_PREFIXES.some((p) => name.startsWith(p))) {
-			const why = unavailableReason(name, registered(), toolOpts());
+			const why = unavailableReason(name, mode, registered(), toolOpts());
 			if (why) {
 				if (benchOut) record({ kind: "wrong_mode", tool: name, input });
 				return { block: true, reason: why };
@@ -447,39 +441,19 @@ export async function createSubsub(pi: ExtensionAPI, deps: SubsubDeps = {}): Pro
 		};
 	}
 
-	const libraryNote = (on: boolean) =>
-		on
-			? "Sub-Sub: library changes on. Every change shows a preview first."
-			: "Sub-Sub: library changes off. Sub-Sub reads, searches and writes notes; it does not change the library.";
-
-	pi.registerCommand("library", {
-		description: "Sub-Sub: turn library changes on or off (/library on, /library off)",
-		handler: async (args, ctx) => {
-			const a = args.trim().toLowerCase();
-			const on = a === "on" ? true : a === "off" ? false : a === "" ? !libraryChanges : undefined;
-			if (on === undefined) {
-				ctx.ui.notify("Type /library on or /library off.", "warning");
-				return;
-			}
-			applyLibrary(ctx, on, true);
-			ctx.ui.notify(libraryNote(on), "info");
-		},
-	});
-
-	// The two modes before 0.10, kept so that old habits and notes still work.
 	pi.registerCommand("librarian", {
-		description: "Sub-Sub: same as /library on",
+		description: "Sub-Sub: switch to the Librarian (manages the library: tags, imports, metadata, PDFs)",
 		handler: async (_args, ctx) => {
-			applyLibrary(ctx, true, true);
-			ctx.ui.notify(`${libraryNote(true)} (/librarian is now /library on.)`, "info");
+			await applyMode(ctx, "librarian", true);
+			ctx.ui.notify("Sub-Sub: Librarian mode. For searches and notes, switch to /researcher.", "info");
 		},
 	});
 
 	pi.registerCommand("researcher", {
-		description: "Sub-Sub: same as /library off",
+		description: "Sub-Sub: switch to the Researcher (searches, notes, reviews, and everything the Librarian does)",
 		handler: async (_args, ctx) => {
-			applyLibrary(ctx, false, true);
-			ctx.ui.notify(`${libraryNote(false)} (/researcher is now /library off.)`, "info");
+			await applyMode(ctx, "researcher", true);
+			ctx.ui.notify("Sub-Sub: Researcher mode. It searches, writes notes and also changes the library, with a preview.", "info");
 		},
 	});
 
@@ -502,7 +476,7 @@ export async function createSubsub(pi: ExtensionAPI, deps: SubsubDeps = {}): Pro
 			} catch (err) {
 				saved = ` Not saved: ${(err as Error).message}`;
 			}
-			applyLibrary(ctx, libraryChanges, false);
+			await applyMode(ctx, mode, false);
 			ctx.ui.notify(`Sub-Sub: ${profileSpec(profile).label} profile (${profileSpec(profile).summary}).${saved}`, "info");
 		},
 	});
@@ -510,7 +484,7 @@ export async function createSubsub(pi: ExtensionAPI, deps: SubsubDeps = {}): Pro
 	pi.registerCommand("subsub", {
 		description: "Sub-Sub: Zotero connection and library overview",
 		handler: async (_args, ctx) => {
-			const lines = [`Library changes: ${libraryChanges ? "on" : "off"}. Profile: ${profileSpec(profile).label}. Model: ${ctx.model?.id ?? "none"}.`];
+			const lines = [`Mode: ${mode}. Profile: ${profileSpec(profile).label}. Model: ${ctx.model?.id ?? "none"}.`];
 			if (!bridge) {
 				ctx.ui.notify(`${lines[0]}\nThe Zotero servers are not running. Try /reload.`, "warning");
 				return;

package/src/web.ts

@@ -23,7 +23,7 @@ import { extname, join, normalize, resolve, sep } from "node:path";
 import { StringDecoder } from "node:string_decoder";
 import { agentDirFor, chooseCwd, PACKAGE_DIR, packageVersion } from "./cli.ts";
 import { expand, loadConfig, saveConfig, type SubsubConfig, withStarbuck } from "./config.ts";
-import { TESTED_MODEL } from "./init.ts";
+import { TESTED_MODELS } from "./init.ts";
 import { obsidianRoot } from "./layout.ts";
 import { realish, within } from "./paths.ts";
 
@@ -568,9 +568,11 @@ export async function startWeb(opts: WebOptions, env: NodeJS.ProcessEnv = proces
 					if (busy) return send(res, 409, { error: "busy" });
 					const body = await readJson(req);
 					const spec = `${String(body.provider)}/${String(body.id)}`;
-					// Remember the model (and drop the per-mode models of versions before 0.10), then restart pi
-					// so the extension reads the new setting.
-					saveConfig({ model: spec, models: undefined }, env);
+					// Remember the model for the current mode (or both), then restart pi so the extension reads it.
+					const mode = (subsubState as { mode?: string } | null)?.mode === "librarian" ? "librarian" : "researcher";
+					const models: Record<string, string> = { ...(loadConfig(env).models ?? {}), [mode]: spec };
+					if (body.both) models[mode === "librarian" ? "researcher" : "librarian"] = spec;
+					saveConfig({ models, model: undefined }, env);
 					await agent.request({ type: "set_model", provider: String(body.provider), modelId: String(body.id) });
 					await restartAgent();
 					return send(res, 200, { ok: true });
@@ -594,7 +596,7 @@ export async function startWeb(opts: WebOptions, env: NodeJS.ProcessEnv = proces
 					const body = await readJson(req);
 					saveApiKey(agentDir, String(body.provider ?? ""), String(body.key ?? ""));
 					const current = loadConfig(env);
-					if (body.provider === "opencode-go" && !current.model) saveConfig({ model: TESTED_MODEL, models: undefined }, env);
+					if (body.provider === "opencode-go" && Object.keys(current.models).length === 0) saveConfig({ models: TESTED_MODELS, model: undefined }, env);
 					await restartAgent();
 					return send(res, 200, { ok: true });
 				}

package/templates/Zotero agent.md

@@ -2,8 +2,8 @@ Shared rules for Sub-Sub. Sub-Sub reads this file at the start of every session.
 
 ## What Sub-Sub does
 
-- Sub-Sub reads the library, searches PubMed, Europe PMC and OpenAlex, and writes notes in this folder.
-- With library changes on, it also changes the library: tags, imports, metadata, PDFs, collections, notes in Zotero. Every change shows a preview and needs the user's yes.
+- Sub-Sub has two modes. The Librarian manages the library: tags, imports, metadata, PDFs, collections, notes in Zotero. The Researcher reads the library, searches PubMed, Europe PMC and OpenAlex, writes notes in this folder, and also does everything the Librarian does.
+- Every library change shows a preview and needs the user's yes.
 - Works found in a search are imported directly when the user chooses them. For a list to choose from later, Sub-Sub writes Inbox/Zotero import queue.md; the user ticks the lines and Sub-Sub imports them.
 
 ## Safety

package/web/app.css

@@ -87,8 +87,9 @@
 	--warn: #d6a84e;
 }
 
-/* One accent, blue. Rust marks the switch that lets Sub-Sub change the library. */
+/* The mode sets the accent: blue for the Researcher, rust for the Librarian. */
 body { --accent: var(--researcher); --accent-soft: var(--researcher-soft); }
+body[data-mode="librarian"] { --accent: var(--librarian); --accent-soft: var(--librarian-soft); }
 
 /* ---------------------------------------------------------------- base */
 
@@ -219,20 +220,27 @@ select:hover { border-color: var(--rule-strong); }
 .brand .mark { color: var(--accent); }
 .brand .hyphen { color: var(--accent); }
 
-/* The library switch in the top bar: rust when Sub-Sub may change the library. */
-.lib-switch {
-	padding: 0.3rem 0.7rem 0.3rem 0.5rem;
-	border: 1px solid var(--rule);
-	border-radius: 999px;
+.modes {
+	display: inline-flex;
+	padding: 3px;
+	border-radius: 8px;
 	background: var(--surface);
-	font-size: 0.84rem;
+	border: 1px solid var(--rule);
+}
+.modes button {
+	padding: 0.28rem 0.8rem;
+	border-radius: 5px;
+	font-size: 0.86rem;
 	color: var(--muted);
-	white-space: nowrap;
+	border: 0;
+}
+.modes button:hover { color: var(--text); }
+.modes button[aria-pressed="true"] {
+	background: var(--raised);
+	color: var(--accent);
+	font-weight: 600;
+	box-shadow: 0 1px 2px rgb(0 0 0 / 0.08), 0 0 0 1px var(--rule);
 }
-.lib-switch:hover { border-color: var(--rule-strong); color: var(--text); }
-.top .lib-switch input:checked + .track { background: var(--librarian); }
-body[data-library="on"] .lib-switch { color: var(--text); }
-body[data-library="off"] .top { border-top-color: var(--rule-strong); }
 
 .status {
 	margin-left: auto;
@@ -855,8 +863,7 @@ body > p.empty { text-align: center; color: var(--muted); padding: 30vh 1rem 0;
 
 @media (max-width: 30rem) {
 	.brand > span { display: none; }
-	.lib-switch > span:last-child { display: none; }
-	.lib-switch { padding: 0.35rem 0.5rem; }
+	.modes button { padding: 0.28rem 0.6rem; }
 }
 
 @media (prefers-reduced-motion: reduce) {

package/web/app.js

@@ -7,7 +7,7 @@ import { ACTIONS, STRINGS, SUGGESTIONS, TOOLS } from "/i18n.js";
 // ---------------------------------------------------------------- state
 
 let lang = "en";
-let state = null; // Sub-Sub's own state: libraryChanges, profile, model, library, down
+let state = null; // Sub-Sub's own state: mode, profile, model, library, down
 let session = null; // pi's session state
 let busy = false;
 let commands = [];
@@ -169,15 +169,16 @@ function applyLang() {
 	updateLayoutUI();
 }
 
-/** Library changes on (the default until the state arrives). */
-function libOn() {
-	return state?.libraryChanges !== false;
+function mode() {
+	return state?.mode === "librarian" ? "librarian" : "researcher";
 }
 
 function renderHeader() {
-	document.body.dataset.library = libOn() ? "on" : "off";
-	$("library-switch").checked = libOn();
-	$("library-switch-label").title = t("libraryHint");
+	document.body.dataset.mode = mode();
+	for (const b of document.querySelectorAll(".modes button")) {
+		b.setAttribute("aria-pressed", String(b.dataset.mode === mode()));
+		b.title = t(b.dataset.mode === "librarian" ? "librarianHint" : "researcherHint");
+	}
 	if (state?.profile) $("profile").value = $("profile-side").value = state.profile;
 	$("starbuck-toggle").checked = Boolean(state?.starbuck);
 	$("starbuck-label").title = t("starbuckHint");
@@ -205,7 +206,7 @@ function renderHeader() {
 		lib.classList.add("down");
 	}
 	lib.title = txt.textContent;
-	$("input").placeholder = libOn() ? t("placeholder") : t("placeholderReadOnly");
+	$("input").placeholder = mode() === "librarian" ? t("placeholderLibrarian") : t("placeholderResearcher");
 	if (log.querySelector(".empty")) {
 		clearEmpty();
 		renderEmpty();
@@ -225,10 +226,11 @@ function renderActions() {
 	box.replaceChildren();
 	const shown = (a) =>
 		hasCommand(a.cmd) &&
-		(!a.changes || libOn()) &&
+
 		(!a.needs || state?.[a.needs]) &&
 		(!a.profiles || a.profiles.includes(state?.profile ?? "scholar"));
-	for (const [group, label] of [["research", "groupResearch"], ["library", "groupLibrary"]]) {
+	const groups = mode() === "librarian" ? [["library", "groupLibrary"]] : [["research", "groupResearch"], ["library", "groupLibrary"]];
+	for (const [group, label] of groups) {
 		const list = ACTIONS[group].filter(shown);
 		if (!list.length) continue;
 		box.append(el("p", { class: "group", text: t(label) }));
@@ -376,14 +378,14 @@ function clearEmpty() {
 
 function renderEmpty() {
 	if (log.children.length) return;
-	const s = SUGGESTIONS.filter((x) => !x.changes || libOn()).map((x) => x[lang] ?? x.en);
+	const s = SUGGESTIONS[mode()].map((x) => x[lang] ?? x.en);
 	log.append(
 		el(
 			"div",
 			{ class: "empty" },
-			el("p", { class: "kicker", text: libOn() ? t("assistant") : `${t("assistant")} · ${t("readOnly")}` }),
+			el("p", { class: "kicker", text: t(mode()) }),
 			el("h1", { text: t("emptyTitle") }),
-			el("p", { class: "lede", text: t(libOn() ? "emptyOn" : "emptyOff") }),
+			el("p", { class: "lede", text: t(mode() === "librarian" ? "emptyLibrarian" : "emptyResearcher") }),
 			el(
 				"div",
 				{ class: "chips" },
@@ -715,8 +717,8 @@ function onEvent(ev) {
 			break;
 		case "extension_ui_request":
 			if (ev.method === "notify") {
-				// The switch shows the state; these confirmations would only repeat it.
-				if (/^Sub-Sub: library changes (on|off)\./.test(ev.message)) break;
+				// The mode buttons show the mode; these confirmations would only repeat it.
+				if (/^Sub-Sub: (Librarian|Researcher) mode\./.test(ev.message)) break;
 				note(ev.message, ev.notifyType === "error" ? "error" : ev.notifyType === "warning" ? "warning" : "info", /\n/.test(ev.message));
 			} else {
 				dialogs.push(ev);
@@ -901,7 +903,7 @@ async function openModels() {
 					onclick: async () => {
 						if (busy) return note(t("busy"), "warning");
 						try {
-							await api("/api/model", { provider: m.provider, id: m.id });
+							await api("/api/model", { provider: m.provider, id: m.id, both: $("model-both").checked });
 							dlg.close();
 						} catch (err) {
 							note(err.message, "error");
@@ -1042,12 +1044,11 @@ $("new-btn").addEventListener("click", async () => {
 		note(err.message, "error");
 	}
 });
-$("library-switch").addEventListener("change", async (e) => {
-	const on = e.target.checked;
-	if (on === libOn()) return;
-	const ok = await sendMessage(`/library ${on ? "on" : "off"}`);
-	if (!ok) e.target.checked = libOn();
-});
+for (const b of document.querySelectorAll(".modes button")) {
+	b.addEventListener("click", () => {
+		if (b.dataset.mode !== mode()) sendMessage(`/${b.dataset.mode}`);
+	});
+}
 $("profile").addEventListener("change", (e) => sendMessage(`/profile ${e.target.value}`));
 $("starbuck-toggle").addEventListener("change", async (e) => {
 	const on = e.target.checked;

package/web/i18n.js

@@ -79,14 +79,15 @@ export const STRINGS = {
 		starbuckOff: "Reference checks are off.",
 		composerHint: "Enter sends. Shift+Enter starts a new line. / shows the commands.",
 		previewKicker: "Preview",
-		assistant: "Assistant",
-		readOnly: "Read only",
-		libraryChanges: "Library changes",
-		libraryHint: "On: Sub-Sub can import, tag and repair items, and every change shows a preview first. Off: it only reads, searches and writes notes.",
-		placeholder: "Ask about your library, or type / for commands",
-		placeholderReadOnly: "Ask about your library (read only), or type / for commands",
-		emptyOn: "Sub-Sub reads your library, searches PubMed, Europe PMC and OpenAlex, and writes notes. It also imports and tags: every change shows a preview, and nothing changes until you approve it.",
-		emptyOff: "Library changes are off. Sub-Sub reads your library, searches and writes notes, but does not change the library. Turn them on with the switch at the top.",
+		researcher: "Researcher",
+		librarian: "Librarian",
+		researcherHint: "Searches, reads and writes notes, and also changes the library (every change is previewed).",
+		librarianHint: "Manages the library only: tags, imports, metadata, PDFs. No literature search.",
+		placeholderResearcher: "Ask about your library or the literature, or type / for commands",
+		placeholderLibrarian: "Ask for a change to your library, or type / for commands",
+		emptyResearcher: "The Researcher reads your library, searches PubMed, Europe PMC and OpenAlex and writes notes. It also imports, tags and repairs items: every change shows a preview, and nothing changes until you approve it.",
+		emptyLibrarian: "The Librarian manages your library: tags, imports, metadata and PDFs. Every change shows a preview, and nothing changes until you approve it. For searches and notes, switch to the Researcher.",
+		forBoth: "Use it in both modes",
 		groupResearch: "Research",
 		groupLibrary: "Library",
 	},
@@ -167,14 +168,15 @@ export const STRINGS = {
 		starbuckOff: "A verificação de referências está desligada.",
 		composerHint: "Enter envia. Shift+Enter muda de linha. / mostra os comandos.",
 		previewKicker: "Pré-visualização",
-		assistant: "Assistente",
-		readOnly: "Só leitura",
-		libraryChanges: "Alterações à biblioteca",
-		libraryHint: "Ligado: o Sub-Sub pode importar, etiquetar e corrigir itens, e cada alteração mostra primeiro uma pré-visualização. Desligado: só lê, pesquisa e escreve notas.",
-		placeholder: "Pergunte sobre a sua biblioteca, ou escreva / para ver os comandos",
-		placeholderReadOnly: "Pergunte sobre a sua biblioteca (só leitura), ou escreva / para ver os comandos",
-		emptyOn: "O Sub-Sub lê a sua biblioteca, pesquisa na PubMed, Europe PMC e OpenAlex e escreve notas. Também importa e etiqueta: cada alteração mostra uma pré-visualização, e nada muda até a aprovar.",
-		emptyOff: "As alterações à biblioteca estão desligadas. O Sub-Sub lê a biblioteca, pesquisa e escreve notas, mas não altera a biblioteca. Ligue-as no interruptor no topo.",
+		researcher: "Investigador",
+		librarian: "Bibliotecário",
+		researcherHint: "Pesquisa, lê e escreve notas, e também altera a biblioteca (cada alteração é pré-visualizada).",
+		librarianHint: "Só gere a biblioteca: etiquetas, importações, metadados, PDF. Não pesquisa a literatura.",
+		placeholderResearcher: "Pergunte sobre a sua biblioteca ou a literatura, ou escreva / para ver os comandos",
+		placeholderLibrarian: "Peça uma alteração à biblioteca, ou escreva / para ver os comandos",
+		emptyResearcher: "O Investigador lê a sua biblioteca, pesquisa na PubMed, Europe PMC e OpenAlex e escreve notas. Também importa, etiqueta e corrige itens: cada alteração mostra uma pré-visualização, e nada muda até a aprovar.",
+		emptyLibrarian: "O Bibliotecário gere a sua biblioteca: etiquetas, importações, metadados e PDF. Cada alteração mostra uma pré-visualização, e nada muda até a aprovar. Para pesquisar e escrever notas, mude para o Investigador.",
+		forBoth: "Usar nos dois modos",
 		groupResearch: "Investigação",
 		groupLibrary: "Biblioteca",
 	},
@@ -182,7 +184,7 @@ export const STRINGS = {
 
 /**
  * Buttons in the side panel, in two groups. `fill` puts the command in the message box; `send` runs it at once.
- * `changes`: shown only with library changes on. `profiles` and `needs` limit a button to some profiles or add-ons.
+ * The Librarian sees the Library group only. `profiles` and `needs` limit a button to some profiles or add-ons.
  */
 export const ACTIONS = {
 	research: [
@@ -200,21 +202,27 @@ export const ACTIONS = {
 	],
 	library: [
 		{ cmd: "subsub", send: true, en: "Library overview", pt: "Resumo da biblioteca" },
-		{ cmd: "tag-batch 10", send: true, changes: true, en: "Tag 10 items", pt: "Etiquetar 10 itens" },
-		{ cmd: "clean-tags", send: true, changes: true, en: "Clean up tags", pt: "Limpar etiquetas" },
-		{ cmd: "import-queue", send: true, changes: true, en: "Import the queue", pt: "Importar a fila" },
+		{ cmd: "tag-batch 10", send: true, en: "Tag 10 items", pt: "Etiquetar 10 itens" },
+		{ cmd: "clean-tags", send: true, en: "Clean up tags", pt: "Limpar etiquetas" },
+		{ cmd: "import-queue", send: true, en: "Import the queue", pt: "Importar a fila" },
 		{ cmd: "history", send: true, en: "Recent changes", pt: "Alterações recentes" },
-		{ cmd: "undo", send: true, changes: true, en: "Undo the last change", pt: "Desfazer a última alteração" },
+		{ cmd: "undo", send: true, en: "Undo the last change", pt: "Desfazer a última alteração" },
 	],
 };
 
-/** Suggestions on an empty conversation. `changes`: only with library changes on. */
-export const SUGGESTIONS = [
-	{ en: "What do I have on ", pt: "O que tenho sobre " },
-	{ en: "Find recent systematic reviews on ", pt: "Procure revisões sistemáticas recentes sobre " },
-	{ en: "Tag the next 10 items without a topic", pt: "Etiquete os próximos 10 itens sem tópico", changes: true },
-	{ en: "Import 10.1136/bmj.n71", pt: "Importe 10.1136/bmj.n71", changes: true },
-];
+/** Suggestions on an empty conversation, per mode. */
+export const SUGGESTIONS = {
+	researcher: [
+		{ en: "What do I have on ", pt: "O que tenho sobre " },
+		{ en: "Find recent systematic reviews on ", pt: "Procure revisões sistemáticas recentes sobre " },
+		{ en: "Which items have no PDF?", pt: "Que itens não têm PDF?" },
+	],
+	librarian: [
+		{ en: "Tag the next 10 items without a topic", pt: "Etiquete os próximos 10 itens sem tópico" },
+		{ en: "Import 10.1136/bmj.n71", pt: "Importe 10.1136/bmj.n71" },
+		{ en: "Find duplicates", pt: "Procure duplicados" },
+	],
+};
 
 /** Plain names for the tools, shown while they run. Unknown tools keep their name. */
 export const TOOLS = {

package/web/index.html

@@ -10,12 +10,15 @@
 	<link rel="stylesheet" href="/app.css">
 	<script type="module" src="/app.js"></script>
 </head>
-<body data-library="on">
+<body data-mode="researcher">
 	<div class="app">
 		<header class="top">
 			<button type="button" class="icon-btn" id="menu-btn" aria-controls="side" aria-expanded="true" data-i18n-title="menu" title="Menu"><svg viewBox="0 0 24 24" aria-hidden="true"><rect x="3.5" y="4.5" width="17" height="15" rx="2"/><path d="M9.5 4.5v15"/></svg><span class="visually-hidden" data-i18n="menu">Menu</span></button>
 			<div class="brand"><svg class="mark" viewBox="0 0 24 24" aria-hidden="true"><rect x="3" y="5" width="18" height="14" rx="1.5"/><path d="M6.5 9h7M6.5 12h11"/><circle cx="12" cy="16" r="1.1"/></svg><span>Sub<span class="hyphen">-</span>Sub</span></div>
-			<label class="switch lib-switch" id="library-switch-label"><input type="checkbox" role="switch" id="library-switch" checked><span class="track" aria-hidden="true"></span><span data-i18n="libraryChanges">Library changes</span></label>
+			<div class="modes" role="group" aria-label="Mode">
+				<button type="button" data-mode="researcher" aria-pressed="true" data-i18n="researcher">Researcher</button>
+				<button type="button" data-mode="librarian" aria-pressed="false" data-i18n="librarian">Librarian</button>
+			</div>
 			<div class="status">
 				<span class="library" id="library"><span class="library-dot" aria-hidden="true"></span><span class="library-text"></span></span>
 				<label class="profile wide-only"><span class="visually-hidden" data-i18n="profile">Profile</span>
@@ -107,6 +110,7 @@
 			<button type="button" class="link-btn" id="model-close" data-i18n="close">Close</button>
 		</div>
 		<h3 data-i18n="chooseModel">Choose a model</h3>
+		<label class="check"><input type="checkbox" id="model-both"> <span data-i18n="forBoth">Use it in both modes</span></label>
 		<ul class="models" id="models"></ul>
 		<h3 data-i18n="connectProvider">Connect a provider</h3>
 		<form id="login-form" class="login">