@realtimex/sdk 2.0.65 → 2.0.67

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,68 @@ 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;
+};
+export type GetChannelGuidanceQuery = {
+  level?: string;
+  chatType?: string;
+  chatId?: string;
+  chatName?: string;
+};
+export type GetChannelGuidanceHeaders = {
+  "x-app-id"?: string;
+};
+export type GetChannelGuidanceBody = unknown;
+export type GetChannelGuidanceResponse = Record<string, unknown>;
+export interface GetChannelGuidanceOptions extends RealtimeXRequestOptions {
+  params?: GetChannelGuidanceParams;
+  query?: GetChannelGuidanceQuery;
+  headers?: GetChannelGuidanceHeaders & Record<string, string>;
+  body?: GetChannelGuidanceBody;
+}
+
 export type GetChannelWebhookParams = {
   channelId: string;
 };
@@ -1381,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;
 };
@@ -2777,6 +2873,7 @@ export type SetChannelChatBody = {
   replyMode?: "mention" | "always" | "agent";
   guidance?: string;
   clearGuidance?: boolean;
+  useFrom?: string;
   picked?: boolean;
   routeWorkspaceId?: number;
   routeThreadId?: number;
@@ -2790,6 +2887,51 @@ 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;
+};
+export type SetChannelGuidanceQuery = Record<string, never>;
+export type SetChannelGuidanceHeaders = {
+  "x-app-id"?: string;
+};
+export type SetChannelGuidanceBody = {
+  level: "all" | "private" | "groups";
+  guidance?: string;
+  clearGuidance?: boolean;
+  useFrom?: string;
+};
+export type SetChannelGuidanceResponse = Record<string, unknown>;
+export interface SetChannelGuidanceOptions extends RealtimeXRequestOptions {
+  params?: SetChannelGuidanceParams;
+  query?: SetChannelGuidanceQuery;
+  headers?: SetChannelGuidanceHeaders & Record<string, string>;
+  body?: SetChannelGuidanceBody;
+}
+
 export type SetDefaultWorkspaceAgentParams = Record<string, never>;
 export type SetDefaultWorkspaceAgentQuery = Record<string, never>;
 export type SetDefaultWorkspaceAgentHeaders = Record<string, never>;
@@ -3495,6 +3637,7 @@ export type UpdateChannelGroupRuleBody = {
   replyMode?: "mention" | "always" | "agent";
   guidance?: string;
   clearGuidance?: boolean;
+  useFrom?: string;
   targetGroupId?: string;
 };
 export type UpdateChannelGroupRuleResponse = Record<string, unknown>;
