@realtimex/sdk 2.0.25 → 2.0.27

package/index.d.ts

@@ -101,6 +101,26 @@ export interface ConfigurePluginOptions extends RealtimeXRequestOptions {
   body?: ConfigurePluginBody;
 }
 
+export type CreateBrowserSessionParams = Record<string, never>;
+export type CreateBrowserSessionQuery = Record<string, never>;
+export type CreateBrowserSessionHeaders = {
+  "x-app-id"?: string;
+};
+export type CreateBrowserSessionBody = {
+  sessionName: string;
+  url?: string;
+  remoteDebugPort?: number;
+  guardrails?: Record<string, unknown>;
+  origin?: string;
+};
+export type CreateBrowserSessionResponse = Record<string, unknown>;
+export interface CreateBrowserSessionOptions extends RealtimeXRequestOptions {
+  params?: CreateBrowserSessionParams;
+  query?: CreateBrowserSessionQuery;
+  headers?: CreateBrowserSessionHeaders & Record<string, string>;
+  body?: CreateBrowserSessionBody;
+}
+
 export type CreateChannelParams = {
   workspaceSlug: string;
 };
@@ -186,6 +206,22 @@ export interface CreateWorkspaceAgentSkillOptions extends RealtimeXRequestOption
   body?: CreateWorkspaceAgentSkillBody;
 }
 
+export type DeleteBrowserSessionParams = {
+  sessionName: string;
+};
+export type DeleteBrowserSessionQuery = Record<string, never>;
+export type DeleteBrowserSessionHeaders = {
+  "x-app-id"?: string;
+};
+export type DeleteBrowserSessionBody = unknown;
+export type DeleteBrowserSessionResponse = Record<string, unknown>;
+export interface DeleteBrowserSessionOptions extends RealtimeXRequestOptions {
+  params?: DeleteBrowserSessionParams;
+  query?: DeleteBrowserSessionQuery;
+  headers?: DeleteBrowserSessionHeaders & Record<string, string>;
+  body?: DeleteBrowserSessionBody;
+}
+
 export type DeleteChannelParams = {
   channelId: string;
 };
@@ -335,6 +371,25 @@ export interface GetPluginOptions extends RealtimeXRequestOptions {
   body?: GetPluginBody;
 }
 
