@arcgis/ai-components 5.2.0-next.99 → 6.0.0-next.1

package/dist/agentic-workflow/jsonTypes.d.ts

@@ -1,3 +1,13 @@
+/** @internal */
+export type AgenticWorkflowJsonPrimitive = boolean | number | string | null;
+
+/** @internal */
+export type AgenticWorkflowJsonObject = { readonly [key: string]: AgenticWorkflowJsonValue | undefined; };
+
+/** @internal */
+export type AgenticWorkflowJsonValue = AgenticWorkflowJsonObject | AgenticWorkflowJsonPrimitive | AgenticWorkflowJsonValue[] | undefined;
+
+/** @internal */
 export type AgenticWorkflowJson = AgenticWorkflowJsonObject
   & {
   readonly description?: string;
@@ -6,6 +16,26 @@ export type AgenticWorkflowJson = AgenticWorkflowJsonObject
   readonly version: string;
 };
 
+/** @internal */
+export type AgenticWorkflowVariableJson = AgenticWorkflowJsonObject
+  & {
+  readonly data_type?: "array" | "boolean" | "number" | "object" | "string";
+  readonly description?: string;
+  readonly key: string;
+  readonly persisted: boolean;
+  readonly private: boolean;
+  readonly type: "value";
+  readonly value: AgenticWorkflowJsonValue;
+};
+
+/** @internal */
+export type AgenticWorkflowGraphJson = AgenticWorkflowJsonObject
+  & {
+  readonly edges: AgenticWorkflowEdgeJson[];
+  readonly nodes: AgenticWorkflowNodeJson[];
+};
+
+/** @internal */
 export type AgenticWorkflowEdgeJson = AgenticWorkflowJsonObject
   & {
   readonly id: string;
@@ -15,8 +45,19 @@ export type AgenticWorkflowEdgeJson = AgenticWorkflowJsonObject
   readonly target_node_id: AgenticWorkflowNodeIdJson;
 };
 
-export type AgenticWorkflowNodeTypeJson = "agent_node" | "end_message_node" | "guardrails_node" | "hitl_node" | "loop_node" | "start_node";
+/** @internal */
+export type AgenticWorkflowNodeIdJson = `${string}_node_${number}`;
+
+/** @internal */
+export type AgenticWorkflowSourceAnchorIdJson = string;
+
+/** @internal */
+export type AgenticWorkflowNodeTypeJson = "agent_node" | "end_message_node" | "guardrails_node" | "human_input_node" | "loop_node" | "start_node";
+
+/** @internal */
+export type AgenticWorkflowNodeJson = AgenticWorkflowAgentNodeJson | AgenticWorkflowEndMessageNodeJson | AgenticWorkflowGuardrailsNodeJson | AgenticWorkflowHumanInTheLoopNodeJson | AgenticWorkflowLoopNodeJson | AgenticWorkflowStartNodeJson;
 
+/** @internal */
 export type AgenticWorkflowBaseNodeJson<TType extends AgenticWorkflowNodeTypeJson> = AgenticWorkflowJsonObject
   & {
   readonly id: AgenticWorkflowNodeIdJson;
@@ -24,13 +65,21 @@ export type AgenticWorkflowBaseNodeJson<TType extends AgenticWorkflowNodeTypeJso
   readonly type: TType;
 };
 
+/** @internal */
 export type AgenticWorkflowStartNodeJson = AgenticWorkflowBaseNodeJson<"start_node">;
 
+/** @internal */
 export type AgenticWorkflowEndMessageNodeJson = AgenticWorkflowBaseNodeJson<"end_message_node">
   & {
   readonly message: string;
 };
 
+/** @internal */
+export type AgenticWorkflowLLMModelJson = {
+  readonly model_tier: "advanced" | "default" | "fast";
+};
+
+/** @internal */
 export type AgenticWorkflowAgentNodeJson = AgenticWorkflowBaseNodeJson<"agent_node">
   & {
   readonly prompt?: AgenticWorkflowPromptJson;
@@ -39,77 +88,83 @@ export type AgenticWorkflowAgentNodeJson = AgenticWorkflowBaseNodeJson<"agent_no
   readonly llm_model?: AgenticWorkflowLLMModelJson;
 };
 
