@ifc-lite/flow-nodes 0.6.0 → 0.9.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,109 @@ 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.
+
+`review.snapshot` is a volatile `model.read` node over a host-provided native
+Review service. Its optional `after` input sequences the read after an analysis;
+its bounded `snapshot` contains actual facts, coverage and producer provenance.
+Hosts without a native capture service report the missing
+`review` backend capability explicitly. This node does not rerun analysis or
+write models, artifacts, publications or decisions. See
+[the native Review read contract](../../docs/guide/flow.md#reading-captured-native-review).
+
+## Durable native BCF publication
+
+The Node-only `@ifc-lite/flow-nodes/bcf-publication-node` entry exports
+`createNativeBcfWriteGateway({ directory, namespace, secrets })` for
+`FlowHost.bcfWrites`. CLI hosts supply it automatically. An immutable,
+fsynced intent is claimed before a create; a lost response or interrupted host
+blocks the same target and payload across restarts. Bearers are ephemeral;
+a payload containing a known run or write token is refused before persistence.
+Known credentials are checked in values and dynamic keys; fixed public schema
+keys such as `id`, `topicGuid` and `remoteGuid` are protocol names, not credential
+data. Strict record and payload decoders still reject those names in an unknown
+location. Authorization/token keys and credential URL/Bearer syntax remain
+refused, and credential-bearing identifier values remain unsafe.
+Every generated journal record is checked against the current known credentials
+before publication. A credential that cannot be represented without appearing in
+fixed metadata, such as the literal bearer `done`, is refused before the POST.
+Fixed schema keys remain valid: bearers `id` and `intent` can use clean payloads
+and receipt values. A later generated-value collision, such as a receipt timestamp
+matching a known credential, refuses success and leaves the saved intent unresolved
+for explicit checked recovery; it never persists that credential or retries.
+BCF write nodes also redact the actual resolved bearer from successful server
+responses before exposing output ports, including literal and Player tokens.
+
+`list()` inspects one bounded local page. `listPage({cursor, limit})` returns
+`{entries,nextCursor?}`; follow every cursor, including empty progress pages. `check(id, { token, networkGrants })` reads the
+original HTTPS target with fresh capability grants and records matching GUID
+candidates, including trim-equivalent title, description and comment text.
+Server-edited or omitted fields cannot prove absence: unmatched objects make
+the check unavailable. Only a complete empty enumeration with `confirmFullReadAccess: true` proves absence; the operator asserts complete visibility in the same access scope as the original write. Token presence alone is not proof of visibility. Without the assertion an empty enumeration is unavailable, while matching candidates remain available;
+the create protocol supplies no stable client marker for excluding other objects.
+It never retries a write. `reconcile(id, guid)` explicitly selects
+a checked candidate. `confirmAbsent(id)` explicitly releases an intent only
+after the latest complete check proved absence and persisted `fullReadAccessConfirmed: true`. Older markerless absence proofs remain readable but need a fresh asserted check before release. Anonymous genuinely public reads remain supported. No credential or principal identity is persisted. A check alone never
+releases an unresolved create. Preserve the journal when an outcome is unknown.
+
+Storage uses a nonempty `IFCLITE_BCF_OUTBOX_DIR` or defaults to `~/.ifc-lite/bcf-outbox`, isolated
+by namespace. Filesystems without exclusive hard links or directory fsync
+refuse publication. Malformed, oversized or orphaned records also refuse;
+records are bounded to 256 KiB, with 256 generations per digest and 16 checks
+per active immutable epoch. Immutable `v2/<prefix>/<digest>`
+storage retains every receipt; 256 buckets each hold at most 4096 never-deleted
+digest slots. Capacity refusal precedes sending and leaves existing recovery
+readable. Listing streams history and bounds each page to 1000 rows, 5 MiB and
+50,000 bounded record-work units; cursors are weakly consistent during concurrent writes. Old flat
+journals are refused: preserve them and recover using their original build.
+Linux boot/starttime and Windows creation-time queries distinguish process
+instances. Unknown owners require `confirmOwnerStopped: true` on `check`, only
+after operator verification; observed live instances always block recovery. The browser
+continues to use its IndexedDB publication controls and the shared pure
+`@ifc-lite/flow-nodes/bcf-publication` error classifier.
+
+Recovery check epochs retain prior immutable files and locate the latest marker
+with bounded exponential/binary probes over safe integer identities. Validation
+reads the latest epoch and its embedded preceding proof; archived epoch bodies
+are retained as evidence, without rereading their full history. An interrupted
+check resumes the same reserved check ID with a fresh authorized read. A completed
+unavailable check at an epoch boundary permits the next explicit check in a new
+epoch, competing with settlement on the same exclusive transition. An empty new
+epoch marker preserves the preceding proof. These operations never resend a create.
+
+A native process admits at most 64 concurrent or locally completed sends whose
+outcome could not be saved. Completed durable receipts consume no local tracking
+slot. At this bound new creates refuse before any effect; checked reconciliation
+or confirmed absence releases the retained local completion. No completion
+identity is evicted to make room. Reads synchronize the visible receipt or proof's
+directory before acknowledging it; an unresolved directory-sync fault refuses
+recovery and subsequent creates without discarding the existing record.

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"}