@arcgis/ai-components 5.2.0-next.11 → 5.2.0-next.110

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

@@ -1,6 +1,7 @@
 /// <reference path="../../index.d.ts" />
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { AgentRegistration } from "../../utils/index.js";
+import type { AgenticWorkflowJson } from "../../agentic-workflow/jsonTypes.js";
 
 /**
  * The Assistant Agent component is a generic wrapper for registering custom agents to the [arcgis-assistant](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/) component. To define
@@ -67,7 +68,6 @@ export abstract class ArcgisAssistantAgent<TContext = Record<string, unknown>> e
    * See the [Custom Agents guide](https://developers.arcgis.com/javascript/latest/agentic-apps/ai-custom-agents/) for more instructions
    * and links to samples demonstrating how to create custom agents.
    *
-   * @required
    * @see [LangGraph documentation](https://docs.langchain.com/oss/javascript/langgraph/overview)
    * @see [Custom agents guide](https://developers.arcgis.com/javascript/latest/agentic-apps/ai-custom-agents/)
    * @example
@@ -138,4 +138,16 @@ export abstract class ArcgisAssistantAgent<TContext = Record<string, unknown>> e
    * ```
    */
   accessor context: TContext | (() => Promise<TContext | undefined> | TContext | undefined) | undefined;
+  /**
+   * The portal item ID associated with this assistant agent.
+   *
+   * @internal
+   */
+  accessor itemId: string | undefined;
+  /**
+   * The workflow JSON associated with this assistant agent.
+   *
+   * @internal
+   */
+  accessor workflow: AgenticWorkflowJson | undefined;
 }

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

@@ -1,19 +1,541 @@
-/* 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 {
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
+import { c as W } from "../../chunks/runtime.js";
+import { LitElement as F } from "@arcgis/lumina";
+import { b as M, i as j } from "../../chunks/utils2.js";
+import I from "@arcgis/core/portal/PortalItem.js";
+import G from "@arcgis/core/portal/Portal.js";
+import { property as n, subclass as l } from "@arcgis/core/core/accessorSupport/decorators.js";
+import { BaseAgent as L } from "../../agent-utils/BaseAgent.js";
+import y from "@arcgis/core/core/Error.js";
+import { z as c } from "zod";
+import { c as z } from "../../chunks/graph.js";
+import A from "@arcgis/core/core/Accessor.js";
+import { LLMAgent as B } from "../../agent-utils/LLMAgent.js";
+import { r as U } from "../../chunks/arcgisToolRegistry.js";
+import { PromptTemplate as Z } from "@langchain/core/prompts";
+import { Annotation as x } from "@langchain/langgraph";
+import { b as H, d as K } 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 Q } from "../../chunks/baseAgentState.js";
+var V = Object.defineProperty, X = Object.getOwnPropertyDescriptor, f = (e, t, o, s) => {
+  for (var r = s > 1 ? void 0 : s ? X(t, o) : t, a = e.length - 1, i; a >= 0; a--)
+    (i = e[a]) && (r = (s ? i(t, o, r) : i(r)) || r);
+  return s && r && V(t, o, r), r;
+};
+let p = class extends A {
+  //#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 Y = Object.defineProperty, k = Object.getOwnPropertyDescriptor, v = (e, t, o, s) => {
+  for (var r = s > 1 ? void 0 : s ? k(t, o) : t, a = e.length - 1, i; a >= 0; a--)
+    (i = e[a]) && (r = (s ? i(t, o, r) : i(r)) || r);
+  return s && r && Y(t, o, r), r;
+};
+let d = class extends A {
+  //#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()
+], d.prototype, "id", 2);
+v([
+  n()
+], d.prototype, "label", 2);
+v([
+  n()
+], d.prototype, "type", 2);
+d = v([
+  l("BaseNode")
+], d);
+function J(e) {
+  const t = new Set(e.required), o = Object.fromEntries(
+    Object.entries(e.properties).map(([s, r]) => {
+      const a = $(r);
+      return [s, t.has(s) ? a : a.optional()];
+    })
+  );
+  return c.object(o);
+}
+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 = J({
+        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;
+}
+var ee = Object.defineProperty, te = Object.getOwnPropertyDescriptor, N = (e, t, o, s) => {
+  for (var r = s > 1 ? void 0 : s ? te(t, o) : t, a = e.length - 1, i; a >= 0; a--)
+    (i = e[a]) && (r = (s ? i(t, o, r) : i(r)) || r);
+  return s && r && ee(t, o, r), r;
+};
+const re = (e) => e.replace(/_([a-z])/gu, (t, o) => o.toUpperCase());
+let u = class extends A {
+  //#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 U(re(this.name))];
+  }
+  static fromJSON(e) {
+    return new u({
+      name: e.name,
+      requireApproval: e.require_approval
+    });
+  }
+  //#endregion
+};
+N([
+  n()
+], u.prototype, "name", 2);
+N([
+  n()
+], u.prototype, "requireApproval", 2);
+N([
+  n()
+], u.prototype, "type", 2);
+u = N([
+  l("ArcgisTool")
+], u);
+var oe = Object.defineProperty, se = Object.getOwnPropertyDescriptor, T = (e) => {
+  throw TypeError(e);
+}, _ = (e, t, o, s) => {
+  for (var r = s > 1 ? void 0 : s ? se(t, o) : t, a = e.length - 1, i; a >= 0; a--)
+    (i = e[a]) && (r = (s ? i(t, o, r) : i(r)) || r);
+  return s && r && oe(t, o, r), r;
+}, ae = (e, t, o) => t.has(e) || T("Cannot " + o), ie = (e, t, o) => t.has(e) ? T("Cannot add the same private member more than once") : t instanceof WeakSet ? t.add(e) : t.set(e, o), ne = (e, t, o) => (ae(e, t, "access private method"), o), S, D;
+let m = class extends d {
+  //#region Lifecycle
+  constructor(e) {
+    super(e), ie(this, S), this.type = "agent-node";
+  }
+  //#endregion
+  //#region Public Methods
+  createRuntimeNode() {
+    let e;
+    return async (t, o) => {
+      e ??= ne(this, S, D).call(this);
+      const r = await (await e).run(t, o), a = this.outputSchema?.safeParse(r);
+      if (a && !a.success)
+        throw a.error;
+      const i = a?.data, O = i ?? r.outputMessage;
+      return {
+        agentExecutionContext: r.agentExecutionContext,
+        ...i ? {} : { outputMessage: r.outputMessage },
+        status: r.status,
+        summary: r.summary,
+        nodes: {
+          [this.id]: { output: O }
+        }
+      };
+    };
+  }
+  compile(e) {
+    const t = e.outgoingEdges[0]?.targetNodeId;
+    return {
+      runtimeNode: this.createRuntimeNode(),
+      edges: [
+        {
+          from: this.id,
+          decide: (o) => o.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 = J(e.structured_output)), t.tools = e.tools?.filter((o) => o.type === "arcgis_tool").map((o) => u.fromJSON(o)), t;
+  }
+  //#endregion
+};
+S = /* @__PURE__ */ new WeakSet();
+D = 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 o of this.tools) {
+      const s = await o.createRuntimeTools();
+      t.push(...s);
+    }
+  return new B({
+    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, P = (e, t, o, s) => {
+  for (var r = s > 1 ? void 0 : s ? pe(t, o) : t, a = e.length - 1, i; a >= 0; a--)
+    (i = e[a]) && (r = (s ? i(t, o, r) : i(r)) || r);
+  return s && r && ce(t, o, r), r;
+};
+let h = class extends d {
+  //#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
+};
+P([
+  n()
+], h.prototype, "type", 2);
+P([
+  n()
+], h.prototype, "message", 2);
+h = P([
+  l("EndMessageNode")
+], h);
+var me = Object.defineProperty, de = Object.getOwnPropertyDescriptor, R = (e, t, o, s) => {
+  for (var r = s > 1 ? void 0 : s ? de(t, o) : t, a = e.length - 1, i; a >= 0; a--)
+    (i = e[a]) && (r = (s ? i(t, o, r) : i(r)) || r);
+  return s && r && me(t, o, r), r;
+};
+let w = class extends d {
+  //#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
+};
+R([
+  n()
+], w.prototype, "type", 2);
+w = R([
+  l("StartNode")
+], w);
+function ue(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 o = K(e);
+  return x.Root({
+    ...o,
+    nodes: x({
+      reducer: (s, r) => ({ ...s, ...r }),
+      default: () => ({})
+    }),
+    ...Q()
+  });
+}
+function q(e) {
+  const t = /* @__PURE__ */ new Set();
+  for (const s of e)
+    for (const r of Object.keys(s.shape ?? {}))
+      r !== "nodes" && t.add(r);
+  const o = Object.fromEntries([...t].map((s) => [s, void 0]));
+  return le(o);
+}
+class E {
+  //#endregion Private Properties
+  //#region Lifecycle
+  constructor(t, o, s) {
+    this.sourceJSON = t, this.edges = o, this.nodes = s, this._loaded = !1;
+  }
+  //#endregion Lifecycle
+  //#region Public Methods
+  static fromJSON(t) {
+    return new E(
+      t,
+      t.graph.edges.map((o) => p.fromJSON(o)),
+      t.graph.nodes.map((o) => ue(o))
+    );
+  }
+  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, r) => {
+        const a = this.nodes[r];
+        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(), o = q(this.getSchemas()), s = this.nodes.find((i) => i.type === "start-node")?.id, r = {}, a = [];
+    for (const [i, O] of this.nodes.entries()) {
+      const b = t[i];
+      b && (b.runtimeNode && (r[O.id] = b.runtimeNode), a.push(...b.edges));
+    }
+    return {
+      createGraph: () => z(r, a, o, { entryNode: s }),
+      workspace: o
+    };
+  }
+  //#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((o) => o.sourceNodeId === t.id)
+      })
+    );
+  }
+  //#endregion Private Methods
+}
+var he = Object.defineProperty, ge = Object.getOwnPropertyDescriptor, C = (e, t, o, s) => {
+  for (var r = s > 1 ? void 0 : s ? ge(t, o) : t, a = e.length - 1, i; a >= 0; a--)
+    (i = e[a]) && (r = (s ? i(t, o, r) : i(r)) || r);
+  return s && r && he(t, o, r), r;
+};
+const fe = () => {
+  throw new Error("WebAgent must be loaded before it can run.");
+};
+let g = class extends L {
+  //#region Lifecycle
+  constructor(e) {
+    super(e);
+  }
+  //#endregion
+  //#region Public Methods
+  async load() {
+    if (this.portalItem) {
+      try {
+        await this.portalItem.load();
+      } catch (o) {
+        throw new y("web-agent:load-portal-item", "Failed to load portal item", { error: o });
+      }
+      const t = await this.portalItem.fetchData();
+      if (this.sourceJSON = t, !this.portalItem.title)
+        throw new y("web-agent:missing-title", "The portal item is missing a title");
+    }
+    if (!this.sourceJSON)
+      throw new y("web-agent:missing-source-json", "The source JSON is missing");
+    if (!this.sourceJSON.description)
+      throw new y("web-agent:missing-description", "The source JSON is missing a description");
+    const e = E.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", q([])), this._set("createGraph", fe);
+      return;
+    }
+    const { createGraph: e, workspace: t } = this._runtime.generate();
+    this._set("workspace", t), this._set("createGraph", e);
+  }
+  //#endregion
+};
+C([
+  n({ type: I })
+], g.prototype, "portalItem", 2);
+C([
+  n()
+], g.prototype, "sourceJSON", 2);
+g = C([
+  l("WebAgent")
+], g);
+class _e extends F {
   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 M(this.context) ? await this.context() : this.context;
+  }
+  async load() {
+    let t;
+    if (this.itemId) {
+      const o = G.getDefault();
+      t = new g({ portalItem: new I({ id: this.itemId, portal: o }) });
+    } 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 = j(this);
   }
