@voltro/cli 0.54.0 → 0.56.0

package/dist/buildReport-52gHKgfO.js

@@ -0,0 +1,64 @@
+import { join as e } from "node:path";
+import { existsSync as t, readFileSync as n, readdirSync as r, statSync as i } from "node:fs";
+import { gzipSync as a } from "node:zlib";
+//#region src/buildReport.ts
+var o = 9, s = (e) => a(e, { level: o }).length, c = (n) => {
+	let a = 0, o = 0, s = (t) => {
+		for (let n of r(t, { withFileTypes: !0 })) {
+			let r = e(t, n.name);
+			n.isDirectory() ? s(r) : (a += i(r).size, o += 1);
+		}
+	};
+	return t(n) && s(n), {
+		bytes: a,
+		files: o
+	};
+}, l = (a) => {
+	let o = e(a, ".framework", "dist"), l = e(o, "index.html");
+	if (!t(l)) return null;
+	let u = n(l, "utf8"), d = (r) => {
+		let i = e(o, r.replace(/^\//, ""));
+		if (!t(i)) return null;
+		let a = n(i);
+		return {
+			file: r,
+			gzip: s(a),
+			raw: a.length
+		};
+	}, f = [...u.matchAll(/(?:src|href)="(\/assets\/[^"]+\.js)"/g)].map((e) => e[1]), p = [...u.matchAll(/href="(\/assets\/[^"]+\.css)"/g)].map((e) => e[1]), m = f.map(d).filter((e) => e !== null), h = p.map(d).filter((e) => e !== null), g = e(o, "assets"), _ = 0, v = 0;
+	if (t(g)) for (let t of r(g)) t.endsWith(".js") && (_ += s(n(e(g, t))), v += 1);
+	let y = e(o, "server", "ssrEntry.js"), b = c(e(a, ".framework", "dist-web", "startBundle")), x = c(e(a, ".framework", "dist-api", "serveBundle"));
+	return {
+		firstLoad: m,
+		firstLoadGzip: m.reduce((e, t) => e + t.gzip, 0),
+		css: h,
+		cssGzip: h.reduce((e, t) => e + t.gzip, 0),
+		totalGzip: _,
+		chunkCount: v,
+		ssrEntryBytes: t(y) ? i(y).size : 0,
+		startBundleBytes: b.bytes,
+		startBundleFiles: b.files,
+		serveBundleBytes: x.bytes,
+		serveBundleFiles: x.files
+	};
+}, u = (e) => `${(e / 1024).toFixed(1)} KB`, d = (e) => `${(e / 1e6).toFixed(2)} MB`, f = (e) => {
+	if (e === null) return [];
+	let t = [
+		"",
+		"build report — what a visitor downloads",
+		""
+	];
+	t.push(`  first load   ${u(e.firstLoadGzip).padStart(10)} gz   ${e.firstLoad.length} file(s), entry + modulepreload`), e.css.length > 0 && t.push(`  css          ${u(e.cssGzip).padStart(10)} gz   ${e.css.length} stylesheet(s)`), t.push(`  all chunks   ${u(e.totalGzip).padStart(10)} gz   ${e.chunkCount} chunk(s), eager + lazy`);
+	let n = [...e.firstLoad].sort((e, t) => t.gzip - e.gzip).slice(0, 5);
+	if (n.length > 0) {
+		t.push("");
+		for (let r of n) {
+			let n = e.firstLoadGzip === 0 ? 0 : Math.round(r.gzip / e.firstLoadGzip * 100);
+			t.push(`    ${u(r.gzip).padStart(10)} gz  ${String(n).padStart(3)}%  ${r.file}`);
+		}
+	}
+	let r = n[0];
+	return r !== void 0 && e.firstLoadGzip > 0 && r.gzip > e.firstLoadGzip / 2 && (t.push(""), t.push(`  ⚠ one chunk is ${Math.round(r.gzip / e.firstLoadGzip * 100)}% of the first load: ${r.file}`), t.push("    Every visitor downloads it before the page is interactive. If that is"), t.push("    data rather than code (a content glob, a locale catalog, a dataset),"), t.push("    it usually belongs behind a dynamic import or a build-time index.")), (e.ssrEntryBytes > 0 || e.startBundleFiles > 0 || e.serveBundleFiles > 0) && (t.push(""), t.push("  server artefacts (what the image ships and a cold boot loads)"), e.ssrEntryBytes > 0 && t.push(`    ssr bundle       ${d(e.ssrEntryBytes).padStart(10)}`), e.startBundleFiles > 0 && t.push(`    start bundle     ${d(e.startBundleBytes).padStart(10)}   ${e.startBundleFiles} file(s)`), e.serveBundleFiles > 0 && t.push(`    serve bundle     ${d(e.serveBundleBytes).padStart(10)}   ${e.serveBundleFiles} file(s)`)), t.push(""), t;
+};
+//#endregion
+export { l as collectBuildReport, f as formatBuildReport };

package/dist/{checkCommand-Dg1G7Gwd.js → checkCommand-CAwFXrxA.js}

@@ -1,10 +1,10 @@
 import { t as e } from "./cliArgs-D4p8n7EE.js";
-import { a as t, l as n } from "./codegen-DSLM8Su9.js";
+import { a as t, l as n } from "./codegen-Bth5lUTU.js";
 import { r } from "./appGraph-yRuKjOba.js";
 import { n as i } from "./cliOutput-D1tSBoRM.js";
-import { n as a, o, r as s, t as c } from "./inspectFetch-EMuhTG_9.js";
+import { n as a, o, r as s, t as c } from "./inspectFetch-BU1NyzxV.js";
 import { r as l } from "./fileTaxonomy-CbyMQYx_.js";
-import { S as u } from "./doctorCommand-DCiFVMtZ.js";
+import { S as u } from "./doctorCommand-aR_bFmIi.js";
 import { resolve as d } from "node:path";
 import { readdirSync as f, statSync as p } from "node:fs";
 import { isReactivityChannelKey as m } from "@voltro/protocol";
@@ -170,9 +170,9 @@ var h = (e) => (e === void 0 ? [] : typeof e == "string" ? [e] : e).filter((e) =
 	let t = e.severity === "error" ? "✗ error" : "⚠ warn", n = e.file ? ` (${e.file})` : "";
 	return `${t}  ${e.rule}  ${e.node}${n}\n    ${e.breaks.join("; ")}\n    fix: ${e.fix}`;
 }).join("\n"), O = async (e) => {
-	let { walk: t, loadDiscovered: n, loadApiConfig: r } = await import("./dev-cKUiZZsB.js"), { buildRpcEntry: i } = await import("./manifestBuild-C4-J1-m_.js"), { buildCapabilityManifest: a } = await import("./inspect-CuoDInfZ.js"), { relative: o } = await import("node:path"), s = await n(await t(e)), c = await r(e).then((e) => e?.plugins ?? []).catch(() => []);
+	let { walk: t, loadDiscovered: n, loadApiConfig: r } = await import("./dev-B9Gz0k85.js"), { buildRpcEntry: i } = await import("./manifestBuild-DIa_s6u0.js"), { buildCapabilityManifest: a } = await import("./inspect-S2rWy1Ys.js"), { relative: o } = await import("node:path"), s = await n(await t(e)), c = await r(e).then((e) => e?.plugins ?? []).catch(() => []);
 	try {
-		let { mergePluginRoutesInto: e } = await import("./dev-cKUiZZsB.js");
+		let { mergePluginRoutesInto: e } = await import("./dev-B9Gz0k85.js");
 		e({
 			plugins: c,
 			queries: s.queries,
@@ -189,7 +189,7 @@ var h = (e) => (e === void 0 ? [] : typeof e == "string" ? [e] : e).filter((e) =
 		...s.mutations.map((e) => l(e.descriptor, "mutation", e.file)),
 		...s.actions.map((e) => l(e.descriptor, "action", e.file)),
 		...s.streams.map((e) => l(e.descriptor, "stream", e.file))
-	], { assembleFrameworkTables: d } = await import("./frameworkTableAssembly-IPD1pUnZ.js"), f = await d({ root: e }).catch((e) => (console.warn(`\n⚠  plugin tables could not be collected — this report is INCOMPLETE.\n   ${e instanceof Error ? e.message.split("\n")[0] : String(e)}\n`), [])), p = new Set(s.tables.map((e) => e.tableName)), m = [...[...p].map((e) => ({ name: e })), ...f.map((e) => e.tableName).filter((e) => !p.has(e)).map((e) => ({
+	], { assembleFrameworkTables: d } = await import("./frameworkTableAssembly-CGNC0qr7.js"), f = await d({ root: e }).catch((e) => (console.warn(`\n⚠  plugin tables could not be collected — this report is INCOMPLETE.\n   ${e instanceof Error ? e.message.split("\n")[0] : String(e)}\n`), [])), p = new Set(s.tables.map((e) => e.tableName)), m = [...[...p].map((e) => ({ name: e })), ...f.map((e) => e.tableName).filter((e) => !p.has(e)).map((e) => ({
 		name: e,
 		framework: !0
 	}))], h = c;

package/dist/{checkCommand-L7DTlpIF.js → checkCommand-D0QV_zM_.js}

@@ -1,2 +1,2 @@
-import { a as e, i as t, o as n } from "./checkCommand-Dg1G7Gwd.js";
+import { a as e, i as t, o as n } from "./checkCommand-CAwFXrxA.js";
 export { t as offlineManifest, e as runCheckCommand, n as toInput };

package/dist/{clusterCmd-DrVFCzSj.js → clusterCmd-CdLB1GkT.js}

@@ -1,5 +1,5 @@
 import { n as e } from "./cliOutput-D1tSBoRM.js";
-import { n as t, o as n, r, t as i } from "./inspectFetch-EMuhTG_9.js";
+import { n as t, o as n, r, t as i } from "./inspectFetch-BU1NyzxV.js";
 import { ansi as a } from "@voltro/logger";
 //#region src/clusterCmd.ts
 var o = () => {

package/dist/{codegen-DSLM8Su9.js → codegen-Bth5lUTU.js}

@@ -10,7 +10,8 @@ import { isAgentDescriptor as m } from "@voltro/ai/agent";
 var h = /* @__PURE__ */ new Set(/* @__PURE__ */ "crypto.fs.path.os.net.http.https.http2.tls.dns.dgram.stream.zlib.child_process.worker_threads.cluster.readline.vm.module.perf_hooks.async_hooks.inspector.v8.process.tty.repl.constants.sys.string_decoder".split(".")), g = (e) => e.startsWith("node:") || h.has(e) || e === "@voltro/workflow" ? !0 : e === "@voltro/database/wire" ? !1 : e === "@voltro/database" || e.startsWith("@voltro/database/") || e === "@voltro/runtime" || e.startsWith("@voltro/runtime/") ? !0 : e === "@voltro/ai/agent" || e === "@voltro/ai/events" ? !1 : !!(e === "@voltro/ai" || e.startsWith("@voltro/ai/") || [
 	"@voltro/protocol/session",
 	"@voltro/protocol/jwt",
-	"@voltro/protocol/apikey"
+	"@voltro/protocol/apikey",
+	"@voltro/protocol/identity"
 ].includes(e) || e === "@voltro/env/server" || e.startsWith("@effect/cluster") || e.startsWith("@effect/sql") || e === "@effect/platform-node" || [
 	"pg",
 	"postgres",
@@ -304,8 +305,8 @@ ${o.join("\n\n")}\n`);
 		file: t,
 		reason: "a descriptor changed since the group was generated"
 	};
-}, Q = (e, t, n, i = [], o = [], s = !1, l = !1, u = [], d = "") => {
-	let f = o.length > 0, m = o.flatMap((e) => [{
+}, Q = (e, t, n, i = [], o = [], s = !1, l = !1, u = [], d = {}, f = "") => {
+	let m = o.length > 0, h = o.flatMap((e) => [{
 		file: e.file,
 		exportName: e.exportName,
 		rpcTag: `${e.name}.send`,
@@ -315,7 +316,7 @@ ${o.join("\n\n")}\n`);
 		exportName: e.exportName,
 		rpcTag: `${e.name}.messages`,
 		kind: "query"
-	}]), h = [...new Map(u.map((e) => [e.tag, e])).values()].sort((e, t) => e.tag < t.tag ? -1 : 1), g = h.map((e) => ({
+	}]), g = [...new Map(u.map((e) => [e.tag, e])).values()].sort((e, t) => e.tag < t.tag ? -1 : 1), _ = g.map((e) => ({
 		file: `plugin:${e.module}`,
 		exportName: e.name,
 		rpcTag: e.tag,
@@ -323,26 +324,26 @@ ${o.join("\n\n")}\n`);
 	}));
 	ee([
 		...n,
-		...m,
-		...g
+		...h,
+		..._
 	], e), q([
 		...n,
-		...m,
-		...g
+		...h,
+		..._
 	], e);
-	let _ = (e) => e.replace(/[^a-zA-Z0-9_$]/g, "_"), v = (e) => `__src_agent_${_(e.name)}`, y = (e) => `__agentRoutes_${_(e.name)}`, b = i.length > 0, x = i.map((e, t) => `import { ${e.name} as __pe${t} } from '${e.module}'`), S = b ? ", __voltroPluginErrors" : "", C = h.length > 0, w = h.map((e, t) => `import { ${e.name} as __prpc${t} } from '${e.module}'`), T = (e) => e === "query" ? "queryToRpc" : e === "mutation" ? "mutationToRpc" : "actionToRpc", E = h.map((e, t) => `export const ${G(e.tag)} = ${T(e.kind)}(__prpc${t}${S})`), D = h.map((e) => `  ${G(e.tag)},`), O = [...n].sort((e, t) => e.kind === t.kind ? e.rpcTag < t.rpcTag ? -1 : 1 : J(e.kind) - J(t.kind)), k = r(t), A = (e) => `__src_${G(e.rpcTag)}`, j = (e) => {
-		let t = `./${a(k, e.file).replace(/\\/g, "/").replace(/\.tsx?$/, "")}`;
-		return `import { ${e.exportName} as ${A(e)} } from '${t}'`;
-	}, M = (e) => {
-		let t = G(e.rpcTag), n = A(e);
-		return e.kind === "query" ? `export const ${t} = queryToRpc(${n}${S})` : e.kind === "mutation" ? `export const ${t} = mutationToRpc(${n}${S})` : e.kind === "action" ? `export const ${t} = actionToRpc(${n}${S})` : e.kind === "stream" ? `export const ${t} = streamToRpc(${n}${S})` : e.kind === "event" ? `export const ${t} = eventToRpc(${n}${S})` : [
+	let v = (e) => e.replace(/[^a-zA-Z0-9_$]/g, "_"), y = (e) => `__src_agent_${v(e.name)}`, b = (e) => `__agentRoutes_${v(e.name)}`, x = i.length > 0, S = i.map((e, t) => `import { ${e.name} as __pe${t} } from '${e.module}'`), C = x ? ", __voltroPluginErrors" : "", w = g.length > 0, T = g.map((e, t) => `import { ${e.name} as __prpc${t} } from '${e.module}'`), E = (e) => e === "query" ? "queryToRpc" : e === "mutation" ? "mutationToRpc" : "actionToRpc", D = g.map((e, t) => `export const ${G(e.tag)} = ${E(e.kind)}(withRpcTag(__prpc${t}, ${JSON.stringify(e.tag)})${C})`), O = g.map((e) => `  ${G(e.tag)},`), k = [...n].sort((e, t) => e.kind === t.kind ? e.rpcTag < t.rpcTag ? -1 : 1 : J(e.kind) - J(t.kind)), A = r(t), j = (e) => `__src_${G(e.rpcTag)}`, M = (e) => {
+		let t = `./${a(A, e.file).replace(/\\/g, "/").replace(/\.tsx?$/, "")}`;
+		return `import { ${e.exportName} as ${j(e)} } from '${t}'`;
+	}, N = (e) => {
+		let t = G(e.rpcTag), n = j(e);
+		return e.kind === "query" ? `export const ${t} = queryToRpc(${n}${C})` : e.kind === "mutation" ? `export const ${t} = mutationToRpc(${n}${C})` : e.kind === "action" ? `export const ${t} = actionToRpc(${n}${C})` : e.kind === "stream" ? `export const ${t} = streamToRpc(${n}${C})` : e.kind === "event" ? `export const ${t} = eventToRpc(${n}${C})` : [
 			`export const ${t} = Rpc.make('${e.rpcTag}', {`,
 			`  payload: strictInput(${n}.payloadSchema),`,
 			"  success: WorkflowRunHandleSchema,",
 			`  error:   ${n}.errorSchema,`,
 			"})"
 		].join("\n");
-	}, N = [...O.filter((e) => e.kind === "query" || e.kind === "mutation" || e.kind === "action" || e.kind === "stream").map((e) => `  | __AppErrorOf<typeof ${A(e)}>`), ...b ? ["  | Schema.Schema.Type<(typeof __voltroPluginErrors)[number]>"] : []], P = N.length > 0, F = O.some((e) => e.kind === "workflow"), I = F ? [
+	}, P = [...k.filter((e) => e.kind === "query" || e.kind === "mutation" || e.kind === "action" || e.kind === "stream").map((e) => `  | __AppErrorOf<typeof ${j(e)}>`), ...x ? ["  | Schema.Schema.Type<(typeof __voltroPluginErrors)[number]>"] : []], F = P.length > 0, I = k.some((e) => e.kind === "workflow"), L = I ? [
 		"__voltroWorkflowRun",
 		"__voltroWorkflowRuns",
 		"__voltroWorkflowRunSteps",
@@ -353,27 +354,29 @@ ${o.join("\n\n")}\n`);
 		"__voltroWorkflowResume",
 		"__voltroWorkflowSignal",
 		"__voltroWorkflowUpdate"
-	] : [], L = s ? [
+	] : [], R = s ? [
 		"__voltroUndoLog",
 		"__voltroUndoApply",
 		"__voltroUndoRedo"
-	] : [], R = O.some((e) => e.requiresApproval === !0), z = R ? ["__voltroApprovalsPending", "__voltroApprovalsDecide"] : [], B = l ? [
+	] : [], z = k.some((e) => e.requiresApproval === !0), B = z ? ["__voltroApprovalsPending", "__voltroApprovalsDecide"] : [], V = l ? [
 		"__voltroConnectionsList",
 		"__voltroConnectionStart",
 		"__voltroConnectionSubmitToken",
 		"__voltroConnectionDisconnect"
-	] : [], V = [
-		...O.map((e) => `  ${G(e.rpcTag)},`),
+	] : [], H = [
+		...k.map((e) => `  ${G(e.rpcTag)},`),
 		...o.flatMap((e) => [`  ${G(`${e.name}.send`)},`, `  ${G(`${e.name}.messages`)},`]),
-		...I.map((e) => `  ${e},`),
 		...L.map((e) => `  ${e},`),
-		...z.map((e) => `  ${e},`),
+		...R.map((e) => `  ${e},`),
 		...B.map((e) => `  ${e},`),
-		...D
-	].join("\n"), H = ["queryToRpc"];
-	(O.some((e) => e.kind === "mutation") || h.some((e) => e.kind === "mutation")) && H.push("mutationToRpc"), (O.some((e) => e.kind === "action") || F || f || h.some((e) => e.kind === "action")) && H.push("actionToRpc"), O.some((e) => e.kind === "stream") && H.push("streamToRpc"), O.some((e) => e.kind === "event") && H.push("eventToRpc"), F && H.push("strictInput", "WorkflowRunHandleSchema", "workflowCancelDescriptor", "workflowDomainEventsQueryDescriptor", "workflowEventDeliveriesQueryDescriptor", "workflowResumeDescriptor", "workflowRunEventsQueryDescriptor", "workflowRunQueryDescriptor", "workflowRunsQueryDescriptor", "workflowRunStepsQueryDescriptor", "workflowSignalDescriptor", "workflowUpdateDescriptor"), s && H.push("mutationToRpc", "undoLogQueryDescriptor", "undoApplyDescriptor", "undoRedoDescriptor"), R && H.push("mutationToRpc", "approvalsPendingQueryDescriptor", "approvalsDecideDescriptor"), l && H.push("mutationToRpc", "actionToRpc", "connectionsListQueryDescriptor", "connectionStartDescriptor", "connectionSubmitTokenDescriptor", "connectionDisconnectDescriptor"), (O.some((e) => e.kind === "query" || e.kind === "mutation" || e.kind === "action" || e.kind === "stream") || f || F || s || R || l || C) && H.push("normalizeDescriptor");
-	let U = [...new Set(H)].sort(), W = [...O.filter((e) => e.kind === "query" || e.kind === "mutation" || e.kind === "action" || e.kind === "stream").map((e) => [e.rpcTag, A(e)]), ...o.flatMap((e) => [[`${e.name}.send`, `${y(e)}.send`], [`${e.name}.messages`, `${y(e)}.messages`]])], K = [
-		...F ? [
+		...V.map((e) => `  ${e},`),
+		...O
+	].join("\n"), U = ["queryToRpc"];
+	w && U.push("withRpcTag");
+	let W = Object.entries(d).sort(([e], [t]) => e < t ? -1 : 1), K = W.length > 0;
+	K && U.push("registerPluginAliases"), (k.some((e) => e.kind === "mutation") || g.some((e) => e.kind === "mutation")) && U.push("mutationToRpc"), (k.some((e) => e.kind === "action") || I || m || g.some((e) => e.kind === "action")) && U.push("actionToRpc"), k.some((e) => e.kind === "stream") && U.push("streamToRpc"), k.some((e) => e.kind === "event") && U.push("eventToRpc"), I && U.push("strictInput", "WorkflowRunHandleSchema", "workflowCancelDescriptor", "workflowDomainEventsQueryDescriptor", "workflowEventDeliveriesQueryDescriptor", "workflowResumeDescriptor", "workflowRunEventsQueryDescriptor", "workflowRunQueryDescriptor", "workflowRunsQueryDescriptor", "workflowRunStepsQueryDescriptor", "workflowSignalDescriptor", "workflowUpdateDescriptor"), s && U.push("mutationToRpc", "undoLogQueryDescriptor", "undoApplyDescriptor", "undoRedoDescriptor"), z && U.push("mutationToRpc", "approvalsPendingQueryDescriptor", "approvalsDecideDescriptor"), l && U.push("mutationToRpc", "actionToRpc", "connectionsListQueryDescriptor", "connectionStartDescriptor", "connectionSubmitTokenDescriptor", "connectionDisconnectDescriptor"), (k.some((e) => e.kind === "query" || e.kind === "mutation" || e.kind === "action" || e.kind === "stream") || m || I || s || z || l || w) && U.push("normalizeDescriptor");
+	let Y = [...new Set(U)].sort(), X = [...k.filter((e) => e.kind === "query" || e.kind === "mutation" || e.kind === "action" || e.kind === "stream").map((e) => [e.rpcTag, j(e)]), ...o.flatMap((e) => [[`${e.name}.send`, `${b(e)}.send`], [`${e.name}.messages`, `${b(e)}.messages`]])], Z = [
+		...I ? [
 			["__voltro.workflow.run", "workflowRunQueryDescriptor"],
 			["__voltro.workflow.runs", "workflowRunsQueryDescriptor"],
 			["__voltro.workflow.run.steps", "workflowRunStepsQueryDescriptor"],
@@ -390,20 +393,20 @@ ${o.join("\n\n")}\n`);
 			["__voltro.undo.apply", "undoApplyDescriptor"],
 			["__voltro.undo.redo", "undoRedoDescriptor"]
 		] : [],
-		...R ? [["__voltro.approvals.pending", "approvalsPendingQueryDescriptor"], ["__voltro.approvals.decide", "approvalsDecideDescriptor"]] : [],
+		...z ? [["__voltro.approvals.pending", "approvalsPendingQueryDescriptor"], ["__voltro.approvals.decide", "approvalsDecideDescriptor"]] : [],
 		...l ? [
 			["__voltro.connections.list", "connectionsListQueryDescriptor"],
 			["__voltro.connections.start", "connectionStartDescriptor"],
 			["__voltro.connections.submitToken", "connectionSubmitTokenDescriptor"],
 			["__voltro.connections.disconnect", "connectionDisconnectDescriptor"]
 		] : [],
-		...h.map((e, t) => [e.tag, `__prpc${t}`])
-	], Y = ([e, t]) => `  ${JSON.stringify(e)}: normalizeDescriptor(${t}),`, X = ([e, t]) => `  readonly ${JSON.stringify(e)}: typeof ${t}`, Z = W.map(Y), Q = K.map(Y), $ = O.filter((e) => e.kind === "workflow").map((e) => `  ${JSON.stringify(e.rpcTag)}: { kind: 'workflow' },`), ne = O.filter((e) => e.kind === "workflow").map((e) => `  readonly ${JSON.stringify(e.rpcTag)}: { readonly kind: 'workflow' }`), re = [
-		...W.map(X),
-		...ne,
-		...K.map(X)
-	], ie = O.filter((e) => e.kind === "workflow").map((e) => {
-		let t = A(e);
+		...g.map((e, t) => [e.tag, `__prpc${t}`])
+	], Q = ([e, t]) => `  ${JSON.stringify(e)}: normalizeDescriptor(${t}),`, $ = ([e, t]) => `  readonly ${JSON.stringify(e)}: typeof ${t}`, ne = X.map(Q), re = Z.map(Q), ie = k.filter((e) => e.kind === "workflow").map((e) => `  ${JSON.stringify(e.rpcTag)}: { kind: 'workflow' },`), ae = k.filter((e) => e.kind === "workflow").map((e) => `  readonly ${JSON.stringify(e.rpcTag)}: { readonly kind: 'workflow' }`), oe = [
+		...X.map($),
+		...ae,
+		...Z.map($)
+	], se = k.filter((e) => e.kind === "workflow").map((e) => {
+		let t = j(e);
 		return [
 			`  ${JSON.stringify(e.rpcTag)}: {`,
 			"    kind: 'workflow',",
@@ -414,44 +417,53 @@ ${o.join("\n\n")}\n`);
 			`    updates: __voltroWorkflowMessages(${t}).updates,`,
 			"  },"
 		].join("\n");
-	}), ae = [...O, ...o.map((e) => ({
+	}), ce = [...k, ...o.map((e) => ({
 		rpcTag: `agent:${e.name}`,
 		file: e.file
 	}))];
 	return [
 		"// THIS FILE IS GENERATED — DO NOT EDIT BY HAND.",
 		"// Re-emitted by `voltro dev` whenever query/mutation/action/stream/workflow files change.",
-		`// descriptor-fingerprint: ${p("sha1").update(ae.map((e) => {
+		`// descriptor-fingerprint: ${p("sha1").update(ce.map((e) => {
 			let t = "";
 			try {
 				t = c(e.file, "utf8");
 			} catch {}
 			return `${e.rpcTag}\u0000${t}`;
 		}).join("
")).digest("hex").slice(0, 16)}`,
-		`${te}${d}`,
+		`${te}${f}`,
 		"// Source files:",
-		...O.map((t) => `//   - ${a(e, t.file).replace(/\\/g, "/")}`),
+		...k.map((t) => `//   - ${a(e, t.file).replace(/\\/g, "/")}`),
 		...o.map((t) => `//   - ${a(e, t.file).replace(/\\/g, "/")}  (agent)`),
 		"",
-		F ? "import { Rpc, RpcGroup } from '@effect/rpc'" : "import { RpcGroup } from '@effect/rpc'",
-		...F || P ? ["import { Schema } from 'effect'"] : [],
-		`import { ${U.join(", ")} } from '@voltro/protocol'`,
-		...f ? ["import { agentRouteDescriptors as __voltroAgentRoutes } from '@voltro/ai/agent'"] : [],
+		I ? "import { Rpc, RpcGroup } from '@effect/rpc'" : "import { RpcGroup } from '@effect/rpc'",
+		...I || F ? ["import { Schema } from 'effect'"] : [],
+		`import { ${Y.join(", ")} } from '@voltro/protocol'`,
+		...m ? ["import { agentRouteDescriptors as __voltroAgentRoutes } from '@voltro/ai/agent'"] : [],
 		"",
-		...O.map(j),
-		...o.map((e) => `import { ${e.exportName} as ${v(e)} } from './${a(k, e.file).replace(/\\/g, "/").replace(/\.tsx?$/, "")}'`),
-		...b ? ["", ...x] : [],
-		...C ? ["", ...w] : [],
+		...k.map(M),
+		...o.map((e) => `import { ${e.exportName} as ${y(e)} } from './${a(A, e.file).replace(/\\/g, "/").replace(/\.tsx?$/, "")}'`),
+		...x ? ["", ...S] : [],
+		...w ? ["", ...T] : [],
+		...K ? [
+			"",
+			"/** Which namespace each installed plugin answers to in THIS app. Read by",
+			" *  the plugins' own client hooks via `pluginTag()` so an `alias` in",
+			" *  app.config.ts moves them too, not just the server's routes. */",
+			"registerPluginAliases({",
+			...W.map(([e, t]) => `  ${JSON.stringify(e)}: ${JSON.stringify(t)},`),
+			"})"
+		] : [],
 		"",
-		...o.map((e) => `const ${y(e)} = __voltroAgentRoutes(${v(e)})`),
-		...f ? [""] : [],
-		...b ? [
+		...o.map((e) => `const ${b(e)} = __voltroAgentRoutes(${y(e)})`),
+		...m ? [""] : [],
+		...x ? [
 			"/** Cross-cutting plugin error schemas, unioned into every rpc's",
 			" *  wire error so interceptor failures decode typed on the client. */",
 			`const __voltroPluginErrors = [${i.map((e, t) => `__pe${t}`).join(", ")}] as const`,
 			""
 		] : [],
-		...F ? [
+		...I ? [
 			"const __voltroEmptyWorkflowMessages = { signals: {}, updates: {} } as const",
 			"const __voltroWorkflowMessages = <const M extends {",
 			"  readonly signals: Readonly<Record<string, Schema.Schema.Any>>",
@@ -460,7 +472,7 @@ ${o.join("\n\n")}\n`);
 			"  definition.__voltroWorkflowMessages ?? __voltroEmptyWorkflowMessages",
 			"",
 			"export const workflowDescriptors = {",
-			...ie,
+			...se,
 			"} as const",
 			"",
 			"export type WorkflowDescriptors = typeof workflowDescriptors",
@@ -479,9 +491,9 @@ ${o.join("\n\n")}\n`);
 			"} }",
 			""
 		] : [],
-		...O.map(M),
-		...o.flatMap((e) => [`export const ${G(`${e.name}.send`)} = actionToRpc(${y(e)}.send${S})`, `export const ${G(`${e.name}.messages`)} = queryToRpc(${y(e)}.messages${S})`]),
-		...F ? [
+		...k.map(N),
+		...o.flatMap((e) => [`export const ${G(`${e.name}.send`)} = actionToRpc(${b(e)}.send${C})`, `export const ${G(`${e.name}.messages`)} = queryToRpc(${b(e)}.messages${C})`]),
+		...I ? [
 			"export const __voltroWorkflowRun = queryToRpc(workflowRunQueryDescriptor)",
 			"export const __voltroWorkflowRuns = queryToRpc(workflowRunsQueryDescriptor)",
 			"export const __voltroWorkflowRunSteps = queryToRpc(workflowRunStepsQueryDescriptor)",
@@ -498,26 +510,26 @@ ${o.join("\n\n")}\n`);
 			"export const __voltroUndoApply = mutationToRpc(undoApplyDescriptor)",
 			"export const __voltroUndoRedo = mutationToRpc(undoRedoDescriptor)"
 		] : [],
-		...R ? ["export const __voltroApprovalsPending = queryToRpc(approvalsPendingQueryDescriptor)", "export const __voltroApprovalsDecide = mutationToRpc(approvalsDecideDescriptor)"] : [],
+		...z ? ["export const __voltroApprovalsPending = queryToRpc(approvalsPendingQueryDescriptor)", "export const __voltroApprovalsDecide = mutationToRpc(approvalsDecideDescriptor)"] : [],
 		...l ? [
 			"export const __voltroConnectionsList = queryToRpc(connectionsListQueryDescriptor)",
 			"export const __voltroConnectionStart = actionToRpc(connectionStartDescriptor)",
 			"export const __voltroConnectionSubmitToken = mutationToRpc(connectionSubmitTokenDescriptor)",
 			"export const __voltroConnectionDisconnect = mutationToRpc(connectionDisconnectDescriptor)"
 		] : [],
-		...E,
+		...D,
 		"",
 		"export const appGroup = RpcGroup.make(",
-		V,
+		H,
 		")",
 		"",
 		"/** Per-rpc-tag metadata for the client. Drives auto-optimistic etc.",
 		" *  Function fields (target.shape, target.identify) survive because",
 		" *  the descriptors themselves are imported by reference. */",
 		"export const appDescriptors = {",
-		...Z,
-		...$,
-		...Q,
+		...ne,
+		...ie,
+		...re,
 		"} as const",
 		"",
 		"export type AppDescriptors = typeof appDescriptors",
@@ -541,16 +553,16 @@ ${o.join("\n\n")}\n`);
 		" *  Types only — erased at build time, so importing it costs the bundle",
 		" *  nothing. */",
 		"export type AppProcedures = {",
-		...re,
+		...oe,
 		"}",
 		"",
-		...P ? [
+		...F ? [
 			"type __AppErrorOf<D> = D extends { readonly error: infer E extends Schema.Schema.Any } ? Schema.Schema.Type<E> : never",
 			"/** Union of every typed error the app's rpcs can fail with — the declared",
 			" *  `error:` schemas + cross-cutting plugin errors. Generated by reference,",
 			" *  so it can never drift out of date. (Workflows: see `WorkflowErrors`.) */",
 			"export type AppError =",
-			...N,
+			...P,
 			"/** The `_tag` literal of every AppError — the exhaustive key set for `matchError`. */",
 			"export type AppErrorTag = AppError extends { readonly _tag: infer T extends string } ? T : never",
 			"",
@@ -594,7 +606,7 @@ ${o.join("\n\n")}\n`);
 		"workflows"
 	]), p = (e) => e.slice(e.lastIndexOf("/") + 1), m = u;
 	for (; m !== t && d.has(p(m));) m = m.slice(0, m.lastIndexOf("/")) || "/";
-	let h = o(e.outputFile ?? i(m, "rpcGroup.generated.ts")), g = [...new Map((e.pluginErrorImports ?? []).map((e) => [`${e.module}#${e.name}`, e])).values()], _ = [...new Map((e.pluginRpcImports ?? []).map((e) => [e.tag, e])).values()], v = await Y(r(h)), y = Q(t, h, a, g, c, f(), l, _, v), b = [];
+	let h = o(e.outputFile ?? i(m, "rpcGroup.generated.ts")), g = [...new Map((e.pluginErrorImports ?? []).map((e) => [`${e.module}#${e.name}`, e])).values()], _ = [...new Map((e.pluginRpcImports ?? []).map((e) => [e.tag, e])).values()], v = await Y(r(h)), y = Q(t, h, a, g, c, f(), l, _, e.pluginAliases ?? {}, v), b = [];
 	for (let t of e.pluginContributions ?? []) {
 		let e = null;
 		try {

package/dist/codegen-DbH7NbCR.js

@@ -0,0 +1,2 @@
+import { t as e } from "./codegen-Bth5lUTU.js";
+export { e as checkRpcGroupFreshness };

package/dist/{codegenCommand-CG_Vx4lc.js → codegenCommand-CidbQzbv.js}

@@ -1,36 +1,37 @@
-import { Dn as e, En as t, V as n, l as r, u as i } from "./dev-CmuvUKRq.js";
-import { n as a } from "./frameworkTableAssembly-D7LJuALW.js";
-import { i as o, r as s } from "./codegen-DSLM8Su9.js";
+import { An as e, V as t, kn as n, l as r, u as i } from "./dev-Dw263KPu.js";
+import { n as a } from "./frameworkTableAssembly-DNOFXfEQ.js";
+import { i as o, r as s } from "./codegen-Bth5lUTU.js";
 import { n as c, r as l } from "./mobileCommand-D9O6iq3D.js";
 import { basename as u, relative as d, resolve as f } from "node:path";
 //#region src/codegenCommand.ts
-var p = async (t) => {
-	let { config: i, present: a, error: o } = await r(t);
+var p = async (n) => {
+	let { config: i, present: a, error: o } = await r(n);
 	if (a && i === null) return {
 		kind: "refused",
 		reason: "app.config.ts exists but could not be loaded" + (o === void 0 ? "" : ` — ${o instanceof Error ? o.message : String(o)}`)
 	};
-	let c = i?.plugins ?? [], { pluginContributions: l, pluginErrorImports: d, pluginRpcImports: f } = await n(c, i?.name ?? u(t), t), p = await s({
-		root: t,
+	let c = i?.plugins ?? [], { pluginContributions: l, pluginErrorImports: d, pluginRpcImports: f, pluginAliases: p } = await t(c, i?.name ?? u(n), n), h = await s({
+		root: n,
 		...l.length > 0 ? { pluginContributions: l } : {},
 		...d.length > 0 ? { pluginErrorImports: d } : {},
 		...f.length > 0 ? { pluginRpcImports: f } : {},
+		...Object.keys(p).length > 0 ? { pluginAliases: p } : {},
 		...i?.name === void 0 ? {} : { apiName: i.name }
 	});
-	if (!p) return { kind: "nothing-to-write" };
-	let h = await m(t, i), g = await e(p, h);
+	if (!h) return { kind: "nothing-to-write" };
+	let g = await m(n, i), _ = await e(h, g);
 	return {
 		kind: "wrote",
-		file: p,
+		file: h,
 		plugins: c.length,
 		errorSchemas: d.length,
 		routes: f.length,
-		tables: h.size,
-		dts: g
+		tables: g.size,
+		dts: _
 	};
-}, m = async (e, n) => {
+}, m = async (e, t) => {
 	let r = await o(e), { tables: s } = await i(r), c = await a({ root: e });
-	return t(s, c, n?.analytics?.tables ?? []);
+	return n(s, c, t?.analytics?.tables ?? []);
 }, h = async (e) => {
 	let t = f(e.find((e) => !e.startsWith("-")) ?? process.cwd()), n = await l(t);
 	if (n.apis.kind !== "not-a-mobile-app") return c(t, n);