@signalcore/ui 0.1.0 → 1.0.0-beta.1

package/dist/builder/useBuildSession.d.ts

@@ -1,36 +0,0 @@
-import { type BuildEvent, type Transcript } from "../stream/builder.js";
-export interface BuildSessionOptions {
-    agentId: string;
-    /** The conversation to show; none starts a new one on the first message. */
-    sessionId?: string | null | undefined;
-    /** Cards still waiting for an answer belong to the latest conversation only (default). */
-    showPending?: boolean | undefined;
-    /** A conversation started here got its id, with the first message. */
-    onSession?: ((sessionId: string) => void) | undefined;
-    /** The model a conversation started here runs on; none is the deployment's default. */
-    model?: string | null | undefined;
-    /** Every event of a turn as it arrives, for a host that refreshes what the builder changes. */
-    onEvent?: ((event: BuildEvent) => void) | undefined;
-    /** A turn is over, however it ended. */
-    onTurnEnd?: (() => void) | undefined;
-}
-export interface BuildSession {
-    transcript: Transcript;
-    /** The history of the conversation is being read. */
-    loading: boolean;
-    /** Why the history could not be read. */
-    error: Error | undefined;
-    /** Sends the owner's message and follows the turn; nothing while one runs. */
-    send: (text: string) => Promise<void>;
-    /** Hangs up on the turn that runs. */
-    stop: () => void;
-}
-/**
- * One conversation with the builder: its transcript, sending a message and stopping the turn.
- * The history is read again whenever the conversation changes, a conversation started here is
- * created with the first message (`onSession` hears its id), and a turn streams through the
- * provider's client (`build.sessions.say`) until its last event, or until `stop`.
- *
- * It is what `BuilderChat` is made of, for a host that draws the conversation its own way.
- */
-export declare function useBuildSession(options: BuildSessionOptions): BuildSession;

package/dist/builder/useBuildSession.js

@@ -1,130 +0,0 @@
-import { useCallback, useEffect, useReducer, useRef, useState } from "react";
-import { cardOf } from "../request/cards.js";
-import { useMessages, useSignalcore } from "../SignalcoreProvider.js";
-import { emptyTranscript, isBuildEvent, reduceTranscript, } from "../stream/builder.js";
-import { untilAborted } from "../stream/untilAborted.js";
-const keyOf = (agentId, sessionId) => `${agentId}/${sessionId}`;
-const asError = (reason, connectionLost) => reason instanceof Error ? reason : new Error(connectionLost);
-/**
- * One conversation with the builder: its transcript, sending a message and stopping the turn.
- * The history is read again whenever the conversation changes, a conversation started here is
- * created with the first message (`onSession` hears its id), and a turn streams through the
- * provider's client (`build.sessions.say`) until its last event, or until `stop`.
- *
- * It is what `BuilderChat` is made of, for a host that draws the conversation its own way.
- */
-export function useBuildSession(options) {
-    const { agentId, sessionId = null, showPending = true, model = null } = options;
-    const { client } = useSignalcore();
-    const { connectionLost } = useMessages();
-    const sessions = client?.build?.sessions;
-    const pending = client?.requests?.pending;
-    const [transcript, dispatch] = useReducer(reduceTranscript, emptyTranscript);
-    const [shown, setShown] = useState(null);
-    const turn = useRef(null);
-    // The host's callbacks (and the word for a lost connection) as of the last render, so neither
-    // sending nor reading changes when they do.
-    const latest = useRef({ ...options, connectionLost });
-    useEffect(() => {
-        latest.current = { ...options, connectionLost };
-    });
-    const key = sessionId === null ? null : keyOf(agentId, sessionId);
-    const shownKey = shown?.key;
-    useEffect(() => {
-        // A conversation that is on screen already (started here, or read) is not read again.
-        if (sessionId === null || key === shownKey || !sessions)
-            return undefined;
-        let current = true;
-        const read = async () => {
-            const [page, waiting] = await Promise.all([
-                sessions.history(agentId, sessionId),
-                showPending && pending
-                    ? pending({ agent_id: agentId, source: "builder" }).then((found) => found.items, () => [])
-                    : [],
-            ]);
-            const cards = waiting.flatMap((request) => cardOf(request) ?? []);
-            const events = page.items.flatMap((item) => (isBuildEvent(item) ? [item] : []));
-            return { events, pending: cards };
-        };
-        read().then((history) => {
-            if (!current)
-                return;
-            dispatch({ type: "load", ...history });
-            setShown({ key: keyOf(agentId, sessionId) });
-        }, (reason) => {
-            if (current) {
-                const error = asError(reason, latest.current.connectionLost);
-                setShown({ key: keyOf(agentId, sessionId), error });
-            }
-        });
-        return () => {
-            current = false;
-        };
-    }, [sessions, pending, agentId, sessionId, key, shownKey, showPending]);
-    useEffect(() => {
-        // Leaving a conversation stops its turn; a new conversation getting its id does not.
-        const running = turn.current;
-        if (running && running.sessionId !== sessionId)
-            running.controller.abort();
-        if (sessionId === null && !running) {
-            dispatch({ type: "load", events: [], pending: [] });
-        }
-    }, [agentId, sessionId]);
-    useEffect(() => () => {
-        turn.current?.controller.abort();
-    }, []);
-    const send = useCallback(async (text) => {
-        const message = text.trim();
-        if (!message || turn.current || !sessions)
-            return;
-        const controller = new AbortController();
-        const current = { controller, sessionId };
-        turn.current = current;
-        dispatch({ type: "start", text: message, at: Date.now() });
-        let finished = false;
-        try {
-            let id = sessionId;
-            if (id === null) {
-                id = (await sessions.create(agentId, { model })).id;
-                current.sessionId = id;
-                setShown({ key: keyOf(agentId, id) });
-                latest.current.onSession?.(id);
-            }
-            const said = sessions.say(agentId, id, message, { signal: controller.signal });
-            for await (const event of untilAborted(said, controller.signal)) {
-                if (!isBuildEvent(event))
-                    continue;
-                dispatch({ type: "event", event, at: Date.now() });
-                if (event.type === "done")
-                    finished = true;
-                latest.current.onEvent?.(event);
-            }
-        }
-        catch (reason) {
-            if (!controller.signal.aborted) {
-                const lost = {
-                    type: "error",
-                    message: asError(reason, latest.current.connectionLost).message,
-                };
-                dispatch({ type: "event", event: lost, at: Date.now() });
-            }
-        }
-        finally {
-            if (!finished)
-                dispatch({ type: "stop", at: Date.now() });
-            turn.current = null;
-            latest.current.onTurnEnd?.();
-        }
-    }, [sessions, agentId, sessionId, model]);
-    const stop = useCallback(() => {
-        turn.current?.controller.abort();
-    }, []);
-    const reading = key !== null && key !== shownKey && sessions !== undefined;
-    return {
-        transcript,
-        loading: reading,
-        error: key !== null && key === shownKey ? shown?.error : undefined,
-        send,
-        stop,
-    };
-}

package/dist/builder/workingOn.d.ts

@@ -1,7 +0,0 @@
-import type { Messages } from "../messages/index.js";
-import { type Transcript } from "../stream/builder.js";
-/**
- * What the builder is doing right now, in a few words: "Editar app.py", "Escribiendo". In the
- * language of `messages`, which a component takes from `useMessages()`; Spanish without it.
- */
-export declare function workingOn(transcript: Transcript, messages?: Messages): string;

package/dist/builder/workingOn.js

