@arcgis/ai-components 5.2.0-next.105 → 5.2.0-next.107

package/dist/chunks/aiFactory.js

@@ -0,0 +1,94 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
+import { ChatOpenAI as E, OpenAIEmbeddings as U } from "@langchain/openai";
+import p from "@arcgis/core/portal/Portal.js";
+import h from "@arcgis/core/request.js";
+import b from "@arcgis/core/identity/IdentityManager.js";
+import { generateGuid as I } from "@arcgis/toolkit/string";
+import q from "@arcgis/core/config.js";
+const y = {
+  advanced: "gpt-5.6-sol",
+  default: "gpt-5.6-terra",
+  fast: "gpt-5.6-luna"
+}, w = {
+  default: "text-embedding-ada-002"
+}, f = /* @__PURE__ */ new Map();
+let i = null;
+const R = () => {
+  const t = p.getDefault().helperServices;
+  if (!t?.aiModels?.url)
+    throw new Error("AI Models Service URL is not defined in the portal's helper services.");
+  return t.aiModels.url;
+}, S = async (e) => {
+  const t = R();
+  f.size === 0 && (i || (i = (async () => {
+    try {
+      (await h(`${t}/models`)).data.models.forEach((s) => f.set(s.name, s));
+    } catch (r) {
+      throw i = null, r;
+    }
+  })()), await i);
+  const o = f.get(e);
+  if (!o)
+    throw new Error(`Model '${e}' is not available in the discovery service.`);
+  return o.endpoint;
+}, C = async (e = "default") => await S(y[e]), A = async (e = "default") => await S(w[e]), k = (e) => typeof e == "string" && e.length > 0 ? e : void 0, D = () => I(), F = (e) => typeof e != "string" || e.trim().length === 0 ? "MapsSDK" : `MapsSDK - ${e.trim()}`, K = (e) => {
+  const t = e?.configurable;
+  return {
+    conversationId: k(t?.thread_id),
+    abortSignal: e?.signal,
+    requestId: D(),
+    requestSource: F(q.applicationName)
+  };
+}, L = (e) => {
+  if (e == null || typeof e == "string" || e instanceof FormData || e instanceof HTMLFormElement)
+    return e;
+  if (e instanceof URLSearchParams)
+    return e.toString();
+  throw new TypeError(`Unsupported request body type: ${Object.prototype.toString.call(e)}`);
+}, v = async ({ config: e }) => {
+  const t = p.getDefault(), o = await b.getCredential(`${t.url}/sharing`);
+  return async (r, n) => {
+    const { conversationId: s, abortSignal: c, requestId: g, requestSource: l } = K(e), a = new Headers(n?.headers);
+    for (const m of [...a.keys()]) {
+      const u = m.toLowerCase();
+      (u === "authorization" || u === "api-key" || u.startsWith("x-stainless-")) && a.delete(m);
+    }
+    const d = o?.token;
+    d && d.length > 0 && a.set("X-Esri-Authorization", `Bearer ${d}`), t.isPortal || (l && l.length > 0 && a.set("X-Esri-Request-Source", l), s && s.length > 0 && a.set("X-Esri-Conversation-Id", s), g.length > 0 && a.set("X-Esri-Request-Id", g));
+    const M = c && n?.signal ? AbortSignal.any([c, n.signal]) : n?.signal ?? c;
+    return (await h(r instanceof Request ? r.url : r.toString(), {
+      body: L(n?.body),
+      headers: Object.fromEntries(a),
+      responseType: "native",
+      signal: M
+    })).data;
+  };
+}, B = async (e = {}) => {
+  const { modelTier: t = "default", config: o } = e, r = y[t], n = await C(t);
+  return new E({
+    modelName: r,
+    apiKey: "dummy-key",
+    configuration: {
+      baseURL: n,
+      fetch: await v({ config: o })
+    }
+  });
+}, j = async (e = {}) => {
+  const { tier: t = "default", config: o } = e, r = w[t], n = await A(t);
+  return new U({
+    modelName: r,
+    apiKey: "dummy-key",
+    configuration: {
+      baseURL: n,
+      fetch: await v({ config: o })
+    },
+    batchSize: 2048,
+    maxConcurrency: 10
+  });
+};
+export {
+  w as E,
+  j as a,
+  B as c,
+  A as g
+};

