@pinecall/dot 0.11.24 → 0.11.26

package/dist/wire/acts.js

@@ -0,0 +1,120 @@
+/** A macro as a function: the params it takes, the steps that act on the page (fill, press, wait, read), and the `{slots}` its words are filled from. */
+//
+// A walk that takes params is called with them: in a call the agent's model passes them, with no call
+// the site's server picks them out of what the visitor typed (`@pinecall/dot/server`). A param is the
+// visitor's own words (a name, a phone, what to search for) or one option of a list. Its value fills
+// the `{name}` slots of the walk's sentences and of what a step types, and `read` adds the cells of a
+// row of a table the page shows (`{hit.Time}`). A step with a slot nothing filled is left out, so a
+// walk said without a param says the rest; `if` and `unless` keep a step for a value there, or not.
+/** The longest a wait may be, in ms. */
+export const LONGEST_WAIT = 20_000;
+/** The longest a value may be: a name, a phone, a cell. */
+export const LONGEST_VALUE = 80;
+const SLOT = /\{([A-Za-z_][\w]*(?:\.[^{}\n]+)?)\}/g;
+/** The slots a text names, in order: `{name}`, `{hit.Time}`. */
+export function slotsOf(text) {
+    return [...text.matchAll(SLOT)].map((found) => found[1] ?? "");
+}
+/** `text` with its slots filled; null when one has no value. */
+export function filled(text, values) {
+    let missing = false;
+    const out = text.replace(SLOT, (_, slot) => {
+        const value = values[slot];
+        if (value === undefined || value === "")
+            missing = true;
+        return value ?? "";
+    });
+    return missing ? null : out;
+}
+/** Whether a step is taken, with these values. */
+export function taken(step, values) {
+    const has = (slot) => (values[slot] ?? "") !== "";
+    return (step.if === undefined || has(step.if)) && (step.unless === undefined || !has(step.unless));
+}
+/** A value as it may fill a slot: one line, cut. */
+export function valueOf(text) {
+    return text.replace(/\s+/g, " ").trim().slice(0, LONGEST_VALUE);
+}
+/** Whether a step is an act rather than a sentence. */
+export function isAct(step) {
+    return "fill" in step || "press" in step || "wait" in step || "read" in step;
+}
+const text = (value) => typeof value === "string" && value.trim() !== "";
+/** An act as a file or a document says it, checked; null for one that is not. */
+export function actOf(fields) {
+    if ("fill" in fields)
+        return text(fields["fill"]) && text(fields["with"]) ? { fill: fields["fill"], with: fields["with"] } : null;
+    if ("press" in fields)
+        return text(fields["press"]) && slotsOf(fields["press"]).length === 0 ? { press: fields["press"] } : null;
+    if ("wait" in fields) {
+        const ms = fields["ms"];
+        if (!text(fields["wait"]) || (ms !== undefined && (typeof ms !== "number" || ms <= 0 || ms > LONGEST_WAIT)))
+            return null;
+        return { wait: fields["wait"], ...(ms === undefined ? {} : { ms }) };
+    }
+    if ("read" in fields) {
+        const row = fields["row"];
+        if (!text(fields["read"]) || !text(fields["as"]) || !/^[A-Za-z_]\w*$/.test(fields["as"]))
+            return null;
+        if (row !== undefined && row !== "first" && row !== "best")
+            return null;
+        return { read: fields["read"], as: fields["as"], ...(row === undefined ? {} : { row }) };
+    }
+    return null;
+}
+/** A step's guards, checked; null when one is not a slot's name. */
+export function guardsOf(fields) {
+    const guards = {};
+    for (const key of ["if", "unless"]) {
+        const slot = fields[key];
+        if (slot === undefined)
+            continue;
+        if (typeof slot !== "string" || slot === "")
+            return null;
+        guards[key] = slot;
+    }
+    return guards;
+}
+/** A walk's params, as its file or document says them (`one_of` for the options), checked; null for any that is not one. */
+export function paramsOf(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return null;
+    const params = {};
+    for (const [name, declared] of Object.entries(value)) {
+        if (!/^[A-Za-z_]\w*$/.test(name) || typeof declared !== "object" || declared === null)
+            return null;
+        const fields = { ...declared };
+        const about = fields["about"];
+        const options = fields["one_of"] ?? fields["oneOf"];
+        if (!text(about))
+            return null;
+        if (options === undefined) {
+            params[name] = { about };
+            continue;
+        }
+        if (typeof options !== "object" || options === null || Array.isArray(options))
+            return null;
+        const entries = Object.entries(options);
+        if (entries.length === 0 || !entries.every(([, said]) => typeof said === "string"))
+            return null;
+        params[name] = { about, oneOf: Object.fromEntries(entries) };
+    }
+    return params;
+}
+/** The values a walk is called with, checked against its params: a list's value one of its options, the rest the visitor's words, cut. */
+export function valuesFor(params, given) {
+    const values = {};
+    const wrong = [];
+    for (const [name, value] of Object.entries(given)) {
+        const param = params[name];
+        if (param === undefined || typeof value !== "string" || value.trim() === "")
+            continue;
+        if (param.oneOf !== undefined && !(value in param.oneOf)) {
+            wrong.push(`${name} is one of ${Object.keys(param.oneOf).join(", ")}`);
+            continue;
+        }
+        values[name] = valueOf(value);
+    }
+    return { values, wrong };
+}
+//# sourceMappingURL=acts.js.map

