@realtimex/sdk 1.7.4 → 1.7.6

package/dist/{chunk-PDAMNSF2.mjs → chunk-YHNURPXJ.mjs}

@@ -125,6 +125,20 @@ var V1AuthModule = class {
   async getAuth() {
     return this.client.request("GET", `/v1/auth`);
   }
+  /**
+   * Relay external browser auth callbacks back to the local Electron renderer. Localhost only; keyed by OAuth state.
+   * @see POST /v1/auth/external-callback
+   */
+  async externalCallback() {
+    return this.client.request("POST", `/v1/auth/external-callback`);
+  }
+  /**
+   * Poll for a relayed external browser auth callback by OAuth state. Localhost only.
+   * @see GET /v1/auth/external-callback/{state}
+   */
+  async getExternalCallback(state) {
+    return this.client.request("GET", `/v1/auth/external-callback/${state}`);
+  }
 };
 
 // src/v1/modules/v1Admin.ts
@@ -628,6 +642,76 @@ var V1EmbedModule = 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 /runtime-sessions/desktop-shell/launch-spec
+   */
+  async desktopShellLaunchSpec(body) {
+    return this.client.request("POST", `/runtime-sessions/desktop-shell/launch-spec`, body);
+  }
+  /**
+   * Evaluate the runtime terminal permission policy for a pending CLI action.
+   * @see POST /runtime-sessions/terminal-permissions/evaluate
+   */
+  async terminalPermissionsEvaluate(body) {
+    return this.client.request("POST", `/runtime-sessions/terminal-permissions/evaluate`, body);
+  }
+  /**
+   * Resolve the CLI agent terminal launch command and working directory.
+   * @see POST /runtime-sessions/cli-agent/launch-spec
+   */
+  async cliAgentLaunchSpec(body) {
+    return this.client.request("POST", `/runtime-sessions/cli-agent/launch-spec`, body);
+  }
+  /**
+   * Create a persistent ACP-backed CLI agent runtime session.
+   * @see POST /runtime-sessions/cli-agent
+   */
+  async cliAgent(body) {
+    return this.client.request("POST", `/runtime-sessions/cli-agent`, body);
+  }
+  /**
+   * Stream a chat turn to an existing CLI agent runtime session using Server-Sent Events.
+   * @see POST /runtime-sessions/cli-agent/{sessionKey}/chat/stream
+   */
+  async cliAgentChatStream(sessionKey, body) {
+    return this.client.request("POST", `/runtime-sessions/cli-agent/${sessionKey}/chat/stream`, body);
+  }
+  /**
+   * Resolve a pending permission request for a CLI agent runtime session.
+   * @see POST /runtime-sessions/cli-agent/{sessionKey}/permission
+   */
+  async cliAgentPermission(sessionKey, body) {
+    return this.client.request("POST", `/runtime-sessions/cli-agent/${sessionKey}/permission`, body);
+  }
+  /**
+   * Cancel the current CLI turn for an active runtime session.
+   * @see POST /runtime-sessions/cli-agent/{sessionKey}/cancel
+   */
+  async cliAgentCancel(sessionKey, body) {
+    return this.client.request("POST", `/runtime-sessions/cli-agent/${sessionKey}/cancel`, body);
+  }
+  /**
+   * Close a CLI agent runtime session and clear its control-plane metadata.
+   * @see DELETE /runtime-sessions/cli-agent/{sessionKey}
+   */
+  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}`);
+  }
+};
+
 // src/v1/namespace.ts
 var V1ApiNamespace = class {
   // [GENERATED-PROPS-END]
@@ -642,6 +726,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);
   }
 };
 
@@ -661,5 +746,6 @@ export {
   V1UsersModule,
   V1OpenAIModule,
   V1EmbedModule,
+  V1RuntimeSessionsModule,
   V1ApiNamespace
 };

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

@@ -38,6 +38,16 @@ declare class V1AuthModule {
      * @see GET /v1/auth
      */
     getAuth(): Promise<unknown>;
+    /**
+     * Relay external browser auth callbacks back to the local Electron renderer. Localhost only; keyed by OAuth state.
+     * @see POST /v1/auth/external-callback
+     */
+    externalCallback(): Promise<unknown>;
+    /**
+     * Poll for a relayed external browser auth callback by OAuth state. Localhost only.
+     * @see GET /v1/auth/external-callback/{state}
+     */
+    getExternalCallback(state: string): Promise<unknown>;
 }
 
 declare class V1AdminModule {
@@ -395,6 +405,56 @@ declare class V1EmbedModule {
     deleteEmbed(embedUuid: string): 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 /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 /runtime-sessions/terminal-permissions/evaluate
+     */
+    terminalPermissionsEvaluate(body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Resolve the CLI agent terminal launch command and working directory.
+     * @see POST /runtime-sessions/cli-agent/launch-spec
+     */
+    cliAgentLaunchSpec(body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Create a persistent ACP-backed CLI agent runtime session.
+     * @see POST /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 /runtime-sessions/cli-agent/{sessionKey}/chat/stream
+     */
+    cliAgentChatStream(sessionKey: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Resolve a pending permission request for a CLI agent runtime session.
+     * @see POST /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 /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 /runtime-sessions/cli-agent/{sessionKey}
+     */
+    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>;
+}
+
 /**
  * V1ApiNamespace - Container for all RealtimeX Developer API (v1) modules.
  *
@@ -418,6 +478,7 @@ declare class V1ApiNamespace {
     users: V1UsersModule;
     openai: V1OpenAIModule;
     embed: V1EmbedModule;
+    runtimeSessions: V1RuntimeSessionsModule;
     constructor(baseUrl: string, apiKey: string, appId?: string);
 }
 
@@ -442,4 +503,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 };
+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 };

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

@@ -38,6 +38,16 @@ declare class V1AuthModule {
      * @see GET /v1/auth
      */
     getAuth(): Promise<unknown>;
+    /**
+     * Relay external browser auth callbacks back to the local Electron renderer. Localhost only; keyed by OAuth state.
+     * @see POST /v1/auth/external-callback
+     */
+    externalCallback(): Promise<unknown>;
+    /**
+     * Poll for a relayed external browser auth callback by OAuth state. Localhost only.
+     * @see GET /v1/auth/external-callback/{state}
+     */
+    getExternalCallback(state: string): Promise<unknown>;
 }
 
 declare class V1AdminModule {
@@ -395,6 +405,56 @@ declare class V1EmbedModule {
     deleteEmbed(embedUuid: string): 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 /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 /runtime-sessions/terminal-permissions/evaluate
+     */
+    terminalPermissionsEvaluate(body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Resolve the CLI agent terminal launch command and working directory.
+     * @see POST /runtime-sessions/cli-agent/launch-spec
+     */
+    cliAgentLaunchSpec(body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Create a persistent ACP-backed CLI agent runtime session.
+     * @see POST /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 /runtime-sessions/cli-agent/{sessionKey}/chat/stream
+     */
+    cliAgentChatStream(sessionKey: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Resolve a pending permission request for a CLI agent runtime session.
+     * @see POST /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 /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 /runtime-sessions/cli-agent/{sessionKey}
+     */
+    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>;
+}
+
 /**
  * V1ApiNamespace - Container for all RealtimeX Developer API (v1) modules.
  *
@@ -418,6 +478,7 @@ declare class V1ApiNamespace {
     users: V1UsersModule;
     openai: V1OpenAIModule;
     embed: V1EmbedModule;
+    runtimeSessions: V1RuntimeSessionsModule;
     constructor(baseUrl: string, apiKey: string, appId?: string);
 }
 
@@ -442,4 +503,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 };
+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 };

package/dist/index.d.mts

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

package/dist/index.d.ts

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

package/dist/index.js

@@ -3170,6 +3170,20 @@ var V1AuthModule = class {
   async getAuth() {
     return this.client.request("GET", `/v1/auth`);
   }
+  /**
+   * Relay external browser auth callbacks back to the local Electron renderer. Localhost only; keyed by OAuth state.
+   * @see POST /v1/auth/external-callback
+   */
+  async externalCallback() {
+    return this.client.request("POST", `/v1/auth/external-callback`);
+  }
+  /**
+   * Poll for a relayed external browser auth callback by OAuth state. Localhost only.
+   * @see GET /v1/auth/external-callback/{state}
+   */
+  async getExternalCallback(state) {
+    return this.client.request("GET", `/v1/auth/external-callback/${state}`);
+  }
 };
 
 // src/v1/modules/v1Admin.ts
@@ -3673,6 +3687,76 @@ var V1EmbedModule = 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 /runtime-sessions/desktop-shell/launch-spec
+   */
+  async desktopShellLaunchSpec(body) {
+    return this.client.request("POST", `/runtime-sessions/desktop-shell/launch-spec`, body);
+  }
+  /**
+   * Evaluate the runtime terminal permission policy for a pending CLI action.
+   * @see POST /runtime-sessions/terminal-permissions/evaluate
+   */
+  async terminalPermissionsEvaluate(body) {
+    return this.client.request("POST", `/runtime-sessions/terminal-permissions/evaluate`, body);
+  }
+  /**
+   * Resolve the CLI agent terminal launch command and working directory.
+   * @see POST /runtime-sessions/cli-agent/launch-spec
+   */
+  async cliAgentLaunchSpec(body) {
+    return this.client.request("POST", `/runtime-sessions/cli-agent/launch-spec`, body);
+  }
+  /**
+   * Create a persistent ACP-backed CLI agent runtime session.
+   * @see POST /runtime-sessions/cli-agent
+   */
+  async cliAgent(body) {
+    return this.client.request("POST", `/runtime-sessions/cli-agent`, body);
+  }
+  /**
+   * Stream a chat turn to an existing CLI agent runtime session using Server-Sent Events.
+   * @see POST /runtime-sessions/cli-agent/{sessionKey}/chat/stream
+   */
+  async cliAgentChatStream(sessionKey, body) {
+    return this.client.request("POST", `/runtime-sessions/cli-agent/${sessionKey}/chat/stream`, body);
+  }
+  /**
+   * Resolve a pending permission request for a CLI agent runtime session.
+   * @see POST /runtime-sessions/cli-agent/{sessionKey}/permission
+   */
+  async cliAgentPermission(sessionKey, body) {
+    return this.client.request("POST", `/runtime-sessions/cli-agent/${sessionKey}/permission`, body);
+  }
+  /**
+   * Cancel the current CLI turn for an active runtime session.
+   * @see POST /runtime-sessions/cli-agent/{sessionKey}/cancel
+   */
+  async cliAgentCancel(sessionKey, body) {
+    return this.client.request("POST", `/runtime-sessions/cli-agent/${sessionKey}/cancel`, body);
+  }
+  /**
+   * Close a CLI agent runtime session and clear its control-plane metadata.
+   * @see DELETE /runtime-sessions/cli-agent/{sessionKey}
+   */
+  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}`);
+  }
+};
+
 // src/v1/namespace.ts
 var V1ApiNamespace = class {
   // [GENERATED-PROPS-END]
@@ -3687,6 +3771,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);
   }
 };
 

