@realtimex/sdk 2.0.47 → 2.0.48

package/index.d.ts

@@ -270,7 +270,43 @@ export type CreateBrowserSessionBody = {
   guardrails?: Record<string, unknown>;
   origin?: string;
 };
-export type CreateBrowserSessionResponse = Record<string, unknown>;
+export type CreateBrowserSessionResponse = {
+  success: boolean;
+  session?: {
+  sessionName: string;
+  status: string;
+  running: boolean;
+  remoteDebugPort?: number | null;
+  tabs?: Array<{
+  id?: number;
+  url?: string;
+  title?: string;
+  isActive?: boolean;
+}>;
+  control: {
+  mode?: "agent" | "person" | "idle";
+  source?: "gateway" | "host-only";
+  agent?: {
+  clients?: number;
+  lastCommandAt?: string | null;
+  active?: boolean;
+};
+  person?: {
+  since?: string | null;
+};
+  startedBy?: Record<string, unknown> | null;
+  updatedAt?: string | null;
+} | null;
+  pendingAuth: {
+  host: string;
+  realm: string | null;
+} | null;
+  downloads: {
+  count: number;
+  lastAt: string | null;
+} | null;
+} | null;
+};
 export interface CreateBrowserSessionOptions extends RealtimeXRequestOptions {
   params?: CreateBrowserSessionParams;
   query?: CreateBrowserSessionQuery;
@@ -308,6 +344,7 @@ export type CreateChannelBody = {
   config?: Record<string, unknown>;
   settings?: {
   deliveryMode?: "agent" | "platform";
+  ownerMessages?: boolean;
 };
 };
 export type CreateChannelResponse = Record<string, unknown>;
@@ -720,7 +757,43 @@ export type FocusBrowserTabBody = {
   tabRef?: string;
   focusWindow?: boolean;
 };
-export type FocusBrowserTabResponse = Record<string, unknown>;
+export type FocusBrowserTabResponse = {
+  success: boolean;
+  session?: {
+  sessionName: string;
+  status: string;
+  running: boolean;
+  remoteDebugPort?: number | null;
+  tabs?: Array<{
+  id?: number;
+  url?: string;
+  title?: string;
+  isActive?: boolean;
+}>;
+  control: {
+  mode?: "agent" | "person" | "idle";
+  source?: "gateway" | "host-only";
+  agent?: {
+  clients?: number;
+  lastCommandAt?: string | null;
+  active?: boolean;
+};
+  person?: {
+  since?: string | null;
+};
+  startedBy?: Record<string, unknown> | null;
+  updatedAt?: string | null;
+} | null;
+  pendingAuth: {
+  host: string;
+  realm: string | null;
+} | null;
+  downloads: {
+  count: number;
+  lastAt: string | null;
+} | null;
+} | null;
+};
 export interface FocusBrowserTabOptions extends RealtimeXRequestOptions {
   params?: FocusBrowserTabParams;
   query?: FocusBrowserTabQuery;
@@ -1117,6 +1190,39 @@ export interface ListArtifactsOptions extends RealtimeXRequestOptions {
   body?: ListArtifactsBody;
 }
 
+export type ListBrowserDownloadsParams = {
+  sessionName: string;
+};
+export type ListBrowserDownloadsQuery = Record<string, never>;
+export type ListBrowserDownloadsHeaders = {
+  "x-app-id"?: string;
+};
+export type ListBrowserDownloadsBody = unknown;
+export type ListBrowserDownloadsResponse = {
+  success: true;
+  sessionName: string;
+  downloads: Array<{
+  id: string;
+  filename?: string | null;
+  path?: string | null;
+  state: "progressing" | "completed" | "cancelled" | "interrupted";
+  url?: string | null;
+  mimeType?: string | null;
+  startedBy: "agent" | "person" | "unknown";
+  receivedBytes?: number;
+  totalBytes?: number;
+  startedAt?: string | null;
+  endedAt?: string | null;
+  reason?: string;
+}>;
+};
+export interface ListBrowserDownloadsOptions extends RealtimeXRequestOptions {
+  params?: ListBrowserDownloadsParams;
+  query?: ListBrowserDownloadsQuery;
+  headers?: ListBrowserDownloadsHeaders & Record<string, string>;
+  body?: ListBrowserDownloadsBody;
+}
+
 export type ListBrowserProfilesParams = Record<string, never>;
 export type ListBrowserProfilesQuery = Record<string, never>;
 export type ListBrowserProfilesHeaders = {
@@ -1137,7 +1243,44 @@ export type ListBrowserSessionsHeaders = {
   "x-app-id"?: string;
 };
 export type ListBrowserSessionsBody = unknown;
-export type ListBrowserSessionsResponse = Record<string, unknown>;
+export type ListBrowserSessionsResponse = {
+  success: true;
+  sessions: Array<{
+  sessionName: string;
+  status: string;
+  running: boolean;
+  remoteDebugPort?: number | null;
+  tabs?: Array<{
+  id?: number;
+  url?: string;
+  title?: string;
+  isActive?: boolean;
+}>;
+  control: {
+  mode?: "agent" | "person" | "idle";
+  source?: "gateway" | "host-only";
+  agent?: {
+  clients?: number;
+  lastCommandAt?: string | null;
+  active?: boolean;
+};
+  person?: {
+  since?: string | null;
+};
+  startedBy?: Record<string, unknown> | null;
+  updatedAt?: string | null;
+} | null;
+  pendingAuth: {
+  host: string;
+  realm: string | null;
+} | null;
+  downloads: {
+  count: number;
+  lastAt: string | null;
+} | null;
+}>;
+  profiles?: Array<Record<string, unknown>>;
+};
 export interface ListBrowserSessionsOptions extends RealtimeXRequestOptions {
   params?: ListBrowserSessionsParams;
   query?: ListBrowserSessionsQuery;
@@ -1568,6 +1711,43 @@ export interface PauseArtifactOptions extends RealtimeXRequestOptions {
   body?: PauseArtifactBody;
 }
 
+export type PeerConnectionFixtureParams = Record<string, never>;
+export type PeerConnectionFixtureQuery = Record<string, never>;
+export type PeerConnectionFixtureHeaders = Record<string, never>;
+export type PeerConnectionFixtureBody = {
+  workspaceSlug?: string;
+  storageUser?: string;
+  artifactPath?: string;
+  timeoutMs?: number;
+  confirmDestructive?: boolean;
+};
+export type PeerConnectionFixtureResponse = Record<string, unknown>;
+export interface PeerConnectionFixtureOptions extends RealtimeXRequestOptions {
+  params?: PeerConnectionFixtureParams;
+  query?: PeerConnectionFixtureQuery;
+  headers?: PeerConnectionFixtureHeaders & Record<string, string>;
+  body?: PeerConnectionFixtureBody;
+}
+
+export type PeerRequestFixtureParams = Record<string, never>;
+export type PeerRequestFixtureQuery = Record<string, never>;
+export type PeerRequestFixtureHeaders = Record<string, never>;
+export type PeerRequestFixtureBody = {
+  workspaceSlug?: string;
+  threadSlug?: string;
+  storageUser?: string;
+  artifactPath?: string;
+  timeoutMs?: number;
+  confirmDestructive?: boolean;
+};
+export type PeerRequestFixtureResponse = Record<string, unknown>;
+export interface PeerRequestFixtureOptions extends RealtimeXRequestOptions {
+  params?: PeerRequestFixtureParams;
+  query?: PeerRequestFixtureQuery;
+  headers?: PeerRequestFixtureHeaders & Record<string, string>;
+  body?: PeerRequestFixtureBody;
+}
+
 export type PostCliDelegateConsultationsConsultationIdReplyParams = {
   consultationId: string;
 };
@@ -2599,7 +2779,43 @@ export type StartBrowserSessionHeaders = {
 export type StartBrowserSessionBody = {
   url?: string;
 };
-export type StartBrowserSessionResponse = Record<string, unknown>;
+export type StartBrowserSessionResponse = {
+  success: boolean;
+  session?: {
+  sessionName: string;
+  status: string;
+  running: boolean;
+  remoteDebugPort?: number | null;
+  tabs?: Array<{
+  id?: number;
+  url?: string;
+  title?: string;
+  isActive?: boolean;
+}>;
+  control: {
+  mode?: "agent" | "person" | "idle";
+  source?: "gateway" | "host-only";
+  agent?: {
+  clients?: number;
+  lastCommandAt?: string | null;
+  active?: boolean;
+};
+  person?: {
+  since?: string | null;
+};
+  startedBy?: Record<string, unknown> | null;
+  updatedAt?: string | null;
+} | null;
+  pendingAuth: {
+  host: string;
+  realm: string | null;
+} | null;
+  downloads: {
+  count: number;
+  lastAt: string | null;
+} | null;
+} | null;
+};
 export interface StartBrowserSessionOptions extends RealtimeXRequestOptions {
   params?: StartBrowserSessionParams;
   query?: StartBrowserSessionQuery;
@@ -2647,7 +2863,43 @@ export type StopBrowserSessionHeaders = {
 export type StopBrowserSessionBody = {
   timeoutMs?: number;
 };
-export type StopBrowserSessionResponse = Record<string, unknown>;
+export type StopBrowserSessionResponse = {
+  success: boolean;
+  session?: {
+  sessionName: string;
+  status: string;
+  running: boolean;
+  remoteDebugPort?: number | null;
+  tabs?: Array<{
+  id?: number;
+  url?: string;
+  title?: string;
+  isActive?: boolean;
+}>;
+  control: {
+  mode?: "agent" | "person" | "idle";
+  source?: "gateway" | "host-only";
+  agent?: {
+  clients?: number;
+  lastCommandAt?: string | null;
+  active?: boolean;
+};
+  person?: {
+  since?: string | null;
+};
+  startedBy?: Record<string, unknown> | null;
+  updatedAt?: string | null;
+} | null;
+  pendingAuth: {
+  host: string;
+  realm: string | null;
+} | null;
+  downloads: {
+  count: number;
+  lastAt: string | null;
+} | null;
+} | null;
+};
 export interface StopBrowserSessionOptions extends RealtimeXRequestOptions {
   params?: StopBrowserSessionParams;
   query?: StopBrowserSessionQuery;
@@ -2804,6 +3056,7 @@ export type UpdateChannelBody = {
   tts_enabled?: boolean;
   settings?: {
   deliveryMode?: "agent" | "platform";
+  ownerMessages?: boolean;
 };
 };
 export type UpdateChannelResponse = Record<string, unknown>;
@@ -3084,7 +3337,7 @@ export declare class RealtimeXClient {
   /** Set non-secret global configuration values for one installed plugin. Use a plugin id, name, or displayName from list-plugins. Password fields are refused for manual global setup; workspace-owned fields are rejected and must be configured in Workspace Settings → Plugins. */
   configurePlugin(options?: ConfigurePluginOptions): Promise<ConfigurePluginResponse>;
   configurePlugin(pluginId: string, body: ConfigurePluginBody, options?: Omit<ConfigurePluginOptions, 'params' | 'body'>): Promise<ConfigurePluginResponse>;
-  /** Create an isolated named RealTimeX Browser session. When url is supplied, start the session and open that URL. */
+  /** Create a named RealTimeX Browser session on its own throwaway profile, or, with profileName, on a profile the user created in Settings. When url is supplied, start it and open that URL. */
   createBrowserSession(options?: CreateBrowserSessionOptions): Promise<CreateBrowserSessionResponse>;
   createBrowserSession(body: CreateBrowserSessionBody, options?: Omit<CreateBrowserSessionOptions, 'body'>): Promise<CreateBrowserSessionResponse>;
   /** 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. */
@@ -3112,7 +3365,7 @@ export declare class RealtimeXClient {
   /** Create and deliver a valid synthetic Delegate Human-authorization task in an isolated development runtime. */
   delegateHumanTaskFixture(options?: DelegateHumanTaskFixtureOptions): Promise<DelegateHumanTaskFixtureResponse>;
   delegateHumanTaskFixture(body: DelegateHumanTaskFixtureBody, options?: Omit<DelegateHumanTaskFixtureOptions, 'body'>): Promise<DelegateHumanTaskFixtureResponse>;
-  /** Delete a stopped named RealTimeX Browser session and its isolated profile. */
+  /** Delete a stopped named RealTimeX Browser session. Its throwaway profile is removed with it; a profile the user created in Settings stays. */
   deleteBrowserSession(options?: DeleteBrowserSessionOptions): Promise<DeleteBrowserSessionResponse>;
   deleteBrowserSession(sessionName: string, options?: Omit<DeleteBrowserSessionOptions, 'params'>): Promise<DeleteBrowserSessionResponse>;
   /** Delete one chat channel by exact channel id. */
@@ -3206,6 +3459,9 @@ export declare class RealtimeXClient {
   /** List public artifacts for one exact workspace slug. Revoked artifacts are hidden unless includeRevoked=true is passed. */
   listArtifacts(options?: ListArtifactsOptions): Promise<ListArtifactsResponse>;
   listArtifacts(workspaceSlug: string, options?: Omit<ListArtifactsOptions, 'params'>): Promise<ListArtifactsResponse>;
+  /** List the downloads of a running RealTimeX Browser session, newest first: filename, path, state (progressing, completed, cancelled or interrupted), url, startedBy (agent, person or unknown) and byte counts. Files are saved to <Downloads folder>/RealTimeX Browser/<profile name>/. It answers while the person is in control. A session that is not running has no list. */
+  listBrowserDownloads(options?: ListBrowserDownloadsOptions): Promise<ListBrowserDownloadsResponse>;
+  listBrowserDownloads(sessionName: string, options?: Omit<ListBrowserDownloadsOptions, 'params'>): Promise<ListBrowserDownloadsResponse>;
   /** List RealTimeX Browser profiles: the identities (sign-ins) sessions run on, with retention policy and the session using each one. */
   listBrowserProfiles(options?: ListBrowserProfilesOptions): Promise<ListBrowserProfilesResponse>;
   /** List registered RealTimeX Browser sessions and their live runtime state. */
@@ -3270,6 +3526,12 @@ export declare class RealtimeXClient {
   /** Pause one published artifact by artifact id. Paused artifacts remain listed but stop serving publicly. */
   pauseArtifact(options?: PauseArtifactOptions): Promise<PauseArtifactResponse>;
   pauseArtifact(artifactId: string, options?: Omit<PauseArtifactOptions, 'params'>): Promise<PauseArtifactResponse>;
+  /** Put an isolated development runtime into one desktop-connection state for the #2671 thread-reference item. */
+  peerConnectionFixture(options?: PeerConnectionFixtureOptions): Promise<PeerConnectionFixtureResponse>;
+  peerConnectionFixture(body: PeerConnectionFixtureBody, options?: Omit<PeerConnectionFixtureOptions, 'body'>): Promise<PeerConnectionFixtureResponse>;
+  /** Seed one desktop-connection request card per UX contract v3 state into a thread of an isolated development runtime. */
+  peerRequestFixture(options?: PeerRequestFixtureOptions): Promise<PeerRequestFixtureResponse>;
+  peerRequestFixture(body: PeerRequestFixtureBody, options?: Omit<PeerRequestFixtureOptions, 'body'>): Promise<PeerRequestFixtureResponse>;
   postCliDelegateConsultationsConsultationIdReply(options?: PostCliDelegateConsultationsConsultationIdReplyOptions): Promise<PostCliDelegateConsultationsConsultationIdReplyResponse>;
   postCliDelegateConsultationsConsultationIdReply(consultationId: string, options?: Omit<PostCliDelegateConsultationsConsultationIdReplyOptions, 'params'>): Promise<PostCliDelegateConsultationsConsultationIdReplyResponse>;
   postCliDelegateRunsRunIdConsultations(options?: PostCliDelegateRunsRunIdConsultationsOptions): Promise<PostCliDelegateRunsRunIdConsultationsResponse>;

package/index.js

@@ -609,6 +609,18 @@ const operations = {
     ],
     "hasBody": false
   },
+  "listBrowserDownloads": {
+    "method": "GET",
+    "path": "/list-browser-downloads/{sessionName}",
+    "pathParams": [
+      "sessionName"
+    ],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": false
+  },
   "listBrowserProfiles": {
     "method": "GET",
     "path": "/list-browser-profiles",
@@ -881,6 +893,22 @@ const operations = {
     ],
     "hasBody": false
   },
+  "peerConnectionFixture": {
+    "method": "POST",
+    "path": "/peer-connection-fixture",
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [],
+    "hasBody": true
+  },
+  "peerRequestFixture": {
+    "method": "POST",
+    "path": "/peer-request-fixture",
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [],
+    "hasBody": true
+  },
   "postCliDelegateConsultationsConsultationIdReply": {
     "method": "POST",
     "path": "/delegate-consultations/{consultationId}/reply",
@@ -2441,6 +2469,13 @@ class RealtimeXClient {
     );
   }
 
+  listBrowserDownloads(...args) {
+    return this.request(
+      "listBrowserDownloads",
+      normalizeOperationOptions(operations["listBrowserDownloads"], args)
+    );
+  }
+
   listBrowserProfiles(...args) {
     return this.request(
       "listBrowserProfiles",
@@ -2623,6 +2658,20 @@ class RealtimeXClient {
     );
   }
 
+  peerConnectionFixture(...args) {
+    return this.request(
+      "peerConnectionFixture",
+      normalizeOperationOptions(operations["peerConnectionFixture"], args)
+    );
+  }
+
+  peerRequestFixture(...args) {
+    return this.request(
+      "peerRequestFixture",
+      normalizeOperationOptions(operations["peerRequestFixture"], args)
+    );
+  }
+
   postCliDelegateConsultationsConsultationIdReply(...args) {
     return this.request(
       "postCliDelegateConsultationsConsultationIdReply",
@@ -3117,5 +3166,5 @@ module.exports = {
   createRealtimeXClient,
   createRealtimeXWebhookClient,
   operations,
-  version: "2.0.47",
+  version: "2.0.48",
 };

package/package.json

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

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.47. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.48. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.47`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.48`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.48
 ```
 
 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.47. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.48. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.47`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.48`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.48
 ```
 
 For requests about the current workspace or thread, resolve context first:
@@ -83,6 +83,14 @@ realtimex-pp-cli prepare --agent
 
 - `realtimex-pp-cli memory-page` — Exercise the global Memory page with intercepted synthetic sources in an owned dev renderer.
 
+**peer-connection-fixture** — Manage peer connection fixture
+
+- `realtimex-pp-cli peer-connection-fixture` — Put an isolated development runtime into one desktop-connection state for the #2671 thread-reference item.
+
+**peer-request-fixture** — Manage peer request fixture
+
+- `realtimex-pp-cli peer-request-fixture` — Seed one desktop-connection request card per UX contract v3 state into a thread of an isolated development runtime.
+
 **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

@@ -1,6 +1,6 @@
 ---
 name: realtimex-browser-sessions
-description: "List, create, start, stop, delete and show tabs of isolated RealTimeX browser sessions. Use for named browser runtime and profile lifecycle work."
+description: "List, create, start, stop, delete and show tabs of named RealTimeX browser sessions. Use for named browser runtime and profile lifecycle work."
 allowed-tools: "Read Bash"
 metadata:
   openclaw:
@@ -11,20 +11,20 @@ metadata:
 
 # RealTimeX Browser Sessions
 
-List, create, start, stop, delete and show tabs of isolated RealTimeX browser sessions. Use for named browser runtime and profile lifecycle work.
+List, create, start, stop, delete and show tabs of named RealTimeX browser sessions. Use for named browser runtime and profile lifecycle work.
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.47. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.48. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.47`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.48`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.48
 ```
 
 For requests about the current workspace or thread, resolve context first:
@@ -37,16 +37,20 @@ realtimex-pp-cli prepare --agent
 
 **create-browser-session** — Manage create browser session
 
-- `realtimex-pp-cli create-browser-session` — Create an isolated named RealTimeX Browser session. When url is supplied, start the session and open that URL.
+- `realtimex-pp-cli create-browser-session` — Create a named RealTimeX Browser session on its own throwaway profile, or, with profileName
 
 **delete-browser-session** — Manage delete browser session
 
-- `realtimex-pp-cli delete-browser-session <sessionName>` — Delete a stopped named RealTimeX Browser session and its isolated profile.
+- `realtimex-pp-cli delete-browser-session <sessionName>` — Delete a stopped named RealTimeX Browser session.
 
 **focus-browser-tab** — Manage focus browser tab
 
 - `realtimex-pp-cli focus-browser-tab <sessionName>` — Make a tab the displayed tab of a running RealTimeX Browser session, so it renders before an agent interacts with it.
 
+**list-browser-downloads** — Manage list browser downloads
+
+- `realtimex-pp-cli list-browser-downloads <sessionName>` — List the downloads of a running RealTimeX Browser session, newest first: filename, path, state (progressing, completed
+
 **list-browser-profiles** — Manage list browser profiles
 
 - `realtimex-pp-cli list-browser-profiles` — List RealTimeX Browser profiles: the identities (sign-ins) sessions run on
@@ -66,10 +70,12 @@ realtimex-pp-cli prepare --agent
 ## Domain rules
 
 - List browser sessions before lifecycle changes and use the exact returned session name.
-- Create a named session before starting it; stop it when the task is done and do not delete it to clean up. Pass `--profile-name` only for a profile the user created in Settings and `list-browser-profiles` shows; the host removes throwaway sessions after your agent session ends.
+- Create a named session before starting it; stop it when the task is done and do not delete it to clean up. Pass `--profile-name` only for a profile the user created in Settings and `list-browser-profiles` shows, and a name `list-browser-profiles` does not show answers `404 profile-not-found` with `knownProfiles`; the host removes throwaway sessions after your agent session ends.
 - A session runs on a profile (a saved sign-in); without `--profile-name` it gets its own throwaway profile. Never substitute terminal-session identifiers for session names.
 - Before interacting with a tab over CDP, run `focus-browser-tab <sessionName> --tab-id <id>` so it becomes the displayed tab; add `--focus-window` only when the Human should see it.
 - If you attached `agent-browser` to a session, do not run `agent-browser close`; stopping the session closes it.
+- `list-browser-sessions` returns `control` per session (`mode` is `agent`, `person` or `idle`; null with browser control off). If a command fails because the person is in control, stop and wait for the hand-back message; to check later, run `list-browser-sessions` once and read `control.mode`, never in a loop.
+- `list-browser-downloads <sessionName>` lists the files a session downloaded, with `state`, `path` and `startedBy`; files are under `<Downloads>/RealTimeX Browser/<profile name>/`. A session entry's `pendingAuth` names an HTTP challenge only the person can answer.
 
 ## Shared constraints
 

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.47. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.48. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.47`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.48`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.48
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-decisions/SKILL.md

@@ -15,16 +15,16 @@ Run advisory decision-model judgments, list decision batteries, and calibrate ba
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.47. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.48. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.47`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.48`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.48
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-delegates/SKILL.md

@@ -15,16 +15,16 @@ Manage RealTimeX Delegate scope bindings, policy drafts and compiler jobs, activ
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.47. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.48. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.47`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.48`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.48
 ```
 
 For requests about the current workspace or thread, resolve context first:

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.47. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.48. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.47`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.48`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.48
 ```
 
 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.47. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.48. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.47`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.48`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.48
 ```
 
 For requests about the current workspace or thread, resolve context first:

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

@@ -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.47. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.48. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.47`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.48`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.48
 ```
 
 For requests about the current workspace or thread, resolve context first:
@@ -41,7 +41,7 @@ realtimex-pp-cli prepare --agent
 | `realtimex-secrets` | Manage encrypted Login, Card, Identity, SSH key and Secure note items, tags and workspace scope with the moderator CLI. Use saved fields in terminal commands or browser forms through rtxexec. |
 | `realtimex-workspaces` | Manage RealTimeX workspaces, threads, messages, workspace personality, LLM configuration, and default agents. Use for workspace and conversation operations. |
 | `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. |
-| `realtimex-browser-sessions` | List, create, start, stop, delete and show tabs of isolated RealTimeX browser sessions. Use for named browser runtime and profile lifecycle work. |
+| `realtimex-browser-sessions` | List, create, start, stop, delete and show tabs of named RealTimeX browser sessions. Use for named browser runtime and profile lifecycle work. |
 | `realtimex-local-apps` | Create, inspect, configure, start, stop, restart, and delete RealTimeX Local Apps. Use for local source, npx, uvx, webhook-trigger, status, log, and lifecycle operations. |
 | `realtimex-heartbeat` | Configure RealTimeX heartbeat scheduling, agents, active hours, timezone, autopilot, and immediate workspace heartbeat runs. Use for recurring HEARTBEAT.md task execution. |
 | `realtimex-automation-flows` | Run RealTimeX automation workflows and guided automation-flow commands, including working-directory setup and workspace layout. Use for explicit multi-step automation execution. |

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.47. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.48. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.47`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.48`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.48
 ```
 
 For requests about the current workspace or thread, resolve context first:

package/skills/realtimex-secrets/SKILL.md

@@ -15,16 +15,16 @@ Manage encrypted Login, Card, Identity, SSH key and Secure note items, tags and
 
 ## CLI setup
 
-This skill uses `realtimex-pp-cli` version 2.0.47. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.48. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.47`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.48`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.48
 ```
 
 For requests about the current workspace or thread, resolve context first:

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.47. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.48. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.47`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.48`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.48
 ```
 
 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.47. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.48. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.47`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.48`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.48
 ```
 
 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.47. Before using its commands:
+This skill uses `realtimex-pp-cli` version 2.0.48. Before using its commands:
 
 ```bash
 realtimex-pp-cli --version
 ```
 
-If it is missing or does not report `realtimex-pp-cli 2.0.47`, install the pinned version:
+If it is missing or does not report `realtimex-pp-cli 2.0.48`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.48
 ```
 
 For requests about the current workspace or thread, resolve context first: