@realtimex/sdk 2.0.33 → 2.0.34

package/skills/realtimex-plugin-and-skill/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: realtimex-plugin-and-skill
+description: "Manage RealTimeX plugins and agent skills, including configuration, enablement, reload, installation, promotion, and workspace skill state. Use for plugin and skill administration."
+allowed-tools: "Read Bash"
+metadata:
+  openclaw:
+    requires:
+      bins:
+        - realtimex-pp-cli
+---
+
+# RealTimeX Plugins and Skills
+
+Manage RealTimeX plugins and agent skills, including configuration, enablement, reload, installation, promotion, and workspace skill state. Use for plugin and skill administration.
+
+## CLI setup
+
+This skill uses `realtimex-pp-cli` version 2.0.34. Before using its commands:
+
+```bash
+realtimex-pp-cli --version
+```
+
+If it is missing or does not report `realtimex-pp-cli 2.0.34`, install the pinned version:
+
+```bash
+npm install -g @realtimex/pp-cli@2.0.34
+```
+
+For requests about the current workspace or thread, resolve context first:
+
+```bash
+realtimex-pp-cli prepare --agent
+```
+
+## Command reference
+
+**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-workspace-agent-skill** — Manage create workspace agent skill
+
+- `realtimex-pp-cli create-workspace-agent-skill <workspaceSlug>` — Create a managed agent skill owned by one workspace.
+
+**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-plugin** — Manage get plugin
+
+- `realtimex-pp-cli get-plugin <pluginId>` — Get one installed plugin with its config schema (keys, labels, types, defaults)
+
+**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.
+
+**list-plugins** — Manage list plugins
+
+- `realtimex-pp-cli list-plugins` — List installed plugins with enabled state and runtime load status.
+
+**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.
+
+**promote-workspace-agent-skill** — Manage promote workspace agent skill
+
+- `realtimex-pp-cli promote-workspace-agent-skill <workspaceSlug> <skillId>` — Promote one workspace-owned agent skill to a global managed skill by copying its files into a new global skill row.
+
+**reload-agent-skills** — Manage reload agent skills
+
+- `realtimex-pp-cli reload-agent-skills` — Force reload all enabled agent skills into one workspace working directory.
+
+**reload-plugin** — Manage reload plugin
+
+- `realtimex-pp-cli reload-plugin <pluginId>` — Reload one enabled plugin in runtime. Disabled plugins must be enabled before reload.
+
+## Domain rules
+
+- List plugins or skills before changing them and use the exact returned identifier.
+- Inspect a plugin schema before configuration and never invent configuration keys.
+- After reloading agent skills, reload the caller skill context before relying on changed instructions.
+
+## Shared constraints
+
+- Run documented commands with `--agent`.
+- Use exact identifiers returned by `prepare` or the relevant list/get command; do not guess values.
+- Do not bypass the CLI with raw HTTP calls. If a required operation is absent, report that limitation.
+- Ask one concise clarification when required target context is missing or ambiguous.

package/skills/realtimex-terminal-agents/SKILL.md

