@arcgis/ai-components 5.2.0-next.99 → 6.0.0-next.1

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

@@ -1,144 +1,173 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { tool as S } from "@langchain/core/tools";
-import e from "zod";
-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, s as x, r as G } from "../../../../chunks/resolvePointGeometryFilter.js";
-import { f as N } from "../../../../chunks/fetchAgentContext.js";
-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)
+import { tool as x } from "@langchain/core/tools";
+import t from "zod";
+import G from "@arcgis/core/rest/support/TopFeaturesQuery.js";
+import R from "@arcgis/core/rest/support/TopFilter.js";
+import { m as w, c as j } from "../../../../chunks/mergeWhereClauses.js";
+import { a as D } from "../../../../chunks/formatFeatureAttributes.js";
+import { g as Q, s as $, r as E } from "../../../../chunks/resolveGeometryFilter.js";
+import { f as O } from "../../../../chunks/resolveFieldNames.js";
+import { f as U } from "../../../../chunks/fetchAgentContext.js";
+import { distanceUnitsSchema as B } from "../../shared/types.js";
+const T = (o) => o.flatMap((e) => e.split(",")).map((e) => e.trim()).map((e) => e.split(/\s+/u)[0]?.replace(/^"|"$/gu, "")).filter((e) => !!e), W = (o, e, n) => {
+  if (n === "date") {
+    const s = e instanceof Date ? e : typeof e == "number" ? new Date(e) : void 0;
+    if (s && Number.isFinite(s.getTime())) {
+      const l = s.toISOString().replace("T", " ").replace("Z", " +00:00");
+      return `${o} = TIMESTAMP'${l}'`;
+    }
+    return;
+  }
+  if (typeof e == "number" && Number.isFinite(e))
+    return `${o} = ${e}`;
+  if (typeof e == "string")
+    return `${o} = '${e.replace(/'/gu, "''")}'`;
+}, A = async (o, e, n, s, l) => {
+  const i = n.map?.allLayers.find((r) => r.id === o.layerId), p = await n.whenLayerView(i), c = i.title ?? o.layerId, y = O(
+    o.outFields,
+    i.fields.map((r) => r.name)
+  );
+  let f;
+  if (s) {
+    const r = await Q(s, n);
+    if ("error" in r)
       return {
         tool: "getTopFeatures",
-        layerName: u,
+        layerName: c,
         summary: "Geometry lookup failed",
-        details: { error: o.error }
+        details: { error: r.error }
       };
-    if (!o.geometry)
+    if (!r.geometry)
       return {
         tool: "getTopFeatures",
-        layerName: u,
+        layerName: c,
         summary: "No features found for geometry filter",
         details: {
-          error: `No features found matching: ${"where" in i ? i.where : "unknown criteria"}`
+          error: `No features found matching: ${"where" in s ? s.where : "unknown criteria"}`
         }
       };
-    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])];
+    f = r.geometry;
+  } else l && (f = n.extent.clone());
+  const F = e.groupByFields && e.groupByFields.length > 0, g = i.objectIdField, b = y.includes("*") ? ["*"] : [.../* @__PURE__ */ new Set([...y, g])];
   try {
-    let o;
-    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
+    let r;
+    if (F) {
+      const u = new G({
+        where: o.where || "1=1",
+        outFields: b,
+        orderByFields: o.orderByFields,
+        geometry: f,
+        spatialRelationship: f ? "intersects" : void 0,
+        distance: s?.distance,
+        units: s?.units,
+        topFilter: new R({
+          topCount: e.topCount,
+          groupByFields: e.groupByFields,
+          orderByFields: e.orderByFields
         })
       });
-      o = await a.queryTopFeatures(r);
+      r = await i.queryTopFeatures(u);
     } else {
-      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([...s.outFields, ...k(t.orderByFields)])
-      ], w = v(c, m, l ?? !1);
+      let u;
+      if (e.topCount === 1) {
+        const d = i.createQuery();
+        d.where = w(i.definitionExpression, o.where || "1=1");
+        const N = T(e.orderByFields)[0], m = i.fields.find((h) => h.name.toLowerCase() === N?.toLowerCase());
+        if (m) {
+          d.outFields = ["*"], d.orderByFields = e.orderByFields, d.num = e.topCount, d.returnGeometry = !1;
+          const h = await i.queryFeatures(d), q = h.features[h.features.length - 1]?.attributes?.[m.name];
+          u = W(m.name, q, m.type);
+        }
+      }
+      const a = i.createQuery(), S = w(i.definitionExpression, o.where || "1=1");
+      a.where = u ? w(S, u) : S, a.outFields = b.length ? b : ["*"], a.orderByFields = e.orderByFields, a.returnGeometry = !1, u || (a.num = e.topCount), f && (a.geometry = f, a.spatialRelationship = "intersects"), s?.distance && (a.distance = s.distance), s?.units && (a.units = s.units), a.outSpatialReference = n.spatialReference;
+      const k = [
+        .../* @__PURE__ */ new Set([...y, ...T(e.orderByFields)])
+      ], v = j(p, k, l ?? !1);
       try {
-        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 a.queryFeatures(r);
+        r = v ? await p.queryFeatures(a) : await i.queryFeatures(a);
+      } catch (d) {
+        console.warn("Client-side query failed, falling back to server:", d), r = await i.queryFeatures(a);
       }
     }
-    const g = o.features.map((r) => r.attributes[f]), { attributes: b } = I(a, o, n.timeZone);
+    const C = r.features.map((u) => u.attributes[g]), { attributes: I } = D(i, r, n.timeZone);
     return {
       tool: "getTopFeatures",
-      layerName: u,
-      summary: `Top ${t.topCount} features extracted`,
+      layerName: c,
+      summary: `Top ${e.topCount} features extracted`,
       details: {
-        topCount: t.topCount,
-        attributes: b,
-        objectIds: g,
-        objectIdField: f,
-        where: s.where,
-        orderByFields: t.orderByFields,
-        ...p && { groupByFields: t.groupByFields }
+        topCount: e.topCount,
+        attributes: I,
+        objectIds: C,
+        objectIdField: g,
+        where: o.where,
+        orderByFields: e.orderByFields,
+        ...F && { groupByFields: e.groupByFields }
       }
     };
-  } catch (o) {
+  } catch (r) {
     return {
       tool: "getTopFeatures",
-      layerName: u,
+      layerName: c,
       summary: "Query failed",
-      details: { error: o instanceof Error ? o.message : String(o) }
+      details: { error: r instanceof Error ? r.message : String(r) }
     };
   }
-}, j = async ({
-  targetLayer: s,
-  topFilter: t,
+}, V = async ({
+  targetLayer: o,
+  topFilter: e,
   geometryFilter: n,
-  useCurrentExtent: i
+  useCurrentExtent: s
 }, l) => {
-  const { mapView: a } = N(l, ["mapView"]), c = G(
+  const { mapView: i } = U(l, ["mapView"]), p = E(
     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.")
-}), 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"),
-    spatialReference: e.object({
-      wkid: e.number().describe("Spatial reference WKID (e.g., 4326 for WGS84)")
+  ), c = await A(o, e, i, p, s);
+  return JSON.stringify(c, null, 2);
+}, P = 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: B.optional().describe("The units for the distance buffer.")
+}), Y = 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"),
+    spatialReference: t.object({
+      wkid: t.number().describe("Spatial reference WKID (e.g., 4326 for WGS84)")
     }).optional().describe("Spatial reference. Defaults to map's spatial reference if not provided.")
   }).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.")
-}), 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."),
-    orderByFields: e.array(e.string().describe("The field(s) and order for which to sort the resulting features.")),
-    outFields: e.array(
-      e.string().describe(
+  distance: t.number().optional().describe("Optional buffer distance around the point."),
+  units: B.optional().describe("The units for the distance buffer.")
+}), Z = 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."),
+    orderByFields: t.array(t.string().describe("The field(s) and order for which to sort the resulting features.")),
+    outFields: t.array(
+      t.string().describe(
         'The fields to include in the output that will be presented to the user. This should include identifying information about the resulting features, like a name or id, along with the values desired in the output. If unsure, choose all fields ("*").'
       ).default("*")
     )
   }),
