react-cheminfo 0.77.0 → 0.78.0

package/lib/host/core/connectHost.js

@@ -41,7 +41,7 @@ export function connectHost(options) {
             .then(async () => {
             const result = request.type === 'load'
                 ? await applyLoad(request)
-                : answerGet(request, tool, outputs);
+                : await answerGet(request, tool, outputs);
             port?.postMessage(result);
         })
             // A request that failed must not stop the ones after it being served,

package/lib/host/core/connectHost.js.map

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

package/lib/host/core/connectTool.d.ts

@@ -0,0 +1,103 @@
+/**
+ * A host's side of the host protocol: answer the `hello` of the tool in a
+ * frame with a private port, hand it documents, hear the values it sends back,
+ * and ask it for others.
+ *
+ * Free of React and of the DOM — the frame and the window are handed in — so a
+ * test drives the whole exchange against a real tool side and a real
+ * `MessageChannel`.
+ */
+import type { HostError, HostItem, OutputMessage, UsedItem } from './protocol.ts';
+import type { ToolHello } from './toolMessages.ts';
+/** A message posted to this window, as far as a host reads it. */
+export interface ToolWindowEvent {
+    data: unknown;
+    source: unknown;
+    origin: string;
+}
+/** The window of the frame the tool runs in. */
+export interface ToolFrameWindow {
+    postMessage: (message: unknown, targetOrigin: string, transfer: Transferable[]) => void;
+}
+/** A document handed to a tool: what it shows, and what it sends back unasked. */
+export interface ToolDocument {
+    /** What the data belongs to; the tool applies the same document once. */
+    document: string;
+    /** The values, each with its kind. */
+    items: HostItem[];
+    /**
+     * The outputs the tool sends whenever they change, by key or by kind.
+     * @default undefined — nothing is sent unasked
+     */
+    accept?: string[];
+}
+/**
+ * What became of a document: shown, refused with the tool's reason, or never
+ * answered — another document took its place, the connection was closed, or
+ * the tool took too long.
+ */
+export type LoadOutcome = {
+    status: 'loaded';
+    used: UsedItem[];
+} | {
+    status: 'refused';
+    error: HostError;
+} | {
+    status: 'dropped';
+};
+/** Where the connection runs, and whom it talks to. */
+export interface ToolConnectionOptions {
+    /** The window of the frame, once there is one: `hello` is taken from it alone. */
+    frame: () => ToolFrameWindow | null;
+    /** Where the tool is served from: a message from any other origin is ignored. */
+    origin: string;
+    /** How the host introduces itself in `connect`. */
+    host: {
+        name: string;
+    };
+    /** Subscribe to this window's messages; the returned function unsubscribes. */
+    listen: (listener: (event: ToolWindowEvent) => void) => () => void;
+    /**
+     * Told each time the tool says `hello` — once per load of the frame — with
+     * what it takes and gives.
+     * @default undefined
+     */
+    onHello?: (tool: ToolHello) => void;
+    /**
+     * Told of every `output` the tool sends.
+     * @default undefined
+     */
+    onOutput?: (message: OutputMessage) => void;
+    /**
+     * How long a request may go unanswered, in milliseconds.
+     * @default REQUEST_TIMEOUT
+     */
+    timeout?: number;
+}
+/** A connection to a framed tool. */
+export interface ToolConnection {
+    /**
+     * Show a document. One handed over before the tool has connected waits for
+     * it, and the latest is handed over again whenever the tool connects anew —
+     * after a reload of its frame.
+     */
+    load: (document: ToolDocument) => Promise<LoadOutcome>;
+    /** The current values of some outputs; rejects with the tool's reason. */
+    get: (keys: readonly string[]) => Promise<HostItem[]>;
+    /** Stop listening and close the port; what is pending is dropped. */
+    close: () => void;
+}
+/** How long a request may go unanswered, in milliseconds. */
+export declare const REQUEST_TIMEOUT = 20000;
+/**
+ * Listen for the framed tool's `hello`, and talk to it once it has said it.
+ *
+ * A `hello` counts only from the frame's window and from the tool's origin —
+ * a frame that navigated elsewhere keeps its window — and `connect` is posted
+ * to that origin alone, so a page the frame later shows never receives the
+ * port, nor anything sent through it.
+ * @param options - The frame, the tool's origin, and what to tell.
+ * @returns The connection.
+ */
+export declare function connectTool(options: ToolConnectionOptions): ToolConnection;
+//# sourceMappingURL=connectTool.d.ts.map

package/lib/host/core/connectTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectTool.d.ts","sourceRoot":"","sources":["../../../src/host/core/connectTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,QAAQ,EACR,aAAa,EAEb,QAAQ,EACT,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,CACX,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,YAAY,EAAE,KACrB,IAAI,CAAC;CACX;AAED,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC3B,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,QAAQ,EAAE,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACvC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AAE1B,uDAAuD;AACvD,MAAM,WAAW,qBAAqB;IACpC,kFAAkF;IAClF,KAAK,EAAE,MAAM,eAAe,GAAG,IAAI,CAAC;IACpC,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvB,+EAA+E;IAC/E,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IACnE;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IAC5C;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,IAAI,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IACvD,0EAA0E;IAC1E,GAAG,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACtD,qEAAqE;IACrE,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,6DAA6D;AAC7D,eAAO,MAAM,eAAe,QAAS,CAAC;AAsBtC;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAgJ1E"}

package/lib/host/core/connectTool.js

@@ -0,0 +1,169 @@
+/**
+ * A host's side of the host protocol: answer the `hello` of the tool in a
+ * frame with a private port, hand it documents, hear the values it sends back,
+ * and ask it for others.
+ *
+ * Free of React and of the DOM — the frame and the window are handed in — so a
+ * test drives the whole exchange against a real tool side and a real
+ * `MessageChannel`.
+ */
+import { CONNECT_TYPE, PROTOCOL_VERSION } from "./protocol.js";
+import { readHello, readToolMessage } from "./toolMessages.js";
+/** How long a request may go unanswered, in milliseconds. */
+export const REQUEST_TIMEOUT = 20_000;
+const ABANDONED = {
+    timeout: 'The tool did not answer in time.',
+    reconnected: 'The tool was reloaded before it answered.',
+    closed: 'The tool is no longer connected.',
+};
+/**
+ * Listen for the framed tool's `hello`, and talk to it once it has said it.
+ *
+ * A `hello` counts only from the frame's window and from the tool's origin —
+ * a frame that navigated elsewhere keeps its window — and `connect` is posted
+ * to that origin alone, so a page the frame later shows never receives the
+ * port, nor anything sent through it.
+ * @param options - The frame, the tool's origin, and what to tell.
+ * @returns The connection.
+ */
+export function connectTool(options) {
+    const { frame, origin, host, listen, onHello, onOutput } = options;
+    const { timeout = REQUEST_TIMEOUT } = options;
+    const waiting = new Map();
+    let port = null;
+    let shown = null;
+    let count = 0;
+    let closed = false;
+    function post(body, handlers) {
+        if (port === null)
+            return;
+        count += 1;
+        const id = `h${count}`;
+        const timer = setTimeout(() => {
+            waiting.delete(id);
+            handlers.abandon('timeout');
+        }, timeout);
+        waiting.set(id, { ...handlers, timer });
+        port.postMessage({ ...body, id });
+    }
+    function abandonAll(reason) {
+        for (const entry of waiting.values()) {
+            clearTimeout(entry.timer);
+            entry.abandon(reason);
+        }
+        waiting.clear();
+    }
+    function settle(entry, outcome) {
+        entry.settle?.(outcome);
+        entry.settle = null;
+    }
+    function send(entry) {
+        const { document, items, accept } = entry.document;
+        post({
+            type: 'load',
+            document,
+            items,
+            ...(accept === undefined ? {} : { accept }),
+        }, {
+            answer: (message) => {
+                settle(entry, outcomeOf(message));
+            },
+            // Sent again to the reloaded tool, which answers then.
+            abandon: (reason) => {
+                if (reason !== 'reconnected')
+                    settle(entry, { status: 'dropped' });
+            },
+        });
+    }
+    function receive(data) {
+        const message = readToolMessage(data);
+        if (message === null)
+            return;
+        if (message.type === 'output') {
+            onOutput?.(message);
+            return;
+        }
+        const entry = waiting.get(message.id);
+        if (entry === undefined)
+            return;
+        waiting.delete(message.id);
+        clearTimeout(entry.timer);
+        entry.answer(message);
+    }
+    const stopListening = listen((event) => {
+        if (closed || event.origin !== origin)
+            return;
+        const target = frame();
+        if (target === null || event.source !== target)
+            return;
+        const tool = readHello(event.data);
+        if (tool === null)
+            return;
+        abandonAll('reconnected');
+        port?.close();
+        const channel = new MessageChannel();
+        port = channel.port1;
+        port.addEventListener('message', (message) => {
+            receive(message.data);
+        });
+        port.start();
+        target.postMessage({ type: CONNECT_TYPE, version: PROTOCOL_VERSION, host }, origin, [channel.port2]);
+        onHello?.(tool);
+        if (shown !== null)
+            send(shown);
+    });
+    return {
+        load(document) {
+            return new Promise((resolve) => {
+                if (shown !== null)
+                    settle(shown, { status: 'dropped' });
+                const entry = { document, settle: resolve };
+                shown = entry;
+                if (closed)
+                    settle(entry, { status: 'dropped' });
+                else
+                    send(entry);
+            });
+        },
+        get(keys) {
+            return new Promise((resolve, reject) => {
+                if (port === null) {
+                    reject(new Error(closed
+                        ? ABANDONED.closed
+                        : 'The tool has not connected yet, so it has nothing to give.'));
+                    return;
+                }
+                post({ type: 'get', keys: [...keys] }, {
+                    answer: (message) => {
+                        if (!message.ok) {
+                            reject(new Error(message.error.message, { cause: message }));
+                        }
+                        else {
+                            resolve('items' in message ? message.items : []);
+                        }
+                    },
+                    abandon: (reason) => {
+                        reject(new Error(ABANDONED[reason]));
+                    },
+                });
+            });
+        },
+        close() {
+            if (closed)
+                return;
+            closed = true;
+            stopListening();
+            abandonAll('closed');
+            if (shown !== null)
+                settle(shown, { status: 'dropped' });
+            port?.close();
+            port = null;
+        },
+    };
+}
+function outcomeOf(message) {
+    if (!message.ok)
+        return { status: 'refused', error: message.error };
+    return { status: 'loaded', used: 'used' in message ? message.used : [] };
+}
+//# sourceMappingURL=connectTool.js.map

package/lib/host/core/connectTool.js.map

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

package/lib/host/core/hostOutputs.d.ts

@@ -6,6 +6,10 @@
  * already has: the values as they stood once its document was applied, then
  * every value sent since. Opening a document therefore never writes it back,
  * and a band picked on one spectrum of a sample leaves the others alone.
+ *
+ * A value that costs something to make — a picture rendered from the scene on
+ * screen — is not read with the others: it is rendered when a `get` names it,
+ * and never sent unasked.
  */
 import type { GetRequest, HostItem, OutputMessage, ResultMessage, ToolInterface } from './protocol.ts';
 /** Where a tool's outputs are read, and how their changes are heard. */
@@ -18,6 +22,14 @@ export interface HostOutputs {
     read: () => readonly HostItem[];
     /** Be told whenever they may have changed; the returned function stops it. */
     subscribe: (listener: () => void) => () => void;
+    /**
+     * The outputs made only when a host asks for them, by key: a `get` naming one
+     * waits for its value, which is never sent unasked. A function resolving to
+     * `undefined` has nothing to give yet; one that rejects answers the `get`
+     * with its error's message.
+     * @default undefined — every output is read by `read`
+     */
+    render?: Readonly<Record<string, () => Promise<HostItem | undefined>>>;
 }
 /**
  * How long the outputs must stay still before a change is sent, in
@@ -26,13 +38,14 @@ export interface HostOutputs {
 export declare const OUTPUT_DELAY = 300;
 /**
  * Answer a `get` with the values it asks for — every output when it names
- * none.
+ * none — rendering those made on request.
  * @param request - The request.
  * @param tool - What the tool hands back.
  * @param outputs - Where the values are read, if anywhere.
- * @returns The values, or `no-output` when the tool has none of those asked.
+ * @returns The values, or `no-output` when the tool has none of those asked,
+ * or one could not be made.
  */
-export declare function answerGet(request: GetRequest, tool: ToolInterface, outputs: HostOutputs | undefined): ResultMessage;
+export declare function answerGet(request: GetRequest, tool: ToolInterface, outputs: HostOutputs | undefined): Promise<ResultMessage>;
 /** What the connection tells the publisher, and the means to stop it. */
 export interface OutputPublisher {
     /** A document was applied: what the host has is what the tool now shows. */

package/lib/host/core/hostOutputs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hostOutputs.d.ts","sourceRoot":"","sources":["../../../src/host/core/hostOutputs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EACR,aAAa,EACb,aAAa,EACb,aAAa,EACd,MAAM,eAAe,CAAC;AAEvB,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,IAAI,EAAE,MAAM,SAAS,QAAQ,EAAE,CAAC;IAChC,8EAA8E;IAC9E,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;CACjD;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,MAAM,CAAC;AAEhC;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,WAAW,GAAG,SAAS,GAC/B,aAAa,CAsBf;AAED,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IAChE,oCAAoC;IACpC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;;;OAGG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,yBAAyB;IACzB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,EACtC,KAAK,EAAE,MAAM,GACZ,eAAe,CA4CjB"}
+{"version":3,"file":"hostOutputs.d.ts","sourceRoot":"","sources":["../../../src/host/core/hostOutputs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EACR,aAAa,EACb,aAAa,EACb,aAAa,EACd,MAAM,eAAe,CAAC;AAEvB,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,IAAI,EAAE,MAAM,SAAS,QAAQ,EAAE,CAAC;IAChC,8EAA8E;IAC9E,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAChD;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;CACxE;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,MAAM,CAAC;AAEhC;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,WAAW,GAAG,SAAS,GAC/B,OAAO,CAAC,aAAa,CAAC,CAyCxB;AAYD,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IAChE,oCAAoC;IACpC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;;;OAGG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,yBAAyB;IACzB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,EACtC,KAAK,EAAE,MAAM,GACZ,eAAe,CA4CjB"}

package/lib/host/core/hostOutputs.js

@@ -6,6 +6,10 @@
  * already has: the values as they stood once its document was applied, then
  * every value sent since. Opening a document therefore never writes it back,
  * and a band picked on one spectrum of a sample leaves the others alone.
+ *
+ * A value that costs something to make — a picture rendered from the scene on
+ * screen — is not read with the others: it is rendered when a `get` names it,
+ * and never sent unasked.
  */
 import { kindAccepts } from "./kinds.js";
 /**
@@ -15,13 +19,14 @@ import { kindAccepts } from "./kinds.js";
 export const OUTPUT_DELAY = 300;
 /**
  * Answer a `get` with the values it asks for — every output when it names
- * none.
+ * none — rendering those made on request.
  * @param request - The request.
  * @param tool - What the tool hands back.
  * @param outputs - Where the values are read, if anywhere.
- * @returns The values, or `no-output` when the tool has none of those asked.
+ * @returns The values, or `no-output` when the tool has none of those asked,
+ * or one could not be made.
  */
-export function answerGet(request, tool, outputs) {
+export async function answerGet(request, tool, outputs) {
     const { id, keys } = request;
     const declared = new Set();
     for (const output of tool.outputs)
@@ -39,11 +44,40 @@ export function answerGet(request, tool, outputs) {
     }
     const items = [];
     for (const item of outputs.read()) {
-        if (item.key !== undefined && wanted.has(item.key))
+        if (item.key === undefined || !wanted.has(item.key))
+            continue;
+        if (renderOf(outputs, item.key) === undefined)
             items.push(item);
     }
+    const renders = [];
+    const renderedKeys = [];
+    for (const key of wanted) {
+        const render = renderOf(outputs, key);
+        if (render === undefined)
+            continue;
+        renders.push(render);
+        renderedKeys.push(key);
+    }
+    try {
+        const made = await Promise.all(renders.map((render) => render()));
+        for (let index = 0; index < made.length; index++) {
+            const item = made[index];
+            const key = renderedKeys[index];
+            if (item !== undefined && key !== undefined)
+                items.push({ ...item, key });
+        }
+    }
+    catch (error) {
+        return noOutput(id, error instanceof Error ? error.message : String(error));
+    }
     return { type: 'result', id, ok: true, items };
 }
+function renderOf(outputs, key) {
+    const { render } = outputs;
+    return render !== undefined && Object.hasOwn(render, key)
+        ? render[key]
+        : undefined;
+}
 /**
  * Send the host what changed of the outputs it accepted, once they settle.
  * @param outputs - Where the values are read.

package/lib/host/core/hostOutputs.js.map

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

package/lib/host/core/index.d.ts

@@ -1,15 +1,21 @@
 export type { HostConnectionOptions, HostMessageEvent } from './connectHost.ts';
 export { connectHost } from './connectHost.ts';
+export type { LoadOutcome, ToolConnection, ToolConnectionOptions, ToolDocument, ToolFrameWindow, ToolWindowEvent, } from './connectTool.ts';
+export { REQUEST_TIMEOUT, connectTool } from './connectTool.ts';
 export type { HostOutputs, OutputPublisher } from './hostOutputs.ts';
 export { OUTPUT_DELAY, answerGet, createOutputPublisher, } from './hostOutputs.ts';
 export type { StructureValue } from './hostStructure.ts';
 export { STRUCTURE_KINDS, hostStructureLoader, hostStructureSource, readHostMolecule, } from './hostStructure.ts';
 export type { IrJdxValue, IrPeakValue, IrPeaksValue } from './irKinds.ts';
 export { IR_JDX_SCHEMA, IR_PEAKS_SCHEMA } from './irKinds.ts';
-export type { CheckOutcome, CheckedValue, KnownKind, MolfileValue, OclIdValue, SmilesValue, } from './kinds.ts';
-export { checkValue, isKnownKind, kindAccepts } from './kinds.ts';
+export type { CheckOutcome, CheckedOf, CheckedValue, KnownKind, MolfileValue, OclIdValue, SmilesValue, } from './kinds.ts';
+export { checkValue, isKnownKind, kindAccepts, readOutput } from './kinds.ts';
 export type { GetRequest, HelloMessage, HostError, HostErrorCode, HostItem, HostRequest, LoadRequest, OutputMessage, ResultMessage, ToolInput, ToolInterface, ToolOutput, UsedItem, } from './protocol.ts';
 export { CONNECT_TYPE, HELLO_TYPE, MAX_ITEMS, MAX_LABEL_LENGTH, PROTOCOL_VERSION, isConnect, parseRequest, } from './protocol.ts';
+export type { NameValue, SvgImageValue, TableCell, TableValue, } from './resultKinds.ts';
+export { NAME_SCHEMA, SVG_IMAGE_SCHEMA, TABLE_SCHEMA } from './resultKinds.ts';
 export type { InputSelection, LoadedInput } from './selectInputs.ts';
 export { selectInputs } from './selectInputs.ts';
+export type { ToolHello } from './toolMessages.ts';
+export { readHello, readToolMessage } from './toolMessages.ts';
 //# sourceMappingURL=index.d.ts.map

package/lib/host/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/host/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EACL,YAAY,EACZ,SAAS,EACT,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC9D,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,UAAU,EACV,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAClE,YAAY,EACV,UAAU,EACV,YAAY,EACZ,SAAS,EACT,aAAa,EACb,QAAQ,EACR,WAAW,EACX,WAAW,EACX,aAAa,EACb,aAAa,EACb,SAAS,EACT,aAAa,EACb,UAAU,EACV,QAAQ,GACT,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,YAAY,EACZ,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/host/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EACV,WAAW,EACX,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,eAAe,EACf,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAChE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EACL,YAAY,EACZ,SAAS,EACT,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC9D,YAAY,EACV,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,UAAU,EACV,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC9E,YAAY,EACV,UAAU,EACV,YAAY,EACZ,SAAS,EACT,aAAa,EACb,QAAQ,EACR,WAAW,EACX,WAAW,EACX,aAAa,EACb,aAAa,EACb,SAAS,EACT,aAAa,EACb,UAAU,EACV,QAAQ,GACT,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,YAAY,EACZ,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,SAAS,EACT,aAAa,EACb,SAAS,EACT,UAAU,GACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC/E,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/host/core/index.js

@@ -1,8 +1,11 @@
 export { connectHost } from "./connectHost.js";
+export { REQUEST_TIMEOUT, connectTool } from "./connectTool.js";
 export { OUTPUT_DELAY, answerGet, createOutputPublisher, } from "./hostOutputs.js";
 export { STRUCTURE_KINDS, hostStructureLoader, hostStructureSource, readHostMolecule, } from "./hostStructure.js";
 export { IR_JDX_SCHEMA, IR_PEAKS_SCHEMA } from "./irKinds.js";
-export { checkValue, isKnownKind, kindAccepts } from "./kinds.js";
+export { checkValue, isKnownKind, kindAccepts, readOutput } from "./kinds.js";
 export { CONNECT_TYPE, HELLO_TYPE, MAX_ITEMS, MAX_LABEL_LENGTH, PROTOCOL_VERSION, isConnect, parseRequest, } from "./protocol.js";
+export { NAME_SCHEMA, SVG_IMAGE_SCHEMA, TABLE_SCHEMA } from "./resultKinds.js";
 export { selectInputs } from "./selectInputs.js";
+export { readHello, readToolMessage } from "./toolMessages.js";
 //# sourceMappingURL=index.js.map

package/lib/host/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/host/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EACL,YAAY,EACZ,SAAS,EACT,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAS9D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAgBlE,OAAO,EACL,YAAY,EACZ,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/host/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAS/C,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEhE,OAAO,EACL,YAAY,EACZ,SAAS,EACT,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAU9D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAgB9E,OAAO,EACL,YAAY,EACZ,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,YAAY,GACb,MAAM,eAAe,CAAC;AAOvB,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE/E,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/host/core/kinds.d.ts

@@ -4,14 +4,17 @@
  * name, a JSON Schema, and ajv.
  *
  * The names are pipeline's (`chem.molfile.2d`, `chem.ocl.id`…), plus
- * `chem.smiles`, which pipeline lists among its future schemas, and the two
- * infrared kinds of `./irKinds.ts`. A name with children is a category whose
+ * `chem.smiles`, which pipeline lists among its future schemas, the two
+ * infrared kinds of `./irKinds.ts`, and the kinds a tool hands back, of
+ * `./resultKinds.ts`. A name with children is a category whose
  * schema every child satisfies, so `chem.molfile` reads `chem.molfile.2d` and
  * `chem.molfile.3d.h.energy` alike; the fields a tool does not read are
  * stripped rather than refused, so a host sending more than it needs to is
  * never turned away.
  */
 import type { IrJdxValue, IrPeaksValue } from './irKinds.ts';
+import type { HostItem } from './protocol.ts';
+import type { NameValue, SvgImageValue, TableValue } from './resultKinds.ts';
 /** A molfile, V2000 or V3000. */
 export interface MolfileValue {
     molfile: string;
@@ -41,9 +44,22 @@ export type CheckedValue = {
 } | {
     kind: 'spectra.ir.peaks';
     value: IrPeaksValue;
+} | {
+    kind: 'image.svg';
+    value: SvgImageValue;
+} | {
+    kind: 'chem.name';
+    value: NameValue;
+} | {
+    kind: 'data.table';
+    value: TableValue;
 };
-/** The name of a kind a tool can read. */
+/** The name of a kind there is a schema for: one a tool reads, or one it hands back. */
 export type KnownKind = CheckedValue['kind'];
+/** A checked value of one kind. */
+export type CheckedOf<K extends KnownKind> = Extract<CheckedValue, {
+    kind: K;
+}>;
 /** What checking a value gave. */
 export type CheckOutcome = {
     valid: true;
@@ -78,4 +94,16 @@ export declare function isKnownKind(kind: string): kind is KnownKind;
  * them, `'/idCode: must be string'`.
  */
 export declare function checkValue(kind: KnownKind, value: unknown): CheckOutcome;
+/**
+ * Read the value a tool handed back under an output, as the kind the host
+ * asked for: the item must be of that kind or one under it, and pass that
+ * kind's schema.
+ * @param items - What the tool handed back.
+ * @param key - The output.
+ * @param kind - The kind it is read as.
+ * @returns The value tagged with the kind, or `undefined` when the tool handed
+ * nothing back under that key.
+ * @throws {Error} When the item is of another kind, or not of its shape.
+ */
+export declare function readOutput<K extends KnownKind>(items: readonly HostItem[], key: string, kind: K): CheckedOf<K> | undefined;
 //# sourceMappingURL=kinds.d.ts.map

package/lib/host/core/kinds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kinds.d.ts","sourceRoot":"","sources":["../../../src/host/core/kinds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG7D,iCAAiC;AACjC,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,gBAAgB;AAChB,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oEAAoE;AACpE,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAAC;AAEtD,0CAA0C;AAC1C,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAK7C,kCAAkC;AAClC,MAAM,MAAM,YAAY,GACtB;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE9E;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAMtE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,SAAS,CAE3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY,CAWxE"}
+{"version":3,"file":"kinds.d.ts","sourceRoot":"","sources":["../../../src/host/core/kinds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG7E,iCAAiC;AACjC,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oDAAoD;AACpD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,gBAAgB;AAChB,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oEAAoE;AACpE,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC;AAE9C,wFAAwF;AACxF,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAE7C,mCAAmC;AACnC,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,SAAS,IAAI,OAAO,CAAC,YAAY,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC;AAKhF,kCAAkC;AAClC,MAAM,MAAM,YAAY,GACtB;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE9E;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAMtE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,SAAS,CAE3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,YAAY,CAWxE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,SAAS,EAC5C,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,GACN,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,CAc1B"}