@arcgis/ai-components 5.2.0-next.12 → 5.2.0-next.121

package/dist/chunks/helpAgent.js

@@ -0,0 +1,32 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { createSkillAgent as o } from "../agents/runtime/skill/createSkillAgent.js";
+const d = (a, e) => {
+  const r = Array.from(a?.values() ?? []).map(({ fieldRegistry: n, layerItem: t }) => {
+    const s = Array.from(n.values(), ({ name: l }) => l);
+    return {
+      title: t.title,
+      description: t.description,
+      fields: s.slice(0, 10),
+      additionalFieldCount: Math.max(s.length - 10, 0)
+    };
+  }), i = (e?.list() ?? []).map(({ agent: { description: n, id: t, name: s } }) => ({
+    id: t,
+    name: s,
+    description: n
+  }));
+  return JSON.stringify({ layers: r, agents: i }, null, 2);
+}, p = ({ config: a }) => {
+  const e = a?.configurable?.services;
+  return d(e?.layersAndFieldsRegistry, e?.agentRegistry);
+}, c = [async () => (await import("./SKILL3.js")).default], m = o({
+  id: "help",
+  name: "Help Agent",
+  description: "Answers questions about the current map, its layers and fields, and available assistant capabilities. Use for general help, unsupported map actions, and unrelated requests that should be redirected to map-related questions.",
+  skillLoaders: c,
+  modelTier: "default",
+  systemPrompt: "You are an ArcGIS map help agent.",
+  runtimeContextLoader: p
+});
+export {
+  m as H
+};

package/dist/chunks/help_prompt.js

@@ -1,7 +1,28 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-const e = `## Map Query Gate
+const n = `## Who you are
 
-### Input
+You are a map assistant embedded inside a GIS application. You have no knowledge of history, science, people, events, cooking, or anything outside of this map and its data. You only know what is described in the Map Context below.
+
+If asked anything outside of that context, you simply don't have that information — respond naturally and redirect to something you _can_ help with, using specific layer and field names from the map context.
+
+Example of how to handle unknown topics:
+"I don't have information on that — I only know about this map. You could ask me to list all layers in the map, or capabilities of this assistant."
+
+---
+
+## Your capabilities
+
+You can help users with:
+
+- Listing the layers in this map
+- Listing the fields in a specific layer (use the tool)
+- Suggesting specific queries using actual layer and field names
+- Summarizing what this map contains and what users can do with it
+- Letting users know when a map-related action isn't supported (e.g. charts, tables), and that it may be added in the future
+
+---
+
+## Input
 
 Assigned task:
 {assignedTask}
@@ -12,11 +33,13 @@ Latest user request:
 Prior steps:
 {priorSteps}
 
-Use the assigned task as the primary instruction for the current query. The question will **not** be restated again here.
-Use the latest user request as supporting context when needed.
-Use prior steps only when needed to explain a previous result, failure, or likely next action.
+Use the assigned task as the primary instruction. The question will **not** be restated again here.
+Use the latest user request as supporting context.
+Use prior steps only to explain a previous result, failure, or likely next action.
+
+---
 
-### Map Context
+## Map Context
 
 {layerSummary}
 
@@ -24,15 +47,6 @@ Use prior steps only when needed to explain a previous result, failure, or likel
 
 {agents}
 
-### Rules
-
-- "What layers are in this map?" → List the layer names
-- "What fields are in this layer?" → Call the tool to list the field names for that layer
-- "What can you do?" / "What can I ask?" → Suggest specific queries using EXACT layer and field names from the context above
-- "Tell me about this map" → Summarize layers and capabilities
-- "Create a chart of all wells ans their depth" → If a question is map related but not supported by available capabilities, say so. Add that support for this might be added in the future.
-- Questions completely unrelated to maps/GIS → Politely explain you only help with the map |
-
 ### Response Guidelines
 
 When suggesting what users can ask, be SPECIFIC using actual layer names:
@@ -46,12 +60,15 @@ For "what can I ask" responses, provide 3-5 specific example queries using field
 For off-topic questions:
 "I can only help with this map. Try asking me to filter [LayerName] by [FieldName], or zoom to a location."
 
-Rules:
+---
+
+## Format
 
 - Keep responses concise
 - Use bullet points for lists
 - Use new lines (\\n) and appropriate formatting in your response
