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

package/dist/chunks/navigationGraph.js

@@ -1,64 +1,83 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-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 { StateGraph as E, START as $, END as R } from "@langchain/langgraph/web";
+import { g as T, t as C, r as F, N as k } 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 L, i as M } from "./generateLayerDescriptions.js";
 import "@langchain/core/messages";
 import "@langchain/core/callbacks/dispatch/web";
+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 { goToAddressTool as A } from "../agents/tools/navigation/goToAddress/adapter.js";
+import { goToBookmarkTool as _ } from "../agents/tools/navigation/goToBookmark/adapter.js";
+import { goToFeaturesTool as I } from "../agents/tools/navigation/goToFeatures/adapter.js";
+import { goToFullExtentTool as q } from "../agents/tools/navigation/goToFullExtent/adapter.js";
+import { goToHomeExtentTool as Z } from "../agents/tools/navigation/goToHomeExtent/adapter.js";
+import { goToLayerTool as V } from "../agents/tools/navigation/goToLayer/adapter.js";
+import { goToScaleTool as j } from "../agents/tools/navigation/goToScale/adapter.js";
+import { goToViewpointTool as P } from "../agents/tools/navigation/goToViewpoint/adapter.js";
+import { goToZoomTool as z } from "../agents/tools/navigation/goToZoom/adapter.js";
+import { f as w } from "./fetchAgentContext.js";
+import { h as G } from "./toolCallResponse.js";
+import { s as p } from "./index.js";
 import "@langchain/core/prompts";
-import { ToolNode as G } from "@langchain/langgraph/prebuilt";
-import x from "zod";
-const S = [
-  F,
-  R,
-  L,
-  M,
+import { ToolNode as O } from "@langchain/langgraph/prebuilt";
+import S from "zod";
+import { f as y } from "./fetchService.js";
+const f = [
   A,
   _,
   I,
   q,
-  Z
+  Z,
+  V,
+  j,
+  P,
+  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)}`
+async function B(e, t) {
+  const o = await T("navigation_tool_prompt"), { mapView: s } = w(t, ["mapView"]), c = s.map.bookmarks?.map((u) => u.name).filter(Boolean) ?? [], m = e.vectorSearchLayerResults?.length > 0 ? e.vectorSearchLayerResults.map(
+    (u, b) => `${b + 1}. layerId=${u.id} | title=${u.title ?? ""} | name=${u.name ?? ""} | score=${u.score.toFixed(2)}`
   ).join(`
