bladebro 4.2.3 → 4.3.0

package/README.md

@@ -14,7 +14,71 @@ Or use without installing:
 npx bladebro mcp
 ```
 
-## Two ways to use Bladebro
+### DeepSeek Harness (DSH)
+
+Add Bladebro as a native plugin in the Web UI's **Plugins** page, or run:
+
+```bash
+dsh plugin --profile web add bladebro
+```
+
+Restart the profile and start a new chat. Desktop users can install `bladebro`
+from the same **Plugins** page. For terminal setup, enable Desktop's **Manage dsh
+Command**, fully quit the app, then use its bundled command:
+
+```bash
+dsh plugin --profile desktop add bladebro
+```
+
+Use Desktop's command for its profile; the npm DSH CLI cannot manage that
+app-owned profile. Open Desktop again after installation.
+
+DSH discovers the five tools as `mcp__bladebro__act`, `see`, `state`, `run` and
+`vision` (each with the same prefix). Schemas and descriptions come from the
+binary; DSH handles permissions, image attachments, reconnection and cleanup
+through its native MCP bridge. DSH may also expose its own generic MCP resource
+helpers and choose PTC presentation. No API key, separate MCP configuration, global
+Bladebro install or extra plugin package is needed. Chrome/Chromium must be
+installed on the machine running the DSH host. A remotely hosted Web UI controls
+that host's browser, rather than the device viewing the UI.
+
+Disable/re-enable the **Bladebro** bundle in Plugins, or remove it with
+`dsh plugin --profile web remove bladebro` (use `desktop` with Desktop's command).
+Restart the profile and begin a new chat after package changes. Other tools and
+settings remain intact. Do not also configure a second MCP server named
+`bladebro`; DSH refuses the duplicate namespace.
+
+Updates use DSH's package manager: `dsh plugin --profile web update bladebro`,
+or **Update** in Plugins. The plugin and native binary travel in the same
+package, so ordinary Bladebro releases update both. Existing global/Pi installs
+are separate. No background downloader or installation scripts run.
+
+Advanced configuration belongs in the profile's `cordis.patch.yml`:
+
+```yaml
+- id: bladebro
+  config:
+    # Optional absolute source-build/portable executable; package binary is default.
+    binaryPath: /absolute/path/to/bladebro
+    env:
+      CHROME_PATH: /absolute/path/to/chrome
+      BLADE_HOME: /absolute/path/to/private/browser-data
+    toolCallTimeoutMs: 180000
+```
+
+Windows YAML paths can use forward slashes, such as `C:/Tools/bladebro.exe`.
+The optional `cwd` and `reconnect` settings use DSH's native MCP configuration.
+The default per-call budget is 180 seconds; raise it for longer `run` sequences.
+Cancellation stops waiting, but an already-dispatched browser mutation may
+finish: observe its destination before trying it again.
+
+The npm CLI keeps its Node.js >=14 requirement; the DSH plugin uses the host's
+Node.js requirement. Prebuilt binaries cover Linux x64/ARM64 (glibc >=2.28),
+macOS Intel/Apple Silicon and Windows x64. Other targets need a source build and
+`binaryPath`. See the official [DSH plugin commands](https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/cli/reference/README.md#plugin-management)
+and [Desktop command runtime](https://github.com/deepseek-ai/deepseek-harness/blob/master/apps/desktop/README.md#bundled-command-runtime).
+
+## MCP and CLI
 
 ### Option 1: MCP Server
 

package/bin.js

@@ -2,50 +2,13 @@
 'use strict';
 
 const { spawnSync } = require('child_process');
-const { existsSync } = require('fs');
-const { dirname, join } = require('path');
+const { resolveBinary } = require('./binary.cjs');
 
-// ── 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-windows-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('  linux-arm64   Linux ARM64 (aarch64)\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');
+  binPath = resolveBinary();
+} catch (error) {
+  process.stderr.write(error.message + '\n');
   process.exit(1);
 }
 

package/binary.cjs

@@ -0,0 +1,41 @@
+'use strict';
+
+const { accessSync, constants, statSync } = require('fs');
+const { dirname, isAbsolute, join } = require('path');
+
+const PLATFORMS = {
+  'linux-x64': 'bladebro-linux-x64',
+  'linux-arm64': 'bladebro-linux-arm64',
+  'darwin-x64': 'bladebro-darwin-x64',
+  'darwin-arm64': 'bladebro-darwin-arm64',
+  'win32-x64': 'bladebro-windows-x64',
+};
+
+// Resolve beside this package, never through a shell or a desktop app's PATH.
+// Both the CLI launcher and DSH use the very same optional binary dependency.
+function resolveBinary(override) {
+  let path = override;
+  if (path !== undefined && (typeof path !== 'string' || !isAbsolute(path) || path.includes('\0'))) {
+    throw new Error('bladebro: binaryPath must be an absolute executable path');
+  }
+  if (path === undefined) {
+    const key = `${process.platform}-${process.arch}`;
+    const pkg = PLATFORMS[key];
+    if (!pkg) throw new Error(`bladebro: no prebuilt binary for ${key}. Build from source: https://github.com/dondai44423/bladebro#from-source`);
+    try {
+      const manifest = require.resolve(`${pkg}/package.json`);
+      path = join(dirname(manifest), process.platform === 'win32' ? 'bladebro.exe' : 'bladebro');
+    } catch {
+      throw new Error(`bladebro: platform package "${pkg}" not installed. Reinstall bladebro with optional dependencies enabled.`);
+    }
+  }
+  try {
+    if (!statSync(path).isFile()) throw new Error('not a file');
+    accessSync(path, process.platform === 'win32' ? constants.F_OK : constants.X_OK);
+  } catch (error) {
+    throw new Error(`bladebro: cannot execute ${path}: ${error.message}. Reinstall bladebro or set binaryPath.`);
+  }
+  return path;
+}
+
+module.exports = { resolveBinary };

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# A native DSH bundle: tools and lifecycle belong to the host's MCP bridge.
+- insert:
+    - id: bladebro
+      name: ./dsh-plugin.mjs

