@signalcore/ui 0.1.0 → 1.0.0-beta.1

package/dist/browser/useBrowserSession.js

@@ -1,67 +0,0 @@
-import { useEffect, useState } from "react";
-import { safeUrl } from "../safeUrl.js";
-import { useSignalcore } from "../SignalcoreProvider.js";
-const POLL_MS = 2_000;
-const UNKNOWN = { session: undefined, ended: false, screenshot: undefined };
-/**
- * Follows a hosted browser: asks the API where it is every couple of seconds, and takes its
- * screenshot while there is no live view to watch (a live URL, or `streamed`: a live stream shows
- * the page). Without a client there is nothing to ask, and the view shows what the surface itself
- * said. Polling stops when the API says it is gone.
- */
-export function useBrowserSession(sessionId, knownLiveUrl, streamed = false) {
-    const browser = useSignalcore().client?.browser;
-    const [look, setLook] = useState(UNKNOWN);
-    useEffect(() => {
-        if (!browser)
-            return undefined;
-        let stopped = false;
-        const isStopped = () => stopped;
-        let timer;
-        let screenshot;
-        const forget = () => {
-            if (screenshot)
-                URL.revokeObjectURL(screenshot);
-            screenshot = undefined;
-        };
-        const follow = async () => {
-            try {
-                const session = await browser.get(sessionId);
-                if (isStopped())
-                    return;
-                if (streamed || safeUrl(session.live_url ?? knownLiveUrl))
-                    forget();
-                else
-                    screenshot = await latest(browser, sessionId, screenshot);
-                if (isStopped())
-                    return;
-                setLook({ session, ended: false, screenshot });
-                timer = setTimeout(() => void follow(), POLL_MS);
-            }
-            catch {
-                if (!isStopped())
-                    setLook((old) => ({ ...old, ended: true }));
-            }
-        };
-        void follow();
-        return () => {
-            stopped = true;
-            clearTimeout(timer);
-            forget();
-        };
-    }, [browser, sessionId, knownLiveUrl, streamed]);
-    return look;
-}
-/** A new screenshot as an object URL, the old one released; the old one stays if this fails. */
-async function latest(browser, sessionId, old) {
-    try {
-        const bytes = (await browser.screenshot(sessionId)).slice(); // a copy over a plain ArrayBuffer, which Blob takes
-        const picture = URL.createObjectURL(new Blob([bytes], { type: "image/png" }));
-        if (old)
-            URL.revokeObjectURL(old);
-        return picture;
-    }
-    catch {
-        return old;
-    }
-}

package/dist/builder/BuilderChat.d.ts

@@ -1,32 +0,0 @@
-import type { ReactNode } from "react";
-import type { AppDirectory } from "../request/types.js";
-import { type BlockRenderers } from "./BuilderTranscript.js";
-export interface BuilderChatProps {
-    /** The agent the owner is shaping. */
-    agentId: string;
-    /** The conversation to show; none starts a new one with the first message. */
-    sessionId?: string | null | undefined;
-    /** A conversation started here got its id: keep it to show the same one next time. */
-    onSession?: ((sessionId: string) => void) | undefined;
-    /** The model a conversation started here runs on; none is the deployment's default. */
-    model?: string | null | undefined;
-    /** How the host's apps look and are called, for the cards about one. */
-    apps?: AppDirectory | undefined;
-    /** How to draw the blocks that are only content, the host's way. */
-    renderers?: Partial<BlockRenderers> | undefined;
-    /** What to show before anything is said; a short invitation by default. */
-    empty?: ReactNode;
-    autoFocus?: boolean | undefined;
-    className?: string | undefined;
-}
-/**
- * The chat of the owner who shapes the agent (ADR 0009): their messages, what the builder says
- * and does as it works, the surfaces it shows, and the cards it asks them to answer, in place.
- * A turn streams as it happens and can be stopped; reopening a conversation replays it exactly
- * as it was, with the cards still waiting for an answer.
- *
- * It reaches the builder through the provider's client (`build.sessions`, `requests`). Hosts
- * that draw the conversation their own way build it from `useBuildSession`, `BuilderTranscript`,
- * `StatusLine` and `Composer`, which this is made of.
- */
-export declare function BuilderChat(props: BuilderChatProps): import("react").JSX.Element;

package/dist/builder/BuilderChat.js

