@signalcore/ui 0.1.0 → 1.0.0-beta.1

package/dist/windows/AgentSpace.d.ts

@@ -1,78 +0,0 @@
-import { type ReactNode } from "react";
-import type { ChatMessage } from "../chat/types.js";
-import type { SurfaceAction, SurfaceData } from "../surface/types.js";
-import { type SpaceDock, type SpaceMode } from "./Dock.js";
-import type { DefaultWindowKind } from "./kinds.js";
-import { type Spoken } from "./space.js";
-import { type SpaceStrip } from "./Strip.js";
-/**
- * What the host's voice is given to speak with, in the shape of the props `VoiceWindow` (from
- * `@signalcore/ui/voice`) takes, so that `renderVoice={(voice) => <VoiceWindow {...voice} />}`
- * is all there is to wire.
- */
-export interface SpaceVoice {
-    agentId: string;
-    thread: string | undefined;
-    /** A turn was answered: what was said and what came back, which the captions show. */
-    onTurn: (turn: Spoken) => void;
-    /**
-     * The agent showed something with its answer. It is placed as a window (one the agent placed
-     * in none gets the `answer` window), because a person who is listening has no transcript to
-     * read it in.
-     */
-    onSurfaces: (surfaces: readonly SurfaceData[]) => void;
-}
-export interface AgentSpaceProps {
-    /** The agent the person talks to. */
-    agentId: string;
-    /** The conversation to speak in; the agent remembers it, and every window speaks in it. */
-    thread?: string | undefined;
-    /**
-     * The app's own windows to open, besides the conversation, which is always there: the first
-     * one listed is on the stage (`["automations", "flow"]`). Windows the viewer may not be shown
-     * (the provider's `viewer`) are not opened. The agent opens more as it works.
-     */
-    windows?: readonly DefaultWindowKind[] | undefined;
-    /**
-     * How the person talks to the agent: `"text"` (the box in the dock) or `"voice"`. Without it
-     * the space keeps the choice itself, starting with writing.
-     */
-    mode?: SpaceMode | undefined;
-    /** The person chose to write or to speak with the dock's button. */
-    onModeChange?: ((mode: SpaceMode) => void) | undefined;
-    /**
-     * What the dock draws when the person speaks (a `VoiceWindow` from `@signalcore/ui/voice`, or
-     * a voice of the host's own). Without it, there is no voice to choose, and no button for it.
-     */
-    renderVoice?: ((voice: SpaceVoice) => ReactNode) | undefined;
-    /** What was said in this thread before, as `AgentChat` takes it. */
-    loadHistory?: ((thread: string | undefined) => Promise<ChatMessage[]>) | undefined;
-    /** The person picked or submitted something on a surface; it has already gone to the agent. */
-    onSurfaceAction?: ((action: SurfaceAction) => void) | undefined;
-    /** Draws the strip of windows in place of ours. */
-    renderStrip?: ((strip: SpaceStrip) => ReactNode) | undefined;
-    /** Draws the dock in place of ours. */
-    renderDock?: ((dock: SpaceDock) => ReactNode) | undefined;
-    placeholder?: string | undefined;
-    /** What the space is called to someone who cannot see it. */
-    label?: string | undefined;
-    className?: string | undefined;
-}
-/**
- * Everything a person sees of an agent, in one place (ADR 0011): a stage with the window that
- * matters now, a strip of the ones that are open, and a dock to talk from. The conversation is
- * always a window; the others are the app's own (`automations`, `flow`…, drawn from facts by the
- * components the provider registers) and the pages the agent places for the person ("show me
- * this week's sales" ends in a page, not a bubble in a transcript). A pick on one of those pages
- * goes to the agent as the next turn, the way a pick in the chat does.
- *
- * It follows the conversation (`useConversation`, which the dock, the transcript and the pages
- * all speak in) and the journals of the runs it hears the answers of, and gives them to the
- * stage (`useWindows`): the stage is rebuilt from the history when it opens, with no resource of
- * its own. A window the person closed stays closed until the agent puts something new in it.
- *
- * With the keyboard, Tab goes from the strip to the stage to the dock, and Esc closes the window
- * on the stage (never the conversation). Under 720 pixels wide the strip becomes tabs above the
- * stage, which takes the width.
- */
-export declare function AgentSpace(props: AgentSpaceProps): import("react").JSX.Element;

package/dist/windows/AgentSpace.js

