@arcgis/ai-components 5.2.0-next.1 → 5.2.0-next.100

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

@@ -0,0 +1,26 @@
+/// <reference path="../../index.d.ts" />
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { AssistantMessage } from "../arcgis-assistant/types.js";
+import type { T9nMeta } from "@arcgis/lumina/controllers";
+
+/**
+ * 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 {
+  /** @internal */
+  protected _messages: { loadingLabel: string; } & T9nMeta<{ loadingLabel: string; }>;
+  /** @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

@@ -1,43 +1,46 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { c as d } from "../../chunks/runtime.js";
-import { css as m, html as a } from "lit";
-import { LitElement as g, nothing as i } from "@arcgis/lumina";
-import { useSlottableRequest as b } from "@arcgis/lumina/controllers";
-import { g as c, a as r } from "../../chunks/slottableRequestUtils.js";
-const f = m`: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)}@container (min-width: 480px){.container{max-width:80%}}`;
-function p({ message: t }) {
-  const e = /* @__PURE__ */ new Map();
-  if (!t)
-    return e;
-  const s = c(t.id);
-  return e.set(s, { data: { message: t }, name: "message", slotName: s }), t.blocks?.forEach((l, o) => {
-    const n = r(t.id, o);
-    e.set(n, { data: { block: l, index: o, message: t }, name: "block", slotName: n });
-  }), e;
+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 { u as g } from "../../chunks/useT9n.js";
+import { useSlottableRequest as m } from "@arcgis/lumina/controllers";
+import { g as r } from "../../chunks/slottableRequestUtils.js";
+const p = 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%;min-width:0;gap:var(--calcite-spacing-md)}.content{display:flex;flex-direction:column;min-width:0;gap:var(--calcite-spacing-sm)}.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 h extends g {
+class u extends c {
   constructor() {
-    super(...arguments), this.arcgisSlottableRequest = b(this, ["message"], p), this.feedbackEnabled = !1, this.logEnabled = !1, this.copyEnabled = !1, this.readAloudEnabled = !1, this.footerDisabled = !1;
+    super(...arguments), this._messages = g({ blocking: !0 }), this.arcgisSlottableRequest = m(this, ["message"], b), this.feedbackEnabled = !1, this.logEnabled = !1, this.copyEnabled = !1, this.readAloudEnabled = !1, this.footerDisabled = !1, this.assistantAvatarEnabled = !1;
   }
   static {
-    this.properties = { feedbackEnabled: 5, logEnabled: 5, copyEnabled: 5, readAloudEnabled: 5, footerDisabled: 5, message: 0 };
+    this.properties = { _isStreaming: 16, feedbackEnabled: 5, logEnabled: 5, copyEnabled: 5, readAloudEnabled: 5, footerDisabled: 5, message: 0, assistantAvatarEnabled: 5 };
   }
   static {
-    this.styles = f;
+    this.styles = p;
+  }
+  get _isStreaming() {
+    return !!this.message?.isStreaming;
   }
   _renderContent() {
-    const e = this.message, s = e?.id;
-    if (s)
-      return a`<div class="content"><slot name=${c(s) ?? i}></slot>${e.blocks?.length ? a`<div class="blocks">${e.blocks.map((l, o) => a`<slot name=${r(s, o) ?? i}></slot>`)}</div>` : null}</div>`;
+    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 a`<arcgis-assistant-message-footer .message=${this.message} .feedbackEnabled=${this.feedbackEnabled} .logEnabled=${this.logEnabled} .copyEnabled=${this.copyEnabled} .readAloudEnabled=${this.readAloudEnabled}></arcgis-assistant-message-footer>`;
+    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 a`<div class="container"><slot name=icon><calcite-icon icon=effects class="icon" scale=s></calcite-icon></slot><div class="content-container"><slot name=content>${this._renderContent()}</slot>${this.footerDisabled ? null : a`<slot name=footer>${this._renderFooter()}</slot>`}</div></div>`;
+    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=${this._messages.loadingLabel} inline></calcite-loader></div>` : null}${!this.footerDisabled && !this._isStreaming ? e`<slot name=footer>${this._renderFooter()}</slot>` : null}</div></div>`;
   }
 }
-d("arcgis-assistant-message", h);
+o("arcgis-assistant-message", u);
 export {
-  h as ArcgisAssistantMessage
+  u 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

@@ -1,3 +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

@@ -2,7 +2,7 @@
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { UXSuggestion } from "../../utils/index.js";
 
-/** A primitive for rendering a default assistant output block. */
+/** Renders one structured assistant block. Offers default block rendering for supported suggestion-style blocks. */
 export abstract class ArcgisAssistantMessageBlock extends LitElement {
   accessor block: UXSuggestion | undefined;
 }

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

@@ -1,29 +1,36 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { c as o } from "../../chunks/runtime.js";
-import { css as i, html as p } from "lit";
-import { LitElement as n } from "@arcgis/lumina";
-const l = i`:host{display:block}`;
-class a extends n {
+import { c as n } from "../../chunks/runtime.js";
+import { css as i, html as r } from "lit";
+import { LitElement as o } from "@arcgis/lumina";
+const p = i`:host{display:block}`;
+class c extends o {
   static {
     this.properties = { block: 0 };
   }
   static {
-    this.styles = l;
+    this.styles = p;
   }
   _renderSuggestedPrompts(s) {
     if (s.type !== "suggested-prompts")
       return null;
-    const t = s.data?.prompts, e = Array.isArray(t) ? t.filter((r) => typeof r == "string") : [];
-    return e.length ? p`<arcgis-assistant-suggested-prompts .prompts=${e}></arcgis-assistant-suggested-prompts>` : null;
+    const t = s.data?.prompts, e = Array.isArray(t) ? t.filter((a) => typeof a == "string") : [];
+    return e.length ? r`<arcgis-assistant-suggested-prompts .prompts=${e}></arcgis-assistant-suggested-prompts>` : null;
   }
   _renderBlock(s) {
-    return s.type === "suggested-prompts" ? this._renderSuggestedPrompts(s) : null;
+    switch (s.type) {
+      case "suggested-prompts":
+        return this._renderSuggestedPrompts(s);
+      case "text":
+        return r`<arcgis-assistant-message-text .content=${s.data?.content} .parts=${s.data?.parts}></arcgis-assistant-message-text>`;
+      default:
+        return null;
+    }
   }
   render() {
     return this.block ? this._renderBlock(this.block) : null;
   }
 }
-o("arcgis-assistant-message-block", a);
+n("arcgis-assistant-message-block", c);
 export {
-  a as ArcgisAssistantMessageBlock
+  c as ArcgisAssistantMessageBlock
 };

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

@@ -1,2 +1,3 @@
 import "../arcgis-assistant-suggested-prompts/index.js";
+import "../arcgis-assistant-message-text/index.js";
 export * from "./customElement.js";

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

@@ -3,7 +3,10 @@ import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { AssistantMessage } from "../arcgis-assistant/types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 
-/** @internal */
+/**
+ * Handles thumbs up or down feedback UI. Use it to capture helpful or not helpful signals per response.
+ * Offers feedback toggle behavior and emits feedback updates for the associated assistant message.
+ */
 export abstract class ArcgisAssistantMessageFeedback extends LitElement {
   /** @internal */
   protected _messages: {

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

@@ -3,7 +3,10 @@ import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { AssistantMessage } from "../arcgis-assistant/types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 
-/** @internal */
+/**
+ * Renders the action row under an assistant message. Use it when you want feedback, log, copy, or read-aloud controls.
+ * Offers one footer surface that composes common assistant response actions.
+ */
 export abstract class ArcgisAssistantMessageFooter extends LitElement {
   /** @internal */
   protected _messages: {

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

@@ -1,8 +1,18 @@
 /// <reference path="../../index.d.ts" />
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { AssistantMessage } from "../arcgis-assistant/types.js";
+import type { T9nMeta } from "@arcgis/lumina/controllers";
 
-/** @internal */
+/**
+ * Shows in-progress assistant response UI. Use it to display thinking or loading state while work is running.
+ * Offers a default loading message shell with icon/content slot overrides.
+ */
 export abstract class ArcgisAssistantMessageLoading extends LitElement {
+  /** @internal */
+  protected _messages: { loadingLabel: string; } & T9nMeta<{ loadingLabel: string; }>;
+  /** @default false */
+  accessor assistantAvatarEnabled: boolean;
+  accessor interrupts: AssistantMessage["interrupts"] | undefined;
   /** @default false */
   accessor loading: boolean;
   /** @default "" */

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

@@ -1,20 +1,21 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { c as a } from "../../chunks/runtime.js";
 import { css as e, html as s } from "lit";
-import { LitElement as i } from "@arcgis/lumina";
-const t = e`:host{display:contents}.icon{padding:var(--calcite-spacing-sm);border-radius:var(--calcite-spacing-xl);background:var(--calcite-color-brand);color:var(--calcite-color-foreground-1)}.loading-container{display:flex;flex-direction:column;gap:var(--calcite-spacing-sm);padding:0 var(--calcite-spacing-sm)}.loading{display:flex;align-items:center;gap:var(--calcite-spacing-sm)}.text{font-style:italic;word-wrap:break-word;word-break:break-all;overflow:hidden;text-overflow:ellipsis;display:-webkit-box;-webkit-line-clamp:1;line-clamp:1;-webkit-box-orient:vertical}.skeleton-block{display:flex;flex-direction:column;gap:var(--calcite-spacing-sm);width:100%}.skeleton-text{display:block;height:.95em;border-radius:var(--calcite-border-radius);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 1.2s ease-in-out infinite;width:85%}.skeleton-text:last-child{width:70%}@keyframes assistant-message-loading-shimmer{0%{background-position:-150% 0}to{background-position:150% 0}}@media(prefers-reduced-motion){.skeleton-text{animation:none}}`;
-class o extends i {
+import { LitElement as t } from "@arcgis/lumina";
+import { u as i } from "../../chunks/useT9n.js";
+const n = e`:host{display:contents}.icon{padding:var(--calcite-spacing-sm);border-radius:var(--calcite-spacing-xl);background:var(--calcite-color-brand);color:var(--calcite-color-foreground-1)}.loading-container{display:flex;flex-direction:column;gap:var(--calcite-spacing-sm);padding:0 var(--calcite-spacing-sm)}.loading{display:flex;align-items:center;gap:var(--calcite-spacing-sm)}.text{font-style:italic;word-wrap:break-word;word-break:break-all;overflow:hidden;text-overflow:ellipsis;display:-webkit-box;-webkit-line-clamp:1;line-clamp:1;-webkit-box-orient:vertical}.skeleton-block{display:flex;flex-direction:column;gap:var(--calcite-spacing-sm);width:100%}.skeleton-text{display:block;height:.95em;border-radius:var(--calcite-border-radius);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 1.2s ease-in-out infinite;width:85%}.skeleton-text:last-child{width:70%}@keyframes assistant-message-loading-shimmer{0%{background-position:-150% 0}to{background-position:150% 0}}@media(prefers-reduced-motion){.skeleton-text{animation:none}}`;
+class o extends t {
   constructor() {
-    super(...arguments), this.loading = !1, this.loadingMessage = "";
+    super(...arguments), this._messages = i({ blocking: !0 }), this.loading = !1, this.loadingMessage = "", this.assistantAvatarEnabled = !1;
   }
   static {
-    this.properties = { loading: 5, loadingMessage: 1 };
+    this.properties = { loading: 5, loadingMessage: 1, assistantAvatarEnabled: 5, interrupts: 0 };
   }
   static {
-    this.styles = t;
+    this.styles = n;
   }
   render() {
-    return this.loading ? s`<arcgis-assistant-message footer-disabled><slot name=icon slot=icon><calcite-icon class="icon" icon=effects scale=s></calcite-icon></slot><slot name=content slot=content><div class="loading-container"><div class="loading"><calcite-loader label=loading inline></calcite-loader><div class="text">${this.loadingMessage}</div></div><div class="skeleton-block"><span class="skeleton-text"></span><span class="skeleton-text"></span></div></div></slot></arcgis-assistant-message>` : null;
+    return this.loading ? s`<arcgis-assistant-message .assistantAvatarEnabled=${this.assistantAvatarEnabled} footer-disabled>${this.assistantAvatarEnabled ? s`<slot name=icon slot=icon><calcite-icon class="icon" icon=effects scale=s></calcite-icon></slot>` : null}<slot name=content slot=content><arcgis-assistant-interrupt-preview .interrupts=${this.interrupts}></arcgis-assistant-interrupt-preview><div class="loading-container"><div class="loading"><calcite-loader .label=${this._messages.loadingLabel} inline></calcite-loader><div class="text">${this.loadingMessage}</div></div><div class="skeleton-block"><span class="skeleton-text"></span><span class="skeleton-text"></span></div></div></slot></arcgis-assistant-message>` : null;
   }
 }
 a("arcgis-assistant-message-loading", o);

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

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

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

@@ -1,7 +1,10 @@
 /// <reference path="../../index.d.ts" />
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 
-/** @internal */
+/**
+ * Renders expandable execution log details. Use it when exposing agent or tool trace output.
+ * Offers collapsible log entry rendering for debugging and troubleshooting.
+ */
 export abstract class ArcgisAssistantMessageLog extends LitElement {
   accessor log: string[] | undefined;
   /** @default false */

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

@@ -3,7 +3,10 @@ import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { AssistantMessage } from "../arcgis-assistant/types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 
-/** @internal */
+/**
+ * Adds text-to-speech playback controls. Use it to read assistant responses aloud.
+ * Offers read-aloud start/stop behavior with supported-state handling.
+ */
 export abstract class ArcgisAssistantMessageReadAloud extends LitElement {
   /** @internal */
   protected _messages: {

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

@@ -1,7 +1,11 @@
 /// <reference path="../../index.d.ts" />
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 
-/** @internal */
+/**
+ * Renders assistant message text content. Use it when the block is plain text output.
+ * Offers sanitized rich-text rendering for assistant-generated message content.
+ */
 export abstract class ArcgisAssistantMessageText extends LitElement {
   accessor content: string | undefined;
+  accessor parts: string[] | undefined;
 }

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

@@ -1,22 +1,22 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { c as t } from "../../chunks/runtime.js";
-import { css as e, html as c } from "lit";
-import { LitElement as a } from "@arcgis/lumina";
-import { unsafeHTML as o } from "lit/directives/unsafe-html.js";
-import { p as r } from "../../chunks/converterUtils.js";
-const i = e`.container{color:var(--calcite-color-text-1)}.content>*{margin:0}.content>*+*{margin-block-start:var(--calcite-spacing-sm)}.content :is(ol,ul){padding-inline-start:var(--calcite-spacing-lg)}.content>calcite-table{display:block;max-width:100%}.content pre{background-color:var(--calcite-color-foreground-1);padding:var(--calcite-spacing-sm);border-radius:var(--calcite-border-radius);color:var(--calcite-color-text-1);direction:ltr;max-width:100%;overflow:auto}.content pre code{display:block;white-space:pre;font-family:var(--calcite-code-family)}`;
-class s extends a {
+import { c as r } from "../../chunks/runtime.js";
+import { css as i, html as t } from "lit";
+import { LitElement as c } from "@arcgis/lumina";
+import { unsafeHTML as a } from "lit/directives/unsafe-html.js";
+import { a as n, p as o } from "../../chunks/converterUtils.js";
+const s = i`.container{color:var(--calcite-color-text-1);min-width:0}.content{min-width:0;overflow-wrap:anywhere}.content>*{margin:0}.content>*+*{margin-block-start:var(--calcite-spacing-sm)}.content :is(ol,ul){padding-inline-start:var(--calcite-spacing-lg)}.content>calcite-table{display:block;max-width:100%}.content pre{background-color:var(--calcite-color-foreground-1);padding:var(--calcite-spacing-sm);border-radius:var(--calcite-border-radius);color:var(--calcite-color-text-1);direction:ltr;max-width:100%;overflow:auto}.content pre code{display:block;white-space:pre;font-family:var(--calcite-code-family)}.part{animation:part-reveal calc(3 * var(--calcite-animation-timing)) ease-out}@keyframes part-reveal{0%{opacity:0;transform:translateY(var(--calcite-size-fixed-xxs))}to{opacity:1;transform:translateY(0)}}@media(prefers-reduced-motion:reduce){.part{animation:none}}`;
+class l extends c {
   static {
-    this.properties = { content: 1 };
+    this.properties = { content: 1, parts: 0 };
   }
   static {
-    this.styles = i;
+    this.styles = s;
   }
   render() {
-    return c`<div class="container"><div class="content">${o(r(this.content))}</div></div>`;
+    return t`<div class="container"><div class="content">${this.parts?.map((e) => t`<span class="part">${a(n(e))}</span>`) ?? a(o(this.content))}</div></div>`;
   }
 }
-t("arcgis-assistant-message-text", s);
+r("arcgis-assistant-message-text", l);
 export {
-  s as ArcgisAssistantMessageText
+  l as ArcgisAssistantMessageText
 };

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

@@ -6,21 +6,31 @@ import "@langchain/langgraph/web";
 import "../../chunks/adapter.js";
 import "@arcgis/core/identity/IdentityManager.js";
 import "@arcgis/core/portal/Portal.js";
+import "@arcgis/core/request.js";
+import "@arcgis/toolkit/string";
 import "../../chunks/generateLayerDescriptions.js";
 import "@langchain/core/messages";
 import "@langchain/core/callbacks/dispatch/web";
+import "@langchain/core/callbacks/base";
 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 "../../agents/tools/filter/clearFilters/adapter.js";
+import "../../agents/tools/filter/resetMap/adapter.js";
+import "../../agents/tools/filter/setFeatureEffect/adapter.js";
+import "../../agents/tools/query/getAttribute/adapter.js";
+import "../../agents/tools/query/getStatistics/adapter.js";
+import "../../agents/tools/query/getTopFeatures/adapter.js";
+import "../../agents/tools/query/queryFeatures/adapter.js";
 import "@arcgis/core/intl.js";
 import "@langchain/langgraph/prebuilt";
 import "@arcgis/core/smartMapping/statistics/summaryStatistics.js";
 import "@arcgis/core/smartMapping/statistics/uniqueValues.js";
-import "@arcgis/core/views/LinkChartView.js";
+import "../../agents/tools/help/listFields/adapter.js";
 import "@arcgis/core/rest/knowledgeGraphService.js";
-import { r as o, a as s } from "../../chunks/utils2.js";
+import { r as o, i as s } from "../../chunks/utils2.js";
 class a extends i {
   constructor() {
     super(...arguments), this.agent = r;
@@ -29,13 +39,17 @@ class a extends i {
     this.properties = { referenceElement: 1 };
   }
   #t;
+  #i;
   getContext() {
     if (!this.#t)
       throw new Error("arcgis-assistant-navigation-agent requires a mapView");
     return { mapView: this.#t };
   }
   load() {
-    this.#t = o(this, "arcgis-assistant-navigation-agent"), s(this);
+    this.#t = o(this, "arcgis-assistant-navigation-agent"), this.#i = s(this);
+  }
+  disconnectedCallback() {
+    this.#i?.unregister(this.agent.id), super.disconnectedCallback();
   }
 }
 t("arcgis-assistant-navigation-agent", a);

package/dist/components/arcgis-assistant-speech-input/customElement.d.ts

@@ -2,7 +2,12 @@
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { VoiceInputDraftChangeDetail, VoiceInputErrorCode, VoiceInputMode, VoiceInputTranscriptDetail, VoiceInputTranscriptionStreamChunkDetail } from "./support/types.js";
 
-/** @internal */
+/**
+ * Captures voice input and drafts transcript text. Use it to support microphone-based prompt entry.
+ * Offers voice session lifecycle management and transcription event streams.
+ *
+ * @internal
+ */
 export abstract class ArcgisAssistantSpeechInput extends LitElement {
   /** @default false */
   accessor awaitingResponse: boolean;

package/dist/components/arcgis-assistant-speech-input/customElement.js

@@ -1,17 +1,26 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { c as S } from "../../chunks/runtime.js";
-import { css as R, html as y } from "lit";
-import { when as C, watch as p } from "@arcgis/core/core/reactiveUtils.js";
-import { LitElement as w, createEvent as d, nothing as v } from "@arcgis/lumina";
-import I from "@arcgis/core/core/Accessor.js";
+import { c as C } from "../../chunks/runtime.js";
+import { css as S, html as R } from "lit";
+import { watch as p } from "@arcgis/core/core/reactiveUtils.js";
+import { LitElement as y, createEvent as d, nothing as v } from "@arcgis/lumina";
 import { property as l, subclass as f } from "@arcgis/core/core/accessorSupport/decorators.js";
-const T = R`.button{--calcite-button-background-color: var(--calcite-color-transparent);--calcite-button-border-color: transparent;--calcite-button-icon-color: var(--calcite-color-text-3);--calcite-button-text-color: var(--calcite-color-text-3);flex:0 0 auto;position:relative}.button[data-state=disabled]{--calcite-button-icon-color: var(--calcite-color-text-3);opacity:var(--calcite-opacity-disabled)}.button[data-state=listening]{--calcite-button-background-color: color-mix( in srgb, var(--calcite-color-brand) 14%, var(--calcite-color-foreground-1) );--calcite-button-border-color: color-mix(in srgb, var(--calcite-color-brand) 24%, transparent);--calcite-button-icon-color: var(--calcite-color-brand);--calcite-button-text-color: var(--calcite-color-brand);box-shadow:var(--calcite-shadow-sm)}.button[data-state=listening]:hover{--calcite-button-background-color: color-mix( in srgb, var(--calcite-color-brand-hover, var(--calcite-color-brand)) 18%, var(--calcite-color-foreground-1) )}.button[data-state=listening]:active{--calcite-button-background-color: color-mix( in srgb, var(--calcite-color-brand) 24%, var(--calcite-color-foreground-1) )}.button[data-state=processing]{--calcite-button-background-color: color-mix( in srgb, var(--calcite-color-brand) 10%, var(--calcite-color-foreground-1) );--calcite-button-border-color: color-mix(in srgb, var(--calcite-color-brand) 20%, transparent);--calcite-button-icon-color: var(--calcite-color-brand);--calcite-button-text-color: var(--calcite-color-brand)}.button[data-state=error]{--calcite-button-background-color: color-mix( in srgb, var(--calcite-color-status-danger) 12%, var(--calcite-color-foreground-1) );--calcite-button-border-color: color-mix(in srgb, var(--calcite-color-status-danger) 24%, transparent);--calcite-button-icon-color: var(--calcite-color-status-danger);--calcite-button-text-color: var(--calcite-color-status-danger)}.button[data-state=listening]:after{content:"";position:absolute;inset:-4px;border:1px solid color-mix(in srgb,var(--calcite-color-brand) 40%,transparent);border-radius:inherit;opacity:0;pointer-events:none;transform:scale(.92);animation:assistant-speech-input-recording-pulse 1.8s ease-out infinite}@keyframes assistant-speech-input-recording-pulse{0%{opacity:.65;transform:scale(.92)}70%{opacity:0;transform:scale(1.16)}to{opacity:0;transform:scale(1.16)}}@media(prefers-reduced-motion){.button[data-state=listening]:after{animation:none}}`;
+import w from "@arcgis/core/core/Accessor.js";
+const I = S`.button{--calcite-button-background-color: var(--calcite-color-transparent);--calcite-button-border-color: transparent;--calcite-button-icon-color: var(--calcite-color-text-3);--calcite-button-text-color: var(--calcite-color-text-3);flex:0 0 auto;position:relative}.button[data-state=disabled]{--calcite-button-icon-color: var(--calcite-color-text-3);opacity:var(--calcite-opacity-disabled)}.button[data-state=listening]{--calcite-button-background-color: color-mix( in srgb, var(--calcite-color-brand) 14%, var(--calcite-color-foreground-1) );--calcite-button-border-color: color-mix(in srgb, var(--calcite-color-brand) 24%, transparent);--calcite-button-icon-color: var(--calcite-color-brand);--calcite-button-text-color: var(--calcite-color-brand);box-shadow:var(--calcite-shadow-sm)}.button[data-state=listening]:hover{--calcite-button-background-color: color-mix( in srgb, var(--calcite-color-brand-hover, var(--calcite-color-brand)) 18%, var(--calcite-color-foreground-1) )}.button[data-state=listening]:active{--calcite-button-background-color: color-mix( in srgb, var(--calcite-color-brand) 24%, var(--calcite-color-foreground-1) )}.button[data-state=processing]{--calcite-button-background-color: color-mix( in srgb, var(--calcite-color-brand) 10%, var(--calcite-color-foreground-1) );--calcite-button-border-color: color-mix(in srgb, var(--calcite-color-brand) 20%, transparent);--calcite-button-icon-color: var(--calcite-color-brand);--calcite-button-text-color: var(--calcite-color-brand)}.button[data-state=error]{--calcite-button-background-color: color-mix( in srgb, var(--calcite-color-status-danger) 12%, var(--calcite-color-foreground-1) );--calcite-button-border-color: color-mix(in srgb, var(--calcite-color-status-danger) 24%, transparent);--calcite-button-icon-color: var(--calcite-color-status-danger);--calcite-button-text-color: var(--calcite-color-status-danger)}.button[data-state=listening]:after{content:"";position:absolute;inset:-4px;border:1px solid color-mix(in srgb,var(--calcite-color-brand) 40%,transparent);border-radius:inherit;opacity:0;pointer-events:none;transform:scale(.92);animation:assistant-speech-input-recording-pulse 1.8s ease-out infinite}@keyframes assistant-speech-input-recording-pulse{0%{opacity:.65;transform:scale(.92)}70%{opacity:0;transform:scale(1.16)}to{opacity:0;transform:scale(1.16)}}@media(prefers-reduced-motion){.button[data-state=listening]:after{animation:none}}`, T = [
+  "audio/webm;codecs=opus",
+  "audio/webm",
+  "audio/mp4",
+  "audio/ogg;codecs=opus",
+  "audio/ogg"
+];
+function h(t) {
+  return t.replace(/\s+/gu, " ").trim();
+}
 var k = Object.defineProperty, x = Object.getOwnPropertyDescriptor, u = (t, e, s, i) => {
   for (var r = i > 1 ? void 0 : i ? x(e, s) : e, n = t.length - 1, o; n >= 0; n--)
     (o = t[n]) && (r = (i ? o(e, s, r) : o(r)) || r);
   return i && r && k(e, s, r), r;
 };
-let a = class extends I {
+let a = class extends w {
   constructor(t) {
     super(t), this.state = "idle", this.liveTranscript = "", this.transcript = "", this.errorCode = void 0;
   }
@@ -37,37 +46,17 @@ u([
 a = u([
   f("SpeechController")
 ], a);
-const V = [
-  "audio/webm;codecs=opus",
-  "audio/webm",
-  "audio/mp4",
-  "audio/ogg;codecs=opus",
-  "audio/ogg"
-];
-function h(t) {
-  return t.replace(/\s+/gu, " ").trim();
-}
-var O = Object.defineProperty, M = Object.getOwnPropertyDescriptor, g = (t, e, s, i) => {
-  for (var r = i > 1 ? void 0 : i ? M(e, s) : e, n = t.length - 1, o; n >= 0; n--)
+var V = Object.defineProperty, O = Object.getOwnPropertyDescriptor, g = (t, e, s, i) => {
+  for (var r = i > 1 ? void 0 : i ? O(e, s) : e, n = t.length - 1, o; n >= 0; n--)
     (o = t[n]) && (r = (i ? o(e, s, r) : o(r)) || r);
-  return i && r && O(e, s, r), r;
+  return i && r && V(e, s, r), r;
 };
 let c = class extends a {
   constructor(t) {
     super(t), this._activeSessionId = null, this._mediaRecorder = null, this._mediaRecorderChunkIndex = 0, this._mediaRecorderStopReason = null, this._mediaStream = null, this._pendingChunkOperations = /* @__PURE__ */ new Set(), this._recordedChunks = [], this.handleRecording = null, this.chunkTimeSlice = 3e3;
   }
   get _mimeType() {
-    return typeof window > "u" || typeof window.MediaRecorder?.isTypeSupported != "function" ? "" : V.find((t) => window.MediaRecorder.isTypeSupported(t)) ?? "";
-  }
-  initialize() {
-    c.isSupported() && this.addHandles(
-      C(
-        () => !!this.errorCode,
-        () => {
-          this._set("state", "error");
-        }
-      )
-    );
+    return typeof window > "u" || typeof window.MediaRecorder?.isTypeSupported != "function" ? "" : T.find((t) => window.MediaRecorder.isTypeSupported(t)) ?? "";
   }
   destroy() {
     this._mediaRecorder && (this._mediaRecorder.onstart = null, this._mediaRecorder.ondataavailable = null, this._mediaRecorder.onerror = null, this._mediaRecorder.onstop = null), this.cancel(), this._mediaRecorder = null;
@@ -119,7 +108,7 @@ let c = class extends a {
       } catch {
       }
     }
-    this._activeSessionId = null, this._mediaRecorder = null, this._mediaRecorderChunkIndex = 0, this._mediaRecorderStopReason = null, this._pendingChunkOperations.clear(), this._recordedChunks = [], this._releaseMediaStream(), this._set("liveTranscript", ""), this._set("transcript", ""), this._set("errorCode", t);
+    this._activeSessionId = null, this._mediaRecorder = null, this._mediaRecorderChunkIndex = 0, this._mediaRecorderStopReason = null, this._pendingChunkOperations.clear(), this._recordedChunks = [], this._releaseMediaStream(), this._set("liveTranscript", ""), this._set("transcript", ""), this._set("state", "error"), this._set("errorCode", t);
   }
   _onError() {
     this._failSession("recording-failed");
@@ -146,7 +135,7 @@ let c = class extends a {
     if (await this._awaitPendingChunkOperations(), e !== this._activeSessionId)
       return;
     if (!(i ? new Blob(r, { type: i }) : new Blob(r)).size) {
-      this._activeSessionId === e && (this._activeSessionId = null), this._mediaRecorderStopReason = null, this._recordedChunks = [], this._set("errorCode", "recording-failed");
+      this._activeSessionId === e && (this._activeSessionId = null), this._mediaRecorderStopReason = null, this._recordedChunks = [], this._set("state", "error"), this._set("errorCode", "recording-failed");
       return;
     }
     this._set("state", "processing"), this._set("transcript", h(`${this.transcript} ${this.liveTranscript}`)), this._set("liveTranscript", ""), this._activeSessionId === e && (this._activeSessionId = null), this._set("state", "idle"), this._set("errorCode", void 0), this._mediaRecorderStopReason = null, this._recordedChunks = [];
@@ -165,7 +154,7 @@ let c = class extends a {
       const s = this._mimeType, i = s ? new window.MediaRecorder(e, { mimeType: s }) : new window.MediaRecorder(e);
       this._mediaStream = e, this._mediaRecorder = i, this._mediaRecorderChunkIndex = 0, this._mediaRecorderStopReason = null, this._recordedChunks = [], i.ondataavailable = this._onDataAvailable.bind(this), i.onerror = this._onError.bind(this), i.onstart = this._onStart.bind(this), i.onstop = this._onStop.bind(this), this._mediaRecorder.start(this.chunkTimeSlice);
     }).catch((e) => {
-      t === this._activeSessionId && (this._activeSessionId = null, this._mediaRecorder = null, this._mediaRecorderChunkIndex = 0, this._mediaRecorderStopReason = null, this._pendingChunkOperations.clear(), this._recordedChunks = [], this._releaseMediaStream(), e instanceof DOMException && e.name === "NotAllowedError" ? this._set("errorCode", "not-allowed") : this._set("errorCode", "recording-failed"));
+      t === this._activeSessionId && (this._activeSessionId = null, this._mediaRecorder = null, this._mediaRecorderChunkIndex = 0, this._mediaRecorderStopReason = null, this._pendingChunkOperations.clear(), this._recordedChunks = [], this._releaseMediaStream(), e instanceof DOMException && e.name === "NotAllowedError" ? (this._set("state", "error"), this._set("errorCode", "not-allowed")) : (this._set("state", "error"), this._set("errorCode", "recording-failed")));
     });
   }
   stop() {
@@ -208,8 +197,8 @@ g([
 c = g([
   f("MediaRecorderController")
 ], c);
-var D = Object.getOwnPropertyDescriptor, $ = (t, e, s, i) => {
-  for (var r = i > 1 ? void 0 : i ? D(e, s) : e, n = t.length - 1, o; n >= 0; n--)
+var M = Object.getOwnPropertyDescriptor, D = (t, e, s, i) => {
+  for (var r = i > 1 ? void 0 : i ? M(e, s) : e, n = t.length - 1, o; n >= 0; n--)
     (o = t[n]) && (r = o(r) || r);
   return r;
 };
@@ -228,14 +217,7 @@ let _ = class extends a {
     if (!t)
       return;
     const e = new t();
-    e.continuous = !0, e.interimResults = !0, this.language && (e.lang = this.language), e.onstart = this._onStart.bind(this), e.onresult = this._onResult.bind(this), e.onerror = this._onError.bind(this), e.onend = this._onEnd.bind(this), e.onspeechend = this._onSpeechEnd.bind(this), this._recognition = e, this.addHandles(
-      C(
-        () => !!this.errorCode,
-        () => {
-          this._set("state", "error");
-        }
-      )
-    );
+    e.continuous = !0, e.interimResults = !0, this.language && (e.lang = this.language), e.onstart = this._onStart.bind(this), e.onresult = this._onResult.bind(this), e.onerror = this._onError.bind(this), e.onend = this._onEnd.bind(this), e.onspeechend = this._onSpeechEnd.bind(this), this._recognition = e;
   }
   destroy() {
     this._recognition && (this._recognition.onstart = null, this._recognition.onresult = null, this._recognition.onerror = null, this._recognition.onend = null, this._recognition.onspeechend = null, this.cancel(), this._recognition = null);
@@ -268,7 +250,7 @@ let _ = class extends a {
       default:
         e = "unhandled";
     }
-    this._set("errorCode", e);
+    this._set("state", "error"), this._set("errorCode", e);
   }
   // Natural end can arrive before the last interim segment becomes final, so preserve that trailing text.
   _onEnd() {
@@ -294,7 +276,7 @@ let _ = class extends a {
     try {
       this._recognition.start();
     } catch {
-      this._set("errorCode", "unhandled");
+      this._set("state", "error"), this._set("errorCode", "unhandled");
     }
   }
   stop() {
@@ -319,7 +301,7 @@ let _ = class extends a {
     return !!b();
   }
 };
-_ = $([
+_ = D([
   f("WebSpeechController")
 ], _);
 function m(t) {
@@ -329,7 +311,7 @@ function m(t) {
   const i = e.trim();
   return i ? `${i} ${s}` : s;
 }
-class E extends w {
+class $ extends y {
   constructor() {
     super(...arguments), this.#e = null, this._resolvedMode = "disabled", this.awaitingResponse = !1, this.inputValue = "", this.mode = "web-speech", this.arcgisVoiceInputDraftChange = d(), this.arcgisVoiceInputError = d(), this.arcgisVoiceInputInterimTranscription = d(), this.arcgisVoiceInputStart = d(), this.arcgisVoiceInputStop = d(), this.arcgisVoiceInputTranscription = d(), this.arcgisVoiceInputTranscriptionStreamChunk = d();
   }
@@ -337,7 +319,7 @@ class E extends w {
     this.properties = { _resolvedMode: 16, _state: 16, _errorCode: 16, _liveTranscript: 16, _transcript: 16, _isButtonDisabled: 16, _buttonLabel: 16, awaitingResponse: 5, inputValue: 1, language: 1, mode: 1 };
   }
   static {
-    this.styles = T;
+    this.styles = I;
   }
   #e;
   get _state() {
@@ -477,12 +459,12 @@ class E extends w {
     this._speechController && this._resolvedMode !== "disabled" && this._speechController.cancel(), this.clearDraftSession();
   }
   render() {
-    return y`<calcite-button appearance=transparent class="button" data-mode=${this._resolvedMode ?? v} data-state=${(this._resolvedMode === "disabled" ? "disabled" : this._state) ?? v} .disabled=${this._isButtonDisabled} icon-start=microphone kind=neutral .label=${this._buttonLabel} .loading=${this._state === "processing"} round scale=m @click=${() => {
+    return R`<calcite-button appearance=transparent class="button" data-mode=${this._resolvedMode ?? v} data-state=${(this._resolvedMode === "disabled" ? "disabled" : this._state) ?? v} .disabled=${this._isButtonDisabled} icon-start=microphone kind=neutral .label=${this._buttonLabel} .loading=${this._state === "processing"} round scale=m @click=${() => {
       this._handleToggle();
     }}></calcite-button>`;
   }
 }
-S("arcgis-assistant-speech-input", E);
+C("arcgis-assistant-speech-input", $);
 export {
-  E as ArcgisAssistantSpeechInput
+  $ as ArcgisAssistantSpeechInput
 };