@arcgis/ai-components 5.2.0-next.11 → 5.2.0-next.110

package/dist/chunks/requireAgentServices.js

@@ -0,0 +1,11 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
+const t = (r, s) => (o, i) => {
+  const c = i?.configurable?.services;
+  for (const e of r)
+    if (!c?.[e])
+      throw new Error(`${s} requires services.${e} to be available.`);
+  return o;
+};
+export {
+  t as r
+};

package/dist/chunks/resolvePointGeometryFilter.js

@@ -0,0 +1,92 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
+import l from "@arcgis/core/geometry/Point.js";
+import * as f from "@arcgis/core/geometry/operators/unionOperator.js";
+import r from "zod";
+import { distanceUnitsSchema as m } from "../agents/tools/shared/types.js";
+const d = 750;
+function y(e) {
+  return "point" in e && e.point !== void 0;
+}
+function h(e) {
+  return "layerId" in e && e.layerId !== void 0;
+}
+const v = async (e, n) => {
+  if (y(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 (h(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" };
+}, p = r.object({ id: r.string() }), b = 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: m.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 = p.safeParse(s);
+    return o.success && o.data.id === e.sharedResourceId;
+  });
+  if (!t)
+    throw new Error(`Shared resource not found: ${e.sharedResourceId}`);
+  const a = b.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 {
+  y as a,
+  v as g,
+  h as i,
+  g as r,
+  S as s
+};

package/dist/chunks/runtime.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import "../cdn/main.css";
 import { makeRuntime as e } from "@arcgis/lumina";
 import { trackAccess as s, createObservable as a, createTrackingTarget as r, runTracked as c } from "@arcgis/core/applications/Components/reactiveUtils.js";

package/dist/chunks/slottableRequestUtils.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 function e(o, t) {
   return `block-${o}-${t}`;
 }

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)))];
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
+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

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 const e = `## Task: Summarize Geographic Features
 
 You are given features from ArcGIS Feature layer for multiple layers:  

package/dist/chunks/useT9n.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import { makeT9nController as o } from "@arcgis/lumina/controllers";
 import { g as t } from "./runtime.js";
 const s = o(t);

package/dist/chunks/utils.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import { AIMessage as i } from "@langchain/core/messages";
 function p(e, s, t) {
   return {

package/dist/chunks/utils2.js

@@ -1,11 +1,11 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/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/chunks/utils3.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import { getClosestElement as s } from "@arcgis/toolkit/dom";
 function l(t, o) {
   return o ? typeof o == "string" ? u(t, o) ?? null : o : s(t, "arcgis-map") ?? null;

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,13 +90,79 @@ 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;
   }>;
   /**
-   * When `true`, disables the assistant avatar in the chat interface.
+   * The IDs of the agents available for 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).
+   * If this property is not set, all registered agents are available for routing.
+   *
+   * > **Note:** Agent ids for custom agents are automatically created from the agent's
+   * > [BaseAgent.name](https://developers.arcgis.com/javascript/latest/references/ai-components/agent-utils/BaseAgent/#name) property.
+   * > For example, an agent with the name "My Custom Agent" will have the id "my-custom-agent".
+   *
+   * Agent ids for SDK agents are as follows:
+   *
+   * - Navigation Agent: `navigation`
+   * - Data Exploration Agent: `dataExploration`
+   * - Help Agent: `help`
+   * - Knowledge Agent: `arcgisKnowledge`
+   *
+   * @since 5.2
+   * @example
+   * ```js
+   * const assistant = document.querySelector("arcgis-assistant");
+   * // only route user questions to either the navigation or help agents
+   * // even if other agents are registered to the 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 set, the assistant will route all user messages to the specified agent.
+   *
+   * This is useful for applications that want to bypass the orchestrator's default intent routing
+   * in favor of a single custom agent that directly handles its own intent orchestration to one or more sub-agents. This property
+   * should not be used to route requests to an SDK agent, as the SDK agents do not have their own intent routing outside of the orchestrator.
+   *
+   * This property 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="my-custom-orchestration-agent"></arcgis-assistant>
+   * ```
+   */
+  accessor alwaysUseAgentId: string | undefined;
+  /**
+   * When `true`, displays the assistant avatar in the chat interface.
    *
    * @default false
    * @since 5.1
@@ -277,6 +349,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
@@ -298,6 +385,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.
    *
@@ -468,6 +562,12 @@ export abstract class ArcgisAssistant extends LitElement {
    * @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.
    *
@@ -523,6 +623,7 @@ export abstract class ArcgisAssistant extends LitElement {
     arcgisPromptSelect: ArcgisAssistant["arcgisPromptSelect"]["detail"];
     arcgisReady: ArcgisAssistant["arcgisReady"]["detail"];
     arcgisResponse: ArcgisAssistant["arcgisResponse"]["detail"];
+    arcgisRuntime: ArcgisAssistant["arcgisRuntime"]["detail"];
     arcgisSlottableRequest: ArcgisAssistant["arcgisSlottableRequest"]["detail"];
     arcgisSubmit: ArcgisAssistant["arcgisSubmit"]["detail"];
   };