cad-mcp-server 0.1.0

package/dist/cad/query/shared.js

@@ -0,0 +1,181 @@
+import { CAD_RESPONSE_SCHEMA_VERSION } from '../schema-version.js';
+import { normalizeVector, angleDegreesNormalized } from '../../utils/vectors.js';
+/**
+ * Shared query utilities for pagination, filtering, sorting, and response envelopes.
+ */
+export const DEFAULT_QUERY_LIMITS = {
+    limit: 100,
+    offset: 0,
+    sample_entity_limit: 5,
+    max_page_size: 1000,
+};
+/**
+ * Hardcoded bucket widths for continuous-value grouping.
+ * Single source of truth; the model does not control these.
+ */
+export const GROUP_BUCKETS = {
+    // Log-scale magnitude bins (mm or mm^2) for size dimensions.
+    // A value v falls in the first bin whose upper bound exceeds it.
+    magnitude_bins: [1, 10, 100, 1000, 10000],
+    // Round radius/diameter to this granularity (mm) to separate standard sizes
+    // while merging floating-point noise.
+    radius_step: 0.5,
+    // Faces/edges within this angle (degrees) of a principal axis snap to it.
+    axis_snap_degrees: 15,
+};
+/**
+ * Bucket a continuous magnitude (length, area, depth) into a labelled range
+ * using fixed log-scale bins. Returns a stable string key like "10-100".
+ */
+export function magnitudeBucketKey(value) {
+    const bins = GROUP_BUCKETS.magnitude_bins;
+    if (value < bins[0])
+        return `0-${bins[0]}`;
+    for (let i = 0; i < bins.length - 1; i++) {
+        if (value < bins[i + 1])
+            return `${bins[i]}-${bins[i + 1]}`;
+    }
+    return `${bins[bins.length - 1]}+`;
+}
+/**
+ * Bucket a radius or diameter by rounding to the nearest fixed step.
+ * Returns the rounded numeric value (used directly as the group key).
+ */
+export function radiusBucketValue(value) {
+    const step = GROUP_BUCKETS.radius_step;
+    return Math.round(value / step) * step;
+}
+/**
+ * Snap a direction vector to the nearest principal axis (+X..-Z) when within
+ * the axis-snap tolerance; otherwise return "off-axis". Keys are stable strings.
+ */
+export function axisDirectionKey(direction) {
+    const unit = normalizeVector(direction);
+    if (unit[0] === 0 && unit[1] === 0 && unit[2] === 0)
+        return 'undefined';
+    const axes = [
+        { key: '+X', vec: [1, 0, 0] },
+        { key: '-X', vec: [-1, 0, 0] },
+        { key: '+Y', vec: [0, 1, 0] },
+        { key: '-Y', vec: [0, -1, 0] },
+        { key: '+Z', vec: [0, 0, 1] },
+        { key: '-Z', vec: [0, 0, -1] },
+    ];
+    let best = 'off-axis';
+    let bestAngle = GROUP_BUCKETS.axis_snap_degrees;
+    for (const axis of axes) {
+        const angle = angleDegreesNormalized(unit, axis.vec);
+        if (angle <= bestAngle) {
+            bestAngle = angle;
+            best = axis.key;
+        }
+    }
+    return best;
+}
+/**
+ * Group entities deterministically by a composite key derived from each
+ * requested dimension. Groups are sorted by descending entity count, then by
+ * key for stable ordering. Each group includes bounded sample entity IDs.
+ */
+export function groupEntities(entities, dimensions, keyOf, sampleLimit, summarize) {
+    const buckets = new Map();
+    for (const entity of entities) {
+        const key = {};
+        for (const dimension of dimensions) {
+            key[dimension] = keyOf(entity, dimension);
+        }
+        const mapKey = JSON.stringify(dimensions.map((d) => key[d]));
+        let bucket = buckets.get(mapKey);
+        if (!bucket) {
+            bucket = { key, members: [] };
+            buckets.set(mapKey, bucket);
+        }
+        bucket.members.push(entity);
+    }
+    const groups = [...buckets.values()].map((bucket) => {
+        const ids = bucket.members.map((m) => m.id);
+        const { sampled, is_complete } = sampleEntityIds(ids, sampleLimit);
+        return {
+            key: bucket.key,
+            entity_count: bucket.members.length,
+            entity_ids: ids,
+            sample_entity_ids: sampled,
+            sample_entity_limit: sampleLimit,
+            sample_is_complete: is_complete,
+            summary: summarize ? summarize(bucket.members) : {},
+        };
+    });
+    // Deterministic ordering: largest groups first, then by key string.
+    groups.sort((a, b) => {
+        if (b.entity_count !== a.entity_count)
+            return b.entity_count - a.entity_count;
+        return JSON.stringify(a.key).localeCompare(JSON.stringify(b.key));
+    });
+    return groups.map((group, i) => ({ id: `group:${i}`, ...group }));
+}
+export function normalizePagination(limit, offset) {
+    return {
+        limit: limit ?? DEFAULT_QUERY_LIMITS.limit,
+        offset: offset ?? DEFAULT_QUERY_LIMITS.offset,
+    };
+}
+export function createPagination(limit, offset, returned, total_matched) {
+    return {
+        limit,
+        offset,
+        returned,
+        total_matched,
+        has_more: offset + returned < total_matched,
+    };
+}
+export const STEP_QUERY_UNITS = {
+    length: 'mm',
+    area: 'mm^2',
+    volume: 'mm^3',
+    angle: 'deg',
+};
+export const STEP_QUERY_COORDINATE_SYSTEM = {
+    origin: 'STEP model origin',
+    axes: 'model coordinates',
+    handedness: 'right',
+};
+/**
+ * Build a query response envelope.
+ */
+export function createQueryResponse(file_path, query, pagination, entities, statistics, groups = [], warnings = [], limitations = []) {
+    return {
+        schema_version: CAD_RESPONSE_SCHEMA_VERSION,
+        file_path,
+        units: STEP_QUERY_UNITS,
+        coordinate_system: STEP_QUERY_COORDINATE_SYSTEM,
+        query,
+        statistics: statistics ?? {},
+        pagination,
+        entities,
+        groups: groups.map((g) => ({
+            id: g.id,
+            key: g.key,
+            entity_count: g.entity_count,
+            sample_entity_ids: g.sample_entity_ids,
+            sample_entity_limit: g.sample_entity_limit,
+            sample_is_complete: g.sample_is_complete,
+            summary: g.summary,
+        })),
+        warnings,
+        limitations,
+    };
+}
+/**
+ * Sample entity IDs from a larger set, deterministically.
+ */
+export function sampleEntityIds(entity_ids, sample_limit) {
+    if (sample_limit <= 0) {
+        return { sampled: [], is_complete: entity_ids.length === 0 };
+    }
+    const sampled = entity_ids.slice(0, sample_limit);
+    return {
+        sampled,
+        is_complete: sampled.length === entity_ids.length,
+    };
+}
+//# sourceMappingURL=shared.js.map

package/dist/cad/query/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/cad/query/shared.ts"],"names":[],"mappings":"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"}

package/dist/cad/schema-version.d.ts

@@ -0,0 +1,2 @@
+export declare const CAD_RESPONSE_SCHEMA_VERSION: "0.4";
+//# sourceMappingURL=schema-version.d.ts.map

package/dist/cad/schema-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-version.d.ts","sourceRoot":"","sources":["../../src/cad/schema-version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,EAAG,KAAc,CAAC"}

package/dist/cad/schema-version.js

@@ -0,0 +1,2 @@
+export const CAD_RESPONSE_SCHEMA_VERSION = '0.4';
+//# sourceMappingURL=schema-version.js.map

package/dist/cad/schema-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-version.js","sourceRoot":"","sources":["../../src/cad/schema-version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG,KAAc,CAAC"}

package/dist/compare.d.ts

@@ -0,0 +1,31 @@
+export declare function compareStepFiles(fileA: string, fileB: string): Promise<{
+    schema_version: "0.4";
+    files: {
+        a: string;
+        b: string;
+    };
+    deltas: {
+        dimensions: {
+            width: number;
+            height: number;
+            depth: number;
+        };
+        volume: number;
+        surfaceArea: number;
+        bodyCount: number;
+        faceCount: number | undefined;
+        edgeCount: number | undefined;
+    };
+    exchange: {
+        schemaChanged: boolean;
+        productNamesA: string[];
+        productNamesB: string[];
+    };
+    warnings: import("./types/schema.js").Warning[];
+    limitations: import("./types/schema.js").Limitation[];
+    providers: {
+        a: import("./types/schema.js").ProviderInfo[];
+        b: import("./types/schema.js").ProviderInfo[];
+    };
+}>;
+//# sourceMappingURL=compare.d.ts.map

