@junejs/server 1.0.0-dev.42 → 1.0.0-dev.47

package/dist/agent-durable.d.ts

@@ -1,5 +1,6 @@
 import { Channel, ChannelFactory } from "@junejs/core/agent-config";
 import { AuthorizeAnswer, ChannelPolicy, InboundEvent, InputAnnouncement, Model, Msg, NoteKind, ProactiveTrigger, SessionStore, Tool, TurnError, TurnEvent, TurnFailurePhase } from "@junejs/core/agent-runtime";
+import { FileStore } from "@junejs/core/agent-files";
 import { Connection } from "@junejs/core/connections";
 import { Resources } from "@junejs/core/resources";
 //#region src/agent-durable.d.ts
@@ -63,6 +64,7 @@ export type DoAgentDef = {
   }) => void | Promise<void>;
   authorizeAnswer?: AuthorizeAnswer;
   onInputAnnouncement?: (a: InputAnnouncement) => void | Promise<void>;
+  files?: FileStore;
 };
 export declare class AgentDurableObject {
   private session;
@@ -83,6 +85,7 @@ export declare class AgentDurableObject {
   private readonly authorizeAnswer?;
   private readonly onInputAnnouncement?;
   private readonly storage;
+  private readonly files;
   private announceFailures;
   private resolveResources;
   private resolveConnections;
@@ -140,5 +143,6 @@ export declare function durableChannelSurface(getNamespace: () => DurableObjectN
   env: unknown;
   services?: (env: unknown) => unknown;
   waitUntil?: (p: Promise<unknown>) => void;
+  files?: FileStore;
 }): (req: Request) => Promise<Response | null>;
 //#endregion

package/dist/agent-durable.js

@@ -2,7 +2,8 @@ import { observeTurnEvents } from "./turn-events.js";
 import { isolateLocal } from "./isolate-local.js";
 import { assertCoreRuntimeVersion } from "./core-version.js";
 import { DeliverUnsupportedError, actionToTool, channelDispatch, resolveChannel } from "@junejs/core/agent-config";
-import { AgentSession, ResumeAuthorizationError, grantAnswer, withSystem } from "@junejs/core/agent-runtime";
+import { AgentSession, FatalToolError, ResumeAuthorizationError, grantAnswer, withSystem } from "@junejs/core/agent-runtime";
+import { blobFileStore } from "@junejs/core/agent-files";
 import { connectAll } from "@junejs/core/connections";
 import { ensureScope, runInScope } from "@junejs/db";
 //#region src/agent-durable.ts
@@ -111,6 +112,7 @@ var AgentDurableObject = class {
 	authorizeAnswer;
 	onInputAnnouncement;
 	storage;
+	files;
 	announceFailures = 0;
 	resolveResources() {
 		return this.resourcesOpened ??= Promise.resolve(typeof this.resourcesInput === "function" ? this.resourcesInput(this.doEnv) : this.resourcesInput ?? {});
@@ -145,6 +147,11 @@ var AgentDurableObject = class {
 		this.onInputAnnouncement = def.onInputAnnouncement;
 		this.storage = state.storage;
 		const name = def.name ?? "agent";
+		this.files = def.files ?? blobFileStore(async () => {
+			const blob = (await this.resolveResources()).blob;
+			if (!blob) throw new FatalToolError(`agent "${name}": no file store — declare a blob resource (DoAgentDef.resources) or pass DoAgentDef.files`);
+			return blob;
+		});
 		const sink = new InProcEventSink();
 		sink.subscribe((e) => {
 			if (e.type === "turn.started") this.armWatchdog();
@@ -202,6 +209,7 @@ var AgentDurableObject = class {
 		if (key !== void 0 && key !== "self" && stored === void 0) this.store.setSessionKey(key);
 		this.sessionKey = resolved;
 		this.session = new AgentSession(this.name, resolved, this.store, this.sink, this.model, this.tools, crossDoUnsupported, this.channelInstructions);
+		this.session.files = this.files;
 		this.session.onDequeue = (heldTurnId, held) => {
 			if (held.hostContext?.deliver && held.event) this.deliverHeld(this.session, heldTurnId, held.event);
 		};
@@ -260,7 +268,10 @@ var AgentDurableObject = class {
 			this.ready().then((resources) => runInScope({
 				resources,
 				services: this.services
-			}, () => channel.deliver(target, events, { session: this.sessionKey }))).catch(logRenderFailure).finally(() => {
+			}, () => channel.deliver(target, events, {
+				session: this.sessionKey,
+				files: this.files
+			}))).catch(logRenderFailure).finally(() => {
 				it.return?.();
 			});
 		} catch (err) {
@@ -355,7 +366,10 @@ var AgentDurableObject = class {
 					Promise.resolve().then(() => runInScope({
 						resources,
 						services: this.services
-					}, () => deliverChannel.deliver(target, events, { session: this.sessionKey }))).catch(logRenderFailure).finally(() => {
+					}, () => deliverChannel.deliver(target, events, {
+						session: this.sessionKey,
+						files: this.files
+					}))).catch(logRenderFailure).finally(() => {
 						it.return?.();
 					});
 				} catch (err) {
@@ -419,7 +433,10 @@ var AgentDurableObject = class {
 					Promise.resolve().then(() => runInScope({
 						resources,
 						services: this.services
-					}, () => resumeChannel.deliverResume(target, events, { session: this.sessionKey }))).catch(logRenderFailure).finally(() => {
+					}, () => resumeChannel.deliverResume(target, events, {
+						session: this.sessionKey,
+						files: this.files
+					}))).catch(logRenderFailure).finally(() => {
 						it.return?.();
 					});
 				} catch (err) {
@@ -612,6 +629,7 @@ function durableChannelSurface(getNamespace, opts) {
 		},
 		services: resolveServices(opts.services, opts.env, opts.agentName),
 		waitUntil: opts.waitUntil,
+		files: opts.files,
 		run: async (message, o) => {
 			const namespace = getNamespace();
 			if (!namespace) throw new Error("durableChannelSurface: no Durable Object namespace bound (env.AGENT)");

package/dist/agent-native.d.ts

@@ -1,6 +1,7 @@
 import { SyncSqlite } from "./sqlite-driver.js";
 import { AgentDefinition, ChannelContext } from "@junejs/core/agent-config";
 import { AgentSession, ChannelPolicy, InputAnnouncement, Model, Runtime, Tool } from "@junejs/core/agent-runtime";
+import { FileStore } from "@junejs/core/agent-files";
 //#region src/agent-native.d.ts
 export type AgentDef = {
   model: Model;
@@ -12,6 +13,7 @@ export type AgentDef = {
 export declare function toAgentDef(agent: AgentDefinition, model: Model): AgentDef;
 export type NativeRuntimeOptions = {
   maxSessions?: number;
+  files?: FileStore;
 };
 export declare class NativeRuntime implements Runtime {
   private actors;
@@ -19,11 +21,14 @@ export declare class NativeRuntime implements Runtime {
   private readonly db;
   private readonly announceRetry;
   private readonly maxSessions;
+  private closing;
+  readonly files: FileStore | undefined;
   constructor(agents: Record<string, AgentDef>, db: SyncSqlite, opts?: NativeRuntimeOptions);
   agentDef(name: string): AgentDef | undefined;
   session(agent: string, id: string): AgentSession;
   get sessionCount(): number;
   recoverAnnouncements(): void;
+  close(): Promise<void>;
   private evictIdle;
 }
 export declare function createNativeRuntime(agents: Record<string, AgentDef>, path?: string, opts?: NativeRuntimeOptions): Promise<NativeRuntime>;
@@ -32,20 +37,31 @@ export declare class MemoryRuntime implements Runtime {
   private stores;
   private readonly agents;
   private readonly announceRetry;
-  constructor(agents: Record<string, AgentDef>);
+  private closed;
+  readonly files: FileStore | undefined;
+  constructor(agents: Record<string, AgentDef>, opts?: {
+    files?: FileStore;
+  });
   agentDef(name: string): AgentDef | undefined;
   session(agent: string, id: string): AgentSession;
+  close(): Promise<void>;
 }
 export type AgentBackend = "native" | "memory" | "durable";
+export type InProcessRuntime = Runtime & {
+  close(): Promise<void>;
+  readonly files?: FileStore;
+};
 export declare function createAgentRuntime(agents: Record<string, AgentDef>, opts?: {
   backend?: AgentBackend;
   path?: string;
   maxSessions?: number;
-}): Promise<Runtime>;
+  files?: FileStore;
+}): Promise<InProcessRuntime>;
 export declare function mountAgent(agent: AgentDefinition, runtime: Runtime, opts?: {
   chatPath?: string;
   channels?: boolean;
   services?: unknown;
+  files?: FileStore;
 }): {
   surface: (req: Request) => Promise<Response | null>;
   fetch: (req: Request) => Promise<Response | null>;

package/dist/agent-native.js

@@ -93,6 +93,7 @@ var InProcEventSink = class {
 var AnnouncementRetry = class {
 	flush;
 	state = /* @__PURE__ */ new Map();
+	stopped = false;
 	constructor(flush) {
 		this.flush = flush;
 	}
@@ -102,6 +103,7 @@ var AnnouncementRetry = class {
 		this.state.delete(key);
 	}
 	failed(key, agent, id) {
+		if (this.stopped) return;
 		const s = this.state.get(key) ?? { failures: 0 };
 		this.state.set(key, s);
 		if (s.timer) return;
@@ -113,7 +115,13 @@ var AnnouncementRetry = class {
 		}, delay);
 		s.timer.unref?.();
 	}
+	stop() {
+		this.stopped = true;
+		for (const s of this.state.values()) if (s.timer) clearTimeout(s.timer);
+		this.state.clear();
+	}
 };
+const ownedDbs = /* @__PURE__ */ new WeakSet();
 function wireAnnouncements(session, def, retry) {
 	const hook = def.onInputAnnouncement;
 	if (hook) {
@@ -149,10 +157,13 @@ var NativeRuntime = class {
 		this.session(agent, id).flushAnnouncements();
 	});
 	maxSessions;
+	closing;
+	files;
 	constructor(agents, db, opts = {}) {
 		assertCoreRuntimeVersion("NativeRuntime");
 		this.agents = agents;
 		this.db = db;
+		this.files = opts.files;
 		const max = opts.maxSessions ?? 1e3;
 		if (!(Number.isInteger(max) && max >= 1) && max !== Infinity) throw new RangeError(`NativeRuntime: maxSessions must be an integer >= 1 (or Infinity for no cap), got ${max}`);
 		this.maxSessions = max;
@@ -164,6 +175,7 @@ var NativeRuntime = class {
 	session(agent, id) {
 		const key = `${agent}:${id}`;
 		const hit = this.actors.get(key);
+		if (!hit && this.closing) throw new Error(`NativeRuntime is closed: cannot open session "${key}"`);
 		if (hit) {
 			this.actors.delete(key);
 			this.actors.set(key, hit);
@@ -173,7 +185,9 @@ var NativeRuntime = class {
 		if (!def) throw new Error(`unknown agent: ${agent}`);
 		const model = def.instructions ? withSystem(def.model, def.instructions) : def.model;
 		const sink = new InProcEventSink();
-		const session = wireAnnouncements(new AgentSession(agent, id, new SqliteSessionStore(this.db, key), sink, model, def.tools, this, def.channelInstructions), def, this.announceRetry);
+		const built = new AgentSession(agent, id, new SqliteSessionStore(this.db, key), sink, model, def.tools, this, def.channelInstructions);
+		built.files = this.files;
+		const session = wireAnnouncements(built, def, this.announceRetry);
 		this.evictIdle();
 		this.actors.set(key, {
 			session,
@@ -191,6 +205,18 @@ var NativeRuntime = class {
 			if (first && this.agents[first.agent]?.onInputAnnouncement) this.session(first.agent, first.session);
 		}
 	}
+	close() {
+		this.closing ??= (async () => {
+			this.announceRetry.stop();
+			while ([...this.actors.values()].some((a) => !a.session.idle())) await new Promise((r) => setTimeout(r, 10));
+			this.actors.clear();
+			if (ownedDbs.has(this.db)) {
+				ownedDbs.delete(this.db);
+				this.db.close();
+			}
+		})();
+		return this.closing;
+	}
 	evictIdle() {
 		if (this.actors.size < this.maxSessions) return;
 		for (const [key, a] of this.actors) {
@@ -200,9 +226,21 @@ var NativeRuntime = class {
 	}
 };
 async function createNativeRuntime(agents, path = ":memory:", opts = {}) {
-	const runtime = new NativeRuntime(agents, await openLocalSqliteSync(path), opts);
-	runtime.recoverAnnouncements();
-	return runtime;
+	const db = await openLocalSqliteSync(path);
+	ownedDbs.add(db);
+	let runtime;
+	try {
+		runtime = new NativeRuntime(agents, db, opts);
+		runtime.recoverAnnouncements();
+		return runtime;
+	} catch (err) {
+		if (runtime) await runtime.close();
+		else {
+			ownedDbs.delete(db);
+			db.close();
+		}
+		throw err;
+	}
 }
 var MemorySessionStore = class {
 	msgs = [];
@@ -259,9 +297,12 @@ var MemoryRuntime = class {
 	announceRetry = new AnnouncementRetry((agent, id) => {
 		this.session(agent, id).flushAnnouncements();
 	});
-	constructor(agents) {
+	closed = false;
+	files;
+	constructor(agents, opts = {}) {
 		assertCoreRuntimeVersion("MemoryRuntime");
 		this.agents = agents;
+		this.files = opts.files;
 	}
 	agentDef(name) {
 		return this.agents[name];
@@ -270,21 +311,33 @@ var MemoryRuntime = class {
 		const key = `${agent}:${id}`;
 		let a = this.actors.get(key);
 		if (!a) {
+			if (this.closed) throw new Error(`MemoryRuntime is closed: cannot open session "${key}"`);
 			const def = this.agents[agent];
 			if (!def) throw new Error(`unknown agent: ${agent}`);
 			const store = new MemorySessionStore();
 			this.stores.set(key, store);
 			const model = def.instructions ? withSystem(def.model, def.instructions) : def.model;
-			a = wireAnnouncements(new AgentSession(agent, id, store, new InProcEventSink(), model, def.tools, this, def.channelInstructions), def, this.announceRetry);
+			const built = new AgentSession(agent, id, store, new InProcEventSink(), model, def.tools, this, def.channelInstructions);
+			built.files = this.files;
+			a = wireAnnouncements(built, def, this.announceRetry);
 			this.actors.set(key, a);
 		}
 		return a;
 	}
+	async close() {
+		this.closed = true;
+		this.announceRetry.stop();
+		this.actors.clear();
+		this.stores.clear();
+	}
 };
 async function createAgentRuntime(agents, opts = {}) {
 	const backend = opts.backend ?? "native";
-	if (backend === "memory") return new MemoryRuntime(agents);
-	if (backend === "native") return createNativeRuntime(agents, opts.path, { maxSessions: opts.maxSessions });
+	if (backend === "memory") return new MemoryRuntime(agents, { files: opts.files });
+	if (backend === "native") return createNativeRuntime(agents, opts.path, {
+		maxSessions: opts.maxSessions,
+		files: opts.files
+	});
 	throw new Error("backend 'durable' is the Cloudflare Durable Object target — construct AgentDurableObject in your worker, not via createAgentRuntime");
 }
 function warnOnDrift(agent, runtime) {
@@ -304,6 +357,7 @@ function mountAgent(agent, runtime, opts = {}) {
 	const ctx = {
 		agent,
 		services: opts.services,
+		files: opts.files ?? runtime.files,
 		run: (message, o) => runtime.session(agent.name, o?.session ?? "default").turn({
 			turnId: o?.turnId,
 			userText: message,

package/dist/app.d.ts

@@ -9,6 +9,7 @@ export type JuneApp = {
   warmup(): Promise<void>;
   routePaths(): Promise<string[]>;
   earlyHints(): string[];
+  close(): Promise<void>;
 };
 export declare function createApp({ appDir: appDirInput, config }: CreateAppOptions): JuneApp;
 //#endregion

package/dist/app.js

@@ -1,9 +1,11 @@
 import { discoverAgent } from "./agent-discover.js";
 import { createAgentRuntime, mountAgent, toAgentDef } from "./agent-native.js";
 import { findMiddlewareFile, isResourceFile, listRoutes, matchRouteTree, resolveNotFound, routeFiles } from "./router.js";
+import { routeProblems, scanRoutes } from "./route-scan.js";
 import { createPipeline } from "./pipeline.js";
 import { resolveBoundary } from "./segment.js";
 import { memoizeResources } from "./resources.js";
+import { localBlob } from "./blob.js";
 import { MODULE_STYLES_URL, buildModuleCss, registerCssModules } from "./css-modules.js";
 import { CLIENT_SCRIPT_URL, bundleClientSplit, findClientEntry } from "./client-bundle.js";
 import { generateIslandRegistry } from "./island-registry.js";
@@ -14,6 +16,7 @@ import { existsSync, lstatSync, realpathSync } from "node:fs";
 import { readFile } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
+import { blobFileStore, memoryFileStore } from "@junejs/core/agent-files";
 import { routeFromModule } from "@junejs/core/route";
 import { deployOrigin, resolveAgent, resolveClientRouter, resolveSpeculationRules } from "@junejs/core/config";
 import { runWithTrace } from "@junejs/core/instrumentation";
@@ -115,6 +118,7 @@ function createApp({ appDir: appDirInput, config = {} }) {
 	config.dataLayer?.install();
 	let pipelinePromise;
 	const getPipeline = () => pipelinePromise ??= buildPipeline();
+	let agentRuntime;
 	async function buildPipeline() {
 		const { maps, css } = await getModuleCss();
 		await registerCssModules(maps);
@@ -137,7 +141,13 @@ function createApp({ appDir: appDirInput, config = {} }) {
 			const def = await discoverAgent(agentDir);
 			const backend = agent.runtime.backend === "durable" ? "native" : agent.runtime.backend;
 			const model = anthropic({ model: def.model });
-			const rt = await createAgentRuntime({ [def.name]: toAgentDef(def, model) }, { backend });
+			let blobOpened;
+			const files = backend === "memory" ? memoryFileStore() : blobFileStore(() => blobOpened ??= resources().then(async (r) => r.blob ?? await localBlob().open()));
+			const rt = await createAgentRuntime({ [def.name]: toAgentDef(def, model) }, {
+				backend,
+				files
+			});
+			agentRuntime = rt;
 			const mounted = mountAgent(def, rt, {
 				chatPath: agent.runtime.chat.path,
 				channels: agent.runtime.channels
@@ -257,6 +267,8 @@ function createApp({ appDir: appDirInput, config = {} }) {
 			return toPipeline();
 		},
 		async warmup() {
+			const problems = routeProblems([await scanRoutes(appDir), hasJuneRoutes ? await scanRoutes(juneRoutesDir) : []], dirname(appDir));
+			if (problems) console.error(problems);
 			const files = await routeFiles(appDir, { pageConvention: true });
 			if (hasJuneRoutes) files.push(...await routeFiles(juneRoutesDir, { pageConvention: true }));
 			for (const file of files) await import(pathToFileURL(file).href).catch((err) => {
@@ -264,7 +276,11 @@ function createApp({ appDir: appDirInput, config = {} }) {
 			});
 		},
 		routePaths,
-		earlyHints: () => config.earlyHints ?? []
+		earlyHints: () => config.earlyHints ?? [],
+		async close() {
+			await pipelinePromise?.catch(() => {});
+			await agentRuntime?.close();
+		}
 	};
 }
 //#endregion

package/dist/build.d.ts

@@ -1,7 +1,7 @@
-import { n as scanAppRoutes, r as scanRoutes, t as RouteEntry } from "./route-scan-DMlwoESy.js";
+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-ZWC_Qd4h.js";
-import { n as buildManifest } from "./manifest-DSNX4I-G.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
 export type BuildResult = {
   outFile: string;

package/dist/build.js

@@ -1,6 +1,7 @@
 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 { bundleClientToFile, findClientEntry } from "./client-bundle.js";
@@ -12,7 +13,6 @@ 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 { scanAppRoutes, scanRoutes } from "./route-scan.js";
 import { buildManifest, importLayout } from "./manifest.js";
 import { buildRsc, findRscRoutes } from "./rsc-build.js";
 import { existsSync, lstatSync } from "node:fs";
@@ -154,6 +154,8 @@ 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))};`);
@@ -224,7 +226,7 @@ ${statics.join("\n")}
   },
   dynamicRoutes: [
 ${dynamics.join("\n")}
-  ],${resourceRoutesField}
+  ],${resourceRoutesField}${generatedRoutesField}
   layoutChains: {
 ${chains.join("\n")}
   },${layoutBoundariesField}

package/dist/{config-freeze-ZWC_Qd4h.d.ts → config-freeze-CyXvNqi2.d.ts}

@@ -1,5 +1,5 @@
 import { i as JuneAdapter } from "./adapter-DcZ-W1-7.js";
-import { n as WorkerManifest } from "./worker-Dv4l6Ybs.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

package/dist/config-freeze.d.ts

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

package/dist/core-version.js

@@ -1,6 +1,6 @@
 import * as coreRuntime from "@junejs/core/agent-runtime";
 //#region src/core-version.ts
-const EXPECTED_CORE_RUNTIME_API = 6;
+const EXPECTED_CORE_RUNTIME_API = 7;
 function assertCoreRuntimeVersion(surface) {
 	checkCoreRuntimeVersion(surface, coreRuntime.RUNTIME_API_VERSION);
 }

package/dist/dev.d.ts

@@ -3,10 +3,14 @@ import { JuneHost, ServeHandle } from "./host.js";
 export type DevServerOptions = {
   appDir: string;
   port?: number;
+  hostname?: string;
   host?: JuneHost;
 };
-export type DevServer = ServeHandle & {
+export declare function devUrl(hostname: string, port: number): string;
+export declare function devAllowedHosts(configured: readonly string[] | undefined, hostname: string): string[];
+export type DevServer = Omit<ServeHandle, "stop"> & {
   url: string;
+  stop(force?: boolean): Promise<void>;
 };
-export declare function startDevServer({ appDir, port, host }: DevServerOptions): Promise<DevServer>;
+export declare function startDevServer({ appDir, port, hostname, host }: DevServerOptions): Promise<DevServer>;
 //#endregion

package/dist/dev.js

@@ -9,17 +9,42 @@ import { watch } from "node:fs";
 import { dirname } from "node:path";
 import { createServer } from "node:net";
 //#region src/dev.ts
-async function findFreePort(start, tries = 20) {
+function devUrl(hostname, port) {
+	if ([
+		"127.0.0.1",
+		"0.0.0.0",
+		"::",
+		"localhost"
+	].includes(hostname)) return `http://localhost:${port}`;
+	return `http://${hostname.includes(":") ? `[${hostname}]` : hostname}:${port}`;
+}
+function devAllowedHosts(configured, hostname) {
+	const hosts = /* @__PURE__ */ new Set([
+		"localhost",
+		".localhost",
+		...configured ?? []
+	]);
+	if (!/^[\d.]+$|:/.test(hostname)) hosts.add(hostname.toLowerCase());
+	return [...hosts];
+}
+async function findFreePort(start, hostname, tries = 20) {
 	for (let p = start; p < start + tries; p++) if (await new Promise((resolve) => {
 		const probe = createServer();
 		probe.once("error", () => resolve(false));
-		probe.listen(p, () => probe.close(() => resolve(true)));
+		probe.listen(p, hostname, () => probe.close(() => resolve(true)));
 	})) return p;
 	throw new Error(`june dev: no free port between ${start} and ${start + tries - 1}`);
 }
-async function startDevServer({ appDir, port = 3e3, host: host$1 = host }) {
+async function startDevServer({ appDir, port = 3e3, hostname = "127.0.0.1", host: host$1 = host }) {
 	await installAsyncContext();
-	const config = await loadJuneConfig(appDir);
+	const loaded = await loadJuneConfig(appDir);
+	const config = {
+		...loaded,
+		agent: {
+			...loaded.agent,
+			allowedHosts: devAllowedHosts(loaded.agent?.allowedHosts, hostname)
+		}
+	};
 	const m = await migrateApp(dirname(appDir), config);
 	if (m?.applied.length) console.log(`[june] migrated: ${m.applied.join(", ")}`);
 	if (m?.blocked) console.warn(`[june] ${blockedMessage(m.blocked)}`);
@@ -28,11 +53,12 @@ async function startDevServer({ appDir, port = 3e3, host: host$1 = host }) {
 		config
 	});
 	await app.warmup();
-	const freePort = await findFreePort(port);
+	const freePort = await findFreePort(port, hostname);
 	if (freePort !== port) console.log(`[june] port ${port} is taken → using ${freePort}`);
 	port = freePort;
 	const handle = host$1.serve(withLiveReload((req) => app.fetch(req)), {
 		port,
+		hostname,
 		earlyHints: () => app.earlyHints()
 	});
 	if (findGlobalCss(appDir)) {
@@ -44,12 +70,17 @@ async function startDevServer({ appDir, port = 3e3, host: host$1 = host }) {
 		});
 		processCssCached(appDir).catch(() => {});
 	}
-	const url = `http://localhost:${handle.port}`;
-	console.log(`june dev → ${url}  (host: ${host$1.name})`);
+	const url = devUrl(hostname, handle.port);
+	const lan = hostname === "127.0.0.1" ? "" : `  · listening on ${hostname}`;
+	console.log(`june dev → ${url}  (host: ${host$1.name})${lan}`);
 	return {
 		...handle,
-		url
+		url,
+		async stop(force) {
+			handle.stop(force);
+			await app.close();
+		}
 	};
 }
 //#endregion
-export { startDevServer };
+export { devAllowedHosts, devUrl, startDevServer };

package/dist/host.d.ts

@@ -13,6 +13,7 @@ export interface JuneHost {
   readonly name: "bun" | "node";
   serve(handler: (req: Request) => Promise<Response>, opts: {
     port: number;
+    hostname?: string;
     earlyHints?: () => string[];
   }): ServeHandle;
   spawnModule(entry: string, args: string[], opts: {

package/dist/host.js

@@ -9,6 +9,7 @@ function bunHost() {
 		serve(handler, opts) {
 			const server = Bun.serve({
 				port: opts.port,
+				hostname: opts.hostname,
 				fetch: handler,
 				idleTimeout: 0
 			});
@@ -64,7 +65,7 @@ function nodeHost() {
 					res.end("Internal Server Error");
 				}
 			});
-			server.listen(opts.port);
+			server.listen(opts.port, opts.hostname);
 			return {
 				get port() {
 					const addr = server.address();

package/dist/index.d.ts

@@ -2,12 +2,12 @@ import { a as ResourcePlan, c as staticSite, i as JuneAdapter, l as vercel, n as
 import { AGENT_MODULE_FILE, AgentDirScan, emitAgentModule, findAgentDir, generateAgentModule, scanAgentDir } from "./agent-compile.js";
 import { CreateAppOptions, JuneApp, createApp } from "./app.js";
 import { R2Bucket, localBlob, r2 } from "./blob.js";
-import { r as scanRoutes } from "./route-scan-DMlwoESy.js";
+import { o as scanRoutes } from "./route-scan-BMbBzPIB.js";
 import { t as generateContent } from "./content-freeze-CyiW2fRK.js";
 import { a as Pipeline, d as createPipeline, n as LayoutComponent, o as PipelineConfig, s as Resolved, u as RouteResolver } from "./pipeline-BHUjBO0G.js";
-import { n as WorkerManifest, r as createWorker } from "./worker-Dv4l6Ybs.js";
-import { t as freezeConfig } from "./config-freeze-ZWC_Qd4h.js";
-import { n as buildManifest } from "./manifest-DSNX4I-G.js";
+import { n as WorkerManifest, r as createWorker } from "./worker-2qbQjj2c.js";
+import { t as freezeConfig } from "./config-freeze-CyXvNqi2.js";
+import { n as buildManifest } from "./manifest-CwTT1zVs.js";
 import { BuildResult, juneBuild } from "./build.js";
 import { loadJuneConfig } from "./config-loader.js";
 import { AccountTokenStore, BetterAuthLike, ConnectionAuth, LinkedAccountAuthOptions, betterAuthAccessToken, betterAuthAccountTokenStore, linkedAccountAuth } from "./connection-auth.js";

package/dist/index.js

@@ -1,18 +1,18 @@
 import { deno, staticSite, vercel, workers } from "./adapter.js";
 import { AGENT_MODULE_FILE, emitAgentModule, findAgentDir, generateAgentModule, scanAgentDir } from "./agent-compile.js";
 import { listRoutes, matchRoute, matchRouteTree, resolveNotFound } from "./router.js";
+import { scanRoutes } from "./route-scan.js";
 import { negotiate } from "./negotiate.js";
 import { createPipeline } from "./pipeline.js";
 import { d1 } from "./d1.js";
 import { bindWorkerResources, memoizeResources } from "./resources.js";
-import { createApp } from "./app.js";
 import { localBlob, r2 } from "./blob.js";
+import { createApp } from "./app.js";
 import { loadJuneConfig } from "./config-loader.js";
 import { freezeConfig } from "./config-freeze.js";
 import { collection, entry } from "./content.js";
 import { generateContent } from "./content-freeze.js";
 import { createWorker } from "./worker.js";
-import { scanRoutes } from "./route-scan.js";
 import { buildManifest } from "./manifest.js";
 import { juneBuild } from "./build.js";
 import { betterAuthAccessToken, betterAuthAccountTokenStore, linkedAccountAuth } from "./connection-auth.js";

package/dist/{manifest-DSNX4I-G.d.ts → manifest-CwTT1zVs.d.ts}

@@ -1,5 +1,5 @@
 import { n as LayoutComponent } from "./pipeline-BHUjBO0G.js";
-import { n as WorkerManifest } from "./worker-Dv4l6Ybs.js";
+import { n as WorkerManifest } from "./worker-2qbQjj2c.js";
 //#region src/manifest.d.ts
 type ImportedLayout = {
   component: LayoutComponent;

package/dist/manifest.d.ts

@@ -1,2 +1,2 @@
-import { n as buildManifest, r as importLayout, t as ImportedLayout } from "./manifest-DSNX4I-G.js";
+import { n as buildManifest, r as importLayout, t as ImportedLayout } from "./manifest-CwTT1zVs.js";
 export { ImportedLayout, buildManifest, importLayout };