@@ -0,0 +1,89 @@
+---
+name: realtimex-terminal-agents
+description: "Manage RealTimeX terminal agents, terminal sessions, session messages, and idle prompts. Use for desktop terminal-agent runtime and terminal-session lifecycle work."
+allowed-tools: "Read Bash"
+metadata:
+  openclaw:
+    requires:
+      bins:
+        - realtimex-pp-cli
+---
+
+# RealTimeX Terminal Agents
+
+Manage RealTimeX terminal agents, terminal sessions, session messages, and idle prompts. Use for desktop terminal-agent runtime and terminal-session lifecycle work.
+
+## CLI setup
+
+This skill uses `realtimex-pp-cli` version 2.0.34. Before using its commands:
+
+```bash
+realtimex-pp-cli --version
+```
+
+If it is missing or does not report `realtimex-pp-cli 2.0.34`, install the pinned version:
+
+```bash
+npm install -g @realtimex/pp-cli@2.0.34
+```
+
+For requests about the current workspace or thread, resolve context first:
+
+```bash
+realtimex-pp-cli prepare --agent
+```
+
+## Command reference
+
+**get-terminal-session-context** — Manage get terminal session context
+
+- `realtimex-pp-cli get-terminal-session-context <sessionId>` — Read a bounded, sanitized tail of the PTY output for one exact live terminal runtime session.
+
+**list-terminal-agents** — Manage list terminal agents
+
+- `realtimex-pp-cli list-terminal-agents` — List terminal CLI agents that can be used with open-terminal-session.
+
+**list-terminal-sessions** — Manage list terminal sessions
+
+- `realtimex-pp-cli list-terminal-sessions` — List terminal runtime sessions known to the desktop app. Optionally filter by workspaceSlug and threadSlug.
+
+**open-terminal-session** — Manage open terminal session
+
+- `realtimex-pp-cli open-terminal-session` — Open a new desktop terminal session for one terminal CLI agent. Use list-terminal-agents or prepare.
+
+**respond-terminal-idle-prompt** — Manage respond terminal idle prompt
+
+- `realtimex-pp-cli respond-terminal-idle-prompt <sessionId>` — Send one constrained response action to an exact idle terminal session only when its PTY event sequence is unchanged.
+
+**resume-latest-terminal-session** — Manage resume latest terminal session
+
+- `realtimex-pp-cli resume-latest-terminal-session` — Resume the latest terminal runtime session for one exact thread.
+
+**resume-terminal-session** — Manage resume terminal session
+
+- `realtimex-pp-cli resume-terminal-session <sessionId>` — Resume a terminal runtime session by attaching a CLI controller.
+
+**send-terminal-session-message** — Manage send terminal session message
+
+- `realtimex-pp-cli send-terminal-session-message <sessionId>` — Send one message directly to an exact live terminal session.
+
+**stop-thread-terminal-session** — Manage stop thread terminal session
+
+- `realtimex-pp-cli stop-thread-terminal-session` — Interrupt the selected or current chat-linked terminal session for one exact thread without closing the underlying
+
+**terminate-terminal-session** — Manage terminate terminal session
+
+- `realtimex-pp-cli terminate-terminal-session <sessionId>` — Terminate a terminal runtime session by detaching any controller and closing the underlying PTY session.
+
+## Domain rules
+
+- Discover available agents before opening a session and use exact agent, provider, and model identifiers.
+- Use list operations before resume, stop, or terminate actions; preserve the exact session identifier.
+- Respond to an idle prompt only when the reported session and event sequence still match.
+
+## Shared constraints
+
+- Run documented commands with `--agent`.
+- Use exact identifiers returned by `prepare` or the relevant list/get command; do not guess values.
+- Do not bypass the CLI with raw HTTP calls. If a required operation is absent, report that limitation.
+- Ask one concise clarification when required target context is missing or ambiguous.

package/skills/realtimex-webhooks/SKILL.md

@@ -0,0 +1,77 @@
+---
+name: realtimex-webhooks
+description: "Create, inspect, update, test, and delete RealTimeX public webhook endpoints and inspect bounded delivery metadata. Use for inbound public webhook trigger configuration."
+allowed-tools: "Read Bash"
+metadata:
+  openclaw:
+    requires:
+      bins:
+        - realtimex-pp-cli
+---
+
+# RealTimeX Webhooks
+
+Create, inspect, update, test, and delete RealTimeX public webhook endpoints and inspect bounded delivery metadata. Use for inbound public webhook trigger configuration.
+
+## CLI setup
+
+This skill uses `realtimex-pp-cli` version 2.0.34. Before using its commands:
+
+```bash
+realtimex-pp-cli --version
+```
+
+If it is missing or does not report `realtimex-pp-cli 2.0.34`, install the pinned version:
+
+```bash
+npm install -g @realtimex/pp-cli@2.0.34
+```
+
+For requests about the current workspace or thread, resolve context first:
+
+```bash
+realtimex-pp-cli prepare --agent
+```
+
+## Command reference
+
+**create-webhook-endpoint** — Manage create webhook endpoint
+
+- `realtimex-pp-cli create-webhook-endpoint` — Create a webhook endpoint in an accessible workspace. secret is a write-only input.
+
+**delete-webhook-endpoint** — Manage delete webhook endpoint
+
+- `realtimex-pp-cli delete-webhook-endpoint <endpointId>` — Permanently delete a visible webhook endpoint. confirmDestructive must be true.
+
+**get-webhook-endpoint** — Manage get webhook endpoint
+
+- `realtimex-pp-cli get-webhook-endpoint <endpointId>` — Get one visible webhook endpoint by endpoint id. The response reports secretConfigured but never returns the secret.
+
+**list-webhook-deliveries** — Manage list webhook deliveries
+
+- `realtimex-pp-cli list-webhook-deliveries` — List bounded delivery metadata for visible webhook endpoints.
+
+**list-webhook-endpoints** — Manage list webhook endpoints
+
+- `realtimex-pp-cli list-webhook-endpoints` — List webhook endpoints visible to the authenticated user. Secrets are never returned.
+
+**test-webhook-endpoint** — Manage test webhook endpoint
+
+- `realtimex-pp-cli test-webhook-endpoint <endpointId>` — Submit an optional JSON payload as a signed test delivery through a visible webhook endpoint.
+
+**update-webhook-endpoint** — Manage update webhook endpoint
+
+- `realtimex-pp-cli update-webhook-endpoint <endpointId>` — Update a visible webhook endpoint. Passing secret rotates it; the value is never returned.
+
+## Domain rules
+
+- Treat webhook secrets as write-only input. Never expect or expose plaintext secrets from endpoint responses.
+- Inspect webhook deliveries only through the bounded delivery-list command; raw payload and signature material are intentionally unavailable.
+- Require explicit confirmation before permanent webhook endpoint deletion.
+
+## Shared constraints
+
+- Run documented commands with `--agent`.
+- Use exact identifiers returned by `prepare` or the relevant list/get command; do not guess values.
+- Do not bypass the CLI with raw HTTP calls. If a required operation is absent, report that limitation.
+- Ask one concise clarification when required target context is missing or ambiguous.

