@arcgis/ai-components 5.1.0-next.13 → 5.1.0-next.130

package/dist/chunks/summarize_query_response_prompt.js

@@ -0,0 +1,80 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
+const e = `## Task: Summarize Geographic Features
+
+You are given features from ArcGIS Feature layer for multiple layers:  
+{queryResponse}
+
+## Input
+
+Assigned task:
+{assignedTask}
+
+Latest user request:
+{userRequest}
+
+Prior steps:
+{priorSteps}
+
+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 clearly depends on earlier results.
+Use chat history only when necessary to understand conversational references, and do not override the assigned task.
+
+### Your goal:
+
+1. If the assigned task is about a **specific calculation** (e.g., average, total, count, min, max), return a **single concise sentence** that includes the numeric result.
+
+- Example: “The average price is $4.00.”
+- Never return a bare number by itself (for example: \`4\`).
+- When a value is already present in \`queryResponse\` (for example in \`details.value\` or \`summary\`), copy that value **verbatim**.
+- Do NOT reformat values (including numbers, dates, and times):
+  - Do not add/remove grouping commas.
+  - Do not change decimals, round values, or change numeric type/text.
+  - Do not change date/time format, timezone notation, separators, or precision.
+
+2. If the question is more general or there are **multiple features with varying attributes**, write a **brief summary** (2–3 sentences max) that highlights key patterns or insights.
+
+3. The response can be per layer, or summarize based on the question.
+
+4. DO NOT ramble.
+
+5. If a \`geometryFilter\` is used, do NOT assume the feature referenced in that geometry (e.g., "ApplicationNumber = 'XYZ'") must appear in the results. It may only be used as a spatial anchor.
+
+Only describe what _was_ found — not what was _used to search_.
+
+6. If no feature \`attributes\` are returned but \`totalCount\` is present, assume the spatial filter was applied correctly. There is no need to say the subset was not returned — just summarize based on the count and available context.
+
+7. Do not give suggestions like exporting the results as the tools are not capable to do that.
+
+8. Format all responses using **Markdown** suitable for chat display.
+
+- Use bullet points for lists and use new lines (\\n) and appropriate formatting in your response.
+- Use Markdown emphasis (for example, **bold**) only when it improves clarity; keep formatting minimal and readable.
+- If results are best presented in rows/columns (for example, multiple features sharing the same fields), format them as a **Markdown table**.
+- The table must be valid Markdown with a header row and separator row (e.g., \`| Column |\` and \`| --- |\`).
+- Do not use plain aligned text, CSV-like output, or code fences for tabular data.
+
+9. Do NOT say things like "I can't change the map", "I can't highlight features", or suggest WHERE clauses for the user to run manually. A separate system handles map visualization automatically after this step. Your job is ONLY to summarize the data returned by the query.
+
+In all cases:
+
+- Focus on **notable attribute values**, **commonalities or differences**, and **interesting trends**.
+- If the feature list is empty or not meaningful, state that clearly.
+- Only use fields present in query results. Do not make guesses.
+
+### STRICT OUTPUT RULES
+
+- Do NOT ask follow-up questions.
+- Do NOT offer additional actions or suggestions.
+- Do NOT explain what you can do next.
+- Do NOT add conversational phrases.
+- Do NOT add any text beyond the requested summary or numeric answer.
+- 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.
+- When presenting tabular data, output a valid Markdown table.
+`;
+export {
+  e as default
+};

package/dist/chunks/toolCallResponse.js

@@ -0,0 +1,29 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
+import "@arcgis/core/identity/IdentityManager.js";
+import "@arcgis/core/portal/Portal.js";
+import "@langchain/langgraph/web";
+import { s as r } from "./generateLayerDescriptions.js";
+import "@langchain/core/messages";
+import "@langchain/openai";
+import "@arcgis/core/core/reactiveUtils.js";
+import "@arcgis/core/layers/FeatureLayer.js";
+import "@arcgis/core/request.js";
+import "@langchain/core/prompts";
+const u = async (t, o) => {
+  const a = t.tool_calls ?? [];
+  if (a.length === 0) {
+    await r({ text: `LLM did not request any tool calls: ${String(t?.content)}` }, o);
+    return;
+  }
+  await Promise.all(
+    a.map(
+      async (i) => await r(
+        { text: `LLM invoked ${i.name} tool with arguments: ${JSON.stringify(i.args, null, 2)}` },
+        o
+      )
+    )
+  );
+};
+export {
+  u as h
+};

