@memberjunction/conversations-runtime 6.1.4 → 6.2.0-edge.1

package/dist/mentions/MentionAutocomplete.js

@@ -0,0 +1,507 @@
+import { Metadata } from '@memberjunction/core';
+import { AIEngineBase, AIAgentPermissionHelper, AISkillPermissionHelper } from '@memberjunction/ai-engine-base';
+import { BaseSingleton, UUIDsEqual } from '@memberjunction/global';
+import { IntersectAcceptedSkills } from './SkillNarrowing.js';
+/**
+ * Shared engine behind the conversations composer plugins (the agent-mentions /
+ * record-mentions / skill-commands `ComposerTriggerProvider`s) and the mention-parsing
+ * consumers (message routing, saved-message badge rendering). Loads the
+ * permission-filtered agent / user / entity / query / skill caches once per session and
+ * serves ranked `MentionSuggestion` lists per trigger char.
+ *
+ * Framework-agnostic by construction: a `BaseSingleton` with no Angular, no DOM and no renderer
+ * in its graph. That is what lets the ClassFactory-instantiated trigger providers (which live
+ * outside Angular DI), the Angular components, and a React Native host all share ONE instance and
+ * one cache warm-up.
+ *
+ * It previously lived in `@memberjunction/ng-conversations` and was Angular-coupled only by
+ * location — no import from `@angular/*`, no decorator. A native host cannot depend on an Angular
+ * library, so the same permission filtering, skill narrowing and ranking would have had to be
+ * written a second time to reach mobile, and a second copy of a permission rule is the copy that
+ * drifts. Angular keeps a thin DI shim over this so its call sites are unchanged.
+ */
+export class MentionAutocomplete extends BaseSingleton {
+    constructor() {
+        super();
+        this.agentsCache = [];
+        this.usersCache = [];
+        this.entitiesCache = [];
+        this.queriesCache = [];
+        /** Active skills the current user can Run — surfaced under the '/' trigger. */
+        this.skillsCache = [];
+        /** Default icon for a skill with no IconClass of its own. */
+        this.defaultSkillIcon = 'fa-solid fa-wand-magic-sparkles';
+        /** Generic icon for all query mentions, sourced from the 'MJ: Queries' entity. */
+        this.queriesEntityIcon = 'fa-solid fa-database';
+        this.isInitialized = false;
+        this.initializationPromise = null;
+    }
+    /** The process-wide shared instance (Global Object Store backed). */
+    static get Instance() {
+        return super.getInstance();
+    }
+    /** True once the caches have loaded (agents/users/entities/queries/skills). */
+    get IsInitialized() {
+        return this.isInitialized;
+    }
+    /**
+     * Initialize the service by loading agents and users
+     * Prevents concurrent initialization with promise lock
+     */
+    async initialize(currentUser, provider) {
+        // If already initialized, return immediately
+        if (this.isInitialized) {
+            return;
+        }
+        // If initialization is in progress, wait for it
+        if (this.initializationPromise) {
+            return this.initializationPromise;
+        }
+        // Create initialization promise and store it
+        this.initializationPromise = this._initializeInternal(currentUser, provider);
+        try {
+            await this.initializationPromise;
+        }
+        finally {
+            this.initializationPromise = null;
+        }
+    }
+    /**
+     * Internal initialization logic
+     */
+    async _initializeInternal(currentUser, provider) {
+        try {
+            // Load agents from AIEngineBase
+            await AIEngineBase.Instance.Config(false);
+            const allAgents = AIEngineBase.Instance.Agents || [];
+            // Filter by status, hierarchy, and invocation mode first
+            const candidateAgents = allAgents.filter(a => !a.ParentID && a.Status === 'Active' && a.InvocationMode !== 'Sub-Agent' && !a.IsRestricted);
+            // Filter by user's 'run' permission — respects open-by-default + explicit permissions
+            this.agentsCache = await this.filterAgentsByRunPermission(candidateAgents, currentUser);
+            // Load users from the system (optional - can be expanded later)
+            // For now, we'll just use the current user
+            this.usersCache = [currentUser];
+            // Load entities the current user can read (candidates for #entity mentions)
+            this.entitiesCache = this.loadReadableEntities(currentUser, provider);
+            // Load queries the current user can run (also surfaced under the '#' trigger)
+            this.queriesCache = this.loadRunnableQueries(currentUser, provider);
+            this.queriesEntityIcon = this.resolveQueriesEntityIcon(provider);
+            // Load Active skills the current user can Run (surfaced under the '/' trigger). Mirrors the
+            // agent filter: open-by-default unless a skill has explicit permission rows. This is the user's
+            // full run-permitted set; when the host names the target agent (getSuggestions' targetAgentId)
+            // the picker narrows it to what that agent accepts, and the server's RequestedSkills guard is
+            // the backstop either way.
+            this.skillsCache = await this.filterSkillsByRunPermission(currentUser);
+            this.provider = provider;
+            this.isInitialized = true;
+        }
+        catch (error) {
+            console.error('Failed to initialize MentionAutocomplete:', error);
+            throw error;
+        }
+    }
+    /**
+     * Filter agents to only those the current user has 'run' permission for.
+     * Agents with no permission records are open to everyone (canRun = true).
+     * Agents with explicit permission records are checked against the user.
+     */
+    async filterAgentsByRunPermission(agents, user) {
+        const permitted = [];
+        for (const agent of agents) {
+            try {
+                const canRun = await AIAgentPermissionHelper.HasPermission(agent.ID, user, 'run');
+                if (canRun) {
+                    permitted.push(agent);
+                }
+            }
+            catch {
+                // Fail closed — exclude agent on error
+            }
+        }
+        return permitted;
+    }
+    /**
+     * Filter Active skills to those the current user has 'run' permission for.
+     * Skills with no permission records are open to everyone (canRun = true);
+     * skills with explicit records are checked against the user (open-by-default).
+     */
+    async filterSkillsByRunPermission(user) {
+        try {
+            const runnable = await AISkillPermissionHelper.GetAccessibleSkills(user, 'run');
+            return runnable.filter(s => s.Status === 'Active');
+        }
+        catch {
+            // Fail closed — no skills on error.
+            return [];
+        }
+    }
+    /**
+     * Load entities the current user has read permission for.
+     * These are the candidates surfaced for #entity mentions.
+     */
+    loadReadableEntities(user, provider) {
+        try {
+            const md = provider ?? Metadata.Provider;
+            return (md.Entities || []).filter(entity => {
+                try {
+                    return entity.GetUserPermisions(user).CanRead;
+                }
+                catch {
+                    // Fail closed — exclude entity on permission-check error
+                    return false;
+                }
+            });
+        }
+        catch (error) {
+            console.error('Failed to load entities for mention autocomplete:', error);
+            return [];
+        }
+    }
+    /**
+     * Load queries the current user has run permission for.
+     * These are the candidates surfaced for #query mentions.
+     */
+    loadRunnableQueries(user, provider) {
+        try {
+            const md = provider ?? Metadata.Provider;
+            return (md.Queries || []).filter(query => {
+                try {
+                    return query.UserCanRun(user);
+                }
+                catch {
+                    // Fail closed — exclude query on permission-check error
+                    return false;
+                }
+            });
+        }
+        catch (error) {
+            console.error('Failed to load queries for mention autocomplete:', error);
+            return [];
+        }
+    }
+    /**
+     * Resolve the generic icon used for all query mentions from the 'MJ: Queries' entity.
+     */
+    resolveQueriesEntityIcon(provider) {
+        try {
+            const md = provider ?? Metadata.Provider;
+            return md.EntityByName('MJ: Queries')?.Icon || 'fa-solid fa-database';
+        }
+        catch {
+            return 'fa-solid fa-database';
+        }
+    }
+    /**
+     * Get suggestions based on search query
+     * @param query The search text after the trigger character
+     * @param includeUsers Whether to include users in suggestions
+     * @param trigger '@' (agents + users), '#' (entities + queries) or '/' (skills)
+     * @param targetAgentId When the host knows which agent the message will go to (the '/' trigger
+     * only), skill suggestions are narrowed to what THAT agent accepts — `AcceptsSkills` + its
+     * `MJ: AI Agent Skills` grants — via {@link AIEngineBase.GetSkillsForAgent}. Without it (or for an
+     * agent not in the user's runnable set) the user's full runnable catalog is shown, as before, and
+     * the server's `RequestedSkills` guard is the backstop.
+     * @param scope Narrows the '@' list for one composer: the agents it may offer and the people it
+     * offers. Passed per call, never stored, because this engine is shared by every composer on the
+     * page. Omitted keeps today's list: every agent the user can run, and the current user.
+     * @returns Filtered and ranked suggestions
+     */
+    GetSuggestions(query, includeUsers = true, trigger = '@', targetAgentId = null, scope = null) {
+        // The '#' trigger searches entities + queries; '/' searches skills; '@' searches agents + users
+        if (trigger === '#') {
+            return this.getEntityAndQuerySuggestions(query);
+        }
+        if (trigger === '/') {
+            return this.getSkillSuggestions(query, targetAgentId);
+        }
+        const lowerQuery = query.toLowerCase().trim();
+        const suggestions = [
+            ...this.getAgentSuggestions(lowerQuery, scope?.AllowedAgentIDs ?? null),
+            ...(includeUsers ? this.getPeopleSuggestions(lowerQuery, scope?.People ?? null) : []),
+        ];
+        // Sort by relevance: exact match > starts with > contains
+        return suggestions.sort((a, b) => {
+            const scoreA = this.calculateMatchScore(a.name, lowerQuery);
+            const scoreB = this.calculateMatchScore(b.name, lowerQuery);
+            if (scoreB !== scoreA)
+                return scoreB - scoreA;
+            // If scores are equal, sort agents before users
+            if (a.type !== b.type)
+                return a.type === 'agent' ? -1 : 1;
+            // Otherwise alphabetically
+            return a.name.localeCompare(b.name);
+        });
+    }
+    /** @deprecated Use {@link GetSuggestions}. */
+    getSuggestions(query, includeUsers = true, trigger = '@', targetAgentId = null, scope = null) {
+        return this.GetSuggestions(query, includeUsers, trigger, targetAgentId, scope);
+    }
+    /**
+     * Agent suggestions for '@': the user's runnable agents that match the query, narrowed to
+     * `allowedAgentIDs` when one is given (null offers every runnable agent).
+     */
+    getAgentSuggestions(lowerQuery, allowedAgentIDs) {
+        return this.agentsCache
+            .filter(agent => allowedAgentIDs == null || allowedAgentIDs.some(id => UUIDsEqual(id, agent.ID)))
+            .filter(agent => !lowerQuery || this.calculateMatchScore(agent.Name || '', lowerQuery) > 0)
+            .map(agent => ({
+            type: 'agent',
+            id: agent.ID,
+            name: agent.Name || 'Unknown',
+            displayName: agent.Name || 'Unknown',
+            description: agent.Description || undefined,
+            imageUrl: agent.LogoURL || undefined, // Agent logo/avatar image
+            icon: this.getAgentIcon(agent),
+            // Configuration presets ride on the suggestion — the (AI-blind) composer
+            // renders a preset picker on the inserted chip when there are 2+.
+            presets: this.getAgentPresets(agent.ID)
+        }));
+    }
+    /**
+     * People suggestions for '@': the host's list when a composer supplies one, otherwise the
+     * engine's own (which holds only the current user).
+     */
+    getPeopleSuggestions(lowerQuery, people) {
+        const candidates = people
+            ?? this.usersCache.map(user => ({ ID: user.ID, Name: user.Name, Email: user.Email }));
+        return candidates
+            .filter(person => !lowerQuery || this.calculateMatchScore(person.Name, lowerQuery) > 0)
+            .map(person => ({
+            type: 'user',
+            id: person.ID,
+            name: person.Name,
+            displayName: person.Name,
+            description: person.Email || undefined
+        }));
+    }
+    /**
+     * Get entity + query suggestions for #mentions, ranked by query match.
+     * Capped to keep the dropdown light (entity/query sets can be large).
+     */
+    getEntityAndQuerySuggestions(query) {
+        const lowerQuery = query.toLowerCase().trim();
+        const MAX_SUGGESTIONS = 50;
+        const entityItems = this.entitiesCache.map(entity => ({
+            label: entity.DisplayNameOrName,
+            score: Math.max(this.calculateMatchScore(entity.Name || '', lowerQuery), this.calculateMatchScore(entity.DisplayName || '', lowerQuery)),
+            suggestion: {
+                type: 'entity',
+                id: entity.ID,
+                name: entity.Name,
+                displayName: entity.DisplayNameOrName,
+                description: entity.Description || undefined,
+                icon: entity.Icon || 'fa-solid fa-table'
+            }
+        }));
+        const queryItems = this.queriesCache.map(q => ({
+            label: q.Name || '',
+            score: this.calculateMatchScore(q.Name || '', lowerQuery),
+            suggestion: {
+                type: 'query',
+                id: q.ID,
+                name: q.Name || '',
+                displayName: q.Name || '',
+                description: q.Description || undefined,
+                icon: this.queriesEntityIcon
+            }
+        }));
+        return [...entityItems, ...queryItems]
+            .filter(x => x.score > 0 || !lowerQuery)
+            .sort((a, b) => {
+            if (b.score !== a.score)
+                return b.score - a.score;
+            // When scores tie, prioritize entities over queries
+            if (a.suggestion.type !== b.suggestion.type) {
+                return a.suggestion.type === 'entity' ? -1 : 1;
+            }
+            return a.label.localeCompare(b.label);
+        })
+            .slice(0, MAX_SUGGESTIONS)
+            .map(x => x.suggestion);
+    }
+    /**
+     * The skills to offer under '/': the user's runnable catalog, narrowed to the target agent's
+     * accepted set when the agent is known. Intersection only — the agent filter never adds a skill
+     * the user could not run. Unknown agent id (not in the user's runnable agents) → no narrowing.
+     */
+    skillsForTarget(targetAgentId) {
+        if (!targetAgentId) {
+            return this.skillsCache;
+        }
+        const agent = this.agentsCache.find(a => UUIDsEqual(a.ID, targetAgentId));
+        if (!agent) {
+            return this.skillsCache;
+        }
+        const engine = this.provider
+            ? AIEngineBase.GetProviderInstance(this.provider, AIEngineBase)
+            : AIEngineBase.Instance;
+        return IntersectAcceptedSkills(this.skillsCache, engine.GetSkillsForAgent(agent));
+    }
+    /**
+     * Get skill suggestions for '/'-mentions, ranked by query match. Each carries the skill's own
+     * IconClass/Color (UX metadata) so the dropdown + inserted chip render distinctly per skill.
+     */
+    getSkillSuggestions(query, targetAgentId = null) {
+        const lowerQuery = query.toLowerCase().trim();
+        const MAX_SUGGESTIONS = 12;
+        return this.skillsForTarget(targetAgentId)
+            .map(skill => ({
+            score: this.calculateMatchScore(skill.Name || '', lowerQuery),
+            suggestion: {
+                type: 'skill',
+                id: skill.ID,
+                name: skill.Name || 'Unknown Skill',
+                displayName: skill.Name || 'Unknown Skill',
+                description: skill.Description || undefined,
+                icon: skill.IconClass || this.defaultSkillIcon,
+                color: skill.Color || undefined
+            }
+        }))
+            .filter(x => x.score > 0 || !lowerQuery)
+            .sort((a, b) => {
+            if (b.score !== a.score)
+                return b.score - a.score;
+            return a.suggestion.name.localeCompare(b.suggestion.name);
+        })
+            .slice(0, MAX_SUGGESTIONS)
+            .map(x => x.suggestion);
+    }
+    /**
+     * Calculate match score for ranking
+     * Higher score = better match
+     */
+    calculateMatchScore(name, query) {
+        if (!query)
+            return 1; // Show all if no query
+        const lowerName = name.toLowerCase();
+        const lowerQuery = query.toLowerCase();
+        // Exact match
+        if (lowerName === lowerQuery)
+            return 100;
+        // Starts with
+        if (lowerName.startsWith(lowerQuery))
+            return 50;
+        // Contains
+        if (lowerName.includes(lowerQuery))
+            return 25;
+        // Word boundary match (e.g., "MA" matches "Marketing Agent")
+        const words = lowerName.split(/\s+/);
+        for (const word of words) {
+            if (word.startsWith(lowerQuery))
+                return 40;
+        }
+        return 0; // No match
+    }
+    /**
+     * Map an agent's AI Agent Configuration presets into the composer's generic
+     * `MentionSuggestionPreset` shape so the chip's preset picker works without the
+     * composer knowing anything about agents.
+     *
+     * IMPORTANT: preset.ID is the AIAgentConfiguration.ID (preset ID), not
+     * AIConfigurationID — the backend mapping converts preset ID -> AIConfigurationID.
+     */
+    getAgentPresets(agentId) {
+        try {
+            const presets = AIEngineBase.Instance.GetAgentConfigurationPresets(agentId, true);
+            if (!presets || presets.length === 0) {
+                return undefined;
+            }
+            return presets.map(p => ({
+                ID: p.ID,
+                Name: p.Name,
+                DisplayName: p.DisplayName || undefined,
+                Description: p.Description || undefined,
+                IsDefault: p.IsDefault
+            }));
+        }
+        catch {
+            // Presets are a chip nicety — never let them break suggestion building
+            return undefined;
+        }
+    }
+    /**
+     * Get icon for agent based on type/name
+     */
+    getAgentIcon(agent) {
+        // Use agent's icon if available, otherwise default based on type
+        if (agent.IconClass)
+            return agent.IconClass;
+        // Default icons based on agent name patterns
+        const name = agent.Name?.toLowerCase() || '';
+        if (name.includes('marketing'))
+            return 'fa-megaphone';
+        if (name.includes('data') || name.includes('analysis'))
+            return 'fa-chart-line';
+        if (name.includes('code') || name.includes('developer'))
+            return 'fa-code';
+        if (name.includes('design'))
+            return 'fa-palette';
+        if (name.includes('conversation') || name.includes('manager'))
+            return 'fa-comments';
+        return 'fa-robot'; // Default
+    }
+    /**
+     * Get available agents for parsing
+     */
+    GetAvailableAgents() {
+        return this.agentsCache;
+    }
+    /** @deprecated Use {@link GetAvailableAgents}. */
+    getAvailableAgents() {
+        return this.GetAvailableAgents();
+    }
+    /**
+     * Get available users for parsing
+     */
+    GetAvailableUsers() {
+        return this.usersCache;
+    }
+    /** @deprecated Use {@link GetAvailableUsers}. */
+    getAvailableUsers() {
+        return this.GetAvailableUsers();
+    }
+    /**
+     * Get available entities for parsing
+     */
+    GetAvailableEntities() {
+        return this.entitiesCache;
+    }
+    /** @deprecated Use {@link GetAvailableEntities}. */
+    getAvailableEntities() {
+        return this.GetAvailableEntities();
+    }
+    /**
+     * Get available queries for parsing
+     */
+    GetAvailableQueries() {
+        return this.queriesCache;
+    }
+    /** @deprecated Use {@link GetAvailableQueries}. */
+    getAvailableQueries() {
+        return this.GetAvailableQueries();
+    }
+    /**
+     * Get the generic icon used for all query mentions.
+     */
+    GetQueriesEntityIcon() {
+        return this.queriesEntityIcon;
+    }
+    /** @deprecated Use {@link GetQueriesEntityIcon}. */
+    getQueriesEntityIcon() {
+        return this.GetQueriesEntityIcon();
+    }
+    /**
+     * Refresh the caches
+     * Resets initialization state and reloads agents
+     */
+    async Refresh(currentUser) {
+        this.isInitialized = false;
+        this.initializationPromise = null;
+        await this.initialize(currentUser);
+    }
+    /** @deprecated Use {@link Refresh}. */
+    async refresh(currentUser) {
+        return this.Refresh(currentUser);
+    }
+}
+//# sourceMappingURL=MentionAutocomplete.js.map