@@ -1,135 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useCallback, useEffect, useMemo, useRef, useState, } from "react";
-import { useConversation } from "../chat/useConversation.js";
-import { Scoped, useMessages, useParts, useSignalcore, WithClient } from "../SignalcoreProvider.js";
-import { Dock } from "./Dock.js";
-import { hearingRuns } from "./hearing.js";
-import { Journal } from "./Journal.js";
-import { CHAT_ID, placementOf } from "./reduce.js";
-import { RevealContext } from "./reveal.js";
-import { SpaceChatContext } from "./space.js";
-import { Stage } from "./Stage.js";
-import { Strip } from "./Strip.js";
-import { useUnread } from "./useUnread.js";
-import { useWindows } from "./useWindows.js";
-/** The slot of the window an answer's surface gets when the person is listening and it has none. */
-const ANSWER_SLOT = "answer";
-/**
- * Everything a person sees of an agent, in one place (ADR 0011): a stage with the window that
- * matters now, a strip of the ones that are open, and a dock to talk from. The conversation is
- * always a window; the others are the app's own (`automations`, `flow`…, drawn from facts by the
- * components the provider registers) and the pages the agent places for the person ("show me
- * this week's sales" ends in a page, not a bubble in a transcript). A pick on one of those pages
- * goes to the agent as the next turn, the way a pick in the chat does.
- *
- * It follows the conversation (`useConversation`, which the dock, the transcript and the pages
- * all speak in) and the journals of the runs it hears the answers of, and gives them to the
- * stage (`useWindows`): the stage is rebuilt from the history when it opens, with no resource of
- * its own. A window the person closed stays closed until the agent puts something new in it.
- *
- * With the keyboard, Tab goes from the strip to the stage to the dock, and Esc closes the window
- * on the stage (never the conversation). Under 720 pixels wide the strip becomes tabs above the
- * stage, which takes the width.
- */
-export function AgentSpace(props) {
-    return (_jsx(Scoped, { children: _jsx(Hearing, { ...props }, `${props.agentId}/${props.thread ?? ""}`) }));
-}
-/**
- * Holds the stage, and listens at the client for the runs behind the answers so their journals
- * can be followed: that is where the app's windows are opened. Below this, every turn a window
- * sends is heard, wherever it is sent from.
- */
-function Hearing(props) {
-    const { client } = useSignalcore();
-    const stage = useWindows({ initial: props.windows });
-    const { observe } = stage;
-    const [runs, setRuns] = useState([]);
-    const heard = useMemo(() => hearingRuns(client, (runId) => {
-        setRuns((now) => (now.includes(runId) ? now : [...now, runId]));
-    }), [client]);
-    const ended = useCallback((runId) => {
-        setRuns((now) => now.filter((each) => each !== runId));
-    }, []);
-    return (_jsxs(WithClient, { client: heard, children: [_jsx(Space, { ...props, stage: stage }), runs.map((runId) => (_jsx(Journal, { runId: runId, onEvents: observe, onEnd: ended }, runId)))] }));
-}
-function Space({ stage, agentId, thread, mode: chosen, onModeChange, renderVoice, loadHistory, onSurfaceAction, renderStrip, renderDock, placeholder, label, className, }) {
-    const part = useParts();
-    const copy = useMessages();
-    const conversation = useConversation({ agentId, thread, loadHistory, onSurfaceAction });
-    const { windows, closed, focused, focusedId, focus, close, reopen, place, restore } = stage;
-    const stageBox = useRef(null);
-    // What the agent placed in the conversation (its past, and each answer after it) is the stage's.
-    const restored = useRef(false);
-    const { loading, messages } = conversation;
-    useEffect(() => {
-        if (loading)
-            return;
-        const surfaces = messages.flatMap((message) => message.surfaces);
-        if (restored.current) {
-            place(surfaces);
-        }
-        else {
-            restored.current = true;
-            restore(surfaces);
-        }
-    }, [loading, messages, place, restore]);
-    const reveal = useCallback((slot) => {
-        const id = `slot:${slot}`;
-        if (closed.some((each) => each.id === id))
-            reopen(id);
-        else
-            focus(id);
-    }, [closed, focus, reopen]);
-    const [own, setOwn] = useState("text");
-    const canSpeak = renderVoice !== undefined;
-    const mode = canSpeak && (chosen ?? own) === "voice" ? "voice" : "text";
-    const setMode = useCallback((next) => {
-        setOwn(next);
-        onModeChange?.(next);
-    }, [onModeChange]);
-    const [spoken, setSpoken] = useState();
-    const voice = useMemo(() => ({
-        agentId,
-        thread,
-        onTurn: (turn) => {
-            setSpoken({ said: turn.said, answer: turn.answer });
-        },
-        onSurfaces: (surfaces) => {
-            place(surfaces.map((surface) => placementOf(surface)
-                ? surface
-                : { ...surface, window: { slot: ANSWER_SLOT, title: copy.space.answer } }));
-        },
-    }), [agentId, thread, place, copy.space.answer]);
-    const chat = useMemo(() => ({ conversation, voice: mode === "voice", spoken }), [conversation, mode, spoken]);
-    const unread = useUnread(messages, loading, focusedId === CHAT_ID);
-    const strip = { windows, closed, focusedId, focus, close, reopen, unread };
-    const busy = conversation.answering || conversation.waiting || loading;
-    const dock = {
-        mode,
-        setMode,
-        canSpeak,
-        send: conversation.send,
-        answering: conversation.answering,
-        waiting: conversation.waiting,
-        loading,
-        problem: conversation.problem,
-        announcement: conversation.announcement,
-        voice: mode === "voice" ? renderVoice?.(voice) : undefined,
-    };
-    // Esc closes the window on the stage, but not from the dock or while typing in a field of it
-    // (there it means something else), and never the conversation.
-    const closeOnEscape = (event) => {
-        if (event.key !== "Escape" || event.defaultPrevented || focusedId === CHAT_ID)
-            return;
-        if (!(event.target instanceof Element) || event.target.closest('[data-sc="dock"]'))
-            return;
-        if (event.target.closest("input, textarea, select, [contenteditable]"))
-            return;
-        event.preventDefault();
-        close(focusedId);
-        stageBox.current?.focus();
-    };
-    return (_jsx(RevealContext, { value: reveal, children: _jsx(SpaceChatContext, { value: chat, children: _jsxs("section", { ...part("space", [mode === "voice" && "voice"], className), "aria-label": label ?? copy.space.label, onKeyDown: closeOnEscape, children: [_jsxs("div", { ...part("space__main"), children: [renderStrip ? renderStrip(strip) : _jsx(Strip, { ...strip }), _jsx("div", { ref: stageBox, tabIndex: -1, ...part("space__stage"), children: focused && (_jsx(Stage, { shown: focused, agentId: agentId, thread: thread, onAction: busy ? undefined : conversation.act, onClose: () => {
-                                        close(focused.id);
-                                    } }, focused.id)) })] }), renderDock ? renderDock(dock) : _jsx(Dock, { dock: dock, placeholder: placeholder })] }) }) }));
-}

