@signalcore/ui 0.1.0 → 1.0.0-beta.0

package/dist/request/apps.js

@@ -1,27 +0,0 @@
-import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
-import { safeUrl } from "../safeUrl.js";
-import { useParts } from "../SignalcoreProvider.js";
-/** `googlecalendar` stays as it is, `google_calendar` becomes "Google Calendar". */
-function readable(provider) {
-    const slug = provider.slice(provider.indexOf(":") + 1);
-    return slug
-        .split(/[_\s-]+/)
-        .filter(Boolean)
-        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
-        .join(" ");
-}
-/**
- * How the owner calls an app: the host's name for it, else the slug made readable, else `none`
- * ("the app").
- */
-export function appName(apps, provider, none) {
-    return apps?.name?.(provider) ?? ((provider && readable(provider)) || none);
-}
-/** An app's mark: the host's, else the one the app declared (over https), else a monogram. */
-export function AppLogo({ apps, mark }) {
-    const part = useParts();
-    if (apps?.logo)
-        return _jsx(_Fragment, { children: apps.logo(mark) });
-    const picture = safeUrl(mark.icon);
-    return (_jsx("span", { "aria-hidden": true, ...part("app-logo"), style: { width: mark.size, height: mark.size, fontSize: mark.size * 0.46 }, children: picture ? _jsx("img", { src: picture, alt: "" }) : mark.name.trim().charAt(0).toUpperCase() || "?" }));
-}

package/dist/request/cards.d.ts

@@ -1,12 +0,0 @@
-import type { RequestCardData, RequestKind } from "./types.js";
-export declare function isAnswerable(kind: string): kind is RequestKind;
-/** A request as the API lists it (`requests.pending`), with all its card needs. */
-export interface ListedRequest {
-    id: string;
-    agent_id: string;
-    kind: string;
-    title: string;
-    payload: Record<string, unknown>;
-}
-/** The card for a listed request; nothing for a kind that is only told, or not known here. */
-export declare function cardOf(request: ListedRequest): RequestCardData | undefined;

package/dist/request/cards.js

@@ -1,24 +0,0 @@
-/** Kinds that have a card; a `notify` is only told, and a kind from a newer API is left alone. */
-const ANSWERABLE = new Set([
-    "question",
-    "choice",
-    "connect",
-    "upload",
-    "approval",
-    "secret",
-]);
-export function isAnswerable(kind) {
-    return ANSWERABLE.has(kind);
-}
-/** The card for a listed request; nothing for a kind that is only told, or not known here. */
-export function cardOf(request) {
-    if (!isAnswerable(request.kind))
-        return undefined;
-    return {
-        request_id: request.id,
-        agent_id: request.agent_id,
-        kind: request.kind,
-        title: request.title,
-        payload: request.payload,
-    };
-}

package/dist/request/deliver.d.ts

@@ -1,12 +0,0 @@
-import type { UiClient } from "../client.js";
-import type { Resolution } from "./types.js";
-/** How the host hears of an answer; see `RequestCard`. */
-export type OnResolve = (resolution: Resolution) => void | Promise<void>;
-/** Whether an answer has anywhere to go: the API through the client, or the host. */
-export declare function canAnswer(client: UiClient | undefined, onResolve: OnResolve | undefined): boolean;
-/**
- * Gets an answer to where it belongs. With a client the API takes it, and the host is told
- * afterwards; without one the host takes it from here, and the card counts it answered when the
- * host does. Throws when it cannot be delivered, which the card shows: `cannotAnswer` says why.
- */
-export declare function deliver(client: UiClient | undefined, onResolve: OnResolve | undefined, resolution: Resolution, cannotAnswer: string): Promise<void>;

package/dist/request/deliver.js

