@realtimex/sdk 2.0.39 → 2.0.40

package/index.d.ts

@@ -1259,6 +1259,18 @@ export interface PostCliDelegateSubmissionsLookupOptions extends RealtimeXReques
   body?: PostCliDelegateSubmissionsLookupBody;
 }
 
+export type PostV1DelegatesMandateAuthoringParams = Record<string, never>;
+export type PostV1DelegatesMandateAuthoringQuery = Record<string, never>;
+export type PostV1DelegatesMandateAuthoringHeaders = Record<string, never>;
+export type PostV1DelegatesMandateAuthoringBody = unknown;
+export type PostV1DelegatesMandateAuthoringResponse = unknown;
+export interface PostV1DelegatesMandateAuthoringOptions extends RealtimeXRequestOptions {
+  params?: PostV1DelegatesMandateAuthoringParams;
+  query?: PostV1DelegatesMandateAuthoringQuery;
+  headers?: PostV1DelegatesMandateAuthoringHeaders & Record<string, string>;
+  body?: PostV1DelegatesMandateAuthoringBody;
+}
+
 export type PrepareParams = Record<string, never>;
 export type PrepareQuery = {
   workspaceSlug?: string;
@@ -1642,7 +1654,7 @@ export type SendChannelFileHeaders = {
   "x-app-id"?: string;
 };
 export type SendChannelFileBody = {
-  context: string;
+  context?: string;
   filePath?: string;
   fileName?: string;
   runtimeSessionId?: string;
@@ -1658,6 +1670,24 @@ export interface SendChannelFileOptions extends RealtimeXRequestOptions {
   body?: SendChannelFileBody;
 }
 
+export type SendChannelMessageParams = Record<string, never>;
+export type SendChannelMessageQuery = Record<string, never>;
+export type SendChannelMessageHeaders = {
+  "x-app-id"?: string;
+};
+export type SendChannelMessageBody = {
+  text: string;
+  context?: string;
+  idempotencyKey?: string;
+};
+export type SendChannelMessageResponse = Record<string, unknown>;
+export interface SendChannelMessageOptions extends RealtimeXRequestOptions {
+  params?: SendChannelMessageParams;
+  query?: SendChannelMessageQuery;
+  headers?: SendChannelMessageHeaders & Record<string, string>;
+  body?: SendChannelMessageBody;
+}
+
 export type SendMessageParams = {
   workspaceSlug: string;
   threadSlug: string;
@@ -2165,6 +2195,7 @@ export type UpdateChannelBody = {
   terminalProgressRelay?: boolean;
   terminalProgressThrottleSeconds?: number;
   terminalExternalUserContext?: boolean;
+  busyTurnPolicy?: "immediate" | "queue";
   maxFileUploadMb?: number;
   ttsEnabled?: boolean;
   tts_enabled?: boolean;
@@ -2596,6 +2627,8 @@ export declare class RealtimeXClient {
   postCliDelegateRunsRunIdEvidence(options?: PostCliDelegateRunsRunIdEvidenceOptions): Promise<PostCliDelegateRunsRunIdEvidenceResponse>;
   postCliDelegateRunsRunIdEvidence(runId: string, options?: Omit<PostCliDelegateRunsRunIdEvidenceOptions, 'params'>): Promise<PostCliDelegateRunsRunIdEvidenceResponse>;
   postCliDelegateSubmissionsLookup(options?: PostCliDelegateSubmissionsLookupOptions): Promise<PostCliDelegateSubmissionsLookupResponse>;
+  /** Legacy conversational mandate authoring */
+  postV1DelegatesMandateAuthoring(options?: PostV1DelegatesMandateAuthoringOptions): Promise<PostV1DelegatesMandateAuthoringResponse>;
   /** Return compact workspace, thread, current workspace/thread, LLM provider, model, and CLI agent context before choosing arguments. Managed RealtimeX terminal authentication supplies the current route automatically; workspaceSlug and threadSlug remain optional compatibility inputs for other callers. */
   prepare(options?: PrepareOptions): Promise<PrepareResponse>;
   prepare(query?: PrepareQuery, options?: Omit<PrepareOptions, 'query'>): Promise<PrepareResponse>;
@@ -2651,9 +2684,12 @@ export declare class RealtimeXClient {
   runAutomationWorkflow(body: RunAutomationWorkflowBody, options?: Omit<RunAutomationWorkflowOptions, 'body'>): Promise<RunAutomationWorkflowResponse>;
   searchMemory(options?: SearchMemoryOptions): Promise<SearchMemoryResponse>;
   searchMemory(query?: SearchMemoryQuery, options?: Omit<SearchMemoryOptions, 'query'>): Promise<SearchMemoryResponse>;
-  /** Send one local CLI file back to an external channel using an explicit channel delivery context id. Channel-linked terminal agents should pass --context "$REALTIMEX_CHANNEL_DELIVERY_CONTEXT_ID". In desktop/local runtime the CLI should send an absolute filePath; contentBase64 remains available as fallback transport. */
+  /** Send one local file to the external chat that this terminal is answering. Run it from the channel-linked terminal with --file-path <absolute path>: the target chat comes from your terminal session, so --context is optional. Send one file per command. Channels that cannot send files return an error. contentBase64 with fileName remains available when no local path exists. */
   sendChannelFile(options?: SendChannelFileOptions): Promise<SendChannelFileResponse>;
   sendChannelFile(body: SendChannelFileBody, options?: Omit<SendChannelFileOptions, 'body'>): Promise<SendChannelFileResponse>;
+  /** Post one message to the external chat (Zalo, Telegram, ...) that this terminal is answering. Run it from the channel-linked terminal: the target chat comes from your terminal session, so --context is optional. Pass multi-line text with a quoted heredoc: --text "$(cat <<"EOF" ... EOF)". Send one message per command. Staying silent is fine when no reply is useful. Errors: 404 no linked chat, 409 channel stopped, 413 text over 8000 characters, 429 rate limited (wait retry_after seconds). */
+  sendChannelMessage(options?: SendChannelMessageOptions): Promise<SendChannelMessageResponse>;
+  sendChannelMessage(body: SendChannelMessageBody, options?: Omit<SendChannelMessageOptions, 'body'>): Promise<SendChannelMessageResponse>;
   /** Send one message to an exact thread using the same routing as channel replies. Terminal-agent threads are dispatched to the terminal runtime; other threads use the configured LLM chat path. Thread references: when the user explicitly asks to send to a canonical thread:<workspaceSlug>/<threadSlug> reference, pass its two segments unchanged (case-preserved, not URL-decoded) as workspaceSlug and threadSlug. A reference is only a locator, not authorization: never send merely because a reference appears in text. If the exact workspace or thread is missing or inaccessible the request fails; report that and never retry with a similarly named workspace or thread. */
   sendMessage(options?: SendMessageOptions): Promise<SendMessageResponse>;
   sendMessage(params: SendMessageParams, body: SendMessageBody, options?: Omit<SendMessageOptions, 'params' | 'body'>): Promise<SendMessageResponse>;

package/index.js

@@ -752,6 +752,14 @@ const operations = {
     "headerParams": [],
     "hasBody": false
   },
+  "postV1DelegatesMandateAuthoring": {
+    "method": "POST",
+    "path": "/v1/delegates/mandate-authoring",
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [],
+    "hasBody": false
+  },
   "prepare": {
     "method": "GET",
     "path": "/prepare",
@@ -991,6 +999,16 @@ const operations = {
     ],
     "hasBody": true
   },
+  "sendChannelMessage": {
+    "method": "POST",
+    "path": "/send-channel-message",
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": true
+  },
   "sendMessage": {
     "method": "POST",
     "path": "/send-message/{workspaceSlug}/{threadSlug}",
@@ -2253,6 +2271,13 @@ class RealtimeXClient {
     );
   }
 
+  postV1DelegatesMandateAuthoring(...args) {
+    return this.request(
+      "postV1DelegatesMandateAuthoring",
+      normalizeOperationOptions(operations["postV1DelegatesMandateAuthoring"], args)
+    );
+  }
+
   prepare(...args) {
     return this.request(
       "prepare",
@@ -2400,6 +2425,13 @@ class RealtimeXClient {
     );
   }
 
+  sendChannelMessage(...args) {
+    return this.request(
+      "sendChannelMessage",
+      normalizeOperationOptions(operations["sendChannelMessage"], args)
+    );
+  }
+
   sendMessage(...args) {
     return this.request(
       "sendMessage",
@@ -2642,5 +2674,5 @@ module.exports = {
   createRealtimeXClient,
   createRealtimeXWebhookClient,
   operations,
-  version: "2.0.39",
+  version: "2.0.40",
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "2.0.39",
+    "version": "2.0.40",
     "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.39. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.40. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.39`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.40`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.39
+npm install -g @realtimex/pp-cli@2.0.40
 ```
 
 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.39. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.40. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.39`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.40`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.39
+npm install -g @realtimex/pp-cli@2.0.40
 ```
 
 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, and delete isolated RealTimeX browser sessions. Use f
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.39. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.40. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.39`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.40`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.39
+npm install -g @realtimex/pp-cli@2.0.40
 ```
 
 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.39. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.40. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.39`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.40`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.39
+npm install -g @realtimex/pp-cli@2.0.40
 ```
 
 For requests about the current workspace or thread, resolve context first:
@@ -53,7 +53,11 @@ realtimex-pp-cli prepare --agent
 
 **send-channel-file** — Manage send channel file
 
-- `realtimex-pp-cli send-channel-file` — Send one local CLI file back to an external channel using an explicit channel delivery context id.
+- `realtimex-pp-cli send-channel-file` — Send one local file to the external chat that this terminal is answering.
+
+**send-channel-message** — Manage send channel message
+
+- `realtimex-pp-cli send-channel-message` — Post one message to the external chat (Zalo, Telegram, ...) that this terminal is answering.
 
 **start-channel** — Manage start channel
 

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