@agentshouse/mdruntime 0.1.0-cee9c8aa4cd86 → 0.1.0-cef76ea952695

package/dist/query.js

@@ -1,495 +1,4 @@
-import { pointerFacts, } from '@agentshouse/mdmodel';
-import { referenceField } from './model.js';
-import { normalize } from './paths.js';
-import { decodedCursor } from './windows.js';
-export class QueryError extends Error {
-    code;
-    retryable = false;
-    constructor(code, at, problem) {
-        super(`${code} at ${at}: ${problem}`);
-        this.code = code;
-    }
-}
-const RANGE = ['$gt', '$gte', '$lt', '$lte'];
-const SINGLE = ['$eq', '$ne', '$in', '$nin', '$all', '$size', '$exists'];
-const FILTER = ['rooms', 'types', 'where', 'pathPrefix', 'folder', 'paths', 'hop', 'backlinks'];
-const RELATED = ['types', 'where', 'pathPrefix', 'field'];
-const PARTS = ['fields', 'sections', 'preamble', 'markdown', 'backlinks', 'change', 'fileId'];
-const ORDER = ['by', 'direction', 'nulls', 'stringSort', 'locale', 'localeOptions'];
-const CALENDAR_DATE = /^(\d{4})-(\d{2})-(\d{2})$/;
-const STRAY_ESCAPE = /~(?![01])/u;
-export function invalid(at, problem) {
-    throw new QueryError('invalid-query', at, problem);
-}
-function place(at, name) {
-    return at === '' ? name : `${at}.${name}`;
-}
-export function plain(value) {
-    return (typeof value === 'object' &&
-        value !== null &&
-        !Array.isArray(value) &&
-        (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null));
-}
-export function known(value, allowed, at) {
-    for (const name of Object.keys(value)) {
-        if (!allowed.includes(name))
-            invalid(place(at, name), 'unknown part');
-    }
-}
-function list(input, at) {
-    if (!Array.isArray(input))
-        invalid(at, 'expects a list');
-    return input;
-}
-function value(input, at) {
-    if (Array.isArray(input))
-        invalid(at, 'a list is not a value');
-    if (input !== null &&
-        typeof input !== 'string' &&
-        typeof input !== 'boolean' &&
-        !(typeof input === 'number' && Number.isFinite(input))) {
-        invalid(at, 'not a value');
-    }
-    return input;
-}
-function values(input, at) {
-    return list(input, at).map((item, index) => value(item, `${at}[${index}]`));
-}
-function names(input, at) {
-    const listed = list(input, at);
-    if (listed.some((item) => typeof item !== 'string'))
-        invalid(at, 'expects a list of names');
-    return [...new Set(listed)].sort();
-}
-function pathsOf(input) {
-    const listed = list(input, 'paths');
-    if (listed.some((item) => typeof item !== 'string' || item === '' || normalize(item) !== item)) {
-        invalid('paths', 'expects a list of Paths');
-    }
-    return [...new Set(listed)].sort();
-}
-function directory(input, at) {
-    if (typeof input !== 'string' || normalize(input) !== input) {
-        invalid(at, 'expects a normalized directory');
-    }
-    return input;
-}
-function calendarDate(value) {
-    const match = CALENDAR_DATE.exec(value);
-    if (match === null)
-        return false;
-    const [year, month, day] = match.slice(1).map(Number);
-    const date = new Date(Date.UTC(year, month - 1, day));
-    return (date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day);
-}
-function itemOf(facts) {
-    return facts.type === 'array' ? facts.items : facts;
-}
-function fits(facts, value) {
-    const item = itemOf(facts);
-    if (item?.type === undefined)
-        return true;
-    if (item.values !== undefined)
-        return item.values.includes(value);
-    if (item.type === 'number')
-        return typeof value === 'number';
-    if (item.type === 'integer')
-        return Number.isSafeInteger(value);
-    if (item.type === 'boolean')
-        return typeof value === 'boolean';
-    if (item.type !== 'string' || typeof value !== 'string')
-        return false;
-    if (item.reference !== undefined)
-        return value !== '' && normalize(value) === value;
-    if (item.format === 'date')
-        return calendarDate(value);
-    return true;
-}
-function typing(facts, rooms, types, at) {
-    const read = rooms === null ? facts.rooms : facts.rooms.filter((room) => rooms.includes(room.locator));
-    const acquiring = !facts.listed &&
-        (rooms === null ||
-            rooms.some((locator) => !facts.rooms.some((room) => room.locator === locator)));
-    const available = !acquiring && read.every((room) => room.available);
-    const declared = read.flatMap((room) => room.types);
-    for (const name of types ?? []) {
-        if (name === 'any' || !available || declared.some((type) => type.name === name))
-            continue;
-        throw new QueryError('unknown-type', place(at, 'types'), `no model it reads declares ${name}`);
-    }
-    return {
-        untyped: types === null || types.includes('any') || !available,
-        types: types === null ? declared : declared.filter((type) => types.includes(type.name)),
-    };
-}
-function pointer(input, at) {
-    if (typeof input !== 'string' || !input.startsWith('/') || STRAY_ESCAPE.test(input)) {
-        invalid(at, 'expects a JSON Pointer');
-    }
-    return input;
-}
-function specs(typed, input, at) {
-    const field = pointer(input, at);
-    const declared = typed.types.flatMap((type) => {
-        const spec = pointerFacts(type, field);
-        return spec === undefined ? [] : [spec];
-    });
-    if (declared.length === 0 && !typed.untyped) {
-        throw new QueryError('unknown-field', at, `no MD Type it reads declares ${field}`);
-    }
-    if (!declared.some((spec) => spec.conditional))
-        return declared;
-    return declared.map((spec) => ({
-        facts: { prose: false },
-        through: several(spec),
-        conditional: true,
-    }));
-}
-function several(spec) {
-    return spec.through || spec.facts.type === 'array';
-}
-function single(spec) {
-    return spec.facts.type !== undefined && spec.facts.type !== 'array';
-}
-function every(declared, holds) {
-    return declared.length > 0 && declared.every(holds);
-}
-function kind(declared, checked, at) {
-    if (checked === null ||
-        declared.length === 0 ||
-        declared.some((spec) => fits(spec.facts, checked))) {
-        return;
-    }
-    throw new QueryError('wrong-kind', at, `${JSON.stringify(checked)} is not of its field's kind`);
-}
-function test(declared, input, at) {
-    if (!plain(input)) {
-        const equal = value(input, at);
-        kind(declared, equal, at);
-        return { op: 'eq', value: equal };
-    }
-    const operators = Object.keys(input);
-    if (operators.length === 0)
-        invalid(at, 'names no operator');
-    if (operators.some((operator) => RANGE.includes(operator))) {
-        const stray = operators.find((operator) => !RANGE.includes(operator));
-        if (stray !== undefined)
-            invalid(place(at, stray), 'cannot join a range');
-        if (every(declared, (spec) => spec.facts.type === 'array'))
-            invalid(at, 'a range on a list');
-        if (every(declared, (spec) => spec.facts.type === 'boolean' || spec.facts.type === 'object')) {
-            throw new QueryError('wrong-kind', at, 'its field does not compare in order');
-        }
-        return {
-            op: 'range',
-            bounds: RANGE.filter((operator) => operators.includes(operator)).map((operator) => {
-                const bound = value(input[operator], place(at, operator));
-                if (bound === null)
-                    invalid(place(at, operator), 'a range bound is never null');
-                kind(declared, bound, place(at, operator));
-                return [operator.slice(1), bound];
-            }),
-        };
-    }
-    if (operators.length > 1)
-        invalid(place(at, operators[1]), 'names a second operator');
-    const [operator] = operators;
-    const where = place(at, operator);
-    if (!SINGLE.includes(operator))
-        invalid(where, 'unknown operator');
-    const operand = input[operator];
-    if (operator === '$eq' || operator === '$ne') {
-        const compared = value(operand, where);
-        kind(declared, compared, where);
-        return operator === '$eq' ? { op: 'eq', value: compared } : { op: 'ne', value: compared };
-    }
-    if (operator === '$in' || operator === '$nin' || operator === '$all') {
-        const compared = values(operand, where);
-        compared.forEach((item, index) => kind(declared, item, `${where}[${index}]`));
-        if (operator === '$in')
-            return { op: 'in', values: compared };
-        if (operator === '$nin')
-            return { op: 'nin', values: compared };
-        if (compared.includes(null))
-            invalid(where, 'a list holds no null');
-        if (every(declared, single))
-            invalid(where, 'the field is not a list');
-        return { op: 'all', values: compared };
-    }
-    if (operator === '$size') {
-        if (!Number.isSafeInteger(operand) || operand < 0) {
-            invalid(where, 'expects a nonnegative integer');
-        }
-        if (every(declared, single))
-            invalid(where, 'the field is not a list');
-        return { op: 'size', size: operand };
-    }
-    if (typeof operand !== 'boolean')
-        invalid(where, 'expects true or false');
-    return { op: 'exists', exists: operand };
-}
-function condition(typed, input, at) {
-    if (!plain(input))
-        invalid(at, 'expects an object of field predicates');
-    const conditions = [];
-    for (const name of Object.keys(input).sort()) {
-        const where = name.startsWith('/') ? `${at}${name}` : place(at, name);
-        const entry = input[name];
-        if (name === '$and' || name === '$or') {
-            const nested = list(entry, where).map((item, index) => condition(typed, item, `${where}[${index}]`));
-            if (nested.length === 0)
-                invalid(where, 'expects a nonempty list');
-            conditions.push(name === '$and' ? { every: nested } : { some: nested });
-            continue;
-        }
-        if (name.startsWith('$'))
-            invalid(where, 'unknown operator');
-        conditions.push({ field: name, test: test(specs(typed, name, where), entry, where) });
-    }
-    if (conditions.length === 0)
-        invalid(at, 'names no field');
-    return conditions.length === 1 ? conditions[0] : { every: conditions };
-}
-function scope(facts, rooms, input, at) {
-    const types = input.types === undefined ? null : names(input.types, place(at, 'types'));
-    const typed = typing(facts, rooms, types, at);
-    return {
-        typed,
-        types,
-        where: input.where === undefined || (plain(input.where) && Object.keys(input.where).length === 0)
-            ? null
-            : condition(typed, input.where, place(at, 'where')),
-        pathPrefix: input.pathPrefix === undefined ? null : directory(input.pathPrefix, place(at, 'pathPrefix')),
-    };
-}
-function referenceName(typed, field, at) {
-    const declared = specs(typed, field, at);
-    if (declared.length > 0 &&
-        !declared.some((spec) => spec.conditional || referenceField(spec.facts))) {
-        invalid(at, 'not a reference field');
-    }
-    return field;
-}
-function hopOf(facts, rooms, root, input) {
-    if (!plain(input))
-        invalid('hop', 'expects an object');
-    known(input, RELATED, 'hop');
-    const field = referenceName(root, input.field, 'hop.field');
-    const { types, where, pathPrefix } = scope(facts, rooms, input, 'hop');
-    return { types, where, pathPrefix, field };
-}
-function backlinksOf(facts, rooms, input) {
-    if (!plain(input))
-        invalid('backlinks', 'expects an object');
-    known(input, RELATED, 'backlinks');
-    const { typed, types, where, pathPrefix } = scope(facts, rooms, input, 'backlinks');
-    const field = input.field === undefined ? null : referenceName(typed, input.field, 'backlinks.field');
-    return { types, where, pathPrefix, field };
-}
-function keyPlan(typed, input, at, path) {
-    if (input === 'room' || input === 'type' || input === 'folder' || (path && input === 'path')) {
-        return { of: input };
-    }
-    if (plain(input) && Object.hasOwn(input, 'field') && Object.keys(input).length === 1) {
-        if (specs(typed, input.field, place(at, 'field')).some(several)) {
-            invalid(place(at, 'field'), 'a path that can hold several values');
-        }
-        return { of: 'field', field: input.field };
-    }
-    return invalid(at, path ? 'expects room, path, type, folder or a field' : 'expects room, type, folder or a field');
-}
-function direction(input, at) {
-    if (input === undefined)
-        return 'asc';
-    if (input !== 'asc' && input !== 'desc')
-        invalid(at, 'expects asc or desc');
-    return input;
-}
-function orderOptions(input, at) {
-    const options = {
-        direction: direction(input.direction, place(at, 'direction')),
-    };
-    if (input.nulls !== undefined) {
-        if (input.nulls !== 'first' && input.nulls !== 'last') {
-            invalid(place(at, 'nulls'), 'expects first or last');
-        }
-        options.nulls = input.nulls;
-    }
-    if (input.stringSort !== undefined) {
-        if (input.stringSort !== 'lexical' && input.stringSort !== 'locale') {
-            invalid(place(at, 'stringSort'), 'expects lexical or locale');
-        }
-        options.stringSort = input.stringSort;
-    }
-    if (input.locale !== undefined) {
-        if (typeof input.locale !== 'string' || !collates(input.locale, undefined)) {
-            invalid(place(at, 'locale'), 'expects a locale name');
-        }
-        options.locale = input.locale;
-    }
-    if (input.localeOptions !== undefined) {
-        if (!plain(input.localeOptions) || !collates(options.locale, input.localeOptions)) {
-            invalid(place(at, 'localeOptions'), 'expects collation options');
-        }
-        options.localeOptions = input.localeOptions;
-    }
-    return options;
-}
-function collates(locale, options) {
-    try {
-        ''.localeCompare('', locale, options);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-function parts(typed, input, at, fields) {
-    if (input === undefined)
-        return null;
-    if (input === 'all')
-        return 'all';
-    const named = list(input, at);
-    named.forEach((name, index) => {
-        if (fields)
-            specs(typed, name, `${at}[${index}]`);
-        else if (typeof name !== 'string')
-            invalid(`${at}[${index}]`, 'expects a name');
-    });
-    return named;
-}
-export function flag(input, at) {
-    if (input === undefined)
-        return false;
-    if (input !== true)
-        invalid(at, 'expects true');
-    return true;
-}
-function documentShape(typed, input) {
-    const orderBy = (input.orderBy === undefined ? [] : list(input.orderBy, 'orderBy')).map((clause, index) => {
-        const at = `orderBy[${index}]`;
-        if (!plain(clause))
-            invalid(at, 'expects an order clause');
-        known(clause, ORDER, at);
-        return {
-            key: keyPlan(typed, clause.by, place(at, 'by'), true),
-            options: orderOptions(clause, at),
-        };
-    });
-    const select = input.select;
-    if (select === 'all') {
-        return {
-            kind: 'documents',
-            fields: 'all',
-            sections: 'all',
-            preamble: true,
-            markdown: true,
-            backlinks: true,
-            change: true,
-            fileId: true,
-            orderBy,
-        };
-    }
-    if (!plain(select))
-        invalid('select', "expects 'all' or the parts to return");
-    known(select, PARTS, 'select');
-    return {
-        kind: 'documents',
-        fields: parts(typed, select.fields, 'select.fields', true),
-        sections: parts(typed, select.sections, 'select.sections', false),
-        preamble: flag(select.preamble, 'select.preamble'),
-        markdown: flag(select.markdown, 'select.markdown'),
-        backlinks: flag(select.backlinks, 'select.backlinks'),
-        change: flag(select.change, 'select.change'),
-        fileId: flag(select.fileId, 'select.fileId'),
-        orderBy,
-    };
-}
-function groupShape(typed, input) {
-    const groupBy = list(input.groupBy, 'groupBy').map((key, index) => keyPlan(typed, key, `groupBy[${index}]`, false));
-    if (groupBy.length === 0)
-        invalid('groupBy', 'names no key');
-    const grouped = groupBy.map((key) => JSON.stringify(key));
-    const orderBy = (input.orderBy === undefined ? [] : list(input.orderBy, 'orderBy')).map((clause, index) => {
-        const at = `orderBy[${index}]`;
-        if (!plain(clause))
-            invalid(at, 'expects an order clause');
-        known(clause, ['by', 'direction'], at);
-        const by = clause.by === 'count'
-            ? 'count'
-            : grouped.indexOf(JSON.stringify(keyPlan(typed, clause.by, place(at, 'by'), false)));
-        if (by === -1)
-            invalid(place(at, 'by'), 'orders by a key the query does not group by');
-        return { by, direction: direction(clause.direction, place(at, 'direction')) };
-    });
-    return { kind: 'groups', groupBy, orderBy };
-}
-export function planOf(input, facts, reach = null) {
-    if (!plain(input))
-        invalid('query', 'expects a query object');
-    const grouped = input.groupBy !== undefined;
-    if (grouped && input.select !== undefined)
-        invalid('select', 'a grouped query selects nothing');
-    if (!grouped && input.select === undefined)
-        invalid('select', 'a Document query must select');
-    known(input, [...FILTER, 'orderBy', 'limit', 'after', 'total', grouped ? 'groupBy' : 'select'], '');
-    const limit = limitOf(input.limit);
-    const rooms = input.rooms === undefined ? null : names(input.rooms, 'rooms');
-    const { typed, ...root } = scope(facts, rooms, input, '');
-    const shape = grouped ? groupShape(typed, input) : documentShape(typed, input);
-    return {
-        key: queryKey(input),
-        rooms,
-        reach,
-        locked: [],
-        root,
-        folder: input.folder === undefined ? null : directory(input.folder, 'folder'),
-        paths: input.paths === undefined ? null : pathsOf(input.paths),
-        hop: input.hop === undefined ? null : hopOf(facts, rooms, typed, input.hop),
-        backlinks: input.backlinks === undefined ? null : backlinksOf(facts, rooms, input.backlinks),
-        shape,
-        limit,
-        after: continuationOf(input.after, shape.orderBy.length + 1),
-        total: flag(input.total, 'total'),
-    };
-}
-function continuationOf(input, arity) {
-    if (input === undefined)
-        return null;
-    const values = typeof input === 'string' ? decodedCursor(input) : null;
-    if (values === null || (values.length !== 0 && values.length !== arity)) {
-        invalid('after', 'expects the next an earlier result of this query returned');
-    }
-    return { text: input, values: values.length === 0 ? null : values };
-}
-export function limitOf(input) {
-    if (input === undefined)
-        return null;
-    if (!Number.isSafeInteger(input) || input < 0) {
-        invalid('limit', 'expects a nonnegative integer');
-    }
-    return input;
-}
-export function filterOf(input, facts, reach = null) {
-    if (!plain(input))
-        invalid('documents', 'expects a filter object');
-    known(input, FILTER, '');
-    return planOf({ ...input, select: {} }, facts, reach);
-}
-export function queryKey(query) {
-    return canonical(query);
-}
-function canonical(value) {
-    if (Array.isArray(value))
-        return `[${value.map(canonical).join(',')}]`;
-    if (typeof value === 'object' && value !== null) {
-        return `{${Object.keys(value)
-            .sort()
-            .map((name) => `${JSON.stringify(name)}:${canonical(value[name])}`)
-            .join(',')}}`;
-    }
-    return JSON.stringify(value);
-}
-export function identityOf(plan) {
-    return canonical(plan);
+import { planOf } from '@agentshouse/mdmodel';
+export function planWithin(input, facts, reach = null) {
+    return { ...planOf(input, facts), reach, locked: [] };
 }

package/dist/{chat/questions.d.ts → questions.d.ts}

@@ -1,4 +1,4 @@
-import type { ConversationView } from '../conversation.js';
+import type { ConversationView } from './conversation.js';
 export type ChatChoice = {
     readonly value: string;
     readonly label: string;
@@ -14,6 +14,7 @@ export type ChatField = {
 export type ChatAnswer = Readonly<Record<string, unknown>>;
 export type ChatQuestion = {
     readonly interaction: string;
+    readonly asked: string | null;
     readonly secret: boolean;
     readonly message: string;
     readonly fields: readonly ChatField[];
@@ -22,7 +23,9 @@ export type ChatQuestion = {
     readonly decline: unknown;
 };
 export declare function entered(field: ChatField): boolean;
-export declare function questionsOf(view: ConversationView | null): readonly ChatQuestion[];
+export declare function questionsOf(view: Pick<ConversationView, 'questions'> | null): readonly ChatQuestion[];
+export declare function openQuestion(questions: readonly unknown[]): string | null;
+export declare function questionAsked(questions: readonly unknown[]): string | null;
 export type ChatLone = {
     readonly question: ChatQuestion;
     readonly field: ChatField;

package/dist/questions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"questions.d.ts","sourceRoot":"","sources":["../src/questions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,cAAc,CAAC;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE3D,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAAC;AAuCF,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAEjD;AA2DD,wBAAgB,WAAW,CACzB,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,GAAG,IAAI,GAC/C,SAAS,YAAY,EAAE,CAiBzB;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,GAAG,IAAI,CAKzE;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,GAAG,IAAI,CAE1E;AAED,MAAM,MAAM,QAAQ,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAEtF,wBAAgB,MAAM,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,GAAG,QAAQ,GAAG,IAAI,CAM1E"}

package/dist/{chat/questions.js → questions.js}

@@ -1,4 +1,4 @@
-import { list, record, text } from './read.js';
+import { excerpt, list, record, text } from './read.js';
 const OPTION = 'optionId';
 function choicesOf(schema) {
     const items = record(schema.items);
@@ -95,6 +95,7 @@ export function questionsOf(view) {
             : [
                 {
                     interaction,
+                    asked: text(one, 'asked_at'),
                     secret: one.secret === true,
                     undelivered: one.telegram_undelivered === true,
                     ...asked,
@@ -102,8 +103,18 @@ export function questionsOf(view) {
             ];
     });
 }
+export function openQuestion(questions) {
+    const [asked] = questionsOf({ questions });
+    if (asked === undefined)
+        return null;
+    const said = asked.message === '' ? asked.fields[0]?.prompt : asked.message;
+    return said === undefined || said === '' ? null : excerpt(said);
+}
+export function questionAsked(questions) {
+    return questionsOf({ questions })[0]?.asked ?? null;
+}
 export function loneOf(questions) {
-    const asked = questions.length === 1 && !questions[0]?.secret ? questions[0] : undefined;
+    const asked = questions.length === 1 && !questions[0].secret ? questions[0] : undefined;
     const only = asked?.fields.length === 1 ? asked.fields[0] : undefined;
     return asked !== undefined && only !== undefined && entered(only)
         ? { question: asked, field: only }

package/dist/reach.d.ts

@@ -1,38 +1,45 @@
-import type { ReferrerScope } from './adapter.js';
-import type { MdRuntime, ReadinessPort, RuntimeTopic } from './connection.js';
+import type { AppRoom } from './listing.js';
+import type { ReadinessPort } from './preparation.js';
+import type { MdRuntime, RuntimeTopic } from './surface.js';
 import type { Plan, PlanReach, QueryResult } from './query.js';
 import type { Readiness } from './readiness.js';
-import { type SearchResult } from './search.js';
+import type { SearchResult } from './search.js';
 export type ReachedDocument = {
     readonly room: string;
     readonly path: string;
 };
+export type ReachedArea = {
+    readonly room: string;
+    readonly path: string;
+    readonly open: readonly string[];
+};
 export type PortReach = {
     readonly rooms: readonly string[];
     readonly documents: readonly ReachedDocument[];
+    readonly areas?: readonly ReachedArea[];
     readonly conversations: boolean;
 };
 export type Deliver = (message: unknown) => void;
-export type Watch = (topic: RuntimeTopic, input: readonly unknown[], deliver: Deliver) => () => void;
+export type Fail = (error: unknown) => void;
+export type Watch = (topic: RuntimeTopic, input: readonly unknown[], deliver: Deliver, fail: Fail) => () => void;
 export type RuntimeView = {
     md: MdRuntime;
     watch: Watch;
 };
 export type NarrowedView = RuntimeView & {
     narrow(reach: PortReach | null): void;
-    facts(port: ReadinessPort): void;
 };
 export type Reachable = RuntimeView & {
-    plan(input: unknown, reach: PortReach | null): Plan;
+    plan(input: unknown, reach: PortReach | null): Promise<Plan>;
     query(plan: Plan): Promise<QueryResult>;
-    watchPlan(plan: Plan, deliver: (message: unknown) => void): () => void;
-    search(input: unknown, reach: PortReach | null, locked: readonly string[]): Promise<SearchResult>;
+    watchPlan(plan: Plan, deliver: Deliver, fail: Fail): () => void;
+    search(input: unknown, reach: PortReach | null): Promise<SearchResult>;
     watchReadiness(port: ReadinessPort, reach: PortReach | null, deliver: (readiness: Readiness) => void): () => void;
-    referrerScope(referrer: unknown): ReferrerScope | null;
-    locked(room: string): boolean;
-    lockedRooms(): readonly string[];
+    locked(room: string): Promise<boolean>;
+    lockedRooms(): Promise<readonly string[]>;
     watchLocks(notify: () => void): () => void;
-    located(room: string, path: string, destination: string): ReachedDocument | null;
+    located(room: string, path: string, destination: string): Promise<ReachedDocument | null>;
+    room(locator: string): Promise<AppRoom | undefined>;
 };
 export declare function holds(reach: PortReach | null, room: string): boolean;
 export declare function governs(reach: PortReach | null, room: {
@@ -45,5 +52,5 @@ export declare function governs(reach: PortReach | null, room: {
     readonly selection: boolean;
 };
 export declare function planReach(reach: PortReach | null): PlanReach | null;
-export declare function narrowed(runtime: Reachable, given: PortReach | null, told: ReadinessPort): NarrowedView;
+export declare function narrowed(runtime: Reachable, given: PortReach | null, port: ReadinessPort): NarrowedView;
 //# sourceMappingURL=reach.d.ts.map

package/dist/reach.d.ts.map

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