@@ -1,41 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Composer } from "../chat/Composer.js";
-import { useStickToBottom } from "../chat/useStickToBottom.js";
-import { ErrorText } from "../parts/Input.js";
-import { Spinner } from "../parts/Spinner.js";
-import { Scoped, useMessages, useParts } from "../SignalcoreProvider.js";
-import { BuilderTranscript } from "./BuilderTranscript.js";
-import { StatusLine } from "./StatusLine.js";
-import { formatDuration } from "./time.js";
-import { useBuildSession } from "./useBuildSession.js";
-/**
- * The chat of the owner who shapes the agent (ADR 0009): their messages, what the builder says
- * and does as it works, the surfaces it shows, and the cards it asks them to answer, in place.
- * A turn streams as it happens and can be stopped; reopening a conversation replays it exactly
- * as it was, with the cards still waiting for an answer.
- *
- * It reaches the builder through the provider's client (`build.sessions`, `requests`). Hosts
- * that draw the conversation their own way build it from `useBuildSession`, `BuilderTranscript`,
- * `StatusLine` and `Composer`, which this is made of.
- */
-export function BuilderChat(props) {
-    return (_jsx(Scoped, { children: _jsx(Conversation, { ...props }) }));
-}
-function Conversation({ agentId, sessionId, onSession, model, apps, renderers, empty, autoFocus, className, }) {
-    const part = useParts();
-    const messages = useMessages();
-    const session = useBuildSession({ agentId, sessionId, onSession, model });
-    const { scroller, content } = useStickToBottom();
-    const { transcript, loading, error } = session;
-    const nothingYet = !loading && transcript.blocks.length === 0;
-    const { lastTurn } = transcript;
-    return (_jsxs("section", { ...part("chat", [], className), "aria-label": messages.builderChat, 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, {}), " ", messages.loadingConversation] })), nothingYet && (empty ?? _jsx(Invitation, {})), _jsx(BuilderTranscript, { blocks: transcript.blocks, live: transcript.live, agentId: agentId, onAnswered: (message) => void session.send(message), apps: apps, renderers: renderers }), !transcript.live && lastTurn && (_jsx("p", { ...part("chat__note"), title: lastTurn.costUsd === null
-                                ? undefined
-                                : messages.turnCost(lastTurn.costUsd.toFixed(3)), children: messages.turnDone(lastTurn.ok, formatDuration(lastTurn.durationMs)) })), error && _jsx(ErrorText, { children: messages.cannotLoadConversation })] }) }), _jsx(StatusLine, { transcript: transcript }), _jsx(Composer, { onSend: (text) => void session.send(text), onStop: session.stop, live: transcript.live, disabled: loading, autoFocus: autoFocus, placeholder: nothingYet ? messages.describeYourAgent : messages.replyOrAskForChange })] }));
-}
-/** What the owner sees in a conversation that has not begun. */
-function Invitation() {
-    const part = useParts();
-    const messages = useMessages();
-    return (_jsxs("div", { ...part("chat__note", ["invitation"]), children: [_jsx("p", { children: _jsx("strong", { children: messages.builderEmptyTitle }) }), _jsx("p", { children: messages.builderEmptyBody })] }));
-}

package/dist/builder/BuilderTranscript.d.ts

@@ -1,49 +0,0 @@
-import type { ComponentType, ReactNode } from "react";
-import type { AppDirectory } from "../request/types.js";
-import type { Block } from "../stream/builder.js";
-import { type StepBlock } from "./items.js";
-type Of<Kind extends Block["kind"]> = Extract<Block, {
-    kind: Kind;
-}>;
-/**
- * How a host draws the blocks that are only content, its own way (Markdown for the builder's
- * words, a card that activates a change). The cards and the surfaces are not here: those the
- * platform draws, so the owner's decisions look and behave the same everywhere.
- */
-export interface BlockRenderers {
-    owner: (block: Of<"owner">) => ReactNode;
-    text: (block: Of<"text">) => ReactNode;
-    steps: (steps: StepBlock[]) => ReactNode;
-    published: (block: Of<"published">) => ReactNode;
-    changes: (block: Of<"changes">) => ReactNode;
-    error: (block: Of<"error">) => ReactNode;
-}
-export interface BuilderTranscriptProps {
-    blocks: Block[];
-    /** A turn is streaming: nothing can be answered until it ends. */
-    live: boolean;
-    /** The agent being shaped; it is the one a card belongs to when the card does not say. */
-    agentId?: string | undefined;
-    /**
-     * The owner answered a card or picked on a surface. The card has already sent the answer to
-     * the API; this tells the builder in the owner's words, as their next message.
-     */
-    onAnswered: (message: string) => void;
-    /** How the host's apps look and are called, for the cards about one. */
-    apps?: AppDirectory | undefined;
-    renderers?: Partial<BlockRenderers> | undefined;
-    /** Wraps each block as it appears, for a host that animates entrances. */
-    Item?: ComponentType<{
-        children: ReactNode;
-    }> | undefined;
-    className?: string | undefined;
-}
-/**
- * The conversation with the builder as the owner reads it: their messages, the builder's words,
- * what it did as one list of steps, the surfaces it showed, the cards it asked them to answer
- * and what changed. Only the latest surface takes a pick, and only between turns; older ones
- * are a record. The browser the owner should be watching (the last one shown, while something
- * happens in it) is the one that is told it is in play.
- */
-export declare function BuilderTranscript(props: BuilderTranscriptProps): import("react").JSX.Element;
-export {};

