@realtimex/sdk 1.7.9 → 1.7.10

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@realtimex/sdk",
-    "version": "1.7.9",
+    "version": "1.7.10",
     "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.10
 ---
 
 # 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.10**. Authentication is automatic when running inside RealtimeX.
 
 `<SKILL_DIR>` below refers to the directory containing this SKILL.md.
 
@@ -39,13 +39,19 @@ 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.
+
 ---
 
 ## Desktop Terminal Sessions
@@ -96,6 +102,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.10** · 2026-05-07
 
 **Package:** `@realtimex/sdk` (CJS) · **Server:** `http://localhost:3001`
 **Developer Mode auth:** `Authorization: Bearer <apiKey>`
@@ -41,6 +41,7 @@ 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.
 
 ### `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.10** · 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,6 +53,21 @@ 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
 // ---------------------------------------------------------------------------
@@ -89,9 +104,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 +337,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 +349,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 +369,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;