@realtimex/sdk 2.0.52 → 2.0.54

package/index.d.ts

@@ -145,6 +145,30 @@ export interface CancelThreadWakeOptions extends RealtimeXRequestOptions {
   body?: CancelThreadWakeBody;
 }
 
+export type ChannelActParams = {
+  control: string;
+};
+export type ChannelActQuery = Record<string, never>;
+export type ChannelActHeaders = {
+  "x-app-id"?: string;
+};
+export type ChannelActBody = {
+  argsJson?: string;
+  limit?: number;
+  before?: string;
+  query?: string;
+  name?: string;
+  message?: string;
+  context?: string;
+};
+export type ChannelActResponse = Record<string, unknown>;
+export interface ChannelActOptions extends RealtimeXRequestOptions {
+  params?: ChannelActParams;
+  query?: ChannelActQuery;
+  headers?: ChannelActHeaders & Record<string, string>;
+  body?: ChannelActBody;
+}
+
 export type ChatRichContentContainmentParams = Record<string, never>;
 export type ChatRichContentContainmentQuery = Record<string, never>;
 export type ChatRichContentContainmentHeaders = Record<string, never>;
@@ -1309,6 +1333,7 @@ export type ListBrowserWatchesParams = Record<string, never>;
 export type ListBrowserWatchesQuery = {
   key?: string;
   includeResolved?: boolean;
+  includeIncoming?: boolean;
   limit?: number;
   cursor?: string;
 };