package/dist/builder/BuilderTranscript.js

@@ -1,62 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { RequestCard } from "../request/RequestCard.js";
-import { Scoped, useParts } from "../SignalcoreProvider.js";
-import { Surface } from "../surface/Surface.js";
-import { answerMessage } from "./answer.js";
-import { Changes, Failure, OwnerMessage, Published, Reply, Steps } from "./blocks.js";
-import { itemsOf, showsBrowser } from "./items.js";
-const DEFAULT_RENDERERS = {
-    owner: (block) => _jsx(OwnerMessage, { block: block }),
-    text: (block) => _jsx(Reply, { block: block }),
-    steps: (steps) => _jsx(Steps, { steps: steps }),
-    published: (block) => _jsx(Published, { block: block }),
-    changes: (block) => _jsx(Changes, { block: block }),
-    error: (block) => _jsx(Failure, { block: block }),
-};
-const EVERY_ITEM = ({ children }) => children;
-/**
- * The conversation with the builder as the owner reads it: their messages, the builder's words,
- * what it did as one list of steps, the surfaces it showed, the cards it asked them to answer
- * and what changed. Only the latest surface takes a pick, and only between turns; older ones
- * are a record. The browser the owner should be watching (the last one shown, while something
- * happens in it) is the one that is told it is in play.
- */
-export function BuilderTranscript(props) {
-    return (_jsx(Scoped, { children: _jsx(Transcript, { ...props }) }));
-}
-function Transcript({ blocks, live, agentId, onAnswered, apps, renderers, Item = EVERY_ITEM, className, }) {
-    const part = useParts();
-    const draw = { ...DEFAULT_RENDERERS, ...renderers };
-    const items = itemsOf(blocks);
-    const latestSurface = items.findLast((item) => item.kind === "surface")?.id;
-    const inView = items.findLast(showsBrowser)?.id;
-    const render = (item) => {
-        switch (item.kind) {
-            case "owner":
-                return draw.owner(item);
-            case "text":
-                return draw.text(item);
-            case "steps":
-                return draw.steps(item.steps);
-            case "published":
-                return draw.published(item);
-            case "changes":
-                return draw.changes(item);
-            case "error":
-                return draw.error(item);
-            case "card": {
-                const card = item.card.agent_id || !agentId ? item.card : { ...item.card, agent_id: agentId };
-                return (_jsx(RequestCard, { card: card, busy: live, inView: item.id === inView, apps: apps, onResolve: (resolution) => {
-                        onAnswered(answerMessage(item.card.title, resolution));
-                    } }));
-            }
-            case "surface":
-                return (_jsx(Surface, { surface: item.surface, active: item.id === inView && live, onAction: item.id === latestSurface && !live
-                        ? (action) => {
-                            onAnswered(action.label);
-                        }
-                        : undefined }));
-        }
-    };
-    return (_jsx("div", { ...part("transcript", [], className), children: items.map((item) => (_jsx(Item, { children: render(item) }, item.id))) }));
-}

package/dist/builder/StatusLine.d.ts

@@ -1,8 +0,0 @@
-import type { Transcript } from "../stream/builder.js";
-/**
- * What the builder is doing right now, in one quiet line: "Editar app.py… 12 s". Empty between
- * turns (and a live region, so it is there to be announced when the next one begins).
- */
-export declare function StatusLine({ transcript }: {
-    transcript: Transcript;
-}): import("react").JSX.Element;

