@arcgis/ai-agents 5.1.0-next.103 → 5.1.0-next.104

package/dist/agents/arcgisKnowledge/utils/mapUtils.d.ts

@@ -1,4 +1,4 @@
 import { default as LinkChartView } from '@arcgis/core/views/LinkChartView.js';
 import { default as MapView } from '@arcgis/core/views/MapView.js';
 export declare function isMapValid(mapView: MapView): void;
-export declare function isMapView(view: LinkChartView | MapView | undefined): boolean;
+export declare function isMapView(view: LinkChartView | MapView | undefined): view is MapView;

package/dist/index.js

@@ -1,24 +1,24 @@
-import { Annotation as v, StateGraph as W, START as U, END as C, messagesStateReducer as ke, NodeInterrupt as it } from "@langchain/langgraph/web";
-import { createAgentRuntimeStateWithSharedState as lt, invokeToolPrompt as P, sendTraceMessage as m, invokeStructuredPrompt as Fe, createAgentRuntimeState as ee, invokeTextPrompt as qe, sendUXSuggestion as k } from "@arcgis/ai-orchestrator";
+import { Annotation as v, StateGraph as W, START as U, END as C, messagesStateReducer as ke, NodeInterrupt as lt } from "@langchain/langgraph/web";
+import { createAgentRuntimeStateWithSharedState as ct, invokeToolPrompt as P, sendTraceMessage as m, invokeStructuredPrompt as Fe, createAgentRuntimeState as ee, invokeTextPrompt as qe, sendUXSuggestion as k } from "@arcgis/ai-orchestrator";
 import { tool as b } from "@langchain/core/tools";
-import ct from "@arcgis/core/Graphic.js";
-import dt from "@arcgis/core/symbols/PictureMarkerSymbol.js";
-import { addressToLocations as ut } from "@arcgis/core/rest/locator.js";
+import dt from "@arcgis/core/Graphic.js";
+import ut from "@arcgis/core/symbols/PictureMarkerSymbol.js";
+import { addressToLocations as pt } from "@arcgis/core/rest/locator.js";
 import _ from "@arcgis/core/portal/Portal.js";
 import oe from "@arcgis/core/config.js";
 import l, { z as I } from "zod";
-import pt from "@arcgis/core/geometry/Extent.js";
-import Le from "@arcgis/core/geometry/Point.js";
+import Le from "@arcgis/core/geometry/Extent.js";
+import Ie from "@arcgis/core/geometry/Point.js";
 import { ToolNode as G } from "@langchain/langgraph/prebuilt";
 import ht from "@arcgis/core/layers/support/FeatureEffect.js";
-import Ie from "@arcgis/core/layers/support/FeatureFilter.js";
+import Ne from "@arcgis/core/layers/support/FeatureFilter.js";
 import * as mt from "@arcgis/core/geometry/operators/unionOperator.js";
 import { formatDateOnly as yt, convertDateFormatToIntlOptions as Z, formatTimeOnly as gt, formatDate as fe } from "@arcgis/core/intl.js";
-import Ne from "@arcgis/core/smartMapping/statistics/summaryStatistics.js";
-import Ae from "@arcgis/core/smartMapping/statistics/uniqueValues.js";
+import Ae from "@arcgis/core/smartMapping/statistics/summaryStatistics.js";
+import Me from "@arcgis/core/smartMapping/statistics/uniqueValues.js";
 import ft from "@arcgis/core/rest/support/TopFeaturesQuery.js";
 import wt from "@arcgis/core/rest/support/TopFilter.js";
-import { AIMessage as Me } from "@langchain/core/messages";
+import { AIMessage as ze } from "@langchain/core/messages";
 import { createRenderer as bt } from "@arcgis/core/smartMapping/renderers/pieChart.js";
 import { getSchemesByTag as St, getSchemes as vt } from "@arcgis/core/smartMapping/symbology/pieChart.js";
 import { getBackgroundColorTheme as we } from "@arcgis/core/views/support/colorUtils.js";
@@ -39,12 +39,12 @@ import { getSchemesByTag as zt } from "@arcgis/core/smartMapping/symbology/type.
 import "@arcgis/core/views/LinkChartView.js";
 import { fetchKnowledgeGraph as be, executeQueryStreaming as _t, executeSearchStreaming as Dt } from "@arcgis/core/rest/knowledgeGraphService.js";
 import jt from "@arcgis/core/rest/knowledgeGraph/GraphSearchStreaming.js";
-import ze from "@arcgis/core/rest/knowledgeGraph/GraphQueryStreaming.js";
+import _e from "@arcgis/core/rest/knowledgeGraph/GraphQueryStreaming.js";
 import Se from "@arcgis/core/request.js";
 import ve from "@arcgis/core/identity/IdentityManager.js";
 import Pt from "@arcgis/core/WebLinkChart.js";
-const V = (e, t) => t ?? e, _e = v.Root({
-  ...lt(),
+const V = (e, t) => t ?? e, De = v.Root({
+  ...ct(),
   // internal to the navigation agent
   intent: v({
     reducer: V
@@ -67,17 +67,17 @@ async function Gt(e, t) {
   const a = _.getDefault().helperServices, o = a.geocode.find((y) => y.name === "ArcGIS World Geocoding Service") ?? a.geocode[0];
   if (!o)
     throw new Error("No geocoding service found in helperServices.");
-  const n = o.url, s = `${oe.assetsPath?.endsWith("/") ? oe.assetsPath : `${oe.assetsPath}/`}esri/images/search/search-symbol-32.png`, c = (await ut(n, {
+  const n = o.url, s = `${oe.assetsPath?.endsWith("/") ? oe.assetsPath : `${oe.assetsPath}/`}esri/images/search/search-symbol-32.png`, c = (await pt(n, {
     address: { SingleLine: e },
     outFields: ["Match_addr"]
   }))?.[0];
   if (!c?.extent || !c.location)
     throw new Error(`Could not find location for: ${e}`);
-  const d = new dt({
+  const d = new ut({
     url: s,
     width: 24,
     height: 24
-  }), u = new ct({
+  }), u = new dt({
     geometry: c.location,
     symbol: d
   });
@@ -172,7 +172,7 @@ const Yt = I.object({
   schema: Yt
 });
 async function er(e) {
-  const r = new pt({
+  const r = new Le({
     xmin: -180,
     ymin: -90,
     xmax: 180,
@@ -242,7 +242,7 @@ const mr = l.object({
 });
 async function gr(e, t, r) {
   const o = {
-    target: new Le({
+    target: new Ie({
       longitude: e.longitude,
       latitude: e.latitude,
       spatialReference: { wkid: 4326 }
@@ -531,7 +531,7 @@ ${d.results.map((u) => `  - ${u.name} (${u.score.toFixed(2)})`).join(`
     if (!o?.[n])
       throw new Error(`${t} requires services.${n} to be available.`);
   return r;
-}, Ir = (e, t) => B(["layerSearch", "layersAndFieldsRegistry"], "Navigation Agent")(e, t), Nr = () => new W(_e).addNode("requireNavigationServices", Ir).addNode("intentLLM", Cr).addNode("vectorSearchLayers", Fr).addNode("vectorSearchFields", Lr).addNode("agent", Er).addNode("tools", $r).addEdge(U, "requireNavigationServices").addEdge("requireNavigationServices", "intentLLM").addConditionalEdges(
+}, Ir = (e, t) => B(["layerSearch", "layersAndFieldsRegistry"], "Navigation Agent")(e, t), Nr = () => new W(De).addNode("requireNavigationServices", Ir).addNode("intentLLM", Cr).addNode("vectorSearchLayers", Fr).addNode("vectorSearchFields", Lr).addNode("agent", Er).addNode("tools", $r).addEdge(U, "requireNavigationServices").addEdge("requireNavigationServices", "intentLLM").addConditionalEdges(
   "intentLLM",
   (t) => t.intent === "goToLayer" || t.intent === "goToFeatures" ? "vectorSearchLayers" : "agent",
   {
@@ -569,8 +569,8 @@ ${d.results.map((u) => `  - ${u.name} (${u.score.toFixed(2)})`).join(`
   name: "Navigation Agent",
   description: Ar,
   createGraph: Nr,
-  workspace: _e
-}, De = v.Root({
+  workspace: De
+}, je = v.Root({
   ...ee(),
   vectorSearchLayerIds: v(),
   vectorSearchFieldResults: v(),
@@ -642,7 +642,7 @@ function Q(e) {
 const te = async (e, t) => {
   if (Y(e)) {
     const { point: r } = e;
-    return { geometry: new Le({
+    return { geometry: new Ie({
       x: r.x,
       y: r.y,
       spatialReference: r.spatialReference ? { wkid: r.spatialReference.wkid } : t.spatialReference
@@ -715,7 +715,7 @@ const te = async (e, t) => {
     i = p.geometry;
   }
   if (s.featureEffect = null, s.featureEffect = new ht({
-    filter: new Ie({
+    filter: new Ne({
       ...e.objectIds?.length ? { objectIds: e.objectIds } : { where: e.where },
       geometry: i,
       spatialRelationship: "intersects",
@@ -794,7 +794,7 @@ const te = async (e, t) => {
     return e;
   const t = ie(e);
   return t ? t.toISOString().slice(0, 10) : null;
-}, je = () => {
+}, Pe = () => {
   const e = (/* @__PURE__ */ new Date()).getTimezoneOffset(), t = e <= 0 ? "+" : "-", r = Math.floor(Math.abs(e) / 60).toString().padStart(2, "0"), a = (Math.abs(e) % 60).toString().padStart(2, "0"), o = `${t}${r}:${a}`;
   return { userTimezone: Intl.DateTimeFormat().resolvedOptions().timeZone, userTimezoneOffset: o };
 }, Xr = (e, t, r) => {
@@ -817,7 +817,7 @@ const te = async (e, t) => {
     ...Z("short-date-short-time"),
     timeZone: Jr(r)
   }) : e;
-}, Pe = (e, t, r) => {
+}, Ge = (e, t, r) => {
   if (e && typeof e != "function") {
     const a = "getField" in r && r.getField?.(e), o = a && "getFieldDomain" in r && r.getFieldDomain ? r.getFieldDomain(a.name) : null;
     if (o?.type === "coded-value") {
@@ -859,15 +859,15 @@ const te = async (e, t) => {
   } catch {
     return e;
   }
-}, Ge = (e, t) => e.getFieldAlias?.(t) ?? e.fieldsIndex?.get(t)?.alias ?? e.fieldsIndex?.get(t)?.name ?? t, Oe = (e, t, r, a, o) => {
+}, Oe = (e, t) => e.getFieldAlias?.(t) ?? e.fieldsIndex?.get(t)?.alias ?? e.fieldsIndex?.get(t)?.name ?? t, Ve = (e, t, r, a, o) => {
   if (r == null)
     return r;
   const s = e.getFieldConfiguration?.(t)?.fieldFormat;
   return s?.type === "number" ? ra(r, s) : s?.type === "date-time" ? aa(r, s, o) : Xr(r, a, o);
 }, oa = (e, t, r, a) => {
-  const o = e.fieldsIndex?.get(t), n = Pe(t, r, e) ?? r;
-  return Oe(e, t, n, o?.type, a);
-}, na = (e, t) => Ge(e, t), Ve = (e, t, r) => {
+  const o = e.fieldsIndex?.get(t), n = Ge(t, r, e) ?? r;
+  return Ve(e, t, n, o?.type, a);
+}, na = (e, t) => Oe(e, t), Qe = (e, t, r) => {
   const a = e.objectIdField, o = t.features.map(
     (s) => s.attributes[a]
   ), n = t.features.map((s) => {
@@ -880,8 +880,8 @@ const te = async (e, t) => {
         c[d.name] = u;
         return;
       }
-      const p = Pe(d.name, u, e) ?? u, h = Ge(e, d.name);
-      c[h] = Oe(e, d.name, p, d.type, r);
+      const p = Ge(d.name, u, e) ?? u, h = Oe(e, d.name);
+      c[h] = Ve(e, d.name, p, d.type, r);
     }), c;
   });
   return { objectIds: o, attributes: n };
@@ -951,7 +951,7 @@ const ua = async (e) => {
       units: s.units,
       applied: !0
     });
-    y = new Ie({
+    y = new Ne({
       geometry: T.geometry,
       distance: s.distance,
       units: s.units,
@@ -972,16 +972,16 @@ const ua = async (e) => {
         ...y && { filter: y },
         outStatisticTypes: { include: [a] }
       };
-      g = await Ne(T);
+      g = await Ae(T);
       const D = ["string", "small-integer", "integer"], L = u.domain?.type === "coded-value" ? u.domain : null;
-      (D.includes(u.type) || L) && (f = (await Ae({
+      (D.includes(u.type) || L) && (f = (await Me({
         layer: i,
         useFeaturesInView: w,
         view: w ? o : void 0,
         field: r,
         sqlWhere: X(i.definitionExpression, t.where),
         ...y && { filter: y }
-      })).uniqueValueInfos.sort(($, st) => st.count - $.count).slice(0, x)), f && u.domain?.type === "coded-value" && (f = f.map(($) => ({
+      })).uniqueValueInfos.sort(($, it) => it.count - $.count).slice(0, x)), f && u.domain?.type === "coded-value" && (f = f.map(($) => ({
         ...$,
         value: L ? L.getName($.value) ?? $.value : $.value
       })));
@@ -1113,7 +1113,7 @@ Only call this tool when the answer requires computing an aggregate (avg, max, m
         console.warn("Client-side query failed, falling back to server:", x), h = await n.queryFeatures(g);
       }
     }
-    const y = h.features.map((g) => g.attributes[u]), { attributes: w } = Ve(n, h, r.timeZone);
+    const y = h.features.map((g) => g.attributes[u]), { attributes: w } = Qe(n, h, r.timeZone);
     return {
       tool: "getTopFeatures",
       layerName: i,
@@ -1228,7 +1228,7 @@ Only call this tool when the answer requires computing an aggregate (avg, max, m
   } catch (g) {
     console.warn("Client-side query failed, falling back to server:", g), p = await o.queryFeatureCount(u), p > 0 && p <= ne && (h = await o.queryFeatures(u));
   }
-  const { objectIds: y, attributes: w } = h ? Ve(o, h, t.timeZone) : { objectIds: void 0, attributes: void 0 };
+  const { objectIds: y, attributes: w } = h ? Qe(o, h, t.timeZone) : { objectIds: void 0, attributes: void 0 };
   return {
     tool: "queryFeatures",
     layerName: s,
@@ -1301,12 +1301,12 @@ USE THIS TOOL FOR:
 
 This is the DEFAULT tool for most queries. When in doubt, use this tool.`,
   schema: Ca
-}), Qe = [da, ga, xa, ka], Ke = [Zr, Or, jr], Fa = async (e, t) => {
+}), Ke = [da, ga, xa, ka], We = [Zr, Or, jr], Fa = async (e, t) => {
   await m({ text: "Requesting LLM for layer filter results" }, t);
   const a = await R("data_explore_filter_prompt");
   if (!t?.configurable)
     throw new Error("config.configurable is required for layer filter tools");
-  const { userTimezone: o, userTimezoneOffset: n } = je(), s = {
+  const { userTimezone: o, userTimezoneOffset: n } = Pe(), s = {
     layerFieldInfo: e.layerFieldInfo,
     userTimezone: o,
     userTimezoneOffset: n,
@@ -1319,7 +1319,7 @@ This is the DEFAULT tool for most queries. When in doubt, use this tool.`,
     modelTier: "advanced",
     messages: e.dataExplorationMessages,
     inputVariables: s,
-    tools: Ke
+    tools: We
   }), c = [...e.dataExplorationMessages, i];
   if (!((i.tool_calls?.length ?? 0) > 0))
     return await m({ text: "LLM determined no filter changes needed" }, t), {
@@ -1334,7 +1334,7 @@ This is the DEFAULT tool for most queries. When in doubt, use this tool.`,
   const a = await R("data_explore_query_prompt");
   if (!t?.configurable)
     throw new Error("config.configurable is required for layer query tools");
-  const { userTimezone: o, userTimezoneOffset: n } = je(), s = {
+  const { userTimezone: o, userTimezoneOffset: n } = Pe(), s = {
     layerFieldInfo: e.layerFieldInfo,
     userTimezone: o,
     userTimezoneOffset: n,
@@ -1346,7 +1346,7 @@ This is the DEFAULT tool for most queries. When in doubt, use this tool.`,
     modelTier: "advanced",
     messages: e.dataExplorationMessages,
     inputVariables: s,
-    tools: Qe
+    tools: Ke
   }), c = i.content.toString();
   return await he(i, t), {
     ...e,
@@ -1368,7 +1368,7 @@ This is the DEFAULT tool for most queries. When in doubt, use this tool.`,
       modelTier: "fast",
       messages: e.dataExplorationMessages,
       inputVariables: o
-    }), s = typeof n == "string" ? n : n.content, i = new Me(s);
+    }), s = typeof n == "string" ? n : n.content, i = new ze(s);
     await m({ text: `Received response from LLM: ${s}` }, t);
     const c = s;
     return {
@@ -1383,7 +1383,7 @@ This is the DEFAULT tool for most queries. When in doubt, use this tool.`,
   }
 };
 async function Ia(e, t) {
-  const a = await new G(Ke).invoke(
+  const a = await new G(We).invoke(
     {
       messages: e.dataExplorationMessages
     },
@@ -1394,7 +1394,7 @@ async function Ia(e, t) {
     t
   ), { ...e };
 }
-const Na = new G(Qe);
+const Na = new G(Ke);
 async function Aa(e, t) {
   const { messages: r } = await Na.invoke({ messages: e.dataExplorationMessages }, t), a = [], o = [];
   for (const n of r) {
@@ -1438,9 +1438,9 @@ const Ma = 10, za = ["string", "small-integer", "integer"], _a = async (e, t, {
   let o = null, n = null;
   try {
     if (t.type !== "geometry" && t.type !== "oid" && t.type !== "global-id") {
-      r && (o = await Ne({ layer: e, field: t.name }));
+      r && (o = await Ae({ layer: e, field: t.name }));
       const s = t.domain?.type === "coded-value" ? t.domain : null;
-      a && (za.includes(t.type) || s) && (n = (await Ae({ layer: e, field: t.name })).uniqueValueInfos.sort((i, c) => c.count - i.count).slice(0, Ma), s && (n = n.map((i) => ({
+      a && (za.includes(t.type) || s) && (n = (await Me({ layer: e, field: t.name })).uniqueValueInfos.sort((i, c) => c.count - i.count).slice(0, Ma), s && (n = n.map((i) => ({
         ...i,
         value: s.getName(i.value) ?? i.value
       }))));
@@ -1587,7 +1587,7 @@ ${i}` : c = "Vector search completed. No matching layers found.", await m({ text
 }, Wa = (e, t) => B(["layerSearch", "fieldSearch", "layersAndFieldsRegistry"], "Data Exploration Agent")(
   e,
   t
-), Ua = () => new W(De).addNode("requireDataExplorationServices", Wa).addNode("vectorSearchLayers", Ka).addNode("vectorSearchFields", Va).addNode("fieldStatistics", Ga).addNode("queryAgent", qa).addNode("queryTools", Aa).addNode("summarizeQueryResponseLLM", La).addNode("filterAgent", Fa).addNode("filterTools", Ia).addNode("earlyExit", Mr).addEdge(U, "requireDataExplorationServices").addEdge("requireDataExplorationServices", "vectorSearchLayers").addConditionalEdges(
+), Ua = () => new W(je).addNode("requireDataExplorationServices", Wa).addNode("vectorSearchLayers", Ka).addNode("vectorSearchFields", Va).addNode("fieldStatistics", Ga).addNode("queryAgent", qa).addNode("queryTools", Aa).addNode("summarizeQueryResponseLLM", La).addNode("filterAgent", Fa).addNode("filterTools", Ia).addNode("earlyExit", Mr).addEdge(U, "requireDataExplorationServices").addEdge("requireDataExplorationServices", "vectorSearchLayers").addConditionalEdges(
   "vectorSearchLayers",
   (t) => t.vectorSearchLayerIds.length ? "vectorSearchFields" : "earlyExit"
 ).addConditionalEdges(
@@ -1609,7 +1609,7 @@ ${i}` : c = "Vector search completed. No matching layers found.", await m({ text
   name: "Data Exploration Agent",
   description: Ba,
   createGraph: Ua,
-  workspace: De
+  workspace: je
 }, $e = 0.7, Ha = 10, Za = async (e, t) => {
   try {
     await m({ text: "Similarity search to find fields" }, t);
@@ -2525,7 +2525,7 @@ Keywords: categorical, category, type, unique, discrete, point of interest, regi
 Example: Color each feature based on the region it belongs to
 Fields: This style requires a single field which may be a string, number, or date type. It is usually a string.`,
   schema: pn
-}), We = [
+}), Ue = [
   no,
   po,
   wo,
@@ -2537,7 +2537,7 @@ Fields: This style requires a single field which may be a string, number, or dat
   en,
   sn,
   hn
-], Ue = (e, t = 3) => {
+], Be = (e, t = 3) => {
   const r = e.map((o, n) => o.type === "human" ? n : -1).filter((o) => o !== -1);
   if (r.length === 0)
     return [];
@@ -2553,9 +2553,9 @@ Fields: This style requires a single field which may be a string, number, or dat
   }, o = await P({
     promptText: r,
     modelTier: "advanced",
-    messages: Ue(e.agentExecutionContext.messages),
+    messages: Be(e.agentExecutionContext.messages),
     inputVariables: a,
-    tools: We
+    tools: Ue
   });
   return await he(o, t), {
     ...e,
@@ -2566,9 +2566,9 @@ Fields: This style requires a single field which may be a string, number, or dat
   };
 };
 async function yn(e, t) {
-  const a = await new G(We).invoke(
+  const a = await new G(Ue).invoke(
     {
-      messages: Ue(e.agentExecutionContext.messages)
+      messages: Be(e.agentExecutionContext.messages)
     },
     t
   ), o = a.messages.map((s) => s.text).join(`
@@ -2578,7 +2578,7 @@ async function yn(e, t) {
 `);
   return { ...e, outputMessage: n };
 }
-const Be = v.Root({
+const He = v.Root({
   ...ee(),
   vectorSearchLayerIds: v(),
   vectorSearchFieldResults: v(),
@@ -2628,14 +2628,14 @@ const Be = v.Root({
       message: "Choose a layer to apply the styles.",
       metadata: [...r]
     };
-    throw new it(n);
+    throw new lt(n);
   }
   let o = null;
   return Array.isArray(a.payload) && a.payload.length > 0 && (o = a.payload[0]), {
     ...e,
     selectedLayerId: o ?? e.vectorSearchLayerIds[0]
   };
-}, bn = (e, t) => B(["layerSearch", "fieldSearch", "layersAndFieldsRegistry"], "Layer Styling Agent")(e, t), Sn = () => new W(Be).addNode("requireLayerStylingServices", bn).addNode("vectorSearchLayers", Ya).addNode("layerSelectionHITL", wn).addNode("vectorSearchFields", Za).addNode("populateLayerFieldInfo", fn).addNode("agent", mn).addNode("tools", yn).addNode("earlyExit", gn).addEdge(U, "requireLayerStylingServices").addEdge("requireLayerStylingServices", "vectorSearchLayers").addConditionalEdges(
+}, bn = (e, t) => B(["layerSearch", "fieldSearch", "layersAndFieldsRegistry"], "Layer Styling Agent")(e, t), Sn = () => new W(He).addNode("requireLayerStylingServices", bn).addNode("vectorSearchLayers", Ya).addNode("layerSelectionHITL", wn).addNode("vectorSearchFields", Za).addNode("populateLayerFieldInfo", fn).addNode("agent", mn).addNode("tools", yn).addNode("earlyExit", gn).addEdge(U, "requireLayerStylingServices").addEdge("requireLayerStylingServices", "vectorSearchLayers").addConditionalEdges(
   "layerSelectionHITL",
   (t) => t.vectorSearchLayerIds.length ? "vectorSearchFields" : "earlyExit"
 ).addConditionalEdges(
@@ -2650,8 +2650,8 @@ const Be = v.Root({
   name: "Layer Styling Agent",
   description: vn,
   createGraph: Sn,
-  workspace: Be
-}, He = v.Root({
+  workspace: He
+}, Ze = v.Root({
   ...ee(),
   // internal to the help agent
   helpInternalState: v({
@@ -2682,7 +2682,7 @@ ${o}`;
   schema: l.object({
     layerTitle: l.string().describe("The title or partial title of the layer to list fields for.")
   })
-}), Ze = [En], Rn = (e) => {
+}), Je = [En], Rn = (e) => {
   if (!e || e.size === 0)
     return "No layers available in this map.";
   const t = Array.from(e.values()).map(({ layerItem: r, fieldRegistry: a }, o) => {
@@ -2706,7 +2706,7 @@ async function Cn(e, t) {
     const n = await P({
       promptText: r,
       modelTier: "fast",
-      tools: Ze,
+      tools: Je,
       inputVariables: {
         layerSummary: Rn(a),
         agents: $n(o),
@@ -2737,7 +2737,7 @@ async function Cn(e, t) {
 }
 const kn = (e, t) => B(["agentRegistry"], "Help Agent")(e, t);
 async function Fn(e, t) {
-  const r = new G(Ze);
+  const r = new G(Je);
   try {
     const a = e.helpInternalState.toolCallMessage;
     if (!a)
@@ -2768,7 +2768,7 @@ async function Fn(e, t) {
     };
   }
 }
-const qn = () => new W(He).addNode("requireHelpServices", kn).addNode("agent", Cn).addNode("tools", Fn).addEdge(U, "requireHelpServices").addEdge("requireHelpServices", "agent").addConditionalEdges("agent", (t) => t.helpInternalState.toolCallMessage ? "tools" : C).addEdge("tools", C), Ln = String.raw`- **help** — Enables users to ask questions about the map, layers, fields, and it's capabilities.
+const qn = () => new W(Ze).addNode("requireHelpServices", kn).addNode("agent", Cn).addNode("tools", Fn).addEdge(U, "requireHelpServices").addEdge("requireHelpServices", "agent").addConditionalEdges("agent", (t) => t.helpInternalState.toolCallMessage ? "tools" : C).addEdge("tools", C), Ln = String.raw`- **help** — Enables users to ask questions about the map, layers, fields, and it's capabilities.
 
   _Example: “Tell me about this map”_  
   _Example: “List all layers in this map”_  
@@ -2786,8 +2786,8 @@ const qn = () => new W(He).addNode("requireHelpServices", kn).addNode("agent", C
   name: "Help Agent",
   description: Ln,
   createGraph: qn,
-  workspace: He
-}, Je = v.Root({
+  workspace: Ze
+}, Ye = v.Root({
   ...ee(),
   intent: v({
     reducer: (e, t) => t
@@ -2803,7 +2803,7 @@ const qn = () => new W(He).addNode("requireHelpServices", kn).addNode("agent", C
 }), J = {
   conversationId: ""
 }, In = ["view"], se = ["knowledgeGraph", "view"];
-function Ye(e) {
+function Xe(e) {
   const t = e.map?.allLayers.filter((r) => r.type === "knowledge-graph");
   if (!t || t?.length !== 1)
     throw new Error("The Knowledge Agent currently only supports maps with exactly one Knowledge Graph Layer.");
@@ -2819,7 +2819,7 @@ function re(e) {
   if (a.length)
     throw new Error(`View context missing: ${a.join(", ")}`);
   const o = r.view;
-  return o.map && !("activeLinkChartLayer" in o.map) && Ye(o), {
+  return o.map && !("activeLinkChartLayer" in o.map) && Xe(o), {
     view: o
   };
 }
@@ -2842,7 +2842,7 @@ async function O(e) {
         knowledgeGraph: await be(n)
       };
     } else {
-      Ye(r.view);
+      Xe(r.view);
       const s = (r.view.map?.allLayers.find(
         (c) => c.type === "knowledge-graph"
       )).url;
@@ -3061,7 +3061,7 @@ async function ye(e, t, r, a, o) {
   return { graphQuery: u, explanation: p };
 }
 const z = 3;
-function Xe(e, t = 100) {
+function et(e, t = 100) {
   const r = {};
   for (const a of Object.entries(e.properties ?? {})) {
     const [o, n] = a;
@@ -3111,7 +3111,7 @@ const Pn = async ({
   }
   return { type: "success", rowLimitReached: !1, resultHeader: i, processedResult: c };
 };
-async function et({
+async function tt({
   prompt: e,
   kg: t,
   graphQueryServiceUrl: r,
@@ -3142,7 +3142,7 @@ async function et({
     );
     const h = await Pn({
       kg: t,
-      queryParams: new ze({
+      queryParams: new _e({
         openCypherQuery: p.graphQuery
       }),
       targetStructure: a,
@@ -3296,7 +3296,7 @@ function Un(e) {
   return { allNamedTypesFullyDynamic: !1, idTypePairs: t, dynamicTypes: r };
 }
 async function Bn(e, t, r, a, o) {
-  const { view: n } = a, s = await et({
+  const { view: n } = a, s = await tt({
     prompt: e,
     kg: t,
     graphQueryServiceUrl: r,
@@ -3322,22 +3322,21 @@ async function Bn(e, t, r, a, o) {
       text: `Query Results parsed into ${u.length} unique relationships and entities.  Atempting to add to link chart...`
     },
     o
-  ), H(n))
-    return await n?.map?.allLayers.find(
-      (h) => h.type === "knowledge-graph"
-    )?.addRecords(u), `Map updated successfully.  Cypher Query used: 
+  ), !H(n) && n?.map) {
+    const p = n.map;
+    return await p.addRecords(u), n.goTo(p.diagramNodesExtent ?? new Le()), `Link Chart updated successfully.  Cypher Query used: 
 ${i}
 
 Explanation: ${c}`;
-  {
-    const p = n;
-    return await p.map.addRecords(u), p.goTo(p.map.diagramNodesExtent), `Link Chart updated successfully.  Cypher Query used: 
+  } else
+    return await n?.map?.allLayers.find(
+      (h) => h.type === "knowledge-graph"
+    )?.addRecords(u), `Map updated successfully.  Cypher Query used: 
 ${i}
 
 Explanation: ${c}`;
-  }
 }
-const tt = "addRecords", Hn = l.object({
+const rt = "addRecords", Hn = l.object({
   prompt: l.string().describe("The user's inquiry into the knowledge graph that needs to be run.")
 }), Zn = async ({ prompt: e }, t) => {
   const { knowledgeGraph: r } = await O(t), a = re(t), { view: o } = a, s = _.getDefault().helperServices;
@@ -3364,17 +3363,17 @@ ${u}${JSON.stringify(p)}`;
     t
   );
   return {
-    toolName: tt,
+    toolName: rt,
     status: "success",
     summary: c
   };
 }, Jn = b(Zn, {
-  name: tt,
+  name: rt,
   description: "Adds records (entities or relationships) to the current link chart visualization from an inquiry into the knowledge graph data. The inquiry will retrieve data from the graph database that will serve as the basis for the records to be added to the link chart.  The user should have explicitly requested to add records to the current link chart from their prompt.",
   schema: Hn
 });
 async function Yn(e, t) {
-  return await t.map.applyLayout(e), `Successfully applied layout: ${e}.`;
+  return await t.map?.applyLayout(e), `Successfully applied layout: ${e}.`;
 }
 const le = "applyLayout", Xn = l.object({
   layout: l.enum([
@@ -3413,7 +3412,7 @@ const le = "applyLayout", Xn = l.object({
   schema: Xn
 });
 function rs(e, t) {
-  return t.map.changeNonspatialDataDisplay(e), `Successfully applied nonspatial visibility setting: ${e}.`;
+  return t.map?.changeNonspatialDataDisplay(e), `Successfully applied nonspatial visibility setting: ${e}.`;
 }
 const ce = "changeNonspatialVisibility", as = l.object({
   setting: l.enum(["hidden", "visible"]).describe("The setting of nonspatial visibility")
@@ -3453,7 +3452,7 @@ async function ss(e, t, r, a, o) {
       await m({ text: `Attempting to create link chart from derived query: ${i}` }, o);
       const d = await Pt.fromCypherQuery(
         t,
-        new ze({
+        new _e({
           openCypherQuery: i
         })
       );
@@ -3509,7 +3508,7 @@ const de = "createLinkChart", is = l.object({
   name: de,
   description: "Creates a new link chart visualization from an inquiry into the knowledge graph data. The inquiry will retrieve data from the graph database that will serve as the basis for the new link chart.  The user should have explicitly requested the creation of a new link chart from their prompt.",
   schema: is
-}), rt = "queryGraphData", ds = l.object({
+}), at = "queryGraphData", ds = l.object({
   prompt: l.string().describe(
     `The user's inquiry into the knowledge graph, from which a cypher query will be generated and executed to answer the inquiry. IMPORTANT: 
 
@@ -3518,7 +3517,7 @@ REQUEST LIMIT: If the user does not specifically request for no limits or an exp
 DESCRIPTIVE COLUMN NAMES: If the user's prompt does not explicitly request for specific column names in the result, ensure that the generated query has descriptive column names (using AS statements) to make the results easier to understand when displayed in a table format.`
   )
 }), us = async ({ prompt: e }, t) => {
-  const { knowledgeGraph: r } = await O(t), o = _.getDefault().helperServices, n = await et({
+  const { knowledgeGraph: r } = await O(t), o = _.getDefault().helperServices, n = await tt({
     prompt: e,
     kg: r,
     graphQueryServiceUrl: `${o.aiAssistantServices.url}${o.aiAssistantServices.graphQueryAssistant}`,
@@ -3539,11 +3538,11 @@ DESCRIPTIVE COLUMN NAMES: If the user's prompt does not explicitly request for s
     for (const y of h)
       j(
         y,
-        (w) => Xe(w)
+        (w) => et(w)
       );
   const u = 50, p = i.slice(0, u).map((h) => JSON.stringify(h));
   return {
-    toolName: rt,
+    toolName: at,
     status: "success",
     summary: `To answer the inquiry, the following cypher query was executed against the knowledge graph:
 
@@ -3570,10 +3569,10 @@ ${p.length > u ? `Showing top ${u} results:
     }
   };
 }, ps = b(us, {
-  name: rt,
+  name: at,
   description: "Allows users to explore the data in their knowledge graph via cypher query. Generates and executes a cypher query based on the user's inquiry into the knowledge graph, and displays the results in the chat pane without modifying the user's link chart if any. Use this tool when the user is asking an exploratory question about their data as a whole that can be answered via cypher query, for example 'What are the top 5 suppliers by total parts cost?' or 'How many employees do we have in each department?'.",
   schema: ds
-}), at = "generateCypher", hs = l.object({
+}), ot = "generateCypher", hs = l.object({
   prompt: l.string().describe("The user's inquiry into the knowledge graph that needs to be translated into a cypher query.")
 }), ms = async ({ prompt: e }, t) => {
   const { knowledgeGraph: r } = await O(t), o = _.getDefault().helperServices, n = await jn(
@@ -3583,12 +3582,12 @@ ${p.length > u ? `Showing top ${u} results:
     t
   );
   return {
-    toolName: at,
+    toolName: ot,
     status: "success",
     summary: n
   };
 }, ys = b(ms, {
-  name: at,
+  name: ot,
   description: "Generates an Open Cypher query based on the user's prompt which represents an inquiry into the data of the knowledge service and its graph database, attempting to filter based on certain conditions and traverse specified relationships. The generated query should be syntactically correct and optimized for performance.",
   schema: hs
 }), gs = (e) => {
@@ -3632,7 +3631,7 @@ async function fs(e, t) {
     schema: i
   });
 }
-const ot = "searchGraphData", ws = l.object({
+const nt = "searchGraphData", ws = l.object({
   prompt: l.string().describe(
     "The user's inquiry into the knowledge graph, from which a lucene search query will be generated and executed against the graph to return relevant results."
   )
@@ -3659,11 +3658,11 @@ const ot = "searchGraphData", ws = l.object({
   for (const i of o.results)
     j(
       i,
-      (c) => Xe(c)
+      (c) => et(c)
     );
   const n = 10, s = o.results.slice(0, n);
   return {
-    toolName: ot,
+    toolName: nt,
     status: "success",
     summary: `To answer the query, the following lucene query was generated and executed:
     Query: ${a.query}
@@ -3685,10 +3684,10 @@ const ot = "searchGraphData", ws = l.object({
     }
   };
 }, Ss = b(bs, {
-  name: ot,
+  name: nt,
   description: "Allows users to search the knowledge graph for text matching their inquiry, using lucene search syntax, against indexed string properties defined on their entities and relationships. Use this tool when the user asks a question about their knowledge graph data as a whole, that could be answered via lucene text search of properties stored on graph elements, e.g requiring fuzzy matching. Otherwise if the inquiry is looking for connected records (e.g. paths), data aggregations, etc explore the data via the queryGraphData tool.",
   schema: ws
-}), nt = [
+}), st = [
   ts,
   ns,
   ys,
@@ -3706,7 +3705,7 @@ async function vs(e, t) {
     promptText: r,
     messages: e.arcgisKnowledgeMessages,
     inputVariables: a,
-    tools: nt
+    tools: st
   }), n = (o.tool_calls?.length ?? 0) > 0, s = typeof o.text == "string" ? o.text.trim() : "", i = s.length > 0, c = o.content.toString();
   return {
     ...e,
@@ -3717,7 +3716,7 @@ async function vs(e, t) {
   };
 }
 async function xs(e, t) {
-  const r = new G(nt);
+  const r = new G(st);
   try {
     const a = await r.invoke(
       {
@@ -3791,10 +3790,10 @@ async function Es(e, t) {
     outputMessage: c,
     status: "success",
     summary: N(c),
-    arcgisKnowledgeMessages: [...e.arcgisKnowledgeMessages, new Me(c)]
+    arcgisKnowledgeMessages: [...e.arcgisKnowledgeMessages, new ze(c)]
   };
 }
-const Rs = () => new W(Je).addNode("requireArcgisKnowledgeServices", Ts).addNode("agent", vs).addNode("tools", xs).addNode("summarizationLLM", Es).addEdge(U, "requireArcgisKnowledgeServices").addEdge("requireArcgisKnowledgeServices", "agent").addConditionalEdges("agent", (t) => (t.arcgisKnowledgeMessages[t.arcgisKnowledgeMessages.length - 1]?.tool_calls?.length ?? 0) > 0 ? "tools" : C).addConditionalEdges("tools", (t) => t.status === "failed" ? C : "summarizationLLM").addEdge("summarizationLLM", C), $s = String.raw`The purpose of this agent is to work with Knowledge Graph data, a graph database technology that represents and stores data as interconnected entities (nodes) and relationships (edges).
+const Rs = () => new W(Ye).addNode("requireArcgisKnowledgeServices", Ts).addNode("agent", vs).addNode("tools", xs).addNode("summarizationLLM", Es).addEdge(U, "requireArcgisKnowledgeServices").addEdge("requireArcgisKnowledgeServices", "agent").addConditionalEdges("agent", (t) => (t.arcgisKnowledgeMessages[t.arcgisKnowledgeMessages.length - 1]?.tool_calls?.length ?? 0) > 0 ? "tools" : C).addConditionalEdges("tools", (t) => t.status === "failed" ? C : "summarizationLLM").addEdge("summarizationLLM", C), $s = String.raw`The purpose of this agent is to work with Knowledge Graph data, a graph database technology that represents and stores data as interconnected entities (nodes) and relationships (edges).
 This agent has two categories of skills: those that work with an active link chart visualization of a subset of the data in the knowledge graph, and those that work with the knowledge graph data more generally against the entire dataset in the service and database.
 For link charts, the agent enables users to interact with a link chart by adding new entities (also called nodes) or relationships (also called edges), removing existing entities or relationships, 
 expanding the graph from particular entities, finding relationships between specified entities on the link chart and adding them to the link chart, finding all relationships 
@@ -3837,7 +3836,7 @@ _example: "What is the average age of all people who work for Esri?"_`, Si = {
   name: "ArcgisKnowledge Agent",
   description: $s,
   createGraph: Rs,
-  workspace: Je
+  workspace: Ye
 };
 export {
   Si as ArcgisKnowledgeAgent,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/ai-agents",
-  "version": "5.1.0-next.103",
+  "version": "5.1.0-next.104",
   "description": "ArcGIS AI Agents Package",
   "homepage": "https://developers.arcgis.com/javascript/latest/",
   "type": "module",
@@ -20,7 +20,7 @@
     "@langchain/langgraph": "^1.2.6",
     "tslib": "^2.8.1",
     "zod": "^4.3.6",
-    "@arcgis/ai-orchestrator": "5.1.0-next.103"
+    "@arcgis/ai-orchestrator": "5.1.0-next.104"
   },
   "peerDependencies": {
     "@arcgis/core": "^5.1.0-next"