package/dist/mentions/MentionAutocomplete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MentionAutocomplete.js","sourceRoot":"","sources":["../../src/mentions/MentionAutocomplete.ts"],"names":[],"mappings":"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"}

package/dist/mentions/MentionParser.d.ts

@@ -73,20 +73,28 @@ export declare class MentionParser {
      * }
      * ```
      */
+    ParseMentions(text: string, availableAgents: MJAIAgentEntityExtended[], availableUsers?: UserInfo[]): MentionParseResult;
+    /** @deprecated Use {@link ParseMentions}. */
     parseMentions(text: string, availableAgents: MJAIAgentEntityExtended[], availableUsers?: UserInfo[]): MentionParseResult;
     /**
      * Validate every mention in `text`. Returns an array of mention names that could not be
      * resolved to a known agent or user.
      */
+    ValidateMentions(text: string, availableAgents: MJAIAgentEntityExtended[], availableUsers?: UserInfo[]): string[];
+    /** @deprecated Use {@link ValidateMentions}. */
     validateMentions(text: string, availableAgents: MJAIAgentEntityExtended[], availableUsers?: UserInfo[]): string[];
     /**
      * Extract every raw mention name from `text` (no resolution against agents/users).
      */
+    ExtractMentionNames(text: string): string[];
+    /** @deprecated Use {@link ExtractMentionNames}. */
     extractMentionNames(text: string): string[];
     /**
      * Rewrite mentions in `text` to a canonical `@Name` format using the proper casing
      * from `mentions`. Useful when normalizing user-typed mentions before storage or display.
      */
+    FormatMentions(text: string, mentions: Mention[]): string;
+    /** @deprecated Use {@link FormatMentions}. */
     formatMentions(text: string, mentions: Mention[]): string;
     /**
      * Convert a message containing JSON-encoded mentions to plain text — `@{…}` blocks
@@ -99,6 +107,8 @@ export declare class MentionParser {
      * // Output: '@Sage help me'
      * ```
      */
