@epam/ai-dial-chat-hooks 1.1.0-dev.256 → 1.1.0-dev.262

package/index.d.ts

@@ -22,5 +22,6 @@ export * from './usePageFileDrag/usePageFileDrag';
 export * from './usePanelMaxWidth/usePanelMaxWidth';
 export * from './useShareLink/useShareLink';
 export * from './useShareRecipientsCount/useShareRecipientsCount';
+export * from './useToolsMenu/useToolsMenu';
 export * from './useViewportWidth/useViewportWidth';
 //# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sDAAsD,CAAC;AACrE,cAAc,8DAA8D,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,0DAA0D,CAAC;AAC3F,OAAO,EACL,YAAY,EACZ,aAAa,GACd,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AAChG,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wDAAwD,CAAC;AACvE,cAAc,4DAA4D,CAAC;AAC3E,OAAO,EACL,iBAAiB,EACjB,eAAe,GAChB,MAAM,0DAA0D,CAAC;AAClE,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,GACjB,MAAM,wDAAwD,CAAC;AAChE,OAAO,EACL,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,uDAAuD,CAAC;AAC/D,cAAc,gEAAgE,CAAC;AAC/E,cAAc,4DAA4D,CAAC;AAC3E,cAAc,4DAA4D,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,0BAA0B,EAAE,MAAM,wDAAwD,CAAC;AACpG,cAAc,4DAA4D,CAAC;AAC3E,cAAc,sEAAsE,CAAC;AACrF,cAAc,uDAAuD,CAAC;AACtE,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mDAAmD,CAAC;AAClE,cAAc,qCAAqC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sDAAsD,CAAC;AACrE,cAAc,8DAA8D,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,0DAA0D,CAAC;AAC3F,OAAO,EACL,YAAY,EACZ,aAAa,GACd,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AAChG,cAAc,4CAA4C,CAAC;AAC3D,cAAc,wDAAwD,CAAC;AACvE,cAAc,4DAA4D,CAAC;AAC3E,OAAO,EACL,iBAAiB,EACjB,eAAe,GAChB,MAAM,0DAA0D,CAAC;AAClE,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,GACjB,MAAM,wDAAwD,CAAC;AAChE,OAAO,EACL,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,uDAAuD,CAAC;AAC/D,cAAc,gEAAgE,CAAC;AAC/E,cAAc,4DAA4D,CAAC;AAC3E,cAAc,4DAA4D,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,0BAA0B,EAAE,MAAM,wDAAwD,CAAC;AACpG,cAAc,4DAA4D,CAAC;AAC3E,cAAc,sEAAsE,CAAC;AACrF,cAAc,uDAAuD,CAAC;AACtE,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,mDAAmD,CAAC;AAClE,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qCAAqC,CAAC"}

package/index.js

@@ -1612,6 +1612,46 @@ var k = (e) => e.startsWith("files/"), A = (e) => e.url != null && k(e.url) || e
 			r.current.delete(e), n(({ [e]: t, ...n }) => n);
 		}, [])
 	};
+}, jt = { deepResearchFallback: "Deep research" }, Mt = (e) => {
+	let { deepResearchToolId: t, selectedItemId: n, selectedDeploymentConfiguration: r } = e, i = _(() => ({
+		...jt,
+		...e.labels
+	}), [e.labels]), a = e.toolIcon, o = _(() => {
+		if (t == null || r == null) return null;
+		let e = r.properties?.[t];
+		return e == null || !(e.type === "boolean" || e.type == null && typeof e.default == "boolean") ? null : e;
+	}, [t, r]), s = _(() => typeof o?.default == "boolean" ? o.default : !1, [o]), [c, l] = y(s);
+	h(() => {
+		l(s);
+	}, [n, s]);
+	let u = m((e) => {
+		e === t && l((e) => !e);
+	}, [t]), d = m((e) => {
+		if (t == null) return;
+		let n = e?.[t];
+		typeof n == "boolean" && l(n);
+	}, [t]);
+	return {
+		toolsMenuItems: _(() => o == null || t == null ? [] : [{
+			id: t,
+			label: typeof o.title == "string" && o.title || i.deepResearchFallback,
+			icon: a ?? null,
+			isSelected: c
+		}], [
+			o,
+			t,
+			c,
+			i,
+			a
+		]),
+		onToolToggle: u,
+		toolConfigurationValue: _(() => t == null || o == null ? {} : { [t]: c }, [
+			t,
+			o,
+			c
+		]),
+		restoreToolConfiguration: d
+	};
 };
 //#endregion
