@realtimex/sdk 2.0.34 → 2.0.35

package/skills/realtimex-artifacts/SKILL.md

@@ -15,16 +15,16 @@ List, publish, inspect, pause, resume, and revoke RealTimeX workspace artifacts.
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.34. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.35. 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:
+If it is missing or does not report `realtimex-pp-cli 2.0.35`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.34
+npm install -g @realtimex/pp-cli@2.0.35
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-automation-flows/SKILL.md

@@ -15,16 +15,16 @@ Run RealTimeX automation workflows and guided automation-flow commands, includin
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.34. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.35. 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:
+If it is missing or does not report `realtimex-pp-cli 2.0.35`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.34
+npm install -g @realtimex/pp-cli@2.0.35
 ```
 
 For requests about the current workspace or thread, resolve context first:
@@ -35,14 +35,42 @@ realtimex-pp-cli prepare --agent
 
 ## Command reference
 
+**archive-active-thread-spa** — Manage archive active thread spa
+
+- `realtimex-pp-cli archive-active-thread-spa` — Verify archive and global-search thread navigation stay in one Electron renderer without eager TTS workers or runaway
+
 **chat-with-terminal-agent** — Manage chat with terminal agent
 
 - `realtimex-pp-cli chat-with-terminal-agent` — Guide a user through sending a chat message to the terminal agent.
 
+**companion-host-capability-rename** — Manage companion host capability rename
+
+- `realtimex-pp-cli companion-host-capability-rename` — Verify Companion host-capability rename preview, navigation cancellation, confirmation, and terminal-session isolation.
+
+**delegate-rules-authoring** — Manage delegate rules authoring
+
+- `realtimex-pp-cli delegate-rules-authoring` — Verify Delegate natural-language authoring, compilation states, simulation, activation CAS, and immutable history.
+
+**dogfood-companion-scout** — Manage dogfood companion scout
+
+- `realtimex-pp-cli dogfood-companion-scout` — Preview and confirm one governed Dogfood Scout capability, prove confirmation idempotency, PM delivery
+
 **goal-kickoff-composer** — Manage goal kickoff composer
 
 - `realtimex-pp-cli goal-kickoff-composer` — Verify the shared Project/global Goal kickoff composer, routing, attachment authorization, retry, preview
 
+**loop-background-handoff-order-e2e** — Manage loop background handoff order e2e
+
+- `realtimex-pp-cli loop-background-handoff-order-e2e` — Verify handoff, reply, and card order after returning to a cached background thread.
+
+**loop-cold-handoff-e2e** — Manage loop cold handoff e2e
+
+- `realtimex-pp-cli loop-cold-handoff-e2e` — Prove a new Loops role thread cold-launches its workspace default terminal agent exactly once before canonical state
+
+**loop-live-handoff-order-e2e** — Manage loop live handoff order e2e
+
+- `realtimex-pp-cli loop-live-handoff-order-e2e` — Prove a live loop handoff stays above its active terminal-session card and card-linked reply.
+
 **run-automation-workflow** — Manage run automation workflow
 
 - `realtimex-pp-cli run-automation-workflow` — Run any app automation flow or scenario exposed via flowMetadata.cli.enabled=true by passing workflowName.

package/skills/realtimex-browser-sessions/SKILL.md

@@ -15,16 +15,16 @@ List, create, start, stop, and delete isolated RealTimeX browser sessions. Use f
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.34. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.35. 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:
+If it is missing or does not report `realtimex-pp-cli 2.0.35`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.34
+npm install -g @realtimex/pp-cli@2.0.35
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-channels/SKILL.md

@@ -15,16 +15,16 @@ Create, configure, start, stop, and delete RealTimeX chat channels, approve pair
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.34. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.35. 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:
+If it is missing or does not report `realtimex-pp-cli 2.0.35`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.34
+npm install -g @realtimex/pp-cli@2.0.35
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-delegates/SKILL.md

@@ -0,0 +1,137 @@
+---
+name: realtimex-delegates
+description: "Manage RealTimeX Delegate scope bindings, policy drafts and compiler jobs, activation, lifecycle, decisions, and executions. Use for explicit Human-representing Delegate authority administration."
+allowed-tools: "Read Bash"
+metadata:
+  openclaw:
+    requires:
+      bins:
+        - realtimex-pp-cli
+---
+
+# RealTimeX Delegates
+
+Manage RealTimeX Delegate scope bindings, policy drafts and compiler jobs, activation, lifecycle, decisions, and executions. Use for explicit Human-representing Delegate authority administration.
+
+## CLI setup
+
+This skill uses `realtimex-pp-cli` version 2.0.35. Before using its commands:
+
+```bash
+realtimex-pp-cli --version
+```
+
+If it is missing or does not report `realtimex-pp-cli 2.0.35`, install the pinned version:
+
+```bash
+npm install -g @realtimex/pp-cli@2.0.35
+```
+
+For requests about the current workspace or thread, resolve context first:
+
+```bash
+realtimex-pp-cli prepare --agent
+```
+
+## Command reference
+
+**activate-delegate-policy** — Manage activate delegate policy
+
+- `realtimex-pp-cli activate-delegate-policy <instanceId>` — Activate a compiled candidate with exact optimistic revisions and explicit instance confirmation.
+
+**cancel-delegate-compiler-job** — Manage cancel delegate compiler job
+
+- `realtimex-pp-cli cancel-delegate-compiler-job <instanceId> <jobId>` — Cancel delegate compiler job
+
+**compile-delegate-policy** — Manage compile delegate policy
+
+- `realtimex-pp-cli compile-delegate-policy <instanceId> <revision>` — Start a strictly idempotent compilation for one immutable draft revision.
+
+**get-delegate** — Manage get delegate
+
+- `realtimex-pp-cli get-delegate <instanceId>` — Inspect one owned Delegate, including safe health, policy, runtime, recent decision, and execution state.
+
+**get-delegate-compiler-job** — Manage get delegate compiler job
+
+- `realtimex-pp-cli get-delegate-compiler-job <instanceId> <jobId>` — Get delegate compiler job
+
+**get-delegate-decision** — Manage get delegate decision
+
+- `realtimex-pp-cli get-delegate-decision <instanceId> <decisionId>` — Get delegate decision
+
+**get-delegate-execution** — Manage get delegate execution
+
+- `realtimex-pp-cli get-delegate-execution <instanceId> <executionId>` — Get delegate execution
+
+**get-delegate-policy-candidate** — Manage get delegate policy candidate
+
+- `realtimex-pp-cli get-delegate-policy-candidate <instanceId>` — Get delegate policy candidate
+
+**get-delegate-policy-draft** — Manage get delegate policy draft
+
+- `realtimex-pp-cli get-delegate-policy-draft <instanceId>` — Get delegate policy draft
+
+**get-delegate-policy-version** — Manage get delegate policy version
+
+- `realtimex-pp-cli get-delegate-policy-version <instanceId> <version>` — Get delegate policy version
+
+**list-delegate-compiler-jobs** — Manage list delegate compiler jobs
+
+- `realtimex-pp-cli list-delegate-compiler-jobs <instanceId>` — List delegate compiler jobs
+
+**list-delegate-executions** — Manage list delegate executions
+
+- `realtimex-pp-cli list-delegate-executions <instanceId>` — List a stable page of safe execution summaries.
+
+**list-delegate-policy-versions** — Manage list delegate policy versions
+
+- `realtimex-pp-cli list-delegate-policy-versions <instanceId>` — List delegate policy versions
+
+**provision-delegate** — Manage provision delegate
+
+- `realtimex-pp-cli provision-delegate` — Provision and bind the authenticated user as the Delegate for an explicit scope.
+
+**resolve-delegate** — Manage resolve delegate
+
+- `realtimex-pp-cli resolve-delegate` — Resolve the authenticated user Delegate for an explicit supported consumer scope without provisioning it.
+
+**resume-delegate** — Manage resume delegate
+
+- `realtimex-pp-cli resume-delegate <instanceId>` — Resume delegate
+
+**retry-delegate-compiler-job** — Manage retry delegate compiler job
+
+- `realtimex-pp-cli retry-delegate-compiler-job <instanceId> <jobId>` — Create or return the one durable direct retry of an eligible terminal compiler job.
+
+**revoke-delegate-outstanding** — Manage revoke delegate outstanding
+
+- `realtimex-pp-cli revoke-delegate-outstanding <instanceId>` — Revoke delegate outstanding
+
+**save-delegate-policy-draft** — Manage save delegate policy draft
+
+- `realtimex-pp-cli save-delegate-policy-draft <instanceId>` — Save a policy draft with an explicit optimistic revision. Use expectedRevision zero for the first save.
+
+**simulate-delegate-policy** — Manage simulate delegate policy
+
+- `realtimex-pp-cli simulate-delegate-policy <instanceId>` — Simulate delegate policy
+
+**suspend-delegate** — Manage suspend delegate
+
+- `realtimex-pp-cli suspend-delegate <instanceId>` — Suspend delegate
+
+## Domain rules
+
+- Treat `configure-plugin` as topology deployment only; it does not grant, activate, suspend, resume, or revoke Delegate authority.
+- Always supply the explicit native scope identifier: global topology registry id, project topology assignment id, or numeric Workspace Team database id.
+- Inspect the Delegate, draft, compiler job, or execution before dependent mutations, and preserve every server-returned id and revision exactly.
+- Never automatically retry Delegate mutations after a timeout, network error, 429, or 5xx response. Read authoritative state before deciding whether a manual repeat is safe.
+- Use `expected-revision 0` for the first draft save and `expected-policy-version none` only when no policy is active.
+- Supply exact instance confirmation where required. Do not invent confirmation or refresh stale activation revisions automatically.
+- Poll compiler jobs and pending decisions with the generated GET commands; polling must not create work or authority.
+
+## 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-heartbeat/SKILL.md

@@ -15,16 +15,16 @@ Configure RealTimeX heartbeat scheduling, agents, active hours, timezone, autopi
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.34. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.35. 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:
+If it is missing or does not report `realtimex-pp-cli 2.0.35`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.34
+npm install -g @realtimex/pp-cli@2.0.35
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-local-apps/SKILL.md

@@ -15,16 +15,16 @@ Create, inspect, configure, start, stop, restart, and delete RealTimeX Local App
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.34. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.35. 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:
+If it is missing or does not report `realtimex-pp-cli 2.0.35`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.34
+npm install -g @realtimex/pp-cli@2.0.35
 ```
 
 For requests about the current workspace or thread, resolve context first:

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