-export type AgenticWorkflowArcgisToolJson = AgenticWorkflowJsonObject
+/** @internal */
+export type AgenticWorkflowGuardrailsNodeJson = AgenticWorkflowBaseNodeJson<"guardrails_node">
   & {
-  readonly type: "arcgis_tool";
-  readonly name: string;
-  readonly require_approval: AgenticWorkflowApprovalRequirementJson;
+  readonly conditions: AgenticWorkflowConditionJson[];
+  readonly confidence_threshold: number;
+  readonly prompt?: AgenticWorkflowPromptJson;
+  readonly llm_model?: AgenticWorkflowLLMModelJson;
 };
 
-export type AgenticWorkflowJsonObject = { readonly [key: string]: AgenticWorkflowJsonValue | undefined; };
-
-export type AgenticWorkflowJsonValue = AgenticWorkflowJsonObject | AgenticWorkflowJsonPrimitive | AgenticWorkflowJsonValue[] | undefined;
-
-export type AgenticWorkflowVariableJson = AgenticWorkflowJsonObject
+/** @internal */
+export type AgenticWorkflowHumanInTheLoopNodeJson = AgenticWorkflowBaseNodeJson<"human_input_node">
   & {
-  readonly data_type?: "array" | "boolean" | "number" | "object" | "string";
-  readonly description?: string;
-  readonly key: string;
-  readonly persisted: boolean;
-  readonly private: boolean;
-  readonly type: "value";
-  readonly value: AgenticWorkflowJsonValue;
+  readonly conditions: AgenticWorkflowConditionJson[];
+  readonly message: AgenticWorkflowHumanInTheLoopMessageJson;
+  readonly response: AgenticWorkflowHumanInTheLoopResponseJson;
 };
 
