@pinecall/dot 0.0.0-stage → 0.11.21

package/dist/pointer/typing.js.map

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

package/dist/tutor/captions.d.ts

@@ -0,0 +1,22 @@
+/** What the tutor shows of the conversation in words: whose, as the site chose and the visitor turned on or off, and the visitor's own words as they say them. */
+import type { RoomStore } from "@pinecall/room";
+/** Whose words the tutor may show: both sides, one, or none. */
+export type Captions = "both" | "agent" | "caller" | "none";
+export declare const CAPTIONS: readonly Captions[];
+/** What of the call's log the visitor's words are read from. */
+export type Heard = Pick<RoomStore["state"]["log"], "live" | "turns">;
+/** `value` when it names a choice, else both sides. */
+export declare function captionsOf(value: string | null | undefined): Captions;
+/** Whether `side`'s words show, under the site's choice and the visitor's; none while a window of code or a card is open, as they would cover it. */
+export declare function shows(captions: Captions, visitorOn: boolean, side: "agent" | "caller", coding?: boolean): boolean;
+/** Whether the visitor turned the captions on: off unless they turned them on on this site. */
+export declare function visitorWantsCaptions(storage: () => Storage): boolean;
+/** Keep the visitor's choice for their next visit. */
+export declare function keepVisitorChoice(storage: () => Storage, on: boolean): void;
+/** The visitor's words to show now: what they are saying, else their last turn for `linger` ms after it ended. */
+export declare class Hearing {
+    #private;
+    constructor(linger: number);
+    at(log: Heard, now: number): string | null;
+}
+//# sourceMappingURL=captions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"captions.d.ts","sourceRoot":"","sources":["../../src/tutor/captions.ts"],"names":[],"mappings":"AAAA,kKAAkK;AAOlK,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,gEAAgE;AAChE,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAC5D,eAAO,MAAM,QAAQ,EAAE,SAAS,QAAQ,EAAwC,CAAC;AAKjF,gEAAgE;AAChE,MAAM,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;AAEtE,uDAAuD;AACvD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,QAAQ,CAErE;AAED,qJAAqJ;AACrJ,wBAAgB,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,EAAE,MAAM,UAAQ,GAAG,OAAO,CAE/G;AAGD,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,OAAO,GAAG,OAAO,CAMpE;AAED,sDAAsD;AACtD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,OAAO,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAM3E;AAED,kHAAkH;AAClH,qBAAa,OAAO;;IAMlB,YAAY,MAAM,EAAE,MAAM,EAEzB;IAED,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAazC;CACF"}

package/dist/tutor/captions.js

