@smarter.sh/ui-chat 0.8.0 → 0.9.1

package/dist/types/src/components/SmarterChat/Component.d.ts

@@ -26,5 +26,5 @@
 import "@chatscope/chat-ui-kit-styles/dist/default/styles.min.css";
 import type { SmarterChatProps } from "@/types";
 import "@/components/SmarterChat/styles.css";
-declare function SmarterChat({ apiUrl, apiKey, toggleMetadata, csrfCookieName, csrftoken, debugCookieName, debugCookieExpiration, debugMode, sessionCookieName, sessionCookieExpiration, showConsole, cookieDomain, smarterRequestId, logStreamUrl, streamProgress, }: SmarterChatProps): import("react").JSX.Element;
+declare function SmarterChat({ apiUrl, apiKey, toggleMetadata, csrfCookieName, csrftoken, debugCookieName, debugCookieExpiration, debugMode, sessionCookieName, sessionCookieExpiration, cookiePath, showConsole, cookieDomain, smarterRequestId, logStreamUrl, streamProgress, }: SmarterChatProps): import("react").JSX.Element;
 export default SmarterChat;

package/dist/types/src/contract.gen.d.ts

@@ -344,7 +344,7 @@ export interface PromptChatApiConfig {
      * The ENABLE_REACTAPP_DEBUG_MODE waffle switch.
      */
     debug_mode: boolean;
-    functions?: PromptChatApiFunctionList | null;
+    extensions?: PromptChatApiExtensionList | null;
     history: PromptChatApiHistory;
     llmclient: PromptChatApiLLMClient;
     meta_data: PromptChatApiMetaData;
@@ -360,56 +360,68 @@ export interface PromptChatApiConfig {
     [k: string]: unknown;
 }
 /**
- * The LLMClient's built-in functions.
+ * The LLMClient's extensions.
  *
  * The list itself is returned only in the complete configuration.
  *
  * This interface was referenced by `SmarterChatAPIContract`'s JSON-Schema
- * via the `definition` "PromptChatApiFunctionList".
+ * via the `definition` "PromptChatApiExtensionList".
  */
-export interface PromptChatApiFunctionList {
-    functions?: PromptChatApiLLMClientFunction[];
+export interface PromptChatApiExtensionList {
+    extensions?: PromptChatApiLLMClientExtension[];
     meta_data: PromptChatApiListMetaData;
     [k: string]: unknown;
 }
 /**
- * A built-in function of the LLMClient: a :class:`smarter.apps.llmclient.models.LLMClientFunctions`.
+ * An extension of the LLMClient: a :class:`smarter.apps.llmclient.models.LLMClientExtensions`.
  *
  * This interface was referenced by `SmarterChatAPIContract`'s JSON-Schema
- * via the `definition` "PromptChatApiLLMClientFunction".
+ * via the `definition` "PromptChatApiLLMClientExtension".
  */
-export interface PromptChatApiLLMClientFunction {
+export interface PromptChatApiLLMClientExtension {
     /**
      * TimestampedModel.created_at.
      */
     created_at?: string | null;
+    /**
+     * Whether the Extension is enabled, so that its tools are offered.
+     */
+    enabled: boolean;
+    /**
+     * LLMClientExtensions.extension: the Extension's id.
+     */
+    extension: number;
     /**
      * The row's primary key.
      */
     id: number;
     /**
-     * LLMClientFunctions.llmclient: the LLMClient's id.
+     * LLMClientExtensions.llmclient: the LLMClient's id.
      */
     llmclient: number;
     /**
-     * LLMClientFunctions.name.
+     * The Extension's slug, e.g. weather.
      */
-    name?: ("get_current_weather" | "date_calculator" | "calculator") | null;
+    name: string;
     /**
      * TimestampedModel.updated_at.
      */
     updated_at?: string | null;
+    /**
+     * The Extension's installed version, e.g. 1.0.0.
+     */
+    version?: string | null;
 }
 /**
- * The counts of a list of the LLMClient's plugins or functions.
+ * The counts of a list of the LLMClient's plugins or extensions.
  *
  * This interface was referenced by `SmarterChatAPIContract`'s JSON-Schema
  * via the `definition` "PromptChatApiListMetaData".
  */
 export interface PromptChatApiListMetaData {
-    functions_returned?: number | null;
+    extensions_returned?: number | null;
     plugins_returned?: number | null;
-    total_functions?: number | null;
+    total_extensions?: number | null;
     total_plugins?: number | null;
     [k: string]: unknown;
 }
@@ -479,7 +491,7 @@ export interface PromptChatApiPromptRequest {
     [k: string]: unknown;
 }
 /**
- * A plugin selector's activation: a :class:`smarter.apps.plugin.models.PluginSelectorHistory`.
+ * A plugin selector's activation: a :class:`smarter.apps.llmtool.models.PluginSelectorHistory`.
  *
  * This interface was referenced by `SmarterChatAPIContract`'s JSON-Schema
  * via the `definition` "PromptChatApiPluginSelection".
@@ -784,7 +796,7 @@ export interface PromptChatApiConfigV1 {
      * The ENABLE_REACTAPP_DEBUG_MODE waffle switch.
      */
     debug_mode: boolean;
-    functions?: PromptChatApiFunctionListV1 | null;
+    extensions?: PromptChatApiExtensionListV1 | null;
     history: PromptChatApiHistoryV1;
     meta_data: PromptChatApiMetaData;
     plugins: PromptChatApiPluginListV1;
@@ -800,41 +812,44 @@ export interface PromptChatApiConfigV1 {
 }
 /**
  * @deprecated
- * The LLMClient's built-in functions, in version 1.
+ * The LLMClient's extensions, in version 1.
  *
  * This interface was referenced by `SmarterChatAPIContract`'s JSON-Schema
- * via the `definition` "PromptChatApiFunctionListV1".
+ * via the `definition` "PromptChatApiExtensionListV1".
  */
-export interface PromptChatApiFunctionListV1 {
-    functions?: PromptChatApiLLMClientFunctionV1[];
+export interface PromptChatApiExtensionListV1 {
+    extensions?: PromptChatApiLLMClientExtensionV1[];
     meta_data: PromptChatApiListMetaData;
     [k: string]: unknown;
 }
 /**
  * @deprecated
- * A built-in function of the LLMClient, in version 1, whose ``llmclient`` is renamed ``chatbot``.
+ * An extension of the LLMClient, in version 1, whose ``llmclient`` is renamed ``chatbot``.
  *
  * This interface was referenced by `SmarterChatAPIContract`'s JSON-Schema
- * via the `definition` "PromptChatApiLLMClientFunctionV1".
+ * via the `definition` "PromptChatApiLLMClientExtensionV1".
  */
-export interface PromptChatApiLLMClientFunctionV1 {
+export interface PromptChatApiLLMClientExtensionV1 {
     /**
-     * LLMClientFunctions.llmclient: the LLMClient's id.
+     * LLMClientExtensions.llmclient: the LLMClient's id.
      */
     chatbot: number;
     /**
      * TimestampedModel.created_at.
      */
     created_at?: string | null;
+    enabled: boolean;
+    extension: number;
     /**
      * The row's primary key.
      */
     id: number;
-    name?: ("get_current_weather" | "date_calculator" | "calculator") | null;
+    name: string;
     /**
      * TimestampedModel.updated_at.
      */
     updated_at?: string | null;
+    version?: string | null;
 }
 /**
  * @deprecated
@@ -920,7 +935,7 @@ export interface PromptChatApiLLMClientPluginV1 {
     updated_at?: string | null;
 }
 /**
- * A plugin's metadata: a :class:`smarter.apps.plugin.models.PluginMeta`.
+ * A plugin's metadata: a :class:`smarter.apps.llmtool.models.PluginMeta`.
  *
  * Its owner is left out: the configuration never includes a user's profile.
  *

package/dist/types/src/embed/EmbedApp.d.ts

@@ -0,0 +1,10 @@
+import type { EmbedOptions } from "./options";
+export declare const PANEL_ID = "smarter-chat-embed-panel";
+export interface EmbedAppProps {
+    options: EmbedOptions;
+    /** Whether the launcher is open. The element owns this state, so that page scripts can open and close it. */
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+}
+declare function EmbedApp(props: EmbedAppProps): import("react").JSX.Element;
+export default EmbedApp;

package/dist/types/src/embed/assets.d.ts

@@ -0,0 +1,7 @@
+export declare const CDN_BASE_URL: string;
+/** The url of the directory of a script, or of jsDelivr's copy of the package, if it has no url. */
+export declare function scriptBaseUrl(script: Element | null | undefined): string;
+/** Remembers the directory of the running script. Called once, by index.ts, when the script first runs. */
+export declare function captureBaseUrl(script?: Element | null | undefined): string;
+/** The url of one of the embed script's files, e.g. assetUrl("mermaid/mermaid.js"). */
+export declare function assetUrl(path: string): string;

package/dist/types/src/embed/autoMount.d.ts

@@ -0,0 +1,18 @@
+/** The attribute that marks the elements that the script added, with their chatbot's url. */
+export declare const AUTO_ATTRIBUTE = "data-smarter-chat-auto";
+export type EmbedConfig = Record<string, unknown>;
+declare global {
+    interface Window {
+        SmarterChatConfig?: EmbedConfig | EmbedConfig[];
+    }
+}
+/** The configurations of the script tag's data- attributes and of window.SmarterChatConfig, as attributes. */
+export declare function configurations(script: Element | null | undefined, globalConfig: EmbedConfig | EmbedConfig[] | null | undefined): Record<string, string>[];
+/**
+ * Adds a <smarter-chat> element for a configuration, unless the page has one for its chatbot already.
+ *
+ * @returns The new element, or null if none was added.
+ */
+export declare function mountChat(attributes: Record<string, string>, doc?: Document): HTMLElement | null;
+/** Adds the configurations' elements once the page's body exists. */
+export declare function autoMount(script: Element | null | undefined, globalConfig: EmbedConfig | EmbedConfig[] | null | undefined, doc?: Document): void;

package/dist/types/src/embed/css.d.ts

@@ -0,0 +1,15 @@
+export declare const ASSETS_PLACEHOLDER = "__SMARTER_CHAT_ASSETS__/";
+export declare const FONT_STYLE_ID = "smarter-chat-embed-fonts";
+/** Adds css to the embed's stylesheet. Called by the modules that the embed build generates for css imports. */
+export declare function addCss(css: string): void;
+/** The embed's css, with the urls of its own files. */
+export declare function embedCss(): string;
+/** The @font-face rules of a stylesheet. */
+export declare function fontFaceRules(css: string): string[];
+/** Adds the @font-face rules of the css to the document's head, once. */
+export declare function hoistFontFaces(css: string, doc?: Document): void;
+/**
+ * Applies the css to a shadow root: as a constructable stylesheet, shared by every chat on the page, where the
+ * browser supports them, or else as a style element.
+ */
+export declare function applyCss(root: ShadowRoot, css: string): void;

package/dist/types/src/embed/element.d.ts

@@ -0,0 +1,19 @@
+import { type EmbedOptionsResult } from "./options";
+export declare const ELEMENT_NAME = "smarter-chat";
+export declare const TOGGLE_EVENT = "smarter-chat-toggle";
+export declare class SmarterChatElement extends HTMLElement {
+    #private;
+    static observedAttributes: ("chatbot" | "color" | "label" | "open" | "debug" | "width" | "height" | "position" | "api-key" | "mode" | "z-index" | "session-cookie-name" | "cookie-path" | "stream-progress")[];
+    /** The element's options, from its attributes. */
+    get options(): EmbedOptionsResult;
+    /** Whether the launcher is open. */
+    get isOpen(): boolean;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+    open(): void;
+    close(): void;
+    toggle(): void;
+}
+/** Defines <smarter-chat>, unless the page already has, e.g. with another copy of the embed script. */
+export declare function defineElement(registry?: CustomElementRegistry): void;

package/dist/types/src/embed/index.d.ts

@@ -0,0 +1,17 @@
+import { type EmbedConfig } from "./autoMount";
+import "./styles.css";
+/** The api of window.SmarterChat. */
+export interface SmarterChatEmbedApi {
+    version: string;
+    /** Opens the launchers, or the launcher of one chatbot, by its url. */
+    open: (chatbot?: string) => void;
+    close: (chatbot?: string) => void;
+    toggle: (chatbot?: string) => void;
+    /** Adds a chat to the page, as window.SmarterChatConfig does. */
+    mount: (config: EmbedConfig) => HTMLElement | null;
+}
+declare global {
+    interface Window {
+        SmarterChat?: SmarterChatEmbedApi;
+    }
+}

package/dist/types/src/embed/mermaid.d.ts

@@ -0,0 +1,2 @@
+/** The entry point of the embed script's separate build of mermaid, embed/mermaid/mermaid.js. See vite.config.ts. */
+export { default } from "mermaid";

package/dist/types/src/embed/mermaidImport.d.ts

@@ -0,0 +1 @@
+export declare const importMermaid: () => Promise<typeof import("mermaid")>;

package/dist/types/src/embed/options.d.ts

@@ -0,0 +1,69 @@
+export type EmbedMode = "launcher" | "inline";
+export type EmbedPosition = "bottom-right" | "bottom-left";
+export interface EmbedOptions {
+    /** The url of the deployed LLMClient, e.g. https://support.3141-5926-5359.api.example.com/ */
+    chatbot: string;
+    /** A Smarter api key, for LLMClients that require one. It is public, as is everything in a web page. */
+    apiKey: string | null;
+    /** "launcher": a button in a corner of the page that opens the chat. "inline": the chat, in the page. */
+    mode: EmbedMode;
+    /** The launcher's corner. */
+    position: EmbedPosition;
+    /** Whether the launcher starts open. */
+    open: boolean;
+    /** The launcher's accessible name, and the chat panel's. */
+    label: string;
+    /** The launcher button's background color. */
+    color: string;
+    /** The width of the inline chat, or of the launcher's panel. */
+    width: string;
+    /** The height of the inline chat, or of the launcher's panel. */
+    height: string;
+    /** The launcher's z-index. */
+    zIndex: number;
+    /** The cookie in which the chat saves its session's key. */
+    sessionCookieName: string;
+    /** The path of the chat's cookies. "/" keeps one chat session across the website. */
+    cookiePath: string;
+    /** Display a running prompt's progress. */
+    streamProgress: boolean;
+    /** Log to the browser console. */
+    debug: boolean;
+}
+/** The result of reading the options: the options, or why they can't be used. */
+export type EmbedOptionsResult = {
+    options: EmbedOptions;
+    error: null;
+} | {
+    options: null;
+    error: string;
+};
+/** The attributes that a <smarter-chat> element reads, in kebab-case. */
+export declare const OPTION_ATTRIBUTES: readonly ["chatbot", "api-key", "mode", "position", "open", "label", "color", "width", "height", "z-index", "session-cookie-name", "cookie-path", "stream-progress", "debug"];
+export declare const DEFAULT_LABEL = "Chat";
+export declare const DEFAULT_COLOR = "#ff5733";
+export declare const DEFAULT_Z_INDEX = 2147483000;
+/** A boolean attribute: present and empty, or "true", is true. "false" is false. Missing is the default. */
+export declare function booleanOption(value: string | null | undefined, defaultValue: boolean): boolean;
+/** The url, if it is an http(s) url, normalized to end with a slash, else null. */
+export declare function chatbotUrl(value: string | null | undefined): string | null;
+/**
+ * The default session cookie of a chatbot: one per chatbot host, so that two chatbots on one website keep separate
+ * chat sessions, e.g. smarter_chat_support_3141_5926_5359_api_example_com.
+ */
+export declare function defaultSessionCookieName(chatbot: string): string;
+/**
+ * The options of a <smarter-chat> element.
+ *
+ * @param get Returns the value of an attribute, by its kebab-case name, or null if it is missing.
+ * @param defaultMode The mode, if the attributes don't say: "inline" for an element in the page, and "launcher"
+ *   for the element that the script tag adds.
+ */
+export declare function parseOptions(get: (name: (typeof OPTION_ATTRIBUTES)[number]) => string | null, defaultMode?: EmbedMode): EmbedOptionsResult;
+/** A camelCase name in kebab-case, e.g. apiKey to api-key. */
+export declare function kebabCase(name: string): string;
+/**
+ * The attributes of a configuration object, e.g. window.SmarterChatConfig's, or a script tag's dataset: kebab-case
+ * names, and string values. Values that are null, undefined, objects or functions are left out.
+ */
+export declare function configAttributes(config: Record<string, unknown>): Record<string, string>;

package/dist/types/src/lib/cookie.d.ts

@@ -1,7 +1,8 @@
 /**
  * Cookie management for Smarter Chat: the Django CSRF cookie, which it reads, and the chat
  * session and debug cookies, which it sets for the page's path, so that each LLMClient's
- * workbench has its own chat session.
+ * workbench has its own chat session, or for the path that the cookie names, e.g. "/" for a chat
+ * that follows the visitor across a website.
  */
 import type { CookieMeta } from "../types";
 /**
@@ -12,6 +13,6 @@ import type { CookieMeta } from "../types";
 export declare function inCookieDomain(hostname: string, domain: string | null | undefined): boolean;
 /** The cookie's value: its preset value, else the browser's cookie, else defaultValue. */
 export declare function getCookie(cookie: CookieMeta, defaultValue?: string | null): string | null;
-/** Sets the cookie for the page's path, or deletes it when value is empty. */
+/** Sets the cookie for its path (by default, the page's), or deletes it when value is empty. */
 export declare function setCookie(cookie: CookieMeta, value: string | boolean | null | undefined): void;
-export declare function cookieMetaFactory(name: string, expiration: number | null, domain: string | undefined, value?: string | null): CookieMeta;
+export declare function cookieMetaFactory(name: string, expiration: number | null, domain: string | undefined, value?: string | null, path?: string | null): CookieMeta;

package/dist/types/src/lib/mermaidImport.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Imports mermaid, which lib/mermaid.ts does the first time that a message has a diagram.
+ *
+ * In the npm package and the web console, the page's bundler splits mermaid into chunks, which are downloaded only
+ * then. The embed script, a single classic script, can't be split that way, so its build replaces this module with
+ * src/embed/mermaidImport.ts, which imports a separate build of mermaid from beside the script. See vite.config.ts.
+ */
+export declare const importMermaid: () => Promise<typeof import("mermaid")>;

package/dist/types/src/types.d.ts

@@ -54,6 +54,8 @@ export interface CookieMeta {
     domain: string;
     /** A value to use instead of the cookie's. */
     value: string | null;
+    /** The path that Smarter Chat sets the cookie for. Empty or missing means the page's path. */
+    path?: string | null;
 }
 export interface ChatCookies {
     csrfCookie: CookieMeta;
@@ -87,6 +89,11 @@ export interface SmarterChatProps {
     /** The name of the cookie in which Smarter Chat saves the chat session's key. */
     sessionCookieName?: string;
     sessionCookieExpiration?: number;
+    /**
+     * The path of the session and debug cookies. By default, the page's path, so that each page has its own chat
+     * session. "/" keeps one chat session as the visitor moves from page to page of a website.
+     */
+    cookiePath?: string | null;
     /** @deprecated Not used. Django's session cookie is sent with each request, as is. */
     authSessionCookieName?: string;
     /** Show the Console, which displays the chat's configuration and history. */