@ensembleapp/client-sdk 0.0.55 → 0.0.56

package/dist/index.d.ts

@@ -86,6 +86,12 @@ interface ChatUsageData {
  * part is not a usage part.
  */
 declare function extractUsageData(dataPart: unknown): ChatUsageData | null;
+/**
+ * Build the GET /chat/messages URL for loading initial history. Appends
+ * `?limit=<n>` when `messagesToLoad` is provided (a positive number), otherwise
+ * returns the base URL so the server default applies.
+ */
+declare function buildMessagesUrl(baseUrl: string, messagesToLoad?: number): string;
 type UseChatConfig = DeprecatedChatConfig & {
     /** The server API configuration */
     api: ApiConfig;
@@ -97,6 +103,8 @@ type UseChatConfig = DeprecatedChatConfig & {
     agentVersion?: AgentVersion;
     /** additional context (anything) that needs to be passed to the LLM */
     dataContext?: unknown;
+    /** Number of most-recent messages to load into the chat on open/reload. Defaults to the server's default. */
+    messagesToLoad?: number;
     onError?: (error: Error) => void;
     /** Called when API returns 401/unauthorized (e.g., token expiry). Return a new token to retry the request. */
     onAuthError?: () => Promise<string | null>;
@@ -106,7 +114,7 @@ type UseChatConfig = DeprecatedChatConfig & {
     /** Called when usage data is received (token counts/percentages and message-history stats) */
     onUsage?: (usage: ChatUsageData) => void;
 };
-declare function useChat({ api, threadId, agentId, agentVersion, agentExecutionId, dataContext, onError, onAuthError, onFinish, onData, onMessage, onUsage, }: UseChatConfig): {
+declare function useChat({ api, threadId, agentId, agentVersion, agentExecutionId, dataContext, messagesToLoad, onError, onAuthError, onFinish, onData, onMessage, onUsage, }: UseChatConfig): {
     messages: ChatMessage[];
     status: ai.ChatStatus;
     isLoadingInitial: boolean;
@@ -661,4 +669,4 @@ declare const getVendorCardsWidget: (isProd?: boolean) => SDKUIWidgetDefinition[
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { type AgentVersion, type AnyUIWidgetDefinition, type ApiConfig, type ApprovalUIConfig, BriefDisplayMode, BriefDisplayMode as BriefRenderer, type ChatMessage, type ChatMessageSection, type ChatUsageData, ChatWidget, type ChatWidgetFeedbackOptions, type ChatWidgetHandle, type ChatWidgetConfig as ChatWidgetProps, type ChatWidgetSpeechToTextOptions, type ChatWidgetStyles, type ChatWidgetVoiceOptions, type CustomerReactDOM, type DisplayMode, type DisplayModeProps, type EmbeddableChatWidgetConfig, type EnrichedResults, type FeedbackConfig, type FeedbackHandlers, type FetchApprovalConfigOptions, FullDisplayMode, FullDisplayMode as FullRenderer, HideToolsDisplayMode, HideToolsDisplayMode as HideToolsRenderer, type InvokeTool, type MessageContext, MessageRenderer, type MessageRendererProps, type PendingToolApproval, type PendingToolOutput, type PopupAnchorConfig, PopupChatWidget, type PopupChatWidgetProps, type DisplayModeProps as RendererProps, type SDKUIWidgetDefinition, SDK_WIDGET_MARKER, type StructuredMessagePayload, type SubmitFeedbackParams, TagGroupDisplay, type TagGroupDisplayProps, ToolCallDisplay, type ToolCallDisplayProps, type ToolInvokeRequest, type ToolInvokeResult, type ToolPart, type UIMessagePart, type UIWidgetDefinition, type UseChatConfig, type UseFeedbackConfig, type WidgetRenderOptions, cn, createSDKWidget, createWidget, defaultChatWidgets, extractUsageData, fetchApprovalConfig, getVendorCardsWidget, isSDKWidget, registerChatWidgets, transformMessage, useChat, useFeedback };
+export { type AgentVersion, type AnyUIWidgetDefinition, type ApiConfig, type ApprovalUIConfig, BriefDisplayMode, BriefDisplayMode as BriefRenderer, type ChatMessage, type ChatMessageSection, type ChatUsageData, ChatWidget, type ChatWidgetFeedbackOptions, type ChatWidgetHandle, type ChatWidgetConfig as ChatWidgetProps, type ChatWidgetSpeechToTextOptions, type ChatWidgetStyles, type ChatWidgetVoiceOptions, type CustomerReactDOM, type DisplayMode, type DisplayModeProps, type EmbeddableChatWidgetConfig, type EnrichedResults, type FeedbackConfig, type FeedbackHandlers, type FetchApprovalConfigOptions, FullDisplayMode, FullDisplayMode as FullRenderer, HideToolsDisplayMode, HideToolsDisplayMode as HideToolsRenderer, type InvokeTool, type MessageContext, MessageRenderer, type MessageRendererProps, type PendingToolApproval, type PendingToolOutput, type PopupAnchorConfig, PopupChatWidget, type PopupChatWidgetProps, type DisplayModeProps as RendererProps, type SDKUIWidgetDefinition, SDK_WIDGET_MARKER, type StructuredMessagePayload, type SubmitFeedbackParams, TagGroupDisplay, type TagGroupDisplayProps, ToolCallDisplay, type ToolCallDisplayProps, type ToolInvokeRequest, type ToolInvokeResult, type ToolPart, type UIMessagePart, type UIWidgetDefinition, type UseChatConfig, type UseFeedbackConfig, type WidgetRenderOptions, buildMessagesUrl, cn, createSDKWidget, createWidget, defaultChatWidgets, extractUsageData, fetchApprovalConfig, getVendorCardsWidget, isSDKWidget, registerChatWidgets, transformMessage, useChat, useFeedback };

package/dist/index.js

@@ -4226,6 +4226,13 @@ function extractUsageData(dataPart) {
   }
   return null;
 }
+function buildMessagesUrl(baseUrl, messagesToLoad) {
+  const base = `${baseUrl}/chat/messages`;
+  if (messagesToLoad != null && Number.isFinite(messagesToLoad) && messagesToLoad > 0) {
+    return `${base}?limit=${messagesToLoad}`;
+  }
+  return base;
+}
 var EMPTY_HEADERS = {};
 function useChat({
   api,
@@ -4234,6 +4241,7 @@ function useChat({
   agentVersion,
   agentExecutionId,
   dataContext,
+  messagesToLoad,
   onError,
   onAuthError,
   onFinish,
@@ -4338,7 +4346,7 @@ function useChat({
     const fetchInitialMessages = async () => {
       hasFetchedRef.current = true;
       try {
-        const response = await authFetch(`${baseUrl}/chat/messages`, {
+        const response = await authFetch(buildMessagesUrl(baseUrl, messagesToLoad), {
           method: "GET",
           headers: {
             "thread-id": threadId,
@@ -4362,7 +4370,7 @@ function useChat({
       }
     };
     fetchInitialMessages();
-  }, [agentExecutionId, agentId, authFetch, baseUrl, customHeadersKey, threadId]);
+  }, [agentExecutionId, agentId, authFetch, baseUrl, customHeadersKey, threadId, messagesToLoad]);
   useEffect(() => {
     if (!onMessage || messages.length === 0) return;
     const lastMessage = messages[messages.length - 1];
@@ -9725,6 +9733,7 @@ var ChatWidget = forwardRef(function ChatWidget2({
   agentVersion,
   agentExecutionId,
   dataContext,
+  messagesToLoad,
   displayMode = "brief",
   onError,
   onAuthError,
@@ -9833,6 +9842,7 @@ var ChatWidget = forwardRef(function ChatWidget2({
     agentVersion,
     agentExecutionId: agentExecutionId ?? void 0,
     dataContext,
+    messagesToLoad,
     onError,
     onAuthError,
     onFinish,
@@ -10958,6 +10968,7 @@ export {
   SDK_WIDGET_MARKER,
   TagGroupDisplay,
   ToolCallDisplay,
+  buildMessagesUrl,
   cn,
   createSDKWidget,
   createWidget,