@realtimex/sdk 2.0.32 → 2.0.33

package/index.d.ts

@@ -151,6 +151,29 @@ export interface CreateChannelOptions extends RealtimeXRequestOptions {
   body?: CreateChannelBody;
 }
 
+export type CreateLocalAppParams = Record<string, never>;
+export type CreateLocalAppQuery = Record<string, never>;
+export type CreateLocalAppHeaders = Record<string, never>;
+export type CreateLocalAppBody = {
+  displayName: string;
+  description?: string;
+  sourceType: "source" | "npx" | "uvx";
+  sourcePath?: string;
+  packageInput?: string;
+  homeUrl?: string;
+  env?: {
+  [key: string]: string;
+};
+  tags?: Array<string>;
+};
+export type CreateLocalAppResponse = Record<string, unknown>;
+export interface CreateLocalAppOptions extends RealtimeXRequestOptions {
+  params?: CreateLocalAppParams;
+  query?: CreateLocalAppQuery;
+  headers?: CreateLocalAppHeaders & Record<string, string>;
+  body?: CreateLocalAppBody;
+}
+
 export type CreateThreadParams = {
   workspaceSlug: string;
 };
@@ -273,6 +296,22 @@ export interface DeleteChannelOptions extends RealtimeXRequestOptions {
   body?: DeleteChannelBody;
 }
 
