@pinecall/dot 0.11.23 → 0.11.25

package/dist/wire/index.js

@@ -3,6 +3,8 @@
 // Both ride what a call already has. The page's facts go up as events (`call.event(name, data)`,
 // the agent's `onEvent`); the agent's moves come down on `pinecall.ui`, beside its cards and
 // choices, told apart by `type`.
+import { actOf, guardsOf, isAct, paramsOf, slotsOf } from "./acts.js";
+export * from "./acts.js";
 /** The topic the agent sends on, and the page's `onUi` hears. */
 export const UI = "pinecall.ui";
 /**
@@ -24,12 +26,32 @@ export const WALKED = "page.walked";
 /** The name the agent publishes its recorded walks under, which the page reads with no key. */
 export const WALKS = "walks";
 /**
- * What the pointer can do. `type` fills a field with what the visitor said: it never submits a form,
- * clicks, or leaves the page for them, and never touches a password or a card.
+ * What the pointer can do. `type` fills a field with what the visitor said, and never touches a password
+ * or a card. `press` presses a button a walk names, one outside any form or in a search form: never a
+ * form that sends the visitor's details, and never a page left. `wait` waits for the page to change.
  */
-export const ACTIONS = ["point", "highlight", "unhighlight", "scroll_to", "here", "home", "type"];
+export const ACTIONS = ["point", "highlight", "unhighlight", "scroll_to", "here", "home", "type", "press", "wait"];
+/** The moves a macro's beat cannot make: what types, presses or waits is a step of its own. */
+const NOT_A_BEAT = ["type", "press", "wait"];
 /** A target that is a ref of the snapshot rather than a name. */
 export const A_REF = /^e\d+$/;
