@arcgis/ai-components 5.2.0-next.71 → 5.2.0-next.73

package/dist/chunks/dataExplorationGraph.js

@@ -1,28 +1,31 @@
 /* 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, R as D, r as z, S as b, T as P } from "./adapter.js";
+import { StateGraph as I, START as V, END as v } from "@langchain/langgraph/web";
+import { g as T, y as R, t as C, z as k, r as D, D as N, A as z } from "./adapter.js";
 import "@arcgis/core/identity/IdentityManager.js";
 import "@arcgis/core/portal/Portal.js";
 import "@arcgis/core/request.js";
 import "@arcgis/toolkit/string";
-import { h as _, e as Q } from "./generateLayerDescriptions.js";
-import { AIMessage as O } from "@langchain/core/messages";
+import { h as b, e as P } from "./generateLayerDescriptions.js";
+import { AIMessage as Q } from "@langchain/core/messages";
 import { s as n } from "./index.js";
 import "@langchain/openai";
 import "@arcgis/core/config.js";
 import "@arcgis/core/core/reactiveUtils.js";
 import "@arcgis/core/layers/FeatureLayer.js";
 import "@langchain/core/prompts";
-import { h as $ } 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";
+import { h as A } from "./toolCallResponse.js";
+import { b as _ } from "./formatFeatureAttributes.js";
+import { ToolNode as O } from "@langchain/langgraph/prebuilt";
+import j from "@arcgis/core/smartMapping/statistics/summaryStatistics.js";
+import G from "@arcgis/core/smartMapping/statistics/uniqueValues.js";
+import { f as U } from "./fetchAgentContext.js";
+import { f } from "./fetchService.js";
 const W = async (t, e) => (await n({ text: "Exiting Data Exploration agent" }, e), t), B = async (t, e) => {
   await n({ 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: l, userTimezoneOffset: s } = R(), r = {
+  const { userTimezone: l, userTimezoneOffset: s } = _(), r = {
     layerFieldInfo: t.layerFieldInfo,
     userTimezone: l,
     userTimezoneOffset: s,
@@ -30,13 +33,13 @@ 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
-  }, o = await _({
+  }, o = await b({
     promptText: d,
     modelTier: "advanced",
     config: e,
     messages: t.dataExplorationMessages,
     inputVariables: r,
-    tools: C
+    tools: R
   }), i = [...t.dataExplorationMessages, o];
   if (!((o.tool_calls?.length ?? 0) > 0))
     return await n({ text: "LLM determined no filter changes needed" }, e), {
@@ -45,13 +48,13 @@ const W = async (t, e) => (await n({ text: "Exiting Data Exploration agent" }, e
       // Don't overwrite outputMessage if query already set it
     };
   const m = i, g = o.content.toString();
-  return await $(o, e), { ...t, dataExplorationMessages: m, outputMessage: g };
+  return await A(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, o = r.lastNavigatedFeatures?.value, i = r.lastResolvedLocation?.value;
+  const { userTimezone: l, userTimezoneOffset: s } = _(), r = t.agentExecutionContext.sharedState, o = r.lastNavigatedFeatures?.value, i = r.lastResolvedLocation?.value;
   let c = "none";
   if (o != null)
     try {
@@ -78,22 +81,22 @@ const W = async (t, e) => (await n({ text: "Exiting Data Exploration agent" }, e
     priorSteps: t.agentExecutionContext.priorSteps,
     lastNavigatedFeatures: c,
     lastResolvedLocation: m
-  }, y = await _({
+  }, y = await b({
     promptText: d,
     modelTier: "advanced",
     config: e,
     messages: t.dataExplorationMessages,
     inputVariables: g,
-    tools: V
+    tools: k
   }), h = (y.tool_calls?.length ?? 0) > 0, p = y.content.toString();
-  return await $(y, e), {
+  return await A(y, e), {
     ...t,
     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.
     ...h ? {} : { outputMessage: p },
     status: "success",
-    summary: p && !h ? N(p) : "Query planning completed."
+    summary: p && !h ? C(p) : "Query planning completed."
   };
 }, J = async (t, e) => {
   try {
@@ -103,20 +106,20 @@ 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
-    }, s = await Q({
+    }, s = await P({
       promptText: d,
       modelTier: "fast",
       config: e,
       messages: t.dataExplorationMessages,
       inputVariables: l
-    }), r = typeof s == "string" ? s : s.content, o = new O(r);
+    }), r = typeof s == "string" ? s : s.content, o = new Q(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.",
+      summary: i ? C(i) : "Summary generated.",
       dataExplorationMessages: [...t.dataExplorationMessages, o]
     };
   } catch (a) {
@@ -129,7 +132,7 @@ async function K(t, e) {
     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 j(C, { handleToolErrors: !1 }).invoke(
+  const l = await new O(R, { handleToolErrors: !1 }).invoke(
     {
       messages: t.dataExplorationMessages
     },
@@ -144,9 +147,9 @@ const X = 10, Y = ["string", "small-integer", "integer"], Z = async (t, e, { inc
   let l = null, s = null;
   try {
     if (e.type !== "geometry" && e.type !== "oid" && e.type !== "global-id") {
-      a && (l = await G({ layer: t, field: e.name }));
+      a && (l = await j({ layer: t, field: e.name }));
       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) => ({
+      d && (Y.includes(e.type) || r) && (s = (await G({ 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
       }))));
@@ -192,7 +195,7 @@ async function te(t, e, a, d = !0) {
         fieldName: u.name,
         didFetchStatistics: q
       }), q) {
-        const A = Z(g, u, {
+        const $ = Z(g, u, {
           includeSummaryStatistics: E,
           includeUniqueValues: w
         }).then((F) => {
@@ -202,7 +205,7 @@ async function te(t, e, a, d = !0) {
           };
           E && (S.summaryStatistics = F.summaryStatistics), w && (S.uniqueValues = F.uniqueValues), y.set(u.name, { ...u, statistics: S }), u.statistics = S;
         });
-        s.push(A);
+        s.push($);
       }
       h.fieldInfos.push(u);
     }
@@ -220,7 +223,7 @@ function ae(t, e) {
 const se = async (t, e) => {
   try {
     await n({ text: "Preparing field information for vector search results" }, e);
-    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(
+    const a = f(e, "layersAndFieldsRegistry"), { mapView: d } = U(e, ["mapView"]), { assignedTask: l, userRequest: s } = t.agentExecutionContext, r = ae(l, s), { layerFieldInfo: o, didFetchStatistics: i, fieldStatisticsFetchStatus: c } = await te(
       t.vectorSearchFieldResults,
       a,
       d,
@@ -290,10 +293,10 @@ ${o}` : i = "Vector search completed. No matching layers found.", await n({ text
       e
     ), new Error(`Vector search failed: ${a instanceof Error ? a.message : String(a)}`);
   }
-}, le = (t, e) => z(["layerSearch", "fieldSearch", "layersAndFieldsRegistry"], "Data Exploration Agent")(
+}, le = (t, e) => D(["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(N).addNode("requireDataExplorationServices", le).addNode("vectorSearchLayers", ne).addNode("vectorSearchFields", oe).addNode("fieldStatistics", se).addNode("queryAgent", H).addNode("queryTools", z).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(
@@ -312,13 +315,13 @@ ${o}` : i = "Vector search completed. No matching layers found.", await n({ text
   _Example: “What’s the average population?”_  
   _Example: “Which values are in the status field?”_
 
-  This agent does NOT handle help/metadata requests such as listing available layers, listing field names/columns/attributes for a layer, or capability guidance.`, Ce = {
+  This agent does NOT handle help/metadata requests such as listing available layers, listing field names/columns/attributes for a layer, or capability guidance.`, Ae = {
   id: "dataExploration",
   name: "Data Exploration Agent",
   description: de,
   createGraph: ce,
-  workspace: b
+  workspace: N
 };
 export {
-  Ce as D
+  Ae as D
 };

package/dist/chunks/fetchAgentContext.js

@@ -0,0 +1,13 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+function c(e, o) {
+  const t = e?.configurable?.context;
+  if (!t || typeof t != "object")
+    throw new Error("Agent context missing");
+  const n = o.filter((i) => !(i in t));
+  if (n.length)
+    throw new Error(`Agent context missing: ${n.join(", ")}`);
+  return t;
+}
+export {
+  c as f
+};

package/dist/chunks/fetchService.js

@@ -0,0 +1,10 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+const i = (s, e) => {
+  const r = s?.configurable?.services?.[e];
+  if (r == null)
+    throw new Error(`${e} missing in config.configurable.services`);
+  return r;
+};
+export {
+  i as f
+};

package/dist/chunks/formatFeatureAttributes.js

@@ -0,0 +1,132 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { formatDateOnly as F, convertDateFormatToIntlOptions as m, formatTimeOnly as T, formatDate as p } from "@arcgis/core/intl.js";
+const w = /* @__PURE__ */ new Set([
+  "date",
+  "esrifieldtypedate",
+  "date-only",
+  "dateonly",
+  "esrifieldtypedateonly",
+  "time-only",
+  "timeonly",
+  "esrifieldtypetimeonly",
+  "timestamp-offset",
+  "timestampoffset",
+  "esrifieldtypetimestampoffset"
+]), g = (t) => {
+  if (!t)
+    return !1;
+  const e = t.toLowerCase();
+  return w.has(e);
+}, d = (t) => {
+  if (t instanceof Date)
+    return Number.isNaN(t.getTime()) ? null : t;
+  if (typeof t == "number" && Number.isFinite(t)) {
+    const e = new Date(t);
+    return Number.isNaN(e.getTime()) ? null : e;
+  }
+  return null;
+}, I = (t) => !t || t === "system" ? Intl.DateTimeFormat().resolvedOptions().timeZone : t === "unknown" ? "UTC" : t, N = (t) => {
+  if (typeof t == "string" && t)
+    return t;
+  const e = d(t);
+  return e ? e.toISOString().slice(0, 10) : null;
+}, k = () => {
+  const t = (/* @__PURE__ */ new Date()).getTimezoneOffset(), e = t <= 0 ? "+" : "-", n = Math.floor(Math.abs(t) / 60).toString().padStart(2, "0"), o = (Math.abs(t) % 60).toString().padStart(2, "0"), i = `${e}${n}:${o}`;
+  return { userTimezone: Intl.DateTimeFormat().resolvedOptions().timeZone, userTimezoneOffset: i };
+}, S = (t, e, n) => {
+  const o = e?.toLowerCase();
+  if (o && !g(o))
+    return t;
+  if (o === "date-only") {
+    const s = N(t);
+    return s ? F(s, m("short-date")) : t;
+  }
+  if (o === "time-only") {
+    if (typeof t == "string" && t)
+      return T(t, m("long-time"));
+    const s = d(t);
+    return s ? p(s, {
+      ...m("long-time"),
+      timeZone: "UTC"
+    }) : t;
+  }
+  const i = d(t);
+  return i ? p(i, {
+    ...m("short-date-short-time"),
+    timeZone: I(n)
+  }) : t;
+}, l = (t, e, n) => {
+  if (t && typeof t != "function") {
+    const o = "getField" in n && n.getField?.(t), i = o && "getFieldDomain" in n && n.getFieldDomain ? n.getFieldDomain(o.name) : null;
+    if (i?.type === "coded-value") {
+      const s = i.codedValues.find((r) => r.code === e);
+      return s ? s.name : null;
+    }
+  }
+  return null;
+}, O = (t) => !t || t === "system" ? Intl.DateTimeFormat().resolvedOptions().timeZone : t === "unknown" ? "UTC" : t, C = (t) => {
+  if (t instanceof Date)
+    return Number.isNaN(t.getTime()) ? null : t;
+  if (typeof t == "number" && Number.isFinite(t)) {
+    const e = new Date(t);
+    return Number.isNaN(e.getTime()) ? null : e;
+  }
+  if (typeof t == "string" && t) {
+    const e = new Date(t);
+    return Number.isNaN(e.getTime()) ? null : e;
+  }
+  return null;
+}, V = (t, e) => {
+  if (typeof t != "number")
+    return t;
+  const n = {};
+  e.minimumFractionDigits !== void 0 && (n.minimumFractionDigits = e.minimumFractionDigits), e.maximumFractionDigits !== void 0 && (n.maximumFractionDigits = e.maximumFractionDigits), e.useGrouping === "always" ? n.useGrouping = !0 : e.useGrouping === "never" && (n.useGrouping = !1);
+  try {
+    return new Intl.NumberFormat(void 0, n).format(t);
+  } catch {
+    return t;
+  }
+}, x = (t, e, n) => {
+  const o = C(t);
+  if (!o)
+    return t;
+  const i = {};
+  e.dateStyle ? i.dateStyle = e.dateStyle : (e.year && (i.year = e.year), e.month && (i.month = e.month)), e.timeStyle && (i.timeStyle = e.timeStyle), e.timeStyle && e.hour12 === "always" ? i.hour12 = !0 : e.timeStyle && e.hour12 === "never" && (i.hour12 = !1), i.timeZone = O(n);
+  try {
+    return new Intl.DateTimeFormat(void 0, i).format(o);
+  } catch {
+    return t;
+  }
+}, y = (t, e) => t.getFieldAlias?.(e) ?? t.fieldsIndex?.get(e)?.alias ?? t.fieldsIndex?.get(e)?.name ?? e, D = (t, e, n, o, i) => {
+  if (n == null)
+    return n;
+  const r = t.getFieldConfiguration?.(e)?.fieldFormat;
+  return r?.type === "number" ? V(n, r) : r?.type === "date-time" ? !o || g(o) ? x(n, r, i) : n : S(n, o, i);
+}, L = (t, e, n, o) => {
+  const i = t.fieldsIndex?.get(e), s = l(e, n, t) ?? n;
+  return D(t, e, s, i?.type, o);
+}, $ = (t, e) => y(t, e), j = (t, e, n) => {
+  const o = t.objectIdField, i = e.features.map(
+    (r) => r.attributes[o]
+  ), s = e.features.map((r) => {
+    const u = r.attributes, c = {};
+    return t.fields.forEach((a) => {
+      if (!Object.hasOwn(u, a.name))
+        return;
+      const f = u[a.name];
+      if (a.name === o) {
+        c[a.name] = f;
+        return;
+      }
+      const b = l(a.name, f, t) ?? f, h = y(t, a.name);
+      c[h] = D(t, a.name, b, a.type, n);
+    }), c;
+  });
+  return { objectIds: i, attributes: s };
+};
+export {
+  j as a,
+  k as b,
+  L as f,
+  $ as g
+};