@solidxai/core-ui 0.1.18 → 0.1.19-beta.1

package/dist/components/core/solid-agent/SolidAgentChat.tsx

@@ -0,0 +1,451 @@
+import React, { useCallback, useEffect, useState } from "react";
+import { History, LogOut, Maximize2, Minimize2, Minus, PanelRight, Plus, Sparkles, Trash2, WifiOff, X } from "lucide-react";
+import styles from "./SolidAgent.module.css";
+import { agentModeChanged, agentPrefillConsumed } from "../../../redux/features/agentSlice";
+import { deleteSession, fetchAgentConfigVersionStatus, fetchAgentModelAssignments, fetchSessionList, type AgentSessionSummary } from "./client/agentRest";
+import { AgentThread } from "./thread/AgentThread";
+import { AgentComposer } from "./composer/AgentComposer";
+import type { AgentAttachment, AgentMode, AgentRuntimeType } from "./types";
+import type { AgentInputContext } from "./useAdminInputContext";
+import { useAgentChat } from "./useAgentChat";
+import { useAgentAuth } from "./useAgentAuth";
+import { AgentSignIn } from "./AgentSignIn";
+import { signOutOfAgent } from "./client/agentAuth";
+import { AgentModelIndicator } from "./AgentModelIndicator";
+import type { AgentModelAssignments } from "./types";
+import type { AgentInputDefinition } from "./embed/agentEmbedProtocol";
+import { SolidButton } from "../../shad-cn-ui/SolidButton";
+import { SolidDialog, SolidDialogBody } from "../../shad-cn-ui/SolidDialog";
+import { SolidInput } from "../../shad-cn-ui/SolidInput";
+
+type Props = {
+    agentUrl: string;
+    title?: string;
+    /** Which agent backend `agentUrl` belongs to (default "solidx", shared with the launcher). */
+    agentRuntime?: AgentRuntimeType;
+    inputContext?: AgentInputContext;
+    inputs?: Record<string, unknown>;
+    requiredInputs?: AgentInputDefinition[];
+    externalEmbed?: boolean;
+    onInputsLocked?: (locked: boolean) => void;
+    /** Rendered inside a page (tab/form widget) instead of the floating window: no window controls. */
+    embedded?: boolean;
+    /** Only one mounted chat should act on SDK prefill requests; the floating window does by default. */
+    handlesPrefill?: boolean;
+    suggestions?: string[];
+    /** Controlled window actions for an embedded chat rendered in a modal. */
+    windowControls?: {
+        mode: "docked" | "maximized";
+        onDock: () => void;
+        onMaximize: () => void;
+        onRestore: () => void;
+        onClose: () => void;
+    };
+};
+
+const DEFAULT_SUGGESTIONS = [
+    "What can you help me with in this app?",
+    "Show me the models in this module",
+    "Explain what this screen does",
+];
+
+const AGENT_HUB_DEFAULT_SUGGESTIONS = [
+    "What can you help me with?",
+    "What tools can you use?",
+    "Summarize your capabilities",
+];
+
+function formatDate(iso: string | null) {
+    if (!iso) return "";
+    const date = new Date(iso);
+    const days = Math.floor((Date.now() - date.getTime()) / 86_400_000);
+    if (days === 0) return date.toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" });
+    if (days === 1) return "Yesterday";
+    if (days < 7) return date.toLocaleDateString([], { weekday: "short" });
+    return date.toLocaleDateString([], { month: "short", day: "numeric" });
+}
+
+function parseInputValues(fields: AgentInputDefinition[], rawValues: Record<string, string>): { values?: Record<string, unknown>; error?: string } {
+    const values: Record<string, unknown> = {};
+    for (const field of fields) {
+        const raw = rawValues[field.name] ?? "";
+        if (field.dataType === "boolean") {
+            if (raw !== "true" && raw !== "false") return { error: `Choose true or false for “${field.name}”.` };
+            values[field.name] = raw === "true";
+            continue;
+        }
+        if (!raw.trim()) return { error: `Enter a value for “${field.name}”.` };
+        if (field.dataType === "number" || field.dataType === "integer") {
+            const value = Number(raw);
+            if (!Number.isFinite(value) || (field.dataType === "integer" && !Number.isSafeInteger(value))) {
+                return { error: `Enter a valid ${field.dataType} for “${field.name}”.` };
+            }
+            values[field.name] = value;
+            continue;
+        }
+        if (field.dataType === "object" || field.dataType === "array") {
+            try {
+                const value: unknown = JSON.parse(raw);
+                if (field.dataType === "object" && (!value || typeof value !== "object" || Array.isArray(value))) throw new Error();
+                if (field.dataType === "array" && !Array.isArray(value)) throw new Error();
+                values[field.name] = value;
+            } catch {
+                return { error: `Enter valid JSON ${field.dataType === "array" ? "array" : "object"} for “${field.name}”.` };
+            }
+            continue;
+        }
+        if (field.dataType === "date" && (Number.isNaN(Date.parse(raw)) || new Date(raw).toISOString().slice(0, 10) !== raw)) {
+            return { error: `Enter a valid date for “${field.name}”.` };
+        }
+        if (field.dataType === "datetime" && Number.isNaN(Date.parse(raw))) {
+            return { error: `Enter a valid date and time for “${field.name}”.` };
+        }
+        values[field.name] = raw;
+    }
+    return { values };
+}
+
+export function SolidAgentChat({
+    agentUrl,
+    title = "SolidX Agent",
+    agentRuntime = "solidx",
+    inputContext = {},
+    inputs,
+    requiredInputs = [],
+    externalEmbed = false,
+    onInputsLocked,
+    embedded = false,
+    // SDK prefill goes through the shared "solidx" conversation only.
+    handlesPrefill = !embedded && agentRuntime === "solidx",
+    suggestions,
+    windowControls,
+}: Props) {
+    const { agent, dispatch, runtime } = useAgentChat(agentRuntime, agentUrl, externalEmbed);
+    // Agent login (API key → agentToken in sessionStorage); the chat is usable once signed in.
+    const agentAuth = useAgentAuth(agentUrl, agentRuntime === "agentHub");
+    const signedIn = agentAuth.status === "signedIn";
+    const signedInAs = agentAuth.auth?.user?.email ?? agentAuth.auth?.user?.username;
+    const emptyStateSuggestions = suggestions ?? (agentRuntime === "agentHub" ? AGENT_HUB_DEFAULT_SUGGESTIONS : DEFAULT_SUGGESTIONS);
+
+    const [showHistory, setShowHistory] = useState(false);
+    const [sessions, setSessions] = useState<AgentSessionSummary[]>([]);
+    const [seed, setSeed] = useState<{ text: string; key: number } | null>(null);
+    const [staleAgentConfig, setStaleAgentConfig] = useState(false);
+    const [modelAssignments, setModelAssignments] = useState<AgentModelAssignments | null>(null);
+    const [collectedInputs, setCollectedInputs] = useState<Record<string, unknown> | null>(null);
+    const [rawInputValues, setRawInputValues] = useState<Record<string, string>>({});
+    const [inputError, setInputError] = useState("");
+    const shouldPromptForInputs = !externalEmbed && agentRuntime === "agentHub" && signedIn
+        && requiredInputs.length > 0 && inputs === undefined && collectedInputs === null;
+    const messageInputs = inputs ?? collectedInputs ?? undefined;
+
+    const submitRequiredInputs = (event: React.FormEvent<HTMLFormElement>) => {
+        event.preventDefault();
+        const result = parseInputValues(requiredInputs, rawInputValues);
+        if (!result.values) {
+            setInputError(result.error ?? "Check the input values and try again.");
+            return;
+        }
+        setCollectedInputs(result.values);
+    };
+
+    useEffect(() => {
+        if (!signedIn) {
+            setModelAssignments(null);
+            return;
+        }
+        let alive = true;
+        fetchAgentModelAssignments(agentUrl).then((models) => {
+            if (alive) setModelAssignments(models);
+        });
+        return () => { alive = false; };
+    }, [agentUrl, signedIn]);
+
+    useEffect(() => {
+        if (agentRuntime !== "agentHub" || !signedIn) {
+            setStaleAgentConfig(false);
+            return;
+        }
+
+        let alive = true;
+        const refreshConfigStatus = async () => {
+            try {
+                const status = await fetchAgentConfigVersionStatus(agentUrl);
+                if (alive && status) setStaleAgentConfig(status.stale);
+            } catch {
+                // Keep the last known status when the agent is temporarily unreachable.
+            }
+        };
+        void refreshConfigStatus();
+        const timer = window.setInterval(() => void refreshConfigStatus(), 30_000);
+        return () => {
+            alive = false;
+            window.clearInterval(timer);
+        };
+    }, [agentRuntime, agentUrl, signedIn]);
+
+    // SDK requests: solidAgent.open({ prompt, autoSend, context }).
+    useEffect(() => {
+        if (!handlesPrefill || !agent.prefill || !runtime) return;
+        const { prompt, autoSend, context, nonce } = agent.prefill;
+        dispatch(agentPrefillConsumed());
+        setShowHistory(false);
+        if (autoSend) runtime.sendMessage(prompt, { ...inputContext, ...(context ?? {}) });
+        else setSeed({ text: prompt, key: nonce });
+    }, [agent.prefill, handlesPrefill, dispatch, runtime, inputContext]);
+
+    useEffect(() => {
+        if (!showHistory || !signedIn) return;
+        let alive = true;
+        fetchSessionList(agentUrl).then((list) => alive && setSessions(list ?? []));
+        return () => {
+            alive = false;
+        };
+    }, [showHistory, agentUrl, signedIn]);
+
+    const setMode = (mode: AgentMode) => dispatch(agentModeChanged(mode));
+    const windowMode = windowControls?.mode ?? agent.mode;
+    const send = useCallback((text: string) => {
+        if (!text.trim() || !runtime) return;
+        onInputsLocked?.(true);
+        return runtime.sendMessage(text, inputContext, [], messageInputs);
+    }, [runtime, inputContext, messageInputs, onInputsLocked]);
+    const sendWithAttachments = useCallback(
+        (text: string, attachments: AgentAttachment[]) => {
+            if ((!text.trim() && !attachments.length) || !runtime) return;
+            onInputsLocked?.(true);
+            return runtime.sendMessage(text, inputContext, attachments, messageInputs);
+        },
+        [runtime, inputContext, messageInputs, onInputsLocked],
+    );
+    const offline = agent.connection === "reconnecting" || agent.connection === "offline";
+    const statusColor = agent.connection === "open" ? (agent.working ? "#eab308" : "#22c55e") : offline ? "#dc2626" : "#94a3b8";
+    const statusText =
+        agentAuth.status === "signedOut" ? "Sign in required"
+        : agent.connection === "open" ? (agent.working ? "Working…" : "Ready")
+        : agent.connection === "connecting" ? "Connecting…"
+        : offline ? "Reconnecting…" : "Idle";
+
+    const empty = (
+        <div className={styles.empty}>
+            <div className={styles.emptyMark}><Sparkles size={24} /></div>
+            <div>
+                <h2 className={styles.emptyTitle}>{agentRuntime === "agentHub" ? `Start a conversation with ${title}` : "How can I help?"}</h2>
+                <p className={styles.emptyText}>{agentRuntime === "agentHub"
+                    ? "Ask this agent for help with its configured capabilities. It can use the tools and knowledge available to it."
+                    : "Ask in plain English. I can read this app's metadata and data, and run the agent's tools for you."}</p>
+            </div>
+            <div className={styles.suggestions}>
+                {emptyStateSuggestions.map((text) => (
+                    <button key={text} type="button" className={styles.suggestion} onClick={() => send(text)}>
+                        {text}
+                    </button>
+                ))}
+            </div>
+        </div>
+    );
+
+    return (
+        <>
+            {shouldPromptForInputs && <SolidDialog
+                open
+                dismissible={!!windowControls}
+                onOpenChange={(open) => { if (!open) windowControls?.onClose(); }}
+                className={styles.inputDialog}
+                overlayClassName={styles.inputDialogOverlay}
+                header="Set up this test run"
+                ariaLabel={`Enter required inputs for ${title}`}
+                style={{ width: "min(34rem, 94vw)" }}
+            >
+                <SolidDialogBody className={styles.inputDialogBody}>
+                    <form className={styles.inputForm} autoComplete="off" onSubmit={submitRequiredInputs}>
+                        <p>Sign-in is complete. Enter the values this agent needs before starting the conversation.</p>
+                        <div className={styles.inputFields}>
+                            {requiredInputs.map((field, index) => {
+                                const id = `solid-agent-test-input-${index}`;
+                                const value = rawInputValues[field.name] ?? "";
+                                const update = (next: string) => {
+                                    setRawInputValues((current) => ({ ...current, [field.name]: next }));
+                                    setInputError("");
+                                };
+                                const inputType = field.dataType === "integer" || field.dataType === "number" ? "number"
+                                    : field.dataType === "datetime" ? "datetime-local"
+                                        : field.dataType === "date" ? "date" : "text";
+                                return <label className={styles.inputField} htmlFor={id} key={`${field.name}-${index}`}>
+                                    <span>{field.name}<small>{field.description || field.dataType}</small></span>
+                                    {field.dataType === "boolean" ? (
+                                        <select id={id} autoComplete="off" value={value} onChange={(event) => update(event.target.value)}>
+                                            <option value="">Choose a value</option><option value="true">True</option><option value="false">False</option>
+                                        </select>
+                                    ) : field.dataType === "object" || field.dataType === "array" ? (
+                                        <textarea id={id} autoComplete="off" value={value} onChange={(event) => update(event.target.value)} placeholder={field.dataType === "array" ? "[ ]" : "{ }"} rows={3} />
+                                    ) : (
+                                        <SolidInput id={id} type={inputType} step={field.dataType === "number" ? "any" : field.dataType === "integer" ? "1" : undefined}
+                                            autoComplete="off" value={value} onChange={(event) => update(event.target.value)} />
+                                    )}
+                                </label>;
+                            })}
+                        </div>
+                        {inputError && <p className={styles.inputError} role="alert">{inputError}</p>}
+                        <div className={styles.inputActions}>
+                            {windowControls && <SolidButton type="button" variant="secondary" onClick={() => windowControls.onClose()}>Cancel</SolidButton>}
+                            <SolidButton type="submit">Start test</SolidButton>
+                        </div>
+                    </form>
+                </SolidDialogBody>
+            </SolidDialog>}
+            <div className={`${styles.header} ${externalEmbed ? styles.externalEmbedHeader : ""}`}>
+                <div className={styles.headerMark}>
+                    <Sparkles size={15} />
+                    <span className={styles.statusDot} style={{ background: statusColor }} />
+                </div>
+                <div className={styles.headerTitle}>
+                    <strong>{title}</strong>
+                    <span className={styles.headerSub}>{statusText}</span>
+                </div>
+                {signedIn && (
+                    <>
+                        <button type="button" className={styles.iconBtn} title="New chat" aria-label="New chat" disabled={agent.working} onClick={() => { runtime?.newChat(); setShowHistory(false); onInputsLocked?.(false); if (!externalEmbed && agentRuntime === "agentHub" && requiredInputs.length && inputs === undefined) { setCollectedInputs(null); setInputError(""); } }}>
+                            <Plus size={16} />
+                        </button>
+                        {!externalEmbed && <button
+                            type="button"
+                            className={styles.iconBtn}
+                            title="History"
+                            aria-label="Chat history"
+                            aria-pressed={showHistory}
+                            onClick={() => setShowHistory((v) => !v)}
+                        >
+                            <History size={16} />
+                        </button>}
+                        {!externalEmbed && <button
+                            type="button"
+                            className={styles.iconBtn}
+                            title={signedInAs ? `Sign out of the agent (${String(signedInAs)})` : "Sign out of the agent"}
+                            aria-label="Sign out of the agent"
+                            onClick={() => { setShowHistory(false); void signOutOfAgent(agentUrl); }}
+                        >
+                            <LogOut size={15} />
+                        </button>}
+                    </>
+                )}
+                {(!embedded || windowControls) && (
+                    <>
+                        {windowMode !== "docked" && (
+                            <button type="button" className={styles.iconBtn} title="Dock to the side" aria-label="Dock to the side" onClick={() => windowControls ? windowControls.onDock() : setMode("docked")}>
+                                <PanelRight size={16} />
+                            </button>
+                        )}
+                        {windowMode === "maximized" ? (
+                            <button type="button" className={styles.iconBtn} title="Restore" aria-label="Restore size" onClick={() => windowControls ? windowControls.onRestore() : setMode("compact")}>
+                                <Minimize2 size={15} />
+                            </button>
+                        ) : (
+                            <button type="button" className={styles.iconBtn} title="Maximize" aria-label="Maximize" onClick={() => windowControls ? windowControls.onMaximize() : setMode("maximized")}>
+                                <Maximize2 size={15} />
+                            </button>
+                        )}
+                        <button type="button" className={styles.iconBtn} title={windowControls ? "Close test agent" : "Minimize (Esc)"} aria-label={windowControls ? "Close test agent" : "Minimize"} onClick={() => windowControls ? windowControls.onClose() : setMode("bubble")}>
+                            {windowControls || windowMode !== "compact" ? <X size={16} /> : <Minus size={16} />}
+                        </button>
+                    </>
+                )}
+            </div>
+
+            {agentAuth.status === "checking" ? (
+                externalEmbed
+                    ? <div className={styles.embedWait} role="status" aria-live="polite"><div className={styles.embedWaitCard}><span className={styles.embedSpinner} aria-hidden="true" /><strong>Please wait</strong><span>Checking your connection</span></div></div>
+                    : <div style={{ flex: "1 1 auto" }} />
+            ) : agentAuth.status === "signedOut" ? (
+                // The agent forgot the token (expired/restarted) if it already reported an auth error.
+                externalEmbed ? <div className={styles.embedWait} role="status" aria-live="polite"><div className={styles.embedWaitCard}><span className={styles.embedSpinner} aria-hidden="true" /><strong>Please wait</strong><span>Connecting to your agent</span></div></div>
+                    : <AgentSignIn agentUrl={agentUrl} expired={!!agent.authError} />
+            ) : (
+                <>
+                {externalEmbed && agent.connection !== "open" && (
+                    <div className={styles.embedWait} role="status" aria-live="polite">
+                        <div className={styles.embedWaitCard}>
+                            <span className={styles.embedSpinner} aria-hidden="true" />
+                            <strong>Please wait</strong>
+                            <span>{offline ? "Reconnecting to your agent" : "Connecting to your agent"}</span>
+                        </div>
+                    </div>
+                )}
+                {offline && (
+                    <div className={styles.banner} role="status">
+                        <WifiOff size={14} /> Reconnecting to the agent… Your messages will be sent once it is back.
+                    </div>
+                )}
+                {agentRuntime === "agentHub" && staleAgentConfig && (
+                    <div className={styles.banner} role="status">
+                        This session is using an older agent configuration. Ask an administrator to restart the agent, then sign in again to load the latest version.
+                    </div>
+                )}
+                {agent.authError && (
+                    <div className={`${styles.banner} ${styles.bannerError}`} role="alert">
+                        {agent.authError}
+                    </div>
+                )}
+
+                {showHistory ? (
+                    <div className={styles.historyPanel} aria-label="Past conversations">
+                        {sessions.length === 0 && <div className={styles.notice}>No past conversations.</div>}
+                        {sessions.map((session) => (
+                            <div key={session.session_id} style={{ display: "flex", alignItems: "center" }}>
+                                <button
+                                    type="button"
+                                    className={`${styles.historyItem} ${session.session_id === agent.historySessionId ? styles.historyItemActive : ""}`}
+                                    onClick={() => {
+                                        runtime?.resume(session.session_id);
+                                        setShowHistory(false);
+                                    }}
+                                >
+                                    <span className={styles.historyPreview}>{session.preview || "New conversation"}</span>
+                                    <span className={styles.historyDate}>{formatDate(session.created_at)}</span>
+                                </button>
+                                <button
+                                    type="button"
+                                    className={styles.iconBtn}
+                                    aria-label="Delete conversation"
+                                    title="Delete"
+                                    onClick={async () => {
+                                        if (!window.confirm("Delete this conversation?")) return;
+                                        await deleteSession(agentUrl, session.session_id);
+                                        setSessions((prev) => prev.filter((s) => s.session_id !== session.session_id));
+                                        if (session.session_id === agent.historySessionId) runtime?.newChat();
+                                    }}
+                                >
+                                    <Trash2 size={14} />
+                                </button>
+                            </div>
+                        ))}
+                    </div>
+                ) : (
+                    <AgentThread
+                        items={agent.items}
+                        thinking={agent.working && agent.thinking}
+                        working={agent.working}
+                        hasMore={agent.hasMoreHistory}
+                        context={agent.context ?? undefined}
+                        emptyState={empty}
+                        onLoadOlder={() => void runtime?.loadOlder()}
+                        onReply={(widgetId, widget, value) => runtime?.replyToWidget(widgetId, widget, value)}
+                        onPrompt={send}
+                    />
+                )}
+
+                <AgentComposer
+                    working={agent.working}
+                    disabled={!!agent.authError}
+                    commands={agent.commands}
+                    seed={seed?.text}
+                    seedKey={seed?.key}
+                    onSend={sendWithAttachments}
+                    onStop={() => runtime?.cancel()}
+                    modelIndicator={<AgentModelIndicator assignments={modelAssignments} />}
+                />
+                </>
+            )}
+        </>
+    );
+}

package/dist/components/core/solid-agent/SolidAgentEmbedded.d.ts

@@ -0,0 +1,44 @@
+import { type AgentInputContext } from "./useAdminInputContext";
+import type { AgentInputDefinition } from "./embed/agentEmbedProtocol";
+type SharedProps = {
+    title?: string;
+    /** Additional key/value context sent with each message to the agent. */
+    inputContext?: AgentInputContext;
+    /** Values for the AgentHub agent's declared requiredInputs. */
+    inputs?: Record<string, unknown>;
+    /** AgentHub input schema; used by the admin test surface when no values were supplied. */
+    requiredInputs?: AgentInputDefinition[];
+    /** External bootstrap: the standalone route registers credentials for this private URL. */
+    externalEmbed?: {
+        agentUrl: string;
+        onInputsLocked?: (locked: boolean) => void;
+    };
+    /** Container height; the chat fills it. */
+    height?: number | string;
+    suggestions?: string[];
+    className?: string;
+    /** Adds the standard chat window controls with actions managed by the embedding surface. */
+    windowControls?: {
+        mode: "docked" | "maximized";
+        onDock: () => void;
+        onMaximize: () => void;
+        onRestore: () => void;
+        onClose: () => void;
+    };
+};
+type Props = SharedProps & ({
+    /** SolidX runtime (setting solidxAgentBackendUrl); agent ID is optional. */
+    agentRuntime?: "solidx";
+    agentId?: number;
+} | {
+    /** AgentHub runtime (setting solidxAgentHubBackendUrl); an agent ID is required. */
+    agentRuntime: "agentHub";
+    agentId: number;
+});
+/**
+ * The agent chat rendered inside a page (a tab or form widget) instead of the floating window.
+ * With agentRuntime "solidx" it shares the same connection and thread as the launcher.
+ */
+export declare function SolidAgentEmbedded(props: Props): import("react/jsx-runtime").JSX.Element | null;
+export {};
+//# sourceMappingURL=SolidAgentEmbedded.d.ts.map

