@arcgis/ai-components 5.1.0-next.127 → 5.1.0-next.129

package/dist/chunks/arcgisKnowledgeGraph.js

@@ -1,130 +1,147 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import { StateGraph as w, START as y, END as h } from "@langchain/langgraph/web";
-import { a as f, c as x, b as k, d as _, e as b, s as K, q as v, g as p, h as A, t as g, r as M, i as S, G as T, j as u } from "./adapter.js";
+import { StateGraph as y, START as f, END as h, Command as x } from "@langchain/langgraph/web";
+import { a as k, c as _, b, d as K, e as A, s as v, q as M, g as u, h as S, t as c, r as T, i as q, G as C, j as m } from "./adapter.js";
 import "@arcgis/core/identity/IdentityManager.js";
 import "@arcgis/core/portal/Portal.js";
-import { j as q, s as c, h as C } from "./generateLayerDescriptions.js";
-import { AIMessage as E } from "@langchain/core/messages";
+import { j as E, s as p, h as G } from "./generateLayerDescriptions.js";
+import { AIMessage as R } from "@langchain/core/messages";
 import "@langchain/core/callbacks/dispatch/web";
 import "@langchain/openai";
 import "@arcgis/core/core/reactiveUtils.js";
 import "@arcgis/core/layers/FeatureLayer.js";
 import "@arcgis/core/request.js";
-import { ToolNode as G } from "@langchain/langgraph/prebuilt";
+import { ToolNode as N } from "@langchain/langgraph/prebuilt";
 import "@langchain/core/prompts";
-const m = [
-  f,
-  x,
+const w = [
   k,
   _,
   b,
   K,
-  v
+  A,
+  v,
+  M
 ];
-async function R(e, o) {
-  const l = await p("arcgis_knowledge_tool_prompt"), a = A(o), r = {
+async function L(e, a) {
+  const i = await u("arcgis_knowledge_tool_prompt"), o = S(a), r = {
     assignedTask: e.agentExecutionContext.assignedTask,
     userRequest: e.agentExecutionContext.userRequest,
     priorSteps: e.agentExecutionContext.priorSteps,
-    contextType: a
-  }, n = await q({
-    promptText: l,
+    contextType: o
+  }, s = await E({
+    promptText: i,
     messages: e.arcgisKnowledgeMessages,
     inputVariables: r,
-    tools: m
-  }), t = (n.tool_calls?.length ?? 0) > 0, s = typeof n.text == "string" ? n.text.trim() : "", i = s.length > 0, d = n.content.toString();
-  return !t && (a === "map" || a === "knowledgeGraph") ? {
+    tools: w
+  }), t = (s.tool_calls?.length ?? 0) > 0, n = typeof s.text == "string" ? s.text.trim() : "", l = n.length > 0, d = s.content.toString();
+  return !t && (o === "map" || o === "knowledgeGraph") ? {
     ...e,
-    arcgisKnowledgeMessages: [...e.arcgisKnowledgeMessages, n],
-    outputMessage: a === "map" ? "No tools were found for the current view and prompt. Maps do not support changing nonspatial visibility, layout changes, or generation from queries." : "No tools were found for the current prompt and knowledge graph service. A knowledge graph service only supports search and query.",
+    arcgisKnowledgeMessages: [...e.arcgisKnowledgeMessages, s],
+    outputMessage: o === "map" ? "No tools were found for the current view and prompt. Maps do not support changing nonspatial visibility, layout changes, or generation from queries." : "No tools were found for the current prompt and knowledge graph service. A knowledge graph service only supports search and query.",
     status: "success"
   } : {
     ...e,
-    arcgisKnowledgeMessages: [...e.arcgisKnowledgeMessages, n],
-    outputMessage: t ? d : s,
-    status: t ? e.status : i ? "success" : "failed",
-    summary: d ? g(d) : "ArcGIS Knowledge Agent tool executed."
+    arcgisKnowledgeMessages: [...e.arcgisKnowledgeMessages, s],
+    outputMessage: t ? d : n,
+    status: t ? e.status : l ? "success" : "failed",
+    summary: d ? c(d) : "ArcGIS Knowledge Agent tool executed."
   };
 }
-async function N(e, o) {
-  const l = new G(m);
+async function z(e, a) {
+  const i = new N(w);
   try {
-    const a = await l.invoke(
+    const o = await i.invoke(
       {
         messages: e.arcgisKnowledgeMessages
       },
-      o
+      a
     ), r = [];
-    for (const t of a.messages) {
-      let s;
+    for (const t of o.messages) {
+      let n;
       if (typeof t.content != "string")
         throw new Error(`Unexpected tool message content type: ${typeof t.content}. Expected string.`);
       try {
-        s = JSON.parse(t.content);
+        n = JSON.parse(t.content);
       } catch {
-        throw new Error(`Failed to parse tool message content as JSON. Tool: ${t.name ?? "unknown"}`);
+        throw new Error(
+          `Failed to parse tool message content as JSON. Tool: ${t.name ?? "unknown"}.
+
+ Original Content: ${t.content}`
+        );
       }
-      if (!s || typeof s != "object" || !("toolName" in s))
+      if (!n || typeof n != "object" || !("toolName" in n))
         throw new Error(
-          `Parsed tool message content does not have expected structure. Parsed content: ${JSON.stringify(s)}`
+          `Parsed tool message content does not have expected structure. Parsed content: ${JSON.stringify(n)}`
         );
-      r.push(s);
+      r.push(n);
     }
-    await c(
+    await p(
       {
-        text: `Finished executing ArcGIS Knowledge Agent tools: ${a.messages.filter((t) => t.name).map((t) => t.name).join(", ")}`
+        text: `Finished executing ArcGIS Knowledge Agent tools: ${o.messages.filter((t) => t.name).map((t) => t.name).join(", ")}`
       },
-      o
+      a
     );
-    const n = r.filter((t) => typeof t != "string").map((t) => `- Called Tool: ${t.toolName}, Status: ${t.status}`);
+    const s = r.filter((t) => typeof t != "string").map((t) => `- Called Tool: ${t.toolName}, Status: ${t.status}`);
     return {
       ...e,
-      outputMessage: n.join(`
+      outputMessage: s.join(`
 `),
-      summary: n.length ? g(n.join(`
+      summary: s.length ? c(s.join(`
 `)) : "ArcGIS Knowledge Agent did not execute any tools or return any results.",
-      arcgisKnowledgeMessages: [...e.arcgisKnowledgeMessages, ...a.messages],
+      arcgisKnowledgeMessages: [...e.arcgisKnowledgeMessages, ...o.messages],
       arcgisKnowledgeToolResult: r
     };
-  } catch (a) {
-    const r = a instanceof Error ? a.message : String(a);
-    return await c({ text: `ArcGIS Knowledge Agent tool execution failed: ${r}` }, o), {
+  } catch (o) {
+    const r = o instanceof Error ? o.message : String(o);
+    return await p(
+      { text: `ArcGIS Knowledge Agent tool execution failed unexpectedly: ${r}` },
+      a
+    ), {
       ...e,
-      outputMessage: `ArcGIS Knowledge Agent tool execution failed: ${r}`,
+      outputMessage: `ArcGIS Knowledge Agent tool execution failed unexpectedly: ${r}`,
       status: "failed",
-      summary: `ArcGIS Knowledge Agent tool execution failed: ${r}`,
+      summary: c(`ArcGIS Knowledge Agent tool execution failed unexpectedly: ${r}`),
       arcgisKnowledgeMessages: [...e.arcgisKnowledgeMessages]
     };
   }
 }
-const L = (e, o) => (
+const D = (e, a) => (
   //agent services (ex: embeddingsWorker) would go in the array below, if required.
-  M([], "ArcgisKnowledge Agent")(e, o)
+  T([], "ArcgisKnowledge Agent")(e, a)
 );
-async function z(e, o) {
-  const a = (e.arcgisKnowledgeToolResult ?? []).map((d) => ({
+async function $(e, a) {
+  const o = (e.arcgisKnowledgeToolResult ?? []).map((d) => ({
     ...d,
     details: void 0
     // Remove details to avoid overwhelming the LLM with too much info
-  })), { knowledgeGraph: r } = await S(o), n = T.getDataModelTypesSummary(r.dataModel), t = {
+  })), { knowledgeGraph: r } = await q(a), s = C.getDataModelTypesSummary(r.dataModel), t = {
     assignedTask: e.agentExecutionContext.assignedTask,
     userRequest: e.agentExecutionContext.userRequest,
-    toolResult: a,
-    dataModelSummary: n
-  }, s = await C({
-    promptText: await p("arcgis_knowledge_summarize_result_prompt"),
+    toolResult: o,
+    dataModelSummary: s
+  }, n = await G({
+    promptText: await u("arcgis_knowledge_summarize_result_prompt"),
     modelTier: "default",
     inputVariables: t
-  }), i = typeof s == "string" ? s : s.content;
+  }), l = typeof n == "string" ? n : n.content;
   return {
     ...e,
-    outputMessage: i,
+    outputMessage: l,
     status: "success",
-    summary: g(i),
-    arcgisKnowledgeMessages: [...e.arcgisKnowledgeMessages, new E(i)]
+    summary: c(l),
+    arcgisKnowledgeMessages: [...e.arcgisKnowledgeMessages, new R(l)]
   };
 }
-const D = () => new w(u).addNode("requireArcgisKnowledgeServices", L).addNode("agent", R).addNode("tools", N).addNode("summarizationLLM", z).addEdge(y, "requireArcgisKnowledgeServices").addEdge("requireArcgisKnowledgeServices", "agent").addConditionalEdges("agent", (o) => (o.arcgisKnowledgeMessages[o.arcgisKnowledgeMessages.length - 1]?.tool_calls?.length ?? 0) > 0 ? "tools" : h).addConditionalEdges("tools", (o) => o.status === "failed" ? h : "summarizationLLM").addEdge("summarizationLLM", h), F = String.raw`The purpose of this agent is to work with Knowledge Graph data, a graph database technology that represents and stores data as interconnected entities (nodes) and relationships (edges).
+function g(e) {
+  return async (a, i) => i?.configurable?.abortSignal?.aborted ? (await p({ text: "Knowledge Agent execution cancelled" }, i), new x({
+    goto: h,
+    update: {
+      outputMessage: "Knowledge Agent execution cancelled",
+      summary: "Knowledge Agent execution cancelled",
+      status: "failed"
+    }
+  })) : await e(a, i);
+}
+const F = () => new y(m).addNode("requireArcgisKnowledgeServices", D).addNode("agent", g(L)).addNode("tools", g(z)).addNode("summarizationLLM", g($)).addEdge(f, "requireArcgisKnowledgeServices").addEdge("requireArcgisKnowledgeServices", "agent").addConditionalEdges("agent", (a) => (a.arcgisKnowledgeMessages[a.arcgisKnowledgeMessages.length - 1]?.tool_calls?.length ?? 0) > 0 ? "tools" : h).addConditionalEdges("tools", (a) => a.status === "failed" ? h : "summarizationLLM").addEdge("summarizationLLM", h), I = String.raw`The purpose of this agent is to work with Knowledge Graph data, a graph database technology that represents and stores data as interconnected entities (nodes) and relationships (edges).
 This agent has two categories of skills: those that work with an active link chart visualization of a subset of the data in the knowledge graph, and those that work with the knowledge graph data more generally against the entire dataset in the service and database.
 For link charts, the agent enables users to interact with a link chart by adding new entities (also called nodes) or relationships (also called edges), removing existing entities or relationships, 
 expanding the graph from particular entities, finding relationships between specified entities on the link chart and adding them to the link chart, finding all relationships 
@@ -162,13 +179,13 @@ _example: "Discover and add all the relationships originating at 'Entity E' to t
 _example: "Show me all entities with a name similar to 'Smith' and add them to the link chart"_
 _example: "Find reports in my graph that have a title similar to 'Quarterly Earnings'"_
 _example: "Find John Smith and all people he has made phone calls to in the last year"_
-_example: "What is the average age of all people who work for Esri?"_`, W = {
+_example: "What is the average age of all people who work for Esri?"_`, ee = {
   id: "arcgisKnowledge",
   name: "ArcgisKnowledge Agent",
-  description: F,
-  createGraph: D,
-  workspace: u
+  description: I,
+  createGraph: F,
+  workspace: m
 };
 export {
-  W as A
+  ee as A
 };

package/dist/chunks/slottableRequestUtils.js

@@ -1,11 +1,7 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-function a(e) {
-  return `message-${e}`;
-}
-function o(e, t) {
-  return `block-${e}-${t}`;
+function e(o, t) {
+  return `block-${o}-${t}`;
 }
 export {
-  o as a,
-  a as g
+  e as g
 };

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

@@ -89,6 +89,13 @@ export abstract class ArcgisAssistant extends LitElement {
       stopButtonLabel: string;
       askButtonLabel: string;
   }>;
+  /**
+   * When `true`, disables the assistant avatar in the chat interface.
+   *
+   * @default false
+   * @since 5.1
+   */
+  accessor assistantAvatarEnabled: boolean;
   /**
    * Indicates whether the assistant is currently processing a user message.
    * This value is `true` while the assistant is generating a response and `false` when idle.
@@ -454,6 +461,13 @@ export abstract class ArcgisAssistant extends LitElement {
    * ```
    */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
+  /**
+   * Emitted when the assistant generates a response to a user message. The event detail includes an AssistantMessage object that contains the assistant's response,
+   * along with any relevant logs or errors. This allows app developers to capture the assistant's responses.
+   *
+   * @since 5.1
+   */
+  readonly arcgisResponse: import("@arcgis/lumina").TargetedEvent<this, AssistantMessage>;
   /**
    * Emitted when the assistant requests custom slotted content for an assistant message.
    *
@@ -508,6 +522,7 @@ export abstract class ArcgisAssistant extends LitElement {
     arcgisInterruptSubmit: ArcgisAssistant["arcgisInterruptSubmit"]["detail"];
     arcgisPromptSelect: ArcgisAssistant["arcgisPromptSelect"]["detail"];
     arcgisReady: ArcgisAssistant["arcgisReady"]["detail"];
+    arcgisResponse: ArcgisAssistant["arcgisResponse"]["detail"];
     arcgisSlottableRequest: ArcgisAssistant["arcgisSlottableRequest"]["detail"];
     arcgisSubmit: ArcgisAssistant["arcgisSubmit"]["detail"];
   };