@arcgis/ai-components 5.1.0-next.8 → 5.1.0-next.80

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

@@ -1,26 +1,26 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import { c as v } from "../../chunks/runtime.js";
-import { css as b, html as u } from "lit";
-import _ from "@arcgis/core/core/Collection.js";
-import { whenOnce as w, watch as E, when as $ } from "@arcgis/core/core/reactiveUtils.js";
-import k from "@arcgis/core/portal/Portal.js";
-import { LitElement as C, createEvent as o } from "@arcgis/lumina";
-import { createRef as m, ref as y } from "lit/directives/ref.js";
-import { Orchestrator as S } from "@arcgis/ai-orchestrator";
-import L from "@arcgis/core/core/Accessor.js";
-import { property as h, subclass as I } from "@arcgis/core/core/accessorSupport/decorators.js";
-import { g as P } from "../../chunks/utils2.js";
-import { u as O } from "../../chunks/useT9n.js";
+import { c as _ } from "../../chunks/runtime.js";
+import { css as w, html as n } from "lit";
+import E from "@arcgis/core/core/Collection.js";
+import { whenOnce as C, watch as $, when as k } from "@arcgis/core/core/reactiveUtils.js";
+import S from "@arcgis/core/portal/Portal.js";
+import { LitElement as I, createEvent as l } from "@arcgis/lumina";
+import { createRef as b, ref as f } from "lit/directives/ref.js";
+import { Orchestrator as L } from "@arcgis/ai-orchestrator";
+import P from "@arcgis/core/core/Accessor.js";
+import { property as u, subclass as R } from "@arcgis/core/core/accessorSupport/decorators.js";
+import { u as x } from "../../chunks/useT9n.js";
 import { rethrowError as M } from "@arcgis/toolkit/log";
