@arcgis/ai-components 5.1.0-next.103 → 5.1.0-next.104

package/dist/cdn/index.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import{p as s,x as e}from"./DSEMD4M2.js";import"./CFDTXKJ6.js";var a=s(e,{"arcgis-assistant":[()=>import("./P6VE72RL.js"),"_messages:,awaitingResponse:,awaitingResponseStep:,copyEnabled,description,entryMessage,feedbackEnabled,heading,interrupt:,keepSuggestedPrompts,logEnabled,messages:,orchestrator:,readAloudEnabled,referenceElement,suggestedPrompts:,voiceInputEnabled;clearChatHistory,submitMessage;cancelInterrupt,register,submitInterrupt"],"arcgis-assistant-agent":[()=>import("./ZPNJGIAF.js"),"agent:,context:;getContext"],"arcgis-assistant-data-exploration-agent":[()=>import("./MXVYKCXV.js"),"referenceElement;;getContext"],"arcgis-assistant-help-agent":[()=>import("./PE3TLAMZ.js"),"referenceElement;;getContext"],"arcgis-assistant-layer-styling-agent":[()=>import("./IYWZ7KR5.js"),"referenceElement;;getContext"],"arcgis-assistant-navigation-agent":[()=>import("./WJLYLYKX.js"),"referenceElement;;getContext"],"arcgis-assistant-chat":[()=>import("./2YEKZADB.js"),"loading,messages:"],"arcgis-assistant-chat-entry":[()=>import("./YNJYG2RG.js"),"_messages:,awaitingResponse,entryPlaceholder,inputValue,keyboardShortcutsDisabled,messages:,status,voiceInputEnabled;submitMessage"],"arcgis-assistant-interrupt":[()=>import("./ZLO73NU6.js"),"_messages:,message,options:,type"],"arcgis-assistant-message":[()=>import("./G4SVCCJH.js"),"copyEnabled,feedbackEnabled,footerDisabled,logEnabled,message:,readAloudEnabled"],"arcgis-assistant-message-block":[()=>import("./5JBT3YNY.js"),"block:"],"arcgis-assistant-message-feedback":[()=>import("./Q5D5LJS5.js"),"_messages:,feedbackEnabled,message:"],"arcgis-assistant-message-footer":[()=>import("./UK6CP7BR.js"),"_messages:,copyEnabled,feedbackEnabled,logEnabled,message:,readAloudEnabled"],"arcgis-assistant-message-loading":[()=>import("./Z3DVGFEE.js"),"loading,loadingMessage"],"arcgis-assistant-message-log":[()=>import("./PTGKT5P6.js"),"log:,logEnabled,showLog"],"arcgis-assistant-message-read-aloud":[()=>import("./R5FWFRWW.js"),"_messages:,message:,readAloudEnabled"],"arcgis-assistant-message-text":[()=>import("./Y3AUHNRX.js"),"content"],"arcgis-assistant-speech-input":[()=>import("./TRDKA5Y6.js"),"awaitingResponse,inputValue,language,mode;;clearDraftSession"],"arcgis-assistant-suggested-prompts":[()=>import("./LXFCO34K.js"),"_messages:,label,prompts:"],"arcgis-assistant-user-message":[()=>import("./WBRZZ4FB.js"),"content,message:,user"]});a({resourcesUrl:import.meta.url});var t=new CSSStyleSheet;t.replaceSync("@layer{:not([hydrated]):is(arcgis-assistant,arcgis-assistant-agent,arcgis-assistant-data-exploration-agent,arcgis-assistant-help-agent,arcgis-assistant-layer-styling-agent,arcgis-assistant-navigation-agent,arcgis-assistant-chat,arcgis-assistant-chat-entry,arcgis-assistant-interrupt,arcgis-assistant-message-block,arcgis-assistant-message-feedback,arcgis-assistant-message-footer,arcgis-assistant-message-loading,arcgis-assistant-message-log,arcgis-assistant-message-read-aloud,arcgis-assistant-message-text,arcgis-assistant-speech-input,arcgis-assistant-suggested-prompts,arcgis-assistant-user-message){visibility:hidden}}");document.adoptedStyleSheets=[...document.adoptedStyleSheets,t];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)
+import{p as s,x as e}from"./DSEMD4M2.js";import"./CFDTXKJ6.js";var a=s(e,{"arcgis-assistant":[()=>import("./TEUDBVRL.js"),"_messages:,awaitingResponse:,awaitingResponseStep:,copyEnabled,description,entryMessage,feedbackEnabled,heading,interrupt:,keepSuggestedPrompts,logEnabled,messages:,orchestrator:,readAloudEnabled,referenceElement,suggestedPrompts:,voiceInputEnabled;clearChatHistory,submitMessage;cancelInterrupt,register,submitInterrupt"],"arcgis-assistant-agent":[()=>import("./EKYXKJTY.js"),"agent:,context:;getContext"],"arcgis-assistant-data-exploration-agent":[()=>import("./AUI5SK23.js"),"referenceElement;;getContext"],"arcgis-assistant-help-agent":[()=>import("./DYOEGUSR.js"),"referenceElement;;getContext"],"arcgis-assistant-knowledge-agent":[()=>import("./MRXJFN2A.js"),"context:,referenceElement,serviceUrl;getContext"],"arcgis-assistant-layer-styling-agent":[()=>import("./AHO5GI7C.js"),"referenceElement;;getContext"],"arcgis-assistant-navigation-agent":[()=>import("./53VEUSO6.js"),"referenceElement;;getContext"],"arcgis-assistant-chat":[()=>import("./2YEKZADB.js"),"loading,messages:"],"arcgis-assistant-chat-entry":[()=>import("./YNJYG2RG.js"),"_messages:,awaitingResponse,entryPlaceholder,inputValue,keyboardShortcutsDisabled,messages:,status,voiceInputEnabled;submitMessage"],"arcgis-assistant-interrupt":[()=>import("./ZLO73NU6.js"),"_messages:,message,options:,type"],"arcgis-assistant-message":[()=>import("./G4SVCCJH.js"),"copyEnabled,feedbackEnabled,footerDisabled,logEnabled,message:,readAloudEnabled"],"arcgis-assistant-message-block":[()=>import("./5JBT3YNY.js"),"block:"],"arcgis-assistant-message-feedback":[()=>import("./Q5D5LJS5.js"),"_messages:,feedbackEnabled,message:"],"arcgis-assistant-message-footer":[()=>import("./UK6CP7BR.js"),"_messages:,copyEnabled,feedbackEnabled,logEnabled,message:,readAloudEnabled"],"arcgis-assistant-message-loading":[()=>import("./Z3DVGFEE.js"),"loading,loadingMessage"],"arcgis-assistant-message-log":[()=>import("./PTGKT5P6.js"),"log:,logEnabled,showLog"],"arcgis-assistant-message-read-aloud":[()=>import("./R5FWFRWW.js"),"_messages:,message:,readAloudEnabled"],"arcgis-assistant-message-text":[()=>import("./Y3AUHNRX.js"),"content"],"arcgis-assistant-speech-input":[()=>import("./TRDKA5Y6.js"),"awaitingResponse,inputValue,language,mode;;clearDraftSession"],"arcgis-assistant-suggested-prompts":[()=>import("./LXFCO34K.js"),"_messages:,label,prompts:"],"arcgis-assistant-user-message":[()=>import("./WBRZZ4FB.js"),"content,message:,user"]});a({resourcesUrl:import.meta.url});var t=new CSSStyleSheet;t.replaceSync("@layer{:not([hydrated]):is(arcgis-assistant,arcgis-assistant-agent,arcgis-assistant-data-exploration-agent,arcgis-assistant-help-agent,arcgis-assistant-knowledge-agent,arcgis-assistant-layer-styling-agent,arcgis-assistant-navigation-agent,arcgis-assistant-chat,arcgis-assistant-chat-entry,arcgis-assistant-interrupt,arcgis-assistant-message-block,arcgis-assistant-message-feedback,arcgis-assistant-message-footer,arcgis-assistant-message-loading,arcgis-assistant-message-log,arcgis-assistant-message-read-aloud,arcgis-assistant-message-text,arcgis-assistant-speech-input,arcgis-assistant-suggested-prompts,arcgis-assistant-user-message){visibility:hidden}}");document.adoptedStyleSheets=[...document.adoptedStyleSheets,t];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)

