@arcgis/ai-components 5.2.0-next.97 → 5.2.0-next.99

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

@@ -3,75 +3,85 @@ 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, d, s as w, r as I } from "../../../../chunks/resolvePointGeometryFilter.js";
+import { f as g } from "../../../../chunks/fetchAgentContext.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 +91,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 +99,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,10 +111,10 @@ 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, {
+}), A = 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

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,30 @@
 /* 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, d as I, s as N, r as G } from "../../../../chunks/resolvePointGeometryFilter.js";
+import { f as U } from "../../../../chunks/fetchAgentContext.js";
+import { f as W } from "../../../../chunks/fetchService.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 +32,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.")
+}), P = 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 +124,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.")
+}), $ = 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, P, 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, {
+}), _ = 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 +150,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: $
 });
 export {
-  M as getStatisticsTool
+  _ as getStatisticsTool
 };

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

@@ -1,103 +1,106 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { tool as T } from "@langchain/core/tools";
+import { tool as S } from "@langchain/core/tools";
 import e from "zod";
-import S from "@arcgis/core/rest/support/TopFeaturesQuery.js";
+import T from "@arcgis/core/rest/support/TopFeaturesQuery.js";
 import B from "@arcgis/core/rest/support/TopFilter.js";
 import { m as C, c as v } from "../../../../chunks/mergeWhereClauses.js";
 import { a as I } from "../../../../chunks/formatFeatureAttributes.js";
-import { g as q, d as y } from "../../../../chunks/types.js";
+import { g as q, d as y, s as x, r as G } from "../../../../chunks/resolvePointGeometryFilter.js";
 import { f as N } from "../../../../chunks/fetchAgentContext.js";
-const k = (i) => i.flatMap((t) => t.split(",")).map((t) => t.trim()).map((t) => t.split(/\s+/u)[0]?.replace(/^"|"$/gu, "")).filter((t) => !!t), x = async (i, t, a, s, l) => {
-  const n = a.map?.allLayers.find((o) => o.id === i.layerId), d = await a.whenLayerView(n), c = n.title ?? i.layerId;
-  let u;
-  if (s) {
-    const o = await q(s, a);
+const k = (s) => s.flatMap((t) => t.split(",")).map((t) => t.trim()).map((t) => t.split(/\s+/u)[0]?.replace(/^"|"$/gu, "")).filter((t) => !!t), R = async (s, t, n, i, l) => {
+  const a = n.map?.allLayers.find((o) => o.id === s.layerId), c = await n.whenLayerView(a), u = a.title ?? s.layerId;
+  let d;
+  if (i) {
+    const o = await q(i, n);
     if ("error" in o)
       return {
         tool: "getTopFeatures",
-        layerName: c,
+        layerName: u,
         summary: "Geometry lookup failed",
         details: { error: o.error }
       };
     if (!o.geometry)
       return {
         tool: "getTopFeatures",
-        layerName: c,
+        layerName: u,
         summary: "No features found for geometry filter",
         details: {
-          error: `No features found matching: ${"where" in s ? s.where : "unknown criteria"}`
+          error: `No features found matching: ${"where" in i ? i.where : "unknown criteria"}`
         }
       };
-    u = o.geometry;
-  } else l && (u = a.extent.clone());
-  const h = t.groupByFields && t.groupByFields.length > 0, f = n.objectIdField, p = i.outFields.includes("*") ? ["*"] : [.../* @__PURE__ */ new Set([...i.outFields, f])];
+    d = o.geometry;
+  } else l && (d = n.extent.clone());
+  const p = t.groupByFields && t.groupByFields.length > 0, f = a.objectIdField, h = s.outFields.includes("*") ? ["*"] : [.../* @__PURE__ */ new Set([...s.outFields, f])];
   try {
     let o;
-    if (h) {
-      const r = new S({
-        where: i.where || "1=1",
-        outFields: p,
-        orderByFields: i.orderByFields,
-        geometry: u,
-        spatialRelationship: u ? "intersects" : void 0,
-        distance: s?.distance,
-        units: s?.units,
+    if (p) {
+      const r = new T({
+        where: s.where || "1=1",
+        outFields: h,
+        orderByFields: s.orderByFields,
+        geometry: d,
+        spatialRelationship: d ? "intersects" : void 0,
+        distance: i?.distance,
+        units: i?.units,
         topFilter: new B({
           topCount: t.topCount,
           groupByFields: t.groupByFields,
           orderByFields: t.orderByFields
         })
       });
-      o = await n.queryTopFeatures(r);
+      o = await a.queryTopFeatures(r);
     } else {
-      const r = n.createQuery();
-      r.where = C(n.definitionExpression, i.where || "1=1"), r.outFields = p.length ? p : ["*"], r.orderByFields = t.orderByFields, r.returnGeometry = !1, r.num = t.topCount, u && (r.geometry = u, r.spatialRelationship = "intersects"), s?.distance && (r.distance = s.distance), s?.units && (r.units = s.units), r.outSpatialReference = a.spatialReference;
+      const r = a.createQuery();
+      r.where = C(a.definitionExpression, s.where || "1=1"), r.outFields = h.length ? h : ["*"], r.orderByFields = t.orderByFields, r.returnGeometry = !1, r.num = t.topCount, d && (r.geometry = d, r.spatialRelationship = "intersects"), i?.distance && (r.distance = i.distance), i?.units && (r.units = i.units), r.outSpatialReference = n.spatialReference;
       const m = [
-        .../* @__PURE__ */ new Set([...i.outFields, ...k(t.orderByFields)])
-      ], w = v(d, m, l ?? !1);
+        .../* @__PURE__ */ new Set([...s.outFields, ...k(t.orderByFields)])
+      ], w = v(c, m, l ?? !1);
       try {
-        o = w ? await d.queryFeatures(r) : await n.queryFeatures(r);
+        o = w ? await c.queryFeatures(r) : await a.queryFeatures(r);
       } catch (F) {
-        console.warn("Client-side query failed, falling back to server:", F), o = await n.queryFeatures(r);
+        console.warn("Client-side query failed, falling back to server:", F), o = await a.queryFeatures(r);
       }
     }
-    const g = o.features.map((r) => r.attributes[f]), { attributes: b } = I(n, o, a.timeZone);
+    const g = o.features.map((r) => r.attributes[f]), { attributes: b } = I(a, o, n.timeZone);
     return {
       tool: "getTopFeatures",
-      layerName: c,
+      layerName: u,
       summary: `Top ${t.topCount} features extracted`,
       details: {
         topCount: t.topCount,
         attributes: b,
         objectIds: g,
         objectIdField: f,
-        where: i.where,
+        where: s.where,
         orderByFields: t.orderByFields,
-        ...h && { groupByFields: t.groupByFields }
+        ...p && { groupByFields: t.groupByFields }
       }
     };
   } catch (o) {
     return {
       tool: "getTopFeatures",
-      layerName: c,
+      layerName: u,
       summary: "Query failed",
       details: { error: o instanceof Error ? o.message : String(o) }
     };
   }
 }, j = async ({
-  targetLayer: i,
+  targetLayer: s,
   topFilter: t,
-  geometryFilter: a,
-  useCurrentExtent: s
+  geometryFilter: n,
+  useCurrentExtent: i
 }, l) => {
-  const { mapView: n } = N(l, ["mapView"]), d = await x(i, t, n, a, s);
-  return JSON.stringify(d, null, 2);
-}, G = e.object({
+  const { mapView: a } = N(l, ["mapView"]), c = G(
+    n,
+    l.state?.agentExecutionContext?.sharedResources
+  ), u = await R(s, t, a, c, i);
+  return JSON.stringify(u, null, 2);
+}, D = 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: y.optional().describe("The units for the distance buffer.")
-}), R = e.object({
+}), Q = 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"),
@@ -107,7 +110,7 @@ const k = (i) => i.flatMap((t) => t.split(",")).map((t) => t.trim()).map((t) =>
   }).describe("Point coordinates from a previous navigation/geocoding result"),
   distance: e.number().optional().describe("Optional buffer distance around the point."),
   units: y.optional().describe("The units for the distance buffer.")
-}), Q = e.object({
+}), U = e.object({
   targetLayer: e.object({
     layerId: e.string().describe("The layerId of the layer containing the field from which to get a value."),
     where: e.string().describe("The SQL-92 where clause representing the feature from which to get an attribute value."),
@@ -118,8 +121,8 @@ const k = (i) => i.flatMap((t) => t.split(",")).map((t) => t.trim()).map((t) =>
       ).default("*")
     )
   }),
-  geometryFilter: e.union([G, R]).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: e.union([D, Q, x]).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."
   ),
   topFilter: e.object({
     topCount: e.number().describe("Number of top features to return per group."),
@@ -131,11 +134,11 @@ const k = (i) => i.flatMap((t) => t.split(",")).map((t) => t.trim()).map((t) =>
   useCurrentExtent: e.boolean().optional().describe(
     "Set to true ONLY when user explicitly asks about features 'in my view', 'on my map', 'I am looking at'. Default is false (queries entire layer)."
   )
-}), z = T(j, {
+}), J = S(j, {
   name: "getTopFeatures",
   description: 'Returns top N features ranked by an existing field value. Use for "highest", "lowest", "top N" questions where ranking is based on a field that already exists in the data (e.g., population, value, date, depth). orderByFields must be actual field names with ASC/DESC. Do NOT use aggregate functions like COUNT(), SUM(), AVG() - those require getStatistics.',
-  schema: Q
+  schema: U
 });
 export {
-  z as getTopFeaturesTool
+  J as getTopFeaturesTool
 };