@render-harness/cap-browser-browserbase 0.1.1

package/README.md

@@ -0,0 +1,18 @@
+## @render-harness/cap-browser-browserbase
+
+Wires Browserbase headless-browser into a Render harness entry:
+
+```yaml
+capabilities:
+  - pack: "@render-harness/cap-browser-browserbase"
+```
+
+Set `BROWSERBASE_API_KEY` and `BROWSERBASE_PROJECT_ID` in the entry's environment.
+
+The pack contributes:
+
+- An MCP server `cap-browser-browserbase.browserbase` (stdio transport, runs `npx -y @browserbasehq/mcp`).
+- A skill (`browserbase`).
+- Two env-schema entries.
+
+Browserbase is a hosted service; this pack adds no extra Render services.

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+import * as _render_harness_registry from '@render-harness/registry';
+
+/**
+ * cap-browser-browserbase — wires Browserbase's headless-browser MCP
+ * for any harness entry that needs to drive a real browser (login
+ * flows, JS-heavy pages, scraping behind paywalls / SPAs).
+ *
+ * Usage in render-harness.yaml:
+ *
+ *   capabilities:
+ *     - pack: "@render-harness/cap-browser-browserbase"
+ *
+ * Surfaces:
+ *   - One MCP server `browserbase` (stdio transport).
+ *   - One skill (skills/browserbase.md).
+ *   - envSchema entries for BROWSERBASE_API_KEY and BROWSERBASE_PROJECT_ID.
+ *
+ * Config keys:
+ *   - `apiKeyEnv` (string, default "BROWSERBASE_API_KEY")
+ *   - `projectIdEnv` (string, default "BROWSERBASE_PROJECT_ID")
+ *   - `command` (string, default "npx")
+ *   - `package` (string, default "@browserbasehq/mcp")
+ *
+ * Browserbase is a hosted browser pool, so this pack does NOT declare
+ * any extra Render services — sessions live on Browserbase's side.
+ */
+declare const pack: _render_harness_registry.CapabilityPack;
+
+export { pack as default };

package/dist/index.js