package/dist/windows/Captions.d.ts

@@ -1,13 +0,0 @@
-import type { SpaceChat } from "./space.js";
-export interface CaptionsProps {
-    chat: Pick<SpaceChat, "conversation" | "spoken">;
-    /** What the captions are called to someone who cannot see them. */
-    label?: string | undefined;
-    className?: string | undefined;
-}
-/**
- * The conversation when the person is listening instead of reading: the last thing they said and
- * the last thing the agent answered, as plain lines, and nothing of the transcript. The voice's
- * own turn is shown while it is the latest; before the first one, the end of what was written.
- */
-export declare function Captions({ chat, label, className }: CaptionsProps): import("react").JSX.Element;

package/dist/windows/Captions.js

@@ -1,22 +0,0 @@
-import { jsxs as _jsxs } from "react/jsx-runtime";
-import { useMessages, useParts } from "../SignalcoreProvider.js";
-/**
- * The conversation when the person is listening instead of reading: the last thing they said and
- * the last thing the agent answered, as plain lines, and nothing of the transcript. The voice's
- * own turn is shown while it is the latest; before the first one, the end of what was written.
- */
-export function Captions({ chat, label, className }) {
-    const part = useParts();
-    const copy = useMessages();
-    const { said, answer } = chat.spoken ?? lastTurn(chat.conversation.messages);
-    return (_jsxs("section", { ...part("captions", [], className), "aria-label": label ?? copy.space.captions, children: [said !== "" && (_jsxs("p", { ...part("captions__line", ["person"]), children: [_jsxs("span", { ...part("sr-only"), children: [copy.you, ": "] }), said] })), answer !== "" && (_jsxs("p", { ...part("captions__line", ["agent"]), children: [_jsxs("span", { ...part("sr-only"), children: [copy.theAgent, ": "] }), answer] }))] }));
-}
-/** What the person last said, and the agent's answer to it if it has come. */
-function lastTurn(messages) {
-    const asked = messages.findLastIndex((message) => message.role === "person");
-    const said = messages[asked]?.text ?? "";
-    const reply = messages.slice(asked + 1).find((message) => message.role === "agent");
-    // Before anyone spoke, the end of what the agent said is what there is.
-    const answer = asked === -1 ? (messages.findLast((m) => m.role === "agent")?.text ?? "") : (reply?.text ?? "");
-    return { said, answer };
-}

package/dist/windows/Dock.d.ts

