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

package/dist/chunks/helpGraph.js

@@ -1,18 +1,20 @@
 /* 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 c } 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 { 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 { s as m } from "./index.js";
 import "@langchain/core/prompts";
-const m = [h], v = (e) => {
+const u = [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) => {
@@ -31,12 +33,13 @@ ${t}`;
 `) : "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,
+      config: t,
+      tools: u,
       inputVariables: {
         layerSummary: v(s),
         agents: T(l),
@@ -65,16 +68,16 @@ async function _(e, t) {
     };
   }
 }
-const C = (e, t) => f(["agentRegistry"], "Help Agent")(e, t);
+const C = (e, t) => x(["agentRegistry"], "Help Agent")(e, t);
 async function H(e, t) {
-  const r = new E(m);
+  const r = new E(u, { 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 +89,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 +101,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 b = () => new d(c).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.
 
   _Example: “Tell me about this map”_  
   _Example: “List all layers in this map”_  
@@ -111,13 +114,13 @@ const b = () => new d(u).addNode("requireHelpServices", C).addNode("agent", _).a
   
   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.
   _Example: "Create a chart"_
-  _Example: "Create a table"_`, D = {
+  _Example: "Create a table"_`, G = {
   id: "help",
   name: "Help Agent",
   description: M,
   createGraph: b,
-  workspace: u
+  workspace: c
 };
 export {
-  D as H
+  G as H
 };

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", or "the previous results", 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", or "them" 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,30 @@
 /* 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 { 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 +48,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 +67,8 @@ ${c}` : l = "Vector search completed. No matching layers found.", await i({ text
   }
 }, f = [
   v,
-  R,
   T,
+  R,
   F,
   C,
   A,
@@ -91,11 +93,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 +107,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 +132,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 +163,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(

package/dist/chunks/navigationGraph.js

@@ -1,15 +1,17 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { StateGraph as E, START as $, END as C } from "@langchain/langgraph/web";
+import { StateGraph as b, START as $, END as C } from "@langchain/langgraph/web";
 import { k as F, m as R, n as L, o as M, p as A, u as _, v as I, w as q, x as Z, g as T, y as k, t as j, f as u, r as P, N as w } from "./adapter.js";
 import "@arcgis/core/identity/IdentityManager.js";
 import "@arcgis/core/portal/Portal.js";
-import { j as V, s as h, i as z } from "./generateLayerDescriptions.js";
+import { h as V, i as z } 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 { s as h } from "./index.js";
 import "@langchain/core/prompts";
 import { ToolNode as G } from "@langchain/langgraph/prebuilt";
 import x from "zod";
@@ -25,14 +27,14 @@ const S = [
   Z
 ];
 async function O(e, t) {
-  const o = await T("navigation_tool_prompt"), { mapView: s } = k(t), i = s.map.bookmarks?.map((p) => p.name).filter(Boolean) ?? [], c = e.vectorSearchLayerResults?.length > 0 ? e.vectorSearchLayerResults.map(
-    (p, b) => `${b + 1}. layerId=${p.id} | title=${p.title ?? ""} | name=${p.name ?? ""} | score=${p.score.toFixed(2)}`
+  const o = await T("navigation_tool_prompt"), { mapView: s } = k(t), i = s.map.bookmarks?.map((p) => p.name).filter(Boolean) ?? [], l = e.vectorSearchLayerResults?.length > 0 ? e.vectorSearchLayerResults.map(
+    (p, E) => `${E + 1}. layerId=${p.id} | title=${p.title ?? ""} | name=${p.name ?? ""} | score=${p.score.toFixed(2)}`
   ).join(`
-`) : "", l = e.vectorSearchFieldResults?.length > 0 ? JSON.stringify(e.vectorSearchFieldResults, null, 2) : "", a = e.intent === "goToBookmark" && i.length ? `Available bookmarks:
+`) : "", c = e.vectorSearchFieldResults?.length > 0 ? JSON.stringify(e.vectorSearchFieldResults, null, 2) : "", a = e.intent === "goToBookmark" && i.length ? `Available bookmarks:
 ${i.map((p) => `- ${p}`).join(`
 `)}` : "", r = (e.intent === "goToLayer" || e.intent === "goToFeatures") && e.vectorSearchLayerResults?.length ? `Candidate layers:
-${c}` : "", d = e.intent === "goToFeatures" && e.vectorSearchFieldResults?.length ? `Candidate fields:
-${l}` : "", y = {
+${l}` : "", d = e.intent === "goToFeatures" && e.vectorSearchFieldResults?.length ? `Candidate fields:
+${c}` : "", y = {
     intent: e.intent,
     bookmarksSection: a,
     layersSection: r,
@@ -44,6 +46,7 @@ ${l}` : "", y = {
   }, n = await V({
     promptText: o,
     modelTier: "fast",
+    config: t,
     inputVariables: y,
     tools: S
   }), m = (n.tool_calls?.length ?? 0) > 0, v = typeof n.text == "string" ? n.text.trim() : "", N = v.length > 0;
@@ -70,7 +73,7 @@ const B = (e) => {
   return { text: t };
 };
 async function D(e, t) {
-  const o = new G(S);
+  const o = new G(S, { handleToolErrors: !1 });
   try {
     const s = e.navigationInternalState.toolCallMessage;
     if (!s)
@@ -81,19 +84,19 @@ async function D(e, t) {
       },
       t
     );
-    let i = "", c;
-    for (const l of g) {
-      const a = B(l.content);
+    let i = "", l;
+    for (const c of g) {
+      const a = B(c.content);
       a.text && (i += `${a.text}
-`), a.sharedStatePatch && (c = {
-        ...c,
+`), a.sharedStatePatch && (l = {
+        ...l,
         ...a.sharedStatePatch
       });
     }
     return await h({ text: `Finished executing navigation tool: ${i}` }, t), {
       ...e,
       outputMessage: i,
-      sharedStatePatch: c,
+      sharedStatePatch: l,
       status: "success",
       summary: i ? j(i) : "Navigation executed.",
       navigationInternalState: {
@@ -120,12 +123,12 @@ async function J(e, t) {
     name: n.name,
     description: n.description,
     schema: n.schema
-  })), c = s.map.bookmarks?.map((n) => n.name).filter(Boolean) ?? [], l = c.length ? `Available bookmarks:
-${c.map((n) => `- ${n}`).join(`
+  })), l = s.map.bookmarks?.map((n) => n.name).filter(Boolean) ?? [], c = l.length ? `Available bookmarks:
+${l.map((n) => `- ${n}`).join(`
 `)}` : "", a = {
     tools: g.map(({ name: n, description: m, schema: v }) => `${n}: ${m}, ${JSON.stringify(v)}`).join(`
 `),
-    bookmarks: l,
+    bookmarks: c,
     assignedTask: e.agentExecutionContext.assignedTask,
     userRequest: e.agentExecutionContext.userRequest,
     priorSteps: e.agentExecutionContext.priorSteps
@@ -133,6 +136,7 @@ ${c.map((n) => `- ${n}`).join(`
     intent: x.string()
   }), d = await z({
     promptText: o,
+    config: t,
     inputVariables: a,
     schema: r,
     modelTier: "fast"
@@ -145,7 +149,7 @@ const H = 0.7, U = async (e, t) => {
       { text: `Similarity search to find layers: ${e.agentExecutionContext.assignedTask}` },
       t
     );
-    const o = u(t, "layerSearch"), s = u(t, "layersAndFieldsRegistry"), g = u(t, "embeddingCache"), c = (await o.searchLayers({
+    const o = u(t, "layerSearch"), s = u(t, "layersAndFieldsRegistry"), g = u(t, "embeddingCache"), l = (await o.searchLayers({
       text: e.agentExecutionContext.assignedTask,
       minScore: H,
       embeddingCache: g
@@ -158,12 +162,12 @@ const H = 0.7, U = async (e, t) => {
         score: r
       };
     });
-    let l;
-    return c.length > 0 ? l = `Vector search completed. Matching layers:
-${c.map((a) => `- layerId=${a.id} | title=${a.title ?? ""} | name=${a.name ?? ""} | score=${a.score.toFixed(2)}`).join(`
-`)}` : l = "Vector search completed. No matching layers found.", await h({ text: l }, t), {
+    let c;
+    return l.length > 0 ? c = `Vector search completed. Matching layers:
+${l.map((a) => `- layerId=${a.id} | title=${a.title ?? ""} | name=${a.name ?? ""} | score=${a.score.toFixed(2)}`).join(`
+`)}` : c = "Vector search completed. No matching layers found.", await h({ text: c }, t), {
       ...e,
-      vectorSearchLayerResults: c
+      vectorSearchLayerResults: l
     };
   } catch (o) {
     throw await h(
@@ -180,7 +184,7 @@ ${c.map((a) => `- layerId=${a.id} | title=${a.title ?? ""} | name=${a.name ?? ""
     const o = u(t, "fieldSearch"), s = u(t, "layersAndFieldsRegistry"), g = u(t, "embeddingCache"), i = e.vectorSearchLayerResults?.map((r) => r.id) ?? [];
     if (i.length === 0)
       return await h({ text: "No candidate layers for field search" }, t), e;
-    const l = (await o.searchFields({
+    const c = (await o.searchFields({
       text: e.agentExecutionContext.assignedTask,
       layerIds: i,
       minScore: f,
@@ -205,15 +209,15 @@ ${c.map((a) => `- layerId=${a.id} | title=${a.title ?? ""} | name=${a.name ?? ""
       };
     });
     let a;
-    return l.length > 0 ? a = `Vector search completed. Matching layers and fields:
-${l.map(
+    return c.length > 0 ? a = `Vector search completed. Matching layers and fields:
+${c.map(
       (r) => `${r.layerName ?? r.layerId}:
 ${r.results.map((d) => `  - ${d.name} (${d.score.toFixed(2)})`).join(`
 `)}`
     ).join(`
 `)}` : a = `No vector search field results found for score over ${f}.`, await h({ text: a }, t), {
       ...e,
-      vectorSearchFieldResults: l
+      vectorSearchFieldResults: c
     };
   } catch (o) {
     throw await h(
@@ -221,7 +225,7 @@ ${r.results.map((d) => `  - ${d.name} (${d.score.toFixed(2)})`).join(`
       t
     ), o;
   }
-}, Q = (e, t) => P(["layerSearch", "layersAndFieldsRegistry"], "Navigation Agent")(e, t), X = () => new E(w).addNode("requireNavigationServices", Q).addNode("intentLLM", J).addNode("vectorSearchLayers", U).addNode("vectorSearchFields", K).addNode("agent", O).addNode("tools", D).addEdge($, "requireNavigationServices").addEdge("requireNavigationServices", "intentLLM").addConditionalEdges(
+}, Q = (e, t) => P(["layerSearch", "layersAndFieldsRegistry"], "Navigation Agent")(e, t), X = () => new b(w).addNode("requireNavigationServices", Q).addNode("intentLLM", J).addNode("vectorSearchLayers", U).addNode("vectorSearchFields", K).addNode("agent", O).addNode("tools", D).addEdge($, "requireNavigationServices").addEdge("requireNavigationServices", "intentLLM").addConditionalEdges(
   "intentLLM",
   (t) => t.intent === "goToLayer" || t.intent === "goToFeatures" ? "vectorSearchLayers" : "agent",
   {
@@ -254,7 +258,7 @@ ${r.results.map((d) => `  - ${d.name} (${d.score.toFixed(2)})`).join(`
   _Example: “Center the map on San Francisco at scale 50000”_  
   _Example: “Zoom to the features in the schools layer where city = 'Austin'”_  
   _Example: “Go to the Downtown bookmark”_  
-  _Example: “Where is Mount Rainier?”_`, pe = {
+  _Example: “Where is Mount Rainier?”_`, ye = {
   id: "navigation",
   name: "Navigation Agent",
   description: Y,
@@ -262,5 +266,5 @@ ${r.results.map((d) => `  - ${d.name} (${d.score.toFixed(2)})`).join(`
   workspace: w
 };
 export {
-  pe as N
+  ye as N
 };