@realtimex/sdk 2.0.49 → 2.0.52

package/index.d.ts

@@ -360,6 +360,7 @@ export type CreateChannelBody = {
   settings?: {
   deliveryMode?: "agent" | "platform";
   ownerMessages?: boolean;
+  approvalPrompts?: "desktop" | "chat";
 };
 };
 export type CreateChannelResponse = Record<string, unknown>;
@@ -1321,6 +1322,24 @@ export interface ListBrowserWatchesOptions extends RealtimeXRequestOptions {
   body?: ListBrowserWatchesBody;
 }
 
+export type ListChannelMembersParams = Record<string, never>;
+export type ListChannelMembersQuery = {
+  query?: string;
+  limit?: number;
+  context?: string;
+};
+export type ListChannelMembersHeaders = {
+  "x-app-id"?: string;
+};
+export type ListChannelMembersBody = unknown;
+export type ListChannelMembersResponse = Record<string, unknown>;
+export interface ListChannelMembersOptions extends RealtimeXRequestOptions {
+  params?: ListChannelMembersParams;
+  query?: ListChannelMembersQuery;
+  headers?: ListChannelMembersHeaders & Record<string, string>;
+  body?: ListChannelMembersBody;
+}
+
 export type ListChannelsParams = Record<string, never>;
 export type ListChannelsQuery = Record<string, never>;
 export type ListChannelsHeaders = {
@@ -2397,6 +2416,8 @@ export type SendChannelMessageBody = {
   context?: string;
   idempotencyKey?: string;
   replyTo?: string;
+  thread?: string;
+  chat?: string;
 };
 export type SendChannelMessageResponse = Record<string, unknown>;
 export interface SendChannelMessageOptions extends RealtimeXRequestOptions {
@@ -3165,6 +3186,7 @@ export type UpdateChannelBody = {
   settings?: {
   deliveryMode?: "agent" | "platform";
   ownerMessages?: boolean;
+  approvalPrompts?: "desktop" | "chat";
 };
 };
 export type UpdateChannelResponse = Record<string, unknown>;
@@ -3580,6 +3602,9 @@ export declare class RealtimeXClient {
   /** List the browser watches of the thread of the calling agent session, newest first: open ones, or all with includeResolved=true. Each shows its publicId and name on the Webhooks & Events page, its state (paused when the person paused it there), why it is suspended, coverage gaps and recent fires. Page excerpts are never listed. */
   listBrowserWatches(options?: ListBrowserWatchesOptions): Promise<ListBrowserWatchesResponse>;
   listBrowserWatches(query?: ListBrowserWatchesQuery, options?: Omit<ListBrowserWatchesOptions, 'query'>): Promise<ListBrowserWatchesResponse>;
+  /** List the members of the group chat this terminal is answering, as names and handles to tag with @[Name](handle) in send-channel-message. Run it from the channel-linked terminal, so --context is optional. Handles are cu_<id> (the same as sender_handle) or zm_<id> (this chat only). Errors: 400 not a group chat or the channel has no mentions, 404 no linked chat, 409 channel stopped, 503 member list unavailable (try again later). */
+  listChannelMembers(options?: ListChannelMembersOptions): Promise<ListChannelMembersResponse>;
+  listChannelMembers(query?: ListChannelMembersQuery, options?: Omit<ListChannelMembersOptions, 'query'>): Promise<ListChannelMembersResponse>;
   /** List configured chat channels. Use returned channel ids with update-channel. */
   listChannels(options?: ListChannelsOptions): Promise<ListChannelsResponse>;
   /** List host and workspace batteries with the fitted status for the active model; no model call. */
@@ -3726,7 +3751,7 @@ export declare class RealtimeXClient {
   /** Send one local file to the external chat that this terminal is answering. Run it from the channel-linked terminal with --file-path <absolute path>: the target chat comes from your terminal session, so --context is optional. Send one file per command. Channels that cannot send files return an error. contentBase64 with fileName remains available when no local path exists. */
   sendChannelFile(options?: SendChannelFileOptions): Promise<SendChannelFileResponse>;
   sendChannelFile(body: SendChannelFileBody, options?: Omit<SendChannelFileOptions, 'body'>): Promise<SendChannelFileResponse>;
-  /** Post one message to the external chat (Zalo, Telegram, ...) that this terminal is answering. Run it from the channel-linked terminal: the target chat comes from your terminal session, so --context is optional. Pass multi-line text with a quoted heredoc: --text "$(cat <<"EOF" ... EOF)". Send one message per command. Staying silent is fine when no reply is useful. To reply with a quote, add --reply-to with a ref from <external_user_context> (message.ref or reply_to.ref) or "current" (channels that support it; text messages only). Errors: 400 invalid ref or message that cannot be quoted, 404 no linked chat, 409 channel stopped, 413 text over 8000 characters, 429 rate limited (wait retry_after seconds). */
+  /** Post one message to the external chat (Zalo, Telegram, ...) that this terminal is answering. Run it from the channel-linked terminal: the target chat comes from your terminal session, so --context is optional. Pass multi-line text with a quoted heredoc: --text "$(cat <<"EOF" ... EOF)". Send one message per command. Staying silent is fine when no reply is useful. To reply with a quote, add --reply-to with a ref from <external_user_context> (message.ref or reply_to.ref) or "current" (channels that support it; text messages only). In a group chat, tag members with @[Name] or @[Name](handle) in the text (see list-channel-members); a plain @Name is not a tag. To post owner-approved text word for word to the chat another thread of this workspace serves, add --thread <workspace>/<thread> (and --chat when that thread serves several chats; Zalo Personal and WhatsApp chats for now): RealTimeX posts it as one message, shows it in that thread as an owner post and returns status delivered, failed or delivery_unknown; it needs the workspace setting "Agents in this workspace may post to its channel chats" and is not available from a terminal that answers a chat. Errors: 400 unknown or ambiguous mention (lists candidates; nothing posted), 400 invalid ref or message that cannot be quoted, 403 --thread setting off (CHANNEL_CROSS_THREAD_POST_DISABLED) or another workspace (CHANNEL_CONTEXT_CALLER_MISMATCH), 404 no linked chat, 409 channel stopped or CHAT_AMBIGUOUS (lists candidates), 413 text over 8000 characters or, with --thread, over the channel */
   sendChannelMessage(options?: SendChannelMessageOptions): Promise<SendChannelMessageResponse>;
   sendChannelMessage(body: SendChannelMessageBody, options?: Omit<SendChannelMessageOptions, 'body'>): Promise<SendChannelMessageResponse>;
   /** Add (--emoji) or remove (--remove) your reaction on one message of the external chat this terminal is answering. Name the message with --message: a ref from <external_user_context> (message.ref or reply_to.ref) or "current" for the message of this turn. Run it from the channel-linked terminal, so --context is optional. Errors: 400 invalid ref or unsupported emoji (the error lists the supported ones), 404 no linked chat or no current message, 409 channel stopped, 429 rate limited (wait retry_after seconds). */

package/index.js

@@ -662,6 +662,20 @@ const operations = {
     "headerParams": [],
     "hasBody": false
   },
+  "listChannelMembers": {
+    "method": "GET",
+    "path": "/list-channel-members",
+    "pathParams": [],
+    "queryParams": [
+      "query",
+      "limit",
+      "context"
+    ],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": false
+  },
   "listChannels": {
     "method": "GET",
     "path": "/list-channels",
@@ -2553,6 +2567,13 @@ class RealtimeXClient {
     );
   }
 
+  listChannelMembers(...args) {
+    return this.request(
+      "listChannelMembers",
+      normalizeOperationOptions(operations["listChannelMembers"], args)
+    );
+  }
+
   listChannels(...args) {
     return this.request(
       "listChannels",
@@ -3250,5 +3271,5 @@ module.exports = {
   createRealtimeXClient,
   createRealtimeXWebhookClient,
   operations,
-  version: "2.0.49",
+  version: "2.0.52",
 };

package/package.json

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

package/skills/realtimex-artifacts/SKILL.md

@@ -15,16 +15,16 @@ List, publish, inspect, pause, resume, and revoke RealTimeX workspace artifacts.
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.49. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.52. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.49`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.49
+npm install -g @realtimex/pp-cli@2.0.52
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-automation-flows/SKILL.md

@@ -15,16 +15,16 @@ Run RealTimeX automation workflows and guided automation-flow commands, includin
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.49. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.52. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.49`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.49
+npm install -g @realtimex/pp-cli@2.0.52
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-browser-sessions/SKILL.md

@@ -15,16 +15,16 @@ List, create, start, stop, delete and show tabs of named RealTimeX browser sessi
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.49. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.52. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.49`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.49
+npm install -g @realtimex/pp-cli@2.0.52
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-channels/SKILL.md

@@ -15,16 +15,16 @@ Create, configure, start, stop, and delete RealTimeX chat channels, approve pair
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.49. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.52. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.49`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.49
+npm install -g @realtimex/pp-cli@2.0.52
 ```
 
 For requests about the current workspace or thread, resolve context first:
@@ -59,6 +59,10 @@ realtimex-pp-cli prepare --agent
 
 - `realtimex-pp-cli ignore-channel-pairing-code <code>` — Ignore one pending channel access request by visible 6-digit code or database id.
 
+**list-channel-members** — Manage list channel members
+
+- `realtimex-pp-cli list-channel-members` — List the members of the group chat this terminal is answering, as names and handles to tag with @[Name](handle)
+
 **list-channels** — Manage list channels
 
 - `realtimex-pp-cli list-channels` — List configured chat channels. Use returned channel ids with update-channel.

package/skills/realtimex-decisions/SKILL.md

@@ -15,16 +15,16 @@ Run advisory decision-model judgments, list decision batteries, and calibrate ba
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.49. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.52. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.49`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.49
+npm install -g @realtimex/pp-cli@2.0.52
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-delegates/SKILL.md

@@ -15,16 +15,16 @@ Manage RealTimeX Delegate scope bindings, policy drafts and compiler jobs, activ
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.49. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.52. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.49`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.49
+npm install -g @realtimex/pp-cli@2.0.52
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-heartbeat/SKILL.md

@@ -15,16 +15,16 @@ Configure RealTimeX heartbeat scheduling, agents, active hours, timezone, autopi
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.49. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.52. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.49`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.49
+npm install -g @realtimex/pp-cli@2.0.52
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-local-apps/SKILL.md

@@ -15,16 +15,16 @@ Create, inspect, configure, start, stop, restart, and delete RealTimeX Local App
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.49. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.52. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.49`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.49
+npm install -g @realtimex/pp-cli@2.0.52
 ```
 
 For requests about the current workspace or thread, resolve context first:

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

@@ -15,16 +15,16 @@ Use this router to select the smallest RealTimeX skill that owns the requested o
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.49. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.52. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.49`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.49
+npm install -g @realtimex/pp-cli@2.0.52
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-plugin-and-skill/SKILL.md

@@ -15,16 +15,16 @@ Manage RealTimeX plugins and agent skills, including configuration, enablement,
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.49. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.52. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.49`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.49
+npm install -g @realtimex/pp-cli@2.0.52
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-secrets/SKILL.md

@@ -15,16 +15,16 @@ Manage encrypted Login, Card, Identity, SSH key and Secure note items, tags and
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.49. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.52. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.49`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.49
+npm install -g @realtimex/pp-cli@2.0.52
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-terminal-agents/SKILL.md

@@ -15,16 +15,16 @@ Manage RealTimeX terminal agents, terminal sessions, session messages, and idle
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.49. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.52. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.49`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.49
+npm install -g @realtimex/pp-cli@2.0.52
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-webhooks/SKILL.md

@@ -15,16 +15,16 @@ Create, inspect, update, test, and delete RealTimeX public webhook endpoints and
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.49. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.52. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.49`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.49
+npm install -g @realtimex/pp-cli@2.0.52
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-workspaces/SKILL.md

@@ -15,16 +15,16 @@ Manage RealTimeX workspaces, threads, messages, workspace personality, LLM confi
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.49. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.52. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.49`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.49
+npm install -g @realtimex/pp-cli@2.0.52
 ```
 
 For requests about the current workspace or thread, resolve context first: