@giselles-ai/browser-tool 0.1.12 → 0.1.14

package/dist/react/index.d.ts

@@ -84,4 +84,45 @@ declare function BrowserToolProvider({ endpoint, children, }: BrowserToolProvide
 
 declare function useBrowserTool(): BrowserToolContextValue;
 
-export { type BrowserToolContextValue, BrowserToolProvider, type BrowserToolProviderProps, type BrowserToolRelayHandler, PromptPanel, type PromptPanelProps, browserTool, useBrowserTool };
+type ToolCallInfo = {
+    toolName: string;
+    toolCallId: string;
+    input?: unknown;
+    dynamic?: boolean;
+};
+type ToolOutputSuccess = {
+    tool: string;
+    toolCallId: string;
+    output: unknown;
+};
+type ToolOutputError = {
+    state: "output-error";
+    tool: string;
+    toolCallId: string;
+    errorText: string;
+};
+type AddToolOutputFn = (output: ToolOutputSuccess | ToolOutputError) => void;
+type BrowserToolChatHandler = {
+    onToolCall: (options: {
+        toolCall: ToolCallInfo;
+    }) => Promise<void>;
+    connect: (addToolOutput: AddToolOutputFn) => void;
+};
+/**
+ * Hook that encapsulates browser-tool handling for `useChat`'s `onToolCall`.
+ *
+ * Usage:
+ * ```ts
+ * const browserTool = useBrowserToolHandler();
+ * const { addToolOutput, ...chat } = useChat({
+ *   sendAutomaticallyWhen: lastAssistantMessageIsCompleteWithToolCalls,
+ *   ...browserTool,
+ * });
+ * browserTool.connect(addToolOutput);
+ * ```
+ */
+declare function useBrowserToolHandler(options?: {
+    onWarnings?: (warnings: string[]) => void;
+}): BrowserToolChatHandler;
+
+export { type BrowserToolChatHandler, type BrowserToolContextValue, BrowserToolProvider, type BrowserToolProviderProps, type BrowserToolRelayHandler, PromptPanel, type PromptPanelProps, browserTool, useBrowserTool, useBrowserToolHandler };

package/dist/react/index.js

@@ -709,9 +709,80 @@ function PromptPanel({
     ] })
   ] }) });
 }
+
+// src/react/use-chat-handler.ts
+import { useCallback as useCallback2, useRef } from "react";
+function isRecord3(value) {
+  return Boolean(value) && typeof value === "object";
+}
+function parseExecuteInput(value) {
+  if (!isRecord3(value)) {
+    return { actions: [], fields: [] };
+  }
+  return {
+    actions: Array.isArray(value.actions) ? value.actions : [],
+    fields: Array.isArray(value.fields) ? value.fields : []
+  };
+}
+function useBrowserToolHandler(options) {
+  const addToolOutputRef = useRef(void 0);
+  const onWarningsRef = useRef(options?.onWarnings);
+  onWarningsRef.current = options?.onWarnings;
+  const onToolCall = useCallback2(
+    async ({ toolCall }) => {
+      const addToolOutput = addToolOutputRef.current;
+      if (!addToolOutput || toolCall.dynamic) {
+        return;
+      }
+      try {
+        if (toolCall.toolName === "getFormSnapshot") {
+          const fields = snapshot();
+          addToolOutput({
+            tool: "getFormSnapshot",
+            toolCallId: toolCall.toolCallId,
+            output: { fields }
+          });
+          return;
+        }
+        if (toolCall.toolName === "executeFormActions") {
+          const { actions, fields } = parseExecuteInput(toolCall.input);
+          const report = execute(actions, fields);
+          if (report.warnings.length > 0) {
+            onWarningsRef.current?.(report.warnings);
+          }
+          addToolOutput({
+            tool: "executeFormActions",
+            toolCallId: toolCall.toolCallId,
+            output: { report }
+          });
+          return;
+        }
+        addToolOutput({
+          state: "output-error",
+          tool: toolCall.toolName,
+          toolCallId: toolCall.toolCallId,
+          errorText: `Unknown tool: ${toolCall.toolName}`
+        });
+      } catch (error) {
+        addToolOutput({
+          state: "output-error",
+          tool: toolCall.toolName,
+          toolCallId: toolCall.toolCallId,
+          errorText: error instanceof Error ? error.message : "Tool execution failed."
+        });
+      }
+    },
+    []
+  );
+  const connect = useCallback2((addToolOutput) => {
+    addToolOutputRef.current = addToolOutput;
+  }, []);
+  return { onToolCall, connect };
+}
 export {
   BrowserToolProvider,
   PromptPanel,
   browserTool,
-  useBrowserTool
+  useBrowserTool,
+  useBrowserToolHandler
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@giselles-ai/browser-tool",
-	"version": "0.1.12",
+	"version": "0.1.14",
 	"type": "module",
 	"sideEffects": false,
 	"license": "Apache-2.0",