@arcgis/ai-components 5.2.0-next.5 → 5.2.0-next.7

package/dist/chunks/generateLayerDescriptions.js

@@ -1,11 +1,11 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { Annotation as d } from "@langchain/langgraph/web";
 import p, { z as o } from "zod";
-import { ChatPromptTemplate as F, SystemMessagePromptTemplate as B } from "@langchain/core/prompts";
+import { ChatPromptTemplate as F, SystemMessagePromptTemplate as W } from "@langchain/core/prompts";
 import { dispatchCustomEvent as U } from "@langchain/core/callbacks/dispatch/web";
-import { AIMessage as W, isAIMessage as H, isToolMessage as J } from "@langchain/core/messages";
-import { createAgent as X, summarizationMiddleware as G, modelCallLimitMiddleware as Q } from "langchain";
-import { ChatOpenAI as Y, OpenAIEmbeddings as Z } from "@langchain/openai";
+import { AIMessage as H, isAIMessage as J, isToolMessage as X } from "@langchain/core/messages";
+import { createAgent as G, summarizationMiddleware as Q, modelCallLimitMiddleware as Y } from "langchain";
+import { ChatOpenAI as Z, OpenAIEmbeddings as ee } from "@langchain/openai";
 import _ from "@arcgis/core/identity/IdentityManager.js";
 import k from "@arcgis/core/portal/Portal.js";
 const P = {
@@ -14,30 +14,30 @@ const P = {
   fast: "gpt-5.4-nano"
 }, A = {
   default: "text-embedding-ada-002"
-}, S = /* @__PURE__ */ new Map();
+}, M = /* @__PURE__ */ new Map();
 let v = null;
-const ee = () => {
+const te = () => {
   const t = k.getDefault().helperServices;
   if (!t?.aiModels?.url)
     throw new Error("AI Models Service URL is not defined in the portal's helper services.");
   return t.aiModels.url;
 }, q = async (e) => {
-  const t = ee();
-  S.size === 0 && (v || (v = (async () => {
+  const t = te();
+  M.size === 0 && (v || (v = (async () => {
     try {
       const n = await fetch(`${t}/models`);
       if (!n.ok)
         throw new Error("Failed to fetch AI service discovery data.");
-      (await n.json()).models.forEach((r) => S.set(r.name, r));
+      (await n.json()).models.forEach((i) => M.set(i.name, i));
     } catch (n) {
       throw v = null, n;
     }
   })()), await v);
-  const s = S.get(e);
+  const s = M.get(e);
   if (!s)
     throw new Error(`Model '${e}' is not available in the discovery service.`);
   return s.endpoint;
-}, te = async (e = "default") => await q(P[e]), ne = async (e = "default") => await q(A[e]), f = (e, t) => t, j = (e, t) => ({
+}, ne = async (e = "default") => await q(P[e]), se = async (e = "default") => await q(A[e]), h = (e, t) => t, j = (e, t) => ({
   ...e,
   ...t
 }), $ = (e = "", t) => {
@@ -49,10 +49,10 @@ const ee = () => {
     return s;
   if (n === s)
     return e;
-  const i = n.split(`
+  const a = n.split(`
 
 `);
-  return i[i.length - 1]?.trim() === s ? e : `${e}
+  return a[a.length - 1]?.trim() === s ? e : `${e}
 
 ${s}`;
 }, N = () => ({
@@ -61,7 +61,7 @@ ${s}`;
   messages: [],
   priorSteps: [],
   sharedState: {}
-}), se = () => ({
+}), ae = () => ({
   agentExecutionContext: d({
     reducer: j,
     default: N
@@ -71,33 +71,33 @@ ${s}`;
     default: () => ""
   }),
   summary: d({
-    reducer: f,
+    reducer: h,
     default: () => ""
   }),
   status: d({
-    reducer: f
+    reducer: h
   })
-}), Re = () => ({
-  ...se(),
+}), De = () => ({
+  ...ae(),
   sharedStatePatch: d({
-    reducer: f
+    reducer: h
   })
-}), De = d.Root({
+}), Fe = d.Root({
   agentExecutionContext: d({
     default: N,
     reducer: j
   }),
   currentIntent: d({
     default: () => "none",
-    reducer: f
+    reducer: h
   }),
   lastExecutedAgent: d({
     default: () => "",
-    reducer: f
+    reducer: h
   }),
   requiresFollowUp: d({
     default: () => !0,
-    reducer: f
+    reducer: h
   }),
   stepCount: d({
     default: () => 0,
@@ -107,24 +107,24 @@ ${s}`;
     default: () => "",
     reducer: $
   })
-}), g = async (e, t) => {
+}), f = async (e, t) => {
   await U("trace_message", e, t);
-}, Fe = async (e, t) => {
+}, Ue = async (e, t) => {
   await U("graph_ux_suggestion", e, t);
 }, ie = (e) => {
   if (!e || typeof e != "object" || !("services" in e))
     return !1;
   const t = e.services;
   return !!t && typeof t == "object" && "agentRegistry" in t;
-}, re = (e) => {
+}, oe = (e) => {
   const t = e?.configurable;
   return ie(t) ? t : void 0;
-}, oe = (e, t, s) => {
+}, re = (e, t, s) => {
   const n = e[t];
-  return n ? typeof n == "function" ? n() : Promise.resolve(n) : new Promise((i, r) => {
-    (typeof queueMicrotask == "function" ? queueMicrotask : setTimeout)(r.bind(null, /* @__PURE__ */ new Error("Unknown variable dynamic import: " + t + (t.split("/").length !== s ? ". Note that variables only represent file names one level deep." : ""))));
+  return n ? typeof n == "function" ? n() : Promise.resolve(n) : new Promise((a, i) => {
+    (typeof queueMicrotask == "function" ? queueMicrotask : setTimeout)(i.bind(null, /* @__PURE__ */ new Error("Unknown variable dynamic import: " + t + (t.split("/").length !== s ? ". Note that variables only represent file names one level deep." : ""))));
   });
-}, E = async (e) => (await oe(/* @__PURE__ */ Object.assign({ "./field_descriptions_prompt.md": () => import("./field_descriptions_prompt.js"), "./intent_prompt.md": () => import("./intent_prompt.js"), "./layer_descriptions_prompt.md": () => import("./layer_descriptions_prompt.js") }), `./${e}.md`, 2)).default, ae = async (e) => {
+}, I = async (e) => (await re(/* @__PURE__ */ Object.assign({ "./field_descriptions_prompt.md": () => import("./field_descriptions_prompt.js"), "./intent_prompt.md": () => import("./intent_prompt.js"), "./layer_descriptions_prompt.md": () => import("./layer_descriptions_prompt.js") }), `./${e}.md`, 2)).default, ce = async (e) => {
   const { agent: t, messages: s, config: n } = e;
   return { structuredResponse: (await t.invoke(
     {
@@ -133,73 +133,78 @@ ${s}`;
     n
   )).structuredResponse };
 }, O = (e, t) => async (s, n) => {
-  const i = new Headers(n?.headers);
-  i.delete("Authorization"), i.delete("api-key"), e && e.length > 0 && (i.set("X-Esri-Authorization", `Bearer ${e}`), i.set("X-Esri-Request-Source", "MapsSDK"));
-  const r = t && n?.signal ? AbortSignal.any([t, n.signal]) : n?.signal ?? t;
+  const a = new Headers(n?.headers);
+  a.delete("Authorization"), a.delete("api-key"), e && e.length > 0 && (a.set("X-Esri-Authorization", `Bearer ${e}`), a.set("X-Esri-Request-Source", "MapsSDK"));
+  const i = t && n?.signal ? AbortSignal.any([t, n.signal]) : n?.signal ?? t;
   return await fetch(s, {
     ...n,
-    headers: i,
-    signal: r
+    headers: a,
+    signal: i
   });
 }, b = async (e = {}) => {
-  const { modelTier: t = "default", temperature: s = 0, abortSignal: n } = e, i = k.getDefault(), r = await _.getCredential(`${i.url}/sharing`), a = P[t], c = await te(t);
-  return new Y({
-    modelName: a,
+  const { modelTier: t = "default", temperature: s = 0, abortSignal: n } = e, a = k.getDefault(), i = await _.getCredential(`${a.url}/sharing`), r = P[t], c = await ne(t);
+  return new Z({
+    modelName: r,
     apiKey: "dummy-key",
     // 5-mini does not support temperature parameter
     ...t !== "default" && { temperature: s },
     configuration: {
       baseURL: c,
-      fetch: O(r.token, n)
+      fetch: O(i.token, n)
     }
   });
-}, Ue = async (e = "default", t) => {
-  const s = k.getDefault(), n = await _.getCredential(`${s.url}/sharing`), i = A[e], r = await ne(e);
-  return new Z({
-    modelName: i,
+}, _e = async (e = "default", t) => {
+  const s = k.getDefault(), n = await _.getCredential(`${s.url}/sharing`), a = A[e], i = await se(e);
+  return new ee({
+    modelName: a,
     apiKey: "dummy-key",
     configuration: {
-      baseURL: r,
+      baseURL: i,
       fetch: O(n.token, t)
     },
     batchSize: 2048,
     maxConcurrency: 10
   });
-}, ce = o.object({
+}, le = o.object({
   id: o.string().min(1),
   name: o.string().min(1),
   description: o.string().min(1)
 });
-o.array(ce);
-const R = (e) => JSON.stringify(e, null, 2), le = (e) => {
+o.array(le);
+const R = (e) => JSON.stringify(e, null, 2), de = (e) => {
   const t = e.map((n) => n.id), s = o.enum(t);
   return o.object({
     intent: s.nullable(),
     assignedTask: o.string().nullable(),
     requiresFollowUp: o.boolean()
   });
-}, _e = async (e, t) => {
-  const s = re(t);
+}, Pe = async (e, t) => {
+  const s = oe(t);
   if (s.abortSignal?.aborted)
-    return await g({ text: "Run cancelled; skipping intent routing" }, t), {
+    return await f({ text: "Run cancelled; skipping intent routing" }, t), {
       ...e,
       currentIntent: "none",
+      finalOutputMessage: "Operation cancelled.",
       requiresFollowUp: !1
     };
   try {
-    await g({ text: "Asking LLM to route to an agent" }, t);
-    const r = (s.services.agentRegistry?.list() ?? []).map(({ agent: y }) => ({
-      id: y.id,
-      name: y.name,
-      description: y.description
+    await f({ text: "Asking LLM to route to an agent" }, t);
+    const a = s.services.agentRegistry?.list() ?? [], i = a.map(({ agent: g }) => ({
+      id: g.id,
+      name: g.name,
+      description: g.description
     }));
-    if (!r.length)
-      return await g({ text: "No agents registered; skipping intent detection" }, t), { ...e, currentIntent: "none" };
-    const a = await E("intent_prompt"), c = R(r), l = le(r), m = {
+    if (!i.length)
+      return await f({ text: "No agents registered; skipping intent detection" }, t), {
+        ...e,
+        currentIntent: "none",
+        finalOutputMessage: "No agents registered; skipping intent detection."
+      };
+    const r = await I("intent_prompt"), c = R(i), l = de(i), m = {
       registeredAgents: c,
       priorSteps: R(e.agentExecutionContext.priorSteps),
       userRequest: e.agentExecutionContext.userRequest
-    }, T = await F.fromTemplate(a).format(m), C = X({
+    }, T = await F.fromTemplate(r).format(m), C = G({
       model: await b({ modelTier: "fast", abortSignal: s.abortSignal }),
       tools: [],
       systemPrompt: T,
@@ -209,40 +214,43 @@ const R = (e) => JSON.stringify(e, null, 2), le = (e) => {
         // Preserve recent conversation context while summarizing older messages
         // to control token usage without losing important intent signals.
         // The trigger and keep parameters can be tuned based on token limits and behavior.
-        G({
+        Q({
           model: await b({ modelTier: "fast", abortSignal: s.abortSignal }),
           trigger: { tokens: 4e3 },
           keep: { messages: 6 }
         }),
         // Enforce no loop/retry.
         // 1 usual LLM call and 1 optional summarization call.
-        Q({ runLimit: 2 })
+        Y({ runLimit: 2 })
       ]
-    }), { structuredResponse: L } = await ae({
+    }), { structuredResponse: L } = await ce({
       agent: C,
       messages: e.agentExecutionContext.messages,
       config: t
-    }), h = l.parse(
+    }), y = l.parse(
       L ?? { intent: null, assignedTask: null, requiresFollowUp: !1 }
-    ), x = h.intent ?? "none", K = {
+    ), x = y.intent ?? "none", K = {
       ...e,
       currentIntent: x,
-      requiresFollowUp: h.requiresFollowUp,
+      requiresFollowUp: y.requiresFollowUp,
       agentExecutionContext: {
         ...e.agentExecutionContext,
-        assignedTask: h.assignedTask ?? ""
+        assignedTask: y.assignedTask ?? ""
       }
     };
     if (x === "none") {
-      const y = "I could not find a matching agent for that request. Please rephrase your question with more detail.";
-      return await g({ text: "LLM did not identify a clear intent." }, t), {
+      const g = `I could not find an agent that can handle that request. I have access to the following agents: ${a.map(({ agent: B }) => B.name).join(", ")}.
+
+Please ask a question that can be answered by one of these agents.`;
+      return await f({ text: "LLM did not identify a clear intent." }, t), {
         ...e,
         currentIntent: x,
         requiresFollowUp: !1,
+        finalOutputMessage: g,
         agentExecutionContext: {
           ...e.agentExecutionContext,
           assignedTask: "",
-          messages: [...e.agentExecutionContext.messages, new W(y)],
+          messages: [...e.agentExecutionContext.messages, new H(g)],
           priorSteps: [
             ...e.agentExecutionContext.priorSteps ?? [],
             {
@@ -255,31 +263,31 @@ const R = (e) => JSON.stringify(e, null, 2), le = (e) => {
         }
       };
     }
-    return await g(
+    return await f(
       {
         text: `Agent picked: ${x}
-Task Assigned: ${h.assignedTask ?? ""}
-Requires Follow-Up: ${h.requiresFollowUp}`
+Task Assigned: ${y.assignedTask ?? ""}
+Requires Follow-Up: ${y.requiresFollowUp}`
       },
       t
     ), K;
   } catch (n) {
-    throw await g({ text: "Error during intent detection" }, t), new Error(`Error during intent detection: ${n instanceof Error ? n.message : String(n)}`);
+    throw await f({ text: "Error during intent detection" }, t), new Error(`Error during intent detection: ${n instanceof Error ? n.message : String(n)}`);
   }
-}, de = "0.1", w = 1536, pe = "openai", me = A.default, ue = `Name: {name}
+}, pe = "0.1", w = 1536, me = "openai", ue = A.default, ge = `Name: {name}
 Title: {title}
-Description: {description}`, ge = `Name: {name}
+Description: {description}`, fe = `Name: {name}
 Alias: {alias}
-Description: {description}`, Pe = o.object({
-  schemaVersion: o.literal(de),
+Description: {description}`, qe = o.object({
+  schemaVersion: o.literal(pe),
   modified: o.number().int().nonnegative(),
   embeddings: o.object({
-    modelProvider: o.literal(pe),
-    model: o.literal(me),
+    modelProvider: o.literal(me),
+    model: o.literal(ue),
     dimensions: o.literal(w),
     templates: o.object({
-      layer: o.string().default(ue),
-      field: o.string().default(ge)
+      layer: o.string().default(ge),
+      field: o.string().default(fe)
     })
   }),
   layers: o.array(
@@ -303,99 +311,99 @@ Description: {description}`, Pe = o.object({
       )
     })
   ).default([])
-}), fe = (e) => {
+}), he = (e) => {
   const t = /* @__PURE__ */ new Set();
   for (const n of e)
-    if (H(n)) {
-      const i = n;
-      i.tool_calls && i.tool_calls.length > 0 && i.tool_calls.forEach((r) => {
-        r.id && t.add(r.id);
+    if (J(n)) {
+      const a = n;
+      a.tool_calls && a.tool_calls.length > 0 && a.tool_calls.forEach((i) => {
+        i.id && t.add(i.id);
       });
     }
   return e.filter((n) => {
-    if (J(n)) {
-      const i = n;
-      return t.has(i.tool_call_id);
+    if (X(n)) {
+      const a = n;
+      return t.has(a.tool_call_id);
     }
     return !0;
   });
-}, I = (e, t) => {
-  const s = B.fromTemplate(e);
+}, E = (e, t) => {
+  const s = W.fromTemplate(e);
   return F.fromMessages([s, ...t]);
-}, he = async (e) => {
-  const { promptText: t, modelTier: s, temperature: n, messages: i, abortSignal: r } = e, a = I(t, i ?? []), c = await b({ modelTier: s, temperature: n, abortSignal: r });
-  return a.pipe(c);
-}, qe = async (e) => {
-  const { promptText: t, modelTier: s = "default", temperature: n = 0, messages: i, inputVariables: r, abortSignal: a } = e, l = await (await he({
+}, ye = async (e) => {
+  const { promptText: t, modelTier: s, temperature: n, messages: a, abortSignal: i } = e, r = E(t, a ?? []), c = await b({ modelTier: s, temperature: n, abortSignal: i });
+  return r.pipe(c);
+}, je = async (e) => {
+  const { promptText: t, modelTier: s = "default", temperature: n = 0, messages: a, inputVariables: i, abortSignal: r } = e, l = await (await ye({
     promptText: t,
     modelTier: s,
     temperature: n,
-    messages: i,
-    abortSignal: a
-  })).invoke(r ?? {});
+    messages: a,
+    abortSignal: r
+  })).invoke(i ?? {});
   if (typeof l == "string")
     return l;
   const m = l.content;
   return typeof m == "string" ? m : JSON.stringify(m);
 }, V = async (e) => {
-  const { promptText: t, modelTier: s = "default", temperature: n = 0, messages: i, inputVariables: r, schema: a, abortSignal: c } = e, l = I(t, i ?? []), u = (await b({ modelTier: s, temperature: n, abortSignal: c })).withStructuredOutput(a);
-  return await l.pipe(u).invoke(r ?? {});
-}, je = async (e) => {
-  const { promptText: t, modelTier: s = "default", temperature: n = 0, messages: i, inputVariables: r, tools: a, abortSignal: c } = e, l = a.length > 0 ? fe(i ?? []) : i ?? [], m = I(t, l), u = await b({ modelTier: s, temperature: n, abortSignal: c });
-  return await m.pipe(u.bindTools(a)).invoke(r ?? {});
-}, ye = p.object({
+  const { promptText: t, modelTier: s = "default", temperature: n = 0, messages: a, inputVariables: i, schema: r, abortSignal: c } = e, l = E(t, a ?? []), u = (await b({ modelTier: s, temperature: n, abortSignal: c })).withStructuredOutput(r);
+  return await l.pipe(u).invoke(i ?? {});
+}, $e = async (e) => {
+  const { promptText: t, modelTier: s = "default", temperature: n = 0, messages: a, inputVariables: i, tools: r, abortSignal: c } = e, l = r.length > 0 ? he(a ?? []) : a ?? [], m = E(t, l), u = await b({ modelTier: s, temperature: n, abortSignal: c });
+  return await m.pipe(u.bindTools(r)).invoke(i ?? {});
+}, we = p.object({
   name: p.string(),
   description: p.string(),
   valueType: p.string(),
   alias: p.string()
-}), we = p.object({
-  fields: p.array(ye)
-}), z = (e, t) => e.getFieldAlias(t) ?? void 0, M = (e, t) => z(e, t.name) ?? t.alias ?? "", be = (e, t) => {
+}), be = p.object({
+  fields: p.array(we)
+}), z = (e, t) => e.getFieldAlias(t) ?? void 0, S = (e, t) => z(e, t.name) ?? t.alias ?? "", xe = (e, t) => {
   const s = z(e, t.name);
   return !!(s && s !== (t.alias ?? ""));
 };
 function D(e, t) {
   const s = /* @__PURE__ */ new Map();
   for (const n of e.fields) {
-    const i = t.fields.find((l) => l.name === n.name), r = M(e, n), a = be(e, n), c = {
+    const a = t.fields.find((l) => l.name === n.name), i = S(e, n), r = xe(e, n), c = {
       name: n.name,
       type: n.type,
-      alias: a ? r : i?.alias ?? r,
-      description: i?.description ?? n.description ?? "",
-      valueType: i?.valueType ?? n.valueType ?? "",
+      alias: r ? i : a?.alias ?? i,
+      description: a?.description ?? n.description ?? "",
+      valueType: a?.valueType ?? n.valueType ?? "",
       domain: e.getFieldDomain(n.name) ?? void 0
     };
     s.set(n.name, c);
   }
   return s;
 }
-const $e = async (e) => {
-  const s = await E("field_descriptions_prompt"), n = e.fields.filter((a) => !(M(e, a) && a.description)).map((a) => {
-    const { name: c, type: l, description: m } = a, u = M(e, a);
+const Ne = async (e) => {
+  const s = await I("field_descriptions_prompt"), n = e.fields.filter((r) => !(S(e, r) && r.description)).map((r) => {
+    const { name: c, type: l, description: m } = r, u = S(e, r);
     return [`Name: ${c}`, `Type: ${l}`, `Alias: ${u}`, `Description: ${m ?? "N/A"}`].join(", ");
   }).join(`
 `);
   if (n.length === 0)
     return D(e, { fields: [] });
-  const i = {
+  const a = {
     existingItemTitle: e.portalItem?.title,
     existingItemDescription: e.portalItem?.description,
     existingLayerTitle: e.title,
     existingLayerDescription: e.portalItem?.description,
     fieldInformation: n
-  }, r = await V({
+  }, i = await V({
     promptText: s,
-    schema: we,
-    inputVariables: i
+    schema: be,
+    inputVariables: a
   });
-  return D(e, r);
-}, xe = p.object({
+  return D(e, i);
+}, ve = p.object({
   title: p.string(),
   description: p.string(),
   name: p.string().nullable()
-}), Ne = async (e, t) => {
-  const n = await E("layer_descriptions_prompt"), i = Array.from(t.values()), r = {
-    fieldInformation: JSON.stringify(i, null, 2),
+}), Oe = async (e, t) => {
+  const n = await I("layer_descriptions_prompt"), a = Array.from(t.values()), i = {
+    fieldInformation: JSON.stringify(a, null, 2),
     existingLayerTitle: e.title,
     existingLayerDescription: e.portalItem?.description,
     existingLayerSnippet: e.portalItem?.snippet,
@@ -403,31 +411,31 @@ const $e = async (e) => {
   };
   return { ...await V({
     promptText: n,
-    schema: xe,
-    inputVariables: r
+    schema: ve,
+    inputVariables: i
   }), name: e.title ?? null };
 };
 export {
-  De as D,
-  Pe as W,
-  Ne as a,
-  pe as b,
+  Fe as D,
+  qe as W,
+  Oe as a,
+  me as b,
   b as c,
   w as d,
-  de as e,
-  ge as f,
-  $e as g,
-  qe as h,
+  pe as e,
+  fe as f,
+  Ne as g,
+  je as h,
   V as i,
-  je as j,
-  se as k,
-  ue as l,
-  me as m,
-  Re as n,
-  Fe as o,
-  ne as p,
-  re as q,
-  _e as r,
-  g as s,
-  Ue as t
+  $e as j,
+  ae as k,
+  ge as l,
+  ue as m,
+  De as n,
+  Ue as o,
+  se as p,
+  oe as q,
+  Pe as r,
+  f as s,
+  _e as t
 };

package/dist/components/arcgis-assistant-chat/customElement.d.ts

@@ -3,7 +3,12 @@ import type Collection from "@arcgis/core/core/Collection.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { ChatMessage } from "../arcgis-assistant/types.js";
 
-/** @internal */
+/**
+ * Wraps and renders the conversation area. Use it as the container for message list content.
+ * Offers chat-level layout structure for message starter, message list, and loading regions.
+ *
+ * @internal
+ */
 export abstract class ArcgisAssistantChat extends LitElement {
   /** @default false */
   accessor loading: boolean;

package/dist/components/arcgis-assistant-chat-entry/customElement.d.ts

@@ -5,7 +5,8 @@ import type { ChatMessage } from "../arcgis-assistant/types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 
 /**
- * An input bar primitive for collecting assistant prompts.
+ * Provides the input bar and submit or cancel behavior. Use it to collect prompts and emit submit events.
+ * Offers keyboard submit/history behavior, entry action slots, and optional voice-input integration.
  *
  * @slot [entry-actions-start] - Slot for adding actions to the start of the entry area.
  * @slot [entry-actions-end] - Slot for adding actions to the end of the entry area.

package/dist/components/arcgis-assistant-interrupt/customElement.d.ts

@@ -2,7 +2,10 @@
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 
-/** @internal */
+/**
+ * Renders interrupt prompts for extra user input. Use it when an agent pauses for confirmation, choice, or text input.
+ * Offers interrupt-specific input modes and submit or cancel event handling.
+ */
 export abstract class ArcgisAssistantInterrupt extends LitElement {
   /** @internal */
   protected _messages: {

package/dist/components/arcgis-assistant-message/customElement.d.ts

@@ -0,0 +1,21 @@
+/// <reference path="../../index.d.ts" />
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { AssistantMessage } from "../arcgis-assistant/types.js";
+
+/**
+ * Renders a single assistant response message shell. Pass one assistant message object and let it host body and footer actions.
+ * Offers a reusable assistant-message layout with icon, content, and footer slot regions.
+ */
+export abstract class ArcgisAssistantMessage extends LitElement {
+  /** @default false */
+  accessor copyEnabled: boolean;
+  /** @default false */
+  accessor feedbackEnabled: boolean;
+  /** @default false */
+  accessor footerDisabled: boolean;
+  /** @default false */
+  accessor logEnabled: boolean;
+  accessor message: AssistantMessage | undefined;
+  /** @default false */
+  accessor readAloudEnabled: boolean;
+}

package/dist/components/arcgis-assistant-message/index.d.ts

@@ -0,0 +1 @@
+export * from "./customElement.js";

package/dist/components/arcgis-assistant-message-block/customElement.d.ts

@@ -2,7 +2,7 @@
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { UXSuggestion } from "../../utils/index.js";
 
-/** A primitive for rendering a default assistant output block. */
+/** Renders one structured assistant block. Offers default block rendering for supported suggestion-style blocks. */
 export abstract class ArcgisAssistantMessageBlock extends LitElement {
   accessor block: UXSuggestion | undefined;
 }

package/dist/components/arcgis-assistant-message-feedback/customElement.d.ts

@@ -3,7 +3,10 @@ import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { AssistantMessage } from "../arcgis-assistant/types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 
-/** @internal */
+/**
+ * Handles thumbs up or down feedback UI. Use it to capture helpful or not helpful signals per response.
+ * Offers feedback toggle behavior and emits feedback updates for the associated assistant message.
+ */
 export abstract class ArcgisAssistantMessageFeedback extends LitElement {
   /** @internal */
   protected _messages: {

package/dist/components/arcgis-assistant-message-footer/customElement.d.ts

@@ -3,7 +3,10 @@ import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { AssistantMessage } from "../arcgis-assistant/types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 
-/** @internal */
+/**
+ * Renders the action row under an assistant message. Use it when you want feedback, log, copy, or read-aloud controls.
+ * Offers one footer surface that composes common assistant response actions.
+ */
 export abstract class ArcgisAssistantMessageFooter extends LitElement {
   /** @internal */
   protected _messages: {