@esri/solutions-components 5.1.0-next.16 → 5.1.0-next.161

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 { x as M, z as B, M as N, N as E, O as T, Q as y, B as J } from "./helpers.js";
-class _ {
-  /**
-   * 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 j(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 x(
-    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 x(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 {
-  _ as C,
-  j 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 { z as a } from "./helpers.js";
-function p(o, t) {
+import { g as a } from "./helpers.js";
+function g(o, t) {
   const n = [];
   return o.forEach((e) => {
     t.has(e.id) && n.push(e);
   }), n;
 }
-function y(o, t, n) {
+function p(o, t, n) {
   if (t < 1 || o.length < t)
     return {
       cards: [],
@@ -29,7 +29,7 @@ function y(o, t, n) {
     }
   };
 }
-function g(o, t) {
+function y(o, t) {
   const n = c(o);
   return d(n, t);
 }
@@ -96,13 +96,13 @@ function b(o, t) {
   return u(n.title);
 }
 export {
-  b as a,
-  g as b,
-  u as c,
-  p as d,
-  y as e,
-  I as f,
-  m as g,
+  I as a,
+  m as b,
+  g as c,
+  u as d,
+  p as e,
+  b as f,
+  y as g,
   h,
   w as s
 };

package/dist/chunks/classifyIntent.js

@@ -0,0 +1,101 @@
+/* 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
+# 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) Context-Aware Builder\r
+2) Active Design\r
+3) General ArcGIS Help\r
+4) Uncertainty\r
+\r
+## Context-Aware Builder\r
+If the user has expressed intent to build, create, or design a solution, treat the conversation as a solution design interaction. References to “my solution” or “a solution” do NOT qualify as build intent.\r
+\r
+In this interaction:\r
+- The assistant and user are collaboratively defining the solution to build through the conversation.\r
+- When the assistant asks for details (such as workflow or use case), the user’s response MUST be treated as contributing to the solution design.\r
+- Any response that provides a workflow, goal, or activity MUST be interpreted as valid design input, regardless of level of detail.\r
+\r
+Important:\r
+- You MUST NOT evaluate whether the user’s input is “detailed enough” or “complete enough” to begin design.\r
+- High-level or simple goals are still valid requirements and MUST be routed to the \`builder\`.\r
+\r
+Tool selection:\r
+- Select \`builder\` whenever the user is continuing a solution-building interaction by providing additional information, goals, workflows, or requirements.\r
+- Do not select \`explorer\` for inputs that continue the design conversation, even if they could match common ArcGIS Solutions workflows.\r
+- Only select \`explorer\` if the user explicitly asks to explore or evaluate existing solutions.\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
+- builder\r
+- explorer\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 to create, build, or design a solution\r
+- Asks to update, modify, or refine a custom solution:\r
+  - Updating solution metadata (title, description, tags)\r
+  - Adding, updating, or removing layers, fields, or domains\r
+\r
+You MUST select \`builder\` including when it includes for harmful or unsafe content and regardless of domain relevance or realism.\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
+- Asks how to build a solution or what kinds of solutions they can build\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 for details about a solution or how to use, modify, configure or extend it\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 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 instructing the assistant to deploy a solution\r
+- The request is instructing the assistant to provide or create data for 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 message is conversational and does not introduce a new task\r
+\r
+# User Query\r
+{query}`;
+export {
+  e as default
+};