package/dist/wire/acts.js.map

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

package/dist/wire/ask.d.ts

@@ -0,0 +1,132 @@
+/** What the dot asks when the visitor types to it, and the one thing it may be told to do: a walk, a thing shown, the agent, or nothing. */
+import { type Values } from "./acts.js";
+/** What the visitor typed, and the page it was typed on, as the dot sends it to be decided. */
+export interface AskRequest {
+    message: string;
+    /** The path of the page: `/pricing`. */
+    path: string;
+    /** The page as the agent reads it: each thing with its role, its name and its ref. */
+    page: string;
+    /** The walks of this page, and what each takes. */
+    walks: {
+        name: string;
+        title: string;
+        when?: string | undefined;
+        params?: Record<string, {
+            about: string;
+            oneOf?: Record<string, string> | undefined;
+        }> | undefined;
+    }[];
+}
+/** Which row of a table a walk read best answers what the visitor typed: each row as its cells, joined. */
+export interface RowRequest {
+    message: string;
+    rows: string[];
+}
+/** A sentence of a walk with slots, to record now its values are known: the page it is on, the walk, the step, the values. */
+export interface SayRequest {
+    path: string;
+    walk: string;
+    step: number;
+    values: Values;
+}
+/** A text of the page itself to record in the agent's voice: a part of a page read aloud. */
+export interface ReadRequest {
+    text: string;
+}
+/** A command's output a page shows, for the agent's model to explain: notes, each on a line of it. */
+export interface ExplainRequest {
+    output: string;
+    command?: string | undefined;
+    language?: string | undefined;
+}
+/** One turn of a chat the dot talks to, as it was heard: whose, and what was said. */
+export interface Heard {
+    who: "agent" | "caller";
+    said: string;
+}
+/** The dot's next line on a chat it talks to for a goal: the goal, what was said so far, the language. */
+export interface NextRequest {
+    goal: string;
+    heard: Heard[];
+    language?: string | undefined;
+}
+/** The dot's next line, and whether it says goodbye with it. */
+export interface NextLine {
+    say: string;
+    hangup: boolean;
+}
+/** The most turns a talk sends as heard: the gateway's own ceiling. */
+export declare const MOST_HEARD = 80;
+/** A note of an output: a fragment of one of its lines, and what is said of it. */
+export interface Note {
+    find: string;
+    say: string;
+}
+/** What the page asks the site's door: one of the five. */
+export type DoorRequest = {
+    decide: AskRequest;
+} | {
+    row: RowRequest;
+} | {
+    say: SayRequest;
+} | {
+    read: ReadRequest;
+} | {
+    explain: ExplainRequest;
+} | {
+    next: NextRequest;
+};
+/** The site's door's answer to a `row`: the row's index, or null when none answers it. */
+export interface RowAnswer {
+    row: number | null;
+}
+/** The door's answer to a `say`: the sentence as recorded. */
+export interface SaidAnswer {
+    say: string;
+    audio: string;
+    durationMs: number;
+    words: {
+        text: string;
+        startMs: number;
+        endMs: number;
+    }[];
+}
+/** The one thing to do, and how sure the decision is, 0 to 1. */
+export type Decision = {
+    do: "walk";
+    walk: string;
+    params?: Values | undefined;
+    confidence: number;
+} | {
+    do: "show";
+    target: string;
+    confidence: number;
+} | {
+    do: "talk";
+    confidence: number;
+} | {
+    do: "none";
+    confidence: number;
+};
+/** A thing of the page with a name: its ref, its role and its name. */
+export interface Named {
+    ref: string;
+    role: string;
+    name: string;
+}
+/** The things of a page with a name and a ref, in the page's order. */
+export declare function namedIn(page: string): Named[];
+/** A decision as a server answered it, checked; null for anything else. */
+export declare function decisionOf(value: unknown): Decision | null;
+/** The most notes an output is explained with. */
+export declare const MOST_NOTES = 6;
+/** An explanation's notes, checked, the first six; none for anything else. */
+/** The door's answer to `{ next }` read as the dot's next line; null when it gave none. */
+export declare function nextOf(value: unknown): NextLine | null;
+export declare function notesOf(value: unknown): Note[];
+/** A row answer, checked; null for anything else. */
+export declare function rowOf(value: unknown): number | null;
+/** A recorded sentence, checked; null for anything else. */
+export declare function saidOf(value: unknown): SaidAnswer | null;
+//# sourceMappingURL=ask.d.ts.map