@@ -0,0 +1,71 @@
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { definePack } from '@render-harness/registry';
+
+// src/index.ts
+var HERE = dirname(fileURLToPath(import.meta.url));
+var SKILLS_DIR = join(HERE, "..", "skills");
+function readConfig(ctx) {
+  const cfg = ctx.config;
+  return {
+    apiKeyEnv: cfg.apiKeyEnv ?? "BROWSERBASE_API_KEY",
+    projectIdEnv: cfg.projectIdEnv ?? "BROWSERBASE_PROJECT_ID",
+    command: cfg.command ?? "npx",
+    pkg: cfg.package ?? "@browserbasehq/mcp"
+  };
+}
+var pack = definePack({
+  name: "cap-browser-browserbase",
+  version: "0.1.0",
+  envSchema: [
+    {
+      name: "BROWSERBASE_API_KEY",
+      required: true,
+      secret: true,
+      description: "API key for Browserbase (https://browserbase.com)."
+    },
+    {
+      name: "BROWSERBASE_PROJECT_ID",
+      required: true,
+      secret: false,
+      description: "Project ID in your Browserbase workspace."
+    }
+  ],
+  mcpServers(ctx) {
+    const cfg = readConfig(ctx);
+    const apiKey = ctx.env(cfg.apiKeyEnv);
+    const projectId = ctx.env(cfg.projectIdEnv);
+    if (!apiKey || !projectId) {
+      throw new Error(
+        `cap-browser-browserbase: missing ${cfg.apiKeyEnv} or ${cfg.projectIdEnv}. Set both before starting the agent.`
+      );
+    }
+    return [
+      {
+        name: "browserbase",
+        transport: "stdio",
+        command: cfg.command,
+        args: ["-y", cfg.pkg],
+        env: {
+          BROWSERBASE_API_KEY: apiKey,
+          BROWSERBASE_PROJECT_ID: projectId
+        }
+      }
+    ];
+  },
+  skills(_ctx) {
+    return [
+      {
+        name: "browserbase",
+        description: "Drive a real browser via Browserbase when scraping isn't enough.",
+        whenToUse: "When the page requires JS execution, login, click flows, or screenshots that aren't possible with HTTP scraping.",
+        contentPath: join(SKILLS_DIR, "browserbase.md")
+      }
+    ];
+  }
+});
+var src_default = pack;
+
+export { src_default as default };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;AA8BA,IAAM,IAAA,GAAO,OAAA,CAAQ,aAAA,CAAc,MAAA,CAAA,IAAA,CAAY,GAAG,CAAC,CAAA;AACnD,IAAM,UAAA,GAAa,IAAA,CAAK,IAAA,EAAM,IAAA,EAAM,QAAQ,CAAA;AAS5C,SAAS,WAAW,GAAA,EAAkB;AACpC,EAAA,MAAM,MAAM,GAAA,CAAI,MAAA;AAChB,EAAA,OAAO;AAAA,IACL,SAAA,EAAW,IAAI,SAAA,IAAa,qBAAA;AAAA,IAC5B,YAAA,EAAc,IAAI,YAAA,IAAgB,wBAAA;AAAA,IAClC,OAAA,EAAS,IAAI,OAAA,IAAW,KAAA;AAAA,IACxB,GAAA,EAAK,IAAI,OAAA,IAAW;AAAA,GACtB;AACF;AAEA,IAAM,OAAO,UAAA,CAAW;AAAA,EACtB,IAAA,EAAM,yBAAA;AAAA,EACN,OAAA,EAAS,OAAA;AAAA,EACT,SAAA,EAAW;AAAA,IACT;AAAA,MACE,IAAA,EAAM,qBAAA;AAAA,MACN,QAAA,EAAU,IAAA;AAAA,MACV,MAAA,EAAQ,IAAA;AAAA,MACR,WAAA,EAAa;AAAA,KACf;AAAA,IACA;AAAA,MACE,IAAA,EAAM,wBAAA;AAAA,MACN,QAAA,EAAU,IAAA;AAAA,MACV,MAAA,EAAQ,KAAA;AAAA,MACR,WAAA,EAAa;AAAA;AACf,GACF;AAAA,EACA,WAAW,GAAA,EAAqC;AAC9C,IAAA,MAAM,GAAA,GAAM,WAAW,GAAG,CAAA;AAC1B,IAAA,MAAM,MAAA,GAAS,GAAA,CAAI,GAAA,CAAI,GAAA,CAAI,SAAS,CAAA;AACpC,IAAA,MAAM,SAAA,GAAY,GAAA,CAAI,GAAA,CAAI,GAAA,CAAI,YAAY,CAAA;AAC1C,IAAA,IAAI,CAAC,MAAA,IAAU,CAAC,SAAA,EAAW;AACzB,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,CAAA,iCAAA,EAAoC,GAAA,CAAI,SAAS,CAAA,IAAA,EAAO,IAAI,YAAY,CAAA,qCAAA;AAAA,OAC1E;AAAA,IACF;AACA,IAAA,OAAO;AAAA,MACL;AAAA,QACE,IAAA,EAAM,aAAA;AAAA,QACN,SAAA,EAAW,OAAA;AAAA,QACX,SAAS,GAAA,CAAI,OAAA;AAAA,QACb,IAAA,EAAM,CAAC,IAAA,EAAM,GAAA,CAAI,GAAG,CAAA;AAAA,QACpB,GAAA,EAAK;AAAA,UACH,mBAAA,EAAqB,MAAA;AAAA,UACrB,sBAAA,EAAwB;AAAA;AAC1B;AACF,KACF;AAAA,EACF,CAAA;AAAA,EACA,OAAO,IAAA,EAAoC;AACzC,IAAA,OAAO;AAAA,MACL;AAAA,QACE,IAAA,EAAM,aAAA;AAAA,QACN,WAAA,EAAa,kEAAA;AAAA,QACb,SAAA,EACE,kHAAA;AAAA,QACF,WAAA,EAAa,IAAA,CAAK,UAAA,EAAY,gBAAgB;AAAA;AAChD,KACF;AAAA,EACF;AACF,CAAC,CAAA;AAED,IAAO,WAAA,GAAQ","file":"index.js","sourcesContent":["/**\n * cap-browser-browserbase — wires Browserbase's headless-browser MCP\n * for any harness entry that needs to drive a real browser (login\n * flows, JS-heavy pages, scraping behind paywalls / SPAs).\n *\n * Usage in render-harness.yaml:\n *\n *   capabilities:\n *     - pack: \"@render-harness/cap-browser-browserbase\"\n *\n * Surfaces:\n *   - One MCP server `browserbase` (stdio transport).\n *   - One skill (skills/browserbase.md).\n *   - envSchema entries for BROWSERBASE_API_KEY and BROWSERBASE_PROJECT_ID.\n *\n * Config keys:\n *   - `apiKeyEnv` (string, default \"BROWSERBASE_API_KEY\")\n *   - `projectIdEnv` (string, default \"BROWSERBASE_PROJECT_ID\")\n *   - `command` (string, default \"npx\")\n *   - `package` (string, default \"@browserbasehq/mcp\")\n *\n * Browserbase is a hosted browser pool, so this pack does NOT declare\n * any extra Render services — sessions live on Browserbase's side.\n */\n\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport type { McpServerConfig, SkillMetadata } from \"@render-harness/core\";\nimport { definePack, type PackContext } from \"@render-harness/registry\";\n\nconst HERE = dirname(fileURLToPath(import.meta.url));\nconst SKILLS_DIR = join(HERE, \"..\", \"skills\");\n\ninterface BrowserbaseConfig {\n  apiKeyEnv?: string;\n  projectIdEnv?: string;\n  command?: string;\n  package?: string;\n}\n\nfunction readConfig(ctx: PackContext) {\n  const cfg = ctx.config as BrowserbaseConfig;\n  return {\n    apiKeyEnv: cfg.apiKeyEnv ?? \"BROWSERBASE_API_KEY\",\n    projectIdEnv: cfg.projectIdEnv ?? \"BROWSERBASE_PROJECT_ID\",\n    command: cfg.command ?? \"npx\",\n    pkg: cfg.package ?? \"@browserbasehq/mcp\",\n  };\n}\n\nconst pack = definePack({\n  name: \"cap-browser-browserbase\",\n  version: \"0.1.0\",\n  envSchema: [\n    {\n      name: \"BROWSERBASE_API_KEY\",\n      required: true,\n      secret: true,\n      description: \"API key for Browserbase (https://browserbase.com).\",\n    },\n    {\n      name: \"BROWSERBASE_PROJECT_ID\",\n      required: true,\n      secret: false,\n      description: \"Project ID in your Browserbase workspace.\",\n    },\n  ],\n  mcpServers(ctx: PackContext): McpServerConfig[] {\n    const cfg = readConfig(ctx);\n    const apiKey = ctx.env(cfg.apiKeyEnv);\n    const projectId = ctx.env(cfg.projectIdEnv);\n    if (!apiKey || !projectId) {\n      throw new Error(\n        `cap-browser-browserbase: missing ${cfg.apiKeyEnv} or ${cfg.projectIdEnv}. Set both before starting the agent.`,\n      );\n    }\n    return [\n      {\n        name: \"browserbase\",\n        transport: \"stdio\",\n        command: cfg.command,\n        args: [\"-y\", cfg.pkg],\n        env: {\n          BROWSERBASE_API_KEY: apiKey,\n          BROWSERBASE_PROJECT_ID: projectId,\n        },\n      },\n    ];\n  },\n  skills(_ctx: PackContext): SkillMetadata[] {\n    return [\n      {\n        name: \"browserbase\",\n        description: \"Drive a real browser via Browserbase when scraping isn't enough.\",\n        whenToUse:\n          \"When the page requires JS execution, login, click flows, or screenshots that aren't possible with HTTP scraping.\",\n        contentPath: join(SKILLS_DIR, \"browserbase.md\"),\n      },\n    ];\n  },\n});\n\nexport default pack;\n"]}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@render-harness/cap-browser-browserbase",
+  "version": "0.1.1",
+  "description": "Browserbase headless-browser capability pack for the Render agent harness.",
+  "type": "module",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "skills"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "render-harness-cap",
+    "render-harness",
+    "browser",
+    "browserbase",
+    "mcp"
+  ],
+  "renderHarness": {
+    "gallery": {
+      "label": "Browserbase remote browser",
+      "envHint": "BROWSERBASE_API_KEY"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests"
+  },
+  "dependencies": {
+    "@render-harness/registry": "workspace:*"
+  },
+  "devDependencies": {
+    "@render-harness/core": "workspace:*",
+    "@types/node": "^25.6.2",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
+  }
+}