package/dist/components/core/solid-agent/SolidAgentEmbedded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SolidAgentEmbedded.d.ts","sourceRoot":"","sources":["../../../../src/components/core/solid-agent/SolidAgentEmbedded.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEvE,KAAK,WAAW,GAAG;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,0FAA0F;IAC1F,cAAc,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACxC,2FAA2F;IAC3F,aAAa,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,CAAC;IACjF,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4FAA4F;IAC5F,cAAc,CAAC,EAAE;QACb,IAAI,EAAE,QAAQ,GAAG,WAAW,CAAC;QAC7B,MAAM,EAAE,MAAM,IAAI,CAAC;QACnB,UAAU,EAAE,MAAM,IAAI,CAAC;QACvB,SAAS,EAAE,MAAM,IAAI,CAAC;QACtB,OAAO,EAAE,MAAM,IAAI,CAAC;KACvB,CAAC;CACL,CAAC;AAEF,KAAK,KAAK,GAAG,WAAW,GAAG,CACrB;IACE,4EAA4E;IAC5E,YAAY,CAAC,EAAE,QAAQ,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,GACC;IACE,oFAAoF;IACpF,YAAY,EAAE,UAAU,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACnB,CACJ,CAAC;AAIF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,kDAkC9C"}

package/dist/components/core/solid-agent/SolidAgentEmbedded.js

