@realtimex/sdk 1.7.12 → 1.7.14

package/dist/{chunk-3DVGTGOK.mjs → chunk-PEWBG7US.mjs}

@@ -705,6 +705,83 @@ var V1DesktopRuntimeSessionsModule = class {
   }
 };
 
+// src/v1/modules/v1DesktopBrowser.ts
+var V1DesktopBrowserModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List RealTimeX Browser sessions available in the Electron desktop app.
+   * @see GET /sdk/desktop/browser/sessions
+   */
+  async listSessions() {
+    return this.client.request("GET", `/sdk/desktop/browser/sessions`);
+  }
+  /**
+   * Create a named RealTimeX Browser session in the Electron desktop app.
+   * @see POST /sdk/desktop/browser/sessions
+   */
+  async createSession(body) {
+    return this.client.request("POST", `/sdk/desktop/browser/sessions`, body);
+  }
+  /**
+   * Get a specific RealTimeX Browser session by session name.
+   * @see GET /sdk/desktop/browser/sessions/{sessionName}
+   */
+  async getSession(sessionName) {
+    return this.client.request("GET", `/sdk/desktop/browser/sessions/${sessionName}`);
+  }
+  /**
+   * Delete a named RealTimeX Browser session from the Electron desktop app.
+   * @see DELETE /sdk/desktop/browser/sessions/{sessionName}
+   */
+  async deleteSession(sessionName) {
+    return this.client.request("DELETE", `/sdk/desktop/browser/sessions/${sessionName}`);
+  }
+  /**
+   * Create a RealTimeX Browser tab, optionally launching the browser session if needed.
+   * @see POST /sdk/desktop/browser/tabs
+   */
+  async createTab(body) {
+    return this.client.request("POST", `/sdk/desktop/browser/tabs`, body);
+  }
+  /**
+   * Get a RealTimeX Browser tab snapshot by tab reference.
+   * @see GET /sdk/desktop/browser/tabs/{tabRef}
+   */
+  async getTab(tabRef) {
+    return this.client.request("GET", `/sdk/desktop/browser/tabs/${tabRef}`);
+  }
+  /**
+   * Close an existing RealTimeX Browser tab.
+   * @see DELETE /sdk/desktop/browser/tabs/{tabRef}
+   */
+  async deleteTab(tabRef) {
+    return this.client.request("DELETE", `/sdk/desktop/browser/tabs/${tabRef}`);
+  }
+  /**
+   * Evaluate JavaScript in a specific RealTimeX Browser tab.
+   * @see POST /sdk/desktop/browser/tabs/{tabRef}/evaluate
+   */
+  async evaluateTab(tabRef, body) {
+    return this.client.request("POST", `/sdk/desktop/browser/tabs/${tabRef}/evaluate`, body);
+  }
+  /**
+   * Focus an existing RealTimeX Browser tab.
+   * @see POST /sdk/desktop/browser/tabs/{tabRef}/focus
+   */
+  async focusTab(tabRef, body) {
+    return this.client.request("POST", `/sdk/desktop/browser/tabs/${tabRef}/focus`, body);
+  }
+  /**
+   * Navigate an existing RealTimeX Browser tab to a new URL.
+   * @see POST /sdk/desktop/browser/tabs/{tabRef}/navigate
+   */
+  async navigateTab(tabRef, body) {
+    return this.client.request("POST", `/sdk/desktop/browser/tabs/${tabRef}/navigate`, body);
+  }
+};
+
 // src/v1/namespace.ts
 var V1ApiNamespace = class {
   // [GENERATED-PROPS-END]
@@ -720,6 +797,7 @@ var V1ApiNamespace = class {
     this.openai = new V1OpenAIModule(this._client);
     this.embed = new V1EmbedModule(this._client);
     this.desktopRuntimeSessions = new V1DesktopRuntimeSessionsModule(this._client);
+    this.desktopBrowser = new V1DesktopBrowserModule(this._client);
   }
 };
 
@@ -740,5 +818,6 @@ export {
   V1OpenAIModule,
   V1EmbedModule,
   V1DesktopRuntimeSessionsModule,
+  V1DesktopBrowserModule,
   V1ApiNamespace
 };

package/dist/{errors-x6ngbrlA.d.mts → errors-DsxB91BA.d.mts}

@@ -450,6 +450,61 @@ declare class V1DesktopRuntimeSessionsModule {
     permission(sessionId: string, body?: Record<string, unknown>): Promise<unknown>;
 }
 