+export type DeleteLocalAppParams = {
+  appId: string;
+};
+export type DeleteLocalAppQuery = Record<string, never>;
+export type DeleteLocalAppHeaders = Record<string, never>;
+export type DeleteLocalAppBody = {
+  confirmDestructive: true;
+};
+export type DeleteLocalAppResponse = Record<string, unknown>;
+export interface DeleteLocalAppOptions extends RealtimeXRequestOptions {
+  params?: DeleteLocalAppParams;
+  query?: DeleteLocalAppQuery;
+  headers?: DeleteLocalAppHeaders & Record<string, string>;
+  body?: DeleteLocalAppBody;
+}
+
 export type DeleteThreadParams = {
   workspaceSlug: string;
   threadSlug: string;
@@ -406,6 +445,50 @@ export interface GetArtifactOptions extends RealtimeXRequestOptions {
   body?: GetArtifactBody;
 }
 
+export type GetLocalAppParams = {
+  appId: string;
+};
+export type GetLocalAppQuery = Record<string, never>;
+export type GetLocalAppHeaders = Record<string, never>;
+export type GetLocalAppBody = unknown;
+export type GetLocalAppResponse = Record<string, unknown>;
+export interface GetLocalAppOptions extends RealtimeXRequestOptions {
+  params?: GetLocalAppParams;
+  query?: GetLocalAppQuery;
+  headers?: GetLocalAppHeaders & Record<string, string>;
+  body?: GetLocalAppBody;
+}
+
+export type GetLocalAppLogsParams = {
+  appId: string;
+};
+export type GetLocalAppLogsQuery = {
+  limit?: number;
+};
+export type GetLocalAppLogsHeaders = Record<string, never>;
+export type GetLocalAppLogsBody = unknown;
+export type GetLocalAppLogsResponse = Record<string, unknown>;
+export interface GetLocalAppLogsOptions extends RealtimeXRequestOptions {
+  params?: GetLocalAppLogsParams;
+  query?: GetLocalAppLogsQuery;
+  headers?: GetLocalAppLogsHeaders & Record<string, string>;
+  body?: GetLocalAppLogsBody;
+}
+
+export type GetLocalAppStatusParams = {
+  appId: string;
+};
+export type GetLocalAppStatusQuery = Record<string, never>;
+export type GetLocalAppStatusHeaders = Record<string, never>;
+export type GetLocalAppStatusBody = unknown;
+export type GetLocalAppStatusResponse = Record<string, unknown>;
+export interface GetLocalAppStatusOptions extends RealtimeXRequestOptions {
+  params?: GetLocalAppStatusParams;
+  query?: GetLocalAppStatusQuery;
+  headers?: GetLocalAppStatusHeaders & Record<string, string>;
+  body?: GetLocalAppStatusBody;
+}
+
 export type GetPluginParams = {
   pluginId: string;
 };
@@ -612,6 +695,18 @@ export interface ListLlmProvidersOptions extends RealtimeXRequestOptions {
   body?: ListLlmProvidersBody;
 }
 
+export type ListLocalAppsParams = Record<string, never>;
+export type ListLocalAppsQuery = Record<string, never>;
+export type ListLocalAppsHeaders = Record<string, never>;
+export type ListLocalAppsBody = unknown;
+export type ListLocalAppsResponse = Record<string, unknown>;
+export interface ListLocalAppsOptions extends RealtimeXRequestOptions {
+  params?: ListLocalAppsParams;
+  query?: ListLocalAppsQuery;
+  headers?: ListLocalAppsHeaders & Record<string, string>;
+  body?: ListLocalAppsBody;
+}
+
 export type ListPluginsParams = Record<string, never>;
 export type ListPluginsQuery = Record<string, never>;
 export type ListPluginsHeaders = {
@@ -950,6 +1045,20 @@ export interface RespondTerminalIdlePromptOptions extends RealtimeXRequestOption
   body?: RespondTerminalIdlePromptBody;
 }
 
+export type RestartLocalAppParams = {
+  appId: string;
+};
+export type RestartLocalAppQuery = Record<string, never>;
+export type RestartLocalAppHeaders = Record<string, never>;
+export type RestartLocalAppBody = unknown;
+export type RestartLocalAppResponse = Record<string, unknown>;
+export interface RestartLocalAppOptions extends RealtimeXRequestOptions {
+  params?: RestartLocalAppParams;
+  query?: RestartLocalAppQuery;
+  headers?: RestartLocalAppHeaders & Record<string, string>;
+  body?: RestartLocalAppBody;
+}
+
 export type ResumeArtifactParams = {
   artifactId: string;
 };
@@ -1270,6 +1379,22 @@ export interface SetHeartbeatTimezoneOptions extends RealtimeXRequestOptions {
   body?: SetHeartbeatTimezoneBody;
 }
 
+export type SetLocalAppEnabledParams = {
+  appId: string;
+};
+export type SetLocalAppEnabledQuery = Record<string, never>;
+export type SetLocalAppEnabledHeaders = Record<string, never>;
+export type SetLocalAppEnabledBody = {
+  enabled: boolean;
+};
+export type SetLocalAppEnabledResponse = Record<string, unknown>;
+export interface SetLocalAppEnabledOptions extends RealtimeXRequestOptions {
+  params?: SetLocalAppEnabledParams;
+  query?: SetLocalAppEnabledQuery;
+  headers?: SetLocalAppEnabledHeaders & Record<string, string>;
+  body?: SetLocalAppEnabledBody;
+}
+
 export type SetupHeartbeatTasksParams = Record<string, never>;
 export type SetupHeartbeatTasksQuery = {
   workspaceSlug?: string;
@@ -1407,6 +1532,20 @@ export interface StartChannelOptions extends RealtimeXRequestOptions {
   body?: StartChannelBody;
 }
 
+export type StartLocalAppParams = {
+  appId: string;
+};
+export type StartLocalAppQuery = Record<string, never>;
+export type StartLocalAppHeaders = Record<string, never>;
+export type StartLocalAppBody = unknown;
+export type StartLocalAppResponse = Record<string, unknown>;
+export interface StartLocalAppOptions extends RealtimeXRequestOptions {
+  params?: StartLocalAppParams;
+  query?: StartLocalAppQuery;
+  headers?: StartLocalAppHeaders & Record<string, string>;
+  body?: StartLocalAppBody;
+}
+
 export type StopBrowserSessionParams = {
   sessionName: string;
 };
@@ -1441,6 +1580,22 @@ export interface StopChannelOptions extends RealtimeXRequestOptions {
   body?: StopChannelBody;
 }
 
+export type StopLocalAppParams = {
+  appId: string;
+};
+export type StopLocalAppQuery = Record<string, never>;
+export type StopLocalAppHeaders = Record<string, never>;
+export type StopLocalAppBody = {
+  force?: boolean;
+};
+export type StopLocalAppResponse = Record<string, unknown>;
+export interface StopLocalAppOptions extends RealtimeXRequestOptions {
+  params?: StopLocalAppParams;
+  query?: StopLocalAppQuery;
+  headers?: StopLocalAppHeaders & Record<string, string>;
+  body?: StopLocalAppBody;
+}
+
 export type StopThreadTerminalSessionParams = Record<string, never>;
 export type StopThreadTerminalSessionQuery = Record<string, never>;
 export type StopThreadTerminalSessionHeaders = {
@@ -1547,6 +1702,27 @@ export interface UpdateChannelOptions extends RealtimeXRequestOptions {
   body?: UpdateChannelBody;
 }
 
+export type UpdateLocalAppParams = {
+  appId: string;
+};
+export type UpdateLocalAppQuery = Record<string, never>;
+export type UpdateLocalAppHeaders = Record<string, never>;
+export type UpdateLocalAppBody = {
+  displayName?: string;
+  description?: string;
+  homeUrl?: string;
+  env?: {
+  [key: string]: string;
+};
+};
+export type UpdateLocalAppResponse = Record<string, unknown>;
+export interface UpdateLocalAppOptions extends RealtimeXRequestOptions {
+  params?: UpdateLocalAppParams;
+  query?: UpdateLocalAppQuery;
+  headers?: UpdateLocalAppHeaders & Record<string, string>;
+  body?: UpdateLocalAppBody;
+}
+
 export type UpdateWebhookEndpointParams = {
   endpointId: string;
 };
@@ -1706,6 +1882,8 @@ export declare class RealtimeXClient {
   /** Create a chat channel in one exact workspace. Defaults to Telegram when plugin_type, channelType, and type are omitted. Use flat botToken and thread_id fields instead of nested config/settings. */
   createChannel(options?: CreateChannelOptions): Promise<CreateChannelResponse>;
   createChannel(workspaceSlug: string, body: CreateChannelBody, options?: Omit<CreateChannelOptions, 'params' | 'body'>): Promise<CreateChannelResponse>;
+  createLocalApp(options?: CreateLocalAppOptions): Promise<CreateLocalAppResponse>;
+  createLocalApp(body: CreateLocalAppBody, options?: Omit<CreateLocalAppOptions, 'body'>): Promise<CreateLocalAppResponse>;
   /** Create a thread in one workspace. The name is optional but recommended. */
   createThread(options?: CreateThreadOptions): Promise<CreateThreadResponse>;
   createThread(workspaceSlug: string, body: CreateThreadBody, options?: Omit<CreateThreadOptions, 'params' | 'body'>): Promise<CreateThreadResponse>;
@@ -1724,6 +1902,8 @@ export declare class RealtimeXClient {
   /** Delete one chat channel by exact channel id. */
   deleteChannel(options?: DeleteChannelOptions): Promise<DeleteChannelResponse>;
   deleteChannel(channelId: string, options?: Omit<DeleteChannelOptions, 'params'>): Promise<DeleteChannelResponse>;
+  deleteLocalApp(options?: DeleteLocalAppOptions): Promise<DeleteLocalAppResponse>;
+  deleteLocalApp(appId: string, body: DeleteLocalAppBody, options?: Omit<DeleteLocalAppOptions, 'params' | 'body'>): Promise<DeleteLocalAppResponse>;
   /** Delete one thread by exact workspace slug and exact thread slug. */
   deleteThread(options?: DeleteThreadOptions): Promise<DeleteThreadResponse>;
   deleteThread(params: DeleteThreadParams, options?: Omit<DeleteThreadOptions, 'params'>): Promise<DeleteThreadResponse>;
@@ -1748,6 +1928,13 @@ export declare class RealtimeXClient {
   /** Get one public artifact by artifact id. */
   getArtifact(options?: GetArtifactOptions): Promise<GetArtifactResponse>;
   getArtifact(artifactId: string, options?: Omit<GetArtifactOptions, 'params'>): Promise<GetArtifactResponse>;
+  getLocalApp(options?: GetLocalAppOptions): Promise<GetLocalAppResponse>;
+  getLocalApp(appId: string, options?: Omit<GetLocalAppOptions, 'params'>): Promise<GetLocalAppResponse>;
+  /** Read bounded recent desktop logs. Each entry is capped at 4 KiB and secret-bearing configuration is omitted. */
+  getLocalAppLogs(options?: GetLocalAppLogsOptions): Promise<GetLocalAppLogsResponse>;
+  getLocalAppLogs(appId: string, options?: Omit<GetLocalAppLogsOptions, 'params'>): Promise<GetLocalAppLogsResponse>;
+  getLocalAppStatus(options?: GetLocalAppStatusOptions): Promise<GetLocalAppStatusResponse>;
+  getLocalAppStatus(appId: string, options?: Omit<GetLocalAppStatusOptions, 'params'>): Promise<GetLocalAppStatusResponse>;
   /** Get one installed plugin with its config schema (keys, labels, types, defaults) and current non-secret configuration values. Secret (password-type) values are never returned; secretConfigState reports whether each one is set. Use a plugin id, name, or displayName from list-plugins. */
   getPlugin(options?: GetPluginOptions): Promise<GetPluginResponse>;
   getPlugin(pluginId: string, options?: Omit<GetPluginOptions, 'params'>): Promise<GetPluginResponse>;
@@ -1783,6 +1970,7 @@ export declare class RealtimeXClient {
   listLlmModels(provider: string, options?: Omit<ListLlmModelsOptions, 'params'>): Promise<ListLlmModelsResponse>;
   /** List supported LLM providers. Use provider ids from this response when configuring workspace or thread LLM settings. */
   listLlmProviders(options?: ListLlmProvidersOptions): Promise<ListLlmProvidersResponse>;
+  listLocalApps(options?: ListLocalAppsOptions): Promise<ListLocalAppsResponse>;
   /** List installed plugins with enabled state and runtime load status. Use returned ids with enable-plugin, disable-plugin, and reload-plugin. */
   listPlugins(options?: ListPluginsOptions): Promise<ListPluginsResponse>;
   /** List terminal CLI agents that can be used with open-terminal-session. This is the same compact agent catalog returned by prepare.agents. */
@@ -1833,6 +2021,8 @@ export declare class RealtimeXClient {
   /** Send one constrained response action to an exact idle terminal session only when its PTY event sequence is unchanged. */
   respondTerminalIdlePrompt(options?: RespondTerminalIdlePromptOptions): Promise<RespondTerminalIdlePromptResponse>;
   respondTerminalIdlePrompt(sessionId: string, body: RespondTerminalIdlePromptBody, options?: Omit<RespondTerminalIdlePromptOptions, 'params' | 'body'>): Promise<RespondTerminalIdlePromptResponse>;
+  restartLocalApp(options?: RestartLocalAppOptions): Promise<RestartLocalAppResponse>;
+  restartLocalApp(appId: string, body: RestartLocalAppBody, options?: Omit<RestartLocalAppOptions, 'params' | 'body'>): Promise<RestartLocalAppResponse>;
   /** Resume one paused artifact by artifact id. */
   resumeArtifact(options?: ResumeArtifactOptions): Promise<ResumeArtifactResponse>;
   resumeArtifact(artifactId: string, options?: Omit<ResumeArtifactOptions, 'params'>): Promise<ResumeArtifactResponse>;
@@ -1881,6 +2071,8 @@ export declare class RealtimeXClient {
   /** Set workspace or global ambient-agent heartbeat timezone, for example Asia/Saigon or UTC. */
   setHeartbeatTimezone(options?: SetHeartbeatTimezoneOptions): Promise<SetHeartbeatTimezoneResponse>;
   setHeartbeatTimezone(body: SetHeartbeatTimezoneBody, options?: Omit<SetHeartbeatTimezoneOptions, 'body'>): Promise<SetHeartbeatTimezoneResponse>;
+  setLocalAppEnabled(options?: SetLocalAppEnabledOptions): Promise<SetLocalAppEnabledResponse>;
+  setLocalAppEnabled(appId: string, body: SetLocalAppEnabledBody, options?: Omit<SetLocalAppEnabledOptions, 'params' | 'body'>): Promise<SetLocalAppEnabledResponse>;
   /** Set up HEARTBEAT.md task instructions for a workspace or global ambient agent. Returns the target path, template, file path, and concise editing instructions. */
   setupHeartbeatTasks(options?: SetupHeartbeatTasksOptions): Promise<SetupHeartbeatTasksResponse>;
   setupHeartbeatTasks(query?: SetupHeartbeatTasksQuery, options?: Omit<SetupHeartbeatTasksOptions, 'query'>): Promise<SetupHeartbeatTasksResponse>;
@@ -1899,12 +2091,16 @@ export declare class RealtimeXClient {
   /** Start one chat channel by exact channel id. */
   startChannel(options?: StartChannelOptions): Promise<StartChannelResponse>;
   startChannel(channelId: string, options?: Omit<StartChannelOptions, 'params'>): Promise<StartChannelResponse>;
+  startLocalApp(options?: StartLocalAppOptions): Promise<StartLocalAppResponse>;
+  startLocalApp(appId: string, body: StartLocalAppBody, options?: Omit<StartLocalAppOptions, 'params' | 'body'>): Promise<StartLocalAppResponse>;
   /** Gracefully stop an existing named RealTimeX Browser session. */
   stopBrowserSession(options?: StopBrowserSessionOptions): Promise<StopBrowserSessionResponse>;
   stopBrowserSession(sessionName: string, body: StopBrowserSessionBody, options?: Omit<StopBrowserSessionOptions, 'params' | 'body'>): Promise<StopBrowserSessionResponse>;
   /** Stop one chat channel by exact channel id. */
   stopChannel(options?: StopChannelOptions): Promise<StopChannelResponse>;
   stopChannel(channelId: string, options?: Omit<StopChannelOptions, 'params'>): Promise<StopChannelResponse>;
+  stopLocalApp(options?: StopLocalAppOptions): Promise<StopLocalAppResponse>;
+  stopLocalApp(appId: string, body: StopLocalAppBody, options?: Omit<StopLocalAppOptions, 'params' | 'body'>): Promise<StopLocalAppResponse>;
   /** Interrupt the selected or current chat-linked terminal session for one exact thread without closing the underlying terminal session. This uses the same stop dispatcher as channel /stop commands. */
   stopThreadTerminalSession(options?: StopThreadTerminalSessionOptions): Promise<StopThreadTerminalSessionResponse>;
   /** Terminate a terminal runtime session by detaching any controller and closing the underlying PTY session. */
@@ -1922,6 +2118,8 @@ export declare class RealtimeXClient {
   /** Update one chat channel by exact channel id. Only channel writable fields are changed. */
   updateChannel(options?: UpdateChannelOptions): Promise<UpdateChannelResponse>;
   updateChannel(channelId: string, body: UpdateChannelBody, options?: Omit<UpdateChannelOptions, 'params' | 'body'>): Promise<UpdateChannelResponse>;
+  updateLocalApp(options?: UpdateLocalAppOptions): Promise<UpdateLocalAppResponse>;
+  updateLocalApp(appId: string, body: UpdateLocalAppBody, options?: Omit<UpdateLocalAppOptions, 'params' | 'body'>): Promise<UpdateLocalAppResponse>;
   /** Update a visible webhook endpoint. Passing secret rotates it; the value is never returned. */
   updateWebhookEndpoint(options?: UpdateWebhookEndpointOptions): Promise<UpdateWebhookEndpointResponse>;
   updateWebhookEndpoint(endpointId: string, body: UpdateWebhookEndpointBody, options?: Omit<UpdateWebhookEndpointOptions, 'params' | 'body'>): Promise<UpdateWebhookEndpointResponse>;

package/index.js

@@ -70,6 +70,14 @@ const operations = {
     ],
     "hasBody": true
   },
+  "createLocalApp": {
+    "method": "POST",
+    "path": "/create-local-app",
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [],
+    "hasBody": true
+  },
   "createThread": {
     "method": "POST",
     "path": "/create-thread/{workspaceSlug}",
@@ -137,6 +145,16 @@ const operations = {
     ],
     "hasBody": false
   },
+  "deleteLocalApp": {
+    "method": "DELETE",
+    "path": "/delete-local-app/{appId}",
+    "pathParams": [
+      "appId"
+    ],
+    "queryParams": [],
+    "headerParams": [],
+    "hasBody": true
+  },
   "deleteThread": {
     "method": "DELETE",
     "path": "/delete-thread/{workspaceSlug}/{threadSlug}",
@@ -236,6 +254,38 @@ const operations = {
     ],
     "hasBody": false
   },
+  "getLocalApp": {
+    "method": "GET",
+    "path": "/get-local-app/{appId}",
+    "pathParams": [
+      "appId"
+    ],
+    "queryParams": [],
+    "headerParams": [],
+    "hasBody": false
+  },
+  "getLocalAppLogs": {
+    "method": "GET",
+    "path": "/get-local-app-logs/{appId}",
+    "pathParams": [
+      "appId"
+    ],
+    "queryParams": [
+      "limit"
+    ],
+    "headerParams": [],
+    "hasBody": false
+  },
+  "getLocalAppStatus": {
+    "method": "GET",
+    "path": "/get-local-app-status/{appId}",
+    "pathParams": [
+      "appId"
+    ],
+    "queryParams": [],
+    "headerParams": [],
+    "hasBody": false
+  },
   "getPlugin": {
     "method": "GET",
     "path": "/get-plugin/{pluginId}",
@@ -380,6 +430,14 @@ const operations = {
     ],
     "hasBody": false
   },
+  "listLocalApps": {
+    "method": "GET",
+    "path": "/list-local-apps",
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [],
+    "hasBody": false
+  },
   "listPlugins": {
     "method": "GET",
     "path": "/list-plugins",
@@ -589,6 +647,16 @@ const operations = {
     ],
     "hasBody": true
   },
+  "restartLocalApp": {
+    "method": "POST",
+    "path": "/restart-local-app/{appId}",
+    "pathParams": [
+      "appId"
+    ],
+    "queryParams": [],
+    "headerParams": [],
+    "hasBody": true
+  },
   "resumeArtifact": {
     "method": "POST",
     "path": "/resume-artifact/{artifactId}",
@@ -760,6 +828,16 @@ const operations = {
     ],
     "hasBody": true
   },
+  "setLocalAppEnabled": {
+    "method": "POST",
+    "path": "/set-local-app-enabled/{appId}",
+    "pathParams": [
+      "appId"
+    ],
+    "queryParams": [],
+    "headerParams": [],
+    "hasBody": true
+  },
   "setupHeartbeatTasks": {
     "method": "GET",
     "path": "/setup-heartbeat-tasks",
@@ -831,6 +909,16 @@ const operations = {
     ],
     "hasBody": false
   },
+  "startLocalApp": {
+    "method": "POST",
+    "path": "/start-local-app/{appId}",
+    "pathParams": [
+      "appId"
+    ],
+    "queryParams": [],
+    "headerParams": [],
+    "hasBody": true
+  },
   "stopBrowserSession": {
     "method": "POST",
     "path": "/stop-browser-session/{sessionName}",
@@ -855,6 +943,16 @@ const operations = {
     ],
     "hasBody": false
   },
+  "stopLocalApp": {
+    "method": "POST",
+    "path": "/stop-local-app/{appId}",
+    "pathParams": [
+      "appId"
+    ],
+    "queryParams": [],
+    "headerParams": [],
+    "hasBody": true
+  },
   "stopThreadTerminalSession": {
     "method": "POST",
     "path": "/stop-thread-terminal-session",
@@ -923,6 +1021,16 @@ const operations = {
     ],
     "hasBody": true
   },
+  "updateLocalApp": {
+    "method": "POST",
+    "path": "/update-local-app/{appId}",
+    "pathParams": [
+      "appId"
+    ],
+    "queryParams": [],
+    "headerParams": [],
+    "hasBody": true
+  },
   "updateWebhookEndpoint": {
     "method": "POST",
     "path": "/update-webhook-endpoint/{endpointId}",
@@ -1408,6 +1516,13 @@ class RealtimeXClient {
     );
   }
 
+  createLocalApp(...args) {
+    return this.request(
+      "createLocalApp",
+      normalizeOperationOptions(operations["createLocalApp"], args)
+    );
+  }
+
   createThread(...args) {
     return this.request(
       "createThread",
@@ -1450,6 +1565,13 @@ class RealtimeXClient {
     );
   }
 
+  deleteLocalApp(...args) {
+    return this.request(
+      "deleteLocalApp",
+      normalizeOperationOptions(operations["deleteLocalApp"], args)
+    );
+  }
+
   deleteThread(...args) {
     return this.request(
       "deleteThread",
@@ -1506,6 +1628,27 @@ class RealtimeXClient {
     );
   }
 
+  getLocalApp(...args) {
+    return this.request(
+      "getLocalApp",
+      normalizeOperationOptions(operations["getLocalApp"], args)
+    );
+  }
+
+  getLocalAppLogs(...args) {
+    return this.request(
+      "getLocalAppLogs",
+      normalizeOperationOptions(operations["getLocalAppLogs"], args)
+    );
+  }
+
+  getLocalAppStatus(...args) {
+    return this.request(
+      "getLocalAppStatus",
+      normalizeOperationOptions(operations["getLocalAppStatus"], args)
+    );
+  }
+
   getPlugin(...args) {
     return this.request(
       "getPlugin",
@@ -1597,6 +1740,13 @@ class RealtimeXClient {
     );
   }
 
+  listLocalApps(...args) {
+    return this.request(
+      "listLocalApps",
+      normalizeOperationOptions(operations["listLocalApps"], args)
+    );
+  }
+
   listPlugins(...args) {
     return this.request(
       "listPlugins",
@@ -1723,6 +1873,13 @@ class RealtimeXClient {
     );
   }
 
+  restartLocalApp(...args) {
+    return this.request(
+      "restartLocalApp",
+      normalizeOperationOptions(operations["restartLocalApp"], args)
+    );
+  }
+
   resumeArtifact(...args) {
     return this.request(
       "resumeArtifact",
@@ -1835,6 +1992,13 @@ class RealtimeXClient {
     );
   }
 
+  setLocalAppEnabled(...args) {
+    return this.request(
+      "setLocalAppEnabled",
+      normalizeOperationOptions(operations["setLocalAppEnabled"], args)
+    );
+  }
+
   setupHeartbeatTasks(...args) {
     return this.request(
       "setupHeartbeatTasks",
@@ -1877,6 +2041,13 @@ class RealtimeXClient {
     );
   }
 
+  startLocalApp(...args) {
+    return this.request(
+      "startLocalApp",
+      normalizeOperationOptions(operations["startLocalApp"], args)
+    );
+  }
+
   stopBrowserSession(...args) {
     return this.request(
       "stopBrowserSession",
@@ -1891,6 +2062,13 @@ class RealtimeXClient {
     );
   }
 
+  stopLocalApp(...args) {
+    return this.request(
+      "stopLocalApp",
+      normalizeOperationOptions(operations["stopLocalApp"], args)
+    );
+  }
+
   stopThreadTerminalSession(...args) {
     return this.request(
       "stopThreadTerminalSession",
@@ -1933,6 +2111,13 @@ class RealtimeXClient {
     );
   }
 
+  updateLocalApp(...args) {
+    return this.request(
+      "updateLocalApp",
+      normalizeOperationOptions(operations["updateLocalApp"], args)
+    );
+  }
+
   updateWebhookEndpoint(...args) {
     return this.request(
       "updateWebhookEndpoint",
@@ -1965,5 +2150,5 @@ module.exports = {
   createRealtimeXClient,
   createRealtimeXWebhookClient,
   operations,
-  version: "2.0.32",
+  version: "2.0.33",
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "2.0.32",
+    "version": "2.0.33",
     "description": "RealtimeX runtime SDK package and moderator agent skill assets.",
     "private": false,
     "main": "./index.js",

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

@@ -20,15 +20,15 @@ This skill drives the `realtimex-pp-cli` binary. Verify the CLI is installed and
 
 1. Install or reinstall the pinned version via npm:
    ```bash
-   npm install -g @realtimex/pp-cli@2.0.32
+   npm install -g @realtimex/pp-cli@2.0.33
    ```
 2. Verify the exact version:
    ```bash
    realtimex-pp-cli --version
    ```
-   The output must be `realtimex-pp-cli 2.0.32`.
+   The output must be `realtimex-pp-cli 2.0.33`.
 
-If `--version` reports "command not found" after install, the npm global bin directory is not on `$PATH`. If it reports any version other than `2.0.32`, reinstall with the pinned npm command above. Do not proceed with skill commands until exact-version verification succeeds.
+If `--version` reports "command not found" after install, the npm global bin directory is not on `$PATH`. If it reports any version other than `2.0.33`, reinstall with the pinned npm command above. Do not proceed with skill commands until exact-version verification succeeds.
 
 * Always run first:
 
@@ -62,6 +62,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli create-channel <workspaceSlug>` — Create a chat channel in one exact workspace. Defaults to Telegram when plugin_type, channelType, and type are omitted.
 
+**create-local-app** — Manage create local app
+
+- `realtimex-pp-cli create-local-app` — Create local app
+
 **create-thread** — Manage create thread
 
 - `realtimex-pp-cli create-thread <workspaceSlug>` — Create a thread in one workspace. The name is optional but recommended.
@@ -86,6 +90,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli delete-channel <channelId>` — Delete one chat channel by exact channel id.
 
+**delete-local-app** — Manage delete local app
+
+- `realtimex-pp-cli delete-local-app <appId>` — Delete local app
+
 **delete-thread** — Manage delete thread
 
 - `realtimex-pp-cli delete-thread <workspaceSlug> <threadSlug>` — Delete one thread by exact workspace slug and exact thread slug.
@@ -118,6 +126,18 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli get-artifact <artifactId>` — Get one public artifact by artifact id.
 
+**get-local-app** — Manage get local app
+
+- `realtimex-pp-cli get-local-app <appId>` — Get local app
+
+**get-local-app-logs** — Manage get local app logs
+
+- `realtimex-pp-cli get-local-app-logs <appId>` — Read bounded recent desktop logs. Each entry is capped at 4 KiB and secret-bearing configuration is omitted.
+
+**get-local-app-status** — Manage get local app status
+
+- `realtimex-pp-cli get-local-app-status <appId>` — Get local app status
+
 **get-plugin** — Manage get plugin
 
 - `realtimex-pp-cli get-plugin <pluginId>` — Get one installed plugin with its config schema (keys, labels, types, defaults)
@@ -170,6 +190,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli list-llm-providers` — List supported LLM providers. Use provider ids from this response when configuring workspace or thread LLM settings.
 
+**list-local-apps** — Manage list local apps
+
+- `realtimex-pp-cli list-local-apps` — List local apps
+
 **list-plugins** — Manage list plugins
 
 - `realtimex-pp-cli list-plugins` — List installed plugins with enabled state and runtime load status.
@@ -242,6 +266,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli respond-terminal-idle-prompt <sessionId>` — Send one constrained response action to an exact idle terminal session only when its PTY event sequence is unchanged.
 
+**restart-local-app** — Manage restart local app
+
+- `realtimex-pp-cli restart-local-app <appId>` — Restart local app
+
 **resume-artifact** — Manage resume artifact
 
 - `realtimex-pp-cli resume-artifact <artifactId>` — Resume one paused artifact by artifact id.
@@ -302,6 +330,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli set-heartbeat-timezone` — Set workspace or global ambient-agent heartbeat timezone, for example Asia/Saigon or UTC.
 
+**set-local-app-enabled** — Manage set local app enabled
+
+- `realtimex-pp-cli set-local-app-enabled <appId>` — Set local app enabled
+
 **set-workspace-default-agent** — Manage set workspace default agent
 
 - `realtimex-pp-cli set-workspace-default-agent <workspaceSlug>` — Set the default CLI agent for a workspace.
@@ -326,6 +358,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli start-channel <channelId>` — Start one chat channel by exact channel id.
 
+**start-local-app** — Manage start local app
+
+- `realtimex-pp-cli start-local-app <appId>` — Start local app
+
 **stop-browser-session** — Manage stop browser session
 
 - `realtimex-pp-cli stop-browser-session <sessionName>` — Gracefully stop an existing named RealTimeX Browser session.
@@ -334,6 +370,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli stop-channel <channelId>` — Stop one chat channel by exact channel id.
 
+**stop-local-app** — Manage stop local app
+
+- `realtimex-pp-cli stop-local-app <appId>` — Stop local app
+
 **stop-thread-terminal-session** — Manage stop thread terminal session
 
 - `realtimex-pp-cli stop-thread-terminal-session` — Interrupt the selected or current chat-linked terminal session for one exact thread without closing the underlying
@@ -358,6 +398,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli update-channel <channelId>` — Update one chat channel by exact channel id. Only channel writable fields are changed.
 
+**update-local-app** — Manage update local app
+
+- `realtimex-pp-cli update-local-app <appId>` — Update local app
+
 **update-webhook-endpoint** — Manage update webhook endpoint
 
 - `realtimex-pp-cli update-webhook-endpoint <endpointId>` — Update a visible webhook endpoint. Passing secret rotates it; the value is never returned.
@@ -492,9 +536,9 @@ Verify: `claude mcp list`
    ```bash
    realtimex-pp-cli --version
    ```
-   If the command is missing or the output is not exactly `realtimex-pp-cli 2.0.32`, reinstall the pinned version:
+   If the command is missing or the output is not exactly `realtimex-pp-cli 2.0.33`, reinstall the pinned version:
    ```bash
-   npm install -g @realtimex/pp-cli@2.0.32
+   npm install -g @realtimex/pp-cli@2.0.33
    ```
    Then run `realtimex-pp-cli --version` again and proceed only after exact-version verification succeeds.
 2. Match the user query to the best command from the Unique Capabilities and Command Reference above.