package/dist/chunks/utils.js

@@ -1,31 +1,53 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import { getClosestElement as a } from "@arcgis/toolkit/dom";
-import { g as i } from "./utils2.js";
-function o(e, t) {
-  const s = i(e.el, e.referenceElement);
-  if (s)
-    return s;
-  const n = a(e.el, "arcgis-assistant"), r = i(e.el, n?.referenceElement);
-  if (r)
-    return r;
-  throw new Error(`${t}: Reference element not found`);
+import { AIMessage as i } from "@langchain/core/messages";
+function p(e, s, t) {
+  return {
+    ...e,
+    status: s,
+    summary: t
+  };
 }
-function f(e, t) {
-  const n = o(e, t).view;
-  if (!n)
-    throw new Error(`${t}: Reference element does not have a view`);
-  return n;
+function f(e) {
+  const s = Object.entries(e).filter(
+    ([t, n]) => t !== "agentExecutionContext" && t !== "outputMessage" && t !== "summary" && t !== "status" && n !== void 0
+  );
+  if (s.length !== 0)
+    try {
+      return JSON.stringify(Object.fromEntries(s), null, 2);
+    } catch {
+      return;
+    }
 }
-function m(e) {
-  const t = a(e.el, "arcgis-assistant");
-  if (t === void 0)
-    throw new Error("arcgis-assistant-agent must be used within an arcgis-assistant element");
-  t.register({
-    agent: e.agent,
-    getContext: () => e.getContext?.() ?? e.context ?? {}
-  });
+function m(e, s, t = []) {
+  const n = s.safeParse(e);
+  if (n.success) {
+    const a = { ...n.data }, r = f(a), o = r ?? "LLMAgent produced structured output.", u = r ?? a.outputMessage, c = {
+      ...a,
+      ...u ? { outputMessage: u } : {},
+      agentExecutionContext: {
+        messages: [
+          ...t,
+          new i(typeof u == "string" && u.trim() ? u : o)
+        ]
+      }
+    };
+    return p(c, "success", o);
+  } else
+    throw new Error(`LLMAgent output schema validation failed: ${n.error.message}`);
+}
+function l(e, s) {
+  const t = {
+    outputMessage: e.outputMessage
+  };
+  if (s) {
+    const n = s.shape, a = e;
+    for (const r of Object.keys(n ?? {}))
+      r in e && (t[r] = a[r]);
+  }
+  return t;
 }
 export {
-  m as i,
-  f as r
+  p as c,
+  l as g,
+  m as h
 };

package/dist/chunks/utils2.js

@@ -1,8 +1,47 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import { getClosestElement as o } from "@arcgis/toolkit/dom";
-function u(r, t) {
-  return t ? typeof t == "string" ? document.querySelector(t) : t : o(r, "arcgis-map") ?? null;
+import { getClosestElement as i } from "@arcgis/toolkit/dom";
+import { g as r, 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);
+  if (a)
+    return a;
+  throw new Error(`${t}: Reference element not found`);
+}
+function m(e, t) {
+  const n = c(e, t).view;
+  if (!n)
+    throw new Error(`${t}: Reference element does not have a view`);
+  return n;
+}
+function w(e) {
+  return typeof e == "function";
+}
+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({
+    agent: e.agent,
+    getContext: async () => await e.getContext?.() ?? e.context ?? {}
+  });
+}
+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);
+  return n || null;
+}
+function v(e) {
+  const t = l(e);
+  return t ? t.view : null;
 }
 export {
-  u as g
+  g as a,
+  v as b,
+  w as i,
+  m as r
 };

package/dist/chunks/utils3.js

@@ -0,0 +1,16 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
+import { getClosestElement as s } from "@arcgis/toolkit/dom";
+function l(t, o) {
+  return o ? typeof o == "string" ? u(t, o) ?? null : o : s(t, "arcgis-map") ?? null;
+}
+function n(t, o) {
+  return o ? typeof o == "string" ? u(t, o) ?? null : o : s(t, "arcgis-link-chart") ?? s(t, "arcgis-map") ?? null;
+}
+function u(t, o) {
+  const r = o.includes("#") || o.includes(".") || o.includes("["), i = t.getRootNode();
+  return (r ? void 0 : i.querySelector(`#${o}`)) ?? i.querySelector(o) ?? void 0;
+}
+export {
+  n as a,
+  l as g
+};