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

package/dist/ai-chatbot/utils.mjs

@@ -1,114 +0,0 @@
-import { v4 } from "uuid";
-import { renderInlineMarkdown, renderMarkdown } from "../utils/markdown.mjs";
-function shouldShowToolRenderer(toolCall, toolDefinition) {
-  if (!toolDefinition?.renderer) {
-    return false;
-  }
-  if (toolCall.status === "complete") {
-    return true;
-  }
-  return !!toolDefinition.renderOnStart && (toolCall.status === "parsing" || toolCall.status === "executing");
-}
-function isToolCallSettled(toolCall, toolDefinition) {
-  return toolCall.status === "complete" || toolCall.status === "error" || toolCall.status === "cancelled" || shouldShowToolRenderer(toolCall, toolDefinition);
-}
-function rendersAsMcpAppWidget(toolCall) {
-  return !!toolCall.uiResource || !!toolCall.uiResourceStatus;
-}
-function generateId() {
-  return v4();
-}
-function downloadFile(content, filename, mimeType = "text/plain") {
-  const blob = new Blob([content], { type: mimeType });
-  const url = URL.createObjectURL(blob);
-  const link = document.createElement("a");
-  link.href = url;
-  link.download = filename;
-  document.body.appendChild(link);
-  link.click();
-  document.body.removeChild(link);
-  URL.revokeObjectURL(url);
-}
-function fileAttachmentsToContextItems(completedAttachments, pendingAttachments) {
-  const pending = pendingAttachments.map((file) => ({
-    id: file.id,
-    label: file.filename,
-    sublabel: formatBytes(file.size),
-    loading: file.uploading ?? true,
-    removable: true,
-    type: "file"
-  }));
-  const completed = completedAttachments.map((file) => ({
-    id: file.id,
-    label: file.filename,
-    sublabel: formatBytes(file.size),
-    removable: true,
-    type: "file"
-  }));
-  return [...pending, ...completed];
-}
-function formatToolCallForExport(toolCall) {
-  const lines = [`  - Tool: ${toolCall.name}`, `    Args: ${JSON.stringify(toolCall.args)}`];
-  if (toolCall.status === "error") {
-    const errorMsg = typeof toolCall.result === "object" && toolCall.result !== null && "error" in toolCall.result ? toolCall.result.error : "Unknown error";
-    lines.push(`    Error: ${errorMsg}`);
-  } else if (toolCall.status === "cancelled") {
-    lines.push("    Cancelled");
-  } else if (toolCall.result !== void 0) {
-    lines.push(`    Result: ${JSON.stringify(toolCall.result)}`);
-  }
-  return lines.join("\n");
-}
-function formatChatTranscript(messages, { includeToolCalls = false } = {}) {
-  return messages.map((message) => {
-    const timestamp = new Date(message.timestamp).toLocaleString();
-    const role = message.role === "user" ? "You" : "Agent";
-    const body = message.children?.length ? formatInterleavedBody(message.children, includeToolCalls) : formatFlatBody(message, includeToolCalls);
-    return `[${timestamp}] ${role}:
-${body}
-`;
-  }).join("\n");
-}
-function formatInterleavedBody(children, includeToolCalls) {
-  return children.map((item) => {
-    if (item.type === "text") {
-      return item.content;
-    }
-    return includeToolCalls ? formatToolCallForExport(item.data) : "";
-  }).filter((part) => part.trim().length > 0).join("\n\n");
-}
-function formatFlatBody(message, includeToolCalls) {
-  let body = message.content;
-  if (includeToolCalls && message.toolCalls?.length) {
-    body += "\n" + message.toolCalls.map(formatToolCallForExport).join("\n\n") + "\n";
-  }
-  return body;
-}
-function createChatExportFilename(agentName) {
-  const timestamp = (/* @__PURE__ */ new Date()).toISOString().slice(0, 19).replace(/:/g, "-");
-  const slug = agentName?.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
-  const prefix = slug ? `${slug}-` : "";
-  return `${prefix}chat-history-${timestamp}.txt`;
-}
-function formatBytes(bytes) {
-  if (bytes === 0) {
-    return "0 B";
-  }
-  const k = 1024;
-  const sizes = ["B", "KB", "MB", "GB"];
-  const i = Math.floor(Math.log(bytes) / Math.log(k));
-  return `${Math.round(bytes / Math.pow(k, i) * 100) / 100} ${sizes[i]}`;
-}
-export {
-  createChatExportFilename,
-  downloadFile,
-  fileAttachmentsToContextItems,
-  formatChatTranscript,
-  formatToolCallForExport,
-  generateId,
-  isToolCallSettled,
-  renderInlineMarkdown,
-  renderMarkdown,
-  rendersAsMcpAppWidget,
-  shouldShowToolRenderer
-};

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