@@ -1,6 +1,6 @@
 ---
 name: realtimex-moderator-sdk
-description: "Route RealTimeX API work to the focused workspace, terminal-agent, browser-session, local-app, heartbeat, automation-flow, artifact, channel, webhook, or plugin-and-skill capability. Use when a request spans capabilities or the correct RealTimeX skill is unclear."
+description: "Route RealTimeX API work to the focused workspace, terminal-agent, browser-session, local-app, heartbeat, automation-flow, artifact, channel, webhook, Delegate-authority, or plugin-and-skill capability. Use when a request spans capabilities or the correct RealTimeX skill is unclear."
 allowed-tools: "Read Bash"
 metadata:
   openclaw:
@@ -15,16 +15,16 @@ Use this router to select the smallest RealTimeX skill that owns the requested o
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.34. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.35. 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:
+If it is missing or does not report `realtimex-pp-cli 2.0.35`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.34
+npm install -g @realtimex/pp-cli@2.0.35
 ```
 
 For requests about the current workspace or thread, resolve context first:
@@ -47,6 +47,7 @@ realtimex-pp-cli prepare --agent
 | `realtimex-channels` | Create, configure, start, stop, and delete RealTimeX chat channels, approve pairing codes, and deliver channel files. Use for Telegram, Zalo, Discord, and other channel integrations. |
 | `realtimex-webhooks` | Create, inspect, update, test, and delete RealTimeX public webhook endpoints and inspect bounded delivery metadata. Use for inbound public webhook trigger configuration. |
 | `realtimex-plugin-and-skill` | Manage RealTimeX plugins and agent skills, including configuration, enablement, reload, installation, promotion, and workspace skill state. Use for plugin and skill administration. |
+| `realtimex-delegates` | Manage RealTimeX Delegate scope bindings, policy drafts and compiler jobs, activation, lifecycle, decisions, and executions. Use for explicit Human-representing Delegate authority administration. |
 
 ## Cross-domain requests
 

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

@@ -15,16 +15,16 @@ Manage RealTimeX plugins and agent skills, including configuration, enablement,
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.34. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.35. 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:
+If it is missing or does not report `realtimex-pp-cli 2.0.35`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.34
+npm install -g @realtimex/pp-cli@2.0.35
 ```
 
 For requests about the current workspace or thread, resolve context first:
