@radaros/transport 0.3.7 → 0.3.9

package/dist/index.d.ts

@@ -1,4 +1,38 @@
-import { Agent, Team, Workflow, VoiceAgent, A2AAgentCard } from '@radaros/core';
+import { Agent, A2AAgentCard, Team, Workflow, EventBus, VoiceAgent } from '@radaros/core';
+
+interface A2AServerOptions {
+    agents: Record<string, Agent>;
+    basePath?: string;
+    provider?: {
+        organization: string;
+        url?: string;
+    };
+    version?: string;
+}
+
+/**
+ * Mount an A2A-compliant server on an Express app.
+ *
+ * - Serves `/.well-known/agent.json` with the Agent Card
+ * - Handles JSON-RPC 2.0 requests at the basePath for message/send, message/stream, tasks/get, tasks/cancel
+ */
+declare function createA2AServer(app: any, opts: A2AServerOptions): void;
+
+/**
+ * Generate an A2A Agent Card from a RadarOS Agent.
+ * The card is served at /.well-known/agent.json per the A2A spec.
+ */
+declare function generateAgentCard(agent: Agent, serverUrl: string, provider?: {
+    organization: string;
+    url?: string;
+}, version?: string): A2AAgentCard;
+/**
+ * Generate a combined Agent Card that lists multiple agents as skills.
+ */
+declare function generateMultiAgentCard(agents: Record<string, Agent>, serverUrl: string, provider?: {
+    organization: string;
+    url?: string;
+}, version?: string): A2AAgentCard;
 
 interface FileUploadOptions {
     maxFileSize?: number;
@@ -8,6 +42,9 @@ interface FileUploadOptions {
 declare function createFileUploadMiddleware(opts?: FileUploadOptions): any;
 declare function buildMultiModalInput(body: any, files?: any[]): string | any[];
 
+declare function errorHandler(): (err: any, _req: any, res: any, _next: any) => void;
+declare function requestLogger(): (req: any, _res: any, next: any) => void;
+
 interface SwaggerOptions {
     /** Enable Swagger UI at /docs. Default: false */
     enabled?: boolean;
@@ -42,9 +79,6 @@ interface RouterOptions {
 
 declare function createAgentRouter(opts: RouterOptions): any;
 
-declare function errorHandler(): (err: any, _req: any, res: any, _next: any) => void;
-declare function requestLogger(): (req: any, _res: any, next: any) => void;
-
 interface OpenAPISpec {
     openapi: string;
     info: {
@@ -69,6 +103,66 @@ interface OpenAPISpec {
 }
 declare function generateOpenAPISpec(routerOpts: RouterOptions, swaggerOpts?: SwaggerOptions): OpenAPISpec;
 
+/**
+ * Minimal interface for a BrowserAgent — avoids a hard dependency on @radaros/browser.
+ * Any object that matches this shape (e.g. a real BrowserAgent) works.
+ */
+interface BrowserAgentLike {
+    name: string;
+    eventBus: EventBus;
+    run(task: string, opts?: {
+        startUrl?: string;
+        apiKey?: string;
+        sessionId?: string;
+    }): Promise<{
+        result: string;
+        success: boolean;
+        finalUrl: string;
+        durationMs: number;
+        videoPath?: string;
+        steps: Array<{
+            index: number;
+            action: unknown;
+            screenshot: Buffer;
+            pageUrl: string;
+            pageTitle: string;
+            dom?: string;
+        }>;
+    }>;
+}
+interface BrowserGatewayOptions {
+    /** Named BrowserAgent instances. Clients select one via agentName. */
+    agents: Record<string, BrowserAgentLike>;
+    /** Socket.IO server instance */
+    io: any;
+    /** Socket.IO namespace. Default: "/radaros-browser" */
+    namespace?: string;
+    /** Optional auth middleware applied to the namespace */
+    authMiddleware?: (socket: any, next: (err?: Error) => void) => void;
+    /**
+     * Stream screenshots to the client in real-time.
+     * Default: true. Disable for bandwidth-constrained clients.
+     */
+    streamScreenshots?: boolean;
+}
+/**
+ * Create a Socket.IO gateway that streams BrowserAgent execution in real-time.
+ *
+ * ## Client → Server events
+ * - `browser.start` — kick off a browser task
+ * - `browser.stop`  — cancel a running task
+ *
+ * ## Server → Client events
+ * - `browser.started`    — task accepted
+ * - `browser.screenshot` — live screenshot (base64 PNG)
+ * - `browser.action`     — action about to execute
+ * - `browser.step`       — full step with screenshot + DOM
+ * - `browser.done`       — task finished (result, success, duration, video)
+ * - `browser.error`      — error occurred
+ * - `browser.stopped`    — task was cancelled
+ */
+declare function createBrowserGateway(opts: BrowserGatewayOptions): void;
+
 interface GatewayOptions {
     agents?: Record<string, Agent>;
     teams?: Record<string, Team>;
@@ -87,38 +181,4 @@ interface VoiceGatewayOptions {
 }
 declare function createVoiceGateway(opts: VoiceGatewayOptions): void;
 
-interface A2AServerOptions {
-    agents: Record<string, Agent>;
-    basePath?: string;
-    provider?: {
-        organization: string;
-        url?: string;
-    };
-    version?: string;
-}
-
-/**
- * Mount an A2A-compliant server on an Express app.
- *
- * - Serves `/.well-known/agent.json` with the Agent Card
- * - Handles JSON-RPC 2.0 requests at the basePath for message/send, message/stream, tasks/get, tasks/cancel
- */
-declare function createA2AServer(app: any, opts: A2AServerOptions): void;
-
-/**
- * Generate an A2A Agent Card from a RadarOS Agent.
- * The card is served at /.well-known/agent.json per the A2A spec.
- */
-declare function generateAgentCard(agent: Agent, serverUrl: string, provider?: {
-    organization: string;
-    url?: string;
-}, version?: string): A2AAgentCard;
-/**
- * Generate a combined Agent Card that lists multiple agents as skills.
- */
-declare function generateMultiAgentCard(agents: Record<string, Agent>, serverUrl: string, provider?: {
-    organization: string;
-    url?: string;
-}, version?: string): A2AAgentCard;
-
-export { type A2AServerOptions, type FileUploadOptions, type GatewayOptions, type RouterOptions, type SwaggerOptions, type VoiceGatewayOptions, buildMultiModalInput, createA2AServer, createAgentGateway, createAgentRouter, createFileUploadMiddleware, createVoiceGateway, errorHandler, generateAgentCard, generateMultiAgentCard, generateOpenAPISpec, requestLogger };
+export { type A2AServerOptions, type BrowserGatewayOptions, type FileUploadOptions, type GatewayOptions, type RouterOptions, type SwaggerOptions, type VoiceGatewayOptions, buildMultiModalInput, createA2AServer, createAgentGateway, createAgentRouter, createBrowserGateway, createFileUploadMiddleware, createVoiceGateway, errorHandler, generateAgentCard, generateMultiAgentCard, generateOpenAPISpec, requestLogger };