feat: Add WebRTC signaling and peer connection support

.github/workflows/package-smoke-test.yaml

@@ -326,7 +326,7 @@ jobs:
 
    playwright-e2e-test:
       runs-on: blacksmith-4vcpu-ubuntu-2204
-      timeout-minutes: 10
+      timeout-minutes: 15
       name: Playwright E2E Smoke Test
       steps:
          - uses: actions/checkout@v4
@@ -346,8 +346,11 @@ jobs:
          - name: Install SDK in e2e-web
            run: bash scripts/install-sdk-tarballs.sh apps/testing/e2e-web
 
+         # No explicit build step needed: playwright.config.ts webServer starts
+         # "bun run dev" which compiles on-the-fly via Vite. A production build
+         # would be redundant since e2e tests run against the dev server.
          - name: Run Playwright E2E tests
-           run: bash scripts/test-e2e.sh
+           run: bun run test:e2e
 
          # TODO: Re-enable after artifact storage quota resets (disabled 2026-02-01)
          # - name: Upload Playwright report

AGENTS.md

@@ -14,17 +14,23 @@
 
 Bun workspaces monorepo with packages in `packages/`:
 
-| Package      | Runtime  | Description                                  |
-| ------------ | -------- | -------------------------------------------- |
-| `core`       | Node/Bun | Shared types and utilities (publish first)   |
-| `schema`     | Any      | Schema validation (StandardSchema v1)        |
-| `server`     | Node/Bun | Runtime-agnostic server utilities            |
-| `runtime`    | Bun      | Hono-based server runtime with OpenTelemetry |
-| `react`      | Browser  | React hooks for agents                       |
-| `frontend`   | Browser  | Framework-agnostic web utilities             |
-| `auth`       | Both     | Authentication providers (Clerk, etc.)       |
-| `cli`        | Bun      | CLI framework with commander.js              |
-| `test-utils` | Test     | Private test helpers (never published)       |
+| Package      | Runtime  | Description                                           |
+| ------------ | -------- | ----------------------------------------------------- |
+| `core`       | Node/Bun | Shared types and utilities (publish first)            |
+| `schema`     | Any      | Schema validation (StandardSchema v1)                 |
+| `server`     | Node/Bun | Runtime-agnostic server utilities                     |
+| `runtime`    | Bun      | Hono-based server runtime with WebRTC signaling       |
+| `react`      | Browser  | React hooks for agents and WebRTC                     |
+| `frontend`   | Browser  | Framework-agnostic web utilities with WebRTC manager  |
+| `auth`       | Both     | Authentication providers (Clerk, etc.)                |
+| `cli`        | Bun      | CLI framework with commander.js                       |
+| `postgres`   | Node/Bun | Resilient PostgreSQL client with auto-reconnection    |
+| `drizzle`    | Node/Bun | Drizzle ORM integration with resilient connections    |
+| `evals`      | Any      | Reusable evaluation presets                           |
+| `opencode`   | Bun      | Opencoder agent plugins for Agentuity                 |
+| `workbench`  | Browser  | Workbench UI component for agent testing              |
+| `vscode`     | Node     | VS Code extension for Agentuity                       |
+| `test-utils` | Test     | Private test helpers (never published)                |
 
 ## Code Style
 

README.md

@@ -48,11 +48,11 @@ The structure of this mono repository:
 - `packages/core` - Shared utilities used by most packages
 - `packages/drizzle` - Drizzle ORM integration with resilient PostgreSQL connections
 - `packages/evals` - Reusable Evaluation Presets
-- `packages/frontend` - Reusable code for web frontends
+- `packages/frontend` - Reusable code for web frontends including WebRTC peer connections
 - `packages/opencode` - Opencoder agent plugins for Agentuity
 - `packages/postgres` - Resilient PostgreSQL client with automatic reconnection
-- `packages/react` - React package for the Browser
-- `packages/runtime` - Server-side package for the Agent runtime
+- `packages/react` - React package for the Browser including WebRTC hooks
+- `packages/runtime` - Server-side package for the Agent runtime with WebRTC signaling
 - `packages/schema` - Schema validation library similar to zod and arktype
 - `packages/server` - Runtime-agnostic server-side SDK (Node.js & Bun)
 - `packages/test-utils` - Internal test utilities that can be used by packages

