devframe 0.9.0-beta.8 → 0.9.0

package/dist/{rpc-core-C8JQ3p7A.d.mts → rpc-core-Cc4lucI0.d.mts}

@@ -1,6 +1,6 @@
-import { J as DevframeRpcServerFunctions, g as DevframeNodeContext, q as DevframeRpcClientFunctions, u as DevframeAuthHandler, z as DevframeNodeRpcSession } from "./devframe-Cfx6doi4.mjs";
+import { K as DevframeRpcClientFunctions, R as DevframeNodeRpcSession, g as DevframeNodeContext, q as DevframeRpcServerFunctions, u as DevframeAuthHandler } from "./devframe-DJMg0WLe.mjs";
 import { d as DevframeRpcConnection, u as DevframeNodeRpcSessionMeta } from "./ws-server-D1d3QM9f.mjs";
-import "./index-MYi1SZVL.mjs";
+import "./index-CB-fSUyn.mjs";
 import { BirpcGroup, EventOptions } from "birpc";
 //#region src/node/rpc-core.d.ts
 interface CreateContextRpcServerOptions {

package/dist/{rpc-core-IhcWl_xn.mjs → rpc-core-DMTe-hLo.mjs}

@@ -1,6 +1,6 @@
 import { n as __exportAll } from "./rolldown-runtime-JspESFgx.mjs";
 import { createRpcServer } from "./rpc/server.mjs";
-import { t as diagnostics } from "./diagnostics-DEuH3P5O.mjs";
+import { t as diagnostics } from "./diagnostics-DOQPnQmX.mjs";
 import { AsyncLocalStorage } from "node:async_hooks";
 //#region src/node/rpc-core.ts
 var rpc_core_exports = /* @__PURE__ */ __exportAll({ createContextRpcServer: () => createContextRpcServer });

package/dist/{serialization-BHY8M5NQ.mjs → serialization-BGzEwAdr.mjs}

@@ -1,4 +1,4 @@
-import { t as diagnostics } from "./diagnostics-hwjXp_UV.mjs";
+import { t as diagnostics } from "./diagnostics-CD8nlgll.mjs";
 //#region src/rpc/serialization.ts
 /**
 * Wire format used by the live RPC transports (WebSocket and SSE).

package/dist/{static-CvjkO8QE.mjs → static-BPZ1_OPA.mjs}

@@ -1,5 +1,5 @@
-import { n as validateDefinitions, r as getRpcHandler, s as hash } from "./validation-BiuDXTKW.mjs";
-import { t as diagnostics } from "./diagnostics-hwjXp_UV.mjs";
+import { n as validateDefinitions, r as getRpcHandler, s as hash } from "./validation-CpXFB6Dz.mjs";
+import { t as diagnostics } from "./diagnostics-CD8nlgll.mjs";
 import { DEVFRAME_RPC_DUMP_DIRNAME } from "./constants.mjs";
 //#region ../../node_modules/.pnpm/yocto-queue@1.2.2/node_modules/yocto-queue/index.js
 var Node = class {

package/dist/{storage-BVuipbGS.mjs → storage-CYye7P7L.mjs}

@@ -1,4 +1,4 @@
-import { t as diagnostics } from "./diagnostics-DEuH3P5O.mjs";
+import { t as diagnostics } from "./diagnostics-DOQPnQmX.mjs";
 import { createSharedState } from "devframe/utils/shared-state";
 import fs from "node:fs";
 import { dirname } from "pathe";

package/dist/types/index.d.mts

@@ -1,5 +1,6 @@
-import { A as ScopedServerFunctions, B as RpcBroadcastOptions, C as DevframeScopedStreamingHost, Ct as AgentToolProviderHandle, D as ScopedBroadcastOptions, Dt as EventUnsubscribe, E as DevframeSettingsStore, Et as EventEmitter, F as DevframeStorageScope, G as RpcStreamingChannelOptions, H as RpcSharedStateGetOptions, I as DevframeDefineDiagnosticsOptions, J as DevframeRpcServerFunctions, K as RpcStreamingHost, L as DevframeDiagnosticsHost, M as SettingsForNamespace, N as DevframeViewHost, O as ScopedClientFunctions, Ot as EventsMap, P as DevframeHost, R as DevframeDiagnosticsLogger, S as DevframeScopedNodeRpc, St as AgentToolProvider, T as DevframeSettingsRegistry, Tt as DevframeAgentHostEvents, U as RpcSharedStateHost, V as RpcFunctionsHost, W as RpcStreamingChannel, Y as DevframeRpcSharedStates, _ as DevframeServiceId, _t as AgentResource, a as DevframeDuplicationStrategy, b as DevframeServicesRegistry, bt as AgentTool, c as DevframeWsOptions, d as ConnectionMeta, f as ConnectionMetaSse, g as DevframeNodeContext, gt as AgentManifest, h as DevframeConnectionConfigsRegistry, ht as AgentHandle, i as DevframeDockDefaults, j as ScopedSharedStates, k as ScopedRpcFn, l as McpRouteOptions, m as DevframeCapabilities, n as DevframeDefinition, o as DevframeSetupInfo, p as ConnectionMetaWebsocket, q as DevframeRpcClientFunctions, r as DevframeDeploymentKind, s as DevframeSseOptions, t as DevframeCliOptions, v as DevframeServiceOf, vt as AgentResourceContent, w as DevframeSettings, wt as DevframeAgentHost, x as DevframeScopedNodeContext, xt as AgentToolInput, y as DevframeServicesHost, yt as AgentResourceInput, z as DevframeNodeRpcSession } from "../devframe-Cfx6doi4.mjs";
+import { A as ScopedServerFunctions, B as RpcFunctionsHost, C as DevframeScopedStreamingHost, Ct as DevframeAgentHost, D as ScopedBroadcastOptions, Dt as EventsMap, E as DevframeSettingsStore, Et as EventUnsubscribe, F as DevframeStorageScope, G as RpcStreamingHost, H as RpcSharedStateHost, I as DevframeDiagnosticsHost, J as DevframeRpcSharedStates, K as DevframeRpcClientFunctions, L as DevframeDiagnosticsLogger, M as SettingsForNamespace, N as DevframeViewHost, O as ScopedClientFunctions, P as DevframeHost, R as DevframeNodeRpcSession, S as DevframeScopedNodeRpc, St as AgentToolProviderHandle, T as DevframeSettingsRegistry, Tt as EventEmitter, U as RpcStreamingChannel, V as RpcSharedStateGetOptions, W as RpcStreamingChannelOptions, _ as DevframeServiceId, _t as AgentResourceContent, a as DevframeDuplicationStrategy, b as DevframeServicesRegistry, bt as AgentToolInput, c as DevframeWsOptions, d as ConnectionMeta, f as ConnectionMetaSse, g as DevframeNodeContext, gt as AgentResource, h as DevframeConnectionConfigsRegistry, ht as AgentManifest, i as DevframeDockDefaults, j as ScopedSharedStates, k as ScopedRpcFn, l as McpRouteOptions, m as DevframeCapabilities, mt as AgentHandle, n as DevframeDefinition, o as DevframeSetupInfo, p as ConnectionMetaWebsocket, q as DevframeRpcServerFunctions, r as DevframeDeploymentKind, s as DevframeSseOptions, t as DevframeCliOptions, v as DevframeServiceOf, vt as AgentResourceInput, w as DevframeSettings, wt as DevframeAgentHostEvents, x as DevframeScopedNodeContext, xt as AgentToolProvider, y as DevframeServicesHost, yt as AgentTool, z as RpcBroadcastOptions } from "../devframe-DJMg0WLe.mjs";
 import { g as RpcFunctionAgentOptions } from "../types-Djq7CBXh.mjs";
 import { d as DevframeRpcConnection, f as DevframeRpcConnectionRequest, p as DevframeRpcTransportKind, u as DevframeNodeRpcSessionMeta } from "../ws-server-D1d3QM9f.mjs";
-import { a as StaticAssetsSource, i as RemoteAssetsStore, n as RemoteAssetsProvider, r as RemoteAssetsProviderCustom, t as RemoteAssets } from "../remote-assets-DclsYyoL.mjs";
-export { AgentHandle, AgentManifest, AgentResource, AgentResourceContent, AgentResourceInput, AgentTool, AgentToolInput, AgentToolProvider, AgentToolProviderHandle, ConnectionMeta, ConnectionMetaSse, ConnectionMetaWebsocket, DevframeAgentHost, DevframeAgentHostEvents, DevframeCapabilities, DevframeCliOptions, DevframeConnectionConfigsRegistry, DevframeDefineDiagnosticsOptions, DevframeDefinition, DevframeDeploymentKind, DevframeDiagnosticsHost, DevframeDiagnosticsLogger, DevframeDockDefaults, DevframeDuplicationStrategy, DevframeHost, DevframeNodeContext, DevframeNodeRpcSession, type DevframeNodeRpcSessionMeta, DevframeRpcClientFunctions, type DevframeRpcConnection, type DevframeRpcConnectionRequest, DevframeRpcServerFunctions, DevframeRpcSharedStates, type DevframeRpcTransportKind, DevframeScopedNodeContext, DevframeScopedNodeRpc, DevframeScopedStreamingHost, DevframeServiceId, DevframeServiceOf, DevframeServicesHost, DevframeServicesRegistry, DevframeSettings, DevframeSettingsRegistry, DevframeSettingsStore, DevframeSetupInfo, DevframeSseOptions, DevframeStorageScope, DevframeViewHost, DevframeWsOptions, EventEmitter, EventUnsubscribe, EventsMap, McpRouteOptions, RemoteAssets, RemoteAssetsProvider, RemoteAssetsProviderCustom, RemoteAssetsStore, RpcBroadcastOptions, type RpcFunctionAgentOptions, RpcFunctionsHost, RpcSharedStateGetOptions, RpcSharedStateHost, RpcStreamingChannel, RpcStreamingChannelOptions, RpcStreamingHost, ScopedBroadcastOptions, ScopedClientFunctions, ScopedRpcFn, ScopedServerFunctions, ScopedSharedStates, SettingsForNamespace, StaticAssetsSource };
+import { i as DevframeDefineDiagnosticsOptions } from "../nostics-SPGDgHEP.mjs";
+import { a as RemoteAssetsStore, i as RemoteAssetsProviderCustom, n as RemoteAssetsErrorMessage, o as StaticAssetsSource, r as RemoteAssetsProvider, t as RemoteAssets } from "../remote-assets-Bg4gCUZ_.mjs";
+export { AgentHandle, AgentManifest, AgentResource, AgentResourceContent, AgentResourceInput, AgentTool, AgentToolInput, AgentToolProvider, AgentToolProviderHandle, ConnectionMeta, ConnectionMetaSse, ConnectionMetaWebsocket, DevframeAgentHost, DevframeAgentHostEvents, DevframeCapabilities, DevframeCliOptions, DevframeConnectionConfigsRegistry, type DevframeDefineDiagnosticsOptions, DevframeDefinition, DevframeDeploymentKind, DevframeDiagnosticsHost, DevframeDiagnosticsLogger, DevframeDockDefaults, DevframeDuplicationStrategy, DevframeHost, DevframeNodeContext, DevframeNodeRpcSession, type DevframeNodeRpcSessionMeta, DevframeRpcClientFunctions, type DevframeRpcConnection, type DevframeRpcConnectionRequest, DevframeRpcServerFunctions, DevframeRpcSharedStates, type DevframeRpcTransportKind, DevframeScopedNodeContext, DevframeScopedNodeRpc, DevframeScopedStreamingHost, DevframeServiceId, DevframeServiceOf, DevframeServicesHost, DevframeServicesRegistry, DevframeSettings, DevframeSettingsRegistry, DevframeSettingsStore, DevframeSetupInfo, DevframeSseOptions, DevframeStorageScope, DevframeViewHost, DevframeWsOptions, EventEmitter, EventUnsubscribe, EventsMap, McpRouteOptions, RemoteAssets, RemoteAssetsErrorMessage, RemoteAssetsProvider, RemoteAssetsProviderCustom, RemoteAssetsStore, RpcBroadcastOptions, type RpcFunctionAgentOptions, RpcFunctionsHost, RpcSharedStateGetOptions, RpcSharedStateHost, RpcStreamingChannel, RpcStreamingChannelOptions, RpcStreamingHost, ScopedBroadcastOptions, ScopedClientFunctions, ScopedRpcFn, ScopedServerFunctions, ScopedSharedStates, SettingsForNamespace, StaticAssetsSource };

package/dist/utils/events.d.mts

@@ -1,4 +1,4 @@
-import { Et as EventEmitter, Ot as EventsMap } from "../devframe-Cfx6doi4.mjs";
+import { Dt as EventsMap, Tt as EventEmitter } from "../devframe-DJMg0WLe.mjs";
 //#region src/utils/events.d.ts
 /**
  * Create event emitter.

package/dist/utils/get-port.d.mts

@@ -0,0 +1,17 @@
+//#region ../../node_modules/.pnpm/get-port-please@3.2.0/node_modules/get-port-please/dist/index.d.mts
+interface GetPortOptions {
+  name: string;
+  random: boolean;
+  port: number;
+  ports: number[];
+  portRange: [fromInclusive: number, toInclusive: number];
+  alternativePortRange: [fromInclusive: number, toInclusive: number];
+  host: string;
+  verbose?: boolean;
+  public?: boolean;
+}
+type GetPortInput = Partial<GetPortOptions> | number | string;
+type PortNumber = number;
+declare function getPort(_userOptions?: GetPortInput): Promise<PortNumber>;
+//#endregion
+export { type GetPortInput, type GetPortOptions, getPort };

package/dist/utils/get-port.mjs

@@ -0,0 +1,2 @@
+import { n as getPort } from "../dist-eNI9qM_I.mjs";
+export { getPort };

package/dist/utils/nostics.d.mts

@@ -0,0 +1,2 @@
+import { a as Diagnostic, c as DiagnosticHandle, d as Diagnostics, f as ansiFormatter, g as formatDiagnostic, h as defineProdDiagnostics, i as DevframeDefineDiagnosticsOptions, l as DiagnosticInit, m as defineDiagnostics, n as ConsoleMethod, o as DiagnosticCallParams, p as createConsoleReporter, r as ConsoleReporterOptions, s as DiagnosticDefinition, t as AnyDiagnosticReporter, u as DiagnosticReporter } from "../nostics-SPGDgHEP.mjs";
+export { type AnyDiagnosticReporter, type ConsoleMethod, type ConsoleReporterOptions, DevframeDefineDiagnosticsOptions, type Diagnostic, type DiagnosticCallParams, type DiagnosticDefinition, type DiagnosticHandle, type DiagnosticInit, type DiagnosticReporter, type Diagnostics, ansiFormatter, createConsoleReporter, defineDiagnostics, defineProdDiagnostics, formatDiagnostic };

package/dist/utils/nostics.mjs

@@ -0,0 +1,2 @@
+import { a as defineProdDiagnostics, i as defineDiagnostics, n as ansiFormatter, o as formatDiagnostic, r as createConsoleReporter, t as Diagnostic } from "../nostics-CzECRXpE.mjs";
+export { Diagnostic, ansiFormatter, createConsoleReporter, defineDiagnostics, defineProdDiagnostics, formatDiagnostic };

package/dist/utils/remote-assets.d.mts

@@ -1,4 +1,4 @@
-import { a as StaticAssetsSource, i as RemoteAssetsStore } from "../remote-assets-DclsYyoL.mjs";
+import { a as RemoteAssetsStore, o as StaticAssetsSource } from "../remote-assets-Bg4gCUZ_.mjs";
 //#region src/utils/remote-assets.d.ts
 /**
  * Normalize a {@link StaticAssetsSource} into something servable: a local

package/dist/utils/remote-assets.mjs

@@ -1,309 +1,2 @@
-import { t as diagnostics } from "../diagnostics-DEuH3P5O.mjs";
-import { createRequire } from "node:module";
-import { createReadStream, existsSync } from "node:fs";
-import { Buffer } from "node:buffer";
-import { mkdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
-import { Readable } from "node:stream";
-import { lookup } from "mrmime";
-import { dirname, extname, join, normalize, sep } from "pathe";
-//#region src/utils/remote-assets.ts
-const MANIFEST_FILENAME = ".manifest.json";
-/** Flatten a jsDelivr (`name`/`files`) or unpkg (`path`/`files`) file tree. */
-function flattenTree(nodes, style) {
-	const out = [];
-	const walk = (list, prefix) => {
-		for (const node of list) if (style === "path") if (node.type === "file") out.push((node.path ?? "").replace(/^\//, ""));
-		else walk(node.files ?? [], "");
-		else if (node.type === "file") out.push(prefix + (node.name ?? ""));
-		else if (node.files) walk(node.files, `${prefix}${node.name}/`);
-	};
-	walk(nodes, "");
-	return out;
-}
-const providers = {
-	jsdelivr: {
-		fileUrl: (pkg, version, filePath) => `https://cdn.jsdelivr.net/npm/${pkg}@${version}/${filePath}`,
-		listFiles: async (pkg, version, fetchImpl) => {
-			const res = await fetchImpl(`https://data.jsdelivr.com/v1/packages/npm/${pkg}@${version}`);
-			if (!res.ok) throw new Error(`HTTP ${res.status} from data.jsdelivr.com`);
-			return flattenTree((await res.json()).files ?? [], "name");
-		}
-	},
-	unpkg: {
-		fileUrl: (pkg, version, filePath) => `https://unpkg.com/${pkg}@${version}/${filePath}`,
-		listFiles: async (pkg, version, fetchImpl) => {
-			const res = await fetchImpl(`https://unpkg.com/${pkg}@${version}/?meta`);
-			if (!res.ok) throw new Error(`HTTP ${res.status} from unpkg.com`);
-			return flattenTree([await res.json()], "path");
-		}
-	}
-};
-function resolveProvider(assets) {
-	const p = assets.provider ?? "jsdelivr";
-	return typeof p === "string" ? {
-		provider: providers[p],
-		name: p
-	} : {
-		provider: p,
-		name: "custom"
-	};
-}
-/**
-* Resolve a locally installed copy of `assets.package` from
-* `assets.resolveFrom`'s dependency graph and return its assets directory,
-* or `undefined` when the package (or directory) is absent. A different
-* installed version warns (`DF0062`); a different major throws (`DF0061`).
-*/
-function resolveInstalled(assets) {
-	if (!assets.resolveFrom) return void 0;
-	let pkgJsonPath;
-	let installed;
-	try {
-		const requireFrom = createRequire(assets.resolveFrom);
-		pkgJsonPath = requireFrom.resolve(`${assets.package}/package.json`);
-		installed = requireFrom(`${assets.package}/package.json`).version;
-	} catch {
-		return;
-	}
-	if (typeof installed !== "string") return void 0;
-	if (installed !== assets.version) {
-		const major = (v) => v.trim().split(".")[0] ?? v;
-		if (major(installed) !== major(assets.version)) throw diagnostics.DF0061({
-			package: assets.package,
-			required: assets.version,
-			installed
-		});
-		diagnostics.DF0062({
-			package: assets.package,
-			required: assets.version,
-			installed
-		});
-	}
-	const dir = join(dirname(pkgJsonPath), assets.path ?? "dist");
-	return existsSync(dir) ? dir : void 0;
-}
-function contentTypeFor(filePath) {
-	const type = lookup(filePath);
-	if (!type) return "application/octet-stream";
-	return type === "text/html" ? "text/html; charset=utf-8" : type;
-}
-/** Clean a request path into a safe package-relative POSIX path, or `null` if it escapes root. */
-function cleanRequestPath(urlPath) {
-	let cleaned;
-	try {
-		cleaned = decodeURIComponent(urlPath || "/");
-	} catch {
-		return null;
-	}
-	cleaned = cleaned.replace(/[?#].*$/, "").replace(/^\/+|\/+$/g, "");
-	const normalized = normalize(cleaned);
-	if (normalized === ".." || normalized.startsWith(`..${sep}`) || normalized.startsWith("/")) return null;
-	return normalized === "." ? "" : normalized;
-}
-/** Candidate files for a request, in order: direct hit, index, `.html`, SPA fallback. */
-function candidatePaths(prefix, cleaned) {
-	const candidates = [];
-	if (cleaned) candidates.push(prefix + cleaned);
-	candidates.push(`${prefix}${cleaned ? `${cleaned}/` : ""}index.html`);
-	if (cleaned && !extname(cleaned)) candidates.push(`${prefix + cleaned}.html`);
-	if (!/\.[a-z0-9]+$/i.test(cleaned) && !candidates.includes(`${prefix}index.html`)) candidates.push(`${prefix}index.html`);
-	return candidates;
-}
-function createStore(assets, cacheDir) {
-	const normalized = {
-		...assets,
-		path: assets.path ?? "dist"
-	};
-	const { provider, name: providerName } = resolveProvider(assets);
-	const fetchImpl = assets.fetch ?? globalThis.fetch;
-	const prefix = `${normalized.path}/`;
-	let manifestPromise;
-	let manifestReported = false;
-	async function loadManifest() {
-		const manifestFile = join(cacheDir, MANIFEST_FILENAME);
-		try {
-			return new Set(JSON.parse(await readFile(manifestFile, "utf8")));
-		} catch {}
-		if (assets.offline || !provider.listFiles) return null;
-		try {
-			const files = await provider.listFiles(normalized.package, normalized.version, fetchImpl);
-			await mkdir(cacheDir, { recursive: true });
-			await writeFile(manifestFile, JSON.stringify(files), "utf8").catch(() => {});
-			return new Set(files);
-		} catch (error) {
-			if (!manifestReported) {
-				manifestReported = true;
-				diagnostics.DF0059({
-					package: normalized.package,
-					version: normalized.version,
-					provider: providerName,
-					reason: errText(error),
-					cause: error
-				});
-			}
-			return null;
-		}
-	}
-	async function serveCached(filePath) {
-		const abs = join(cacheDir, filePath);
-		let size;
-		try {
-			const s = await stat(abs);
-			if (!s.isFile()) return null;
-			size = s.size;
-		} catch {
-			return null;
-		}
-		return new Response(Readable.toWeb(createReadStream(abs)), { headers: {
-			"Content-Type": contentTypeFor(filePath),
-			"Content-Length": String(size),
-			"Cache-Control": "no-store"
-		} });
-	}
-	/** Persist `body` to the cache at `filePath` (tmp + rename); failures warn (`DF0063`). */
-	async function persist(filePath, body) {
-		const target = join(cacheDir, filePath);
-		const tmp = `${target}.${Math.random().toString(36).slice(2)}.tmp`;
-		try {
-			await mkdir(dirname(target), { recursive: true });
-			await writeFile(tmp, Buffer.from(await new Response(body).arrayBuffer()));
-			await rename(tmp, target);
-		} catch (error) {
-			await rm(tmp, { force: true }).catch(() => {});
-			diagnostics.DF0063({
-				filepath: target,
-				reason: errText(error),
-				cause: error
-			});
-		}
-	}
-	/** Fetch `filePath` through the provider: `null` on 404, a `Response` on 200, throws (`DF0060`) otherwise. */
-	async function serveRemote(filePath) {
-		const url = provider.fileUrl(normalized.package, normalized.version, filePath);
-		let res;
-		try {
-			res = await fetchImpl(url);
-		} catch (error) {
-			throw diagnostics.DF0060({
-				url,
-				package: normalized.package,
-				reason: errText(error),
-				cause: error
-			});
-		}
-		if (res.status === 404) {
-			await res.body?.cancel().catch(() => {});
-			return null;
-		}
-		if (!res.ok || !res.body) {
-			await res.body?.cancel().catch(() => {});
-			throw diagnostics.DF0060({
-				url,
-				package: normalized.package,
-				reason: `HTTP ${res.status}`
-			});
-		}
-		const [toClient, toCache] = res.body.tee();
-		persist(filePath, toCache);
-		const length = res.headers.get("content-length");
-		return new Response(toClient, { headers: {
-			"Content-Type": contentTypeFor(filePath),
-			"Cache-Control": "no-store",
-			...length ? { "Content-Length": length } : {}
-		} });
-	}
-	async function serve(urlPath) {
-		const cleaned = cleanRequestPath(urlPath);
-		if (cleaned === null) return null;
-		const candidates = candidatePaths(prefix, cleaned);
-		manifestPromise ??= loadManifest();
-		const manifest = await manifestPromise;
-		if (manifest) {
-			const filePath = candidates.find((c) => manifest.has(c));
-			if (!filePath) return null;
-			return await serveCached(filePath) ?? (assets.offline ? Promise.reject(diagnostics.DF0060({
-				url: filePath,
-				package: normalized.package,
-				reason: "offline: true and the file is not in the cache"
-			})) : serveRemote(filePath));
-		}
-		for (const candidate of candidates) {
-			const cached = await serveCached(candidate);
-			if (cached) return cached;
-		}
-		if (assets.offline) return null;
-		for (const candidate of candidates) {
-			const remote = await serveRemote(candidate);
-			if (remote) return remote;
-		}
-		return null;
-	}
-	async function materialize(targetDir) {
-		const fail = (reason, cause) => {
-			throw diagnostics.DF0064({
-				package: normalized.package,
-				version: normalized.version,
-				reason,
-				cause
-			});
-		};
-		if (!provider.listFiles) fail("the configured provider has no file listing (`listFiles`)");
-		let files;
-		try {
-			files = await provider.listFiles(normalized.package, normalized.version, fetchImpl);
-		} catch (error) {
-			return fail(errText(error), error);
-		}
-		for (const filePath of files.filter((f) => f.startsWith(prefix))) {
-			const target = join(targetDir, filePath.slice(prefix.length));
-			const url = provider.fileUrl(normalized.package, normalized.version, filePath);
-			let res;
-			try {
-				res = await fetchImpl(url);
-				if (!res.ok) throw new Error(`HTTP ${res.status}`);
-			} catch (error) {
-				return fail(`failed to download ${filePath}: ${errText(error)}`, error);
-			}
-			await mkdir(dirname(target), { recursive: true });
-			await writeFile(target, Buffer.from(await res.arrayBuffer()));
-		}
-	}
-	return {
-		assets: normalized,
-		serve,
-		materialize
-	};
-}
-function errText(error) {
-	return error instanceof Error ? error.message : String(error);
-}
-const PACKAGE_NAME_RE = /^(?:@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/;
-const VERSION_RE = /^\d+\.\d+\.\d+(?:-[a-z0-9-]+(?:\.[a-z0-9-]+)*)?(?:\+[a-z0-9-]+(?:\.[a-z0-9-]+)*)?$/i;
-/** Reject a {@link RemoteAssets} with an unsafe package name or version (`DF0065`). */
-function assertValidRemoteAssets(assets) {
-	if (assets.package.length > 214 || !PACKAGE_NAME_RE.test(assets.package)) throw diagnostics.DF0065({
-		field: "package",
-		value: assets.package
-	});
-	if (!VERSION_RE.test(assets.version)) throw diagnostics.DF0065({
-		field: "version",
-		value: assets.version
-	});
-}
-/**
-* Normalize a {@link StaticAssetsSource} into something servable: a local
-* directory (strings pass through; a remote source short-circuits to a
-* locally installed copy of its package when present) or a caching
-* {@link RemoteAssetsStore} back-proxy. Remote caches live under
-* `<projectStorageDir>/.remote-assets/<package>@<version>/`.
-*
-* A remote source's `package`/`version` are validated first (`DF0065`) — both
-* are interpolated into CDN URLs and the cache path.
-*/
-function resolveStaticAssetsSource(source, projectStorageDir) {
-	if (typeof source === "string") return source;
-	assertValidRemoteAssets(source);
-	return resolveInstalled(source) ?? createStore(source, join(projectStorageDir, ".remote-assets", `${source.package.replace(/\//g, "+")}@${source.version}`));
-}
-//#endregion
+import { t as resolveStaticAssetsSource } from "../remote-assets-nTTxY2MU.mjs";
 export { resolveStaticAssetsSource };

package/dist/utils/serve-static.d.mts

@@ -1,4 +1,4 @@
-import { i as RemoteAssetsStore } from "../remote-assets-DclsYyoL.mjs";
+import { a as RemoteAssetsStore } from "../remote-assets-Bg4gCUZ_.mjs";
 import { IncomingMessage, ServerResponse } from "node:http";
 import { EventHandler, H3 } from "h3";
 //#region src/utils/serve-static.d.ts

package/dist/utils/serve-static.mjs

@@ -1,3 +1,4 @@
+import { DEVFRAME_REMOTE_ASSETS_ERROR_MESSAGE_TYPE } from "../constants.mjs";
 import { createReadStream } from "node:fs";
 import { stat } from "node:fs/promises";
 import { Readable } from "node:stream";
@@ -220,11 +221,22 @@ function serveStaticNodeMiddleware(source, options) {
 /**
 * Minimal, dependency-free HTML shown when a remote-assets request cannot
 * be satisfied (no installed package, no cache, provider unreachable).
+*
+* The page stands on its own when a devframe is opened directly, and
+* announces itself over `postMessage` when it loads inside a viewer's iframe
+* ({@link DEVFRAME_REMOTE_ASSETS_ERROR_MESSAGE_TYPE}) so the viewer can show
+* the same failure in its own UI instead.
 */
 function remoteErrorPage(pkg, version, reason) {
 	const esc = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
 	const name = esc(pkg);
 	const ver = esc(version);
+	const payload = JSON.stringify({
+		type: DEVFRAME_REMOTE_ASSETS_ERROR_MESSAGE_TYPE,
+		package: pkg,
+		version,
+		reason
+	}).replace(/</g, "\\u003c");
 	return `<!doctype html>
 <html lang="en">
 <head>
@@ -254,6 +266,10 @@ function remoteErrorPage(pkg, version, reason) {
   <button onclick="location.reload()">Retry</button>
   <p class="muted">devframe remote assets</p>
 </main>
+<script>
+  if (window.parent !== window)
+    window.parent.postMessage(${payload}, '*')
+<\/script>
 </body>
 </html>
 `;

package/dist/utils/shared-state.d.mts

@@ -1,2 +1,2 @@
-import { at as Immutable, ct as ImmutableObject, dt as SharedStateEvents, ft as SharedStateOptions, lt as ImmutableSet, mt as createSharedState, ot as ImmutableArray, pt as SharedStatePatch, st as ImmutableMap, ut as SharedState } from "../devframe-Cfx6doi4.mjs";
+import { at as ImmutableArray, ct as ImmutableSet, dt as SharedStateOptions, ft as SharedStatePatch, it as Immutable, lt as SharedState, ot as ImmutableMap, pt as createSharedState, st as ImmutableObject, ut as SharedStateEvents } from "../devframe-DJMg0WLe.mjs";
 export { Immutable, ImmutableArray, ImmutableMap, ImmutableObject, ImmutableSet, SharedState, SharedStateEvents, SharedStateOptions, SharedStatePatch, createSharedState };

package/dist/utils/streaming-channel.d.mts

@@ -1,2 +1,2 @@
-import { $ as StreamErrorPayload, Q as CreateStreamSinkOptions, X as BufferedChunk, Z as CreateStreamReaderOptions, et as StreamReader, it as createStreamSink, nt as StreamSinkEvents, rt as createStreamReader, tt as StreamSink } from "../devframe-Cfx6doi4.mjs";
+import { $ as StreamReader, Q as StreamErrorPayload, X as CreateStreamReaderOptions, Y as BufferedChunk, Z as CreateStreamSinkOptions, et as StreamSink, nt as createStreamReader, rt as createStreamSink, tt as StreamSinkEvents } from "../devframe-DJMg0WLe.mjs";
 export { BufferedChunk, CreateStreamReaderOptions, CreateStreamSinkOptions, StreamErrorPayload, StreamReader, StreamSink, StreamSinkEvents, createStreamReader, createStreamSink };

package/dist/{validation-BiuDXTKW.mjs → validation-CpXFB6Dz.mjs}

@@ -1,4 +1,4 @@
-import { t as diagnostics } from "./diagnostics-hwjXp_UV.mjs";
+import { t as diagnostics } from "./diagnostics-CD8nlgll.mjs";
 import { createHash } from "node:crypto";
 //#region ../../node_modules/.pnpm/ohash@2.0.11/node_modules/ohash/dist/shared/ohash.D__AXeF1.mjs
 function serialize(o) {

package/dist/{wire-codec-9VhIKnyp.mjs → wire-codec-0K-o5MYW.mjs}

@@ -1,4 +1,4 @@
-import { n as strictJsonStringify } from "./serialization-BHY8M5NQ.mjs";
+import { n as strictJsonStringify } from "./serialization-BGzEwAdr.mjs";
 import { n as structuredCloneStringify, t as structuredCloneParse } from "./structured-clone-CbAV5rFI.mjs";
 //#region src/rpc/wire-codec.ts
 const EMPTY_WIRE_DEFS = /* @__PURE__ */ new Map();
@@ -12,7 +12,6 @@ const EMPTY_WIRE_DEFS = /* @__PURE__ */ new Map();
 * don't collide across connections.
 *
 * @internal
-* implementations; not part of the stable public API.
 */
 function createRpcWireCodec(definitions = EMPTY_WIRE_DEFS) {
 	const pendingRequestMethods = /* @__PURE__ */ new Map();
@@ -41,7 +40,6 @@ function createRpcWireCodec(definitions = EMPTY_WIRE_DEFS) {
 * handed to birpc proper.
 *
 * @internal
-* implementations; not part of the stable public API.
 */
 function peekRpcWireFrame(raw) {
 	try {

package/dist/{ws-server-Bk1hOG3X.mjs → ws-server-BdSLrhxE.mjs}

@@ -1,5 +1,5 @@
 import "./constants.mjs";
-import { t as createRpcWireCodec } from "./wire-codec-9VhIKnyp.mjs";
+import { t as createRpcWireCodec } from "./wire-codec-0K-o5MYW.mjs";
 import { n as randomToken, r as timingSafeEqual } from "./crypto-token-XCqTSMg9.mjs";
 import { createServer } from "node:http";
 import { createServer as createServer$1 } from "node:https";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "devframe",
   "type": "module",
-  "version": "0.9.0-beta.8",
+  "version": "0.9.0",
   "description": "Framework for building one portable devtool integration that runs in any viewer.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -48,9 +48,11 @@
     "./utils/colors": "./dist/utils/colors.mjs",
     "./utils/crypto-token": "./dist/utils/crypto-token.mjs",
     "./utils/events": "./dist/utils/events.mjs",
+    "./utils/get-port": "./dist/utils/get-port.mjs",
     "./utils/hash": "./dist/utils/hash.mjs",
     "./utils/launch-editor": "./dist/utils/launch-editor.mjs",
     "./utils/nanoid": "./dist/utils/nanoid.mjs",
+    "./utils/nostics": "./dist/utils/nostics.mjs",
     "./utils/open": "./dist/utils/open.mjs",
     "./utils/remote-assets": "./dist/utils/remote-assets.mjs",
     "./utils/simple-schema": "./dist/utils/simple-schema.mjs",

package/dist/diagnostics-reporter-CsIG85Q5.mjs

@@ -1,38 +0,0 @@
-import { ansiFormatter } from "nostics/formatters/ansi";
-//#region src/utils/colors.ts
-function makeColor(open, close) {
-	const o = `\x1B[${open}m`;
-	const c = `\x1B[${close}m`;
-	return ((arg, ...values) => {
-		if (Array.isArray(arg) && "raw" in arg) {
-			const strings = arg;
-			let out = "";
-			for (let i = 0; i < strings.length; i++) {
-				out += strings[i];
-				if (i < values.length) out += String(values[i]);
-			}
-			return `${o}${out}${c}`;
-		}
-		return `${o}${String(arg)}${c}`;
-	});
-}
-const colors = {
-	blue: makeColor(34, 39),
-	cyan: makeColor(36, 39),
-	gray: makeColor(90, 39),
-	green: makeColor(32, 39),
-	red: makeColor(31, 39),
-	yellow: makeColor(33, 39),
-	bold: makeColor(1, 22),
-	dim: makeColor(2, 22),
-	reset: makeColor(0, 0),
-	underline: makeColor(4, 24)
-};
-//#endregion
-//#region src/utils/diagnostics-reporter.ts
-const formatAnsi = ansiFormatter(colors);
-function devframeReporter(d, { method = "warn" } = {}) {
-	console[method](formatAnsi(d));
-}
-//#endregion
-export { colors as n, devframeReporter as t };