@@ -1,37 +0,0 @@
-import type { ReactNode } from "react";
-/** How the person talks to the agent: by writing, or by voice (ADR 0011). */
-export type SpaceMode = "text" | "voice";
-/**
- * What a dock is drawn from: how the person talks, how the conversation stands, and what sends
- * their words. A host that draws its own dock (`AgentSpace`'s `renderDock`) is given this.
- */
-export interface SpaceDock {
-    mode: SpaceMode;
-    setMode: (mode: SpaceMode) => void;
-    /** The host gave a voice to speak with, so the person may choose it. */
-    canSpeak: boolean;
-    send: (text: string) => void;
-    /** The agent is writing its answer. */
-    answering: boolean;
-    /** The run paused for the owner to confirm something, and goes on when they do. */
-    waiting: boolean;
-    /** The history is being read. */
-    loading: boolean;
-    /** Something went wrong; the text is for the person. */
-    problem: string | undefined;
-    /** What the agent just said, in words, for whoever cannot see the page. */
-    announcement: string;
-    /** What the host's voice draws in the dock while the person speaks; nothing when they write. */
-    voice: ReactNode;
-}
-export interface DockProps {
-    dock: SpaceDock;
-    placeholder?: string | undefined;
-}
-/**
- * Where the person talks to the agent, whichever window is on the stage: the box to write in,
- * or the host's voice when they chose to speak, with the way to change between the two. It says
- * when the agent is writing or waiting for a confirmation, and what went wrong, because the
- * conversation may not be the window they are looking at.
- */
-export declare function Dock({ dock, placeholder }: DockProps): import("react").JSX.Element;

package/dist/windows/Dock.js

@@ -1,22 +0,0 @@
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { Composer } from "../chat/Composer.js";
-import { Button } from "../parts/Button.js";
-import { ErrorText } from "../parts/Input.js";
-import { Spinner } from "../parts/Spinner.js";
-import { useMessages, useParts } from "../SignalcoreProvider.js";
-/**
- * Where the person talks to the agent, whichever window is on the stage: the box to write in,
- * or the host's voice when they chose to speak, with the way to change between the two. It says
- * when the agent is writing or waiting for a confirmation, and what went wrong, because the
- * conversation may not be the window they are looking at.
- */
-export function Dock({ dock, placeholder }) {
-    const part = useParts();
-    const copy = useMessages();
-    const { mode, answering, waiting } = dock;
-    const status = answering ? copy.writing : waiting ? copy.waitingForConfirmation : undefined;
-    const toggle = dock.canSpeak && (_jsx(Button, { variant: "ghost", size: "sm", "aria-pressed": mode === "voice", onClick: () => {
-            dock.setMode(mode === "voice" ? "text" : "voice");
-        }, children: mode === "voice" ? copy.space.write : copy.space.speak }));
-    return (_jsxs("div", { ...part("dock"), children: [_jsx("div", { "aria-live": "polite", "aria-atomic": "true", ...part("sr-only"), children: dock.announcement }), _jsx("div", { role: "status", ...part("dock__status"), children: status && (_jsxs(_Fragment, { children: [_jsx(Spinner, {}), " ", status] })) }), dock.problem && _jsx(ErrorText, { children: dock.problem }), mode === "voice" ? (_jsxs("div", { ...part("dock__voice"), children: [dock.voice, toggle] })) : (_jsx(Composer, { onSend: dock.send, live: answering || waiting, disabled: dock.loading, placeholder: placeholder ?? copy.defaultPlaceholder, tools: toggle }))] }));
-}

package/dist/windows/Journal.d.ts

@@ -1,15 +0,0 @@
-import type { RunEvent } from "../stream/reduce.js";
-export interface JournalProps {
-    runId: string;
-    /** What the run has said so far, again and with more each time it says something. */
-    onEvents: (runId: string, events: readonly RunEvent[]) => void;
-    /** The run is over, or could not be followed: nothing more will come of it. */
-    onEnd: (runId: string) => void;
-}
-/**
- * Follows one run's journal (`useRunStream`) and hands what it says to the stage: the surfaces it
- * placed and the windows it opened. It draws nothing. A shell keeps one for each answer it hears
- * until the run ends, so a run that opens a window late (after it paused for an approval) opens
- * it when it happens.
- */
-export declare function Journal({ runId, onEvents, onEnd }: JournalProps): null;

package/dist/windows/Journal.js

@@ -1,19 +0,0 @@
-import { useEffect } from "react";
-import { useRunStream } from "../stream/useRunStream.js";
-/**
- * Follows one run's journal (`useRunStream`) and hands what it says to the stage: the surfaces it
- * placed and the windows it opened. It draws nothing. A shell keeps one for each answer it hears
- * until the run ends, so a run that opens a window late (after it paused for an approval) opens
- * it when it happens.
- */
-export function Journal({ runId, onEvents, onEnd }) {
-    const { events, status } = useRunStream(runId, { cards: false });
-    useEffect(() => {
-        onEvents(runId, events);
-    }, [runId, events, onEvents]);
-    useEffect(() => {
-        if (status === "done" || status === "failed")
-            onEnd(runId);
-    }, [runId, status, onEnd]);
-    return null;
-}

