@arcgis/ai-components 5.2.0-next.6 → 5.2.0-next.61

package/dist/types/react.d.ts

@@ -23,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" | "streamingDisabled" | "suggestedPrompts">>, HTMLProps<ArcgisAssistant> {
   onarcgisCancel?: EventHandler<ArcgisAssistant["arcgisCancel"]>;
   onarcgisError?: EventHandler<ArcgisAssistant["arcgisError"]>;
   onarcgisFeedback?: EventHandler<ArcgisAssistant["arcgisFeedback"]>;
@@ -32,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"]>;
 }
@@ -54,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"]>;
 }
@@ -67,7 +68,7 @@ interface ReactArcgisAssistantInterrupt extends Partial<Pick<ArcgisAssistantInte
   onarcgisSubmit?: EventHandler<ArcgisAssistantInterrupt["arcgisSubmit"]>;
 }
 
-interface ReactArcgisAssistantMessage extends Partial<Pick<ArcgisAssistantMessage, "copyEnabled" | "feedbackEnabled" | "footerDisabled" | "logEnabled" | "message" | "readAloudEnabled">>, HTMLProps<ArcgisAssistantMessage> {
+interface ReactArcgisAssistantMessage extends Partial<Pick<ArcgisAssistantMessage, "assistantAvatarEnabled" | "copyEnabled" | "feedbackEnabled" | "footerDisabled" | "logEnabled" | "message" | "readAloudEnabled">>, HTMLProps<ArcgisAssistantMessage> {
 }
 
 interface ReactArcgisAssistantMessageBlock extends Partial<Pick<ArcgisAssistantMessageBlock, "block">>, HTMLProps<ArcgisAssistantMessageBlock> {
@@ -80,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> {
@@ -89,7 +90,7 @@ interface ReactArcgisAssistantMessageLog extends Partial<Pick<ArcgisAssistantMes
 interface ReactArcgisAssistantMessageReadAloud extends Partial<Pick<ArcgisAssistantMessageReadAloud, "message" | "readAloudEnabled">>, HTMLProps<ArcgisAssistantMessageReadAloud> {
 }
 
-interface ReactArcgisAssistantMessageText extends Partial<Pick<ArcgisAssistantMessageText, "content">>, HTMLProps<ArcgisAssistantMessageText> {
+interface ReactArcgisAssistantMessageText extends Partial<Pick<ArcgisAssistantMessageText, "content" | "parts">>, HTMLProps<ArcgisAssistantMessageText> {
 }
 
 interface ReactArcgisAssistantSpeechInput extends Partial<Pick<ArcgisAssistantSpeechInput, "awaitingResponse" | "inputValue" | "language" | "mode">>, HTMLProps<ArcgisAssistantSpeechInput> {

package/dist/types/stencil.d.ts

@@ -23,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" | "streamingDisabled" | "suggestedPrompts">>, StencilJsx.HTMLAttributes<ArcgisAssistant> {
   onArcgisCancel?: EventHandler<ArcgisAssistant["arcgisCancel"]>;
   onArcgisError?: EventHandler<ArcgisAssistant["arcgisError"]>;
   onArcgisFeedback?: EventHandler<ArcgisAssistant["arcgisFeedback"]>;
@@ -32,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"]>;
 }
@@ -54,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"]>;
 }
@@ -67,7 +68,7 @@ interface StencilArcgisAssistantInterrupt extends Partial<Pick<ArcgisAssistantIn
   onArcgisSubmit?: EventHandler<ArcgisAssistantInterrupt["arcgisSubmit"]>;
 }
 
-interface StencilArcgisAssistantMessage extends Partial<Pick<ArcgisAssistantMessage, "copyEnabled" | "feedbackEnabled" | "footerDisabled" | "logEnabled" | "message" | "readAloudEnabled">>, StencilJsx.HTMLAttributes<ArcgisAssistantMessage> {
+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> {
@@ -80,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> {
@@ -89,7 +90,7 @@ interface StencilArcgisAssistantMessageLog extends Partial<Pick<ArcgisAssistantM
 interface StencilArcgisAssistantMessageReadAloud extends Partial<Pick<ArcgisAssistantMessageReadAloud, "message" | "readAloudEnabled">>, StencilJsx.HTMLAttributes<ArcgisAssistantMessageReadAloud> {
 }
 
-interface StencilArcgisAssistantMessageText extends Partial<Pick<ArcgisAssistantMessageText, "content">>, StencilJsx.HTMLAttributes<ArcgisAssistantMessageText> {
+interface StencilArcgisAssistantMessageText extends Partial<Pick<ArcgisAssistantMessageText, "content" | "parts">>, StencilJsx.HTMLAttributes<ArcgisAssistantMessageText> {
 }
 
 interface StencilArcgisAssistantSpeechInput extends Partial<Pick<ArcgisAssistantSpeechInput, "awaitingResponse" | "inputValue" | "language" | "mode">>, StencilJsx.HTMLAttributes<ArcgisAssistantSpeechInput> {

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.
@@ -174,8 +177,8 @@ export type ArcgisPromptOptions = {
    * and produce more accurate and relevant responses.
    */
   messages?: ChatHistory;
-  /** Abort signal for cooperative run cancellation. */
-  abortSignal?: AbortSignal;
+  /** 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
@@ -309,10 +312,21 @@ export function sendTraceMessage(data: TraceEventData, config?: RunnableConfig):
  */
 export function getEmbeddings(inputs: string[]): Promise<number[][]>;
 
+/**
+ * Calculates the cosine similarity between two numeric vectors. This is used to measure the similarity
+ * between two embedding vectors, where a score of 1 indicates identical vectors, 0 indicates orthogonal
+ * vectors, and -1 indicates opposite vectors.
+ *
+ * @param vectorA - The first vector array.
+ * @param vectorB - The second vector array.
+ * @returns A similarity score from -1 (opposite) to 1 (identical).
+ */
+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. */
@@ -324,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>;
 }
 
@@ -420,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;
@@ -431,37 +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 parameter0
- * @internal
- */
-export function createChatModel(parameter0?: {
-    modelTier?: ChatModelTier;
-    temperature?: number;
-    abortSignal?: AbortSignal;
-}): 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>;
@@ -469,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;
+    config?: RunnableConfig;
+}): Promise<ChatOpenAI>;

package/dist/utils/index.js

@@ -1,101 +1,116 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { g as p } from "../chunks/orchestrator.js";
-import { O as ge } from "../chunks/orchestrator.js";
-import { g as A, a as h, W as v, f as g, l as f, d as S, m as w, b as $, e as b, i as L, h as P, j as E, s as T, k as R, n as k, c as D, o as W } from "../chunks/generateLayerDescriptions.js";
-import x from "@arcgis/core/layers/FeatureLayer.js";
-import * as F from "@arcgis/core/core/reactiveUtils.js";
-import { N as M } from "../chunks/navigationGraph.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";
 import { L as C } from "../chunks/layerStylingGraph.js";
 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 (t) => {
-  const e = t.allLayers.toArray(), s = [], o = /* @__PURE__ */ new Map();
-  for (const a of e)
-    if (a instanceof x) {
+const I = async (e) => {
+  const t = e.allLayers.toArray(), s = [], o = /* @__PURE__ */ new Map();
+  for (const a of t)
+    if (a instanceof D) {
       const m = (async () => {
-        const r = await A(a), c = await h(a, r);
-        o.set(a.id, { layerItem: c, fieldRegistry: r });
+        const r = await S(a), n = await v(a, r);
+        o.set(a.id, { layerItem: n, fieldRegistry: r });
       })();
       s.push(m);
     }
   return await Promise.all(s), o;
-}, O = async (t) => {
-  await F.whenOnce(() => t.ready);
-  const e = await I(t.map), { layers: s } = await U(e), o = {
-    schemaVersion: b,
+}, O = async (e) => {
+  await W.whenOnce(() => e.ready);
+  const t = await I(e.map), { layers: s } = await U(t), o = {
+    schemaVersion: L,
     modified: Date.now(),
     embeddings: {
-      modelProvider: $,
-      model: w,
-      dimensions: S,
+      modelProvider: E,
+      model: b,
+      dimensions: $,
       templates: {
-        layer: f,
-        field: g
+        layer: y,
+        field: f
       }
     },
     layers: s
-  }, a = v.safeParse(o);
+  }, 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 (t) => {
-  const e = [], s = [];
-  for (const [r, { fieldRegistry: c, layerItem: n }] of t.entries()) {
-    const y = l(f, {
-      name: n.name,
-      title: n.title,
-      description: n.description
+}, U = async (e) => {
+  const t = [], s = [];
+  for (const [r, { fieldRegistry: n, layerItem: i }] of e.entries()) {
+    const l = g(y, {
+      name: i.name,
+      title: i.title,
+      description: i.description
     });
-    e.push(y);
+    t.push(l);
     const d = {
       id: r,
-      name: n.name ?? "",
-      title: n.title,
-      description: n.description,
+      name: i.name ?? "",
+      title: i.title,
+      description: i.description,
       vector: [],
       fields: []
     };
-    for (const [, i] of c.entries()) {
-      const u = l(g, {
-        name: i.name,
-        alias: i.alias,
-        description: i.description
+    for (const [, c] of n.entries()) {
+      const u = g(f, {
+        name: c.name,
+        alias: c.alias,
+        description: c.description
       });
-      e.push(u), d.fields.push({
-        name: i.name,
-        alias: i.alias,
-        description: i.description,
+      t.push(u), d.fields.push({
+        name: c.name,
+        alias: c.alias,
+        description: c.description,
         vector: []
       });
     }
     s.push(d);
   }
-  const o = await p(e);
+  const o = await p(t);
   let a = 0;
-  return { layers: s.map((r) => (r.vector = o[a++], r.fields.forEach((c) => {
-    c.vector = o[a++];
+  return { layers: s.map((r) => (r.vector = o[a++], r.fields.forEach((n) => {
+    n.vector = o[a++];
   }), r)) };
-}, l = (t, e) => t.replace(/\{(\w+)\}/gu, (s, o) => e[o] ?? ""), J = P, Q = L, Y = E, Z = T, ee = p, te = M, ae = C, se = N, oe = z, re = H, ne = O, ie = () => R(), ce = () => k(), me = async (t, e) => await W(t, e), de = async ({
-  modelTier: t = "default",
-  temperature: e = 0,
-  abortSignal: s
-} = {}) => await D({ modelTier: t, temperature: e, abortSignal: s });
+}, 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 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(o * a);
+  if (m === 0)
+    return 0;
+  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 {
-  re as ArcgisKnowledgeAgent,
-  se as DataExplorationAgent,
-  oe as HelpAgent,
-  ae as LayerStylingAgent,
-  te as NavigationAgent,
-  ge as Orchestrator,
-  ie as createAgentRuntimeState,
-  ce as createAgentRuntimeStateWithSharedState,
-  de as createChatModel,
-  ne as createWebmapEmbeddings,
-  ee as getEmbeddings,
-  Q as invokeStructuredPrompt,
-  J as invokeTextPrompt,
-  Y as invokeToolPrompt,
-  Z as sendTraceMessage,
-  me 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.6",
+  "version": "5.2.0-next.61",
   "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",
@@ -39,21 +40,21 @@
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
     "@esri/arcgis-html-sanitizer": "~4.1.0",
-    "@langchain/core": "^1.1.39",
-    "@langchain/langgraph": "^1.2.6",
-    "@langchain/openai": "^1.4.3",
-    "langchain": "^1.3.1",
+    "@langchain/core": "^1.2.1",
+    "@langchain/langgraph": "^1.4.7",
+    "@langchain/openai": "^1.5.3",
+    "langchain": "^1.5.2",
     "lit": "^3.3.0",
-    "marked": "~18.0.4",
+    "marked": "~18.0.7",
     "tslib": "^2.8.1",
-    "zod": "^4.3.6",
-    "@arcgis/toolkit": "5.2.0-next.6",
-    "@arcgis/lumina": "5.2.0-next.6"
+    "zod": "^4.4.3",
+    "@arcgis/toolkit": "5.2.0-next.61",
+    "@arcgis/lumina": "5.2.0-next.61"
   },
   "peerDependencies": {
-    "@arcgis/core": "^5.1.0-next",
-    "@esri/calcite-components": "^5.1.1-next.3",
-    "@arcgis/map-components": "~5.2.0-next.6"
+    "@arcgis/core": "^5.2.0-next",
+    "@esri/calcite-components": "^5.1.1",
+    "@arcgis/map-components": "~5.2.0-next.61"
   },
   "css.customData": [
     "dist/docs/vscode.css-custom-data.json"

package/dist/cdn/2AXF774U.js

@@ -1,2 +0,0 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{g as s,h as e,v as i,y as t}from"./OH64RMOR.js";import"./YIMNOUTF.js";var o=s`:host{display:contents}.icon{padding:var(--calcite-spacing-sm);border-radius:var(--calcite-spacing-xl);background:var(--calcite-color-brand);color:var(--calcite-color-foreground-1)}.loading-container{display:flex;flex-direction:column;gap:var(--calcite-spacing-sm);padding:0 var(--calcite-spacing-sm)}.loading{display:flex;align-items:center;gap:var(--calcite-spacing-sm)}.text{font-style:italic;word-wrap:break-word;word-break:break-all;overflow:hidden;text-overflow:ellipsis;display:-webkit-box;-webkit-line-clamp:1;line-clamp:1;-webkit-box-orient:vertical}.skeleton-block{display:flex;flex-direction:column;gap:var(--calcite-spacing-sm);width:100%}.skeleton-text{display:block;height:.95em;border-radius:var(--calcite-border-radius);background:linear-gradient(90deg,color-mix(in srgb,var(--calcite-color-foreground-2) 65%,transparent),color-mix(in srgb,var(--calcite-color-foreground-3) 85%,transparent),color-mix(in srgb,var(--calcite-color-foreground-2) 65%,transparent));background-size:200% 100%;animation:assistant-message-loading-shimmer 1.2s ease-in-out infinite;width:85%}.skeleton-text:last-child{width:70%}@keyframes assistant-message-loading-shimmer{0%{background-position:-150% 0}to{background-position:150% 0}}@media(prefers-reduced-motion){.skeleton-text{animation:none}}`,a=class extends i{constructor(){super(...arguments),this.loading=!1,this.loadingMessage=""}static{this.properties={loading:5,loadingMessage:1}}static{this.styles=o}render(){return this.loading?e`<arcgis-assistant-message footer-disabled><slot name=icon slot=icon><calcite-icon class="icon" icon=effects scale=s></calcite-icon></slot><slot name=content slot=content><div class="loading-container"><div class="loading"><calcite-loader label=loading inline></calcite-loader><div class="text">${this.loadingMessage}</div></div><div class="skeleton-block"><span class="skeleton-text"></span><span class="skeleton-text"></span></div></div></slot></arcgis-assistant-message>`:null}};t("arcgis-assistant-message-loading",a);export{a as ArcgisAssistantMessageLoading};

package/dist/cdn/3NI46YCE.js

@@ -1,2 +0,0 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import a from"./JV4SI65E.js";export default $arcgis.t(([,,,,,{f:t}])=>{var y=async(o,r)=>{let i=o.tool_calls??[];if(i.length===0){await t({text:`LLM did not request any tool calls: ${String(o?.content)}`},r);return}await Promise.all(i.map(async a=>await t({text:`LLM invoked ${a.name} tool with arguments: ${JSON.stringify(a.args,null,2)}`},r)))};return y},"identity/IdentityManager","portal/Portal","core/reactiveUtils","layers/FeatureLayer","request",a)

package/dist/cdn/3PKJWIC3.js

@@ -1,2 +0,0 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{a as l}from"./H7422XUG.js";import"./MH5RPXHM.js";import"./OAVEHGB6.js";import{g as a,h as e,k as o,t as i,u as n,v as r,y as c}from"./OH64RMOR.js";import"./YIMNOUTF.js";export default $arcgis.t(([{watch:d}])=>{var g=a`.container{display:flex;align-items:center;width:100%;justify-content:space-between;gap:var(--calcite-spacing-xs)}.start,.end{display:flex;align-items:center;gap:var(--calcite-spacing-xs)}`,t=class extends r{constructor(){super(...arguments),this._messages=l({blocking:!0}),this._endRef=i(),this._showLog=!1,this.feedbackEnabled=!1,this.logEnabled=!1,this.copyEnabled=!1,this.readAloudEnabled=!1}static{this.properties={_showLog:16,feedbackEnabled:5,logEnabled:5,copyEnabled:5,readAloudEnabled:5,message:0}}static{this.styles=g}loaded(){this.manager.onLifecycle(()=>[d(()=>this._showLog,()=>this._scrollToEnd())])}_scrollToEnd(){requestAnimationFrame(()=>{this._endRef.value?.scrollIntoView({behavior:"smooth",block:"end"})})}_renderCopyButton(){return!this.message?.error&&this.copyEnabled?e`<calcite-action id=action-copy icon=copy-to-clipboard scale=s @click=${async()=>{try{let s=this.message?.content?.trim();s&&await navigator.clipboard.writeText(s)}catch(s){o("warn","assistant-message-footer","Failed to copy text to clipboard",{once:!0,detail:{error:s}})}}} text></calcite-action><calcite-tooltip reference-element=action-copy overlay-positioning=fixed placement=bottom><span>${this._messages.copyButtonLabel}</span></calcite-tooltip>`:null}_renderLogButton(){return this.message?.log?.length&&this.logEnabled?e`<calcite-action id=action-log icon=access-string-results scale=s @click=${()=>this._showLog=!this._showLog} .text=${this._messages.logButtonLabel} .active=${this._showLog}></calcite-action><calcite-tooltip reference-element=action-log overlay-positioning=fixed placement=bottom><span>${this._messages.logButtonLabel}</span></calcite-tooltip>`:null}_renderReadAloudButton(){return e`<arcgis-assistant-message-read-aloud .message=${this.message} .readAloudEnabled=${this.readAloudEnabled}></arcgis-assistant-message-read-aloud>`}_renderLog(){return e`<arcgis-assistant-message-log .log=${this.message?.log} .showLog=${this._showLog} .logEnabled=${this.logEnabled}></arcgis-assistant-message-log>`}_renderFeedback(){return e`<arcgis-assistant-message-feedback .message=${this.message} .feedbackEnabled=${this.feedbackEnabled}></arcgis-assistant-message-feedback>`}render(){return e`${this._renderLog()}<div class="container"><div class="start">${this._renderCopyButton()}${this._renderLogButton()}${this._renderReadAloudButton()}<slot name=footer-actions-start></slot></div><div class="end"><slot name=footer-actions-end></slot>${this._renderFeedback()}</div></div><div ${n(this._endRef)}></div>`}};c("arcgis-assistant-message-footer",t);return t},"core/reactiveUtils")