@arcgis/ai-components 5.2.0-next.1 → 5.2.0-next.11

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

@@ -7,9 +7,13 @@ import type { StructuredToolInterface } from "@langchain/core/tools";
 import type { AnnotationRoot, BaseChannel, StateGraph } from "@langchain/langgraph/web";
 import type { ChatOpenAI } from "@langchain/openai";
 import type { ZodType } from "zod";
+import type { AgentRegistration as AgentRegistration2 } from "../orchestrator/registry/agentRegistry.js";
 
-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 +150,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 +178,8 @@ export type ArcgisPromptOptions = {
    * and produce more accurate and relevant responses.
    */
   messages?: ChatHistory;
+  /** Optional runnable configuration used to derive runtime values (for example, conversation id and abort signal). */
+  config?: RunnableConfig;
   /**
    * 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 +327,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 +339,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>;
 }
 
@@ -388,7 +405,7 @@ export type DataExplorationContext = {
 export const HelpAgent: AgentRegistration;
 
 /** @internal */
-export const ArcgisKnowledgeAgent: AgentRegistration;
+export const ArcgisKnowledgeAgent: AgentRegistration2;
 
 /** @internal */
 export type ArcgisKnowledgeContext = {
@@ -427,6 +444,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 +458,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 +468,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;
+    config?: RunnableConfig;
+}): Promise<ChatOpenAI>;

package/dist/utils/index.js

@@ -1,7 +1,8 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { g as p } from "../chunks/orchestrator.js";
-import { O as ye } from "../chunks/orchestrator.js";
-import { g as h, a as A, W as S, f, l as y, d as v, m as w, b as $, e as b, i as E, h as L, j as P, s as M, k as T, n as R, c as k, o as x } from "../chunks/generateLayerDescriptions.js";
+import { O as ue } from "../chunks/orchestrator.js";
+import { s as h, a as A } from "../chunks/index.js";
+import { g as S, a as v, W as w, f, l as y, d as $, m as b, b as E, s as L, i as P, e as M, h as T, j as R, k, c as x } from "../chunks/generateLayerDescriptions.js";
 import D from "@arcgis/core/layers/FeatureLayer.js";
 import * as W from "@arcgis/core/core/reactiveUtils.js";
 import { N as F } from "../chunks/navigationGraph.js";