package/dist/cdn/main.css

@@ -1 +1 @@
-@layer{:not([hydrated]):is(arcgis-assistant,arcgis-assistant-agent,arcgis-assistant-data-exploration-agent,arcgis-assistant-help-agent,arcgis-assistant-layer-styling-agent,arcgis-assistant-navigation-agent,arcgis-assistant-chat,arcgis-assistant-chat-entry,arcgis-assistant-interrupt,arcgis-assistant-message-block,arcgis-assistant-message-feedback,arcgis-assistant-message-footer,arcgis-assistant-message-loading,arcgis-assistant-message-log,arcgis-assistant-message-read-aloud,arcgis-assistant-message-text,arcgis-assistant-speech-input,arcgis-assistant-suggested-prompts,arcgis-assistant-user-message){visibility:hidden}}
+@layer{:not([hydrated]):is(arcgis-assistant,arcgis-assistant-agent,arcgis-assistant-data-exploration-agent,arcgis-assistant-help-agent,arcgis-assistant-knowledge-agent,arcgis-assistant-layer-styling-agent,arcgis-assistant-navigation-agent,arcgis-assistant-chat,arcgis-assistant-chat-entry,arcgis-assistant-interrupt,arcgis-assistant-message-block,arcgis-assistant-message-feedback,arcgis-assistant-message-footer,arcgis-assistant-message-loading,arcgis-assistant-message-log,arcgis-assistant-message-read-aloud,arcgis-assistant-message-text,arcgis-assistant-speech-input,arcgis-assistant-suggested-prompts,arcgis-assistant-user-message){visibility:hidden}}

