@sensaiorg/adapter-chrome 0.1.0

package/dist/chrome-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome-adapter.d.ts","sourceRoot":"","sources":["../src/chrome-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AAKtB,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,aAAc,YAAW,gBAAgB;IACpD,QAAQ,CAAC,QAAQ,EAAG,QAAQ,CAAU;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAUzC;IAEF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,aAAa,CAAM;IAE3B,QAAQ,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,CAAQ;IACvC,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAQ;IAC1C,QAAQ,CAAC,WAAW,EAAE,oBAAoB,GAAG,IAAI,CAAQ;IACzD,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IACjD,QAAQ,CAAC,WAAW,EAAE,oBAAoB,GAAG,IAAI,CAAQ;IACzD,QAAQ,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAQ;IACvD,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAQ;gBAEvC,MAAM,GAAE,mBAAwB;IAWtC,UAAU,IAAI,OAAO,CAAC,gBAAgB,CAAC;IA+B7C,QAAQ,IAAI,IAAI;IAIhB,WAAW,IAAI,OAAO;IAItB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;CAI/C"}

package/dist/chrome-adapter.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * ChromeAdapter — implements IPlatformAdapter for Chrome browser debugging.
+ *
+ * Communication flow:
+ *   MCP Server <-> ChromeAdapter <-> WebSocket <-> Chrome Extension <-> chrome.debugger API <-> CDP
+ *
+ * The Chrome Extension uses chrome.debugger to attach to the active tab and
+ * forwards CDP commands/responses through a WebSocket connection to this adapter.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChromeAdapter = void 0;
+const cdp_bridge_js_1 = require("./transport/cdp-bridge.js");
+const chrome_tools_js_1 = require("./tools/chrome-tools.js");
+class ChromeAdapter {
+    platform = "chrome";
+    displayName;
+    capabilities = {
+        uiTree: true, // DOM tree -> UiNode
+        logs: true, // Console API messages
+        interaction: true, // Input.dispatch* via CDP
+        network: true, // Network domain (full request/response)
+        performance: true, // Performance domain + Web Vitals
+        screenshot: true, // Page.captureScreenshot
+        appState: true, // localStorage, cookies, sessionStorage
+        hotReload: false, // Not applicable for web (use browser refresh)
+        evalCode: true, // Runtime.evaluate
+    };
+    config;
+    bridge;
+    collector;
+    currentTabUrl = "";
+    ui = null; // TODO: DomUiProvider
+    logs = null; // TODO: ConsoleLogProvider
+    interaction = null; // TODO: CdpInteractionProvider
+    network = null; // TODO: CdpNetworkProvider
+    performance = null;
+    screenshot = null;
+    appState = null;
+    constructor(config = {}) {
+        this.config = {
+            wsPort: config.wsPort ?? parseInt(process.env.SENSAI_CHROME_PORT ?? "9230", 10),
+            tabUrlPattern: config.tabUrlPattern ?? process.env.SENSAI_CHROME_TAB_URL ?? "",
+        };
+        this.displayName = `Chrome (port ${this.config.wsPort})`;
+        this.bridge = new cdp_bridge_js_1.CdpBridge(this.config.wsPort);
+        this.collector = new chrome_tools_js_1.CdpEventCollector();
+    }
+    async initialize() {
+        try {
+            const connected = await this.bridge.connect();
+            if (connected) {
+                this.currentTabUrl = await this.bridge.getCurrentUrl();
+                // Enable CDP domains and start collecting console/network events
+                await this.collector.enableDomains(this.bridge).catch(() => {
+                    // Non-fatal: tools will still work, just no buffered events
+                });
+            }
+            return {
+                platform: "chrome",
+                device: `Chrome Tab: ${this.currentTabUrl || "none"}`,
+                connected,
+                capabilities: this.capabilities,
+                details: {
+                    wsPort: this.config.wsPort,
+                    tabUrl: this.currentTabUrl,
+                },
+            };
+        }
+        catch {
+            return {
+                platform: "chrome",
+                device: "Chrome (not connected)",
+                connected: false,
+                capabilities: this.capabilities,
+            };
+        }
+    }
+    shutdown() {
+        this.bridge.disconnect();
+    }
+    isConnected() {
+        return this.bridge.isConnected();
+    }
+    registerPlatformTools(server) {
+        const prefix = "chrome_";
+        (0, chrome_tools_js_1.registerChromeTools)(server, this.bridge, this.collector, prefix);
+    }
+}
+exports.ChromeAdapter = ChromeAdapter;
+//# sourceMappingURL=chrome-adapter.js.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * @sensai/adapter-chrome — Chrome/web platform adapter for SensAI.
+ *
+ * Provides debugging tools via Chrome DevTools Protocol (CDP).
+ * Communicates with the SensAI Chrome Extension via Native Messaging or WebSocket.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChromeAdapter = void 0;
+var chrome_adapter_js_1 = require("./chrome-adapter.js");
+Object.defineProperty(exports, "ChromeAdapter", { enumerable: true, get: function () { return chrome_adapter_js_1.ChromeAdapter; } });
+//# sourceMappingURL=index.js.map

package/dist/tools/chrome-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chrome-tools.d.ts","sourceRoot":"","sources":["../../src/tools/chrome-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAI5D,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,YAAY;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;IAClD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmC;IAClE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAO;IAClC,OAAO,CAAC,cAAc,CAAS;IAE/B,oEAAoE;IAC9D,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IA4GrD,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE;IAKjD,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE;IAMpD,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,WAAW;CASpB;AAID,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,iBAAiB,EAC5B,MAAM,EAAE,MAAM,GACb,IAAI,CAwiBN"}