@esri/solutions-components 5.1.0-next.14 → 5.1.0-next.140

package/dist/chunks/assistantResponse.js

@@ -0,0 +1,51 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
+const e = `# Your Role\r
+You are the ArcGIS Solutions assistant responding to a user request that is outside the supported capabilities for solution exploration or solution building, or is a meta question about the assistant itself.\r
+\r
+You must follow all rules below at all times. If a request conflicts with these rules, prioritize the rules.\r
+\r
+# Your Task\r
+- Analyze the User Query and chat history\r
+- If the user is expressing gratitude or closing the interaction:\r
+  - Respond politely and naturally.\r
+  - Do NOT reference routing, limitations, or rationale.\r
+  - Offer a simple, friendly invitation to continue if needed.\r
+\r
+- If the user asked about the assistant itself:\r
+  - Respond briefly and at a high level\r
+  - Do NOT reference routing, limitations, or rationale.\r
+  - Describe capabilities using the Supported Capabilities section\r
+\r
+- For all other requests:\r
+  - Use the provided Routing Rationale to briefly acknowledge the user’s request and explain why you cannot help with it, without referencing scope, internals, or implementation details.\r
+  - State what you CAN help with using ONLY the predefined capability statements below. Do NOT customize, contextualize, or adapt them to the user’s request.\r
+  - Treat general knowledge, definitional, or explanatory questions as unsupported, even if the answer is commonly known.\r
+\r
+You are NOT here to solve, interpret, summarize, define, or partially address the original request, even if the information is commonly known or available from general knowledge.\r
+\r
+# Routing Rational\r
+{rationale}\r
+\r
+# Supported Capabilities\r
+When describing what you can help with, use ONLY these options.\r
+\r
+- Explore existing solutions and understand what they do.\r
+- Answer questions using ArcGIS Solutions documentation.\r
+- Help build a solution for a specific workflow.\r
+\r
+# Response Rules\r
+- Do NOT attempt to answer, solve, or partially address the original request\r
+- Do NOT reinterpret, generalize, or reframe the original request into a different problem\r
+- Do NOT imply that supported capabilities can indirectly solve the original request\r
+- Do NOT describe hypothetical workflows that sound related to the original request\r
+- Do NOT suggest workarounds outside ArcGIS Solutions\r
+- Do NOT ask follow-up questions about the original request\r
+- Do NOT provide definitions, descriptions, examples, background information, or factual statements about the subject of the user’s request.\r
+- Do NOT use text formatting such as bold, italics, or underlining\r
+- Keep the response concise (2–3 sentences is ideal)\r
+- Use plain, professional, user-focused language\r
+- If you are describing something a user explores, builds, designs, updates, or deploys, you MUST use the generic terms “solution” or “solutions” — NOT “ArcGIS Solutions" or "ArcGIS solution".\r
+- When asked who you are, refer to yourself as the ArcGIS Solutions assistant.`;
+export {
+  e as default
+};

package/dist/chunks/cardFetchingUtils.js