-export type AgenticWorkflowGraphJson = AgenticWorkflowJsonObject
-  & {
-  readonly edges: AgenticWorkflowEdgeJson[];
-  readonly nodes: AgenticWorkflowNodeJson[];
+/** @internal */
+export type AgenticWorkflowHumanInTheLoopMessageJson = {
+    readonly content: string;
+    readonly source: "fixed";
+} | {
+    readonly generationInstructions: string;
+    readonly model: AgenticWorkflowLLMModelJson;
+    readonly source: "generated";
 };
 
-export type AgenticWorkflowNodeIdJson = `${string}_node_${number}`;
-
-export type AgenticWorkflowSourceAnchorIdJson = `source_anchor_${string}`;
-
-export type AgenticWorkflowNodeJson = AgenticWorkflowAgentNodeJson | AgenticWorkflowEndMessageNodeJson | AgenticWorkflowGuardrailsNodeJson | AgenticWorkflowHumanInTheLoopNodeJson | AgenticWorkflowLoopNodeJson | AgenticWorkflowStartNodeJson;
-
-export type AgenticWorkflowLLMModelJson = {
-  readonly model_tier: "advanced" | "default" | "fast";
-};
+/** @internal */
+export type AgenticWorkflowHumanInTheLoopResponseJson = {
+    readonly choices: AgenticWorkflowHumanInTheLoopChoicesJson;
+    readonly freeTextInput?: AgenticWorkflowHumanInTheLoopFreeTextJson;
+    readonly type: "multipleSelect" | "singleSelect";
+} | {
+    readonly type: "confirmation";
+    readonly freeTextInput?: AgenticWorkflowHumanInTheLoopFreeTextJson;
+} | { readonly type: "textInput"; };
 
-export type AgenticWorkflowGuardrailsNodeJson = AgenticWorkflowBaseNodeJson<"guardrails_node">
-  & {
-  readonly conditions: AgenticWorkflowConditionJson[];
-  readonly confidence_threshold: number;
-  readonly prompt?: AgenticWorkflowPromptJson;
-  readonly llm_model?: AgenticWorkflowLLMModelJson;
+/** @internal */
+export type AgenticWorkflowHumanInTheLoopChoicesJson = {
+    readonly items: {
+        readonly label: string;
+        readonly value: string;
+    }[];
+    readonly source: "fixed";
+} | {
+    readonly reference: string;
+    readonly source: "reference";
 };
 
-export type AgenticWorkflowHumanInTheLoopNodeJson = AgenticWorkflowBaseNodeJson<"hitl_node">
-  & {
-  readonly conditions?: AgenticWorkflowConditionJson[];
-  readonly enable_feedback: boolean;
-  readonly human_input_description: string;
-  readonly human_input_description_type?: "dynamic" | "fixed";
+/** @internal */
+export type AgenticWorkflowHumanInTheLoopFreeTextJson = {
+  readonly enabled: boolean;
+  readonly maxLength?: number;
+  readonly placeholder?: string;
 };
 
+/** @internal */
 export type AgenticWorkflowLoopNodeJson = AgenticWorkflowBaseNodeJson<"loop_node">
   & {
   readonly loop_back_node_id: AgenticWorkflowNodeIdJson;
   readonly max_loop_count: number;
 };
 
+/** @internal */
 export type AgenticWorkflowConditionJson = AgenticWorkflowJsonObject
   & {
-  readonly preset?: "process" | "reject";
+  readonly outcome: "confirmed" | "dismissed";
   readonly source_anchor_id: AgenticWorkflowSourceAnchorIdJson;
 };
 
+/** @internal */
 export type AgenticWorkflowPromptJson = AgenticWorkflowJsonObject
   & {
   readonly content?: string;
 };
 
+/** @internal */
 export type AgenticWorkflowStructuredJsonSchemaJson = AgenticWorkflowJsonObject
   & {
   readonly properties: Record<string, AgenticWorkflowStructuredJsonPropertyJson>;
@@ -118,6 +173,7 @@ export type AgenticWorkflowStructuredJsonSchemaJson = AgenticWorkflowJsonObject
   readonly additionalProperties: boolean;
 };
 
+/** @internal */
 export type AgenticWorkflowStructuredJsonPropertyJson = AgenticWorkflowJsonObject
   & {
   readonly description?: string;
@@ -129,8 +185,18 @@ export type AgenticWorkflowStructuredJsonPropertyJson = AgenticWorkflowJsonObjec
   readonly additionalProperties?: boolean;
 };
 
+/** @internal */
 export type AgenticWorkflowToolJson = AgenticWorkflowArcgisToolJson | AgenticWorkflowMcpToolJson;
 
+/** @internal */
+export type AgenticWorkflowArcgisToolJson = AgenticWorkflowJsonObject
+  & {
+  readonly type: "arcgis_tool";
+  readonly name: string;
+  readonly require_approval: AgenticWorkflowApprovalRequirementJson;
+};
+
+/** @internal */
 export type AgenticWorkflowMcpToolJson = AgenticWorkflowJsonObject
   & {
   readonly allowed_tools?: string[];
@@ -148,14 +214,17 @@ export type AgenticWorkflowMcpToolJson = AgenticWorkflowJsonObject
   readonly type: "mcp";
 };
 
+/** @internal */
 export type AgenticWorkflowApprovalRequirementJson = "always" | "never";
 
+/** @internal */
 export type AgenticWorkflowUpdateVariableJson = AgenticWorkflowJsonObject
   & {
   readonly key: string;
   readonly value: AgenticWorkflowExpressionValueJson;
 };
 
+/** @internal */
 export type AgenticWorkflowExpressionValueJson = AgenticWorkflowJsonObject
   & {
   readonly return_type?: "array" | "boolean" | "number" | "object" | "string" | "unknown";
@@ -163,18 +232,21 @@ export type AgenticWorkflowExpressionValueJson = AgenticWorkflowJsonObject
   readonly value: boolean | number | string;
 };
 
+/** @internal */
 export type AgenticWorkflowMcpToolAuthBearerJson = {
   mode: string;
   header_name?: string;
   scheme?: string;
 };
 
+/** @internal */
 export type AgenticWorkflowMcpToolAuthAPIKeyJson = {
   mode: string;
   header_name?: string;
   prefix?: string;
 };
 
+/** @internal */
 export type AgenticWorkflowMcpToolAuthOAuth2Json = {
   mode: string;
   discovery?: string;
@@ -184,6 +256,4 @@ export type AgenticWorkflowMcpToolAuthOAuth2Json = {
   refresh_url?: string;
   redirect_url?: string;
   scope?: string;
-};
-
-export type AgenticWorkflowJsonPrimitive = boolean | number | string | null;
+};

package/dist/agents/agents/arcgisKnowledge/graph/arcgisKnowledgeGraph.d.ts

@@ -0,0 +1,8 @@
+import type { AgentRegistration } from "../../../../orchestrator/types.js";
+
+/**
+ * Built-in knowledge graph agent.
+ *
+ * @internal
+ */
+export const ArcgisKnowledgeAgent: AgentRegistration;

package/dist/{chunks → agents/agents/arcgisKnowledge/graph}/arcgisKnowledgeGraph.js

@@ -1,21 +1,13 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { StateGraph as x, START as k, END as c, Command as b } from "@langchain/langgraph/web";
-import { a as K, c as _, b as T, d as A, e as S, s as M, q as v, g as u, f as q, t as g, r as C, h as E, G, i as m } 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 N, e as R } from "./generateLayerDescriptions.js";
+import { a as K, c as _, g as T, b as A, d as S, s as M, q as v, e as q, f as C, G as E, h as u } from "../../../../chunks/adapter2.js";
+import { invokeToolPrompt as G, invokeTextPrompt as N } from "../../../../orchestrator/models/prompts.js";
+import { g as m } from "../../../../chunks/getPrompt.js";
+import { t as g } from "../../../../chunks/textFormatters.js";
+import { ToolNode as R } from "@langchain/langgraph/prebuilt";
+import { sendTraceMessage as p, sendUXSuggestion as L } from "../../../../orchestrator/signals.js";
+import { r as z } from "../../../../chunks/requireAgentServices.js";
 import { AIMessage as y } from "@langchain/core/messages";
-import "@langchain/core/callbacks/dispatch/web";
-import "@langchain/core/callbacks/base";
-import "@langchain/openai";
-import "@arcgis/core/config.js";
-import "@arcgis/core/core/reactiveUtils.js";
-import "@arcgis/core/layers/FeatureLayer.js";
-import { ToolNode as L } from "@langchain/langgraph/prebuilt";
-import { s as p, a as z } from "./index.js";
-import "@langchain/core/prompts";
 const w = [
   K,
   _,
@@ -26,18 +18,18 @@ const w = [
   v
 ];
 async function D(e, t) {
-  const o = await u("arcgis_knowledge_tool_prompt"), s = q(t), n = {
+  const o = await m("arcgis_knowledge_tool_prompt"), s = q(t), n = {
     assignedTask: e.agentExecutionContext.assignedTask,
     userRequest: e.agentExecutionContext.userRequest,
     priorSteps: e.agentExecutionContext.priorSteps,
     contextType: s
-  }, r = await N({
+  }, r = await G({
     promptText: o,
     messages: e.arcgisKnowledgeMessages,
     inputVariables: n,
     tools: w,
     config: t
-  }), l = (r.tool_calls?.length ?? 0) > 0, a = typeof r.text == "string" ? r.text.trim() : "", i = a.length > 0, d = r.content.toString();
+  }), l = (r.tool_calls?.length ?? 0) > 0, a = typeof r.text == "string" ? r.text.trim() : "", i = a.length > 0, d = r.text;
   return !l && (s === "map" || s === "knowledgeGraph") ? {
     ...e,
     arcgisKnowledgeMessages: [...e.arcgisKnowledgeMessages, r],
@@ -70,7 +62,7 @@ function $(e) {
   };
 }
 async function I(e, t) {
-  const o = new L(w, { handleToolErrors: !1 });
+  const o = new R(w, { handleToolErrors: !1 });
   try {
     const s = await o.invoke(
       {
@@ -104,7 +96,7 @@ async function I(e, t) {
       t
     );
     const r = n.filter((a) => typeof a != "string").map((a) => `- Called Tool: ${a.toolName}, Status: ${a.status}`), l = n[0];
-    return l && F(l) && await z($(l), t), {
+    return l && F(l) && await L($(l), t), {
       ...e,
       outputMessage: r.join(`
 `),
@@ -129,20 +121,20 @@ async function I(e, t) {
 }
 const V = (e, t) => (
   //agent services (ex: embeddingsWorker) would go in the array below, if required.
-  C([], "ArcgisKnowledge Agent")(e, t)
+  z([], "ArcgisKnowledge Agent")(e, t)
 );
 async function O(e, t) {
   const s = (e.arcgisKnowledgeToolResult ?? []).map((d) => ({
     ...d,
     details: void 0
     // Remove details to avoid overwhelming the LLM with too much info
-  })), { knowledgeGraph: n } = await E(t), r = G.getDataModelTypesSummary(n.dataModel), l = {
+  })), { knowledgeGraph: n } = await C(t), r = E.getDataModelTypesSummary(n.dataModel), l = {
     assignedTask: e.agentExecutionContext.assignedTask,
     userRequest: e.agentExecutionContext.userRequest,
     toolResult: s,
     dataModelSummary: r
-  }, a = await R({
-    promptText: await u("arcgis_knowledge_summarize_result_prompt"),
+  }, a = await N({
+    promptText: await m("arcgis_knowledge_summarize_result_prompt"),
     modelTier: "default",
     inputVariables: l,
     config: t
@@ -175,7 +167,7 @@ function h(e) {
     }
   })) : await e(t, o);
 }
-const j = () => new x(m).addNode("requireArcgisKnowledgeServices", V).addNode("agent", h(D)).addNode("tools", h(I)).addNode("summarizationLLM", h(O)).addNode("finalizeToolSummary", h(P)).addEdge(k, "requireArcgisKnowledgeServices").addEdge("requireArcgisKnowledgeServices", "agent").addConditionalEdges("agent", (t) => (t.arcgisKnowledgeMessages[t.arcgisKnowledgeMessages.length - 1]?.tool_calls?.length ?? 0) > 0 ? "tools" : c).addConditionalEdges("tools", (t) => {
+const j = () => new x(u).addNode("requireArcgisKnowledgeServices", V).addNode("agent", h(D)).addNode("tools", h(I)).addNode("summarizationLLM", h(O)).addNode("finalizeToolSummary", h(P)).addEdge(k, "requireArcgisKnowledgeServices").addEdge("requireArcgisKnowledgeServices", "agent").addConditionalEdges("agent", (t) => (t.arcgisKnowledgeMessages[t.arcgisKnowledgeMessages.length - 1]?.tool_calls?.length ?? 0) > 0 ? "tools" : c).addConditionalEdges("tools", (t) => {
   if (t.status === "failed")
     return c;
   const o = t.arcgisKnowledgeToolResult?.[0];
@@ -218,13 +210,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?"_`, de = {
-  id: "arcgisKnowledge",
+_example: "What is the average age of all people who work for Esri?"_`, te = {
+  id: "knowledge",
   name: "ArcgisKnowledge Agent",
   description: J,
   createGraph: j,
-  workspace: m
+  workspace: u
 };
 export {
-  de as A
+  te as ArcgisKnowledgeAgent
 };

package/dist/agents/agents/dataExploration/dataExplorationAgent.d.ts

@@ -0,0 +1,18 @@
+import type MapView from "@arcgis/core/views/MapView.js";
+import type { AgentRegistration } from "../../../orchestrator/types.js";
+
+/**
+ * Context supplied to the Data Exploration agent.
+ *
+ * @internal
+ */
+export type DataExplorationContext = {
+  mapView: MapView;
+};
+
+/**
+ * Built-in data exploration agent.
+ *
+ * @internal
+ */
+export const DataExplorationAgent: AgentRegistration;

package/dist/agents/agents/dataExploration/dataExplorationAgent.js

@@ -0,0 +1,17 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { c as e } from "../../../chunks/createSkillAgent.js";
+const t = [
+  async () => (await import("../../../chunks/SKILL2.js")).default,
+  async () => (await import("../../../chunks/SKILL.js")).default
+], s = e({
+  id: "data-exploration",
+  name: "Data Exploration Agent",
+  description: "Explores feature-layer data and applies data-driven map filters using on-demand query and filter skills.",
+  skillLoaders: t,
+  modelTier: "default",
+  systemPrompt: "You are an ArcGIS data exploration agent.",
+  instructions: "Answer only questions about the current map's layers, features, fields, spatial relationships, or supported map actions, using returned tool results. Do not answer unrelated general-knowledge, advice, opinion, political, health, security, or other non-map requests, even when the user asks for this agent. For an unsupported request, respond only: 'I can help with questions about the data and features in this map.' Report directly relevant findings, requested calculations, and limitations that affect the answer. Do not provide unsolicited advice about dataset design, publishing, classification, grouping, future analysis, or alternative questions. Ask a clarifying question only when a map-related request cannot be answered reliably as written. A request can require both query and filter skills. Treat show, display, highlight, map, filter, reveal, emphasize, include, or exclude as visual map intent when the request targets matching features. For visual map intent, do not stop after query. First use query to identify/count the matching features, then load the filter skill and call setFeatureEffect with the same layer, where clause, geometry filter, extent setting, or object IDs. Use only tool results to describe data or map changes."
+});
+export {
+  s as DataExplorationAgent
+};

package/dist/agents/agents/dataExplorationGraph/graph/dataExplorationGraph.d.ts

@@ -0,0 +1,8 @@
+import type { AgentRegistration } from "../../../../orchestrator/types.js";
+
+/**
+ * Built-in graph-based data exploration agent.
+ *
+ * @internal
+ */
+export const DataExplorationGraphAgent: AgentRegistration;