apps/testing/e2e-web/.vscode/settings.json

@@ -0,0 +1,16 @@
+{
+  "search.exclude": {
+    "**/.git/**": true,
+    "**/node_modules/**": true,
+    "**/bun.lock": true,
+    "**/.agentuity/**": true
+  },
+  "json.schemas": [
+    {
+      "fileMatch": [
+        "agentuity.json"
+      ],
+      "url": "https://agentuity.dev/schema/cli/v1/agentuity.json"
+    }
+  ]
+}

apps/testing/e2e-web/src/api/index.ts

@@ -1,8 +1,11 @@
-import { createRouter } from '@agentuity/runtime';
+import { createRouter, webrtc } from '@agentuity/runtime';
 import hello from '../agent/hello/agent';
 
 const api = createRouter();
 
+// WebRTC signaling endpoint for E2E tests
+api.get('/webrtc/signal', webrtc({ maxPeers: 10 }));
+
 api.post('/hello', hello.validator(), async (c) => {
 	const data = c.req.valid('json');
 	const result = await hello.run(data);

apps/testing/e2e-web/src/generated/routes.ts

@@ -119,6 +119,12 @@ declare module '@agentuity/frontend' {
 				stream: false;
 				params: { userId: string };
 			};
+	'GET /api/webrtc/signal': {
+				inputSchema: never;
+				outputSchema: never;
+				stream: false;
+				params: never;
+			};
 	}
 
 	/**
@@ -200,6 +206,14 @@ declare module '@agentuity/frontend' {
 				get: { input: never; output: never; type: 'api'; params: { userId: string }; paramsTuple: [string] };
 			};
 		};
+		webrtc: {
+			signal: {
+				/**
+				 * Route: GET /api/webrtc/signal
+				 */
+				get: { input: never; output: never; type: 'api'; params: never; paramsTuple: [] };
+			};
+		};
 	}
 }
 
@@ -231,6 +245,12 @@ declare module '@agentuity/react' {
 				stream: false;
 				params: { userId: string };
 			};
+	'GET /api/webrtc/signal': {
+				inputSchema: never;
+				outputSchema: never;
+				stream: false;
+				params: never;
+			};
 	}
 	export interface WebSocketRouteRegistry {
 	'/api/echo': {
@@ -293,6 +313,14 @@ declare module '@agentuity/react' {
 				get: { input: never; output: never; type: 'api'; params: { userId: string }; paramsTuple: [string] };
 			};
 		};
+		webrtc: {
+			signal: {
+				/**
+				 * Route: GET /api/webrtc/signal
+				 */
+				get: { input: never; output: never; type: 'api'; params: never; paramsTuple: [] };
+			};
+		};
 	}
 }
 
@@ -352,6 +380,14 @@ const _rpcRouteMetadata = {
 								]
 						}
 				}
+		},
+		"webrtc": {
+				"signal": {
+						"get": {
+								"type": "api",
+								"path": "/api/webrtc/signal"
+						}
+				}
 		}
 } as const;
 

apps/testing/e2e-web/src/web/App.tsx

@@ -5,6 +5,7 @@ import { RpcPage } from './RpcPage';
 import { RpcTestPage } from './RpcTestPage';
 import { PathParamsPage } from './PathParamsPage';
 import { AnalyticsTestPage } from './AnalyticsTestPage';
+import { WebRTCTestPage } from './WebRTCTestPage';
 
 const WORKBENCH_PATH = process.env.AGENTUITY_PUBLIC_WORKBENCH_PATH;
 
@@ -32,6 +33,10 @@ export function App() {
 		return <AnalyticsTestPage />;
 	}
 
+	if (path === '/webrtc') {
+		return <WebRTCTestPage />;
+	}
+
 	const [name, setName] = useState('World');
 	const { data: greeting, invoke, isLoading: running } = useAPI('POST /api/hello');