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

package/dist/chunks/navigationGraph.js

@@ -3,15 +3,19 @@ import { StateGraph as E, 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 "@arcgis/core/request.js";
+import "@arcgis/toolkit/string";
+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 { h as G } from "./toolCallResponse.js";
+import { s as h } from "./index.js";
 import "@langchain/core/prompts";
-import { ToolNode as G } from "@langchain/langgraph/prebuilt";
+import { ToolNode as O } from "@langchain/langgraph/prebuilt";
 import x from "zod";
 const S = [
   F,
@@ -24,19 +28,19 @@ const S = [
   q,
   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(
+async function B(e, t) {
+  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, b) => `${b + 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}` : "", g = e.intent === "goToFeatures" && e.vectorSearchFieldResults?.length ? `Candidate fields:
+${c}` : "", y = {
     intent: e.intent,
     bookmarksSection: a,
     layersSection: r,
-    fieldsSection: d,
+    fieldsSection: g,
     currentZoom: s.zoom,
     assignedTask: e.agentExecutionContext.assignedTask,
     userRequest: e.agentExecutionContext.userRequest,
@@ -44,9 +48,12 @@ ${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;
+  });
+  await G(n, t);
+  const m = (n.tool_calls?.length ?? 0) > 0, v = typeof n.text == "string" ? n.text.trim() : "", N = v.length > 0;
   return {
     ...e,
     navigationInternalState: {
@@ -58,7 +65,7 @@ ${l}` : "", y = {
     status: m ? e.status : N ? "success" : "failed"
   };
 }
-const B = (e) => {
+const D = (e) => {
   const t = typeof e == "string" ? e : String(e);
   try {
     const o = JSON.parse(t);
@@ -69,31 +76,31 @@ const B = (e) => {
   }
   return { text: t };
 };
-async function D(e, t) {
-  const o = new G(S);
+async function J(e, t) {
+  const o = new O(S, { handleToolErrors: !1 });
   try {
     const s = e.navigationInternalState.toolCallMessage;
     if (!s)
       throw new Error("navigationToolCalling: missing navigationInternalState.toolCallMessage");
-    const { messages: g } = await o.invoke(
+    const { messages: d } = await o.invoke(
       {
         messages: [s]
       },
       t
     );
-    let i = "", c;
-    for (const l of g) {
-      const a = B(l.content);
+    let i = "", l;
+    for (const c of d) {
+      const a = D(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: {
@@ -102,12 +109,12 @@ async function D(e, t) {
       }
     };
   } catch (s) {
-    const g = s instanceof Error ? s.message : String(s);
-    return await h({ text: `Navigation tool execution failed: ${g}` }, t), {
+    const d = s instanceof Error ? s.message : String(s);
+    return await h({ text: `Navigation tool execution failed: ${d}` }, t), {
       ...e,
-      outputMessage: `Navigation tool execution failed: ${g}`,
+      outputMessage: `Navigation tool execution failed: ${d}`,
       status: "failed",
-      summary: `Navigation tool execution failed: ${g}`,
+      summary: `Navigation tool execution failed: ${d}`,
       navigationInternalState: {
         ...e.navigationInternalState,
         toolCallMessage: void 0
@@ -115,55 +122,56 @@ async function D(e, t) {
     };
   }
 }
-async function J(e, t) {
-  const o = await T("navigation_intent_prompt"), { mapView: s } = k(t), g = S.map((n) => ({
+async function H(e, t) {
+  const o = await T("navigation_intent_prompt"), { mapView: s } = k(t), d = S.map((n) => ({
     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(`
-`)}` : "", a = {
-    tools: g.map(({ name: n, description: m, schema: v }) => `${n}: ${m}, ${JSON.stringify(v)}`).join(`
+  })), l = s.map.bookmarks?.map((n) => n.name).filter(Boolean) ?? [], c = l.length ? `Available bookmarks:
+${l.map((n) => `- ${n}`).join(`
+`)}` : "No bookmarks are available in this map.", a = {
+    tools: d.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
   }, r = x.object({
     intent: x.string()
-  }), d = await z({
+  }), g = await z({
     promptText: o,
+    config: t,
     inputVariables: a,
     schema: r,
     modelTier: "fast"
-  }), y = typeof d.intent == "string" ? d.intent.trim().replace(/^"|"$/gu, "") : "";
+  }), y = typeof g.intent == "string" ? g.intent.trim().replace(/^"|"$/gu, "") : "";
   return { ...e, intent: y || "" };
 }
-const H = 0.7, U = async (e, t) => {
+const U = 0.7, W = async (e, t) => {
   try {
     await h(
       { 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"), d = u(t, "embeddingCache"), l = (await o.searchLayers({
       text: e.agentExecutionContext.assignedTask,
-      minScore: H,
-      embeddingCache: g
+      minScore: U,
+      embeddingCache: d
     })).map(({ id: a, score: r }) => {
-      const d = s.get(a)?.layerItem;
+      const g = s.get(a)?.layerItem;
       return {
         id: a,
-        title: d?.title,
-        name: d?.name ?? void 0,
+        title: g?.title,
+        name: g?.name ?? void 0,
         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(
@@ -171,27 +179,27 @@ ${c.map((a) => `- layerId=${a.id} | title=${a.title ?? ""} | name=${a.name ?? ""
       t
     ), o;
   }
-}, f = 0.7, W = 10, K = async (e, t) => {
+}, f = 0.7, K = 10, Q = async (e, t) => {
   try {
     await h(
       { text: `Similarity search to find fields: ${e.agentExecutionContext.assignedTask}` },
       t
     );
-    const o = u(t, "fieldSearch"), s = u(t, "layersAndFieldsRegistry"), g = u(t, "embeddingCache"), i = e.vectorSearchLayerResults?.map((r) => r.id) ?? [];
+    const o = u(t, "fieldSearch"), s = u(t, "layersAndFieldsRegistry"), d = 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,
-      topResults: W,
-      embeddingCache: g
-    })).map(({ layerId: r, results: d }) => {
+      topResults: K,
+      embeddingCache: d
+    })).map(({ layerId: r, results: g }) => {
       const y = s.get(r)?.fieldRegistry;
       return {
         layerId: r,
         layerName: s.get(r)?.layerItem.name,
-        results: d.map((n) => {
+        results: g.map((n) => {
           const m = y?.get(n.name);
           return {
             name: n.name,
@@ -205,15 +213,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(`
+${r.results.map((g) => `  - ${g.name} (${g.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 +229,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(
+}, X = (e, t) => P(["layerSearch", "layersAndFieldsRegistry"], "Navigation Agent")(e, t), Y = () => new E(w).addNode("requireNavigationServices", X).addNode("intentLLM", H).addNode("vectorSearchLayers", W).addNode("vectorSearchFields", Q).addNode("agent", B).addNode("tools", J).addEdge($, "requireNavigationServices").addEdge("requireNavigationServices", "intentLLM").addConditionalEdges(
   "intentLLM",
   (t) => t.intent === "goToLayer" || t.intent === "goToFeatures" ? "vectorSearchLayers" : "agent",
   {
@@ -235,7 +243,7 @@ ${r.results.map((d) => `  - ${d.name} (${d.score.toFixed(2)})`).join(`
     vectorSearchFields: "vectorSearchFields",
     agent: "agent"
   }
-).addEdge("vectorSearchFields", "agent").addEdge("agent", "tools").addEdge("tools", C), Y = String.raw`- **navigation** — Enables users to interact with the map by navigating to specific locations, layers, features, or extents.  
+).addEdge("vectorSearchFields", "agent").addEdge("agent", "tools").addEdge("tools", C), ee = String.raw`- **navigation** — Enables users to interact with the map by navigating to specific locations, layers, features, or extents.  
   This includes zooming, panning, centering, or geocoding based on user input. The agent is designed to handle explicit map movement requests. NOTE: DO NOT call this agent if the user asks "show me...", that is meant to be handled by another agent. If the query is about where a certain address is, call this agent.
 
   Supported actions:
@@ -254,13 +262,13 @@ ${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?”_`, xe = {
   id: "navigation",
   name: "Navigation Agent",
-  description: Y,
-  createGraph: X,
+  description: ee,
+  createGraph: Y,
   workspace: w
 };
 export {
-  pe as N
+  xe 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.
 `;