@realtimex/sdk 2.0.66 → 2.0.68

package/index.d.ts

@@ -74,6 +74,26 @@ export interface AskHumanOptions extends RealtimeXRequestOptions {
   body?: AskHumanBody;
 }
 
+export type CalibrateChannelGateParams = Record<string, never>;
+export type CalibrateChannelGateQuery = Record<string, never>;
+export type CalibrateChannelGateHeaders = {
+  "x-app-id"?: string;
+};
+export type CalibrateChannelGateBody = {
+  battery?: string;
+  corpus?: string;
+  corpusPath?: string;
+  write?: boolean;
+  perStateTimeoutMs?: number;
+};
+export type CalibrateChannelGateResponse = unknown;
+export interface CalibrateChannelGateOptions extends RealtimeXRequestOptions {
+  params?: CalibrateChannelGateParams;
+  query?: CalibrateChannelGateQuery;
+  headers?: CalibrateChannelGateHeaders & Record<string, string>;
+  body?: CalibrateChannelGateBody;
+}
+
 export type CalibrateDecisionBatteryParams = Record<string, never>;
 export type CalibrateDecisionBatteryQuery = Record<string, never>;
 export type CalibrateDecisionBatteryHeaders = {
@@ -892,6 +912,47 @@ export interface GetChannelOptions extends RealtimeXRequestOptions {
   body?: GetChannelBody;
 }
 
+export type GetChannelGateParams = {
+  channelId: string;
+};
+export type GetChannelGateQuery = {
+  level?: string;
+  chatType?: string;
+  chatId?: string;
+  chatName?: string;
+};
+export type GetChannelGateHeaders = {
+  "x-app-id"?: string;
+};
+export type GetChannelGateBody = unknown;
+export type GetChannelGateResponse = Record<string, unknown>;
+export interface GetChannelGateOptions extends RealtimeXRequestOptions {
+  params?: GetChannelGateParams;
+  query?: GetChannelGateQuery;
+  headers?: GetChannelGateHeaders & Record<string, string>;
+  body?: GetChannelGateBody;
+}
+
+export type GetChannelGateDecisionsParams = {
+  channelId: string;
+};
+export type GetChannelGateDecisionsQuery = {
+  chatType: string;
+  chatId: string;
+  limit?: number;
+};
+export type GetChannelGateDecisionsHeaders = {
+  "x-app-id"?: string;
+};
+export type GetChannelGateDecisionsBody = unknown;
+export type GetChannelGateDecisionsResponse = Record<string, unknown>;
+export interface GetChannelGateDecisionsOptions extends RealtimeXRequestOptions {
+  params?: GetChannelGateDecisionsParams;
+  query?: GetChannelGateDecisionsQuery;
+  headers?: GetChannelGateDecisionsHeaders & Record<string, string>;
+  body?: GetChannelGateDecisionsBody;
+}
+
 export type GetChannelGuidanceParams = {
   channelId: string;
 };
@@ -1402,6 +1463,20 @@ export interface ListChannelFriendsOptions extends RealtimeXRequestOptions {
   body?: ListChannelFriendsBody;
 }
 
+export type ListChannelGateBatteriesParams = Record<string, never>;
+export type ListChannelGateBatteriesQuery = Record<string, never>;
+export type ListChannelGateBatteriesHeaders = {
+  "x-app-id"?: string;
+};
+export type ListChannelGateBatteriesBody = unknown;
+export type ListChannelGateBatteriesResponse = Record<string, unknown>;
+export interface ListChannelGateBatteriesOptions extends RealtimeXRequestOptions {
+  params?: ListChannelGateBatteriesParams;
+  query?: ListChannelGateBatteriesQuery;
+  headers?: ListChannelGateBatteriesHeaders & Record<string, string>;
+  body?: ListChannelGateBatteriesBody;
+}
+
 export type ListChannelGroupsParams = {
   channelId: string;
 };
@@ -2812,6 +2887,30 @@ export interface SetChannelChatOptions extends RealtimeXRequestOptions {
   body?: SetChannelChatBody;
 }
 
+export type SetChannelGateParams = {
+  channelId: string;
+};
+export type SetChannelGateQuery = Record<string, never>;
+export type SetChannelGateHeaders = {
+  "x-app-id"?: string;
+};
+export type SetChannelGateBody = {
+  level?: "all" | "private" | "groups";
+  chatType?: "group" | "dm";
+  chatId?: string;
+  chatName?: string;
+  mode?: "off" | "on" | "shadow";
+  battery?: string | null;
+  clear?: boolean;
+};
+export type SetChannelGateResponse = Record<string, unknown>;
+export interface SetChannelGateOptions extends RealtimeXRequestOptions {
+  params?: SetChannelGateParams;
+  query?: SetChannelGateQuery;
+  headers?: SetChannelGateHeaders & Record<string, string>;
+  body?: SetChannelGateBody;
+}
+
 export type SetChannelGuidanceParams = {
   channelId: string;
 };
@@ -3794,6 +3893,9 @@ export declare class RealtimeXClient {
   archiveActiveThreadSpa(body: ArchiveActiveThreadSpaBody, options?: Omit<ArchiveActiveThreadSpaOptions, 'body'>): Promise<ArchiveActiveThreadSpaResponse>;
   askHuman(options?: AskHumanOptions): Promise<AskHumanResponse>;
   askHuman(body: AskHumanBody, options?: Omit<AskHumanOptions, 'body'>): Promise<AskHumanResponse>;
+  /** Fit per-model thresholds for a Message gate battery from labelled messages: every state is built the way the gate builds it and sent under the channel.message-gate class (the decision model\'s allowance for that class applies). corpus builtin is the shipped Vietnamese and English corpus; corpusPath names a .jsonl file in this workspace\'s .realtimex-decisions/corpus folder; each line is { id, lang, state: { message, guidance, recent }, expected: { <question>: <answer> } } with at least 50 labels per question. Thresholds keep zero consequential false positives and maximize coverage. Reports coverage, false positives and negatives, accuracy and the unsure rate per question and language; write true saves the lock (workspace batteries in .realtimex-decisions/locks; the built-in battery only in development). Errors: 400 invalid corpus or battery (DECISION_INVALID_REQUEST), 429 rate limited. */
+  calibrateChannelGate(options?: CalibrateChannelGateOptions): Promise<CalibrateChannelGateResponse>;
+  calibrateChannelGate(body: CalibrateChannelGateBody, options?: Omit<CalibrateChannelGateOptions, 'body'>): Promise<CalibrateChannelGateResponse>;
   /** Fit per-model battery thresholds from labelled states or paired decision digests; report only unless write=true. */
   calibrateDecisionBattery(options?: CalibrateDecisionBatteryOptions): Promise<CalibrateDecisionBatteryResponse>;
   calibrateDecisionBattery(body: CalibrateDecisionBatteryBody, options?: Omit<CalibrateDecisionBatteryOptions, 'body'>): Promise<CalibrateDecisionBatteryResponse>;
@@ -3898,6 +4000,12 @@ export declare class RealtimeXClient {
   /** Show one chat channel by exact channel id: its non-secret settings, who can use it (whoCanUse), access policies, pending request count, live status, setup state, guidancePolicy and guidance: the default levels all (All chats), private (All private chats) and groups (All groups), each with its text, boxes and the combined text the agent sees (see set-channel-guidance, get-channel-guidance). Tokens, app secrets and account sessions are never returned. Errors: 404 no such channel, or one in a workspace this caller cannot reach. */
   getChannel(options?: GetChannelOptions): Promise<GetChannelResponse>;
   getChannel(channelId: string, options?: Omit<GetChannelOptions, 'params'>): Promise<GetChannelResponse>;
+  /** The Message gate of one level (level all, private or groups) or one chat (chatType group or dm with chatId; a group may also take chatName). Returns setting (mode, battery, the level it comes from and inheritedFrom), chain (the value set at each level, null where none), battery (id, version, title, source and whether it is tuned for the active decision model), consent (required, state current, missing, stale or not_needed, backend, destination and model) and status: off, on, shadow, not_tuned (thresholds missing for this model: it wakes more often), consent_pending (waiting for the owner\'s confirmation: every message wakes the agent) or unavailable (no decision model: every message wakes the agent). Errors: 400 no level or chat named, 404 no such channel or person, 409 CONTACT_AMBIGUOUS. */
+  getChannelGate(options?: GetChannelGateOptions): Promise<GetChannelGateResponse>;
+  getChannelGate(channelId: string, options?: Omit<GetChannelGateOptions, 'params'>): Promise<GetChannelGateResponse>;
+  /** One chat\'s recent Message gate decisions, newest first (chatType group or dm with chatId; limit up to 100, default 20): decision (wake, hold or drop), the rule that matched (or otherwise, onUnsure, onUnavailable), reason, source (on or shadow), the input cuts, battery, backend and model, whether thresholds were fitted, the verdicts, latency and any error code. Never the message text. Errors: 400 no chat named (INVALID_CHAT), 404 no such channel or person. */
+  getChannelGateDecisions(options?: GetChannelGateDecisionsOptions): Promise<GetChannelGateDecisionsResponse>;
+  getChannelGateDecisions(channelId: string, options?: Omit<GetChannelGateDecisionsOptions, 'params'>): Promise<GetChannelGateDecisionsResponse>;
   /** What the agent sees: the combined guidance of one level (level all, private or groups) or one chat (chatType group or dm with chatId; a group may also take chatName; a private chat also a sealed sender_handle cu_<n>). Returns combined (text, length, warn above 8,000 characters, and the parts in order) and every level on the chain with its text, boxes (ticks) and the boxes changed at that level (changedHere). Errors: 400 no level or chat named (GUIDANCE_LEVEL_INVALID, INVALID_CHAT; CHANNEL_TYPE_UNSUPPORTED for a website private chat), 404 no such channel or person (CONTACT_NOT_FOUND), 409 a person with several conversations (CONTACT_AMBIGUOUS). */
   getChannelGuidance(options?: GetChannelGuidanceOptions): Promise<GetChannelGuidanceResponse>;
   getChannelGuidance(channelId: string, options?: Omit<GetChannelGuidanceOptions, 'params'>): Promise<GetChannelGuidanceResponse>;
@@ -3966,6 +4074,8 @@ export declare class RealtimeXClient {
   /** List the friends or contacts of a Zalo Personal or WhatsApp account by name, with the ids to use in set-channel-access --add-allow-from or set-channel-chat --chat-type dm --chat-id. Errors: 400 another channel type (CHANNEL_TYPE_UNSUPPORTED) or the account is not logged in, 404 no such channel. */
   listChannelFriends(options?: ListChannelFriendsOptions): Promise<ListChannelFriendsResponse>;
   listChannelFriends(channelId: string, options?: Omit<ListChannelFriendsOptions, 'params'>): Promise<ListChannelFriendsResponse>;
+  /** List the Message gate batteries: the built-in channel-gate (Follow guidance) and this workspace\'s batteries in .realtimex-decisions/batteries with policy kind gate. Each has its questions, rule ids, the lock identities it ships and whether it is tuned for the active decision model (an untuned battery wakes more often; calibrate it with calibrate-channel-gate). No model call. */
+  listChannelGateBatteries(options?: ListChannelGateBatteriesOptions): Promise<ListChannelGateBatteriesResponse>;
   /** List the groups of a Zalo Personal or WhatsApp account by name, with the ids to use in set-channel-chat --chat-type group --chat-id. Errors: 400 another channel type (CHANNEL_TYPE_UNSUPPORTED) or the account is not logged in, 404 no such channel. */
   listChannelGroups(options?: ListChannelGroupsOptions): Promise<ListChannelGroupsResponse>;
   listChannelGroups(channelId: string, options?: Omit<ListChannelGroupsOptions, 'params'>): Promise<ListChannelGroupsResponse>;
@@ -4158,6 +4268,9 @@ export declare class RealtimeXClient {
   /** Change one chat of a channel, as the Chats tab does. Name it with chatType (group or dm) and chatId (from list-channel-groups or list-channel-friends; for a private chat also a sealed sender_handle cu_<n>, or on Pancake the conversation id or the person\'s id). Any chat: guidance (or clearGuidance) is the chat\'s own guidance, always used when set, and useFrom picks which levels above it apply: a group uses all (All chats) and groups (All groups), a private chat all and private (All private chats); each on, off or inherit (follow the level above), for example all=off,groups=on. get-channel-guidance shows what the agent then sees. Zalo Personal and WhatsApp only: for a group allow (turn it on or off) and replyMode; for a private chat picked (on or off the list under only people I pick); for either routeWorkspaceId and routeThreadId send the chat to that workspace or thread, clearRoute sends it back to the channel\'s own. Other channel types take guidance, clearGuidance and useFrom only; website takes none. Only the fields you pass change. Turning a group on, picking a person, replies to every message and any route change wait for the owner on the desktop when run from a terminal answering an external chat. Errors: 400 invalid chat or field (CHANNEL_TYPE_UNSUPPORTED for a field this channel type does not have; USE_FROM_INVALID_KEY or USE_FROM_INVALID_VALUE for useFrom; CHANNEL_GUIDANCE_TOO_LONG above 4,000 characters), 403 a route into or out of a workspace this session cannot reach (ISOLATED_WORKSPACE_CROSSING_REFUSED), 404 no such channel or person (CONTACT_NOT_FOUND), 409 picked while the channel does not use only people I pick, or a person with several conversations (CONTACT_AMBIGUOUS, lists them). */
   setChannelChat(options?: SetChannelChatOptions): Promise<SetChannelChatResponse>;
   setChannelChat(channelId: string, body: SetChannelChatBody, options?: Omit<SetChannelChatOptions, 'params' | 'body'>): Promise<SetChannelChatResponse>;
+  /** Set the Message gate of one level (level all, private or groups) or one chat (chatType group or dm with chatId; a group may also take chatName; a private chat also a sealed sender_handle cu_<n>). mode off (default everywhere) lets every message wake the agent; on screens each incoming message with the gate battery (one decision-model call when a rule needs it) and wakes the agent, holds the message (saved, readable in channel-act history) or drops it; shadow evaluates and logs but always wakes. battery is a gate battery id (list-channel-gate-batteries) or null for the built-in Follow guidance battery (channel-gate). clear removes the setting at that level, so it follows the level above. The nearest level that sets the gate wins. Agent decides chats only. With a decision model that runs off this computer, the owner must confirm in Settings before any message is sent out; until then every message wakes the agent and get-channel-gate reports status consent_pending. Errors: 400 invalid level or chat (GATE_LEVEL_INVALID, INVALID_CHAT), mode (GATE_MODE_INVALID), battery (GATE_BATTERY_INVALID, GATE_BATTERY_UNKNOWN, GATE_BATTERY_NOT_GATE) or nothing to change (NOTHING_TO_UPDATE, CONFLICTING_FIELDS), 404 no such channel or person, 409 a person with several conversations (CONTACT_AMBIGUOUS). */
+  setChannelGate(options?: SetChannelGateOptions): Promise<SetChannelGateResponse>;
+  setChannelGate(channelId: string, body: SetChannelGateBody, options?: Omit<SetChannelGateOptions, 'params' | 'body'>): Promise<SetChannelGateResponse>;
   /** Set the guidance of one default level of a channel. level all is All chats (every chat; the same text as update-channel --agent-guidance), private is All private chats and groups is All groups. guidance (or clearGuidance) is the level\'s own text, up to 4,000 characters. useFrom (private and groups only) picks whether All chats applies: all=on, off or inherit. Unticks pass down: a chat follows the level above unless it changed that box itself. Each chat can add its own guidance with set-channel-chat. get-channel-guidance shows the combined text the agent sees; above 8,000 characters it warns but still saves. Errors: 400 invalid level (GUIDANCE_LEVEL_INVALID), useFrom on all (USE_FROM_NOT_ALLOWED), a wrong box (USE_FROM_INVALID_KEY or USE_FROM_INVALID_VALUE) or text over 4,000 characters (CHANNEL_GUIDANCE_TOO_LONG), 404 no such channel. */
   setChannelGuidance(options?: SetChannelGuidanceOptions): Promise<SetChannelGuidanceResponse>;
   setChannelGuidance(channelId: string, body: SetChannelGuidanceBody, options?: Omit<SetChannelGuidanceOptions, 'params' | 'body'>): Promise<SetChannelGuidanceResponse>;

package/index.js

@@ -31,6 +31,16 @@ const operations = {
     "headerParams": [],
     "hasBody": true
   },
+  "calibrateChannelGate": {
+    "method": "POST",
+    "path": "/calibrate-channel-gate",
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": true
+  },
   "calibrateDecisionBattery": {
     "method": "POST",
     "path": "/calibrate-decision-battery",
@@ -422,6 +432,39 @@ const operations = {
     ],
     "hasBody": false
   },
+  "getChannelGate": {
+    "method": "GET",
+    "path": "/get-channel-gate/{channelId}",
+    "pathParams": [
+      "channelId"
+    ],
+    "queryParams": [
+      "level",
+      "chatType",
+      "chatId",
+      "chatName"
+    ],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": false
+  },
+  "getChannelGateDecisions": {
+    "method": "GET",
+    "path": "/get-channel-gate-decisions/{channelId}",
+    "pathParams": [
+      "channelId"
+    ],
+    "queryParams": [
+      "chatType",
+      "chatId",
+      "limit"
+    ],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": false
+  },
   "getChannelGuidance": {
     "method": "GET",
     "path": "/get-channel-guidance/{channelId}",
@@ -718,6 +761,16 @@ const operations = {
     ],
     "hasBody": false
   },
+  "listChannelGateBatteries": {
+    "method": "GET",
+    "path": "/list-channel-gate-batteries",
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": false
+  },
   "listChannelGroups": {
     "method": "GET",
     "path": "/list-channel-groups/{channelId}",
@@ -1527,6 +1580,18 @@ const operations = {
     ],
     "hasBody": true
   },
+  "setChannelGate": {
+    "method": "POST",
+    "path": "/set-channel-gate/{channelId}",
+    "pathParams": [
+      "channelId"
+    ],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": true
+  },
   "setChannelGuidance": {
     "method": "POST",
     "path": "/set-channel-guidance/{channelId}",
@@ -2364,6 +2429,13 @@ class RealtimeXClient {
     );
   }
 
+  calibrateChannelGate(...args) {
+    return this.request(
+      "calibrateChannelGate",
+      normalizeOperationOptions(operations["calibrateChannelGate"], args)
+    );
+  }
+
   calibrateDecisionBattery(...args) {
     return this.request(
       "calibrateDecisionBattery",
@@ -2623,6 +2695,20 @@ class RealtimeXClient {
     );
   }
 
+  getChannelGate(...args) {
+    return this.request(
+      "getChannelGate",
+      normalizeOperationOptions(operations["getChannelGate"], args)
+    );
+  }
+
+  getChannelGateDecisions(...args) {
+    return this.request(
+      "getChannelGateDecisions",
+      normalizeOperationOptions(operations["getChannelGateDecisions"], args)
+    );
+  }
+
   getChannelGuidance(...args) {
     return this.request(
       "getChannelGuidance",
@@ -2805,6 +2891,13 @@ class RealtimeXClient {
     );
   }
 
+  listChannelGateBatteries(...args) {
+    return this.request(
+      "listChannelGateBatteries",
+      normalizeOperationOptions(operations["listChannelGateBatteries"], args)
+    );
+  }
+
   listChannelGroups(...args) {
     return this.request(
       "listChannelGroups",
@@ -3316,6 +3409,13 @@ class RealtimeXClient {
     );
   }
 
+  setChannelGate(...args) {
+    return this.request(
+      "setChannelGate",
+      normalizeOperationOptions(operations["setChannelGate"], args)
+    );
+  }
+
   setChannelGuidance(...args) {
     return this.request(
       "setChannelGuidance",
@@ -3593,5 +3693,5 @@ module.exports = {
   createRealtimeXClient,
   createRealtimeXWebhookClient,
   operations,
-  version: "2.0.66",
+  version: "2.0.68",
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "2.0.66",
+    "version": "2.0.68",
     "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.66. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.68. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.66`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.68`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.66
+npm install -g @realtimex/pp-cli@2.0.68
 ```
 
 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.66. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.68. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.66`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.68`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.66
+npm install -g @realtimex/pp-cli@2.0.68
 ```
 
 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.66. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.68. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.66`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.68`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.66
+npm install -g @realtimex/pp-cli@2.0.68
 ```
 
 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: who can use
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.66. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.68. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.66`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.68`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.66
+npm install -g @realtimex/pp-cli@2.0.68
 ```
 
 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.
 
+**calibrate-channel-gate** — Manage calibrate channel gate
+
+- `realtimex-pp-cli calibrate-channel-gate` — Fit per-model thresholds for a Message gate battery from labelled messages
+
 **channel-act** — Manage channel act
 
 - `realtimex-pp-cli channel-act <control>` — Run one control of the external chat this terminal answers (Zalo Personal first)
@@ -59,6 +63,14 @@ realtimex-pp-cli prepare --agent
 
 - `realtimex-pp-cli get-channel <channelId>` — Show one chat channel by exact channel id: its non-secret settings, who can use it (whoCanUse), access policies
 
+**get-channel-gate** — Manage get channel gate
+
+- `realtimex-pp-cli get-channel-gate <channelId>` — The Message gate of one level (level all, private or groups) or one chat (chatType group or dm with chatId
+
+**get-channel-gate-decisions** — Manage get channel gate decisions
+
+- `realtimex-pp-cli get-channel-gate-decisions <channelId>` — One chat's recent Message gate decisions, newest first (chatType group or dm with chatId; limit up to 100, default 20)
+
 **get-channel-guidance** — Manage get channel guidance
 
 - `realtimex-pp-cli get-channel-guidance <channelId>` — What the agent sees: the combined guidance of one level (level all, private or groups)
@@ -75,6 +87,10 @@ realtimex-pp-cli prepare --agent
 
 - `realtimex-pp-cli list-channel-friends <channelId>` — List the friends or contacts of a Zalo Personal or WhatsApp account by name
 
+**list-channel-gate-batteries** — Manage list channel gate batteries
+
+- `realtimex-pp-cli list-channel-gate-batteries` — List the Message gate batteries: the built-in channel-gate (Follow guidance) and this workspace's batteries in .
+
 **list-channel-groups** — Manage list channel groups
 
 - `realtimex-pp-cli list-channel-groups <channelId>` — List the groups of a Zalo Personal or WhatsApp account by name
@@ -139,6 +155,10 @@ realtimex-pp-cli prepare --agent
 
 - `realtimex-pp-cli set-channel-chat <channelId>` — Change one chat of a channel, as the Chats tab does.
 
+**set-channel-gate** — Manage set channel gate
+
+- `realtimex-pp-cli set-channel-gate <channelId>` — Set the Message gate of one level (level all, private or groups) or one chat (chatType group or dm with chatId
+
 **set-channel-guidance** — Manage set channel guidance
 
 - `realtimex-pp-cli set-channel-guidance <channelId>` — Set the guidance of one default level of a 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.66. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.68. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.66`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.68`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.66
+npm install -g @realtimex/pp-cli@2.0.68
 ```
 
 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.66. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.68. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.66`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.68`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.66
+npm install -g @realtimex/pp-cli@2.0.68
 ```
 
 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.66. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.68. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.66`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.68`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.66
+npm install -g @realtimex/pp-cli@2.0.68
 ```
 
 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.66. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.68. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.66`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.68`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.66
+npm install -g @realtimex/pp-cli@2.0.68
 ```
 
 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.66. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.68. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.66`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.68`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.66
+npm install -g @realtimex/pp-cli@2.0.68
 ```
 
 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.66. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.68. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.66`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.68`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.66
+npm install -g @realtimex/pp-cli@2.0.68
 ```
 
 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.66. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.68. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.66`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.68`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.66
+npm install -g @realtimex/pp-cli@2.0.68
 ```
 
 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.66. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.68. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.66`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.68`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.66
+npm install -g @realtimex/pp-cli@2.0.68
 ```
 
 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.66. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.68. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.66`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.68`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.66
+npm install -g @realtimex/pp-cli@2.0.68
 ```
 
 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.66. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.68. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.66`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.68`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.66
+npm install -g @realtimex/pp-cli@2.0.68
 ```
 
 For requests about the current workspace or thread, resolve context first: