@arcgis/ai-components 5.2.0-next.12 → 5.2.0-next.14

package/dist/chunks/arcgisKnowledgeGraph.js

@@ -1,8 +1,9 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { StateGraph as f, START as x, END as h, Command as k } from "@langchain/langgraph/web";
-import { a as b, c as _, b as K, d as A, e as T, s as v, q as S, g as u, h as q, t as c, r as M, i as C, G as E, j as m } from "./adapter.js";
+import { a as b, c as _, b as K, d as A, e as T, s as v, q, g as u, h as M, t as c, r as S, i as C, G as E, j as m } from "./adapter.js";
 import "@arcgis/core/identity/IdentityManager.js";
 import "@arcgis/core/portal/Portal.js";
+import "@arcgis/toolkit/string";
 import { h as G, e as N } from "./generateLayerDescriptions.js";
 import { AIMessage as R } from "@langchain/core/messages";
 import "@langchain/core/callbacks/dispatch/web";
@@ -21,10 +22,10 @@ const w = [
   A,
   T,
   v,
-  S
+  q
 ];
 async function z(e, a) {
-  const i = await u("arcgis_knowledge_tool_prompt"), o = q(a), n = {
+  const i = await u("arcgis_knowledge_tool_prompt"), o = M(a), n = {
     assignedTask: e.agentExecutionContext.assignedTask,
     userRequest: e.agentExecutionContext.userRequest,
     priorSteps: e.agentExecutionContext.priorSteps,
@@ -126,7 +127,7 @@ async function I(e, a) {
 }
 const V = (e, a) => (
   //agent services (ex: embeddingsWorker) would go in the array below, if required.
-  M([], "ArcgisKnowledge Agent")(e, a)
+  S([], "ArcgisKnowledge Agent")(e, a)
 );
 async function j(e, a) {
   const o = (e.arcgisKnowledgeToolResult ?? []).map((d) => ({
@@ -152,7 +153,7 @@ async function j(e, a) {
   };
 }
 function g(e) {
-  return async (a, i) => i?.configurable?.abortSignal?.aborted ? (await p({ text: "Knowledge Agent execution cancelled" }, i), new k({
+  return async (a, i) => i?.signal?.aborted ? (await p({ text: "Knowledge Agent execution cancelled" }, i), new k({
     goto: h,
     update: {
       outputMessage: "Knowledge Agent execution cancelled",
@@ -199,7 +200,7 @@ _example: "Discover and add all the relationships originating at 'Entity E' to t
 _example: "Show me all entities with a name similar to 'Smith' and add them to the link chart"_
 _example: "Find reports in my graph that have a title similar to 'Quarterly Earnings'"_
 _example: "Find John Smith and all people he has made phone calls to in the last year"_
-_example: "What is the average age of all people who work for Esri?"_`, re = {
+_example: "What is the average age of all people who work for Esri?"_`, ie = {
   id: "arcgisKnowledge",
   name: "ArcgisKnowledge Agent",
   description: P,
@@ -207,5 +208,5 @@ _example: "What is the average age of all people who work for Esri?"_`, re = {
   workspace: m
 };
 export {
-  re as A
+  ie as A
 };

package/dist/chunks/dataExplorationGraph.js

@@ -1,10 +1,11 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { StateGraph as I, START as k, END as v } from "@langchain/langgraph/web";
-import { g as T, O as R, P as C, t as N, Q as V, f as h, R as D, r as z, S as b, T as P } from "./adapter.js";
+import { g as T, O as R, P as C, t as N, Q as V, f, R as D, r as z, S as _, T as P } from "./adapter.js";
 import "@arcgis/core/identity/IdentityManager.js";
 import "@arcgis/core/portal/Portal.js";
-import { h as _, e as Q } from "./generateLayerDescriptions.js";
-import { AIMessage as j } from "@langchain/core/messages";
+import "@arcgis/toolkit/string";
+import { h as $, e as Q } from "./generateLayerDescriptions.js";
+import { AIMessage as O } from "@langchain/core/messages";
 import { s as n } from "./index.js";
 import "@langchain/openai";
 import "@arcgis/core/config.js";
@@ -12,8 +13,8 @@ import "@arcgis/core/core/reactiveUtils.js";
 import "@arcgis/core/layers/FeatureLayer.js";
 import "@arcgis/core/request.js";
 import "@langchain/core/prompts";
-import { h as $ } from "./toolCallResponse.js";
-import { ToolNode as O } from "@langchain/langgraph/prebuilt";
+import { h as b } from "./toolCallResponse.js";
+import { ToolNode as j } from "@langchain/langgraph/prebuilt";
 import G from "@arcgis/core/smartMapping/statistics/summaryStatistics.js";
 import U from "@arcgis/core/smartMapping/statistics/uniqueValues.js";
 const W = async (t, e) => (await n({ text: "Exiting Data Exploration agent" }, e), t), B = async (t, e) => {
@@ -21,7 +22,7 @@ const W = async (t, e) => (await n({ text: "Exiting Data Exploration agent" }, e
   const d = await T("data_explore_filter_prompt");
   if (!e?.configurable)
     throw new Error("config.configurable is required for layer filter tools");
-  const { userTimezone: l, userTimezoneOffset: s } = R(), o = {
+  const { userTimezone: l, userTimezoneOffset: s } = R(), r = {
     layerFieldInfo: t.layerFieldInfo,
     userTimezone: l,
     userTimezoneOffset: s,
@@ -29,59 +30,70 @@ const W = async (t, e) => (await n({ text: "Exiting Data Exploration agent" }, e
     assignedTask: t.agentExecutionContext.assignedTask,
     userRequest: t.agentExecutionContext.userRequest,
     priorSteps: t.agentExecutionContext.priorSteps
-  }, r = await _({
+  }, o = await $({
     promptText: d,
     modelTier: "advanced",
     config: e,
     messages: t.dataExplorationMessages,
-    inputVariables: o,
+    inputVariables: r,
     tools: C
-  }), i = [...t.dataExplorationMessages, r];
-  if (!((r.tool_calls?.length ?? 0) > 0))
+  }), i = [...t.dataExplorationMessages, o];
+  if (!((o.tool_calls?.length ?? 0) > 0))
     return await n({ text: "LLM determined no filter changes needed" }, e), {
       ...t,
       dataExplorationMessages: i
       // Don't overwrite outputMessage if query already set it
     };
-  const m = i, p = r.content.toString();
-  return await $(r, e), { ...t, dataExplorationMessages: m, outputMessage: p };
+  const m = i, g = o.content.toString();
+  return await b(o, e), { ...t, dataExplorationMessages: m, outputMessage: g };
 }, H = async (t, e) => {
   await n({ text: "Requesting LLM for layer query results" }, e);
   const d = await T("data_explore_query_prompt");
   if (!e?.configurable)
     throw new Error("config.configurable is required for layer query tools");
-  const { userTimezone: l, userTimezoneOffset: s } = R(), r = t.agentExecutionContext.sharedState.lastNavigatedFeatures, i = r && typeof r == "object" && "value" in r ? r.value : r;
+  const { userTimezone: l, userTimezoneOffset: s } = R(), r = t.agentExecutionContext.sharedState, o = r.lastNavigatedFeatures?.value, i = r.lastResolvedLocation?.value;
   let c = "none";
-  if (i != null)
+  if (o != null)
     try {
-      c = JSON.stringify(i);
+      c = JSON.stringify(o);
     } catch {
       c = "none";
     }
-  const m = {
+  let m = "none";
+  if (i != null)
+    try {
+      m = JSON.stringify({
+        address: i.address,
+        location: i.location
+      });
+    } catch {
+      m = "none";
+    }
+  const g = {
     layerFieldInfo: t.layerFieldInfo,
     userTimezone: l,
     userTimezoneOffset: s,
     assignedTask: t.agentExecutionContext.assignedTask,
     userRequest: t.agentExecutionContext.userRequest,
     priorSteps: t.agentExecutionContext.priorSteps,
-    lastNavigatedFeatures: c
-  }, p = await _({
+    lastNavigatedFeatures: c,
+    lastResolvedLocation: m
+  }, y = await $({
     promptText: d,
     modelTier: "advanced",
     config: e,
     messages: t.dataExplorationMessages,
-    inputVariables: m,
+    inputVariables: g,
     tools: V
-  }), f = (p.tool_calls?.length ?? 0) > 0, g = p.content.toString();
-  return await $(p, e), {
+  }), h = (y.tool_calls?.length ?? 0) > 0, p = y.content.toString();
+  return await b(y, e), {
     ...t,
-    dataExplorationMessages: [...t.dataExplorationMessages, p],
+    dataExplorationMessages: [...t.dataExplorationMessages, y],
     // Only emit output here when no tools are being called.
     // For tool-calling flows, downstream summarizer nodes provide the final user-facing message.
-    ...f ? {} : { outputMessage: g },
+    ...h ? {} : { outputMessage: p },
     status: "success",
-    summary: g && !f ? N(g) : "Query planning completed."
+    summary: p && !h ? N(p) : "Query planning completed."
   };
 }, J = async (t, e) => {
   try {
@@ -97,15 +109,15 @@ const W = async (t, e) => (await n({ text: "Exiting Data Exploration agent" }, e
       config: e,
       messages: t.dataExplorationMessages,
       inputVariables: l
-    }), o = typeof s == "string" ? s : s.content, r = new j(o);
-    await n({ text: `Received response from LLM: ${o}` }, e);
-    const i = o;
+    }), r = typeof s == "string" ? s : s.content, o = new O(r);
+    await n({ text: `Received response from LLM: ${r}` }, e);
+    const i = r;
     return {
       ...t,
       outputMessage: i,
       status: "success",
       summary: i ? N(i) : "Summary generated.",
-      dataExplorationMessages: [...t.dataExplorationMessages, r]
+      dataExplorationMessages: [...t.dataExplorationMessages, o]
     };
   } catch (a) {
     throw await n({ text: "Error during filter LLM request" }, e), new Error(`Error during filter LLM request: ${a instanceof Error ? a.message : String(a)}`);
@@ -113,11 +125,11 @@ const W = async (t, e) => (await n({ text: "Exiting Data Exploration agent" }, e
 };
 async function K(t, e) {
   if ((t.queryResponse ?? []).some((s) => {
-    const o = s.details;
-    return typeof o == "object" && o !== null && "error" in o;
+    const r = s.details;
+    return typeof r == "object" && r !== null && "error" in r;
   }))
     return await n({ text: "Skipping layer filter tool because query response contains an error." }, e), { ...t };
-  const l = await new O(C, { handleToolErrors: !1 }).invoke(
+  const l = await new j(C, { handleToolErrors: !1 }).invoke(
     {
       messages: t.dataExplorationMessages
     },
@@ -133,14 +145,14 @@ const X = 10, Y = ["string", "small-integer", "integer"], Z = async (t, e, { inc
   try {
     if (e.type !== "geometry" && e.type !== "oid" && e.type !== "global-id") {
       a && (l = await G({ layer: t, field: e.name }));
-      const o = e.domain?.type === "coded-value" ? e.domain : null;
-      d && (Y.includes(e.type) || o) && (s = (await U({ layer: t, field: e.name })).uniqueValueInfos.sort((r, i) => i.count - r.count).slice(0, X), o && (s = s.map((r) => ({
-        ...r,
-        value: o.getName(r.value) ?? r.value
+      const r = e.domain?.type === "coded-value" ? e.domain : null;
+      d && (Y.includes(e.type) || r) && (s = (await U({ layer: t, field: e.name })).uniqueValueInfos.sort((o, i) => i.count - o.count).slice(0, X), r && (s = s.map((o) => ({
+        ...o,
+        value: r.getName(o.value) ?? o.value
       }))));
     }
-  } catch (o) {
-    console.error(`Error fetching statistics for field ${e.name}:`, o);
+  } catch (r) {
+    console.error(`Error fetching statistics for field ${e.name}:`, r);
   }
   return {
     summaryStatistics: l,
@@ -151,36 +163,36 @@ function ee(t, e) {
   return ["string", "small-integer", "integer"].includes(t) || e === "coded-value";
 }
 async function te(t, e, a, d = !0) {
-  const l = [], s = [], o = [];
-  for (const r of t) {
-    let i = function(y) {
-      const u = e.get(y)?.layerItem;
+  const l = [], s = [], r = [];
+  for (const o of t) {
+    let i = function(p) {
+      const u = e.get(p)?.layerItem;
       return u ? [
         u.name && `Name: ${u.name}`,
         u.title && `Title: ${u.title}`,
         u.description && `Description: ${u.description}`
-      ].filter(Boolean).join(" | ") : y;
+      ].filter(Boolean).join(" | ") : p;
     };
-    const { layerId: c, results: m } = r, p = a.map?.allLayers.find((y) => y.id === c), f = e.get(c)?.fieldRegistry;
-    if (!f)
+    const { layerId: c, results: m } = o, g = a.map?.allLayers.find((p) => p.id === c), y = e.get(c)?.fieldRegistry;
+    if (!y)
       continue;
-    let g = l.find((y) => y.layerId === c);
-    g || (g = {
+    let h = l.find((p) => p.layerId === c);
+    h || (h = {
       layerId: c,
       layerSummary: i(c),
       fieldInfos: []
-    }, l.push(g));
-    for (const y of m) {
-      const u = f.get(y.name);
+    }, l.push(h));
+    for (const p of m) {
+      const u = y.get(p.name);
       if (!u)
         continue;
       const x = u.statistics, E = d && !x?.summaryStatistics, w = ee(u.type, u.domain?.type) && !x?.uniqueValues, q = E || w;
-      if (o.push({
+      if (r.push({
         layerId: c,
         fieldName: u.name,
         didFetchStatistics: q
       }), q) {
-        const A = Z(p, u, {
+        const A = Z(g, u, {
           includeSummaryStatistics: E,
           includeUniqueValues: w
         }).then((F) => {
@@ -188,31 +200,31 @@ async function te(t, e, a, d = !0) {
             summaryStatistics: x?.summaryStatistics ?? null,
             uniqueValues: x?.uniqueValues ?? null
           };
-          E && (S.summaryStatistics = F.summaryStatistics), w && (S.uniqueValues = F.uniqueValues), f.set(u.name, { ...u, statistics: S }), u.statistics = S;
+          E && (S.summaryStatistics = F.summaryStatistics), w && (S.uniqueValues = F.uniqueValues), y.set(u.name, { ...u, statistics: S }), u.statistics = S;
         });
         s.push(A);
       }
-      g.fieldInfos.push(u);
+      h.fieldInfos.push(u);
     }
   }
   return await Promise.all(s), {
     layerFieldInfo: l,
     didFetchStatistics: s.length > 0,
-    fieldStatisticsFetchStatus: o
+    fieldStatisticsFetchStatus: r
   };
 }
-const M = /\b(average|avg|mean|median|max(?:imum)?|min(?:imum)?|sum|total|count|std(?:dev|\s*deviation)|variance|null\s*count|missing\s*values?|range)\b/iu;
+const L = /\b(average|avg|mean|median|max(?:imum)?|min(?:imum)?|sum|total|count|std(?:dev|\s*deviation)|variance|null\s*count|missing\s*values?|range)\b/iu;
 function ae(t, e) {
-  return M.test(t) || M.test(e);
+  return L.test(t) || L.test(e);
 }
 const se = async (t, e) => {
   try {
     await n({ text: "Preparing field information for vector search results" }, e);
-    const a = h(e, "layersAndFieldsRegistry"), { mapView: d } = D(e), { assignedTask: l, userRequest: s } = t.agentExecutionContext, o = ae(l, s), { layerFieldInfo: r, didFetchStatistics: i, fieldStatisticsFetchStatus: c } = await te(
+    const a = f(e, "layersAndFieldsRegistry"), { mapView: d } = D(e), { assignedTask: l, userRequest: s } = t.agentExecutionContext, r = ae(l, s), { layerFieldInfo: o, didFetchStatistics: i, fieldStatisticsFetchStatus: c } = await te(
       t.vectorSearchFieldResults,
       a,
       d,
-      o
+      r
     );
     i ? await n({ text: "Statistics fetched" }, e) : await n({ text: "Statistics skipped" }, e);
     for (const m of c)
@@ -222,29 +234,29 @@ const se = async (t, e) => {
         },
         e
       );
-    return await n({ text: "Field information prepared" }, e), { ...t, layerFieldInfo: r };
+    return await n({ text: "Field information prepared" }, e), { ...t, layerFieldInfo: o };
   } catch (a) {
     throw await n({ text: "Error during fetching statistics" }, e), new Error(`Error during fetching statistics: ${a instanceof Error ? a.message : String(a)}`);
   }
-}, L = 0.7, re = 10, oe = async (t, e) => {
+}, M = 0.7, re = 10, oe = async (t, e) => {
   try {
     await n({ text: "Similarity search to find fields" }, e);
-    const a = h(e, "fieldSearch"), d = h(e, "layersAndFieldsRegistry"), l = h(e, "embeddingCache"), s = await a.searchFields({
+    const a = f(e, "fieldSearch"), d = f(e, "layersAndFieldsRegistry"), l = f(e, "embeddingCache"), s = await a.searchFields({
       text: t.agentExecutionContext.assignedTask,
       layerIds: t.vectorSearchLayerIds,
-      minScore: L,
+      minScore: M,
       topResults: re,
       embeddingCache: l
-    }), o = s.map(({ layerId: i, results: c }) => {
-      const m = c.map((p) => `  - ${p.name} (${p.score.toFixed(2)})`).join(`
+    }), r = s.map(({ layerId: i, results: c }) => {
+      const m = c.map((g) => `  - ${g.name} (${g.score.toFixed(2)})`).join(`
 `);
       return `${d.get(i)?.layerItem.name ?? i}:
 ${m}`;
     }).join(`
 `);
-    let r;
-    return s.length > 0 ? r = `Vector search completed. Matching layers and fields with scores:
-${o}` : r = `No vector search results found for score over ${L}.`, await n({ text: r }, e), {
+    let o;
+    return s.length > 0 ? o = `Vector search completed. Matching layers and fields with scores:
+${r}` : o = `No vector search results found for score over ${M}.`, await n({ text: o }, e), {
       ...t,
       vectorSearchFieldResults: s
     };
@@ -260,17 +272,17 @@ ${o}` : r = `No vector search results found for score over ${L}.`, await n({ tex
       { text: `Similarity search to find layers: ${t.agentExecutionContext.assignedTask}` },
       e
     );
-    const a = h(e, "layerSearch"), d = h(e, "layersAndFieldsRegistry"), l = h(e, "embeddingCache"), s = await a.searchLayers({
+    const a = f(e, "layerSearch"), d = f(e, "layersAndFieldsRegistry"), l = f(e, "embeddingCache"), s = await a.searchLayers({
       text: t.agentExecutionContext.assignedTask,
       minScore: ie,
       embeddingCache: l
-    }), o = s.map((c) => c.id), r = s.map(({ id: c, score: m }) => `${d.get(c)?.layerItem.name ?? c} (${m.toFixed(2)})`).join(`
+    }), r = s.map((c) => c.id), o = s.map(({ id: c, score: m }) => `${d.get(c)?.layerItem.name ?? c} (${m.toFixed(2)})`).join(`
 `);
     let i;
-    return o.length > 0 ? i = `Vector search completed. Matching layers with scores:
-${r}` : i = "Vector search completed. No matching layers found.", await n({ text: i }, e), {
+    return r.length > 0 ? i = `Vector search completed. Matching layers with scores:
+${o}` : i = "Vector search completed. No matching layers found.", await n({ text: i }, e), {
       ...t,
-      vectorSearchLayerIds: o
+      vectorSearchLayerIds: r
     };
   } catch (a) {
     throw await n(
@@ -281,7 +293,7 @@ ${r}` : i = "Vector search completed. No matching layers found.", await n({ text
 }, le = (t, e) => z(["layerSearch", "fieldSearch", "layersAndFieldsRegistry"], "Data Exploration Agent")(
   t,
   e
-), ce = () => new I(b).addNode("requireDataExplorationServices", le).addNode("vectorSearchLayers", ne).addNode("vectorSearchFields", oe).addNode("fieldStatistics", se).addNode("queryAgent", H).addNode("queryTools", P).addNode("summarizeQueryResponseLLM", J).addNode("filterAgent", B).addNode("filterTools", K).addNode("earlyExit", W).addEdge(k, "requireDataExplorationServices").addEdge("requireDataExplorationServices", "vectorSearchLayers").addConditionalEdges(
+), ce = () => new I(_).addNode("requireDataExplorationServices", le).addNode("vectorSearchLayers", ne).addNode("vectorSearchFields", oe).addNode("fieldStatistics", se).addNode("queryAgent", H).addNode("queryTools", P).addNode("summarizeQueryResponseLLM", J).addNode("filterAgent", B).addNode("filterTools", K).addNode("earlyExit", W).addEdge(k, "requireDataExplorationServices").addEdge("requireDataExplorationServices", "vectorSearchLayers").addConditionalEdges(
   "vectorSearchLayers",
   (e) => e.vectorSearchLayerIds.length ? "vectorSearchFields" : "earlyExit"
 ).addConditionalEdges(
@@ -298,13 +310,13 @@ ${r}` : i = "Vector search completed. No matching layers found.", await n({ text
   This also includes questions that ask which feature meets a given condition or where a particular feature in the data is located (e.g., “Where is the spring with the highest elevation?”). However, this agent does not handle addresses.
   _Example: “How many features are there?”_  
   _Example: “What’s the average population?”_  
-  _Example: “Which values are in the status field?”_`, Re = {
+  _Example: “Which values are in the status field?”_`, Ce = {
   id: "dataExploration",
   name: "Data Exploration Agent",
   description: de,
   createGraph: ce,
-  workspace: b
+  workspace: _
 };
 export {
-  Re as D
+  Ce as D
 };

package/dist/chunks/data_explore_query_prompt.js

@@ -39,10 +39,13 @@ Prior steps:
 Last navigated features from shared state (if available):
 {lastNavigatedFeatures}
 
+Last resolved location from shared state (if available):
+{lastResolvedLocation}
+
 Use the assigned task as the primary instruction for the current query.
 Use the latest user request as supporting context when needed.
 Use prior steps only when the assigned task or user request clearly depends on earlier results.
-Use lastNavigatedFeatures as authoritative context for map-navigation references when present.
+Use shared-state context (\`lastResolvedLocation\`, \`lastNavigatedFeatures\`) for referential follow-ups when relevant.
 Use chat history only when necessary to understand conversational references, and do not override the assigned task.
 
 ### Anchor selection rule (strict, single source of truth)
@@ -50,8 +53,9 @@ Use chat history only when necessary to understand conversational references, an
 When the request is referential (for example: "this", "it", "that", "those", "them", "of those", "the same one(s)"), choose exactly one anchor using this priority order:
 
 1. Explicit entity named in the current request (if present)
-2. \`lastNavigatedFeatures\` (if present)
-3. The immediately previous successful relevant step from \`priorSteps\`
+2. \`lastResolvedLocation\` (if present and the request refers to a place/location)
+3. \`lastNavigatedFeatures\` (if present)
+4. The immediately previous successful relevant step from \`priorSteps\`
 
 After selecting the anchor, keep that anchor for this query and do not switch to an older entity.
 If \`lastNavigatedFeatures\` is used as the anchor, reuse its \`layerId\` and \`where\` for query scope unless the current request explicitly overrides it.
@@ -78,7 +82,8 @@ Start with a fresh WHERE clause for each new question. Do not inherit filters fr
 
 This is an exception to the "fresh WHERE clause" rule above.
 
-- If the anchored context indicates \`useCurrentExtent: true\`, use \`useCurrentExtent: true\` with \`where: "1=1"\`.
+- If the anchored context is \`lastResolvedLocation\` with a point, prefer \`geometryFilter.point\` and use \`where: "1=1"\` unless the user asked for additional attribute filters.
+- Only use \`useCurrentExtent: true\` when the user explicitly asks about the current view/map extent (for example: "in my view", "on my map", "visible now").
 - If the anchored context includes specific feature IDs/objectIds, scope to those IDs.
 - Otherwise, use the anchored \`layerId\` + \`where\` combination.