@@ -0,0 +1,46 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import styles from "./SolidAgent.module.css";
+import { SolidAgentChat } from "./SolidAgentChat";
+import { useAgentAvailability } from "./useAgentAvailability";
+import { withAgentId } from "./client/agentUrls";
+import { useAdminInputContext } from "./useAdminInputContext";
+var AGENT_LABEL = { solidx: "SolidX Agent", agentHub: "AgentHub Agent" };
+/**
+ * The agent chat rendered inside a page (a tab or form widget) instead of the floating window.
+ * With agentRuntime "solidx" it shares the same connection and thread as the launcher.
+ */
+export function SolidAgentEmbedded(props) {
+    var _a, _b, _c, _d, _e;
+    var _f = props.agentRuntime, agentRuntime = _f === void 0 ? "solidx" : _f, agentId = props.agentId, suppliedInputContext = props.inputContext, _g = props.height, height = _g === void 0 ? 560 : _g, suggestions = props.suggestions, className = props.className, windowControls = props.windowControls;
+    var title = (_a = props.title) !== null && _a !== void 0 ? _a : AGENT_LABEL[agentRuntime];
+    var _h = useAgentAvailability(!props.externalEmbed), ready = _h.ready, enabled = _h.enabled, agentUrls = _h.agentUrls, canUse = _h.canUse;
+    var inferredInputContext = useAdminInputContext();
+    var inputContext = props.externalEmbed ? (suppliedInputContext !== null && suppliedInputContext !== void 0 ? suppliedInputContext : {}) : __assign(__assign({}, inferredInputContext), (suppliedInputContext !== null && suppliedInputContext !== void 0 ? suppliedInputContext : {}));
+    if (!props.externalEmbed && !ready)
+        return null;
+    var backendUrl = (_b = agentUrls[agentRuntime]) !== null && _b !== void 0 ? _b : null;
+    // The chat URL names the agent, so each agent has its own login.
+    var agentUrl = (_d = (_c = props.externalEmbed) === null || _c === void 0 ? void 0 : _c.agentUrl) !== null && _d !== void 0 ? _d : (backendUrl ? withAgentId(backendUrl, agentId) : null);
+    if (!props.externalEmbed && (!enabled || !canUse)) {
+        return _jsxs("div", { className: styles.root, style: { padding: 16, color: "var(--solid-agent-muted)" }, children: [title, " is not available for your account."] });
+    }
+    if (agentRuntime === "agentHub" && agentId === undefined) {
+        return _jsxs("div", { className: styles.root, style: { padding: 16, color: "var(--solid-agent-muted)" }, children: ["No agent is selected for the ", AGENT_LABEL[agentRuntime], "."] });
+    }
+    if (!agentUrl) {
+        return (_jsxs("div", { className: styles.root, style: { padding: 16, color: "var(--solid-agent-muted)" }, children: ["No backend URL is configured for the ", AGENT_LABEL[agentRuntime], "."] }));
+    }
+    return (_jsx("div", { className: "".concat(styles.root, " ").concat(className !== null && className !== void 0 ? className : ""), style: { height: height, display: "flex", flexDirection: "column", border: "1px solid var(--solid-agent-border)", borderRadius: 12, overflow: "hidden", background: "var(--solid-agent-bg)" }, children: _jsx(SolidAgentChat, { agentUrl: agentUrl, agentRuntime: agentRuntime, title: title, inputContext: inputContext, inputs: props.inputs, requiredInputs: props.requiredInputs, externalEmbed: !!props.externalEmbed, onInputsLocked: (_e = props.externalEmbed) === null || _e === void 0 ? void 0 : _e.onInputsLocked, embedded: true, suggestions: suggestions, windowControls: windowControls }, agentUrl) }));
+}
+//# sourceMappingURL=SolidAgentEmbedded.js.map

