bladebro 3.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bishesh Bhandari
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,52 @@
+# Bladebro
+
+God-tier agentic browser driver for AI agents. Few tools, full control, real stealth, max token efficiency.
+
+## Install
+
+```bash
+npm install -g bladebro
+```
+
+Or use without installing:
+
+```bash
+npx bladebro mcp
+```
+
+## Usage
+
+Bladebro speaks MCP (Model Context Protocol) over stdio. Point your AI agent at it:
+
+```json
+{
+  "mcpServers": {
+    "bladebro": {
+      "command": "bladebro",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+Five tools: `act`, `see`, `state`, `run`, `vision`. Full docs at [github.com/dondai44423/bladebro](https://github.com/dondai44423/bladebro).
+
+## Requirements
+
+- Node.js >= 14
+- Chrome/Chromium installed (Bladebro finds it automatically)
+
+## Platforms
+
+Prebuilt binaries available for:
+
+- Linux x86_64 (`linux-x64`)
+- macOS Apple Silicon (`darwin-arm64`) — coming soon
+- macOS Intel (`darwin-x64`) — coming soon
+- Windows x86_64 (`win32-x64`) — coming soon
+
+Other platforms: [build from source](https://github.com/dondai44423/bladebro#building-from-source).
+
+## License
+
+MIT

package/bin.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+'use strict';
+
+const { spawnSync } = require('child_process');
+const { existsSync } = require('fs');
+const { dirname, join } = require('path');
+
+// ── platform → npm package name mapping ──────────────────────────────
+const PLATFORM_MAP = {
+  'linux-x64':    'bladebro-linux-x64',
+  'linux-arm64':  'bladebro-linux-arm64',
+  'darwin-x64':   'bladebro-darwin-x64',
+  'darwin-arm64': 'bladebro-darwin-arm64',
+  'win32-x64':    'bladebro-win32-x64',
+};
+
+const key = process.platform + '-' + process.arch;
+const pkgName = PLATFORM_MAP[key];
+
+if (!pkgName) {
+  process.stderr.write('bladebro: no prebuilt binary for ' + key + '\n');
+  process.stderr.write('\nSupported platforms:\n');
+  process.stderr.write('  linux-x64     Linux x86_64\n');
+  process.stderr.write('  darwin-arm64  macOS Apple Silicon\n');
+  process.stderr.write('  darwin-x64    macOS Intel\n');
+  process.stderr.write('  win32-x64     Windows x86_64\n');
+  process.stderr.write('\nBuild from source: https://github.com/dondai44423/bladebro\n');
+  process.exit(1);
+}
+
+// ── resolve the binary path from the platform package ─────────────────
+let binPath;
+try {
+  const pkgJsonPath = require.resolve(pkgName + '/package.json');
+  const pkgJson = require(pkgJsonPath);
+  const binName = pkgJson.main || 'bladebro';
+  binPath = join(dirname(pkgJsonPath), binName);
+} catch (e) {
+  process.stderr.write('bladebro: platform package "' + pkgName + '" not installed\n');
+  process.stderr.write('Run: npm install bladebro\n');
+  process.exit(1);
+}
+
+// ── verify the binary exists ──────────────────────────────────────────
+if (!existsSync(binPath)) {
+  process.stderr.write('bladebro: binary not found at ' + binPath + '\n');
+  process.stderr.write('Reinstall: npm install bladebro\n');
+  process.exit(1);
+}
+
+// ── spawn the Rust binary with inherited stdio ────────────────────────
+const result = spawnSync(binPath, process.argv.slice(2), {
+  stdio: 'inherit',
+  cwd: process.cwd(),
+  env: process.env,
+});
+
+// Forward exit code or signal
+if (result.signal) {
+  // Re-raise the signal so the parent process sees it
+  process.kill(process.pid, result.signal);
+} else {
+  process.exit(result.status || 0);
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "bladebro",
+  "version": "3.0.0",
+  "description": "God-tier agentic browser driver for AI agents. Few tools, full control, real stealth, max token efficiency.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dondai44423/bladebro"
+  },
+  "homepage": "https://github.com/dondai44423/bladebro#readme",
+  "bugs": {
+    "url": "https://github.com/dondai44423/bladebro/issues"
+  },
+  "keywords": [
+    "browser",
+    "automation",
+    "agent",
+    "ai",
+    "mcp",
+    "cdp",
+    "chrome",
+    "stealth",
+    "scraper",
+    "puppeteer",
+    "playwright"
+  ],
+  "bin": {
+    "bladebro": "bin.js"
+  },
+  "files": [
+    "bin.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "optionalDependencies": {
+    "bladebro-linux-x64": "3.0.0"
+  },
+  "engines": {
+    "node": ">=14"
+  }
+}