@arcgis/ai-components 5.2.0-next.11 → 5.2.0-next.110

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

@@ -0,0 +1,131 @@
+/* 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, 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;
+  if (e) {
+    const u = await R(e, r);
+    if ("error" in u) {
+      const s = { error: u.error };
+      if (F(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);
+      return {
+        tool: "queryFeatures",
+        layerName: f,
+        summary: "Geometry lookup failed",
+        details: s
+      };
+    }
+    if (!u.geometry) {
+      const s = {};
+      if (F(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);
+      return {
+        tool: "queryFeatures",
+        layerName: f,
+        summary: "No features found for geometry filter",
+        details: s
+      };
+    }
+    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;
+  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));
+  } 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));
+  }
+  const { objectIds: g, attributes: S } = m ? C(a, m, r.timeZone) : { objectIds: void 0, attributes: void 0 };
+  return {
+    tool: "queryFeatures",
+    layerName: f,
+    summary: `${n} features found`,
+    details: {
+      totalCount: n,
+      where: i.where,
+      orderByFields: i.orderByFields,
+      outFields: i.outFields,
+      ...g && { objectIds: g, objectIdField: w },
+      ...S && { attributes: S },
+      ...n > p && {
+        note: `${n} features found.`
+      }
+    }
+  };
+};
+async function k({
+  targetLayer: i,
+  geometryFilter: r,
+  useCurrentExtent: e
+}, l) {
+  const { mapView: a } = N(l, ["mapView"]), d = O(
+    r,
+    l.state?.agentExecutionContext?.sharedResources
+  ), f = await B(i, a, d, e);
+  return JSON.stringify(f, null, 2);
+}
+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: q.optional().describe("The units for the distance buffer.")
+}), L = 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: t.number().optional().describe("Optional buffer distance around the point."),
+  units: q.optional().describe("The units for the distance buffer.")
+}), U = 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(
+      "SQL-92 where clause. IMPORTANT: When using geometryFilter.point or geometryFilter.sharedResourceId for point-in-polygon queries, set this to '1=1' to return all features that intersect the point. Only add attribute filters if the user specifically requests them in addition to the spatial query."
+    ),
+    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: t.union([D, L, 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)."
+  )
+}), 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. 
+
+USE THIS TOOL FOR:
+- "Show / display / list features where..." — finding and listing features
+- "How many X are Y?" — counting features that match a condition
+- "Which features..." / "Find features..." — identifying specific features
+- Spatial queries — finding features near/within/intersecting other features
+- 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
+});
+export {
+  X as queryFeaturesTool
+};

package/dist/agents/tools/search/findRelevantFields/adapter.d.ts

@@ -0,0 +1,8 @@
+import type { StructuredToolInterface } from "@langchain/core/tools";
+
+/**
+ * Finds and enriches fields that are semantically relevant to a task.
+ *
+ * @internal
+ */
+export const findRelevantFieldsTool: StructuredToolInterface;

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

@@ -0,0 +1,57 @@
+/* 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";
+import { f as r } from "../../../../chunks/fetchService.js";
+import { b as p } from "../../../../chunks/fieldStatistics.js";
+const v = 0.7, S = 10;
+async function R(a) {
+  const {
+    query: e,
+    layerIds: i,
+    includeSummaryStatistics: s = !1,
+    fieldSearch: l,
+    layersAndFieldsRegistry: d,
+    embeddingCache: o,
+    mapView: c,
+    minScore: m = v,
+    topResults: f = S
+  } = a, n = await l.searchFields({
+    text: e,
+    layerIds: i,
+    minScore: m,
+    topResults: f,
+    embeddingCache: o
+  }), u = await p(
+    n,
+    d,
+    c,
+    s
+  );
+  return { matches: n, ...u };
+}
+const b = t.object({
+  query: t.string().describe("A concise semantic description of the fields relevant to the user's task."),
+  layerIds: t.array(t.string()).min(1).describe("Layer IDs returned by findRelevantLayers, restricted to layers relevant to the current task."),
+  includeSummaryStatistics: t.boolean().optional().default(!1).describe(
+    "Set to true only when the task directly asks for numeric summaries such as average, minimum, maximum, total, variance, or range."
+  )
+});
+async function F(a, e) {
+  const { mapView: i } = h(e, ["mapView"]), s = await R({
+    ...a,
+    fieldSearch: r(e, "fieldSearch"),
+    layersAndFieldsRegistry: r(e, "layersAndFieldsRegistry"),
+    embeddingCache: r(e, "embeddingCache"),
+    mapView: i
+  });
+  return JSON.stringify(s, null, 2);
+}
+const C = y(F, {
+  name: "findRelevantFields",
+  description: "Finds relevant fields within candidate layers. Returns ranked matches, field metadata, categorical values, and optional numeric summary statistics. Call findRelevantLayers first when layer IDs are not already known.",
+  schema: b
+});
+export {
+  C as findRelevantFieldsTool
+};

package/dist/agents/tools/search/findRelevantLayers/adapter.d.ts

@@ -0,0 +1,8 @@
+import type { StructuredToolInterface } from "@langchain/core/tools";
+
+/**
+ * Finds map layers that are semantically relevant to a task.
+ *
+ * @internal
+ */
+export const findRelevantLayersTool: StructuredToolInterface;

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

