@singlebase/elements 0.8.0 → 0.9.0

package/dist/chat-messages.d.ts

@@ -52,6 +52,10 @@ export interface SinglebaseChatMessages {
     restore: string;
     minimize: string;
     exportHeading: string;
+    viewOptions: string;
+    viewHeading: string;
+    viewFollowups: string;
+    viewSources: string;
     exportMarkdown: string;
     exportJson: string;
     exportText: string;
@@ -80,6 +84,7 @@ export interface SinglebaseChatMessages {
     sourceLabel: string;
     openSource: string;
     citedPassage: string;
+    passageCount: string;
     copyReference: string;
     alsoCited: string;
     close: string;

package/dist/chat.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./chat-BWcGH9lr.cjs");Object.defineProperty(exports,"SinglebaseChat",{enumerable:!0,get:()=>e.SinglebaseChat});exports.adaptBlocks=e.adaptBlocks;exports.citedNumbers=e.citedNumbers;exports.defaultChatMessages=e.defaultChatMessages;exports.describeSource=e.describeSource;exports.parseInline=e.parseInline;exports.parseMarkdown=e.parseMarkdown;exports.resolveChatMessages=e.resolveChatMessages;exports.settleStreaming=e.settleStreaming;exports.splitFollowups=e.splitFollowups;exports.svgDataUrl=e.svgDataUrl;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./chat-Bj6DrOaW.cjs");Object.defineProperty(exports,"SinglebaseChat",{enumerable:!0,get:()=>e.SinglebaseChat});exports.adaptBlocks=e.adaptBlocks;exports.citedNumbers=e.citedNumbers;exports.defaultChatMessages=e.defaultChatMessages;exports.describeSource=e.describeSource;exports.parseInline=e.parseInline;exports.parseMarkdown=e.parseMarkdown;exports.resolveChatMessages=e.resolveChatMessages;exports.settleStreaming=e.settleStreaming;exports.splitFollowups=e.splitFollowups;exports.svgDataUrl=e.svgDataUrl;
 //# sourceMappingURL=chat.cjs.map

package/dist/chat.js

@@ -1,4 +1,4 @@
-import { S as e, a as r, c as t, d as l, b as o, p, e as d, r as g, s as i, f as c, g as n } from "./chat-t4o5FsxM.js";
+import { S as e, a as r, c as t, d as l, b as o, p, e as d, r as g, s as i, f as c, g as n } from "./chat-DNiqYF6F.js";
 export {
   e as SinglebaseChat,
   r as adaptBlocks,

package/dist/elements/chat.d.ts

@@ -23,6 +23,8 @@ export type ChatClient = {
 export interface ChatSummary {
     _id: string;
     title: string | null;
+    /** The caller-chosen key this chat can also be opened by. */
+    key?: string | null;
     bookmarked?: boolean;
     message_count?: number;
     _created_at?: string;
@@ -97,6 +99,7 @@ export interface ChatConfig {
     client: ChatClient | null;
     /** Opens this saved chat. */
     chatId: string;
+    chatKey: string;
     embed: ChatEmbed;
     mode: ChatMode;
     format: ChatFormat;
@@ -135,6 +138,7 @@ export interface ChatConfig {
     saveAttachments: boolean;
     showFollowups: boolean;
     showSources: boolean;
+    allowViewOptions: boolean;
     showNewChat: boolean;
     showBookmarked: boolean;
     allowSearch: boolean;
@@ -151,6 +155,7 @@ export interface ChatConfig {
 /** A readable view of whatever shape the server recorded for a source. */
 export declare function describeSource(source: Record<string, unknown>, n: number): {
     n: number;
+    doc: string;
     title: string;
     section: string;
     path: string;
@@ -159,6 +164,20 @@ export declare function describeSource(source: Record<string, unknown>, n: numbe
     text: string;
     score: number | null;
 };
+type DescribedSource = ReturnType<typeof describeSource>;
+/** One document and the passages of it that a reply used. */
+export interface SourceGroup {
+    doc: string;
+    /** The first passage: it supplies the title, path and preview. */
+    first: DescribedSource;
+    items: DescribedSource[];
+}
+/**
+ * Groups passages by the document they come from, keeping first-seen order.
+ * A file split into passages comes back as several numbered sources; shown one
+ * by one it looks like the same document repeated.
+ */
+export declare function groupSources(sources: DescribedSource[]): SourceGroup[];
 /**
  * An AI chat workspace backed by the `llm.*` service.
  *
@@ -221,6 +240,11 @@ export declare class SinglebaseChat extends LitElement {
     accessor showBookmarked: boolean;
     /** Show the follow-up questions under the latest reply. */
     accessor showFollowups: boolean;
+    /**
+     * Adds a header menu where the reader can hide suggested questions and
+     * sources for a cleaner view. Their choice is remembered in this browser.
+     */
+    accessor allowViewOptions: boolean;
     /** The search box in the chat list. */
     accessor allowSearch: boolean;
     /** Replace the provisional title with a model-written one after the first reply. */
@@ -245,6 +269,12 @@ export declare class SinglebaseChat extends LitElement {
     accessor showTitle: boolean;
     /** Opens this chat on load. */
     accessor chatIdAttr: string;
+    /**
+     * A key of your own for this conversation, unique per signed-in user. The
+     * chat with this key is opened if there is one; otherwise the first message
+     * creates it, so the same key reopens it later. `chat-id` wins if both are set.
+     */
+    accessor chatKey: string;
     /** Used in placeholders, exports and labels. Never shown above messages. */
     accessor assistantName: string;
     accessor logoUrl: string;
@@ -254,7 +284,9 @@ export declare class SinglebaseChat extends LitElement {
     accessor eyebrow: string | undefined;
     /**
      * Suggested prompts: `|`-separated in markup, an array in JavaScript.
-     * `"none"` or `[]` shows no suggestions.
+     * `"none"` or `[]` shows no suggestions. `"auto"` asks the service for
+     * starter questions drawn from the chat's context (`retrieval`, `docsets`
+     * and saved attachments); they're stored on the chat and reused on reload.
      */
     accessor prompts: string | (string | ChatPrompt)[];
     accessor bubbleText: string;
@@ -306,6 +338,9 @@ export declare class SinglebaseChat extends LitElement {
     private accessor width;
     private accessor panel;
     private accessor menuOpen;
+    private accessor viewOpen;
+    /** What the reader chose to hide, when `allow-view-options` lets them. */
+    private accessor viewHidden;
     private accessor editingKey;
     private accessor editDraft;
     private accessor editingTitle;
@@ -335,10 +370,22 @@ export declare class SinglebaseChat extends LitElement {
     private renamed;
     private observer;
     private observed;
+    private resizeTimer;
+    private shownPassage;
     private media;
     private focusNext;
     private bubbleScheduled;
     private pendingChatId;
+    /** Starter questions the service generated for this chat's context. */
+    private accessor starterList;
+    private accessor startersLoading;
+    /** The key the open conversation is created under, until the user leaves it. */
+    private boundKey;
+    /** The open chat was prepared but has no messages yet. */
+    private prepared;
+    private syncedKey;
+    private syncSignature;
+    private syncRun;
     get msg(): SinglebaseChatMessages;
     /** An explicit `.client`, else the page default. */
     get resolvedClient(): ChatClient | null;
@@ -346,6 +393,8 @@ export declare class SinglebaseChat extends LitElement {
     get chatId(): string | null;
     /** The open conversation's messages. */
     get thread(): readonly ChatMessage[];
+    /** The starter questions from `prompts="auto"`, if any. */
+    get starters(): readonly string[];
     /** `format`, falling back to the default for anything unknown. */
     /** `docsets` as a clean list of ids. */
     private get docsetIds();
@@ -386,6 +435,26 @@ export declare class SinglebaseChat extends LitElement {
     newChat(): void;
     /** Opens a saved conversation. */
     openChat(id: string): Promise<void>;
+    /** Suggested questions under answers: the page's setting, then the reader's. */
+    private get followupsVisible();
+    /** Source cards and the "searched" row: the page's setting, then the reader's. */
+    private get sourcesVisible();
+    private toggleView;
+    /** Puts a chat from `llm.get_chat` (or `llm.prepare_chat`) on screen. */
+    private showChat;
+    private get wantsStarters();
+    /** The user moved to another conversation: stop tying messages to the key. */
+    private leaveKeyedChat;
+    /** Docsets first, then the page's own retrieval entries. */
+    private baseRetrieval;
+    /**
+     * Opens the chat for `chat-key`, and with `prompts="auto"` prepares the chat
+     * with its context so the service returns stored starter questions.
+     *
+     * It runs when the key or the context changes. A change of context alone
+     * never replaces a conversation that already has messages.
+     */
+    private syncKeyedChat;
     /** Sends a message; with no argument, sends the composer's text. */
     send(text?: string): Promise<void>;
     /** Stops waiting for, or revealing, the current reply. */
@@ -465,6 +534,8 @@ export declare class SinglebaseChat extends LitElement {
     private renderSidebar;
     private renderThreadRow;
     private renderHeader;
+    /** Lets the reader hide suggested questions and sources for a cleaner view. */
+    private renderViewMenu;
     private renderExportMenu;
     /** The suggestion cards. `[]` or `"none"` shows none; unset uses the mode's. */
     private promptList;
@@ -491,3 +562,4 @@ declare global {
         "singlebase-chat": SinglebaseChat;
     }
 }
+export {};

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./authui-display-C2o9gApg.cjs"),r=require("./uploader-C57vgFME.cjs"),s=require("@singlebase/core"),a=require("./files-4T62wkwj.cjs"),t=require("./chat-BWcGH9lr.cjs");exports.AuthController=e.AuthController;exports.SettingsController=e.SettingsController;Object.defineProperty(exports,"SinglebaseAccountScreen",{enumerable:!0,get:()=>e.SinglebaseAccountScreen});Object.defineProperty(exports,"SinglebaseAuthButtons",{enumerable:!0,get:()=>e.SinglebaseAuthButtons});Object.defineProperty(exports,"SinglebaseAuthDisplay",{enumerable:!0,get:()=>e.SinglebaseAuthDisplay});Object.defineProperty(exports,"SinglebaseAuthGuard",{enumerable:!0,get:()=>e.SinglebaseAuthGuard});Object.defineProperty(exports,"SinglebaseAuthScreen",{enumerable:!0,get:()=>e.SinglebaseAuthScreen});exports.defaultMessages=e.defaultMessages;exports.fullNameOf=e.fullNameOf;exports.initialsOf=e.initialsOf;exports.isGuestScreen=e.isGuestScreen;exports.isProtectedScreen=e.isProtectedScreen;exports.isScreen=e.isScreen;exports.resolveMessages=e.resolveMessages;Object.defineProperty(exports,"SinglebaseUploader",{enumerable:!0,get:()=>r.SinglebaseUploader});exports.inspectFile=r.inspectFile;exports.isInspectable=r.isInspectable;exports.resolveRedirectTarget=r.resolveRedirectTarget;Object.defineProperty(exports,"OPERATORS",{enumerable:!0,get:()=>s.OPERATORS});Object.defineProperty(exports,"matchesPredicate",{enumerable:!0,get:()=>s.matchesPredicate});Object.defineProperty(exports,"validatePredicate",{enumerable:!0,get:()=>s.validatePredicate});exports.TOKEN_DEFAULTS=a.TOKEN_DEFAULTS;exports.defaultUploadMessages=a.defaultUploadMessages;exports.resolveUploadMessages=a.resolveUploadMessages;Object.defineProperty(exports,"SinglebaseChat",{enumerable:!0,get:()=>t.SinglebaseChat});exports.adaptBlocks=t.adaptBlocks;exports.citedNumbers=t.citedNumbers;exports.defaultChatMessages=t.defaultChatMessages;exports.describeSource=t.describeSource;exports.parseInline=t.parseInline;exports.parseMarkdown=t.parseMarkdown;exports.resolveChatMessages=t.resolveChatMessages;exports.settleStreaming=t.settleStreaming;exports.splitFollowups=t.splitFollowups;exports.svgDataUrl=t.svgDataUrl;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./authui-display-C2o9gApg.cjs"),r=require("./uploader-C57vgFME.cjs"),s=require("@singlebase/core"),a=require("./files-4T62wkwj.cjs"),t=require("./chat-Bj6DrOaW.cjs");exports.AuthController=e.AuthController;exports.SettingsController=e.SettingsController;Object.defineProperty(exports,"SinglebaseAccountScreen",{enumerable:!0,get:()=>e.SinglebaseAccountScreen});Object.defineProperty(exports,"SinglebaseAuthButtons",{enumerable:!0,get:()=>e.SinglebaseAuthButtons});Object.defineProperty(exports,"SinglebaseAuthDisplay",{enumerable:!0,get:()=>e.SinglebaseAuthDisplay});Object.defineProperty(exports,"SinglebaseAuthGuard",{enumerable:!0,get:()=>e.SinglebaseAuthGuard});Object.defineProperty(exports,"SinglebaseAuthScreen",{enumerable:!0,get:()=>e.SinglebaseAuthScreen});exports.defaultMessages=e.defaultMessages;exports.fullNameOf=e.fullNameOf;exports.initialsOf=e.initialsOf;exports.isGuestScreen=e.isGuestScreen;exports.isProtectedScreen=e.isProtectedScreen;exports.isScreen=e.isScreen;exports.resolveMessages=e.resolveMessages;Object.defineProperty(exports,"SinglebaseUploader",{enumerable:!0,get:()=>r.SinglebaseUploader});exports.inspectFile=r.inspectFile;exports.isInspectable=r.isInspectable;exports.resolveRedirectTarget=r.resolveRedirectTarget;Object.defineProperty(exports,"OPERATORS",{enumerable:!0,get:()=>s.OPERATORS});Object.defineProperty(exports,"matchesPredicate",{enumerable:!0,get:()=>s.matchesPredicate});Object.defineProperty(exports,"validatePredicate",{enumerable:!0,get:()=>s.validatePredicate});exports.TOKEN_DEFAULTS=a.TOKEN_DEFAULTS;exports.defaultUploadMessages=a.defaultUploadMessages;exports.resolveUploadMessages=a.resolveUploadMessages;Object.defineProperty(exports,"SinglebaseChat",{enumerable:!0,get:()=>t.SinglebaseChat});exports.adaptBlocks=t.adaptBlocks;exports.citedNumbers=t.citedNumbers;exports.defaultChatMessages=t.defaultChatMessages;exports.describeSource=t.describeSource;exports.parseInline=t.parseInline;exports.parseMarkdown=t.parseMarkdown;exports.resolveChatMessages=t.resolveChatMessages;exports.settleStreaming=t.settleStreaming;exports.splitFollowups=t.splitFollowups;exports.svgDataUrl=t.svgDataUrl;
 //# sourceMappingURL=index.cjs.map

package/dist/index.js

@@ -2,7 +2,7 @@ import { A as a, S as r, a as t, b as l, c as i, d as o, e as n, f as c, g as S,
 import { S as h, i as m, a as A, r as M } from "./uploader-Cz9yfzfV.js";
 import { OPERATORS as x, matchesPredicate as C, validatePredicate as O } from "@singlebase/core";
 import { T as U, d as P, r as k } from "./files-DS-H-3yN.js";
-import { S as E, a as F, c as N, d as R, b as w, p as B, e as G, r as I, s as j, f as y, g as K } from "./chat-t4o5FsxM.js";
+import { S as E, a as F, c as N, d as R, b as w, p as B, e as G, r as I, s as j, f as y, g as K } from "./chat-DNiqYF6F.js";
 export {
   a as AuthController,
   x as OPERATORS,