@arcgis/ai-components 5.1.0-next.13 → 5.1.0-next.130

package/dist/components/arcgis-assistant-data-exploration-agent/customElement.js

@@ -1,11 +1,27 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
 import { c as t } from "../../chunks/runtime.js";
-import { LitElement as a } from "@arcgis/lumina";
-import { DataExplorationAgent as e } from "@arcgis/ai-agents";
-import { r as s, i } from "../../chunks/utils.js";
-class r extends a {
+import { LitElement as i } from "@arcgis/lumina";
+import "@langchain/langgraph/web";
+import "../../chunks/adapter.js";
+import "@arcgis/core/identity/IdentityManager.js";
+import "@arcgis/core/portal/Portal.js";
+import "../../chunks/generateLayerDescriptions.js";
+import "@langchain/core/messages";
+import "@langchain/core/callbacks/dispatch/web";
+import "@langchain/openai";
+import "@arcgis/core/core/reactiveUtils.js";
+import "@arcgis/core/layers/FeatureLayer.js";
+import "@arcgis/core/request.js";
+import "@langchain/core/prompts";
+import "@langchain/langgraph/prebuilt";
+import "zod";
+import { D as r } from "../../chunks/dataExplorationGraph.js";
+import "@arcgis/core/views/LinkChartView.js";
+import "@arcgis/core/rest/knowledgeGraphService.js";
+import { r as a, a as o } from "../../chunks/utils2.js";
+class s extends i {
   constructor() {
-    super(...arguments), this.agent = e;
+    super(...arguments), this.agent = r;
   }
   static {
     this.properties = { referenceElement: 1 };
@@ -17,10 +33,10 @@ class r extends a {
     return { mapView: this.#t };
   }
   load() {
-    this.#t = s(this, "arcgis-assistant-data-exploration-agent"), i(this);
+    this.#t = a(this, "arcgis-assistant-data-exploration-agent"), o(this);
   }
 }
-t("arcgis-assistant-data-exploration-agent", r);
+t("arcgis-assistant-data-exploration-agent", s);
 export {
-  r as ArcgisAssistantDataExplorationAgent
+  s as ArcgisAssistantDataExplorationAgent
 };

package/dist/components/arcgis-assistant-help-agent/customElement.d.ts

@@ -3,13 +3,17 @@ import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { ArcgisMap as ArcgisMap } from "@arcgis/map-components/components/arcgis-map";
 
 /**
- * The Help Agent component provides contextual assistance and guidance to the end user within a web map application.
- * It can offer tips, instructions, and other helpful information based on the current map view and user interactions.
+ * The Help Agent provides contextual assistance and guidance to the end user within an
+ * agentic web mapping application. It can provide answers to questions about the web map provided
+ * to the [referenceElement](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant-help-agent/#referenceElement) property and answer questions about other agents included
+ * as subcomponents to the [arcgis-assistant](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/) component.
  *
- * This is an unrendered component that must be added as a child of the `arcgis-assistant` component in either HTML or JavaScript.
+ * This is an unrendered component that must be added as a child of the `arcgis-assistant` component in
+ * either HTML or JavaScript.
  *
  * ```html
- * <arcgis-assistant>
+ * <arcgis-map id="my-map"></arcgis-map>
+ * <arcgis-assistant reference-element="my-map">
  *   <arcgis-assistant-help-agent></arcgis-assistant-help-agent>
  * </arcgis-assistant>
  * ```
@@ -20,14 +24,50 @@ import type { ArcgisMap as ArcgisMap } from "@arcgis/map-components/components/a
  * assistant.appendChild(helpAgent);
  * ```
  *
+ * Once added to the assistant, the agent is loaded and ready to receive user messages related to help and guidance.
+ *
+ * ### Example questions
+ *
+ * The following are example questions a user can ask within the bounds of the help agent:
+ *
+ * - "What kind of questions can I ask?"
+ * - "What layers are in this map?"
+ * - "What kind of data can I ask questions about?"
+ *
+ * The following are examples of the types of questions that fall outside the bounds of the
+ * help agent and should therefore be avoided:
+ *
+ * - "Search the Esri documentation for ways that I can query my data."
+ * - "Log a bug related to map navigation to the Esri support team."
+ * - "How do I bake a cake?"
+ * - "How does map navigation work in ArcGIS?"
+ *
+ * > Due to the non-deterministic nature of generative AI, there may be inaccuracies or unexpected behavior when using the
+ * out-of-the-box agents.
+ *
  * @since 5.0
  * @beta
  * @see [arcgis-assistant](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/)
+ * @see [Intro to building agentic mapping applications](https://developers.arcgis.com/javascript/latest/agentic-apps/ai-introduction/)
+ * @see [AI Assistant component sample](https://developers.arcgis.com/javascript/latest/sample-code/ai-assistant/)
  */
 export abstract class ArcgisAssistantHelpAgent extends LitElement {
   /**
-   * A reference to the map element or its ID string used to resolve the MapView for this agent.
-   * If not provided, the agent will attempt to find the closest parent `arcgis-map` element.
+   * The reference element to the map that provides context for the help agent. Currently,
+   * this is only scoped to `arcgis-map` elements. This shows the help agent which map for which to
+   * provide assistance. This allows users to ask questions about the specific map provided to the agent.
+   *
+   * Setting this property is not necessary if you set the reference element on the parent
+   * `arcgis-assistant` component.
+   *
+   * @see [arcgis-assistant.referenceElement](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/#referenceElement)
+   * @example
+   * ```html
+   * <arcgis-map id="my-map"></arcgis-map>
+   * <arcgis-assistant>
+   *   <arcgis-assistant-help-agent reference-element="my-map"></arcgis-assistant-help-agent>
+   * </arcgis-assistant>
+   * ```
    */
   accessor referenceElement: ArcgisMap | string | undefined;
 }

package/dist/components/arcgis-assistant-help-agent/customElement.js

@@ -1,11 +1,30 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
 import { c as t } from "../../chunks/runtime.js";
-import { LitElement as e } from "@arcgis/lumina";
-import { HelpAgent as s } from "@arcgis/ai-agents";
-import { r as i, i as r } from "../../chunks/utils.js";
-class a extends e {
+import { LitElement as i } from "@arcgis/lumina";
+import "@langchain/langgraph/web";
+import "../../chunks/adapter.js";
+import "@arcgis/core/identity/IdentityManager.js";
+import "@arcgis/core/portal/Portal.js";
+import "../../chunks/generateLayerDescriptions.js";
+import "@langchain/core/messages";
+import "@langchain/core/callbacks/dispatch/web";
+import "@langchain/openai";
+import "@arcgis/core/core/reactiveUtils.js";
+import "@arcgis/core/layers/FeatureLayer.js";
+import "@arcgis/core/request.js";
+import "@langchain/core/prompts";
+import "@langchain/langgraph/prebuilt";
+import "zod";
+import "@arcgis/core/intl.js";
+import "@arcgis/core/smartMapping/statistics/summaryStatistics.js";
+import "@arcgis/core/smartMapping/statistics/uniqueValues.js";
+import { H as r } from "../../chunks/helpGraph.js";
+import "@arcgis/core/views/LinkChartView.js";
+import "@arcgis/core/rest/knowledgeGraphService.js";
+import { r as e, a as s } from "../../chunks/utils2.js";
+class o extends i {
   constructor() {
-    super(...arguments), this.agent = s;
+    super(...arguments), this.agent = r;
   }
   static {
     this.properties = { referenceElement: 1 };
@@ -17,10 +36,10 @@ class a extends e {
     return { mapView: this.#t };
   }
   load() {
-    this.#t = i(this, "arcgis-assistant-help-agent"), r(this);
+    this.#t = e(this, "arcgis-assistant-help-agent"), s(this);
   }
 }
-t("arcgis-assistant-help-agent", a);
+t("arcgis-assistant-help-agent", o);
 export {
-  a as ArcgisAssistantHelpAgent
+  o as ArcgisAssistantHelpAgent
 };

package/dist/components/arcgis-assistant-interrupt/customElement.d.ts

@@ -2,7 +2,10 @@
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 
-/** @internal */
+/**
+ * Renders interrupt prompts for extra user input. Use it when an agent pauses for confirmation, choice, or text input.
+ * Offers interrupt-specific input modes and submit or cancel event handling.
+ */
 export abstract class ArcgisAssistantInterrupt extends LitElement {
   /** @internal */
   protected _messages: {

package/dist/components/arcgis-assistant-interrupt/customElement.js

@@ -1,18 +1,18 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
 import { c as a } from "../../chunks/runtime.js";
 import { css as c, html as e } from "lit";
-import { LitElement as l, createEvent as s } from "@arcgis/lumina";
-import { u as n } from "../../chunks/useT9n.js";
-const r = c``;
+import { LitElement as l, createEvent as i } from "@arcgis/lumina";
+import { u as r } from "../../chunks/useT9n.js";
+const n = c`:host{width:100%;padding:var(--calcite-spacing-md);background:var(--calcite-panel-background-color, var(--calcite-color-background))}calcite-panel{border-radius:var(--calcite-dialog-corner-radius, var(--calcite-corner-radius-sm));border:0 solid var(--calcite-color-brand);border-block-start-width:4px;box-shadow:var(--calcite-shadow-md);width:100%;--calcite-panel-border-color: none}.interrupt-content{padding:0 var(--calcite-spacing-md);background:var(--calcite-color-foreground-1)}`;
 class o extends l {
   constructor() {
-    super(...arguments), this.#t = [], this._messages = n({ blocking: !0 }), this.arcgisCancel = s(), this.arcgisSubmit = s();
+    super(...arguments), this.#t = [], this._messages = r({ blocking: !0 }), this.arcgisCancel = i(), this.arcgisSubmit = i();
   }
   static {
     this.properties = { type: 1, message: 1, options: 0 };
   }
   static {
-    this.styles = r;
+    this.styles = n;
   }
   #t;
   _renderInterruptOptions() {
@@ -20,7 +20,7 @@ class o extends l {
       case "single-select":
         return e`<calcite-list selection-mode=single-persist .label=${this._messages.optionsLabel} @calciteListChange=${(t) => this.#t = t.target.selectedItems[0]?.value}>${this.options?.map((t) => e`<calcite-list-item .label=${t} .value=${t}></calcite-list-item>`)}</calcite-list>`;
       case "multi-select":
-        return e`<calcite-list selection-mode=multiple .label=${this._messages.optionsLabel} @calciteListChange=${(t) => this.#t = t.target.selectedItems.map((i) => i.value)}>${this.options?.map((t) => e`<calcite-list-item .label=${t} .value=${t}></calcite-list-item>`)}</calcite-list>`;
+        return e`<calcite-list selection-mode=multiple .label=${this._messages.optionsLabel} @calciteListChange=${(t) => this.#t = t.target.selectedItems.map((s) => s.value)}>${this.options?.map((t) => e`<calcite-list-item .label=${t} .value=${t}></calcite-list-item>`)}</calcite-list>`;
       case "boolean-choice":
         return null;
       case "text-input":
@@ -28,7 +28,7 @@ class o extends l {
     }
   }
   render() {
-    return e`<calcite-panel .description=${this.message}>${this._renderInterruptOptions()}<calcite-button slot=footer-end appearance=outline @click=${() => this.arcgisCancel.emit()}>${this._messages.cancelButtonLabel}</calcite-button><calcite-button slot=footer-end appearance=solid @click=${() => this.arcgisSubmit.emit(this.type === "boolean-choice" ? !0 : this.#t)}>${this._messages.submitButtonLabel}</calcite-button></calcite-panel>`;
+    return e`<calcite-panel .description=${this.message}><div class="interrupt-content">${this._renderInterruptOptions()}</div><calcite-button slot=footer-end appearance=outline @click=${() => this.arcgisCancel.emit()}>${this._messages.cancelButtonLabel}</calcite-button><calcite-button slot=footer-end appearance=solid @click=${() => this.arcgisSubmit.emit(this.type === "boolean-choice" ? !0 : this.#t)}>${this._messages.submitButtonLabel}</calcite-button></calcite-panel>`;
   }
 }
 a("arcgis-assistant-interrupt", o);

package/dist/components/arcgis-assistant-interrupt-preview/customElement.js

@@ -0,0 +1,20 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
+import { c as r } from "../../chunks/runtime.js";
+import { css as l, html as t } from "lit";
+import { LitElement as a } from "@arcgis/lumina";
+const n = l`.interrupt-details ul{margin-block:var(--calcite-spacing-xxs) 0;padding-inline-start:var(--calcite-spacing-xxl)}.interrupt-details li{margin-block:0}.interrupts-container{display:flex;flex-direction:column;gap:var(--calcite-spacing-lg)}`;
+class c extends a {
+  static {
+    this.properties = { interrupts: 0 };
+  }
+  static {
+    this.styles = n;
+  }
+  render() {
+    return this.interrupts?.length ? t`<calcite-block collapsible expanded heading="Assistant Questions"><div class="interrupts-container">${this.interrupts?.map(({ interrupt: s, response: i }) => t`<div class="interrupt-details"><div>Q: ${s.message}</div><ul>${Array.isArray(i) ? i.length ? i.map((e) => t`<li>${e}</li>`) : t`<li>(Question skipped)</li>` : t`<li>${i != null ? String(i) : "(Question skipped)"}</li>`}</ul></div>`)}</div></calcite-block>` : null;
+  }
+}
+r("arcgis-assistant-interrupt-preview", c);
+export {
+  c as ArcgisAssistantInterruptPreview
+};

package/dist/components/arcgis-assistant-interrupt-preview/index.js

@@ -0,0 +1,2 @@
+import "@esri/calcite-components/components/calcite-block";
+export * from "./customElement.js";

package/dist/components/arcgis-assistant-knowledge-agent/customElement.d.ts

@@ -0,0 +1,158 @@
+/// <reference path="../../index.d.ts" />
+import type MapView from "@arcgis/core/views/MapView.js";
+import type LinkChartView from "@arcgis/core/views/LinkChartView.js";
+import type KnowledgeGraph from "@arcgis/core/rest/knowledgeGraph/KnowledgeGraph.js";
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { ArcgisLinkChart as ArcgisLinkChart } from "@arcgis/map-components/components/arcgis-link-chart";
+import type { ArcgisMap as ArcgisMap } from "@arcgis/map-components/components/arcgis-map";
+
+/**
+ * The Knowledge Agent enables the end user to explore knowledge graph data in a [link chart](https://developers.arcgis.com/javascript/latest/references/core/WebLinkChart/), a
+ *  [knowledge graph service](https://developers.arcgis.com/javascript/latest/references/core/rest/knowledgeGraphService/), or a [knowledge graph layer](https://developers.arcgis.com/javascript/latest/references/core/layers/KnowledgeGraphLayer/) in a map via natural language queries. It also provides additional capabilities when used with a knowledge graph layer or link chart. See the list of capabilities below for more details.
+ *
+ * The knowledge agent is designed to answer questions about data in the knowledge graph provided by the knowledge graph layer on map,
+ * a link chart or a knowledge graph service url, and does not have access to external data sources or the user's location.
+ *
+ * It cannot create visualizations in the form of charts, layer renderers, new maps, or other visual outputs.
+ * When provided a link chart as context, it can create new link charts based on queries generated from user prompts.
+ *
+ * This agent can add to the knowledge graph data on a map or link chart if a user prompt generates a query that returns entities
+ * or relationships from the graph and asks for the returned results to be added to the view.
+ * It can also change the layout of a link chart or toggle visibility of non-spatial data on a link chart.
+ * However, it cannot change the symbology of
+ * features or create new layers or export results of a query to a file or external source.
+ *
+ * This is an unrendered component that must be added as a child of the `arcgis-assistant` component in either HTML or JavaScript.
+ *
+ * Link Chart context example:
+ * ```html
+ * <arcgis-link-chart id="my-link-chart"></arcgis-link-chart>
+ * <arcgis-assistant>
+ *   <arcgis-assistant-knowledge-agent reference-element="my-link-chart"></arcgis-assistant-knowledge-agent>
+ * </arcgis-assistant>
+ * ```
+ *
+ * Map context example:
+ * Note: the map must contain one knowledge graph layer.
+ * ```html
+ * <arcgis-map id="my-map"></arcgis-map>
+ * <arcgis-assistant>
+ *   <arcgis-assistant-knowledge-agent reference-element="my-map"></arcgis-assistant-knowledge-agent>
+ * </arcgis-assistant>
+ * ```
+ *
+ * Knowledge Graph Service context example:
+ * ```html
+ * <arcgis-assistant>
+ *   <arcgis-assistant-knowledge-agent
+ *     service-url="https://example.com/server/rest/services/Hosted/myKnowledgeGraph/KnowledgeGraphServer"
+ *   >
+ *   </arcgis-assistant-knowledge-agent>
+ * </arcgis-assistant>
+ * ```
+ *
+ * Once added to the assistant, the agent is loaded and ready to receive user messages directed to their knowledge graph related layers or data.
+ *
+ * ### Capabilities
+ *
+ * The knowledge agent provides the following capabilities related to a knowledge graph or associated knowledge graph layer or link chart layer:
+ *
+ * - **Query** - Ask about the entities and relationships in my graph. This includes questions about connections between entities and
+ * patterns in the graph, as well as questions about the structure of the graph such as the types of entities and relationships and the
+ * number of each type.
+ * Returns the results of the query in text form, and can optionally add returned
+ * entities or relationships to the map or link chart view if the user prompt requests it.
+ * - **Search** - Search for specific entities or relationships in the knowledge graph, or the closest matches based on their properties.
+ * Returns the results of the search in text form, and can optionally add returned entities or relationships to the map or link chart
+ * view if the user prompt requests it.
+ * - **Generate Cypher Query** - Generates and returns a cypher query based on a natural language question and the current knowledge
+ * graph data model,
+ * which can be run against the knowledge graph service.
+ *
+ * Additional capabilities with a map view with a knowledge graph layer or a link chart view
+ *
+ * - **Add entities and relationships** - Add entities or relationships the the knowledge graph or link chart layer based on results returned from searches or queries generated from user prompts.
+ *
+ * Additional capabilities with a link chart view only
+ *
+ * - **Change link chart layout** - Change the layout of the link chart between different modes such as force directed, radial, or hierarchical.
+ * - **Toggle non-spatial visibility** - Show or hide non-spatial entities and relationships on the link chart.
+ * - **Create link chart from query** - Recreate the link chart with new entities and relationships based on a query generated from the
+ * user prompt.
+ *
+ *
+ * ### Example questions
+ *
+ * The following are example questions a user can ask within the bounds of the knowledge agent:
+ *
+ * - "What entities are in this graph, and what is the count of each entity type?"
+ * - "Who are the top 5 entities most connected to Company X?"
+ * - "Find all employees with the last name Smith."
+ * - "What is the most influential company in this graph?"
+ * - "Generate a cypher query to find all employees of Company X that joined the company after 2022 who worked for a competitor before joining Company X."
+ * - "Add all connections between Company X and Company Y to the link chart"
+ * - "Change the layout to hierarchical"
+ * - "Hide non spatial data on the link chart"
+ * - "Create a new link chart with all employees from Company X that joined the company after 2015 and are located in California"
+ *
+ * > Due to the non-deterministic nature of generative AI, there may be inaccuracies or unexpected behavior when using the
+ * out-of-the-box agents.
+ *
+ * @since 5.1
+ * @beta
+ * @see [arcgis-assistant](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/)
+ * @see [Intro to building agentic mapping applications](https://developers.arcgis.com/javascript/latest/agentic-apps/ai-introduction/)
+ * @see [AI Assistant component sample](https://developers.arcgis.com/javascript/latest/sample-code/ai-assistant/)
+ */
+export abstract class ArcgisAssistantKnowledgeAgent extends LitElement {
+  /**
+   * Required and optional context for the knowledge agent. The knowledge agent requires either a link chart view,
+   * a map view with at least one knowledge graph layer, or KnowledgeGraph instance in order to function.
+   *
+   * Depending on the context provided, different capabilities will be available.
+   */
+  accessor context: ArcgisKnowledgeContext | undefined;
+  /**
+   * The reference element to the map that provides context for the navigation agent. Currently,
+   * this is only scoped to `arcgis-map` elements. This shows the navigation agent which map on which to
+   * perform navigation actions. This is required for the navigation agent to function properly.
+   *
+   * Setting this property is not necessary if you set the reference element on the parent
+   * `arcgis-assistant` component.
+   *
+   * @see [arcgis-assistant.referenceElement](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/#referenceElement)
+   * @example
+   * ```html
+   * <arcgis-link-chart id="my-link-chart"></arcgis-link-chart>
+   * <arcgis-assistant>
+   *   <arcgis-assistant-knowledge-agent reference-element="my-link-chart"></arcgis-assistant-knowledge-agent>
+   * </arcgis-assistant>
+   * ```
+   */
+  accessor referenceElement: ArcgisLinkChart | ArcgisMap | string | undefined;
+  /**
+   * The URL of a Knowledge Graph Service. This can be set to use the agent without a map or link chart view.
+   *
+   * If a map or link chart view reference element are provided, this property will be ignored.
+   *
+   * @example
+   * ```html
+   * <arcgis-assistant>
+   *  <arcgis-assistant-knowledge-agent service-url="https://example.esri.com/server/rest/services/Hosted/KGS_Service_Name/KnowledgeGraphServer"></arcgis-assistant-knowledge-agent>
+   * </arcgis-assistant>
+   * ```
+   */
+  accessor serviceUrl: null | undefined | string;
+}
+
+/**
+ * Context required by the Knowledge Link Chart agent.
+ * Supplied by the application via an agent `getContext()` provider.
+ */
+export type ArcgisKnowledgeContext = {
+    knowledgeGraph: KnowledgeGraph;
+    view?: never;
+} | {
+    view: LinkChartView | MapView;
+    knowledgeGraph?: never;
+};

package/dist/components/arcgis-assistant-knowledge-agent/customElement.js

@@ -0,0 +1,68 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
+import { c as r } from "../../chunks/runtime.js";
+import { LitElement as i } from "@arcgis/lumina";
+import "@langchain/langgraph/web";
+import "../../chunks/adapter.js";
+import "@arcgis/core/identity/IdentityManager.js";
+import "@arcgis/core/portal/Portal.js";
+import "../../chunks/generateLayerDescriptions.js";
+import "@langchain/core/messages";
+import "@langchain/core/callbacks/dispatch/web";
+import "@langchain/openai";
+import "@arcgis/core/core/reactiveUtils.js";
+import "@arcgis/core/layers/FeatureLayer.js";
+import "@arcgis/core/request.js";
+import "@langchain/core/prompts";
+import "@langchain/langgraph/prebuilt";
+import "zod";
+import "@arcgis/core/intl.js";
+import "@arcgis/core/smartMapping/statistics/summaryStatistics.js";
+import "@arcgis/core/smartMapping/statistics/uniqueValues.js";
+import { A as o } from "../../chunks/arcgisKnowledgeGraph.js";
+import { b as s, a as n } from "../../chunks/utils2.js";
+import { fetchKnowledgeGraph as a } from "@arcgis/core/rest/knowledgeGraphService.js";
+class c extends i {
+  constructor() {
+    super(...arguments), this.agent = o;
+  }
+  static {
+    this.properties = { referenceElement: 1, serviceUrl: 3, context: 0 };
+  }
+  #e;
+  #r;
+  #t;
+  get serviceUrl() {
+    return this.#r;
+  }
+  set serviceUrl(t) {
+    this.#r = t;
+  }
+  async getContext() {
+    const t = this.context ? { ...this.context, knowledgeGraph: void 0, view: void 0 } : {};
+    if (this.#e)
+      return {
+        ...t,
+        view: this.#e
+      };
+    if (this.#t)
+      try {
+        const e = await this.#t;
+        return { ...t, knowledgeGraph: e };
+      } catch (e) {
+        console.error("Failed to load knowledge graph via service URL:", e);
+      }
+    if (!this.context?.knowledgeGraph && !this.context?.view)
+      throw new Error("arcgis-assistant-knowledge-agent requires either a knowledgeGraph or view in context, and neither were provided");
+    return this.context;
+  }
+  willUpdate(t) {
+    t.has("serviceUrl") && this.serviceUrl ? this.#t = a(this.serviceUrl) : this.#t = void 0;
+  }
+  load() {
+    this.#e = s(this) ?? void 0, n(this);
+  }
+}
+r("arcgis-assistant-knowledge-agent", c);
+export {
+  c as ArcgisAssistantKnowledgeAgent
+};

package/dist/components/arcgis-assistant-layer-styling-agent/customElement.js

@@ -1,11 +1,30 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
 import { c as t } from "../../chunks/runtime.js";
-import { LitElement as s } from "@arcgis/lumina";
-import { LayerStylingAgent as e } from "@arcgis/ai-agents";
-import { r as i, i as r } from "../../chunks/utils.js";
-class a extends s {
+import { LitElement as i } from "@arcgis/lumina";
+import "@langchain/langgraph/web";
+import "../../chunks/adapter.js";
+import "@arcgis/core/identity/IdentityManager.js";
+import "@arcgis/core/portal/Portal.js";
+import "../../chunks/generateLayerDescriptions.js";
+import "@langchain/core/messages";
+import "@langchain/core/callbacks/dispatch/web";
+import "@langchain/openai";
+import "@arcgis/core/core/reactiveUtils.js";
+import "@arcgis/core/layers/FeatureLayer.js";
+import "@arcgis/core/request.js";
+import "@langchain/core/prompts";
+import "@langchain/langgraph/prebuilt";
+import "zod";
+import "@arcgis/core/intl.js";
+import "@arcgis/core/smartMapping/statistics/summaryStatistics.js";
+import "@arcgis/core/smartMapping/statistics/uniqueValues.js";
+import { L as r } from "../../chunks/layerStylingGraph.js";
+import "@arcgis/core/views/LinkChartView.js";
+import "@arcgis/core/rest/knowledgeGraphService.js";
+import { r as s, a as e } from "../../chunks/utils2.js";
+class o extends i {
   constructor() {
-    super(...arguments), this.agent = e;
+    super(...arguments), this.agent = r;
   }
   static {
     this.properties = { referenceElement: 1 };
@@ -17,10 +36,10 @@ class a extends s {
     return { mapView: this.#t };
   }
   load() {
-    this.#t = i(this, "arcgis-assistant-layer-styling-agent"), r(this);
+    this.#t = s(this, "arcgis-assistant-layer-styling-agent"), e(this);
   }
 }
-t("arcgis-assistant-layer-styling-agent", a);
+t("arcgis-assistant-layer-styling-agent", o);
 export {
-  a as ArcgisAssistantLayerStylingAgent
+  o as ArcgisAssistantLayerStylingAgent
 };

package/dist/components/arcgis-assistant-message/customElement.d.ts

@@ -0,0 +1,23 @@
+/// <reference path="../../index.d.ts" />
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { AssistantMessage } from "../arcgis-assistant/types.js";
+
+/**
+ * Renders a single assistant response message shell. Pass one assistant message object and let it host body and footer actions.
+ * Offers a reusable assistant-message layout with icon, content, and footer slot regions.
+ */
+export abstract class ArcgisAssistantMessage extends LitElement {
+  /** @default false */
+  accessor assistantAvatarEnabled: boolean;
+  /** @default false */
+  accessor copyEnabled: boolean;
+  /** @default false */
+  accessor feedbackEnabled: boolean;
+  /** @default false */
+  accessor footerDisabled: boolean;
+  /** @default false */
+  accessor logEnabled: boolean;
+  accessor message: AssistantMessage | undefined;
+  /** @default false */
+  accessor readAloudEnabled: boolean;
+}

package/dist/components/arcgis-assistant-message/customElement.js

@@ -0,0 +1,45 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
+import { c as o } from "../../chunks/runtime.js";
+import { css as l, html as e } from "lit";
+import { LitElement as c, nothing as d } from "@arcgis/lumina";
+import { useSlottableRequest as g } from "@arcgis/lumina/controllers";
+import { g as r } from "../../chunks/slottableRequestUtils.js";
+const m = l`:host{display:block;container-type:inline-size}.container{display:flex;flex-direction:column;align-items:flex-start;gap:var(--calcite-spacing-sm);width:100%;text-align:left}.icon{padding:var(--calcite-spacing-sm);border-radius:var(--calcite-spacing-xl);background:var(--calcite-color-brand);color:var(--calcite-color-foreground-1)}.content-container{display:flex;flex:1;flex-direction:column;width:100%;gap:var(--calcite-spacing-md)}.content,.blocks{display:flex;flex-direction:column;gap:var(--calcite-spacing-sm)}.block-pending{display:flex;justify-content:center;align-items:center;padding:var(--calcite-spacing-sm);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 2s ease-in-out infinite;border-radius:var(--calcite-border-radius);min-height:100px}.message-error{font-style:italic}@container (min-width: 480px){.container{max-width:80%}}@keyframes assistant-message-loading-shimmer{0%{background-position:-150% 0}to{background-position:150% 0}}@media(prefers-reduced-motion){.block-pending{animation:none}}`;
+function b({ message: t }) {
+  const s = /* @__PURE__ */ new Map();
+  return t && t.blocks?.forEach((a, i) => {
+    if (!a.isPending) {
+      const n = r(t.id, i);
+      s.set(n, { data: { block: a, index: i, message: t }, name: "block", slotName: n });
+    }
+  }), s;
+}
+class p extends c {
+  constructor() {
+    super(...arguments), this.arcgisSlottableRequest = g(this, ["message"], b), this.feedbackEnabled = !1, this.logEnabled = !1, this.copyEnabled = !1, this.readAloudEnabled = !1, this.footerDisabled = !1, this.assistantAvatarEnabled = !1;
+  }
+  static {
+    this.properties = { _isStreaming: 16, feedbackEnabled: 5, logEnabled: 5, copyEnabled: 5, readAloudEnabled: 5, footerDisabled: 5, message: 0, assistantAvatarEnabled: 5 };
+  }
+  static {
+    this.styles = m;
+  }
+  get _isStreaming() {
+    return !!this.message?.isStreaming;
+  }
+  _renderContent() {
+    const s = this.message, a = s?.id;
+    if (a)
+      return e`<div class="content"><arcgis-assistant-interrupt-preview .interrupts=${this.message?.interrupts}></arcgis-assistant-interrupt-preview>${s.blocks?.length ? e`<div class="blocks">${s.blocks.map((i, n) => i.isPending && i.type !== "text" ? e`<div class="block-pending"></div>` : e`<slot name=${r(a, n) ?? d}></slot>`)}</div>` : null}</div>`;
+  }
+  _renderFooter() {
+    return e`<arcgis-assistant-message-footer .message=${this.message} .feedbackEnabled=${this.feedbackEnabled} .logEnabled=${this.logEnabled} .copyEnabled=${this.copyEnabled} .readAloudEnabled=${this.readAloudEnabled}></arcgis-assistant-message-footer>`;
+  }
+  render() {
+    return e`<div class="container">${this.assistantAvatarEnabled ? e`<slot name=icon><calcite-icon icon=effects class="icon" scale=s></calcite-icon></slot>` : null}<div class="content-container"><slot name=content>${this._renderContent()}</slot>${this.message?.error ? e`<div class="message-error">${this.message.error}</div>` : null}${this._isStreaming ? e`<div class="streaming-indicator"><calcite-loader label=loading inline></calcite-loader></div>` : null}${!this.footerDisabled && !this._isStreaming ? e`<slot name=footer>${this._renderFooter()}</slot>` : null}</div></div>`;
+  }
+}
+o("arcgis-assistant-message", p);
+export {
+  p as ArcgisAssistantMessage
+};

package/dist/components/arcgis-assistant-message/index.d.ts

@@ -0,0 +1 @@
+export * from "./customElement.js";

package/dist/components/arcgis-assistant-message/index.js

@@ -0,0 +1,5 @@
+import "../arcgis-assistant-interrupt-preview/index.js";
+import "../arcgis-assistant-message-footer/index.js";
+import "@esri/calcite-components/components/calcite-icon";
+import "@esri/calcite-components/components/calcite-loader";
+export * from "./customElement.js";

package/dist/components/arcgis-assistant-message-block/customElement.d.ts

@@ -0,0 +1,8 @@
+/// <reference path="../../index.d.ts" />
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { UXSuggestion } from "../../utils/index.js";
+
+/** Renders one structured assistant block. Offers default block rendering for supported suggestion-style blocks. */
+export abstract class ArcgisAssistantMessageBlock extends LitElement {
+  accessor block: UXSuggestion | undefined;
+}