@safebrowse/playwright-adapter 0.1.2-rc.1

package/LICENSE

@@ -0,0 +1,15 @@
+SafeBrowse Non-Commercial License 1.0
+
+Copyright (c) 2026 RobKang1234. All rights reserved.
+
+This package is licensed for non-commercial use only.
+
+You may use, copy, modify, and redistribute this package for
+non-commercial purposes only, provided that you preserve this license
+notice and all copyright notices.
+
+Commercial use is prohibited without prior written permission from the
+copyright holder.
+
+The full license text is distributed in the repository root `LICENSE`
+file for SafeBrowse.

package/README.md

@@ -0,0 +1,15 @@
+# `@safebrowse/playwright-adapter`
+
+Reference Playwright adapter for the SafeBrowse runtime.
+
+## Install
+
+```bash
+npm install @safebrowse/playwright-adapter playwright-core
+```
+
+This package keeps `playwright-core` as a peer dependency so you can match your own browser runtime.
+
+See the repository README for the broader SafeBrowse workflow:
+
+- https://github.com/RobKang1234/safebrowse-sdk#readme

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+import type { ActionProposal, RawObservationInput, SafeVerdict } from "@safebrowse/core";
+export interface PageLike {
+    url(): string;
+    content?(): Promise<string>;
+    title?(): Promise<string>;
+}
+export interface PlaywrightPageSnapshot {
+    url: string;
+    frameUrl?: string;
+    visibleText: string;
+    hiddenText?: string;
+    metadataText?: string[];
+    annotations?: string[];
+    renderedText?: string;
+    extractedText?: string;
+    userShared?: boolean;
+}
+export declare function createObservationFromSnapshot(snapshot: PlaywrightPageSnapshot): RawObservationInput;
+export declare function proposeNavigationAction(input: {
+    actionId: string;
+    currentUrl: string;
+    targetUrl: string;
+    riskClass?: ActionProposal["riskClass"];
+    requestedWrite?: boolean;
+}): ActionProposal;
+export declare function snapshotPage(page: PageLike): Promise<PlaywrightPageSnapshot>;
+export declare function enforceVerdict<T>(verdict: SafeVerdict, allowedAction: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEzF,MAAM,WAAW,QAAQ;IACvB,GAAG,IAAI,MAAM,CAAC;IACd,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,sBAAsB,GAC/B,mBAAmB,CAsCrB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;IACxC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,cAAc,CAajB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAWlF;AAED,wBAAsB,cAAc,CAAC,CAAC,EACpC,OAAO,EAAE,WAAW,EACpB,aAAa,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAC9B,OAAO,CAAC,CAAC,CAAC,CAOZ"}

package/dist/index.js

@@ -0,0 +1,71 @@
+export function createObservationFromSnapshot(snapshot) {
+    return {
+        sourceType: "page",
+        text: snapshot.visibleText,
+        fragments: [
+            {
+                text: snapshot.visibleText,
+                visibilityClass: "visible",
+                medium: "text",
+                sourceOrigin: snapshot.url,
+                frameOrigin: snapshot.frameUrl ?? snapshot.url
+            },
+            ...(snapshot.hiddenText
+                ? [
+                    {
+                        text: snapshot.hiddenText,
+                        visibilityClass: "hidden",
+                        medium: "metadata",
+                        sourceOrigin: snapshot.url,
+                        frameOrigin: snapshot.frameUrl ?? snapshot.url
+                    }
+                ]
+                : []),
+            ...(snapshot.metadataText ?? []).map((text) => ({
+                text,
+                visibilityClass: "metadata",
+                medium: "metadata",
+                sourceOrigin: snapshot.url,
+                frameOrigin: snapshot.frameUrl ?? snapshot.url
+            }))
+        ],
+        trustSignals: {
+            sourceOrigin: snapshot.url,
+            frameOrigin: snapshot.frameUrl ?? snapshot.url,
+            userSharedFlag: snapshot.userShared ?? false,
+            sessionDiscoveredFlag: !(snapshot.userShared ?? false)
+        }
+    };
+}
+export function proposeNavigationAction(input) {
+    return {
+        actionId: input.actionId,
+        verb: "navigate",
+        currentOrigin: input.currentUrl,
+        targetUrl: input.targetUrl,
+        riskClass: input.riskClass ?? "low",
+        requestedWrite: input.requestedWrite ?? false,
+        trustSignals: {
+            sourceOrigin: input.currentUrl,
+            frameOrigin: input.currentUrl
+        }
+    };
+}
+export async function snapshotPage(page) {
+    const [html, title] = await Promise.all([
+        page.content?.() ?? Promise.resolve(""),
+        page.title?.() ?? Promise.resolve("")
+    ]);
+    return {
+        url: page.url(),
+        visibleText: html,
+        metadataText: title ? [title] : []
+    };
+}
+export async function enforceVerdict(verdict, allowedAction) {
+    if (verdict.decision !== "ALLOW") {
+        throw new Error(`SafeBrowse blocked adapter execution with decision ${verdict.decision}: ${verdict.reasonCodes.join(", ")}`);
+    }
+    return allowedAction();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,6BAA6B,CAC3C,QAAgC;IAEhC,OAAO;QACL,UAAU,EAAE,MAAM;QAClB,IAAI,EAAE,QAAQ,CAAC,WAAW;QAC1B,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,QAAQ,CAAC,WAAW;gBAC1B,eAAe,EAAE,SAAS;gBAC1B,MAAM,EAAE,MAAM;gBACd,YAAY,EAAE,QAAQ,CAAC,GAAG;gBAC1B,WAAW,EAAE,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,GAAG;aAC/C;YACD,GAAG,CAAC,QAAQ,CAAC,UAAU;gBACrB,CAAC,CAAC;oBACE;wBACE,IAAI,EAAE,QAAQ,CAAC,UAAU;wBACzB,eAAe,EAAE,QAAiB;wBAClC,MAAM,EAAE,UAAmB;wBAC3B,YAAY,EAAE,QAAQ,CAAC,GAAG;wBAC1B,WAAW,EAAE,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,GAAG;qBAC/C;iBACF;gBACH,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,QAAQ,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC9C,IAAI;gBACJ,eAAe,EAAE,UAAmB;gBACpC,MAAM,EAAE,UAAmB;gBAC3B,YAAY,EAAE,QAAQ,CAAC,GAAG;gBAC1B,WAAW,EAAE,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,GAAG;aAC/C,CAAC,CAAC;SACJ;QACD,YAAY,EAAE;YACZ,YAAY,EAAE,QAAQ,CAAC,GAAG;YAC1B,WAAW,EAAE,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,GAAG;YAC9C,cAAc,EAAE,QAAQ,CAAC,UAAU,IAAI,KAAK;YAC5C,qBAAqB,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,IAAI,KAAK,CAAC;SACvD;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAMvC;IACC,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,IAAI,EAAE,UAAU;QAChB,aAAa,EAAE,KAAK,CAAC,UAAU;QAC/B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,KAAK;QACnC,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,KAAK;QAC7C,YAAY,EAAE;YACZ,YAAY,EAAE,KAAK,CAAC,UAAU;YAC9B,WAAW,EAAE,KAAK,CAAC,UAAU;SAC9B;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAc;IAC/C,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACtC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;KACtC,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;QACf,WAAW,EAAE,IAAI;QACjB,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;KACnC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAoB,EACpB,aAA+B;IAE/B,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,sDAAsD,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5G,CAAC;IACJ,CAAC;IACD,OAAO,aAAa,EAAE,CAAC;AACzB,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+    "name":  "@safebrowse/playwright-adapter",
+    "version":  "0.1.2-rc.1",
+    "description":  "Playwright reference adapter for the SafeBrowse runtime",
+    "license":  "SEE LICENSE IN LICENSE",
+    "type":  "module",
+    "main":  "dist/index.js",
+    "types":  "dist/index.d.ts",
+    "repository":  {
+                       "type":  "git",
+                       "url":  "git+https://github.com/RobKang1234/safebrowse-sdk.git",
+                       "directory":  "packages/playwright-adapter"
+                   },
+    "homepage":  "https://github.com/RobKang1234/safebrowse-sdk#readme",
+    "bugs":  {
+                 "url":  "https://github.com/RobKang1234/safebrowse-sdk/issues"
+             },
+    "keywords":  [
+                     "agent-security",
+                     "browser-agents",
+                     "playwright",
+                     "reference-adapter",
+                     "safebrowse"
+                 ],
+    "publishConfig":  {
+                          "access":  "public",
+                          "provenance":  false
+                      },
+    "engines":  {
+                    "node":  "\u003e=22.0.0"
+                },
+    "exports":  {
+                    ".":  {
+                              "types":  "./dist/index.d.ts",
+                              "import":  "./dist/index.js"
+                          }
+                },
+    "files":  [
+                  "dist",
+                  "README.md"
+              ],
+    "scripts":  {
+                    "build":  "tsc -p tsconfig.json",
+                    "typecheck":  "tsc -p tsconfig.json --noEmit"
+                },
+    "dependencies":  {
+                         "@safebrowse/core":  "0.1.2-rc.1"
+                     },
+    "peerDependencies":  {
+                             "playwright-core":  "\u003e=1.49.0"
+                         },
+    "peerDependenciesMeta":  {
+                                 "playwright-core":  {
+                                                         "optional":  true
+                                                     }
+                             },
+    "sideEffects":  false
+}