package/dist/builder/StatusLine.js

@@ -1,17 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { Scoped, useMessages, useParts } from "../SignalcoreProvider.js";
-import { useElapsed } from "./time.js";
-import { workingOn } from "./workingOn.js";
-/**
- * What the builder is doing right now, in one quiet line: "Editar app.py… 12 s". Empty between
- * turns (and a live region, so it is there to be announced when the next one begins).
- */
-export function StatusLine({ transcript }) {
-    return (_jsx(Scoped, { children: _jsx(Line, { transcript: transcript }) }));
-}
-function Line({ transcript }) {
-    const part = useParts();
-    const messages = useMessages();
-    const elapsed = useElapsed(transcript.turnStartedAt);
-    return (_jsx("div", { role: "status", ...part("status-line"), children: transcript.live && (_jsxs(_Fragment, { children: [_jsx("span", { "aria-hidden": true, ...part("status-line__dot") }), _jsxs("span", { children: [workingOn(transcript, messages), "\u2026"] }), " ", _jsxs("span", { children: [elapsed, " s"] }), " ", _jsxs("span", { ...part("status-line__hint"), children: [_jsx("kbd", { children: "Esc" }), " ", messages.escToStop] })] })) }));
-}

package/dist/builder/answer.d.ts

@@ -1,7 +0,0 @@
-import type { Resolution } from "../request/types.js";
-/**
- * What the builder hears when the owner answers one of its cards, in the owner's words:
- * "¿Envío? → Aprobado", or "¿Envío? — Rechazado" when it was turned down. The conversation goes
- * on from there as the owner's next message.
- */
-export declare function answerMessage(title: string, { reject, label }: Resolution): string;

package/dist/builder/answer.js

@@ -1,8 +0,0 @@
-/**
- * What the builder hears when the owner answers one of its cards, in the owner's words:
- * "¿Envío? → Aprobado", or "¿Envío? — Rechazado" when it was turned down. The conversation goes
- * on from there as the owner's next message.
- */
-export function answerMessage(title, { reject, label }) {
-    return reject ? `${title} — ${label}` : `${title} → ${label}`;
-}

package/dist/builder/blocks.d.ts

@@ -1,31 +0,0 @@
-import type { Block } from "../stream/builder.js";
-import type { StepBlock } from "./items.js";
-/** The blocks of the conversation that are plain content, in the package's own look. */
-type Of<Kind extends Block["kind"]> = Extract<Block, {
-    kind: Kind;
-}>;
-/** The owner's own message, on their side. */
-export declare const OwnerMessage: import("react").MemoExoticComponent<({ block }: {
-    block: Of<"owner">;
-}) => import("react").JSX.Element>;
-/** What the builder says, with a cursor while it is still writing. */
-export declare const Reply: import("react").MemoExoticComponent<({ block }: {
-    block: Of<"text">;
-}) => import("react").JSX.Element>;
-/** The things the builder did one after another: a mark for how each went, and what it acted on. */
-export declare function Steps({ steps }: {
-    steps: StepBlock[];
-}): import("react").JSX.Element;
-/** "Publicado · versión 3 — Resumen de citas". */
-export declare function Published({ block }: {
-    block: Of<"published">;
-}): import("react").JSX.Element;
-/** How a turn ends: what it built or changed, and what it learned, in one glance. */
-export declare const Changes: import("react").MemoExoticComponent<({ block }: {
-    block: Of<"changes">;
-}) => import("react").JSX.Element>;
-/** Something went wrong in the turn. */
-export declare function Failure({ block }: {
-    block: Of<"error">;
-}): import("react").JSX.Element;
-export {};

package/dist/builder/blocks.js

