@arcgis/ai-components 5.1.0-next.99 → 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.99",
+  "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.99",
-    "@arcgis/toolkit": "5.1.0-next.99",
-    "@arcgis/lumina": "5.1.0-next.99",
-    "@arcgis/ai-orchestrator": "5.1.0-next.99"
+    "@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.99"
+    "@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/4QVKWA2Z.js

@@ -1,24 +0,0 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import"./CFDTXKJ6.js";var e=`# ArcgisKnowledge Tool Instructions
-
-You are an assistant that helps users answer questions and perform operations on their knowledge graph or link chart. You have been assigned the task below, which must be achieved by calling a single tool.
-
-## Task Details:
-
-Assigned task:
-{assignedTask}
-
-User Request:
-{userRequest}
-
-Prior steps:
-{priorSteps}
-
-## Your Goal:
-
-Call exactly one arcgisKnowledge tool, with the appropriate arguments given the assigned task. Use the provided user request or prior steps only if needed for context based on the assigned task.
-
-If no tools apply, return an **empty string**
-
-CRITICAL: You are FORBIDDEN from making multiple tool calls. You MUST make exactly ONE tool call.
-`;export{e as default};

package/dist/cdn/5L7OZ37N.js

@@ -1,2 +0,0 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import c from"./6ALN3KMA.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)