-const x = b`:host{display:block;height:var(--arcgis-internal-expand-max-height, 100%)}`;
-var A = Object.defineProperty, R = Object.getOwnPropertyDescriptor, l = (c, t, e, i) => {
-  for (var s = i > 1 ? void 0 : i ? R(t, e) : t, r = c.length - 1, n; r >= 0; r--)
-    (n = c[r]) && (s = (i ? n(t, e, s) : n(s)) || s);
-  return i && s && A(t, e, s), s;
+import { g as O } from "../../chunks/utils2.js";
+const A = w`:host{display:block;width:var(--arcgis-internal-panel-width, 100%);height:var(--arcgis-internal-expand-max-height, 100%)}.footer-container{display:flex;flex-direction:column;flex:1 1 0;gap:var(--calcite-spacing-md)}.content-container{display:flex;flex-direction:column;flex:1 1 0;min-height:0;position:relative;overflow:auto}.suggested-prompts-container{display:flex;justify-content:center;width:100%}.suggested-prompts{display:block;padding:var(--calcite-spacing-md);max-width:100%;box-sizing:border-box}`;
+var z = Object.defineProperty, V = Object.getOwnPropertyDescriptor, h = (g, e, t, i) => {
+  for (var s = i > 1 ? void 0 : i ? V(e, t) : e, r = g.length - 1, a; r >= 0; r--)
+    (a = g[r]) && (s = (i ? a(e, t, s) : a(s)) || s);
+  return i && s && z(e, t, s), s;
 };
-let a = class extends L {
-  constructor(c) {
-    super(c), this.view = null, this.loading = !1, this.processing = !1, this.processingStep = "";
+let o = class extends P {
+  constructor(g) {
+    super(g), this.view = null, this.loading = !1, this.processing = !1, this.processingStep = "";
   }
   async load() {
     this._set("loading", !0);
@@ -34,182 +34,217 @@ let a = class extends L {
     this.orchestrator?.dispose(), super.destroy();
   }
   async _initialize() {
-    this.removeHandles(), await Promise.all([this.portal.load(), this.view?.when()]), this.view && await w(() => !this.view.updating), this._set(
+    this.removeHandles(), await Promise.all([this.portal.load(), this.view?.when()]), this.view && await C(() => !this.view.updating), this._set(
       "orchestrator",
-      await S.init({
+      await L.init({
         agents: [...this.agents],
-        portal: this.portal,
         view: this.view ?? void 0
       })
     ), this.addHandles([
-      E(
+      $(
         () => [this.view, this.agents],
-        () => void this._initialize()
+        () => {
+          this._initialize();
+        }
       )
     ]);
   }
-  async *ask(c, t) {
+  clearChatHistory() {
+    this.orchestrator?.newConversation();
+  }
+  async *ask(g, e) {
     if (!this.orchestrator)
       throw new Error("Orchestrator not initialized yet.");
     this._set("processing", !0), this._set("processingStep", "");
-    const e = [];
+    const t = [];
+    let i;
     try {
-      const i = this.orchestrator.ask(c);
-      for await (const s of i) {
-        const r = s.runId;
-        if (t?.aborted) {
-          yield { type: "cancelled", runId: r };
+      const s = this.orchestrator.ask(g);
+      for await (const r of s) {
+        const a = r.runId;
+        if (e?.aborted) {
+          yield { type: "cancelled", runId: a };
           break;
         }
-        switch (s.type) {
+        switch (r.type) {
           case "trace": {
-            this._set("processingStep", s.data.text), e.push(s.data.text);
+            this._set("processingStep", r.data.text), t.push(r.data.text);
             break;
           }
           case "completed": {
-            if (!s.result.content.length) {
-              yield { type: "completed", error: "Could not process the request.", log: e, runId: r };
+            const c = r.result, p = !!c.content.length, m = !!i?.length;
+            if (!p && !m) {
+              yield { type: "completed", error: "Could not process the request.", log: t, runId: a };
               return;
             }
-            const n = s.result.content;
-            this._set("processingStep", ""), yield { type: "completed", response: n, log: e, runId: r };
+            const d = c.content;
+            this._set("processingStep", ""), yield { type: "completed", response: d, blocks: i, log: t, runId: a };
             return;
           }
+          case "ux-suggestion": {
+            const c = r.suggestion;
+            i = i ? [...i, c] : [c];
+            break;
+          }
           case "interrupt": {
-            const { kind: n, message: p, metadata: d } = s.interrupt, g = Array.isArray(d) ? [...d] : [], f = (() => {
-              switch (n) {
+            const { kind: c, message: p, metadata: m } = r.interrupt, d = Array.isArray(m) ? m.filter((v) => typeof v == "string") : [], y = (() => {
+              switch (c) {
                 case "booleanChoice":
-                  return { type: "boolean-choice", message: p, options: g };
+                  return { type: "boolean-choice", message: p, options: d };
                 case "singleSelection":
-                  return { type: "single-select", message: p, options: g };
+                  return { type: "single-select", message: p, options: d };
                 case "multipleSelection":
-                  return { type: "multi-select", message: p, options: g };
+                  return { type: "multi-select", message: p, options: d };
                 case "textInput":
                   return { type: "text-input", message: p };
                 default:
-                  return { type: n, message: p, options: g };
+                  return { type: c, message: p, options: d };
               }
             })();
-            this._set("processingStep", "Waiting for user input..."), yield { type: "interrupt", payload: f, runId: r };
+            this._set("processingStep", "Waiting for user input..."), yield { type: "interrupt", payload: y, runId: a };
             break;
           }
           case "cancelled": {
-            yield { type: "cancelled", runId: r };
+            yield { type: "cancelled", runId: a };
+            return;
+          }
+          case "error": {
+            yield { type: "completed", error: r.error.message, log: t, runId: a };
             return;
           }
           default: {
-            console.warn("Unknown event type:", s);
+            console.warn("Unknown event type:", r);
             break;
           }
         }
       }
-    } catch (i) {
-      console.warn("Error during message processing:", i), yield { type: "completed", error: "An error occurred during message processing.", log: e, runId: "error" };
+    } catch (s) {
+      console.warn("Error during message processing:", s), yield { type: "completed", error: "An error occurred during message processing.", log: t, runId: "error" };
       return;
     } finally {
       this._set("processing", !1);
     }
   }
 };
-l([
-  h({ readOnly: !0 })
-], a.prototype, "orchestrator", 2);
-l([
-  h()
-], a.prototype, "agents", 2);
-l([
-  h()
-], a.prototype, "portal", 2);
-l([
-  h()
-], a.prototype, "view", 2);
-l([
-  h({ readOnly: !0 })
-], a.prototype, "loading", 2);
-l([
-  h({ readOnly: !0 })
-], a.prototype, "processing", 2);
-l([
-  h({ readOnly: !0 })
-], a.prototype, "processingStep", 2);
-a = l([
-  I("OrchestratorController")
-], a);
-class z extends C {
+h([
+  u({ readOnly: !0 })
+], o.prototype, "orchestrator", 2);
+h([
+  u()
+], o.prototype, "agents", 2);
+h([
+  u()
+], o.prototype, "portal", 2);
+h([
+  u()
+], o.prototype, "view", 2);
+h([
+  u({ readOnly: !0 })
+], o.prototype, "loading", 2);
+h([
+  u({ readOnly: !0 })
+], o.prototype, "processing", 2);
+h([
+  u({ readOnly: !0 })
+], o.prototype, "processingStep", 2);
+o = h([
+  R("OrchestratorController")
+], o);
+const j = "Embeddings resource 'embeddings-v01.json' not found in the webmap portal item.", H = "Embeddings not found for this web map.", B = "https://developers.arcgis.com/javascript/latest/agentic-apps/ai-webmap-setup/#embeddings";
+class D extends I {
   constructor() {
-    super(...arguments), this._messages = O({ blocking: !0 }), this.#e = m(), this.#s = m(), this.#t = null, this.#r = null, this.#o = /* @__PURE__ */ new Map(), this.#i = k.getDefault(), this.#a = (t) => {
-      t.stopPropagation(), this.arcgisInterruptCancel.emit(), this.orchestrator?.cancelInterrupt(), this._interrupt = null;
-    }, this.#n = (t) => {
-      t.stopPropagation();
-      const e = t.detail;
-      this.arcgisInterruptSubmit.emit(e), this.orchestrator?.resumeInterrupt(e), this._interrupt = null;
-    }, this.#l = (t) => {
-      t.stopPropagation(), this.suggestedPrompts = [];
-      const e = t.detail;
-      this.arcgisSubmit.emit(e), this.submitMessage(e);
-    }, this.#c = (t) => {
-      if (t.stopPropagation(), this.arcgisCancel.emit(), this._interrupt) {
+    super(...arguments), this._messages = x({ blocking: !0 }), this.#e = b(), this.#n = b(), this.#t = b(), this.#s = null, this.#o = /* @__PURE__ */ new Map(), this.#r = S.getDefault(), this.#i = (e) => {
+      e.stopPropagation(), this.cancelInterrupt();
+    }, this.#a = (e) => {
+      e.stopPropagation();
+      const t = e.detail;
+      this.submitInterrupt(t);
+    }, this.#l = (e) => {
+      e.stopPropagation(), this.keepSuggestedPrompts || (this.suggestedPrompts = []);
+      const t = e.detail;
+      this._inputValue = "", this.arcgisSubmit.emit(t), this.submitMessage(t);
+    }, this.#c = (e) => {
+      if (e.stopPropagation(), this.arcgisCancel.emit(), this._interrupt) {
         this.orchestrator?.cancelInterrupt(), this._interrupt = null;
         return;
       }
-      this.#r?.abort();
-    }, this.#h = (t) => {
-      t.stopPropagation();
-      const e = t.detail;
-      this.arcgisFeedback.emit(e);
-    }, this._interrupt = null, this._error = null, this.messages = new _([]), this.referenceElement = null, this.suggestedPrompts = [], this.feedbackEnabled = !1, this.logEnabled = !1, this.copyEnabled = !1, this.arcgisCancel = o(), this.arcgisError = o(), this.arcgisInterrupt = o(), this.arcgisInterruptCancel = o(), this.arcgisInterruptSubmit = o(), this.arcgisReady = o(), this.arcgisSubmit = o(), this.arcgisFeedback = o();
+      this.#s?.abort();
+    }, this.#h = (e) => {
+      e.stopPropagation();
+      const t = e.detail;
+      this.arcgisFeedback.emit(t);
+    }, this.#g = (e) => {
+      e.stopPropagation();
+      const t = e.detail;
+      this._inputValue = t.prompt, this.arcgisPromptSelect.emit(t);
+    }, this._orchestratorController = null, this._interrupt = null, this._error = null, this._inputValue = "", this.messages = new E([]), this.referenceElement = null, this.suggestedPrompts = [], this.feedbackEnabled = !1, this.keepSuggestedPrompts = !1, this.logEnabled = !1, this.copyEnabled = !1, this.voiceInputEnabled = !1, this.readAloudEnabled = !1, this.arcgisCancel = l(), this.arcgisError = l(), this.arcgisFeedback = l(), this.arcgisInterrupt = l(), this.arcgisInterruptCancel = l(), this.arcgisInterruptSubmit = l(), this.arcgisPromptSelect = l(), this.arcgisReady = l(), this.arcgisSubmit = l();
   }
   static {
-    this.properties = { _interrupt: 16, _error: 16, _user: 16, messages: 0, orchestrator: 32, entryMessage: 1, heading: 1, description: 1, referenceElement: 1, suggestedPrompts: 0, feedbackEnabled: 5, logEnabled: 5, copyEnabled: 5 };
+    this.properties = { _orchestratorController: 16, _interrupt: 16, _error: 16, _inputValue: 16, _user: 16, awaitingResponse: 32, awaitingResponseStep: 32, interrupt: 32, messages: 0, orchestrator: 32, entryMessage: 1, heading: 1, description: 1, referenceElement: 1, suggestedPrompts: 0, feedbackEnabled: 5, keepSuggestedPrompts: 5, logEnabled: 5, copyEnabled: 5, voiceInputEnabled: 5, readAloudEnabled: 5 };
   }
   static {
-    this.styles = x;
+    this.styles = A;
   }
   #e;
-  #s;
+  #n;
   #t;
-  #r;
+  #s;
   #o;
+  #r;
   #i;
   #a;
-  #n;
   #l;
   #c;
   #h;
+  #g;
   async #p() {
     try {
-      const t = P(this.el, this.referenceElement);
-      await t?.componentOnReady();
-      const e = [...this.#o.values()];
-      return e.length ? (this.#t = new a({
-        agents: e,
-        portal: this.#i,
-        view: t?.view
-      }), await this.#t.load(), !0) : (this._error = "No agents found.", !1);
-    } catch (t) {
-      return this._error = "Error initializing orchestrator.", M(this)(t), !1;
+      const e = O(this.el, this.referenceElement);
+      await e?.componentOnReady();
+      const t = [...this.#o.values()];
+      return t.length ? (this._orchestratorController = new o({
+        agents: t,
+        portal: this.#r,
+        view: e?.view
+      }), await this._orchestratorController.load(), !0) : (this._error = "No agents found.", !1);
+    } catch (e) {
+      return this._error = e?.message ?? "Error initializing orchestrator.", M(this)(e), !1;
     }
   }
   get _user() {
-    return this.#i?.user?.fullName || this.#i?.user?.username;
+    return this.#r?.user?.fullName || this.#r?.user?.username;
+  }
+  get awaitingResponse() {
+    return this._orchestratorController?.processing ?? !1;
+  }
+  get awaitingResponseStep() {
+    return this._orchestratorController?.processingStep ?? "";
+  }
+  get interrupt() {
+    return this._interrupt;
   }
   get orchestrator() {
-    return this.#t?.orchestrator;
+    return this._orchestratorController?.orchestrator;
   }
-  register(t) {
-    this.#o.set(t.agent.id, t);
+  async clearChatHistory() {
+    this._reset(), this._orchestratorController?.clearChatHistory();
   }
-  async submitMessage(t) {
-    const e = t.trim();
-    if (!e || (this.messages.push({
+  cancelInterrupt() {
+    this.arcgisInterruptCancel.emit(), this.orchestrator?.cancelInterrupt(), this._interrupt = null;
+  }
+  register(e) {
+    this.#o.set(e.agent.id, e);
+  }
+  async submitMessage(e) {
+    const t = e.trim();
+    if (!t || (this.messages.push({
       id: Date.now().toString(),
       // TODO: Replace with a more robust ID generation method or get from orchestrator
       role: "user",
-      content: e
-    }), !this.#t))
+      content: t
+    }), !this._orchestratorController))
       return;
-    this.#r = new AbortController();
-    const i = this.#t.ask(e, this.#r.signal);
+    const i = this._orchestratorController.ask(t, this.#s?.signal);
     for await (const s of i) {
       const r = s.runId;
       switch (s.type) {
@@ -217,13 +252,14 @@ class z extends C {
           this.messages.push({
             role: "assistant",
             content: s.response,
+            blocks: s.blocks,
             log: s.log,
             error: s.error,
             id: r
           });
           break;
         case "interrupt":
-          this._interrupt = { ...s.payload, id: r };
+          this._interrupt = { ...s.payload, id: r }, this.arcgisInterrupt.emit(this._interrupt);
           break;
         case "cancelled":
           this.messages.push({
@@ -235,32 +271,47 @@ class z extends C {
       }
     }
   }
+  submitInterrupt(e) {
+    this.arcgisInterruptSubmit.emit(e), this.orchestrator?.resumeInterrupt(e), this._interrupt = null;
+  }
   load() {
-    this.manager.onLifecycle(() => () => {
-      this.#r?.abort(), this._interrupt = null, this.messages.removeAll(), this._error = null;
-    });
+    this.manager.onLifecycle(this._reset.bind(this));
   }
   loaded() {
     this.manager.onLifecycle(() => {
-      this.#e.value?.addEventListener("arcgisSubmit", this.#l), this.#e.value?.addEventListener("arcgisCancel", this.#c), this.#e.value?.addEventListener("arcgisFeedback", this.#h);
-      const t = $(() => !!this._interrupt && !!this.#s.value, () => {
-        const e = this.#s.value;
-        e.removeEventListener("arcgisSubmit", this.#n), e.removeEventListener("arcgisCancel", this.#a), e.addEventListener("arcgisSubmit", this.#n, { once: !0 }), e.addEventListener("arcgisCancel", this.#a, { once: !0 }), this._interrupt && this.arcgisInterrupt.emit(this._interrupt);
+      this.#e.value?.addEventListener("arcgisPromptSelect", this.#g), this.#e.value?.addEventListener("arcgisSubmit", this.#l), this.#e.value?.addEventListener("arcgisCancel", this.#c), this.#e.value?.addEventListener("arcgisFeedback", this.#h);
+      const e = k(() => !!this._interrupt && !!this.#t.value, () => {
+        const t = this.#t.value;
+        t.removeEventListener("arcgisSubmit", this.#a), t.removeEventListener("arcgisCancel", this.#i), t.addEventListener("arcgisSubmit", this.#a, { once: !0 }), t.addEventListener("arcgisCancel", this.#i, { once: !0 });
       });
       return queueMicrotask(() => {
-        this.#p().then((e) => {
-          e ? this.arcgisReady.emit() : this.arcgisError.emit(new Error(this._error || "Unknown error initializing assistant."));
+        this.#p().then((t) => {
+          t ? this.arcgisReady.emit() : this._error && this.arcgisError.emit(new Error(this._error));
         });
       }), () => {
-        t.remove(), this.#s.value?.removeEventListener("arcgisSubmit", this.#n), this.#s.value?.removeEventListener("arcgisCancel", this.#a), this.#e.value?.removeEventListener("arcgisSubmit", this.#l), this.#e.value?.removeEventListener("arcgisCancel", this.#c), this.#e.value?.removeEventListener("arcgisFeedback", this.#h), this.#t?.destroy(), this.#t = null;
+        e.remove(), this.#e.value?.removeEventListener("arcgisPromptSelect", this.#g), this.#t.value?.removeEventListener("arcgisSubmit", this.#a), this.#t.value?.removeEventListener("arcgisCancel", this.#i), this.#e.value?.removeEventListener("arcgisSubmit", this.#l), this.#e.value?.removeEventListener("arcgisCancel", this.#c), this.#e.value?.removeEventListener("arcgisFeedback", this.#h), this._orchestratorController?.destroy(), this._orchestratorController = null;
       };
     });
   }
+  _reset() {
+    this.#s?.abort(), this._interrupt = null, this.messages.removeAll(), this._error = null, this._inputValue = "";
+  }
+  _renderEntryMessage() {
+    return this._interrupt ? n`<slot name=interrupt><arcgis-assistant-interrupt .type=${this._interrupt.type} .message=${this._interrupt.message} .options=${this._interrupt.options} ${f(this.#t)}></arcgis-assistant-interrupt></slot>` : this._error ? this._renderErrorNotice() : this.entryMessage ? this.messages.length > 0 ? null : n`<calcite-notice open kind=info closable icon width=full><div slot=message>${this.entryMessage}</div></calcite-notice>` : n`<slot name=entry-message></slot>`;
+  }
+  _renderErrorNotice() {
+    return this._error ? n`<calcite-notice closable slot=entry-message open kind=danger icon width=full>${this._error === j ? n`<div slot=message>${H}</div><calcite-link slot=link .href=${B} target=_blank title="Learn about web map embeddings">Read more</calcite-link>` : n`<div slot=message>${this._error}</div>`}</calcite-notice>` : null;
+  }
+  _renderSuggestedPrompts() {
+    return this.suggestedPrompts?.length ? n`<div class="suggested-prompts-container"><arcgis-assistant-suggested-prompts class="suggested-prompts" .prompts=${this.suggestedPrompts}></arcgis-assistant-suggested-prompts></div>` : null;
+  }
   render() {
-    return u`<arcgis-assistant-shell .loading=${!this.#t || this.#t?.loading} .heading=${this.heading ?? this._messages.assistantLabel} .description=${this.description} .entryMessage=${this.entryMessage} .entryMessageClosed=${this.messages.length > 0} .awaitingResponse=${this.#t?.processing} .suggestedPrompts=${this.suggestedPrompts} .status=${this.#t?.processing ? "working" : this._error ? "error" : "ready"} .messages=${this.messages} ${y(this.#e)}>${this._error ? u`<calcite-notice slot=entry-message open kind=danger icon width=full><div slot=message>${this._error}</div></calcite-notice>` : null}${this._interrupt ? u`<arcgis-assistant-interrupt slot=entry-message .type=${this._interrupt.type} .message=${this._interrupt.message} .options=${this._interrupt.options} ${y(this.#s)}></arcgis-assistant-interrupt>` : null}<arcgis-assistant-chat .loading=${this.#t?.processing} .loadingMessage=${this.#t?.processingStep || ""} .messages=${this.messages} .user=${this._user} .feedbackEnabled=${this.feedbackEnabled} .logEnabled=${this.logEnabled} .copyEnabled=${this.copyEnabled}><slot></slot><slot name=chat-card-footer-actions-start slot=chat-card-footer-actions-start></slot><slot name=chat-card-footer-actions-end slot=chat-card-footer-actions-end></slot></arcgis-assistant-chat><slot name=header-actions-end slot=header-actions-end></slot>${this.entryMessage ? null : u`<slot name=entry-message slot=entry-message></slot>`}<slot name=entry-actions-start slot=entry-actions-start></slot><slot name=footer-content slot=footer-content></slot></arcgis-assistant-shell>`;
+    return n`<calcite-panel .loading=${!this._orchestratorController && !this._error || this._orchestratorController?.loading} .heading=${this.heading ?? this._messages.assistantLabel} .description=${this.description} ${f(this.#e)}><slot name=header-actions-start slot=header-actions-start></slot><slot name=header-actions-end slot=header-actions-end></slot><div class="content-container"><arcgis-assistant-chat .loading=${this.awaitingResponse} .messages=${this.messages}><slot name=message-starter slot=message-starter></slot><slot name=messages slot=messages>${this.messages.map((e) => e.role === "assistant" ? n`<arcgis-assistant-message .message=${e} .feedbackEnabled=${this.feedbackEnabled} .logEnabled=${this.logEnabled} .copyEnabled=${this.copyEnabled} .readAloudEnabled=${this.readAloudEnabled}></arcgis-assistant-message>` : n`<arcgis-assistant-user-message .message=${e} .user=${this._user}></arcgis-assistant-user-message>`)}</slot><slot name=message-loading slot=message-loading><arcgis-assistant-message-loading .loading=${this.awaitingResponse} .loadingMessage=${this.awaitingResponseStep}></arcgis-assistant-message-loading></slot></arcgis-assistant-chat></div>${this._renderSuggestedPrompts()}<div class="footer-container" slot=footer>${this._renderEntryMessage()}<slot name=chat-entry><arcgis-assistant-chat-entry .awaitingResponse=${this.awaitingResponse} .arcgisSubmit=${this.arcgisSubmit} .arcgisCancel=${this.arcgisCancel} .inputValue=${this._inputValue} .messages=${this.messages} .voiceInputEnabled=${this.voiceInputEnabled} ${f(this.#n)}><slot name=entry-actions-start slot=entry-actions-start></slot><slot name=entry-actions-end slot=entry-actions-end><calcite-button .iconStart=${this.awaitingResponse ? "circle-stop" : "send"} @click=${() => {
+      this.#n.value?.submitMessage();
+    }} round>${this.awaitingResponse ? this._messages.stopButtonLabel : this._messages.askButtonLabel}</calcite-button></slot></arcgis-assistant-chat-entry></slot><slot name=footer-content></slot></div></calcite-panel>`;
   }
 }
-v("arcgis-assistant", z);
+_("arcgis-assistant", D);
 export {
-  z as ArcgisAssistant
+  D as ArcgisAssistant
 };

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

@@ -1,5 +1,12 @@
-import "../arcgis-assistant-shell/index.js";
-import "@esri/calcite-components/components/calcite-notice";
 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-user-message/index.js";
+import "../arcgis-assistant-message-loading/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,29 +1,136 @@
+import type { UXSuggestion } from "@arcgis/ai-orchestrator";
+
+/** An interrupt is a UI mechanism used by an agent to prompt the user for additional input or clarification. */
 export interface Interrupt {
+  /**
+   * The unique identifier of the message associated with the interrupt. This is used to associate the interrupt
+   * with specific messages.
+   */
   id?: string;
+  /**
+   * The type of interrupt, which determines how the assistant will prompt the user for input. The available types are:
+   *
+   * - `boolean-choice`: Presents the user with a yes/no question.
+   * - `multi-select`: Allows the user to select multiple options from a list using a checkbox interface.
+   * - `single-select`: Allows the user to select a single option from a list using a radio button interface.
+   * - `text-input`: Prompts the user to enter free-form text input.
+   *
+   * The assistant will use the specified type to determine how to display the prompt and collect the user's response.
+   * For example, a `boolean-choice` interrupt might be used to confirm an action, while a `text-input`
+   * interrupt could be used to ask for more details about a request.
+   */
   type: "boolean-choice" | "multi-select" | "single-select" | "text-input";
+  /**
+   * The message to display to the user when prompting for input. This should provide clear instructions or questions
+   * related to the interrupt, guiding the user on what information is needed or what action they should take in response
+   * to the prompt.
+   *
+   * For example, if the interrupt type is `boolean-choice`, the message might be "Do you want to proceed with this
+   * action?" If the type is `text-input`, the message could be "Please provide more details about your request."
+   */
   message?: string;
+  /**
+   * The options to present to the user for selection when the interrupt type is `multi-select` or `single-select`.
+   * This should be an array of strings representing the available choices. For `boolean-choice`,
+   * the options are implicitly "Yes" and "No" and do not need to be provided.
+   * For `text-input`, options are not applicable and should be omitted.
+   *
+   * For example, if the interrupt type is `multi-select`, the options might be ["Option 1", "Option 2", "Option 3"].
+   * If the type is `single-select`, the options could be ["Choice A", "Choice B", "Choice C"].
+   */
   options?: string[];
 }
 
+/** A chat message sent by the assistant. */
 export interface AssistantMessage extends ChatMessageBase {
   role: "assistant";
+  /** The content of the assistant's message. This can include text generated by the assistant in response to the user's message. The content is displayed in the chat interface for the user to read and interact with. */
   content?: string;
+  /**
+   * Structured response UI blocks associated with the assistant message. These blocks are rendered as interactive
+   * 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[];
+  /**
+   * 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
+   * arrived at its response. Log messages are primarily intended for debugging and transparency purposes, allowing
+   * developers and users to understand the assistant's behavior and decision-making process.
+   */
   log?: string[];
+  /**
+   * An error message indicating any issues that occurred while the assistant was processing the user's request.
+   * The error message may be displayed in the chat interface to inform the user of the issue and can also be used for
+   * debugging and improving the assistant's performance.
+   */
   error?: string;
+  /**
+   * Feedback provided by the user for this specific assistant message. This allows users to indicate whether the
+   * assistant's response was helpful or not, which the app developer can capture and use to improve the assistant's
+   * performance over time.
+   */
   feedback?: Feedback;
 }
 
+/**
+ * A chat message from the user or the assistant. Messages include all relevant information such as content,
+ * logs, errors, and feedback.
+ */
 export type ChatMessage = AssistantMessage | UserMessage;
 
-export interface Feedback {
-  positive: boolean;
-}
+/** Detail payload emitted when a suggested prompt is selected. */
+export type AssistantPromptSelectDetail = {
+  /** The selected suggested prompt value. */
+  prompt: string;
+};
+
+/** Detail payload emitted with the assistant slottable request event. */
+export type AssistantSlottableRequestDetail = {
+  /** The request name describing the slot being requested. */
+  name: AssistantSlottableRequestName;
+  /** Element that owns the requested slot. Use this instead of event.target across shadow boundaries. */
+  slotOwner: HTMLElement;
+  /** The slot name consumers should target when appending light DOM content. */
+  slotName: string;
+  /** Data describing the current slot request. */
+  data: AssistantSlottableRequestData;
+};
 
+/** The base interface for chat messages exchanged between the user and the assistant. */
 export interface ChatMessageBase {
+  /**
+   * The unique identifier for the message. This is used to associate messages with interrupts and feedback.
+   * If not provided, a unique ID will be generated automatically.
+   */
   id: string;
 }
 
+/** A chat message sent by the user. */
 export interface UserMessage extends ChatMessageBase {
   role: "user";
+  /**
+   * The content of the user's message. This is the text input provided by the user in the chat interface.
+   * This content is sent to the assistant and its agents for processing and generating responses.
+   */
   content: string;
-}
+}
+
+/** Feedback provided by the user for a specific message. */
+export interface Feedback {
+  /** Indicates whether the feedback is positive or negative. */
+  positive: boolean;
+}
+
+/** Data emitted with an assistant slottable request. */
+export type AssistantSlottableRequestData = {
+  /** The assistant message associated with the slot request. */
+  message: AssistantMessage;
+  /** The block associated with the slot request, when requesting block content. */
+  block?: UXSuggestion;
+  /** Zero-based index of the block associated with the slot request. */
+  index?: number;
+};
+
+/** Supported assistant slottable request names. */
+export type AssistantSlottableRequestName = "block" | "message";