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

package/dist/tools/rank.js

@@ -0,0 +1,66 @@
+/* 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/. */
+/**
+ * Lexical ranking for lookup tools. Deterministic and dependency-free: exact
+ * match, then prefix, then every query token contained, then a bounded edit
+ * distance for typos. The `Ifc` prefix and case are ignored.
+ */
+function fold(value) {
+    return value.toLowerCase().replace(/^ifc/, '').replace(/[\s_-]+/g, '');
+}
+/** Split `FireRating`, `fire rating`, `fire_rating` into lower-case tokens. */
+function tokens(value) {
+    return value
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter((t) => t.length > 0 && t !== 'ifc');
+}
+function distance(a, b, cap) {
+    if (Math.abs(a.length - b.length) > cap)
+        return cap + 1;
+    let prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+    for (let i = 1; i <= a.length; i++) {
+        const row = [i];
+        let best = i;
+        for (let j = 1; j <= b.length; j++) {
+            row[j] = Math.min(prev[j] + 1, row[j - 1] + 1, prev[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1));
+            best = Math.min(best, row[j]);
+        }
+        if (best > cap)
+            return cap + 1;
+        prev = row;
+    }
+    return prev[b.length];
+}
+function score(query, queryTokens, name) {
+    const folded = fold(name);
+    if (folded === query)
+        return 100;
+    if (folded.startsWith(query))
+        return 80 - Math.min(20, folded.length - query.length);
+    const nameTokens = tokens(name);
+    const all = queryTokens.length > 0 && queryTokens.every((q) => nameTokens.some((t) => t.startsWith(q)) || folded.includes(q));
+    if (all)
+        return 60 - Math.min(20, folded.length - query.length);
+    if (folded.includes(query))
+        return 50;
+    const cap = Math.max(1, Math.floor(query.length / 4));
+    const d = distance(query, folded, cap);
+    return d <= cap ? 40 - d * 5 : 0;
+}
+/** The best `limit` names for `query`, best first; ties keep the input order. */
+export function rankNames(query, names, limit) {
+    const q = fold(query);
+    if (!q)
+        return [];
+    const qt = tokens(query);
+    return names
+        .map((name, index) => ({ name, index, s: score(q, qt, name) }))
+        .filter((r) => r.s > 0)
+        .sort((a, b) => b.s - a.s || a.index - b.index)
+        .slice(0, limit)
+        .map((r) => r.name);
+}
+//# sourceMappingURL=rank.js.map

package/dist/tools/rank.js.map

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

package/dist/tools/registry.d.ts

@@ -0,0 +1,59 @@
+/**
+ * The tool registry: every tool is one JSON Schema plus a handler.
+ *
+ * The workspace has no zod. The schema handed to the provider and the check
+ * run before the handler are the same object, interpreted by the op
+ * contract's own validator (`validateJson` from `@ifc-lite/ids-authoring`),
+ * so a tool definition cannot drift from what it accepts. `ids_apply_ops`
+ * embeds the op vocabulary's schema (`getOpJsonSchema`) rather than a copy.
+ *
+ * A call never throws into the loop: an unknown tool, unparseable JSON, a
+ * schema violation and a handler failure all come back as an error result
+ * the model reads and can correct.
+ */
+import type { ToolSpec } from '@ifc-lite/ai';
+import { type JsonSchema } from '@ifc-lite/ids-authoring';
+/** Tool names are `[a-z_]` (providers reject dots), grouped by prefix: `schema_`, `ids_`, `model_`, `bsdd_`. */
+export type ToolGroup = 'schema' | 'ids' | 'model' | 'bsdd';
+export interface ToolOutcome {
+    ok: boolean;
+    /** Serialised as the tool result the model reads. */
+    data: unknown;
+    /** One line for progress events and receipts; never document content. */
+    summary: string;
+    /**
+     * Stable failure keys (gate code + offending value, diagnostic code + node)
+     * used by no-progress detection. Empty or absent on success.
+     */
+    signature?: readonly string[];
+}
+export interface AgentTool<Ctx> {
+    readonly name: string;
+    readonly group: ToolGroup;
+    readonly description: string;
+    readonly inputSchema: JsonSchema;
+    /** Shared `$defs` the input schema refers to. */
+    readonly defs?: Readonly<Record<string, JsonSchema>>;
+    /** Ask the provider for strict, schema-constrained inputs (small schemas only). */
+    readonly strict: boolean;
+    /** True when the tool cannot change the sandbox document. */
+    readonly readOnly: boolean;
+    run(input: unknown, ctx: Ctx): Promise<ToolOutcome> | ToolOutcome;
+}
+export interface ToolDefinition<Input, Ctx> extends Omit<AgentTool<Ctx>, 'run'> {
+    /** Called only with input that passed `inputSchema`. */
+    run(input: Input, ctx: Ctx): Promise<ToolOutcome> | ToolOutcome;
+}
+/** Declare a tool whose handler receives schema-validated input of type `Input`. */
+export declare function defineTool<Input, Ctx>(definition: ToolDefinition<Input, Ctx>): AgentTool<Ctx>;
+export interface ToolRegistry<Ctx> {
+    readonly tools: readonly AgentTool<Ctx>[];
+    /** Provider-neutral definitions, in registration order (stable for prompt caching). */
+    specs(): ToolSpec[];
+    has(name: string): boolean;
+    call(name: string, input: unknown, rawInput: string | undefined, ctx: Ctx): Promise<ToolOutcome>;
+}
+export declare function failure(summary: string, data: Record<string, unknown>, signature?: readonly string[]): ToolOutcome;
+export declare function success(summary: string, data: Record<string, unknown>): ToolOutcome;
+export declare function createToolRegistry<Ctx>(tools: readonly AgentTool<Ctx>[]): ToolRegistry<Ctx>;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAgB,KAAK,UAAU,EAAoB,MAAM,yBAAyB,CAAC;AAE1F,gHAAgH;AAChH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,qDAAqD;IACrD,IAAI,EAAE,OAAO,CAAC;IACd,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS,CAAC,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;IACjC,iDAAiD;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IACrD,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAAC;CACnE;AAED,MAAM,WAAW,cAAc,CAAC,KAAK,EAAE,GAAG,CAAE,SAAQ,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC;IAC7E,wDAAwD;IACxD,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAAC;CACjE;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAI7F;AAED,MAAM,WAAW,YAAY,CAAC,GAAG;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;IAC1C,uFAAuF;IACvF,KAAK,IAAI,QAAQ,EAAE,CAAC;IACpB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAClG;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,CAElH;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAEnF;AAYD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,YAAY,CAAC,GAAG,CAAC,CAgC3F"}

package/dist/tools/registry.js

