@realtimex/sdk 2.0.25 → 2.0.26

package/index.d.ts

@@ -101,6 +101,26 @@ export interface ConfigurePluginOptions extends RealtimeXRequestOptions {
   body?: ConfigurePluginBody;
 }
 
+export type CreateBrowserSessionParams = Record<string, never>;
+export type CreateBrowserSessionQuery = Record<string, never>;
+export type CreateBrowserSessionHeaders = {
+  "x-app-id"?: string;
+};
+export type CreateBrowserSessionBody = {
+  sessionName: string;
+  url?: string;
+  remoteDebugPort?: number;
+  guardrails?: Record<string, unknown>;
+  origin?: string;
+};
+export type CreateBrowserSessionResponse = Record<string, unknown>;
+export interface CreateBrowserSessionOptions extends RealtimeXRequestOptions {
+  params?: CreateBrowserSessionParams;
+  query?: CreateBrowserSessionQuery;
+  headers?: CreateBrowserSessionHeaders & Record<string, string>;
+  body?: CreateBrowserSessionBody;
+}
+
 export type CreateChannelParams = {
   workspaceSlug: string;
 };
@@ -186,6 +206,22 @@ export interface CreateWorkspaceAgentSkillOptions extends RealtimeXRequestOption
   body?: CreateWorkspaceAgentSkillBody;
 }
 
+export type DeleteBrowserSessionParams = {
+  sessionName: string;
+};
+export type DeleteBrowserSessionQuery = Record<string, never>;
+export type DeleteBrowserSessionHeaders = {
+  "x-app-id"?: string;
+};
+export type DeleteBrowserSessionBody = unknown;
+export type DeleteBrowserSessionResponse = Record<string, unknown>;
+export interface DeleteBrowserSessionOptions extends RealtimeXRequestOptions {
+  params?: DeleteBrowserSessionParams;
+  query?: DeleteBrowserSessionQuery;
+  headers?: DeleteBrowserSessionHeaders & Record<string, string>;
+  body?: DeleteBrowserSessionBody;
+}
+
 export type DeleteChannelParams = {
   channelId: string;
 };
@@ -335,6 +371,25 @@ export interface GetPluginOptions extends RealtimeXRequestOptions {
   body?: GetPluginBody;
 }
 
