@realtimex/sdk 1.7.28 → 2.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/dist/chunk-DZUAP6FW.mjs +598 -0
  2. package/dist/errors-DwEt8WYf.d.mts +399 -0
  3. package/dist/errors-DwEt8WYf.d.ts +399 -0
  4. package/dist/index.d.mts +8 -2048
  5. package/dist/index.d.ts +8 -2048
  6. package/dist/index.js +308 -4537
  7. package/dist/index.mjs +7 -3783
  8. package/dist/v1/index.d.mts +3 -56
  9. package/dist/v1/index.d.ts +3 -56
  10. package/dist/v1/index.js +255 -681
  11. package/dist/v1/index.mjs +4 -42
  12. package/package.json +6 -7
  13. package/dist/chunk-Z5GAUBIM.mjs +0 -993
  14. package/dist/errors-NufsyIZ-.d.mts +0 -678
  15. package/dist/errors-NufsyIZ-.d.ts +0 -678
  16. package/skills/realtimex-moderator-sdk/SKILL.md +0 -102
  17. package/skills/realtimex-moderator-sdk/references/activities.md +0 -14
  18. package/skills/realtimex-moderator-sdk/references/agents.md +0 -13
  19. package/skills/realtimex-moderator-sdk/references/api-reference/acpagent.md +0 -105
  20. package/skills/realtimex-moderator-sdk/references/api-reference/activities.md +0 -24
  21. package/skills/realtimex-moderator-sdk/references/api-reference/agent.md +0 -27
  22. package/skills/realtimex-moderator-sdk/references/api-reference/api.md +0 -17
  23. package/skills/realtimex-moderator-sdk/references/api-reference/auth.md +0 -36
  24. package/skills/realtimex-moderator-sdk/references/api-reference/contract.md +0 -27
  25. package/skills/realtimex-moderator-sdk/references/api-reference/core.md +0 -40
  26. package/skills/realtimex-moderator-sdk/references/api-reference/database.md +0 -24
  27. package/skills/realtimex-moderator-sdk/references/api-reference/index.md +0 -43
  28. package/skills/realtimex-moderator-sdk/references/api-reference/llm.md +0 -176
  29. package/skills/realtimex-moderator-sdk/references/api-reference/mcp.md +0 -50
  30. package/skills/realtimex-moderator-sdk/references/api-reference/port.md +0 -21
  31. package/skills/realtimex-moderator-sdk/references/api-reference/stt.md +0 -15
  32. package/skills/realtimex-moderator-sdk/references/api-reference/task.md +0 -62
  33. package/skills/realtimex-moderator-sdk/references/api-reference/tts.md +0 -18
  34. package/skills/realtimex-moderator-sdk/references/api-reference/v1-acpauth.md +0 -21
  35. package/skills/realtimex-moderator-sdk/references/api-reference/v1-acpcommands.md +0 -15
  36. package/skills/realtimex-moderator-sdk/references/api-reference/v1-admin.md +0 -48
  37. package/skills/realtimex-moderator-sdk/references/api-reference/v1-auth.md +0 -18
  38. package/skills/realtimex-moderator-sdk/references/api-reference/v1-channels.md +0 -78
  39. package/skills/realtimex-moderator-sdk/references/api-reference/v1-credentials.md +0 -27
  40. package/skills/realtimex-moderator-sdk/references/api-reference/v1-customthemes.md +0 -24
  41. package/skills/realtimex-moderator-sdk/references/api-reference/v1-desktopbrowser.md +0 -39
  42. package/skills/realtimex-moderator-sdk/references/api-reference/v1-desktopembed.md +0 -24
  43. package/skills/realtimex-moderator-sdk/references/api-reference/v1-desktopruntimesessions.md +0 -33
  44. package/skills/realtimex-moderator-sdk/references/api-reference/v1-document.md +0 -39
  45. package/skills/realtimex-moderator-sdk/references/api-reference/v1-embed.md +0 -27
  46. package/skills/realtimex-moderator-sdk/references/api-reference/v1-openai.md +0 -21
  47. package/skills/realtimex-moderator-sdk/references/api-reference/v1-sttapi.md +0 -12
  48. package/skills/realtimex-moderator-sdk/references/api-reference/v1-system.md +0 -36
  49. package/skills/realtimex-moderator-sdk/references/api-reference/v1-thread.md +0 -26
  50. package/skills/realtimex-moderator-sdk/references/api-reference/v1-users.md +0 -15
  51. package/skills/realtimex-moderator-sdk/references/api-reference/v1-workspace.md +0 -39
  52. package/skills/realtimex-moderator-sdk/references/api-reference/webhook.md +0 -13
  53. package/skills/realtimex-moderator-sdk/references/api-reference.md +0 -1330
  54. package/skills/realtimex-moderator-sdk/references/app-concepts.md +0 -1276
  55. package/skills/realtimex-moderator-sdk/references/browser.md +0 -27
  56. package/skills/realtimex-moderator-sdk/references/channels.md +0 -189
  57. package/skills/realtimex-moderator-sdk/references/credentials.md +0 -111
  58. package/skills/realtimex-moderator-sdk/references/known-issues.md +0 -237
  59. package/skills/realtimex-moderator-sdk/references/llm.md +0 -13
  60. package/skills/realtimex-moderator-sdk/references/mcp.md +0 -13
  61. package/skills/realtimex-moderator-sdk/references/permissions.md +0 -30
  62. package/skills/realtimex-moderator-sdk/references/quickstart.md +0 -16
  63. package/skills/realtimex-moderator-sdk/references/terminal-sessions.md +0 -34
  64. package/skills/realtimex-moderator-sdk/references/workspaces.md +0 -20
  65. package/skills/realtimex-moderator-sdk/scripts/lib/sdk-init.js +0 -171
  66. package/skills/realtimex-moderator-sdk/scripts/rtx.js +0 -1359
