@arcgis/ai-agents 5.1.0-next.109 → 5.1.0-next.111

package/dist/agents/arcgisKnowledge/context/arcgisKnowledgeContext.d.ts

@@ -12,5 +12,4 @@ export type ArcgisKnowledgeContext = {
     view: LinkChartView | MapView;
     knowledgeGraph?: never;
 };
-export declare const arcgisKnowledgeContextRequiredKeys: readonly ["view"];
-export declare const serviceContextKeys: readonly ["knowledgeGraph", "view"];
+export type KnowledgeGraphSourceType = "knowledgeGraph" | "linkChart" | "map";

package/dist/agents/arcgisKnowledge/context/getArcgisKnowledgeContext.d.ts

@@ -1,10 +1,12 @@
 import { RunnableConfig } from '@langchain/core/runnables';
+import { KnowledgeGraphSourceType } from './arcgisKnowledgeContext';
 import { default as KnowledgeGraph } from '@arcgis/core/rest/knowledgeGraph/KnowledgeGraph.js';
 import { default as LinkChartView } from '@arcgis/core/views/LinkChartView.js';
 import { default as MapView } from '@arcgis/core/views/MapView.js';
 export declare function getViewContext(config?: RunnableConfig): {
     view: LinkChartView | MapView;
 };
+export declare function getContextType(config?: RunnableConfig): KnowledgeGraphSourceType;
 export declare function getKnowledgeGraphContext(config?: RunnableConfig): Promise<{
     knowledgeGraph: KnowledgeGraph;
 }>;

package/dist/agents/arcgisKnowledge/nodes/arcgisKnowledgeLLM.d.ts

@@ -1,3 +1,3 @@
 import { RunnableConfig } from '@langchain/core/runnables';
 import { ArcgisKnowledgeGraphStateType } from '../state/arcgisKnowledgeState';
-export declare function arcgisKnowledgeLLM(state: ArcgisKnowledgeGraphStateType, _config?: RunnableConfig): Promise<ArcgisKnowledgeGraphStateType>;
+export declare function arcgisKnowledgeLLM(state: ArcgisKnowledgeGraphStateType, config?: RunnableConfig): Promise<ArcgisKnowledgeGraphStateType>;

package/dist/agents/arcgisKnowledge/utils/mapUtils.d.ts

@@ -1,4 +1,4 @@
 import { default as LinkChartView } from '@arcgis/core/views/LinkChartView.js';
 import { default as MapView } from '@arcgis/core/views/MapView.js';
-export declare function isMapValid(mapView: MapView): void;
+export declare function validateMapLayers(mapView: MapView): void;
 export declare function isMapView(view: LinkChartView | MapView | undefined): view is MapView;

package/dist/arcgis_knowledge_tool_prompt-C5ubmorM.js

@@ -0,0 +1,33 @@
+const e = `# ArcgisKnowledge Tool Instructions
+
+You are an assistant that helps users answer questions and perform operations on their knowledge graph, map or link chart. You have been assigned the task below, which must be achieved by calling a single tool.
+
+## Task Details:
+
+Assigned task:
+{assignedTask}
+
+User Request:
+{userRequest}
+
+Prior steps:
+{priorSteps}
+
+Context type:
+{contextType}
+
+## Rules:
+
+1. Use the provided context type above for the following rule. If the context type is a map, you may never call any of the following arcgisKnowledge tools: changeNonspatialVisibility, applyLayout, createLinkChart.
+
+2. Use the provided context type above for the following rule. If the context type is a knowledgeGraph, you may never call any of the following arcgisKnowledge tools: changeNonspatialVisibility, applyLayout, createLinkChart, addRecords.
+
+3. If no tools apply to the assigned task, return zero tool calls and an empty message.
+
+4. If a tool is found for the assigned task, call exactly one arcgisKnowledge tool, with the appropriate arguments given the assigned task. Use the provided user request or prior steps only if needed for context based on the assigned task.
+
+5. CRITICAL: You are FORBIDDEN from making multiple tool calls. You MUST make exactly ONE tool call or ZERO tool calls.
+`;
+export {
+  e as default
+};

package/dist/index.js

@@ -1,4 +1,4 @@
-import { Annotation as v, StateGraph as W, START as U, END as C, messagesStateReducer as ke, NodeInterrupt as lt } from "@langchain/langgraph/web";
+import { Annotation as v, StateGraph as U, START as B, END as C, messagesStateReducer as ke, NodeInterrupt as lt } from "@langchain/langgraph/web";
 import { createAgentRuntimeStateWithSharedState as ct, invokeToolPrompt as P, sendTraceMessage as m, invokeStructuredPrompt as Fe, createAgentRuntimeState as ee, invokeTextPrompt as qe, sendUXSuggestion as k } from "@arcgis/ai-orchestrator";
 import { tool as b } from "@langchain/core/tools";
 import oe from "@arcgis/core/config.js";
@@ -23,7 +23,7 @@ import { createRenderer as bt } from "@arcgis/core/smartMapping/renderers/pieCha
 import { getSchemesByTag as St, getSchemes as vt } from "@arcgis/core/smartMapping/symbology/pieChart.js";
 import { getBackgroundColorTheme as we } from "@arcgis/core/views/support/colorUtils.js";
 import { createAgeRenderer as xt, createContinuousRenderer as Tt } from "@arcgis/core/smartMapping/renderers/color.js";