+export type GetTerminalSessionContextParams = {
+  sessionId: string;
+};
+export type GetTerminalSessionContextQuery = {
+  maxChars?: number;
+  afterSeq?: number;
+};
+export type GetTerminalSessionContextHeaders = {
+  "x-app-id"?: string;
+};
+export type GetTerminalSessionContextBody = unknown;
+export type GetTerminalSessionContextResponse = Record<string, unknown>;
+export interface GetTerminalSessionContextOptions extends RealtimeXRequestOptions {
+  params?: GetTerminalSessionContextParams;
+  query?: GetTerminalSessionContextQuery;
+  headers?: GetTerminalSessionContextHeaders & Record<string, string>;
+  body?: GetTerminalSessionContextBody;
+}
+
 export type GetThreadParams = {
   workspaceSlug: string;
   threadSlug: string;
@@ -415,6 +470,20 @@ export interface ListArtifactsOptions extends RealtimeXRequestOptions {
   body?: ListArtifactsBody;
 }
 
+export type ListBrowserSessionsParams = Record<string, never>;
+export type ListBrowserSessionsQuery = Record<string, never>;
+export type ListBrowserSessionsHeaders = {
+  "x-app-id"?: string;
+};
+export type ListBrowserSessionsBody = unknown;
+export type ListBrowserSessionsResponse = Record<string, unknown>;
+export interface ListBrowserSessionsOptions extends RealtimeXRequestOptions {
+  params?: ListBrowserSessionsParams;
+  query?: ListBrowserSessionsQuery;
+  headers?: ListBrowserSessionsHeaders & Record<string, string>;
+  body?: ListBrowserSessionsBody;
+}
+
 export type ListChannelsParams = Record<string, never>;
 export type ListChannelsQuery = Record<string, never>;
 export type ListChannelsHeaders = {
@@ -1171,6 +1240,24 @@ export interface SetWorkspaceDefaultAgentOptions extends RealtimeXRequestOptions
   body?: SetWorkspaceDefaultAgentBody;
 }
 
+export type StartBrowserSessionParams = {
+  sessionName: string;
+};
+export type StartBrowserSessionQuery = Record<string, never>;
+export type StartBrowserSessionHeaders = {
+  "x-app-id"?: string;
+};
+export type StartBrowserSessionBody = {
+  url?: string;
+};
+export type StartBrowserSessionResponse = Record<string, unknown>;
+export interface StartBrowserSessionOptions extends RealtimeXRequestOptions {
+  params?: StartBrowserSessionParams;
+  query?: StartBrowserSessionQuery;
+  headers?: StartBrowserSessionHeaders & Record<string, string>;
+  body?: StartBrowserSessionBody;
+}
+
 export type StartChannelParams = {
   channelId: string;
 };
@@ -1187,6 +1274,24 @@ export interface StartChannelOptions extends RealtimeXRequestOptions {
   body?: StartChannelBody;
 }
 
+export type StopBrowserSessionParams = {
+  sessionName: string;
+};
+export type StopBrowserSessionQuery = Record<string, never>;
+export type StopBrowserSessionHeaders = {
+  "x-app-id"?: string;
+};
+export type StopBrowserSessionBody = {
+  timeoutMs?: number;
+};
+export type StopBrowserSessionResponse = Record<string, unknown>;
+export interface StopBrowserSessionOptions extends RealtimeXRequestOptions {
+  params?: StopBrowserSessionParams;
+  query?: StopBrowserSessionQuery;
+  headers?: StopBrowserSessionHeaders & Record<string, string>;
+  body?: StopBrowserSessionBody;
+}
+
 export type StopChannelParams = {
   channelId: string;
 };
@@ -1353,6 +1458,9 @@ export declare class RealtimeXClient {
   /** Set non-secret configuration values for one installed plugin. Use a plugin id, name, or displayName from list-plugins. Password-type fields are refused and reported back for manual setup in the desktop settings UI. */
   configurePlugin(options?: ConfigurePluginOptions): Promise<ConfigurePluginResponse>;
   configurePlugin(pluginId: string, body: ConfigurePluginBody, options?: Omit<ConfigurePluginOptions, 'params' | 'body'>): Promise<ConfigurePluginResponse>;
+  /** Create an isolated named RealTimeX Browser session. When url is supplied, start the session and open that URL. */
+  createBrowserSession(options?: CreateBrowserSessionOptions): Promise<CreateBrowserSessionResponse>;
+  createBrowserSession(body: CreateBrowserSessionBody, options?: Omit<CreateBrowserSessionOptions, 'body'>): Promise<CreateBrowserSessionResponse>;
   /** 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>;
@@ -1365,6 +1473,9 @@ export declare class RealtimeXClient {
   /** Create a managed agent skill owned by one workspace. Terminal agents should use this instead of writing final skill content into runtime skill directories. */
   createWorkspaceAgentSkill(options?: CreateWorkspaceAgentSkillOptions): Promise<CreateWorkspaceAgentSkillResponse>;
   createWorkspaceAgentSkill(workspaceSlug: string, body: CreateWorkspaceAgentSkillBody, options?: Omit<CreateWorkspaceAgentSkillOptions, 'params' | 'body'>): Promise<CreateWorkspaceAgentSkillResponse>;
+  /** Delete a stopped named RealTimeX Browser session and its isolated profile. */
+  deleteBrowserSession(options?: DeleteBrowserSessionOptions): Promise<DeleteBrowserSessionResponse>;
+  deleteBrowserSession(sessionName: string, options?: Omit<DeleteBrowserSessionOptions, 'params'>): Promise<DeleteBrowserSessionResponse>;
   /** Delete one chat channel by exact channel id. */
   deleteChannel(options?: DeleteChannelOptions): Promise<DeleteChannelResponse>;
   deleteChannel(channelId: string, options?: Omit<DeleteChannelOptions, 'params'>): Promise<DeleteChannelResponse>;
@@ -1392,6 +1503,9 @@ export declare class RealtimeXClient {
   /** 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>;
+  /** Read a bounded, sanitized tail of the PTY output for one exact live terminal runtime session. */
+  getTerminalSessionContext(options?: GetTerminalSessionContextOptions): Promise<GetTerminalSessionContextResponse>;
+  getTerminalSessionContext(sessionId: string, options?: Omit<GetTerminalSessionContextOptions, 'params'>): Promise<GetTerminalSessionContextResponse>;
   /** Get one thread by exact workspace slug and exact thread slug. */
   getThread(options?: GetThreadOptions): Promise<GetThreadResponse>;
   getThread(params: GetThreadParams, options?: Omit<GetThreadOptions, 'params'>): Promise<GetThreadResponse>;
@@ -1406,6 +1520,8 @@ export declare class RealtimeXClient {
   /** List public artifacts for one exact workspace slug. Revoked artifacts are hidden unless includeRevoked=true is passed. */
   listArtifacts(options?: ListArtifactsOptions): Promise<ListArtifactsResponse>;
   listArtifacts(workspaceSlug: string, options?: Omit<ListArtifactsOptions, 'params'>): Promise<ListArtifactsResponse>;
+  /** List registered RealTimeX Browser sessions and their live runtime state. */
+  listBrowserSessions(options?: ListBrowserSessionsOptions): Promise<ListBrowserSessionsResponse>;
   /** List configured chat channels. Use returned channel ids with update-channel. */
   listChannels(options?: ListChannelsOptions): Promise<ListChannelsResponse>;
   /** List models for one provider id. Use an exact model id from this response when configuring workspace or thread LLM settings. */
@@ -1515,9 +1631,15 @@ export declare class RealtimeXClient {
   /** Set the default CLI agent for a workspace. Use prepare first to find a valid agent canonical/providerId and optional modelId. */
   setWorkspaceDefaultAgent(options?: SetWorkspaceDefaultAgentOptions): Promise<SetWorkspaceDefaultAgentResponse>;
   setWorkspaceDefaultAgent(workspaceSlug: string, body: SetWorkspaceDefaultAgentBody, options?: Omit<SetWorkspaceDefaultAgentOptions, 'params' | 'body'>): Promise<SetWorkspaceDefaultAgentResponse>;
+  /** Start an existing named RealTimeX Browser session, optionally opening an absolute HTTP or HTTPS URL. */
+  startBrowserSession(options?: StartBrowserSessionOptions): Promise<StartBrowserSessionResponse>;
+  startBrowserSession(sessionName: string, body: StartBrowserSessionBody, options?: Omit<StartBrowserSessionOptions, 'params' | 'body'>): Promise<StartBrowserSessionResponse>;
   /** Start one chat channel by exact channel id. */
   startChannel(options?: StartChannelOptions): Promise<StartChannelResponse>;
   startChannel(channelId: string, options?: Omit<StartChannelOptions, 'params'>): Promise<StartChannelResponse>;
+  /** 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>;

package/index.js

@@ -46,6 +46,16 @@ const operations = {
     ],
     "hasBody": true
   },
+  "createBrowserSession": {
+    "method": "POST",
+    "path": "/create-browser-session",
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": true
+  },
   "createChannel": {
     "method": "POST",
     "path": "/create-channel/{workspaceSlug}",
@@ -93,6 +103,18 @@ const operations = {
     ],
     "hasBody": true
   },
+  "deleteBrowserSession": {
+    "method": "DELETE",
+    "path": "/delete-browser-session/{sessionName}",
+    "pathParams": [
+      "sessionName"
+    ],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": false
+  },
   "deleteChannel": {
     "method": "DELETE",
     "path": "/delete-channel/{channelId}",
@@ -206,6 +228,21 @@ const operations = {
     ],
     "hasBody": false
   },
+  "getTerminalSessionContext": {
+    "method": "GET",
+    "path": "/get-terminal-session-context/{sessionId}",
+    "pathParams": [
+      "sessionId"
+    ],
+    "queryParams": [
+      "maxChars",
+      "afterSeq"
+    ],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": false
+  },
   "getThread": {
     "method": "GET",
     "path": "/get-thread/{workspaceSlug}/{threadSlug}",
@@ -263,6 +300,16 @@ const operations = {
     ],
     "hasBody": false
   },
+  "listBrowserSessions": {
+    "method": "GET",
+    "path": "/list-browser-sessions",
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": false
+  },
   "listChannels": {
     "method": "GET",
     "path": "/list-channels",
@@ -690,6 +737,18 @@ const operations = {
     ],
     "hasBody": true
   },
+  "startBrowserSession": {
+    "method": "POST",
+    "path": "/start-browser-session/{sessionName}",
+    "pathParams": [
+      "sessionName"
+    ],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": true
+  },
   "startChannel": {
     "method": "POST",
     "path": "/start-channel/{channelId}",
@@ -702,6 +761,18 @@ const operations = {
     ],
     "hasBody": false
   },
+  "stopBrowserSession": {
+    "method": "POST",
+    "path": "/stop-browser-session/{sessionName}",
+    "pathParams": [
+      "sessionName"
+    ],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": true
+  },
   "stopChannel": {
     "method": "POST",
     "path": "/stop-channel/{channelId}",
@@ -1004,6 +1075,13 @@ class RealtimeXClient {
     );
   }
 
+  createBrowserSession(...args) {
+    return this.request(
+      "createBrowserSession",
+      normalizeOperationOptions(operations["createBrowserSession"], args)
+    );
+  }
+
   createChannel(...args) {
     return this.request(
       "createChannel",
@@ -1032,6 +1110,13 @@ class RealtimeXClient {
     );
   }
 
+  deleteBrowserSession(...args) {
+    return this.request(
+      "deleteBrowserSession",
+      normalizeOperationOptions(operations["deleteBrowserSession"], args)
+    );
+  }
+
   deleteChannel(...args) {
     return this.request(
       "deleteChannel",
@@ -1095,6 +1180,13 @@ class RealtimeXClient {
     );
   }
 
+  getTerminalSessionContext(...args) {
+    return this.request(
+      "getTerminalSessionContext",
+      normalizeOperationOptions(operations["getTerminalSessionContext"], args)
+    );
+  }
+
   getThread(...args) {
     return this.request(
       "getThread",
@@ -1130,6 +1222,13 @@ class RealtimeXClient {
     );
   }
 
+  listBrowserSessions(...args) {
+    return this.request(
+      "listBrowserSessions",
+      normalizeOperationOptions(operations["listBrowserSessions"], args)
+    );
+  }
+
   listChannels(...args) {
     return this.request(
       "listChannels",
@@ -1396,6 +1495,13 @@ class RealtimeXClient {
     );
   }
 
+  startBrowserSession(...args) {
+    return this.request(
+      "startBrowserSession",
+      normalizeOperationOptions(operations["startBrowserSession"], args)
+    );
+  }
+
   startChannel(...args) {
     return this.request(
       "startChannel",
@@ -1403,6 +1509,13 @@ class RealtimeXClient {
     );
   }
 
+  stopBrowserSession(...args) {
+    return this.request(
+      "stopBrowserSession",
+      normalizeOperationOptions(operations["stopBrowserSession"], args)
+    );
+  }
+
   stopChannel(...args) {
     return this.request(
       "stopChannel",
@@ -1463,5 +1576,5 @@ module.exports = {
   createClient: createRealtimeXClient,
   createRealtimeXClient,
   operations,
-  version: "2.0.25",
+  version: "2.0.26",
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "2.0.25",
+    "version": "2.0.26",
     "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.25
+   npm install -g @realtimex/pp-cli@2.0.26
    ```
 2. Verify the exact version:
    ```bash
    realtimex-pp-cli --version
    ```
-   The output must be `realtimex-pp-cli 2.0.25`.
+   The output must be `realtimex-pp-cli 2.0.26`.
 
-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.25`, 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.26`, reinstall with the pinned npm command above. Do not proceed with skill commands until exact-version verification succeeds.
 
 * Always run first:
 
@@ -54,6 +54,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli configure-plugin <pluginId>` — Set non-secret configuration values for one installed plugin. Use a plugin id, name, or displayName from list-plugins.
 
+**create-browser-session** — Manage create browser session
+
+- `realtimex-pp-cli create-browser-session` — Create an isolated named RealTimeX Browser session. When url is supplied, start the session and open that URL.
+
 **create-channel** — Manage create channel
 
 - `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.
@@ -70,6 +74,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli create-workspace-agent-skill <workspaceSlug>` — Create a managed agent skill owned by one workspace.
 
+**delete-browser-session** — Manage delete browser session
+
+- `realtimex-pp-cli delete-browser-session <sessionName>` — Delete a stopped named RealTimeX Browser session and its isolated profile.
+
 **delete-channel** — Manage delete channel
 
 - `realtimex-pp-cli delete-channel <channelId>` — Delete one chat channel by exact channel id.
@@ -106,6 +114,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli get-plugin <pluginId>` — Get one installed plugin with its config schema (keys, labels, types, defaults)
 
+**get-terminal-session-context** — Manage get terminal session context
+
+- `realtimex-pp-cli get-terminal-session-context <sessionId>` — Read a bounded, sanitized tail of the PTY output for one exact live terminal runtime session.
+
 **get-thread** — Manage get thread
 
 - `realtimex-pp-cli get-thread <workspaceSlug> <threadSlug>` — Get one thread by exact workspace slug and exact thread slug.
@@ -126,6 +138,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli list-artifacts <workspaceSlug>` — List public artifacts for one exact workspace slug. Revoked artifacts are hidden unless includeRevoked=true is passed.
 
+**list-browser-sessions** — Manage list browser sessions
+
+- `realtimex-pp-cli list-browser-sessions` — List registered RealTimeX Browser sessions and their live runtime state.
+
 **list-channels** — Manage list channels
 
 - `realtimex-pp-cli list-channels` — List configured chat channels. Use returned channel ids with update-channel.
@@ -274,10 +290,18 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli setup-working-dir` — Add or edit an agent working directory from the desktop settings UI.
 
+**start-browser-session** — Manage start browser session
+
+- `realtimex-pp-cli start-browser-session <sessionName>` — Start an existing named RealTimeX Browser session, optionally opening an absolute HTTP or HTTPS URL.
+
 **start-channel** — Manage start channel
 
 - `realtimex-pp-cli start-channel <channelId>` — Start one chat channel by exact channel id.
 
+**stop-browser-session** — Manage stop browser session
+
+- `realtimex-pp-cli stop-browser-session <sessionName>` — Gracefully stop an existing named RealTimeX Browser session.
+
 **stop-channel** — Manage stop channel
 
 - `realtimex-pp-cli stop-channel <channelId>` — Stop one chat channel by exact channel id.
@@ -432,9 +456,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.25`, reinstall the pinned version:
+   If the command is missing or the output is not exactly `realtimex-pp-cli 2.0.26`, reinstall the pinned version:
    ```bash
-   npm install -g @realtimex/pp-cli@2.0.25
+   npm install -g @realtimex/pp-cli@2.0.26
    ```
    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.