@arcgis/ai-components 5.2.0-next.71 → 5.2.0-next.72

package/dist/chunks/navigationGraph.js

@@ -1,11 +1,11 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 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 { 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 V, f as u, r as j, N as w } from "./adapter.js";
 import "@arcgis/core/identity/IdentityManager.js";
 import "@arcgis/core/portal/Portal.js";
 import "@arcgis/core/request.js";
 import "@arcgis/toolkit/string";
-import { h as V, i as z } from "./generateLayerDescriptions.js";
+import { h as P, i as z } from "./generateLayerDescriptions.js";
 import "@langchain/core/messages";
 import "@langchain/core/callbacks/dispatch/web";
 import "@langchain/openai";
@@ -29,23 +29,23 @@ const S = [
   Z
 ];
 async function B(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(
+  const o = await T("navigation_tool_prompt"), { mapView: s } = k(t, ["mapView"]), i = s.map.bookmarks?.map((p) => p.name).filter(Boolean) ?? [], l = e.vectorSearchLayerResults?.length > 0 ? e.vectorSearchLayerResults.map(
     (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(`
 `)}` : "", r = (e.intent === "goToLayer" || e.intent === "goToFeatures") && e.vectorSearchLayerResults?.length ? `Candidate layers:
-${l}` : "", m = e.intent === "goToFeatures" && e.vectorSearchFieldResults?.length ? `Candidate fields:
+${l}` : "", d = e.intent === "goToFeatures" && e.vectorSearchFieldResults?.length ? `Candidate fields:
 ${c}` : "", y = {
     intent: e.intent,
     bookmarksSection: a,
     layersSection: r,
-    fieldsSection: m,
+    fieldsSection: d,
     currentZoom: s.zoom,
     assignedTask: e.agentExecutionContext.assignedTask,
     userRequest: e.agentExecutionContext.userRequest,
     priorSteps: e.agentExecutionContext.priorSteps
-  }, n = await V({
+  }, n = await P({
     promptText: o,
     modelTier: "fast",
     config: t,
@@ -82,14 +82,14 @@ async function J(e, t) {
     const s = e.navigationInternalState.toolCallMessage;
     if (!s)
       throw new Error("navigationToolCalling: missing navigationInternalState.toolCallMessage");
-    const { messages: d } = await o.invoke(
+    const { messages: m } = await o.invoke(
       {
         messages: [s]
       },
       t
     );
     let i = "", l;
-    for (const c of d) {
+    for (const c of m) {
       const a = D(c.content);
       a.text && (i += `${a.text}
 `), a.sharedStatePatch && (l = {
@@ -102,19 +102,19 @@ async function J(e, t) {
       outputMessage: i,
       sharedStatePatch: l,
       status: "success",
-      summary: i ? j(i) : "Navigation executed.",
+      summary: i ? V(i) : "Navigation executed.",
       navigationInternalState: {
         ...e.navigationInternalState,
         toolCallMessage: void 0
       }
     };
   } catch (s) {
-    const d = s instanceof Error ? s.message : String(s);
-    return await h({ text: `Navigation tool execution failed: ${d}` }, t), {
+    const m = s instanceof Error ? s.message : String(s);
+    return await h({ text: `Navigation tool execution failed: ${m}` }, t), {
       ...e,
-      outputMessage: `Navigation tool execution failed: ${d}`,
+      outputMessage: `Navigation tool execution failed: ${m}`,
       status: "failed",
-      summary: `Navigation tool execution failed: ${d}`,
+      summary: `Navigation tool execution failed: ${m}`,
       navigationInternalState: {
         ...e.navigationInternalState,
         toolCallMessage: void 0
@@ -123,14 +123,14 @@ async function J(e, t) {
   }
 }
 async function H(e, t) {
-  const o = await T("navigation_intent_prompt"), { mapView: s } = k(t), d = S.map((n) => ({
+  const o = await T("navigation_intent_prompt"), { mapView: s } = k(t, ["mapView"]), m = S.map((n) => ({
     name: n.name,
     description: n.description,
     schema: n.schema
   })), l = s.map.bookmarks?.map((n) => n.name).filter(Boolean) ?? [], c = l.length ? `Available bookmarks:
 ${l.map((n) => `- ${n}`).join(`
 `)}` : "No bookmarks are available in this map.", a = {
-    tools: d.map(({ name: n, description: g, schema: v }) => `${n}: ${g}, ${JSON.stringify(v)}`).join(`
+    tools: m.map(({ name: n, description: g, schema: v }) => `${n}: ${g}, ${JSON.stringify(v)}`).join(`
 `),
     bookmarks: c,
     assignedTask: e.agentExecutionContext.assignedTask,
@@ -138,13 +138,13 @@ ${l.map((n) => `- ${n}`).join(`
     priorSteps: e.agentExecutionContext.priorSteps
   }, r = x.object({
     intent: x.string()
-  }), m = await z({
+  }), d = await z({
     promptText: o,
     config: t,
     inputVariables: a,
     schema: r,
     modelTier: "fast"
-  }), y = typeof m.intent == "string" ? m.intent.trim().replace(/^"|"$/gu, "") : "";
+  }), y = typeof d.intent == "string" ? d.intent.trim().replace(/^"|"$/gu, "") : "";
   return { ...e, intent: y || "" };
 }
 const U = 0.7, W = async (e, t) => {
@@ -153,16 +153,16 @@ const U = 0.7, W = async (e, t) => {
       { text: `Similarity search to find layers: ${e.agentExecutionContext.assignedTask}` },
       t
     );
-    const o = u(t, "layerSearch"), s = u(t, "layersAndFieldsRegistry"), d = u(t, "embeddingCache"), l = (await o.searchLayers({
+    const o = u(t, "layerSearch"), s = u(t, "layersAndFieldsRegistry"), m = u(t, "embeddingCache"), l = (await o.searchLayers({
       text: e.agentExecutionContext.assignedTask,
       minScore: U,
-      embeddingCache: d
+      embeddingCache: m
     })).map(({ id: a, score: r }) => {
-      const m = s.get(a)?.layerItem;
+      const d = s.get(a)?.layerItem;
       return {
         id: a,
-        title: m?.title,
-        name: m?.name ?? void 0,
+        title: d?.title,
+        name: d?.name ?? void 0,
         score: r
       };
     });
@@ -185,7 +185,7 @@ ${l.map((a) => `- layerId=${a.id} | title=${a.title ?? ""} | name=${a.name ?? ""
       { text: `Similarity search to find fields: ${e.agentExecutionContext.assignedTask}` },
       t
     );
-    const o = u(t, "fieldSearch"), s = u(t, "layersAndFieldsRegistry"), d = u(t, "embeddingCache"), i = e.vectorSearchLayerResults?.map((r) => r.id) ?? [];
+    const o = u(t, "fieldSearch"), s = u(t, "layersAndFieldsRegistry"), m = u(t, "embeddingCache"), i = e.vectorSearchLayerResults?.map((r) => r.id) ?? [];
     if (i.length === 0)
       return await h({ text: "No candidate layers for field search" }, t), e;
     const c = (await o.searchFields({
@@ -193,13 +193,13 @@ ${l.map((a) => `- layerId=${a.id} | title=${a.title ?? ""} | name=${a.name ?? ""
       layerIds: i,
       minScore: f,
       topResults: K,
-      embeddingCache: d
-    })).map(({ layerId: r, results: m }) => {
+      embeddingCache: m
+    })).map(({ layerId: r, results: d }) => {
       const y = s.get(r)?.fieldRegistry;
       return {
         layerId: r,
         layerName: s.get(r)?.layerItem.name,
-        results: m.map((n) => {
+        results: d.map((n) => {
           const g = y?.get(n.name);
           return {
             name: n.name,
@@ -217,7 +217,7 @@ ${l.map((a) => `- layerId=${a.id} | title=${a.title ?? ""} | name=${a.name ?? ""
     return c.length > 0 ? a = `Vector search completed. Matching layers and fields:
 ${c.map(
       (r) => `${r.layerName ?? r.layerId}:
-${r.results.map((m) => `  - ${m.name} (${m.score.toFixed(2)})`).join(`
+${r.results.map((d) => `  - ${d.name} (${d.score.toFixed(2)})`).join(`
 `)}`
     ).join(`
 `)}` : a = `No vector search field results found for score over ${f}.`, await h({ text: a }, t), {
@@ -230,7 +230,7 @@ ${r.results.map((m) => `  - ${m.name} (${m.score.toFixed(2)})`).join(`
       t
     ), o;
   }
-}, X = (e, t) => P(["layerSearch", "layersAndFieldsRegistry"], "Navigation Agent")(e, t), Y = () => new E(w).addNode("requireNavigationServices", X).addNode("intentLLM", H).addNode("vectorSearchLayers", W).addNode("vectorSearchFields", Q).addNode("agent", B).addNode("tools", J).addEdge($, "requireNavigationServices").addEdge("requireNavigationServices", "intentLLM").addConditionalEdges(
+}, X = (e, t) => j(["layerSearch", "layersAndFieldsRegistry"], "Navigation Agent")(e, t), Y = () => new E(w).addNode("requireNavigationServices", X).addNode("intentLLM", H).addNode("vectorSearchLayers", W).addNode("vectorSearchFields", Q).addNode("agent", B).addNode("tools", J).addEdge($, "requireNavigationServices").addEdge("requireNavigationServices", "intentLLM").addConditionalEdges(
   "intentLLM",
   (t) => t.intent === "goToLayer" || t.intent === "goToFeatures" ? "vectorSearchLayers" : "agent",
   {

package/dist/chunks/orchestrator.js

@@ -1,7 +1,7 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import A from "@arcgis/core/identity/IdentityManager.js";
 import C from "@arcgis/core/portal/Portal.js";
-import { n as k, o as b, D as M, p as D, q as F, W as $ } from "./generateLayerDescriptions.js";
+import { j as k, k as b, D as M, n as D, o as F, W as $ } from "./generateLayerDescriptions.js";
 import { isGraphInterrupt as L, StateGraph as W, START as q, END as j, MemorySaver as H } from "@langchain/langgraph/web";
 import { generateGuid as P } from "@arcgis/toolkit/string";
 import { HumanMessage as O, AIMessage as T } from "@langchain/core/messages";

package/dist/chunks/state.js

@@ -1,17 +1,9 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { Annotation as s } from "@langchain/langgraph/web";
-const c = /* @__PURE__ */ new Set(["agentExecutionContext", "outputMessage", "summary", "status"]);
-function u() {
-  return {
-    assignedTask: "",
-    messages: [],
-    priorSteps: [],
-    sharedState: {},
-    userRequest: ""
-  };
-}
-function i(r) {
-  const n = [...new Set([...r].filter((t) => c.has(t)))];
+import { Annotation as o } from "@langchain/langgraph/web";
+import { c } from "./baseAgentState.js";
+const i = /* @__PURE__ */ new Set(["agentExecutionContext", "outputMessage", "summary", "status"]);
+function u(r) {
+  const n = [...new Set([...r].filter((t) => i.has(t)))];
   if (n.length !== 0)
     throw new Error(`custom state cannot define reserved runtime fields: ${n.join(", ")}.`);
 }
@@ -20,36 +12,36 @@ function f(r) {
   return Object.fromEntries(
     n.map(([t, e]) => [
       t,
-      s({
-        reducer: (o, a) => a,
+      o({
+        reducer: (s, a) => a,
         default: () => e
       })
     ])
   );
 }
 function m(r = {}) {
-  i(Object.keys(r));
+  u(Object.keys(r));
   const n = f(r);
-  return s.Root({
+  return o.Root({
     ...n,
-    agentExecutionContext: s({
+    agentExecutionContext: o({
       reducer: (t, e) => ({
         ...t,
         ...e
       }),
-      default: u
+      default: c
     }),
-    outputMessage: s({
+    outputMessage: o({
       // Preserve the last meaningful user-facing message produced by the graph.
       reducer: (t = "", e) => typeof e == "string" && e.trim() ? e : t,
       default: () => ""
     }),
-    summary: s({
+    summary: o({
       // Summary is a compact orchestrator-facing outcome, so replacement semantics are enough.
       reducer: (t = "", e) => typeof e == "string" ? e : t,
       default: () => ""
     }),
-    status: s({
+    status: o({
       // Keep the first meaningful status until a later node explicitly replaces it.
       reducer: (t, e) => e ?? t,
       default: () => {
@@ -57,15 +49,17 @@ function m(r = {}) {
     })
   });
 }
-function l(r) {
+function g(r) {
   const n = /* @__PURE__ */ new Set();
   for (const e of r)
-    for (const o of Object.keys(e.shape ?? {}))
-      n.add(o);
+    for (const s of Object.keys(e.shape ?? {}))
+      n.add(s);
   const t = Object.fromEntries([...n].map((e) => [e, void 0]));
   return m(t);
 }
 export {
   m as a,
-  l as c
+  u as b,
+  g as c,
+  f as d
 };

package/dist/chunks/utils2.js

@@ -40,8 +40,8 @@ function v(e) {
   return t ? t.view : null;
 }
 export {
-  g as a,
-  v as b,
-  w as i,
+  v as a,
+  w as b,
+  g as i,
   m as r
 };

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

@@ -1,6 +1,7 @@
 /// <reference path="../../index.d.ts" />
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { AgentRegistration } from "../../utils/index.js";
+import type { AgenticWorkflowJson } from "../../agentic-workflow/jsonTypes.js";
 
 /**
  * The Assistant Agent component is a generic wrapper for registering custom agents to the [arcgis-assistant](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/) component. To define
@@ -67,7 +68,6 @@ export abstract class ArcgisAssistantAgent<TContext = Record<string, unknown>> e
    * See the [Custom Agents guide](https://developers.arcgis.com/javascript/latest/agentic-apps/ai-custom-agents/) for more instructions
    * and links to samples demonstrating how to create custom agents.
    *
-   * @required
    * @see [LangGraph documentation](https://docs.langchain.com/oss/javascript/langgraph/overview)
    * @see [Custom agents guide](https://developers.arcgis.com/javascript/latest/agentic-apps/ai-custom-agents/)
    * @example
@@ -138,4 +138,16 @@ export abstract class ArcgisAssistantAgent<TContext = Record<string, unknown>> e
    * ```
    */
   accessor context: TContext | (() => Promise<TContext | undefined> | TContext | undefined) | undefined;
+  /**
+   * The portal item ID associated with this assistant agent.
+   *
+   * @internal
+   */
+  accessor itemId: string | undefined;
+  /**
+   * The workflow JSON associated with this assistant agent.
+   *
+   * @internal
+   */
+  accessor workflow: AgenticWorkflowJson | undefined;
 }