-  geometryFilter: e.union([D, Q, x]).optional().describe(
+  geometryFilter: t.union([P, Y, $]).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."),
-    orderByFields: e.array(
-      e.string().describe("Field(s) to rank by with ASC/DESC. Must be existing field names, not aggregate functions.")
+  topFilter: t.object({
+    topCount: t.number().describe("Number of top features to return per group."),
+    orderByFields: t.array(
+      t.string().describe("Field(s) to rank by with ASC/DESC. Must be existing field names, not aggregate functions.")
     ),
-    groupByFields: e.array(e.string().describe("Field(s) to group results by. Returns top N per group."))
+    groupByFields: t.array(t.string().describe("Field(s) to group results by. Returns top N per group."))
   }).required(),
-  useCurrentExtent: e.boolean().optional().describe(
+  useCurrentExtent: t.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)."
   )
-}), J = S(j, {
+}), se = x(V, {
   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: U
+  description: 'Returns top N features ranked by an existing field value. Use for "highest", "lowest", "latest", "earliest", "top N" questions where ranking is based on a field that already exists in the data (e.g., population, value, date, depth). Display all the features that meet the ranking criteria, including ties at the cutoff value. orderByFields must be actual field names with ASC/DESC. Do NOT use aggregate functions like COUNT(), SUM(), AVG() - those require getStatistics.',
+  schema: Z
 });
 export {
-  J as getTopFeaturesTool
+  se as getTopFeaturesTool
 };

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

@@ -1,54 +1,59 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { tool as v } from "@langchain/core/tools";
-import { a as C } from "../../../../chunks/formatFeatureAttributes.js";
-import { g as R, i as F, a as I, d as q, s as G, r as O } from "../../../../chunks/resolvePointGeometryFilter.js";
+import { tool as C } from "@langchain/core/tools";
+import { a as R } from "../../../../chunks/formatFeatureAttributes.js";
+import { g as O, i as S, a as I, s as G, r as N } from "../../../../chunks/resolveGeometryFilter.js";
 import { c as j, m as x } from "../../../../chunks/mergeWhereClauses.js";
+import { f as W } from "../../../../chunks/resolveFieldNames.js";
 import t from "zod";
