@epam/ai-dial-chat-hooks 1.1.0-rc.0 → 1.1.0-rc.2

package/catalog/map-deployment-to-catalog-item.js

@@ -31,11 +31,11 @@ var c = {
 }, f = "applications/", p = "toolsets/", m = "public", h = (t, n) => (t.startsWith(n) ? t.slice(n.length) : t).split("/").filter(Boolean).map(e), g = (e, t) => {
 	if (e.isMy) return [t.personal];
 	let n = h(e.applicationFolder ?? "", f);
-	return e.sharedWithMe ? [t.shared, ...n.slice(1)] : n[0]?.toLowerCase() === m ? [t.public, ...n.slice(1)] : n;
+	return e.sharedWithMe ? [t.shared, ...n.slice(1)] : n.length === 0 && e.type?.toLowerCase() === "application" ? [t.public] : n[0]?.toLowerCase() === m ? [t.public, ...n.slice(1)] : n;
 }, _ = (e, t) => {
 	if (e.isMy && t != null) return [t.personal];
 	let n = e.toolset || e.id;
-	if (!n.startsWith(p)) return [];
+	if (!n.startsWith(p)) return t == null ? [] : e.sharedWithMe ? [t.shared] : n.length > 0 && !n.includes("/") ? [t.public] : [];
 	let r = h(n, p).slice(0, -1);
 	return e.sharedWithMe && t != null ? [t.shared, ...r.slice(1)] : r[0]?.toLowerCase() === m && t != null ? [t.public, ...r.slice(1)] : r.slice(1);
 }, v = (e, { favoriteIds: t = /* @__PURE__ */ new Set(), entityDetails: o, folderLabels: s, editableSchemaIds: c = [], isCustomAppsEditable: l = !1, activeLocale: u, primaryLocale: f, resolveIconUrl: p }) => {

package/catalog/map-skill-to-catalog-item.js

@@ -115,9 +115,9 @@ var c = {
 	if (Number.isFinite(t) && t > 262144) return null;
 	let n = await e.arrayBuffer();
 	return n.byteLength > 262144 ? null : new Uint8Array(n);
-}, S = async (e) => {
+}, S = async (e) => new Uint8Array(await e.arrayBuffer()), C = async (e) => {
 	let t = await x(e);
 	return t == null ? null : new TextDecoder().decode(t);
 };
 //#endregion
-export { b as buildSkillContentTree, _ as buildSkillOverview, u as mapSkillToCatalogItem, x as readSkillFileBytes, S as readSkillManifest, g as resolveSkillFileDownloadPath, m as resolveSkillManifestFileId };
+export { b as buildSkillContentTree, _ as buildSkillOverview, u as mapSkillToCatalogItem, x as readSkillFileBytes, S as readSkillFilePreviewBytes, C as readSkillManifest, g as resolveSkillFileDownloadPath, m as resolveSkillManifestFileId };

package/catalog/useSkillItemDetails.js

@@ -1,6 +1,6 @@
 import { SKILL_MANIFEST_FILE as e } from "../skill/skill.js";
 import { parseSkillResourceUrl as t } from "../skill/skill-types.js";
-import { buildSkillContentTree as n, buildSkillOverview as r, readSkillFileBytes as i, readSkillManifest as a, resolveSkillFileDownloadPath as o, resolveSkillManifestFileId as s } from "./map-skill-to-catalog-item.js";
+import { buildSkillContentTree as n, buildSkillOverview as r, readSkillFilePreviewBytes as i, readSkillManifest as a, resolveSkillFileDownloadPath as o, resolveSkillManifestFileId as s } from "./map-skill-to-catalog-item.js";
 import { parseSkillManifestDocument as c } from "../skill/skill-manifest.js";
 import { useCallback as l, useRef as u } from "react";
 //#region src/catalog/useSkillItemDetails.ts
@@ -47,9 +47,7 @@ var d = ({ api: d, skills: f, skillOverviewLabels: p }) => {
 			if (n == null) throw Error("A folder cannot be previewed");
 			let r = await d.downloadSkillFile(t.bucket, t.path, n);
 			if (!r.ok) throw Object.assign(/* @__PURE__ */ Error(`File preview failed with status ${r.status}`), { status: r.status });
-			let a = await i(r);
-			if (a == null) throw Error("File exceeds the preview size limit");
-			let s = r.headers.get("content-type")?.split(";")[0].trim() || void 0;
+			let a = await i(r), s = r.headers.get("content-type")?.split(";")[0].trim() || void 0;
 			return {
 				bytes: a,
 				mimeType: s === "application/octet-stream" ? void 0 : s

package/catalog.d.ts

@@ -652,6 +652,24 @@ export declare interface PublishApiClient {
  */
 export declare const readSkillFileBytes: (response: Response) => Promise<Uint8Array | null>;
 
+/**
+ * Reads a skill file response as raw bytes with no size ceiling, for the
+ * supporting-file **preview** path.
+ *
+ * Previews are user-initiated, one file at a time, and a realistic binary
+ * (a PDF, an image) routinely exceeds `SKILL_MANIFEST_MAX_BYTES` — a cap
+ * sized for `SKILL.md` frontmatter, not for binaries — so applying that cap
+ * here rejected virtually every real PDF before it was ever decoded. This
+ * reader therefore never returns `null`: file size is not a failure class on
+ * the preview path.
+ *
+ * `readSkillFileBytes` and `readSkillManifest` keep their
+ * `SKILL_MANIFEST_MAX_BYTES` ceiling, because they feed the manifest parse
+ * and the textual Content-tab read, where an oversized body must never be
+ * decoded into a string.
+ */
+export declare const readSkillFilePreviewBytes: (response: Response) => Promise<Uint8Array>;
+
 /**
  * Reads a skill manifest response as text, or `null` when the body is larger
  * than `SKILL_MANIFEST_MAX_BYTES`. The size is checked before decoding, so an
@@ -681,7 +699,8 @@ export declare const reconcileFilterTopics: (persistedTopics: ReadonlySet<string
  */
 export declare const resolveCatalogPrimaryAction: (item: CatalogItem, fetchPrompt: (item: CatalogItem) => Promise<PromptResponseDto>) => Promise<CatalogPrimaryActionResult>;
 
-export declare const resolveDeploymentFolder: (deployment: Pick<DeploymentItemDto, "isMy" | "sharedWithMe" | "applicationFolder">, labels: DeploymentFolderLabels) => string[];
+/** Resolves a deployment's display folder, including organization applications without a folder path. */
+export declare const resolveDeploymentFolder: (deployment: Pick<DeploymentItemDto, "isMy" | "sharedWithMe" | "applicationFolder"> & Partial<Pick<DeploymentItemDto, "type">>, labels: DeploymentFolderLabels) => string[];
 
 /** Returns the MCP resource kind a catalog item's Connect endpoint belongs to, or `null` when the item exposes no MCP endpoint. */
 export declare const resolveMcpResourceKind: (type: CatalogEntityType, supportsMcp?: boolean) => McpResourceKind | null;

package/catalog.js

@@ -8,17 +8,17 @@ import { mapDeploymentDetailsDtoToEntityDetails as u, mapEntityDetailsToCatalogD
 import { mapDeploymentToCatalogItem as p, mapDeploymentToolsetCredentials as m, mapToolsetToCatalogItem as h, resolveDeploymentFolder as g } from "./catalog/map-deployment-to-catalog-item.js";
 import { buildPromptOverview as _, isOrganisationPromptItem as v, mapPromptToCatalogItem as y } from "./catalog/map-prompt-to-catalog-item.js";
 import { PUBLIC_SKILL_BUCKET as b, SKILL_LISTING_MAX_PAGES as x, SKILL_LISTING_PAGE_SIZE as S, SKILL_MANIFEST_MAX_BYTES as C, SkillSource as w, parseSkillResourceUrl as T } from "./skill/skill-types.js";
-import { buildSkillContentTree as E, buildSkillOverview as D, mapSkillToCatalogItem as O, readSkillFileBytes as k, readSkillManifest as A, resolveSkillFileDownloadPath as j, resolveSkillManifestFileId as M } from "./catalog/map-skill-to-catalog-item.js";
-import { McpResourceKind as N, buildApplicationMcpUrl as P, buildConnectApi as F, buildToolsetMcpUrl as I, resolveMcpResourceKind as L } from "./catalog/mcp-endpoint-url.js";
-import { getPublicCatalogEntityFolderPath as R, isPublicCatalogEntityId as z, mapPublishConversationResultDto as B, mapPublishHistoryEntryDto as V, toPublishEntityType as H } from "./catalog/publish.js";
-import { deriveAvailableTabIds as U, deriveFavoriteItems as W, filterCatalogItemsBySelector as G, filterHiddenOwnedItems as K, reconcileFilterTopics as q } from "./catalog/catalog-derivations.js";
-import { CatalogPrimaryActionType as J, resolveCatalogPrimaryAction as Y } from "./catalog/catalog-primary-action.js";
-import { useCatalogEditNavigation as X } from "./catalog/useCatalogEditNavigation/useCatalogEditNavigation.js";
-import { useSkillItemDetails as Z } from "./catalog/useSkillItemDetails.js";
-import { useCatalogItemDetails as Q } from "./catalog/useCatalogItemDetails.js";
-import { useCatalogToolsetCredentials as $ } from "./catalog/useCatalogToolsetCredentials/useCatalogToolsetCredentials.js";
-import { useSkillDetailsPanelData as ee } from "./catalog/useSkillDetailsPanelData/useSkillDetailsPanelData.js";
-import { FavoriteEntityType as te, useFavoriteEntitiesState as ne } from "./catalog/useFavoriteEntitiesState/useFavoriteEntitiesState.js";
-import { usePublishFolders as re } from "./catalog/usePublishFolders/usePublishFolders.js";
-import { SkillPreviewErrorKind as ie, useSkillFilePreview as ae } from "./skill/useSkillFilePreview.js";
-export { s as AuthenticationType, J as CatalogPrimaryActionType, te as FavoriteEntityType, N as McpResourceKind, b as PUBLIC_SKILL_BUCKET, x as SKILL_LISTING_MAX_PAGES, S as SKILL_LISTING_PAGE_SIZE, C as SKILL_MANIFEST_MAX_BYTES, ie as SkillPreviewErrorKind, w as SkillSource, P as buildApplicationMcpUrl, n as buildChatCompletionsUrl, F as buildConnectApi, r as buildDeploymentConnectApi, _ as buildPromptOverview, i as buildResponsesUrl, E as buildSkillContentTree, D as buildSkillOverview, I as buildToolsetMcpUrl, e as createPublishApiClient, U as deriveAvailableTabIds, W as deriveFavoriteItems, a as encodeDeploymentId, G as filterCatalogItemsBySelector, K as filterHiddenOwnedItems, o as findDeploymentByIdOrReference, R as getPublicCatalogEntityFolderPath, v as isOrganisationPromptItem, z as isPublicCatalogEntityId, u as mapDeploymentDetailsDtoToEntityDetails, c as mapDeploymentLimitsDtoToCatalogLimits, l as mapDeploymentLimitsToInput, p as mapDeploymentToCatalogItem, m as mapDeploymentToolsetCredentials, d as mapEntityDetailsToCatalogDetails, y as mapPromptToCatalogItem, B as mapPublishConversationResultDto, V as mapPublishHistoryEntryDto, O as mapSkillToCatalogItem, f as mapToolsetCredentials, h as mapToolsetToCatalogItem, T as parseSkillResourceUrl, k as readSkillFileBytes, A as readSkillManifest, q as reconcileFilterTopics, Y as resolveCatalogPrimaryAction, g as resolveDeploymentFolder, L as resolveMcpResourceKind, j as resolveSkillFileDownloadPath, M as resolveSkillManifestFileId, H as toPublishEntityType, t as toPublishRuleDto, X as useCatalogEditNavigation, Q as useCatalogItemDetails, $ as useCatalogToolsetCredentials, ne as useFavoriteEntitiesState, re as usePublishFolders, ee as useSkillDetailsPanelData, ae as useSkillFilePreview, Z as useSkillItemDetails };
+import { buildSkillContentTree as E, buildSkillOverview as D, mapSkillToCatalogItem as O, readSkillFileBytes as k, readSkillFilePreviewBytes as A, readSkillManifest as j, resolveSkillFileDownloadPath as M, resolveSkillManifestFileId as N } from "./catalog/map-skill-to-catalog-item.js";
+import { McpResourceKind as P, buildApplicationMcpUrl as F, buildConnectApi as I, buildToolsetMcpUrl as L, resolveMcpResourceKind as R } from "./catalog/mcp-endpoint-url.js";
+import { getPublicCatalogEntityFolderPath as z, isPublicCatalogEntityId as B, mapPublishConversationResultDto as V, mapPublishHistoryEntryDto as H, toPublishEntityType as U } from "./catalog/publish.js";
+import { deriveAvailableTabIds as W, deriveFavoriteItems as G, filterCatalogItemsBySelector as K, filterHiddenOwnedItems as q, reconcileFilterTopics as J } from "./catalog/catalog-derivations.js";
+import { CatalogPrimaryActionType as Y, resolveCatalogPrimaryAction as X } from "./catalog/catalog-primary-action.js";
+import { useCatalogEditNavigation as Z } from "./catalog/useCatalogEditNavigation/useCatalogEditNavigation.js";
+import { useSkillItemDetails as Q } from "./catalog/useSkillItemDetails.js";
+import { useCatalogItemDetails as $ } from "./catalog/useCatalogItemDetails.js";
+import { useCatalogToolsetCredentials as ee } from "./catalog/useCatalogToolsetCredentials/useCatalogToolsetCredentials.js";
+import { useSkillDetailsPanelData as te } from "./catalog/useSkillDetailsPanelData/useSkillDetailsPanelData.js";
+import { FavoriteEntityType as ne, useFavoriteEntitiesState as re } from "./catalog/useFavoriteEntitiesState/useFavoriteEntitiesState.js";
+import { usePublishFolders as ie } from "./catalog/usePublishFolders/usePublishFolders.js";
+import { SkillPreviewErrorKind as ae, useSkillFilePreview as oe } from "./skill/useSkillFilePreview.js";
+export { s as AuthenticationType, Y as CatalogPrimaryActionType, ne as FavoriteEntityType, P as McpResourceKind, b as PUBLIC_SKILL_BUCKET, x as SKILL_LISTING_MAX_PAGES, S as SKILL_LISTING_PAGE_SIZE, C as SKILL_MANIFEST_MAX_BYTES, ae as SkillPreviewErrorKind, w as SkillSource, F as buildApplicationMcpUrl, n as buildChatCompletionsUrl, I as buildConnectApi, r as buildDeploymentConnectApi, _ as buildPromptOverview, i as buildResponsesUrl, E as buildSkillContentTree, D as buildSkillOverview, L as buildToolsetMcpUrl, e as createPublishApiClient, W as deriveAvailableTabIds, G as deriveFavoriteItems, a as encodeDeploymentId, K as filterCatalogItemsBySelector, q as filterHiddenOwnedItems, o as findDeploymentByIdOrReference, z as getPublicCatalogEntityFolderPath, v as isOrganisationPromptItem, B as isPublicCatalogEntityId, u as mapDeploymentDetailsDtoToEntityDetails, c as mapDeploymentLimitsDtoToCatalogLimits, l as mapDeploymentLimitsToInput, p as mapDeploymentToCatalogItem, m as mapDeploymentToolsetCredentials, d as mapEntityDetailsToCatalogDetails, y as mapPromptToCatalogItem, V as mapPublishConversationResultDto, H as mapPublishHistoryEntryDto, O as mapSkillToCatalogItem, f as mapToolsetCredentials, h as mapToolsetToCatalogItem, T as parseSkillResourceUrl, k as readSkillFileBytes, A as readSkillFilePreviewBytes, j as readSkillManifest, J as reconcileFilterTopics, X as resolveCatalogPrimaryAction, g as resolveDeploymentFolder, R as resolveMcpResourceKind, M as resolveSkillFileDownloadPath, N as resolveSkillManifestFileId, U as toPublishEntityType, t as toPublishRuleDto, Z as useCatalogEditNavigation, $ as useCatalogItemDetails, ee as useCatalogToolsetCredentials, re as useFavoriteEntitiesState, ie as usePublishFolders, te as useSkillDetailsPanelData, oe as useSkillFilePreview, Q as useSkillItemDetails };

package/conversation/announcement-message.js

@@ -34,9 +34,20 @@ var t = {
 e.addHook("afterSanitizeAttributes", (e) => {
 	e.tagName === "A" && e.getAttribute("target") === "_blank" && e.setAttribute("rel", "noopener noreferrer");
 });
-var r = (n) => e.sanitize(n, t), i = (t) => e.sanitize(t, n), a = (e) => typeof e == "string" && e.length > 0, o = ({ title: e, description: t }) => a(e) || a(t), s = (e) => o(e) || a(e.html), c = (e) => o(e) ? JSON.stringify({
-	title: e.title ?? "",
-	description: e.description ?? ""
-}) : e.html ?? "";
+var r = (n) => e.sanitize(n, t), i = (t) => e.sanitize(t, n), a = (e) => typeof e == "string" && e.length > 0, o = ({ title: e, description: t }) => a(e) || a(t), s = (e) => o(e) || a(e.html), c = (e) => e.map((e) => ({
+	title: e.title,
+	description: e.description ?? "",
+	link: e.link ? {
+		label: e.link.label,
+		href: e.link.href
+	} : null
+})), l = (e) => {
+	if (!o(e)) return e.html ?? "";
+	let t = {
+		title: e.title ?? "",
+		description: e.description ?? ""
+	}, n = e.items ?? [];
+	return n.length > 0 && (t.items = c(n)), JSON.stringify(t);
+};
 //#endregion
-export { c as buildAnnouncementSignature, s as hasAnnouncementContent, o as hasStructuredAnnouncement, r as sanitizeAnnouncementHtml, i as sanitizeAnnouncementMessageHtml };
+export { l as buildAnnouncementSignature, s as hasAnnouncementContent, o as hasStructuredAnnouncement, r as sanitizeAnnouncementHtml, i as sanitizeAnnouncementMessageHtml };

package/conversation/useAttachmentUpload/useAttachmentUpload.js

@@ -26,9 +26,16 @@ var o = 700, s = 5, c = (e) => t(e.split("/").filter(Boolean).pop() ?? "file").r
 				})).url,
 				name: a.fileName
 			};
-		} catch (t) {
-			if (l(t)) {
+		} catch (c) {
+			if (l(c)) {
 				if (i.markTaken(a.fileName), o < s) {
+					if (t.listFiles) try {
+						let e = await t.listFiles({
+							bucket: u,
+							path: a.path.slice(0, a.path.lastIndexOf("/"))
+						});
+						for (let t of e.items) i.markTaken(t.name);
+					} catch {}
 					a = i.allocate(n);
 					continue;
 				}
@@ -38,10 +45,10 @@ var o = 700, s = 5, c = (e) => t(e.split("/").filter(Boolean).pop() ?? "file").r
 					let e = p.current.splice(0);
 					d?.(e), m.current = null;
 				}, f);
-				let n = t instanceof Error ? t : /* @__PURE__ */ Error("Network upload failed");
-				throw n.errorReason = r.Network, n;
+				let t = c instanceof Error ? c : /* @__PURE__ */ Error("Network upload failed");
+				throw t.errorReason = r.Network, t;
 			}
-			throw t;
+			throw c;
 		}
 	}, [
 		u,

package/conversation/useConversationHandlers/useConversationHandlers.js

@@ -44,23 +44,19 @@ var p = ({ conversation: p, conversationId: m, bucket: h, isStreaming: g, startS
 		if (g || !m || !p || e === -1 || p.messages[e]?.role !== c.Assistant) return;
 		let t = p.messages[e - 1];
 		if (!t || t.role !== c.User) return;
-		let n = C();
-		v((t) => {
-			if (!t) return t;
-			let r = {
-				...t.messages[e],
-				content: "",
-				custom_content: void 0,
-				wasStoppedByUser: void 0,
-				stoppedWithoutContent: void 0,
-				streamErrorMessage: void 0,
-				deploymentId: n
-			}, i = {
-				...t,
-				messages: [...t.messages.slice(0, e), r]
-			};
-			return y.current = i, i;
-		}), A((t) => new Set([...t].filter((t) => t < e))), _(m, t.content, e, n, t.custom_content, l(), f.Regenerate);
+		let n = C(), r = {
+			...p.messages[e],
+			content: "",
+			custom_content: void 0,
+			wasStoppedByUser: void 0,
+			stoppedWithoutContent: void 0,
+			streamErrorMessage: void 0,
+			deploymentId: n
+		}, i = {
+			...p,
+			messages: [...p.messages.slice(0, e), r]
+		};
+		y.current = i, v(i), A((t) => new Set([...t].filter((t) => t < e))), _(m, t.content, e, n, t.custom_content, l(), f.Regenerate);
 	}, [
 		p,
 		m,

package/conversation/useConversationStream/useConversationStream.js

@@ -86,7 +86,11 @@ var m = 2e4, h = ({ conversationId: h, state: { setConversation: g, conversation
 		};
 		(async () => {
 			try {
-				let e = x?.channelId ?? await x?.waitForChannel(m) ?? void 0;
+				let e = x?.channelId ?? await x?.waitForChannel(m) ?? void 0, t = N.current.has(h);
+				if (D.signal.aborted || E() || t) {
+					M.current.get(C)?.generationId === h && M.current.delete(C), E() || R(C), k.current === h && (k.current = null, A.current = null, O(null)), b(C, h), x?.notifyGenerationSettled?.(), t ? N.current.delete(h) : E() || S?.notifyGenerationEnd?.();
+					return;
+				}
 				v.streamCompletion(C, o, l, F, u, h, f, T, e);
 			} catch (e) {
 				F.onError(e instanceof Error ? e : Error(String(e)));

package/conversation/useTranscribeAudio/transcription-retry.js

@@ -1,6 +1,6 @@
 import { AudioTranscriptionError as e, AudioTranscriptionErrorReason as t } from "./audio-transcription-error.js";
 //#region src/conversation/useTranscribeAudio/transcription-retry.ts
-var n = 2, r = 9e4, i = (e, t) => (t.throwIfAborted(), new Promise((n, r) => {
+var n = 2, r = 6e3, i = (e, t) => (t.throwIfAborted(), new Promise((n, r) => {
 	let i = () => {
 		clearTimeout(a), r(t.reason);
 	}, a = setTimeout(() => {
@@ -28,9 +28,10 @@ var n = 2, r = 9e4, i = (e, t) => (t.throwIfAborted(), new Promise((n, r) => {
 				503,
 				504
 			].includes(u.status)) throw o;
-			let d = [429, 503].includes(u.status) ? 3e4 : 2e3, f = Math.max(1e3, a(u.headers.get("retry-after")) ?? d * 2 ** l);
-			if (l >= n || c + f > r) throw new e(t.Busy);
-			c += f, await i(f, s);
+			if ([429, 503].includes(u.status)) throw new e(t.Busy);
+			let d = Math.max(1e3, a(u.headers.get("retry-after")) ?? 2e3 * 2 ** l);
+			if (l >= n || c + d > r) throw new e(t.Busy);
+			c += d, await i(d, s);
 		}
 	}
 };

package/conversation-overlay.d.ts

@@ -0,0 +1,7 @@
+import { Message } from '@epam/ai-dial-chat-shared';
+import { OverlayChatMessage } from '@epam/ai-dial-chat-overlay';
+
+/** Maps chat messages to the DIAL Chat Overlay protocol's message shape. */
+export declare const toOverlayMessages: (messages: Message[]) => OverlayChatMessage[];
+
+export { }

package/conversation-overlay.js

@@ -0,0 +1,2 @@
+import { toOverlayMessages as e } from "./conversation/overlay-messages.js";
+export { e as toOverlayMessages };

package/conversation.d.ts

@@ -15,7 +15,6 @@ import { Message } from '@epam/ai-dial-chat-shared';
 import { MessageCustomContent } from '@epam/ai-dial-chat-shared';
 import { MessageRating } from '@epam/ai-dial-chat-shared';
 import { MutableRefObject } from 'react';
-import { OverlayChatMessage } from '@epam/ai-dial-chat-overlay';
 import { PublishHistoryEntry } from '@epam/ai-dial-publish-panel';
 import { RateApi } from '@epam/ai-dial-chat-api-client';
 import { ReactNode } from 'react';
@@ -36,6 +35,26 @@ export declare interface AnnouncementContent {
     title: string | null;
     description: string | null;
     html: string | null;
+    /** Entries of the popover the banner opens. */
+    items?: readonly AnnouncementListItem[];
+}
+
+/** One entry of the announcements popover behind the banner's `+N` pill. */
+export declare interface AnnouncementListItem {
+    /** Plain-text heading of the entry. */
+    title: string;
+    /** Supporting copy of the entry, sanitized before it is rendered. */
+    description?: string | null;
+    /** Optional call to action shown at the end of the entry. */
+    link?: AnnouncementListItemLink | null;
+}
+
+/** A link rendered as the call to action of an announcements-popover entry. */
+export declare interface AnnouncementListItemLink {
+    /** Visible text of the call to action. */
+    label: string;
+    /** Absolute `http`/`https` target the call to action opens. */
+    href: string;
 }
 
 /** State and controls returned by `useAsyncConfirmDialog`. */
@@ -95,7 +114,7 @@ export declare enum AudioTranscriptionErrorReason {
     Unavailable = "unavailable",
     /** The recording exceeds the caller's configured size limit. */
     TooLarge = "tooLarge",
-    /** The upstream ASR provider stayed rate-limited or unavailable after retrying. */
+    /** Recognition is rate-limited, unavailable, or exhausted short gateway retries. */
     Busy = "busy",
     /** Recognition failed for any other reason. */
     Failed = "failed"
@@ -107,9 +126,18 @@ export declare enum AudioTranscriptionErrorReason {
  * hidden only while the current announcement produces the same signature, so
  * editing any part of it brings the banner back with no version counter.
  *
+ * Every piece of content the banner surface renders feeds the signature — the
+ * title, the description, and the popover entries behind the pill, which live
+ * inside the banner and are hidden along with it. Publishing a new entry in
+ * that list therefore invalidates an earlier dismissal on its own, even when
+ * the banner line itself is untouched.
+ *
  * A legacy-only announcement returns the raw HTML string — byte-identical to
  * what shipped before the structured fields existed — so dismissals recorded
- * by older builds keep working without a storage migration.
+ * by older builds keep working without a storage migration. `items` is left
+ * out of the payload entirely when the list is empty for the same reason: a
+ * deployment that never configured the popover keeps matching the signatures
+ * its users already have stored.
  */
 export declare const buildAnnouncementSignature: (content: AnnouncementContent) => string;
 
@@ -633,9 +661,6 @@ export declare interface StreamCompletionOptions {
     signal: AbortSignal;
 }
 
-/** Maps chat messages to the DIAL Chat Overlay protocol's message shape. */
-export declare const toOverlayMessages: (messages: Message[]) => OverlayChatMessage[];
-
 /** Request shape the host's selected-deployment recognition call accepts. */
 export declare interface TranscribeWithDeploymentParams {
     audioUrl: string;
@@ -699,8 +724,8 @@ export declare const useAttachmentUpload: ({ filesApi, bucket, onNetworkError, d
 
 /** Parameters for {@link useAttachmentUpload}. */
 export declare interface UseAttachmentUploadParams {
-    /** Already-configured generated-client instance used to upload the file. */
-    filesApi: Pick<FilesApi, 'uploadFile'>;
+    /** Already-configured client; optional listing skips stored names after a conflict. */
+    filesApi: Pick<FilesApi, 'uploadFile'> & Partial<Pick<FilesApi, 'listFiles'>>;
     /** DIAL Core bucket the file is uploaded into. */
     bucket: string | undefined;
     /** Called with batched filenames after a burst of network-error upload failures. */

package/conversation.js

@@ -6,26 +6,25 @@ import { getModelIdFromConversationId as d } from "./conversation/get-model-id-f
 import { getTimeOfDayGreeting as f } from "./conversation/greeting.js";
 import { createDeploymentChangedMessage as p } from "./conversation/message-factory.js";
 import { getLastDeploymentId as m, getLastUserMessageToolConfiguration as h, isMessageStreaming as g, messageHasStages as _, normalizeResponseFormat as v } from "./conversation/message-utils.js";
-import { toOverlayMessages as y } from "./conversation/overlay-messages.js";
-import { getQuickAppConversationStarters as b } from "./conversation/quick-app-conversation-starters.js";
-import { getStarterPopulateText as x, getStartersFromSchema as S } from "./conversation/starter-option.js";
-import { deriveConversationRowActionState as C } from "./conversation/deriveConversationRowActionState/deriveConversationRowActionState.js";
-import { useActiveConversationSync as w } from "./conversation/useActiveConversationSync/useActiveConversationSync.js";
-import { useAsyncConfirmDialog as T } from "./conversation/useAsyncConfirmDialog/useAsyncConfirmDialog.js";
-import { useConversationLookupMaps as E } from "./conversation/useConversationLookupMaps/useConversationLookupMaps.js";
-import { getConversationSource as D, useConversationPanelItems as O } from "./conversation/useConversationPanelItems/useConversationPanelItems.js";
-import { useImportFilePicker as k } from "./conversation/useImportFilePicker/useImportFilePicker.js";
-import { useAttachmentUpload as A } from "./conversation/useAttachmentUpload/useAttachmentUpload.js";
-import { AudioTranscriptionError as j, AudioTranscriptionErrorReason as M } from "./conversation/useTranscribeAudio/audio-transcription-error.js";
-import { useTranscribeAudio as N } from "./conversation/useTranscribeAudio/useTranscribeAudio.js";
-import { attachmentToDto as P, attachmentsToDtos as F } from "./conversation/useConversationHandlers/attachment-to-dto.js";
-import { createMessagePair as I } from "./conversation/useConversationHandlers/message-factory.js";
-import { hasActiveToolConfig as L, isAnswerIncomplete as R, isMessageChanged as z, shouldRerunGenerationOnEdit as B } from "./conversation/useConversationHandlers/message-utils.js";
-import { getStarterConversationText as V, getStarterDisplayText as H, getStarterSubmitText as U } from "./conversation/useConversationHandlers/starter-option.js";
-import { getConversationPath as W } from "./conversation/useConversationStream/conversation-path.js";
-import { useConversationHandlers as G } from "./conversation/useConversationHandlers/useConversationHandlers.js";
-import { isAwaitingGenerationResume as K } from "./conversation/useConversationStream/generation-resume.js";
-import { useConversationStream as q } from "./conversation/useConversationStream/useConversationStream.js";
-import { useChatSettingsFormConfig as J } from "./useChatSettingsFormConfig/useChatSettingsFormConfig.js";
-import { useToolsMenu as Y } from "./useToolsMenu/useToolsMenu.js";
-export { j as AudioTranscriptionError, M as AudioTranscriptionErrorReason, a as DEFAULT_GENERATION_CONFLICT_MESSAGE, o as GenerationConflictError, P as attachmentToDto, F as attachmentsToDtos, e as buildAnnouncementSignature, s as createChatStreamApi, p as createDeploymentChangedMessage, I as createMessagePair, C as deriveConversationRowActionState, l as formatAppVersion, W as getConversationPath, D as getConversationSource, m as getLastDeploymentId, h as getLastUserMessageToolConfiguration, d as getModelIdFromConversationId, b as getQuickAppConversationStarters, V as getStarterConversationText, H as getStarterDisplayText, x as getStarterPopulateText, U as getStarterSubmitText, S as getStartersFromSchema, f as getTimeOfDayGreeting, L as hasActiveToolConfig, t as hasAnnouncementContent, n as hasStructuredAnnouncement, R as isAnswerIncomplete, K as isAwaitingGenerationResume, z as isMessageChanged, g as isMessageStreaming, _ as messageHasStages, v as normalizeResponseFormat, r as sanitizeAnnouncementHtml, i as sanitizeAnnouncementMessageHtml, u as sanitizeFooterHtml, B as shouldRerunGenerationOnEdit, c as shouldWatchForDisplayNameUpdate, y as toOverlayMessages, w as useActiveConversationSync, T as useAsyncConfirmDialog, A as useAttachmentUpload, J as useChatSettingsFormConfig, G as useConversationHandlers, E as useConversationLookupMaps, O as useConversationPanelItems, q as useConversationStream, k as useImportFilePicker, Y as useToolsMenu, N as useTranscribeAudio };
+import { getQuickAppConversationStarters as y } from "./conversation/quick-app-conversation-starters.js";
+import { getStarterPopulateText as b, getStartersFromSchema as x } from "./conversation/starter-option.js";
+import { deriveConversationRowActionState as S } from "./conversation/deriveConversationRowActionState/deriveConversationRowActionState.js";
+import { useActiveConversationSync as C } from "./conversation/useActiveConversationSync/useActiveConversationSync.js";
+import { useAsyncConfirmDialog as w } from "./conversation/useAsyncConfirmDialog/useAsyncConfirmDialog.js";
+import { useConversationLookupMaps as T } from "./conversation/useConversationLookupMaps/useConversationLookupMaps.js";
+import { getConversationSource as E, useConversationPanelItems as D } from "./conversation/useConversationPanelItems/useConversationPanelItems.js";
+import { useImportFilePicker as O } from "./conversation/useImportFilePicker/useImportFilePicker.js";
+import { useAttachmentUpload as k } from "./conversation/useAttachmentUpload/useAttachmentUpload.js";
+import { AudioTranscriptionError as A, AudioTranscriptionErrorReason as j } from "./conversation/useTranscribeAudio/audio-transcription-error.js";
+import { useTranscribeAudio as M } from "./conversation/useTranscribeAudio/useTranscribeAudio.js";
+import { attachmentToDto as N, attachmentsToDtos as P } from "./conversation/useConversationHandlers/attachment-to-dto.js";
+import { createMessagePair as F } from "./conversation/useConversationHandlers/message-factory.js";
+import { hasActiveToolConfig as I, isAnswerIncomplete as L, isMessageChanged as R, shouldRerunGenerationOnEdit as z } from "./conversation/useConversationHandlers/message-utils.js";
+import { getStarterConversationText as B, getStarterDisplayText as V, getStarterSubmitText as H } from "./conversation/useConversationHandlers/starter-option.js";
+import { getConversationPath as U } from "./conversation/useConversationStream/conversation-path.js";
+import { useConversationHandlers as W } from "./conversation/useConversationHandlers/useConversationHandlers.js";
+import { isAwaitingGenerationResume as G } from "./conversation/useConversationStream/generation-resume.js";
+import { useConversationStream as K } from "./conversation/useConversationStream/useConversationStream.js";
+import { useChatSettingsFormConfig as q } from "./useChatSettingsFormConfig/useChatSettingsFormConfig.js";
+import { useToolsMenu as J } from "./useToolsMenu/useToolsMenu.js";
+export { A as AudioTranscriptionError, j as AudioTranscriptionErrorReason, a as DEFAULT_GENERATION_CONFLICT_MESSAGE, o as GenerationConflictError, N as attachmentToDto, P as attachmentsToDtos, e as buildAnnouncementSignature, s as createChatStreamApi, p as createDeploymentChangedMessage, F as createMessagePair, S as deriveConversationRowActionState, l as formatAppVersion, U as getConversationPath, E as getConversationSource, m as getLastDeploymentId, h as getLastUserMessageToolConfiguration, d as getModelIdFromConversationId, y as getQuickAppConversationStarters, B as getStarterConversationText, V as getStarterDisplayText, b as getStarterPopulateText, H as getStarterSubmitText, x as getStartersFromSchema, f as getTimeOfDayGreeting, I as hasActiveToolConfig, t as hasAnnouncementContent, n as hasStructuredAnnouncement, L as isAnswerIncomplete, G as isAwaitingGenerationResume, R as isMessageChanged, g as isMessageStreaming, _ as messageHasStages, v as normalizeResponseFormat, r as sanitizeAnnouncementHtml, i as sanitizeAnnouncementMessageHtml, u as sanitizeFooterHtml, z as shouldRerunGenerationOnEdit, c as shouldWatchForDisplayNameUpdate, C as useActiveConversationSync, w as useAsyncConfirmDialog, k as useAttachmentUpload, q as useChatSettingsFormConfig, W as useConversationHandlers, T as useConversationLookupMaps, D as useConversationPanelItems, K as useConversationStream, O as useImportFilePicker, J as useToolsMenu, M as useTranscribeAudio };