@mastra/hono 1.3.5-alpha.0 → 1.4.0-alpha.2

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @mastra/hono
 
+## 1.4.0-alpha.2
+
+### Minor Changes
+
+- Add browser streaming WebSocket support for Hono server adapter ([#14938](https://github.com/mastra-ai/mastra/pull/14938))
+  - New `setupBrowserStream()` function for real-time screencast streaming
+  - WebSocket route at `/browser/:agentId/stream` for viewer connections
+  - Browser close endpoint at `/api/agents/:agentId/browser/close`
+
+### Patch Changes
+
+- Updated dependencies [[`cb15509`](https://github.com/mastra-ai/mastra/commit/cb15509b58f6a83e11b765c945082afc027db972), [`cb15509`](https://github.com/mastra-ai/mastra/commit/cb15509b58f6a83e11b765c945082afc027db972), [`80c5668`](https://github.com/mastra-ai/mastra/commit/80c5668e365470d3a96d3e953868fd7a643ff67c), [`3d478c1`](https://github.com/mastra-ai/mastra/commit/3d478c1e13f17b80f330ac49d7aa42ef929b93ff), [`f03f37a`](https://github.com/mastra-ai/mastra/commit/f03f37a5e5880f2bb2700514405e311f840c53d2), [`eecd0eb`](https://github.com/mastra-ai/mastra/commit/eecd0ebde7b54bbfe32e7ebbf5fe2c59b29dd685), [`6039f17`](https://github.com/mastra-ai/mastra/commit/6039f176f9c457304825ff1df8c83b8e457376c0), [`06b928d`](https://github.com/mastra-ai/mastra/commit/06b928dfc2f5630d023467476cc5919dfa858d0a), [`6a8d984`](https://github.com/mastra-ai/mastra/commit/6a8d9841f2933456ee1598099f488d742b600054)]:
+  - @mastra/core@1.22.0-alpha.2
+  - @mastra/server@1.22.0-alpha.2
+
+## 1.3.5-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [[`81e4259`](https://github.com/mastra-ai/mastra/commit/81e425939b4ceeb4f586e9b6d89c3b1c1f2d2fe7), [`951b8a1`](https://github.com/mastra-ai/mastra/commit/951b8a1b5ef7e1474c59dc4f2b9fc1a8b1e508b6)]:
+  - @mastra/core@1.22.0-alpha.1
+  - @mastra/server@1.22.0-alpha.1
+
 ## 1.3.5-alpha.0
 
 ### Patch Changes

package/dist/browser-stream/index.d.ts

@@ -0,0 +1,35 @@
+import type { BrowserStreamConfig, BrowserStreamResult } from '@mastra/server/browser-stream';
+import type { Env, Hono, Schema } from 'hono';
+/**
+ * Set up WebSocket-based browser stream endpoint for real-time screencast viewing.
+ *
+ * Creates a WebSocket route at `/browser/:agentId/stream` that:
+ * - Accepts viewer connections
+ * - Starts screencast when first viewer connects
+ * - Broadcasts frames to all connected viewers
+ * - Stops screencast when last viewer disconnects
+ *
+ * **Note**: Requires `ws` package to be installed. If not available, returns null
+ * and logs a warning. Browser streaming will be disabled but everything else works.
+ *
+ * @param app - The Hono application instance
+ * @param config - Configuration for browser stream
+ * @returns Object containing injectWebSocket function and registry instance, or null if ws is not available
+ *
+ * @example
+ * ```typescript
+ * import { Hono } from 'hono';
+ * import { serve } from '@hono/node-server';
+ * import { setupBrowserStream } from '@mastra/hono';
+ *
+ * const app = new Hono();
+ * const browserStream = await setupBrowserStream(app, {
+ *   getToolset: (agentId) => browserToolsets.get(agentId),
+ * });
+ *
+ * const server = serve({ fetch: app.fetch, port: 4111 });
+ * browserStream?.injectWebSocket(server);
+ * ```
+ */
+export declare function setupBrowserStream<E extends Env, S extends Schema, B extends string>(app: Hono<E, S, B>, config: BrowserStreamConfig): Promise<BrowserStreamResult | null>;
+//# sourceMappingURL=index.d.ts.map

package/dist/browser-stream/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser-stream/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAC9F,OAAO,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EACxF,GAAG,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAClB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CA0GrC"}

package/dist/index.cjs

@@ -4,6 +4,7 @@ var serverAdapter = require('@mastra/server/server-adapter');
 var fetchToNode = require('fetch-to-node');
 var requestContext = require('@mastra/core/request-context');
 var auth = require('@mastra/server/auth');
+var browserStream = require('@mastra/server/browser-stream');
 
 // src/index.ts
 
@@ -460,6 +461,83 @@ function createAuthMiddleware({ mastra, requiresAuth = true }) {
     return c.json(result.body, result.status);
   };
 }
+async function setupBrowserStream(app, config2) {
+  let createNodeWebSocket;
+  try {
+    const mod = "@hono/node-ws";
+    const honoNodeWs = await import(
+      /* @vite-ignore */
+      /* webpackIgnore: true */
+      mod
+    );
+    createNodeWebSocket = honoNodeWs.createNodeWebSocket;
+  } catch {
+    return null;
+  }
+  const { injectWebSocket, upgradeWebSocket } = createNodeWebSocket({ app });
+  const registry2 = new browserStream.ViewerRegistry();
+  app.get(
+    "/browser/:agentId/stream",
+    upgradeWebSocket((c) => {
+      const agentId = c.req.param("agentId");
+      const threadId = c.req.query("threadId");
+      const viewerKey = threadId ? `${agentId}:${threadId}` : agentId;
+      return {
+        onOpen(_event, ws) {
+          ws.send(JSON.stringify({ status: "connected" }));
+          void registry2.addViewer(viewerKey, ws, config2.getToolset, agentId, threadId);
+        },
+        onMessage(event, _ws) {
+          const data = typeof event.data === "string" ? event.data : null;
+          if (data) {
+            browserStream.handleInputMessage(data, config2.getToolset, agentId, threadId);
+          }
+        },
+        onClose(_event, ws) {
+          void registry2.removeViewer(viewerKey, ws);
+        },
+        onError(event, ws) {
+          console.error("[BrowserStream] WebSocket error:", event);
+          void registry2.removeViewer(viewerKey, ws);
+        }
+      };
+    })
+  );
+  app.post("/api/agents/:agentId/browser/close", async (c) => {
+    const agentId = c.req.param("agentId");
+    if (!agentId) {
+      return c.json({ error: "Agent ID is required" }, 400);
+    }
+    const toolset = config2.getToolset(agentId);
+    if (!toolset) {
+      return c.json({ error: "No browser session for this agent" }, 404);
+    }
+    try {
+      let threadId;
+      try {
+        const body = await c.req.json();
+        threadId = body?.threadId;
+      } catch {
+      }
+      const scope = toolset.getScope();
+      const viewerKey = threadId ? `${agentId}:${threadId}` : agentId;
+      if (scope === "thread" && threadId) {
+        await registry2.closeBrowserSession(viewerKey);
+        if ("closeThreadSession" in toolset && typeof toolset.closeThreadSession === "function") {
+          await toolset.closeThreadSession(threadId);
+        }
+      } else {
+        await registry2.closeBrowserSession(viewerKey);
+        await toolset.close();
+      }
+      return c.json({ success: true });
+    } catch (error) {
+      console.error(`[BrowserStream] Error closing browser for ${agentId}:`, error);
+      return c.json({ error: "Failed to close browser" }, 500);
+    }
+  });
+  return { injectWebSocket, registry: registry2 };
+}
 
 // src/index.ts
 var _hasPermissionPromise;
@@ -965,5 +1043,6 @@ var MastraServer = class extends serverAdapter.MastraServer {
 
 exports.MastraServer = MastraServer;
 exports.createAuthMiddleware = createAuthMiddleware;
+exports.setupBrowserStream = setupBrowserStream;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map