@@ -1,15 +0,0 @@
-import { es } from "../messages/es.js";
-import { activity } from "../stream/builder.js";
-import { describeStep } from "./steps.js";
-/**
- * What the builder is doing right now, in a few words: "Editar app.py", "Escribiendo". In the
- * language of `messages`, which a component takes from `useMessages()`; Spanish without it.
- */
-export function workingOn(transcript, messages = es) {
-    const current = activity(transcript);
-    if (current?.kind === "step") {
-        const step = describeStep(current.name, current.input, messages);
-        return step.target ? `${step.verb} ${step.target}` : step.verb;
-    }
-    return current?.kind === "text" ? messages.writingReply : messages.working;
-}

package/dist/chat/AgentChat.d.ts

@@ -1,37 +0,0 @@
-import type { SurfaceAction } from "../surface/types.js";
-import type { ChatMessage } from "./types.js";
-export interface AgentChatProps {
-    /** The agent the person talks to. */
-    agentId: string;
-    /** The conversation to speak in; the agent remembers it across messages. */
-    thread?: string | undefined;
-    placeholder?: string | undefined;
-    /**
-     * The person picked or submitted something on a surface. The chat has already sent it to the
-     * agent (`agents.invoke` with the action), so this is only to tell the host, for its own
-     * records.
-     */
-    onSurfaceAction?: ((action: SurfaceAction) => void) | undefined;
-    autoFocus?: boolean | undefined;
-    /**
-     * What was said in this thread before, oldest first; read once when the chat opens. See
-     * `messagesFromConversation` for the API's conversation messages. Without it the chat reads
-     * the caller's own conversation in the thread when the client can (`endUsers.myConversation`,
-     * which an end user's token or a publishable key has), and otherwise starts empty.
-     */
-    loadHistory?: ((thread: string | undefined) => Promise<ChatMessage[]>) | undefined;
-    /** What the conversation is called to someone who cannot see it. */
-    label?: string | undefined;
-    className?: string | undefined;
-}
-/**
- * The chat of the people an agent serves (ADR 0009): their messages and the agent's, the
- * agent's surfaces drawn inline, and a box to write in. It speaks to the agent as the person
- * (`agents.invoke` through the provider's client) and can never change the agent.
- *
- * It never shows an approval, a connection or a secret: when the agent needs the owner to
- * confirm something, the person sees that the answer is waiting, and gets it when it arrives.
- * New messages from the agent are announced to screen readers, and everything works from the
- * keyboard (Enter sends, Shift+Enter breaks the line, a surface's buttons are real buttons).
- */
-export declare function AgentChat(props: AgentChatProps): import("react").JSX.Element;

package/dist/chat/AgentChat.js

@@ -1,21 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { Scoped } from "../SignalcoreProvider.js";
-import { ChatView } from "./ChatView.js";
-import { useConversation } from "./useConversation.js";
-/**
- * The chat of the people an agent serves (ADR 0009): their messages and the agent's, the
- * agent's surfaces drawn inline, and a box to write in. It speaks to the agent as the person
- * (`agents.invoke` through the provider's client) and can never change the agent.
- *
- * It never shows an approval, a connection or a secret: when the agent needs the owner to
- * confirm something, the person sees that the answer is waiting, and gets it when it arrives.
- * New messages from the agent are announced to screen readers, and everything works from the
- * keyboard (Enter sends, Shift+Enter breaks the line, a surface's buttons are real buttons).
- */
-export function AgentChat(props) {
-    return (_jsx(Scoped, { children: _jsx(Chat, { ...props }, `${props.agentId}/${props.thread ?? ""}`) }));
-}
-function Chat({ agentId, thread, placeholder, onSurfaceAction, autoFocus, loadHistory, label, className, }) {
-    const conversation = useConversation({ agentId, thread, loadHistory, onSurfaceAction });
-    return (_jsx(ChatView, { conversation: conversation, placeholder: placeholder, autoFocus: autoFocus, label: label, className: className }));
-}

package/dist/chat/ChatView.d.ts

