@stack-spot/ai-chat-widget 0.11.0 → 1.0.0-dev.1768324407795

package/dist/state/ChatEntry.js

@@ -1,27 +1,45 @@
 import { pull } from 'lodash';
+// this id is unique for each message and used for rendering. The `messageId`, which comes from the backend, is not always available and, 
+// therefore, can't be used for this purpose.
 let nextId = 0;
+/**
+ * A message (entry) in the chat.
+ */
 export class ChatEntry {
     id;
     value;
     listeners = [];
     /**
      * @param value the value of the entry.
-     * @param isStreamed whether or not this entry is streamed. Defaults to false.
      */
     constructor(value) {
         this.id = nextId++;
         this.value = value;
     }
-    static createUserEntry(content, isMd = false) {
+    /**
+     * Utility function to create a user entry.
+     * @param content the message's content.
+     * @param isMd whether or not this should be rendered as markdown.
+     * @param hiddenContent the message's content.
+     * @returns a new ChatEntry.
+     */
+    static createUserEntry(content, isMd = false, fieldName, hiddenContent, data) {
         return new ChatEntry({
             agentType: 'user',
             type: isMd ? 'md' : 'text',
             content,
+            name: fieldName,
+            hiddenContent,
+            data,
             updated: new Date().toISOString(),
         });
     }
+    /**
+     * Utility function to create a streamed entry from the AI agent.
+     * @returns a new ChatEntry.
+     */
     static createStreamedBotEntry() {
-        return new ChatEntry({ agentType: 'bot', type: 'md', content: '' });
+        return new ChatEntry({ agentType: 'bot', type: 'md', content: '', done: false });
     }
     setValue(value) {
         this.value = value;
@@ -30,6 +48,11 @@ export class ChatEntry {
     getValue() {
         return this.value;
     }
+    /**
+     * Watches the value of this ChatEntry.
+     * @param listener a function to call whenever the value changes.
+     * @returns a function that removes the listener.
+     */
     onChange(listener) {
         this.listeners.push(listener);
         return () => {

package/dist/state/ChatEntry.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChatEntry.js","sourceRoot":"","sources":["../../src/state/ChatEntry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AA0C7B,IAAI,MAAM,GAAG,CAAC,CAAA;AAEd,MAAM,OAAO,SAAS;IACX,EAAE,CAAQ;IACX,KAAK,CAAe;IACpB,SAAS,GAAwB,EAAE,CAAA;IAE3C;;;OAGG;IACH,YAAY,KAAoB;QAC9B,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,CAAA;QAClB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAED,MAAM,CAAC,eAAe,CAAC,OAAe,EAAE,IAAI,GAAG,KAAK;QAClD,OAAO,IAAI,SAAS,CAAC;YACnB,SAAS,EAAE,MAAM;YACjB,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM;YAC1B,OAAO;YACP,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SAClC,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,CAAC,sBAAsB;QAC3B,OAAO,IAAI,SAAS,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAA;IACrE,CAAC;IAED,QAAQ,CAAC,KAAoB;QAC3B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;IAC5C,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED,QAAQ,CAAC,QAA2B;QAClC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC7B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QAChC,CAAC,CAAA;IACH,CAAC;CACF"}
+{"version":3,"file":"ChatEntry.js","sourceRoot":"","sources":["../../src/state/ChatEntry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAsM7B,0IAA0I;AAC1I,6CAA6C;AAC7C,IAAI,MAAM,GAAG,CAAC,CAAA;AAEd;;GAEG;AACH,MAAM,OAAO,SAAS;IACX,EAAE,CAAQ;IACX,KAAK,CAAe;IACpB,SAAS,GAAwB,EAAE,CAAA;IAE3C;;OAEG;IACH,YAAY,KAAoB;QAC9B,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,CAAA;QAClB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CAAC,OAAe,EAAE,IAAI,GAAG,KAAK,EAAE,SAAkB,EAAE,aAAwB,EAAE,IAAU;QAC5G,OAAO,IAAI,SAAS,CAAC;YACnB,SAAS,EAAE,MAAM;YACjB,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM;YAC1B,OAAO;YACP,IAAI,EAAE,SAAS;YACf,aAAa;YACb,IAAI;YACJ,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SAClC,CAAC,CAAA;IACJ,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,sBAAsB;QAC3B,OAAO,IAAI,SAAS,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAClF,CAAC;IAED,QAAQ,CAAC,KAAoB;QAC3B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QAClB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAA;IAC5C,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,QAA2B;QAClC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC7B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QAChC,CAAC,CAAA;IACH,CAAC;CACF"}

package/dist/state/ChatState.d.ts

@@ -1,15 +1,40 @@
+import { ChatFeatures } from '../features.js';
+import { UploadManager } from '../utils/upload/UploadManager.js';
 import { ChatEntry } from './ChatEntry.js';
 import { ObservableState } from './ObservableState.js';
-import { Labeled, LabeledWithImage } from './types.js';
-export interface ChatProperties {
+import { Labeled, LabeledAgent } from './types.js';
+export interface ChatPropertiesWithOptionalFeatures {
+    /**
+     * The name of the chat.
+     */
     label: string;
-    agent?: LabeledWithImage & {
-        builtIn: boolean;
-    };
+    /**
+     * The current AI agent.
+     */
+    agent?: LabeledAgent;
+    /**
+     * The current workspace.
+     */
     workspace?: Labeled;
+    /**
+     * The current stack.
+     */
     stack?: Labeled;
+    /**
+     * The current knowledge sources.
+     */
     knowledgeSources?: Labeled[];
+    /**
+     * Whether or not the chat is in a loading state.
+     */
     isLoading?: boolean;
+    /**
+     * Whether or not the chat is planning.
+     */
+    isPlaning?: boolean;
+    /**
+     * The value of the next message. This is the value of the text typed in the textarea below the chat.
+     */
     nextMessage?: string;
     /**
      * The current code in the editor.
@@ -20,39 +45,110 @@ export interface ChatProperties {
      */
     codeLanguage?: string;
     /**
-     * The current selection in the editor
+     * The current selection in the editor.
      */
     codeSelection?: string;
+    /**
+     * The features enabled for this chat.
+     *
+     * If a feature is marked as false, it's disabled, otherwise it's enabled.
+     */
+    features?: Partial<ChatFeatures>;
+    /**
+     * The current LLM (Large Language Model) being used for this chat.
+     */
+    selected_model_id?: string;
+}
+export interface ChatProperties extends ChatPropertiesWithOptionalFeatures {
+    /**
+     * The features enabled for this chat.
+     */
+    features: ChatFeatures;
 }
 type ChatMessagesListener = (chat: ChatEntry[]) => void;
 export type MessageInterceptor = (entry: ChatEntry, chat: ChatState, signal: AbortSignal) => boolean | undefined | void | Promise<boolean | undefined | void>;
 interface Options {
+    /**
+     * The unique identifier for this chat (conversationId).
+     */
     id: string;
-    initial: ChatProperties;
+    /**
+     * The initial value for the state of this chat.
+     */
+    initial: ChatPropertiesWithOptionalFeatures;
+    /**
+     * The interceptors to use for the messages pushed to this chat.
+     *
+     * The interceptors are run whenever a new message (chat entry) is added to the chat. They're always run in the order of the array and if
+     * any returns a promise, the promise is awaited before running the next.
+     *
+     * If an interceptor returns false or resolves to false (if a promise), the execution is interrupted, i.e. the next interceptors are not
+     * run.
+     *
+     * An interceptor receives three parameters:
+     * 1. the chat entry added;
+     * 2. the chat state;
+     * 3. an AbortSignal that can be aborted by calling `abort()` on the ChatState. Once the signal is aborted, the interceptor must abort all
+     * of its operations.
+     *
+     * Attention: when multiple messages are added at once, only the last goes through the interceptors. Furthermore, messages created by the
+     * constructor don't go through the interceptors, only messages added via `pushMessage` do.
+     */
     interceptors?: MessageInterceptor[];
+    /**
+     * The content of this chat, i.e. its messages.
+     */
     entries?: ChatEntry[];
+    /**
+     * Whether or not the label for this chat is real (persisted in the backend) or just a mock.
+     *
+     * This should be true if the label is just a mock.
+     */
+    untitled?: boolean;
 }
+/**
+ * A chat. Each chat tab is a different ChatState.
+ */
 export declare class ChatState extends ObservableState<ChatProperties> {
     readonly id: string;
     private entries;
     private messagesListeners;
     private readonly interceptors;
+    /**
+     * A memory space (map) to be used by interceptors.
+     */
     interceptorMemory: Map<string, any>;
+    /**
+     * Abort signals currently active.
+     */
     private abortions;
     /**
-     * @param id the id of the chat.
-     * @param initial the initial state.
-     * @param interceptors a list of interceptors to run whenever a new message (entry) is added to the chat. If an interception function
-     * returns false, the next interceptors are not run. Attention: when multiple messages are added at once, only the last goes through the
-     * interceptors. Furthermore, messages created by the constructor don't go through the interceptors, only messages added via `pushMessage`
-     * do.
+     * Used to manage uploads for this Chat.
      */
-    constructor({ id, initial, entries, interceptors }: Options);
+    readonly uploadManager: UploadManager;
+    untitled: boolean;
+    constructor({ id, initial, entries, interceptors, untitled }: Options);
     private runMessagesListeners;
     private runInterceptors;
+    /**
+     * Adds one or more messages to the chat. Messages are appended to the end of the chat.
+     * @param entries the messages to add.
+     */
     pushMessage(...entries: ChatEntry[]): void;
+    /**
+     * Removes one or more messages from the end of the chat.
+     * @param quantity the number of messages to remove. Defaults to 1.
+     */
     popMessage(quantity?: number): void;
+    /**
+     * @returns the current list of messages.
+     */
     getMessages(): ChatEntry[];
+    /**
+     * Watches this chat for changes in the list of messages.
+     * @param listener the function to call whenever the list of messages changes.
+     * @returns a function that removes the listener.
+     */
     onChangeMessages(listener: ChatMessagesListener): () => void;
     /**
      * Aborts all currently running chat interceptors.
@@ -64,6 +160,12 @@ export declare class ChatState extends ObservableState<ChatProperties> {
      * All abortions from this chat will be transferred to the new chat. The abortions of this chat will be cleared.
      */
     transferToNewChat(label: string): ChatState;
+    /**
+     * Returns a promise that resolves when the chat is no longer loading (isLoading state).
+     *
+     * If this is called when the chat is not loading, a resolved promise is returned.
+     */
+    whenLoadingEnds(): Promise<void>;
 }
 export {};
 //# sourceMappingURL=ChatState.d.ts.map

package/dist/state/ChatState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatState.d.ts","sourceRoot":"","sources":["../../src/state/ChatState.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAEnD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,gBAAgB,GAAG;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gBAAgB,CAAC,EAAE,OAAO,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,KAAK,oBAAoB,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,IAAI,CAAA;AAEvD,MAAM,MAAM,kBAAkB,GAAG,CAC/B,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,KACnD,OAAO,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC,CAAA;AAErE,UAAU,OAAO;IACf,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,cAAc,CAAC;IACxB,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACpC,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;CACvB;AAED,qBAAa,SAAU,SAAQ,eAAe,CAAC,cAAc,CAAC;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,iBAAiB,mBAAyB;IAC1C,OAAO,CAAC,SAAS,CAAwB;IAEzC;;;;;;;OAOG;gBACS,EAAE,EAAE,EAAE,OAAO,EAAE,OAAY,EAAE,YAAiB,EAAE,EAAE,OAAO;IAOrE,OAAO,CAAC,oBAAoB;YAId,eAAe;IAe7B,WAAW,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE;IAOnC,UAAU,CAAC,QAAQ,SAAI;IAKvB,WAAW;IAIX,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB;IAO/C;;OAEG;IACH,KAAK;IAKL;;;;OAIG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM;CAUhC"}
+{"version":3,"file":"ChatState.d.ts","sourceRoot":"","sources":["../../src/state/ChatState.ts"],"names":[],"mappings":"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"}

package/dist/state/ChatState.js

@@ -1,27 +1,37 @@
 import { dropRight, last, pull } from 'lodash';
 import { ulid } from 'ulid';
 import { AbortedError } from '../AbortedError.js';
+import { getFeaturesWithDefaults } from '../features.js';
+import { UploadManager } from '../utils/upload/UploadManager.js';
+import { acceptedFileTypes, maxFileSize, maxUploadItems } from './constants.js';
 import { ObservableState } from './ObservableState.js';
+/**
+ * A chat. Each chat tab is a different ChatState.
+ */
 export class ChatState extends ObservableState {
     id;
     entries;
     messagesListeners = [];
     interceptors;
+    /**
+     * A memory space (map) to be used by interceptors.
+     */
     interceptorMemory = new Map();
+    /**
+     * Abort signals currently active.
+     */
     abortions = [];
     /**
-     * @param id the id of the chat.
-     * @param initial the initial state.
-     * @param interceptors a list of interceptors to run whenever a new message (entry) is added to the chat. If an interception function
-     * returns false, the next interceptors are not run. Attention: when multiple messages are added at once, only the last goes through the
-     * interceptors. Furthermore, messages created by the constructor don't go through the interceptors, only messages added via `pushMessage`
-     * do.
+     * Used to manage uploads for this Chat.
      */
-    constructor({ id, initial, entries = [], interceptors = [] }) {
-        super(initial);
+    uploadManager = new UploadManager({ maxSize: maxFileSize, accept: acceptedFileTypes, maxItems: maxUploadItems });
+    untitled;
+    constructor({ id, initial, entries = [], interceptors = [], untitled = false }) {
+        super({ ...initial, features: getFeaturesWithDefaults(initial.features) });
         this.id = id;
         this.interceptors = interceptors;
         this.entries = entries;
+        this.untitled = untitled;
     }
     runMessagesListeners() {
         this.messagesListeners.forEach(l => l(this.entries));
@@ -42,6 +52,10 @@ export class ChatState extends ObservableState {
         }
         pull(this.abortions, abort);
     }
+    /**
+     * Adds one or more messages to the chat. Messages are appended to the end of the chat.
+     * @param entries the messages to add.
+     */
     pushMessage(...entries) {
         if (!entries.length)
             return;
@@ -49,13 +63,25 @@ export class ChatState extends ObservableState {
         this.runMessagesListeners();
         this.runInterceptors(last(entries));
     }
+    /**
+     * Removes one or more messages from the end of the chat.
+     * @param quantity the number of messages to remove. Defaults to 1.
+     */
     popMessage(quantity = 1) {
         this.entries = dropRight(this.entries, quantity);
         this.runMessagesListeners();
     }
+    /**
+     * @returns the current list of messages.
+     */
     getMessages() {
         return this.entries;
     }
+    /**
+     * Watches this chat for changes in the list of messages.
+     * @param listener the function to call whenever the list of messages changes.
+     * @returns a function that removes the listener.
+     */
     onChangeMessages(listener) {
         this.messagesListeners.push(listener);
         return () => {
@@ -84,5 +110,20 @@ export class ChatState extends ObservableState {
         this.abortions = [];
         return newChat;
     }
+    /**
+     * Returns a promise that resolves when the chat is no longer loading (isLoading state).
+     *
+     * If this is called when the chat is not loading, a resolved promise is returned.
+     */
+    whenLoadingEnds() {
+        return this.get('isLoading') ? new Promise((resolve) => {
+            const removeListener = this.onChange('isLoading', (value) => {
+                if (!value) {
+                    resolve();
+                    removeListener();
+                }
+            });
+        }) : Promise.resolve();
+    }
 }
 //# sourceMappingURL=ChatState.js.map

package/dist/state/ChatState.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChatState.js","sourceRoot":"","sources":["../../src/state/ChatState.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ChatState.js","sourceRoot":"","sources":["../../src/state/ChatState.ts"],"names":[],"mappings":"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"}

package/dist/state/ChatTabsController.d.ts

@@ -1,16 +1,65 @@
 import { ChatState } from './ChatState.js';
-type TabChangeListener = (chats: ChatState[], activeId: string) => void;
+type TabChangeListener = (chats: ChatState[], active: ChatState) => void;
+/**
+ * Controls the chat tabs.
+ */
 export declare class ChatTabsController {
     private chats;
     private activeChatId;
     private listeners;
     private runListeners;
+    /**
+     * Adds new chats to the tab view.
+     * @param chats the chats to add.
+     */
     add(...chats: ChatState[]): void;
+    /**
+     * If the active chat is deleted, this selects a new chat based on the position of the chat that has been removed.
+     *
+     * @param previous the previous tabs.
+     * @param deleted the ids of the chats that have been deleted.
+     */
+    private reselect;
+    /**
+     * Removes chats from the tab view. This will never remove a chat if this chat is the last one.
+     *
+     * @param ids the ids of the chats to remove.
+     */
     remove(...ids: string[]): void;
+    /**
+     * Removes all empty chats. The last chat will be kept if it's empty, but the only chat remaining.
+     *
+     * @param exceptions ids of chats that shouldn't be removed even if empty.
+     */
+    removeEmptyChats(...exceptions: string[]): void;
+    /**
+     * @param id the id of the chat to retrieve.
+     * @returns a ChatState corresponding to the id.
+     */
     get(id: string): ChatState | undefined;
+    /**
+     * @returns the id of the chat corresponding to the tab that is currently active.
+     */
     getActiveChatId(): string;
+    /**
+     * @returns the chat corresponding to the tab that is currently active.
+     */
+    getActiveChat(): ChatState;
+    /**
+     * @returns all chats in tab view.
+     */
     getAll(): ChatState[];
+    /**
+     * Watches for changes in the tab view.
+     * @param listener a function called whenever a tab is added, removed or selected. This function receives the list of chats as the first
+     * parameter and the id of the active chat as the second parameter.
+     * @returns a function to remove the listener.
+     */
     onChange(listener: TabChangeListener): () => void;
+    /**
+     * Changes the chat (tab) that is currently active.
+     * @param id the id of the chat to select.
+     */
     select(id: string): void;
 }
 export {};

package/dist/state/ChatTabsController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChatTabsController.d.ts","sourceRoot":"","sources":["../../src/state/ChatTabsController.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,KAAK,iBAAiB,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;AAEvE,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,SAAS,CAA0B;IAE3C,OAAO,CAAC,YAAY;IAIpB,GAAG,CAAC,GAAG,KAAK,EAAE,SAAS,EAAE;IAMzB,MAAM,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE;IAWvB,GAAG,CAAC,EAAE,EAAE,MAAM;IAId,eAAe;IAIf,MAAM;IAIN,QAAQ,CAAC,QAAQ,EAAE,iBAAiB;IAOpC,MAAM,CAAC,EAAE,EAAE,MAAM;CAIlB"}
+{"version":3,"file":"ChatTabsController.d.ts","sourceRoot":"","sources":["../../src/state/ChatTabsController.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAEvC,KAAK,iBAAiB,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,SAAS,KAAK,IAAI,CAAA;AAExE;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,SAAS,CAA0B;IAE3C,OAAO,CAAC,YAAY;IAIpB;;;OAGG;IACH,GAAG,CAAC,GAAG,KAAK,EAAE,SAAS,EAAE;IAMzB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IAQhB;;;;OAIG;IACH,MAAM,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE;IASvB;;;;OAIG;IACH,gBAAgB,CAAC,GAAG,UAAU,EAAE,MAAM,EAAE;IAYxC;;;OAGG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM;IAId;;OAEG;IACH,eAAe;IAIf;;OAEG;IACH,aAAa;IAMb;;OAEG;IACH,MAAM;IAIN;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,iBAAiB;IAOpC;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM;CAIlB"}

package/dist/state/ChatTabsController.js

@@ -1,44 +1,113 @@
-import { last, pull } from 'lodash';
+import { groupBy, last, pull } from 'lodash';
+/**
+ * Controls the chat tabs.
+ */
 export class ChatTabsController {
     chats = [];
     activeChatId = '';
     listeners = [];
     runListeners() {
-        this.listeners.forEach(l => l(this.chats, this.activeChatId));
+        this.listeners.forEach(l => l(this.chats, this.getActiveChat()));
     }
+    /**
+     * Adds new chats to the tab view.
+     * @param chats the chats to add.
+     */
     add(...chats) {
         if (!chats.length)
             return;
         this.chats = [...this.chats, ...chats];
         this.runListeners();
     }
-    remove(...ids) {
-        if (this.chats.length <= 1 || !ids.length)
-            return;
-        const currentActiveIndex = this.chats.findIndex(c => c.id === this.activeChatId);
-        this.chats = this.chats.filter(c => !ids.includes(c.id));
-        if (ids.includes(this.activeChatId)) {
+    /**
+     * If the active chat is deleted, this selects a new chat based on the position of the chat that has been removed.
+     *
+     * @param previous the previous tabs.
+     * @param deleted the ids of the chats that have been deleted.
+     */
+    reselect(previous, deleted) {
+        if (deleted.includes(this.activeChatId)) {
+            const currentActiveIndex = previous.findIndex(c => c.id === this.activeChatId);
             if (currentActiveIndex === -1)
                 this.activeChatId = this.chats[0]?.id;
             this.activeChatId = currentActiveIndex < this.chats.length ? this.chats[currentActiveIndex].id : last(this.chats)?.id ?? '';
         }
+    }
+    /**
+     * Removes chats from the tab view. This will never remove a chat if this chat is the last one.
+     *
+     * @param ids the ids of the chats to remove.
+     */
+    remove(...ids) {
+        ids.splice(this.chats.length - 1, ids.length - this.chats.length);
+        if (!ids.length)
+            return;
+        const previous = this.chats;
+        this.chats = this.chats.filter(c => !ids.includes(c.id));
+        this.reselect(previous, ids);
         this.runListeners();
     }
+    /**
+     * Removes all empty chats. The last chat will be kept if it's empty, but the only chat remaining.
+     *
+     * @param exceptions ids of chats that shouldn't be removed even if empty.
+     */
+    removeEmptyChats(...exceptions) {
+        const lastChat = last(this.chats);
+        const previous = this.chats;
+        const { true: removed, false: kept = [] } = groupBy(this.chats, c => c.getMessages().length === 0 && !exceptions.includes(c.id));
+        if (removed) {
+            this.chats = kept;
+            if (lastChat && this.chats.length === 0)
+                this.chats.push(lastChat);
+            this.reselect(previous, removed.map(c => c.id));
+            this.runListeners();
+        }
+    }
+    /**
+     * @param id the id of the chat to retrieve.
+     * @returns a ChatState corresponding to the id.
+     */
     get(id) {
         return this.chats.find(c => c.id === id);
     }
+    /**
+     * @returns the id of the chat corresponding to the tab that is currently active.
+     */
     getActiveChatId() {
         return this.activeChatId;
     }
+    /**
+     * @returns the chat corresponding to the tab that is currently active.
+     */
+    getActiveChat() {
+        const chat = this.chats.find(c => c.id === this.activeChatId);
+        if (!chat)
+            throw new Error('Chat state error, the active chat id corresponds to none chat in the tabs.');
+        return chat;
+    }
+    /**
+     * @returns all chats in tab view.
+     */
     getAll() {
         return this.chats;
     }
+    /**
+     * Watches for changes in the tab view.
+     * @param listener a function called whenever a tab is added, removed or selected. This function receives the list of chats as the first
+     * parameter and the id of the active chat as the second parameter.
+     * @returns a function to remove the listener.
+     */
     onChange(listener) {
         this.listeners.push(listener);
         return () => {
             pull(this.listeners, listener);
         };
     }
+    /**
+     * Changes the chat (tab) that is currently active.
+     * @param id the id of the chat to select.
+     */
     select(id) {
         this.activeChatId = id;
         this.runListeners();

package/dist/state/ChatTabsController.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChatTabsController.js","sourceRoot":"","sources":["../../src/state/ChatTabsController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAKnC,MAAM,OAAO,kBAAkB;IACrB,KAAK,GAAgB,EAAE,CAAA;IACvB,YAAY,GAAG,EAAE,CAAA;IACjB,SAAS,GAAwB,EAAE,CAAA;IAEnC,YAAY;QAClB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAA;IAC/D,CAAC;IAED,GAAG,CAAC,GAAG,KAAkB;QACvB,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,OAAM;QACzB,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,CAAA;QACtC,IAAI,CAAC,YAAY,EAAE,CAAA;IACrB,CAAC;IAED,MAAM,CAAC,GAAG,GAAa;QACrB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM;YAAE,OAAM;QACjD,MAAM,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,YAAY,CAAC,CAAA;QAChF,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QACxD,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YACpC,IAAI,kBAAkB,KAAK,CAAC,CAAC;gBAAE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;YACpE,IAAI,CAAC,YAAY,GAAG,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,CAAA;QAC7H,CAAC;QACD,IAAI,CAAC,YAAY,EAAE,CAAA;IACrB,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;IAC1C,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAA;IAC1B,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED,QAAQ,CAAC,QAA2B;QAClC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAC7B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QAChC,CAAC,CAAA;IACH,CAAC;IAED,MAAM,CAAC,EAAU;QACf,IAAI,CAAC,YAAY,GAAG,EAAE,CAAA;QACtB,IAAI,CAAC,YAAY,EAAE,CAAA;IACrB,CAAC;CACF"}
+{"version":3,"file":"ChatTabsController.js","sourceRoot":"","sources":["../../src/state/ChatTabsController.ts"],"names":[],"mappings":"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"}

package/dist/state/ObservableState.d.ts

@@ -1,10 +1,24 @@
 export type ObservableStateListener<T, K extends keyof T> = (value: T[K]) => void;
+/**
+ * A generic representation of a state that can be observed for changes.
+ *
+ * Building our own state instead of using React is important because:
+ * 1. We need to be able to control it even outside the react context.
+ * 2. We need performance, we can't have everything re-rendering because something changes. We need to be careful to watch only the
+ * properties we need in a component.
+ */
 export declare class ObservableState<T> {
     protected state: T;
     private listeners;
     constructor(initial: T);
     set<K extends keyof T>(key: K, value: T[K]): void;
     get<K extends keyof T>(key: K): T[K];
+    /**
+     * Watches for changes in the state referred by the provided key.
+     * @param key the key of the state to watch.
+     * @param listener a function called whenever the value of the state referred by `key` changes.
+     * @returns a function to remove the listener.
+     */
     onChange<K extends keyof T>(key: K, listener: (value: T[K]) => void): () => void;
 }
 //# sourceMappingURL=ObservableState.d.ts.map

package/dist/state/ObservableState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ObservableState.d.ts","sourceRoot":"","sources":["../../src/state/ObservableState.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,uBAAuB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;AAMjF,qBAAa,eAAe,CAAC,CAAC;IAC5B,SAAS,CAAC,KAAK,EAAE,CAAC,CAAA;IAClB,OAAO,CAAC,SAAS,CAAmB;gBAExB,OAAO,EAAE,CAAC;IAItB,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAO1C,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAIpC,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;CAOpE"}
+{"version":3,"file":"ObservableState.d.ts","sourceRoot":"","sources":["../../src/state/ObservableState.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,uBAAuB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;AAMjF;;;;;;;GAOG;AACH,qBAAa,eAAe,CAAC,CAAC;IAC5B,SAAS,CAAC,KAAK,EAAE,CAAC,CAAA;IAClB,OAAO,CAAC,SAAS,CAAmB;gBAExB,OAAO,EAAE,CAAC;IAItB,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAO1C,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAIpC;;;;;OAKG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;CAOpE"}

package/dist/state/ObservableState.js

@@ -1,4 +1,12 @@
 import { pull } from 'lodash';
+/**
+ * A generic representation of a state that can be observed for changes.
+ *
+ * Building our own state instead of using React is important because:
+ * 1. We need to be able to control it even outside the react context.
+ * 2. We need performance, we can't have everything re-rendering because something changes. We need to be careful to watch only the
+ * properties we need in a component.
+ */
 export class ObservableState {
     state;
     listeners = {};
@@ -14,6 +22,12 @@ export class ObservableState {
     get(key) {
         return this.state[key];
     }
+    /**
+     * Watches for changes in the state referred by the provided key.
+     * @param key the key of the state to watch.
+     * @param listener a function called whenever the value of the state referred by `key` changes.
+     * @returns a function to remove the listener.
+     */
     onChange(key, listener) {
         this.listeners[key] ??= [];
         this.listeners[key].push(listener);

package/dist/state/ObservableState.js.map

@@ -1 +1 @@
-{"version":3,"file":"ObservableState.js","sourceRoot":"","sources":["../../src/state/ObservableState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAQ7B,MAAM,OAAO,eAAe;IAChB,KAAK,CAAG;IACV,SAAS,GAAiB,EAAE,CAAA;IAEpC,YAAY,OAAU;QACpB,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,OAAO,EAAE,CAAA;IAC7B,CAAC;IAED,GAAG,CAAoB,GAAM,EAAE,KAAW;QACxC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;YACvB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;QAC7C,CAAC;IACH,CAAC;IAED,GAAG,CAAoB,GAAM;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACxB,CAAC;IAED,QAAQ,CAAoB,GAAM,EAAE,QAA+B;QACjE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,CAAA;QAC1B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACnC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAE,EAAE,QAAQ,CAAC,CAAA;QACtC,CAAC,CAAA;IACH,CAAC;CACF"}
+{"version":3,"file":"ObservableState.js","sourceRoot":"","sources":["../../src/state/ObservableState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAQ7B;;;;;;;GAOG;AACH,MAAM,OAAO,eAAe;IAChB,KAAK,CAAG;IACV,SAAS,GAAiB,EAAE,CAAA;IAEpC,YAAY,OAAU;QACpB,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,OAAO,EAAE,CAAA;IAC7B,CAAC;IAED,GAAG,CAAoB,GAAM,EAAE,KAAW;QACxC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;YACvB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;QAC7C,CAAC;IACH,CAAC;IAED,GAAG,CAAoB,GAAM;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACxB,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAoB,GAAM,EAAE,QAA+B;QACjE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,CAAA;QAC1B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACnC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAE,EAAE,QAAQ,CAAC,CAAA;QACtC,CAAC,CAAA;IACH,CAAC;CACF"}