@realtimex/sdk 2.0.47 → 2.0.49

package/index.d.ts

@@ -99,6 +99,21 @@ export interface CalibrateDecisionBatteryOptions extends RealtimeXRequestOptions
   body?: CalibrateDecisionBatteryBody;
 }
 
+export type CancelBrowserWatchParams = Record<string, never>;
+export type CancelBrowserWatchQuery = Record<string, never>;
+export type CancelBrowserWatchHeaders = Record<string, never>;
+export type CancelBrowserWatchBody = {
+  key: string;
+  acknowledgeUnknown?: boolean;
+};
+export type CancelBrowserWatchResponse = unknown;
+export interface CancelBrowserWatchOptions extends RealtimeXRequestOptions {
+  params?: CancelBrowserWatchParams;
+  query?: CancelBrowserWatchQuery;
+  headers?: CancelBrowserWatchHeaders & Record<string, string>;
+  body?: CancelBrowserWatchBody;
+}
+
 export type CancelHumanQuestionParams = {
   requestId: string;
 };
@@ -270,7 +285,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 +359,7 @@ export type CreateChannelBody = {
   config?: Record<string, unknown>;
   settings?: {
   deliveryMode?: "agent" | "platform";
+  ownerMessages?: boolean;
 };
 };
 export type CreateChannelResponse = Record<string, unknown>;
