@coloopx/colocad 0.0.0-stage → 0.1.0-alpha.3

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 (194) hide show
  1. package/LICENSE +21 -0
  2. package/NOTICE.md +5 -0
  3. package/README.md +131 -2
  4. package/README.zh-CN.md +100 -0
  5. package/bin/colocad.mjs +32 -0
  6. package/examples/manifold.json +11 -0
  7. package/examples/sensor-rail.json +9 -0
  8. package/kernel/LICENSE +21 -0
  9. package/kernel/dist/artifacts.d.ts +3 -0
  10. package/kernel/dist/artifacts.js +19 -0
  11. package/kernel/dist/assets.d.ts +3 -0
  12. package/kernel/dist/assets.js +11 -0
  13. package/kernel/dist/binary.d.ts +2 -0
  14. package/kernel/dist/binary.js +14 -0
  15. package/kernel/dist/client.d.ts +22 -0
  16. package/kernel/dist/client.js +99 -0
  17. package/kernel/dist/files.d.ts +19 -0
  18. package/kernel/dist/files.js +103 -0
  19. package/kernel/dist/generated.d.ts +707 -0
  20. package/kernel/dist/generated.js +1 -0
  21. package/kernel/dist/helpers.d.ts +9 -0
  22. package/kernel/dist/helpers.js +23 -0
  23. package/kernel/dist/index.d.ts +8 -0
  24. package/kernel/dist/index.js +6 -0
  25. package/kernel/dist/preview-cache.d.ts +19 -0
  26. package/kernel/dist/preview-cache.js +29 -0
  27. package/kernel/dist/process.d.ts +12 -0
  28. package/kernel/dist/process.js +41 -0
  29. package/kernel/dist/tools.d.ts +67 -0
  30. package/kernel/dist/tools.js +20 -0
  31. package/kernel/dist/types.d.ts +26 -0
  32. package/kernel/dist/types.js +1 -0
  33. package/kernel/licenses/adler2-2.0.1-LICENSE-0BSD +12 -0
  34. package/kernel/licenses/adler2-2.0.1-LICENSE-APACHE +201 -0
  35. package/kernel/licenses/adler2-2.0.1-LICENSE-MIT +23 -0
  36. package/kernel/licenses/allocator-api2-0.2.21-LICENSE-APACHE +176 -0
  37. package/kernel/licenses/allocator-api2-0.2.21-LICENSE-MIT +23 -0
  38. package/kernel/licenses/autocfg-1.5.1-LICENSE-APACHE +201 -0
  39. package/kernel/licenses/autocfg-1.5.1-LICENSE-MIT +25 -0
  40. package/kernel/licenses/bitflags-1.3.2-LICENSE-APACHE +201 -0
  41. package/kernel/licenses/bitflags-1.3.2-LICENSE-MIT +25 -0
  42. package/kernel/licenses/block-buffer-0.10.4-LICENSE-APACHE +201 -0
  43. package/kernel/licenses/block-buffer-0.10.4-LICENSE-MIT +25 -0
  44. package/kernel/licenses/cfg-if-1.0.5-LICENSE-APACHE +201 -0
  45. package/kernel/licenses/cfg-if-1.0.5-LICENSE-MIT +25 -0
  46. package/kernel/licenses/cpufeatures-0.2.17-LICENSE-APACHE +201 -0
  47. package/kernel/licenses/cpufeatures-0.2.17-LICENSE-MIT +25 -0
  48. package/kernel/licenses/crc32fast-1.5.4-LICENSE-APACHE +202 -0
  49. package/kernel/licenses/crc32fast-1.5.4-LICENSE-MIT +21 -0
  50. package/kernel/licenses/crossbeam-deque-0.8.8-LICENSE-APACHE +201 -0
  51. package/kernel/licenses/crossbeam-deque-0.8.8-LICENSE-MIT +27 -0
  52. package/kernel/licenses/crossbeam-epoch-0.9.21-LICENSE-APACHE +201 -0
  53. package/kernel/licenses/crossbeam-epoch-0.9.21-LICENSE-MIT +27 -0
  54. package/kernel/licenses/crossbeam-utils-0.8.23-LICENSE-APACHE +201 -0
  55. package/kernel/licenses/crossbeam-utils-0.8.23-LICENSE-MIT +27 -0
  56. package/kernel/licenses/crypto-common-0.1.7-LICENSE-APACHE +201 -0
  57. package/kernel/licenses/crypto-common-0.1.7-LICENSE-MIT +25 -0
  58. package/kernel/licenses/dependencies.json +618 -0
  59. package/kernel/licenses/digest-0.10.7-LICENSE-APACHE +201 -0
  60. package/kernel/licenses/digest-0.10.7-LICENSE-MIT +25 -0
  61. package/kernel/licenses/dyn-clone-1.0.20-LICENSE-APACHE +176 -0
  62. package/kernel/licenses/dyn-clone-1.0.20-LICENSE-MIT +23 -0
  63. package/kernel/licenses/either-1.19.0-LICENSE-APACHE +201 -0
  64. package/kernel/licenses/either-1.19.0-LICENSE-MIT +25 -0
  65. package/kernel/licenses/equivalent-1.0.3-LICENSE-APACHE +201 -0
  66. package/kernel/licenses/equivalent-1.0.3-LICENSE-MIT +25 -0
  67. package/kernel/licenses/fdeflate-0.3.7-LICENSE-APACHE +177 -0
  68. package/kernel/licenses/fdeflate-0.3.7-LICENSE-MIT +25 -0
  69. package/kernel/licenses/flate2-1.1.10-LICENSE-APACHE +201 -0
  70. package/kernel/licenses/flate2-1.1.10-LICENSE-MIT +25 -0
  71. package/kernel/licenses/foldhash-0.2.0-LICENSE +19 -0
  72. package/kernel/licenses/generic-array-0.14.7-LICENSE +21 -0
  73. package/kernel/licenses/hashbrown-0.16.1-LICENSE-APACHE +201 -0
  74. package/kernel/licenses/hashbrown-0.16.1-LICENSE-MIT +25 -0
  75. package/kernel/licenses/itoa-1.0.18-LICENSE-APACHE +176 -0
  76. package/kernel/licenses/itoa-1.0.18-LICENSE-MIT +23 -0
  77. package/kernel/licenses/libc-0.2.191-LICENSE-APACHE +176 -0
  78. package/kernel/licenses/libc-0.2.191-LICENSE-MIT +25 -0
  79. package/kernel/licenses/memchr-2.8.3-COPYING +3 -0
  80. package/kernel/licenses/memchr-2.8.3-LICENSE-MIT +21 -0
  81. package/kernel/licenses/miniz_oxide-0.8.9-LICENSE +25 -0
  82. package/kernel/licenses/miniz_oxide-0.8.9-LICENSE-APACHE.md +177 -0
  83. package/kernel/licenses/miniz_oxide-0.8.9-LICENSE-MIT.md +24 -0
  84. package/kernel/licenses/miniz_oxide-0.8.9-LICENSE-ZLIB.md +14 -0
  85. package/kernel/licenses/miniz_oxide-0.9.1-LICENSE +25 -0
  86. package/kernel/licenses/miniz_oxide-0.9.1-LICENSE-APACHE.md +177 -0
  87. package/kernel/licenses/miniz_oxide-0.9.1-LICENSE-MIT.md +24 -0
  88. package/kernel/licenses/miniz_oxide-0.9.1-LICENSE-ZLIB.md +14 -0
  89. package/kernel/licenses/num-traits-0.2.19-LICENSE-APACHE +201 -0
  90. package/kernel/licenses/num-traits-0.2.19-LICENSE-MIT +25 -0
  91. package/kernel/licenses/png-0.17.16-LICENSE-APACHE +201 -0
  92. package/kernel/licenses/png-0.17.16-LICENSE-MIT +25 -0
  93. package/kernel/licenses/proc-macro2-1.0.107-LICENSE-APACHE +176 -0
  94. package/kernel/licenses/proc-macro2-1.0.107-LICENSE-MIT +23 -0
  95. package/kernel/licenses/quote-1.0.47-LICENSE-APACHE +176 -0
  96. package/kernel/licenses/quote-1.0.47-LICENSE-MIT +23 -0
  97. package/kernel/licenses/rayon-1.12.0-LICENSE-APACHE +201 -0
  98. package/kernel/licenses/rayon-1.12.0-LICENSE-MIT +25 -0
  99. package/kernel/licenses/rayon-core-1.13.0-LICENSE-APACHE +201 -0
  100. package/kernel/licenses/rayon-core-1.13.0-LICENSE-MIT +25 -0
  101. package/kernel/licenses/ref-cast-1.0.27-LICENSE-APACHE +176 -0
  102. package/kernel/licenses/ref-cast-1.0.27-LICENSE-MIT +23 -0
  103. package/kernel/licenses/ref-cast-impl-1.0.27-LICENSE-APACHE +176 -0
  104. package/kernel/licenses/ref-cast-impl-1.0.27-LICENSE-MIT +23 -0
  105. package/kernel/licenses/robust-1.2.0-LICENSE-APACHE +201 -0
  106. package/kernel/licenses/robust-1.2.0-LICENSE-MIT +26 -0
  107. package/kernel/licenses/schemars-1.2.3-LICENSE +21 -0
  108. package/kernel/licenses/schemars_derive-1.2.3-LICENSE +21 -0
  109. package/kernel/licenses/serde-1.0.229-LICENSE-APACHE +176 -0
  110. package/kernel/licenses/serde-1.0.229-LICENSE-MIT +23 -0
  111. package/kernel/licenses/serde_core-1.0.229-LICENSE-APACHE +176 -0
  112. package/kernel/licenses/serde_core-1.0.229-LICENSE-MIT +23 -0
  113. package/kernel/licenses/serde_derive-1.0.229-LICENSE-APACHE +176 -0
  114. package/kernel/licenses/serde_derive-1.0.229-LICENSE-MIT +23 -0
  115. package/kernel/licenses/serde_derive_internals-0.30.0-LICENSE-APACHE +176 -0
  116. package/kernel/licenses/serde_derive_internals-0.30.0-LICENSE-MIT +23 -0
  117. package/kernel/licenses/serde_json-1.0.154-LICENSE-APACHE +176 -0
  118. package/kernel/licenses/serde_json-1.0.154-LICENSE-MIT +23 -0
  119. package/kernel/licenses/sha2-0.10.9-LICENSE-APACHE +201 -0
  120. package/kernel/licenses/sha2-0.10.9-LICENSE-MIT +27 -0
  121. package/kernel/licenses/simd-adler32-0.3.10-LICENSE.md +21 -0
  122. package/kernel/licenses/smallvec-1.16.4-LICENSE-APACHE +201 -0
  123. package/kernel/licenses/smallvec-1.16.4-LICENSE-MIT +25 -0
  124. package/kernel/licenses/solidcore-1.0.1-LICENSE +203 -0
  125. package/kernel/licenses/solidcore-1.0.1-NOTICE +30 -0
  126. package/kernel/licenses/solidcore-ATTRIBUTION.md +92 -0
  127. package/kernel/licenses/solidcore-LICENSE +203 -0
  128. package/kernel/licenses/solidcore-NOTICE +30 -0
  129. package/kernel/licenses/solidcore-convert-0.1.0-ATTRIBUTION.md +92 -0
  130. package/kernel/licenses/solidcore-convert-0.1.0-LICENSE +203 -0
  131. package/kernel/licenses/solidcore-convert-0.1.0-NOTICE +30 -0
  132. package/kernel/licenses/solidcore-record-0.1.0-ATTRIBUTION.md +92 -0
  133. package/kernel/licenses/solidcore-record-0.1.0-LICENSE +203 -0
  134. package/kernel/licenses/solidcore-record-0.1.0-NOTICE +30 -0
  135. package/kernel/licenses/solidcore-tess-0.1.0-ATTRIBUTION.md +92 -0
  136. package/kernel/licenses/solidcore-tess-0.1.0-LICENSE +203 -0
  137. package/kernel/licenses/solidcore-tess-0.1.0-NOTICE +30 -0
  138. package/kernel/licenses/spade-2.15.1-LICENSE-APACHE +202 -0
  139. package/kernel/licenses/spade-2.15.1-LICENSE-MIT +25 -0
  140. package/kernel/licenses/step-brep-0.1.0-ATTRIBUTION.md +92 -0
  141. package/kernel/licenses/step-brep-0.1.0-LICENSE +203 -0
  142. package/kernel/licenses/step-brep-0.1.0-NOTICE +30 -0
  143. package/kernel/licenses/step-export-0.1.0-ATTRIBUTION.md +92 -0
  144. package/kernel/licenses/step-export-0.1.0-LICENSE +203 -0
  145. package/kernel/licenses/step-export-0.1.0-NOTICE +30 -0
  146. package/kernel/licenses/step-import-0.1.0-ATTRIBUTION.md +92 -0
  147. package/kernel/licenses/step-import-0.1.0-LICENSE +203 -0
  148. package/kernel/licenses/step-import-0.1.0-NOTICE +30 -0
  149. package/kernel/licenses/syn-3.0.9-LICENSE-APACHE +176 -0
  150. package/kernel/licenses/syn-3.0.9-LICENSE-MIT +23 -0
  151. package/kernel/licenses/thiserror-2.0.21-LICENSE-APACHE +176 -0
  152. package/kernel/licenses/thiserror-2.0.21-LICENSE-MIT +23 -0
  153. package/kernel/licenses/thiserror-impl-2.0.21-LICENSE-APACHE +176 -0
  154. package/kernel/licenses/thiserror-impl-2.0.21-LICENSE-MIT +23 -0
  155. package/kernel/licenses/typenum-1.20.1-LICENSE +1 -0
  156. package/kernel/licenses/typenum-1.20.1-LICENSE-APACHE +201 -0
  157. package/kernel/licenses/typenum-1.20.1-LICENSE-MIT +21 -0
  158. package/kernel/licenses/unicode-ident-1.0.27-LICENSE-APACHE +176 -0
  159. package/kernel/licenses/unicode-ident-1.0.27-LICENSE-MIT +23 -0
  160. package/kernel/licenses/unicode-ident-1.0.27-LICENSE-UNICODE +39 -0
  161. package/kernel/licenses/version_check-0.9.5-LICENSE-APACHE +201 -0
  162. package/kernel/licenses/version_check-0.9.5-LICENSE-MIT +19 -0
  163. package/kernel/licenses/zlib-rs-0.6.8-LICENSE +19 -0
  164. package/kernel/licenses/zmij-1.0.23-LICENSE-MIT +23 -0
  165. package/kernel/native/darwin-arm64/agent-cad +4 -0
  166. package/kernel/native/darwin-arm64/manifest.json +6 -0
  167. package/kernel/native/linux-arm64/agent-cad +4 -0
  168. package/kernel/native/linux-arm64/manifest.json +6 -0
  169. package/kernel/native/linux-x64/agent-cad +4 -0
  170. package/kernel/native/linux-x64/manifest.json +6 -0
  171. package/kernel/release.json +8 -0
  172. package/kernel/schemas/model.schema.json +4080 -0
  173. package/package.json +59 -4
  174. package/scripts/check-release.mjs +24 -0
  175. package/skills/colocad/SKILL.md +17 -0
  176. package/skills/colocad/assets/angle-bracket.json +39 -0
  177. package/skills/colocad/assets/ball.json +16 -0
  178. package/skills/colocad/assets/block.json +18 -0
  179. package/skills/colocad/assets/open-housing.json +35 -0
  180. package/skills/colocad/assets/pin.json +18 -0
  181. package/skills/colocad/assets/plate-grid.json +34 -0
  182. package/skills/colocad/assets/sleeve.json +19 -0
  183. package/skills/colocad/assets/taper.json +20 -0
  184. package/skills/colocad/references/quick-build.md +44 -0
  185. package/skills/colocad/scripts/assembly.mjs +3 -0
  186. package/skills/colocad/scripts/build.mjs +54 -0
  187. package/solidworks/managed/Colocad.SolidWorks.deps.json +23 -0
  188. package/solidworks/managed/Colocad.SolidWorks.dll +0 -0
  189. package/solidworks/managed/Colocad.SolidWorks.runtimeconfig.json +13 -0
  190. package/src/build.mjs +69 -0
  191. package/src/index.d.mts +67 -0
  192. package/src/index.mjs +4 -0
  193. package/src/solidworks.mjs +65 -0
  194. package/src/tree.mjs +199 -0
