@arcgis/ai-components 5.2.0-next.113 → 5.2.0-next.115

package/dist/chunks/resolveGeometryFilter.js

@@ -0,0 +1,149 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import u from "@arcgis/core/geometry/Point.js";
+import p from "@arcgis/core/geometry/Polygon.js";
+import y from "@arcgis/core/geometry/Polyline.js";
+import * as f from "@arcgis/core/geometry/operators/unionOperator.js";
+import r from "zod";
+import { distanceUnitsSchema as m } from "../agents/tools/shared/types.js";
+const d = 750;
+function h(e) {
+  return "point" in e && e.point !== void 0;
+}
+function b(e) {
+  return "layerId" in e && e.layerId !== void 0;
+}
+function R(e) {
+  return "polygon" in e && e.polygon !== void 0;
+}
+function w(e) {
+  return "polyline" in e && e.polyline !== void 0;
+}
+const P = async (e, a) => {
+  if (h(e)) {
+    const { point: t } = e;
+    return { geometry: new u({
+      x: t.x,
+      y: t.y,
+      spatialReference: t.spatialReference ? { wkid: t.spatialReference.wkid } : a.spatialReference
+    }) };
+  }
+  if (R(e))
+    return {
+      geometry: new p({
+        rings: e.polygon.rings,
+        spatialReference: e.polygon.spatialReference
+      })
+    };
+  if (w(e))
+    return {
+      geometry: new y({
+        paths: e.polyline.paths,
+        spatialReference: e.polyline.spatialReference
+      })
+    };
+  if (b(e)) {
+    const t = a.map?.allLayers.find(
+      (n) => n.id === e.layerId
+    );
+    if (!t)
+      return { error: `Could not find geometry layer with ID: ${e.layerId}` };
+    const o = t.title ?? t.id, i = e.where?.trim() || "1=1";
+    try {
+      const n = await t.queryFeatures({
+        where: i,
+        returnGeometry: !0,
+        outSpatialReference: a.spatialReference,
+        num: d + 1
+      });
+      if (!n.features.length)
+        return {
+          error: `No features found in geometry layer "${o}" with the specified where clause: ${i}`
+        };
+      if (n.features.length > d)
+        return {
+          error: `Geometry filter for layer "${o}" matched too many features (${n.features.length}+). Please narrow the geometry layer filter.`
+        };
+      const s = n.features.map((c) => c.geometry).filter((c) => !!c);
+      if (!s.length)
+        return { error: "No valid geometries found for the matched geometry layer features." };
+      const l = s.length === 1 ? s[0] : f.executeMany(s);
+      return l ? (l.spatialReference || (l.spatialReference = a.spatialReference), { geometry: l }) : { error: "Failed to combine geometries from geometry layer." };
+    } catch (n) {
+      return { error: `Failed to query geometry: ${String(n)}` };
+    }
+  }
+  return { error: "Invalid geometry configuration provided" };
+}, I = r.object({ id: r.string() }), g = r.discriminatedUnion("kind", [
+  r.object({
+    id: r.string(),
+    kind: r.literal("point"),
+    payload: r.object({
+      x: r.number(),
+      y: r.number(),
+      spatialReference: r.object({ wkid: r.number() }).optional()
+    })
+  }),
+  r.object({
+    id: r.string(),
+    kind: r.literal("polyline"),
+    payload: r.object({
+      paths: r.array(r.array(r.array(r.number()))),
+      spatialReference: r.object({ wkid: r.number() }).optional()
+    })
+  }),
+  r.object({
+    id: r.string(),
+    kind: r.literal("polygon"),
+    payload: r.object({
+      rings: r.array(r.array(r.array(r.number()))),
+      spatialReference: r.object({ wkid: r.number() }).optional()
+    })
+  })
+]), $ = r.object({
+  sharedResourceId: r.string().describe("ID of a point, polyline, or polygon returned by listSharedResources."),
+  distance: r.number().optional().describe("Optional buffer distance around the geometry."),
+  units: m.optional().describe("The units for the distance buffer.")
+}), x = (e, a) => {
+  if (!e || !("sharedResourceId" in e))
+    return e;
+  if (!a)
+    throw new Error("Shared resources are unavailable in the tool runtime state.");
+  const t = a.find((i) => {
+    const n = I.safeParse(i);
+    return n.success && n.data.id === e.sharedResourceId;
+  });
+  if (!t)
+    throw new Error(`Shared resource not found: ${e.sharedResourceId}`);
+  const o = g.safeParse(t);
+  if (!o.success)
+    throw new Error(
+      `Shared resource ${e.sharedResourceId} does not contain valid point, polyline, or polygon geometry.`
+    );
+  switch (o.data.kind) {
+    case "point":
+      return {
+        point: o.data.payload,
+        distance: e.distance,
+        units: e.units
+      };
+    case "polyline":
+      return {
+        polyline: o.data.payload,
+        distance: e.distance,
+        units: e.units
+      };
+    case "polygon":
+      return {
+        polygon: o.data.payload,
+        distance: e.distance,
+        units: e.units
+      };
+  }
+};
+export {
+  h as a,
+  P as g,
+  b as i,
+  x as r,
+  $ as s
+};

