@agi-cli/web-ui 0.1.56 → 0.1.58

package/README.md

@@ -35,17 +35,21 @@ import { serveWebUI } from '@agi-cli/web-ui';
 
 Bun.serve({
   port: 3000,
+  idleTimeout: 240, // IMPORTANT: prevents SSE timeout
   fetch: serveWebUI({ prefix: '/ui' })
 });
 
 console.log('Web UI: http://localhost:3000/ui');
 ```
 
+> **⚠️ Important**: Always set `idleTimeout: 240` (or higher) in `Bun.serve()` to prevent SSE connection timeouts. The web UI uses Server-Sent Events for real-time streaming, and Bun's default timeout of 10 seconds will cause connections to drop.
+
 That's it! The web UI will be available at `/ui` with:
 - ✅ Automatic SPA routing
 - ✅ Asset path handling (both `/ui/assets/*` and `/assets/*`)
 - ✅ Proper MIME types
 - ✅ 404 fallbacks
+- ✅ Real-time SSE streaming
 
 ### With Custom Routes
 
@@ -109,6 +113,44 @@ Bun.serve({
 console.log('Web UI: http://localhost:3000/admin');
 ```
 
+### Custom Server URL
+
+When serving both the API and web UI from the same server, you can configure the web UI to connect to your server instead of the default `localhost:9100`:
+
+```typescript
+import { createApp } from '@agi-cli/server';
+import { serveWebUI } from '@agi-cli/web-ui';
+
+const port = parseInt(process.env.PORT || '3000', 10);
+const host = process.env.HOST || '127.0.0.1';
+
+const app = createApp();
+const handleWebUI = serveWebUI({
+  prefix: '/ui',
+  serverUrl: `http://${host}:${port}`, // Explicit server URL
+});
+
+// Or let it auto-detect (recommended for same-server setup):
+// const handleWebUI = serveWebUI({ prefix: '/ui' });
+
+const server = Bun.serve({
+  port,
+  hostname: host,
+  async fetch(req) {
+    // Serve web UI first
+    const webUIResponse = await handleWebUI(req);
+    if (webUIResponse) return webUIResponse;
+
+    // Then API routes
+    return app.fetch(req);
+  },
+});
+
+console.log(`Server: http://${host}:${server.port}/ui`);
+```
+
+> **Note:** If you don't specify `serverUrl`, the web UI will automatically detect the server URL from the incoming request. This is recommended when serving both the API and UI from the same server.
+
 ## API Reference
 
 ### `serveWebUI(options?): (req: Request) => Promise<Response | null>`
@@ -122,6 +164,7 @@ Creates a request handler that serves the web UI.
 | `prefix` | `string` | `'/ui'` | URL prefix for the web UI |
 | `redirectRoot` | `boolean` | `false` | Redirect `/` to the prefix |
 | `onNotFound` | `(req: Request) => Response \| null` | `null` | Custom 404 handler |
+| `serverUrl` | `string` | Auto-detected | API server URL for the web UI to connect to. If not provided, auto-detects from request (e.g., `http://localhost:3000`) |
 
 **Returns:** A request handler function that returns:
 - `Response` if the request matches a web UI route

package/dist/index.d.ts

@@ -25,6 +25,13 @@ export interface ServeWebUIOptions {
      * Custom 404 handler
      */
     onNotFound?: (req: Request) => Response | Promise<Response> | null;
+    /**
+     * API server URL for the web UI to connect to
+     * If not provided, will attempt to auto-detect from the request
+     * or fall back to localhost:9100
+     * @example 'http://localhost:3000', 'https://api.example.com'
+     */
+    serverUrl?: string;
 }
 /**
  * Create a request handler for serving the web UI

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAa1C;AAED,MAAM,WAAW,iBAAiB;IACjC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;CACnE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,IAMrB,KAAK,OAAO,KAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAsG3E;;;;;;;AAyBD,wBAKE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAa1C;AAED,MAAM,WAAW,iBAAiB;IACjC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAEnE;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,IAWrB,KAAK,OAAO,KAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAkJ3E;;;;;;;AAyBD,wBAKE"}