@@ -0,0 +1,62 @@
+/** What the tutor shows of the conversation in words: whose, as the site chose and the visitor turned on or off, and the visitor's own words as they say them. */
+//
+// The agent's words are lit as its voice says them (the bubble beside the face); the visitor's are
+// what the ears hear, interim and then final, held a moment after their turn ends. The site picks
+// which sides may show; they start off, and the visitor's CC button turns them on and off, kept in
+// their browser.
+export const CAPTIONS = ["both", "agent", "caller", "none"];
+/** Where the visitor's choice is kept, per site. */
+const KEPT = "pinecall.captions";
+/** `value` when it names a choice, else both sides. */
+export function captionsOf(value) {
+    return CAPTIONS.find((one) => one === value) ?? "both";
+}
+/** Whether `side`'s words show, under the site's choice and the visitor's; none while a window of code or a card is open, as they would cover it. */
+export function shows(captions, visitorOn, side, coding = false) {
+    return visitorOn && !coding && (captions === "both" || captions === side);
+}
+// Storage throws in a private window or with site data blocked: the captions then start off.
+/** Whether the visitor turned the captions on: off unless they turned them on on this site. */
+export function visitorWantsCaptions(storage) {
+    try {
+        return storage().getItem(KEPT) === "on";
+    }
+    catch {
+        return false;
+    }
+}
+/** Keep the visitor's choice for their next visit. */
+export function keepVisitorChoice(storage, on) {
+    try {
+        storage().setItem(KEPT, on ? "on" : "off");
+    }
+    catch {
+        // Not kept: it holds for this page.
+    }
+}
+/** The visitor's words to show now: what they are saying, else their last turn for `linger` ms after it ended. */
+export class Hearing {
+    #linger;
+    #last = { text: "", at: Number.NEGATIVE_INFINITY };
+    /** The visitor's turns already seen; null until the first look, so a page that joins late shows none of the past. */
+    #turns = null;
+    constructor(linger) {
+        this.#linger = linger;
+    }
+    at(log, now) {
+        const turns = log.turns.filter((turn) => turn.role === "user");
+        if (this.#turns === null)
+            this.#turns = turns.length;
+        const saying = log.live.user;
+        if (saying !== null && saying !== "") {
+            this.#last = { text: saying, at: now };
+            return saying;
+        }
+        if (turns.length > this.#turns) {
+            this.#turns = turns.length;
+            this.#last = { text: turns.at(-1)?.text ?? "", at: now };
+        }
+        return this.#last.text !== "" && now - this.#last.at < this.#linger ? this.#last.text : null;
+    }
+}
+//# sourceMappingURL=captions.js.map

package/dist/tutor/captions.js.map

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

package/dist/tutor/macro.d.ts

@@ -0,0 +1,19 @@
+/** A macro's step on the page: its beats armed when the step arrives, each run as its word is said. */
+import type { Beat, Step } from "../wire/index.js";
+/** Where each beat sits in its step: the index of the word it hangs on, or -1 when the step never says it. */
+export declare function placesOf(step: Pick<Step, "say" | "beats">): number[];
+/** One step at a time: a new one replaces the one before, whose beats are left. */
+export declare class Player {
+    #private;
+    /** A step arrived. `speaking` is the reply under way now, if any. */
+    arm(step: Step, speaking: string | null): void;
+    get armed(): boolean;
+    /**
+     * The beats due now, each once: `speech` is the reply being said (null when none is) and `lit`
+     * the words of it said so far. A step whose reply has ended is done.
+     */
+    due(speech: string | null, lit: string): Beat[];
+    /** Leave the step: the visitor spoke, or the tutor stopped. */
+    drop(): void;
+}
+//# sourceMappingURL=macro.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"macro.d.ts","sourceRoot":"","sources":["../../src/tutor/macro.ts"],"names":[],"mappings":"AAAA,uGAAuG;AAOvG,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAGnD,8GAA8G;AAC9G,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,GAAG,MAAM,EAAE,CAYpE;AAYD,mFAAmF;AACnF,qBAAa,MAAM;;IAGjB,qEAAqE;IACrE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAE7C;IAED,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,EAAE,CAoB9C;IAED,+DAA+D;IAC/D,IAAI,IAAI,IAAI,CAEX;CACF"}

package/dist/tutor/macro.js

@@ -0,0 +1,67 @@
+/** A macro's step on the page: its beats armed when the step arrives, each run as its word is said. */
+//
+// The agent sends a step and then says it. The page binds the step to the next reply it hears, and
+// counts the reply's words as the voice says them (room's karaoke, from the log's word timings):
+// a beat runs when its word starts. So the pointer is in time with the voice to the word, whatever
+// the voice, and nothing has to be timed on the agent's side.
+import { normal, wordsOf } from "../wire/index.js";
+/** Where each beat sits in its step: the index of the word it hangs on, or -1 when the step never says it. */
+export function placesOf(step) {
+    const words = wordsOf(step.say);
+    return step.beats.map((beat) => {
+        const wanted = normal(beat.word);
+        let seen = 0;
+        for (let at = 0; at < words.length; at += 1) {
+            if (words[at] !== wanted)
+                continue;
+            seen += 1;
+            if (seen === (beat.nth ?? 1))
+                return at;
+        }
+        return -1;
+    });
+}
+/** One step at a time: a new one replaces the one before, whose beats are left. */
+export class Player {
+    #armed = null;
+    /** A step arrived. `speaking` is the reply under way now, if any. */
+    arm(step, speaking) {
+        this.#armed = { step, places: placesOf(step), fired: new Set(), speech: null, before: speaking };
+    }
+    get armed() {
+        return this.#armed !== null;
+    }
+    /**
+     * The beats due now, each once: `speech` is the reply being said (null when none is) and `lit`
+     * the words of it said so far. A step whose reply has ended is done.
+     */
+    due(speech, lit) {
+        const armed = this.#armed;
+        if (armed === null)
+            return [];
+        if (armed.speech === null) {
+            if (speech === null || speech === armed.before)
+                return [];
+            armed.speech = speech;
+        }
+        if (speech !== armed.speech) {
+            this.#armed = null;
+            return [];
+        }
+        const said = wordsOf(lit).length;
+        const due = [];
+        armed.step.beats.forEach((beat, at) => {
+            const place = armed.places[at] ?? -1;
+            if (place < 0 || place >= said || armed.fired.has(at))
+                return;
+            armed.fired.add(at);
+            due.push(beat);
+        });
+        return due;
+    }
+    /** Leave the step: the visitor spoke, or the tutor stopped. */
+    drop() {
+        this.#armed = null;
+    }
+}
+//# sourceMappingURL=macro.js.map

package/dist/tutor/macro.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"macro.js","sourceRoot":"","sources":["../../src/tutor/macro.ts"],"names":[],"mappings":"AAAA,uGAAuG;AACvG,EAAE;AACF,mGAAmG;AACnG,iGAAiG;AACjG,mGAAmG;AACnG,8DAA8D;AAG9D,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEnD,8GAA8G;AAC9G,MAAM,UAAU,QAAQ,CAAC,IAAiC;IACxD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC;YAC5C,IAAI,KAAK,CAAC,EAAE,CAAC,KAAK,MAAM;gBAAE,SAAS;YACnC,IAAI,IAAI,CAAC,CAAC;YACV,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;gBAAE,OAAO,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC;AAYD,mFAAmF;AACnF,MAAM,OAAO,MAAM;IACjB,MAAM,GAAiB,IAAI,CAAC;IAE5B,qEAAqE;IACrE,GAAG,CAAC,IAAU,EAAE,QAAuB;QACrC,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnG,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,MAAqB,EAAE,GAAW;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC1B,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,KAAK,CAAC,MAAM;gBAAE,OAAO,EAAE,CAAC;YAC1D,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;QACxB,CAAC;QACD,IAAI,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;YAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;QACjC,MAAM,GAAG,GAAW,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE;YACpC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;YACrC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,OAAO;YAC9D,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACpB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC;IACb,CAAC;IAED,+DAA+D;IAC/D,IAAI;QACF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;CACF"}