@@ -1,74 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { memo, useState } from "react";
-import { Icon } from "../parts/Icon.js";
-import { ErrorText } from "../parts/Input.js";
-import { Spinner } from "../parts/Spinner.js";
-import { useMessages, useParts } from "../SignalcoreProvider.js";
-import { describeStep } from "./steps.js";
-/** The owner's own message, on their side. */
-export const OwnerMessage = memo(function OwnerMessage({ block }) {
-    const part = useParts();
-    return (_jsx("div", { ...part("message", ["person"]), children: _jsx("p", { ...part("message__text"), children: block.text }) }));
-});
-/** What the builder says, with a cursor while it is still writing. */
-export const Reply = memo(function Reply({ block }) {
-    const part = useParts();
-    return (_jsxs("p", { ...part("reply"), children: [block.text, block.open && _jsx("span", { "aria-hidden": true, ...part("reply__cursor") })] }));
-});
-/** The things the builder did one after another: a mark for how each went, and what it acted on. */
-export function Steps({ steps }) {
-    const part = useParts();
-    return (_jsx("ol", { ...part("activity"), children: steps.map((step) => (_jsx(StepRow, { step: step }, step.id))) }));
-}
-const StepRow = memo(function StepRow({ step }) {
-    const part = useParts();
-    const messages = useMessages();
-    const [expanded, setExpanded] = useState(false);
-    const label = describeStep(step.name, step.input, messages);
-    const detail = step.summary ?? "";
-    const head = (_jsxs(_Fragment, { children: [_jsx("span", { ...part("activity__mark", [step.status]), children: _jsx(Mark, { status: step.status }) }), _jsx("span", { ...part("activity__verb"), children: label.verb }), label.target && (_jsx("span", { ...part("activity__target", [
-                    label.code && "code",
-                    step.status === "stopped" && "struck",
-                ]), children: label.target })), step.status === "error" && (_jsx("span", { ...part("activity__note", ["danger"]), children: messages.stepFailed })), step.status === "stopped" && _jsx("span", { ...part("activity__note"), children: messages.stepStopped })] }));
-    return (_jsxs("li", { ...part("activity__step", [step.status]), children: [detail ? (_jsx("button", { type: "button", "aria-expanded": expanded, title: messages.stepDetail, ...part("activity__toggle"), onClick: () => {
-                    setExpanded((now) => !now);
-                }, children: head })) : (_jsx("div", { ...part("activity__toggle", ["static"]), children: head })), expanded && detail && _jsx("pre", { ...part("activity__summary"), children: detail })] }));
-});
-/** How a step stands: working, done, failed or stopped. */
-function Mark({ status }) {
-    if (status === "running")
-        return _jsx(Spinner, {});
-    if (status === "ok")
-        return _jsx(Icon, { name: "check" });
-    if (status === "error")
-        return _jsx(Icon, { name: "x" });
-    return null;
-}
-/** "Publicado · versión 3 — Resumen de citas". */
-export function Published({ block }) {
-    const part = useParts();
-    const messages = useMessages();
-    return (_jsxs("p", { ...part("note", ["ok"]), children: [_jsx(Icon, { name: "check" }), _jsxs("span", { children: [_jsx("strong", { children: messages.published(block.version) }), block.summary && ` — ${block.summary}`] })] }));
-}
-const SHOWN_LEARNED = 3;
-function verbOf(item, messages) {
-    if (item.change === "added") {
-        return item.what === "skill" ? messages.newSkill : messages.newAutomation;
-    }
-    return item.change === "changed" ? messages.changedPart : messages.removedPart;
-}
-/** How a turn ends: what it built or changed, and what it learned, in one glance. */
-export const Changes = memo(function Changes({ block }) {
-    const part = useParts();
-    const messages = useMessages();
-    const [all, setAll] = useState(false);
-    const facts = all ? block.learned : block.learned.slice(0, SHOWN_LEARNED);
-    const hidden = block.learned.length - SHOWN_LEARNED;
-    return (_jsxs("div", { ...part("changes"), children: [_jsx("p", { ...part("changes__title"), children: block.change?.description ?? messages.whatChanged }), _jsxs("ul", { ...part("changes__list"), children: [block.items.map((item) => (_jsxs("li", { ...part("changes__item", [item.change]), children: [_jsxs("span", { ...part("changes__label"), children: [verbOf(item, messages), ":"] }), " ", item.title] }, `${item.what}:${item.id}`))), facts.map((fact) => (_jsxs("li", { ...part("changes__item", ["learned"]), children: [_jsx("span", { ...part("changes__label"), children: messages.learned }), " ", fact] }, fact)))] }), hidden > 0 && !all && (_jsx("button", { type: "button", ...part("changes__more"), onClick: () => {
-                    setAll(true);
-                }, children: messages.moreRows(hidden) }))] }));
-});
-/** Something went wrong in the turn. */
-export function Failure({ block }) {
-    return _jsx(ErrorText, { children: block.message });
-}

package/dist/builder/items.d.ts

