@onkernel/sdk 0.96.0 → 0.98.0

package/src/resources/browsers/fs/fs.ts

@@ -28,13 +28,18 @@ export class Fs extends APIResource {
    *
    * @example
    * ```ts
-   * await client.browsers.fs.createDirectory('id', {
-   *   path: '/J!',
-   * });
+   * await client.browsers.fs.createDirectory(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   { path: '/J!' },
+   * );
    * ```
    */
-  createDirectory(id: string, body: FCreateDirectoryParams, options?: RequestOptions): APIPromise<void> {
-    return this._client.put(path`/browsers/${id}/fs/create_directory`, {
+  createDirectory(
+    idOrName: string,
+    body: FCreateDirectoryParams,
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    return this._client.put(path`/browsers/${idOrName}/fs/create_directory`, {
       body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
@@ -46,13 +51,18 @@ export class Fs extends APIResource {
    *
    * @example
    * ```ts
-   * await client.browsers.fs.deleteDirectory('id', {
-   *   path: '/J!',
-   * });
+   * await client.browsers.fs.deleteDirectory(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   { path: '/J!' },
+   * );
    * ```
    */
-  deleteDirectory(id: string, body: FDeleteDirectoryParams, options?: RequestOptions): APIPromise<void> {
-    return this._client.put(path`/browsers/${id}/fs/delete_directory`, {
+  deleteDirectory(
+    idOrName: string,
+    body: FDeleteDirectoryParams,
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    return this._client.put(path`/browsers/${idOrName}/fs/delete_directory`, {
       body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
@@ -64,11 +74,14 @@ export class Fs extends APIResource {
    *
    * @example
    * ```ts
-   * await client.browsers.fs.deleteFile('id', { path: '/J!' });
+   * await client.browsers.fs.deleteFile(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   { path: '/J!' },
+   * );
    * ```
    */
-  deleteFile(id: string, body: FDeleteFileParams, options?: RequestOptions): APIPromise<void> {
-    return this._client.put(path`/browsers/${id}/fs/delete_file`, {
+  deleteFile(idOrName: string, body: FDeleteFileParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.put(path`/browsers/${idOrName}/fs/delete_file`, {
       body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
@@ -81,7 +94,7 @@ export class Fs extends APIResource {
    * @example
    * ```ts
    * const response = await client.browsers.fs.downloadDirZip(
-   *   'id',
+   *   'htzv5orfit78e1m2biiifpbv',
    *   { path: '/J!' },
    * );
    *
@@ -89,8 +102,12 @@ export class Fs extends APIResource {
    * console.log(content);
    * ```
    */
-  downloadDirZip(id: string, query: FDownloadDirZipParams, options?: RequestOptions): APIPromise<Response> {
-    return this._client.get(path`/browsers/${id}/fs/download_dir_zip`, {
+  downloadDirZip(
+    idOrName: string,
+    query: FDownloadDirZipParams,
+    options?: RequestOptions,
+  ): APIPromise<Response> {
+    return this._client.get(path`/browsers/${idOrName}/fs/download_dir_zip`, {
       query,
       ...options,
       headers: buildHeaders([{ Accept: 'application/zip' }, options?.headers]),
@@ -103,13 +120,18 @@ export class Fs extends APIResource {
    *
    * @example
    * ```ts
-   * const response = await client.browsers.fs.fileInfo('id', {
-   *   path: '/J!',
-   * });
+   * const response = await client.browsers.fs.fileInfo(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   { path: '/J!' },
+   * );
    * ```
    */
-  fileInfo(id: string, query: FFileInfoParams, options?: RequestOptions): APIPromise<FFileInfoResponse> {
-    return this._client.get(path`/browsers/${id}/fs/file_info`, { query, ...options });
+  fileInfo(
+    idOrName: string,
+    query: FFileInfoParams,
+    options?: RequestOptions,
+  ): APIPromise<FFileInfoResponse> {
+    return this._client.get(path`/browsers/${idOrName}/fs/file_info`, { query, ...options });
   }
 
   /**
@@ -117,13 +139,18 @@ export class Fs extends APIResource {
    *
    * @example
    * ```ts
-   * const response = await client.browsers.fs.listFiles('id', {
-   *   path: '/J!',
-   * });
+   * const response = await client.browsers.fs.listFiles(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   { path: '/J!' },
+   * );
    * ```
    */
-  listFiles(id: string, query: FListFilesParams, options?: RequestOptions): APIPromise<FListFilesResponse> {
-    return this._client.get(path`/browsers/${id}/fs/list_files`, { query, ...options });
+  listFiles(
+    idOrName: string,
+    query: FListFilesParams,
+    options?: RequestOptions,
+  ): APIPromise<FListFilesResponse> {
+    return this._client.get(path`/browsers/${idOrName}/fs/list_files`, { query, ...options });
   }
 
   /**
@@ -131,14 +158,14 @@ export class Fs extends APIResource {
    *
    * @example
    * ```ts
-   * await client.browsers.fs.move('id', {
+   * await client.browsers.fs.move('htzv5orfit78e1m2biiifpbv', {
    *   dest_path: '/J!',
    *   src_path: '/J!',
    * });
    * ```
    */
-  move(id: string, body: FMoveParams, options?: RequestOptions): APIPromise<void> {
-    return this._client.put(path`/browsers/${id}/fs/move`, {
+  move(idOrName: string, body: FMoveParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.put(path`/browsers/${idOrName}/fs/move`, {
       body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
@@ -150,16 +177,17 @@ export class Fs extends APIResource {
    *
    * @example
    * ```ts
-   * const response = await client.browsers.fs.readFile('id', {
-   *   path: '/J!',
-   * });
+   * const response = await client.browsers.fs.readFile(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   { path: '/J!' },
+   * );
    *
    * const content = await response.blob();
    * console.log(content);
    * ```
    */
-  readFile(id: string, query: FReadFileParams, options?: RequestOptions): APIPromise<Response> {
-    return this._client.get(path`/browsers/${id}/fs/read_file`, {
+  readFile(idOrName: string, query: FReadFileParams, options?: RequestOptions): APIPromise<Response> {
+    return this._client.get(path`/browsers/${idOrName}/fs/read_file`, {
       query,
       ...options,
       headers: buildHeaders([{ Accept: 'application/octet-stream' }, options?.headers]),
@@ -172,18 +200,18 @@ export class Fs extends APIResource {
    *
    * @example
    * ```ts
-   * await client.browsers.fs.setFilePermissions('id', {
-   *   mode: '0611',
-   *   path: '/J!',
-   * });
+   * await client.browsers.fs.setFilePermissions(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   { mode: '0611', path: '/J!' },
+   * );
    * ```
    */
   setFilePermissions(
-    id: string,
+    idOrName: string,
     body: FSetFilePermissionsParams,
     options?: RequestOptions,
   ): APIPromise<void> {
-    return this._client.put(path`/browsers/${id}/fs/set_file_permissions`, {
+    return this._client.put(path`/browsers/${idOrName}/fs/set_file_permissions`, {
       body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
@@ -195,19 +223,22 @@ export class Fs extends APIResource {
    *
    * @example
    * ```ts
-   * await client.browsers.fs.upload('id', {
-   *   files: [
-   *     {
-   *       dest_path: '/J!',
-   *       file: fs.createReadStream('path/to/file'),
-   *     },
-   *   ],
-   * });
+   * await client.browsers.fs.upload(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   {
+   *     files: [
+   *       {
+   *         dest_path: '/J!',
+   *         file: fs.createReadStream('path/to/file'),
+   *       },
+   *     ],
+   *   },
+   * );
    * ```
    */
-  upload(id: string, body: FUploadParams, options?: RequestOptions): APIPromise<void> {
+  upload(idOrName: string, body: FUploadParams, options?: RequestOptions): APIPromise<void> {
     return this._client.post(
-      path`/browsers/${id}/fs/upload`,
+      path`/browsers/${idOrName}/fs/upload`,
       multipartFormRequestOptions(
         { body, ...options, headers: buildHeaders([{ Accept: '*/*' }, options?.headers]) },
         this._client,
@@ -220,15 +251,18 @@ export class Fs extends APIResource {
    *
    * @example
    * ```ts
-   * await client.browsers.fs.uploadZip('id', {
-   *   dest_path: '/J!',
-   *   zip_file: fs.createReadStream('path/to/file'),
-   * });
+   * await client.browsers.fs.uploadZip(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   {
+   *     dest_path: '/J!',
+   *     zip_file: fs.createReadStream('path/to/file'),
+   *   },
+   * );
    * ```
    */
-  uploadZip(id: string, body: FUploadZipParams, options?: RequestOptions): APIPromise<void> {
+  uploadZip(idOrName: string, body: FUploadZipParams, options?: RequestOptions): APIPromise<void> {
     return this._client.post(
-      path`/browsers/${id}/fs/upload_zip`,
+      path`/browsers/${idOrName}/fs/upload_zip`,
       multipartFormRequestOptions(
         { body, ...options, headers: buildHeaders([{ Accept: '*/*' }, options?.headers]) },
         this._client,
@@ -242,20 +276,20 @@ export class Fs extends APIResource {
    * @example
    * ```ts
    * await client.browsers.fs.writeFile(
-   *   'id',
+   *   'htzv5orfit78e1m2biiifpbv',
    *   fs.createReadStream('path/to/file'),
    *   { path: '/J!' },
    * );
    * ```
    */
   writeFile(
-    id: string,
+    idOrName: string,
     contents: string | ArrayBuffer | ArrayBufferView | Blob | DataView,
     params: FWriteFileParams,
     options?: RequestOptions,
   ): APIPromise<void> {
     const { path: path_, mode } = params;
-    return this._client.put(path`/browsers/${id}/fs/write_file`, {
+    return this._client.put(path`/browsers/${idOrName}/fs/write_file`, {
       body: contents,
       query: { path: path_, mode },
       ...options,

package/src/resources/browsers/fs/watch.ts

@@ -18,7 +18,7 @@ export class Watch extends APIResource {
    * ```ts
    * const response = await client.browsers.fs.watch.events(
    *   'watch_id',
-   *   { id: 'id' },
+   *   { id_or_name: 'htzv5orfit78e1m2biiifpbv' },
    * );
    * ```
    */
@@ -27,8 +27,8 @@ export class Watch extends APIResource {
     params: WatchEventsParams,
     options?: RequestOptions,
   ): APIPromise<Stream<WatchEventsResponse>> {
-    const { id } = params;
-    return this._client.get(path`/browsers/${id}/fs/watch/${watchID}/events`, {
+    const { id_or_name } = params;
+    return this._client.get(path`/browsers/${id_or_name}/fs/watch/${watchID}/events`, {
       ...options,
       headers: buildHeaders([{ Accept: 'text/event-stream' }, options?.headers]),
       stream: true,
@@ -41,13 +41,13 @@ export class Watch extends APIResource {
    * @example
    * ```ts
    * const response = await client.browsers.fs.watch.start(
-   *   'id',
+   *   'htzv5orfit78e1m2biiifpbv',
    *   { path: 'path' },
    * );
    * ```
    */
-  start(id: string, body: WatchStartParams, options?: RequestOptions): APIPromise<WatchStartResponse> {
-    return this._client.post(path`/browsers/${id}/fs/watch`, { body, ...options });
+  start(idOrName: string, body: WatchStartParams, options?: RequestOptions): APIPromise<WatchStartResponse> {
+    return this._client.post(path`/browsers/${idOrName}/fs/watch`, { body, ...options });
   }
 
   /**
@@ -56,13 +56,13 @@ export class Watch extends APIResource {
    * @example
    * ```ts
    * await client.browsers.fs.watch.stop('watch_id', {
-   *   id: 'id',
+   *   id_or_name: 'htzv5orfit78e1m2biiifpbv',
    * });
    * ```
    */
   stop(watchID: string, params: WatchStopParams, options?: RequestOptions): APIPromise<void> {
-    const { id } = params;
-    return this._client.delete(path`/browsers/${id}/fs/watch/${watchID}`, {
+    const { id_or_name } = params;
+    return this._client.delete(path`/browsers/${id_or_name}/fs/watch/${watchID}`, {
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
     });
@@ -103,9 +103,9 @@ export interface WatchStartResponse {
 
 export interface WatchEventsParams {
   /**
-   * Browser session ID
+   * Browser session ID or name
    */
-  id: string;
+  id_or_name: string;
 }
 
 export interface WatchStartParams {
@@ -122,9 +122,9 @@ export interface WatchStartParams {
 
 export interface WatchStopParams {
   /**
-   * Browser session ID
+   * Browser session ID or name
    */
-  id: string;
+  id_or_name: string;
 }
 
 export declare namespace Watch {

package/src/resources/browsers/index.ts

@@ -90,7 +90,9 @@ export {
   Telemetry,
   type BrowserAPICallEvent,
   type BrowserCallStack,
+  type BrowserCaptchaChallengeResultEvent,
   type BrowserCaptchaSolveResultEvent,
+  type BrowserCaptchaSolveStartedEvent,
   type BrowserCdpCommandEvent,
   type BrowserCdpCommandMethod,
   type BrowserCdpConnectEvent,
@@ -141,3 +143,15 @@ export {
   type TelemetryStreamParams,
   type TelemetryEventsResponsesOffsetPagination,
 } from './telemetry';
+export {
+  Webmcp,
+  type InvocationFailure,
+  type InvocationResult,
+  type InvokeRequest,
+  type Tool,
+  type ToolAnnotations,
+  type ToolFrame,
+  type ToolSource,
+  type ToolsResponse,
+  type WebmcpInvokeToolParams,
+} from './webmcp';

package/src/resources/browsers/logs.ts

@@ -17,13 +17,18 @@ export class Logs extends APIResource {
    *
    * @example
    * ```ts
-   * const logEvent = await client.browsers.logs.stream('id', {
-   *   source: 'path',
-   * });
+   * const logEvent = await client.browsers.logs.stream(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   { source: 'path' },
+   * );
    * ```
    */
-  stream(id: string, query: LogStreamParams, options?: RequestOptions): APIPromise<Stream<Shared.LogEvent>> {
-    return this._client.get(path`/browsers/${id}/logs/stream`, {
+  stream(
+    idOrName: string,
+    query: LogStreamParams,
+    options?: RequestOptions,
+  ): APIPromise<Stream<Shared.LogEvent>> {
+    return this._client.get(path`/browsers/${idOrName}/logs/stream`, {
       query,
       ...options,
       headers: buildHeaders([{ Accept: 'text/event-stream' }, options?.headers]),

package/src/resources/browsers/playwright.ts

@@ -12,23 +12,26 @@ export class Playwright extends APIResource {
   /**
    * 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', and 'browser'
-   * variables. It can `return` a value, and this value is returned in the response.
+   * 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.
    *
    * @example
    * ```ts
    * const response = await client.browsers.playwright.execute(
-   *   'id',
+   *   'htzv5orfit78e1m2biiifpbv',
    *   { code: 'code' },
    * );
    * ```
    */
   execute(
-    id: string,
+    idOrName: string,
     body: PlaywrightExecuteParams,
     options?: RequestOptions,
   ): APIPromise<PlaywrightExecuteResponse> {
-    return this._client.post(path`/browsers/${id}/playwright/execute`, { body, ...options });
+    return this._client.post(path`/browsers/${idOrName}/playwright/execute`, { body, ...options });
   }
 }
 

package/src/resources/browsers/process.ts

@@ -16,13 +16,14 @@ export class Process extends APIResource {
    *
    * @example
    * ```ts
-   * const response = await client.browsers.process.exec('id', {
-   *   command: 'command',
-   * });
+   * const response = await client.browsers.process.exec(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   { command: 'command' },
+   * );
    * ```
    */
-  exec(id: string, body: ProcessExecParams, options?: RequestOptions): APIPromise<ProcessExecResponse> {
-    return this._client.post(path`/browsers/${id}/process/exec`, { body, ...options });
+  exec(idOrName: string, body: ProcessExecParams, options?: RequestOptions): APIPromise<ProcessExecResponse> {
+    return this._client.post(path`/browsers/${idOrName}/process/exec`, { body, ...options });
   }
 
   /**
@@ -32,7 +33,10 @@ export class Process extends APIResource {
    * ```ts
    * const response = await client.browsers.process.kill(
    *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
-   *   { id: 'id', signal: 'TERM' },
+   *   {
+   *     id_or_name: 'htzv5orfit78e1m2biiifpbv',
+   *     signal: 'TERM',
+   *   },
    * );
    * ```
    */
@@ -41,8 +45,8 @@ export class Process extends APIResource {
     params: ProcessKillParams,
     options?: RequestOptions,
   ): APIPromise<ProcessKillResponse> {
-    const { id, ...body } = params;
-    return this._client.post(path`/browsers/${id}/process/${processID}/kill`, { body, ...options });
+    const { id_or_name, ...body } = params;
+    return this._client.post(path`/browsers/${id_or_name}/process/${processID}/kill`, { body, ...options });
   }
 
   /**
@@ -53,7 +57,7 @@ export class Process extends APIResource {
    * const response = await client.browsers.process.resize(
    *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
    *   {
-   *     id: 'id',
+   *     id_or_name: 'htzv5orfit78e1m2biiifpbv',
    *     cols: 1,
    *     rows: 1,
    *   },
@@ -65,8 +69,8 @@ export class Process extends APIResource {
     params: ProcessResizeParams,
     options?: RequestOptions,
   ): APIPromise<ProcessResizeResponse> {
-    const { id, ...body } = params;
-    return this._client.post(path`/browsers/${id}/process/${processID}/resize`, { body, ...options });
+    const { id_or_name, ...body } = params;
+    return this._client.post(path`/browsers/${id_or_name}/process/${processID}/resize`, { body, ...options });
   }
 
   /**
@@ -74,13 +78,18 @@ export class Process extends APIResource {
    *
    * @example
    * ```ts
-   * const response = await client.browsers.process.spawn('id', {
-   *   command: 'command',
-   * });
+   * const response = await client.browsers.process.spawn(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   { command: 'command' },
+   * );
    * ```
    */
-  spawn(id: string, body: ProcessSpawnParams, options?: RequestOptions): APIPromise<ProcessSpawnResponse> {
-    return this._client.post(path`/browsers/${id}/process/spawn`, { body, ...options });
+  spawn(
+    idOrName: string,
+    body: ProcessSpawnParams,
+    options?: RequestOptions,
+  ): APIPromise<ProcessSpawnResponse> {
+    return this._client.post(path`/browsers/${idOrName}/process/spawn`, { body, ...options });
   }
 
   /**
@@ -90,7 +99,7 @@ export class Process extends APIResource {
    * ```ts
    * const response = await client.browsers.process.status(
    *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
-   *   { id: 'id' },
+   *   { id_or_name: 'htzv5orfit78e1m2biiifpbv' },
    * );
    * ```
    */
@@ -99,8 +108,8 @@ export class Process extends APIResource {
     params: ProcessStatusParams,
     options?: RequestOptions,
   ): APIPromise<ProcessStatusResponse> {
-    const { id } = params;
-    return this._client.get(path`/browsers/${id}/process/${processID}/status`, options);
+    const { id_or_name } = params;
+    return this._client.get(path`/browsers/${id_or_name}/process/${processID}/status`, options);
   }
 
   /**
@@ -110,7 +119,10 @@ export class Process extends APIResource {
    * ```ts
    * const response = await client.browsers.process.stdin(
    *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
-   *   { id: 'id', data_b64: 'data_b64' },
+   *   {
+   *     id_or_name: 'htzv5orfit78e1m2biiifpbv',
+   *     data_b64: 'data_b64',
+   *   },
    * );
    * ```
    */
@@ -119,8 +131,8 @@ export class Process extends APIResource {
     params: ProcessStdinParams,
     options?: RequestOptions,
   ): APIPromise<ProcessStdinResponse> {
-    const { id, ...body } = params;
-    return this._client.post(path`/browsers/${id}/process/${processID}/stdin`, { body, ...options });
+    const { id_or_name, ...body } = params;
+    return this._client.post(path`/browsers/${id_or_name}/process/${processID}/stdin`, { body, ...options });
   }
 
   /**
@@ -130,7 +142,7 @@ export class Process extends APIResource {
    * ```ts
    * const response = await client.browsers.process.stdoutStream(
    *   '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
-   *   { id: 'id' },
+   *   { id_or_name: 'htzv5orfit78e1m2biiifpbv' },
    * );
    * ```
    */
@@ -139,8 +151,8 @@ export class Process extends APIResource {
     params: ProcessStdoutStreamParams,
     options?: RequestOptions,
   ): APIPromise<Stream<ProcessStdoutStreamResponse>> {
-    const { id } = params;
-    return this._client.get(path`/browsers/${id}/process/${processID}/stdout/stream`, {
+    const { id_or_name } = params;
+    return this._client.get(path`/browsers/${id_or_name}/process/${processID}/stdout/stream`, {
       ...options,
       headers: buildHeaders([{ Accept: 'text/event-stream' }, options?.headers]),
       stream: true,
@@ -312,9 +324,9 @@ export interface ProcessExecParams {
 
 export interface ProcessKillParams {
   /**
-   * Path param: Browser session ID
+   * Path param: Browser session ID or name
    */
-  id: string;
+  id_or_name: string;
 
   /**
    * Body param: Signal to send.
@@ -324,9 +336,9 @@ export interface ProcessKillParams {
 
 export interface ProcessResizeParams {
   /**
-   * Path param: Browser session ID
+   * Path param: Browser session ID or name
    */
-  id: string;
+  id_or_name: string;
 
   /**
    * Body param: New terminal columns.
@@ -393,16 +405,16 @@ export interface ProcessSpawnParams {
 
 export interface ProcessStatusParams {
   /**
-   * Browser session ID
+   * Browser session ID or name
    */
-  id: string;
+  id_or_name: string;
 }
 
 export interface ProcessStdinParams {
   /**
-   * Path param: Browser session ID
+   * Path param: Browser session ID or name
    */
-  id: string;
+  id_or_name: string;
 
   /**
    * Body param: Base64-encoded data to write.
@@ -412,9 +424,9 @@ export interface ProcessStdinParams {
 
 export interface ProcessStdoutStreamParams {
   /**
-   * Browser session ID
+   * Browser session ID or name
    */
-  id: string;
+  id_or_name: string;
 }
 
 export declare namespace Process {