@ensembleapp/client-sdk 0.0.18 → 0.0.20

package/dist/index.d.ts

@@ -41,15 +41,17 @@ type ToolCallConfig = {
  * ```
  */
 type WidgetEnrichConfig = Record<string, ToolCallConfig>;
-/** Enrichment result containing the full tool response. This should mirror ToolResult on server-side. */
-type EnrichmentResult$1 = {
+/**
+ * Enrichment result containing the full tool response.
+ * This should mirror ToolResult on server-side without debug/metadata info.
+ */
+type EnrichmentResult<TData = unknown> = {
     success: boolean;
     error?: {
-        message: string;
+        message?: string;
         code?: string;
     };
-    data?: unknown;
-    metadata?: Record<string, unknown>;
+    data?: TData;
 };
 /** Widget output shape sent to the client */
 type UIWidget = {
@@ -57,7 +59,7 @@ type UIWidget = {
     /** LLM-generated data based on the widget schema specified by the client */
     payload: unknown;
     /** Server-injected enrichment results from tool calls, keyed by enrichment name */
-    enriched?: Record<string, EnrichmentResult$1>;
+    enriched?: Record<string, EnrichmentResult>;
 };
 
 type DeprecatedChatConfig = {
@@ -176,16 +178,6 @@ declare function useFeedback({ api, threadId, agentId, agentExecutionId, }: UseF
     error: Error | null;
 };
 
-/** Enrichment result containing the full tool response - this should mirror ToolResult */
-interface EnrichmentResult<TData = unknown> {
-    success: boolean;
-    error?: {
-        message: string;
-        code?: string;
-    };
-    data?: TData;
-    metadata?: Record<string, unknown>;
-}
 /** Enriched results keyed by enrichment name */
 type EnrichedResults<T = unknown> = Record<string, EnrichmentResult<T>>;
 interface UIWidgetDefinition<TSchema extends AnyZodObject = AnyZodObject, TEnriched extends EnrichedResults = EnrichedResults> {
@@ -253,8 +245,12 @@ interface ChatWidgetFeedbackOptions {
 interface ChatWidgetConfig extends UseChatConfig {
     /** Title for the Chat window */
     title?: string;
-    /** Introductory message displayed at the start of the chat for brand new threads */
-    introMessage?: string;
+    /** Initial assistant message displayed at the start of the chat (if history is empty).
+     * Skipped if initialUserMessage is provided. */
+    initialAssistantMessage?: string;
+    /** Initial user message to send automatically when the chat loads (if history is empty).
+     * Use this to kick-start the conversation without requiring user input. */
+    initialUserMessage?: string;
     /** Placeholder text for the input box */
     inputPlaceholder?: string;
     className?: string;
@@ -265,7 +261,7 @@ interface ChatWidgetConfig extends UseChatConfig {
     /** Feedback options for assistant messages. Enabled by default. */
     feedback?: ChatWidgetFeedbackOptions;
 }
-declare function ChatWidget({ api, threadId, agentId, agentExecutionId, dataContext, onError, onAuthError, onFinish, onMessage, title, introMessage, inputPlaceholder, className, styles: styleProps, voice, speechToText, widgets, feedback, }: ChatWidgetConfig): react_jsx_runtime.JSX.Element;
+declare function ChatWidget({ api, threadId, agentId, agentExecutionId, dataContext, onError, onAuthError, onFinish, onMessage, title, initialAssistantMessage, initialUserMessage, inputPlaceholder, className, styles: styleProps, voice, speechToText, widgets, feedback, }: ChatWidgetConfig): react_jsx_runtime.JSX.Element;
 
 interface PopupAnchorConfig {
     enabled?: boolean;
@@ -358,4 +354,4 @@ declare const defaultChatWidgets: UIWidgetDefinition[];
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { type ApiConfig, type ChatContentItem, type ChatMessage, ChatWidget, type ChatWidgetFeedbackOptions, type ChatWidgetInstance, type ChatWidgetConfig as ChatWidgetProps, type ChatWidgetSpeechToTextOptions, type ChatWidgetStyles, type ChatWidgetVoiceOptions, type EmbeddableChatWidgetConfig, type EnrichedResults, type EnrichmentResult, type FeedbackRating, type FeedbackState, type MessageFeedback, type MessageSection, type PopupAnchorConfig, PopupChatWidget, type PopupChatWidgetProps, type SubmitFeedbackParams, type TagGroup, TagGroupDisplay, type TagGroupDisplayProps, type ToolCallContent, ToolCallDisplay, type ToolCallDisplayProps, type UIWidgetDefinition, type UseChatConfig, type UseFeedbackConfig, type WidgetEnrichConfig, cn, createChatWidget, createWidget, defaultChatWidgets, registerChatWidgets, useChat, useFeedback };
+export { type ApiConfig, type ChatContentItem, type ChatMessage, ChatWidget, type ChatWidgetFeedbackOptions, type ChatWidgetInstance, type ChatWidgetConfig as ChatWidgetProps, type ChatWidgetSpeechToTextOptions, type ChatWidgetStyles, type ChatWidgetVoiceOptions, type EmbeddableChatWidgetConfig, type EnrichedResults, type FeedbackRating, type FeedbackState, type MessageFeedback, type MessageSection, type PopupAnchorConfig, PopupChatWidget, type PopupChatWidgetProps, type SubmitFeedbackParams, type TagGroup, TagGroupDisplay, type TagGroupDisplayProps, type ToolCallContent, ToolCallDisplay, type ToolCallDisplayProps, type UIWidgetDefinition, type UseChatConfig, type UseFeedbackConfig, type WidgetEnrichConfig, cn, createChatWidget, createWidget, defaultChatWidgets, registerChatWidgets, useChat, useFeedback };

package/dist/index.js

@@ -24422,7 +24422,8 @@ function ChatWidget({
   onFinish,
   onMessage,
   title,
-  introMessage,
+  initialAssistantMessage,
+  initialUserMessage,
   inputPlaceholder,
   className,
   styles: styleProps,
@@ -24532,14 +24533,21 @@ function ChatWidget({
     };
   }, [voice]);
   useEffect4(() => {
-    if (introMessage && messages.length === 0) {
+    if (initialAssistantMessage && !initialUserMessage && messages.length === 0) {
       setMessages([{
         id: "welcome-message",
         role: "assistant",
-        parts: [{ type: "text", text: introMessage }]
+        parts: [{ type: "text", text: initialAssistantMessage }]
       }]);
     }
-  }, [introMessage, messages.length, setMessages]);
+  }, [initialAssistantMessage, initialUserMessage, messages.length, setMessages]);
+  const initialMessageSentRef = useRef3(false);
+  useEffect4(() => {
+    if (initialUserMessage && !initialMessageSentRef.current && status === "ready" && messages.length === 0) {
+      initialMessageSentRef.current = true;
+      sendMessage({ text: initialUserMessage });
+    }
+  }, [initialUserMessage, status, messages.length, sendMessage]);
   const handleScroll = useCallback4(() => {
     if (!scrollContainerRef.current) return;
     const { scrollTop, scrollHeight, clientHeight } = scrollContainerRef.current;
@@ -24908,7 +24916,7 @@ function VendorCards({ payload, enriched }) {
   };
   return /* @__PURE__ */ jsx8("div", { style: { display: "flex", flexDirection: "column", gap: "0.75rem" }, children: payload.vendors.map((v, index) => {
     const data = vendorData[v.vendor_id];
-    const name17 = data?.names?.find((n) => n.type === "org")?.value ?? "";
+    const name17 = data?.names?.[0]?.value ?? "Unknown";
     const address = data?.location?.address;
     const distanceEntry = distances.find((d) => d.destinationIndex === index);
     const distance = distanceEntry && distanceEntry.distanceMeters ? formatDistance(distanceEntry.distanceMeters) : void 0;
@@ -25017,7 +25025,7 @@ var defaultChatWidgets = [
     widgetType: "person-card",
     schema: zod_default.object({
       name: zod_default.string(),
-      profileUri: zod_default.string().optional(),
+      photoUri: zod_default.string().optional().describe("URL to a photo of the person"),
       details: zod_default.record(zod_default.any()).optional()
     }).describe("showing a person card with name, photo and additional details"),
     render: (payload) => /* @__PURE__ */ jsx9(
@@ -25034,10 +25042,10 @@ var defaultChatWidgets = [
           boxShadow: "0 1px 3px 0 rgba(0, 0, 0, 0.1), 0 1px 2px 0 rgba(0, 0, 0, 0.06)"
         },
         children: /* @__PURE__ */ jsxs8("div", { style: { display: "flex", alignItems: "flex-start", gap: "0.75rem" }, children: [
-          payload.profileUri && /* @__PURE__ */ jsx9(
+          payload.photoUri && /* @__PURE__ */ jsx9(
             "img",
             {
-              src: payload.profileUri,
+              src: payload.photoUri,
               alt: payload.name,
               style: {
                 width: "3rem",