@onkernel/sdk 0.110.0 → 0.112.0

package/resources/browsers/webmcp/custom-tools.d.mts

@@ -0,0 +1,118 @@
+import { APIResource } from "../../../core/resource.mjs";
+import * as WebmcpAPI from "./webmcp.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+/**
+ * Discover and invoke native page tools across the browser instance.
+ */
+export declare class CustomTools extends APIResource {
+    /**
+     * Returns every registered custom tool with its generated ID, namespace, matcher,
+     * and MCP tool metadata.
+     *
+     * @example
+     * ```ts
+     * const customToolsResponse =
+     *   await client.browsers.webmcp.customTools.list(
+     *     'id_or_name',
+     *   );
+     * ```
+     */
+    list(idOrName: string, options?: RequestOptions): APIPromise<CustomToolsResponse>;
+    /**
+     * Add a namespaced batch of custom tools. A custom tool can be page-backed or
+     * CDP-backed. Page-backed tools execute in the page via JavaScript. CDP-backed
+     * tools execute via CDP and can use all browser REPL tools (see `/repl`). The
+     * source must evaluate to a non-empty array of definitions with URL matchers, tool
+     * metadata (including an optional output schema), and execute functions. The batch
+     * is added atomically. Matchers apply to top-level documents and nested frames,
+     * including out-of-process iframes; each matching tool is exposed once on the
+     * tab's top-level document and appears in the WebMCP tool snapshot.
+     *
+     * To update one tool, list the tools, delete its ID, and add its replacement. Set
+     * force_overwrite_namespace to replace every existing tool in the namespace
+     * atomically; omitted or false adds tools without replacing existing ones.
+     * Existing invocations continue.
+     *
+     * @example
+     * ```ts
+     * const customToolsResponse =
+     *   await client.browsers.webmcp.customTools.add(
+     *     'id_or_name',
+     *     { namespace: 'namespace', source: 'source' },
+     *   );
+     * ```
+     */
+    add(idOrName: string, body: CustomToolAddParams, options?: RequestOptions): APIPromise<CustomToolsResponse>;
+    /**
+     * Removes one custom tool by generated ID. An invocation already in progress is
+     * not canceled.
+     *
+     * @example
+     * ```ts
+     * await client.browsers.webmcp.customTools.remove(
+     *   'ct_n10b9798ad53ecc4y69z31e1',
+     *   { id_or_name: 'id_or_name' },
+     * );
+     * ```
+     */
+    remove(id: string, params: CustomToolRemoveParams, options?: RequestOptions): APIPromise<void>;
+}
+export interface AddRequest {
+    namespace: string;
+    /**
+     * JavaScript expression that evaluates to a non-empty array of custom tool
+     * definitions. Limited to 8,000,000 bytes when UTF-8 encoded, so multi-byte
+     * characters reduce the allowed character count.
+     */
+    source: string;
+    /**
+     * Atomically replace all existing tools in this namespace with this batch when
+     * true.
+     */
+    force_overwrite_namespace?: boolean;
+}
+export interface CustomToolsResponse {
+    tools: Array<Definition>;
+}
+export interface Definition {
+    id: string;
+    kind: string;
+    match: Match;
+    namespace: string;
+    /**
+     * Tool metadata follows the
+     * [MCP Tool definition](https://modelcontextprotocol.io/specification/2025-11-25/server/tools#tool)
+     * and the
+     * [WebMCP RegisteredTool definition](https://webmachinelearning.github.io/webmcp/#dictdef-registeredtool).
+     * outputSchema is optional for page and custom tools.
+     */
+    tool: WebmcpAPI.ToolMetadata;
+}
+export interface Match {
+    url_patterns: Array<string>;
+}
+export interface CustomToolAddParams {
+    namespace: string;
+    /**
+     * JavaScript expression that evaluates to a non-empty array of custom tool
+     * definitions. Limited to 8,000,000 bytes when UTF-8 encoded, so multi-byte
+     * characters reduce the allowed character count.
+     */
+    source: string;
+    /**
+     * Atomically replace all existing tools in this namespace with this batch when
+     * true.
+     */
+    force_overwrite_namespace?: boolean;
+}
+export interface CustomToolRemoveParams {
+    /**
+     * Browser session ID or name
+     */
+    id_or_name: string;
+}
+export declare namespace CustomTools {
+    export { type AddRequest as AddRequest, type CustomToolsResponse as CustomToolsResponse, type Definition as Definition, type Match as Match, type CustomToolAddParams as CustomToolAddParams, type CustomToolRemoveParams as CustomToolRemoveParams, };
+}
+//# sourceMappingURL=custom-tools.d.mts.map

