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

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

@@ -1,14 +1,13 @@
-import "../arcgis-assistant-interrupt/index.js";
 import "@esri/calcite-components/components/calcite-notice";
 import "@esri/calcite-components/components/calcite-link";
-import "../arcgis-assistant-suggested-prompts/index.js";
 import "@esri/calcite-components/components/calcite-panel";
 import "../arcgis-assistant-chat/index.js";
 import "../arcgis-assistant-message/index.js";
-import "../arcgis-assistant-message-text/index.js";
 import "../arcgis-assistant-message-block/index.js";
 import "../arcgis-assistant-user-message/index.js";
 import "../arcgis-assistant-message-loading/index.js";
+import "../arcgis-assistant-interrupt/index.js";
+import "../arcgis-assistant-suggested-prompts/index.js";
 import "../arcgis-assistant-chat-entry/index.js";
 import "@esri/calcite-components/components/calcite-button";
 export * from "./customElement.js";

package/dist/components/arcgis-assistant/types.d.ts

@@ -1,4 +1,4 @@
-import type { UXSuggestion } from "@arcgis/ai-orchestrator";
+import type { UXSuggestion } from "../../utils/index.js";
 
 /** An interrupt is a UI mechanism used by an agent to prompt the user for additional input or clarification. */
 export interface Interrupt {
@@ -51,7 +51,7 @@ export interface AssistantMessage extends ChatMessageBase {
    * UI elements separate from the plain text transcript and can be used to display actions, follow-up prompts,
    * or app-registered custom content.
    */
-  blocks?: UXSuggestion[];
+  blocks?: (UXSuggestion & { isPending?: boolean; })[];
   /**
    * Log messages related to the assistant's processing of the user's request. This can include information about
    * the agents or tools it invoked, the parameters generated by the LLM, and any relevant details about how it
@@ -71,6 +71,19 @@ export interface AssistantMessage extends ChatMessageBase {
    * performance over time.
    */
   feedback?: Feedback;
+  /**
+   * Indicates whether the message content is still being streamed from the assistant. This can be used to show loading
+   * indicators or placeholders in the UI until the full content is received.
+   */
+  isStreaming?: boolean;
+  /**
+   * An array of interrupts emitted by the assistant during the processing of the user's request. Each interrupt includes
+   * details about the type of interrupt, the message to display to the user, and any options for user input.
+   */
+  interrupts?: {
+      interrupt: Interrupt;
+      response?: string[] | boolean | string;
+  }[];
 }
 
 /**

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

@@ -1,6 +1,6 @@
 /// <reference path="../../index.d.ts" />
-import type { AgentRegistration } from "@arcgis/ai-orchestrator";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { AgentRegistration } from "../../utils/index.js";
 
 /**
  * The Assistant Agent component is a generic wrapper for registering custom agents to the [arcgis-assistant](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/) component. To define

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

@@ -1,16 +1,20 @@
 /* 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 { i as e, a as i } from "../../chunks/utils.js";
+import { i as e, a as i } from "../../chunks/utils2.js";
 class n extends s {
   static {
     this.properties = { agent: 0, context: 0 };
   }
+  #t;
   async getContext() {
     return e(this.context) ? await this.context() : this.context;
   }
   load() {
-    i(this);
+    this.#t = i(this);
+  }
+  disconnectedCallback() {
+    this.#t?.unregister(this.agent.id), super.disconnectedCallback();
   }
 }
 t("arcgis-assistant-agent", n);

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

@@ -1,10 +1,16 @@
 /// <reference path="../../index.d.ts" />
 import type Collection from "@arcgis/core/core/Collection.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { ChatMessage } from "../arcgis-assistant/types.js";
+import type { ChatMessage, Interrupt } from "../arcgis-assistant/types.js";
 
-/** @internal */
+/**
+ * Wraps and renders the conversation area. Use it as the container for message list content.
+ * Offers chat-level layout structure for message starter, message list, and loading regions.
+ *
+ * @internal
+ */
 export abstract class ArcgisAssistantChat extends LitElement {
+  accessor interrupt: Interrupt | null;
   /** @default false */
   accessor loading: boolean;
   accessor messages: Collection<ChatMessage>;

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

@@ -2,44 +2,49 @@
 import { c as s } from "../../chunks/runtime.js";
 import { css as e, html as t } from "lit";
 import { LitElement as i } from "@arcgis/lumina";
-import { createRef as a, ref as o } from "lit/directives/ref.js";
-import l from "@arcgis/core/core/Collection.js";
-import { watch as r } from "@arcgis/core/core/reactiveUtils.js";
-const n = e`.messages-container{display:flex;flex:1;flex-direction:column}.messages-list{padding:var(--calcite-spacing-lg);display:flex;flex-direction:column;gap:var(--calcite-spacing-xxl);flex:1 1 auto;min-height:0;justify-content:flex-end;overflow:auto}`;
-class c extends i {
+import { createRef as a, ref as l } from "lit/directives/ref.js";
+import n from "@arcgis/core/core/Collection.js";
+import { when as r, watch as o } from "@arcgis/core/core/reactiveUtils.js";
+const c = e`.messages-container{display:flex;flex:1;flex-direction:column;line-height:var(--calcite-font-line-height-relative-snug)}.messages-list{padding:var(--calcite-spacing-lg);display:flex;flex-direction:column;gap:var(--calcite-spacing-xxl);flex:1 1 auto;min-height:0;justify-content:flex-end;overflow:auto}.end-ref{margin-top:var(--calcite-spacing-lg)}`;
+class m extends i {
   constructor() {
-    super(...arguments), this.#s = a(), this.loading = !1, this.messages = new l([]);
+    super(...arguments), this.#e = a(), this.#s = !1, this.loading = !1, this.messages = new n([]), this.interrupt = null;
   }
   static {
-    this.properties = { loading: 5, messages: 0 };
+    this.properties = { loading: 5, messages: 0, interrupt: 0 };
   }
   static {
-    this.styles = n;
+    this.styles = c;
   }
+  #e;
   #s;
   firstUpdated() {
-    this._scrollToEnd();
+    this.#t();
   }
   loaded() {
     this.manager.onLifecycle(() => [
       this.messages.on("change", () => {
-        this.requestUpdate(), this._scrollToEnd();
+        this.#t();
       }),
-      r(() => this.loading, () => {
-        this._scrollToEnd();
-      })
+      r(() => !this.loading, () => {
+        this.#s = !1;
+      }),
+      o(() => [this.loading, this.interrupt], () => this.#t())
     ]);
   }
-  _scrollToEnd() {
+  #t() {
     requestAnimationFrame(() => {
-      this.#s.value?.scrollIntoView({ behavior: "smooth" });
+      this.#s || this.#e.value?.scrollIntoView({ behavior: "smooth", block: "end" });
     });
   }
+  #i() {
+    this.#s = !0;
+  }
   render() {
-    return t`<div class="messages-container"><div class="messages-list"><slot name=message-starter></slot><slot name=messages></slot><slot name=message-loading></slot></div><div ${o(this.#s)}></div></div>`;
+    return t`<div class="messages-container" @wheel=${this.#i}><div class="messages-list"><slot name=message-starter></slot><slot name=messages></slot><slot name=message-loading></slot></div><div class="end-ref" ${l(this.#e)}></div></div>`;
   }
 }
-s("arcgis-assistant-chat", c);
+s("arcgis-assistant-chat", m);
 export {
-  c as ArcgisAssistantChat
+  m as ArcgisAssistantChat
 };

package/dist/components/arcgis-assistant-chat-entry/customElement.d.ts

@@ -5,7 +5,8 @@ import type { ChatMessage } from "../arcgis-assistant/types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 
 /**
- * An input bar primitive for collecting assistant prompts.
+ * Provides the input bar and submit or cancel behavior. Use it to collect prompts and emit submit events.
+ * Offers keyboard submit/history behavior, entry action slots, and optional voice-input integration.
  *
  * @slot [entry-actions-start] - Slot for adding actions to the start of the entry area.
  * @slot [entry-actions-end] - Slot for adding actions to the end of the entry area.
@@ -15,6 +16,8 @@ export abstract class ArcgisAssistantChatEntry extends LitElement {
   protected _messages: { entryPlaceholder: string; } & T9nMeta<{ entryPlaceholder: string; }>;
   /** @default false */
   accessor awaitingResponse: boolean;
+  /** @default false */
+  accessor disabled: boolean;
   accessor entryPlaceholder: string | undefined;
   /** @default "" */
   accessor inputValue: string;

package/dist/components/arcgis-assistant-chat-entry/customElement.js

@@ -1,27 +1,28 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import { c as p } from "../../chunks/runtime.js";
-import { css as d, html as l } from "lit";
-import { LitElement as g, createEvent as u } from "@arcgis/lumina";
-import { createRef as c, ref as h } from "lit/directives/ref.js";
-import { u as f } from "../../chunks/useT9n.js";
-import m from "@arcgis/core/core/Collection.js";
-const y = d`.input-container{display:flex;flex-direction:column}.footer-start{display:flex;gap:var(--calcite-spacing-md);flex-wrap:wrap;align-items:center}.footer-end{display:flex;gap:var(--calcite-spacing-md);align-items:center}.status-indicator{width:9px;height:9px;border-radius:100%;background-color:var(--calcite-color-status-success)}.status-indicator[data-status=working]{background-color:var(--calcite-color-status-warning)}.status-indicator[data-status=error]{background-color:var(--calcite-color-status-danger)}.status-text{text-transform:capitalize}`;
-class v extends g {
+import { c as d } from "../../chunks/runtime.js";
+import { css as p, html as c } from "lit";
+import { LitElement as f, createEvent as l, safeClassMap as g } from "@arcgis/lumina";
+import { createRef as u, ref as h } from "lit/directives/ref.js";
+import { u as m } from "../../chunks/useT9n.js";
+import y from "@arcgis/core/core/Collection.js";
+import { classes as v } from "@arcgis/toolkit/dom";
+const b = p`:host{--calcite-text-area-border-color: var(--calcite-color-border-1);--calcite-text-area-divider-color: var(--calcite-color-border-1);--calcite-text-area-corner-radius: var(--calcite-border-radius)}.input-container{display:flex;flex-direction:column}.footer-start{display:flex;gap:var(--calcite-spacing-md);flex-wrap:wrap;align-items:center}.footer-end{display:flex;gap:var(--calcite-spacing-md);align-items:center}.status-indicator{width:9px;height:9px;border-radius:100%;background-color:var(--calcite-color-status-success)}.status-indicator[data-status=working]{background-color:var(--calcite-color-status-warning)}.status-indicator[data-status=error]{background-color:var(--calcite-color-status-danger)}.status-text{text-transform:capitalize}.focused{--calcite-text-area-shadow: var(--calcite-shadow-sm)}`;
+class w extends f {
   constructor() {
-    super(...arguments), this.#s = c(), this.#i = c(), this.#t = -1, this.#e = "", this.#a = (t) => {
+    super(...arguments), this.#s = u(), this.#i = u(), this.#t = -1, this.#e = "", this.#a = (t) => {
       t.stopPropagation();
       const s = t.detail;
       this._setDraftValue(s.value), s.focusInput && this.#s.value && this.#s.value.setFocus();
     }, this.#r = (t) => {
       const s = t.target.value ?? "";
       this.inputValue = s, this.#e = s;
-    }, this._messages = f({ blocking: !0 }), this.keyboardShortcutsDisabled = !1, this.awaitingResponse = !1, this.inputValue = "", this.voiceInputEnabled = !1, this.messages = new m([]), this.arcgisCancel = u(), this.arcgisSubmit = u();
+    }, this._messages = m({ blocking: !0 }), this._inFocus = !1, this.keyboardShortcutsDisabled = !1, this.awaitingResponse = !1, this.inputValue = "", this.voiceInputEnabled = !1, this.messages = new y([]), this.disabled = !1, this.arcgisCancel = l(), this.arcgisSubmit = l();
   }
   static {
-    this.properties = { _userMessages: 16, keyboardShortcutsDisabled: 5, entryPlaceholder: 1, awaitingResponse: 5, inputValue: 1, status: 1, voiceInputEnabled: 5, messages: 0 };
+    this.properties = { _inFocus: 16, _userMessages: 16, keyboardShortcutsDisabled: 5, entryPlaceholder: 1, awaitingResponse: 5, inputValue: 1, status: 1, voiceInputEnabled: 5, messages: 0, disabled: 5 };
   }
   static {
-    this.styles = y;
+    this.styles = b;
   }
   #s;
   #i;
@@ -54,8 +55,8 @@ class v extends g {
     const e = this._userMessages;
     if (e.length === 0)
       return;
-    const r = a.value ?? "", n = a.shadowRoot?.querySelector("textarea"), i = n?.selectionStart, o = n?.selectionEnd;
-    if (!(i == null || o == null) && !(i !== o || t === "up" && i !== 0 || t === "down" && i !== r.length)) {
+    const r = a.value ?? "", o = a.shadowRoot?.querySelector("textarea"), i = o?.selectionStart, n = o?.selectionEnd;
+    if (!(i == null || n == null) && !(i !== n || t === "up" && i !== 0 || t === "down" && i !== r.length)) {
       if (t === "up") {
         this.#t === -1 ? (this.#e = r, this.#t = e.length - 1) : this.#t = Math.max(0, this.#t - 1), this.inputValue = e[this.#t] ?? "", s.preventDefault();
         return;
@@ -66,13 +67,19 @@ class v extends g {
   _setDraftValue(t) {
     this.inputValue = t, this.#t = -1, this.#e = t;
   }
+  _onFocusIn() {
+    this._inFocus = !0;
+  }
+  _onFocusOut() {
+    this._inFocus = !1;
+  }
   render() {
-    return l`<div class="input-container"><calcite-text-area .value=${this.inputValue} .placeholder=${this.entryPlaceholder ?? this._messages.entryPlaceholder} resize=vertical @calciteTextAreaInput=${this.#r} @keydown=${async (t) => {
+    return c`<div class="input-container"><calcite-text-area class=${g(v({ focused: this._inFocus }))} .value=${this.inputValue} .placeholder=${this.entryPlaceholder ?? this._messages.entryPlaceholder} resize=vertical @calciteTextAreaInput=${this.#r} .disabled=${this.disabled} @keydown=${async (t) => {
       t.altKey || t.ctrlKey || t.metaKey || t.shiftKey || this.keyboardShortcutsDisabled || (t.key === "Enter" ? (t.preventDefault(), await this.submitMessage()) : t.key === "ArrowUp" ? await this._navigateHistory("up", t) : t.key === "ArrowDown" && await this._navigateHistory("down", t));
-    }} ${h(this.#s)}><div slot=footer-start class="footer-start"><slot name=entry-actions-start></slot></div><div slot=footer-end class="footer-end">${this.voiceInputEnabled ? l`<arcgis-assistant-speech-input .awaitingResponse=${this.awaitingResponse} .inputValue=${this.inputValue} ${h(this.#i)}></arcgis-assistant-speech-input>` : null}<slot name=entry-actions-end></slot></div></calcite-text-area></div>`;
+    }} @focusin=${this._onFocusIn} @focusout=${this._onFocusOut} ${h(this.#s)}><div slot=footer-start class="footer-start"><slot name=entry-actions-start></slot></div><div slot=footer-end class="footer-end">${this.voiceInputEnabled ? c`<arcgis-assistant-speech-input .awaitingResponse=${this.awaitingResponse} .inputValue=${this.inputValue} ${h(this.#i)}></arcgis-assistant-speech-input>` : null}<slot name=entry-actions-end></slot></div></calcite-text-area></div>`;
   }
 }
-p("arcgis-assistant-chat-entry", v);
+d("arcgis-assistant-chat-entry", w);
 export {
-  v as ArcgisAssistantChatEntry
+  w as ArcgisAssistantChatEntry
 };

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

@@ -1,26 +1,48 @@
 /* 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, a as 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 "@arcgis/toolkit/string";
+import "../../chunks/generateLayerDescriptions.js";
+import "@langchain/core/messages";
+import "@langchain/core/callbacks/dispatch/web";
+import "@langchain/openai";
+import "@arcgis/core/config.js";
+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 s } from "../../chunks/utils2.js";
+class e extends i {
   constructor() {
-    super(...arguments), this.agent = e;
+    super(...arguments), this.agent = r;
   }
   static {
     this.properties = { referenceElement: 1 };
   }
   #t;
+  #i;
   getContext() {
     if (!this.#t)
       throw new Error("arcgis-assistant-data-exploration-agent requires a mapView");
     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"), this.#i = s(this);
+  }
+  disconnectedCallback() {
+    this.#i?.unregister(this.agent.id), super.disconnectedCallback();
   }
 }
-t("arcgis-assistant-data-exploration-agent", r);
+t("arcgis-assistant-data-exploration-agent", e);
 export {
-  r as ArcgisAssistantDataExplorationAgent
+  e as ArcgisAssistantDataExplorationAgent
 };

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

@@ -1,26 +1,51 @@
 /* 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, a 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 "@arcgis/toolkit/string";
+import "../../chunks/generateLayerDescriptions.js";
+import "@langchain/core/messages";
+import "@langchain/core/callbacks/dispatch/web";
+import "@langchain/openai";
+import "@arcgis/core/config.js";
+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 s, a as e } from "../../chunks/utils2.js";
+class o extends i {
   constructor() {
-    super(...arguments), this.agent = s;
+    super(...arguments), this.agent = r;
   }
   static {
     this.properties = { referenceElement: 1 };
   }
   #t;
+  #i;
   getContext() {
     if (!this.#t)
       throw new Error("arcgis-assistant-help-agent requires a mapView");
     return { mapView: this.#t };
   }
   load() {
-    this.#t = i(this, "arcgis-assistant-help-agent"), r(this);
+    this.#t = s(this, "arcgis-assistant-help-agent"), this.#i = e(this);
+  }
+  disconnectedCallback() {
+    this.#i?.unregister(this.agent.id), super.disconnectedCallback();
   }
 }
-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

@@ -2,17 +2,17 @@
 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 { u as r } from "../../chunks/useT9n.js";
+const n = c`:host{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 = s(), this.arcgisSubmit = s();
   }
   static {
     this.properties = { type: 1, message: 1, options: 0 };
   }
   static {
-    this.styles = r;
+    this.styles = n;
   }
   #t;
   _renderInterruptOptions() {
@@ -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 {
+  /**
+   * Optional context for the knowledge agent. If the agent does not have a view or kg service url provided via reference element or serviceUrl property
+   * a knowledge graph can be provided directly via context to enable Knowledge Service related capabilties.
+   *
+   * Depending on the context provided, different capabilities will be available.
+   */
+  accessor context: ArcgisKnowledgeAssistantContext | 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 ArcgisKnowledgeAssistantContext = {
+    view: LinkChartView | MapView;
+    knowledgeGraph?: never;
+} | {
+    knowledgeGraph: KnowledgeGraph;
+    view?: never;
+};