@tekmidian/pai 0.37.0 → 0.39.0

package/dist/{program-CEIHn_Ma.mjs → program-DXBwJV7h.mjs}

@@ -11,10 +11,11 @@ import { _ as findMovedProjects, a as findLatestNote, c as extractAndStoreTriple
 import { a as schedulerLogPath, i as paiSocketPath, n as daemonLogPath, r as daemonPidPath } from "./runtime-paths-rni52zHX.mjs";
 import { t as PaiClient } from "./ipc-client-BmypMNYk.mjs";
 import { a as expandHome, c as UNROUTED, i as ensureConfigDir, n as CONFIG_FILE$2, o as loadConfig, s as OWNER_LABEL_PREFIX, t as CONFIG_DIR } from "./config-B64vFg14.mjs";
-import { r as humanDuration, t as createStorageBackend } from "./factory-DD2T33C9.mjs";
-import { A as readJsonStrict, C as loadStatus, D as workersLogDir, E as ledgerPath, O as WorkersConfigError, S as openPaneForWorker, T as eventsPath, _ as stopProxy, a as setRole, b as checkPaneForWorker, c as useProvider, d as replayOutput, f as statusLineOutput, g as ensureProxyRunning, h as DEFAULT_PROXY_PORT, i as setProviderEnabled, j as writeJsonAtomic, k as readWorkersSection, l as followWorkers, m as testProvider, n as describeProviders, o as setWorkersEnabled, p as runWorker, r as removeProvider, s as unsetRole, t as addProvider, u as psOutput, v as sayToWorker, x as openFollowPane, y as describeMcp } from "./providers-sXcK5bDZ.mjs";
+import { r as humanDuration, t as createStorageBackend } from "./factory-A9x-T2Kg.mjs";
+import { B as workersLogDir, H as PROVIDER_TAGS, I as parseRunnerArgs, J as readWorkersSection, R as eventsPath, U as WorkersConfigError, X as readJsonStrict, Z as writeJsonAtomic, a as testProvider, b as openPaneForWorker, c as stopProxy, f as discardWorker, g as sayToWorker, i as runWorker, j as loadStatus, l as describeMcp, m as handoffFromInside, o as DEFAULT_PROXY_PORT, p as mergeWorker, s as ensureProxyRunning, t as runChain, v as checkPaneForWorker, y as openFollowPane, z as ledgerPath } from "./chain-CTtHligI.mjs";
 import { s as kgQuery } from "./kg-entity-r8duqhi9.mjs";
 import { _ as scanSessions, a as renderDedupedSessions, c as probeResume, d as callAiBroker, f as fetchLiveSessions, g as resolveSessionByNameOrId, h as fmtAge, i as normalizeName$2, l as restoreTopLevel, m as sendToSession, o as hasConversation, p as revealItermSession, r as buildDeduped, s as launchInDir, t as cmdMain, u as printExitDir } from "./main-resolver-DlaLOFBA.mjs";
+import { a as setClass, c as unsetClass, d as followWorkers, f as psOutput, i as removeProvider, l as updateProvider, m as statusLineOutput, n as classTargetText, o as setProviderEnabled, p as replayOutput, r as describeProviders, s as setWorkersEnabled, t as addProvider, u as useProvider } from "./providers-FYkZjn_C.mjs";
 import { appendFileSync, chmodSync, copyFileSync, createReadStream, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, readlinkSync, realpathSync, renameSync, statSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
 import { homedir, platform, tmpdir } from "node:os";
 import { basename, dirname, join, relative, resolve, sep } from "node:path";
@@ -1889,7 +1890,7 @@ function cmdUnregister(db, slug, opts = {}) {
 //#region src/cli/commands/project/projects-index.ts
 function registerProjectsCommands(projectsCmd, getDb) {
 	projectsCmd.command("list", { isDefault: true }).description("Show the unified deduped listing (same as `pai`).\nUse --all to include cold / zero-session / archived projects.").option("--all", "Show all entries including cold / zero-session / archived projects").option("-n, --n <count>", "Max rows to show", "20").action(async (opts) => {
-		const { cmdMain } = await import("./main-resolver-IhZo4pI0.mjs");
+		const { cmdMain } = await import("./main-resolver-D6IImXvF.mjs");
 		await cmdMain(getDb(), void 0, void 0, opts);
 	});
 	projectsCmd.command("list-raw").description("Raw registry listing with slug, path, status, last_active columns").option("--all", "Include archived projects (default: active only)").option("--status <status>", "Filter by status: active | archived").option("--tag <tag>", "Filter by tag").option("--type <type>", "Filter by type").action((opts) => {
@@ -2961,9 +2962,9 @@ function registerStatsCommands(memoryCmd, getDb) {
 //#region src/cli/commands/memory/sources-cmd.ts
 function registerSourcesCommand(memoryCmd) {
 	memoryCmd.command("sources").description("Show what the indexer has taken in: composition by source, which roots\ncontent enters from, the heaviest single files, and how many chunks are\nrewritten per day (which distinguishes a finite backlog from a treadmill).").option("--limit <n>", "Rows per section (default 8)", "8").action(async (opts) => {
-		const { createStorageBackend } = await import("./factory-BXzqRYVZ.mjs");
+		const { createStorageBackend } = await import("./factory-BD-np0Vd.mjs");
 		const { loadConfig } = await import("./config-C_ErGddD.mjs");
-		const { cmdMemorySources } = await import("./sources-Bi7--33T.mjs");
+		const { cmdMemorySources } = await import("./sources-kLnQsNrW.mjs");
 		let backend;
 		try {
 			backend = await createStorageBackend(loadConfig());
@@ -3650,7 +3651,7 @@ function cmdLogs(opts) {
 }
 function registerDaemonCommands(daemonCmd) {
 	daemonCmd.command("serve").description("Start the PAI daemon in the foreground").action(async () => {
-		const { serve } = await import("./daemon-DsGGiIJM.mjs");
+		const { serve } = await import("./daemon-CmHHmKpg.mjs");
 		const { loadConfig: lc, ensureConfigDir } = await import("./config-C_ErGddD.mjs");
 		ensureConfigDir();
 		await serve(lc());
@@ -6253,7 +6254,7 @@ async function stepWorkers(rl) {
 		return { workers: {
 			enabled: false,
 			providers: {},
-			roles: {}
+			classes: {}
 		} };
 	}
 	line$1();
@@ -6265,14 +6266,14 @@ async function stepWorkers(rl) {
 	line$1(c.dim("      --key-file ~/.config/example/api_key \\"));
 	line$1(c.dim("      --model example-4.7 --fast-model example-4.7-flash"));
 	line$1();
-	line$1("  The first provider turns workers on and seeds the roles.");
+	line$1("  The first provider turns workers on and seeds the classes.");
 	line$1();
 	const r = installWorkers();
 	for (const l of r.lines) line$1(`  ${l}`);
 	return { workers: {
 		enabled: false,
 		providers: {},
-		roles: {}
+		classes: {}
 	} };
 }
 
@@ -7228,7 +7229,7 @@ async function cmdExplore(note, opts) {
 	const depth = parseInt(opts.depth ?? "3", 10);
 	const direction = opts.direction ?? "both";
 	const mode = opts.mode ?? "all";
-	const { zettelExplore } = await import("./zettelkasten-vo7psPdT.mjs");
+	const { zettelExplore } = await import("./zettelkasten-m5QPtb-L.mjs");
 	const result = zettelExplore(getFedDb(), {
 		startNote: note,
 		depth,
@@ -7293,7 +7294,7 @@ async function cmdHealth(opts) {
 	const projectPath = opts.project;
 	const recentDays = parseInt(opts.days ?? "30", 10);
 	const includeTypes = opts.include ? opts.include.split(",").map((s) => s.trim()) : void 0;
-	const { zettelHealth } = await import("./zettelkasten-vo7psPdT.mjs");
+	const { zettelHealth } = await import("./zettelkasten-m5QPtb-L.mjs");
 	const result = zettelHealth(getFedDb(), {
 		scope,
 		projectPath,
@@ -7364,7 +7365,7 @@ async function cmdSurprise(note, opts) {
 	const limit = parseInt(opts.limit ?? "10", 10);
 	const minSimilarity = parseFloat(opts.minSimilarity ?? "0.3");
 	const minGraphDistance = parseInt(opts.minDistance ?? "3", 10);
-	const { zettelSurprise } = await import("./zettelkasten-vo7psPdT.mjs");
+	const { zettelSurprise } = await import("./zettelkasten-m5QPtb-L.mjs");
 	const db = getFedDb();
 	console.log();
 	console.log(header("  PAI Zettel Surprise"));
@@ -7419,7 +7420,7 @@ async function cmdSuggest(note, opts) {
 	const vaultProjectId = parseInt(opts.vaultProjectId, 10);
 	const limit = parseInt(opts.limit ?? "5", 10);
 	const excludeLinked = opts.excludeLinked !== false;
-	const { zettelSuggest } = await import("./zettelkasten-vo7psPdT.mjs");
+	const { zettelSuggest } = await import("./zettelkasten-m5QPtb-L.mjs");
 	const db = getFedDb();
 	console.log();
 	console.log(header("  PAI Zettel Suggest"));
@@ -7472,7 +7473,7 @@ async function cmdConverse(question, opts) {
 	const vaultProjectId = parseInt(opts.vaultProjectId, 10);
 	const depth = parseInt(opts.depth ?? "2", 10);
 	const limit = parseInt(opts.limit ?? "15", 10);
-	const { zettelConverse } = await import("./zettelkasten-vo7psPdT.mjs");
+	const { zettelConverse } = await import("./zettelkasten-m5QPtb-L.mjs");
 	const db = getFedDb();
 	console.log();
 	console.log(header("  PAI Zettel Converse"));
@@ -7535,7 +7536,7 @@ async function cmdThemes(opts) {
 	const minClusterSize = parseInt(opts.minSize ?? "3", 10);
 	const maxThemes = parseInt(opts.maxThemes ?? "10", 10);
 	const similarityThreshold = parseFloat(opts.threshold ?? "0.65");
-	const { zettelThemes } = await import("./zettelkasten-vo7psPdT.mjs");
+	const { zettelThemes } = await import("./zettelkasten-m5QPtb-L.mjs");
 	const db = getFedDb();
 	console.log();
 	console.log(header("  PAI Zettel Themes"));
@@ -9110,7 +9111,7 @@ async function escalate(task, headline, detail, state, now, opts) {
 	state.alarmedAt[task.id] = now;
 	let delivered = false;
 	try {
-		const { routeNotification } = await import("./router-1zi8jiNF.mjs");
+		const { routeNotification } = await import("./router-Bk77E7hj.mjs");
 		const { loadConfig } = await import("./config-C_ErGddD.mjs");
 		delivered = (await routeNotification({
 			event: "error",
@@ -11727,9 +11728,9 @@ function cmdActive(db, opts) {
 	], rows));
 }
 async function cmdAutoRoute(opts) {
-	const { autoRoute, formatAutoRoute, formatAutoRouteJson } = await import("./auto-route-DM7GhJ8y.mjs");
+	const { autoRoute, formatAutoRoute, formatAutoRouteJson } = await import("./auto-route-BlWOWT4z.mjs");
 	const { openRegistry } = await import("./db-XEwJbuGO.mjs");
-	const { createStorageBackend } = await import("./factory-BXzqRYVZ.mjs");
+	const { createStorageBackend } = await import("./factory-BD-np0Vd.mjs");
 	const { loadConfig } = await import("./config-C_ErGddD.mjs");
 	const config = loadConfig();
 	const registryDb = openRegistry();
@@ -13577,6 +13578,99 @@ function registerSessionCommands(sessionCmd, getDb) {
 	});
 }
 
+//#endregion
+//#region src/workers/agents.ts
+/**
+* agents.ts — run agent definitions (~/.claude/agents/<name>.md) as workers.
+*
+* The file format is the Claude Code agent one: YAML front matter (`model`,
+* `tools`, `description`) followed by a Markdown body that is the agent's
+* system prompt. `pai worker run --agent <name>` loads it and maps it onto
+* the worker runner:
+*
+*   - body    → --append-system-prompt (prepended, so an explicit caller
+*               flag still wins);
+*   - tools   → --allowedTools;
+*   - model   → a task class (haiku→simple, sonnet→implement, opus→complex),
+*               unless --class is given.
+*/
+/** Directory the agent library lives in. */
+function agentsDir() {
+	return join(homedir(), ".claude", "agents");
+}
+function agentPath(name) {
+	return join(agentsDir(), `${name}.md`);
+}
+/** `key: value` (bare) or `key: [a, b]` / `key:\n  - a\n  - b` (list). */
+function parseFrontMatter(text) {
+	const out = {};
+	let key = "";
+	for (const raw of text.split("\n")) {
+		const listItem = /^\s+-\s+(.*)$/.exec(raw);
+		if (listItem && key) {
+			const cur = out[key];
+			const item = listItem[1].trim().replace(/^["']|["']$/g, "");
+			out[key] = Array.isArray(cur) ? [...cur, item] : [item];
+			continue;
+		}
+		const kv = /^([A-Za-z0-9_-]+):\s*(.*)$/.exec(raw);
+		if (!kv) continue;
+		key = kv[1];
+		const val = kv[2].trim();
+		if (!val) out[key] = [];
+		else if (val.startsWith("[") && val.endsWith("]")) out[key] = val.slice(1, -1).split(",").map((s) => s.trim().replace(/^["']|["']$/g, "")).filter(Boolean);
+		else out[key] = val.replace(/^["']|["']$/g, "");
+	}
+	return out;
+}
+/** Parse an agent file's text (front matter + body). Throws on empty body. */
+function parseAgentFile(name, text, path) {
+	const m = /^---\n([\s\S]*?)\n---\n?([\s\S]*)$/.exec(text);
+	if (!m) throw new Error(`${path}: expected YAML front matter (--- … ---) before the agent body`);
+	const fm = parseFrontMatter(m[1]);
+	const body = m[2].trim();
+	if (!body) throw new Error(`${path}: the agent body (after the front matter) is empty`);
+	const def = {
+		name,
+		body,
+		path
+	};
+	if (typeof fm.model === "string" && fm.model) def.model = fm.model;
+	if (Array.isArray(fm.tools) && fm.tools.length) def.tools = fm.tools;
+	if (typeof fm.description === "string" && fm.description) def.description = fm.description;
+	return def;
+}
+/** Load ~/.claude/agents/<name>.md; the error names the library when missing. */
+function loadAgent(name) {
+	const path = agentPath(name);
+	let text;
+	try {
+		text = readFileSync(path, "utf8");
+	} catch {
+		throw new Error(`no agent named "${name}" at ${path}. The agent library lives in ~/.claude/agents/<name>.md and runs on workers.`);
+	}
+	return parseAgentFile(name, text, path);
+}
+/** Map an agent's front-matter model to a worker class. */
+function modelToClass(model) {
+	if (!model) return void 0;
+	const m = model.toLowerCase();
+	if (m.includes("haiku")) return "simple";
+	if (m.includes("sonnet")) return "implement";
+	if (m.includes("opus")) return "complex";
+}
+/** Extra claude args the definition contributes (before the caller's own). */
+function agentClaudeArgs(def) {
+	const args = [];
+	if (def.tools?.length) args.push("--allowedTools", def.tools.join(","));
+	args.push("--append-system-prompt", def.body);
+	return args;
+}
+/** `<agent>: <first 50 chars of prompt>` — the default label for a run. */
+function agentLabel(name, prompt) {
+	return `${name}: ${prompt ?? "(no prompt)"}`.slice(0, name.length + 2 + 50);
+}
+
 //#endregion
 //#region src/cli/commands/worker/providers.ts
 function fail$1(e) {
@@ -13599,14 +13693,37 @@ function parseIntArg$1(v) {
 	if (Number.isNaN(n) || n <= 0) throw new WorkersConfigError(`expected a positive number, got "${v}"`);
 	return n;
 }
-/** `glm/fast` | `{provider, mcp}` → one printable target line. */
-function roleTargetText(target) {
-	if (typeof target === "string") return target;
-	if (typeof target === "object" && target !== null) {
-		const t = target;
-		return `${t.provider ?? "?"}${t.mcp?.length ? ` +mcp(${t.mcp.join(",")})` : ""}`;
+function parseCostTier(v) {
+	const n = parseInt(v, 10);
+	if (!Number.isInteger(n) || n < 1 || n > 5) throw new WorkersConfigError(`cost tier must be an integer 1 (cheapest) … 5 (most expensive), got "${v}"`);
+	return n;
+}
+/** `--tags a,b` (repeatable) → validated tag list. */
+function collectTags(vals) {
+	const out = [];
+	for (const v of vals ?? []) for (const t of v.split(",").map((s) => s.trim()).filter(Boolean)) {
+		if (!PROVIDER_TAGS.includes(t)) throw new WorkersConfigError(`"${t}" is not a tag (from: ${PROVIDER_TAGS.join(", ")})`);
+		if (!out.includes(t)) out.push(t);
 	}
-	return String(target);
+	return out;
+}
+/** Positional target + constraint flags → a ClassTarget for setClass. */
+function buildClassTarget(target, opts) {
+	const hasConstraints = opts.provider !== void 0 || opts.mcp !== void 0 || opts.maxCostTier !== void 0 || opts.requireTags !== void 0 || opts.order !== void 0;
+	if (target !== void 0 && !hasConstraints) return target;
+	const obj = {};
+	if (target !== void 0) obj.provider = target.split("/")[0];
+	if (opts.provider !== void 0) obj.provider = opts.provider;
+	if (opts.mcp !== void 0) obj.mcp = opts.mcp.split(",").map((s) => s.trim()).filter(Boolean);
+	if (opts.maxCostTier !== void 0) obj.maxCostTier = opts.maxCostTier;
+	if (opts.requireTags !== void 0) obj.requireTags = opts.requireTags;
+	if (opts.order !== void 0) obj.order = opts.order.split(",").map((s) => s.trim()).filter(Boolean);
+	if (target !== void 0 && target.includes("/") && obj.provider) {
+		const alias = target.split("/")[1];
+		if (alias && alias !== "default") throw new WorkersConfigError(`a provider alias ("${alias}") cannot be combined with constraint flags — use the plain "<target>" form for pinning`);
+	}
+	if (!Object.keys(obj).length) throw new WorkersConfigError("give a target (provider, provider/fast) or a constraint (--max-cost-tier, --require-tags, …)");
+	return obj;
 }
 function registerWorkerProviderCommands(providersCmd) {
 	providersCmd.description("Providers: list (default), add, remove, use, enable, disable, test").action(() => {
@@ -13617,13 +13734,14 @@ function registerWorkerProviderCommands(providersCmd) {
 		console.log(dim$1(`  workers are ${workers.enabled ? "on" : "off"} — pai worker ${workers.enabled ? "off" : "on"}`));
 		console.log();
 	});
-	providersCmd.command("add <name>").description("Add a provider; the first one also turns workers on and seeds roles.\nExample: pai worker providers add glm --base-url https://…/anthropic \\\n           --key-file ~/.config/zai/api_key --model glm-5.3 --fast-model glm-5.3-flash\nOpenAI-protocol: --protocol openai --upstream-url https://…/v1 (runs via the PAI proxy).\nCodex (ChatGPT plan): --engine codex — runs through the Codex CLI.").option("--base-url <url>", "Anthropic-compatible API base URL (required unless --protocol openai)").requiredOption("--model <model>", "Default model id for this provider").option("--key-file <path>", "File holding the API token (0600); omit for token \"local\"").option("--fast-model <model>", "Cheaper model for spotchecks and routing").option("--env <name=value>", "Extra env for runs (repeatable)", (v, acc) => [...acc, v], []).option("--note <text>", "Human note shown in `providers list`").option("--protocol <proto>", "anthropic (default) or openai — openai runs through the local PAI proxy").option("--upstream-url <url>", "Chat Completions base URL (required for --protocol openai)").option("--engine <engine>", "claude (default) or codex — codex runs `codex exec --json`").option("--context-window <tokens>", "Context window for the meter (default 200000; init event overrides)", parseIntArg$1).option("--quota-probe <url>", "URL whose JSON first number is the quota percent (0-100)").action((name, opts) => {
+	providersCmd.command("add <name>").description("Add a provider; the first one also turns workers on and seeds classes.\nExample: pai worker providers add glm --base-url https://…/anthropic \\\n           --key-file ~/.config/zai/api_key --model glm-5.3 --fast-model glm-5.3-flash\nOpenAI-protocol: --protocol openai --upstream-url https://…/v1 (runs via the PAI proxy).\nCodex (ChatGPT plan): --engine codex — runs through the Codex CLI.").option("--base-url <url>", "Anthropic-compatible API base URL (required unless --protocol openai)").requiredOption("--model <model>", "Default model id for this provider").option("--key-file <path>", "File holding the API token (0600); omit for token \"local\"").option("--fast-model <model>", "Cheaper model for spotchecks and routing").option("--env <name=value>", "Extra env for runs (repeatable)", (v, acc) => [...acc, v], []).option("--note <text>", "Human note shown in `providers list`").option("--protocol <proto>", "anthropic (default) or openai — openai runs through the local PAI proxy").option("--upstream-url <url>", "Chat Completions base URL (required for --protocol openai)").option("--engine <engine>", "claude (default) or codex — codex runs `codex exec --json`").option("--context-window <tokens>", "Context window for the meter (default 200000; init event overrides)", parseIntArg$1).option("--quota-probe <url>", "URL whose JSON first number is the quota percent (0-100)").option("--cost-tier <1-5>", "Cost tier 1 (cheapest) … 5 (most expensive; default 3)", parseCostTier).option("--tags <tags>", "Capability tags, comma-separated (from: " + PROVIDER_TAGS.join(", ") + ")", (v, acc) => [...acc, v], []).action((name, opts) => {
 		try {
 			const protocol = opts.protocol;
 			const engine = opts.engine;
 			if (protocol && protocol !== "anthropic" && protocol !== "openai") throw new WorkersConfigError(`--protocol must be anthropic or openai, got "${protocol}"`);
 			if (engine && engine !== "claude" && engine !== "codex") throw new WorkersConfigError(`--engine must be claude or codex, got "${engine}"`);
 			if (protocol !== "openai" && !opts.baseUrl) throw new WorkersConfigError("--base-url is required (only --protocol openai goes without it)");
+			const tags = collectTags(opts.tags);
 			addProvider({
 				name,
 				baseUrl: opts.baseUrl ?? "",
@@ -13636,7 +13754,9 @@ function registerWorkerProviderCommands(providersCmd) {
 				...opts.upstreamUrl ? { upstreamUrl: opts.upstreamUrl } : {},
 				...engine ? { engine } : {},
 				...opts.contextWindow ? { contextWindow: opts.contextWindow } : {},
-				quotaProbe: opts.quotaProbe
+				quotaProbe: opts.quotaProbe,
+				...opts.costTier !== void 0 ? { costTier: opts.costTier } : {},
+				...tags.length ? { tags } : {}
 			});
 			const { workers } = readWorkersSection();
 			console.log(ok$1(`provider ${name} added`));
@@ -13646,7 +13766,22 @@ function registerWorkerProviderCommands(providersCmd) {
 			fail$1(e);
 		}
 	});
-	providersCmd.command("remove <name>").description("Remove a provider and any roles pointing at it").action((name) => {
+	providersCmd.command("update <name>").description("Change cost tier and tags of a provider (routing constraints use these)").option("--cost-tier <1-5>", "Cost tier 1 (cheapest) … 5 (most expensive)", parseCostTier).option("--tags <tags>", "Capability tags, comma-separated (from: " + PROVIDER_TAGS.join(", ") + "); --tags '' clears", (v, acc) => [...acc, v], []).action((name, opts) => {
+		try {
+			if (opts.costTier === void 0 && opts.tags === void 0) throw new WorkersConfigError("nothing to update — pass --cost-tier and/or --tags");
+			const tags = opts.tags === void 0 ? void 0 : collectTags(opts.tags);
+			updateProvider(name, {
+				...opts.costTier !== void 0 ? { costTier: opts.costTier } : {},
+				...tags !== void 0 ? { tags } : {}
+			});
+			console.log(ok$1(`provider ${name} updated`));
+			const { workers } = readWorkersSection();
+			for (const line of describeProviders(workers)) console.log(dim$1(`  ${line}`));
+		} catch (e) {
+			fail$1(e);
+		}
+	});
+	providersCmd.command("remove <name>").description("Remove a provider and any classes pointing at it").action((name) => {
 		try {
 			removeProvider(name);
 			console.log(ok$1(`provider ${name} removed`));
@@ -13654,7 +13789,7 @@ function registerWorkerProviderCommands(providersCmd) {
 			fail$1(e);
 		}
 	});
-	providersCmd.command("use <name>").description("Make this provider the active one for runs without --provider/--role").action((name) => {
+	providersCmd.command("use <name>").description("Make this provider the active one for runs without --provider/--class").action((name) => {
 		try {
 			useProvider(name);
 			console.log(ok$1(`active provider: ${name}`));
@@ -13699,43 +13834,40 @@ function registerWorkerProviderCommands(providersCmd) {
 		}
 	});
 }
-/** `pai worker roles` — role → provider[/fast] assignment. */
-function registerWorkerRoleCommands(workerCmd) {
-	const rolesCmd = workerCmd.command("roles").description("Roles: which provider serves implement / research / spotcheck").action(() => {
-		const { workers } = readWorkersSection();
-		const entries = Object.entries(workers.roles);
-		if (!entries.length) {
-			console.log(dim$1("  no roles set — runs use the active provider"));
-			return;
-		}
-		for (const [role, target] of entries) console.log(`  ${role.padEnd(12)} ${roleTargetText(target)}`);
-	});
-	rolesCmd.command("list").description("List roles and their providers (default action)").action(() => {
-		const { workers } = readWorkersSection();
-		const entries = Object.entries(workers.roles);
-		if (!entries.length) {
-			console.log(dim$1("  no roles set — runs use the active provider"));
-			return;
-		}
-		for (const [role, target] of entries) console.log(`  ${role.padEnd(12)} ${roleTargetText(target)}`);
-	});
-	rolesCmd.command("set <role> <provider[/alias]>").description("Point a role at a provider, optionally its fast model (e.g. glm/fast)").action((role, target) => {
+function printClasses() {
+	const { workers } = readWorkersSection();
+	const entries = Object.entries(workers.classes);
+	if (!entries.length) {
+		console.log(dim$1("  no classes set — runs use the active provider (or auto routing)"));
+		return;
+	}
+	for (const [cls, target] of entries) console.log(`  ${cls.padEnd(12)} ${classTargetText(target)}`);
+}
+function registerClassSubcommands(classesCmd) {
+	classesCmd.command("list").description("List classes and their targets (default action)").action(() => printClasses());
+	classesCmd.command("set <class> [target]").description("Point a class at a provider (or provider/fast), or give only constraints:\nclasses set research --max-cost-tier 2 --require-tags long-context,reasoning").option("--provider <name>", "Pin the class to this provider (object form)").option("--mcp <names>", "MCP servers/sets for runs of this class (comma-separated)").option("--max-cost-tier <1-5>", "Auto-routing considers only providers up to this cost tier", parseCostTier).option("--require-tags <tags>", "Auto-routing needs these tags (comma-separated)", (v) => v.split(",").map((s) => s.trim()).filter(Boolean)).option("--order <providers>", "Per-class routing order overriding workers.routing.order (comma-separated)").action((cls, target, opts) => {
 		try {
-			setRole(role, target);
-			console.log(ok$1(`role ${role} → ${target}`));
+			const built = buildClassTarget(target, opts);
+			setClass(cls, built);
+			console.log(ok$1(`class ${cls} → ${classTargetText(built)}`));
 		} catch (e) {
 			fail$1(e);
 		}
 	});
-	rolesCmd.command("unset <role>").description("Remove a role (runs then use the active provider)").action((role) => {
+	classesCmd.command("unset <class>").description("Remove a class (runs then use the active provider)").action((cls) => {
 		try {
-			unsetRole(role);
-			console.log(ok$1(`role ${role} removed`));
+			unsetClass(cls);
+			console.log(ok$1(`class ${cls} removed`));
 		} catch (e) {
 			fail$1(e);
 		}
 	});
 }
+/** `pai worker classes` — class → target assignment (roles is the old name). */
+function registerWorkerClassCommands(workerCmd) {
+	registerClassSubcommands(workerCmd.command("classes").description("Classes: which provider serves draft / implement / review / …").action(() => printClasses()));
+	registerClassSubcommands(workerCmd.command("roles", { hidden: true }).description("Alias of `classes` (roles was renamed to classes)").action(() => printClasses()));
+}
 
 //#endregion
 //#region src/cli/commands/worker/index.ts
@@ -13749,16 +13881,44 @@ function fail(e) {
 	process.exitCode = 1;
 }
 function registerWorkerCommands(workerCmd) {
-	workerCmd.command("run").description("Run one claude-code worker through the configured provider.\nUnknown options are passed to claude verbatim (e.g. -p, --allowedTools);\n--output-format/--verbose are handled here.").allowUnknownOption(true).option("--provider <name>", "Provider to run on (default: active, else routing order)").option("--role <role>", "Use the provider of this role (implement, research, spotcheck, …)").option("--model <model>", "Override the provider's model for this run").option("--label <text>", "Short task label shown in ps / follow / status line").option("--mcp <names>", "MCP servers/sets this worker may use (comma-separated; see `pai worker mcp`)").option("--no-pane", "Do not open a follow pane for this worker").argument("[args...]", "claude arguments, e.g. -p '<task>' --allowedTools 'Read,Edit,Bash'").action(async (args, opts) => {
+	workerCmd.command("run").description("Run one claude-code worker through the configured provider.\nUnknown options are passed to claude verbatim (e.g. -p, --allowedTools);\n--output-format/--verbose are handled here.\n--chain draft,implement[,review] runs a spec-first pipeline;\n--agent <name> runs an agent definition from ~/.claude/agents.").allowUnknownOption(true).option("--provider <name>", "Provider to run on (default: active, else routing order)").option("--class <name>", "Use the provider of this class (draft, implement, review, research, spotcheck, simple, complex, image)").option("--role <name>", "Alias of --class (roles were renamed to classes)").option("--chain <stages>", "Comma-separated stage classes, e.g. draft,implement or draft,implement,review").option("--agent <name>", "Run the agent definition ~/.claude/agents/<name>.md on a worker").option("--model <model>", "Override the provider's model for this run").option("--label <text>", "Short task label shown in ps / follow / status line").option("--mcp <names>", "MCP servers/sets this worker may use (comma-separated; see `pai worker mcp`)").option("--no-pane", "Do not open a follow pane for this worker").option("--worktree", "Run in a git worktree on branch worker/<id> (default for implement/complex/plan in a git repo)").option("--no-worktree", "Run in place, no worktree").argument("[args...]", "claude arguments, e.g. -p '<task>' --allowedTools 'Read,Edit,Bash'").action(async (args, opts) => {
 		try {
+			const className = opts.class ?? opts.role;
+			let claudeArgs = args;
+			let label = opts.label;
+			let agentClass;
+			if (opts.agent) {
+				const def = loadAgent(opts.agent);
+				claudeArgs = [...agentClaudeArgs(def), ...args];
+				agentClass = modelToClass(def.model);
+				if (!label) label = agentLabel(opts.agent, parseRunnerArgs(args).prompt);
+			}
+			if (opts.chain) {
+				const brief = parseRunnerArgs(claudeArgs).prompt;
+				if (!brief) throw new Error("--chain needs the task as -p '<brief>'");
+				const rc = await runChain({
+					stages: opts.chain.split(","),
+					className: className ?? agentClass,
+					providerFlag: opts.provider,
+					modelFlag: opts.model,
+					label,
+					noPane: opts.pane === false,
+					mcpFlag: opts.mcp,
+					brief,
+					claudeArgs
+				});
+				process.exitCode = rc;
+				return;
+			}
 			const rc = await runWorker({
 				providerFlag: opts.provider,
-				role: opts.role,
+				className: className ?? agentClass,
 				modelFlag: opts.model,
-				label: opts.label,
+				label,
 				mcpFlag: opts.mcp,
 				noPane: opts.pane === false,
-				claudeArgs: args
+				worktreeFlag: opts.worktree,
+				claudeArgs
 			});
 			process.exitCode = rc;
 		} catch (e) {
@@ -13799,13 +13959,13 @@ function registerWorkerCommands(workerCmd) {
 			process.exitCode = code ?? 1;
 		});
 	});
-	workerCmd.command("pane [id]").description("Open the follow pane for a worker (or one shared pane for this session)").option("--check", "Only report whether the pane is open, plus the profile file's path and font").action(async (id, opts) => {
+	workerCmd.command("pane [id]").description("Open the follow pane for a worker (or one shared pane for this session)").option("--check", "Only report whether the pane is open, plus the profile file's path, font, and the hosting window's bounds").action(async (id, opts) => {
 		try {
 			const { workers } = readWorkersSection();
 			const logDir = currentLogDir();
 			const term = process.env.ITERM_SESSION_ID ?? "";
 			if (id) {
-				const msg = opts.check ? await checkPaneForWorker(id, workers.pane.fontSize) : await openPaneForWorker(logDir, workers, id, term);
+				const msg = opts.check ? await checkPaneForWorker(id, workers.pane.fontSize, term) : await openPaneForWorker(logDir, workers, id, term);
 				console.log(msg);
 			} else console.log(await openFollowPane(logDir, workers, term, opts.check === true));
 		} catch (e) {
@@ -13860,6 +14020,55 @@ function registerWorkerCommands(workerCmd) {
 			fail(e);
 		}
 	});
+	workerCmd.command("handoff <json>").description("From inside a worker: append a handoff to the parent's inbox and (when it runs) say it to the parent.\nPayload: {\"kind\":\"proposal|question|blocker\",\"text\":\"…\",\"data\":{…}} — from/to come from the environment.").action(async (json) => {
+		try {
+			let payload;
+			try {
+				payload = JSON.parse(json);
+			} catch {
+				fail(/* @__PURE__ */ new Error(`payload is not JSON: ${json}`));
+				return;
+			}
+			const h = await handoffFromInside(currentLogDir(), process.env, payload);
+			console.log(`ok → ${h.to} (${h.kind}); inbox ${h.to}.inbox.jsonl`);
+		} catch (e) {
+			fail(e);
+		}
+	});
+	workerCmd.command("merge <id>").description("Merge a worker's worktree branch (worker/<id>) into the original checkout, then remove the worktree").action((id) => {
+		try {
+			console.log(mergeWorker(currentLogDir(), id));
+		} catch (e) {
+			fail(e);
+		}
+	});
+	workerCmd.command("discard <id>").description("Drop a worker's worktree and branch, keeping nothing").action((id) => {
+		try {
+			console.log(discardWorker(currentLogDir(), id));
+		} catch (e) {
+			fail(e);
+		}
+	});
+	workerCmd.command("controls <id> <who>").description("Hand the desktop controls (clickr) to a worker or take them back.\n<who> is `you` (the worker may actuate) or `me` (the operator keeps them);\ninside a worker's pane, typing \"your controls\" does the same.").action((id, who) => {
+		try {
+			if (who !== "you" && who !== "me") {
+				fail(/* @__PURE__ */ new Error(`<who> must be "you" or "me"`));
+				return;
+			}
+			if (!loadStatus(currentLogDir(), id)) {
+				fail(/* @__PURE__ */ new Error(`no worker named "${id}"`));
+				return;
+			}
+			const proc = spawn("clickr", ["controls", who], { stdio: "inherit" });
+			proc.on("error", (e) => fail(/* @__PURE__ */ new Error(`cannot run clickr controls: ${e.message} (is clickr installed?)`)));
+			proc.on("close", (code) => {
+				if (code === 0) console.log(`controls → ${who === "you" ? id : "operator"}`);
+				process.exitCode = code ?? 1;
+			});
+		} catch (e) {
+			fail(e);
+		}
+	});
 	workerCmd.command("resume <id> <text>").description("Continue a finished worker on the same provider: claude --resume <session>").option("--print-id", "Print the new worker id on its own line (pane follow handoff)").option("--no-pane", "Do not open a follow pane for the resumed worker").action(async (id, text, opts) => {
 		try {
 			const old = loadStatus(currentLogDir(), id);
@@ -13955,7 +14164,7 @@ function registerWorkerCommands(workerCmd) {
 		}
 	});
 	registerWorkerProviderCommands(workerCmd.command("providers").description("Providers: list, add, remove, use, enable, disable, test"));
-	registerWorkerRoleCommands(workerCmd);
+	registerWorkerClassCommands(workerCmd);
 }
 function parseIntArg(v) {
 	const n = parseInt(v, 10);
@@ -14326,7 +14535,7 @@ async function countVectorDbPaths(oldPaths) {
 	if (oldPaths.length === 0) return 0;
 	try {
 		const { loadConfig } = await import("./config-C_ErGddD.mjs");
-		const { PostgresBackend } = await import("./postgres--BjPtLa0.mjs");
+		const { PostgresBackend } = await import("./postgres-mW1n7Vi1.mjs");
 		const config = loadConfig();
 		if (config.storageBackend !== "postgres") return 0;
 		const pgBackend = new PostgresBackend(config.postgres ?? {});
@@ -14347,7 +14556,7 @@ async function updateVectorDbPaths(moves) {
 	if (moves.length === 0) return 0;
 	try {
 		const { loadConfig } = await import("./config-C_ErGddD.mjs");
-		const { PostgresBackend } = await import("./postgres--BjPtLa0.mjs");
+		const { PostgresBackend } = await import("./postgres-mW1n7Vi1.mjs");
 		const config = loadConfig();
 		if (config.storageBackend !== "postgres") return 0;
 		const pgBackend = new PostgresBackend(config.postgres ?? {});
@@ -15872,4 +16081,4 @@ claude() {
 
 //#endregion
 export { drainStdio as n, buildProgram as t };
-//# sourceMappingURL=program-CEIHn_Ma.mjs.map
+//# sourceMappingURL=program-DXBwJV7h.mjs.map