@@ -1,190 +0,0 @@
-import { PropertyValues, TemplateResult, CSSResult } from 'lit';
-import { AiMessageThreadComponent } from '../ai-message-thread';
-import { AiPromptComponent, ForgeAiPromptSendEventData } from '../ai-prompt';
-import { ForgeAiSuggestionsEventData } from '../ai-suggestions';
-import { AiChatbotBase, FeatureToggle } from '../ai-chatbot/ai-chatbot-base.js';
-import { ChatMessage, ThreadState } from '../ai-chatbot/types.js';
-import { CanvasOpenEventData, OpenCanvasOptions } from '../core/canvas-controller.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;
-}
-export type { OpenCanvasOptions };
-export type ForgeAiChatbotLauncherCanvasOpenEventData = CanvasOpenEventData;
-export interface ForgeAiChatbotLauncherCanvasResizeEventData {
-    /** Width of the conversation column in pixels; the canvas takes the remaining width. */
-    chatWidth: number;
-}
-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>;
-        'forge-ai-chatbot-launcher-canvas-open': CustomEvent<ForgeAiChatbotLauncherCanvasOpenEventData>;
-        'forge-ai-chatbot-launcher-canvas-close': CustomEvent<void>;
-        'forge-ai-chatbot-launcher-canvas-resize': CustomEvent<ForgeAiChatbotLauncherCanvasResizeEventData>;
-    }
-}
-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.
- *
- * In conversation mode an artifact canvas can open beside the thread via `openCanvas()`, a tool definition's
- * `canvas` config, or a renderer's `forge-ai-canvas-open-request`. The conversation narrows to a sidebar-style
- * column and the canvas takes the remaining width. The canvas closes whenever the conversation view is left.
- *
- * @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)
- * @slot canvas - Content shown in the canvas when `openCanvas()` is called without `content`
- * @slot canvas-actions - Action buttons rendered in the canvas header before the close button
- *
- * @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.
- * @property {string} canvasTitle - Default title for the canvas header, used when the open request does not supply one
- * @property {FeatureToggle} canvasResizable - Controls the drag handle between the conversation and the canvas. `'on'` (default) lets users resize with a pointer or the arrow keys; `'off'` hides it, so the conversation stays at `chatWidth`.
- * @property {number} chatWidth - Width in pixels of the conversation column while the canvas is open (default: 420). Updated as the user resizes, clamped to at least 360px and to leave the canvas at least 320px when there is room. Resized widths are persisted per tab in sessionStorage and shared across tabs via localStorage; on load the session value is preferred, then the local value, then the default.
- *
- * @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
- * @event {CustomEvent<ForgeAiChatbotLauncherCanvasOpenEventData>} forge-ai-chatbot-launcher-canvas-open - Fired before the canvas opens or replaces its content. Cancelable - prevents the canvas from opening
- * @event {CustomEvent<ForgeAiChatbotLauncherCanvasResizeEventData>} forge-ai-chatbot-launcher-canvas-resize - Fired when a resize is committed via pointer release or keyboard step. Detail has the new `chatWidth`
- * @event {CustomEvent<void>} forge-ai-chatbot-launcher-canvas-close - Fired when the canvas closes. Cancelable only for user or `closeCanvas()` initiated closes; closes caused by leaving the conversation view cannot be prevented
- */
-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;
-    canvasTitle?: string;
-    canvasResizable: FeatureToggle;
-    chatWidth: number;
-    private _viewState;
-    private _isResizing;
-    private _skipAnimation;
-    private _editingThreadId;
-    private _historyPopoverOpen;
-    protected _messageThreadRef: Ref<AiMessageThreadComponent>;
-    protected _promptRef: Ref<AiPromptComponent>;
-    constructor();
-    protected _onConnected(): void;
-    willUpdate(changedProperties: PropertyValues<this>): void;
-    updated(changedProperties: PropertyValues<this>): 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;
-    get canvasOpen(): boolean;
-    /**
-     * Opens the canvas beside the conversation, or swaps its content if already open. Only available in the
-     * conversation view; returns false elsewhere or when the open event is prevented.
-     */
-    openCanvas(options?: OpenCanvasOptions): boolean;
-    /**
-     * Closes the canvas. Returns false if it was not open or the close event was prevented.
-     */
-    closeCanvas(): boolean;
-    focus(): void;
-    render(): TemplateResult;
-}