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

package/dist/chunks/dataExplorationGraph.js

@@ -1,9 +1,9 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { StateGraph as b, START as V, END as v } from "@langchain/langgraph/web";
-import { g as T, O as R, P as C, t as N, Q as k, f as y, R as D, r as z, S as $, T as P } from "./adapter.js";
+import { g as T, O as R, P as C, t as N, Q as k, f as h, 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 { s as l, j as A, h as Q } from "./generateLayerDescriptions.js";
+import { s as c, j as A, h as Q } from "./generateLayerDescriptions.js";
 import { AIMessage as j } from "@langchain/core/messages";
 import "@langchain/openai";
 import "@arcgis/core/core/reactiveUtils.js";
@@ -14,9 +14,9 @@ import { h as I } from "./toolCallResponse.js";
 import { ToolNode as O } 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 l({ text: "Exiting Data Exploration agent" }, e), t), B = async (t, e) => {
-  await l({ text: "Requesting LLM for layer filter results" }, e);
-  const c = await T("data_explore_filter_prompt");
+const W = async (t, e) => (await c({ text: "Exiting Data Exploration agent" }, e), t), B = async (t, e) => {
+  await c({ text: "Requesting LLM for layer filter results" }, 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: n, userTimezoneOffset: r } = R(), o = {
@@ -28,61 +28,70 @@ const W = async (t, e) => (await l({ text: "Exiting Data Exploration agent" }, e
     userRequest: t.agentExecutionContext.userRequest,
     priorSteps: t.agentExecutionContext.priorSteps
   }, s = await A({
-    promptText: c,
+    promptText: d,
     modelTier: "advanced",
     messages: t.dataExplorationMessages,
     inputVariables: o,
     tools: C
   }), i = [...t.dataExplorationMessages, s];
   if (!((s.tool_calls?.length ?? 0) > 0))
-    return await l({ text: "LLM determined no filter changes needed" }, e), {
+    return await c({ text: "LLM determined no filter changes needed" }, e), {
       ...t,
       dataExplorationMessages: i
       // Don't overwrite outputMessage if query already set it
     };
-  const m = [...i, s], g = s.content.toString();
-  return await I(s, e), { ...t, dataExplorationMessages: m, outputMessage: g };
+  const m = [...i, s], p = s.content.toString();
+  return await I(s, e), { ...t, dataExplorationMessages: m, outputMessage: p };
 }, H = async (t, e) => {
-  await l({ text: "Requesting LLM for layer query results" }, e);
-  const c = await T("data_explore_query_prompt");
+  await c({ 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: n, userTimezoneOffset: r } = R(), o = {
+  const { userTimezone: n, userTimezoneOffset: r } = R(), s = t.agentExecutionContext.sharedState.lastNavigatedFeatures, i = s && typeof s == "object" && "value" in s ? s.value : s;
+  let l = "none";
+  if (i != null)
+    try {
+      l = JSON.stringify(i);
+    } catch {
+      l = "none";
+    }
+  const m = {
     layerFieldInfo: t.layerFieldInfo,
     userTimezone: n,
     userTimezoneOffset: r,
     assignedTask: t.agentExecutionContext.assignedTask,
     userRequest: t.agentExecutionContext.userRequest,
-    priorSteps: t.agentExecutionContext.priorSteps
-  }, s = await A({
-    promptText: c,
+    priorSteps: t.agentExecutionContext.priorSteps,
+    lastNavigatedFeatures: l
+  }, p = await A({
+    promptText: d,
     modelTier: "advanced",
     messages: t.dataExplorationMessages,
-    inputVariables: o,
+    inputVariables: m,
     tools: k
-  }), i = s.content.toString();
-  return await I(s, e), {
+  }), y = p.content.toString();
+  return await I(p, e), {
     ...t,
-    dataExplorationMessages: [...t.dataExplorationMessages, s],
-    outputMessage: i,
+    dataExplorationMessages: [...t.dataExplorationMessages, p],
+    outputMessage: y,
     status: "success",
-    summary: i ? N(i) : "Query executed."
+    summary: y ? N(y) : "Query executed."
   };
-}, K = async (t, e) => {
+}, J = async (t, e) => {
   try {
-    await l({ text: "Requesting LLM for summary on query results" }, e);
-    const c = await T("summarize_query_response_prompt"), n = {
+    await c({ text: "Requesting LLM for summary on query results" }, e);
+    const d = await T("summarize_query_response_prompt"), n = {
       queryResponse: t.queryResponse,
       assignedTask: t.agentExecutionContext.assignedTask,
       userRequest: t.agentExecutionContext.userRequest,
       priorSteps: t.agentExecutionContext.priorSteps
     }, r = await Q({
-      promptText: c,
+      promptText: d,
       modelTier: "fast",
       messages: t.dataExplorationMessages,
       inputVariables: n
     }), o = typeof r == "string" ? r : r.content, s = new j(o);
-    await l({ text: `Received response from LLM: ${o}` }, e);
+    await c({ text: `Received response from LLM: ${o}` }, e);
     const i = o;
     return {
       ...t,
@@ -92,28 +101,28 @@ const W = async (t, e) => (await l({ text: "Exiting Data Exploration agent" }, e
       dataExplorationMessages: [...t.dataExplorationMessages, s]
     };
   } catch (a) {
-    throw await l({ text: "Error during filter LLM request" }, e), new Error(`Error during filter LLM request: ${a instanceof Error ? a.message : String(a)}`);
+    throw await c({ text: "Error during filter LLM request" }, e), new Error(`Error during filter LLM request: ${a instanceof Error ? a.message : String(a)}`);
   }
 };
-async function J(t, e) {
-  const c = await new O(C).invoke(
+async function K(t, e) {
+  const d = await new O(C).invoke(
     {
       messages: t.dataExplorationMessages
     },
     e
   );
-  return await l(
-    { text: `Finished executing layer filter tool: ${c.messages.map((n) => n.content).join(", ")}` },
+  return await c(
+    { text: `Finished executing layer filter tool: ${d.messages.map((n) => n.content).join(", ")}` },
     e
   ), { ...t };
 }
-const X = 10, Y = ["string", "small-integer", "integer"], Z = async (t, e, { includeSummaryStatistics: a = !0, includeUniqueValues: c = !0 } = {}) => {
+const X = 10, Y = ["string", "small-integer", "integer"], Z = async (t, e, { includeSummaryStatistics: a = !0, includeUniqueValues: d = !0 } = {}) => {
   let n = null, r = null;
   try {
     if (e.type !== "geometry" && e.type !== "oid" && e.type !== "global-id") {
       a && (n = await G({ layer: t, field: e.name }));
       const o = e.domain?.type === "coded-value" ? e.domain : null;
-      c && (Y.includes(e.type) || o) && (r = (await U({ layer: t, field: e.name })).uniqueValueInfos.sort((s, i) => i.count - s.count).slice(0, X), o && (r = r.map((s) => ({
+      d && (Y.includes(e.type) || o) && (r = (await U({ layer: t, field: e.name })).uniqueValueInfos.sort((s, i) => i.count - s.count).slice(0, X), o && (r = r.map((s) => ({
         ...s,
         value: o.getName(s.value) ?? s.value
       }))));
@@ -129,49 +138,49 @@ const X = 10, Y = ["string", "small-integer", "integer"], Z = async (t, e, { inc
 function ee(t, e) {
   return ["string", "small-integer", "integer"].includes(t) || e === "coded-value";
 }
-async function te(t, e, a, c = !0) {
+async function te(t, e, a, d = !0) {
   const n = [], r = [], o = [];
   for (const s of t) {
-    let i = function(p) {
-      const d = e.get(p)?.layerItem;
-      return d ? [
-        d.name && `Name: ${d.name}`,
-        d.title && `Title: ${d.title}`,
-        d.description && `Description: ${d.description}`
-      ].filter(Boolean).join(" | ") : p;
+    let i = function(g) {
+      const u = e.get(g)?.layerItem;
+      return u ? [
+        u.name && `Name: ${u.name}`,
+        u.title && `Title: ${u.title}`,
+        u.description && `Description: ${u.description}`
+      ].filter(Boolean).join(" | ") : g;
     };
-    const { layerId: u, results: m } = s, g = a.map?.allLayers.find((p) => p.id === u), S = e.get(u)?.fieldRegistry;
-    if (!S)
+    const { layerId: l, results: m } = s, p = a.map?.allLayers.find((g) => g.id === l), y = e.get(l)?.fieldRegistry;
+    if (!y)
       continue;
-    let h = n.find((p) => p.layerId === u);
-    h || (h = {
-      layerId: u,
-      layerSummary: i(u),
+    let f = n.find((g) => g.layerId === l);
+    f || (f = {
+      layerId: l,
+      layerSummary: i(l),
       fieldInfos: []
-    }, n.push(h));
-    for (const p of m) {
-      const d = S.get(p.name);
-      if (!d)
+    }, n.push(f));
+    for (const g of m) {
+      const u = y.get(g.name);
+      if (!u)
         continue;
-      const f = d.statistics, E = c && !f?.summaryStatistics, w = ee(d.type, d.domain?.type) && !f?.uniqueValues, q = E || w;
+      const x = u.statistics, E = d && !x?.summaryStatistics, w = ee(u.type, u.domain?.type) && !x?.uniqueValues, q = E || w;
       if (o.push({
-        layerId: u,
-        fieldName: d.name,
+        layerId: l,
+        fieldName: u.name,
         didFetchStatistics: q
       }), q) {
-        const _ = Z(g, d, {
+        const _ = Z(p, u, {
           includeSummaryStatistics: E,
           includeUniqueValues: w
-        }).then((M) => {
-          const x = {
-            summaryStatistics: f?.summaryStatistics ?? null,
-            uniqueValues: f?.uniqueValues ?? null
+        }).then((F) => {
+          const S = {
+            summaryStatistics: x?.summaryStatistics ?? null,
+            uniqueValues: x?.uniqueValues ?? null
           };
-          E && (x.summaryStatistics = M.summaryStatistics), w && (x.uniqueValues = M.uniqueValues), S.set(d.name, { ...d, statistics: x }), d.statistics = x;
+          E && (S.summaryStatistics = F.summaryStatistics), w && (S.uniqueValues = F.uniqueValues), y.set(u.name, { ...u, statistics: S }), u.statistics = S;
         });
         r.push(_);
       }
-      h.fieldInfos.push(d);
+      f.fieldInfos.push(u);
     }
   }
   return await Promise.all(r), {
@@ -180,79 +189,79 @@ async function te(t, e, a, c = !0) {
     fieldStatisticsFetchStatus: o
   };
 }
-const F = /\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 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;
 function ae(t, e) {
-  return F.test(t) || F.test(e);
+  return M.test(t) || M.test(e);
 }
 const se = async (t, e) => {
   try {
-    await l({ text: "Preparing field information for vector search results" }, e);
-    const a = y(e, "layersAndFieldsRegistry"), { mapView: c } = D(e), { assignedTask: n, userRequest: r } = t.agentExecutionContext, o = ae(n, r), { layerFieldInfo: s, didFetchStatistics: i, fieldStatisticsFetchStatus: u } = await te(
+    await c({ text: "Preparing field information for vector search results" }, e);
+    const a = h(e, "layersAndFieldsRegistry"), { mapView: d } = D(e), { assignedTask: n, userRequest: r } = t.agentExecutionContext, o = ae(n, r), { layerFieldInfo: s, didFetchStatistics: i, fieldStatisticsFetchStatus: l } = await te(
       t.vectorSearchFieldResults,
       a,
-      c,
+      d,
       o
     );
-    i ? await l({ text: "Statistics fetched" }, e) : await l({ text: "Statistics skipped" }, e);
-    for (const m of u)
-      await l(
+    i ? await c({ text: "Statistics fetched" }, e) : await c({ text: "Statistics skipped" }, e);
+    for (const m of l)
+      await c(
         {
           text: `  - ${m.fieldName} - stats ${m.didFetchStatistics ? "fetched" : "skipped"}`
         },
         e
       );
-    return await l({ text: "Field information prepared" }, e), { ...t, layerFieldInfo: s };
+    return await c({ text: "Field information prepared" }, e), { ...t, layerFieldInfo: s };
   } catch (a) {
-    throw await l({ text: "Error during fetching statistics" }, e), new Error(`Error during fetching statistics: ${a instanceof Error ? a.message : String(a)}`);
+    throw await c({ 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) => {
   try {
-    await l({ text: "Similarity search to find fields" }, e);
-    const a = y(e, "fieldSearch"), c = y(e, "layersAndFieldsRegistry"), n = y(e, "embeddingCache"), r = await a.searchFields({
+    await c({ text: "Similarity search to find fields" }, e);
+    const a = h(e, "fieldSearch"), d = h(e, "layersAndFieldsRegistry"), n = h(e, "embeddingCache"), r = await a.searchFields({
       text: t.agentExecutionContext.assignedTask,
       layerIds: t.vectorSearchLayerIds,
       minScore: L,
       topResults: re,
       embeddingCache: n
-    }), o = r.map(({ layerId: i, results: u }) => {
-      const m = u.map((g) => `  - ${g.name} (${g.score.toFixed(2)})`).join(`
+    }), o = r.map(({ layerId: i, results: l }) => {
+      const m = l.map((p) => `  - ${p.name} (${p.score.toFixed(2)})`).join(`
 `);
-      return `${c.get(i)?.layerItem.name ?? i}:
+      return `${d.get(i)?.layerItem.name ?? i}:
 ${m}`;
     }).join(`
 `);
     let s;
     return r.length > 0 ? s = `Vector search completed. Matching layers and fields with scores:
-${o}` : s = `No vector search results found for score over ${L}.`, await l({ text: s }, e), {
+${o}` : s = `No vector search results found for score over ${L}.`, await c({ text: s }, e), {
       ...t,
       vectorSearchFieldResults: r
     };
   } catch (a) {
-    throw await l(
+    throw await c(
       { text: `Error during vector search: ${a instanceof Error ? a.message : String(a)}` },
       e
     ), new Error(`Vector search failed: ${a instanceof Error ? a.message : String(a)}`);
   }
 }, ie = 0.7, ne = async (t, e) => {
   try {
-    await l(
+    await c(
       { text: `Similarity search to find layers: ${t.agentExecutionContext.assignedTask}` },
       e
     );
-    const a = y(e, "layerSearch"), c = y(e, "layersAndFieldsRegistry"), n = y(e, "embeddingCache"), r = await a.searchLayers({
+    const a = h(e, "layerSearch"), d = h(e, "layersAndFieldsRegistry"), n = h(e, "embeddingCache"), r = await a.searchLayers({
       text: t.agentExecutionContext.assignedTask,
       minScore: ie,
       embeddingCache: n
-    }), o = r.map((u) => u.id), s = r.map(({ id: u, score: m }) => `${c.get(u)?.layerItem.name ?? u} (${m.toFixed(2)})`).join(`
+    }), o = r.map((l) => l.id), s = r.map(({ id: l, score: m }) => `${d.get(l)?.layerItem.name ?? l} (${m.toFixed(2)})`).join(`
 `);
     let i;
     return o.length > 0 ? i = `Vector search completed. Matching layers with scores:
-${s}` : i = "Vector search completed. No matching layers found.", await l({ text: i }, e), {
+${s}` : i = "Vector search completed. No matching layers found.", await c({ text: i }, e), {
       ...t,
       vectorSearchLayerIds: o
     };
   } catch (a) {
-    throw await l(
+    throw await c(
       { text: `Error during vector search: ${a instanceof Error ? a.message : String(a)}` },
       e
     ), new Error(`Vector search failed: ${a instanceof Error ? a.message : String(a)}`);
@@ -260,7 +269,7 @@ ${s}` : i = "Vector search completed. No matching layers found.", await l({ text
 }, le = (t, e) => z(["layerSearch", "fieldSearch", "layersAndFieldsRegistry"], "Data Exploration Agent")(
   t,
   e
-), ce = () => new b($).addNode("requireDataExplorationServices", le).addNode("vectorSearchLayers", ne).addNode("vectorSearchFields", oe).addNode("fieldStatistics", se).addNode("queryAgent", H).addNode("queryTools", P).addNode("summarizeQueryResponseLLM", K).addNode("filterAgent", B).addNode("filterTools", J).addNode("earlyExit", W).addEdge(V, "requireDataExplorationServices").addEdge("requireDataExplorationServices", "vectorSearchLayers").addConditionalEdges(
+), ce = () => new 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(V, "requireDataExplorationServices").addEdge("requireDataExplorationServices", "vectorSearchLayers").addConditionalEdges(
   "vectorSearchLayers",
   (e) => e.vectorSearchLayerIds.length ? "vectorSearchFields" : "earlyExit"
 ).addConditionalEdges(
@@ -277,7 +286,7 @@ ${s}` : i = "Vector search completed. No matching layers found.", await l({ 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?”_`, Fe = {
+  _Example: “Which values are in the status field?”_`, Me = {
   id: "dataExploration",
   name: "Data Exploration Agent",
   description: de,
@@ -285,5 +294,5 @@ ${s}` : i = "Vector search completed. No matching layers found.", await l({ text
   workspace: $
 };
 export {
-  Fe as D
+  Me as D
 };

package/dist/chunks/data_explore_query_prompt.js

@@ -36,11 +36,26 @@ Latest user request:
 Prior steps:
 {priorSteps}
 
+Last navigated features from shared state (if available):
+{lastNavigatedFeatures}
+
 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 chat history only when necessary to understand conversational references, and do not override the assigned task.
 
+### Anchor selection rule (strict, single source of truth)
+
+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\`
+
+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.
+
 ### Fresh WHERE clause rule
 
 Start with a fresh WHERE clause for each new question. Do not inherit filters from previous questions UNLESS the assigned task explicitly references previous results (see "Referencing Previously Identified Features" below).
@@ -63,11 +78,9 @@ 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.
 
-When the assigned task uses words like "these", "those", "them", "the same ones" referring to features from a previous turn:
-
-- If the previous query used useCurrentExtent: true → use useCurrentExtent: true with where: "1=1"
-- If the previous assistant response mentions specific objectIds or feature IDs → use {{objectIdField}} IN (id1, id2, ...) to scope to those features
-- If neither is available, use the same WHERE clause and layer from the previous query turn to re-select the same features
+- If the anchored context indicates \`useCurrentExtent: true\`, use \`useCurrentExtent: true\` with \`where: "1=1"\`.
+- If the anchored context includes specific feature IDs/objectIds, scope to those IDs.
+- Otherwise, use the anchored \`layerId\` + \`where\` combination.
 
 ### Mixed Questions
 

package/dist/chunks/intent_prompt.js

@@ -117,7 +117,6 @@ Do not reinterpret the request into a different form.
 - \`requiresFollowUp\` should indicate a likely next agent step, not uncertainty about the current request
 - Set \`requiresFollowUp\` to \`true\` only when another orchestration step will likely be needed after this agent succeeds
 - Set \`requiresFollowUp\` to \`false\` when a successful result from this agent would likely complete the user-visible task
-- Default to \`false\`
 `;
 export {
   e as default

package/dist/chunks/summarize_query_response_prompt.js

@@ -58,6 +58,7 @@ In all cases:
 
 - Focus on **notable attribute values**, **commonalities or differences**, and **interesting trends**.
 - If the feature list is empty or not meaningful, state that clearly.
+- Only use fields present in query results. Do not make guesses.
 
 ### STRICT OUTPUT RULES