@btraut/browser-bridge 0.6.1 → 0.7.0

package/CHANGELOG.md

@@ -8,6 +8,12 @@ The format is based on "Keep a Changelog", and this project adheres to Semantic
 
 _TBD_
 
+## [0.7.0] - 2026-02-10
+
+### Fixed
+
+- MCP adapter: avoid SDK `_zod` crashes on tool calls by registering object-shaped output schemas and flagging `ok: false` envelopes as MCP errors.
+
 ## [0.6.1] - 2026-02-10
 
 ### Added

package/README.md

@@ -82,6 +82,21 @@ What makes it different:
 - **Recovery-first**: sessions have an explicit state machine with `session.recover()` and `diagnostics doctor`.
 - **Inspect beyond screenshots**: DOM snapshots (AX + HTML) and `inspect dom-diff` to detect page changes.
 
+## 🆚 Feature Comparison
+
+| Category | Browser Bridge | Playwright MCP | agent-browser | mcp-chrome | Claude Code + Chrome |
+| --- | --- | --- | --- | --- | --- |
+| Uses your real, already-logged-in Chrome (tabs/cookies) | ✅ | ❌ | ❌ | ✅ | ✅ |
+| Visible browser (not headless) | ✅ | ✅ | ❌ | ✅ | ✅ |
+| Per-site permission prompts / allowlist | ✅ | ❌ | ❌ | ❌ | ✅ |
+| Drive/Inspect split (inspect without racing input) | ✅ | ❌ | ❌ | ❌ | ❌ |
+| Token-efficient inspection (element refs, bounded output, cleanup) | ✅ | ❌ | ❌ | ❌ | ❌ |
+| Structured errors + retry hints | ✅ | ❌ | ❌ | ❌ | ❌ |
+| Explicit recovery + doctor-style diagnostics | ✅ | ❌ | ❌ | ❌ | ❌ |
+| DOM diff (change detection) | ✅ | ❌ | ❌ | ❌ | ❌ |
+| HAR / network export | ✅ | ✅ | ✅ | ✅ | ❌ |
+| Open source | ✅ | ✅ | ✅ | ✅ | ❌ |
+
 ## 🔒 Site Permissions (Drive Actions)
 
 Browser Bridge is intentionally safe: **drive actions** (`drive.navigate`, click, type, etc.) require **per-site approval**. `inspect.*` is not gated, so agents can inspect first and only ask for permission when it's time to click/type.

package/dist/api.js

@@ -2888,7 +2888,6 @@ var successEnvelopeSchema = (result) => import_zod.z.object({
   ok: import_zod.z.literal(true),
   result
 });
-var apiEnvelopeSchema = (result) => import_zod.z.union([successEnvelopeSchema(result), ErrorEnvelopeSchema]);
 
 // packages/shared/src/schemas.ts
 var import_zod2 = require("zod");
@@ -4620,9 +4619,11 @@ var createCoreClient = (options = {}) => {
 var toToolResult = (payload) => {
   const content = [{ type: "text", text: JSON.stringify(payload) }];
   if (payload && typeof payload === "object") {
+    const isErrorEnvelope = ErrorEnvelopeSchema.safeParse(payload).success;
     return {
       content,
-      structuredContent: payload
+      structuredContent: payload,
+      isError: isErrorEnvelope
     };
   }
   return { content };
@@ -4635,7 +4636,7 @@ var toInternalErrorEnvelope = (error) => ({
     retryable: false
   }
 });
-var envelope = (schema) => apiEnvelopeSchema(schema);
+var envelope = (schema) => successEnvelopeSchema(schema);
 var TOOL_DEFINITIONS = [
   {
     name: "session.create",