package/dist/chunks/utils.js

@@ -1,26 +1,26 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import { getClosestElement as a } from "@arcgis/toolkit/dom";
-import { g as i } from "./utils2.js";
-function o(e, t) {
-  const s = i(e.el, e.referenceElement);
+import { getClosestElement as i } from "@arcgis/toolkit/dom";
+import { g as r, a as o } from "./utils2.js";
+function c(e, t) {
+  const s = r(e.el, e.referenceElement);
   if (s)
     return s;
-  const n = a(e.el, "arcgis-assistant"), r = i(e.el, n?.referenceElement);
-  if (r)
-    return r;
+  const n = i(e.el, "arcgis-assistant"), a = r(e.el, n?.referenceElement);
+  if (a)
+    return a;
   throw new Error(`${t}: Reference element not found`);
 }
-function l(e, t) {
-  const n = o(e, t).view;
+function m(e, t) {
+  const n = c(e, t).view;
   if (!n)
     throw new Error(`${t}: Reference element does not have a view`);
   return n;
 }
-function m(e) {
+function w(e) {
   return typeof e == "function";
 }
 function g(e) {
-  const t = a(e.el, "arcgis-assistant");
+  const t = i(e.el, "arcgis-assistant");
   if (t === void 0)
     throw new Error("arcgis-assistant-agent must be used within an arcgis-assistant element");
   t.register({
@@ -28,8 +28,20 @@ function g(e) {
     getContext: async () => await e.getContext?.() ?? e.context ?? {}
   });
 }
+function l(e) {
+  const t = o(e.el, e.referenceElement);
+  if (t)
+    return t;
+  const s = i(e.el, "arcgis-assistant"), n = r(e.el, s?.referenceElement);
+  return n || null;
+}
+function v(e) {
+  const t = l(e);
+  return t ? t.view : null;
+}
 export {
   g as a,
-  m as i,
-  l as r
+  v as b,
+  w as i,
+  m as r
 };

package/dist/chunks/utils2.js

@@ -1,12 +1,16 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import { getClosestElement as i } from "@arcgis/toolkit/dom";
-function r(s, o) {
-  return o ? typeof o == "string" ? l(s, o) ?? null : o : i(s, "arcgis-map") ?? null;
+import { getClosestElement as s } from "@arcgis/toolkit/dom";
+function l(t, o) {
+  return o ? typeof o == "string" ? u(t, o) ?? null : o : s(t, "arcgis-map") ?? null;
 }
-function l(s, o) {
-  const u = o.includes("#") || o.includes(".") || o.includes("["), t = s.getRootNode();
-  return (u ? void 0 : t.querySelector(`#${o}`)) ?? t.querySelector(o) ?? void 0;
+function n(t, o) {
+  return o ? typeof o == "string" ? u(t, o) ?? null : o : s(t, "arcgis-link-chart") ?? s(t, "arcgis-map") ?? null;
+}
+function u(t, o) {
+  const r = o.includes("#") || o.includes(".") || o.includes("["), i = t.getRootNode();
+  return (r ? void 0 : i.querySelector(`#${o}`)) ?? i.querySelector(o) ?? void 0;
 }
 export {
-  r as g
+  n as a,
+  l as g
 };

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

@@ -0,0 +1,101 @@
+/// <reference path="../../index.d.ts" />
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { ArcgisKnowledgeContext } from "@arcgis/ai-agents";
+import type { ArcgisLinkChart as ArcgisLinkChart } from "@arcgis/map-components/components/arcgis-link-chart";
+import type { ArcgisMap as ArcgisMap } from "@arcgis/map-components/components/arcgis-map";
+
+/**
+ * The Knowledge Agent enables the end user to perform operations on a knowledge graph layer or link chart layer,
+ * as well as explore the data in the knowledge graph via natural language queries. See the list of capabilities below for more details.
+ *
+ * This is an unrendered component that must be added as a child of the `arcgis-assistant` component in either HTML or JavaScript.
+ *
+ * Note: Sign in to access the data in this demo, U/P: `viewer01`/`I68VGU^nMurF`
+ *
+ * ```html
+ * <arcgis-link-chart id="my-link-chart"></arcgis-link-chart>
+ * <arcgis-assistant>
+ *   <arcgis-assistant-knowledge-agent reference-element="my-link-chart"></arcgis-assistant-knowledge-agent>
+ * </arcgis-assistant>
+ * ```
+ *
+ * Once added to the assistant, the agent is loaded and ready to receive user messages related to their knowledge graph related layers or data.
+ *
+ * ### Capabilties
+ *
+ * The knowledge agent provides the following capabilities related to a knowledge graph or associated knowledge graph layer or link chart layer:
+ *
+ * - **Query and Search Graph Data** - Answers questions about the data in the knowledge graph via cypher query or text property search.
+ * - **Generate Cypher Query** - Generates a cypher query based on a natural language question and the current knowledge graph data model,
+ * which can be run against the knowledge graph service.
+ *
+ * **Additional capabilities with a map view with a knowledge graph layer or a link chart view**
+ * - **Add entities and relationships** - Add entities or relationships the the knowledge graph or link chart layer.
+ *
+ * **Additional capabilities with a link chart view only**
+ * - **Change link chart layout** - Swap the layout of the link chart between different modes such as force directed, radial, or hierarchical.
+ * - **Toggle non-spatial visibility** - Show or hide non-spatial entities and relationships on the link chart.
+ * - **Create link chart from query** - Update the existing link chart with new membership based on a generated query.
+ *
+ *
+ * ### Example questions
+ *
+ * The following are example questions a user can ask within the bounds of the navigation agent:
+ *
+ * - "What entities are in this graph, and what is the count of each entity type?"
+ * - "Find documents related to the San Francisco Bay Area."
+ * - "Generate a cypher query to find all employees of Company X that are located in California."
+ * - "Add all connections between Company X and Company Y to the link chart"
+ * - "Change the layout to radial-root-centric"
+ * - "Show nonspatial data on the link chart"
+ * - "Create a new link chart from the with all employees from Company X that joined the company after 2015 and are located in California"
+ *
+ * > Due to the non-deterministic nature of generative AI, there may be inaccuracies or unexpected behavior when using the
+ * out-of-the-box agents.
+ *
+ * @since 5.1
+ * @beta
+ * @see [arcgis-assistant](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/)
+ * @see [Intro to building agentic mapping applications](https://developers.arcgis.com/javascript/latest/agentic-apps/ai-introduction/)
+ * @see [AI Assistant component sample](https://developers.arcgis.com/javascript/latest/sample-code/ai-assistant/)
+ */
+export abstract class ArcgisAssistantKnowledgeAgent extends LitElement {
+  /**
+   * Required and optional context for the knowledge agent. The knowledge agent requires either a link chart view,
+   * a map view with at least one knowledge graph layer, or KnowledgeGraph instance in order to function.
+   *
+   * Depending on the context provided, different capabilities will be available.
+   */
+  accessor context: ArcgisKnowledgeContext | undefined;
+  /**
+   * The reference element to the map that provides context for the navigation agent. Currently,
+   * this is only scoped to `arcgis-map` elements. This shows the navigation agent which map on which to
+   * perform navigation actions. This is required for the navigation agent to function properly.
+   *
+   * Setting this property is not necessary if you set the reference element on the parent
+   * `arcgis-assistant` component.
+   *
+   * @see [arcgis-assistant.referenceElement](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/#referenceElement)
+   * @example
+   * ```html
+   * <arcgis-link-chart id="my-link-chart"></arcgis-link-chart>
+   * <arcgis-assistant>
+   *   <arcgis-assistant-knowledge-agent reference-element="my-link-chart"></arcgis-assistant-knowledge-agent>
+   * </arcgis-assistant>
+   * ```
+   */
+  accessor referenceElement: ArcgisLinkChart | ArcgisMap | string | undefined;
+  /**
+   * The URL of a Knowledge Graph Service. This can be set to use the agent without a map or link chart view.
+   *
+   * If a map or link chart view reference element are provided, this property will be ignored.
+   *
+   * @example
+   * ```html
+   * <arcgis-assistant>
+   *  <arcgis-assistant-knowledge-agent service-url="https://example.esri.com/server/rest/services/Hosted/KGS_Service_Name/KnowledgeGraphServer"></arcgis-assistant-knowledge-agent>
+   * </arcgis-assistant>
+   * ```
+   */
+  accessor serviceUrl: null | undefined | string;
+}

package/dist/components/arcgis-assistant-knowledge-agent/customElement.js

@@ -0,0 +1,51 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
+import { c as r } from "../../chunks/runtime.js";
+import { LitElement as i } from "@arcgis/lumina";
+import { ArcgisKnowledgeAgent as s } from "@arcgis/ai-agents";
+import { b as o, a as n } from "../../chunks/utils.js";
+import { fetchKnowledgeGraph as a } from "@arcgis/core/rest/knowledgeGraphService.js";
+class c extends i {
+  constructor() {
+    super(...arguments), this.agent = s;
+  }
+  static {
+    this.properties = { referenceElement: 1, serviceUrl: 3, context: 0 };
+  }
+  #t;
+  #r;
+  #e;
+  get serviceUrl() {
+    return this.#r;
+  }
+  set serviceUrl(e) {
+    this.#r = e;
+  }
+  async getContext() {
+    const e = this.context ? { ...this.context, knowledgeGraph: void 0, view: void 0 } : {};
+    if (this.#t)
+      return {
+        ...e,
+        view: this.#t
+      };
+    if (this.#e)
+      try {
+        const t = await this.#e;
+        return { ...e, knowledgeGraph: t };
+      } catch (t) {
+        console.error("Failed to load knowledge graph via service URL:", t);
+      }
+    if (!this.context?.knowledgeGraph && !this.context?.view)
+      throw new Error("arcgis-assistant-knowledge-agent requires either a knowledgeGraph or view in context, and neither were provided");
+    return this.context;
+  }
+  willUpdate(e) {
+    e.has("serviceUrl") && this.serviceUrl ? this.#e = a(this.serviceUrl) : this.#e = void 0;
+  }
+  load() {
+    this.#t = o(this) ?? void 0, n(this);
+  }
+}
+r("arcgis-assistant-knowledge-agent", c);
+export {
+  c as ArcgisAssistantKnowledgeAgent
+};

package/dist/components/arcgis-assistant-knowledge-agent/index.d.ts

@@ -0,0 +1 @@
+export * from "./customElement.js";

package/dist/components/arcgis-assistant-knowledge-agent/index.js

@@ -0,0 +1 @@
+export * from "./customElement.js";