package/dsh-plugin.mjs

@@ -0,0 +1,33 @@
+import { resolveBinary } from './binary.cjs';
+
+export const name = 'bladebro';
+export const inject = ['tools'];
+
+// DSH owns discovery, schemas, images, cancellation, reconnection and disposal.
+// Import its bridge from the running host, so no private SDK copy can drift.
+export async function apply(ctx, config = {}) {
+  if (!config || typeof config !== 'object' || Array.isArray(config)) {
+    throw new Error('bladebro: plugin config must be an object');
+  }
+  const { binaryPath, ...options } = config;
+  for (const key of Object.keys(options)) {
+    if (!['env', 'cwd', 'toolCallTimeoutMs', 'reconnect'].includes(key)) {
+      throw new Error(`bladebro: unknown plugin option ${JSON.stringify(key)}`);
+    }
+  }
+  if (options.toolCallTimeoutMs !== undefined &&
+      (!Number.isSafeInteger(options.toolCallTimeoutMs) || options.toolCallTimeoutMs < 1000 || options.toolCallTimeoutMs > 2147483647)) {
+    throw new Error('bladebro: toolCallTimeoutMs must be an integer from 1000 through 2147483647');
+  }
+  const command = resolveBinary(binaryPath);
+  const bridge = await import('@deepseek-ai/dsh-mcp-client');
+  await ctx.plugin(bridge, {
+    toolCallTimeoutMs: 180000,
+    ...options,
+    transport: 'stdio',
+    serverName: 'bladebro',
+    command,
+    args: ['mcp'],
+    failOnStartupError: true,
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bladebro",
-  "version": "4.2.3",
+  "version": "4.3.0",
   "description": "Stealthy and efficient agentic browser driver for AI agents. Few tools, full control, real stealth, max token efficiency.",
   "license": "Apache-2.0",
   "repository": {
@@ -23,7 +23,8 @@
     "stealth",
     "scraper",
     "puppeteer",
-    "playwright"
+    "playwright",
+    "dsh-plugin"
   ],
   "pi": {
     "extensions": [
@@ -43,18 +44,26 @@
   },
   "files": [
     "bin.js",
+    "binary.cjs",
+    "dsh-plugin.mjs",
+    "cordis.patch.yml",
     "pi-extension.ts",
     "README.md",
     "LICENSE"
   ],
   "optionalDependencies": {
-    "bladebro-linux-x64": "4.2.3",
-    "bladebro-linux-arm64": "4.2.3",
-    "bladebro-darwin-x64": "4.2.3",
-    "bladebro-darwin-arm64": "4.2.3",
-    "bladebro-windows-x64": "4.2.3"
+    "bladebro-linux-x64": "4.3.0",
+    "bladebro-linux-arm64": "4.3.0",
+    "bladebro-darwin-x64": "4.3.0",
+    "bladebro-darwin-arm64": "4.3.0",
+    "bladebro-windows-x64": "4.3.0"
   },
   "engines": {
     "node": ">=14"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
   }
 }