spi3der 0.0.0-stage → 0.1.0

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 (113) hide show
  1. package/APP.md +40 -0
  2. package/Dockerfile +4 -0
  3. package/MCP.md +149 -0
  4. package/PLAYER.md +136 -0
  5. package/README.md +35 -2
  6. package/api/mcp.mjs +31 -0
  7. package/api/store.mjs +158 -0
  8. package/bin/spi3der.mjs +20 -0
  9. package/emulator.html +17 -0
  10. package/engine/8fa668821759/bevel.js +265 -0
  11. package/engine/8fa668821759/camera.js +76 -0
  12. package/engine/8fa668821759/character.js +1019 -0
  13. package/engine/8fa668821759/check.js +83 -0
  14. package/engine/8fa668821759/csg.js +342 -0
  15. package/engine/8fa668821759/edit.js +48 -0
  16. package/engine/8fa668821759/galaxy.js +265 -0
  17. package/engine/8fa668821759/gl.js +798 -0
  18. package/engine/8fa668821759/gpu.js +1356 -0
  19. package/engine/8fa668821759/index.js +48 -0
  20. package/engine/8fa668821759/instances.js +41 -0
  21. package/engine/8fa668821759/joints.js +355 -0
  22. package/engine/8fa668821759/kernel-bytes.js +2 -0
  23. package/engine/8fa668821759/kernel.js +82 -0
  24. package/engine/8fa668821759/lathe.js +87 -0
  25. package/engine/8fa668821759/material.js +19 -0
  26. package/engine/8fa668821759/mesh.js +131 -0
  27. package/engine/8fa668821759/order.js +125 -0
  28. package/engine/8fa668821759/pick.js +85 -0
  29. package/engine/8fa668821759/place.js +17 -0
  30. package/engine/8fa668821759/planet.js +376 -0
  31. package/engine/8fa668821759/rig.js +417 -0
  32. package/engine/8fa668821759/saw.js +121 -0
  33. package/engine/8fa668821759/sky.js +428 -0
  34. package/engine/8fa668821759/svg.js +239 -0
  35. package/engine/8fa668821759/text.js +231 -0
  36. package/engine/8fa668821759/triangulate.js +72 -0
  37. package/engine/8fa668821759/types.js +2 -0
  38. package/engine/8fa668821759/vec.js +22 -0
  39. package/engine/8fa668821759/version.js +7 -0
  40. package/engine/8fa668821759/vrtsh.js +354 -0
  41. package/engine/8fa668821759/wire.js +346 -0
  42. package/favicon.svg +15 -0
  43. package/help.md +289 -0
  44. package/icons/apple-touch-icon.png +0 -0
  45. package/icons/favicon-32.png +0 -0
  46. package/icons/icon-192.png +0 -0
  47. package/icons/icon-512.png +0 -0
  48. package/icons/icon-maskable-512.png +0 -0
  49. package/icons/icon-maskable.svg +13 -0
  50. package/icons/icon.svg +15 -0
  51. package/index.html +13730 -0
  52. package/manifest.webmanifest +37 -0
  53. package/mcp/engine/bevel.js +265 -0
  54. package/mcp/engine/camera.js +76 -0
  55. package/mcp/engine/character.js +1019 -0
  56. package/mcp/engine/check.js +83 -0
  57. package/mcp/engine/csg.js +342 -0
  58. package/mcp/engine/edit.js +48 -0
  59. package/mcp/engine/galaxy.js +265 -0
  60. package/mcp/engine/gl.js +798 -0
  61. package/mcp/engine/gpu.js +1356 -0
  62. package/mcp/engine/index.js +48 -0
  63. package/mcp/engine/instances.js +41 -0
  64. package/mcp/engine/joints.js +355 -0
  65. package/mcp/engine/kernel-bytes.js +2 -0
  66. package/mcp/engine/kernel.js +82 -0
  67. package/mcp/engine/lathe.js +87 -0
  68. package/mcp/engine/material.js +19 -0
  69. package/mcp/engine/mesh.js +131 -0
  70. package/mcp/engine/order.js +125 -0
  71. package/mcp/engine/pick.js +85 -0
  72. package/mcp/engine/place.js +17 -0
  73. package/mcp/engine/planet.js +376 -0
  74. package/mcp/engine/rig.js +417 -0
  75. package/mcp/engine/saw.js +121 -0
  76. package/mcp/engine/sky.js +428 -0
  77. package/mcp/engine/svg.js +239 -0
  78. package/mcp/engine/text.js +231 -0
  79. package/mcp/engine/triangulate.js +72 -0
  80. package/mcp/engine/types.js +2 -0
  81. package/mcp/engine/vec.js +22 -0
  82. package/mcp/engine/version.js +7 -0
  83. package/mcp/engine/vrtsh.js +354 -0
  84. package/mcp/engine/wire.js +346 -0
  85. package/mcp/http.js +292 -0
  86. package/mcp/live.js +95 -0
  87. package/mcp/package.json +10 -0
  88. package/mcp/scene.js +1027 -0
  89. package/mcp/serve.js +87 -0
  90. package/mcp/server.js +97 -0
  91. package/media/face-of-spider.png +0 -0
  92. package/media/spider-paint-2015.png +0 -0
  93. package/media/spider-web.png +0 -0
  94. package/models/deepsky-lark.scene.json +1 -0
  95. package/models/deepsky.scene.json +1 -0
  96. package/models/globe.scene.json +1 -0
  97. package/models/lark-4.scene.json +1 -0
  98. package/models/lark.game.json +14 -0
  99. package/models/spider-build-v2.md +215 -0
  100. package/models/spider-build-v2.mjs +355 -0
  101. package/models/spider-build-v2.schema.json +1001 -0
  102. package/nginx.conf +12 -0
  103. package/package.json +45 -4
  104. package/player.html +274 -0
  105. package/sky.html +133 -0
  106. package/sky.md +285 -0
  107. package/src/demo.js +92 -0
  108. package/src/emulator/devices.js +22 -0
  109. package/src/emulator/xr.js +362 -0
  110. package/src/math.js +77 -0
  111. package/sw.js +37 -0
  112. package/xr-compare.html +332 -0
  113. package/xr-test.html +248 -0