@@ -1,171 +0,0 @@
1
- 'use strict';
2
- /**
3
- * sdk-init.js — SDK initializer
4
- * AUTO-GENERATED by scripts/generate-skill.mjs — do not edit by hand.
5
- *
6
- * Credential resolution:
7
- * 1. Explicit override passed to initSDK({ apiKey } or { appId })
8
- * 2. ~/.realtimex.ai/.sdk-app-id file (written by RealtimeX server)
9
- * 3. RTX_APP_ID in process.env (injected by RealtimeX for local apps)
10
- * 4. RTX_API_KEY in process.env (standalone dev)
11
- * 5. RTX_API_KEY in <envDir>/.env (standalone dev)
12
- * 6. Interactive readline prompt (fallback)
13
- */
14
-
15
- const path = require('path');
16
- const fs = require('fs');
17
- const os = require('os');
18
- const readline = require('readline');
19
- const { createRequire } = require('module');
20
-
21
- const ALL_PERMISSIONS = [
22
- 'api.agents', 'api.workspaces', 'api.threads', 'api.task',
23
- 'webhook.trigger', 'activities.read', 'activities.write',
24
- 'llm.chat', 'llm.embed', 'llm.providers',
25
- 'vectors.read', 'vectors.write',
26
- 'tts.generate', 'mcp.servers', 'mcp.tools', 'acp.agent',
27
- 'desktop.runtime-sessions',
28
- 'desktop.browser',
29
- ];
30
-
31
- /** Well-known file written by RealtimeX server for seamless auth. */
32
- const SDK_APP_ID_FILE = path.join(os.homedir(), '.realtimex.ai', '.sdk-app-id');
33
-
34
- function requireRealtimeXSDK() {
35
- try {
36
- return require('@realtimex/sdk');
37
- } catch (err) {
38
- if (err?.code !== 'MODULE_NOT_FOUND') throw err;
39
- }
40
-
41
- const moduleRoots = [
42
- process.env.RTX_SDK_MODULE_ROOT,
43
- process.env.RTX_SERVER_ROOT,
44
- path.join(os.homedir(), '.realtimex.ai', 'Resources', 'server'),
45
- ].filter(Boolean);
46
-
47
- for (const root of moduleRoots) {
48
- const packagePath = path.join(root, 'package.json');
49
- if (!fs.existsSync(packagePath)) continue;
50
-
51
- try {
52
- return createRequire(packagePath)('@realtimex/sdk');
53
- } catch (err) {
54
- if (err?.code !== 'MODULE_NOT_FOUND') throw err;
55
- }
56
- }
57
-
58
- throw new Error(
59
- 'Cannot find @realtimex/sdk. Install it with this skill, set RTX_SDK_MODULE_ROOT, or set RTX_SERVER_ROOT to the RealTimeX server directory.'
60
- );
61
- }
62
-
63
- function normalizeContextValue(value) {
64
- const normalized = String(value || '').trim();
65
- return normalized || null;
66
- }
67
-
68
- function parseEnvFile(filePath) {
69
- const vars = {};
70
- if (!fs.existsSync(filePath)) return vars;
71
- for (const raw of fs.readFileSync(filePath, 'utf-8').split('\n')) {
72
- const line = raw.trim();
73
- if (!line || line.startsWith('#')) continue;
74
- const eq = line.indexOf('=');
75
- if (eq === -1) continue;
76
- const key = line.slice(0, eq).trim();
77
- const val = line.slice(eq + 1).trim().replace(/^["']|["']$/g, '');
78
- vars[key] = val;
79
- }
80
- return vars;
81
- }
82
-
83
- /**
84
- * Resolve credentials. The well-known app ID file is checked first so
85
- * agents running inside RealtimeX authenticate without hitting stale
86
- * or inherited env vars.
87
- */
88
- async function resolveCredentials({ envDir, apiKey, appId } = {}) {
89
- // 1. Explicit overrides
90
- if (apiKey) return { apiKey, appId: null };
91
- if (appId) return { apiKey: null, appId };
92
-
93
- // 2. Well-known file (written by RealtimeX server — highest auto priority)
94
- try {
95
- if (fs.existsSync(SDK_APP_ID_FILE)) {
96
- const fileAppId = fs.readFileSync(SDK_APP_ID_FILE, 'utf-8').trim();
97
- if (fileAppId) return { apiKey: null, appId: fileAppId };
98
- }
99
- } catch { /* ignore read errors */ }
100
-
101
- // 3. RTX_APP_ID from process.env (injected by Electron for local apps)
102
- const envAppId = process.env.RTX_APP_ID;
103
- if (envAppId) return { apiKey: null, appId: envAppId };
104
-
105
- // 4. RTX_API_KEY from process.env (standalone dev — explicit, no collision risk)
106
- if (process.env.RTX_API_KEY) return { apiKey: process.env.RTX_API_KEY, appId: null };
107
-
108
- // 5. .env file (standalone dev)
109
- const envVars = parseEnvFile(path.join(envDir || process.cwd(), '.env'));
110
- const fromFile = envVars.RTX_API_KEY || envVars.REALTIMEX_API_KEY || envVars.REALTIMEX_AI_API_KEY;
111
- if (fromFile) return { apiKey: fromFile, appId: null };
112
-
113
- // 6. Interactive prompt (fallback)
114
- const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
115
- const answer = await new Promise((resolve) => {
116
- rl.question('RealTimeX API key not found. Enter your API key: ', (ans) => {
117
- rl.close();
118
- resolve(ans.trim());
119
- });
120
- });
121
- if (answer) return { apiKey: answer, appId: null };
122
-
123
- return { apiKey: null, appId: null };
124
- }
125
-
126
- function resolveDefaultWorkspaceThreadContext(overrides = {}) {
127
- const workspaceSlug =
128
- normalizeContextValue(overrides.workspaceSlug) ||
129
- normalizeContextValue(process.env.RTX_WORKSPACE_SLUG);
130
- const threadSlug =
131
- normalizeContextValue(overrides.threadSlug) ||
132
- normalizeContextValue(process.env.RTX_THREAD_SLUG);
133
-
134
- return {
135
- workspaceSlug,
136
- threadSlug,
137
- };
138
- }
139
-
140
- async function initSDK(opts = {}) {
141
- const { RealtimeXSDK } = requireRealtimeXSDK();
142
- const { apiKey, appId } = await resolveCredentials(opts);
143
- const context = resolveDefaultWorkspaceThreadContext(opts);
144
-
145
- if (!apiKey && !appId) {
146
- throw new Error(
147
- 'No credentials found. Run inside RealtimeX for automatic auth, or set RTX_API_KEY.'
148
- );
149
- }
150
-
151
- const sdk = new RealtimeXSDK({
152
- realtimex: {
153
- url: opts.url || 'http://localhost:3001',
154
- ...(apiKey ? { apiKey } : {}),
155
- ...(appId ? { appId } : {}),
156
- },
157
- permissions: opts.permissions || ALL_PERMISSIONS,
158
- });
159
-
160
- return { sdk, apiKey: apiKey || null, appId: appId || null, context };
161
- }
162
-
163
- module.exports = {
164
- initSDK,
165
- requireRealtimeXSDK,
166
- resolveCredentials,
167
- resolveDefaultWorkspaceThreadContext,
168
- parseEnvFile,
169
- ALL_PERMISSIONS,
170
- SDK_APP_ID_FILE,
171
- };