package/resources/browsers/webmcp/custom-tools.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-tools.d.mts","sourceRoot":"","sources":["../../../src/resources/browsers/webmcp/custom-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,mCAA+B;AACrD,OAAO,KAAK,SAAS,qBAAiB;AACtC,OAAO,EAAE,UAAU,EAAE,sCAAkC;AAEvD,OAAO,EAAE,cAAc,EAAE,8CAA0C;AAGnE;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,mBAAmB,CAAC;IAIjF;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,GAAG,CACD,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,mBAAmB,EACzB,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,mBAAmB,CAAC;IAIlC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAO/F;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IAEX,IAAI,EAAE,MAAM,CAAC;IAEb,KAAK,EAAE,KAAK,CAAC;IAEb,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,IAAI,EAAE,SAAS,CAAC,YAAY,CAAC;CAC9B;AAED,MAAM,WAAW,KAAK;IACpB,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,OAAO,EACL,KAAK,UAAU,IAAI,UAAU,EAC7B,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,UAAU,IAAI,UAAU,EAC7B,KAAK,KAAK,IAAI,KAAK,EACnB,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}

package/resources/browsers/webmcp/custom-tools.d.ts

@@ -0,0 +1,118 @@
+import { APIResource } from "../../../core/resource.js";
+import * as WebmcpAPI from "./webmcp.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+/**
+ * Discover and invoke native page tools across the browser instance.
+ */
+export declare class CustomTools extends APIResource {
+    /**
+     * Returns every registered custom tool with its generated ID, namespace, matcher,
+     * and MCP tool metadata.
+     *
+     * @example
+     * ```ts
+     * const customToolsResponse =
+     *   await client.browsers.webmcp.customTools.list(
+     *     'id_or_name',
+     *   );
+     * ```
+     */
+    list(idOrName: string, options?: RequestOptions): APIPromise<CustomToolsResponse>;
+    /**
+     * Add a namespaced batch of custom tools. A custom tool can be page-backed or
+     * CDP-backed. Page-backed tools execute in the page via JavaScript. CDP-backed
+     * tools execute via CDP and can use all browser REPL tools (see `/repl`). The
+     * source must evaluate to a non-empty array of definitions with URL matchers, tool
+     * metadata (including an optional output schema), and execute functions. The batch
+     * is added atomically. Matchers apply to top-level documents and nested frames,
+     * including out-of-process iframes; each matching tool is exposed once on the
+     * tab's top-level document and appears in the WebMCP tool snapshot.
+     *
+     * To update one tool, list the tools, delete its ID, and add its replacement. Set
+     * force_overwrite_namespace to replace every existing tool in the namespace
+     * atomically; omitted or false adds tools without replacing existing ones.
+     * Existing invocations continue.
+     *
+     * @example
+     * ```ts
+     * const customToolsResponse =
+     *   await client.browsers.webmcp.customTools.add(
+     *     'id_or_name',
+     *     { namespace: 'namespace', source: 'source' },
+     *   );
+     * ```
+     */
+    add(idOrName: string, body: CustomToolAddParams, options?: RequestOptions): APIPromise<CustomToolsResponse>;
+    /**
+     * Removes one custom tool by generated ID. An invocation already in progress is
+     * not canceled.
+     *
+     * @example
+     * ```ts
+     * await client.browsers.webmcp.customTools.remove(
+     *   'ct_n10b9798ad53ecc4y69z31e1',
+     *   { id_or_name: 'id_or_name' },
+     * );
+     * ```
+     */
+    remove(id: string, params: CustomToolRemoveParams, options?: RequestOptions): APIPromise<void>;
+}
+export interface AddRequest {
+    namespace: string;
+    /**
+     * JavaScript expression that evaluates to a non-empty array of custom tool
+     * definitions. Limited to 8,000,000 bytes when UTF-8 encoded, so multi-byte
+     * characters reduce the allowed character count.
+     */
+    source: string;
+    /**
+     * Atomically replace all existing tools in this namespace with this batch when
+     * true.
+     */
+    force_overwrite_namespace?: boolean;
+}
+export interface CustomToolsResponse {
+    tools: Array<Definition>;
+}
+export interface Definition {
+    id: string;
+    kind: string;
+    match: Match;
+    namespace: string;
+    /**
+     * Tool metadata follows the
+     * [MCP Tool definition](https://modelcontextprotocol.io/specification/2025-11-25/server/tools#tool)
+     * and the
+     * [WebMCP RegisteredTool definition](https://webmachinelearning.github.io/webmcp/#dictdef-registeredtool).
+     * outputSchema is optional for page and custom tools.
+     */
+    tool: WebmcpAPI.ToolMetadata;
+}
+export interface Match {
+    url_patterns: Array<string>;
+}
+export interface CustomToolAddParams {
+    namespace: string;
+    /**
+     * JavaScript expression that evaluates to a non-empty array of custom tool
+     * definitions. Limited to 8,000,000 bytes when UTF-8 encoded, so multi-byte
+     * characters reduce the allowed character count.
+     */
+    source: string;
+    /**
+     * Atomically replace all existing tools in this namespace with this batch when
+     * true.
+     */
+    force_overwrite_namespace?: boolean;
+}
+export interface CustomToolRemoveParams {
+    /**
+     * Browser session ID or name
+     */
+    id_or_name: string;
+}
+export declare namespace CustomTools {
+    export { type AddRequest as AddRequest, type CustomToolsResponse as CustomToolsResponse, type Definition as Definition, type Match as Match, type CustomToolAddParams as CustomToolAddParams, type CustomToolRemoveParams as CustomToolRemoveParams, };
+}
+//# sourceMappingURL=custom-tools.d.ts.map