package/dist/windows/KindMark.d.ts

@@ -1,7 +0,0 @@
-import type { Slot } from "../look.js";
-import type { AgentWindow } from "./reduce.js";
-/** The mark of a kind of window; decoration only, the window's title is what names it. */
-export declare function KindMark({ kind, slot }: {
-    kind: AgentWindow["kind"];
-    slot: Slot;
-}): import("react").JSX.Element;

package/dist/windows/KindMark.js

@@ -1,31 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { Icon, Mark } from "../parts/Icon.js";
-/**
- * What each kind of window is drawn with: a mark that says what it is at a glance, in the
- * strip and in the window's own bar. Phosphor Icons (MIT, phosphoricons.com), the regular
- * weight, like the rest of the package's marks.
- */
-const DRAWINGS = {
-    chat: {
-        path: "M128,24A104,104,0,0,0,36.18,176.88L24.83,210.93a16,16,0,0,0,20.24,20.24l34.05-11.35A104,104,0,1,0,128,24Zm0,192a87.87,87.87,0,0,1-44.06-11.81,8,8,0,0,0-6.54-.67L40,216,52.47,178.6a8,8,0,0,0-.66-6.54A88,88,0,1,1,128,216Z",
-    },
-    automations: { icon: "listChecks" },
-    flow: {
-        path: "M160,112h48a16,16,0,0,0,16-16V48a16,16,0,0,0-16-16H160a16,16,0,0,0-16,16V64H128a24,24,0,0,0-24,24v32H72v-8A16,16,0,0,0,56,96H24A16,16,0,0,0,8,112v32a16,16,0,0,0,16,16H56a16,16,0,0,0,16-16v-8h32v32a24,24,0,0,0,24,24h16v16a16,16,0,0,0,16,16h48a16,16,0,0,0,16-16V160a16,16,0,0,0-16-16H160a16,16,0,0,0-16,16v16H128a8,8,0,0,1-8-8V88a8,8,0,0,1,8-8h16V96A16,16,0,0,0,160,112ZM56,144H24V112H56v32Zm104,16h48v48H160Zm0-112h48V96H160Z",
-    },
-    voice: { icon: "microphone" },
-    browser: {
-        path: "M128,24h0A104,104,0,1,0,232,128,104.12,104.12,0,0,0,128,24Zm88,104a87.61,87.61,0,0,1-3.33,24H174.16a157.44,157.44,0,0,0,0-48h38.51A87.61,87.61,0,0,1,216,128ZM102,168H154a115.11,115.11,0,0,1-26,45A115.27,115.27,0,0,1,102,168Zm-3.9-16a140.84,140.84,0,0,1,0-48h59.88a140.84,140.84,0,0,1,0,48ZM40,128a87.61,87.61,0,0,1,3.33-24H81.84a157.44,157.44,0,0,0,0,48H43.33A87.61,87.61,0,0,1,40,128ZM154,88H102a115.11,115.11,0,0,1,26-45A115.27,115.27,0,0,1,154,88Zm52.33,0H170.71a135.28,135.28,0,0,0-22.3-45.6A88.29,88.29,0,0,1,206.37,88ZM107.59,42.4A135.28,135.28,0,0,0,85.29,88H49.63A88.29,88.29,0,0,1,107.59,42.4ZM49.63,168H85.29a135.28,135.28,0,0,0,22.3,45.6A88.29,88.29,0,0,1,49.63,168Zm98.78,45.6a135.28,135.28,0,0,0,22.3-45.6h35.66A88.29,88.29,0,0,1,148.41,213.6Z",
-    },
-    live: {
-        path: "M128,88a40,40,0,1,0,40,40A40,40,0,0,0,128,88Zm0,64a24,24,0,1,1,24-24A24,24,0,0,1,128,152Zm73.71,7.14a80,80,0,0,1-14.08,22.2,8,8,0,0,1-11.92-10.67,63.95,63.95,0,0,0,0-85.33,8,8,0,1,1,11.92-10.67,80.08,80.08,0,0,1,14.08,84.47ZM69,103.09a64,64,0,0,0,11.26,67.58,8,8,0,0,1-11.92,10.67,79.93,79.93,0,0,1,0-106.67A8,8,0,1,1,80.29,85.34,63.77,63.77,0,0,0,69,103.09ZM248,128a119.58,119.58,0,0,1-34.29,84,8,8,0,1,1-11.42-11.2,103.9,103.9,0,0,0,0-145.56A8,8,0,1,1,213.71,44,119.58,119.58,0,0,1,248,128ZM53.71,200.78A8,8,0,1,1,42.29,212a119.87,119.87,0,0,1,0-168,8,8,0,1,1,11.42,11.2,103.9,103.9,0,0,0,0,145.56Z",
-    },
-    surface: {
-        path: "M216,40H40A16,16,0,0,0,24,56V200a16,16,0,0,0,16,16H216a16,16,0,0,0,16-16V56A16,16,0,0,0,216,40Zm0,160H40V56H216V200ZM80,84A12,12,0,1,1,68,72,12,12,0,0,1,80,84Zm40,0a12,12,0,1,1-12-12A12,12,0,0,1,120,84Z",
-    },
-};
-/** The mark of a kind of window; decoration only, the window's title is what names it. */
-export function KindMark({ kind, slot }) {
-    const drawing = DRAWINGS[kind];
-    return "icon" in drawing ? (_jsx(Icon, { name: drawing.icon, slot: slot })) : (_jsx(Mark, { path: drawing.path, slot: slot }));
-}