package/dist/chunks/state.js

@@ -1,65 +1,76 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { Annotation as o } from "@langchain/langgraph/web";
-import { c } from "./baseAgentState.js";
-const i = /* @__PURE__ */ new Set(["agentExecutionContext", "outputMessage", "summary", "status"]);
-function u(n) {
-  const r = [...new Set([...n].filter((e) => i.has(e)))];
-  if (r.length !== 0)
-    throw new Error(`custom state cannot define reserved runtime fields: ${r.join(", ")}.`);
+import { Annotation as s } from "@langchain/langgraph/web";
+import { c as a } from "./baseAgentState.js";
+const i = /* @__PURE__ */ new Set([
+  "agentExecutionContext",
+  "outputMessage",
+  "summary",
+  "status",
+  "sharedResourceAdditions"
+]);
+function u(r) {
+  const n = [...new Set([...r].filter((t) => i.has(t)))];
+  if (n.length !== 0)
+    throw new Error(`custom state cannot define reserved runtime fields: ${n.join(", ")}.`);
 }
-function f(n) {
-  const r = Object.entries(n);
+function d(r) {
+  const n = Object.entries(r);
   return Object.fromEntries(
-    r.map(([e, t]) => [
-      e,
-      o({
-        reducer: (s, a) => a,
-        default: () => t
+    n.map(([t, e]) => [
+      t,
+      s({
+        reducer: (o, c) => c,
+        default: () => e
       })
     ])
   );
 }
-function m(n = {}) {
-  u(Object.keys(n));
-  const r = f(n);
-  return o.Root({
-    ...r,
-    agentExecutionContext: o({
-      reducer: (e, t) => ({
-        ...e,
-        ...t
+function f(r = {}) {
+  u(Object.keys(r));
+  const n = d(r);
+  return s.Root({
+    ...n,
+    agentExecutionContext: s({
+      reducer: (t, e) => ({
+        ...t,
+        ...e
       }),
-      default: c
+      default: a
     }),
-    outputMessage: o({
+    outputMessage: s({
       // Preserve the last meaningful user-facing message produced by the graph.
-      reducer: (e = "", t) => typeof t == "string" && t.trim() ? t : e,
+      reducer: (t = "", e) => typeof e == "string" && e.trim() ? e : t,
       default: () => ""
     }),
-    summary: o({
+    summary: s({
       // Summary is a compact orchestrator-facing outcome, so replacement semantics are enough.
-      reducer: (e = "", t) => typeof t == "string" ? t : e,
+      reducer: (t = "", e) => typeof e == "string" ? e : t,
       default: () => ""
     }),
-    status: o({
+    status: s({
       // Keep the first meaningful status until a later node explicitly replaces it.
-      reducer: (e, t) => t ?? e,
+      reducer: (t, e) => e ?? t,
+      default: () => {
+      }
+    }),
+    sharedResourceAdditions: s({
+      reducer: (t, e) => e,
       default: () => {
       }
     })
   });
 }
-function g(n, r = []) {
-  const e = new Set(r);
-  for (const s of n)
-    for (const a of Object.keys(s.shape ?? {}))
-      e.add(a);
-  const t = Object.fromEntries([...e].map((s) => [s, void 0]));
-  return m(t);
+function g(r, n = []) {
+  const t = new Set(n);
+  for (const o of r)
+    for (const c of Object.keys(o.shape ?? {}))
+      t.add(c);
+  const e = Object.fromEntries([...t].map((o) => [o, void 0]));
+  return f(e);
 }
 export {
-  m as a,
+  f as a,
   u as b,
   g as c,
-  f as d
+  d
 };

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;
@@ -106,6 +108,8 @@ export abstract class ArcgisAssistant extends LitElement {
       userPrivilegesNotSufficientMessage: string;
   } & T9nMeta<{
       assistantLabel: string;
+      multipleCommands: string;
+      partsOnlyRequiresAgent: string;
       stopButtonLabel: string;
       askButtonLabel: string;
       stoppedByUserLabel: string;
@@ -189,6 +193,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.
@@ -222,6 +234,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,
@@ -431,6 +450,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
@@ -438,7 +458,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,
@@ -618,7 +638,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"];