@@ -439,6 +491,7 @@ export type CreateWorkspaceHeaders = {
 };
 export type CreateWorkspaceBody = {
   name: string;
+  isolationMode?: "none" | "client";
 };
 export type CreateWorkspaceResponse = Record<string, unknown>;
 export interface CreateWorkspaceOptions extends RealtimeXRequestOptions {
@@ -720,7 +773,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 +1206,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 +1259,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;
@@ -1145,6 +1304,23 @@ export interface ListBrowserSessionsOptions extends RealtimeXRequestOptions {
   body?: ListBrowserSessionsBody;
 }
 
+export type ListBrowserWatchesParams = Record<string, never>;
+export type ListBrowserWatchesQuery = {
+  key?: string;
+  includeResolved?: boolean;
+  limit?: number;
+  cursor?: string;
+};
+export type ListBrowserWatchesHeaders = Record<string, never>;
+export type ListBrowserWatchesBody = unknown;
+export type ListBrowserWatchesResponse = unknown;
+export interface ListBrowserWatchesOptions extends RealtimeXRequestOptions {
+  params?: ListBrowserWatchesParams;
+  query?: ListBrowserWatchesQuery;
+  headers?: ListBrowserWatchesHeaders & Record<string, string>;
+  body?: ListBrowserWatchesBody;
+}
+
 export type ListChannelsParams = Record<string, never>;
 export type ListChannelsQuery = Record<string, never>;
 export type ListChannelsHeaders = {
@@ -1568,6 +1744,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;
 };
@@ -2183,6 +2396,7 @@ export type SendChannelMessageBody = {
   text: string;
   context?: string;
   idempotencyKey?: string;
+  replyTo?: string;
 };
 export type SendChannelMessageResponse = Record<string, unknown>;
 export interface SendChannelMessageOptions extends RealtimeXRequestOptions {
@@ -2192,6 +2406,25 @@ export interface SendChannelMessageOptions extends RealtimeXRequestOptions {
   body?: SendChannelMessageBody;
 }
 
+export type SendChannelReactionParams = Record<string, never>;
+export type SendChannelReactionQuery = Record<string, never>;
+export type SendChannelReactionHeaders = {
+  "x-app-id"?: string;
+};
+export type SendChannelReactionBody = {
+  message: string;
+  emoji?: string;
+  remove?: boolean;
+  context?: string;
+};
+export type SendChannelReactionResponse = Record<string, unknown>;
+export interface SendChannelReactionOptions extends RealtimeXRequestOptions {
+  params?: SendChannelReactionParams;
+  query?: SendChannelReactionQuery;
+  headers?: SendChannelReactionHeaders & Record<string, string>;
+  body?: SendChannelReactionBody;
+}
+
 export type SendMessageParams = {
   workspaceSlug: string;
   threadSlug: string;
@@ -2246,6 +2479,42 @@ export interface SendTerminalSessionMessageOptions extends RealtimeXRequestOptio
   body?: SendTerminalSessionMessageBody;
 }
 
+export type SetBrowserWatchParams = Record<string, never>;
+export type SetBrowserWatchQuery = Record<string, never>;
+export type SetBrowserWatchHeaders = Record<string, never>;
+export type SetBrowserWatchBody = {
+  key: string;
+  session: string;
+  tabId: number;
+  kind: "dom" | "url";
+  condition: {
+  selector?: string;
+  text?: string;
+  caseInsensitive?: boolean;
+  when?: "appears" | "changes";
+  idAttr?: string;
+  urlPrefix?: string;
+  urlIncludes?: string;
+  urlEquals?: string;
+};
+  urlScope?: string;
+  until?: string;
+  for?: string;
+  maxFires?: number;
+  minGapSeconds?: number;
+  debounceMs?: number;
+  excerptChars?: number;
+  reason: string;
+  context?: Record<string, unknown>;
+};
+export type SetBrowserWatchResponse = unknown;
+export interface SetBrowserWatchOptions extends RealtimeXRequestOptions {
+  params?: SetBrowserWatchParams;
+  query?: SetBrowserWatchQuery;
+  headers?: SetBrowserWatchHeaders & Record<string, string>;
+  body?: SetBrowserWatchBody;
+}
+
 export type SetDefaultWorkspaceAgentParams = Record<string, never>;
 export type SetDefaultWorkspaceAgentQuery = Record<string, never>;
 export type SetDefaultWorkspaceAgentHeaders = Record<string, never>;
@@ -2599,7 +2868,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;
@@ -2623,6 +2928,25 @@ export interface StartChannelOptions extends RealtimeXRequestOptions {
   body?: StartChannelBody;
 }
 
+export type StartChannelChatParams = Record<string, never>;
+export type StartChannelChatQuery = Record<string, never>;
+export type StartChannelChatHeaders = {
+  "x-app-id"?: string;
+};
+export type StartChannelChatBody = {
+  channelId: number;
+  chatType: "group" | "dm";
+  chatName?: string;
+  chatId?: string;
+};
+export type StartChannelChatResponse = Record<string, unknown>;
+export interface StartChannelChatOptions extends RealtimeXRequestOptions {
+  params?: StartChannelChatParams;
+  query?: StartChannelChatQuery;
+  headers?: StartChannelChatHeaders & Record<string, string>;
+  body?: StartChannelChatBody;
+}
+
 export type StartLocalAppParams = {
   appId: string;
 };
@@ -2647,7 +2971,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 +3164,7 @@ export type UpdateChannelBody = {
   tts_enabled?: boolean;
   settings?: {
   deliveryMode?: "agent" | "platform";
+  ownerMessages?: boolean;
 };
 };
 export type UpdateChannelResponse = Record<string, unknown>;
@@ -3062,6 +3423,9 @@ export declare class RealtimeXClient {
   /** Fit per-model battery thresholds from labelled states or paired decision digests; report only unless write=true. */
   calibrateDecisionBattery(options?: CalibrateDecisionBatteryOptions): Promise<CalibrateDecisionBatteryResponse>;
   calibrateDecisionBattery(body: CalibrateDecisionBatteryBody, options?: Omit<CalibrateDecisionBatteryOptions, 'body'>): Promise<CalibrateDecisionBatteryResponse>;
+  /** Cancel a browser watch of the thread of the calling agent session by key: it ends and its endpoint turns off. Cancelling an already cancelled key succeeds. A fire that is being delivered cannot be retracted. A watch whose delivery is uncertain can only be released with acknowledgeUnknown after checking the thread. */
+  cancelBrowserWatch(options?: CancelBrowserWatchOptions): Promise<CancelBrowserWatchResponse>;
+  cancelBrowserWatch(body: CancelBrowserWatchBody, options?: Omit<CancelBrowserWatchOptions, 'body'>): Promise<CancelBrowserWatchResponse>;
   cancelHumanQuestion(options?: CancelHumanQuestionOptions): Promise<CancelHumanQuestionResponse>;
   cancelHumanQuestion(requestId: string, body: CancelHumanQuestionBody, options?: Omit<CancelHumanQuestionOptions, 'params' | 'body'>): Promise<CancelHumanQuestionResponse>;
   /** Cancel a scheduled wake-up of the thread of the calling agent session by key. Cancelling an already cancelled key succeeds. A wake that is being delivered cannot be retracted. A wake with uncertain delivery can only be released with acknowledgeUnknown after checking the thread. */
@@ -3084,7 +3448,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 +3476,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,10 +3570,16 @@ 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. */
   listBrowserSessions(options?: ListBrowserSessionsOptions): Promise<ListBrowserSessionsResponse>;
+  /** List the browser watches of the thread of the calling agent session, newest first: open ones, or all with includeResolved=true. Each shows its publicId and name on the Webhooks & Events page, its state (paused when the person paused it there), why it is suspended, coverage gaps and recent fires. Page excerpts are never listed. */
+  listBrowserWatches(options?: ListBrowserWatchesOptions): Promise<ListBrowserWatchesResponse>;
+  listBrowserWatches(query?: ListBrowserWatchesQuery, options?: Omit<ListBrowserWatchesOptions, 'query'>): Promise<ListBrowserWatchesResponse>;
   /** List configured chat channels. Use returned channel ids with update-channel. */
   listChannels(options?: ListChannelsOptions): Promise<ListChannelsResponse>;
   /** List host and workspace batteries with the fitted status for the active model; no model call. */
@@ -3270,6 +3640,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>;
@@ -3350,15 +3726,21 @@ export declare class RealtimeXClient {
   /** Send one local file to the external chat that this terminal is answering. Run it from the channel-linked terminal with --file-path <absolute path>: the target chat comes from your terminal session, so --context is optional. Send one file per command. Channels that cannot send files return an error. contentBase64 with fileName remains available when no local path exists. */
   sendChannelFile(options?: SendChannelFileOptions): Promise<SendChannelFileResponse>;
   sendChannelFile(body: SendChannelFileBody, options?: Omit<SendChannelFileOptions, 'body'>): Promise<SendChannelFileResponse>;
-  /** Post one message to the external chat (Zalo, Telegram, ...) that this terminal is answering. Run it from the channel-linked terminal: the target chat comes from your terminal session, so --context is optional. Pass multi-line text with a quoted heredoc: --text "$(cat <<"EOF" ... EOF)". Send one message per command. Staying silent is fine when no reply is useful. Errors: 404 no linked chat, 409 channel stopped, 413 text over 8000 characters, 429 rate limited (wait retry_after seconds). */
+  /** Post one message to the external chat (Zalo, Telegram, ...) that this terminal is answering. Run it from the channel-linked terminal: the target chat comes from your terminal session, so --context is optional. Pass multi-line text with a quoted heredoc: --text "$(cat <<"EOF" ... EOF)". Send one message per command. Staying silent is fine when no reply is useful. To reply with a quote, add --reply-to with a ref from <external_user_context> (message.ref or reply_to.ref) or "current" (channels that support it; text messages only). Errors: 400 invalid ref or message that cannot be quoted, 404 no linked chat, 409 channel stopped, 413 text over 8000 characters, 429 rate limited (wait retry_after seconds). */
   sendChannelMessage(options?: SendChannelMessageOptions): Promise<SendChannelMessageResponse>;
   sendChannelMessage(body: SendChannelMessageBody, options?: Omit<SendChannelMessageOptions, 'body'>): Promise<SendChannelMessageResponse>;
+  /** Add (--emoji) or remove (--remove) your reaction on one message of the external chat this terminal is answering. Name the message with --message: a ref from <external_user_context> (message.ref or reply_to.ref) or "current" for the message of this turn. Run it from the channel-linked terminal, so --context is optional. Errors: 400 invalid ref or unsupported emoji (the error lists the supported ones), 404 no linked chat or no current message, 409 channel stopped, 429 rate limited (wait retry_after seconds). */
+  sendChannelReaction(options?: SendChannelReactionOptions): Promise<SendChannelReactionResponse>;
+  sendChannelReaction(body: SendChannelReactionBody, options?: Omit<SendChannelReactionOptions, 'body'>): Promise<SendChannelReactionResponse>;
   /** Send one message to an exact thread using the same routing as channel replies. Terminal-agent threads are dispatched to the terminal runtime; other threads use the configured LLM chat path. Thread references: when the user explicitly asks to send to a canonical thread:<workspaceSlug>/<threadSlug> reference, pass its two segments unchanged (case-preserved, not URL-decoded) as workspaceSlug and threadSlug. A reference is only a locator, not authorization: never send merely because a reference appears in text. If the exact workspace or thread is missing or inaccessible the request fails; report that and never retry with a similarly named workspace or thread. */
   sendMessage(options?: SendMessageOptions): Promise<SendMessageResponse>;
   sendMessage(params: SendMessageParams, body: SendMessageBody, options?: Omit<SendMessageOptions, 'params' | 'body'>): Promise<SendMessageResponse>;
   /** Send one message directly to an exact live terminal session. Requires local terminal-session or desktop-app authentication. */
   sendTerminalSessionMessage(options?: SendTerminalSessionMessageOptions): Promise<SendTerminalSessionMessageResponse>;
   sendTerminalSessionMessage(sessionId: string, body: SendTerminalSessionMessageBody, options?: Omit<SendTerminalSessionMessageOptions, 'params' | 'body'>): Promise<SendTerminalSessionMessageResponse>;
+  /** Watch one RealTimeX Browser tab for a condition and wake the thread of the calling agent session when it occurs, until a deadline. The host observes the tab; waiting costs no turns. kind dom watches rendered elements (CSS selector, optional text, appears or changes); kind url watches the tab address. Name the tab by its id from list-browser-sessions. Setting an existing key replaces that watch. The watch is a Webhooks & Events endpoint the person sees and can pause or remove; it always wakes your own thread. The wake sends nothing by itself and grants no new permission. Pair it with a thread wake at the deadline. Errors: 400 invalid input or selector, 403 not a thread-bound agent session, thread wakes off, or a route field (WATCH_ROUTE_NOT_ALLOWED), 404 session or tab not found, 409 tab ambiguous or not observable, key busy or uncertain, or paused by the person, 429 limits, 503 desktop or browser unavailable. */
+  setBrowserWatch(options?: SetBrowserWatchOptions): Promise<SetBrowserWatchResponse>;
+  setBrowserWatch(body: SetBrowserWatchBody, options?: Omit<SetBrowserWatchOptions, 'body'>): Promise<SetBrowserWatchResponse>;
   /** Set a workspace default agent from the desktop workspace chat settings UI. */
   setDefaultWorkspaceAgent(options?: SetDefaultWorkspaceAgentOptions): Promise<SetDefaultWorkspaceAgentResponse>;
   setDefaultWorkspaceAgent(body: SetDefaultWorkspaceAgentBody, options?: Omit<SetDefaultWorkspaceAgentOptions, 'body'>): Promise<SetDefaultWorkspaceAgentResponse>;
@@ -3406,6 +3788,9 @@ export declare class RealtimeXClient {
   /** Start one chat channel by exact channel id. */
   startChannel(options?: StartChannelOptions): Promise<StartChannelResponse>;
   startChannel(channelId: string, options?: Omit<StartChannelOptions, 'params'>): Promise<StartChannelResponse>;
+  /** Start a Zalo Personal or WhatsApp chat before anyone writes in it, or get the thread it already has. Pass channelId, chatType (group or dm) and the chat\'s listed name as chatName (or chatId). Works only for a chat the channel\'s access settings already allow; it never approves anyone. A new chat gets its own thread, and that thread\'s agent is told the owner started the chat. Nothing is sent to the chat. Errors: 404 unknown chat name, 409 not allowed, ambiguous name or channel stopped, 403 workspace not reachable. */
+  startChannelChat(options?: StartChannelChatOptions): Promise<StartChannelChatResponse>;
+  startChannelChat(body: StartChannelChatBody, options?: Omit<StartChannelChatOptions, 'body'>): Promise<StartChannelChatResponse>;
   startLocalApp(options?: StartLocalAppOptions): Promise<StartLocalAppResponse>;
   startLocalApp(appId: string, body: StartLocalAppBody, options?: Omit<StartLocalAppOptions, 'params' | 'body'>): Promise<StartLocalAppResponse>;
   /** Gracefully stop an existing named RealTimeX Browser session. */

package/index.js

@@ -41,6 +41,14 @@ const operations = {
     ],
     "hasBody": true
   },
+  "cancelBrowserWatch": {
+    "method": "POST",
+    "path": "/cancel-browser-watch",
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [],
+    "hasBody": true
+  },
   "cancelHumanQuestion": {
     "method": "POST",
     "path": "/cancel-human-question/{requestId}",
@@ -609,6 +617,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",
@@ -629,6 +649,19 @@ const operations = {
     ],
     "hasBody": false
   },
+  "listBrowserWatches": {
+    "method": "GET",
+    "path": "/list-browser-watches",
+    "pathParams": [],
+    "queryParams": [
+      "key",
+      "includeResolved",
+      "limit",
+      "cursor"
+    ],
+    "headerParams": [],
+    "hasBody": false
+  },
   "listChannels": {
     "method": "GET",
     "path": "/list-channels",
@@ -881,6 +914,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",
@@ -1247,6 +1296,16 @@ const operations = {
     ],
     "hasBody": true
   },
+  "sendChannelReaction": {
+    "method": "POST",
+    "path": "/send-channel-reaction",
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": true
+  },
   "sendMessage": {
     "method": "POST",
     "path": "/send-message/{workspaceSlug}/{threadSlug}",
@@ -1272,6 +1331,14 @@ const operations = {
     ],
     "hasBody": true
   },
+  "setBrowserWatch": {
+    "method": "POST",
+    "path": "/set-browser-watch",
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [],
+    "hasBody": true
+  },
   "setDefaultWorkspaceAgent": {
     "method": "POST",
     "path": "/set-default-workspace-agent",
@@ -1441,6 +1508,16 @@ const operations = {
     ],
     "hasBody": false
   },
+  "startChannelChat": {
+    "method": "POST",
+    "path": "/start-channel-chat",
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": true
+  },
   "startLocalApp": {
     "method": "POST",
     "path": "/start-local-app/{appId}",
@@ -2070,6 +2147,13 @@ class RealtimeXClient {
     );
   }
 
+  cancelBrowserWatch(...args) {
+    return this.request(
+      "cancelBrowserWatch",
+      normalizeOperationOptions(operations["cancelBrowserWatch"], args)
+    );
+  }
+
   cancelHumanQuestion(...args) {
     return this.request(
       "cancelHumanQuestion",
@@ -2441,6 +2525,13 @@ class RealtimeXClient {
     );
   }
 
+  listBrowserDownloads(...args) {
+    return this.request(
+      "listBrowserDownloads",
+      normalizeOperationOptions(operations["listBrowserDownloads"], args)
+    );
+  }
+
   listBrowserProfiles(...args) {
     return this.request(
       "listBrowserProfiles",
@@ -2455,6 +2546,13 @@ class RealtimeXClient {
     );
   }
 
+  listBrowserWatches(...args) {
+    return this.request(
+      "listBrowserWatches",
+      normalizeOperationOptions(operations["listBrowserWatches"], args)
+    );
+  }
+
   listChannels(...args) {
     return this.request(
       "listChannels",
@@ -2623,6 +2721,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",
@@ -2854,6 +2966,13 @@ class RealtimeXClient {
     );
   }
 
+  sendChannelReaction(...args) {
+    return this.request(
+      "sendChannelReaction",
+      normalizeOperationOptions(operations["sendChannelReaction"], args)
+    );
+  }
+
   sendMessage(...args) {
     return this.request(
       "sendMessage",
@@ -2868,6 +2987,13 @@ class RealtimeXClient {
     );
   }
 
+  setBrowserWatch(...args) {
+    return this.request(
+      "setBrowserWatch",
+      normalizeOperationOptions(operations["setBrowserWatch"], args)
+    );
+  }
+
   setDefaultWorkspaceAgent(...args) {
     return this.request(
       "setDefaultWorkspaceAgent",
@@ -2980,6 +3106,13 @@ class RealtimeXClient {
     );
   }
 
+  startChannelChat(...args) {
+    return this.request(
+      "startChannelChat",
+      normalizeOperationOptions(operations["startChannelChat"], args)
+    );
+  }
+
   startLocalApp(...args) {
     return this.request(
       "startLocalApp",
@@ -3117,5 +3250,5 @@ module.exports = {
   createRealtimeXClient,
   createRealtimeXWebhookClient,
   operations,
-  version: "2.0.47",
+  version: "2.0.49",
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "2.0.47",
+    "version": "2.0.49",
     "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.49. 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.49`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.49
 ```
 
 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.49. 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.49`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.49
 ```
 
 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.49. 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.49`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.49
 ```
 
 For requests about the current workspace or thread, resolve context first:
@@ -35,18 +35,26 @@ realtimex-pp-cli prepare --agent
 
 ## Command reference
 
+**cancel-browser-watch** — Manage cancel browser watch
+
+- `realtimex-pp-cli cancel-browser-watch` — Cancel a browser watch of the thread of the calling agent session by key: it ends and its endpoint turns off.
+
 **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
@@ -55,6 +63,14 @@ realtimex-pp-cli prepare --agent
 
 - `realtimex-pp-cli list-browser-sessions` — List registered RealTimeX Browser sessions and their live runtime state.
 
+**list-browser-watches** — Manage list browser watches
+
+- `realtimex-pp-cli list-browser-watches` — List the browser watches of the thread of the calling agent session, newest first: open ones
+
+**set-browser-watch** — Manage set browser watch
+
+- `realtimex-pp-cli set-browser-watch` — Watch one RealTimeX Browser tab for a condition and wake the thread of the calling agent session when it occurs
+
 **start-browser-session** — Manage start browser session
 
 - `realtimex-pp-cli start-browser-session <sessionName>` — Start an existing named RealTimeX Browser session, optionally opening an absolute HTTP or HTTPS URL.
@@ -66,10 +82,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.49. 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.49`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.49
 ```
 
 For requests about the current workspace or thread, resolve context first:
@@ -75,10 +75,18 @@ realtimex-pp-cli prepare --agent
 
 - `realtimex-pp-cli send-channel-message` — Post one message to the external chat (Zalo, Telegram, ...) that this terminal is answering.
 
+**send-channel-reaction** — Manage send channel reaction
+
+- `realtimex-pp-cli send-channel-reaction` — Add (--emoji) or remove (--remove) your reaction on one message of the external chat this terminal is answering.
+
 **start-channel** — Manage start channel
 
 - `realtimex-pp-cli start-channel <channelId>` — Start one chat channel by exact channel id.
 
+**start-channel-chat** — Manage start channel chat
+
+- `realtimex-pp-cli start-channel-chat` — Start a Zalo Personal or WhatsApp chat before anyone writes in it, or get the thread it already has.
+
 **stop-channel** — Manage stop channel
 
 - `realtimex-pp-cli stop-channel <channelId>` — Stop one chat channel by exact channel id.

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.49. 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.49`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.49
 ```
 
 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.49. 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.49`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.49
 ```
 
 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.49. 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.49`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.49
 ```
 
 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.49. 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.49`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.49
 ```
 
 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.49. 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.49`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.49
 ```
 
 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.49. 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.49`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.49
 ```
 
 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.49. 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.49`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.49
 ```
 
 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.49. 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.49`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.49
 ```
 
 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.49. 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.49`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.49
 ```
 
 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.49. 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.49`, install the pinned version:
 
 ```bash
-npm install -g @realtimex/pp-cli@2.0.47
+npm install -g @realtimex/pp-cli@2.0.49
 ```
 
 For requests about the current workspace or thread, resolve context first: