@tylertech/forge-ai 0.14.0 → 0.15.1

package/dist/ai-chatbot/message-state-controller.mjs

@@ -58,7 +58,7 @@ class MessageStateController {
     this.#updateResponseInItems();
     this.#notifyStateChange();
   }
-  addTextToResponse(messageId, content, event) {
+  addTextToResponse(messageId, content) {
     const response = this._activeResponse ?? this.startResponse();
     response.isThinking = false;
     const lastChild = response.children[response.children.length - 1];
@@ -68,18 +68,10 @@ class MessageStateController {
     } else {
       response.children.push({ type: "text", messageId, content, status: "streaming" });
     }
-    if (event) {
-      this.#appendEventToResponse({
-        type: "message-start",
-        timestamp: Date.now(),
-        data: event,
-        rawEvent: event.rawEvent
-      });
-    }
     this.#updateResponseInItems();
     this.#notifyStateChange();
   }
-  appendTextDelta(messageId, delta, event) {
+  appendTextDelta(messageId, delta) {
     const response = this._activeResponse ?? this.startResponse();
     response.isThinking = false;
     const lastChild = response.children[response.children.length - 1];
@@ -88,18 +80,10 @@ class MessageStateController {
     } else {
       response.children.push({ type: "text", messageId, content: delta, status: "streaming" });
     }
-    if (event) {
-      this.#appendEventToResponse({
-        type: "message-delta",
-        timestamp: Date.now(),
-        data: event,
-        rawEvent: event.rawEvent
-      });
-    }
     this.#updateResponseInItems();
     this.#notifyStateChange();
   }
-  markTextComplete(messageId, event) {
+  markTextComplete(messageId) {
     if (!this._activeResponse) {
       return;
     }
@@ -107,37 +91,19 @@ class MessageStateController {
     if (textChild && textChild.type === "text") {
       textChild.status = "complete";
     }
-    if (event) {
-      this.#appendEventToResponse({
-        type: "message-end",
-        timestamp: Date.now(),
-        data: event,
-        rawEvent: event.rawEvent
-      });
-    }
     this.#updateResponseInItems();
     this.#notifyStateChange();
   }
-  addToolCallToResponse(toolCall, event) {
+  addToolCallToResponse(toolCall) {
     const response = this._activeResponse ?? this.startResponse();
     response.isThinking = false;
     const toolCallWithTimestamp = { ...toolCall, startTimestamp: Date.now() };
     this._toolCalls.set(toolCall.id, toolCallWithTimestamp);
     response.children.push({ type: "toolCall", data: toolCallWithTimestamp });
-    if (event) {
-      const streamEvent = {
-        type: "tool-call-start",
-        timestamp: Date.now(),
-        data: event,
-        rawEvent: event.rawEvent
-      };
-      this.#appendEventToResponse(streamEvent);
-      this.#appendEventToToolCallInResponse(toolCall.id, streamEvent);
-    }
     this.#updateResponseInItems();
     this.#notifyStateChange();
   }
-  updateToolCallInResponse(toolCallId, updates, eventData) {
+  updateToolCallInResponse(toolCallId, updates) {
     const toolCall = this._toolCalls.get(toolCallId);
     if (!toolCall) {
       return;
@@ -157,29 +123,6 @@ class MessageStateController {
         }
       }
     }
-    if (eventData) {
-      if (eventData.eventType === "tool-call-args") {
-        const argsEvent = eventData.event;
-        const streamEvent = {
-          type: "tool-call-args",
-          timestamp: Date.now(),
-          data: argsEvent,
-          rawEvent: argsEvent.rawEvent
-        };
-        this.#appendEventToResponse(streamEvent);
-        this.#appendEventToToolCallInResponse(toolCallId, streamEvent);
-      } else {
-        const endEvent = eventData.event;
-        const streamEvent = {
-          type: "tool-call-end",
-          timestamp: Date.now(),
-          data: endEvent,
-          rawEvent: endEvent.rawEvent
-        };
-        this.#appendEventToResponse(streamEvent);
-        this.#appendEventToToolCallInResponse(toolCallId, streamEvent);
-      }
-    }
     this.#updateResponseInItems();
     this.#notifyStateChange();
   }
@@ -188,16 +131,6 @@ class MessageStateController {
       result,
       status: event?.isError === true ? "error" : "complete"
     });
-    if (event) {
-      const streamEvent = {
-        type: "tool-result",
-        timestamp: Date.now(),
-        data: event,
-        rawEvent: event.rawEvent
-      };
-      this.#appendEventToResponse(streamEvent);
-      this.#appendEventToToolCallInResponse(toolCallId, streamEvent);
-    }
   }
   tryFinalizeResponse() {
     if (!this._activeResponse) {
@@ -221,29 +154,6 @@ class MessageStateController {
       return item;
     });
   }
-  #appendEventToResponse(event) {
-    if (!this._activeResponse) {
-      return;
-    }
-    this._activeResponse.eventStream = [...this._activeResponse.eventStream || [], event];
-  }
-  #appendEventToToolCallInResponse(toolCallId, event) {
-    const toolCall = this._toolCalls.get(toolCallId);
-    if (!toolCall) {
-      return;
-    }
-    const eventStream = [...toolCall.eventStream || [], event];
-    const updated = { ...toolCall, eventStream };
-    this._toolCalls.set(toolCallId, updated);
-    if (this._activeResponse) {
-      for (const child of this._activeResponse.children) {
-        if (child.type === "toolCall" && child.data.id === toolCallId) {
-          child.data = updated;
-          break;
-        }
-      }
-    }
-  }
   #notifyStateChange() {
     this._host.requestUpdate();
   }
@@ -251,21 +161,13 @@ class MessageStateController {
     this._messageItems = [...this._messageItems, item];
     this.#notifyStateChange();
   }
-  addMessage(message, event) {
+  addMessage(message) {
     this.tryFinalizeResponse();
     const existing = this.getMessage(message.id);
     if (existing) {
       return;
     }
     this.addMessageItem({ type: "message", data: message });
-    if (event) {
-      this.#appendEventToMessage(message.id, {
-        type: "message-start",
-        timestamp: Date.now(),
-        data: event,
-        rawEvent: event.rawEvent
-      });
-    }
     if (message.status === "complete" || message.status === "error") {
       this._config.onThreadSettled?.();
     }
@@ -308,21 +210,13 @@ class MessageStateController {
     this._messageItems = this._messageItems.filter((item) => !(item.type === "message" && item.data.id === id));
     this.#notifyStateChange();
   }
-  updateMessageStatus(id, status, event) {
+  updateMessageStatus(id, status) {
     this._messageItems = this._messageItems.map((item) => {
       if (item.type === "message" && item.data.id === id) {
         return { ...item, data: { ...item.data, status } };
       }
       return item;
     });
-    if (event) {
-      this.#appendEventToMessage(id, {
-        type: "message-end",
-        timestamp: Date.now(),
-        data: event,
-        rawEvent: event.rawEvent
-      });
-    }
     this.#notifyStateChange();
     if (status === "complete" || status === "error") {
       this._config.onThreadSettled?.();
@@ -373,7 +267,6 @@ class MessageStateController {
           timestamp: response.timestamp,
           status: response.status === "streaming" ? "streaming" : response.status === "error" ? "error" : "complete",
           toolCalls: toolCalls.length ? toolCalls : void 0,
-          eventStream: response.eventStream,
           feedback: response.feedback,
           children: response.children
         };
@@ -418,7 +311,6 @@ class MessageStateController {
           children,
           status: msg.status === "streaming" ? "streaming" : "complete",
           timestamp: msg.timestamp,
-          eventStream: msg.eventStream,
           feedback: msg.feedback
         };
         messageItems.push({ type: "assistant", data: response });
@@ -436,20 +328,6 @@ class MessageStateController {
       this.#notifyStateChange();
     }
   }