+    ToPlainText(text: string, agents?: MJAIAgentEntityExtended[], users?: UserInfo[]): string;
+    /** @deprecated Use {@link ToPlainText}. */
     toPlainText(text: string, agents?: MJAIAgentEntityExtended[], users?: UserInfo[]): string;
     /**
      * Find an agent by name (case-insensitive). Tries exact match first, then starts-with.

package/dist/mentions/MentionParser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MentionParser.d.ts","sourceRoot":"","sources":["../../src/mentions/MentionParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,uBAAuB,EAAuB,MAAM,8BAA8B,CAAC;AAC5F,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,+BAA+B;AAC/B,MAAM,WAAW,OAAO;IACpB,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IAC/B,4CAA4C;IAC5C,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,uEAAuE;IACvE,YAAY,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,yBAAyB;IACzB,YAAY,EAAE,OAAO,EAAE,CAAC;IACxB,gEAAgE;IAChE,cAAc,EAAE,OAAO,EAAE,CAAC;IAC1B;;;;OAIG;IACH,aAAa,EAAE,OAAO,EAAE,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,qBAAa,aAAa;IACtB,kFAAkF;IAClF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAiB;IAEpD,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAwB;IAE7D;;;;;;;;;;;;;;;;;;;;;OAqBG;IACI,aAAa,CAChB,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,uBAAuB,EAAE,EAC1C,cAAc,CAAC,EAAE,QAAQ,EAAE,GAC5B,kBAAkB;IA+ErB;;;OAGG;IACI,gBAAgB,CACnB,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,uBAAuB,EAAE,EAC1C,cAAc,CAAC,EAAE,QAAQ,EAAE,GAC5B,MAAM,EAAE;IAoDX;;OAEG;IACI,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAsBlD;;;OAGG;IACI,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM;IAkBhE;;;;;;;;;;OAUG;IACI,WAAW,CACd,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,uBAAuB,EAAE,EAClC,KAAK,CAAC,EAAE,QAAQ,EAAE,GACnB,MAAM;IAkBT;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAiBjB;;;OAGG;IACH,OAAO,CAAC,QAAQ;CAenB"}
+{"version":3,"file":"MentionParser.d.ts","sourceRoot":"","sources":["../../src/mentions/MentionParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,uBAAuB,EAAuB,MAAM,8BAA8B,CAAC;AAC5F,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,+BAA+B;AAC/B,MAAM,WAAW,OAAO;IACpB,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IAC/B,4CAA4C;IAC5C,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,uEAAuE;IACvE,YAAY,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,yBAAyB;IACzB,YAAY,EAAE,OAAO,EAAE,CAAC;IACxB,gEAAgE;IAChE,cAAc,EAAE,OAAO,EAAE,CAAC;IAC1B;;;;OAIG;IACH,aAAa,EAAE,OAAO,EAAE,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,qBAAa,aAAa;IACtB,kFAAkF;IAClF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAiB;IAEpD,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAwB;IAE7D;;;;;;;;;;;;;;;;;;;;;OAqBG;IACI,aAAa,CAChB,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,uBAAuB,EAAE,EAC1C,cAAc,CAAC,EAAE,QAAQ,EAAE,GAC5B,kBAAkB;IA+ErB,6CAA6C;IACtC,aAAa,CAChB,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,uBAAuB,EAAE,EAC1C,cAAc,CAAC,EAAE,QAAQ,EAAE,GAC5B,kBAAkB;IAIrB;;;OAGG;IACI,gBAAgB,CACnB,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,uBAAuB,EAAE,EAC1C,cAAc,CAAC,EAAE,QAAQ,EAAE,GAC5B,MAAM,EAAE;IAoDX,gDAAgD;IACzC,gBAAgB,CACnB,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,uBAAuB,EAAE,EAC1C,cAAc,CAAC,EAAE,QAAQ,EAAE,GAC5B,MAAM,EAAE;IAIX;;OAEG;IACI,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAsBlD,mDAAmD;IAC5C,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAIlD;;;OAGG;IACI,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM;IAkBhE,8CAA8C;IACvC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM;IAIhE;;;;;;;;;;OAUG;IACI,WAAW,CACd,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,uBAAuB,EAAE,EAClC,KAAK,CAAC,EAAE,QAAQ,EAAE,GACnB,MAAM;IAkBT,2CAA2C;IACpC,WAAW,CACd,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,uBAAuB,EAAE,EAClC,KAAK,CAAC,EAAE,QAAQ,EAAE,GACnB,MAAM;IAIT;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAiBjB;;;OAGG;IACH,OAAO,CAAC,QAAQ;CAenB"}

package/dist/mentions/MentionParser.js

@@ -49,7 +49,7 @@ export class MentionParser {
      * }
      * ```
      */