@@ -1,21 +0,0 @@
-/** Whether an answer has anywhere to go: the API through the client, or the host. */
-export function canAnswer(client, onResolve) {
-    return client?.requests !== undefined || onResolve !== undefined;
-}
-/**
- * Gets an answer to where it belongs. With a client the API takes it, and the host is told
- * afterwards; without one the host takes it from here, and the card counts it answered when the
- * host does. Throws when it cannot be delivered, which the card shows: `cannotAnswer` says why.
- */
-export async function deliver(client, onResolve, resolution, cannotAnswer) {
-    if (client?.requests) {
-        await client.requests.resolve(resolution.request_id, {
-            value: resolution.value,
-            reject: resolution.reject,
-        });
-    }
-    else if (!onResolve) {
-        throw new Error(cannotAnswer);
-    }
-    await onResolve?.(resolution);
-}

package/dist/request/handOver.d.ts

@@ -1,18 +0,0 @@
-import type { RequestCardData } from "./types.js";
-/**
- * A question whose payload carries the browser is a hand-over: the agent stopped at a login or a
- * payment and the owner takes the controls, in the live view, then says when it is done.
- */
-export interface HandOver {
-    session_id: string;
-    live_url: string | null;
-    /** The live stream showing the browser, when it has one: watched in preference to the rest. */
-    stream_id: string | null;
-    url: string;
-    title: string;
-    /** Why the agent stopped, in its words: the card's heading when it said. */
-    reason: string | null;
-    /** What the owner has to do in the browser, in order (the page marks them with the same numbers). */
-    steps: string[];
-}
-export declare function handOverOf(card: RequestCardData): HandOver | null;

package/dist/request/handOver.js

@@ -1,33 +0,0 @@
-export function handOverOf(card) {
-    if (card.kind !== "question")
-        return null;
-    const browser = card.payload.browser;
-    if (!browser || typeof browser !== "object")
-        return null;
-    const fields = browser;
-    const session = fields["session_id"];
-    if (typeof session !== "string")
-        return null;
-    const text = (key) => (typeof fields[key] === "string" ? fields[key] : "");
-    const reason = card.payload.reason;
-    return {
-        session_id: session,
-        live_url: text("live_url") || null,
-        stream_id: text("stream_id") || null,
-        url: text("url"),
-        title: text("title"),
-        reason: typeof reason === "string" && reason.trim() ? reason.trim() : null,
-        steps: instructionsOf(card.payload.steps),
-    };
-}
-/** The instructions of `payload.steps`, in order; anything that is not one is skipped. */
-function instructionsOf(value) {
-    if (!Array.isArray(value))
-        return [];
-    return value.flatMap((step) => {
-        if (!step || typeof step !== "object")
-            return [];
-        const instruction = step["instruction"];
-        return typeof instruction === "string" && instruction.trim() ? [instruction.trim()] : [];
-    });
-}

package/dist/request/kinds/Approval.d.ts

@@ -1,3 +0,0 @@
-import type { KindProps } from "../types.js";
-/** Allow the action or turn it down. What it would do is shown above, by `ApprovalPreview`. */
-export declare function Approval({ reply, busy }: KindProps): import("react").JSX.Element;

package/dist/request/kinds/Approval.js

@@ -1,9 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Button } from "../../parts/Button.js";
-import { useMessages, useParts } from "../../SignalcoreProvider.js";
-/** Allow the action or turn it down. What it would do is shown above, by `ApprovalPreview`. */
-export function Approval({ reply, busy }) {
-    const part = useParts();
-    const messages = useMessages();
-    return (_jsxs("div", { ...part("request__actions"), children: [_jsx(Button, { size: "sm", variant: "primary", disabled: busy, onClick: () => void reply(true, messages.approved), children: messages.approve }), _jsx(Button, { size: "sm", disabled: busy, onClick: () => void reply(false, messages.rejected, true), children: messages.reject })] }));
-}

package/dist/request/kinds/Choice.d.ts

@@ -1,3 +0,0 @@
-import type { KindProps } from "../types.js";
-/** Pick one of the options the agent offered; the pick is the answer. */
-export declare function Choice({ card, reply, busy }: KindProps): import("react").JSX.Element;

package/dist/request/kinds/Choice.js

@@ -1,8 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { Button } from "../../parts/Button.js";
-import { useParts } from "../../SignalcoreProvider.js";
-/** Pick one of the options the agent offered; the pick is the answer. */
-export function Choice({ card, reply, busy }) {
-    const part = useParts();
-    return (_jsx("div", { ...part("request__actions"), children: (card.payload.options ?? []).map((option) => (_jsx(Button, { size: "sm", disabled: busy, onClick: () => void reply(option, option), children: option }, option))) }));
-}

package/dist/request/kinds/Connect.d.ts

@@ -1,9 +0,0 @@
-import type { KindProps } from "../types.js";
-/**
- * OAuth in a popup. The consent link is asked for on the click, when the client can: the one the
- * card was made with is good for one attempt and expires, and a card answered hours later would
- * send the owner to a dead flow. The callback page tells us when it is done (a message from our
- * own origin); we confirm with the API, and while the consent window is open we ask it every few
- * seconds, since the provider may not send the browser back (local addresses, an unlisted domain).
- */
-export declare function Connect({ card, busy, reply, apps }: KindProps): import("react").JSX.Element;

package/dist/request/kinds/Connect.js

@@ -1,119 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect, useEffectEvent, useState } from "react";
-import { Button } from "../../parts/Button.js";
-import { ErrorText } from "../../parts/Input.js";
-import { safeUrl } from "../../safeUrl.js";
-import { useMessages, useParts, useSignalcore } from "../../SignalcoreProvider.js";
-import { AppLogo, appName } from "../apps.js";
-const POLL_MS = 3_000;
-const GIVE_UP_MS = 5 * 60_000;
-const POPUP = "width=520,height=720";
-/**
- * OAuth in a popup. The consent link is asked for on the click, when the client can: the one the
- * card was made with is good for one attempt and expires, and a card answered hours later would
- * send the owner to a dead flow. The callback page tells us when it is done (a message from our
- * own origin); we confirm with the API, and while the consent window is open we ask it every few
- * seconds, since the provider may not send the browser back (local addresses, an unlisted domain).
- */
-export function Connect({ card, busy, reply, apps }) {
-    const part = useParts();
-    const messages = useMessages();
-    const { url, connection_id: connectionId, provider, icon } = card.payload;
-    const app = appName(apps, provider, messages.theApp);
-    const connections = useSignalcore().client?.connections;
-    const [status, setStatus] = useState(null);
-    const [polling, setPolling] = useState(false);
-    const authorize = safeUrl(url);
-    /** Whether the app is connected; a client that cannot ask takes the owner's word for it. */
-    const isConnected = async () => {
-        if (!connections || !connectionId)
-            return true;
-        return (await connections.refresh(connectionId)).status === "active";
-    };
-    const connected = () => reply("connected", messages.connected(app));
-    const check = async () => {
-        try {
-            if (await isConnected())
-                await connected();
-            else
-                setStatus(messages.notConnectedYet);
-        }
-        catch (reason) {
-            setStatus(reason instanceof Error ? reason.message : messages.cannotSend);
-        }
-    };
-    /**
-     * Where the owner authorizes now; `""` when nothing is left to authorize. A client that
-     * cannot ask, or an answer that is not a safe address, leaves the link the card came with.
-     */
-    const freshLink = async () => {
-        if (!connections || !connectionId)
-            return authorize;
-        try {
-            const pending = await connections.authorize(connectionId);
-            return pending.url ? (safeUrl(pending.url) ?? authorize) : "";
-        }
-        catch {
-            return authorize;
-        }
-    };
-    const openConsent = async () => {
-        // Opened on the click itself: browsers block a window opened after an await.
-        const popup = window.open("", "sc-connect", POPUP);
-        setPolling(true);
-        const link = await freshLink();
-        if (!link) {
-            popup?.close();
-            setPolling(false);
-            if (link === "")
-                await connected();
-            return;
-        }
-        if (popup)
-            popup.location.href = link;
-        else
-            window.open(link, "sc-connect", POPUP);
-    };
-    const onCallback = useEffectEvent(() => void check());
-    useEffect(() => {
-        const onMessage = (event) => {
-            const data = event.data;
-            if (event.origin === window.location.origin && data?.type === "sc:connected")
-                onCallback();
-        };
-        window.addEventListener("message", onMessage);
-        return () => {
-            window.removeEventListener("message", onMessage);
-        };
-    }, []);
-    const onTick = useEffectEvent(async () => {
-        if (connections &&
-            connectionId &&
-            (await connections.refresh(connectionId)).status === "active") {
-            setPolling(false);
-            await connected();
-        }
-    });
-    useEffect(() => {
-        if (!polling || !connections || !connectionId)
-            return undefined;
-        const started = Date.now();
-        const timer = window.setInterval(() => {
-            if (Date.now() - started > GIVE_UP_MS)
-                setPolling(false);
-            else
-                void onTick().catch(() => undefined);
-        }, POLL_MS);
-        return () => {
-            window.clearInterval(timer);
-        };
-    }, [polling, connections, connectionId]);
-    if (!url) {
-        // Nothing to authorize: the app needs no account, or the owner already gave access.
-        return (_jsxs("div", { ...part("request__form"), children: [_jsx("p", { ...part("request__details"), children: messages.alreadyConnected(app) }), _jsx("div", { children: _jsx(Button, { size: "sm", variant: "primary", disabled: busy, onClick: () => void connected(), children: messages.continue }) })] }));
-    }
-    return (_jsxs("div", { ...part("request__form"), children: [_jsxs("div", { ...part("request__actions", ["center"]), children: [_jsxs("button", { type: "button", disabled: busy || !authorize, "aria-busy": polling, ...part("app-button", [polling && "waiting"]), onClick: () => {
-                            if (authorize)
-                                void openConsent();
-                        }, children: [_jsxs("span", { ...part("app-button__logo"), children: [_jsx(AppLogo, { apps: apps, mark: { provider, name: app, icon, size: 24 } }), polling && _jsx("span", { "aria-hidden": true, ...part("app-button__ping") })] }), polling ? messages.waitingFor(app) : messages.connectWith(app)] }), _jsx(Button, { size: "sm", variant: "ghost", disabled: busy, onClick: () => void check(), children: messages.iConnectedIt }), _jsx(Button, { size: "sm", variant: "ghost", disabled: busy, onClick: () => void reply("skip", messages.notNow, true), children: messages.notNow })] }), status && _jsx("p", { ...part("request__hint"), children: status }), !authorize && _jsx(ErrorText, { children: messages.unsafeAddress })] }));
-}

package/dist/request/kinds/FreeText.d.ts

@@ -1,3 +0,0 @@
-import type { KindProps } from "../types.js";
-/** A question with no options: the owner answers in a line. */
-export declare function FreeText({ reply, busy }: KindProps): import("react").JSX.Element;

package/dist/request/kinds/FreeText.js

@@ -1,20 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useState } from "react";
-import { Button } from "../../parts/Button.js";
-import { Input } from "../../parts/Input.js";
-import { useMessages, useParts } from "../../SignalcoreProvider.js";
-/** A question with no options: the owner answers in a line. */
-export function FreeText({ reply, busy }) {
-    const part = useParts();
-    const messages = useMessages();
-    const [value, setValue] = useState("");
-    const submit = (event) => {
-        event.preventDefault();
-        const text = value.trim();
-        if (text)
-            void reply(text, text);
-    };
-    return (_jsxs("form", { onSubmit: submit, ...part("request__form"), children: [_jsx(Input, { value: value, onChange: (event) => {
-                    setValue(event.target.value);
-                }, placeholder: messages.yourAnswer, autoFocus: true }), _jsx("div", { children: _jsx(Button, { type: "submit", size: "sm", variant: "primary", disabled: busy || !value.trim(), children: messages.reply }) })] }));
-}

package/dist/request/kinds/HandOver.d.ts

@@ -1,13 +0,0 @@
-import type { HandOver as HandOverData } from "../handOver.js";
-import type { Reply } from "../types.js";
-/**
- * The owner takes the controls of the agent's browser right here (a login, a payment: their
- * data stays in the hosted browser, nothing passes through us) and says when it is done.
- */
-export declare function HandOver({ handOver, busy, reply, active, }: {
-    handOver: HandOverData;
-    busy: boolean;
-    reply: Reply;
-    /** A hand-over the owner is in the middle of: its browser takes the room. */
-    active: boolean;
-}): import("react").JSX.Element;

package/dist/request/kinds/HandOver.js

@@ -1,20 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { BrowserView } from "../../browser/BrowserView.js";
-import { Button } from "../../parts/Button.js";
-import { useMessages, useParts } from "../../SignalcoreProvider.js";
-/**
- * The owner takes the controls of the agent's browser right here (a login, a payment: their
- * data stays in the hosted browser, nothing passes through us) and says when it is done.
- */
-export function HandOver({ handOver, busy, reply, active, }) {
-    const part = useParts();
-    const messages = useMessages();
-    const { steps } = handOver;
-    return (_jsxs("div", { ...part("handover", [steps.length > 0 && "steps"]), children: [_jsx(BrowserView, { mode: "guiding", sessionId: handOver.session_id, liveUrl: handOver.live_url ?? undefined, streamId: handOver.stream_id ?? undefined, url: handOver.url, title: handOver.title, active: active }), _jsxs("div", { ...part("handover__side"), children: [steps.length > 0 && _jsx(Steps, { steps: steps }), _jsx("p", { ...part("request__details"), children: messages.doItInTheBrowser }), _jsx("div", { children: _jsx(Button, { size: "sm", variant: "primary", disabled: busy, onClick: () => void reply(messages.done, messages.done), children: messages.done }) })] })] }));
-}
-/** What the owner has to do in the browser, in order, numbered as the page marks it. */
-function Steps({ steps }) {
-    const part = useParts();
-    const messages = useMessages();
-    return (_jsx("ol", { "aria-label": messages.steps, ...part("steps"), children: steps.map((instruction, index) => (_jsxs("li", { ...part("steps__item"), children: [_jsx("span", { ...part("steps__number"), children: index + 1 }), _jsx("span", { ...part("steps__text"), children: instruction })] }, index))) }));
-}

package/dist/request/kinds/Secret.d.ts

@@ -1,7 +0,0 @@
-import type { KindProps } from "../types.js";
-/**
- * A key typed straight into the vault: it goes to the vault API through the client, never into
- * the host's callbacks, the chat, the builder or the transcript. The agent only learns that it
- * was saved. Without a client that can store it, the card says so instead of taking it.
- */
-export declare function Secret({ card, busy, reply }: KindProps): import("react").JSX.Element;

package/dist/request/kinds/Secret.js

@@ -1,49 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useState } from "react";
-import { Button } from "../../parts/Button.js";
-import { ErrorText, Input } from "../../parts/Input.js";
-import { useMessages, useParts, useSignalcore } from "../../SignalcoreProvider.js";
-/**
- * A key typed straight into the vault: it goes to the vault API through the client, never into
- * the host's callbacks, the chat, the builder or the transcript. The agent only learns that it
- * was saved. Without a client that can store it, the card says so instead of taking it.
- */
-export function Secret({ card, busy, reply }) {
-    const part = useParts();
-    const messages = useMessages();
-    const vault = useSignalcore().client?.vault;
-    const name = card.payload.secret_name ?? "";
-    const hosts = card.payload.hosts ?? [];
-    const [value, setValue] = useState("");
-    const [saving, setSaving] = useState(false);
-    const [error, setError] = useState(null);
-    const submit = async (event) => {
-        event.preventDefault();
-        const secret = value.trim();
-        if (!secret || !vault)
-            return;
-        setSaving(true);
-        setError(null);
-        try {
-            await vault.put(name, {
-                value: secret,
-                hosts,
-                ...(card.title ? { description: card.title } : {}),
-                ...(card.agent_id ? { agent_id: card.agent_id } : {}),
-            });
-            setValue("");
-            await reply("saved", messages.savedInVault);
-        }
-        catch (reason) {
-            setError(reason instanceof Error ? reason.message : messages.cannotSend);
-        }
-        finally {
-            setSaving(false);
-        }
-    };
-    if (!vault)
-        return _jsx("p", { ...part("request__details"), children: messages.cannotStoreHere });
-    return (_jsxs("form", { onSubmit: (event) => void submit(event), ...part("request__form"), children: [_jsx("p", { ...part("request__name"), children: name }), _jsx(Input, { type: "password", autoComplete: "off", spellCheck: false, value: value, onChange: (event) => {
-                    setValue(event.target.value);
-                }, placeholder: messages.pasteTheKey, "aria-label": messages.secretValue(name) }), _jsx("p", { ...part("request__hint"), children: messages.storedEncrypted }), hosts.length > 0 && (_jsxs("p", { ...part("request__hint"), children: [messages.onlySentTo, _jsx("span", { ...part("request__name"), children: hosts.join(", ") }), "."] })), error && _jsx(ErrorText, { children: error }), _jsx("div", { children: _jsx(Button, { type: "submit", size: "sm", variant: "primary", loading: saving, disabled: busy || !value.trim(), children: messages.saveInVault }) })] }));
-}