@@ -0,0 +1,38 @@
+/* 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";
+const m = 0.7;
+async function h(r) {
+  const { query: e, layerSearch: a, layersAndFieldsRegistry: l, embeddingCache: o, minScore: c = m } = r;
+  return (await a.searchLayers({ text: e, minScore: c, embeddingCache: o })).map(({ id: s, score: d }) => {
+    const t = l.get(s)?.layerItem;
+    return {
+      layerId: s,
+      score: d,
+      name: t?.name ?? void 0,
+      title: t?.title,
+      description: t?.description
+    };
+  });
+}
+const f = i.object({
+  query: i.string().describe("A concise semantic description of the layers relevant to the user's task.")
+});
+async function p({ query: r }, e) {
+  const a = await h({
+    query: r,
+    layerSearch: n(e, "layerSearch"),
+    layersAndFieldsRegistry: n(e, "layersAndFieldsRegistry"),
+    embeddingCache: n(e, "embeddingCache")
+  });
+  return JSON.stringify({ layers: a }, null, 2);
+}
+const S = y(p, {
+  name: "findRelevantLayers",
+  description: "Finds map layers relevant to a task and returns their layer IDs, similarity scores, names, titles, and descriptions. Call this before finding fields or querying data when layer IDs are not already known.",
+  schema: f
+});
+export {
+  S as findRelevantLayersTool
+};

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/24EIZVUM.js

@@ -0,0 +1,2 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
+import n from"./FK2CVSXW.js";import"./2F4TPWZQ.js";import m from"./ZY3JQCZQ.js";import{c as s,d as p}from"./SNG3WODY.js";import"./M5B6X46F.js";import l from"./VK6CCPTG.js";import"./LXIKAXUT.js";import k from"./M3KKORBG.js";import j from"./3PPXAIRE.js";import i from"./XVJFPZTW.js";import h from"./YOW3YKWR.js";import g from"./KKCLHXHG.js";import"./LLY5A2E2.js";import"./X42ACC66.js";import"./V4PJMCJZ.js";import f from"./EK3PM4L5.js";import"./T6W6F4TF.js";import"./CKUUYQLO.js";import d from"./KBSXHSBX.js";import"./275FFTBE.js";import"./TFAJNKBC.js";import"./HV7MVIQV.js";import"./OALQBAZR.js";import"./4YOG5F3W.js";import c from"./2LVYAXHG.js";import"./4OI4QEV7.js";import"./SJMAKF4P.js";import"./TXZQZR3I.js";import b from"./STOGCXJH.js";import a from"./VGLBH473.js";import"./A6LBMS7A.js";import{v as e,z as o}from"./53KIFJFA.js";import"./TLPZELG3.js";import"./V52GSTOC.js";import"./477I66FH.js";import"./ZJWR4W2S.js";import"./M2U456J5.js";import"./5X23DDDZ.js";import"./CSE6BHOJ.js";import"./BVUCNXC5.js";export default $arcgis.t(([,,,,,,,,,{fetchKnowledgeGraph:n},,,,,,,,,,,,,m])=>{var r=class extends e{constructor(){super(...arguments),this.agent=m}static{this.properties={referenceElement:1,serviceUrl:3,context:0}}#i;#r;#t;#e;get serviceUrl(){return this.#r}set serviceUrl(t){this.#r=t}async getContext(){let t=this.context?{...this.context,knowledgeGraph:void 0,view:void 0}:{};if(this.#i)return{...t,view:this.#i};if(this.#t)try{let i=await this.#t;return{...t,knowledgeGraph:i}}catch(i){console.error("Failed to load knowledge graph via service URL:",i)}if(!this.context?.knowledgeGraph&&!this.context?.view)throw new Error("arcgis-assistant-knowledge-agent requires either a knowledgeGraph or view in context, and neither were provided");return this.context}willUpdate(t){t.has("serviceUrl")&&this.serviceUrl?this.#t=n(this.serviceUrl):this.#t=void 0}load(){this.#i=p(this)??void 0,this.#e=s(this)}disconnectedCallback(){this.#e?.unregister(this.agent.id),super.disconnectedCallback()}};o("arcgis-assistant-knowledge-agent",r);return r},"identity/IdentityManager","portal/Portal","request","config","core/reactiveUtils","layers/FeatureLayer","intl","smartMapping/statistics/summaryStatistics","smartMapping/statistics/uniqueValues","rest/knowledgeGraphService",a,b,c,d,f,g,h,i,j,k,l,m,n)

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/275FFTBE.js

@@ -0,0 +1,2 @@
+/* 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/27CK3JHY.js

@@ -0,0 +1,2 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
+import{b as r}from"./BBEGLIZC.js";import"./4YOG5F3W.js";import{g as a,h as e,n as s,v as c,z as l}from"./53KIFJFA.js";import"./TLPZELG3.js";import"./BVUCNXC5.js";var o=a`:host{padding:var(--calcite-spacing-md);background:var(--calcite-panel-background-color, var(--calcite-color-background))}calcite-panel{border-radius:var(--calcite-dialog-corner-radius, var(--calcite-corner-radius-sm));border:0 solid var(--calcite-color-brand);border-block-start-width:4px;box-shadow:var(--calcite-shadow-md);width:100%;--calcite-panel-border-color: none}.interrupt-content{padding:0 var(--calcite-spacing-md);background:var(--calcite-color-foreground-1)}`,i=class extends c{constructor(){super(...arguments),this._messages=r({blocking:!0}),this._selectedOptions=[],this.arcgisCancel=s(),this.arcgisSubmit=s()}static{this.properties={_selectedOptions:16,type:1,message:1,options:0}}static{this.styles=o}_renderInterruptOptions(){switch(this.type){case"single-select":return e`<calcite-list selection-mode=single-persist .label=${this._messages.optionsLabel} @calciteListChange=${t=>this._selectedOptions=t.target.selectedItems[0]?.value}>${this.options?.map(t=>e`<calcite-list-item .label=${t} .value=${t}></calcite-list-item>`)}</calcite-list>`;case"multi-select":return e`<calcite-list selection-mode=multiple .label=${this._messages.optionsLabel} @calciteListChange=${t=>this._selectedOptions=t.target.selectedItems.map(n=>n.value)}>${this.options?.map(t=>e`<calcite-list-item .label=${t} .value=${t}></calcite-list-item>`)}</calcite-list>`;case"boolean-choice":return null;case"text-input":return e`<calcite-input .label=${this._messages.enterTextLabel} @calciteInputInput=${t=>this._selectedOptions=t.target.value}></calcite-input>`}}render(){return e`<calcite-panel .description=${this.message}><div class="interrupt-content">${this._renderInterruptOptions()}</div>${this.type==="boolean-choice"?e`<calcite-button slot=footer-end appearance=outline @click=${()=>this.arcgisSubmit.emit(!1)}>${this._messages.declineButtonLabel}</calcite-button><calcite-button slot=footer-end appearance=solid @click=${()=>this.arcgisSubmit.emit(!0)}>${this._messages.approveButtonLabel}</calcite-button>`:e`<calcite-button slot=footer-end appearance=outline @click=${()=>this.arcgisCancel.emit()}>${this._messages.cancelButtonLabel}</calcite-button><calcite-button slot=footer-end appearance=solid .disabled=${!this._selectedOptions.length} @click=${()=>this.arcgisSubmit.emit(this._selectedOptions)}>${this._messages.submitButtonLabel}</calcite-button>`}</calcite-panel>`}};l("arcgis-assistant-interrupt",i);export{i as ArcgisAssistantInterrupt};

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};