@realtimex/sdk 2.0.21 → 2.0.23

package/index.d.ts

@@ -82,6 +82,25 @@ export interface ClearWorkspaceDefaultAgentOptions extends RealtimeXRequestOptio
   body?: ClearWorkspaceDefaultAgentBody;
 }
 
+export type ConfigurePluginParams = {
+  pluginId: string;
+};
+export type ConfigurePluginQuery = Record<string, never>;
+export type ConfigurePluginHeaders = {
+  "x-app-id"?: string;
+};
+export type ConfigurePluginBody = {
+  config?: Record<string, unknown>;
+  configJson?: string;
+};
+export type ConfigurePluginResponse = Record<string, unknown>;
+export interface ConfigurePluginOptions extends RealtimeXRequestOptions {
+  params?: ConfigurePluginParams;
+  query?: ConfigurePluginQuery;
+  headers?: ConfigurePluginHeaders & Record<string, string>;
+  body?: ConfigurePluginBody;
+}
+
 export type CreateChannelParams = {
   workspaceSlug: string;
 };
@@ -300,6 +319,22 @@ export interface GetArtifactOptions extends RealtimeXRequestOptions {
   body?: GetArtifactBody;
 }
 
+export type GetPluginParams = {
+  pluginId: string;
+};
+export type GetPluginQuery = Record<string, never>;
+export type GetPluginHeaders = {
+  "x-app-id"?: string;
+};
+export type GetPluginBody = unknown;
+export type GetPluginResponse = Record<string, unknown>;
+export interface GetPluginOptions extends RealtimeXRequestOptions {
+  params?: GetPluginParams;
+  query?: GetPluginQuery;
+  headers?: GetPluginHeaders & Record<string, string>;
+  body?: GetPluginBody;
+}
+
 export type GetThreadParams = {
   workspaceSlug: string;
   threadSlug: string;
@@ -333,6 +368,23 @@ export interface GetWorkspaceOptions extends RealtimeXRequestOptions {
   body?: GetWorkspaceBody;
 }
 
+export type InstallPluginParams = Record<string, never>;
+export type InstallPluginQuery = Record<string, never>;
+export type InstallPluginHeaders = {
+  "x-app-id"?: string;
+};
+export type InstallPluginBody = {
+  path: string;
+  force?: boolean;
+};
+export type InstallPluginResponse = Record<string, unknown>;
+export interface InstallPluginOptions extends RealtimeXRequestOptions {
+  params?: InstallPluginParams;
+  query?: InstallPluginQuery;
+  headers?: InstallPluginHeaders & Record<string, string>;
+  body?: InstallPluginBody;
+}
+
 export type ListAgentSkillsParams = Record<string, never>;
 export type ListAgentSkillsQuery = Record<string, never>;
 export type ListAgentSkillsHeaders = {
@@ -1255,6 +1307,9 @@ export declare class RealtimeXClient {
   /** Clear the default CLI agent from a workspace. */
   clearWorkspaceDefaultAgent(options?: ClearWorkspaceDefaultAgentOptions): Promise<ClearWorkspaceDefaultAgentResponse>;
   clearWorkspaceDefaultAgent(workspaceSlug: string, options?: Omit<ClearWorkspaceDefaultAgentOptions, 'params'>): Promise<ClearWorkspaceDefaultAgentResponse>;
+  /** Set non-secret configuration values for one installed plugin. Use a plugin id, name, or displayName from list-plugins. Password-type fields are refused and reported back for manual setup in the desktop settings UI. */
+  configurePlugin(options?: ConfigurePluginOptions): Promise<ConfigurePluginResponse>;
+  configurePlugin(pluginId: string, body: ConfigurePluginBody, options?: Omit<ConfigurePluginOptions, 'params' | 'body'>): Promise<ConfigurePluginResponse>;
   /** Create a chat channel in one exact workspace. Defaults to Telegram when plugin_type, channelType, and type are omitted. Use flat botToken and thread_id fields instead of nested config/settings. */
   createChannel(options?: CreateChannelOptions): Promise<CreateChannelResponse>;
   createChannel(workspaceSlug: string, body: CreateChannelBody, options?: Omit<CreateChannelOptions, 'params' | 'body'>): Promise<CreateChannelResponse>;
@@ -1291,12 +1346,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>;
+  /** Get one installed plugin with its config schema (keys, labels, types, defaults) and current non-secret configuration values. Secret (password-type) values are never returned; secretConfigState reports whether each one is set. Use a plugin id, name, or displayName from list-plugins. */
+  getPlugin(options?: GetPluginOptions): Promise<GetPluginResponse>;
+  getPlugin(pluginId: string, options?: Omit<GetPluginOptions, 'params'>): Promise<GetPluginResponse>;
   /** Get one thread by exact workspace slug and exact thread slug. */
   getThread(options?: GetThreadOptions): Promise<GetThreadResponse>;
   getThread(params: GetThreadParams, options?: Omit<GetThreadOptions, 'params'>): Promise<GetThreadResponse>;
   /** Get one workspace by exact workspace slug. */
   getWorkspace(options?: GetWorkspaceOptions): Promise<GetWorkspaceResponse>;
   getWorkspace(workspaceSlug: string, options?: Omit<GetWorkspaceOptions, 'params'>): Promise<GetWorkspaceResponse>;
+  /** Install a plugin from a local source directory on the same machine as the server. Pass an absolute path containing realtimex.plugin.json. Pass force=true to replace an already-installed version; its saved configuration (including secrets) is preserved. */
+  installPlugin(options?: InstallPluginOptions): Promise<InstallPluginResponse>;
+  installPlugin(body: InstallPluginBody, options?: Omit<InstallPluginOptions, 'body'>): Promise<InstallPluginResponse>;
   /** List published agent skills. Use list-workspace-agent-skills to see enabled/disabled state for one workspace. */
   listAgentSkills(options?: ListAgentSkillsOptions): Promise<ListAgentSkillsResponse>;
   /** List public artifacts for one exact workspace slug. Revoked artifacts are hidden unless includeRevoked=true is passed. */

package/index.js

@@ -34,6 +34,18 @@ const operations = {
     ],
     "hasBody": false
   },
+  "configurePlugin": {
+    "method": "POST",
+    "path": "/configure-plugin/{pluginId}",
+    "pathParams": [
+      "pluginId"
+    ],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": true
+  },
   "createChannel": {
     "method": "POST",
     "path": "/create-channel/{workspaceSlug}",
@@ -182,6 +194,18 @@ const operations = {
     ],
     "hasBody": false
   },
+  "getPlugin": {
+    "method": "GET",
+    "path": "/get-plugin/{pluginId}",
+    "pathParams": [
+      "pluginId"
+    ],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": false
+  },
   "getThread": {
     "method": "GET",
     "path": "/get-thread/{workspaceSlug}/{threadSlug}",
@@ -207,6 +231,16 @@ const operations = {
     ],
     "hasBody": false
   },
+  "installPlugin": {
+    "method": "POST",
+    "path": "/install-plugin",
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": true
+  },
   "listAgentSkills": {
     "method": "GET",
     "path": "/list-agent-skills",
@@ -943,6 +977,13 @@ class RealtimeXClient {
     );
   }
 
+  configurePlugin(...args) {
+    return this.request(
+      "configurePlugin",
+      normalizeOperationOptions(operations["configurePlugin"], args)
+    );
+  }
+
   createChannel(...args) {
     return this.request(
       "createChannel",
@@ -1027,6 +1068,13 @@ class RealtimeXClient {
     );
   }
 
+  getPlugin(...args) {
+    return this.request(
+      "getPlugin",
+      normalizeOperationOptions(operations["getPlugin"], args)
+    );
+  }
+
   getThread(...args) {
     return this.request(
       "getThread",
@@ -1041,6 +1089,13 @@ class RealtimeXClient {
     );
   }
 
+  installPlugin(...args) {
+    return this.request(
+      "installPlugin",
+      normalizeOperationOptions(operations["installPlugin"], args)
+    );
+  }
+
   listAgentSkills(...args) {
     return this.request(
       "listAgentSkills",
@@ -1374,5 +1429,5 @@ module.exports = {
   createClient: createRealtimeXClient,
   createRealtimeXClient,
   operations,
-  version: "2.0.21",
+  version: "2.0.23",
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "2.0.21",
+    "version": "2.0.23",
     "description": "RealtimeX runtime SDK package and moderator agent skill assets.",
     "private": false,
     "main": "./index.js",

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

@@ -20,15 +20,15 @@ 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.21
+   npm install -g @realtimex/pp-cli@2.0.23
    ```
 2. Verify the exact version:
    ```bash
    realtimex-pp-cli --version
    ```
-   The output must be `realtimex-pp-cli 2.0.21`.
+   The output must be `realtimex-pp-cli 2.0.23`.
 
-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.21`, 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.23`, reinstall with the pinned npm command above. Do not proceed with skill commands until exact-version verification succeeds.
 
 * Always run first:
 
@@ -50,6 +50,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli clear-workspace-default-agent <workspaceSlug>` — Clear the default CLI agent from a workspace.
 
+**configure-plugin** — Manage configure plugin
+
+- `realtimex-pp-cli configure-plugin <pluginId>` — Set non-secret configuration values for one installed plugin. Use a plugin id, name, or displayName from list-plugins.
+
 **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.
@@ -98,6 +102,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli get-artifact <artifactId>` — Get one public artifact by artifact id.
 
+**get-plugin** — Manage get plugin
+
+- `realtimex-pp-cli get-plugin <pluginId>` — Get one installed plugin with its config schema (keys, labels, types, defaults)
+
 **get-thread** — Manage get thread
 
 - `realtimex-pp-cli get-thread <workspaceSlug> <threadSlug>` — Get one thread by exact workspace slug and exact thread slug.
@@ -106,6 +114,10 @@ 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.
 
+**install-plugin** — Manage install plugin
+
+- `realtimex-pp-cli install-plugin` — Install a plugin from a local source directory on the same machine as the server.
+
 **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.
@@ -412,9 +424,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.21`, reinstall the pinned version:
+   If the command is missing or the output is not exactly `realtimex-pp-cli 2.0.23`, reinstall the pinned version:
    ```bash
-   npm install -g @realtimex/pp-cli@2.0.21
+   npm install -g @realtimex/pp-cli@2.0.23
    ```
    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.

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

@@ -14,7 +14,7 @@ Use `interval` for simple timing. Supported units are `m`, `h`, and `d`, for exa
 Omit `interval` and `cron` to run on every scheduler check interval.
 Use `interval: disabled` to keep a task in the file but skip it during scheduled heartbeat checks. Manual triggers can still run the task.
 Use `cron` for complex schedules, for example `0 9 * * *`.
-Agent tasks require `agent`, for example `@codex-terminal`.
+Agent tasks require `agent`, for example `@codex`.
 Use `model` to run an agent task with a specific model, for example `gpt-5.5-medium`.
 Use `skills` to prefer skills for an agent task, for example `agent-browser, realtimex-moderator-sdk`.
 Use `executor: shell` and `command` to run a shell command instead of an agent. Shell tasks do not use `prompt`.
@@ -48,13 +48,13 @@ tasks:
 - name: default-review
   default: true
   interval: 30m
-  agent: @codex-terminal
+  agent: @codex
   model: gpt-5.5-medium
   skills: agent-browser, realtimex-moderator-sdk
   prompt: Review the workspace context and respond HEARTBEAT_OK when no action is needed
 - name: weekday-morning-task
   cron: 0 9 * * 1-5
-  agent: @codex-terminal
+  agent: @codex
   prompt: Describe what should run on a cron schedule
 - name: sync-metrics
   interval: 30m
@@ -62,10 +62,10 @@ tasks:
   command: bash ./scripts/sync-metrics.sh
 - name: paused-task
   interval: disabled
-  agent: @codex-terminal
+  agent: @codex
   prompt: This task is skipped by scheduled heartbeat checks until re-enabled
 - name: another-task
-  agent: @codex-terminal
+  agent: @codex
   prompt: Tasks without interval or cron run on every scheduler check interval
 
 ## Check for