@arcgis/ai-components 5.2.0-next.99 → 6.0.0-next.0

package/dist/chunks/textFormatters.js

@@ -0,0 +1,8 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+const c = (r, t = 300) => {
+  const e = r.replace(/\s+/gu, " ").replace(/[*_`#>\-]/gu, "").trim();
+  return e.length > t ? `${e.slice(0, t)}...` : e;
+};
+export {
+  c as t
+};

package/dist/chunks/toolCallResponse.js

@@ -1,33 +1,20 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import "@arcgis/core/identity/IdentityManager.js";
-import "@arcgis/core/portal/Portal.js";
-import "@arcgis/core/request.js";
-import "@langchain/langgraph/web";
-import "@arcgis/toolkit/string";
-import "./generateLayerDescriptions.js";
-import "@langchain/core/messages";
-import { s as a } from "./index.js";
-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 "@langchain/core/prompts";
-const x = async (t, o) => {
-  const i = t.tool_calls ?? [];
-  if (i.length === 0) {
-    await a({ text: `LLM did not request any tool calls: ${String(t?.content)}` }, o);
+import { sendTraceMessage as l } from "../orchestrator/signals.js";
+const s = async (t, a) => {
+  const e = t.tool_calls ?? [];
+  if (e.length === 0) {
+    await l({ text: `LLM did not request any tool calls: ${String(t?.content)}` }, a);
     return;
   }
   await Promise.all(
-    i.map(
-      async (r) => await a(
-        { text: `LLM invoked ${r.name} tool with arguments: ${JSON.stringify(r.args, null, 2)}` },
-        o
+    e.map(
+      async (n) => await l(
+        { text: `LLM invoked ${n.name} tool with arguments: ${JSON.stringify(n.args, null, 2)}` },
+        a
       )
     )
   );
 };
 export {
-  x as h
+  s as h
 };

package/dist/chunks/utils.js

@@ -21,7 +21,7 @@ function f(e) {
 function m(e, s, t = []) {
   const n = s.safeParse(e);
   if (n.success) {
-    const a = { ...n.data }, r = f(a), o = r ?? "LLMAgent produced structured output.", u = r ?? a.outputMessage, c = {
+    const a = { ...n.data }, r = f(a), o = r ?? "Agent produced structured output.", u = r ?? a.outputMessage, c = {
       ...a,
       ...u ? { outputMessage: u } : {},
       agentExecutionContext: {
@@ -33,7 +33,7 @@ function m(e, s, t = []) {
     };
     return p(c, "success", o);
   } else
-    throw new Error(`LLMAgent output schema validation failed: ${n.error.message}`);
+    throw new Error(`Agent output schema validation failed: ${n.error.message}`);
 }
 function l(e, s) {
   const t = {

package/dist/chunks/utils2.js

@@ -1,47 +1,23 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { getClosestElement as i } from "@arcgis/toolkit/dom";
-import { g as s, a as o } from "./utils3.js";
-function c(e, t) {
-  const r = s(e.el, e.referenceElement);
-  if (r)
-    return r;
-  const n = i(e.el, "arcgis-assistant"), a = s(e.el, n?.referenceElement);
-  if (a)
-    return a;
-  throw new Error(`${t}: Reference element not found`);
+function c(o, s) {
+  if (!s)
+    return;
+  const t = typeof s == "string" ? u(o, s) : s;
+  return t?.localName === "arcgis-assistant" && t.isConnected ? t : void 0;
 }
-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 g(o, s) {
+  return s ? typeof s == "string" ? u(o, s) ?? null : s : i(o, "arcgis-map") ?? null;
 }
-function w(e) {
-  return typeof e == "function";
+function d(o, s) {
+  return s ? typeof s == "string" ? u(o, s) ?? null : s : i(o, "arcgis-link-chart") ?? i(o, "arcgis-map") ?? null;
 }
-function g(e) {
-  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");
-  return t.register({
-    agent: e.agent,
-    getContext: async () => await e.getContext?.() ?? e.context ?? {}
-  }), t;
-}
-function l(e) {
-  const t = o(e.el, e.referenceElement);
-  if (t)
-    return t;
-  const r = i(e.el, "arcgis-assistant"), n = s(e.el, r?.referenceElement);
-  return n || null;
-}
-function v(e) {
-  const t = l(e);
-  return t ? t.view : null;
+function u(o, s) {
+  const t = s.includes("#") || s.includes(".") || s.includes("["), a = o.getRootNode();
+  return (t ? void 0 : a.querySelector(`#${s}`)) ?? a.querySelector(s) ?? void 0;
 }
 export {
-  v as a,
-  w as b,
-  g as i,
-  m as r
+  d as a,
+  c as b,
+  g
 };

package/dist/chunks/utils3.js

@@ -1,16 +1,47 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-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;
+import { getClosestElement as i } from "@arcgis/toolkit/dom";
+import { g as s, a as o } from "./utils2.js";
+function c(e, t) {
+  const r = s(e.el, e.referenceElement);
+  if (r)
+    return r;
+  const n = i(e.el, "arcgis-assistant"), a = s(e.el, n?.referenceElement);
+  if (a)
+    return a;
+  throw new Error(`${t}: Reference element not found`);
 }
-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 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 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;
+function g(e) {
+  return typeof e == "function";
+}
+function w(e) {
+  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");
+  return t.register({
+    agent: "registration" in e.agent ? e.agent.registration : e.agent,
+    getContext: async () => await e.getContext?.() ?? e.context ?? {}
+  }), t;
+}
+function l(e) {
+  const t = o(e.el, e.referenceElement);
+  if (t)
+    return t;
+  const r = i(e.el, "arcgis-assistant"), n = s(e.el, r?.referenceElement);
+  return n || null;
+}
+function v(e) {
+  const t = l(e);
+  return t ? t.view : null;
 }
 export {
-  n as a,
-  l as g
+  v as a,
+  g as b,
+  w as i,
+  m as r
 };

package/dist/chunks/webmapSchema.js

@@ -0,0 +1,56 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import { z as e } from "zod";
+import { E as o } from "./modelConfig.js";
+const m = (r, i, s) => {
+  const n = r[i];
+  return n ? typeof n == "function" ? n() : Promise.resolve(n) : new Promise((g, a) => {
+    (typeof queueMicrotask == "function" ? queueMicrotask : setTimeout)(a.bind(null, /* @__PURE__ */ new Error("Unknown variable dynamic import: " + i + (i.split("/").length !== s ? ". Note that variables only represent file names one level deep." : ""))));
+  });
+}, y = async (r) => (await m(/* @__PURE__ */ Object.assign({ "./field_descriptions_prompt.md": () => import("./field_descriptions_prompt.js"), "./intent_prompt.md": () => import("./intent_prompt.js"), "./layer_descriptions_prompt.md": () => import("./layer_descriptions_prompt.js") }), `./${r}.md`, 2)).default, l = "0.1", t = 1536, c = "openai", d = o.default, p = `Name: {name}
+Title: {title}
+Description: {description}`, u = `Name: {name}
+Alias: {alias}
+Description: {description}`, v = e.object({
+  schemaVersion: e.literal(l),
+  modified: e.number().int().nonnegative(),
+  embeddings: e.object({
+    modelProvider: e.literal(c),
+    model: e.literal(d),
+    dimensions: e.literal(t),
+    templates: e.object({
+      layer: e.string().default(p),
+      field: e.string().default(u)
+    })
+  }),
+  layers: e.array(
+    e.object({
+      id: e.string().min(1),
+      name: e.string().min(1),
+      title: e.string().catch(""),
+      description: e.string().catch(""),
+      vector: e.array(e.number()).length(t, {
+        message: `Layer vector must be exactly ${t} dimensions`
+      }),
+      fields: e.array(
+        e.object({
+          name: e.string().min(1),
+          alias: e.string().catch(""),
+          description: e.string().catch(""),
+          vector: e.array(e.number()).length(t, {
+            message: `Field vector must be exactly ${t} dimensions`
+          })
+        })
+      )
+    })
+  ).default([])
+});
+export {
+  v as W,
+  c as a,
+  t as d,
+  u as f,
+  y as g,
+  p as l,
+  d as m,
+  l as s
+};

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

@@ -2,7 +2,7 @@
 import type Collection from "@arcgis/core/core/Collection.js";
 import type { RuntimeSpanEvent } from "../../orchestrator/orchestrator/orchestratorEvents.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { AssistantMessage, AssistantPromptSelectDetail, AssistantSlottableRequestDetail, ChatMessage, Interrupt } from "./types.js";
+import type { AssistantCommandProvider, AssistantEntityProvider, AssistantMessage, AssistantSubmission, AssistantPromptSelectDetail, AssistantSlottableRequestDetail, ChatMessage, Interrupt, SubmitMessageOptions } from "./types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 import type { ArcgisMap as ArcgisMap } from "@arcgis/map-components/components/arcgis-map";
 
@@ -88,6 +88,8 @@ export abstract class ArcgisAssistant extends LitElement {
   /** @internal */
   protected _messages: {
       assistantLabel: string;
+      multipleCommands: string;
+      partsOnlyRequiresAgent: string;
       stopButtonLabel: string;
       askButtonLabel: string;
       stoppedByUserLabel: string;
@@ -101,8 +103,14 @@ export abstract class ArcgisAssistant extends LitElement {
       readMoreLabel: string;
       learnAboutWebMapEmbeddingsLabel: string;
       waitingForUserInputMessage: string;
+      aiAssistantsNotEnabledMessage: string;
+      serviceUrlNotAvailableMessage: string;
+      userPrivilegesNotSufficientMessage: string;
+      messageProcessingErrorMessage: string;
   } & T9nMeta<{
       assistantLabel: string;
+      multipleCommands: string;
+      partsOnlyRequiresAgent: string;
       stopButtonLabel: string;
       askButtonLabel: string;
       stoppedByUserLabel: string;
@@ -116,28 +124,52 @@ export abstract class ArcgisAssistant extends LitElement {
       readMoreLabel: string;
       learnAboutWebMapEmbeddingsLabel: string;
       waitingForUserInputMessage: string;
+      aiAssistantsNotEnabledMessage: string;
+      serviceUrlNotAvailableMessage: string;
+      userPrivilegesNotSufficientMessage: string;
+      messageProcessingErrorMessage: string;
   }>;
   /**
-   * The IDs of the agents available to automatic intent routing.
+   * The IDs of the agents available for automatic intent routing.
    * A single ID still uses automatic routing and does not enable direct routing.
    * This property cannot be used together with [alwaysUseAgentId](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/#alwaysUseAgentId).
+   * If this property is not set, all registered agents are available for routing.
+   *
+   * > **Note:** Agent ids for custom agents are automatically created from the agent's
+   * > [BaseAgent.name](https://developers.arcgis.com/javascript/latest/references/ai-components/agent-utils/BaseAgent/#name) property.
+   * > For example, an agent with the name "My Custom Agent" will have the id "my-custom-agent".
+   *
+   * Agent ids for SDK agents are as follows:
+   *
+   * - Navigation Agent: `navigation`
+   * - Data Exploration Agent: `data-exploration`
+   * - Help Agent: `help`
+   * - Knowledge Agent: `knowledge`
    *
    * @since 5.2
    * @example
    * ```js
    * const assistant = document.querySelector("arcgis-assistant");
+   * // only route user questions to either the navigation or help agents
+   * // even if other agents are registered to the assistant
    * assistant.allowedAgentIds = ["navigation", "help"];
    * ```
    */
   accessor allowedAgentIds: readonly string[] | undefined;
   /**
    * The ID of the agent that should process every user message without intent routing.
-   * When this property is set, it cannot be used together with [allowedAgentIds](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/#allowedAgentIds).
+   * When set, the assistant will route all user messages to the specified agent.
+   *
+   * This is useful for applications that want to bypass the orchestrator's default intent routing
+   * in favor of a single custom agent that directly handles its own intent orchestration to one or more sub-agents. This property
+   * should not be used to route requests to an SDK agent, as the SDK agents do not have their own intent routing outside of the orchestrator.
+   *
+   * This property cannot be used together with [allowedAgentIds](https://developers.arcgis.com/javascript/latest/references/ai-components/components/arcgis-assistant/#allowedAgentIds).
    *
    * @since 5.2
    * @example
    * ```html
-   * <arcgis-assistant always-use-agent-id="navigation"></arcgis-assistant>
+   * <arcgis-assistant always-use-agent-id="my-custom-orchestration-agent"></arcgis-assistant>
    * ```
    */
   accessor alwaysUseAgentId: string | undefined;
@@ -163,6 +195,14 @@ export abstract class ArcgisAssistant extends LitElement {
    * @since 5.1
    */
   get awaitingResponseStep(): string;
+  /**
+   * Provider used by the built-in chat entry to suggest slash commands.
+   * Selected commands are included as structured input and removed from the prompt sent to the agent.
+   * A command with an `agentId` routes that request directly to the specified agent.
+   *
+   * @internal
+   */
+  accessor commandProvider: AssistantCommandProvider | undefined;
   /**
    * When `true`, enables the copy action that, when clicked, copies the content of the message to the clipboard. This can be helpful for users to easily copy and share
    * information provided by the assistant, such as a summary of findings, a set of instructions, or any other relevant details. Enabling this property can enhance the user experience by providing a convenient way for users to capture and utilize the information generated by the assistant.
@@ -196,6 +236,13 @@ export abstract class ArcgisAssistant extends LitElement {
    * ```
    */
   accessor description: string | undefined;
+  /**
+   * Providers used by the built-in chat entry to suggest structured entities.
+   * Selected entities remain in the prompt and do not affect agent routing.
+   *
+   * @internal
+   */
+  accessor entityProviders: readonly AssistantEntityProvider[] | undefined;
   /**
    * The instructions to display when the assistant is first loaded. This is intended to be a welcome or entry message that
    * provides guidance to users on how to interact with the assistant. Once the user submits their first message,
@@ -405,6 +452,7 @@ export abstract class ArcgisAssistant extends LitElement {
    * complex interactions and integrations with other components or services.
    *
    * @param message - The message to submit to the assistant. This should be a string containing the user's input or question they want to ask the assistant.
+   * @param options
    * @since 5.0
    * @example
    * ```js
@@ -412,7 +460,7 @@ export abstract class ArcgisAssistant extends LitElement {
    * assistant.submitMessage("What is the population of New York City?");
    * ```
    */
-  submitMessage(message: string): Promise<void>;
+  submitMessage(message: string, options?: SubmitMessageOptions): Promise<void>;
   /**
    * Emitted when the user cancels a message. This is typically invoked when a user submits a question while a previous question is still being processed.
    * This allows app developers to capture messages cancelled by the user and respond to them in custom ways, such as by providing additional information,
@@ -592,7 +640,7 @@ export abstract class ArcgisAssistant extends LitElement {
    * });
    * ```
    */
-  readonly arcgisSubmit: import("@arcgis/lumina").TargetedEvent<this, string>;
+  readonly arcgisSubmit: import("@arcgis/lumina").TargetedEvent<this, AssistantSubmission | string>;
   readonly "@eventTypes": {
     arcgisCancel: ArcgisAssistant["arcgisCancel"]["detail"];
     arcgisError: ArcgisAssistant["arcgisError"]["detail"];