+export type GetTerminalSessionContextParams = {
+  sessionId: string;
+};
+export type GetTerminalSessionContextQuery = {
+  maxChars?: number;
+  afterSeq?: number;
+};
+export type GetTerminalSessionContextHeaders = {
+  "x-app-id"?: string;
+};
+export type GetTerminalSessionContextBody = unknown;
+export type GetTerminalSessionContextResponse = Record<string, unknown>;
+export interface GetTerminalSessionContextOptions extends RealtimeXRequestOptions {
+  params?: GetTerminalSessionContextParams;
+  query?: GetTerminalSessionContextQuery;
+  headers?: GetTerminalSessionContextHeaders & Record<string, string>;
+  body?: GetTerminalSessionContextBody;
+}
+
 export type GetThreadParams = {
   workspaceSlug: string;
   threadSlug: string;
@@ -415,6 +470,20 @@ export interface ListArtifactsOptions extends RealtimeXRequestOptions {
   body?: ListArtifactsBody;
 }
 
+export type ListBrowserSessionsParams = Record<string, never>;
+export type ListBrowserSessionsQuery = Record<string, never>;
+export type ListBrowserSessionsHeaders = {
+  "x-app-id"?: string;
+};
+export type ListBrowserSessionsBody = unknown;
+export type ListBrowserSessionsResponse = Record<string, unknown>;
+export interface ListBrowserSessionsOptions extends RealtimeXRequestOptions {
+  params?: ListBrowserSessionsParams;
+  query?: ListBrowserSessionsQuery;
+  headers?: ListBrowserSessionsHeaders & Record<string, string>;
+  body?: ListBrowserSessionsBody;
+}
+
 export type ListChannelsParams = Record<string, never>;
 export type ListChannelsQuery = Record<string, never>;
 export type ListChannelsHeaders = {
@@ -1171,6 +1240,24 @@ export interface SetWorkspaceDefaultAgentOptions extends RealtimeXRequestOptions
   body?: SetWorkspaceDefaultAgentBody;
 }
 
+export type StartBrowserSessionParams = {
+  sessionName: string;
+};
+export type StartBrowserSessionQuery = Record<string, never>;
+export type StartBrowserSessionHeaders = {
+  "x-app-id"?: string;
+};
+export type StartBrowserSessionBody = {
+  url?: string;
+};
+export type StartBrowserSessionResponse = Record<string, unknown>;
+export interface StartBrowserSessionOptions extends RealtimeXRequestOptions {
+  params?: StartBrowserSessionParams;
+  query?: StartBrowserSessionQuery;
+  headers?: StartBrowserSessionHeaders & Record<string, string>;
+  body?: StartBrowserSessionBody;
+}
+
 export type StartChannelParams = {
   channelId: string;
 };
@@ -1187,6 +1274,24 @@ export interface StartChannelOptions extends RealtimeXRequestOptions {
   body?: StartChannelBody;
 }
 
+export type StopBrowserSessionParams = {
+  sessionName: string;
+};
+export type StopBrowserSessionQuery = Record<string, never>;
+export type StopBrowserSessionHeaders = {
+  "x-app-id"?: string;
+};
+export type StopBrowserSessionBody = {
+  timeoutMs?: number;
+};
+export type StopBrowserSessionResponse = Record<string, unknown>;
+export interface StopBrowserSessionOptions extends RealtimeXRequestOptions {
+  params?: StopBrowserSessionParams;
+  query?: StopBrowserSessionQuery;
+  headers?: StopBrowserSessionHeaders & Record<string, string>;
+  body?: StopBrowserSessionBody;
+}
+
 export type StopChannelParams = {
   channelId: string;
 };
@@ -1353,6 +1458,9 @@ export declare class RealtimeXClient {
   /** Set non-secret configuration values for one installed plugin. Use a plugin id, name, or displayName from list-plugins. Password-type fields are refused and reported back for manual setup in the desktop settings UI. */
   configurePlugin(options?: ConfigurePluginOptions): Promise<ConfigurePluginResponse>;
   configurePlugin(pluginId: string, body: ConfigurePluginBody, options?: Omit<ConfigurePluginOptions, 'params' | 'body'>): Promise<ConfigurePluginResponse>;
+  /** Create an isolated named RealTimeX Browser session. When url is supplied, start the session 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. */
   createChannel(options?: CreateChannelOptions): Promise<CreateChannelResponse>;
   createChannel(workspaceSlug: string, body: CreateChannelBody, options?: Omit<CreateChannelOptions, 'params' | 'body'>): Promise<CreateChannelResponse>;
@@ -1365,6 +1473,9 @@ export declare class RealtimeXClient {
   /** Create a managed agent skill owned by one workspace. Terminal agents should use this instead of writing final skill content into runtime skill directories. */
   createWorkspaceAgentSkill(options?: CreateWorkspaceAgentSkillOptions): Promise<CreateWorkspaceAgentSkillResponse>;
   createWorkspaceAgentSkill(workspaceSlug: string, body: CreateWorkspaceAgentSkillBody, options?: Omit<CreateWorkspaceAgentSkillOptions, 'params' | 'body'>): Promise<CreateWorkspaceAgentSkillResponse>;
+  /** Delete a stopped named RealTimeX Browser session and its isolated profile. */
+  deleteBrowserSession(options?: DeleteBrowserSessionOptions): Promise<DeleteBrowserSessionResponse>;
+  deleteBrowserSession(sessionName: string, options?: Omit<DeleteBrowserSessionOptions, 'params'>): Promise<DeleteBrowserSessionResponse>;
   /** Delete one chat channel by exact channel id. */
   deleteChannel(options?: DeleteChannelOptions): Promise<DeleteChannelResponse>;
   deleteChannel(channelId: string, options?: Omit<DeleteChannelOptions, 'params'>): Promise<DeleteChannelResponse>;
@@ -1392,6 +1503,9 @@ export declare class RealtimeXClient {
   /** Get one installed plugin with its config schema (keys, labels, types, defaults) and current non-secret configuration values. Secret (password-type) values are never returned; secretConfigState reports whether each one is set. Use a plugin id, name, or displayName from list-plugins. */
   getPlugin(options?: GetPluginOptions): Promise<GetPluginResponse>;
   getPlugin(pluginId: string, options?: Omit<GetPluginOptions, 'params'>): Promise<GetPluginResponse>;
+  /** Read a bounded, sanitized tail of the PTY output for one exact live terminal runtime session. */
+  getTerminalSessionContext(options?: GetTerminalSessionContextOptions): Promise<GetTerminalSessionContextResponse>;
+  getTerminalSessionContext(sessionId: string, options?: Omit<GetTerminalSessionContextOptions, 'params'>): Promise<GetTerminalSessionContextResponse>;
   /** Get one thread by exact workspace slug and exact thread slug. */
   getThread(options?: GetThreadOptions): Promise<GetThreadResponse>;
   getThread(params: GetThreadParams, options?: Omit<GetThreadOptions, 'params'>): Promise<GetThreadResponse>;
@@ -1406,6 +1520,8 @@ 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 registered RealTimeX Browser sessions and their live runtime state. */
+  listBrowserSessions(options?: ListBrowserSessionsOptions): Promise<ListBrowserSessionsResponse>;
   /** List configured chat channels. Use returned channel ids with update-channel. */
   listChannels(options?: ListChannelsOptions): Promise<ListChannelsResponse>;
   /** List models for one provider id. Use an exact model id from this response when configuring workspace or thread LLM settings. */
@@ -1434,7 +1550,7 @@ 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>;
-  /** Return compact workspace, thread, current workspace/thread from explicit workspaceSlug and threadSlug query parameters, LLM provider, model, and CLI agent context for agents before choosing arguments. Agents should pass --workspace-slug "$RTX_WORKSPACE_SLUG" and --thread-slug "$RTX_THREAD_SLUG" when those environment variables exist. */
+  /** Return compact workspace, thread, current workspace/thread, LLM provider, model, and CLI agent context before choosing arguments. Managed RealtimeX terminal authentication supplies the current route automatically; workspaceSlug and threadSlug remain optional compatibility inputs for other callers. */
   prepare(options?: PrepareOptions): Promise<PrepareResponse>;
   prepare(query?: PrepareQuery, options?: Omit<PrepareOptions, 'query'>): Promise<PrepareResponse>;
   /** Promote one workspace-owned agent skill to a global managed skill by copying its files into a new global skill row. */
@@ -1515,9 +1631,15 @@ export declare class RealtimeXClient {
   /** Set the default CLI agent for a workspace. Use prepare first to find a valid agent canonical/providerId and optional modelId. */
   setWorkspaceDefaultAgent(options?: SetWorkspaceDefaultAgentOptions): Promise<SetWorkspaceDefaultAgentResponse>;
   setWorkspaceDefaultAgent(workspaceSlug: string, body: SetWorkspaceDefaultAgentBody, options?: Omit<SetWorkspaceDefaultAgentOptions, 'params' | 'body'>): Promise<SetWorkspaceDefaultAgentResponse>;
+  /** Start an existing named RealTimeX Browser session, optionally opening an absolute HTTP or HTTPS URL. */
+  startBrowserSession(options?: StartBrowserSessionOptions): Promise<StartBrowserSessionResponse>;
+  startBrowserSession(sessionName: string, body: StartBrowserSessionBody, options?: Omit<StartBrowserSessionOptions, 'params' | 'body'>): Promise<StartBrowserSessionResponse>;
   /** Start one chat channel by exact channel id. */
   startChannel(options?: StartChannelOptions): Promise<StartChannelResponse>;
   startChannel(channelId: string, options?: Omit<StartChannelOptions, 'params'>): Promise<StartChannelResponse>;
+  /** Gracefully stop an existing named RealTimeX Browser session. */
+  stopBrowserSession(options?: StopBrowserSessionOptions): Promise<StopBrowserSessionResponse>;
+  stopBrowserSession(sessionName: string, body: StopBrowserSessionBody, options?: Omit<StopBrowserSessionOptions, 'params' | 'body'>): Promise<StopBrowserSessionResponse>;
   /** Stop one chat channel by exact channel id. */
   stopChannel(options?: StopChannelOptions): Promise<StopChannelResponse>;
   stopChannel(channelId: string, options?: Omit<StopChannelOptions, 'params'>): Promise<StopChannelResponse>;

package/index.js

@@ -46,6 +46,16 @@ const operations = {
     ],
     "hasBody": true
   },
+  "createBrowserSession": {
+    "method": "POST",
+    "path": "/create-browser-session",
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": true
+  },
   "createChannel": {
     "method": "POST",
     "path": "/create-channel/{workspaceSlug}",
@@ -93,6 +103,18 @@ const operations = {
     ],
     "hasBody": true
   },
+  "deleteBrowserSession": {
+    "method": "DELETE",
+    "path": "/delete-browser-session/{sessionName}",
+    "pathParams": [
+      "sessionName"
+    ],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": false
+  },
   "deleteChannel": {
     "method": "DELETE",
     "path": "/delete-channel/{channelId}",
@@ -206,6 +228,21 @@ const operations = {
     ],
     "hasBody": false
   },
+  "getTerminalSessionContext": {
+    "method": "GET",
+    "path": "/get-terminal-session-context/{sessionId}",
+    "pathParams": [
+      "sessionId"
+    ],
+    "queryParams": [
+      "maxChars",
+      "afterSeq"
+    ],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": false
+  },
   "getThread": {
     "method": "GET",
     "path": "/get-thread/{workspaceSlug}/{threadSlug}",
@@ -263,6 +300,16 @@ const operations = {
     ],
     "hasBody": false
   },
+  "listBrowserSessions": {
+    "method": "GET",
+    "path": "/list-browser-sessions",
+    "pathParams": [],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": false
+  },
   "listChannels": {
     "method": "GET",
     "path": "/list-channels",
@@ -690,6 +737,18 @@ const operations = {
     ],
     "hasBody": true
   },
+  "startBrowserSession": {
+    "method": "POST",
+    "path": "/start-browser-session/{sessionName}",
+    "pathParams": [
+      "sessionName"
+    ],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": true
+  },
   "startChannel": {
     "method": "POST",
     "path": "/start-channel/{channelId}",
@@ -702,6 +761,18 @@ const operations = {
     ],
     "hasBody": false
   },
+  "stopBrowserSession": {
+    "method": "POST",
+    "path": "/stop-browser-session/{sessionName}",
+    "pathParams": [
+      "sessionName"
+    ],
+    "queryParams": [],
+    "headerParams": [
+      "x-app-id"
+    ],
+    "hasBody": true
+  },
   "stopChannel": {
     "method": "POST",
     "path": "/stop-channel/{channelId}",
@@ -1004,6 +1075,13 @@ class RealtimeXClient {
     );
   }
 
+  createBrowserSession(...args) {
+    return this.request(
+      "createBrowserSession",
+      normalizeOperationOptions(operations["createBrowserSession"], args)
+    );
+  }
+
   createChannel(...args) {
     return this.request(
       "createChannel",
@@ -1032,6 +1110,13 @@ class RealtimeXClient {
     );
   }
 
+  deleteBrowserSession(...args) {
+    return this.request(
+      "deleteBrowserSession",
+      normalizeOperationOptions(operations["deleteBrowserSession"], args)
+    );
+  }
+
   deleteChannel(...args) {
     return this.request(
       "deleteChannel",
@@ -1095,6 +1180,13 @@ class RealtimeXClient {
     );
   }
 
+  getTerminalSessionContext(...args) {
+    return this.request(
+      "getTerminalSessionContext",
+      normalizeOperationOptions(operations["getTerminalSessionContext"], args)
+    );
+  }
+
   getThread(...args) {
     return this.request(
       "getThread",
@@ -1130,6 +1222,13 @@ class RealtimeXClient {
     );
   }
 
+  listBrowserSessions(...args) {
+    return this.request(
+      "listBrowserSessions",
+      normalizeOperationOptions(operations["listBrowserSessions"], args)
+    );
+  }
+
   listChannels(...args) {
     return this.request(
       "listChannels",
@@ -1396,6 +1495,13 @@ class RealtimeXClient {
     );
   }
 
+  startBrowserSession(...args) {
+    return this.request(
+      "startBrowserSession",
+      normalizeOperationOptions(operations["startBrowserSession"], args)
+    );
+  }
+
   startChannel(...args) {
     return this.request(
       "startChannel",
@@ -1403,6 +1509,13 @@ class RealtimeXClient {
     );
   }
 
+  stopBrowserSession(...args) {
+    return this.request(
+      "stopBrowserSession",
+      normalizeOperationOptions(operations["stopBrowserSession"], args)
+    );
+  }
+
   stopChannel(...args) {
     return this.request(
       "stopChannel",
@@ -1463,5 +1576,5 @@ module.exports = {
   createClient: createRealtimeXClient,
   createRealtimeXClient,
   operations,
-  version: "2.0.25",
+  version: "2.0.27",
 };

package/package.json

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

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

@@ -20,20 +20,20 @@ This skill drives the `realtimex-pp-cli` binary. Verify the CLI is installed and
 
 1. Install or reinstall the pinned version via npm:
    ```bash
-   npm install -g @realtimex/pp-cli@2.0.25
+   npm install -g @realtimex/pp-cli@2.0.27
    ```
 2. Verify the exact version:
    ```bash
    realtimex-pp-cli --version
    ```
-   The output must be `realtimex-pp-cli 2.0.25`.
+   The output must be `realtimex-pp-cli 2.0.27`.
 
-If `--version` reports "command not found" after install, the npm global bin directory is not on `$PATH`. If it reports any version other than `2.0.25`, reinstall with the pinned npm command above. Do not proceed with skill commands until exact-version verification succeeds.
+If `--version` reports "command not found" after install, the npm global bin directory is not on `$PATH`. If it reports any version other than `2.0.27`, reinstall with the pinned npm command above. Do not proceed with skill commands until exact-version verification succeeds.
 
 * Always run first:
 
   ```bash
-  realtimex-pp-cli prepare --workspace-slug "$RTX_WORKSPACE_SLUG" --thread-slug "$RTX_THREAD_SLUG" --agent
+  realtimex-pp-cli prepare --agent
   ```
 
 ## Command Reference
@@ -54,6 +54,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli configure-plugin <pluginId>` — Set non-secret configuration values for one installed plugin. Use a plugin id, name, or displayName from list-plugins.
 
+**create-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.
+
 **create-channel** — Manage create channel
 
 - `realtimex-pp-cli create-channel <workspaceSlug>` — Create a chat channel in one exact workspace. Defaults to Telegram when plugin_type, channelType, and type are omitted.
@@ -70,6 +74,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli create-workspace-agent-skill <workspaceSlug>` — Create a managed agent skill owned by one workspace.
 
+**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.
+
 **delete-channel** — Manage delete channel
 
 - `realtimex-pp-cli delete-channel <channelId>` — Delete one chat channel by exact channel id.
@@ -106,6 +114,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli get-plugin <pluginId>` — Get one installed plugin with its config schema (keys, labels, types, defaults)
 
+**get-terminal-session-context** — Manage get terminal session context
+
+- `realtimex-pp-cli get-terminal-session-context <sessionId>` — Read a bounded, sanitized tail of the PTY output for one exact live terminal runtime session.
+
 **get-thread** — Manage get thread
 
 - `realtimex-pp-cli get-thread <workspaceSlug> <threadSlug>` — Get one thread by exact workspace slug and exact thread slug.
@@ -126,6 +138,10 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli list-artifacts <workspaceSlug>` — List public artifacts for one exact workspace slug. Revoked artifacts are hidden unless includeRevoked=true is passed.
 
+**list-browser-sessions** — Manage list browser sessions
+
+- `realtimex-pp-cli list-browser-sessions` — List registered RealTimeX Browser sessions and their live runtime state.
+
 **list-channels** — Manage list channels
 
 - `realtimex-pp-cli list-channels` — List configured chat channels. Use returned channel ids with update-channel.
@@ -172,7 +188,7 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 **prepare** — Manage prepare
 
-- `realtimex-pp-cli prepare` — Return compact workspace, thread, current workspace/thread from explicit workspaceSlug and threadSlug query parameters
+- `realtimex-pp-cli prepare` — Return compact workspace, thread, current workspace/thread, LLM provider, model
 
 **promote-workspace-agent-skill** — Manage promote workspace agent skill
 
@@ -274,10 +290,18 @@ If `--version` reports "command not found" after install, the npm global bin dir
 
 - `realtimex-pp-cli setup-working-dir` — Add or edit an agent working directory from the desktop settings UI.
 
+**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.
+
 **start-channel** — Manage start channel
 
 - `realtimex-pp-cli start-channel <channelId>` — Start one chat channel by exact channel id.
 
+**stop-browser-session** — Manage stop browser session
+
+- `realtimex-pp-cli stop-browser-session <sessionName>` — Gracefully stop an existing named RealTimeX Browser session.
+
 **stop-channel** — Manage stop channel
 
 - `realtimex-pp-cli stop-channel <channelId>` — Stop one chat channel by exact channel id.
@@ -432,9 +456,9 @@ Verify: `claude mcp list`
    ```bash
    realtimex-pp-cli --version
    ```
-   If the command is missing or the output is not exactly `realtimex-pp-cli 2.0.25`, reinstall the pinned version:
+   If the command is missing or the output is not exactly `realtimex-pp-cli 2.0.27`, reinstall the pinned version:
    ```bash
-   npm install -g @realtimex/pp-cli@2.0.25
+   npm install -g @realtimex/pp-cli@2.0.27
    ```
    Then run `realtimex-pp-cli --version` again and proceed only after exact-version verification succeeds.
 2. Match the user query to the best command from the Unique Capabilities and Command Reference above.
@@ -452,19 +476,21 @@ This skill intentionally exposes a small action-first command set. Prefer these
 * Never call the RealTimeX API directly with `curl`, `fetch`, raw HTTP clients, or custom scripts.
 * If the current CLI cannot do the requested task, say the feature is not available and will be added soon.
 * Use `--agent` on every command.
-* Treat `$RTX_WORKSPACE_SLUG` as the current workspace slug when it is set, and `$RTX_THREAD_SLUG` as the current thread slug when it is set.
-* For requests that refer to "current workspace", "this workspace", "current thread", or "this thread", use those environment values directly when they are available.
-* When you need the resolved current workspace/thread objects or related context, call:
+* In a managed RealtimeX terminal, let `prepare` resolve the current workspace and thread from authenticated terminal-session context. Do not require or forward workspace/thread environment variables to `prepare`.
+* Treat `prepare` as the resolved source of truth for requests that refer to "current workspace", "this workspace", "current thread", or "this thread".
+* `RTX_AGENT_CONTEXT_JSON` and the legacy `$RTX_WORKSPACE_SLUG` and `$RTX_THREAD_SLUG` aliases may be present for runtime compatibility, but do not block on inspecting them or manually pass them to `prepare`.
+* Call the following whenever you need the resolved current workspace/thread objects or related context:
 
   ```bash
-  realtimex-pp-cli prepare --workspace-slug "$RTX_WORKSPACE_SLUG" --thread-slug "$RTX_THREAD_SLUG" --agent
+  realtimex-pp-cli prepare --agent
   ```
 
-* If `$RTX_WORKSPACE_SLUG` or `$RTX_THREAD_SLUG` is missing for a current-context request that requires it, ask for the missing workspace or thread before running the command.
+* For callers outside a managed RealtimeX terminal, `prepare` still accepts explicit `--workspace-slug` and `--thread-slug` compatibility inputs.
+* Ask for a missing workspace or thread only when `prepare` cannot resolve the required current context or when the user intends to target a different context.
 * Always run first:
 
   ```bash
-  realtimex-pp-cli prepare --workspace-slug "$RTX_WORKSPACE_SLUG" --thread-slug "$RTX_THREAD_SLUG" --agent
+  realtimex-pp-cli prepare --agent
   ```
 
 * Use exact workspace slugs, thread slugs, provider ids, model ids, agent `canonical`, and agent `modelId` values from `prepare`.
@@ -506,7 +532,7 @@ For terminal agents and terminal sessions:
 * Use `list-terminal-agents` when you only need available terminal agents. Use `prepare` when you also need workspace/thread/provider/model context.
 * Use `open-terminal-session` to open a new desktop terminal session for a terminal agent. It auto-attaches the CLI controller through the desktop runtime launch request.
 * Use exact `agentName`, `providerId`, and `modelId` values from `list-terminal-agents` or `prepare.agents`.
-* When opening a terminal session for the current thread, pass both `--workspace-slug "$RTX_WORKSPACE_SLUG"` and `--thread-slug "$RTX_THREAD_SLUG"`.
+* When opening a terminal session for the current thread, pass the exact current workspace and thread slugs returned by `prepare`.
 * Use `list-terminal-sessions` to inspect grouped terminal sessions by `workspaceSlug` and `threadSlug`. Each session includes compact identity fields and `attached` status.
 * Use `resume-terminal-session` or `resume-latest-terminal-session` to resume + attach an existing session. Use `terminate-terminal-session` to close + detach a session.
 
@@ -514,7 +540,7 @@ For agent skills:
 
 * Use `list-workspace-agent-skills` before enabling, disabling, or reloading workspace skills.
 * For `reload-agent-skills`, always pass a workspace slug.
-* If the user asks to reload skills for the current workspace, pass `--workspace-slug "$RTX_WORKSPACE_SLUG"`.
+* If the user asks to reload skills for the current workspace, pass the exact current workspace slug returned by `prepare`.
 * After `reload-agent-skills` succeeds, reload your own skill context before relying on updated skill instructions.
 
 For personality and heartbeat setup: