@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.
- package/LICENSE +21 -0
- package/NOTICE.md +5 -0
- package/README.md +131 -2
- package/README.zh-CN.md +100 -0
- package/bin/colocad.mjs +32 -0
- package/examples/manifold.json +11 -0
- package/examples/sensor-rail.json +9 -0
- package/kernel/LICENSE +21 -0
- package/kernel/dist/artifacts.d.ts +3 -0
- package/kernel/dist/artifacts.js +19 -0
- package/kernel/dist/assets.d.ts +3 -0
- package/kernel/dist/assets.js +11 -0
- package/kernel/dist/binary.d.ts +2 -0
- package/kernel/dist/binary.js +14 -0
- package/kernel/dist/client.d.ts +22 -0
- package/kernel/dist/client.js +99 -0
- package/kernel/dist/files.d.ts +19 -0
- package/kernel/dist/files.js +103 -0
- package/kernel/dist/generated.d.ts +707 -0
- package/kernel/dist/generated.js +1 -0
- package/kernel/dist/helpers.d.ts +9 -0
- package/kernel/dist/helpers.js +23 -0
- package/kernel/dist/index.d.ts +8 -0
- package/kernel/dist/index.js +6 -0
- package/kernel/dist/preview-cache.d.ts +19 -0
- package/kernel/dist/preview-cache.js +29 -0
- package/kernel/dist/process.d.ts +12 -0
- package/kernel/dist/process.js +41 -0
- package/kernel/dist/tools.d.ts +67 -0
- package/kernel/dist/tools.js +20 -0
- package/kernel/dist/types.d.ts +26 -0
- package/kernel/dist/types.js +1 -0
- package/kernel/licenses/adler2-2.0.1-LICENSE-0BSD +12 -0
- package/kernel/licenses/adler2-2.0.1-LICENSE-APACHE +201 -0
- package/kernel/licenses/adler2-2.0.1-LICENSE-MIT +23 -0
- package/kernel/licenses/allocator-api2-0.2.21-LICENSE-APACHE +176 -0
- package/kernel/licenses/allocator-api2-0.2.21-LICENSE-MIT +23 -0
- package/kernel/licenses/autocfg-1.5.1-LICENSE-APACHE +201 -0
- package/kernel/licenses/autocfg-1.5.1-LICENSE-MIT +25 -0
- package/kernel/licenses/bitflags-1.3.2-LICENSE-APACHE +201 -0
- package/kernel/licenses/bitflags-1.3.2-LICENSE-MIT +25 -0
- package/kernel/licenses/block-buffer-0.10.4-LICENSE-APACHE +201 -0
- package/kernel/licenses/block-buffer-0.10.4-LICENSE-MIT +25 -0
- package/kernel/licenses/cfg-if-1.0.5-LICENSE-APACHE +201 -0
- package/kernel/licenses/cfg-if-1.0.5-LICENSE-MIT +25 -0
- package/kernel/licenses/cpufeatures-0.2.17-LICENSE-APACHE +201 -0
- package/kernel/licenses/cpufeatures-0.2.17-LICENSE-MIT +25 -0
- package/kernel/licenses/crc32fast-1.5.4-LICENSE-APACHE +202 -0
- package/kernel/licenses/crc32fast-1.5.4-LICENSE-MIT +21 -0
- package/kernel/licenses/crossbeam-deque-0.8.8-LICENSE-APACHE +201 -0
- package/kernel/licenses/crossbeam-deque-0.8.8-LICENSE-MIT +27 -0
- package/kernel/licenses/crossbeam-epoch-0.9.21-LICENSE-APACHE +201 -0
- package/kernel/licenses/crossbeam-epoch-0.9.21-LICENSE-MIT +27 -0
- package/kernel/licenses/crossbeam-utils-0.8.23-LICENSE-APACHE +201 -0
- package/kernel/licenses/crossbeam-utils-0.8.23-LICENSE-MIT +27 -0
- package/kernel/licenses/crypto-common-0.1.7-LICENSE-APACHE +201 -0
- package/kernel/licenses/crypto-common-0.1.7-LICENSE-MIT +25 -0
- package/kernel/licenses/dependencies.json +618 -0
- package/kernel/licenses/digest-0.10.7-LICENSE-APACHE +201 -0
- package/kernel/licenses/digest-0.10.7-LICENSE-MIT +25 -0
- package/kernel/licenses/dyn-clone-1.0.20-LICENSE-APACHE +176 -0
- package/kernel/licenses/dyn-clone-1.0.20-LICENSE-MIT +23 -0
- package/kernel/licenses/either-1.19.0-LICENSE-APACHE +201 -0
- package/kernel/licenses/either-1.19.0-LICENSE-MIT +25 -0
- package/kernel/licenses/equivalent-1.0.3-LICENSE-APACHE +201 -0
- package/kernel/licenses/equivalent-1.0.3-LICENSE-MIT +25 -0
- package/kernel/licenses/fdeflate-0.3.7-LICENSE-APACHE +177 -0
- package/kernel/licenses/fdeflate-0.3.7-LICENSE-MIT +25 -0
- package/kernel/licenses/flate2-1.1.10-LICENSE-APACHE +201 -0
- package/kernel/licenses/flate2-1.1.10-LICENSE-MIT +25 -0
- package/kernel/licenses/foldhash-0.2.0-LICENSE +19 -0
- package/kernel/licenses/generic-array-0.14.7-LICENSE +21 -0
- package/kernel/licenses/hashbrown-0.16.1-LICENSE-APACHE +201 -0
- package/kernel/licenses/hashbrown-0.16.1-LICENSE-MIT +25 -0
- package/kernel/licenses/itoa-1.0.18-LICENSE-APACHE +176 -0
- package/kernel/licenses/itoa-1.0.18-LICENSE-MIT +23 -0
- package/kernel/licenses/libc-0.2.191-LICENSE-APACHE +176 -0
- package/kernel/licenses/libc-0.2.191-LICENSE-MIT +25 -0
- package/kernel/licenses/memchr-2.8.3-COPYING +3 -0
- package/kernel/licenses/memchr-2.8.3-LICENSE-MIT +21 -0
- package/kernel/licenses/miniz_oxide-0.8.9-LICENSE +25 -0
- package/kernel/licenses/miniz_oxide-0.8.9-LICENSE-APACHE.md +177 -0
- package/kernel/licenses/miniz_oxide-0.8.9-LICENSE-MIT.md +24 -0
- package/kernel/licenses/miniz_oxide-0.8.9-LICENSE-ZLIB.md +14 -0
- package/kernel/licenses/miniz_oxide-0.9.1-LICENSE +25 -0
- package/kernel/licenses/miniz_oxide-0.9.1-LICENSE-APACHE.md +177 -0
- package/kernel/licenses/miniz_oxide-0.9.1-LICENSE-MIT.md +24 -0
- package/kernel/licenses/miniz_oxide-0.9.1-LICENSE-ZLIB.md +14 -0
- package/kernel/licenses/num-traits-0.2.19-LICENSE-APACHE +201 -0
- package/kernel/licenses/num-traits-0.2.19-LICENSE-MIT +25 -0
- package/kernel/licenses/png-0.17.16-LICENSE-APACHE +201 -0
- package/kernel/licenses/png-0.17.16-LICENSE-MIT +25 -0
- package/kernel/licenses/proc-macro2-1.0.107-LICENSE-APACHE +176 -0
- package/kernel/licenses/proc-macro2-1.0.107-LICENSE-MIT +23 -0
- package/kernel/licenses/quote-1.0.47-LICENSE-APACHE +176 -0
- package/kernel/licenses/quote-1.0.47-LICENSE-MIT +23 -0
- package/kernel/licenses/rayon-1.12.0-LICENSE-APACHE +201 -0
- package/kernel/licenses/rayon-1.12.0-LICENSE-MIT +25 -0
- package/kernel/licenses/rayon-core-1.13.0-LICENSE-APACHE +201 -0
- package/kernel/licenses/rayon-core-1.13.0-LICENSE-MIT +25 -0
- package/kernel/licenses/ref-cast-1.0.27-LICENSE-APACHE +176 -0
- package/kernel/licenses/ref-cast-1.0.27-LICENSE-MIT +23 -0
- package/kernel/licenses/ref-cast-impl-1.0.27-LICENSE-APACHE +176 -0
- package/kernel/licenses/ref-cast-impl-1.0.27-LICENSE-MIT +23 -0
- package/kernel/licenses/robust-1.2.0-LICENSE-APACHE +201 -0
- package/kernel/licenses/robust-1.2.0-LICENSE-MIT +26 -0
- package/kernel/licenses/schemars-1.2.3-LICENSE +21 -0
- package/kernel/licenses/schemars_derive-1.2.3-LICENSE +21 -0
- package/kernel/licenses/serde-1.0.229-LICENSE-APACHE +176 -0
- package/kernel/licenses/serde-1.0.229-LICENSE-MIT +23 -0
- package/kernel/licenses/serde_core-1.0.229-LICENSE-APACHE +176 -0
- package/kernel/licenses/serde_core-1.0.229-LICENSE-MIT +23 -0
- package/kernel/licenses/serde_derive-1.0.229-LICENSE-APACHE +176 -0
- package/kernel/licenses/serde_derive-1.0.229-LICENSE-MIT +23 -0
- package/kernel/licenses/serde_derive_internals-0.30.0-LICENSE-APACHE +176 -0
- package/kernel/licenses/serde_derive_internals-0.30.0-LICENSE-MIT +23 -0
- package/kernel/licenses/serde_json-1.0.154-LICENSE-APACHE +176 -0
- package/kernel/licenses/serde_json-1.0.154-LICENSE-MIT +23 -0
- package/kernel/licenses/sha2-0.10.9-LICENSE-APACHE +201 -0
- package/kernel/licenses/sha2-0.10.9-LICENSE-MIT +27 -0
- package/kernel/licenses/simd-adler32-0.3.10-LICENSE.md +21 -0
- package/kernel/licenses/smallvec-1.16.4-LICENSE-APACHE +201 -0
- package/kernel/licenses/smallvec-1.16.4-LICENSE-MIT +25 -0
- package/kernel/licenses/solidcore-1.0.1-LICENSE +203 -0
- package/kernel/licenses/solidcore-1.0.1-NOTICE +30 -0
- package/kernel/licenses/solidcore-ATTRIBUTION.md +92 -0
- package/kernel/licenses/solidcore-LICENSE +203 -0
- package/kernel/licenses/solidcore-NOTICE +30 -0
- package/kernel/licenses/solidcore-convert-0.1.0-ATTRIBUTION.md +92 -0
- package/kernel/licenses/solidcore-convert-0.1.0-LICENSE +203 -0
- package/kernel/licenses/solidcore-convert-0.1.0-NOTICE +30 -0
- package/kernel/licenses/solidcore-record-0.1.0-ATTRIBUTION.md +92 -0
- package/kernel/licenses/solidcore-record-0.1.0-LICENSE +203 -0
- package/kernel/licenses/solidcore-record-0.1.0-NOTICE +30 -0
- package/kernel/licenses/solidcore-tess-0.1.0-ATTRIBUTION.md +92 -0
- package/kernel/licenses/solidcore-tess-0.1.0-LICENSE +203 -0
- package/kernel/licenses/solidcore-tess-0.1.0-NOTICE +30 -0
- package/kernel/licenses/spade-2.15.1-LICENSE-APACHE +202 -0
- package/kernel/licenses/spade-2.15.1-LICENSE-MIT +25 -0
- package/kernel/licenses/step-brep-0.1.0-ATTRIBUTION.md +92 -0
- package/kernel/licenses/step-brep-0.1.0-LICENSE +203 -0
- package/kernel/licenses/step-brep-0.1.0-NOTICE +30 -0
- package/kernel/licenses/step-export-0.1.0-ATTRIBUTION.md +92 -0
- package/kernel/licenses/step-export-0.1.0-LICENSE +203 -0
- package/kernel/licenses/step-export-0.1.0-NOTICE +30 -0
- package/kernel/licenses/step-import-0.1.0-ATTRIBUTION.md +92 -0
- package/kernel/licenses/step-import-0.1.0-LICENSE +203 -0
- package/kernel/licenses/step-import-0.1.0-NOTICE +30 -0
- package/kernel/licenses/syn-3.0.9-LICENSE-APACHE +176 -0
- package/kernel/licenses/syn-3.0.9-LICENSE-MIT +23 -0
- package/kernel/licenses/thiserror-2.0.21-LICENSE-APACHE +176 -0
- package/kernel/licenses/thiserror-2.0.21-LICENSE-MIT +23 -0
- package/kernel/licenses/thiserror-impl-2.0.21-LICENSE-APACHE +176 -0
- package/kernel/licenses/thiserror-impl-2.0.21-LICENSE-MIT +23 -0
- package/kernel/licenses/typenum-1.20.1-LICENSE +1 -0
- package/kernel/licenses/typenum-1.20.1-LICENSE-APACHE +201 -0
- package/kernel/licenses/typenum-1.20.1-LICENSE-MIT +21 -0
- package/kernel/licenses/unicode-ident-1.0.27-LICENSE-APACHE +176 -0
- package/kernel/licenses/unicode-ident-1.0.27-LICENSE-MIT +23 -0
- package/kernel/licenses/unicode-ident-1.0.27-LICENSE-UNICODE +39 -0
- package/kernel/licenses/version_check-0.9.5-LICENSE-APACHE +201 -0
- package/kernel/licenses/version_check-0.9.5-LICENSE-MIT +19 -0
- package/kernel/licenses/zlib-rs-0.6.8-LICENSE +19 -0
- package/kernel/licenses/zmij-1.0.23-LICENSE-MIT +23 -0
- package/kernel/native/darwin-arm64/agent-cad +4 -0
- package/kernel/native/darwin-arm64/manifest.json +6 -0
- package/kernel/native/linux-arm64/agent-cad +4 -0
- package/kernel/native/linux-arm64/manifest.json +6 -0
- package/kernel/native/linux-x64/agent-cad +4 -0
- package/kernel/native/linux-x64/manifest.json +6 -0
- package/kernel/release.json +8 -0
- package/kernel/schemas/model.schema.json +4080 -0
- package/package.json +59 -4
- package/scripts/check-release.mjs +24 -0
- package/skills/colocad/SKILL.md +17 -0
- package/skills/colocad/assets/angle-bracket.json +39 -0
- package/skills/colocad/assets/ball.json +16 -0
- package/skills/colocad/assets/block.json +18 -0
- package/skills/colocad/assets/open-housing.json +35 -0
- package/skills/colocad/assets/pin.json +18 -0
- package/skills/colocad/assets/plate-grid.json +34 -0
- package/skills/colocad/assets/sleeve.json +19 -0
- package/skills/colocad/assets/taper.json +20 -0
- package/skills/colocad/references/quick-build.md +44 -0
- package/skills/colocad/scripts/assembly.mjs +3 -0
- package/skills/colocad/scripts/build.mjs +54 -0
- package/solidworks/managed/Colocad.SolidWorks.deps.json +23 -0
- package/solidworks/managed/Colocad.SolidWorks.dll +0 -0
- package/solidworks/managed/Colocad.SolidWorks.runtimeconfig.json +13 -0
- package/src/build.mjs +69 -0
- package/src/index.d.mts +67 -0
- package/src/index.mjs +4 -0
- package/src/solidworks.mjs +65 -0
- 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
|
+
}
|