bare-agent 0.3.3 → 0.3.4

package/README.md

@@ -72,6 +72,7 @@ Every piece works alone — take what you need, ignore the rest.
 | **Scheduler** | Cron (`0 9 * * 1-5`) or relative (`2h`, `30m`). Persisted jobs survive restarts |
 | **Stream** | Structured event emitter. Pipe as JSONL, subscribe in-process, or custom transport |
 | **Errors** | Typed hierarchy — `ProviderError`, `ToolError`, `TimeoutError`, `MaxRoundsError`, `CircuitOpenError` |
+| **Browsing** | Optional web navigation, clicking, typing, reading via `barebrowse`. Tools in bareagent format — pass directly to Loop |
 
 **Providers:** OpenAI-compatible (OpenAI, OpenRouter, Groq, vLLM, LM Studio), Anthropic, Ollama, CLIPipe (any CLI tool via stdin/stdout with real-time streaming), Fallback, or bring your own (one method: `generate`). All return the same shape — swap freely.
 
@@ -79,7 +80,7 @@ Every piece works alone — take what you need, ignore the rest.
 
 **Cross-language:** Runs as a subprocess. Communicate via JSONL on stdin/stdout from Python, Go, Rust, Ruby, Java, or anything that can spawn a process. Ready-made wrappers in [`contrib/`](contrib/README.md).
 
-**Deps:** 0 required. Optional: `cron-parser` (cron expressions), `better-sqlite3` (SQLite store).
+**Deps:** 0 required. Optional: `cron-parser` (cron expressions), `better-sqlite3` (SQLite store), `barebrowse` (web browsing).
 
 ---
 

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "bare-agent",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "files": [
     "index.js",
     "src/",
-    "bin/"
+    "bin/",
+    "tools/"
   ],
   "description": "Lightweight, composable agent orchestration. ~1700 lines, 0 required deps.",
   "license": "MIT",
@@ -21,7 +22,8 @@
     ".": "./index.js",
     "./providers": "./src/providers.js",
     "./stores": "./src/stores.js",
-    "./transports": "./src/transports.js"
+    "./transports": "./src/transports.js",
+    "./tools": "./src/tools.js"
   },
   "engines": {
     "node": ">=18"
@@ -36,6 +38,7 @@
     "lightweight"
   ],
   "optionalDependencies": {
+    "barebrowse": "^0.2.0",
     "cron-parser": "^4.9.0"
   },
   "peerDependencies": {

package/src/tools.js

@@ -0,0 +1,5 @@
+'use strict';
+
+const { createBrowsingTools } = require('../tools/browse');
+
+module.exports = { createBrowsingTools };

package/tools/browse.js

@@ -0,0 +1,18 @@
+'use strict';
+
+/**
+ * Creates browsing tools via barebrowse (optional dep).
+ * Returns { tools, close } or null if barebrowse is not installed.
+ * @param {object} [opts] - Options passed to barebrowse createBrowseTools
+ * @returns {Promise<{tools: Array, close: Function}|null>}
+ */
+async function createBrowsingTools(opts = {}) {
+  try {
+    const { createBrowseTools } = await import('barebrowse/bareagent');
+    return createBrowseTools(opts);
+  } catch {
+    return null;
+  }
+}
+
+module.exports = { createBrowsingTools };