webtool

webtool

webtool provides browser-backed web tools for the ds4 agent loop, matching the design of the upstream ds4 inference engine's browser helper (ds4_web.c).

It enables DeepSeek agent loops to search Google and visit web pages using a local Google Chrome or Chromium installation.

How it Works

1. Auto-Detection: The package automatically searches standard locations on macOS and Linux for a Google Chrome or Chromium executable (or reads the DS4_CHROME environment variable).
2. Process Management: It starts a visible Google Chrome process in the background configured with remote debugging enabled (--remote-debugging-port) and a dedicated user data directory (~/.ds4/browser).
3. CDP over Raw WebSockets: It connects to Chrome using the Chrome DevTools Protocol (CDP). To remain zero-dependency, it uses a lightweight, custom RFC 6455 WebSocket client implementation built on top of standard Go sockets.
4. Markdown Extraction: It navigates to pages, automatically bypasses Google Search consent forms, triggers lazy-loaded content by scrolling, and runs JavaScript-based Markdown extractors to compile clean structured text snapshots of pages.

Usage

You can initialize webtool.NewWebHelper and register its tools (GoogleSearchTool() and VisitPageTool()) directly into a ds4.ToolRegistry:

package main

import (
	"context"
	"fmt"
	"log"
	"strings"

	"github.com/NimbleMarkets/ds4go"
	"github.com/NimbleMarkets/ds4go/webtool"
)

func main() {
	// Initialize the helper
	helper := webtool.NewWebHelper(webtool.Config{
		Port: 9333,
		ConfirmApproval: func(message string) (bool, error) {
			// Web tools require explicit user confirmation to launch Chrome for the first time
			fmt.Print(message)
			var input string
			_, err := fmt.Scanln(&input)
			if err != nil {
				return false, err
			}
			input = strings.ToLower(strings.TrimSpace(input))
			return input == "y" || input == "yes", nil
		},
		Log: func(msg string) {
			log.Printf("[Browser Log] %s\n", msg)
		},
	})
	// Keep the browser running across tool execution rounds, but clean up on shutdown
	defer helper.Close()

	// Register tools
	reg := ds4.NewToolRegistry()
	reg.MustRegister(helper.GoogleSearchTool())
	reg.MustRegister(helper.VisitPageTool())

	// Configure and run the ds4 ToolLoop...
}

Available Tools

The following tools are exposed to the DeepSeek model:

google_search

• Description: Search Google in a visible browser and return compact Markdown links.
• Arguments:

  {
    "query": "search query string"
  }
  

visit_page

• Description: Open a URL in a visible browser and return rendered page Markdown.
• Arguments:

  {
    "url": "https://example.com"
  }
  

Configuration Options

The webtool.Config struct accepts the following configuration fields: