@arcgis/ai-components 5.1.0-next.7 → 5.1.0-next.71

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

@@ -3,14 +3,14 @@ import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { ArcgisMap as ArcgisMap } from "@arcgis/map-components/components/arcgis-map";
 
 /**
- * The Navigation Agent component enables the end user to navigate to different areas of a web map.
- * It allows you to type in a place name, address, or layer title to navigate to the desired location.
- * Currently, this is only scoped to navigation within a 2D map view.
+ * The Navigation Agent enables the end user to navigate to different areas of a web map. See the list
+ * of capabilities below for more details.
  *
  * This is an unrendered component that must be added as a child of the `arcgis-assistant` component in either HTML or JavaScript.
  *
  * ```html
- * <arcgis-assistant>
+ * <arcgis-map id="my-map"></arcgis-map>
+ * <arcgis-assistant reference-element="my-map">
  *   <arcgis-assistant-navigation-agent></arcgis-assistant-navigation-agent>
  * </arcgis-assistant>
  * ```
@@ -21,14 +21,61 @@ import type { ArcgisMap as ArcgisMap } from "@arcgis/map-components/components/a
  * assistant.appendChild(navigationAgent);
  * ```
  *
+ * Once added to the assistant, the agent is loaded and ready to receive user messages related to navigation.
+ *
+ * ### Capabilities
+ *
+ * The navigation agent provides the following capabilities related to map navigation:
+ *
+ * - **Geocoding** - Navigate to an address using Esri's World Geocoding Service.
+ * - **Go to extent** - Navigate to the extent of a bookmark in the map, the home extent of the web map,
+ *   or the extent of a layer.
+ * - **Go to features** - Navigate to a specified feature or set of features.
+ * - **Go to viewpoint** - Navigate to a specified viewpoint, which can include center, zoom, and/or
+ *   rotation.
+ *
+ * ### Example questions
+ *
+ * The following are example questions a user can ask within the bounds of the navigation agent:
+ *
+ * - "Go to the Golden Gate Bridge"
+ * - "Zoom to a 1 to 24,000 scale"
+ * - "Zoom in"
+ * - "Go to the parks layer"
+ *
+ * The following are examples of the types of questions that fall outside the bounds of the
+ * navigation agent and should therefore be avoided:
+ *
+ * - "Rotate the map 45 degrees" (this capability is not currently supported but may be in the future)
+ * - "Make this map 3D and tilt the view to a 45 degree angle" (3D navigation is currently not supported)
+ * - "Where am I?" (the navigation agent does not have access to the user's location)
+ *
+ * > Due to the non-deterministic nature of generative AI, there may be inaccuracies or unexpected behavior when using the
+ * out-of-the-box agents.
+ *
  * @since 5.0
  * @beta
  * @see [arcgis-assistant](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/)
+ * @see [Intro to building agentic mapping applications](https://developers.arcgis.com/javascript/latest/agentic-apps/ai-introduction/)
+ * @see [AI Assistant component sample](https://developers.arcgis.com/javascript/latest/sample-code/ai-assistant/)
  */
 export abstract class ArcgisAssistantNavigationAgent extends LitElement {
   /**
-   * A reference to the map element or its ID string used to resolve the MapView for this agent.
-   * If not provided, the agent will attempt to find the closest parent `arcgis-map` element.
+   * The reference element to the map that provides context for the navigation agent. Currently,
+   * this is only scoped to `arcgis-map` elements. This shows the navigation agent which map on which to
+   * perform navigation actions. This is required for the navigation agent to function properly.
+   *
+   * Setting this property is not necessary if you set the reference element on the parent
+   * `arcgis-assistant` component.
+   *
+   * @see [arcgis-assistant.referenceElement](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/#referenceElement)
+   * @example
+   * ```html
+   * <arcgis-map id="my-map"></arcgis-map>
+   * <arcgis-assistant>
+   *   <arcgis-assistant-navigation-agent reference-element="my-map"></arcgis-assistant-navigation-agent>
+   * </arcgis-assistant>
+   * ```
    */
   accessor referenceElement: ArcgisMap | string | undefined;
 }

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