@@ -1,321 +1,40 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import { s as U, d as D, e as g, b as I } from "./cardsHelpers.js";
-import * as l from "@esri/solution-common";
-import { L as M, y as B, M as N, N as E, O as T, Q as y, B as J } from "./interfaces.js";
-class x {
-  /**
-   * Constructor
-   *
-   * @param orgUrl URL of organization, e.g., "http://myOrg.maps.arcgis.com"
-   * @param portalUrl URL of portal, e.g., "https://www.arcgis.com"
-   * @param userSession Authentication
-   */
-  constructor(r, t, s) {
-    this.cMissingImageDataURI = "https://static.arcgis.com/images/solution.png", this.cardCache = [], this.cardCacheParams = {
-      q: "",
-      categoriesAsStr: "[]",
-      sortField: "title",
-      sortOrder: "asc"
-    }, this.locale = r, this.orgUrl = t, this.portalUrl = s, this.anonAgolSession = new l.UserSession({}), this.agolPortalUrl = M(s);
-  }
-  /**
-   * Adds a card to the cache to keep cache fresh between full refreshes.
-   *
-   * @param card Card to add
-   */
-  addToCache(r) {
-    this.cardCache.push(r);
-  }
-  /**
-   * Returns the current cache.
-   *
-   * @returns Cards in the cache
-   */
-  getCache() {
-    return this.cardCache;
-  }
-  /**
-   * Removes a card to the cache to keep cache fresh between full refreshes.
-   *
-   * @param id Id of card to remove
-   */
-  removeFromCache(r) {
-    this.cardCache = this.cardCache.filter((t) => t.id !== r);
-  }
-  /**
-   * Fetches cards for availale Solutions from the server.
-   *
-   * @param query AGO query terms and options
-   * @param primarySolutionsGroupId Id of a group that's the primary source of Solutions for AGO or Enterprise
-   * @param agoBasedEnterpriseSolutionsGroupId Id of an AGO-based set of Enterprise Solutions
-   * @param userSession Authentication for thumbnailUrl
-   * @param isEnterprise When true we are working with an enterprise portal
-   * @param signal AbortController signal
-   * @param pagingParams Parameters for how the request is to be batched
-   * @param acceptableIds A set of item ids that the results must be a part of; if not defined, then there's no restriction
-   * @returns A promise resolving to a collection of available Solutions as cards as well as paging information about
-   * where those cards came from in the fetcher cache; in case of failure, the promise resolves to an error message
-   */
-  requestAvailableSolutionCards(r, t, s, e, i, c, a, o) {
-    const C = a?.start ? a.start : 1, f = a?.num ? a.num : 24, p = this.portalUrl + "/sharing/rest", u = this.agolPortalUrl + "/sharing/rest", P = this.anonAgolSession, F = JSON.stringify(r.categories);
-    if (this.cardCacheParams.q !== r.q || this.cardCacheParams.categoriesAsStr !== F || r.sortField === "relevance" ? (this.cardCache = [], this.cardCacheParams = {
-      q: r.q,
-      categoriesAsStr: F,
-      sortField: r.sortField,
-      sortOrder: r.sortOrder
-    }) : (this.cardCacheParams.sortField !== r.sortField || this.cardCacheParams.sortOrder !== r.sortOrder) && (this.cardCacheParams.sortField = r.sortField, this.cardCacheParams.sortOrder = r.sortOrder, this.cardCache = U(
-      this.cardCache,
-      this.cardCacheParams.sortField,
-      this.cardCacheParams.sortOrder
-    )), this.cardCache.length > 0) {
-      let n;
-      if (o && o.size > 0) {
-        const d = D(this.cardCache, o);
-        n = g(d, C, f);
-      } else
-        n = g(this.cardCache, C, f);
-      return Promise.resolve(n);
-    }
-    const w = {
-      filter: r.filter,
-      sortField: r.sortField,
-      sortOrder: r.sortOrder,
-      categories: r?.categories ? this.convertSearchCategories(r.categories) : "",
-      signal: c
-    }, S = [];
-    if (t && !i) {
-      const n = e || new l.UserSession({});
-      S.push(
-        l.searchGroupAllContents(
-          t,
-          r.q,
-          n,
-          w,
-          p
-        )
-      );
-    }
-    return s && i && S.push(
-      l.searchGroupAllContents(
-        s,
-        r.q,
-        P,
-        w,
-        u
-      )
-    ), Promise.allSettled(S).then((n) => {
-      const d = [];
-      n.forEach((m) => {
-        if (m.status === "fulfilled") {
-          const A = m.value;
-          let v = "", R = !1;
-          v = this.agolPortalUrl, R = !0, A.results.forEach((b) => {
-            b.sourcePortalUrl = v, b.knownToBePublicSource = R;
-          }), d.push(A);
-        } else if (m.status === "rejected")
-          throw new Error(
-            m.reason.message ? m.reason.message : "cannotAccessAGO"
-            // (isPrimary
-            // // A failed fetch of the primary group in enterprise or AGO
-            // ? result.reason.message
-            // // We're in enterprise and configured to search AGO (because agoBasedEnterpriseSolutionsGroupId
-            // // is defined), but appear not to be able to reach the internet
-            // : "enterpriseCannotAccessAGO"
-            // ) as string
-          );
-      }), d.length === 0 ? this.cardCache = [] : d.length === 1 ? this.cardCache = this.getCardsFromResponse(d[0]) : this.cardCache = U(
-        this.getCardsFromResponse(this.mergeResponses(d)),
-        this.cardCacheParams.sortField,
-        this.cardCacheParams.sortOrder
-      );
-      let O;
-      if (o && o.size > 0) {
-        const m = D(this.cardCache, o);
-        O = g(m, C, f);
-      } else
-        O = g(this.cardCache, C, f);
-      return Promise.resolve(O);
-    }).catch((n) => Promise.reject(new Error(n.message)));
-  }
-  /**
-   * Fetches cards for deployed Solutions from the server.
-   *
-   * @param query AGO query terms and options
-   * @param userSession Authentication for thumbnailUrl
-   * @returns A collection of deployed Solutions as cards; the paging information shows that all of the cards
-   * are returned
-   */
-  requestDeployedSolutionCards(r, t, s = "", e) {
-    const i = this.portalUrl + "/sharing/rest";
-    if (e.aborted)
-      return Promise.resolve([]);
-    if (this.cardCacheParams.q !== r.q || this.cardCacheParams.categoriesAsStr !== JSON.stringify(r.q) || r.sortField === "relevance" ? (this.cardCache = [], this.cardCacheParams = {
-      q: r.q,
-      categoriesAsStr: "[]",
-      sortField: r.sortField,
-      sortOrder: r.sortOrder
-    }) : (this.cardCacheParams.sortField !== r.sortField || this.cardCacheParams.sortOrder !== r.sortOrder) && (this.cardCacheParams.sortField = r.sortField, this.cardCacheParams.sortOrder = r.sortOrder, this.cardCache = U(
-      this.cardCache,
-      this.cardCacheParams.sortField,
-      this.cardCacheParams.sortOrder
-    )), e.aborted)
-      return Promise.resolve([]);
-    if (this.cardCache.length > 0) {
-      const a = g(this.cardCache, 1, this.cardCache.length);
-      return Promise.resolve(a);
-    }
-    const c = {
-      q: r.q,
-      filter: r.filter,
-      sortField: r.sortField,
-      sortOrder: r.sortOrder,
-      authentication: t,
-      portal: i,
-      categories: r?.categories ? JSON.stringify(r.categories) : "",
-      num: r.num,
-      signal: e
-    };
-    return s ? l.getItemBase(s, t).then((a) => {
-      if (e.aborted)
-        return Promise.resolve([]);
-      this.cardCache = this.getCardsFromResponse({ results: [a] });
-      const o = g(this.cardCache, 1, this.cardCache.length);
-      return Promise.resolve(o);
-    }).catch((a) => Promise.reject(new Error(a))) : l.searchAllItems(c).then((a) => {
-      this.cardCache = this.getCardsFromResponse(a);
-      const o = g(this.cardCache, 1, this.cardCache.length);
-      return Promise.resolve(o);
-    }).catch((a) => Promise.reject(new Error(a)));
-  }
-  // ---------------------------------------------------------------------------------------------------------------- //
-  /**
-   * Stringifies categories for search.
-   *
-   * @param categories AGO item categories, e.g., "/Categories/Conservation"
-   * or ["/Categories/Conservation", "/Categories/Pipeline"]
-   * @returns Categories where each element is a stringified array of categories
-   */
-  convertSearchCategories(r) {
-    return r && (Array.isArray(r) ? r = r.map(
-      (t) => JSON.stringify(Array.isArray(t) ? t : [t])
-      // force to an array to allow categories with commas
-    ) : r = JSON.stringify([r])), r;
-  }
-  /**
-   * Constructs Solution cards from a Solution-query response.
-   *
-   * @param response Response from a query
-   * @returns Solution information as cards
-   */
-  getCardsFromResponse(r) {
-    return r.results.length > 0 ? l.sanitizeJSON(r.results).map(
-      (e) => {
-        const i = e.sourcePortalUrl ? e.sourcePortalUrl : this.portalUrl, c = e.sourcePortalUrl ? e.sourcePortalUrl : this.orgUrl, a = {
-          id: e.id,
-          title: e.title,
-          snippet: e.snippet || "",
-          description: e.description || "",
-          url: e.url || "",
-          itemUrl: `${c}/home/item.html` + y([{ k: "id", v: e.id }]) || "",
-          thumbnailFilename: e.thumbnail,
-          thumbnailUrl: T(
-            e.id,
-            e.thumbnail,
-            this.cMissingImageDataURI,
-            i
-          ),
-          tryitUrl: e.url || "",
-          typeKeywords: e.typeKeywords,
-          learnMoreUrl: e.properties?.learnMoreUrl || "",
-          createdMs: e.created,
-          created: E(e.created, this.locale),
-          modified: E(e.modified, this.locale),
-          numViews: e.numViews,
-          tags: e.tags,
-          categories: e.groupCategories && e.groupCategories.length > 0 ? e.groupCategories : e.categories || [],
-          licenseInfo: N(e.licenseInfo),
-          deployCommonId: B(e.typeKeywords || [], "solutionid-"),
-          deployVersion: B(e.typeKeywords || [], "solutionversion-"),
-          canDelete: e.created > 16183314e5,
-          // Only solutions deployed after April 13, 2021 at 9:30PM can be deleted (9.1 release)
-          preview: this.preparePreviewImageUrls(e.id, e.properties?.preview, i),
-          sourcePortalUrl: e.sourcePortalUrl || "",
-          knownToBePublicSource: e.knownToBePublicSource || !1,
-          waitId: "",
-          relatedSolutions: l.getProp(e, "properties.relatedSolutions") || [],
-          owner: e.owner
-        };
-        return a.deployCommonId !== "" && a.deployVersion !== "" ? a : null;
-      }
-    ).filter((e) => e != null) : [];
-  }
-  /**
-   * Merge a set of search responses into a single response item.
-   *
-   * @param responseSet Array of search results
-   * @returns A response item that takes its query from the first item in the set and sets the other properties
-   * as if all of the responses are the result of one, large query that's independent of AGO's 100-item limit.
-   */
-  mergeResponses(r) {
-    let t = 0;
-    r.forEach((e) => t += e.total);
-    let s = [];
-    return r.forEach((e) => s = s.concat(e.results)), {
-      query: r[0].query,
-      start: 1,
-      num: t,
-      nextStart: -1,
-      total: t,
-      results: s
-    };
-  }
-  /**
-   * Converts image preview information into a URL pointing to that image; returns non-image previews unchanged.
-   *
-   * @param id Item id to insert into URL
-   * @param preview List of previews to modify
-   * @returns Copy of previews with iamge previews modified
-   */
-  preparePreviewImageUrls(r, t, s) {
-    return t ? t.map(
-      (e) => (e.format === "image" && (e.name = s + "/sharing/rest/content/items/" + r + "/resources/" + e.name), e)
-    ) : [];
-  }
-}
-async function z(h, r, t, s, e = J, i = "created", c = "desc", a = !1, o = [], C = [], f, p, u) {
-  if (!h?.IsSignedIn)
+import "@esri/solution-common";
+import { g as p } from "./cardsHelpers.js";
+import { B as y } from "./interfaces.js";
+async function _(e, n, r, o, t = y, i = "created", s = "desc", a = !1, l = [], u = [], c, f, g) {
+  if (!e?.IsSignedIn)
     return;
-  const P = {
-    q: e,
+  const d = {
+    q: t,
     filter: "type:Solution",
     sortField: i,
-    sortOrder: c,
+    sortOrder: s,
     delay: a,
-    categories: o,
+    categories: l,
     num: 100
   };
-  return P.q += k(h, p), await K(
-    r,
-    P,
-    s,
-    C,
+  return d.q += S(e, f), await m(
+    n,
+    d,
+    o,
     u,
-    f
+    g,
+    c
   );
 }
-function k(h, r) {
-  let t = "";
-  const s = h.PortalUserOrg, e = h.PortalUserName;
-  return s && (t += " orgid:" + s), r !== "My organization's solutions" && e && (t += " owner:" + e), t;
+function S(e, n) {
+  let r = "";
+  const o = e.PortalUserOrg, t = e.PortalUserName;
+  return o && (r += " orgid:" + o), n !== "My organization's solutions" && t && (r += " owner:" + t), r;
 }
-async function K(h, r, t, s, e = "", i) {
-  const c = await t.requestDeployedSolutionCards(r, h, e, i), a = I(c.cards, s);
+async function m(e, n, r, o, t = "", i) {
+  const s = await r.requestDeployedSolutionCards(n, e, t, i), a = p(s.cards, o);
   return {
-    cards: c.cards,
+    cards: s.cards,
     relatedSolutions: a
   };
 }
 export {
-  x as C,
-  z as g
+  _ as g
 };

package/dist/chunks/cardsHelpers.js

@@ -1,13 +1,13 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
 import "@esri/solution-common";
-import { y as a } from "./interfaces.js";
-function S(o, t) {
+import { o as a } from "./helpers.js";
+function p(o, t) {
   const n = [];
   return o.forEach((e) => {
     t.has(e.id) && n.push(e);
   }), n;
 }
-function p(o, t, n) {
+function y(o, t, n) {
   if (t < 1 || o.length < t)
     return {
       cards: [],
@@ -96,13 +96,13 @@ function b(o, t) {
   return u(n.title);
 }
 export {
-  b as a,
-  g as b,
+  p as a,
+  I as b,
   u as c,
-  S as d,
-  p as e,
-  I as f,
-  m as g,
-  h,
+  b as d,
+  y as e,
+  h as f,
+  g,
+  m as h,
   w as s
 };

package/dist/chunks/classifyIntent.js

@@ -0,0 +1,120 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
+const e = `# Your Role\r
+You are a tool selector for the ArcGIS Solutions assistant. Your job is to select the single most appropriate tool based strictly on the User Query and the chat history provided.\r
+\r
+# Your Task\r
+- Analyze the User Query and chat history\r
+- Select exactly ONE tool\r
+- Return a confidence score (0.00–1.00) and a brief rationale (≤140 characters)\r
+- Use chat history to resolve intent, but prioritize the latest User Query if there is conflict\r
+\r
+# Design Context\r
+An active solution design may or may not be available.\r
+- \`activeSolutionDesign\`: {activeSolutionDesign}\r
+\r
+If \`activeSolutionDesign\` is true, the user may refer to the solution implicitly (e.g., “this solution”, “the design”, “it”) or request changes without restating build intent.\r
+\r
+# Scope Context\r
+ArcGIS Solutions are a set of pre-configured applications and tools designed to address specific industry needs and workflows within the ArcGIS platform. They provide users with ready-to-use capabilities that can help streamline processes, improve decision-making, and enhance productivity. ArcGIS Solutions support the following industries:\r
+- Architecture, Engineering, and Construction (AEC)\r
+- Airports, Ports, and Rails\r
+- Business\r
+- Conservation\r
+- Defense\r
+- Facilities\r
+- Health and Human Services\r
+- Pipeline\r
+- Public Safety\r
+- Renewables\r
+- State and Local Government\r
+- Telecommunications\r
+- Utilities\r
+\r
+# Rules\r
+You must follow all rules below at all times. If a request conflicts with these rules, prioritize the rules in this order:\r
+1) Builder Exclusions Override\r
+2) Active Design\r
+3) Context-Aware Builder\r
+4) General ArcGIS Help\r
+5) Uncertainty\r
+\r
+## Builder Exclusion Override\r
+The following are unsupported capabilities of the \`builder\` tool. If the request matches any of the following criteria, you MUST select \`other\`, even if the user explicitly says they want to build a solution:\r
+1) References to ArcGIS products, services or capabilities:\r
+   - Request references an ArcGIS product, app, or capability.\r
+   - Request references the Utility Network, Parcel Fabric, Branch Versioned, or other advanced service types\r
+2) Build/derive from an existing solution or schema:\r
+   - Reuqest to build a solution from an existing solution or schema from an existing solution\r
+   - Request to clone/copy/import/convert/recreate from an existing schema/geodatabase/feature service\r
+3) External resources or URLs as the source of truth:\r
+   - Request includes a URL/file/reference and to use as a source for the solution\r
+   - Builder cannot fetch or ingest external resources\r
+\r
+If you select \`other\`, your rationale MUST explicitly state:\r
+- Which exclusion was triggered, and\r
+- That \`builder\` could not be selected because the request includes an unsupported capability.\r
+\r
+## Context-Aware Builder\r
+If prior chat has established intent to build a solution, ANY subsequent user message that describes a workflow, use case, or requirements MUST be treated as input to the solution being built and MUST select \`builder\`.\r
+\r
+## Active Design\r
+If \`activeSolutionDesign\` is true and the user requests changes, updates, refinements, or adjustments to a solution or its components—even without explicitly stating build intent—you MUST select \`builder\`.\r
+\r
+Examples include:\r
+- “Add a status field”\r
+- “Rename the inspections layer”\r
+- “Update the domain values”\r
+- “Change the title”\r
+\r
+## General ArcGIS Help\r
+If the user asks to define, explain, use, configure, or understand an ArcGIS product or service you MUST select \`other\` unless the query explicitly mentions ArcGIS Solutions or a specific solution.\r
+\r
+## Uncertainty\r
+If you are not confident that a request clearly matches a specific tool, you MUST return \`other\`.\r
+\r
+# Available Tools\r
+Return exactly one of the following tool names:\r
+- explorer\r
+- builder\r
+- other\r
+\r
+## builder\r
+Select \`builder\` when the user explicitly intends to build, create, design, or update a custom solution.\r
+\r
+Use this tool when the user:\r
+- Asks how to build a solution or what kinds of solutions they can build\r
+- Asks to create, build, or design a solution\r
+- Asks to update, modify, or refine an existing solution design:\r
+  - Updating solution metadata (title, description, tags)\r
+  - Modifying existing layers, fields, or attributes\r
+  - Adding or removing layers or fields\r
+\r
+## explorer\r
+Select \`explorer\` when the user is discovering, understanding, or evaluating existing ArcGIS Solutions using official documentation.\r
+\r
+Use this tool when the user:\r
+- Asks what solutions exist for a workflow, role, or domain\r
+- Describes a real-world workflow commonly addressed by ArcGIS Solutions (even without mentioning ArcGIS)\r
+- Asks general questions about ArcGIS Solutions (what they are, how they work, what’s included)\r
+- Asks how to deploy a solution (e.g., “How do I deploy a solution?”)\r
+- Asks for steps, guidance, or explanations about deployment\r
+- Asks about a specific solution’s details or configuration (how to configure/use the solution)\r
+- Asks about solution implementation guidance\r
+\r
+## other\r
+Select \`other\` when:\r
+- The request does not match any available tool or you are uncertain between tools\r
+- The topic is unrelated to ArcGIS Solutions or clearly outside supported workflows/domains\r
+- The request is about an ArcGIS product or service and does not mention ArcGIS Solutions or a specific solution.\r
+- The request is about general GIS or unrelated software without reference to ArcGIS Solutions\r
+- The request is instucting the assistant to deploy a solution\r
+- The request is a meta question about the assistant itself (Who are you?, What do you do?, What can I do here?)\r
+- The request is ambiguous or cannot be confidently classified\r
+- The request includes harmful, hateful, or otherwise inappropriate content for an organization to engage with\r
+- The message is conversational and does not introduce a new task\r
+\r
+# User Query\r
+{query}`;
+export {
+  e as default
+};