@@ -1,15 +0,0 @@
-import type { Block } from "../stream/builder.js";
-/** A step of the builder's turn: one thing it did. */
-export type StepBlock = Extract<Block, {
-    kind: "step";
-}>;
-/** What the transcript draws: blocks, with the steps that follow one another as one list. */
-export type Item = Exclude<Block, StepBlock> | {
-    kind: "steps";
-    id: string;
-    steps: StepBlock[];
-};
-/** Consecutive steps read as one list. */
-export declare function itemsOf(blocks: readonly Block[]): Item[];
-/** Something the owner should be looking at in a browser: its surface, or the hand-over card. */
-export declare function showsBrowser(item: Item): boolean;

package/dist/builder/items.js

@@ -1,21 +0,0 @@
-/** Consecutive steps read as one list. */
-export function itemsOf(blocks) {
-    const items = [];
-    for (const block of blocks) {
-        const last = items.at(-1);
-        if (block.kind !== "step")
-            items.push(block);
-        else if (last?.kind === "steps")
-            last.steps = [...last.steps, block];
-        else
-            items.push({ kind: "steps", id: `steps-${block.id}`, steps: [block] });
-    }
-    return items;
-}
-/** Something the owner should be looking at in a browser: its surface, or the hand-over card. */
-export function showsBrowser(item) {
-    if (item.kind === "surface") {
-        return item.surface.components.some((component) => component.component === "Browser");
-    }
-    return item.kind === "card" && item.card.kind === "question" && "browser" in item.card.payload;
-}

package/dist/builder/steps.d.ts

@@ -1,20 +0,0 @@
-/**
- * How a builder step reads in the chat: a short verb and what it acted on.
- * "Editar app.py", "Buscar apps “hubspot”", "Preguntarte: ¿Cuál es tu horario?".
- */
-import type { Messages } from "../messages/index.js";
-/** The kind of work a step is, for a host that draws a mark for each. */
-export type StepIcon = "read" | "write" | "edit" | "search" | "web" | "check" | "run" | "publish" | "settings" | "ask" | "memory" | "app" | "tool";
-export interface StepLabel {
-    verb: string;
-    target?: string;
-    icon: StepIcon;
-    /** The target is code-like (a path, a command) and reads best in monospace. */
-    code?: boolean;
-}
-/**
- * In the language of `messages`, which a component takes from `useMessages()`; Spanish without it.
- */
-export declare function describeStep(name: string, input: Record<string, unknown>, messages?: Messages): StepLabel;
-/** googlecalendar → Google Calendar, google_calendar → Google Calendar */
-export declare function appName(slug: string | undefined): string | undefined;

package/dist/builder/steps.js

