@pinecall/dot 0.11.24 → 0.11.26

package/dist/tutor/options.d.ts

@@ -1,5 +1,6 @@
-/** What a page gives `tutor()`: where it rests, its colour and shape, whose words show, the walks it plays, and the views of its own tools. */
+/** What a page gives `tutor()`: where it rests, its colour and shape, whose words show, the walks it plays, and the views of its own tools; and the tutor it hands back. */
 import type { Shape } from "../face/shape.js";
+import type { DoorRequest } from "../wire/ask.js";
 import type { Captions } from "./captions.js";
 import type { Views } from "./views.js";
 import type { Walked } from "./walking.js";
@@ -26,8 +27,16 @@ export interface TutorOptions {
         walks?: string | undefined;
         stop?: string | undefined;
         pause?: string | undefined;
+        /** The buttons that take a walk a sentence back and on: "Back", "Next". */
+        back?: string | undefined;
+        next?: string | undefined;
         close?: string | undefined;
         more?: string | undefined;
+        ask?: string | undefined;
+        askAgent?: string | undefined;
+        looking?: string | undefined;
+        notHere?: string | undefined;
+        forAgent?: string | undefined;
     } | undefined;
     /** Where the agent published its recorded walks (`GET …/v1/agents/{slug}/public/walks`): a button beside the face plays them with no call. */
     walks?: string | undefined;
@@ -38,5 +47,32 @@ export interface TutorOptions {
      * times, the booking form, a piece of code. Read each time a tool finishes, so a page may set it late.
      */
     views?: Views | undefined;
+    /**
+     * The site's door, on its own server, answered by `@pinecall/dot/server`'s `answer()`: what the visitor
+     * typed decided (`{ decide }`), the row of a table a walk read that answers them (`{ row }`), a walk's
+     * sentence with slots recorded (`{ say }`). Given, the walks' menu has a field: "Ask me to show you…".
+     */
+    ask?: ((request: DoorRequest) => Promise<unknown>) | undefined;
+    /** With `ask`, the field in the walks' menu; false leaves it out, for a door that only reads the page aloud. Default true. */
+    typing?: boolean | undefined;
+    /**
+     * The page read aloud in the agent's voice, with no call: what it marks `data-pinecall-read`, the part read lit and
+     * pointed at, its examples (`data-pinecall-press`) pressed on the way. The title of its pill, first in the walks' menu:
+     * "Leer el capítulo". Each part is recorded by the site's door (`{ read }`), so it takes `ask`.
+     */
+    reading?: string | undefined;
+    /** What they typed, for a question the page cannot show: the site takes it to the agent (a call, it written in). */
+    onTalk?: ((message: string) => void) | undefined;
+}
+export interface Tutor {
+    /** A message the agent sent on `pinecall.ui`: true when it was the tutor's to carry out, false for a card or choices. */
+    take(data: unknown): boolean;
+    /** Let the face hear the voice: call it from the click that starts the call. */
+    wake(): void;
+    /** Read the page aloud (`reading`), from the visitor's click: a button of the site's own. */
+    read(): void;
+    /** Stop the walk or the reading playing, if one is: the site's own reason to (the visitor took over). */
+    stop(): void;
+    close(): void;
 }
 //# sourceMappingURL=options.d.ts.map

package/dist/tutor/options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/tutor/options.ts"],"names":[],"mappings":"AAAA,+IAA+I;AAE/I,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IACpC,oFAAoF;IACpF,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,kEAAkE;IAClE,OAAO,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACnC,iHAAiH;IACjH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,sEAAsE;IACtE,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IAC1B,iGAAiG;IACjG,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,qIAAqI;IACrI,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,gKAAgK;IAChK,KAAK,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC3B,GAAG,SAAS,CAAC;IACd,8IAA8I;IAC9I,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,+EAA+E;IAC/E,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAChD;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;CAC3B"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/tutor/options.ts"],"names":[],"mappings":"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"}

package/dist/tutor/options.js

@@ -1,3 +1,3 @@
-/** What a page gives `tutor()`: where it rests, its colour and shape, whose words show, the walks it plays, and the views of its own tools. */
+/** What a page gives `tutor()`: where it rests, its colour and shape, whose words show, the walks it plays, and the views of its own tools; and the tutor it hands back. */
 export {};
 //# sourceMappingURL=options.js.map

package/dist/tutor/options.js.map

@@ -1 +1 @@
-{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/tutor/options.ts"],"names":[],"mappings":"AAAA,+IAA+I"}
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/tutor/options.ts"],"names":[],"mappings":"AAAA,4KAA4K"}

package/dist/tutor/reading.d.ts

@@ -0,0 +1,58 @@
+/** A page read aloud with no call: what the site marks `data-pinecall-read`, part by part, in the agent's voice, the part read lit and pointed at; its examples pressed on the way. */
+import type { RecordedWalk, WalkStep } from "../wire/index.js";
+export { QUIET_ATTRIBUTE, lineIn, piecesOf, textOf, wordsOf } from "./text.js";
+export declare const READ_ATTRIBUTE = "data-pinecall-read";
+export declare const PRESS_ATTRIBUTE = "data-pinecall-press";
+/** On a field: the words typed into it when the reading reaches it, the page's own example (a chat's question); the `data-pinecall-press` after it sends it. */
+export declare const TYPE_ATTRIBUTE = "data-pinecall-type";
+/** On a chat's send button: the dot talks to what it sends to, turn by turn, until it gets this (or the chat ends). */
+export declare const GOAL_ATTRIBUTE = "data-pinecall-goal";
+/** On each turn of a chat talked to: whose it is, `agent`, `caller` or another (a tool the agent used, `end`); all but the caller's read aloud as they come, by their `data-pinecall-say` when they have one. */
+export declare const SAID_ATTRIBUTE = "data-pinecall-said";
+/** On the output of a talk that is a spoken call: the agent is heard there, so its turns are not read aloud; the dot's own lines are said into it. */
+export declare const HEARD_ATTRIBUTE = "data-pinecall-heard";
+/** The event a spoken call's output is told the dot's line by, as the line starts: `detail.text`, `detail.audio` (its recording's URL) and `detail.durationMs`; the site plays it into the call. */
+export declare const SAYING_EVENT = "pinecall-saying";
+/** The line an element is said as, instead of what it shows: the same the agent says in a call. */
+export declare const SAY_ATTRIBUTE = "data-pinecall-say";
+/** What an example's output shows, said pointing at it once it answered. */
+export declare const THEN_ATTRIBUTE = "data-pinecall-then";
+/** On an example's button: the id of a list of notes on its output, each `data-pinecall-find` a text (or `/a regex/`) of a line of it. */
+export declare const NOTES_ATTRIBUTE = "data-pinecall-notes";
+export declare const FIND_ATTRIBUTE = "data-pinecall-find";
+/** On an example's button: its output, when no note of the page's covers it, explained by the site's door; its value names the command. */
+export declare const EXPLAIN_ATTRIBUTE = "data-pinecall-explain";
+/** On an output while its notes are read, for the site to widen it: a box that scrolls shows whole. */
+export declare const READING_ATTRIBUTE = "data-pinecall-reading";
+/** The name a page read aloud plays under. */
+export declare const READ_WALK = "read";
+/** A step about an example's output: the output, and the text of the line it is about; null, the output whole. */
+export interface AboutOutput {
+    output: Element;
+    find: string | null;
+}
+/** Words typed into a field as a sentence is said. */
+export interface Typed {
+    field: Element;
+    text: string;
+}
+/** A page as it is read: its steps, the element each is about, which are about an output, the goal a step talks for, what is typed as one is said, and the call one is said into. */
+export interface Reading {
+    walk: RecordedWalk;
+    at: Element[];
+    outputs: (AboutOutput | undefined)[];
+    goals: WeakMap<WalkStep, string>;
+    typed: WeakMap<WalkStep, Typed>;
+    spoken: WeakMap<WalkStep, Element>;
+}
+/** The page as it reads now, under the title the menu shows it with; null when it marks nothing to read. */
+export declare function readingOf(document: Document, title: string): Reading | null;
+/** The reading from where the page is scrolled to: from its first part not above what is seen; whole when that is its first. */
+export declare function fromHere(reading: Reading): Reading;
+/** The name a step calls an example by: its label, its placeholder, its words. */
+export declare const labelOf: (element: Element) => string;
+/** An example's output: what it controls (`aria-controls`), else itself. */
+export declare function outputOf(element: Element): Element;
+/** The language an output's page is in, for the door; none when the page does not say. */
+export declare const languageOf: (element: Element) => string | undefined;
+//# sourceMappingURL=reading.d.ts.map

package/dist/tutor/reading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reading.d.ts","sourceRoot":"","sources":["../../src/tutor/reading.ts"],"names":[],"mappings":"AAAA,uLAAuL;AA6BvL,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG/D,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE/E,eAAO,MAAM,cAAc,uBAAuB,CAAC;AACnD,eAAO,MAAM,eAAe,wBAAwB,CAAC;AACrD,gKAAgK;AAChK,eAAO,MAAM,cAAc,uBAAuB,CAAC;AACnD,uHAAuH;AACvH,eAAO,MAAM,cAAc,uBAAuB,CAAC;AACnD,iNAAiN;AACjN,eAAO,MAAM,cAAc,uBAAuB,CAAC;AACnD,sJAAsJ;AACtJ,eAAO,MAAM,eAAe,wBAAwB,CAAC;AACrD,oMAAoM;AACpM,eAAO,MAAM,YAAY,oBAAoB,CAAC;AAC9C,mGAAmG;AACnG,eAAO,MAAM,aAAa,sBAAsB,CAAC;AACjD,4EAA4E;AAC5E,eAAO,MAAM,cAAc,uBAAuB,CAAC;AACnD,0IAA0I;AAC1I,eAAO,MAAM,eAAe,wBAAwB,CAAC;AACrD,eAAO,MAAM,cAAc,uBAAuB,CAAC;AACnD,2IAA2I;AAC3I,eAAO,MAAM,iBAAiB,0BAA0B,CAAC;AACzD,uGAAuG;AACvG,eAAO,MAAM,iBAAiB,0BAA0B,CAAC;AACzD,8CAA8C;AAC9C,eAAO,MAAM,SAAS,SAAS,CAAC;AAKhC,kHAAkH;AAClH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,sDAAsD;AACtD,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qLAAqL;AACrL,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,OAAO,EAAE,CAAC;IACd,OAAO,EAAE,CAAC,WAAW,GAAG,SAAS,CAAC,EAAE,CAAC;IACrC,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAChC,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;CACpC;AAuBD,4GAA4G;AAC5G,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAuF3E;AAKD,gIAAgI;AAChI,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAIlD;AAED,kFAAkF;AAClF,eAAO,MAAM,OAAO,YAAa,OAAO,KAAG,MAAkH,CAAC;AAE9J,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAGlD;AAED,0FAA0F;AAC1F,eAAO,MAAM,UAAU,YAAa,OAAO,KAAG,MAAM,GAAG,SAAoE,CAAC"}

package/dist/tutor/reading.js

@@ -0,0 +1,193 @@
+/** A page read aloud with no call: what the site marks `data-pinecall-read`, part by part, in the agent's voice, the part read lit and pointed at; its examples pressed on the way. */
+//
+// The site marks a container `data-pinecall-read`: its headings, paragraphs, items and captions are read
+// in the page's order, as written. Each is recorded in the agent's voice when the reading reaches it, by
+// the site's door (`{ read }`), the next one asked for while one plays; a part longer than the voice takes
+// at once is read a few sentences at a time. A field marked `data-pinecall-type` is an example the page
+// types: its value is typed into it when the reading reaches it, and the button marked `data-pinecall-press`
+// after it sends it, in any form (the page's own example, not the visitor's). A button marked
+// `data-pinecall-press` in it is an example:
+// pressed when the reading reaches it (its value, when it has one, said first), and the reading waits for
+// what the button controls (`aria-controls`) to answer and not be busy, then says its `data-pinecall-then`
+// (what the output shows) pointing at it, and each note of its `data-pinecall-notes` list pointing at the
+// line of the output the note finds (`data-pinecall-find`): the output lit line by line, as a person
+// reads a result with a finger on it. A button marked `data-pinecall-explain` with no notes of its own
+// has its output explained by the site's door (`{ explain }`, the agent's model) once it answered, the
+// notes it gives read the same way, in the place of its `data-pinecall-then` (said when the model gives none). Under `data-pinecall-quiet` nothing is read (code, a legend),
+// though a button marked to press there is still pressed. An element with `data-pinecall-say` is said
+// as that line, written to be heard, instead of what it shows; the parts inside it are not read again. A heading that
+// shares its box with one text alone (a card: its title and its words) is read with it, "Title. Words",
+// and the whole box lit: a title said alone, then its words, sounds like two things. A frame of the site's own
+// (a chat, a widget) is read in its place, as a page: what its page marks `data-pinecall-read`. A send button
+// marked `data-pinecall-goal` is a chat the dot talks to: it asks the door for its line, says it as it types it
+// (the letters paced to the recording), sends it, reads the agent's answer aloud (`data-pinecall-said` on each turn), and goes on until it has what it came
+// for, the chat read as it goes. Any chat's answer (`data-pinecall-said="agent"`) is read as it came
+// once the press that drew it out is done, before the notes on it. A page read with its top scrolled away is read from the first part
+// still in view (`fromHere`): a person who comes back to the middle of a chapter goes on from there.
+import { boxOf, frameOf, pageOf } from "../pointer/frames.js";
+import { seenOf } from "../pointer/flight.js";
+import { QUIET_ATTRIBUTE, piecesOf, seen, wordsOf } from "./text.js";
+export { QUIET_ATTRIBUTE, lineIn, piecesOf, textOf, wordsOf } from "./text.js";
+export const READ_ATTRIBUTE = "data-pinecall-read";
+export const PRESS_ATTRIBUTE = "data-pinecall-press";
+/** On a field: the words typed into it when the reading reaches it, the page's own example (a chat's question); the `data-pinecall-press` after it sends it. */
+export const TYPE_ATTRIBUTE = "data-pinecall-type";
+/** On a chat's send button: the dot talks to what it sends to, turn by turn, until it gets this (or the chat ends). */
+export const GOAL_ATTRIBUTE = "data-pinecall-goal";
+/** On each turn of a chat talked to: whose it is, `agent`, `caller` or another (a tool the agent used, `end`); all but the caller's read aloud as they come, by their `data-pinecall-say` when they have one. */
+export const SAID_ATTRIBUTE = "data-pinecall-said";
+/** On the output of a talk that is a spoken call: the agent is heard there, so its turns are not read aloud; the dot's own lines are said into it. */
+export const HEARD_ATTRIBUTE = "data-pinecall-heard";
+/** The event a spoken call's output is told the dot's line by, as the line starts: `detail.text`, `detail.audio` (its recording's URL) and `detail.durationMs`; the site plays it into the call. */
+export const SAYING_EVENT = "pinecall-saying";
+/** The line an element is said as, instead of what it shows: the same the agent says in a call. */
+export const SAY_ATTRIBUTE = "data-pinecall-say";
+/** What an example's output shows, said pointing at it once it answered. */
+export const THEN_ATTRIBUTE = "data-pinecall-then";
+/** On an example's button: the id of a list of notes on its output, each `data-pinecall-find` a text (or `/a regex/`) of a line of it. */
+export const NOTES_ATTRIBUTE = "data-pinecall-notes";
+export const FIND_ATTRIBUTE = "data-pinecall-find";
+/** On an example's button: its output, when no note of the page's covers it, explained by the site's door; its value names the command. */
+export const EXPLAIN_ATTRIBUTE = "data-pinecall-explain";
+/** On an output while its notes are read, for the site to widen it: a box that scrolls shows whole. */
+export const READING_ATTRIBUTE = "data-pinecall-reading";
+/** The name a page read aloud plays under. */
+export const READ_WALK = "read";
+/** The parts of a container a person reads out, each once: the outermost when one holds another. */
+const PARTS = "h1, h2, h3, h4, h5, h6, p, li, dt, dd, figcaption, blockquote, caption";
+/** The parts of `box` a person reads, outermost, in order. */
+function partsIn(box) {
+    return [...box.querySelectorAll(PARTS)].filter((part) => seen(part) && part.closest(`[${QUIET_ATTRIBUTE}]`) === null && !box.contains(part.parentElement?.closest(PARTS) ?? null));
+}
+/** A heading and the one text it shares its box with, as one: the box and "Title. Words"; null when it is not one. */
+function card(heading, root) {
+    const box = heading.parentElement;
+    if (box === null || box === root || !root.contains(box) || !/^H[1-6]$/.test(heading.tagName))
+        return null;
+    const parts = partsIn(box);
+    const words = parts[1];
+    if (parts.length !== 2 || parts[0] !== heading || words === undefined)
+        return null;
+    const title = wordsOf(heading);
+    return { box, words, text: `${title}${/[.!?:…]$/.test(title) ? "" : "."} ${wordsOf(words)}` };
+}
+/** The containers of `document` that are read, outermost. */
+function rootsOf(document) {
+    return [...document.querySelectorAll(`[${READ_ATTRIBUTE}]`)].filter((root) => root.parentElement?.closest(`[${READ_ATTRIBUTE}]`) == null);
+}
+/** The page as it reads now, under the title the menu shows it with; null when it marks nothing to read. */
+export function readingOf(document, title) {
+    const steps = [];
+    const at = [];
+    const outputs = [];
+    const goals = new WeakMap();
+    const typed = new WeakMap();
+    const spoken = new WeakMap();
+    /** A field marked to type, typed as the next press's line is said. */
+    let pending = null;
+    /** The words of a card, read with its title. */
+    const read = new Set();
+    const line = (text, element, about) => {
+        const said = [];
+        for (const piece of piecesOf(text.replace(/\s+/g, " ").trim())) {
+            const step = { say: piece, beats: [], live: true };
+            steps.push(step);
+            said.push(step);
+            at.push(element);
+            outputs[at.length - 1] = about;
+        }
+        return said;
+    };
+    const scan = (root) => {
+        for (const element of root.querySelectorAll(`${PARTS}, [${PRESS_ATTRIBUTE}], [${TYPE_ATTRIBUTE}], [${SAY_ATTRIBUTE}], iframe`)) {
+            if (!seen(element))
+                continue;
+            // A frame of the site's own is read in its place, as a page is: what its page marks.
+            if (element.tagName === "IFRAME") {
+                const page = pageOf(element);
+                if (page !== null)
+                    rootsOf(page).forEach(scan);
+                continue;
+            }
+            if (element.hasAttribute(TYPE_ATTRIBUTE)) {
+                pending = { field: element, text: element.getAttribute(TYPE_ATTRIBUTE) ?? "" };
+                continue;
+            }
+            if (element.hasAttribute(PRESS_ATTRIBUTE)) {
+                const goal = element.getAttribute(GOAL_ATTRIBUTE);
+                // Its line is said pointing at the field typed in meanwhile; a chat's, at the chat itself; a call's (an output
+                // the agent is heard in), at the button that opens it; else at the button.
+                const shown = pending?.field ?? (goal && !outputOf(element).hasAttribute(HEARD_ATTRIBUTE) ? (frameOf(element.ownerDocument) ?? outputOf(element)) : element);
+                const said = line(element.getAttribute(PRESS_ATTRIBUTE) ?? "", shown);
+                if (pending !== null) {
+                    // Typed as the line is said; with no line to say, typed on its own.
+                    if (said[0] !== undefined)
+                        typed.set(said[0], pending);
+                    else {
+                        steps.push({ fill: labelOf(pending.field), with: pending.text });
+                        at.push(pending.field);
+                    }
+                    pending = null;
+                }
+                const press = { press: labelOf(element) };
+                steps.push(press);
+                at.push(element);
+                // A button with a goal: the dot talks to what it sends to when it reaches it (`ReadAloud`); nothing is said of it before.
+                if (goal !== null && goal !== "") {
+                    goals.set(press, goal);
+                    continue;
+                }
+                const output = outputOf(element);
+                line(element.getAttribute(THEN_ATTRIBUTE) ?? "", output, { output, find: null });
+                // Each note on the output, said pointing at the line it finds; one that finds none is left out as it is reached.
+                const notes = element.getAttribute(NOTES_ATTRIBUTE);
+                for (const note of (notes === null ? null : document.getElementById(notes))?.children ?? []) {
+                    const find = note.getAttribute(FIND_ATTRIBUTE);
+                    if (find !== null && find !== "")
+                        line(note.textContent ?? "", output, { output, find });
+                }
+                continue;
+            }
+            // Inside a part said as its own line, nothing is read again; quiet, nothing at all.
+            const told = element.parentElement?.closest(`[${SAY_ATTRIBUTE}]`) ?? null;
+            if ((told !== null && root.contains(told)) || element.closest(`[${QUIET_ATTRIBUTE}]`) !== null)
+                continue;
+            // A chat's turns (a tool's line among them) are read as the dot talks to it, not as the page.
+            if (element.closest(`[${SAID_ATTRIBUTE}]`) !== null)
+                continue;
+            if (element.hasAttribute(SAY_ATTRIBUTE)) {
+                line(element.getAttribute(SAY_ATTRIBUTE) ?? "", element);
+                continue;
+            }
+            // A part inside another part of the same container is read with it.
+            const holder = element.parentElement?.closest(PARTS) ?? null;
+            if ((holder !== null && root.contains(holder)) || read.has(element))
+                continue;
+            const together = card(element, root);
+            if (together !== null)
+                read.add(together.words);
+            line(together?.text ?? wordsOf(element), together?.box ?? element);
+        }
+    };
+    rootsOf(document).forEach(scan);
+    return steps.length === 0 ? null : { walk: { name: READ_WALK, title, steps }, at, outputs, goals, typed, spoken };
+}
+/** How far above what is seen a part may start and still be where the reading begins, in px. */
+const JUST_ABOVE = 8;
+/** The reading from where the page is scrolled to: from its first part not above what is seen; whole when that is its first. */
+export function fromHere(reading) {
+    const first = reading.at.findIndex((element) => boxOf(element).bottom > seenOf(element).top + JUST_ABOVE);
+    if (first <= 0)
+        return reading;
+    return { ...reading, walk: { ...reading.walk, steps: reading.walk.steps.slice(first) }, at: reading.at.slice(first), outputs: reading.outputs.slice(first) };
+}
+/** The name a step calls an example by: its label, its placeholder, its words. */
+export const labelOf = (element) => element.getAttribute("aria-label") ?? element.getAttribute("placeholder") ?? wordsOf(element) ?? "field";
+/** An example's output: what it controls (`aria-controls`), else itself. */
+export function outputOf(element) {
+    const controls = element.getAttribute("aria-controls");
+    return (controls === null ? null : element.ownerDocument.getElementById(controls)) ?? element;
+}
+/** The language an output's page is in, for the door; none when the page does not say. */
+export const languageOf = (element) => element.ownerDocument.documentElement.lang || undefined;
+//# sourceMappingURL=reading.js.map

package/dist/tutor/reading.js.map

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

package/dist/tutor/text.d.ts

@@ -0,0 +1,16 @@
+/** A page's text as a person reads it: the words of an element, an output line by line, the line a note finds, and a text cut into recordings. */
+/** Under it nothing is read (code, a legend), though an example marked to press or type there is still done. */
+export declare const QUIET_ATTRIBUTE = "data-pinecall-quiet";
+/** The nearest box of `element`, within `within`, that is a line of its own: not a run of words (a span, a code) inside one. */
+export declare function blockOf(element: Element, within: Element): Element;
+/** What an output shows, line by line: each box of its own on a line, the words inside it as written. Hidden parts left out. */
+export declare function textOf(output: Element): string;
+/** The line of `output` that holds `find`, a text in any case and spacing or `/a regex/flags`: the innermost box that holds it; null when none does. */
+export declare function lineIn(output: Element, find: string): Element | null;
+/** Whether a person sees `element`: not hidden, not left out for the tutor. */
+export declare function seen(element: Element): boolean;
+/** The words a person reads out of `element`, on one line: its text, without what is quiet or hidden inside it. */
+export declare function wordsOf(element: Element): string;
+/** A text as it is recorded: whole when it fits, else a few sentences at a time, `longest` characters at most each. */
+export declare function piecesOf(text: string, longest?: number): string[];
+//# sourceMappingURL=text.d.ts.map

package/dist/tutor/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/tutor/text.ts"],"names":[],"mappings":"AAAA,kJAAkJ;AAIlJ,gHAAgH;AAChH,eAAO,MAAM,eAAe,wBAAwB,CAAC;AAMrD,gIAAgI;AAChI,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAQlE;AAED,gIAAgI;AAChI,wBAAgB,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAuB9C;AAKD,wJAAwJ;AACxJ,wBAAgB,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAcpE;AAED,+EAA+E;AAC/E,wBAAgB,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAI9C;AAED,mHAAmH;AACnH,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAUhD;AAED,uHAAuH;AACvH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,SAAU,GAAG,MAAM,EAAE,CAalE"}

package/dist/tutor/text.js

@@ -0,0 +1,119 @@
+/** A page's text as a person reads it: the words of an element, an output line by line, the line a note finds, and a text cut into recordings. */
+import { isElement } from "../pointer/frames.js";
+/** Under it nothing is read (code, a legend), though an example marked to press or type there is still done. */
+export const QUIET_ATTRIBUTE = "data-pinecall-quiet";
+/** The most characters one recording takes: a few sentences. */
+const LONGEST = 480;
+const INLINE = new Set(["SPAN", "CODE", "B", "I", "EM", "STRONG", "A", "SMALL", "KBD", "U", "S", "MARK", "TIME", "SUB", "SUP", "ABBR"]);
+/** The nearest box of `element`, within `within`, that is a line of its own: not a run of words (a span, a code) inside one. */
+export function blockOf(element, within) {
+    let node = element;
+    while (node !== within && node.parentElement !== null) {
+        const display = node.ownerDocument.defaultView?.getComputedStyle(node).display ?? "";
+        if (!INLINE.has(node.tagName) && !display.startsWith("inline") && display !== "contents")
+            return node;
+        node = node.parentElement;
+    }
+    return node;
+}
+/** What an output shows, line by line: each box of its own on a line, the words inside it as written. Hidden parts left out. */
+export function textOf(output) {
+    const lines = [];
+    const walk = (node, line) => {
+        for (const child of node.childNodes) {
+            // By node type, not `instanceof`: a frame's nodes are of the frame's window.
+            if (child.nodeType === 3)
+                line.push(child.textContent ?? "");
+            else if (isElement(child) && seen(child) && !child.matches("script, style, template")) {
+                // A span laid out as a block (a cell of a row) is a line of its own; one in a run of words is not.
+                const display = child.ownerDocument.defaultView?.getComputedStyle(child).display ?? "";
+                const inline = display === "" ? INLINE.has(child.tagName) : display.startsWith("inline");
+                if (inline)
+                    walk(child, line);
+                else {
+                    const own = [];
+                    walk(child, own);
+                    lines.push(own.join("").replace(/\s+/g, " ").trim());
+                }
+            }
+        }
+    };
+    const top = [];
+    walk(output, top);
+    const first = top.join("").replace(/\s+/g, " ").trim();
+    return [first, ...lines].filter((line) => line !== "").join("\n");
+}
+/** A text as two are compared for a note: one space between words, in lower case. */
+const flat = (text) => text.replace(/\s+/g, " ").trim().toLowerCase();
+/** The line of `output` that holds `find`, a text in any case and spacing or `/a regex/flags`: the innermost box that holds it; null when none does. */
+export function lineIn(output, find) {
+    const expr = /^\/(.+)\/([a-z]*)$/.exec(find);
+    let matches;
+    try {
+        const regex = expr === null ? null : new RegExp(expr[1] ?? "", (expr[2] ?? "").replace("g", ""));
+        const wanted = flat(find);
+        matches = regex === null ? (text) => flat(text).includes(wanted) : (text) => regex.test(text);
+    }
+    catch {
+        return null;
+    }
+    const holding = [...output.querySelectorAll("*")].filter((element) => matches(element.textContent ?? ""));
+    const innermost = holding.find((element) => !holding.some((other) => other !== element && element.contains(other)));
+    if (innermost === undefined)
+        return matches(output.textContent ?? "") ? output : null;
+    return blockOf(innermost, output);
+}
+/** Whether a person sees `element`: not hidden, not left out for the tutor. */
+export function seen(element) {
+    if (element.closest("[hidden], [aria-hidden='true'], [data-pinecall-skip]") !== null)
+        return false;
+    const style = element.ownerDocument.defaultView?.getComputedStyle(element);
+    return style === undefined || (style.display !== "none" && style.visibility !== "hidden");
+}
+/** The words a person reads out of `element`, on one line: its text, without what is quiet or hidden inside it. */
+export function wordsOf(element) {
+    const document = element.ownerDocument;
+    const walker = document.createTreeWalker(element, NodeFilter.SHOW_TEXT);
+    let text = "";
+    for (let node = walker.nextNode(); node !== null; node = walker.nextNode()) {
+        const parent = node.parentElement;
+        if (parent === null || parent.closest(`[${QUIET_ATTRIBUTE}]`) !== null || !seen(parent) || parent.matches("script, style, template"))
+            continue;
+        text += node.textContent ?? "";
+    }
+    return text.replace(/\s+/g, " ").trim();
+}
+/** A text as it is recorded: whole when it fits, else a few sentences at a time, `longest` characters at most each. */
+export function piecesOf(text, longest = LONGEST) {
+    if (text.length <= longest)
+        return text === "" ? [] : [text];
+    const sentences = text.split(/(?<=[.!?…:;])\s+/);
+    const pieces = [];
+    let piece = "";
+    for (const sentence of sentences.flatMap((one) => (one.length <= longest ? [one] : cut(one, longest)))) {
+        if (piece !== "" && piece.length + 1 + sentence.length > longest) {
+            pieces.push(piece);
+            piece = sentence;
+        }
+        else
+            piece = piece === "" ? sentence : `${piece} ${sentence}`;
+    }
+    if (piece !== "")
+        pieces.push(piece);
+    return pieces;
+}
+/** A sentence longer than a recording, cut between its words. */
+function cut(sentence, longest) {
+    const pieces = [];
+    let piece = "";
+    for (const word of sentence.split(" ")) {
+        if (piece !== "" && piece.length + 1 + word.length > longest) {
+            pieces.push(piece);
+            piece = word;
+        }
+        else
+            piece = piece === "" ? word : `${piece} ${word}`;
+    }
+    return piece === "" ? pieces : [...pieces, piece];
+}
+//# sourceMappingURL=text.js.map

package/dist/tutor/text.js.map

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

package/dist/tutor/tutor.d.ts

@@ -1,14 +1,7 @@
 /** The tutor on a page: the person with its pointer and face, what it sends of the page, and every move the agent asks for. */
 import { type RoomStore } from "@pinecall/room";
-import type { TutorOptions } from "./options.js";
-export type { TutorOptions } from "./options.js";
-export interface Tutor {
-    /** A message the agent sent on `pinecall.ui`: true when it was the tutor's to carry out, false for a card or choices. */
-    take(data: unknown): boolean;
-    /** Let the face hear the voice: call it from the click that starts the call. */
-    wake(): void;
-    close(): void;
-}
+import type { Tutor, TutorOptions } from "./options.js";
+export type { Tutor, TutorOptions } from "./options.js";
 /** Put the tutor on the page, moving with `call`. Nothing is sent until the call is live. */
 export declare function tutor(call: RoomStore, options?: TutorOptions): Tutor;
 //# sourceMappingURL=tutor.d.ts.map

package/dist/tutor/tutor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tutor.d.ts","sourceRoot":"","sources":["../../src/tutor/tutor.ts"],"names":[],"mappings":"AAAA,+HAA+H;AAS/H,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAYjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAIjD,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,WAAW,KAAK;IACpB,yHAAyH;IACzH,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IAC7B,gFAAgF;IAChF,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,IAAI,IAAI,CAAC;CACf;AAKD,6FAA6F;AAC7F,wBAAgB,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,YAAiB,GAAG,KAAK,CAgVxE"}
+{"version":3,"file":"tutor.d.ts","sourceRoot":"","sources":["../../src/tutor/tutor.ts"],"names":[],"mappings":"AAAA,+HAA+H;AAU/H,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAiBjE,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAIxD,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AASxD,6FAA6F;AAC7F,wBAAgB,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,GAAE,YAAiB,GAAG,KAAK,CA+VxE"}