@pixelbyte-software/pixcode 1.35.2 → 1.35.4

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 (228) hide show
  1. package/LICENSE +718 -718
  2. package/README.de.md +248 -248
  3. package/README.ja.md +240 -240
  4. package/README.ko.md +240 -240
  5. package/README.md +303 -303
  6. package/README.ru.md +248 -248
  7. package/README.tr.md +250 -250
  8. package/README.zh-CN.md +240 -240
  9. package/dist/api-docs.html +548 -548
  10. package/dist/assets/index-BwmhA_le.css +32 -0
  11. package/dist/assets/{index-D1-AIL_5.js → index-CyxRiNt0.js} +182 -182
  12. package/dist/clear-cache.html +85 -85
  13. package/dist/convert-icons.md +52 -52
  14. package/dist/favicon.svg +8 -8
  15. package/dist/generate-icons.js +48 -48
  16. package/dist/icons/codex-white.svg +3 -3
  17. package/dist/icons/codex.svg +3 -3
  18. package/dist/icons/cursor-white.svg +11 -11
  19. package/dist/icons/icon-128x128.svg +9 -9
  20. package/dist/icons/icon-144x144.svg +9 -9
  21. package/dist/icons/icon-152x152.svg +9 -9
  22. package/dist/icons/icon-192x192.svg +9 -9
  23. package/dist/icons/icon-384x384.svg +9 -9
  24. package/dist/icons/icon-512x512.svg +9 -9
  25. package/dist/icons/icon-72x72.svg +9 -9
  26. package/dist/icons/icon-96x96.svg +9 -9
  27. package/dist/icons/icon-template.svg +9 -9
  28. package/dist/icons/qwen-logo.svg +14 -14
  29. package/dist/index.html +59 -59
  30. package/dist/logo.svg +12 -12
  31. package/dist/manifest.json +60 -60
  32. package/dist/openapi.yaml +1693 -1693
  33. package/dist/sw.js +124 -124
  34. package/dist-server/server/cli.js +96 -96
  35. package/dist-server/server/cli.js.map +1 -1
  36. package/dist-server/server/cursor-cli.js.map +1 -1
  37. package/dist-server/server/daemon/manager.js +33 -33
  38. package/dist-server/server/daemon-manager.js +64 -64
  39. package/dist-server/server/gemini-cli.js +4 -4
  40. package/dist-server/server/gemini-cli.js.map +1 -1
  41. package/dist-server/server/index.js +11 -11
  42. package/dist-server/server/index.js.map +1 -1
  43. package/dist-server/server/load-env.js.map +1 -1
  44. package/dist-server/server/middleware/auth.js.map +1 -1
  45. package/dist-server/server/modules/orchestration/tasks/orchestration-task.routes.js.map +1 -1
  46. package/dist-server/server/modules/providers/list/claude/claude-auth.provider.js +1 -1
  47. package/dist-server/server/modules/providers/list/claude/claude-auth.provider.js.map +1 -1
  48. package/dist-server/server/modules/providers/list/codex/codex-auth.provider.js +1 -1
  49. package/dist-server/server/modules/providers/list/codex/codex-auth.provider.js.map +1 -1
  50. package/dist-server/server/modules/providers/list/gemini/gemini-auth.provider.js +1 -1
  51. package/dist-server/server/modules/providers/list/gemini/gemini-auth.provider.js.map +1 -1
  52. package/dist-server/server/modules/providers/list/opencode/opencode-auth.provider.js +1 -1
  53. package/dist-server/server/modules/providers/list/opencode/opencode-auth.provider.js.map +1 -1
  54. package/dist-server/server/modules/providers/list/qwen/qwen-auth.provider.js +1 -1
  55. package/dist-server/server/modules/providers/list/qwen/qwen-auth.provider.js.map +1 -1
  56. package/dist-server/server/modules/providers/provider.routes.js +3 -6
  57. package/dist-server/server/modules/providers/provider.routes.js.map +1 -1
  58. package/dist-server/server/opencode-cli.js +1 -1
  59. package/dist-server/server/opencode-cli.js.map +1 -1
  60. package/dist-server/server/projects.js +2 -3
  61. package/dist-server/server/projects.js.map +1 -1
  62. package/dist-server/server/qwen-code-cli.js +1 -1
  63. package/dist-server/server/qwen-code-cli.js.map +1 -1
  64. package/dist-server/server/routes/agent.js +3 -3
  65. package/dist-server/server/routes/agent.js.map +1 -1
  66. package/dist-server/server/routes/auth.js.map +1 -1
  67. package/dist-server/server/routes/codex.js.map +1 -1
  68. package/dist-server/server/routes/commands.js +26 -26
  69. package/dist-server/server/routes/commands.js.map +1 -1
  70. package/dist-server/server/routes/cursor.js +1 -1
  71. package/dist-server/server/routes/cursor.js.map +1 -1
  72. package/dist-server/server/routes/gemini.js.map +1 -1
  73. package/dist-server/server/routes/git.js +18 -18
  74. package/dist-server/server/routes/git.js.map +1 -1
  75. package/dist-server/server/routes/mcp-utils.js.map +1 -1
  76. package/dist-server/server/routes/messages.js.map +1 -1
  77. package/dist-server/server/routes/network.js +1 -1
  78. package/dist-server/server/routes/network.js.map +1 -1
  79. package/dist-server/server/routes/plugins.js +2 -2
  80. package/dist-server/server/routes/plugins.js.map +1 -1
  81. package/dist-server/server/routes/projects.js +1 -1
  82. package/dist-server/server/routes/projects.js.map +1 -1
  83. package/dist-server/server/routes/settings.js.map +1 -1
  84. package/dist-server/server/routes/taskmaster.js +423 -424
  85. package/dist-server/server/routes/taskmaster.js.map +1 -1
  86. package/dist-server/server/routes/user.js +1 -1
  87. package/dist-server/server/routes/user.js.map +1 -1
  88. package/dist-server/server/services/external-access.js +0 -1
  89. package/dist-server/server/services/external-access.js.map +1 -1
  90. package/dist-server/server/services/notification-orchestrator.js.map +1 -1
  91. package/dist-server/server/utils/commandParser.js.map +1 -1
  92. package/dist-server/server/utils/plugin-process-manager.js.map +1 -1
  93. package/dist-server/server/vite-daemon.js.map +1 -1
  94. package/package.json +180 -180
  95. package/scripts/fix-node-pty.js +67 -67
  96. package/scripts/smoke/a2a-roundtrip.mjs +167 -167
  97. package/scripts/smoke/orchestration-api.mjs +172 -172
  98. package/scripts/smoke/orchestration-live-run.mjs +176 -176
  99. package/server/claude-sdk.js +898 -898
  100. package/server/cli.js +936 -935
  101. package/server/constants/config.js +4 -4
  102. package/server/cursor-cli.js +344 -342
  103. package/server/daemon/manager.js +564 -564
  104. package/server/daemon-manager.js +959 -959
  105. package/server/database/db.js +794 -794
  106. package/server/database/json-store.js +197 -197
  107. package/server/gemini-cli.js +536 -535
  108. package/server/gemini-response-handler.js +79 -79
  109. package/server/index.js +3138 -3135
  110. package/server/load-env.js +35 -34
  111. package/server/middleware/auth.js +174 -173
  112. package/server/modules/orchestration/a2a/adapter-registry.ts +108 -108
  113. package/server/modules/orchestration/a2a/adapters/abstract-a2a.adapter.ts +55 -55
  114. package/server/modules/orchestration/a2a/adapters/claude-code.adapter.ts +284 -284
  115. package/server/modules/orchestration/a2a/adapters/codex.adapter.ts +244 -244
  116. package/server/modules/orchestration/a2a/adapters/cursor.adapter.ts +249 -249
  117. package/server/modules/orchestration/a2a/adapters/gemini.adapter.ts +248 -248
  118. package/server/modules/orchestration/a2a/adapters/opencode.adapter.ts +248 -248
  119. package/server/modules/orchestration/a2a/adapters/qwen.adapter.ts +248 -248
  120. package/server/modules/orchestration/a2a/routes.ts +577 -577
  121. package/server/modules/orchestration/a2a/task-store.ts +178 -178
  122. package/server/modules/orchestration/a2a/types.ts +125 -125
  123. package/server/modules/orchestration/a2a/validator.ts +113 -113
  124. package/server/modules/orchestration/index.ts +66 -66
  125. package/server/modules/orchestration/preview/port-watcher.ts +112 -112
  126. package/server/modules/orchestration/preview/preview-proxy.ts +60 -60
  127. package/server/modules/orchestration/preview/types.ts +19 -19
  128. package/server/modules/orchestration/tasks/orchestration-task-store.ts +45 -45
  129. package/server/modules/orchestration/tasks/orchestration-task.routes.ts +74 -73
  130. package/server/modules/orchestration/tasks/orchestration-task.service.ts +145 -145
  131. package/server/modules/orchestration/tasks/orchestration-task.types.ts +29 -29
  132. package/server/modules/orchestration/workflows/built-in-workflows.ts +127 -127
  133. package/server/modules/orchestration/workflows/workflow-runner.ts +1206 -1206
  134. package/server/modules/orchestration/workflows/workflow-store.ts +97 -97
  135. package/server/modules/orchestration/workflows/workflow.routes.ts +169 -169
  136. package/server/modules/orchestration/workflows/workflow.types.ts +70 -70
  137. package/server/modules/orchestration/workflows/workspace-target.ts +120 -120
  138. package/server/modules/orchestration/workspace/docker-workspace.ts +135 -135
  139. package/server/modules/orchestration/workspace/path-safety.ts +55 -55
  140. package/server/modules/orchestration/workspace/types.ts +52 -52
  141. package/server/modules/orchestration/workspace/workspace-manager.ts +97 -97
  142. package/server/modules/orchestration/workspace/worktree-workspace.ts +125 -125
  143. package/server/modules/providers/index.ts +2 -2
  144. package/server/modules/providers/list/claude/claude-auth.provider.ts +146 -145
  145. package/server/modules/providers/list/claude/claude-mcp.provider.ts +135 -135
  146. package/server/modules/providers/list/claude/claude-sessions.provider.ts +306 -306
  147. package/server/modules/providers/list/claude/claude.provider.ts +15 -15
  148. package/server/modules/providers/list/codex/codex-auth.provider.ts +116 -115
  149. package/server/modules/providers/list/codex/codex-mcp.provider.ts +135 -135
  150. package/server/modules/providers/list/codex/codex-sessions.provider.ts +319 -319
  151. package/server/modules/providers/list/codex/codex.provider.ts +15 -15
  152. package/server/modules/providers/list/cursor/cursor-auth.provider.ts +143 -143
  153. package/server/modules/providers/list/cursor/cursor-mcp.provider.ts +108 -108
  154. package/server/modules/providers/list/cursor/cursor-sessions.provider.ts +421 -421
  155. package/server/modules/providers/list/cursor/cursor.provider.ts +15 -15
  156. package/server/modules/providers/list/gemini/gemini-auth.provider.ts +164 -163
  157. package/server/modules/providers/list/gemini/gemini-mcp.provider.ts +110 -110
  158. package/server/modules/providers/list/gemini/gemini-sessions.provider.ts +227 -227
  159. package/server/modules/providers/list/gemini/gemini.provider.ts +15 -15
  160. package/server/modules/providers/list/opencode/opencode-auth.provider.ts +131 -130
  161. package/server/modules/providers/list/opencode/opencode-mcp.provider.ts +126 -126
  162. package/server/modules/providers/list/opencode/opencode-sessions.provider.ts +232 -232
  163. package/server/modules/providers/list/opencode/opencode.provider.ts +29 -29
  164. package/server/modules/providers/list/qwen/qwen-auth.provider.ts +146 -145
  165. package/server/modules/providers/list/qwen/qwen-mcp.provider.ts +114 -114
  166. package/server/modules/providers/list/qwen/qwen-sessions.provider.ts +265 -265
  167. package/server/modules/providers/list/qwen/qwen.provider.ts +21 -21
  168. package/server/modules/providers/provider.registry.ts +40 -40
  169. package/server/modules/providers/provider.routes.ts +822 -819
  170. package/server/modules/providers/services/mcp.service.ts +86 -86
  171. package/server/modules/providers/services/provider-auth.service.ts +26 -26
  172. package/server/modules/providers/services/sessions.service.ts +45 -45
  173. package/server/modules/providers/shared/base/abstract.provider.ts +20 -20
  174. package/server/modules/providers/shared/mcp/mcp.provider.ts +151 -151
  175. package/server/modules/providers/shared/provider-configs.ts +142 -142
  176. package/server/modules/providers/tests/mcp.test.ts +293 -293
  177. package/server/openai-codex.js +462 -462
  178. package/server/opencode-cli.js +460 -459
  179. package/server/opencode-response-handler.js +107 -107
  180. package/server/projects.js +3106 -3105
  181. package/server/qwen-code-cli.js +396 -395
  182. package/server/qwen-response-handler.js +73 -73
  183. package/server/routes/agent.js +1367 -1365
  184. package/server/routes/auth.js +139 -138
  185. package/server/routes/codex.js +20 -19
  186. package/server/routes/commands.js +556 -554
  187. package/server/routes/cursor.js +54 -52
  188. package/server/routes/gemini.js +25 -24
  189. package/server/routes/git.js +1490 -1488
  190. package/server/routes/mcp-utils.js +32 -31
  191. package/server/routes/messages.js +62 -61
  192. package/server/routes/network.js +121 -120
  193. package/server/routes/plugins.js +320 -318
  194. package/server/routes/projects.js +917 -915
  195. package/server/routes/qwen.js +27 -27
  196. package/server/routes/settings.js +287 -286
  197. package/server/routes/taskmaster.js +1498 -1496
  198. package/server/routes/telegram.js +125 -125
  199. package/server/routes/user.js +125 -123
  200. package/server/services/external-access.js +171 -171
  201. package/server/services/install-jobs.js +571 -571
  202. package/server/services/notification-orchestrator.js +244 -242
  203. package/server/services/provider-credentials.js +189 -189
  204. package/server/services/provider-models.js +381 -381
  205. package/server/services/telegram/bot.js +279 -279
  206. package/server/services/telegram/telegram-http-client.js +130 -130
  207. package/server/services/telegram/translations.js +170 -170
  208. package/server/services/vapid-keys.js +36 -36
  209. package/server/sessionManager.js +225 -225
  210. package/server/shared/interfaces.ts +54 -54
  211. package/server/shared/types.ts +172 -172
  212. package/server/shared/utils.ts +193 -193
  213. package/server/tsconfig.json +36 -36
  214. package/server/utils/colors.js +21 -21
  215. package/server/utils/commandParser.js +305 -303
  216. package/server/utils/frontmatter.js +18 -18
  217. package/server/utils/gitConfig.js +34 -34
  218. package/server/utils/mcp-detector.js +147 -147
  219. package/server/utils/plugin-loader.js +457 -457
  220. package/server/utils/plugin-process-manager.js +185 -184
  221. package/server/utils/port-access.js +209 -209
  222. package/server/utils/runtime-paths.js +37 -37
  223. package/server/utils/taskmaster-websocket.js +128 -128
  224. package/server/utils/url-detection.js +71 -71
  225. package/server/vite-daemon.js +79 -78
  226. package/shared/modelConstants.js +162 -162
  227. package/shared/networkHosts.js +22 -22
  228. package/dist/assets/index-B8w57E1r.css +0 -32
