@arcgis/ai-components 5.2.0-next.6 → 5.2.0-next.61

package/dist/chunks/helpGraph.js

@@ -1,18 +1,22 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { StateGraph as d, START as g, END as i } from "@langchain/langgraph/web";
-import { l as h, g as x, f as p, r as f, t as y, H as u } from "./adapter.js";
+import { l as h, g as f, f as p, r as x, t as y, H as u } from "./adapter.js";
 import "@arcgis/core/identity/IdentityManager.js";
 import "@arcgis/core/portal/Portal.js";
-import { j as S, s as c } from "./generateLayerDescriptions.js";
+import "@arcgis/core/request.js";
+import "@arcgis/toolkit/string";
+import { h as S } from "./generateLayerDescriptions.js";
 import "@langchain/core/messages";
 import "@langchain/core/callbacks/dispatch/web";
 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 { ToolNode as E } from "@langchain/langgraph/prebuilt";
+import { h as E } from "./toolCallResponse.js";
+import { ToolNode as T } from "@langchain/langgraph/prebuilt";
+import { s as m } from "./index.js";
 import "@langchain/core/prompts";
-const m = [h], v = (e) => {
+const c = [h], v = (e) => {
   if (!e || e.size === 0)
     return "No layers available in this map.";
   const t = Array.from(e.values()).map(({ layerItem: r, fieldRegistry: s }, l) => {
@@ -25,26 +29,29 @@ const m = [h], v = (e) => {
   return `This map contains ${e.size} layer(s):
 
 ${t}`;
-}, T = (e) => {
+}, C = (e) => {
   const t = e?.list() ?? [];
   return t.length ? t.map((r) => `- ${r.agent.name}: ${r.agent.description}`).join(`
 `) : "No agents currently available.";
 };
 async function _(e, t) {
-  const r = await x("help_prompt"), s = p(t, "layersAndFieldsRegistry"), l = p(t, "agentRegistry");
+  const r = await f("help_prompt"), s = p(t, "layersAndFieldsRegistry"), l = p(t, "agentRegistry");
   try {
     const a = await S({
       promptText: r,
-      modelTier: "fast",
-      tools: m,
+      modelTier: "default",
+      config: t,
+      tools: c,
       inputVariables: {
         layerSummary: v(s),
-        agents: T(l),
+        agents: C(l),
         assignedTask: e.agentExecutionContext.assignedTask,
         userRequest: e.agentExecutionContext.userRequest,
         priorSteps: e.agentExecutionContext.priorSteps
       }
-    }), o = (a.tool_calls?.length ?? 0) > 0, n = typeof a.text == "string" ? a.text.trim() : "";
+    });
+    await E(a, t);
+    const o = (a.tool_calls?.length ?? 0) > 0, n = typeof a.text == "string" ? a.text.trim() : "";
     return {
       ...e,
       helpInternalState: {
@@ -65,16 +72,16 @@ async function _(e, t) {
     };
   }
 }
-const C = (e, t) => f(["agentRegistry"], "Help Agent")(e, t);
-async function H(e, t) {
-  const r = new E(m);
+const H = (e, t) => x(["agentRegistry"], "Help Agent")(e, t);
+async function b(e, t) {
+  const r = new T(c, { handleToolErrors: !1 });
   try {
     const s = e.helpInternalState.toolCallMessage;
     if (!s)
       throw new Error("helpToolCalling: missing helpInternalState.toolCallMessage");
     const a = (await r.invoke({ messages: [s] }, t)).messages.map((o) => o.text).join(`
 `);
-    return await c({ text: `Finished executing help tool: ${a}` }, t), {
+    return await m({ text: `Finished executing help tool: ${a}` }, t), {
       ...e,
       outputMessage: a,
       status: "success",
@@ -86,7 +93,7 @@ async function H(e, t) {
     };
   } catch (s) {
     const l = s instanceof Error ? s.message : String(s);
-    return await c({ text: `Help tool execution failed: ${l}` }, t), {
+    return await m({ text: `Help tool execution failed: ${l}` }, t), {
       ...e,
       outputMessage: `Help tool execution failed: ${l}`,
       status: "failed",
@@ -98,7 +105,7 @@ async function H(e, t) {
     };
   }
 }
-const b = () => new d(u).addNode("requireHelpServices", C).addNode("agent", _).addNode("tools", H).addEdge(g, "requireHelpServices").addEdge("requireHelpServices", "agent").addConditionalEdges("agent", (t) => t.helpInternalState.toolCallMessage ? "tools" : i).addEdge("tools", i), M = String.raw`- **help** — Enables users to ask questions about the map, layers, fields, and it's capabilities.
+const M = () => new d(u).addNode("requireHelpServices", H).addNode("agent", _).addNode("tools", b).addEdge(g, "requireHelpServices").addEdge("requireHelpServices", "agent").addConditionalEdges("agent", (t) => t.helpInternalState.toolCallMessage ? "tools" : i).addEdge("tools", i), k = String.raw`- **help** — Enables users to ask questions about the map, layers, fields, and it's capabilities.
 
   _Example: “Tell me about this map”_  
   _Example: “List all layers in this map”_  
@@ -107,17 +114,17 @@ const b = () => new d(u).addNode("requireHelpServices", C).addNode("agent", _).a
   _Example: “What can you do?”_  
   _Example: “What can I ask”_
   
-  Even if the user asks unrelated queries like "What are the vowels in English alphabet" or "How to cook", call this agent.
+  If the user asks unrelated queries like "What are the vowels in English alphabet" or "How to cook", call this agent so it can politely refuse and redirect to map-related questions.
   
-  IF the user asks map related queries, but those that are not performed by any of the agents, call this agent so we can respond accordingly.
+  IF the user asks map related queries, but those that are not performed by any of the agents, call this agent so we can respond that the requested action is not supported.
   _Example: "Create a chart"_
-  _Example: "Create a table"_`, D = {
+  _Example: "Create a table"_`, J = {
   id: "help",
   name: "Help Agent",
-  description: M,
-  createGraph: b,
+  description: k,
+  createGraph: M,
   workspace: u
 };
 export {
-  D as H
+  J 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/index.js

@@ -0,0 +1,11 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { dispatchCustomEvent as e } from "@langchain/core/callbacks/dispatch/web";
+const n = async (s, a) => {
+  await e("trace_message", s, a);
+}, o = async (s, a) => {
+  await e("graph_ux_suggestion", s, a);
+};
+export {
+  o as a,
+  n as s
+};

package/dist/chunks/intent_prompt.js

@@ -97,6 +97,20 @@ 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", "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.
+
+Resolve the reference using the most recent relevant chat history or successful prior step.
+
+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", "them", "this", or "it" in \`assignedTask\` when they can be resolved from context.
+
+---
+
 ## Assigned Task Guidelines (IMPORTANT)
 
 - The \`assignedTask\` must match the user’s request exactly in meaning
@@ -106,6 +120,8 @@ Do not reinterpret the request into a different form.
 
 - Keep the task short, specific, and directly executable
 - Keep wording close to the user’s request with minimal transformation
+- 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
 
 - The \`assignedTask\` may represent only part of the user’s request when multiple steps are necessary

package/dist/chunks/layerStylingGraph.js

@@ -1,28 +1,31 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { NodeInterrupt as L, StateGraph as w, START as E, END as m } from "@langchain/langgraph/web";
+import { NodeInterrupt as E, StateGraph as L, START as w, END as m } from "@langchain/langgraph/web";
 import "@arcgis/core/identity/IdentityManager.js";
 import "@arcgis/core/portal/Portal.js";
-import { s as i, j as I } from "./generateLayerDescriptions.js";
+import "@arcgis/core/request.js";
+import "@arcgis/toolkit/string";
+import { h as I } from "./generateLayerDescriptions.js";
 import "@langchain/core/messages";
+import { s as i } from "./index.js";
 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 p, z as v, A as R, B as T, 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 j, M as S } from "./adapter.js";
-import { h as k } from "./toolCallResponse.js";
-import { ToolNode as V } from "@langchain/langgraph/prebuilt";
+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) => {
   try {
     await i({ text: "Similarity search to find fields" }, e);
-    const r = p(e, "fieldSearch"), a = p(e, "layersAndFieldsRegistry"), o = p(e, "embeddingCache"), n = await r.searchFields({
+    const r = g(e, "fieldSearch"), a = g(e, "layersAndFieldsRegistry"), o = g(e, "embeddingCache"), n = await r.searchFields({
       text: t.agentExecutionContext.assignedTask,
       layerIds: t.vectorSearchLayerIds,
       minScore: h,
       topResults: z,
       embeddingCache: o
-    }), c = n.map(({ layerId: d, results: g }) => {
-      const y = g.map((s) => `  - ${s.name} (${s.score.toFixed(2)})`).join(`
+    }), c = n.map(({ layerId: d, results: p }) => {
+      const y = p.map((s) => `  - ${s.name} (${s.score.toFixed(2)})`).join(`
 `);
       return `${a.get(d)?.layerItem.name ?? d}:
 ${y}`;
@@ -46,10 +49,10 @@ ${c}` : l = `No vector search results found for score over ${h}.`, await i({ tex
       { text: `Similarity search to find layers: ${t.agentExecutionContext.assignedTask}` },
       e
     );
-    const r = p(e, "layerSearch"), a = p(e, "layersAndFieldsRegistry"), o = await r.searchLayers({
+    const r = g(e, "layerSearch"), a = g(e, "layersAndFieldsRegistry"), o = await r.searchLayers({
       text: t.agentExecutionContext.assignedTask,
       minScore: P
-    }), n = o.map((d) => d.id), c = o.map(({ id: d, score: g }) => `${a.get(d)?.layerItem.name ?? d} (${g.toFixed(2)})`).join(`
+    }), 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:
@@ -65,8 +68,8 @@ ${c}` : l = "Vector search completed. No matching layers found.", await i({ text
   }
 }, f = [
   v,
-  R,
   T,
+  R,
   F,
   C,
   A,
@@ -91,11 +94,12 @@ ${c}` : l = "Vector search completed. No matching layers found.", await i({ text
   }, o = await I({
     promptText: r,
     modelTier: "advanced",
+    config: e,
     messages: x(t.agentExecutionContext.messages),
     inputVariables: a,
     tools: f
   });
-  return await k(o, e), {
+  return await V(o, e), {
     ...t,
     agentExecutionContext: {
       ...t.agentExecutionContext,
@@ -104,7 +108,7 @@ ${c}` : l = "Vector search completed. No matching layers found.", await i({ text
   };
 };
 async function B(t, e) {
-  const a = await new V(f).invoke(
+  const a = await new j(f, { handleToolErrors: !1 }).invoke(
     {
       messages: x(t.agentExecutionContext.messages)
     },
@@ -129,18 +133,18 @@ const U = async (t, e) => (await i({ text: "Exiting Layer Styling agent" }, e),
           s.description && `Description: ${s.description}`
         ].filter(Boolean).join(" | ") : y;
       };
-      const { layerId: n, results: c } = a, l = p(e, "layersAndFieldsRegistry"), d = l.get(n)?.fieldRegistry;
+      const { layerId: n, results: c } = a, l = g(e, "layersAndFieldsRegistry"), d = l.get(n)?.fieldRegistry;
       if (!d)
         continue;
-      let g = r.find((y) => y.layerId === n);
-      g || (g = {
+      let p = r.find((y) => y.layerId === n);
+      p || (p = {
         layerId: n,
         layerSummary: o(n),
         fieldInfos: []
-      }, r.push(g));
+      }, r.push(p));
       for (const y of c) {
         const s = d.get(y.name);
-        s && g.fieldInfos.push(s);
+        s && p.fieldInfos.push(s);
       }
     }
     return await i({ text: "Populated layerFieldInfo" }, e), { ...t, layerFieldInfo: r };
@@ -160,14 +164,14 @@ const U = async (t, e) => (await i({ text: "Exiting Layer Styling agent" }, e),
       message: "Choose a layer to apply the styles.",
       metadata: [...r]
     };
-    throw new L(n);
+    throw new E(n);
   }
   let o = null;
   return Array.isArray(a.payload) && a.payload.length > 0 && (o = a.payload[0]), {
     ...t,
     selectedLayerId: o ?? t.vectorSearchLayerIds[0]
   };
-}, O = (t, e) => j(["layerSearch", "fieldSearch", "layersAndFieldsRegistry"], "Layer Styling Agent")(t, e), Q = () => new w(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(E, "requireLayerStylingServices").addEdge("requireLayerStylingServices", "vectorSearchLayers").addConditionalEdges(
+}, 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(
   "layerSelectionHITL",
   (e) => e.vectorSearchLayerIds.length ? "vectorSearchFields" : "earlyExit"
 ).addConditionalEdges(