lopata 0.9.0 → 0.10.1

package/README.md

@@ -198,6 +198,43 @@ export default {
 
 Workers can call each other via service bindings configured in their respective `wrangler.jsonc`. Both HTTP (`binding.fetch()`) and RPC (`binding.myMethod()`) modes are supported, including promise pipelining.
 
+### Route patterns
+
+In multi-worker setups, auxiliary workers can use Cloudflare-style `routes` in their `wrangler.jsonc` to handle specific URL patterns. The main worker acts as a fallback for unmatched requests.
+
+```jsonc
+// workers/api/wrangler.jsonc
+{
+	"name": "api-worker",
+	"main": "src/index.ts",
+	"routes": [
+		"example.com/api/*",
+		{ "pattern": "example.com/webhooks/*" }
+	]
+}
+```
+
+Routes support trailing `*` wildcards (`/api/*` matches `/api/foo` and `/api/foo/bar`). When multiple routes match, the most specific one wins (more path segments > fewer, exact match > wildcard). The domain portion is stripped — only the path is matched locally.
+
+### Host-based routing
+
+For routing by hostname (e.g. subdomains), use `hosts` in `lopata.config.ts`:
+
+```ts
+export default {
+	main: './wrangler.jsonc',
+	workers: [
+		{
+			name: 'api-worker',
+			config: './workers/api/wrangler.jsonc',
+			hosts: ['api.localhost', '*.api.localhost'],
+		},
+	],
+}
+```
+
+Wildcard patterns like `*.localhost` match any subdomain. Requests matching a host pattern are routed to that worker regardless of path-based routes.
+
 ## Vite plugin
 
 The Vite plugin is a drop-in replacement for `@cloudflare/vite-plugin`. It provides:

package/dist/dashboard/{chunk-yq8n0mcf.js → chunk-1ekdqbs2.js}

@@ -1142,6 +1142,63 @@ function toError(err) {
   return err instanceof Error ? err : new Error(String(err));
 }
 
+// src/dashboard/components/copy-markdown-button.tsx
+function CopyMarkdownButton({ getMarkdown, title }) {
+  const [copied, setCopied] = d2(false);
+  const timerRef = A2(null);
+  y2(() => {
+    return () => {
+      if (timerRef.current)
+        clearTimeout(timerRef.current);
+    };
+  }, []);
+  const handleCopy = (e3) => {
+    e3.stopPropagation();
+    navigator.clipboard.writeText(getMarkdown()).then(() => {
+      setCopied(true);
+      if (timerRef.current)
+        clearTimeout(timerRef.current);
+      timerRef.current = setTimeout(() => setCopied(false), 1500);
+    });
+  };
+  return /* @__PURE__ */ u3("button", {
+    onClick: handleCopy,
+    class: "rounded-md px-2 py-1 text-xs font-medium text-text-muted hover:text-text-data hover:bg-panel-hover border border-transparent hover:border-border transition-all",
+    title: title ?? "Copy as Markdown",
+    children: copied ? "Copied!" : "Copy MD"
+  }, undefined, false, undefined, this);
+}
+function extractText(v3) {
+  if (v3 == null || v3 === false || v3 === true)
+    return "";
+  if (typeof v3 === "string" || typeof v3 === "number")
+    return String(v3);
+  if (Array.isArray(v3))
+    return v3.map(extractText).join("");
+  if (typeof v3 === "object" && "props" in v3) {
+    const props = v3.props;
+    return extractText(props.children);
+  }
+  return String(v3);
+}
+function tableToMarkdown(headers, rows) {
+  const escape = (v3) => extractText(v3).replace(/\|/g, "\\|").replace(/\n/g, " ");
+  const headerRow = `| ${headers.map(escape).join(" | ")} |`;
+  const separator = `| ${headers.map(() => "---").join(" | ")} |`;
+  const dataRows = rows.map((row) => `| ${row.map(escape).join(" | ")} |`);
+  return [headerRow, separator, ...dataRows].join(`
+`);
+}
+function recordsToMarkdown(headers, rows) {
+  return tableToMarkdown(headers, rows.map((row) => headers.map((h3) => row[h3])));
+}
+function keyValueToMarkdown(data) {
+  const entries = Object.entries(data);
+  if (entries.length === 0)
+    return "";
+  return tableToMarkdown(["Key", "Value"], entries);
+}
+
 // src/dashboard/sql-browser/editable-cell.tsx
 function EditableCell({ value, onSave, foreignKey, onNavigateFK, onInspect, alignRight }) {
   const [editing, setEditing] = d2(false);
@@ -2354,6 +2411,9 @@ function TableDataView({ table, execQuery, onOpenInConsole, history: history2, b
                   }, undefined, true, undefined, this)
                 ]
               }, undefined, true, undefined, this),