-    parseMentions(text, availableAgents, availableUsers) {
+    ParseMentions(text, availableAgents, availableUsers) {
         const mentions = [];
         // First, try to parse JSON mentions (new format)
         const jsonMatches = Array.from(text.matchAll(this.JSON_MENTION_REGEX));
@@ -118,11 +118,15 @@ export class MentionParser {
         const skillMentions = mentions.filter((m) => m.type === 'skill');
         return { mentions, agentMention, userMentions, entityMentions, skillMentions };
     }
+    /** @deprecated Use {@link ParseMentions}. */
+    parseMentions(text, availableAgents, availableUsers) {
+        return this.ParseMentions(text, availableAgents, availableUsers);
+    }
     /**
      * Validate every mention in `text`. Returns an array of mention names that could not be
      * resolved to a known agent or user.
      */
-    validateMentions(text, availableAgents, availableUsers) {
+    ValidateMentions(text, availableAgents, availableUsers) {
         const invalidMentions = [];
         // Check JSON mentions first
         const jsonMatches = Array.from(text.matchAll(this.JSON_MENTION_REGEX));
@@ -171,10 +175,14 @@ export class MentionParser {
         }
         return invalidMentions;
     }
+    /** @deprecated Use {@link ValidateMentions}. */
+    validateMentions(text, availableAgents, availableUsers) {
+        return this.ValidateMentions(text, availableAgents, availableUsers);
+    }
     /**
      * Extract every raw mention name from `text` (no resolution against agents/users).
      */
-    extractMentionNames(text) {
+    ExtractMentionNames(text) {
         // Check JSON mentions first
         const jsonMatches = Array.from(text.matchAll(this.JSON_MENTION_REGEX));
         if (jsonMatches.length > 0) {
@@ -195,11 +203,15 @@ export class MentionParser {
         const matches = Array.from(text.matchAll(this.LEGACY_MENTION_REGEX));
         return matches.map((match) => match[1] || match[2]).filter(Boolean);
     }
+    /** @deprecated Use {@link ExtractMentionNames}. */
+    extractMentionNames(text) {
+        return this.ExtractMentionNames(text);
+    }
     /**
      * Rewrite mentions in `text` to a canonical `@Name` format using the proper casing
      * from `mentions`. Useful when normalizing user-typed mentions before storage or display.
      */
-    formatMentions(text, mentions) {
+    FormatMentions(text, mentions) {
         let formattedText = text;
         for (const mention of mentions) {
             // Find the mention in the text and replace with proper name
@@ -213,6 +225,10 @@ export class MentionParser {
         }
         return formattedText;
     }
+    /** @deprecated Use {@link FormatMentions}. */
+    formatMentions(text, mentions) {
+        return this.FormatMentions(text, mentions);
+    }
     /**
      * Convert a message containing JSON-encoded mentions to plain text — `@{…}` blocks
      * become simple `@Name` strings. Delegates to
@@ -224,7 +240,7 @@ export class MentionParser {
      * // Output: '@Sage help me'
      * ```
      */
-    toPlainText(text, agents, users) {
+    ToPlainText(text, agents, users) {
         if (!text)
             return '';
         // Convert agents to the AgentInfo format expected by ConversationUtility
@@ -239,6 +255,10 @@ export class MentionParser {
         }));
         return ConversationUtility.ToPlainText(text, agentInfos, userInfos);
     }
+    /** @deprecated Use {@link ToPlainText}. */
+    toPlainText(text, agents, users) {
+        return this.ToPlainText(text, agents, users);
+    }
     /**
      * Find an agent by name (case-insensitive). Tries exact match first, then starts-with.
      * Explicitly does NOT do a contains-match — that would be ambiguous when multiple agent