@@ -1,11 +1,11 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
 import { c as t } from "../../chunks/runtime.js";
 import { LitElement as i } from "@arcgis/lumina";
-import { NavigationAgent as a } from "@arcgis/ai-agents";
-import { r as s, i as e } from "../../chunks/utils.js";
+import { NavigationAgent as s } from "@arcgis/ai-agents";
+import { r as a, a as e } from "../../chunks/utils.js";
 class n extends i {
   constructor() {
-    super(...arguments), this.agent = a;
+    super(...arguments), this.agent = s;
   }
   static {
     this.properties = { referenceElement: 1 };
@@ -16,8 +16,8 @@ class n extends i {
       throw new Error("arcgis-assistant-navigation-agent requires a mapView");
     return { mapView: this.#t };
   }
-  async load() {
-    this.#t = await s(this, "arcgis-assistant-navigation-agent"), e(this);
+  load() {
+    this.#t = a(this, "arcgis-assistant-navigation-agent"), e(this);
   }
 }
 t("arcgis-assistant-navigation-agent", n);

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

@@ -0,0 +1,31 @@
+/// <reference path="../../index.d.ts" />
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { VoiceInputDraftChangeDetail, VoiceInputErrorCode, VoiceInputMode, VoiceInputTranscriptDetail, VoiceInputTranscriptionStreamChunkDetail } from "./support/types.js";
+
+/** @internal */
+export abstract class ArcgisAssistantSpeechInput extends LitElement {
+  /** @default false */
+  accessor awaitingResponse: boolean;
+  /** @default "" */
+  accessor inputValue: string;
+  accessor language: string | undefined;
+  /** @default "web-speech" */
+  accessor mode: VoiceInputMode;
+  clearDraftSession(): void;
+  readonly arcgisVoiceInputDraftChange: import("@arcgis/lumina").TargetedEvent<this, VoiceInputDraftChangeDetail>;
+  readonly arcgisVoiceInputError: import("@arcgis/lumina").TargetedEvent<this, { errorCode: VoiceInputErrorCode; }>;
+  readonly arcgisVoiceInputInterimTranscription: import("@arcgis/lumina").TargetedEvent<this, VoiceInputTranscriptDetail>;
+  readonly arcgisVoiceInputStart: import("@arcgis/lumina").TargetedEvent<this, void>;
+  readonly arcgisVoiceInputStop: import("@arcgis/lumina").TargetedEvent<this, void>;
+  readonly arcgisVoiceInputTranscription: import("@arcgis/lumina").TargetedEvent<this, VoiceInputTranscriptDetail>;
+  readonly arcgisVoiceInputTranscriptionStreamChunk: import("@arcgis/lumina").TargetedEvent<this, VoiceInputTranscriptionStreamChunkDetail>;
+  readonly "@eventTypes": {
+    arcgisVoiceInputDraftChange: ArcgisAssistantSpeechInput["arcgisVoiceInputDraftChange"]["detail"];
+    arcgisVoiceInputError: ArcgisAssistantSpeechInput["arcgisVoiceInputError"]["detail"];
+    arcgisVoiceInputInterimTranscription: ArcgisAssistantSpeechInput["arcgisVoiceInputInterimTranscription"]["detail"];
+    arcgisVoiceInputStart: ArcgisAssistantSpeechInput["arcgisVoiceInputStart"]["detail"];
+    arcgisVoiceInputStop: ArcgisAssistantSpeechInput["arcgisVoiceInputStop"]["detail"];
+    arcgisVoiceInputTranscription: ArcgisAssistantSpeechInput["arcgisVoiceInputTranscription"]["detail"];
+    arcgisVoiceInputTranscriptionStreamChunk: ArcgisAssistantSpeechInput["arcgisVoiceInputTranscriptionStreamChunk"]["detail"];
+  };
+}

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

@@ -0,0 +1,488 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.1/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 { 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}}`;
+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 {
+  constructor(t) {
+    super(t), this.state = "idle", this.liveTranscript = "", this.transcript = "", this.errorCode = void 0;
+  }
+  static isSupported() {
+    return !1;
+  }
+};
+u([
+  l()
+], a.prototype, "language", 2);
+u([
+  l({ readOnly: !0 })
+], a.prototype, "state", 2);
+u([
+  l({ readOnly: !0 })
+], a.prototype, "liveTranscript", 2);
+u([
+  l({ readOnly: !0 })
+], a.prototype, "transcript", 2);
+u([
+  l({ readOnly: !0 })
+], a.prototype, "errorCode", 2);
+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--)
+    (o = t[n]) && (r = (i ? o(e, s, r) : o(r)) || r);
+  return i && r && O(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");
+        }
+      )
+    );
+  }
+  destroy() {
+    this._mediaRecorder && (this._mediaRecorder.onstart = null, this._mediaRecorder.ondataavailable = null, this._mediaRecorder.onerror = null, this._mediaRecorder.onstop = null), this.cancel(), this._mediaRecorder = null;
+  }
+  // Stop waits for any in-flight chunk transcription before finalizing the session transcript.
+  _queuePendingChunkOperation(t) {
+    this._pendingChunkOperations.add(t), t.finally(() => {
+      this._pendingChunkOperations.delete(t);
+    });
+  }
+  async _awaitPendingChunkOperations() {
+    this._pendingChunkOperations.size && await Promise.allSettled(Array.from(this._pendingChunkOperations));
+  }
+  _onDataAvailable(t) {
+    const e = this._activeSessionId;
+    e != null && this._queuePendingChunkOperation(this._processDataAvailable(t, e));
+  }
+  async _processDataAvailable(t, e) {
+    const s = t.data;
+    if (!s.size || e !== this._activeSessionId)
+      return;
+    this._recordedChunks.push(s);
+    const i = s.type || this._mediaRecorder?.mimeType || this._mimeType, r = this._mediaRecorderStopReason === "toggle" && this._mediaRecorder?.state === "inactive";
+    try {
+      if (!this.handleRecording)
+        return;
+      const n = h(
+        await this.handleRecording(s, i, this._mediaRecorderChunkIndex, r) ?? ""
+      );
+      if (e !== this._activeSessionId)
+        return;
+      n && this._set("liveTranscript", h(`${this.liveTranscript} ${n}`));
+    } catch (n) {
+      if (e !== this._activeSessionId)
+        return;
+      this._failSession(
+        n instanceof Error && n.message === "transcription-unavailable" ? "transcription-unavailable" : "transcription-failed"
+      );
+      return;
+    }
+    !r && e === this._activeSessionId && (this._mediaRecorderChunkIndex += 1);
+  }
+  _failSession(t) {
+    const e = this._mediaRecorder;
+    if (e) {
+      e.onstart = null, e.ondataavailable = null, e.onerror = null, e.onstop = null;
+      try {
+        e.state !== "inactive" && e.stop();
+      } 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);
+  }
+  _onError() {
+    this._failSession("recording-failed");
+  }
+  _onStart() {
+    this._set("state", "listening");
+  }
+  _onStop() {
+    this._handleStop();
+  }
+  _releaseMediaStream() {
+    this._mediaStream?.getTracks().forEach((t) => t.stop()), this._mediaStream = null;
+  }
+  async _handleStop() {
+    const t = this._mediaRecorder, e = this._activeSessionId, s = this._mediaRecorderStopReason, i = t?.mimeType || this._recordedChunks.find((o) => !!o.type)?.type || "", r = [...this._recordedChunks];
+    if (this._mediaRecorder = null, this._mediaRecorderChunkIndex = 0, this._releaseMediaStream(), s === "cancel") {
+      this._activeSessionId === e && (this._activeSessionId = null), this._mediaRecorderStopReason = null, this._pendingChunkOperations.clear(), this._recordedChunks = [], this._set("liveTranscript", ""), this._set("transcript", ""), this._set("state", "idle"), this._set("errorCode", void 0);
+      return;
+    }
+    if (e == null) {
+      this._mediaRecorderStopReason = null, this._pendingChunkOperations.clear(), this._recordedChunks = [], this._set("state", "idle"), this._set("errorCode", void 0);
+      return;
+    }
+    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");
+      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 = [];
+  }
+  start() {
+    if (!c.isSupported()) {
+      this._set("errorCode", "not-supported");
+      return;
+    }
+    const t = Date.now();
+    this._activeSessionId = t, this._mediaRecorderChunkIndex = 0, this._mediaRecorderStopReason = null, this._pendingChunkOperations.clear(), this._recordedChunks = [], this._set("liveTranscript", ""), this._set("transcript", ""), this._set("errorCode", void 0), navigator.mediaDevices.getUserMedia({ audio: !0 }).then((e) => {
+      if (t !== this._activeSessionId) {
+        e.getTracks().forEach((r) => r.stop());
+        return;
+      }
+      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"));
+    });
+  }
+  stop() {
+    if (this._mediaRecorder) {
+      this._mediaRecorderStopReason = "toggle";
+      try {
+        this._mediaRecorder.state !== "inactive" ? this._mediaRecorder.stop() : this._handleStop();
+      } catch {
+      }
+    }
+  }
+  cancel() {
+    const t = this._mediaRecorder;
+    if (this._activeSessionId = null, this._mediaRecorderStopReason = "cancel", this._mediaRecorderChunkIndex = 0, this._pendingChunkOperations.clear(), this._recordedChunks = [], this._set("liveTranscript", ""), this._set("transcript", ""), this._set("state", "idle"), this._set("errorCode", void 0), !t) {
+      this._releaseMediaStream();
+      return;
+    }
+    try {
+      if (t.state !== "inactive") {
+        t.stop();
+        return;
+      }
+    } catch {
+    }
+    this._mediaRecorder = null, this._releaseMediaStream();
+  }
+  static isSupported() {
+    return typeof window < "u" && !!(window.MediaRecorder && navigator.mediaDevices?.getUserMedia);
+  }
+};
+g([
+  l()
+], c.prototype, "_mimeType", 1);
+g([
+  l()
+], c.prototype, "handleRecording", 2);
+g([
+  l()
+], c.prototype, "chunkTimeSlice", 2);
+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--)
+    (o = t[n]) && (r = o(r) || r);
+  return r;
+};
+function b() {
+  if (typeof window > "u")
+    return null;
+  const t = window;
+  return t.SpeechRecognition ?? t.webkitSpeechRecognition ?? null;
+}
+let _ = class extends a {
+  constructor(t) {
+    super(t), this._isCancelled = !1, this._recognition = null;
+  }
+  initialize() {
+    const t = b();
+    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");
+        }
+      )
+    );
+  }
+  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);
+  }
+  _onStart() {
+    this._isCancelled = !1, this._set("state", "listening");
+  }
+  // SpeechRecognition result lists are cumulative, so rebuild finalized and live text from the full list.
+  _onResult(t) {
+    const { finalTranscript: e, liveTranscript: s } = Array.from(t.results).reduce(
+      (i, r) => (r.isFinal ? i.finalTranscript += r[0].transcript : i.liveTranscript += r[0].transcript, i),
+      { finalTranscript: "", liveTranscript: "" }
+    );
+    this._set("transcript", h(e)), this._set("liveTranscript", h(s));
+  }
+  _onError(t) {
+    if (t.error === "aborted" && this._isCancelled) {
+      this._set("state", "idle");
+      return;
+    }
+    let e = "unhandled";
+    switch (t.error) {
+      case "no-speech":
+        e = "no-speech";
+        break;
+      case "service-not-allowed":
+      case "not-allowed":
+        e = "not-allowed";
+        break;
+      default:
+        e = "unhandled";
+    }
+    this._set("errorCode", e);
+  }
+  // Natural end can arrive before the last interim segment becomes final, so preserve that trailing text.
+  _onEnd() {
+    const t = h(`${this.transcript} ${this.liveTranscript}`);
+    if (this._set("liveTranscript", ""), this._isCancelled) {
+      this._set("transcript", ""), this._set("state", "idle"), this._set("errorCode", void 0);
+      return;
+    }
+    this.errorCode ? this._set("transcript", "") : (this._set("transcript", t), this._set("state", "idle")), this._set("errorCode", void 0);
+  }
+  _onSpeechEnd() {
+    this._set("state", "processing");
+  }
+  _reset(t = !1) {
+    this._isCancelled = t, this._set("liveTranscript", ""), this._set("transcript", ""), this._set("errorCode", void 0), this._set("state", "idle");
+  }
+  start() {
+    if (!this._recognition) {
+      this._set("errorCode", "not-supported");
+      return;
+    }
+    this._reset(!1);
+    try {
+      this._recognition.start();
+    } catch {
+      this._set("errorCode", "unhandled");
+    }
+  }
+  stop() {
+    if (this._recognition) {
+      this._set("state", "processing");
+      try {
+        this._recognition.stop();
+      } catch {
+      }
+    }
+  }
+  cancel() {
+    if (this._recognition) {
+      this._reset(!0);
+      try {
+        this._recognition.abort();
+      } catch {
+      }
+    }
+  }
+  static isSupported() {
+    return !!b();
+  }
+};
+_ = $([
+  f("WebSpeechController")
+], _);
+function m(t) {
+  const { baseValue: e, transcript: s } = t;
+  if (!s)
+    return e;
+  const i = e.trim();
+  return i ? `${i} ${s}` : s;
+}
+class E extends w {
+  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();
+  }
+  static {
+    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;
+  }
+  #e;
+  get _state() {
+    return this._speechController?.state ?? "idle";
+  }
+  get _errorCode() {
+    return this._speechController?.errorCode ?? null;
+  }
+  get _liveTranscript() {
+    return this._speechController?.liveTranscript ?? "";
+  }
+  get _transcript() {
+    return this._speechController?.transcript ?? "";
+  }
+  get _isButtonDisabled() {
+    return this._resolvedMode === "disabled" || this.awaitingResponse || this._state === "processing";
+  }
+  get _buttonLabel() {
+    if (this.awaitingResponse)
+      return "Voice input unavailable while assistant is responding";
+    if (this._resolvedMode === "disabled")
+      return "Voice input unavailable";
+    switch (this._state) {
+      case "error":
+        return this._errorCode === "not-allowed" ? "Microphone permission denied. Retry voice input" : "Retry voice input";
+      case "listening":
+        return "Stop voice input";
+      case "processing":
+        return "Processing voice input";
+      default:
+        return "Start voice input";
+    }
+  }
+  clearDraftSession() {
+    this.#e = null;
+  }
+  loaded() {
+    this.manager.onLifecycle(() => [
+      p(() => [this.mode, this.language], () => {
+        this._configureController();
+      }, { initial: !0 }),
+      p(() => this.awaitingResponse, (e) => {
+        e && this._cancelActiveSession();
+      }, { initial: !0 }),
+      p(() => this._liveTranscript, (e) => {
+        if (e) {
+          const s = h(`${this._transcript} ${e}`);
+          this.arcgisVoiceInputInterimTranscription.emit({ transcript: s }), this._applyVoiceInputTranscript(s);
+        }
+      }),
+      p(() => this._transcript, (e) => {
+        e && (this.arcgisVoiceInputTranscription.emit({ transcript: e }), this._applyVoiceInputTranscript(e, { final: !0 }));
+      }),
+      p(() => this._state, (e) => {
+        e === "error" && this._errorCode && this.arcgisVoiceInputError.emit({ errorCode: this._errorCode });
+      })
+    ]);
+  }
+  disconnectedCallback() {
+    super.disconnectedCallback(), this._destroySpeechController();
+  }
+  _configureController() {
+    const e = this._resolveMode();
+    this._destroySpeechController(), this._resolvedMode = e, e !== "disabled" && (this._speechController = e === "web-speech" ? new _({
+      language: this.language
+    }) : new c({
+      language: this.language,
+      handleRecording: this._handleRecording.bind(this)
+    }));
+  }
+  _destroySpeechController() {
+    this._speechController?.cancel(), this._speechController?.destroy(), this._speechController = void 0;
+  }
+  _emitDraftChange(e, s) {
+    this.arcgisVoiceInputDraftChange.emit({
+      focusInput: s?.focusInput,
+      value: e
+    });
+  }
+  _startVoiceInputSession() {
+    this.#e = {
+      baseValue: this.inputValue.trim(),
+      phase: "listening",
+      transcript: ""
+    };
+  }
+  _finishVoiceInputSession() {
+    const e = this.#e;
+    if (!e) {
+      this._emitDraftChange(this.inputValue.trim());
+      return;
+    }
+    const s = { ...e, phase: "stopped" }, i = m(s);
+    this.#e = s, this._emitDraftChange(i);
+  }
+  async _applyVoiceInputTranscript(e, s) {
+    const i = this.#e;
+    if (!e || !i)
+      return;
+    if (i.phase === "stopped") {
+      const o = m(i);
+      if (this.inputValue.trim() !== o) {
+        this.clearDraftSession();
+        return;
+      }
+    }
+    const r = { ...i, transcript: e }, n = m(r);
+    this.#e = r, this._emitDraftChange(n, {
+      focusInput: s?.final && r.phase === "stopped"
+    });
+  }
+  async _handleToggle() {
+    if (!(this._isButtonDisabled || !this._speechController)) {
+      if (this._state === "listening") {
+        this._speechController.stop(), this._finishVoiceInputSession(), this.arcgisVoiceInputStop.emit();
+        return;
+      }
+      this._speechController.start(), this._startVoiceInputSession(), this.arcgisVoiceInputStart.emit();
+    }
+  }
+  async _handleRecording(e, s, i, r) {
+    let n;
+    return this.arcgisVoiceInputTranscriptionStreamChunk.emit({
+      blob: e,
+      chunkIndex: i,
+      isFinal: r,
+      mimeType: s,
+      respondWithTranscript: (o) => {
+        n = o;
+      }
+    }), n;
+  }
+  _resolveMode() {
+    return this.mode === "disabled" ? "disabled" : this.mode === "web-speech" && _.isSupported() ? "web-speech" : c.isSupported() ? "media-recorder" : "disabled";
+  }
+  async _cancelActiveSession() {
+    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=${() => {
+      this._handleToggle();
+    }}></calcite-button>`;
+  }
+}
+S("arcgis-assistant-speech-input", E);
+export {
+  E as ArcgisAssistantSpeechInput
+};

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

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

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

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

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

