@arcgis/ai-components 5.2.0-next.77 → 5.2.0-next.78

package/dist/chunks/adapter.js

@@ -37,8 +37,8 @@ import { ToolNode as ze } from "@langchain/langgraph/prebuilt";
 import { clearFiltersTool as ke } from "../agents/tools/filter/clearFilters/adapter.js";
 import { resetMapTool as Ae } from "../agents/tools/filter/resetMap/adapter.js";
 import { setFeatureEffectTool as qe } from "../agents/tools/filter/setFeatureEffect/adapter.js";
-import { getAttributeTool as Me } from "../agents/tools/query/getAttribute/adapter.js";
-import { getStatisticsTool as Ne } from "../agents/tools/query/getStatistics/adapter.js";
+import { getAttributeTool as Ne } from "../agents/tools/query/getAttribute/adapter.js";
+import { getStatisticsTool as Me } from "../agents/tools/query/getStatistics/adapter.js";
 import { getTopFeaturesTool as De } from "../agents/tools/query/getTopFeatures/adapter.js";
 import { queryFeaturesTool as Le } from "../agents/tools/query/queryFeatures/adapter.js";
 import Ge from "@arcgis/core/WebLinkChart.js";
@@ -779,7 +779,7 @@ async function qr({
     return `Error applying size-age renderer: ${p instanceof Error ? p.message : String(p)}`;
   }
 }
