@onkernel/sdk 0.118.0 → 0.120.0

package/resources/browsers/playwright/executors.d.ts

@@ -0,0 +1,95 @@
+import { APIResource } from "../../../core/resource.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+/**
+ * Execute Playwright code against the browser instance and manage the executors it runs in.
+ */
+export declare class Executors extends APIResource {
+    /**
+     * Lists the default executor first, then the named executors created by POST
+     * /browsers/{id_or_name}/playwright/execute. Each entry reports whether a call is
+     * running on it and, for named executors, the target ID and URL of the tab it
+     * owns. Returns 404 for a browser whose image predates executors.
+     *
+     * @example
+     * ```ts
+     * const executorList =
+     *   await client.browsers.playwright.executors.list(
+     *     'htzv5orfit78e1m2biiifpbv',
+     *   );
+     * ```
+     */
+    list(idOrName: string, options?: RequestOptions): APIPromise<ExecutorList>;
+    /**
+     * Stops the executor's process. A call running on it fails with an error saying
+     * the executor was deleted. By default the executor's tab is closed too. The name
+     * can be reused; the next call with it creates a new executor and tab.
+     *
+     * The default executor is restarted instead of removed: its process is stopped, a
+     * call running on it fails with an error saying the executor was restarted, and
+     * queued and later calls run on a new process. It owns no tab, so 'close_tab' has
+     * no effect on it.
+     *
+     * @example
+     * ```ts
+     * await client.browsers.playwright.executors.delete(
+     *   'checkout',
+     *   { id_or_name: 'htzv5orfit78e1m2biiifpbv' },
+     * );
+     * ```
+     */
+    delete(name: string, params: ExecutorDeleteParams, options?: RequestOptions): APIPromise<void>;
+}
+/**
+ * A Playwright executor on the browser
+ */
+export interface Executor {
+    /**
+     * Whether a call is running on the executor
+     */
+    busy: boolean;
+    /**
+     * When the executor was created
+     */
+    created_at: string;
+    /**
+     * When the most recent call on the executor started
+     */
+    last_used_at: string;
+    /**
+     * Name of a Playwright executor. Calls with the same name run in the same
+     * executor, one at a time; the first call with a new name creates it. Calls on
+     * different executors run concurrently. 'default' names the executor that runs
+     * calls without a name.
+     */
+    name: string;
+    /**
+     * CDP page target ID of the executor's tab, once it has one. The default executor
+     * owns no tab.
+     */
+    target_id?: string;
+    /**
+     * Current URL of the executor's tab, when it is open
+     */
+    url?: string;
+}
+/**
+ * The default executor followed by the named executors
+ */
+export interface ExecutorList {
+    executors: Array<Executor>;
+}
+export interface ExecutorDeleteParams {
+    /**
+     * Path param: Browser session ID or name
+     */
+    id_or_name: string;
+    /**
+     * Query param: Close the executor's tab. Defaults to true.
+     */
+    close_tab?: boolean;
+}
+export declare namespace Executors {
+    export { type Executor as Executor, type ExecutorList as ExecutorList, type ExecutorDeleteParams as ExecutorDeleteParams, };
+}
+//# sourceMappingURL=executors.d.ts.map

package/resources/browsers/playwright/executors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executors.d.ts","sourceRoot":"","sources":["../../../src/resources/browsers/playwright/executors.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,kCAA+B;AACrD,OAAO,EAAE,UAAU,EAAE,qCAAkC;AAEvD,OAAO,EAAE,cAAc,EAAE,6CAA0C;AAGnE;;GAEG;AACH,qBAAa,SAAU,SAAQ,WAAW;IACxC;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,YAAY,CAAC;IAI1E;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAQ/F;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,CAAC,OAAO,WAAW,SAAS,CAAC;IACjC,OAAO,EACL,KAAK,QAAQ,IAAI,QAAQ,EACzB,KAAK,YAAY,IAAI,YAAY,EACjC,KAAK,oBAAoB,IAAI,oBAAoB,GAClD,CAAC;CACH"}