@@ -1,120 +0,0 @@
-/**
- * How a builder step reads in the chat: a short verb and what it acted on.
- * "Editar app.py", "Buscar apps “hubspot”", "Preguntarte: ¿Cuál es tu horario?".
- */
-import { es } from "../messages/es.js";
-/**
- * In the language of `messages`, which a component takes from `useMessages()`; Spanish without it.
- */
-export function describeStep(name, input, messages = es) {
-    const { verbs } = messages;
-    const str = (key) => {
-        const value = input[key];
-        return typeof value === "string" && value.trim() ? value.trim() : undefined;
-    };
-    const file = str("file_path") ?? str("path");
-    const at = (label, target) => target === undefined ? label : { ...label, target };
-    switch (name) {
-        case "Read":
-            return at({ verb: verbs.read, icon: "read", code: true }, file && basename(file));
-        case "Write":
-            return at({ verb: verbs.write, icon: "write", code: true }, file && basename(file));
-        case "Edit":
-        case "MultiEdit":
-            return at({ verb: verbs.edit, icon: "edit", code: true }, file && basename(file));
-        case "Bash":
-            return at({ verb: verbs.run, icon: "run", code: true }, str("command"));
-        case "Glob":
-            return at({ verb: verbs.findFiles, icon: "search", code: true }, str("pattern"));
-        case "Grep":
-            return at({ verb: verbs.searchCode, icon: "search", code: true }, str("pattern"));
-        case "WebSearch":
-            return at({ verb: verbs.searchWeb, icon: "web" }, quote(str("query")));
-        case "WebFetch":
-            return at({ verb: verbs.read, icon: "web" }, host(str("url")));
-        case "get_files":
-            return { verb: verbs.readAgentCode, icon: "read" };
-        case "save_files":
-            return at({ verb: verbs.save, icon: "write", code: true }, savedFiles(input, messages));
-        case "check":
-            return { verb: verbs.checkAgent, icon: "check" };
-        case "browse":
-            return at({ verb: verbs.browse, icon: "web" }, quote(str("goal")));
-        case "configure":
-            return { verb: verbs.saveSettings, icon: "settings" };
-        case "ask_owner":
-            return at({ verb: verbs.askYou, icon: "ask" }, str("title"));
-        case "remember":
-            return at({ verb: verbs.remember, icon: "memory" }, str("content"));
-        case "list_connections":
-            return { verb: verbs.checkApps, icon: "app" };
-        case "search_apps":
-            return at({ verb: verbs.searchApps, icon: "search" }, quote(str("query")));
-        case "connect_app":
-            return at({ verb: verbs.connect, icon: "app" }, appName(str("app")));
-        case "app_actions":
-            return at({ verb: verbs.explore, icon: "app" }, appName(str("app")));
-        case "use_app":
-            return at({ verb: appName(str("app")) ?? verbs.useApp, icon: "app" }, humanize(str("action")));
-        case "give_agent_app":
-            return at({ verb: verbs.giveAccess, icon: "app" }, appName(str("app")));
-        default:
-            // A tool the owner has no word for: say what kind of work it is, not its name.
-            return { verb: verbs.workOnAgent, icon: "tool" };
-    }
-}
-const basename = (path) => path.split(/[\\/]/).at(-1) ?? path;
-const quote = (text) => text && `“${text}”`;
-/** "app.py, test_app.py" for a save; "3 archivos" when there are many. */
-function savedFiles(input, messages) {
-    const files = input["files"];
-    const removed = input["removed"];
-    const paths = [
-        ...(files && typeof files === "object" ? Object.keys(files) : []),
-        ...(Array.isArray(removed) ? removed.filter((p) => typeof p === "string") : []),
-    ];
-    if (paths.length === 0)
-        return undefined;
-    return paths.length > 2 ? messages.files(paths.length) : paths.map(basename).join(", ");
-}
-function host(url) {
-    if (!url)
-        return undefined;
-    try {
-        return new URL(url).host;
-    }
-    catch {
-        return url;
-    }
-}
-// How brands write themselves (mirrors signalcore_domain.agents.describe).
-const BRANDS = {
-    calcom: "Cal.com",
-    gmail: "Gmail",
-    googlecalendar: "Google Calendar",
-    googledrive: "Google Drive",
-    googlesheets: "Google Sheets",
-    hubspot: "HubSpot",
-    microsoftteams: "Microsoft Teams",
-    woocommerce: "WooCommerce",
-};
-/** googlecalendar → Google Calendar, google_calendar → Google Calendar */
-export function appName(slug) {
-    if (!slug)
-        return undefined;
-    const brand = BRANDS[slug.toLowerCase().replace(/[_\s-]+/g, "")];
-    if (brand)
-        return brand;
-    return slug
-        .split(/[_\s-]+/)
-        .filter(Boolean)
-        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
-        .join(" ");
-}
-/** HUBSPOT_LIST_CONTACTS → list contacts (the app name is shown already). */
-function humanize(action) {
-    if (!action)
-        return undefined;
-    const words = action.toLowerCase().split("_");
-    return (words.length > 1 ? words.slice(1) : words).join(" ");
-}

package/dist/builder/time.d.ts

@@ -1,4 +0,0 @@
-/** Whole seconds since `since`, ticking while it is set. */
-export declare function useElapsed(since: number | null | undefined): number;
-/** "12 s", "2 min 5 s". */
-export declare function formatDuration(ms: number): string;

package/dist/builder/time.js

@@ -1,24 +0,0 @@
-import { useEffect, useState } from "react";
-/** Whole seconds since `since`, ticking while it is set. */
-export function useElapsed(since) {
-    const [now, setNow] = useState(() => Date.now());
-    useEffect(() => {
-        if (since == null)
-            return undefined;
-        const timer = setInterval(() => {
-            setNow(Date.now());
-        }, 1000);
-        return () => {
-            clearInterval(timer);
-        };
-    }, [since]);
-    return since == null ? 0 : Math.max(0, Math.floor((now - since) / 1000));
-}
-/** "12 s", "2 min 5 s". */
-export function formatDuration(ms) {
-    const seconds = Math.round(ms / 1000);
-    if (seconds < 60)
-        return `${seconds} s`;
-    const minutes = Math.floor(seconds / 60);
-    return `${minutes} min ${seconds % 60} s`;
-}