@@ -37,7 +37,7 @@ realtimex-pp-cli prepare --agent
 
 **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.
+- `realtimex-pp-cli configure-plugin <pluginId>` — Set non-secret global configuration values for one installed plugin.
 
 **create-workspace-agent-skill** — Manage create workspace agent skill
 
@@ -61,7 +61,7 @@ realtimex-pp-cli prepare --agent
 
 **get-plugin** — Manage get plugin
 
-- `realtimex-pp-cli get-plugin <pluginId>` — Get one installed plugin with its config schema (keys, labels, types, defaults)
+- `realtimex-pp-cli get-plugin <pluginId>` — Get one installed plugin with its global config schema and current non-secret global values.
 
 **install-plugin** — Manage install plugin
 
@@ -69,7 +69,7 @@ realtimex-pp-cli prepare --agent
 
 **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.
+- `realtimex-pp-cli list-agent-skills` — List available non-candidate agent skills.
 
 **list-plugins** — Manage list plugins
 
@@ -77,7 +77,7 @@ realtimex-pp-cli prepare --agent
 
 **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.
+- `realtimex-pp-cli list-workspace-agent-skills <workspaceSlug>` — List available non-candidate agent skills with enabled/disabled state for one exact workspace slug.
 
 **promote-workspace-agent-skill** — Manage promote workspace agent skill
 

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

@@ -15,16 +15,16 @@ Manage RealTimeX terminal agents, terminal sessions, session messages, and idle
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.34. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.35. 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:
+If it is missing or does not report `realtimex-pp-cli 2.0.35`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.34
+npm install -g @realtimex/pp-cli@2.0.35
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-webhooks/SKILL.md

@@ -15,16 +15,16 @@ Create, inspect, update, test, and delete RealTimeX public webhook endpoints and
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.34. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.35. 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:
+If it is missing or does not report `realtimex-pp-cli 2.0.35`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.34
+npm install -g @realtimex/pp-cli@2.0.35
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-workspaces/SKILL.md

@@ -15,16 +15,16 @@ Manage RealTimeX workspaces, threads, messages, workspace personality, LLM confi
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.34. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.35. 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:
+If it is missing or does not report `realtimex-pp-cli 2.0.35`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.34
+npm install -g @realtimex/pp-cli@2.0.35
 ```
 
 For requests about the current workspace or thread, resolve context first: