@ai-agent-forge/plugin-browser-playwright 0.88.3

package/dist/types.d.ts

@@ -0,0 +1,270 @@
+/**
+ * Browser capability contracts for the built-in Playwright plugin.
+ *
+ * The plugin is the product's single browser channel. Playwright itself is
+ * never bundled: the driver resolves it from `<agentDir>/browser-deps` at
+ * connect time and `browser_setup` installs it on first use. Everything here
+ * is host-independent; hosts and tests inject a `BrowserRuntimeV1` whose
+ * `connect()` yields a driver, so the capability layer never imports
+ * Playwright types.
+ */
+import type { PluginResultV1 } from "@agent-forge/plugin-sdk";
+export type BrowserLocatorKindV1 = "css" | "id" | "role" | "text" | "test-id";
+export interface BrowserLocatorV1 {
+    readonly kind: BrowserLocatorKindV1;
+    readonly value: string;
+    /** Accessible name refinement for `kind: "role"`. */
+    readonly name?: string;
+}
+export type BrowserWaitUntilV1 = "commit" | "domcontentloaded" | "load" | "networkidle";
+export interface BrowserNavigateInputV1 {
+    readonly url: string;
+    readonly waitUntil?: BrowserWaitUntilV1;
+}
+export interface BrowserSnapshotInputV1 {
+    readonly includeDom?: boolean;
+    readonly includeA11y?: boolean;
+    readonly includeStyles?: boolean;
+    readonly includeScreenshot?: boolean;
+}
+export type BrowserLocatorActionKindV1 = "click" | "dblclick" | "rightclick" | "fill" | "type" | "press" | "hover" | "select" | "check" | "uncheck" | "clear" | "upload" | "scroll";
+export interface BrowserLocatorActionInputV1 {
+    readonly locator: BrowserLocatorV1;
+    readonly action: BrowserLocatorActionKindV1;
+    /**
+     * Value for `fill`, `type`, and `select`; for `upload` a single absolute
+     * file path or a JSON array of paths; for `scroll` a `<direction>:<pixels>`
+     * directive (`down:500`, `up:200`, `left:100`, `right:100`).
+     */
+    readonly value?: string;
+    /** Key sequence for `press`. */
+    readonly key?: string;
+    /** Inter-key delay in milliseconds for `type`. */
+    readonly delay?: number;
+}
+export interface BrowserEvaluateInputV1 {
+    /**
+     * JavaScript expression evaluated via `page.evaluate`. Keep it a plain
+     * expression (`document.title`, `1 + 1`); for multi-statement logic use an
+     * IIFE string (`(() => { ... return x; })()`) — a bare `() => ...` string is
+     * not invoked by Playwright and serializes to `undefined`.
+     */
+    readonly expression: string;
+    /** JSON-serializable argument passed through to the page context. */
+    readonly arg?: unknown;
+}
+export interface BrowserConsoleReadInputV1 {
+    /** Comma-combined level filter: error/warning/info/debug (`info` also matches `log`). */
+    readonly level?: string;
+    /** Substring filter on the message text. */
+    readonly contains?: string;
+    /** Most-recent count to return; defaults to 50. */
+    readonly limit?: number;
+}
+export interface BrowserConsoleEntryV1 {
+    readonly type: string;
+    readonly text: string;
+    readonly location?: {
+        readonly url: string;
+        readonly lineNumber: number;
+        readonly columnNumber: number;
+    };
+    readonly timestamp: number;
+}
+export interface BrowserNetworkReadInputV1 {
+    readonly containsUrl?: string;
+    readonly status?: number;
+    readonly method?: string;
+    /** Most-recent count to return; defaults to 50. */
+    readonly limit?: number;
+}
+export interface BrowserNetworkEntryV1 {
+    readonly method: string;
+    readonly url: string;
+    readonly status: number;
+    readonly timestamp: number;
+    /** Wall-clock duration in milliseconds when the request timing is available. */
+    readonly durationMs?: number;
+    /** Response `content-length` in bytes when the header is present. */
+    readonly sizeBytes?: number;
+}
+/** Raw in-page performance collection; the driver shapes it into {@link BrowserPerformancePayloadV1}. */
+export interface BrowserPerformanceRawV1 {
+    readonly navigation: {
+        readonly ttfbMs: number;
+        readonly domContentLoadedMs: number;
+        readonly loadMs: number;
+    } | null;
+    readonly paints: readonly {
+        readonly name: string;
+        readonly startTimeMs: number;
+    }[];
+    readonly resources: readonly {
+        readonly url: string;
+        readonly durationMs: number;
+        readonly transferBytes: number;
+    }[];
+    readonly domNodes: number;
+}
+export interface BrowserPerformancePayloadV1 {
+    readonly navigation?: {
+        readonly ttfbMs: number;
+        readonly domContentLoadedMs: number;
+        readonly loadMs: number;
+    };
+    readonly paint: {
+        readonly firstPaintMs?: number;
+        readonly firstContentfulPaintMs?: number;
+    };
+    readonly resources: {
+        readonly count: number;
+        readonly totalTransferBytes: number;
+        readonly slowest: readonly {
+            readonly url: string;
+            readonly durationMs: number;
+        }[];
+    };
+    readonly domNodes: number;
+}
+export type BrowserWaitUntilKindV1 = "selector" | "navigation" | "networkidle" | "time";
+export interface BrowserWaitInputV1 {
+    readonly until: BrowserWaitUntilKindV1;
+    /** Locator for `until: "selector"` (waits for the element to be visible). */
+    readonly locator?: BrowserLocatorV1;
+    /** Milliseconds; required for `until: "time"`, optional timeout for the others. Clamped to 30000. */
+    readonly ms?: number;
+}
+export interface BrowserDragInputV1 {
+    readonly from: BrowserLocatorV1;
+    readonly to: BrowserLocatorV1;
+    /** Number of intermediate mouse moves over the target; defaults to 8. */
+    readonly steps?: number;
+}
+export type BrowserMouseActionKindV1 = "move" | "click" | "dblclick" | "rightclick" | "wheel";
+export type BrowserMouseButtonV1 = "left" | "right" | "middle";
+export interface BrowserMouseInputV1 {
+    readonly action: BrowserMouseActionKindV1;
+    /** Non-negative integer viewport x coordinate. */
+    readonly x: number;
+    /** Non-negative integer viewport y coordinate. */
+    readonly y: number;
+    /** Horizontal wheel delta in pixels (`wheel`). */
+    readonly deltaX?: number;
+    /** Vertical wheel delta in pixels (`wheel`). */
+    readonly deltaY?: number;
+    readonly button?: BrowserMouseButtonV1;
+}
+export interface BrowserPressKeyInputV1 {
+    /** Playwright key name, e.g. `Control+a`, `Enter`, `Meta+c`. */
+    readonly key: string;
+    /** Delay between keydown and keyup in milliseconds. */
+    readonly delay?: number;
+}
+export type BrowserTabsActionKindV1 = "list" | "new" | "switch" | "close";
+export interface BrowserTabsInputV1 {
+    readonly action: BrowserTabsActionKindV1;
+    /** Tab index for `switch` and `close`. */
+    readonly index?: number;
+    /** URL for `new`; defaults to `about:blank`. */
+    readonly url?: string;
+}
+export type BrowserStorageActionKindV1 = "get-cookies" | "set-cookie" | "clear-cookies" | "get-local" | "set-local" | "clear-local";
+export interface BrowserStorageInputV1 {
+    readonly action: BrowserStorageActionKindV1;
+    /** Cookie name for `set-cookie`. */
+    readonly name?: string;
+    /** Cookie value for `set-cookie`; localStorage value for `set-local`. */
+    readonly value?: string;
+    /** Cookie domain for `set-cookie` (Playwright requires domain or url). */
+    readonly domain?: string;
+    readonly path?: string;
+    /** Cookie expiry as Unix seconds; omit for a session cookie. */
+    readonly expires?: number;
+    /** localStorage key for `get-local` and `set-local`. */
+    readonly key?: string;
+}
+export type BrowserViewportActionKindV1 = "set" | "get";
+export interface BrowserViewportInputV1 {
+    readonly action: BrowserViewportActionKindV1;
+    /** Requested width; clamped into 320..7680. */
+    readonly width?: number;
+    /** Requested height; clamped into 320..7680. */
+    readonly height?: number;
+}
+export type BrowserElementStateV1 = "visible" | "hidden" | "value";
+export type BrowserPostconditionV1 = {
+    readonly kind: "url";
+    readonly equals?: string;
+    readonly contains?: string;
+} | {
+    readonly kind: "element";
+    readonly locator: BrowserLocatorV1;
+    readonly state: BrowserElementStateV1;
+    readonly value?: string;
+} | {
+    readonly kind: "text";
+    readonly locator?: BrowserLocatorV1;
+    readonly contains: string;
+} | {
+    readonly kind: "console";
+    readonly contains: string;
+    readonly level?: string;
+} | {
+    readonly kind: "network";
+    readonly containsUrl: string;
+    readonly status?: number;
+};
+/** `browser_collect_evidence` kinds; console/network come from bounded page ring buffers. */
+export type BrowserEvidenceKindV1 = "console" | "network" | "snapshot";
+export interface BrowserOperationOptionsV1 {
+    readonly operationId?: string;
+    readonly signal?: AbortSignal;
+}
+/**
+ * Driver contract behind `BrowserRuntimeV1`. Every operation returns a
+ * validated `PluginResultV1`; failures are structured results, not throws
+ * (module/install problems surface as thrown errors at `connect` time and are
+ * sanitized by the capability layer). Structured payloads (console/network
+ * entries, performance metrics, evaluate results, storage and tab state) are
+ * carried as bounded JSON text in evidence summaries.
+ */
+export interface BrowserDriverV1 {
+    navigate(input: BrowserNavigateInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;
+    snapshot(input?: BrowserSnapshotInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;
+    locatorAction(input: BrowserLocatorActionInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;
+    assertPostcondition(input: BrowserPostconditionV1 | readonly BrowserPostconditionV1[], options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;
+    collectEvidence(kind: BrowserEvidenceKindV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;
+    /** Escape hatch: runs a JS expression in the page context; use only when no built-in tool covers the operation. */
+    evaluate(input: BrowserEvaluateInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;
+    consoleEntries(input: BrowserConsoleReadInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;
+    networkEntries(input: BrowserNetworkReadInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;
+    /** Navigation Timing, paint, resource summary, and DOM node count; read-only. */
+    performance(options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;
+    wait(input: BrowserWaitInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;
+    drag(input: BrowserDragInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;
+    mouse(input: BrowserMouseInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;
+    pressKey(input: BrowserPressKeyInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;
+    tabs(input: BrowserTabsInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;
+    storage(input: BrowserStorageInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;
+    viewport(input: BrowserViewportInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;
+    /** Idempotent, best-effort teardown; never throws. */
+    close(): void;
+}
+export type BrowserSetupOutcomeV1 = {
+    readonly ok: true;
+    readonly alreadyInstalled: boolean;
+    readonly log: string;
+} | {
+    readonly ok: false;
+    readonly message: string;
+};
+/**
+ * Injection face for the capability factory. Tests bind a fake runtime over a
+ * mock driver; the production entry binds `PlaywrightBrowserRuntimeV1`, whose
+ * optional `setup()` self-installs Playwright into `<agentDir>/browser-deps`.
+ */
+export interface BrowserRuntimeV1 {
+    connect(): Promise<BrowserDriverV1>;
+    setup?(): Promise<BrowserSetupOutcomeV1>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Browser capability contracts for the built-in Playwright plugin.\n *\n * The plugin is the product's single browser channel. Playwright itself is\n * never bundled: the driver resolves it from `<agentDir>/browser-deps` at\n * connect time and `browser_setup` installs it on first use. Everything here\n * is host-independent; hosts and tests inject a `BrowserRuntimeV1` whose\n * `connect()` yields a driver, so the capability layer never imports\n * Playwright types.\n */\nimport type { PluginResultV1 } from \"@agent-forge/plugin-sdk\";\n\nexport type BrowserLocatorKindV1 = \"css\" | \"id\" | \"role\" | \"text\" | \"test-id\";\n\nexport interface BrowserLocatorV1 {\n\treadonly kind: BrowserLocatorKindV1;\n\treadonly value: string;\n\t/** Accessible name refinement for `kind: \"role\"`. */\n\treadonly name?: string;\n}\n\nexport type BrowserWaitUntilV1 = \"commit\" | \"domcontentloaded\" | \"load\" | \"networkidle\";\n\nexport interface BrowserNavigateInputV1 {\n\treadonly url: string;\n\treadonly waitUntil?: BrowserWaitUntilV1;\n}\n\nexport interface BrowserSnapshotInputV1 {\n\treadonly includeDom?: boolean;\n\treadonly includeA11y?: boolean;\n\treadonly includeStyles?: boolean;\n\treadonly includeScreenshot?: boolean;\n}\n\nexport type BrowserLocatorActionKindV1 =\n\t| \"click\"\n\t| \"dblclick\"\n\t| \"rightclick\"\n\t| \"fill\"\n\t| \"type\"\n\t| \"press\"\n\t| \"hover\"\n\t| \"select\"\n\t| \"check\"\n\t| \"uncheck\"\n\t| \"clear\"\n\t| \"upload\"\n\t| \"scroll\";\n\nexport interface BrowserLocatorActionInputV1 {\n\treadonly locator: BrowserLocatorV1;\n\treadonly action: BrowserLocatorActionKindV1;\n\t/**\n\t * Value for `fill`, `type`, and `select`; for `upload` a single absolute\n\t * file path or a JSON array of paths; for `scroll` a `<direction>:<pixels>`\n\t * directive (`down:500`, `up:200`, `left:100`, `right:100`).\n\t */\n\treadonly value?: string;\n\t/** Key sequence for `press`. */\n\treadonly key?: string;\n\t/** Inter-key delay in milliseconds for `type`. */\n\treadonly delay?: number;\n}\n\nexport interface BrowserEvaluateInputV1 {\n\t/**\n\t * JavaScript expression evaluated via `page.evaluate`. Keep it a plain\n\t * expression (`document.title`, `1 + 1`); for multi-statement logic use an\n\t * IIFE string (`(() => { ... return x; })()`) — a bare `() => ...` string is\n\t * not invoked by Playwright and serializes to `undefined`.\n\t */\n\treadonly expression: string;\n\t/** JSON-serializable argument passed through to the page context. */\n\treadonly arg?: unknown;\n}\n\nexport interface BrowserConsoleReadInputV1 {\n\t/** Comma-combined level filter: error/warning/info/debug (`info` also matches `log`). */\n\treadonly level?: string;\n\t/** Substring filter on the message text. */\n\treadonly contains?: string;\n\t/** Most-recent count to return; defaults to 50. */\n\treadonly limit?: number;\n}\n\nexport interface BrowserConsoleEntryV1 {\n\treadonly type: string;\n\treadonly text: string;\n\treadonly location?: { readonly url: string; readonly lineNumber: number; readonly columnNumber: number };\n\treadonly timestamp: number;\n}\n\nexport interface BrowserNetworkReadInputV1 {\n\treadonly containsUrl?: string;\n\treadonly status?: number;\n\treadonly method?: string;\n\t/** Most-recent count to return; defaults to 50. */\n\treadonly limit?: number;\n}\n\nexport interface BrowserNetworkEntryV1 {\n\treadonly method: string;\n\treadonly url: string;\n\treadonly status: number;\n\treadonly timestamp: number;\n\t/** Wall-clock duration in milliseconds when the request timing is available. */\n\treadonly durationMs?: number;\n\t/** Response `content-length` in bytes when the header is present. */\n\treadonly sizeBytes?: number;\n}\n\n/** Raw in-page performance collection; the driver shapes it into {@link BrowserPerformancePayloadV1}. */\nexport interface BrowserPerformanceRawV1 {\n\treadonly navigation: {\n\t\treadonly ttfbMs: number;\n\t\treadonly domContentLoadedMs: number;\n\t\treadonly loadMs: number;\n\t} | null;\n\treadonly paints: readonly { readonly name: string; readonly startTimeMs: number }[];\n\treadonly resources: readonly { readonly url: string; readonly durationMs: number; readonly transferBytes: number }[];\n\treadonly domNodes: number;\n}\n\nexport interface BrowserPerformancePayloadV1 {\n\treadonly navigation?: { readonly ttfbMs: number; readonly domContentLoadedMs: number; readonly loadMs: number };\n\treadonly paint: { readonly firstPaintMs?: number; readonly firstContentfulPaintMs?: number };\n\treadonly resources: {\n\t\treadonly count: number;\n\t\treadonly totalTransferBytes: number;\n\t\treadonly slowest: readonly { readonly url: string; readonly durationMs: number }[];\n\t};\n\treadonly domNodes: number;\n}\n\nexport type BrowserWaitUntilKindV1 = \"selector\" | \"navigation\" | \"networkidle\" | \"time\";\n\nexport interface BrowserWaitInputV1 {\n\treadonly until: BrowserWaitUntilKindV1;\n\t/** Locator for `until: \"selector\"` (waits for the element to be visible). */\n\treadonly locator?: BrowserLocatorV1;\n\t/** Milliseconds; required for `until: \"time\"`, optional timeout for the others. Clamped to 30000. */\n\treadonly ms?: number;\n}\n\nexport interface BrowserDragInputV1 {\n\treadonly from: BrowserLocatorV1;\n\treadonly to: BrowserLocatorV1;\n\t/** Number of intermediate mouse moves over the target; defaults to 8. */\n\treadonly steps?: number;\n}\n\nexport type BrowserMouseActionKindV1 = \"move\" | \"click\" | \"dblclick\" | \"rightclick\" | \"wheel\";\nexport type BrowserMouseButtonV1 = \"left\" | \"right\" | \"middle\";\n\nexport interface BrowserMouseInputV1 {\n\treadonly action: BrowserMouseActionKindV1;\n\t/** Non-negative integer viewport x coordinate. */\n\treadonly x: number;\n\t/** Non-negative integer viewport y coordinate. */\n\treadonly y: number;\n\t/** Horizontal wheel delta in pixels (`wheel`). */\n\treadonly deltaX?: number;\n\t/** Vertical wheel delta in pixels (`wheel`). */\n\treadonly deltaY?: number;\n\treadonly button?: BrowserMouseButtonV1;\n}\n\nexport interface BrowserPressKeyInputV1 {\n\t/** Playwright key name, e.g. `Control+a`, `Enter`, `Meta+c`. */\n\treadonly key: string;\n\t/** Delay between keydown and keyup in milliseconds. */\n\treadonly delay?: number;\n}\n\nexport type BrowserTabsActionKindV1 = \"list\" | \"new\" | \"switch\" | \"close\";\n\nexport interface BrowserTabsInputV1 {\n\treadonly action: BrowserTabsActionKindV1;\n\t/** Tab index for `switch` and `close`. */\n\treadonly index?: number;\n\t/** URL for `new`; defaults to `about:blank`. */\n\treadonly url?: string;\n}\n\nexport type BrowserStorageActionKindV1 =\n\t| \"get-cookies\"\n\t| \"set-cookie\"\n\t| \"clear-cookies\"\n\t| \"get-local\"\n\t| \"set-local\"\n\t| \"clear-local\";\n\nexport interface BrowserStorageInputV1 {\n\treadonly action: BrowserStorageActionKindV1;\n\t/** Cookie name for `set-cookie`. */\n\treadonly name?: string;\n\t/** Cookie value for `set-cookie`; localStorage value for `set-local`. */\n\treadonly value?: string;\n\t/** Cookie domain for `set-cookie` (Playwright requires domain or url). */\n\treadonly domain?: string;\n\treadonly path?: string;\n\t/** Cookie expiry as Unix seconds; omit for a session cookie. */\n\treadonly expires?: number;\n\t/** localStorage key for `get-local` and `set-local`. */\n\treadonly key?: string;\n}\n\nexport type BrowserViewportActionKindV1 = \"set\" | \"get\";\n\nexport interface BrowserViewportInputV1 {\n\treadonly action: BrowserViewportActionKindV1;\n\t/** Requested width; clamped into 320..7680. */\n\treadonly width?: number;\n\t/** Requested height; clamped into 320..7680. */\n\treadonly height?: number;\n}\n\nexport type BrowserElementStateV1 = \"visible\" | \"hidden\" | \"value\";\n\nexport type BrowserPostconditionV1 =\n\t| { readonly kind: \"url\"; readonly equals?: string; readonly contains?: string }\n\t| {\n\t\t\treadonly kind: \"element\";\n\t\t\treadonly locator: BrowserLocatorV1;\n\t\t\treadonly state: BrowserElementStateV1;\n\t\t\treadonly value?: string;\n\t  }\n\t| { readonly kind: \"text\"; readonly locator?: BrowserLocatorV1; readonly contains: string }\n\t| { readonly kind: \"console\"; readonly contains: string; readonly level?: string }\n\t| { readonly kind: \"network\"; readonly containsUrl: string; readonly status?: number };\n\n/** `browser_collect_evidence` kinds; console/network come from bounded page ring buffers. */\nexport type BrowserEvidenceKindV1 = \"console\" | \"network\" | \"snapshot\";\n\nexport interface BrowserOperationOptionsV1 {\n\treadonly operationId?: string;\n\treadonly signal?: AbortSignal;\n}\n\n/**\n * Driver contract behind `BrowserRuntimeV1`. Every operation returns a\n * validated `PluginResultV1`; failures are structured results, not throws\n * (module/install problems surface as thrown errors at `connect` time and are\n * sanitized by the capability layer). Structured payloads (console/network\n * entries, performance metrics, evaluate results, storage and tab state) are\n * carried as bounded JSON text in evidence summaries.\n */\nexport interface BrowserDriverV1 {\n\tnavigate(input: BrowserNavigateInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\tsnapshot(input?: BrowserSnapshotInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\tlocatorAction(input: BrowserLocatorActionInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\tassertPostcondition(\n\t\tinput: BrowserPostconditionV1 | readonly BrowserPostconditionV1[],\n\t\toptions?: BrowserOperationOptionsV1,\n\t): Promise<PluginResultV1>;\n\tcollectEvidence(kind: BrowserEvidenceKindV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\t/** Escape hatch: runs a JS expression in the page context; use only when no built-in tool covers the operation. */\n\tevaluate(input: BrowserEvaluateInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\tconsoleEntries(input: BrowserConsoleReadInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\tnetworkEntries(input: BrowserNetworkReadInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\t/** Navigation Timing, paint, resource summary, and DOM node count; read-only. */\n\tperformance(options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\twait(input: BrowserWaitInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\tdrag(input: BrowserDragInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\tmouse(input: BrowserMouseInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\tpressKey(input: BrowserPressKeyInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\ttabs(input: BrowserTabsInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\tstorage(input: BrowserStorageInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\tviewport(input: BrowserViewportInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\t/** Idempotent, best-effort teardown; never throws. */\n\tclose(): void;\n}\n\nexport type BrowserSetupOutcomeV1 =\n\t| { readonly ok: true; readonly alreadyInstalled: boolean; readonly log: string }\n\t| { readonly ok: false; readonly message: string };\n\n/**\n * Injection face for the capability factory. Tests bind a fake runtime over a\n * mock driver; the production entry binds `PlaywrightBrowserRuntimeV1`, whose\n * optional `setup()` self-installs Playwright into `<agentDir>/browser-deps`.\n */\nexport interface BrowserRuntimeV1 {\n\tconnect(): Promise<BrowserDriverV1>;\n\tsetup?(): Promise<BrowserSetupOutcomeV1>;\n}\n"]}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Browser capability contracts for the built-in Playwright plugin.\n *\n * The plugin is the product's single browser channel. Playwright itself is\n * never bundled: the driver resolves it from `<agentDir>/browser-deps` at\n * connect time and `browser_setup` installs it on first use. Everything here\n * is host-independent; hosts and tests inject a `BrowserRuntimeV1` whose\n * `connect()` yields a driver, so the capability layer never imports\n * Playwright types.\n */\nimport type { PluginResultV1 } from \"@agent-forge/plugin-sdk\";\n\nexport type BrowserLocatorKindV1 = \"css\" | \"id\" | \"role\" | \"text\" | \"test-id\";\n\nexport interface BrowserLocatorV1 {\n\treadonly kind: BrowserLocatorKindV1;\n\treadonly value: string;\n\t/** Accessible name refinement for `kind: \"role\"`. */\n\treadonly name?: string;\n}\n\nexport type BrowserWaitUntilV1 = \"commit\" | \"domcontentloaded\" | \"load\" | \"networkidle\";\n\nexport interface BrowserNavigateInputV1 {\n\treadonly url: string;\n\treadonly waitUntil?: BrowserWaitUntilV1;\n}\n\nexport interface BrowserSnapshotInputV1 {\n\treadonly includeDom?: boolean;\n\treadonly includeA11y?: boolean;\n\treadonly includeStyles?: boolean;\n\treadonly includeScreenshot?: boolean;\n}\n\nexport type BrowserLocatorActionKindV1 =\n\t| \"click\"\n\t| \"dblclick\"\n\t| \"rightclick\"\n\t| \"fill\"\n\t| \"type\"\n\t| \"press\"\n\t| \"hover\"\n\t| \"select\"\n\t| \"check\"\n\t| \"uncheck\"\n\t| \"clear\"\n\t| \"upload\"\n\t| \"scroll\";\n\nexport interface BrowserLocatorActionInputV1 {\n\treadonly locator: BrowserLocatorV1;\n\treadonly action: BrowserLocatorActionKindV1;\n\t/**\n\t * Value for `fill`, `type`, and `select`; for `upload` a single absolute\n\t * file path or a JSON array of paths; for `scroll` a `<direction>:<pixels>`\n\t * directive (`down:500`, `up:200`, `left:100`, `right:100`).\n\t */\n\treadonly value?: string;\n\t/** Key sequence for `press`. */\n\treadonly key?: string;\n\t/** Inter-key delay in milliseconds for `type`. */\n\treadonly delay?: number;\n}\n\nexport interface BrowserEvaluateInputV1 {\n\t/**\n\t * JavaScript expression evaluated via `page.evaluate`. Keep it a plain\n\t * expression (`document.title`, `1 + 1`); for multi-statement logic use an\n\t * IIFE string (`(() => { ... return x; })()`) — a bare `() => ...` string is\n\t * not invoked by Playwright and serializes to `undefined`.\n\t */\n\treadonly expression: string;\n\t/** JSON-serializable argument passed through to the page context. */\n\treadonly arg?: unknown;\n}\n\nexport interface BrowserConsoleReadInputV1 {\n\t/** Comma-combined level filter: error/warning/info/debug (`info` also matches `log`). */\n\treadonly level?: string;\n\t/** Substring filter on the message text. */\n\treadonly contains?: string;\n\t/** Most-recent count to return; defaults to 50. */\n\treadonly limit?: number;\n}\n\nexport interface BrowserConsoleEntryV1 {\n\treadonly type: string;\n\treadonly text: string;\n\treadonly location?: { readonly url: string; readonly lineNumber: number; readonly columnNumber: number };\n\treadonly timestamp: number;\n}\n\nexport interface BrowserNetworkReadInputV1 {\n\treadonly containsUrl?: string;\n\treadonly status?: number;\n\treadonly method?: string;\n\t/** Most-recent count to return; defaults to 50. */\n\treadonly limit?: number;\n}\n\nexport interface BrowserNetworkEntryV1 {\n\treadonly method: string;\n\treadonly url: string;\n\treadonly status: number;\n\treadonly timestamp: number;\n\t/** Wall-clock duration in milliseconds when the request timing is available. */\n\treadonly durationMs?: number;\n\t/** Response `content-length` in bytes when the header is present. */\n\treadonly sizeBytes?: number;\n}\n\n/** Raw in-page performance collection; the driver shapes it into {@link BrowserPerformancePayloadV1}. */\nexport interface BrowserPerformanceRawV1 {\n\treadonly navigation: {\n\t\treadonly ttfbMs: number;\n\t\treadonly domContentLoadedMs: number;\n\t\treadonly loadMs: number;\n\t} | null;\n\treadonly paints: readonly { readonly name: string; readonly startTimeMs: number }[];\n\treadonly resources: readonly { readonly url: string; readonly durationMs: number; readonly transferBytes: number }[];\n\treadonly domNodes: number;\n}\n\nexport interface BrowserPerformancePayloadV1 {\n\treadonly navigation?: { readonly ttfbMs: number; readonly domContentLoadedMs: number; readonly loadMs: number };\n\treadonly paint: { readonly firstPaintMs?: number; readonly firstContentfulPaintMs?: number };\n\treadonly resources: {\n\t\treadonly count: number;\n\t\treadonly totalTransferBytes: number;\n\t\treadonly slowest: readonly { readonly url: string; readonly durationMs: number }[];\n\t};\n\treadonly domNodes: number;\n}\n\nexport type BrowserWaitUntilKindV1 = \"selector\" | \"navigation\" | \"networkidle\" | \"time\";\n\nexport interface BrowserWaitInputV1 {\n\treadonly until: BrowserWaitUntilKindV1;\n\t/** Locator for `until: \"selector\"` (waits for the element to be visible). */\n\treadonly locator?: BrowserLocatorV1;\n\t/** Milliseconds; required for `until: \"time\"`, optional timeout for the others. Clamped to 30000. */\n\treadonly ms?: number;\n}\n\nexport interface BrowserDragInputV1 {\n\treadonly from: BrowserLocatorV1;\n\treadonly to: BrowserLocatorV1;\n\t/** Number of intermediate mouse moves over the target; defaults to 8. */\n\treadonly steps?: number;\n}\n\nexport type BrowserMouseActionKindV1 = \"move\" | \"click\" | \"dblclick\" | \"rightclick\" | \"wheel\";\nexport type BrowserMouseButtonV1 = \"left\" | \"right\" | \"middle\";\n\nexport interface BrowserMouseInputV1 {\n\treadonly action: BrowserMouseActionKindV1;\n\t/** Non-negative integer viewport x coordinate. */\n\treadonly x: number;\n\t/** Non-negative integer viewport y coordinate. */\n\treadonly y: number;\n\t/** Horizontal wheel delta in pixels (`wheel`). */\n\treadonly deltaX?: number;\n\t/** Vertical wheel delta in pixels (`wheel`). */\n\treadonly deltaY?: number;\n\treadonly button?: BrowserMouseButtonV1;\n}\n\nexport interface BrowserPressKeyInputV1 {\n\t/** Playwright key name, e.g. `Control+a`, `Enter`, `Meta+c`. */\n\treadonly key: string;\n\t/** Delay between keydown and keyup in milliseconds. */\n\treadonly delay?: number;\n}\n\nexport type BrowserTabsActionKindV1 = \"list\" | \"new\" | \"switch\" | \"close\";\n\nexport interface BrowserTabsInputV1 {\n\treadonly action: BrowserTabsActionKindV1;\n\t/** Tab index for `switch` and `close`. */\n\treadonly index?: number;\n\t/** URL for `new`; defaults to `about:blank`. */\n\treadonly url?: string;\n}\n\nexport type BrowserStorageActionKindV1 =\n\t| \"get-cookies\"\n\t| \"set-cookie\"\n\t| \"clear-cookies\"\n\t| \"get-local\"\n\t| \"set-local\"\n\t| \"clear-local\";\n\nexport interface BrowserStorageInputV1 {\n\treadonly action: BrowserStorageActionKindV1;\n\t/** Cookie name for `set-cookie`. */\n\treadonly name?: string;\n\t/** Cookie value for `set-cookie`; localStorage value for `set-local`. */\n\treadonly value?: string;\n\t/** Cookie domain for `set-cookie` (Playwright requires domain or url). */\n\treadonly domain?: string;\n\treadonly path?: string;\n\t/** Cookie expiry as Unix seconds; omit for a session cookie. */\n\treadonly expires?: number;\n\t/** localStorage key for `get-local` and `set-local`. */\n\treadonly key?: string;\n}\n\nexport type BrowserViewportActionKindV1 = \"set\" | \"get\";\n\nexport interface BrowserViewportInputV1 {\n\treadonly action: BrowserViewportActionKindV1;\n\t/** Requested width; clamped into 320..7680. */\n\treadonly width?: number;\n\t/** Requested height; clamped into 320..7680. */\n\treadonly height?: number;\n}\n\nexport type BrowserElementStateV1 = \"visible\" | \"hidden\" | \"value\";\n\nexport type BrowserPostconditionV1 =\n\t| { readonly kind: \"url\"; readonly equals?: string; readonly contains?: string }\n\t| {\n\t\t\treadonly kind: \"element\";\n\t\t\treadonly locator: BrowserLocatorV1;\n\t\t\treadonly state: BrowserElementStateV1;\n\t\t\treadonly value?: string;\n\t  }\n\t| { readonly kind: \"text\"; readonly locator?: BrowserLocatorV1; readonly contains: string }\n\t| { readonly kind: \"console\"; readonly contains: string; readonly level?: string }\n\t| { readonly kind: \"network\"; readonly containsUrl: string; readonly status?: number };\n\n/** `browser_collect_evidence` kinds; console/network come from bounded page ring buffers. */\nexport type BrowserEvidenceKindV1 = \"console\" | \"network\" | \"snapshot\";\n\nexport interface BrowserOperationOptionsV1 {\n\treadonly operationId?: string;\n\treadonly signal?: AbortSignal;\n}\n\n/**\n * Driver contract behind `BrowserRuntimeV1`. Every operation returns a\n * validated `PluginResultV1`; failures are structured results, not throws\n * (module/install problems surface as thrown errors at `connect` time and are\n * sanitized by the capability layer). Structured payloads (console/network\n * entries, performance metrics, evaluate results, storage and tab state) are\n * carried as bounded JSON text in evidence summaries.\n */\nexport interface BrowserDriverV1 {\n\tnavigate(input: BrowserNavigateInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\tsnapshot(input?: BrowserSnapshotInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\tlocatorAction(input: BrowserLocatorActionInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\tassertPostcondition(\n\t\tinput: BrowserPostconditionV1 | readonly BrowserPostconditionV1[],\n\t\toptions?: BrowserOperationOptionsV1,\n\t): Promise<PluginResultV1>;\n\tcollectEvidence(kind: BrowserEvidenceKindV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\t/** Escape hatch: runs a JS expression in the page context; use only when no built-in tool covers the operation. */\n\tevaluate(input: BrowserEvaluateInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\tconsoleEntries(input: BrowserConsoleReadInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\tnetworkEntries(input: BrowserNetworkReadInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\t/** Navigation Timing, paint, resource summary, and DOM node count; read-only. */\n\tperformance(options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\twait(input: BrowserWaitInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\tdrag(input: BrowserDragInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\tmouse(input: BrowserMouseInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\tpressKey(input: BrowserPressKeyInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\ttabs(input: BrowserTabsInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\tstorage(input: BrowserStorageInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\tviewport(input: BrowserViewportInputV1, options?: BrowserOperationOptionsV1): Promise<PluginResultV1>;\n\t/** Idempotent, best-effort teardown; never throws. */\n\tclose(): void;\n}\n\nexport type BrowserSetupOutcomeV1 =\n\t| { readonly ok: true; readonly alreadyInstalled: boolean; readonly log: string }\n\t| { readonly ok: false; readonly message: string };\n\n/**\n * Injection face for the capability factory. Tests bind a fake runtime over a\n * mock driver; the production entry binds `PlaywrightBrowserRuntimeV1`, whose\n * optional `setup()` self-installs Playwright into `<agentDir>/browser-deps`.\n */\nexport interface BrowserRuntimeV1 {\n\tconnect(): Promise<BrowserDriverV1>;\n\tsetup?(): Promise<BrowserSetupOutcomeV1>;\n}\n"]}

package/package.json

@@ -0,0 +1,57 @@
+{
+	"name": "@ai-agent-forge/plugin-browser-playwright",
+	"version": "0.88.3",
+	"description": "Built-in Playwright browser capability plugin for Agent Forge (seventeen prewritten browser tools: navigate/snapshot/locator_action with 13 actions/assert/collect/console/network/performance/wait/drag/mouse/press_key/tabs/storage/viewport, evaluate as the escape hatch, self-installing browser_setup; Playwright is never bundled)",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"MANUAL.md",
+		"agent-forge.json",
+		"plugin.json",
+		"README.md"
+	],
+	"scripts": {
+		"clean": "shx rm -rf dist",
+		"build": "tsgo -p tsconfig.build.json",
+		"test": "vitest --run",
+		"prepublishOnly": "npm run clean && npm run build"
+	},
+	"keywords": [
+		"agent-forge",
+		"plugin",
+		"browser",
+		"playwright",
+		"automation",
+		"evidence"
+	],
+	"author": "Agent Forge contributors",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/agent-forge/agent-forge.git",
+		"directory": "plugins/browser-playwright"
+	},
+	"bugs": {
+		"url": "https://github.com/agent-forge/agent-forge/issues"
+	},
+	"homepage": "https://github.com/agent-forge/agent-forge#readme",
+	"engines": {
+		"node": ">=22.19.0"
+	},
+	"dependencies": {
+		"typebox": "1.3.27",
+		"@ai-agent-forge/plugin-sdk": "^0.88.3"
+	},
+	"devDependencies": {
+		"shx": "0.4.0",
+		"vitest": "4.1.11"
+	}
+}

package/plugin.json

@@ -0,0 +1,20 @@
+{
+	"id": "agent-forge.plugin.browser-playwright",
+	"version": "0.88.3",
+	"apiVersion": "1-draft",
+	"entry": "./dist/entry.js",
+	"hostVersion": ">=0.84.4",
+	"description": "浏览器调试/测试/抓取:Playwright 17 工具(导航/DOM 与 a11y 快照/点击填写/拖拽/滚动/截图/console/网络/性能/存储/多标签),首次使用先 browser_setup 自装 Playwright",
+	"activation": "on-demand",
+	"manual": "./MANUAL.md",
+	"requiredCapabilities": [
+		"tools"
+	],
+	"provides": [
+		{
+			"id": "browser",
+			"version": 1,
+			"kind": "contribution"
+		}
+	]
+}