-  #appendEventToMessage(id, event) {
-    const messageExists = this._messageItems.some((item) => item.type === "message" && item.data.id === id);
-    if (!messageExists) {
-      return;
-    }
-    this._messageItems = this._messageItems.map((item) => {
-      if (item.type === "message" && item.data.id === id) {
-        const eventStream = [...item.data.eventStream || [], event];
-        return { ...item, data: { ...item.data, eventStream } };
-      }
-      return item;
-    });
-    this.#notifyStateChange();
-  }
 }
 export {
   MessageStateController

package/dist/ai-chatbot/request-serialization.d.ts

@@ -0,0 +1,33 @@
+import { ChatMessage, ToolCall } from './types.js';
+/**
+ * Wire shape for a tool call sent back to an agent endpoint: the final `args`
+ * and its `result`, and nothing else. Local-only fields (`eventStream`,
+ * `argsBuffer`, `children`, timing metadata) are deliberately absent - no
+ * backend reads them and they grow without bound across turns.
+ */
+export interface RequestToolCall {
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+    status: ToolCall['status'];
+    result?: unknown;
+}
+/** Wire shape for a single message sent to an agent endpoint. */
+export interface RequestMessage {
+    role: ChatMessage['role'];
+    content: string;
+    toolCallId?: string;
+    toolCalls?: RequestToolCall[];
+}
+/**
+ * Projects a tool call onto its wire shape. This is the single boundary at which
+ * local state is dropped, so adapters never have to remember to omit it.
+ */
+export declare function toRequestToolCall(toolCall: ToolCall): RequestToolCall;
+/**
+ * Projects the thread onto the messages an agent endpoint is sent: client-only
+ * messages and empty assistant turns are dropped, and every remaining message is
+ * rebuilt field by field rather than spread, so no local state can leak into a
+ * request body.
+ */
+export declare function toRequestMessages(messages: ChatMessage[]): RequestMessage[];

package/dist/ai-chatbot/request-serialization.mjs

@@ -0,0 +1,31 @@
+function toRequestToolCall(toolCall) {
+  const { id, name, args, status, result } = toolCall;
+  return {
+    id,
+    name,
+    args,
+    status,
+    ...result === void 0 ? {} : { result }
+  };
+}
+function toRequestMessages(messages) {
+  return messages.filter(isSendableMessage).map((message) => ({
+    role: message.role,
+    content: message.content,
+    ...message.toolCallId ? { toolCallId: message.toolCallId } : {},
+    ...message.toolCalls?.length ? { toolCalls: message.toolCalls.map(toRequestToolCall) } : {}
+  }));
+}
+function isSendableMessage(message) {
+  if (message.clientOnly) {
+    return false;
+  }
+  if (message.role === "assistant") {
+    return message.content.trim().length > 0 || !!message.toolCalls?.length;
+  }
+  return true;
+}
+export {
+  toRequestMessages,
+  toRequestToolCall
+};

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

@@ -100,76 +100,6 @@ export interface ToolDefinition<THandlerArgs = Record<string, unknown>> {
      */
     handler?: (context: HandlerContext<THandlerArgs>) => Promise<string | Record<string, unknown> | void> | string | Record<string, unknown> | void;
 }
-export interface MessageStartEvent {
-    messageId: string;
-}
-export interface MessageDeltaEvent {
-    messageId: string;
-    delta: string;
-}
-export interface MessageEndEvent {
-    messageId: string;
-}
-export interface ToolCallStartEvent {
-    id: string;
-    messageId: string;
-    name: string;
-}
-export interface ToolCallArgsEvent {
-    id: string;
-    messageId: string;
-    name: string;
-    argsBuffer: string;
-    partialArgs?: Record<string, unknown>;
-}
-export interface ToolCallEndEvent {
-    id: string;
-    messageId: string;
-    name: string;
-    args: Record<string, unknown>;
-}
-export interface ToolResultEvent {
-    toolCallId: string;
-    result: unknown;
-    message: ChatMessage;
-    isError?: boolean;
-}
-export type StreamEvent = {
-    type: 'message-start';
-    timestamp: number;
-    data: MessageStartEvent;
-    rawEvent?: unknown;
-} | {
-    type: 'message-delta';
-    timestamp: number;
-    data: MessageDeltaEvent;
-    rawEvent?: unknown;
-} | {
-    type: 'message-end';
-    timestamp: number;
-    data: MessageEndEvent;
-    rawEvent?: unknown;
-} | {
-    type: 'tool-call-start';
-    timestamp: number;
-    data: ToolCallStartEvent;
-    rawEvent?: unknown;
-} | {
-    type: 'tool-call-args';
-    timestamp: number;
-    data: ToolCallArgsEvent;
-    rawEvent?: unknown;
-} | {
-    type: 'tool-call-end';
-    timestamp: number;
-    data: ToolCallEndEvent;
-    rawEvent?: unknown;
-} | {
-    type: 'tool-result';
-    timestamp: number;
-    data: ToolResultEvent;
-    rawEvent?: unknown;
-};
 export interface ChatMessage {
     id: string;
     role: 'user' | 'assistant' | 'system' | 'tool';
@@ -178,7 +108,6 @@ export interface ChatMessage {
     status: 'pending' | 'streaming' | 'complete' | 'error';
     toolCalls?: ToolCall[];
     toolCallId?: string;
-    eventStream?: StreamEvent[];
     feedback?: ResponseFeedback;
     children?: ResponseItem[];
     clientOnly?: boolean;
@@ -217,7 +146,6 @@ export interface ToolCall<TArgs = Record<string, unknown>> {
     result?: unknown;
     status: 'pending' | 'parsing' | 'executing' | 'complete' | 'error';
     type: ToolType;
-    eventStream?: StreamEvent[];
     startTimestamp?: number;
     endTimestamp?: number;
 }
@@ -240,7 +168,6 @@ export interface AssistantResponse {
     children: ResponseItem[];
     status: 'streaming' | 'complete' | 'error';
     timestamp: number;
-    eventStream?: StreamEvent[];
     feedback?: ResponseFeedback;
     isThinking?: boolean;
 }

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

@@ -46,6 +46,7 @@ declare global {
         '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;
@@ -72,11 +73,13 @@ export declare const AiChatbotLauncherComponentTagName: keyof HTMLElementTagName
  * @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 gate the history button and its disabled state
+ * @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.
@@ -94,10 +97,11 @@ export declare const AiChatbotLauncherComponentTagName: keyof HTMLElementTagName
  * @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
+ * @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;
@@ -105,11 +109,13 @@ export declare class AiChatbotLauncherComponent extends AiChatbotBase {
     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;
@@ -120,6 +126,12 @@ export declare class AiChatbotLauncherComponent extends AiChatbotBase {
     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).
      */