fix(playground): externalize project libraries and YAML in ESM bundle

Author: chenanran555

bun.lock

@@ -42,9 +42,12 @@
 	"dependencies": {
 		"@hono/node-server": "^2.0.5",
 		"@hono/zod-openapi": "^1.4.0",
+		"@openagentpack/project-versions": "workspace:*",
+		"@openagentpack/project-workspace": "workspace:*",
 		"@openagentpack/sdk": "workspace:*",
 		"chokidar": "^4.0.3",
 		"hono": "^4.12.28",
+		"yaml": "^2.9.0",
 		"zod": "^4.4.3"
 	},
 	"devDependencies": {

packages/playground/package.json

@@ -13,7 +13,19 @@ export default defineConfig({
 	// Shared singletons must resolve to one runtime instance: @hono/zod-openapi patches zod's
 	// prototype with `.openapi()`, and the external @openagentpack/sdk builds its schemas from the same
 	// zod — bundling a second copy would leave sdk's schemas without the patch.
-	external: ["@openagentpack/sdk", "hono", "@hono/node-server", "@hono/zod-openapi", "zod"],
+	// Server sources also import the public project libraries and YAML. Load these as
+	// declared runtime dependencies: inlining YAML's CommonJS entry into ESM leaves
+	// require("process") without Node's CommonJS loader.
+	external: [
+		"@openagentpack/sdk",
+		"@openagentpack/project-versions",
+		"@openagentpack/project-workspace",
+		"hono",
+		"@hono/node-server",
+		"@hono/zod-openapi",
+		"yaml",
+		"zod",
+	],
 	// Inline the private workspace packages so the published artifact is self-contained.
 	noExternal: [/@openagentpack\/server/],
 	esbuildOptions(options) {

packages/playground/tsup.config.ts

@@ -0,0 +1,34 @@
+import { describe, expect, test } from "bun:test";
+import { readFileSync } from "node:fs";
+import playgroundConfig from "../../packages/playground/tsup.config.ts";
+
+function runtimeDependencies(relativePath: string): Record<string, string> {
+	const manifest = JSON.parse(readFileSync(new URL(relativePath, import.meta.url), "utf8")) as {
+		dependencies: Record<string, string>;
+	};
+	return manifest.dependencies;
+}
+
+describe("published Playground dependency boundary", () => {
+	test("declares the bundled private Server's runtime dependencies", () => {
+		const serverDependencies = runtimeDependencies("../../apps/server/package.json");
+		const playgroundDependencies = runtimeDependencies("../../packages/playground/package.json");
+		for (const [name, versionRange] of Object.entries(serverDependencies)) {
+			expect(playgroundDependencies[name]).toBe(versionRange);
+		}
+	});
+
+	test("keeps public project libraries and CommonJS YAML external to the ESM bundle", () => {
+		if (typeof playgroundConfig === "function" || Array.isArray(playgroundConfig)) {
+			throw new Error("Expected a single Playground build configuration");
+		}
+		for (const name of [
+			"@openagentpack/sdk",
+			"@openagentpack/project-versions",
+			"@openagentpack/project-workspace",
+			"yaml",
+		]) {
+			expect(playgroundConfig.external).toContain(name);
+		}
+	});
+});