package/dist/tutor/options.d.ts

@@ -0,0 +1,42 @@
+/** 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. */
+import type { Shape } from "../face/shape.js";
+import type { Captions } from "./captions.js";
+import type { Views } from "./views.js";
+import type { Walked } from "./walking.js";
+export interface TutorOptions {
+    /** The corner it rests in. Default `right`. */
+    dock?: "right" | "left" | undefined;
+    /** What the face is called for a screen reader. Default "Talk to the assistant". */
+    label?: string | undefined;
+    /** The face was clicked: the page starts the call, or ends it. */
+    onClick?: (() => void) | undefined;
+    /** How long its last words stay beside it after a reply, and the visitor's after theirs, in ms. Default 2600. */
+    linger?: number | undefined;
+    /** The face's shape: `circle` (the default), `squircle` or `blob`. */
+    shape?: Shape | undefined;
+    /** The face's and the pointer's colour, any CSS colour; the page's `--pc-face` when left out. */
+    color?: string | undefined;
+    /** Whose words show: `both` (the default), `agent`, `caller` or `none`. The visitor turns them off and on with CC, unless `none`. */
+    captions?: Captions | undefined;
+    /** The buttons' names, for a screen reader and a tooltip. Default "Hang up", "Captions", "Explain this", "Walks", "Stop", "Pause", "Close" and "More walks". */
+    words?: {
+        hangUp?: string | undefined;
+        captions?: string | undefined;
+        explain?: string | undefined;
+        walks?: string | undefined;
+        stop?: string | undefined;
+        pause?: string | undefined;
+        close?: string | undefined;
+        more?: 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;
+    /** A walk started, ended, or was stopped: the page's own analytics hear it. */
+    onWalk?: ((walked: Walked) => void) | undefined;
+    /**
+     * What the page draws for the agent's own tools, by tool name: a card beside the face with the free
+     * times, the booking form, a piece of code. Read each time a tool finishes, so a page may set it late.
+     */
+    views?: Views | undefined;
+}
+//# sourceMappingURL=options.d.ts.map

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

@@ -0,0 +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"}

package/dist/tutor/options.js

@@ -0,0 +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. */
+export {};
+//# sourceMappingURL=options.js.map

package/dist/tutor/options.js.map

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

package/dist/tutor/tutor.d.ts

@@ -0,0 +1,14 @@
+/** 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;
+}
+/** 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

@@ -0,0 +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,CA8UxE"}