@@ -1,25 +0,0 @@
-import type { Conversation } from "./useConversation.js";
-export interface ChatViewProps {
-    conversation: Conversation;
-    placeholder?: string | undefined;
-    autoFocus?: boolean | undefined;
-    /** What the conversation is called to someone who cannot see it. */
-    label?: string | undefined;
-    /**
-     * The box to write in, the line saying the agent is writing, what went wrong and the
-     * announcement of new words are somewhere else (the shell's dock), so this draws the
-     * transcript alone.
-     */
-    docked?: boolean | undefined;
-    className?: string | undefined;
-}
-/**
- * A conversation drawn: the person's messages and the agent's, the agent's surfaces inline,
- * and (unless it is docked) the box to write in. It draws a `Conversation` it is given, so the
- * chat of one agent (`AgentChat`) and the conversation window of a shell (`AgentSpace`) are the
- * same drawing of different holders of it.
- *
- * A surface takes a pick only while it is the last thing said: once the person has answered, in
- * a pick or in words, it is a record of what was shown.
- */
-export declare function ChatView({ conversation, placeholder, autoFocus, label, docked, className, }: ChatViewProps): import("react").JSX.Element;

package/dist/chat/ChatView.js

@@ -1,34 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { useMemo, useState } from "react";
-import { ErrorText } from "../parts/Input.js";
-import { Spinner } from "../parts/Spinner.js";
-import { useLanguage, useMessages, useParts } from "../SignalcoreProvider.js";
-import { Composer } from "./Composer.js";
-import { MessageRow } from "./MessageRow.js";
-import { rowsOf } from "./moments.js";
-import { useStickToBottom } from "./useStickToBottom.js";
-/**
- * A conversation drawn: the person's messages and the agent's, the agent's surfaces inline,
- * and (unless it is docked) the box to write in. It draws a `Conversation` it is given, so the
- * chat of one agent (`AgentChat`) and the conversation window of a shell (`AgentSpace`) are the
- * same drawing of different holders of it.
- *
- * A surface takes a pick only while it is the last thing said: once the person has answered, in
- * a pick or in words, it is a record of what was shown.
- */
-export function ChatView({ conversation, placeholder, autoFocus, label, docked = false, className, }) {
-    const part = useParts();
-    const language = useLanguage();
-    const copy = useMessages();
-    const { scroller, content } = useStickToBottom();
-    // The day labels are relative to when the chat opened.
-    const [now] = useState(() => new Date());
-    const rows = useMemo(() => rowsOf(conversation.messages, now, language), [conversation.messages, now, language]);
-    const { loading, answering, waiting } = conversation;
-    const last = conversation.messages.at(-1);
-    const latest = last && last.surfaces.length > 0 ? last.id : undefined;
-    const status = answering ? copy.writing : waiting ? copy.waitingForConfirmation : undefined;
-    return (_jsxs("section", { ...part("chat", [], className), "aria-label": label ?? copy.agentChat, children: [_jsx("div", { ref: scroller, ...part("chat__scroll"), children: _jsxs("div", { ref: content, ...part("chat__content"), children: [loading && (_jsxs("p", { ...part("chat__note"), children: [_jsx(Spinner, {}), " ", copy.loadingConversation] })), _jsx("ol", { ...part("messages"), children: rows.map((row) => row.kind === "moment" ? (_jsx("li", { ...part("moment"), children: row.label }, row.id)) : (_jsx(MessageRow, { message: row.message, joined: row.joined, onAction: row.message.id === latest && !answering && !waiting && !loading
-                                    ? conversation.act
-                                    : undefined }, row.message.id))) }), !docked && (_jsx("div", { role: "status", ...part("chat__status"), children: status && (_jsxs(_Fragment, { children: [_jsx(Spinner, {}), " ", status] })) })), !docked && conversation.problem && _jsx(ErrorText, { children: conversation.problem })] }) }), !docked && (_jsxs(_Fragment, { children: [_jsx("div", { "aria-live": "polite", "aria-atomic": "true", ...part("sr-only"), children: conversation.announcement }), _jsx(Composer, { onSend: conversation.send, live: answering || waiting, disabled: loading, placeholder: placeholder ?? copy.defaultPlaceholder, autoFocus: autoFocus })] }))] }));
-}

package/dist/chat/Composer.d.ts

@@ -1,20 +0,0 @@
-import { type ReactNode } from "react";
-import { type ComposerOptions } from "./useComposer.js";
-export interface ComposerProps extends ComposerOptions {
-    /** What the box is called to someone who cannot see it. */
-    label?: string | undefined;
-    placeholder?: string | undefined;
-    autoFocus?: boolean | undefined;
-    /** Above the box: what the message is about. */
-    context?: ReactNode;
-    /** In the box, beside the send button: the host's own tools (a model, a file, a microphone). */
-    tools?: ReactNode;
-    className?: string | undefined;
-}
-/**
- * The message box of both chats: grows with the text, Enter sends, Shift+Enter breaks the line
- * and Esc stops a running turn. While a turn runs the button becomes a stop button; while the
- * history loads it cannot send, but the box stays free to write in, so the person is never
- * dropped out of it. The behavior is `useComposer`'s.
- */
-export declare function Composer({ label, placeholder, autoFocus, context, tools, className, ...options }: ComposerProps): import("react").JSX.Element;

package/dist/chat/Composer.js

@@ -1,22 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import {} from "react";
-import { Icon } from "../parts/Icon.js";
-import { useMessages, useParts } from "../SignalcoreProvider.js";
-import { useComposer } from "./useComposer.js";
-/**
- * The message box of both chats: grows with the text, Enter sends, Shift+Enter breaks the line
- * and Esc stops a running turn. While a turn runs the button becomes a stop button; while the
- * history loads it cannot send, but the box stays free to write in, so the person is never
- * dropped out of it. The behavior is `useComposer`'s.
- */
-export function Composer({ label, placeholder, autoFocus, context, tools, className, ...options }) {
-    const part = useParts();
-    const messages = useMessages();
-    const { input, canSend, send, focus } = useComposer(options);
-    const { live, onStop } = options;
-    const stoppable = live === true && onStop !== undefined;
-    return (_jsxs("form", { ...part("composer", [], className), onSubmit: (event) => {
-            event.preventDefault();
-            send();
-        }, children: [context && _jsx("div", { ...part("composer__context"), children: context }), _jsxs("div", { ...part("composer__box"), onClick: focus, children: [_jsx("textarea", { ...input, autoFocus: autoFocus, placeholder: placeholder, "aria-label": label ?? messages.message, ...part("composer__input") }), _jsxs("div", { ...part("composer__bar"), children: [_jsx("div", { ...part("composer__tools"), children: tools }), stoppable ? (_jsx("button", { type: "button", onClick: onStop, "aria-label": messages.stop, title: messages.stopWithKey, ...part("composer__send", ["stop"]), children: _jsx(Icon, { name: "stop" }) })) : (_jsx("button", { type: "submit", disabled: !canSend, "aria-label": messages.send, ...part("composer__send"), children: _jsx(Icon, { name: "arrowUp" }) }))] })] })] }));
-}

package/dist/chat/MessageRow.d.ts

@@ -1,22 +0,0 @@
-import type { SurfaceAction } from "../surface/types.js";
-import type { ChatMessage } from "./types.js";
-export interface MessageRowProps {
-    message: ChatMessage;
-    /** The same side said the one before: they sit close together. */
-    joined: boolean;
-    /**
-     * What the person does on this message's surfaces. Without it they are a record of what was
-     * shown: only the latest message of a quiet conversation takes a pick.
-     */
-    onAction?: ((action: SurfaceAction) => void) | undefined;
-}
-/**
- * One message: the words (kept as written, line breaks included) and what the agent drew with
- * them. Its surfaces are the catalog's, drawn by `Surface`, which shows the text twin of any it
- * cannot draw. A person who cannot see the page hears who said it.
- *
- * A surface the agent placed in a window (`Surface.window`) is not drawn here when the chat is
- * part of a shell: the window has it, and the transcript says where, with a way to go there.
- * On its own, a chat has no windows, so the surface is drawn in the message.
- */
-export declare const MessageRow: import("react").MemoExoticComponent<({ message, joined, onAction }: MessageRowProps) => import("react").JSX.Element>;

package/dist/chat/MessageRow.js

@@ -1,32 +0,0 @@
-import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
-import { memo } from "react";
-import { useMessages, useParts } from "../SignalcoreProvider.js";
-import { Surface } from "../surface/Surface.js";
-import { placementOf } from "../windows/reduce.js";
-import { useReveal } from "../windows/reveal.js";
-/**
- * One message: the words (kept as written, line breaks included) and what the agent drew with
- * them. Its surfaces are the catalog's, drawn by `Surface`, which shows the text twin of any it
- * cannot draw. A person who cannot see the page hears who said it.
- *
- * A surface the agent placed in a window (`Surface.window`) is not drawn here when the chat is
- * part of a shell: the window has it, and the transcript says where, with a way to go there.
- * On its own, a chat has no windows, so the surface is drawn in the message.
- */
-export const MessageRow = memo(function MessageRow({ message, joined, onAction }) {
-    const part = useParts();
-    const messages = useMessages();
-    const reveal = useReveal();
-    return (_jsxs("li", { ...part("message", [message.role, joined && "joined"]), children: [_jsxs("span", { ...part("sr-only"), children: [message.role === "person" ? messages.you : messages.theAgent, ":", " "] }), message.text !== "" && _jsx("p", { ...part("message__text"), children: message.text }), message.surfaces.map((surface) => {
-                const placement = placementOf(surface);
-                return reveal && placement ? (_jsx(WindowNote, { placement: placement, reveal: reveal }, surface.id)) : (_jsx("div", { ...part("message__surface"), children: _jsx(Surface, { surface: surface, onAction: onAction }) }, surface.id));
-            })] }));
-});
-/** "→ Abierto en Ventas": where a surface went, and a button to go there. */
-function WindowNote({ placement, reveal }) {
-    const part = useParts();
-    const messages = useMessages();
-    return (_jsxs("p", { ...part("message__window"), children: [_jsx("span", { "aria-hidden": true, children: "\u2192" }), " ", messages.space.openedIn, " ", _jsx("button", { type: "button", onClick: () => {
-                    reveal(placement.slot);
-                }, ...part("message__open"), children: placement.title })] }));
-}

package/dist/chat/arrival.d.ts

@@ -1,15 +0,0 @@
-import type { SurfaceData } from "../surface/types.js";
-import type { RunEvent } from "../stream/reduce.js";
-/** What a run that waited for a confirmation said once it went on. */
-export interface Arrival {
-    text: string;
-    surfaces: SurfaceData[];
-    /** The run ended without finishing its work (it failed, or was canceled). */
-    failed: boolean;
-}
-/**
- * What a run said after it paused. The answer to the message already showed everything up to
- * the pause, and the journal replays from the start, so only what follows the first
- * `run.waiting` is new.
- */
-export declare function arrivalOf(events: readonly RunEvent[]): Arrival;

package/dist/chat/arrival.js

@@ -1,25 +0,0 @@
-import { surfaceOf } from "../surface/check.js";
-/**
- * What a run said after it paused. The answer to the message already showed everything up to
- * the pause, and the journal replays from the start, so only what follows the first
- * `run.waiting` is new.
- */
-export function arrivalOf(events) {
-    const paused = events.findIndex((event) => event.type === "run.waiting");
-    const after = paused === -1 ? events : events.slice(paused + 1);
-    const words = [];
-    const surfaces = [];
-    let failed = false;
-    for (const event of after) {
-        if (event.type === "message.finished" && event.text.trim() !== "")
-            words.push(event.text);
-        else if (event.type === "ui.surface") {
-            const surface = surfaceOf(event.surface);
-            if (surface)
-                surfaces.push(surface);
-        }
-        else if (event.type === "run.finished" && event.status !== "succeeded")
-            failed = true;
-    }
-    return { text: words.join("\n\n"), surfaces, failed };
-}

