@realtimex/sdk 2.0.19 → 2.0.21

package/index.d.ts

@@ -28,6 +28,43 @@ export interface ApproveChannelPairingCodeOptions extends RealtimeXRequestOption
   body?: ApproveChannelPairingCodeBody;
 }
 
+export type ChatWithTerminalAgentParams = Record<string, never>;
+export type ChatWithTerminalAgentQuery = Record<string, never>;
+export type ChatWithTerminalAgentHeaders = Record<string, never>;
+export type ChatWithTerminalAgentBody = {
+  workspaceName?: string;
+  threadName?: string;
+  agentName?: string;
+  agentSearch?: string;
+  modelName?: string;
+  skipModelSelection?: boolean;
+  messageText?: string;
+  messageConfirmation?: string;
+  workspaceTimeoutMs?: number;
+  threadTimeoutMs?: number;
+  actionTimeoutMs?: number;
+  actionDelayMs?: number;
+  recordVideo?: boolean;
+  videoPath?: string;
+  logProgress?: boolean;
+  tour?: boolean;
+  tourId?: string;
+  tourTts?: string;
+  tourLang?: string;
+  tourTtsVoice?: string;
+  tourSurface?: string;
+  tourTtsMaxWaitMs?: number;
+  timeoutMs?: number;
+  confirmDestructive?: boolean;
+};
+export type ChatWithTerminalAgentResponse = Record<string, unknown>;
+export interface ChatWithTerminalAgentOptions extends RealtimeXRequestOptions {
+  params?: ChatWithTerminalAgentParams;
+  query?: ChatWithTerminalAgentQuery;
+  headers?: ChatWithTerminalAgentHeaders & Record<string, string>;
+  body?: ChatWithTerminalAgentBody;
+}
+
 export type ClearWorkspaceDefaultAgentParams = {
   workspaceSlug: string;
 };
@@ -110,6 +147,26 @@ export interface CreateWorkspaceOptions extends RealtimeXRequestOptions {
   body?: CreateWorkspaceBody;
 }
 
+export type CreateWorkspaceAgentSkillParams = {
+  workspaceSlug: string;
+};
+export type CreateWorkspaceAgentSkillQuery = Record<string, never>;
+export type CreateWorkspaceAgentSkillHeaders = {
+  "x-app-id"?: string;
+};
+export type CreateWorkspaceAgentSkillBody = {
+  displayName: string;
+  name?: string;
+  description?: string;
+};
+export type CreateWorkspaceAgentSkillResponse = Record<string, unknown>;
+export interface CreateWorkspaceAgentSkillOptions extends RealtimeXRequestOptions {
+  params?: CreateWorkspaceAgentSkillParams;
+  query?: CreateWorkspaceAgentSkillQuery;
+  headers?: CreateWorkspaceAgentSkillHeaders & Record<string, string>;
+  body?: CreateWorkspaceAgentSkillBody;
+}
+
 export type DeleteChannelParams = {
   channelId: string;
 };
@@ -530,6 +587,27 @@ export interface PrepareOptions extends RealtimeXRequestOptions {
   body?: PrepareBody;
 }
 
+export type PromoteWorkspaceAgentSkillParams = {
+  workspaceSlug: string;
+  skillId: string;
+};
+export type PromoteWorkspaceAgentSkillQuery = Record<string, never>;
+export type PromoteWorkspaceAgentSkillHeaders = {
+  "x-app-id"?: string;
+};
+export type PromoteWorkspaceAgentSkillBody = {
+  displayName?: string;
+  name?: string;
+  description?: string;
+};
+export type PromoteWorkspaceAgentSkillResponse = Record<string, unknown>;
+export interface PromoteWorkspaceAgentSkillOptions extends RealtimeXRequestOptions {
+  params?: PromoteWorkspaceAgentSkillParams;
+  query?: PromoteWorkspaceAgentSkillQuery;
+  headers?: PromoteWorkspaceAgentSkillHeaders & Record<string, string>;
+  body?: PromoteWorkspaceAgentSkillBody;
+}
+
 export type PublishArtifactParams = {
   workspaceSlug: string;
 };
@@ -774,6 +852,35 @@ export interface SendMessageOptions extends RealtimeXRequestOptions {
   body?: SendMessageBody;
 }
 