package/dist/chunks/arcgisKnowledgeGraph.js

@@ -1,11 +1,11 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/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 { a as K, c as _, g as T, b as A, d as S, s as M, q as v, e as u, f as q, t as g, h as C, G as E, 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 { i as G, a as N } from "./generateLayerDescriptions.js";
 import { AIMessage as y } from "@langchain/core/messages";
 import "@langchain/core/callbacks/dispatch/web";
 import "@langchain/core/callbacks/base";
@@ -13,9 +13,10 @@ 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 { ToolNode as R } from "@langchain/langgraph/prebuilt";
+import { s as p, a as L } from "./index.js";
 import "@langchain/core/prompts";
+import { r as z } from "./requireAgentServices.js";
 const w = [
   K,
   _,
@@ -31,13 +32,13 @@ async function D(e, t) {
     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.text;
+  }), l = (r.tool_calls?.length ?? 0) > 0, a = typeof r.text == "string" ? r.text.trim() : "", i = a.length > 0, d = r.content.toString();
   return !l && (s === "map" || s === "knowledgeGraph") ? {
     ...e,
     arcgisKnowledgeMessages: [...e.arcgisKnowledgeMessages, r],
@@ -70,7 +71,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 +105,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,19 +130,19 @@ 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({
+  }, a = await N({
     promptText: await u("arcgis_knowledge_summarize_result_prompt"),
     modelTier: "default",
     inputVariables: l,
@@ -218,7 +219,7 @@ _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 = {
+_example: "What is the average age of all people who work for Esri?"_`, ce = {
   id: "arcgisKnowledge",
   name: "ArcgisKnowledge Agent",
   description: J,
@@ -226,5 +227,5 @@ _example: "What is the average age of all people who work for Esri?"_`, de = {
   workspace: m
 };
 export {
-  de as A
+  ce as A
 };

package/dist/chunks/arcgisToolRegistry.js

@@ -0,0 +1,88 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
+const a = /* @__PURE__ */ new Map([
+  [
+    "clearFilters",
+    async () => (await import("../agents/tools/filter/clearFilters/adapter.js")).clearFiltersTool
+  ],
+  [
+    "resetMap",
+    async () => (await import("../agents/tools/filter/resetMap/adapter.js")).resetMapTool
+  ],
+  [
+    "setFeatureEffect",
+    async () => (await import("../agents/tools/filter/setFeatureEffect/adapter.js")).setFeatureEffectTool
+  ],
+  [
+    "listLayerFields",
+    async () => (await import("../agents/tools/help/listFields/adapter.js")).listLayerFieldsTool
+  ],
+  [
+    "goToAddress",
+    async () => (await import("../agents/tools/navigation/goToAddress/adapter.js")).goToAddressTool
+  ],
+  [
+    "goToBookmark",
+    async () => (await import("../agents/tools/navigation/goToBookmark/adapter.js")).goToBookmarkTool
+  ],
+  [
+    "goToFeatures",
+    async () => (await import("../agents/tools/navigation/goToFeatures/adapter.js")).goToFeaturesTool
+  ],
+  [
+    "goToFullExtent",
+    async () => (await import("../agents/tools/navigation/goToFullExtent/adapter.js")).goToFullExtentTool
+  ],
+  [
+    "goToHomeExtent",
+    async () => (await import("../agents/tools/navigation/goToHomeExtent/adapter.js")).goToHomeExtentTool
+  ],
+  [
+    "goToLayer",
+    async () => (await import("../agents/tools/navigation/goToLayer/adapter.js")).goToLayerTool
+  ],
+  [
+    "goToScale",
+    async () => (await import("../agents/tools/navigation/goToScale/adapter.js")).goToScaleTool
+  ],
+  [
+    "goToViewpoint",
+    async () => (await import("../agents/tools/navigation/goToViewpoint/adapter.js")).goToViewpointTool
+  ],
+  [
+    "goToZoom",
+    async () => (await import("../agents/tools/navigation/goToZoom/adapter.js")).goToZoomTool
+  ],
+  [
+    "findRelevantFields",
+    async () => (await import("../agents/tools/search/findRelevantFields/adapter.js")).findRelevantFieldsTool
+  ],
+  [
+    "findRelevantLayers",
+    async () => (await import("../agents/tools/search/findRelevantLayers/adapter.js")).findRelevantLayersTool
+  ],
+  [
+    "getAttribute",
+    async () => (await import("../agents/tools/query/getAttribute/adapter.js")).getAttributeTool
+  ],
+  [
+    "getStatistics",
+    async () => (await import("../agents/tools/query/getStatistics/adapter.js")).getStatisticsTool
+  ],
+  [
+    "getTopFeatures",
+    async () => (await import("../agents/tools/query/getTopFeatures/adapter.js")).getTopFeaturesTool
+  ],
+  [
+    "queryFeatures",
+    async () => (await import("../agents/tools/query/queryFeatures/adapter.js")).queryFeaturesTool
+  ]
+]);
+async function e(o) {
+  const t = a.get(o);
+  if (!t)
+    throw new Error(`"${o}" tool not found`);
+  return await t();
+}
+export {
+  e as r
+};

package/dist/chunks/arcgis_knowledge_current_lc_context.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 const e = `## Membership Bind Parameters
 
 The current link chart contains a subset of entities and relationships from the database. Their membership is available to Cypher queries as lists of string identifiers through these bind parameters:

package/dist/chunks/arcgis_knowledge_current_map_context.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 const e = `## Membership Bind Parameters
 
 The current map contains a subset of entities and relationships from the database. Their membership is available to Cypher queries as lists of string identifiers through these bind parameters:

package/dist/chunks/arcgis_knowledge_cypher_query_prompt.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 const e = `# ArcGIS Knowledge Graph Cypher Rules
 
 ## GOAL

package/dist/chunks/arcgis_knowledge_lucene_generation_prompt.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 const e = `## ArcgisKnowledge Agent - Lucene Generation for Graph Search
 
 You are an assistant that generates a lucene query for graph query searching.

package/dist/chunks/arcgis_knowledge_summarize_result_prompt.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 const n = `# ArcGIS Knowledge Agent — Action Summary
 
 You are a Knowledge Graph assistant that has executed tool calls to answer a user request.

package/dist/chunks/arcgis_knowledge_tool_prompt.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 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.

package/dist/chunks/baseAgentState.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import { Annotation as r } from "@langchain/langgraph/web";
 const a = (e, t) => t, c = (e, t) => ({
   ...e,
@@ -50,9 +50,9 @@ ${s}`;
 }), g = () => i();
 export {
   i as a,
-  g as b,
+  o as b,
   d as c,
-  o as d,
+  g as d,
   c as m,
   a as r
 };

package/dist/chunks/converterUtils.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import w from "@esri/arcgis-html-sanitizer";
 import { marked as S } from "marked";
 S.use({

package/dist/chunks/dataExplorationAgent.js

@@ -0,0 +1,19 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
+import { createSkillAgent as e } from "../agents/runtime/skill/createSkillAgent.js";
+const t = [
+  async () => (await import("./SKILL.js")).default,
+  async () => (await import("./SKILL2.js")).default
+], r = e({
+  id: "dataExploration",
+  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: "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.",
+  fallbackMessage: "Data exploration request completed.",
+  failureMessage: "I couldn't complete the data exploration request."
+});
+export {
+  r as D
+};

package/dist/chunks/data_explore_filter_prompt.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 const e = `# ArcGIS Online Map Viewer — Layer Filter Tool Calling Assistant
 
 You are an assistant that helps manage layer filters and visual effects for **ArcGIS Online Map Viewer** by selecting and calling the appropriate tool.

package/dist/chunks/data_explore_query_prompt.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 const e = `# ArcGIS JavaScript SDK FeatureLayerView Query Assistant
 
 You are a GIS assistant that generates query parameters for the ArcGIS JavaScript SDK FeatureLayerView \`queryFeatures()\` method.

package/dist/chunks/embeddings.worker.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 const o = `(function(){"use strict";const h=(a,r)=>{if(a.length!==r.length)throw new Error("Vectors must be the same length");let c=0,t=0,e=0;for(let n=0;n<a.length;++n){const s=a[n],l=r[n];c+=s*l,t+=s*s,e+=l*l}const i=Math.sqrt(t*e);if(i===0)return 0;const m=c/i;return Math.max(-1,Math.min(1,m))},f=(a,r,c=.6)=>{const t=[],e=[...a];for(;t.length<r&&e.length>0;){let i=-1,m=-1/0;for(let n=0;n<e.length;n++){const s=e[n].score,l=t.length===0?0:Math.max(...t.map(o=>h(e[n].vector,o.vector))),d=c*s-(1-c)*l;d>m&&(m=d,i=n)}t.push(e[i]),e.splice(i,1)}return t.map(({name:i,score:m})=>({name:i,score:m}))};let p=[];const u=new Map,v=12,y=10,M=a=>{p=a.layers.map(r=>({id:r.id,vector:r.vector}))},E=a=>{u.clear();for(const r of a.layers){const c=r.fields.map(t=>({name:t.name,vector:t.vector}));u.set(r.id,c)}};globalThis.addEventListener("message",a=>{(async()=>{const{type:r,webmapEmbeddings:c,layerIdForFieldsSearch:t=[],requestId:e,precomputedEmbedding:i,minScore:m=0,topResults:n=v}=a.data;switch(r){case"generateEmbeddings":{c&&(M(c),E(c)),globalThis.postMessage("completed");break}case"layerSearch":{if(p.length>0)try{const s=p.map(o=>({id:o.id,vector:o.vector,score:h(i,o.vector)})),d=f(s.map(o=>({name:o.id,vector:o.vector,score:o.score})),y).map(({name:o,score:b})=>({id:o,score:b}));globalThis.postMessage({requestId:e,results:d})}catch(s){globalThis.postMessage({requestId:e,results:[],error:s instanceof Error?s.message:"Calculation error"})}else globalThis.postMessage({requestId:e,results:[],error:"Layer embeddings not initialized"});break}case"fieldSearch":{if(t.length>0)try{const s=t.map(l=>{const d=u.get(l);if(!d)return{layerId:l,results:[]};const o=d.map(g=>({name:g.name,vector:g.vector,score:h(i,g.vector)})).filter(({score:g})=>g>=m),b=f(o,n);return{layerId:l,results:b}});globalThis.postMessage({requestId:e,results:s})}catch(s){globalThis.postMessage({requestId:e,results:[],error:s instanceof Error?s.message:"Field search calculation error"})}break}default:console.warn("Unknown message type:",r)}})()})})();
 `, s = typeof self < "u" && self.Blob && new Blob(["(self.URL || self.webkitURL).revokeObjectURL(self.location.href);", o], { type: "text/javascript;charset=utf-8" });
 function a(r) {

package/dist/chunks/fetchAgentContext.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 function c(e, o) {
   const t = e?.configurable?.context;
   if (!t || typeof t != "object")

package/dist/chunks/fetchService.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 const i = (s, e) => {
   const r = s?.configurable?.services?.[e];
   if (r == null)

package/dist/chunks/fieldStatistics.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import v from "@arcgis/core/smartMapping/statistics/summaryStatistics.js";
 import L from "@arcgis/core/smartMapping/statistics/uniqueValues.js";
 const $ = 10, b = ["string", "small-integer", "integer"], w = async (u, e, { includeSummaryStatistics: d = !0, includeUniqueValues: y = !0 } = {}) => {

package/dist/chunks/field_descriptions_prompt.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 const e = `You are a knowledgeable GIS expert.
 
 You are given a Feature Service description and title.

package/dist/chunks/formatFeatureAttributes.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import { formatDateOnly as F, convertDateFormatToIntlOptions as m, formatTimeOnly as T, formatDate as p } from "@arcgis/core/intl.js";
 const w = /* @__PURE__ */ new Set([
   "date",