@ifc-lite/ids-agent 0.0.0-stage → 0.2.1

package/dist/tools/ask-user.js

@@ -0,0 +1,62 @@
+/* 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_ask_user`: structured clarification (ADR-008). The model offers 2–4
+ * answers, each a ready op batch; the user picks one and that batch is
+ * applied to the sandbox like any other. Every choice is checked by the gate
+ * BEFORE the user sees it, so the user is never offered an ungrounded
+ * answer. Headless runs answer with the first choice.
+ */
+import { checkOps } from '@ifc-lite/ids-authoring';
+import { objectSchema } from './context.js';
+import { agentOpSchema } from './op-schema.js';
+import { applyResult } from './act-tools.js';
+import { defineTool, failure, success } from './registry.js';
+const ASK_USER_MAX_CHOICES = 4;
+const askUser = defineTool({
+    name: 'ids_ask_user', group: 'ids', strict: false, readOnly: false,
+    description: [
+        'Ask the user to choose between 2 to 4 materially different answers, each a ready op batch (may be empty).',
+        'Ask only when lookups return two or more candidates that differ in meaning or model counts; otherwise choose and state the assumption in the rationale.',
+        'The chosen batch is applied for you; its result is returned.',
+    ].join(' '),
+    inputSchema: objectSchema({
+        question: { type: 'string', minLength: 1 },
+        choices: {
+            type: 'array', minItems: 2,
+            items: objectSchema({ label: { type: 'string', minLength: 1 }, rationale: { type: 'string' }, ops: { type: 'array', items: agentOpSchema().op } }, ['label', 'ops']),
+        },
+    }, ['question', 'choices']),
+    defs: agentOpSchema().defs,
+    async run(input, ctx) {
+        if (input.choices.length > ASK_USER_MAX_CHOICES) {
+            return failure('too many choices', { error: `Offer at most ${ASK_USER_MAX_CHOICES} choices.` }, ['ASK:choices']);
+        }
+        const choices = [];
+        for (const [index, choice] of input.choices.entries()) {
+            const ops = ctx.sandbox.handles.resolve(choice.ops);
+            const gate = checkOps(ops, ctx.sandbox.doc, ctx.gate);
+            if (!gate.ok) {
+                return failure(`choice ${index} refused by the gate`, {
+                    error: `Choice ${index} ("${choice.label}") does not pass the gate; fix it before asking.`,
+                    issues: gate.issues.map((i) => ({ code: i.code, path: i.path, message: i.message, candidates: i.candidates.slice(0, 5).map((c) => c.value) })),
+                }, gate.issues.map((i) => `${i.code}:${i.value ?? i.path}`));
+            }
+            // The gate accepted them, so they are well-formed ops.
+            choices.push({ label: choice.label, ...(choice.rationale ? { rationale: choice.rationale } : {}), ops: ops });
+        }
+        const picked = await ctx.askUser({ id: ctx.callId, question: input.question, choices }, ctx.signal);
+        if (picked === null || !choices[picked]) {
+            return success('user dismissed the question', { answered: false, note: 'The user did not choose. Record the statement with ids_mark_unresolved (category "ambiguous") or proceed with a stated assumption.' });
+        }
+        const choice = choices[picked];
+        if (choice.ops.length === 0)
+            return success(`user chose "${choice.label}"`, { answered: true, choice: picked, label: choice.label, applied: false });
+        const outcome = ctx.sandbox.apply(choice.ops, { origin: 'ask_user', rationale: `${input.question} → ${choice.label}`, sources: [] });
+        const result = applyResult(outcome, `answer "${choice.label}"`);
+        return { ...result, data: { answered: true, choice: picked, label: choice.label, result: result.data } };
+    },
+});
+export const ASK_USER_TOOLS = [askUser];
+//# sourceMappingURL=ask-user.js.map

package/dist/tools/ask-user.js.map

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

package/dist/tools/bsdd-tools.d.ts

