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

package/dist/chunks/resolvePointGeometryFilter.js

@@ -0,0 +1,92 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import l from "@arcgis/core/geometry/Point.js";
+import * as f from "@arcgis/core/geometry/operators/unionOperator.js";
+import r from "zod";
+const d = 750;
+function m(e) {
+  return "point" in e && e.point !== void 0;
+}
+function y(e) {
+  return "layerId" in e && e.layerId !== void 0;
+}
+const v = async (e, n) => {
+  if (m(e)) {
+    const { point: t } = e;
+    return { geometry: new l({
+      x: t.x,
+      y: t.y,
+      spatialReference: t.spatialReference ? { wkid: t.spatialReference.wkid } : n.spatialReference
+    }) };
+  }
+  if (y(e)) {
+    const t = n.map?.allLayers.find(
+      (o) => o.id === e.layerId
+    );
+    if (!t)
+      return { error: `Could not find geometry layer with ID: ${e.layerId}` };
+    const a = t.title ?? t.id, s = e.where?.trim() || "1=1";
+    try {
+      const o = await t.queryFeatures({
+        where: s,
+        returnGeometry: !0,
+        outSpatialReference: n.spatialReference,
+        num: d + 1
+      });
+      if (!o.features.length)
+        return {
+          error: `No features found in geometry layer "${a}" with the specified where clause: ${s}`
+        };
+      if (o.features.length > d)
+        return {
+          error: `Geometry filter for layer "${a}" matched too many features (${o.features.length}+). Please narrow the geometry layer filter.`
+        };
+      const i = o.features.map((c) => c.geometry).filter((c) => !!c);
+      if (!i.length)
+        return { error: "No valid geometries found for the matched geometry layer features." };
+      const u = i.length === 1 ? i[0] : f.executeMany(i);
+      return u ? (u.spatialReference || (u.spatialReference = n.spatialReference), { geometry: u }) : { error: "Failed to combine geometries from geometry layer." };
+    } catch (o) {
+      return { error: `Failed to query geometry: ${String(o)}` };
+    }
+  }
+  return { error: "Invalid geometry configuration provided" };
+}, h = ["feet", "kilometers", "meters", "miles", "nautical-miles", "us-nautical-miles"], p = r.enum(h), b = r.object({ id: r.string() }), R = r.object({
+  id: r.string(),
+  kind: r.literal("point"),
+  payload: r.object({
+    x: r.number(),
+    y: r.number(),
+    spatialReference: r.object({ wkid: r.number() }).optional()
+  })
+}), S = r.object({
+  sharedResourceId: r.string().describe("ID of a point returned by listSharedResources for a previously geocoded address or place."),
+  distance: r.number().optional().describe("Optional buffer distance around the point."),
+  units: p.optional().describe("The units for the distance buffer.")
+}), g = (e, n) => {
+  if (!e || !("sharedResourceId" in e))
+    return e;
+  if (!n)
+    throw new Error("Shared resources are unavailable in the tool runtime state.");
+  const t = n.find((s) => {
+    const o = b.safeParse(s);
+    return o.success && o.data.id === e.sharedResourceId;
+  });
+  if (!t)
+    throw new Error(`Shared resource not found: ${e.sharedResourceId}`);
+  const a = R.safeParse(t);
+  if (!a.success)
+    throw new Error(`Shared resource ${e.sharedResourceId} does not contain a valid point.`);
+  return {
+    point: a.data.payload,
+    distance: e.distance,
+    units: e.units
+  };
+};
+export {
+  m as a,
+  p as d,
+  v as g,
+  y as i,
+  g as r,
+  S as s
+};

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