+declare class V1DesktopBrowserModule {
+    private readonly client;
+    constructor(client: DeveloperApiClient);
+    /**
+     * List RealTimeX Browser sessions available in the Electron desktop app.
+     * @see GET /sdk/desktop/browser/sessions
+     */
+    listSessions(): Promise<unknown>;
+    /**
+     * Create a named RealTimeX Browser session in the Electron desktop app.
+     * @see POST /sdk/desktop/browser/sessions
+     */
+    createSession(body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Get a specific RealTimeX Browser session by session name.
+     * @see GET /sdk/desktop/browser/sessions/{sessionName}
+     */
+    getSession(sessionName: string): Promise<unknown>;
+    /**
+     * Delete a named RealTimeX Browser session from the Electron desktop app.
+     * @see DELETE /sdk/desktop/browser/sessions/{sessionName}
+     */
+    deleteSession(sessionName: string): Promise<unknown>;
+    /**
+     * Create a RealTimeX Browser tab, optionally launching the browser session if needed.
+     * @see POST /sdk/desktop/browser/tabs
+     */
+    createTab(body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Get a RealTimeX Browser tab snapshot by tab reference.
+     * @see GET /sdk/desktop/browser/tabs/{tabRef}
+     */
+    getTab(tabRef: string): Promise<unknown>;
+    /**
+     * Close an existing RealTimeX Browser tab.
+     * @see DELETE /sdk/desktop/browser/tabs/{tabRef}
+     */
+    deleteTab(tabRef: string): Promise<unknown>;
+    /**
+     * Evaluate JavaScript in a specific RealTimeX Browser tab.
+     * @see POST /sdk/desktop/browser/tabs/{tabRef}/evaluate
+     */
+    evaluateTab(tabRef: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Focus an existing RealTimeX Browser tab.
+     * @see POST /sdk/desktop/browser/tabs/{tabRef}/focus
+     */
+    focusTab(tabRef: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Navigate an existing RealTimeX Browser tab to a new URL.
+     * @see POST /sdk/desktop/browser/tabs/{tabRef}/navigate
+     */
+    navigateTab(tabRef: string, body?: Record<string, unknown>): Promise<unknown>;
+}
+
 /**
  * V1ApiNamespace - Container for all RealtimeX Developer API (v1) modules.
  *
@@ -474,6 +529,7 @@ declare class V1ApiNamespace {
     openai: V1OpenAIModule;
     embed: V1EmbedModule;
     desktopRuntimeSessions: V1DesktopRuntimeSessionsModule;
+    desktopBrowser: V1DesktopBrowserModule;
     constructor(baseUrl: string, apiKey: string, appId?: string);
 }
 
@@ -498,4 +554,4 @@ declare class ServerError extends DeveloperApiError {
     constructor(message?: string);
 }
 
-export { AuthenticationError as A, DeveloperApiClient as D, NotFoundError as N, ServerError as S, V1ApiNamespace as V, V1DesktopRuntimeSessionsModule as a, DeveloperApiError as b, ValidationError as c, V1AuthModule as d, V1AdminModule as e, V1DocumentModule as f, V1WorkspaceModule as g, V1SystemModule as h, V1ThreadModule as i, V1UsersModule as j, V1OpenAIModule as k, V1EmbedModule as l };
+export { AuthenticationError as A, DeveloperApiClient as D, NotFoundError as N, ServerError as S, V1ApiNamespace as V, V1DesktopRuntimeSessionsModule as a, V1DesktopBrowserModule as b, DeveloperApiError as c, ValidationError as d, V1AuthModule as e, V1AdminModule as f, V1DocumentModule as g, V1WorkspaceModule as h, V1SystemModule as i, V1ThreadModule as j, V1UsersModule as k, V1OpenAIModule as l, V1EmbedModule as m };

package/dist/{errors-x6ngbrlA.d.ts → errors-DsxB91BA.d.ts}

@@ -450,6 +450,61 @@ declare class V1DesktopRuntimeSessionsModule {
     permission(sessionId: string, body?: Record<string, unknown>): Promise<unknown>;
 }
 
+declare class V1DesktopBrowserModule {
+    private readonly client;
+    constructor(client: DeveloperApiClient);
+    /**
+     * List RealTimeX Browser sessions available in the Electron desktop app.
+     * @see GET /sdk/desktop/browser/sessions
+     */
+    listSessions(): Promise<unknown>;
+    /**
+     * Create a named RealTimeX Browser session in the Electron desktop app.
+     * @see POST /sdk/desktop/browser/sessions
+     */
+    createSession(body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Get a specific RealTimeX Browser session by session name.
+     * @see GET /sdk/desktop/browser/sessions/{sessionName}
+     */
+    getSession(sessionName: string): Promise<unknown>;
+    /**
+     * Delete a named RealTimeX Browser session from the Electron desktop app.
+     * @see DELETE /sdk/desktop/browser/sessions/{sessionName}
+     */
+    deleteSession(sessionName: string): Promise<unknown>;
+    /**
+     * Create a RealTimeX Browser tab, optionally launching the browser session if needed.
+     * @see POST /sdk/desktop/browser/tabs
+     */
+    createTab(body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Get a RealTimeX Browser tab snapshot by tab reference.
+     * @see GET /sdk/desktop/browser/tabs/{tabRef}
+     */
+    getTab(tabRef: string): Promise<unknown>;
+    /**
+     * Close an existing RealTimeX Browser tab.
+     * @see DELETE /sdk/desktop/browser/tabs/{tabRef}
+     */
+    deleteTab(tabRef: string): Promise<unknown>;
+    /**
+     * Evaluate JavaScript in a specific RealTimeX Browser tab.
+     * @see POST /sdk/desktop/browser/tabs/{tabRef}/evaluate
+     */
+    evaluateTab(tabRef: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Focus an existing RealTimeX Browser tab.
+     * @see POST /sdk/desktop/browser/tabs/{tabRef}/focus
+     */
+    focusTab(tabRef: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Navigate an existing RealTimeX Browser tab to a new URL.
+     * @see POST /sdk/desktop/browser/tabs/{tabRef}/navigate
+     */
+    navigateTab(tabRef: string, body?: Record<string, unknown>): Promise<unknown>;
+}
+
 /**
  * V1ApiNamespace - Container for all RealtimeX Developer API (v1) modules.
  *
@@ -474,6 +529,7 @@ declare class V1ApiNamespace {
     openai: V1OpenAIModule;
     embed: V1EmbedModule;
     desktopRuntimeSessions: V1DesktopRuntimeSessionsModule;
+    desktopBrowser: V1DesktopBrowserModule;
     constructor(baseUrl: string, apiKey: string, appId?: string);
 }
 
@@ -498,4 +554,4 @@ declare class ServerError extends DeveloperApiError {
     constructor(message?: string);
 }
 
-export { AuthenticationError as A, DeveloperApiClient as D, NotFoundError as N, ServerError as S, V1ApiNamespace as V, V1DesktopRuntimeSessionsModule as a, DeveloperApiError as b, ValidationError as c, V1AuthModule as d, V1AdminModule as e, V1DocumentModule as f, V1WorkspaceModule as g, V1SystemModule as h, V1ThreadModule as i, V1UsersModule as j, V1OpenAIModule as k, V1EmbedModule as l };
+export { AuthenticationError as A, DeveloperApiClient as D, NotFoundError as N, ServerError as S, V1ApiNamespace as V, V1DesktopRuntimeSessionsModule as a, V1DesktopBrowserModule as b, DeveloperApiError as c, ValidationError as d, V1AuthModule as e, V1AdminModule as f, V1DocumentModule as g, V1WorkspaceModule as h, V1SystemModule as i, V1ThreadModule as j, V1UsersModule as k, V1OpenAIModule as l, V1EmbedModule as m };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { V as V1ApiNamespace, a as V1DesktopRuntimeSessionsModule } from './errors-x6ngbrlA.mjs';
-export { A as AuthenticationError, D as DeveloperApiClient, b as DeveloperApiError, N as NotFoundError, S as ServerError, c as ValidationError } from './errors-x6ngbrlA.mjs';
+import { V as V1ApiNamespace, a as V1DesktopRuntimeSessionsModule, b as V1DesktopBrowserModule } from './errors-DsxB91BA.mjs';
+export { A as AuthenticationError, D as DeveloperApiClient, c as DeveloperApiError, N as NotFoundError, S as ServerError, d as ValidationError } from './errors-DsxB91BA.mjs';
 
 /**
  * RealtimeX Local App SDK - Types
@@ -2027,6 +2027,11 @@ declare class RealtimeXSDK {
      * Backed by `sdk.v1.desktopRuntimeSessions` for compatibility with generated v1 modules.
      */
     desktopRuntimeSessions: V1DesktopRuntimeSessionsModule | undefined;
+    /**
+     * Desktop browser control — top-level alias for the RealTimeX Browser session and tab APIs.
+     * Backed by `sdk.v1.desktopBrowser` for compatibility with generated v1 modules.
+     */
+    desktopBrowser: V1DesktopBrowserModule | undefined;
     readonly appId: string;
     readonly appName: string | undefined;
     readonly apiKey: string | undefined;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { V as V1ApiNamespace, a as V1DesktopRuntimeSessionsModule } from './errors-x6ngbrlA.js';
-export { A as AuthenticationError, D as DeveloperApiClient, b as DeveloperApiError, N as NotFoundError, S as ServerError, c as ValidationError } from './errors-x6ngbrlA.js';
+import { V as V1ApiNamespace, a as V1DesktopRuntimeSessionsModule, b as V1DesktopBrowserModule } from './errors-DsxB91BA.js';
+export { A as AuthenticationError, D as DeveloperApiClient, c as DeveloperApiError, N as NotFoundError, S as ServerError, d as ValidationError } from './errors-DsxB91BA.js';
 
 /**
  * RealtimeX Local App SDK - Types
@@ -2027,6 +2027,11 @@ declare class RealtimeXSDK {
      * Backed by `sdk.v1.desktopRuntimeSessions` for compatibility with generated v1 modules.
      */
     desktopRuntimeSessions: V1DesktopRuntimeSessionsModule | undefined;
+    /**
+     * Desktop browser control — top-level alias for the RealTimeX Browser session and tab APIs.
+     * Backed by `sdk.v1.desktopBrowser` for compatibility with generated v1 modules.
+     */
+    desktopBrowser: V1DesktopBrowserModule | undefined;
     readonly appId: string;
     readonly appName: string | undefined;
     readonly apiKey: string | undefined;

package/dist/index.js

@@ -3750,6 +3750,83 @@ var V1DesktopRuntimeSessionsModule = class {
   }
 };
 
+// src/v1/modules/v1DesktopBrowser.ts
+var V1DesktopBrowserModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List RealTimeX Browser sessions available in the Electron desktop app.
+   * @see GET /sdk/desktop/browser/sessions
+   */
+  async listSessions() {
+    return this.client.request("GET", `/sdk/desktop/browser/sessions`);
+  }
+  /**
+   * Create a named RealTimeX Browser session in the Electron desktop app.
+   * @see POST /sdk/desktop/browser/sessions
+   */
+  async createSession(body) {
+    return this.client.request("POST", `/sdk/desktop/browser/sessions`, body);
+  }
+  /**
+   * Get a specific RealTimeX Browser session by session name.
+   * @see GET /sdk/desktop/browser/sessions/{sessionName}
+   */
+  async getSession(sessionName) {
+    return this.client.request("GET", `/sdk/desktop/browser/sessions/${sessionName}`);
+  }
+  /**
+   * Delete a named RealTimeX Browser session from the Electron desktop app.
+   * @see DELETE /sdk/desktop/browser/sessions/{sessionName}
+   */
+  async deleteSession(sessionName) {
+    return this.client.request("DELETE", `/sdk/desktop/browser/sessions/${sessionName}`);
+  }
+  /**
+   * Create a RealTimeX Browser tab, optionally launching the browser session if needed.
+   * @see POST /sdk/desktop/browser/tabs
+   */
+  async createTab(body) {
+    return this.client.request("POST", `/sdk/desktop/browser/tabs`, body);
+  }
+  /**
+   * Get a RealTimeX Browser tab snapshot by tab reference.
+   * @see GET /sdk/desktop/browser/tabs/{tabRef}
+   */
+  async getTab(tabRef) {
+    return this.client.request("GET", `/sdk/desktop/browser/tabs/${tabRef}`);
+  }
+  /**
+   * Close an existing RealTimeX Browser tab.
+   * @see DELETE /sdk/desktop/browser/tabs/{tabRef}
+   */
+  async deleteTab(tabRef) {
+    return this.client.request("DELETE", `/sdk/desktop/browser/tabs/${tabRef}`);
+  }
+  /**
+   * Evaluate JavaScript in a specific RealTimeX Browser tab.
+   * @see POST /sdk/desktop/browser/tabs/{tabRef}/evaluate
+   */
+  async evaluateTab(tabRef, body) {
+    return this.client.request("POST", `/sdk/desktop/browser/tabs/${tabRef}/evaluate`, body);
+  }
+  /**
+   * Focus an existing RealTimeX Browser tab.
+   * @see POST /sdk/desktop/browser/tabs/{tabRef}/focus
+   */
+  async focusTab(tabRef, body) {
+    return this.client.request("POST", `/sdk/desktop/browser/tabs/${tabRef}/focus`, body);
+  }
+  /**
+   * Navigate an existing RealTimeX Browser tab to a new URL.
+   * @see POST /sdk/desktop/browser/tabs/{tabRef}/navigate
+   */
+  async navigateTab(tabRef, body) {
+    return this.client.request("POST", `/sdk/desktop/browser/tabs/${tabRef}/navigate`, body);
+  }
+};
+
 // src/v1/namespace.ts
 var V1ApiNamespace = class {
   // [GENERATED-PROPS-END]
@@ -3765,6 +3842,7 @@ var V1ApiNamespace = class {
     this.openai = new V1OpenAIModule(this._client);
     this.embed = new V1EmbedModule(this._client);
     this.desktopRuntimeSessions = new V1DesktopRuntimeSessionsModule(this._client);
+    this.desktopBrowser = new V1DesktopBrowserModule(this._client);
   }
 };
 
@@ -4468,6 +4546,7 @@ var _RealtimeXSDK = class _RealtimeXSDK {
     this.credentials = new CredentialsModule(this.httpClient);
     this.v1 = this.apiKey || this.appId ? new V1ApiNamespace(this.realtimexUrl, this.apiKey ?? "", this.appId || void 0) : void 0;
     this.desktopRuntimeSessions = this.v1?.desktopRuntimeSessions;
+    this.desktopBrowser = this.v1?.desktopBrowser;
     if (this.permissions.length > 0 && this.appId && !this.apiKey) {
       this.register().catch((err) => {
         console.error("[RealtimeX SDK] Auto-registration failed:", err.message);

package/dist/index.mjs

@@ -6,7 +6,7 @@ import {
   ServerError,
   V1ApiNamespace,
   ValidationError
-} from "./chunk-3DVGTGOK.mjs";
+} from "./chunk-PEWBG7US.mjs";
 
 // src/modules/api.ts
 var PermissionDeniedError = class extends Error {
@@ -3653,6 +3653,7 @@ var _RealtimeXSDK = class _RealtimeXSDK {
     this.credentials = new CredentialsModule(this.httpClient);
     this.v1 = this.apiKey || this.appId ? new V1ApiNamespace(this.realtimexUrl, this.apiKey ?? "", this.appId || void 0) : void 0;
     this.desktopRuntimeSessions = this.v1?.desktopRuntimeSessions;
+    this.desktopBrowser = this.v1?.desktopBrowser;
     if (this.permissions.length > 0 && this.appId && !this.apiKey) {
       this.register().catch((err) => {
         console.error("[RealtimeX SDK] Auto-registration failed:", err.message);

package/dist/v1/index.d.mts

@@ -1,5 +1,5 @@
-import { D as DeveloperApiClient } from '../errors-x6ngbrlA.mjs';
-export { A as AuthenticationError, b as DeveloperApiError, N as NotFoundError, S as ServerError, e as V1AdminModule, V as V1ApiNamespace, d as V1AuthModule, a as V1DesktopRuntimeSessionsModule, f as V1DocumentModule, l as V1EmbedModule, k as V1OpenAIModule, h as V1SystemModule, i as V1ThreadModule, j as V1UsersModule, g as V1WorkspaceModule, c as ValidationError } from '../errors-x6ngbrlA.mjs';
+import { D as DeveloperApiClient } from '../errors-DsxB91BA.mjs';
+export { A as AuthenticationError, c as DeveloperApiError, N as NotFoundError, S as ServerError, f as V1AdminModule, V as V1ApiNamespace, e as V1AuthModule, b as V1DesktopBrowserModule, a as V1DesktopRuntimeSessionsModule, g as V1DocumentModule, m as V1EmbedModule, l as V1OpenAIModule, i as V1SystemModule, j as V1ThreadModule, k as V1UsersModule, h as V1WorkspaceModule, d as ValidationError } from '../errors-DsxB91BA.mjs';
 
 interface WorkspaceStreamChunk {
     /** The text fragment emitted by this SSE event */

package/dist/v1/index.d.ts

@@ -1,5 +1,5 @@
-import { D as DeveloperApiClient } from '../errors-x6ngbrlA.js';
-export { A as AuthenticationError, b as DeveloperApiError, N as NotFoundError, S as ServerError, e as V1AdminModule, V as V1ApiNamespace, d as V1AuthModule, a as V1DesktopRuntimeSessionsModule, f as V1DocumentModule, l as V1EmbedModule, k as V1OpenAIModule, h as V1SystemModule, i as V1ThreadModule, j as V1UsersModule, g as V1WorkspaceModule, c as ValidationError } from '../errors-x6ngbrlA.js';
+import { D as DeveloperApiClient } from '../errors-DsxB91BA.js';
+export { A as AuthenticationError, c as DeveloperApiError, N as NotFoundError, S as ServerError, f as V1AdminModule, V as V1ApiNamespace, e as V1AuthModule, b as V1DesktopBrowserModule, a as V1DesktopRuntimeSessionsModule, g as V1DocumentModule, m as V1EmbedModule, l as V1OpenAIModule, i as V1SystemModule, j as V1ThreadModule, k as V1UsersModule, h as V1WorkspaceModule, d as ValidationError } from '../errors-DsxB91BA.js';
 
 interface WorkspaceStreamChunk {
     /** The text fragment emitted by this SSE event */

package/dist/v1/index.js

@@ -28,6 +28,7 @@ __export(v1_exports, {
   V1AdminModule: () => V1AdminModule,
   V1ApiNamespace: () => V1ApiNamespace,
   V1AuthModule: () => V1AuthModule,
+  V1DesktopBrowserModule: () => V1DesktopBrowserModule,
   V1DesktopRuntimeSessionsModule: () => V1DesktopRuntimeSessionsModule,
   V1DocumentModule: () => V1DocumentModule,
   V1EmbedModule: () => V1EmbedModule,
@@ -751,6 +752,83 @@ var V1DesktopRuntimeSessionsModule = class {
   }
 };
 
+// src/v1/modules/v1DesktopBrowser.ts
+var V1DesktopBrowserModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List RealTimeX Browser sessions available in the Electron desktop app.
+   * @see GET /sdk/desktop/browser/sessions
+   */
+  async listSessions() {
+    return this.client.request("GET", `/sdk/desktop/browser/sessions`);
+  }
+  /**
+   * Create a named RealTimeX Browser session in the Electron desktop app.
+   * @see POST /sdk/desktop/browser/sessions
+   */
+  async createSession(body) {
+    return this.client.request("POST", `/sdk/desktop/browser/sessions`, body);
+  }
+  /**
+   * Get a specific RealTimeX Browser session by session name.
+   * @see GET /sdk/desktop/browser/sessions/{sessionName}
+   */
+  async getSession(sessionName) {
+    return this.client.request("GET", `/sdk/desktop/browser/sessions/${sessionName}`);
+  }
+  /**
+   * Delete a named RealTimeX Browser session from the Electron desktop app.
+   * @see DELETE /sdk/desktop/browser/sessions/{sessionName}
+   */
+  async deleteSession(sessionName) {
+    return this.client.request("DELETE", `/sdk/desktop/browser/sessions/${sessionName}`);
+  }
+  /**
+   * Create a RealTimeX Browser tab, optionally launching the browser session if needed.
+   * @see POST /sdk/desktop/browser/tabs
+   */
+  async createTab(body) {
+    return this.client.request("POST", `/sdk/desktop/browser/tabs`, body);
+  }
+  /**
+   * Get a RealTimeX Browser tab snapshot by tab reference.
+   * @see GET /sdk/desktop/browser/tabs/{tabRef}
+   */
+  async getTab(tabRef) {
+    return this.client.request("GET", `/sdk/desktop/browser/tabs/${tabRef}`);
+  }
+  /**
+   * Close an existing RealTimeX Browser tab.
+   * @see DELETE /sdk/desktop/browser/tabs/{tabRef}
+   */
+  async deleteTab(tabRef) {
+    return this.client.request("DELETE", `/sdk/desktop/browser/tabs/${tabRef}`);
+  }
+  /**
+   * Evaluate JavaScript in a specific RealTimeX Browser tab.
+   * @see POST /sdk/desktop/browser/tabs/{tabRef}/evaluate
+   */
+  async evaluateTab(tabRef, body) {
+    return this.client.request("POST", `/sdk/desktop/browser/tabs/${tabRef}/evaluate`, body);
+  }
+  /**
+   * Focus an existing RealTimeX Browser tab.
+   * @see POST /sdk/desktop/browser/tabs/{tabRef}/focus
+   */
+  async focusTab(tabRef, body) {
+    return this.client.request("POST", `/sdk/desktop/browser/tabs/${tabRef}/focus`, body);
+  }
+  /**
+   * Navigate an existing RealTimeX Browser tab to a new URL.
+   * @see POST /sdk/desktop/browser/tabs/{tabRef}/navigate
+   */
+  async navigateTab(tabRef, body) {
+    return this.client.request("POST", `/sdk/desktop/browser/tabs/${tabRef}/navigate`, body);
+  }
+};
+
 // src/v1/namespace.ts
 var V1ApiNamespace = class {
   // [GENERATED-PROPS-END]
@@ -766,6 +844,7 @@ var V1ApiNamespace = class {
     this.openai = new V1OpenAIModule(this._client);
     this.embed = new V1EmbedModule(this._client);
     this.desktopRuntimeSessions = new V1DesktopRuntimeSessionsModule(this._client);
+    this.desktopBrowser = new V1DesktopBrowserModule(this._client);
   }
 };
 
@@ -892,6 +971,7 @@ async function uploadFileToFolder(client, file, folderName, options = {}) {
   V1AdminModule,
   V1ApiNamespace,
   V1AuthModule,
+  V1DesktopBrowserModule,
   V1DesktopRuntimeSessionsModule,
   V1DocumentModule,
   V1EmbedModule,

package/dist/v1/index.mjs

@@ -7,6 +7,7 @@ import {
   V1AdminModule,
   V1ApiNamespace,
   V1AuthModule,
+  V1DesktopBrowserModule,
   V1DesktopRuntimeSessionsModule,
   V1DocumentModule,
   V1EmbedModule,
@@ -16,7 +17,7 @@ import {
   V1UsersModule,
   V1WorkspaceModule,
   ValidationError
-} from "../chunk-3DVGTGOK.mjs";
+} from "../chunk-PEWBG7US.mjs";
 
 // src/v1/overrides/v1WorkspaceStreaming.ts
 async function* streamWorkspaceChat(client, slug, body) {
@@ -140,6 +141,7 @@ export {
   V1AdminModule,
   V1ApiNamespace,
   V1AuthModule,
+  V1DesktopBrowserModule,
   V1DesktopRuntimeSessionsModule,
   V1DocumentModule,
   V1EmbedModule,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "1.7.12",
+    "version": "1.7.14",
     "description": "SDK for building Local Apps that integrate with RealtimeX",
     "main": "dist/index.js",
     "module": "dist/index.mjs",

package/skills/realtimex-moderator-sdk/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: realtimex-moderator-sdk
 description: Control and interact with the RealTimeX application through its Node.js SDK. This skill should be used when users want to manage workspaces, threads, agents, activities, LLM chat, vector store, MCP tools, ACP agent sessions, TTS/STT, or any other RealTimeX platform feature via the API. All method signatures are verified against the SDK source code.
-generated: 2026-05-07
-sdk_version: 1.7.12
+generated: 2026-05-08
+sdk_version: 1.7.14
 ---
 
 # RealTimeX Moderator (SDK Source-Verified)
 
-Interact with the RealTimeX platform (`http://localhost:3001`) using `@realtimex/sdk` **v1.7.12**. Authentication is automatic when running inside RealtimeX.
+Interact with the RealTimeX platform (`http://localhost:3001`) using `@realtimex/sdk` **v1.7.14**. Authentication is automatic when running inside RealtimeX.
 
 `<SKILL_DIR>` below refers to the directory containing this SKILL.md.
 
@@ -29,6 +29,9 @@ node "$SKILL" terminal-launch-cli-agent claude claude-cli "what is current worki
 node "$SKILL" terminal-launch-shell --workspace=<slug> --thread=<slug> --command="pwd"  $ENV
 node "$SKILL" terminal-sessions --workspace=<slug>     $ENV
 node "$SKILL" terminal-write <session-id> "continue"   $ENV
+node "$SKILL" browser-sessions                         $ENV
+node "$SKILL" browser-session-create github-review     $ENV
+node "$SKILL" browser-tab-create https://example.com --session=github-review  $ENV
 node "$SKILL" acp-chat qwen-cli "question" --cwd=<path>  $ENV
 node "$SKILL" llm-chat "message"                       $ENV
 node "$SKILL" activities --status=pending              $ENV
@@ -169,6 +172,98 @@ If the user says:
 
 then prefer `sdk.desktopRuntimeSessions.*`, not ACP.
 
+If the user says:
+- "open this URL in RealTimeX Browser"
+- "create a browser session"
+- "navigate the managed browser tab"
+- "focus or close a RealTimeX Browser tab"
+
+then prefer `sdk.desktopBrowser.*`, not ACP and not desktop terminal sessions.
+
+---
+
+## Desktop Browser
+
+For anything that says **RealTimeX Browser**, **browser session**, **browser tab**, **open a URL in the managed browser**, or **navigate/focus/close a managed browser tab**, use:
+
+- `sdk.desktopBrowser.*`
+
+Do **not** use ACP for this unless the user explicitly wants ACP browser handoff behavior. Do **not** use `sdk.desktopRuntimeSessions.*` for browser tabs; that module is only for terminal sessions.
+
+### Use desktop browser for
+- listing named RealTimeX Browser sessions
+- creating a named browser session
+- getting or deleting a named browser session
+- creating a browser tab in a named session
+- reading a browser tab snapshot
+- evaluating JavaScript in a browser tab
+- focusing a browser tab
+- navigating a browser tab
+- closing a browser tab
+
+### Correct SDK namespace
+
+```js
+sdk.desktopBrowser
+```
+
+Compatibility:
+- `sdk.desktopBrowser` is the preferred alias
+- `sdk.v1.desktopBrowser` still exists for backward compatibility
+
+### Correct examples
+
+List browser sessions:
+
+```js
+await sdk.desktopBrowser.listSessions();
+```
+
+Create a named browser session:
+
+```js
+await sdk.desktopBrowser.createSession({
+  sessionName: "github-review"
+});
+```
+
+Create a browser tab:
+
+```js
+await sdk.desktopBrowser.createTab({
+  sessionName: "github-review",
+  url: "https://example.com"
+});
+```
+
+Navigate a browser tab:
+
+```js
+await sdk.desktopBrowser.navigateTab("cli-browser:9555:tab:3", {
+  url: "https://docs.realtimex.ai",
+  focus: true,
+  focusWindow: true
+});
+```
+
+Evaluate JavaScript in a browser tab:
+
+```js
+await sdk.desktopBrowser.evaluateTab("cli-browser:9555:tab:3", {
+  expression: "document.title",
+  userGesture: true
+});
+```
+
+### Naming rule
+
+Prefer normal named sessions like:
+- `github-review`
+- `docs-research`
+- `qa-checkout`
+
+Avoid mutating reserved/system-managed sessions like `acp-*` unless the user explicitly asks to work with internal ACP browser flows.
+
 ---
 
 ## ACP Session Management
@@ -353,6 +448,52 @@ It covers:
 - **Agent Skills** — types (`repo`/`zip`), scopes, status values
 - **Data Models** — all database models with fields and defaults
 
+### Heartbeat Task Blocks
+
+When working with `HEARTBEAT.md`, check whether it uses a top-level `tasks:` block.
+
+Example:
+
+```yaml
+tasks:
+  - name: audit-fetch
+    interval: 4h
+    prompt: Fetch origin/realtimex-dev and diff against tmp/frontend-audit-cursor.txt.
+
+  - name: audit-ui-design
+    interval: 4h
+    prompt: Review changed frontend files for UI design violations. If none, reply HEARTBEAT_OK.
+```
+
+Rules:
+- A top-level `tasks:` list means the heartbeat is split into separate scheduled tasks, not one monolithic prompt.
+- Each `- name:` item is its own task definition.
+- `name` is the stable task id. Keep it concise and stable when editing.
+- `interval` is the cadence for that specific task.
+- `prompt` is the full instruction body for that task.
+- `HEARTBEAT_OK` means the task ran successfully but had nothing actionable to do.
+- Preserve task order unless the user explicitly wants a reordering.
+- If one task refers to another task's output, that dependency is described in the prompt text. Do not invent hidden YAML dependency fields.
+
+When editing heartbeat files:
+- If the file already uses `tasks:`, add or edit individual task items instead of collapsing them into one large prompt.
+- If the file is a single long heartbeat prompt and the user wants separate scheduled jobs, rewrite it into a `tasks:` list with one item per independent workflow.
+- When splitting a single heartbeat into tasks, preserve the original intent, move each discrete workflow into its own `prompt`, and keep shared context text only where needed.
+- Keep YAML formatting simple: top-level `tasks:`, then `- name`, `interval`, `prompt`.
+
+When a user asks how to convert a heartbeat into task-block form, produce or edit it into this shape:
+
+```yaml
+tasks:
+  - name: task-one
+    interval: 4h
+    prompt: First workflow instructions.
+
+  - name: task-two
+    interval: 12h
+    prompt: Second workflow instructions.
+```
+
 ---
 
 ## References

package/skills/realtimex-moderator-sdk/references/api-reference.md

@@ -1,6 +1,6 @@
 # RealTimeX SDK — API Reference
 
-> Auto-generated from `@realtimex/sdk` source · v**1.7.12** · 2026-05-07
+> Auto-generated from `@realtimex/sdk` source · v**1.7.14** · 2026-05-08
 
 **Package:** `@realtimex/sdk` (CJS) · **Server:** `http://localhost:3001`
 **Developer Mode auth:** `Authorization: Bearer <apiKey>`
@@ -27,6 +27,8 @@
 | `mcp.servers` | `sdk.mcp.getServers()` |
 | `mcp.tools` | `sdk.mcp.getTools/executeTool()` |
 | `acp.agent` | `sdk.acpAgent.*` |
+| `desktop.runtime-sessions` | `sdk.desktopRuntimeSessions.*` |
+| `desktop.browser` | `sdk.desktopBrowser.*` |
 
 ---
 
@@ -105,6 +107,62 @@ Compatibility: `sdk.v1.desktopRuntimeSessions` remains available, but prefer the
 
 ---
 
+## sdk.desktopBrowser — RealTimeX Browser
+
+Use this module for the managed RealTimeX Browser control plane. This is the correct path for:
+- listing named browser sessions
+- creating a named browser session
+- opening a URL in a managed browser tab
+- reading/evaluating/focusing/navigating/closing managed browser tabs
+
+Do not use ACP for these unless the user explicitly asks for ACP browser handoff behavior.
+Do not use desktop terminal sessions for browser tabs.
+
+### `V1DesktopBrowserModule`
+
+```ts
+async listSessions(): Promise<unknown>
+async createSession(body: { sessionName: string; remoteDebugPort?: number; }): Promise<unknown>
+async getSession(sessionName: string): Promise<unknown>
+async deleteSession(sessionName: string): Promise<unknown>
+async createTab(body: { sessionName?: string; url: string; focus?: boolean; focusWindow?: boolean; }): Promise<unknown>
+async getTab(tabRef: string): Promise<unknown>
+async evaluateTab(tabRef: string, body: { expression: string; userGesture?: boolean; }): Promise<unknown>
+async focusTab(tabRef: string, body?: { focusWindow?: boolean; }): Promise<unknown>
+async navigateTab(tabRef: string, body: { url: string; focus?: boolean; focusWindow?: boolean; }): Promise<unknown>
+async deleteTab(tabRef: string): Promise<unknown>
+```
+
+### Correct examples
+
+```js
+await sdk.desktopBrowser.createSession({
+  sessionName: 'github-review'
+});
+
+await sdk.desktopBrowser.createTab({
+  sessionName: 'github-review',
+  url: 'https://example.com'
+});
+
+await sdk.desktopBrowser.navigateTab('cli-browser:9555:tab:3', {
+  url: 'https://docs.realtimex.ai',
+  focus: true,
+  focusWindow: true
+});
+
+await sdk.desktopBrowser.evaluateTab('cli-browser:9555:tab:3', {
+  expression: 'document.title',
+  userGesture: true
+});
+```
+
+Prefer normal named sessions like `github-review` or `docs-research`.
+Avoid mutating reserved/system-managed sessions like `acp-*` unless the user explicitly asks for internal ACP browser flows.
+Compatibility: `sdk.v1.desktopBrowser` remains available, but prefer the top-level alias.
+
+---
+
 ## Core — RealtimeXSDK
 
 ### `RealtimeXSDK`
@@ -128,6 +186,7 @@ Compatibility: `sdk.v1.desktopRuntimeSessions` remains available, but prefer the
 - `credentials: CredentialsModule`
 - `v1: V1ApiNamespace | undefined`
 - `desktopRuntimeSessions: V1DesktopRuntimeSessionsModule | undefined`
+- `desktopBrowser: V1DesktopBrowserModule | undefined`
 
 ```ts
 // Developer API (v1) — requires apiKey to be set in config.
@@ -887,6 +946,44 @@ async createCustomTheme(): Promise<unknown>
 
 ---
 
+## sdk.v1.desktopBrowser — v1 Desktop Browser
+
+### `V1DesktopBrowserModule`
+
+```ts
+// List RealTimeX Browser sessions available in the Electron desktop app.
+async listSessions(): Promise<unknown>
+
+// Create a named RealTimeX Browser session in the Electron desktop app.
+async createSession(body?: Record<string, unknown>): Promise<unknown>
+
+// Get a specific RealTimeX Browser session by session name.
+async getSession(sessionName: string): Promise<unknown>
+
+// Delete a named RealTimeX Browser session from the Electron desktop app.
+async deleteSession(sessionName: string): Promise<unknown>
+
+// Create a RealTimeX Browser tab, optionally launching the browser session if needed.
+async createTab(body?: Record<string, unknown>): Promise<unknown>
+
+// Get a RealTimeX Browser tab snapshot by tab reference.
+async getTab(tabRef: string): Promise<unknown>
+
+// Close an existing RealTimeX Browser tab.
+async deleteTab(tabRef: string): Promise<unknown>
+
+// Evaluate JavaScript in a specific RealTimeX Browser tab.
+async evaluateTab(tabRef: string, body?: Record<string, unknown>): Promise<unknown>
+
+// Focus an existing RealTimeX Browser tab.
+async focusTab(tabRef: string, body?: Record<string, unknown>): Promise<unknown>
+
+// Navigate an existing RealTimeX Browser tab to a new URL.
+async navigateTab(tabRef: string, body?: Record<string, unknown>): Promise<unknown>
+```
+
+---
+
 ## sdk.v1.desktopEmbed — v1 Desktop Embed
 
 ### `V1DesktopEmbedModule`

package/skills/realtimex-moderator-sdk/references/known-issues.md

@@ -1,6 +1,6 @@
 # Known Issues — Source-Detected
 
-> Auto-generated by `scripts/generate-skill.mjs` · SDK **1.7.12** · 2026-05-07
+> Auto-generated by `scripts/generate-skill.mjs` · SDK **1.7.14** · 2026-05-08
 
 Run `node scripts/generate-skill.mjs --force` after SDK source changes to refresh.
 

package/skills/realtimex-moderator-sdk/scripts/lib/sdk-init.js

@@ -24,6 +24,7 @@ const ALL_PERMISSIONS = [
   'vectors.read', 'vectors.write',
   'tts.generate', 'mcp.servers', 'mcp.tools', 'acp.agent',
   'desktop.runtime-sessions',
+  'desktop.browser',
 ];
 
 /** Well-known file written by RealtimeX server for seamless auth. */

package/skills/realtimex-moderator-sdk/scripts/rtx.js

@@ -344,6 +344,14 @@ function getDesktopRuntimeSessionsModule(sdk) {
   return module;
 }
 
+function getDesktopBrowserModule(sdk) {
+  const module = sdk?.desktopBrowser || sdk?.v1?.desktopBrowser;
+  if (!module) {
+    throw new Error('sdk.desktopBrowser is unavailable. Ensure the SDK was initialized with Developer API access.');
+  }
+  return module;
+}
+
 // -- terminal-launcher / terminal sessions ----------------------------------
 CMD['terminal-open-launcher'] = async () => {
   const { sdk, context } = await getSDK();
@@ -450,6 +458,131 @@ CMD['terminal-close'] = async () => {
   print(await terminal.deleteRuntimeSession(sessionId));
 };
 
+CMD['browser-sessions'] = async () => {
+  const { sdk } = await getSDK();
+  const browser = getDesktopBrowserModule(sdk);
+  print(await browser.listSessions());
+};
+
+CMD['browser-session-create'] = async () => {
+  const [sessionName] = cmdArgs;
+  if (!sessionName) {
+    console.error('Usage: rtx.js browser-session-create <session-name> [--port=<n>]');
+    process.exit(1);
+  }
+  const { sdk } = await getSDK();
+  const browser = getDesktopBrowserModule(sdk);
+  const body = {
+    sessionName,
+    ...(flags.port ? { remoteDebugPort: Number(flags.port) } : {}),
+  };
+  print(await browser.createSession(body));
+};
+
+CMD['browser-session-get'] = async () => {
+  const [sessionName] = cmdArgs;
+  if (!sessionName) {
+    console.error('Usage: rtx.js browser-session-get <session-name>');
+    process.exit(1);
+  }
+  const { sdk } = await getSDK();
+  const browser = getDesktopBrowserModule(sdk);
+  print(await browser.getSession(sessionName));
+};
+
+CMD['browser-session-delete'] = async () => {
+  const [sessionName] = cmdArgs;
+  if (!sessionName) {
+    console.error('Usage: rtx.js browser-session-delete <session-name>');
+    process.exit(1);
+  }
+  const { sdk } = await getSDK();
+  const browser = getDesktopBrowserModule(sdk);
+  print(await browser.deleteSession(sessionName));
+};
+
+CMD['browser-tab-create'] = async () => {
+  const [url] = cmdArgs;
+  if (!url) {
+    console.error('Usage: rtx.js browser-tab-create <url> [--session=<name>] [--focus=true|false] [--focus-window=true|false]');
+    process.exit(1);
+  }
+  const { sdk } = await getSDK();
+  const browser = getDesktopBrowserModule(sdk);
+  const body = {
+    url,
+    ...(flags.session ? { sessionName: flags.session } : {}),
+    ...(flags.focus !== undefined ? { focus: flags.focus !== 'false' } : {}),
+    ...(flags['focus-window'] !== undefined ? { focusWindow: flags['focus-window'] !== 'false' } : {}),
+  };
+  print(await browser.createTab(body));
+};
+
+CMD['browser-tab-get'] = async () => {
+  const [tabRef] = cmdArgs;
+  if (!tabRef) {
+    console.error('Usage: rtx.js browser-tab-get <tab-ref>');
+    process.exit(1);
+  }
+  const { sdk } = await getSDK();
+  const browser = getDesktopBrowserModule(sdk);
+  print(await browser.getTab(tabRef));
+};
+
+CMD['browser-tab-focus'] = async () => {
+  const [tabRef] = cmdArgs;
+  if (!tabRef) {
+    console.error('Usage: rtx.js browser-tab-focus <tab-ref> [--focus-window=true|false]');
+    process.exit(1);
+  }
+  const { sdk } = await getSDK();
+  const browser = getDesktopBrowserModule(sdk);
+  const body = flags['focus-window'] !== undefined ? { focusWindow: flags['focus-window'] !== 'false' } : {};
+  print(await browser.focusTab(tabRef, body));
+};
+
+CMD['browser-tab-navigate'] = async () => {
+  const [tabRef, url] = cmdArgs;
+  if (!tabRef || !url) {
+    console.error('Usage: rtx.js browser-tab-navigate <tab-ref> <url> [--focus=true|false] [--focus-window=true|false]');
+    process.exit(1);
+  }
+  const { sdk } = await getSDK();
+  const browser = getDesktopBrowserModule(sdk);
+  const body = {
+    url,
+    ...(flags.focus !== undefined ? { focus: flags.focus !== 'false' } : {}),
+    ...(flags['focus-window'] !== undefined ? { focusWindow: flags['focus-window'] !== 'false' } : {}),
+  };
+  print(await browser.navigateTab(tabRef, body));
+};
+
+CMD['browser-tab-evaluate'] = async () => {
+  const [tabRef, ...expressionParts] = cmdArgs;
+  if (!tabRef || expressionParts.length === 0) {
+    console.error('Usage: rtx.js browser-tab-evaluate <tab-ref> <expression> [--user-gesture=true|false]');
+    process.exit(1);
+  }
+  const { sdk } = await getSDK();
+  const browser = getDesktopBrowserModule(sdk);
+  const body = {
+    expression: expressionParts.join(' '),
+    ...(flags['user-gesture'] !== undefined ? { userGesture: flags['user-gesture'] !== 'false' } : {}),
+  };
+  print(await browser.evaluateTab(tabRef, body));
+};
+
+CMD['browser-tab-close'] = async () => {
+  const [tabRef] = cmdArgs;
+  if (!tabRef) {
+    console.error('Usage: rtx.js browser-tab-close <tab-ref>');
+    process.exit(1);
+  }
+  const { sdk } = await getSDK();
+  const browser = getDesktopBrowserModule(sdk);
+  print(await browser.deleteTab(tabRef));
+};
+
 // -- acp-agents -------------------------------------------------------------
 // Source: AcpAgentModule.listAgents({ includeModels? })
 // Returns: AcpAgentInfo[] { id, label, handles[], installed, authReady, status }
@@ -982,6 +1115,40 @@ sdk.desktopRuntimeSessions.* — Desktop terminal sessions:
   Compatibility:
     The SDK also exposes this module as sdk.v1.desktopRuntimeSessions.
 
+sdk.desktopBrowser.* — RealTimeX Browser sessions and tabs:
+  browser-sessions
+    List named RealTimeX Browser sessions.
+
+  browser-session-create <session-name> [--port=<n>]
+    Create a named browser session.
+
+  browser-session-get <session-name>
+    Fetch one named browser session.
+
+  browser-session-delete <session-name>
+    Delete a named browser session.
+
+  browser-tab-create <url> [--session=<name>] [--focus=true|false] [--focus-window=true|false]
+    Create a managed browser tab.
+
+  browser-tab-get <tab-ref>
+    Fetch one browser tab snapshot by tab ref.
+
+  browser-tab-focus <tab-ref> [--focus-window=true|false]
+    Focus a managed browser tab.
+
+  browser-tab-navigate <tab-ref> <url> [--focus=true|false] [--focus-window=true|false]
+    Navigate a managed browser tab.
+
+  browser-tab-evaluate <tab-ref> <expression> [--user-gesture=true|false]
+    Evaluate JavaScript in a managed browser tab.
+
+  browser-tab-close <tab-ref>
+    Close a managed browser tab.
+
+  Compatibility:
+    The SDK also exposes this module as sdk.v1.desktopBrowser.
+
 sdk.acpAgent.* — Session Management:
   acp-agents [--models=true]
     List available ACP CLI agents.