@agimon-ai/po 0.0.0-alpha.0

package/dist/src/builders/server/mcpBundle.mjs

@@ -0,0 +1,84 @@
+import fs from "node:fs";
+import path from "node:path";
+//#region src/builders/server/mcpBundle.ts
+function packageRootOf(entry) {
+	let directory = path.dirname(fs.realpathSync(entry));
+	for (;;) {
+		if (fs.existsSync(path.join(directory, "package.json"))) return directory;
+		const parent = path.dirname(directory);
+		if (parent === directory) throw new Error(`No package manifest owns ${entry}`);
+		directory = parent;
+	}
+}
+function packagePath(packageDir, field, value) {
+	if (typeof value !== "string" || !value.startsWith("./") || value.includes("..")) throw new Error(`poMcp ${field} in ${packageDir} must be a package-relative ./path with no '..'.`);
+	return value;
+}
+function declaredMcpPlugin(packageDir, manifest) {
+	const value = manifest.poMcp;
+	if (value === void 0) return void 0;
+	if (typeof value !== "object" || value === null || Array.isArray(value)) throw new Error(`poMcp manifest in ${packageDir} must be an object.`);
+	const declaration = value;
+	if (!Array.isArray(declaration.scopes) || declaration.scopes.length !== 1 || declaration.scopes[0] !== "session") throw new Error(`poMcp scopes in ${packageDir} must be exactly ['session'].`);
+	const packageName = manifest.name;
+	if (typeof packageName !== "string" || packageName === "") throw new Error(`Package in ${packageDir} has no name.`);
+	let ui;
+	if (declaration.ui !== void 0) {
+		const value = declaration.ui;
+		if (typeof value !== "object" || value === null || !Array.isArray(value.widgets) || value.widgets.some((key) => typeof key !== "string" || !key.startsWith(`${packageName}/`)) || new Set(value.widgets).size !== value.widgets.length) throw new Error(`Invalid MCP widget manifest in ${packageDir}`);
+		ui = {
+			dist: packagePath(packageDir, "ui.dist", value.dist),
+			widgets: value.widgets
+		};
+	}
+	return {
+		packageName,
+		packageDir,
+		...ui === void 0 ? {} : { ui },
+		entry: packagePath(packageDir, "entry", declaration.entry),
+		dist: packagePath(packageDir, "dist", declaration.dist)
+	};
+}
+/**
+* The MCP plugins the given compositions select, in first-selection order.
+*
+* A package that two different directories claim is ambiguous, and a built
+* entry that resolves outside its package is refused.
+*/
+function mcpPluginCandidates(compositions) {
+	const packages = /* @__PURE__ */ new Map();
+	for (const composition of compositions) {
+		const majorMode = composition.majorMode?.name;
+		if (!majorMode) throw new Error("An MCP bundle composition needs its major mode");
+		for (const root of new Set(composition.packageEntries.map(packageRootOf))) {
+			const declaration = declaredMcpPlugin(root, JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf8")));
+			if (declaration === void 0) continue;
+			const previous = packages.get(declaration.packageName);
+			if (previous && previous.declaration.packageDir !== root) throw new Error(`Ambiguous MCP bundle package: ${declaration.packageName}`);
+			const candidate = previous ?? {
+				declaration,
+				owners: []
+			};
+			const layers = composition.selections.filter((selection) => selection.outcome === "resolved" && selection.path && packageRootOf(selection.path) === root).map((selection) => selection.layer);
+			for (const layer of new Set(layers.length > 0 ? layers : ["default"])) if (!candidate.owners.some((owner) => owner.majorMode === majorMode && owner.layer === layer)) candidate.owners.push({
+				majorMode,
+				layer
+			});
+			packages.set(declaration.packageName, candidate);
+		}
+	}
+	return [...packages.values()].map(({ declaration, owners }) => {
+		const module = fs.realpathSync(path.resolve(declaration.packageDir, declaration.dist));
+		const relative = path.relative(declaration.packageDir, module);
+		if (relative === ".." || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) throw new Error(`MCP entry escapes package: ${declaration.packageName}`);
+		return {
+			declaration,
+			module,
+			owners
+		};
+	});
+}
+//#endregion
+export { mcpPluginCandidates };
+
+//# sourceMappingURL=mcpBundle.mjs.map

package/dist/src/builders/server/mcpBundle.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpBundle.mjs","names":[],"sources":["../../../../src/builders/server/mcpBundle.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { DoomServerBundleOwner } from '@agimon-ai/po-core/serverFacet';\n\nimport type { ExtensionComposition } from '../cli/extensionAssembler';\n\nexport interface DeclaredMcpPlugin {\n  readonly packageName: string;\n  readonly packageDir: string;\n  readonly entry: string;\n  readonly dist: string;\n  readonly ui?: { readonly dist: string; readonly widgets: readonly string[] };\n}\n\nfunction packageRootOf(entry: string): string {\n  let directory = path.dirname(fs.realpathSync(entry));\n  for (;;) {\n    if (fs.existsSync(path.join(directory, 'package.json'))) return directory;\n    const parent = path.dirname(directory);\n    if (parent === directory) throw new Error(`No package manifest owns ${entry}`);\n    directory = parent;\n  }\n}\n\nfunction packagePath(packageDir: string, field: string, value: unknown): string {\n  if (typeof value !== 'string' || !value.startsWith('./') || value.includes('..'))\n    throw new Error(`poMcp ${field} in ${packageDir} must be a package-relative ./path with no '..'.`);\n  return value;\n}\n\nfunction declaredMcpPlugin(packageDir: string, manifest: Record<string, unknown>): DeclaredMcpPlugin | undefined {\n  const value = manifest.poMcp;\n  if (value === undefined) return undefined;\n  if (typeof value !== 'object' || value === null || Array.isArray(value))\n    throw new Error(`poMcp manifest in ${packageDir} must be an object.`);\n  const declaration = value as Record<string, unknown>;\n  if (!Array.isArray(declaration.scopes) || declaration.scopes.length !== 1 || declaration.scopes[0] !== 'session')\n    throw new Error(`poMcp scopes in ${packageDir} must be exactly ['session'].`);\n  const packageName = manifest.name;\n  if (typeof packageName !== 'string' || packageName === '') throw new Error(`Package in ${packageDir} has no name.`);\n  let ui: DeclaredMcpPlugin['ui'];\n  if (declaration.ui !== undefined) {\n    const value = declaration.ui as { dist?: unknown; widgets?: unknown } | null;\n    if (\n      typeof value !== 'object' ||\n      value === null ||\n      !Array.isArray(value.widgets) ||\n      value.widgets.some((key: unknown) => typeof key !== 'string' || !key.startsWith(`${packageName}/`)) ||\n      new Set(value.widgets).size !== value.widgets.length\n    )\n      throw new Error(`Invalid MCP widget manifest in ${packageDir}`);\n    ui = { dist: packagePath(packageDir, 'ui.dist', value.dist), widgets: value.widgets as string[] };\n  }\n  return {\n    packageName,\n    packageDir,\n    ...(ui === undefined ? {} : { ui }),\n    entry: packagePath(packageDir, 'entry', declaration.entry),\n    dist: packagePath(packageDir, 'dist', declaration.dist),\n  };\n}\n\n/** One MCP plugin a composition set selects, with the built entry a host imports. */\nexport interface McpPluginCandidate {\n  readonly declaration: DeclaredMcpPlugin;\n  /** Absolute, symlink-resolved path of the package's built `dist` entry. */\n  readonly module: string;\n  /** Every major mode and layer that admitted the package. */\n  readonly owners: readonly DoomServerBundleOwner[];\n}\n\n/**\n * The MCP plugins the given compositions select, in first-selection order.\n *\n * A package that two different directories claim is ambiguous, and a built\n * entry that resolves outside its package is refused.\n */\nexport function mcpPluginCandidates(compositions: readonly ExtensionComposition[]): McpPluginCandidate[] {\n  const packages = new Map<string, { declaration: DeclaredMcpPlugin; owners: DoomServerBundleOwner[] }>();\n  for (const composition of compositions) {\n    const majorMode = composition.majorMode?.name;\n    if (!majorMode) throw new Error('An MCP bundle composition needs its major mode');\n    for (const root of new Set(composition.packageEntries.map(packageRootOf))) {\n      const manifest = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')) as Record<string, unknown>;\n      const declaration = declaredMcpPlugin(root, manifest);\n      if (declaration === undefined) continue;\n      const previous = packages.get(declaration.packageName);\n      if (previous && previous.declaration.packageDir !== root)\n        throw new Error(`Ambiguous MCP bundle package: ${declaration.packageName}`);\n      const candidate = previous ?? { declaration, owners: [] };\n      const layers = composition.selections\n        .filter(\n          (selection) => selection.outcome === 'resolved' && selection.path && packageRootOf(selection.path) === root,\n        )\n        .map((selection) => selection.layer);\n      for (const layer of new Set(layers.length > 0 ? layers : ['default'])) {\n        if (!candidate.owners.some((owner) => owner.majorMode === majorMode && owner.layer === layer))\n          candidate.owners.push({ majorMode, layer });\n      }\n      packages.set(declaration.packageName, candidate);\n    }\n  }\n  return [...packages.values()].map(({ declaration, owners }) => {\n    const module = fs.realpathSync(path.resolve(declaration.packageDir, declaration.dist));\n    const relative = path.relative(declaration.packageDir, module);\n    if (relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative))\n      throw new Error(`MCP entry escapes package: ${declaration.packageName}`);\n    return { declaration, module, owners };\n  });\n}\n"],"mappings":"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"}

package/dist/src/builders/server/packageReloadCheck.cjs

@@ -0,0 +1,62 @@
+//#region src/builders/server/packageReloadCheck.ts
+function createPackageReloadCheck() {
+	const committed = /* @__PURE__ */ new Map();
+	const byModule = (identities) => new Map(identities.map((identity) => [identity.module, identity]));
+	return {
+		diff(scope, identities) {
+			const previous = committed.get(scope);
+			const current = byModule(identities);
+			if (previous === void 0) return {
+				first: true,
+				changed: [...new Set(identities.map((identity) => identity.url))],
+				reselected: [],
+				removed: [],
+				superseded: []
+			};
+			const kept = [...current.values()].filter((identity) => previous.get(identity.module)?.url === identity.url);
+			return {
+				first: false,
+				changed: [...new Set([...current.values()].filter((identity) => previous.get(identity.module)?.url !== identity.url).map((identity) => identity.url))],
+				reselected: kept.filter((identity) => previous.get(identity.module)?.selection !== identity.selection).map((identity) => identity.module),
+				removed: [...previous.keys()].filter((module) => !current.has(module)),
+				superseded: [...new Set([...current.values()].flatMap((identity) => {
+					const before = previous.get(identity.module)?.url;
+					return before !== void 0 && before !== identity.url ? [before] : [];
+				}))]
+			};
+		},
+		commit(scope, identities) {
+			committed.set(scope, byModule(identities));
+		},
+		forget(scope) {
+			committed.delete(scope);
+		}
+	};
+}
+/**
+* Imports each URL once per process.
+*
+* Package URLs are content-addressed, so a URL already imported is the same code: a
+* reload re-imports only the URLs whose content changed. Native `import()` caches by URL
+* too; this keeps that guarantee explicit and observable for the loaders that take an
+* `importer` seam. A failed import is not cached, so the poison set decides retries.
+*/
+function createLiveModuleCache(importer = (url) => import(url)) {
+	const modules = /* @__PURE__ */ new Map();
+	return (url) => {
+		let module = modules.get(url);
+		if (module === void 0) {
+			module = importer(url);
+			modules.set(url, module);
+			module.catch(() => {
+				if (modules.get(url) === module) modules.delete(url);
+			});
+		}
+		return module;
+	};
+}
+//#endregion
+exports.createLiveModuleCache = createLiveModuleCache;
+exports.createPackageReloadCheck = createPackageReloadCheck;
+
+//# sourceMappingURL=packageReloadCheck.cjs.map

package/dist/src/builders/server/packageReloadCheck.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageReloadCheck.cjs","names":[],"sources":["../../../../src/builders/server/packageReloadCheck.ts"],"sourcesContent":["/** One package entry a scope loads, identified by the URL its current content imports from. */\nexport interface ScopePackageIdentity {\n  /** The resolved entry file, stable across rebuilds. */\n  readonly module: string;\n  /** Content-addressed import URL from `packageUrls`; a new URL means new content. */\n  readonly url: string;\n  /**\n   * What else decides whether the scope loads this entry (ownership, selected mode). A\n   * change remounts the scope without importing anything new.\n   */\n  readonly selection?: string;\n}\n\nexport interface ScopeChange {\n  /** No identities were recorded for this scope before. */\n  readonly first: boolean;\n  /** URLs that are new to the scope: added entries and entries whose content changed. */\n  readonly changed: readonly string[];\n  /** Entries whose URL is the same but whose selection changed. */\n  readonly reselected: readonly string[];\n  /** Entries the scope no longer loads. */\n  readonly removed: readonly string[];\n  /** Previously committed URLs that a newer URL of the same entry replaces. */\n  readonly superseded: readonly string[];\n}\n\nexport interface PackageReloadCheck {\n  /**\n   * Compares a scope's current identities with the ones it last committed. Nothing is\n   * recorded until `commit`, so a reload that fails is retried by the next check.\n   */\n  diff(scope: string, identities: readonly ScopePackageIdentity[]): ScopeChange;\n  commit(scope: string, identities: readonly ScopePackageIdentity[]): void;\n  forget(scope: string): void;\n}\n\nexport function createPackageReloadCheck(): PackageReloadCheck {\n  const committed = new Map<string, ReadonlyMap<string, ScopePackageIdentity>>();\n  const byModule = (identities: readonly ScopePackageIdentity[]) =>\n    new Map(identities.map((identity) => [identity.module, identity]));\n  return {\n    diff(scope, identities) {\n      const previous = committed.get(scope);\n      const current = byModule(identities);\n      if (previous === undefined)\n        return {\n          first: true,\n          changed: [...new Set(identities.map((identity) => identity.url))],\n          reselected: [],\n          removed: [],\n          superseded: [],\n        };\n      const kept = [...current.values()].filter((identity) => previous.get(identity.module)?.url === identity.url);\n      return {\n        first: false,\n        changed: [\n          ...new Set(\n            [...current.values()]\n              .filter((identity) => previous.get(identity.module)?.url !== identity.url)\n              .map((identity) => identity.url),\n          ),\n        ],\n        reselected: kept\n          .filter((identity) => previous.get(identity.module)?.selection !== identity.selection)\n          .map((identity) => identity.module),\n        removed: [...previous.keys()].filter((module) => !current.has(module)),\n        superseded: [\n          ...new Set(\n            [...current.values()].flatMap((identity) => {\n              const before = previous.get(identity.module)?.url;\n              return before !== undefined && before !== identity.url ? [before] : [];\n            }),\n          ),\n        ],\n      };\n    },\n    commit(scope, identities) {\n      committed.set(scope, byModule(identities));\n    },\n    forget(scope) {\n      committed.delete(scope);\n    },\n  };\n}\n\n/**\n * Imports each URL once per process.\n *\n * Package URLs are content-addressed, so a URL already imported is the same code: a\n * reload re-imports only the URLs whose content changed. Native `import()` caches by URL\n * too; this keeps that guarantee explicit and observable for the loaders that take an\n * `importer` seam. A failed import is not cached, so the poison set decides retries.\n */\nexport function createLiveModuleCache(\n  importer: (url: string) => Promise<unknown> = (url) => import(url),\n): (url: string) => Promise<unknown> {\n  const modules = new Map<string, Promise<unknown>>();\n  return (url) => {\n    let module = modules.get(url);\n    if (module === undefined) {\n      module = importer(url);\n      modules.set(url, module);\n      module.catch(() => {\n        if (modules.get(url) === module) modules.delete(url);\n      });\n    }\n    return module;\n  };\n}\n"],"mappings":";AAoCA,SAAgB,2BAA+C;CAC7D,MAAM,4BAAY,IAAI,IAAuD;CAC7E,MAAM,YAAY,eAChB,IAAI,IAAI,WAAW,KAAK,aAAa,CAAC,SAAS,QAAQ,QAAQ,CAAC,CAAC;CACnE,OAAO;EACL,KAAK,OAAO,YAAY;GACtB,MAAM,WAAW,UAAU,IAAI,KAAK;GACpC,MAAM,UAAU,SAAS,UAAU;GACnC,IAAI,aAAa,KAAA,GACf,OAAO;IACL,OAAO;IACP,SAAS,CAAC,GAAG,IAAI,IAAI,WAAW,KAAK,aAAa,SAAS,GAAG,CAAC,CAAC;IAChE,YAAY,CAAC;IACb,SAAS,CAAC;IACV,YAAY,CAAC;GACf;GACF,MAAM,OAAO,CAAC,GAAG,QAAQ,OAAO,CAAC,CAAC,CAAC,QAAQ,aAAa,SAAS,IAAI,SAAS,MAAM,CAAC,EAAE,QAAQ,SAAS,GAAG;GAC3G,OAAO;IACL,OAAO;IACP,SAAS,CACP,GAAG,IAAI,IACL,CAAC,GAAG,QAAQ,OAAO,CAAC,CAAC,CAClB,QAAQ,aAAa,SAAS,IAAI,SAAS,MAAM,CAAC,EAAE,QAAQ,SAAS,GAAG,CAAC,CACzE,KAAK,aAAa,SAAS,GAAG,CACnC,CACF;IACA,YAAY,KACT,QAAQ,aAAa,SAAS,IAAI,SAAS,MAAM,CAAC,EAAE,cAAc,SAAS,SAAS,CAAC,CACrF,KAAK,aAAa,SAAS,MAAM;IACpC,SAAS,CAAC,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,QAAQ,WAAW,CAAC,QAAQ,IAAI,MAAM,CAAC;IACrE,YAAY,CACV,GAAG,IAAI,IACL,CAAC,GAAG,QAAQ,OAAO,CAAC,CAAC,CAAC,SAAS,aAAa;KAC1C,MAAM,SAAS,SAAS,IAAI,SAAS,MAAM,CAAC,EAAE;KAC9C,OAAO,WAAW,KAAA,KAAa,WAAW,SAAS,MAAM,CAAC,MAAM,IAAI,CAAC;IACvE,CAAC,CACH,CACF;GACF;EACF;EACA,OAAO,OAAO,YAAY;GACxB,UAAU,IAAI,OAAO,SAAS,UAAU,CAAC;EAC3C;EACA,OAAO,OAAO;GACZ,UAAU,OAAO,KAAK;EACxB;CACF;AACF;;;;;;;;;AAUA,SAAgB,sBACd,YAA+C,QAAQ,OAAO,MAC3B;CACnC,MAAM,0BAAU,IAAI,IAA8B;CAClD,QAAQ,QAAQ;EACd,IAAI,SAAS,QAAQ,IAAI,GAAG;EAC5B,IAAI,WAAW,KAAA,GAAW;GACxB,SAAS,SAAS,GAAG;GACrB,QAAQ,IAAI,KAAK,MAAM;GACvB,OAAO,YAAY;IACjB,IAAI,QAAQ,IAAI,GAAG,MAAM,QAAQ,QAAQ,OAAO,GAAG;GACrD,CAAC;EACH;EACA,OAAO;CACT;AACF"}

package/dist/src/builders/server/packageReloadCheck.mjs

@@ -0,0 +1,61 @@
+//#region src/builders/server/packageReloadCheck.ts
+function createPackageReloadCheck() {
+	const committed = /* @__PURE__ */ new Map();
+	const byModule = (identities) => new Map(identities.map((identity) => [identity.module, identity]));
+	return {
+		diff(scope, identities) {
+			const previous = committed.get(scope);
+			const current = byModule(identities);
+			if (previous === void 0) return {
+				first: true,
+				changed: [...new Set(identities.map((identity) => identity.url))],
+				reselected: [],
+				removed: [],
+				superseded: []
+			};
+			const kept = [...current.values()].filter((identity) => previous.get(identity.module)?.url === identity.url);
+			return {
+				first: false,
+				changed: [...new Set([...current.values()].filter((identity) => previous.get(identity.module)?.url !== identity.url).map((identity) => identity.url))],
+				reselected: kept.filter((identity) => previous.get(identity.module)?.selection !== identity.selection).map((identity) => identity.module),
+				removed: [...previous.keys()].filter((module) => !current.has(module)),
+				superseded: [...new Set([...current.values()].flatMap((identity) => {
+					const before = previous.get(identity.module)?.url;
+					return before !== void 0 && before !== identity.url ? [before] : [];
+				}))]
+			};
+		},
+		commit(scope, identities) {
+			committed.set(scope, byModule(identities));
+		},
+		forget(scope) {
+			committed.delete(scope);
+		}
+	};
+}
+/**
+* Imports each URL once per process.
+*
+* Package URLs are content-addressed, so a URL already imported is the same code: a
+* reload re-imports only the URLs whose content changed. Native `import()` caches by URL
+* too; this keeps that guarantee explicit and observable for the loaders that take an
+* `importer` seam. A failed import is not cached, so the poison set decides retries.
+*/
+function createLiveModuleCache(importer = (url) => import(url)) {
+	const modules = /* @__PURE__ */ new Map();
+	return (url) => {
+		let module = modules.get(url);
+		if (module === void 0) {
+			module = importer(url);
+			modules.set(url, module);
+			module.catch(() => {
+				if (modules.get(url) === module) modules.delete(url);
+			});
+		}
+		return module;
+	};
+}
+//#endregion
+export { createLiveModuleCache, createPackageReloadCheck };
+
+//# sourceMappingURL=packageReloadCheck.mjs.map

package/dist/src/builders/server/packageReloadCheck.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageReloadCheck.mjs","names":[],"sources":["../../../../src/builders/server/packageReloadCheck.ts"],"sourcesContent":["/** One package entry a scope loads, identified by the URL its current content imports from. */\nexport interface ScopePackageIdentity {\n  /** The resolved entry file, stable across rebuilds. */\n  readonly module: string;\n  /** Content-addressed import URL from `packageUrls`; a new URL means new content. */\n  readonly url: string;\n  /**\n   * What else decides whether the scope loads this entry (ownership, selected mode). A\n   * change remounts the scope without importing anything new.\n   */\n  readonly selection?: string;\n}\n\nexport interface ScopeChange {\n  /** No identities were recorded for this scope before. */\n  readonly first: boolean;\n  /** URLs that are new to the scope: added entries and entries whose content changed. */\n  readonly changed: readonly string[];\n  /** Entries whose URL is the same but whose selection changed. */\n  readonly reselected: readonly string[];\n  /** Entries the scope no longer loads. */\n  readonly removed: readonly string[];\n  /** Previously committed URLs that a newer URL of the same entry replaces. */\n  readonly superseded: readonly string[];\n}\n\nexport interface PackageReloadCheck {\n  /**\n   * Compares a scope's current identities with the ones it last committed. Nothing is\n   * recorded until `commit`, so a reload that fails is retried by the next check.\n   */\n  diff(scope: string, identities: readonly ScopePackageIdentity[]): ScopeChange;\n  commit(scope: string, identities: readonly ScopePackageIdentity[]): void;\n  forget(scope: string): void;\n}\n\nexport function createPackageReloadCheck(): PackageReloadCheck {\n  const committed = new Map<string, ReadonlyMap<string, ScopePackageIdentity>>();\n  const byModule = (identities: readonly ScopePackageIdentity[]) =>\n    new Map(identities.map((identity) => [identity.module, identity]));\n  return {\n    diff(scope, identities) {\n      const previous = committed.get(scope);\n      const current = byModule(identities);\n      if (previous === undefined)\n        return {\n          first: true,\n          changed: [...new Set(identities.map((identity) => identity.url))],\n          reselected: [],\n          removed: [],\n          superseded: [],\n        };\n      const kept = [...current.values()].filter((identity) => previous.get(identity.module)?.url === identity.url);\n      return {\n        first: false,\n        changed: [\n          ...new Set(\n            [...current.values()]\n              .filter((identity) => previous.get(identity.module)?.url !== identity.url)\n              .map((identity) => identity.url),\n          ),\n        ],\n        reselected: kept\n          .filter((identity) => previous.get(identity.module)?.selection !== identity.selection)\n          .map((identity) => identity.module),\n        removed: [...previous.keys()].filter((module) => !current.has(module)),\n        superseded: [\n          ...new Set(\n            [...current.values()].flatMap((identity) => {\n              const before = previous.get(identity.module)?.url;\n              return before !== undefined && before !== identity.url ? [before] : [];\n            }),\n          ),\n        ],\n      };\n    },\n    commit(scope, identities) {\n      committed.set(scope, byModule(identities));\n    },\n    forget(scope) {\n      committed.delete(scope);\n    },\n  };\n}\n\n/**\n * Imports each URL once per process.\n *\n * Package URLs are content-addressed, so a URL already imported is the same code: a\n * reload re-imports only the URLs whose content changed. Native `import()` caches by URL\n * too; this keeps that guarantee explicit and observable for the loaders that take an\n * `importer` seam. A failed import is not cached, so the poison set decides retries.\n */\nexport function createLiveModuleCache(\n  importer: (url: string) => Promise<unknown> = (url) => import(url),\n): (url: string) => Promise<unknown> {\n  const modules = new Map<string, Promise<unknown>>();\n  return (url) => {\n    let module = modules.get(url);\n    if (module === undefined) {\n      module = importer(url);\n      modules.set(url, module);\n      module.catch(() => {\n        if (modules.get(url) === module) modules.delete(url);\n      });\n    }\n    return module;\n  };\n}\n"],"mappings":";AAoCA,SAAgB,2BAA+C;CAC7D,MAAM,4BAAY,IAAI,IAAuD;CAC7E,MAAM,YAAY,eAChB,IAAI,IAAI,WAAW,KAAK,aAAa,CAAC,SAAS,QAAQ,QAAQ,CAAC,CAAC;CACnE,OAAO;EACL,KAAK,OAAO,YAAY;GACtB,MAAM,WAAW,UAAU,IAAI,KAAK;GACpC,MAAM,UAAU,SAAS,UAAU;GACnC,IAAI,aAAa,KAAA,GACf,OAAO;IACL,OAAO;IACP,SAAS,CAAC,GAAG,IAAI,IAAI,WAAW,KAAK,aAAa,SAAS,GAAG,CAAC,CAAC;IAChE,YAAY,CAAC;IACb,SAAS,CAAC;IACV,YAAY,CAAC;GACf;GACF,MAAM,OAAO,CAAC,GAAG,QAAQ,OAAO,CAAC,CAAC,CAAC,QAAQ,aAAa,SAAS,IAAI,SAAS,MAAM,CAAC,EAAE,QAAQ,SAAS,GAAG;GAC3G,OAAO;IACL,OAAO;IACP,SAAS,CACP,GAAG,IAAI,IACL,CAAC,GAAG,QAAQ,OAAO,CAAC,CAAC,CAClB,QAAQ,aAAa,SAAS,IAAI,SAAS,MAAM,CAAC,EAAE,QAAQ,SAAS,GAAG,CAAC,CACzE,KAAK,aAAa,SAAS,GAAG,CACnC,CACF;IACA,YAAY,KACT,QAAQ,aAAa,SAAS,IAAI,SAAS,MAAM,CAAC,EAAE,cAAc,SAAS,SAAS,CAAC,CACrF,KAAK,aAAa,SAAS,MAAM;IACpC,SAAS,CAAC,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,QAAQ,WAAW,CAAC,QAAQ,IAAI,MAAM,CAAC;IACrE,YAAY,CACV,GAAG,IAAI,IACL,CAAC,GAAG,QAAQ,OAAO,CAAC,CAAC,CAAC,SAAS,aAAa;KAC1C,MAAM,SAAS,SAAS,IAAI,SAAS,MAAM,CAAC,EAAE;KAC9C,OAAO,WAAW,KAAA,KAAa,WAAW,SAAS,MAAM,CAAC,MAAM,IAAI,CAAC;IACvE,CAAC,CACH,CACF;GACF;EACF;EACA,OAAO,OAAO,YAAY;GACxB,UAAU,IAAI,OAAO,SAAS,UAAU,CAAC;EAC3C;EACA,OAAO,OAAO;GACZ,UAAU,OAAO,KAAK;EACxB;CACF;AACF;;;;;;;;;AAUA,SAAgB,sBACd,YAA+C,QAAQ,OAAO,MAC3B;CACnC,MAAM,0BAAU,IAAI,IAA8B;CAClD,QAAQ,QAAQ;EACd,IAAI,SAAS,QAAQ,IAAI,GAAG;EAC5B,IAAI,WAAW,KAAA,GAAW;GACxB,SAAS,SAAS,GAAG;GACrB,QAAQ,IAAI,KAAK,MAAM;GACvB,OAAO,YAAY;IACjB,IAAI,QAAQ,IAAI,GAAG,MAAM,QAAQ,QAAQ,OAAO,GAAG;GACrD,CAAC;EACH;EACA,OAAO;CACT;AACF"}

package/dist/src/builders/server/packageUrl.cjs

@@ -0,0 +1,210 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let node_url = require("node:url");
+let node_crypto = require("node:crypto");
+node_crypto = require_runtime.__toESM(node_crypto, 1);
+//#region src/builders/server/packageUrl.ts
+/** Realpath fragments of version-scoped package stores: a new version is a new path. */
+const VERSIONED_STORES = [".upm", ".pnpm"].map((store) => `${node_path.default.sep}node_modules${node_path.default.sep}${store}${node_path.default.sep}`);
+const SNAPSHOT_DIRECTORY = node_path.default.join("node_modules", ".po-snapshots");
+const SETTLE_MS = 300;
+const STABLE_ATTEMPTS = 5;
+/** Build outputs a host never imports. */
+const SKIPPED_SUFFIXES = [
+	".map",
+	".d.ts",
+	".d.mts",
+	".d.cts",
+	".tsbuildinfo"
+];
+function packageRootOf(file) {
+	let directory = node_path.default.dirname(file);
+	for (;;) {
+		if (node_fs.default.existsSync(node_path.default.join(directory, "package.json"))) return directory;
+		const parent = node_path.default.dirname(directory);
+		if (parent === directory) return void 0;
+		directory = parent;
+	}
+}
+function isVersioned(root) {
+	return VERSIONED_STORES.some((store) => `${root}${node_path.default.sep}`.includes(store));
+}
+function exportTargets(value, condition, into) {
+	if (condition === "types") return;
+	if (typeof value === "string") {
+		if (!value.includes("*")) into.push(value);
+		return;
+	}
+	if (Array.isArray(value)) {
+		for (const item of value) exportTargets(item, condition, into);
+		return;
+	}
+	if (typeof value === "object" && value !== null) for (const [key, item] of Object.entries(value)) exportTargets(item, key, into);
+}
+function record(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+/** Package-relative entry targets the manifest declares for a server-side host. */
+function declaredTargets(manifest) {
+	const targets = [];
+	exportTargets(manifest.exports, void 0, targets);
+	if (typeof manifest.main === "string") targets.push(manifest.main);
+	const pi = record(manifest.pi);
+	if (Array.isArray(pi?.extensions)) {
+		for (const entry of pi.extensions) if (typeof entry === "string") targets.push(entry);
+	}
+	const server = record(manifest.poServer);
+	if (typeof server?.dist === "string") targets.push(server.dist);
+	const mcp = record(manifest.poMcp);
+	if (typeof mcp?.dist === "string") targets.push(mcp.dist);
+	return targets;
+}
+function inside(relative) {
+	return relative !== "" && relative !== ".." && !relative.startsWith(`..${node_path.default.sep}`) && !node_path.default.isAbsolute(relative);
+}
+/**
+* The files a snapshot carries, package-relative and sorted.
+*
+* A target's whole top-level directory goes with it: bundlers split entries into
+* sibling chunks the entry imports relatively, so copying only the named file would
+* break the import graph.
+*/
+function snapshotFiles(root, entry) {
+	const manifest = JSON.parse(node_fs.default.readFileSync(node_path.default.join(root, "package.json"), "utf8"));
+	const targets = [.../* @__PURE__ */ new Set([...declaredTargets(manifest), node_path.default.relative(root, entry)])].map((target) => node_path.default.normalize(target));
+	const files = /* @__PURE__ */ new Set(["package.json"]);
+	for (const target of targets) {
+		if (!inside(target) || target.split(node_path.default.sep)[0] === "node_modules") continue;
+		const absolute = node_path.default.join(root, target);
+		if (!node_fs.default.existsSync(absolute)) throw new Error(`declared entry is missing: ${target}`);
+		const top = target.split(node_path.default.sep)[0];
+		const topPath = node_path.default.join(root, top);
+		if (top === target || !node_fs.default.statSync(topPath).isDirectory()) {
+			files.add(target);
+			continue;
+		}
+		const collect = (directory) => {
+			for (const dirent of node_fs.default.readdirSync(directory, { withFileTypes: true })) {
+				const file = node_path.default.join(directory, dirent.name);
+				if (dirent.isDirectory()) {
+					if (dirent.name !== "node_modules") collect(file);
+				} else if ((dirent.isFile() || dirent.isSymbolicLink()) && !SKIPPED_SUFFIXES.some((suffix) => dirent.name.endsWith(suffix))) files.add(node_path.default.relative(root, file));
+			}
+		};
+		collect(topPath);
+	}
+	return [...files].sort();
+}
+function statSignature(root, files) {
+	return files.map((file) => {
+		const stat = node_fs.default.statSync(node_path.default.join(root, file));
+		return `${file}\0${String(stat.size)}\0${String(stat.mtimeMs)}`;
+	}).join("\n");
+}
+function contentHash(root, files) {
+	const hash = node_crypto.default.createHash("sha256");
+	for (const file of files) {
+		hash.update(file).update("\0");
+		hash.update(node_fs.default.readFileSync(node_path.default.join(root, file))).update("\0");
+	}
+	return hash.digest("hex").slice(0, 32);
+}
+function pruneOthers(snapshots, keep) {
+	if (!node_fs.default.existsSync(snapshots)) return;
+	for (const name of node_fs.default.readdirSync(snapshots)) if (name !== keep) node_fs.default.rmSync(node_path.default.join(snapshots, name), {
+		recursive: true,
+		force: true
+	});
+}
+/**
+* Maps resolved package entries to import URLs that change only when content changes.
+*
+* A package under a versioned store imports in place: an upgrade is already a new path.
+* Any other package (repo-local, or npm-installed) is snapshotted by content into
+* `<package>/node_modules/.po-snapshots/<hash>/`, with its `package.json` so a
+* self-import by name resolves to the snapshot, while dependencies still resolve
+* from `<package>/node_modules`. A snapshot is taken only when every declared entry
+* exists and two reads `settleMs` apart agree, so a build in progress is never
+* captured. The first snapshot of a package in this process prunes its older ones;
+* later ones keep them, because live sessions may still lazily import from them.
+*/
+function createPackageUrls(options = {}) {
+	const settleMs = options.settleMs ?? SETTLE_MS;
+	const sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+	const states = /* @__PURE__ */ new Map();
+	const pending = /* @__PURE__ */ new Map();
+	const snapshot = async (root, entry) => {
+		const snapshots = node_path.default.join(root, SNAPSHOT_DIRECTORY);
+		for (let attempt = 0; attempt < STABLE_ATTEMPTS; attempt++) {
+			const files = snapshotFiles(root, entry);
+			const signature = statSignature(root, files);
+			const previous = states.get(root);
+			if (previous?.signature === signature && node_fs.default.existsSync(node_path.default.join(snapshots, previous.hash))) return previous.hash;
+			const hash = contentHash(root, files);
+			const target = node_path.default.join(snapshots, hash);
+			if (!node_fs.default.existsSync(target)) {
+				await sleep(settleMs);
+				const settled = snapshotFiles(root, entry);
+				if (settled.join("\n") !== files.join("\n") || contentHash(root, settled) !== hash) continue;
+				const staging = node_path.default.join(snapshots, `.${hash}.${String(process.pid)}.${node_crypto.default.randomUUID()}`);
+				for (const file of files) {
+					node_fs.default.mkdirSync(node_path.default.dirname(node_path.default.join(staging, file)), { recursive: true });
+					node_fs.default.copyFileSync(node_path.default.join(root, file), node_path.default.join(staging, file));
+				}
+				if (contentHash(staging, files) !== hash) {
+					node_fs.default.rmSync(staging, {
+						recursive: true,
+						force: true
+					});
+					continue;
+				}
+				try {
+					node_fs.default.renameSync(staging, target);
+				} catch (error) {
+					node_fs.default.rmSync(staging, {
+						recursive: true,
+						force: true
+					});
+					if (!node_fs.default.existsSync(target)) throw error;
+				}
+			}
+			if (!previous?.pruned) pruneOthers(snapshots, hash);
+			states.set(root, {
+				signature,
+				hash,
+				pruned: true
+			});
+			return hash;
+		}
+		throw new Error(`package content kept changing while it was read: ${root}`);
+	};
+	const pathFor = async (entry) => {
+		const real = node_fs.default.realpathSync(entry);
+		const root = packageRootOf(real);
+		if (root === void 0 || isVersioned(root)) return real;
+		const relative = node_path.default.relative(root, real);
+		if (relative.split(node_path.default.sep)[0] === "node_modules") return real;
+		const key = `${root}\0${relative}`;
+		let running = pending.get(key);
+		if (!running) {
+			running = snapshot(root, real).finally(() => pending.delete(key));
+			pending.set(key, running);
+		}
+		const hash = await running;
+		return node_path.default.join(root, SNAPSHOT_DIRECTORY, hash, relative);
+	};
+	return {
+		pathFor,
+		urlFor: async (entry) => (0, node_url.pathToFileURL)(await pathFor(entry)).href
+	};
+}
+//#endregion
+exports.SNAPSHOT_DIRECTORY = SNAPSHOT_DIRECTORY;
+exports.createPackageUrls = createPackageUrls;
+exports.snapshotFiles = snapshotFiles;
+exports.statSignature = statSignature;
+
+//# sourceMappingURL=packageUrl.cjs.map

package/dist/src/builders/server/packageUrl.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageUrl.cjs","names":["path","fs","crypto","pathToFileURL"],"sources":["../../../../src/builders/server/packageUrl.ts"],"sourcesContent":["import crypto from 'node:crypto';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport { pathToFileURL } from 'node:url';\n\n/** Realpath fragments of version-scoped package stores: a new version is a new path. */\nconst VERSIONED_STORES = ['.upm', '.pnpm'].map((store) => `${path.sep}node_modules${path.sep}${store}${path.sep}`);\nexport const SNAPSHOT_DIRECTORY = path.join('node_modules', '.po-snapshots');\nconst SETTLE_MS = 300;\nconst STABLE_ATTEMPTS = 5;\n/** Build outputs a host never imports. */\nconst SKIPPED_SUFFIXES = ['.map', '.d.ts', '.d.mts', '.d.cts', '.tsbuildinfo'];\n\nexport interface PackageUrlOptions {\n  /** Delay between the two content reads that prove a build is not in progress. */\n  readonly settleMs?: number;\n  readonly sleep?: (ms: number) => Promise<void>;\n}\n\nexport interface PackageUrls {\n  /** The URL to import for a resolved entry file. Stable until the package content changes. */\n  urlFor(entry: string): Promise<string>;\n  /** Same as `urlFor`, as a file path, for loaders that take paths (po-hook). */\n  pathFor(entry: string): Promise<string>;\n}\n\ninterface PackageState {\n  signature: string;\n  hash: string;\n  pruned: boolean;\n}\n\nfunction packageRootOf(file: string): string | undefined {\n  let directory = path.dirname(file);\n  for (;;) {\n    if (fs.existsSync(path.join(directory, 'package.json'))) return directory;\n    const parent = path.dirname(directory);\n    if (parent === directory) return undefined;\n    directory = parent;\n  }\n}\n\nfunction isVersioned(root: string): boolean {\n  return VERSIONED_STORES.some((store) => `${root}${path.sep}`.includes(store));\n}\n\nfunction exportTargets(value: unknown, condition: string | undefined, into: string[]): void {\n  if (condition === 'types') return;\n  if (typeof value === 'string') {\n    if (!value.includes('*')) into.push(value);\n    return;\n  }\n  if (Array.isArray(value)) {\n    for (const item of value) exportTargets(item, condition, into);\n    return;\n  }\n  if (typeof value === 'object' && value !== null)\n    for (const [key, item] of Object.entries(value)) exportTargets(item, key, into);\n}\n\nfunction record(value: unknown): Record<string, unknown> | undefined {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n\n/** Package-relative entry targets the manifest declares for a server-side host. */\nfunction declaredTargets(manifest: Record<string, unknown>): string[] {\n  const targets: string[] = [];\n  exportTargets(manifest.exports, undefined, targets);\n  if (typeof manifest.main === 'string') targets.push(manifest.main);\n  const pi = record(manifest.pi);\n  if (Array.isArray(pi?.extensions))\n    for (const entry of pi.extensions) if (typeof entry === 'string') targets.push(entry);\n  const server = record(manifest.poServer);\n  if (typeof server?.dist === 'string') targets.push(server.dist);\n  const mcp = record(manifest.poMcp);\n  if (typeof mcp?.dist === 'string') targets.push(mcp.dist);\n  return targets;\n}\n\nfunction inside(relative: string): boolean {\n  return relative !== '' && relative !== '..' && !relative.startsWith(`..${path.sep}`) && !path.isAbsolute(relative);\n}\n\n/**\n * The files a snapshot carries, package-relative and sorted.\n *\n * A target's whole top-level directory goes with it: bundlers split entries into\n * sibling chunks the entry imports relatively, so copying only the named file would\n * break the import graph.\n */\nexport function snapshotFiles(root: string, entry: string): string[] {\n  const manifest = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')) as Record<string, unknown>;\n  const targets = [...new Set([...declaredTargets(manifest), path.relative(root, entry)])].map((target) =>\n    path.normalize(target),\n  );\n  const files = new Set<string>(['package.json']);\n  for (const target of targets) {\n    if (!inside(target) || target.split(path.sep)[0] === 'node_modules') continue;\n    const absolute = path.join(root, target);\n    if (!fs.existsSync(absolute)) throw new Error(`declared entry is missing: ${target}`);\n    const top = target.split(path.sep)[0]!;\n    const topPath = path.join(root, top);\n    if (top === target || !fs.statSync(topPath).isDirectory()) {\n      files.add(target);\n      continue;\n    }\n    const collect = (directory: string): void => {\n      for (const dirent of fs.readdirSync(directory, { withFileTypes: true })) {\n        const file = path.join(directory, dirent.name);\n        if (dirent.isDirectory()) {\n          if (dirent.name !== 'node_modules') collect(file);\n        } else if (\n          (dirent.isFile() || dirent.isSymbolicLink()) &&\n          !SKIPPED_SUFFIXES.some((suffix) => dirent.name.endsWith(suffix))\n        )\n          files.add(path.relative(root, file));\n      }\n    };\n    collect(topPath);\n  }\n  return [...files].sort();\n}\n\nexport function statSignature(root: string, files: readonly string[]): string {\n  return files\n    .map((file) => {\n      const stat = fs.statSync(path.join(root, file));\n      return `${file}\\0${String(stat.size)}\\0${String(stat.mtimeMs)}`;\n    })\n    .join('\\n');\n}\n\nfunction contentHash(root: string, files: readonly string[]): string {\n  const hash = crypto.createHash('sha256');\n  for (const file of files) {\n    hash.update(file).update('\\0');\n    hash.update(fs.readFileSync(path.join(root, file))).update('\\0');\n  }\n  return hash.digest('hex').slice(0, 32);\n}\n\nfunction pruneOthers(snapshots: string, keep: string): void {\n  if (!fs.existsSync(snapshots)) return;\n  for (const name of fs.readdirSync(snapshots))\n    if (name !== keep) fs.rmSync(path.join(snapshots, name), { recursive: true, force: true });\n}\n\n/**\n * Maps resolved package entries to import URLs that change only when content changes.\n *\n * A package under a versioned store imports in place: an upgrade is already a new path.\n * Any other package (repo-local, or npm-installed) is snapshotted by content into\n * `<package>/node_modules/.po-snapshots/<hash>/`, with its `package.json` so a\n * self-import by name resolves to the snapshot, while dependencies still resolve\n * from `<package>/node_modules`. A snapshot is taken only when every declared entry\n * exists and two reads `settleMs` apart agree, so a build in progress is never\n * captured. The first snapshot of a package in this process prunes its older ones;\n * later ones keep them, because live sessions may still lazily import from them.\n */\nexport function createPackageUrls(options: PackageUrlOptions = {}): PackageUrls {\n  const settleMs = options.settleMs ?? SETTLE_MS;\n  const sleep = options.sleep ?? ((ms: number) => new Promise<void>((resolve) => setTimeout(resolve, ms)));\n  const states = new Map<string, PackageState>();\n  const pending = new Map<string, Promise<string>>();\n\n  const snapshot = async (root: string, entry: string): Promise<string> => {\n    const snapshots = path.join(root, SNAPSHOT_DIRECTORY);\n    for (let attempt = 0; attempt < STABLE_ATTEMPTS; attempt++) {\n      const files = snapshotFiles(root, entry);\n      const signature = statSignature(root, files);\n      const previous = states.get(root);\n      if (previous?.signature === signature && fs.existsSync(path.join(snapshots, previous.hash))) return previous.hash;\n      const hash = contentHash(root, files);\n      const target = path.join(snapshots, hash);\n      if (!fs.existsSync(target)) {\n        await sleep(settleMs);\n        const settled = snapshotFiles(root, entry);\n        if (settled.join('\\n') !== files.join('\\n') || contentHash(root, settled) !== hash) continue;\n        const staging = path.join(snapshots, `.${hash}.${String(process.pid)}.${crypto.randomUUID()}`);\n        for (const file of files) {\n          fs.mkdirSync(path.dirname(path.join(staging, file)), { recursive: true });\n          fs.copyFileSync(path.join(root, file), path.join(staging, file));\n        }\n        if (contentHash(staging, files) !== hash) {\n          fs.rmSync(staging, { recursive: true, force: true });\n          continue;\n        }\n        try {\n          fs.renameSync(staging, target);\n        } catch (error) {\n          fs.rmSync(staging, { recursive: true, force: true });\n          if (!fs.existsSync(target)) throw error;\n        }\n      }\n      if (!previous?.pruned) pruneOthers(snapshots, hash);\n      states.set(root, { signature, hash, pruned: true });\n      return hash;\n    }\n    throw new Error(`package content kept changing while it was read: ${root}`);\n  };\n\n  const pathFor = async (entry: string): Promise<string> => {\n    const real = fs.realpathSync(entry);\n    const root = packageRootOf(real);\n    // A file no package owns (a loose repository hook) has nothing to snapshot.\n    if (root === undefined || isVersioned(root)) return real;\n    const relative = path.relative(root, real);\n    if (relative.split(path.sep)[0] === 'node_modules') return real;\n    const key = `${root}\\0${relative}`;\n    let running = pending.get(key);\n    if (!running) {\n      running = snapshot(root, real).finally(() => pending.delete(key));\n      pending.set(key, running);\n    }\n    const hash = await running;\n    return path.join(root, SNAPSHOT_DIRECTORY, hash, relative);\n  };\n\n  return { pathFor, urlFor: async (entry) => pathToFileURL(await pathFor(entry)).href };\n}\n"],"mappings":"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"}