@@ -2527,6 +2552,16 @@ export type SetBrowserWatchBody = {
   excerptChars?: number;
   reason: string;
   context?: Record<string, unknown>;
+  route?: {
+  dispatchMode: "send_to_thread" | "trigger_agent" | "trigger_flow" | "record_only";
+  workspaceId?: number;
+  workspaceSlug?: string;
+  threadId?: number;
+  threadSlug?: string;
+  triggerFlowId?: string;
+};
+  includePayloadPreview?: boolean;
+  authorizationRequestId?: string;
 };
 export type SetBrowserWatchResponse = unknown;
 export interface SetBrowserWatchOptions extends RealtimeXRequestOptions {
@@ -3453,6 +3488,9 @@ export declare class RealtimeXClient {
   /** Cancel a scheduled wake-up of the thread of the calling agent session by key. Cancelling an already cancelled key succeeds. A wake that is being delivered cannot be retracted. A wake with uncertain delivery can only be released with acknowledgeUnknown after checking the thread. */
   cancelThreadWake(options?: CancelThreadWakeOptions): Promise<CancelThreadWakeResponse>;
   cancelThreadWake(body: CancelThreadWakeBody, options?: Omit<CancelThreadWakeOptions, 'body'>): Promise<CancelThreadWakeResponse>;
+  /** Run one control of the external chat this terminal answers (Zalo Personal first): channel-act list shows the controls of this chat with their level, channel-act describe --name <control> shows the arguments of one control, and channel-act <name> runs it with --args-json and the flags below. Open controls (free, chat-write) run right away; ask controls run after the terminal permission prompt; user ids take cu_ and zm_ handles; history pages back with --before <next_before>. Posting text stays on send-channel-message. Run it from the channel-linked terminal, so --context is optional. Errors: 400 invalid arguments (details and schema) or a control that cannot be called safely (CHANNEL_ACT_UNAVAILABLE), 403 an account-wide list on an account that serves other workspaces (CHANNEL_ACT_ISOLATED), 404 no such control (a hint names the right one) or no linked chat, 409 channel stopped, 429 rate limited (wait retry_after seconds), 502 the channel refused. */
+  channelAct(options?: ChannelActOptions): Promise<ChannelActResponse>;
+  channelAct(control: string, body: ChannelActBody, options?: Omit<ChannelActOptions, 'params' | 'body'>): Promise<ChannelActResponse>;
   /** Measure chat rich-content containment in the owned Electron renderer. */
   chatRichContentContainment(options?: ChatRichContentContainmentOptions): Promise<ChatRichContentContainmentResponse>;
   chatRichContentContainment(body: ChatRichContentContainmentBody, options?: Omit<ChatRichContentContainmentOptions, 'body'>): Promise<ChatRichContentContainmentResponse>;
@@ -3599,7 +3637,7 @@ export declare class RealtimeXClient {
   listBrowserProfiles(options?: ListBrowserProfilesOptions): Promise<ListBrowserProfilesResponse>;
   /** List registered RealTimeX Browser sessions and their live runtime state. */
   listBrowserSessions(options?: ListBrowserSessionsOptions): Promise<ListBrowserSessionsResponse>;
-  /** 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. */
+  /** 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, where it delivers (route) and, for one that delivers elsewhere, its approval. With includeIncoming=true, incoming lists the watches set by another thread */
   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). */
@@ -3763,7 +3801,7 @@ export declare class RealtimeXClient {
   /** 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>;
-  /** Watch one RealTimeX Browser tab for a condition and wake the thread of the calling agent session when it occurs, until a deadline. The host observes the tab; waiting costs no turns. kind dom watches rendered elements (CSS selector, optional text, appears or changes); kind url watches the tab address. Name the tab by its id from list-browser-sessions. Setting an existing key replaces that watch. The watch is a Webhooks & Events endpoint the person sees and can pause or remove; it always wakes your own thread. The wake sends nothing by itself and grants no new permission. Pair it with a thread wake at the deadline. Errors: 400 invalid input or selector, 403 not a thread-bound agent session, thread wakes off, or a route field (WATCH_ROUTE_NOT_ALLOWED), 404 session or tab not found, 409 tab ambiguous or not observable, key busy or uncertain, or paused by the person, 429 limits, 503 desktop or browser unavailable. */
+  /** Watch one RealTimeX Browser tab for a condition and wake the thread of the calling agent session when it occurs, until a deadline. The host observes the tab; waiting costs no turns. kind dom watches rendered elements (CSS selector, optional text, appears or changes); kind url watches the tab address. Name the tab by its id from list-browser-sessions. Setting an existing key replaces that watch. The watch is a Webhooks & Events endpoint the person sees and can pause or remove. It wakes your own thread; to deliver to another thread, a workspace */
   setBrowserWatch(options?: SetBrowserWatchOptions): Promise<SetBrowserWatchResponse>;
   setBrowserWatch(body: SetBrowserWatchBody, options?: Omit<SetBrowserWatchOptions, 'body'>): Promise<SetBrowserWatchResponse>;
   /** Set a workspace default agent from the desktop workspace chat settings UI. */

package/index.js

@@ -67,6 +67,18 @@ const operations = {
     "headerParams": [],
     "hasBody": true
   },
+  "channelAct": {
+    "method": "POST",
+    "path": "/channel-act/{control}",
+    "pathParams": [
+      "control"
+    ],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": true
+  },
   "chatRichContentContainment": {
     "method": "POST",
     "path": "/chat-rich-content-containment",
@@ -656,6 +668,7 @@ const operations = {
     "queryParams": [
       "key",
       "includeResolved",
+      "includeIncoming",
       "limit",
       "cursor"
     ],
@@ -2182,6 +2195,13 @@ class RealtimeXClient {
     );
   }
 
+  channelAct(...args) {
+    return this.request(
+      "channelAct",
+      normalizeOperationOptions(operations["channelAct"], args)
+    );
+  }
+
   chatRichContentContainment(...args) {
     return this.request(
       "chatRichContentContainment",
@@ -3271,5 +3291,5 @@ module.exports = {
   createRealtimeXClient,
   createRealtimeXWebhookClient,
   operations,
-  version: "2.0.52",
+  version: "2.0.54",
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "2.0.52",
+    "version": "2.0.54",
     "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.52. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.54. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.54`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.52
+npm install -g @realtimex/pp-cli@2.0.54
 ```
 
 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.52. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.54. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.54`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.52
+npm install -g @realtimex/pp-cli@2.0.54
 ```
 
 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.52. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.54. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.54`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.52
+npm install -g @realtimex/pp-cli@2.0.54
 ```
 
 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.52. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.54. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.54`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.52
+npm install -g @realtimex/pp-cli@2.0.54
 ```
 
 For requests about the current workspace or thread, resolve context first:
@@ -39,6 +39,10 @@ realtimex-pp-cli prepare --agent
 
 - `realtimex-pp-cli approve-channel-pairing-code <code>` — Approve one pending channel pairing code by visible 6-digit code or database id.
 
+**channel-act** — Manage channel act
+
+- `realtimex-pp-cli channel-act <control>` — Run one control of the external chat this terminal answers (Zalo Personal first)
+
 **complete-channel-setup** — Manage complete channel setup
 
 - `realtimex-pp-cli complete-channel-setup <channelId>` — Complete channel setup

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.52. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.54. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.54`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.52
+npm install -g @realtimex/pp-cli@2.0.54
 ```
 
 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.52. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.54. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.54`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.52
+npm install -g @realtimex/pp-cli@2.0.54
 ```
 
 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.52. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.54. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.54`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.52
+npm install -g @realtimex/pp-cli@2.0.54
 ```
 
 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.52. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.54. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.54`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.52
+npm install -g @realtimex/pp-cli@2.0.54
 ```
 
 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.52. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.54. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.54`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.52
+npm install -g @realtimex/pp-cli@2.0.54
 ```
 
 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.52. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.54. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.54`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.52
+npm install -g @realtimex/pp-cli@2.0.54
 ```
 
 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.52. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.54. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.54`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.52
+npm install -g @realtimex/pp-cli@2.0.54
 ```
 
 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.52. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.54. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.54`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.52
+npm install -g @realtimex/pp-cli@2.0.54
 ```
 
 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.52. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.54. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.54`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.52
+npm install -g @realtimex/pp-cli@2.0.54
 ```
 
 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.52. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.54. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.52`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.54`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.52
+npm install -g @realtimex/pp-cli@2.0.54
 ```
 
 For requests about the current workspace or thread, resolve context first: