@epam/ai-dial-chat-hooks 1.3.0-dev.35 → 1.3.0-dev.354

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

@@ -2,9 +2,9 @@ import { safeDecodeURIComponent as e, stripSurroundingSlashes as t } from "../sh
 import { formatCalendarDate as n } from "../shared/formatting.js";
 import { SKILL_FOLDER_MARKER as r } from "../skill/skill.js";
 import { SkillSource as i } from "../skill/skill-types.js";
-import { CatalogEntityType as a, formatLastUsed as o } from "@epam/ai-dial-chat-shared";
-import { CatalogContentNodeType as s } from "@epam/ai-dial-catalog";
-import { SkillMetadataItemDtoNodeTypeEnum as c } from "@epam/ai-dial-chat-api-client";
+import { SkillMetadataItemDtoNodeTypeEnum as a } from "@epam/ai-dial-chat-api-client";
+import { CatalogEntityType as o, formatLastUsed as s } from "@epam/ai-dial-chat-shared";
+import { CatalogContentNodeType as c } from "@epam/ai-dial-catalog";
 //#region src/catalog/map-skill-to-catalog-item.ts
 var l = {
 	[i.Personal]: "personal",
@@ -14,28 +14,28 @@ var l = {
 	let r = (n ?? "").split("/").filter(Boolean), i = t.split("/").filter(Boolean).slice(2, -1);
 	return i.length === r.length ? i.map(e) : r;
 }, d = (e, t, n) => [n[l[t]], ...u(e.url, e.parentPath)], f = (e, { folderLabels: t, source: n, favoriteIds: r }) => {
-	let s = r.has(e.url), c = n === i.Public, l = n === i.Personal;
+	let a = r.has(e.url), c = n === i.Public, l = n === i.Personal;
 	return {
 		id: e.url,
-		type: a.Skill,
+		type: o.Skill,
 		name: e.name,
 		description: e.description ?? "",
 		version: "",
-		lastUsed: o(e.updatedAt),
+		lastUsed: s(e.updatedAt),
 		createdAt: e.createdAt,
 		updatedAt: e.updatedAt,
 		isFeatured: !1,
 		isHidden: !1,
 		topics: [],
-		isUserFavorite: s,
-		isStarred: s,
+		isUserFavorite: a,
+		isStarred: a,
 		isMyApp: l && (e.isMy ?? !0),
 		sharedWithMe: e.sharedWithMe ?? n === i.SharedWithMe,
 		isEditable: !c && (e.canEdit ?? l),
 		folder: d(e, n, t)
 	};
 }, p = (e) => e.join(" · "), m = (e, t) => {
-	if (e == null) return null;
+	if (e == null) return [];
 	let n = [];
 	return e.whenToUse != null && n.push({
 		label: t.whenToUseLabel,
@@ -46,11 +46,8 @@ var l = {
 	}), e.bundledResources?.length && n.push({
 		label: t.bundledResourcesLabel,
 		value: p(e.bundledResources)
-	}), n.length === 0 ? null : {
-		title: t.specificationSectionTitle,
-		specs: n
-	};
-}, h = (e) => e.filter((e) => e.nodeType === c.Item), g = (e, n) => {
+	}), n;
+}, h = (e) => e.filter((e) => e.nodeType === a.Item), g = (e, n) => {
 	let r = t(n), i = r ? `${r}/files` : "files";
 	return h(e).find((e) => {
 		let n = t(e.path);
@@ -60,28 +57,26 @@ var l = {
 	let r = t(e), i = t(n), a = i ? `${i}/files` : "files";
 	return r === "" || r === "files" || r === a ? null : r.startsWith(`${a}/`) ? r.slice(a.length + 1) : r.startsWith("files/") ? r.slice(6) : r;
 }, v = (e, t) => _(e, t), y = (e, t, r, i) => {
-	let a = [], o = m(r, i);
-	o != null && a.push(o);
-	let s = [];
-	return e?.author && s.push({
+	let a = m(r, i);
+	return e?.author && a.push({
 		label: i.authorLabel,
 		value: e.author
-	}), s.push({
+	}), a.push({
 		label: i.updatedLabel,
 		value: e?.updatedAt ? n(e.updatedAt) : ""
-	}), s.push({
+	}), a.push({
 		label: i.fileCountLabel,
 		value: String(h(t).length)
-	}), a.push({
-		title: i.detailsSectionTitle,
-		specs: s
-	}), { sections: a };
+	}), { sections: [{
+		title: i.specificationSectionTitle,
+		specs: a
+	}] };
 }, b = (e, t, n) => {
 	if (e === "") return n;
 	let r = t.get(e);
 	if (r != null) return r.items;
 	let i = e.split("/"), a = b(i.slice(0, -1).join("/"), t, n), o = {
-		type: s.Folder,
+		type: c.Folder,
 		id: e,
 		name: i[i.length - 1],
 		items: []
@@ -95,25 +90,21 @@ var l = {
 		}
 		return e.name.localeCompare(n.name);
 	});
-	for (let t of e) t.type === s.Folder && x(t.items, !1);
+	for (let t of e) t.type === c.Folder && x(t.items, !1);
 }, S = (e, t) => {
 	let n = /* @__PURE__ */ new Map(), i = [];
-	for (let a of e) {
-		let e = _(a.path, t);
+	for (let o of e) {
+		let e = _(o.path, t);
 		if (e == null) continue;
-		if (a.nodeType === c.Folder) {
+		if (o.nodeType === a.Folder) {
 			b(e, n, i);
 			continue;
 		}
-		let o = e.lastIndexOf("/"), l = o === -1 ? "" : e.slice(0, o);
-		if (a.name === r) {
-			b(l, n, i);
-			continue;
-		}
-		b(l, n, i).push({
-			type: s.File,
-			id: a.path,
-			name: a.name
+		let s = e.lastIndexOf("/"), l = s === -1 ? "" : e.slice(0, s);
+		o.name === r ? b(l, n, i) : b(l, n, i).push({
+			type: c.File,
+			id: o.path,
+			name: o.name
 		});
 	}
 	return x(i, !0), i;

package/catalog/mcp-endpoint-url.d.ts

@@ -0,0 +1,18 @@
+import { CatalogItemApiDetails } from '@epam/ai-dial-catalog';
+import { CatalogEntityType } from '@epam/ai-dial-chat-shared';
+/** Resource families that DIAL Core exposes an MCP endpoint for. */
+export declare enum McpResourceKind {
+    /** Toolsets, served under `/v1/toolset/{id}/mcp`. */
+    Toolset = "toolset",
+    /** Application deployments, served under `/v1/deployments/{id}/mcp`. */
+    Application = "application"
+}
+/** Builds the MCP endpoint URL for a toolset resource. */
+export declare const buildToolsetMcpUrl: (baseUrl: string, id: string) => string;
+/** Builds the MCP endpoint URL for an application-deployment resource. */
+export declare const buildApplicationMcpUrl: (baseUrl: string, id: string) => 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;
+/** Builds the "Connect" tab's resource/endpoint/snippet data for the MCP endpoint of the given resource kind. */
+export declare const buildConnectApi: (baseUrl: string, id: string, kind: McpResourceKind) => CatalogItemApiDetails;
+//# sourceMappingURL=mcp-endpoint-url.d.ts.map

package/catalog/mcp-endpoint-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-endpoint-url.d.ts","sourceRoot":"","sources":["../../src/catalog/mcp-endpoint-url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,oEAAoE;AACpE,oBAAY,eAAe;IACzB,qDAAqD;IACrD,OAAO,YAAY;IACnB,wEAAwE;IACxE,WAAW,gBAAgB;CAC5B;AAmBD,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,GAAI,SAAS,MAAM,EAAE,IAAI,MAAM,KAAG,MACY,CAAC;AAE9E,0EAA0E;AAC1E,eAAO,MAAM,sBAAsB,GAAI,SAAS,MAAM,EAAE,IAAI,MAAM,KAAG,MACY,CAAC;AAUlF,mIAAmI;AACnI,eAAO,MAAM,sBAAsB,GACjC,MAAM,iBAAiB,EACvB,cAAc,OAAO,KACpB,eAAe,GAAG,IAMpB,CAAC;AAEF,iHAAiH;AACjH,eAAO,MAAM,eAAe,GAC1B,SAAS,MAAM,EACf,IAAI,MAAM,EACV,MAAM,eAAe,KACpB,qBAWF,CAAC"}

package/catalog/publish.d.ts

@@ -0,0 +1,35 @@
+import { PublishConversationResultDto, PublishHistoryEntryDto } from '@epam/ai-dial-chat-api-client';
+import { CatalogEntityType } from '@epam/ai-dial-chat-shared';
+import { PublishHistoryEntry } from '@epam/ai-dial-publish-panel';
+/**
+ * The publish API's entity-type path param values. Re-declared as a plain
+ * string-literal union rather than importing the generated
+ * `PublishCatalogEntityEntityTypeEnum`, so this module has no dependency on
+ * the app's own `server-api` layer.
+ */
+export type CatalogPublishEntityType = 'model' | 'toolset' | 'application' | 'prompt' | 'skill' | 'project';
+/** Maps a catalog item's entity type to the publish API's entity-type path param, or `undefined` if that type is not publishable. */
+export declare const toPublishEntityType: (type: CatalogEntityType) => CatalogPublishEntityType | undefined;
+/**
+ * Whether a catalog entity id addresses the shared `public` bucket
+ * (`{resourceType}/public/{folder…}/{name}`), i.e. the id names a published
+ * copy rather than the author's own source item.
+ *
+ * The bucket is always the second segment, so a personal item that happens to
+ * own a folder called `public` (`applications/{bucket}/public/{name}`) is not
+ * matched. An id with no bucket segment at all — a plain model id such as
+ * `gpt-4` — is not public.
+ */
+export declare const isPublicCatalogEntityId: (entityId: string) => boolean;
+/**
+ * The publish folder a public catalog entity id sits in: the segments between
+ * the `public` bucket and the entity name, decoded to the plain text the
+ * publish API takes. Empty for a copy published at the public root, and for an
+ * id that is not public at all.
+ */
+export declare const getPublicCatalogEntityFolderPath: (entityId: string) => string[];
+/** Maps a publish-history API response entry to the catalog lib's `PublishHistoryEntry` model. */
+export declare const mapPublishHistoryEntryDto: (dto: PublishHistoryEntryDto) => PublishHistoryEntry;
+/** Maps a conversation publish-history API response entry to the publish panel's `PublishHistoryEntry` model. */
+export declare const mapPublishConversationResultDto: (dto: PublishConversationResultDto) => PublishHistoryEntry;
+//# sourceMappingURL=publish.d.ts.map

package/catalog/publish.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../src/catalog/publish.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAC5B,sBAAsB,EACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAiB,MAAM,2BAA2B,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAGvE;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAClC,OAAO,GAAG,SAAS,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAYvE,qIAAqI;AACrI,eAAO,MAAM,mBAAmB,GAC9B,MAAM,iBAAiB,KACtB,wBAAwB,GAAG,SAA2C,CAAC;AAE1E;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,GAAI,UAAU,MAAM,KAAG,OACjB,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,GAAI,UAAU,MAAM,KAAG,MAAM,EAGlE,CAAC;AAET,kGAAkG;AAClG,eAAO,MAAM,yBAAyB,GACpC,KAAK,sBAAsB,KAC1B,mBAKD,CAAC;AAEH,iHAAiH;AACjH,eAAO,MAAM,+BAA+B,GAC1C,KAAK,4BAA4B,KAChC,mBAKD,CAAC"}

package/catalog/resource-folder.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Returns the plain-text folder segments of a personal resource id
+ * `{type}/{bucket}/{folder…}/{name}`, e.g. `['Design', 'Audit']` for
+ * `applications/b1/Design/Audit/agent__1.0.0`; `[]` at the bucket root or
+ * for an id that is not a full resource id.
+ */
+export declare const parseResourceFolderPath: (resourceId: string) => string[];
+//# sourceMappingURL=resource-folder.d.ts.map

package/catalog/resource-folder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-folder.d.ts","sourceRoot":"","sources":["../../src/catalog/resource-folder.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,YAAY,MAAM,KAAG,MAAM,EAKlE,CAAC"}

package/catalog/resource-folder.js

@@ -0,0 +1,13 @@
+//#region src/catalog/resource-folder.ts
+var e = (e) => {
+	try {
+		return decodeURIComponent(e);
+	} catch {
+		return e;
+	}
+}, t = (t) => {
+	let n = t.split("/");
+	return n.length <= 3 ? [] : n.slice(2, -1).map(e);
+};
+//#endregion
+export { t as parseResourceFolderPath };

package/catalog/resource-save-adapter.d.ts

@@ -0,0 +1,36 @@
+import { CatalogPublishEntityType } from './publish';
+/** What a save step produced: the full id of the resource it wrote. */
+export interface SavedResource {
+    /** Full DIAL Core id `{type}/{bucket}/{path}`. */
+    id: string;
+}
+/** The operations the Save panel runs for a resource that already exists, supplied by each editor. */
+export interface ResourceEditSaveAdapter {
+    /** The publish API entity type of the resource. */
+    publishEntityType: CatalogPublishEntityType;
+    /** Whether the resource has versions; an unversioned one never forks. */
+    isVersioned: boolean;
+    /** Saves the editor's current state in place; the editor's existing Save. */
+    saveInPlace: () => Promise<SavedResource>;
+    /** Writes the edits as `{folderPath}/{name}__{version}`, leaving the stored current version unchanged. Required when `isVersioned`. */
+    saveAsNewVersion?: (version: string, folderPath: string[]) => Promise<SavedResource>;
+    /** Moves a saved resource into `folderPath` of the user's own bucket. */
+    move: (id: string, folderPath: string[]) => Promise<SavedResource>;
+}
+/** The operation the Save panel runs for a resource being created, supplied by each editor. */
+export interface ResourceCreateSaveAdapter {
+    /** The publish API entity type of the resource. */
+    publishEntityType: CatalogPublishEntityType;
+    /** Always `false`: a new resource takes its version from the form, so the panel offers no version choice. */
+    isVersioned: false;
+    /** Creates the resource in `folderPath` of the user's own bucket, never overwriting an existing one. */
+    createIn: (folderPath: string[]) => Promise<SavedResource>;
+}
+/** The resource-specific operations the Save panel runs. */
+export type ResourceSaveAdapter = ResourceEditSaveAdapter | ResourceCreateSaveAdapter;
+/** Returns whether `adapter` creates a new resource rather than saving an existing one. */
+export declare const isResourceCreateAdapter: (adapter: ResourceSaveAdapter) => adapter is ResourceCreateSaveAdapter;
+/** A save failure whose `message` is already translated for the user, e.g. a half-finished version commit. */
+export declare class ResourceSaveError extends Error {
+}
+//# sourceMappingURL=resource-save-adapter.d.ts.map

package/catalog/resource-save-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-save-adapter.d.ts","sourceRoot":"","sources":["../../src/catalog/resource-save-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAE1D,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,sGAAsG;AACtG,MAAM,WAAW,uBAAuB;IACtC,mDAAmD;IACnD,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,yEAAyE;IACzE,WAAW,EAAE,OAAO,CAAC;IACrB,6EAA6E;IAC7E,WAAW,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1C,uIAAuI;IACvI,gBAAgB,CAAC,EAAE,CACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAAE,KACjB,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5B,yEAAyE;IACzE,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;CACpE;AAED,+FAA+F;AAC/F,MAAM,WAAW,yBAAyB;IACxC,mDAAmD;IACnD,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,6GAA6G;IAC7G,WAAW,EAAE,KAAK,CAAC;IACnB,wGAAwG;IACxG,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;CAC5D;AAED,4DAA4D;AAC5D,MAAM,MAAM,mBAAmB,GAC7B,uBAAuB,GAAG,yBAAyB,CAAC;AAEtD,2FAA2F;AAC3F,eAAO,MAAM,uBAAuB,GAClC,SAAS,mBAAmB,KAC3B,OAAO,IAAI,yBAAkD,CAAC;AAEjE,8GAA8G;AAC9G,qBAAa,iBAAkB,SAAQ,KAAK;CAAG"}

package/catalog/resource-save-adapter.js

@@ -0,0 +1,4 @@
+//#region src/catalog/resource-save-adapter.ts
+var e = (e) => "createIn" in e, t = class extends Error {};
+//#endregion
+export { t as ResourceSaveError, e as isResourceCreateAdapter };

package/catalog/resource-save-adapters.d.ts

@@ -0,0 +1,93 @@
+import { ApplicationsApi, CreatePromptDto, PromptsApi, ResourceFoldersResponseDto, SkillsApi, ToolsetBodyDto, ToolsetsApi, UpdatePromptDto } from '@epam/ai-dial-chat-api-client';
+import { ResourceCreateSaveAdapter, ResourceEditSaveAdapter } from './resource-save';
+/** The application operations the application save adapters call. */
+export type ResourceSaveApplicationsApi = Pick<ApplicationsApi, 'moveApplication' | 'forkApplicationVersion' | 'commitApplicationVersion' | 'deleteApplication'>;
+/** The toolset operations {@link createToolsetSaveAdapter} calls. */
+export type ResourceSaveToolsetsApi = Pick<ToolsetsApi, 'updateToolset' | 'createToolset' | 'moveToolset'>;
+/** The prompt operations the prompt save adapters and {@link createPromptFolderLister} call. */
+export type ResourceSavePromptsApi = Pick<PromptsApi, 'listPrompts' | 'createPrompt' | 'updatePrompt' | 'movePrompt'>;
+/** Parameters for {@link createEmbeddedApplicationSaveAdapter}. */
+export interface EmbeddedApplicationSaveAdapterParams {
+    /** Configured applications client. */
+    applicationsApi: ResourceSaveApplicationsApi;
+    /** Full id of the edited application. */
+    applicationId: string;
+    /** Runs the embedded editor's own save of the edited application. */
+    runEmbeddedSave: () => Promise<void>;
+    /** Translated message for a fork whose commit failed, naming the new version. */
+    getCommitFailedMessage: (version: string) => string;
+}
+/** Parameters for {@link createHostApplicationSaveAdapter}. */
+export interface HostApplicationSaveAdapterParams {
+    /** Configured applications client. */
+    applicationsApi: Pick<ResourceSaveApplicationsApi, 'moveApplication'>;
+    /** Full id of the edited application. */
+    applicationId: string;
+    /** Writes the edited values to the application in place. */
+    update: () => Promise<unknown>;
+    /** Creates the edited values as a new application with `version` in `folderPath`, never overwriting. */
+    createVersion: (version: string, folderPath: string[]) => Promise<{
+        id?: string;
+    } | void>;
+}
+/** Parameters for {@link createToolsetSaveAdapter}. */
+export interface ToolsetSaveAdapterParams {
+    /** Configured toolsets client. */
+    toolsetsApi: ResourceSaveToolsetsApi;
+    /** Full id of the edited toolset. */
+    toolsetId: string;
+    /** The edited values, already mapped to the write body. */
+    body: ToolsetBodyDto;
+}
+/** Parameters for {@link createPromptSaveAdapter}. */
+export interface PromptSaveAdapterParams {
+    /** Configured prompts client. */
+    promptsApi: Pick<ResourceSavePromptsApi, 'updatePrompt' | 'movePrompt'>;
+    /** Full id of the edited prompt. */
+    promptId: string;
+    /** The edited values. */
+    body: UpdatePromptDto;
+}
+/**
+ * Save operations for an application whose embedded editor is the single
+ * writer (Quick Apps). A new version is a fork of the stored application,
+ * the editor's save to the original, then a commit that swaps the two
+ * bodies, so the edits land in the new version and the original keeps its
+ * last saved content.
+ */
+export declare const createEmbeddedApplicationSaveAdapter: ({ applicationsApi, applicationId, runEmbeddedSave, getCommitFailedMessage, }: EmbeddedApplicationSaveAdapterParams) => ResourceEditSaveAdapter;
+/**
+ * Save operations for an application the host writes itself (schema-form
+ * and custom apps). A new version is a create-only write of the edited
+ * values, so the stored current version is never touched.
+ */
+export declare const createHostApplicationSaveAdapter: ({ applicationsApi, applicationId, update, createVersion, }: HostApplicationSaveAdapterParams) => ResourceEditSaveAdapter;
+/** Save operations for a toolset; a new version is a create-only write into the chosen folder. */
+export declare const createToolsetSaveAdapter: ({ toolsetsApi, toolsetId, body, }: ToolsetSaveAdapterParams) => ResourceEditSaveAdapter;
+/** Save operations for a prompt: unversioned, so it is updated in place and then moved when its folder changes. */
+export declare const createPromptSaveAdapter: ({ promptsApi, promptId, body, }: PromptSaveAdapterParams) => ResourceEditSaveAdapter;
+/** Parameters for {@link createToolsetCreateAdapter}. */
+export interface ToolsetCreateAdapterParams {
+    /** Configured toolsets client. */
+    toolsetsApi: Pick<ResourceSaveToolsetsApi, 'createToolset'>;
+    /** The new toolset's values, already mapped to the write body. */
+    body: ToolsetBodyDto;
+}
+/** Parameters for {@link createPromptCreateAdapter}. */
+export interface PromptCreateAdapterParams {
+    /** Configured prompts client. */
+    promptsApi: Pick<ResourceSavePromptsApi, 'createPrompt'>;
+    /** The new prompt's values; its folder comes from the panel. */
+    body: Omit<CreatePromptDto, 'folderId'>;
+}
+/** Creates a new toolset in the chosen Personal folder, never overwriting an existing one. */
+export declare const createToolsetCreateAdapter: ({ toolsetsApi, body, }: ToolsetCreateAdapterParams) => ResourceCreateSaveAdapter;
+/** Creates a new prompt in the chosen Personal folder. */
+export declare const createPromptCreateAdapter: ({ promptsApi, body, }: PromptCreateAdapterParams) => ResourceCreateSaveAdapter;
+/** Returns a lister of the caller's prompt folders directly under `path` (plain text, `''` for the root). */
+export declare const createPromptFolderLister: (promptsApi: Pick<ResourceSavePromptsApi, "listPrompts">) => (path: string) => Promise<ResourceFoldersResponseDto>;
+/** The skill operation {@link createSkillFolderLister} calls. */
+export type ResourceSaveSkillsApi = Pick<SkillsApi, 'listSkills'>;
+/** Returns a lister of the grouping folders directly under `path` (plain text, `''` for the root) of the caller's skills in `bucket`. */
+export declare const createSkillFolderLister: (skillsApi: ResourceSaveSkillsApi, bucket: string) => (path: string) => Promise<ResourceFoldersResponseDto>;
+//# sourceMappingURL=resource-save-adapters.d.ts.map

package/catalog/resource-save-adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-save-adapters.d.ts","sourceRoot":"","sources":["../../src/catalog/resource-save-adapters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,UAAU,EACV,0BAA0B,EAC1B,SAAS,EACT,cAAc,EACd,WAAW,EACX,eAAe,EAChB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAE7B,MAAM,iBAAiB,CAAC;AAEzB,qEAAqE;AACrE,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC5C,eAAe,EACb,iBAAiB,GACjB,wBAAwB,GACxB,0BAA0B,GAC1B,mBAAmB,CACtB,CAAC;AAEF,qEAAqE;AACrE,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACxC,WAAW,EACX,eAAe,GAAG,eAAe,GAAG,aAAa,CAClD,CAAC;AAEF,gGAAgG;AAChG,MAAM,MAAM,sBAAsB,GAAG,IAAI,CACvC,UAAU,EACV,aAAa,GAAG,cAAc,GAAG,cAAc,GAAG,YAAY,CAC/D,CAAC;AAEF,mEAAmE;AACnE,MAAM,WAAW,oCAAoC;IACnD,sCAAsC;IACtC,eAAe,EAAE,2BAA2B,CAAC;IAC7C,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,eAAe,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,iFAAiF;IACjF,sBAAsB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CACrD;AAED,+DAA+D;AAC/D,MAAM,WAAW,gCAAgC;IAC/C,sCAAsC;IACtC,eAAe,EAAE,IAAI,CAAC,2BAA2B,EAAE,iBAAiB,CAAC,CAAC;IACtE,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,wGAAwG;IACxG,aAAa,EAAE,CACb,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAAE,KACjB,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;CACtC;AAED,uDAAuD;AACvD,MAAM,WAAW,wBAAwB;IACvC,kCAAkC;IAClC,WAAW,EAAE,uBAAuB,CAAC;IACrC,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,sDAAsD;AACtD,MAAM,WAAW,uBAAuB;IACtC,iCAAiC;IACjC,UAAU,EAAE,IAAI,CAAC,sBAAsB,EAAE,cAAc,GAAG,YAAY,CAAC,CAAC;IACxE,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,IAAI,EAAE,eAAe,CAAC;CACvB;AAUD;;;;;;GAMG;AACH,eAAO,MAAM,oCAAoC,GAAI,8EAKlD,oCAAoC,KAAG,uBA+BxC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,GAAI,4DAK9C,gCAAgC,KAAG,uBAapC,CAAC;AAEH,kGAAkG;AAClG,eAAO,MAAM,wBAAwB,GAAI,mCAItC,wBAAwB,KAAG,uBAmB5B,CAAC;AAEH,mHAAmH;AACnH,eAAO,MAAM,uBAAuB,GAAI,iCAIrC,uBAAuB,KAAG,uBAW3B,CAAC;AAEH,yDAAyD;AACzD,MAAM,WAAW,0BAA0B;IACzC,kCAAkC;IAClC,WAAW,EAAE,IAAI,CAAC,uBAAuB,EAAE,eAAe,CAAC,CAAC;IAC5D,kEAAkE;IAClE,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,wDAAwD;AACxD,MAAM,WAAW,yBAAyB;IACxC,iCAAiC;IACjC,UAAU,EAAE,IAAI,CAAC,sBAAsB,EAAE,cAAc,CAAC,CAAC;IACzD,gEAAgE;IAChE,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;CACzC;AAED,8FAA8F;AAC9F,eAAO,MAAM,0BAA0B,GAAI,wBAGxC,0BAA0B,KAAG,yBAW9B,CAAC;AAEH,0DAA0D;AAC1D,eAAO,MAAM,yBAAyB,GAAI,uBAGvC,yBAAyB,KAAG,yBAU7B,CAAC;AAEH,6GAA6G;AAC7G,eAAO,MAAM,wBAAwB,GAClC,YAAY,IAAI,CAAC,sBAAsB,EAAE,aAAa,CAAC,MACjD,MAAM,MAAM,KAAG,OAAO,CAAC,0BAA0B,CAcvD,CAAC;AAEJ,iEAAiE;AACjE,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AAElE,yIAAyI;AACzI,eAAO,MAAM,uBAAuB,GACjC,WAAW,qBAAqB,EAAE,QAAQ,MAAM,MAC1C,MAAM,MAAM,KAAG,OAAO,CAAC,0BAA0B,CAuBvD,CAAC"}

package/catalog/resource-save-adapters.js

@@ -0,0 +1,116 @@
+import { ResourceSaveError as e } from "./resource-save-adapter.js";
+//#region src/catalog/resource-save-adapters.ts
+var t = (e) => (t, n) => e.moveApplication({
+	applicationName: t,
+	moveResourceDto: { folderPath: n.join("/") }
+}), n = ({ applicationsApi: n, applicationId: r, runEmbeddedSave: i, getCommitFailedMessage: a }) => ({
+	publishEntityType: "application",
+	isVersioned: !0,
+	saveInPlace: async () => (await i(), { id: r }),
+	saveAsNewVersion: async (t, o) => {
+		let { id: s } = await n.forkApplicationVersion({
+			applicationName: r,
+			forkApplicationVersionDto: {
+				version: t,
+				folderPath: o.join("/")
+			}
+		});
+		try {
+			await i();
+		} catch (e) {
+			throw await n.deleteApplication({ applicationName: s }).catch(() => void 0), e;
+		}
+		try {
+			return await n.commitApplicationVersion({
+				applicationName: r,
+				commitApplicationVersionDto: { snapshotId: s }
+			});
+		} catch {
+			throw new e(a(t));
+		}
+	},
+	move: t(n)
+}), r = ({ applicationsApi: e, applicationId: n, update: r, createVersion: i }) => ({
+	publishEntityType: "application",
+	isVersioned: !0,
+	saveInPlace: async () => (await r(), { id: n }),
+	saveAsNewVersion: async (e, t) => {
+		let n = await i(e, t);
+		if (!n?.id) throw Error("Created version has no id");
+		return { id: n.id };
+	},
+	move: t(e)
+}), i = ({ toolsetsApi: e, toolsetId: t, body: n }) => ({
+	publishEntityType: "toolset",
+	isVersioned: !0,
+	saveInPlace: () => e.updateToolset({
+		toolsetName: t,
+		toolsetBodyDto: n
+	}),
+	saveAsNewVersion: (t, r) => e.createToolset({ createToolsetBodyDto: {
+		...n,
+		version: t,
+		createOnly: !0,
+		...r.length > 0 ? { folderPath: r.join("/") } : {}
+	} }),
+	move: (t, n) => e.moveToolset({
+		toolsetName: t,
+		moveResourceDto: { folderPath: n.join("/") }
+	})
+}), a = ({ promptsApi: e, promptId: t, body: n }) => ({
+	publishEntityType: "prompt",
+	isVersioned: !1,
+	saveInPlace: () => e.updatePrompt({
+		id: t,
+		updatePromptDto: n
+	}),
+	move: (t, n) => e.movePrompt({
+		id: t,
+		movePromptDto: { targetFolderId: n.join("/") }
+	})
+}), o = ({ toolsetsApi: e, body: t }) => ({
+	publishEntityType: "toolset",
+	isVersioned: !1,
+	createIn: (n) => e.createToolset({ createToolsetBodyDto: {
+		...t,
+		createOnly: !0,
+		...n.length > 0 ? { folderPath: n.join("/") } : {}
+	} })
+}), s = ({ promptsApi: e, body: t }) => ({
+	publishEntityType: "prompt",
+	isVersioned: !1,
+	createIn: (n) => e.createPrompt({ createPromptDto: {
+		...t,
+		...n.length > 0 ? { folderId: n.join("/") } : {}
+	} })
+}), c = (e) => async (t) => {
+	let { folders: n } = await e.listPrompts(), r = t ? `${t}/` : "";
+	return { folders: n.filter((e) => e.id.startsWith(r) && e.id.length > r.length && !e.id.slice(r.length).includes("/")).map((e) => ({
+		name: e.name,
+		path: e.id
+	})) };
+}, l = (e, t) => async (n) => {
+	let r = [], i = /* @__PURE__ */ new Set(), a;
+	do {
+		let o = await e.listSkills({
+			bucket: t,
+			path: n || void 0,
+			token: a
+		});
+		for (let e of o.items) {
+			if (e.nodeType !== "folder") continue;
+			let t = e.path.replace(/\/$/, "");
+			r.push({
+				name: e.name,
+				path: t
+			});
+		}
+		if (a = o.nextToken, a != null) {
+			if (i.has(a)) break;
+			i.add(a);
+		}
+	} while (a != null);
+	return { folders: r };
+};
+//#endregion
+export { n as createEmbeddedApplicationSaveAdapter, r as createHostApplicationSaveAdapter, s as createPromptCreateAdapter, c as createPromptFolderLister, a as createPromptSaveAdapter, l as createSkillFolderLister, o as createToolsetCreateAdapter, i as createToolsetSaveAdapter };

package/catalog/resource-save.d.ts

@@ -0,0 +1,76 @@
+import { SaveVersionMode, FolderDestination, PublicationRule } from '@epam/ai-dial-publish-panel';
+import { PublishApiClient } from './create-publish-api';
+import { CatalogPublishEntityType } from './publish';
+import { ResourceSaveAdapter } from './resource-save-adapter';
+export * from './resource-save-adapter';
+/** The roots of the Save panel's destination tree. */
+export declare enum SaveDestinationRoot {
+    /** The user's own folders for the resource type. */
+    Personal = "personal",
+    /** The Organization/public bucket; saving here also sends a publish request. */
+    Organization = "organization"
+}
+/** How a save that reached at least its first step ended. */
+export declare enum ResourceSaveOutcome {
+    /** Every step succeeded. */
+    Saved = "saved",
+    /** The save succeeded but moving into the chosen Personal folder failed. */
+    SavedButMoveFailed = "savedButMoveFailed",
+    /** The save succeeded but the publish request failed. */
+    SavedButPublishFailed = "savedButPublishFailed"
+}
+/** Why the new version typed in the Save panel cannot be used. */
+export declare enum ResourceSaveVersionError {
+    /** It does not match the host's version pattern. */
+    Invalid = "invalid",
+    /** It equals the resource's current version. */
+    Unchanged = "unchanged",
+    /** DIAL Core already stores a resource with that version. */
+    Exists = "exists"
+}
+/** What the user chose in the Save panel. */
+export interface ResourceSaveChoice {
+    /** Full id of the resource being edited. */
+    resourceId: string;
+    /** Its current Personal folder. */
+    currentFolderPath: string[];
+    /** Its current version; `undefined` for an unversioned resource. */
+    currentVersion?: string;
+    /** The confirmed destination. */
+    destination: FolderDestination;
+    /** Keep the version or save a new one. Ignored for an unversioned resource. */
+    versionMode: SaveVersionMode;
+    /** The new version, used when `versionMode` is `New`. */
+    newVersion: string;
+    /** Access rules sent with the publish request for an Organization destination. */
+    rules?: PublicationRule[];
+}
+/** Sends the publish request for a saved resource. */
+export type PublishSavedResource = (entityType: CatalogPublishEntityType, id: string, folderPath: string[], version: string | undefined, rules: PublicationRule[]) => Promise<void>;
+/** The result of a save whose first step succeeded. */
+export interface ResourceSaveResult {
+    /** How the later steps ended. */
+    outcome: ResourceSaveOutcome;
+    /** Id of the saved resource (the new version's, after a fork). */
+    savedId: string;
+    /** Whether the resource was created rather than saved. */
+    isCreated: boolean;
+    /** Whether a new version was written. */
+    isNewVersion: boolean;
+    /** Whether a publish request was sent successfully. */
+    isPublished: boolean;
+    /** The error of the step that failed after the save, if any. */
+    error?: unknown;
+}
+/** Returns a {@link PublishSavedResource} that sends the catalog publish request through `client`. */
+export declare const createPublishSavedResource: (client: Pick<PublishApiClient, "publishCatalogEntity">) => PublishSavedResource;
+/**
+ * Runs the Save panel's choice through `adapter`: create the resource in the
+ * chosen Personal folder, or save it in place or as a new version and then
+ * move it into a different Personal folder; for an Organization folder, save
+ * where it lives and publish. Rejects only when the first step fails; a failure
+ * after the save resolves with the matching partial outcome, because the
+ * save itself already happened.
+ */
+export declare const runResourceSave: (adapter: ResourceSaveAdapter, choice: ResourceSaveChoice, publish: PublishSavedResource) => Promise<ResourceSaveResult>;
+//# sourceMappingURL=resource-save.d.ts.map

package/catalog/resource-save.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-save.d.ts","sourceRoot":"","sources":["../../src/catalog/resource-save.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAEf,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,yBAAyB,CAAC;AAEjC,cAAc,yBAAyB,CAAC;AAExC,sDAAsD;AACtD,oBAAY,mBAAmB;IAC7B,oDAAoD;IACpD,QAAQ,aAAa;IACrB,gFAAgF;IAChF,YAAY,iBAAiB;CAC9B;AAED,6DAA6D;AAC7D,oBAAY,mBAAmB;IAC7B,4BAA4B;IAC5B,KAAK,UAAU;IACf,4EAA4E;IAC5E,kBAAkB,uBAAuB;IACzC,yDAAyD;IACzD,qBAAqB,0BAA0B;CAChD;AAED,kEAAkE;AAClE,oBAAY,wBAAwB;IAClC,oDAAoD;IACpD,OAAO,YAAY;IACnB,gDAAgD;IAChD,SAAS,cAAc;IACvB,6DAA6D;IAC7D,MAAM,WAAW;CAClB;AAED,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,+EAA+E;IAC/E,WAAW,EAAE,eAAe,CAAC;IAC7B,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,KAAK,CAAC,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,sDAAsD;AACtD,MAAM,MAAM,oBAAoB,GAAG,CACjC,UAAU,EAAE,wBAAwB,EACpC,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,eAAe,EAAE,KACrB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,SAAS,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,YAAY,EAAE,OAAO,CAAC;IACtB,uDAAuD;IACvD,WAAW,EAAE,OAAO,CAAC;IACrB,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAKD,sGAAsG;AACtG,eAAO,MAAM,0BAA0B,GAEnC,QAAQ,IAAI,CAAC,gBAAgB,EAAE,sBAAsB,CAAC,KACrD,oBAOF,CAAC;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAC1B,SAAS,mBAAmB,EAC5B,QAAQ,kBAAkB,EAC1B,SAAS,oBAAoB,KAC5B,OAAO,CAAC,kBAAkB,CAqE5B,CAAC"}

package/catalog/resource-save.js

@@ -0,0 +1,52 @@
+import { toPublishRuleDto as e } from "./create-publish-api.js";
+import { ResourceSaveError as t, isResourceCreateAdapter as n } from "./resource-save-adapter.js";
+import { SaveVersionMode as r, toFolderPathKey as i } from "@epam/ai-dial-publish-panel";
+//#region src/catalog/resource-save.ts
+var a = /* @__PURE__ */ function(e) {
+	return e.Personal = "personal", e.Organization = "organization", e;
+}({}), o = /* @__PURE__ */ function(e) {
+	return e.Saved = "saved", e.SavedButMoveFailed = "savedButMoveFailed", e.SavedButPublishFailed = "savedButPublishFailed", e;
+}({}), s = /* @__PURE__ */ function(e) {
+	return e.Invalid = "invalid", e.Unchanged = "unchanged", e.Exists = "exists", e;
+}({}), c = (e, t) => i(e) === i(t), l = (t) => async (n, r, i, a, o) => {
+	await t.publishCatalogEntity(n, r, {
+		folderPath: i.join("/"),
+		...a ? { version: a } : {},
+		rules: o.map(e)
+	});
+}, u = async (e, t, i) => {
+	let a = e.isVersioned && t.versionMode === r.New, o = t.destination.rootKey === "organization", s = o ? t.currentFolderPath : t.destination.path, l, u = !1;
+	if (n(e)) ({id: l} = await e.createIn(s));
+	else if (a) {
+		if (!e.saveAsNewVersion) throw Error("This resource cannot be saved as a new version");
+		({id: l} = await e.saveAsNewVersion(t.newVersion, s));
+	} else ({id: l} = await e.saveInPlace()), u = !o && !c(s, t.currentFolderPath);
+	let d = {
+		outcome: "saved",
+		savedId: l,
+		isCreated: n(e),
+		isNewVersion: a,
+		isPublished: !1
+	};
+	if (u && !n(e)) try {
+		({id: d.savedId} = await e.move(l, s));
+	} catch (e) {
+		return {
+			...d,
+			outcome: "savedButMoveFailed",
+			error: e
+		};
+	}
+	if (o) try {
+		await i(e.publishEntityType, d.savedId, t.destination.path, a ? t.newVersion : t.currentVersion, t.rules ?? []), d.isPublished = !0;
+	} catch (e) {
+		return {
+			...d,
+			outcome: "savedButPublishFailed",
+			error: e
+		};
+	}
+	return d;
+};
+//#endregion
+export { t as ResourceSaveError, o as ResourceSaveOutcome, s as ResourceSaveVersionError, a as SaveDestinationRoot, l as createPublishSavedResource, n as isResourceCreateAdapter, u as runResourceSave };

package/catalog/usage-limit-rows.d.ts

@@ -0,0 +1,14 @@
+import { CatalogItemLimits } from '@epam/ai-dial-catalog';
+/** The capped row closest to its limit, with its consumed percentage. */
+export interface WorstCappedRow {
+    /** Period label of that row, e.g. `'Today'`. */
+    label: string;
+    /** Consumed share of that row's limit, rounded and clamped to 0–100. */
+    usedPercent: number;
+}
+/**
+ * Returns the capped row with the highest used/total ratio across every group,
+ * or `undefined` when no row is capped.
+ */
+export declare const findWorstCappedRow: (limits: CatalogItemLimits | undefined) => WorstCappedRow | undefined;
+//# sourceMappingURL=usage-limit-rows.d.ts.map

package/catalog/usage-limit-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-limit-rows.d.ts","sourceRoot":"","sources":["../../src/catalog/usage-limit-rows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EAElB,MAAM,uBAAuB,CAAC;AAG/B,yEAAyE;AACzE,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;CACrB;AAKD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,iBAAiB,GAAG,SAAS,KACpC,cAAc,GAAG,SAwBnB,CAAC"}