package/skills/realtimex-workspaces/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: realtimex-workspaces
+description: "Manage RealTimeX workspaces, threads, messages, workspace personality, LLM configuration, and default agents. Use for workspace and conversation operations."
+allowed-tools: "Read Bash"
+metadata:
+  openclaw:
+    requires:
+      bins:
+        - realtimex-pp-cli
+---
+
+# RealTimeX Workspaces
+
+Manage RealTimeX workspaces, threads, messages, workspace personality, LLM configuration, and default agents. Use for workspace and conversation operations.
+
+## CLI setup
+
+This skill uses `realtimex-pp-cli` version 2.0.34. Before using its commands:
+
+```bash
+realtimex-pp-cli --version
+```
+
+If it is missing or does not report `realtimex-pp-cli 2.0.34`, install the pinned version:
+
+```bash
+npm install -g @realtimex/pp-cli@2.0.34
+```
+
+For requests about the current workspace or thread, resolve context first:
+
+```bash
+realtimex-pp-cli prepare --agent
+```
+
+## Command reference
+
+**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-thread** — Manage create thread
+
+- `realtimex-pp-cli create-thread <workspaceSlug>` — Create a thread in one workspace. The name is optional but recommended.
+
+**create-workspace** — Manage create workspace
+
+- `realtimex-pp-cli create-workspace` — Create a workspace. Requires a human-readable workspace name.
+
+**delete-thread** — Manage delete thread
+
+- `realtimex-pp-cli delete-thread <workspaceSlug> <threadSlug>` — Delete one thread by exact workspace slug and exact thread slug.
+
+**delete-workspace** — Manage delete workspace
+
+- `realtimex-pp-cli delete-workspace <workspaceSlug>` — Delete one workspace by exact workspace slug.
+
+**get-thread** — Manage get thread
+
+- `realtimex-pp-cli get-thread <workspaceSlug> <threadSlug>` — Get one thread by exact workspace slug and exact thread slug.
+
+**get-workspace** — Manage get workspace
+
+- `realtimex-pp-cli get-workspace <workspaceSlug>` — Get one workspace by exact workspace slug.
+
+**list-llm-models** — Manage list llm models
+
+- `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 when configuring workspace or thread LLM settings.
+
+**list-threads** — Manage list threads
+
+- `realtimex-pp-cli list-threads <workspaceSlug>` — List threads 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, current workspace/thread, LLM provider, model
+
+**rename-thread** — Manage rename thread
+
+- `realtimex-pp-cli rename-thread <workspaceSlug> <threadSlug>` — Rename one thread by exact workspace slug and exact thread slug. Only the name is changed.
+
+**rename-workspace** — Manage rename workspace
+
+- `realtimex-pp-cli rename-workspace <workspaceSlug>` — Rename one workspace by exact workspace slug. Only the name is changed.
+
+**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-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-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.
+
+## Domain rules
+
+- Use `prepare` as the source of truth for the current workspace, thread, available agents, providers, and models.
+- For `send-message`, require an explicit or unambiguous workspace, thread, and message. The server selects the thread model.
+- For workspace default-agent changes, use exact agent canonical and model values returned by `prepare`.
+
+## Shared constraints
+
+- Run documented commands with `--agent`.
+- Use exact identifiers returned by `prepare` or the relevant list/get command; do not guess values.
+- Do not bypass the CLI with raw HTTP calls. If a required operation is absent, report that limitation.
+- Ask one concise clarification when required target context is missing or ambiguous.

package/skills/realtimex-workspaces/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