@realtimex/sdk 2.0.23 → 2.0.25

package/index.d.ts

@@ -904,6 +904,29 @@ export interface SendMessageOptions extends RealtimeXRequestOptions {
   body?: SendMessageBody;
 }
 
+export type SendTerminalSessionMessageParams = {
+  sessionId: string;
+};
+export type SendTerminalSessionMessageQuery = Record<string, never>;
+export type SendTerminalSessionMessageHeaders = {
+  "x-app-id"?: string;
+};
+export type SendTerminalSessionMessageBody = {
+  message: string;
+  attachments?: Array<Record<string, unknown>>;
+  webSearchEnabled?: boolean;
+  broadcastThreadEvents?: boolean;
+  stripAgentPrefixForDelivery?: boolean;
+  channelTurnId?: string;
+};
+export type SendTerminalSessionMessageResponse = Record<string, unknown>;
+export interface SendTerminalSessionMessageOptions extends RealtimeXRequestOptions {
+  params?: SendTerminalSessionMessageParams;
+  query?: SendTerminalSessionMessageQuery;
+  headers?: SendTerminalSessionMessageHeaders & Record<string, string>;
+  body?: SendTerminalSessionMessageBody;
+}
+
 export type SetDefaultWorkspaceAgentParams = Record<string, never>;
 export type SetDefaultWorkspaceAgentQuery = Record<string, never>;
 export type SetDefaultWorkspaceAgentHeaders = Record<string, never>;
@@ -1270,6 +1293,26 @@ export interface UpdateChannelOptions extends RealtimeXRequestOptions {
   body?: UpdateChannelBody;
 }
 
+export type WorkspaceShellLayoutParams = Record<string, never>;
+export type WorkspaceShellLayoutQuery = Record<string, never>;
+export type WorkspaceShellLayoutHeaders = Record<string, never>;
+export type WorkspaceShellLayoutBody = {
+  cdpUrl?: string;
+  mainAppUrl?: string;
+  workspaceSlug?: string;
+  artifactPath?: string;
+  screenshotDir?: string;
+  timeoutMs?: number;
+  confirmDestructive?: boolean;
+};
+export type WorkspaceShellLayoutResponse = Record<string, unknown>;
+export interface WorkspaceShellLayoutOptions extends RealtimeXRequestOptions {
+  params?: WorkspaceShellLayoutParams;
+  query?: WorkspaceShellLayoutQuery;
+  headers?: WorkspaceShellLayoutHeaders & Record<string, string>;
+  body?: WorkspaceShellLayoutBody;
+}
+
 export interface RealtimeXClientOptions {
   baseUrl?: string;
   appId?: string;
@@ -1436,6 +1479,9 @@ export declare class RealtimeXClient {
   /** Send one message to an exact thread using the same routing as channel replies. Terminal-agent threads are dispatched to the terminal runtime; other threads use the configured LLM chat path. */
   sendMessage(options?: SendMessageOptions): Promise<SendMessageResponse>;
   sendMessage(params: SendMessageParams, body: SendMessageBody, options?: Omit<SendMessageOptions, 'params' | 'body'>): Promise<SendMessageResponse>;
+  /** Send one message directly to an exact live terminal session. Requires local terminal-session or desktop-app authentication. */
+  sendTerminalSessionMessage(options?: SendTerminalSessionMessageOptions): Promise<SendTerminalSessionMessageResponse>;
+  sendTerminalSessionMessage(sessionId: string, body: SendTerminalSessionMessageBody, options?: Omit<SendTerminalSessionMessageOptions, 'params' | 'body'>): Promise<SendTerminalSessionMessageResponse>;
   /** Set a workspace default agent from the desktop workspace chat settings UI. */
   setDefaultWorkspaceAgent(options?: SetDefaultWorkspaceAgentOptions): Promise<SetDefaultWorkspaceAgentResponse>;
   setDefaultWorkspaceAgent(body: SetDefaultWorkspaceAgentBody, options?: Omit<SetDefaultWorkspaceAgentOptions, 'body'>): Promise<SetDefaultWorkspaceAgentResponse>;
@@ -1489,6 +1535,9 @@ 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>;
+  /** Verify workspace navigation, title-bar containment, Files dock behavior, and action contrast at desktop and compact viewports. */
+  workspaceShellLayout(options?: WorkspaceShellLayoutOptions): Promise<WorkspaceShellLayoutResponse>;
+  workspaceShellLayout(body: WorkspaceShellLayoutBody, options?: Omit<WorkspaceShellLayoutOptions, 'body'>): Promise<WorkspaceShellLayoutResponse>;
 }
 
 export declare function createRealtimeXClient(

package/index.js

@@ -563,6 +563,18 @@ const operations = {
     ],
     "hasBody": true
   },
+  "sendTerminalSessionMessage": {
+    "method": "POST",
+    "path": "/send-terminal-session-message/{sessionId}",
+    "pathParams": [
+      "sessionId"
+    ],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": true
+  },
   "setDefaultWorkspaceAgent": {
     "method": "POST",
     "path": "/set-default-workspace-agent",
@@ -759,6 +771,14 @@ const operations = {
       "x-app-id"
     ],
     "hasBody": true
+  },
+  "workspaceShellLayout": {
+    "method": "POST",
+    "path": "/workspace-shell-layout",
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [],
+    "hasBody": true
   }
 };
 