-export { re as AttachmentValidationErrorReason, oe as ConversationExportMode, V as ConversationTransferErrorCode, z as ConversationTransferJobStatus, B as ConversationTransferSubjectKind, H as ConversationTransferWarningCode, U as EXPORT_APP_NAME, R as ExportFileNameKind, Ot as RecipientsCountStatus, Re as attachmentToDto, J as attachmentsToDtos, Y as createMessagePair, j as downloadAttachment, L as formatDateYM, ae as formatDateYMD, xe as formatQuotedNameList, Q as getConversationPath, Ve as getStarterConversationText, He as getStarterSubmitText, X as hasActiveToolConfig, $ as isAwaitingGenerationResume, k as isDialFileId, A as isDownloadableAttachment, ze as isMessageChanged, P as useAttachmentAction, Oe as useAttachmentUpload, ie as useAttachmentValidation, bt as useChatSettingsFormConfig, Le as useConversationExport, Ue as useConversationHandlers, ot as useConversationImport, lt as useConversationScroll, _t as useConversationSources, ht as useConversationStream, xt as usePageFileDrag, wt as usePanelMaxWidth, Dt as useShareLink, At as useShareRecipientsCount, Ct as useViewportWidth };
+export { re as AttachmentValidationErrorReason, oe as ConversationExportMode, V as ConversationTransferErrorCode, z as ConversationTransferJobStatus, B as ConversationTransferSubjectKind, H as ConversationTransferWarningCode, U as EXPORT_APP_NAME, R as ExportFileNameKind, Ot as RecipientsCountStatus, Re as attachmentToDto, J as attachmentsToDtos, Y as createMessagePair, j as downloadAttachment, L as formatDateYM, ae as formatDateYMD, xe as formatQuotedNameList, Q as getConversationPath, Ve as getStarterConversationText, He as getStarterSubmitText, X as hasActiveToolConfig, $ as isAwaitingGenerationResume, k as isDialFileId, A as isDownloadableAttachment, ze as isMessageChanged, P as useAttachmentAction, Oe as useAttachmentUpload, ie as useAttachmentValidation, bt as useChatSettingsFormConfig, Le as useConversationExport, Ue as useConversationHandlers, ot as useConversationImport, lt as useConversationScroll, _t as useConversationSources, ht as useConversationStream, xt as usePageFileDrag, wt as usePanelMaxWidth, Dt as useShareLink, At as useShareRecipientsCount, Mt as useToolsMenu, Ct as useViewportWidth };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@epam/ai-dial-chat-hooks",
   "description": "Framework-level React hooks extracted from AI DIAL Chat for building custom chat interfaces",