@@ -1,31 +1,32 @@
1
- /**
2
- * MCP UTILITIES API ROUTES
3
- * ========================
4
- *
5
- * API endpoints for MCP server detection and configuration utilities.
6
- * These endpoints expose centralized MCP detection functionality.
7
- */
8
-
9
- import express from 'express';
10
- import { detectTaskMasterMCPServer } from '../utils/mcp-detector.js';
11
-
12
- const router = express.Router();
13
-
14
- /**
15
- * GET /api/mcp-utils/taskmaster-server
16
- * Check if TaskMaster MCP server is configured
17
- */
18
- router.get('/taskmaster-server', async (req, res) => {
19
- try {
20
- const result = await detectTaskMasterMCPServer();
21
- res.json(result);
22
- } catch (error) {
23
- console.error('TaskMaster MCP detection error:', error);
24
- res.status(500).json({
25
- error: 'Failed to detect TaskMaster MCP server',
26
- message: error.message
27
- });
28
- }
29
- });
30
-
31
- export default router;
1
+ /**
2
+ * MCP UTILITIES API ROUTES
3
+ * ========================
4
+ *
5
+ * API endpoints for MCP server detection and configuration utilities.
6
+ * These endpoints expose centralized MCP detection functionality.
7
+ */
8
+
9
+ import express from 'express';
10
+
11
+ import { detectTaskMasterMCPServer } from '../utils/mcp-detector.js';
12
+
13
+ const router = express.Router();
14
+
15
+ /**
16
+ * GET /api/mcp-utils/taskmaster-server
17
+ * Check if TaskMaster MCP server is configured
18
+ */
19
+ router.get('/taskmaster-server', async (req, res) => {
20
+ try {
21
+ const result = await detectTaskMasterMCPServer();
22
+ res.json(result);
23
+ } catch (error) {
24
+ console.error('TaskMaster MCP detection error:', error);
25
+ res.status(500).json({
26
+ error: 'Failed to detect TaskMaster MCP server',
27
+ message: error.message
28
+ });
29
+ }
30
+ });
31
+
32
+ export default router;
@@ -1,61 +1,62 @@
1
- /**
2
- * Unified messages endpoint.
3
- *
4
- * GET /api/sessions/:sessionId/messages?provider=claude&projectName=foo&limit=50&offset=0
5
- *
6
- * Replaces the four provider-specific session message endpoints with a single route
7
- * that delegates to the appropriate adapter via the provider registry.
8
- *
9
- * @module routes/messages
10
- */
11
-
12
- import express from 'express';
13
- import { sessionsService } from '../modules/providers/services/sessions.service.js';
14
-
15
- const router = express.Router();
16
-
17
- /**
18
- * GET /api/sessions/:sessionId/messages
19
- *
20
- * Auth: authenticateToken applied at mount level in index.js
21
- *
22
- * Query params:
23
- * provider - 'claude' | 'cursor' | 'codex' | 'gemini' (default: 'claude')
24
- * projectName - required for claude provider
25
- * projectPath - required for cursor provider (absolute path used for cwdId hash)
26
- * limit - page size (omit or null for all)
27
- * offset - pagination offset (default: 0)
28
- */
29
- router.get('/:sessionId/messages', async (req, res) => {
30
- try {
31
- const { sessionId } = req.params;
32
- const provider = String(req.query.provider || 'claude').trim().toLowerCase();
33
- const projectName = req.query.projectName || '';
34
- const projectPath = req.query.projectPath || '';
35
- const limitParam = req.query.limit;
36
- const limit = limitParam !== undefined && limitParam !== null && limitParam !== ''
37
- ? parseInt(limitParam, 10)
38
- : null;
39
- const offset = parseInt(req.query.offset || '0', 10);
40
-
41
- const availableProviders = sessionsService.listProviderIds();
42
- if (!availableProviders.includes(provider)) {
43
- const available = availableProviders.join(', ');
44
- return res.status(400).json({ error: `Unknown provider: ${provider}. Available: ${available}` });
45
- }
46
-
47
- const result = await sessionsService.fetchHistory(provider, sessionId, {
48
- projectName,
49
- projectPath,
50
- limit,
51
- offset,
52
- });
53
-
54
- return res.json(result);
55
- } catch (error) {
56
- console.error('Error fetching unified messages:', error);
57
- return res.status(500).json({ error: 'Failed to fetch messages' });
58
- }
59
- });
60
-
61
- export default router;
1
+ /**
2
+ * Unified messages endpoint.
3
+ *
4
+ * GET /api/sessions/:sessionId/messages?provider=claude&projectName=foo&limit=50&offset=0
5
+ *
6
+ * Replaces the four provider-specific session message endpoints with a single route
7
+ * that delegates to the appropriate adapter via the provider registry.
8
+ *
9
+ * @module routes/messages
10
+ */
11
+
12
+ import express from 'express';
13
+
14
+ import { sessionsService } from '../modules/providers/services/sessions.service.js';
15
+
16
+ const router = express.Router();
17
+
18
+ /**
19
+ * GET /api/sessions/:sessionId/messages
20
+ *
21
+ * Auth: authenticateToken applied at mount level in index.js
22
+ *
23
+ * Query params:
24
+ * provider - 'claude' | 'cursor' | 'codex' | 'gemini' (default: 'claude')
25
+ * projectName - required for claude provider
26
+ * projectPath - required for cursor provider (absolute path used for cwdId hash)
27
+ * limit - page size (omit or null for all)
28
+ * offset - pagination offset (default: 0)
29
+ */
30
+ router.get('/:sessionId/messages', async (req, res) => {
31
+ try {
32
+ const { sessionId } = req.params;
33
+ const provider = String(req.query.provider || 'claude').trim().toLowerCase();
34
+ const projectName = req.query.projectName || '';
35
+ const projectPath = req.query.projectPath || '';
36
+ const limitParam = req.query.limit;
37
+ const limit = limitParam !== undefined && limitParam !== null && limitParam !== ''
38
+ ? parseInt(limitParam, 10)
39
+ : null;
40
+ const offset = parseInt(req.query.offset || '0', 10);
41
+
42
+ const availableProviders = sessionsService.listProviderIds();
43
+ if (!availableProviders.includes(provider)) {
44
+ const available = availableProviders.join(', ');
45
+ return res.status(400).json({ error: `Unknown provider: ${provider}. Available: ${available}` });
46
+ }
47
+
48
+ const result = await sessionsService.fetchHistory(provider, sessionId, {
49
+ projectName,
50
+ projectPath,
51
+ limit,
52
+ offset,
53
+ });
54
+
55
+ return res.json(result);
56
+ } catch (error) {
57
+ console.error('Error fetching unified messages:', error);
58
+ return res.status(500).json({ error: 'Failed to fetch messages' });
59
+ }
60
+ });
61
+
62
+ export default router;
@@ -1,120 +1,121 @@
1
- import express from 'express';
2
- import os from 'os';
3
-
4
- import {
5
- getTunnelState,
6
- getUpnpState,
7
- startTunnel,
8
- stopTunnel,
9
- } from '../services/external-access.js';
10
-
11
- const router = express.Router();
12
-
13
- // Accept any env key the rest of the server honors. Keep this aligned with server/cli.js.
14
- const resolveServerPort = () => {
15
- const raw = process.env.SERVER_PORT || process.env.PORT || '3001';
16
- const port = Number(raw);
17
- return Number.isFinite(port) && port > 0 ? port : 3001;
18
- };
19
-
20
- // Filter to usable LAN addresses. We skip:
21
- // - internal (loopback) addresses, since QR-ing "127.0.0.1" is useless for a phone
22
- // - link-local IPv6, since pasting "fe80::…%iface" into a phone browser won't resolve
23
- // - IPv6 addresses in general for the first pass (most users want the v4 QR)
24
- const listLanEndpoints = () => {
25
- const interfaces = os.networkInterfaces();
26
- const endpoints = [];
27
-
28
- for (const [ifaceName, addrs] of Object.entries(interfaces)) {
29
- if (!addrs) continue;
30
- for (const addr of addrs) {
31
- if (addr.internal) continue;
32
- if (addr.family !== 'IPv4' && addr.family !== 4) continue;
33
- endpoints.push({
34
- host: addr.address,
35
- label: ifaceName,
36
- family: 'IPv4',
37
- });
38
- }
39
- }
40
-
41
- return endpoints;
42
- };
43
-
44
- router.get('/endpoints', (req, res) => {
45
- try {
46
- const port = resolveServerPort();
47
- const endpoints = listLanEndpoints().map((entry) => ({
48
- ...entry,
49
- url: `http://${entry.host}:${port}`,
50
- }));
51
-
52
- res.json({
53
- port,
54
- hostname: os.hostname(),
55
- endpoints,
56
- });
57
- } catch (error) {
58
- console.error('Error listing network endpoints:', error);
59
- res.status(500).json({ error: 'Failed to list network endpoints' });
60
- }
61
- });
62
-
63
- // ============================================================================
64
- // External access (UPnP + tunnel)
65
- // ============================================================================
66
-
67
- router.get('/external', (req, res) => {
68
- try {
69
- res.json({
70
- upnp: getUpnpState(),
71
- tunnel: getTunnelState(),
72
- });
73
- } catch (error) {
74
- console.error('Error reading external-access state:', error);
75
- res.status(500).json({ error: 'Failed to read external access state' });
76
- }
77
- });
78
-
79
- // UPnP endpoints removed in v1.32 (see external-access.js for rationale).
80
- // Clients hitting /upnp get a 410 so the UI can show a clear "moved to
81
- // tunnel" hint without mistaking the absence for a transient 404.
82
- router.post('/upnp', (_req, res) => {
83
- res.status(410).json({
84
- error: 'UPnP removed in v1.32 — use cloudflared or ngrok tunnels instead',
85
- upnp: getUpnpState(),
86
- });
87
- });
88
- router.delete('/upnp', (_req, res) => {
89
- res.status(410).json({
90
- error: 'UPnP removed in v1.32 — use cloudflared or ngrok tunnels instead',
91
- upnp: getUpnpState(),
92
- });
93
- });
94
-
95
- router.post('/tunnel', async (req, res) => {
96
- const port = resolveServerPort();
97
- try {
98
- const state = await startTunnel({ port });
99
- res.json({ success: true, tunnel: state });
100
- } catch (error) {
101
- console.error('Tunnel start failed:', error);
102
- // 424 Failed Dependency is the best match for "we can't start because a
103
- // required external binary is missing" it tells the UI to show the
104
- // "install cloudflared/ngrok" hint rather than a generic server error.
105
- const status = error?.code === 'ENOENT_TUNNEL' ? 424 : 502;
106
- res.status(status).json({ error: error?.message || 'Tunnel start failed', tunnel: getTunnelState() });
107
- }
108
- });
109
-
110
- router.delete('/tunnel', async (req, res) => {
111
- try {
112
- const state = await stopTunnel();
113
- res.json({ success: true, tunnel: state });
114
- } catch (error) {
115
- console.error('Tunnel stop failed:', error);
116
- res.status(502).json({ error: error?.message || 'Tunnel stop failed', tunnel: getTunnelState() });
117
- }
118
- });
119
-
120
- export default router;
1
+ import os from 'os';
2
+
3
+ import express from 'express';
4
+
5
+ import {
6
+ getTunnelState,
7
+ getUpnpState,
8
+ startTunnel,
9
+ stopTunnel,
10
+ } from '../services/external-access.js';
11
+
12
+ const router = express.Router();
13
+
14
+ // Accept any env key the rest of the server honors. Keep this aligned with server/cli.js.
15
+ const resolveServerPort = () => {
16
+ const raw = process.env.SERVER_PORT || process.env.PORT || '3001';
17
+ const port = Number(raw);
18
+ return Number.isFinite(port) && port > 0 ? port : 3001;
19
+ };
20
+
21
+ // Filter to usable LAN addresses. We skip:
22
+ // - internal (loopback) addresses, since QR-ing "127.0.0.1" is useless for a phone
23
+ // - link-local IPv6, since pasting "fe80::…%iface" into a phone browser won't resolve
24
+ // - IPv6 addresses in general for the first pass (most users want the v4 QR)
25
+ const listLanEndpoints = () => {
26
+ const interfaces = os.networkInterfaces();
27
+ const endpoints = [];
28
+
29
+ for (const [ifaceName, addrs] of Object.entries(interfaces)) {
30
+ if (!addrs) continue;
31
+ for (const addr of addrs) {
32
+ if (addr.internal) continue;
33
+ if (addr.family !== 'IPv4' && addr.family !== 4) continue;
34
+ endpoints.push({
35
+ host: addr.address,
36
+ label: ifaceName,
37
+ family: 'IPv4',
38
+ });
39
+ }
40
+ }
41
+
42
+ return endpoints;
43
+ };
44
+
45
+ router.get('/endpoints', (req, res) => {
46
+ try {
47
+ const port = resolveServerPort();
48
+ const endpoints = listLanEndpoints().map((entry) => ({
49
+ ...entry,
50
+ url: `http://${entry.host}:${port}`,
51
+ }));
52
+
53
+ res.json({
54
+ port,
55
+ hostname: os.hostname(),
56
+ endpoints,
57
+ });
58
+ } catch (error) {
59
+ console.error('Error listing network endpoints:', error);
60
+ res.status(500).json({ error: 'Failed to list network endpoints' });
61
+ }
62
+ });
63
+
64
+ // ============================================================================
65
+ // External access (UPnP + tunnel)
66
+ // ============================================================================
67
+
68
+ router.get('/external', (req, res) => {
69
+ try {
70
+ res.json({
71
+ upnp: getUpnpState(),
72
+ tunnel: getTunnelState(),
73
+ });
74
+ } catch (error) {
75
+ console.error('Error reading external-access state:', error);
76
+ res.status(500).json({ error: 'Failed to read external access state' });
77
+ }
78
+ });
79
+
80
+ // UPnP endpoints removed in v1.32 (see external-access.js for rationale).
81
+ // Clients hitting /upnp get a 410 so the UI can show a clear "moved to
82
+ // tunnel" hint without mistaking the absence for a transient 404.
83
+ router.post('/upnp', (_req, res) => {
84
+ res.status(410).json({
85
+ error: 'UPnP removed in v1.32 — use cloudflared or ngrok tunnels instead',
86
+ upnp: getUpnpState(),
87
+ });
88
+ });
89
+ router.delete('/upnp', (_req, res) => {
90
+ res.status(410).json({
91
+ error: 'UPnP removed in v1.32 — use cloudflared or ngrok tunnels instead',
92
+ upnp: getUpnpState(),
93
+ });
94
+ });
95
+
96
+ router.post('/tunnel', async (req, res) => {
97
+ const port = resolveServerPort();
98
+ try {
99
+ const state = await startTunnel({ port });
100
+ res.json({ success: true, tunnel: state });
101
+ } catch (error) {
102
+ console.error('Tunnel start failed:', error);
103
+ // 424 Failed Dependency is the best match for "we can't start because a
104
+ // required external binary is missing" it tells the UI to show the
105
+ // "install cloudflared/ngrok" hint rather than a generic server error.
106
+ const status = error?.code === 'ENOENT_TUNNEL' ? 424 : 502;
107
+ res.status(status).json({ error: error?.message || 'Tunnel start failed', tunnel: getTunnelState() });
108
+ }
109
+ });
110
+
111
+ router.delete('/tunnel', async (req, res) => {
112
+ try {
113
+ const state = await stopTunnel();
114
+ res.json({ success: true, tunnel: state });
115
+ } catch (error) {
116
+ console.error('Tunnel stop failed:', error);
117
+ res.status(502).json({ error: error?.message || 'Tunnel stop failed', tunnel: getTunnelState() });
118
+ }
119
+ });
120
+
121
+ export default router;