@onkernel/sdk 0.97.0 → 0.98.0

package/src/resources/browsers/computer.ts

@@ -17,13 +17,14 @@ export class Computer extends APIResource {
    *
    * @example
    * ```ts
-   * await client.browsers.computer.batch('id', {
-   *   actions: [{ type: 'click_mouse' }],
-   * });
+   * await client.browsers.computer.batch(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   { actions: [{ type: 'click_mouse' }] },
+   * );
    * ```
    */
-  batch(id: string, body: ComputerBatchParams, options?: RequestOptions): APIPromise<void> {
-    return this._client.post(path`/browsers/${id}/computer/batch`, {
+  batch(idOrName: string, body: ComputerBatchParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/browsers/${idOrName}/computer/batch`, {
       body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
@@ -36,18 +37,20 @@ export class Computer extends APIResource {
    * @example
    * ```ts
    * const response =
-   *   await client.browsers.computer.captureScreenshot('id');
+   *   await client.browsers.computer.captureScreenshot(
+   *     'htzv5orfit78e1m2biiifpbv',
+   *   );
    *
    * const content = await response.blob();
    * console.log(content);
    * ```
    */
   captureScreenshot(
-    id: string,
+    idOrName: string,
     body: ComputerCaptureScreenshotParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<Response> {
-    return this._client.post(path`/browsers/${id}/computer/screenshot`, {
+    return this._client.post(path`/browsers/${idOrName}/computer/screenshot`, {
       body,
       ...options,
       headers: buildHeaders([{ Accept: 'image/png' }, options?.headers]),
@@ -60,14 +63,14 @@ export class Computer extends APIResource {
    *
    * @example
    * ```ts
-   * await client.browsers.computer.clickMouse('id', {
-   *   x: 0,
-   *   y: 0,
-   * });
+   * await client.browsers.computer.clickMouse(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   { x: 0, y: 0 },
+   * );
    * ```
    */
-  clickMouse(id: string, body: ComputerClickMouseParams, options?: RequestOptions): APIPromise<void> {
-    return this._client.post(path`/browsers/${id}/computer/click_mouse`, {
+  clickMouse(idOrName: string, body: ComputerClickMouseParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/browsers/${idOrName}/computer/click_mouse`, {
       body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
@@ -79,16 +82,19 @@ export class Computer extends APIResource {
    *
    * @example
    * ```ts
-   * await client.browsers.computer.dragMouse('id', {
-   *   path: [
-   *     [0, 0],
-   *     [0, 0],
-   *   ],
-   * });
+   * await client.browsers.computer.dragMouse(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   {
+   *     path: [
+   *       [0, 0],
+   *       [0, 0],
+   *     ],
+   *   },
+   * );
    * ```
    */
-  dragMouse(id: string, body: ComputerDragMouseParams, options?: RequestOptions): APIPromise<void> {
-    return this._client.post(path`/browsers/${id}/computer/drag_mouse`, {
+  dragMouse(idOrName: string, body: ComputerDragMouseParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/browsers/${idOrName}/computer/drag_mouse`, {
       body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
@@ -101,11 +107,13 @@ export class Computer extends APIResource {
    * @example
    * ```ts
    * const response =
-   *   await client.browsers.computer.getMousePosition('id');
+   *   await client.browsers.computer.getMousePosition(
+   *     'htzv5orfit78e1m2biiifpbv',
+   *   );
    * ```
    */
-  getMousePosition(id: string, options?: RequestOptions): APIPromise<ComputerGetMousePositionResponse> {
-    return this._client.post(path`/browsers/${id}/computer/get_mouse_position`, options);
+  getMousePosition(idOrName: string, options?: RequestOptions): APIPromise<ComputerGetMousePositionResponse> {
+    return this._client.post(path`/browsers/${idOrName}/computer/get_mouse_position`, options);
   }
 
   /**
@@ -113,14 +121,14 @@ export class Computer extends APIResource {
    *
    * @example
    * ```ts
-   * await client.browsers.computer.moveMouse('id', {
-   *   x: 0,
-   *   y: 0,
-   * });
+   * await client.browsers.computer.moveMouse(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   { x: 0, y: 0 },
+   * );
    * ```
    */
-  moveMouse(id: string, body: ComputerMoveMouseParams, options?: RequestOptions): APIPromise<void> {
-    return this._client.post(path`/browsers/${id}/computer/move_mouse`, {
+  moveMouse(idOrName: string, body: ComputerMoveMouseParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/browsers/${idOrName}/computer/move_mouse`, {
       body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
@@ -132,13 +140,14 @@ export class Computer extends APIResource {
    *
    * @example
    * ```ts
-   * await client.browsers.computer.pressKey('id', {
-   *   keys: ['string'],
-   * });
+   * await client.browsers.computer.pressKey(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   { keys: ['string'] },
+   * );
    * ```
    */
-  pressKey(id: string, body: ComputerPressKeyParams, options?: RequestOptions): APIPromise<void> {
-    return this._client.post(path`/browsers/${id}/computer/press_key`, {
+  pressKey(idOrName: string, body: ComputerPressKeyParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/browsers/${idOrName}/computer/press_key`, {
       body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
@@ -151,11 +160,13 @@ export class Computer extends APIResource {
    * @example
    * ```ts
    * const response =
-   *   await client.browsers.computer.readClipboard('id');
+   *   await client.browsers.computer.readClipboard(
+   *     'htzv5orfit78e1m2biiifpbv',
+   *   );
    * ```
    */
-  readClipboard(id: string, options?: RequestOptions): APIPromise<ComputerReadClipboardResponse> {
-    return this._client.post(path`/browsers/${id}/computer/clipboard/read`, options);
+  readClipboard(idOrName: string, options?: RequestOptions): APIPromise<ComputerReadClipboardResponse> {
+    return this._client.post(path`/browsers/${idOrName}/computer/clipboard/read`, options);
   }
 
   /**
@@ -163,11 +174,14 @@ export class Computer extends APIResource {
    *
    * @example
    * ```ts
-   * await client.browsers.computer.scroll('id', { x: 0, y: 0 });
+   * await client.browsers.computer.scroll(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   { x: 0, y: 0 },
+   * );
    * ```
    */
-  scroll(id: string, body: ComputerScrollParams, options?: RequestOptions): APIPromise<void> {
-    return this._client.post(path`/browsers/${id}/computer/scroll`, {
+  scroll(idOrName: string, body: ComputerScrollParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/browsers/${idOrName}/computer/scroll`, {
       body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
@@ -180,17 +194,18 @@ export class Computer extends APIResource {
    * @example
    * ```ts
    * const response =
-   *   await client.browsers.computer.setCursorVisibility('id', {
-   *     hidden: true,
-   *   });
+   *   await client.browsers.computer.setCursorVisibility(
+   *     'htzv5orfit78e1m2biiifpbv',
+   *     { hidden: true },
+   *   );
    * ```
    */
   setCursorVisibility(
-    id: string,
+    idOrName: string,
     body: ComputerSetCursorVisibilityParams,
     options?: RequestOptions,
   ): APIPromise<ComputerSetCursorVisibilityResponse> {
-    return this._client.post(path`/browsers/${id}/computer/cursor`, { body, ...options });
+    return this._client.post(path`/browsers/${idOrName}/computer/cursor`, { body, ...options });
   }
 
   /**
@@ -198,13 +213,14 @@ export class Computer extends APIResource {
    *
    * @example
    * ```ts
-   * await client.browsers.computer.typeText('id', {
-   *   text: 'text',
-   * });
+   * await client.browsers.computer.typeText(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   { text: 'text' },
+   * );
    * ```
    */
-  typeText(id: string, body: ComputerTypeTextParams, options?: RequestOptions): APIPromise<void> {
-    return this._client.post(path`/browsers/${id}/computer/type`, {
+  typeText(idOrName: string, body: ComputerTypeTextParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/browsers/${idOrName}/computer/type`, {
       body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
@@ -216,13 +232,18 @@ export class Computer extends APIResource {
    *
    * @example
    * ```ts
-   * await client.browsers.computer.writeClipboard('id', {
-   *   text: 'text',
-   * });
+   * await client.browsers.computer.writeClipboard(
+   *   'htzv5orfit78e1m2biiifpbv',
+   *   { text: 'text' },
+   * );
    * ```
    */
-  writeClipboard(id: string, body: ComputerWriteClipboardParams, options?: RequestOptions): APIPromise<void> {
-    return this._client.post(path`/browsers/${id}/computer/clipboard/write`, {
+  writeClipboard(
+    idOrName: string,
+    body: ComputerWriteClipboardParams,
+    options?: RequestOptions,
+  ): APIPromise<void> {
+    return this._client.post(path`/browsers/${idOrName}/computer/clipboard/write`, {
       body,
       ...options,
       headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),

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

@@ -143,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]),