package/dist/components/core/solid-agent/SolidAgentEmbedded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SolidAgentEmbedded.js","sourceRoot":"","sources":["../../../../src/components/core/solid-agent/SolidAgentEmbedded.tsx"],"names":[],"mappings":"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","sourcesContent":["import React from \"react\";\nimport styles from \"./SolidAgent.module.css\";\nimport { SolidAgentChat } from \"./SolidAgentChat\";\nimport { useAgentAvailability } from \"./useAgentAvailability\";\nimport type { AgentRuntimeType } from \"./types\";\nimport { withAgentId } from \"./client/agentUrls\";\nimport { useAdminInputContext, type AgentInputContext } from \"./useAdminInputContext\";\nimport type { AgentInputDefinition } from \"./embed/agentEmbedProtocol\";\n\ntype SharedProps = {\n    title?: string;\n    /** Additional key/value context sent with each message to the agent. */\n    inputContext?: AgentInputContext;\n    /** Values for the AgentHub agent's declared requiredInputs. */\n    inputs?: Record<string, unknown>;\n    /** AgentHub input schema; used by the admin test surface when no values were supplied. */\n    requiredInputs?: AgentInputDefinition[];\n    /** External bootstrap: the standalone route registers credentials for this private URL. */\n    externalEmbed?: { agentUrl: string; onInputsLocked?: (locked: boolean) => void };\n    /** Container height; the chat fills it. */\n    height?: number | string;\n    suggestions?: string[];\n    className?: string;\n    /** Adds the standard chat window controls with actions managed by the embedding surface. */\n    windowControls?: {\n        mode: \"docked\" | \"maximized\";\n        onDock: () => void;\n        onMaximize: () => void;\n        onRestore: () => void;\n        onClose: () => void;\n    };\n};\n\ntype Props = SharedProps & (\n    | {\n        /** SolidX runtime (setting solidxAgentBackendUrl); agent ID is optional. */\n        agentRuntime?: \"solidx\";\n        agentId?: number;\n    }\n    | {\n        /** AgentHub runtime (setting solidxAgentHubBackendUrl); an agent ID is required. */\n        agentRuntime: \"agentHub\";\n        agentId: number;\n    }\n);\n\nconst AGENT_LABEL: Record<AgentRuntimeType, string> = { solidx: \"SolidX Agent\", agentHub: \"AgentHub Agent\" };\n\n/**\n * The agent chat rendered inside a page (a tab or form widget) instead of the floating window.\n * With agentRuntime \"solidx\" it shares the same connection and thread as the launcher.\n */\nexport function SolidAgentEmbedded(props: Props) {\n    const { agentRuntime = \"solidx\", agentId, inputContext: suppliedInputContext, height = 560, suggestions, className, windowControls } = props;\n    const title = props.title ?? AGENT_LABEL[agentRuntime];\n    const { ready, enabled, agentUrls, canUse } = useAgentAvailability(!props.externalEmbed);\n    const inferredInputContext = useAdminInputContext();\n    const inputContext = props.externalEmbed ? (suppliedInputContext ?? {}) : { ...inferredInputContext, ...(suppliedInputContext ?? {}) };\n    if (!props.externalEmbed && !ready) return null;\n    const backendUrl = agentUrls[agentRuntime] ?? null;\n    // The chat URL names the agent, so each agent has its own login.\n    const agentUrl = props.externalEmbed?.agentUrl ?? (backendUrl ? withAgentId(backendUrl, agentId) : null);\n    if (!props.externalEmbed && (!enabled || !canUse)) {\n        return <div className={styles.root} style={{ padding: 16, color: \"var(--solid-agent-muted)\" }}>{title} is not available for your account.</div>;\n    }\n    if (agentRuntime === \"agentHub\" && agentId === undefined) {\n        return <div className={styles.root} style={{ padding: 16, color: \"var(--solid-agent-muted)\" }}>No agent is selected for the {AGENT_LABEL[agentRuntime]}.</div>;\n    }\n    if (!agentUrl) {\n        return (\n            <div className={styles.root} style={{ padding: 16, color: \"var(--solid-agent-muted)\" }}>\n                No backend URL is configured for the {AGENT_LABEL[agentRuntime]}.\n            </div>\n        );\n    }\n    return (\n        <div\n            className={`${styles.root} ${className ?? \"\"}`}\n            style={{ height, display: \"flex\", flexDirection: \"column\", border: \"1px solid var(--solid-agent-border)\", borderRadius: 12, overflow: \"hidden\", background: \"var(--solid-agent-bg)\" }}\n        >\n            {/* key: switching type remounts the chat onto the other backend's conversation. */}\n            <SolidAgentChat key={agentUrl} agentUrl={agentUrl} agentRuntime={agentRuntime} title={title} inputContext={inputContext}\n                inputs={props.inputs} requiredInputs={props.requiredInputs} externalEmbed={!!props.externalEmbed} onInputsLocked={props.externalEmbed?.onInputsLocked}\n                embedded suggestions={suggestions} windowControls={windowControls} />\n        </div>\n    );\n}\n"]}