package/dist/compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../src/compare.ts"],"names":[],"mappings":"AAGA,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDlE"}

package/dist/compare.js

@@ -0,0 +1,51 @@
+import { withStepModel } from './model-store.js';
+import { CAD_RESPONSE_SCHEMA_VERSION } from './schema-version.js';
+export async function compareStepFiles(fileA, fileB) {
+    return withStepModel(fileA, async (modelA) => withStepModel(fileB, async (modelB) => {
+        const [brepA, brepB, semanticA, semanticB] = await Promise.all([
+            modelA.getBRepModel(),
+            modelB.getBRepModel(),
+            modelA.getSemanticModel(),
+            modelB.getSemanticModel(),
+        ]);
+        return {
+            schema_version: CAD_RESPONSE_SCHEMA_VERSION,
+            files: { a: fileA, b: fileB },
+            deltas: {
+                dimensions: {
+                    width: brepB.dimensions.width - brepA.dimensions.width,
+                    height: brepB.dimensions.height - brepA.dimensions.height,
+                    depth: brepB.dimensions.depth - brepA.dimensions.depth,
+                },
+                volume: brepB.volume - brepA.volume,
+                surfaceArea: brepB.surfaceArea - brepA.surfaceArea,
+                bodyCount: brepB.bodyCount - brepA.bodyCount,
+                faceCount: brepB.faceCount !== undefined && brepA.faceCount !== undefined
+                    ? brepB.faceCount - brepA.faceCount
+                    : undefined,
+                edgeCount: brepB.edgeStatistics && brepA.edgeStatistics
+                    ? brepB.edgeStatistics.count - brepA.edgeStatistics.count
+                    : undefined,
+            },
+            exchange: {
+                schemaChanged: semanticA.schema !== semanticB.schema,
+                productNamesA: semanticA.productNames,
+                productNamesB: semanticB.productNames,
+            },
+            warnings: [...brepA.health.warnings, ...brepB.health.warnings],
+            limitations: [
+                ...semanticA.limitations,
+                ...semanticB.limitations,
+                {
+                    source: 'compare_step_files',
+                    message: 'Comparison uses metric and metadata deltas only; stable feature identity and adjacency across revisions are not inferred.',
+                },
+            ],
+            providers: {
+                a: [brepA.provider, semanticA.provider],
+                b: [brepB.provider, semanticB.provider],
+            },
+        };
+    }));
+}
+//# sourceMappingURL=compare.js.map

