@epam/ai-dial-skills 1.2.0-dev.141 → 1.2.0-dev.142

package/models/skill-mention-anchor.d.ts

@@ -0,0 +1,12 @@
+/** A skill mention's location within the current plain-text draft. */
+export interface SkillMentionAnchor {
+    /** The mentioned skill's resource URL — the value sent as this entry's `{ url }`. */
+    url: string;
+    /** Display name at the time of insertion (`/${name}` is what actually sits in the text). */
+    name: string;
+    /** Character offset of the leading `/` in the current draft string. */
+    start: number;
+    /** Length of the `/{name}` run, `1 + name.length`. */
+    length: number;
+}
+//# sourceMappingURL=skill-mention-anchor.d.ts.map

package/models/skill-mention-anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-mention-anchor.d.ts","sourceRoot":"","sources":["../../src/models/skill-mention-anchor.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IACjC,qFAAqF;IACrF,GAAG,EAAE,MAAM,CAAC;IACZ,4FAA4F;IAC5F,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/models/skill-selector-overlay.d.ts

@@ -1,5 +1,5 @@
 import { RequestSkill } from '@epam/ai-dial-chat-shared';
-import { CommandMenuConfig, MenuOverlayConfig } from '@epam/ai-dial-conversation-input';
+import { CommandMenuConfig, HighlightedTextRange, MenuOverlayConfig } from '@epam/ai-dial-conversation-input';
 import { ComponentType, ReactNode } from 'react';
 import { SkillListingEntry } from './favorite-skill-item';
 import { FavoriteSkillsPanelLabels } from './favorite-skills-panel-props';
@@ -28,11 +28,6 @@ export interface SkillSelectorOverlayLabels {
      * is open with an empty query. Defaults to `'Type to filter'`.
      */
     emptyQueryHintLabel?: string;
-    /**
-     * Message shown alone in the selected skill chip's error-state tooltip
-     * while the current deployment does not support skills.
-     */
-    unsupportedTooltipLabel?: string;
     /** Labels forwarded to the favorites panel rendered as the overlay. */
     panelLabels?: FavoriteSkillsPanelLabels;
 }
