@coloopx/colocad 0.1.0-alpha.5 → 0.1.0-alpha.7
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/CHANGELOG.md +44 -0
- package/README.md +115 -172
- package/README.zh-CN.md +118 -125
- package/bin/colocad.mjs +17 -9
- package/docs/README.md +10 -3
- package/docs/README.zh-CN.md +11 -2
- package/docs/agent-modeling-handbook.md +1 -1
- package/docs/agent-modeling-handbook.zh-CN.md +2 -2
- package/docs/api.md +9 -6
- package/docs/engineering-queries.md +122 -0
- package/docs/engineering-queries.zh-CN.md +74 -0
- package/docs/getting-started.md +1 -1
- package/docs/integrations/claude-code.md +1 -1
- package/docs/integrations/codex.md +1 -1
- package/docs/integrations/pi.md +17 -4
- package/docs/integrations/verification.md +7 -1
- package/docs/native-solidworks.md +12 -0
- package/docs/performance.md +62 -0
- package/examples/integrations/README.md +11 -2
- package/examples/integrations/compact-tools.mjs +1 -1
- package/kernel/dist/client.d.ts +5 -2
- package/kernel/dist/client.js +35 -7
- package/kernel/dist/generated.d.ts +297 -4
- package/kernel/dist/process.d.ts +1 -1
- package/kernel/dist/process.js +3 -3
- package/kernel/dist/query-generated.d.ts +181 -0
- package/kernel/dist/query-generated.js +1 -0
- package/kernel/dist/tools.d.ts +35 -0
- package/kernel/dist/tools.js +11 -2
- package/kernel/dist/types.d.ts +9 -0
- package/kernel/native/darwin-arm64/agent-cad +2 -2
- package/kernel/native/darwin-arm64/manifest.json +2 -2
- package/kernel/native/linux-arm64/agent-cad +2 -2
- package/kernel/native/linux-arm64/manifest.json +2 -2
- package/kernel/native/linux-x64/agent-cad +2 -2
- package/kernel/native/linux-x64/manifest.json +2 -2
- package/kernel/release.json +4 -4
- package/kernel/schemas/model.schema.json +1752 -135
- package/kernel/schemas/query.schema.json +1150 -0
- package/package.json +5 -2
- package/skills/colocad/references/tool-contracts.md +14 -2
- package/src/build.mjs +3 -2
- package/src/index.d.mts +2 -1
- package/src/session.d.mts +5 -3
- package/src/session.mjs +26 -10
- package/viewer/dist/index.js +179 -179
- package/viewer/dist/standalone.js +179 -179
- package/viewer/index.d.ts +2 -1
package/kernel/dist/tools.d.ts
CHANGED
|
@@ -8,6 +8,20 @@ export declare function createCadTools(client: CadClient): Promise<({
|
|
|
8
8
|
additionalProperties: boolean;
|
|
9
9
|
};
|
|
10
10
|
execute: () => Promise<Receipt>;
|
|
11
|
+
} | {
|
|
12
|
+
name: string;
|
|
13
|
+
description: string;
|
|
14
|
+
inputSchema: {
|
|
15
|
+
type: string;
|
|
16
|
+
properties: Record<string, unknown>;
|
|
17
|
+
required: string[];
|
|
18
|
+
additionalProperties: boolean;
|
|
19
|
+
$defs: unknown;
|
|
20
|
+
};
|
|
21
|
+
execute: (a: {
|
|
22
|
+
model: Model;
|
|
23
|
+
options?: import("./types.js").BuildOptions;
|
|
24
|
+
}) => Promise<Receipt>;
|
|
11
25
|
} | {
|
|
12
26
|
name: string;
|
|
13
27
|
description: string;
|
|
@@ -64,4 +78,25 @@ export declare function createCadTools(client: CadClient): Promise<({
|
|
|
64
78
|
model: Model;
|
|
65
79
|
parameters: Record<string, number>;
|
|
66
80
|
}) => Promise<Receipt>;
|
|
81
|
+
} | {
|
|
82
|
+
name: string;
|
|
83
|
+
description: string;
|
|
84
|
+
inputSchema: {
|
|
85
|
+
type: string;
|
|
86
|
+
properties: {
|
|
87
|
+
artifact_directory: {
|
|
88
|
+
type: string;
|
|
89
|
+
};
|
|
90
|
+
request: {
|
|
91
|
+
[x: string]: unknown;
|
|
92
|
+
};
|
|
93
|
+
};
|
|
94
|
+
required: string[];
|
|
95
|
+
additionalProperties: boolean;
|
|
96
|
+
$defs: unknown;
|
|
97
|
+
};
|
|
98
|
+
execute: (a: {
|
|
99
|
+
artifact_directory: string;
|
|
100
|
+
request: import("./types.js").QueryRequest;
|
|
101
|
+
}) => Promise<Receipt>;
|
|
67
102
|
})[]>;
|
package/kernel/dist/tools.js
CHANGED
|
@@ -8,13 +8,22 @@ export async function createCadTools(client) {
|
|
|
8
8
|
// JSON Schema references resolve from the tool root, so lift definitions with it.
|
|
9
9
|
const { $defs, $schema, ...modelBody } = modelSchema;
|
|
10
10
|
const object = (properties, required) => ({ type: 'object', properties, required, additionalProperties: false, $defs });
|
|
11
|
-
|
|
11
|
+
const tools = [
|
|
12
12
|
{ name: 'cad_capabilities', description: '查询当前内核、操作、预算与未实现能力。', inputSchema: { type: 'object', properties: {}, additionalProperties: false }, execute: () => client.capabilities() },
|
|
13
13
|
{ name: 'cad_validate', description: '低成本检查参数、特征依赖和预算;不执行几何验证。', inputSchema: object({ model: modelBody }, ['model']), execute: (a) => client.validate(a.model) },
|
|
14
|
-
{ name: 'cad_build', description: '生成新的不可变版本,执行几何检查,返回体积、尺寸、逐特征耗时与 STEP
|
|
14
|
+
{ name: 'cad_build', description: '生成新的不可变版本,执行几何检查,返回体积、尺寸、逐特征耗时与 STEP 工件目录。queryable 保存精确查询快照。默认失败明确报错;只有模型显式允许 on_fail:record 才记录降级。', inputSchema: object({ model: modelBody, options: { type: 'object', properties: { queryable: { type: 'boolean' } }, additionalProperties: false } }, ['model']), execute: (a) => client.build(a.model, a.options) },
|
|
15
15
|
{ name: 'cad_preview', description: '输出 PNG、GLB 和 STL;相同模型、姿态和精度复用已校验网格,切换视角或图像尺寸不重建。改参按特征依赖复用检查点;section 可按世界坐标平面剖视。精确检查使用 B-rep。', inputSchema: object({ model: modelBody, options: { $ref: '#/$defs/PreviewOptions' } }, ['model']), execute: (a) => client.preview(a.model, a.options) },
|
|
16
16
|
{ name: 'cad_solve_sketch', description: '求解参数草图,返回局部自由度、冗余方程及每条约束残差。未声明的欠约束和冲突会失败。', inputSchema: object({ sketch: { $ref: '#/$defs/Sketch' }, parameters: { type: 'object', additionalProperties: { type: 'number' } } }, ['sketch']), execute: (a) => client.solveSketch(a.sketch, a.parameters) },
|
|
17
17
|
{ name: 'cad_inspect_step', description: '解析已登记 STEP 的产品树、共享零件定义和变换,返回可重建模型模板。使用原 model.assets 构建模板;不缩放组件。', inputSchema: object({ model: modelBody, asset: { type: 'string' } }, ['model', 'asset']), execute: (a) => client.inspectStep(a.model, a.asset) },
|
|
18
18
|
{ name: 'cad_edit', description: '修改已有尺寸参数,按依赖重新计算受影响的特征,返回新版本。', inputSchema: object({ model: modelBody, parameters: { type: 'object', additionalProperties: { type: 'number' } } }, ['model', 'parameters']), execute: (a) => client.edit(a.model, a.parameters) }
|
|
19
19
|
];
|
|
20
|
+
const capabilities = await client.capabilities();
|
|
21
|
+
if (capabilities.ok && capabilities.data.query?.schema === 'colocad.query/1') {
|
|
22
|
+
const schema = await client.querySchema();
|
|
23
|
+
if (!schema.ok)
|
|
24
|
+
throw Error(schema.error.message);
|
|
25
|
+
const { $defs: queryDefs, $schema: querySchema, ...request } = schema.data;
|
|
26
|
+
return [...tools, { name: 'cad_query', description: '查询已保存的精确几何:有界选择、拓扑/基准、孔组/安装接口与整零件关系测量;保留歧义和 partial 诊断。必须提供预期 query_revision_id;不重建、不改模型。路径受宿主允许的工件目录约束。', inputSchema: { type: 'object', properties: { artifact_directory: { type: 'string' }, request }, required: ['artifact_directory', 'request'], additionalProperties: false, $defs: queryDefs }, execute: (a) => client.query(a.artifact_directory, a.request) }];
|
|
27
|
+
}
|
|
28
|
+
return tools;
|
|
20
29
|
}
|
package/kernel/dist/types.d.ts
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
export type * from './generated.js';
|
|
2
|
+
export type { Request as QueryRequest, TopologyRef, Selection, Filter as QueryFilter, Derive as DatumDerivation } from './query-generated.js';
|
|
2
3
|
import type { Scalar } from './generated.js';
|
|
3
4
|
export type V2 = [Scalar, Scalar];
|
|
4
5
|
export type V3 = [Scalar, Scalar, Scalar];
|
|
@@ -11,6 +12,8 @@ export type Receipt = {
|
|
|
11
12
|
code: string;
|
|
12
13
|
message: string;
|
|
13
14
|
feature_id?: string | null;
|
|
15
|
+
query_id?: string;
|
|
16
|
+
details?: Record<string, unknown>;
|
|
14
17
|
};
|
|
15
18
|
};
|
|
16
19
|
export type Runner = {
|
|
@@ -21,6 +24,12 @@ export interface Config {
|
|
|
21
24
|
outputRoot: string;
|
|
22
25
|
binary?: string;
|
|
23
26
|
wallMs?: number;
|
|
27
|
+
/** Host-owned allowlist for querying reopened artifacts; defaults to outputRoot. */
|
|
28
|
+
queryRoots?: string[];
|
|
24
29
|
/** @deprecated 0.4 local binary configuration. */
|
|
25
30
|
runner?: Runner;
|
|
26
31
|
}
|
|
32
|
+
export interface BuildOptions {
|
|
33
|
+
queryable?: boolean;
|
|
34
|
+
previousRevision?: string;
|
|
35
|
+
}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
1
|
[diffend] Oversized file quarantined before diffing.
|
|
2
2
|
name: package/kernel/native/darwin-arm64/agent-cad
|
|
3
|
-
size:
|
|
4
|
-
sha256:
|
|
3
|
+
size: 37821120 bytes
|
|
4
|
+
sha256: 5e58552f359106ab8f9368b259dd9af514f77cfe493993002d815635ec8b75b4
|
|
@@ -1,4 +1,4 @@
|
|
|
1
1
|
[diffend] Oversized file quarantined before diffing.
|
|
2
2
|
name: package/kernel/native/linux-arm64/agent-cad
|
|
3
|
-
size:
|
|
4
|
-
sha256:
|
|
3
|
+
size: 37360456 bytes
|
|
4
|
+
sha256: cc7a2b5d68b71d3a787838c9b35d721febfaafcdb4d648dbe6b920f9a900c8fc
|
|
@@ -1,4 +1,4 @@
|
|
|
1
1
|
[diffend] Oversized file quarantined before diffing.
|
|
2
2
|
name: package/kernel/native/linux-x64/agent-cad
|
|
3
|
-
size:
|
|
4
|
-
sha256:
|
|
3
|
+
size: 48544488 bytes
|
|
4
|
+
sha256: be4bbfff19711b59afcdf4c6c9257f16e31a9c6e0504f4c877fe16e567739c7f
|
package/kernel/release.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
|
-
"version": "0.1.0-alpha.
|
|
2
|
+
"version": "0.1.0-alpha.7",
|
|
3
3
|
"sha256": {
|
|
4
|
-
"darwin-arm64": "
|
|
5
|
-
"linux-arm64": "
|
|
6
|
-
"linux-x64": "
|
|
4
|
+
"darwin-arm64": "5e58552f359106ab8f9368b259dd9af514f77cfe493993002d815635ec8b75b4",
|
|
5
|
+
"linux-arm64": "cc7a2b5d68b71d3a787838c9b35d721febfaafcdb4d648dbe6b920f9a900c8fc",
|
|
6
|
+
"linux-x64": "be4bbfff19711b59afcdf4c6c9257f16e31a9c6e0504f4c877fe16e567739c7f"
|
|
7
7
|
}
|
|
8
8
|
}
|