@realtimex/sdk 2.0.6 → 2.0.8

package/dist/chunk-SFY6E7TY.mjs

@@ -0,0 +1,132 @@
+import {
+  AuthenticationError,
+  DeveloperApiError,
+  NotFoundError,
+  ServerError,
+  ValidationError
+} from "./chunk-UPXEAZIT.mjs";
+
+// src/cli/client.ts
+var CliApiClient = class {
+  constructor(baseUrl, apiKey, appId) {
+    this.baseUrl = baseUrl.replace(/\/$/, "");
+    this.apiKey = apiKey;
+    this.appId = appId;
+  }
+  getHeaders(extra) {
+    const headers = {
+      "Content-Type": "application/json",
+      "Authorization": `Bearer ${this.apiKey}`
+    };
+    if (this.appId) headers["x-app-id"] = this.appId;
+    return { ...headers, ...extra };
+  }
+  async handleResponse(response) {
+    let data;
+    try {
+      data = await response.json();
+    } catch {
+      data = {};
+    }
+    if (response.ok) return data;
+    const message = data?.message || data?.error || response.statusText || "Request failed";
+    switch (response.status) {
+      case 400:
+        throw new ValidationError(message);
+      case 401:
+      case 403:
+        throw new AuthenticationError(message);
+      case 404:
+        throw new NotFoundError(message);
+      case 500:
+      case 502:
+      case 503:
+        throw new ServerError(message);
+      default:
+        throw new DeveloperApiError(response.status, "API_ERROR", message);
+    }
+  }
+  async request(method, path, body) {
+    const url = `${this.baseUrl}/cli${path}`;
+    const response = await fetch(url, {
+      method,
+      headers: this.getHeaders(),
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+    return this.handleResponse(response);
+  }
+};
+
+// src/cli/namespace.ts
+var CliApiNamespace = class {
+  constructor(baseUrl, apiKey, appId) {
+    this._client = new CliApiClient(baseUrl, apiKey, appId);
+  }
+  async prepare() {
+    return this._client.request("GET", "/prepare");
+  }
+  async listWorkspaces() {
+    return this._client.request("GET", "/list-workspaces");
+  }
+  async createWorkspace(body) {
+    return this._client.request("POST", "/create-workspace", body);
+  }
+  async getWorkspace(workspaceSlug) {
+    return this._client.request("GET", `/get-workspace/${encodeURIComponent(workspaceSlug)}`);
+  }
+  async renameWorkspace(workspaceSlug, body) {
+    return this._client.request("POST", `/rename-workspace/${encodeURIComponent(workspaceSlug)}`, body);
+  }
+  async deleteWorkspace(workspaceSlug) {
+    return this._client.request("DELETE", `/delete-workspace/${encodeURIComponent(workspaceSlug)}`);
+  }
+  async setWorkspaceDefaultAgent(workspaceSlug, body) {
+    return this._client.request("POST", `/set-workspace-default-agent/${encodeURIComponent(workspaceSlug)}`, body);
+  }
+  async clearWorkspaceDefaultAgent(workspaceSlug) {
+    return this._client.request("DELETE", `/clear-workspace-default-agent/${encodeURIComponent(workspaceSlug)}`);
+  }
+  async listThreads(workspaceSlug) {
+    return this._client.request("GET", `/list-threads/${encodeURIComponent(workspaceSlug)}`);
+  }
+  async createThread(workspaceSlug, body) {
+    return this._client.request("POST", `/create-thread/${encodeURIComponent(workspaceSlug)}`, body);
+  }
+  async getThread(workspaceSlug, threadSlug) {
+    return this._client.request(
+      "GET",
+      `/get-thread/${encodeURIComponent(workspaceSlug)}/${encodeURIComponent(threadSlug)}`
+    );
+  }
+  async renameThread(workspaceSlug, threadSlug, body) {
+    return this._client.request(
+      "POST",
+      `/rename-thread/${encodeURIComponent(workspaceSlug)}/${encodeURIComponent(threadSlug)}`,
+      body
+    );
+  }
+  async deleteThread(workspaceSlug, threadSlug) {
+    return this._client.request(
+      "DELETE",
+      `/delete-thread/${encodeURIComponent(workspaceSlug)}/${encodeURIComponent(threadSlug)}`
+    );
+  }
+  async sendLlmMessage(workspaceSlug, threadSlug, body) {
+    return this._client.request(
+      "POST",
+      `/send-llm-message/${encodeURIComponent(workspaceSlug)}/${encodeURIComponent(threadSlug)}`,
+      body
+    );
+  }
+  async listLlmProviders() {
+    return this._client.request("GET", "/list-llm-providers");
+  }
+  async listLlmModels(provider) {
+    return this._client.request("GET", `/list-llm-models/${encodeURIComponent(provider)}`);
+  }
+};
+
+export {
+  CliApiClient,
+  CliApiNamespace
+};

package/dist/chunk-UPXEAZIT.mjs

@@ -0,0 +1,41 @@
+// src/v1/errors.ts
+var DeveloperApiError = class extends Error {
+  constructor(status, code, message) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.name = "DeveloperApiError";
+  }
+};
+var AuthenticationError = class extends DeveloperApiError {
+  constructor(message = "Invalid or missing API key") {
+    super(403, "AUTHENTICATION_ERROR", message);
+    this.name = "AuthenticationError";
+  }
+};
+var NotFoundError = class extends DeveloperApiError {
+  constructor(message = "Resource not found") {
+    super(404, "NOT_FOUND", message);
+    this.name = "NotFoundError";
+  }
+};
+var ValidationError = class extends DeveloperApiError {
+  constructor(message) {
+    super(400, "VALIDATION_ERROR", message);
+    this.name = "ValidationError";
+  }
+};
+var ServerError = class extends DeveloperApiError {
+  constructor(message = "Internal server error") {
+    super(500, "SERVER_ERROR", message);
+    this.name = "ServerError";
+  }
+};
+
+export {
+  DeveloperApiError,
+  AuthenticationError,
+  NotFoundError,
+  ValidationError,
+  ServerError
+};

package/dist/{chunk-DZUAP6FW.mjs → chunk-XKQRTTIC.mjs}

@@ -1,36 +1,10 @@
-// src/v1/errors.ts
-var DeveloperApiError = class extends Error {
-  constructor(status, code, message) {
-    super(message);
-    this.status = status;
-    this.code = code;
-    this.name = "DeveloperApiError";
-  }
-};
-var AuthenticationError = class extends DeveloperApiError {
-  constructor(message = "Invalid or missing API key") {
-    super(403, "AUTHENTICATION_ERROR", message);
-    this.name = "AuthenticationError";
-  }
-};
-var NotFoundError = class extends DeveloperApiError {
-  constructor(message = "Resource not found") {
-    super(404, "NOT_FOUND", message);
-    this.name = "NotFoundError";
-  }
-};
-var ValidationError = class extends DeveloperApiError {
-  constructor(message) {
-    super(400, "VALIDATION_ERROR", message);
-    this.name = "ValidationError";
-  }
-};
-var ServerError = class extends DeveloperApiError {
-  constructor(message = "Internal server error") {
-    super(500, "SERVER_ERROR", message);
-    this.name = "ServerError";
-  }
-};
+import {
+  AuthenticationError,
+  DeveloperApiError,
+  NotFoundError,
+  ServerError,
+  ValidationError
+} from "./chunk-UPXEAZIT.mjs";
 
 // src/v1/client.ts
 var DeveloperApiClient = class {
@@ -585,11 +559,6 @@ var V1ApiNamespace = class {
 };
 
 export {
-  DeveloperApiError,
-  AuthenticationError,
-  NotFoundError,
-  ValidationError,
-  ServerError,
   DeveloperApiClient,
   V1ChatModule,
   V1WorkspaceModule,

package/dist/cli/index.d.mts

@@ -0,0 +1,54 @@
+declare class CliApiClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly appId?;
+    constructor(baseUrl: string, apiKey: string, appId?: string);
+    private getHeaders;
+    private handleResponse;
+    request<T = unknown>(method: string, path: string, body?: unknown): Promise<T>;
+}
+
+interface NameRequest {
+    name: string;
+}
+interface CreateThreadRequest {
+    name?: string;
+}
+interface WorkspaceDefaultAgentRequest {
+    canonical: string;
+    providerId?: string;
+    modelId?: string;
+}
+interface SendLlmMessageRequest {
+    message: string;
+    chatProvider: string;
+    chatModel: string;
+    attachments?: Record<string, unknown>[];
+    webSearchEnabled?: boolean;
+    thinkingEffort?: string;
+    chatTuningConfig?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+declare class CliApiNamespace {
+    /** @internal Shared HTTP client used by all CLI API methods */
+    readonly _client: CliApiClient;
+    constructor(baseUrl: string, apiKey: string, appId?: string);
+    prepare(): Promise<unknown>;
+    listWorkspaces(): Promise<unknown>;
+    createWorkspace(body: NameRequest): Promise<unknown>;
+    getWorkspace(workspaceSlug: string): Promise<unknown>;
+    renameWorkspace(workspaceSlug: string, body: NameRequest): Promise<unknown>;
+    deleteWorkspace(workspaceSlug: string): Promise<unknown>;
+    setWorkspaceDefaultAgent(workspaceSlug: string, body: WorkspaceDefaultAgentRequest): Promise<unknown>;
+    clearWorkspaceDefaultAgent(workspaceSlug: string): Promise<unknown>;
+    listThreads(workspaceSlug: string): Promise<unknown>;
+    createThread(workspaceSlug: string, body?: CreateThreadRequest): Promise<unknown>;
+    getThread(workspaceSlug: string, threadSlug: string): Promise<unknown>;
+    renameThread(workspaceSlug: string, threadSlug: string, body: NameRequest): Promise<unknown>;
+    deleteThread(workspaceSlug: string, threadSlug: string): Promise<unknown>;
+    sendLlmMessage(workspaceSlug: string, threadSlug: string, body: SendLlmMessageRequest): Promise<unknown>;
+    listLlmProviders(): Promise<unknown>;
+    listLlmModels(provider: string): Promise<unknown>;
+}
+
+export { CliApiClient, CliApiNamespace, type CreateThreadRequest, type NameRequest, type SendLlmMessageRequest, type WorkspaceDefaultAgentRequest };

package/dist/cli/index.d.ts

@@ -0,0 +1,54 @@
+declare class CliApiClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly appId?;
+    constructor(baseUrl: string, apiKey: string, appId?: string);
+    private getHeaders;
+    private handleResponse;
+    request<T = unknown>(method: string, path: string, body?: unknown): Promise<T>;
+}
+
+interface NameRequest {
+    name: string;
+}
+interface CreateThreadRequest {
+    name?: string;
+}
+interface WorkspaceDefaultAgentRequest {
+    canonical: string;
+    providerId?: string;
+    modelId?: string;
+}
+interface SendLlmMessageRequest {
+    message: string;
+    chatProvider: string;
+    chatModel: string;
+    attachments?: Record<string, unknown>[];
+    webSearchEnabled?: boolean;
+    thinkingEffort?: string;
+    chatTuningConfig?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+declare class CliApiNamespace {
+    /** @internal Shared HTTP client used by all CLI API methods */
+    readonly _client: CliApiClient;
+    constructor(baseUrl: string, apiKey: string, appId?: string);
+    prepare(): Promise<unknown>;
+    listWorkspaces(): Promise<unknown>;
+    createWorkspace(body: NameRequest): Promise<unknown>;
+    getWorkspace(workspaceSlug: string): Promise<unknown>;
+    renameWorkspace(workspaceSlug: string, body: NameRequest): Promise<unknown>;
+    deleteWorkspace(workspaceSlug: string): Promise<unknown>;
+    setWorkspaceDefaultAgent(workspaceSlug: string, body: WorkspaceDefaultAgentRequest): Promise<unknown>;
+    clearWorkspaceDefaultAgent(workspaceSlug: string): Promise<unknown>;
+    listThreads(workspaceSlug: string): Promise<unknown>;
+    createThread(workspaceSlug: string, body?: CreateThreadRequest): Promise<unknown>;
+    getThread(workspaceSlug: string, threadSlug: string): Promise<unknown>;
+    renameThread(workspaceSlug: string, threadSlug: string, body: NameRequest): Promise<unknown>;
+    deleteThread(workspaceSlug: string, threadSlug: string): Promise<unknown>;
+    sendLlmMessage(workspaceSlug: string, threadSlug: string, body: SendLlmMessageRequest): Promise<unknown>;
+    listLlmProviders(): Promise<unknown>;
+    listLlmModels(provider: string): Promise<unknown>;
+}
+
+export { CliApiClient, CliApiNamespace, type CreateThreadRequest, type NameRequest, type SendLlmMessageRequest, type WorkspaceDefaultAgentRequest };

package/dist/cli/index.js

@@ -0,0 +1,185 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/cli/index.ts
+var cli_exports = {};
+__export(cli_exports, {
+  CliApiClient: () => CliApiClient,
+  CliApiNamespace: () => CliApiNamespace
+});
+module.exports = __toCommonJS(cli_exports);
+
+// src/v1/errors.ts
+var DeveloperApiError = class extends Error {
+  constructor(status, code, message) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.name = "DeveloperApiError";
+  }
+};
+var AuthenticationError = class extends DeveloperApiError {
+  constructor(message = "Invalid or missing API key") {
+    super(403, "AUTHENTICATION_ERROR", message);
+    this.name = "AuthenticationError";
+  }
+};
+var NotFoundError = class extends DeveloperApiError {
+  constructor(message = "Resource not found") {
+    super(404, "NOT_FOUND", message);
+    this.name = "NotFoundError";
+  }
+};
+var ValidationError = class extends DeveloperApiError {
+  constructor(message) {
+    super(400, "VALIDATION_ERROR", message);
+    this.name = "ValidationError";
+  }
+};
+var ServerError = class extends DeveloperApiError {
+  constructor(message = "Internal server error") {
+    super(500, "SERVER_ERROR", message);
+    this.name = "ServerError";
+  }
+};
+
+// src/cli/client.ts
+var CliApiClient = class {
+  constructor(baseUrl, apiKey, appId) {
+    this.baseUrl = baseUrl.replace(/\/$/, "");
+    this.apiKey = apiKey;
+    this.appId = appId;
+  }
+  getHeaders(extra) {
+    const headers = {
+      "Content-Type": "application/json",
+      "Authorization": `Bearer ${this.apiKey}`
+    };
+    if (this.appId) headers["x-app-id"] = this.appId;
+    return { ...headers, ...extra };
+  }
+  async handleResponse(response) {
+    let data;
+    try {
+      data = await response.json();
+    } catch {
+      data = {};
+    }
+    if (response.ok) return data;
+    const message = data?.message || data?.error || response.statusText || "Request failed";
+    switch (response.status) {
+      case 400:
+        throw new ValidationError(message);
+      case 401:
+      case 403:
+        throw new AuthenticationError(message);
+      case 404:
+        throw new NotFoundError(message);
+      case 500:
+      case 502:
+      case 503:
+        throw new ServerError(message);
+      default:
+        throw new DeveloperApiError(response.status, "API_ERROR", message);
+    }
+  }
+  async request(method, path, body) {
+    const url = `${this.baseUrl}/cli${path}`;
+    const response = await fetch(url, {
+      method,
+      headers: this.getHeaders(),
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+    return this.handleResponse(response);
+  }
+};
+
+// src/cli/namespace.ts
+var CliApiNamespace = class {
+  constructor(baseUrl, apiKey, appId) {
+    this._client = new CliApiClient(baseUrl, apiKey, appId);
+  }
+  async prepare() {
+    return this._client.request("GET", "/prepare");
+  }
+  async listWorkspaces() {
+    return this._client.request("GET", "/list-workspaces");
+  }
+  async createWorkspace(body) {
+    return this._client.request("POST", "/create-workspace", body);
+  }
+  async getWorkspace(workspaceSlug) {
+    return this._client.request("GET", `/get-workspace/${encodeURIComponent(workspaceSlug)}`);
+  }
+  async renameWorkspace(workspaceSlug, body) {
+    return this._client.request("POST", `/rename-workspace/${encodeURIComponent(workspaceSlug)}`, body);
+  }
+  async deleteWorkspace(workspaceSlug) {
+    return this._client.request("DELETE", `/delete-workspace/${encodeURIComponent(workspaceSlug)}`);
+  }
+  async setWorkspaceDefaultAgent(workspaceSlug, body) {
+    return this._client.request("POST", `/set-workspace-default-agent/${encodeURIComponent(workspaceSlug)}`, body);
+  }
+  async clearWorkspaceDefaultAgent(workspaceSlug) {
+    return this._client.request("DELETE", `/clear-workspace-default-agent/${encodeURIComponent(workspaceSlug)}`);
+  }
+  async listThreads(workspaceSlug) {
+    return this._client.request("GET", `/list-threads/${encodeURIComponent(workspaceSlug)}`);
+  }
+  async createThread(workspaceSlug, body) {
+    return this._client.request("POST", `/create-thread/${encodeURIComponent(workspaceSlug)}`, body);
+  }
+  async getThread(workspaceSlug, threadSlug) {
+    return this._client.request(
+      "GET",
+      `/get-thread/${encodeURIComponent(workspaceSlug)}/${encodeURIComponent(threadSlug)}`
+    );
+  }
+  async renameThread(workspaceSlug, threadSlug, body) {
+    return this._client.request(
+      "POST",
+      `/rename-thread/${encodeURIComponent(workspaceSlug)}/${encodeURIComponent(threadSlug)}`,
+      body
+    );
+  }
+  async deleteThread(workspaceSlug, threadSlug) {
+    return this._client.request(
+      "DELETE",
+      `/delete-thread/${encodeURIComponent(workspaceSlug)}/${encodeURIComponent(threadSlug)}`
+    );
+  }
+  async sendLlmMessage(workspaceSlug, threadSlug, body) {
+    return this._client.request(
+      "POST",
+      `/send-llm-message/${encodeURIComponent(workspaceSlug)}/${encodeURIComponent(threadSlug)}`,
+      body
+    );
+  }
+  async listLlmProviders() {
+    return this._client.request("GET", "/list-llm-providers");
+  }
+  async listLlmModels(provider) {
+    return this._client.request("GET", `/list-llm-models/${encodeURIComponent(provider)}`);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CliApiClient,
+  CliApiNamespace
+});

package/dist/cli/index.mjs

@@ -0,0 +1,9 @@
+import {
+  CliApiClient,
+  CliApiNamespace
+} from "../chunk-SFY6E7TY.mjs";
+import "../chunk-UPXEAZIT.mjs";
+export {
+  CliApiClient,
+  CliApiNamespace
+};

package/dist/index.d.mts

@@ -1,5 +1,7 @@
 import { V as V1ApiNamespace } from './errors-DwEt8WYf.mjs';
 export { A as AuthenticationError, D as DeveloperApiClient, a as DeveloperApiError, N as NotFoundError, S as ServerError, b as ValidationError } from './errors-DwEt8WYf.mjs';
+import { CliApiNamespace } from './cli/index.mjs';
+export { CliApiClient } from './cli/index.mjs';
 
 interface SDKConfig {
     realtimex?: {
@@ -21,9 +23,10 @@ declare class RealtimeXSDK {
     readonly apiKey: string | undefined;
     readonly realtimexUrl: string;
     readonly v1: V1ApiNamespace;
+    readonly cli: CliApiNamespace;
     private static DEFAULT_REALTIMEX_URL;
     constructor(config?: SDKConfig);
     private getEnvVar;
 }
 
-export { RealtimeXSDK, type SDKConfig, V1ApiNamespace };
+export { CliApiNamespace, RealtimeXSDK, type SDKConfig, V1ApiNamespace };

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 import { V as V1ApiNamespace } from './errors-DwEt8WYf.js';
 export { A as AuthenticationError, D as DeveloperApiClient, a as DeveloperApiError, N as NotFoundError, S as ServerError, b as ValidationError } from './errors-DwEt8WYf.js';
+import { CliApiNamespace } from './cli/index.js';
+export { CliApiClient } from './cli/index.js';
 
 interface SDKConfig {
     realtimex?: {
@@ -21,9 +23,10 @@ declare class RealtimeXSDK {
     readonly apiKey: string | undefined;
     readonly realtimexUrl: string;
     readonly v1: V1ApiNamespace;
+    readonly cli: CliApiNamespace;
     private static DEFAULT_REALTIMEX_URL;
     constructor(config?: SDKConfig);
     private getEnvVar;
 }
 
-export { RealtimeXSDK, type SDKConfig, V1ApiNamespace };
+export { CliApiNamespace, RealtimeXSDK, type SDKConfig, V1ApiNamespace };

package/dist/index.js

@@ -21,6 +21,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   AuthenticationError: () => AuthenticationError,
+  CliApiClient: () => CliApiClient,
+  CliApiNamespace: () => CliApiNamespace,
   DeveloperApiClient: () => DeveloperApiClient,
   DeveloperApiError: () => DeveloperApiError,
   NotFoundError: () => NotFoundError,
@@ -617,6 +619,126 @@ var V1ApiNamespace = class {
   }
 };
 
+// src/cli/client.ts
+var CliApiClient = class {
+  constructor(baseUrl, apiKey, appId) {
+    this.baseUrl = baseUrl.replace(/\/$/, "");
+    this.apiKey = apiKey;
+    this.appId = appId;
+  }
+  getHeaders(extra) {
+    const headers = {
+      "Content-Type": "application/json",
+      "Authorization": `Bearer ${this.apiKey}`
+    };
+    if (this.appId) headers["x-app-id"] = this.appId;
+    return { ...headers, ...extra };
+  }
+  async handleResponse(response) {
+    let data;
+    try {
+      data = await response.json();
+    } catch {
+      data = {};
+    }
+    if (response.ok) return data;
+    const message = data?.message || data?.error || response.statusText || "Request failed";
+    switch (response.status) {
+      case 400:
+        throw new ValidationError(message);
+      case 401:
+      case 403:
+        throw new AuthenticationError(message);
+      case 404:
+        throw new NotFoundError(message);
+      case 500:
+      case 502:
+      case 503:
+        throw new ServerError(message);
+      default:
+        throw new DeveloperApiError(response.status, "API_ERROR", message);
+    }
+  }
+  async request(method, path, body) {
+    const url = `${this.baseUrl}/cli${path}`;
+    const response = await fetch(url, {
+      method,
+      headers: this.getHeaders(),
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+    return this.handleResponse(response);
+  }
+};
+
+// src/cli/namespace.ts
+var CliApiNamespace = class {
+  constructor(baseUrl, apiKey, appId) {
+    this._client = new CliApiClient(baseUrl, apiKey, appId);
+  }
+  async prepare() {
+    return this._client.request("GET", "/prepare");
+  }
+  async listWorkspaces() {
+    return this._client.request("GET", "/list-workspaces");
+  }
+  async createWorkspace(body) {
+    return this._client.request("POST", "/create-workspace", body);
+  }
+  async getWorkspace(workspaceSlug) {
+    return this._client.request("GET", `/get-workspace/${encodeURIComponent(workspaceSlug)}`);
+  }
+  async renameWorkspace(workspaceSlug, body) {
+    return this._client.request("POST", `/rename-workspace/${encodeURIComponent(workspaceSlug)}`, body);
+  }
+  async deleteWorkspace(workspaceSlug) {
+    return this._client.request("DELETE", `/delete-workspace/${encodeURIComponent(workspaceSlug)}`);
+  }
+  async setWorkspaceDefaultAgent(workspaceSlug, body) {
+    return this._client.request("POST", `/set-workspace-default-agent/${encodeURIComponent(workspaceSlug)}`, body);
+  }
+  async clearWorkspaceDefaultAgent(workspaceSlug) {
+    return this._client.request("DELETE", `/clear-workspace-default-agent/${encodeURIComponent(workspaceSlug)}`);
+  }
+  async listThreads(workspaceSlug) {
+    return this._client.request("GET", `/list-threads/${encodeURIComponent(workspaceSlug)}`);
+  }
+  async createThread(workspaceSlug, body) {
+    return this._client.request("POST", `/create-thread/${encodeURIComponent(workspaceSlug)}`, body);
+  }
+  async getThread(workspaceSlug, threadSlug) {
+    return this._client.request(
+      "GET",
+      `/get-thread/${encodeURIComponent(workspaceSlug)}/${encodeURIComponent(threadSlug)}`
+    );
+  }
+  async renameThread(workspaceSlug, threadSlug, body) {
+    return this._client.request(
+      "POST",
+      `/rename-thread/${encodeURIComponent(workspaceSlug)}/${encodeURIComponent(threadSlug)}`,
+      body
+    );
+  }
+  async deleteThread(workspaceSlug, threadSlug) {
+    return this._client.request(
+      "DELETE",
+      `/delete-thread/${encodeURIComponent(workspaceSlug)}/${encodeURIComponent(threadSlug)}`
+    );
+  }
+  async sendLlmMessage(workspaceSlug, threadSlug, body) {
+    return this._client.request(
+      "POST",
+      `/send-llm-message/${encodeURIComponent(workspaceSlug)}/${encodeURIComponent(threadSlug)}`,
+      body
+    );
+  }
+  async listLlmProviders() {
+    return this._client.request("GET", "/list-llm-providers");
+  }
+  async listLlmModels(provider) {
+    return this._client.request("GET", `/list-llm-models/${encodeURIComponent(provider)}`);
+  }
+};
+
 // src/index.ts
 var _RealtimeXSDK = class _RealtimeXSDK {
   constructor(config = {}) {
@@ -630,6 +752,11 @@ var _RealtimeXSDK = class _RealtimeXSDK {
       this.apiKey ?? "",
       this.appId || void 0
     );
+    this.cli = new CliApiNamespace(
+      this.realtimexUrl,
+      this.apiKey ?? "",
+      this.appId || void 0
+    );
   }
   getEnvVar(name) {
     if (typeof process !== "undefined" && process.env) {
@@ -646,6 +773,8 @@ var RealtimeXSDK = _RealtimeXSDK;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AuthenticationError,
+  CliApiClient,
+  CliApiNamespace,
   DeveloperApiClient,
   DeveloperApiError,
   NotFoundError,

package/dist/index.mjs

@@ -1,12 +1,18 @@
 import {
-  AuthenticationError,
+  CliApiClient,
+  CliApiNamespace
+} from "./chunk-SFY6E7TY.mjs";
+import {
   DeveloperApiClient,
+  V1ApiNamespace
+} from "./chunk-XKQRTTIC.mjs";
+import {
+  AuthenticationError,
   DeveloperApiError,
   NotFoundError,
   ServerError,
-  V1ApiNamespace,
   ValidationError
-} from "./chunk-DZUAP6FW.mjs";
+} from "./chunk-UPXEAZIT.mjs";
 
 // src/index.ts
 var _RealtimeXSDK = class _RealtimeXSDK {
@@ -21,6 +27,11 @@ var _RealtimeXSDK = class _RealtimeXSDK {
       this.apiKey ?? "",
       this.appId || void 0
     );
+    this.cli = new CliApiNamespace(
+      this.realtimexUrl,
+      this.apiKey ?? "",
+      this.appId || void 0
+    );
   }
   getEnvVar(name) {
     if (typeof process !== "undefined" && process.env) {
@@ -36,6 +47,8 @@ _RealtimeXSDK.DEFAULT_REALTIMEX_URL = "http://localhost:3001";
 var RealtimeXSDK = _RealtimeXSDK;
 export {
   AuthenticationError,
+  CliApiClient,
+  CliApiNamespace,
   DeveloperApiClient,
   DeveloperApiError,
   NotFoundError,

package/dist/v1/index.mjs

@@ -1,15 +1,17 @@
 import {
-  AuthenticationError,
   DeveloperApiClient,
-  DeveloperApiError,
-  NotFoundError,
-  ServerError,
   V1ApiNamespace,
   V1ChatModule,
   V1ThreadModule,
-  V1WorkspaceModule,
+  V1WorkspaceModule
+} from "../chunk-XKQRTTIC.mjs";
+import {
+  AuthenticationError,
+  DeveloperApiError,
+  NotFoundError,
+  ServerError,
   ValidationError
-} from "../chunk-DZUAP6FW.mjs";
+} from "../chunk-UPXEAZIT.mjs";
 
 // src/v1/overrides/v1WorkspaceStreaming.ts
 async function* streamWorkspaceChat(client, slug, body) {

package/package.json

@@ -1,25 +1,30 @@
 {
     "name": "@realtimex/sdk",
-    "version": "2.0.6",
+    "version": "2.0.8",
     "description": "SDK for building Local Apps that integrate with RealtimeX",
     "main": "dist/index.js",
     "module": "dist/index.mjs",
     "types": "dist/index.d.ts",
     "exports": {
         ".": {
+            "types": "./dist/index.d.ts",
             "import": "./dist/index.mjs",
-            "require": "./dist/index.js",
-            "types": "./dist/index.d.ts"
+            "require": "./dist/index.js"
         },
         "./v1": {
+            "types": "./dist/v1/index.d.ts",
             "import": "./dist/v1/index.mjs",
-            "require": "./dist/v1/index.js",
-            "types": "./dist/v1/index.d.ts"
+            "require": "./dist/v1/index.js"
+        },
+        "./cli": {
+            "types": "./dist/cli/index.d.ts",
+            "import": "./dist/cli/index.mjs",
+            "require": "./dist/cli/index.js"
         }
     },
     "scripts": {
-        "build": "node ../scripts/generate-v1-sdk.mjs --force && tsup src/index.ts src/v1/index.ts --format cjs,esm --dts --clean",
-        "dev": "tsup src/index.ts src/v1/index.ts --format cjs,esm --dts --watch",
+        "build": "node ../scripts/generate-v1-sdk.mjs --force && tsup src/index.ts src/v1/index.ts src/cli/index.ts --format cjs,esm --dts --clean",
+        "dev": "tsup src/index.ts src/v1/index.ts src/cli/index.ts --format cjs,esm --dts --watch",
         "test": "vitest run --passWithNoTests",
         "sdk:generate": "node ../scripts/generate-v1-sdk.mjs",
         "sdk:generate:force": "node ../scripts/generate-v1-sdk.mjs --force",

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

@@ -1,6 +1,6 @@
 ---
 name: realtimex-moderator-sdk
-description: "Use the RealTimeX API through the generated CLI for workspace, thread, and chat operations."
+description: "Use the RealTimeX API through the generated CLI for workspace, thread, channel (Telegram, Zalo, Discord), send messages, setup personality, and heartbeat operations."
 author: ""
 license: "Apache-2.0"
 argument-hint: "<command> [args] | install cli"
@@ -20,22 +20,36 @@ This skill drives the `realtimex-pp-cli` binary. Verify the CLI is installed and
 
 1. Install or reinstall the pinned version via npm:
    ```bash
-   npm install -g @realtimex/pp-cli@2.0.6
+   npm install -g @realtimex/pp-cli@2.0.8
    ```
 2. Verify the exact version:
    ```bash
    realtimex-pp-cli --version
    ```
-   The output must be `realtimex-pp-cli 2.0.6`.
+   The output must be `realtimex-pp-cli 2.0.8`.
 
-If `--version` reports "command not found" after install, the npm global bin directory is not on `$PATH`. If it reports any version other than `2.0.6`, reinstall with the pinned npm command above. Do not proceed with skill commands until exact-version verification succeeds.
+If `--version` reports "command not found" after install, the npm global bin directory is not on `$PATH`. If it reports any version other than `2.0.8`, reinstall with the pinned npm command above. Do not proceed with skill commands until exact-version verification succeeds.
+
+* Always run first:
+
+  ```bash
+  realtimex-pp-cli prepare --workspace-slug "$RTX_WORKSPACE_SLUG" --thread-slug "$RTX_THREAD_SLUG" --agent
+  ```
 
 ## Command Reference
 
+**approve-channel-pairing-code** — Manage approve channel pairing code
+
+- `realtimex-pp-cli approve-channel-pairing-code <code>` — Approve one pending channel pairing code by visible 6-digit code or database id.
+
 **clear-workspace-default-agent** — Manage clear workspace default agent
 
 - `realtimex-pp-cli clear-workspace-default-agent <workspaceSlug>` — Clear the default CLI agent from a workspace.
 
+**create-channel** — Manage create channel
+
+- `realtimex-pp-cli create-channel <workspaceSlug>` — Create a chat channel in one exact workspace. Defaults to Telegram when plugin_type, channelType, and type are omitted.
+
 **create-thread** — Manage create thread
 
 - `realtimex-pp-cli create-thread <workspaceSlug>` — Create a thread in one workspace. The name is optional but recommended.
@@ -44,6 +58,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli create-workspace` — Create a workspace. Requires a human-readable workspace name.
 
+**delete-channel** — Manage delete channel
+
+- `realtimex-pp-cli delete-channel <channelId>` — Delete one chat channel by exact channel id.
+
 **delete-thread** — Manage delete thread
 
 - `realtimex-pp-cli delete-thread <workspaceSlug> <threadSlug>` — Delete one thread by exact workspace slug and exact thread slug.
@@ -52,6 +70,22 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli delete-workspace <workspaceSlug>` — Delete one workspace by exact workspace slug.
 
+**disable-plugin** — Manage disable plugin
+
+- `realtimex-pp-cli disable-plugin <pluginId>` — Disable one installed plugin globally and unload it from runtime.
+
+**disable-workspace-agent-skill** — Manage disable workspace agent skill
+
+- `realtimex-pp-cli disable-workspace-agent-skill <workspaceSlug> <skillId>` — Disable one agent skill in a workspace. Use a skill id, name, or displayName from list-workspace-agent-skills.
+
+**enable-plugin** — Manage enable plugin
+
+- `realtimex-pp-cli enable-plugin <pluginId>` — Enable one installed plugin globally and load it into runtime. Use a plugin id, name, or displayName from list-plugins.
+
+**enable-workspace-agent-skill** — Manage enable workspace agent skill
+
+- `realtimex-pp-cli enable-workspace-agent-skill <workspaceSlug> <skillId>` — Enable one agent skill in a workspace. Use a skill id, name, or displayName from list-workspace-agent-skills.
+
 **get-thread** — Manage get thread
 
 - `realtimex-pp-cli get-thread <workspaceSlug> <threadSlug>` — Get one thread by exact workspace slug and exact thread slug.
@@ -60,25 +94,45 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli get-workspace <workspaceSlug>` — Get one workspace by exact workspace slug.
 
+**list-agent-skills** — Manage list agent skills
+
+- `realtimex-pp-cli list-agent-skills` — List published agent skills. Use list-workspace-agent-skills to see enabled/disabled state for one workspace.
+
+**list-channels** — Manage list channels
+
+- `realtimex-pp-cli list-channels` — List configured chat channels. Use returned channel ids with update-channel.
+
 **list-llm-models** — Manage list llm models
 
-- `realtimex-pp-cli list-llm-models <provider>` — List models for one provider id. Use an exact model id from this response with send-llm-message.
+- `realtimex-pp-cli list-llm-models <provider>` — List models for one provider id.
 
 **list-llm-providers** — Manage list llm providers
 
-- `realtimex-pp-cli list-llm-providers` — List supported LLM providers. Use provider ids from this response with list-llm-models and send-llm-message.
+- `realtimex-pp-cli list-llm-providers` — List supported LLM providers. Use provider ids from this response when configuring workspace or thread LLM settings.
+
+**list-plugins** — Manage list plugins
+
+- `realtimex-pp-cli list-plugins` — List installed plugins with enabled state and runtime load status.
 
 **list-threads** — Manage list threads
 
 - `realtimex-pp-cli list-threads <workspaceSlug>` — List threads for one exact workspace slug.
 
+**list-workspace-agent-skills** — Manage list workspace agent skills
+
+- `realtimex-pp-cli list-workspace-agent-skills <workspaceSlug>` — List published agent skills with enabled/disabled state for one exact workspace slug.
+
 **list-workspaces** — Manage list workspaces
 
 - `realtimex-pp-cli list-workspaces` — List all workspaces visible to the current API caller. Use this before choosing a workspace slug.
 
 **prepare** — Manage prepare
 
-- `realtimex-pp-cli prepare` — Return compact workspace, thread, LLM provider, model, and CLI agent context for agents before choosing arguments.
+- `realtimex-pp-cli prepare` — Return compact workspace, thread, current workspace/thread from explicit workspaceSlug and threadSlug query parameters
+
+**reload-plugin** — Manage reload plugin
+
+- `realtimex-pp-cli reload-plugin <pluginId>` — Reload one enabled plugin in runtime. Disabled plugins must be enabled before reload.
 
 **rename-thread** — Manage rename thread
 
@@ -88,14 +142,58 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli rename-workspace <workspaceSlug>` — Rename one workspace by exact workspace slug. Only the name is changed.
 
-**send-llm-message** — Manage send llm message
+**send-message** — Manage send message
+
+- `realtimex-pp-cli send-message <workspaceSlug> <threadSlug>` — Send one message to an exact thread using the same routing as channel replies.
+
+**set-heartbeat-active-hours** — Manage set heartbeat active hours
+
+- `realtimex-pp-cli set-heartbeat-active-hours` — Set workspace or global ambient-agent active hours using HH:mm start and end values.
+
+**set-heartbeat-auto-pilot** — Manage set heartbeat auto pilot
+
+- `realtimex-pp-cli set-heartbeat-auto-pilot` — Turn workspace or global ambient-agent heartbeat auto pilot on or off.
+
+**set-heartbeat-default-agent** — Manage set heartbeat default agent
+
+- `realtimex-pp-cli set-heartbeat-default-agent` — Set workspace or global ambient-agent main executor default terminal agent and optional model.
+
+**set-heartbeat-enabled** — Manage set heartbeat enabled
+
+- `realtimex-pp-cli set-heartbeat-enabled` — Turn workspace or global ambient-agent heartbeat on or off.
+
+**set-heartbeat-interval** — Manage set heartbeat interval
+
+- `realtimex-pp-cli set-heartbeat-interval` — Set workspace or global ambient-agent main executor interval.
 
-- `realtimex-pp-cli send-llm-message <workspaceSlug> <threadSlug>` — Send one non-streaming LLM message to an exact thread.
+**set-heartbeat-timezone** — Manage set heartbeat timezone
+
+- `realtimex-pp-cli set-heartbeat-timezone` — Set workspace or global ambient-agent heartbeat timezone, for example Asia/Saigon or UTC.
 
 **set-workspace-default-agent** — Manage set workspace default agent
 
 - `realtimex-pp-cli set-workspace-default-agent <workspaceSlug>` — Set the default CLI agent for a workspace.
 
+**setup-heartbeat-tasks** — Manage setup heartbeat tasks
+
+- `realtimex-pp-cli setup-heartbeat-tasks` — Set up HEARTBEAT.md task instructions for a workspace or global ambient agent.
+
+**setup-personality** — Manage setup personality
+
+- `realtimex-pp-cli setup-personality` — Set up AGENTS.md and CLAUDE.md personality files for a workspace or global ambient agent.
+
+**start-channel** — Manage start channel
+
+- `realtimex-pp-cli start-channel <channelId>` — Start one chat channel by exact channel id.
+
+**stop-channel** — Manage stop channel
+
+- `realtimex-pp-cli stop-channel <channelId>` — Stop one chat channel by exact channel id.
+
+**update-channel** — Manage update channel
+
+- `realtimex-pp-cli update-channel <channelId>` — Update one chat channel by exact channel id. Only channel writable fields are changed.
+
 
 ### Finding the right command
 
@@ -126,7 +224,7 @@ Add `--agent` to any command. Expands to: `--json --compact --no-input --no-colo
 - **Filterable** — `--select` keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
 
   ```bash
-  realtimex-pp-cli clear-workspace-default-agent mock-value --agent --select id,name,status
+  realtimex-pp-cli approve-channel-pairing-code mock-value --agent --select id,name,status
   ```
 - **Previewable** — `--dry-run` shows the request without sending
 - **Offline-friendly** — sync/search commands can use the local SQLite store when available
@@ -178,7 +276,7 @@ A profile is a saved set of flag values, reused across invocations. Use it when
 
 ```
 realtimex-pp-cli profile save briefing --json
-realtimex-pp-cli --profile briefing clear-workspace-default-agent mock-value
+realtimex-pp-cli --profile briefing approve-channel-pairing-code mock-value
 realtimex-pp-cli profile list --json
 realtimex-pp-cli profile show briefing
 realtimex-pp-cli profile delete briefing --yes
@@ -222,9 +320,9 @@ Verify: `claude mcp list`
    ```bash
    realtimex-pp-cli --version
    ```
-   If the command is missing or the output is not exactly `realtimex-pp-cli 2.0.6`, reinstall the pinned version:
+   If the command is missing or the output is not exactly `realtimex-pp-cli 2.0.8`, reinstall the pinned version:
    ```bash
-   npm install -g @realtimex/pp-cli@2.0.6
+   npm install -g @realtimex/pp-cli@2.0.8
    ```
    Then run `realtimex-pp-cli --version` again and proceed only after exact-version verification succeeds.
 2. Match the user query to the best command from the Unique Capabilities and Command Reference above.
@@ -245,7 +343,7 @@ This skill intentionally exposes a small action-first command set. Prefer these
 * Always run first:
 
   ```bash
-  realtimex-pp-cli prepare --agent
+  realtimex-pp-cli prepare --workspace-slug "$RTX_WORKSPACE_SLUG" --thread-slug "$RTX_THREAD_SLUG" --agent
   ```
 
 * Use exact workspace slugs, thread slugs, provider ids, model ids, agent `canonical`, and agent `modelId` values from `prepare`.
@@ -257,25 +355,26 @@ This skill intentionally exposes a small action-first command set. Prefer these
 * When the user explicitly uses contextual references such as "current workspace", "this thread", "the thread just created", "that workspace", or similar references, resolve them from the available conversation context only when the reference is unambiguous.
 * If multiple plausible matches exist, ask the user to choose.
 
-For `send-llm-message`:
+For `send-message`:
 
-* Require all four values to be explicitly named or explicitly referenced in the current request:
+* Require these values to be explicitly named or explicitly referenced in the current request:
   * workspace
   * thread
-  * LLM provider
-  * LLM model
-* If any of those four values are missing or ambiguous, ask for the missing values before running the command.
-* Use provider/model only from:
-  * `prepare.models`
-  * `list-llm-providers`
-  * `list-llm-models`
-* Never use `prepare.agents[].models` for `send-llm-message`.
-* Prefer provider `realtimexai` unless the user explicitly asks for local `nodellama`.
-* Only choose a model id that exists in the selected provider's LLM model list.
-* If the requested model is unavailable, ask which available model to use instead.
+  * message
+* If any of those values are missing or ambiguous, ask for the missing values before running the command.
+* Do not provide LLM provider/model arguments to `send-message`; the server routes the message based on the thread/workspace configuration.
 
 For workspace default-agent setup:
 
 * Use `prepare.agents` only.
 * Use exact agent `canonical` and optional agent `modelId` values from `prepare.agents`.
 * Never use `prepare.models` for workspace default-agent setup.
+
+For personality and heartbeat setup:
+
+* Use `setup-personality` to get the target directory for workspace or global personality files.
+* Start from `templates/AGENTS.template.md` when creating `AGENTS.md`.
+* Make `CLAUDE.md` a symlink to `AGENTS.md`.
+* Use `setup-heartbeat-tasks` to get the target `HEARTBEAT.md` path.
+* Start from `templates/HEARTBEAT.template.md` when creating `HEARTBEAT.md`.
+* Keep heartbeat instructions separate from personality files.

package/skills/realtimex-moderator-sdk/templates/AGENTS.template.md

@@ -0,0 +1,49 @@
+# Agent Instructions
+
+## Mission
+
+Describe the workspace or global personality that agents should follow.
+
+You are working inside the RealTimeX app.
+
+## Role
+
+- State who the agent is for this workspace.
+- Define the agent's primary responsibility.
+- Define what the agent should avoid doing.
+
+## Boundaries
+
+- Ask for clarification when instructions are ambiguous.
+- Do not fabricate facts.
+- Do not take destructive actions without explicit approval.
+- Do not store secrets in personality files.
+
+## Tools
+
+- Describe which tools the agent may use.
+- Describe any tool-specific constraints.
+- Prefer using the `realtimex-moderator-sdk` skill for work related to RealTimeX workspaces, threads, channels (Telegram, Zalo, Discord), sending messages, setup personality, and heartbeat operations.
+- Prefer documented RealTimeX CLI commands when interacting with RealTimeX.
+
+## Memory
+
+- Record only durable preferences or facts that should affect future work.
+- Keep memory concise and verifiable.
+- Do not store credentials, tokens, or private secrets.
+
+## Style
+
+- Be concise.
+- Prefer concrete updates over speculation.
+- Explain blockers clearly.
+
+## Child Files
+
+Reference child markdown files here if used:
+
+- SOUL.md
+- USER.md
+- IDENTITY.md
+- TOOLS.md
+- MEMORY.md

package/skills/realtimex-moderator-sdk/templates/HEARTBEAT.template.md

@@ -0,0 +1,61 @@
+# Heartbeat Instructions
+
+## Mission
+
+Describe the ambient agent's standing responsibility.
+
+## Scheduled tasks (optional)
+
+Remove this section if you don't need recurring tasks.
+When present, the scheduler runs only tasks that are due on each tick.
+Tasks without an interval inherit the main check interval.
+Use `interval` for simple timing. Supported units are `m`, `h`, and `d`, for example `3m`, `1h`, or `1d`.
+Use `cron` for complex schedules, for example `0 9 * * *`.
+Use `agent` to run a task with a specific terminal agent, for example `@codex-terminal`.
+Use `model` to run a task with a specific model, for example `gpt-5.5-medium`.
+Use `skills` to prefer skills for the task, for example `agent-browser, realtimex-moderator-sdk`.
+`agent`, `model`, `skills`, `interval`, and `cron` are optional. If omitted, the task inherits from the main heartbeat executor.
+
+tasks:
+
+- name: example-task
+  interval: 30m
+  agent: @codex-terminal
+  model: gpt-5.5-medium
+  skills: agent-browser, realtimex-moderator-sdk
+  prompt: Describe what the agent should do for this task
+- name: weekday-morning-task
+  cron: 0 9 * * 1-5
+  prompt: Describe what should run on a cron schedule
+- name: another-task
+  prompt: Tasks without interval run at the main check interval
+
+## Check for
+
+- Pending tasks that require follow-up
+- New events that need awareness
+
+## When action is needed
+
+- State what should trigger action
+- Describe the preferred next step
+- If calendar routine context is provided, use it only when a concise update would help
+
+## When nothing is needed
+
+- Reply exactly HEARTBEAT_OK
+
+## Allowed actions
+
+- Review the current workspace context
+- Create or update relevant artifacts when necessary
+
+## Never do
+
+- Do not repeat old work without a clear reason
+- Do not take destructive actions without explicit approval
+
+## Style
+
+- Be concise
+- Prefer concrete updates over speculation