@@ -46,9 +41,13 @@ export interface UseSkillSelectorOverlayOptions {
     /**
      * Whether the input's current deployment supports skills. While `false`
      * (with the flow enabled) the entry points are omitted — no Add-menu item
-     * and no slash menu — but an already-selected skill chip stays rendered in
-     * its error state with its removal gesture and "View details" panel
-     * available. The host resolves this from its own deployment data.
+     * and no slash menu — but a tracked mention stays in the draft text and
+     * folds into `isSkillUnsupported` for the host's own send-disabled
+     * condition. The host resolves this from its own deployment data. Note: a
+     * live-composing mention has no per-mention error styling of its own (it
+     * renders as a plain highlighted run, not a `ChatSkill`); only the sent
+     * `custom_content.skills`/history rendering, and this boolean fold, reflect
+     * the unsupported state.
      */
     isSkillsSupported: boolean;
     /** The user's own skills. */
@@ -84,18 +83,18 @@ export interface UseSkillSelectorOverlayOptions {
 export interface UseSkillSelectorOverlayResult {
     /**
      * The Skills entry for the `menuOverlays` prop of
-     * `ConversationInput`/`Input`. `undefined` while the flow is disabled or the
-     * current deployment does not support skills: the host omits the entry
-     * entirely when this is `undefined`, so a stub renderer would leave the
-     * menu item in place with nothing behind it.
+     * `ConversationInput`/`EditMessageInput`/`Input`. `undefined` while the flow
+     * is disabled or the current deployment does not support skills: the host
+     * omits the entry entirely when this is `undefined`, so a stub renderer
+     * would leave the menu item in place with nothing behind it.
      */
     skillMenuOverlay?: MenuOverlayConfig;
     /**
      * The Skills entry for the `commandMenu` prop of
-     * `ConversationInput`/`Input`: typing `/` into an empty textarea opens the
-     * favorites panel in search mode above the input. `undefined` while the
-     * flow is disabled or the current deployment does not support skills,
-     * disabling the slash menu entirely.
+     * `ConversationInput`/`EditMessageInput`/`Input`: typing `/` into an empty
+     * textarea opens the favorites panel in search mode above the input.
+     * `undefined` while the flow is disabled or the current deployment does not
+     * support skills, disabling the slash menu entirely.
      */
     commandMenu?: CommandMenuConfig;
     /**
@@ -109,55 +108,102 @@ export interface UseSkillSelectorOverlayResult {
      */
     skillDetailsPanel: ReactNode;
     /**
-     * The selected skill as a `ChatSkill` element for the conversation input's
-     * `inlineStartSlot` — at most one, replaced on every selection, carrying
-     * the shared tooltip (the listing-sourced description, same as the favorite
-     * rows), or the error state while the current deployment does not support
-     * skills. The element has no remove control of its own; removal is the
-     * input's Backspace-at-start gesture, wired through `removeSelectedSkill`.
-     * `null` while `isEnabled` is `false` or nothing is selected.
+     * The composer's message text after the most recent skill selection, with
+     * every `/{name}` mention spliced in. Pass straight through to
+     * `ConversationInput`/`EditMessageInput`'s own `message` prop alongside
+     * `messageRevision` — like that prop's existing "populated by a starter
+     * selection" use, this is a one-shot push applied on a `messageRevision`
+     * bump, not a value the host feeds back on every keystroke (ordinary typing
+     * is tracked separately through `onDraftChange`).
      */
-    selectedSkillElement: ReactNode;
+    message: string;
     /**
-     * Whether a skill is selected while the current deployment does not
-     * support skills — the chip renders in its error state and hosts must fold
-     * this into their send-disabled conditions. Always `false` while
-     * `isEnabled` is `false`.
+     * Token that forces `message` to re-apply even when its string value is
+     * unchanged from the last push (e.g. the same skill selected again).
+     * Bumped on every call to the selection handlers backing `skillMenuOverlay`
+     * and `commandMenu`. Pass straight through to the composer's own
+     * `messageRevision` prop.
      */
-    isSkillUnsupported: boolean;
+    messageRevision: number;
     /**
-     * The selected skill's resource URL (`skills/{bucket}/{path}`) — the value
-     * the host sends as a `{ url }` entry in the outgoing message's
-     * `custom_content.skills`. `null` while nothing is selected or the flow is
-     * disabled.
+     * Every currently-tracked skill mention's character range within the
+     * composer's live draft text, for `ConversationInput`/`EditMessageInput`/
+     * `Input`'s `activeMentions` prop (the live-composing highlighted-run
+     * render). Empty while nothing is mentioned or the flow is disabled.
      */
-    selectedSkillPath: string | null;
+    activeMentions: HighlightedTextRange[];
     /**
-     * The selected skill as the send-time `custom_content.skills` payload —
-     * `[{ url: selectedSkillPath }]`, or `undefined` while nothing is selected
-     * or the flow is disabled, so `custom_content.skills` is omitted entirely.
+     * Reconciles tracked mentions against an external edit to the composer's
+     * draft text (ordinary typing, deleting, pasting, undo/redo). Wire to the
+     * composer's own `onChange` callback, in addition to whatever the host
+     * already does with that value — this keeps `activeMentions`/
+     * `selectedSkills` in sync with live edits between selections.
      */
-    selectedSkills: RequestSkill[] | undefined;
+    onDraftChange: (nextValue: string) => void;
+    /**
+     * Looks up the mention whose run ends exactly at `caretPosition`, without
+     * mutating any state. Pass straight through to the composer's
+     * `onBackspaceAtCaret` prop, which performs the actual whole-mention
+     * deletion through the textarea's native editing pipeline and reports the
+     * result back through `onDraftChange`. Returns `undefined` when the caret
+     * isn't at a mention boundary.
+     */
+    onBackspaceAtCaret: (caretPosition: number) => HighlightedTextRange | undefined;
     /**
-     * Selects a skill by its resource URL (`skills/{bucket}/{path}`), replacing
-     * any prior selection.
+     * Caret offset to place the cursor at immediately after the most recent
+     * skill selection applies `message`/`messageRevision` — the position right
+     * after the inserted mention's text. Pass straight through to the
+     * composer's `caretPositionOverride` prop. `undefined` before any selection
+     * has been made this session.
      */
-    selectSkill: (skillId: string) => void;
+    caretPositionOverride: number | undefined;
     /**
-     * Clears the selected skill. Wire to the input's `onInlineStartRemove` —
-     * Backspace with the caret collapsed at position 0 while the selected
-     * skill's element is shown.
+     * Whether at least one skill is mentioned while the current deployment does
+     * not support skills — hosts must fold this into their send-disabled
+     * conditions. Always `false` while `isEnabled` is `false`.
      */
-    removeSelectedSkill: () => void;
+    isSkillUnsupported: boolean;
+    /**
+     * Every currently-tracked mention as the send-time `custom_content.skills`
+     * payload, in left-to-right text order — `undefined` while nothing is
+     * mentioned or the flow is disabled, so `custom_content.skills` is omitted
+     * entirely. Cleared to `undefined` by `resetSkillMentions` after a
+     * successful send.
+     */
+    selectedSkills: RequestSkill[] | undefined;
     /**
-     * Renders a message's `custom_content.skills` entries as `ChatSkill`
-     * elements beside the message bubble's first text line, with the text
-     * word-flowing after them — one per entry, sharing the "View details"
-     * details panel with the favorite rows and the input chip. Each entry's
-     * name comes from the listing pools matched on its url, falling back to
-     * the url's last non-empty segment, and its description from the same
-     * match (absent when no pool carries the url). Returns `null` while
-     * `isEnabled` is `false` or the array is empty.
+     * Clears every tracked mention and the draft text alongside it. Call after
+     * a successful send, matching the per-message selection-clears semantics of
+     * `custom_content.skills`.
+     */
+    resetSkillMentions: () => void;
+    /**
+     * Seeds the draft and its tracked mentions from a persisted message — runs
+     * `matchSkillMentions` once against `content`/`skills` and initializes
+     * `message`/`activeMentions` from the result (bumping `messageRevision`).
+     * Call once when entering edit mode on a message that carries
+     * `custom_content.skills`.
+     */
+    seedSkillMentions: (content: string, skills: RequestSkill[] | undefined) => void;
+    /**
+     * Renders a user message's `content` and `custom_content.skills` as an
+     * ordered array interleaving plain-text runs and `ChatSkill` elements at
+     * each mention's actual text position — for `UserMessageBubble`'s
+     * `textSegments` prop. Resolves each entry's name from the listing pools
+     * matched on its url, falling back to the url's last non-empty segment,
+     * sharing the "View details" panel with the favorite rows. Returns `null`
+     * while `isEnabled` is `false` or `skills` is empty/absent; a mention
+     * `matchSkillMentions` cannot locate in `content` is simply omitted from
+     * the render (see `matchSkillMentions`'s own doc for that heuristic).
+     */
+    renderHistorySkillSegments: (content: string, skills: RequestSkill[] | undefined) => ReactNode[] | null;
+    /**
+     * Renders every entry of `skills` as a flat list of `ChatSkill` elements,
+     * ignoring text position — for `AssistantMessageBubble`'s `beforeContent`
+     * slot, since assistant text is model-generated markdown and never
+     * authors positioned mentions. Each entry's name/description resolve the
+     * same way as `renderHistorySkillSegments`. Returns `null` while
+     * `isEnabled` is `false` or the array is empty/absent.
      */
     renderHistorySkills: (skills: RequestSkill[] | undefined) => ReactNode;
 }

package/models/skill-selector-overlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-selector-overlay.d.ts","sourceRoot":"","sources":["../../src/models/skill-selector-overlay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE/E;;;;;GAKG;AACH,MAAM,WAAW,+BAA+B;IAC9C,iFAAiF;IACjF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,qEAAqE;AACrE,MAAM,WAAW,0BAA0B;IACzC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,uEAAuE;IACvE,WAAW,CAAC,EAAE,yBAAyB,CAAC;CACzC;AAED,qDAAqD;AACrD,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAC3B,6BAA6B;IAC7B,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,qEAAqE;IACrE,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACnC,uDAAuD;IACvD,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACnC,0EAA0E;IAC1E,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,oEAAoE;IACpE,gBAAgB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,oCAAoC;IACpC,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC;;;;;;OAMG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC;;;;OAIG;IACH,oBAAoB,EAAE,CACpB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,EAC9B,OAAO,EAAE,MAAM,IAAI,KAChB,SAAS,CAAC;IACf,sEAAsE;IACtE,qBAAqB,EAAE,aAAa,CAAC,+BAA+B,CAAC,CAAC;CACvE;AAED,6CAA6C;AAC7C,MAAM,WAAW,6BAA6B;IAC5C;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IACrC;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC;;;OAGG;IACH,iBAAiB,EAAE,SAAS,CAAC;IAC7B;;;OAGG;IACH,iBAAiB,EAAE,SAAS,CAAC;IAC7B;;;;;;;;OAQG;IACH,oBAAoB,EAAE,SAAS,CAAC;IAChC;;;;;OAKG;IACH,kBAAkB,EAAE,OAAO,CAAC;IAC5B;;;;;OAKG;IACH,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC;;;;OAIG;IACH,cAAc,EAAE,YAAY,EAAE,GAAG,SAAS,CAAC;IAC3C;;;OAGG;IACH,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC;;;;OAIG;IACH,mBAAmB,EAAE,MAAM,IAAI,CAAC;IAChC;;;;;;;;;OASG;IACH,mBAAmB,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,SAAS,KAAK,SAAS,CAAC;CACxE"}
+{"version":3,"file":"skill-selector-overlay.d.ts","sourceRoot":"","sources":["../../src/models/skill-selector-overlay.ts"],"names":[],"mappings":"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"}

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.141",
+  "version": "1.2.0-dev.142",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -18,11 +18,11 @@
   },
   "dependencies": {
     "@tabler/icons-react": "^3.44.0",
-    "@epam/ai-dial-catalog": "1.2.0-dev.141",
-    "@epam/ai-dial-conversation-input": "1.2.0-dev.141"
+    "@epam/ai-dial-catalog": "1.2.0-dev.142",
+    "@epam/ai-dial-conversation-input": "1.2.0-dev.142"
   },
   "peerDependencies": {
-    "@epam/ai-dial-chat-shared": "1.2.0-dev.141",
+    "@epam/ai-dial-chat-shared": "1.2.0-dev.142",
     "@epam/ai-dial-ui-kit": "^0.15.0-dev.18",
     "react": "^19.2.8"
   },

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

@@ -0,0 +1,25 @@
+import { RequestSkill } from '@epam/ai-dial-chat-shared';
+/** 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[];
+//# 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;AAE9D,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"}

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

@@ -0,0 +1,39 @@
+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;
+//# 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"}