package/dist/compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.js","sourceRoot":"","sources":["../src/compare.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAa,EAAE,KAAa;IACjE,OAAO,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAC3C,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACpC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC7D,MAAM,CAAC,YAAY,EAAE;YACrB,MAAM,CAAC,YAAY,EAAE;YACrB,MAAM,CAAC,gBAAgB,EAAE;YACzB,MAAM,CAAC,gBAAgB,EAAE;SAC1B,CAAC,CAAC;QAEH,OAAO;YACL,cAAc,EAAE,2BAA2B;YAC3C,KAAK,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE;YAC7B,MAAM,EAAE;gBACN,UAAU,EAAE;oBACV,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK;oBACtD,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,MAAM;oBACzD,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK;iBACvD;gBACD,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM;gBACnC,WAAW,EAAE,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW;gBAClD,SAAS,EAAE,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS;gBAC5C,SAAS,EACP,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;oBAC5D,CAAC,CAAC,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS;oBACnC,CAAC,CAAC,SAAS;gBACf,SAAS,EACP,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC,cAAc;oBAC1C,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK;oBACzD,CAAC,CAAC,SAAS;aAChB;YACD,QAAQ,EAAE;gBACR,aAAa,EAAE,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM;gBACpD,aAAa,EAAE,SAAS,CAAC,YAAY;gBACrC,aAAa,EAAE,SAAS,CAAC,YAAY;aACtC;YACD,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;YAC9D,WAAW,EAAE;gBACX,GAAG,SAAS,CAAC,WAAW;gBACxB,GAAG,SAAS,CAAC,WAAW;gBACxB;oBACE,MAAM,EAAE,oBAAoB;oBAC5B,OAAO,EACL,2HAA2H;iBAC9H;aACF;YACD,SAAS,EAAE;gBACT,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC;gBACvC,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC;aACxC;SACF,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+export declare function jsonToolResult(result: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    structuredContent: unknown;
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+    structuredContent?: undefined;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAmCA,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO;;;;;;;;;;;;;;EAsB7C"}

package/dist/index.js

@@ -0,0 +1,113 @@
+#!/usr/bin/env node
+import { pathToFileURL } from 'node:url';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { handleCompareStepFiles, handleFindStepEdges, handleFindStepFaces, handleGetStepEntities, handleInspectStepFile, handleQueryStepPmi, stepToolOutputSchemas, stepToolSchemas, } from './tools/step-tools.js';
+const server = new McpServer({
+    name: 'cad-mcp-server',
+    version: '0.1.0',
+});
+function isToolResult(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'ok' in value &&
+        typeof value.ok === 'boolean');
+}
+export function jsonToolResult(result) {
+    if (isToolResult(result)) {
+        if (result.ok) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }],
+                structuredContent: result.data,
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `${result.error.type}: ${result.error.message}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    return {
+        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        structuredContent: result,
+    };
+}
+const registerTool = server.registerTool.bind(server);
+function withErrorContext(toolName, handler) {
+    return async (args) => {
+        try {
+            return await handler(args);
+        }
+        catch (error) {
+            console.error(`Tool ${toolName} failed:`, error);
+            throw error;
+        }
+    };
+}
+registerTool('inspect_step_file', {
+    title: 'Inspect STEP File',
+    description: 'Compact first-pass overview of a STEP file. Use this FIRST to identify the part, check validity, dimensions, body count, and topology counts. Expensive face area extremes and adjacency are deferred; follow up with find_step_faces, find_step_edges, or get_step_entities for detail. Do NOT use for entity-level searches. IMPORTANT: Omit all optional filter parameters you do not need — do not pass placeholder values (0, 999999, empty array). Example: {file_path:"model.step"}',
+    inputSchema: stepToolSchemas.inspectStepFile,
+    outputSchema: stepToolOutputSchemas.inspectStepFile,
+}, withErrorContext('inspect_step_file', async ({ file_path }) => jsonToolResult(await handleInspectStepFile(String(file_path)))));
+registerTool('find_step_faces', {
+    title: 'Find STEP Faces',
+    description: 'Search faces by surface type, area, spatial region, or proximity. Use when you need specific faces such as large faces, cylindrical faces, faces near a point, or grouped face statistics. Do NOT use for known face IDs; use get_step_entities. CRITICAL: Omit every optional parameter you do not need. Adding a filter narrows results. Do NOT pass placeholder values. Example small faces: {file_path:"model.step",area_max:1,sort:{by:"area"}}. Example cylinders: {file_path:"model.step",surface_types:["cylinder"],return_type:"groups",group_by:["surface_type"]}',
+    inputSchema: stepToolSchemas.findStepFaces,
+    outputSchema: stepToolOutputSchemas.findStepFaces,
+}, withErrorContext('find_step_faces', async (args) => {
+    const query = args;
+    return jsonToolResult(await handleFindStepFaces(String(query.file_path), query));
+}));
+registerTool('find_step_edges', {
+    title: 'Find STEP Edges',
+    description: 'Search edges by curve type, length, circular radius, spatial region, or proximity. Use for tiny-edge investigation, long edges, circular edges, or grouped edge statistics. For tiny edges use length_max and sort:{by:"length"}. The "radius" filter restricts to circular/curved edges only; omit it unless specifically querying circular edges by radius. Do NOT use for known edge IDs; use get_step_entities. CRITICAL: Omit every optional parameter you do not need. Do NOT pass placeholder values. Example tiny edges: {file_path:"model.step",length_max:0.5,sort:{by:"length"},fields:["id","length","curve_type"]}',
+    inputSchema: stepToolSchemas.findStepEdges,
+    outputSchema: stepToolOutputSchemas.findStepEdges,
+}, withErrorContext('find_step_edges', async (args) => {
+    const query = args;
+    return jsonToolResult(await handleFindStepEdges(String(query.file_path), query));
+}));
+registerTool('get_step_entities', {
+    title: 'Get STEP Entities',
+    description: 'Retrieve one or more known faces or edges by exact entity ID. IDs come from inspect_step_file, find_step_faces, or find_step_edges. Use ONLY when you already have specific IDs. Do NOT use for searching or filtering; use find_step_faces or find_step_edges. Example: {file_path:"model.step",entity_type:"face",entity_ids:["face:0"],fields:["id","area","normal"]}. IMPORTANT: Omit fields if you want the default projection.',
+    inputSchema: stepToolSchemas.getStepEntities,
+    outputSchema: stepToolOutputSchemas.getStepEntities,
+}, withErrorContext('get_step_entities', async (args) => {
+    const query = args;
+    return jsonToolResult(await handleGetStepEntities(String(query.file_path), query));
+}));
+registerTool('compare_step_files', {
+    title: 'Compare STEP Files',
+    description: 'Compare two STEP files and return whole-model metric deltas and metadata changes. Use for two revisions of a part when you need factual differences in dimensions, volume, area, topology counts, or exchange metadata. Does NOT track feature identity across revisions. Deltas are comparison_file_path minus baseline_file_path. Both parameters are required. Example: {baseline_file_path:"model_v1.step",comparison_file_path:"model_v2.step"}',
+    inputSchema: stepToolSchemas.compareStepFiles,
+    outputSchema: stepToolOutputSchemas.compareStepFiles,
+}, withErrorContext('compare_step_files', async (args) => {
+    const { baseline_file_path, comparison_file_path } = args;
+    return jsonToolResult(await handleCompareStepFiles(String(baseline_file_path), String(comparison_file_path)));
+}));
+registerTool('query_step_pmi', {
+    title: 'Query STEP PMI',
+    description: 'Query Product Manufacturing Information (PMI): geometric tolerances, dimensions, datums, and annotations. Use return_type:"summary" first to check whether PMI exists. Not all STEP files contain PMI; AP203 files commonly do not. CRITICAL: Omit every optional parameter you do not need. Do NOT pass placeholder values. Example quick check: {file_path:"model.step",return_type:"summary"}',
+    inputSchema: stepToolSchemas.queryStepPmi,
+    outputSchema: stepToolOutputSchemas.queryStepPmi,
+}, withErrorContext('query_step_pmi', async (args) => {
+    const query = args;
+    return jsonToolResult(await handleQueryStepPmi(String(query.file_path), query));
+}));
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('CAD MCP Server started');
+}
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+    main().catch((error) => {
+        console.error('Fatal error:', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/kernel/aag-utils.d.ts

@@ -0,0 +1,7 @@
+import type { OcctKernel, ShapeHandle } from 'occt-wasm';
+export type EdgeVexity = 'convex' | 'concave' | 'smooth' | 'unknown';
+export declare function computeEdgeVexity(kernel: OcctKernel, faceA: ShapeHandle, faceB: ShapeHandle, sharedEdge: ShapeHandle): {
+    vexity: EdgeVexity;
+    dihedralAngleDeg: number;
+};
+//# sourceMappingURL=aag-utils.d.ts.map

package/dist/kernel/aag-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aag-utils.d.ts","sourceRoot":"","sources":["../../src/kernel/aag-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAQ,MAAM,WAAW,CAAC;AAE/D,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAErE,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,WAAW,GACtB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAsClD"}

package/dist/kernel/aag-utils.js

@@ -0,0 +1,54 @@
+export function computeEdgeVexity(kernel, faceA, faceB, sharedEdge) {
+    try {
+        const params = kernel.curveParameters(sharedEdge);
+        const midParam = (params.first + params.last) / 2;
+        const tangent = kernel.curveTangent(sharedEdge, midParam);
+        const point = kernel.curvePointAtParam(sharedEdge, midParam);
+        const uvA = kernel.uvFromPoint(faceA, point);
+        const uvB = kernel.uvFromPoint(faceB, point);
+        const normalA = kernel.surfaceNormal(faceA, uvA.u, uvA.v);
+        const normalB = kernel.surfaceNormal(faceB, uvB.u, uvB.v);
+        const ta = { x: tangent.x, y: tangent.y, z: tangent.z };
+        const nA = { x: normalA.x, y: normalA.y, z: normalA.z };
+        const nB = { x: normalB.x, y: normalB.y, z: normalB.z };
+        const taLen = magnitude(ta);
+        if (taLen < 1e-12) {
+            return { vexity: 'unknown', dihedralAngleDeg: 0 };
+        }
+        const tHat = { x: ta.x / taLen, y: ta.y / taLen, z: ta.z / taLen };
+        const cA = normalize(cross(nA, tHat));
+        const cB = normalize(cross(nB, tHat));
+        const dot = dotProduct(cA, cB);
+        const clamped = Math.max(-1, Math.min(1, dot));
+        const angleRad = Math.acos(clamped);
+        const dihedralAngleDeg = angleRad * (180 / Math.PI);
+        if (dot > 0.05)
+            return { vexity: 'convex', dihedralAngleDeg };
+        if (dot < -0.05)
+            return { vexity: 'concave', dihedralAngleDeg };
+        return { vexity: 'smooth', dihedralAngleDeg };
+    }
+    catch {
+        return { vexity: 'unknown', dihedralAngleDeg: 0 };
+    }
+}
+function cross(a, b) {
+    return {
+        x: a.y * b.z - a.z * b.y,
+        y: a.z * b.x - a.x * b.z,
+        z: a.x * b.y - a.y * b.x,
+    };
+}
+function dotProduct(a, b) {
+    return a.x * b.x + a.y * b.y + a.z * b.z;
+}
+function magnitude(v) {
+    return Math.sqrt(v.x * v.x + v.y * v.y + v.z * v.z);
+}
+function normalize(v) {
+    const len = magnitude(v);
+    if (len < 1e-12)
+        return { x: 0, y: 0, z: 1 };
+    return { x: v.x / len, y: v.y / len, z: v.z / len };
+}
+//# sourceMappingURL=aag-utils.js.map

package/dist/kernel/aag-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aag-utils.js","sourceRoot":"","sources":["../../src/kernel/aag-utils.ts"],"names":[],"mappings":"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"}

package/dist/kernel/import.d.ts

@@ -0,0 +1,4 @@
+import { type AnalysisError } from '../utils/errors.js';
+export declare function mapOcctError(error: unknown, action: string): AnalysisError;
+export declare function readStepText(filePath: string): Promise<string>;
+//# sourceMappingURL=import.d.ts.map

package/dist/kernel/import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../src/kernel/import.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAgB,MAAM,oBAAoB,CAAC;AAEtE,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAS1E;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUpE"}

package/dist/kernel/import.js

@@ -0,0 +1,25 @@
+import { readFile } from 'node:fs/promises';
+import { OcctError, OcctErrorCode } from 'occt-wasm';
+import { unknownError } from '../utils/errors.js';
+export function mapOcctError(error, action) {
+    if (error instanceof OcctError) {
+        return {
+            type: error.code === OcctErrorCode.ImportExportFailed ? 'invalid_format' : 'unknown',
+            message: `${action} failed: ${error.message}`,
+        };
+    }
+    return unknownError(error, action);
+}
+export async function readStepText(filePath) {
+    try {
+        return await readFile(filePath, 'utf8');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw {
+            type: 'file_not_found',
+            message: `File not found: ${filePath}. ${message}`,
+        };
+    }
+}
+//# sourceMappingURL=import.js.map

package/dist/kernel/import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.js","sourceRoot":"","sources":["../../src/kernel/import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAsB,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEtE,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,MAAc;IACzD,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;QAC/B,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC,kBAAkB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;YACpF,OAAO,EAAE,GAAG,MAAM,YAAY,KAAK,CAAC,OAAO,EAAE;SAC9C,CAAC;IACJ,CAAC;IAED,OAAO,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM;YACJ,IAAI,EAAE,gBAAgB;YACtB,OAAO,EAAE,mBAAmB,QAAQ,KAAK,OAAO,EAAE;SAC3B,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/kernel/kernel.d.ts

@@ -0,0 +1,3 @@
+import { OcctKernel } from 'occt-wasm';
+export declare function getOcctKernel(): Promise<OcctKernel>;
+//# sourceMappingURL=kernel.d.ts.map

package/dist/kernel/kernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../../src/kernel/kernel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAIvC,wBAAsB,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC,CAGzD"}

package/dist/kernel/kernel.js

@@ -0,0 +1,7 @@
+import { OcctKernel } from 'occt-wasm';
+let kernelPromise;
+export async function getOcctKernel() {
+    kernelPromise ??= OcctKernel.init();
+    return kernelPromise;
+}
+//# sourceMappingURL=kernel.js.map

package/dist/kernel/kernel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.js","sourceRoot":"","sources":["../../src/kernel/kernel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,IAAI,aAA8C,CAAC;AAEnD,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,aAAa,KAAK,UAAU,CAAC,IAAI,EAAE,CAAC;IACpC,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/kernel/measure.d.ts

@@ -0,0 +1,6 @@
+import type { OcctKernel, ShapeHandle } from 'occt-wasm';
+import type { BoundingBox, Dimensions } from '../types/schema.js';
+export declare function toBoundingBox(kernel: OcctKernel, shape: ShapeHandle): BoundingBox;
+export declare function getDimensions(boundingBox: BoundingBox): Dimensions;
+export declare function guessShapeClass(dimensions: Dimensions): 'box' | 'cylindrical' | 'complex';
+//# sourceMappingURL=measure.d.ts.map

package/dist/kernel/measure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure.d.ts","sourceRoot":"","sources":["../../src/kernel/measure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAElE,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,WAAW,CAOjF;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,CAMlE;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,KAAK,GAAG,aAAa,GAAG,SAAS,CAMzF"}

package/dist/kernel/measure.js

@@ -0,0 +1,23 @@
+export function toBoundingBox(kernel, shape) {
+    const bbox = kernel.getBoundingBox(shape, false);
+    return {
+        min: { x: bbox.xmin, y: bbox.ymin, z: bbox.zmin },
+        max: { x: bbox.xmax, y: bbox.ymax, z: bbox.zmax },
+    };
+}
+export function getDimensions(boundingBox) {
+    return {
+        width: boundingBox.max.x - boundingBox.min.x,
+        height: boundingBox.max.y - boundingBox.min.y,
+        depth: boundingBox.max.z - boundingBox.min.z,
+    };
+}
+export function guessShapeClass(dimensions) {
+    const { width, height, depth } = dimensions;
+    if (width > height * 2 || width > depth * 2)
+        return 'box';
+    if (Math.abs(height - depth) < Math.max(height, depth) * 0.2)
+        return 'cylindrical';
+    return 'complex';
+}
+//# sourceMappingURL=measure.js.map

package/dist/kernel/measure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure.js","sourceRoot":"","sources":["../../src/kernel/measure.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,aAAa,CAAC,MAAkB,EAAE,KAAkB;IAClE,MAAM,IAAI,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAEjD,OAAO;QACL,GAAG,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE;QACjD,GAAG,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE;KAClD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,WAAwB;IACpD,OAAO;QACL,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;QAC7C,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;KAC7C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,UAAsB;IACpD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;IAE5C,IAAI,KAAK,GAAG,MAAM,GAAG,CAAC,IAAI,KAAK,GAAG,KAAK,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1D,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,GAAG;QAAE,OAAO,aAAa,CAAC;IACnF,OAAO,SAAS,CAAC;AACnB,CAAC"}