@arcgis/ai-components 5.1.0-next.1 → 5.1.0-next.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cdn/{SLRL7NB7.js → 3ESJRLJ5.js} +26 -20
- package/dist/cdn/{FVVYK5KV.js → JZEJNNTI.js} +1 -1
- package/dist/cdn/{GLPXJC3A.js → M2EZXXBA.js} +1 -1
- package/dist/cdn/{ZV2N427X.js → WQK36HD5.js} +1 -1
- package/dist/cdn/{ZIHS43OH.js → ZATIKKBO.js} +1 -1
- package/dist/cdn/{KSJNIOUZ.js → ZSWFMMCM.js} +1 -1
- package/dist/cdn/index.js +1 -1
- package/dist/docs/api.json +1 -1
- package/dist/docs/docs.json +1 -1
- package/dist/docs/web-types.json +1 -1
- package/package.json +6 -6
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
|
|
2
|
-
import a from"./JOZLOFW3.js";export default $arcgis.t(([mt,he,De,ft,{addressToLocations:gt},Pe,V,Y,me,fe,Ge,Be,ge,Qe,{createRenderer:yt},{getSchemesByTag:pt,getSchemes:wt},{getBackgroundColorTheme:
|
|
3
|
-
Please fix your mistakes.`,name:e.name,tool_call_id:e.id??""})}}async run(e,r){let t;if(dt(e))t=[await this.runTool(e.lg_tool_call,r)];else{let i;if(
|
|
2
|
+
import a from"./JOZLOFW3.js";export default $arcgis.t(([mt,he,De,ft,{addressToLocations:gt},Pe,V,Y,me,fe,Ge,Be,ge,Qe,{createRenderer:yt},{getSchemesByTag:pt,getSchemes:wt},{getBackgroundColorTheme:ke},{createAgeRenderer:bt,createContinuousRenderer:vt},{getSchemesByTag:ye},{createContinuousRenderer:St},{createRenderer:Tt},{getSchemesByTag:Et},{createRenderer:xt},{getSchemesByTag:It},{createRenderer:Lt},{getSchemesByTag:$t},{createRenderer:Ft},{getSchemesByTag:_t},{createAgeRenderer:Nt,createContinuousRenderer:kt},{createRenderer:qt},{getSchemesByTag:At},We,qe,Ae,P,{executeQueryStreaming:Rt},Mt,{a:xe,b:Ie,c:O,d:te,e:re,f:j,g:D,h:N,i:p,j:y,k:k,l:E,m:Le,n:U,o:J,p:$e,q:L,r:q,s:s,t:h,u:x,v:ae,w:Fe,x:z}])=>{var Ne=e=>Array.isArray(e)&&e.every(O),ct=e=>typeof e=="object"&&e!=null&&"messages"in e&&Ne(e.messages),dt=e=>typeof e=="object"&&e!=null&&"lg_tool_call"in e,A=class extends $e{tools;handleToolErrors=!0;trace=!1;constructor(e,r){let{name:t,tags:a,handleToolErrors:o}=r??{};super({name:t,tags:a,func:(i,n)=>this.run(i,n)}),this.tools=e,this.handleToolErrors=o??this.handleToolErrors}async runTool(e,r){let t=this.tools.find(a=>a.name===e.name);try{if(t===void 0)throw new Error(`Tool "${e.name}" not found.`);let a=await t.invoke({...e,type:"tool_call"},r);return O(a)&&a.getType()==="tool"||J(a)?a:new te({status:"success",name:t.name,content:typeof a=="string"?a:JSON.stringify(a),tool_call_id:e.id})}catch(a){if(!this.handleToolErrors||Ie(a))throw a;return new te({status:"error",content:`Error: ${a.message}
|
|
3
|
+
Please fix your mistakes.`,name:e.name,tool_call_id:e.id??""})}}async run(e,r){let t;if(dt(e))t=[await this.runTool(e.lg_tool_call,r)];else{let i;if(Ne(e))i=e;else if(ct(e))i=e.messages;else throw new Error("ToolNode only accepts BaseMessage[] or { messages: BaseMessage[] } as input.");let n=new Set(i.filter(c=>c.getType()==="tool").map(c=>c.tool_call_id)),l;for(let c=i.length-1;c>=0;c-=1){let d=i[c];if(D(d)){l=d;break}}if(l==null||!D(l))throw new Error("ToolNode only accepts AIMessages as input.");t=await Promise.all(l.tool_calls?.filter(c=>c.id==null||!n.has(c.id)).map(c=>this.runTool(c,r))??[])}if(!t.some(J))return Array.isArray(e)?t:{messages:t};let a=[],o=null;for(let i of t)J(i)?i.graph===U.PARENT&&Array.isArray(i.goto)&&i.goto.every(n=>Le(n))?o?o.goto.push(...i.goto):o=new U({graph:U.PARENT,goto:i.goto}):a.push(i):a.push(Array.isArray(e)?[i]:{messages:[i]});return o&&a.push(o),a}};var as=y.Root({llmInputMessages:y({reducer:(e,r)=>L([],r),default:()=>[]})});var Ke=y.Root({messages:y({reducer:L,default:()=>[]}),outputMessage:y({reducer:(e="",r)=>{let t=typeof r=="string"?r.trim():"";if(!t)return e;let a=e.trim();if(!a)return t;if(a===t)return e;let o=a.split(`
|
|
4
4
|
|
|
5
5
|
`);return o[o.length-1]?.trim()===t?e:`${e}
|
|
6
6
|
|
|
7
|
-
${t}`},default:()=>""}),intent:y({reducer:(e,r)=>r}),vectorSearchLayerResults:y({reducer:(e,r)=>r,default:()=>[]}),vectorSearchFieldResults:y({reducer:(e,r)=>r})});async function zt(e,r){let t="https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer";console.log(`[goToAddress] Geocoding: ${e}`);let a=(await gt(t,{address:{SingleLine:e},outFields:["Match_addr"]}))?.[0];if(!a?.extent)throw new Error(`Could not find location for: ${e}`);let{xmin:o,ymin:i,xmax:n,ymax:l,spatialReference:c}=a.extent,d=new De({xmin:o,ymin:i,xmax:n,ymax:l,spatialReference:c}),u=(o+n)/2,m=(i+l)/2,f=new he({x:u,y:m,spatialReference:c}),g=new ft({style:"circle",color:"red",size:12}),w=new mt({geometry:f,symbol:g});return r.graphics.removeAll(),r.graphics.add(w),await r.goTo(d),`Successfully zoomed to: ${a.address}. Location coordinates: x=${u}, y=${m}, wkid=${c.wkid}`}var Ct=["mapView"];function $(e){let r=e?.configurable?.context;if(!r||typeof r!="object")throw new Error("NavigationAgent context missing");let t=Ct.filter(a=>!(a in r));if(t.length)throw new Error(`NavigationAgent context missing: ${t.join(", ")}`);return r}async function jt({address:e},r){let{mapView:t}=$(r);return await zt(e,t)}var Vt=s.object({address:s.string().describe("The full address or place name to locate.")}),Ot=p(jt,{name:"goToAddress",description:"Geocodes an address using Esri's World Geocoding Service and zooms the map to that location.",schema:Vt});async function Dt(e,r){let t=r.map.bookmarks;if(!t||t.length===0)throw new Error("No bookmarks found in the map.");let a=t.find(i=>i.name===e);if(!a)throw new Error(`Bookmark with name "${e}" not found.`);let o=a.viewpoint;if(!o)throw new Error(`Bookmark with name "${e}" does not have a valid viewpoint.`);return await r.goTo(o),`Navigated to bookmark: ${e}`}async function Pt({bookmarkName:e},r){let{mapView:t}=$(r);return await Promise.resolve(Dt(e,t))}var Gt=
|
|
7
|
+
${t}`},default:()=>""}),intent:y({reducer:(e,r)=>r}),vectorSearchLayerResults:y({reducer:(e,r)=>r,default:()=>[]}),vectorSearchFieldResults:y({reducer:(e,r)=>r})});async function zt(e,r){let t="https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer";console.log(`[goToAddress] Geocoding: ${e}`);let a=(await gt(t,{address:{SingleLine:e},outFields:["Match_addr"]}))?.[0];if(!a?.extent)throw new Error(`Could not find location for: ${e}`);let{xmin:o,ymin:i,xmax:n,ymax:l,spatialReference:c}=a.extent,d=new De({xmin:o,ymin:i,xmax:n,ymax:l,spatialReference:c}),u=(o+n)/2,m=(i+l)/2,f=new he({x:u,y:m,spatialReference:c}),g=new ft({style:"circle",color:"red",size:12}),w=new mt({geometry:f,symbol:g});return r.graphics.removeAll(),r.graphics.add(w),await r.goTo(d),`Successfully zoomed to: ${a.address}. Location coordinates: x=${u}, y=${m}, wkid=${c.wkid}`}var Ct=["mapView"];function $(e){let r=e?.configurable?.context;if(!r||typeof r!="object")throw new Error("NavigationAgent context missing");let t=Ct.filter(a=>!(a in r));if(t.length)throw new Error(`NavigationAgent context missing: ${t.join(", ")}`);return r}async function jt({address:e},r){let{mapView:t}=$(r);return await zt(e,t)}var Vt=s.object({address:s.string().describe("The full address or place name to locate.")}),Ot=p(jt,{name:"goToAddress",description:"Geocodes an address using Esri's World Geocoding Service and zooms the map to that location.",schema:Vt});async function Dt(e,r){let t=r.map.bookmarks;if(!t||t.length===0)throw new Error("No bookmarks found in the map.");let a=t.find(i=>i.name===e);if(!a)throw new Error(`Bookmark with name "${e}" not found.`);let o=a.viewpoint;if(!o)throw new Error(`Bookmark with name "${e}" does not have a valid viewpoint.`);return await r.goTo(o),`Navigated to bookmark: ${e}`}async function Pt({bookmarkName:e},r){let{mapView:t}=$(r);return await Promise.resolve(Dt(e,t))}var Gt=N.object({bookmarkName:N.string().describe("The name of the bookmark to navigate to.")}),Bt=p(Pt,{name:"goToBookmark",description:"Go to the extent of the bookmark with the given name.",schema:Gt});async function Qt(e,r,t){let a=t.map?.allLayers.find(i=>i.id===e);if(!a)return`Error: Layer with id ${e} not found`;let o=a.createQuery();o.where=r??"1=1";try{let{extent:i,count:n}=await a.queryExtent(o);if(n===0)return`No features found in ${a.title} matching: ${r}`;if(i)await t.goTo(i);else return`Error: Unable to determine extent for ${a.title}`;return`Successfully zoomed to ${n} feature(s) in ${a.title}`}catch(i){return console.error("Error in goToFeatures:",i),`Error: ${i instanceof Error?i.message:"Unknown error"}`}}async function Wt({layerId:e,where:r},t){let{mapView:a}=$(t);return await Qt(e,r,a)}var Kt=N.object({layerId:N.string().describe("The layerId of the layer to zoom to."),where:N.string().describe("The sql-92 where clause used to query features to zoom to")}),Ut=p(Wt,{name:"goToFeatures",description:"Go to the features that match the given filter related to the given layerId.",schema:Kt});async function Jt(e){let r=new De({xmin:-180,ymin:-90,xmax:180,ymax:90,spatialReference:{wkid:4326}}).expand(.7);return await e.goTo(r),"Successfully zoomed to world extent"}async function Zt(e,r){let{mapView:t}=$(r);return await Jt(t)}var Ht=N.object({}),Yt=p(Zt,{name:"goToFullExtent",description:"Zooms the map to the full world extent using Esri's Geocoding Service.",schema:Ht});async function Xt(e){let r=e.map.initialViewProperties?.viewpoint?.targetGeometry;if(r)await e.goTo(r);else throw new Error("Initial extent is undefined");return"Successfully zoomed to home extent"}async function er(e,r){let{mapView:t}=$(r);return await Xt(t)}var tr=s.object({}),rr=p(er,{name:"goToHomeExtent",description:"Go to the initial web map view extent",schema:tr});async function ar(e,r){await r.when();let t=r.map?.allLayers.find(o=>o.id===e);if(!t)return console.warn(`[goToLayer] No matching FeatureLayer found for: ${e}`),`Could not find layer for: ${e}`;console.log(`[goToLayer] Zooming to layer: ${t.title}`);let a;return(t.type==="link-chart"||t.type==="knowledge-graph-sublayer")&&r.map?.activeLinkChartLayer?a=r.map.diagramNodesExtent:a=t.fullExtent,a?(await r.goTo(a),t.visible=!0,`Successfully zoomed to: ${t.title??""}`):"Layer has no defined extent. Cannot zoom to layer."}async function or({layerId:e},r){let{mapView:t}=$(r);return await ar(e,t)}var ir=N.object({layerId:N.string().describe("The id of the layer to navigate to")}),nr=p(or,{name:"goToLayer",description:"Zooms the map view to the full extent of the top matching layer.",schema:ir});async function sr(e,r){return await r.goTo({scale:e}),`Successfully zoomed to: ${e}`}async function lr({scale:e},r){let{mapView:t}=$(r);return await sr(e,t)}var cr=s.object({scale:s.number().describe("The map scale of the view to go to.")}),dr=p(lr,{name:"goToScale",description:"Go to the specified view scale.",schema:cr});async function ur(e,r,t){let a={target:new he({longitude:e.longitude,latitude:e.latitude,spatialReference:{wkid:4326}})};return t?.zoom!==void 0&&(a.zoom=t.zoom),t?.scale!==void 0&&(a.scale=t.scale),await r.goTo(a),`Successfully navigated to: ${[`(${e.latitude}\xB0, ${e.longitude}\xB0)`,t?.zoom!==void 0?`zoom ${t.zoom}`:"",t?.scale!==void 0?`scale 1:${t.scale}`:""].filter(Boolean).join(", ")}`}async function hr({center:e,zoom:r,scale:t},a){let{mapView:o}=$(a);return await ur(e,o,{zoom:r,scale:t})}var mr=s.object({center:s.object({longitude:s.number().describe("The longitude (x-coordinate) of the point to navigate to."),latitude:s.number().describe("The latitude (y-coordinate) of the point to navigate to.")}),zoom:s.number().optional().describe("The zoom level. Higher values = more zoomed in."),scale:s.number().optional().describe("The map scale. Alternative to zoom. Smaller numbers = more zoomed in.")}),fr=p(hr,{name:"goToViewpoint",description:"Go to the specified viewpoint. This can contain a combination of scale, center, zoom, etc.",schema:mr});async function gr(e,r){return await r.goTo({zoom:e}),`Successfully zoomed to: ${e}`}async function yr({zoom:e},r){let{mapView:t}=$(r);return await gr(e,t)}var pr=s.object({zoom:s.number().min(1).max(20).describe("The zoom level of the view to go to.")}),wr=p(yr,{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:pr}),pe=[Ot,Bt,Ut,Yt,rr,nr,dr,fr,wr],Re=Object.assign({"../agents/arcgisKnowledge/prompts/arcgis_knowledge_current_lc_context.md":()=>import("./LSGRWCAO.js").then(e=>e.default),"../agents/arcgisKnowledge/prompts/arcgis_knowledge_intent_prompt.md":()=>import("./KKHKKCYH.js").then(e=>e.default),"../agents/arcgisKnowledge/prompts/arcgis_knowledge_tool_prompt.md":()=>import("./KQ6LEQHH.js").then(e=>e.default),"../agents/dataExploration/prompts/data_explore_filter_prompt.md":()=>import("./M7XUI5KY.js").then(e=>e.default),"../agents/dataExploration/prompts/data_explore_query_prompt.md":()=>import("./ZYQ6U2YH.js").then(e=>e.default),"../agents/dataExploration/prompts/summarize_query_response_prompt.md":()=>import("./SOWNHB7F.js").then(e=>e.default),"../agents/help/prompts/help_prompt.md":()=>import("./62K6RJZZ.js").then(e=>e.default),"../agents/layerFilter/prompts/layer_filter_prompt.md":()=>import("./X7WF7TCS.js").then(e=>e.default),"../agents/layerQuery/prompts/data_query_prompt.md":()=>import("./6T2EIYO4.js").then(e=>e.default),"../agents/layerQuery/prompts/summarize_query_response_prompt.md":()=>import("./HN2HMAMX.js").then(e=>e.default),"../agents/layerStyling/prompts/layer_styling_prompt.md":()=>import("./CFT5BBC6.js").then(e=>e.default),"../agents/navigation/prompts/navigation_intent_prompt.md":()=>import("./NKNUZCLA.js").then(e=>e.default),"../agents/navigation/prompts/navigation_tool_prompt.md":()=>import("./LTBEINKG.js").then(e=>e.default)});async function F(e){let r=Object.entries(Re).find(([t])=>t.endsWith(`/${e}.md`));if(console.log(`entry for prompt "${e}":`,r),!r)throw new Error(`Prompt not found: ${e}
|
|
8
8
|
Available prompts:
|
|
9
9
|
${Object.keys(Re).join(`
|
|
10
10
|
`)}`);return await r[1]()}var br=(e,r=3)=>e.filter(t=>t instanceof re).slice(-r),v=(e,r=3)=>{let t=e.map((o,i)=>o instanceof re?i:-1).filter(o=>o!==-1);if(t.length===0)return[];let a=t.length>r?t[t.length-r]:t[0];return e.slice(a)},_=(e,r=" ")=>br(e).map(t=>t.content).join(r).trim();async function vr(e,r){let t=await F("navigation_tool_prompt"),{mapView:a}=$(r),o=a.map,i=e.vectorSearchLayerResults?.length>0?e.vectorSearchLayerResults.map((w,S)=>`${S+1}. layerId=${w.id} | title=${w.title??""} | name=${w.name??""} | score=${w.score.toFixed(2)}`).join(`
|
|
@@ -20,7 +20,7 @@ ${n.map(c=>`- layerId=${c.id} | title=${c.title??""} | name=${c.name??""} | scor
|
|
|
20
20
|
${l.map(d=>`${d.layerName??d.layerId}:
|
|
21
21
|
${d.results.map(u=>` - ${u.name} (${u.score.toFixed(2)})`).join(`
|
|
22
22
|
`)}`).join(`
|
|
23
|
-
`)}`:c=`No vector search field results found for score over ${Me}.`,await h({text:c},r),{...e,vectorSearchFieldResults:l}}catch(t){throw await h({text:`Error during vector search fields: ${t instanceof Error?t.message:String(t)}`},r),t}},B=(e,r)=>(t,a)=>{let o=a?.configurable?.services;for(let i of e)if(!o?.[i])throw new Error(`${r} requires services.${i} to be available.`);return t},$r=(e,r)=>B(["layerSearch","layersAndFieldsRegistry"],"Navigation Agent")(e,r),Fr=()=>new q(Ke).addNode("requireNavigationServices",$r).addNode("intentLLM",Tr).addNode("vectorSearchLayers",xr).addNode("vectorSearchFields",Lr).addNode("agent",vr).addNode("tools",Sr).addEdge(
|
|
23
|
+
`)}`:c=`No vector search field results found for score over ${Me}.`,await h({text:c},r),{...e,vectorSearchFieldResults:l}}catch(t){throw await h({text:`Error during vector search fields: ${t instanceof Error?t.message:String(t)}`},r),t}},B=(e,r)=>(t,a)=>{let o=a?.configurable?.services;for(let i of e)if(!o?.[i])throw new Error(`${r} requires services.${i} to be available.`);return t},$r=(e,r)=>B(["layerSearch","layersAndFieldsRegistry"],"Navigation Agent")(e,r),Fr=()=>new q(Ke).addNode("requireNavigationServices",$r).addNode("intentLLM",Tr).addNode("vectorSearchLayers",xr).addNode("vectorSearchFields",Lr).addNode("agent",vr).addNode("tools",Sr).addEdge(k,"requireNavigationServices").addEdge("requireNavigationServices","intentLLM").addConditionalEdges("intentLLM",e=>e.intent==="goToLayer"||e.intent==="goToFeatures"?"vectorSearchLayers":"agent",{vectorSearchLayers:"vectorSearchLayers",agent:"agent"}).addConditionalEdges("vectorSearchLayers",e=>e.intent==="goToFeatures"?"vectorSearchFields":"agent",{vectorSearchFields:"vectorSearchFields",agent:"agent"}).addEdge("vectorSearchFields","agent").addEdge("agent","tools").addEdge("tools",E),_r=String.raw`- **navigation** — Enables users to interact with the map by navigating to specific locations, layers, features, or extents.
|
|
24
24
|
This includes zooming, panning, centering, or geocoding based on user input. The agent is designed to handle explicit map movement requests. NOTE: DO NOT call this agent if the user asks "where is... " or "show me...", that is meant to be handled by another agent.
|
|
25
25
|
|
|
26
26
|
Supported actions:
|
|
@@ -43,7 +43,7 @@ ${d.results.map(u=>` - ${u.name} (${u.score.toFixed(2)})`).join(`
|
|
|
43
43
|
|
|
44
44
|
`);return o[o.length-1]?.trim()===t?e:`${e}
|
|
45
45
|
|
|
46
|
-
${t}`},default:()=>""}),vectorSearchLayerIds:y(),vectorSearchFieldResults:y(),layerFieldInfo:y(),queryResponse:y()}),kr=async(e,r)=>(await h({text:"Exiting Data Exploration agent"},r),e),Q=async(e,r)=>{let t=e.tool_calls??[];if(t.length===0){await h({text:`LLM did not request any tool calls: ${String(e?.content)}`},r);return}await Promise.all(t.map(async a=>await h({text:`LLM requested tool call with arguments: ${JSON.stringify(a.args,null,2)}`},r))),console.log("LLM response:",JSON.stringify(e.tool_calls,null,2))};function ne(e){return"point"in e&&e.point!==void 0}function se(e){return"layerId"in e&&e.layerId!==void 0}var W=async(e,r)=>{if(ne(e)){let{point:t}=e;return{geometry:new he({x:t.x,y:t.y,spatialReference:t.spatialReference?{wkid:t.spatialReference.wkid}:r.spatialReference})}}if(se(e)){let t=r.map?.allLayers.find(a=>a.id===e.layerId);if(!t)return{error:`Could not find geometry layer with ID: ${e.layerId}`};try{let a=await t.queryFeatures({where:e.where,returnGeometry:!0,outSpatialReference:r.spatialReference});if(!a.features.length)return{error:`No features found in geometry layer with the specified where clause: ${e.where}`};let o;if(a.features.length===1){let i=a.features[0].geometry;if(!i)return{error:"The geometry of the first feature is undefined or null."};o=i}else{let i=a.features.map(l=>l.geometry),n=Y.executeMany(i);if(!n)return{error:"Failed to create a combined geometry."};o=n}return o.spatialReference||(o.spatialReference=r.spatialReference),{geometry:o}}catch(a){return{error:`Failed to query geometry: ${String(a)}`}}}return{error:"Invalid geometry configuration provided"}},Je=async(e,r,t)=>{let a=e.map?.allLayers.find(i=>i.id===r),o=a.createQuery();o.where=t??"1=1";try{let{extent:i,count:n}=await a.queryExtent(o);return!i||n===0?{success:!1,error:`No features found for where clause: ${t}`}:(await e.goTo(i),{success:!0})}catch(i){return{success:!1,error:i instanceof Error?i.message:String(i)}}},Nr=async(e,r,t,a,o)=>{let i=r.map?.allLayers.find(d=>d.id===e.layerId);if(!i)return`Could not find target layer with ID: ${e.layerId}`;let n;if(o){let d=await W(o,r);if("error"in d)return d.error;n=d.geometry}i.featureEffect=null,i.featureEffect=new Pe({filter:new V({where:e.where,geometry:n,spatialRelationship:"intersects",distance:o?.distance,units:o?.units}),includedEffect:t,excludedEffect:a}),i.visible=!0;let l=await Je(r,o?o.layerId:e.layerId,o?o.where:e.where),c=i.title??e.layerId;return l.success?`Applied feature effects to target layer "${i.title??e.layerId}"${o?` using geometry from layer "${o.layerId}"`:""}.`:`Applied filter to "${c}" but no features matched. ${l.error}`},qr=["mapView"];function C(e){let r=e?.configurable?.context;if(!r||typeof r!="object")throw new Error("DataExplorationAgent context missing");let t=qr.filter(a=>!(a in r));if(t.length)throw new Error(`DataExplorationAgent context missing: ${t.join(", ")}`);return r}var Ar=["feet","kilometers","meters","miles","nautical-miles","us-nautical-miles"],R=s.enum(Ar),Rr=async({targetLayer:e,geometryLayer:r,includedEffect:t="drop-shadow(2px, 2px, 2px, gray)",excludedEffect:a="grayscale(100%) opacity(60%) blur(2px)"},o)=>{let{mapView:i}=C(o);return await Nr(e,i,t,a,r)},Mr=s.object({targetLayer:s.object({layerId:s.string().describe("The layerId of the layer on which to set a feature effect."),where:s.string().describe("The SQL-92 where clause representing the features to emphasize.")}),geometryLayer:s.object({layerId:s.string().describe("The layerId of the layer containing the geometry by which to filter."),where:s.string().describe("The SQL-92 where clause representing the features from which to filter features from the targetLayer by geometry."),distance:s.number().describe("The distance by which to filter the input geometry."),units:R.describe("The units used to filter by geometry and distance.")}).optional().describe("Optional geometry-based filtering parameters for spatial queries."),includedEffect:s.string().optional().default("drop-shadow(2px, 2px, 2px, gray)").describe("The effect applied to features that meet the filter requirements. Valid effects include: bloom, blur, brightness, contrast, drop-shadow, grayscale, hue-rotate, invert, opacity, saturate, and sepia. Prefer default unless specified."),excludedEffect:s.string().optional().default("grayscale(100%) opacity(60%) blur(2px)").describe("The effect applied to features that do not meet the filter requirements. Valid effects include: bloom, blur, brightness, contrast, drop-shadow, grayscale, hue-rotate, invert, opacity, saturate, and sepia. Prefer default unless specified.")}),zr=p(Rr,{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:Mr}),Cr=async(e,r,t)=>{let a=r.map?.allLayers.find(c=>c.id===e.layerId);if(!a)return`Could not find target layer with ID: ${e.layerId}`;let o;if(t){let c=await W(t,r);if("error"in c)return c.error;o=c.geometry}let i=await r.whenLayerView(a);i.filter=null,i.filter=new V({where:e.where,geometry:o,spatialRelationship:"intersects",distance:t?.distance,units:t?.units}),a.visible=!0;let n=await Je(r,t?t.layerId:e.layerId,t?t.where:e.where),l=a.title??e.layerId;return n.success?`Applied feature filter to layer "${a.title??e.layerId}"${t?` using geometry from layer "${t.layerId}"`:""}.`:`Applied filter to "${l}" but no features matched. ${n.error}`},jr=async({targetLayer:e,geometryLayer:r},t)=>{let{mapView:a}=C(t);return await Cr(e,a,r)},Vr=s.object({targetLayer:s.object({layerId:s.string().describe("The layerId of the layer on which to set a filter."),where:s.string().describe("The SQL-92 where clause representing the features to display.")}),geometryLayer:s.object({layerId:s.string().describe("The layerId of the layer containing the geometry by which to filter."),where:s.string().describe("The SQL-92 where clause representing the features from which to filter features from the targetLayer by geometry."),distance:s.number().describe("The distance by which to filter the input geometry."),units:R.describe("The units used to filter by geometry and distance.")}).optional().describe("Optional geometry-based filtering parameters for spatial queries.")}),Or=p(jr,{name:"setFeatureFilter",description:"Sets a client-side filter using a where clause, geometry filter, or both on a target layer. This filters features at the client level in the view.",schema:Vr}),le=(e,r,t)=>{if(e&&typeof e!="function"){let a="getField"in t&&t.getField?.(e),o=a&&"getFieldDomain"in t&&t.getFieldDomain?t.getFieldDomain(a.name):null;if(o?.type==="coded-value"){let i=o.codedValues.find(n=>n.code===r);return i?i.name:null}}return null},Dr=(e,r,t)=>{let a=e.createQuery();return a.outFields=[r],a.where=t||"1=1",a.num=1,a},Pr=async(e,r,t,a)=>{let o=a.map?.allLayers.find(d=>d.id===e),i=Dr(o,r,t.where),n=(await o.queryFeatures(i)).features[0],l=n?n.attributes[r]:null,c=le(r,l,o)||l;return{tool:"getAttribute",layerName:o.title??e,summary:`${r} = ${c}`,details:{fieldName:r,value:c,where:t.where}}};async function Gr({layerId:e,fieldName:r,query:t},a){let{mapView:o}=C(a),i=await Pr(e,r,t,o);return JSON.stringify(i,null,2)}var Br=s.object({layerId:s.string().describe("The layerId of the layer containing the field from which to get a value."),fieldName:s.string().describe("The name of the field/attribute from which to get a field value."),query:s.object({where:s.string().describe("The SQL-92 where clause representing the feature from which to get an attribute value.")})}),Qr=p(Gr,{name:"getAttribute",description:"Returns an attribute value for a given feature.",schema:Br}),we=(e,r)=>r?e.hasAllFeaturesInView:e.hasAllFeatures,Wr=async e=>{let{targetLayer:r,fieldName:t,statisticType:a,mapView:o,layersAndFieldsRegistry:i,geometryLayer:n}=e,l=o.map?.allLayers.find(T=>T.id===r.layerId);if(!l)throw new Error(`Layer '${r.layerId}' not found.`);let c=await o.whenLayerView(l),d=i.get(r.layerId)?.fieldRegistry.get(t);if(!d)throw new Error(`Field '${t}' not found.`);let u,m;if(n){let T=await W(n,o);if("error"in T)throw new Error(T.error);if(!T.geometry)throw new Error(`No features found matching: ${n.where}`);u={geometryLayerId:n.layerId,geometryWhere:n.where,distance:n.distance,units:n.units,applied:!0},m=new V({geometry:T.geometry,distance:n.distance,units:n.units,spatialRelationship:"intersects"})}let f=we(c,!1),g=null,w=null,S=10;if(d.type!=="geometry"&&d.type!=="oid"&&d.type!=="global-id")try{g=await me({layer:l,useFeaturesInView:f,view:f?o:void 0,field:t,sqlWhere:r.where,...m&&{filter:m},outStatisticTypes:{include:[a]}}),["string","small-integer","integer"].includes(d.type)&&(w=(await fe({layer:l,useFeaturesInView:f,view:f?o:void 0,field:t,sqlWhere:r.where,...m&&{filter:m}})).uniqueValueInfos.sort((T,M)=>M.count-T.count).slice(0,S))}catch(T){console.error("Statistics error:",T)}return{tool:"getStatistics",layerName:l.title??r.layerId,summary:`${a} = ${typeof g?.[a]=="number"?g[a]:"N/A"}`,details:{fieldName:t,statisticType:a,statistic:g?.[a]??null,summaryStatistics:g,uniqueValues:w,where:r.where,spatialFilterInfo:u}}};async function Kr({targetLayer:e,fieldName:r,statisticType:t,geometryLayer:a},o){let i=b(o,"layersAndFieldsRegistry"),{mapView:n}=C(o),l=await Wr({targetLayer:e,fieldName:r,statisticType:t,mapView:n,layersAndFieldsRegistry:i,geometryLayer:a});return JSON.stringify(l,null,2)}var Ur=s.object({targetLayer:s.object({layerId:s.string().describe("The layerId of the layer containing the field from which to get a value."),where:s.string().describe("The SQL-92 where clause representing the feature from which to get an attribute value.")}),geometryLayer:s.union([s.object({layerId:s.string().describe("The layerId of the layer containing the geometry by which to filter."),where:s.string().describe("The SQL-92 where clause representing the features from which to filter features from the targetLayer by geometry."),distance:s.number().optional().describe("The distance by which to query from the input geometry."),units:R.optional().describe("The units used to query by geometry and distance.")}),s.object({}).strict()]).optional().describe("Optional geometry-based filtering parameters for spatial queries."),fieldName:s.string().describe("The name of the field for which to get statistics. STRICTLY DO NOT use OBJECTID. Use any other field"),statisticType:s.enum(["avg","max","median","min","stddev","sum","variance","nullcount","count"]).describe("The statistic type to calculate.")}),Jr=p(Kr,{name:"getStatistics",description:'Returns one or more summary statistics for the given field. Statistic types include: count, maximum, minimum, average, median, standard deviation, variance, mode, sum, nullcount (number of features without a value for a given field), unique values. For "most common/frequent" questions: Use statisticType "count" on a categorical field. The response includes uniqueValues sorted by frequency (most common first). Statistics can be returned for number, date, and string fields. Also returns frequency analysis for string fields - unique values sorted by occurrence count (most frequent first). Use this for "most common", "most frequent", or "how many of each" questions. Only call this tool when the question requires filtering (e.g. a WHERE clause or spatial constraint) that cannot be satisfied by precomputed stats.',schema:Ur}),Zr=async(e,r,t,a)=>{let o=t.map?.allLayers.find(u=>u.id===e.layerId),i=await t.whenLayerView(o),n=o.title??e.layerId,l;if(a){let u=await W(a,t);if("error"in u)return{tool:"getTopFeatures",layerName:n,summary:"Geometry lookup failed",details:{error:u.error}};if(!u.geometry)return{tool:"getTopFeatures",layerName:n,summary:"No features found for geometry filter",details:{error:`No features found matching: ${a.where}`}};l=u.geometry}let c=e.outFields.length>2?e.outFields:["*"],d=r.groupByFields&&r.groupByFields.length>0;try{let u;if(d){let f=new Ge({where:e.where||"1=1",outFields:c,orderByFields:e.orderByFields,geometry:l,spatialRelationship:l?"intersects":void 0,distance:a?.distance,units:a?.units,topFilter:new Be({topCount:r.topCount,groupByFields:r.groupByFields,orderByFields:r.orderByFields})});u=await o.queryTopFeatures(f)}else{let f=new ge({where:e.where||"1=1",outFields:c,orderByFields:r.orderByFields,num:r.topCount,geometry:l,spatialRelationship:l?"intersects":void 0,distance:a?.distance,units:a?.units,outSpatialReference:t.spatialReference}),g=we(i,!1);try{u=g?await i.queryFeatures(f):await o.queryFeatures(f)}catch(w){console.warn("Client-side query failed, falling back to server:",w),u=await o.queryFeatures(f)}}let m=u.features.map(f=>f.attributes);return{tool:"getTopFeatures",layerName:n,summary:`Top ${r.topCount} features extracted`,details:{topCount:r.topCount,attributes:m,where:e.where,orderByFields:r.orderByFields,...d&&{groupByFields:r.groupByFields}}}}catch(u){return{tool:"getTopFeatures",layerName:n,summary:"Query failed",details:{error:u instanceof Error?u.message:String(u)}}}},Hr=async({targetLayer:e,topFilter:r,geometryLayer:t},a)=>{let{mapView:o}=C(a),i=await Zr(e,r,o,t);return JSON.stringify(i,null,2)},Yr=s.object({targetLayer:s.object({layerId:s.string().describe("The layerId of the layer containing the field from which to get a value."),where:s.string().describe("The SQL-92 where clause representing the feature from which to get an attribute value."),orderByFields:s.array(s.string().describe("The field(s) and order for which to sort the resulting features.")),outFields:s.array(s.string().describe('The fields to include in the output that will be presented to the user. This should include identifying information about the resulting features, like a name or id, along with the values desired in the output. If unsure, choose all fields ("*").').default("*"))}),geometryLayer:s.object({layerId:s.string().describe("The layerId of the layer containing the geometry by which to filter."),where:s.string().describe("The SQL-92 where clause representing the features from which to filter features from the targetLayer by geometry."),distance:s.number().optional().describe("The distance by which to query from the input geometry."),units:R.describe("The units used to query by geometry and distance.").optional()}).optional().describe("Optional geometry-based filtering parameters for spatial queries."),topFilter:s.object({topCount:s.number().describe("Number of top features to return per group."),orderByFields:s.array(s.string().describe("Field(s) to rank by with ASC/DESC. Must be existing field names, not aggregate functions.")),groupByFields:s.array(s.string().describe("Field(s) to group results by. Returns top N per group."))})}),Xr=p(Hr,{name:"getTopFeatures",description:'Returns top N features ranked by an existing field value. Use for "highest", "lowest", "top N" questions where ranking is based on a field that already exists in the data (e.g., population, value, date, depth). orderByFields must be actual field names with ASC/DESC. Do NOT use aggregate functions like COUNT(), SUM(), AVG() - those require getStatistics.',schema:Yr}),ie=25,ea=async(e,r,t,a)=>{let o=r.map?.allLayers.find(g=>g.id===e.layerId),i=await r.whenLayerView(o),n=o.title??e.layerId,l;if(t){let g=await W(t,r);if("error"in g){let w={error:g.error};return se(t)?(w.geometryLayerId=t.layerId,w.geometryWhere=t.where):ne(t)&&(w.point=t.point),{tool:"queryFeatures",layerName:n,summary:"Geometry lookup failed",details:w}}if(!g.geometry){let w={};return se(t)?(w.error=`No features found matching: ${t.where}`,w.geometryLayerId=t.layerId,w.geometryWhere=t.where):ne(t)&&(w.error="Failed to create point geometry",w.point=t.point),{tool:"queryFeatures",layerName:n,summary:"No features found for geometry filter",details:w}}l=g.geometry}else a&&(l=r.extent.clone());let c=we(i,a??!1),d=new ge({where:e.where||"1=1",outFields:e.outFields.length?e.outFields:["*"],orderByFields:e.orderByFields,...l&&{geometry:l,spatialRelationship:"intersects"},...t?.distance&&{distance:t.distance},...t?.units&&{units:t.units},outSpatialReference:r.spatialReference}),u,m;try{u=c?await i.queryFeatureCount(d):await o.queryFeatureCount(d),u>0&&u<=ie&&(m=c?await i.queryFeatures(d):await o.queryFeatures(d),m&&m.features.forEach(g=>{let w=g.attributes;o.fields.forEach(S=>{let T=w[S.name],M=le(S.name,T,o);M&&(w[S.name]=M)})}))}catch(g){console.warn("Client-side query failed, falling back to server:",g),u=await o.queryFeatureCount(d),u>0&&u<=ie&&(m=await o.queryFeatures(d),m&&m.features.forEach(w=>{o.fields.forEach(S=>{let T=w.attributes[S.name],M=le(S.name,T,o);M&&(w.attributes[S.name]=M)})}))}let f=m?.features.map(g=>g.attributes);return{tool:"queryFeatures",layerName:n,summary:`${u} features found`,details:{totalCount:u,where:e.where,...f&&{attributes:f},...u>ie&&{note:`${u} features found. Too many to list. Use filters to narrow results.`}}}};async function ta({targetLayer:e,geometryFilter:r,useCurrentExtent:t},a){let{mapView:o}=C(a),i=await ea(e,o,r,t);return JSON.stringify(i,null,2)}var ra=s.object({layerId:s.string().describe("The layerId of the layer containing the geometry by which to filter."),where:s.string().describe("The SQL-92 where clause representing the features from which to filter."),distance:s.number().optional().describe("The buffer distance around the geometry."),units:R.optional().describe("The units for the distance buffer.")}),aa=s.object({point:s.object({x:s.number().describe("X coordinate (longitude) from navigation result"),y:s.number().describe("Y coordinate (latitude) from navigation result"),spatialReference:s.object({wkid:s.number().describe("Spatial reference WKID (e.g., 4326 for WGS84)")}).optional().describe("Spatial reference. Defaults to map's spatial reference if not provided.")}).describe("Point coordinates from a previous navigation/geocoding result"),distance:s.number().optional().describe("Optional buffer distance around the point."),units:R.optional().describe("The units for the distance buffer.")}),oa=s.object({targetLayer:s.object({layerId:s.string().describe("The layerId of the layer containing the field from which to get a value."),where:s.string().describe("SQL-92 where clause. IMPORTANT: When using geometryFilter.point for point-in-polygon queries, set this to '1=1' to return all features that intersect the point. Only add attribute filters if the user specifically requests them in addition to the spatial query."),orderByFields:s.array(s.string().describe("The field(s) and order for which to sort the resulting features.")),outFields:s.array(s.string().describe('The fields to include in the output that will be presented to the user. This should include identifying information about the resulting features, like a name or id, along with the values desired in the output. If unsure, choose all fields ("*").').default("*"))}),geometryFilter:s.union([ra,aa]).optional().describe("Geometry filter for spatial queries. Use 'point' option with x/y coordinates from navigation results to find features at that location (point-in-polygon). Use 'layerId/where' option to filter by features from another layer."),useCurrentExtent:s.boolean().optional().describe("Set to true ONLY when user explicitly asks about features 'in my view', 'on my map', 'I am looking at'. Default is false (queries entire layer).")}),ia=p(ta,{name:"queryFeatures",description:"Queries features from a layer. Returns count and attributes (if \u226425 features). Use for listing features, finding features matching conditions, or spatial queries.",schema:oa}),Ze=[Qr,Jr,Xr,ia],He=[zr,Or],X=()=>{let e=new Date().getTimezoneOffset(),r=e<=0?"+":"-",t=Math.floor(Math.abs(e)/60).toString().padStart(2,"0"),a=(Math.abs(e)%60).toString().padStart(2,"0"),o=`${r}${t}:${a}`;return{userTimezone:Intl.DateTimeFormat().resolvedOptions().timeZone,userTimezoneOffset:o}},na=async(e,r)=>{await h({text:"Requesting LLM for layer filter results"},r);let t=await F("data_explore_filter_prompt");if(!r?.configurable)throw new Error("config.configurable is required for layer filter tools");let{userTimezone:a,userTimezoneOffset:o}=X(),i={layerFieldInfo:e.layerFieldInfo,userTimezone:a,userTimezoneOffset:o},n=await z({promptText:t,messages:v(e.messages),inputVariables:i,tools:He}),l=[...e.messages,n],c=(n.tool_calls?.length??0)>0?l:[...l,n],d=n.content.toString();return await Q(n,r),{...e,messages:c,outputMessage:d}},sa=async(e,r)=>{await h({text:"Requesting LLM for layer query results"},r);let t=await F("data_explore_query_prompt");if(!r?.configurable)throw new Error("config.configurable is required for layer query tools");let{userTimezone:a,userTimezoneOffset:o}=X(),i={layerFieldInfo:e.layerFieldInfo,userTimezone:a,userTimezoneOffset:o},n=await z({promptText:t,messages:v(e.messages),inputVariables:i,tools:Ze}),l=[...e.messages,n],c=n.content.toString();return await Q(n,r),{...e,messages:l,outputMessage:c}},la=async(e,r)=>{try{await h({text:"Requesting LLM for summary on query results"},r);let t=await F("summarize_query_response_prompt"),a={queryResponse:e.queryResponse},o=await ae({promptText:t,messages:v(e.messages),inputVariables:a}),i=typeof o=="string"?o:o.content,n=new j(i);return await h({text:`Received response from LLM: ${i}`},r),{...e,outputMessage:i,messages:[...e.messages,n]}}catch(t){throw await h({text:"Error during filter LLM request"},r),new Error(`Error during filter LLM request: ${t instanceof Error?t.message:String(t)}`)}};async function ca(e,r){let t=await new A(He).invoke({messages:v(e.messages)},r),a=[...e.messages,...t.messages],o=t.messages.map(l=>new j({content:l.content,additional_kwargs:l.additional_kwargs}));await h({text:`Finished executing layer filter tool: ${t.messages.map(l=>l.content).join(", ")}`},r);let i=[...a,...o],n=o.map(l=>l.content).join(`
|
|
46
|
+
${t}`},default:()=>""}),vectorSearchLayerIds:y(),vectorSearchFieldResults:y(),layerFieldInfo:y(),queryResponse:y()}),Nr=async(e,r)=>(await h({text:"Exiting Data Exploration agent"},r),e),Q=async(e,r)=>{let t=e.tool_calls??[];if(t.length===0){await h({text:`LLM did not request any tool calls: ${String(e?.content)}`},r);return}await Promise.all(t.map(async a=>await h({text:`LLM requested tool call with arguments: ${JSON.stringify(a.args,null,2)}`},r))),console.log("LLM response:",JSON.stringify(e.tool_calls,null,2))};function ne(e){return"point"in e&&e.point!==void 0}function se(e){return"layerId"in e&&e.layerId!==void 0}var W=async(e,r)=>{if(ne(e)){let{point:t}=e;return{geometry:new he({x:t.x,y:t.y,spatialReference:t.spatialReference?{wkid:t.spatialReference.wkid}:r.spatialReference})}}if(se(e)){let t=r.map?.allLayers.find(a=>a.id===e.layerId);if(!t)return{error:`Could not find geometry layer with ID: ${e.layerId}`};try{let a=await t.queryFeatures({where:e.where,returnGeometry:!0,outSpatialReference:r.spatialReference});if(!a.features.length)return{error:`No features found in geometry layer with the specified where clause: ${e.where}`};let o;if(a.features.length===1){let i=a.features[0].geometry;if(!i)return{error:"The geometry of the first feature is undefined or null."};o=i}else{let i=a.features.map(l=>l.geometry),n=Y.executeMany(i);if(!n)return{error:"Failed to create a combined geometry."};o=n}return o.spatialReference||(o.spatialReference=r.spatialReference),{geometry:o}}catch(a){return{error:`Failed to query geometry: ${String(a)}`}}}return{error:"Invalid geometry configuration provided"}},Je=async(e,r,t)=>{let a=e.map?.allLayers.find(i=>i.id===r),o=a.createQuery();o.where=t??"1=1";try{let{extent:i,count:n}=await a.queryExtent(o);return!i||n===0?{success:!1,error:`No features found for where clause: ${t}`}:(await e.goTo(i),{success:!0})}catch(i){return{success:!1,error:i instanceof Error?i.message:String(i)}}},kr=async(e,r,t,a,o)=>{let i=r.map?.allLayers.find(d=>d.id===e.layerId);if(!i)return`Could not find target layer with ID: ${e.layerId}`;let n;if(o){let d=await W(o,r);if("error"in d)return d.error;n=d.geometry}i.featureEffect=null,i.featureEffect=new Pe({filter:new V({where:e.where,geometry:n,spatialRelationship:"intersects",distance:o?.distance,units:o?.units}),includedEffect:t,excludedEffect:a}),i.visible=!0;let l=await Je(r,o?o.layerId:e.layerId,o?o.where:e.where),c=i.title??e.layerId;return l.success?`Applied feature effects to target layer "${i.title??e.layerId}"${o?` using geometry from layer "${o.layerId}"`:""}.`:`Applied filter to "${c}" but no features matched. ${l.error}`},qr=["mapView"];function C(e){let r=e?.configurable?.context;if(!r||typeof r!="object")throw new Error("DataExplorationAgent context missing");let t=qr.filter(a=>!(a in r));if(t.length)throw new Error(`DataExplorationAgent context missing: ${t.join(", ")}`);return r}var Ar=["feet","kilometers","meters","miles","nautical-miles","us-nautical-miles"],R=s.enum(Ar),Rr=async({targetLayer:e,geometryLayer:r,includedEffect:t="drop-shadow(2px, 2px, 2px, gray)",excludedEffect:a="grayscale(100%) opacity(60%) blur(2px)"},o)=>{let{mapView:i}=C(o);return await kr(e,i,t,a,r)},Mr=s.object({targetLayer:s.object({layerId:s.string().describe("The layerId of the layer on which to set a feature effect."),where:s.string().describe("The SQL-92 where clause representing the features to emphasize.")}),geometryLayer:s.object({layerId:s.string().describe("The layerId of the layer containing the geometry by which to filter."),where:s.string().describe("The SQL-92 where clause representing the features from which to filter features from the targetLayer by geometry."),distance:s.number().describe("The distance by which to filter the input geometry."),units:R.describe("The units used to filter by geometry and distance.")}).optional().describe("Optional geometry-based filtering parameters for spatial queries."),includedEffect:s.string().optional().default("drop-shadow(2px, 2px, 2px, gray)").describe("The effect applied to features that meet the filter requirements. Valid effects include: bloom, blur, brightness, contrast, drop-shadow, grayscale, hue-rotate, invert, opacity, saturate, and sepia. Prefer default unless specified."),excludedEffect:s.string().optional().default("grayscale(100%) opacity(60%) blur(2px)").describe("The effect applied to features that do not meet the filter requirements. Valid effects include: bloom, blur, brightness, contrast, drop-shadow, grayscale, hue-rotate, invert, opacity, saturate, and sepia. Prefer default unless specified.")}),zr=p(Rr,{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:Mr}),Cr=async(e,r,t)=>{let a=r.map?.allLayers.find(c=>c.id===e.layerId);if(!a)return`Could not find target layer with ID: ${e.layerId}`;let o;if(t){let c=await W(t,r);if("error"in c)return c.error;o=c.geometry}let i=await r.whenLayerView(a);i.filter=null,i.filter=new V({where:e.where,geometry:o,spatialRelationship:"intersects",distance:t?.distance,units:t?.units}),a.visible=!0;let n=await Je(r,t?t.layerId:e.layerId,t?t.where:e.where),l=a.title??e.layerId;return n.success?`Applied feature filter to layer "${a.title??e.layerId}"${t?` using geometry from layer "${t.layerId}"`:""}.`:`Applied filter to "${l}" but no features matched. ${n.error}`},jr=async({targetLayer:e,geometryLayer:r},t)=>{let{mapView:a}=C(t);return await Cr(e,a,r)},Vr=s.object({targetLayer:s.object({layerId:s.string().describe("The layerId of the layer on which to set a filter."),where:s.string().describe("The SQL-92 where clause representing the features to display.")}),geometryLayer:s.object({layerId:s.string().describe("The layerId of the layer containing the geometry by which to filter."),where:s.string().describe("The SQL-92 where clause representing the features from which to filter features from the targetLayer by geometry."),distance:s.number().describe("The distance by which to filter the input geometry."),units:R.describe("The units used to filter by geometry and distance.")}).optional().describe("Optional geometry-based filtering parameters for spatial queries.")}),Or=p(jr,{name:"setFeatureFilter",description:"Sets a client-side filter using a where clause, geometry filter, or both on a target layer. This filters features at the client level in the view.",schema:Vr}),le=(e,r,t)=>{if(e&&typeof e!="function"){let a="getField"in t&&t.getField?.(e),o=a&&"getFieldDomain"in t&&t.getFieldDomain?t.getFieldDomain(a.name):null;if(o?.type==="coded-value"){let i=o.codedValues.find(n=>n.code===r);return i?i.name:null}}return null},Dr=(e,r,t)=>{let a=e.createQuery();return a.outFields=[r],a.where=t||"1=1",a.num=1,a},Pr=async(e,r,t,a)=>{let o=a.map?.allLayers.find(d=>d.id===e),i=Dr(o,r,t.where),n=(await o.queryFeatures(i)).features[0],l=n?n.attributes[r]:null,c=le(r,l,o)||l;return{tool:"getAttribute",layerName:o.title??e,summary:`${r} = ${c}`,details:{fieldName:r,value:c,where:t.where}}};async function Gr({layerId:e,fieldName:r,query:t},a){let{mapView:o}=C(a),i=await Pr(e,r,t,o);return JSON.stringify(i,null,2)}var Br=s.object({layerId:s.string().describe("The layerId of the layer containing the field from which to get a value."),fieldName:s.string().describe("The name of the field/attribute from which to get a field value."),query:s.object({where:s.string().describe("The SQL-92 where clause representing the feature from which to get an attribute value.")})}),Qr=p(Gr,{name:"getAttribute",description:"Returns an attribute value for a given feature.",schema:Br}),we=(e,r)=>r?e.hasAllFeaturesInView:e.hasAllFeatures,Wr=async e=>{let{targetLayer:r,fieldName:t,statisticType:a,mapView:o,layersAndFieldsRegistry:i,geometryLayer:n}=e,l=o.map?.allLayers.find(T=>T.id===r.layerId);if(!l)throw new Error(`Layer '${r.layerId}' not found.`);let c=await o.whenLayerView(l),d=i.get(r.layerId)?.fieldRegistry.get(t);if(!d)throw new Error(`Field '${t}' not found.`);let u,m;if(n){let T=await W(n,o);if("error"in T)throw new Error(T.error);if(!T.geometry)throw new Error(`No features found matching: ${n.where}`);u={geometryLayerId:n.layerId,geometryWhere:n.where,distance:n.distance,units:n.units,applied:!0},m=new V({geometry:T.geometry,distance:n.distance,units:n.units,spatialRelationship:"intersects"})}let f=we(c,!1),g=null,w=null,S=10;if(d.type!=="geometry"&&d.type!=="oid"&&d.type!=="global-id")try{g=await me({layer:l,useFeaturesInView:f,view:f?o:void 0,field:t,sqlWhere:r.where,...m&&{filter:m},outStatisticTypes:{include:[a]}}),["string","small-integer","integer"].includes(d.type)&&(w=(await fe({layer:l,useFeaturesInView:f,view:f?o:void 0,field:t,sqlWhere:r.where,...m&&{filter:m}})).uniqueValueInfos.sort((T,M)=>M.count-T.count).slice(0,S))}catch(T){console.error("Statistics error:",T)}return{tool:"getStatistics",layerName:l.title??r.layerId,summary:`${a} = ${typeof g?.[a]=="number"?g[a]:"N/A"}`,details:{fieldName:t,statisticType:a,statistic:g?.[a]??null,summaryStatistics:g,uniqueValues:w,where:r.where,spatialFilterInfo:u}}};async function Kr({targetLayer:e,fieldName:r,statisticType:t,geometryLayer:a},o){let i=b(o,"layersAndFieldsRegistry"),{mapView:n}=C(o),l=await Wr({targetLayer:e,fieldName:r,statisticType:t,mapView:n,layersAndFieldsRegistry:i,geometryLayer:a});return JSON.stringify(l,null,2)}var Ur=s.object({targetLayer:s.object({layerId:s.string().describe("The layerId of the layer containing the field from which to get a value."),where:s.string().describe("The SQL-92 where clause representing the feature from which to get an attribute value.")}),geometryLayer:s.union([s.object({layerId:s.string().describe("The layerId of the layer containing the geometry by which to filter."),where:s.string().describe("The SQL-92 where clause representing the features from which to filter features from the targetLayer by geometry."),distance:s.number().optional().describe("The distance by which to query from the input geometry."),units:R.optional().describe("The units used to query by geometry and distance.")}),s.object({}).strict()]).optional().describe("Optional geometry-based filtering parameters for spatial queries."),fieldName:s.string().describe("The name of the field for which to get statistics. STRICTLY DO NOT use OBJECTID. Use any other field"),statisticType:s.enum(["avg","max","median","min","stddev","sum","variance","nullcount","count"]).describe("The statistic type to calculate.")}),Jr=p(Kr,{name:"getStatistics",description:'Returns one or more summary statistics for the given field. Statistic types include: count, maximum, minimum, average, median, standard deviation, variance, mode, sum, nullcount (number of features without a value for a given field), unique values. For "most common/frequent" questions: Use statisticType "count" on a categorical field. The response includes uniqueValues sorted by frequency (most common first). Statistics can be returned for number, date, and string fields. Also returns frequency analysis for string fields - unique values sorted by occurrence count (most frequent first). Use this for "most common", "most frequent", or "how many of each" questions. Only call this tool when the question requires filtering (e.g. a WHERE clause or spatial constraint) that cannot be satisfied by precomputed stats.',schema:Ur}),Zr=async(e,r,t,a)=>{let o=t.map?.allLayers.find(u=>u.id===e.layerId),i=await t.whenLayerView(o),n=o.title??e.layerId,l;if(a){let u=await W(a,t);if("error"in u)return{tool:"getTopFeatures",layerName:n,summary:"Geometry lookup failed",details:{error:u.error}};if(!u.geometry)return{tool:"getTopFeatures",layerName:n,summary:"No features found for geometry filter",details:{error:`No features found matching: ${a.where}`}};l=u.geometry}let c=e.outFields.length>2?e.outFields:["*"],d=r.groupByFields&&r.groupByFields.length>0;try{let u;if(d){let f=new Ge({where:e.where||"1=1",outFields:c,orderByFields:e.orderByFields,geometry:l,spatialRelationship:l?"intersects":void 0,distance:a?.distance,units:a?.units,topFilter:new Be({topCount:r.topCount,groupByFields:r.groupByFields,orderByFields:r.orderByFields})});u=await o.queryTopFeatures(f)}else{let f=new ge({where:e.where||"1=1",outFields:c,orderByFields:r.orderByFields,num:r.topCount,geometry:l,spatialRelationship:l?"intersects":void 0,distance:a?.distance,units:a?.units,outSpatialReference:t.spatialReference}),g=we(i,!1);try{u=g?await i.queryFeatures(f):await o.queryFeatures(f)}catch(w){console.warn("Client-side query failed, falling back to server:",w),u=await o.queryFeatures(f)}}let m=u.features.map(f=>f.attributes);return{tool:"getTopFeatures",layerName:n,summary:`Top ${r.topCount} features extracted`,details:{topCount:r.topCount,attributes:m,where:e.where,orderByFields:r.orderByFields,...d&&{groupByFields:r.groupByFields}}}}catch(u){return{tool:"getTopFeatures",layerName:n,summary:"Query failed",details:{error:u instanceof Error?u.message:String(u)}}}},Hr=async({targetLayer:e,topFilter:r,geometryLayer:t},a)=>{let{mapView:o}=C(a),i=await Zr(e,r,o,t);return JSON.stringify(i,null,2)},Yr=s.object({targetLayer:s.object({layerId:s.string().describe("The layerId of the layer containing the field from which to get a value."),where:s.string().describe("The SQL-92 where clause representing the feature from which to get an attribute value."),orderByFields:s.array(s.string().describe("The field(s) and order for which to sort the resulting features.")),outFields:s.array(s.string().describe('The fields to include in the output that will be presented to the user. This should include identifying information about the resulting features, like a name or id, along with the values desired in the output. If unsure, choose all fields ("*").').default("*"))}),geometryLayer:s.object({layerId:s.string().describe("The layerId of the layer containing the geometry by which to filter."),where:s.string().describe("The SQL-92 where clause representing the features from which to filter features from the targetLayer by geometry."),distance:s.number().optional().describe("The distance by which to query from the input geometry."),units:R.describe("The units used to query by geometry and distance.").optional()}).optional().describe("Optional geometry-based filtering parameters for spatial queries."),topFilter:s.object({topCount:s.number().describe("Number of top features to return per group."),orderByFields:s.array(s.string().describe("Field(s) to rank by with ASC/DESC. Must be existing field names, not aggregate functions.")),groupByFields:s.array(s.string().describe("Field(s) to group results by. Returns top N per group."))})}),Xr=p(Hr,{name:"getTopFeatures",description:'Returns top N features ranked by an existing field value. Use for "highest", "lowest", "top N" questions where ranking is based on a field that already exists in the data (e.g., population, value, date, depth). orderByFields must be actual field names with ASC/DESC. Do NOT use aggregate functions like COUNT(), SUM(), AVG() - those require getStatistics.',schema:Yr}),ie=25,ea=async(e,r,t,a)=>{let o=r.map?.allLayers.find(g=>g.id===e.layerId),i=await r.whenLayerView(o),n=o.title??e.layerId,l;if(t){let g=await W(t,r);if("error"in g){let w={error:g.error};return se(t)?(w.geometryLayerId=t.layerId,w.geometryWhere=t.where):ne(t)&&(w.point=t.point),{tool:"queryFeatures",layerName:n,summary:"Geometry lookup failed",details:w}}if(!g.geometry){let w={};return se(t)?(w.error=`No features found matching: ${t.where}`,w.geometryLayerId=t.layerId,w.geometryWhere=t.where):ne(t)&&(w.error="Failed to create point geometry",w.point=t.point),{tool:"queryFeatures",layerName:n,summary:"No features found for geometry filter",details:w}}l=g.geometry}else a&&(l=r.extent.clone());let c=we(i,a??!1),d=new ge({where:e.where||"1=1",outFields:e.outFields.length?e.outFields:["*"],orderByFields:e.orderByFields,...l&&{geometry:l,spatialRelationship:"intersects"},...t?.distance&&{distance:t.distance},...t?.units&&{units:t.units},outSpatialReference:r.spatialReference}),u,m;try{u=c?await i.queryFeatureCount(d):await o.queryFeatureCount(d),u>0&&u<=ie&&(m=c?await i.queryFeatures(d):await o.queryFeatures(d),m&&m.features.forEach(g=>{let w=g.attributes;o.fields.forEach(S=>{let T=w[S.name],M=le(S.name,T,o);M&&(w[S.name]=M)})}))}catch(g){console.warn("Client-side query failed, falling back to server:",g),u=await o.queryFeatureCount(d),u>0&&u<=ie&&(m=await o.queryFeatures(d),m&&m.features.forEach(w=>{o.fields.forEach(S=>{let T=w.attributes[S.name],M=le(S.name,T,o);M&&(w.attributes[S.name]=M)})}))}let f=m?.features.map(g=>g.attributes);return{tool:"queryFeatures",layerName:n,summary:`${u} features found`,details:{totalCount:u,where:e.where,...f&&{attributes:f},...u>ie&&{note:`${u} features found. Too many to list. Use filters to narrow results.`}}}};async function ta({targetLayer:e,geometryFilter:r,useCurrentExtent:t},a){let{mapView:o}=C(a),i=await ea(e,o,r,t);return JSON.stringify(i,null,2)}var ra=s.object({layerId:s.string().describe("The layerId of the layer containing the geometry by which to filter."),where:s.string().describe("The SQL-92 where clause representing the features from which to filter."),distance:s.number().optional().describe("The buffer distance around the geometry."),units:R.optional().describe("The units for the distance buffer.")}),aa=s.object({point:s.object({x:s.number().describe("X coordinate (longitude) from navigation result"),y:s.number().describe("Y coordinate (latitude) from navigation result"),spatialReference:s.object({wkid:s.number().describe("Spatial reference WKID (e.g., 4326 for WGS84)")}).optional().describe("Spatial reference. Defaults to map's spatial reference if not provided.")}).describe("Point coordinates from a previous navigation/geocoding result"),distance:s.number().optional().describe("Optional buffer distance around the point."),units:R.optional().describe("The units for the distance buffer.")}),oa=s.object({targetLayer:s.object({layerId:s.string().describe("The layerId of the layer containing the field from which to get a value."),where:s.string().describe("SQL-92 where clause. IMPORTANT: When using geometryFilter.point for point-in-polygon queries, set this to '1=1' to return all features that intersect the point. Only add attribute filters if the user specifically requests them in addition to the spatial query."),orderByFields:s.array(s.string().describe("The field(s) and order for which to sort the resulting features.")),outFields:s.array(s.string().describe('The fields to include in the output that will be presented to the user. This should include identifying information about the resulting features, like a name or id, along with the values desired in the output. If unsure, choose all fields ("*").').default("*"))}),geometryFilter:s.union([ra,aa]).optional().describe("Geometry filter for spatial queries. Use 'point' option with x/y coordinates from navigation results to find features at that location (point-in-polygon). Use 'layerId/where' option to filter by features from another layer."),useCurrentExtent:s.boolean().optional().describe("Set to true ONLY when user explicitly asks about features 'in my view', 'on my map', 'I am looking at'. Default is false (queries entire layer).")}),ia=p(ta,{name:"queryFeatures",description:"Queries features from a layer. Returns count and attributes (if \u226425 features). Use for listing features, finding features matching conditions, or spatial queries.",schema:oa}),Ze=[Qr,Jr,Xr,ia],He=[zr,Or],X=()=>{let e=new Date().getTimezoneOffset(),r=e<=0?"+":"-",t=Math.floor(Math.abs(e)/60).toString().padStart(2,"0"),a=(Math.abs(e)%60).toString().padStart(2,"0"),o=`${r}${t}:${a}`;return{userTimezone:Intl.DateTimeFormat().resolvedOptions().timeZone,userTimezoneOffset:o}},na=async(e,r)=>{await h({text:"Requesting LLM for layer filter results"},r);let t=await F("data_explore_filter_prompt");if(!r?.configurable)throw new Error("config.configurable is required for layer filter tools");let{userTimezone:a,userTimezoneOffset:o}=X(),i={layerFieldInfo:e.layerFieldInfo,userTimezone:a,userTimezoneOffset:o},n=await z({promptText:t,messages:v(e.messages),inputVariables:i,tools:He}),l=[...e.messages,n],c=(n.tool_calls?.length??0)>0?l:[...l,n],d=n.content.toString();return await Q(n,r),{...e,messages:c,outputMessage:d}},sa=async(e,r)=>{await h({text:"Requesting LLM for layer query results"},r);let t=await F("data_explore_query_prompt");if(!r?.configurable)throw new Error("config.configurable is required for layer query tools");let{userTimezone:a,userTimezoneOffset:o}=X(),i={layerFieldInfo:e.layerFieldInfo,userTimezone:a,userTimezoneOffset:o},n=await z({promptText:t,messages:v(e.messages),inputVariables:i,tools:Ze}),l=[...e.messages,n],c=n.content.toString();return await Q(n,r),{...e,messages:l,outputMessage:c}},la=async(e,r)=>{try{await h({text:"Requesting LLM for summary on query results"},r);let t=await F("summarize_query_response_prompt"),a={queryResponse:e.queryResponse},o=await ae({promptText:t,messages:v(e.messages),inputVariables:a}),i=typeof o=="string"?o:o.content,n=new j(i);return await h({text:`Received response from LLM: ${i}`},r),{...e,outputMessage:i,messages:[...e.messages,n]}}catch(t){throw await h({text:"Error during filter LLM request"},r),new Error(`Error during filter LLM request: ${t instanceof Error?t.message:String(t)}`)}};async function ca(e,r){let t=await new A(He).invoke({messages:v(e.messages)},r),a=[...e.messages,...t.messages],o=t.messages.map(l=>new j({content:l.content,additional_kwargs:l.additional_kwargs}));await h({text:`Finished executing layer filter tool: ${t.messages.map(l=>l.content).join(", ")}`},r);let i=[...a,...o],n=o.map(l=>l.content).join(`
|
|
47
47
|
|
|
48
48
|
`);return{...e,messages:i,outputMessage:n}}var da=new A(Ze);async function ua(e,r){let{messages:t}=await da.invoke({messages:v(e.messages)},r),a=[],o=[];for(let n of t){let l=n.content,c;if(typeof l!="string"){c={tool:n.name??"unknown",layerName:"unknown",summary:"Query failed",details:{error:"Skipping non-string tool output:",raw:l}};continue}try{c=JSON.parse(l)}catch{c={tool:n.name??"unknown",layerName:"unknown",summary:"Query failed",details:{error:l}}}a.push(c),c.details&&typeof c.details=="object"&&"error"in c.details?o.push(`- ${c.tool}: Error - ${String(c.details.error)}`):o.push(`- ${c.layerName}: ${c.summary}`)}let i=[...e.messages,...t];return await h({text:`Finished executing layer query tool: ${o.join(", ")}`},r),{...e,messages:i,queryResponse:a}}var ha=10,ma=async(e,r)=>{let t=null,a=null;try{r.type!=="geometry"&&r.type!=="oid"&&r.type!=="global-id"&&(t=await me({layer:e,field:r.name}),r.type==="string"&&(a=(await fe({layer:e,field:r.name})).uniqueValueInfos.sort((o,i)=>i.count-o.count).slice(0,ha)))}catch(o){console.error(`Error fetching statistics for field ${r.name}:`,o)}return{summaryStatistics:t,uniqueValues:a}};async function be(e,r,t){let a=[],o=[];for(let i of e){let n=function(f){let g=r.get(f)?.layerItem;return g?[g.name&&`Name: ${g.name}`,g.title&&`Title: ${g.title}`,g.description&&`Description: ${g.description}`].filter(Boolean).join(" | "):f},{layerId:l,results:c}=i,d=t.map?.allLayers.find(f=>f.id===l),u=r.get(l)?.fieldRegistry;if(!u)continue;let m=a.find(f=>f.layerId===l);m||(m={layerId:l,layerSummary:n(l),fieldInfos:[]},a.push(m));for(let f of c){let g=u.get(f.name);if(g){if(!g.statistics){let w=ma(d,g).then(S=>{u.set(g.name,{...g,statistics:S}),g.statistics=S});o.push(w)}m.fieldInfos.push(g)}}}return await Promise.all(o),a}var fa=async(e,r)=>{try{await h({text:"Getting statistics for vector search results"},r);let t=b(r,"layersAndFieldsRegistry"),{mapView:a}=C(r),o=await be(e.vectorSearchFieldResults,t,a);return console.log("Field statistics retrieved:",o),await h({text:"Statistics retrieved"},r),{...e,layerFieldInfo:o}}catch(t){throw await h({text:"Error during fetching statistics"},r),new Error(`Error during fetching statistics: ${t instanceof Error?t.message:String(t)}`)}},ze=.7,ga=10,ya=async(e,r)=>{try{let t=_(e.messages);await h({text:"Similarity search to find fields"},r);let a=b(r,"fieldSearch"),o=b(r,"layersAndFieldsRegistry"),i=b(r,"embeddingCache"),n=await a.searchFields({text:t,layerIds:e.vectorSearchLayerIds,minScore:ze,topResults:ga,embeddingCache:i}),l=n.map(({layerId:d,results:u})=>{let m=u.map(f=>` - ${f.name} (${f.score.toFixed(2)})`).join(`
|
|
49
49
|
`);return`${o.get(d)?.layerItem.name??d}:
|
|
@@ -51,7 +51,7 @@ ${m}`}).join(`
|
|
|
51
51
|
`),c;return n.length>0?c=`Vector search completed. Matching layers and fields with scores:
|
|
52
52
|
${l}`:c=`No vector search results found for score over ${ze}.`,await h({text:c},r),{...e,vectorSearchFieldResults:n}}catch(t){throw await h({text:`Error during vector search: ${t instanceof Error?t.message:String(t)}`},r),new Error(`Vector search failed: ${t instanceof Error?t.message:String(t)}`)}},pa=.7,wa=async(e,r)=>{try{let t=_(e.messages);await h({text:`Similarity search to find layers: ${t}`},r);let a=b(r,"layerSearch"),o=b(r,"layersAndFieldsRegistry"),i=b(r,"embeddingCache"),n=await a.searchLayers({text:t,minScore:pa,embeddingCache:i}),l=n.map(u=>u.id),c=n.map(({id:u,score:m})=>`${o.get(u)?.layerItem.name??u} (${m.toFixed(2)})`).join(`
|
|
53
53
|
`),d;return l.length>0?d=`Vector search completed. Matching layers with scores:
|
|
54
|
-
${c}`:d="Vector search completed. No matching layers found.",await h({text:d},r),{...e,vectorSearchLayerIds:l}}catch(t){throw await h({text:`Error during vector search: ${t instanceof Error?t.message:String(t)}`},r),new Error(`Vector search failed: ${t instanceof Error?t.message:String(t)}`)}},ba=(e,r)=>B(["layerSearch","fieldSearch","layersAndFieldsRegistry"],"Data Exploration Agent")(e,r),va=()=>new q(Ue).addNode("requireDataExplorationServices",ba).addNode("vectorSearchLayers",wa).addNode("vectorSearchFields",ya).addNode("fieldStatistics",fa).addNode("queryAgent",sa).addNode("queryTools",ua).addNode("summarizeQueryResponseLLM",la).addNode("filterAgent",na).addNode("filterTools",ca).addNode("earlyExit",
|
|
54
|
+
${c}`:d="Vector search completed. No matching layers found.",await h({text:d},r),{...e,vectorSearchLayerIds:l}}catch(t){throw await h({text:`Error during vector search: ${t instanceof Error?t.message:String(t)}`},r),new Error(`Vector search failed: ${t instanceof Error?t.message:String(t)}`)}},ba=(e,r)=>B(["layerSearch","fieldSearch","layersAndFieldsRegistry"],"Data Exploration Agent")(e,r),va=()=>new q(Ue).addNode("requireDataExplorationServices",ba).addNode("vectorSearchLayers",wa).addNode("vectorSearchFields",ya).addNode("fieldStatistics",fa).addNode("queryAgent",sa).addNode("queryTools",ua).addNode("summarizeQueryResponseLLM",la).addNode("filterAgent",na).addNode("filterTools",ca).addNode("earlyExit",Nr).addEdge(k,"requireDataExplorationServices").addEdge("requireDataExplorationServices","vectorSearchLayers").addConditionalEdges("vectorSearchLayers",e=>e.vectorSearchLayerIds.length?"vectorSearchFields":"earlyExit").addConditionalEdges("vectorSearchFields",e=>e.vectorSearchFieldResults.length?"fieldStatistics":"earlyExit").addEdge("fieldStatistics","queryAgent").addConditionalEdges("queryAgent",e=>(e.messages[e.messages.length-1]?.tool_calls?.length??0)>0?"queryTools":"filterAgent").addConditionalEdges("queryTools",e=>e.queryResponse.length?"summarizeQueryResponseLLM":"filterAgent").addEdge("summarizeQueryResponseLLM","filterAgent").addEdge("filterAgent","filterTools").addEdge("filterTools",E).addEdge("summarizeQueryResponseLLM",E).addEdge("earlyExit",E),Sa=String.raw`- **data exploration** — User is asking about the feature layer’s data (e.g. counts, summaries, statistics, field values), either for all features, a subset based on a condition, or for a subset based on the current view. And/Or user wants to include or exclude features based on field values, or visually style features differently (e.g., highlight or deemphasize them).
|
|
55
55
|
The Data Exploration Agent will automatically zoom to the affected features for action taken by this agent. In this case, no need to call navigation tool separately.
|
|
56
56
|
_Example: “Only show stations where Brand is Shell”_
|
|
57
57
|
_Example: “Make Shell stations stand out on the map”_
|
|
@@ -65,13 +65,13 @@ ${m}`}).join(`
|
|
|
65
65
|
`),c;return n.length>0?c=`Vector search completed. Matching layers and fields with scores:
|
|
66
66
|
${l}`:c=`No vector search results found for score over ${Ce}.`,await h({text:c},r),{...e,vectorSearchFieldResults:n}}catch(t){throw await h({text:`Error during vector search: ${t instanceof Error?t.message:String(t)}`},r),new Error(`Vector search failed: ${t instanceof Error?t.message:String(t)}`)}},xa=.7,Ia=async(e,r)=>{try{let t=_(e.messages);await h({text:`Similarity search to find layers: ${t}`},r);let a=b(r,"layerSearch"),o=b(r,"layersAndFieldsRegistry"),i=await a.searchLayers({text:t,minScore:xa}),n=i.map(d=>d.id),l=i.map(({id:d,score:u})=>`${o.get(d)?.layerItem.name??d} (${u.toFixed(2)})`).join(`
|
|
67
67
|
`),c;return n.length>0?c=`Vector search completed. Matching layers with scores:
|
|
68
|
-
${l}`:c="Vector search completed. No matching layers found.",await h({text:c},r),{...e,vectorSearchLayerIds:n}}catch(t){throw await h({text:`Error during vector search: ${t instanceof Error?t.message:String(t)}`},r),new Error(`Vector search failed: ${t instanceof Error?t.message:String(t)}`)}},Ye=["mapView"];function ve(e){let r=e?.configurable?.context;if(!r||typeof r!="object")throw new Error("LayerFilterAgent context missing");let t=Ye.filter(a=>!(a in r));if(t.length)throw new Error(`LayerFilterAgent context missing: ${t.join(", ")}`);return r}var La=async(e,r)=>{try{await h({text:"Getting statistics for vector search results"},r);let t=b(r,"layersAndFieldsRegistry"),{mapView:a}=ve(r),o=await be(e.vectorSearchFieldResults,t,a);return console.log("Field statistics retrieved:",o),await h({text:"Statistics retrieved"},r),{...e,layerFieldInfo:o}}catch(t){throw await h({text:"Error during fetching statistics"},r),new Error(`Error during fetching statistics: ${t instanceof Error?t.message:String(t)}`)}},Xe=async(e,r,t)=>{let a=e.map?.allLayers.find(n=>n.id===r),o=a.createQuery();o.where=t??"1=1";let{features:i}=await a.queryFeatures(o);e.goTo(i)},et=async(e,r)=>{let t=r.map?.allLayers.find(i=>i.id===e.layerId);if(!t)return{error:`Could not find geometry layer with ID: ${e.layerId}`};let a=await t.queryFeatures({where:e.where,returnGeometry:!0});if(!a.features.length)return{error:`No features found in geometry layer with the specified where clause: ${e.where}`};let o;if(a.features.length===1){let i=a.features[0].geometry;if(!i)return{error:"The geometry of the first feature is undefined or null."};o=i}else{let i=a.features.map(l=>l.geometry),n=Y.executeMany(i);if(!n)return{error:"Failed to create a combined geometry."};o=n}return{geometry:o}},$a=async(e,r,t,a,o)=>{let i=r.map?.allLayers.find(l=>l.id===e.layerId);if(!i)return`Could not find target layer with ID: ${e.layerId}`;console.log("Layer type:",i.type),console.log("Layer geometryType:",i.geometryType),console.log("Layer renderer:",i.renderer?.type);let n;if(o){let l=await et(o,r);if("error"in l)return l.error;n=l.geometry}return i.featureEffect=new Pe({filter:new V({where:e.where,geometry:n,spatialRelationship:"intersects",distance:o?.distance,units:o?.units}),includedEffect:t,excludedEffect:a}),i.visible=!0,Xe(r,o?o.layerId:e.layerId,o?o.where:e.where),`Applied feature effects to target layer "${i.title??e.layerId}"${o?` using geometry from layer "${o.layerId}"`:""}.`},Fa=["feet","kilometers","meters","miles","nautical-miles","us-nautical-miles"],tt=s.enum(Fa),_a=async({targetLayer:e,geometryLayer:r,includedEffect:t="drop-shadow(2px, 2px, 2px, gray)",excludedEffect:a="grayscale(100%) opacity(60%) blur(2px)"},o)=>{let{mapView:i}=ve(o);return await $a(e,i,t,a,r)},
|
|
68
|
+
${l}`:c="Vector search completed. No matching layers found.",await h({text:c},r),{...e,vectorSearchLayerIds:n}}catch(t){throw await h({text:`Error during vector search: ${t instanceof Error?t.message:String(t)}`},r),new Error(`Vector search failed: ${t instanceof Error?t.message:String(t)}`)}},Ye=["mapView"];function ve(e){let r=e?.configurable?.context;if(!r||typeof r!="object")throw new Error("LayerFilterAgent context missing");let t=Ye.filter(a=>!(a in r));if(t.length)throw new Error(`LayerFilterAgent context missing: ${t.join(", ")}`);return r}var La=async(e,r)=>{try{await h({text:"Getting statistics for vector search results"},r);let t=b(r,"layersAndFieldsRegistry"),{mapView:a}=ve(r),o=await be(e.vectorSearchFieldResults,t,a);return console.log("Field statistics retrieved:",o),await h({text:"Statistics retrieved"},r),{...e,layerFieldInfo:o}}catch(t){throw await h({text:"Error during fetching statistics"},r),new Error(`Error during fetching statistics: ${t instanceof Error?t.message:String(t)}`)}},Xe=async(e,r,t)=>{let a=e.map?.allLayers.find(n=>n.id===r),o=a.createQuery();o.where=t??"1=1";let{features:i}=await a.queryFeatures(o);e.goTo(i)},et=async(e,r)=>{let t=r.map?.allLayers.find(i=>i.id===e.layerId);if(!t)return{error:`Could not find geometry layer with ID: ${e.layerId}`};let a=await t.queryFeatures({where:e.where,returnGeometry:!0});if(!a.features.length)return{error:`No features found in geometry layer with the specified where clause: ${e.where}`};let o;if(a.features.length===1){let i=a.features[0].geometry;if(!i)return{error:"The geometry of the first feature is undefined or null."};o=i}else{let i=a.features.map(l=>l.geometry),n=Y.executeMany(i);if(!n)return{error:"Failed to create a combined geometry."};o=n}return{geometry:o}},$a=async(e,r,t,a,o)=>{let i=r.map?.allLayers.find(l=>l.id===e.layerId);if(!i)return`Could not find target layer with ID: ${e.layerId}`;console.log("Layer type:",i.type),console.log("Layer geometryType:",i.geometryType),console.log("Layer renderer:",i.renderer?.type);let n;if(o){let l=await et(o,r);if("error"in l)return l.error;n=l.geometry}return i.featureEffect=new Pe({filter:new V({where:e.where,geometry:n,spatialRelationship:"intersects",distance:o?.distance,units:o?.units}),includedEffect:t,excludedEffect:a}),i.visible=!0,Xe(r,o?o.layerId:e.layerId,o?o.where:e.where),`Applied feature effects to target layer "${i.title??e.layerId}"${o?` using geometry from layer "${o.layerId}"`:""}.`},Fa=["feet","kilometers","meters","miles","nautical-miles","us-nautical-miles"],tt=s.enum(Fa),_a=async({targetLayer:e,geometryLayer:r,includedEffect:t="drop-shadow(2px, 2px, 2px, gray)",excludedEffect:a="grayscale(100%) opacity(60%) blur(2px)"},o)=>{let{mapView:i}=ve(o);return await $a(e,i,t,a,r)},Na=s.object({targetLayer:s.object({layerId:s.string().describe("The layerId of the layer on which to set a feature effect."),where:s.string().describe("The SQL-92 where clause representing the features to emphasize.")}),geometryLayer:s.object({layerId:s.string().describe("The layerId of the layer containing the geometry by which to filter."),where:s.string().describe("The SQL-92 where clause representing the features from which to filter features from the targetLayer by geometry."),distance:s.number().describe("The distance by which to filter the input geometry."),units:tt.describe("The units used to filter by geometry and distance.")}).optional().describe("Optional geometry-based filtering parameters for spatial queries."),includedEffect:s.string().optional().default("drop-shadow(2px, 2px, 2px, gray)").describe("The effect applied to features that meet the filter requirements. Valid effects include: bloom, blur, brightness, contrast, drop-shadow, grayscale, hue-rotate, invert, opacity, saturate, and sepia. Prefer default unless specified."),excludedEffect:s.string().optional().default("grayscale(100%) opacity(60%) blur(2px)").describe("The effect applied to features that do not meet the filter requirements. Valid effects include: bloom, blur, brightness, contrast, drop-shadow, grayscale, hue-rotate, invert, opacity, saturate, and sepia. Prefer default unless specified.")}),ka=p(_a,{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:Na}),qa=async(e,r,t)=>{let a=r.map?.allLayers.find(n=>n.id===e.layerId);if(!a)return`Could not find target layer with ID: ${e.layerId}`;let o;if(t){let n=await et(t,r);if("error"in n)return n.error;o=n.geometry}let i=await r.whenLayerView(a);return i.filter=new V({where:e.where,geometry:o,spatialRelationship:"intersects",distance:t?.distance,units:t?.units}),a.visible=!0,Xe(r,t?t.layerId:e.layerId,t?t.where:e.where),`Applied feature filter to layer "${a.title??e.layerId}"${t?` using geometry from layer "${t.layerId}"`:""}.`},Aa=async({targetLayer:e,geometryLayer:r},t)=>{let{mapView:a}=ve(t);return await qa(e,a,r)},Ra=s.object({targetLayer:s.object({layerId:s.string().describe("The layerId of the layer on which to set a filter."),where:s.string().describe("The SQL-92 where clause representing the features to display.")}),geometryLayer:s.object({layerId:s.string().describe("The layerId of the layer containing the geometry by which to filter."),where:s.string().describe("The SQL-92 where clause representing the features from which to filter features from the targetLayer by geometry."),distance:s.number().describe("The distance by which to filter the input geometry."),units:tt.describe("The units used to filter by geometry and distance.")}).optional().describe("Optional geometry-based filtering parameters for spatial queries.")}),Ma=p(Aa,{name:"setFeatureFilter",description:"Sets a client-side filter using a where clause, geometry filter, or both on a target layer. This filters features at the client level in the view.",schema:Ra}),rt=[ka,Ma],za=async(e,r)=>{await h({text:"Requesting LLM for layer filter results"},r);let t=await F("layer_filter_prompt");if(!r?.configurable)throw new Error("config.configurable is required for layer filter tools");let{userTimezone:a,userTimezoneOffset:o}=X(),i={layerFieldInfo:e.layerFieldInfo,userTimezone:a,userTimezoneOffset:o},n=await z({promptText:t,messages:v(e.messages),inputVariables:i,tools:rt}),l=n.content.toString();return await Q(n,r),{...e,messages:[...e.messages,n],outputMessage:l}};async function Ca(e,r){let t=await new A(rt).invoke({messages:v(e.messages)},r),a=t.messages.map(n=>n.text).join(`
|
|
69
69
|
`);await h({text:`Finished executing layer filter tool: ${a}`},r);let o=[...e.messages,...t.messages],i=t.messages.map(n=>n.text).join(`
|
|
70
70
|
`);return{...e,outputMessage:i,messages:o}}var at=y.Root({messages:y({reducer:L,default:()=>[]}),outputMessage:y({reducer:(e="",r)=>{let t=typeof r=="string"?r.trim():"";if(!t)return e;let a=e.trim();if(!a)return t;if(a===t)return e;let o=a.split(`
|
|
71
71
|
|
|
72
72
|
`);return o[o.length-1]?.trim()===t?e:`${e}
|
|
73
73
|
|
|
74
|
-
${t}`},default:()=>""}),vectorSearchLayerIds:y(),vectorSearchFieldResults:y(),layerFieldInfo:y()}),ja=async(e,r)=>(await h({text:"Exiting Layer Filter agent"},r),e),Va=(e,r)=>B(["layerSearch","fieldSearch","layersAndFieldsRegistry"],"Layer Filter Agent")(e,r),Oa=()=>new q(at).addNode("requireLayerFilterServices",Va).addNode("vectorSearchLayers",Ia).addNode("vectorSearchFields",Ea).addNode("fieldStatistics",La).addNode("agent",za).addNode("tools",Ca).addNode("earlyExit",ja).addEdge(
|
|
74
|
+
${t}`},default:()=>""}),vectorSearchLayerIds:y(),vectorSearchFieldResults:y(),layerFieldInfo:y()}),ja=async(e,r)=>(await h({text:"Exiting Layer Filter agent"},r),e),Va=(e,r)=>B(["layerSearch","fieldSearch","layersAndFieldsRegistry"],"Layer Filter Agent")(e,r),Oa=()=>new q(at).addNode("requireLayerFilterServices",Va).addNode("vectorSearchLayers",Ia).addNode("vectorSearchFields",Ea).addNode("fieldStatistics",La).addNode("agent",za).addNode("tools",Ca).addNode("earlyExit",ja).addEdge(k,"requireLayerFilterServices").addEdge("requireLayerFilterServices","vectorSearchLayers").addConditionalEdges("vectorSearchLayers",e=>e.vectorSearchLayerIds.length?"vectorSearchFields":"earlyExit").addConditionalEdges("vectorSearchFields",e=>e.vectorSearchFieldResults.length?"fieldStatistics":"earlyExit").addEdge("fieldStatistics","agent").addConditionalEdges("agent",e=>(e.messages[e.messages.length-1]?.tool_calls?.length??0)>0?"tools":"earlyExit").addEdge("tools","earlyExit").addEdge("earlyExit",E),Da=String.raw`- **layer filter** — User wants to include or exclude features based on field values, or visually style features differently (e.g., highlight or deemphasize them).
|
|
75
75
|
The Layer Filter Agent will automatically zoom to the affected features for action taken by this agent. In this case, no need to call navigation tool separately.
|
|
76
76
|
_Example: “Only show stations where Brand is Shell”_
|
|
77
77
|
_Example: “Make Shell stations stand out on the map”_
|
|
@@ -89,7 +89,7 @@ ${l}`:c="Vector search completed. No matching layers found.",await h({text:c},r)
|
|
|
89
89
|
${o.join(`
|
|
90
90
|
`)}`}),n=`Query results:
|
|
91
91
|
${o.join(`
|
|
92
|
-
`)}`;return{...e,outputMessage:n,messages:[...e.messages,...t,i],queryResponses:a}}var po=async(e,r)=>{try{await h({text:"Requesting LLM for summary on query results"},r);let t=await F("summarize_query_response_prompt"),a={queryResponse:e.queryResponses},o=await ae({promptText:t,messages:v(e.messages),inputVariables:a}),i=typeof o=="string"?o:o.content;return e.messages=[...e.messages,new j(i)],e.outputMessage=i,await h({text:`Received response from LLM: ${i}`},r),e}catch(t){throw await h({text:"Error during filter LLM request"},r),new Error(`Error during filter LLM request: ${t instanceof Error?t.message:String(t)}`)}},wo=(e,r)=>B(["layerSearch","fieldSearch","layersAndFieldsRegistry"],"Layer Query Agent")(e,r),bo=()=>new q(ot).addNode("requireLayerQueryServices",wo).addNode("vectorSearchLayers",Ka).addNode("vectorSearchFields",Qa).addNode("fieldStatistics",Ga).addNode("agent",fo).addNode("tools",yo).addNode("summarizeQueryResponseLLM",po).addNode("earlyExit",Pa).addEdge(
|
|
92
|
+
`)}`;return{...e,outputMessage:n,messages:[...e.messages,...t,i],queryResponses:a}}var po=async(e,r)=>{try{await h({text:"Requesting LLM for summary on query results"},r);let t=await F("summarize_query_response_prompt"),a={queryResponse:e.queryResponses},o=await ae({promptText:t,messages:v(e.messages),inputVariables:a}),i=typeof o=="string"?o:o.content;return e.messages=[...e.messages,new j(i)],e.outputMessage=i,await h({text:`Received response from LLM: ${i}`},r),e}catch(t){throw await h({text:"Error during filter LLM request"},r),new Error(`Error during filter LLM request: ${t instanceof Error?t.message:String(t)}`)}},wo=(e,r)=>B(["layerSearch","fieldSearch","layersAndFieldsRegistry"],"Layer Query Agent")(e,r),bo=()=>new q(ot).addNode("requireLayerQueryServices",wo).addNode("vectorSearchLayers",Ka).addNode("vectorSearchFields",Qa).addNode("fieldStatistics",Ga).addNode("agent",fo).addNode("tools",yo).addNode("summarizeQueryResponseLLM",po).addNode("earlyExit",Pa).addEdge(k,"requireLayerQueryServices").addEdge("requireLayerQueryServices","vectorSearchLayers").addConditionalEdges("vectorSearchLayers",e=>e.vectorSearchLayerIds.length?"vectorSearchFields":"earlyExit").addConditionalEdges("vectorSearchFields",e=>e.vectorSearchFieldResults.length?"fieldStatistics":"earlyExit").addEdge("fieldStatistics","agent").addEdge("agent","tools").addConditionalEdges("tools",e=>e.queryResponses.length?"summarizeQueryResponseLLM":"earlyExit").addEdge("summarizeQueryResponseLLM",E).addEdge("earlyExit",E),vo=String.raw`- **layerQuery** — User is asking about the feature layer’s data (e.g. counts, summaries, statistics, field values), either for all features, a subset based on a condition, or for a subset based on the current view. CRITICAL: Always call the Layer Filter Agent after this agent.
|
|
93
93
|
This also includes questions that ask which feature meets a given condition or where a particular feature in the data is located (e.g., “Where is the spring with the highest elevation?”).
|
|
94
94
|
_Example: “How many features are there?”_
|
|
95
95
|
_Example: “What’s the average population?”_
|
|
@@ -99,7 +99,7 @@ ${m}`}).join(`
|
|
|
99
99
|
`),c;return n.length>0?c=`Vector search completed. Matching layers and fields with scores:
|
|
100
100
|
${l}`:c=`No vector search results found for score over ${Ve}.`,await h({text:c},r),{...e,vectorSearchFieldResults:n}}catch(t){throw await h({text:`Error during vector search: ${t instanceof Error?t.message:String(t)}`},r),new Error(`Vector search failed: ${t instanceof Error?t.message:String(t)}`)}},Eo=.7,xo=async(e,r)=>{try{let t=_(e.messages);await h({text:`Similarity search to find layers: ${t}`},r);let a=b(r,"layerSearch"),o=b(r,"layersAndFieldsRegistry"),i=await a.searchLayers({text:t,minScore:Eo}),n=i.map(d=>d.id),l=i.map(({id:d,score:u})=>`${o.get(d)?.layerItem.name??d} (${u.toFixed(2)})`).join(`
|
|
101
101
|
`),c;return n.length>0?c=`Vector search completed. Matching layers with scores:
|
|
102
|
-
${l}`:c="Vector search completed. No matching layers found.",await h({text:c},r),{...e,vectorSearchLayerIds:n}}catch(t){throw await h({text:`Error during vector search: ${t instanceof Error?t.message:String(t)}`},r),new Error(`Vector search failed: ${t instanceof Error?t.message:String(t)}`)}};async function Io(e){let{fields:r,layer:t,view:a,styleName:o,colorSchemeTags:i}=e,n;return i?n=pt({basemapTheme:await
|
|
102
|
+
${l}`:c="Vector search completed. No matching layers found.",await h({text:c},r),{...e,vectorSearchLayerIds:n}}catch(t){throw await h({text:`Error during vector search: ${t instanceof Error?t.message:String(t)}`},r),new Error(`Vector search failed: ${t instanceof Error?t.message:String(t)}`)}};async function Io(e){let{fields:r,layer:t,view:a,styleName:o,colorSchemeTags:i}=e,n;return i?n=pt({basemapTheme:await ke(a),geometryType:t.geometryType,includedTags:i,numColors:Math.min(r.length,8)})[0]:n=wt({basemapTheme:await ke(a),geometryType:t.geometryType,numColors:Math.min(r.length,8)}).primaryScheme,{layer:t,view:a,attributes:r.map(l=>({field:l,label:t.fields.find(c=>c.name===l)?.alias??""})).slice(0,8),outlineOptimizationEnabled:!0,sizeOptimizationEnabled:!0,includeSizeVariable:o.includes("Size"),pieChartScheme:n}}async function Lo(e){return await yt(e)}async function $o({arcgisMap:e,arcgisMapView:r,layerId:t,fields:a,colorSchemes:o,includeSize:i}){let n=r,l=e?.allLayers.find(d=>d.id===t);if(!l)return`Could not find layer for id: ${t}`;let c={styleName:i?"chart-size":"chart",fields:a,layer:l,view:n,colorSchemeTags:o};try{let d=await Io(c),u=await Lo(d);return l.renderer=u.renderer,l.visible=!0,`Chart renderer applied to layer: ${l.title??l.id} using fields ${a.join(", ")}`}catch(d){return`Error applying chart renderer: ${d instanceof Error?d.message:String(d)}`}}var Fo=["mapView"];function I(e){let r=e?.configurable?.context;if(!r||typeof r!="object")throw new Error("LayerStylingAgent context missing");let t=Fo.filter(a=>!(a in r));if(t.length)throw new Error(`LayerStylingAgent context missing: ${t.join(", ")}`);return r}async function _o({layerId:e,fields:r,colorSchemes:t,includeSize:a},o){let{mapView:i}=I(o);return await x({id:"show-legend",description:"Show Legend",payload:{layerIds:[e]}},o),await $o({arcgisMap:i.map,arcgisMapView:i,layerId:e,fields:r,colorSchemes:t,includeSize:a})}var No=s.object({layerId:s.string().describe("The id of the layer to apply the chart renderer to"),fields:s.array(s.string()).describe("The fields to use for the chart renderer (multiple numeric fields)"),colorSchemes:s.array(s.string()).optional().describe("Optional color scheme tags to use"),includeSize:s.boolean().optional().describe("Whether to vary the chart size (chart-size)")}),ko=p(_o,{name:"chart",description:`Label: Charts
|
|
103
103
|
Description: Show the values of two or more categories as a proportion of the total using a pie chart.
|
|
104
104
|
Keywords: pie, chart, all categories, breakdown, proportion
|
|
105
105
|
Example: Show the total number of homes built in each decade using a pie chart for each feature.
|
|
@@ -109,7 +109,7 @@ ${l}`:c="Vector search completed. No matching layers found.",await h({text:c},r)
|
|
|
109
109
|
Description: Show the values of two or more categories as a proportion of the total using a pie chart and use size to capture the total amount or magnitude.
|
|
110
110
|
Keywords: pie, chart, all categories, breakdown, proportion, total, amount, how much, sum, graduated size, proportional size
|
|
111
111
|
Example: Show the total number of homes built in each decade using a pie chart for each feature and vary the size of each chart based on the total of all categories.
|
|
112
|
-
Fields: This style requires 2-8 number fields.`,schema:
|
|
112
|
+
Fields: This style requires 2-8 number fields.`,schema:No});function qo(e){let{fields:r,layer:t,view:a,theme:o,colorSchemeTags:i}=e,n=r[0],l;return i&&(l=ye({geometryType:t.geometryType,includedTags:i,theme:o||"high-to-low"})[0]),{layer:t,view:a,startTime:n,endTime:new Date,theme:o,sizeOptimizationEnabled:!0,outlineOptimizationEnabled:!0,colorScheme:l}}async function Ao(e){return await bt(e)}async function Ro({arcgisMap:e,arcgisMapView:r,layerId:t,fields:a,colorSchemes:o,theme:i}){let n=r,l=e?.allLayers.find(d=>d.id===t);if(!l)return`Could not find layer for id: ${t}`;let c={styleName:"color-age",fields:a,layer:l,view:n,colorSchemeTags:o,theme:i};try{let d=qo(c),u=await Ao(d);return l.renderer=u.renderer,l.visible=!0,`Color-age renderer applied to layer: ${l.title??l.id} using fields ${a.join(", ")}`}catch(d){return`Error applying color-age renderer: ${d instanceof Error?d.message:String(d)}`}}async function Mo({layerId:e,fields:r,colorSchemes:t,theme:a},o){let{mapView:i}=I(o);return await x({id:"show-legend",description:"Show Legend",payload:{layerIds:[e]}},o),await Ro({arcgisMap:i.map,arcgisMapView:i,layerId:e,fields:r,colorSchemes:t,theme:a})}var zo=s.object({layerId:s.string().describe("The id of the layer to apply the color-age renderer to"),fields:s.array(s.string()).describe("The field(s) to use for the color-age renderer (temporal/date data)"),colorSchemes:s.array(s.string()).optional().describe("Optional color scheme tags to use"),theme:s.enum(["above-and-below","above","below","centered-on","extremes","high-to-low"]).optional().describe("Optional theme for the color ramp")}),Co=p(Mo,{name:"color-age",description:`Label: Age (color)
|
|
113
113
|
Description: Use colors along a continuous color ramp to represent the age of features. Age reflects the length of time from a start date to an end date.
|
|
114
114
|
Keywords: since, age, how old, how long
|
|
115
115
|
Example: Show the age of each feature based on its reported date.
|
|
@@ -150,11 +150,11 @@ Fields: This typically requires zero or one field of type number.`,schema:ni});f
|
|
|
150
150
|
Description: Overlays two color ramps to represent the relationship between two numeric attributes.
|
|
151
151
|
Keywords: relationship, correlation, compare, related, bivariate choropleth, bivariate color
|
|
152
152
|
Example: Show the relationship between tree height and carbon storage
|
|
153
|
-
Fields: This style requires two number fields.`,schema:wi});function vi(e){let{fields:r,layer:t,view:a,theme:o}=e,i=r[0];return{layer:t,view:a,startTime:i,endTime:new Date,theme:o,sizeOptimizationEnabled:!0,outlineOptimizationEnabled:!0}}async function Si(e){return await
|
|
153
|
+
Fields: This style requires two number fields.`,schema:wi});function vi(e){let{fields:r,layer:t,view:a,theme:o}=e,i=r[0];return{layer:t,view:a,startTime:i,endTime:new Date,theme:o,sizeOptimizationEnabled:!0,outlineOptimizationEnabled:!0}}async function Si(e){return await Nt(e)}async function Ti({arcgisMap:e,arcgisMapView:r,layerId:t,fields:a,colorSchemes:o,theme:i}){let n=r,l=e?.allLayers.find(d=>d.id===t);if(!l)return`Could not find layer for id: ${t}`;let c={styleName:"size-age",fields:a,layer:l,view:n,colorSchemeTags:o,theme:i};try{let d=vi(c),u=await Si(d);return l.renderer=u.renderer,l.visible=!0,`Size-age renderer applied to layer: ${l.title??l.id} using fields ${a.join(", ")}`}catch(d){return`Error applying size-age renderer: ${d instanceof Error?d.message:String(d)}`}}async function Ei({layerId:e,fields:r,colorSchemes:t,theme:a},o){let{mapView:i}=I(o);return await x({id:"show-legend",description:"Show Legend",payload:{layerIds:[e]}},o),await Ti({arcgisMap:i.map,arcgisMapView:i,layerId:e,fields:r,colorSchemes:t,theme:a})}var xi=s.object({layerId:s.string().describe("The id of the layer to apply the size-age renderer to"),fields:s.array(s.string()).describe("The field(s) to use for the size-age renderer (temporal data with size)"),colorSchemes:s.array(s.string()).optional().describe("Optional color scheme tags to use"),theme:s.enum(["above-and-below","above","below","centered-on","extremes","high-to-low"]).optional().describe("Optional theme for the size ramp")}),Ii=p(Ei,{name:"size-age",description:`Label: Age (size)
|
|
154
154
|
Description: Vary symbol sizes along a continuous ramp to represent the age of features. Age reflects the length of time from a start date to an end date.
|
|
155
155
|
Keywords: since, age, how old, how long
|
|
156
156
|
Example: Change the size of features so older features are larger than new features.
|
|
157
|
-
Fields: This style requires at least one field with a date type.`,schema:xi});function Li(e){let{fields:r,layer:t,view:a}=e,{theme:o}=e,i=r[1],n=r[0];return{layer:t,view:a,field:n,normalizationField:i,theme:o,sizeOptimizationEnabled:!0,outlineOptimizationEnabled:!0}}async function $i(e){return await
|
|
157
|
+
Fields: This style requires at least one field with a date type.`,schema:xi});function Li(e){let{fields:r,layer:t,view:a}=e,{theme:o}=e,i=r[1],n=r[0];return{layer:t,view:a,field:n,normalizationField:i,theme:o,sizeOptimizationEnabled:!0,outlineOptimizationEnabled:!0}}async function $i(e){return await kt(e)}async function Fi({arcgisMap:e,arcgisMapView:r,layerId:t,fields:a,colorSchemes:o,theme:i}){let n=r,l=e?.allLayers.find(d=>d.id===t);if(!l)return`Could not find layer for id: ${t}`;let c={styleName:"size",fields:a,layer:l,view:n,colorSchemeTags:o,theme:i};try{let d=Li(c),u=await $i(d);return l.renderer=u.renderer,l.visible=!0,`Size renderer applied to layer: ${l.title??l.id} using fields ${a.join(", ")}`}catch(d){return`Error applying size renderer: ${d instanceof Error?d.message:String(d)}`}}async function _i({layerId:e,fields:r,colorSchemes:t,theme:a},o){let{mapView:i}=I(o);return await x({id:"show-legend",description:"Show Legend",payload:{layerIds:[e]}},o),await Fi({arcgisMap:i.map,arcgisMapView:i,layerId:e,fields:r,colorSchemes:t,theme:a})}var Ni=s.object({layerId:s.string().describe("The id of the layer to apply the size renderer to"),fields:s.array(s.string()).describe("The field(s) to use for the size renderer (numeric data)"),colorSchemes:s.array(s.string()).optional().describe("Optional color scheme tags to use"),theme:s.enum(["above-and-below","above","below","centered-on","extremes","high-to-low"]).optional().describe("Optional theme for the size ramp")}),ki=p(_i,{name:"size",description:`Label: Counts and Amounts (size)
|
|
158
158
|
Description: Vary symbol sizes along a continuous ramp to represent numeric or ranked data.
|
|
159
159
|
Keywords: graduated size, proportional size, how much, total, number, amount, size
|
|
160
160
|
Example: Vary the size of each point based on the total population.
|
|
@@ -164,17 +164,17 @@ Fields: This typically requires zero or one field of type number.`,schema:ni});f
|
|
|
164
164
|
Description: Vary symbol sizes along a continuous ramp to represent dates.
|
|
165
165
|
Keywords: graduated size, proportional size, classed size, how much, total, number, when
|
|
166
166
|
Example: Vary the size of each feature based on the date a ticket was completed.
|
|
167
|
-
Fields: This style requires a single field with a date type.`,schema:
|
|
167
|
+
Fields: This style requires a single field with a date type.`,schema:Ni});function qi(e){let{fields:r,layer:t,view:a,colorSchemeTags:o}=e;console.log("processTypeRendererParams",e);let i=r[0],n=r[1],l=r[2],c;return o&&(c=At({geometryType:t.geometryType,includedTags:o})[0]),{layer:t,view:a,field:i,field2:n,field3:l,outlineOptimizationEnabled:!0,sizeOptimizationEnabled:!0,typeScheme:c}}async function Ai(e){return await qt(e)}async function Ri({arcgisMap:e,arcgisMapView:r,layerId:t,fields:a,colorSchemes:o,theme:i}){let n=r,l=e?.allLayers.find(d=>d.id===t);if(!l)return`Could not find layer for id: ${t}`;let c={styleName:"type",fields:a,layer:l,view:n,colorSchemeTags:o,theme:i};try{let d=qi(c),u=await Ai(d);return l.renderer=u.renderer,l.visible=!0,`Type renderer applied to layer: ${l.title??l.id} using fields ${a.join(", ")}`}catch(d){return`Error applying type renderer: ${d instanceof Error?d.message:String(d)}`}}async function Mi({layerId:e,fields:r,colorSchemes:t,theme:a},o){let{mapView:i}=I(o);return await x({id:"show-legend",description:"Show Legend",payload:{layerIds:[e]}},o),await Ri({arcgisMap:i.map,arcgisMapView:i,layerId:e,fields:r,colorSchemes:t,theme:a})}var zi=s.object({layerId:s.string().describe("The id of the layer to apply the type renderer to"),fields:s.array(s.string()).describe("The field(s) to use for the type renderer (categorical data)"),colorSchemes:s.array(s.string()).optional().describe("Optional color scheme tags to use"),theme:s.enum(["above-and-below","above","below","centered-on","extremes","high-to-low"]).optional().describe("Optional theme for the color scheme")}),Ci=p(Mi,{name:"type",description:`Label: Types (unique symbols)
|
|
168
168
|
Description: Represent features as categories with different symbol colors or shapes. Examples include type of tree, road class, or province name.
|
|
169
169
|
Keywords: categorical, category, type, unique, discrete, point of interest, region, group
|
|
170
170
|
Example: Color each feature based on the region it belongs to
|
|
171
|
-
Fields: This style requires a single field which may be a string, number, or date type. It is usually a string.`,schema:zi}),nt=[
|
|
171
|
+
Fields: This style requires a single field which may be a string, number, or date type. It is usually a string.`,schema:zi}),nt=[ko,Co,Go,Jo,ti,si,mi,bi,Ii,ki,Ci],ji=async(e,r)=>{await h({text:"Requesting LLM for layer query results"},r);let t=await F("navigation_intent_prompt");if(!r?.configurable)throw new Error("config.configurable is required for layer query tools");let a={layerFieldInfo:e.layerFieldInfo},o=await z({promptText:t,messages:v(e.messages),inputVariables:a,tools:nt});return await Q(o,r),{...e,messages:[...e.messages,o]}};async function Vi(e,r){let t=await new A(nt).invoke({messages:v(e.messages)},r),a=t.messages.map(i=>i.text).join(`
|
|
172
172
|
`);await h({text:`Finished executing layer filter tool: ${a}`},r);let o=t.messages.map(i=>i.text).join(`
|
|
173
173
|
`);return{...e,outputMessage:o}}var st=y.Root({messages:y({reducer:L,default:()=>[]}),outputMessage:y({reducer:(e="",r)=>{let t=typeof r=="string"?r.trim():"";if(!t)return e;let a=e.trim();if(!a)return t;if(a===t)return e;let o=a.split(`
|
|
174
174
|
|
|
175
175
|
`);return o[o.length-1]?.trim()===t?e:`${e}
|
|
176
176
|
|
|
177
|
-
${t}`},default:()=>""}),vectorSearchLayerIds:y(),vectorSearchFieldResults:y(),layerFieldInfo:y(),selectedLayerId:y()}),Oi=async(e,r)=>(await h({text:"Exiting Layer Styling agent"},r),e),Di=async(e,r)=>{try{await h({text:"Populating layer and field info"},r);let t=[];for(let a of e.vectorSearchFieldResults){let o=function(u){let m=l.get(u)?.layerItem;return m?[m.name&&`Name: ${m.name}`,m.title&&`Title: ${m.title}`,m.description&&`Description: ${m.description}`].filter(Boolean).join(" | "):u},{layerId:i,results:n}=a,l=b(r,"layersAndFieldsRegistry"),c=l.get(i)?.fieldRegistry;if(!c)continue;let d=t.find(u=>u.layerId===i);d||(d={layerId:i,layerSummary:o(i),fieldInfos:[]},t.push(d));for(let u of n){let m=c.get(u.name);m&&d.fieldInfos.push(m)}}return console.log("Populated layerFieldInfo:",t),await h({text:"Populated layerFieldInfo"},r),{...e,layerFieldInfo:t}}catch(t){throw await h({text:"Error populating layerFieldInfo"},r),new Error(`Error populating layerFieldInfo: ${t instanceof Error?t.message:String(t)}`)}},Pi=(e,r)=>{let t=e.vectorSearchLayerIds??[];if(t.length<=1)return{...e,selectedLayerId:e.vectorSearchLayerIds[0]};let{hitlResponse:a}=r.configurable;if(console.log("hitlResponse:",a),!a||a.agentId!==Oe.id||a.id!=="reviewLayerSelection"){let i={agentId:Oe.id,id:"reviewLayerSelection",kind:"singleSelection",message:"Choose a layer to apply the styles.",metadata:[...t]};throw new xe(i)}let o=null;return Array.isArray(a.payload)&&a.payload.length>0&&(o=a.payload[0]),{...e,selectedLayerId:o??e.vectorSearchLayerIds[0]}},Gi=(e,r)=>B(["layerSearch","fieldSearch","layersAndFieldsRegistry"],"Layer Styling Agent")(e,r),Bi=()=>new q(st).addNode("requireLayerStylingServices",Gi).addNode("vectorSearchLayers",xo).addNode("layerSelectionHITL",Pi).addNode("vectorSearchFields",To).addNode("populateLayerFieldInfo",Di).addNode("agent",ji).addNode("tools",Vi).addNode("earlyExit",Oi).addEdge(
|
|
177
|
+
${t}`},default:()=>""}),vectorSearchLayerIds:y(),vectorSearchFieldResults:y(),layerFieldInfo:y(),selectedLayerId:y()}),Oi=async(e,r)=>(await h({text:"Exiting Layer Styling agent"},r),e),Di=async(e,r)=>{try{await h({text:"Populating layer and field info"},r);let t=[];for(let a of e.vectorSearchFieldResults){let o=function(u){let m=l.get(u)?.layerItem;return m?[m.name&&`Name: ${m.name}`,m.title&&`Title: ${m.title}`,m.description&&`Description: ${m.description}`].filter(Boolean).join(" | "):u},{layerId:i,results:n}=a,l=b(r,"layersAndFieldsRegistry"),c=l.get(i)?.fieldRegistry;if(!c)continue;let d=t.find(u=>u.layerId===i);d||(d={layerId:i,layerSummary:o(i),fieldInfos:[]},t.push(d));for(let u of n){let m=c.get(u.name);m&&d.fieldInfos.push(m)}}return console.log("Populated layerFieldInfo:",t),await h({text:"Populated layerFieldInfo"},r),{...e,layerFieldInfo:t}}catch(t){throw await h({text:"Error populating layerFieldInfo"},r),new Error(`Error populating layerFieldInfo: ${t instanceof Error?t.message:String(t)}`)}},Pi=(e,r)=>{let t=e.vectorSearchLayerIds??[];if(t.length<=1)return{...e,selectedLayerId:e.vectorSearchLayerIds[0]};let{hitlResponse:a}=r.configurable;if(console.log("hitlResponse:",a),!a||a.agentId!==Oe.id||a.id!=="reviewLayerSelection"){let i={agentId:Oe.id,id:"reviewLayerSelection",kind:"singleSelection",message:"Choose a layer to apply the styles.",metadata:[...t]};throw new xe(i)}let o=null;return Array.isArray(a.payload)&&a.payload.length>0&&(o=a.payload[0]),{...e,selectedLayerId:o??e.vectorSearchLayerIds[0]}},Gi=(e,r)=>B(["layerSearch","fieldSearch","layersAndFieldsRegistry"],"Layer Styling Agent")(e,r),Bi=()=>new q(st).addNode("requireLayerStylingServices",Gi).addNode("vectorSearchLayers",xo).addNode("layerSelectionHITL",Pi).addNode("vectorSearchFields",To).addNode("populateLayerFieldInfo",Di).addNode("agent",ji).addNode("tools",Vi).addNode("earlyExit",Oi).addEdge(k,"requireLayerStylingServices").addEdge("requireLayerStylingServices","vectorSearchLayers").addConditionalEdges("layerSelectionHITL",e=>e.vectorSearchLayerIds.length?"vectorSearchFields":"earlyExit").addConditionalEdges("vectorSearchFields",e=>e.vectorSearchFieldResults.length?"populateLayerFieldInfo":"earlyExit").addEdge("populateLayerFieldInfo","agent").addEdge("agent","tools").addEdge("tools",E).addEdge("earlyExit",E),Qi=String.raw`- **layerStyling** — User wants to change how features are drawn or styled on the map based on their data, such as applying color, size, transparency, symbols, or charts according to field values.
|
|
178
178
|
_Example: “Color points by sales amount”_
|
|
179
179
|
_Example: “Show population density with a color gradient”_
|
|
180
180
|
_Example: “Create a relationship map between height and depth”_
|
|
@@ -199,12 +199,18 @@ ${t}`},default:()=>""})});var cl=String.raw`- **help** — Enables users to ask
|
|
|
199
199
|
|
|
200
200
|
`);return o[o.length-1]?.trim()===t?e:`${e}
|
|
201
201
|
|
|
202
|
-
${t}`},default:()=>""}),intent:y({reducer:(e,r)=>r})}),Z={conversationId:""},Wi=["linkChartView"],Ki=["knowledgeGraph"];function ee(e){let r=e?.configurable?.context;if(!r||typeof r!="object")throw new Error("ArcgisKnowledgeAgent context missing");let t=Wi.filter(a=>!(a in r));if(t.length)throw new Error(`Link Chart context missing: ${t.join(", ")}`);return r}function Te(e){let r=e?.configurable?.context;if(!r||typeof r!="object")throw new Error("ArcgisKnowledgeAgent context missing");let t=Ki.filter(a=>!(a in r));if(t.length)throw new Error(`Knowledge Graph context missing: ${t.join(", ")}`);return r}var ce=class{constructor(r){this.dataModel=r,this.kind="GraphQueryGenerationRequest",this.explainQuery=!0,this.schemaInformation=de.fromDataModel(r)}},de=class e{constructor(){this.schemaType="ArcgisGraphSchema",this.entityTypes=[],this.relationshipTypes=[],this.identifierInfo={mappingInfo:{identifierMapsTo:"UniformPropertyIdentifier",identifierPropertyName:"globalid"}}}static fromDataModel(r){let t=new e;for(let a of r.entityTypes)t.entityTypes.push(G.fromEntityType(a));for(let a of r.relationshipTypes)t.relationshipTypes.push(ue.fromRelationshipType(a));return t.identifierInfo={mappingInfo:{identifierMapsTo:Ui(r.identifierInfo.identifierMappingInfo.identifierInfoType),identifierPropertyName:r.identifierInfo.identifierMappingInfo.uniformPropertyIdentifier.identifierPropertyName}},t.spatialReference=JSON.parse(JSON.stringify(r.spatialReference)),t}},G=class e{constructor(){this.name="",this.properties=[]}static fromEntityType(r){let t=new e;t.name=r.name,t.alias=r.alias?r.alias:void 0,t.role=Ji(r.role);for(let a of r.properties){let o={name:a.name,alias:a.alias?a.alias:void 0,fieldType:a.fieldType,role:Zi(a.role),geometryDef:a.fieldType==="esriFieldTypeGeometry"?{geometryType:a.geometryType??"esriGeometryAny",hasM:a.hasM?a.hasM:void 0,hasZ:a.hasZ?a.hasZ:void 0}:void 0};t.properties.push(o)}return t}},ue=class extends G{constructor(){super(...arguments),this.observedEndPoints=[]}static fromRelationshipType(r){let t=G.fromEntityType(r);t.observedEndPoints=[];for(let a of r.endPoints)t.observedEndPoints.push({originEntityType:a.originEntityType,destinationEntityType:a.destinationEntityType});return t}},Ui=e=>{switch(e){case"esriIdentifierInfoTypeUNSPECIFIED":return"UNSPECIFIED";case"esriIdentifierInfoTypeDatabaseNative":return"DatabaseNative";case"esriIdentifierInfoTypeUniformProperty":return"UniformPropertyIdentifier";default:return e}},Ji=e=>{switch(e){case"Regular":return"esriGraphNamedObjectRegular";case"Provenance":return"esriGraphNamedObjectProvenance";case"Document":return"esriGraphNamedObjectDocument";default:return e}};function Zi(e){switch(e){case"esriGraphPropertyRegular":return"Regular";case"esriGraphPropertyDocumentName":return"Document_Name";case"esriGraphPropertyDocumentTitle":return"Document_Title";case"esriGraphPropertyDocumentUrl":return"Document_Url";case"esriGraphPropertyDocumentText":return"Document_Text";case"esriGraphPropertyDocumentKeywords":return"Document_Keywords";case"esriGraphPropertyDocumentContentType":return"Document_ContentType";case"esriGraphPropertyDocumentMetadata":return"Document_Metadata";case"esriGraphPropertyDocumentFileExtension":return"Document_FileExtension";case"esriGraphPropertyProvenanceInstanceId":return"Provenance_InstanceId";case"esriGraphPropertyProvenanceSourceType":return"Provenance_SourceType";case"esriGraphPropertyProvenanceSourceName":return"Provenance_SourceName";case"esriGraphPropertyProvenanceSource":return"Provenance_Source";case"esriGraphPropertyProvenanceComment":return"Provenance_Comment";case"esriGraphPropertyProvenanceTypeName":return"Provenance_TypeName";case"esriGraphPropertyProvenancePropertyName":return"Provenance_PropertyName";default:return"Regular"}}async function Hi(e,r,t,a){let{graphQuery:o,explanation:i}=await Ee(e,r,t,a);return`Generated Graph Query:
|
|
203
|
-
|
|
202
|
+
${t}`},default:()=>""}),intent:y({reducer:(e,r)=>r})}),Z={conversationId:""},Wi=["linkChartView"],Ki=["knowledgeGraph"];function ee(e){let r=e?.configurable?.context;if(!r||typeof r!="object")throw new Error("ArcgisKnowledgeAgent context missing");let t=Wi.filter(a=>!(a in r));if(t.length)throw new Error(`Link Chart context missing: ${t.join(", ")}`);return r}function Te(e){let r=e?.configurable?.context;if(!r||typeof r!="object")throw new Error("ArcgisKnowledgeAgent context missing");let t=Ki.filter(a=>!(a in r));if(t.length)throw new Error(`Knowledge Graph context missing: ${t.join(", ")}`);return r}var ce=class{constructor(r){this.dataModel=r,this.kind="GraphQueryGenerationRequest",this.explainQuery=!0,this.schemaInformation=de.fromDataModel(r)}},de=class e{constructor(){this.schemaType="ArcgisGraphSchema",this.entityTypes=[],this.relationshipTypes=[],this.identifierInfo={mappingInfo:{identifierMapsTo:"UniformPropertyIdentifier",identifierPropertyName:"globalid"}}}static fromDataModel(r){let t=new e;for(let a of r.entityTypes)t.entityTypes.push(G.fromEntityType(a));for(let a of r.relationshipTypes)t.relationshipTypes.push(ue.fromRelationshipType(a));return t.identifierInfo={mappingInfo:{identifierMapsTo:Ui(r.identifierInfo.identifierMappingInfo.identifierInfoType),identifierPropertyName:r.identifierInfo.identifierMappingInfo.uniformPropertyIdentifier.identifierPropertyName}},t.spatialReference=JSON.parse(JSON.stringify(r.spatialReference)),t}},G=class e{constructor(){this.name="",this.properties=[]}static fromEntityType(r){let t=new e;t.name=r.name,t.alias=r.alias?r.alias:void 0,t.role=Ji(r.role);for(let a of r.properties){let o={name:a.name,alias:a.alias?a.alias:void 0,fieldType:a.fieldType,role:Zi(a.role),geometryDef:a.fieldType==="esriFieldTypeGeometry"?{geometryType:a.geometryType??"esriGeometryAny",hasM:a.hasM?a.hasM:void 0,hasZ:a.hasZ?a.hasZ:void 0}:void 0};t.properties.push(o)}return t}},ue=class extends G{constructor(){super(...arguments),this.observedEndPoints=[]}static fromRelationshipType(r){let t=G.fromEntityType(r);t.observedEndPoints=[];for(let a of r.endPoints)t.observedEndPoints.push({originEntityType:a.originEntityType,destinationEntityType:a.destinationEntityType});return t}},Ui=e=>{switch(e){case"esriIdentifierInfoTypeUNSPECIFIED":return"UNSPECIFIED";case"esriIdentifierInfoTypeDatabaseNative":return"DatabaseNative";case"esriIdentifierInfoTypeUniformProperty":return"UniformPropertyIdentifier";default:return e}},Ji=e=>{switch(e){case"Regular":return"esriGraphNamedObjectRegular";case"Provenance":return"esriGraphNamedObjectProvenance";case"Document":return"esriGraphNamedObjectDocument";default:return e}};function Zi(e){switch(e){case"esriGraphPropertyRegular":return"Regular";case"esriGraphPropertyDocumentName":return"Document_Name";case"esriGraphPropertyDocumentTitle":return"Document_Title";case"esriGraphPropertyDocumentUrl":return"Document_Url";case"esriGraphPropertyDocumentText":return"Document_Text";case"esriGraphPropertyDocumentKeywords":return"Document_Keywords";case"esriGraphPropertyDocumentContentType":return"Document_ContentType";case"esriGraphPropertyDocumentMetadata":return"Document_Metadata";case"esriGraphPropertyDocumentFileExtension":return"Document_FileExtension";case"esriGraphPropertyProvenanceInstanceId":return"Provenance_InstanceId";case"esriGraphPropertyProvenanceSourceType":return"Provenance_SourceType";case"esriGraphPropertyProvenanceSourceName":return"Provenance_SourceName";case"esriGraphPropertyProvenanceSource":return"Provenance_Source";case"esriGraphPropertyProvenanceComment":return"Provenance_Comment";case"esriGraphPropertyProvenanceTypeName":return"Provenance_TypeName";case"esriGraphPropertyProvenancePropertyName":return"Provenance_PropertyName";default:return"Regular"}}async function Hi(e,r,t,a){let{graphQuery:o,explanation:i}=await Ee(e,r,t,a);return`Generated Graph Query:
|
|
203
|
+
${o}
|
|
204
|
+
|
|
205
|
+
Explanation: ${i}`}async function Ee(e,r,t,a){let o={message:e,context:new ce(r)};Z.conversationId&&(o.conversationId=Z.conversationId),await h({text:"Attempting to generate a cypher query from your prompt..."},a);let i=await qe(`${t}/chat`,{method:"post",body:JSON.stringify(o),headers:{"Content-Type":"application/json",token:Ae.findCredential(P.getDefault().url)?.token??""}});if(i.httpStatus!==200)throw new Error(`Graph query service returned an error: ${i.httpStatus}`,{cause:i.data});Z.conversationId||(Z.conversationId=i.data.conversationId);let n=!1,l=Date.now(),c=i.data.sequenceNumber,d="",u="",m=1;for(;!n;){await new Promise(g=>setTimeout(g,1e3)),await h({text:`Periodically requesting status of job from ArcGIS AI Services${"...".substring(0,m)}`},a),m=m%3+1;let f=await qe(`${t}/chat`,{method:"post",body:JSON.stringify({conversationId:i.data.conversationId,inquiryId:i.data.inquiryId,ackSequenceNumber:c}),headers:{"Content-Type":"application/json",token:Ae.findCredential(P.getDefault().url)?.token??""}});if(f.httpStatus!==200)throw new Error(`Graph query service polling returned an error: ${f.httpStatus}`,{cause:f.data});if(f.data.context)d=f.data.context.graphQuery,u=f.data.message||"";else if(!f.data.hasMore)n=!0;else if(Date.now()-l>6e4)throw new Error("Graph query service polling timed out after 1 minute.");c=f.data.sequenceNumber}return{graphQuery:d,explanation:u}}function H(e,r){if(!(!e||typeof e!="object")){if(Xi(e))for(let t of e.path)H(t,r);else if(Yi(e))r.set(`${e.typeName}__${e.id}`,{id:e.id,typeName:e.typeName});else if(Array.isArray(e))for(let t of e)H(t,r);else if(en(e))for(let t of Object.values(e.properties??{}))H(t,r)}}function Yi(e){return!e||typeof e!="object"||Array.isArray(e)?!1:"id"in e&&"typeName"in e}function Xi(e){return!e||typeof e!="object"||Array.isArray(e)?!1:e&&"path"in e&&Array.isArray(e.path)}function en(e){return!e||typeof e!="object"||Array.isArray(e)||"id"in e?!1:"properties"in e&&typeof e.properties=="object"}function tn(e,r){let t=[];for(let a of[...r.dataModel.entityTypes,...r.dataModel.relationshipTypes]){let o=e.getMemberIdsByType(a.name);for(let i of o)t.push({id:i,typeName:a.name})}return t}var rn=async e=>{let r=new Map,t=e.resultRowsStream.getReader();for(;;){let{done:a,value:o}=await t.read();if(a)break;for(let i of o)for(let n of i)H(n,r)}return Array.from(r.values())};async function an(e,r,t,a,o){let{graphQuery:i,explanation:n}=await Ee(e,r.dataModel,t,o);await h({text:`Attempting to execute query: ${i.substring(0,500)}${i.length>500?"...":""}`},o);let l=await Rt(r,new We({openCypherQuery:i}),{signal:o?.signal,timeout:o?.timeout}),c=await rn(l);return await h({text:`Query Results parsed into ${c.length} unique relationships and entities. Atempting to add to link chart...`},o),await a.map.addRecords(c),a.goTo(a.map.diagramNodesExtent),`Link Chart updated successfully. Cypher Query used:
|
|
206
|
+
${i}
|
|
207
|
+
|
|
204
208
|
Explanation: ${n}`}async function on({prompt:e},r){let{knowledgeGraph:t}=Te(r),{linkChartView:a}=ee(r),o=P.getDefault().helperServices,i=await F("arcgis_knowledge_current_lc_context"),n=tn(a.map,t),l=`${e}
|
|
205
209
|
|
|
206
|
-
${i}${JSON.stringify(n)}`;return await an(l,t,`${o.aiAssistantServices.url}${o.aiAssistantServices.graphQueryAssistant}`,a,r)}var nn=s.object({prompt:s.string().describe("The user's inquiry into the knowledge graph that needs to be run.")}),ul=p(on,{name:"addRecords",description:"Adds records (entities or relationships) to the current 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 records to be added to the link chart. The user should have explicitly requested to add records to the current link chart from their prompt.",schema:nn});async function sn(e,r){return await r.map.applyLayout(e),`Successfully applied layout: ${e}.`}async function ln({layout:e},r){let{linkChartView:t}=ee(r);return await sn(e,t)}var cn=s.object({layout:s.enum(["organic-standard","organic-community","basic-grid","hierarchical-bottom-to-top","radial-root-centric","tree-left-to-right","geographic-organic-standard","chronological-mono-timeline","chronological-multi-timeline"]).describe("The layout mode to apply to the link chart. The value must be one of the following: organic-standard, organic-community, basic-grid, hierarchical-bottom-to-top, radial-root-centric, tree-left-to-right, geographic-organic-standard, chronological-mono-timeline, chronological-multi-timeline")}),hl=p(ln,{name:"applyLayout",description:"Apply a diagram layout to the link chart",schema:cn});function dn(e,r){return r.map.changeNonspatialDataDisplay(e),`Successfully applied nonspatial visibility setting: ${e}.`}function un({setting:e},r){let{linkChartView:t}=ee(r);return dn(e,t)}var hn=s.object({setting:s.enum(["hidden","visible"]).describe("The setting of nonspatial visibility")}),ml=p(un,{name:"changeNonspatialVisibility",description:"Change whether or not nonspatial data is visible in the link chart. The value must be either 'hidden' or 'visible'.",schema:hn});async function mn(e,r,t,a,o){let{graphQuery:i,explanation:n}=await Ee(e,r.dataModel,t,o);await h({text:`Attempting to create link chart from derived query: ${i}`},o);let l=await Mt.fromCypherQuery(r,new We({openCypherQuery:i}));return await h({text:"Link chart created successfully, loading..."},o),a.map=l,await l.load(),await a.when(),`Link chart created successfully. Cypher Query used to create the link chart:
|
|
207
|
-
|
|
210
|
+
${i}${JSON.stringify(n)}`;return await an(l,t,`${o.aiAssistantServices.url}${o.aiAssistantServices.graphQueryAssistant}`,a,r)}var nn=s.object({prompt:s.string().describe("The user's inquiry into the knowledge graph that needs to be run.")}),ul=p(on,{name:"addRecords",description:"Adds records (entities or relationships) to the current 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 records to be added to the link chart. The user should have explicitly requested to add records to the current link chart from their prompt.",schema:nn});async function sn(e,r){return await r.map.applyLayout(e),`Successfully applied layout: ${e}.`}async function ln({layout:e},r){let{linkChartView:t}=ee(r);return await sn(e,t)}var cn=s.object({layout:s.enum(["organic-standard","organic-community","basic-grid","hierarchical-bottom-to-top","radial-root-centric","tree-left-to-right","geographic-organic-standard","chronological-mono-timeline","chronological-multi-timeline"]).describe("The layout mode to apply to the link chart. The value must be one of the following: organic-standard, organic-community, basic-grid, hierarchical-bottom-to-top, radial-root-centric, tree-left-to-right, geographic-organic-standard, chronological-mono-timeline, chronological-multi-timeline")}),hl=p(ln,{name:"applyLayout",description:"Apply a diagram layout to the link chart",schema:cn});function dn(e,r){return r.map.changeNonspatialDataDisplay(e),`Successfully applied nonspatial visibility setting: ${e}.`}function un({setting:e},r){let{linkChartView:t}=ee(r);return dn(e,t)}var hn=s.object({setting:s.enum(["hidden","visible"]).describe("The setting of nonspatial visibility")}),ml=p(un,{name:"changeNonspatialVisibility",description:"Change whether or not nonspatial data is visible in the link chart. The value must be either 'hidden' or 'visible'.",schema:hn});async function mn(e,r,t,a,o){let{graphQuery:i,explanation:n}=await Ee(e,r.dataModel,t,o);await h({text:`Attempting to create link chart from derived query: ${i}`},o);let l=await Mt.fromCypherQuery(r,new We({openCypherQuery:i}));return await h({text:"Link chart created successfully, loading..."},o),a.map=l,await l.load(),await a.when(),`Link chart created successfully. Cypher Query used to create the link chart:
|
|
211
|
+
${i}
|
|
212
|
+
|
|
213
|
+
Explanation: ${n}`}async function fn({prompt:e},r){let{knowledgeGraph:t}=Te(r),{linkChartView:a}=ee(r),o=P.getDefault().helperServices;return await mn(e,t,`${o.aiAssistantServices.url}${o.aiAssistantServices.graphQueryAssistant}`,a,r)}var gn=s.object({prompt:s.string().describe("The user's inquiry into the knowledge graph that needs to be transformed into a link chart visualization.")}),fl=p(fn,{name:"createLinkChart",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:gn});async function yn({prompt:e},r){let{knowledgeGraph:t}=Te(r),a=P.getDefault().helperServices;return await Hi(e,t.dataModel,`${a.aiAssistantServices.url}${a.aiAssistantServices.graphQueryAssistant}`,r)}var pn=s.object({prompt:s.string().describe("The user's inquiry into the knowledge graph that needs to be translated into a cypher query.")}),gl=p(yn,{name:"generateCypher",description:"Generates an Open Cypher query based on the user's prompt which represents an inquiry into the data of the knowledge service and its graph database, attempting to filter based on certain conditions and traverse specified relationships. The generated query should be syntactically correct and optimized for performance.",schema:pn});var yl=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).
|
|
208
214
|
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.
|
|
209
215
|
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,
|
|
210
216
|
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
|
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
|
|
2
|
-
import c from"./
|
|
2
|
+
import c from"./3ESJRLJ5.js";import b from"./JOZLOFW3.js";import{a as i,b as e}from"./M672SFG6.js";import"./I22GHLAO.js";import"./WBSNYWJJ.js";import{p as a,t as s}from"./26V7SXDR.js";import"./CFDTXKJ6.js";export default $arcgis.t(([,{a:r}])=>{var t=class extends a{constructor(){super(...arguments),this.agent=r}static{this.properties={referenceElement:1}}#t;getContext(){if(!this.#t)throw new Error("arcgis-assistant-navigation-agent requires a mapView");return{mapView:this.#t}}async load(){this.#t=await i(this,"arcgis-assistant-navigation-agent"),e(this)}};s("arcgis-assistant-navigation-agent",t);return t},b,c)
|
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
|
|
2
|
-
import c from"./
|
|
2
|
+
import c from"./3ESJRLJ5.js";import b from"./JOZLOFW3.js";import{a as r,b as e}from"./M672SFG6.js";import"./I22GHLAO.js";import"./WBSNYWJJ.js";import{p as a,t as s}from"./26V7SXDR.js";import"./CFDTXKJ6.js";export default $arcgis.t(([,{b:i}])=>{var t=class extends a{constructor(){super(...arguments),this.agent=i}static{this.properties={referenceElement:1}}#t;getContext(){if(!this.#t)throw new Error("arcgis-assistant-data-exploration-agent requires a mapView");return{mapView:this.#t}}async load(){this.#t=await r(this,"arcgis-assistant-data-exploration-agent"),e(this)}};s("arcgis-assistant-data-exploration-agent",t);return t},b,c)
|
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
|
|
2
|
-
import c from"./
|
|
2
|
+
import c from"./3ESJRLJ5.js";import b from"./JOZLOFW3.js";import{a as s,b as a}from"./M672SFG6.js";import"./I22GHLAO.js";import"./WBSNYWJJ.js";import{p as r,t as e}from"./26V7SXDR.js";import"./CFDTXKJ6.js";export default $arcgis.t(([,{d:i}])=>{var t=class extends r{constructor(){super(...arguments),this.agent=i}static{this.properties={referenceElement:1}}#t;getContext(){if(!this.#t)throw new Error("arcgis-assistant-layer-query-agent requires a mapView");return{mapView:this.#t}}async load(){this.#t=await s(this,"arcgis-assistant-layer-query-agent"),a(this)}};e("arcgis-assistant-layer-query-agent",t);return t},b,c)
|
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
|
|
2
|
-
import c from"./
|
|
2
|
+
import c from"./3ESJRLJ5.js";import b from"./JOZLOFW3.js";import{a as e,b as i}from"./M672SFG6.js";import"./I22GHLAO.js";import"./WBSNYWJJ.js";import{p as s,t as a}from"./26V7SXDR.js";import"./CFDTXKJ6.js";export default $arcgis.t(([,{e:r}])=>{var t=class extends s{constructor(){super(...arguments),this.agent=r}static{this.properties={referenceElement:1}}#t;getContext(){if(!this.#t)throw new Error("arcgis-assistant-layer-styling-agent requires a mapView");return{mapView:this.#t}}async load(){this.#t=await e(this,"arcgis-assistant-layer-styling-agent"),i(this)}};a("arcgis-assistant-layer-styling-agent",t);return t},b,c)
|
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
|
|
2
|
-
import c from"./
|
|
2
|
+
import c from"./3ESJRLJ5.js";import b from"./JOZLOFW3.js";import{a as s,b as a}from"./M672SFG6.js";import"./I22GHLAO.js";import"./WBSNYWJJ.js";import{p as r,t as e}from"./26V7SXDR.js";import"./CFDTXKJ6.js";export default $arcgis.t(([,{c:i}])=>{var t=class extends r{constructor(){super(...arguments),this.agent=i}static{this.properties={referenceElement:1}}#t;getContext(){if(!this.#t)throw new Error("arcgis-assistant-layer-filter-agent requires a mapView");return{mapView:this.#t}}async load(){this.#t=await s(this,"arcgis-assistant-layer-filter-agent"),a(this)}};e("arcgis-assistant-layer-filter-agent",t);return t},b,c)
|
package/dist/cdn/index.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
1
|
/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
|
|
2
|
-
import{m as t,s as e}from"./26V7SXDR.js";import"./CFDTXKJ6.js";var s=t(e,{"arcgis-assistant":[()=>import("./AF7UTDDE.js"),"_messages:,description,entryMessage,heading,orchestrator:,portal:,referenceElement,suggestedPrompts:;;register"],"arcgis-assistant-agent":[()=>import("./4Y73V2HU.js"),"agent:,context:;;getContext"],"arcgis-assistant-data-exploration-agent":[()=>import("./
|
|
2
|
+
import{m as t,s as e}from"./26V7SXDR.js";import"./CFDTXKJ6.js";var s=t(e,{"arcgis-assistant":[()=>import("./AF7UTDDE.js"),"_messages:,description,entryMessage,heading,orchestrator:,portal:,referenceElement,suggestedPrompts:;;register"],"arcgis-assistant-agent":[()=>import("./4Y73V2HU.js"),"agent:,context:;;getContext"],"arcgis-assistant-data-exploration-agent":[()=>import("./M2EZXXBA.js"),"referenceElement;;getContext"],"arcgis-assistant-layer-filter-agent":[()=>import("./ZSWFMMCM.js"),"referenceElement;;getContext"],"arcgis-assistant-layer-query-agent":[()=>import("./WQK36HD5.js"),"referenceElement;;getContext"],"arcgis-assistant-layer-styling-agent":[()=>import("./ZATIKKBO.js"),"referenceElement;;getContext"],"arcgis-assistant-navigation-agent":[()=>import("./JZEJNNTI.js"),"referenceElement;;getContext"],"arcgis-assistant-chat":[()=>import("./IFWK7P7O.js"),"loading,loadingMessage,messages:,user"],"arcgis-assistant-chat-card":[()=>import("./GCFT45CD.js"),"_messages:,content,error,feedbackDisabled,loading,loadingMessage,log,timestampDisabled,type,user"],"arcgis-assistant-chat-card-content":[()=>import("./XVUE27HC.js"),"content,loading,loadingMessage,type"],"arcgis-assistant-chat-entry":[()=>import("./VUHDKXFM.js"),"_messages:,awaitingResponse,enterKeySubmits,entryPlaceholder,inputValue,status"],"arcgis-assistant-interrupt":[()=>import("./Q674OE2M.js"),"_messages:,message,options:,type"],"arcgis-assistant-shell":[()=>import("./KJZARHAM.js"),"_messages:,awaitingResponse,description,entryMessage,entryMessageClosed,heading,inputValue,loading,status,suggestedPrompts:"]});s({resourcesUrl:import.meta.url});var a=new CSSStyleSheet;a.replaceSync("@layer{:not([hydrated]):is(arcgis-assistant,arcgis-assistant-agent,arcgis-assistant-data-exploration-agent,arcgis-assistant-layer-filter-agent,arcgis-assistant-layer-query-agent,arcgis-assistant-layer-styling-agent,arcgis-assistant-navigation-agent,arcgis-assistant-chat,arcgis-assistant-chat-card,arcgis-assistant-chat-card-content,arcgis-assistant-chat-entry,arcgis-assistant-interrupt,arcgis-assistant-shell){visibility:hidden}}");document.adoptedStyleSheets=[...document.adoptedStyleSheets,a];window.$arcgis||Object.defineProperty(window,"$arcgis",{configurable:!1,enumerable:!0,writable:!1,value:{}}),((a,r)=>{a.t=(c,...x)=>Promise.all(x.map(x=>x.then?x:(!a?.forceESM&&a?.import||(x=>import(x+".js").then(m=>m.default??m)))("@arcgis/core/"+x))).then(c);r.p=a.t(([m])=>{r.t=m.trackAccess;r.o=m.createObservable;r.c=m.createTrackingTarget;r.r=m.runTracked},"applications/Components/reactiveUtils")})($arcgis,e)
|