@backendkit-labs/agent-web 0.1.0

package/README.md

@@ -0,0 +1,62 @@
+# @backendkit-labs/agent-web
+
+HTTP/WebSocket server layer for [@backendkit-labs/agent-core](https://www.npmjs.com/package/@backendkit-labs/agent-core).
+
+Wraps `AgentEngine` in a Fastify 5 server and exposes it to browsers via WebSocket with streaming, multi-session management, and a real-time monitor bus.
+
+## Install
+
+```bash
+npm install @backendkit-labs/agent-web @backendkit-labs/agent-core
+```
+
+## Quick start
+
+```typescript
+import { AgentServer } from '@backendkit-labs/agent-web';
+import type { EngineFactory } from '@backendkit-labs/agent-web';
+import { AgentEngine, AgentRegistry, ToolRegistry, ProviderRegistry } from '@backendkit-labs/agent-core';
+
+const engineFactory: EngineFactory = (sessionId, transport) =>
+  new AgentEngine({ transport, /* ...your config */ });
+
+const server = new AgentServer({
+  port: 3000,
+  engineFactory,
+  cors: '*',
+});
+
+await server.start();
+// WS /chat       — chat sessions
+// WS /monitor    — real-time observer (read-only)
+// GET /health    — { status, sessions, monitors }
+// GET /sessions  — active session list
+```
+
+## WebSocket protocol
+
+**Client → server** (`/chat`):
+```json
+{ "type": "input",  "content": "Your message" }
+{ "type": "abort" }
+```
+
+**Server → client** — standard `AgentEvent` JSON frames: `token`, `tool_call`, `tool_result`, `agent_switch`, `block_start`, `done`, `error`, etc.
+
+## Monitor bus
+
+Connect to `WS /monitor` to observe all sessions in real time (read-only):
+
+```json
+{ "type": "monitor_hello",         "sessionIds": ["..."] }
+{ "type": "monitor_session_open",  "sessionId": "..." }
+{ "type": "monitor_session_close", "sessionId": "..." }
+{ "sessionId": "...", "type": "run_input", "content": "..." }
+{ "sessionId": "...", "type": "token", "content": "..." }
+```
+
+Use with [`@backendkit-labs/agent-web-ui`](https://www.npmjs.com/package/@backendkit-labs/agent-web-ui) for a ready-made React chat + kanban monitor UI.
+
+## License
+
+MIT

package/client/index.html

@@ -0,0 +1,418 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>BackendKit Agent</title>
+  <style>
+    * { box-sizing: border-box; margin: 0; padding: 0; }
+
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+      background: #0f0f0f;
+      color: #e8e8e8;
+      height: 100dvh;
+      display: flex;
+      flex-direction: column;
+    }
+
+    #header {
+      padding: 12px 20px;
+      border-bottom: 1px solid #2a2a2a;
+      display: flex;
+      align-items: center;
+      gap: 12px;
+      background: #161616;
+    }
+
+    #header h1 { font-size: 15px; font-weight: 600; }
+
+    #agent-badge {
+      font-size: 12px;
+      padding: 2px 8px;
+      border-radius: 999px;
+      background: #2a2a2a;
+      color: #999;
+    }
+
+    #status-dot {
+      width: 8px; height: 8px;
+      border-radius: 50%;
+      background: #555;
+      margin-left: auto;
+    }
+    #status-dot.connected { background: #22c55e; }
+    #status-dot.thinking  { background: #f59e0b; animation: pulse 1s infinite; }
+
+    @keyframes pulse {
+      0%, 100% { opacity: 1; }
+      50%       { opacity: 0.3; }
+    }
+
+    #messages {
+      flex: 1;
+      overflow-y: auto;
+      padding: 20px;
+      display: flex;
+      flex-direction: column;
+      gap: 16px;
+    }
+
+    .msg {
+      max-width: 720px;
+      width: 100%;
+      align-self: flex-start;
+    }
+
+    .msg.user {
+      align-self: flex-end;
+    }
+
+    .msg-bubble {
+      padding: 10px 14px;
+      border-radius: 12px;
+      font-size: 14px;
+      line-height: 1.6;
+      white-space: pre-wrap;
+      word-break: break-word;
+    }
+
+    .msg.user .msg-bubble {
+      background: #1d4ed8;
+      color: #fff;
+      border-bottom-right-radius: 4px;
+    }
+
+    .msg.assistant .msg-bubble {
+      background: #1e1e1e;
+      border: 1px solid #2a2a2a;
+      border-bottom-left-radius: 4px;
+    }
+
+    .msg-meta {
+      font-size: 11px;
+      color: #555;
+      margin-bottom: 4px;
+      padding: 0 4px;
+    }
+
+    .tool-badge {
+      display: inline-flex;
+      align-items: center;
+      gap: 6px;
+      font-size: 12px;
+      padding: 4px 10px;
+      border-radius: 6px;
+      background: #1a1a2e;
+      border: 1px solid #2d2d5e;
+      color: #818cf8;
+      margin: 4px 0;
+    }
+
+    .tool-badge.done { border-color: #166534; color: #4ade80; background: #052e16; }
+    .tool-badge.error { border-color: #7f1d1d; color: #f87171; background: #2d0000; }
+
+    #input-area {
+      padding: 16px 20px;
+      border-top: 1px solid #2a2a2a;
+      background: #161616;
+      display: flex;
+      gap: 10px;
+    }
+
+    #input {
+      flex: 1;
+      background: #1e1e1e;
+      border: 1px solid #2a2a2a;
+      border-radius: 8px;
+      padding: 10px 14px;
+      color: #e8e8e8;
+      font-size: 14px;
+      resize: none;
+      outline: none;
+      min-height: 44px;
+      max-height: 160px;
+      font-family: inherit;
+    }
+
+    #input:focus { border-color: #3b82f6; }
+
+    #send-btn {
+      background: #1d4ed8;
+      color: #fff;
+      border: none;
+      border-radius: 8px;
+      padding: 0 18px;
+      font-size: 14px;
+      cursor: pointer;
+      font-weight: 500;
+      height: 44px;
+      white-space: nowrap;
+    }
+
+    #send-btn:disabled { opacity: 0.4; cursor: not-allowed; }
+    #send-btn:hover:not(:disabled) { background: #1e40af; }
+
+    #abort-btn {
+      background: transparent;
+      color: #f87171;
+      border: 1px solid #7f1d1d;
+      border-radius: 8px;
+      padding: 0 14px;
+      font-size: 13px;
+      cursor: pointer;
+      height: 44px;
+      display: none;
+    }
+    #abort-btn.visible { display: block; }
+    #abort-btn:hover { background: #2d0000; }
+
+    #connect-bar {
+      padding: 10px 20px;
+      background: #1a1a1a;
+      border-bottom: 1px solid #2a2a2a;
+      display: flex;
+      gap: 8px;
+      align-items: center;
+      font-size: 13px;
+    }
+
+    #server-url {
+      flex: 1;
+      background: #1e1e1e;
+      border: 1px solid #2a2a2a;
+      border-radius: 6px;
+      padding: 6px 10px;
+      color: #e8e8e8;
+      font-size: 13px;
+      outline: none;
+    }
+
+    #connect-btn {
+      background: #065f46;
+      color: #34d399;
+      border: 1px solid #065f46;
+      border-radius: 6px;
+      padding: 6px 14px;
+      cursor: pointer;
+      font-size: 13px;
+    }
+    #connect-btn:hover { background: #047857; }
+  </style>
+</head>
+<body>
+
+<div id="header">
+  <h1>BackendKit Agent</h1>
+  <span id="agent-badge">–</span>
+  <div id="status-dot" title="Disconnected"></div>
+</div>
+
+<div id="connect-bar">
+  <input id="server-url" type="text" value="ws://localhost:4000/chat" spellcheck="false" />
+  <button id="connect-btn" onclick="connect()">Connect</button>
+</div>
+
+<div id="messages"></div>
+
+<div id="input-area">
+  <textarea id="input" placeholder="Send a message…" rows="1" disabled></textarea>
+  <button id="abort-btn" onclick="abort()">Stop</button>
+  <button id="send-btn" onclick="sendMessage()" disabled>Send</button>
+</div>
+
+<script>
+  let ws = null;
+  let sessionId = null;
+  let currentAssistantMsg = null;
+  let isRunning = false;
+
+  const messagesEl  = document.getElementById('messages');
+  const inputEl     = document.getElementById('input');
+  const sendBtn     = document.getElementById('send-btn');
+  const abortBtn    = document.getElementById('abort-btn');
+  const statusDot   = document.getElementById('status-dot');
+  const agentBadge  = document.getElementById('agent-badge');
+  const connectBtn  = document.getElementById('connect-btn');
+
+  function connect() {
+    const url = document.getElementById('server-url').value.trim();
+    if (ws) { ws.close(); ws = null; }
+
+    addSystemMsg(`Connecting to ${url}…`);
+    ws = new WebSocket(url);
+
+    ws.onopen = () => {
+      statusDot.className = 'connected';
+      statusDot.title = 'Connected';
+    };
+
+    ws.onclose = () => {
+      statusDot.className = '';
+      statusDot.title = 'Disconnected';
+      inputEl.disabled = true;
+      sendBtn.disabled = true;
+      setRunning(false);
+      addSystemMsg('Disconnected.');
+    };
+
+    ws.onerror = () => addSystemMsg('WebSocket error.');
+
+    ws.onmessage = (e) => {
+      const evt = JSON.parse(e.data);
+      handleEvent(evt);
+    };
+  }
+
+  function handleEvent(evt) {
+    switch (evt.type) {
+      case 'session_created':
+        sessionId = evt.sessionId;
+        inputEl.disabled = false;
+        sendBtn.disabled = false;
+        addSystemMsg(`Session: ${sessionId.slice(0, 8)}…`);
+        break;
+
+      case 'ready':
+        setRunning(false);
+        currentAssistantMsg = null;
+        break;
+
+      case 'token':
+        if (!currentAssistantMsg) currentAssistantMsg = addAssistantMsg();
+        currentAssistantMsg.textContent += evt.content;
+        scrollToBottom();
+        break;
+
+      case 'tool_call':
+        currentAssistantMsg = null;
+        addToolBadge(`⚙ ${evt.name}${evt.args_preview ? ` — ${evt.args_preview}` : ''}`, 'pending');
+        break;
+
+      case 'tool_result': {
+        const last = messagesEl.querySelector('.tool-badge:last-child');
+        if (last) last.className = `tool-badge ${evt.success ? 'done' : 'error'}`;
+        break;
+      }
+
+      case 'agent_switch':
+        agentBadge.textContent = `${evt.to_icon ?? ''} ${evt.to_name ?? evt.to}`.trim();
+        currentAssistantMsg = null;
+        break;
+
+      case 'block_start':
+        agentBadge.textContent = `${evt.agent_icon ?? ''} ${evt.agent_name ?? evt.agent_id}`.trim();
+        break;
+
+      case 'thinking':
+        addSystemMsg(`💭 ${evt.label}`);
+        break;
+
+      case 'done':
+        setRunning(false);
+        currentAssistantMsg = null;
+        break;
+
+      case 'error':
+        setRunning(false);
+        addSystemMsg(`Error: ${evt.message}`, true);
+        currentAssistantMsg = null;
+        break;
+
+      case 'system':
+        addSystemMsg(evt.text, evt.level === 'error');
+        break;
+
+      case 'metrics':
+        addSystemMsg(`Tokens: ${evt.input_tokens} in / ${evt.output_tokens} out${evt.cost_usd != null ? ` · $${evt.cost_usd.toFixed(4)}` : ''}`);
+        break;
+    }
+  }
+
+  function sendMessage() {
+    const content = inputEl.value.trim();
+    if (!content || !ws || isRunning) return;
+
+    addUserMsg(content);
+    inputEl.value = '';
+    inputEl.style.height = 'auto';
+    setRunning(true);
+
+    ws.send(JSON.stringify({ type: 'input', content }));
+  }
+
+  function abort() {
+    if (ws) ws.send(JSON.stringify({ type: 'abort' }));
+    setRunning(false);
+  }
+
+  function setRunning(running) {
+    isRunning = running;
+    sendBtn.disabled = running;
+    abortBtn.className = running ? 'visible' : '';
+    statusDot.className = running ? 'thinking connected' : 'connected';
+  }
+
+  // ── DOM helpers ──────────────────────────────────────────────────────────
+
+  function addUserMsg(text) {
+    const div = document.createElement('div');
+    div.className = 'msg user';
+    div.innerHTML = `<div class="msg-bubble">${escHtml(text)}</div>`;
+    messagesEl.appendChild(div);
+    scrollToBottom();
+  }
+
+  function addAssistantMsg() {
+    const div = document.createElement('div');
+    div.className = 'msg assistant';
+    const meta = agentBadge.textContent !== '–' ? `<div class="msg-meta">${escHtml(agentBadge.textContent)}</div>` : '';
+    div.innerHTML = `${meta}<div class="msg-bubble"></div>`;
+    messagesEl.appendChild(div);
+    scrollToBottom();
+    return div.querySelector('.msg-bubble');
+  }
+
+  function addToolBadge(label, state) {
+    const span = document.createElement('span');
+    span.className = `tool-badge ${state}`;
+    span.textContent = label;
+    const wrap = document.createElement('div');
+    wrap.className = 'msg assistant';
+    wrap.appendChild(span);
+    messagesEl.appendChild(wrap);
+    scrollToBottom();
+  }
+
+  function addSystemMsg(text, isError = false) {
+    const div = document.createElement('div');
+    div.style.cssText = `font-size:12px;color:${isError ? '#f87171' : '#555'};padding:2px 4px;text-align:center`;
+    div.textContent = text;
+    messagesEl.appendChild(div);
+    scrollToBottom();
+  }
+
+  function scrollToBottom() {
+    messagesEl.scrollTop = messagesEl.scrollHeight;
+  }
+
+  function escHtml(s) {
+    return s.replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;');
+  }
+
+  // ── Keyboard shortcuts ────────────────────────────────────────────────────
+
+  inputEl.addEventListener('keydown', (e) => {
+    if (e.key === 'Enter' && !e.shiftKey) {
+      e.preventDefault();
+      sendMessage();
+    }
+  });
+
+  inputEl.addEventListener('input', () => {
+    inputEl.style.height = 'auto';
+    inputEl.style.height = Math.min(inputEl.scrollHeight, 160) + 'px';
+  });
+</script>
+</body>
+</html>

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { AgentServer } from './server/AgentServer';
+export type { AgentServerOptions, AuthHook } from './server/AgentServer';
+export { SessionManager } from './session/SessionManager';
+export type { Session, SessionManagerOptions, EngineFactory } from './session/SessionManager';
+export { WebSocketTransport } from './transport/WebSocketTransport';
+export type { WsMessage } from './transport/WebSocketTransport';
+export { MonitorBus } from './monitor/MonitorBus';
+export type { MonitorFrame } from './monitor/MonitorBus';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEzE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,YAAY,EAAE,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9F,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,YAAY,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAEhE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MonitorBus = exports.WebSocketTransport = exports.SessionManager = exports.AgentServer = void 0;
+var AgentServer_1 = require("./server/AgentServer");
+Object.defineProperty(exports, "AgentServer", { enumerable: true, get: function () { return AgentServer_1.AgentServer; } });
+var SessionManager_1 = require("./session/SessionManager");
+Object.defineProperty(exports, "SessionManager", { enumerable: true, get: function () { return SessionManager_1.SessionManager; } });
+var WebSocketTransport_1 = require("./transport/WebSocketTransport");
+Object.defineProperty(exports, "WebSocketTransport", { enumerable: true, get: function () { return WebSocketTransport_1.WebSocketTransport; } });
+var MonitorBus_1 = require("./monitor/MonitorBus");
+Object.defineProperty(exports, "MonitorBus", { enumerable: true, get: function () { return MonitorBus_1.MonitorBus; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,oDAAmD;AAA1C,0GAAA,WAAW,OAAA;AAGpB,2DAA0D;AAAjD,gHAAA,cAAc,OAAA;AAGvB,qEAAoE;AAA3D,wHAAA,kBAAkB,OAAA;AAG3B,mDAAkD;AAAzC,wGAAA,UAAU,OAAA"}

package/dist/monitor/MonitorBus.d.ts

@@ -0,0 +1,31 @@
+import type { AgentEvent } from '@backendkit-labs/agent-core';
+import type { WebSocket } from 'ws';
+export type MonitorFrame = {
+    type: 'monitor_hello';
+    sessionIds: string[];
+} | {
+    type: 'monitor_session_open';
+    sessionId: string;
+} | {
+    type: 'monitor_session_close';
+    sessionId: string;
+} | ({
+    sessionId: string;
+} & AgentEvent) | {
+    sessionId: string;
+    type: 'run_input';
+    content: string;
+};
+export declare class MonitorBus {
+    private monitors;
+    private activeSessions;
+    subscribe(socket: WebSocket): void;
+    notifySessionOpen(sessionId: string): void;
+    notifySessionClose(sessionId: string): void;
+    broadcast(sessionId: string, event: AgentEvent): void;
+    broadcastRunInput(sessionId: string, content: string): void;
+    private fanOut;
+    private send;
+    get size(): number;
+}
+//# sourceMappingURL=MonitorBus.d.ts.map

package/dist/monitor/MonitorBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonitorBus.d.ts","sourceRoot":"","sources":["../../src/monitor/MonitorBus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEpC,MAAM,MAAM,YAAY,GAClB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACpD,CAAC;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CAAC,GACpC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE,qBAAa,UAAU;IACnB,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,cAAc,CAAqB;IAE3C,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAUlC,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAK1C,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAK3C,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAIrD,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3D,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,IAAI;IAMZ,IAAI,IAAI,IAAI,MAAM,CAEjB;CACJ"}

package/dist/monitor/MonitorBus.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MonitorBus = void 0;
+class MonitorBus {
+    monitors = new Set();
+    activeSessions = new Set();
+    subscribe(socket) {
+        this.monitors.add(socket);
+        // Greet the new observer with currently open sessions
+        const hello = { type: 'monitor_hello', sessionIds: [...this.activeSessions] };
+        this.send(socket, hello);
+        socket.on('close', () => this.monitors.delete(socket));
+    }
+    notifySessionOpen(sessionId) {
+        this.activeSessions.add(sessionId);
+        this.fanOut({ type: 'monitor_session_open', sessionId });
+    }
+    notifySessionClose(sessionId) {
+        this.activeSessions.delete(sessionId);
+        this.fanOut({ type: 'monitor_session_close', sessionId });
+    }
+    broadcast(sessionId, event) {
+        this.fanOut({ sessionId, ...event });
+    }
+    broadcastRunInput(sessionId, content) {
+        this.fanOut({ sessionId, type: 'run_input', content });
+    }
+    fanOut(frame) {
+        const data = JSON.stringify(frame);
+        for (const ws of this.monitors) {
+            if (ws.readyState === 1 /* OPEN */) {
+                try {
+                    ws.send(data);
+                }
+                catch { /* ignore — socket may be closing */ }
+            }
+        }
+    }
+    send(socket, frame) {
+        if (socket.readyState === 1) {
+            try {
+                socket.send(JSON.stringify(frame));
+            }
+            catch { /* ignore */ }
+        }
+    }
+    get size() {
+        return this.monitors.size;
+    }
+}
+exports.MonitorBus = MonitorBus;
+//# sourceMappingURL=MonitorBus.js.map

package/dist/monitor/MonitorBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MonitorBus.js","sourceRoot":"","sources":["../../src/monitor/MonitorBus.ts"],"names":[],"mappings":";;;AAUA,MAAa,UAAU;IACX,QAAQ,GAAG,IAAI,GAAG,EAAa,CAAC;IAChC,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IAE3C,SAAS,CAAC,MAAiB;QACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAE1B,sDAAsD;QACtD,MAAM,KAAK,GAAiB,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;QAC5F,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAEzB,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,iBAAiB,CAAC,SAAiB;QAC/B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,kBAAkB,CAAC,SAAiB;QAChC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,SAAS,CAAC,SAAiB,EAAE,KAAiB;QAC1C,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAkB,CAAC,CAAC;IACzD,CAAC;IAED,iBAAiB,CAAC,SAAiB,EAAE,OAAe;QAChD,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3D,CAAC;IAEO,MAAM,CAAC,KAAmB;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACnC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC7B,IAAI,EAAE,CAAC,UAAU,KAAK,CAAC,CAAC,UAAU,EAAE,CAAC;gBACjC,IAAI,CAAC;oBAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,oCAAoC,CAAC,CAAC;YACzE,CAAC;QACL,CAAC;IACL,CAAC;IAEO,IAAI,CAAC,MAAiB,EAAE,KAAmB;QAC/C,IAAI,MAAM,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC;gBAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QACtE,CAAC;IACL,CAAC;IAED,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC9B,CAAC;CACJ;AAlDD,gCAkDC"}

package/dist/server/AgentServer.d.ts

@@ -0,0 +1,30 @@
+import type { FastifyRequest, FastifyReply } from 'fastify';
+import { SessionManager } from '../session/SessionManager';
+import type { SessionManagerOptions } from '../session/SessionManager';
+import { MonitorBus } from '../monitor/MonitorBus';
+export type AuthHook = (req: FastifyRequest, reply: FastifyReply) => Promise<void>;
+export interface AgentServerOptions extends SessionManagerOptions {
+    /** TCP port to listen on. Default: 3000. */
+    port?: number;
+    /** Host to bind to. Default: '0.0.0.0'. */
+    host?: string;
+    /** Optional auth hook — called on every request before route handlers. */
+    auth?: AuthHook;
+    /** Fastify logger. Default: false (silent). Pass true for pretty logs in dev. */
+    logger?: boolean | object;
+    /** Allowed CORS origins. Default: '*'. */
+    cors?: string | string[];
+}
+export declare class AgentServer {
+    private app;
+    private sessions;
+    private readonly monitor;
+    private readonly port;
+    private readonly host;
+    constructor(opts: AgentServerOptions);
+    start(): Promise<string>;
+    stop(): Promise<void>;
+    get sessionManager(): SessionManager;
+    get monitorBus(): MonitorBus;
+}
+//# sourceMappingURL=AgentServer.d.ts.map

package/dist/server/AgentServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentServer.d.ts","sourceRoot":"","sources":["../../src/server/AgentServer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAmB,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGnD,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnF,MAAM,WAAW,kBAAmB,SAAQ,qBAAqB;IAC7D,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,iFAAiF;IACjF,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC5B;AAED,qBAAa,WAAW;IACpB,OAAO,CAAC,GAAG,CAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,IAAI,EAAE,kBAAkB;IA4C9B,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAKxB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,IAAI,cAAc,IAAI,cAAc,CAEnC;IAED,IAAI,UAAU,IAAI,UAAU,CAE3B;CACJ"}

package/dist/server/AgentServer.js

@@ -0,0 +1,71 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentServer = void 0;
+const fastify_1 = __importDefault(require("fastify"));
+const websocket_1 = __importDefault(require("@fastify/websocket"));
+const SessionManager_1 = require("../session/SessionManager");
+const MonitorBus_1 = require("../monitor/MonitorBus");
+const routes_1 = require("./routes");
+class AgentServer {
+    app;
+    sessions;
+    monitor;
+    port;
+    host;
+    constructor(opts) {
+        this.port = opts.port ?? 3000;
+        this.host = opts.host ?? '0.0.0.0';
+        this.monitor = new MonitorBus_1.MonitorBus();
+        this.sessions = new SessionManager_1.SessionManager({
+            engineFactory: opts.engineFactory,
+            maxIdleMs: opts.maxIdleMs,
+            maxSessions: opts.maxSessions,
+            monitorBus: this.monitor,
+        });
+        this.app = (0, fastify_1.default)({ logger: opts.logger ?? false });
+        // CORS headers
+        const origins = opts.cors ?? '*';
+        this.app.addHook('onSend', async (_req, reply) => {
+            const origin = Array.isArray(origins) ? origins.join(', ') : origins;
+            reply.header('Access-Control-Allow-Origin', origin);
+        });
+        this.app.options('*', async (_req, reply) => {
+            const origin = Array.isArray(origins) ? origins.join(', ') : origins;
+            reply.header('Access-Control-Allow-Origin', origin);
+            reply.header('Access-Control-Allow-Methods', 'GET, POST, DELETE, OPTIONS');
+            reply.header('Access-Control-Allow-Headers', 'Content-Type, Authorization');
+            reply.code(204).send();
+        });
+        if (opts.auth) {
+            const authHook = opts.auth;
+            this.app.addHook('preHandler', authHook);
+        }
+        // Register websocket plugin + all routes inside a register() so Fastify
+        // resolves the plugin before wiring routes (required for WS routes in v11).
+        const sessions = this.sessions;
+        const monitor = this.monitor;
+        this.app.register(async (instance) => {
+            await instance.register(websocket_1.default);
+            (0, routes_1.registerRoutes)(instance, sessions, monitor);
+        });
+    }
+    async start() {
+        const address = await this.app.listen({ port: this.port, host: this.host });
+        return address;
+    }
+    async stop() {
+        this.sessions.close();
+        await this.app.close();
+    }
+    get sessionManager() {
+        return this.sessions;
+    }
+    get monitorBus() {
+        return this.monitor;
+    }
+}
+exports.AgentServer = AgentServer;
+//# sourceMappingURL=AgentServer.js.map

package/dist/server/AgentServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentServer.js","sourceRoot":"","sources":["../../src/server/AgentServer.ts"],"names":[],"mappings":"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"}

package/dist/server/routes.d.ts

@@ -0,0 +1,5 @@
+import type { FastifyInstance } from 'fastify';
+import type { SessionManager } from '../session/SessionManager';
+import type { MonitorBus } from '../monitor/MonitorBus';
+export declare function registerRoutes(app: FastifyInstance, sessions: SessionManager, monitorBus?: MonitorBus): void;
+//# sourceMappingURL=routes.d.ts.map

package/dist/server/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/server/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAgF5G"}

package/dist/server/routes.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerRoutes = registerRoutes;
+function registerRoutes(app, sessions, monitorBus) {
+    // ── Health ────────────────────────────────────────────────────────────────
+    app.get('/health', async () => ({
+        status: 'ok',
+        sessions: sessions.size,
+        monitors: monitorBus?.size ?? 0,
+        timestamp: new Date().toISOString(),
+    }));
+    // ── Sessions ─────────────────────────────────────────────────────────────
+    app.get('/sessions', async () => ({ sessions: sessions.list() }));
+    app.delete('/sessions/:id', async (req, reply) => {
+        const session = sessions.get(req.params.id);
+        if (!session)
+            return reply.code(404).send({ error: 'Session not found' });
+        sessions.destroy(req.params.id);
+        return { ok: true };
+    });
+    // ── WebSocket chat ────────────────────────────────────────────────────────
+    // Client connects → session is created → messages flow over the socket.
+    // The engine sends AgentEvents as JSON frames; the client sends:
+    //   { type: 'input', content: '...' }    ← user message
+    //   { type: 'abort' }                    ← cancel current run
+    app.get('/chat', { websocket: true }, (socket, _req) => {
+        let session;
+        try {
+            session = sessions.create(socket);
+            // Announce session id so the client can reference it
+            socket.send(JSON.stringify({ type: 'session_created', sessionId: session.id }));
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Failed to create session';
+            socket.send(JSON.stringify({ type: 'error', message }));
+            socket.close();
+            return;
+        }
+        socket.on('message', (raw) => {
+            try {
+                const msg = JSON.parse(raw.toString());
+                if (msg.type === 'input' && typeof msg.content === 'string') {
+                    sessions.get(session.id);
+                    // Broadcast user input to monitor observers before running
+                    monitorBus?.broadcastRunInput(session.id, msg.content);
+                    // Fire-and-forget: engine.run() handles its own error boundary
+                    void session.engine.run(msg.content).catch((err) => {
+                        const message = err instanceof Error ? err.message : 'Engine error';
+                        socket.send(JSON.stringify({ type: 'error', message }));
+                    });
+                }
+                if (msg.type === 'abort') {
+                    session.engine.abort();
+                }
+            }
+            catch {
+                // ignore malformed frames
+            }
+        });
+        // Cleanup is handled by SessionManager's socket.on('close') hook
+    });
+    // ── WebSocket monitor ─────────────────────────────────────────────────────
+    // Read-only observer — receives all session events tagged with sessionId.
+    // Protocol (server → client):
+    //   { type: 'monitor_hello', sessionIds: string[] }
+    //   { type: 'monitor_session_open', sessionId }
+    //   { type: 'monitor_session_close', sessionId }
+    //   { sessionId, type: 'run_input', content }
+    //   { sessionId, ...AgentEvent }
+    if (monitorBus) {
+        const bus = monitorBus;
+        app.get('/monitor', { websocket: true }, (socket, _req) => {
+            bus.subscribe(socket);
+        });
+    }
+}
+//# sourceMappingURL=routes.js.map

package/dist/server/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/server/routes.ts"],"names":[],"mappings":";;AAKA,wCAgFC;AAhFD,SAAgB,cAAc,CAAC,GAAoB,EAAE,QAAwB,EAAE,UAAuB;IAElG,6EAA6E;IAC7E,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC5B,MAAM,EAAE,IAAI;QACZ,QAAQ,EAAE,QAAQ,CAAC,IAAI;QACvB,QAAQ,EAAE,UAAU,EAAE,IAAI,IAAI,CAAC;QAC/B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,CAAC,CAAC,CAAC;IAEJ,4EAA4E;IAE5E,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IAElE,GAAG,CAAC,MAAM,CAA6B,eAAe,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QACzE,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC;QAC1E,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAChC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,6EAA6E;IAC7E,wEAAwE;IACxE,iEAAiE;IACjE,wDAAwD;IACxD,8DAA8D;IAC9D,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,MAAiB,EAAE,IAAI,EAAE,EAAE;QAC9D,IAAI,OAA6C,CAAC;QAElD,IAAI,CAAC;YACD,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAClC,qDAAqD;YACrD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACpF,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,CAAC;YAChF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;YACxD,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,OAAO;QACX,CAAC;QAED,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAoB,EAAE,EAAE;YAC1C,IAAI,CAAC;gBACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAEvC,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;oBAC1D,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;oBACzB,2DAA2D;oBAC3D,UAAU,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;oBACvD,+DAA+D;oBAC/D,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;wBACxD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC;wBACpE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;oBAC5D,CAAC,CAAC,CAAC;gBACP,CAAC;gBAED,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBACvB,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBAC3B,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACL,0BAA0B;YAC9B,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,iEAAiE;IACrE,CAAC,CAAC,CAAC;IAEH,6EAA6E;IAC7E,0EAA0E;IAC1E,8BAA8B;IAC9B,oDAAoD;IACpD,gDAAgD;IAChD,iDAAiD;IACjD,8CAA8C;IAC9C,iCAAiC;IACjC,IAAI,UAAU,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,UAAU,CAAC;QACvB,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,MAAiB,EAAE,IAAI,EAAE,EAAE;YACjE,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACP,CAAC;AACL,CAAC"}

package/dist/session/SessionManager.d.ts

@@ -0,0 +1,40 @@
+import type { AgentEngine } from '@backendkit-labs/agent-core';
+import { WebSocketTransport } from '../transport/WebSocketTransport';
+import type { MonitorBus } from '../monitor/MonitorBus';
+import type { WebSocket } from 'ws';
+export interface Session {
+    id: string;
+    engine: AgentEngine;
+    transport: WebSocketTransport;
+    createdAt: Date;
+    lastActivityAt: Date;
+}
+export type EngineFactory = (sessionId: string, transport: WebSocketTransport) => AgentEngine;
+export interface SessionManagerOptions {
+    /** Factory that creates a fresh AgentEngine for a session. Called once per session. */
+    engineFactory: EngineFactory;
+    /** Max idle time in ms before a session is automatically evicted. Default: 30 minutes. */
+    maxIdleMs?: number;
+    /** Max concurrent sessions. Rejects new sessions when reached. Default: 100. */
+    maxSessions?: number;
+    /** Optional monitor bus — broadcasts all session events to connected observers. */
+    monitorBus?: MonitorBus;
+}
+export declare class SessionManager {
+    private sessions;
+    private readonly maxIdleMs;
+    private readonly maxSessions;
+    private readonly engineFactory;
+    private readonly monitorBus;
+    private sweepTimer;
+    constructor(opts: SessionManagerOptions);
+    /** Create a new session and wire a WebSocket to it. */
+    create(socket: WebSocket): Session;
+    get(id: string): Session | undefined;
+    destroy(id: string): void;
+    list(): Pick<Session, 'id' | 'createdAt' | 'lastActivityAt'>[];
+    get size(): number;
+    close(): void;
+    private sweepIdle;
+}
+//# sourceMappingURL=SessionManager.d.ts.map

package/dist/session/SessionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../../src/session/SessionManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEpC,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,SAAS,EAAE,IAAI,CAAC;IAChB,cAAc,EAAE,IAAI,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,kBAAkB,KAAK,WAAW,CAAC;AAE9F,MAAM,WAAW,qBAAqB;IAClC,uFAAuF;IACvF,aAAa,EAAE,aAAa,CAAC;IAC7B,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,UAAU,CAAC,EAAE,UAAU,CAAC;CAC3B;AAED,qBAAa,cAAc;IACvB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,OAAO,CAAC,UAAU,CAA+C;gBAErD,IAAI,EAAE,qBAAqB;IAWvC,uDAAuD;IACvD,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO;IAoClC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAMpC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IASzB,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,WAAW,GAAG,gBAAgB,CAAC,EAAE;IAM9D,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,SAAS;CAQpB"}

package/dist/session/SessionManager.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionManager = void 0;
+const uuid_1 = require("uuid");
+const WebSocketTransport_1 = require("../transport/WebSocketTransport");
+class SessionManager {
+    sessions = new Map();
+    maxIdleMs;
+    maxSessions;
+    engineFactory;
+    monitorBus;
+    sweepTimer = null;
+    constructor(opts) {
+        this.engineFactory = opts.engineFactory;
+        this.maxIdleMs = opts.maxIdleMs ?? 30 * 60 * 1000;
+        this.maxSessions = opts.maxSessions ?? 100;
+        this.monitorBus = opts.monitorBus;
+        // sweep idle sessions every minute
+        this.sweepTimer = setInterval(() => this.sweepIdle(), 60_000);
+        this.sweepTimer.unref?.();
+    }
+    /** Create a new session and wire a WebSocket to it. */
+    create(socket) {
+        if (this.sessions.size >= this.maxSessions) {
+            throw new Error(`Max concurrent sessions (${this.maxSessions}) reached`);
+        }
+        const id = (0, uuid_1.v4)();
+        const transport = new WebSocketTransport_1.WebSocketTransport(socket);
+        // Tap emit to fan out every AgentEvent to the monitor bus
+        if (this.monitorBus) {
+            const bus = this.monitorBus;
+            const origEmit = transport.emit.bind(transport);
+            transport.emit = (event) => {
+                origEmit(event);
+                bus.broadcast(id, event);
+            };
+        }
+        const engine = this.engineFactory(id, transport);
+        const session = {
+            id,
+            engine,
+            transport,
+            createdAt: new Date(),
+            lastActivityAt: new Date(),
+        };
+        this.sessions.set(id, session);
+        this.monitorBus?.notifySessionOpen(id);
+        socket.on('close', () => this.destroy(id));
+        return session;
+    }
+    get(id) {
+        const session = this.sessions.get(id);
+        if (session)
+            session.lastActivityAt = new Date();
+        return session;
+    }
+    destroy(id) {
+        const session = this.sessions.get(id);
+        if (!session)
+            return;
+        try {
+            session.engine.abort();
+        }
+        catch { /* engine may already be idle */ }
+        try {
+            session.transport.close();
+        }
+        catch { /* may already be closed */ }
+        this.sessions.delete(id);
+        this.monitorBus?.notifySessionClose(id);
+    }
+    list() {
+        return [...this.sessions.values()].map(({ id, createdAt, lastActivityAt }) => ({
+            id, createdAt, lastActivityAt,
+        }));
+    }
+    get size() {
+        return this.sessions.size;
+    }
+    close() {
+        if (this.sweepTimer) {
+            clearInterval(this.sweepTimer);
+            this.sweepTimer = null;
+        }
+        for (const id of [...this.sessions.keys()])
+            this.destroy(id);
+    }
+    sweepIdle() {
+        const cutoff = Date.now() - this.maxIdleMs;
+        for (const [id, session] of this.sessions) {
+            if (session.lastActivityAt.getTime() < cutoff) {
+                this.destroy(id);
+            }
+        }
+    }
+}
+exports.SessionManager = SessionManager;
+//# sourceMappingURL=SessionManager.js.map

package/dist/session/SessionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionManager.js","sourceRoot":"","sources":["../../src/session/SessionManager.ts"],"names":[],"mappings":";;;AAAA,+BAAoC;AAEpC,wEAAqE;AAyBrE,MAAa,cAAc;IACf,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC7B,SAAS,CAAS;IAClB,WAAW,CAAS;IACpB,aAAa,CAAgB;IAC7B,UAAU,CAAyB;IAC5C,UAAU,GAA0C,IAAI,CAAC;IAEjE,YAAY,IAA2B;QACnC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAClD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,GAAG,CAAC;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAElC,mCAAmC;QACnC,IAAI,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,MAAM,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC;IAC9B,CAAC;IAED,uDAAuD;IACvD,MAAM,CAAC,MAAiB;QACpB,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,WAAW,WAAW,CAAC,CAAC;QAC7E,CAAC;QAED,MAAM,EAAE,GAAG,IAAA,SAAM,GAAE,CAAC;QACpB,MAAM,SAAS,GAAG,IAAI,uCAAkB,CAAC,MAAM,CAAC,CAAC;QAEjD,0DAA0D;QAC1D,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC;YAC5B,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAChD,SAAS,CAAC,IAAI,GAAG,CAAC,KAAiB,EAAE,EAAE;gBACnC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAChB,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YAC7B,CAAC,CAAC;QACN,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAEjD,MAAM,OAAO,GAAY;YACrB,EAAE;YACF,MAAM;YACN,SAAS;YACT,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,cAAc,EAAE,IAAI,IAAI,EAAE;SAC7B,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,EAAE,CAAC,CAAC;QAEvC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;QAE3C,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,GAAG,CAAC,EAAU;QACV,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,OAAO;YAAE,OAAO,CAAC,cAAc,GAAG,IAAI,IAAI,EAAE,CAAC;QACjD,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,OAAO,CAAC,EAAU;QACd,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,CAAC;YAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,gCAAgC,CAAC,CAAC;QAC1E,IAAI,CAAC;YAAC,OAAO,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,2BAA2B,CAAC,CAAC;QACxE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzB,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI;QACA,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC;YAC3E,EAAE,EAAE,SAAS,EAAE,cAAc;SAChC,CAAC,CAAC,CAAC;IACR,CAAC;IAED,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC9B,CAAC;IAED,KAAK;QACD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QAC3B,CAAC;QACD,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IAEO,SAAS;QACb,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;QAC3C,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACxC,IAAI,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;gBAC5C,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACrB,CAAC;QACL,CAAC;IACL,CAAC;CACJ;AAjGD,wCAiGC"}

package/dist/transport/WebSocketTransport.d.ts

@@ -0,0 +1,21 @@
+import type { AgentEvent } from '@backendkit-labs/agent-core';
+import type { Transport, Unsubscribe } from '@backendkit-labs/agent-core';
+import type { WebSocket } from 'ws';
+export type WsMessage = {
+    type: 'input';
+    content: string;
+} | {
+    type: 'approval';
+    decision: 'approve' | 'approve_all' | 'reject';
+};
+export declare class WebSocketTransport implements Transport {
+    private readonly socket;
+    private inputHandlers;
+    private closed;
+    constructor(socket: WebSocket);
+    emit(event: AgentEvent): void;
+    onInput(handler: (input: string) => void): Unsubscribe;
+    close(): void;
+    get isOpen(): boolean;
+}
+//# sourceMappingURL=WebSocketTransport.d.ts.map

package/dist/transport/WebSocketTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketTransport.d.ts","sourceRoot":"","sources":["../../src/transport/WebSocketTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAEpC,MAAM,MAAM,SAAS,GACf;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,SAAS,GAAG,aAAa,GAAG,QAAQ,CAAA;CAAE,CAAC;AAE3E,qBAAa,kBAAmB,YAAW,SAAS;IAIpC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,MAAM,CAAS;gBAEM,MAAM,EAAE,SAAS;IAkB9C,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAS7B,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,WAAW;IAOtD,KAAK,IAAI,IAAI;IAUb,IAAI,MAAM,IAAI,OAAO,CAEpB;CACJ"}

package/dist/transport/WebSocketTransport.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketTransport = void 0;
+class WebSocketTransport {
+    socket;
+    inputHandlers = [];
+    closed = false;
+    constructor(socket) {
+        this.socket = socket;
+        socket.on('message', (raw) => {
+            try {
+                const msg = JSON.parse(raw.toString());
+                if (msg.type === 'input') {
+                    for (const h of this.inputHandlers)
+                        h(msg.content);
+                }
+            }
+            catch {
+                // ignore malformed frames
+            }
+        });
+        socket.on('close', () => {
+            this.closed = true;
+            this.inputHandlers = [];
+        });
+    }
+    emit(event) {
+        if (this.closed)
+            return;
+        try {
+            this.socket.send(JSON.stringify(event));
+        }
+        catch {
+            // socket may have closed between the guard and send
+        }
+    }
+    onInput(handler) {
+        this.inputHandlers.push(handler);
+        return () => {
+            this.inputHandlers = this.inputHandlers.filter(h => h !== handler);
+        };
+    }
+    close() {
+        this.closed = true;
+        this.inputHandlers = [];
+        try {
+            this.socket.close();
+        }
+        catch {
+            // already closed
+        }
+    }
+    get isOpen() {
+        return !this.closed && this.socket.readyState === 1; // OPEN
+    }
+}
+exports.WebSocketTransport = WebSocketTransport;
+//# sourceMappingURL=WebSocketTransport.js.map

package/dist/transport/WebSocketTransport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketTransport.js","sourceRoot":"","sources":["../../src/transport/WebSocketTransport.ts"],"names":[],"mappings":";;;AAQA,MAAa,kBAAkB;IAIE;IAHrB,aAAa,GAAmC,EAAE,CAAC;IACnD,MAAM,GAAG,KAAK,CAAC;IAEvB,YAA6B,MAAiB;QAAjB,WAAM,GAAN,MAAM,CAAW;QAC1C,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAoB,EAAE,EAAE;YAC1C,IAAI,CAAC;gBACD,MAAM,GAAG,GAAc,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAClD,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBACvB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,aAAa;wBAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACvD,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACL,0BAA0B;YAC9B,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACpB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;IACP,CAAC;IAED,IAAI,CAAC,KAAiB;QAClB,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACL,oDAAoD;QACxD,CAAC;IACL,CAAC;IAED,OAAO,CAAC,OAAgC;QACpC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,OAAO,GAAG,EAAE;YACR,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC;QACvE,CAAC,CAAC;IACN,CAAC;IAED,KAAK;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACL,iBAAiB;QACrB,CAAC;IACL,CAAC;IAED,IAAI,MAAM;QACN,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,OAAO;IAChE,CAAC;CACJ;AAnDD,gDAmDC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@backendkit-labs/agent-web",
+  "version": "0.1.0",
+  "description": "HTTP/WebSocket server layer for agent-core — browser-ready streaming agent sessions",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/",
+    "client/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "@backendkit-labs/agent-core": ">=0.21.0"
+  },
+  "dependencies": {
+    "@fastify/websocket": "^11.0.0",
+    "fastify": "^5.0.0",
+    "uuid": "^10.0.0"
+  },
+  "devDependencies": {
+    "@backendkit-labs/agent-core": "*",
+    "@types/node": "^20.0.0",
+    "@types/uuid": "^10.0.0",
+    "@types/ws": "^8.0.0",
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}