-  "version": "1.1.0-dev.256",
+  "version": "1.1.0-dev.262",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -17,14 +17,14 @@
   },
   "peerDependencies": {
     "react": "^19.2.6",
-    "@epam/ai-dial-attachment-canvas": "1.1.0-dev.256",
-    "@epam/ai-dial-attachment-input": "1.1.0-dev.256",
-    "@epam/ai-dial-chat-api-client": "1.1.0-dev.256",
-    "@epam/ai-dial-chat-shared": "1.1.0-dev.256",
-    "@epam/ai-dial-quotations": "1.1.0-dev.256",
+    "@epam/ai-dial-attachment-canvas": "1.1.0-dev.262",
+    "@epam/ai-dial-attachment-input": "1.1.0-dev.262",
+    "@epam/ai-dial-chat-api-client": "1.1.0-dev.262",
+    "@epam/ai-dial-chat-shared": "1.1.0-dev.262",
+    "@epam/ai-dial-quotations": "1.1.0-dev.262",
     "@epam/ai-dial-react-file-manager": "*",
-    "@epam/ai-dial-share": "1.1.0-dev.256",
-    "@epam/ai-dial-source-panel": "1.1.0-dev.256",
+    "@epam/ai-dial-share": "1.1.0-dev.262",
+    "@epam/ai-dial-source-panel": "1.1.0-dev.262",
     "fflate": "^0.8.3"
   },
   "repository": {

package/useToolsMenu/useToolsMenu.d.ts

@@ -0,0 +1,40 @@
+import { DeploymentConfigurationSchema, ToolMenuItem } from '@epam/ai-dial-chat-shared';
+import { ReactNode } from 'react';
+/** Translatable strings the tools menu surfaces. */
+export interface ToolsMenuLabels {
+    /** Fallback label for the deep-research tool when the schema defines no `title`. */
+    deepResearchFallback: string;
+}
+/** Host-supplied inputs to {@link useToolsMenu}. */
+export interface UseToolsMenuParams {
+    /** Operator-configured deep-research tool id, or `null` when none is configured. */
+    deepResearchToolId: string | null;
+    /** Id of the currently selected deployment, or `null` when none is selected. */
+    selectedItemId: string | null;
+    /** JSON-schema configuration for the selected deployment, or `null` when none. */
+    selectedDeploymentConfiguration: DeploymentConfigurationSchema | null;
+    /** Translated labels. Fields not provided fall back to English defaults. */
+    labels?: Partial<ToolsMenuLabels>;
+    /** Icon element rendered on the tool menu item. Defaults to `null`. */
+    toolIcon?: ReactNode;
+}
+/** Result returned by {@link useToolsMenu}. */
+export type UseToolsMenuResult = {
+    /** Derived submenu items (empty until a boolean tool property is found). */
+    toolsMenuItems: ToolMenuItem[];
+    /** Toggles the tool with the given id; ignores unknown ids. */
+    onToolToggle: (id: string) => void;
+    /** Stable record of tool ids to their current on/off state, for completion requests. */
+    toolConfigurationValue: Record<string, boolean>;
+    /** Restores toggle state from a persisted tool configuration record. */
+    restoreToolConfiguration: (configurationValue: Record<string, unknown> | undefined) => void;
+};
+/**
+ * Derives the tools submenu from the active deployment's configuration schema
+ * and the operator-configured tool id. Manages toggle state locally, resets on
+ * deployment change, and exposes a stable `toolConfigurationValue` record for
+ * inclusion in completion requests. Headless: translation and the tool icon are
+ * the host's responsibility, supplied via `labels` and `toolIcon`.
+ */
+export declare const useToolsMenu: (params: UseToolsMenuParams) => UseToolsMenuResult;
+//# sourceMappingURL=useToolsMenu.d.ts.map

package/useToolsMenu/useToolsMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToolsMenu.d.ts","sourceRoot":"","sources":["../../src/useToolsMenu/useToolsMenu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,YAAY,EACb,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAEf,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,oFAAoF;IACpF,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,gFAAgF;IAChF,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kFAAkF;IAClF,+BAA+B,EAAE,6BAA6B,GAAG,IAAI,CAAC;IACtE,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAClC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,+CAA+C;AAC/C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,4EAA4E;IAC5E,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,+DAA+D;IAC/D,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,wFAAwF;IACxF,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,wEAAwE;IACxE,wBAAwB,EAAE,CACxB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,KACpD,IAAI,CAAC;CACX,CAAC;AAMF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GACvB,QAAQ,kBAAkB,KACzB,kBA0FF,CAAC"}