-import { getSchemesByTag as ue } from "@arcgis/core/smartMapping/symbology/color.js";
+import { getSchemesByTag as de } from "@arcgis/core/smartMapping/symbology/color.js";
 import { createContinuousRenderer as Et } from "@arcgis/core/smartMapping/renderers/univariateColorSize.js";
 import { createRenderer as Rt } from "@arcgis/core/smartMapping/renderers/dotDensity.js";
 import { getSchemesByTag as $t } from "@arcgis/core/smartMapping/symbology/dotDensity.js";
@@ -43,21 +43,21 @@ import _e from "@arcgis/core/rest/knowledgeGraph/GraphQueryStreaming.js";
 import Se from "@arcgis/core/request.js";
 import ve from "@arcgis/core/identity/IdentityManager.js";
 import Pt from "@arcgis/core/WebLinkChart.js";
-const V = (e, t) => t ?? e, De = v.Root({
+const Q = (e, t) => t ?? e, De = v.Root({
   ...ct(),
   // internal to the navigation agent
   intent: v({
-    reducer: V
+    reducer: Q
   }),
   vectorSearchLayerResults: v({
-    reducer: V,
+    reducer: Q,
     default: () => []
   }),
   vectorSearchFieldResults: v({
-    reducer: V
+    reducer: Q
   }),
   navigationInternalState: v({
-    reducer: V,
+    reducer: Q,
     default: () => ({
       toolCallMessage: void 0
     })
@@ -283,7 +283,7 @@ const xr = l.object({
   name: "goToZoom",
   description: 'Go to the specified zoom level. If input is generic (e.g. "zoom in", then only zoom to the next appropriate level - increase level for zooming in and decrease for zooming out.).',
   schema: xr
-}), pe = [
+}), ue = [
   Kt,
   Ht,
   Xt,
@@ -298,7 +298,7 @@ const xr = l.object({
   "../agents/arcgisKnowledge/prompts/arcgis_knowledge_current_map_context.md": () => import("./arcgis_knowledge_current_map_context-CfNPKOjr.js").then((e) => e.default),
   "../agents/arcgisKnowledge/prompts/arcgis_knowledge_lucene_generation_prompt.md": () => import("./arcgis_knowledge_lucene_generation_prompt-D3mtOeWu.js").then((e) => e.default),
   "../agents/arcgisKnowledge/prompts/arcgis_knowledge_summarize_result_prompt.md": () => import("./arcgis_knowledge_summarize_result_prompt-D2CFAGMP.js").then((e) => e.default),
-  "../agents/arcgisKnowledge/prompts/arcgis_knowledge_tool_prompt.md": () => import("./arcgis_knowledge_tool_prompt-BxNenktf.js").then((e) => e.default),
+  "../agents/arcgisKnowledge/prompts/arcgis_knowledge_tool_prompt.md": () => import("./arcgis_knowledge_tool_prompt-C5ubmorM.js").then((e) => e.default),
   "../agents/dataExploration/prompts/data_explore_filter_prompt.md": () => import("./data_explore_filter_prompt-g9GTTJyj.js").then((e) => e.default),
   "../agents/dataExploration/prompts/data_explore_query_prompt.md": () => import("./data_explore_query_prompt-DqJVadVm.js").then((e) => e.default),
   "../agents/dataExploration/prompts/summarize_query_response_prompt.md": () => import("./summarize_query_response_prompt-uHW-P2T8.js").then((e) => e.default),
@@ -337,7 +337,7 @@ ${i}` : "", p = {
     promptText: r,
     modelTier: "fast",
     inputVariables: p,
-    tools: pe
+    tools: ue
   }), g = (h.tool_calls?.length ?? 0) > 0, w = typeof h.text == "string" ? h.text.trim() : "", y = w.length > 0;
   return {
     ...e,
@@ -365,7 +365,7 @@ const N = (e, t = 300) => {
   return { text: t };
 };
 async function $r(e, t) {
-  const r = new G(pe);
+  const r = new G(ue);
   try {
     const a = e.navigationInternalState.toolCallMessage;
     if (!a)
@@ -411,7 +411,7 @@ async function $r(e, t) {
   }
 }
 async function Cr(e, t) {
-  const r = await R("navigation_intent_prompt"), { mapView: a } = F(t), o = pe.map((h) => ({
+  const r = await R("navigation_intent_prompt"), { mapView: a } = F(t), o = ue.map((h) => ({
     name: h.name,
     description: h.description,
     schema: h.schema
@@ -521,13 +521,13 @@ ${d.results.map((u) => `  - ${u.name} (${u.score.toFixed(2)})`).join(`
       t
     ), r;
   }
-}, B = (e, t) => (r, a) => {
+}, H = (e, t) => (r, a) => {
   const o = a?.configurable?.services;
   for (const n of e)
     if (!o?.[n])
       throw new Error(`${t} requires services.${n} to be available.`);
   return r;
-}, Ir = (e, t) => B(["layerSearch", "layersAndFieldsRegistry"], "Navigation Agent")(e, t), Nr = () => new W(De).addNode("requireNavigationServices", Ir).addNode("intentLLM", Cr).addNode("vectorSearchLayers", Fr).addNode("vectorSearchFields", Lr).addNode("agent", Er).addNode("tools", $r).addEdge(U, "requireNavigationServices").addEdge("requireNavigationServices", "intentLLM").addConditionalEdges(
+}, Ir = (e, t) => H(["layerSearch", "layersAndFieldsRegistry"], "Navigation Agent")(e, t), Nr = () => new U(De).addNode("requireNavigationServices", Ir).addNode("intentLLM", Cr).addNode("vectorSearchLayers", Fr).addNode("vectorSearchFields", Lr).addNode("agent", Er).addNode("tools", $r).addEdge(B, "requireNavigationServices").addEdge("requireNavigationServices", "intentLLM").addConditionalEdges(
   "intentLLM",
   (t) => t.intent === "goToLayer" || t.intent === "goToFeatures" ? "vectorSearchLayers" : "agent",
   {
@@ -576,7 +576,7 @@ ${d.results.map((u) => `  - ${u.name} (${u.score.toFixed(2)})`).join(`
     reducer: ke,
     default: () => []
   })
-}), Mr = async (e, t) => (await m({ text: "Exiting Data Exploration agent" }, t), e), he = async (e, t) => {
+}), Mr = async (e, t) => (await m({ text: "Exiting Data Exploration agent" }, t), e), pe = async (e, t) => {
   const r = e.tool_calls ?? [];
   if (r.length === 0) {
     await m({ text: `LLM did not request any tool calls: ${String(e?.content)}` }, t);
@@ -632,7 +632,7 @@ const _r = (e) => {
 function Y(e) {
   return "point" in e && e.point !== void 0;
 }
-function Q(e) {
+function K(e) {
   return "layerId" in e && e.layerId !== void 0;
 }
 const te = async (e, t) => {
@@ -644,7 +644,7 @@ const te = async (e, t) => {
       spatialReference: r.spatialReference ? { wkid: r.spatialReference.wkid } : t.spatialReference
     }) };
   }
-  if (Q(e)) {
+  if (K(e)) {
     const r = t.map?.allLayers.find(
       (o) => o.id === e.layerId
     );
@@ -777,7 +777,7 @@ const te = async (e, t) => {
   name: "setFeatureEffect",
   description: "Sets a feature effect on a given layer with given filter parameters and feature effects to emphasize certain features that meet a filter requirement. If no feature effect information is provided, then use the default effect provided.",
   schema: Hr
-}), ie = (e) => {
+}), se = (e) => {
   if (e instanceof Date)
     return Number.isNaN(e.getTime()) ? null : e;
   if (typeof e == "number" && Number.isFinite(e)) {
@@ -788,7 +788,7 @@ const te = async (e, t) => {
 }, Jr = (e) => !e || e === "system" ? Intl.DateTimeFormat().resolvedOptions().timeZone : e === "unknown" ? "UTC" : e, Yr = (e) => {
   if (typeof e == "string" && e)
     return e;
-  const t = ie(e);
+  const t = se(e);
   return t ? t.toISOString().slice(0, 10) : null;
 }, Pe = () => {
   const e = (/* @__PURE__ */ new Date()).getTimezoneOffset(), t = e <= 0 ? "+" : "-", r = Math.floor(Math.abs(e) / 60).toString().padStart(2, "0"), a = (Math.abs(e) % 60).toString().padStart(2, "0"), o = `${t}${r}:${a}`;
@@ -802,13 +802,13 @@ const te = async (e, t) => {
   if (a === "time-only") {
     if (typeof e == "string" && e)
       return gt(e, Z("long-time"));
-    const n = ie(e);
+    const n = se(e);
     return n ? fe(n, {
       ...Z("long-time"),
       timeZone: "UTC"
     }) : e;
   }
-  const o = ie(e);
+  const o = se(e);
   return o ? fe(o, {
     ...Z("short-date-short-time"),
     timeZone: Jr(r)
@@ -912,7 +912,7 @@ const ca = l.object({
   name: "getAttribute",
   description: "Returns an attribute value for a given feature.",
   schema: ca
-}), me = (e, t, r) => r ? e.hasAllFeaturesInView && e.availableFields === t : e.hasAllFeatures && e.availableFields === t;
+}), he = (e, t, r) => r ? e.hasAllFeaturesInView && e.availableFields === t : e.hasAllFeatures && e.availableFields === t;
 function X(e, t) {
   let r = e ?? "";
   return t != null && t && (r = r ? `(${r}) AND (${t})` : t), r || null;
@@ -930,8 +930,8 @@ const ua = async (e) => {
     if ("error" in T)
       throw new Error(T.error);
     if (!T.geometry)
-      throw Q(s) ? new Error(`No features found matching: ${s.where}`) : new Error("Failed to create geometry");
-    if (Q(s)) {
+      throw K(s) ? new Error(`No features found matching: ${s.where}`) : new Error("Failed to create geometry");
+    if (K(s)) {
       const D = o.map?.allLayers.find((L) => L.id === s.layerId);
       h = {
         geometryLayerName: D?.title ?? D?.id,
@@ -954,7 +954,7 @@ const ua = async (e) => {
       spatialRelationship: "intersects"
     });
   }
-  const w = me(c, [r], !1);
+  const w = he(c, [r], !1);
   let y = null, f = null;
   const x = 10;
   if (u.type !== "geometry" && u.type !== "oid" && u.type !== "global-id")
@@ -1102,7 +1102,7 @@ Only call this tool when the answer requires computing an aggregate (avg, max, m
     } else {
       const y = n.createQuery();
       y.where = X(n.definitionExpression, e.where || "1=1"), y.outFields = p.length ? p : ["*"], y.orderByFields = t.orderByFields, y.num = t.topCount, c && (y.geometry = c, y.spatialRelationship = "intersects"), a?.distance && (y.distance = a.distance), a?.units && (y.units = a.units), y.outSpatialReference = r.spatialReference;
-      const f = me(s, e.outFields, o ?? !1);
+      const f = he(s, e.outFields, o ?? !1);
       try {
         h = f ? await s.queryFeatures(y) : await n.queryFeatures(y);
       } catch (x) {
@@ -1190,7 +1190,7 @@ Only call this tool when the answer requires computing an aggregate (avg, max, m
     const y = await te(r, t);
     if ("error" in y) {
       const f = { error: y.error };
-      if (Q(r)) {
+      if (K(r)) {
         const x = t.map?.allLayers.find((E) => E.id === r.layerId);
         f.geometryLayerName = x?.title ?? x?.id, f.geometryLayerId = r.layerId, f.geometryWhere = r.where;
       } else Y(r) && (f.point = r.point);
@@ -1203,7 +1203,7 @@ Only call this tool when the answer requires computing an aggregate (avg, max, m
     }
     if (!y.geometry) {
       const f = {};
-      if (Q(r)) {
+      if (K(r)) {
         const x = t.map?.allLayers.find((E) => E.id === r.layerId);
         f.error = `No features found matching: ${r.where}`, f.geometryLayerName = x?.title ?? x?.id, f.geometryLayerId = r.layerId, f.geometryWhere = r.where;
       } else Y(r) && (f.error = "Failed to create point geometry", f.point = r.point);
@@ -1216,7 +1216,7 @@ Only call this tool when the answer requires computing an aggregate (avg, max, m
     }
     i = y.geometry;
   } else a && (i = t.extent.clone());
-  const c = me(n, e.outFields, a ?? !1), d = o.objectIdField, u = o.createQuery();
+  const c = he(n, e.outFields, a ?? !1), d = o.objectIdField, u = o.createQuery();
   u.where = X(o.definitionExpression, e.where || "1=1"), u.outFields = e.outFields.includes("*") ? ["*"] : [.../* @__PURE__ */ new Set([...e.outFields, d])], u.orderByFields = e.orderByFields, i && (u.geometry = i, u.spatialRelationship = "intersects"), r?.distance && (u.distance = r.distance), r?.units && (u.units = r.units), u.outSpatialReference = t.spatialReference;
   let p, h;
   try {
@@ -1324,7 +1324,7 @@ This is the DEFAULT tool for most queries. When in doubt, use this tool.`,
       // Don't overwrite outputMessage if query already set it
     };
   const u = [...c, i], p = i.content.toString();
-  return await he(i, t), { ...e, dataExplorationMessages: u, outputMessage: p };
+  return await pe(i, t), { ...e, dataExplorationMessages: u, outputMessage: p };
 }, qa = async (e, t) => {
   await m({ text: "Requesting LLM for layer query results" }, t);
   const a = await R("data_explore_query_prompt");
@@ -1344,7 +1344,7 @@ This is the DEFAULT tool for most queries. When in doubt, use this tool.`,
     inputVariables: s,
     tools: Ke
   }), c = i.content.toString();
-  return await he(i, t), {
+  return await pe(i, t), {
     ...e,
     dataExplorationMessages: [...e.dataExplorationMessages, i],
     outputMessage: c,
@@ -1580,10 +1580,10 @@ ${i}` : c = "Vector search completed. No matching layers found.", await m({ text
       t
     ), new Error(`Vector search failed: ${r instanceof Error ? r.message : String(r)}`);
   }
-}, Wa = (e, t) => B(["layerSearch", "fieldSearch", "layersAndFieldsRegistry"], "Data Exploration Agent")(
+}, Wa = (e, t) => H(["layerSearch", "fieldSearch", "layersAndFieldsRegistry"], "Data Exploration Agent")(
   e,
   t
-), Ua = () => new W(je).addNode("requireDataExplorationServices", Wa).addNode("vectorSearchLayers", Ka).addNode("vectorSearchFields", Va).addNode("fieldStatistics", Ga).addNode("queryAgent", qa).addNode("queryTools", Aa).addNode("summarizeQueryResponseLLM", La).addNode("filterAgent", Fa).addNode("filterTools", Ia).addNode("earlyExit", Mr).addEdge(U, "requireDataExplorationServices").addEdge("requireDataExplorationServices", "vectorSearchLayers").addConditionalEdges(
+), Ua = () => new U(je).addNode("requireDataExplorationServices", Wa).addNode("vectorSearchLayers", Ka).addNode("vectorSearchFields", Va).addNode("fieldStatistics", Ga).addNode("queryAgent", qa).addNode("queryTools", Aa).addNode("summarizeQueryResponseLLM", La).addNode("filterAgent", Fa).addNode("filterTools", Ia).addNode("earlyExit", Mr).addEdge(B, "requireDataExplorationServices").addEdge("requireDataExplorationServices", "vectorSearchLayers").addConditionalEdges(
   "vectorSearchLayers",
   (t) => t.vectorSearchLayerIds.length ? "vectorSearchFields" : "earlyExit"
 ).addConditionalEdges(
@@ -1760,7 +1760,7 @@ const oo = l.object({
 function so(e) {
   const { fields: t, layer: r, view: a, theme: o, colorSchemeTags: n } = e, s = t[0];
   let i;
-  return n && (i = ue({
+  return n && (i = de({
     geometryType: r.geometryType,
     includedTags: n,
     theme: o || "high-to-low"
@@ -1839,7 +1839,7 @@ function ho(e) {
   let { theme: n } = e, s = t[1];
   const i = t[0];
   let c;
-  return o && (c = ue({
+  return o && (c = de({
     geometryType: r.geometryType,
     includedTags: o,
     theme: n || "high-to-low"
@@ -1917,7 +1917,7 @@ function bo(e) {
   const { fields: t, layer: r, view: a, colorSchemeTags: o, theme: n } = e;
   let s, i;
   const c = t[0];
-  return o && (i = ue({
+  return o && (i = de({
     geometryType: r.geometryType,
     includedTags: o,
     theme: n || "high-to-low"
@@ -2553,7 +2553,7 @@ Fields: This style requires a single field which may be a string, number, or dat
     inputVariables: a,
     tools: Ue
   });
-  return await he(o, t), {
+  return await pe(o, t), {
     ...e,
     agentExecutionContext: {
       ...e.agentExecutionContext,
@@ -2631,7 +2631,7 @@ const He = v.Root({
     ...e,
     selectedLayerId: o ?? e.vectorSearchLayerIds[0]
   };
-}, bn = (e, t) => B(["layerSearch", "fieldSearch", "layersAndFieldsRegistry"], "Layer Styling Agent")(e, t), Sn = () => new W(He).addNode("requireLayerStylingServices", bn).addNode("vectorSearchLayers", Ya).addNode("layerSelectionHITL", wn).addNode("vectorSearchFields", Za).addNode("populateLayerFieldInfo", fn).addNode("agent", mn).addNode("tools", yn).addNode("earlyExit", gn).addEdge(U, "requireLayerStylingServices").addEdge("requireLayerStylingServices", "vectorSearchLayers").addConditionalEdges(
+}, bn = (e, t) => H(["layerSearch", "fieldSearch", "layersAndFieldsRegistry"], "Layer Styling Agent")(e, t), Sn = () => new U(He).addNode("requireLayerStylingServices", bn).addNode("vectorSearchLayers", Ya).addNode("layerSelectionHITL", wn).addNode("vectorSearchFields", Za).addNode("populateLayerFieldInfo", fn).addNode("agent", mn).addNode("tools", yn).addNode("earlyExit", gn).addEdge(B, "requireLayerStylingServices").addEdge("requireLayerStylingServices", "vectorSearchLayers").addConditionalEdges(
   "layerSelectionHITL",
   (t) => t.vectorSearchLayerIds.length ? "vectorSearchFields" : "earlyExit"
 ).addConditionalEdges(
@@ -2651,7 +2651,7 @@ const He = v.Root({
   ...ee(),
   // internal to the help agent
   helpInternalState: v({
-    reducer: V,
+    reducer: Q,
     default: () => ({
       toolCallMessage: void 0
     })
@@ -2731,7 +2731,7 @@ async function Cn(e, t) {
     };
   }
 }
-const kn = (e, t) => B(["agentRegistry"], "Help Agent")(e, t);
+const kn = (e, t) => H(["agentRegistry"], "Help Agent")(e, t);
 async function Fn(e, t) {
   const r = new G(Je);
   try {
@@ -2764,7 +2764,7 @@ async function Fn(e, t) {
     };
   }
 }
-const qn = () => new W(Ze).addNode("requireHelpServices", kn).addNode("agent", Cn).addNode("tools", Fn).addEdge(U, "requireHelpServices").addEdge("requireHelpServices", "agent").addConditionalEdges("agent", (t) => t.helpInternalState.toolCallMessage ? "tools" : C).addEdge("tools", C), Ln = String.raw`- **help** — Enables users to ask questions about the map, layers, fields, and it's capabilities.
+const qn = () => new U(Ze).addNode("requireHelpServices", kn).addNode("agent", Cn).addNode("tools", Fn).addEdge(B, "requireHelpServices").addEdge("requireHelpServices", "agent").addConditionalEdges("agent", (t) => t.helpInternalState.toolCallMessage ? "tools" : C).addEdge("tools", C), Ln = String.raw`- **help** — Enables users to ask questions about the map, layers, fields, and it's capabilities.
 
   _Example: “Tell me about this map”_  
   _Example: “List all layers in this map”_  
@@ -2798,35 +2798,36 @@ const qn = () => new W(Ze).addNode("requireHelpServices", kn).addNode("agent", C
   })
 }), J = {
   conversationId: ""
-}, In = ["view"], se = ["knowledgeGraph", "view"];
-function Xe(e) {
+};
+function me(e) {
   const t = e.map?.allLayers.filter((r) => r.type === "knowledge-graph");
   if (!t || t?.length !== 1)
     throw new Error("The Knowledge Agent currently only supports maps with exactly one Knowledge Graph Layer.");
 }
-function H(e) {
+function O(e) {
   return !!e?.map && !("activeLinkChartLayer" in e.map);
 }
 function re(e) {
   const r = e?.configurable?.context;
   if (!r || typeof r != "object")
     throw new Error("ArcgisKnowledgeAgent context missing");
-  const a = In.filter((n) => !(n in r));
-  if (a.length)
-    throw new Error(`View context missing: ${a.join(", ")}`);
-  const o = r.view;
-  return o.map && !("activeLinkChartLayer" in o.map) && Xe(o), {
-    view: o
+  if (!("view" in r))
+    throw new Error("View context missing");
+  const a = r.view;
+  return a.map && !("activeLinkChartLayer" in a.map) && me(a), {
+    view: a
   };
 }
-async function O(e) {
+function In(e) {
   const r = e?.configurable?.context;
-  if (!r || typeof r != "object")
-    throw new Error("ArcgisKnowledgeAgent context missing");
-  const a = se.find((o) => o in r);
-  if (!a || se.every((o) => o in r))
-    throw new Error(`Knowledge Graph context should be exactly one of ${se.join(", ")}`);
-  if (a === "knowledgeGraph")
+  if (Xe(e) === "knowledgeGraph")
+    return "knowledgeGraph";
+  const o = r.view;
+  return O(o) ? (me(o), "map") : "linkChart";
+}
+async function V(e) {
+  const r = e?.configurable?.context;
+  if (Xe(e) === "knowledgeGraph")
     return r;
   {
     const o = r.view.map;
@@ -2838,7 +2839,7 @@ async function O(e) {
         knowledgeGraph: await be(n)
       };
     } else {
-      Xe(r.view);
+      me(r.view);
       const s = (r.view.map?.allLayers.find(
         (c) => c.type === "knowledge-graph"
       )).url;
@@ -2850,6 +2851,18 @@ async function O(e) {
     }
   }
 }
+function Xe(e) {
+  const r = e?.configurable?.context;
+  if (!r || typeof r != "object")
+    throw new Error("ArcgisKnowledgeAgent context missing");
+  if ("knowledgeGraph" in r && "view" in r)
+    throw new Error("Knowledge Graph context should only have a view or knowledgeGraph, but never both.");
+  if ("knowledgeGraph" in r)
+    return "knowledgeGraph";
+  if ("view" in r)
+    return "view";
+  throw new Error("ArcgisKnowledgeAgent context must have either a view or knowledgeGraph property.");
+}
 class Nn {
   constructor(t) {
     this.dataModel = t, this.kind = "GraphQueryGenerationRequest", this.explainQuery = !0, this.schemaInformation = ae.fromDataModel(t);
@@ -2867,7 +2880,7 @@ class ae {
   static fromDataModel(t) {
     const r = new ae();
     for (const a of t.entityTypes)
-      r.entityTypes.push(K.fromEntityType(a));
+      r.entityTypes.push(W.fromEntityType(a));
     for (const a of t.relationshipTypes)
       r.relationshipTypes.push(An.fromRelationshipType(a));
     return r.identifierInfo = {
@@ -2886,12 +2899,12 @@ class ae {
  Relationship Types: ${a}.`;
   }
 }
-class K {
+class W {
   constructor() {
     this.name = "", this.properties = [];
   }
   static fromEntityType(t) {
-    const r = new K();
+    const r = new W();
     r.name = t.name, r.alias = t.alias ? t.alias : void 0, r.role = zn(t.role);
     for (const a of t.properties) {
       const o = {
@@ -2910,12 +2923,12 @@ class K {
     return r;
   }
 }
-class An extends K {
+class An extends W {
   constructor() {
     super(...arguments), this.observedEndPoints = [];
   }
   static fromRelationshipType(t) {
-    const r = K.fromEntityType(t);
+    const r = W.fromEntityType(t);
     r.observedEndPoints = [];
     for (const a of t.endPoints)
       r.observedEndPoints.push({
@@ -3318,7 +3331,7 @@ async function Bn(e, t, r, a, o) {
       text: `Query Results parsed into ${u.length} unique relationships and entities.  Atempting to add to link chart...`
     },
     o
-  ), !H(n) && n?.map) {
+  ), !O(n) && n?.map) {
     const p = n.map;
     return await p.addRecords(u), n.goTo(p.diagramNodesExtent ?? new Le()), `Link Chart updated successfully.  Cypher Query used: 
 ${i}
@@ -3335,9 +3348,9 @@ Explanation: ${c}`;
 const rt = "addRecords", Hn = l.object({
   prompt: l.string().describe("The user's inquiry into the knowledge graph that needs to be run.")
 }), Zn = async ({ prompt: e }, t) => {
-  const { knowledgeGraph: r } = await O(t), a = re(t), { view: o } = a, s = _.getDefault().helperServices;
+  const { knowledgeGraph: r } = await V(t), a = re(t), { view: o } = a, s = _.getDefault().helperServices;
   let i = e;
-  if (H(o)) {
+  if (O(o)) {
     const d = o.map, { allNamedTypesFullyDynamic: u, idTypePairs: p, dynamicTypes: h } = Un(d), g = await R("arcgis_knowledge_current_map_context");
     if (i = `${e}
 
@@ -3371,7 +3384,7 @@ ${u}${JSON.stringify(p)}`;
 async function Yn(e, t) {
   return await t.map?.applyLayout(e), `Successfully applied layout: ${e}.`;
 }
-const le = "applyLayout", Xn = l.object({
+const ie = "applyLayout", Xn = l.object({
   layout: l.enum([
     "organic-standard",
     "organic-community",
@@ -3387,9 +3400,9 @@ const le = "applyLayout", Xn = l.object({
   )
 }), es = async ({ layout: e }, t) => {
   const { view: r } = re(t);
-  if (H(r))
+  if (O(r))
     return {
-      toolName: le,
+      toolName: ie,
       status: "error",
       errorMessage: "The applyLayout tool can only be used with a LinkChartView.",
       error: new Error()
@@ -3397,26 +3410,26 @@ const le = "applyLayout", Xn = l.object({
   {
     const a = await Yn(e, r);
     return {
-      toolName: le,
+      toolName: ie,
       status: "success",
       summary: a
     };
   }
 }, ts = b(es, {
-  name: le,
+  name: ie,
   description: "Apply a diagram layout to the link chart",
   schema: Xn
 });
 function rs(e, t) {
   return t.map?.changeNonspatialDataDisplay(e), `Successfully applied nonspatial visibility setting: ${e}.`;
 }
-const ce = "changeNonspatialVisibility", as = l.object({
+const le = "changeNonspatialVisibility", as = l.object({
   setting: l.enum(["hidden", "visible"]).describe("The setting of nonspatial visibility")
 }), os = async ({ setting: e }, t) => {
   const { view: r } = re(t);
-  if (H(r))
+  if (O(r))
     return {
-      toolName: ce,
+      toolName: le,
       status: "error",
       errorMessage: "The changeNonspatialVisibility tool can only be used with a LinkChartView.",
       error: new Error()
@@ -3424,13 +3437,13 @@ const ce = "changeNonspatialVisibility", as = l.object({
   {
     const a = rs(e, r);
     return {
-      toolName: ce,
+      toolName: le,
       status: "success",
       summary: a
     };
   }
 }, ns = b(os, {
-  name: ce,
+  name: le,
   description: "Change whether or not nonspatial data is visible in the link chart.  The value must be either 'hidden' or 'visible'.",
   schema: as
 });
@@ -3473,15 +3486,15 @@ Explanation: ${c}`;
   }
   throw new Error(`Failed to create link chart after ${z} attempts.`);
 }
-const de = "createLinkChart", is = l.object({
+const ce = "createLinkChart", is = l.object({
   prompt: l.string().describe(
     "The user's inquiry into the knowledge graph that needs to be transformed into a link chart visualization."
   )
 }), ls = async ({ prompt: e }, t) => {
-  const { knowledgeGraph: r } = await O(t), { view: a } = re(t);
-  if (H(a))
+  const { knowledgeGraph: r } = await V(t), { view: a } = re(t);
+  if (O(a))
     return {
-      toolName: de,
+      toolName: ce,
       status: "error",
       errorMessage: "The createLinkChart tool can only be used with a LinkChartView.",
       error: new Error()
@@ -3495,13 +3508,13 @@ const de = "createLinkChart", is = l.object({
       t
     );
     return {
-      toolName: de,
+      toolName: ce,
       status: "success",
       summary: s
     };
   }
 }, cs = b(ls, {
-  name: de,
+  name: ce,
   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.",
   schema: is
 }), at = "queryGraphData", ds = l.object({
@@ -3513,7 +3526,7 @@ REQUEST LIMIT: If the user does not specifically request for no limits or an exp
 DESCRIPTIVE COLUMN NAMES: If the user's prompt does not explicitly request for specific column names in the result, ensure that the generated query has descriptive column names (using AS statements) to make the results easier to understand when displayed in a table format.`
   )
 }), us = async ({ prompt: e }, t) => {
-  const { knowledgeGraph: r } = await O(t), o = _.getDefault().helperServices, n = await tt({
+  const { knowledgeGraph: r } = await V(t), o = _.getDefault().helperServices, n = await tt({
     prompt: e,
     kg: r,
     graphQueryServiceUrl: `${o.aiAssistantServices.url}${o.aiAssistantServices.graphQueryAssistant}`,
@@ -3571,7 +3584,7 @@ ${p.length > u ? `Showing top ${u} results:
 }), ot = "generateCypher", hs = l.object({
   prompt: l.string().describe("The user's inquiry into the knowledge graph that needs to be translated into a cypher query.")
 }), ms = async ({ prompt: e }, t) => {
-  const { knowledgeGraph: r } = await O(t), o = _.getDefault().helperServices, n = await jn(
+  const { knowledgeGraph: r } = await V(t), o = _.getDefault().helperServices, n = await jn(
     e,
     r.dataModel,
     `${o.aiAssistantServices.url}${o.aiAssistantServices.graphQueryAssistant}`,
@@ -3632,7 +3645,7 @@ const nt = "searchGraphData", ws = l.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."
   )
 }), bs = async ({ prompt: e }, t) => {
-  const { knowledgeGraph: r } = await O(t);
+  const { knowledgeGraph: r } = await V(t);
   await m({ text: "Generating search query for the user inquiry" }, t);
   const a = await fs(e, r);
   await m({ text: "Executing graph search with generated search query" }, t);
@@ -3693,22 +3706,28 @@ const nt = "searchGraphData", ws = l.object({
   ps
 ];
 async function vs(e, t) {
-  const r = await R("arcgis_knowledge_tool_prompt"), a = {
+  const r = await R("arcgis_knowledge_tool_prompt"), a = In(t), o = {
     assignedTask: e.agentExecutionContext.assignedTask,
     userRequest: e.agentExecutionContext.userRequest,
-    priorSteps: e.agentExecutionContext.priorSteps
-  }, o = await P({
+    priorSteps: e.agentExecutionContext.priorSteps,
+    contextType: a
+  }, n = await P({
     promptText: r,
     messages: e.arcgisKnowledgeMessages,
-    inputVariables: a,
+    inputVariables: o,
     tools: st
-  }), n = (o.tool_calls?.length ?? 0) > 0, s = typeof o.text == "string" ? o.text.trim() : "", i = s.length > 0, c = o.content.toString();
-  return {
+  }), s = (n.tool_calls?.length ?? 0) > 0, i = typeof n.text == "string" ? n.text.trim() : "", c = i.length > 0, d = n.content.toString();
+  return !s && (a === "map" || a === "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.",
+    status: "success"
+  } : {
     ...e,
-    arcgisKnowledgeMessages: [...e.arcgisKnowledgeMessages, o],
-    outputMessage: n ? c : s,
-    status: n ? e.status : i ? "success" : "failed",
-    summary: c ? N(c) : "ArcGIS Knowledge Agent tool executed."
+    arcgisKnowledgeMessages: [...e.arcgisKnowledgeMessages, n],
+    outputMessage: s ? d : i,
+    status: s ? e.status : c ? "success" : "failed",
+    summary: d ? N(d) : "ArcGIS Knowledge Agent tool executed."
   };
 }
 async function xs(e, t) {
@@ -3764,14 +3783,14 @@ async function xs(e, t) {
 }
 const Ts = (e, t) => (
   //agent services (ex: embeddingsWorker) would go in the array below, if required.
-  B([], "ArcgisKnowledge Agent")(e, t)
+  H([], "ArcgisKnowledge Agent")(e, t)
 );
 async function Es(e, t) {
   const a = (e.arcgisKnowledgeToolResult ?? []).map((d) => ({
     ...d,
     details: void 0
     // Remove details to avoid overwhelming the LLM with too much info
-  })), { knowledgeGraph: o } = await O(t), n = ae.getDataModelTypesSummary(o.dataModel), s = {
+  })), { knowledgeGraph: o } = await V(t), n = ae.getDataModelTypesSummary(o.dataModel), s = {
     assignedTask: e.agentExecutionContext.assignedTask,
     userRequest: e.agentExecutionContext.userRequest,
     toolResult: a,
@@ -3789,7 +3808,7 @@ async function Es(e, t) {
     arcgisKnowledgeMessages: [...e.arcgisKnowledgeMessages, new ze(c)]
   };
 }
-const Rs = () => new W(Ye).addNode("requireArcgisKnowledgeServices", Ts).addNode("agent", vs).addNode("tools", xs).addNode("summarizationLLM", Es).addEdge(U, "requireArcgisKnowledgeServices").addEdge("requireArcgisKnowledgeServices", "agent").addConditionalEdges("agent", (t) => (t.arcgisKnowledgeMessages[t.arcgisKnowledgeMessages.length - 1]?.tool_calls?.length ?? 0) > 0 ? "tools" : C).addConditionalEdges("tools", (t) => t.status === "failed" ? C : "summarizationLLM").addEdge("summarizationLLM", C), $s = 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).
+const Rs = () => new U(Ye).addNode("requireArcgisKnowledgeServices", Ts).addNode("agent", vs).addNode("tools", xs).addNode("summarizationLLM", Es).addEdge(B, "requireArcgisKnowledgeServices").addEdge("requireArcgisKnowledgeServices", "agent").addConditionalEdges("agent", (t) => (t.arcgisKnowledgeMessages[t.arcgisKnowledgeMessages.length - 1]?.tool_calls?.length ?? 0) > 0 ? "tools" : C).addConditionalEdges("tools", (t) => t.status === "failed" ? C : "summarizationLLM").addEdge("summarizationLLM", C), $s = 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 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/ai-agents",
-  "version": "5.1.0-next.109",
+  "version": "5.1.0-next.111",
   "description": "ArcGIS AI Agents Package",
   "homepage": "https://developers.arcgis.com/javascript/latest/",
   "type": "module",
@@ -20,7 +20,7 @@
     "@langchain/langgraph": "^1.2.6",
     "tslib": "^2.8.1",
     "zod": "^4.3.6",
-    "@arcgis/ai-orchestrator": "5.1.0-next.109"
+    "@arcgis/ai-orchestrator": "5.1.0-next.111"
   },
   "peerDependencies": {
     "@arcgis/core": "^5.1.0-next"

package/dist/arcgis_knowledge_tool_prompt-BxNenktf.js

@@ -1,26 +0,0 @@
-const e = `# ArcgisKnowledge Tool Instructions
-
-You are an assistant that helps users answer questions and perform operations on their knowledge graph or link chart. You have been assigned the task below, which must be achieved by calling a single tool.
-
-## Task Details:
-
-Assigned task:
-{assignedTask}
-
-User Request:
-{userRequest}
-
-Prior steps:
-{priorSteps}
-
-## Your Goal:
-
-Call exactly one arcgisKnowledge tool, with the appropriate arguments given the assigned task. Use the provided user request or prior steps only if needed for context based on the assigned task.
-
-If no tools apply, return an **empty string**
-
-CRITICAL: You are FORBIDDEN from making multiple tool calls. You MUST make exactly ONE tool call.
-`;
-export {
-  e as default
-};