@realtimex/sdk 2.0.28 → 2.0.30

package/README.md

@@ -15,5 +15,9 @@ const client = createRealtimeXClient({
 const workspaces = await client.request("listWorkspaces");
 ```
 
+`baseUrl` is required, either as an explicit client option or through
+`REALTIMEX_BASE_URL`. Desktop and `dev:all` runtimes propagate the resolved
+dynamic `/cli` endpoint; the SDK does not guess a localhost port.
+
 The package also publishes generated skill assets under
 `skills/realtimex-moderator-sdk`.

package/index.d.ts

@@ -818,6 +818,26 @@ export interface RenameWorkspaceOptions extends RealtimeXRequestOptions {
   body?: RenameWorkspaceBody;
 }
 
+export type RespondTerminalIdlePromptParams = {
+  sessionId: string;
+};
+export type RespondTerminalIdlePromptQuery = Record<string, never>;
+export type RespondTerminalIdlePromptHeaders = {
+  "x-app-id"?: string;
+};
+export type RespondTerminalIdlePromptBody = {
+  responseAction: "confirm-selected-option" | "cancel-prompt";
+  expectedEventSeq: number;
+  dispatchKey: string;
+};
+export type RespondTerminalIdlePromptResponse = Record<string, unknown>;
+export interface RespondTerminalIdlePromptOptions extends RealtimeXRequestOptions {
+  params?: RespondTerminalIdlePromptParams;
+  query?: RespondTerminalIdlePromptQuery;
+  headers?: RespondTerminalIdlePromptHeaders & Record<string, string>;
+  body?: RespondTerminalIdlePromptBody;
+}
+
 export type ResumeArtifactParams = {
   artifactId: string;
 };
@@ -1572,6 +1592,9 @@ export declare class RealtimeXClient {
   /** Rename one workspace by exact workspace slug. Only the name is changed. */
   renameWorkspace(options?: RenameWorkspaceOptions): Promise<RenameWorkspaceResponse>;
   renameWorkspace(workspaceSlug: string, body: RenameWorkspaceBody, options?: Omit<RenameWorkspaceOptions, 'params' | 'body'>): Promise<RenameWorkspaceResponse>;
+  /** 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>;
   /** Resume one paused artifact by artifact id. */
   resumeArtifact(options?: ResumeArtifactOptions): Promise<ResumeArtifactResponse>;
   resumeArtifact(artifactId: string, options?: Omit<ResumeArtifactOptions, 'params'>): Promise<ResumeArtifactResponse>;

package/index.js

@@ -519,6 +519,18 @@ const operations = {
     ],
     "hasBody": true
   },
+  "respondTerminalIdlePrompt": {
+    "method": "POST",
+    "path": "/respond-terminal-idle-prompt/{sessionId}",
+    "pathParams": [
+      "sessionId"
+    ],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": true
+  },
   "resumeArtifact": {
     "method": "POST",
     "path": "/resume-artifact/{artifactId}",
@@ -980,8 +992,12 @@ function normalizeOperationOptions(operation, args) {
 class RealtimeXClient {
   constructor(options = {}) {
     const env = typeof process !== 'undefined' ? process.env || {} : {};
-    this.baseUrl =
-      options.baseUrl || env.REALTIMEX_BASE_URL || 'http://localhost:3101/cli';
+    this.baseUrl = options.baseUrl || env.REALTIMEX_BASE_URL;
+    if (!this.baseUrl) {
+      throw new Error(
+        'RealtimeX SDK base URL is unavailable; pass { baseUrl } or propagate REALTIMEX_BASE_URL.'
+      );
+    }
     this.fetch = options.fetch || globalThis.fetch;
     if (typeof this.fetch !== 'function') {
       throw new Error('A fetch implementation is required. Use Node 18+ or pass { fetch }.');
@@ -1355,6 +1371,13 @@ class RealtimeXClient {
     );
   }
 
+  respondTerminalIdlePrompt(...args) {
+    return this.request(
+      "respondTerminalIdlePrompt",
+      normalizeOperationOptions(operations["respondTerminalIdlePrompt"], args)
+    );
+  }
+
   resumeArtifact(...args) {
     return this.request(
       "resumeArtifact",
@@ -1576,5 +1599,5 @@ module.exports = {
   createClient: createRealtimeXClient,
   createRealtimeXClient,
   operations,
-  version: "2.0.28",
+  version: "2.0.30",
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "2.0.28",
+    "version": "2.0.30",
     "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.28
+   npm install -g @realtimex/pp-cli@2.0.30
    ```
 2. Verify the exact version:
    ```bash
    realtimex-pp-cli --version
    ```
-   The output must be `realtimex-pp-cli 2.0.28`.
+   The output must be `realtimex-pp-cli 2.0.30`.
 
-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.28`, 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.30`, reinstall with the pinned npm command above. Do not proceed with skill commands until exact-version verification succeeds.
 
 * Always run first:
 
@@ -214,6 +214,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli rename-workspace <workspaceSlug>` — Rename one workspace by exact workspace slug. Only the name is changed.
 
+**respond-terminal-idle-prompt** — Manage respond terminal idle prompt
+
+- `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.
+
 **resume-artifact** — Manage resume artifact
 
 - `realtimex-pp-cli resume-artifact <artifactId>` — Resume one paused artifact by artifact id.
@@ -456,9 +460,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.28`, reinstall the pinned version:
+   If the command is missing or the output is not exactly `realtimex-pp-cli 2.0.30`, reinstall the pinned version:
    ```bash
-   npm install -g @realtimex/pp-cli@2.0.28
+   npm install -g @realtimex/pp-cli@2.0.30
    ```
    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.