@arcgis/ai-components 5.2.0-next.104 → 5.2.0-next.106

package/dist/chunks/layerStylingGraph.js

@@ -4,9 +4,9 @@ import "@arcgis/core/identity/IdentityManager.js";
 import "@arcgis/core/portal/Portal.js";
 import "@arcgis/core/request.js";
 import "@arcgis/toolkit/string";
-import { h as v } from "./generateLayerDescriptions.js";
+import { i as v } from "./generateLayerDescriptions.js";
 import "@langchain/core/messages";
-import { s as i } from "./index.js";
+import { s } from "./index.js";
 import "@langchain/core/callbacks/base";
 import "@langchain/openai";
 import "@arcgis/core/config.js";
@@ -14,20 +14,34 @@ import "@arcgis/core/core/reactiveUtils.js";
 import "@arcgis/core/layers/FeatureLayer.js";
 import "@langchain/core/prompts";
 import { f as g } from "./fetchService.js";
-import { m as I, n as T, o as R, p as F, u as C, v as A, w as $, x as N, y as b, z as q, A as _, g as M, r as k, L as S } from "./adapter.js";
-import { h as V } from "./toolCallResponse.js";
-import { ToolNode as j } from "@langchain/langgraph/prebuilt";
-const h = 0.7, z = 10, P = async (t, e) => {
+import { j as I, k as T, l as R, m as F, n as $, o as C, p as A, r as N, u as q, v as M, w as _, e as b, L as S } from "./adapter.js";
+import { ToolNode as k } from "@langchain/langgraph/prebuilt";
+import { r as j } from "./requireAgentServices.js";
+const P = async (r, e) => {
+  const t = r.tool_calls ?? [];
+  if (t.length === 0) {
+    await s({ text: `LLM did not request any tool calls: ${String(r?.content)}` }, e);
+    return;
+  }
+  await Promise.all(
+    t.map(
+      async (a) => await s(
+        { text: `LLM invoked ${a.name} tool with arguments: ${JSON.stringify(a.args, null, 2)}` },
+        e
+      )
+    )
+  );
+}, h = 0.7, V = 10, z = async (r, e) => {
   try {
-    await i({ text: "Similarity search to find fields" }, e);
-    const r = g(e, "fieldSearch"), a = g(e, "layersAndFieldsRegistry"), o = g(e, "embeddingCache"), n = await r.searchFields({
-      text: t.agentExecutionContext.assignedTask,
-      layerIds: t.vectorSearchLayerIds,
+    await s({ text: "Similarity search to find fields" }, e);
+    const t = g(e, "fieldSearch"), a = g(e, "layersAndFieldsRegistry"), o = g(e, "embeddingCache"), n = await t.searchFields({
+      text: r.agentExecutionContext.assignedTask,
+      layerIds: r.vectorSearchLayerIds,
       minScore: h,
-      topResults: z,
+      topResults: V,
       embeddingCache: o
     }), c = n.map(({ layerId: d, results: p }) => {
-      const y = p.map((s) => `  - ${s.name} (${s.score.toFixed(2)})`).join(`
+      const y = p.map((i) => `  - ${i.name} (${i.score.toFixed(2)})`).join(`
 `);
       return `${a.get(d)?.layerItem.name ?? d}:
 ${y}`;
@@ -35,128 +49,128 @@ ${y}`;
 `);
     let l;
     return n.length > 0 ? l = `Vector search completed. Matching layers and fields with scores:
-${c}` : l = `No vector search results found for score over ${h}.`, await i({ text: l }, e), {
-      ...t,
+${c}` : l = `No vector search results found for score over ${h}.`, await s({ text: l }, e), {
+      ...r,
       vectorSearchFieldResults: n
     };
-  } catch (r) {
-    throw await i(
-      { text: `Error during vector search: ${r instanceof Error ? r.message : String(r)}` },
+  } catch (t) {
+    throw await s(
+      { text: `Error during vector search: ${t instanceof Error ? t.message : String(t)}` },
       e
-    ), new Error(`Vector search failed: ${r instanceof Error ? r.message : String(r)}`);
+    ), new Error(`Vector search failed: ${t instanceof Error ? t.message : String(t)}`);
   }
-}, D = 0.7, H = async (t, e) => {
+}, D = 0.7, H = async (r, e) => {
   try {
-    await i(
-      { text: `Similarity search to find layers: ${t.agentExecutionContext.assignedTask}` },
+    await s(
+      { text: `Similarity search to find layers: ${r.agentExecutionContext.assignedTask}` },
       e
     );
-    const r = g(e, "layerSearch"), a = g(e, "layersAndFieldsRegistry"), o = await r.searchLayers({
-      text: t.agentExecutionContext.assignedTask,
+    const t = g(e, "layerSearch"), a = g(e, "layersAndFieldsRegistry"), o = await t.searchLayers({
+      text: r.agentExecutionContext.assignedTask,
       minScore: D
     }), n = o.map((d) => d.id), c = o.map(({ id: d, score: p }) => `${a.get(d)?.layerItem.name ?? d} (${p.toFixed(2)})`).join(`
 `);
     let l;
     return n.length > 0 ? l = `Vector search completed. Matching layers with scores:
-${c}` : l = "Vector search completed. No matching layers found.", await i({ text: l }, e), {
-      ...t,
+${c}` : l = "Vector search completed. No matching layers found.", await s({ text: l }, e), {
+      ...r,
       vectorSearchLayerIds: n
     };
-  } catch (r) {
-    throw await i(
-      { text: `Error during vector search: ${r instanceof Error ? r.message : String(r)}` },
+  } catch (t) {
+    throw await s(
+      { text: `Error during vector search: ${t instanceof Error ? t.message : String(t)}` },
       e
-    ), new Error(`Vector search failed: ${r instanceof Error ? r.message : String(r)}`);
+    ), new Error(`Vector search failed: ${t instanceof Error ? t.message : String(t)}`);
   }
 }, f = [
   I,
   T,
   R,
   F,
+  $,
   C,
   A,
-  $,
   N,
-  b,
   q,
+  M,
   _
-], x = (t, e = 3) => {
-  const r = t.map((o, n) => o.type === "human" ? n : -1).filter((o) => o !== -1);
-  if (r.length === 0)
+], x = (r, e = 3) => {
+  const t = r.map((o, n) => o.type === "human" ? n : -1).filter((o) => o !== -1);
+  if (t.length === 0)
     return [];
-  const a = r.length > e ? r[r.length - e] : r[0];
-  return t.slice(a);
-}, G = async (t, e) => {
-  await i({ text: "Requesting LLM for layer query results" }, e);
-  const r = await M("navigation_intent_prompt");
+  const a = t.length > e ? t[t.length - e] : t[0];
+  return r.slice(a);
+}, G = async (r, e) => {
+  await s({ text: "Requesting LLM for layer query results" }, e);
+  const t = await b("navigation_intent_prompt");
   if (!e?.configurable)
     throw new Error("config.configurable is required for layer query tools");
   const a = {
-    layerFieldInfo: t.layerFieldInfo
+    layerFieldInfo: r.layerFieldInfo
   }, o = await v({
-    promptText: r,
+    promptText: t,
     modelTier: "advanced",
     config: e,
-    messages: x(t.agentExecutionContext.messages),
+    messages: x(r.agentExecutionContext.messages),
     inputVariables: a,
     tools: f
   });
-  return await V(o, e), {
-    ...t,
+  return await P(o, e), {
+    ...r,
     agentExecutionContext: {
-      ...t.agentExecutionContext,
-      messages: [...t.agentExecutionContext.messages, o]
+      ...r.agentExecutionContext,
+      messages: [...r.agentExecutionContext.messages, o]
     }
   };
 };
-async function U(t, e) {
-  const a = await new j(f, { handleToolErrors: !1 }).invoke(
+async function O(r, e) {
+  const a = await new k(f, { handleToolErrors: !1 }).invoke(
     {
-      messages: x(t.agentExecutionContext.messages)
+      messages: x(r.agentExecutionContext.messages)
     },
     e
   ), o = a.messages.map((c) => c.text).join(`
 `);
-  await i({ text: `Finished executing layer filter tool: ${o}` }, e);
+  await s({ text: `Finished executing layer filter tool: ${o}` }, e);
   const n = a.messages.map((c) => c.text).join(`
 `);
-  return { ...t, outputMessage: n };
+  return { ...r, outputMessage: n };
 }
-const B = async (t, e) => (await i({ text: "Exiting Layer Styling agent" }, e), t), O = async (t, e) => {
+const U = async (r, e) => (await s({ text: "Exiting Layer Styling agent" }, e), r), B = async (r, e) => {
   try {
-    await i({ text: "Populating layer and field info" }, e);
-    const r = [];
-    for (const a of t.vectorSearchFieldResults) {
+    await s({ text: "Populating layer and field info" }, e);
+    const t = [];
+    for (const a of r.vectorSearchFieldResults) {
       let o = function(y) {
-        const s = l.get(y)?.layerItem;
-        return s ? [
-          s.name && `Name: ${s.name}`,
-          s.title && `Title: ${s.title}`,
-          s.description && `Description: ${s.description}`
+        const i = l.get(y)?.layerItem;
+        return i ? [
+          i.name && `Name: ${i.name}`,
+          i.title && `Title: ${i.title}`,
+          i.description && `Description: ${i.description}`
         ].filter(Boolean).join(" | ") : y;
       };
       const { layerId: n, results: c } = a, l = g(e, "layersAndFieldsRegistry"), d = l.get(n)?.fieldRegistry;
       if (!d)
         continue;
-      let p = r.find((y) => y.layerId === n);
+      let p = t.find((y) => y.layerId === n);
       p || (p = {
         layerId: n,
         layerSummary: o(n),
         fieldInfos: []
-      }, r.push(p));
+      }, t.push(p));
       for (const y of c) {
-        const s = d.get(y.name);
-        s && p.fieldInfos.push(s);
+        const i = d.get(y.name);
+        i && p.fieldInfos.push(i);
       }
     }
-    return await i({ text: "Populated layerFieldInfo" }, e), { ...t, layerFieldInfo: r };
-  } catch (r) {
-    throw await i({ text: "Error populating layerFieldInfo" }, e), new Error(`Error populating layerFieldInfo: ${r instanceof Error ? r.message : String(r)}`);
+    return await s({ text: "Populated layerFieldInfo" }, e), { ...r, layerFieldInfo: t };
+  } catch (t) {
+    throw await s({ text: "Error populating layerFieldInfo" }, e), new Error(`Error populating layerFieldInfo: ${t instanceof Error ? t.message : String(t)}`);
   }
-}, J = (t, e) => {
-  const r = t.vectorSearchLayerIds ?? [];
-  if (r.length <= 1)
-    return { ...t, selectedLayerId: t.vectorSearchLayerIds[0] };
+}, J = (r, e) => {
+  const t = r.vectorSearchLayerIds ?? [];
+  if (t.length <= 1)
+    return { ...r, selectedLayerId: r.vectorSearchLayerIds[0] };
   const { hitlResponse: a } = e.configurable;
   if (a?.agentId !== u.id || a.id !== "reviewLayerSelection") {
     const n = {
@@ -164,16 +178,16 @@ const B = async (t, e) => (await i({ text: "Exiting Layer Styling agent" }, e),
       id: "reviewLayerSelection",
       kind: "singleSelection",
       message: "Choose a layer to apply the styles.",
-      metadata: [...r]
+      metadata: [...t]
     };
     throw new w(n);
   }
   let o = null;
   return Array.isArray(a.payload) && a.payload.length > 0 && (o = a.payload[0]), {
-    ...t,
-    selectedLayerId: o ?? t.vectorSearchLayerIds[0]
+    ...r,
+    selectedLayerId: o ?? r.vectorSearchLayerIds[0]
   };
-}, K = (t, e) => k(["layerSearch", "fieldSearch", "layersAndFieldsRegistry"], "Layer Styling Agent")(t, e), Q = () => new L(S).addNode("requireLayerStylingServices", K).addNode("vectorSearchLayers", H).addNode("layerSelectionHITL", J).addNode("vectorSearchFields", P).addNode("populateLayerFieldInfo", O).addNode("agent", G).addNode("tools", U).addNode("earlyExit", B).addEdge(E, "requireLayerStylingServices").addEdge("requireLayerStylingServices", "vectorSearchLayers").addConditionalEdges(
+}, K = (r, e) => j(["layerSearch", "fieldSearch", "layersAndFieldsRegistry"], "Layer Styling Agent")(r, e), Q = () => new L(S).addNode("requireLayerStylingServices", K).addNode("vectorSearchLayers", H).addNode("layerSelectionHITL", J).addNode("vectorSearchFields", z).addNode("populateLayerFieldInfo", B).addNode("agent", G).addNode("tools", O).addNode("earlyExit", U).addEdge(E, "requireLayerStylingServices").addEdge("requireLayerStylingServices", "vectorSearchLayers").addConditionalEdges(
   "layerSelectionHITL",
   (e) => e.vectorSearchLayerIds.length ? "vectorSearchFields" : "earlyExit"
 ).addConditionalEdges(
@@ -191,5 +205,6 @@ const B = async (t, e) => (await i({ text: "Exiting Layer Styling agent" }, e),
   workspace: S
 };
 export {
-  u as L
+  u as L,
+  P as h
 };

package/dist/chunks/navigationAgent.js

@@ -0,0 +1,40 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { createSkillAgent as n } from "../agents/runtime/skill/createSkillAgent.js";
+import { f as r } from "./fetchAgentContext.js";
+const s = ({ config: a }) => {
+  const { mapView: o } = r(a, ["mapView"]), e = o.map, t = Number.isFinite(o.zoom) ? o.zoom : void 0;
+  return JSON.stringify(
+    {
+      availableBookmarks: e.bookmarks?.map(({ name: i }) => i).filter(Boolean) ?? [],
+      currentZoom: t
+    },
+    null,
+    2
+  );
+}, l = [async () => (await import("./SKILL4.js")).default], m = {
+  findRelevantFields: async () => (await import("../agents/tools/search/findRelevantFields/adapter.js")).findRelevantFieldsTool,
+  findRelevantLayers: async () => (await import("../agents/tools/search/findRelevantLayers/adapter.js")).findRelevantLayersTool,
+  goToAddress: async () => (await import("../agents/tools/navigation/goToAddress/adapter.js")).goToAddressTool,
+  goToBookmark: async () => (await import("../agents/tools/navigation/goToBookmark/adapter.js")).goToBookmarkTool,
+  goToFeatures: async () => (await import("../agents/tools/navigation/goToFeatures/adapter.js")).goToFeaturesTool,
+  goToFullExtent: async () => (await import("../agents/tools/navigation/goToFullExtent/adapter.js")).goToFullExtentTool,
+  goToHomeExtent: async () => (await import("../agents/tools/navigation/goToHomeExtent/adapter.js")).goToHomeExtentTool,
+  goToLayer: async () => (await import("../agents/tools/navigation/goToLayer/adapter.js")).goToLayerTool,
+  goToScale: async () => (await import("../agents/tools/navigation/goToScale/adapter.js")).goToScaleTool,
+  goToViewpoint: async () => (await import("../agents/tools/navigation/goToViewpoint/adapter.js")).goToViewpointTool,
+  goToZoom: async () => (await import("../agents/tools/navigation/goToZoom/adapter.js")).goToZoomTool
+}, p = n({
+  id: "navigation",
+  name: "Navigation Agent",
+  description: "Navigates the map for explicit zoom, center, address, bookmark, layer, feature, extent, scale, and viewpoint requests. Use for questions asking where a place is or to resolve an address or place as a reusable spatial anchor for a proximity request. Resolves only the location; it does not query, display, filter, or highlight feature data.",
+  skillLoaders: l,
+  toolLoaders: m,
+  modelTier: "default",
+  systemPrompt: "You are an ArcGIS map navigation agent.",
+  runtimeContextLoader: s,
+  fallbackMessage: "Navigation request completed.",
+  failureMessage: "I couldn't complete the navigation request."
+});
+export {
+  p as N
+};

package/dist/chunks/orchestrator.js

@@ -1,9 +1,10 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import M from "@arcgis/core/identity/IdentityManager.js";
 import _ from "@arcgis/core/portal/Portal.js";
-import { j as $, k as b, D, n as F, o as L, W } from "./generateLayerDescriptions.js";
-import { isGraphInterrupt as q, StateGraph as T, START as j, END as H, MemorySaver as P } from "@langchain/langgraph/web";
-import { generateGuid as A } from "@arcgis/toolkit/string";
+import { g as $, a as D } from "./aiFactory.js";
+import { isGraphInterrupt as F, StateGraph as L, START as W, END as q, MemorySaver as T } from "@langchain/langgraph/web";
+import { generateGuid as b } from "@arcgis/toolkit/string";
+import { g as A, D as j, b as H, W as P } from "./generateLayerDescriptions.js";
 import { HumanMessage as U, AIMessage as O } from "@langchain/core/messages";
 import { s as p } from "./index.js";
 import { BaseCallbackHandler as G } from "@langchain/core/callbacks/base";
@@ -32,7 +33,7 @@ const B = async (n) => {
 }, K = (n) => {
   n.currentIntent = "none";
 }, J = async (n, e) => {
-  const r = b(e);
+  const r = A(e);
   if (n.agentExecutionContext.userRequest) {
     const t = new U(n.agentExecutionContext.userRequest.trim());
     n.agentExecutionContext.messages = [...n.agentExecutionContext.messages, t], K(n);
@@ -108,7 +109,7 @@ const B = async (n) => {
     return e;
   const t = Date.now(), a = r.map((i) => ({
     ...i,
-    id: A(),
+    id: b(),
     meta: {
       createdByAgentId: s,
       createdAt: t
@@ -143,7 +144,7 @@ const B = async (n) => {
     sharedResourceAdditions: o
   };
 }, x = 4e3, oe = async (n, e) => {
-  const r = b(e);
+  const r = A(e);
   if (e?.signal?.aborted)
     return await p({ text: "Run cancelled; skipping agent execution" }, e), {
       ...n,
@@ -184,7 +185,7 @@ const B = async (n) => {
     );
     i = ie(t.agent.name, c), await p({ text: `Finished executing registered agent: ${t.agent.name}` }, e);
   } catch (c) {
-    if (q(c) || e?.signal?.aborted || c instanceof Error && c.name === "AbortError")
+    if (F(c) || e?.signal?.aborted || c instanceof Error && c.name === "AbortError")
       throw c;
     const u = c instanceof Error ? c.message : String(c);
     console.error(`Agent "${t.agent.name}" failed:`, c), await p({ text: `Registered agent failed: ${t.agent.name}. ${u}` }, e), i = {
@@ -241,7 +242,7 @@ const B = async (n) => {
       assignedTask: n.agentExecutionContext.userRequest
     }
   };
-}, de = 3, ue = (n) => n.routing.mode === "direct" ? "assignDirectAgent" : "intentLLM", ge = (n) => n.routing.mode === "direct" || n.stepCount >= de || !n.requiresFollowUp ? "exit" : "intentLLM", le = () => new T(D).addNode("ingestInput", J).addNode("assignDirectAgent", ce).addNode("intentLLM", F).addNode("executeRegisteredAgent", oe).addNode("exit", X).addEdge(j, "ingestInput").addConditionalEdges("ingestInput", ue).addEdge("assignDirectAgent", "executeRegisteredAgent").addConditionalEdges("intentLLM", (e) => e.currentIntent === "none" || e.currentIntent === e.lastExecutedAgent ? "exit" : "executeRegisteredAgent").addConditionalEdges("executeRegisteredAgent", ge).addEdge("exit", H), he = (n, e) => {
+}, de = 3, ue = (n) => n.routing.mode === "direct" ? "assignDirectAgent" : "intentLLM", ge = (n) => n.routing.mode === "direct" || n.stepCount >= de || !n.requiresFollowUp ? "exit" : "intentLLM", le = () => new L(j).addNode("ingestInput", J).addNode("assignDirectAgent", ce).addNode("intentLLM", H).addNode("executeRegisteredAgent", oe).addNode("exit", X).addEdge(W, "ingestInput").addConditionalEdges("ingestInput", ue).addEdge("assignDirectAgent", "executeRegisteredAgent").addConditionalEdges("intentLLM", (e) => e.currentIntent === "none" || e.currentIntent === e.lastExecutedAgent ? "exit" : "executeRegisteredAgent").addConditionalEdges("executeRegisteredAgent", ge).addEdge("exit", q), he = (n, e) => {
   const r = n.output?.usage_metadata ?? e.usage_metadata, s = n.output?.llmOutput?.tokenUsage, t = r?.input_tokens ?? s?.promptTokens, a = r?.output_tokens ?? s?.completionTokens, i = r?.total_tokens ?? s?.totalTokens;
   if (t === void 0 || a === void 0 || i === void 0)
     return;
@@ -385,7 +386,7 @@ class fe {
 }
 const we = async (n) => {
   try {
-    return await (await L()).embedDocuments(n);
+    return await (await D()).embedDocuments(n);
   } catch (e) {
     throw console.error("Failed to generate embeddings:", e), e;
   }
@@ -467,7 +468,7 @@ function xe(n) {
   };
 }
 const Se = (n) => {
-  const e = W.safeParse(n);
+  const e = P.safeParse(n);
   if (!e.success)
     throw new Error("Embeddings response validation failed. Regenerate embeddings.");
   return e.data;
@@ -579,8 +580,8 @@ class k {
       throw new Error("Orchestrator has no agents selected for this request.");
     if (++this.streamEpoch, !e.trim())
       return;
-    const t = A();
-    this.parentRunIds.clear(), this.activeRuntimeSpans.clear(), this.activeRunId = t, this.activeAbortController = new AbortController(), this.graph || (this.graph = le().compile({ checkpointer: new P() }));
+    const t = b();
+    this.parentRunIds.clear(), this.activeRuntimeSpans.clear(), this.activeRunId = t, this.activeAbortController = new AbortController(), this.graph || (this.graph = le().compile({ checkpointer: new T() }));
     const a = this.embeddingsWorker ? Ee({ worker: this.embeddingsWorker }) : void 0, i = this.embeddingsWorker ? xe({ worker: this.embeddingsWorker }) : void 0, o = /* @__PURE__ */ new Map(), d = r.routing === "direct" ? { mode: "direct", agentId: r.agentId } : { mode: "auto" }, c = {
       // eslint-disable-next-line @typescript-eslint/naming-convention
       thread_id: t,

package/dist/chunks/requireAgentServices.js

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

@@ -2,15 +2,16 @@
 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 m(e) {
+function y(e) {
   return "point" in e && e.point !== void 0;
 }
-function y(e) {
+function h(e) {
   return "layerId" in e && e.layerId !== void 0;
 }
 const v = async (e, n) => {
-  if (m(e)) {
+  if (y(e)) {
     const { point: t } = e;
     return { geometry: new l({
       x: t.x,
@@ -18,7 +19,7 @@ const v = async (e, n) => {
       spatialReference: t.spatialReference ? { wkid: t.spatialReference.wkid } : n.spatialReference
     }) };
   }
-  if (y(e)) {
+  if (h(e)) {
     const t = n.map?.allLayers.find(
       (o) => o.id === e.layerId
     );
@@ -50,7 +51,7 @@ const v = async (e, n) => {
     }
   }
   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({
+}, p = r.object({ id: r.string() }), b = r.object({
   id: r.string(),
   kind: r.literal("point"),
   payload: r.object({
@@ -61,19 +62,19 @@ const v = async (e, n) => {
 }), 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.")
+  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 = b.safeParse(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 = R.safeParse(t);
+  const a = b.safeParse(t);
   if (!a.success)
     throw new Error(`Shared resource ${e.sharedResourceId} does not contain a valid point.`);
   return {
@@ -83,10 +84,9 @@ const v = async (e, n) => {
   };
 };
 export {
-  m as a,
-  p as d,
+  y as a,
   v as g,
-  y as i,
+  h as i,
   g as r,
   S as s
 };

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

@@ -118,26 +118,46 @@ export abstract class ArcgisAssistant extends LitElement {
       waitingForUserInputMessage: string;
   }>;
   /**
-   * The IDs of the agents available to automatic intent routing.
+   * 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 this property is set, it cannot be used together with [allowedAgentIds](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/#allowedAgentIds).
+   * 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="navigation"></arcgis-assistant>
+   * <arcgis-assistant always-use-agent-id="my-custom-orchestration-agent"></arcgis-assistant>
    * ```
    */
   accessor alwaysUseAgentId: string | undefined;

package/dist/components/arcgis-assistant-data-exploration-agent/customElement.js

@@ -1,6 +1,7 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { c as t } from "../../chunks/runtime.js";
 import { LitElement as i } from "@arcgis/lumina";
+import "../../agents/runtime/skill/createSkillAgent.js";
 import "@langchain/langgraph/web";
 import "../../chunks/adapter.js";
 import "@arcgis/core/identity/IdentityManager.js";
@@ -27,11 +28,21 @@ import "../../agents/tools/navigation/goToViewpoint/adapter.js";
 import "../../agents/tools/navigation/goToZoom/adapter.js";
 import "@langchain/langgraph/prebuilt";
 import "zod";
-import { D as r } from "../../chunks/dataExplorationGraph.js";
+import { D as r } from "../../chunks/dataExplorationAgent.js";
+import "../../agents/tools/filter/clearFilters/adapter.js";
+import "../../agents/tools/filter/resetMap/adapter.js";
+import "../../agents/tools/filter/setFeatureEffect/adapter.js";
+import "../../agents/tools/query/getAttribute/adapter.js";
+import "../../agents/tools/query/getStatistics/adapter.js";
+import "../../agents/tools/query/getTopFeatures/adapter.js";
+import "../../agents/tools/query/queryFeatures/adapter.js";
+import "@arcgis/core/intl.js";
+import "@arcgis/core/smartMapping/statistics/summaryStatistics.js";
+import "@arcgis/core/smartMapping/statistics/uniqueValues.js";
 import "../../agents/tools/help/listFields/adapter.js";
 import "@arcgis/core/rest/knowledgeGraphService.js";
-import { r as o, i as a } from "../../chunks/utils2.js";
-class s extends i {
+import { r as o, i as p } from "../../chunks/utils2.js";
+class m extends i {
   constructor() {
     super(...arguments), this.agent = r;
   }
@@ -46,13 +57,13 @@ class s extends i {
     return { mapView: this.#t };
   }
   load() {
-    this.#t = o(this, "arcgis-assistant-data-exploration-agent"), this.#i = a(this);
+    this.#t = o(this, "arcgis-assistant-data-exploration-agent"), this.#i = p(this);
   }
   disconnectedCallback() {
     this.#i?.unregister(this.agent.id), super.disconnectedCallback();
   }
 }
-t("arcgis-assistant-data-exploration-agent", s);
+t("arcgis-assistant-data-exploration-agent", m);
 export {
-  s as ArcgisAssistantDataExplorationAgent
+  m as ArcgisAssistantDataExplorationAgent
 };

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

@@ -1,6 +1,7 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { c as t } from "../../chunks/runtime.js";
 import { LitElement as i } from "@arcgis/lumina";
+import "../../agents/runtime/skill/createSkillAgent.js";
 import "@langchain/langgraph/web";
 import "../../chunks/adapter.js";
 import "@arcgis/core/identity/IdentityManager.js";
@@ -37,7 +38,8 @@ import "../../agents/tools/query/queryFeatures/adapter.js";
 import "@arcgis/core/intl.js";
 import "@arcgis/core/smartMapping/statistics/summaryStatistics.js";
 import "@arcgis/core/smartMapping/statistics/uniqueValues.js";
-import { H as r } from "../../chunks/helpGraph.js";
+import { H as r } from "../../chunks/helpAgent.js";
+import "../../agents/tools/help/listFields/adapter.js";
 import "@arcgis/core/rest/knowledgeGraphService.js";
 import { r as o, i as p } from "../../chunks/utils2.js";
 class m extends i {

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

@@ -1,6 +1,7 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { c as r } from "../../chunks/runtime.js";
 import { LitElement as e } from "@arcgis/lumina";
+import "../../agents/runtime/skill/createSkillAgent.js";
 import "@langchain/langgraph/web";
 import "../../chunks/adapter.js";
 import "@arcgis/core/identity/IdentityManager.js";

package/dist/components/arcgis-assistant-layer-styling-agent/customElement.js

@@ -1,6 +1,7 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { c as t } from "../../chunks/runtime.js";
 import { LitElement as i } from "@arcgis/lumina";
+import "../../agents/runtime/skill/createSkillAgent.js";
 import "@langchain/langgraph/web";
 import "../../chunks/adapter.js";
 import "@arcgis/core/identity/IdentityManager.js";