@agentshouse/mdruntime 0.1.0-cc5745cd9af96 → 0.1.0-ccbb89b0ca151

package/dist/turn.js

@@ -9,29 +9,51 @@ export function yielded() {
     });
 }
 const UNIT = 1 << 20;
+// A unit of runtime work ends within one 60 Hz frame so a port's next message waits at most a frame.
+const SLICE_MS = 16;
 export const ROW_WEIGHT = 256;
 export function after(value, next) {
     return value instanceof Promise ? value.then(next) : next(value);
 }
+function spending() {
+    let spent = 0;
+    let since = performance.now();
+    return {
+        spend(weight) {
+            spent += weight;
+            return spent >= UNIT || performance.now() - since >= SLICE_MS;
+        },
+        restart() {
+            spent = 0;
+            since = performance.now();
+        },
+    };
+}
+export function paced() {
+    const spent = spending();
+    return (weight) => (spent.spend(weight) ? yielded().then(() => spent.restart()) : undefined);
+}
 async function resumed(iterator, each, ended, paused) {
-    let spent = UNIT;
-    for (let next = iterator.next(); next.done !== true; next = iterator.next()) {
-        if (spent >= UNIT) {
+    const spent = spending();
+    for (let due = true;;) {
+        if (due) {
             await paused();
-            spent = 0;
+            spent.restart();
         }
-        spent += each(next.value);
-        if (spent >= UNIT)
+        const next = iterator.next();
+        if (next.done === true)
+            break;
+        due = spent.spend(each(next.value));
+        if (due)
             ended();
     }
     ended();
 }
 export function inUnits(items, each, ended = () => { }, paused = yielded) {
     const iterator = items[Symbol.iterator]();
-    let spent = 0;
+    const spent = spending();
     for (let next = iterator.next(); next.done !== true; next = iterator.next()) {
-        spent += each(next.value);
-        if (spent >= UNIT) {
+        if (spent.spend(each(next.value))) {
             ended();
             return resumed(iterator, each, ended, paused);
         }
@@ -51,14 +73,3 @@ export function stepped(steps) {
     };
     return after(inUnits(driven(), (weight) => weight), () => result);
 }
-export async function inChunks(items, weigh, each) {
-    for (let at = 0; at < items.length;) {
-        await yielded();
-        const chunk = [];
-        for (let spent = 0; at < items.length && spent < UNIT; at += 1) {
-            chunk.push(items[at]);
-            spent += weigh(items[at]);
-        }
-        await each(chunk);
-    }
-}

package/dist/validation.d.ts

@@ -0,0 +1,30 @@
+import { type Validation } from '@agentshouse/mdmodel';
+import { type Composition } from './collection.js';
+type Examined = {
+    readonly path: string;
+    readonly content: string | null;
+};
+export type Typed = {
+    readonly type: string | undefined;
+    readonly binary: boolean;
+};
+export type Walk = (after: string | null) => Promise<{
+    readonly entries: readonly Examined[];
+    readonly next: string | null;
+}>;
+export type Lookup = (paths: readonly string[]) => Promise<ReadonlyMap<string, Typed>>;
+export declare function validatedCollection(walk: Walk, lookup: Lookup, composition: Composition): Promise<Validation>;
+export type Changed = {
+    readonly path: string;
+    readonly was: string | null | undefined;
+    readonly now: string | null | undefined;
+};
+type CleanSource = {
+    readonly lookup: Lookup;
+    readonly texts: (paths: readonly string[]) => Promise<ReadonlyMap<string, string | null>>;
+    readonly referrers: ((targets: readonly string[]) => Promise<readonly string[]>) | null;
+};
+export declare function sameComposition(left: Composition, right: Composition): boolean;
+export declare function changedCleanly(changes: readonly Changed[], previous: Composition, composition: Composition, source: CleanSource): Promise<boolean>;
+export {};
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,UAAU,EAGhB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAMxE,KAAK,QAAQ,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAE3E,MAAM,MAAM,KAAK,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAEpF,MAAM,MAAM,IAAI,GAAG,CACjB,KAAK,EAAE,MAAM,GAAG,IAAI,KACjB,OAAO,CAAC;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,QAAQ,EAAE,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAAC;AAEtF,MAAM,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AAyBvF,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,UAAU,CAAC,CAyCrB;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACzC,CAAC;AAEF,KAAK,WAAW,GAAG;IACjB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IAC1F,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;CACzF,CAAC;AAaF,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAQ9E;AAqCD,wBAAsB,cAAc,CAClC,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,QAAQ,EAAE,WAAW,EACrB,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,OAAO,CAAC,CAsDlB"}

package/dist/validation.js

@@ -0,0 +1,162 @@
+import { assess, checkDocument, parse, parseFrontmatter, resolves, verdicts, } from '@agentshouse/mdmodel';
+import { governing, selected } from './collection.js';
+import { sameTyping } from './model.js';
+import { paced, ROW_WEIGHT, yielded } from './turn.js';
+const NO_TYPES = { types: {} };
+function modelOf(model) {
+    return model.status === 'unavailable' ? NO_TYPES : { types: model.types };
+}
+function typedText(content) {
+    const read = parse(content);
+    return read.ok && read.document.type !== undefined && read.document.type !== 'any';
+}
+function partVerdict(part) {
+    return part.unmodeled !== null
+        ? { verdict: 'refuse', rule: 'model-unavailable', file: part.unmodeled }
+        : part.judged.verdict();
+}
+export async function validatedCollection(walk, lookup, composition) {
+    const collection = { model: composition.model, judged: verdicts(), unmodeled: null };
+    const selection = composition.selection === null
+        ? null
+        : { model: composition.selection.model, judged: verdicts(), unmodeled: null };
+    const partOf = (path) => selection !== null && selected(composition, path) ? selection : collection;
+    const pace = paced();
+    for (let after = null;;) {
+        const { entries, next } = await walk(after);
+        const assessed = [];
+        for (const { path, content } of entries) {
+            if (content === null)
+                continue;
+            const part = partOf(path);
+            if (part.model.status === 'unavailable' && part.unmodeled === null && typedText(content)) {
+                part.unmodeled = path;
+            }
+            const assessment = assess(path, content, false, modelOf(part.model), { anyRoom: true });
+            assessed.push({ part, assessment });
+            await pace(content.length + assessment.targets.length * ROW_WEIGHT);
+        }
+        const targets = [...new Set(assessed.flatMap(({ assessment }) => assessment.targets))];
+        const known = await lookup(targets);
+        for (const { part, assessment } of assessed) {
+            const within = (path) => partOf(path) === part;
+            part.judged.add(assessment, (path) => (within(path) ? known.get(path)?.type : undefined), (path) => within(path) && known.get(path)?.binary === true);
+            await pace((assessment.targets.length + 1) * ROW_WEIGHT);
+        }
+        if (next === null)
+            break;
+        after = next;
+        await yielded();
+    }
+    const judged = [partVerdict(collection), ...(selection === null ? [] : [partVerdict(selection)])];
+    const refusals = judged.filter((verdict) => verdict.verdict === 'refuse');
+    if (refusals.length === 0)
+        return judged[0];
+    return refusals.find((refusal) => refusal.rule !== 'model-unavailable') ?? refusals[0];
+}
+function declared(content) {
+    if (content === undefined || content === null)
+        return undefined;
+    const read = parseFrontmatter(content);
+    return read.ok ? (read.frontmatter.type ?? 'any') : undefined;
+}
+function typedIn(content) {
+    const type = declared(content);
+    return type !== undefined && type !== 'any';
+}
+export function sameComposition(left, right) {
+    return (sameTyping(left.model, right.model) &&
+        (left.selection === null || right.selection === null
+            ? left.selection === right.selection
+            : sameTyping(left.selection.model, right.selection.model)) &&
+        JSON.stringify(left.selection?.roots ?? null) === JSON.stringify(right.selection?.roots ?? null));
+}
+function checked(path, content, composition) {
+    const model = governing(composition, path);
+    return checkDocument(path, content, modelOf(model), { anyRoom: true });
+}
+async function reachingAll(checks, composition, next) {
+    const targets = [
+        ...new Set(checks.flatMap(({ check }) => check.ok ? check.references.flatMap(({ target }) => (target === null ? [] : [target])) : [])),
+    ];
+    const known = await next(targets);
+    const pace = paced();
+    for (const { path, check } of checks) {
+        if (!check.ok)
+            return false;
+        const part = (other) => selected(composition, other) === selected(composition, path);
+        const resolved = check.references.every((reference) => resolves(reference, (other) => (part(other) ? known.get(other)?.type : undefined), (other) => part(other) && known.get(other)?.binary === true));
+        if (!resolved)
+            return false;
+        await pace((check.references.length + 1) * ROW_WEIGHT);
+    }
+    return true;
+}
+export async function changedCleanly(changes, previous, composition, source) {
+    if (!sameComposition(previous, composition))
+        return false;
+    const changedAt = new Map(changes.map((change) => [change.path, change]));
+    const next = async (paths) => {
+        const asked = paths.filter((path) => !changedAt.has(path));
+        const known = new Map(await source.lookup(asked));
+        for (const path of paths) {
+            const change = changedAt.get(path);
+            if (change === undefined)
+                continue;
+            if (change.now === undefined)
+                known.delete(path);
+            else
+                known.set(path, { type: declared(change.now), binary: change.now === null });
+        }
+        return known;
+    };
+    const shifted = [];
+    const checks = [];
+    const pace = paced();
+    for (const { path, was, now } of changes) {
+        await pace((now?.length ?? 0) + (was?.length ?? 0) + ROW_WEIGHT);
+        const modeled = governing(composition, path).status !== 'unavailable';
+        if ((now === undefined) !== (was === undefined) ||
+            declared(now) !== declared(was) ||
+            (now === null) !== (was === null)) {
+            shifted.push(path);
+        }
+        if (!modeled && typedIn(was) && !typedIn(now))
+            return false;
+        if (now === undefined)
+            continue;
+        if (now === null)
+            return false;
+        if (!modeled) {
+            if (declared(now) === undefined)
+                return false;
+            if (typedIn(now))
+                continue;
+            const check = checked(path, now, composition);
+            if (!check.ok)
+                return false;
+            checks.push({ path, check });
+            continue;
+        }
+        checks.push({ path, check: checked(path, now, composition) });
+    }
+    if (!(await reachingAll(checks, composition, next)))
+        return false;
+    if (shifted.length === 0)
+        return true;
+    if (source.referrers === null)
+        return false;
+    const files = (await source.referrers(shifted)).filter((file) => !changedAt.has(file));
+    if (files.length === 0)
+        return true;
+    const texts = await source.texts(files);
+    const rechecked = [];
+    for (const file of files) {
+        const content = texts.get(file);
+        if (content === undefined || content === null)
+            return false;
+        await pace(content.length + ROW_WEIGHT);
+        rechecked.push({ path: file, check: checked(file, content, composition) });
+    }
+    return reachingAll(rechecked, composition, next);
+}

package/dist/windows.d.ts

@@ -8,19 +8,15 @@ export type Ordering = {
     readonly locale: string | undefined;
     readonly localeOptions: Intl.CollatorOptions | undefined;
 };
-export type Windowed<T> = {
-    readonly kept: readonly T[];
-    readonly next: string | undefined;
-};
 interface Placed {
     readonly position: string;
     readonly identity: string;
 }
 export declare function messageOrder(left: Placed, right: Placed): number;
 export declare function precedes(message: Placed, before: readonly [string, string] | null): boolean;
-export declare function beyond(values: readonly unknown[], cursor: readonly unknown[], orderings: readonly Ordering[]): boolean;
+export declare function byCodePoint(left: string, right: string): number;
+export declare function compared(left: unknown, right: unknown, ordering: Ordering): number;
 export declare function cursorOf(values: readonly unknown[]): string;
 export declare function decodedCursor(text: string): readonly unknown[] | null;
-export declare function windowed<T>(entries: readonly T[], limit: number | null, after: string | undefined, cursor: (entry: T) => string): Windowed<T>;
 export {};
 //# sourceMappingURL=windows.d.ts.map

package/dist/windows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"windows.d.ts","sourceRoot":"","sources":["../src/windows.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC,eAAO,MAAM,UAAU,OAAO,CAAC;AAE/B,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAE/D;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;CAC1D,CAAC;AAEF,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAE7F,UAAU,MAAM;IACd,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,OAAO,CAE3F;AA0CD,wBAAgB,MAAM,CACpB,MAAM,EAAE,SAAS,OAAO,EAAE,EAC1B,MAAM,EAAE,SAAS,OAAO,EAAE,EAC1B,SAAS,EAAE,SAAS,QAAQ,EAAE,GAC7B,OAAO,CAMT;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAE3D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,OAAO,EAAE,GAAG,IAAI,CAOrE;AAED,wBAAgB,QAAQ,CAAC,CAAC,EACxB,OAAO,EAAE,SAAS,CAAC,EAAE,EACrB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,GAC3B,QAAQ,CAAC,CAAC,CAAC,CAOb"}
+{"version":3,"file":"windows.d.ts","sourceRoot":"","sources":["../src/windows.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC,eAAO,MAAM,UAAU,OAAO,CAAC;AAE/B,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAE/D;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;CAC1D,CAAC;AAEF,UAAU,MAAM;IACd,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,OAAO,CAE3F;AAaD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAO/D;AA4BD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAMlF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAE3D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,OAAO,EAAE,GAAG,IAAI,CAOrE"}

package/dist/windows.js

@@ -13,6 +13,27 @@ export function messageOrder(left, right) {
 export function precedes(message, before) {
     return before === null || messageOrder(message, { position: before[0], identity: before[1] }) < 0;
 }
+function rank(value) {
+    if (typeof value === 'boolean' || typeof value === 'number')
+        return 1;
+    if (typeof value === 'string')
+        return 2;
+    return Array.isArray(value) ? 3 : 4;
+}
+function unit(code) {
+    if (code >= 0xd800 && code < 0xe000)
+        return code + 0x2000;
+    return code >= 0xe000 ? code - 0x800 : code;
+}
+export function byCodePoint(left, right) {
+    for (let at = 0; at < Math.min(left.length, right.length); at += 1) {
+        const ours = left.charCodeAt(at);
+        const theirs = right.charCodeAt(at);
+        if (ours !== theirs)
+            return unit(ours) - unit(theirs);
+    }
+    return left.length - right.length;
+}
 function ascending(left, right, ordering) {
     if (left == null && right == null)
         return 0;
@@ -20,8 +41,13 @@ function ascending(left, right, ordering) {
         return ordering.nulls === 'first' ? -1 : 1;
     if (right == null)
         return ordering.nulls === 'first' ? 1 : -1;
-    if (typeof left === 'string' && typeof right === 'string' && ordering.stringSort === 'locale') {
-        return left.localeCompare(right, ordering.locale, ordering.localeOptions);
+    const ranked = rank(left) - rank(right);
+    if (ranked !== 0)
+        return ranked;
+    if (typeof left === 'string' && typeof right === 'string') {
+        return ordering.stringSort === 'locale'
+            ? left.localeCompare(right, ordering.locale, ordering.localeOptions)
+            : byCodePoint(left, right);
     }
     if (Array.isArray(left) && Array.isArray(right)) {
         for (let at = 0; at < Math.min(left.length, right.length); at += 1) {
@@ -32,9 +58,7 @@ function ascending(left, right, ordering) {
         return left.length - right.length;
     }
     if (typeof left === 'object')
-        return typeof right === 'object' ? 0 : 1;
-    if (typeof right === 'object')
-        return -1;
+        return 0;
     const held = left;
     const other = right;
     if (held < other)
@@ -43,7 +67,7 @@ function ascending(left, right, ordering) {
         return 1;
     return 0;
 }
-function compared(left, right, ordering) {
+export function compared(left, right, ordering) {
     if (ordering.direction === 'asc')
         return ascending(left, right, ordering);
     return ascending(right, left, {
@@ -51,25 +75,6 @@ function compared(left, right, ordering) {
         nulls: ordering.nulls === 'first' ? 'last' : 'first',
     });
 }
-function keyCompared(left, right) {
-    if (typeof left !== typeof right)
-        return typeof left === 'string' ? -1 : 1;
-    const held = left;
-    const other = right;
-    if (held < other)
-        return -1;
-    if (held > other)
-        return 1;
-    return 0;
-}
-export function beyond(values, cursor, orderings) {
-    for (let at = 0; at < orderings.length; at += 1) {
-        const result = compared(values[at], cursor[at], orderings[at]);
-        if (result !== 0)
-            return result > 0;
-    }
-    return keyCompared(values[orderings.length], cursor[orderings.length]) > 0;
-}
 export function cursorOf(values) {
     return JSON.stringify(values);
 }
@@ -82,12 +87,3 @@ export function decodedCursor(text) {
         return null;
     }
 }
-export function windowed(entries, limit, after, cursor) {
-    if (limit === null || entries.length <= limit)
-        return { kept: entries, next: undefined };
-    const kept = entries.slice(0, limit);
-    return {
-        kept,
-        next: kept.length === 0 ? (after ?? FROM_START) : cursor(kept[kept.length - 1]),
-    };
-}

package/dist/wire.d.ts

@@ -42,6 +42,10 @@ declare const MEMBERS: {
         readonly reach: 'within';
         readonly effect: 'read';
     };
+    readonly resolve: {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
     readonly 'binaryFile.read': {
         readonly reach: 'within';
         readonly effect: 'read';
@@ -50,7 +54,15 @@ declare const MEMBERS: {
         readonly reach: 'within';
         readonly effect: 'read';
     };
-    readonly 'binaryFile.readReference': {
+    readonly 'binaryFile.show': {
+        readonly reach: 'within';
+        readonly effect: 'read';
+    };
+    readonly 'binaryFile.attach': {
+        readonly reach: 'within';
+        readonly effect: 'action';
+    };
+    readonly 'binaryFile.part': {
         readonly reach: 'within';
         readonly effect: 'read';
     };
@@ -66,6 +78,10 @@ declare const MEMBERS: {
         readonly reach: 'whole';
         readonly effect: 'read';
     };
+    readonly cleanUp: {
+        readonly reach: 'whole';
+        readonly effect: 'write';
+    };
     readonly persistence: {
         readonly reach: 'runtime';
         readonly effect: 'read';

package/dist/wire.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../src/wire.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../src/wire.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IACjG,KAAK,IAAI,IAAI,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE3E,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErD,MAAM,MAAM,QAAQ,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAElF,QAAA,MAAM,OAAO;;iBACF,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,MAAM;;;iBAC/B,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,MAAM;;;iBAC9B,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,MAAM;;;iBAChC,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,MAAM;;;iBAChC,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,OAAO;;;iBAC3B,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,OAAO;;;iBAClC,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,MAAM;;;iBAC/B,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,MAAM;;;iBACrB,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,MAAM;;;iBAC/B,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,MAAM;;;iBAC/B,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,MAAM;;;iBAC7B,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,QAAQ;;;iBACnC,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,MAAM;;;iBAC5C,KAAK,EAAE,SAAS;iBAAE,MAAM,EAAE,QAAQ;;;iBAC/B,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,MAAM;;;iBACnC,KAAK,EAAE,OAAO;iBAAE,MAAM,EAAE,MAAM;;;iBAC1B,KAAK,EAAE,OAAO;iBAAE,MAAM,EAAE,OAAO;;;iBAC3B,KAAK,EAAE,SAAS;iBAAE,MAAM,EAAE,MAAM;;;iBACtC,KAAK,EAAE,SAAS;iBAAE,MAAM,EAAE,OAAO;;;iBAC3B,KAAK,EAAE,SAAS;iBAAE,MAAM,EAAE,OAAO;;;iBAC5B,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,MAAM;;;iBAC/B,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,MAAM;;;iBAC9B,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,OAAO;;;iBAC9B,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,OAAO;;;iBAChC,KAAK,EAAE,KAAK;iBAAE,MAAM,EAAE,MAAM;;;iBAC3B,KAAK,EAAE,KAAK;iBAAE,MAAM,EAAE,OAAO;;;iBAC9B,KAAK,EAAE,KAAK;iBAAE,MAAM,EAAE,OAAO;;;iBAC7B,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,MAAM;;;iBAC/B,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,MAAM;;;iBAC7B,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,QAAQ;;;iBACnC,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,QAAQ;;;iBAC/B,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,QAAQ;;;iBAC9B,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,QAAQ;;;iBACtC,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,QAAQ;;;iBAC/B,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,QAAQ;;;iBACjC,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,QAAQ;;;iBACrC,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,OAAO;;;iBAC9B,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,OAAO;;;iBAChC,KAAK,EAAE,QAAQ;iBAAE,MAAM,EAAE,OAAO;;CACF,CAAC;AAExD,QAAA,MAAM,MAAM;oBACH,QAAQ;wBACJ,QAAQ;mCACG,SAAS;6BACf,SAAS;iCACL,SAAS;4BACd,QAAQ;6BACP,SAAS;qBACjB,SAAS;oBACV,QAAQ;oBACR,QAAQ;4BACA,QAAQ;2BACT,KAAK;2BACL,QAAQ;4BACP,QAAQ;qBACf,QAAQ;CACsC,CAAC;AAEzD,eAAO,MAAM,IAAI,EAAE;IACjB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CACf,CAAC;AAEzC,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,OAAO,CAAC;AAC9C,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,MAAM,CAAC;AAE5C,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,GAC5E;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjC,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC9C,CAAC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC,GAC7C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtB,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B,GAAG,UAAU,GAAG,IAAI,CAWpB;AAED,eAAO,MAAM,mBAAmB,iCAAiC,CAAC;AAElE,eAAO,MAAM,WAAW,oBAAoB,CAAC;AAQ7C,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAiC5D;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAgC1D"}

package/dist/wire.js

@@ -7,12 +7,16 @@ const MEMBERS = {
     save: { reach: 'within', effect: 'write' },
     saveParts: { reach: 'within', effect: 'write' },
     history: { reach: 'within', effect: 'read' },
+    resolve: { reach: 'within', effect: 'read' },
     'binaryFile.read': { reach: 'within', effect: 'read' },
     'binaryFile.link': { reach: 'within', effect: 'read' },
-    'binaryFile.readReference': { reach: 'within', effect: 'read' },
+    'binaryFile.show': { reach: 'within', effect: 'read' },
+    'binaryFile.attach': { reach: 'within', effect: 'action' },
+    'binaryFile.part': { reach: 'within', effect: 'read' },
     call: { reach: 'actions', effect: 'action' },
     reached: { reach: 'within', effect: 'read' },
     log: { reach: 'whole', effect: 'read' },
+    cleanUp: { reach: 'whole', effect: 'write' },
     persistence: { reach: 'runtime', effect: 'read' },
     retry: { reach: 'runtime', effect: 'write' },
     reauthorize: { reach: 'runtime', effect: 'write' },

package/dist/words.d.ts

@@ -0,0 +1,19 @@
+export type Clause = {
+    readonly text: string;
+    readonly kind: 'term' | 'stem' | 'prefix' | 'phrase';
+    readonly term: string;
+};
+export type Located = {
+    readonly start: number;
+    readonly end: number;
+};
+export declare function indexed(text: string): string;
+export declare function matchClauses(text: string): Clause[] | null;
+export declare function matchExpression(clauses: readonly Clause[]): string;
+export declare function queryTerms(text: string): string[];
+export declare function snippet(part: string, terms: readonly string[], reach: number): {
+    readonly text: string;
+    readonly at: readonly [number, number];
+} | null;
+export declare function matched(part: string, terms: readonly string[]): string[];
+//# sourceMappingURL=words.d.ts.map

package/dist/words.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"words.d.ts","sourceRoot":"","sources":["../src/words.ts"],"names":[],"mappings":"AAwBA,MAAM,MAAM,MAAM,GAAG;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,OAAO,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAYvE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAgBD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAiB1D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAElE;AAMD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjD;AAyDD,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,KAAK,EAAE,MAAM,GACZ;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CAW1E;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAQxE"}

package/dist/words.js

@@ -0,0 +1,150 @@
+const SPACELESS = /(?:[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Thai}\p{Script=Lao}\p{Script=Khmer}\p{Script=Myanmar}\p{Script=Hangul}]\p{M}*)+/gu;
+const SPACELESS_TERM = /[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Thai}\p{Script=Lao}\p{Script=Khmer}\p{Script=Myanmar}\p{Script=Hangul}]/u;
+const TOKEN = /[\p{L}\p{N}\p{M}\p{Co}]+/gu;
+const MARKED = /([\p{Script=Latin}\p{Script=Greek}\p{Script=Cyrillic}])\p{M}+/gu;
+const INFLECTED = /^[\p{Script=Cyrillic}\p{Script=Greek}]+$/u;
+const FOLD = /\p{M}+/gu;
+const ASCII = /^[\x00-\x7f]$/;
+const PREFIXED_LETTERS = 2;
+const INFLECTED_LETTERS = 4;
+const PHRASE_TERMS = { least: 2, most: 6 };
+const GRAPHEMES = new Intl.Segmenter(undefined, { granularity: 'grapheme' });
+function bigrams(run) {
+    const characters = Array.from(run);
+    if (characters.length < 2)
+        return ` ${run} `;
+    const pairs = [];
+    for (let index = 0; index + 1 < characters.length; index += 1) {
+        pairs.push(characters[index] + characters[index + 1]);
+    }
+    return ` ${pairs.join(' ')} `;
+}
+export function indexed(text) {
+    return text.normalize('NFKD').replace(MARKED, '$1').normalize('NFKC').replace(SPACELESS, bigrams);
+}
+function tokens(text) {
+    return [...text.matchAll(TOKEN)].map(([token]) => token.toLowerCase());
+}
+function quoted(token) {
+    return `"${token.replaceAll('"', '""')}"`;
+}
+function truncated(term) {
+    const letters = Array.from(term);
+    if (!INFLECTED.test(term) || letters.length < INFLECTED_LETTERS)
+        return null;
+    return letters.slice(0, letters.length - (letters.length >= 6 ? 2 : 1)).join('');
+}
+export function matchClauses(text) {
+    const terms = tokens(indexed(text));
+    if (terms.length === 0)
+        return null;
+    const unique = [...new Set(terms)];
+    const clauses = unique.map((term) => ({ text: quoted(term), kind: 'term', term }));
+    for (const term of unique) {
+        const stem = truncated(term);
+        if (stem !== null)
+            clauses.push({ text: `${quoted(stem)}*`, kind: 'stem', term });
+    }
+    const last = terms[terms.length - 1];
+    if (!/\s$/u.test(text) && Array.from(last).length >= PREFIXED_LETTERS) {
+        clauses.push({ text: `${quoted(last)}*`, kind: 'prefix', term: last });
+    }
+    if (terms.length >= PHRASE_TERMS.least && terms.length <= PHRASE_TERMS.most) {
+        clauses.push({ text: quoted(terms.join(' ')), kind: 'phrase', term: terms.join(' ') });
+    }
+    return clauses;
+}
+export function matchExpression(clauses) {
+    return clauses.map(({ text }) => text).join(' OR ');
+}
+function folded(text) {
+    return text.normalize('NFKD').replace(FOLD, '').toLowerCase();
+}
+export function queryTerms(text) {
+    return [...new Set(tokens(text.normalize('NFKC')).map(folded))];
+}
+function agrees(token, term) {
+    if (SPACELESS_TERM.test(term))
+        return token.includes(term);
+    if (token.startsWith(term))
+        return true;
+    return token.length >= 3 && term.startsWith(token.slice(0, Math.max(3, token.length - 2)));
+}
+function inside(token, offset, term) {
+    const pieces = [...GRAPHEMES.segment(token)];
+    const owner = [];
+    let joined = '';
+    for (const [at, { segment }] of pieces.entries()) {
+        const part = folded(segment);
+        joined += part;
+        for (let index = 0; index < part.length; index += 1)
+            owner.push(at);
+    }
+    const found = joined.indexOf(term);
+    if (found < 0)
+        return null;
+    const first = pieces[owner[found]];
+    const last = pieces[owner[found + term.length - 1]];
+    return { start: offset + first.index, end: offset + last.index + last.segment.length };
+}
+function locate(part, terms) {
+    for (const match of part.matchAll(TOKEN)) {
+        const token = folded(match[0]);
+        for (const term of terms) {
+            if (!agrees(token, term))
+                continue;
+            if (!SPACELESS_TERM.test(term)) {
+                return { start: match.index, end: match.index + match[0].length };
+            }
+            const found = inside(match[0], match.index, term);
+            if (found !== null)
+                return found;
+        }
+    }
+    return null;
+}
+function settled(part, index) {
+    if (index <= 0 || index >= part.length)
+        return true;
+    const before = part[index - 1];
+    const after = part[index];
+    if (before === '\n')
+        return true;
+    return ASCII.test(before) && ASCII.test(after) && !(before === '\r' && after === '\n');
+}
+function edgesAround(part, low, high) {
+    let from = Math.max(0, low);
+    while (!settled(part, from))
+        from -= 1;
+    let to = Math.min(part.length, high);
+    while (!settled(part, to))
+        to += 1;
+    const edges = [...GRAPHEMES.segment(part.slice(from, to))].map(({ index }) => from + index);
+    edges.push(to);
+    return edges;
+}
+export function snippet(part, terms, reach) {
+    const located = locate(part, terms);
+    if (located === null)
+        return null;
+    const edges = edgesAround(part, located.start - 2 * reach, located.end + 2 * reach);
+    const last = (limit) => edges.filter((edge) => edge <= limit).at(-1) ?? edges[0];
+    const first = (limit) => edges.find((edge) => edge >= limit) ?? edges[edges.length - 1];
+    const from = last(located.start);
+    const to = Math.max(first(Math.min(located.end, from + reach)), first(from + 1));
+    const start = first(Math.max(0, from - reach));
+    const end = last(Math.min(part.length, to + reach));
+    return { text: part.slice(start, end), at: [from - start, to - start] };
+}
+export function matched(part, terms) {
+    const found = new Set();
+    for (const match of part.matchAll(TOKEN)) {
+        const token = folded(match[0]);
+        for (const term of terms)
+            if (agrees(token, term))
+                found.add(term);
+        if (found.size === terms.length)
+            break;
+    }
+    return [...found];
+}