-async function Mr({
+async function Nr({
   layerId: e,
   fields: t,
   colorSchemes: r,
@@ -795,19 +795,19 @@ async function Mr({
     theme: a
   });
 }
-const Nr = c.object({
+const Mr = c.object({
   layerId: c.string().describe("The id of the layer to apply the size-age renderer to"),
   fields: c.array(c.string()).describe("The field(s) to use for the size-age renderer (temporal data with size)"),
   colorSchemes: c.array(c.string()).optional().describe("Optional color scheme tags to use"),
   theme: c.enum(["above-and-below", "above", "below", "centered-on", "extremes", "high-to-low"]).optional().describe("Optional theme for the size ramp")
-}), qa = g(Mr, {
+}), qa = g(Nr, {
   name: "size-age",
   description: `Label: Age (size)
     Description: Vary symbol sizes along a continuous ramp to represent the age of features. Age reflects the length of time from a start date to an end date.
     Keywords: since, age, how old, how long
     Example: Change the size of features so older features are larger than new features.
     Fields: This style requires at least one field with a date type.`,
-  schema: Nr
+  schema: Mr
 });
 function Dr(e) {
   const { fields: t, layer: r, view: a } = e;
@@ -873,7 +873,7 @@ const Fr = c.object({
   fields: c.array(c.string()).describe("The field(s) to use for the size renderer (numeric data)"),
   colorSchemes: c.array(c.string()).optional().describe("Optional color scheme tags to use"),
   theme: c.enum(["above-and-below", "above", "below", "centered-on", "extremes", "high-to-low"]).optional().describe("Optional theme for the size ramp")
-}), Ma = g(jr, {
+}), Na = g(jr, {
   name: "size",
   description: `Label: Counts and Amounts (size)
     Description: Vary symbol sizes along a continuous ramp to represent numeric or ranked data.
@@ -955,7 +955,7 @@ const Kr = c.object({
   fields: c.array(c.string()).describe("The field(s) to use for the type renderer (categorical data)"),
   colorSchemes: c.array(c.string()).optional().describe("Optional color scheme tags to use"),
   theme: c.enum(["above-and-below", "above", "below", "centered-on", "extremes", "high-to-low"]).optional().describe("Optional theme for the color scheme")
-}), Na = g(Or, {
+}), Ma = g(Or, {
   name: "type",
   description: `Label: Types (unique symbols)
 Description: Represent features as categories with different symbol colors or shapes. Examples include type of tree, road class, or province name.
@@ -979,7 +979,7 @@ Fields: This style requires a single field which may be a string, number, or dat
     reducer: ee,
     default: () => []
   })
-}), Vr = [Me, Ne, De, Le], Ga = [qe, Ae, ke], Wr = new ze(Vr, { handleToolErrors: !1 });
+}), Vr = [Ne, Me, De, Le], Ga = [qe, Ae, ke], Wr = new ze(Vr, { handleToolErrors: !1 });
 async function ja(e, t) {
   const { messages: r } = await Wr.invoke({ messages: e.dataExplorationMessages }, t), a = [], o = [];
   for (const i of r) {
@@ -1046,10 +1046,10 @@ function W(e) {
     throw new Error("The Knowledge Agent currently only supports maps with exactly one Knowledge Graph Layer.");
 }
 function x(e) {
-  return !!e?.map && !("activeLinkChartLayer" in e.map);
+  return !!e?.map && "activeLinkChartLayer" in e.map;
 }
 async function j(e) {
-  !e || x(e) || !e.map?.diagramNodesExtent || await e.goTo(e.map.diagramNodesExtent);
+  !x(e) || !e.map.diagramNodesExtent || await e.goTo(e.map.diagramNodesExtent);
 }
 function q(e) {
   const r = e?.configurable?.context;
@@ -1067,9 +1067,9 @@ function Qa(e) {
   if (te(e) === "knowledgeGraph")
     return "knowledgeGraph";
   const o = r.view;
-  return x(o) ? (W(o), "map") : "linkChart";
+  return x(o) ? "linkChart" : (W(o), "map");
 }
-async function M(e) {
+async function N(e) {
   const r = e?.configurable?.context;
   if (te(e) === "knowledgeGraph")
     return r;
@@ -1591,7 +1591,7 @@ async function ie({
   includeReturnEntityAndRelationshipContext: a = !1
 }) {
   const o = [e];
-  if (a && o.push(ne), !x(t) && t.map) {
+  if (a && o.push(ne), x(t)) {
     const d = await L("arcgis_knowledge_current_lc_context"), u = ot(t.map, r);
     return o.push(d), {
       enhancedPrompt: o.join(`
@@ -1653,16 +1653,16 @@ async function ct(e, t, r, a, o, i) {
       text: `Query Results parsed into ${u.length} unique relationships and entities.  Atempting to add to link chart...`
     },
     i
-  ), !x(s) && s?.map ? (await s.map.addRecords(u), await j(s), { generatedQuery: l, explanation: p, addedIdTypePairs: u }) : (await s?.map?.allLayers.find(
+  ), x(s) ? (await s.map.addRecords(u), await j(s), { generatedQuery: l, explanation: p, addedIdTypePairs: u }) : (await s?.map?.allLayers.find(
     (f) => f.type === "knowledge-graph"
   )?.addRecords(u), { generatedQuery: l, explanation: p, addedIdTypePairs: u });
 }
-const N = "addRecords", pt = c.object({
+const M = "addRecords", pt = c.object({
   prompt: c.string().describe(
     "The user's inquiry and context required in order to generate a cypher query that will be used to add records to the link chart."
   )
 }), dt = async ({ prompt: e }, t) => {
-  const { knowledgeGraph: r } = await M(t), a = q(t), { view: o } = a, s = P.getDefault().helperServices, {
+  const { knowledgeGraph: r } = await N(t), a = q(t), { view: o } = a, s = P.getDefault().helperServices, {
     enhancedPrompt: n,
     bindParameters: l,
     allNamedTypesFullyDynamic: p
@@ -1674,7 +1674,7 @@ const N = "addRecords", pt = c.object({
   });
   if (p)
     return {
-      toolName: N,
+      toolName: M,
       status: "success",
       summary: "No records have been added to the map because all data in the knowledge graph is contained in the map.",
       details: {
@@ -1693,7 +1693,7 @@ const N = "addRecords", pt = c.object({
       t
     );
     return {
-      toolName: N,
+      toolName: M,
       status: "success",
       summary: `Records added successfully. Cypher Query used: ${d}
 
@@ -1707,14 +1707,14 @@ Number of records added: ${h.length}`,
   } catch (d) {
     const u = E(d);
     return {
-      toolName: N,
+      toolName: M,
       status: "error",
       errorMessage: `Failed to add records to the link chart. ${u}`,
       error: d
     };
   }
 }, Ia = g(dt, {
-  name: N,
+  name: M,
   description: `Adds records (entities or relationships) to the current link chart visualization from an inquiry into the knowledge graph data. The inquiry will retrieve data from the graph database that will serve as the basis for the records to be added to the link chart.  The user should have explicitly requested to add records to the current link chart from their prompt. "add to new link chart" is not a valid prompt for this tool. 
     
     example prompts:
@@ -1747,14 +1747,7 @@ const _ = "applyLayout", ht = c.object({
   )
 }), yt = async ({ layout: e }, t) => {
   const { view: r } = q(t);
-  if (x(r))
-    return {
-      toolName: _,
-      status: "error",
-      errorMessage: "The applyLayout tool can only be used with a LinkChartView.",
-      error: new Error()
-    };
-  {
+  if (x(r)) {
     const { appliedLayout: a } = await ut(e, r);
     return {
       toolName: _,
@@ -1764,7 +1757,13 @@ const _ = "applyLayout", ht = c.object({
         appliedLayout: a
       }
     };
-  }
+  } else
+    return {
+      toolName: _,
+      status: "error",
+      errorMessage: "The applyLayout tool can only be used with a LinkChartView.",
+      error: new Error()
+    };
 }, Oa = g(yt, {
   name: _,
   description: "Apply a diagram layout to the link chart",
@@ -1777,14 +1776,7 @@ const Q = "changeNonspatialVisibility", gt = c.object({
   setting: c.enum(["hidden", "visible"]).describe("The setting of nonspatial visibility")
 }), ft = async ({ setting: e }, t) => {
   const { view: r } = q(t);
-  if (x(r))
-    return {
-      toolName: Q,
-      status: "error",
-      errorMessage: "The changeNonspatialVisibility tool can only be used with a LinkChartView.",
-      error: new Error()
-    };
-  {
+  if (x(r)) {
     const { appliedNonspatialDataDisplayMode: a } = await mt(e, r);
     return {
       toolName: Q,
@@ -1794,7 +1786,13 @@ const Q = "changeNonspatialVisibility", gt = c.object({
         appliedNonspatialDataDisplayMode: a
       }
     };
-  }
+  } else
+    return {
+      toolName: Q,
+      status: "error",
+      errorMessage: "The changeNonspatialVisibility tool can only be used with a LinkChartView.",
+      error: new Error()
+    };
 }, Ka = g(ft, {
   name: Q,
   description: "Change whether or not nonspatial data is visible in the link chart.  The value must be either 'hidden' or 'visible'.",
@@ -1857,15 +1855,8 @@ const D = "createLinkChart", bt = c.object({
     "The user's inquiry and context required in order to generate a cypher query that will be used to create a link chart visualization. Only include information relevant to generating a cypher query. Do not suggest entity types, relationship types or properties. Do not include limits  or formatting instructions for the query results unless specifically requested by the user. The prompt should be focused on the data the user wants to see in the link chart, not how to generate it."
   )
 }), Tt = async ({ prompt: e }, t) => {
-  const { knowledgeGraph: r } = await M(t), { view: a } = q(t);
-  if (x(a))
-    return {
-      toolName: D,
-      status: "error",
-      errorMessage: "The createLinkChart tool can only be used with a LinkChartView.",
-      error: new Error()
-    };
-  {
+  const { knowledgeGraph: r } = await N(t), { view: a } = q(t);
+  if (x(a)) {
     const i = P.getDefault().helperServices, s = await wt(
       `${e}
 
@@ -1895,7 +1886,13 @@ Explanation: ${l}`,
         explanation: l
       }
     };
-  }
+  } else
+    return {
+      toolName: D,
+      status: "error",
+      errorMessage: "The createLinkChart tool can only be used with a LinkChartView.",
+      error: new Error()
+    };
 }, Va = g(Tt, {
   name: D,
   description: "Creates a new link chart visualization from an inquiry into the knowledge graph data. The inquiry will retrieve data from the graph database that will serve as the basis for the new link chart.  The user should have explicitly requested the creation of a new link chart from their prompt using language like 'create new link chart' or 'add to new link chart'.",
@@ -1905,7 +1902,7 @@ Explanation: ${l}`,
     "The user's inquiry into the knowledge graph, from which a cypher query will be generated and executed to answer the inquiry. Only include entity types, relationship types or properties if they are provided in the user prompt or prior steps. Do not suggest entity types, relationship types or properties. Do not include limits, information on what to return, instructions on how to write the query, or formatting instructions for the query results unless specifically requested by the user."
   )
 }), vt = async ({ prompt: e }, t) => {
-  const { knowledgeGraph: r } = await M(t), o = P.getDefault().helperServices;
+  const { knowledgeGraph: r } = await N(t), o = P.getDefault().helperServices;
   let i = e, s = null, n = null;
   try {
     ({ view: n } = q(t));
@@ -1982,7 +1979,7 @@ ${w.length > y ? `Showing top ${y} results:
 }), O = "generateCypher", Rt = c.object({
   prompt: c.string().describe("The user's inquiry into the knowledge graph that needs to be translated into a cypher query.")
 }), xt = async ({ prompt: e }, t) => {
-  const { knowledgeGraph: r } = await M(t), o = P.getDefault().helperServices;
+  const { knowledgeGraph: r } = await N(t), o = P.getDefault().helperServices;
   try {
     const { graphQuery: i, explanation: s } = await Xr(
       e,
@@ -2062,7 +2059,7 @@ const K = "searchGraphData", Pt = c.object({
     "The user's inquiry into the knowledge graph, from which a lucene search query will be generated and executed against the graph to return relevant results."
   )
 }), Et = async ({ prompt: e }, t) => {
-  const { knowledgeGraph: r } = await M(t);
+  const { knowledgeGraph: r } = await N(t);
   await T({ text: "Generating search query for the user inquiry" }, t);
   const a = await $t(e, r, t);
   await T({ text: "Executing graph search with generated search query" }, t);
@@ -2138,7 +2135,7 @@ export {
   Ia as e,
   Qa as f,
   L as g,
-  M as h,
+  N as h,
   _a as i,
   xa as j,
   Ca as k,
@@ -2153,8 +2150,8 @@ export {
   Ie as t,
   Aa as u,
   qa as v,
-  Ma as w,
-  Na as x,
+  Na as w,
+  Ma as x,
   Ga as y,
   Vr as z
 };

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,98 +28,115 @@ 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 n = r; n < e.length; n++) {
-      const l = e[n];
-      if (l === "{" ? a++ : l === "}" ? a-- : l === "[" ? c++ : l === "]" && 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 && n > r)
-        return e.slice(r, n + 1);
+      if (n === 0 && l === 0 && a > r)
+        return e.slice(r, a + 1);
     }
   }
   return null;
 }
-function O(e) {
+function z(e) {
   if (!e)
     return "";
   let t = e;
   const r = x(e);
   if (r)
     try {
-      const c = JSON.parse(r), l = `
+      const l = JSON.parse(r), c = `
 
 \`\`\`json
-${JSON.stringify(c, null, 2)}
+${JSON.stringify(l, null, 2)}
 \`\`\`
 
 `;
-      t = e.replace(r, l);
+      t = e.replace(r, c);
     } catch {
     }
-  const a = E(t);
-  return q(a);
+  const n = q(t);
+  return M(n);
 }
-function q(e) {
+function M(e) {
   if (!e)
     return "";
-  const t = M(e);
-  return T(t);
+  const t = E(e), r = k(t);
+  return T(r);
 }
-function E(e) {
+function q(e) {
   return e ? S.parse(e, { async: !1 }) : "";
 }
-function M(e) {
+function E(e) {
   if (!e || typeof DOMParser > "u")
     return e;
   try {
     const t = new DOMParser().parseFromString(e, "text/html");
-    return Array.from(t.querySelectorAll("table")).forEach((a, c) => {
-      const n = t.createElement("calcite-table");
-      n.setAttribute("caption", `Table ${c + 1}`), n.setAttribute("striped", "true");
-      const l = a.querySelector("thead");
-      if (l) {
-        const d = Array.from(l.querySelectorAll("tr"));
-        for (const u 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 f = Array.from(u.querySelectorAll("th, td"));
-          for (const h of f) {
-            const s = (h.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);
           }
-          n.appendChild(o);
+          a.appendChild(o);
         }
       }
-      const b = a.querySelector("tbody");
-      (b ? Array.from(b.querySelectorAll("tr")) : Array.from(a.querySelectorAll("tr")).filter((d) => !l?.contains(d))).forEach((d, u) => {
-        const o = t.createElement("calcite-table-row"), f = !l && u === 0 && d.querySelectorAll("th").length > 0;
-        f && o.setAttribute("slot", "table-header");
-        const h = Array.from(d.querySelectorAll("th, td"));
-        for (const s of h) {
-          if (f && 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);
         }
-        n.appendChild(o);
-      }), a.replaceWith(n);
+        a.appendChild(o);
+      }), n.replaceWith(a);
     }), t.body.innerHTML;
   } catch {
     return e;
   }
 }
 export {
-  q as a,
-  O as p
+  M as a,
+  z as p
 };

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

@@ -89,13 +89,35 @@ export abstract class ArcgisAssistant extends LitElement {
       assistantLabel: string;
       stopButtonLabel: string;
       askButtonLabel: string;
+      stoppedByUserLabel: string;
+      noAgentsFoundMessage: string;
+      orchestratorInitializationErrorMessage: string;
+      signInErrorMessage: string;
+      signInRequiredMessage: string;
+      signInLabel: string;
+      signInToArcGISOnlineLabel: string;
+      noPortalInformationMessage: string;
+      readMoreLabel: string;
+      learnAboutWebMapEmbeddingsLabel: string;
+      waitingForUserInputMessage: string;
   } & T9nMeta<{
       assistantLabel: string;
       stopButtonLabel: string;
       askButtonLabel: string;
+      stoppedByUserLabel: string;
+      noAgentsFoundMessage: string;
+      orchestratorInitializationErrorMessage: string;
+      signInErrorMessage: string;
+      signInRequiredMessage: string;
+      signInLabel: string;
+      signInToArcGISOnlineLabel: string;
+      noPortalInformationMessage: string;
+      readMoreLabel: string;
+      learnAboutWebMapEmbeddingsLabel: string;
+      waitingForUserInputMessage: string;
   }>;
   /**
-   * When `true`, disables the assistant avatar in the chat interface.
+   * When `true`, displays the assistant avatar in the chat interface.
    *
    * @default false
    * @since 5.1
@@ -310,6 +332,13 @@ export abstract class ArcgisAssistant extends LitElement {
    * ```
    */
   accessor suggestedPrompts: string[];
+  /**
+   * When `true`, displays the user avatar in the chat interface.
+   *
+   * @default false
+   * @since 5.2
+   */
+  accessor userAvatarEnabled: boolean;
   /**
    * Cancels the active interrupt, if one is pending.
    *