@@ -0,0 +1,103 @@
1
+ import { open, readFile, writeFile, link, unlink } from 'node:fs/promises';
2
+ import { randomUUID, createHash } from 'node:crypto';
3
+ import { dirname, basename, extname, join } from 'node:path';
4
+ import { attachStep } from './assets.js';
5
+ const limit = 32 * 1024 * 1024;
6
+ const marker = '/* AGENT_CAD_IR_1 ';
7
+ const hash = (s) => createHash('sha256').update(s).digest('hex');
8
+ function requireData(r) { if (!r.ok)
9
+ throw Object.assign(Error(r.error.message), { code: r.error.code }); return r.data; }
10
+ const unsupported = (path) => Object.assign(Error('No local CAD file codec for ' + extname(path)), { code: 'UNSUPPORTED_FILE_FORMAT' });
11
+ async function bounded(path) {
12
+ const fd = await open(path, 'r');
13
+ try {
14
+ const s = await fd.stat();
15
+ if (!s.isFile() || s.size > limit)
16
+ throw Error('CAD input must be a regular file up to 32 MiB');
17
+ const bytes = await fd.readFile();
18
+ if (bytes.length > limit)
19
+ throw Error('CAD file grew beyond its budget');
20
+ return bytes;
21
+ }
22
+ finally {
23
+ await fd.close();
24
+ }
25
+ }
26
+ /** Paths belong to the Harness in the current sandbox. Foreign STEP geometry is imported as an asset. */
27
+ export async function readModelFile(cad, path) {
28
+ const ext = extname(path).toLowerCase();
29
+ if (!['.json', '.step', '.stp'].includes(ext))
30
+ throw unsupported(path);
31
+ const raw = (await bounded(path)).toString('utf8');
32
+ let model;
33
+ if (ext === '.json') {
34
+ model = JSON.parse(raw);
35
+ }
36
+ else {
37
+ if (!/^\s*ISO-10303-21;/i.test(raw))
38
+ throw Error('invalid STEP exchange header');
39
+ const start = raw.indexOf(marker);
40
+ if (start < 0) {
41
+ const id = 'source_part';
42
+ const seed = attachStep({ version: 1, units: 'mm', parameters: {}, features: [], output: '' }, id, raw);
43
+ const inspected = requireData(await cad.inspectStep(seed, id));
44
+ model = { ...inspected.model_template, assets: seed.assets };
45
+ }
46
+ else {
47
+ const end = raw.indexOf(' */\n', start);
48
+ if (end < 0 || raw.indexOf(marker, start + marker.length) >= 0)
49
+ throw Error('invalid embedded model record');
50
+ const fields = raw.slice(start + marker.length, end).split(' ');
51
+ if (fields.length !== 3)
52
+ throw Error('invalid embedded model fields');
53
+ const [stepHash, sourceHash, encoded] = fields;
54
+ const step = raw.slice(0, start) + raw.slice(end + 4);
55
+ const source = Buffer.from(encoded, 'base64');
56
+ if (hash(step) !== stepHash || hash(source) !== sourceHash || source.toString('base64') !== encoded)
57
+ throw Error('embedded model or STEP digest mismatch');
58
+ model = JSON.parse(source.toString('utf8'));
59
+ }
60
+ }
61
+ requireData(await cad.validate(model));
62
+ return model;
63
+ }
64
+ async function publish(path, bytes) {
65
+ const temp = join(dirname(path), '.' + basename(path) + '.' + randomUUID() + '.tmp');
66
+ try {
67
+ await writeFile(temp, bytes, { flag: 'wx', mode: 0o600 });
68
+ await link(temp, path);
69
+ }
70
+ finally {
71
+ await unlink(temp).catch(e => { if (e.code !== 'ENOENT')
72
+ throw e; });
73
+ }
74
+ }
75
+ /** Export a new file. A STEP with embedModel=true can be reopened and edited from that single file. */
76
+ export async function writeModelFile(cad, model, path, options = {}) {
77
+ const ext = extname(path).toLowerCase();
78
+ const names = { '.json': 'model.json', '.step': 'model.step', '.stp': 'model.step', '.glb': 'model.glb', '.stl': 'model.stl', '.png': 'preview.png' };
79
+ if (!Object.hasOwn(names, ext))
80
+ throw unsupported(path);
81
+ const preview = ['.png', '.stl', '.glb'].includes(ext);
82
+ const receipt = requireData(await cad.build(preview ? { ...model, preview: model.preview ?? {} } : model));
83
+ let bytes = await readFile(join(String(receipt.artifact_directory), names[ext]));
84
+ if (options.embedModel && ['.step', '.stp'].includes(ext)) {
85
+ const step = bytes.toString('utf8'), source = Buffer.from(JSON.stringify(model), 'utf8');
86
+ const first = step.indexOf('\n') + 1;
87
+ if (!first)
88
+ throw Error('invalid STEP output header');
89
+ const comment = marker + hash(bytes) + ' ' + hash(source) + ' ' + source.toString('base64') + ' */\n';
90
+ bytes = Buffer.from(step.slice(0, first) + comment + step.slice(first));
91
+ }
92
+ if (bytes.length > limit)
93
+ throw Error('file exceeds 32 MiB');
94
+ await publish(path, bytes);
95
+ return { path, bytes: bytes.length, sha256: hash(bytes), model_hash: String(receipt.model_hash) };
96
+ }
97
+ export async function editModelFile(cad, source, parameters, destination) {
98
+ const model = await readModelFile(cad, source);
99
+ for (const [key, value] of Object.entries(parameters))
100
+ if (!Object.hasOwn(model.parameters, key) || !Number.isFinite(value))
101
+ throw Error('unknown or nonfinite parameter: ' + key);
102
+ return writeModelFile(cad, { ...model, parameters: { ...model.parameters, ...parameters } }, destination, { embedModel: true });
103
+ }