@junejs/server 0.1.2 → 0.2.0

package/dist/build.d.ts

@@ -1,40 +1,19 @@
-import { JuneAdapter } from "./adapter.js";
-import { WorkerManifest } from "./worker.js";
-import { JuneConfig } from "@junejs/core/config";
-import { DocumentConfig } from "@junejs/core/document";
+import { a as scanAppRoutes, o as scanRoutes, t as RouteEntry } from "./route-scan-BMbBzPIB.js";
+import { t as generateContent } from "./content-freeze-CyiW2fRK.js";
+import { i as workerName, n as normalizeBase, r as resolveDeployAdapter, t as freezeConfig } from "./config-freeze-CyXvNqi2.js";
+import { n as buildManifest } from "./manifest-CwTT1zVs.js";
 //#region src/build.d.ts
-type BuildResult = {
+export type BuildResult = {
   outFile: string;
   routes: string[];
   dynamicRoutes: string[];
   contentCollections: string[];
   prerendered: string[];
 };
-type RouteEntry = {
-  path: string;
-  file: string;
-  dynamic: boolean;
-  resource?: boolean;
-  layouts: string[];
-  loading?: string;
-};
-declare const isBunSpecifier: (id: string) => boolean;
-declare function resolveDeployAdapter(deploy: JuneConfig["deploy"]): JuneAdapter;
-declare function scanRoutes(appDir: string, dir?: string, layouts?: string[], out?: RouteEntry[], loading?: string): Promise<RouteEntry[]>;
-declare function generateContent(appRoot: string): Promise<string[]>;
-declare function freezeConfig(appRoot: string): Promise<{
-  document: DocumentConfig;
-  agent: WorkerManifest["agent"];
-  i18n: WorkerManifest["i18n"];
-  earlyHints: string[];
-  buildExternal: string[];
-}>;
-declare function normalizeBase(base?: string): string;
-declare function workerName(raw: string): string;
-declare function buildManifest(appRoot: string): Promise<WorkerManifest>;
-declare function juneBuild(appRoot: string, options?: {
+export declare const isBunSpecifier: (id: string) => boolean;
+export declare function juneBuild(appRoot: string, options?: {
   outDir?: string;
   external?: string[];
 }): Promise<BuildResult>;
 //#endregion
-export { BuildResult, buildManifest, freezeConfig, generateContent, isBunSpecifier, juneBuild, normalizeBase, resolveDeployAdapter, scanRoutes, workerName };
+export { type RouteEntry, buildManifest, freezeConfig, generateContent, normalizeBase, resolveDeployAdapter, scanAppRoutes, scanRoutes, workerName };

package/dist/build.js

@@ -1,281 +1,29 @@
-import { deno, staticSite, vercel, workers } from "./adapter.js";
+import { jsxTransform } from "./tsconfig-jsx.js";
+import { generateAgentModule } from "./agent-compile.js";
 import { findMiddlewareFile } from "./router.js";
+import { scanAppRoutes, scanRoutes } from "./route-scan.js";
 import { resolveBoundary } from "./segment.js";
 import { buildModuleCss, registerCssModules, rolldownCssModulesPlugin } from "./css-modules.js";
-import { jsxTransform } from "./tsconfig-jsx.js";
-import { CLIENT_SCRIPT_URL, bundleClientToFile, findClientEntry } from "./client-bundle.js";
+import { bundleClientToFile, findClientEntry } from "./client-bundle.js";
 import { generateIslandRegistry } from "./island-registry.js";
-import { STYLES_URL, cssTargets, findGlobalCss, globalCssUsesTailwind, minifyCss, processCss } from "./css.js";
+import { cssTargets, minifyCss, processCss } from "./css.js";
 import { RESERVED_PREFIX } from "./static-files.js";
-import { findJuneConfigPath, loadJuneConfig } from "./config-loader.js";
-import { generateContentModule } from "./content.js";
+import { GENERATED_ICONS, googleFontFetcher, publicFileCheck, renderIcons, resolveIcons } from "./favicon.js";
+import { loadJuneConfig } from "./config-loader.js";
+import { freezeConfig, normalizeBase, resolveDeployAdapter, workerName } from "./config-freeze.js";
+import { generateContent } from "./content-freeze.js";
 import { createWorker } from "./worker.js";
+import { buildManifest, importLayout } from "./manifest.js";
 import { buildRsc, findRscRoutes } from "./rsc-build.js";
 import { existsSync, lstatSync } from "node:fs";
-import { copyFile, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
+import { copyFile, mkdir, readdir, rm, writeFile } from "node:fs/promises";
 import { basename, dirname, join, relative, resolve, sep } from "node:path";
-import { pathToFileURL } from "node:url";
-import { routeFromModule } from "@junejs/core/route";
-import { resolveAgent, resolveClientRouter, resolveSpeculationRules } from "@junejs/core/config";
+import { PRERENDER_ORIGIN } from "@junejs/core/document";
 import { buildLinkHeader } from "@junejs/core/discovery";
 import { localeHref } from "@junejs/core/i18n";
 import { createHash } from "node:crypto";
-import { execFileSync } from "node:child_process";
 //#region src/build.ts
-const PAGE_BASENAMES = /* @__PURE__ */ new Set(["page", "index"]);
-const ROUTE_EXTS = [
-	".tsx",
-	".jsx",
-	".ts",
-	".js"
-];
-const isRouteGroup = (name) => /^\(.+\)$/.test(name);
 const isBunSpecifier = (id) => id === "bun" || id.startsWith("bun:");
-function resolveDeployAdapter(deploy) {
-	if (deploy?.adapter) return deploy.adapter;
-	switch (deploy?.target) {
-		case "static": return staticSite();
-		case "vercel": return vercel();
-		case "deno": return deno();
-		default: return workers({
-			name: deploy?.name,
-			domain: deploy?.domain
-		});
-	}
-}
-function segmentFile(dir, base) {
-	return ROUTE_EXTS.map((e) => join(dir, `${base}${e}`)).find(existsSync);
-}
-async function scanRoutes(appDir, dir = appDir, layouts = [], out = [], loading) {
-	const ownLayout = segmentFile(dir, "layout");
-	const chain = ownLayout ? [...layouts, ownLayout] : layouts;
-	const nearestLoading = segmentFile(dir, "loading") ?? loading;
-	const entries = await readdir(dir, { withFileTypes: true }).catch(() => []);
-	for (const e of entries) {
-		if (e.name.startsWith("_") || e.name.startsWith(".")) continue;
-		const full = join(dir, e.name);
-		if (e.isDirectory()) {
-			await scanRoutes(appDir, full, chain, out, nearestLoading);
-			continue;
-		}
-		const ext = e.name.match(/\.[^.]+$/)?.[0] ?? "";
-		if (!ROUTE_EXTS.includes(ext)) continue;
-		const base = basename(e.name, ext);
-		const resource = base === "route";
-		if (!PAGE_BASENAMES.has(base) && !resource) continue;
-		const relDir = relative(appDir, dir);
-		const path = "/" + (relDir === "" ? [] : relDir.split(sep).filter((s) => !isRouteGroup(s))).join("/");
-		out.push({
-			path: path === "/" ? "/" : path,
-			file: full,
-			dynamic: /\[.+\]/.test(path),
-			resource,
-			layouts: chain,
-			loading: nearestLoading
-		});
-	}
-	return out;
-}
-async function generateContent(appRoot) {
-	const contentDir = join(appRoot, "content");
-	await mkdir(join(appRoot, "app"), { recursive: true });
-	const emit = async (sources, knownLocales) => {
-		const { code, names } = generateContentModule(contentDir, knownLocales, sources);
-		await writeFile(join(appRoot, "app", "_content.ts"), code);
-		return names;
-	};
-	const resolveSources = (sources) => sources.map((s) => ({
-		...s,
-		dir: resolve(appRoot, s.dir)
-	}));
-	const declaredLocales = (config) => config.i18n ? [.../* @__PURE__ */ new Set([config.i18n.defaultLocale, ...Object.keys(config.i18n.locales)])] : [];
-	let config = null;
-	try {
-		config = await loadJuneConfig(appRoot);
-	} catch {}
-	if (config) return emit(resolveSources(config.content?.sources ?? []), declaredLocales(config));
-	const names = await emit([], void 0);
-	await seedContentImports(appRoot);
-	const probed = probeConfigFresh(appRoot);
-	if (probed === null) {
-		console.warn("[june gen] june.config.ts failed to load — content.sources/i18n locales (if any) not applied");
-		return names;
-	}
-	return emit(resolveSources(probed.sources), probed.locales);
-}
-async function seedContentImports(appRoot) {
-	const cfgPath = findJuneConfigPath(appRoot);
-	if (!cfgPath) return;
-	const contentFile = join(appRoot, "app", "_content.ts");
-	const current = existsSync(contentFile) ? await readFile(contentFile, "utf8") : "";
-	const cfgSrc = await readFile(cfgPath, "utf8");
-	const isIdent = (s) => /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(s);
-	const seen = /* @__PURE__ */ new Set();
-	const stubs = [];
-	for (const m of cfgSrc.matchAll(/import\s*(?:type\s+)?\{([^}]*)\}\s*from\s*["'][^"']*app\/_content(?:\.\w+)?["']/g)) {
-		const inner = (m[1] ?? "").replace(/\/\*[\s\S]*?\*\//g, "").replace(/\/\/[^\n]*/g, "");
-		for (const part of inner.split(",")) {
-			const name = part.replace(/\btype\b/g, "").split(/\s+as\s+/).pop()?.trim();
-			if (!name || !isIdent(name) || seen.has(name)) continue;
-			seen.add(name);
-			const reName = name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-			if (!new RegExp(`export (?:const|function|type) ${reName}\\b`).test(current)) stubs.push(`export const ${name}: ContentEntry[] = [];`);
-		}
-	}
-	if (stubs.length) await writeFile(contentFile, current + stubs.join("\n") + "\n");
-}
-function probeConfigFresh(appRoot) {
-	const path = findJuneConfigPath(appRoot);
-	if (!path) return {
-		sources: [],
-		locales: []
-	};
-	const code = `import(${JSON.stringify(pathToFileURL(path).href)}).then((m) => { const c = m.default ?? {}; process.stdout.write("\\n__JUNE_CONTENT__" + JSON.stringify({ sources: c.content?.sources ?? [], locales: c.i18n ? [...new Set([c.i18n.defaultLocale, ...Object.keys(c.i18n.locales ?? {})])] : [] }) + "__END__"); }, () => process.exit(42));`;
-	try {
-		const m = execFileSync(process.execPath, [
-			...process.execArgv,
-			"-e",
-			code
-		], {
-			encoding: "utf8",
-			stdio: [
-				"ignore",
-				"pipe",
-				"ignore"
-			]
-		}).match(/__JUNE_CONTENT__(.*?)__END__/s);
-		return m ? JSON.parse(m[1]) : null;
-	} catch {
-		return null;
-	}
-}
-async function freezeConfig(appRoot) {
-	const cfg = await loadJuneConfig(appRoot);
-	const hasClient = findClientEntry(join(appRoot, "app")) !== void 0 || findClientEntry(join(appRoot, ".june", "routes")) !== void 0;
-	const hasCss = findGlobalCss(join(appRoot, "app")) !== null;
-	return {
-		document: {
-			site: cfg.site ?? {},
-			speculationRules: resolveSpeculationRules(cfg.speculation ?? void 0),
-			speculationDelivery: "inline",
-			viewTransitions: cfg.viewTransitions ?? true,
-			cssReset: cfg.cssReset ?? !globalCssUsesTailwind(join(appRoot, "app")),
-			clientRouter: resolveClientRouter(cfg.clientRouter),
-			clientScript: hasClient ? CLIENT_SCRIPT_URL : null,
-			styles: hasCss ? STYLES_URL : null,
-			basePath: normalizeBase(cfg.basePath)
-		},
-		agent: resolveAgent(cfg.agent),
-		i18n: cfg.i18n,
-		earlyHints: cfg.earlyHints ?? [],
-		buildExternal: cfg.build?.external ?? []
-	};
-}
-function normalizeBase(base) {
-	if (!base) return "";
-	const b = base.startsWith("/") ? base : `/${base}`;
-	return b.endsWith("/") ? b.slice(0, -1) : b;
-}
-async function importLayout(file) {
-	const mod = await import(pathToFileURL(file).href);
-	return typeof mod.default === "function" ? {
-		component: mod.default,
-		boundary: mod.segmentBoundary === true
-	} : null;
-}
-function workerName(raw) {
-	return raw.replace(/^@[^/]+\//, "").toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "") || "app";
-}
-async function buildManifest(appRoot) {
-	const appDir = join(appRoot, "app");
-	const juneRoutesDir = join(appRoot, ".june", "routes");
-	const frozen = await freezeConfig(appRoot);
-	const appRoutes = await scanRoutes(appDir);
-	const frameworkRoutes = existsSync(juneRoutesDir) ? await scanRoutes(juneRoutesDir) : [];
-	const appPaths = new Set(appRoutes.map((r) => r.path));
-	const scanned = [...appRoutes, ...frameworkRoutes.filter((r) => !appPaths.has(r.path))].sort((a, b) => a.path.localeCompare(b.path));
-	const layoutCache = /* @__PURE__ */ new Map();
-	const loadCached = async (f) => {
-		if (!layoutCache.has(f)) layoutCache.set(f, await importLayout(f));
-		return layoutCache.get(f) ?? null;
-	};
-	const componentsFor = async (files) => {
-		const items = [];
-		for (const f of files) {
-			const c = await loadCached(f);
-			items.push({
-				file: f,
-				entry: c?.component ?? null,
-				boundary: !!c?.boundary
-			});
-		}
-		return resolveBoundary(items);
-	};
-	const loadingCache = /* @__PURE__ */ new Map();
-	const loadingFor = async (file) => {
-		if (!file) return void 0;
-		if (!loadingCache.has(file)) {
-			const loaded = await importLayout(file);
-			loadingCache.set(file, loaded ? loaded.component : null);
-		}
-		return loadingCache.get(file) ?? void 0;
-	};
-	const routes = {};
-	const dynamicRoutes = [];
-	const resourceRoutes = [];
-	const layoutChains = {};
-	const layoutBoundaries = {};
-	const loadings = {};
-	for (const r of scanned) {
-		const mod = await import(pathToFileURL(r.file).href);
-		if (r.resource) {
-			const handler = mod.default;
-			if (typeof handler === "function") resourceRoutes.push({
-				pattern: r.path,
-				handler
-			});
-			continue;
-		}
-		const def = routeFromModule(mod);
-		if (!def) continue;
-		const { chain, boundaryIndex, key } = await componentsFor(r.layouts);
-		const loading = await loadingFor(r.loading);
-		if (r.dynamic) {
-			dynamicRoutes.push({
-				pattern: r.path,
-				def
-			});
-			layoutChains[r.path] = chain;
-		} else {
-			routes[r.path] = def;
-			layoutChains[r.path] = chain;
-		}
-		if (boundaryIndex !== null && key !== null) layoutBoundaries[r.path] = {
-			index: boundaryIndex,
-			key
-		};
-		if (loading) loadings[r.path] = loading;
-	}
-	let extra;
-	const extraFile = findMiddlewareFile(appDir);
-	if (extraFile) {
-		const mod = await import(pathToFileURL(extraFile).href);
-		if (typeof mod.default === "function") extra = mod.default;
-	}
-	return {
-		routes,
-		dynamicRoutes,
-		resourceRoutes,
-		layoutChains,
-		layoutBoundaries,
-		loadings,
-		document: frozen.document,
-		agent: frozen.agent,
-		i18n: frozen.i18n,
-		earlyHints: frozen.earlyHints,
-		extra
-	};
-}
 function importPath(fromDir, file) {
 	const p = relative(fromDir, file).split(sep).join("/").replace(/\.[^.]+$/, "");
 	return p.startsWith(".") ? p : `./${p}`;
@@ -300,11 +48,7 @@ async function juneBuild(appRoot, options = {}) {
 		force: true
 	});
 	const contentCollections = await generateContent(appRoot);
-	const juneRoutesDir2 = join(appRoot, ".june", "routes");
-	const appRoutes2 = await scanRoutes(appDir);
-	const frameworkRoutes2 = existsSync(juneRoutesDir2) ? await scanRoutes(juneRoutesDir2) : [];
-	const appPaths2 = new Set(appRoutes2.map((r) => r.path));
-	const routes = [...appRoutes2, ...frameworkRoutes2.filter((r) => !appPaths2.has(r.path))].sort((a, b) => a.path.localeCompare(b.path));
+	const routes = await scanAppRoutes(appRoot);
 	if (routes.length === 0) throw new Error(`no page.* routes found under ${appDir} or .june/routes/`);
 	const frozen = await freezeConfig(appRoot);
 	if (frozen.i18n?.resolveLocale) console.warn("[june build] i18n.resolveLocale is not yet wired into the built worker (URL-pinned + built-in negotiation work; the hook runs in dev only).");
@@ -317,6 +61,24 @@ async function juneBuild(appRoot, options = {}) {
 		} : void 0 },
 		config: fullConfig
 	});
+	const agentDir = join(appDir, frozen.agent.runtime.dir);
+	let agentModule = null;
+	if (frozen.agent.runtime.enabled) {
+		const generated = generateAgentModule(agentDir);
+		if (generated && adapter.capabilities.durableObjects) agentModule = generated;
+		else if (generated) console.warn(`[june build] app/${frozen.agent.runtime.dir}/ found, but the ${adapter.name}() target has no Durable Objects — the durable agent is not mounted.`);
+	}
+	if (agentModule) {
+		const sdkResolvable = (fromDir) => {
+			for (let d = resolve(fromDir);;) {
+				if (existsSync(join(d, "node_modules", "@anthropic-ai", "sdk", "package.json"))) return true;
+				const parent = dirname(d);
+				if (parent === d) return false;
+				d = parent;
+			}
+		};
+		if (!sdkResolvable(appRoot)) throw new Error(`app/${frozen.agent.runtime.dir}/ mounts a durable agent whose model is Claude — add the SDK to the app so it bundles for workerd: bun add @anthropic-ai/sdk`);
+	}
 	const cssOut = await processCss(appDir, { minify: true });
 	let cssAsset = null;
 	if (cssOut !== null) {
@@ -392,10 +154,12 @@ async function juneBuild(appRoot, options = {}) {
 		if (r.loading) loadings.push(`    ${JSON.stringify(r.path)}: ${loadingId(r.loading)},`);
 	});
 	const resourceRoutesField = resources.length ? `\n  resourceRoutes: [\n${resources.join("\n")}\n  ],` : "";
+	const generatedPaths = routes.filter((r) => r.generated).map((r) => r.path);
+	const generatedRoutesField = generatedPaths.length ? `\n  generatedRoutes: ${JSON.stringify(generatedPaths)},` : "";
 	const layoutBoundariesField = boundaries.length ? `\n  layoutBoundaries: {\n${boundaries.join("\n")}\n  },` : "";
 	const builtExtraFile = findMiddlewareFile(appDir);
 	if (builtExtraFile) imports.push(`import extra from ${JSON.stringify(importPath(genDir, builtExtraFile))};`);
-	const linkHeader = buildLinkHeader(frozen.agent);
+	const linkHeader = buildLinkHeader(frozen.agent, { catalogs: !frozen.document.basePath });
 	const adapterEntry = adapter.entry({ linkHeader });
 	const resourceFlags = {
 		db: !!resourcesCfg?.db,
@@ -407,7 +171,8 @@ async function juneBuild(appRoot, options = {}) {
 		imports.push(`import { turso } from "@junejs/server/db";`);
 		imports.push(`import { memoizeResources } from "@junejs/server/resources";`);
 	} else if (hasResources) imports.push(`import { bindWorkerResources } from "@junejs/server/resources";`);
-	const resourcesField = tursoDb ? `\n  resources: memoizeResources({ db: turso() }),` : hasResources ? `\n  resources: bindWorkerResources(${JSON.stringify(resourceFlags)}),` : "";
+	const resourcesExpr = tursoDb ? `memoizeResources({ db: turso() })` : hasResources ? `bindWorkerResources(${JSON.stringify(resourceFlags)})` : null;
+	const resourcesField = resourcesExpr ? `\n  resources: ${resourcesExpr},` : "";
 	const dataLayerModule = fullConfig.dataLayer?.module;
 	if (dataLayerModule) imports.push(`import { installDataLayer } from ${JSON.stringify(dataLayerModule)};`);
 	const dataLayerBoot = dataLayerModule ? "\ninstallDataLayer();\n" : "";
@@ -417,17 +182,51 @@ async function juneBuild(appRoot, options = {}) {
 		imports.push(`import { services as __appServices } from ${JSON.stringify(spec)};`);
 	}
 	const servicesField = servicesModule ? `\n  services: __appServices,` : "";
+	if (agentModule) {
+		imports.push(`import __agentModule from ${JSON.stringify(importPath(genDir, agentModule.file))};`);
+		imports.push(`import { assembleDurable } from "@junejs/core/agent-config";`);
+		imports.push(`import { anthropic } from "@junejs/core/agent-models";`);
+		imports.push(`import { AgentDurableObject } from "@junejs/server/agent-durable";`);
+		imports.push(`import { DurableObject } from "cloudflare:workers";`);
+		imports.push(`import Anthropic from "@anthropic-ai/sdk";`);
+	}
+	const agentPreamble = agentModule ? `\nconst __agentDef = assembleDurable(__agentModule);\n` : "";
+	const agentNameField = agentModule ? `\n  agentName: __agentModule.config.name,\n  agentChannels: __agentDef.channels,` : "";
+	const doClass = agentModule ? `
+// The durable agent: one Durable Object per session, the compiled agent/
+// directory as its definition — adapted tools (+ read_skill when skills exist),
+// the assembled system prompt, channel factories resolved with the DO's own
+// env, and the app's declared resources opened from THIS isolate's env (lazily,
+// at the first turn — the same ambient db a tool sees in native dev). Model:
+// Anthropic over a statically bundled client (workerd cannot resolve a bare
+// import at runtime), keyed by the ANTHROPIC_API_KEY secret — a missing secret
+// surfaces as the SDK's own clear construction error on the first agent request.
+export class JuneAgentDO extends DurableObject {
+  #agent = new AgentDurableObject(this.ctx, {
+    ...__agentDef,
+    model: anthropic({ model: __agentModule.config.model, client: new Anthropic({ apiKey: (this.env as { ANTHROPIC_API_KEY?: string }).ANTHROPIC_API_KEY }) }),
+    env: this.env,${resourcesExpr ? `\n    resources: ${resourcesExpr},` : ""}${servicesModule ? "\n    services: __appServices(this.env)," : ""}
+  });
+  fetch(req: Request): Promise<Response> {
+    return this.#agent.fetch(req);
+  }
+  // Delivers input announcements left undelivered — a failed hook's retry, or the watchdog (#260).
+  alarm(): Promise<void> {
+    return this.#agent.alarm();
+  }
+}
+` : "";
 	const entry = `// AUTO-GENERATED by \`june build\` — do not edit. Regenerate: june build .
 ${adapterEntry.imports.join("\n")}
 ${imports.join("\n")}
-${dataLayerBoot}
+${dataLayerBoot}${agentPreamble}
 const pipeline = createWorker({
   routes: {
 ${statics.join("\n")}
   },
   dynamicRoutes: [
 ${dynamics.join("\n")}
-  ],${resourceRoutesField}
+  ],${resourceRoutesField}${generatedRoutesField}
   layoutChains: {
 ${chains.join("\n")}
   },${layoutBoundariesField}
@@ -435,12 +234,12 @@ ${chains.join("\n")}
 ${loadings.join("\n")}
   },
   document: ${JSON.stringify(frozen.document, null, 2).replace(/\n/g, "\n  ")},
-  agent: ${JSON.stringify(frozen.agent)},${frozen.i18n ? `\n  i18n: ${JSON.stringify(frozen.i18n)},` : ""}
+  agent: ${JSON.stringify(frozen.agent)},${agentNameField}${frozen.i18n ? `\n  i18n: ${JSON.stringify(frozen.i18n)},` : ""}
   earlyHints: ${JSON.stringify(frozen.earlyHints)},${builtExtraFile ? "\n  extra," : ""}${resourcesField}${servicesField}
 });
 
 ${adapterEntry.wrap("pipeline")}
-`;
+${doClass}`;
 	const entryFile = join(genDir, "worker-entry.tsx");
 	await writeFile(entryFile, entry);
 	const { rolldown } = await import("rolldown");
@@ -455,6 +254,7 @@ ${adapterEntry.wrap("pipeline")}
 		plugins: [rolldownCssModulesPlugin(cssModuleMaps)],
 		external: (id) => {
 			if (isBunSpecifier(id)) return true;
+			if (id.startsWith("cloudflare:")) return true;
 			if (/\.(wasm|ttf|otf|woff2?|png|jpe?g|avif|webp)$/.test(id)) return true;
 			return [...adapter.buildExternal ?? [], ...options.external ?? frozen.buildExternal].some((e) => id === e || id.startsWith(`${e}/`));
 		},
@@ -473,7 +273,14 @@ ${adapterEntry.wrap("pipeline")}
 	if (cssAsset) manifest.document.styles = `/${cssAsset}`;
 	if (clientAsset) manifest.document.clientScript = `/${clientAsset}`;
 	if (moduleCssAsset) manifest.document.moduleStyles = `/${moduleCssAsset}`;
-	const worker = createWorker(manifest);
+	const isStatic = adapter.capabilities.runtime === "static";
+	if (isStatic) manifest.agent = {
+		...manifest.agent,
+		mcp: false,
+		api: false,
+		webmcp: false
+	};
+	const worker = createWorker(manifest, { staticBuild: isStatic });
 	let hasAssets = false;
 	const publicDir = join(appRoot, "public");
 	const publicFiles = [];
@@ -495,7 +302,20 @@ ${adapterEntry.wrap("pipeline")}
 		}
 		if (publicFiles.length) hasAssets = true;
 	}
-	const isStatic = adapter.capabilities.runtime === "static";
+	const site = frozen.document.site;
+	if (resolveIcons(site, publicFileCheck(publicDir)).generate) {
+		const icons = await renderIcons({
+			site,
+			fetchFont: googleFontFetcher(join(appRoot, "node_modules", ".cache", "june", "fonts")),
+			warn: (msg) => console.warn(msg)
+		});
+		await mkdir(assetsDir, { recursive: true });
+		for (const file of GENERATED_ICONS) {
+			await writeFile(join(assetsDir, file), icons[file]);
+			publicFiles.push(file);
+		}
+		hasAssets = true;
+	}
 	const i18n = frozen.i18n;
 	const prerenderOne = async (reqPath, def) => {
 		const stem = reqPath === "/" ? "index" : reqPath.slice(1);
@@ -509,7 +329,7 @@ ${adapterEntry.wrap("pipeline")}
 		if (def.md !== false) targets.push([mdReq, mdFile]);
 		if (typeof def.json === "function") targets.push([jsonReq, jsonFile]);
 		for (const [rp, file] of targets) {
-			const res = await worker.fetch(new Request(`https://prerender.june${rp}`));
+			const res = await worker.fetch(new Request(`${PRERENDER_ORIGIN}${rp}`));
 			if (!res.ok) throw new Error(`prerender ${rp} → ${res.status}`);
 			const dest = join(assetsDir, file);
 			await mkdir(dirname(dest), { recursive: true });
@@ -518,6 +338,10 @@ ${adapterEntry.wrap("pipeline")}
 		prerendered.push(reqPath);
 		hasAssets = true;
 	};
+	if (isStatic && i18n) {
+		const onDomain = Object.keys(i18n.locales).filter((l) => i18n.locales[l].domain);
+		if (onDomain.length) throw new Error(`[june build] the static() target serves one host, so i18n locales with their own domain are not supported (${onDomain.join(", ")}). Give them a path prefix instead, e.g. { path: "/${onDomain[0]}" }.`);
+	}
 	const localeVariants = (path) => isStatic && i18n ? [...new Set(Object.keys(i18n.locales).map((l) => localeHref(i18n, path, l)))] : [path];
 	for (const r of routes.filter((x) => !x.dynamic)) {
 		const def = manifest.routes[r.path];
@@ -530,19 +354,36 @@ ${adapterEntry.wrap("pipeline")}
 			const sp = dyn.def.staticPaths;
 			if (!sp) continue;
 			const paths = typeof sp === "function" ? await sp() : sp;
+			dyn.def.staticPaths = paths;
 			for (const p of paths) await prerenderOne(p, dyn.def);
 		}
-		for (const [reqPath, file] of [
+		const extra = [
 			["/favicon.svg", "favicon.svg"],
+			["/manifest.webmanifest", "manifest.webmanifest"],
 			["/llms.txt", "llms.txt"],
 			["/sitemap.xml", "sitemap.xml"]
-		]) {
-			const res = await worker.fetch(new Request(`https://prerender.june${reqPath}`));
+		];
+		if (manifest.agent.discovery && !manifest.document.site.url && !manifest.document.deployOrigin) console.warn("[june build] no sitemap.xml: set site.url (or deploy.domain) in june.config.ts so its URLs are absolute.");
+		const doc = manifest.document;
+		if (manifest.agent.discovery && !doc.basePath && (doc.site.url || doc.deployOrigin)) extra.push(["/.well-known/ai-catalog.json", ".well-known/ai-catalog.json"], ["/.well-known/ard.json", ".well-known/ard.json"], ["/.well-known/agent-skills/index.json", ".well-known/agent-skills/index.json"]);
+		for (let i = 0; i < extra.length; i++) {
+			const [reqPath, file] = extra[i];
+			const res = await worker.fetch(new Request(`${PRERENDER_ORIGIN}${reqPath}`));
 			if (!res.ok) continue;
-			await writeFile(join(assetsDir, file), Buffer.from(await res.arrayBuffer()));
+			const bytes = Buffer.from(await res.arrayBuffer());
+			await mkdir(dirname(join(assetsDir, file)), { recursive: true });
+			await writeFile(join(assetsDir, file), bytes);
 			hasAssets = true;
+			if (file.endsWith("agent-skills/index.json")) {
+				const index = JSON.parse(bytes.toString("utf8"));
+				for (const s of index.skills ?? []) {
+					if (!s.url) continue;
+					const p = new URL(s.url, PRERENDER_ORIGIN).pathname;
+					extra.push([p, p.slice(1)]);
+				}
+			}
 		}
-		const nf = await worker.fetch(new Request("https://prerender.june/__june_not_found__"));
+		const nf = await worker.fetch(new Request(`${PRERENDER_ORIGIN}/__june_not_found__`));
 		await writeFile(join(assetsDir, "404.html"), Buffer.from(await nf.arrayBuffer()));
 		hasAssets = true;
 	}
@@ -560,11 +401,18 @@ ${adapterEntry.wrap("pipeline")}
 		hasAssets = true;
 	}
 	const pkgPath = join(appRoot, "package.json");
-	const defaultName = workerName((existsSync(pkgPath) ? JSON.parse(await Bun.file(pkgPath).text()).name : void 0) ?? basename(appRoot));
-	const plan = resourcesCfg?.db && resourcesCfg.db.kind !== "turso" ? { db: {
-		binding: "DB",
-		databaseName: `${defaultName}-db`
-	} } : {};
+	const pkgName = existsSync(pkgPath) ? JSON.parse(await Bun.file(pkgPath).text()).name : void 0;
+	const defaultName = workerName(pkgName ?? basename(appRoot));
+	const plan = {
+		...resourcesCfg?.db && resourcesCfg.db.kind !== "turso" ? { db: {
+			binding: "DB",
+			databaseName: `${defaultName}-db`
+		} } : {},
+		...agentModule ? { agent: {
+			binding: "AGENT",
+			className: "JuneAgentDO"
+		} } : {}
+	};
 	await adapter.emit({
 		appRoot,
 		outDir,
@@ -576,6 +424,7 @@ ${adapterEntry.wrap("pipeline")}
 		publicFiles
 	});
 	if (plan.db) console.log(`  ↳ d1 binding "${plan.db.binding}" emitted — set database_id in wrangler.jsonc (wrangler d1 create ${plan.db.databaseName})`);
+	if (plan.agent) console.log(`  ↳ durable agent mounted (${plan.agent.className} → env.${plan.agent.binding}; chat at ${frozen.agent.runtime.chat.path})`);
 	return {
 		outFile,
 		routes: routes.filter((r) => !r.dynamic).map((r) => r.path),
@@ -585,4 +434,4 @@ ${adapterEntry.wrap("pipeline")}
 	};
 }
 //#endregion