-import { f as N } from "../../../../chunks/fetchAgentContext.js";
-const p = 25, W = (i) => i.flatMap((r) => r.split(",")).map((r) => r.trim()).map((r) => r.split(/\s+/u)[0]?.replace(/^"|"$/gu, "")).filter((r) => !!r), B = async (i, r, e, l) => {
-  const a = r.map?.allLayers.find((u) => u.id === i.layerId), d = await r.whenLayerView(a), f = a.title ?? i.layerId;
+import { f as B } from "../../../../chunks/fetchAgentContext.js";
+import { distanceUnitsSchema as q } from "../../shared/types.js";
+const p = 25, k = (i) => i.flatMap((r) => r.split(",")).map((r) => r.trim()).map((r) => r.split(/\s+/u)[0]?.replace(/^"|"$/gu, "")).filter((r) => !!r), D = async (i, r, e, l) => {
+  const s = r.map?.allLayers.find((u) => u.id === i.layerId), d = await r.whenLayerView(s), f = s.title ?? i.layerId;
   let h;
   if (e) {
-    const u = await R(e, r);
+    const u = await O(e, r);
     if ("error" in u) {
-      const s = { error: u.error };
-      if (F(e)) {
+      const a = { error: u.error };
+      if (S(e)) {
         const c = r.map?.allLayers.find((y) => y.id === e.layerId);
-        s.geometryLayerName = c?.title ?? c?.id, s.geometryLayerId = e.layerId, s.geometryWhere = e.where;
-      } else I(e) && (s.point = e.point);
+        a.geometryLayerName = c?.title ?? c?.id, a.geometryLayerId = e.layerId, a.geometryWhere = e.where;
+      } else I(e) && (a.point = e.point);
       return {
         tool: "queryFeatures",
         layerName: f,
         summary: "Geometry lookup failed",
-        details: s
+        details: a
       };
     }
     if (!u.geometry) {
-      const s = {};
-      if (F(e)) {
+      const a = {};
+      if (S(e)) {
         const c = r.map?.allLayers.find((y) => y.id === e.layerId);
-        s.error = `No features found matching: ${e.where}`, s.geometryLayerName = c?.title ?? c?.id, s.geometryLayerId = e.layerId, s.geometryWhere = e.where;
-      } else I(e) && (s.error = "Failed to create point geometry", s.point = e.point);
+        a.error = `No features found matching: ${e.where}`, a.geometryLayerName = c?.title ?? c?.id, a.geometryLayerId = e.layerId, a.geometryWhere = e.where;
+      } else I(e) && (a.error = "Failed to create point geometry", a.point = e.point);
       return {
         tool: "queryFeatures",
         layerName: f,
         summary: "No features found for geometry filter",
-        details: s
+        details: a
       };
     }
     h = u.geometry;
   } else l && (h = r.extent.clone());
-  const T = [
-    .../* @__PURE__ */ new Set([...i.outFields, ...W(i.orderByFields)])
-  ], b = j(d, T, l ?? !1), w = a.objectIdField, o = a.createQuery();
-  o.where = x(a.definitionExpression, i.where || "1=1"), o.outFields = i.outFields.includes("*") ? ["*"] : [.../* @__PURE__ */ new Set([...i.outFields, w])], o.orderByFields = i.orderByFields, h && (o.geometry = h, o.spatialRelationship = "intersects"), e?.distance && (o.distance = e.distance), e?.units && (o.units = e.units), o.outSpatialReference = r.spatialReference;
+  const v = [
+    .../* @__PURE__ */ new Set([...i.outFields, ...k(i.orderByFields)])
+  ], b = j(d, v, l ?? !1), w = s.objectIdField, o = s.createQuery();
+  o.where = x(s.definitionExpression, i.where || "1=1"), o.outFields = i.outFields.includes("*") ? ["*"] : [.../* @__PURE__ */ new Set([...i.outFields, w])], o.orderByFields = i.orderByFields, h && (o.geometry = h, o.spatialRelationship = "intersects"), e?.distance && (o.distance = e.distance), e?.units && (o.units = e.units), o.outSpatialReference = r.spatialReference;
   let n, m;
   try {
-    n = b ? await d.queryFeatureCount(o) : await a.queryFeatureCount(o), n > 0 && n <= p && (m = b ? await d.queryFeatures(o) : await a.queryFeatures(o));
+    n = b ? await d.queryFeatureCount(o) : await s.queryFeatureCount(o), n > 0 && n <= p && (m = b ? await d.queryFeatures(o) : await s.queryFeatures(o));
   } catch (u) {
-    console.warn("Client-side query failed, falling back to server:", u), n = await a.queryFeatureCount(o), n > 0 && n <= p && (m = await a.queryFeatures(o));
+    console.warn("Client-side query failed, falling back to server:", u), n = await s.queryFeatureCount(o), n > 0 && n <= p && (m = await s.queryFeatures(o));
   }
-  const { objectIds: g, attributes: S } = m ? C(a, m, r.timeZone) : { objectIds: void 0, attributes: void 0 };
+  const { objectIds: g, attributes: F } = m ? R(s, m, r.timeZone) : { objectIds: void 0, attributes: void 0 }, T = W(
+    i.outFields,
+    s.fields.map((u) => u.name)
+  );
   return {
     tool: "queryFeatures",
     layerName: f,
@@ -57,32 +62,32 @@ const p = 25, W = (i) => i.flatMap((r) => r.split(",")).map((r) => r.trim()).map
       totalCount: n,
       where: i.where,
       orderByFields: i.orderByFields,
-      outFields: i.outFields,
+      outFields: T,
       ...g && { objectIds: g, objectIdField: w },
-      ...S && { attributes: S },
+      ...F && { attributes: F },
       ...n > p && {
         note: `${n} features found.`
       }
     }
   };
 };
