@realtimex/sdk 1.7.9 → 1.7.11

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "1.7.9",
+    "version": "1.7.11",
     "description": "SDK for building Local Apps that integrate with RealtimeX",
     "main": "dist/index.js",
     "module": "dist/index.mjs",

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

@@ -1,13 +1,13 @@
 ---
 name: realtimex-moderator-sdk
 description: Control and interact with the RealTimeX application through its Node.js SDK. This skill should be used when users want to manage workspaces, threads, agents, activities, LLM chat, vector store, MCP tools, ACP agent sessions, TTS/STT, or any other RealTimeX platform feature via the API. All method signatures are verified against the SDK source code.
-generated: 2026-05-06
-sdk_version: 1.7.9
+generated: 2026-05-07
+sdk_version: 1.7.11
 ---
 
 # RealTimeX Moderator (SDK Source-Verified)
 
-Interact with the RealTimeX platform (`http://localhost:3001`) using `@realtimex/sdk` **v1.7.9**. Authentication is automatic when running inside RealtimeX.
+Interact with the RealTimeX platform (`http://localhost:3001`) using `@realtimex/sdk` **v1.7.11**. Authentication is automatic when running inside RealtimeX.
 
 `<SKILL_DIR>` below refers to the directory containing this SKILL.md.
 
@@ -20,6 +20,7 @@ SKILL=<SKILL_DIR>/scripts/rtx.js
 ENV=--env-dir=<cwd>
 
 node "$SKILL" ping                                     $ENV
+node "$SKILL" context                                 $ENV
 node "$SKILL" agents                                   $ENV
 node "$SKILL" workspaces                               $ENV
 node "$SKILL" threads <workspace-slug>                 $ENV
@@ -39,13 +40,34 @@ node "$SKILL" help
 
 ```js
 const { initSDK } = require('<SKILL_DIR>/scripts/lib/sdk-init');
-const { sdk } = await initSDK();
+const { sdk, context } = await initSDK();
 // All SDK APIs — see references/api-reference.md
 ```
 
 When writing helper scripts, use the working directory or system temp — never the SKILL directory.
 Scripts using the SDK must exit explicitly — `process.exit(0)` on success, `process.exit(1)` on error — or they hang on open HTTP sockets.
 
+When the skill runs inside a spawned ACP or desktop terminal session, RealtimeX injects:
+- `RTX_WORKSPACE_SLUG`
+- `RTX_THREAD_SLUG`
+
+The bundled `sdk-init` and `rtx.js` helpers use those env vars as default context for terminal actions and thread listing. Explicit arguments still win.
+
+## Workspace And Thread Rule
+
+When the skill is used and a task needs workspace/thread context:
+
+1. Check current context first.
+   Use `const { sdk, context } = await initSDK()` or `node "$SKILL" context`.
+2. If `context.workspaceSlug` or `context.threadSlug` exists, use it as the default.
+3. If the user explicitly provided workspace/thread, those values override the default context.
+4. If no current context is available:
+   - list workspaces first
+   - list threads for the chosen workspace if a thread is needed
+   - ask the user only when still ambiguous
+
+Do not guess a workspace or thread if the current context is unknown.
+
 ---
 
 ## Desktop Terminal Sessions
@@ -96,6 +118,11 @@ await sdk.desktopRuntimeSessions.launchTerminalCliAgent({
 });
 ```
 
+If `workspaceSlug` and `threadSlug` are omitted, prefer this order:
+- explicit user-provided values
+- `RTX_WORKSPACE_SLUG` / `RTX_THREAD_SLUG` from the current spawned process
+- list workspaces/threads and ask only if still ambiguous
+
 Important:
 - `agentName` is the agent label, like `"claude"` or `"gemini"`
 - `providerId` is the launcher/provider id, like `"claude-cli"` or `"gemini-cli"`

package/skills/realtimex-moderator-sdk/references/api-reference.md

@@ -1,6 +1,6 @@
 # RealTimeX SDK — API Reference
 
-> Auto-generated from `@realtimex/sdk` source · v**1.7.9** · 2026-05-06
+> Auto-generated from `@realtimex/sdk` source · v**1.7.11** · 2026-05-07
 
 **Package:** `@realtimex/sdk` (CJS) · **Server:** `http://localhost:3001`
 **Developer Mode auth:** `Authorization: Bearer <apiKey>`
