@ifc-lite/mcp 0.22.1 → 0.24.1

package/dist/tools/hosted-edit.js

@@ -0,0 +1,37 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { ToolErrorCode, ToolExecutionError } from '../errors.js';
+import { okResult, resolveModel } from './util.js';
+/** #6232 D5: hosted.slide and inspector dimensions share their physical edit core. */
+export const hostedEditTool = {
+    name: 'edit_hosted_element',
+    description: 'Move or resize a live wall-hosted opening, door or window together with its actual cut. '
+        + 'Offset and Sill are metres in the host frame; OverallWidth/OverallHeight are metres. '
+        + 'Identity and relationships are retained. Overlap, out-of-host and unsupported geometry edits are refused atomically. '
+        + 'One mutation_undo restores the preceding graph.',
+    scope: 'mutate',
+    inputSchema: {
+        type: 'object', properties: {
+            model_id: { type: 'string', description: 'Required when multiple models are loaded.' },
+            express_id: { type: 'integer', minimum: 1 },
+            patch: {
+                type: 'object', properties: {
+                    OverallWidth: { type: 'number', minimum: 0 }, OverallHeight: { type: 'number', minimum: 0 },
+                    Offset: { type: 'number' }, Sill: { type: 'number' },
+                }, additionalProperties: false, anyOf: ['OverallWidth', 'OverallHeight', 'Offset', 'Sill'].map(name => ({ required: [name] })),
+            },
+        }, required: ['express_id', 'patch'], additionalProperties: false,
+    },
+    handler(input, ctx) {
+        const model = resolveModel(ctx, input.model_id);
+        try {
+            const ref = model.bim.store.editHostedElement({ modelId: model.id, expressId: input.express_id }, input.patch);
+            return okResult(`Edited hosted element #${ref.expressId}.`, { ...ref });
+        }
+        catch (error) {
+            throw new ToolExecutionError({ code: ToolErrorCode.INVALID_INPUT, message: error instanceof Error ? error.message : String(error) });
+        }
+    },
+};
+//# sourceMappingURL=hosted-edit.js.map

package/dist/tools/hosted-edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-edit.js","sourceRoot":"","sources":["../../src/tools/hosted-edit.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAG/D,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEjE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEnD,sFAAsF;AACtF,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,0FAA0F;UACnG,uFAAuF;UACvF,uHAAuH;UACvH,iDAAiD;IACrD,KAAK,EAAE,QAAQ;IACf,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE;YAC1B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2CAA2C,EAAE;YACtF,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;YAC3C,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE;oBAC1B,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;oBAC3F,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBACrD,EAAE,oBAAoB,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,cAAc,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;aAC/H;SACF,EAAE,QAAQ,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE,oBAAoB,EAAE,KAAK;KAClE;IACD,OAAO,CAAC,KAAK,EAAE,GAAG;QAChB,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,QAA8B,CAAC,CAAC;QACtE,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,UAAoB,EAAE,EAAE,KAAK,CAAC,KAA0B,CAAC,CAAC;YAC9I,OAAO,QAAQ,CAAC,0BAA0B,GAAG,CAAC,SAAS,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;QAC1E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,kBAAkB,CAAC,EAAE,IAAI,EAAE,aAAa,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvI,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/hosted-place.d.ts

@@ -0,0 +1,3 @@
+import type { Tool } from './types.js';
+export declare const hostedPlaceTools: Tool[];
+//# sourceMappingURL=hosted-place.d.ts.map

package/dist/tools/hosted-place.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-place.d.ts","sourceRoot":"","sources":["../../src/tools/hosted-place.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAwDvC,eAAO,MAAM,gBAAgB,EAAE,IAAI,EAA6D,CAAC"}

package/dist/tools/hosted-place.js

@@ -0,0 +1,63 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/** MCP gesture-free counterparts of the viewer's hosted commands (#6232 D5).
+ * All IFC writing and fit/overlap refusal is in @ifc-lite/create via bim.store. */
+import { readHostedFill } from '@ifc-lite/create';
+import { ToolErrorCode, ToolExecutionError } from '../errors.js';
+import { okResult, resolveModel } from './util.js';
+const common = {
+    Offset: { type: 'number', description: 'Opening centre along the host local X, in metres.' },
+    Sill: { type: 'number', description: 'Bottom above the host local origin, in metres; defaults to zero for a door or opening.' },
+    Width: { type: 'number', minimum: 0 }, Height: { type: 'number', minimum: 0 },
+    CutDepth: { type: 'number', minimum: 0 },
+    Name: { type: 'string' }, Description: { type: 'string' }, ObjectType: { type: 'string' }, Tag: { type: 'string' },
+    GlobalId: { type: 'string', minLength: 22, maxLength: 22 },
+};
+function hostedTool(kind) {
+    const type = kind === 'opening' ? 'IfcOpeningElement' : kind === 'door' ? 'IfcDoor' : 'IfcWindow';
+    const fill = kind === 'opening' ? {} : {
+        FrameThickness: { type: 'number', minimum: 0 },
+        PredefinedType: { type: 'string', enum: kind === 'door'
+                ? ['DOOR', 'GATE', 'TRAPDOOR', 'USERDEFINED', 'NOTDEFINED']
+                : ['WINDOW', 'SKYLIGHT', 'LIGHTDOME', 'USERDEFINED', 'NOTDEFINED'] },
+        ...(kind === 'door'
+            ? { OperationType: { type: 'string' }, UserDefinedOperationType: { type: 'string' } }
+            : { PartitioningType: { type: 'string' }, UserDefinedPartitioningType: { type: 'string' } }),
+    };
+    return {
+        name: `place_${kind}`,
+        description: `Place ${type} in a loaded wall through the same creation core as the Model workspace and SDK. `
+            + 'Dimensions are metres in the host frame. Refuses cuts outside the wall, overlapping cuts, and unreadable opening geometry. '
+            + 'Writes the complete void/fill graph atomically; one mutation_undo removes the placement.',
+        scope: 'mutate',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                model_id: { type: 'string', description: 'Required when multiple models are loaded.' },
+                host_express_id: { type: 'integer', minimum: 1, description: 'IfcWall express id within the chosen model, including a wall created this session.' },
+                params: { type: 'object', properties: { ...common, ...fill }, required: ['Offset', 'Width', 'Height', ...(kind === 'window' ? ['Sill'] : [])], additionalProperties: false },
+            },
+            required: ['host_express_id', 'params'], additionalProperties: false,
+        },
+        handler(input, ctx) {
+            const model = resolveModel(ctx, input.model_id);
+            const hostId = input.host_express_id;
+            const params = input.params;
+            try {
+                const placed = kind === 'opening' ? model.bim.store.addOpening(model.id, hostId, params)
+                    : kind === 'door' ? model.bim.store.addHostedDoor(model.id, hostId, params)
+                        : model.bim.store.addHostedWindow(model.id, hostId, params);
+                const hosted = readHostedFill(model.store, placed.expressId, model.backend.getMutationView());
+                return okResult(`Placed ${type} as #${placed.expressId} in wall #${hostId}.`, {
+                    ...placed, type, openingId: hosted?.openingId ?? placed.expressId, hostExpressId: hostId,
+                });
+            }
+            catch (error) {
+                throw new ToolExecutionError({ code: ToolErrorCode.INVALID_INPUT, message: error instanceof Error ? error.message : String(error) });
+            }
+        },
+    };
+}
+export const hostedPlaceTools = ['opening', 'door', 'window'].map(hostedTool);
+//# sourceMappingURL=hosted-place.js.map

package/dist/tools/hosted-place.js.map

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

package/dist/tools/ids-accessor.d.ts

@@ -7,6 +7,7 @@
  */
 import type { IfcDataStore } from '@ifc-lite/parser';
 import type { MutablePropertyView } from '@ifc-lite/mutations';
+import type { IFCDataAccessor } from '@ifc-lite/ids';
 /**
  * `mutationView`, when supplied, is consulted for entity membership only.
  * Enumeration excludes tombstones and includes overlay-created entities, and
@@ -14,5 +15,5 @@ import type { MutablePropertyView } from '@ifc-lite/mutations';
  * `EntityVisibilityView` structurally, so no adapter is needed. Omitting it
  * leaves the accessor answering for the file as parsed.
  */