-async function k({
+async function L({
   targetLayer: i,
   geometryFilter: r,
   useCurrentExtent: e
 }, l) {
-  const { mapView: a } = N(l, ["mapView"]), d = O(
+  const { mapView: s } = B(l, ["mapView"]), d = N(
     r,
     l.state?.agentExecutionContext?.sharedResources
-  ), f = await B(i, a, d, e);
+  ), f = await D(i, s, d, e);
   return JSON.stringify(f, null, 2);
 }
-const D = t.object({
+const U = 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: q.optional().describe("The units for the distance buffer.")
-}), L = t.object({
+}), A = 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"),
@@ -92,7 +97,7 @@ const D = t.object({
   }).describe("Point coordinates from a previous navigation/geocoding result"),
   distance: t.number().optional().describe("Optional buffer distance around the point."),
   units: q.optional().describe("The units for the distance buffer.")
-}), U = t.object({
+}), E = 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(
@@ -105,13 +110,13 @@ const D = t.object({
       ).default("*")
     )
   }),
-  geometryFilter: t.union([D, L, G]).optional().describe(
+  geometryFilter: t.union([U, A, G]).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."
   ),
   useCurrentExtent: t.boolean().optional().describe(
     "Set to true ONLY when user explicitly asks about features 'in my view', 'on my map', 'I am looking at', OR when the user refers back to features previously identified using the current extent (e.g. 'these', 'those', 'them', 'the same ones'). Default is false (queries entire layer)."
   )
-}), H = v(k, {
+}), K = C(L, {
   name: "queryFeatures",
   description: `Queries features from a layer. Returns the total count of matching features, plus individual feature attributes if ≤25 features match. 
 
@@ -123,8 +128,8 @@ USE THIS TOOL FOR:
 - Any question where the user wants to SEE or COUNT matching features
 
 This is the DEFAULT tool for most queries. When in doubt, use this tool.`,
-  schema: U
+  schema: E
 });
 export {
-  H as queryFeaturesTool
+  K as queryFeaturesTool
 };

package/dist/agents/tools/shared/resolveToolArtifact.d.ts

@@ -0,0 +1,24 @@
+import type { BaseMessage } from "@langchain/core/messages";
+
+/** @internal */
+export type ArtifactSchema<T> = {
+  parse: (value: unknown) => T;
+};
+
+/** @internal */
+export type ResolveToolArtifactOptions<T> = {
+  messages: readonly BaseMessage[];
+  schema: ArtifactSchema<T>;
+  toolName: string;
+};
+
+/**
+ * Resolves the artifact from the most recent retained tool message with the requested tool name.
+ *
+ * @param parameter0
+ * @returns The validated artifact.
+ * @typeParam T - The validated artifact type.
+ * @throws If the matching message has no artifact, its artifact is invalid, or no matching message is available.
+ * @internal
+ */
+export function resolveLatestToolArtifact<T>(parameter0: ResolveToolArtifactOptions<T>): T;

package/dist/agents/tools/shared/resolveToolArtifact.js

@@ -0,0 +1,20 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { ToolMessage as a } from "@langchain/core/messages";
+const i = (r) => typeof r == "object" && r !== null && "value" in r, c = ({ messages: r, schema: n, toolName: t }) => {
+  for (let o = r.length - 1; o >= 0; o--) {
+    const e = r[o];
+    if (!(!a.isInstance(e) || e.name !== t)) {
+      if (!i(e.artifact))
+        throw new Error(`Tool "${t}" did not return an artifact.`);
+      try {
+        return n.parse(e.artifact.value);
+      } catch {
+        throw new Error(`Tool "${t}" returned an invalid artifact.`);
+      }
+    }
+  }
+  throw new Error(`No result from tool "${t}" is available.`);
+};
+export {
+  c as resolveLatestToolArtifact
+};