package/dist/chat/history.d.ts

@@ -1,24 +0,0 @@
-import type { Schemas } from "@signalcore/sdk";
-import type { UiClient } from "../client.js";
-import type { ChatMessage } from "./types.js";
-/**
- * How a chat reads its own past when the host gave it no loader: the caller's conversation in
- * the thread (`endUsers.myConversation`, which only an end user's token or a publishable key
- * has). A person who has not spoken yet has no conversation, which the API says is not found:
- * that is an empty history, not a failure. Nothing when the client cannot say.
- */
-export declare function historyOf(client: UiClient | undefined, agentId: string): ((thread: string | undefined) => Promise<ChatMessage[]>) | undefined;
-/**
- * The messages of a conversation as the API lists them (`conversations.messages`), ready for
- * `AgentChat`'s `loadHistory`: what a contact sent is the person's, everything the business
- * said (the agent, or a teammate who took over) is the agent's. A message with nothing to show
- * (a system note, a file this chat cannot draw) is left out.
- *
- *     loadHistory={() => client.conversations.messages(id).then(messagesFromConversation)}
- */
-/** What a stored message must carry to be drawn: the team's listing and an end user's own
- * conversation both have it, the latter nothing more. */
-export type StoredMessage = Pick<Schemas["MessageOut"], "id" | "direction" | "author" | "body" | "surfaces" | "created_at">;
-export declare function messagesFromConversation(page: {
-    items: readonly StoredMessage[];
-}): ChatMessage[];

package/dist/chat/history.js

@@ -1,45 +0,0 @@
-import { surfaceOf } from "../surface/check.js";
-/** The thread the API speaks in when a message names none. */
-const DEFAULT_THREAD = "default";
-/**
- * How a chat reads its own past when the host gave it no loader: the caller's conversation in
- * the thread (`endUsers.myConversation`, which only an end user's token or a publishable key
- * has). A person who has not spoken yet has no conversation, which the API says is not found:
- * that is an empty history, not a failure. Nothing when the client cannot say.
- */
-export function historyOf(client, agentId) {
-    const mine = client?.endUsers?.myConversation;
-    if (!mine)
-        return undefined;
-    return async (thread) => {
-        try {
-            const conversation = await mine(thread ?? DEFAULT_THREAD, { agent_id: agentId });
-            return messagesFromConversation({ items: conversation.messages });
-        }
-        catch (reason) {
-            if (isNotFound(reason))
-                return [];
-            throw reason;
-        }
-    };
-}
-const isNotFound = (reason) => typeof reason === "object" && reason !== null && "status" in reason && reason.status === 404;
-export function messagesFromConversation(page) {
-    return page.items.flatMap((item) => {
-        if (item.author === "system")
-            return [];
-        const surfaces = item.surfaces.flatMap((raw) => surfaceOf(raw) ?? []);
-        const text = item.body ?? "";
-        if (text === "" && surfaces.length === 0)
-            return [];
-        return [
-            {
-                id: item.id,
-                role: item.direction === "in" ? "person" : "agent",
-                text,
-                surfaces,
-                at: item.created_at,
-            },
-        ];
-    });
-}

package/dist/chat/moments.d.ts

@@ -1,25 +0,0 @@
-import type { Language } from "../messages/index.js";
-import type { ChatMessage } from "./types.js";
-/** What the list shows, in order: the time a stretch of the conversation began, and messages. */
-export type Row = {
-    kind: "moment";
-    id: string;
-    label: string;
-}
-/** `joined`: the same side said the one before, so they sit close together. */
- | {
-    kind: "message";
-    message: ChatMessage;
-    joined: boolean;
-};
-/**
- * "Hoy 10:32", "Ayer 18:05", "12 oct, 09:00", and with the year when it is not this one; the
- * words and the dates of the language.
- */
-export declare function momentLabel(at: Date, now: Date, { locale, messages }: Language): string;
-/**
- * The conversation as rows: a time above the first message and after every long silence or new
- * day, and each message marked as joined to the one before when the same side said both.
- * Messages that carry no time (the ones just sent) follow the stretch they are in.
- */
-export declare function rowsOf(list: readonly ChatMessage[], now: Date, language: Language): Row[];