@@ -1,55 +1,47 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { Annotation as s } from "@langchain/langgraph/web";
-const c = /* @__PURE__ */ new Set(["agentExecutionContext", "outputMessage", "summary", "status"]);
-function u() {
-  return {
-    assignedTask: "",
-    messages: [],
-    priorSteps: [],
-    sharedState: {},
-    userRequest: ""
-  };
-}
-function i(r) {
-  const n = [...new Set([...r].filter((t) => c.has(t)))];
+import { Annotation as o } from "@langchain/langgraph/web";
+import { c } from "./baseAgentState.js";
+const i = /* @__PURE__ */ new Set(["agentExecutionContext", "outputMessage", "summary", "status"]);
+function u(r) {
+  const n = [...new Set([...r].filter((t) => i.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);
   return Object.fromEntries(
     n.map(([t, e]) => [
       t,
-      s({
-        reducer: (o, a) => a,
+      o({
+        reducer: (s, a) => a,
         default: () => e
       })
     ])
   );
 }
 function m(r = {}) {
-  i(Object.keys(r));
+  u(Object.keys(r));
   const n = f(r);
-  return s.Root({
+  return o.Root({
     ...n,
-    agentExecutionContext: s({
+    agentExecutionContext: o({
       reducer: (t, e) => ({
         ...t,
         ...e
       }),
-      default: u
+      default: c
     }),
-    outputMessage: s({
+    outputMessage: o({
       // Preserve the last meaningful user-facing message produced by the graph.
       reducer: (t = "", e) => typeof e == "string" && e.trim() ? e : t,
       default: () => ""
     }),
-    summary: s({
+    summary: o({
       // Summary is a compact orchestrator-facing outcome, so replacement semantics are enough.
       reducer: (t = "", e) => typeof e == "string" ? e : t,
       default: () => ""
     }),
-    status: s({
+    status: o({
       // Keep the first meaningful status until a later node explicitly replaces it.
       reducer: (t, e) => e ?? t,
       default: () => {
@@ -57,15 +49,17 @@ function m(r = {}) {
     })
   });
 }
-function l(r) {
+function g(r) {
   const n = /* @__PURE__ */ new Set();
   for (const e of r)
-    for (const o of Object.keys(e.shape ?? {}))
-      n.add(o);
+    for (const s of Object.keys(e.shape ?? {}))
+      n.add(s);
   const t = Object.fromEntries([...n].map((e) => [e, void 0]));
   return m(t);
 }
 export {
   m as a,
-  l as c
+  u as b,
+  g as c,
+  f as d
 };

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

@@ -1,29 +1,33 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import "@arcgis/core/identity/IdentityManager.js";
 import "@arcgis/core/portal/Portal.js";
+import "@arcgis/core/request.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/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";
-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 x = 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
+  x 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) {
@@ -40,8 +40,8 @@ function v(e) {
   return t ? t.view : null;
 }
 export {
-  g as a,
-  v as b,
-  w as i,
+  v as a,
+  w as b,
+  g as i,
   m as r
 };

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

@@ -1,5 +1,6 @@
 /// <reference path="../../index.d.ts" />
 import type Collection from "@arcgis/core/core/Collection.js";
+import type { RuntimeSpanEvent } from "../../orchestrator/orchestrator/orchestratorEvents.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { AssistantMessage, AssistantPromptSelectDetail, AssistantSlottableRequestDetail, ChatMessage, Interrupt } from "./types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
@@ -41,6 +42,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.
@@ -84,11 +90,64 @@ export abstract class ArcgisAssistant extends LitElement {
       assistantLabel: string;
       stopButtonLabel: string;
       askButtonLabel: string;
+      stoppedByUserLabel: string;
+      noAgentsFoundMessage: string;
+      orchestratorInitializationErrorMessage: string;
+      signInErrorMessage: string;
+      signInRequiredMessage: string;
+      signInLabel: string;
+      signInToArcGISOnlineLabel: string;
+      noPortalInformationMessage: string;
+      readMoreLabel: string;
+      learnAboutWebMapEmbeddingsLabel: string;
+      waitingForUserInputMessage: string;
   } & T9nMeta<{
       assistantLabel: string;
       stopButtonLabel: string;
       askButtonLabel: string;
+      stoppedByUserLabel: string;
+      noAgentsFoundMessage: string;
+      orchestratorInitializationErrorMessage: string;
+      signInErrorMessage: string;
+      signInRequiredMessage: string;
+      signInLabel: string;
+      signInToArcGISOnlineLabel: string;
+      noPortalInformationMessage: string;
+      readMoreLabel: string;
+      learnAboutWebMapEmbeddingsLabel: string;
+      waitingForUserInputMessage: string;
   }>;
+  /**
+   * The IDs of the agents available to automatic intent routing.
+   * A single ID still uses automatic routing and does not enable direct routing.
+   * This property cannot be used together with [alwaysUseAgentId](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/#alwaysUseAgentId).
+   *
+   * @since 5.2
+   * @example
+   * ```js
+   * const assistant = document.querySelector("arcgis-assistant");
+   * assistant.allowedAgentIds = ["navigation", "help"];
+   * ```
+   */
+  accessor allowedAgentIds: readonly string[] | undefined;
+  /**
+   * The ID of the agent that should process every user message without intent routing.
+   * When this property is set, it cannot be used together with [allowedAgentIds](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/#allowedAgentIds).
+   *
+   * @since 5.2
+   * @example
+   * ```html
+   * <arcgis-assistant always-use-agent-id="navigation"></arcgis-assistant>
+   * ```
+   */
+  accessor alwaysUseAgentId: string | undefined;
+  /**
+   * When `true`, displays 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 +329,21 @@ export abstract class ArcgisAssistant extends LitElement {
    * ```
    */
   accessor referenceElement: ArcgisMap | string | null;
+  /**
+   * When `true`, emits normalized runtime span events while processing requests.
+   *
+   * @default false
+   * @internal
+   * @since 5.2
+   */
+  accessor runtimeEventsEnabled: boolean;
+  /**
+   * 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
@@ -291,6 +365,13 @@ export abstract class ArcgisAssistant extends LitElement {
    * ```
    */
   accessor suggestedPrompts: string[];
+  /**
+   * When `true`, displays the user avatar in the chat interface.
+   *
+   * @default false
+   * @since 5.2
+   */
+  accessor userAvatarEnabled: boolean;
   /**
    * Cancels the active interrupt, if one is pending.
    *
@@ -454,6 +535,19 @@ 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 for each normalized runtime span lifecycle event produced while processing a request.
+   *
+   * @internal
+   */
+  readonly arcgisRuntime: import("@arcgis/lumina").TargetedEvent<this, RuntimeSpanEvent>;
   /**
    * Emitted when the assistant requests custom slotted content for an assistant message.
    *
@@ -508,6 +602,8 @@ export abstract class ArcgisAssistant extends LitElement {
     arcgisInterruptSubmit: ArcgisAssistant["arcgisInterruptSubmit"]["detail"];
     arcgisPromptSelect: ArcgisAssistant["arcgisPromptSelect"]["detail"];
     arcgisReady: ArcgisAssistant["arcgisReady"]["detail"];
+    arcgisResponse: ArcgisAssistant["arcgisResponse"]["detail"];
+    arcgisRuntime: ArcgisAssistant["arcgisRuntime"]["detail"];
     arcgisSlottableRequest: ArcgisAssistant["arcgisSlottableRequest"]["detail"];
     arcgisSubmit: ArcgisAssistant["arcgisSubmit"]["detail"];
   };