@arcgis/ai-components 5.2.0-next.12 → 5.2.0-next.121

package/dist/chunks/arcgis_knowledge_summarize_result_prompt.js

@@ -1,48 +1,137 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-const e = `## ArcgisKnowledge Agent - Action Summary
+const n = `# ArcGIS Knowledge Agent — Action Summary
 
-You are a helpful Knowledge Graph assistant agent that has received a user inquiry and performed some tool call actions to answer their question or perform the desired operation.
+You are a Knowledge Graph assistant that has executed tool calls to answer a user request.
 
-The knowledge graph you are working with has the following data model:
+## Context
 
+**Data model**
 {dataModelSummary}
 
-## User Input:
-
-Assigned task:
+**Assigned task**
 {assignedTask}
 
-Latest user request:
+**User request**
 {userRequest}
 
-## Tool Call Result:
-
+**Tool result**
 {toolResult}
 
-## Your Goal:
+---
+
+## Goal
+
+Generate a concise, complete Markdown response using the tool results.
+
+---
+
+## Priority Rules (Strict Order)
+
+### 1. User Formatting Override (Highest Priority)
+
+- If the user specifies a format (table, list, bullets, etc.):
+  - Use that format exactly
+  - Ignore ALL default formatting rules below
+  - Do NOT add summaries or extra sections unless requested
+
+---
+
+### 2. Default Output (When no override)
+
+Produce:
+
+- **Summary**: 1–2 sentences (no header, no bullets)
+- **Results**: Minimal, well-formatted data
+- **Note (optional)**:
+  - 1–2 italicized sentences describing tool limitations
+
+#### Limits
+
+- maxPreviewItems: 5
+
+---
+
+### 3. Output Constraints (Non-Negotiable)
+
+- Output **valid Markdown only** (no JSON)
+- Do NOT hallucinate data (entities, fields, counts, relationships)
+- Do NOT include:
+  - reasoning
+  - classification labels
+  - follow-up questions
+  - next steps
+  - intro phrases (“Here are…”)
+  - restating the question
+- End immediately after the response
+
+---
+
+### 4. Data Handling Rules
+
+- If results are empty → clearly state no results returned
+- If insufficient data → state limitation, do NOT speculate
+- Do NOT output:
+  - raw nested objects
+  - large arrays
+  - geometry
+- Summarize complex structures
+- Truncate long values with \`…\`
+- Show entities/relationships only once
+- Use:
+  - “entity” (not node)
+  - “relationship” (not edge)
+- Hide \`globalid\` and \`objectid\` unless explicitly requested
+
+---
+
+### 5. Formatting Rules (Default Mode Only)
+
+- No headers; use _italic labels_ if needed
+- Use:
+  - bullets → single item summaries
+  - tables → multiple results (limit to 5 rows)
+- Reduce columns to key fields only
+- Format:
+  - dates → “day month year”
+  - time separate from date
+
+---
+
+### 6. Result-Type Formatting
+
+**SEARCH_HITS**
+
+- Highlight top match (bullets)
+- Table for remaining results
+
+**ENTITIES**
+
+- Group by type (if multiple)
+- Show key properties only
+
+**RELATIONSHIPS**
+
+- Format: \`(entity) —[relationship]→ (entity)\`
+
+**PATHS**
+
+- Summary + 1-3 examples
+
+---
 
-Based on the user request and tool call result above, generate a concise response that answers their question fully.
+## Internal Processing (Do NOT output)
 
-If the above tool calls do not provide the information required to answer the users question, state this, and do not speculate.
+Classify results into:
 
-The general format for the summary should be (paragraphs of content separated by new lines, not bullet points):
+- SEARCH_HITS, ENTITIES, RELATIONSHIPS, PATHS
 
-- A short, easy to read summary of the results and answer to the users inquiry, in the form of a concise 1-3 sentence summary. This can include the tool called and a brief summary of its settings. For multiple or complex settings (e.g. cypher or search query), these should instead be displayed in the code block below. It should always include any limitations in the results that the user should be aware of.
-- _Optional_ - Code block containing tool settings / query or search used etc for tool calls with multiple or complex settings
-- _Optional_ - Markdown table of query or search results preview if these tools were used, and this is appropriate to answer the user's question. Ensure long property values are truncated to short lengths (20 chars) in the table if not directly relevant to the user's query. Do not re-order data in the table. If a query or search of graph data was done, this should be displayed.
-- _Important_ If the summary or markdown table was generated based on data where only a limited preview of the full results of e.g. a search/query was available, indicate this at the end of the summary in a separate paragraph in italics, along the lines of 'NOTE: This summary was generated from a limited preview of the search / query results, and may not be accurate.'
+## Failure Handling
 
-### STRICT OUTPUT RULES
+- If data is insufficient → clearly state limitation
+- Never infer or fabricate missing information
 
-- Do NOT ask follow-up questions.
-- Do NOT offer additional actions or suggestions.
-- Do NOT explain what you can do next.
-- End the response immediately after the summary.
-- Do NOT include introductory phrases (e.g., "Found", "Here are", "The results show").
-- Do NOT restate the assigned task or user’s question.
-- Use Markdown formatting for the response, formatting in a way that makes the summary easy to read.
-- When presenting tabular data, output a valid Markdown table.
+---
 `;
 export {
-  e as default
+  n as default
 };

package/dist/chunks/baseAgentState.js

@@ -0,0 +1,59 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { Annotation as r } from "@langchain/langgraph/web";
+const a = (e, t) => t, c = (e, t) => ({
+  ...e,
+  ...t
+}), o = (e = "", t) => {
+  const s = typeof t == "string" ? t.trim() : "";
+  if (!s)
+    return e;
+  const n = e.trim();
+  if (!n)
+    return s;
+  if (n === s)
+    return e;
+  const u = n.split(`
+
+`);
+  return u[u.length - 1]?.trim() === s ? e : `${e}
+
+${s}`;
+}, i = () => ({
+  userRequest: "",
+  inputParts: [],
+  assignedTask: "",
+  messages: [],
+  priorSteps: [],
+  sharedState: {},
+  sharedResources: []
+}), d = () => ({
+  agentExecutionContext: r({
+    reducer: c,
+    default: i
+  }),
+  outputMessage: r({
+    reducer: o,
+    default: () => ""
+  }),
+  summary: r({
+    reducer: a,
+    default: () => ""
+  }),
+  status: r({
+    reducer: a
+  }),
+  sharedStatePatch: r({
+    reducer: a
+  }),
+  sharedResourceAdditions: r({
+    reducer: a
+  })
+}), g = () => d();
+export {
+  d as a,
+  o as b,
+  i as c,
+  g as d,
+  c as m,
+  a as r
+};

package/dist/chunks/converterUtils.js

@@ -1,12 +1,12 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import g from "@esri/arcgis-html-sanitizer";
+import w from "@esri/arcgis-html-sanitizer";
 import { marked as S } from "marked";
 S.use({
   gfm: !0,
   breaks: !0,
   async: !1
 });
