wire embedded web UI back into CLI for compiled binaries

Author: RhysSullivan

apps/cli/src/main.ts

@@ -30,6 +30,9 @@ import * as Cause from "effect/Cause";
 import { ExecutorApi } from "@executor/api";
 import { startServer, runMcpStdioServer, getExecutor } from "@executor/local";
 
+// Embedded web UI — baked into compiled binaries via `with { type: "file" }`
+import embeddedWebUI from "./embedded-web-ui.gen";
+
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------
@@ -115,7 +118,9 @@ const makeApiClient = (baseUrl: string) =>
 
 const runForegroundSession = (input: { port: number }) =>
   Effect.gen(function* () {
-    const server = yield* Effect.promise(() => startServer({ port: input.port }));
+    const server = yield* Effect.promise(() =>
+      startServer({ port: input.port, embeddedWebUI }),
+    );
 
     const baseUrl = `http://localhost:${server.port}`;
     console.log(`Executor is ready.`);

apps/local/src/serve.ts

@@ -44,13 +44,30 @@ function collectStaticRoutes(dir: string, prefix = ""): Record<string, ReturnTyp
   return routes;
 }
 
+/**
+ * Convert an embedded web UI map (path → bunfs path) into Bun.serve routes.
+ * The embedded map is generated by the CLI build step using `with { type: "file" }`.
+ */
+function embeddedToStaticRoutes(
+  embedded: Record<string, string>,
+): Record<string, ReturnType<typeof Bun.file>> {
+  const routes: Record<string, ReturnType<typeof Bun.file>> = {};
+  for (const [key, bunfsPath] of Object.entries(embedded)) {
+    routes[`/${key}`] = Bun.file(bunfsPath);
+  }
+  return routes;
+}
+
 // ---------------------------------------------------------------------------
 // Server
 // ---------------------------------------------------------------------------
 
 export interface StartServerOptions {
   port?: number;
+  /** Directory containing built client assets (for dev/disk serving). */
   clientDir?: string;
+  /** Embedded web UI map from compiled binary (path → bunfs path). Overrides clientDir. */
+  embeddedWebUI?: Record<string, string> | null;
 }
 
 export interface ServerInstance {
@@ -63,8 +80,18 @@ export async function startServer(opts: StartServerOptions = {}): Promise<Server
   const clientDir = opts.clientDir ?? resolve(import.meta.dirname, "../dist");
 
   const handlers = await getServerHandlers();
-  const staticRoutes = collectStaticRoutes(clientDir);
-  const indexHtml = Bun.file(join(clientDir, "index.html"));
+
+  // Build static routes from either embedded assets or disk
+  let staticRoutes: Record<string, ReturnType<typeof Bun.file>>;
+  let indexHtml: ReturnType<typeof Bun.file>;
+
+  if (opts.embeddedWebUI) {
+    staticRoutes = embeddedToStaticRoutes(opts.embeddedWebUI);
+    indexHtml = staticRoutes["/index.html"] ?? Bun.file(join(clientDir, "index.html"));
+  } else {
+    staticRoutes = collectStaticRoutes(clientDir);
+    indexHtml = Bun.file(join(clientDir, "index.html"));
+  }
 
   const server = Bun.serve({
     port,