@esri/solutions-components 5.1.0-next.99 → 5.1.0

package/dist/chunks/cardFetchingUtils.js

@@ -1,322 +1,40 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import { s as O, d as D, e as g, b as I } from "./cardsHelpers.js";
-import * as l from "@esri/solution-common";
-import { g as T, b as B, i as M, j as E, k as N, l as k } from "./helpers.js";
+import "@esri/solution-common";
+import { g as p } from "./cardsHelpers.js";
 import { B as y } from "./interfaces.js";
-class z {
-  /**
-   * 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 = T(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 = O(
-      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 = "", b = !1;
-          v = this.agolPortalUrl, b = !0, A.results.forEach((R) => {
-            R.sourcePortalUrl = v, R.knownToBePublicSource = b;
-          }), 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 = O(
-        this.getCardsFromResponse(this.mergeResponses(d)),
-        this.cardCacheParams.sortField,
-        this.cardCacheParams.sortOrder
-      );
-      let U;
-      if (o && o.size > 0) {
-        const m = D(this.cardCache, o);
-        U = g(m, C, f);
-      } else
-        U = g(this.cardCache, C, f);
-      return Promise.resolve(U);
-    }).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 = O(
-      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` + k([{ k: "id", v: e.id }]) || "",
-          thumbnailFilename: e.thumbnail,
-          thumbnailUrl: N(
-            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: M(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 V(h, r, t, s, e = y, i = "created", c = "desc", a = !1, o = [], C = [], f, p, u) {
-  if (!h?.IsSignedIn)
+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 += J(h, p), await j(
-    r,
-    P,
-    s,
-    C,
+  return d.q += S(e, f), await m(
+    n,
+    d,
+    o,
     u,
-    f
+    g,
+    c
   );
 }
-function J(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 j(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 {
-  z as C,
-  V 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 { b 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,88 @@
+/* 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.\r
+\r
+# Your Task\r
+- Analyze the User Query and chat history\r
+- Select one tool based on the user’s intent using the conversation context\r
+- Return a confidence score (0.00–1.00) and a brief rationale (≤140 characters)\r
+\r
+# Active Solution Design\r
+activeSolutionDesign: {activeSolutionDesign}\r
+\r
+The activeSolutionDesign flag indicates whether a solution is currently being designed in the conversation.\r
+When true, it reflects an ongoing solution-building interaction between the assistant and the user.\r
+\r
+## If activeSolutionDesign = true\r
+Treat the conversation as part of an ongoing solution build.\r
+- Interpret the user’s message as continuing the current solution unless there is clear intent to switch tasks\r
+- Select builder for follow-ups, clarifications, additions, or questions related to their custom solution\r
+\r
+## If activeSolutionDesign = false\r
+If the user has expressed intent to build, create, or design a solution, treat the conversation as a solution design interaction.\r
+\r
+In this interaction:\r
+- The assistant and user are collaboratively defining the solution through the conversation\r
+- Treat user responses as contributing to the solution when they provide workflows, goals, or related information\r
+- Do not reject input due to lack of detail; high-level or partial input is valid\r
+\r
+Tool selection:\r
+- Select \`builder\` when the user is continuing this design interaction\r
+- Only select \`explorer\` if the user clearly shifts to exploring existing solutions\r
+\r
+# Last Tool\r
+lastTool: {lastTool}\r
+\r
+The lastTool represents the tool most recently used by the assistant to respond in the conversation. \r
+It reflects the current interaction context and should guide tool selection for follow-up messages.\r
+\r
+If the user’s message appears to respond to the assistant’s previous message:\r
+  - Treat it as a continuation of the same interaction\r
+  - Select the lastTool unless there is clear intent to switch tasks\r
+  - Use the lastTool to maintain consistency in the interaction rather than reclassifying intent from scratch\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
+# Tool Definitions\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 or item metadata (title, description, tags)\r
+  - Adding, updating, or removing items, layers, fields, or domains\r
+\r
+Select \`builder\` regardless of domain relevance or realism or if it includes harmful or unsafe content when explicit build or modification intent is present.\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
+};