@@ -0,0 +1,61 @@
+/* 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 { validateJson } from '@ifc-lite/ids-authoring';
+/** Declare a tool whose handler receives schema-validated input of type `Input`. */
+export function defineTool(definition) {
+    // The registry validates against `inputSchema` before `run`, so the
+    // narrowing below is the schema's own guarantee.
+    return { ...definition, run: (input, ctx) => definition.run(input, ctx) };
+}
+export function failure(summary, data, signature) {
+    return { ok: false, summary, data: { ok: false, ...data }, ...(signature ? { signature } : {}) };
+}
+export function success(summary, data) {
+    return { ok: true, summary, data: { ok: true, ...data } };
+}
+function toSpec(tool) {
+    const schema = { ...tool.inputSchema };
+    if (tool.defs)
+        schema.$defs = tool.defs;
+    return { name: tool.name, description: tool.description, inputSchema: schema, strict: tool.strict };
+}
+function formatErrors(errors) {
+    return errors.slice(0, 20).map((e) => `${e.path}: ${e.message}`);
+}
+export function createToolRegistry(tools) {
+    const byName = new Map();
+    for (const tool of tools) {
+        if (!/^[a-z][a-z0-9_]{0,63}$/.test(tool.name))
+            throw new Error(`Invalid tool name "${tool.name}"`);
+        if (byName.has(tool.name))
+            throw new Error(`Duplicate tool "${tool.name}"`);
+        byName.set(tool.name, tool);
+    }
+    return {
+        tools,
+        specs: () => tools.map(toSpec),
+        has: (name) => byName.has(name),
+        async call(name, input, rawInput, ctx) {
+            const tool = byName.get(name);
+            if (!tool) {
+                return failure(`unknown tool ${name}`, { error: `There is no tool named "${name}".`, tools: [...byName.keys()] }, [`TOOL:${name}`]);
+            }
+            if (rawInput !== undefined) {
+                return failure(`${name}: invalid JSON`, { error: 'INVALID_JSON', input: rawInput.slice(0, 2000) }, [`JSON:${name}`]);
+            }
+            const errors = validateJson(input, tool.inputSchema, { ...tool.defs });
+            if (errors.length > 0) {
+                return failure(`${name}: invalid input`, { error: 'The input does not match the tool schema.', errors: formatErrors(errors) }, errors.slice(0, 5).map((e) => `INPUT:${name}:${e.path}`));
+            }
+            try {
+                return await tool.run(input, ctx);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                return failure(`${name}: failed`, { error: message }, [`FAIL:${name}`]);
+            }
+        },
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema-tools.d.ts","sourceRoot":"","sources":["../../src/tools/schema-tools.ts"],"names":[],"mappings":"AAeA,OAAO,EAAkE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAoIjH,eAAO,MAAM,YAAY,EAAE,SAAS,YAAY,EAAmE,CAAC"}

package/dist/tools/schema-tools.js

@@ -0,0 +1,127 @@
+/* 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 { clampLimit, objectSchema, versionSchema } from './context.js';
+import { defineTool, failure, success } from './registry.js';
+import { rankNames } from './rank.js';
+function tables(ctx, version) {
+    return ctx.gate.tables[version];
+}
+function chain(t, name) {
+    const out = [];
+    const seen = new Set();
+    let cursor = t.entities.get(name.toUpperCase());
+    while (cursor && !seen.has(cursor.name)) {
+        out.push(cursor);
+        seen.add(cursor.name);
+        cursor = cursor.parent ? t.entities.get(cursor.parent.toUpperCase()) : undefined;
+    }
+    return out;
+}
+function applicablePsets(t, entity) {
+    const names = new Set(chain(t, entity).map((e) => e.name.toUpperCase()));
+    return [...t.psets.values()].filter((p) => p.applicableEntities.some((a) => names.has(a.toUpperCase())));
+}
+function unknownEntity(t, name, version) {
+    return failure(`unknown entity ${name}`, {
+        error: `"${name}" is not an entity in ${version}.`,
+        candidates: rankNames(name, t.entityNames, 5),
+    }, [`SCHEMA-ENT:${name}`]);
+}
+const searchEntities = defineTool({
+    name: 'schema_search_entities', group: 'schema', strict: true, readOnly: true,
+    description: 'Search IFC entity (class) names of one schema version by a word or partial name. Returns ranked names with parent, abstractness and predefined types.',
+    inputSchema: objectSchema({
+        query: { type: 'string', minLength: 1 },
+        version: versionSchema,
+        includeAbstract: { type: 'boolean' },
+        limit: { type: 'integer', minimum: 1, description: 'At most 25.' },
+    }, ['query', 'version']),
+    run(input, ctx) {
+        const t = tables(ctx, input.version);
+        const names = input.includeAbstract ? t.entityNames : t.entityNames.filter((n) => !t.entities.get(n.toUpperCase())?.abstract);
+        const hits = rankNames(input.query, names, clampLimit(input.limit, 10, 25)).map((name) => {
+            const e = t.entities.get(name.toUpperCase());
+            return { name, parent: e?.parent, abstract: e?.abstract ?? false, predefinedTypes: e?.predefinedTypes.slice(0, 15) ?? [] };
+        });
+        return success(`${hits.length} entities for "${input.query}"`, { version: input.version, results: hits });
+    },
+});
+const entityCard = defineTool({
+    name: 'schema_entity', group: 'schema', strict: true, readOnly: true,
+    description: 'The card of one IFC entity: inheritance chain, abstractness, predefined types, attributes (inherited included), direct subtypes, type entity and applicable property sets.',
+    inputSchema: objectSchema({ name: { type: 'string', minLength: 1 }, version: versionSchema }, ['name', 'version']),
+    run(input, ctx) {
+        const t = tables(ctx, input.version);
+        const e = t.entities.get(input.name.toUpperCase());
+        if (!e)
+            return unknownEntity(t, input.name, input.version);
+        const subtypes = [...t.entities.values()].filter((s) => s.parent?.toUpperCase() === e.name.toUpperCase()).map((s) => s.name);
+        return success(`entity ${e.name}`, {
+            version: input.version, name: e.name, abstract: e.abstract,
+            inheritance: chain(t, e.name).map((c) => c.name),
+            predefinedTypes: e.predefinedTypes, attributes: e.attributes,
+            subtypes: subtypes.slice(0, 40), typeEntity: e.typeEntity,
+            propertySets: applicablePsets(t, e.name).map((p) => p.name).slice(0, 60),
+        });
+    },
+});
+const psetsFor = defineTool({
+    name: 'schema_psets_for', group: 'schema', strict: true, readOnly: true,
+    description: 'Standard property and quantity sets applicable to an entity (through its inheritance), with their property names. Optionally filtered by a word matched against set and property names.',
+    inputSchema: objectSchema({ entity: { type: 'string', minLength: 1 }, version: versionSchema, query: { type: 'string' } }, ['entity', 'version']),
+    run(input, ctx) {
+        const t = tables(ctx, input.version);
+        if (!t.entities.has(input.entity.toUpperCase()))
+            return unknownEntity(t, input.entity, input.version);
+        const q = input.query?.trim().toLowerCase();
+        const sets = applicablePsets(t, input.entity)
+            .filter((p) => !q || p.name.toLowerCase().includes(q) || p.properties.some((pr) => pr.name.toLowerCase().includes(q)))
+            .slice(0, 40)
+            .map((p) => ({ name: p.name, properties: p.properties.map((pr) => pr.name).slice(0, 25) }));
+        return success(`${sets.length} sets for ${input.entity}`, {
+            version: input.version, entity: input.entity, propertySets: sets,
+            ...(t.hasQuantitySets ? {} : { note: 'Quantity sets (Qto_) are not tabulated for this version and are not listed.' }),
+        });
+    },
+});
+const psetCard = defineTool({
+    name: 'schema_pset', group: 'schema', strict: true, readOnly: true,
+    description: 'The properties of one standard property set: name, kind, data type and enumeration values, plus the entities it applies to.',
+    inputSchema: objectSchema({ name: { type: 'string', minLength: 1 }, version: versionSchema }, ['name', 'version']),
+    run(input, ctx) {
+        const t = tables(ctx, input.version);
+        const p = t.psets.get(input.name);
+        if (!p) {
+            return failure(`unknown set ${input.name}`, {
+                error: `"${input.name}" is not a standard property set in ${input.version}.`,
+                candidates: rankNames(input.name, t.psetNames, 5),
+            }, [`SCHEMA-PSET:${input.name}`]);
+        }
+        return success(`set ${p.name}`, {
+            version: input.version, name: p.name, applicableEntities: p.applicableEntities.slice(0, 30),
+            properties: p.properties.map((pr) => ({
+                name: pr.name, kind: pr.kind, ...(pr.dataType ? { dataType: pr.dataType } : {}),
+                ...(pr.enumeration ? { enumeration: pr.enumeration.slice(0, 40) } : {}),
+            })),
+        });
+    },
+});
+const findProperty = defineTool({
+    name: 'schema_find_property', group: 'schema', strict: true, readOnly: true,
+    description: 'Find the standard property sets that define a property, by full or partial property name. With an entity, only sets applicable to it are returned.',
+    inputSchema: objectSchema({ name: { type: 'string', minLength: 1 }, version: versionSchema, entity: { type: 'string' } }, ['name', 'version']),
+    run(input, ctx) {
+        const t = tables(ctx, input.version);
+        const allowed = input.entity ? new Set(applicablePsets(t, input.entity).map((p) => p.name)) : null;
+        const names = rankNames(input.name, [...t.psetsByProperty.keys()], 10);
+        const results = names.map((property) => {
+            const sets = (t.psetsByProperty.get(property) ?? []).filter((s) => !allowed || allowed.has(s));
+            const dataType = sets.map((s) => t.psets.get(s)?.properties.find((pr) => pr.name === property)?.dataType).find(Boolean);
+            return { property, propertySets: sets.slice(0, 15), ...(dataType ? { dataType } : {}) };
+        }).filter((r) => r.propertySets.length > 0);
+        return success(`${results.length} properties for "${input.name}"`, { version: input.version, results });
+    },
+});
+export const SCHEMA_TOOLS = [searchEntities, entityCard, psetsFor, psetCard, findProperty];
+//# sourceMappingURL=schema-tools.js.map

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

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

package/dist/worker-bridge.d.ts

@@ -0,0 +1,47 @@
+/**
+ * `ModelBridge` over a message port (IDS-078). The model data lives in the
+ * model-loop worker (`04-model-loop.md` §7); the agent runs on the main
+ * thread or in Node. `createWorkerModelBridge(port)` is the agent side,
+ * `serveModelBridge(port, impl)` the worker side. Requests carry an id;
+ * a cancelled request posts `cancel` and resolves as an abort error, and a
+ * late answer to it is dropped.
+ *
+ * Only the `ModelBridge` methods cross the port, with structured-clone data.
+ */
+import type { ModelBridge } from './bridges.js';
+type Method = 'stats' | 'count' | 'distinctValues' | 'infer' | 'coverage';
+export type BridgeRequest = {
+    type: 'call';
+    id: number;
+    method: Method;
+    arg: unknown;
+} | {
+    type: 'cancel';
+    id: number;
+};
+export type BridgeResponse = {
+    type: 'result';
+    id: number;
+    value: unknown;
+} | {
+    type: 'error';
+    id: number;
+    message: string;
+};
+/** The subset of `MessagePort` / `Worker` the bridge needs. */
+export interface BridgePort {
+    postMessage(message: unknown): void;
+    addEventListener(type: 'message', listener: (event: {
+        data: unknown;
+    }) => void): void;
+    removeEventListener(type: 'message', listener: (event: {
+        data: unknown;
+    }) => void): void;
+}
+export declare function createWorkerModelBridge(port: BridgePort): ModelBridge & {
+    dispose(): void;
+};
+/** Worker side: answer bridge requests from `impl`. Returns a function that stops serving. */
+export declare function serveModelBridge(port: BridgePort, impl: ModelBridge): () => void;
+export {};
+//# sourceMappingURL=worker-bridge.d.ts.map

package/dist/worker-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-bridge.d.ts","sourceRoot":"","sources":["../src/worker-bridge.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,KAAK,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,gBAAgB,GAAG,OAAO,GAAG,UAAU,CAAC;AAE1E,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AACxH,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7H,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IACtF,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;CAC1F;AAYD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG;IAAE,OAAO,IAAI,IAAI,CAAA;CAAE,CAwC3F;AAED,8FAA8F;AAC9F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,IAAI,CA8BhF"}

package/dist/worker-bridge.js

@@ -0,0 +1,97 @@
+/* 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/. */
+function isResponse(value) {
+    return typeof value === 'object' && value !== null && 'type' in value && 'id' in value
+        && (value.type === 'result' || value.type === 'error');
+}
+function isRequest(value) {
+    return typeof value === 'object' && value !== null && 'type' in value && 'id' in value
+        && (value.type === 'call' || value.type === 'cancel');
+}
+export function createWorkerModelBridge(port) {
+    let next = 0;
+    const pending = new Map();
+    const listener = (event) => {
+        if (!isResponse(event.data))
+            return;
+        const entry = pending.get(event.data.id);
+        if (!entry)
+            return; // a late answer to a cancelled request
+        pending.delete(event.data.id);
+        if (event.data.type === 'result')
+            entry.resolve(event.data.value);
+        else
+            entry.reject(new Error(event.data.message));
+    };
+    port.addEventListener('message', listener);
+    const call = (method, arg, signal) => new Promise((resolve, reject) => {
+        if (signal.aborted) {
+            reject(new Error('cancelled'));
+            return;
+        }
+        const id = ++next;
+        const onAbort = () => {
+            pending.delete(id);
+            port.postMessage({ type: 'cancel', id });
+            reject(new Error('cancelled'));
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+        // The worker answers with the value of `method`, whose type is `T`.
+        pending.set(id, {
+            resolve: (v) => { signal.removeEventListener('abort', onAbort); resolve(v); },
+            reject: (e) => { signal.removeEventListener('abort', onAbort); reject(e); },
+        });
+        port.postMessage({ type: 'call', id, method, arg });
+    });
+    return {
+        stats: (signal) => call('stats', null, signal),
+        count: (query, signal) => call('count', query, signal),
+        distinctValues: (query, signal) => call('distinctValues', query, signal),
+        infer: (query, signal) => call('infer', query, signal),
+        coverage: (query, signal) => call('coverage', query, signal),
+        dispose() {
+            port.removeEventListener('message', listener);
+            for (const entry of pending.values())
+                entry.reject(new Error('bridge disposed'));
+            pending.clear();
+        },
+    };
+}
+/** Worker side: answer bridge requests from `impl`. Returns a function that stops serving. */
+export function serveModelBridge(port, impl) {
+    const running = new Map();
+    const listener = (event) => {
+        const request = event.data;
+        if (!isRequest(request))
+            return;
+        if (request.type === 'cancel') {
+            running.get(request.id)?.abort();
+            running.delete(request.id);
+            return;
+        }
+        const controller = new AbortController();
+        running.set(request.id, controller);
+        const s = controller.signal;
+        // Each method receives the argument the agent side sent for it.
+        const work = request.method === 'stats' ? impl.stats(s)
+            : request.method === 'count' ? impl.count(request.arg, s)
+                : request.method === 'distinctValues' ? impl.distinctValues(request.arg, s)
+                    : request.method === 'infer' ? impl.infer(request.arg, s)
+                        : impl.coverage(request.arg, s);
+        work.then((value) => { if (running.delete(request.id))
+            port.postMessage({ type: 'result', id: request.id, value }); }, (error) => {
+            if (running.delete(request.id)) {
+                port.postMessage({ type: 'error', id: request.id, message: error instanceof Error ? error.message : String(error) });
+            }
+        });
+    };
+    port.addEventListener('message', listener);
+    return () => {
+        port.removeEventListener('message', listener);
+        for (const c of running.values())
+            c.abort();
+        running.clear();
+    };
+}
+//# sourceMappingURL=worker-bridge.js.map

package/dist/worker-bridge.js.map

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

package/package.json

@@ -1,6 +1,82 @@
 {
   "name": "@ifc-lite/ids-agent",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.1",
+  "description": "Headless IDS authoring agent: a tool-calling loop over the IDS Studio op vocabulary, grounded by the gate, producing reviewable proposals",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./anthropic": {
+      "types": "./dist/providers/anthropic.d.ts",
+      "import": "./dist/providers/anthropic.js",
+      "default": "./dist/providers/anthropic.js"
+    },
+    "./openai": {
+      "types": "./dist/providers/openai.d.ts",
+      "import": "./dist/providers/openai.js",
+      "default": "./dist/providers/openai.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js",
+      "default": "./dist/testing/index.js"
+    }
+  },
+  "dependencies": {
+    "@ifc-lite/ai": "^0.2.0",
+    "@ifc-lite/data": "6.2.0",
+    "@ifc-lite/ids": "3.3.1",
+    "@ifc-lite/ids-authoring": "0.2.1"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/sdk": ">=0.128.0"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/sdk": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@anthropic-ai/sdk": "^0.132.1",
+    "@types/node": "^26.6.5",
+    "typescript": "^6.0.3",
+    "vitest": "^5.0.3"
+  },
+  "license": "MPL-2.0",
+  "author": "Louis True",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/LTplus-AG/ifc-lite.git",
+    "directory": "packages/ids-agent"
+  },
+  "homepage": "https://ifclite.dev/docs/",
+  "bugs": "https://github.com/LTplus-AG/ifc-lite/issues",
+  "keywords": [
+    "ifc",
+    "bim",
+    "ids",
+    "buildingsmart",
+    "ai",
+    "agent",
+    "tool-use"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "pnpm exec tsc",
+    "typecheck": "node ../../scripts/typecheck-tests.mjs",
+    "dev": "pnpm exec tsc --watch",
+    "test": "vitest run"
+  }
 }