@olib-ai/owl-browser-sdk 2.0.0 → 2.0.1

package/README.md

@@ -346,6 +346,6 @@ MIT - See LICENSE file for details.
 ## Links
 
 - **Website**: https://www.owlbrowser.net
-- **Documentation**: https://docs.owlbrowser.net
+- **Documentation**: https://www.owlbrowser.net/docs
 - **GitHub**: https://github.com/Olib-AI/olib-browser
 - **Support**: support@olib.ai

package/openapi.json

@@ -3,7 +3,7 @@
   "info": {
     "title": "Owl Browser API",
     "description": "REST API for browser automation with anti-detection capabilities",
-    "version": "1.0.4"
+    "version": "1.0.7"
   },
   "servers": [
     {
@@ -25,6 +25,85 @@
     }
   },
   "paths": {
+    "/go": {
+      "get": {
+        "summary": "Browser Go",
+        "description": "One-shot browser navigation tool. Creates a new context, navigates to the URL, waits for page load, extracts the HTML, and closes the context. Optimized for single-page scraping or rendering tasks. Supports both GET and POST requests.",
+        "tags": [
+          "Navigation"
+        ],
+        "parameters": [
+          {
+            "name": "url",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "string"
+            },
+            "description": "The full URL to navigate to, including protocol (e.g., 'https://example.com'). Supports http://, https://, file://, and data: URLs"
+          },
+          {
+            "name": "wait_until",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "enum": [
+                "",
+                "load",
+                "domcontentloaded",
+                "networkidle",
+                "fullscroll"
+              ]
+            },
+            "description": "When to consider navigation complete: '' (return immediately), 'load' (wait for load event), 'domcontentloaded' (wait for DOMContentLoaded), 'networkidle' (wait for network to be idle, default), 'fullscroll' (scroll full page to trigger lazy loading, then scroll back to top)"
+          },
+          {
+            "name": "timeout",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "integer"
+            },
+            "description": "Maximum time to wait for navigation in milliseconds. Default: 30000 (30 seconds)"
+          },
+          {
+            "name": "os",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "enum": [
+                "windows",
+                "macos",
+                "linux"
+              ]
+            },
+            "description": "Filter profiles by operating system. Options: 'windows', 'macos', 'linux'"
+          },
+          {
+            "name": "use_tor",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "boolean"
+            },
+            "description": "Use TOR proxy for anonymous browsing. Each request gets a unique exit IP. Default: false"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Successful response"
+          },
+          "400": {
+            "description": "Bad request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          }
+        }
+      }
+    },
     "/api/execute/browser_create_context": {
       "post": {
         "summary": "Browser Create Context",
@@ -1882,7 +1961,7 @@
     "/api/execute/browser_extract_text": {
       "post": {
         "summary": "Browser Extract Text",
-        "description": "Extract visible text content from the page or a specific element. Returns plain text stripped of HTML tags. Optionally target a specific element using CSS selector or natural language description. Useful for reading page content, extracting article text, or getting form values.",
+        "description": "Extract visible text content from the page or a specific element. Returns plain text stripped of HTML tags. Optionally target a specific element using CSS selector or natural language description. Optionally apply a regex pattern to filter/extract specific content from the text. Useful for reading page content, extracting article text, getting form values, or extracting specific data like numbers, emails, or prices.",
         "tags": [
           "General"
         ],
@@ -1900,6 +1979,14 @@
                   "selector": {
                     "type": "string",
                     "description": "Optional CSS selector or natural language description to extract text from a specific element. If omitted, extracts all visible text from the entire page. Examples: '#main-content', 'article', 'the product description'"
+                  },
+                  "regex": {
+                    "type": "string",
+                    "description": "Optional regex pattern to apply to the extracted text. When provided, only content matching the regex will be returned. If both selector and regex are provided, the selector extracts text first, then regex filters the result. Examples: '\\\\d+' to extract numbers, '(?<=Price: )\\\\$[\\\\d.]+' to extract prices, '[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\\\.[A-Z|a-z]{2,}' for emails"
+                  },
+                  "regex_group": {
+                    "type": "string",
+                    "description": "Which capture group to return from the regex match. 0 returns the full match (default), 1 returns the first capture group, 2 returns the second, etc. Example: with regex 'FP ID:\\\\s*(\\\\S+)' and regex_group=1, only the ID value is returned."
                   }
                 },
                 "required": [
@@ -6968,7 +7055,7 @@
     "/api/execute/server_restart_browser": {
       "post": {
         "summary": "Server Restart Browser",
-        "description": "Restart the browser process. This stops the current browser subprocess and starts a new one. Useful after updating configuration, adding/removing licenses, or recovering from browser errors. All active browser contexts will be terminated. Returns success/failure status.",
+        "description": "Restart the HTTP server and browser via s6-overlay process supervisor. This performs a clean restart of the entire service, ensuring both the HTTP server and browser processes are fully restarted. Useful for recovering from browser hangs, memory issues, or applying configuration changes. All active browser contexts will be terminated. The restart is non-blocking - the response is sent before the restart occurs (~1 second delay). In Docker containers, uses s6-svc for graceful restart. Falls back to browser-only restart in non-Docker environments.",
         "tags": [
           "General"
         ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olib-ai/owl-browser-sdk",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Node.js SDK for Owl Browser automation - Async-first with dynamic OpenAPI method generation",
   "main": "dist/index.js",
   "module": "dist/index.js",