everything-dev 1.7.2 → 1.8.0

package/dist/orchestrator.mjs

@@ -1,204 +1,62 @@
-import { getHostDevelopmentPort, getProjectRoot, parsePort } from "./config.mjs";
 import { patchManifestFetchForSsrPublicPath } from "./mf.mjs";
-import { Deferred, Effect, Fiber, Ref } from "effect";
+import { DevRuntimeConfig, ServiceDescriptorMap } from "./service-descriptor.mjs";
+import { Deferred, Effect, Option, Ref, Stream } from "effect";
 import { createConnection } from "node:net";
+import { Command } from "@effect/platform";
 
 //#region src/orchestrator.ts
-const processConfigBases = {
-	"host-build": {
-		name: "host-build",
-		command: "bun",
-		args: ["run", "build"],
-		cwd: "host",
-		readyPatterns: [/built in/i, /compiled.*successfully/i],
-		errorPatterns: [
-			/error:/i,
-			/failed/i,
-			/exception/i
-		]
-	},
-	host: {
-		name: "host",
-		command: "bun",
-		args: ["run", "dev"],
-		cwd: "host",
-		readyPatterns: [/Host (dev|production) server running at/i, /Server running at/i],
-		errorPatterns: [
-			/error:/i,
-			/failed/i,
-			/exception/i
-		]
-	},
-	ui: {
-		name: "ui",
-		command: "bun",
-		args: ["run", "dev"],
-		cwd: "ui",
-		readyPatterns: [
-			/\bready\s+built in\b/i,
-			/\bLocal:\b/i,
-			/\bcompiled\b.*successfully/i
-		],
-		errorPatterns: [/error/i, /failed to compile/i]
-	},
-	"ui-ssr": {
-		name: "ui-ssr",
-		command: "bun",
-		args: ["run", "dev:ssr"],
-		cwd: "ui",
-		readyPatterns: [/\bready\s+built in\b/i, /\bcompiled\b.*successfully/i],
-		errorPatterns: [/error/i, /failed/i]
-	},
-	api: {
-		name: "api",
-		command: "bun",
-		args: ["run", "dev"],
-		cwd: "api",
-		readyPatterns: [
-			/ready in/i,
-			/compiled.*successfully/i,
-			/listening/i,
-			/started/i
-		],
-		errorPatterns: [/error/i, /failed/i]
-	}
-};
-function getProcessConfig(pkg, env, portOverride, bosConfig, runtimeConfig) {
-	if (pkg === "auth") {
-		const authConfig = runtimeConfig?.auth;
-		if (!authConfig?.localPath || authConfig.source !== "local") return null;
-		const port = portOverride ?? authConfig.port ?? (authConfig.url ? parsePort(authConfig.url) : 3020);
-		return {
-			name: "auth",
-			command: "bun",
-			args: ["run", "dev"],
-			cwd: authConfig.localPath,
-			port,
-			readyPatterns: [
-				/ready in/i,
-				/compiled.*successfully/i,
-				/listening/i,
-				/started/i
-			],
-			errorPatterns: [/error/i, /failed/i],
-			env
-		};
-	}
-	if (pkg.startsWith("plugin:")) {
-		const pluginId = pkg.slice(7);
-		const pluginConfig = runtimeConfig?.plugins?.[pluginId] ?? null;
-		const localPath = pluginConfig?.localPath;
-		if (!localPath || pluginConfig?.source !== "local") return null;
-		return {
-			name: pkg,
-			command: "bun",
-			args: ["run", "dev"],
-			cwd: localPath,
-			port: portOverride ?? pluginConfig?.port ?? (pluginConfig?.url ? parsePort(pluginConfig.url) : 0),
-			readyPatterns: [
-				/ready in/i,
-				/compiled.*successfully/i,
-				/listening/i,
-				/started/i
-			],
-			errorPatterns: [/error/i, /failed/i],
-			env
-		};
-	}
-	const base = processConfigBases[pkg];
-	if (!base) return null;
-	let port;
-	if (pkg === "host") port = portOverride ?? (runtimeConfig?.hostUrl ? parsePort(runtimeConfig.hostUrl) : bosConfig ? getHostDevelopmentPort(bosConfig.app.host.development) : 3e3);
-	else if (pkg === "ui") port = runtimeConfig?.ui.port ?? (runtimeConfig?.ui.url ? parsePort(runtimeConfig.ui.url) : 3002);
-	else if (pkg === "ui-ssr") port = runtimeConfig?.ui.ssrUrl ? parsePort(runtimeConfig.ui.ssrUrl) : runtimeConfig?.ui.port ? runtimeConfig.ui.port + 1 : 3003;
-	else if (pkg === "api") port = runtimeConfig?.api.port ?? (runtimeConfig?.api.url ? parsePort(runtimeConfig.api.url) : 3014);
-	else port = 0;
-	const cwd = pkg === "ui" ? runtimeConfig?.ui.localPath ?? base.cwd : pkg === "api" ? runtimeConfig?.api.localPath ?? base.cwd : base.cwd;
-	return {
-		...base,
-		cwd,
-		port,
-		env
-	};
-}
 const stripAnsi = (input) => {
 	const ESC = String.fromCharCode(27);
 	const BEL = String.fromCharCode(7);
 	return input.replace(new RegExp(`${ESC}\\][^${BEL}]*${BEL}`, "g"), "").replace(new RegExp(`${ESC}\\[[0-?]*[ -/]*[@-~]`, "g"), "");
 };
-const probeHttpOk = async (url, timeoutMs = 400) => {
-	const controller = new AbortController();
-	const timer = setTimeout(() => controller.abort(), timeoutMs);
-	try {
-		return (await fetch(url, { signal: controller.signal })).ok;
-	} catch {
-		return false;
-	} finally {
-		clearTimeout(timer);
-	}
-};
-const probeTcpOpen = async (port, timeoutMs = 250) => {
-	return new Promise((resolve) => {
-		const socket = createConnection({
-			host: "127.0.0.1",
-			port
-		});
-		const timer = setTimeout(() => {
-			socket.destroy();
-			resolve(false);
-		}, timeoutMs);
-		socket.once("connect", () => {
+const probeHttpOk = (url, timeoutMs = 400) => Effect.tryPromise({
+	try: async () => {
+		const controller = new AbortController();
+		const timer = setTimeout(() => controller.abort(), timeoutMs);
+		try {
+			return (await fetch(url, { signal: controller.signal })).ok;
+		} catch {
+			return false;
+		} finally {
 			clearTimeout(timer);
-			socket.destroy();
-			resolve(true);
-		});
-		socket.once("error", () => {
-			clearTimeout(timer);
-			resolve(false);
-		});
+		}
+	},
+	catch: () => false
+});
+const probeTcpOpen = (port, timeoutMs = 250) => Effect.async((resume) => {
+	const socket = createConnection({
+		host: "127.0.0.1",
+		port
 	});
-};
-const detectStatus = (line, config) => {
+	const timer = setTimeout(() => {
+		socket.destroy();
+		resume(Effect.succeed(false));
+	}, timeoutMs);
+	socket.once("connect", () => {
+		clearTimeout(timer);
+		socket.destroy();
+		resume(Effect.succeed(true));
+	});
+	socket.once("error", () => {
+		clearTimeout(timer);
+		resume(Effect.succeed(false));
+	});
+});
+const detectStatus = (line, descriptor) => {
 	const cleanLine = stripAnsi(line);
-	for (const pattern of config.errorPatterns) if (pattern.test(cleanLine)) return {
+	const errorPatterns = descriptor.errorPatterns ?? [];
+	const readyPatterns = descriptor.readyPatterns ?? [];
+	for (const pattern of errorPatterns) if (pattern.test(cleanLine)) return {
 		status: "error",
 		isError: true
 	};
-	for (const pattern of config.readyPatterns) if (pattern.test(cleanLine)) return {
+	for (const pattern of readyPatterns) if (pattern.test(cleanLine)) return {
 		status: "ready",
 		isError: false
 	};
 	return null;
 };
-const killProcessTree = (pid) => Effect.gen(function* () {
-	const killSignal = (signal) => Effect.try({
-		try: () => {
-			process.kill(-pid, signal);
-		},
-		catch: () => null
-	}).pipe(Effect.ignore);
-	const killDirect = (signal) => Effect.try({
-		try: () => {
-			process.kill(pid, signal);
-		},
-		catch: () => null
-	}).pipe(Effect.ignore);
-	const isRunning = () => Effect.try({
-		try: () => {
-			process.kill(pid, 0);
-			return true;
-		},
-		catch: () => false
-	});
-	yield* killSignal("SIGTERM");
-	yield* killDirect("SIGTERM");
-	yield* Effect.sleep("200 millis");
-	if (yield* isRunning()) {
-		yield* killSignal("SIGKILL");
-		yield* killDirect("SIGKILL");
-		yield* Effect.sleep("100 millis");
-	}
-});
 const patchConsole = (name, callbacks) => {
 	const originalLog = console.log;
 	const originalError = console.error;
@@ -226,14 +84,14 @@ const patchConsole = (name, callbacks) => {
 		console.info = originalInfo;
 	};
 };
-const spawnRemoteHost = (config, callbacks, runtimeConfig) => Effect.gen(function* () {
-	const remoteUrl = config.env?.HOST_REMOTE_URL;
-	if (!remoteUrl) return yield* Effect.fail(/* @__PURE__ */ new Error("HOST_REMOTE_URL not provided for remote host"));
-	if (config.env) for (const [key, value] of Object.entries(config.env)) process.env[key] = value;
-	callbacks.onStatus(config.name, "starting");
-	callbacks.onLog(config.name, `Remote: ${remoteUrl}`);
-	const restoreConsole = patchConsole(config.name, callbacks);
-	callbacks.onLog(config.name, "Loading Module Federation runtime...");
+const spawnRemoteHost = (descriptor, callbacks) => Effect.gen(function* () {
+	const runtimeConfig = yield* DevRuntimeConfig;
+	const remoteUrl = descriptor.remoteUrl;
+	if (!remoteUrl) return yield* Effect.fail(/* @__PURE__ */ new Error("remoteUrl not provided on host descriptor"));
+	callbacks.onStatus(descriptor.key, "starting");
+	callbacks.onLog(descriptor.key, `Remote: ${remoteUrl}`);
+	const restoreConsole = patchConsole(descriptor.key, callbacks);
+	callbacks.onLog(descriptor.key, "Loading Module Federation runtime...");
 	const mfRuntime = yield* Effect.tryPromise({
 		try: () => import("@module-federation/enhanced/runtime"),
 		catch: (e) => /* @__PURE__ */ new Error(`Failed to load MF runtime: ${e}`)
@@ -270,24 +128,24 @@ const spawnRemoteHost = (config, callbacks, runtimeConfig) => Effect.gen(functio
 		name: "host",
 		entry: entryUrl
 	}]);
-	callbacks.onLog(config.name, `Loading host from ${entryUrl}...`);
+	callbacks.onLog(descriptor.key, `Loading host from ${entryUrl}...`);
 	const hostModule = yield* Effect.tryPromise({
 		try: () => mf.loadRemote("host/Server"),
 		catch: (e) => /* @__PURE__ */ new Error(`Failed to load host module: ${e}`)
 	});
 	if (!hostModule?.runServer) return yield* Effect.fail(/* @__PURE__ */ new Error("Host module does not export runServer function"));
-	callbacks.onLog(config.name, "Starting server...");
+	callbacks.onLog(descriptor.key, "Starting server...");
 	const serverHandle = hostModule.runServer({ config: runtimeConfig });
 	yield* Effect.tryPromise({
 		try: () => serverHandle.ready,
 		catch: (e) => /* @__PURE__ */ new Error(`Server failed to start: ${e}`)
 	});
-	callbacks.onStatus(config.name, "ready");
+	callbacks.onStatus(descriptor.key, "ready");
 	return {
-		name: config.name,
+		name: descriptor.key,
 		pid: process.pid,
 		kill: Effect.gen(function* () {
-			callbacks.onLog(config.name, "Shutting down remote host...");
+			callbacks.onLog(descriptor.key, "Shutting down remote host...");
 			restoreConsole();
 			yield* Effect.tryPromise({
 				try: () => serverHandle.shutdown(),
@@ -298,56 +156,44 @@ const spawnRemoteHost = (config, callbacks, runtimeConfig) => Effect.gen(functio
 		waitForExit: Effect.never
 	};
 });
-const spawnDevProcess = (config, callbacks, runtimeConfig, registry) => Effect.gen(function* () {
-	let configDir;
-	try {
-		configDir = getProjectRoot();
-	} catch {
-		configDir = process.cwd();
-	}
-	const fullCwd = config.cwd.startsWith("/") ? config.cwd : `${configDir}/${config.cwd}`;
+const spawnDevProcess = (descriptor, callbacks) => Effect.gen(function* () {
+	const runtimeConfig = yield* DevRuntimeConfig;
+	if (!descriptor.localPath) return yield* Effect.fail(/* @__PURE__ */ new Error(`No localPath for local service: ${descriptor.key}`));
+	const fullCwd = descriptor.localPath;
+	const command = descriptor.command ?? "bun";
+	const args = descriptor.args ?? ["run", "dev"];
+	const port = descriptor.port ?? descriptor.defaultPort;
+	const name = descriptor.key;
 	const readyDeferred = yield* Deferred.make();
 	const statusRef = yield* Ref.make("starting");
-	callbacks.onStatus(config.name, "starting");
+	callbacks.onStatus(name, "starting");
 	const envVars = {
 		...process.env,
-		...config.env,
 		FORCE_COLOR: "1",
-		...config.port > 0 ? { PORT: String(config.port) } : {}
+		...port > 0 ? { PORT: String(port) } : {}
 	};
-	if (runtimeConfig && config.name === "host") envVars.BOS_RUNTIME_CONFIG = JSON.stringify(runtimeConfig);
-	const proc = Bun.spawn({
-		cmd: [config.command, ...config.args],
-		cwd: fullCwd,
-		env: envVars,
-		stdio: [
-			"inherit",
-			"pipe",
-			"pipe"
-		]
-	});
+	if (name === "host") envVars.BOS_RUNTIME_CONFIG = JSON.stringify(runtimeConfig);
+	const cmd = Command.make(command, ...args).pipe(Command.workingDirectory(fullCwd), Command.env(envVars));
+	const proc = yield* Command.start(cmd);
 	const markReady = Effect.gen(function* () {
 		const currentStatus = yield* Ref.get(statusRef);
 		if (currentStatus === "ready" || currentStatus === "error") return;
 		yield* Ref.set(statusRef, "ready");
-		callbacks.onStatus(config.name, "ready");
+		callbacks.onStatus(name, "ready");
 		yield* Deferred.succeed(readyDeferred, void 0).pipe(Effect.ignore);
 	});
-	if (config.port > 0) {
-		const readinessPath = config.name === "host" ? "/health" : config.name === "ui-ssr" ? "/" : "/remoteEntry.js";
-		const url = `http://127.0.0.1:${config.port}${readinessPath}`;
+	if (port > 0) {
+		const url = `http://127.0.0.1:${port}${descriptor.readinessPath}`;
 		yield* Effect.forkScoped(Effect.gen(function* () {
 			const deadline = Date.now() + 9e4;
 			while (Date.now() < deadline) {
 				const status = yield* Ref.get(statusRef);
 				if (status === "ready" || status === "error") return;
-				if (url ? yield* Effect.tryPromise({
-					try: () => probeHttpOk(url),
-					catch: () => false
-				}) : yield* Effect.tryPromise({
-					try: () => probeTcpOpen(config.port),
-					catch: () => false
-				})) {
+				if (yield* probeHttpOk(url)) {
+					yield* markReady;
+					return;
+				}
+				if (yield* probeTcpOpen(port)) {
 					yield* markReady;
 					return;
 				}
@@ -355,117 +201,123 @@ const spawnDevProcess = (config, callbacks, runtimeConfig, registry) => Effect.g
 			}
 		}));
 	}
-	if (registry && proc.pid) yield* registry.track({
-		pid: proc.pid,
-		name: config.name,
-		port: config.port,
-		startedAt: Date.now(),
-		command: [config.command, ...config.args].join(" ")
-	});
-	yield* Effect.forkScoped(Effect.promise(() => proc.exited).pipe(Effect.andThen((code) => Effect.gen(function* () {
-		if (registry && proc.pid) yield* registry.untrack(proc.pid).pipe(Effect.ignore);
+	const pid = Number(proc.pid);
+	yield* Effect.forkScoped(Effect.gen(function* () {
+		const exitCode = yield* proc.exitCode;
 		if ((yield* Ref.get(statusRef)) === "ready") return;
-		callbacks.onLog(config.name, `Process exited before ready (exit code: ${code})`, true);
+		callbacks.onLog(name, `Process exited before ready (exit code: ${exitCode})`, true);
 		yield* Ref.set(statusRef, "error");
-		callbacks.onStatus(config.name, "error");
-		yield* Deferred.fail(readyDeferred, /* @__PURE__ */ new Error(`Process exited before ready: ${config.name}`)).pipe(Effect.ignore);
-	}))));
+		callbacks.onStatus(name, "error");
+		yield* Deferred.fail(readyDeferred, /* @__PURE__ */ new Error(`Process exited before ready: ${name}`)).pipe(Effect.ignore);
+	}));
 	const handleLine = (line, isStderr) => Effect.gen(function* () {
 		if (!line.trim()) return;
-		callbacks.onLog(config.name, line, isStderr);
+		const cleanLine = stripAnsi(line);
+		const looksLikeError = isStderr && /^(error|fail|fatal|exception|unhandled|reject)/i.test(cleanLine) && !/^\$/.test(cleanLine);
+		callbacks.onLog(name, line, looksLikeError);
 		if ((yield* Ref.get(statusRef)) === "ready") return;
-		const detected = detectStatus(line, config);
+		const detected = detectStatus(line, descriptor);
 		if (detected) {
 			yield* Ref.set(statusRef, detected.status);
-			callbacks.onStatus(config.name, detected.status);
+			callbacks.onStatus(name, detected.status);
 			if (detected.status === "ready" || detected.status === "error") if (detected.status === "ready") yield* Deferred.succeed(readyDeferred, void 0).pipe(Effect.ignore);
-			else yield* Deferred.fail(readyDeferred, /* @__PURE__ */ new Error(`Process failed: ${config.name}`)).pipe(Effect.ignore);
+			else yield* Deferred.fail(readyDeferred, /* @__PURE__ */ new Error(`Process failed: ${name}`)).pipe(Effect.ignore);
 		}
 	});
-	const decoder = new TextDecoder();
-	const stdoutFiber = yield* Effect.forkScoped(Effect.async((resume) => {
-		if (!proc.stdout) {
-			resume(Effect.void);
-			return;
-		}
-		const reader = proc.stdout.getReader();
-		let buffer = "";
-		let active = true;
-		const pump = () => reader.read().then(({ done, value }) => {
-			if (!active) return;
-			if (done) {
-				if (buffer) Effect.runSync(handleLine(buffer, false));
+	yield* Effect.forkScoped(Stream.runForEach((line) => handleLine(line, false))(Stream.splitLines(Stream.decodeText(proc.stdout, "utf-8"))));
+	yield* Effect.forkScoped(Stream.runForEach((line) => handleLine(line, true))(Stream.splitLines(Stream.decodeText(proc.stderr, "utf-8"))));
+	return {
+		name,
+		pid,
+		kill: Effect.gen(function* () {
+			const result = yield* proc.kill("SIGTERM").pipe(Effect.timeout("3 seconds"), Effect.option);
+			if (Option.isNone(result)) {
+				const pid = Number(proc.pid);
+				yield* Effect.try(() => process.kill(-pid, "SIGKILL")).pipe(Effect.ignore);
+				yield* Effect.sleep("250 millis");
+			}
+		}).pipe(Effect.ignore),
+		waitForReady: Deferred.await(readyDeferred),
+		waitForExit: proc.exitCode
+	};
+});
+const spawnRemoteProbe = (pkg, descriptor, callbacks) => Effect.gen(function* () {
+	callbacks.onStatus(pkg, "starting");
+	const readyDeferred = yield* Deferred.make();
+	const statusRef = yield* Ref.make("starting");
+	const markReady = Effect.gen(function* () {
+		yield* Ref.set(statusRef, "ready");
+		yield* Deferred.succeed(readyDeferred, void 0);
+		callbacks.onStatus(pkg, "ready", "loaded");
+	});
+	const markError = Effect.gen(function* () {
+		yield* Ref.set(statusRef, "error");
+		yield* Deferred.fail(readyDeferred, /* @__PURE__ */ new Error(`Remote ${pkg} unreachable`));
+		callbacks.onStatus(pkg, "error", "unreachable");
+	});
+	const baseUrl = descriptor.url.replace(/\/$/, "");
+	const manifestUrl = `${baseUrl}/mf-manifest.json`;
+	const entryUrl = `${baseUrl}${descriptor.readinessPath}`;
+	const probeUrl = descriptor.readinessPath === "/health" ? `${baseUrl}/health` : manifestUrl;
+	yield* Effect.forkScoped(Effect.gen(function* () {
+		const deadline = Date.now() + 6e4;
+		while (Date.now() < deadline) {
+			const status = yield* Ref.get(statusRef);
+			if (status === "ready" || status === "error") return;
+			if (yield* probeHttpOk(probeUrl, 400)) {
+				yield* markReady;
 				return;
 			}
-			buffer += decoder.decode(value, { stream: true }).replace(/\r\n/g, "\n").replace(/\r/g, "\n");
-			const lines = buffer.split("\n");
-			buffer = lines.pop() ?? "";
-			for (const line of lines) Effect.runSync(handleLine(line, false));
-			return pump();
-		});
-		pump().then(() => {
-			if (active) resume(Effect.void);
-		});
-		return Effect.sync(() => {
-			active = false;
-			reader.cancel();
-		});
-	}));
-	const stderrFiber = yield* Effect.forkScoped(Effect.async((resume) => {
-		if (!proc.stderr) {
-			resume(Effect.void);
-			return;
-		}
-		const reader = proc.stderr.getReader();
-		let buffer = "";
-		let active = true;
-		const pump = () => reader.read().then(({ done, value }) => {
-			if (!active) return;
-			if (done) {
-				if (buffer) Effect.runSync(handleLine(buffer, true));
+			if (yield* probeHttpOk(entryUrl, 400)) {
+				yield* markReady;
 				return;
 			}
-			buffer += decoder.decode(value, { stream: true }).replace(/\r\n/g, "\n").replace(/\r/g, "\n");
-			const lines = buffer.split("\n");
-			buffer = lines.pop() ?? "";
-			for (const line of lines) Effect.runSync(handleLine(line, true));
-			return pump();
-		});
-		pump().then(() => {
-			if (active) resume(Effect.void);
-		});
-		return Effect.sync(() => {
-			active = false;
-			reader.cancel();
-		});
+			yield* Effect.sleep("500 millis");
+		}
+		if ((yield* Ref.get(statusRef)) !== "ready") yield* markError;
 	}));
 	return {
-		name: config.name,
-		pid: proc.pid,
-		kill: proc.pid ? killProcessTree(proc.pid) : Effect.gen(function* () {
-			proc.kill("SIGTERM");
-			yield* Effect.sleep("100 millis");
-			try {
-				proc.kill("SIGKILL");
-			} catch {}
+		name: pkg,
+		pid: void 0,
+		kill: Effect.gen(function* () {
+			yield* Ref.set(statusRef, "error");
+			yield* Deferred.fail(readyDeferred, /* @__PURE__ */ new Error("Killed")).pipe(Effect.ignore);
 		}),
 		waitForReady: Deferred.await(readyDeferred),
-		waitForExit: Effect.gen(function* () {
-			yield* Fiber.joinAll([stdoutFiber, stderrFiber]);
-			return yield* Effect.promise(() => proc.exited);
-		})
+		waitForExit: Effect.never
 	};
 });
-const makeDevProcess = (pkg, env, callbacks, portOverride, bosConfig, runtimeConfig, registry) => Effect.gen(function* () {
-	const config = getProcessConfig(pkg, env, portOverride, bosConfig, runtimeConfig);
-	if (!config) return yield* Effect.fail(/* @__PURE__ */ new Error(`Unknown package: ${pkg}`));
-	if (pkg === "host" && runtimeConfig) {
-		if (env?.HOST_SOURCE === "remote") return yield* spawnRemoteHost(config, callbacks, runtimeConfig);
-		return yield* spawnDevProcess(config, callbacks, runtimeConfig, registry);
+const makeDevProcess = (pkg, callbacks, portOverride) => Effect.gen(function* () {
+	const descriptor = (yield* ServiceDescriptorMap).get(pkg);
+	if (!descriptor) {
+		callbacks.onStatus(pkg, "ready", "Remote");
+		return {
+			name: pkg,
+			pid: void 0,
+			kill: Effect.void,
+			waitForReady: Effect.void,
+			waitForExit: Effect.never
+		};
 	}
-	return yield* spawnDevProcess(config, callbacks, runtimeConfig, registry);
+	if (pkg === "host" && descriptor.source === "remote") return yield* spawnRemoteHost(descriptor, callbacks);
+	if (descriptor.source === "remote" || !descriptor.localPath) return yield* spawnRemoteProbe(pkg, descriptor, callbacks);
+	return yield* spawnDevProcess(portOverride ? {
+		...descriptor,
+		port: portOverride
+	} : descriptor, callbacks);
 });
+function getProcessStates(packages, services, portOverride) {
+	return packages.map((pkg) => {
+		const descriptor = services.get(pkg);
+		return {
+			name: pkg,
+			status: "pending",
+			port: portOverride && pkg === "host" ? portOverride : descriptor?.port ?? descriptor?.defaultPort ?? 0,
+			source: descriptor?.source
+		};
+	});
+}
 
 //#endregion
-export { getProcessConfig, makeDevProcess, spawnDevProcess, spawnRemoteHost };
+export { getProcessStates, makeDevProcess };
 //# sourceMappingURL=orchestrator.mjs.map