-  load() {
-    i(this);
+  disconnectedCallback() {
+    this.#e?.unregister(this.agent.id), super.disconnectedCallback();
   }
 }
-t("arcgis-assistant-agent", n);
+W("arcgis-assistant-agent", _e);
 export {
-  n as ArcgisAssistantAgent
+  _e as ArcgisAssistantAgent
 };

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

@@ -1,45 +1,50 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import { c as s } from "../../chunks/runtime.js";
 import { css as e, html as t } from "lit";
 import { LitElement as i } from "@arcgis/lumina";
-import { createRef as a, ref as o } from "lit/directives/ref.js";
-import l from "@arcgis/core/core/Collection.js";
-import { watch as n } from "@arcgis/core/core/reactiveUtils.js";
-const r = e`.messages-container{display:flex;flex:1;flex-direction:column;line-height:var(--calcite-font-line-height-relative-snug)}.messages-list{padding:var(--calcite-spacing-lg);display:flex;flex-direction:column;gap:var(--calcite-spacing-xxl);flex:1 1 auto;min-height:0;justify-content:flex-end;overflow:auto}`;
-class c extends i {
+import { createRef as a, ref as l } from "lit/directives/ref.js";
+import n from "@arcgis/core/core/Collection.js";
+import { when as r, watch as o } from "@arcgis/core/core/reactiveUtils.js";
+const c = e`.messages-container{display:flex;flex:1;flex-direction:column;line-height:var(--calcite-font-line-height-relative-snug)}.messages-list{padding:var(--calcite-spacing-lg);display:flex;flex-direction:column;gap:var(--calcite-spacing-xxl);flex:1 1 auto;min-height:0;justify-content:flex-end;overflow:auto}.end-ref{margin-top:var(--calcite-spacing-lg)}`;
+class m extends i {
   constructor() {
-    super(...arguments), this.#s = a(), this.loading = !1, this.messages = new l([]), this.interrupt = null;
+    super(...arguments), this.#e = a(), this.#s = !1, this.loading = !1, this.messages = new n([]), this.interrupt = null;
   }
   static {
     this.properties = { loading: 5, messages: 0, interrupt: 0 };
   }
   static {
-    this.styles = r;
+    this.styles = c;
   }
+  #e;
   #s;
   firstUpdated() {
-    this._scrollToEnd();
+    this.#t();
   }
   loaded() {
     this.manager.onLifecycle(() => [
       this.messages.on("change", () => {
-        this._scrollToEnd();
+        this.#t();
       }),
-      n(() => [this.loading, this.interrupt], () => {
-        this._scrollToEnd();
-      })
+      r(() => !this.loading, () => {
+        this.#s = !1;
+      }),
+      o(() => [this.loading, this.interrupt], () => this.#t())
     ]);
   }
-  _scrollToEnd() {
+  #t() {
     requestAnimationFrame(() => {
-      this.#s.value?.scrollIntoView({ behavior: "smooth" });
+      this.#s || this.#e.value?.scrollIntoView({ behavior: "smooth", block: "end" });
     });
   }
+  #i() {
+    this.#s = !0;
+  }
   render() {
-    return t`<div class="messages-container"><div class="messages-list"><slot name=message-starter></slot><slot name=messages></slot><slot name=message-loading></slot></div><div ${o(this.#s)}></div></div>`;
+    return t`<div class="messages-container" @wheel=${this.#i}><div class="messages-list"><slot name=message-starter></slot><slot name=messages></slot><slot name=message-loading></slot></div><div class="end-ref" ${l(this.#e)}></div></div>`;
   }
 }
-s("arcgis-assistant-chat", c);
+s("arcgis-assistant-chat", m);
 export {
-  c as ArcgisAssistantChat
+  m as ArcgisAssistantChat
 };

package/dist/components/arcgis-assistant-chat-entry/customElement.js

@@ -1,4 +1,4 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+/* COPYRIGHT Esri - https://js.arcgis.com/1.0/LICENSE.txt */
 import { c as d } from "../../chunks/runtime.js";
 import { css as p, html as c } from "lit";
 import { LitElement as f, createEvent as l, safeClassMap as g } from "@arcgis/lumina";