@volter-ai-dev/supercode-browser-playwright 0.1.0

package/dist/provider.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The provider: one Playwright connection over CDP, one page, and the
+ * `supercode/browser-provider-v1` envelope around each operation call.
+ */
+import { SUPERCODE_BROWSER_PROVIDER_PROTOCOL, type BrowserOperationResult } from "./protocol.js";
+/** Bound for one provider request (`BROWSER_PROVIDER_MAX_REQUEST_BYTES`). */
+export declare const MAX_REQUEST_BYTES: number;
+/** Bound for one provider response (`BROWSER_PROVIDER_MAX_RESPONSE_BYTES`). */
+export declare const MAX_RESPONSE_BYTES: number;
+export interface PlaywrightBrowserProviderOptions {
+    /** CDP endpoint: `http://…` (resolved through `/json/version`) or `ws://…`. */
+    cdpUrl: string;
+    /** Hex token every request must carry. */
+    token: string;
+    /** True when the endpoint dispatches `isTrusted:false` input (an AlmostCDP endpoint). */
+    syntheticEvents: boolean;
+}
+/** The provider-v1 response envelope the harness reads. */
+export interface ProviderResponse {
+    protocol: typeof SUPERCODE_BROWSER_PROVIDER_PROTOCOL;
+    id: string | null;
+    result: BrowserOperationResult;
+}
+export interface PlaywrightBrowserProvider {
+    readonly token: string;
+    /** Validate one provider-v1 request and answer it with a provider-v1 response. */
+    handle(request: unknown): Promise<ProviderResponse>;
+    /** Disconnect from the endpoint. The browser itself is left running. */
+    close(): Promise<void>;
+}
+export declare function createPlaywrightBrowserProvider(options: PlaywrightBrowserProviderOptions): PlaywrightBrowserProvider;

package/dist/serve.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Two framings of the same provider-v1 envelope.
+ *
+ * - TCP (the harness's wire, `crates/harness/src/browser.rs`): one
+ *   newline-terminated JSON request per connection, one JSON response, close.
+ *   Discovery is an owner-only record under `<providers dir>/browser/<id>.json`.
+ * - HTTP: `POST /` with the request JSON as the body, the response JSON as the
+ *   body, for a host that can reach the provider only by HTTP.
+ */
+import { type PlaywrightBrowserProvider } from "./provider.js";
+export interface ServeHandle {
+    framing: "tcp" | "http";
+    port: number;
+    /** The discovery record written for the TCP framing. */
+    discoveryPath?: string;
+    stop(): Promise<void>;
+}
+/** Supercode's providers directory, resolved as `browser_provider_directory()` resolves its parent. */
+export declare function defaultProvidersDirectory(): string;
+export interface TcpServeOptions {
+    port: number;
+    /** Parent of `browser/`; defaults to Supercode's providers directory. */
+    providersDirectory?: string;
+    /** Workspace the discovery record is scoped to; defaults to the working directory. */
+    workspace?: string;
+    syntheticEvents: boolean;
+}
+export declare function serveTcp(provider: PlaywrightBrowserProvider, options: TcpServeOptions): Promise<ServeHandle>;
+export interface HttpServeOptions {
+    port: number;
+}
+export declare function serveHttp(provider: PlaywrightBrowserProvider, options: HttpServeOptions): Promise<ServeHandle>;

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@volter-ai-dev/supercode-browser-playwright",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Supercode browser provider that is an unmodified playwright-core client over CDP, and the browser-operation wire it answers",
+  "bin": {
+    "supercode-browser-playwright": "bin/supercode-browser-playwright"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    },
+    "./protocol": {
+      "types": "./dist/protocol.d.ts",
+      "import": "./dist/protocol.mjs"
+    },
+    "./executor": {
+      "types": "./dist/executor.d.ts",
+      "import": "./dist/executor.mjs"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "bin",
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "playwright-core": "1.63.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "esbuild": "^0.25.0",
+    "typescript": "5.6.3"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT OR Apache-2.0"
+}