-export declare function buildIdsAccessor(store: IfcDataStore, mutationView?: MutablePropertyView | null): unknown;
+export declare function buildIdsAccessor(store: IfcDataStore, mutationView?: MutablePropertyView | null): IFCDataAccessor;
 //# sourceMappingURL=ids-accessor.d.ts.map

package/dist/tools/ids-accessor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ids-accessor.d.ts","sourceRoot":"","sources":["../../src/tools/ids-accessor.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/D;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,YAAY,EACnB,YAAY,CAAC,EAAE,mBAAmB,GAAG,IAAI,GACxC,OAAO,CAET"}
+{"version":3,"file":"ids-accessor.d.ts","sourceRoot":"","sources":["../../src/tools/ids-accessor.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,YAAY,EACnB,YAAY,CAAC,EAAE,mBAAmB,GAAG,IAAI,GACxC,eAAe,CAEjB"}

package/dist/tools/ids-accessor.js.map

@@ -1 +1 @@
-{"version":3,"file":"ids-accessor.js","sourceRoot":"","sources":["../../src/tools/ids-accessor.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAY/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAmB,EACnB,YAAyC;IAEzC,OAAO,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,YAAY,IAAI,SAAS,CAAC,CAAC;AACzE,CAAC"}
+{"version":3,"file":"ids-accessor.js","sourceRoot":"","sources":["../../src/tools/ids-accessor.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAa/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAmB,EACnB,YAAyC;IAEzC,OAAO,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,YAAY,IAAI,SAAS,CAAC,CAAC;AACzE,CAAC"}

package/dist/tools/ids-authoring-model.d.ts

@@ -0,0 +1,3 @@
+import type { Tool } from './types.js';
+export declare const idsAuthoringModelTools: Tool[];
+//# sourceMappingURL=ids-authoring-model.d.ts.map

package/dist/tools/ids-authoring-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids-authoring-model.d.ts","sourceRoot":"","sources":["../../src/tools/ids-authoring-model.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAgGvC,eAAO,MAAM,sBAAsB,EAAE,IAAI,EAA0D,CAAC"}

package/dist/tools/ids-authoring-model.js

@@ -0,0 +1,112 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * IDS authoring tools, batch 2 (IDS-119): `ids_diff`, plus the model-loop
+ * and test-suite tools `ids_preview`, `ids_infer`, `ids_coverage` and
+ * `ids_test`.
+ *
+ * `ids_diff` works today (re-identification matcher, `diffIds`). The other
+ * four are declared with their final input schemas and answer
+ * UNSUPPORTED_OPERATION, the same convention as `gherkin_check`: the
+ * funnel, inference and coverage engines (IDS model loop) and the
+ * test-suite runner (IDS-110) are not in this release. Each replaces its
+ * stub handler when its engine lands; the names and inputs do not change.
+ */
+import { readFile } from 'node:fs/promises';
+import { IDSParseError, parseIDS } from '@ifc-lite/ids';
+import { diffIds } from '@ifc-lite/ids-authoring';
+import { ToolErrorCode, ToolExecutionError } from '../errors.js';
+import { resolveSafePath } from '../safe-path.js';
+import { okResult } from './util.js';
+async function loadSide(input, side, ctx) {
+    const inline = input[`${side}_xml`];
+    const path = input[`${side}_path`];
+    let xml;
+    if (typeof inline === 'string')
+        xml = inline;
+    else if (typeof path === 'string')
+        xml = await readFile(await resolveSafePath(path, ctx, 'read'), 'utf-8');
+    else
+        throw new ToolExecutionError({ code: ToolErrorCode.INVALID_INPUT, message: `Provide ${side}_xml or ${side}_path.` });
+    try {
+        return parseIDS(xml);
+    }
+    catch (err) {
+        if (!(err instanceof IDSParseError))
+            throw err;
+        throw new ToolExecutionError({ code: ToolErrorCode.PARSE_FAILED, message: `The ${side} IDS does not parse: ${err.message}` });
+    }
+}
+const idsDiff = {
+    name: 'ids_diff',
+    description: 'Semantic diff of two IDS revisions. Specifications and facets are paired by identifier, then name and applicability, then similarity, so a rename or an edited requirement is one change. Returns added / removed / changed entries with XML paths and a plain-language line each.',
+    scope: 'read',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            before_xml: { type: 'string' },
+            before_path: { type: 'string', description: 'Subject to allowedPaths.' },
+            after_xml: { type: 'string' },
+            after_path: { type: 'string', description: 'Subject to allowedPaths.' },
+        },
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const diff = diffIds(await loadSide(input, 'before', ctx), await loadSide(input, 'after', ctx));
+        const head = diff.identical ? 'No changes.' : `${diff.entries.length} change(s):`;
+        const lines = diff.entries.slice(0, 20).map((e) => `- ${e.text}`);
+        return okResult([head, ...lines].join('\n'), { identical: diff.identical, entries: diff.entries });
+    },
+};
+function notInThisRelease(name, engine) {
+    return () => {
+        throw new ToolExecutionError({
+            code: ToolErrorCode.UNSUPPORTED_OPERATION,
+            message: `${name} is not available in this release: it needs ${engine}, which has not shipped yet.`,
+            hint: 'Use ids_validate to check a model against an IDS, and ids_lint for static checks.',
+        });
+    };
+}
+const MODEL_ID = { type: 'string', description: 'Loaded model to evaluate against (default: the only one).' };
+const IDS_SOURCE = {
+    ids_xml: { type: 'string' },
+    ids_path: { type: 'string' },
+    doc: { type: 'object', description: 'A Studio document from ids_read / ids_apply_ops.' },
+};
+const MODEL_LOOP = 'the IDS model loop (funnel, inference and coverage engines)';
+const idsPreview = {
+    name: 'ids_preview',
+    description: 'Funnel counts per specification against a loaded model: how many elements each applicability facet keeps, and how many pass each requirement. Not available yet.',
+    scope: 'validate',
+    inputSchema: { type: 'object', properties: { model_id: MODEL_ID, ...IDS_SOURCE, spec_id: { type: 'string' } }, additionalProperties: false },
+    handler: notInThisRelease('ids_preview', MODEL_LOOP),
+};
+const idsInfer = {
+    name: 'ids_infer',
+    description: 'Infer specifications from the elements a selector picks in a loaded model (IfcOpenShell selector syntax). Returns ops for ids_apply_ops. Not available yet.',
+    scope: 'validate',
+    inputSchema: {
+        type: 'object',
+        properties: { model_id: MODEL_ID, select: { type: 'string' }, threshold: { type: 'number', minimum: 0, maximum: 1 } },
+        required: ['select'],
+        additionalProperties: false,
+    },
+    handler: notInThisRelease('ids_infer', MODEL_LOOP),
+};
+const idsCoverage = {
+    name: 'ids_coverage',
+    description: 'Element classes in a loaded model that no specification of the IDS governs. Not available yet.',
+    scope: 'validate',
+    inputSchema: { type: 'object', properties: { model_id: MODEL_ID, ...IDS_SOURCE }, additionalProperties: false },
+    handler: notInThisRelease('ids_coverage', MODEL_LOOP),
+};
+const idsTest = {
+    name: 'ids_test',
+    description: 'Run the test suites stored in an .idsz bundle (fixtures that must pass or fail each specification). Not available yet.',
+    scope: 'validate',
+    inputSchema: { type: 'object', properties: { idsz_path: { type: 'string' } }, required: ['idsz_path'], additionalProperties: false },
+    handler: notInThisRelease('ids_test', 'the IDS test-suite runner'),
+};
+export const idsAuthoringModelTools = [idsDiff, idsPreview, idsInfer, idsCoverage, idsTest];
+//# sourceMappingURL=ids-authoring-model.js.map

package/dist/tools/ids-authoring-model.js.map

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

package/dist/tools/ids-authoring.d.ts

@@ -0,0 +1,3 @@
+import type { Tool } from './types.js';
+export declare const idsAuthoringTools: Tool[];
+//# sourceMappingURL=ids-authoring.d.ts.map

package/dist/tools/ids-authoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids-authoring.d.ts","sourceRoot":"","sources":["../../src/tools/ids-authoring.ts"],"names":[],"mappings":"AA4CA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAiMvC,eAAO,MAAM,iBAAiB,EAAE,IAAI,EAAwD,CAAC"}

package/dist/tools/ids-authoring.js

@@ -0,0 +1,202 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * IDS authoring tools, batch 1 (IDS-118): `ids_audit`, `ids_lint`,
+ * `ids_read`, `ids_apply_ops`, `ids_write`. The `ids_schema_*` lookups
+ * live in `ids-schema.ts`.
+ *
+ * Stateless by design: a document travels as Studio JSON (`ids_read`
+ * output) between calls, and node ids are derived from the content, so
+ * reading the same XML twice gives the same ids.
+ *
+ * External agents get the grounding gate. `ids_apply_ops` is the only tool
+ * that changes a document, and it goes through `applyOpsGated`: every op is
+ * validated against the op JSON Schema and the batch is checked against the
+ * IFC schema tables; a refused batch changes nothing and the refusal (code,
+ * path, message, candidates) goes back to the caller. Because Studio JSON
+ * can be edited by hand between calls, `ids_write` audits what it
+ * serialises and refuses a document with audit errors.
+ */
+import { auditIDSDocument, IDSParseError } from '@ifc-lite/ids';
+import { applyOpsGated, createGateContext, createLintContext, createSidecar, createStudioDocument, getOpJsonSchema, lintDocument, nodePath, parseStudioDocument, readStudioDocument, serializeSidecar, writeStudioDocument, } from '@ifc-lite/ids-authoring';
+import { writeIdsXml } from '@ifc-lite/ids';
+import { ToolErrorCode, ToolExecutionError } from '../errors.js';
+import { okResult } from './util.js';
+import { loadIdsXml } from './validation.js';
+const XML_INPUT = {
+    ids_xml: { type: 'string', description: 'Inline IDS XML.' },
+    ids_path: { type: 'string', description: 'Path to an .ids file (subject to allowedPaths).' },
+};
+const DOC_INPUT = {
+    type: 'object',
+    description: 'A Studio document as returned by ids_read or ids_apply_ops (`doc`).',
+};
+function parseError(err) {
+    if (err instanceof IDSParseError) {
+        throw new ToolExecutionError({ code: ToolErrorCode.PARSE_FAILED, message: `IDS does not parse: ${err.message}`, hint: 'Run ids_audit for details.' });
+    }
+    throw err;
+}
+/** `doc` when given, else the IDS in `ids_xml` / `ids_path`, else `fallback` (or an error). */
+async function loadDocument(input, ctx, fallback) {
+    if (input.doc !== undefined) {
+        try {
+            return parseStudioDocument(input.doc);
+        }
+        catch (err) {
+            throw new ToolExecutionError({ code: ToolErrorCode.INVALID_INPUT, message: `doc is not a Studio document: ${err instanceof Error ? err.message : String(err)}` });
+        }
+    }
+    if (fallback && input.ids_xml === undefined && input.ids_path === undefined)
+        return fallback();
+    const xml = await loadIdsXml(input, ctx);
+    try {
+        return readStudioDocument(xml);
+    }
+    catch (err) {
+        return parseError(err);
+    }
+}
+async function lintSummary(doc, options = {}) {
+    const result = lintDocument(doc, await createLintContext(), options);
+    const diagnostics = result.diagnostics.map((d) => ({ ...d, path: nodePath(doc, d.nodeId) }));
+    const counts = { error: 0, warning: 0, info: 0 };
+    for (const d of diagnostics)
+        counts[d.severity]++;
+    return { counts, diagnostics, suppressed: result.suppressed.length };
+}
+function outline(doc) {
+    return doc.ids.specifications.map((spec, i) => ({
+        id: doc.nodes.specs[i].id,
+        name: spec.name,
+        applicability: doc.nodes.specs[i].applicability.map((n, j) => ({ id: n.id, type: spec.applicability.facets[j].type })),
+        requirements: doc.nodes.specs[i].requirements.map((n, j) => ({ id: n.id, type: spec.requirements[j].facet.type })),
+    }));
+}
+const idsAudit = {
+    name: 'ids_audit',
+    description: 'Conformance audit of an IDS file: XML and XSD shape, IFC entity/property names, restriction coherence. Answers "is this a valid IDS 1.0 file?". No model needed.',
+    scope: 'validate',
+    inputSchema: { type: 'object', properties: { ...XML_INPUT }, additionalProperties: false },
+    async handler(input, ctx) {
+        const report = await auditIDSDocument(await loadIdsXml(input, ctx));
+        const counts = { error: 0, warning: 0, info: 0 };
+        for (const issue of report.issues)
+            counts[issue.severity]++;
+        return okResult(`IDS audit: ${report.status} (${counts.error} errors, ${counts.warning} warnings, ${counts.info} info).`, {
+            status: report.status,
+            counts,
+            issues: report.issues,
+        });
+    },
+};
+const idsLint = {
+    name: 'ids_lint',
+    description: 'Lint an IDS document with the IDSL rule catalogue: does it mean what the author intends? Each diagnostic names its node (`nodeId`, `path`) and may carry quick fixes: op batches you can pass to ids_apply_ops unchanged. Pass `doc` (from ids_read / ids_apply_ops) or the XML.',
+    scope: 'validate',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            doc: DOC_INPUT,
+            ...XML_INPUT,
+            rules: { type: 'array', items: { type: 'string' }, description: 'Only these rule codes, e.g. ["IDSL-PROP-001"].' },
+            severity: { type: 'object', description: 'Per-rule severity override: {"IDSL-SPEC-008": "off"}. Values: error, warning, info, off.' },
+        },
+        additionalProperties: false,
+    },
+    async handler(input, ctx) {
+        const doc = await loadDocument(input, ctx);
+        const severity = input.severity;
+        const summary = await lintSummary(doc, { rules: input.rules, severity });
+        const { counts } = summary;
+        return okResult(`IDS lint: ${counts.error} errors, ${counts.warning} warnings, ${counts.info} info.`, { docId: doc.docId, ...summary });
+    },
+};
+const idsRead = {
+    name: 'ids_read',
+    description: 'Read IDS XML into a Studio document (JSON with a stable UUID for every specification, facet and constraint). Pass the returned `doc` to ids_apply_ops, ids_lint and ids_write. Reading the same XML twice gives the same ids.',
+    scope: 'read',
+    inputSchema: { type: 'object', properties: { ...XML_INPUT }, additionalProperties: false },
+    async handler(input, ctx) {
+        const doc = await loadDocument(input, ctx);
+        return okResult(`Read "${doc.ids.info.title}": ${doc.ids.specifications.length} specification(s).`, { doc, outline: outline(doc) });
+    },
+};
+function opsInputSchema() {
+    const ops = getOpJsonSchema();
+    return {
+        type: 'object',
+        properties: {
+            doc: DOC_INPUT,
+            ...XML_INPUT,
+            title: { type: 'string', description: 'Title of a new, empty document (when neither doc nor XML is given).' },
+            ops: { type: 'array', minItems: 1, items: { oneOf: ops.oneOf }, description: 'Operations of IDS ops vocabulary v1, applied in order as one batch.' },
+        },
+        required: ['ops'],
+        additionalProperties: false,
+        $defs: ops.$defs,
+    };
+}
+function refusalText(issues) {
+    const lines = issues.slice(0, 5).map((i) => {
+        const near = i.candidates.slice(0, 3).map((c) => c.value);
+        return `- ${i.code} at ${i.path}: ${i.message}${near.length ? ` Did you mean: ${near.join(', ')}?` : ''}`;
+    });
+    const more = issues.length > 5 ? `\n- … ${issues.length - 5} more in structuredContent.details.issues` : '';
+    return `The grounding gate refused the batch; nothing was applied.\n${lines.join('\n')}${more}`;
+}
+const idsApplyOps = {
+    name: 'ids_apply_ops',
+    description: 'Change an IDS document by applying typed operations. Every op is validated and the batch is checked by the grounding gate against the IFC schema tables (entities, predefined types, attributes, property sets, properties, enumerations, data types). A refused batch changes nothing and returns each problem with a path and ranked candidates; fix the names and resend the whole batch. Starts from `doc`, from the XML, or from an empty document. Returns the new `doc` and its lint diagnostics.',
+    scope: 'read',
+    inputSchema: opsInputSchema(),
+    async handler(input, ctx) {
+        const doc = await loadDocument(input, ctx, () => createStudioDocument({ title: typeof input.title === 'string' ? input.title : '' }));
+        const result = applyOpsGated(doc, input.ops, await createGateContext());
+        if (!result.ok) {
+            throw new ToolExecutionError({
+                code: ToolErrorCode.INVALID_INPUT,
+                message: refusalText(result.issues),
+                details: { refused: true, issues: result.issues },
+                hint: 'Use ids_schema_search / ids_schema_entity / ids_schema_pset to look names up.',
+            });
+        }
+        const lint = await lintSummary(result.doc);
+        return okResult(`Applied ${result.applied.length} op(s). Lint: ${lint.counts.error} errors, ${lint.counts.warning} warnings, ${lint.counts.info} info.`, { doc: result.doc, applied: result.applied.length, touched: result.touched, lint });
+    },
+};
+const idsWrite = {
+    name: 'ids_write',
+    description: 'Serialise a Studio document to IDS 1.0 XML. The XML is read back to prove nothing was lost and audited; a document with audit errors is refused. Also returns the studio.json sidecar that keeps node ids next to the XML.',
+    scope: 'read',
+    inputSchema: { type: 'object', properties: { doc: DOC_INPUT }, required: ['doc'], additionalProperties: false },
+    async handler(input, ctx) {
+        const doc = await loadDocument(input, ctx);
+        const out = writeStudioDocument(doc, writeIdsXml);
+        if (!out.ok) {
+            throw new ToolExecutionError({
+                code: ToolErrorCode.UNSUPPORTED_OPERATION,
+                message: `Cannot write this document: ${out.message}`,
+                details: { reason: out.reason, lost: out.lost ?? [] },
+            });
+        }
+        const audit = await auditIDSDocument(out.xml);
+        const errors = audit.issues.filter((i) => i.severity === 'error');
+        if (errors.length > 0) {
+            throw new ToolExecutionError({
+                code: ToolErrorCode.INVALID_INPUT,
+                message: `The document fails the IDS audit (${errors.length} error(s)); it was not written. First: ${errors[0].message}`,
+                details: { issues: errors },
+                hint: 'Change documents through ids_apply_ops, which grounds names before they enter the document.',
+            });
+        }
+        return okResult(`Wrote "${doc.ids.info.title}" (${out.xml.length} characters).`, {
+            xml: out.xml,
+            sidecar: serializeSidecar(createSidecar(doc, out.xml)),
+            audit: { status: audit.status, issues: audit.issues },
+        });
+    },
+};
+export const idsAuthoringTools = [idsAudit, idsLint, idsRead, idsApplyOps, idsWrite];
+//# sourceMappingURL=ids-authoring.js.map

