@realtimex/sdk 1.7.6 → 1.7.8

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

@@ -642,73 +642,66 @@ var V1EmbedModule = class {
   }
 };
 
-// src/v1/modules/v1RuntimeSessions.ts
-var V1RuntimeSessionsModule = class {
+// src/v1/modules/v1DesktopRuntimeSessions.ts
+var V1DesktopRuntimeSessionsModule = class {
   constructor(client) {
     this.client = client;
   }
   /**
-   * Resolve the desktop shell launch working directory for a workspace or thread context.
-   * @see POST /runtime-sessions/desktop-shell/launch-spec
+   * Open the shared terminal launcher in the Electron desktop app.
+   * @see POST /sdk/desktop/runtime-sessions/open-launcher
    */
-  async desktopShellLaunchSpec(body) {
-    return this.client.request("POST", `/runtime-sessions/desktop-shell/launch-spec`, body);
+  async openLauncher(body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/open-launcher`, body);
   }
   /**
-   * Evaluate the runtime terminal permission policy for a pending CLI action.
-   * @see POST /runtime-sessions/terminal-permissions/evaluate
+   * Launch a local PTY-backed shell terminal in the Electron desktop app.
+   * @see POST /sdk/desktop/runtime-sessions/launch-terminal-shell
    */
-  async terminalPermissionsEvaluate(body) {
-    return this.client.request("POST", `/runtime-sessions/terminal-permissions/evaluate`, body);
+  async launchTerminalShell(body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/launch-terminal-shell`, body);
   }
   /**
-   * Resolve the CLI agent terminal launch command and working directory.
-   * @see POST /runtime-sessions/cli-agent/launch-spec
+   * Launch a local PTY-backed CLI agent terminal in the Electron desktop app.
+   * @see POST /sdk/desktop/runtime-sessions/launch-terminal-cli-agent
    */
-  async cliAgentLaunchSpec(body) {
-    return this.client.request("POST", `/runtime-sessions/cli-agent/launch-spec`, body);
+  async launchTerminalCliAgent(body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/launch-terminal-cli-agent`, body);
   }
   /**
-   * Create a persistent ACP-backed CLI agent runtime session.
-   * @see POST /runtime-sessions/cli-agent
+   * List desktop PTY-backed runtime sessions currently known to the Electron app.
+   * @see GET /sdk/desktop/runtime-sessions
    */
-  async cliAgent(body) {
-    return this.client.request("POST", `/runtime-sessions/cli-agent`, body);
+  async listRuntimeSessions() {
+    return this.client.request("GET", `/sdk/desktop/runtime-sessions`);
   }
   /**
-   * Stream a chat turn to an existing CLI agent runtime session using Server-Sent Events.
-   * @see POST /runtime-sessions/cli-agent/{sessionKey}/chat/stream
+   * Fetch one desktop PTY-backed runtime session by runtime session ID or PTY session ID.
+   * @see GET /sdk/desktop/runtime-sessions/{sessionId}
    */
-  async cliAgentChatStream(sessionKey, body) {
-    return this.client.request("POST", `/runtime-sessions/cli-agent/${sessionKey}/chat/stream`, body);
+  async getRuntimeSession(sessionId) {
+    return this.client.request("GET", `/sdk/desktop/runtime-sessions/${sessionId}`);
   }
   /**
-   * Resolve a pending permission request for a CLI agent runtime session.
-   * @see POST /runtime-sessions/cli-agent/{sessionKey}/permission
+   * Close an existing desktop runtime session.
+   * @see DELETE /sdk/desktop/runtime-sessions/{sessionId}
    */
-  async cliAgentPermission(sessionKey, body) {
-    return this.client.request("POST", `/runtime-sessions/cli-agent/${sessionKey}/permission`, body);
+  async deleteRuntimeSession(sessionId) {
+    return this.client.request("DELETE", `/sdk/desktop/runtime-sessions/${sessionId}`);
   }
   /**
-   * Cancel the current CLI turn for an active runtime session.
-   * @see POST /runtime-sessions/cli-agent/{sessionKey}/cancel
+   * Write input to an existing desktop runtime session. Use `message` to submit a CLI turn or `input` for raw PTY data.
+   * @see POST /sdk/desktop/runtime-sessions/{sessionId}/write
    */
-  async cliAgentCancel(sessionKey, body) {
-    return this.client.request("POST", `/runtime-sessions/cli-agent/${sessionKey}/cancel`, body);
+  async write(sessionId, body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/${sessionId}/write`, body);
   }
   /**
-   * Close a CLI agent runtime session and clear its control-plane metadata.
-   * @see DELETE /runtime-sessions/cli-agent/{sessionKey}
+   * Approve or deny a pending desktop runtime session action.
+   * @see POST /sdk/desktop/runtime-sessions/{sessionId}/permission
    */
-  async deleteCliAgent(sessionKey) {
-    return this.client.request("DELETE", `/runtime-sessions/cli-agent/${sessionKey}`);
-  }
-  /**
-   * Fetch the current state and runtime options for a CLI agent session.
-   * @see GET /runtime-sessions/cli-agent/{sessionKey}
-   */
-  async getCliAgent(sessionKey) {
-    return this.client.request("GET", `/runtime-sessions/cli-agent/${sessionKey}`);
+  async permission(sessionId, body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/${sessionId}/permission`, body);
   }
 };
 
@@ -726,7 +719,7 @@ var V1ApiNamespace = class {
     this.users = new V1UsersModule(this._client);
     this.openai = new V1OpenAIModule(this._client);
     this.embed = new V1EmbedModule(this._client);
-    this.runtimeSessions = new V1RuntimeSessionsModule(this._client);
+    this.desktopRuntimeSessions = new V1DesktopRuntimeSessionsModule(this._client);
   }
 };
 
@@ -746,6 +739,6 @@ export {
   V1UsersModule,
   V1OpenAIModule,
   V1EmbedModule,
-  V1RuntimeSessionsModule,
+  V1DesktopRuntimeSessionsModule,
   V1ApiNamespace
 };

package/dist/{errors-7Y9damGS.d.mts → errors-BmVxnpJS.d.mts}

@@ -405,54 +405,49 @@ declare class V1EmbedModule {
     deleteEmbed(embedUuid: string): Promise<unknown>;
 }
 
-declare class V1RuntimeSessionsModule {
+declare class V1DesktopRuntimeSessionsModule {
     private readonly client;
     constructor(client: DeveloperApiClient);
     /**
-     * Resolve the desktop shell launch working directory for a workspace or thread context.
-     * @see POST /runtime-sessions/desktop-shell/launch-spec
+     * Open the shared terminal launcher in the Electron desktop app.
+     * @see POST /sdk/desktop/runtime-sessions/open-launcher
      */
-    desktopShellLaunchSpec(body?: Record<string, unknown>): Promise<unknown>;
+    openLauncher(body?: Record<string, unknown>): Promise<unknown>;
     /**
-     * Evaluate the runtime terminal permission policy for a pending CLI action.
-     * @see POST /runtime-sessions/terminal-permissions/evaluate
+     * Launch a local PTY-backed shell terminal in the Electron desktop app.
+     * @see POST /sdk/desktop/runtime-sessions/launch-terminal-shell
      */
-    terminalPermissionsEvaluate(body?: Record<string, unknown>): Promise<unknown>;
+    launchTerminalShell(body?: Record<string, unknown>): Promise<unknown>;
     /**
-     * Resolve the CLI agent terminal launch command and working directory.
-     * @see POST /runtime-sessions/cli-agent/launch-spec
+     * Launch a local PTY-backed CLI agent terminal in the Electron desktop app.
+     * @see POST /sdk/desktop/runtime-sessions/launch-terminal-cli-agent
      */
-    cliAgentLaunchSpec(body?: Record<string, unknown>): Promise<unknown>;
+    launchTerminalCliAgent(body?: Record<string, unknown>): Promise<unknown>;
     /**
-     * Create a persistent ACP-backed CLI agent runtime session.
-     * @see POST /runtime-sessions/cli-agent
+     * List desktop PTY-backed runtime sessions currently known to the Electron app.
+     * @see GET /sdk/desktop/runtime-sessions
      */
-    cliAgent(body?: Record<string, unknown>): Promise<unknown>;
+    listRuntimeSessions(): Promise<unknown>;
     /**
-     * Stream a chat turn to an existing CLI agent runtime session using Server-Sent Events.
-     * @see POST /runtime-sessions/cli-agent/{sessionKey}/chat/stream
+     * Fetch one desktop PTY-backed runtime session by runtime session ID or PTY session ID.
+     * @see GET /sdk/desktop/runtime-sessions/{sessionId}
      */
-    cliAgentChatStream(sessionKey: string, body?: Record<string, unknown>): Promise<unknown>;
+    getRuntimeSession(sessionId: string): Promise<unknown>;
     /**
-     * Resolve a pending permission request for a CLI agent runtime session.
-     * @see POST /runtime-sessions/cli-agent/{sessionKey}/permission
+     * Close an existing desktop runtime session.
+     * @see DELETE /sdk/desktop/runtime-sessions/{sessionId}
      */
-    cliAgentPermission(sessionKey: string, body?: Record<string, unknown>): Promise<unknown>;
+    deleteRuntimeSession(sessionId: string): Promise<unknown>;
     /**
-     * Cancel the current CLI turn for an active runtime session.
-     * @see POST /runtime-sessions/cli-agent/{sessionKey}/cancel
+     * Write input to an existing desktop runtime session. Use `message` to submit a CLI turn or `input` for raw PTY data.
+     * @see POST /sdk/desktop/runtime-sessions/{sessionId}/write
      */
-    cliAgentCancel(sessionKey: string, body?: Record<string, unknown>): Promise<unknown>;
+    write(sessionId: string, body?: Record<string, unknown>): Promise<unknown>;
     /**
-     * Close a CLI agent runtime session and clear its control-plane metadata.
-     * @see DELETE /runtime-sessions/cli-agent/{sessionKey}
+     * Approve or deny a pending desktop runtime session action.
+     * @see POST /sdk/desktop/runtime-sessions/{sessionId}/permission
      */
-    deleteCliAgent(sessionKey: string): Promise<unknown>;
-    /**
-     * Fetch the current state and runtime options for a CLI agent session.
-     * @see GET /runtime-sessions/cli-agent/{sessionKey}
-     */
-    getCliAgent(sessionKey: string): Promise<unknown>;
+    permission(sessionId: string, body?: Record<string, unknown>): Promise<unknown>;
 }
 
 /**
@@ -478,7 +473,7 @@ declare class V1ApiNamespace {
     users: V1UsersModule;
     openai: V1OpenAIModule;
     embed: V1EmbedModule;
-    runtimeSessions: V1RuntimeSessionsModule;
+    desktopRuntimeSessions: V1DesktopRuntimeSessionsModule;
     constructor(baseUrl: string, apiKey: string, appId?: string);
 }
 
@@ -503,4 +498,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, DeveloperApiError as a, ValidationError as b, V1AuthModule as c, V1AdminModule as d, V1DocumentModule as e, V1WorkspaceModule as f, V1SystemModule as g, V1ThreadModule as h, V1UsersModule as i, V1OpenAIModule as j, V1EmbedModule as k, V1RuntimeSessionsModule as l };
+export { AuthenticationError as A, DeveloperApiClient as D, NotFoundError as N, ServerError as S, V1ApiNamespace as V, DeveloperApiError as a, ValidationError as b, V1AuthModule as c, V1AdminModule as d, V1DocumentModule as e, V1WorkspaceModule as f, V1SystemModule as g, V1ThreadModule as h, V1UsersModule as i, V1OpenAIModule as j, V1EmbedModule as k, V1DesktopRuntimeSessionsModule as l };

package/dist/{errors-7Y9damGS.d.ts → errors-BmVxnpJS.d.ts}

@@ -405,54 +405,49 @@ declare class V1EmbedModule {
     deleteEmbed(embedUuid: string): Promise<unknown>;
 }
 
-declare class V1RuntimeSessionsModule {
+declare class V1DesktopRuntimeSessionsModule {
     private readonly client;
     constructor(client: DeveloperApiClient);
     /**
-     * Resolve the desktop shell launch working directory for a workspace or thread context.
-     * @see POST /runtime-sessions/desktop-shell/launch-spec
+     * Open the shared terminal launcher in the Electron desktop app.
+     * @see POST /sdk/desktop/runtime-sessions/open-launcher
      */
-    desktopShellLaunchSpec(body?: Record<string, unknown>): Promise<unknown>;
+    openLauncher(body?: Record<string, unknown>): Promise<unknown>;
     /**
-     * Evaluate the runtime terminal permission policy for a pending CLI action.
-     * @see POST /runtime-sessions/terminal-permissions/evaluate
+     * Launch a local PTY-backed shell terminal in the Electron desktop app.
+     * @see POST /sdk/desktop/runtime-sessions/launch-terminal-shell
      */
-    terminalPermissionsEvaluate(body?: Record<string, unknown>): Promise<unknown>;
+    launchTerminalShell(body?: Record<string, unknown>): Promise<unknown>;
     /**
-     * Resolve the CLI agent terminal launch command and working directory.
-     * @see POST /runtime-sessions/cli-agent/launch-spec
+     * Launch a local PTY-backed CLI agent terminal in the Electron desktop app.
+     * @see POST /sdk/desktop/runtime-sessions/launch-terminal-cli-agent
      */
-    cliAgentLaunchSpec(body?: Record<string, unknown>): Promise<unknown>;
+    launchTerminalCliAgent(body?: Record<string, unknown>): Promise<unknown>;
     /**
-     * Create a persistent ACP-backed CLI agent runtime session.
-     * @see POST /runtime-sessions/cli-agent
+     * List desktop PTY-backed runtime sessions currently known to the Electron app.
+     * @see GET /sdk/desktop/runtime-sessions
      */
-    cliAgent(body?: Record<string, unknown>): Promise<unknown>;
+    listRuntimeSessions(): Promise<unknown>;
     /**
-     * Stream a chat turn to an existing CLI agent runtime session using Server-Sent Events.
-     * @see POST /runtime-sessions/cli-agent/{sessionKey}/chat/stream
+     * Fetch one desktop PTY-backed runtime session by runtime session ID or PTY session ID.
+     * @see GET /sdk/desktop/runtime-sessions/{sessionId}
      */
-    cliAgentChatStream(sessionKey: string, body?: Record<string, unknown>): Promise<unknown>;
+    getRuntimeSession(sessionId: string): Promise<unknown>;
     /**
-     * Resolve a pending permission request for a CLI agent runtime session.
-     * @see POST /runtime-sessions/cli-agent/{sessionKey}/permission
+     * Close an existing desktop runtime session.
+     * @see DELETE /sdk/desktop/runtime-sessions/{sessionId}
      */
-    cliAgentPermission(sessionKey: string, body?: Record<string, unknown>): Promise<unknown>;
+    deleteRuntimeSession(sessionId: string): Promise<unknown>;
     /**
-     * Cancel the current CLI turn for an active runtime session.
-     * @see POST /runtime-sessions/cli-agent/{sessionKey}/cancel
+     * Write input to an existing desktop runtime session. Use `message` to submit a CLI turn or `input` for raw PTY data.
+     * @see POST /sdk/desktop/runtime-sessions/{sessionId}/write
      */
-    cliAgentCancel(sessionKey: string, body?: Record<string, unknown>): Promise<unknown>;
+    write(sessionId: string, body?: Record<string, unknown>): Promise<unknown>;
     /**
-     * Close a CLI agent runtime session and clear its control-plane metadata.
-     * @see DELETE /runtime-sessions/cli-agent/{sessionKey}
+     * Approve or deny a pending desktop runtime session action.
+     * @see POST /sdk/desktop/runtime-sessions/{sessionId}/permission
      */
-    deleteCliAgent(sessionKey: string): Promise<unknown>;
-    /**
-     * Fetch the current state and runtime options for a CLI agent session.
-     * @see GET /runtime-sessions/cli-agent/{sessionKey}
-     */
-    getCliAgent(sessionKey: string): Promise<unknown>;
+    permission(sessionId: string, body?: Record<string, unknown>): Promise<unknown>;
 }
 
 /**
@@ -478,7 +473,7 @@ declare class V1ApiNamespace {
     users: V1UsersModule;
     openai: V1OpenAIModule;
     embed: V1EmbedModule;
-    runtimeSessions: V1RuntimeSessionsModule;
+    desktopRuntimeSessions: V1DesktopRuntimeSessionsModule;
     constructor(baseUrl: string, apiKey: string, appId?: string);
 }
 
@@ -503,4 +498,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, DeveloperApiError as a, ValidationError as b, V1AuthModule as c, V1AdminModule as d, V1DocumentModule as e, V1WorkspaceModule as f, V1SystemModule as g, V1ThreadModule as h, V1UsersModule as i, V1OpenAIModule as j, V1EmbedModule as k, V1RuntimeSessionsModule as l };
+export { AuthenticationError as A, DeveloperApiClient as D, NotFoundError as N, ServerError as S, V1ApiNamespace as V, DeveloperApiError as a, ValidationError as b, V1AuthModule as c, V1AdminModule as d, V1DocumentModule as e, V1WorkspaceModule as f, V1SystemModule as g, V1ThreadModule as h, V1UsersModule as i, V1OpenAIModule as j, V1EmbedModule as k, V1DesktopRuntimeSessionsModule as l };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { V as V1ApiNamespace } from './errors-7Y9damGS.mjs';
-export { A as AuthenticationError, D as DeveloperApiClient, a as DeveloperApiError, N as NotFoundError, S as ServerError, b as ValidationError } from './errors-7Y9damGS.mjs';
+import { V as V1ApiNamespace } from './errors-BmVxnpJS.mjs';
+export { A as AuthenticationError, D as DeveloperApiClient, a as DeveloperApiError, N as NotFoundError, S as ServerError, b as ValidationError } from './errors-BmVxnpJS.mjs';
 
 /**
  * RealtimeX Local App SDK - Types

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { V as V1ApiNamespace } from './errors-7Y9damGS.js';
-export { A as AuthenticationError, D as DeveloperApiClient, a as DeveloperApiError, N as NotFoundError, S as ServerError, b as ValidationError } from './errors-7Y9damGS.js';
+import { V as V1ApiNamespace } from './errors-BmVxnpJS.js';
+export { A as AuthenticationError, D as DeveloperApiClient, a as DeveloperApiError, N as NotFoundError, S as ServerError, b as ValidationError } from './errors-BmVxnpJS.js';
 
 /**
  * RealtimeX Local App SDK - Types

package/dist/index.js

@@ -3687,73 +3687,66 @@ var V1EmbedModule = class {
   }
 };
 
-// src/v1/modules/v1RuntimeSessions.ts
-var V1RuntimeSessionsModule = class {
+// src/v1/modules/v1DesktopRuntimeSessions.ts
+var V1DesktopRuntimeSessionsModule = class {
   constructor(client) {
     this.client = client;
   }
   /**
-   * Resolve the desktop shell launch working directory for a workspace or thread context.
-   * @see POST /runtime-sessions/desktop-shell/launch-spec
+   * Open the shared terminal launcher in the Electron desktop app.
+   * @see POST /sdk/desktop/runtime-sessions/open-launcher
    */
-  async desktopShellLaunchSpec(body) {
-    return this.client.request("POST", `/runtime-sessions/desktop-shell/launch-spec`, body);
+  async openLauncher(body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/open-launcher`, body);
   }
   /**
-   * Evaluate the runtime terminal permission policy for a pending CLI action.
-   * @see POST /runtime-sessions/terminal-permissions/evaluate
+   * Launch a local PTY-backed shell terminal in the Electron desktop app.
+   * @see POST /sdk/desktop/runtime-sessions/launch-terminal-shell
    */
-  async terminalPermissionsEvaluate(body) {
-    return this.client.request("POST", `/runtime-sessions/terminal-permissions/evaluate`, body);
+  async launchTerminalShell(body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/launch-terminal-shell`, body);
   }
   /**
-   * Resolve the CLI agent terminal launch command and working directory.
-   * @see POST /runtime-sessions/cli-agent/launch-spec
+   * Launch a local PTY-backed CLI agent terminal in the Electron desktop app.
+   * @see POST /sdk/desktop/runtime-sessions/launch-terminal-cli-agent
    */
-  async cliAgentLaunchSpec(body) {
-    return this.client.request("POST", `/runtime-sessions/cli-agent/launch-spec`, body);
+  async launchTerminalCliAgent(body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/launch-terminal-cli-agent`, body);
   }
   /**
-   * Create a persistent ACP-backed CLI agent runtime session.
-   * @see POST /runtime-sessions/cli-agent
+   * List desktop PTY-backed runtime sessions currently known to the Electron app.
+   * @see GET /sdk/desktop/runtime-sessions
    */
-  async cliAgent(body) {
-    return this.client.request("POST", `/runtime-sessions/cli-agent`, body);
+  async listRuntimeSessions() {
+    return this.client.request("GET", `/sdk/desktop/runtime-sessions`);
   }
   /**
-   * Stream a chat turn to an existing CLI agent runtime session using Server-Sent Events.
-   * @see POST /runtime-sessions/cli-agent/{sessionKey}/chat/stream
+   * Fetch one desktop PTY-backed runtime session by runtime session ID or PTY session ID.
+   * @see GET /sdk/desktop/runtime-sessions/{sessionId}
    */
-  async cliAgentChatStream(sessionKey, body) {
-    return this.client.request("POST", `/runtime-sessions/cli-agent/${sessionKey}/chat/stream`, body);
+  async getRuntimeSession(sessionId) {
+    return this.client.request("GET", `/sdk/desktop/runtime-sessions/${sessionId}`);
   }
   /**
-   * Resolve a pending permission request for a CLI agent runtime session.
-   * @see POST /runtime-sessions/cli-agent/{sessionKey}/permission
+   * Close an existing desktop runtime session.
+   * @see DELETE /sdk/desktop/runtime-sessions/{sessionId}
    */
-  async cliAgentPermission(sessionKey, body) {
-    return this.client.request("POST", `/runtime-sessions/cli-agent/${sessionKey}/permission`, body);
+  async deleteRuntimeSession(sessionId) {
+    return this.client.request("DELETE", `/sdk/desktop/runtime-sessions/${sessionId}`);
   }
   /**
-   * Cancel the current CLI turn for an active runtime session.
-   * @see POST /runtime-sessions/cli-agent/{sessionKey}/cancel
+   * Write input to an existing desktop runtime session. Use `message` to submit a CLI turn or `input` for raw PTY data.
+   * @see POST /sdk/desktop/runtime-sessions/{sessionId}/write
    */
-  async cliAgentCancel(sessionKey, body) {
-    return this.client.request("POST", `/runtime-sessions/cli-agent/${sessionKey}/cancel`, body);
+  async write(sessionId, body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/${sessionId}/write`, body);
   }
   /**
-   * Close a CLI agent runtime session and clear its control-plane metadata.
-   * @see DELETE /runtime-sessions/cli-agent/{sessionKey}
+   * Approve or deny a pending desktop runtime session action.
+   * @see POST /sdk/desktop/runtime-sessions/{sessionId}/permission
    */
-  async deleteCliAgent(sessionKey) {
-    return this.client.request("DELETE", `/runtime-sessions/cli-agent/${sessionKey}`);
-  }
-  /**
-   * Fetch the current state and runtime options for a CLI agent session.
-   * @see GET /runtime-sessions/cli-agent/{sessionKey}
-   */
-  async getCliAgent(sessionKey) {
-    return this.client.request("GET", `/runtime-sessions/cli-agent/${sessionKey}`);
+  async permission(sessionId, body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/${sessionId}/permission`, body);
   }
 };
 
@@ -3771,7 +3764,7 @@ var V1ApiNamespace = class {
     this.users = new V1UsersModule(this._client);
     this.openai = new V1OpenAIModule(this._client);
     this.embed = new V1EmbedModule(this._client);
-    this.runtimeSessions = new V1RuntimeSessionsModule(this._client);
+    this.desktopRuntimeSessions = new V1DesktopRuntimeSessionsModule(this._client);
   }
 };
 

package/dist/index.mjs

@@ -6,7 +6,7 @@ import {
   ServerError,
   V1ApiNamespace,
   ValidationError
-} from "./chunk-YHNURPXJ.mjs";
+} from "./chunk-3DVGTGOK.mjs";
 
 // src/modules/api.ts
 var PermissionDeniedError = class extends Error {

package/dist/v1/index.d.mts

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

package/dist/v1/index.js

@@ -28,10 +28,10 @@ __export(v1_exports, {
   V1AdminModule: () => V1AdminModule,
   V1ApiNamespace: () => V1ApiNamespace,
   V1AuthModule: () => V1AuthModule,
+  V1DesktopRuntimeSessionsModule: () => V1DesktopRuntimeSessionsModule,
   V1DocumentModule: () => V1DocumentModule,
   V1EmbedModule: () => V1EmbedModule,
   V1OpenAIModule: () => V1OpenAIModule,
-  V1RuntimeSessionsModule: () => V1RuntimeSessionsModule,
   V1SystemModule: () => V1SystemModule,
   V1ThreadModule: () => V1ThreadModule,
   V1UsersModule: () => V1UsersModule,
@@ -688,73 +688,66 @@ var V1EmbedModule = class {
   }
 };
 
-// src/v1/modules/v1RuntimeSessions.ts
-var V1RuntimeSessionsModule = class {
+// src/v1/modules/v1DesktopRuntimeSessions.ts
+var V1DesktopRuntimeSessionsModule = class {
   constructor(client) {
     this.client = client;
   }
   /**
-   * Resolve the desktop shell launch working directory for a workspace or thread context.
-   * @see POST /runtime-sessions/desktop-shell/launch-spec
+   * Open the shared terminal launcher in the Electron desktop app.
+   * @see POST /sdk/desktop/runtime-sessions/open-launcher
    */
-  async desktopShellLaunchSpec(body) {
-    return this.client.request("POST", `/runtime-sessions/desktop-shell/launch-spec`, body);
+  async openLauncher(body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/open-launcher`, body);
   }
   /**
-   * Evaluate the runtime terminal permission policy for a pending CLI action.
-   * @see POST /runtime-sessions/terminal-permissions/evaluate
+   * Launch a local PTY-backed shell terminal in the Electron desktop app.
+   * @see POST /sdk/desktop/runtime-sessions/launch-terminal-shell
    */
-  async terminalPermissionsEvaluate(body) {
-    return this.client.request("POST", `/runtime-sessions/terminal-permissions/evaluate`, body);
+  async launchTerminalShell(body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/launch-terminal-shell`, body);
   }
   /**
-   * Resolve the CLI agent terminal launch command and working directory.
-   * @see POST /runtime-sessions/cli-agent/launch-spec
+   * Launch a local PTY-backed CLI agent terminal in the Electron desktop app.
+   * @see POST /sdk/desktop/runtime-sessions/launch-terminal-cli-agent
    */
-  async cliAgentLaunchSpec(body) {
-    return this.client.request("POST", `/runtime-sessions/cli-agent/launch-spec`, body);
+  async launchTerminalCliAgent(body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/launch-terminal-cli-agent`, body);
   }
   /**
-   * Create a persistent ACP-backed CLI agent runtime session.
-   * @see POST /runtime-sessions/cli-agent
+   * List desktop PTY-backed runtime sessions currently known to the Electron app.
+   * @see GET /sdk/desktop/runtime-sessions
    */
-  async cliAgent(body) {
-    return this.client.request("POST", `/runtime-sessions/cli-agent`, body);
+  async listRuntimeSessions() {
+    return this.client.request("GET", `/sdk/desktop/runtime-sessions`);
   }
   /**
-   * Stream a chat turn to an existing CLI agent runtime session using Server-Sent Events.
-   * @see POST /runtime-sessions/cli-agent/{sessionKey}/chat/stream
+   * Fetch one desktop PTY-backed runtime session by runtime session ID or PTY session ID.
+   * @see GET /sdk/desktop/runtime-sessions/{sessionId}
    */
-  async cliAgentChatStream(sessionKey, body) {
-    return this.client.request("POST", `/runtime-sessions/cli-agent/${sessionKey}/chat/stream`, body);
+  async getRuntimeSession(sessionId) {
+    return this.client.request("GET", `/sdk/desktop/runtime-sessions/${sessionId}`);
   }
   /**
-   * Resolve a pending permission request for a CLI agent runtime session.
-   * @see POST /runtime-sessions/cli-agent/{sessionKey}/permission
+   * Close an existing desktop runtime session.
+   * @see DELETE /sdk/desktop/runtime-sessions/{sessionId}
    */
-  async cliAgentPermission(sessionKey, body) {
-    return this.client.request("POST", `/runtime-sessions/cli-agent/${sessionKey}/permission`, body);
+  async deleteRuntimeSession(sessionId) {
+    return this.client.request("DELETE", `/sdk/desktop/runtime-sessions/${sessionId}`);
   }
   /**
-   * Cancel the current CLI turn for an active runtime session.
-   * @see POST /runtime-sessions/cli-agent/{sessionKey}/cancel
+   * Write input to an existing desktop runtime session. Use `message` to submit a CLI turn or `input` for raw PTY data.
+   * @see POST /sdk/desktop/runtime-sessions/{sessionId}/write
    */
-  async cliAgentCancel(sessionKey, body) {
-    return this.client.request("POST", `/runtime-sessions/cli-agent/${sessionKey}/cancel`, body);
+  async write(sessionId, body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/${sessionId}/write`, body);
   }
   /**
-   * Close a CLI agent runtime session and clear its control-plane metadata.
-   * @see DELETE /runtime-sessions/cli-agent/{sessionKey}
+   * Approve or deny a pending desktop runtime session action.
+   * @see POST /sdk/desktop/runtime-sessions/{sessionId}/permission
    */
-  async deleteCliAgent(sessionKey) {
-    return this.client.request("DELETE", `/runtime-sessions/cli-agent/${sessionKey}`);
-  }
-  /**
-   * Fetch the current state and runtime options for a CLI agent session.
-   * @see GET /runtime-sessions/cli-agent/{sessionKey}
-   */
-  async getCliAgent(sessionKey) {
-    return this.client.request("GET", `/runtime-sessions/cli-agent/${sessionKey}`);
+  async permission(sessionId, body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/${sessionId}/permission`, body);
   }
 };
 
@@ -772,7 +765,7 @@ var V1ApiNamespace = class {
     this.users = new V1UsersModule(this._client);
     this.openai = new V1OpenAIModule(this._client);
     this.embed = new V1EmbedModule(this._client);
-    this.runtimeSessions = new V1RuntimeSessionsModule(this._client);
+    this.desktopRuntimeSessions = new V1DesktopRuntimeSessionsModule(this._client);
   }
 };
 
@@ -899,10 +892,10 @@ async function uploadFileToFolder(client, file, folderName, options = {}) {
   V1AdminModule,
   V1ApiNamespace,
   V1AuthModule,
+  V1DesktopRuntimeSessionsModule,
   V1DocumentModule,
   V1EmbedModule,
   V1OpenAIModule,
-  V1RuntimeSessionsModule,
   V1SystemModule,
   V1ThreadModule,
   V1UsersModule,

package/dist/v1/index.mjs

@@ -7,16 +7,16 @@ import {
   V1AdminModule,
   V1ApiNamespace,
   V1AuthModule,
+  V1DesktopRuntimeSessionsModule,
   V1DocumentModule,
   V1EmbedModule,
   V1OpenAIModule,
-  V1RuntimeSessionsModule,
   V1SystemModule,
   V1ThreadModule,
   V1UsersModule,
   V1WorkspaceModule,
   ValidationError
-} from "../chunk-YHNURPXJ.mjs";
+} from "../chunk-3DVGTGOK.mjs";
 
 // src/v1/overrides/v1WorkspaceStreaming.ts
 async function* streamWorkspaceChat(client, slug, body) {
@@ -140,10 +140,10 @@ export {
   V1AdminModule,
   V1ApiNamespace,
   V1AuthModule,
+  V1DesktopRuntimeSessionsModule,
   V1DocumentModule,
   V1EmbedModule,
   V1OpenAIModule,
-  V1RuntimeSessionsModule,
   V1SystemModule,
   V1ThreadModule,
   V1UsersModule,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "1.7.6",
+    "version": "1.7.8",
     "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-04
-sdk_version: 1.7.6
+generated: 2026-05-06
+sdk_version: 1.7.8
 ---
 
 # RealTimeX Moderator (SDK Source-Verified)
 
-Interact with the RealTimeX platform (`http://localhost:3001`) using `@realtimex/sdk` **v1.7.6**. Authentication is automatic when running inside RealtimeX.
+Interact with the RealTimeX platform (`http://localhost:3001`) using `@realtimex/sdk` **v1.7.8**. Authentication is automatic when running inside RealtimeX.
 
 `<SKILL_DIR>` below refers to the directory containing this SKILL.md.
 

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.6** · 2026-05-04
+> Auto-generated from `@realtimex/sdk` source · v**1.7.8** · 2026-05-06
 
 **Package:** `@realtimex/sdk` (CJS) · **Server:** `http://localhost:3001`
 **Developer Mode auth:** `Authorization: Bearer <apiKey>`
@@ -834,6 +834,38 @@ async deleteExposure(exposureId: string): Promise<unknown>
 
 ---
 
+## sdk.v1.desktopRuntimeSessions — v1 Desktop Runtime Sessions
+
+### `V1DesktopRuntimeSessionsModule`
+
+```ts
+// Open the shared terminal launcher in the Electron desktop app.
+async openLauncher(body?: Record<string, unknown>): Promise<unknown>
+
+// Launch a local PTY-backed shell terminal in the Electron desktop app.
+async launchTerminalShell(body?: Record<string, unknown>): Promise<unknown>
+
+// Launch a local PTY-backed CLI agent terminal in the Electron desktop app.
+async launchTerminalCliAgent(body?: Record<string, unknown>): Promise<unknown>
+
+// List desktop PTY-backed runtime sessions currently known to the Electron app.
+async listRuntimeSessions(): Promise<unknown>
+
+// Fetch one desktop PTY-backed runtime session by runtime session ID or PTY session ID.
+async getRuntimeSession(sessionId: string): Promise<unknown>
+
+// Close an existing desktop runtime session.
+async deleteRuntimeSession(sessionId: string): Promise<unknown>
+
+// Write input to an existing desktop runtime session. Use `message` to submit a CLI turn or `input` for raw PTY data.
+async write(sessionId: string, body?: Record<string, unknown>): Promise<unknown>
+
+// Approve or deny a pending desktop runtime session action.
+async permission(sessionId: string, body?: Record<string, unknown>): Promise<unknown>
+```
+
+---
+
 ## sdk.v1.document — v1 Document
 
 ### `V1DocumentModule`
@@ -918,41 +950,6 @@ async listVectorStores(): Promise<unknown>
 
 ---
 
-## sdk.v1.runtimeSessions — Runtime Sessions (CLI Agent / Terminal mode)
-
-### `V1RuntimeSessionsModule`
-
-```ts
-// Resolve the desktop shell launch working directory for a workspace or thread context.
-async desktopShellLaunchSpec(body?: Record<string, unknown>): Promise<unknown>
-
-// Evaluate the runtime terminal permission policy for a pending CLI action.
-async terminalPermissionsEvaluate(body?: Record<string, unknown>): Promise<unknown>
-
-// Resolve the CLI agent terminal launch command and working directory.
-async cliAgentLaunchSpec(body?: Record<string, unknown>): Promise<unknown>
-
-// Create a persistent ACP-backed CLI agent runtime session.
-async cliAgent(body?: Record<string, unknown>): Promise<unknown>
-
-// Stream a chat turn to an existing CLI agent runtime session using Server-Sent Events.
-async cliAgentChatStream(sessionKey: string, body?: Record<string, unknown>): Promise<unknown>
-
-// Resolve a pending permission request for a CLI agent runtime session.
-async cliAgentPermission(sessionKey: string, body?: Record<string, unknown>): Promise<unknown>
-
-// Cancel the current CLI turn for an active runtime session.
-async cliAgentCancel(sessionKey: string, body?: Record<string, unknown>): Promise<unknown>
-
-// Close a CLI agent runtime session and clear its control-plane metadata.
-async deleteCliAgent(sessionKey: string): Promise<unknown>
-
-// Fetch the current state and runtime options for a CLI agent session.
-async getCliAgent(sessionKey: string): Promise<unknown>
-```
-
----
-
 ## sdk.v1.sttApi — v1 Stt Api
 
 ### `V1SttApiModule`

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.6** · 2026-05-04
+> Auto-generated by `scripts/generate-skill.mjs` · SDK **1.7.8** · 2026-05-06
 
 Run `node scripts/generate-skill.mjs --force` after SDK source changes to refresh.