@giselles-ai/browser-tool 0.1.16 → 0.1.18

package/dist/relay/index.d.ts

@@ -1,4 +1,5 @@
 import Redis from 'ioredis';
+import { z } from 'zod';
 
 declare function createRelayHandler(): {
     GET: (request: Request) => Promise<Response>;
@@ -7,6 +8,79 @@ declare function createRelayHandler(): {
 };
 
 type RelayErrorCode = "UNAUTHORIZED" | "NO_BROWSER" | "TIMEOUT" | "INVALID_RESPONSE" | "NOT_FOUND" | "INTERNAL";
+declare const relayRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"snapshot_request">;
+    requestId: z.ZodString;
+    instruction: z.ZodString;
+    document: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"execute_request">;
+    requestId: z.ZodString;
+    actions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        action: z.ZodLiteral<"fill">;
+        fieldId: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"click">;
+        fieldId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        action: z.ZodLiteral<"select">;
+        fieldId: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>], "action">>;
+    fields: z.ZodArray<z.ZodObject<{
+        fieldId: z.ZodString;
+        selector: z.ZodString;
+        kind: z.ZodEnum<{
+            text: "text";
+            textarea: "textarea";
+            select: "select";
+            checkbox: "checkbox";
+            radio: "radio";
+        }>;
+        label: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        required: z.ZodBoolean;
+        placeholder: z.ZodOptional<z.ZodString>;
+        currentValue: z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>;
+        options: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "type">;
+declare const relayResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"snapshot_response">;
+    requestId: z.ZodString;
+    fields: z.ZodArray<z.ZodObject<{
+        fieldId: z.ZodString;
+        selector: z.ZodString;
+        kind: z.ZodEnum<{
+            text: "text";
+            textarea: "textarea";
+            select: "select";
+            checkbox: "checkbox";
+            radio: "radio";
+        }>;
+        label: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        required: z.ZodBoolean;
+        placeholder: z.ZodOptional<z.ZodString>;
+        currentValue: z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>;
+        options: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"execute_response">;
+    requestId: z.ZodString;
+    report: z.ZodObject<{
+        applied: z.ZodNumber;
+        skipped: z.ZodNumber;
+        warnings: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"error_response">;
+    requestId: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>], "type">;
+type RelayRequest = z.infer<typeof relayRequestSchema>;
+type RelayResponse = z.infer<typeof relayResponseSchema>;
 
 declare global {
     var __browserToolRelayRedis: Redis | undefined;
@@ -23,4 +97,18 @@ declare function createRelaySession(): Promise<{
 }>;
 declare function toRelayError(error: unknown): RelayStoreError;
 
-export { createRelayHandler, createRelaySession, toRelayError };
+type RelayRequestSubscription = {
+    nextRequest(): Promise<RelayRequest>;
+    close(): Promise<void>;
+};
+declare function createRelayRequestSubscription(input: {
+    sessionId: string;
+    token: string;
+}): Promise<RelayRequestSubscription>;
+declare function sendRelayResponse(input: {
+    sessionId: string;
+    token: string;
+    response: RelayResponse;
+}): Promise<void>;
+
+export { type RelayRequestSubscription, createRelayHandler, createRelayRequestSubscription, createRelaySession, sendRelayResponse, toRelayError };

package/dist/relay/index.js

@@ -789,8 +789,63 @@ function createRelayHandler() {
     OPTIONS: (request) => new Response(null, { status: 204, headers: corsHeaders(request) })
   };
 }
+
+// src/relay/request-subscription.ts
+async function createRelayRequestSubscription(input) {
+  await assertRelaySession(input.sessionId, input.token);
+  const subscriber = createRelaySubscriber();
+  const channel = relayRequestChannel(input.sessionId);
+  await subscriber.subscribe(channel);
+  const nextRequest = () => {
+    return new Promise((resolve, reject) => {
+      const onMessage = (_channel, message) => {
+        if (_channel !== channel) {
+          return;
+        }
+        let parsed = null;
+        try {
+          const raw = JSON.parse(message);
+          const safe = relayRequestSchema.safeParse(raw);
+          if (!safe.success) {
+            return;
+          }
+          parsed = safe.data;
+        } catch {
+          return;
+        }
+        cleanup();
+        resolve(parsed);
+      };
+      const onError = (error) => {
+        cleanup();
+        reject(error);
+      };
+      const cleanup = () => {
+        subscriber.off("message", onMessage);
+        subscriber.off("error", onError);
+      };
+      subscriber.on("message", onMessage);
+      subscriber.on("error", onError);
+    });
+  };
+  const close = async () => {
+    await subscriber.unsubscribe(channel).catch(() => void 0);
+    await subscriber.quit().catch(() => {
+      subscriber.disconnect();
+    });
+  };
+  return {
+    nextRequest,
+    close
+  };
+}
+async function sendRelayResponse(input) {
+  await resolveRelayResponse(input);
+}
 export {
   createRelayHandler,
+  createRelayRequestSubscription,
   createRelaySession,
+  sendRelayResponse,
   toRelayError
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@giselles-ai/browser-tool",
-	"version": "0.1.16",
+	"version": "0.1.18",
 	"type": "module",
 	"sideEffects": false,
 	"license": "Apache-2.0",
@@ -54,6 +54,14 @@
 		"react": ">=19.0.0",
 		"react-dom": ">=19.0.0"
 	},
+	"peerDependenciesMeta": {
+		"react": {
+			"optional": true
+		},
+		"react-dom": {
+			"optional": true
+		}
+	},
 	"devDependencies": {
 		"@types/node": "25.3.0",
 		"@types/react": "19.2.14",