@@ -3750,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>;
@@ -3851,9 +3997,18 @@ export declare class RealtimeXClient {
   /** Get one public artifact by artifact id. */
   getArtifact(options?: GetArtifactOptions): Promise<GetArtifactResponse>;
   getArtifact(artifactId: string, options?: Omit<GetArtifactOptions, 'params'>): Promise<GetArtifactResponse>;
-  /** 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 and guidancePolicy. Tokens, app secrets and account sessions are never returned. Errors: 404 no such channel, or one in a workspace this caller cannot reach. */
+  /** 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>;
   getChannelWebhook(options?: GetChannelWebhookOptions): Promise<GetChannelWebhookResponse>;
   getChannelWebhook(channelId: string, options?: Omit<GetChannelWebhookOptions, 'params'>): Promise<GetChannelWebhookResponse>;
   getDelegateMandate(options?: GetDelegateMandateOptions): Promise<GetDelegateMandateResponse>;
@@ -3919,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>;
@@ -4108,9 +4265,15 @@ export declare class RealtimeXClient {
   /** Set who can use one channel, as Settings › Channels › Who can use it does. Only the fields you pass change. Private chats (dmPolicy): open (anyone), pairing (people I approve; not on Pancake), allowlist (only people I pick) or disabled. On Zalo Personal and WhatsApp also: groups (groupPolicy open, allowlist = only groups I turn on, or disabled), requireMention and replyMode for groups, the picked people (addAllowFrom/removeAllowFrom, ids from list-channel-friends) and the trusted members whose new groups turn on automatically (addTrustedMembers/removeTrustedMembers). Switching to allowlist while people can use the agent privately needs approvedPeople keep (they join the list) or pause. Pancake also takes its picked conversations (addAllowFrom/removeAllowFrom, Pancake conversation ids) and an invite code testers send to be picked (inviteCode create with inviteHours and inviteMaxUses, or inviteCode revoke; leaving allowlist revokes it); anyone else who messages the page is ignored. Other channel types take dmPolicy only. Anything that may widen access (any policy but disabled, adding people or members, creating an invite code, mentions not required, replies to every message) waits for the owner on the desktop when run from a terminal answering an external chat. Errors: 400 invalid value or a setting this channel type does not have, 404 no such channel, 409 approvedPeople needed. */
   setChannelAccess(options?: SetChannelAccessOptions): Promise<SetChannelAccessResponse>;
   setChannelAccess(channelId: string, body: SetChannelAccessBody, options?: Omit<SetChannelAccessOptions, 'params' | 'body'>): Promise<SetChannelAccessResponse>;
-  /** Change one chat of a Zalo Personal or WhatsApp 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 group: allow (turn it on or off), replyMode and guidance (or clearGuidance). 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. 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 other channel types), 403 a route into or out of a workspace this session cannot reach (ISOLATED_WORKSPACE_CROSSING_REFUSED), 404 no such channel, 409 picked while the channel does not use only people I pick. */
+  /** 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>;
   /** 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>;
@@ -4192,7 +4355,7 @@ export declare class RealtimeXClient {
   /** Update one chat channel by exact channel id. Only the fields you pass change; every other setting, the token and the account session keep their values. Limits keep the server floors and ceilings: an out-of-range value returns 400 LIMIT_OUT_OF_RANGE with the allowed min and max, and nothing is saved. From a terminal answering an external chat, a change that may widen access or loosen a limit (dmPolicy other than disabled, workspaceId, a rate limit, pacing or splitting off, enabling slash commands, approvalPrompts chat) waits for the owner on the desktop. Errors: 400 invalid value or nothing to update, 403 a move into or out of a client-isolated workspace (desktop owner only), 404 no such channel, or one in a workspace this caller cannot reach, 409 a move while a Take over runs. */
   updateChannel(options?: UpdateChannelOptions): Promise<UpdateChannelResponse>;
   updateChannel(channelId: string, body: UpdateChannelBody, options?: Omit<UpdateChannelOptions, 'params' | 'body'>): Promise<UpdateChannelResponse>;
-  /** Change one group name rule of a Zalo Personal or WhatsApp channel (the rules under get-channel policies.groups whose key is a name pattern, not a group id). action update sets allow, replyMode or guidance (or clearGuidance); remove deletes the rule; apply copies the rule onto one group (targetGroupId) and deletes the rule. Removing or applying a rule, turning it on and replies to every message wait for the owner on the desktop when run from a terminal answering an external chat. Errors: 400 invalid rule (CHANNEL_TYPE_UNSUPPORTED for other channel types), 404 no such channel or rule. */
+  /** Change one group name rule of a Zalo Personal or WhatsApp channel (the rules under get-channel policies.groups whose key is a name pattern, not a group id). action update sets allow, replyMode or guidance (or clearGuidance) and useFrom (all, groups: on, off or inherit); the key * is All groups, whose guidance and useFrom are saved as that level (set-channel-guidance --level groups); remove deletes the rule; apply copies the rule onto one group (targetGroupId) and deletes the rule. Removing or applying a rule, turning it on and replies to every message wait for the owner on the desktop when run from a terminal answering an external chat. Errors: 400 invalid rule (CHANNEL_TYPE_UNSUPPORTED for other channel types), 404 no such channel or rule. */
   updateChannelGroupRule(options?: UpdateChannelGroupRuleOptions): Promise<UpdateChannelGroupRuleResponse>;
   updateChannelGroupRule(channelId: string, body: UpdateChannelGroupRuleBody, options?: Omit<UpdateChannelGroupRuleOptions, 'params' | 'body'>): Promise<UpdateChannelGroupRuleResponse>;
   updateLocalApp(options?: UpdateLocalAppOptions): Promise<UpdateLocalAppResponse>;

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,56 @@ 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}",
+    "pathParams": [
+      "channelId"
+    ],
+    "queryParams": [
+      "level",
+      "chatType",
+      "chatId",
+      "chatName"
+    ],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": false
+  },
   "getChannelWebhook": {
     "method": "GET",
     "path": "/get-channel-webhook/{channelId}",
@@ -701,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}",
@@ -1510,6 +1580,30 @@ 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}",
+    "pathParams": [
+      "channelId"
+    ],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": true
+  },
   "setDefaultWorkspaceAgent": {
     "method": "POST",
     "path": "/set-default-workspace-agent",
@@ -2335,6 +2429,13 @@ class RealtimeXClient {
     );
   }
 
