@ifc-lite/flow-nodes 0.6.0 → 0.8.0

package/README.md

@@ -31,6 +31,18 @@ const result = await runFlow(doc, { host: { bim }, registry, features: BROWSER_F
 `host.grants` (parsed capabilities from `@ifc-lite/extensions`) gates every node;
 omit it only for a trusted caller such as the CLI running a local file.
 
+## Stair and railing authoring
+
+`element.stair` and `element.railing` produce specs for the existing tracked
+`model.addElement` node. Their PascalCase parameters reuse the canonical SDK
+builders; dimensions are storey-local metres. Stair update/removal removes the
+uniquely owned parent/flight pair, retaining shared representation leaves and
+refusing ambiguous ownership or foreign product references. Unsupported backend
+capabilities refuse explicitly. All `model.addElement` updates use the optional
+atomic replacement capability, preserving the old graph and tracking entry
+on refusal, including a spec-kind change. Reuse a tracking store for keep/update/remove;
+public MCP `run_flow` starts fresh tracking on each call.
+
 ## Session automation host
 
 The seven standard automation definitions call `host.automation` and pass the
@@ -63,3 +75,33 @@ not rerun a comparison against the loaded models.
 ## License
 
 MPL-2.0
+
+The separate `@ifc-lite/flow-nodes/ai` entry includes `ai.propose`: a bounded,
+review-required draft over selected finding columns and explicit native
+field/value constraints. Its portable `model.changes` output cites captured
+rows and expected values, and performs no writes. Current-state validation and
+mutation approval remain native host responsibilities. See the
+[AI node and checkpoint contract](../../docs/guide/flow.md#ai-nodes-and-review-checkpoints).
+
+## BCF write response boundary
+
+Both create operations enrol the actual resolved bearer, including short literal
+and Player values. Successful DTO data, dynamic keys and outward diagnostics
+redact raw and JSON-escaped bearer occurrences. The primary `guid` and optional
+comment `topic_guid`, `viewpoint_guid` and `reply_to_comment_guid` are validated
+before an owned gateway saves the receipt and before any returned receipt is
+emitted. A credential-bearing identifier leaves the retained server effect
+uncertain; it is never silently renamed or retried. Clean identifier values,
+nullable optional relationships and their fixed protocol keys stay exact, even
+when a short bearer equals part of a key. Browser intent admission validates a
+closed schema and checks credential values and dynamic keys, so a bearer such
+as `id` does not reject fixed names such as `topicGuid`. Unknown fields and
+credential values, URL credentials and Authorization/Bearer syntax stay refused.
+A fixed protocol field name is not server-echoed credential data. Gateway errors preserve the host's refusal
+or recovery message as a plain `Error`, without its original class or cause.
+Direct sends use dispatch provenance: a preflight denial is definite; a refused
+redirect, HTTP 409, HTTP 5xx or missing response remains uncertain and never retries.
+Direct remote failures expose only the safe failure class and valid HTTP status;
+remote response bodies, detail URLs and error causes are discarded. Known local
+preflight diagnostics and gateway refusal/recovery text are retained after
+redacting the actual bearer, without carrying their original error cause.

package/dist/ai-classify.d.ts

@@ -0,0 +1,8 @@
+import type { FlowNodeDef } from './host.js';
+/** Read one batch reply into per-row results; anything not provable stays `unknown`. */
+export declare function readClassifications(value: Record<string, unknown>, batchKeys: ReadonlySet<string>, labels: ReadonlySet<string>, columns: ReadonlySet<string>): Map<string, {
+    label: string | null;
+    evidence: string[];
+}>;
+export declare const aiClassifyNode: FlowNodeDef;
+//# sourceMappingURL=ai-classify.d.ts.map

package/dist/ai-classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-classify.d.ts","sourceRoot":"","sources":["../src/ai-classify.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAsB7C,wFAAwF;AACxF,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GACxH,GAAG,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAa3D;AAED,eAAO,MAAM,cAAc,EAAE,WA2E5B,CAAC"}

package/dist/ai-classify.js

@@ -0,0 +1,113 @@
+/* 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 { SCALAR_ITEM, TABLE_ITEM } from './ports.js';
+import { AI_CAPABILITY, AI_FEATURE, aiService, dataBlock, positiveInt, requestJson, rowKeys, sentColumns } from './ai-service.js';
+import { classificationSchema } from './ai-response-schemas.js';
+function categoriesOf(value) {
+    if (!Array.isArray(value) || value.length === 0 || value.length > 50)
+        throw new Error('"categories" must list 1 to 50 { label, definition } entries');
+    const seen = new Set();
+    return value.map((c, i) => {
+        const label = typeof c?.label === 'string' ? c.label.trim() : '';
+        if (!label || label.length > 80 || label === 'unknown' || seen.has(label))
+            throw new Error(`category ${i + 1} needs a unique label other than "unknown"`);
+        seen.add(label);
+        return { label, definition: typeof c.definition === 'string' ? c.definition.slice(0, 500) : '' };
+    });
+}
+/** Read one batch reply into per-row results; anything not provable stays `unknown`. */
+export function readClassifications(value, batchKeys, labels, columns) {
+    const out = new Map();
+    const items = Array.isArray(value.items) ? value.items : [];
+    for (const raw of items) {
+        if (!raw || typeof raw !== 'object')
+            continue;
+        const item = raw;
+        const key = typeof item.key === 'string' ? item.key : null;
+        if (key === null || !batchKeys.has(key) || out.has(key))
+            continue;
+        const evidence = Array.isArray(item.evidence) ? [...new Set(item.evidence.filter((e) => typeof e === 'string' && columns.has(e)))] : [];
+        const label = typeof item.label === 'string' && labels.has(item.label) && evidence.length > 0 ? item.label : null;
+        out.set(key, { label, evidence: label ? evidence : [] });
+    }
+    return out;
+}
+export const aiClassifyNode = {
+    type: 'ai.classify', title: 'AI classify rows', category: 'ai',
+    doc: 'Label each row with one of the listed categories using the host AI model. Rows carry an outcome (classified, unknown, failed, not-sent) and the columns cited as evidence. The run pauses for review of the labels.',
+    inputs: [{ name: 'table', type: TABLE_ITEM }],
+    outputs: [{ name: 'table', type: TABLE_ITEM }, { name: 'coverage', type: SCALAR_ITEM }],
+    params: [
+        { name: 'categories', kind: 'json', default: [], doc: '[{ "label": "...", "definition": "..." }]' },
+        { name: 'version', kind: 'string', default: '1', doc: 'Version of the category definitions, kept with the result.' },
+        { name: 'columns', kind: 'json', default: [], doc: 'Columns sent to the model; select at least one explicitly.' },
+        { name: 'maxRows', kind: 'number', default: 200 },
+        { name: 'batchSize', kind: 'number', default: 25 },
+        { name: 'maxOutputTokens', kind: 'number', default: 2000, doc: 'Output ceiling per request.' },
+    ],
+    capabilities: [AI_CAPABILITY], requires: { backend: [AI_FEATURE], network: true }, volatile: true, review: 'required',
+    run: async (ctx, inputs, p) => {
+        const table = inputs.table;
+        const categories = categoriesOf(p.categories);
+        const columns = sentColumns(table, Array.isArray(p.columns) ? p.columns.map(String) : []);
+        const maxRows = positiveInt(p.maxRows, 'maxRows', 5000);
+        const batchSize = positiveInt(p.batchSize, 'batchSize', 100);
+        const maxOutputTokens = positiveInt(p.maxOutputTokens, 'maxOutputTokens', 32_000);
+        const service = aiService(ctx);
+        const keys = rowKeys(table);
+        const outcome = keys.map(() => 'not-sent');
+        const label = keys.map(() => null);
+        const evidence = keys.map(() => []);
+        const labels = new Set(categories.map((c) => c.label));
+        const task = [
+            `Classify each data row into exactly one category (definitions version ${String(p.version)}):`,
+            ...categories.map((c) => `- ${c.label}: ${c.definition}`),
+            'Reply {"items":[{"key":"<row key>","label":"<category label or unknown>","evidence":["<column name>"]}]} with one item per row.',
+            'Cite the column names whose values justify the label. Use "unknown" when the data does not decide it.',
+        ].join('\n');
+        let requests = 0;
+        const sendable = keys.map((_, i) => i).slice(0, maxRows);
+        for (let start = 0; start < sendable.length; start += batchSize) {
+            const batch = sendable.slice(start, start + batchSize);
+            const reply = await requestJson(ctx, service, task, dataBlock(table, keys, batch, columns), maxOutputTokens, classificationSchema(batch.map(i => keys[i]), [...labels], columns), 'flow.ai.classify.v1');
+            if (reply.kind === 'budget') {
+                ctx.log('warn', `the AI budget ran out after ${requests} request(s); ${sendable.length - start} row(s) were not sent`);
+                break;
+            }
+            requests += 1;
+            if (reply.kind === 'failed' || !Array.isArray(reply.value.items)) {
+                ctx.log('warn', `rows ${start + 1}-${start + batch.length}: ${reply.kind === 'failed' ? reply.message : 'the reply has no items array'}`);
+                for (const i of batch)
+                    outcome[i] = 'failed';
+                continue;
+            }
+            const read = readClassifications(reply.value, new Set(batch.map((i) => keys[i])), labels, new Set(columns));
+            for (const i of batch) {
+                const r = read.get(keys[i]);
+                label[i] = r?.label ?? null;
+                evidence[i] = r?.evidence ?? [];
+                outcome[i] = r === undefined ? 'failed' : r.label ? 'classified' : 'unknown';
+            }
+        }
+        if (keys.length > maxRows)
+            ctx.log('warn', `${keys.length - maxRows} row(s) beyond maxRows ${maxRows} were not sent`);
+        const count = (o) => outcome.filter((x) => x === o).length;
+        const result = {
+            key: 'key',
+            columns: [
+                { name: 'key', type: 'identifier' }, { name: 'label', type: 'label' },
+                { name: 'evidence', type: 'text' }, { name: 'outcome', type: 'enum' },
+            ],
+            rows: keys.map((key, i) => ({ key, label: label[i], evidence: evidence[i].join(', '), outcome: outcome[i] })),
+        };
+        return {
+            table: result,
+            coverage: {
+                model: service.model, categoriesVersion: String(p.version), rows: keys.length, requests,
+                classified: count('classified'), unknown: count('unknown'), failed: count('failed'), notSent: count('not-sent'),
+            },
+        };
+    },
+};
+//# sourceMappingURL=ai-classify.js.map

package/dist/ai-classify.js.map

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

package/dist/ai-extract.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `ai.extract` (#6923): typed candidate records from supplied text passages.
+ *
+ * Each record names the passage it came from and quotes a source span. A
+ * record is `supported` only when that span occurs verbatim in its passage
+ * and every value has its field's type; otherwise it is kept as
+ * `unsupported` with the offending values blanked, so a reviewer sees what
+ * the model claimed. This is a quote-and-type check, not a semantic check
+ * that the quoted text entails each typed value. All records remain candidates
+ * awaiting human review. Passages beyond
+ * `maxPassages`, or past a budget stop, are reported as not sent. The run
+ * pauses here for review.
+ */
+import type { Cell } from '@ifc-lite/flow';
+import type { FlowNodeDef } from './host.js';
+type FieldType = 'string' | 'number' | 'boolean';
+interface Field {
+    readonly name: string;
+    readonly type: FieldType;
+    readonly description: string;
+}
+/** One reply's records, checked against their passages. */
+export declare function readRecords(value: Record<string, unknown>, passages: ReadonlyMap<number, string>, fields: readonly Field[]): Record<string, Cell>[];
+export declare const aiExtractNode: FlowNodeDef;
+export {};
+//# sourceMappingURL=ai-extract.d.ts.map

package/dist/ai-extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-extract.d.ts","sourceRoot":"","sources":["../src/ai-extract.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAiB,MAAM,gBAAgB,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAI7C,KAAK,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AACjD,UAAU,KAAK;IAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AAiBjG,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAsBnJ;AAID,eAAO,MAAM,aAAa,EAAE,WAmE3B,CAAC"}

package/dist/ai-extract.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 { SCALAR_ITEM, SCALAR_LIST, TABLE_ITEM } from './ports.js';
+import { AI_CAPABILITY, AI_FEATURE, aiService, positiveInt, requestJson } from './ai-service.js';
+import { extractionSchema } from './ai-response-schemas.js';
+const RESERVED = new Set(['passage', 'span', 'outcome']);
+function fieldsOf(value) {
+    if (!Array.isArray(value) || value.length === 0 || value.length > 30)
+        throw new Error('"fields" must list 1 to 30 { name, type, description } entries');
+    const seen = new Set();
+    return value.map((f, i) => {
+        const name = typeof f?.name === 'string' ? f.name.trim() : '';
+        const type = f?.type;
+        if (!/^[A-Za-z][A-Za-z0-9_]{0,63}$/.test(name) || RESERVED.has(name) || seen.has(name))
+            throw new Error(`field ${i + 1} needs a unique identifier name other than passage, span or outcome`);
+        if (type !== 'string' && type !== 'number' && type !== 'boolean')
+            throw new Error(`field "${name}" must have type string, number or boolean`);
+        seen.add(name);
+        return { name, type, description: typeof f.description === 'string' ? f.description.slice(0, 300) : '' };
+    });
+}
+/** One reply's records, checked against their passages. */
+export function readRecords(value, passages, fields) {
+    const records = Array.isArray(value.records) ? value.records : [];
+    return records.flatMap((raw) => {
+        if (!raw || typeof raw !== 'object')
+            return [];
+        const record = raw;
+        const passage = typeof record.passage === 'number' ? record.passage : -1;
+        const source = passages.get(passage);
+        if (source === undefined)
+            return [];
+        const sourceSpan = typeof record.span === 'string' ? record.span : '';
+        const span = sourceSpan.slice(0, 1000);
+        const values = record.values && typeof record.values === 'object' ? record.values : {};
+        let supported = sourceSpan.length > 0 && sourceSpan.length <= 1000 && source.includes(sourceSpan);
+        const row = { passage, span };
+        for (const f of fields) {
+            const v = values[f.name];
+            const ok = v === null || v === undefined || (f.type === 'number' ? typeof v === 'number' && Number.isFinite(v) : typeof v === f.type);
+            if (!ok)
+                supported = false;
+            row[f.name] = ok && v !== undefined ? v : null;
+        }
+        row.outcome = supported ? 'supported' : 'unsupported';
+        return [row];
+    });
+}
+const COLUMN_TYPE = { string: 'text', number: 'real', boolean: 'boolean' };
+export const aiExtractNode = {
+    type: 'ai.extract', title: 'AI extract records', category: 'ai',
+    doc: 'Extract typed records from text passages using the host AI model. Each record quotes its source span; records whose span is not in the passage or whose values have the wrong type are marked unsupported. The run pauses for review of the records.',
+    inputs: [{ name: 'passages', type: SCALAR_LIST }],
+    outputs: [{ name: 'records', type: TABLE_ITEM }, { name: 'coverage', type: SCALAR_ITEM }],
+    params: [
+        { name: 'fields', kind: 'json', default: [], doc: '[{ "name": "...", "type": "string|number|boolean", "description": "..." }]' },
+        { name: 'maxPassages', kind: 'number', default: 50 },
+        { name: 'batchSize', kind: 'number', default: 10 },
+        { name: 'maxRecords', kind: 'number', default: 200 },
+        { name: 'maxOutputTokens', kind: 'number', default: 2000 },
+    ],
+    capabilities: [AI_CAPABILITY], requires: { backend: [AI_FEATURE], network: true }, volatile: true, review: 'required',
+    run: async (ctx, inputs, p) => {
+        const passages = inputs.passages.map((v) => (typeof v === 'string' ? v : v === null || v === undefined ? '' : String(v)));
+        const fields = fieldsOf(p.fields);
+        const maxPassages = positiveInt(p.maxPassages, 'maxPassages', 1000);
+        const batchSize = positiveInt(p.batchSize, 'batchSize', 50);
+        const maxRecords = positiveInt(p.maxRecords, 'maxRecords', 5000);
+        const maxOutputTokens = positiveInt(p.maxOutputTokens, 'maxOutputTokens', 32_000);
+        const service = aiService(ctx);
+        const task = [
+            'Extract records with these fields from the passages:',
+            ...fields.map((f) => `- ${f.name} (${f.type}): ${f.description}`),
+            'Reply {"records":[{"passage":<passage number>,"span":"<exact quote from that passage>","values":{...}}]}.',
+            'Quote the span verbatim. Use null for a value the passage does not state.',
+        ].join('\n');
+        const rows = [];
+        let requests = 0;
+        let sent = 0;
+        let failed = 0;
+        const sendable = Math.min(passages.length, maxPassages);
+        for (let start = 0; start < sendable && rows.length < maxRecords; start += batchSize) {
+            const batch = new Map();
+            for (let i = start; i < Math.min(start + batchSize, sendable); i++)
+                batch.set(i, passages[i].slice(0, 8000));
+            const data = [...batch].map(([i, t]) => JSON.stringify({ passage: i, text: t })).join('\n');
+            const reply = await requestJson(ctx, service, task, `<data>\n${data}\n</data>`, maxOutputTokens, extractionSchema([...batch.keys()], fields), 'flow.ai.extract.v1');
+            if (reply.kind === 'budget') {
+                ctx.log('warn', `the AI budget ran out after ${requests} request(s)`);
+                break;
+            }
+            requests += 1;
+            sent += batch.size;
+            if (reply.kind === 'failed') {
+                failed += batch.size;
+                ctx.log('warn', `passages ${start + 1}-${start + batch.size}: ${reply.message}`);
+                continue;
+            }
+            if (!Array.isArray(reply.value.records)) {
+                failed += batch.size;
+                ctx.log('warn', `passages ${start + 1}-${start + batch.size}: reply must contain a records array`);
+                continue;
+            }
+            rows.push(...readRecords(reply.value, batch, fields));
+        }
+        if (rows.length > maxRecords)
+            ctx.log('warn', `${rows.length - maxRecords} record(s) beyond maxRecords were dropped`);
+        const kept = rows.slice(0, maxRecords);
+        const records = {
+            key: 'passage',
+            columns: [
+                { name: 'passage', type: 'integer' }, ...fields.map((f) => ({ name: f.name, type: COLUMN_TYPE[f.type] })),
+                { name: 'span', type: 'text' }, { name: 'outcome', type: 'enum' },
+            ],
+            rows: kept,
+        };
+        return {
+            records,
+            coverage: {
+                model: service.model, passages: passages.length, sent, failed, notSent: passages.length - sent, requests,
+                records: kept.length, unsupported: kept.filter((r) => r.outcome === 'unsupported').length,
+            },
+        };
+    },
+};
+//# sourceMappingURL=ai-extract.js.map

package/dist/ai-extract.js.map

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

package/dist/ai-propose-fields.d.ts

@@ -0,0 +1,12 @@
+/** #7070: native field constraints for portable model-change drafts. */
+import { type ChangeScalar, type ModelChange } from '@ifc-lite/ai/artifacts';
+export interface ProposalField {
+    readonly native: ModelChange;
+    readonly expectedColumn: string;
+    readonly allowedValues: readonly ChangeScalar[];
+}
+/** Native parsing checks each allowed value's IFC type, rather than copying that validator. */
+export declare function proposalFields(raw: unknown, columns: readonly string[]): ProposalField[];
+/** Every effect field and candidate value must be explicitly allowed by the graph. */
+export declare function constrainedField(change: ModelChange, fields: readonly ProposalField[]): ProposalField;
+//# sourceMappingURL=ai-propose-fields.d.ts.map

package/dist/ai-propose-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-propose-fields.d.ts","sourceRoot":"","sources":["../src/ai-propose-fields.ts"],"names":[],"mappings":"AAIA,wEAAwE;AACxE,OAAO,EAAoC,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE/G,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,SAAS,YAAY,EAAE,CAAC;CACjD;AAKD,+FAA+F;AAC/F,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa,EAAE,CA4BxF;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,aAAa,CAQrG"}

package/dist/ai-propose-fields.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/. */
+/** #7070: native field constraints for portable model-change drafts. */
+import { changeKey, parseModelChangeBatch } from '@ifc-lite/ai/artifacts';
+const sampleTarget = { globalId: '0000000000000000000000' };
+const fieldKey = (change) => changeKey({ ...change, target: sampleTarget });
+const record = (value) => !!value && typeof value === 'object' && !Array.isArray(value);
+/** Native parsing checks each allowed value's IFC type, rather than copying that validator. */
+export function proposalFields(raw, columns) {
+    if (!Array.isArray(raw) || !raw.length || raw.length > 50)
+        throw new Error('Select 1 to 50 native fields for the proposal');
+    const seen = new Set();
+    return raw.map((value, index) => {
+        if (!record(value))
+            throw new Error(`Field ${index + 1} must be an object`);
+        const { expectedColumn, allowedValues, ...binding } = value;
+        const keys = ['op', 'name', 'pset', 'qset', 'dataType'];
+        if (Object.keys(binding).some(key => !keys.includes(key)))
+            throw new Error(`Field ${index + 1} has an unknown constraint`);
+        if (typeof expectedColumn !== 'string' || !columns.includes(expectedColumn))
+            throw new Error(`Field ${index + 1} needs a selected expectedColumn`);
+        const deleting = binding.op === 'property.delete';
+        if (deleting ? allowedValues !== undefined : !Array.isArray(allowedValues) || !allowedValues.length || allowedValues.length > 20) {
+            throw new Error('Set fields need 1 to 20 allowedValues; delete fields must omit them');
+        }
+        const values = deleting ? ['existing value'] : allowedValues;
+        const parsed = values.map(candidate => parseModelChangeBatch(JSON.stringify({ version: 1, kind: 'model.changes', title: 'Field constraint', changes: [{
+                    ...binding, target: sampleTarget, expected: deleting ? 'existing value' : binding.op === 'attribute.set' ? '' : binding.op === 'quantity.set' ? 0 : null,
+                    ...(!deleting ? { value: candidate } : {}),
+                }] })).changes[0]);
+        const native = parsed[0];
+        // Cross-operation fields must not smuggle unused binding names into the prompt.
+        const allowedKeys = native.op === 'property.set' ? ['op', 'name', 'pset', 'dataType']
+            : native.op === 'property.delete' ? ['op', 'name', 'pset'] : native.op === 'quantity.set' ? ['op', 'name', 'qset'] : ['op', 'name'];
+        if (Object.keys(binding).some(key => !allowedKeys.includes(key)))
+            throw new Error(`Field ${index + 1} has a binding for another operation`);
+        const key = fieldKey(native);
+        if (seen.has(key))
+            throw new Error('Each native value may have only one field constraint');
+        seen.add(key);
+        return { native, expectedColumn, allowedValues: deleting ? [] : parsed.map(change => 'value' in change ? change.value : null) };
+    });
+}
+/** Every effect field and candidate value must be explicitly allowed by the graph. */
+export function constrainedField(change, fields) {
+    const field = fields.find(candidate => fieldKey(candidate.native) === fieldKey(change) && candidate.native.op === change.op);
+    if (!field)
+        throw new Error('The proposed change is outside the selected native fields');
+    if (change.op === 'property.set' && field.native.op === 'property.set' && change.dataType !== field.native.dataType) {
+        throw new Error('The proposed property dataType differs from its native field constraint');
+    }
+    if ('value' in change && !field.allowedValues.some(value => Object.is(value, change.value)))
+        throw new Error('The proposed value is outside allowedValues');
+    return field;
+}
+//# sourceMappingURL=ai-propose-fields.js.map

package/dist/ai-propose-fields.js.map

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

package/dist/ai-propose.d.ts

@@ -0,0 +1,3 @@
+import type { FlowNodeDef } from './host.js';
+export declare const aiProposeNode: FlowNodeDef;
+//# sourceMappingURL=ai-propose.d.ts.map

package/dist/ai-propose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-propose.d.ts","sourceRoot":"","sources":["../src/ai-propose.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAK7C,eAAO,MAAM,aAAa,EAAE,WAoE3B,CAAC"}

package/dist/ai-propose.js

@@ -0,0 +1,94 @@
+/* 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/. */
+/** #7070: one constrained portable draft; never native writes or publication. */
+import { MODEL_CHANGE_LIMIT, MODEL_DATA_CHANGE_OUTPUT_GUIDANCE, parseModelChangeBatch } from '@ifc-lite/ai/artifacts';
+import { SCALAR_ITEM, TABLE_ITEM } from './ports.js';
+import { AI_CAPABILITY, AI_FEATURE, aiService, dataBlock, positiveInt, requestJson, rowKeys, sentColumns } from './ai-service.js';
+import { constrainedField, proposalFields } from './ai-propose-fields.js';
+import { proposalSchema } from './ai-response-schemas.js';
+export const aiProposeNode = {
+    type: 'ai.propose', title: 'AI propose a native artifact', category: 'ai',
+    doc: 'Draft a model.changes artifact over explicitly selected findings and native fields. Every change cites one captured row, copies its expected value and uses an allowed candidate value. No effects run before checkpoint review; current values and permissions still need native mutation preflight.',
+    inputs: [{ name: 'table', type: TABLE_ITEM }],
+    outputs: [{ name: 'proposal', type: SCALAR_ITEM }, { name: 'coverage', type: SCALAR_ITEM }],
+    params: [
+        { name: 'artifactKind', kind: 'string', default: 'model.changes', doc: 'Closed native allowlist: model.changes. Unsupported kinds are refused before spending.' },
+        { name: 'instructions', kind: 'string', default: '', doc: 'The requested correction policy; rows are evidence, never instructions.' },
+        { name: 'columns', kind: 'json', default: [], doc: 'Columns explicitly sent to the model, including target and expected-value columns.' },
+        { name: 'targetColumn', kind: 'string', default: 'GlobalId' },
+        { name: 'modelColumn', kind: 'string', default: '', doc: 'Optional selected column of native model ids; required to disambiguate a shared GlobalId.' },
+        { name: 'fields', kind: 'json', default: [], doc: '[{ "op":"property.set", "pset":"Pset_WallCommon", "name":"IsExternal", "expectedColumn":"IsExternal", "allowedValues":[true], "dataType":"IfcBoolean" }]' },
+        { name: 'maxRows', kind: 'number', default: 200 },
+        { name: 'maxChanges', kind: 'number', default: 100 },
+        { name: 'maxOutputTokens', kind: 'number', default: 2000 },
+    ],
+    capabilities: [AI_CAPABILITY], requires: { backend: [AI_FEATURE], network: true }, volatile: true, review: 'required',
+    run: async (ctx, inputs, p) => {
+        if (p.artifactKind !== 'model.changes')
+            throw new Error('This host supports only the model.changes artifact kind');
+        if (typeof p.instructions !== 'string' || !p.instructions.trim() || p.instructions.length > 4000)
+            throw new Error('Supply a bounded correction policy');
+        const table = inputs.table;
+        const columns = sentColumns(table, Array.isArray(p.columns) ? p.columns.map(String) : []);
+        if (typeof p.targetColumn !== 'string' || !columns.includes(p.targetColumn))
+            throw new Error('Select the target GlobalId column');
+        const targetColumn = p.targetColumn;
+        if (typeof p.modelColumn !== 'string' || (p.modelColumn && !columns.includes(p.modelColumn)))
+            throw new Error('Select the native model id column');
+        const modelColumn = p.modelColumn;
+        const fields = proposalFields(p.fields, columns);
+        const maxRows = positiveInt(p.maxRows, 'maxRows', MODEL_CHANGE_LIMIT);
+        const maxChanges = positiveInt(p.maxChanges, 'maxChanges', MODEL_CHANGE_LIMIT);
+        const maxOutputTokens = positiveInt(p.maxOutputTokens, 'maxOutputTokens', 32_000);
+        const sent = { ...table, rows: table.rows.slice(0, maxRows) };
+        if (!sent.rows.length)
+            throw new Error('There are no findings to propose changes for');
+        for (const row of sent.rows) {
+            if (typeof row[targetColumn] !== 'string' || !/^[0-9A-Za-z_$]{22}$/.test(row[targetColumn]))
+                throw new Error('Every sent finding needs a native IFC GlobalId');
+            if (modelColumn && (typeof row[modelColumn] !== 'string' || !String(row[modelColumn]).trim()))
+                throw new Error('Every sent finding needs a native model id');
+        }
+        const keys = rowKeys(sent), known = new Set(keys);
+        const task = `${MODEL_DATA_CHANGE_OUTPUT_GUIDANCE}\nReply {"artifact":<model.changes>,"citations":["<row key>"],"clarification":null}. Each change must match exactly one cited row. Use targetColumn ${JSON.stringify(targetColumn)} and modelColumn ${JSON.stringify(modelColumn)}; copy each expected value from its field's expectedColumn. Never propose more than ${maxChanges} changes. Use only the supplied fields and allowedValues. If evidence cannot decide, return {"artifact":null,"citations":[],"clarification":"What input is missing"}.\nRequested policy: ${p.instructions}\nField constraints: ${JSON.stringify(p.fields)}`;
+        const service = aiService(ctx);
+        const reply = await requestJson(ctx, service, task, dataBlock(sent, keys, keys.map((_, index) => index), columns), maxOutputTokens, proposalSchema(fields, keys, !!modelColumn), 'flow.ai.propose.v1');
+        if (reply.kind !== 'value')
+            throw new Error(reply.kind === 'budget' ? 'The AI proposal budget is exhausted' : reply.message);
+        if (reply.value.kind === 'clarification')
+            throw new Error(`Proposal needs clarification: ${String(reply.value.message ?? 'Missing evidence').slice(0, 1000)}`);
+        if (typeof reply.value.clarification === 'string')
+            throw new Error(`Proposal needs clarification: ${reply.value.clarification.slice(0, 1000)}`);
+        if (reply.value.clarification !== undefined && reply.value.clarification !== null)
+            throw new Error('Invalid proposal clarification');
+        if (Object.keys(reply.value).some(key => key !== 'artifact' && key !== 'citations' && key !== 'clarification'))
+            throw new Error('Unknown proposal envelope field');
+        const citations = reply.value.citations;
+        if (!Array.isArray(citations) || !citations.length || citations.some(key => typeof key !== 'string' || !known.has(key)) || new Set(citations).size !== citations.length) {
+            throw new Error('The proposal must cite distinct sent finding keys');
+        }
+        if (!reply.value.artifact || typeof reply.value.artifact !== 'object' || Array.isArray(reply.value.artifact))
+            throw new Error('A native model.changes artifact is required');
+        const artifact = parseModelChangeBatch(JSON.stringify(reply.value.artifact));
+        if (artifact.changes.length > maxChanges)
+            throw new Error('The proposal exceeds maxChanges');
+        const used = new Set();
+        for (const change of artifact.changes) {
+            const field = constrainedField(change, fields);
+            const matches = sent.rows.map((row, index) => ({ row, key: keys[index] })).filter(({ row, key }) => citations.includes(key) && row[targetColumn] === change.target.globalId
+                && (modelColumn ? row[modelColumn] === change.target.modelId : change.target.modelId === undefined));
+            if (matches.length !== 1)
+                throw new Error('A proposed target is absent or ambiguous in the cited findings');
+            const { row, key } = matches[0];
+            if (!Object.hasOwn(row, field.expectedColumn) || !Object.is(row[field.expectedColumn], change.expected))
+                throw new Error('The proposed expected value differs from the captured finding');
+            used.add(key);
+        }
+        if (used.size !== citations.length)
+            throw new Error('The proposal cites rows without a proposed change');
+        return { proposal: { artifact, citations }, coverage: { model: service.model, kind: 'model.changes', rows: table.rows.length,
+                sent: sent.rows.length, notSent: table.rows.length - sent.rows.length, requests: 1, changes: artifact.changes.length, citedRows: used.size } };
+    },
+};
+//# sourceMappingURL=ai-propose.js.map

package/dist/ai-propose.js.map

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

package/dist/ai-response-schemas.d.ts

@@ -0,0 +1,11 @@
+/** Native Flow JSON shapes, shared by every provider and host (#7132). */
+import type { JsonResponseSchema } from '@ifc-lite/ai';
+import type { ProposalField } from './ai-propose-fields.js';
+export declare function classificationSchema(keys: readonly string[], labels: readonly string[], columns: readonly string[]): JsonResponseSchema;
+export declare function extractionSchema(passages: readonly number[], fields: readonly {
+    name: string;
+    type: string;
+}[]): JsonResponseSchema;
+export declare function summarySchema(keys: readonly string[]): JsonResponseSchema;
+export declare function proposalSchema(fields: readonly ProposalField[], keys: readonly string[], withModel: boolean): JsonResponseSchema;
+//# sourceMappingURL=ai-response-schemas.d.ts.map

package/dist/ai-response-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-response-schemas.d.ts","sourceRoot":"","sources":["../src/ai-response-schemas.ts"],"names":[],"mappings":"AAIA,0EAA0E;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAc5D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,kBAAkB,CAIvI;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,kBAAkB,CAKnI;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,kBAAkB,CAIzE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,EAAE,OAAO,GAAG,kBAAkB,CAehI"}