@arcgis/portal-components 5.1.0-next.99 → 5.1.0

package/dist/components/arcgis-portal-ai-assistant/customElement.js

@@ -1,59 +1,61 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import { c as $ } from "../../chunks/runtime.js";
-import { css as z, html as b } from "lit";
-import { LitElement as M } from "@arcgis/lumina";
-import { createRef as d, ref as p } from "lit/directives/ref.js";
-import { u as T } from "../../chunks/useT9n.js";
-import { Annotation as h, StateGraph as U, START as q, END as f } from "@langchain/langgraph/web";
-import { sendTraceMessage as y, invokeStructuredPrompt as x, sendUXSuggestion as P, createAgentRuntimeStateWithSharedState as k } from "@arcgis/ai-orchestrator";
+import { c as Z } from "../../chunks/runtime.js";
+import { LitElement as tt, createEvent as et } from "@arcgis/lumina";
+import { css as st, render as at, html as w } from "lit";
+import { createRef as M, ref as T } from "lit/directives/ref.js";
+import { u as rt } from "../../chunks/useT9n.js";
+import { a as P, t as ot } from "../../chunks/functionalities.js";
+import { Annotation as h, StateGraph as $, START as G, END as y, NodeInterrupt as V } from "@langchain/langgraph/web";
+import { sendTraceMessage as g, invokeStructuredPrompt as b, createChatModel as F, sendUXSuggestion as B, createAgentRuntimeStateWithSharedState as E } from "@arcgis/ai-components/utils/index.js";
 import n from "zod";