package/resources/browsers/playwright/executors.js

@@ -0,0 +1,57 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Executors = void 0;
+const resource_1 = require("../../../core/resource.js");
+const headers_1 = require("../../../internal/headers.js");
+const path_1 = require("../../../internal/utils/path.js");
+/**
+ * Execute Playwright code against the browser instance and manage the executors it runs in.
+ */
+class Executors extends resource_1.APIResource {
+    /**
+     * Lists the default executor first, then the named executors created by POST
+     * /browsers/{id_or_name}/playwright/execute. Each entry reports whether a call is
+     * running on it and, for named executors, the target ID and URL of the tab it
+     * owns. Returns 404 for a browser whose image predates executors.
+     *
+     * @example
+     * ```ts
+     * const executorList =
+     *   await client.browsers.playwright.executors.list(
+     *     'htzv5orfit78e1m2biiifpbv',
+     *   );
+     * ```
+     */
+    list(idOrName, options) {
+        return this._client.get((0, path_1.path) `/browsers/${idOrName}/playwright/executors`, options);
+    }
+    /**
+     * Stops the executor's process. A call running on it fails with an error saying
+     * the executor was deleted. By default the executor's tab is closed too. The name
+     * can be reused; the next call with it creates a new executor and tab.
+     *
+     * The default executor is restarted instead of removed: its process is stopped, a
+     * call running on it fails with an error saying the executor was restarted, and
+     * queued and later calls run on a new process. It owns no tab, so 'close_tab' has
+     * no effect on it.
+     *
+     * @example
+     * ```ts
+     * await client.browsers.playwright.executors.delete(
+     *   'checkout',
+     *   { id_or_name: 'htzv5orfit78e1m2biiifpbv' },
+     * );
+     * ```
+     */
+    delete(name, params, options) {
+        const { id_or_name, close_tab } = params;
+        return this._client.delete((0, path_1.path) `/browsers/${id_or_name}/playwright/executors/${name}`, {
+            query: { close_tab },
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.Executors = Executors;
+//# sourceMappingURL=executors.js.map

package/resources/browsers/playwright/executors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executors.js","sourceRoot":"","sources":["../../../src/resources/browsers/playwright/executors.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAErD,0DAAyD;AAEzD,0DAAoD;AAEpD;;GAEG;AACH,MAAa,SAAU,SAAQ,sBAAW;IACxC;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,QAAgB,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,QAAQ,uBAAuB,EAAE,OAAO,CAAC,CAAC;IACrF,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,IAAY,EAAE,MAA4B,EAAE,OAAwB;QACzE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,aAAa,UAAU,yBAAyB,IAAI,EAAE,EAAE;YACrF,KAAK,EAAE,EAAE,SAAS,EAAE;YACpB,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AA7CD,8BA6CC"}

package/resources/browsers/playwright/executors.mjs

@@ -0,0 +1,53 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../core/resource.mjs";
+import { buildHeaders } from "../../../internal/headers.mjs";
+import { path } from "../../../internal/utils/path.mjs";
+/**
+ * Execute Playwright code against the browser instance and manage the executors it runs in.
+ */
+export class Executors extends APIResource {
+    /**
+     * Lists the default executor first, then the named executors created by POST
+     * /browsers/{id_or_name}/playwright/execute. Each entry reports whether a call is
+     * running on it and, for named executors, the target ID and URL of the tab it
+     * owns. Returns 404 for a browser whose image predates executors.
+     *
+     * @example
+     * ```ts
+     * const executorList =
+     *   await client.browsers.playwright.executors.list(
+     *     'htzv5orfit78e1m2biiifpbv',
+     *   );
+     * ```
+     */
+    list(idOrName, options) {
+        return this._client.get(path `/browsers/${idOrName}/playwright/executors`, options);
+    }
+    /**
+     * Stops the executor's process. A call running on it fails with an error saying
+     * the executor was deleted. By default the executor's tab is closed too. The name
+     * can be reused; the next call with it creates a new executor and tab.
+     *
+     * The default executor is restarted instead of removed: its process is stopped, a
+     * call running on it fails with an error saying the executor was restarted, and
+     * queued and later calls run on a new process. It owns no tab, so 'close_tab' has
+     * no effect on it.
+     *
+     * @example
+     * ```ts
+     * await client.browsers.playwright.executors.delete(
+     *   'checkout',
+     *   { id_or_name: 'htzv5orfit78e1m2biiifpbv' },
+     * );
+     * ```
+     */
+    delete(name, params, options) {
+        const { id_or_name, close_tab } = params;
+        return this._client.delete(path `/browsers/${id_or_name}/playwright/executors/${name}`, {
+            query: { close_tab },
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+//# sourceMappingURL=executors.mjs.map

package/resources/browsers/playwright/executors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"executors.mjs","sourceRoot":"","sources":["../../../src/resources/browsers/playwright/executors.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,mCAA+B;AAErD,OAAO,EAAE,YAAY,EAAE,sCAAkC;AAEzD,OAAO,EAAE,IAAI,EAAE,yCAAqC;AAEpD;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,WAAW;IACxC;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,QAAgB,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,QAAQ,uBAAuB,EAAE,OAAO,CAAC,CAAC;IACrF,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,IAAY,EAAE,MAA4B,EAAE,OAAwB;QACzE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,aAAa,UAAU,yBAAyB,IAAI,EAAE,EAAE;YACrF,KAAK,EAAE,EAAE,SAAS,EAAE;YACpB,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF"}

package/resources/browsers/playwright/index.d.mts

@@ -0,0 +1,3 @@
+export { Executors, type Executor, type ExecutorList, type ExecutorDeleteParams } from "./executors.mjs";
+export { Playwright, type ExecutorLimitError, type Tab, type PlaywrightExecuteResponse, type PlaywrightExecuteParams, } from "./playwright.mjs";
+//# sourceMappingURL=index.d.mts.map

package/resources/browsers/playwright/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/resources/browsers/playwright/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,KAAK,oBAAoB,EAAE,wBAAoB;AACrG,OAAO,EACL,UAAU,EACV,KAAK,kBAAkB,EACvB,KAAK,GAAG,EACR,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,GAC7B,yBAAqB"}

package/resources/browsers/playwright/index.d.ts

@@ -0,0 +1,3 @@
+export { Executors, type Executor, type ExecutorList, type ExecutorDeleteParams } from "./executors.js";
+export { Playwright, type ExecutorLimitError, type Tab, type PlaywrightExecuteResponse, type PlaywrightExecuteParams, } from "./playwright.js";
+//# sourceMappingURL=index.d.ts.map

package/resources/browsers/playwright/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resources/browsers/playwright/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,KAAK,oBAAoB,EAAE,uBAAoB;AACrG,OAAO,EACL,UAAU,EACV,KAAK,kBAAkB,EACvB,KAAK,GAAG,EACR,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,GAC7B,wBAAqB"}

package/resources/browsers/playwright/index.js

@@ -0,0 +1,9 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Playwright = exports.Executors = void 0;
+var executors_1 = require("./executors.js");
+Object.defineProperty(exports, "Executors", { enumerable: true, get: function () { return executors_1.Executors; } });
+var playwright_1 = require("./playwright.js");
+Object.defineProperty(exports, "Playwright", { enumerable: true, get: function () { return playwright_1.Playwright; } });
+//# sourceMappingURL=index.js.map

package/resources/browsers/playwright/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/browsers/playwright/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,4CAAqG;AAA5F,sGAAA,SAAS,OAAA;AAClB,8CAMsB;AALpB,wGAAA,UAAU,OAAA"}

package/resources/browsers/playwright/index.mjs

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { Executors } from "./executors.mjs";
+export { Playwright, } from "./playwright.mjs";
+//# sourceMappingURL=index.mjs.map

package/resources/browsers/playwright/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/resources/browsers/playwright/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,SAAS,EAA+D,wBAAoB;AACrG,OAAO,EACL,UAAU,GAKX,yBAAqB"}

package/resources/browsers/playwright/playwright.d.mts

@@ -0,0 +1,149 @@
+import { APIResource } from "../../../core/resource.mjs";
+import * as ExecutorsAPI from "./executors.mjs";
+import { Executor, ExecutorDeleteParams, ExecutorList, Executors } from "./executors.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+/**
+ * Execute Playwright code against the browser instance and manage the executors it runs in.
+ */
+export declare class Playwright extends APIResource {
+    executors: ExecutorsAPI.Executors;
+    /**
+     * Execute arbitrary Playwright code in a fresh execution context against the
+     * browser. The code runs in the same VM as the browser, minimizing latency and
+     * maximizing throughput. It has access to 'page', 'context', 'browser', and
+     * 'webmcp' variables. Use 'webmcp.listTools()' to discover browser-wide WebMCP
+     * tools and 'webmcp.invokeTool(toolRef, input?, { timeoutSec? })' to invoke an
+     * exact registration. It can `return` a value, and this value is returned in the
+     * response.
+     *
+     * Every call runs in an executor: a dedicated Node.js process with its own browser
+     * connection. Calls on different executors run concurrently; calls on the same
+     * executor run one at a time. A timeout, crash, or blocked event loop in one
+     * executor does not affect other executors. After a timeout the executor keeps its
+     * process and drops its browser connection, so code abandoned by the timeout
+     * cannot keep driving the browser. After a crash or a blocked event loop, the next
+     * call on that executor starts a fresh process.
+     *
+     * Calls without 'executor' run in the executor named 'default', which always
+     * exists and is the same as passing 'executor: "default"'. In the default
+     * executor, 'page' is bound to an active tab reported by Chrome. In single-window
+     * sessions, this is the foreground tab. When multiple browser windows are open,
+     * Chrome reports one active tab per window and the selected window is unspecified.
+     * 'context' is the BrowserContext that owns the selected page. Use
+     * 'browser.contexts()' to select a context or page explicitly.
+     *
+     * Pass any other name to run the call in a named executor. The first call with a
+     * new name creates it. Each named executor owns a tab: its first call opens a new
+     * background tab in the default browser context, and 'page' is bound to that tab
+     * on every later call while it stays open. Opening it does not change the active
+     * tab of an existing window. If the tab is closed, the next call opens a new one
+     * and reports 'tab.created: true'. Executor code can still reach other tabs
+     * through 'context' and 'browser'; ownership only decides what 'page' is bound to.
+     * Use named executors to drive several tabs of one browser in parallel.
+     *
+     * A browser can have at most 8 named executors; the default executor does not
+     * count. A call that would create another returns 409 with the current executors;
+     * delete one with DELETE /browsers/{id_or_name}/playwright/executors/{name}. Named
+     * executors are not removed automatically while the browser runs; when it shuts
+     * down, they are removed and their tabs closed.
+     *
+     * A named call to a browser whose image predates executors fails with 400 instead
+     * of running on the active tab; calls without 'executor' keep working on every
+     * image.
+     *
+     * @example
+     * ```ts
+     * const response = await client.browsers.playwright.execute(
+     *   'htzv5orfit78e1m2biiifpbv',
+     *   { code: 'code' },
+     * );
+     * ```
+     */
+    execute(idOrName: string, body: PlaywrightExecuteParams, options?: RequestOptions): APIPromise<PlaywrightExecuteResponse>;
+}
+/**
+ * Returned when a call would create a named executor beyond the per-browser limit
+ */
+export interface ExecutorLimitError {
+    /**
+     * The default executor and the named executors that already exist
+     */
+    executors: Array<ExecutorsAPI.Executor>;
+    /**
+     * Human-readable error description
+     */
+    message: string;
+}
+/**
+ * The tab 'page' was bound to for this call. Absent if the call failed before
+ * binding a tab.
+ */
+export interface Tab {
+    /**
+     * Whether this call opened the tab. For a named executor this happens on its first
+     * call and after its previous tab was closed. For the default executor it happens
+     * only when the browser had no open page.
+     */
+    created: boolean;
+    /**
+     * CDP page target ID of the tab
+     */
+    target_id: string;
+}
+/**
+ * Result of Playwright code execution
+ */
+export interface PlaywrightExecuteResponse {
+    /**
+     * Whether the code executed successfully
+     */
+    success: boolean;
+    /**
+     * Error message if execution failed
+     */
+    error?: string;
+    /**
+     * The value returned by the code (if any)
+     */
+    result?: unknown;
+    /**
+     * Standard error from the execution
+     */
+    stderr?: string;
+    /**
+     * Standard output from the execution
+     */
+    stdout?: string;
+    /**
+     * The tab 'page' was bound to for this call. Absent if the call failed before
+     * binding a tab.
+     */
+    tab?: Tab;
+}
+export interface PlaywrightExecuteParams {
+    /**
+     * TypeScript/JavaScript code to execute. The code has access to 'page', 'context',
+     * and 'browser' variables. It runs within a function, so you can use a return
+     * statement at the end to return a value. This value is returned as the `result`
+     * property in the response. Example: "await page.goto('https://example.com');
+     * return await page.title();"
+     */
+    code: string;
+    /**
+     * Name of a Playwright executor. Calls with the same name run in the same
+     * executor, one at a time; the first call with a new name creates it. Calls on
+     * different executors run concurrently. 'default' names the executor that runs
+     * calls without a name.
+     */
+    executor?: string;
+    /**
+     * Maximum execution time in seconds. Default is 60.
+     */
+    timeout_sec?: number;
+}
+export declare namespace Playwright {
+    export { type ExecutorLimitError as ExecutorLimitError, type Tab as Tab, type PlaywrightExecuteResponse as PlaywrightExecuteResponse, type PlaywrightExecuteParams as PlaywrightExecuteParams, };
+    export { Executors as Executors, type Executor as Executor, type ExecutorList as ExecutorList, type ExecutorDeleteParams as ExecutorDeleteParams, };
+}
+//# sourceMappingURL=playwright.d.mts.map

package/resources/browsers/playwright/playwright.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright.d.mts","sourceRoot":"","sources":["../../../src/resources/browsers/playwright/playwright.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,mCAA+B;AACrD,OAAO,KAAK,YAAY,wBAAoB;AAC5C,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,YAAY,EAAE,SAAS,EAAE,wBAAoB;AACtF,OAAO,EAAE,UAAU,EAAE,sCAAkC;AACvD,OAAO,EAAE,cAAc,EAAE,8CAA0C;AAGnE;;GAEG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC,SAAS,EAAE,YAAY,CAAC,SAAS,CAA4C;IAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmDG;IACH,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,uBAAuB,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,yBAAyB,CAAC;CAGzC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAExC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,GAAG;IAClB;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,GAAG,CAAC,EAAE,GAAG,CAAC;CACX;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,OAAO,EACL,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,GAAG,IAAI,GAAG,EACf,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,uBAAuB,IAAI,uBAAuB,GACxD,CAAC;IAEF,OAAO,EACL,SAAS,IAAI,SAAS,EACtB,KAAK,QAAQ,IAAI,QAAQ,EACzB,KAAK,YAAY,IAAI,YAAY,EACjC,KAAK,oBAAoB,IAAI,oBAAoB,GAClD,CAAC;CACH"}

package/resources/browsers/playwright/playwright.d.ts

@@ -0,0 +1,149 @@
+import { APIResource } from "../../../core/resource.js";
+import * as ExecutorsAPI from "./executors.js";
+import { Executor, ExecutorDeleteParams, ExecutorList, Executors } from "./executors.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+/**
+ * Execute Playwright code against the browser instance and manage the executors it runs in.
+ */
+export declare class Playwright extends APIResource {
+    executors: ExecutorsAPI.Executors;
+    /**
+     * Execute arbitrary Playwright code in a fresh execution context against the
+     * browser. The code runs in the same VM as the browser, minimizing latency and
+     * maximizing throughput. It has access to 'page', 'context', 'browser', and
+     * 'webmcp' variables. Use 'webmcp.listTools()' to discover browser-wide WebMCP
+     * tools and 'webmcp.invokeTool(toolRef, input?, { timeoutSec? })' to invoke an
+     * exact registration. It can `return` a value, and this value is returned in the
+     * response.
+     *
+     * Every call runs in an executor: a dedicated Node.js process with its own browser
+     * connection. Calls on different executors run concurrently; calls on the same
+     * executor run one at a time. A timeout, crash, or blocked event loop in one
+     * executor does not affect other executors. After a timeout the executor keeps its
+     * process and drops its browser connection, so code abandoned by the timeout
+     * cannot keep driving the browser. After a crash or a blocked event loop, the next
+     * call on that executor starts a fresh process.
+     *
+     * Calls without 'executor' run in the executor named 'default', which always
+     * exists and is the same as passing 'executor: "default"'. In the default
+     * executor, 'page' is bound to an active tab reported by Chrome. In single-window
+     * sessions, this is the foreground tab. When multiple browser windows are open,
+     * Chrome reports one active tab per window and the selected window is unspecified.
+     * 'context' is the BrowserContext that owns the selected page. Use
+     * 'browser.contexts()' to select a context or page explicitly.
+     *
+     * Pass any other name to run the call in a named executor. The first call with a
+     * new name creates it. Each named executor owns a tab: its first call opens a new
+     * background tab in the default browser context, and 'page' is bound to that tab
+     * on every later call while it stays open. Opening it does not change the active
+     * tab of an existing window. If the tab is closed, the next call opens a new one
+     * and reports 'tab.created: true'. Executor code can still reach other tabs
+     * through 'context' and 'browser'; ownership only decides what 'page' is bound to.
+     * Use named executors to drive several tabs of one browser in parallel.
+     *
+     * A browser can have at most 8 named executors; the default executor does not
+     * count. A call that would create another returns 409 with the current executors;
+     * delete one with DELETE /browsers/{id_or_name}/playwright/executors/{name}. Named
+     * executors are not removed automatically while the browser runs; when it shuts
+     * down, they are removed and their tabs closed.
+     *
+     * A named call to a browser whose image predates executors fails with 400 instead
+     * of running on the active tab; calls without 'executor' keep working on every
+     * image.
+     *
+     * @example
+     * ```ts
+     * const response = await client.browsers.playwright.execute(
+     *   'htzv5orfit78e1m2biiifpbv',
+     *   { code: 'code' },
+     * );
+     * ```
+     */
+    execute(idOrName: string, body: PlaywrightExecuteParams, options?: RequestOptions): APIPromise<PlaywrightExecuteResponse>;
+}
+/**
+ * Returned when a call would create a named executor beyond the per-browser limit
+ */
+export interface ExecutorLimitError {
+    /**
+     * The default executor and the named executors that already exist
+     */
+    executors: Array<ExecutorsAPI.Executor>;
+    /**
+     * Human-readable error description
+     */
+    message: string;
+}
+/**
+ * The tab 'page' was bound to for this call. Absent if the call failed before
+ * binding a tab.
+ */
+export interface Tab {
+    /**
+     * Whether this call opened the tab. For a named executor this happens on its first
+     * call and after its previous tab was closed. For the default executor it happens
+     * only when the browser had no open page.
+     */
+    created: boolean;
+    /**
+     * CDP page target ID of the tab
+     */
+    target_id: string;
+}
+/**
+ * Result of Playwright code execution
+ */
+export interface PlaywrightExecuteResponse {
+    /**
+     * Whether the code executed successfully
+     */
+    success: boolean;
+    /**
+     * Error message if execution failed
+     */
+    error?: string;
+    /**
+     * The value returned by the code (if any)
+     */
+    result?: unknown;
+    /**
+     * Standard error from the execution
+     */
+    stderr?: string;
+    /**
+     * Standard output from the execution
+     */
+    stdout?: string;
+    /**
+     * The tab 'page' was bound to for this call. Absent if the call failed before
+     * binding a tab.
+     */
+    tab?: Tab;
+}
+export interface PlaywrightExecuteParams {
+    /**
+     * TypeScript/JavaScript code to execute. The code has access to 'page', 'context',
+     * and 'browser' variables. It runs within a function, so you can use a return
+     * statement at the end to return a value. This value is returned as the `result`
+     * property in the response. Example: "await page.goto('https://example.com');
+     * return await page.title();"
+     */
+    code: string;
+    /**
+     * Name of a Playwright executor. Calls with the same name run in the same
+     * executor, one at a time; the first call with a new name creates it. Calls on
+     * different executors run concurrently. 'default' names the executor that runs
+     * calls without a name.
+     */
+    executor?: string;
+    /**
+     * Maximum execution time in seconds. Default is 60.
+     */
+    timeout_sec?: number;
+}
+export declare namespace Playwright {
+    export { type ExecutorLimitError as ExecutorLimitError, type Tab as Tab, type PlaywrightExecuteResponse as PlaywrightExecuteResponse, type PlaywrightExecuteParams as PlaywrightExecuteParams, };
+    export { Executors as Executors, type Executor as Executor, type ExecutorList as ExecutorList, type ExecutorDeleteParams as ExecutorDeleteParams, };
+}
+//# sourceMappingURL=playwright.d.ts.map

package/resources/browsers/playwright/playwright.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright.d.ts","sourceRoot":"","sources":["../../../src/resources/browsers/playwright/playwright.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,kCAA+B;AACrD,OAAO,KAAK,YAAY,uBAAoB;AAC5C,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,YAAY,EAAE,SAAS,EAAE,uBAAoB;AACtF,OAAO,EAAE,UAAU,EAAE,qCAAkC;AACvD,OAAO,EAAE,cAAc,EAAE,6CAA0C;AAGnE;;GAEG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC,SAAS,EAAE,YAAY,CAAC,SAAS,CAA4C;IAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmDG;IACH,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,uBAAuB,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,yBAAyB,CAAC;CAGzC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,SAAS,EAAE,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAExC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,GAAG;IAClB;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,GAAG,CAAC,EAAE,GAAG,CAAC;CACX;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,OAAO,EACL,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,GAAG,IAAI,GAAG,EACf,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,uBAAuB,IAAI,uBAAuB,GACxD,CAAC;IAEF,OAAO,EACL,SAAS,IAAI,SAAS,EACtB,KAAK,QAAQ,IAAI,QAAQ,EACzB,KAAK,YAAY,IAAI,YAAY,EACjC,KAAK,oBAAoB,IAAI,oBAAoB,GAClD,CAAC;CACH"}

package/resources/browsers/playwright/playwright.js

@@ -0,0 +1,76 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Playwright = void 0;
+const tslib_1 = require("../../../internal/tslib.js");
+const resource_1 = require("../../../core/resource.js");
+const ExecutorsAPI = tslib_1.__importStar(require("./executors.js"));
+const executors_1 = require("./executors.js");
+const path_1 = require("../../../internal/utils/path.js");
+/**
+ * Execute Playwright code against the browser instance and manage the executors it runs in.
+ */
+class Playwright extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.executors = new ExecutorsAPI.Executors(this._client);
+    }
+    /**
+     * Execute arbitrary Playwright code in a fresh execution context against the
+     * browser. The code runs in the same VM as the browser, minimizing latency and
+     * maximizing throughput. It has access to 'page', 'context', 'browser', and
+     * 'webmcp' variables. Use 'webmcp.listTools()' to discover browser-wide WebMCP
+     * tools and 'webmcp.invokeTool(toolRef, input?, { timeoutSec? })' to invoke an
+     * exact registration. It can `return` a value, and this value is returned in the
+     * response.
+     *
+     * Every call runs in an executor: a dedicated Node.js process with its own browser
+     * connection. Calls on different executors run concurrently; calls on the same
+     * executor run one at a time. A timeout, crash, or blocked event loop in one
+     * executor does not affect other executors. After a timeout the executor keeps its
+     * process and drops its browser connection, so code abandoned by the timeout
+     * cannot keep driving the browser. After a crash or a blocked event loop, the next
+     * call on that executor starts a fresh process.
+     *
+     * Calls without 'executor' run in the executor named 'default', which always
+     * exists and is the same as passing 'executor: "default"'. In the default
+     * executor, 'page' is bound to an active tab reported by Chrome. In single-window
+     * sessions, this is the foreground tab. When multiple browser windows are open,
+     * Chrome reports one active tab per window and the selected window is unspecified.
+     * 'context' is the BrowserContext that owns the selected page. Use
+     * 'browser.contexts()' to select a context or page explicitly.
+     *
+     * Pass any other name to run the call in a named executor. The first call with a
+     * new name creates it. Each named executor owns a tab: its first call opens a new
+     * background tab in the default browser context, and 'page' is bound to that tab
+     * on every later call while it stays open. Opening it does not change the active
+     * tab of an existing window. If the tab is closed, the next call opens a new one
+     * and reports 'tab.created: true'. Executor code can still reach other tabs
+     * through 'context' and 'browser'; ownership only decides what 'page' is bound to.
+     * Use named executors to drive several tabs of one browser in parallel.
+     *
+     * A browser can have at most 8 named executors; the default executor does not
+     * count. A call that would create another returns 409 with the current executors;
+     * delete one with DELETE /browsers/{id_or_name}/playwright/executors/{name}. Named
+     * executors are not removed automatically while the browser runs; when it shuts
+     * down, they are removed and their tabs closed.
+     *
+     * A named call to a browser whose image predates executors fails with 400 instead
+     * of running on the active tab; calls without 'executor' keep working on every
+     * image.
+     *
+     * @example
+     * ```ts
+     * const response = await client.browsers.playwright.execute(
+     *   'htzv5orfit78e1m2biiifpbv',
+     *   { code: 'code' },
+     * );
+     * ```
+     */
+    execute(idOrName, body, options) {
+        return this._client.post((0, path_1.path) `/browsers/${idOrName}/playwright/execute`, { body, ...options });
+    }
+}
+exports.Playwright = Playwright;
+Playwright.Executors = executors_1.Executors;
+//# sourceMappingURL=playwright.js.map

package/resources/browsers/playwright/playwright.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright.js","sourceRoot":"","sources":["../../../src/resources/browsers/playwright/playwright.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,wDAAqD;AACrD,qEAA4C;AAC5C,8CAAsF;AAGtF,0DAAoD;AAEpD;;GAEG;AACH,MAAa,UAAW,SAAQ,sBAAW;IAA3C;;QACE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA6D/E,CAAC;IA3DC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmDG;IACH,OAAO,CACL,QAAgB,EAChB,IAA6B,EAC7B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,aAAa,QAAQ,qBAAqB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjG,CAAC;CACF;AA9DD,gCA8DC;AA+FD,UAAU,CAAC,SAAS,GAAG,qBAAS,CAAC"}