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

package/dist/chunks/slottableRequestUtils.js

@@ -1,11 +1,7 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-function a(e) {
-  return `message-${e}`;
-}
-function o(e, t) {
-  return `block-${e}-${t}`;
+function e(o, t) {
+  return `block-${o}-${t}`;
 }
 export {
-  o as a,
-  a as g
+  e as g
 };

package/dist/chunks/state.js

@@ -13,7 +13,7 @@ function u() {
 function i(r) {
   const n = [...new Set([...r].filter((t) => c.has(t)))];
   if (n.length !== 0)
-    throw new Error(`ADK custom state cannot define reserved runtime fields: ${n.join(", ")}.`);
+    throw new Error(`custom state cannot define reserved runtime fields: ${n.join(", ")}.`);
 }
 function f(r) {
   const n = Object.entries(r);

package/dist/chunks/summarize_query_response_prompt.js

@@ -22,13 +22,15 @@ Use chat history only when necessary to understand conversational references, an
 
 ### Your goal:
 
-1. If the assigned task is about a **specific calculation** (e.g., average, total, count, min, max), return only the **direct numeric answer** — short and clear.
-   - Example: “The average price is $4.00.”
-   - When a value is already present in \`queryResponse\` (for example in \`details.value\` or \`summary\`), copy that value **verbatim**.
-   - Do NOT reformat values (including numbers, dates, and times):
-     - Do not add/remove grouping commas.
-     - Do not change decimals, round values, or change numeric type/text.
-     - Do not change date/time format, timezone notation, separators, or precision.
+1. If the assigned task is about a **specific calculation** (e.g., average, total, count, min, max), return a **single concise sentence** that includes the numeric result.
+
+- Example: “The average price is $4.00.”
+- Never return a bare number by itself (for example: \`4\`).
+- When a value is already present in \`queryResponse\` (for example in \`details.value\` or \`summary\`), copy that value **verbatim**.
+- Do NOT reformat values (including numbers, dates, and times):
+  - Do not add/remove grouping commas.
+  - Do not change decimals, round values, or change numeric type/text.
+  - Do not change date/time format, timezone notation, separators, or precision.
 
 2. If the question is more general or there are **multiple features with varying attributes**, write a **brief summary** (2–3 sentences max) that highlights key patterns or insights.
 

package/dist/chunks/toolCallResponse.js

@@ -2,28 +2,31 @@
 import "@arcgis/core/identity/IdentityManager.js";
 import "@arcgis/core/portal/Portal.js";
 import "@langchain/langgraph/web";
-import { s as r } from "./generateLayerDescriptions.js";
+import "@arcgis/toolkit/string";
+import "./generateLayerDescriptions.js";
 import "@langchain/core/messages";
+import { s as a } from "./index.js";
 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";
-const u = async (t, o) => {
-  const a = t.tool_calls ?? [];
-  if (a.length === 0) {
-    await r({ text: `LLM did not request any tool calls: ${String(t?.content)}` }, o);
+const L = async (t, o) => {
+  const i = t.tool_calls ?? [];
+  if (i.length === 0) {
+    await a({ text: `LLM did not request any tool calls: ${String(t?.content)}` }, o);
     return;
   }
   await Promise.all(
-    a.map(
-      async (i) => await r(
-        { text: `LLM invoked ${i.name} tool with arguments: ${JSON.stringify(i.args, null, 2)}` },
+    i.map(
+      async (r) => await a(
+        { text: `LLM invoked ${r.name} tool with arguments: ${JSON.stringify(r.args, null, 2)}` },
         o
       )
     )
   );
 };
 export {
-  u as h
+  L as h
 };

package/dist/chunks/utils2.js

@@ -1,11 +1,11 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { getClosestElement as i } from "@arcgis/toolkit/dom";
-import { g as r, a as o } from "./utils3.js";
+import { g as s, a as o } from "./utils3.js";
 function c(e, t) {
-  const s = r(e.el, e.referenceElement);
-  if (s)
-    return s;
-  const n = i(e.el, "arcgis-assistant"), a = r(e.el, n?.referenceElement);
+  const r = s(e.el, e.referenceElement);
+  if (r)
+    return r;
+  const n = i(e.el, "arcgis-assistant"), a = s(e.el, n?.referenceElement);
   if (a)
     return a;
   throw new Error(`${t}: Reference element not found`);
@@ -23,16 +23,16 @@ function g(e) {
   const t = i(e.el, "arcgis-assistant");
   if (t === void 0)
     throw new Error("arcgis-assistant-agent must be used within an arcgis-assistant element");
-  t.register({
+  return t.register({
     agent: e.agent,
     getContext: async () => await e.getContext?.() ?? e.context ?? {}
-  });
+  }), t;
 }
 function l(e) {
   const t = o(e.el, e.referenceElement);
   if (t)
     return t;
-  const s = i(e.el, "arcgis-assistant"), n = r(e.el, s?.referenceElement);
+  const r = i(e.el, "arcgis-assistant"), n = s(e.el, r?.referenceElement);
   return n || null;
 }
 function v(e) {

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

@@ -41,6 +41,11 @@ import type { ArcgisMap as ArcgisMap } from "@arcgis/map-components/components/a
  * for the included ArcGIS agents to function properly, as they rely on the map context to perform their tasks. This is not
  * a requirement for [custom agents](https://developers.arcgis.com/javascript/latest/agentic-apps/ai-custom-agents/).
  *
+ * ## Application Identification
+ * For applications that use the arcgis-assistant component, setting the [`applicationName`](https://developers.arcgis.com/javascript/latest/references/core/config/#Config-applicationName) property on the ArcGIS config object [`esriConfig`](https://developers.arcgis.com/javascript/latest/references/core/config/) is recommended.
+ * When provided, this value can help associate assistant activity and feedback with a specific application, where supported.
+ * This can make it easier to understand usage patterns and troubleshoot feedback.
+ *
  * ## Context
  *
  * Use the [referenceElement](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/#referenceElement) property to provide a web map as context to the assistant and its agents.
@@ -89,6 +94,13 @@ export abstract class ArcgisAssistant extends LitElement {
       stopButtonLabel: string;
       askButtonLabel: string;
   }>;
+  /**
+   * When `true`, disables the assistant avatar in the chat interface.
+   *
+   * @default false
+   * @since 5.1
+   */
+  accessor assistantAvatarEnabled: boolean;
   /**
    * Indicates whether the assistant is currently processing a user message.
    * This value is `true` while the assistant is generating a response and `false` when idle.
@@ -270,6 +282,13 @@ export abstract class ArcgisAssistant extends LitElement {
    * ```
    */
   accessor referenceElement: ArcgisMap | string | null;
+  /**
+   * When `true`, assistant text responses render after completion instead of streaming progressively.
+   *
+   * @default false
+   * @since 5.1
+   */
+  accessor streamingDisabled: boolean;
   /**
    * Prompts to suggest to the end user on load. These are intended to help users understand which questions they can ask.
    * This property should be set to establish boundaries for the end user. As all agents have limitations and LLMs can
@@ -454,6 +473,13 @@ export abstract class ArcgisAssistant extends LitElement {
    * ```
    */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
+  /**
+   * Emitted when the assistant generates a response to a user message. The event detail includes an AssistantMessage object that contains the assistant's response,
+   * along with any relevant logs or errors. This allows app developers to capture the assistant's responses.
+   *
+   * @since 5.1
+   */
+  readonly arcgisResponse: import("@arcgis/lumina").TargetedEvent<this, AssistantMessage>;
   /**
    * Emitted when the assistant requests custom slotted content for an assistant message.
    *
@@ -508,6 +534,7 @@ export abstract class ArcgisAssistant extends LitElement {
     arcgisInterruptSubmit: ArcgisAssistant["arcgisInterruptSubmit"]["detail"];
     arcgisPromptSelect: ArcgisAssistant["arcgisPromptSelect"]["detail"];
     arcgisReady: ArcgisAssistant["arcgisReady"]["detail"];
+    arcgisResponse: ArcgisAssistant["arcgisResponse"]["detail"];
     arcgisSlottableRequest: ArcgisAssistant["arcgisSlottableRequest"]["detail"];
     arcgisSubmit: ArcgisAssistant["arcgisSubmit"]["detail"];
   };