@@ -0,0 +1,8 @@
+/**
+ * bSDD tools (`05-bsdd.md` §3), over the host's `BsddClient`. Registered only
+ * when a client is provided. Only search terms and URIs leave the agent;
+ * nothing from the document or the model is sent to the dictionary.
+ */
+import { type IdsAgentTool } from './context.js';
+export declare const BSDD_TOOLS: readonly IdsAgentTool[];
+//# sourceMappingURL=bsdd-tools.d.ts.map

package/dist/tools/bsdd-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bsdd-tools.d.ts","sourceRoot":"","sources":["../../src/tools/bsdd-tools.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AAEH,OAAO,EAA4D,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AA0D3G,eAAO,MAAM,UAAU,EAAE,SAAS,YAAY,EAAgD,CAAC"}

package/dist/tools/bsdd-tools.js

@@ -0,0 +1,64 @@
+/* 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/. */
+/**
+ * bSDD tools (`05-bsdd.md` §3), over the host's `BsddClient`. Registered only
+ * when a client is provided. Only search terms and URIs leave the agent;
+ * nothing from the document or the model is sent to the dictionary.
+ */
+import { capText, clampLimit, objectSchema } from './context.js';
+import { defineTool, failure, success } from './registry.js';
+function client(ctx) {
+    if (!ctx.bsdd)
+        throw new Error('bSDD is not available.');
+    return ctx.bsdd;
+}
+const URI = { type: 'string', minLength: 1, pattern: '^https?://' };
+const search = defineTool({
+    name: 'bsdd_search', group: 'bsdd', strict: true, readOnly: true,
+    description: 'Search buildingSMART Data Dictionary classes by text, optionally within one dictionary or related to an IFC entity. Returns class URIs and codes to use as classification values.',
+    inputSchema: objectSchema({
+        text: { type: 'string', minLength: 1 }, dictionaryUri: URI, relatedIfcEntity: { type: 'string' },
+        limit: { type: 'integer', minimum: 1, description: 'At most 20.' },
+    }, ['text']),
+    async run(input, ctx) {
+        const results = await client(ctx).search({ ...input, limit: clampLimit(input.limit, 10, 20) }, ctx.signal);
+        return success(`${results.length} bSDD classes for "${input.text}"`, { results: results.slice(0, 20) });
+    },
+});
+const classCard = defineTool({
+    name: 'bsdd_class', group: 'bsdd', strict: true, readOnly: true,
+    description: 'The card of one bSDD class by URI: code, name, dictionary, definition and related IFC entities.',
+    inputSchema: objectSchema({ uri: URI }, ['uri']),
+    async run(input, ctx) {
+        const card = await client(ctx).getClass(input.uri, ctx.signal);
+        if (!card)
+            return failure('unknown bSDD class', { error: `No bSDD class at ${input.uri}.` }, [`BSDD:${input.uri}`]);
+        return success(`bSDD class ${card.code}`, { ...card, ...(card.definition ? { definition: capText(card.definition, 500) } : {}) });
+    },
+});
+const properties = defineTool({
+    name: 'bsdd_properties', group: 'bsdd', strict: true, readOnly: true,
+    description: 'The properties a bSDD class defines: code, name, property set, data type, units and allowed values.',
+    inputSchema: objectSchema({ uri: URI }, ['uri']),
+    async run(input, ctx) {
+        const props = await client(ctx).classProperties(input.uri, ctx.signal);
+        return success(`${props.length} bSDD properties`, {
+            properties: props.slice(0, 60).map((p) => ({ ...p, ...(p.allowedValues ? { allowedValues: p.allowedValues.slice(0, 40) } : {}),
+                ...(p.definition ? { definition: capText(p.definition, 200) } : {}) })),
+        });
+    },
+});
+const resolveUri = defineTool({
+    name: 'bsdd_resolve_uri', group: 'bsdd', strict: true, readOnly: true,
+    description: 'Resolve a bSDD URI (class, property or dictionary) to what it identifies.',
+    inputSchema: objectSchema({ uri: URI }, ['uri']),
+    async run(input, ctx) {
+        const resolution = await client(ctx).resolveUri(input.uri, ctx.signal);
+        if (resolution.kind === 'unknown')
+            return failure('unknown URI', { error: `${input.uri} does not resolve in bSDD.` }, [`BSDD:${input.uri}`]);
+        return success(`bSDD ${resolution.kind}`, { ...resolution });
+    },
+});
+export const BSDD_TOOLS = [search, classCard, properties, resolveUri];
+//# sourceMappingURL=bsdd-tools.js.map