+  calibrateChannelGate(...args) {
+    return this.request(
+      "calibrateChannelGate",
+      normalizeOperationOptions(operations["calibrateChannelGate"], args)
+    );
+  }
+
   calibrateDecisionBattery(...args) {
     return this.request(
       "calibrateDecisionBattery",
@@ -2594,6 +2695,27 @@ 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",
+      normalizeOperationOptions(operations["getChannelGuidance"], args)
+    );
+  }
+
   getChannelWebhook(...args) {
     return this.request(
       "getChannelWebhook",
@@ -2769,6 +2891,13 @@ class RealtimeXClient {
     );
   }
 
+  listChannelGateBatteries(...args) {
+    return this.request(
+      "listChannelGateBatteries",
+      normalizeOperationOptions(operations["listChannelGateBatteries"], args)
+    );
+  }
+
   listChannelGroups(...args) {
     return this.request(
       "listChannelGroups",
@@ -3280,6 +3409,20 @@ class RealtimeXClient {
     );
   }
 
+  setChannelGate(...args) {
+    return this.request(
+      "setChannelGate",
+      normalizeOperationOptions(operations["setChannelGate"], args)
+    );
+  }
+
+  setChannelGuidance(...args) {
+    return this.request(
+      "setChannelGuidance",
+      normalizeOperationOptions(operations["setChannelGuidance"], args)
+    );
+  }
+
   setDefaultWorkspaceAgent(...args) {
     return this.request(
       "setDefaultWorkspaceAgent",
@@ -3550,5 +3693,5 @@ module.exports = {
   createRealtimeXClient,
   createRealtimeXWebhookClient,
   operations,
-  version: "2.0.65",
+  version: "2.0.67",
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "2.0.65",
+    "version": "2.0.67",
     "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.65. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.67. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.65`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.67`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.65
+npm install -g @realtimex/pp-cli@2.0.67
 ```
 
 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.65. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.67. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.65`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.67`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.65
+npm install -g @realtimex/pp-cli@2.0.67
 ```
 
 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.65. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.67. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.65`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.67`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.65
+npm install -g @realtimex/pp-cli@2.0.67
 ```
 
 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.65. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.67. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.65`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.67`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.65
+npm install -g @realtimex/pp-cli@2.0.67
 ```
 
 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,18 @@ 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)
+
 **get-channel-webhook** — Manage get channel webhook
 
 - `realtimex-pp-cli get-channel-webhook <channelId>` — Get channel webhook
@@ -71,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
@@ -133,7 +153,15 @@ realtimex-pp-cli prepare --agent
 
 **set-channel-chat** — Manage set channel chat
 
-- `realtimex-pp-cli set-channel-chat <channelId>` — Change one chat of a Zalo Personal or WhatsApp channel, as the Chats tab does.
+- `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.
 
 **start-channel** — Manage start 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.65. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.67. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.65`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.67`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.65
+npm install -g @realtimex/pp-cli@2.0.67
 ```
 
 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.65. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.67. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.65`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.67`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.65
+npm install -g @realtimex/pp-cli@2.0.67
 ```
 
 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.65. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.67. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.65`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.67`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.65
+npm install -g @realtimex/pp-cli@2.0.67
 ```
 
 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.65. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.67. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.65`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.67`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.65
+npm install -g @realtimex/pp-cli@2.0.67
 ```
 
 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.65. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.67. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.65`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.67`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.65
+npm install -g @realtimex/pp-cli@2.0.67
 ```
 
 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.65. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.67. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.65`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.67`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.65
+npm install -g @realtimex/pp-cli@2.0.67
 ```
 
 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.65. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.67. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.65`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.67`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.65
+npm install -g @realtimex/pp-cli@2.0.67
 ```
 
 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.65. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.67. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.65`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.67`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.65
+npm install -g @realtimex/pp-cli@2.0.67
 ```
 
 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.65. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.67. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.65`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.67`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.65
+npm install -g @realtimex/pp-cli@2.0.67
 ```
 
 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.65. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.67. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.65`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.67`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.65
+npm install -g @realtimex/pp-cli@2.0.67
 ```
 
 For requests about the current workspace or thread, resolve context first: