@realtimex/sdk 1.7.7 → 1.7.9

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

@@ -487,77 +487,6 @@ var V1SystemModule = class {
   }
 };
 
-// src/v1/modules/v1RuntimeSessions.ts
-var V1RuntimeSessionsModule = class {
-  constructor(client) {
-    this.client = client;
-  }
-  /**
-   * Resolve the desktop shell launch working directory for a workspace or thread context.
-   * @see POST /v1/runtime-sessions/desktop-shell/launch-spec
-   */
-  async desktopShellLaunchSpec(body) {
-    return this.client.request("POST", `/v1/runtime-sessions/desktop-shell/launch-spec`, body);
-  }
-  /**
-   * Evaluate the runtime terminal permission policy for a pending CLI action.
-   * @see POST /v1/runtime-sessions/terminal-permissions/evaluate
-   */
-  async terminalPermissionsEvaluate(body) {
-    return this.client.request("POST", `/v1/runtime-sessions/terminal-permissions/evaluate`, body);
-  }
-  /**
-   * Resolve the CLI agent terminal launch command and working directory.
-   * @see POST /v1/runtime-sessions/cli-agent/launch-spec
-   */
-  async cliAgentLaunchSpec(body) {
-    return this.client.request("POST", `/v1/runtime-sessions/cli-agent/launch-spec`, body);
-  }
-  /**
-   * Create a persistent ACP-backed CLI agent runtime session.
-   * @see POST /v1/runtime-sessions/cli-agent
-   */
-  async cliAgent(body) {
-    return this.client.request("POST", `/v1/runtime-sessions/cli-agent`, body);
-  }
-  /**
-   * Stream a chat turn to an existing CLI agent runtime session using Server-Sent Events.
-   * @see POST /v1/runtime-sessions/cli-agent/{sessionKey}/chat/stream
-   */
-  // @streaming-stub — implement SSE parsing in overrides/v1RuntimeSessionsStreaming.ts
-  async cliAgentChatStream(sessionKey, body) {
-    return this.client.requestRaw("POST", `/v1/runtime-sessions/cli-agent/${sessionKey}/chat/stream`, body);
-  }
-  /**
-   * Resolve a pending permission request for a CLI agent runtime session.
-   * @see POST /v1/runtime-sessions/cli-agent/{sessionKey}/permission
-   */
-  async cliAgentPermission(sessionKey, body) {
-    return this.client.request("POST", `/v1/runtime-sessions/cli-agent/${sessionKey}/permission`, body);
-  }
-  /**
-   * Cancel the current CLI turn for an active runtime session.
-   * @see POST /v1/runtime-sessions/cli-agent/{sessionKey}/cancel
-   */
-  async cliAgentCancel(sessionKey, body) {
-    return this.client.request("POST", `/v1/runtime-sessions/cli-agent/${sessionKey}/cancel`, body);
-  }
-  /**
-   * Close a CLI agent runtime session and clear its control-plane metadata.
-   * @see DELETE /v1/runtime-sessions/cli-agent/{sessionKey}
-   */
-  async deleteCliAgent(sessionKey) {
-    return this.client.request("DELETE", `/v1/runtime-sessions/cli-agent/${sessionKey}`);
-  }
-  /**
-   * Fetch the current state and runtime options for a CLI agent session.
-   * @see GET /v1/runtime-sessions/cli-agent/{sessionKey}
-   */
-  async getCliAgent(sessionKey) {
-    return this.client.request("GET", `/v1/runtime-sessions/cli-agent/${sessionKey}`);
-  }
-};
-
 // src/v1/modules/v1Thread.ts
 var V1ThreadModule = class {
   constructor(client) {
@@ -713,6 +642,69 @@ var V1EmbedModule = class {
   }
 };
 
+// src/v1/modules/v1DesktopRuntimeSessions.ts
+var V1DesktopRuntimeSessionsModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Open the shared terminal launcher in the Electron desktop app.
+   * @see POST /sdk/desktop/runtime-sessions/open-launcher
+   */
+  async openLauncher(body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/open-launcher`, body);
+  }
+  /**
+   * Launch a local PTY-backed shell terminal in the Electron desktop app.
+   * @see POST /sdk/desktop/runtime-sessions/launch-terminal-shell
+   */
+  async launchTerminalShell(body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/launch-terminal-shell`, body);
+  }
+  /**
+   * Launch a local PTY-backed CLI agent terminal in the Electron desktop app.
+   * @see POST /sdk/desktop/runtime-sessions/launch-terminal-cli-agent
+   */
+  async launchTerminalCliAgent(body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/launch-terminal-cli-agent`, body);
+  }
+  /**
+   * List desktop PTY-backed runtime sessions currently known to the Electron app.
+   * @see GET /sdk/desktop/runtime-sessions
+   */
+  async listRuntimeSessions() {
+    return this.client.request("GET", `/sdk/desktop/runtime-sessions`);
+  }
+  /**
+   * Fetch one desktop PTY-backed runtime session by runtime session ID or PTY session ID.
+   * @see GET /sdk/desktop/runtime-sessions/{sessionId}
+   */
+  async getRuntimeSession(sessionId) {
+    return this.client.request("GET", `/sdk/desktop/runtime-sessions/${sessionId}`);
+  }
+  /**
+   * Close an existing desktop runtime session.
+   * @see DELETE /sdk/desktop/runtime-sessions/{sessionId}
+   */
+  async deleteRuntimeSession(sessionId) {
+    return this.client.request("DELETE", `/sdk/desktop/runtime-sessions/${sessionId}`);
+  }
+  /**
+   * 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 write(sessionId, body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/${sessionId}/write`, body);
+  }
+  /**
+   * Approve or deny a pending desktop runtime session action.
+   * @see POST /sdk/desktop/runtime-sessions/{sessionId}/permission
+   */
+  async permission(sessionId, body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/${sessionId}/permission`, body);
+  }
+};
+
 // src/v1/namespace.ts
 var V1ApiNamespace = class {
   // [GENERATED-PROPS-END]
@@ -723,11 +715,11 @@ var V1ApiNamespace = class {
     this.document = new V1DocumentModule(this._client);
     this.workspace = new V1WorkspaceModule(this._client);
     this.system = new V1SystemModule(this._client);
-    this.runtimeSessions = new V1RuntimeSessionsModule(this._client);
     this.thread = new V1ThreadModule(this._client);
     this.users = new V1UsersModule(this._client);
     this.openai = new V1OpenAIModule(this._client);
     this.embed = new V1EmbedModule(this._client);
+    this.desktopRuntimeSessions = new V1DesktopRuntimeSessionsModule(this._client);
   }
 };
 
@@ -743,10 +735,10 @@ export {
   V1DocumentModule,
   V1WorkspaceModule,
   V1SystemModule,
-  V1RuntimeSessionsModule,
   V1ThreadModule,
   V1UsersModule,
   V1OpenAIModule,
   V1EmbedModule,
+  V1DesktopRuntimeSessionsModule,
   V1ApiNamespace
 };

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

@@ -295,56 +295,6 @@ declare class V1SystemModule {
     getHealthVersion3(): Promise<unknown>;
 }
 
-declare class V1RuntimeSessionsModule {
-    private readonly client;
-    constructor(client: DeveloperApiClient);
-    /**
-     * Resolve the desktop shell launch working directory for a workspace or thread context.
-     * @see POST /v1/runtime-sessions/desktop-shell/launch-spec
-     */
-    desktopShellLaunchSpec(body?: Record<string, unknown>): Promise<unknown>;
-    /**
-     * Evaluate the runtime terminal permission policy for a pending CLI action.
-     * @see POST /v1/runtime-sessions/terminal-permissions/evaluate
-     */
-    terminalPermissionsEvaluate(body?: Record<string, unknown>): Promise<unknown>;
-    /**
-     * Resolve the CLI agent terminal launch command and working directory.
-     * @see POST /v1/runtime-sessions/cli-agent/launch-spec
-     */
-    cliAgentLaunchSpec(body?: Record<string, unknown>): Promise<unknown>;
-    /**
-     * Create a persistent ACP-backed CLI agent runtime session.
-     * @see POST /v1/runtime-sessions/cli-agent
-     */
-    cliAgent(body?: Record<string, unknown>): Promise<unknown>;
-    /**
-     * Stream a chat turn to an existing CLI agent runtime session using Server-Sent Events.
-     * @see POST /v1/runtime-sessions/cli-agent/{sessionKey}/chat/stream
-     */
-    cliAgentChatStream(sessionKey: string, body?: Record<string, unknown>): Promise<Response>;
-    /**
-     * Resolve a pending permission request for a CLI agent runtime session.
-     * @see POST /v1/runtime-sessions/cli-agent/{sessionKey}/permission
-     */
-    cliAgentPermission(sessionKey: string, body?: Record<string, unknown>): Promise<unknown>;
-    /**
-     * Cancel the current CLI turn for an active runtime session.
-     * @see POST /v1/runtime-sessions/cli-agent/{sessionKey}/cancel
-     */
-    cliAgentCancel(sessionKey: string, body?: Record<string, unknown>): Promise<unknown>;
-    /**
-     * Close a CLI agent runtime session and clear its control-plane metadata.
-     * @see DELETE /v1/runtime-sessions/cli-agent/{sessionKey}
-     */
-    deleteCliAgent(sessionKey: string): Promise<unknown>;
-    /**
-     * Fetch the current state and runtime options for a CLI agent session.
-     * @see GET /v1/runtime-sessions/cli-agent/{sessionKey}
-     */
-    getCliAgent(sessionKey: string): Promise<unknown>;
-}
-
 declare class V1ThreadModule {
     private readonly client;
     constructor(client: DeveloperApiClient);
@@ -455,6 +405,51 @@ declare class V1EmbedModule {
     deleteEmbed(embedUuid: string): Promise<unknown>;
 }
 
+declare class V1DesktopRuntimeSessionsModule {
+    private readonly client;
+    constructor(client: DeveloperApiClient);
+    /**
+     * Open the shared terminal launcher in the Electron desktop app.
+     * @see POST /sdk/desktop/runtime-sessions/open-launcher
+     */
+    openLauncher(body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Launch a local PTY-backed shell terminal in the Electron desktop app.
+     * @see POST /sdk/desktop/runtime-sessions/launch-terminal-shell
+     */
+    launchTerminalShell(body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Launch a local PTY-backed CLI agent terminal in the Electron desktop app.
+     * @see POST /sdk/desktop/runtime-sessions/launch-terminal-cli-agent
+     */
+    launchTerminalCliAgent(body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * List desktop PTY-backed runtime sessions currently known to the Electron app.
+     * @see GET /sdk/desktop/runtime-sessions
+     */
+    listRuntimeSessions(): Promise<unknown>;
+    /**
+     * Fetch one desktop PTY-backed runtime session by runtime session ID or PTY session ID.
+     * @see GET /sdk/desktop/runtime-sessions/{sessionId}
+     */
+    getRuntimeSession(sessionId: string): Promise<unknown>;
+    /**
+     * Close an existing desktop runtime session.
+     * @see DELETE /sdk/desktop/runtime-sessions/{sessionId}
+     */
+    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.
+     * @see POST /sdk/desktop/runtime-sessions/{sessionId}/write
+     */
+    write(sessionId: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Approve or deny a pending desktop runtime session action.
+     * @see POST /sdk/desktop/runtime-sessions/{sessionId}/permission
+     */
+    permission(sessionId: string, body?: Record<string, unknown>): Promise<unknown>;
+}
+
 /**
  * V1ApiNamespace - Container for all RealtimeX Developer API (v1) modules.
  *
@@ -474,11 +469,11 @@ declare class V1ApiNamespace {
     document: V1DocumentModule;
     workspace: V1WorkspaceModule;
     system: V1SystemModule;
-    runtimeSessions: V1RuntimeSessionsModule;
     thread: V1ThreadModule;
     users: V1UsersModule;
     openai: V1OpenAIModule;
     embed: V1EmbedModule;
+    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, V1RuntimeSessionsModule 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, 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 };

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

@@ -295,56 +295,6 @@ declare class V1SystemModule {
     getHealthVersion3(): Promise<unknown>;
 }
 
-declare class V1RuntimeSessionsModule {
-    private readonly client;
-    constructor(client: DeveloperApiClient);
-    /**
-     * Resolve the desktop shell launch working directory for a workspace or thread context.
-     * @see POST /v1/runtime-sessions/desktop-shell/launch-spec
-     */
-    desktopShellLaunchSpec(body?: Record<string, unknown>): Promise<unknown>;
-    /**
-     * Evaluate the runtime terminal permission policy for a pending CLI action.
-     * @see POST /v1/runtime-sessions/terminal-permissions/evaluate
-     */
-    terminalPermissionsEvaluate(body?: Record<string, unknown>): Promise<unknown>;
-    /**
-     * Resolve the CLI agent terminal launch command and working directory.
-     * @see POST /v1/runtime-sessions/cli-agent/launch-spec
-     */
-    cliAgentLaunchSpec(body?: Record<string, unknown>): Promise<unknown>;
-    /**
-     * Create a persistent ACP-backed CLI agent runtime session.
-     * @see POST /v1/runtime-sessions/cli-agent
-     */
-    cliAgent(body?: Record<string, unknown>): Promise<unknown>;
-    /**
-     * Stream a chat turn to an existing CLI agent runtime session using Server-Sent Events.
-     * @see POST /v1/runtime-sessions/cli-agent/{sessionKey}/chat/stream
-     */
-    cliAgentChatStream(sessionKey: string, body?: Record<string, unknown>): Promise<Response>;
-    /**
-     * Resolve a pending permission request for a CLI agent runtime session.
-     * @see POST /v1/runtime-sessions/cli-agent/{sessionKey}/permission
-     */
-    cliAgentPermission(sessionKey: string, body?: Record<string, unknown>): Promise<unknown>;
-    /**
-     * Cancel the current CLI turn for an active runtime session.
-     * @see POST /v1/runtime-sessions/cli-agent/{sessionKey}/cancel
-     */
-    cliAgentCancel(sessionKey: string, body?: Record<string, unknown>): Promise<unknown>;
-    /**
-     * Close a CLI agent runtime session and clear its control-plane metadata.
-     * @see DELETE /v1/runtime-sessions/cli-agent/{sessionKey}
-     */
-    deleteCliAgent(sessionKey: string): Promise<unknown>;
-    /**
-     * Fetch the current state and runtime options for a CLI agent session.
-     * @see GET /v1/runtime-sessions/cli-agent/{sessionKey}
-     */
-    getCliAgent(sessionKey: string): Promise<unknown>;
-}
-
 declare class V1ThreadModule {
     private readonly client;
     constructor(client: DeveloperApiClient);
@@ -455,6 +405,51 @@ declare class V1EmbedModule {
     deleteEmbed(embedUuid: string): Promise<unknown>;
 }
 
+declare class V1DesktopRuntimeSessionsModule {
+    private readonly client;
+    constructor(client: DeveloperApiClient);
+    /**
+     * Open the shared terminal launcher in the Electron desktop app.
+     * @see POST /sdk/desktop/runtime-sessions/open-launcher
+     */
+    openLauncher(body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Launch a local PTY-backed shell terminal in the Electron desktop app.
+     * @see POST /sdk/desktop/runtime-sessions/launch-terminal-shell
+     */
+    launchTerminalShell(body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Launch a local PTY-backed CLI agent terminal in the Electron desktop app.
+     * @see POST /sdk/desktop/runtime-sessions/launch-terminal-cli-agent
+     */
+    launchTerminalCliAgent(body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * List desktop PTY-backed runtime sessions currently known to the Electron app.
+     * @see GET /sdk/desktop/runtime-sessions
+     */
+    listRuntimeSessions(): Promise<unknown>;
+    /**
+     * Fetch one desktop PTY-backed runtime session by runtime session ID or PTY session ID.
+     * @see GET /sdk/desktop/runtime-sessions/{sessionId}
+     */
+    getRuntimeSession(sessionId: string): Promise<unknown>;
+    /**
+     * Close an existing desktop runtime session.
+     * @see DELETE /sdk/desktop/runtime-sessions/{sessionId}
+     */
+    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.
+     * @see POST /sdk/desktop/runtime-sessions/{sessionId}/write
+     */
+    write(sessionId: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Approve or deny a pending desktop runtime session action.
+     * @see POST /sdk/desktop/runtime-sessions/{sessionId}/permission
+     */
+    permission(sessionId: string, body?: Record<string, unknown>): Promise<unknown>;
+}
+
 /**
  * V1ApiNamespace - Container for all RealtimeX Developer API (v1) modules.
  *
@@ -474,11 +469,11 @@ declare class V1ApiNamespace {
     document: V1DocumentModule;
     workspace: V1WorkspaceModule;
     system: V1SystemModule;
-    runtimeSessions: V1RuntimeSessionsModule;
     thread: V1ThreadModule;
     users: V1UsersModule;
     openai: V1OpenAIModule;
     embed: V1EmbedModule;
+    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, V1RuntimeSessionsModule 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, 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 };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { V as V1ApiNamespace } from './errors-kN70vQrd.mjs';
-export { A as AuthenticationError, D as DeveloperApiClient, a as DeveloperApiError, N as NotFoundError, S as ServerError, b as ValidationError } from './errors-kN70vQrd.mjs';
+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';
 
 /**
  * RealtimeX Local App SDK - Types
@@ -2022,6 +2022,11 @@ declare class RealtimeXSDK {
      * Provides access to workspace management, admin, documents, system settings, and more.
      */
     v1: V1ApiNamespace | undefined;
+    /**
+     * Desktop terminal sessions — top-level alias for the desktop runtime session APIs.
+     * Backed by `sdk.v1.desktopRuntimeSessions` for compatibility with generated v1 modules.
+     */
+    desktopRuntimeSessions: V1DesktopRuntimeSessionsModule | 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 } from './errors-kN70vQrd.js';
-export { A as AuthenticationError, D as DeveloperApiClient, a as DeveloperApiError, N as NotFoundError, S as ServerError, b as ValidationError } from './errors-kN70vQrd.js';
+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';
 
 /**
  * RealtimeX Local App SDK - Types
@@ -2022,6 +2022,11 @@ declare class RealtimeXSDK {
      * Provides access to workspace management, admin, documents, system settings, and more.
      */
     v1: V1ApiNamespace | undefined;
+    /**
+     * Desktop terminal sessions — top-level alias for the desktop runtime session APIs.
+     * Backed by `sdk.v1.desktopRuntimeSessions` for compatibility with generated v1 modules.
+     */
+    desktopRuntimeSessions: V1DesktopRuntimeSessionsModule | undefined;
     readonly appId: string;
     readonly appName: string | undefined;
     readonly apiKey: string | undefined;

package/dist/index.js

@@ -3532,77 +3532,6 @@ var V1SystemModule = class {
   }
 };
 
-// src/v1/modules/v1RuntimeSessions.ts
-var V1RuntimeSessionsModule = class {
-  constructor(client) {
-    this.client = client;
-  }
-  /**
-   * Resolve the desktop shell launch working directory for a workspace or thread context.
-   * @see POST /v1/runtime-sessions/desktop-shell/launch-spec
-   */
-  async desktopShellLaunchSpec(body) {
-    return this.client.request("POST", `/v1/runtime-sessions/desktop-shell/launch-spec`, body);
-  }
-  /**
-   * Evaluate the runtime terminal permission policy for a pending CLI action.
-   * @see POST /v1/runtime-sessions/terminal-permissions/evaluate
-   */
-  async terminalPermissionsEvaluate(body) {
-    return this.client.request("POST", `/v1/runtime-sessions/terminal-permissions/evaluate`, body);
-  }
-  /**
-   * Resolve the CLI agent terminal launch command and working directory.
-   * @see POST /v1/runtime-sessions/cli-agent/launch-spec
-   */
-  async cliAgentLaunchSpec(body) {
-    return this.client.request("POST", `/v1/runtime-sessions/cli-agent/launch-spec`, body);
-  }
-  /**
-   * Create a persistent ACP-backed CLI agent runtime session.
-   * @see POST /v1/runtime-sessions/cli-agent
-   */
-  async cliAgent(body) {
-    return this.client.request("POST", `/v1/runtime-sessions/cli-agent`, body);
-  }
-  /**
-   * Stream a chat turn to an existing CLI agent runtime session using Server-Sent Events.
-   * @see POST /v1/runtime-sessions/cli-agent/{sessionKey}/chat/stream
-   */
-  // @streaming-stub — implement SSE parsing in overrides/v1RuntimeSessionsStreaming.ts
-  async cliAgentChatStream(sessionKey, body) {
-    return this.client.requestRaw("POST", `/v1/runtime-sessions/cli-agent/${sessionKey}/chat/stream`, body);
-  }
-  /**
-   * Resolve a pending permission request for a CLI agent runtime session.
-   * @see POST /v1/runtime-sessions/cli-agent/{sessionKey}/permission
-   */
-  async cliAgentPermission(sessionKey, body) {
-    return this.client.request("POST", `/v1/runtime-sessions/cli-agent/${sessionKey}/permission`, body);
-  }
-  /**
-   * Cancel the current CLI turn for an active runtime session.
-   * @see POST /v1/runtime-sessions/cli-agent/{sessionKey}/cancel
-   */
-  async cliAgentCancel(sessionKey, body) {
-    return this.client.request("POST", `/v1/runtime-sessions/cli-agent/${sessionKey}/cancel`, body);
-  }
-  /**
-   * Close a CLI agent runtime session and clear its control-plane metadata.
-   * @see DELETE /v1/runtime-sessions/cli-agent/{sessionKey}
-   */
-  async deleteCliAgent(sessionKey) {
-    return this.client.request("DELETE", `/v1/runtime-sessions/cli-agent/${sessionKey}`);
-  }
-  /**
-   * Fetch the current state and runtime options for a CLI agent session.
-   * @see GET /v1/runtime-sessions/cli-agent/{sessionKey}
-   */
-  async getCliAgent(sessionKey) {
-    return this.client.request("GET", `/v1/runtime-sessions/cli-agent/${sessionKey}`);
-  }
-};
-
 // src/v1/modules/v1Thread.ts
 var V1ThreadModule = class {
   constructor(client) {
@@ -3758,6 +3687,69 @@ var V1EmbedModule = class {
   }
 };
 
+// src/v1/modules/v1DesktopRuntimeSessions.ts
+var V1DesktopRuntimeSessionsModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Open the shared terminal launcher in the Electron desktop app.
+   * @see POST /sdk/desktop/runtime-sessions/open-launcher
+   */
+  async openLauncher(body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/open-launcher`, body);
+  }
+  /**
+   * Launch a local PTY-backed shell terminal in the Electron desktop app.
+   * @see POST /sdk/desktop/runtime-sessions/launch-terminal-shell
+   */
+  async launchTerminalShell(body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/launch-terminal-shell`, body);
+  }
+  /**
+   * Launch a local PTY-backed CLI agent terminal in the Electron desktop app.
+   * @see POST /sdk/desktop/runtime-sessions/launch-terminal-cli-agent
+   */
+  async launchTerminalCliAgent(body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/launch-terminal-cli-agent`, body);
+  }
+  /**
+   * List desktop PTY-backed runtime sessions currently known to the Electron app.
+   * @see GET /sdk/desktop/runtime-sessions
+   */
+  async listRuntimeSessions() {
+    return this.client.request("GET", `/sdk/desktop/runtime-sessions`);
+  }
+  /**
+   * Fetch one desktop PTY-backed runtime session by runtime session ID or PTY session ID.
+   * @see GET /sdk/desktop/runtime-sessions/{sessionId}
+   */
+  async getRuntimeSession(sessionId) {
+    return this.client.request("GET", `/sdk/desktop/runtime-sessions/${sessionId}`);
+  }
+  /**
+   * Close an existing desktop runtime session.
+   * @see DELETE /sdk/desktop/runtime-sessions/{sessionId}
+   */
+  async deleteRuntimeSession(sessionId) {
+    return this.client.request("DELETE", `/sdk/desktop/runtime-sessions/${sessionId}`);
+  }
+  /**
+   * 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 write(sessionId, body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/${sessionId}/write`, body);
+  }
+  /**
+   * Approve or deny a pending desktop runtime session action.
+   * @see POST /sdk/desktop/runtime-sessions/{sessionId}/permission
+   */
+  async permission(sessionId, body) {
+    return this.client.request("POST", `/sdk/desktop/runtime-sessions/${sessionId}/permission`, body);
+  }
+};
+
 // src/v1/namespace.ts
 var V1ApiNamespace = class {
   // [GENERATED-PROPS-END]
@@ -3768,11 +3760,11 @@ var V1ApiNamespace = class {
     this.document = new V1DocumentModule(this._client);
     this.workspace = new V1WorkspaceModule(this._client);
     this.system = new V1SystemModule(this._client);
-    this.runtimeSessions = new V1RuntimeSessionsModule(this._client);
     this.thread = new V1ThreadModule(this._client);
     this.users = new V1UsersModule(this._client);
     this.openai = new V1OpenAIModule(this._client);
     this.embed = new V1EmbedModule(this._client);
+    this.desktopRuntimeSessions = new V1DesktopRuntimeSessionsModule(this._client);
   }
 };
 
@@ -4475,6 +4467,7 @@ var _RealtimeXSDK = class _RealtimeXSDK {
     this.auth = new AuthModule(this.realtimexUrl, this.appId, this.apiKey);
     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;
     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-EMMHP4JM.mjs";
+} from "./chunk-3DVGTGOK.mjs";
 
 // src/modules/api.ts
 var PermissionDeniedError = class extends Error {
@@ -3652,6 +3652,7 @@ var _RealtimeXSDK = class _RealtimeXSDK {
     this.auth = new AuthModule(this.realtimexUrl, this.appId, this.apiKey);
     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;
     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-kN70vQrd.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, l as V1EmbedModule, k as V1OpenAIModule, h as V1RuntimeSessionsModule, g as V1SystemModule, i as V1ThreadModule, j as V1UsersModule, f as V1WorkspaceModule, b as ValidationError } from '../errors-kN70vQrd.mjs';
+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';
 
 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-kN70vQrd.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, l as V1EmbedModule, k as V1OpenAIModule, h as V1RuntimeSessionsModule, g as V1SystemModule, i as V1ThreadModule, j as V1UsersModule, f as V1WorkspaceModule, b as ValidationError } from '../errors-kN70vQrd.js';
+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';
 
 interface WorkspaceStreamChunk {
     /** The text fragment emitted by this SSE event */