@realtimex/sdk 2.0.22 → 2.0.24

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 = {
@@ -1218,6 +1270,26 @@ export interface UpdateChannelOptions extends RealtimeXRequestOptions {
   body?: UpdateChannelBody;
 }
 
+export type WorkspaceShellLayoutParams = Record<string, never>;
+export type WorkspaceShellLayoutQuery = Record<string, never>;
+export type WorkspaceShellLayoutHeaders = Record<string, never>;
+export type WorkspaceShellLayoutBody = {
+  cdpUrl?: string;
+  mainAppUrl?: string;
+  workspaceSlug?: string;
+  artifactPath?: string;
+  screenshotDir?: string;
+  timeoutMs?: number;
+  confirmDestructive?: boolean;
+};
+export type WorkspaceShellLayoutResponse = Record<string, unknown>;
+export interface WorkspaceShellLayoutOptions extends RealtimeXRequestOptions {
+  params?: WorkspaceShellLayoutParams;
+  query?: WorkspaceShellLayoutQuery;
+  headers?: WorkspaceShellLayoutHeaders & Record<string, string>;
+  body?: WorkspaceShellLayoutBody;
+}
+
 export interface RealtimeXClientOptions {
   baseUrl?: string;
   appId?: string;
@@ -1255,6 +1327,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 +1366,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. */
@@ -1428,6 +1509,9 @@ export declare class RealtimeXClient {
   /** Update one chat channel by exact channel id. Only channel writable fields are changed. */
   updateChannel(options?: UpdateChannelOptions): Promise<UpdateChannelResponse>;
   updateChannel(channelId: string, body: UpdateChannelBody, options?: Omit<UpdateChannelOptions, 'params' | 'body'>): Promise<UpdateChannelResponse>;
+  /** Verify workspace navigation, title-bar containment, Files dock behavior, and action contrast at desktop and compact viewports. */
+  workspaceShellLayout(options?: WorkspaceShellLayoutOptions): Promise<WorkspaceShellLayoutResponse>;
+  workspaceShellLayout(body: WorkspaceShellLayoutBody, options?: Omit<WorkspaceShellLayoutOptions, 'body'>): Promise<WorkspaceShellLayoutResponse>;
 }
 
 export declare function createRealtimeXClient(

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",
@@ -725,6 +759,14 @@ const operations = {
       "x-app-id"
     ],
     "hasBody": true
+  },
+  "workspaceShellLayout": {
+    "method": "POST",
+    "path": "/workspace-shell-layout",
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [],
+    "hasBody": true
   }
 };
 
@@ -943,6 +985,13 @@ class RealtimeXClient {
     );
   }
 
+  configurePlugin(...args) {
+    return this.request(
+      "configurePlugin",
+      normalizeOperationOptions(operations["configurePlugin"], args)
+    );
+  }
+
   createChannel(...args) {
     return this.request(
       "createChannel",
@@ -1027,6 +1076,13 @@ class RealtimeXClient {
     );
   }
 
+  getPlugin(...args) {
+    return this.request(
+      "getPlugin",
+      normalizeOperationOptions(operations["getPlugin"], args)
+    );
+  }
+
   getThread(...args) {
     return this.request(
       "getThread",
@@ -1041,6 +1097,13 @@ class RealtimeXClient {
     );
   }
 
+  installPlugin(...args) {
+    return this.request(
+      "installPlugin",
+      normalizeOperationOptions(operations["installPlugin"], args)
+    );
+  }
+
   listAgentSkills(...args) {
     return this.request(
       "listAgentSkills",
@@ -1362,6 +1425,13 @@ class RealtimeXClient {
       normalizeOperationOptions(operations["updateChannel"], args)
     );
   }
+
+  workspaceShellLayout(...args) {
+    return this.request(
+      "workspaceShellLayout",
+      normalizeOperationOptions(operations["workspaceShellLayout"], args)
+    );
+  }
 }
 
 function createRealtimeXClient(options = {}) {
@@ -1374,5 +1444,5 @@ module.exports = {
   createClient: createRealtimeXClient,
   createRealtimeXClient,
   operations,
-  version: "2.0.22",
+  version: "2.0.24",
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "2.0.22",
+    "version": "2.0.24",
     "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.22
+   npm install -g @realtimex/pp-cli@2.0.24
    ```
 2. Verify the exact version:
    ```bash
    realtimex-pp-cli --version
    ```
-   The output must be `realtimex-pp-cli 2.0.22`.
+   The output must be `realtimex-pp-cli 2.0.24`.
 
-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.22`, 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.24`, 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.
@@ -286,6 +298,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli update-channel <channelId>` — Update one chat channel by exact channel id. Only channel writable fields are changed.
 
+**workspace-shell-layout** — Manage workspace shell layout
+
+- `realtimex-pp-cli workspace-shell-layout` — Verify workspace navigation, title-bar containment, Files dock behavior
+
 
 ### Finding the right command
 
@@ -412,9 +428,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.22`, reinstall the pinned version:
+   If the command is missing or the output is not exactly `realtimex-pp-cli 2.0.24`, reinstall the pinned version:
    ```bash
-   npm install -g @realtimex/pp-cli@2.0.22
+   npm install -g @realtimex/pp-cli@2.0.24
    ```
    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