@epam/ai-dial-skills 1.2.0-dev.99 → 1.2.0-rc.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@epam/ai-dial-skills",
   "description": "Host-agnostic UI for picking a favorite skill to attach to a chat input",
-  "version": "1.2.0-dev.99",
+  "version": "1.2.0-rc.1",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -18,12 +18,13 @@
   },
   "dependencies": {
     "@tabler/icons-react": "^3.44.0",
-    "@epam/ai-dial-catalog": "1.2.0-dev.99",
-    "@epam/ai-dial-conversation-input": "1.2.0-dev.99"
+    "@epam/ai-dial-catalog": "1.2.0-rc.1",
+    "@epam/ai-dial-conversation-input": "1.2.0-rc.1"
   },
   "peerDependencies": {
-    "@epam/ai-dial-chat-shared": "1.2.0-dev.99",
-    "@epam/ai-dial-ui-kit": "^0.15.0-dev.12",
+    "@epam/ai-dial-chat-shared": "1.2.0-rc.1",
+    "@epam/ai-dial-react-file-manager": "^0.3.0",
+    "@epam/ai-dial-ui-kit": "^0.15.0",
     "react": "^19.2.8"
   },
   "repository": {

package/test-setup.d.ts

@@ -1 +1,2 @@
+export {};
 //# sourceMappingURL=test-setup.d.ts.map

package/types/skill-unresolved-reason.d.ts

@@ -0,0 +1,8 @@
+/** Why a skill's url resolved to no loaded listing entry. */
+export declare enum SkillUnresolvedReason {
+    /** The url's bucket is the viewer's own bucket. The viewer's own skill no longer exists. */
+    Deleted = "deleted",
+    /** The url's bucket belongs to someone else. A personal skill never shared with the viewer (or since unshared/deleted). */
+    NotShared = "not-shared"
+}
+//# sourceMappingURL=skill-unresolved-reason.d.ts.map

package/types/skill-unresolved-reason.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-unresolved-reason.d.ts","sourceRoot":"","sources":["../../src/types/skill-unresolved-reason.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,oBAAY,qBAAqB;IAC/B,4FAA4F;IAC5F,OAAO,YAAY;IACnB,2HAA2H;IAC3H,SAAS,eAAe;CACzB"}

package/utils/catalog-content-dial-files.d.ts

@@ -0,0 +1,10 @@
+import { CatalogContentTreeNode } from '@epam/ai-dial-catalog';
+import { DialFile } from '@epam/ai-dial-react-file-manager';
+/**
+ * Maps the details panel's `CatalogContentTreeNode[]` onto the nested
+ * `DialFile[]` `DialFoldersTree` renders. A node's opaque `id` becomes the
+ * file's `path`, so the tree's `selectedPath` / `expandedPaths` /
+ * `onItemClick` speak the panel's ids unchanged — nothing is parsed.
+ */
+export declare const mapCatalogContentTreeToDialFiles: (nodes: CatalogContentTreeNode[], parentPath?: string | null) => DialFile[];
+//# sourceMappingURL=catalog-content-dial-files.d.ts.map

package/utils/catalog-content-dial-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-content-dial-files.d.ts","sourceRoot":"","sources":["../../src/utils/catalog-content-dial-files.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAEjE;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,GAC3C,OAAO,sBAAsB,EAAE,EAC/B,aAAY,MAAM,GAAG,IAAW,KAC/B,QAAQ,EAkBR,CAAC"}

package/utils/skill-mention-matching.d.ts

@@ -0,0 +1,34 @@
+import { RequestSkill } from '@epam/ai-dial-chat-shared';
+import { SkillListingEntry } from '../models/favorite-skill-item';
+import { SkillMentionAnchor } from '../models/skill-mention-anchor';
+/** One resolved mention location, or omitted for a skill whose text mention could not be found. */
+export interface ResolvedSkillMention {
+    /** Index into the input `skills` array this location resolves. */
+    skillIndex: number;
+    /** Character offset of the leading `/` in `text`. */
+    start: number;
+    /** Length of the matched `/{name}` run. */
+    length: number;
+}
+/**
+ * Matches each entry of `skills` (in array order) to the next available
+ * `/{name}` occurrence in `text`, where `name` is that entry's display name
+ * resolved via `resolveName(url)` — the current listing name, falling back to
+ * the url's last path segment (`getSkillFallbackName`). Scans left to right,
+ * consuming text as it goes, so two skills with the same resolved name are
+ * still matched to distinct, successive occurrences in the text. A skill
+ * whose exact `/{name}` cannot be found at or after the current scan position
+ * (e.g. the user's later edit broke the mention) is omitted from the result —
+ * it still counts as a real `custom_content.skills` entry for sending, it
+ * simply renders nowhere in particular, and later entries still get their own
+ * independent forward search from the same unmoved cursor.
+ */
+export declare const matchSkillMentions: (text: string, skills: RequestSkill[], resolveName: (url: string) => string) => ResolvedSkillMention[];
+/**
+ * Returns every `/{name}` run in `text` that names one of `skills`, as mention
+ * anchors with offsets into `text`. A run must start the text or follow
+ * whitespace and end at a word boundary; the longest matching name wins, and
+ * a name shared by several skills resolves to the first of them in `skills`.
+ */
+export declare const findSkillMentionsInText: (text: string, skills: Pick<SkillListingEntry, "url" | "name">[]) => SkillMentionAnchor[];
+//# sourceMappingURL=skill-mention-matching.d.ts.map

package/utils/skill-mention-matching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-mention-matching.d.ts","sourceRoot":"","sources":["../../src/utils/skill-mention-matching.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,mGAAmG;AACnG,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,GAC7B,MAAM,MAAM,EACZ,QAAQ,YAAY,EAAE,EACtB,aAAa,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,KACnC,oBAAoB,EA0BtB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,MAAM,MAAM,EACZ,QAAQ,IAAI,CAAC,iBAAiB,EAAE,KAAK,GAAG,MAAM,CAAC,EAAE,KAChD,kBAAkB,EAiCpB,CAAC"}

package/utils/skill-mention-tracking.d.ts

@@ -0,0 +1,56 @@
+import { SkillMentionAnchor } from '../models/skill-mention-anchor';
+/** A single-region text edit, expressed as the replaced range in the previous string. */
+export interface TextChange {
+    /** Character offset where the previous and next strings first diverge. */
+    start: number;
+    /** Number of characters removed from the previous string at `start`. */
+    deletedLength: number;
+    /** Number of characters inserted at `start` in the next string. */
+    insertedLength: number;
+}
+/**
+ * Diffs two strings produced by a single-cursor edit (typing, deleting,
+ * pasting, cutting, undo/redo) via their common prefix and common suffix —
+ * cheap (O(n)) and exact for that class of edit, which is everything a
+ * textarea actually produces.
+ */
+export declare const diffTextChange: (previous: string, next: string) => TextChange;
+/**
+ * Applies a text change to a set of tracked mention anchors: an anchor
+ * entirely before the edited region is untouched, one entirely after is
+ * shifted by the edit's length delta, and one that overlaps the edited region
+ * is dropped — the user edited into the middle of a mention, so it reverts to
+ * plain text and no longer contributes a `custom_content.skills` entry.
+ */
+export declare const reconcileAnchors: (anchors: SkillMentionAnchor[], change: TextChange) => SkillMentionAnchor[];
+/**
+ * Inserts a new mention anchor at `atIndex` and shifts every anchor at or
+ * after that index by the inserted `/{name}` run's length — plus one more
+ * when `hasTrailingSpace` — keeping the result ordered by `start`
+ * (left-to-right reading order).
+ */
+export declare const insertAnchor: (anchors: SkillMentionAnchor[], atIndex: number, url: string, name: string, hasTrailingSpace: boolean) => SkillMentionAnchor[];
+/**
+ * Finds the anchor whose mention run ends exactly at `caretPosition` — the
+ * caret sitting immediately after that mention — or `undefined` if none does.
+ * Used to detect the whole-mention Backspace gesture.
+ */
+export declare const findMentionAtCaret: (anchors: SkillMentionAnchor[], caretPosition: number) => SkillMentionAnchor | undefined;
+/**
+ * The contiguous non-whitespace run touching `caretPosition` in `text`, when
+ * it is shaped like an as-yet-unselected slash query: starts with `prefix`
+ * and contains no second occurrence of it. `undefined` when the run at the
+ * caret isn't shaped that way. Mirrors the word shape the slash command menu
+ * opens for, so the Add-menu's own selection path can detect and consume the
+ * same typed `/query` text.
+ */
+export declare const findSlashQueryAtCaret: (text: string, caretPosition: number, prefix: string) => {
+    start: number;
+    end: number;
+} | undefined;
+/**
+ * Returns the offset in `next` at which `text` landed when `change` is the
+ * edit that inserted it, or `undefined` when `change` cannot have inserted it.
+ */
+export declare const findInsertedTextOffset: (next: string, change: TextChange, text: string) => number | undefined;
+//# sourceMappingURL=skill-mention-tracking.d.ts.map

package/utils/skill-mention-tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-mention-tracking.d.ts","sourceRoot":"","sources":["../../src/utils/skill-mention-tracking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,yFAAyF;AACzF,MAAM,WAAW,UAAU;IACzB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,EAAE,MAAM,MAAM,KAAG,UAyB/D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,SAAS,kBAAkB,EAAE,EAC7B,QAAQ,UAAU,KACjB,kBAAkB,EAmBpB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GACvB,SAAS,kBAAkB,EAAE,EAC7B,SAAS,MAAM,EACf,KAAK,MAAM,EACX,MAAM,MAAM,EACZ,kBAAkB,OAAO,KACxB,kBAAkB,EAkBpB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC7B,SAAS,kBAAkB,EAAE,EAC7B,eAAe,MAAM,KACpB,kBAAkB,GAAG,SACkD,CAAC;AAE3E;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAChC,MAAM,MAAM,EACZ,eAAe,MAAM,EACrB,QAAQ,MAAM,KACb;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,SAgBnC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,MAAM,EACZ,QAAQ,UAAU,EAClB,MAAM,MAAM,KACX,MAAM,GAAG,SAWX,CAAC"}

package/utils/skill-url.d.ts

@@ -1,2 +1,3 @@
 export declare const getSkillFallbackName: (url: string) => string;
+export declare const getSkillUrlBucket: (url: string) => string | null;
 //# sourceMappingURL=skill-url.d.ts.map

package/utils/skill-url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-url.d.ts","sourceRoot":"","sources":["../../src/utils/skill-url.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,oBAAoB,GAAI,KAAK,MAAM,KAAG,MAGlD,CAAC"}
+{"version":3,"file":"skill-url.d.ts","sourceRoot":"","sources":["../../src/utils/skill-url.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,oBAAoB,GAAI,KAAK,MAAM,KAAG,MAGlD,CAAC;AAUF,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,IAIxD,CAAC"}