package/dist/chat/moments.js

@@ -1,72 +0,0 @@
-/** A silence this long (or a new day) starts a new moment, with its time written above it. */
-const MOMENT_GAP_MS = 30 * 60_000;
-const FORMATS = new Map();
-/** How a locale writes a time and a day; made once, since a chat labels many moments. */
-function formatsOf(locale) {
-    let formats = FORMATS.get(locale);
-    if (!formats) {
-        formats = {
-            time: new Intl.DateTimeFormat(locale, { hour: "2-digit", minute: "2-digit" }),
-            day: new Intl.DateTimeFormat(locale, { day: "numeric", month: "short" }),
-            dayAndYear: new Intl.DateTimeFormat(locale, {
-                day: "numeric",
-                month: "short",
-                year: "numeric",
-            }),
-        };
-        FORMATS.set(locale, formats);
-    }
-    return formats;
-}
-const startOfDay = (date) => new Date(date.getFullYear(), date.getMonth(), date.getDate()).getTime();
-/**
- * "Hoy 10:32", "Ayer 18:05", "12 oct, 09:00", and with the year when it is not this one; the
- * words and the dates of the language.
- */
-export function momentLabel(at, now, { locale, messages }) {
-    const formats = formatsOf(locale);
-    const days = Math.round((startOfDay(now) - startOfDay(at)) / 86_400_000);
-    const time = formats.time.format(at);
-    if (days === 0)
-        return `${messages.today} ${time}`;
-    if (days === 1)
-        return `${messages.yesterday} ${time}`;
-    const day = (at.getFullYear() === now.getFullYear() ? formats.day : formats.dayAndYear).format(at);
-    return `${day}, ${time}`;
-}
-function timeOf(message) {
-    if (message.at === undefined)
-        return undefined;
-    const at = new Date(message.at);
-    return Number.isNaN(at.getTime()) ? undefined : at;
-}
-const sameDay = (a, b) => startOfDay(a) === startOfDay(b);
-/**
- * The conversation as rows: a time above the first message and after every long silence or new
- * day, and each message marked as joined to the one before when the same side said both.
- * Messages that carry no time (the ones just sent) follow the stretch they are in.
- */
-export function rowsOf(list, now, language) {
-    const rows = [];
-    let last;
-    list.forEach((message, index) => {
-        const at = timeOf(message);
-        const quiet = at !== undefined && (last === undefined || startsMoment(last, at));
-        if (at !== undefined && quiet) {
-            rows.push({
-                kind: "moment",
-                id: `moment-${message.id}`,
-                label: momentLabel(at, now, language),
-            });
-        }
-        const before = list[index - 1];
-        const joined = !quiet && before?.role === message.role;
-        rows.push({ kind: "message", message, joined });
-        if (at !== undefined)
-            last = at;
-    });
-    return rows;
-}
-function startsMoment(last, at) {
-    return at.getTime() - last.getTime() >= MOMENT_GAP_MS || !sameDay(last, at);
-}

package/dist/chat/types.d.ts

@@ -1,12 +0,0 @@
-import type { SurfaceData } from "../surface/types.js";
-/** One message of the conversation between a person and the agent that serves them. */
-export interface ChatMessage {
-    id: string;
-    /** `person` is whoever is talking to the agent; `agent` is the business's side. */
-    role: "person" | "agent";
-    text: string;
-    /** What the agent showed with its words, ready to draw. */
-    surfaces: SurfaceData[];
-    /** When it was said, as an ISO 8601 time; a message without one is not placed in time. */
-    at: string | undefined;
-}

package/dist/chat/types.js

@@ -1 +0,0 @@
-export {};