package/dist/windows/Pending.d.ts

@@ -1,8 +0,0 @@
-/**
- * What a window says instead of itself: that it is loading, that it could not be (`failed` is the
- * window's own sentence), or that it has nothing to draw from.
- */
-export declare function Pending({ state, failed, }: {
-    state: "loading" | "failed" | "unavailable";
-    failed: string;
-}): import("react").JSX.Element;

package/dist/windows/Pending.js

@@ -1,17 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Spinner } from "../parts/Spinner.js";
-import { ErrorText } from "../parts/Input.js";
-import { useMessages, useParts } from "../SignalcoreProvider.js";
-/**
- * What a window says instead of itself: that it is loading, that it could not be (`failed` is the
- * window's own sentence), or that it has nothing to draw from.
- */
-export function Pending({ state, failed, }) {
-    const part = useParts();
-    const copy = useMessages();
-    if (state === "failed")
-        return _jsx(ErrorText, { children: failed });
-    if (state === "unavailable")
-        return _jsx("p", { ...part("note"), children: copy.windows.unavailable });
-    return (_jsxs("p", { role: "status", ...part("note"), children: [_jsx(Spinner, {}), " ", copy.windows.loading] }));
-}

package/dist/windows/Stage.d.ts

@@ -1,18 +0,0 @@
-import type { SurfaceAction } from "../surface/types.js";
-import { type AgentWindow } from "./reduce.js";
-export interface StageProps {
-    /** The window on the stage. */
-    shown: AgentWindow;
-    agentId: string;
-    thread: string | undefined;
-    /** What the person does on a generated window; nothing while the conversation is busy. */
-    onAction: ((action: SurfaceAction) => void) | undefined;
-    onClose: () => void;
-}
-/**
- * The window on the stage, full size, in its frame. A generated window is a surface; a default
- * one is drawn by the component the provider's registry has for its kind, and one with none
- * says what the agent said it shows. Whatever a component does, it cannot take the shell down:
- * if it throws, the window shows its words instead and the rest carries on.
- */
-export declare function Stage({ shown, agentId, thread, onAction, onClose }: StageProps): import("react").JSX.Element;

package/dist/windows/Stage.js

@@ -1,21 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { SurfaceBoundary } from "../surface/SurfaceBoundary.js";
-import { CHAT_ID } from "./reduce.js";
-import { useWindowComponents, WindowTwin } from "./registry.js";
-import { SurfaceWindow } from "./SurfaceWindow.js";
-import { WindowFrame } from "./WindowFrame.js";
-/**
- * The window on the stage, full size, in its frame. A generated window is a surface; a default
- * one is drawn by the component the provider's registry has for its kind, and one with none
- * says what the agent said it shows. Whatever a component does, it cannot take the shell down:
- * if it throws, the window shows its words instead and the rest carries on.
- */
-export function Stage({ shown, agentId, thread, onAction, onClose }) {
-    const components = useWindowComponents();
-    if (shown.kind === "surface") {
-        return (_jsx(SurfaceWindow, { surface: shown.surface, title: shown.title, onAction: onAction, onClose: onClose }));
-    }
-    const Component = components[shown.kind];
-    const twin = _jsx(WindowTwin, { text: shown.fallbackText });
-    return (_jsx(WindowFrame, { title: shown.title, kind: shown.kind, onClose: shown.id === CHAT_ID ? undefined : onClose, children: _jsx(SurfaceBoundary, { fallback: twin, resetKey: shown, children: Component ? (_jsx(Component, { agentId: agentId, thread: thread, label: shown.title, fallbackText: shown.fallbackText, params: shown.params })) : (twin) }) }));
-}

