@arcgis/ai-components 5.2.0-next.9 → 5.2.0-next.91

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

@@ -1,19 +1,623 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { c as t } from "../../chunks/runtime.js";
-import { LitElement as s } from "@arcgis/lumina";
-import { i as e, a as i } from "../../chunks/utils2.js";
-class n extends s {
+import { c as q } from "../../chunks/runtime.js";
+import { LitElement as M } from "@arcgis/lumina";
+import { b as W, i as L } from "../../chunks/utils2.js";
+import C from "@arcgis/core/portal/PortalItem.js";
+import j from "@arcgis/core/portal/Portal.js";
+import { property as n, subclass as l } from "@arcgis/core/core/accessorSupport/decorators.js";
+import { BaseAgent as G } from "../../agent-utils/BaseAgent.js";
+import b from "@arcgis/core/core/Error.js";
+import { z as c } from "zod";
+import { c as B } from "../../chunks/graph.js";
+import T from "@arcgis/core/core/Accessor.js";
+import { LLMAgent as z } from "../../agent-utils/LLMAgent.js";
+import { PromptTemplate as Z } from "@langchain/core/prompts";
+import { Annotation as x } from "@langchain/langgraph";
+import { b as H, d as U } from "../../chunks/state.js";
+import "@arcgis/core/identity/IdentityManager.js";
+import "@arcgis/core/request.js";
+import "@langchain/langgraph/web";
+import "@arcgis/toolkit/string";
+import "../../chunks/generateLayerDescriptions.js";
+import "@langchain/core/messages";
+import "@langchain/core/callbacks/dispatch/web";
+import "@langchain/core/callbacks/base";
+import "@langchain/openai";
+import "@arcgis/core/config.js";
+import "@arcgis/core/core/reactiveUtils.js";
+import "@arcgis/core/layers/FeatureLayer.js";
+import { a as V } from "../../chunks/baseAgentState.js";
+var K = Object.defineProperty, Q = Object.getOwnPropertyDescriptor, f = (e, t, r, s) => {
+  for (var o = s > 1 ? void 0 : s ? Q(t, r) : t, a = e.length - 1, i; a >= 0; a--)
+    (i = e[a]) && (o = (s ? i(t, r, o) : i(o)) || o);
+  return s && o && K(t, r, o), o;
+};
+let p = class extends T {
+  //#region Lifecycle
+  constructor(e) {
+    super(e);
+  }
+  //#endregion
+  //#region Public Methods
+  static fromJSON(e) {
+    return new p({
+      id: e.id,
+      sourceAnchorId: e.source_anchor_id,
+      sourceNodeId: e.source_node_id,
+      targetAnchorId: e.target_anchor_id,
+      targetNodeId: e.target_node_id
+    });
+  }
+  //#endregion
+};
+f([
+  n()
+], p.prototype, "id", 2);
+f([
+  n()
+], p.prototype, "sourceAnchorId", 2);
+f([
+  n()
+], p.prototype, "sourceNodeId", 2);
+f([
+  n()
+], p.prototype, "targetAnchorId", 2);
+f([
+  n()
+], p.prototype, "targetNodeId", 2);
+p = f([
+  l("Edge")
+], p);
+var X = Object.defineProperty, Y = Object.getOwnPropertyDescriptor, v = (e, t, r, s) => {
+  for (var o = s > 1 ? void 0 : s ? Y(t, r) : t, a = e.length - 1, i; a >= 0; a--)
+    (i = e[a]) && (o = (s ? i(t, r, o) : i(o)) || o);
+  return s && o && X(t, r, o), o;
+};
+let u = class extends T {
+  //#region Lifecycle
+  constructor(e) {
+    super(e);
+  }
+  //#endregion
+  //#region Public Methods
+  async load() {
+    return await Promise.resolve(this);
+  }
+  compile(e) {
+    return {
+      runtimeNode: this.createRuntimeNode(),
+      edges: e.outgoingEdges.map((t) => ({
+        from: this.id,
+        to: t.targetNodeId
+      }))
+    };
+  }
+  static fromJSON(e) {
+    throw new Error("BaseNode is abstract and cannot be instantiated directly.");
+  }
+  //#endregion
+  //#region Private Methods
+  //#endregion
+};
+v([
+  n()
+], u.prototype, "id", 2);
+v([
+  n()
+], u.prototype, "label", 2);
+v([
+  n()
+], u.prototype, "type", 2);
+u = v([
+  l("BaseNode")
+], u);
+function I(e) {
+  const t = new Set(e.required), r = Object.fromEntries(
+    Object.entries(e.properties).map(([s, o]) => {
+      const a = $(o);
+      return [s, t.has(s) ? a : a.optional()];
+    })
+  );
+  return c.object(r);
+}
+function $(e) {
+  let t;
+  switch (e.type) {
+    case "array":
+      t = c.array(e.items ? $(e.items) : c.unknown());
+      break;
+    case "boolean":
+      t = c.boolean();
+      break;
+    case "number":
+      t = c.number();
+      break;
+    case "object":
+      t = I({
+        properties: e.properties ?? {},
+        required: e.required
+      });
+      break;
+    case "string":
+      t = e.enum?.length ? c.enum(e.enum) : c.string();
+      break;
+  }
+  return e.description ? t.describe(e.description) : t;
+}
+const k = /* @__PURE__ */ new Map([
+  [
+    "clear_filters",
+    async () => (await import("../../agents/tools/filter/clearFilters/adapter.js")).clearFiltersTool
+  ],
+  [
+    "reset_map",
+    async () => (await import("../../agents/tools/filter/resetMap/adapter.js")).resetMapTool
+  ],
+  [
+    "set_feature_effect",
+    async () => (await import("../../agents/tools/filter/setFeatureEffect/adapter.js")).setFeatureEffectTool
+  ],
+  [
+    "list_layer_fields",
+    async () => (await import("../../agents/tools/help/listFields/adapter.js")).listLayerFieldsTool
+  ],
+  [
+    "go_to_address",
+    async () => (await import("../../agents/tools/navigation/goToAddress/adapter.js")).goToAddressTool
+  ],
+  [
+    "go_to_bookmark",
+    async () => (await import("../../agents/tools/navigation/goToBookmark/adapter.js")).goToBookmarkTool
+  ],
+  [
+    "go_to_features",
+    async () => (await import("../../agents/tools/navigation/goToFeatures/adapter.js")).goToFeaturesTool
+  ],
+  [
+    "go_to_full_extent",
+    async () => (await import("../../agents/tools/navigation/goToFullExtent/adapter.js")).goToFullExtentTool
+  ],
+  [
+    "go_to_home_extent",
+    async () => (await import("../../agents/tools/navigation/goToHomeExtent/adapter.js")).goToHomeExtentTool
+  ],
+  [
+    "go_to_layer",
+    async () => (await import("../../agents/tools/navigation/goToLayer/adapter.js")).goToLayerTool
+  ],
+  [
+    "go_to_scale",
+    async () => (await import("../../agents/tools/navigation/goToScale/adapter.js")).goToScaleTool
+  ],
+  [
+    "go_to_viewpoint",
+    async () => (await import("../../agents/tools/navigation/goToViewpoint/adapter.js")).goToViewpointTool
+  ],
+  [
+    "go_to_zoom",
+    async () => (await import("../../agents/tools/navigation/goToZoom/adapter.js")).goToZoomTool
+  ],
+  [
+    "find_relevant_fields",
+    async () => (await import("../../agents/tools/search/findRelevantFields/adapter.js")).findRelevantFieldsTool
+  ],
+  [
+    "find_relevant_layers",
+    async () => (await import("../../agents/tools/search/findRelevantLayers/adapter.js")).findRelevantLayersTool
+  ],
+  [
+    "get_attribute",
+    async () => (await import("../../agents/tools/query/getAttribute/adapter.js")).getAttributeTool
+  ],
+  [
+    "get_statistics",
+    async () => (await import("../../agents/tools/query/getStatistics/adapter.js")).getStatisticsTool
+  ],
+  [
+    "get_top_features",
+    async () => (await import("../../agents/tools/query/getTopFeatures/adapter.js")).getTopFeaturesTool
+  ],
+  [
+    "query_features",
+    async () => (await import("../../agents/tools/query/queryFeatures/adapter.js")).queryFeaturesTool
+  ]
+]);
+async function ee(e) {
+  const t = k.get(e);
+  if (!t)
+    throw new Error(`ArcGIS tool is not supported in the browser runtime: ${e}`);
+  return await t();
+}
+var te = Object.defineProperty, oe = Object.getOwnPropertyDescriptor, N = (e, t, r, s) => {
+  for (var o = s > 1 ? void 0 : s ? oe(t, r) : t, a = e.length - 1, i; a >= 0; a--)
+    (i = e[a]) && (o = (s ? i(t, r, o) : i(o)) || o);
+  return s && o && te(t, r, o), o;
+};
+let d = class extends T {
+  //#region Lifecycle
+  constructor(e) {
+    super(e), this.type = "arcgis-tool";
+  }
+  //#endregion
+  //#region Public Methods
+  async createRuntimeTools() {
+    if (!this.name)
+      throw new Error("ArcgisTool name is required");
+    return [await ee(this.name)];
+  }
+  static fromJSON(e) {
+    return new d({
+      name: e.name,
+      requireApproval: e.require_approval
+    });
+  }
+  //#endregion
+};
+N([
+  n()
+], d.prototype, "name", 2);
+N([
+  n()
+], d.prototype, "requireApproval", 2);
+N([
+  n()
+], d.prototype, "type", 2);
+d = N([
+  l("ArcgisTool")
+], d);
+var re = Object.defineProperty, se = Object.getOwnPropertyDescriptor, J = (e) => {
+  throw TypeError(e);
+}, _ = (e, t, r, s) => {
+  for (var o = s > 1 ? void 0 : s ? se(t, r) : t, a = e.length - 1, i; a >= 0; a--)
+    (i = e[a]) && (o = (s ? i(t, r, o) : i(o)) || o);
+  return s && o && re(t, r, o), o;
+}, ae = (e, t, r) => t.has(e) || J("Cannot " + r), ie = (e, t, r) => t.has(e) ? J("Cannot add the same private member more than once") : t instanceof WeakSet ? t.add(e) : t.set(e, r), ne = (e, t, r) => (ae(e, t, "access private method"), r), S, R;
+let m = class extends u {
+  //#region Lifecycle
+  constructor(e) {
+    super(e), ie(this, S), this.type = "agent-node";
+  }
+  //#endregion
+  //#region Public Methods
+  createRuntimeNode() {
+    let e;
+    return async (t, r) => {
+      e ??= ne(this, S, R).call(this);
+      const o = await (await e).run(t, r), a = this.outputSchema?.safeParse(o);
+      if (a && !a.success)
+        throw a.error;
+      const i = a?.data, O = i ?? o.outputMessage;
+      return {
+        agentExecutionContext: o.agentExecutionContext,
+        ...i ? {} : { outputMessage: o.outputMessage },
+        status: o.status,
+        summary: o.summary,
+        nodes: {
+          [this.id]: { output: O }
+        }
+      };
+    };
+  }
+  compile(e) {
+    const t = e.outgoingEdges[0]?.targetNodeId;
+    return {
+      runtimeNode: this.createRuntimeNode(),
+      edges: [
+        {
+          from: this.id,
+          decide: (r) => r.status === "failed" ? void 0 : t
+        }
+      ],
+      schemas: [
+        c.object({
+          output: this.outputSchema ?? c.string()
+        })
+      ]
+    };
+  }
+  static fromJSON(e) {
+    const t = new m({
+      id: e.id,
+      label: e.label,
+      prompt: e.prompt?.content,
+      type: "agent-node",
+      modelTier: e.llm_model?.model_tier
+    });
+    return e.structured_output && (t.outputSchema = I(e.structured_output)), t.tools = e.tools?.filter((r) => r.type === "arcgis_tool").map((r) => d.fromJSON(r)), t;
+  }
+  //#endregion
+};
+S = /* @__PURE__ */ new WeakSet();
+R = async function() {
+  const e = this.prompt;
+  if (!e?.trim())
+    throw new Error(`WebAgent agent node "${this.id}" requires a prompt.`);
+  const t = [];
+  if (this.tools)
+    for (const r of this.tools) {
+      const s = await r.createRuntimeTools();
+      t.push(...s);
+    }
+  return new z({
+    name: this.id,
+    // TODO: change to label
+    outputSchema: this.outputSchema,
+    modelTier: this.modelTier,
+    prompt: e,
+    tools: t
+  });
+};
+_([
+  n()
+], m.prototype, "type", 2);
+_([
+  n()
+], m.prototype, "prompt", 2);
+_([
+  n()
+], m.prototype, "outputSchema", 2);
+_([
+  n()
+], m.prototype, "tools", 2);
+_([
+  n()
+], m.prototype, "modelTier", 2);
+m = _([
+  l("AgentNode")
+], m);
+var ce = Object.defineProperty, pe = Object.getOwnPropertyDescriptor, A = (e, t, r, s) => {
+  for (var o = s > 1 ? void 0 : s ? pe(t, r) : t, a = e.length - 1, i; a >= 0; a--)
+    (i = e[a]) && (o = (s ? i(t, r, o) : i(o)) || o);
+  return s && o && ce(t, r, o), o;
+};
+let h = class extends u {
+  //#region Lifecycle
+  constructor(e) {
+    super(e), this.type = "end-message-node";
+  }
+  //#endregion
+  //#region Public Methods
+  createRuntimeNode() {
+    return async (e) => {
+      const t = await Z.fromTemplate(this.message, { templateFormat: "mustache" }).format(e);
+      return {
+        outputMessage: t,
+        status: "success",
+        summary: t
+      };
+    };
+  }
+  compile(e) {
+    return {
+      runtimeNode: this.createRuntimeNode(),
+      edges: []
+    };
+  }
+  static fromJSON(e) {
+    const t = new h({
+      id: e.id,
+      label: e.label,
+      type: "end-message-node"
+    });
+    return t.message = e.message, t;
+  }
+  //#endregion
+  //#region Private Methods
+  //#endregion
+};
+A([
+  n()
+], h.prototype, "type", 2);
+A([
+  n()
+], h.prototype, "message", 2);
+h = A([
+  l("EndMessageNode")
+], h);
+var me = Object.defineProperty, ue = Object.getOwnPropertyDescriptor, D = (e, t, r, s) => {
+  for (var o = s > 1 ? void 0 : s ? ue(t, r) : t, a = e.length - 1, i; a >= 0; a--)
+    (i = e[a]) && (o = (s ? i(t, r, o) : i(o)) || o);
+  return s && o && me(t, r, o), o;
+};
+let w = class extends u {
+  //#region Lifecycle
+  constructor(e) {
+    super(e), this.type = "start-node";
+  }
+  //#endregion
+  //#region Public Methods
+  createRuntimeNode() {
+    return (e) => ({ question: e.agentExecutionContext.userRequest });
+  }
+  static fromJSON(e) {
+    return new w({
+      id: e.id,
+      label: e.label,
+      type: "start-node"
+    });
+  }
+  //#endregion
+  //#region Private Methods
+  //#endregion
+};
+D([
+  n()
+], w.prototype, "type", 2);
+w = D([
+  l("StartNode")
+], w);
+function de(e) {
+  switch (e.type) {
+    case "agent_node":
+      return m.fromJSON(e);
+    case "end_message_node":
+      return h.fromJSON(e);
+    case "start_node":
+      return w.fromJSON(e);
+    default:
+      throw new Error(`WebAgent node "${e.id}" uses unsupported type "${e.type}".`);
+  }
+}
+function le(e = {}) {
+  const t = Object.keys(e);
+  if (H(t), t.includes("nodes"))
+    throw new Error("node state cannot define reserved field: nodes.");
+  const r = U(e);
+  return x.Root({
+    ...r,
+    nodes: x({
+      reducer: (s, o) => ({ ...s, ...o }),
+      default: () => ({})
+    }),
+    ...V()
+  });
+}
+function F(e) {
+  const t = /* @__PURE__ */ new Set();
+  for (const s of e)
+    for (const o of Object.keys(s.shape ?? {}))
+      o !== "nodes" && t.add(o);
+  const r = Object.fromEntries([...t].map((s) => [s, void 0]));
+  return le(r);
+}
+class P {
+  //#endregion Private Properties
+  //#region Lifecycle
+  constructor(t, r, s) {
+    this.sourceJSON = t, this.edges = r, this.nodes = s, this._loaded = !1;
+  }
+  //#endregion Lifecycle
+  //#region Public Methods
+  static fromJSON(t) {
+    return new P(
+      t,
+      t.graph.edges.map((r) => p.fromJSON(r)),
+      t.graph.nodes.map((r) => de(r))
+    );
+  }
+  async load() {
+    return this._loadPromise ??= Promise.all(this.nodes.map(async (t) => await t.load())).then(() => {
+      this._loaded = !0;
+    }), await this._loadPromise, this;
+  }
+  getSchemas() {
+    const t = Object.fromEntries(
+      this._getNodeCompilations().flatMap((s, o) => {
+        const a = this.nodes[o];
+        return s.schemas?.map((i) => [a.id, i]) ?? [];
+      })
+    );
+    return [c.object({
+      loopCounts: c.record(c.string(), c.number()).optional(),
+      nodes: c.object(t).partial().optional(),
+      question: c.string().optional()
+    })];
+  }
+  generate() {
+    this._assertLoaded(), this._nodeCompilations = void 0;
+    const t = this._getNodeCompilations(), r = F(this.getSchemas()), s = this.nodes.find((i) => i.type === "start-node")?.id, o = {}, a = [];
+    for (const [i, O] of this.nodes.entries()) {
+      const y = t[i];
+      y && (y.runtimeNode && (o[O.id] = y.runtimeNode), a.push(...y.edges));
+    }
+    return {
+      createGraph: () => B(o, a, r, { entryNode: s }),
+      workspace: r
+    };
+  }
+  //#endregion Public Methods
+  //#region Private Methods
+  _assertLoaded() {
+    if (!this._loaded)
+      throw new Error("AgenticWorkflowRuntime must be loaded before it can generate a graph.");
+  }
+  _getNodeCompilations() {
+    return this._assertLoaded(), this._nodeCompilations ??= this.nodes.map(
+      (t) => t.compile({
+        outgoingEdges: this.edges.filter((r) => r.sourceNodeId === t.id)
+      })
+    );
+  }
+  //#endregion Private Methods
+}
+var he = Object.defineProperty, ge = Object.getOwnPropertyDescriptor, E = (e, t, r, s) => {
+  for (var o = s > 1 ? void 0 : s ? ge(t, r) : t, a = e.length - 1, i; a >= 0; a--)
+    (i = e[a]) && (o = (s ? i(t, r, o) : i(o)) || o);
+  return s && o && he(t, r, o), o;
+};
+const fe = () => {
+  throw new Error("WebAgent must be loaded before it can run.");
+};
+let g = class extends G {
+  //#region Lifecycle
+  constructor(e) {
+    super(e);
+  }
+  //#endregion
+  //#region Public Methods
+  async load() {
+    if (this.portalItem) {
+      try {
+        await this.portalItem.load();
+      } catch (r) {
+        throw new b("web-agent:load-portal-item", "Failed to load portal item", { error: r });
+      }
+      const t = await this.portalItem.fetchData();
+      if (this.sourceJSON = t, !this.portalItem.title)
+        throw new b("web-agent:missing-title", "The portal item is missing a title");
+    }
+    if (!this.sourceJSON)
+      throw new b("web-agent:missing-source-json", "The source JSON is missing");
+    if (!this.sourceJSON.description)
+      throw new b("web-agent:missing-description", "The source JSON is missing a description");
+    const e = P.fromJSON(this.sourceJSON);
+    return await e.load(), this._runtime = e, this.description = this.sourceJSON.description, this.name = this.portalItem?.title ?? `web-agent-${Date.now()}`, this.generate(), this;
+  }
+  getSchemas() {
+    return this._runtime?.getSchemas() ?? [];
+  }
+  generate() {
+    if (!this._runtime) {
+      this._set("workspace", F([])), this._set("createGraph", fe);
+      return;
+    }
+    const { createGraph: e, workspace: t } = this._runtime.generate();
+    this._set("workspace", t), this._set("createGraph", e);
+  }
+  //#endregion
+};
+E([
+  n({ type: C })
+], g.prototype, "portalItem", 2);
+E([
+  n()
+], g.prototype, "sourceJSON", 2);
+g = E([
+  l("WebAgent")
+], g);
+class _e extends M {
   static {
-    this.properties = { agent: 0, context: 0 };
+    this.properties = { agent: 0, context: 0, itemId: 1, workflow: 0 };
   }
+  #e;
   async getContext() {
-    return e(this.context) ? await this.context() : this.context;
+    return W(this.context) ? await this.context() : this.context;
+  }
+  async load() {
+    let t;
+    if (this.itemId) {
+      const r = j.getDefault();
+      t = new g({ portalItem: new C({ id: this.itemId, portal: r }) });
+    } else this.workflow && (t = new g({ sourceJSON: this.workflow }));
+    if (t && (await t.load(), this.agent = t.registration), !this.agent)
+      throw new Error("Failed to initialize the assistant agent because the agent registration is missing.");
+    this.#e = L(this);
   }
-  load() {
-    i(this);
+  disconnectedCallback() {
+    this.#e?.unregister(this.agent.id), super.disconnectedCallback();
   }
 }
-t("arcgis-assistant-agent", n);
+q("arcgis-assistant-agent", _e);
 export {
-  n as ArcgisAssistantAgent
+  _e as ArcgisAssistantAgent
 };

package/dist/components/arcgis-assistant-chat/customElement.d.ts

@@ -1,7 +1,7 @@
 /// <reference path="../../index.d.ts" />
 import type Collection from "@arcgis/core/core/Collection.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { ChatMessage } from "../arcgis-assistant/types.js";
+import type { ChatMessage, Interrupt } from "../arcgis-assistant/types.js";
 
 /**
  * Wraps and renders the conversation area. Use it as the container for message list content.
@@ -10,6 +10,7 @@ import type { ChatMessage } from "../arcgis-assistant/types.js";
  * @internal
  */
 export abstract class ArcgisAssistantChat extends LitElement {
+  accessor interrupt: Interrupt | null;
   /** @default false */
   accessor loading: boolean;
   accessor messages: Collection<ChatMessage>;