package/dist/tools/bsdd-tools.js.map

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

package/dist/tools/context.d.ts

@@ -0,0 +1,27 @@
+import type { GateContext } from '@ifc-lite/ids-authoring';
+import type { JsonSchema } from '@ifc-lite/ids-authoring';
+import type { AskUserHandler, BsddClient, ModelBridge } from '../bridges.js';
+import type { Sandbox } from '../sandbox/sandbox.js';
+import type { AgentTool } from './registry.js';
+/** What a tool handler can reach during one call. */
+export interface AgentToolContext {
+    readonly sandbox: Sandbox;
+    readonly gate: GateContext;
+    readonly model?: ModelBridge;
+    readonly bsdd?: BsddClient;
+    readonly askUser: AskUserHandler;
+    readonly signal: AbortSignal;
+    /** The provider's id of the call being answered. */
+    readonly callId: string;
+}
+export type IdsAgentTool = AgentTool<AgentToolContext>;
+/** IFC versions an IDS specification can name. */
+export declare const IFC_VERSIONS: readonly ["IFC2X3", "IFC4", "IFC4X3_ADD2"];
+export declare const versionSchema: JsonSchema;
+/** A closed object schema (what strict tool use requires). */
+export declare function objectSchema(properties: Record<string, JsonSchema>, required: readonly string[]): JsonSchema;
+/** Clamp a caller-supplied limit; the schema interpreter has no `maximum`. */
+export declare function clampLimit(value: number | undefined, fallback: number, max: number): number;
+/** Cap a string sent to the model (values read from a model are data, never instructions). */
+export declare function capText(value: string, max?: number): string;
+//# sourceMappingURL=context.d.ts.map

package/dist/tools/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAAC;AAEvD,kDAAkD;AAClD,eAAO,MAAM,YAAY,4CAA6C,CAAC;AAEvE,eAAO,MAAM,aAAa,EAAE,UAA4F,CAAC;AAEzH,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAE5G;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAG3F;AAED,8FAA8F;AAC9F,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAM,GAAG,MAAM,CAExD"}

package/dist/tools/context.js

@@ -0,0 +1,21 @@
+/* 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/. */
+/** IFC versions an IDS specification can name. */
+export const IFC_VERSIONS = ['IFC2X3', 'IFC4', 'IFC4X3_ADD2'];
+export const versionSchema = { enum: IFC_VERSIONS, description: 'IFC schema version of the specification.' };
+/** A closed object schema (what strict tool use requires). */
+export function objectSchema(properties, required) {
+    return { type: 'object', properties, required, additionalProperties: false };
+}
+/** Clamp a caller-supplied limit; the schema interpreter has no `maximum`. */
+export function clampLimit(value, fallback, max) {
+    if (value === undefined || !Number.isFinite(value))
+        return fallback;
+    return Math.max(1, Math.min(max, Math.floor(value)));
+}
+/** Cap a string sent to the model (values read from a model are data, never instructions). */
+export function capText(value, max = 200) {
+    return value.length > max ? `${value.slice(0, max)}…` : value;
+}
+//# sourceMappingURL=context.js.map

package/dist/tools/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAsB/D,kDAAkD;AAClD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAU,CAAC;AAEvE,MAAM,CAAC,MAAM,aAAa,GAAe,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,0CAA0C,EAAE,CAAC;AAEzH,8DAA8D;AAC9D,MAAM,UAAU,YAAY,CAAC,UAAsC,EAAE,QAA2B;IAC9F,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC;AAC/E,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,UAAU,CAAC,KAAyB,EAAE,QAAgB,EAAE,GAAW;IACjF,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IACpE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,GAAG,GAAG,GAAG;IAC9C,OAAO,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;AAChE,CAAC"}

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

@@ -0,0 +1,26 @@
+import { type StudioDocument, type Uuid } from '@ifc-lite/ids-authoring';
+import { type IdsAgentTool } from './context.js';
+/** The compact document view used by `ids_read` and by the loop's context block. */
+export declare function summarizeDocument(doc: StudioDocument, specIds?: readonly string[]): {
+    title: string;
+    specificationCount: number;
+    specifications: {
+        applicability: {
+            facetId: Uuid;
+            type: "property" | "entity" | "attribute" | "classification" | "material" | "partOf";
+            text: string;
+        }[];
+        requirements: {
+            facetId: Uuid;
+            type: "property" | "entity" | "attribute" | "classification" | "material" | "partOf";
+            text: string;
+        }[];
+        identifier?: string | undefined;
+        specId: string;
+        name: string;
+        ifcVersions: import("@ifc-lite/ids").IFCVersion[];
+        cardinality: "required" | "optional" | "prohibited";
+    }[];
+};
+export declare const IDS_READ_TOOLS: readonly IdsAgentTool[];
+//# sourceMappingURL=ids-read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ids-read.d.ts","sourceRoot":"","sources":["../../src/tools/ids-read.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAkD,KAAK,cAAc,EAAE,KAAK,IAAI,EAAE,MAAM,yBAAyB,CAAC;AACzH,OAAO,EAAuC,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AA0BtF,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE;;;;;qBAJpB,IAAI;;;;;qBAAJ,IAAI;;;;;;;;;;EAmBjE;AAkCD,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAAc,CAAC"}

package/dist/tools/ids-read.js

@@ -0,0 +1,74 @@
+/* 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 { describeFacet } from '@ifc-lite/ids-authoring';
+import { objectSchema } from './context.js';
+import { defineTool, success } from './registry.js';
+function cardinality(spec) {
+    if (spec.maxOccurs === 0)
+        return 'prohibited';
+    return (spec.minOccurs ?? 0) > 0 ? 'required' : 'optional';
+}
+function facetLine(facet, section, optionality) {
+    return describeFacet(facet, section, optionality ?? 'required', 'en');
+}
+function selected(doc, specIds) {
+    const wanted = specIds && specIds.length > 0 ? new Set(specIds) : null;
+    return doc.ids.specifications
+        .map((spec, i) => ({ spec, nodes: doc.nodes.specs[i] }))
+        .filter(({ nodes }) => !wanted || wanted.has(nodes.id));
+}
+function facetEntries(facets, nodes, section, optionalities) {
+    return facets.map((facet, i) => ({ facetId: nodes[i]?.id, type: facet.type, text: facetLine(facet, section, optionalities?.[i]) }));
+}
+/** The compact document view used by `ids_read` and by the loop's context block. */
+export function summarizeDocument(doc, specIds) {
+    return {
+        title: doc.ids.info.title,
+        specificationCount: doc.ids.specifications.length,
+        specifications: selected(doc, specIds).map(({ spec, nodes }) => ({
+            specId: nodes.id,
+            name: spec.name,
+            ifcVersions: spec.ifcVersions,
+            cardinality: cardinality(spec),
+            ...(spec.identifier ? { identifier: spec.identifier } : {}),
+            applicability: facetEntries(spec.applicability.facets, nodes.applicability, 'applicability'),
+            requirements: facetEntries(spec.requirements.map((r) => r.facet), nodes.requirements, 'requirements', spec.requirements.map((r) => r.optionality ?? 'required')),
+        })),
+    };
+}
+function fullView(doc, specIds) {
+    return {
+        info: doc.ids.info,
+        specifications: selected(doc, specIds).map(({ spec, nodes }) => ({ nodes, specification: spec })),
+    };
+}
+function plainView(doc, specIds) {
+    const lines = [`IDS "${doc.ids.info.title}"`];
+    for (const { spec } of selected(doc, specIds)) {
+        lines.push(`- ${spec.name} (${spec.ifcVersions.join(', ')}, ${cardinality(spec)})`);
+        for (const f of spec.applicability.facets)
+            lines.push(`  applies to: ${facetLine(f, 'applicability')}`);
+        for (const r of spec.requirements)
+            lines.push(`  requires: ${facetLine(r.facet, 'requirements', r.optionality ?? 'required')}`);
+    }
+    return lines.join('\n');
+}
+const idsRead = defineTool({
+    name: 'ids_read', group: 'ids', strict: true, readOnly: true,
+    description: 'Read the working IDS document. view "summary" lists specifications and facets with their node ids; "full" returns the IDS content of the selected specifications; "plain" returns plain-language sentences.',
+    inputSchema: objectSchema({
+        view: { enum: ['summary', 'full', 'plain'] },
+        specIds: { type: 'array', items: { type: 'string' }, description: 'Restrict to these specification ids.' },
+    }, ['view']),
+    run(input, ctx) {
+        const doc = ctx.sandbox.doc;
+        if (input.view === 'plain')
+            return success('plain view', { text: plainView(doc, input.specIds) });
+        if (input.view === 'full')
+            return success('full view', fullView(doc, input.specIds));
+        return success('summary view', summarizeDocument(doc, input.specIds));
+    },
+});
+export const IDS_READ_TOOLS = [idsRead];
+//# sourceMappingURL=ids-read.js.map

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

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