package/resources/browsers/webmcp/custom-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-tools.d.ts","sourceRoot":"","sources":["../../../src/resources/browsers/webmcp/custom-tools.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,kCAA+B;AACrD,OAAO,KAAK,SAAS,oBAAiB;AACtC,OAAO,EAAE,UAAU,EAAE,qCAAkC;AAEvD,OAAO,EAAE,cAAc,EAAE,6CAA0C;AAGnE;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,mBAAmB,CAAC;IAIjF;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,GAAG,CACD,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,mBAAmB,EACzB,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,mBAAmB,CAAC;IAIlC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAO/F;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IAEX,IAAI,EAAE,MAAM,CAAC;IAEb,KAAK,EAAE,KAAK,CAAC;IAEb,SAAS,EAAE,MAAM,CAAC;IAElB;;;;;;OAMG;IACH,IAAI,EAAE,SAAS,CAAC,YAAY,CAAC;CAC9B;AAED,MAAM,WAAW,KAAK;IACpB,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,OAAO,EACL,KAAK,UAAU,IAAI,UAAU,EAC7B,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,UAAU,IAAI,UAAU,EAC7B,KAAK,KAAK,IAAI,KAAK,EACnB,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}

package/resources/browsers/webmcp/custom-tools.js

@@ -0,0 +1,75 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomTools = void 0;
+const resource_1 = require("../../../core/resource.js");
+const headers_1 = require("../../../internal/headers.js");
+const path_1 = require("../../../internal/utils/path.js");
+/**
+ * Discover and invoke native page tools across the browser instance.
+ */
+class CustomTools extends resource_1.APIResource {
+    /**
+     * Returns every registered custom tool with its generated ID, namespace, matcher,
+     * and MCP tool metadata.
+     *
+     * @example
+     * ```ts
+     * const customToolsResponse =
+     *   await client.browsers.webmcp.customTools.list(
+     *     'id_or_name',
+     *   );
+     * ```
+     */
+    list(idOrName, options) {
+        return this._client.get((0, path_1.path) `/browsers/${idOrName}/webmcp/custom-tools`, options);
+    }
+    /**
+     * Add a namespaced batch of custom tools. A custom tool can be page-backed or
+     * CDP-backed. Page-backed tools execute in the page via JavaScript. CDP-backed
+     * tools execute via CDP and can use all browser REPL tools (see `/repl`). The
+     * source must evaluate to a non-empty array of definitions with URL matchers, tool
+     * metadata (including an optional output schema), and execute functions. The batch
+     * is added atomically. Matchers apply to top-level documents and nested frames,
+     * including out-of-process iframes; each matching tool is exposed once on the
+     * tab's top-level document and appears in the WebMCP tool snapshot.
+     *
+     * To update one tool, list the tools, delete its ID, and add its replacement. Set
+     * force_overwrite_namespace to replace every existing tool in the namespace
+     * atomically; omitted or false adds tools without replacing existing ones.
+     * Existing invocations continue.
+     *
+     * @example
+     * ```ts
+     * const customToolsResponse =
+     *   await client.browsers.webmcp.customTools.add(
+     *     'id_or_name',
+     *     { namespace: 'namespace', source: 'source' },
+     *   );
+     * ```
+     */
+    add(idOrName, body, options) {
+        return this._client.post((0, path_1.path) `/browsers/${idOrName}/webmcp/custom-tools`, { body, ...options });
+    }
+    /**
+     * Removes one custom tool by generated ID. An invocation already in progress is
+     * not canceled.
+     *
+     * @example
+     * ```ts
+     * await client.browsers.webmcp.customTools.remove(
+     *   'ct_n10b9798ad53ecc4y69z31e1',
+     *   { id_or_name: 'id_or_name' },
+     * );
+     * ```
+     */
+    remove(id, params, options) {
+        const { id_or_name } = params;
+        return this._client.delete((0, path_1.path) `/browsers/${id_or_name}/webmcp/custom-tools/${id}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.CustomTools = CustomTools;
+//# sourceMappingURL=custom-tools.js.map

package/resources/browsers/webmcp/custom-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-tools.js","sourceRoot":"","sources":["../../../src/resources/browsers/webmcp/custom-tools.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAGrD,0DAAyD;AAEzD,0DAAoD;AAEpD;;GAEG;AACH,MAAa,WAAY,SAAQ,sBAAW;IAC1C;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,QAAgB,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,aAAa,QAAQ,sBAAsB,EAAE,OAAO,CAAC,CAAC;IACpF,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,GAAG,CACD,QAAgB,EAChB,IAAyB,EACzB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,aAAa,QAAQ,sBAAsB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClG,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAU,EAAE,MAA8B,EAAE,OAAwB;QACzE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,aAAa,UAAU,wBAAwB,EAAE,EAAE,EAAE;YAClF,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;AApED,kCAoEC"}

package/resources/browsers/webmcp/custom-tools.mjs

@@ -0,0 +1,71 @@
+// 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";
+/**
+ * Discover and invoke native page tools across the browser instance.
+ */
+export class CustomTools extends APIResource {
+    /**
+     * Returns every registered custom tool with its generated ID, namespace, matcher,
+     * and MCP tool metadata.
+     *
+     * @example
+     * ```ts
+     * const customToolsResponse =
+     *   await client.browsers.webmcp.customTools.list(
+     *     'id_or_name',
+     *   );
+     * ```
+     */
+    list(idOrName, options) {
+        return this._client.get(path `/browsers/${idOrName}/webmcp/custom-tools`, options);
+    }
+    /**
+     * Add a namespaced batch of custom tools. A custom tool can be page-backed or
+     * CDP-backed. Page-backed tools execute in the page via JavaScript. CDP-backed
+     * tools execute via CDP and can use all browser REPL tools (see `/repl`). The
+     * source must evaluate to a non-empty array of definitions with URL matchers, tool
+     * metadata (including an optional output schema), and execute functions. The batch
+     * is added atomically. Matchers apply to top-level documents and nested frames,
+     * including out-of-process iframes; each matching tool is exposed once on the
+     * tab's top-level document and appears in the WebMCP tool snapshot.
+     *
+     * To update one tool, list the tools, delete its ID, and add its replacement. Set
+     * force_overwrite_namespace to replace every existing tool in the namespace
+     * atomically; omitted or false adds tools without replacing existing ones.
+     * Existing invocations continue.
+     *
+     * @example
+     * ```ts
+     * const customToolsResponse =
+     *   await client.browsers.webmcp.customTools.add(
+     *     'id_or_name',
+     *     { namespace: 'namespace', source: 'source' },
+     *   );
+     * ```
+     */
+    add(idOrName, body, options) {
+        return this._client.post(path `/browsers/${idOrName}/webmcp/custom-tools`, { body, ...options });
+    }
+    /**
+     * Removes one custom tool by generated ID. An invocation already in progress is
+     * not canceled.
+     *
+     * @example
+     * ```ts
+     * await client.browsers.webmcp.customTools.remove(
+     *   'ct_n10b9798ad53ecc4y69z31e1',
+     *   { id_or_name: 'id_or_name' },
+     * );
+     * ```
+     */
+    remove(id, params, options) {
+        const { id_or_name } = params;
+        return this._client.delete(path `/browsers/${id_or_name}/webmcp/custom-tools/${id}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+//# sourceMappingURL=custom-tools.mjs.map

package/resources/browsers/webmcp/custom-tools.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-tools.mjs","sourceRoot":"","sources":["../../../src/resources/browsers/webmcp/custom-tools.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,mCAA+B;AAGrD,OAAO,EAAE,YAAY,EAAE,sCAAkC;AAEzD,OAAO,EAAE,IAAI,EAAE,yCAAqC;AAEpD;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,QAAgB,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,aAAa,QAAQ,sBAAsB,EAAE,OAAO,CAAC,CAAC;IACpF,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,GAAG,CACD,QAAgB,EAChB,IAAyB,EACzB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,aAAa,QAAQ,sBAAsB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClG,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,EAAU,EAAE,MAA8B,EAAE,OAAwB;QACzE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,aAAa,UAAU,wBAAwB,EAAE,EAAE,EAAE;YAClF,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/webmcp/index.d.mts

@@ -0,0 +1,3 @@
+export { CustomTools, type AddRequest, type CustomToolsResponse, type Definition, type Match, type CustomToolAddParams, type CustomToolRemoveParams, } from "./custom-tools.mjs";
+export { Webmcp, type CustomToolSource, type InvocationFailure, type InvocationResult, type InvokeRequest, type Tool, type ToolAnnotations, type ToolFrame, type ToolMetadata, type ToolSource, type ToolsResponse, type WebmcpInvokeToolParams, type WebmcpListToolsParams, } from "./webmcp.mjs";
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/resources/browsers/webmcp/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B,2BAAuB;AACxB,OAAO,EACL,MAAM,EACN,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,IAAI,EACT,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC3B,qBAAiB"}

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

@@ -0,0 +1,3 @@
+export { CustomTools, type AddRequest, type CustomToolsResponse, type Definition, type Match, type CustomToolAddParams, type CustomToolRemoveParams, } from "./custom-tools.js";
+export { Webmcp, type CustomToolSource, type InvocationFailure, type InvocationResult, type InvokeRequest, type Tool, type ToolAnnotations, type ToolFrame, type ToolMetadata, type ToolSource, type ToolsResponse, type WebmcpInvokeToolParams, type WebmcpListToolsParams, } from "./webmcp.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resources/browsers/webmcp/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B,0BAAuB;AACxB,OAAO,EACL,MAAM,EACN,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,IAAI,EACT,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC3B,oBAAiB"}

package/resources/browsers/webmcp/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.Webmcp = exports.CustomTools = void 0;
+var custom_tools_1 = require("./custom-tools.js");
+Object.defineProperty(exports, "CustomTools", { enumerable: true, get: function () { return custom_tools_1.CustomTools; } });
+var webmcp_1 = require("./webmcp.js");
+Object.defineProperty(exports, "Webmcp", { enumerable: true, get: function () { return webmcp_1.Webmcp; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/browsers/webmcp/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAQwB;AAPtB,2GAAA,WAAW,OAAA;AAQb,sCAckB;AAbhB,gGAAA,MAAM,OAAA"}

package/resources/browsers/webmcp/index.mjs

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { CustomTools, } from "./custom-tools.mjs";
+export { Webmcp, } from "./webmcp.mjs";
+//# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/resources/browsers/webmcp/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EACL,WAAW,GAOZ,2BAAuB;AACxB,OAAO,EACL,MAAM,GAaP,qBAAiB"}

package/resources/browsers/webmcp/webmcp.d.mts

@@ -0,0 +1,211 @@
+import { APIResource } from "../../../core/resource.mjs";
+import * as CustomToolsAPI from "./custom-tools.mjs";
+import { AddRequest, CustomToolAddParams, CustomToolRemoveParams, CustomTools, CustomToolsResponse, Definition, Match } from "./custom-tools.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+/**
+ * Discover and invoke native page tools across the browser instance.
+ */
+export declare class Webmcp extends APIResource {
+    customTools: CustomToolsAPI.CustomTools;
+    /**
+     * Invokes the exact live registration identified by tool_ref. Non-autosubmit
+     * declarative form tools return after their fields are populated with an
+     * awaiting_submission status. Other tools wait for a terminal result, including
+     * across navigation. Inspect a populated form, obtain any required confirmation,
+     * then submit through Playwright or computer interaction without invoking the tool
+     * again. If the tab or embedded frame disappears, or the request times out after
+     * invocation begins, the response reports outcome_unknown and the tool is not
+     * retried. CDP-backed custom tool outputs above 240 KiB return an error rather
+     * than a truncated result.
+     *
+     * @example
+     * ```ts
+     * const invocationResult =
+     *   await client.browsers.webmcp.invokeTool(
+     *     'htzv5orfit78e1m2biiifpbv',
+     *     {
+     *       input: { foo: 'bar' },
+     *       tool_ref: 'x',
+     *     },
+     *   );
+     * ```
+     */
+    invokeTool(idOrName: string, body: WebmcpInvokeToolParams, options?: RequestOptions): APIPromise<InvocationResult>;
+    /**
+     * Returns a snapshot of native and custom WebMCP tools available across every open
+     * tab and embedded frame in the browser. Each tool includes an opaque tool_ref for
+     * invoking that exact live registration, nested tool metadata, and source
+     * information. Custom tools include their generated ID, namespace, and CDP
+     * target_id in source. Tools disappear when their document closes or navigates
+     * away. Use exclude_custom to return only page-provided tools.
+     *
+     * @example
+     * ```ts
+     * const toolsResponse =
+     *   await client.browsers.webmcp.listTools(
+     *     'htzv5orfit78e1m2biiifpbv',
+     *   );
+     * ```
+     */
+    listTools(idOrName: string, query?: WebmcpListToolsParams | null | undefined, options?: RequestOptions): APIPromise<ToolsResponse>;
+}
+export interface CustomToolSource {
+    id: string;
+    namespace: string;
+}
+export interface InvocationFailure {
+    code: 'outcome_unknown';
+    message: string;
+    invocation_id?: string;
+}
+export interface InvocationResult {
+    invocation_id: string;
+    /**
+     * awaiting_submission means a non-autosubmit declarative form was populated but
+     * not submitted. Inspect the form, obtain any required confirmation, then submit
+     * through Playwright or computer interaction without invoking the tool again. The
+     * other statuses are terminal results.
+     */
+    status: 'completed' | 'canceled' | 'error' | 'awaiting_submission';
+    error_text?: string;
+    /**
+     * Untrusted page-provided output. Callers must treat it as potentially malicious
+     * input.
+     */
+    output?: unknown;
+}
+export interface InvokeRequest {
+    /**
+     * Tool input, limited to 1 MiB after JSON serialization.
+     */
+    input: {
+        [key: string]: unknown;
+    };
+    tool_ref: string;
+    timeout_sec?: number;
+}
+export interface Tool {
+    source: ToolSource;
+    /**
+     * Tool metadata follows the
+     * [MCP Tool definition](https://modelcontextprotocol.io/specification/2025-11-25/server/tools#tool)
+     * and the
+     * [WebMCP RegisteredTool definition](https://webmachinelearning.github.io/webmcp/#dictdef-registeredtool).
+     * outputSchema is optional for page and custom tools.
+     */
+    tool: ToolMetadata;
+    /**
+     * Opaque reference for invoking this exact live registration. It becomes invalid
+     * when its document or browser process is replaced.
+     */
+    tool_ref: string;
+}
+/**
+ * Tool-provided behavioral hints from the
+ * [MCP tool specification](https://modelcontextprotocol.io/specification/2025-11-25/server/tools#tool)
+ * and the
+ * [WebMCP ToolAnnotations definition](https://webmachinelearning.github.io/webmcp/#dictdef-toolannotations).
+ * These hints are untrusted and are not enforced by Kernel.
+ */
+export interface ToolAnnotations {
+    autosubmit?: boolean;
+    consequentialHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+    readOnlyHint?: boolean;
+    untrustedContentHint?: boolean;
+}
+export interface ToolFrame {
+    /**
+     * Monotonically increasing identifier for this embedded frame during the current
+     * browser process.
+     */
+    frame_id: number;
+    /**
+     * Current frame URL with the fragment omitted.
+     */
+    url: string;
+}
+/**
+ * Tool metadata follows the
+ * [MCP Tool definition](https://modelcontextprotocol.io/specification/2025-11-25/server/tools#tool)
+ * and the
+ * [WebMCP RegisteredTool definition](https://webmachinelearning.github.io/webmcp/#dictdef-registeredtool).
+ * outputSchema is optional for page and custom tools.
+ */
+export interface ToolMetadata {
+    description: string;
+    inputSchema: {
+        [key: string]: unknown;
+    };
+    name: string;
+    /**
+     * Tool-provided behavioral hints from the
+     * [MCP tool specification](https://modelcontextprotocol.io/specification/2025-11-25/server/tools#tool)
+     * and the
+     * [WebMCP ToolAnnotations definition](https://webmachinelearning.github.io/webmcp/#dictdef-toolannotations).
+     * These hints are untrusted and are not enforced by Kernel.
+     */
+    annotations?: ToolAnnotations;
+    outputSchema?: {
+        [key: string]: unknown;
+    };
+    title?: string;
+}
+export interface ToolSource {
+    /**
+     * Embedded frame that registered the tool, or null when the top-level page
+     * registered it.
+     */
+    frame: ToolFrame | null;
+    /**
+     * Current title of the top-level page.
+     */
+    page_title: string;
+    /**
+     * Current URL of the top-level page with the fragment omitted.
+     */
+    page_url: string;
+    /**
+     * Monotonically increasing identifier for the tab during the current browser
+     * process.
+     */
+    tab_id: number;
+    /**
+     * Monotonically increasing identifier for the browser window during the current
+     * browser process.
+     */
+    window_id: number;
+    custom?: CustomToolSource;
+    /**
+     * CDP target ID for a custom tool's registration tab; omitted for page-provided
+     * tools.
+     */
+    target_id?: string;
+}
+export interface ToolsResponse {
+    tools: Array<Tool>;
+}
+export interface WebmcpInvokeToolParams {
+    /**
+     * Tool input, limited to 1 MiB after JSON serialization.
+     */
+    input: {
+        [key: string]: unknown;
+    };
+    tool_ref: string;
+    timeout_sec?: number;
+}
+export interface WebmcpListToolsParams {
+    /**
+     * Exclude custom tools when true.
+     */
+    exclude_custom?: boolean;
+}
+export declare namespace Webmcp {
+    export { type CustomToolSource as CustomToolSource, type InvocationFailure as InvocationFailure, type InvocationResult as InvocationResult, type InvokeRequest as InvokeRequest, type Tool as Tool, type ToolAnnotations as ToolAnnotations, type ToolFrame as ToolFrame, type ToolMetadata as ToolMetadata, type ToolSource as ToolSource, type ToolsResponse as ToolsResponse, type WebmcpInvokeToolParams as WebmcpInvokeToolParams, type WebmcpListToolsParams as WebmcpListToolsParams, };
+    export { CustomTools as CustomTools, type AddRequest as AddRequest, type CustomToolsResponse as CustomToolsResponse, type Definition as Definition, type Match as Match, type CustomToolAddParams as CustomToolAddParams, type CustomToolRemoveParams as CustomToolRemoveParams, };
+}
+//# sourceMappingURL=webmcp.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webmcp.d.mts","sourceRoot":"","sources":["../../../src/resources/browsers/webmcp/webmcp.ts"],"names":[],"mappings":"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"}