@arcgis/ai-components 5.2.0-next.105 → 5.2.0-next.107

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

@@ -1,26 +1,27 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 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, s as w, r as I } from "../../../../chunks/resolvePointGeometryFilter.js";
+import { g as y, s as w, r as I } from "../../../../chunks/resolvePointGeometryFilter.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);
+  const s = t.map?.allLayers.find((a) => a.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));
+  const o = s.createQuery();
+  o.where = u ?? "1=1", n && (o.geometry = n, o.spatialRelationship = "intersects", r && (o.distance = r), c && (o.units = c));
   try {
-    const { extent: o, count: l } = await s.queryExtent(a);
-    return !o || l === 0 ? {
+    const { extent: a, count: l } = await s.queryExtent(o);
+    return !a || l === 0 ? {
       success: !1,
-      error: `No features found for filter (where: ${a.where}${n ? ", spatial filter used" : ""})`
-    } : (await t.goTo(o), { success: !0 });
-  } catch (o) {
+      error: `No features found for filter (where: ${o.where}${n ? ", spatial filter used" : ""})`
+    } : (await t.goTo(a), { success: !0 });
+  } catch (a) {
     return {
       success: !1,
-      error: o instanceof Error ? o.message : String(o)
+      error: a instanceof Error ? a.message : String(a)
     };
   }
 }, x = async (t, i, u, n, r, c) => {
@@ -29,17 +30,17 @@ const v = async (t, i, u, n, r, c) => {
   );
   if (!s)
     return `Could not find target layer with ID: ${t.layerId}`;
-  let a;
+  let o;
   if (r) {
     const f = await y(r, i);
     if ("error" in f)
       return f.error;
-    a = f.geometry;
+    o = f.geometry;
   }
   if (s.featureEffect = null, s.featureEffect = new m({
     filter: new b({
       ...t.objectIds?.length ? { objectIds: t.objectIds } : { where: t.where },
-      geometry: a,
+      geometry: o,
       spatialRelationship: "intersects",
       distance: r?.distance,
       units: r?.units
@@ -48,11 +49,11 @@ const v = async (t, i, u, n, r, c) => {
     excludedEffect: n
   }), 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(
+  const a = t.objectIds?.length ? `${s.objectIdField} IN (${t.objectIds.join(",")})` : t.where, l = await v(
     i,
     t.layerId,
-    o,
     a,
+    o,
     r?.distance,
     r?.units
   ), p = s.title ?? t.layerId;
@@ -64,7 +65,7 @@ const v = async (t, i, u, n, r, c) => {
   includedEffect: n = "drop-shadow(2px, 2px, 2px, gray)",
   excludedEffect: r = "grayscale(100%) opacity(60%) blur(2px)"
 }, c) => {
-  const { mapView: s } = g(c, ["mapView"]), a = I(
+  const { mapView: s } = g(c, ["mapView"]), o = I(
     i,
     c.state?.agentExecutionContext?.sharedResources
   );
@@ -73,7 +74,7 @@ const v = async (t, i, u, n, r, c) => {
     s,
     n,
     r,
-    a,
+    o,
     u
   );
 }, E = e.object({
@@ -111,11 +112,11 @@ const v = async (t, i, 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(j, {
+}), 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: T
 });
 export {
-  A as setFeatureEffectTool
+  C as setFeatureEffectTool
 };

package/dist/agents/tools/help/listFields/adapter.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import { tool as n } from "@langchain/core/tools";
 import s from "zod";
 import { f as c } from "../../../../chunks/fetchService.js";

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

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import { tool as f } from "@langchain/core/tools";
 import s from "@arcgis/core/config.js";
 import u from "@arcgis/core/Graphic.js";

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

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import { z as i } from "zod";
 import { tool as k } from "@langchain/core/tools";
 import { f as s } from "../../../../chunks/fetchAgentContext.js";

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

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import { z as i } from "zod";
 import { tool as u } from "@langchain/core/tools";
 import { f as c } from "../../../../chunks/fetchAgentContext.js";

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

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import { z as n } from "zod";
 import r from "@arcgis/core/geometry/Extent.js";
 import { tool as i } from "@langchain/core/tools";

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

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import { tool as n } from "@langchain/core/tools";
 import i from "zod";
 import { f as r } from "../../../../chunks/fetchAgentContext.js";

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

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import { z as r } from "zod";
 import { tool as i } from "@langchain/core/tools";
 import { f as c } from "../../../../chunks/fetchAgentContext.js";

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

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import t from "zod";
 import { tool as a } from "@langchain/core/tools";
 import { f as i } from "../../../../chunks/fetchAgentContext.js";

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

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import t from "zod";
 import { tool as c } from "@langchain/core/tools";
 import l from "@arcgis/core/geometry/Point.js";

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

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import t from "zod";
 import { tool as m } from "@langchain/core/tools";
 import { f as i } from "../../../../chunks/fetchAgentContext.js";

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

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import { tool as f } from "@langchain/core/tools";
 import i from "zod";
 import { f as h, g } from "../../../../chunks/formatFeatureAttributes.js";

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

@@ -1,13 +1,14 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import { tool as L } from "@langchain/core/tools";
 import t from "zod";
 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 { g as O, i as S, a as C, 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";
+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)
@@ -135,7 +136,7 @@ const D = t.object({
   ),
   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.")
-}), _ = L(A, {
+}), 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.
 
@@ -153,5 +154,5 @@ Only call this tool when the answer requires computing an aggregate (avg, max, m
   schema: $
 });
 export {
-  _ as getStatisticsTool
+  ee as getStatisticsTool
 };

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

@@ -1,12 +1,13 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/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 { g as q, s as x, r as G } from "../../../../chunks/resolvePointGeometryFilter.js";
 import { f as N } from "../../../../chunks/fetchAgentContext.js";
+import { distanceUnitsSchema as y } from "../../shared/types.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;
@@ -134,11 +135,11 @@ const k = (s) => s.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)."
   )
-}), J = S(j, {
+}), K = 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: U
 });
 export {
-  J as getTopFeaturesTool
+  K as getTopFeaturesTool
 };

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

