@arcgis/ai-components 5.1.0-next.98 → 5.2.0-next.0

package/dist/types/lumina.d.ts

@@ -3,6 +3,7 @@ import type { ArcgisAssistant } from "../components/arcgis-assistant/customEleme
 import type { ArcgisAssistantAgent } from "../components/arcgis-assistant-agent/customElement.js";
 import type { ArcgisAssistantDataExplorationAgent } from "../components/arcgis-assistant-data-exploration-agent/customElement.js";
 import type { ArcgisAssistantHelpAgent } from "../components/arcgis-assistant-help-agent/customElement.js";
+import type { ArcgisAssistantKnowledgeAgent } from "../components/arcgis-assistant-knowledge-agent/customElement.js";
 import type { ArcgisAssistantLayerStylingAgent } from "../components/arcgis-assistant-layer-styling-agent/customElement.js";
 import type { ArcgisAssistantNavigationAgent } from "../components/arcgis-assistant-navigation-agent/customElement.js";
 import type { ArcgisAssistantChat } from "../components/arcgis-assistant-chat/customElement.js";
@@ -20,7 +21,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" | "readAloudEnabled" | "referenceElement" | "suggestedPrompts" | "voiceInputEnabled">>, h.JSX.HTMLAttributes<ArcgisAssistant> {
+interface LuminaArcgisAssistant extends Partial<Pick<ArcgisAssistant, "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"]>;
@@ -42,6 +43,9 @@ interface LuminaArcgisAssistantDataExplorationAgent extends Partial<Pick<ArcgisA
 interface LuminaArcgisAssistantHelpAgent extends Partial<Pick<ArcgisAssistantHelpAgent, "referenceElement">>, h.JSX.HTMLAttributes<ArcgisAssistantHelpAgent> {
 }
 
+interface LuminaArcgisAssistantKnowledgeAgent extends Partial<Pick<ArcgisAssistantKnowledgeAgent, "context" | "referenceElement" | "serviceUrl">>, h.JSX.HTMLAttributes<ArcgisAssistantKnowledgeAgent> {
+}
+
 interface LuminaArcgisAssistantLayerStylingAgent extends Partial<Pick<ArcgisAssistantLayerStylingAgent, "referenceElement">>, h.JSX.HTMLAttributes<ArcgisAssistantLayerStylingAgent> {
 }
 