@@ -10,38 +11,38 @@ import { D as N } from "../chunks/dataExplorationGraph.js";
 import { H as z } from "../chunks/helpGraph.js";
 import { A as H } from "../chunks/arcgisKnowledgeGraph.js";
 const I = async (e) => {
-  const t = e.allLayers.toArray(), n = [], s = /* @__PURE__ */ new Map();
+  const t = e.allLayers.toArray(), s = [], o = /* @__PURE__ */ new Map();
   for (const a of t)
     if (a instanceof D) {
       const m = (async () => {
-        const o = await h(a), r = await A(a, o);
-        s.set(a.id, { layerItem: r, fieldRegistry: o });
+        const r = await S(a), n = await v(a, r);
+        o.set(a.id, { layerItem: n, fieldRegistry: r });
       })();
-      n.push(m);
+      s.push(m);
     }
-  return await Promise.all(n), s;
+  return await Promise.all(s), o;
 }, O = async (e) => {
   await W.whenOnce(() => e.ready);
-  const t = await I(e.map), { layers: n } = await U(t), s = {
-    schemaVersion: b,
+  const t = await I(e.map), { layers: s } = await U(t), o = {
+    schemaVersion: L,
     modified: Date.now(),
     embeddings: {
-      modelProvider: $,
-      model: w,
-      dimensions: v,
+      modelProvider: E,
+      model: b,
+      dimensions: $,
       templates: {
         layer: y,
         field: f
       }
     },
-    layers: n
-  }, a = S.safeParse(s);
+    layers: s
+  }, a = w.safeParse(o);
   if (!a.success)
     throw console.error("Schema Mismatch:", a.error.format()), new Error("Webmap embedding generation failed validation.");
   return a.data;
 }, U = async (e) => {
-  const t = [], n = [];
-  for (const [o, { fieldRegistry: r, layerItem: i }] of e.entries()) {
+  const t = [], s = [];
+  for (const [r, { fieldRegistry: n, layerItem: i }] of e.entries()) {
     const l = g(y, {
       name: i.name,
       title: i.title,
@@ -49,14 +50,14 @@ const I = async (e) => {
     });
     t.push(l);
     const d = {
-      id: o,
+      id: r,
       name: i.name ?? "",
       title: i.title,
       description: i.description,
       vector: [],
       fields: []
     };
-    for (const [, c] of r.entries()) {
+    for (const [, c] of n.entries()) {
       const u = g(f, {
         name: c.name,
         alias: c.alias,
@@ -69,43 +70,47 @@ const I = async (e) => {
         vector: []
       });
     }
-    n.push(d);
+    s.push(d);
   }
-  const s = await p(t);
+  const o = await p(t);
   let a = 0;
-  return { layers: n.map((o) => (o.vector = s[a++], o.fields.forEach((r) => {
-    r.vector = s[a++];
-  }), o)) };
-}, g = (e, t) => e.replace(/\{(\w+)\}/gu, (n, s) => t[s] ?? ""), V = (e, t) => {
+  return { layers: s.map((r) => (r.vector = o[a++], r.fields.forEach((n) => {
+    n.vector = o[a++];
+  }), r)) };
+}, g = (e, t) => e.replace(/\{(\w+)\}/gu, (s, o) => t[o] ?? ""), V = (e, t) => {
   if (e.length !== t.length)
     throw new Error("Vectors must be the same length");
-  let n = 0, s = 0, a = 0;
-  for (let r = 0; r < e.length; ++r) {
-    const i = e[r], l = t[r];
-    n += i * l, s += i * i, a += l * l;
+  let s = 0, o = 0, a = 0;
+  for (let n = 0; n < e.length; ++n) {
+    const i = e[n], l = t[n];
+    s += i * l, o += i * i, a += l * l;
   }
-  const m = Math.sqrt(s * a);
+  const m = Math.sqrt(o * a);
   if (m === 0)
     return 0;
-  const o = n / m;
-  return Math.max(-1, Math.min(1, o));
-}, Q = L, Y = E, Z = P, ee = M, te = p, ae = V, se = F, ne = C, oe = N, re = z, ie = H, ce = O, me = () => T(), le = () => R(), de = async (e, t) => await x(e, t), ge = async (e = "default", t = 0) => await k(e, t);
+  const r = s / m;
+  return Math.max(-1, Math.min(1, r));
+}, Y = M, Z = P, ee = T, te = h, ae = p, se = V, oe = F, re = C, ne = N, ie = z, ce = H, me = O, le = () => R(), de = () => k(), ge = async (e, t) => await A(e, t), pe = async ({
+  modelTier: e = "default",
+  temperature: t = 0,
+  config: s
+} = {}) => await x({ modelTier: e, temperature: t, config: s });
 export {
-  ie as ArcgisKnowledgeAgent,
-  oe as DataExplorationAgent,
-  re as HelpAgent,
-  ne as LayerStylingAgent,
-  se as NavigationAgent,
-  ye as Orchestrator,
-  ae as cosineSimilarity,
-  me as createAgentRuntimeState,
-  le as createAgentRuntimeStateWithSharedState,
-  ge as createChatModel,
-  ce as createWebmapEmbeddings,
-  te as getEmbeddings,
-  Y as invokeStructuredPrompt,
-  Q as invokeTextPrompt,
-  Z as invokeToolPrompt,
-  ee as sendTraceMessage,
-  de as sendUXSuggestion
+  ce as ArcgisKnowledgeAgent,
+  ne as DataExplorationAgent,
+  ie as HelpAgent,
+  re as LayerStylingAgent,
+  oe as NavigationAgent,
+  ue as Orchestrator,
+  se as cosineSimilarity,
+  le as createAgentRuntimeState,
+  de as createAgentRuntimeStateWithSharedState,
+  pe as createChatModel,
+  me as createWebmapEmbeddings,
+  ae as getEmbeddings,
+  Z as invokeStructuredPrompt,
+  Y as invokeTextPrompt,
+  ee as invokeToolPrompt,
+  te as sendTraceMessage,
+  ge as sendUXSuggestion
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/ai-components",
-  "version": "5.2.0-next.1",
+  "version": "5.2.0-next.11",
   "description": "ArcGIS AI Components",
   "type": "module",
   "main": "./dist/index.js",
@@ -9,6 +9,7 @@
   "exports": {
     ".": "./dist/index.js",
     "./loader": "./dist/loader.js",
+    "./agent-utils/index.js": "./dist/agent-utils/index.js",
     "./agent-utils/BaseAgent.js": "./dist/agent-utils/BaseAgent.js",
     "./agent-utils/FunctionAgent.js": "./dist/agent-utils/FunctionAgent.js",
     "./agent-utils/LLMAgent.js": "./dist/agent-utils/LLMAgent.js",
@@ -44,16 +45,16 @@
     "@langchain/openai": "^1.4.3",
     "langchain": "^1.3.1",
     "lit": "^3.3.0",
-    "marked": "~18.0.4",
+    "marked": "~18.0.5",
     "tslib": "^2.8.1",
     "zod": "^4.3.6",
-    "@arcgis/lumina": "5.2.0-next.1",
-    "@arcgis/toolkit": "5.2.0-next.1"
+    "@arcgis/lumina": "5.2.0-next.11",
+    "@arcgis/toolkit": "5.2.0-next.11"
   },
   "peerDependencies": {
-    "@arcgis/core": "^5.1.0-next",
-    "@esri/calcite-components": "^5.1.0-next.60",
-    "@arcgis/map-components": "~5.2.0-next.1"
+    "@arcgis/core": "^5.2.0-next",
+    "@esri/calcite-components": "^5.1.1-next.3",
+    "@arcgis/map-components": "~5.2.0-next.11"
   },
   "css.customData": [
     "dist/docs/vscode.css-custom-data.json"