package/dist/agents/tools/shared/types.d.ts

@@ -0,0 +1,22 @@
+import type { SharedResourceInput, SharedStatePatch } from "../../../orchestrator/state/types.js";
+
+/**
+ * Artifact returned by an agent tool, including optional shared-context effects.
+ *
+ * @internal
+ */
+export type AgentToolArtifact<TValue, TSharedState extends Record<string, unknown> = Record<string, unknown>> = Readonly<{
+    value: TValue;
+    sharedStatePatch?: SharedStatePatch<TSharedState>;
+    sharedResourceAdditions?: readonly SharedResourceInput[];
+}>;
+
+/**
+ * Content and artifact returned by an agent tool.
+ *
+ * @internal
+ */
+export type AgentToolResponse<TValue, TSharedState extends Record<string, unknown> = Record<string, unknown>> = [
+    content: string,
+    artifact: AgentToolArtifact<TValue, TSharedState>
+];

package/dist/agents/tools/shared/types.js

@@ -0,0 +1,6 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import e from "zod";
+const t = ["feet", "kilometers", "meters", "miles", "nautical-miles", "us-nautical-miles"], i = e.enum(t);
+export {
+  i as distanceUnitsSchema
+};

package/dist/cdn/24TK55FP.js

@@ -0,0 +1,2 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import{a}from"./FJV7CI7O.js";import{a as t}from"./WSIZ2OTL.js";var l=async(i={})=>{let{modelTier:e="default",config:o}=i,{getChatAIUtilityServiceUrl:r}=await import("./4KFTUBFL.js").then(m=>m.default),{createAuthenticatedFetch:n}=await import("./OYHYHALE.js").then(m=>m.default.then(e=>({createAuthenticatedFetch:e}))),c=t[e],s=await r(e);return new a({modelName:c,apiKey:"dummy-key",useResponsesApi:!0,zdrEnabled:!0,configuration:{baseURL:s,fetch:await n({config:o,withCredentials:!0})}})};export{l as a};

package/dist/cdn/{7SRLZQVC.js → 2DWN3SKH.js}