+- Use actual layer and field names from the map context in any suggestions
 `;
 export {
-  e as default
+  n as default
 };

package/dist/chunks/intent_prompt.js

@@ -99,7 +99,7 @@ Do not reinterpret the request into a different form.
 
 ## Follow-up Reference Resolution
 
-If the latest user request refers to prior results or prior context using a referential phrase such as "these", "those", "them", "that set", or "the previous results", then the request depends on earlier context.
+If the latest user request refers to prior results or prior context using a referential phrase such as "these", "those", "them", "that set", "the previous results", "this", "it", "that one", "this parcel", "this location", or "that feature", then the request depends on earlier context.
 
 This also applies to equivalent referential wording in other languages.
 
@@ -107,7 +107,7 @@ Resolve the reference using the most recent relevant chat history or successful
 
 In this case, the \`assignedTask\` should be standalone and should preserve the referenced prior constraints while adding only the new constraint or question from the latest user request.
 
-Do not leave ambiguous references like "these", "those", or "them" in \`assignedTask\` when they can be resolved from context.
+Do not leave ambiguous references like "these", "those", "them", "this", or "it" in \`assignedTask\` when they can be resolved from context.
 
 ---
 
@@ -120,6 +120,8 @@ Do not leave ambiguous references like "these", "those", or "them" in \`assigned
 
 - Keep the task short, specific, and directly executable
 - Keep wording close to the user’s request with minimal transformation
+- Do not expand the assigned task into unsolicited recommendations, implementation advice, publishing guidance, classification proposals, future analysis, or other work the selected agent was not asked to perform.
+- Route a request to an agent only when the request fits that agent's registered description, supported actions, and available app context. Do not route unrelated general-knowledge, advice, opinion, political, health, security, or other out-of-scope requests to an agent merely because the user asks for that agent by name.
 - When resolving follow-up references, only replace the ambiguous reference with the resolved prior context; keep the rest of the user’s wording as close as possible.
 
 - Use only information explicitly present in the user request or provided context

package/dist/chunks/layerStylingGraph.js

@@ -1,30 +1,49 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { NodeInterrupt as E, StateGraph as L, START as w, END as m } from "@langchain/langgraph/web";
+import { NodeInterrupt as w, StateGraph as L, START as E, END as m } from "@langchain/langgraph/web";
 import "@arcgis/core/identity/IdentityManager.js";
 import "@arcgis/core/portal/Portal.js";
-import { h as I } from "./generateLayerDescriptions.js";
+import "@arcgis/core/request.js";
+import "@arcgis/toolkit/string";
+import { i as v } from "./generateLayerDescriptions.js";
 import "@langchain/core/messages";
-import { s as i } from "./index.js";
+import { s } from "./index.js";
+import "@arcgis/toolkit/intl";
+import "./runtime.js";
+import "@langchain/core/callbacks/base";
 import "@langchain/openai";
 import "@arcgis/core/config.js";
 import "@arcgis/core/core/reactiveUtils.js";
 import "@arcgis/core/layers/FeatureLayer.js";
-import "@arcgis/core/request.js";
 import "@langchain/core/prompts";
-import { f as g, z as v, A as T, B as R, C as F, D as C, E as A, F as $, I as N, J as b, K as q, L as M, g as _, r as k, M as S } from "./adapter.js";
-import { h as V } from "./toolCallResponse.js";
-import { ToolNode as j } from "@langchain/langgraph/prebuilt";
-const h = 0.7, z = 10, D = async (t, e) => {
+import { f as g } from "./fetchService.js";
+import { j as I, k as T, l as R, m as F, n as $, o as C, p as A, r as N, u as q, v as M, w as _, e as b, L as S } from "./adapter.js";
+import { ToolNode as k } from "@langchain/langgraph/prebuilt";
+import { r as j } from "./requireAgentServices.js";
+const P = async (r, e) => {
+  const t = r.tool_calls ?? [];
+  if (t.length === 0) {
+    await s({ text: `LLM did not request any tool calls: ${String(r?.content)}` }, e);
+    return;
+  }
+  await Promise.all(
+    t.map(
+      async (a) => await s(
+        { text: `LLM invoked ${a.name} tool with arguments: ${JSON.stringify(a.args, null, 2)}` },
+        e
+      )
+    )
+  );
+}, h = 0.7, V = 10, z = async (r, e) => {
   try {
-    await i({ text: "Similarity search to find fields" }, e);
-    const r = g(e, "fieldSearch"), a = g(e, "layersAndFieldsRegistry"), o = g(e, "embeddingCache"), n = await r.searchFields({
-      text: t.agentExecutionContext.assignedTask,
-      layerIds: t.vectorSearchLayerIds,
+    await s({ text: "Similarity search to find fields" }, e);
+    const t = g(e, "fieldSearch"), a = g(e, "layersAndFieldsRegistry"), o = g(e, "embeddingCache"), n = await t.searchFields({
+      text: r.agentExecutionContext.assignedTask,
+      layerIds: r.vectorSearchLayerIds,
       minScore: h,
-      topResults: z,
+      topResults: V,
       embeddingCache: o
     }), c = n.map(({ layerId: d, results: p }) => {
-      const y = p.map((s) => `  - ${s.name} (${s.score.toFixed(2)})`).join(`
+      const y = p.map((i) => `  - ${i.name} (${i.score.toFixed(2)})`).join(`
 `);
       return `${a.get(d)?.layerItem.name ?? d}:
 ${y}`;