package/dist/components/core/solid-agent/SolidAgentEmbedded.tsx

@@ -0,0 +1,87 @@
+import React from "react";
+import styles from "./SolidAgent.module.css";
+import { SolidAgentChat } from "./SolidAgentChat";
+import { useAgentAvailability } from "./useAgentAvailability";
+import type { AgentRuntimeType } from "./types";
+import { withAgentId } from "./client/agentUrls";
+import { useAdminInputContext, type AgentInputContext } from "./useAdminInputContext";
+import type { AgentInputDefinition } from "./embed/agentEmbedProtocol";
+
+type SharedProps = {
+    title?: string;
+    /** Additional key/value context sent with each message to the agent. */
+    inputContext?: AgentInputContext;
+    /** Values for the AgentHub agent's declared requiredInputs. */
+    inputs?: Record<string, unknown>;
+    /** AgentHub input schema; used by the admin test surface when no values were supplied. */
+    requiredInputs?: AgentInputDefinition[];
+    /** External bootstrap: the standalone route registers credentials for this private URL. */
+    externalEmbed?: { agentUrl: string; onInputsLocked?: (locked: boolean) => void };
+    /** Container height; the chat fills it. */
+    height?: number | string;
+    suggestions?: string[];
+    className?: string;
+    /** Adds the standard chat window controls with actions managed by the embedding surface. */
+    windowControls?: {
+        mode: "docked" | "maximized";
+        onDock: () => void;
+        onMaximize: () => void;
+        onRestore: () => void;
+        onClose: () => void;
+    };
+};
+
+type Props = SharedProps & (
+    | {
+        /** SolidX runtime (setting solidxAgentBackendUrl); agent ID is optional. */
+        agentRuntime?: "solidx";
+        agentId?: number;
+    }
+    | {
+        /** AgentHub runtime (setting solidxAgentHubBackendUrl); an agent ID is required. */
+        agentRuntime: "agentHub";
+        agentId: number;
+    }
+);
+
+const AGENT_LABEL: Record<AgentRuntimeType, string> = { solidx: "SolidX Agent", agentHub: "AgentHub Agent" };
+
+/**
+ * The agent chat rendered inside a page (a tab or form widget) instead of the floating window.
+ * With agentRuntime "solidx" it shares the same connection and thread as the launcher.
+ */
+export function SolidAgentEmbedded(props: Props) {
+    const { agentRuntime = "solidx", agentId, inputContext: suppliedInputContext, height = 560, suggestions, className, windowControls } = props;
+    const title = props.title ?? AGENT_LABEL[agentRuntime];
+    const { ready, enabled, agentUrls, canUse } = useAgentAvailability(!props.externalEmbed);
+    const inferredInputContext = useAdminInputContext();
+    const inputContext = props.externalEmbed ? (suppliedInputContext ?? {}) : { ...inferredInputContext, ...(suppliedInputContext ?? {}) };
+    if (!props.externalEmbed && !ready) return null;
+    const backendUrl = agentUrls[agentRuntime] ?? null;
+    // The chat URL names the agent, so each agent has its own login.
+    const agentUrl = props.externalEmbed?.agentUrl ?? (backendUrl ? withAgentId(backendUrl, agentId) : null);
+    if (!props.externalEmbed && (!enabled || !canUse)) {
+        return <div className={styles.root} style={{ padding: 16, color: "var(--solid-agent-muted)" }}>{title} is not available for your account.</div>;
+    }
+    if (agentRuntime === "agentHub" && agentId === undefined) {
+        return <div className={styles.root} style={{ padding: 16, color: "var(--solid-agent-muted)" }}>No agent is selected for the {AGENT_LABEL[agentRuntime]}.</div>;
+    }
+    if (!agentUrl) {
+        return (
+            <div className={styles.root} style={{ padding: 16, color: "var(--solid-agent-muted)" }}>
+                No backend URL is configured for the {AGENT_LABEL[agentRuntime]}.
+            </div>
+        );
+    }
+    return (
+        <div
+            className={`${styles.root} ${className ?? ""}`}
+            style={{ height, display: "flex", flexDirection: "column", border: "1px solid var(--solid-agent-border)", borderRadius: 12, overflow: "hidden", background: "var(--solid-agent-bg)" }}
+        >
+            {/* key: switching type remounts the chat onto the other backend's conversation. */}
+            <SolidAgentChat key={agentUrl} agentUrl={agentUrl} agentRuntime={agentRuntime} title={title} inputContext={inputContext}
+                inputs={props.inputs} requiredInputs={props.requiredInputs} externalEmbed={!!props.externalEmbed} onInputsLocked={props.externalEmbed?.onInputsLocked}
+                embedded suggestions={suggestions} windowControls={windowControls} />
+        </div>
+    );
+}