@@ -41,6 +41,8 @@ Use this module for visible Electron terminal sessions. This is the correct path
 - closing a terminal session
 
 Do not use ACP for these unless the user explicitly asks for ACP/headless mode.
+If the current process was spawned by RealtimeX, prefer `process.env.RTX_WORKSPACE_SLUG` and `process.env.RTX_THREAD_SLUG` as default context before guessing or asking the user.
+Always resolve current workspace/thread context first when a terminal action needs it: explicit user input > spawned-process env > list workspaces/threads > ask user if still ambiguous.
 
 ### `V1DesktopRuntimeSessionsModule`
 

package/skills/realtimex-moderator-sdk/references/known-issues.md

@@ -1,6 +1,6 @@
 # Known Issues — Source-Detected
 
-> Auto-generated by `scripts/generate-skill.mjs` · SDK **1.7.9** · 2026-05-06
+> Auto-generated by `scripts/generate-skill.mjs` · SDK **1.7.11** · 2026-05-07
 
 Run `node scripts/generate-skill.mjs --force` after SDK source changes to refresh.
 

package/skills/realtimex-moderator-sdk/scripts/lib/sdk-init.js

@@ -23,11 +23,17 @@ const ALL_PERMISSIONS = [
   'llm.chat', 'llm.embed', 'llm.providers',
   'vectors.read', 'vectors.write',
   'tts.generate', 'mcp.servers', 'mcp.tools', 'acp.agent',
+  'desktop.runtime-sessions',
 ];
 
 /** Well-known file written by RealtimeX server for seamless auth. */
 const SDK_APP_ID_FILE = path.join(os.homedir(), '.realtimex.ai', '.sdk-app-id');
 