package/mcp/live.js ADDED
@@ -0,0 +1,95 @@
1
+ // (copied from 3Draft 8fa6688 by scripts/sync.mjs: change it there)
2
+ // The live link: the MCP process also serves the viewer and pushes the scene to it.
3
+ // GET /app/ the viewer (same files as `npm run app`)
4
+ // GET /scene the scene as JSON
5
+ // GET /events Server-Sent Events: a `scene` event on connect and after every change,
6
+ // a `view` event for a viewer command (target, camera, vehicle, example: the view_* tools)
7
+ // POST /viewer-state the open viewer reports what it shows (every 2 s): read with the view_state tool
8
+ // Loopback only. The viewer in the browser does not change the MCP scene; the AI edits through MCP.
9
+
10
+ import { createViewerServer, VIEWERS } from './serve.js';
11
+
12
+ /**
13
+ * Starts the server on `port` (0 = any free port); when it is taken, tries the next
14
+ * `tries` ports. Resolves { url, port, clients(), close() }, or null when none was free.
15
+ */
16
+ export const startLive = async (scene, { port = 5173, tries = 10 } = {}) => {
17
+ const clients = new Set();
18
+ const send = (res) => res.write(`event: scene\ndata: ${JSON.stringify(scene.data())}\n\n`);
19
+
20
+ let viewer = null; // the last report of an open viewer: { at (ms), ...state }
21
+ const extra = (req, res, path) => {
22
+ if (req.method === 'POST' && path === '/viewer-state') {
23
+ let body = '';
24
+ req.setEncoding('utf8');
25
+ req.on('data', (c) => {
26
+ body += c;
27
+ if (body.length > 65536) req.destroy();
28
+ });
29
+ req.on('end', () => {
30
+ try {
31
+ viewer = { at: Date.now(), ...JSON.parse(body) };
32
+ res.writeHead(204);
33
+ } catch {
34
+ res.writeHead(400);
35
+ }
36
+ res.end();
37
+ });
38
+ return true;
39
+ }
40
+ if (req.method !== 'GET') return false;
41
+ if (path === '/scene') {
42
+ res.writeHead(200, { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' });
43
+ res.end(JSON.stringify(scene.data()));
44
+ return true;
45
+ }
46
+ if (path === '/events') {
47
+ res.writeHead(200, { 'content-type': 'text/event-stream', 'cache-control': 'no-store', connection: 'keep-alive' });
48
+ res.write('retry: 1000\n\n');
49
+ clients.add(res);
50
+ req.on('close', () => clients.delete(res));
51
+ send(res);
52
+ return true;
53
+ }
54
+ return false;
55
+ };
56
+
57
+ const unsubscribe = scene.subscribe(() => clients.forEach(send));
58
+ const ping = setInterval(() => clients.forEach((res) => res.write(': ping\n\n')), 20000);
59
+ ping.unref();
60
+
61
+ for (let i = 0; i < tries; i++) {
62
+ const p = port === 0 ? 0 : port + i;
63
+ const server = createViewerServer(extra);
64
+ const ok = await new Promise((resolve) => {
65
+ server.once('error', () => resolve(false));
66
+ server.listen(p, '127.0.0.1', () => resolve(true));
67
+ });
68
+ if (!ok) continue;
69
+ const bound = server.address().port;
70
+ const viewers = Object.fromEntries(Object.entries(VIEWERS).map(([k, v]) => [k, `http://localhost:${bound}${v}`]));
71
+ return {
72
+ url: Object.values(viewers)[0],
73
+ viewers,
74
+ port: bound,
75
+ clients: () => clients.size,
76
+ /** Sends a viewer command (a `view` event) to every open viewer; returns how many got it. */
77
+ command: (cmd) => {
78
+ clients.forEach((res) => res.write(`event: view\ndata: ${JSON.stringify(cmd)}\n\n`));
79
+ return clients.size;
80
+ },
81
+ /** The last state an open viewer reported, with its age in seconds, or null. */
82
+ viewer: () => (viewer ? { ...viewer, age_s: Math.round((Date.now() - viewer.at) / 100) / 10 } : null),
83
+ close: () => {
84
+ unsubscribe();
85
+ clearInterval(ping);
86
+ clients.forEach((res) => res.end());
87
+ server.closeAllConnections?.();
88
+ return new Promise((r) => server.close(r));
89
+ },
90
+ };
91
+ }
92
+ unsubscribe();
93
+ clearInterval(ping);
94
+ return null;
95
+ };
@@ -0,0 +1,10 @@
1
+ {
2
+ "name": "spider-paint-mcp",
3
+ "private": true,
4
+ "type": "module",
5
+ "description": "The Spider Paint / 3Draft MCP server: node mcp/server.js",
6
+ "3draft": {
7
+ "version": "26.11.18029",
8
+ "commit": "8fa668821759563fb012042571bf3913c3563824"
9
+ }
10
+ }