@arcgis/ai-components 5.2.0-next.16 → 5.2.0-next.18

package/dist/chunks/helpGraph.js

@@ -1,6 +1,6 @@
 /* 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 f, f as p, r as x, t as y, H as c } 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 "@arcgis/toolkit/string";
@@ -15,7 +15,7 @@ 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 u = [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) => {
@@ -40,7 +40,7 @@ async function _(e, t) {
       promptText: r,
       modelTier: "fast",
       config: t,
-      tools: u,
+      tools: c,
       inputVariables: {
         layerSummary: v(s),
         agents: T(l),
@@ -71,7 +71,7 @@ async function _(e, t) {
 }
 const C = (e, t) => x(["agentRegistry"], "Help Agent")(e, t);
 async function H(e, t) {
-  const r = new E(u, { handleToolErrors: !1 });
+  const r = new E(c, { handleToolErrors: !1 });
   try {
     const s = e.helpInternalState.toolCallMessage;
     if (!s)
@@ -102,7 +102,7 @@ async function H(e, t) {
     };
   }
 }
-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.
+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.
 
   _Example: “Tell me about this map”_  
   _Example: “List all layers in this map”_  
@@ -111,16 +111,16 @@ const b = () => new d(c).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"_`, V = {
   id: "help",
   name: "Help Agent",
   description: M,
   createGraph: b,
-  workspace: c
+  workspace: u
 };
 export {
   V 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/navigationGraph.js

@@ -1,5 +1,5 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { StateGraph as b, START as $, END as C } from "@langchain/langgraph/web";
+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";
@@ -29,7 +29,7 @@ const S = [
 ];
 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) ?? [], 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)}`
+    (p, b) => `${b + 1}. layerId=${p.id} | title=${p.title ?? ""} | name=${p.name ?? ""} | score=${p.score.toFixed(2)}`
   ).join(`
 `) : "", c = e.vectorSearchFieldResults?.length > 0 ? JSON.stringify(e.vectorSearchFieldResults, null, 2) : "", a = e.intent === "goToBookmark" && i.length ? `Available bookmarks:
 ${i.map((p) => `- ${p}`).join(`
@@ -126,7 +126,7 @@ async function J(e, t) {
     schema: n.schema
   })), l = s.map.bookmarks?.map((n) => n.name).filter(Boolean) ?? [], c = l.length ? `Available bookmarks:
 ${l.map((n) => `- ${n}`).join(`
-`)}` : "", a = {
+`)}` : "No bookmarks are available in this map.", a = {
     tools: g.map(({ name: n, description: m, schema: v }) => `${n}: ${m}, ${JSON.stringify(v)}`).join(`
 `),
     bookmarks: c,
@@ -226,7 +226,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 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(
+}, 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(
   "intentLLM",
   (t) => t.intent === "goToLayer" || t.intent === "goToFeatures" ? "vectorSearchLayers" : "agent",
   {

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.
 `;

package/dist/chunks/state.js

@@ -13,7 +13,7 @@ function u() {
 function i(r) {
   const n = [...new Set([...r].filter((t) => c.has(t)))];
   if (n.length !== 0)
-    throw new Error(`ADK custom state cannot define reserved runtime fields: ${n.join(", ")}.`);
+    throw new Error(`custom state cannot define reserved runtime fields: ${n.join(", ")}.`);
 }
 function f(r) {
   const n = Object.entries(r);

package/dist/chunks/utils2.js

@@ -1,11 +1,11 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { getClosestElement as i } from "@arcgis/toolkit/dom";
-import { g as r, a as o } from "./utils3.js";
+import { g as s, a as o } from "./utils3.js";
 function c(e, t) {
-  const s = r(e.el, e.referenceElement);
-  if (s)
-    return s;
-  const n = i(e.el, "arcgis-assistant"), a = r(e.el, n?.referenceElement);
+  const r = s(e.el, e.referenceElement);
+  if (r)
+    return r;
+  const n = i(e.el, "arcgis-assistant"), a = s(e.el, n?.referenceElement);
   if (a)
     return a;
   throw new Error(`${t}: Reference element not found`);
@@ -23,16 +23,16 @@ function g(e) {
   const t = i(e.el, "arcgis-assistant");
   if (t === void 0)
     throw new Error("arcgis-assistant-agent must be used within an arcgis-assistant element");
-  t.register({
+  return t.register({
     agent: e.agent,
     getContext: async () => await e.getContext?.() ?? e.context ?? {}
-  });
+  }), t;
 }
 function l(e) {
   const t = o(e.el, e.referenceElement);
   if (t)
     return t;
-  const s = i(e.el, "arcgis-assistant"), n = r(e.el, s?.referenceElement);
+  const r = i(e.el, "arcgis-assistant"), n = s(e.el, r?.referenceElement);
   return n || null;
 }
 function v(e) {

package/dist/components/arcgis-assistant/customElement.d.ts

@@ -277,6 +277,13 @@ export abstract class ArcgisAssistant extends LitElement {
    * ```
    */
   accessor referenceElement: ArcgisMap | string | null;
+  /**
+   * When `true`, assistant text responses render after completion instead of streaming progressively.
+   *
+   * @default false
+   * @since 5.1
+   */
+  accessor streamingDisabled: boolean;
   /**
    * Prompts to suggest to the end user on load. These are intended to help users understand which questions they can ask.
    * This property should be set to establish boundaries for the end user. As all agents have limitations and LLMs can