+export type SetDefaultWorkspaceAgentParams = Record<string, never>;
+export type SetDefaultWorkspaceAgentQuery = Record<string, never>;
+export type SetDefaultWorkspaceAgentHeaders = Record<string, never>;
+export type SetDefaultWorkspaceAgentBody = {
+  workspaceName?: string;
+  agentName?: string;
+  modelName?: string;
+  skipModelSelection?: boolean;
+  actionTimeoutMs?: number;
+  actionDelayMs?: number;
+  tour?: boolean;
+  tourId?: string;
+  tourTts?: string;
+  tourLang?: string;
+  tourTtsVoice?: string;
+  tourSurface?: string;
+  tourTtsMaxWaitMs?: number;
+  logProgress?: boolean;
+  timeoutMs?: number;
+  confirmDestructive?: boolean;
+};
+export type SetDefaultWorkspaceAgentResponse = Record<string, unknown>;
+export interface SetDefaultWorkspaceAgentOptions extends RealtimeXRequestOptions {
+  params?: SetDefaultWorkspaceAgentParams;
+  query?: SetDefaultWorkspaceAgentQuery;
+  headers?: SetDefaultWorkspaceAgentHeaders & Record<string, string>;
+  body?: SetDefaultWorkspaceAgentBody;
+}
+
 export type SetHeartbeatActiveHoursParams = Record<string, never>;
 export type SetHeartbeatActiveHoursQuery = Record<string, never>;
 export type SetHeartbeatActiveHoursHeaders = {
@@ -949,9 +1056,11 @@ export type SetupWorkingDirBody = {
   actionTimeoutMs?: number;
   actionDelayMs?: number;
   tour?: boolean;
+  tourId?: string;
   tourTts?: string;
   tourLang?: string;
   tourTtsVoice?: string;
+  tourSurface?: string;
   tourTtsMaxWaitMs?: number;
   logProgress?: boolean;
   timeoutMs?: number;
@@ -1140,6 +1249,9 @@ export declare class RealtimeXClient {
   /** Approve one pending channel pairing code by visible 6-digit code or database id. Works for telegram, discord, and zalo channel pairing requests. */
   approveChannelPairingCode(options?: ApproveChannelPairingCodeOptions): Promise<ApproveChannelPairingCodeResponse>;
   approveChannelPairingCode(code: string, options?: Omit<ApproveChannelPairingCodeOptions, 'params'>): Promise<ApproveChannelPairingCodeResponse>;
+  /** Guide a user through sending a chat message to the terminal agent. */
+  chatWithTerminalAgent(options?: ChatWithTerminalAgentOptions): Promise<ChatWithTerminalAgentResponse>;
+  chatWithTerminalAgent(body: ChatWithTerminalAgentBody, options?: Omit<ChatWithTerminalAgentOptions, 'body'>): Promise<ChatWithTerminalAgentResponse>;
   /** Clear the default CLI agent from a workspace. */
   clearWorkspaceDefaultAgent(options?: ClearWorkspaceDefaultAgentOptions): Promise<ClearWorkspaceDefaultAgentResponse>;
   clearWorkspaceDefaultAgent(workspaceSlug: string, options?: Omit<ClearWorkspaceDefaultAgentOptions, 'params'>): Promise<ClearWorkspaceDefaultAgentResponse>;
@@ -1152,6 +1264,9 @@ export declare class RealtimeXClient {
   /** Create a workspace. Requires a human-readable workspace name. */
   createWorkspace(options?: CreateWorkspaceOptions): Promise<CreateWorkspaceResponse>;
   createWorkspace(body: CreateWorkspaceBody, options?: Omit<CreateWorkspaceOptions, 'body'>): Promise<CreateWorkspaceResponse>;
+  /** 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 one chat channel by exact channel id. */
   deleteChannel(options?: DeleteChannelOptions): Promise<DeleteChannelResponse>;
   deleteChannel(channelId: string, options?: Omit<DeleteChannelOptions, 'params'>): Promise<DeleteChannelResponse>;
@@ -1218,6 +1333,9 @@ export declare class RealtimeXClient {
   /** Return compact workspace, thread, current workspace/thread from explicit workspaceSlug and threadSlug query parameters, LLM provider, model, and CLI agent context for agents before choosing arguments. Agents should pass --workspace-slug "$RTX_WORKSPACE_SLUG" and --thread-slug "$RTX_THREAD_SLUG" when those environment variables exist. */
   prepare(options?: PrepareOptions): Promise<PrepareResponse>;
   prepare(query?: PrepareQuery, options?: Omit<PrepareOptions, 'query'>): Promise<PrepareResponse>;
+  /** Promote one workspace-owned agent skill to a global managed skill by copying its files into a new global skill row. */
+  promoteWorkspaceAgentSkill(options?: PromoteWorkspaceAgentSkillOptions): Promise<PromoteWorkspaceAgentSkillResponse>;
+  promoteWorkspaceAgentSkill(params: PromoteWorkspaceAgentSkillParams, body: PromoteWorkspaceAgentSkillBody, options?: Omit<PromoteWorkspaceAgentSkillOptions, 'params' | 'body'>): Promise<PromoteWorkspaceAgentSkillResponse>;
   /** Publish a browser-viewable file or folder under a workspace artifacts directory. artifactPath is relative to that workspace artifacts directory. */
   publishArtifact(options?: PublishArtifactOptions): Promise<PublishArtifactResponse>;
   publishArtifact(workspaceSlug: string, body: PublishArtifactBody, options?: Omit<PublishArtifactOptions, 'params' | 'body'>): Promise<PublishArtifactResponse>;
@@ -1257,6 +1375,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>;
+  /** 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>;
   /** Set workspace or global ambient-agent active hours using HH:mm start and end values. */
   setHeartbeatActiveHours(options?: SetHeartbeatActiveHoursOptions): Promise<SetHeartbeatActiveHoursResponse>;
   setHeartbeatActiveHours(body: SetHeartbeatActiveHoursBody, options?: Omit<SetHeartbeatActiveHoursOptions, 'body'>): Promise<SetHeartbeatActiveHoursResponse>;

package/index.js

@@ -13,6 +13,14 @@ const operations = {
     ],
     "hasBody": false
   },
+  "chatWithTerminalAgent": {
+    "method": "POST",
+    "path": "/chat-with-terminal-agent",
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [],
+    "hasBody": true
+  },
   "clearWorkspaceDefaultAgent": {
     "method": "DELETE",
     "path": "/clear-workspace-default-agent/{workspaceSlug}",
@@ -61,6 +69,18 @@ const operations = {
     ],
     "hasBody": true
   },
+  "createWorkspaceAgentSkill": {
+    "method": "POST",
+    "path": "/create-workspace-agent-skill/{workspaceSlug}",
+    "pathParams": [
+      "workspaceSlug"
+    ],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": true
+  },
   "deleteChannel": {
     "method": "DELETE",
     "path": "/delete-channel/{channelId}",
@@ -346,6 +366,19 @@ const operations = {
     ],
     "hasBody": false
   },
+  "promoteWorkspaceAgentSkill": {
+    "method": "POST",
+    "path": "/promote-workspace-agent-skill/{workspaceSlug}/{skillId}",
+    "pathParams": [
+      "workspaceSlug",
+      "skillId"
+    ],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": true
+  },
   "publishArtifact": {
     "method": "POST",
     "path": "/publish-artifact/{workspaceSlug}",
@@ -496,6 +529,14 @@ const operations = {
     ],
     "hasBody": true
   },
+  "setDefaultWorkspaceAgent": {
+    "method": "POST",
+    "path": "/set-default-workspace-agent",
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [],
+    "hasBody": true
+  },
   "setHeartbeatActiveHours": {
     "method": "POST",
     "path": "/set-heartbeat-active-hours",
@@ -888,6 +929,13 @@ class RealtimeXClient {
     );
   }
 
+  chatWithTerminalAgent(...args) {
+    return this.request(
+      "chatWithTerminalAgent",
+      normalizeOperationOptions(operations["chatWithTerminalAgent"], args)
+    );
+  }
+
   clearWorkspaceDefaultAgent(...args) {
     return this.request(
       "clearWorkspaceDefaultAgent",
@@ -916,6 +964,13 @@ class RealtimeXClient {
     );
   }
 
+  createWorkspaceAgentSkill(...args) {
+    return this.request(
+      "createWorkspaceAgentSkill",
+      normalizeOperationOptions(operations["createWorkspaceAgentSkill"], args)
+    );
+  }
+
   deleteChannel(...args) {
     return this.request(
       "deleteChannel",
@@ -1084,6 +1139,13 @@ class RealtimeXClient {
     );
   }
 
+  promoteWorkspaceAgentSkill(...args) {
+    return this.request(
+      "promoteWorkspaceAgentSkill",
+      normalizeOperationOptions(operations["promoteWorkspaceAgentSkill"], args)
+    );
+  }
+
   publishArtifact(...args) {
     return this.request(
       "publishArtifact",
@@ -1175,6 +1237,13 @@ class RealtimeXClient {
     );
   }
 
+  setDefaultWorkspaceAgent(...args) {
+    return this.request(
+      "setDefaultWorkspaceAgent",
+      normalizeOperationOptions(operations["setDefaultWorkspaceAgent"], args)
+    );
+  }
+
   setHeartbeatActiveHours(...args) {
     return this.request(
       "setHeartbeatActiveHours",
@@ -1305,5 +1374,5 @@ module.exports = {
   createClient: createRealtimeXClient,
   createRealtimeXClient,
   operations,
-  version: "2.0.19",
+  version: "2.0.21",
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "2.0.19",
+    "version": "2.0.21",
     "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.19
+   npm install -g @realtimex/pp-cli@2.0.21
    ```
 2. Verify the exact version:
    ```bash
    realtimex-pp-cli --version
    ```
-   The output must be `realtimex-pp-cli 2.0.19`.
+   The output must be `realtimex-pp-cli 2.0.21`.
 
-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.19`, 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.21`, reinstall with the pinned npm command above. Do not proceed with skill commands until exact-version verification succeeds.
 
 * Always run first:
 
@@ -42,6 +42,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli approve-channel-pairing-code <code>` — Approve one pending channel pairing code by visible 6-digit code or database id.
 
+**chat-with-terminal-agent** — Manage chat with terminal agent
+
+- `realtimex-pp-cli chat-with-terminal-agent` — Guide a user through sending a chat message to the terminal agent.
+
 **clear-workspace-default-agent** — Manage clear workspace default agent
 
 - `realtimex-pp-cli clear-workspace-default-agent <workspaceSlug>` — Clear the default CLI agent from a workspace.
@@ -58,6 +62,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli create-workspace` — Create a workspace. Requires a human-readable workspace name.
 
+**create-workspace-agent-skill** — Manage create workspace agent skill
+
+- `realtimex-pp-cli create-workspace-agent-skill <workspaceSlug>` — Create a managed agent skill owned by one workspace.
+
 **delete-channel** — Manage delete channel
 
 - `realtimex-pp-cli delete-channel <channelId>` — Delete one chat channel by exact channel id.
@@ -154,6 +162,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli prepare` — Return compact workspace, thread, current workspace/thread from explicit workspaceSlug and threadSlug query parameters
 
+**promote-workspace-agent-skill** — Manage promote workspace agent skill
+
+- `realtimex-pp-cli promote-workspace-agent-skill <workspaceSlug> <skillId>` — Promote one workspace-owned agent skill to a global managed skill by copying its files into a new global skill row.
+
 **publish-artifact** — Manage publish artifact
 
 - `realtimex-pp-cli publish-artifact <workspaceSlug>` — Publish a browser-viewable file or folder under a workspace artifacts directory.
@@ -202,6 +214,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.
 
+**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.
+
 **set-heartbeat-active-hours** — Manage set heartbeat active hours
 
 - `realtimex-pp-cli set-heartbeat-active-hours` — Set workspace or global ambient-agent active hours using HH:mm start and end values.
@@ -396,9 +412,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.19`, reinstall the pinned version:
+   If the command is missing or the output is not exactly `realtimex-pp-cli 2.0.21`, reinstall the pinned version:
    ```bash
-   npm install -g @realtimex/pp-cli@2.0.19
+   npm install -g @realtimex/pp-cli@2.0.21
    ```
    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.