@arcgis/ai-components 5.2.0-next.0 → 5.2.0-next.10

package/dist/index.d.ts

@@ -34,6 +34,7 @@ import type { ArcgisAssistantNavigationAgent } from "./components/arcgis-assista
 import type { ArcgisAssistantChat } from "./components/arcgis-assistant-chat/customElement.js";
 import type { ArcgisAssistantChatEntry } from "./components/arcgis-assistant-chat-entry/customElement.js";
 import type { ArcgisAssistantInterrupt } from "./components/arcgis-assistant-interrupt/customElement.js";
+import type { ArcgisAssistantMessage } from "./components/arcgis-assistant-message/customElement.js";
 import type { ArcgisAssistantMessageBlock } from "./components/arcgis-assistant-message-block/customElement.js";
 import type { ArcgisAssistantMessageFeedback } from "./components/arcgis-assistant-message-feedback/customElement.js";
 import type { ArcgisAssistantMessageFooter } from "./components/arcgis-assistant-message-footer/customElement.js";
@@ -91,6 +92,7 @@ declare global {
     "arcgis-assistant-chat": ArcgisAssistantChat;
     "arcgis-assistant-chat-entry": ArcgisAssistantChatEntry;
     "arcgis-assistant-interrupt": ArcgisAssistantInterrupt;
+    "arcgis-assistant-message": ArcgisAssistantMessage;
     "arcgis-assistant-message-block": ArcgisAssistantMessageBlock;
     "arcgis-assistant-message-feedback": ArcgisAssistantMessageFeedback;
     "arcgis-assistant-message-footer": ArcgisAssistantMessageFooter;
@@ -127,6 +129,8 @@ declare global {
   type HTMLArcgisAssistantInterruptElementEventMap = ArcgisAssistantInterrupt["@eventTypes"];
   type HTMLArcgisAssistantInterruptElement = ArcgisAssistantInterrupt;
 
+  type HTMLArcgisAssistantMessageElement = ArcgisAssistantMessage;
+
   type HTMLArcgisAssistantMessageBlockElement = ArcgisAssistantMessageBlock;
 
   type HTMLArcgisAssistantMessageFeedbackElementEventMap = ArcgisAssistantMessageFeedback["@eventTypes"];

package/dist/loader.js

@@ -2,21 +2,22 @@
 import { r as e } from "./chunks/runtime.js";
 import { makeDefineCustomElements as s } from "@arcgis/lumina";
 const n = s(e, {
-  "arcgis-assistant": [() => import("./components/arcgis-assistant/customElement.js"), "_messages:,awaitingResponse:,awaitingResponseStep:,copyEnabled,description,entryMessage,feedbackEnabled,heading,interrupt:,keepSuggestedPrompts,logEnabled,messages:,orchestrator:,readAloudEnabled,referenceElement,suggestedPrompts:,voiceInputEnabled;clearChatHistory,submitMessage;cancelInterrupt,register,submitInterrupt"],
+  "arcgis-assistant": [() => import("./components/arcgis-assistant/customElement.js"), "_messages:,assistantAvatarEnabled,awaitingResponse:,awaitingResponseStep:,copyEnabled,description,entryMessage,feedbackEnabled,heading,interrupt:,keepSuggestedPrompts,logEnabled,messages:,orchestrator:,readAloudEnabled,referenceElement,suggestedPrompts:,voiceInputEnabled;clearChatHistory,submitMessage;cancelInterrupt,register,submitInterrupt"],
   "arcgis-assistant-agent": [() => import("./components/arcgis-assistant-agent/customElement.js"), "agent:,context:;getContext"],
   "arcgis-assistant-data-exploration-agent": [() => import("./components/arcgis-assistant-data-exploration-agent/customElement.js"), "referenceElement;;getContext"],
   "arcgis-assistant-help-agent": [() => import("./components/arcgis-assistant-help-agent/customElement.js"), "referenceElement;;getContext"],
   "arcgis-assistant-knowledge-agent": [() => import("./components/arcgis-assistant-knowledge-agent/customElement.js"), "context:,referenceElement,serviceUrl;getContext"],
   "arcgis-assistant-layer-styling-agent": [() => import("./components/arcgis-assistant-layer-styling-agent/customElement.js"), "referenceElement;;getContext"],
   "arcgis-assistant-navigation-agent": [() => import("./components/arcgis-assistant-navigation-agent/customElement.js"), "referenceElement;;getContext"],
-  "arcgis-assistant-chat": [() => import("./components/arcgis-assistant-chat/customElement.js"), "loading,messages:"],
-  "arcgis-assistant-chat-entry": [() => import("./components/arcgis-assistant-chat-entry/customElement.js"), "_messages:,awaitingResponse,entryPlaceholder,inputValue,keyboardShortcutsDisabled,messages:,status,voiceInputEnabled;submitMessage"],
+  "arcgis-assistant-chat": [() => import("./components/arcgis-assistant-chat/customElement.js"), "interrupt:,loading,messages:"],
+  "arcgis-assistant-chat-entry": [() => import("./components/arcgis-assistant-chat-entry/customElement.js"), "_messages:,awaitingResponse,disabled,entryPlaceholder,inputValue,keyboardShortcutsDisabled,messages:,status,voiceInputEnabled;submitMessage"],
   "arcgis-assistant-interrupt": [() => import("./components/arcgis-assistant-interrupt/customElement.js"), "_messages:,message,options:,type"],
-  "arcgis-assistant-message": [() => import("./components/arcgis-assistant-message/customElement.js"), "copyEnabled,feedbackEnabled,footerDisabled,logEnabled,message:,readAloudEnabled"],
+  "arcgis-assistant-interrupt-preview": [() => import("./components/arcgis-assistant-interrupt-preview/customElement.js"), "interrupts:"],
+  "arcgis-assistant-message": [() => import("./components/arcgis-assistant-message/customElement.js"), "assistantAvatarEnabled,copyEnabled,feedbackEnabled,footerDisabled,logEnabled,message:,readAloudEnabled"],
   "arcgis-assistant-message-block": [() => import("./components/arcgis-assistant-message-block/customElement.js"), "block:"],
   "arcgis-assistant-message-feedback": [() => import("./components/arcgis-assistant-message-feedback/customElement.js"), "_messages:,feedbackEnabled,message:"],
   "arcgis-assistant-message-footer": [() => import("./components/arcgis-assistant-message-footer/customElement.js"), "_messages:,copyEnabled,feedbackEnabled,logEnabled,message:,readAloudEnabled"],
-  "arcgis-assistant-message-loading": [() => import("./components/arcgis-assistant-message-loading/customElement.js"), "loading,loadingMessage"],
+  "arcgis-assistant-message-loading": [() => import("./components/arcgis-assistant-message-loading/customElement.js"), "assistantAvatarEnabled,interrupts:,loading,loadingMessage"],
   "arcgis-assistant-message-log": [() => import("./components/arcgis-assistant-message-log/customElement.js"), "log:,logEnabled,showLog"],
   "arcgis-assistant-message-read-aloud": [() => import("./components/arcgis-assistant-message-read-aloud/customElement.js"), "_messages:,message:,readAloudEnabled"],
   "arcgis-assistant-message-text": [() => import("./components/arcgis-assistant-message-text/customElement.js"), "content"],

package/dist/types/lumina.d.ts

@@ -9,6 +9,7 @@ import type { ArcgisAssistantNavigationAgent } from "../components/arcgis-assist
 import type { ArcgisAssistantChat } from "../components/arcgis-assistant-chat/customElement.js";
 import type { ArcgisAssistantChatEntry } from "../components/arcgis-assistant-chat-entry/customElement.js";
 import type { ArcgisAssistantInterrupt } from "../components/arcgis-assistant-interrupt/customElement.js";
+import type { ArcgisAssistantMessage } from "../components/arcgis-assistant-message/customElement.js";
 import type { ArcgisAssistantMessageBlock } from "../components/arcgis-assistant-message-block/customElement.js";
 import type { ArcgisAssistantMessageFeedback } from "../components/arcgis-assistant-message-feedback/customElement.js";
 import type { ArcgisAssistantMessageFooter } from "../components/arcgis-assistant-message-footer/customElement.js";
@@ -21,7 +22,7 @@ import type { ArcgisAssistantSuggestedPrompts } from "../components/arcgis-assis
 import type { ArcgisAssistantUserMessage } from "../components/arcgis-assistant-user-message/customElement.js";
 import type { h, EventHandler } from "@arcgis/lumina";
 
-interface LuminaArcgisAssistant extends Partial<Pick<ArcgisAssistant, "copyEnabled" | "description" | "entryMessage" | "feedbackEnabled" | "heading" | "keepSuggestedPrompts" | "logEnabled" | "messages" | "referenceElement" | "suggestedPrompts">>, h.JSX.HTMLAttributes<ArcgisAssistant> {
+interface LuminaArcgisAssistant extends Partial<Pick<ArcgisAssistant, "assistantAvatarEnabled" | "copyEnabled" | "description" | "entryMessage" | "feedbackEnabled" | "heading" | "keepSuggestedPrompts" | "logEnabled" | "messages" | "referenceElement" | "suggestedPrompts">>, h.JSX.HTMLAttributes<ArcgisAssistant> {
   onarcgisCancel?: EventHandler<ArcgisAssistant["arcgisCancel"]>;
   onarcgisError?: EventHandler<ArcgisAssistant["arcgisError"]>;
   onarcgisFeedback?: EventHandler<ArcgisAssistant["arcgisFeedback"]>;
@@ -30,6 +31,7 @@ interface LuminaArcgisAssistant extends Partial<Pick<ArcgisAssistant, "copyEnabl
   onarcgisInterruptSubmit?: EventHandler<ArcgisAssistant["arcgisInterruptSubmit"]>;
   onarcgisPromptSelect?: EventHandler<ArcgisAssistant["arcgisPromptSelect"]>;
   onarcgisReady?: EventHandler<ArcgisAssistant["arcgisReady"]>;
+  onarcgisResponse?: EventHandler<ArcgisAssistant["arcgisResponse"]>;
   onarcgisSlottableRequest?: EventHandler<ArcgisAssistant["arcgisSlottableRequest"]>;
   onarcgisSubmit?: EventHandler<ArcgisAssistant["arcgisSubmit"]>;
 }
@@ -52,10 +54,10 @@ interface LuminaArcgisAssistantLayerStylingAgent extends Partial<Pick<ArcgisAssi
 interface LuminaArcgisAssistantNavigationAgent extends Partial<Pick<ArcgisAssistantNavigationAgent, "referenceElement">>, h.JSX.HTMLAttributes<ArcgisAssistantNavigationAgent> {
 }
 
-interface LuminaArcgisAssistantChat extends Partial<Pick<ArcgisAssistantChat, "loading" | "messages">>, h.JSX.HTMLAttributes<ArcgisAssistantChat> {
+interface LuminaArcgisAssistantChat extends Partial<Pick<ArcgisAssistantChat, "interrupt" | "loading" | "messages">>, h.JSX.HTMLAttributes<ArcgisAssistantChat> {
 }
 
-interface LuminaArcgisAssistantChatEntry extends Partial<Pick<ArcgisAssistantChatEntry, "awaitingResponse" | "entryPlaceholder" | "inputValue" | "keyboardShortcutsDisabled" | "messages" | "status" | "voiceInputEnabled">>, h.JSX.HTMLAttributes<ArcgisAssistantChatEntry> {
+interface LuminaArcgisAssistantChatEntry extends Partial<Pick<ArcgisAssistantChatEntry, "awaitingResponse" | "disabled" | "entryPlaceholder" | "inputValue" | "keyboardShortcutsDisabled" | "messages" | "status" | "voiceInputEnabled">>, h.JSX.HTMLAttributes<ArcgisAssistantChatEntry> {
   onarcgisCancel?: EventHandler<ArcgisAssistantChatEntry["arcgisCancel"]>;
   onarcgisSubmit?: EventHandler<ArcgisAssistantChatEntry["arcgisSubmit"]>;
 }
@@ -65,6 +67,9 @@ interface LuminaArcgisAssistantInterrupt extends Partial<Pick<ArcgisAssistantInt
   onarcgisSubmit?: EventHandler<ArcgisAssistantInterrupt["arcgisSubmit"]>;
 }
 
+interface LuminaArcgisAssistantMessage extends Partial<Pick<ArcgisAssistantMessage, "assistantAvatarEnabled" | "copyEnabled" | "feedbackEnabled" | "footerDisabled" | "logEnabled" | "message" | "readAloudEnabled">>, h.JSX.HTMLAttributes<ArcgisAssistantMessage> {
+}
+
 interface LuminaArcgisAssistantMessageBlock extends Partial<Pick<ArcgisAssistantMessageBlock, "block">>, h.JSX.HTMLAttributes<ArcgisAssistantMessageBlock> {
 }
 
@@ -75,7 +80,7 @@ interface LuminaArcgisAssistantMessageFeedback extends Partial<Pick<ArcgisAssist
 interface LuminaArcgisAssistantMessageFooter extends Partial<Pick<ArcgisAssistantMessageFooter, "copyEnabled" | "feedbackEnabled" | "logEnabled" | "message" | "readAloudEnabled">>, h.JSX.HTMLAttributes<ArcgisAssistantMessageFooter> {
 }
 
-interface LuminaArcgisAssistantMessageLoading extends Partial<Pick<ArcgisAssistantMessageLoading, "loading" | "loadingMessage">>, h.JSX.HTMLAttributes<ArcgisAssistantMessageLoading> {
+interface LuminaArcgisAssistantMessageLoading extends Partial<Pick<ArcgisAssistantMessageLoading, "assistantAvatarEnabled" | "interrupts" | "loading" | "loadingMessage">>, h.JSX.HTMLAttributes<ArcgisAssistantMessageLoading> {
 }
 
 interface LuminaArcgisAssistantMessageLog extends Partial<Pick<ArcgisAssistantMessageLog, "log" | "logEnabled" | "showLog">>, h.JSX.HTMLAttributes<ArcgisAssistantMessageLog> {
@@ -117,6 +122,7 @@ declare module "@arcgis/lumina" {
       "arcgis-assistant-chat": LuminaArcgisAssistantChat;
       "arcgis-assistant-chat-entry": LuminaArcgisAssistantChatEntry;
       "arcgis-assistant-interrupt": LuminaArcgisAssistantInterrupt;
+      "arcgis-assistant-message": LuminaArcgisAssistantMessage;
       "arcgis-assistant-message-block": LuminaArcgisAssistantMessageBlock;
       "arcgis-assistant-message-feedback": LuminaArcgisAssistantMessageFeedback;
       "arcgis-assistant-message-footer": LuminaArcgisAssistantMessageFooter;

package/dist/types/preact.d.ts

@@ -9,6 +9,7 @@ import type { ArcgisAssistantNavigationAgent } from "../components/arcgis-assist
 import type { ArcgisAssistantChat } from "../components/arcgis-assistant-chat/customElement.js";
 import type { ArcgisAssistantChatEntry } from "../components/arcgis-assistant-chat-entry/customElement.js";
 import type { ArcgisAssistantInterrupt } from "../components/arcgis-assistant-interrupt/customElement.js";
+import type { ArcgisAssistantMessage } from "../components/arcgis-assistant-message/customElement.js";
 import type { ArcgisAssistantMessageBlock } from "../components/arcgis-assistant-message-block/customElement.js";
 import type { ArcgisAssistantMessageFeedback } from "../components/arcgis-assistant-message-feedback/customElement.js";
 import type { ArcgisAssistantMessageFooter } from "../components/arcgis-assistant-message-footer/customElement.js";
@@ -22,7 +23,7 @@ import type { ArcgisAssistantUserMessage } from "../components/arcgis-assistant-
 import { HTMLAttributes } from "preact";
 import type { EventHandler } from "@arcgis/lumina";
 
-interface PreactArcgisAssistant extends Partial<Pick<ArcgisAssistant, "copyEnabled" | "description" | "entryMessage" | "feedbackEnabled" | "heading" | "keepSuggestedPrompts" | "logEnabled" | "messages" | "referenceElement" | "suggestedPrompts">>, HTMLAttributes<ArcgisAssistant> {
+interface PreactArcgisAssistant extends Partial<Pick<ArcgisAssistant, "assistantAvatarEnabled" | "copyEnabled" | "description" | "entryMessage" | "feedbackEnabled" | "heading" | "keepSuggestedPrompts" | "logEnabled" | "messages" | "referenceElement" | "suggestedPrompts">>, HTMLAttributes<ArcgisAssistant> {
   onarcgisCancel?: EventHandler<ArcgisAssistant["arcgisCancel"]>;
   onarcgisError?: EventHandler<ArcgisAssistant["arcgisError"]>;
   onarcgisFeedback?: EventHandler<ArcgisAssistant["arcgisFeedback"]>;
@@ -31,6 +32,7 @@ interface PreactArcgisAssistant extends Partial<Pick<ArcgisAssistant, "copyEnabl
   onarcgisInterruptSubmit?: EventHandler<ArcgisAssistant["arcgisInterruptSubmit"]>;
   onarcgisPromptSelect?: EventHandler<ArcgisAssistant["arcgisPromptSelect"]>;
   onarcgisReady?: EventHandler<ArcgisAssistant["arcgisReady"]>;
+  onarcgisResponse?: EventHandler<ArcgisAssistant["arcgisResponse"]>;
   onarcgisSlottableRequest?: EventHandler<ArcgisAssistant["arcgisSlottableRequest"]>;
   onarcgisSubmit?: EventHandler<ArcgisAssistant["arcgisSubmit"]>;
 }
@@ -53,10 +55,10 @@ interface PreactArcgisAssistantLayerStylingAgent extends Partial<Pick<ArcgisAssi
 interface PreactArcgisAssistantNavigationAgent extends Partial<Pick<ArcgisAssistantNavigationAgent, "referenceElement">>, HTMLAttributes<ArcgisAssistantNavigationAgent> {
 }
 
-interface PreactArcgisAssistantChat extends Partial<Pick<ArcgisAssistantChat, "loading" | "messages">>, HTMLAttributes<ArcgisAssistantChat> {
+interface PreactArcgisAssistantChat extends Partial<Pick<ArcgisAssistantChat, "interrupt" | "loading" | "messages">>, HTMLAttributes<ArcgisAssistantChat> {
 }
 
-interface PreactArcgisAssistantChatEntry extends Partial<Pick<ArcgisAssistantChatEntry, "awaitingResponse" | "entryPlaceholder" | "inputValue" | "keyboardShortcutsDisabled" | "messages" | "status" | "voiceInputEnabled">>, HTMLAttributes<ArcgisAssistantChatEntry> {
+interface PreactArcgisAssistantChatEntry extends Partial<Pick<ArcgisAssistantChatEntry, "awaitingResponse" | "disabled" | "entryPlaceholder" | "inputValue" | "keyboardShortcutsDisabled" | "messages" | "status" | "voiceInputEnabled">>, HTMLAttributes<ArcgisAssistantChatEntry> {
   onarcgisCancel?: EventHandler<ArcgisAssistantChatEntry["arcgisCancel"]>;
   onarcgisSubmit?: EventHandler<ArcgisAssistantChatEntry["arcgisSubmit"]>;
 }
@@ -66,6 +68,9 @@ interface PreactArcgisAssistantInterrupt extends Partial<Pick<ArcgisAssistantInt
   onarcgisSubmit?: EventHandler<ArcgisAssistantInterrupt["arcgisSubmit"]>;
 }
 
+interface PreactArcgisAssistantMessage extends Partial<Pick<ArcgisAssistantMessage, "assistantAvatarEnabled" | "copyEnabled" | "feedbackEnabled" | "footerDisabled" | "logEnabled" | "message" | "readAloudEnabled">>, HTMLAttributes<ArcgisAssistantMessage> {
+}
+
 interface PreactArcgisAssistantMessageBlock extends Partial<Pick<ArcgisAssistantMessageBlock, "block">>, HTMLAttributes<ArcgisAssistantMessageBlock> {
 }
 
@@ -76,7 +81,7 @@ interface PreactArcgisAssistantMessageFeedback extends Partial<Pick<ArcgisAssist
 interface PreactArcgisAssistantMessageFooter extends Partial<Pick<ArcgisAssistantMessageFooter, "copyEnabled" | "feedbackEnabled" | "logEnabled" | "message" | "readAloudEnabled">>, HTMLAttributes<ArcgisAssistantMessageFooter> {
 }
 
-interface PreactArcgisAssistantMessageLoading extends Partial<Pick<ArcgisAssistantMessageLoading, "loading" | "loadingMessage">>, HTMLAttributes<ArcgisAssistantMessageLoading> {
+interface PreactArcgisAssistantMessageLoading extends Partial<Pick<ArcgisAssistantMessageLoading, "assistantAvatarEnabled" | "interrupts" | "loading" | "loadingMessage">>, HTMLAttributes<ArcgisAssistantMessageLoading> {
 }
 
 interface PreactArcgisAssistantMessageLog extends Partial<Pick<ArcgisAssistantMessageLog, "log" | "logEnabled" | "showLog">>, HTMLAttributes<ArcgisAssistantMessageLog> {
@@ -118,6 +123,7 @@ declare module 'preact' {
       "arcgis-assistant-chat": PreactArcgisAssistantChat;
       "arcgis-assistant-chat-entry": PreactArcgisAssistantChatEntry;
       "arcgis-assistant-interrupt": PreactArcgisAssistantInterrupt;
+      "arcgis-assistant-message": PreactArcgisAssistantMessage;
       "arcgis-assistant-message-block": PreactArcgisAssistantMessageBlock;
       "arcgis-assistant-message-feedback": PreactArcgisAssistantMessageFeedback;
       "arcgis-assistant-message-footer": PreactArcgisAssistantMessageFooter;
@@ -142,6 +148,7 @@ declare module 'preact' {
       "arcgis-assistant-chat": PreactArcgisAssistantChat;
       "arcgis-assistant-chat-entry": PreactArcgisAssistantChatEntry;
       "arcgis-assistant-interrupt": PreactArcgisAssistantInterrupt;
+      "arcgis-assistant-message": PreactArcgisAssistantMessage;
       "arcgis-assistant-message-block": PreactArcgisAssistantMessageBlock;
       "arcgis-assistant-message-feedback": PreactArcgisAssistantMessageFeedback;
       "arcgis-assistant-message-footer": PreactArcgisAssistantMessageFooter;

package/dist/types/react.d.ts

@@ -9,6 +9,7 @@ import type { ArcgisAssistantNavigationAgent } from "../components/arcgis-assist
 import type { ArcgisAssistantChat } from "../components/arcgis-assistant-chat/customElement.js";
 import type { ArcgisAssistantChatEntry } from "../components/arcgis-assistant-chat-entry/customElement.js";
 import type { ArcgisAssistantInterrupt } from "../components/arcgis-assistant-interrupt/customElement.js";
+import type { ArcgisAssistantMessage } from "../components/arcgis-assistant-message/customElement.js";
 import type { ArcgisAssistantMessageBlock } from "../components/arcgis-assistant-message-block/customElement.js";
 import type { ArcgisAssistantMessageFeedback } from "../components/arcgis-assistant-message-feedback/customElement.js";
 import type { ArcgisAssistantMessageFooter } from "../components/arcgis-assistant-message-footer/customElement.js";
@@ -22,7 +23,7 @@ import type { ArcgisAssistantUserMessage } from "../components/arcgis-assistant-
 import type { HTMLProps } from 'react';
 import type { EventHandler } from "@arcgis/lumina"; 
 
-interface ReactArcgisAssistant extends Partial<Pick<ArcgisAssistant, "copyEnabled" | "description" | "entryMessage" | "feedbackEnabled" | "heading" | "keepSuggestedPrompts" | "logEnabled" | "messages" | "referenceElement" | "suggestedPrompts">>, HTMLProps<ArcgisAssistant> {
+interface ReactArcgisAssistant extends Partial<Pick<ArcgisAssistant, "assistantAvatarEnabled" | "copyEnabled" | "description" | "entryMessage" | "feedbackEnabled" | "heading" | "keepSuggestedPrompts" | "logEnabled" | "messages" | "referenceElement" | "suggestedPrompts">>, HTMLProps<ArcgisAssistant> {
   onarcgisCancel?: EventHandler<ArcgisAssistant["arcgisCancel"]>;
   onarcgisError?: EventHandler<ArcgisAssistant["arcgisError"]>;
   onarcgisFeedback?: EventHandler<ArcgisAssistant["arcgisFeedback"]>;
@@ -31,6 +32,7 @@ interface ReactArcgisAssistant extends Partial<Pick<ArcgisAssistant, "copyEnable
   onarcgisInterruptSubmit?: EventHandler<ArcgisAssistant["arcgisInterruptSubmit"]>;
   onarcgisPromptSelect?: EventHandler<ArcgisAssistant["arcgisPromptSelect"]>;
   onarcgisReady?: EventHandler<ArcgisAssistant["arcgisReady"]>;
+  onarcgisResponse?: EventHandler<ArcgisAssistant["arcgisResponse"]>;
   onarcgisSlottableRequest?: EventHandler<ArcgisAssistant["arcgisSlottableRequest"]>;
   onarcgisSubmit?: EventHandler<ArcgisAssistant["arcgisSubmit"]>;
 }
@@ -53,10 +55,10 @@ interface ReactArcgisAssistantLayerStylingAgent extends Partial<Pick<ArcgisAssis
 interface ReactArcgisAssistantNavigationAgent extends Partial<Pick<ArcgisAssistantNavigationAgent, "referenceElement">>, HTMLProps<ArcgisAssistantNavigationAgent> {
 }
 
-interface ReactArcgisAssistantChat extends Partial<Pick<ArcgisAssistantChat, "loading" | "messages">>, HTMLProps<ArcgisAssistantChat> {
+interface ReactArcgisAssistantChat extends Partial<Pick<ArcgisAssistantChat, "interrupt" | "loading" | "messages">>, HTMLProps<ArcgisAssistantChat> {
 }
 
-interface ReactArcgisAssistantChatEntry extends Partial<Pick<ArcgisAssistantChatEntry, "awaitingResponse" | "entryPlaceholder" | "inputValue" | "keyboardShortcutsDisabled" | "messages" | "status" | "voiceInputEnabled">>, HTMLProps<ArcgisAssistantChatEntry> {
+interface ReactArcgisAssistantChatEntry extends Partial<Pick<ArcgisAssistantChatEntry, "awaitingResponse" | "disabled" | "entryPlaceholder" | "inputValue" | "keyboardShortcutsDisabled" | "messages" | "status" | "voiceInputEnabled">>, HTMLProps<ArcgisAssistantChatEntry> {
   onarcgisCancel?: EventHandler<ArcgisAssistantChatEntry["arcgisCancel"]>;
   onarcgisSubmit?: EventHandler<ArcgisAssistantChatEntry["arcgisSubmit"]>;
 }
@@ -66,6 +68,9 @@ interface ReactArcgisAssistantInterrupt extends Partial<Pick<ArcgisAssistantInte
   onarcgisSubmit?: EventHandler<ArcgisAssistantInterrupt["arcgisSubmit"]>;
 }
 
+interface ReactArcgisAssistantMessage extends Partial<Pick<ArcgisAssistantMessage, "assistantAvatarEnabled" | "copyEnabled" | "feedbackEnabled" | "footerDisabled" | "logEnabled" | "message" | "readAloudEnabled">>, HTMLProps<ArcgisAssistantMessage> {
+}
+
 interface ReactArcgisAssistantMessageBlock extends Partial<Pick<ArcgisAssistantMessageBlock, "block">>, HTMLProps<ArcgisAssistantMessageBlock> {
 }
 
@@ -76,7 +81,7 @@ interface ReactArcgisAssistantMessageFeedback extends Partial<Pick<ArcgisAssista
 interface ReactArcgisAssistantMessageFooter extends Partial<Pick<ArcgisAssistantMessageFooter, "copyEnabled" | "feedbackEnabled" | "logEnabled" | "message" | "readAloudEnabled">>, HTMLProps<ArcgisAssistantMessageFooter> {
 }
 
-interface ReactArcgisAssistantMessageLoading extends Partial<Pick<ArcgisAssistantMessageLoading, "loading" | "loadingMessage">>, HTMLProps<ArcgisAssistantMessageLoading> {
+interface ReactArcgisAssistantMessageLoading extends Partial<Pick<ArcgisAssistantMessageLoading, "assistantAvatarEnabled" | "interrupts" | "loading" | "loadingMessage">>, HTMLProps<ArcgisAssistantMessageLoading> {
 }
 
 interface ReactArcgisAssistantMessageLog extends Partial<Pick<ArcgisAssistantMessageLog, "log" | "logEnabled" | "showLog">>, HTMLProps<ArcgisAssistantMessageLog> {
@@ -118,6 +123,7 @@ declare module "react" {
       "arcgis-assistant-chat": ReactArcgisAssistantChat;
       "arcgis-assistant-chat-entry": ReactArcgisAssistantChatEntry;
       "arcgis-assistant-interrupt": ReactArcgisAssistantInterrupt;
+      "arcgis-assistant-message": ReactArcgisAssistantMessage;
       "arcgis-assistant-message-block": ReactArcgisAssistantMessageBlock;
       "arcgis-assistant-message-feedback": ReactArcgisAssistantMessageFeedback;
       "arcgis-assistant-message-footer": ReactArcgisAssistantMessageFooter;
@@ -144,6 +150,7 @@ declare module "react/jsx-runtime" {
       "arcgis-assistant-chat": ReactArcgisAssistantChat;
       "arcgis-assistant-chat-entry": ReactArcgisAssistantChatEntry;
       "arcgis-assistant-interrupt": ReactArcgisAssistantInterrupt;
+      "arcgis-assistant-message": ReactArcgisAssistantMessage;
       "arcgis-assistant-message-block": ReactArcgisAssistantMessageBlock;
       "arcgis-assistant-message-feedback": ReactArcgisAssistantMessageFeedback;
       "arcgis-assistant-message-footer": ReactArcgisAssistantMessageFooter;
@@ -170,6 +177,7 @@ declare module "react/jsx-dev-runtime" {
       "arcgis-assistant-chat": ReactArcgisAssistantChat;
       "arcgis-assistant-chat-entry": ReactArcgisAssistantChatEntry;
       "arcgis-assistant-interrupt": ReactArcgisAssistantInterrupt;
+      "arcgis-assistant-message": ReactArcgisAssistantMessage;
       "arcgis-assistant-message-block": ReactArcgisAssistantMessageBlock;
       "arcgis-assistant-message-feedback": ReactArcgisAssistantMessageFeedback;
       "arcgis-assistant-message-footer": ReactArcgisAssistantMessageFooter;

package/dist/types/stencil.d.ts

@@ -9,6 +9,7 @@ import type { ArcgisAssistantNavigationAgent } from "../components/arcgis-assist
 import type { ArcgisAssistantChat } from "../components/arcgis-assistant-chat/customElement.js";
 import type { ArcgisAssistantChatEntry } from "../components/arcgis-assistant-chat-entry/customElement.js";
 import type { ArcgisAssistantInterrupt } from "../components/arcgis-assistant-interrupt/customElement.js";
+import type { ArcgisAssistantMessage } from "../components/arcgis-assistant-message/customElement.js";
 import type { ArcgisAssistantMessageBlock } from "../components/arcgis-assistant-message-block/customElement.js";
 import type { ArcgisAssistantMessageFeedback } from "../components/arcgis-assistant-message-feedback/customElement.js";
 import type { ArcgisAssistantMessageFooter } from "../components/arcgis-assistant-message-footer/customElement.js";
@@ -22,7 +23,7 @@ import type { ArcgisAssistantUserMessage } from "../components/arcgis-assistant-
 import { JSXBase as StencilJsx } from "@stencil/core/internal";
 import type { EventHandler } from "@arcgis/lumina";
 
-interface StencilArcgisAssistant extends Partial<Pick<ArcgisAssistant, "copyEnabled" | "description" | "entryMessage" | "feedbackEnabled" | "heading" | "keepSuggestedPrompts" | "logEnabled" | "messages" | "referenceElement" | "suggestedPrompts">>, StencilJsx.HTMLAttributes<ArcgisAssistant> {
+interface StencilArcgisAssistant extends Partial<Pick<ArcgisAssistant, "assistantAvatarEnabled" | "copyEnabled" | "description" | "entryMessage" | "feedbackEnabled" | "heading" | "keepSuggestedPrompts" | "logEnabled" | "messages" | "referenceElement" | "suggestedPrompts">>, StencilJsx.HTMLAttributes<ArcgisAssistant> {
   onArcgisCancel?: EventHandler<ArcgisAssistant["arcgisCancel"]>;
   onArcgisError?: EventHandler<ArcgisAssistant["arcgisError"]>;
   onArcgisFeedback?: EventHandler<ArcgisAssistant["arcgisFeedback"]>;
@@ -31,6 +32,7 @@ interface StencilArcgisAssistant extends Partial<Pick<ArcgisAssistant, "copyEnab
   onArcgisInterruptSubmit?: EventHandler<ArcgisAssistant["arcgisInterruptSubmit"]>;
   onArcgisPromptSelect?: EventHandler<ArcgisAssistant["arcgisPromptSelect"]>;
   onArcgisReady?: EventHandler<ArcgisAssistant["arcgisReady"]>;
+  onArcgisResponse?: EventHandler<ArcgisAssistant["arcgisResponse"]>;
   onArcgisSlottableRequest?: EventHandler<ArcgisAssistant["arcgisSlottableRequest"]>;
   onArcgisSubmit?: EventHandler<ArcgisAssistant["arcgisSubmit"]>;
 }
@@ -53,10 +55,10 @@ interface StencilArcgisAssistantLayerStylingAgent extends Partial<Pick<ArcgisAss
 interface StencilArcgisAssistantNavigationAgent extends Partial<Pick<ArcgisAssistantNavigationAgent, "referenceElement">>, StencilJsx.HTMLAttributes<ArcgisAssistantNavigationAgent> {
 }
 
-interface StencilArcgisAssistantChat extends Partial<Pick<ArcgisAssistantChat, "loading" | "messages">>, StencilJsx.HTMLAttributes<ArcgisAssistantChat> {
+interface StencilArcgisAssistantChat extends Partial<Pick<ArcgisAssistantChat, "interrupt" | "loading" | "messages">>, StencilJsx.HTMLAttributes<ArcgisAssistantChat> {
 }
 
-interface StencilArcgisAssistantChatEntry extends Partial<Pick<ArcgisAssistantChatEntry, "awaitingResponse" | "entryPlaceholder" | "inputValue" | "keyboardShortcutsDisabled" | "messages" | "status" | "voiceInputEnabled">>, StencilJsx.HTMLAttributes<ArcgisAssistantChatEntry> {
+interface StencilArcgisAssistantChatEntry extends Partial<Pick<ArcgisAssistantChatEntry, "awaitingResponse" | "disabled" | "entryPlaceholder" | "inputValue" | "keyboardShortcutsDisabled" | "messages" | "status" | "voiceInputEnabled">>, StencilJsx.HTMLAttributes<ArcgisAssistantChatEntry> {
   onArcgisCancel?: EventHandler<ArcgisAssistantChatEntry["arcgisCancel"]>;
   onArcgisSubmit?: EventHandler<ArcgisAssistantChatEntry["arcgisSubmit"]>;
 }
@@ -66,6 +68,9 @@ interface StencilArcgisAssistantInterrupt extends Partial<Pick<ArcgisAssistantIn
   onArcgisSubmit?: EventHandler<ArcgisAssistantInterrupt["arcgisSubmit"]>;
 }
 
+interface StencilArcgisAssistantMessage extends Partial<Pick<ArcgisAssistantMessage, "assistantAvatarEnabled" | "copyEnabled" | "feedbackEnabled" | "footerDisabled" | "logEnabled" | "message" | "readAloudEnabled">>, StencilJsx.HTMLAttributes<ArcgisAssistantMessage> {
+}
+
 interface StencilArcgisAssistantMessageBlock extends Partial<Pick<ArcgisAssistantMessageBlock, "block">>, StencilJsx.HTMLAttributes<ArcgisAssistantMessageBlock> {
 }
 
@@ -76,7 +81,7 @@ interface StencilArcgisAssistantMessageFeedback extends Partial<Pick<ArcgisAssis
 interface StencilArcgisAssistantMessageFooter extends Partial<Pick<ArcgisAssistantMessageFooter, "copyEnabled" | "feedbackEnabled" | "logEnabled" | "message" | "readAloudEnabled">>, StencilJsx.HTMLAttributes<ArcgisAssistantMessageFooter> {
 }
 
-interface StencilArcgisAssistantMessageLoading extends Partial<Pick<ArcgisAssistantMessageLoading, "loading" | "loadingMessage">>, StencilJsx.HTMLAttributes<ArcgisAssistantMessageLoading> {
+interface StencilArcgisAssistantMessageLoading extends Partial<Pick<ArcgisAssistantMessageLoading, "assistantAvatarEnabled" | "interrupts" | "loading" | "loadingMessage">>, StencilJsx.HTMLAttributes<ArcgisAssistantMessageLoading> {
 }
 
 interface StencilArcgisAssistantMessageLog extends Partial<Pick<ArcgisAssistantMessageLog, "log" | "logEnabled" | "showLog">>, StencilJsx.HTMLAttributes<ArcgisAssistantMessageLog> {
@@ -116,6 +121,7 @@ interface ExposedElements {
   "arcgis-assistant-chat": StencilArcgisAssistantChat;
   "arcgis-assistant-chat-entry": StencilArcgisAssistantChatEntry;
   "arcgis-assistant-interrupt": StencilArcgisAssistantInterrupt;
+  "arcgis-assistant-message": StencilArcgisAssistantMessage;
   "arcgis-assistant-message-block": StencilArcgisAssistantMessageBlock;
   "arcgis-assistant-message-feedback": StencilArcgisAssistantMessageFeedback;
   "arcgis-assistant-message-footer": StencilArcgisAssistantMessageFooter;

package/dist/utils/index.d.ts

@@ -8,8 +8,11 @@ import type { AnnotationRoot, BaseChannel, StateGraph } from "@langchain/langgra
 import type { ChatOpenAI } from "@langchain/openai";
 import type { ZodType } from "zod";
 
-export { type CustomConfigurableType } from "../orchestrator";
-export { Orchestrator } from "../orchestrator";
+export { type CustomConfigurableType } from "../orchestrator.js";
+export { Orchestrator } from "../orchestrator.js";
+
+/** @internal */
+export type ChatModelTier = "advanced" | "default" | "fast";
 
 /**
  * Represents the chat message history between the user and the assistant, including all messages sent and received during the conversation.
@@ -146,6 +149,8 @@ export type ArcgisPromptOptions = {
    * - `advanced` - An advanced model tier that may provide improved accuracy or capabilities compared to
    *   the default tier. However, it may also come with increased cost and slower performance. At
    *   JS SDK v5.0, this model tier corresponds to GPT-5.2 model.
+   * - `fast` - A lower cost model suitable for tasks like classification and summarization. This tier may have limitations in terms of response length and complexity.
+   *   New at JS SDK v5.1, this model tier corresponds to GPT-5.4-nano model.
    *
    * The specific models available in each tier may evolve over time as new models are released and existing
    * models are retired. The dates models are retired depends on the model provider and therefore may not
@@ -172,6 +177,8 @@ export type ArcgisPromptOptions = {
    * and produce more accurate and relevant responses.
    */
   messages?: ChatHistory;
+  /** Abort signal for cooperative run cancellation. */
+  abortSignal?: AbortSignal;
   /**
    * Input variables for the prompt. This can include any relevant variables related to the context
    * provided to the agent. This may be necessary for determining tool parameters or for providing additional
@@ -319,7 +326,7 @@ export function cosineSimilarity(vectorA: number[], vectorB: number[]): number;
 /**
  * The suggestions emitted by the agent to the user interface.
  *
- * @internal
+ * @since 5.1
  */
 export type UXSuggestion = {
   /** The type of suggestion being made. */
@@ -331,32 +338,41 @@ export type UXSuggestion = {
 /**
  * Execution status returned by an agent run.
  *
- * @internal
+ * @since 5.1
  */
 export type AgentStatus = "failed" | "success" | "unknown";
 
 /**
  * Summary of a previously executed agent step.
  *
- * @internal
+ * @since 5.1
  */
 export interface PriorStep {
+  /** The agent that handled the step. */
   agentId: string;
+  /** The task assigned to the agent for this step. */
   assignedTask: string;
+  /** A brief summary of the step's execution. */
   summary: string;
+  /** The execution status of the step. */
   status: AgentStatus;
 }
 
 /**
  * Runtime execution context available to agent graph nodes and tools.
  *
- * @internal
+ * @since 5.1
  */
 export interface AgentExecutionContext<TState extends Record<string, unknown> = Record<string, unknown>> {
+  /** The user's original request. */
   userRequest: string;
+  /** The task assigned to the agent. */
   assignedTask: string;
+  /** The message history for the run */
   messages: ChatHistory;
+  /** Previous steps */
   priorSteps: PriorStep[];
+  /** Shared state available to the agent. */
   sharedState: SharedState<TState>;
 }
 
@@ -427,6 +443,9 @@ export const createWebmapEmbeddings: (mapView: MapView) => Promise<{
     }>;
 }>;
 
+/** @internal */
+export type GetContext<TContext extends Record<string, unknown>> = () => Promise<TContext> | TContext;
+
 /** @internal */
 export interface AgentWithContext<TContext extends Record<string, unknown> = Record<string, unknown>> {
   agent: AgentRegistration;
@@ -438,34 +457,9 @@ export interface AgentWithContext<TContext extends Record<string, unknown> = Rec
 }
 
 /** @internal */
-export function createAgentRuntimeState<TState extends Record<string, unknown> = Record<string, unknown>>(): StatelessAgentBaseState<TState>;
-
-/** @internal */
-export function createAgentRuntimeStateWithSharedState<TState extends Record<string, unknown> = Record<string, unknown>>(): StatefulAgentBaseState<TState>;
-
-/**
- * @param suggestion
- * @param config
- * @internal
- */
-export function sendUXSuggestion(suggestion: UXSuggestion, config?: RunnableConfig): Promise<void>;
+export type AgentExecutionContextWithSharedState<TState extends Record<string, unknown> = Record<string, unknown>> = AgentExecutionContext<TState>;
 
 /** @internal */
-export type SharedStatePatch<T extends Record<string, unknown> = Record<string, unknown>> = {
-    [K in keyof T]?: SharedStatePatchEntry<T[K]>;
-};
-
-/**
- * @param tier
- * @param temperature
- * @internal
- */
-export function createChatModel(tier?: ChatModelTier, temperature?: number): Promise<ChatOpenAI>;
-
-export type ChatModelTier = "advanced" | "default" | "fast";
-
-export type GetContext<TContext extends Record<string, unknown>> = () => Promise<TContext> | TContext;
-
 export type StatelessAgentBaseState<TState extends Record<string, unknown> = Record<string, unknown>> = {
   agentExecutionContext: BaseChannel<AgentExecutionContextWithSharedState<TState>, unknown, unknown>;
   outputMessage: BaseChannel<string, unknown, unknown>;
@@ -473,27 +467,76 @@ export type StatelessAgentBaseState<TState extends Record<string, unknown> = Rec
   status: BaseChannel<AgentStatus | undefined, unknown, unknown>;
 };
 
+/** @internal */
 export type StatefulAgentBaseState<TState extends Record<string, unknown> = Record<string, unknown>> = StatelessAgentBaseState<TState>
   & {
   sharedStatePatch: BaseChannel<SharedStatePatch<TState> | undefined, unknown, unknown>;
 };
 
-/** Patch shape returned by agents. `meta` is intentionally omitted. */
-export type SharedStatePatchEntry<T = unknown> = {
-  value: T;
-};
+/**
+ * Creates the standard runtime state for a custom agent graph.
+ * Includes common fields used by the assistant flow (request context, output message, summary, and status), so you only add your agent-specific state.
+ *
+ * @since 5.1
+ */
+export function createAgentRuntimeState<TState extends Record<string, unknown> = Record<string, unknown>>(): StatelessAgentBaseState<TState>;
 
-export type SharedState<T extends Record<string, unknown> = Record<string, unknown>> = {
-    [K in keyof T]?: SharedStateEntry<T[K]>;
-};
+/**
+ * Creates the standard runtime state for a custom agent graph, plus support for shared state updates.
+ * Use this when your agent needs to write values that other agents can read later in the same orchestration flow.
+ *
+ * @since 5.1
+ */
+export function createAgentRuntimeStateWithSharedState<TState extends Record<string, unknown> = Record<string, unknown>>(): StatefulAgentBaseState<TState>;
 
-export type AgentExecutionContextWithSharedState<TState extends Record<string, unknown> = Record<string, unknown>> = AgentExecutionContext<TState>;
+/**
+ * Sends an optional UX suggestion from an agent run to the host application.
+ * Use this for non-blocking hints (for example, recommended next actions or UI prompts) that the app may choose to display.
+ *
+ * @param suggestion
+ * @param config
+ * @since 5.1
+ */
+export function sendUXSuggestion(suggestion: UXSuggestion, config?: RunnableConfig): Promise<void>;
 
-/** Stored shared state entry. `meta` is added by the orchestrator. */
+/** @internal */
 export type SharedStateEntry<T = unknown> = {
   value: T;
   meta: {
       updatedByAgentId: string;
       updatedAt: number;
   };
-};
+};
+
+/** @internal */
+export type SharedStatePatchEntry<T = unknown> = {
+  value: T;
+};
+
+/**
+ * Shared state that can be read and updated during agent execution.
+ *
+ * @since 5.1
+ */
+export type SharedState<T extends Record<string, unknown> = Record<string, unknown>> = {
+    [K in keyof T]?: SharedStateEntry<T[K]>;
+};
+
+/**
+ * Partial shared state returned by an agent for merging into the current run state.
+ *
+ * @since 5.1
+ */
+export type SharedStatePatch<T extends Record<string, unknown> = Record<string, unknown>> = {
+    [K in keyof T]?: SharedStatePatchEntry<T[K]>;
+};
+
+/**
+ * @param parameter0
+ * @internal
+ */
+export function createChatModel(parameter0?: {
+    modelTier?: ChatModelTier;
+    temperature?: number;
+    abortSignal?: AbortSignal;
+}): Promise<ChatOpenAI>;