-const C = new g(
+const C = new w(
   {
     whiteList: {
       // LLMs sometimes return lists like "- 2) Foo". `marked` parses that into a nested ordered list
@@ -17,6 +17,7 @@ const C = new g(
       "calcite-table-row": ["slot", "class"],
       "calcite-table-header": ["heading", "alignment", "description", "class"],
       "calcite-table-cell": ["alignment", "colspan", "rowspan", "class"],
+      "calcite-link": ["href", "target", "rel", "title"],
       // Allow markdown code blocks to render as <pre><code>…</code></pre>.
       pre: ["class"],
       code: ["class"]
@@ -27,44 +28,67 @@ const C = new g(
 function T(e) {
   return C.sanitize(e);
 }
+function k(e) {
+  if (!e || typeof DOMParser > "u")
+    return e;
+  try {
+    const t = new DOMParser().parseFromString(e, "text/html");
+    return t.querySelectorAll("a").forEach((r) => {
+      const n = t.createElement("calcite-link");
+      for (const l of ["href", "target", "rel", "title"]) {
+        const a = r.getAttribute(l);
+        a !== null && n.setAttribute(l, a);
+      }
+      n.append(...r.childNodes), r.replaceWith(n);
+    }), t.body.innerHTML;
+  } catch {
+    return e;
+  }
+}
 function A(e, t) {
-  const r = e.indexOf("{", t), a = e.indexOf("[", t);
-  return r === -1 ? a : a === -1 ? r : Math.min(r, a);
+  const r = e.indexOf("{", t), n = e.indexOf("[", t);
+  return r === -1 ? n : n === -1 ? r : Math.min(r, n);
 }
 function x(e) {
   if (e.trimStart().startsWith("```"))
     return null;
   for (let r = A(e, 0); r !== -1; r = A(e, r + 1)) {
-    let a = 0, c = 0;
-    for (let l = r; l < e.length; l++) {
-      const n = e[l];
-      if (n === "{" ? a++ : n === "}" ? a-- : n === "[" ? c++ : n === "]" && c--, a < 0 || c < 0)
+    let n = 0, l = 0;
+    for (let a = r; a < e.length; a++) {
+      const c = e[a];
+      if (c === "{" ? n++ : c === "}" ? n-- : c === "[" ? l++ : c === "]" && l--, n < 0 || l < 0)
         break;
-      if (a === 0 && c === 0 && l > r)
-        return e.slice(r, l + 1);
+      if (n === 0 && l === 0 && a > r)
+        return e.slice(r, a + 1);
     }
   }
   return null;
 }
-function H(e) {
+function z(e) {
   if (!e)
     return "";
   let t = e;
   const r = x(e);
   if (r)
     try {
-      const l = JSON.parse(r), f = `
+      const l = JSON.parse(r), c = `
 
 \`\`\`json
 ${JSON.stringify(l, null, 2)}
 \`\`\`
 
 `;
-      t = e.replace(r, f);
+      t = e.replace(r, c);
     } catch {
     }
-  const a = q(t), c = E(a);
-  return T(c);
+  const n = q(t);
+  return M(n);
+}
+function M(e) {
+  if (!e)
+    return "";
+  const t = E(e), r = k(t);
+  return T(r);
 }
 function q(e) {
   return e ? S.parse(e, { async: !1 }) : "";
@@ -74,44 +98,45 @@ function E(e) {
     return e;
   try {
     const t = new DOMParser().parseFromString(e, "text/html");
-    return Array.from(t.querySelectorAll("table")).forEach((a, c) => {
-      const l = t.createElement("calcite-table");
-      l.setAttribute("caption", `Table ${c + 1}`), l.setAttribute("striped", "true");
-      const n = a.querySelector("thead");
-      if (n) {
-        const d = Array.from(n.querySelectorAll("tr"));
-        for (const h of d) {
+    return Array.from(t.querySelectorAll("table")).forEach((n, l) => {
+      const a = t.createElement("calcite-table");
+      a.setAttribute("caption", `Table ${l + 1}`), a.setAttribute("striped", "true");
+      const c = n.querySelector("thead");
+      if (c) {
+        const f = Array.from(c.querySelectorAll("tr"));
+        for (const u of f) {
           const o = t.createElement("calcite-table-row");
           o.setAttribute("slot", "table-header");
-          const u = Array.from(h.querySelectorAll("th, td"));
-          for (const b of u) {
-            const s = (b.textContent ?? "").trim(), i = t.createElement("calcite-table-header");
-            i.setAttribute("heading", s), o.appendChild(i);
+          const d = Array.from(u.querySelectorAll("th, td"));
+          for (const h of d) {
+            const i = (h.textContent ?? "").trim(), s = t.createElement("calcite-table-header");
+            s.setAttribute("heading", i), o.appendChild(s);
           }
-          l.appendChild(o);
+          a.appendChild(o);
         }
       }
-      const f = a.querySelector("tbody");
-      (f ? Array.from(f.querySelectorAll("tr")) : Array.from(a.querySelectorAll("tr")).filter((d) => !n?.contains(d))).forEach((d, h) => {
-        const o = t.createElement("calcite-table-row"), u = !n && h === 0 && d.querySelectorAll("th").length > 0;
-        u && o.setAttribute("slot", "table-header");
-        const b = Array.from(d.querySelectorAll("th, td"));
-        for (const s of b) {
-          if (u && s.localName === "th") {
-            const w = (s.textContent ?? "").trim(), y = t.createElement("calcite-table-header");
-            y.setAttribute("heading", w), o.appendChild(y);
+      const b = n.querySelector("tbody");
+      (b ? Array.from(b.querySelectorAll("tr")) : Array.from(n.querySelectorAll("tr")).filter((f) => !c?.contains(f))).forEach((f, u) => {
+        const o = t.createElement("calcite-table-row"), d = !c && u === 0 && f.querySelectorAll("th").length > 0;
+        d && o.setAttribute("slot", "table-header");
+        const h = Array.from(f.querySelectorAll("th, td"));
+        for (const i of h) {
+          if (d && i.localName === "th") {
+            const g = (i.textContent ?? "").trim(), y = t.createElement("calcite-table-header");
+            y.setAttribute("heading", g), o.appendChild(y);
             return;
           }
-          const i = t.createElement("calcite-table-cell"), p = s.getAttribute("colspan"), m = s.getAttribute("rowspan");
-          p && i.setAttribute("colspan", p), m && i.setAttribute("rowspan", m), i.innerHTML = s.innerHTML, o.appendChild(i);
+          const s = t.createElement("calcite-table-cell"), p = i.getAttribute("colspan"), m = i.getAttribute("rowspan");
+          p && s.setAttribute("colspan", p), m && s.setAttribute("rowspan", m), s.innerHTML = i.innerHTML, o.appendChild(s);
         }
-        l.appendChild(o);
-      }), a.replaceWith(l);
+        a.appendChild(o);
+      }), n.replaceWith(a);
     }), t.body.innerHTML;
   } catch {
     return e;
   }
 }
 export {
-  H as p
+  M as a,
+  z as p
 };

package/dist/chunks/dataExplorationAgent.js

@@ -0,0 +1,17 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { createSkillAgent as e } from "../agents/runtime/skill/createSkillAgent.js";
+const t = [
+  async () => (await import("./SKILL.js")).default,
+  async () => (await import("./SKILL2.js")).default
+], s = e({
+  id: "data-exploration",
+  name: "Data Exploration Agent",
+  description: "Explores feature-layer data and applies data-driven map filters using on-demand query and filter skills.",
+  skillLoaders: t,
+  modelTier: "default",
+  systemPrompt: "You are an ArcGIS data exploration agent.",
+  instructions: "Answer only questions about the current map's layers, features, fields, spatial relationships, or supported map actions, using returned tool results. Do not answer unrelated general-knowledge, advice, opinion, political, health, security, or other non-map requests, even when the user asks for this agent. For an unsupported request, respond only: 'I can help with questions about the data and features in this map.' Report directly relevant findings, requested calculations, and limitations that affect the answer. Do not provide unsolicited advice about dataset design, publishing, classification, grouping, future analysis, or alternative questions. Ask a clarifying question only when a map-related request cannot be answered reliably as written. A request can require both query and filter skills. Treat show, display, highlight, map, filter, reveal, emphasize, include, or exclude as visual map intent when the request targets matching features. For visual map intent, do not stop after query. First use query to identify/count the matching features, then load the filter skill and call setFeatureEffect with the same layer, where clause, geometry filter, extent setting, or object IDs. Use only tool results to describe data or map changes."
+});
+export {
+  s as D
+};

package/dist/chunks/data_explore_query_prompt.js

@@ -39,10 +39,13 @@ Prior steps:
 Last navigated features from shared state (if available):
 {lastNavigatedFeatures}
 
+Last resolved location from shared state (if available):
+{lastResolvedLocation}
+
 Use the assigned task as the primary instruction for the current query.
 Use the latest user request as supporting context when needed.
 Use prior steps only when the assigned task or user request clearly depends on earlier results.
-Use lastNavigatedFeatures as authoritative context for map-navigation references when present.
+Use shared-state context (\`lastResolvedLocation\`, \`lastNavigatedFeatures\`) for referential follow-ups when relevant.
 Use chat history only when necessary to understand conversational references, and do not override the assigned task.
 
 ### Anchor selection rule (strict, single source of truth)
@@ -50,8 +53,9 @@ Use chat history only when necessary to understand conversational references, an
 When the request is referential (for example: "this", "it", "that", "those", "them", "of those", "the same one(s)"), choose exactly one anchor using this priority order:
 
 1. Explicit entity named in the current request (if present)
-2. \`lastNavigatedFeatures\` (if present)
-3. The immediately previous successful relevant step from \`priorSteps\`
+2. \`lastResolvedLocation\` (if present and the request refers to a place/location)
+3. \`lastNavigatedFeatures\` (if present)
+4. The immediately previous successful relevant step from \`priorSteps\`
 
 After selecting the anchor, keep that anchor for this query and do not switch to an older entity.
 If \`lastNavigatedFeatures\` is used as the anchor, reuse its \`layerId\` and \`where\` for query scope unless the current request explicitly overrides it.
@@ -78,7 +82,8 @@ Start with a fresh WHERE clause for each new question. Do not inherit filters fr
 
 This is an exception to the "fresh WHERE clause" rule above.
 
-- If the anchored context indicates \`useCurrentExtent: true\`, use \`useCurrentExtent: true\` with \`where: "1=1"\`.
+- If the anchored context is \`lastResolvedLocation\` with a point, prefer \`geometryFilter.point\` and use \`where: "1=1"\` unless the user asked for additional attribute filters.
+- Only use \`useCurrentExtent: true\` when the user explicitly asks about the current view/map extent (for example: "in my view", "on my map", "visible now").
 - If the anchored context includes specific feature IDs/objectIds, scope to those IDs.
 - Otherwise, use the anchored \`layerId\` + \`where\` combination.
 

package/dist/chunks/fetchAgentContext.js

@@ -0,0 +1,13 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+function c(e, o) {
+  const t = e?.configurable?.context;
+  if (!t || typeof t != "object")
+    throw new Error("Agent context missing");
+  const n = o.filter((i) => !(i in t));
+  if (n.length)
+    throw new Error(`Agent context missing: ${n.join(", ")}`);
+  return t;
+}
+export {
+  c as f
+};

package/dist/chunks/fetchService.js

@@ -0,0 +1,10 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+const i = (s, e) => {
+  const r = s?.configurable?.services?.[e];
+  if (r == null)
+    throw new Error(`${e} missing in config.configurable.services`);
+  return r;
+};
+export {
+  i as f
+};

package/dist/chunks/fieldStatistics.js

@@ -0,0 +1,79 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import v from "@arcgis/core/smartMapping/statistics/summaryStatistics.js";
+import L from "@arcgis/core/smartMapping/statistics/uniqueValues.js";
+const $ = 10, b = ["string", "small-integer", "integer"], w = async (u, e, { includeSummaryStatistics: d = !0, includeUniqueValues: y = !0 } = {}) => {
+  let r = null, s = null;
+  try {
+    if (e.type !== "geometry" && e.type !== "oid" && e.type !== "global-id") {
+      d && (r = await v({ layer: u, field: e.name }));
+      const i = e.domain?.type === "coded-value" ? e.domain : null;
+      y && (b.includes(e.type) || i) && (s = (await L({ layer: u, field: e.name })).uniqueValueInfos.sort((n, f) => f.count - n.count).slice(0, $), i && (s = s.map((n) => ({
+        ...n,
+        value: i.getName(n.value) ?? n.value
+      }))));
+    }
+  } catch (i) {
+    console.error(`Error fetching statistics for field ${e.name}:`, i);
+  }
+  return {
+    summaryStatistics: r,
+    uniqueValues: s
+  };
+};
+function N(u, e) {
+  return ["string", "small-integer", "integer"].includes(u) || e === "coded-value";
+}
+async function x(u, e, d, y = !0) {
+  const r = [], s = [], i = [];
+  for (const n of u) {
+    let f = function(a) {
+      const t = e.get(a)?.layerItem;
+      return t ? [
+        t.name && `Name: ${t.name}`,
+        t.title && `Title: ${t.title}`,
+        t.description && `Description: ${t.description}`
+      ].filter(Boolean).join(" | ") : a;
+    };
+    const { layerId: c, results: q } = n, I = d.map?.allLayers.find((a) => a.id === c), S = e.get(c)?.fieldRegistry;
+    if (!S)
+      continue;
+    let l = r.find((a) => a.layerId === c);
+    l || (l = {
+      layerId: c,
+      layerSummary: f(c),
+      fieldInfos: []
+    }, r.push(l));
+    for (const a of q) {
+      const t = S.get(a.name);
+      if (!t)
+        continue;
+      const o = t.statistics, p = y && !o?.summaryStatistics, g = N(t.type, t.domain?.type) && !o?.uniqueValues, h = p || g;
+      if (i.push({
+        layerId: c,
+        fieldName: t.name,
+        didFetchStatistics: h
+      }), h) {
+        const F = w(I, t, {
+          includeSummaryStatistics: p,
+          includeUniqueValues: g
+        }).then((V) => {
+          const m = {
+            summaryStatistics: o?.summaryStatistics ?? null,
+            uniqueValues: o?.uniqueValues ?? null
+          };
+          p && (m.summaryStatistics = V.summaryStatistics), g && (m.uniqueValues = V.uniqueValues), S.set(t.name, { ...t, statistics: m }), t.statistics = m;
+        });
+        s.push(F);
+      }
+      l.fieldInfos.push(t);
+    }
+  }
+  return await Promise.all(s), {
+    layerFieldInfo: r,
+    didFetchStatistics: s.length > 0,
+    fieldStatisticsFetchStatus: i
+  };
+}
+export {
+  x as b
+};