@@ -0,0 +1,20 @@
+export type VoiceInputMode = "disabled" | "media-recorder" | "web-speech";
+
+export type VoiceInputErrorCode = "no-speech" | "not-allowed" | "not-supported" | "recording-failed" | "transcription-failed" | "transcription-unavailable" | "unhandled";
+
+export type VoiceInputTranscriptDetail = {
+  transcript: string;
+};
+
+export type VoiceInputDraftChangeDetail = {
+  focusInput?: boolean;
+  value: string;
+};
+
+export type VoiceInputTranscriptionStreamChunkDetail = {
+  blob: Blob;
+  chunkIndex: number;
+  isFinal: boolean;
+  mimeType: string;
+  respondWithTranscript: (transcript: string) => void;
+};

package/dist/components/arcgis-assistant-suggested-prompts/customElement.d.ts

@@ -0,0 +1,16 @@
+/// <reference path="../../index.d.ts" />
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { AssistantPromptSelectDetail } from "../arcgis-assistant/types.js";
+import type { T9nMeta } from "@arcgis/lumina/controllers";
+
+/** A prompt chip list primitive for rendering assistant suggested prompts. */
+export abstract class ArcgisAssistantSuggestedPrompts extends LitElement {
+  /** @internal */
+  protected _messages: { suggestedPromptsLabel: string; } & T9nMeta<{ suggestedPromptsLabel: string; }>;
+  accessor label: string | undefined;
+  accessor prompts: string[];
+  readonly arcgisPromptSelect: import("@arcgis/lumina").TargetedEvent<this, AssistantPromptSelectDetail>;
+  readonly "@eventTypes": {
+    arcgisPromptSelect: ArcgisAssistantSuggestedPrompts["arcgisPromptSelect"]["detail"];
+  };
+}