@@ -1292,6 +1312,13 @@ class RealtimeXClient {
     );
   }
 
+  sendTerminalSessionMessage(...args) {
+    return this.request(
+      "sendTerminalSessionMessage",
+      normalizeOperationOptions(operations["sendTerminalSessionMessage"], args)
+    );
+  }
+
   setDefaultWorkspaceAgent(...args) {
     return this.request(
       "setDefaultWorkspaceAgent",
@@ -1417,6 +1444,13 @@ class RealtimeXClient {
       normalizeOperationOptions(operations["updateChannel"], args)
     );
   }
+
+  workspaceShellLayout(...args) {
+    return this.request(
+      "workspaceShellLayout",
+      normalizeOperationOptions(operations["workspaceShellLayout"], args)
+    );
+  }
 }
 
 function createRealtimeXClient(options = {}) {
@@ -1429,5 +1463,5 @@ module.exports = {
   createClient: createRealtimeXClient,
   createRealtimeXClient,
   operations,
-  version: "2.0.23",
+  version: "2.0.25",
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "2.0.23",
+    "version": "2.0.25",
     "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.23
+   npm install -g @realtimex/pp-cli@2.0.25
    ```
 2. Verify the exact version:
    ```bash
    realtimex-pp-cli --version
    ```
-   The output must be `realtimex-pp-cli 2.0.23`.
+   The output must be `realtimex-pp-cli 2.0.25`.
 
-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.23`, 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.25`, reinstall with the pinned npm command above. Do not proceed with skill commands until exact-version verification succeeds.
 
 * Always run first:
 
@@ -226,6 +226,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli send-message <workspaceSlug> <threadSlug>` — Send one message to an exact thread using the same routing as channel replies.
 
+**send-terminal-session-message** — Manage send terminal session message
+
+- `realtimex-pp-cli send-terminal-session-message <sessionId>` — Send one message directly to an exact live terminal session.
+
 **set-default-workspace-agent** — Manage set default workspace agent
 
 - `realtimex-pp-cli set-default-workspace-agent` — Set a workspace default agent from the desktop workspace chat settings UI.
@@ -298,6 +302,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.
 
+**workspace-shell-layout** — Manage workspace shell layout
+
+- `realtimex-pp-cli workspace-shell-layout` — Verify workspace navigation, title-bar containment, Files dock behavior
+
 
 ### Finding the right command
 
@@ -424,9 +432,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.23`, reinstall the pinned version:
+   If the command is missing or the output is not exactly `realtimex-pp-cli 2.0.25`, reinstall the pinned version:
    ```bash
-   npm install -g @realtimex/pp-cli@2.0.23
+   npm install -g @realtimex/pp-cli@2.0.25
    ```
    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.