package/dist/request/kinds/Upload.d.ts

@@ -1,6 +0,0 @@
-import type { KindProps } from "../types.js";
-/**
- * A document for the agent's knowledge base, uploaded right from the card through the client.
- * Without a client that can store it, the card says so instead of taking a file.
- */
-export declare function Upload({ card, busy, reply }: KindProps): import("react").JSX.Element;

package/dist/request/kinds/Upload.js

@@ -1,47 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useState } from "react";
-import { Icon } from "../../parts/Icon.js";
-import { ErrorText } from "../../parts/Input.js";
-import { useMessages, useParts, useSignalcore } from "../../SignalcoreProvider.js";
-/** What the knowledge base reads; the API turns away the rest. */
-const ACCEPTED = ".pdf,.txt,.md,.csv,.html,.htm";
-/**
- * A document for the agent's knowledge base, uploaded right from the card through the client.
- * Without a client that can store it, the card says so instead of taking a file.
- */
-export function Upload({ card, busy, reply }) {
-    const part = useParts();
-    const messages = useMessages();
-    const documents = useSignalcore().client?.documents;
-    const [uploading, setUploading] = useState(false);
-    const [error, setError] = useState(null);
-    const upload = async (files) => {
-        const file = files?.[0];
-        if (!file || !documents)
-            return;
-        setUploading(true);
-        setError(null);
-        try {
-            const document = await documents.addFile(file, {
-                shared: true,
-                ...(card.agent_id ? { agent_id: card.agent_id } : {}),
-            });
-            if (document.status === "failed") {
-                setError(document.error ?? messages.cannotReadFile);
-                return;
-            }
-            await reply(document.id, messages.uploaded(document.title));
-        }
-        catch (reason) {
-            setError(reason instanceof Error ? reason.message : messages.cannotUpload);
-        }
-        finally {
-            setUploading(false);
-        }
-    };
-    if (!documents)
-        return _jsx("p", { ...part("request__details"), children: messages.cannotStoreHere });
-    return (_jsxs("div", { ...part("request__form"), children: [_jsxs("label", { ...part("drop", [(busy || uploading) && "busy"]), children: [_jsx(Icon, { name: "upload", slot: "drop__icon" }), uploading ? messages.uploading : messages.chooseAFile, _jsx("input", { type: "file", accept: ACCEPTED, hidden: true, onChange: (event) => {
-                            void upload(event.target.files);
-                        } })] }), error && _jsx(ErrorText, { children: error })] }));
-}

package/dist/request/types.d.ts