package/skills/browserbase.md

@@ -0,0 +1,26 @@
+---
+name: browserbase
+description: Drive a real browser via Browserbase when scraping isn't enough.
+when_to_use: When the page requires JS execution, login, click flows, or screenshots that aren't possible with HTTP scraping.
+---
+
+# Browser automation with Browserbase
+
+The `cap-browser-browserbase.browserbase` MCP exposes Browserbase's full tool set: create sessions, navigate, click, type, screenshot, and read DOM state. Sessions are hosted on Browserbase's infrastructure; nothing runs locally on the agent.
+
+## When to use Browserbase
+
+- The target page is a single-page app whose content only renders after JS executes.
+- You need to log in, click through a flow, or fill a form to get the data the user asked for.
+- You need a screenshot for the final reply.
+
+## When not to use Browserbase
+
+- A simple `firecrawl_scrape` would do. Browser sessions are expensive — try the cheaper path first.
+- The target is rate-limited or detection-aware. Browserbase resists most bot detection but isn't a license to abuse a site.
+
+## Hard rules
+
+- Always close the session when you're done (`browserbase_session_close`). Open sessions cost money.
+- Never enter credentials that aren't explicitly provided in the run input or stored under a deliberate "credential" key in long-term memory. If you need a login and don't have one, ask.
+- If you're scraping at scale, use `firecrawl_scrape` and batch — Browserbase is for interactive flows, not crawling.