-`) : "", l = 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 = e.vectorSearchFieldResults?.length > 0 ? JSON.stringify(e.vectorSearchFieldResults, null, 2) : "", r = e.intent === "goToBookmark" && c.length ? `Available bookmarks:
+${c.map((u) => `- ${u}`).join(`
+`)}` : "", a = (e.intent === "goToLayer" || e.intent === "goToFeatures") && e.vectorSearchLayerResults?.length ? `Candidate layers:
+${m}` : "", i = e.intent === "goToFeatures" && e.vectorSearchFieldResults?.length ? `Candidate fields:
+${l}` : "", h = {
     intent: e.intent,
-    bookmarksSection: a,
-    layersSection: r,
-    fieldsSection: d,
+    bookmarksSection: r,
+    layersSection: a,
+    fieldsSection: i,
     currentZoom: s.zoom,
     assignedTask: e.agentExecutionContext.assignedTask,
     userRequest: e.agentExecutionContext.userRequest,
     priorSteps: e.agentExecutionContext.priorSteps
-  }, n = await V({
+  }, n = await L({
     promptText: o,
     modelTier: "fast",
-    inputVariables: y,
-    tools: S
-  }), m = (n.tool_calls?.length ?? 0) > 0, v = typeof n.text == "string" ? n.text.trim() : "", N = v.length > 0;
+    config: t,
+    inputVariables: h,
+    tools: f
+  });
+  await G(n, t);
+  const g = (n.tool_calls?.length ?? 0) > 0, v = typeof n.text == "string" ? n.text.trim() : "", N = v.length > 0;
   return {
     ...e,
     navigationInternalState: {
       ...e.navigationInternalState,
-      toolCallMessage: m ? n : void 0
+      toolCallMessage: g ? n : void 0
     },
     // No tool call => surface fallback text now. Tool call => tool node will set output.
-    outputMessage: m ? e.outputMessage : v,
-    status: m ? e.status : N ? "success" : "failed"
+    outputMessage: g ? e.outputMessage : v,
+    status: g ? 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,45 +88,48 @@ 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(f, { 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);
-      a.text && (i += `${a.text}
-`), a.sharedStatePatch && (c = {
-        ...c,
-        ...a.sharedStatePatch
-      });
+    let c = "", m, l;
+    for (const r of d) {
+      const a = D(r.content), i = r.artifact;
+      a.text && (c += `${a.text}
+`);
+      const h = i?.sharedStatePatch ?? a.sharedStatePatch;
+      h && (m = {
+        ...m,
+        ...h
+      }), i?.sharedResourceAdditions && (l = [...l ?? [], ...i.sharedResourceAdditions]);
     }
-    return await h({ text: `Finished executing navigation tool: ${i}` }, t), {
+    return await p({ text: `Finished executing navigation tool: ${c}` }, t), {
       ...e,
-      outputMessage: i,
-      sharedStatePatch: c,
+      outputMessage: c,
+      sharedStatePatch: m,
+      sharedResourceAdditions: l,
       status: "success",
-      summary: i ? j(i) : "Navigation executed.",
+      summary: c ? C(c) : "Navigation executed.",
       navigationInternalState: {
         ...e.navigationInternalState,
         toolCallMessage: void 0
       }
     };
   } 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 p({ 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,113 +137,115 @@ 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 } = w(t, ["mapView"]), d = f.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(`
+  })), m = s.map.bookmarks?.map((n) => n.name).filter(Boolean) ?? [], l = m.length ? `Available bookmarks:
+${m.map((n) => `- ${n}`).join(`
+`)}` : "No bookmarks are available in this map.", r = {
+    tools: d.map(({ name: n, description: g, schema: v }) => `${n}: ${g}, ${JSON.stringify(v)}`).join(`
 `),
     bookmarks: l,
     assignedTask: e.agentExecutionContext.assignedTask,
     userRequest: e.agentExecutionContext.userRequest,
     priorSteps: e.agentExecutionContext.priorSteps
-  }, r = x.object({
-    intent: x.string()
-  }), d = await z({
+  }, a = S.object({
+    intent: S.string()
+  }), i = await M({
     promptText: o,
-    inputVariables: a,
-    schema: r,
+    config: t,
+    inputVariables: r,
+    schema: a,
     modelTier: "fast"
-  }), y = typeof d.intent == "string" ? d.intent.trim().replace(/^"|"$/gu, "") : "";
-  return { ...e, intent: y || "" };
+  }), h = typeof i.intent == "string" ? i.intent.trim().replace(/^"|"$/gu, "") : "";
+  return { ...e, intent: h || "" };
 }
