@agentshouse/mdmodel 0.1.0-c4fe1bc82bc55 → 0.1.0-c520180b7a33f

package/dist/document.js

@@ -1,24 +1,35 @@
 import { ARRAY_INDEX, pointerSegments } from './definition.js';
-import { hrefOccurrences } from './links.js';
-import { relative, retarget, SHELL_ROOMS, shellTarget, target } from './paths.js';
+import { destinations, hrefOccurrences, linkInventory, } from './links.js';
+import { destinationPath, relative, retarget, roomPath, roomTarget, SHELL_ROOMS, shellTarget, target, } from './paths.js';
 import { references } from './references.js';
 import { headingSpans, sectionsRecord } from './sections.js';
 import { refusal } from './refuse.js';
 import { bodyStartAfterYaml, bodyStartOf, equalValue, extractFrontmatter, frontmatterValue, jsValue, lineEnding, mapEntry, parseYamlMapping, serializeJs, serializeKey, YamlError, } from './yaml.js';
-const internals = new WeakMap();
+const HELD = Symbol('held');
+function heldOf(document) {
+    return document[HELD];
+}
+export function inventoryOf(document) {
+    const held = heldOf(document);
+    if (held?.inventory !== undefined)
+        return held.inventory;
+    const inventory = linkInventory(document.content.slice(bodyStartOf(document.content)));
+    if (held !== undefined)
+        held.inventory = inventory;
+    return inventory;
+}
 function refuse(file, rule, location) {
     return location === undefined ? refusal(file, rule) : refusal(file, rule, { location });
 }
 function freezeDocument(content, type, fields, preamble, sections, internal) {
-    const document = Object.freeze({
+    const held = { internal, inventory: undefined };
+    return Object.freeze(Object.defineProperty({
         content,
         type,
         fields: Object.freeze(fields),
         preamble,
         sections: Object.freeze(sections),
-    });
-    internals.set(document, internal);
-    return document;
+    }, HELD, { value: held }));
 }
 function declaredType(fields) {
     const value = fields.type;
@@ -28,19 +39,10 @@ function declaredType(fields) {
         return undefined;
     return value;
 }
-export function parse(content, file = '') {
+function opened(content, file) {
     const fence = extractFrontmatter(content);
-    if (fence.kind === 'none') {
-        const spans = headingSpans(content, 0);
-        return {
-            ok: true,
-            document: freezeDocument(content, undefined, {}, content.slice(0, spans[0]?.headingStart), sectionsRecord(spans, content), {
-                root: null,
-                yamlEnd: 0,
-                bodyStart: 0,
-            }),
-        };
-    }
+    if (fence.kind === 'none')
+        return { ok: true, root: null, fields: {}, yamlEnd: 0 };
     if (fence.kind === 'unclosed')
         return { ok: false, refusal: refuse(file, 'frontmatter-fence') };
     try {
@@ -49,17 +51,7 @@ export function parse(content, file = '') {
         if (fields === null || typeof fields !== 'object' || Array.isArray(fields)) {
             return { ok: false, refusal: refuse(file, 'frontmatter-fence') };
         }
-        const bodyStart = bodyStartAfterYaml(content, fence.yamlEnd);
-        const spans = headingSpans(content, bodyStart);
-        const record = fields;
-        return {
-            ok: true,
-            document: freezeDocument(content, declaredType(record), record, content.slice(bodyStart, spans[0]?.headingStart), sectionsRecord(spans, content), {
-                root,
-                yamlEnd: fence.yamlEnd,
-                bodyStart,
-            }),
-        };
+        return { ok: true, root, fields: fields, yamlEnd: fence.yamlEnd };
     }
     catch (error) {
         if (error instanceof YamlError)
@@ -67,66 +59,29 @@ export function parse(content, file = '') {
         throw error;
     }
 }
-function splice(content, start, end, insert) {
-    return content.slice(0, start) + insert + content.slice(end);
-}
-function applyField(document, name, value, prior) {
-    const internal = internals.get(document);
-    if (internal === undefined || internal.root === null) {
-        return { outcome: 'refuse', refusal: refuse('', 'frontmatter-fence', name) };
-    }
-    if (!equalValue(document.fields[name], prior)) {
-        return { outcome: 'stale', document };
-    }
-    if (!frontmatterValue(value)) {
-        return { outcome: 'refuse', refusal: refuse('', 'frontmatter-fence', name) };
-    }
-    let nextContent;
-    const existing = mapEntry(internal.root, name);
-    if (existing !== undefined) {
-        nextContent = splice(document.content, existing.value.start, existing.value.end, serializeJs(value));
-    }
-    else if (document.content[internal.root.start] === '{') {
-        nextContent = splice(document.content, internal.root.end - 1, internal.root.end - 1, `${internal.root.entries.length === 0 ? '' : ', '}${serializeKey(name)}: ${serializeJs(value)}`);
-    }
-    else {
-        const nl = lineEnding(document.content);
-        const lineStart = document.content.lastIndexOf('\n', internal.root.start - 1) + 1;
-        const indent = document.content.slice(lineStart, internal.root.start);
-        const line = `${indent}${serializeKey(name)}: ${serializeJs(value)}${nl}`;
-        const before = document.content.slice(0, internal.yamlEnd);
-        const prefix = before.endsWith('\n') || before.endsWith('\r\n') ? '' : nl;
-        nextContent = splice(document.content, internal.yamlEnd, internal.yamlEnd, `${prefix}${line}`);
-    }
-    const parsed = parse(nextContent);
-    if (!parsed.ok)
-        return { outcome: 'refuse', refusal: parsed.refusal };
-    return { outcome: 'applied', document: parsed.document };
-}
-function applySection(document, name, value, prior) {
-    const internal = internals.get(document);
-    if (internal === undefined)
-        return { outcome: 'refuse', refusal: refuse('', 'required-section', name) };
-    const spans = headingSpans(document.content, internal.bodyStart);
-    const span = spans.find((item) => item.name === name);
-    if (span === undefined)
-        return { outcome: 'refuse', refusal: refuse('', 'required-section', name) };
-    const current = document.content.slice(span.bodyStart, span.bodyEnd);
-    if (current !== prior)
-        return { outcome: 'stale', document };
-    const parsed = parse(splice(document.content, span.bodyStart, span.bodyEnd, value));
-    if (!parsed.ok)
-        return { outcome: 'refuse', refusal: parsed.refusal };
-    return { outcome: 'applied', document: parsed.document };
+export function parseFrontmatter(content, file = '') {
+    const read = opened(content, file);
+    if (!read.ok)
+        return read;
+    return {
+        ok: true,
+        frontmatter: Object.freeze({
+            content,
+            type: declaredType(read.fields),
+            fields: Object.freeze(read.fields),
+        }),
+    };
 }
-function applyPreamble(document, value, prior) {
-    if (document.preamble !== prior)
-        return { outcome: 'stale', document };
-    const start = bodyStartOf(document.content);
-    const parsed = parse(splice(document.content, start, start + document.preamble.length, value));
-    if (!parsed.ok)
-        return { outcome: 'refuse', refusal: parsed.refusal };
-    return { outcome: 'applied', document: parsed.document };
+export function parse(content, file = '') {
+    const read = opened(content, file);
+    if (!read.ok)
+        return read;
+    const bodyStart = read.root === null ? 0 : bodyStartAfterYaml(content, read.yamlEnd);
+    const spans = headingSpans(content, bodyStart);
+    return {
+        ok: true,
+        document: freezeDocument(content, declaredType(read.fields), read.fields, content.slice(bodyStart, spans[0]?.headingStart), sectionsRecord(spans, content), { root: read.root, yamlEnd: read.yamlEnd, bodyStart }),
+    };
 }
 function fitsBare(to) {
     if (to === '' || to.startsWith('<'))
@@ -155,58 +110,34 @@ function destinationText(to, bracketed) {
         return `<${to}>`;
     return null;
 }
-function relinked(content, bodyStart, href, to) {
-    const written = retarget(href, to);
-    let rewritten = '';
-    let cursor = 0;
-    for (const match of hrefOccurrences(content.slice(bodyStart))) {
-        if (match.href !== href)
-            continue;
-        const text = destinationText(written, match.bracketed);
-        if (text === null)
-            return refuse('', 'unwritable-link', written);
-        rewritten += content.slice(cursor, bodyStart + match.start);
-        rewritten += text;
-        cursor = bodyStart + match.end;
-    }
-    return rewritten + content.slice(cursor);
-}
-function shellRelinked(content, bodyStart, file, handle) {
-    const hrefs = new Set(hrefOccurrences(content.slice(bodyStart)).map(({ href }) => href));
-    let held = content;
-    for (const href of hrefs) {
+function shellRelinked(body, file, handle) {
+    const occurrences = hrefOccurrences(body);
+    const written = new Map();
+    for (const href of new Set(occurrences.map((occurrence) => occurrence.href))) {
         const path = shellTarget(href, handle);
         if (path === null)
             continue;
-        const text = relinked(held, bodyStart, href, relative(file, path));
-        if (typeof text !== 'string')
-            return text;
-        held = text;
+        const to = retarget(href, relative(file, path));
+        if (destinationText(to, false) === null)
+            return refuse('', 'unwritable-link', to);
+        written.set(href, to);
     }
-    return held;
-}
-function reparsed(document, content) {
-    if (typeof content !== 'string')
-        return { outcome: 'refuse', refusal: content };
-    if (content === document.content)
-        return { outcome: 'applied', document };
-    const parsed = parse(content);
-    if (!parsed.ok)
-        return { outcome: 'refuse', refusal: parsed.refusal };
-    return { outcome: 'applied', document: parsed.document };
-}
-function applyLink(document, href, to) {
-    const content = document.content;
-    const bodyStart = bodyStartOf(content);
-    if (!hrefOccurrences(content.slice(bodyStart)).some((occurrence) => occurrence.href === href))
-        return { outcome: 'stale', document };
-    return reparsed(document, relinked(content, bodyStart, href, to));
+    let rewritten = '';
+    let cursor = 0;
+    for (const match of occurrences) {
+        const to = written.get(match.href);
+        if (to === undefined)
+            continue;
+        rewritten += body.slice(cursor, match.start) + destinationText(to, match.bracketed);
+        cursor = match.end;
+    }
+    return rewritten + body.slice(cursor);
 }
-function nodeAt(root, pointer) {
+function nodeAt(root, pointer, entryOf = mapEntry) {
     let node = root;
     for (const key of pointerSegments(pointer)) {
         if (node?.kind === 'map')
-            node = mapEntry(node, key)?.value;
+            node = entryOf(node, key)?.value;
         else if (node?.kind === 'seq' && ARRAY_INDEX.test(key))
             node = node.items[Number(key)];
         else
@@ -221,37 +152,36 @@ function scalarText(source, value) {
         return JSON.stringify(value);
     return serializeJs(value);
 }
-function applyReference(document, pointer, value, prior) {
-    const root = internals.get(document)?.root;
-    const node = root === null || root === undefined ? undefined : nodeAt(root, pointer);
-    if (node?.kind !== 'scalar' || node.value !== prior)
-        return { outcome: 'stale', document };
-    const text = scalarText(document.content[node.start], value);
-    const parsed = parse(splice(document.content, node.start, node.end, text));
-    if (!parsed.ok)
-        return { outcome: 'refuse', refusal: parsed.refusal };
-    return { outcome: 'applied', document: parsed.document };
-}
-export function relativize(document, file, handle, definition) {
-    let held = document;
+export function relativize(document, file, handle, definition, kept = new Set()) {
+    const relativized = (href) => {
+        const path = shellTarget(href, handle);
+        return path === null || kept.has(`${SHELL_ROOMS}${handle}/${path}`) ? null : path;
+    };
+    const changes = [];
     for (const { pointer, value } of definition === undefined
         ? []
         : references(document, definition)) {
-        const path = shellTarget(value, handle);
-        if (path === null)
-            continue;
-        const result = applyReference(held, pointer, retarget(value, relative(file, path)), value);
-        if (result.outcome !== 'applied')
-            return result;
-        held = result.document;
+        const path = relativized(value);
+        if (path !== null)
+            changes.push({
+                kind: 'reference',
+                pointer,
+                value: retarget(value, relative(file, path)),
+                prior: value,
+            });
+    }
+    for (const href of new Set(destinations(inventoryOf(document)).map(({ href }) => href))) {
+        const path = relativized(href);
+        if (path !== null)
+            changes.push({ kind: 'link', href, to: relative(file, path) });
     }
-    return reparsed(held, shellRelinked(held.content, bodyStartOf(held.content), file, handle));
+    return apply(document, changes);
 }
 export function relativizeBody(body, file, handle) {
-    const relinkedBody = shellRelinked(body, 0, file, handle);
+    const relinkedBody = shellRelinked(body, file, handle);
     if (typeof relinkedBody !== 'string')
         return { outcome: 'refuse', refusal: relinkedBody };
-    const elsewhere = hrefOccurrences(relinkedBody).find(({ href }) => href.startsWith(SHELL_ROOMS));
+    const elsewhere = hrefOccurrences(relinkedBody).find(({ href }) => destinationPath(href)?.startsWith(SHELL_ROOMS) === true && roomTarget(href) === null);
     if (elsewhere !== undefined)
         return { outcome: 'refuse', refusal: refuse(file, 'unresolved-link', elsewhere.href) };
     return { outcome: 'applied', body: relinkedBody };
@@ -260,11 +190,11 @@ export function relinkBody(body, file, moves) {
     let rewritten = '';
     let cursor = 0;
     for (const match of hrefOccurrences(body)) {
-        const from = target(file, match.href);
+        const from = target(file, match.href) ?? roomPath(match.href);
         const to = from === null ? undefined : moves.get(from);
         if (to === undefined)
             continue;
-        const written = retarget(match.href, relative(file, to));
+        const written = retarget(match.href, from.startsWith(SHELL_ROOMS) || to.startsWith(SHELL_ROOMS) ? to : relative(file, to));
         const text = destinationText(written, match.bracketed);
         if (text === null)
             return { outcome: 'refuse', refusal: refuse(file, 'unwritable-link', written) };
@@ -273,10 +203,10 @@ export function relinkBody(body, file, moves) {
     }
     return { outcome: 'applied', body: rewritten + body.slice(cursor) };
 }
-function linksIn(text, file) {
+function linksIn(occurrences, file) {
     const found = [];
     const seen = new Set();
-    for (const occurrence of hrefOccurrences(text)) {
+    for (const occurrence of occurrences) {
         if (seen.has(occurrence.href))
             continue;
         const resolved = target(file, occurrence.href);
@@ -288,25 +218,250 @@ function linksIn(text, file) {
     return found;
 }
 export function links(document, file) {
-    return linksIn(document.content.slice(bodyStartOf(document.content)), file);
+    return linksIn(destinations(inventoryOf(document)), file);
 }
 export function bodyLinks(body, file) {
-    return linksIn(body, file);
+    return linksIn(hrefOccurrences(body), file);
 }
-export function apply(document, change) {
+function internalOf(document) {
+    const held = heldOf(document);
+    if (held !== undefined)
+        return held.internal;
+    const read = opened(document.content, '');
+    if (!read.ok)
+        return read.refusal;
+    return {
+        root: read.root,
+        yamlEnd: read.yamlEnd,
+        bodyStart: read.root === null ? 0 : bodyStartAfterYaml(document.content, read.yamlEnd),
+    };
+}
+function partOf(change) {
+    if (change.kind === 'field' || change.kind === 'section')
+        return `${change.kind} ${change.name}`;
     if (change.kind === 'link')
-        return applyLink(document, change.href, change.to);
+        return `link ${change.href}`;
     if (change.kind === 'reference')
-        return applyReference(document, change.pointer, change.value, change.prior);
-    if (change.kind === 'preamble')
-        return applyPreamble(document, change.value, change.prior);
-    if (change.kind === 'field')
-        return applyField(document, change.name, change.value, change.prior);
-    return applySection(document, change.name, change.value, change.prior);
+        return `reference ${change.pointer}`;
+    return 'preamble';
+}
+function planner(document, internal) {
+    const content = document.content;
+    const keyed = new Map();
+    let spans;
+    let occurrences;
+    let ending;
+    let added = 0;
+    const entryOf = (map, key) => {
+        let index = keyed.get(map);
+        if (index === undefined) {
+            index = new Map();
+            for (const entry of map.entries)
+                if (!index.has(entry.key))
+                    index.set(entry.key, entry);
+            keyed.set(map, index);
+        }
+        return index.get(key);
+    };
+    const field = (name, value, prior, at) => {
+        const root = internal.root;
+        if (root === null)
+            return refuse('', 'frontmatter-fence', name);
+        if (!equalValue(document.fields[name], prior))
+            return 'stale';
+        if (!frontmatterValue(value))
+            return refuse('', 'frontmatter-fence', name);
+        const existing = entryOf(root, name);
+        if (existing !== undefined) {
+            const held = existing.value;
+            const inline = held.start > existing.after && !/[\r\n]/.test(content.slice(existing.after, held.start));
+            return inline
+                ? [{ start: held.start, end: held.end, text: serializeJs(value), at }]
+                : [{ start: existing.after, end: held.end, text: ` ${serializeJs(value)}`, at }];
+        }
+        const entry = `${serializeKey(name)}: ${serializeJs(value)}`;
+        added += 1;
+        if (content[root.start] === '{') {
+            const separator = root.entries.length === 0 && added === 1 ? '' : ', ';
+            return [{ start: root.end - 1, end: root.end - 1, text: `${separator}${entry}`, at }];
+        }
+        const lineStart = content.lastIndexOf('\n', root.start - 1) + 1;
+        ending ??= lineEnding(content);
+        const line = `${content.slice(lineStart, root.start)}${entry}${ending}`;
+        return [{ start: internal.yamlEnd, end: internal.yamlEnd, text: line, at, entry: true }];
+    };
+    const section = (name, value, prior, at) => {
+        if (spans === undefined) {
+            spans = new Map();
+            for (const span of headingSpans(content, internal.bodyStart))
+                if (!spans.has(span.name))
+                    spans.set(span.name, span);
+        }
+        const span = spans.get(name);
+        if (span === undefined)
+            return refuse('', 'required-section', name);
+        if (content.slice(span.bodyStart, span.bodyEnd) !== prior)
+            return 'stale';
+        return [{ start: span.bodyStart, end: span.bodyEnd, text: value, at }];
+    };
+    const link = (href, to, at) => {
+        if (occurrences === undefined) {
+            occurrences = new Map();
+            for (const occurrence of destinations(inventoryOf(document))) {
+                const same = occurrences.get(occurrence.href);
+                if (same === undefined)
+                    occurrences.set(occurrence.href, [occurrence]);
+                else
+                    same.push(occurrence);
+            }
+        }
+        const found = occurrences.get(href);
+        if (found === undefined)
+            return 'stale';
+        const written = retarget(href, to);
+        if (destinationText(written, false) === null)
+            return refuse('', 'unwritable-link', written);
+        return found.map((occurrence) => ({
+            start: internal.bodyStart + occurrence.start,
+            end: internal.bodyStart + occurrence.end,
+            text: destinationText(written, occurrence.bracketed),
+            at,
+        }));
+    };
+    const reference = (pointer, value, prior, at) => {
+        const node = internal.root === null ? undefined : nodeAt(internal.root, pointer, entryOf);
+        if (node?.kind !== 'scalar' || node.value !== prior)
+            return 'stale';
+        return [
+            { start: node.start, end: node.end, text: scalarText(content[node.start], value), at },
+        ];
+    };
+    return (change, at) => {
+        if (change.kind === 'field')
+            return field(change.name, change.value, change.prior, at);
+        if (change.kind === 'section')
+            return section(change.name, change.value, change.prior, at);
+        if (change.kind === 'link')
+            return link(change.href, change.to, at);
+        if (change.kind === 'reference')
+            return reference(change.pointer, change.value, change.prior, at);
+        if (document.preamble !== change.prior)
+            return 'stale';
+        const start = internal.bodyStart;
+        return [{ start, end: start + document.preamble.length, text: change.value, at }];
+    };
+}
+function overlapping(edits, stale) {
+    let reach = -1;
+    let owner = -1;
+    for (const edit of edits) {
+        if (edit.start < reach)
+            stale.add(Math.max(edit.at, owner));
+        if (edit.end > reach) {
+            reach = edit.end;
+            owner = edit.at;
+        }
+    }
+}
+function firstHeadings(content, bodyStart) {
+    const first = new Map();
+    for (const span of headingSpans(content, bodyStart)) {
+        if (!first.has(span.name))
+            first.set(span.name, span.headingStart);
+    }
+    return first;
+}
+function hidden(before, bodyStart, after, shifts) {
+    const placed = firstHeadings(after, bodyStartOf(after));
+    let shift = 0;
+    let index = 0;
+    for (const [name, at] of firstHeadings(before, bodyStart)) {
+        while (index < shifts.length && shifts[index][0] <= at) {
+            shift += shifts[index][1];
+            index += 1;
+        }
+        if (placed.get(name) !== at + shift)
+            return name;
+    }
+    return undefined;
+}
+function spliced(source, edits) {
+    const shifts = [];
+    const pieces = [];
+    let cursor = 0;
+    let entered = false;
+    let ended = false;
+    for (const edit of edits) {
+        const kept = source.slice(cursor, edit.start);
+        pieces.push(kept);
+        if (kept !== '')
+            ended = kept.endsWith('\n');
+        let text = edit.text;
+        if (edit.entry === true && !entered) {
+            entered = true;
+            if (!ended)
+                text = `${lineEnding(source)}${text}`;
+        }
+        pieces.push(text);
+        if (text !== '')
+            ended = text.endsWith('\n');
+        shifts.push([edit.start, text.length - (edit.end - edit.start)]);
+        cursor = edit.end;
+    }
+    pieces.push(source.slice(cursor));
+    return { content: pieces.join(''), shifts };
+}
+export function apply(document, changes) {
+    const internal = internalOf(document);
+    if (!('bodyStart' in internal))
+        return { outcome: 'refuse', refusal: internal };
+    const plan = planner(document, internal);
+    const edits = [];
+    const stale = new Set();
+    const named = new Set();
+    for (const [at, change] of changes.entries()) {
+        const planned = plan(change, at);
+        if (planned === 'stale') {
+            stale.add(at);
+            continue;
+        }
+        if (!Array.isArray(planned))
+            return { outcome: 'refuse', refusal: planned };
+        const part = partOf(change);
+        if (named.has(part)) {
+            stale.add(at);
+            continue;
+        }
+        named.add(part);
+        for (const edit of planned)
+            edits.push(edit);
+    }
+    edits.sort((left, right) => left.start - right.start || left.end - right.end || left.at - right.at);
+    overlapping(edits, stale);
+    if (stale.size > 0)
+        return { outcome: 'stale', document, stale: [...stale].sort((left, right) => left - right) };
+    const source = document.content;
+    const { content } = spliced(source, edits);
+    if (content === source)
+        return { outcome: 'applied', document };
+    const replaced = edits.filter((edit) => {
+        const kind = changes[edit.at].kind;
+        return kind === 'section' || kind === 'preamble';
+    });
+    if (replaced.length > 0) {
+        const checked = spliced(source, replaced);
+        const name = hidden(source, internal.bodyStart, checked.content, checked.shifts);
+        if (name !== undefined)
+            return { outcome: 'refuse', refusal: refuse('', 'overlapping-section', name) };
+    }
+    const parsed = parse(content);
+    if (!parsed.ok)
+        return { outcome: 'refuse', refusal: parsed.refusal };
+    return { outcome: 'applied', document: parsed.document };
 }
 export function serialize(document) {
     return document.content;
 }
 export function frontmatter(document) {
-    return internals.get(document)?.root ?? null;
+    return heldOf(document)?.internal.root ?? null;
 }

package/dist/event.d.ts

@@ -0,0 +1,78 @@
+import { type Definition } from './definition.js';
+import type { Candidate } from './query/match.js';
+import type { Document, VerifiedModel } from './types.js';
+export type FactKind = 'string' | 'number' | 'boolean' | 'date' | 'time' | 'enum' | 'reference';
+type Scalar = string | number | boolean;
+export type Fact = {
+    readonly kind: FactKind;
+    readonly value: Scalar;
+    readonly member?: string;
+} | {
+    readonly kind: 'prose';
+} | {
+    readonly kind: 'null';
+} | {
+    readonly kind: 'unreadable';
+} | {
+    readonly kind: 'list';
+    readonly items: readonly Fact[];
+} | {
+    readonly kind: 'object';
+    readonly fields: Readonly<Record<string, Fact>>;
+};
+export type DocumentFacts = {
+    readonly id: string;
+    readonly path: string;
+    readonly type: string | null;
+    readonly fields: Readonly<Record<string, Fact>>;
+    readonly sections: readonly string[];
+};
+export declare const TEXT_FIELD = "/text";
+export declare const WRITE_DOORS: readonly ['browser', 'agent', 'client', 'function'];
+export type WriteDoor = (typeof WRITE_DOORS)[number];
+export type Actor = {
+    readonly user?: string;
+    readonly site?: string;
+    readonly app?: string;
+    readonly door?: WriteDoor;
+};
+export type DocumentEvent = {
+    readonly before: DocumentFacts | null;
+    readonly after: DocumentFacts | null;
+    readonly changed: readonly string[];
+    readonly by: Actor;
+    readonly moved_between_rooms: boolean;
+};
+export type ItemFacts = {
+    readonly delivery: string;
+    readonly source: string | null;
+    readonly address: string | null;
+    readonly container: string | null;
+    readonly author: string | null;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly json: {
+        readonly value: unknown;
+    } | null;
+};
+export type MessageFacts = {
+    readonly sender: string;
+    readonly agent_function: string | null;
+    readonly path: string | null;
+};
+export type Resolved = {
+    readonly id: string;
+    readonly member?: string;
+};
+export declare function facts(document: Pick<Document, 'type' | 'fields' | 'sections'>, at: {
+    readonly id: string;
+    readonly path: string;
+}, model: VerifiedModel, resolve: (target: string) => Resolved | undefined): DocumentFacts;
+export declare function prosePaths(facts: DocumentFacts): string[];
+export declare function members(document: DocumentFacts, path: string): readonly string[];
+export declare function pointed(value: unknown, pointer: string): unknown;
+export declare function valuedChange(definition: Definition, pointer: string): boolean;
+export declare function datePointers(definition: Definition): string[];
+export declare function memberPointers(definition: Definition, memberType: string): string[];
+export declare function candidateOf(document: DocumentFacts): Candidate;
+export {};
+//# sourceMappingURL=event.d.ts.map