@arcgis/ai-components 5.2.0-next.3 → 5.2.0-next.30

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

@@ -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.js

@@ -6,11 +6,15 @@ 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.2/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

@@ -5,10 +5,12 @@ 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";
@@ -18,8 +20,8 @@ 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 {
+import { r as a, a as s } from "../../chunks/utils2.js";
+class e extends i {
   constructor() {
     super(...arguments), this.agent = r;
   }
@@ -27,16 +29,20 @@ class s extends i {
     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 = a(this, "arcgis-assistant-data-exploration-agent"), o(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", s);
+t("arcgis-assistant-data-exploration-agent", e);
 export {
-  s as ArcgisAssistantDataExplorationAgent
+  e as ArcgisAssistantDataExplorationAgent
 };

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

@@ -5,10 +5,12 @@ 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";
@@ -21,7 +23,7 @@ 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";
+import { r as s, a as e } from "../../chunks/utils2.js";
 class o extends i {
   constructor() {
     super(...arguments), this.agent = r;
@@ -30,13 +32,17 @@ class o extends i {
     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 = e(this, "arcgis-assistant-help-agent"), s(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", o);

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,15 +1,19 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { c as a } from "../../chunks/runtime.js";
-import { html as e } from "lit";
-import { LitElement as c, createEvent as s } from "@arcgis/lumina";
-import { u as l } from "../../chunks/useT9n.js";
-class n extends c {
+import { css as c, html as e } from "lit";
+import { LitElement as l, createEvent as s } from "@arcgis/lumina";
+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 = l({ 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 = n;
+  }
   #t;
   _renderInterruptOptions() {
     switch (this.type) {
@@ -24,10 +28,10 @@ class n extends c {
     }
   }
   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", n);
+a("arcgis-assistant-interrupt", o);
 export {
-  n as ArcgisAssistantInterrupt
+  o as ArcgisAssistantInterrupt
 };

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

@@ -0,0 +1,20 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/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

@@ -106,12 +106,12 @@ import type { ArcgisMap as ArcgisMap } from "@arcgis/map-components/components/a
  */
 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.
+   * 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: ArcgisKnowledgeContext | undefined;
+  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
@@ -149,10 +149,10 @@ export abstract class ArcgisAssistantKnowledgeAgent extends LitElement {
  * Context required by the Knowledge Link Chart agent.
  * Supplied by the application via an agent `getContext()` provider.
  */
-export type ArcgisKnowledgeContext = {
-    knowledgeGraph: KnowledgeGraph;
-    view?: never;
-} | {
+export type ArcgisKnowledgeAssistantContext = {
     view: LinkChartView | MapView;
     knowledgeGraph?: never;
+} | {
+    knowledgeGraph: KnowledgeGraph;
+    view?: never;
 };

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

@@ -1,14 +1,16 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { c as r } from "../../chunks/runtime.js";
-import { LitElement as i } from "@arcgis/lumina";
+import { c as i } from "../../chunks/runtime.js";
+import { LitElement as r } 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";
@@ -18,24 +20,25 @@ 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 { A as s } from "../../chunks/arcgisKnowledgeGraph.js";
+import { b as o, a as n } from "../../chunks/utils2.js";
 import { fetchKnowledgeGraph as a } from "@arcgis/core/rest/knowledgeGraphService.js";
-class c extends i {
+class c extends r {
   constructor() {
-    super(...arguments), this.agent = o;
+    super(...arguments), this.agent = s;
   }
   static {
     this.properties = { referenceElement: 1, serviceUrl: 3, context: 0 };
   }
   #e;
-  #r;
+  #i;
   #t;
+  #r;
   get serviceUrl() {
-    return this.#r;
+    return this.#i;
   }
   set serviceUrl(t) {
-    this.#r = t;
+    this.#i = t;
   }
   async getContext() {
     const t = this.context ? { ...this.context, knowledgeGraph: void 0, view: void 0 } : {};
@@ -59,10 +62,13 @@ class c extends i {
     t.has("serviceUrl") && this.serviceUrl ? this.#t = a(this.serviceUrl) : this.#t = void 0;
   }
   load() {
-    this.#e = s(this) ?? void 0, n(this);
+    this.#e = o(this) ?? void 0, this.#r = n(this);
+  }
+  disconnectedCallback() {
+    this.#r?.unregister(this.agent.id), super.disconnectedCallback();
   }
 }
-r("arcgis-assistant-knowledge-agent", c);
+i("arcgis-assistant-knowledge-agent", c);
 export {
   c as ArcgisAssistantKnowledgeAgent
 };

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

@@ -5,10 +5,12 @@ 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";
@@ -22,7 +24,7 @@ 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 {
+class a extends i {
   constructor() {
     super(...arguments), this.agent = r;
   }
@@ -30,16 +32,20 @@ class o extends i {
     this.properties = { referenceElement: 1 };
   }
   #t;
+  #i;
   getContext() {
     if (!this.#t)
       throw new Error("arcgis-assistant-layer-styling-agent requires a mapView");
     return { mapView: this.#t };
   }
   load() {
-    this.#t = s(this, "arcgis-assistant-layer-styling-agent"), e(this);
+    this.#t = s(this, "arcgis-assistant-layer-styling-agent"), this.#i = e(this);
+  }
+  disconnectedCallback() {
+    this.#i?.unregister(this.agent.id), super.disconnectedCallback();
   }
 }
-t("arcgis-assistant-layer-styling-agent", o);
+t("arcgis-assistant-layer-styling-agent", a);
 export {
-  o as ArcgisAssistantLayerStylingAgent
+  a 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;
+}