-const H = 0.7, U = async (e, t) => {
+const U = 0.7, W = async (e, t) => {
   try {
-    await h(
+    await p(
       { 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 = y(t, "layerSearch"), s = y(t, "layersAndFieldsRegistry"), d = y(t, "embeddingCache"), m = (await o.searchLayers({
       text: e.agentExecutionContext.assignedTask,
-      minScore: H,
-      embeddingCache: g
-    })).map(({ id: a, score: r }) => {
-      const d = s.get(a)?.layerItem;
+      minScore: U,
+      embeddingCache: d
+    })).map(({ id: r, score: a }) => {
+      const i = s.get(r)?.layerItem;
       return {
-        id: a,
-        title: d?.title,
-        name: d?.name ?? void 0,
-        score: r
+        id: r,
+        title: i?.title,
+        name: i?.name ?? void 0,
+        score: a
       };
     });
     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), {
+    return m.length > 0 ? l = `Vector search completed. Matching layers:
+${m.map((r) => `- layerId=${r.id} | title=${r.title ?? ""} | name=${r.name ?? ""} | score=${r.score.toFixed(2)}`).join(`
+`)}` : l = "Vector search completed. No matching layers found.", await p({ text: l }, t), {
       ...e,
-      vectorSearchLayerResults: c
+      vectorSearchLayerResults: m
     };
   } catch (o) {
-    throw await h(
+    throw await p(
       { text: `Error during vector search layers: ${o instanceof Error ? o.message : String(o)}` },
       t
     ), o;
   }
-}, f = 0.7, W = 10, K = async (e, t) => {
+}, x = 0.7, K = 10, Q = async (e, t) => {
   try {
-    await h(
+    await p(
       { 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) ?? [];
-    if (i.length === 0)
-      return await h({ text: "No candidate layers for field search" }, t), e;
+    const o = y(t, "fieldSearch"), s = y(t, "layersAndFieldsRegistry"), d = y(t, "embeddingCache"), c = e.vectorSearchLayerResults?.map((a) => a.id) ?? [];
+    if (c.length === 0)
+      return await p({ text: "No candidate layers for field search" }, t), e;
     const l = (await o.searchFields({
       text: e.agentExecutionContext.assignedTask,
-      layerIds: i,
-      minScore: f,
-      topResults: W,
-      embeddingCache: g
-    })).map(({ layerId: r, results: d }) => {
-      const y = s.get(r)?.fieldRegistry;
+      layerIds: c,
+      minScore: x,
+      topResults: K,
+      embeddingCache: d
+    })).map(({ layerId: a, results: i }) => {
+      const h = s.get(a)?.fieldRegistry;
       return {
-        layerId: r,
-        layerName: s.get(r)?.layerItem.name,
-        results: d.map((n) => {
-          const m = y?.get(n.name);
+        layerId: a,
+        layerName: s.get(a)?.layerItem.name,
+        results: i.map((n) => {
+          const g = h?.get(n.name);
           return {
             name: n.name,
             score: n.score,
-            type: m?.type,
-            alias: m?.alias,
-            description: m?.description,
-            statistics: m?.statistics
+            type: g?.type,
+            alias: g?.alias,
+            description: g?.description,
+            statistics: g?.statistics,
+            domain: g?.domain
           };
         })
       };
     });
-    let a;
-    return l.length > 0 ? a = `Vector search completed. Matching layers and fields:
+    let r;
+    return l.length > 0 ? r = `Vector search completed. Matching layers and fields:
 ${l.map(
-      (r) => `${r.layerName ?? r.layerId}:
-${r.results.map((d) => `  - ${d.name} (${d.score.toFixed(2)})`).join(`
+      (a) => `${a.layerName ?? a.layerId}:
+${a.results.map((i) => `  - ${i.name} (${i.score.toFixed(2)})`).join(`
 `)}`
     ).join(`
-`)}` : a = `No vector search field results found for score over ${f}.`, await h({ text: a }, t), {
+`)}` : r = `No vector search field results found for score over ${x}.`, await p({ text: r }, t), {
       ...e,
       vectorSearchFieldResults: l
     };
   } catch (o) {
-    throw await h(
+    throw await p(
       { text: `Error during vector search fields: ${o instanceof Error ? o.message : String(o)}` },
       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) => F(["layerSearch", "layersAndFieldsRegistry"], "Navigation Agent")(e, t), Y = () => new E(k).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 +259,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", R), 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 +278,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?”_`, Le = {
   id: "navigation",
   name: "Navigation Agent",
-  description: Y,
-  createGraph: X,
-  workspace: w
+  description: ee,
+  createGraph: Y,
+  workspace: k
 };
 export {
-  pe as N
+  Le 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.
 `;