@@ -1,5 +1,5 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{a as o}from"./FDOMMK2M.js";import{Dc as a}from"./AI6DYOKR.js";import{a as r}from"./VXFQANGJ.js";var f=(l,i)=>{let t=Array.from(l.values()).find(({layerItem:e})=>e.title?.toLowerCase().includes(i.toLowerCase()));if(!t){let e=Array.from(l.values()).map(y=>y.layerItem.title).join(", ");return`Could not find a layer matching "${i}". Available layers: ${e}`}let s=Array.from(t.fieldRegistry.values()),n=s.map(e=>`- **${e.alias||e.name}** (\`${e.name}\`, ${e.type})${e.description?`: ${e.description}`:""}`).join(`
+import{a as o}from"./FDOMMK2M.js";import{a as r}from"./RFPTOFM4.js";import{Ga as a}from"./FSLPYC4Y.js";var f=(l,i)=>{let t=Array.from(l.values()).find(({layerItem:e})=>e.title?.toLowerCase().includes(i.toLowerCase()));if(!t){let e=Array.from(l.values()).map(y=>y.layerItem.title).join(", ");return`Could not find a layer matching "${i}". Available layers: ${e}`}let s=Array.from(t.fieldRegistry.values()),n=s.map(e=>`- **${e.alias||e.name}** (\`${e.name}\`, ${e.type})${e.description?`: ${e.description}`:""}`).join(`
 `);return`**${t.layerItem.title}** has ${s.length} field(s):
 
 ${n}`},m=({layerTitle:l},i)=>{let t=o(i,"layersAndFieldsRegistry");return f(t,l)},u=a(m,{name:"listLayerFields",description:"Lists all fields for a given layer by title. Use ONLY when the user explicitly asks to see fields, columns, or attributes of a specific named layer. Do NOT call this tool for general help questions, capability overviews, or layer listing.",schema:r.object({layerTitle:r.string().describe("The title or partial title of the layer to list fields for.")})});export{u as a};

package/dist/cdn/2O52MJ3D.js

@@ -0,0 +1,2 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import{c as n}from"./DI3VGUJY.js";import{a as d,b as f}from"./VIJVRJHL.js";import{a as h,c as a}from"./BMPBJXD7.js";import{a as g}from"./GHFOAS7T.js";import{a as l}from"./6WYVG3JI.js";import{d as p}from"./5TW2NFES.js";import{y as c}from"./QEGO4B2W.js";import{c as i}from"./EEHDAYOG.js";import{V as u}from"./2UKFCF2J.js";var w=class extends l{constructor(t){super(),this.middlewares=[],this.modelTier="default",this._destroyed=!1,Object.assign(this,t),this.generate()}destroy(){if(!this._destroyed){this._destroyed=!0;for(let t of new Set(this.tools))"getTools"in t&&t.destroy()}}generate(){let t=this.prompt?i.fromTemplate(this.prompt).inputVariables:[],o=p([this.inputSchema,this.outputSchema].filter(Boolean),t),e=this.id,s={[e]:this._invoke.bind(this)},r=[{from:e,decide:()=>{}}];this.workspace=o,this.createGraph=()=>g(s,r,o,{agent:this,entryNode:e,middlewares:this.middlewares})}async _invoke(t,o){try{return this.outputSchema?await this._invokeStructured(t,o):await this._invokeUnstructured(t,o)}catch(e){if(c(e)||o?.signal?.aborted||e instanceof Error&&e.name==="AbortError")throw e;let s=e instanceof Error?e.message:String(e);return d({outputMessage:s},"failed",s)}}async _invokeStructured(t,o){if(!this.outputSchema)throw new Error("Output schema is required for structured invocation.");let{createChatModel:e}=await import("./orchestrator/models/chatModel.js"),s=await a({model:await e({modelTier:this.modelTier}),systemPrompt:await this._getPromptWithInputVariables(t),tools:await this._getTools(),checkpointer:!0,middleware:n(this.middlewares),responseFormat:h(this.outputSchema)}).invoke({messages:t.agentExecutionContext.messages},o);if(!("structuredResponse"in s)||s.structuredResponse===void 0)throw new Error("LLMAgent did not receive structured output from createAgent.");return{...f(s.structuredResponse,this.outputSchema,s.messages),sharedResourceAdditions:y(s.messages)}}async _invokeUnstructured(t,o){let{createChatModel:e}=await import("./orchestrator/models/chatModel.js"),s=(await a({model:await e({modelTier:this.modelTier}),systemPrompt:await this._getPromptWithInputVariables(t),tools:await this._getTools(),checkpointer:!0,middleware:n(this.middlewares)}).invoke({messages:t.agentExecutionContext.messages},o)).messages,r=s.at(-1)?.text??"",T=r.trim()||"LLMAgent completed.";return d({agentExecutionContext:{...t.agentExecutionContext,messages:s},outputMessage:r,sharedResourceAdditions:y(s)},"success",T)}async _getPromptWithInputVariables(t){return await i.fromTemplate(this.prompt).format(t)}async _getTools(){return(await Promise.all((this.tools??[]).map(async t=>"getTools"in t?await t.getTools():["getTool"in t?t.getTool():t]))).flat()}};function y(m){let t=[];for(let o of m)if(u.isInstance(o)&&o.status!=="error"){let e=o.artifact;if(typeof e=="object"&&e!==null&&"sharedResourceAdditions"in e){let s=e.sharedResourceAdditions;if(Array.isArray(s))for(let r of s)t.push({kind:r.kind,description:r.description,payload:r.payload})}}return t}export{w as a};

package/dist/cdn/2UDDCWNW.js

@@ -0,0 +1,2 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import{a}from"./DGCWQYN3.js";import"./RFPTOFM4.js";import"./AMP43OT2.js";import"./UZLQALHY.js";export{a as createZodObjectSchema};