package/dist/index.mjs

@@ -6,7 +6,7 @@ import {
   ServerError,
   V1ApiNamespace,
   ValidationError
-} from "./chunk-PDAMNSF2.mjs";
+} from "./chunk-YHNURPXJ.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-DoCX7LOD.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, g as V1SystemModule, h as V1ThreadModule, i as V1UsersModule, f as V1WorkspaceModule, b as ValidationError } from '../errors-DoCX7LOD.mjs';
+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';
 
 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-DoCX7LOD.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, g as V1SystemModule, h as V1ThreadModule, i as V1UsersModule, f as V1WorkspaceModule, b as ValidationError } from '../errors-DoCX7LOD.js';
+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';
 
 interface WorkspaceStreamChunk {
     /** The text fragment emitted by this SSE event */

package/dist/v1/index.js

@@ -31,6 +31,7 @@ __export(v1_exports, {
   V1DocumentModule: () => V1DocumentModule,
   V1EmbedModule: () => V1EmbedModule,
   V1OpenAIModule: () => V1OpenAIModule,
+  V1RuntimeSessionsModule: () => V1RuntimeSessionsModule,
   V1SystemModule: () => V1SystemModule,
   V1ThreadModule: () => V1ThreadModule,
   V1UsersModule: () => V1UsersModule,
@@ -170,6 +171,20 @@ var V1AuthModule = class {
   async getAuth() {
     return this.client.request("GET", `/v1/auth`);
   }
+  /**
+   * Relay external browser auth callbacks back to the local Electron renderer. Localhost only; keyed by OAuth state.
+   * @see POST /v1/auth/external-callback
+   */
+  async externalCallback() {
+    return this.client.request("POST", `/v1/auth/external-callback`);
+  }
+  /**
+   * Poll for a relayed external browser auth callback by OAuth state. Localhost only.
+   * @see GET /v1/auth/external-callback/{state}
+   */
+  async getExternalCallback(state) {
+    return this.client.request("GET", `/v1/auth/external-callback/${state}`);
+  }
 };
 
 // src/v1/modules/v1Admin.ts
@@ -673,6 +688,76 @@ var V1EmbedModule = 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 /runtime-sessions/desktop-shell/launch-spec
+   */
+  async desktopShellLaunchSpec(body) {
+    return this.client.request("POST", `/runtime-sessions/desktop-shell/launch-spec`, body);
+  }
+  /**
+   * Evaluate the runtime terminal permission policy for a pending CLI action.
+   * @see POST /runtime-sessions/terminal-permissions/evaluate
+   */
+  async terminalPermissionsEvaluate(body) {
+    return this.client.request("POST", `/runtime-sessions/terminal-permissions/evaluate`, body);
+  }
+  /**
+   * Resolve the CLI agent terminal launch command and working directory.
+   * @see POST /runtime-sessions/cli-agent/launch-spec
+   */
+  async cliAgentLaunchSpec(body) {
+    return this.client.request("POST", `/runtime-sessions/cli-agent/launch-spec`, body);
+  }
+  /**
+   * Create a persistent ACP-backed CLI agent runtime session.
+   * @see POST /runtime-sessions/cli-agent
+   */
+  async cliAgent(body) {
+    return this.client.request("POST", `/runtime-sessions/cli-agent`, body);
+  }
+  /**
+   * Stream a chat turn to an existing CLI agent runtime session using Server-Sent Events.
+   * @see POST /runtime-sessions/cli-agent/{sessionKey}/chat/stream
+   */
+  async cliAgentChatStream(sessionKey, body) {
+    return this.client.request("POST", `/runtime-sessions/cli-agent/${sessionKey}/chat/stream`, body);
+  }
+  /**
+   * Resolve a pending permission request for a CLI agent runtime session.
+   * @see POST /runtime-sessions/cli-agent/{sessionKey}/permission
+   */
+  async cliAgentPermission(sessionKey, body) {
+    return this.client.request("POST", `/runtime-sessions/cli-agent/${sessionKey}/permission`, body);
+  }
+  /**
+   * Cancel the current CLI turn for an active runtime session.
+   * @see POST /runtime-sessions/cli-agent/{sessionKey}/cancel
+   */
+  async cliAgentCancel(sessionKey, body) {
+    return this.client.request("POST", `/runtime-sessions/cli-agent/${sessionKey}/cancel`, body);
+  }
+  /**
+   * Close a CLI agent runtime session and clear its control-plane metadata.
+   * @see DELETE /runtime-sessions/cli-agent/{sessionKey}
+   */
+  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}`);
+  }
+};
+
 // src/v1/namespace.ts
 var V1ApiNamespace = class {
   // [GENERATED-PROPS-END]
@@ -687,6 +772,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);
   }
 };
 
@@ -816,6 +902,7 @@ async function uploadFileToFolder(client, file, folderName, options = {}) {
   V1DocumentModule,
   V1EmbedModule,
   V1OpenAIModule,
+  V1RuntimeSessionsModule,
   V1SystemModule,
   V1ThreadModule,
   V1UsersModule,

package/dist/v1/index.mjs

@@ -10,12 +10,13 @@ import {
   V1DocumentModule,
   V1EmbedModule,
   V1OpenAIModule,
+  V1RuntimeSessionsModule,
   V1SystemModule,
   V1ThreadModule,
   V1UsersModule,
   V1WorkspaceModule,
   ValidationError
-} from "../chunk-PDAMNSF2.mjs";
+} from "../chunk-YHNURPXJ.mjs";
 
 // src/v1/overrides/v1WorkspaceStreaming.ts
 async function* streamWorkspaceChat(client, slug, body) {
@@ -142,6 +143,7 @@ export {
   V1DocumentModule,
   V1EmbedModule,
   V1OpenAIModule,
+  V1RuntimeSessionsModule,
   V1SystemModule,
   V1ThreadModule,
   V1UsersModule,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "1.7.4",
+    "version": "1.7.6",
     "description": "SDK for building Local Apps that integrate with RealtimeX",
     "main": "dist/index.js",
     "module": "dist/index.mjs",
@@ -18,7 +18,7 @@
         }
     },
     "scripts": {
-        "build": "node ../scripts/generate-v1-sdk.mjs --force && node ../scripts/generate-skill.mjs --force && tsup src/index.ts src/v1/index.ts --format cjs,esm --dts --clean",
+        "build": "node ../scripts/generate-v1-sdk.mjs --force && node ../scripts/generate-concepts.mjs && node ../scripts/generate-skill.mjs --force && tsup src/index.ts src/v1/index.ts --format cjs,esm --dts --clean",
         "dev": "tsup src/index.ts src/v1/index.ts --format cjs,esm --dts --watch",
         "test": "vitest run",
         "contract:verify": "node ../scripts/verify-contract-compat.mjs",
@@ -27,6 +27,7 @@
         "sdk:generate": "node ../scripts/generate-v1-sdk.mjs",
         "sdk:generate:force": "node ../scripts/generate-v1-sdk.mjs --force",
         "sdk:diff": "node ../scripts/generate-v1-sdk.mjs --dry-run",
+        "concepts:generate": "node ../scripts/generate-concepts.mjs",
         "prepublishOnly": "npm run build"
     },
     "keywords": [

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-04-16
-sdk_version: 1.7.4
+generated: 2026-05-04
+sdk_version: 1.7.6
 ---
 
 # RealTimeX Moderator (SDK Source-Verified)
 
-Interact with the RealTimeX platform (`http://localhost:3001`) using `@realtimex/sdk` **v1.7.4**. Authentication is automatic when running inside RealtimeX.
+Interact with the RealTimeX platform (`http://localhost:3001`) using `@realtimex/sdk` **v1.7.6**. Authentication is automatic when running inside RealtimeX.
 
 `<SKILL_DIR>` below refers to the directory containing this SKILL.md.
 
@@ -44,6 +44,18 @@ Scripts using the SDK must exit explicitly — `process.exit(0)` on success, `pr
 
 ---
 
+## Runtime Sessions
+
+In this SDK, **Runtime Sessions** means the CLI Agent in **Terminal mode**. Use `sdk.agent.*` for that path.
+
+This is separate from ACP mode:
+- `sdk.agent.*` = Runtime Sessions = CLI Agent / Terminal mode
+- `sdk.acpAgent.*` = ACP-backed CLI agent sessions
+
+If a user refers to the v1/OpenAPI tag `Runtime Sessions`, interpret that as the Terminal mode session flow, not ACP.
+
+---
+
 ## ACP Session Management
 
 ACP sessions are persistent agent processes. **Always reuse sessions** across turns instead of spawning a new process for every message — it preserves context and is far more efficient.
@@ -215,7 +227,22 @@ Full fixes in `references/known-issues.md`.
 - **`resolvePermission()`** must be called while the `streamChat` SSE stream is still active
 - **SDK env vars:** `RTX_API_KEY` (dev), `RTX_APP_ID` (prod), `RTX_APP_NAME`
 
+## App Concepts
+
+When the user asks **what something is** in RealtimeX (e.g. Personality, Heartbeat, Workspace types, Agent Skills, data models), read `references/app-concepts.md` first.
+
+It covers:
+- **Personality** — file structure (AGENTS.md, SOUL.md, USER.md, IDENTITY.md, TOOLS.md, MEMORY.md, HEARTBEAT.md) and storage paths
+- **Heartbeat** — ambient background agent scheduler, config fields, calendar routines, queue
+- **Workspace** — types (`default`, `meeting_minutes`, `agent_skills`, `agent_heartbeat`), chat modes, key settings
+- **Agent Skills** — types (`repo`/`zip`), scopes, status values
+- **Data Models** — all database models with fields and defaults
+
+---
+
 ## References
 
-- `references/api-reference.md` — all class methods (auto-generated from source)
+- `references/app-concepts.md` — RealtimeX app concepts (auto-generated from source)
+- `references/api-reference.md` — all SDK class methods (auto-generated from source)
 - `references/known-issues.md` — verified source mismatches (auto-generated)
+- `references/credentials.md` — credential usage patterns