@arcgis/ai-components 5.2.0-next.98 → 6.0.0-next.0

package/dist/agents/tools/filter/setFeatureEffect/adapter.js

@@ -3,75 +3,86 @@ import e from "zod";
 import { tool as h } from "@langchain/core/tools";
 import m from "@arcgis/core/layers/support/FeatureEffect.js";
 import b from "@arcgis/core/layers/support/FeatureFilter.js";
-import { g as y, d } from "../../../../chunks/types.js";
-import { f as w } from "../../../../chunks/fetchAgentContext.js";
-const g = async (t, o, u, n, r, c) => {
-  const a = t.map?.allLayers.find((i) => i.id === o);
-  if (!a)
-    return { success: !1, error: `Layer '${o}' not found.` };
-  const s = a.createQuery();
-  s.where = u ?? "1=1", n && (s.geometry = n, s.spatialRelationship = "intersects", r && (s.distance = r), c && (s.units = c));
+import { g as y, s as w, r as I } from "../../../../chunks/resolveGeometryFilter.js";
+import { f as g } from "../../../../chunks/fetchAgentContext.js";
+import { distanceUnitsSchema as d } from "../../shared/types.js";
+const v = async (t, i, u, n, r, c) => {
+  const s = t.map?.allLayers.find((o) => o.id === i);
+  if (!s)
+    return { success: !1, error: `Layer '${i}' not found.` };
+  const a = s.createQuery();
+  a.where = u ?? "1=1", n && (a.geometry = n, a.spatialRelationship = "intersects", r && (a.distance = r), c && (a.units = c));
   try {
-    const { extent: i, count: l } = await a.queryExtent(s);
-    return !i || l === 0 ? {
+    const { extent: o, count: l } = await s.queryExtent(a);
+    return !o || l === 0 ? {
       success: !1,
-      error: `No features found for filter (where: ${s.where}${n ? ", spatial filter used" : ""})`
-    } : (await t.goTo(i), { success: !0 });
-  } catch (i) {
+      error: `No features found for filter (where: ${a.where}${n ? ", spatial filter used" : ""})`
+    } : (await t.goTo(o), { success: !0 });
+  } catch (o) {
     return {
       success: !1,
-      error: i instanceof Error ? i.message : String(i)
+      error: o instanceof Error ? o.message : String(o)
     };
   }
-}, I = async (t, o, u, n, r, c) => {
-  const a = o.map?.allLayers.find(
+}, x = async (t, i, u, n, r, c) => {
+  const s = i.map?.allLayers.find(
     (f) => f.id === t.layerId
   );
-  if (!a)
+  if (!s)
     return `Could not find target layer with ID: ${t.layerId}`;
-  let s;
+  let a;
   if (r) {
-    const f = await y(r, o);
+    const f = await y(r, i);
     if ("error" in f)
       return f.error;
-    s = f.geometry;
+    a = f.geometry;
   }
-  if (a.featureEffect = null, a.featureEffect = new m({
+  if (s.featureEffect = null, s.featureEffect = new m({
     filter: new b({
       ...t.objectIds?.length ? { objectIds: t.objectIds } : { where: t.where },
-      geometry: s,
+      geometry: a,
       spatialRelationship: "intersects",
       distance: r?.distance,
       units: r?.units
     }),
     includedEffect: u,
     excludedEffect: n
-  }), a.visible = !0, c)
-    return `Applied feature effects to "${a.title ?? t.layerId}" within current map extent.`;
-  const i = t.objectIds?.length ? `${a.objectIdField} IN (${t.objectIds.join(",")})` : t.where, l = await g(
-    o,
-    t.layerId,
+  }), s.visible = !0, c)
+    return `Applied feature effects to "${s.title ?? t.layerId}" within current map extent.`;
+  const o = t.objectIds?.length ? `${s.objectIdField} IN (${t.objectIds.join(",")})` : t.where, l = await v(
     i,
-    s,
+    t.layerId,
+    o,
+    a,
     r?.distance,
     r?.units
-  ), p = a.title ?? t.layerId;
-  return l.success ? `Applied feature effects to target layer "${a.title ?? t.layerId}"${r && "layerId" in r ? ` using geometry from layer "${r.layerId}"` : ""}.` : `Applied filter to "${p}" but no features matched. ${l.error}`;
-}, v = async ({
+  ), p = s.title ?? t.layerId;
+  return l.success ? `Applied feature effects to target layer "${s.title ?? t.layerId}"${r && "layerId" in r ? ` using geometry from layer "${r.layerId}"` : ""}.` : `Applied filter to "${p}" but no features matched. ${l.error}`;
+}, j = async ({
   targetLayer: t,
-  geometryFilter: o,
+  geometryFilter: i,
   useCurrentExtent: u,
   includedEffect: n = "drop-shadow(2px, 2px, 2px, gray)",
   excludedEffect: r = "grayscale(100%) opacity(60%) blur(2px)"
 }, c) => {
-  const { mapView: a } = w(c, ["mapView"]);
-  return await I(t, a, n, r, o, u);
-}, x = e.object({
+  const { mapView: s } = g(c, ["mapView"]), a = I(
+    i,
+    c.state?.agentExecutionContext?.sharedResources
+  );
+  return await x(
+    t,
+    s,
+    n,
+    r,
+    a,
+    u
+  );
+}, E = e.object({
   layerId: e.string().describe("The layerId of the layer containing the geometry by which to filter."),
   where: e.string().describe("The SQL-92 where clause representing the features from which to filter."),
   distance: e.number().optional().describe("The buffer distance around the geometry."),
   units: d.optional().describe("The units for the distance buffer.")
-}), j = e.object({
+}), S = e.object({
   point: e.object({
     x: e.number().describe("X coordinate (longitude) from navigation result"),
     y: e.number().describe("Y coordinate (latitude) from navigation result"),
@@ -81,7 +92,7 @@ const g = async (t, o, u, n, r, c) => {
   }).describe("Point coordinates from a previous navigation/geocoding result"),
   distance: e.number().optional().describe("Optional buffer distance around the point."),
   units: d.optional().describe("The units for the distance buffer.")
-}), E = e.object({
+}), T = e.object({
   targetLayer: e.object({
     layerId: e.string().describe("The layerId of the layer on which to set a feature effect."),
     where: e.string().describe("The SQL-92 where clause representing the features to emphasize."),
@@ -89,7 +100,9 @@ const g = async (t, o, u, n, r, c) => {
       "Array of objectIds from a previous query result. Use this instead of a where clause when the query returned objectIds (e.g. top N results). If provided, takes precedence over where clause."
     )
   }),
-  geometryFilter: e.union([x, j]).optional().describe("Optional geometry-based filtering parameters for spatial queries."),
+  geometryFilter: e.union([E, S, w]).optional().describe(
+    "Optional spatial filter. Use 'sharedResourceId' with an ID from listSharedResources for a previously geocoded location."
+  ),
   useCurrentExtent: e.boolean().optional().describe(
     "Set to true when the previous query used the current map extent as a spatial filter. This ensures the feature effect applies only to features visible in the current view. Default is false."
   ),
@@ -99,11 +112,11 @@ const g = async (t, o, u, n, r, c) => {
   excludedEffect: e.string().default("grayscale(100%) opacity(60%) blur(2px)").describe(
     "The effect applied to features that do not meet the filter requirements. Valid effects include: bloom, blur, brightness, contrast, drop-shadow, grayscale, hue-rotate, invert, opacity, saturate, and sepia. Prefer default unless specified."
   )
-}), A = h(v, {
+}), C = h(j, {
   name: "setFeatureEffect",
   description: "Sets a feature effect on a given layer with given filter parameters and feature effects to emphasize certain features that meet a filter requirement. If no feature effect information is provided, then use the default effect provided.",
-  schema: E
+  schema: T
 });
 export {
-  A as setFeatureEffectTool
+  C as setFeatureEffectTool
 };

package/dist/agents/tools/navigation/goToAddress/adapter.js

@@ -1,51 +1,59 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { tool as p } from "@langchain/core/tools";
-import r from "@arcgis/core/config.js";
-import f from "@arcgis/core/Graphic.js";
-import u from "@arcgis/core/portal/Portal.js";
-import { addressToLocations as S } from "@arcgis/core/rest/locator.js";
-import v from "@arcgis/core/symbols/PictureMarkerSymbol.js";
-import { f as w } from "../../../../chunks/fetchAgentContext.js";
-import c from "zod";
-async function y(e, t) {
-  const a = u.getDefault().helperServices, n = a.geocode.find((h) => h.name === "ArcGIS World Geocoding Service") ?? a.geocode[0];
-  if (!n)
+import { tool as f } from "@langchain/core/tools";
+import s from "@arcgis/core/config.js";
+import u from "@arcgis/core/Graphic.js";
+import S from "@arcgis/core/portal/Portal.js";
+import { addressToLocations as v } from "@arcgis/core/rest/locator.js";
+import w from "@arcgis/core/symbols/PictureMarkerSymbol.js";
+import { f as y } from "../../../../chunks/fetchAgentContext.js";
+import i from "zod";
+async function A(e, t) {
+  const n = S.getDefault().helperServices, c = n.geocode.find((g) => g.name === "ArcGIS World Geocoding Service") ?? n.geocode[0];
+  if (!c)
     throw new Error("No geocoding service found in helperServices.");
-  const i = n.url, d = `${r.assetsPath?.endsWith("/") ? r.assetsPath : `${r.assetsPath}/`}esri/images/search/search-symbol-32.png`, o = (await S(i, {
+  const d = c.url, l = `${s.assetsPath?.endsWith("/") ? s.assetsPath : `${s.assetsPath}/`}esri/images/search/search-symbol-32.png`, o = (await v(d, {
     address: { SingleLine: e },
     outFields: ["Match_addr"]
   }))?.[0];
   if (!o?.extent || !o.location)
     throw new Error(`Could not find location for: ${e}`);
-  const l = new v({
-    url: d,
+  const m = new w({
+    url: l,
     width: 24,
     height: 24
-  }), m = new f({
+  }), h = new u({
     geometry: o.location,
-    symbol: l
+    symbol: m
   });
-  t.graphics.removeAll(), t.graphics.add(m), await t.goTo(o.extent);
-  const g = {
-    address: o.address ?? "",
-    location: o.location ? o.location.toJSON() : null,
-    extent: o.extent ? o.extent.toJSON() : null
-  };
-  return {
-    text: `Successfully zoomed to ${e}.`,
-    sharedStatePatch: { lastResolvedLocation: { value: g } }
+  t.graphics.removeAll(), t.graphics.add(h), await t.goTo(o.extent);
+  const r = {
+    address: o.address ?? e,
+    location: o.location.toJSON(),
+    extent: o.extent.toJSON()
+  }, p = {
+    value: r,
+    sharedStatePatch: { lastResolvedLocation: { value: r } },
+    sharedResourceAdditions: [
+      {
+        kind: "point",
+        description: r.address,
+        payload: r.location
+      }
+    ]
   };
+  return [`Successfully zoomed to ${r.address}.`, p];
 }
 async function T({ address: e }, t) {
-  const { mapView: s } = w(t, ["mapView"]);
-  return await y(e, s);
+  const { mapView: a } = y(t, ["mapView"]);
+  return await A(e, a);
 }
-const x = c.object({
-  address: c.string().describe("The full address or place name to locate.")
-}), E = p(T, {
+const b = i.object({
+  address: i.string().describe("The full address or place name to locate.")
+}), E = f(T, {
   name: "goToAddress",
   description: "Geocodes an address using Esri's World Geocoding Service and zooms the map to that location.",
-  schema: x
+  schema: b,
+  responseFormat: "content_and_artifact"
 });
 export {
   E as goToAddressTool

package/dist/agents/tools/query/getStatistics/adapter.js

@@ -1,30 +1,31 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { tool as L } from "@langchain/core/tools";
 import t from "zod";
-import V from "@arcgis/core/smartMapping/statistics/summaryStatistics.js";
-import E from "@arcgis/core/smartMapping/statistics/uniqueValues.js";
-import O from "@arcgis/core/layers/support/FeatureFilter.js";
-import { c as x, m as b } from "../../../../chunks/mergeWhereClauses.js";
-import { g as N, i as v, a as C, d as S } from "../../../../chunks/types.js";
-import { f as R } from "../../../../chunks/fetchAgentContext.js";
-import { f as U } from "../../../../chunks/fetchService.js";
-const W = async (h) => {
-  const { targetLayer: r, fieldName: n, statisticType: l, mapView: a, layersAndFieldsRegistry: p, geometryFilter: e } = h, s = a.map?.allLayers.find((i) => i.id === r.layerId);
+import E from "@arcgis/core/smartMapping/statistics/summaryStatistics.js";
+import R from "@arcgis/core/smartMapping/statistics/uniqueValues.js";
+import V from "@arcgis/core/layers/support/FeatureFilter.js";
+import { c as x, m as v } from "../../../../chunks/mergeWhereClauses.js";
+import { g as O, i as S, a as C, s as N, r as G } from "../../../../chunks/resolveGeometryFilter.js";
+import { f as U } from "../../../../chunks/fetchAgentContext.js";
+import { f as W } from "../../../../chunks/fetchService.js";
+import { distanceUnitsSchema as I } from "../../shared/types.js";
+const j = async (h) => {
+  const { targetLayer: a, fieldName: n, statisticType: l, mapView: i, layersAndFieldsRegistry: p, geometryFilter: e } = h, s = i.map?.allLayers.find((r) => r.id === a.layerId);
   if (!s)
-    throw new Error(`Layer '${r.layerId}' not found.`);
-  const T = await a.whenLayerView(s), o = p.get(r.layerId)?.fieldRegistry.get(n), I = o?.alias;
+    throw new Error(`Layer '${a.layerId}' not found.`);
+  const w = await i.whenLayerView(s), o = p.get(a.layerId)?.fieldRegistry.get(n), F = o?.alias;
   if (!o)
     throw new Error(`Field '${n}' not found.`);
-  let w, u;
+  let b, u;
   if (e) {
-    const i = await N(e, a);
-    if ("error" in i)
-      throw new Error(i.error);
-    if (!i.geometry)
-      throw v(e) ? new Error(`No features found matching: ${e.where}`) : new Error("Failed to create geometry");
-    if (v(e)) {
-      const g = a.map?.allLayers.find((f) => f.id === e.layerId);
-      w = {
+    const r = await O(e, i);
+    if ("error" in r)
+      throw new Error(r.error);
+    if (!r.geometry)
+      throw S(e) ? new Error(`No features found matching: ${e.where}`) : new Error("Failed to create geometry");
+    if (S(e)) {
+      const g = i.map?.allLayers.find((f) => f.id === e.layerId);
+      b = {
         geometryLayerName: g?.title ?? g?.id,
         geometryLayerId: e.layerId,
         geometryWhere: e.where,
@@ -32,87 +33,90 @@ const W = async (h) => {
         units: e.units,
         applied: !0
       };
-    } else C(e) && (w = {
+    } else C(e) && (b = {
       point: e.point,
       distance: e.distance,
       units: e.units,
       applied: !0
     });
-    u = new O({
-      geometry: i.geometry,
+    u = new V({
+      geometry: r.geometry,
       distance: e.distance,
       units: e.units,
       spatialRelationship: "intersects"
     });
   }
-  const y = x(T, [n], !1);
+  const y = x(w, [n], !1);
   let d = null, m = null;
-  const F = 10;
+  const T = 10;
   if (o.type !== "geometry" && o.type !== "oid" && o.type !== "global-id")
     try {
-      const i = {
+      const r = {
         layer: s,
         useFeaturesInView: y,
-        view: y ? a : void 0,
+        view: y ? i : void 0,
         field: n,
-        sqlWhere: b(s.definitionExpression, r.where),
+        sqlWhere: v(s.definitionExpression, a.where),
         ...u && { filter: u },
         outStatisticTypes: { include: [l] }
       };
-      d = await V(i);
+      d = await E(r);
       const g = ["string", "small-integer", "integer"], f = o.domain?.type === "coded-value" ? o.domain : null;
-      (g.includes(o.type) || f) && (m = (await E({
+      (g.includes(o.type) || f) && (m = (await R({
         layer: s,
         useFeaturesInView: y,
-        view: y ? a : void 0,
+        view: y ? i : void 0,
         field: n,
-        sqlWhere: b(s.definitionExpression, r.where),
+        sqlWhere: v(s.definitionExpression, a.where),
         ...u && { filter: u }
-      })).uniqueValueInfos.sort((c, q) => q.count - c.count).slice(0, F)), m && o.domain?.type === "coded-value" && (m = m.map((c) => ({
+      })).uniqueValueInfos.sort((c, q) => q.count - c.count).slice(0, T)), m && o.domain?.type === "coded-value" && (m = m.map((c) => ({
         ...c,
         value: f ? f.getName(c.value) ?? c.value : c.value
       })));
-    } catch (i) {
-      console.error("Statistics error:", i);
+    } catch (r) {
+      console.error("Statistics error:", r);
     }
   return {
     tool: "getStatistics",
-    layerName: s.title ?? r.layerId,
+    layerName: s.title ?? a.layerId,
     summary: `${l} = ${typeof d?.[l] == "number" ? d[l] : "N/A"}`,
     details: {
       fieldName: n,
-      fieldAlias: I,
+      fieldAlias: F,
       statisticType: l,
       statistic: d?.[l] ?? null,
       summaryStatistics: d,
       uniqueValues: m,
-      where: r.where,
-      spatialFilterInfo: w
+      where: a.where,
+      spatialFilterInfo: b
     }
   };
 };
-async function j({
+async function A({
   targetLayer: h,
-  fieldName: r,
+  fieldName: a,
   statisticType: n,
   geometryFilter: l
-}, a) {
-  const p = U(a, "layersAndFieldsRegistry"), { mapView: e } = R(a, ["mapView"]), s = await W({
+}, i) {
+  const p = W(i, "layersAndFieldsRegistry"), { mapView: e } = U(i, ["mapView"]), s = G(
+    l,
+    i.state?.agentExecutionContext?.sharedResources
+  ), w = await j({
     targetLayer: h,
-    fieldName: r,
+    fieldName: a,
     statisticType: n,
     mapView: e,
     layersAndFieldsRegistry: p,
-    geometryFilter: l
+    geometryFilter: s
   });
-  return JSON.stringify(s, null, 2);
+  return JSON.stringify(w, null, 2);
 }
-const A = t.object({
+const D = t.object({
   layerId: t.string().describe("The layerId of the layer containing the geometry by which to filter."),
   where: t.string().describe("The SQL-92 where clause representing the features from which to filter."),
   distance: t.number().optional().describe("The buffer distance around the geometry."),
-  units: S.optional().describe("The units for the distance buffer.")
-}), G = t.object({
+  units: I.optional().describe("The units for the distance buffer.")
+}), $ = t.object({
   point: t.object({
     x: t.number().describe("X coordinate (longitude) from navigation result"),
     y: t.number().describe("Y coordinate (latitude) from navigation result"),
@@ -121,18 +125,18 @@ const A = t.object({
     }).optional().describe("Spatial reference. Defaults to map's spatial reference if not provided.")
   }).describe("Point coordinates from a previous navigation/geocoding result"),
   distance: t.number().optional().describe("Optional buffer distance around the point."),
-  units: S.optional().describe("The units for the distance buffer.")
-}), D = t.object({
+  units: I.optional().describe("The units for the distance buffer.")
+}), P = t.object({
   targetLayer: t.object({
     layerId: t.string().describe("The layerId of the layer containing the field from which to get a value."),
     where: t.string().describe("The SQL-92 where clause representing the feature from which to get an attribute value.")
   }),
-  geometryFilter: t.union([A, G]).optional().describe(
-    "Geometry filter for spatial queries. Use 'point' option with x/y coordinates from navigation results to find features at that location (point-in-polygon). Use 'layerId/where' option to filter by features from another layer."
+  geometryFilter: t.union([D, $, N]).optional().describe(
+    "Geometry filter for spatial queries. Use 'sharedResourceId' with an ID from listSharedResources for a previously geocoded location. Use 'point' for inline coordinates or 'layerId/where' for features from another layer."
   ),
   fieldName: t.string().describe("The name of the field for which to get statistics. STRICTLY DO NOT use OBJECTID. Use any other field"),
   statisticType: t.enum(["avg", "max", "median", "min", "stddev", "sum", "variance", "nullcount", "count"]).describe("The statistic type to calculate.")
-}), M = L(j, {
+}), ee = L(A, {
   name: "getStatistics",
   description: `Computes a single aggregate statistic (max, min, avg, sum, median, stddev, variance) for a numeric field across matching features. Also returns frequency analysis for categorical fields.
 
@@ -147,8 +151,8 @@ DO NOT USE FOR:
 - Simple counts of features matching a condition — use queryFeatures instead
 
 Only call this tool when the answer requires computing an aggregate (avg, max, min, sum, median, stddev) over a field's values, not just counting or listing features.`,
-  schema: D
+  schema: P
 });
 export {
-  M as getStatisticsTool
+  ee as getStatisticsTool
 };