+              /* @__PURE__ */ u3(CopyMarkdownButton, {
+                getMarkdown: () => recordsToMarkdown(displayCols, rows)
+              }, undefined, false, undefined, this),
               /* @__PURE__ */ u3("button", {
                 onClick: () => setShowInsert(!showInsert),
                 class: `rounded-md px-3 py-1.5 text-sm font-medium transition-all ${showInsert ? "bg-panel-active text-text-data" : "bg-ink text-surface hover:opacity-80"}`,
@@ -3017,33 +3077,41 @@ function SqlConsoleTab({ execQuery, generateSql, initialSql, history: history2 }
 function ResultTable({ columns, rows }) {
   return /* @__PURE__ */ u3("div", {
     class: "bg-panel rounded-lg border border-border overflow-x-auto",
-    children: /* @__PURE__ */ u3("table", {
-      class: "w-full text-sm",
-      children: [
-        /* @__PURE__ */ u3("thead", {
-          children: /* @__PURE__ */ u3("tr", {
-            class: "border-b border-border-subtle",
-            children: columns.map((col) => /* @__PURE__ */ u3("th", {
-              class: "text-left px-4 py-2.5 font-medium text-xs text-text-muted uppercase tracking-wider font-mono",
-              children: col
-            }, col, false, undefined, this))
-          }, undefined, false, undefined, this)
-        }, undefined, false, undefined, this),
-        /* @__PURE__ */ u3("tbody", {
-          children: rows.map((row, i3) => /* @__PURE__ */ u3("tr", {
-            class: "group border-b border-border-row last:border-0 hover:bg-panel-hover/50 transition-colors",
-            children: columns.map((col) => /* @__PURE__ */ u3("td", {
-              class: "px-4 py-2.5 font-mono text-xs",
-              children: row[col] === null ? /* @__PURE__ */ u3("span", {
-                class: "text-text-dim italic",
-                children: "NULL"
-              }, undefined, false, undefined, this) : String(row[col])
-            }, col, false, undefined, this))
-          }, i3, false, undefined, this))
+    children: [
+      /* @__PURE__ */ u3("div", {
+        class: "flex justify-end px-2 pt-2",
+        children: /* @__PURE__ */ u3(CopyMarkdownButton, {
+          getMarkdown: () => recordsToMarkdown(columns, rows)
         }, undefined, false, undefined, this)
-      ]
-    }, undefined, true, undefined, this)
-  }, undefined, false, undefined, this);
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ u3("table", {
+        class: "w-full text-sm",
+        children: [
+          /* @__PURE__ */ u3("thead", {
+            children: /* @__PURE__ */ u3("tr", {
+              class: "border-b border-border-subtle",
+              children: columns.map((col) => /* @__PURE__ */ u3("th", {
+                class: "text-left px-4 py-2.5 font-medium text-xs text-text-muted uppercase tracking-wider font-mono",
+                children: col
+              }, col, false, undefined, this))
+            }, undefined, false, undefined, this)
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ u3("tbody", {
+            children: rows.map((row, i3) => /* @__PURE__ */ u3("tr", {
+              class: "group border-b border-border-row last:border-0 hover:bg-panel-hover/50 transition-colors",
+              children: columns.map((col) => /* @__PURE__ */ u3("td", {
+                class: "px-4 py-2.5 font-mono text-xs",
+                children: row[col] === null ? /* @__PURE__ */ u3("span", {
+                  class: "text-text-dim italic",
+                  children: "NULL"
+                }, undefined, false, undefined, this) : String(row[col])
+              }, col, false, undefined, this))
+            }, i3, false, undefined, this))
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
 }
 
 // src/dashboard/sql-browser/sql-browser.tsx
@@ -3195,25 +3263,35 @@ function KeyValueTable({ data }) {
       children: "No entries"
     }, undefined, false, undefined, this);
   }
-  return /* @__PURE__ */ u3("table", {
-    class: "w-full text-sm",
-    children: /* @__PURE__ */ u3("tbody", {
-      children: entries.map(([key, value]) => /* @__PURE__ */ u3("tr", {
-        class: "border-b border-border-subtle last:border-0 hover:bg-panel-hover/50 transition-colors",
-        children: [
-          /* @__PURE__ */ u3("td", {
-            class: "px-4 py-2 font-medium text-text-secondary whitespace-nowrap align-top font-mono",
-            style: "width: 1%;",
-            children: key
-          }, undefined, false, undefined, this),
-          /* @__PURE__ */ u3("td", {
-            class: "px-4 py-2 text-ink break-all font-mono",
-            children: value
-          }, undefined, false, undefined, this)
-        ]
-      }, key, true, undefined, this))
-    }, undefined, false, undefined, this)
-  }, undefined, false, undefined, this);
+  return /* @__PURE__ */ u3("div", {
+    children: [
+      /* @__PURE__ */ u3("div", {
+        class: "flex justify-end px-2 pt-1",
+        children: /* @__PURE__ */ u3(CopyMarkdownButton, {
+          getMarkdown: () => keyValueToMarkdown(data)
+        }, undefined, false, undefined, this)
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ u3("table", {
+        class: "w-full text-sm",
+        children: /* @__PURE__ */ u3("tbody", {
+          children: entries.map(([key, value]) => /* @__PURE__ */ u3("tr", {
+            class: "border-b border-border-subtle last:border-0 hover:bg-panel-hover/50 transition-colors",
+            children: [
+              /* @__PURE__ */ u3("td", {
+                class: "px-4 py-2 font-medium text-text-secondary whitespace-nowrap align-top font-mono",
+                style: "width: 1%;",
+                children: key
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ u3("td", {
+                class: "px-4 py-2 text-ink break-all font-mono",
+                children: value
+              }, undefined, false, undefined, this)
+            ]
+          }, key, true, undefined, this))
+        }, undefined, false, undefined, this)
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
 }
 // src/dashboard/components/page-header.tsx
 function PageHeader({ title, subtitle, actions }) {
@@ -3341,30 +3419,38 @@ function StatusBadge({ status, colorMap }) {
 function Table({ headers, rows }) {
   return /* @__PURE__ */ u3("div", {
     class: "bg-panel rounded-lg border border-border overflow-x-auto",
-    children: /* @__PURE__ */ u3("table", {
-      class: "w-full text-sm",
-      children: [
-        /* @__PURE__ */ u3("thead", {
-          children: /* @__PURE__ */ u3("tr", {
-            class: "border-b border-border-subtle",
-            children: headers.map((h3) => /* @__PURE__ */ u3("th", {
-              class: "text-left px-4 py-3 font-mono font-medium text-xs text-text-muted uppercase tracking-wider",
-              children: h3
-            }, h3, false, undefined, this))
-          }, undefined, false, undefined, this)
-        }, undefined, false, undefined, this),
-        /* @__PURE__ */ u3("tbody", {
-          children: rows.map((row, i3) => /* @__PURE__ */ u3("tr", {
-            class: "group border-b border-border-row last:border-0 hover:bg-panel-hover/50 transition-colors",
-            children: row.map((cell, j3) => /* @__PURE__ */ u3("td", {
-              class: "px-4 py-3",
-              children: cell
-            }, j3, false, undefined, this))
-          }, i3, false, undefined, this))
+    children: [
+      /* @__PURE__ */ u3("div", {
+        class: "flex justify-end px-2 pt-2",
+        children: /* @__PURE__ */ u3(CopyMarkdownButton, {
+          getMarkdown: () => tableToMarkdown(headers, rows)
         }, undefined, false, undefined, this)
-      ]
-    }, undefined, true, undefined, this)
-  }, undefined, false, undefined, this);
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ u3("table", {
+        class: "w-full text-sm",
+        children: [
+          /* @__PURE__ */ u3("thead", {
+            children: /* @__PURE__ */ u3("tr", {
+              class: "border-b border-border-subtle",
+              children: headers.map((h3) => /* @__PURE__ */ u3("th", {
+                class: "text-left px-4 py-3 font-mono font-medium text-xs text-text-muted uppercase tracking-wider",
+                children: h3
+              }, h3, false, undefined, this))
+            }, undefined, false, undefined, this)
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ u3("tbody", {
+            children: rows.map((row, i3) => /* @__PURE__ */ u3("tr", {
+              class: "group border-b border-border-row last:border-0 hover:bg-panel-hover/50 transition-colors",
+              children: row.map((cell, j3) => /* @__PURE__ */ u3("td", {
+                class: "px-4 py-3",
+                children: cell
+              }, j3, false, undefined, this))
+            }, i3, false, undefined, this))
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
 }
 // src/dashboard/components/table-link.tsx
 function TableLink({ href, children, mono }) {
@@ -5675,11 +5761,25 @@ function ErrorList() {
               /* @__PURE__ */ u3(RefreshButton, {
                 onClick: () => loadErrors()
               }, undefined, false, undefined, this),
-              errors.length > 0 && /* @__PURE__ */ u3("button", {
-                onClick: handleClear,
-                class: "rounded-md px-3 py-1.5 text-sm font-medium bg-panel border border-border text-text-secondary btn-danger transition-all",
-                children: "Clear all"
-              }, undefined, false, undefined, this)
+              errors.length > 0 && /* @__PURE__ */ u3(k, {
+                children: [
+                  /* @__PURE__ */ u3(CopyMarkdownButton, {
+                    getMarkdown: () => tableToMarkdown(["Source", "Error", "Message", "Context", "Worker", "Time"], errors.map((err) => [
+                      err.source ?? "-",
+                      err.errorName,
+                      err.errorMessage,
+                      err.requestMethod && err.requestUrl ? `${err.requestMethod} ${err.requestUrl}` : "-",
+                      err.workerName ?? "-",
+                      formatTimestamp2(err.timestamp)
+                    ]))
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ u3("button", {
+                    onClick: handleClear,
+                    class: "rounded-md px-3 py-1.5 text-sm font-medium bg-panel border border-border text-text-secondary btn-danger transition-all",
+                    children: "Clear all"
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this)
             ]
           }, undefined, true, undefined, this)
         ]
@@ -5889,11 +5989,20 @@ function ErrorDetailPage({ errorId }) {
               }, undefined, true, undefined, this)
             ]
           }, undefined, true, undefined, this),
-          /* @__PURE__ */ u3("button", {
-            onClick: handleDelete,
-            class: "rounded-md px-3 py-1.5 text-sm font-medium bg-panel border border-border text-text-secondary btn-danger transition-all",
-            children: "Delete"
-          }, undefined, false, undefined, this)
+          /* @__PURE__ */ u3("div", {
+            class: "flex items-center gap-2",
+            children: [
+              /* @__PURE__ */ u3(CopyMarkdownButton, {
+                getMarkdown: () => errorToMarkdown(detail),
+                title: "Copy error as Markdown for LLM"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ u3("button", {
+                onClick: handleDelete,
+                class: "rounded-md px-3 py-1.5 text-sm font-medium bg-panel border border-border text-text-secondary btn-danger transition-all",
+                children: "Delete"
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
         ]
       }, undefined, true, undefined, this),
       /* @__PURE__ */ u3("div", {
@@ -6296,6 +6405,60 @@ function truncateUrl(url) {
     return url.length > 50 ? url.slice(0, 50) + "..." : url;
   }
 }
+function errorToMarkdown(detail) {
+  const { data } = detail;
+  const lines = [];
+  lines.push(`## ${data.error.name}: ${data.error.message}`);
+  if (detail.source)
+    lines.push(`**Source:** ${detail.source}`);
+  if (data.runtime.workerName)
+    lines.push(`**Worker:** ${data.runtime.workerName}`);
+  lines.push("");
+  if (data.error.stack) {
+    lines.push("### Stack Trace");
+    lines.push("```");
+    lines.push(data.error.stack);
+    lines.push("```");
+    lines.push("");
+  }
+  if (data.error.frames.length > 0) {
+    lines.push("### Source Code");
+    for (const frame of data.error.frames) {
+      lines.push(`#### ${frame.file}:${frame.line}:${frame.column}${frame.function ? ` in ${frame.function}` : ""}`);
+      if (frame.source && frame.source.length > 0) {
+        const startLine = frame.line - (frame.sourceLine ?? 0);
+        lines.push("```");
+        frame.source.forEach((line, i3) => {
+          const lineNum = startLine + i3;
+          const marker = i3 === frame.sourceLine ? ">" : " ";
+          lines.push(`${marker} ${lineNum} | ${line}`);
+        });
+        lines.push("```");
+      }
+      lines.push("");
+    }
+  }
+  if (data.request.method && data.request.url) {
+    lines.push("### Request");
+    lines.push(`${data.request.method} ${data.request.url}`);
+    const headers = Object.entries(data.request.headers);
+    if (headers.length > 0) {
+      lines.push("");
+      lines.push(keyValueToMarkdown(data.request.headers));
+    }
+    lines.push("");
+  }
+  if (data.bindings.length > 0) {
+    lines.push("### Bindings");
+    lines.push(tableToMarkdown(["Name", "Type"], data.bindings.map((b) => [b.name, b.type])));
+    lines.push("");
+  }
+  lines.push("### Runtime");
+  lines.push(`- **Bun:** ${data.runtime.bunVersion}`);
+  lines.push(`- **Platform:** ${data.runtime.platform} / ${data.runtime.arch}`);
+  return lines.join(`
+`);
+}
 
 // src/dashboard/views/generations.tsx
 var STATE_COLORS = {
@@ -7861,6 +8024,7 @@ function R2ObjectList({ bucket }) {
 // src/dashboard/views/routes.tsx
 var TYPE_COLORS = {
   route: "bg-emerald-500/15 text-emerald-500",
+  host: "bg-blue-500/15 text-blue-500",
   fallback: "bg-panel-active text-text-data"
 };
 function RoutesView() {
@@ -7886,7 +8050,7 @@ function RoutesView() {
             children: r3.workerName
           }, undefined, false, undefined, this),
           /* @__PURE__ */ u3(StatusBadge, {
-            status: r3.isFallback ? "fallback" : "route",
+            status: r3.isFallback ? "fallback" : r3.type === "host" ? "host" : "route",
             colorMap: TYPE_COLORS
           }, undefined, false, undefined, this)
         ])

package/dist/dashboard/{chunk-csyd2tq2.css → chunk-jzyhpjad.css}

@@ -1756,6 +1756,14 @@
     padding-top: calc(var(--spacing) * .5);
   }
 
+  .pt-1 {
+    padding-top: calc(var(--spacing) * 1);
+  }
+
+  .pt-2 {
+    padding-top: calc(var(--spacing) * 2);
+  }
+
   .pt-3 {
     padding-top: calc(var(--spacing) * 3);
   }

package/dist/dashboard/index.html

@@ -8,7 +8,7 @@
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
   <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600&display=swap" rel="stylesheet" />
   
-<link rel="stylesheet" crossorigin href="/__dashboard/assets/chunk-csyd2tq2.css"><script type="module" crossorigin src="/__dashboard/assets/chunk-yq8n0mcf.js"></script></head>
+<link rel="stylesheet" crossorigin href="/__dashboard/assets/chunk-jzyhpjad.css"><script type="module" crossorigin src="/__dashboard/assets/chunk-1ekdqbs2.js"></script></head>
 <body class="h-full bg-surface text-ink" style="font-family: system-ui, -apple-system, sans-serif;">
   <script>
     // Apply saved theme before first paint to prevent flash

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "lopata",
-	"version": "0.9.0",
+	"version": "0.10.1",
 	"type": "module",
 	"license": "MIT",
 	"repository": {

package/src/api/handlers/routes.ts

@@ -5,6 +5,11 @@ export const handlers = {
 	'routes.list'(_input: {}, ctx: HandlerContext): RouteInfo[] {
 		const routes: RouteInfo[] = []
 
+		// Show host-based routes
+		for (const hr of ctx.hostRoutes) {
+			routes.push({ pattern: hr.pattern, workerName: hr.workerName, isFallback: false, type: 'host' })
+		}
+
 		if (ctx.routeDispatcher) {
 			for (const r of ctx.routeDispatcher.getRegisteredRoutes()) {
 				routes.push({ pattern: r.pattern, workerName: r.workerName, isFallback: false })

package/src/api/index.ts

@@ -6,9 +6,9 @@ import type { WorkerRegistry } from '../worker-registry'
 import { handlePreflight, withCors } from './cors'
 import { dispatch } from './dispatch'
 import { handleR2Download, handleR2Upload } from './r2'
-import type { HandlerContext } from './types'
+import type { HandlerContext, HostRouteInfo } from './types'
 
-const ctx: HandlerContext = { config: null, manager: null, registry: null, lopataConfig: null, routeDispatcher: null }
+const ctx: HandlerContext = { config: null, manager: null, registry: null, lopataConfig: null, routeDispatcher: null, hostRoutes: [] }
 
 export function setDashboardConfig(config: WranglerConfig): void {
 	ctx.config = config
@@ -30,6 +30,10 @@ export function setRouteDispatcher(dispatcher: RouteDispatcher): void {
 	ctx.routeDispatcher = dispatcher
 }
 
+export function setHostRoutes(routes: HostRouteInfo[]): void {
+	ctx.hostRoutes = routes
+}
+
 export function handleApiRequest(request: Request): Response | Promise<Response> {
 	const url = new URL(request.url)
 

package/src/api/types.ts

@@ -382,18 +382,25 @@ import type { LopataConfig } from '../lopata-config'
 import type { RouteDispatcher } from '../route-matcher'
 import type { WorkerRegistry } from '../worker-registry'
 
+export interface HostRouteInfo {
+	pattern: string
+	workerName: string
+}
+
 export interface HandlerContext {
 	config: WranglerConfig | null
 	manager: GenerationManager | null
 	registry: WorkerRegistry | null
 	lopataConfig: LopataConfig | null
 	routeDispatcher: RouteDispatcher | null
+	hostRoutes: HostRouteInfo[]
 }
 
 export interface RouteInfo {
 	pattern: string
 	workerName: string
 	isFallback: boolean
+	type?: 'path' | 'host'
 }
 
 /** Collect configs from all workers (registry) or fall back to single config. */

package/src/cli/dev.ts

@@ -3,7 +3,15 @@ Error.stackTraceLimit = 50
 
 import '../plugin'
 import path from 'node:path'
-import { handleApiRequest, setDashboardConfig, setGenerationManager, setLopataConfig, setRouteDispatcher, setWorkerRegistry } from '../api'
+import {
+	handleApiRequest,
+	setDashboardConfig,
+	setGenerationManager,
+	setHostRoutes,
+	setLopataConfig,
+	setRouteDispatcher,
+	setWorkerRegistry,
+} from '../api'
 import { QueuePullConsumer } from '../bindings/queue'
 import type { AckRequest, PullRequest } from '../bindings/queue'
 import { CFWebSocket } from '../bindings/websocket-pair'
@@ -14,7 +22,7 @@ import { FileWatcher } from '../file-watcher'
 import { GenerationManager } from '../generation-manager'
 import { loadLopataConfig } from '../lopata-config'
 import { addCfProperty } from '../request-cf'
-import { RouteDispatcher } from '../route-matcher'
+import { extractHostname, RouteDispatcher } from '../route-matcher'
 import { getTraceStore } from '../tracing/store'
 import type { TraceEvent } from '../tracing/types'
 import { WorkerRegistry } from '../worker-registry'
@@ -105,7 +113,7 @@ export async function run(ctx: CliContext) {
 					if (routeDispatcher) {
 						try {
 							const freshConfig = await loadConfig(workerDef.config, envFlag)
-							routeDispatcher.addRoutes(freshConfig, auxManager, workerDef.name)
+							routeDispatcher.addRoutes(freshConfig, auxManager, workerDef.name, workerDef.hosts)
 						} catch (err) {
 							console.warn(`[lopata] Failed to re-read config for "${workerDef.name}" routes:`, err)
 						}
@@ -130,18 +138,36 @@ export async function run(ctx: CliContext) {
 			)
 		}
 
-		// Build route dispatcher for route-based worker selection (aux workers only — main is the fallback)
+		// Build route dispatcher (aux workers only — main is the fallback)
 		routeDispatcher = new RouteDispatcher(mainManager)
 		for (const workerDef of lopataConfig.workers ?? []) {
-			const auxConfig = auxConfigs.get(workerDef.name)
 			const auxMgr = registry.getManager(workerDef.name)
-			if (auxConfig && auxMgr) routeDispatcher.addRoutes(auxConfig, auxMgr, workerDef.name)
+			if (!auxMgr) continue
+			const auxConfig = auxConfigs.get(workerDef.name)
+			if (auxConfig) routeDispatcher.addRoutes(auxConfig, auxMgr, workerDef.name, workerDef.hosts)
+			// Workers with hosts but no wrangler routes still need a catch-all entry
+			if (workerDef.hosts && (!auxConfig?.routes || auxConfig.routes.length === 0)) {
+				routeDispatcher.addHostWorker(auxMgr, workerDef.name, workerDef.hosts)
+			}
 		}
 		if (routeDispatcher.hasRoutes()) {
 			for (const r of routeDispatcher.getRegisteredRoutes()) {
-				console.log(`[lopata] Route: ${r.pattern} → ${r.workerName}`)
+				const hostInfo = r.hostPatterns ? ` (hosts: ${r.hostPatterns.join(', ')})` : ''
+				console.log(`[lopata] Route: ${r.pattern} → ${r.workerName}${hostInfo}`)
+			}
+		}
+
+		// Expose host routes to the dashboard API
+		const hostRoutes: Array<{ pattern: string; workerName: string }> = []
+		for (const workerDef of lopataConfig.workers ?? []) {
+			if (!workerDef.hosts) continue
+			for (const host of workerDef.hosts) {
+				hostRoutes.push({ pattern: host, workerName: workerDef.name })
 			}
 		}
+		if (hostRoutes.length > 0) {
+			setHostRoutes(hostRoutes)
+		}
 
 		manager = mainManager
 		setGenerationManager(manager)
@@ -256,8 +282,9 @@ export async function run(ctx: CliContext) {
 				return gen.callScheduled(cronExpr)
 			}
 
-			// Delegate to active generation (route-based dispatch in multi-worker mode)
-			const targetManager = routeDispatcher ? routeDispatcher.resolve(url.pathname) : manager
+			// Delegate to active generation (host + route dispatch in multi-worker mode)
+			const reqHostname = extractHostname(request.headers.get('host') ?? '')
+			const targetManager = routeDispatcher ? routeDispatcher.resolve(url.pathname, reqHostname) : manager
 			const gen = targetManager.active
 			if (!gen) {
 				return new Response('No active generation', { status: 503 })

package/src/lopata-config.ts

@@ -8,6 +8,7 @@ export interface LopataConfig {
 	workers?: Array<{
 		name: string
 		config: string
+		hosts?: string[]
 	}>
 	/** Enable real cron scheduling based on wrangler triggers.crons (default: false) */
 	cron?: boolean

package/src/route-matcher.ts

@@ -61,6 +61,22 @@ export function matchRoute(pathname: string, pattern: string): boolean {
 	return pathname === pattern
 }
 
+/** Extract hostname from a Host header value, stripping the port if present. */
+export function extractHostname(hostHeader: string): string {
+	return hostHeader.split(':')[0] ?? ''
+}
+
+/** Match a hostname against a host pattern. Supports exact match and `*.domain` wildcards. */
+export function matchHost(hostname: string, pattern: string): boolean {
+	if (pattern === hostname) return true
+	if (pattern.startsWith('*.')) {
+		const suffix = pattern.slice(1) // ".localhost"
+		// Must have a subdomain — bare hostname doesn't match *.localhost
+		return hostname.endsWith(suffix) && hostname.length > suffix.length
+	}
+	return false
+}
+
 /** Count the number of path segments in a pattern (ignoring trailing wildcard). */
 function segmentCount(pattern: string): number {
 	const clean = pattern.replace(/\/?\*$/, '')
@@ -72,6 +88,8 @@ interface RouteEntry {
 	pattern: string
 	workerName: string
 	manager: RoutableManager
+	/** When set, this route only matches requests whose hostname matches one of these patterns. */
+	hostPatterns?: string[]
 }
 
 /**
@@ -90,7 +108,7 @@ export class RouteDispatcher {
 		this.fallback = fallback
 	}
 
-	addRoutes(config: WranglerConfig, manager: RoutableManager, workerName: string): void {
+	addRoutes(config: WranglerConfig, manager: RoutableManager, workerName: string, hostPatterns?: string[]): void {
 		if (!config.routes) return
 
 		// Clear existing routes for this worker to support re-registration (e.g. config reload)
@@ -116,8 +134,8 @@ export class RouteDispatcher {
 				console.warn(`[lopata] Warning: route pattern "${pattern}" has a wildcard not at the end — Cloudflare only supports trailing wildcards`)
 			}
 
-			// Skip duplicate patterns from different workers (first registered wins)
-			const existing = this.routes.find(r => r.pattern === pattern)
+			// Skip duplicate patterns from different workers when they share the same host scope (first registered wins)
+			const existing = this.routes.find(r => r.pattern === pattern && !r.hostPatterns && !hostPatterns)
 			if (existing) {
 				console.warn(
 					`[lopata] Warning: route pattern "${pattern}" is already registered by "${existing.workerName}" — skipping duplicate from "${workerName}"`,
@@ -125,11 +143,19 @@ export class RouteDispatcher {
 				continue
 			}
 
-			this.routes.push({ pattern, workerName, manager })
+			this.routes.push({ pattern, workerName, manager, hostPatterns })
 			this.sorted = false
 		}
 	}
 
+	/** Register a worker that handles all paths for the given host patterns (no wrangler routes needed). */
+	addHostWorker(manager: RoutableManager, workerName: string, hostPatterns: string[]): void {
+		// Clear existing routes for this worker to support re-registration
+		this.routes = this.routes.filter(r => r.workerName !== workerName)
+		this.routes.push({ pattern: '/*', workerName, manager, hostPatterns })
+		this.sorted = false
+	}
+
 	removeWorkerRoutes(workerName: string): void {
 		this.routes = this.routes.filter(r => r.workerName !== workerName)
 	}
@@ -155,9 +181,13 @@ export class RouteDispatcher {
 		this.sorted = true
 	}
 
-	resolve(pathname: string): RoutableManager {
+	resolve(pathname: string, hostname?: string): RoutableManager {
 		this.ensureSorted()
 		for (const entry of this.routes) {
+			// If route has host constraints, skip unless hostname matches one of them
+			if (entry.hostPatterns) {
+				if (hostname === undefined || !entry.hostPatterns.some(hp => matchHost(hostname, hp))) continue
+			}
 			if (matchRoute(pathname, entry.pattern)) {
 				return entry.manager
 			}
@@ -174,8 +204,8 @@ export class RouteDispatcher {
 		return this.routes.length > 0
 	}
 
-	getRegisteredRoutes(): Array<{ pattern: string; workerName: string }> {
+	getRegisteredRoutes(): Array<{ pattern: string; workerName: string; hostPatterns?: string[] }> {
 		this.ensureSorted()
-		return this.routes.map(r => ({ pattern: r.pattern, workerName: r.workerName }))
+		return this.routes.map(r => ({ pattern: r.pattern, workerName: r.workerName, hostPatterns: r.hostPatterns }))
 	}
 }

package/src/vite-plugin/dev-server-plugin.ts

@@ -2,12 +2,13 @@ import type { IncomingMessage, ServerResponse } from 'node:http'
 import { dirname, resolve } from 'node:path'
 import type { Plugin, ViteDevServer } from 'vite'
 import { FileWatcher } from '../file-watcher.ts'
-import { RouteDispatcher } from '../route-matcher.ts'
+import type { RoutableManager } from '../route-matcher.ts'
+import { extractHostname, RouteDispatcher } from '../route-matcher.ts'
 
 interface DevServerPluginOptions {
 	configPath?: string
 	envName: string
-	auxiliaryWorkers?: { configPath: string; name?: string }[]
+	auxiliaryWorkers?: { configPath: string; name?: string; hosts?: string[] }[]
 }
 
 /**
@@ -203,6 +204,21 @@ export function devServerPlugin(options: DevServerPluginOptions): Plugin {
 		}
 	}
 
+	/**
+	 * Resolve an auxiliary worker for the given request.
+	 * Returns null if the request should be handled by the main worker.
+	 */
+	function resolveAuxWorker(req: IncomingMessage, url: string): { manager: RoutableManager; workerName: string } | null {
+		if (!routeDispatcher) return null
+		const parsedUrl = new URL(url, 'http://localhost')
+		const hostname = extractHostname(req.headers.host ?? '')
+		const targetManager = routeDispatcher.resolve(parsedUrl.pathname, hostname)
+		if (!routeDispatcher.isFallback(targetManager)) {
+			return { manager: targetManager, workerName: (targetManager as any).config?.name ?? 'aux' }
+		}
+		return null
+	}
+
 	return {
 		name: 'lopata:dev-server',
 
@@ -385,7 +401,7 @@ export function devServerPlugin(options: DevServerPluginOptions): Plugin {
 							if (routeDispatcher) {
 								try {
 									const freshConfig = await configMod.loadConfig(auxConfigPath)
-									routeDispatcher.addRoutes(freshConfig, auxManager, workerName)
+									routeDispatcher.addRoutes(freshConfig, auxManager, workerName, workerDef.hosts)
 								} catch (err) {
 									console.warn(`[lopata:vite] Failed to re-read config for "${workerName}" routes:`, err)
 								}
@@ -407,20 +423,40 @@ export function devServerPlugin(options: DevServerPluginOptions): Plugin {
 					)
 				}
 
-				// Build route dispatcher for aux workers with routes (main worker is the fallback)
+				// Build route dispatcher (aux workers only — main is the fallback)
 				routeDispatcher = new RouteDispatcher(mainAdapter)
 				for (const workerDef of options.auxiliaryWorkers) {
 					const cached = auxConfigs.get(workerDef.configPath)
 					if (!cached) continue
 					const auxMgr = workerRegistry.getManager(cached.name)
-					if (auxMgr) routeDispatcher.addRoutes(cached.config, auxMgr, cached.name)
+					if (!auxMgr) continue
+					routeDispatcher.addRoutes(cached.config, auxMgr, cached.name, workerDef.hosts)
+					// Workers with hosts but no wrangler routes still need a catch-all entry
+					if (workerDef.hosts && (!cached.config.routes || cached.config.routes.length === 0)) {
+						routeDispatcher.addHostWorker(auxMgr, cached.name, workerDef.hosts)
+					}
 				}
 				if (routeDispatcher.hasRoutes()) {
 					for (const r of routeDispatcher.getRegisteredRoutes()) {
-						console.log(`[lopata:vite] Route: ${r.pattern} → ${r.workerName}`)
+						const hostInfo = r.hostPatterns ? ` (hosts: ${r.hostPatterns.join(', ')})` : ''
+						console.log(`[lopata:vite] Route: ${r.pattern} → ${r.workerName}${hostInfo}`)
 					}
 				}
 				apiMod.setRouteDispatcher(routeDispatcher)
+
+				// Expose host routes to the dashboard API
+				const hostRoutes: Array<{ pattern: string; workerName: string }> = []
+				for (const workerDef of options.auxiliaryWorkers) {
+					if (!workerDef.hosts) continue
+					const cached = auxConfigs.get(workerDef.configPath)
+					if (!cached) continue
+					for (const host of workerDef.hosts) {
+						hostRoutes.push({ pattern: host, workerName: cached.name })
+					}
+				}
+				if (hostRoutes.length > 0) {
+					apiMod.setHostRoutes(hostRoutes)
+				}
 			}
 
 			// 5. Set up WebSocket trace streaming on httpServer
@@ -471,26 +507,25 @@ export function devServerPlugin(options: DevServerPluginOptions): Plugin {
 						return
 					}
 
-					// Route-based dispatch: if an aux worker matches, use its GenerationManager directly
-					if (routeDispatcher) {
-						const parsedUrl = new URL(url, 'http://localhost')
-						const targetManager = routeDispatcher.resolve(parsedUrl.pathname)
-						// If the resolved manager is not the main adapter, dispatch via aux worker
-						if (!routeDispatcher.isFallback(targetManager)) {
-							const gen = targetManager.active
+					// Aux worker dispatch: host-based first, then route-based
+					{
+						const resolved = resolveAuxWorker(req, url)
+						if (resolved) {
+							const gen = resolved.manager.active
 							if (!gen) {
 								if (!res.headersSent) {
 									res.writeHead(503, { 'content-type': 'text/plain' })
-									res.end('No active generation for matched route')
+									res.end('No active generation')
 								}
 								return
 							}
 							try {
 								const request = nodeReqToRequest(req)
+								const parsedUrl = new URL(request.url)
 								const response = await (startSpan as Function)({
 									name: `${request.method} ${parsedUrl.pathname}`,
 									kind: 'server',
-									attributes: { 'http.method': request.method, 'http.url': request.url, 'lopata.worker': (targetManager as any).config?.name ?? 'aux' },
+									attributes: { 'http.method': request.method, 'http.url': request.url, 'lopata.worker': resolved.workerName },
 								}, async () => {
 									const resp = await gen.callFetch(request, null) as Response
 									;(setSpanAttribute as Function)('http.status_code', resp.status)
@@ -655,37 +690,35 @@ export function devServerPlugin(options: DevServerPluginOptions): Plugin {
 			const request = nodeReqToRequest(req)
 			const parsedUrl = new URL(request.url)
 
-			// Route-based dispatch: if an aux worker matches, delegate the WebSocket upgrade to it
-			if (routeDispatcher) {
-				const targetManager = routeDispatcher.resolve(parsedUrl.pathname)
-				if (!routeDispatcher.isFallback(targetManager)) {
-					const gen = targetManager.active
-					if (!gen) {
-						socket.destroy()
-						return
-					}
-					const response = await (startSpan as Function)({
-						name: `WS ${parsedUrl.pathname}`,
-						kind: 'server',
-						attributes: {
-							'http.method': 'GET',
-							'http.url': request.url,
-							'lopata.worker': (targetManager as any).config?.name ?? 'aux',
-							'lopata.websocket': true,
-						},
-					}, async () => {
-						return gen.callFetch(request, null) as Promise<Response & { webSocket?: InstanceType<typeof CFWebSocket> }>
-					}) as Response & { webSocket?: InstanceType<typeof CFWebSocket> }
-					const cfSocket = response.webSocket
-					if (response.status !== 101 || !cfSocket || !(cfSocket instanceof CFWebSocket)) {
-						socket.destroy()
-						return
-					}
-					wss.handleUpgrade(req, socket, head, (ws: any) => {
-						bridgeCfWebSocket(cfSocket, ws)
-					})
+			// Aux worker dispatch for WebSocket: host-based first, then route-based
+			const resolved = resolveAuxWorker(req, req.url ?? '/')
+			if (resolved) {
+				const gen = resolved.manager.active
+				if (!gen) {
+					socket.destroy()
+					return
+				}
+				const response = await (startSpan as Function)({
+					name: `WS ${parsedUrl.pathname}`,
+					kind: 'server',
+					attributes: {
+						'http.method': 'GET',
+						'http.url': request.url,
+						'lopata.worker': resolved.workerName,
+						'lopata.websocket': true,
+					},
+				}, async () => {
+					return gen.callFetch(request, null) as Promise<Response & { webSocket?: InstanceType<typeof CFWebSocket> }>
+				}) as Response & { webSocket?: InstanceType<typeof CFWebSocket> }
+				const cfSocket = response.webSocket
+				if (response.status !== 101 || !cfSocket || !(cfSocket instanceof CFWebSocket)) {
+					socket.destroy()
 					return
 				}
+				wss.handleUpgrade(req, socket, head, (ws: any) => {
+					bridgeCfWebSocket(cfSocket, ws)
+				})
+				return
 			}
 
 			const activeModule = await ensureWorkerModule()

package/src/vite-plugin/index.ts

@@ -11,7 +11,7 @@ export interface LopataPluginConfig {
 	/** Vite environment name for SSR. Default: "ssr" */
 	viteEnvironment?: { name?: string }
 	/** Auxiliary workers loaded via native Bun import (not through Vite). */
-	auxiliaryWorkers?: { configPath: string; name?: string }[]
+	auxiliaryWorkers?: { configPath: string; name?: string; hosts?: string[] }[]
 }
 
 /**

package/src/vite-plugin/modules-plugin.ts

@@ -68,6 +68,9 @@ export class RpcTarget {
     this[Symbol.for("lopata.RpcTarget")] = true;
   }
 }
+export function waitUntil(promise) {
+  // Shim for build — at runtime, the real cloudflare:workers module provides this.
+}
 `
 			}