package/dist/wire/ask.d.ts.map

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

package/dist/wire/ask.js

@@ -0,0 +1,102 @@
+/** What the dot asks when the visitor types to it, and the one thing it may be told to do: a walk, a thing shown, the agent, or nothing. */
+//
+// The visitor types "where do I see what each plan includes?" and the dot does something on the page,
+// never a conversation: it plays one of the page's walks, shows one thing of the page, offers the agent
+// for a question a person answers, or says it cannot find it. What decides is a server's (`@pinecall/dot/server`);
+// this is what the two say to each other. A walk that takes params is told them, picked out of what was typed.
+// The same door picks the row of a table a walk read that best answers the visitor, and records a sentence
+// of a walk once its slots are filled: one door, three asks, told apart by their one key.
+import { LONGEST_VALUE } from "./acts.js";
+/** The most turns a talk sends as heard: the gateway's own ceiling. */
+export const MOST_HEARD = 80;
+// A line of the page as Page writes it: `  - heading "Pricing" [level=2] [ref=e10]`. A name's own quotes are
+// written as apostrophes, so the first closing quote ends it.
+const A_THING = /^\s*- ([a-z]+) "([^"]*)".*?\[ref=(e\d+)\]/;
+/** The things of a page with a name and a ref, in the page's order. */
+export function namedIn(page) {
+    return page.split("\n").flatMap((line) => {
+        const found = A_THING.exec(line);
+        return found === null || found[2] === undefined || found[2].trim() === "" ? [] : [{ role: found[1] ?? "", name: found[2], ref: found[3] ?? "" }];
+    });
+}
+const isNumber = (value) => typeof value === "number" && Number.isFinite(value);
+/** A decision as a server answered it, checked; null for anything else. */
+export function decisionOf(value) {
+    if (typeof value !== "object" || value === null)
+        return null;
+    const fields = { ...value };
+    const confidence = fields["confidence"];
+    if (!isNumber(confidence))
+        return null;
+    switch (fields["do"]) {
+        case "walk": {
+            if (typeof fields["walk"] !== "string")
+                return null;
+            const given = fields["params"];
+            if (given === undefined)
+                return { do: "walk", walk: fields["walk"], confidence };
+            if (typeof given !== "object" || given === null)
+                return null;
+            const params = Object.fromEntries(Object.entries(given).filter((entry) => typeof entry[1] === "string" && entry[1].length <= LONGEST_VALUE));
+            return { do: "walk", walk: fields["walk"], params, confidence };
+        }
+        case "show":
+            return typeof fields["target"] === "string" && /^e\d+$/.test(fields["target"]) ? { do: "show", target: fields["target"], confidence } : null;
+        case "talk":
+            return { do: "talk", confidence };
+        case "none":
+            return { do: "none", confidence };
+        default:
+            return null;
+    }
+}
+/** The most notes an output is explained with. */
+export const MOST_NOTES = 6;
+/** An explanation's notes, checked, the first six; none for anything else. */
+/** The door's answer to `{ next }` read as the dot's next line; null when it gave none. */
+export function nextOf(value) {
+    if (typeof value !== "object" || value === null)
+        return null;
+    const { say, hangup } = value;
+    return typeof say === "string" && say.trim() !== "" ? { say: say.trim(), hangup: hangup === true } : null;
+}
+export function notesOf(value) {
+    if (typeof value !== "object" || value === null)
+        return [];
+    const notes = value["notes"];
+    if (!Array.isArray(notes))
+        return [];
+    return notes
+        .flatMap((note) => {
+        if (typeof note !== "object" || note === null)
+            return [];
+        const fields = { ...note };
+        const { find, say } = fields;
+        return typeof find === "string" && find.trim() !== "" && typeof say === "string" && say.trim() !== "" ? [{ find, say }] : [];
+    })
+        .slice(0, MOST_NOTES);
+}
+/** A row answer, checked; null for anything else. */
+export function rowOf(value) {
+    if (typeof value !== "object" || value === null)
+        return null;
+    const row = value["row"];
+    return typeof row === "number" && Number.isInteger(row) && row >= 0 ? row : null;
+}
+/** A recorded sentence, checked; null for anything else. */
+export function saidOf(value) {
+    if (typeof value !== "object" || value === null)
+        return null;
+    const said = { ...value };
+    const { say, audio, durationMs, words } = said;
+    if (typeof say !== "string" || typeof audio !== "string" || !/^https?:\/\//.test(audio) || typeof durationMs !== "number" || !Array.isArray(words))
+        return null;
+    const timed = words.filter((word) => {
+        if (typeof word !== "object" || word === null)
+            return false;
+        const one = { ...word };
+        return typeof one["text"] === "string" && typeof one["startMs"] === "number" && typeof one["endMs"] === "number";
+    });
+    return timed.length === words.length ? { say, audio, durationMs, words: timed } : null;
+}
+//# sourceMappingURL=ask.js.map

package/dist/wire/ask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.js","sourceRoot":"","sources":["../../src/wire/ask.ts"],"names":[],"mappings":"AAAA,4IAA4I;AAC5I,EAAE;AACF,sGAAsG;AACtG,wGAAwG;AACxG,mHAAmH;AACnH,+GAA+G;AAC/G,2GAA2G;AAC3G,0FAA0F;AAE1F,OAAO,EAAE,aAAa,EAAe,MAAM,WAAW,CAAC;AA0DvD,uEAAuE;AACvE,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,CAAC;AAsC7B,6GAA6G;AAC7G,8DAA8D;AAC9D,MAAM,OAAO,GAAG,2CAA2C,CAAC;AAE5D,uEAAuE;AACvE,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACvC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACnJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAE1G,2EAA2E;AAC3E,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7D,MAAM,MAAM,GAA4B,EAAE,GAAG,KAAK,EAAE,CAAC;IACrD,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IACxC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,QAAQ,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACrB,KAAK,MAAM,EAAE,CAAC;YACZ,IAAI,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC;YACpD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC/B,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;YACjF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC;YAC7D,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAA6B,EAAE,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,aAAa,CAAC,CAAC,CAAC;YACxK,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAClE,CAAC;QACD,KAAK,MAAM;YACT,OAAO,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/I,KAAK,MAAM;YACT,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QACpC,KAAK,MAAM;YACT,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QACpC;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,kDAAkD;AAClD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;AAE5B,8EAA8E;AAC9E,2FAA2F;AAC3F,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7D,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,KAAgC,CAAC;IACzD,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5G,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC3D,MAAM,KAAK,GAAI,KAAiC,CAAC,OAAO,CAAC,CAAC;IAC1D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,KAAK;SACT,OAAO,CAAC,CAAC,IAAa,EAAE,EAAE;QACzB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,EAAE,CAAC;QACzD,MAAM,MAAM,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;QACpD,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;QAC7B,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/H,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;AAC1B,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,KAAK,CAAC,KAAc;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7D,MAAM,GAAG,GAAI,KAAiC,CAAC,KAAK,CAAC,CAAC;IACtD,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACnF,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7D,MAAM,IAAI,GAA4B,EAAE,GAAG,KAAK,EAAE,CAAC;IACnD,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IAC/C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAChK,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAuC,EAAE;QACvE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC5D,MAAM,GAAG,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;QACjD,OAAO,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,SAAS,CAAC,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;IACnH,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACzF,CAAC"}

package/dist/wire/index.d.ts

@@ -1,4 +1,6 @@
 /** What a tutored page and its agent say to each other: the page's events, and the cursor and macro messages it takes. */
+import { type Act, type Guarded, type Param } from "./acts.js";
+export * from "./acts.js";
 /** The topic the agent sends on, and the page's `onUi` hears. */
 export declare const UI = "pinecall.ui";
 /**
@@ -20,10 +22,11 @@ export declare const WALKED = "page.walked";
 /** The name the agent publishes its recorded walks under, which the page reads with no key. */
 export declare 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 declare const ACTIONS: readonly ["point", "highlight", "unhighlight", "scroll_to", "here", "home", "type"];
+export declare const ACTIONS: readonly ["point", "highlight", "unhighlight", "scroll_to", "here", "home", "type", "press", "wait"];
 export type Action = (typeof ACTIONS)[number];
 /** What the site wrote for the agent to say about one element, and the move it is said with. */
 export interface Line {
@@ -39,6 +42,8 @@ export interface Cursor {
     target?: string | undefined;
     /** What `type` writes in the field: its text, or the option of a list to choose. */
     text?: string | undefined;
+    /** How long `wait` waits at most, in ms. */
+    ms?: number | undefined;
 }
 /** A target that is a ref of the snapshot rather than a name. */
 export declare const A_REF: RegExp;
@@ -60,11 +65,13 @@ export interface Shown {
     code?: CodeView | null | undefined;
     lines?: [from: number, to: number] | undefined;
 }
-/** One sentence of a macro and the moves hung on its words. */
-export interface MacroStep extends Shown {
+/** One sentence of a macro and the moves hung on its words; its `{slots}` filled when it is said. */
+export interface MacroStep extends Shown, Guarded {
     say: string;
     beats: Beat[];
 }
+/** A step of a macro that acts on the page instead of saying a sentence. */
+export type ActStep = Act & Guarded;
 /** A guided walk an agent was given: `macros/<name>.json` in its folder. */
 export interface Macro {
     name: string;
@@ -74,7 +81,9 @@ export interface Macro {
     when?: string | undefined;
     /** The paths of the pages it is for: `["/security"]`. Left out, it is for every page. */
     pages?: string[] | undefined;
-    steps: MacroStep[];
+    /** What it is called with, by name. */
+    params?: Record<string, Param> | undefined;
+    steps: (MacroStep | ActStep)[];
 }
 /**
  * The name of the document the walks of a page are published under: `walks` for the home, `walks-security`
@@ -91,13 +100,20 @@ export interface TimedWord {
     endMs: number;
 }
 /** One sentence of a recorded walk, as the page plays it: its audio, when each word is said, its beats. */
-export interface RecordedStep extends Shown {
+export interface RecordedStep extends Shown, Guarded {
     say: string;
     audio: string;
     durationMs: number;
     words: TimedWord[];
     beats: Beat[];
 }
+/** A sentence with slots: recorded when it is reached, once its values are known (`live`). */
+export interface LiveStep extends Shown, Guarded {
+    say: string;
+    beats: Beat[];
+    live: true;
+}
+export type WalkStep = RecordedStep | LiveStep | ActStep;
 /** A walk recorded in the agent's voice, published for the page to play with no call. */
 export interface RecordedWalk {
     name: string;
@@ -107,7 +123,9 @@ export interface RecordedWalk {
     voice?: string | undefined;
     /** The paths of the pages it is for; none, every page. */
     pages?: string[] | undefined;
-    steps: RecordedStep[];
+    /** What it is called with: a walk with params is asked for, not picked from the menu. */
+    params?: Record<string, Param> | undefined;
+    steps: WalkStep[];
 }
 /** The agent asking for the page as it is now: sent when its call opens, answered with `page.seen`. */
 export interface Look {

package/dist/wire/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wire/index.ts"],"names":[],"mappings":"AAAA,0HAA0H;AAM1H,iEAAiE;AACjE,eAAO,MAAM,EAAE,gBAAgB,CAAC;AAEhC;;;;GAIG;AACH,eAAO,MAAM,IAAI,cAAc,CAAC;AAChC,wEAAwE;AACxE,eAAO,MAAM,KAAK,UAAU,CAAC;AAC7B,uDAAuD;AACvD,eAAO,MAAM,OAAO,iBAAiB,CAAC;AACtC,8FAA8F;AAC9F,eAAO,MAAM,OAAO,iBAAiB,CAAC;AACtC,4FAA4F;AAC5F,eAAO,MAAM,OAAO,iBAAiB,CAAC;AACtC,yHAAyH;AACzH,eAAO,MAAM,MAAM,gBAAgB,CAAC;AACpC,+FAA+F;AAC/F,eAAO,MAAM,KAAK,UAAU,CAAC;AAE7B;;;GAGG;AACH,eAAO,MAAM,OAAO,YAAI,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AAC3G,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9C,gGAAgG;AAChG,MAAM,WAAW,IAAI;IACnB,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,OAAO,GAAG,WAAW,GAAG,WAAW,CAAC;CACzC;AAED,8JAA8J;AAC9J,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,iEAAiE;AACjE,eAAO,MAAM,KAAK,QAAW,CAAC;AAE9B,6HAA6H;AAC7H,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CACjD;AAED,6EAA6E;AAC7E,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,2HAA2H;AAC3H,MAAM,WAAW,KAAK;IACpB,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC;IACnC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;CAChD;AAED,+DAA+D;AAC/D,MAAM,WAAW,SAAU,SAAQ,KAAK;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED,4EAA4E;AAC5E,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,2FAA2F;IAC3F,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,yFAAyF;IACzF,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAKD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED,0HAA0H;AAC1H,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAGlF;AAED,qGAAqG;AACrG,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,2GAA2G;AAC3G,MAAM,WAAW,YAAa,SAAQ,KAAK;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED,yFAAyF;AACzF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,2FAA2F;IAC3F,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,uGAAuG;AACvG,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mEAAmE;AACnE,MAAM,WAAW,IAAK,SAAQ,KAAK;IACjC,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED,8EAA8E;AAC9E,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,gHAAgH;AAChH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,GAAG,IAAI,CAiBrE;AAgBD,+GAA+G;AAC/G,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAwB1E;AAED,sFAAsF;AACtF,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,EAAE,CAW9C;AAkBD,4GAA4G;AAC5G,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,EAAE,CAetD;AAED,sGAAsG;AACtG,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,CAgC3D;AAED,iDAAiD;AACjD,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAGxC;AAED,8EAA8E;AAC9E,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,+DAA+D;AAC/D,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAE9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wire/index.ts"],"names":[],"mappings":"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"}

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,10 +26,13 @@ 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. */
@@ -82,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) {
@@ -94,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" &&
@@ -140,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) {
@@ -166,8 +187,11 @@ export function walksOf(value) {
         const checked = steps.map(stepOf);
         if (checked.some((step) => step === null))
             return [];
+        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, steps: checked.filter((step) => step !== null) }];
+        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. */
@@ -178,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() === "")
@@ -191,11 +238,14 @@ 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"];
@@ -208,6 +258,7 @@ export function macroOf(name, value) {
         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,
     };
 }