package/dist/tools/index.d.ts

@@ -0,0 +1,11 @@
+/** The v1 tool set, assembled per mode and per what the host provides. */
+import type { ModeConfig } from '../modes.js';
+import type { AgentToolContext, IdsAgentTool } from './context.js';
+import { type ToolRegistry } from './registry.js';
+/** Every v1 tool, in the stable order they are offered (prompt caching depends on it). */
+export declare const ALL_TOOLS: readonly IdsAgentTool[];
+export declare function registryFor(mode: ModeConfig, available: {
+    model: boolean;
+    bsdd: boolean;
+}): ToolRegistry<AgentToolContext>;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAIA,0EAA0E;AAE1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGnE,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAGtE,0FAA0F;AAC1F,eAAO,MAAM,SAAS,EAAE,SAAS,YAAY,EAE5C,CAAC;AAEF,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAO1H"}

package/dist/tools/index.js

@@ -0,0 +1,22 @@
+/* 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 { ACT_TOOLS } from './act-tools.js';
+import { ASK_USER_TOOLS } from './ask-user.js';
+import { BSDD_TOOLS } from './bsdd-tools.js';
+import { IDS_READ_TOOLS } from './ids-read.js';
+import { MODEL_TOOLS } from './model-tools.js';
+import { createToolRegistry } from './registry.js';
+import { SCHEMA_TOOLS } from './schema-tools.js';
+/** Every v1 tool, in the stable order they are offered (prompt caching depends on it). */
+export const ALL_TOOLS = [
+    ...SCHEMA_TOOLS, ...IDS_READ_TOOLS, ...ACT_TOOLS, ...ASK_USER_TOOLS, ...MODEL_TOOLS, ...BSDD_TOOLS,
+];
+export function registryFor(mode, available) {
+    const excluded = new Set(mode.excludeTools ?? []);
+    return createToolRegistry(ALL_TOOLS.filter((t) => mode.toolGroups.includes(t.group)
+        && !excluded.has(t.name)
+        && (t.group !== 'model' || available.model)
+        && (t.group !== 'bsdd' || available.bsdd)));
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAK/D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAqB,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,0FAA0F;AAC1F,MAAM,CAAC,MAAM,SAAS,GAA4B;IAChD,GAAG,YAAY,EAAE,GAAG,cAAc,EAAE,GAAG,SAAS,EAAE,GAAG,cAAc,EAAE,GAAG,WAAW,EAAE,GAAG,UAAU;CACnG,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,IAAgB,EAAE,SAA4C;IACxF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IAClD,OAAO,kBAAkB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;WAC9B,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;WACrB,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC;WACxC,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC"}

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

@@ -0,0 +1,3 @@
+import { type IdsAgentTool } from './context.js';
+export declare const MODEL_TOOLS: readonly IdsAgentTool[];
+//# sourceMappingURL=model-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model-tools.d.ts","sourceRoot":"","sources":["../../src/tools/model-tools.ts"],"names":[],"mappings":"AAcA,OAAO,EAA0E,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAgGzH,eAAO,MAAM,WAAW,EAAE,SAAS,YAAY,EAA8C,CAAC"}

package/dist/tools/model-tools.js

@@ -0,0 +1,100 @@
+/* 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 { facetFromDraft } from '@ifc-lite/ids-authoring';
+import { capText, clampLimit, objectSchema, IFC_VERSIONS } from './context.js';
+import { agentOpSchema } from './op-schema.js';
+import { defineTool, failure, success } from './registry.js';
+function bridge(ctx) {
+    if (!ctx.model)
+        throw new Error('No model is loaded.');
+    return ctx.model;
+}
+function specFacets(ctx, specId) {
+    const index = ctx.sandbox.doc.nodes.specs.findIndex((s) => s.id === specId);
+    if (index < 0)
+        return null;
+    const spec = ctx.sandbox.doc.ids.specifications[index];
+    return { applicability: spec.applicability.facets, requirements: spec.requirements.map((r) => r.facet) };
+}
+const stats = defineTool({
+    name: 'model_stats', group: 'model', strict: true, readOnly: true,
+    description: 'Loaded IFC models: schema, element count, most frequent classes and length unit.',
+    inputSchema: objectSchema({}, []),
+    async run(_input, ctx) {
+        const models = await bridge(ctx).stats(ctx.signal);
+        return success(`${models.length} models`, {
+            models: models.map((m) => ({ ...m, classes: m.classes.slice(0, 30) })),
+        });
+    },
+});
+const count = defineTool({
+    name: 'model_count', group: 'model', strict: false, readOnly: true,
+    description: 'Funnel counts in the loaded models: how many elements remain after each applicability facet. Give a specId (and get its requirement pass/fail preview too) or facets as drafts.',
+    inputSchema: objectSchema({
+        specId: { type: 'string' },
+        applicability: { type: 'array', items: { $ref: '#/$defs/FacetDraft' } },
+        ifcVersions: { type: 'array', items: { enum: IFC_VERSIONS } },
+    }, []),
+    defs: agentOpSchema().defs,
+    async run(input, ctx) {
+        let query;
+        if (input.specId) {
+            const facets = specFacets(ctx, input.specId);
+            if (!facets)
+                return failure('unknown spec', { error: `No specification has id "${input.specId}".` }, [`COUNT:${input.specId}`]);
+            query = facets;
+        }
+        else if (input.applicability && input.applicability.length > 0) {
+            query = { applicability: input.applicability.map(facetFromDraft) };
+        }
+        else {
+            return failure('nothing to count', { error: 'Give a specId or at least one applicability facet.' }, ['COUNT:empty']);
+        }
+        const counts = await bridge(ctx).count({ ...query, ...(input.ifcVersions ? { ifcVersions: input.ifcVersions } : {}) }, ctx.signal);
+        return success(`${counts.applicable} applicable`, { ...counts, ...(counts.applicable === 0 ? { warning: 'No element matches; check the applicability against model_stats before finishing.' } : {}) });
+    },
+});
+const distinct = defineTool({
+    name: 'model_distinct_values', group: 'model', strict: true, readOnly: true,
+    description: 'Distinct values of one property in the loaded models (optionally for one entity), with counts. Capped; long strings are truncated.',
+    inputSchema: objectSchema({
+        entity: { type: 'string' }, propertySet: { type: 'string', minLength: 1 }, property: { type: 'string', minLength: 1 },
+        limit: { type: 'integer', minimum: 1, description: 'At most 50.' },
+    }, ['propertySet', 'property']),
+    async run(input, ctx) {
+        const limit = clampLimit(input.limit, 20, 50);
+        const result = await bridge(ctx).distinctValues({ ...input, limit }, ctx.signal);
+        const values = result.values.slice(0, limit).map((v) => ({ value: capText(v.value, 120), count: v.count }));
+        return success(`${values.length} values of ${input.propertySet}.${input.property}`, {
+            values, truncated: result.truncated || result.values.length > limit || values.some((v, i) => v.value !== result.values[i].value),
+        });
+    },
+});
+const infer = defineTool({
+    name: 'model_infer', group: 'model', strict: true, readOnly: true,
+    description: 'Infer applicability and requirement facets from elements: the current selection (selection: "current") or every element of an entity. Each candidate comes with how many examples have it.',
+    inputSchema: objectSchema({
+        selection: { enum: ['current'] }, entity: { type: 'string' },
+        threshold: { type: 'number', minimum: 0, description: 'Share of examples (0..1) that must have a facet; default 1.' },
+    }, []),
+    async run(input, ctx) {
+        if (!input.selection && !input.entity)
+            return failure('nothing to infer from', { error: 'Give selection "current" or an entity.' }, ['INFER:empty']);
+        const threshold = input.threshold === undefined ? 1 : Math.min(1, input.threshold);
+        const result = await bridge(ctx).infer({ ...(input.selection ? { selection: input.selection } : {}), ...(input.entity ? { entity: input.entity } : {}), threshold }, ctx.signal);
+        return success(`${result.candidates.length} candidates`, { candidates: result.candidates.slice(0, 40), sampled: result.sampled });
+    },
+});
+const coverage = defineTool({
+    name: 'model_coverage', group: 'model', strict: true, readOnly: true,
+    description: 'IFC classes in the loaded models that no specification of the working document applies to, by element count.',
+    inputSchema: objectSchema({}, []),
+    async run(_input, ctx) {
+        const applicabilities = ctx.sandbox.doc.ids.specifications.map((s) => s.applicability.facets);
+        const classes = await bridge(ctx).coverage({ applicabilities }, ctx.signal);
+        return success(`${classes.length} ungoverned classes`, { ungoverned: classes.slice(0, 30) });
+    },
+});
+export const MODEL_TOOLS = [stats, count, distinct, infer, coverage];
+//# sourceMappingURL=model-tools.js.map

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * The agent's view of the op vocabulary, derived from `getOpJsonSchema()`
+ * at load time (never copied by hand):
+ *
+ * - the fidelity kinds (`*.restore`, `*.patch`) are dropped: the reducer
+ *   emits them as exact inverses, an author never writes them;
+ * - `opId` becomes optional (the sandbox fills it);
+ * - a node id may be a handle (`@doors`) as well as a UUID.
+ *
+ * Everything else, including every payload schema, is the vocabulary's own.
+ * The sandbox still validates the RESOLVED ops against the real schema in
+ * the gate, so this relaxation cannot let a malformed op through.
+ */
+import { type JsonSchema } from '@ifc-lite/ids-authoring';
+export interface AgentOpSchema {
+    /** Schema of one op as the agent may write it: `{ $ref: '#/$defs/AgentOp' }`. */
+    op: JsonSchema;
+    defs: Record<string, JsonSchema>;
+    /** The op kinds the agent may use, in vocabulary order. */
+    kinds: string[];
+}
+export declare function agentOpSchema(): AgentOpSchema;
+//# sourceMappingURL=op-schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"op-schema.d.ts","sourceRoot":"","sources":["../../src/tools/op-schema.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAM3E,MAAM,WAAW,aAAa;IAC5B,iFAAiF;IACjF,EAAE,EAAE,UAAU,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACjC,2DAA2D;IAC3D,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AASD,wBAAgB,aAAa,IAAI,aAAa,CA2B7C"}

package/dist/tools/op-schema.js

@@ -0,0 +1,57 @@
+/* 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/. */
+/**
+ * The agent's view of the op vocabulary, derived from `getOpJsonSchema()`
+ * at load time (never copied by hand):
+ *
+ * - the fidelity kinds (`*.restore`, `*.patch`) are dropped: the reducer
+ *   emits them as exact inverses, an author never writes them;
+ * - `opId` becomes optional (the sandbox fills it);
+ * - a node id may be a handle (`@doors`) as well as a UUID.
+ *
+ * Everything else, including every payload schema, is the vocabulary's own.
+ * The sandbox still validates the RESOLVED ops against the real schema in
+ * the gate, so this relaxation cannot let a malformed op through.
+ */
+import { getOpJsonSchema } from '@ifc-lite/ids-authoring';
+import { FIDELITY_KINDS } from '../sandbox/sandbox.js';
+import { HANDLE_PATTERN } from '../sandbox/handles.js';
+const UUID_BODY = '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}';
+function opKind(def) {
+    const kind = def.properties?.kind?.const;
+    return typeof kind === 'string' ? kind : undefined;
+}
+let cached;
+export function agentOpSchema() {
+    if (cached)
+        return cached;
+    const full = getOpJsonSchema();
+    // `getOpJsonSchema` returns plain JSON Schema data built from `JsonSchema` values.
+    const source = full.$defs;
+    const defs = {};
+    const refs = [];
+    const kinds = [];
+    for (const [name, def] of Object.entries(source)) {
+        const kind = name.startsWith('Op_') ? opKind(def) : undefined;
+        if (kind === undefined) {
+            if (name !== 'StudioOp')
+                defs[name] = def;
+            continue;
+        }
+        if (FIDELITY_KINDS.has(kind))
+            continue;
+        defs[name] = { ...def, required: (def.required ?? []).filter((key) => key !== 'opId') };
+        refs.push({ $ref: `#/$defs/${name}` });
+        kinds.push(kind);
+    }
+    defs.Uuid = {
+        type: 'string',
+        pattern: `^(?:${UUID_BODY}|${HANDLE_PATTERN.slice(1, -1)})$`,
+        description: 'A node UUID from ids_read, or a handle "@name" for a node created in this run.',
+    };
+    defs.AgentOp = { oneOf: refs };
+    cached = { op: { $ref: '#/$defs/AgentOp' }, defs, kinds };
+    return cached;
+}
+//# sourceMappingURL=op-schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"op-schema.js","sourceRoot":"","sources":["../../src/tools/op-schema.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,eAAe,EAAmB,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,SAAS,GAAG,8DAA8D,CAAC;AAUjF,SAAS,MAAM,CAAC,GAAe;IAC7B,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,KAAK,CAAC;IACzC,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC;AAED,IAAI,MAAiC,CAAC;AAEtC,MAAM,UAAU,aAAa;IAC3B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,mFAAmF;IACnF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAmC,CAAC;IACxD,MAAM,IAAI,GAA+B,EAAE,CAAC;IAC5C,MAAM,IAAI,GAAiB,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,IAAI,IAAI,KAAK,UAAU;gBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;YAC1C,SAAS;QACX,CAAC;QACD,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QACvC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,MAAM,CAAC,EAAE,CAAC;QACxF,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,IAAI,EAAE,EAAE,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,IAAI,GAAG;QACV,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,OAAO,SAAS,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;QAC5D,WAAW,EAAE,gFAAgF;KAC9F,CAAC;IACF,IAAI,CAAC,OAAO,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC/B,MAAM,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC1D,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/rank.d.ts

@@ -0,0 +1,3 @@
+/** The best `limit` names for `query`, best first; ties keep the input order. */
+export declare function rankNames(query: string, names: readonly string[], limit: number): string[];
+//# sourceMappingURL=rank.d.ts.map

package/dist/tools/rank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rank.d.ts","sourceRoot":"","sources":["../../src/tools/rank.ts"],"names":[],"mappings":"AAoDA,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAU1F"}