package/dist/tools/ids-authoring.js.map

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

package/dist/tools/ids-schema.d.ts

@@ -0,0 +1,3 @@
+import type { Tool } from './types.js';
+export declare const idsSchemaTools: Tool[];
+//# sourceMappingURL=ids-schema.d.ts.map

package/dist/tools/ids-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids-schema.d.ts","sourceRoot":"","sources":["../../src/tools/ids-schema.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AA0FvC,eAAO,MAAM,cAAc,EAAE,IAAI,EAAsD,CAAC"}

package/dist/tools/ids-schema.js

@@ -0,0 +1,91 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { createGateContext, describeEntity, describePset, searchSchema } from '@ifc-lite/ids-authoring';
+import { ToolErrorCode, ToolExecutionError } from '../errors.js';
+import { okResult } from './util.js';
+const VERSION = {
+    type: 'string',
+    enum: ['IFC2X3', 'IFC4', 'IFC4X3', 'IFC4X3_ADD2'],
+    default: 'IFC4',
+    description: 'IFC schema version of the specification.',
+};
+const idsSchemaSearch = {
+    name: 'ids_schema_search',
+    description: 'Find IFC entity, property set, property or data type names close to a query (typo-tolerant). Use before writing a name into an IDS facet.',
+    scope: 'read',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: { type: 'string', minLength: 1 },
+            kind: { type: 'string', enum: ['entity', 'pset', 'property', 'dataType'], description: 'Restrict to one kind.' },
+            ifc_version: VERSION,
+            limit: { type: 'integer', minimum: 1, maximum: 50, default: 10 },
+        },
+        required: ['query'],
+        additionalProperties: false,
+    },
+    async handler(input) {
+        const hits = searchSchema(await createGateContext(), input.query, {
+            kind: input.kind,
+            version: input.ifc_version,
+            limit: input.limit,
+        });
+        const top = hits.slice(0, 5).map((h) => `${h.value} (${h.kind})`).join(', ');
+        return okResult(hits.length ? `Closest: ${top}.` : 'No close names.', { hits });
+    },
+};
+const idsSchemaEntity = {
+    name: 'ids_schema_entity',
+    description: 'Describe an IFC entity for IDS authoring: supertypes, abstract flag, predefined types, attributes and the standard property sets that apply to it.',
+    scope: 'read',
+    inputSchema: {
+        type: 'object',
+        properties: { name: { type: 'string', minLength: 1, description: 'Entity name, any case (IfcDoor or IFCDOOR).' }, ifc_version: VERSION },
+        required: ['name'],
+        additionalProperties: false,
+    },
+    async handler(input) {
+        const ctx = await createGateContext();
+        const version = input.ifc_version;
+        const name = input.name;
+        const entity = describeEntity(ctx, name, version);
+        if (!entity) {
+            const candidates = searchSchema(ctx, name, { kind: 'entity', version, limit: 5 });
+            throw new ToolExecutionError({
+                code: ToolErrorCode.INVALID_INPUT,
+                message: `"${name}" is not an entity of ${version}.${candidates.length ? ` Did you mean: ${candidates.map((c) => c.value).join(', ')}?` : ''}`,
+                details: { candidates },
+            });
+        }
+        return okResult(`${entity.name} (${version}): ${entity.propertySets.length} applicable property set(s).`, { entity });
+    },
+};
+const idsSchemaPset = {
+    name: 'ids_schema_pset',
+    description: 'Describe a standard property or quantity set: the entities it applies to and its properties with data types and enumerations.',
+    scope: 'read',
+    inputSchema: {
+        type: 'object',
+        properties: { name: { type: 'string', minLength: 1, description: 'Exact set name, e.g. Pset_DoorCommon.' }, ifc_version: VERSION },
+        required: ['name'],
+        additionalProperties: false,
+    },
+    async handler(input) {
+        const ctx = await createGateContext();
+        const version = input.ifc_version;
+        const name = input.name;
+        const pset = describePset(ctx, name, version);
+        if (!pset) {
+            const candidates = searchSchema(ctx, name, { kind: 'pset', version, limit: 5 });
+            throw new ToolExecutionError({
+                code: ToolErrorCode.INVALID_INPUT,
+                message: `"${name}" is not a standard property set of ${version}.${candidates.length ? ` Did you mean: ${candidates.map((c) => c.value).join(', ')}?` : ''}`,
+                details: { candidates },
+            });
+        }
+        return okResult(`${pset.name} (${version}): ${pset.properties.length} propert${pset.properties.length === 1 ? 'y' : 'ies'}.`, { pset });
+    },
+};
+export const idsSchemaTools = [idsSchemaSearch, idsSchemaEntity, idsSchemaPset];
+//# sourceMappingURL=ids-schema.js.map

package/dist/tools/ids-schema.js.map

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