@@ -1,10 +1,11 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/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 { g as R, i as F, a as I, s as G, r as O } from "../../../../chunks/resolvePointGeometryFilter.js";
 import { c as j, m as x } from "../../../../chunks/mergeWhereClauses.js";
 import t from "zod";
 import { f as N } from "../../../../chunks/fetchAgentContext.js";
+import { distanceUnitsSchema as q } from "../../shared/types.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;
   let h;
@@ -111,7 +112,7 @@ const D = t.object({
   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, {
+}), X = v(k, {
   name: "queryFeatures",
   description: `Queries features from a layer. Returns the total count of matching features, plus individual feature attributes if ≤25 features match. 
 
@@ -126,5 +127,5 @@ This is the DEFAULT tool for most queries. When in doubt, use this tool.`,
   schema: U
 });
 export {
-  H as queryFeaturesTool
+  X as queryFeaturesTool
 };

package/dist/agents/tools/search/findRelevantFields/adapter.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import { tool as y } from "@langchain/core/tools";
 import t from "zod";
 import { f as h } from "../../../../chunks/fetchAgentContext.js";

package/dist/agents/tools/search/findRelevantLayers/adapter.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import { tool as y } from "@langchain/core/tools";
 import i from "zod";
 import { f as n } from "../../../../chunks/fetchService.js";

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

@@ -0,0 +1,22 @@
+import type { BaseMessage } from "@langchain/core/messages";
+
+/**
+ * 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;
+
+export type ResolveToolArtifactOptions<T> = {
+  messages: readonly BaseMessage[];
+  schema: ArtifactSchema<T>;
+  toolName: string;
+};
+
+export type ArtifactSchema<T> = {
+  parse: (value: unknown) => T;
+};

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

@@ -0,0 +1,20 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/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/types/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/1.0/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/25MBI4PD.js

@@ -0,0 +1,2 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
+import{a}from"./CKUUYQLO.js";import"./A6LBMS7A.js";import"./M2U456J5.js";import"./5X23DDDZ.js";import"./CSE6BHOJ.js";import"./BVUCNXC5.js";export{a as goToFeaturesTool};

package/dist/cdn/{LLUGJKAQ.js → 275FFTBE.js}

@@ -1,2 +1,2 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{a as n}from"./ONQ6JSBJ.js";import{Dc as o}from"./AI6DYOKR.js";import{a as i}from"./VXFQANGJ.js";async function a(e){let t=e.map.initialViewProperties?.viewpoint?.targetGeometry;if(t)await e.goTo(t);else throw new Error("Initial extent is undefined");return{text:"Successfully zoomed to home extent"}}async function m(e,t){let{mapView:r}=n(t,["mapView"]);return await a(r)}var s=i.object({}),f=o(m,{name:"goToHomeExtent",description:"Go to the initial web map view extent",schema:s});export{f as a};
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
+import{a as n}from"./A6LBMS7A.js";import{Dc as o}from"./M2U456J5.js";import{a as i}from"./5X23DDDZ.js";async function a(e){let t=e.map.initialViewProperties?.viewpoint?.targetGeometry;if(t)await e.goTo(t);else throw new Error("Initial extent is undefined");return{text:"Successfully zoomed to home extent"}}async function m(e,t){let{mapView:r}=n(t,["mapView"]);return await a(r)}var s=i.object({}),f=o(m,{name:"goToHomeExtent",description:"Go to the initial web map view extent",schema:s});export{f as a};

package/dist/cdn/2F4TPWZQ.js

@@ -0,0 +1,2 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
+var i=(e,o)=>(s,t)=>{let c=t?.configurable?.services;for(let r of e)if(!c?.[r])throw new Error(`${o} requires services.${r} to be available.`);return s};export{i as a};