+/** A path as a page names it: no trailing slash but the root's. */
+const pathOf = (path) => (path.length > 1 ? path.replace(/\/+$/, "") : path) || "/";
+/**
+ * The name of the document the walks of a page are published under: `walks` for the home, `walks-security`
+ * for `/security`. A document is read by every visitor of its page, so each page has its own: a page asks
+ * only for the walks that are for it. (A document's name is a lower case letter, then letters, digits and dashes, 40 at most.)
+ */
+export function walksDocument(path) {
+    const slug = pathOf(path).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+    return slug === "" ? "walks" : `walks-${slug}`.slice(0, 40).replace(/-+$/, "");
+}
+/** Whether a walk for `pages` is for the page at `path`: any walk is, with no pages named; a path unknown is any page. */
+export function onPage(pages, path) {
+    if (pages === undefined || pages.length === 0 || path === "")
+        return true;
+    return pages.some((page) => pathOf(page) === pathOf(path));
+}
 /** What a step shows, checked; null for one that is not: a window with no title or text, lines out of order. */
 export function shownOf(fields) {
     const { code, lines } = fields;
@@ -65,7 +87,7 @@ function isBeat(value) {
     const nth = beat["nth"];
     // A beat has no words to type: a macro shows, and the agent fills a field only with what the visitor said.
     const move = beat["do"];
-    return typeof beat["word"] === "string" && isAction(move) && move !== "type" && found && (nth === undefined || (typeof nth === "number" && nth >= 1));
+    return typeof beat["word"] === "string" && isAction(move) && !NOT_A_BEAT.includes(move) && found && (nth === undefined || (typeof nth === "number" && nth >= 1));
 }
 /** A message on `pinecall.ui` the tutor carries out, or null for one that is not its own (a card, choices). */
 export function tutoring(data) {
@@ -77,10 +99,15 @@ export function tutoring(data) {
     if (message["type"] === "macro.done" && typeof message["macro"] === "string")
         return { type: "macro.done", macro: message["macro"] };
     const action = message["action"];
+    const ms = message["ms"];
     if (message["type"] === "cursor" && isAction(action) && optionalText(message["target"]) && optionalText(message["text"])) {
         if (action === "type" && (message["target"] === undefined || message["text"] === undefined))
             return null;
-        return { type: "cursor", action, target: message["target"], text: message["text"] };
+        if ((action === "press" || action === "wait") && message["target"] === undefined)
+            return null;
+        if (ms !== undefined && (typeof ms !== "number" || ms <= 0))
+            return null;
+        return { type: "cursor", action, target: message["target"], text: message["text"], ...(ms === undefined ? {} : { ms }) };
     }
     const beats = message["beats"];
     if (message["type"] === "macro.step" &&
@@ -123,13 +150,24 @@ function stepOf(value) {
     if (typeof value !== "object" || value === null)
         return null;
     const step = { ...value };
+    const guards = guardsOf(step);
+    if (guards === null)
+        return null;
+    if (isAct(step)) {
+        const act = actOf(step);
+        return act === null ? null : { ...act, ...guards };
+    }
     const { say, audio, durationMs, words, beats } = step;
-    if (typeof say !== "string" || typeof audio !== "string" || !/^https?:\/\//.test(audio) || typeof durationMs !== "number")
+    const shown = shownOf(step);
+    if (typeof say !== "string" || !Array.isArray(beats) || !beats.every(isBeat) || shown === null)
         return null;
-    if (!Array.isArray(words) || !words.every(isWord) || !Array.isArray(beats) || !beats.every(isBeat))
+    if (step["live"] === true)
+        return { say, beats, live: true, ...shown, ...guards };
+    if (typeof audio !== "string" || !/^https?:\/\//.test(audio) || typeof durationMs !== "number")
         return null;
-    const shown = shownOf(step);
-    return shown === null ? null : { say, audio, durationMs, words, beats, ...shown };
+    if (!Array.isArray(words) || !words.every(isWord))
+        return null;
+    return { say, audio, durationMs, words, beats, ...shown, ...guards };
 }
 /** The walks a published document holds, each checked: a walk with any step that is not one is left out. */
 export function walksOf(value) {
@@ -143,13 +181,17 @@ export function walksOf(value) {
         if (typeof item !== "object" || item === null)
             return [];
         const walk = { ...item };
-        const { name, title, when, steps } = walk;
+        const { name, title, when, steps, pages } = walk;
         if (typeof name !== "string" || typeof title !== "string" || !Array.isArray(steps) || steps.length === 0)
             return [];
         const checked = steps.map(stepOf);
         if (checked.some((step) => step === null))
             return [];
-        return [{ name, title, when: typeof when === "string" ? when : undefined, steps: checked.filter((step) => step !== null) }];
+        const params = walk["params"] === undefined ? undefined : paramsOf(walk["params"]);
+        if (params === null)
+            return [];
+        const paths = Array.isArray(pages) && pages.every((page) => typeof page === "string") ? pages : undefined;
+        return [{ name, title, when: typeof when === "string" ? when : undefined, pages: paths, ...(params === undefined ? {} : { params }), steps: checked.filter((step) => step !== null) }];
     });
 }
 /** A macro as its JSON file says it, checked; it throws naming what is wrong, at the class's load. */
@@ -160,10 +202,33 @@ export function macroOf(name, value) {
     const steps = macro["steps"];
     if (!Array.isArray(steps) || steps.length === 0)
         throw new Error(`macro ${name}: no steps`);
+    const params = macro["params"] === undefined ? {} : paramsOf(macro["params"]);
+    if (params === null)
+        throw new Error(`macro ${name}: params are {"<name>": {"about": "...", "one_of"?: {"<option>": "..."}}}`);
+    // A slot is a param, or a row an earlier step read: `{name}`, `{hit.Time}`.
+    const known = new Set(Object.keys(params));
+    const slotted = (at, text) => {
+        const unknown = slotsOf(text).find((slot) => !known.has(slot.split(".")[0] ?? ""));
+        if (unknown !== undefined)
+            throw new Error(`macro ${name}: step ${at + 1} fills {${unknown}}, which is no param and no row read before it`);
+    };
     const checked = steps.map((step, at) => {
         if (typeof step !== "object" || step === null)
             throw new Error(`macro ${name}: step ${at + 1} is not an object`);
         const fields = { ...step };
+        const guards = guardsOf(fields);
+        if (guards === null)
+            throw new Error(`macro ${name}: step ${at + 1} has an if or unless that is not a slot's name`);
+        if (isAct(fields)) {
+            const act = actOf(fields);
+            if (act === null)
+                throw new Error(`macro ${name}: step ${at + 1} is not {fill, with}, {press}, {wait, ms?} or {read, as, row?}`);
+            if ("fill" in act)
+                slotted(at, act.with);
+            if ("read" in act)
+                known.add(act.as);
+            return { ...act, ...guards };
+        }
         const say = fields["say"];
         const beats = fields["beats"] ?? [];
         if (typeof say !== "string" || say.trim() === "")
@@ -173,18 +238,27 @@ export function macroOf(name, value) {
         for (const beat of beats) {
             if (!wordsOf(say).some((word) => word === normal(beat.word)))
                 throw new Error(`macro ${name}: step ${at + 1} never says "${beat.word}"`);
+            if (beat.find !== undefined)
+                slotted(at, beat.find[1]);
         }
+        slotted(at, say);
         const shown = shownOf(fields);
         if (shown === null)
             throw new Error(`macro ${name}: step ${at + 1} shows code that is not {code: {title, text} or null, lines: [from, to]}`);
-        return { say, beats, ...shown };
+        return { say, beats, ...shown, ...guards };
     });
     const when = macro["when"];
     const title = macro["title"];
+    const pages = macro["pages"];
+    if (pages !== undefined && !(Array.isArray(pages) && pages.every((page) => typeof page === "string" && page.startsWith("/")))) {
+        throw new Error(`macro ${name}: pages are paths that begin with a slash, as ["/security"]`);
+    }
     return {
         name: typeof macro["name"] === "string" ? macro["name"] : name,
         title: typeof title === "string" ? title : undefined,
         when: typeof when === "string" ? when : undefined,
+        pages: pages === undefined ? undefined : pages,
+        ...(Object.keys(params).length === 0 ? {} : { params }),
         steps: checked,
     };
 }

package/dist/wire/index.js.map

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

package/docs/macros.md

@@ -0,0 +1,216 @@
+# Macros
+
+> **Experimental.** `@pinecall/dot` may change in any release. This page is true of the version it ships with.
+
+A macro is a guided walk, a JSON file in the agent's folder (`macros/<name>.json`). The agent says
+each step as written; the page runs each step's moves as their words are said. The same file is
+what a visitor plays with no call (a *walk*, recorded in the agent's voice). [Write a tutor
+agent](write-a-tutor.md) shows where it goes; this page is the format.
+
+```json
+{
+  "name": "plans",
+  "title": "Plans and prices",
+  "when": "the visitor asks what it costs, or which plan to choose",
+  "steps": [
+    {
+      "say": "Here are our three plans: one monthly price instead of a surprise bill.",
+      "beats": [
+        { "word": "Here", "do": "scroll_to", "find": ["region", "Pricing"] },
+        { "word": "three", "do": "highlight", "find": ["region", "Pricing"] }
+      ]
+    },
+    {
+      "say": "Family Care is the one most families pick.",
+      "beats": [
+        { "word": "Family", "do": "highlight", "find": ["article", "Family Care plan"] },
+        { "word": "pick", "do": "point", "find": ["article", "Family Care plan"] }
+      ]
+    }
+  ]
+}
+```
+
+## The file
+
+| field | |
+|---|---|
+| `name` | what the model names it in `runMacro`. The key it is given in `macros({ plans })` when left out |
+| `title` | the visitor's button: "Plans and prices". `name` when left out |
+| `when` | when to run it, in the words the model reads: "the visitor asks what it costs" |
+| `pages` | the paths of the pages it is for: `["/security"]`. Left out, it is for every page. See below |
+| `steps` | at least one |
+
+A step:
+
+| field | |
+|---|---|
+| `say` | the sentence, said exactly as written |
+| `beats` | the moves hung on its words; may be empty |
+| `code` | `{ "title": "agent.ts", "text": "…" }` opens a window of code beside the page; `null` closes it. A step that names none leaves the window as it is |
+| `lines` | `[from, to]`, from 1: lights those lines of the window and dims the rest, and the pointer goes to them |
+
+A beat:
+
+| field | |
+|---|---|
+| `word` | the word of `say` it runs on. Case and punctuation do not count: `"Whitening,"` is `whitening` |
+| `do` | the move, below |
+| `find` | `[role, name]`: the element, as the page's snapshot names it. Needed by every move but `unhighlight`, `here` and `home` |
+| `nth` | which time the word is said in the step, from 1 (the first by default), for a word that repeats |
+
+## The moves
+
+| `do` | |
+|---|---|
+| `point` | the pointer flies to the element, the face beside it, and rests under its first words. Scrolls first if it is off the screen |
+| `highlight` | dims the rest of the page and lights the element, following it as the page scrolls |
+| `unhighlight` | takes the light away |
+| `scroll_to` | scrolls the page, eased, until the element sits in the upper middle of the screen, below the site's own header (a fixed or sticky bar along the top, or the page's `scroll-padding-top`). A thing that fits is shown whole; a section taller than the screen shows from its start, just under the header |
+| `here` | a ring at the pointer, twice |
+| `home` | the pointer goes back to its corner |
+
+A beat never types or presses: a walk shows, a step of its own acts, and the agent writes into a field
+only what the visitor said.
+
+## A macro as a function
+
+A macro can take params, and act on the page between its sentences. It is then a function the visitor
+calls by asking: in a call the model passes the params to `runMacro`; typed to the dot, the site's door
+picks them out of what was typed.
+
+```json
+{
+  "name": "times",
+  "title": "Find a time",
+  "when": "the visitor wants an open time: for a treatment, with a dentist, or on a day",
+  "params": { "what": { "about": "the treatment, the dentist or the day they want a time for" } },
+  "steps": [
+    { "say": "Let me look for {what}.", "beats": [] },
+    { "fill": "Treatment or dentist", "with": "{what}" },
+    { "press": "Search times" },
+    { "wait": "Open times", "ms": 6000 },
+    { "read": "Open times", "as": "hit", "row": "best" },
+    { "if": "hit", "say": "The best fit is {hit.Day} at {hit.Time}.", "beats": [{ "word": "best", "do": "highlight", "find": ["row", "{hit}"] }] },
+    { "unless": "hit", "say": "I found no open times for {what}.", "beats": [] }
+  ]
+}
+```
+
+| | |
+|---|---|
+| `params` | `{ "<name>": { "about": "…" } }`: the visitor's own words, one to five of them in a row (a name, a phone, an email, what to search). With `"one_of": { "<option>": "…" }`, one of those options |
+| `{slot}` | in `say`, in what `fill` types and in what a beat's `find` names: a param, or a row read before it (`{hit}` the row, `{hit.Time}` its cell under the header "Time") |
+| `fill` | types `with`, filled, into the field the screen names so. Never a password, a card, a file or a hidden field |
+| `press` | presses the button the screen names so: one outside any form, or in a search form (`<search>`, `role="search"`). Never a link, never a form that books, buys or signs up. Its name is the site's: no slot |
+| `wait` | waits for the thing it names to change, stay still a moment and not be `aria-busy`: a search answered and drawn. `ms` at most (8000 when not said, 20000 the most) |
+| `read` | reads the table the screen names so (a `<table>`, or the section that holds one): each row by its header's words. `row` is `first` (the default) or `best`, the one that answers what the visitor typed |
+| `if`, `unless` | keep the step only when a slot has a value, or has none |
+
+A step with a slot nothing filled is left out, so a walk asked for without a param says the rest.
+
+**In a call** the sentences are said with their slots filled, and the acts sent to the page one at a
+time, each answered once it ended. A `read` ends the walk's own words: what the table shows is handed
+to the model, which answers the visitor in its own words and can light the row it talks about.
+
+**With no call** the page does the acts between the sentences. A sentence with slots cannot be recorded
+before the visitor says what fills them: `pinecall start` publishes it as a live step, and the page asks
+the site's door to record it when it is reached, with its values. The door reads the sentence from the
+walks the agent published, never from the page, and the gateway keeps each recording: the same
+sentence with the same values costs nothing the second time. A walk with params is not in the menu: it
+is asked for. A site's search that says it is busy while it asks (`aria-busy="true"` on its table) is
+waited on to the end.
+
+## Walks for some pages
+
+A site with several pages usually has a walk for each, and a visitor on `/security` should not be
+offered the tour of the home. Name the pages in the file:
+
+```json
+{ "name": "keys", "title": "Where your keys live", "pages": ["/security"], "steps": [ … ] }
+```
+
+- **The menu** lists only the walks for the page the visitor is on (a trailing slash does not
+  matter: `/security` and `/security/` are one page).
+- **A call** is the same: the page tells the agent its path, and the agent offers and runs only
+  the walks for it. A walk that names no page is for all of them, so name the home's
+  walks too (`"pages": ["/"]`) if they are only for the home.
+- **Each page has its own published document**, so a visitor downloads only the walks for the page
+  they are on: `walks` for the home (with the walks that name no page), `walks-security` for `/security`,
+  `walks-developers-sdk` for `/developers/sdk`. The page reads its own and, where the agent published none
+  for it, `walks`. A document is 64 KiB at most; a page with a great many walks can pass it, and is split
+  by naming the pages.
+- **A page that never said its path** (an older page) is offered every walk.
+- A path is exact: `/developers` is not `/developers/sdk`. List both.
+
+## Naming elements: `find`
+
+`find` is `[role, name]`: the first element of that role whose name *contains* the text (case does
+not matter). Roles and names are the accessibility tree's, not the markup's:
+
+| role | what it is | its name |
+|---|---|---|
+| `region` | a `<section>` with `aria-label` or `aria-labelledby` | that label |
+| `heading` | `<h1>`–`<h6>` | its text |
+| `article` | `<article>` | its `aria-label` |
+| `button`, `link`, `tab` | a `<button>` or `summary`, an `<a href>`, `role="tab"` | its text or `aria-label` |
+| `group` | `role="group"`, or `<details>` | its `aria-label` |
+| `textbox`, `combobox`, `checkbox`, `radio` | fields | their label |
+| `img` | `<img>`, `<figure>` | its `alt` |
+| `form` | `<form>` | its `aria-label` |
+
+Three habits keep a walk alive:
+
+1. **Name the parts you point at.** A plain `<div>` has no name, so a macro cannot find it: give
+   it `role="group"` and an `aria-label`, or point at its heading instead. This is the whole
+   reason a beat "does nothing".
+2. **Use a part of the name, not the whole.** `["region", "Pricing"]` finds "Pricing, three plans"
+   too; a label you reword later still matches.
+3. **A beat that finds nothing is skipped**, quietly, in a walk and in a call. The walk goes on, so a
+   renamed section loses a move, not the walk.
+
+## Writing sentences that play well
+
+The sentence is read aloud by the agent's voice, and a walk is recorded once in it.
+
+- **Short sentences, one idea each.** The visitor can stop at any step, and the agent is told how far
+  they got.
+- **Put the beat on the word that names the thing**, not before it: `"Family"` for "Family Care is
+  the one most families pick", so the pointer arrives as the name is said. Avoid a word that is also
+  said earlier in the sentence unless you mean it, or give `nth`.
+- **Light, then point, then let go.** `highlight` on the first word, `point` a few words later,
+  `unhighlight` before you move to a part of the page the light is not on.
+- **Move the light before the page moves.** A step that goes to another section lights it first, on
+  the same word as the scroll (`highlight`, then `scroll_to`, both on that word): the light then comes
+  in with the section. A light left on a section the page scrolls away from dims the whole screen.
+- **Write numbers and symbols as you would say them**: "nineteen dollars a month", not "$19/mo".
+- **Check it with your ears.** `pinecall walks play plans` plays the recorded walk in the terminal;
+  a sentence cut short or a name said strangely is a lexicon entry (`pinecall lexicon`), after which
+  that sentence is recorded again.
+
+## What is checked, and when
+
+`macros({ … })` checks every file when the agent's class loads, and refuses one that is not a JSON
+object, has no steps, a step that says nothing, a beat that is not `{ word, do, find?, nth? }` or
+uses `type`, `press` or `wait`, a word its sentence never says, `code`/`lines` of the wrong shape, a
+param that is not `{ about, one_of? }`, an act that is not one of the four, or a slot that is no param
+and no row read before it. The message names the macro and the step:
+
+```
+macro plans: step 2 never says "Familia"
+```
+
+What it cannot check is the page: whether `find` names something that exists. That is found by
+running it.
+
+## How the agent runs one
+
+In a call, `runMacro("plans")` sends each step to the page and then says it. The model names a walk
+the way it heard it: `runMacro("site tour")` runs `tour` (every word of a macro's name is in what was
+asked), and an agent with a single macro runs it whatever it is called. The page binds the step to the reply that
+follows and runs each beat as its word is said, by the voice's own timings. When the visitor speaks,
+the walk stops and the agent answers them; the result tells it how far it got.
+
+With no call, the page plays the recorded sentence and runs the same beats on the audio's clock,
+the words lit as they are said. A call opened after a walk played is told which one and how far, so
+the agent goes on from there instead of saying it again.