@tylertech/forge-ai 0.15.3-dev.0 → 0.16.0-dev.0

package/dist/ai-chatbot-launcher/ai-chatbot-launcher.d.ts

@@ -1,152 +0,0 @@
-import { TemplateResult, CSSResult } from 'lit';
-import { AiMessageThreadComponent } from '../ai-message-thread';
-import { AiPromptComponent, ForgeAiPromptSendEventData } from '../ai-prompt';
-import { ForgeAiSuggestionsEventData } from '../ai-suggestions';
-import { AiChatbotBase } from '../ai-chatbot/ai-chatbot-base.js';
-import { ChatMessage, ThreadState } from '../ai-chatbot/types.js';
-import { Thread } from '../ai-threads/ai-threads';
-import { Ref } from 'lit/directives/ref.js';
-export type LauncherViewState = 'welcome' | 'conversation' | 'history';
-export interface ForgeAiChatbotLauncherThreadRenameEventData {
-    id: string;
-    oldTitle: string;
-    newTitle: string;
-    onSuccess: () => void;
-    onError: (error?: string) => void;
-}
-export interface ForgeAiChatbotLauncherThreadDeleteEventData {
-    id: string;
-    thread: Thread;
-    onSuccess: () => void;
-    onError: (error?: string) => void;
-}
-export interface ForgeAiChatbotLauncherThreadSelectEventData {
-    id: string;
-    title: string;
-}
-export interface ForgeAiChatbotLauncherThreadSearchEventData {
-    query: string;
-    setResults: (results: Thread[]) => void;
-}
-export interface ForgeAiChatbotLauncherThreadLoadMoreEventData {
-    query: string;
-    appendResults: (results: Thread[]) => void;
-}
-declare global {
-    interface HTMLElementTagNameMap {
-        'forge-ai-chatbot-launcher': AiChatbotLauncherComponent;
-    }
-    interface HTMLElementEventMap {
-        'forge-ai-chatbot-launcher-conversation-start': CustomEvent<void>;
-        'forge-ai-chatbot-launcher-history-open': CustomEvent<void>;
-        'forge-ai-chatbot-launcher-history-close': CustomEvent<void>;
-        'forge-ai-chatbot-launcher-thread-rename': CustomEvent<ForgeAiChatbotLauncherThreadRenameEventData>;
-        'forge-ai-chatbot-launcher-thread-delete': CustomEvent<ForgeAiChatbotLauncherThreadDeleteEventData>;
-        'forge-ai-chatbot-launcher-thread-select': CustomEvent<ForgeAiChatbotLauncherThreadSelectEventData>;
-        'forge-ai-chatbot-launcher-thread-search': CustomEvent<ForgeAiChatbotLauncherThreadSearchEventData>;
-        'forge-ai-chatbot-launcher-thread-load-more': CustomEvent<ForgeAiChatbotLauncherThreadLoadMoreEventData>;
-        'forge-ai-chatbot-launcher-new-chat': CustomEvent<void>;
-        'forge-ai-chatbot-launcher-thread-retry': CustomEvent<void>;
-    }
-}
-export declare const AiChatbotLauncherComponentTagName: keyof HTMLElementTagNameMap;
-/**
- * @tag forge-ai-chatbot-launcher
- *
- * @summary An embedded AI chatbot component with a welcome view that transitions to conversation mode.
- *
- * @description
- * The AI Chatbot Launcher provides a page-embedded chat experience with a centered welcome/hero view
- * that animates into a full conversation interface when the user sends their first message.
- * In conversation mode, a header is displayed with options for clear, export, and agent selection.
- *
- * @slot icon - Slot for custom icon (used in both welcome view and conversation header)
- * @slot heading - Slot for custom heading content (welcome view only)
- * @slot description - Slot for custom description/welcome message below the title (welcome view only)
- * @slot header-actions - Slot for custom header action buttons in conversation mode (rendered before built-in header actions)
- *
- * @property {string} titleText - The title text to display in the welcome view and header (default: 'AI Assistant')
- * @property {string} descriptionText - The description text displayed below the title in the welcome view.
- * @property {HeadingLevel} headingLevel - Controls the heading level for the title content (default: 2)
- * @property {string | null | undefined} disclaimerText - The disclaimer text to display below the prompt.
- * @property {AgentInfo} agentInfo - Agent metadata for info dialog
- * @property {Agent[]} agents - List of available agents for selector
- * @property {string} selectedAgentId - Currently selected agent ID
- * @property {string} threadName - The name of the current thread (shown in conversation view breadcrumb)
- * @property {boolean} showHistoryButton - Controls the prompt bar's chat history button and its popover (default: false). Visibility is yours to decide - the component never infers it from whether chats are loaded, so an empty `threads` shows "No chats yet" rather than removing the entry point
- * @property {boolean} showThreadRename - Whether to show the rename option in thread actions menu
- * @property {boolean} showThreadDelete - Whether to show the delete option in thread actions menu
- * @property {Thread[]} threads - The list of chats shown in the history popover and full history view
- * @property {number} totalThreads - Total number of chats available. When greater than the number of loaded threads, infinite scroll is enabled (0 disables it)
- * @property {boolean} threadsLoading - Whether chats are currently loading, used to show a spinner on the history button and disable it
- * @property {string | undefined} threadsError - Message describing a failed chat history load. When set, the history popover/view shows the message with a retry button instead of the empty state, and the history button shows an error badge so the failure is visible with the popover closed. If chats are already loaded the list stays visible and the message renders as a compact single line with a retry - at the bottom of the list when a page was in flight, otherwise above it. Clear it once a load succeeds.
- * @property {string | null} selectedThreadId - The id of the currently selected thread, highlighted in the history popover/view. Updated internally when a thread is selected or a new chat starts.
- *
- * @cssproperty --forge-ai-chatbot-launcher-icon-color - The fill color for the AI icon.
- *
- * @event {CustomEvent<void>} forge-ai-chatbot-connected - Fired when adapter connects
- * @event {CustomEvent<ForgeAiChatbotMessageEventData>} forge-ai-chatbot-message-sent - Fired when user sends a message
- * @event {CustomEvent<ForgeAiChatbotMessageEventData>} forge-ai-chatbot-message-received - Fired when assistant message is complete
- * @event {CustomEvent<ForgeAiChatbotToolCallEventData>} forge-ai-chatbot-tool-call - Fired when a tool needs to be executed
- * @event {CustomEvent<ForgeAiChatbotErrorEventData>} forge-ai-chatbot-error - Fired when an error occurs
- * @event {CustomEvent<void>} forge-ai-chatbot-launcher-conversation-start - Fired when transitioning from welcome to conversation view
- * @event {CustomEvent<void>} forge-ai-chatbot-launcher-history-open - Fired when transitioning to the full-height history view
- * @event {CustomEvent<void>} forge-ai-chatbot-launcher-history-close - Fired when leaving the full-height history view
- * @event {CustomEvent<ForgeAiChatbotResponseFeedbackEventData>} forge-ai-chatbot-response-feedback - Fired when user provides feedback on a response
- * @event {CustomEvent<void>} forge-ai-chatbot-info - Fired when header info option is selected
- * @event {CustomEvent<ForgeAiChatbotAgentChangeEventData>} forge-ai-chatbot-agent-change - Fired when agent selection changes
- * @event {CustomEvent<ForgeAiChatbotLauncherThreadRenameEventData>} forge-ai-chatbot-launcher-thread-rename - Fired when thread rename is saved. Parent should update threadName property and call onSuccess() or onError()
- * @event {CustomEvent<ForgeAiChatbotLauncherThreadDeleteEventData>} forge-ai-chatbot-launcher-thread-delete - Fired when thread deletion is confirmed. Parent should delete thread and call onSuccess() or onError()
- * @event {CustomEvent<ForgeAiChatbotLauncherThreadSelectEventData>} forge-ai-chatbot-launcher-thread-select - Fired when a thread is selected from the history popover or full history view. Cancelable - prevents selectedThreadId from being set and the transition to the conversation view, leaving the host to commit both once its own load resolves
- * @event {CustomEvent<ForgeAiChatbotLauncherThreadSearchEventData>} forge-ai-chatbot-launcher-thread-search - Fired when the history search query changes (debounced). Cancelable - call setResults() with the results
- * @event {CustomEvent<ForgeAiChatbotLauncherThreadLoadMoreEventData>} forge-ai-chatbot-launcher-thread-load-more - Fired when scrolling near the bottom of the history list for pagination. Call appendResults() with the next page (empty array signals no more results)
- * @event {CustomEvent<void>} forge-ai-chatbot-launcher-new-chat - Fired when "New chat" is clicked from the full history view. Cancelable - prevents startNewChat() from being called
- * @event {CustomEvent<void>} forge-ai-chatbot-launcher-thread-retry - Fired when the retry button in the history error state is clicked. Re-request the chats and clear threadsError once the load succeeds
- */
-export declare class AiChatbotLauncherComponent extends AiChatbotBase {
-    #private;
-    static styles: CSSResult;
-    placeholder: string;
-    descriptionText?: string;
-    threadName?: string;
-    showHistoryButton: boolean;
-    showThreadRename: boolean;
-    showThreadDelete: boolean;
-    threads: Thread[];
-    totalThreads: number;
-    threadsLoading: boolean;
-    threadsError?: string;
-    selectedThreadId: string | null;
-    private _viewState;
-    private _skipAnimation;
-    private _editingThreadId;
-    private _historyPopoverOpen;
-    protected _messageThreadRef: Ref<AiMessageThreadComponent>;
-    protected _promptRef: Ref<AiPromptComponent>;
-    constructor();
-    protected _onConnected(): void;
-    startConversation(): void;
-    /**
-     * Returns to the welcome view without touching conversation state. Unlike `startNewChat()`, this
-     * leaves messages, `selectedThreadId`, and the adapter's thread untouched, so an abandoned thread
-     * selection can be undone without discarding the conversation the user was already in.
-     */
-    showWelcome(): void;
-    /**
-     * Navigates directly to the full history view (not the history popover).
-     */
-    showHistory(): void;
-    protected _handleInfo(): void;
-    protected _handleSend(evt: CustomEvent<ForgeAiPromptSendEventData>): Promise<void>;
-    protected _handleSuggestionSelect(evt: CustomEvent<ForgeAiSuggestionsEventData>): Promise<void>;
-    clearMessages(): boolean;
-    startNewChat(): void;
-    setMessages(messages: ChatMessage[]): void;
-    sendMessage(content: string, files?: File[]): Promise<void>;
-    setThreadState(threadState: ThreadState, options?: {
-        skipAnimation?: boolean;
-    }): Promise<void>;
-    get viewState(): LauncherViewState;
-    focus(): void;
-    render(): TemplateResult;
-}