@@ -32,128 +51,128 @@ ${y}`;
 `);
     let l;
     return n.length > 0 ? l = `Vector search completed. Matching layers and fields with scores:
-${c}` : l = `No vector search results found for score over ${h}.`, await i({ text: l }, e), {
-      ...t,
+${c}` : l = `No vector search results found for score over ${h}.`, await s({ text: l }, e), {
+      ...r,
       vectorSearchFieldResults: n
     };
-  } catch (r) {
-    throw await i(
-      { text: `Error during vector search: ${r instanceof Error ? r.message : String(r)}` },
+  } catch (t) {
+    throw await s(
+      { text: `Error during vector search: ${t instanceof Error ? t.message : String(t)}` },
       e
-    ), new Error(`Vector search failed: ${r instanceof Error ? r.message : String(r)}`);
+    ), new Error(`Vector search failed: ${t instanceof Error ? t.message : String(t)}`);
   }
-}, P = 0.7, H = async (t, e) => {
+}, D = 0.7, H = async (r, e) => {
   try {
-    await i(
-      { text: `Similarity search to find layers: ${t.agentExecutionContext.assignedTask}` },
+    await s(
+      { text: `Similarity search to find layers: ${r.agentExecutionContext.assignedTask}` },
       e
     );
-    const r = g(e, "layerSearch"), a = g(e, "layersAndFieldsRegistry"), o = await r.searchLayers({
-      text: t.agentExecutionContext.assignedTask,
-      minScore: P
+    const t = g(e, "layerSearch"), a = g(e, "layersAndFieldsRegistry"), o = await t.searchLayers({
+      text: r.agentExecutionContext.assignedTask,
+      minScore: D
     }), n = o.map((d) => d.id), c = o.map(({ id: d, score: p }) => `${a.get(d)?.layerItem.name ?? d} (${p.toFixed(2)})`).join(`
 `);
     let l;
     return n.length > 0 ? l = `Vector search completed. Matching layers with scores:
-${c}` : l = "Vector search completed. No matching layers found.", await i({ text: l }, e), {
-      ...t,
+${c}` : l = "Vector search completed. No matching layers found.", await s({ text: l }, e), {
+      ...r,
       vectorSearchLayerIds: n
     };
-  } catch (r) {
-    throw await i(
-      { text: `Error during vector search: ${r instanceof Error ? r.message : String(r)}` },
+  } catch (t) {
+    throw await s(
+      { text: `Error during vector search: ${t instanceof Error ? t.message : String(t)}` },
       e
-    ), new Error(`Vector search failed: ${r instanceof Error ? r.message : String(r)}`);
+    ), new Error(`Vector search failed: ${t instanceof Error ? t.message : String(t)}`);
   }
 }, f = [
-  v,
+  I,
   T,
   R,
   F,
+  $,
   C,
   A,
-  $,
   N,
-  b,
   q,
-  M
-], x = (t, e = 3) => {
-  const r = t.map((o, n) => o.type === "human" ? n : -1).filter((o) => o !== -1);
-  if (r.length === 0)
+  M,
+  _
+], x = (r, e = 3) => {
+  const t = r.map((o, n) => o.type === "human" ? n : -1).filter((o) => o !== -1);
+  if (t.length === 0)
     return [];
-  const a = r.length > e ? r[r.length - e] : r[0];
-  return t.slice(a);
-}, G = async (t, e) => {
-  await i({ text: "Requesting LLM for layer query results" }, e);
-  const r = await _("navigation_intent_prompt");
+  const a = t.length > e ? t[t.length - e] : t[0];
+  return r.slice(a);
+}, G = async (r, e) => {
+  await s({ text: "Requesting LLM for layer query results" }, e);
+  const t = await b("navigation_intent_prompt");
   if (!e?.configurable)
     throw new Error("config.configurable is required for layer query tools");
   const a = {
-    layerFieldInfo: t.layerFieldInfo
-  }, o = await I({
-    promptText: r,
+    layerFieldInfo: r.layerFieldInfo
+  }, o = await v({
+    promptText: t,
     modelTier: "advanced",
     config: e,
-    messages: x(t.agentExecutionContext.messages),
+    messages: x(r.agentExecutionContext.messages),
     inputVariables: a,
     tools: f
   });
-  return await V(o, e), {
-    ...t,
+  return await P(o, e), {
+    ...r,
     agentExecutionContext: {
-      ...t.agentExecutionContext,
-      messages: [...t.agentExecutionContext.messages, o]
+      ...r.agentExecutionContext,
+      messages: [...r.agentExecutionContext.messages, o]
     }
   };
 };
-async function B(t, e) {
-  const a = await new j(f, { handleToolErrors: !1 }).invoke(
+async function O(r, e) {
+  const a = await new k(f, { handleToolErrors: !1 }).invoke(
     {
-      messages: x(t.agentExecutionContext.messages)
+      messages: x(r.agentExecutionContext.messages)
     },
     e
   ), o = a.messages.map((c) => c.text).join(`
 `);
-  await i({ text: `Finished executing layer filter tool: ${o}` }, e);
+  await s({ text: `Finished executing layer filter tool: ${o}` }, e);
   const n = a.messages.map((c) => c.text).join(`
 `);
-  return { ...t, outputMessage: n };
+  return { ...r, outputMessage: n };
 }
-const U = async (t, e) => (await i({ text: "Exiting Layer Styling agent" }, e), t), J = async (t, e) => {
+const U = async (r, e) => (await s({ text: "Exiting Layer Styling agent" }, e), r), B = async (r, e) => {
   try {
-    await i({ text: "Populating layer and field info" }, e);
-    const r = [];
-    for (const a of t.vectorSearchFieldResults) {
+    await s({ text: "Populating layer and field info" }, e);
+    const t = [];
+    for (const a of r.vectorSearchFieldResults) {
       let o = function(y) {
-        const s = l.get(y)?.layerItem;
-        return s ? [
-          s.name && `Name: ${s.name}`,
-          s.title && `Title: ${s.title}`,
-          s.description && `Description: ${s.description}`
+        const i = l.get(y)?.layerItem;
+        return i ? [
+          i.name && `Name: ${i.name}`,
+          i.title && `Title: ${i.title}`,
+          i.description && `Description: ${i.description}`
         ].filter(Boolean).join(" | ") : y;
       };
       const { layerId: n, results: c } = a, l = g(e, "layersAndFieldsRegistry"), d = l.get(n)?.fieldRegistry;
       if (!d)
         continue;
-      let p = r.find((y) => y.layerId === n);
+      let p = t.find((y) => y.layerId === n);
       p || (p = {
         layerId: n,
         layerSummary: o(n),
         fieldInfos: []
-      }, r.push(p));
+      }, t.push(p));
       for (const y of c) {
-        const s = d.get(y.name);
-        s && p.fieldInfos.push(s);
+        const i = d.get(y.name);
+        i && p.fieldInfos.push(i);
       }
     }
-    return await i({ text: "Populated layerFieldInfo" }, e), { ...t, layerFieldInfo: r };
-  } catch (r) {
-    throw await i({ text: "Error populating layerFieldInfo" }, e), new Error(`Error populating layerFieldInfo: ${r instanceof Error ? r.message : String(r)}`);
+    return await s({ text: "Populated layerFieldInfo" }, e), { ...r, layerFieldInfo: t };
+  } catch (t) {
+    throw await s({ text: "Error populating layerFieldInfo" }, e), new Error(`Error populating layerFieldInfo: ${t instanceof Error ? t.message : String(t)}`);
   }
-}, K = (t, e) => {
-  const r = t.vectorSearchLayerIds ?? [];
-  if (r.length <= 1)
-    return { ...t, selectedLayerId: t.vectorSearchLayerIds[0] };
+}, J = (r, e) => {
+  const t = r.vectorSearchLayerIds ?? [];
+  if (t.length <= 1)
+    return { ...r, selectedLayerId: r.vectorSearchLayerIds[0] };
   const { hitlResponse: a } = e.configurable;
   if (a?.agentId !== u.id || a.id !== "reviewLayerSelection") {
     const n = {
@@ -161,16 +180,16 @@ const U = async (t, e) => (await i({ text: "Exiting Layer Styling agent" }, e),
       id: "reviewLayerSelection",
       kind: "singleSelection",
       message: "Choose a layer to apply the styles.",
-      metadata: [...r]
+      metadata: [...t]
     };
-    throw new E(n);
+    throw new w(n);
   }
   let o = null;
   return Array.isArray(a.payload) && a.payload.length > 0 && (o = a.payload[0]), {
-    ...t,
-    selectedLayerId: o ?? t.vectorSearchLayerIds[0]
+    ...r,
+    selectedLayerId: o ?? r.vectorSearchLayerIds[0]
   };
-}, O = (t, e) => k(["layerSearch", "fieldSearch", "layersAndFieldsRegistry"], "Layer Styling Agent")(t, e), Q = () => new L(S).addNode("requireLayerStylingServices", O).addNode("vectorSearchLayers", H).addNode("layerSelectionHITL", K).addNode("vectorSearchFields", D).addNode("populateLayerFieldInfo", J).addNode("agent", G).addNode("tools", B).addNode("earlyExit", U).addEdge(w, "requireLayerStylingServices").addEdge("requireLayerStylingServices", "vectorSearchLayers").addConditionalEdges(
+}, K = (r, e) => j(["layerSearch", "fieldSearch", "layersAndFieldsRegistry"], "Layer Styling Agent")(r, e), Q = () => new L(S).addNode("requireLayerStylingServices", K).addNode("vectorSearchLayers", H).addNode("layerSelectionHITL", J).addNode("vectorSearchFields", z).addNode("populateLayerFieldInfo", B).addNode("agent", G).addNode("tools", O).addNode("earlyExit", U).addEdge(E, "requireLayerStylingServices").addEdge("requireLayerStylingServices", "vectorSearchLayers").addConditionalEdges(
   "layerSelectionHITL",
   (e) => e.vectorSearchLayerIds.length ? "vectorSearchFields" : "earlyExit"
 ).addConditionalEdges(
@@ -188,5 +207,6 @@ const U = async (t, e) => (await i({ text: "Exiting Layer Styling agent" }, e),
   workspace: S
 };
 export {
-  u as L
+  u as L,
+  P as h
 };

package/dist/chunks/mergeWhereClauses.js

@@ -0,0 +1,15 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+const r = (e, s, a) => {
+  if (!(a ? e.hasAllFeaturesInView : e.hasAllFeatures))
+    return !1;
+  const n = new Set((e.availableFields ?? []).map((t) => t.toLowerCase()));
+  return n.has("*") ? !0 : s.every((t) => n.has(t.toLowerCase()));
+};
+function u(e, s) {
+  let a = e ?? "";
+  return s != null && s && (a = a ? `(${a}) AND (${s})` : s), a || null;
+}
+export {
+  r as c,
+  u as m
+};

package/dist/chunks/navigationAgent.js

@@ -0,0 +1,25 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { createSkillAgent as r } from "../agents/runtime/skill/createSkillAgent.js";
+import { f as n } from "./fetchAgentContext.js";
+const s = ({ config: a }) => {
+  const { mapView: e } = n(a, ["mapView"]), o = e.map, t = Number.isFinite(e.zoom) ? e.zoom : void 0;
+  return JSON.stringify(
+    {
+      availableBookmarks: o.bookmarks?.map(({ name: i }) => i).filter(Boolean) ?? [],
+      currentZoom: t
+    },
+    null,
+    2
+  );
+}, l = [async () => (await import("./SKILL4.js")).default], c = r({
+  id: "navigation",
+  name: "Navigation Agent",
+  description: "Navigates the map for explicit zoom, center, address, bookmark, layer, feature, extent, scale, and viewpoint requests. Use for questions asking where a place is or to resolve an address or place as a reusable spatial anchor for a proximity request. Resolves only the location; it does not query, display, filter, or highlight feature data.",
+  skillLoaders: l,
+  modelTier: "default",
+  systemPrompt: "You are an ArcGIS map navigation agent.",
+  runtimeContextLoader: s
+});
+export {
+  c as N
+};

package/dist/chunks/navigation_intent_prompt.js

@@ -36,8 +36,14 @@ This is the order of preference in case of overlap:
 
 For example, "Where is Yosemite National Park". This is an address, but:
 A map that contains a bookmark with Yosemite National Park should prefer the bookmark.
-A map that has the National Parks layer, for example, should prefer the feature.
-If these do not exist, geocode and go to that address.
+If bookmark does not exist, a map that has the National Parks layer, for example, should prefer the feature.
+If both of these do not exist, geocode and go to that address.
+
+Additional mapping guidance:
+
+- "zoom/go to [layer]" with no filter → prefer \`goToLayer\`.
+- "zoom/go to [features] where/with ..." (has a condition/filter) → prefer \`goToFeatures\`.
+- Explicit numeric zoom/scale/viewpoint requests → prefer the matching zoom/scale/viewpoint tool.
 
 Return the name of the tool as a string.
 `;