-import { g as V } from "../../chunks/item.js";
-const v = "portalItemAnalyticsSummaryMemory", D = () => ({ latestItemId: null, memory: {} }), w = (e) => {
-  const t = e?.[v]?.value;
-  if (!t || typeof t != "object")
-    return D();
-  const s = t, o = typeof s.latestItemId == "string" ? s.latestItemId : null, i = s.memory && typeof s.memory == "object" ? s.memory : {};
-  return { latestItemId: o, memory: i };
-}, N = (e) => ({
-  [v]: { value: e }
-}), L = n.object({
-  intent: n.enum(["summarize", "followUp", "clarify"]),
-  itemId: n.string().default(""),
-  question: n.string().default("")
-}), R = n.object({ summary: n.string(), followUpQuestions: n.array(n.string()).default([]) }), F = n.object({ answer: n.string(), isRelevant: n.boolean() }), S = (e) => {
-  for (let t = e.length - 1; t >= 0; t -= 1) {
-    const s = e[t];
-    if (s.type !== "human")
+import { ChatPromptTemplate as L } from "@langchain/core/prompts";
+import { createAgent as Q } from "langchain";
+import { tool as K } from "@langchain/core/tools";
+import { s as nt, g as it, a as lt, c as ct, q as ut } from "../../chunks/groups.js";
+import mt from "@arcgis/core/identity/IdentityManager.js";
+import k from "@arcgis/core/request.js";
+import { Annotation as dt } from "@langchain/langgraph";
+const x = (s) => {
+  for (let t = s.length - 1; t >= 0; t -= 1) {
+    const e = s[t];
+    if (e.type !== "human")
       continue;
-    const o = s.content;
-    if (typeof o == "string")
-      return o;
-    if (Array.isArray(o))
-      return o.map(
-        (i) => typeof i == "string" ? i : "text" in i && typeof i.text == "string" ? i.text : ""
+    const a = e.content;
+    if (typeof a == "string")
+      return a;
+    if (Array.isArray(a))
+      return a.map(
+        (r) => typeof r == "string" ? r : "text" in r && typeof r.text == "string" ? r.text : ""
       ).join(" ").trim();
   }
   return "";
-}, j = async (e, t) => {
-  await y({ text: "Answering follow-up...", agentName: "analytics" }, t);
-  const s = w(e.agentExecutionContext.sharedState), o = e.analyticsItemId ?? s.latestItemId, i = o ? s.memory[o] : void 0, r = e.analyticsQuestion || S(e.agentExecutionContext.messages);
-  return i ? {
+}, pt = () => ({ latestItemId: null, memory: {} }), N = (s) => {
+  const t = s?.agentExecutionContext.sharedState.portalItemAnalyticsSummaryMemory?.value;
+  return t ? { latestItemId: t.latestItemId, memory: t.memory } : pt();
+}, gt = n.object({
+  intent: n.enum(["summarize", "followUp", "clarify"]),
+  itemId: n.string().default(""),
+  question: n.string().default("")
+}), ht = n.object({ summary: n.string(), followUpQuestions: n.array(n.string()).default([]) }), ft = n.object({ answer: n.string(), isRelevant: n.boolean() }), yt = async (s, t) => {
+  await g({ text: "Answering follow-up...", agentName: "analytics" }, t);
+  const e = N(s), a = s.analyticsItemId ?? e.latestItemId, r = a ? e.memory[a] : void 0, l = s.analyticsQuestion || x(s.agentExecutionContext.messages);
+  return r ? {
     status: "success",
-    outputMessage: (await x({
-      promptText: G,
-      schema: F,
+    outputMessage: (await b({
+      promptText: bt,
+      schema: ft,
       modelTier: "default",
       inputVariables: {
-        summary: i.summary,
-        question: r,
-        fullContext: JSON.stringify(i.fullContext)
+        summary: r.summary,
+        question: l,
+        fullContext: JSON.stringify(r.fullContext)
       }
     })).answer
   } : {
     status: "success",
     outputMessage: "I don't have enough information yet. Please ask me to summarize the item first using summarize item <item id>."
   };
-}, G = `
+}, bt = `
 You answer follow-up questions about an ArcGIS item.
 
 Ground your answer in the provided item context.
@@ -73,39 +75,69 @@ Item full context
 
 Question:
 {question}
-`, Q = async (e, t) => {
-  await y({ text: "Analyzing intent...", agentName: "analytics" }, t);
-  const s = S(e.agentExecutionContext.messages), o = !!w(e.agentExecutionContext.sharedState).latestItemId, i = await x({
-    promptText: K,
-    schema: L,
-    inputVariables: {
-      userMessage: s,
-      hasSummaryContext: String(o)
-    }
-  }), { intent: r, itemId: l, question: u } = i, c = r === "clarify" || r === "summarize" && !l || r === "followUp" && !u;
+`;
+function I(s) {
+  const { portal: t, user: e } = s ?? {};
+  if (!s || !t || !e)
+    throw new Error("Invalid context: PortalAssistantContext with portal and user is required.");
+}
+const W = K(
+  async ({ itemTitle: s }, t) => {
+    const e = s.trim();
+    if (!e)
+      return null;
+    const a = t?.configurable?.context;
+    I(a);
+    const { result: r, error: l } = await nt(a.portal, e, { num: 1 });
+    return l && console.error("Error searching for portal item by title:", l), r?.results[0]?.id || null;
+  },
+  {
+    name: "resolvePortalItemIdByTitle",
+    description: 'Resolves an ArcGIS Portal item title to the best-match item id. Use this when a user references an item by title (including hash mentions like #title or #"title with spaces") instead of an explicit item id.',
+    schema: n.object({
+      itemTitle: n.string().describe("The portal item title to resolve to an item id.")
+    })
+  }
+), It = async (s, t) => {
+  await g({ text: "Analyzing intent...", agentName: "analytics" }, t);
+  const e = x(s.agentExecutionContext.messages), a = !!N(s).latestItemId, r = await L.fromTemplate(wt).format({
+    userMessage: e,
+    hasSummaryContext: String(a)
+  }), c = await Q({
+    model: await F({ modelTier: "fast" }),
+    tools: [W],
+    systemPrompt: r,
+    responseFormat: gt,
+    checkpointer: !0
+  }).invoke({ messages: s.agentExecutionContext.messages }, t), { intent: i, itemId: o, question: u } = c.structuredResponse, m = i === "clarify" || i === "summarize" && !o || i === "followUp" && !u;
   return {
-    agentExecutionContext: { ...e.agentExecutionContext },
-    analyticsIntent: c ? "clarify" : r,
-    analyticsItemId: l || null,
+    agentExecutionContext: { ...s.agentExecutionContext },
+    analyticsIntent: m ? "clarify" : i,
+    analyticsItemId: o || null,
     analyticsQuestion: u || "",
     status: "success",
-    outputMessage: c ? "Please clarify with summarize item <item id> or ask a follow-up question about a summarized item." : ""
+    outputMessage: m ? 'Please clarify with summarize item <item id>, summarize item #<title>, or summarize item #"<title with spaces>".' : ""
   };
-}, K = `
+}, wt = `
 Classify the user analytics request.
 
 Rules:
 - intent="summarize" only when the user explicitly asks to summarize/overview/recap an item.
 - intent="followUp" for analytical questions about item details, including schema/fields/attributes/layers.
 - intent="clarify" when neither summarize nor follow-up intent is clear.
-- Extract itemId only when explicit in the request.
+- itemId must be the final resolved item id.
+- If request has explicit item id, set itemId directly.
+- If request references item title (for example #title, #"title with spaces", or plain quoted title), call resolvePortalItemIdByTitle and set itemId to the returned value.
+- Never return item titles in output fields.
 - If intent is "followUp", set question to the user's full question/request text.
 - If intent is "summarize", set question="".
 - When user asks to show/list/explain fields, schema, attributes, columns, or layer details, classify as "followUp" unless they explicitly request a summary.
 - If hasSummaryContext is true, prefer "followUp" for detail-oriented requests that do not explicitly ask to summarize.
 
 Examples:
-- "Summarize item 0123456789abcdef0123456789abcdef" => summarize
+- "Summarize item 0123456789abcdef0123456789abcdef" => summarize, itemId="0123456789abcdef0123456789abcdef"
+- "Summarize item #california" => summarize, call resolvePortalItemIdByTitle("california") and set itemId to tool result
+- "Summarize item #"california farmland"" => summarize, call resolvePortalItemIdByTitle("california farmland") and set itemId to tool result
 - "Show the layer's available fields" => followUp
 - "List attributes and explain what status means" => followUp
 - "What fields are available?" with hasSummaryContext=true => followUp
@@ -116,46 +148,40 @@ hasSummaryContext:
 
 User message:
 {userMessage}
-`;
-function W(e) {
-  const { portal: t, user: s } = e ?? {};
-  if (!e || !t || !s)
-    throw new Error("Invalid context: PortalAssistantContext with portal and user is required.");
-}
-const Y = async (e, t) => {
-  const s = e.analyticsItemId;
-  if (!s)
+`, xt = async (s, t) => {
+  const e = s.analyticsItemId;
+  if (!e)
     return {
       status: "success",
-      outputMessage: "Please clarify with summarize item <item id>."
+      outputMessage: 'Please clarify with summarize item <item id>, summarize item #<title>, or summarize item #"<title with spaces>".'
     };
-  await y({ text: `Summarizing item ${s}...`, agentName: "analytics" }, t);
-  const o = t?.configurable?.context;
-  W(o);
-  const { portal: i, user: r } = o, { result: l, error: u } = await V(r, i, s);
-  if (u || !l)
-    return await y({ text: "Failed to get item context for summarization", agentName: "analytics" }, t), {
+  await g({ text: `Summarizing item ${e}...`, agentName: "analytics" }, t);
+  const a = t?.configurable?.context;
+  I(a);
+  const { portal: r, user: l } = a, { result: c, error: i } = await it(l, r, e);
+  if (i || !c)
+    return await g({ text: "Failed to get item context for summarization", agentName: "analytics" }, t), {
       status: "success",
       outputMessage: "Unable to retrieve item context for summarization."
     };
-  const { context: a } = l, m = await x({
-    promptText: J,
-    schema: R,
+  const { context: o } = c, u = await b({
+    promptText: vt,
+    schema: ht,
     modelTier: "default",
-    inputVariables: { context: JSON.stringify(a) }
-  }), { followUpQuestions: c, summary: I } = m, C = w(e.agentExecutionContext.sharedState), E = {
-    latestItemId: s,
+    inputVariables: { context: JSON.stringify(o) }
+  }), { followUpQuestions: d, summary: p } = u, m = N(s), f = {
+    latestItemId: e,
     memory: {
-      ...C.memory,
-      [s]: { summary: I, followUpQuestions: c, fullContext: a }
+      ...m.memory,
+      [e]: { summary: p, followUpQuestions: d, fullContext: o }
     }
   };
-  return c.length && await P({ type: "suggested-prompts", data: { prompts: c } }, t), {
+  return d.length && await B({ type: "suggested-prompts", data: { prompts: d } }, t), {
     status: "success",
-    outputMessage: I,
-    sharedStatePatch: N(E)
+    outputMessage: p,
+    sharedStatePatch: { portalItemAnalyticsSummaryMemory: { value: f } }
   };
-}, J = `
+}, vt = `
 You are a item summary tool for ArcGIS. Your job is to summarize an item's info based on the provided context.
 Summary rules:
 - The summary should be concise markdown, make sure to format the output nicely so it's easy to read.
@@ -170,71 +196,659 @@ Do not include internal identifiers.
 If the user asks for a detailed summary, you may expand the response up to 300 words.
 Item context:
 {context}
-`, g = (e, t) => t ?? e, A = h.Root({
-  ...k(),
-  // States shared across nodes in the graph
+`, C = (s, t) => t ?? s, O = h.Root({
+  ...E(),
+  // States shared only across nodes in the graph, not between invocations
   analyticsIntent: h({
-    reducer: g,
+    reducer: C,
     default: () => "clarify"
   }),
   analyticsItemId: h({
-    reducer: g,
+    reducer: C,
     default: () => null
   }),
   analyticsQuestion: h({
-    reducer: g,
+    reducer: C,
     default: () => ""
   })
-}), O = () => new U(A).addNode("detectAnalyticsIntent", Q).addNode("summarizePortalItem", Y).addNode("answerAnalyticsFollowUp", j).addEdge(q, "detectAnalyticsIntent").addConditionalEdges("detectAnalyticsIntent", (t) => t.analyticsIntent === "summarize" ? "summarizePortalItem" : t.analyticsIntent === "followUp" ? "answerAnalyticsFollowUp" : f).addEdge("summarizePortalItem", f).addEdge("answerAnalyticsFollowUp", f), B = String.raw`- **portal-item-analytics** - Portal item analytics assistant:
+}), St = () => new $(O).addNode("detectAnalyticsIntent", It).addNode("summarizePortalItem", xt).addNode("answerAnalyticsFollowUp", yt).addEdge(G, "detectAnalyticsIntent").addConditionalEdges("detectAnalyticsIntent", (t) => t.analyticsIntent === "summarize" ? "summarizePortalItem" : t.analyticsIntent === "followUp" ? "answerAnalyticsFollowUp" : y).addEdge("summarizePortalItem", y).addEdge("answerAnalyticsFollowUp", y), Mt = String.raw`- **portal-item-analytics** - Portal item analytics assistant:
   - summarizes ArcGIS portal items from item context
   - suggests follow-up prompts grounded in the item
-`, X = {
+`, Tt = {
   id: "portal-item-analytics",
   name: "Portal Item Analytics",
-  description: B,
-  createGraph: O,
-  workspace: A
-}, H = z`:host{height:100%;border-width:1px;border-style:solid;border-color:var(--calcite-color-border-3);display:block;width:100%;--tw-shadow: 0 1px 6px -1px rgba(0, 0, 0, .16), 0 1px 2px -1px rgba(0, 0, 0, .08);--tw-shadow-colored: 0 1px 6px -1px var(--tw-shadow-color), 0 1px 2px -1px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.chat-entry{display:flex;flex-direction:column;gap:.75rem;width:100%}.chat-actions{display:flex;justify-content:flex-end;gap:.5rem}.header-actions{display:flex;gap:.5rem;padding-inline-start:.75rem}`;
-class Z extends M {
+  description: Mt,
+  createGraph: St,
+  workspace: O
+}, Pt = (s) => s.map((t) => `"${t}"`).join(", "), At = n.object({
+  successMessage: n.string().default("")
+}), q = "portal-group-creation", D = "approveAddMembers", Ct = async (s, t) => {
+  if (s.intentParams.intent !== "addMembers")
+    return {
+      status: "success",
+      outputMessage: "Use @mention usernames for the members you want to add."
+    };
+  const e = s.agentExecutionContext.sharedState.createdGroupId?.value;
+  if (!e)
+    return {
+      status: "success",
+      outputMessage: "Create a group first, then add members using @mention usernames."
+    };
+  const a = s.intentParams.memberInfo.memberIdentifiers.map((m) => m.trim()).filter(Boolean);
+  if (!a.length)
+    return {
+      status: "success",
+      outputMessage: "Use @mention usernames for the members you want to add."
+    };
+  const l = `The following member(s) will be added to the newly created group:
+
+${a.map((m) => `- **@${m}**`).join(`
+`)}
+
+Do you want to continue?`, { hitlResponse: c } = t?.configurable ?? {};
+  if (c?.agentId !== q || c.id !== D) {
+    const m = {
+      agentId: q,
+      id: D,
+      kind: "booleanChoice",
+      message: l,
+      metadata: {
+        action: "addMembers",
+        groupId: e,
+        members: [...a]
+      }
+    };
+    throw new V(m);
+  }
+  if (c.payload !== !0)
+    return {
+      status: "success",
+      outputMessage: "Okay, I cancelled adding members to the group."
+    };
+  await g(
+    { text: `Adding members ${Pt(a)}...`, agentName: "group-creation" },
+    t
+  );
+  const i = t?.configurable?.context;
+  I(i);
+  const { result: o, error: u } = await lt(i.portal, e, a);
+  if (u || !o)
+    return {
+      status: "success",
+      outputMessage: "I could not add members to that group. Please confirm group access and user accounts, then try again."
+    };
+  const { addedUsernames: d, notAddedUsers: p } = o;
+  try {
+    const f = (await b({
+      promptText: $t,
+      schema: At,
+      modelTier: "fast",
+      inputVariables: {
+        addedMembers: d.join(", "),
+        notAddedMembers: JSON.stringify(
+          p.map((v) => ({ username: v.username, reason: v.error.message }))
+        )
+      }
+    })).successMessage;
+    if (f)
+      return { status: "success", outputMessage: f };
+  } catch (m) {
+    console.error("Error generating add-members success message:", m);
+  }
+  return {};
+}, $t = `
+Write a concise, friendly success message for adding members to a group.
+
+Rules:
+- Keep it to 1-2 short sentences.
+- Use plain text only.
+- If there is no notAddedMembers, confirm that all requested members were added successfully.
+- If there are notAddedMembers, acknowledge that some members could not be added and list the added and not added members separately then mention why based on the context
+- Make sure to bold the usernames
+
+Added members:
+{addedMembers}
+
+Not added members:
+{notAddedMembers}
+`, R = "portal-group-creation", U = "approveCreateGroup", Gt = n.object({
+  successMessage: n.string().default("")
+}), Et = n.object({
+  failureMessage: n.string().default("")
+}), Nt = async (s, t) => {
+  if (s.intentParams.intent !== "create")
+    return {
+      status: "success",
+      outputMessage: "Tell me the group title you want to use."
+    };
+  const e = s.intentParams.title.trim();
+  if (!e)
+    return {
+      status: "success",
+      outputMessage: "What title would you like for the new group?"
+    };
+  const a = `A group with the title **${e}** will be created. Do you want to continue?`, { hitlResponse: r } = t?.configurable;
+  if (r?.agentId !== R || r.id !== U) {
+    const u = {
+      agentId: R,
+      id: U,
+      kind: "booleanChoice",
+      message: a,
+      metadata: {
+        action: "createGroup",
+        title: e,
+        access: "private"
+      }
+    };
+    throw new V(u);
+  }
+  if (r.payload !== !0)
+    return {
+      status: "success",
+      outputMessage: `Okay, I cancelled creating **${e}**.`
+    };
+  await g({ text: `Creating group "${e}"...`, agentName: "group-creation" }, t);
+  const l = t?.configurable?.context;
+  I(l);
+  const { result: c, error: i } = await ct(l.portal, {
+    title: e,
+    access: "private"
+  });
+  if (i || !c) {
+    const u = i?.message?.trim() || "No additional details were provided.";
+    try {
+      const p = (await b({
+        promptText: qt,
+        schema: Et,
+        modelTier: "fast",
+        inputVariables: {
+          groupTitle: e,
+          failureReason: u
+        }
+      })).failureMessage.trim();
+      if (p)
+        return {
+          status: "success",
+          outputMessage: p
+        };
+    } catch (d) {
+      console.error("Error generating create-group failure message:", d);
+    }
+    return {
+      status: "success",
+      outputMessage: "I could not create that group. Please confirm your permissions and try again with the group title."
+    };
+  }
+  const o = c.id;
+  try {
+    const d = (await b({
+      promptText: kt,
+      schema: Gt,
+      modelTier: "fast",
+      inputVariables: {
+        groupTitle: e
+      }
+    })).successMessage.trim();
+    if (d)
+      return {
+        status: "success",
+        outputMessage: d,
+        sharedStatePatch: { createdGroupId: { value: o } },
+        createdGroupId: o
+      };
+  } catch (u) {
+    console.error("Error generating create-group success message:", u);
+  }
+  return {};
+}, kt = `
+Write a concise, friendly success message after creating a portal group.
+
+Rules:
+- Mention that the group was created successfully.
+- Mention that the user can add members by using @mention usernames.
+- Keep it to 1-2 short sentences.
+- Make sure to bold the group title in the message.
+
+Group title:
+{groupTitle}
+`, qt = `
+Write a concise, friendly failure message after an attempt to create a portal group.
+
+Rules:
+- Keep it to 1-2 short sentences.
+- Use plain text only.
+- Mention that group creation failed.
+- Include the failure reason in user-friendly language.
+- End with a clear next step the user can try.
+
+Group title:
+{groupTitle}
+
+Failure reason:
+{failureReason}
+`, Dt = n.object({
+  intent: n.enum(["clarify", "create", "addMembers"]).default("clarify"),
+  title: n.string().default(""),
+  memberIdentifiers: n.array(n.string()).default([]),
+  clarifyMessage: n.string().default("")
+}), Rt = async (s, t) => {
+  await g({ text: "Thinking about groups...", agentName: "group-creation" }, t);
+  const e = x(s.agentExecutionContext.messages).trim(), a = await b({
+    promptText: Ut,
+    schema: Dt,
+    modelTier: "default",
+    inputVariables: { userMessage: e }
+  }), r = a.title.trim(), l = a.memberIdentifiers.filter(Boolean), c = a.clarifyMessage.trim(), i = a.intent === "create" && !!r, o = a.intent === "addMembers" && l.length > 0;
+  return {
+    intentParams: i ? { intent: "create", title: r } : o ? { intent: "addMembers", memberInfo: { memberIdentifiers: l } } : { intent: "clarify" },
+    status: "success",
+    outputMessage: !i && !o ? c : ""
+  };
+}, Ut = `
+You classify whether a user is asking to create a new ArcGIS Portal group or add members to an existing group.
+
+Rules:
+- Set intent="create" when the user asks to create a group and a title can be identified.
+- Set intent="addMembers" when the user asks to add one or more members to a group.
+- Set intent="clarify" when required data is missing or the request is ambiguous.
+- For create requests, extract title only.
+- For add-members requests, extract memberIdentifiers as ArcGIS usernames only (no @ prefix), but if you're returning a hint text asking for missing members, include the @ prefix.
+- If the user includes mentions like @jsmith, return "jsmith" in memberIdentifiers.
+- Do not extract group ids or group titles; add-members is a follow-up action that targets the most recently created group.
+- When intent="clarify", provide a concise clarifyMessage describing exactly what is missing.
+- If the user gives the title in quotes, extract exactly that title.
+- If the user says create group <title> without quotes, extract only the title text after the create-group wording.
+- If the user message looks like only a potential title (short phrase, not a question), treat it as the title and set intent="create".
+- Return only extracted values. Do not add helper text into title or memberIdentifiers.
+- Make sure to match the user's tone and texting style
+
+Examples:
+- help me create a new group "<title>" => intent="create", title="<title>", memberIdentifiers=[]
+- add @<username1> and @<username2> => intent="addMembers", memberIdentifiers=["<username1>","<username2>"]
+- add <member> => intent="addMembers", memberIdentifiers=["<member>"]
+- help me create a new group => intent="clarify" with a question for missing title
+
+User message:
+{userMessage}
+`, zt = n.discriminatedUnion("destinationType", [
+  n.object({
+    destinationType: n.literal("portal-content")
+  }),
+  n.object({
+    destinationType: n.literal("portal-groups")
+  }),
+  n.object({
+    destinationType: n.literal("portal-item"),
+    itemId: n.string().trim().min(1)
+  }),
+  n.object({
+    destinationType: n.literal("portal-group"),
+    groupId: n.string().trim().min(1)
+  })
+]);
+function jt(s) {
+  const t = zt.safeParse(s);
+  return t.success ? t.data : void 0;
+}
+const _ = "portal-navigation", J = async (s, t) => {
+  await B({ type: _, data: { ...s } }, t);
+}, Vt = async (s, t) => {
+  const e = s.createdGroupId ?? s.agentExecutionContext.sharedState.createdGroupId?.value;
+  return e ? (await g({ text: "Preparing navigation...", agentName: "group-creation" }, t), await J({ destinationType: "portal-group", groupId: e }, t), {}) : {};
+}, z = (s, t) => t ?? s, Y = h.Root({
+  ...E(),
+  // * Shared state between nodes (but not persisted to the agent execution context)
+  /** Parameters related to the user's intent for group creation actions */
+  intentParams: h({ reducer: z, default: () => ({ intent: "clarify" }) }),
+  /** The ID of the group that was created
+   * even though we already have this in the shared state
+   * we still need it here to also share between nodes
+   */
+  createdGroupId: h({ reducer: z, default: () => "" })
+}), Ft = () => new $(Y).addNode("detectGroupCreationIntent", Rt).addNode("createPortalGroup", Nt).addNode("addMembersToPortalGroup", Ct).addNode("suggestCreatedGroupNavigation", Vt).addEdge(G, "detectGroupCreationIntent").addConditionalEdges("detectGroupCreationIntent", (t) => {
+  switch (t.intentParams.intent) {
+    case "create":
+      return "createPortalGroup";
+    case "addMembers":
+      return "addMembersToPortalGroup";
+    default:
+      return y;
+  }
+}).addEdge("createPortalGroup", "suggestCreatedGroupNavigation").addEdge("addMembersToPortalGroup", "suggestCreatedGroupNavigation").addEdge("suggestCreatedGroupNavigation", y), Bt = String.raw`- **portal-group-creation** - Portal group creation assistant:
+  - creates a new ArcGIS Portal group for the signed-in user
+  - adds users to the newly created group using @mention usernames
+`, Lt = {
+  id: "portal-group-creation",
+  name: "Portal Group Creation",
+  description: Bt,
+  createGraph: Ft,
+  workspace: Y
+}, H = "portalDocAssistantMemory", Qt = () => ({ conversationId: "" }), Kt = (s) => {
+  const t = s?.[H]?.value;
+  if (!t || typeof t != "object")
+    return Qt();
+  const e = t;
+  return {
+    conversationId: typeof e.conversationId == "string" ? e.conversationId : ""
+  };
+}, Wt = (s) => ({
+  [H]: { value: s }
+});
+async function Ot({
+  portal: s,
+  question: t,
+  persona: e,
+  previousConversationId: a,
+  signal: r,
+  skillId: l
+}) {
+  l ??= "doc_ai_assistant";
+  const i = await _t({
+    portal: s,
+    skillId: l,
+    message: t,
+    options: { context: {
+      kind: "DocAIAssistantRequest",
+      filters: { persona: { persona: e } }
+    }, previousConversationId: a, signal: r }
+  });
+  return {
+    reply: Jt(i, l),
+    conversationId: i[0]?.conversationId ?? ""
+  };
+}
+async function _t({
+  portal: s,
+  skillId: t,
+  message: e,
+  options: a
+}) {
+  const l = `${s.helperServices.aiAssistantServices.url}/skills/${t}/chat`, c = {
+    "Content-Type": "application/json",
+    token: mt.findCredential(s.url)?.token ?? ""
+  }, i = await k(l, {
+    method: "post",
+    body: JSON.stringify({
+      message: e,
+      context: a.context,
+      conversationId: a.previousConversationId
+    }),
+    headers: c,
+    signal: a.signal
+  });
+  if (i.httpStatus !== 200)
+    throw new Error(`Doc assistant chat failed (${i.httpStatus})`, {
+      cause: i.data
+    });
+  const o = i.data, u = [o], { conversationId: d, inquiryId: p } = o, m = async (f, v) => {
+    if (!v)
+      return;
+    await ot(1e3);
+    const S = await k(l, {
+      method: "post",
+      body: JSON.stringify({ conversationId: d, inquiryId: p, ackSequenceNumber: f }),
+      headers: c,
+      signal: a.signal
+    });
+    if (S.httpStatus !== 200)
+      throw new Error(`Doc assistant poll failed (${S.httpStatus})`, {
+        cause: S.data
+      });
+    const A = S.data;
+    u.push(A), await m(A.sequenceNumber, A.hasMore);
+  };
+  return o.hasMore && await m(o.sequenceNumber, o.hasMore), u;
+}
+function Jt(s, t) {
+  switch (t) {
+    case "doc_chat":
+      return s.find((e) => e.message != null)?.message ?? "";
+    case "doc_ai_assistant":
+      for (let e = s.length - 1; e >= 0; e -= 1) {
+        const a = s[e];
+        if (a.context?.kind === "DocAIAssistantContext") {
+          const r = a.context.results?.[0]?.reply;
+          if (r)
+            return r;
+        }
+      }
+      return "";
+    default:
+      return P(t);
+  }
+}
+const Yt = async (s, t) => {
+  await g({ text: "Asking documentation assistant...", agentName: "doc-assistant" }, t);
+  const e = x(s.agentExecutionContext.messages).trim();
+  if (!e)
+    return {
+      status: "success",
+      outputMessage: "Please share your question and I can help with ArcGIS and Portal documentation."
+    };
+  const a = t?.configurable?.context;
+  I(a);
+  const r = Kt(s.agentExecutionContext.sharedState), { reply: l, conversationId: c } = await Ot({
+    portal: a.portal,
+    question: e,
+    previousConversationId: r.conversationId || void 0,
+    skillId: "doc_ai_assistant",
+    persona: "developers"
+  });
+  return {
+    status: "success",
+    outputMessage: l.trim() || "I could not retrieve a response from the documentation assistant.",
+    sharedStatePatch: Wt({
+      conversationId: c || r.conversationId
+    })
+  };
+}, Ht = K(
+  async ({ groupTitle: s }, t) => {
+    const e = s.trim();
+    if (!e)
+      return null;
+    const a = t?.configurable?.context;
+    I(a);
+    try {
+      return (await ut(a.portal, { query: `title:${e}`, num: 1 }))?.results[0]?.id || null;
+    } catch (r) {
+      return console.error("Error searching for portal group by title:", r), null;
+    }
+  },
+  {
+    name: "resolvePortalGroupIdByTitle",
+    description: "Resolves an ArcGIS Portal group title to the best-match group id. Use this when a user references a group by title instead of an explicit group id.",
+    schema: n.object({
+      groupTitle: n.string().describe("The portal group title to resolve to a group id.")
+    })
+  }
+), j = n.object({
+  shouldSuggestNavigation: n.boolean().default(!1),
+  destinationType: n.enum(["none", "portal-content", "portal-item", "portal-groups", "portal-group"]).default("none"),
+  itemId: n.string().default(""),
+  groupId: n.string().default("")
+}), Xt = async (s, t) => {
+  await g({ text: "Extracting navigation intent...", agentName: "doc-assistant" }, t);
+  const e = s.outputMessage.trim();
+  if (!e)
+    return {};
+  const a = x(s.agentExecutionContext.messages).trim(), r = await L.fromTemplate(te).format({
+    question: a,
+    response: e
+  }), c = await Q({
+    model: await F({ modelTier: "default" }),
+    tools: [W, Ht],
+    systemPrompt: r,
+    responseFormat: j,
+    checkpointer: !0
+  }).invoke({ messages: s.agentExecutionContext.messages }, t), i = j.parse(c.structuredResponse ?? {});
+  if (!i.shouldSuggestNavigation || i.destinationType === "none")
+    return {};
+  const o = Zt(i);
+  return o ? (await J(o, t), {}) : {};
+};
+function Zt({
+  destinationType: s,
+  itemId: t,
+  groupId: e
+}) {
+  switch (s) {
+    case "portal-content":
+      return { destinationType: "portal-content" };
+    case "portal-groups":
+      return { destinationType: "portal-groups" };
+    case "portal-item":
+      return t ? { destinationType: "portal-item", itemId: t } : null;
+    case "portal-group":
+      return e ? { destinationType: "portal-group", groupId: e } : null;
+    case "none":
+      return null;
+    default:
+      return P(s);
+  }
+}
+const te = `
+You decide whether the assistant response should include a navigation action to ArcGIS Portal.
+
+Given the user question and assistant response:
+- Decide if a navigation action would help the user complete the task.
+- If yes, choose one destination type:
+  - portal-content: portal content page
+  - portal-groups: groups listing page
+  - portal-item: specific item page (requires itemId)
+  - portal-group: specific group page (requires groupId)
+
+Rules:
+- If no navigation is useful, set shouldSuggestNavigation=false and destinationType=none.
+- If destinationType is portal-item and user references an item by title (for example #title, #"title with spaces", or plain quoted title), call resolvePortalItemIdByTitle and set itemId from the tool result.
+- If destinationType is portal-group and user references a group by title (for example $title, $"title with spaces", or plain quoted group title), call resolvePortalGroupIdByTitle and set groupId from the tool result.
+- Do not invent itemId.
+- Do not invent groupId.
+- Prefer destinationType=portal-content for generic "go to content" guidance.
+
+User question:
+{question}
+
+Assistant response:
+{response}
+`, X = dt.Root({
+  ...E()
+}), ee = () => new $(X).addNode("answerDocQuestion", Yt).addNode("extractNavigationIntent", Xt).addEdge(G, "answerDocQuestion").addEdge("answerDocQuestion", "extractNavigationIntent").addEdge("extractNavigationIntent", y), se = String.raw`- **portal-doc-assistant** - General ArcGIS documentation and Portal help assistant:
+  - answers general ArcGIS, Portal, Enterprise, and JavaScript SDK questions
+  - acts as a fallback when specialized agents are not applicable
+`, ae = {
+  id: "portal-doc-assistant",
+  name: "Portal Doc Assistant",
+  description: se,
+  createGraph: ee,
+  workspace: X
+}, re = st`:host{height:100%;border-width:1px;border-style:solid;border-color:var(--calcite-color-border-3);display:block;width:100%;--tw-shadow: 0 1px 6px -1px rgba(0, 0, 0, .16), 0 1px 2px -1px rgba(0, 0, 0, .08);--tw-shadow-colored: 0 1px 6px -1px var(--tw-shadow-color), 0 1px 2px -1px var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow, 0 0 #0000),var(--tw-ring-shadow, 0 0 #0000),var(--tw-shadow)}.chat-entry{display:flex;flex-direction:column;gap:.75rem;width:100%}.chat-actions{display:flex;justify-content:flex-end;gap:.5rem}.header-actions{display:flex;gap:.5rem;padding-inline-start:.75rem}.navigation-block{display:flex;flex-direction:column;align-items:stretch;gap:.35rem;margin-top:.5rem}.navigation-button{width:100%;margin-block:.25rem}.navigation-block-description{font-size:.75rem;color:var(--calcite-color-text-3)}`, oe = (s, t) => {
+  const { destinationType: e } = s, a = `${t.url}/home`;
+  switch (e) {
+    case "portal-content":
+      return `${a}/content.html`;
+    case "portal-groups":
+      return `${a}/groups.html`;
+    case "portal-item":
+      return `${a}/item.html?id=${s.itemId}`;
+    case "portal-group":
+      return `${a}/group.html?id=${s.groupId}`;
+    default:
+      return P(e);
+  }
+};
+class ne extends tt {
   constructor() {
-    super(...arguments), this.t9n = T({ blocking: !0 }), this.assistantEl = d(), this.formEl = d(), this.voiceInputEl = d(), this.inputEl = d(), this.inputText = "", this.showVoiceInput = !0, this.isListening = !1, this.isVoiceInputDisabled = !1, this.autoDestroyDisabled = !1, this.defaultClosed = !1, this.openEntitiesInNewTab = !1;
+    super(...arguments), this.t9n = rt({ blocking: !0 }), this.assistantEl = M(), this.formEl = M(), this.voiceInputEl = M(), this.inputEl = M(), this.navigationSlotElements = /* @__PURE__ */ new Map(), this.handleSlottableRequest = (t) => {
+      const e = t.detail, a = e.data?.block;
+      if (!a)
+        return;
+      const r = this.getNavigationAction(a);
+      r && this.upsertNavigationSlotElement(e.slotName, r);
+    }, this.inputText = "", this.showVoiceInput = !0, this.isListening = !1, this.isVoiceInputDisabled = !1, this.interrupt = null, this.autoDestroyDisabled = !1, this.defaultClosed = !1, this.arcgisPortalNavigationRequest = et();
   }
   static {
-    this.properties = { inputText: 16, showVoiceInput: 16, isListening: 16, isVoiceInputDisabled: 16, autoDestroyDisabled: 5, portal: 0, user: 0, config: 0, defaultClosed: 5, openEntitiesInNewTab: 5 };
+    this.properties = { inputText: 16, showVoiceInput: 16, isListening: 16, isVoiceInputDisabled: 16, interrupt: 16, autoDestroyDisabled: 5, portal: 0, user: 0, config: 0, defaultClosed: 5 };
   }
   static {
-    this.styles = H;
+    this.styles = re;
+  }
+  getNavigationAction(t) {
+    if (t?.type !== _)
+      return;
+    const e = jt(t.data);
+    if (!e)
+      return;
+    const a = oe(e, this.portal);
+    if (a)
+      return { href: a, targetDetail: e, label: this.getNavigationText(e.destinationType) };
+  }
+  upsertNavigationSlotElement(t, e) {
+    const a = this.assistantEl.value;
+    if (!a)
+      return;
+    let r = this.navigationSlotElements.get(t);
+    r || (r = document.createElement("div"), r.slot = t, this.navigationSlotElements.set(t, r), a.append(r)), at(w`<div><calcite-button class="navigation-button" appearance=outline width=full .href=${e.href} icon-end=launch @click=${(l) => {
+      l.preventDefault(), this.arcgisPortalNavigationRequest.emit({
+        href: e.href,
+        targetDetail: e.targetDetail
+      });
+    }}>${e.label}</calcite-button>${e.description ? w`<div class="navigation-block-description">${e.description}</div>` : null}</div>`, r);
+  }
+  getNavigationText(t) {
+    const e = this.t9n.navigation;
+    switch (t) {
+      case "portal-content":
+        return e.openContent;
+      case "portal-groups":
+        return e.openGroups;
+      case "portal-item":
+        return e.openItem;
+      case "portal-group":
+        return e.openGroup;
+      default:
+        return P(t);
+    }
   }
   render() {
-    const { t9n: t, inputText: s, portal: o, user: i, showVoiceInput: r, isListening: l, isVoiceInputDisabled: u } = this;
-    return b`<arcgis-assistant keep-suggested-prompts .heading=${t.heading} .entryMessage=${t.entryMessage} @arcgisPromptSelect=${({ detail: a }) => {
-      this.inputText = a.prompt, requestAnimationFrame(() => {
+    const { t9n: t, inputText: e, portal: a, user: r, showVoiceInput: l, isListening: c, isVoiceInputDisabled: i } = this;
+    return w`<arcgis-assistant log-enabled keep-suggested-prompts .heading=${t.heading} .entryMessage=${t.entryMessage} @arcgisSlottableRequest=${this.handleSlottableRequest} @arcgisInterrupt=${({ detail: o }) => {
+      this.interrupt = o;
+    }} @arcgisInterruptCancel=${() => {
+      this.interrupt = null;
+    }} @arcgisInterruptSubmit=${() => {
+      this.interrupt = null;
+    }} @arcgisPromptSelect=${({ detail: o }) => {
+      this.inputText = o.prompt, requestAnimationFrame(() => {
         this.inputEl.value?.focusTextArea();
       });
-    }} ${p(this.assistantEl)}><div slot=header-actions-start class="header-actions"><calcite-icon icon=effects></calcite-icon></div><form slot=chat-entry class="chat-entry" @submit=${(a) => {
-      a.preventDefault();
-      const m = s.trim();
-      m && (this.assistantEl.value?.submitMessage(m), this.inputText = "");
-    }} ${p(this.formEl)}><arcgis-portal-mentionable-text-area .portal=${o} .user=${i} rows=3 .popoverListLabel=${t.mentionEntities} .placeholder=${t.placeholder} .value=${s} @arcgisUserMentionableTextAreaKeyDown=${({ detail: a }) => {
-      a.key === "Enter" && !a.shiftKey && (a.preventDefault(), this.formEl.value?.requestSubmit());
-    }} @arcgisUserMentionableTextAreaChange=${({ detail: a }) => {
-      this.inputText = a ?? "";
-    }} ${p(this.inputEl)}></arcgis-portal-mentionable-text-area><div class="chat-actions"><arcgis-portal-voice-input @arcgisVoiceInputStart=${() => {
+    }} ${T(this.assistantEl)}><div slot=header-actions-start class="header-actions"><calcite-icon icon=effects></calcite-icon></div><form slot=chat-entry class="chat-entry" @submit=${(o) => {
+      o.preventDefault();
+      const u = e.trim();
+      u && (this.assistantEl.value?.submitMessage(u), this.inputText = "");
+    }} ${T(this.formEl)}><arcgis-portal-mentionable-text-area .portal=${a} .user=${r} rows=3 .popoverListLabel=${t.mentionEntities} .placeholder=${t.placeholder} .value=${e} @arcgisUserMentionableTextAreaKeyDown=${({ detail: o }) => {
+      o.key === "Enter" && !o.shiftKey && (o.preventDefault(), this.formEl.value?.requestSubmit());
+    }} @arcgisUserMentionableTextAreaChange=${({ detail: o }) => {
+      this.inputText = o ?? "";
+    }} ${T(this.inputEl)}></arcgis-portal-mentionable-text-area><div class="chat-actions"><arcgis-portal-voice-input @arcgisVoiceInputStart=${() => {
       this.isListening = !0, this.isVoiceInputDisabled = !1;
     }} @arcgisVoiceInputStop=${() => {
       this.isListening = !1, this.isVoiceInputDisabled = !1;
-    }} @arcgisVoiceInputError=${(a) => {
-      a.detail.errorCode === "not-supported" && (this.showVoiceInput = !1);
-    }} @arcgisVoiceInputInterimTranscription=${(a) => {
-      this.inputText = a.detail.text;
-    }} ${p(this.voiceInputEl)}></arcgis-portal-voice-input>${r && b`<calcite-button icon-start=microphone .label=${t.voiceInput} round .disabled=${u} .appearance=${l ? "solid" : "outline-fill"} @click=${async () => {
+    }} @arcgisVoiceInputError=${(o) => {
+      o.detail.errorCode === "not-supported" && (this.showVoiceInput = !1);
+    }} @arcgisVoiceInputInterimTranscription=${(o) => {
+      this.inputText = o.detail.text;
+    }} ${T(this.voiceInputEl)}></arcgis-portal-voice-input>${l && w`<calcite-button icon-start=microphone .label=${t.voiceInput} round .disabled=${i} .appearance=${c ? "solid" : "outline-fill"} @click=${async () => {
       this.isVoiceInputDisabled = !0;
-      const a = this.voiceInputEl.value;
-      l ? await a?.stopListening() : await a?.startListening();
-    }}></calcite-button>` || ""}<calcite-button type=submit icon-start=send round .disabled=${!s.trim()} .label=${t.send}>${t.send}</calcite-button></div></form><arcgis-assistant-agent .agent=${X} .context=${{ portal: o, user: i }}></arcgis-assistant-agent></arcgis-assistant>`;
+      const o = this.voiceInputEl.value;
+      c ? await o?.stopListening() : await o?.startListening();
+    }}></calcite-button>` || ""}<calcite-button type=submit icon-start=send round .disabled=${!e.trim()} .label=${t.send}>${t.send}</calcite-button></div></form><arcgis-assistant-agent .agent=${Tt} .context=${{ portal: a, user: r }}></arcgis-assistant-agent><arcgis-assistant-agent .agent=${Lt} .context=${{ portal: a, user: r }}></arcgis-assistant-agent><arcgis-assistant-agent .agent=${ae} .context=${{ portal: a, user: r }}></arcgis-assistant-agent>${this.interrupt && w`<arcgis-portal-ai-assistant-interrupt slot=interrupt .type=${this.interrupt.type} .message=${this.interrupt.message} .options=${this.interrupt.options} @arcgisSubmit=${({ detail: o }) => {
+      this.assistantEl.value?.submitInterrupt(o);
+    }} @arcgisCancel=${() => {
+      this.assistantEl.value?.cancelInterrupt();
+    }}></arcgis-portal-ai-assistant-interrupt>` || ""}</arcgis-assistant>`;
   }
 }
-$("arcgis-portal-ai-assistant", Z);
+Z("arcgis-portal-ai-assistant", ne);
 export {
-  Z as ArcgisPortalAiAssistant
+  ne as ArcgisPortalAiAssistant
 };