+function normalizeContextValue(value) {
+  const normalized = String(value || '').trim();
+  return normalized || null;
+}
+
 function parseEnvFile(filePath) {
   const vars = {};
   if (!fs.existsSync(filePath)) return vars;
@@ -86,9 +92,24 @@ async function resolveCredentials({ envDir, apiKey, appId } = {}) {
   return { apiKey: null, appId: null };
 }
 
+function resolveDefaultWorkspaceThreadContext(overrides = {}) {
+  const workspaceSlug =
+    normalizeContextValue(overrides.workspaceSlug) ||
+    normalizeContextValue(process.env.RTX_WORKSPACE_SLUG);
+  const threadSlug =
+    normalizeContextValue(overrides.threadSlug) ||
+    normalizeContextValue(process.env.RTX_THREAD_SLUG);
+
+  return {
+    workspaceSlug,
+    threadSlug,
+  };
+}
+
 async function initSDK(opts = {}) {
   const { RealtimeXSDK } = require('@realtimex/sdk');
   const { apiKey, appId } = await resolveCredentials(opts);
+  const context = resolveDefaultWorkspaceThreadContext(opts);
 
   if (!apiKey && !appId) {
     throw new Error(
@@ -105,7 +126,14 @@ async function initSDK(opts = {}) {
     permissions: opts.permissions || ALL_PERMISSIONS,
   });
 
-  return { sdk, apiKey: apiKey || null, appId: appId || null };
+  return { sdk, apiKey: apiKey || null, appId: appId || null, context };
 }
 
-module.exports = { initSDK, resolveCredentials, parseEnvFile, ALL_PERMISSIONS, SDK_APP_ID_FILE };
+module.exports = {
+  initSDK,
+  resolveCredentials,
+  resolveDefaultWorkspaceThreadContext,
+  parseEnvFile,
+  ALL_PERMISSIONS,
+  SDK_APP_ID_FILE,
+};

package/skills/realtimex-moderator-sdk/scripts/rtx.js

@@ -53,11 +53,35 @@ async function getSDK() {
   return _sdk;
 }
 
+function applyWorkspaceThreadDefaults(body = {}, context = {}) {
+  const nextBody = { ...body };
+  if (!nextBody.workspaceSlug && context?.workspaceSlug) {
+    nextBody.workspaceSlug = context.workspaceSlug;
+  }
+  if (!nextBody.threadSlug && context?.threadSlug) {
+    nextBody.threadSlug = context.threadSlug;
+  }
+  return nextBody;
+}
+
+function resolveWorkspaceFlagOrContext(context = {}) {
+  return flags.workspace || context?.workspaceSlug || null;
+}
+
 // ---------------------------------------------------------------------------
 // Commands
 // ---------------------------------------------------------------------------
 const CMD = {};
 
+CMD.context = async () => {
+  const { context } = await getSDK();
+  print({
+    workspaceSlug: context?.workspaceSlug || null,
+    threadSlug: context?.threadSlug || null,
+    hasContext: Boolean(context?.workspaceSlug || context?.threadSlug),
+  });
+};
+
 // -- ping -------------------------------------------------------------------
 // Source: index.ts → sdk.ping() → { success, mode, appId, timestamp }
 CMD.ping = async () => { const { sdk } = await getSDK(); print(await sdk.ping()); };
@@ -89,9 +113,10 @@ CMD.workspaces = async () => {
 // -- threads ----------------------------------------------------------------
 // Source: ApiModule.getThreads(workspaceSlug) → Thread[] { id, slug, name }
 CMD.threads = async () => {
-  const [slug] = cmdArgs;
+  const [slugArg] = cmdArgs;
+  const { sdk, context } = await getSDK();
+  const slug = slugArg || resolveWorkspaceFlagOrContext(context);
   if (!slug) { console.error('Usage: rtx.js threads <workspace-slug>'); process.exit(1); }
-  const { sdk } = await getSDK();
   printTable(await sdk.api.getThreads(slug), ['id', 'slug', 'name']);
 };
 
@@ -321,9 +346,9 @@ function getDesktopRuntimeSessionsModule(sdk) {
 
 // -- terminal-launcher / terminal sessions ----------------------------------
 CMD['terminal-open-launcher'] = async () => {
-  const { sdk } = await getSDK();
+  const { sdk, context } = await getSDK();
   const terminal = getDesktopRuntimeSessionsModule(sdk);
-  const body = {};
+  const body = applyWorkspaceThreadDefaults({}, context);
   if (flags.workspace) body.workspaceSlug = flags.workspace;
   if (flags.thread) body.threadSlug = flags.thread;
   if (flags.presentation) body.presentationMode = flags.presentation;
@@ -333,9 +358,9 @@ CMD['terminal-open-launcher'] = async () => {
 };
 
 CMD['terminal-launch-shell'] = async () => {
-  const { sdk } = await getSDK();
+  const { sdk, context } = await getSDK();
   const terminal = getDesktopRuntimeSessionsModule(sdk);
-  const body = {};
+  const body = applyWorkspaceThreadDefaults({}, context);
   if (flags.workspace) body.workspaceSlug = flags.workspace;
   if (flags.thread) body.threadSlug = flags.thread;
   if (flags.presentation) body.presentationMode = flags.presentation;
@@ -353,9 +378,9 @@ CMD['terminal-launch-cli-agent'] = async () => {
     console.error('Usage: rtx.js terminal-launch-cli-agent <agent-name> [<provider-id>] [<message>] [--workspace=<slug>] [--thread=<slug>] [--presentation=panel|tab] [--model=<id>]');
     process.exit(1);
   }
-  const { sdk } = await getSDK();
+  const { sdk, context } = await getSDK();
   const terminal = getDesktopRuntimeSessionsModule(sdk);
-  const body = { agentName };
+  const body = applyWorkspaceThreadDefaults({ agentName }, context);
   if (providerId) body.providerId = providerId;
   if (message) body.message = message;
   if (flags.workspace) body.workspaceSlug = flags.workspace;
@@ -876,6 +901,7 @@ Connection:
 
 sdk.api.*:
   agents / workspaces / threads <slug> / task <uuid>
+  context
 
 sdk.activities.*:
   activities [--status --limit --offset]