@@ -107,6 +111,7 @@ declare module "@arcgis/lumina" {
       "arcgis-assistant-agent": LuminaArcgisAssistantAgent;
       "arcgis-assistant-data-exploration-agent": LuminaArcgisAssistantDataExplorationAgent;
       "arcgis-assistant-help-agent": LuminaArcgisAssistantHelpAgent;
+      "arcgis-assistant-knowledge-agent": LuminaArcgisAssistantKnowledgeAgent;
       "arcgis-assistant-layer-styling-agent": LuminaArcgisAssistantLayerStylingAgent;
       "arcgis-assistant-navigation-agent": LuminaArcgisAssistantNavigationAgent;
       "arcgis-assistant-chat": LuminaArcgisAssistantChat;

package/dist/types/preact.d.ts

@@ -3,6 +3,7 @@ import type { ArcgisAssistant } from "../components/arcgis-assistant/customEleme
 import type { ArcgisAssistantAgent } from "../components/arcgis-assistant-agent/customElement.js";
 import type { ArcgisAssistantDataExplorationAgent } from "../components/arcgis-assistant-data-exploration-agent/customElement.js";
 import type { ArcgisAssistantHelpAgent } from "../components/arcgis-assistant-help-agent/customElement.js";
+import type { ArcgisAssistantKnowledgeAgent } from "../components/arcgis-assistant-knowledge-agent/customElement.js";
 import type { ArcgisAssistantLayerStylingAgent } from "../components/arcgis-assistant-layer-styling-agent/customElement.js";
 import type { ArcgisAssistantNavigationAgent } from "../components/arcgis-assistant-navigation-agent/customElement.js";
 import type { ArcgisAssistantChat } from "../components/arcgis-assistant-chat/customElement.js";
@@ -21,7 +22,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" | "readAloudEnabled" | "referenceElement" | "suggestedPrompts" | "voiceInputEnabled">>, HTMLAttributes<ArcgisAssistant> {
+interface PreactArcgisAssistant extends Partial<Pick<ArcgisAssistant, "copyEnabled" | "description" | "entryMessage" | "feedbackEnabled" | "heading" | "keepSuggestedPrompts" | "logEnabled" | "messages" | "referenceElement" | "suggestedPrompts">>, HTMLAttributes<ArcgisAssistant> {
   onarcgisCancel?: EventHandler<ArcgisAssistant["arcgisCancel"]>;
   onarcgisError?: EventHandler<ArcgisAssistant["arcgisError"]>;
   onarcgisFeedback?: EventHandler<ArcgisAssistant["arcgisFeedback"]>;
@@ -43,6 +44,9 @@ interface PreactArcgisAssistantDataExplorationAgent extends Partial<Pick<ArcgisA
 interface PreactArcgisAssistantHelpAgent extends Partial<Pick<ArcgisAssistantHelpAgent, "referenceElement">>, HTMLAttributes<ArcgisAssistantHelpAgent> {
 }
 
+interface PreactArcgisAssistantKnowledgeAgent extends Partial<Pick<ArcgisAssistantKnowledgeAgent, "context" | "referenceElement" | "serviceUrl">>, HTMLAttributes<ArcgisAssistantKnowledgeAgent> {
+}
+
 interface PreactArcgisAssistantLayerStylingAgent extends Partial<Pick<ArcgisAssistantLayerStylingAgent, "referenceElement">>, HTMLAttributes<ArcgisAssistantLayerStylingAgent> {
 }
 
@@ -108,6 +112,7 @@ declare module 'preact' {
       "arcgis-assistant-agent": PreactArcgisAssistantAgent;
       "arcgis-assistant-data-exploration-agent": PreactArcgisAssistantDataExplorationAgent;
       "arcgis-assistant-help-agent": PreactArcgisAssistantHelpAgent;
+      "arcgis-assistant-knowledge-agent": PreactArcgisAssistantKnowledgeAgent;
       "arcgis-assistant-layer-styling-agent": PreactArcgisAssistantLayerStylingAgent;
       "arcgis-assistant-navigation-agent": PreactArcgisAssistantNavigationAgent;
       "arcgis-assistant-chat": PreactArcgisAssistantChat;
@@ -131,6 +136,7 @@ declare module 'preact' {
       "arcgis-assistant-agent": PreactArcgisAssistantAgent;
       "arcgis-assistant-data-exploration-agent": PreactArcgisAssistantDataExplorationAgent;
       "arcgis-assistant-help-agent": PreactArcgisAssistantHelpAgent;
+      "arcgis-assistant-knowledge-agent": PreactArcgisAssistantKnowledgeAgent;
       "arcgis-assistant-layer-styling-agent": PreactArcgisAssistantLayerStylingAgent;
       "arcgis-assistant-navigation-agent": PreactArcgisAssistantNavigationAgent;
       "arcgis-assistant-chat": PreactArcgisAssistantChat;

package/dist/types/react.d.ts

@@ -3,6 +3,7 @@ import type { ArcgisAssistant } from "../components/arcgis-assistant/customEleme
 import type { ArcgisAssistantAgent } from "../components/arcgis-assistant-agent/customElement.js";
 import type { ArcgisAssistantDataExplorationAgent } from "../components/arcgis-assistant-data-exploration-agent/customElement.js";
 import type { ArcgisAssistantHelpAgent } from "../components/arcgis-assistant-help-agent/customElement.js";
+import type { ArcgisAssistantKnowledgeAgent } from "../components/arcgis-assistant-knowledge-agent/customElement.js";
 import type { ArcgisAssistantLayerStylingAgent } from "../components/arcgis-assistant-layer-styling-agent/customElement.js";
 import type { ArcgisAssistantNavigationAgent } from "../components/arcgis-assistant-navigation-agent/customElement.js";
 import type { ArcgisAssistantChat } from "../components/arcgis-assistant-chat/customElement.js";
@@ -21,7 +22,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" | "readAloudEnabled" | "referenceElement" | "suggestedPrompts" | "voiceInputEnabled">>, HTMLProps<ArcgisAssistant> {
+interface ReactArcgisAssistant extends Partial<Pick<ArcgisAssistant, "copyEnabled" | "description" | "entryMessage" | "feedbackEnabled" | "heading" | "keepSuggestedPrompts" | "logEnabled" | "messages" | "referenceElement" | "suggestedPrompts">>, HTMLProps<ArcgisAssistant> {
   onarcgisCancel?: EventHandler<ArcgisAssistant["arcgisCancel"]>;
   onarcgisError?: EventHandler<ArcgisAssistant["arcgisError"]>;
   onarcgisFeedback?: EventHandler<ArcgisAssistant["arcgisFeedback"]>;
@@ -43,6 +44,9 @@ interface ReactArcgisAssistantDataExplorationAgent extends Partial<Pick<ArcgisAs
 interface ReactArcgisAssistantHelpAgent extends Partial<Pick<ArcgisAssistantHelpAgent, "referenceElement">>, HTMLProps<ArcgisAssistantHelpAgent> {
 }
 
+interface ReactArcgisAssistantKnowledgeAgent extends Partial<Pick<ArcgisAssistantKnowledgeAgent, "context" | "referenceElement" | "serviceUrl">>, HTMLProps<ArcgisAssistantKnowledgeAgent> {
+}
+
 interface ReactArcgisAssistantLayerStylingAgent extends Partial<Pick<ArcgisAssistantLayerStylingAgent, "referenceElement">>, HTMLProps<ArcgisAssistantLayerStylingAgent> {
 }
 
@@ -108,6 +112,7 @@ declare module "react" {
       "arcgis-assistant-agent": ReactArcgisAssistantAgent;
       "arcgis-assistant-data-exploration-agent": ReactArcgisAssistantDataExplorationAgent;
       "arcgis-assistant-help-agent": ReactArcgisAssistantHelpAgent;
+      "arcgis-assistant-knowledge-agent": ReactArcgisAssistantKnowledgeAgent;
       "arcgis-assistant-layer-styling-agent": ReactArcgisAssistantLayerStylingAgent;
       "arcgis-assistant-navigation-agent": ReactArcgisAssistantNavigationAgent;
       "arcgis-assistant-chat": ReactArcgisAssistantChat;
@@ -133,6 +138,7 @@ declare module "react/jsx-runtime" {
       "arcgis-assistant-agent": ReactArcgisAssistantAgent;
       "arcgis-assistant-data-exploration-agent": ReactArcgisAssistantDataExplorationAgent;
       "arcgis-assistant-help-agent": ReactArcgisAssistantHelpAgent;
+      "arcgis-assistant-knowledge-agent": ReactArcgisAssistantKnowledgeAgent;
       "arcgis-assistant-layer-styling-agent": ReactArcgisAssistantLayerStylingAgent;
       "arcgis-assistant-navigation-agent": ReactArcgisAssistantNavigationAgent;
       "arcgis-assistant-chat": ReactArcgisAssistantChat;
@@ -158,6 +164,7 @@ declare module "react/jsx-dev-runtime" {
       "arcgis-assistant-agent": ReactArcgisAssistantAgent;
       "arcgis-assistant-data-exploration-agent": ReactArcgisAssistantDataExplorationAgent;
       "arcgis-assistant-help-agent": ReactArcgisAssistantHelpAgent;
+      "arcgis-assistant-knowledge-agent": ReactArcgisAssistantKnowledgeAgent;
       "arcgis-assistant-layer-styling-agent": ReactArcgisAssistantLayerStylingAgent;
       "arcgis-assistant-navigation-agent": ReactArcgisAssistantNavigationAgent;
       "arcgis-assistant-chat": ReactArcgisAssistantChat;

package/dist/types/stencil.d.ts

@@ -3,6 +3,7 @@ import type { ArcgisAssistant } from "../components/arcgis-assistant/customEleme
 import type { ArcgisAssistantAgent } from "../components/arcgis-assistant-agent/customElement.js";
 import type { ArcgisAssistantDataExplorationAgent } from "../components/arcgis-assistant-data-exploration-agent/customElement.js";
 import type { ArcgisAssistantHelpAgent } from "../components/arcgis-assistant-help-agent/customElement.js";
+import type { ArcgisAssistantKnowledgeAgent } from "../components/arcgis-assistant-knowledge-agent/customElement.js";
 import type { ArcgisAssistantLayerStylingAgent } from "../components/arcgis-assistant-layer-styling-agent/customElement.js";
 import type { ArcgisAssistantNavigationAgent } from "../components/arcgis-assistant-navigation-agent/customElement.js";
 import type { ArcgisAssistantChat } from "../components/arcgis-assistant-chat/customElement.js";
@@ -21,7 +22,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" | "readAloudEnabled" | "referenceElement" | "suggestedPrompts" | "voiceInputEnabled">>, StencilJsx.HTMLAttributes<ArcgisAssistant> {
+interface StencilArcgisAssistant extends Partial<Pick<ArcgisAssistant, "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"]>;
@@ -43,6 +44,9 @@ interface StencilArcgisAssistantDataExplorationAgent extends Partial<Pick<Arcgis
 interface StencilArcgisAssistantHelpAgent extends Partial<Pick<ArcgisAssistantHelpAgent, "referenceElement">>, StencilJsx.HTMLAttributes<ArcgisAssistantHelpAgent> {
 }
 
+interface StencilArcgisAssistantKnowledgeAgent extends Partial<Pick<ArcgisAssistantKnowledgeAgent, "context" | "referenceElement" | "serviceUrl">>, StencilJsx.HTMLAttributes<ArcgisAssistantKnowledgeAgent> {
+}
+
 interface StencilArcgisAssistantLayerStylingAgent extends Partial<Pick<ArcgisAssistantLayerStylingAgent, "referenceElement">>, StencilJsx.HTMLAttributes<ArcgisAssistantLayerStylingAgent> {
 }
 
@@ -106,6 +110,7 @@ interface ExposedElements {
   "arcgis-assistant-agent": StencilArcgisAssistantAgent;
   "arcgis-assistant-data-exploration-agent": StencilArcgisAssistantDataExplorationAgent;
   "arcgis-assistant-help-agent": StencilArcgisAssistantHelpAgent;
+  "arcgis-assistant-knowledge-agent": StencilArcgisAssistantKnowledgeAgent;
   "arcgis-assistant-layer-styling-agent": StencilArcgisAssistantLayerStylingAgent;
   "arcgis-assistant-navigation-agent": StencilArcgisAssistantNavigationAgent;
   "arcgis-assistant-chat": StencilArcgisAssistantChat;

package/dist/utils/index.d.ts

@@ -1,12 +1,24 @@
-import type z from "zod";
-import type { ChatHistory } from "@arcgis/ai-orchestrator";
-import type { AIMessage } from "@langchain/core/messages";
+import type MapView from "@arcgis/core/views/MapView.js";
+import type KnowledgeGraph from "@arcgis/core/rest/knowledgeGraph/KnowledgeGraph.js";
+import type LinkChartView from "@arcgis/core/views/LinkChartView.js";
+import type { AIMessage, BaseMessage } from "@langchain/core/messages";
 import type { RunnableConfig } from "@langchain/core/runnables";
 import type { StructuredToolInterface } from "@langchain/core/tools";
-import type { AnnotationRoot, StateGraph } from "@langchain/langgraph/web";
+import type { AnnotationRoot, BaseChannel, StateGraph } from "@langchain/langgraph/web";
+import type { ChatOpenAI } from "@langchain/openai";
+import type { ZodType } from "zod";
 
-export { type ChatHistory } from "@arcgis/ai-orchestrator";
-export { type CustomConfigurableType } from "@arcgis/ai-orchestrator";
+export { type CustomConfigurableType } from "../orchestrator";
+export { Orchestrator } from "../orchestrator";
+
+/**
+ * Represents the chat message history between the user and the assistant, including all messages sent and received during the conversation.
+ * This structure is used to provide context for the assistant's responses and can be utilized when invoking prompts to ensure the model
+ * has access to the full conversation history.
+ *
+ * @since 5.0
+ */
+export type ChatHistory = BaseMessage[];
 
 /**
  * Represents a user-facing interruption emitted by an agent that requires
@@ -147,7 +159,7 @@ export type ArcgisPromptOptions = {
    * agent descriptions and tool node descriptions to
    * ensure they still return the expected responses. You should adjust your implementation as needed.
    */
-  modelTier?: "advanced" | "default";
+  modelTier?: ChatModelTier;
   /**
    * The temperature to use for the model (a number between 0 and 1). Higher values will result in more
    * creative and varied responses, while lower values will produce more focused and deterministic responses.
@@ -183,7 +195,7 @@ export type ArcgisStructuredPromptOptions<T> = ArcgisPromptOptions
    *
    * @see [Zod documentation](https://zod.dev/api)
    */
-  schema: z.ZodType<T>;
+  schema: ZodType<T>;
 };
 
 /**
@@ -302,4 +314,186 @@ export function getEmbeddings(inputs: string[]): Promise<number[][]>;
  * @param vectorB - The second vector array.
  * @returns A similarity score from -1 (opposite) to 1 (identical).
  */
-export function cosineSimilarity(vectorA: number[], vectorB: number[]): number;
+export function cosineSimilarity(vectorA: number[], vectorB: number[]): number;
+
+/**
+ * The suggestions emitted by the agent to the user interface.
+ *
+ * @internal
+ */
+export type UXSuggestion = {
+  /** The type of suggestion being made. */
+  type: string;
+  /** Optional additional data associated with the suggestion. */
+  data?: Record<string, unknown>;
+};
+
+/**
+ * Execution status returned by an agent run.
+ *
+ * @internal
+ */
+export type AgentStatus = "failed" | "success" | "unknown";
+
+/**
+ * Summary of a previously executed agent step.
+ *
+ * @internal
+ */
+export interface PriorStep {
+  agentId: string;
+  assignedTask: string;
+  summary: string;
+  status: AgentStatus;
+}
+
+/**
+ * Runtime execution context available to agent graph nodes and tools.
+ *
+ * @internal
+ */
+export interface AgentExecutionContext<TState extends Record<string, unknown> = Record<string, unknown>> {
+  userRequest: string;
+  assignedTask: string;
+  messages: ChatHistory;
+  priorSteps: PriorStep[];
+  sharedState: SharedState<TState>;
+}
+
+/** @internal */
+export const NavigationAgent: AgentRegistration;
+
+/** @internal */
+export type NavigationContext = {
+  mapView: MapView;
+};
+
+/** @internal */
+export const LayerStylingAgent: AgentRegistration;
+
+/** @internal */
+export type LayerStylingContext = {
+  mapView: MapView;
+};
+
+/** @internal */
+export const DataExplorationAgent: AgentRegistration;
+
+/** @internal */
+export type DataExplorationContext = {
+  mapView: MapView;
+};
+
+/** @internal */
+export const HelpAgent: AgentRegistration;
+
+/** @internal */
+export const ArcgisKnowledgeAgent: AgentRegistration;
+
+/** @internal */
+export type ArcgisKnowledgeContext = {
+    knowledgeGraph: KnowledgeGraph;
+    view?: never;
+} | {
+    view: LinkChartView | MapView;
+    knowledgeGraph?: never;
+};
+
+/** @internal */
+export const createWebmapEmbeddings: (mapView: MapView) => Promise<{
+    schemaVersion: "0.1";
+    modified: number;
+    embeddings: {
+        modelProvider: "openai";
+        model: string;
+        dimensions: 1536;
+        templates: {
+            layer: string;
+            field: string;
+        };
+    };
+    layers: Array<{
+        id: string;
+        name: string;
+        title: string;
+        description: string;
+        vector: Array<number>;
+        fields: Array<{
+            name: string;
+            alias: string;
+            description: string;
+            vector: Array<number>;
+        }>;
+    }>;
+}>;
+
+/** @internal */
+export interface AgentWithContext<TContext extends Record<string, unknown> = Record<string, unknown>> {
+  agent: AgentRegistration;
+  /**
+   * Lazily resolves runtime context.
+   * Can be sync or async, and may perform lifecycle checks (e.g. await view.when()).
+   */
+  getContext?: GetContext<TContext>;
+}
+
+/** @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>;
+
+/** @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>;
+  summary: BaseChannel<string, unknown, unknown>;
+  status: BaseChannel<AgentStatus | undefined, unknown, unknown>;
+};
+
+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;
+};
+
+export type SharedState<T extends Record<string, unknown> = Record<string, unknown>> = {
+    [K in keyof T]?: SharedStateEntry<T[K]>;
+};
+
+export type AgentExecutionContextWithSharedState<TState extends Record<string, unknown> = Record<string, unknown>> = AgentExecutionContext<TState>;
+
+/** Stored shared state entry. `meta` is added by the orchestrator. */
+export type SharedStateEntry<T = unknown> = {
+  value: T;
+  meta: {
+      updatedByAgentId: string;
+      updatedAt: number;
+  };
+};

package/dist/utils/index.js

@@ -1,13 +1,111 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import { cosineSimilarity as o, getEmbeddings as e, invokeStructuredPrompt as t, invokeTextPrompt as i, invokeToolPrompt as s, sendTraceMessage as r } from "@arcgis/ai-orchestrator";
-import "@langchain/langgraph/web";
-import "zod";
-const c = i, p = t, d = s, g = r, k = e, v = o;
+/* 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 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 (e) => {
+  const t = e.allLayers.toArray(), n = [], s = /* @__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 });
+      })();
+      n.push(m);
+    }
+  return await Promise.all(n), s;
+}, O = async (e) => {
+  await W.whenOnce(() => e.ready);
+  const t = await I(e.map), { layers: n } = await U(t), s = {
+    schemaVersion: b,
+    modified: Date.now(),
+    embeddings: {
+      modelProvider: $,
+      model: w,
+      dimensions: v,
+      templates: {
+        layer: y,
+        field: f
+      }
+    },
+    layers: n
+  }, a = S.safeParse(s);
+  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 l = g(y, {
+      name: i.name,
+      title: i.title,
+      description: i.description
+    });
+    t.push(l);
+    const d = {
+      id: o,
+      name: i.name ?? "",
+      title: i.title,
+      description: i.description,
+      vector: [],
+      fields: []
+    };
+    for (const [, c] of r.entries()) {
+      const u = g(f, {
+        name: c.name,
+        alias: c.alias,
+        description: c.description
+      });
+      t.push(u), d.fields.push({
+        name: c.name,
+        alias: c.alias,
+        description: c.description,
+        vector: []
+      });
+    }
+    n.push(d);
+  }
+  const s = 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) => {
+  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;
+  }
+  const m = Math.sqrt(s * 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);
 export {
-  v as cosineSimilarity,
-  k as getEmbeddings,
-  p as invokeStructuredPrompt,
-  c as invokeTextPrompt,
-  d as invokeToolPrompt,
-  g as sendTraceMessage
+  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
 };

package/package.json

@@ -1,14 +1,29 @@
 {
   "name": "@arcgis/ai-components",
-  "version": "5.1.0-next.98",
+  "version": "5.2.0-next.0",
   "description": "ArcGIS AI Components",
   "type": "module",
-  "main": "dist/index.js",
-  "module": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": "./dist/index.js",
     "./loader": "./dist/loader.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",
+    "./agent-utils/WorkflowAgent.js": "./dist/agent-utils/WorkflowAgent.js",
+    "./agent-utils/tools/FunctionTool.js": "./dist/agent-utils/tools/FunctionTool.js",
+    "./agent-utils/workflows/ConditionalWorkflow.js": "./dist/agent-utils/workflows/ConditionalWorkflow.js",
+    "./agent-utils/workflows/LoopWorkflow.js": "./dist/agent-utils/workflows/LoopWorkflow.js",
+    "./agent-utils/workflows/ParallelWorkflow.js": "./dist/agent-utils/workflows/ParallelWorkflow.js",
+    "./agent-utils/workflows/RouterWorkflow.js": "./dist/agent-utils/workflows/RouterWorkflow.js",
+    "./agent-utils/workflows/SequentialWorkflow.js": "./dist/agent-utils/workflows/SequentialWorkflow.js",
+    "./agent-utils/workflows/SwitchWorkflow.js": "./dist/agent-utils/workflows/SwitchWorkflow.js",
+    "./agent-utils/middlewares/middleware.js": "./dist/agent-utils/middlewares/middleware.js",
+    "./agent-utils/middlewares/humanInTheLoop.js": "./dist/agent-utils/middlewares/humanInTheLoop.js",
+    "./agent-utils/middlewares/trace.js": "./dist/agent-utils/middlewares/trace.js",
+    "./agent-utils/middlewares/types.js": "./dist/agent-utils/middlewares/types.js",
     "./utils/index.js": "./dist/utils/index.js",
     "./package.json": "./package.json",
     "./components/*/customElement": "./dist/components/*/customElement.js",
@@ -26,19 +41,19 @@
     "@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",
     "lit": "^3.3.0",
-    "marked": "~18.0.3",
+    "marked": "~18.0.4",
     "tslib": "^2.8.1",
     "zod": "^4.3.6",
-    "@arcgis/ai-agents": "5.1.0-next.98",
-    "@arcgis/lumina": "5.1.0-next.98",
-    "@arcgis/ai-orchestrator": "5.1.0-next.98",
-    "@arcgis/toolkit": "5.1.0-next.98"
+    "@arcgis/lumina": "5.2.0-next.0",
+    "@arcgis/toolkit": "5.2.0-next.0"
   },
   "peerDependencies": {
     "@arcgis/core": "^5.1.0-next",
-    "@esri/calcite-components": "^5.1.0-next.45",
-    "@arcgis/map-components": "~5.1.0-next.98"
+    "@esri/calcite-components": "^5.1.0-next.60",
+    "@arcgis/map-components": "~5.2.0-next.0"
   },
   "css.customData": [
     "dist/docs/vscode.css-custom-data.json"

package/dist/cdn/4CPZZBYD.js

@@ -1,2 +0,0 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import c from"./Z4N6N4OZ.js";import b from"./D7WNBUVK.js";import"./YW52XJMM.js";import{a as i,c as e}from"./B4DEC7PH.js";import"./KVH3PDVW.js";import"./YGW7TUNX.js";import{v as a,y as s}from"./DSEMD4M2.js";import"./CFDTXKJ6.js";export default $arcgis.t(([,{a:r}])=>{var t=class extends a{constructor(){super(...arguments),this.agent=r}static{this.properties={referenceElement:1}}#t;getContext(){if(!this.#t)throw new Error("arcgis-assistant-navigation-agent requires a mapView");return{mapView:this.#t}}load(){this.#t=i(this,"arcgis-assistant-navigation-agent"),e(this)}};s("arcgis-assistant-navigation-agent",t);return t},b,c)

package/dist/cdn/5JS65BCP.js

@@ -1,29 +0,0 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import"./CFDTXKJ6.js";var e=`## ArcgisKnowledge Agent - Tool Intent Classifier
-
-You are an assistant that classifies user intent for arcgisKnowledge agent.
-
-You are given the following tool options:
-{tools}
-
-Return exactly one intent (tool name) based on the task details below. Use the provided user request or prior steps only if needed for context based on the assigned task.
-If no tool apply, return an **empty string**.
-
-**Task Details**
-
-Assigned Task:
-{assignedTask}
-
-User Request:
-{userRequest}
-
-Prior steps:
-{priorSteps}
-
-**End Task Details**
-
-Reminder:
-Choose only from provided tools.
-
-Return the name of the tool as a string.
-`;export{e as default};

package/dist/cdn/7EHQLXMU.js

@@ -1,2 +0,0 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import c from"./Z4N6N4OZ.js";import b from"./D7WNBUVK.js";import"./YW52XJMM.js";import{a as r,c as a}from"./B4DEC7PH.js";import"./KVH3PDVW.js";import"./YGW7TUNX.js";import{v as s,y as e}from"./DSEMD4M2.js";import"./CFDTXKJ6.js";export default $arcgis.t(([,{d:i}])=>{var t=class extends s{constructor(){super(...arguments),this.agent=i}static{this.properties={referenceElement:1}}#t;getContext(){if(!this.#t)throw new Error("arcgis-assistant-help-agent requires a mapView");return{mapView:this.#t}}load(){this.#t=r(this,"arcgis-assistant-help-agent"),a(this)}};e("arcgis-assistant-help-agent",t);return t},b,c)

package/dist/cdn/AKOWC7YT.js

@@ -1,18 +0,0 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import"./CFDTXKJ6.js";var e=`# ArcgisKnowledge Tool Instructions
-
-CRITICAL: You are FORBIDDEN from making multiple tool calls. You MUST make exactly ONE tool call.
-
-Detected intent:
-{intent}
-
-Assigned task:
-{assignedTask}
-
-Latest user request:
-{userRequest}
-
-Rules:
-
-- Call exactly one arcgisKnowledge tool, with the appropriate arguments given the detected intent and assigned task. Use the latest user request for context where necessary.
-`;export{e as default};