-export { buildManifest, freezeConfig, generateContent, isBunSpecifier, juneBuild, normalizeBase, resolveDeployAdapter, scanRoutes, workerName };
+export { buildManifest, freezeConfig, generateContent, isBunSpecifier, juneBuild, normalizeBase, resolveDeployAdapter, scanAppRoutes, scanRoutes, workerName };

package/dist/client-bundle.d.ts

@@ -1,15 +1,14 @@
 import { ModuleMaps } from "./css-modules.js";
 //#region src/client-bundle.d.ts
-declare const CLIENT_SCRIPT_URL = "/_june/client.js";
-declare function findClientEntry(appDir: string): string | undefined;
+export declare const CLIENT_SCRIPT_URL = "/_june/client.js";
+export declare function findClientEntry(appDir: string): string | undefined;
 type BundleMode = "development" | "production";
-declare function isExpectedClientLog(log: {
+export declare function isExpectedClientLog(log: {
   code?: string;
   exporter?: string;
 }): boolean;
-type ClientChunks = Map<string, string>;
-declare function bundleClientSplit(entryFile: string, cwd: string, mode: BundleMode, maps?: ModuleMaps): Promise<ClientChunks>;
-declare function bundleClientToString(entryFile: string, cwd: string, maps?: ModuleMaps): Promise<string>;
-declare function bundleClientToFile(entryFile: string, cwd: string, destDir: string, maps?: ModuleMaps): Promise<string>;
-//#endregion
-export { CLIENT_SCRIPT_URL, ClientChunks, bundleClientSplit, bundleClientToFile, bundleClientToString, findClientEntry, isExpectedClientLog };
+export type ClientChunks = Map<string, string>;
+export declare function bundleClientSplit(entryFile: string, cwd: string, mode: BundleMode, maps?: ModuleMaps): Promise<ClientChunks>;
+export declare function bundleClientToString(entryFile: string, cwd: string, maps?: ModuleMaps): Promise<string>;
+export declare function bundleClientToFile(entryFile: string, cwd: string, destDir: string, maps?: ModuleMaps): Promise<string>;
+//#endregion

package/dist/client-bundle.js

@@ -1,5 +1,5 @@
-import { rolldownCssModulesPlugin } from "./css-modules.js";
 import { jsxTransform } from "./tsconfig-jsx.js";
+import { rolldownCssModulesPlugin } from "./css-modules.js";
 import { existsSync } from "node:fs";
 import { mkdir, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";

package/dist/config-freeze-CyXvNqi2.d.ts

@@ -0,0 +1,17 @@
+import { i as JuneAdapter } from "./adapter-DcZ-W1-7.js";
+import { n as WorkerManifest } from "./worker-2qbQjj2c.js";
+import { JuneConfig } from "@junejs/core/config";
+import { DocumentConfig } from "@junejs/core/document";
+//#region src/config-freeze.d.ts
+declare function resolveDeployAdapter(deploy: JuneConfig["deploy"]): JuneAdapter;
+declare function freezeConfig(appRoot: string): Promise<{
+  document: DocumentConfig;
+  agent: WorkerManifest["agent"];
+  i18n: WorkerManifest["i18n"];
+  earlyHints: string[];
+  buildExternal: string[];
+}>;
+declare function normalizeBase(base?: string): string;
+declare function workerName(raw: string): string;
+//#endregion
+export { workerName as i, normalizeBase as n, resolveDeployAdapter as r, freezeConfig as t };

package/dist/config-freeze.d.ts

@@ -0,0 +1,2 @@
+import { i as workerName, n as normalizeBase, r as resolveDeployAdapter, t as freezeConfig } from "./config-freeze-CyXvNqi2.js";
+export { freezeConfig, normalizeBase, resolveDeployAdapter, workerName };