package/dist/windows/StatusLabel.d.ts

@@ -1,9 +0,0 @@
-import type { ReactNode } from "react";
-import type { Tone } from "./status.js";
-/** A state in words, with a dot of its color: the color is never the whole message. */
-export declare function StatusLabel({ tone, live, children, }: {
-    tone: Tone;
-    /** Something is happening right now: the dot breathes. */
-    live?: boolean | undefined;
-    children: ReactNode;
-}): import("react").JSX.Element;

package/dist/windows/StatusLabel.js

@@ -1,7 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useParts } from "../SignalcoreProvider.js";
-/** A state in words, with a dot of its color: the color is never the whole message. */
-export function StatusLabel({ tone, live = false, children, }) {
-    const part = useParts();
-    return (_jsxs("span", { ...part("status", [tone, live && "live"]), children: [_jsx("span", { "aria-hidden": true, ...part("status__dot", [tone]) }), children] }));
-}

package/dist/windows/Strip.d.ts

@@ -1,17 +0,0 @@
-import type { Windows } from "./useWindows.js";
-/**
- * What a strip is drawn from: the open windows and the ones the person closed, which window is
- * on the stage, and what the person can do about them. A host that draws its own strip
- * (`AgentSpace`'s `renderStrip`) is given this.
- */
-export type SpaceStrip = Pick<Windows, "windows" | "closed" | "focusedId" | "focus" | "close" | "reopen"> & {
-    /** The agent said something while another window was on the stage. */
-    unread: boolean;
-};
-/**
- * The open windows, each a button with its mark and title that brings it to the stage, the one
- * on the stage marked. A window is closed from its own bar (or with Esc), where it is; the ones
- * the person closed wait after the open ones, quieter, to be opened again with one press. Tab
- * goes from one button to the next, in the order the windows were opened.
- */
-export declare function Strip({ windows, closed, focusedId, focus, reopen, unread }: SpaceStrip): import("react").JSX.Element;

package/dist/windows/Strip.js

@@ -1,42 +0,0 @@
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect, useRef } from "react";
-import { useMessages, useParts } from "../SignalcoreProvider.js";
-import { KindMark } from "./KindMark.js";
-import { CHAT_ID } from "./reduce.js";
-/**
- * The open windows, each a button with its mark and title that brings it to the stage, the one
- * on the stage marked. A window is closed from its own bar (or with Esc), where it is; the ones
- * the person closed wait after the open ones, quieter, to be opened again with one press. Tab
- * goes from one button to the next, in the order the windows were opened.
- */
-export function Strip({ windows, closed, focusedId, focus, reopen, unread }) {
-    const part = useParts();
-    const copy = useMessages();
-    const onStage = useRef(null);
-    // A window the agent opens may be past the edge of a narrow strip: bring it into sight.
-    useEffect(() => {
-        const tab = onStage.current;
-        if (tab?.parentElement)
-            showInBar(tab, tab.parentElement);
-    }, [focusedId]);
-    return (_jsxs("div", { role: "group", "aria-label": copy.space.windows, ...part("strip"), children: [windows.map((window) => {
-                const current = window.id === focusedId;
-                return (_jsxs("button", { ref: current ? onStage : undefined, type: "button", "aria-current": current ? "true" : undefined, onClick: () => {
-                        focus(window.id);
-                    }, ...part("strip__tab", [current && "current"]), children: [_jsx(KindMark, { kind: window.kind, slot: "strip__mark" }), _jsx("span", { ...part("strip__title"), children: window.title }), unread && window.id === CHAT_ID && (_jsxs(_Fragment, { children: [" ", _jsx("span", { role: "img", "aria-label": copy.space.newMessage, ...part("strip__dot") })] }))] }, window.id));
-            }), closed.map((window) => (_jsxs("button", { type: "button", "aria-label": copy.space.reopen(window.title), onClick: () => {
-                    reopen(window.id);
-                }, ...part("strip__tab", ["closed"]), children: [_jsx(KindMark, { kind: window.kind, slot: "strip__mark" }), _jsx("span", { ...part("strip__title"), children: window.title })] }, window.id)))] }));
-}
-/**
- * Scrolls the strip, and only the strip, so that the tab is in the middle of it where it
- * overflows (a row of tabs, or a long rail). The page it is on stays where it is.
- */
-function showInBar(tab, bar) {
-    if (bar.scrollWidth > bar.clientWidth) {
-        bar.scrollLeft = tab.offsetLeft - bar.offsetLeft - (bar.clientWidth - tab.offsetWidth) / 2;
-    }
-    if (bar.scrollHeight > bar.clientHeight) {
-        bar.scrollTop = tab.offsetTop - bar.offsetTop - (bar.clientHeight - tab.offsetHeight) / 2;
-    }
-}

