EdgeStream
EdgeStream Dev Tools Overview
The EdgeStream Dev Tools app (edge-stream-dev-tools) is a full-featured React application for debugging, monitoring, and testing EdgeStream deployments. It connects to any EdgeStream server via SignalR and provides real-time pipeline visibility.
What Dev Tools Provides
| Section | Route | Purpose |
|---|---|---|
| Servers | /servers | Server dashboard — connected servers, transport status, pipeline summary |
| Chat | /chat | Live chat window using the EdgeStream connection |
| Event Stream | /events | Raw event viewer — all messages arriving on the connection |
| Activity Stream | /activity-stream | ActivityStreamMonitor with full filtering, export, timeline |
| Node Explorer (ANCP) | /ancp | ANCP node graph — live agent-to-node message flows |
| Pipelines | /pipelines | Pipeline manager — view and configure hooks per server |
| Hook Execution | /hooks | HooksMonitor — real-time hook invocation log |
| Subscriber Delivery | /subscribers | SubscribersMonitor — real-time delivery log |
| Available Hooks | /hooks-reference | Hook library reference — all built-in hooks with docs |
| Available Subscribers | /subscribers-reference | Subscriber library reference |
| Demo | /demo | Interactive demo — send test messages, observe pipeline |
| Help | /help/* | In-app documentation for hooks, subscribers, pipelines |
Connection Flow
DevTools starts disconnected. The QuickStartPanel prompts for server URL, server type, and auth token before connecting:
// User fills in QuickStartPanel:
// Server URL: https://localhost:10001
// Server Type: bas (or chat)
// Access Token: (JWT from your auth system)
// User Name: (optional — for chat)
// DevTools connects:
streamInstance.registerServer({
id: 'bas',
type: 'bas',
url: 'https://localhost:10001/hubs/edge-stream',
transportConfig: {
type: 'signalr',
url: 'https://localhost:10001/hubs/edge-stream',
accessToken: jwtToken,
},
});Default URL
// Default API base URL (configurable via VITE_API_BASE_URL env var):
const apiBaseUrl = import.meta.env.VITE_API_BASE_URL ?? 'https://localhost:10001';
// SignalR hub URL derived:
const hubUrl = `${apiBaseUrl}/hubs/edge-stream`;
Dev Tools Is a React App
Dev Tools is a standalone Vite + React application in
apps/edge-stream-dev-tools/. It uses EdgeStreamProvider and all standard React bindings. The same patterns it demonstrates can be applied in your own application.