@@ -1,83 +0,0 @@
-import type { ReactNode } from "react";
-/** The kinds of request an owner answers; `notify` is only told, so it has no card. */
-export type RequestKind = "question" | "choice" | "connect" | "upload" | "approval" | "secret";
-/** What a request carries for its card. Which fields are there depends on the kind. */
-export interface RequestPayload {
-    /** The choices of a `choice`. */
-    options?: string[];
-    /** The app a `connect` or a `secret` is about, as a slug: `googlecalendar`. */
-    provider?: string;
-    /** The app's own mark, kept on its connection. */
-    icon?: string | null;
-    details?: string;
-    /** Where the owner authorizes an app (`connect`); missing when there is nothing to authorize. */
-    url?: string;
-    connection_id?: string;
-    /** The name a `secret` is kept under in the vault. */
-    secret_name?: string;
-    /** The hosts a secret may be sent to, as the builder asked for it. */
-    hosts?: string[];
-    /** A hand-over or an approval about a hosted browser: which session and where it is. */
-    browser?: unknown;
-    /** Why the agent gave the owner the controls, in its words (a hand-over). */
-    reason?: string;
-    /** What the owner has to do in the browser, in order; `ref` names the element for the page. */
-    steps?: {
-        instruction: string;
-        ref?: string | null;
-    }[];
-    /** The calls a paused turn stopped at, and what the agent's code attached to show (approval). */
-    calls?: unknown;
-    preview?: unknown;
-}
-/** A request, as its card needs it: the API's `RequestOut`, under the name the card uses. */
-export interface RequestCardData {
-    request_id: string;
-    /** Which agent asked; set where cards are shown outside one agent's page (the inbox). */
-    agent_id?: string | undefined;
-    kind: RequestKind;
-    title: string;
-    payload: RequestPayload;
-}
-/** What the owner answered. */
-export interface Resolution {
-    request_id: string;
-    /** What goes to the API as the answer: `true` approves, an option, a line of text. */
-    value: unknown;
-    /** The owner turned it down (Rechazar, Ahora no). */
-    reject: boolean;
-    /** The answer in words, as the card shows it afterwards: "Aprobado". */
-    label: string;
-}
-/** An app, to draw its mark. */
-export interface AppMark {
-    provider: string | null | undefined;
-    /** How the app is called. */
-    name: string;
-    /** The mark the app declared itself, if it did. */
-    icon: string | null | undefined;
-    /** The site of an app that is a server of its own, for a host that finds its logo there. */
-    website?: string | null | undefined;
-    /** In pixels. */
-    size: number;
-}
-/**
- * How a host knows its apps. The package has no catalog of brands: without this an app is its
- * name made readable and a monogram. The web app passes the logos it already has.
- */
-export interface AppDirectory {
-    /** How an app is called, from its slug: `googlecalendar` → "Google Calendar". */
-    name?: (provider: string | undefined) => string | undefined;
-    /** An app's mark, `size` pixels wide. */
-    logo?: (app: AppMark) => ReactNode;
-}
-/** Answers the card's request; what each kind of card calls when its owner decides. */
-export type Reply = (value: unknown, shown: string, reject?: boolean) => Promise<void>;
-/** What every kind of card is given. */
-export interface KindProps {
-    card: RequestCardData;
-    reply: Reply;
-    /** Nothing can be pressed: an answer is on its way, or the host asked for it to wait. */
-    busy: boolean;
-    apps: AppDirectory | undefined;
-}

package/dist/request/types.js

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

package/dist/safeUrl.d.ts

@@ -1,6 +0,0 @@
-/**
- * An address a model gave us, if it is safe to put in front of the user: `https://` only. An
- * image, a link and a live browser view all go through this, so no surface can point the page at
- * a `javascript:` or `data:` address, or at plain `http`.
- */
-export declare function safeUrl(url: string | null | undefined): string | undefined;

package/dist/safeUrl.js

@@ -1,8 +0,0 @@
-/**
- * An address a model gave us, if it is safe to put in front of the user: `https://` only. An
- * image, a link and a live browser view all go through this, so no surface can point the page at
- * a `javascript:` or `data:` address, or at plain `http`.
- */
-export function safeUrl(url) {
-    return url?.startsWith("https://") ? url : undefined;
-}