package/dist/windows/SurfaceWindow.d.ts

@@ -1,20 +0,0 @@
-import type { SurfaceAction, SurfaceData } from "../surface/types.js";
-export interface SurfaceWindowProps {
-    surface: SurfaceData;
-    /** What the window is called. Default: the title the agent placed the surface with. */
-    title?: string | undefined;
-    /**
-     * What the person did on the surface (a pick, a form), in the shape `invoke` expects. The shell
-     * sends it to the agent as the next turn, the way the chat does; without it the window is a
-     * record of what was shown.
-     */
-    onAction?: ((action: SurfaceAction) => void) | undefined;
-    onClose?: (() => void) | undefined;
-    className?: string | undefined;
-}
-/**
- * A generated window: a surface the agent composed from the catalog, drawn in a frame. It is the
- * same `Surface` the transcript draws, with the same rules (a surface it cannot draw shows its
- * text twin, picks go back as actions and never as typed text), in a page of its own.
- */
-export declare function SurfaceWindow({ surface, title, onAction, onClose, className, }: SurfaceWindowProps): import("react").JSX.Element;

package/dist/windows/SurfaceWindow.js

@@ -1,12 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { Surface } from "../surface/Surface.js";
-import { placementOf } from "./reduce.js";
-import { WindowFrame } from "./WindowFrame.js";
-/**
- * A generated window: a surface the agent composed from the catalog, drawn in a frame. It is the
- * same `Surface` the transcript draws, with the same rules (a surface it cannot draw shows its
- * text twin, picks go back as actions and never as typed text), in a page of its own.
- */
-export function SurfaceWindow({ surface, title, onAction, onClose, className, }) {
-    return (_jsx(WindowFrame, { title: title ?? placementOf(surface)?.title ?? surface.fallback_text, kind: "surface", onClose: onClose, className: className, children: _jsx(Surface, { surface: surface, onAction: onAction }) }));
-}

package/dist/windows/WindowFrame.d.ts

@@ -1,23 +0,0 @@
-import { type ReactNode } from "react";
-import type { AgentWindow } from "./reduce.js";
-export interface WindowFrameProps {
-    /** What the window is called: its heading, which names it to someone who cannot see it. */
-    title: string;
-    /** What the window is, for its mark and for a host's styles (`sc-window--flow`). */
-    kind: AgentWindow["kind"];
-    /**
-     * Closes the window, with a button in its bar. Without it the window has none: the
-     * conversation is the one a stage cannot lose.
-     */
-    onClose?: (() => void) | undefined;
-    children: ReactNode;
-    className?: string | undefined;
-}
-/**
- * The chrome every window gets on a stage: its mark and title in a bar, a way to close it, and
- * the room for its content, which scrolls inside while the bar stays. A window is a plain
- * component, so a host may use the frame around its own content, anywhere, without the shell.
- * The frame is a named group, not a landmark: the windows it holds (the conversation, the
- * automations) are the landmarks, and nesting two regions of one name only repeats it.
- */
-export declare function WindowFrame(props: WindowFrameProps): import("react").JSX.Element;

package/dist/windows/WindowFrame.js

@@ -1,22 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useId } from "react";
-import { IconButton } from "../parts/Button.js";
-import { Icon } from "../parts/Icon.js";
-import { Scoped, useMessages, useParts } from "../SignalcoreProvider.js";
-import { KindMark } from "./KindMark.js";
-/**
- * The chrome every window gets on a stage: its mark and title in a bar, a way to close it, and
- * the room for its content, which scrolls inside while the bar stays. A window is a plain
- * component, so a host may use the frame around its own content, anywhere, without the shell.
- * The frame is a named group, not a landmark: the windows it holds (the conversation, the
- * automations) are the landmarks, and nesting two regions of one name only repeats it.
- */
-export function WindowFrame(props) {
-    return (_jsx(Scoped, { children: _jsx(Framed, { ...props }) }));
-}
-function Framed({ title, kind, onClose, children, className }) {
-    const part = useParts();
-    const copy = useMessages();
-    const headingId = useId();
-    return (_jsxs("div", { role: "group", ...part("window", [kind], className), "aria-labelledby": headingId, children: [_jsxs("header", { ...part("window__bar"), children: [_jsx(KindMark, { kind: kind, slot: "window__mark" }), _jsx("h2", { id: headingId, ...part("window__title"), children: title }), onClose && (_jsx(IconButton, { label: copy.space.close(title), onClick: onClose, children: _jsx(Icon, { name: "x" }) }))] }), _jsx("div", { ...part("window__body"), children: children })] }));
-}