@memberjunction/ng-conversations 5.40.1 → 5.41.0

package/dist/lib/services/delegation-result-parser.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Pure parsing of the serialized realtime tool result (`ResultJson`) the server's
+ * `RealtimeToolBroker` produces — `{ success, output, runId?, artifacts? }` on success or
+ * `{ success: false, error }` on failure. Kept framework-free (no Angular / GraphQL
+ * imports) so it is unit-testable in isolation and the {@link RealtimeSessionService}
+ * stays focused on session orchestration.
+ */
+/**
+ * One artifact a delegated run produced, as reported in the tool ResultJson
+ * (`artifacts: [{ artifactId, artifactVersionId, name }]`). The call overlay opens each
+ * in its own artifact tab on the tabbed surface panel.
+ */
+export interface ParsedDelegationArtifact {
+    /** The `MJ: Artifacts` row id. */
+    ArtifactID: string;
+    /** The `MJ: Artifact Versions` row id of the version the run produced. */
+    ArtifactVersionID: string;
+    /** The artifact's display name (used as the tab title). */
+    Name: string;
+}
+/** The normalized shape a tool ResultJson parses into. */
+export interface ParsedDelegationResult {
+    /** Whether the delegated work succeeded (`success !== false`; non-JSON payloads default to true). */
+    Success: boolean;
+    /** The result text — the agent's output, or the structured error message on failure. */
+    Output: string;
+    /**
+     * ID of the delegated agent run (`MJ: AI Agent Runs`) when the server reported one
+     * (`runId` in the JSON). Lets developer tooling link straight to the run record.
+     */
+    RunID?: string;
+    /**
+     * Artifacts the delegated run produced, when the server reported any (`artifacts` in
+     * the JSON). Drives the overlay's auto-opened artifact tabs. `undefined` when absent,
+     * empty, or malformed.
+     */
+    Artifacts?: ParsedDelegationArtifact[];
+}
+/**
+ * Parses the broker's `{success, output, runId, artifacts}` | `{success:false, error}` ResultJson.
+ * If the payload isn't JSON, the raw string is surfaced as the output (success assumed) —
+ * mirroring the spoken path, which feeds whatever came back to the model verbatim.
+ */
+export declare function ParseDelegationResultJson(resultJson: string): ParsedDelegationResult;
+//# sourceMappingURL=delegation-result-parser.d.ts.map

package/dist/lib/services/delegation-result-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation-result-parser.d.ts","sourceRoot":"","sources":["../../../src/lib/services/delegation-result-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0DAA0D;AAC1D,MAAM,WAAW,sBAAsB;IACrC,qGAAqG;IACrG,OAAO,EAAE,OAAO,CAAC;IACjB,wFAAwF;IACxF,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,SAAS,CAAC,EAAE,wBAAwB,EAAE,CAAC;CACxC;AASD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,sBAAsB,CAkBpF"}

package/dist/lib/services/delegation-result-parser.js

@@ -0,0 +1,48 @@
+/**
+ * Pure parsing of the serialized realtime tool result (`ResultJson`) the server's
+ * `RealtimeToolBroker` produces — `{ success, output, runId?, artifacts? }` on success or
+ * `{ success: false, error }` on failure. Kept framework-free (no Angular / GraphQL
+ * imports) so it is unit-testable in isolation and the {@link RealtimeSessionService}
+ * stays focused on session orchestration.
+ */
+/**
+ * Parses the broker's `{success, output, runId, artifacts}` | `{success:false, error}` ResultJson.
+ * If the payload isn't JSON, the raw string is surfaced as the output (success assumed) —
+ * mirroring the spoken path, which feeds whatever came back to the model verbatim.
+ */
+export function ParseDelegationResultJson(resultJson) {
+    try {
+        const parsed = JSON.parse(resultJson);
+        return {
+            Success: parsed.success !== false,
+            Output: parsed.output ?? parsed.error ?? '',
+            RunID: typeof parsed.runId === 'string' && parsed.runId.length > 0 ? parsed.runId : undefined,
+            Artifacts: parseArtifacts(parsed.artifacts)
+        };
+    }
+    catch {
+        return { Success: true, Output: resultJson };
+    }
+}
+/**
+ * Normalizes the raw `artifacts` array: entries must carry non-empty `artifactId` and
+ * `artifactVersionId` strings (malformed entries are dropped); a missing/blank `name`
+ * falls back to `"Artifact"`. Returns `undefined` when nothing valid remains.
+ */
+function parseArtifacts(raw) {
+    if (!Array.isArray(raw)) {
+        return undefined;
+    }
+    const artifacts = [];
+    for (const entry of raw) {
+        const artifactId = typeof entry?.artifactId === 'string' ? entry.artifactId : '';
+        const versionId = typeof entry?.artifactVersionId === 'string' ? entry.artifactVersionId : '';
+        if (artifactId.length === 0 || versionId.length === 0) {
+            continue;
+        }
+        const name = typeof entry.name === 'string' && entry.name.trim().length > 0 ? entry.name.trim() : 'Artifact';
+        artifacts.push({ ArtifactID: artifactId, ArtifactVersionID: versionId, Name: name });
+    }
+    return artifacts.length > 0 ? artifacts : undefined;
+}
+//# sourceMappingURL=delegation-result-parser.js.map

package/dist/lib/services/delegation-result-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation-result-parser.js","sourceRoot":"","sources":["../../../src/lib/services/delegation-result-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0CH;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,UAAkB;IAC1D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAMnC,CAAC;QACF,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO,KAAK,KAAK;YACjC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE;YAC3C,KAAK,EAAE,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;YAC7F,SAAS,EAAE,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC;SAC5C,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC/C,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,GAAY;IAClC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,SAAS,GAA+B,EAAE,CAAC;IACjD,KAAK,MAAM,KAAK,IAAI,GAA8B,EAAE,CAAC;QACnD,MAAM,UAAU,GAAG,OAAO,KAAK,EAAE,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,MAAM,SAAS,GAAG,OAAO,KAAK,EAAE,iBAAiB,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9F,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtD,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;QAC7G,SAAS,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC","sourcesContent":["/**\n * Pure parsing of the serialized realtime tool result (`ResultJson`) the server's\n * `RealtimeToolBroker` produces — `{ success, output, runId?, artifacts? }` on success or\n * `{ success: false, error }` on failure. Kept framework-free (no Angular / GraphQL\n * imports) so it is unit-testable in isolation and the {@link RealtimeSessionService}\n * stays focused on session orchestration.\n */\n\n/**\n * One artifact a delegated run produced, as reported in the tool ResultJson\n * (`artifacts: [{ artifactId, artifactVersionId, name }]`). The call overlay opens each\n * in its own artifact tab on the tabbed surface panel.\n */\nexport interface ParsedDelegationArtifact {\n  /** The `MJ: Artifacts` row id. */\n  ArtifactID: string;\n  /** The `MJ: Artifact Versions` row id of the version the run produced. */\n  ArtifactVersionID: string;\n  /** The artifact's display name (used as the tab title). */\n  Name: string;\n}\n\n/** The normalized shape a tool ResultJson parses into. */\nexport interface ParsedDelegationResult {\n  /** Whether the delegated work succeeded (`success !== false`; non-JSON payloads default to true). */\n  Success: boolean;\n  /** The result text — the agent's output, or the structured error message on failure. */\n  Output: string;\n  /**\n   * ID of the delegated agent run (`MJ: AI Agent Runs`) when the server reported one\n   * (`runId` in the JSON). Lets developer tooling link straight to the run record.\n   */\n  RunID?: string;\n  /**\n   * Artifacts the delegated run produced, when the server reported any (`artifacts` in\n   * the JSON). Drives the overlay's auto-opened artifact tabs. `undefined` when absent,\n   * empty, or malformed.\n   */\n  Artifacts?: ParsedDelegationArtifact[];\n}\n\n/** The raw camelCase artifact entry shape the broker serializes. */\ninterface RawDelegationArtifact {\n  artifactId?: unknown;\n  artifactVersionId?: unknown;\n  name?: unknown;\n}\n\n/**\n * Parses the broker's `{success, output, runId, artifacts}` | `{success:false, error}` ResultJson.\n * If the payload isn't JSON, the raw string is surfaced as the output (success assumed) —\n * mirroring the spoken path, which feeds whatever came back to the model verbatim.\n */\nexport function ParseDelegationResultJson(resultJson: string): ParsedDelegationResult {\n  try {\n    const parsed = JSON.parse(resultJson) as {\n      success?: boolean;\n      output?: string;\n      error?: string;\n      runId?: string;\n      artifacts?: unknown;\n    };\n    return {\n      Success: parsed.success !== false,\n      Output: parsed.output ?? parsed.error ?? '',\n      RunID: typeof parsed.runId === 'string' && parsed.runId.length > 0 ? parsed.runId : undefined,\n      Artifacts: parseArtifacts(parsed.artifacts)\n    };\n  } catch {\n    return { Success: true, Output: resultJson };\n  }\n}\n\n/**\n * Normalizes the raw `artifacts` array: entries must carry non-empty `artifactId` and\n * `artifactVersionId` strings (malformed entries are dropped); a missing/blank `name`\n * falls back to `\"Artifact\"`. Returns `undefined` when nothing valid remains.\n */\nfunction parseArtifacts(raw: unknown): ParsedDelegationArtifact[] | undefined {\n  if (!Array.isArray(raw)) {\n    return undefined;\n  }\n  const artifacts: ParsedDelegationArtifact[] = [];\n  for (const entry of raw as RawDelegationArtifact[]) {\n    const artifactId = typeof entry?.artifactId === 'string' ? entry.artifactId : '';\n    const versionId = typeof entry?.artifactVersionId === 'string' ? entry.artifactVersionId : '';\n    if (artifactId.length === 0 || versionId.length === 0) {\n      continue;\n    }\n    const name = typeof entry.name === 'string' && entry.name.trim().length > 0 ? entry.name.trim() : 'Artifact';\n    artifacts.push({ ArtifactID: artifactId, ArtifactVersionID: versionId, Name: name });\n  }\n  return artifacts.length > 0 ? artifacts : undefined;\n}\n"]}

package/dist/lib/services/mention-autocomplete.service.d.ts

@@ -1,11 +1,11 @@
 import { MJAIAgentEntityExtended } from '@memberjunction/ai-core-plus';
-import { UserInfo } from '@memberjunction/core';
+import { UserInfo, EntityInfo, IMetadataProvider } from '@memberjunction/core';
 import * as i0 from "@angular/core";
 /**
  * Item in the autocomplete dropdown
  */
 export interface MentionSuggestion {
-    type: 'agent' | 'user';
+    type: 'agent' | 'user' | 'entity';
     id: string;
     name: string;
     displayName: string;
@@ -20,6 +20,7 @@ export interface MentionSuggestion {
 export declare class MentionAutocompleteService {
     private agentsCache;
     private usersCache;
+    private entitiesCache;
     private isInitialized;
     private initializationPromise;
     constructor();
@@ -27,7 +28,7 @@ export declare class MentionAutocompleteService {
      * Initialize the service by loading agents and users
      * Prevents concurrent initialization with promise lock
      */
-    initialize(currentUser: UserInfo): Promise<void>;
+    initialize(currentUser: UserInfo, provider?: IMetadataProvider): Promise<void>;
     /**
      * Internal initialization logic
      */
@@ -38,13 +39,23 @@ export declare class MentionAutocompleteService {
      * Agents with explicit permission records are checked against the user.
      */
     private filterAgentsByRunPermission;
+    /**
+     * Load entities the current user has read permission for.
+     * These are the candidates surfaced for #entity mentions.
+     */
+    private loadReadableEntities;
     /**
      * Get suggestions based on search query
      * @param query The search text after @ symbol
      * @param includeUsers Whether to include users in suggestions
      * @returns Filtered and ranked suggestions
      */
-    getSuggestions(query: string, includeUsers?: boolean): MentionSuggestion[];
+    getSuggestions(query: string, includeUsers?: boolean, trigger?: string): MentionSuggestion[];
+    /**
+     * Get entity suggestions for #entity mentions, ranked by query match.
+     * Capped to keep the dropdown light (entity sets can be large).
+     */
+    private getEntitySuggestions;
     /**
      * Calculate match score for ranking
      * Higher score = better match
@@ -62,6 +73,10 @@ export declare class MentionAutocompleteService {
      * Get available users for parsing
      */
     getAvailableUsers(): UserInfo[];
+    /**
+     * Get available entities for parsing
+     */
+    getAvailableEntities(): EntityInfo[];
     /**
      * Refresh the caches
      * Resets initialization state and reloads agents

package/dist/lib/services/mention-autocomplete.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mention-autocomplete.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/mention-autocomplete.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;;AAGhD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,qBAGa,0BAA0B;IACrC,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,qBAAqB,CAA8B;;IAI3D;;;OAGG;IACG,UAAU,CAAC,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBtD;;OAEG;YACW,mBAAmB;IA0BjC;;;;OAIG;YACW,2BAA2B;IAkBzC;;;;;OAKG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,GAAE,OAAc,GAAG,iBAAiB,EAAE;IAmDhF;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAwB3B;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACH,kBAAkB,IAAI,uBAAuB,EAAE;IAI/C;;OAEG;IACH,iBAAiB,IAAI,QAAQ,EAAE;IAI/B;;;OAGG;IACG,OAAO,CAAC,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;yCA9MxC,0BAA0B;6CAA1B,0BAA0B;CAmNtC"}
+{"version":3,"file":"mention-autocomplete.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/mention-autocomplete.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAY,UAAU,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;;AAGzF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,qBAGa,0BAA0B;IACrC,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,qBAAqB,CAA8B;;IAI3D;;;OAGG;IACG,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBpF;;OAEG;YACW,mBAAmB;IA6BjC;;;;OAIG;YACW,2BAA2B;IAkBzC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAiB5B;;;;;OAKG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,GAAE,OAAc,EAAE,OAAO,GAAE,MAAY,GAAG,iBAAiB,EAAE;IAwDvG;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAsB5B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAwB3B;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACH,kBAAkB,IAAI,uBAAuB,EAAE;IAI/C;;OAEG;IACH,iBAAiB,IAAI,QAAQ,EAAE;IAI/B;;OAEG;IACH,oBAAoB,IAAI,UAAU,EAAE;IAIpC;;;OAGG;IACG,OAAO,CAAC,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;yCA7QxC,0BAA0B;6CAA1B,0BAA0B;CAkRtC"}

package/dist/lib/services/mention-autocomplete.service.js

@@ -1,4 +1,5 @@
 import { Injectable } from '@angular/core';
+import { Metadata } from '@memberjunction/core';
 import { AIEngineBase, AIAgentPermissionHelper } from '@memberjunction/ai-engine-base';
 import * as i0 from "@angular/core";
 /**
@@ -7,6 +8,7 @@ import * as i0 from "@angular/core";
 export class MentionAutocompleteService {
     agentsCache = [];
     usersCache = [];
+    entitiesCache = [];
     isInitialized = false;
     initializationPromise = null;
     constructor() { }
@@ -14,7 +16,7 @@ export class MentionAutocompleteService {
      * Initialize the service by loading agents and users
      * Prevents concurrent initialization with promise lock
      */
-    async initialize(currentUser) {
+    async initialize(currentUser, provider) {
         // If already initialized, return immediately
         if (this.isInitialized) {
             return;
@@ -24,7 +26,7 @@ export class MentionAutocompleteService {
             return this.initializationPromise;
         }
         // Create initialization promise and store it
-        this.initializationPromise = this._initializeInternal(currentUser);
+        this.initializationPromise = this._initializeInternal(currentUser, provider);
         try {
             await this.initializationPromise;
         }
@@ -35,7 +37,7 @@ export class MentionAutocompleteService {
     /**
      * Internal initialization logic
      */
-    async _initializeInternal(currentUser) {
+    async _initializeInternal(currentUser, provider) {
         try {
             // Load agents from AIEngineBase
             await AIEngineBase.Instance.Config(false);
@@ -47,6 +49,8 @@ export class MentionAutocompleteService {
             // 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);
             this.isInitialized = true;
         }
         catch (error) {
@@ -74,13 +78,39 @@ export class MentionAutocompleteService {
         }
         return permitted;
     }
+    /**
+     * Load entities the current user has read permission for.
+     * These are the candidates surfaced for #entity mentions.
+     */
+    loadReadableEntities(user, provider) {
+        try {
+            const md = provider ?? new Metadata();
+            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 [];
+        }
+    }
     /**
      * Get suggestions based on search query
      * @param query The search text after @ symbol
      * @param includeUsers Whether to include users in suggestions
      * @returns Filtered and ranked suggestions
      */
-    getSuggestions(query, includeUsers = true) {
+    getSuggestions(query, includeUsers = true, trigger = '@') {
+        // The '#' trigger searches entities; '@' searches agents + users
+        if (trigger === '#') {
+            return this.getEntitySuggestions(query);
+        }
         const lowerQuery = query.toLowerCase().trim();
         const suggestions = [];
         // Add agent suggestions
@@ -127,6 +157,31 @@ export class MentionAutocompleteService {
             return a.name.localeCompare(b.name);
         });
     }
+    /**
+     * Get entity suggestions for #entity mentions, ranked by query match.
+     * Capped to keep the dropdown light (entity sets can be large).
+     */
+    getEntitySuggestions(query) {
+        const lowerQuery = query.toLowerCase().trim();
+        const MAX_ENTITY_SUGGESTIONS = 12;
+        return this.entitiesCache
+            .map(entity => ({ entity, score: this.calculateMatchScore(entity.Name || '', lowerQuery) }))
+            .filter(x => x.score > 0 || !lowerQuery)
+            .sort((a, b) => {
+            if (b.score !== a.score)
+                return b.score - a.score;
+            return (a.entity.Name || '').localeCompare(b.entity.Name || '');
+        })
+            .slice(0, MAX_ENTITY_SUGGESTIONS)
+            .map(({ entity }) => ({
+            type: 'entity',
+            id: entity.ID,
+            name: entity.Name,
+            displayName: entity.Name,
+            description: entity.Description || undefined,
+            icon: 'fa-solid fa-table'
+        }));
+    }
     /**
      * Calculate match score for ranking
      * Higher score = better match
@@ -186,6 +241,12 @@ export class MentionAutocompleteService {
     getAvailableUsers() {
         return this.usersCache;
     }
+    /**
+     * Get available entities for parsing
+     */
+    getAvailableEntities() {
+        return this.entitiesCache;
+    }
     /**
      * Refresh the caches
      * Resets initialization state and reloads agents

package/dist/lib/services/mention-autocomplete.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"mention-autocomplete.service.js","sourceRoot":"","sources":["../../../src/lib/services/mention-autocomplete.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { Injectable } from '@angular/core';\nimport { MJAIAgentEntityExtended } from '@memberjunction/ai-core-plus';\nimport { UserInfo } from '@memberjunction/core';\nimport { AIEngineBase, AIAgentPermissionHelper } from '@memberjunction/ai-engine-base';\n\n/**\n * Item in the autocomplete dropdown\n */\nexport interface MentionSuggestion {\n  type: 'agent' | 'user';\n  id: string;\n  name: string;\n  displayName: string;\n  description?: string;\n  avatarUrl?: string; // Deprecated, use imageUrl\n  imageUrl?: string; // For agent LogoURL or user avatar\n  icon?: string; // For agents (FontAwesome class)\n}\n\n/**\n * Service for autocomplete suggestions when typing @mentions\n */\n@Injectable({\n  providedIn: 'root'\n})\nexport class MentionAutocompleteService {\n  private agentsCache: MJAIAgentEntityExtended[] = [];\n  private usersCache: UserInfo[] = [];\n  private isInitialized = false;\n  private initializationPromise: Promise<void> | null = null;\n\n  constructor() {}\n\n  /**\n   * Initialize the service by loading agents and users\n   * Prevents concurrent initialization with promise lock\n   */\n  async initialize(currentUser: UserInfo): Promise<void> {\n    // If already initialized, return immediately\n    if (this.isInitialized) {\n      return;\n    }\n\n    // If initialization is in progress, wait for it\n    if (this.initializationPromise) {\n      return this.initializationPromise;\n    }\n\n    // Create initialization promise and store it\n    this.initializationPromise = this._initializeInternal(currentUser);\n\n    try {\n      await this.initializationPromise;\n    } finally {\n      this.initializationPromise = null;\n    }\n  }\n\n  /**\n   * Internal initialization logic\n   */\n  private async _initializeInternal(currentUser: UserInfo): Promise<void> {\n    try {\n      // Load agents from AIEngineBase\n      await AIEngineBase.Instance.Config(false);\n\n      const allAgents = AIEngineBase.Instance.Agents || [];\n\n      // Filter by status, hierarchy, and invocation mode first\n      const candidateAgents = allAgents.filter(\n        a => !a.ParentID && a.Status === 'Active' && a.InvocationMode !== 'Sub-Agent' && !a.IsRestricted\n      );\n\n      // Filter by user's 'run' permission — respects open-by-default + explicit permissions\n      this.agentsCache = await this.filterAgentsByRunPermission(candidateAgents, currentUser);\n\n      // Load users from the system (optional - can be expanded later)\n      // For now, we'll just use the current user\n      this.usersCache = [currentUser];\n\n      this.isInitialized = true;\n    } catch (error) {\n      console.error('Failed to initialize MentionAutocompleteService:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Filter agents to only those the current user has 'run' permission for.\n   * Agents with no permission records are open to everyone (canRun = true).\n   * Agents with explicit permission records are checked against the user.\n   */\n  private async filterAgentsByRunPermission(\n    agents: MJAIAgentEntityExtended[],\n    user: UserInfo\n  ): Promise<MJAIAgentEntityExtended[]> {\n    const permitted: MJAIAgentEntityExtended[] = [];\n    for (const agent of agents) {\n      try {\n        const canRun = await AIAgentPermissionHelper.HasPermission(agent.ID, user, 'run');\n        if (canRun) {\n          permitted.push(agent);\n        }\n      } catch {\n        // Fail closed — exclude agent on error\n      }\n    }\n    return permitted;\n  }\n\n  /**\n   * Get suggestions based on search query\n   * @param query The search text after @ symbol\n   * @param includeUsers Whether to include users in suggestions\n   * @returns Filtered and ranked suggestions\n   */\n  getSuggestions(query: string, includeUsers: boolean = true): MentionSuggestion[] {\n    const lowerQuery = query.toLowerCase().trim();\n    const suggestions: MentionSuggestion[] = [];\n\n    // Add agent suggestions\n    for (const agent of this.agentsCache) {\n      const score = this.calculateMatchScore(agent.Name || '', lowerQuery);\n      if (score > 0 || !lowerQuery) {\n        suggestions.push({\n          type: 'agent',\n          id: agent.ID,\n          name: agent.Name || 'Unknown',\n          displayName: agent.Name || 'Unknown',\n          description: agent.Description || undefined,\n          imageUrl: agent.LogoURL || undefined, // Agent logo/avatar image\n          icon: this.getAgentIcon(agent)\n        });\n      }\n    }\n\n    // Add user suggestions (if enabled)\n    if (includeUsers) {\n      for (const user of this.usersCache) {\n        const score = this.calculateMatchScore(user.Name, lowerQuery);\n        if (score > 0 || !lowerQuery) {\n          suggestions.push({\n            type: 'user',\n            id: user.ID,\n            name: user.Name,\n            displayName: user.Name,\n            description: user.Email || undefined,\n            avatarUrl: undefined // Future: load user avatars\n          });\n        }\n      }\n    }\n\n    // Sort by relevance: exact match > starts with > contains\n    return suggestions.sort((a, b) => {\n      const scoreA = this.calculateMatchScore(a.name, lowerQuery);\n      const scoreB = this.calculateMatchScore(b.name, lowerQuery);\n      if (scoreB !== scoreA) return scoreB - scoreA;\n\n      // If scores are equal, sort agents before users\n      if (a.type !== b.type) return a.type === 'agent' ? -1 : 1;\n\n      // Otherwise alphabetically\n      return a.name.localeCompare(b.name);\n    });\n  }\n\n  /**\n   * Calculate match score for ranking\n   * Higher score = better match\n   */\n  private calculateMatchScore(name: string, query: string): number {\n    if (!query) return 1; // Show all if no query\n\n    const lowerName = name.toLowerCase();\n    const lowerQuery = query.toLowerCase();\n\n    // Exact match\n    if (lowerName === lowerQuery) return 100;\n\n    // Starts with\n    if (lowerName.startsWith(lowerQuery)) return 50;\n\n    // Contains\n    if (lowerName.includes(lowerQuery)) return 25;\n\n    // Word boundary match (e.g., \"MA\" matches \"Marketing Agent\")\n    const words = lowerName.split(/\\s+/);\n    for (const word of words) {\n      if (word.startsWith(lowerQuery)) return 40;\n    }\n\n    return 0; // No match\n  }\n\n  /**\n   * Get icon for agent based on type/name\n   */\n  private getAgentIcon(agent: MJAIAgentEntityExtended): string {\n    // Use agent's icon if available, otherwise default based on type\n    if (agent.IconClass) return agent.IconClass;\n\n    // Default icons based on agent name patterns\n    const name = agent.Name?.toLowerCase() || '';\n    if (name.includes('marketing')) return 'fa-megaphone';\n    if (name.includes('data') || name.includes('analysis')) return 'fa-chart-line';\n    if (name.includes('code') || name.includes('developer')) return 'fa-code';\n    if (name.includes('design')) return 'fa-palette';\n    if (name.includes('conversation') || name.includes('manager')) return 'fa-comments';\n\n    return 'fa-robot'; // Default\n  }\n\n  /**\n   * Get available agents for parsing\n   */\n  getAvailableAgents(): MJAIAgentEntityExtended[] {\n    return this.agentsCache;\n  }\n\n  /**\n   * Get available users for parsing\n   */\n  getAvailableUsers(): UserInfo[] {\n    return this.usersCache;\n  }\n\n  /**\n   * Refresh the caches\n   * Resets initialization state and reloads agents\n   */\n  async refresh(currentUser: UserInfo): Promise<void> {\n    this.isInitialized = false;\n    this.initializationPromise = null;\n    await this.initialize(currentUser);\n  }\n}\n"]}
+{"version":3,"file":"mention-autocomplete.service.js","sourceRoot":"","sources":["../../../src/lib/services/mention-autocomplete.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { Injectable } from '@angular/core';\nimport { MJAIAgentEntityExtended } from '@memberjunction/ai-core-plus';\nimport { UserInfo, Metadata, EntityInfo, IMetadataProvider } from '@memberjunction/core';\nimport { AIEngineBase, AIAgentPermissionHelper } from '@memberjunction/ai-engine-base';\n\n/**\n * Item in the autocomplete dropdown\n */\nexport interface MentionSuggestion {\n  type: 'agent' | 'user' | 'entity';\n  id: string;\n  name: string;\n  displayName: string;\n  description?: string;\n  avatarUrl?: string; // Deprecated, use imageUrl\n  imageUrl?: string; // For agent LogoURL or user avatar\n  icon?: string; // For agents (FontAwesome class)\n}\n\n/**\n * Service for autocomplete suggestions when typing @mentions\n */\n@Injectable({\n  providedIn: 'root'\n})\nexport class MentionAutocompleteService {\n  private agentsCache: MJAIAgentEntityExtended[] = [];\n  private usersCache: UserInfo[] = [];\n  private entitiesCache: EntityInfo[] = [];\n  private isInitialized = false;\n  private initializationPromise: Promise<void> | null = null;\n\n  constructor() {}\n\n  /**\n   * Initialize the service by loading agents and users\n   * Prevents concurrent initialization with promise lock\n   */\n  async initialize(currentUser: UserInfo, provider?: IMetadataProvider): Promise<void> {\n    // If already initialized, return immediately\n    if (this.isInitialized) {\n      return;\n    }\n\n    // If initialization is in progress, wait for it\n    if (this.initializationPromise) {\n      return this.initializationPromise;\n    }\n\n    // Create initialization promise and store it\n    this.initializationPromise = this._initializeInternal(currentUser, provider);\n\n    try {\n      await this.initializationPromise;\n    } finally {\n      this.initializationPromise = null;\n    }\n  }\n\n  /**\n   * Internal initialization logic\n   */\n  private async _initializeInternal(currentUser: UserInfo, provider?: IMetadataProvider): Promise<void> {\n    try {\n      // Load agents from AIEngineBase\n      await AIEngineBase.Instance.Config(false);\n\n      const allAgents = AIEngineBase.Instance.Agents || [];\n\n      // Filter by status, hierarchy, and invocation mode first\n      const candidateAgents = allAgents.filter(\n        a => !a.ParentID && a.Status === 'Active' && a.InvocationMode !== 'Sub-Agent' && !a.IsRestricted\n      );\n\n      // Filter by user's 'run' permission — respects open-by-default + explicit permissions\n      this.agentsCache = await this.filterAgentsByRunPermission(candidateAgents, currentUser);\n\n      // Load users from the system (optional - can be expanded later)\n      // For now, we'll just use the current user\n      this.usersCache = [currentUser];\n\n      // Load entities the current user can read (candidates for #entity mentions)\n      this.entitiesCache = this.loadReadableEntities(currentUser, provider);\n\n      this.isInitialized = true;\n    } catch (error) {\n      console.error('Failed to initialize MentionAutocompleteService:', error);\n      throw error;\n    }\n  }\n\n  /**\n   * Filter agents to only those the current user has 'run' permission for.\n   * Agents with no permission records are open to everyone (canRun = true).\n   * Agents with explicit permission records are checked against the user.\n   */\n  private async filterAgentsByRunPermission(\n    agents: MJAIAgentEntityExtended[],\n    user: UserInfo\n  ): Promise<MJAIAgentEntityExtended[]> {\n    const permitted: MJAIAgentEntityExtended[] = [];\n    for (const agent of agents) {\n      try {\n        const canRun = await AIAgentPermissionHelper.HasPermission(agent.ID, user, 'run');\n        if (canRun) {\n          permitted.push(agent);\n        }\n      } catch {\n        // Fail closed — exclude agent on error\n      }\n    }\n    return permitted;\n  }\n\n  /**\n   * Load entities the current user has read permission for.\n   * These are the candidates surfaced for #entity mentions.\n   */\n  private loadReadableEntities(user: UserInfo, provider?: IMetadataProvider): EntityInfo[] {\n    try {\n      const md = provider ?? new Metadata();\n      return (md.Entities || []).filter(entity => {\n        try {\n          return entity.GetUserPermisions(user).CanRead;\n        } catch {\n          // Fail closed — exclude entity on permission-check error\n          return false;\n        }\n      });\n    } catch (error) {\n      console.error('Failed to load entities for mention autocomplete:', error);\n      return [];\n    }\n  }\n\n  /**\n   * Get suggestions based on search query\n   * @param query The search text after @ symbol\n   * @param includeUsers Whether to include users in suggestions\n   * @returns Filtered and ranked suggestions\n   */\n  getSuggestions(query: string, includeUsers: boolean = true, trigger: string = '@'): MentionSuggestion[] {\n    // The '#' trigger searches entities; '@' searches agents + users\n    if (trigger === '#') {\n      return this.getEntitySuggestions(query);\n    }\n\n    const lowerQuery = query.toLowerCase().trim();\n    const suggestions: MentionSuggestion[] = [];\n\n    // Add agent suggestions\n    for (const agent of this.agentsCache) {\n      const score = this.calculateMatchScore(agent.Name || '', lowerQuery);\n      if (score > 0 || !lowerQuery) {\n        suggestions.push({\n          type: 'agent',\n          id: agent.ID,\n          name: agent.Name || 'Unknown',\n          displayName: agent.Name || 'Unknown',\n          description: agent.Description || undefined,\n          imageUrl: agent.LogoURL || undefined, // Agent logo/avatar image\n          icon: this.getAgentIcon(agent)\n        });\n      }\n    }\n\n    // Add user suggestions (if enabled)\n    if (includeUsers) {\n      for (const user of this.usersCache) {\n        const score = this.calculateMatchScore(user.Name, lowerQuery);\n        if (score > 0 || !lowerQuery) {\n          suggestions.push({\n            type: 'user',\n            id: user.ID,\n            name: user.Name,\n            displayName: user.Name,\n            description: user.Email || undefined,\n            avatarUrl: undefined // Future: load user avatars\n          });\n        }\n      }\n    }\n\n    // Sort by relevance: exact match > starts with > contains\n    return suggestions.sort((a, b) => {\n      const scoreA = this.calculateMatchScore(a.name, lowerQuery);\n      const scoreB = this.calculateMatchScore(b.name, lowerQuery);\n      if (scoreB !== scoreA) return scoreB - scoreA;\n\n      // If scores are equal, sort agents before users\n      if (a.type !== b.type) return a.type === 'agent' ? -1 : 1;\n\n      // Otherwise alphabetically\n      return a.name.localeCompare(b.name);\n    });\n  }\n\n  /**\n   * Get entity suggestions for #entity mentions, ranked by query match.\n   * Capped to keep the dropdown light (entity sets can be large).\n   */\n  private getEntitySuggestions(query: string): MentionSuggestion[] {\n    const lowerQuery = query.toLowerCase().trim();\n    const MAX_ENTITY_SUGGESTIONS = 12;\n\n    return this.entitiesCache\n      .map(entity => ({ entity, score: this.calculateMatchScore(entity.Name || '', lowerQuery) }))\n      .filter(x => x.score > 0 || !lowerQuery)\n      .sort((a, b) => {\n        if (b.score !== a.score) return b.score - a.score;\n        return (a.entity.Name || '').localeCompare(b.entity.Name || '');\n      })\n      .slice(0, MAX_ENTITY_SUGGESTIONS)\n      .map(({ entity }) => ({\n        type: 'entity' as const,\n        id: entity.ID,\n        name: entity.Name,\n        displayName: entity.Name,\n        description: entity.Description || undefined,\n        icon: 'fa-solid fa-table'\n      }));\n  }\n\n  /**\n   * Calculate match score for ranking\n   * Higher score = better match\n   */\n  private calculateMatchScore(name: string, query: string): number {\n    if (!query) return 1; // Show all if no query\n\n    const lowerName = name.toLowerCase();\n    const lowerQuery = query.toLowerCase();\n\n    // Exact match\n    if (lowerName === lowerQuery) return 100;\n\n    // Starts with\n    if (lowerName.startsWith(lowerQuery)) return 50;\n\n    // Contains\n    if (lowerName.includes(lowerQuery)) return 25;\n\n    // Word boundary match (e.g., \"MA\" matches \"Marketing Agent\")\n    const words = lowerName.split(/\\s+/);\n    for (const word of words) {\n      if (word.startsWith(lowerQuery)) return 40;\n    }\n\n    return 0; // No match\n  }\n\n  /**\n   * Get icon for agent based on type/name\n   */\n  private getAgentIcon(agent: MJAIAgentEntityExtended): string {\n    // Use agent's icon if available, otherwise default based on type\n    if (agent.IconClass) return agent.IconClass;\n\n    // Default icons based on agent name patterns\n    const name = agent.Name?.toLowerCase() || '';\n    if (name.includes('marketing')) return 'fa-megaphone';\n    if (name.includes('data') || name.includes('analysis')) return 'fa-chart-line';\n    if (name.includes('code') || name.includes('developer')) return 'fa-code';\n    if (name.includes('design')) return 'fa-palette';\n    if (name.includes('conversation') || name.includes('manager')) return 'fa-comments';\n\n    return 'fa-robot'; // Default\n  }\n\n  /**\n   * Get available agents for parsing\n   */\n  getAvailableAgents(): MJAIAgentEntityExtended[] {\n    return this.agentsCache;\n  }\n\n  /**\n   * Get available users for parsing\n   */\n  getAvailableUsers(): UserInfo[] {\n    return this.usersCache;\n  }\n\n  /**\n   * Get available entities for parsing\n   */\n  getAvailableEntities(): EntityInfo[] {\n    return this.entitiesCache;\n  }\n\n  /**\n   * Refresh the caches\n   * Resets initialization state and reloads agents\n   */\n  async refresh(currentUser: UserInfo): Promise<void> {\n    this.isInitialized = false;\n    this.initializationPromise = null;\n    await this.initialize(currentUser);\n  }\n}\n"]}

package/dist/lib/services/mention-parser.service.d.ts

@@ -1,64 +1,19 @@
-import { Mention, MentionParseResult } from '../models/conversation-state.model';
+import type { Mention, MentionParseResult } from '@memberjunction/conversations-runtime';
 import { MJAIAgentEntityExtended } from '@memberjunction/ai-core-plus';
 import { UserInfo } from '@memberjunction/core';
+import { ConversationsRuntimeBootstrap } from './conversations-runtime-bootstrap.service';
 import * as i0 from "@angular/core";
-/**
- * Service for parsing @mentions from message text
- * Supports both JSON format and legacy text format
- */
 export declare class MentionParserService {
-    private readonly JSON_MENTION_REGEX;
-    private readonly LEGACY_MENTION_REGEX;
-    constructor();
-    /**
-     * Parse mentions from message text
-     * Supports both JSON format (@{type:"agent",id:"uuid",...}) and legacy text format (@AgentName)
-     * @param text The message text to parse
-     * @param availableAgents List of available agents for matching
-     * @param availableUsers List of available users for matching (optional)
-     * @returns Parsed mentions with agent and user separation
-     */
+    constructor(_bootstrap: ConversationsRuntimeBootstrap);
+    /** Pass-through to {@link ConversationsRuntime.Instance.Mentions.parseMentions}. */
     parseMentions(text: string, availableAgents: MJAIAgentEntityExtended[], availableUsers?: UserInfo[]): MentionParseResult;
-    /**
-     * Find an agent by name (case-insensitive)
-     * Uses exact match or starts-with match (no contains match to avoid ambiguity)
-     */
-    private findAgent;
-    /**
-     * Find a user by name (case-insensitive)
-     * Uses exact match, email match, or starts-with match (no contains match to avoid ambiguity)
-     */
-    private findUser;
-    /**
-     * Validate mentions - check if all mentions are valid
-     * Returns array of invalid mention names
-     * Supports both JSON and legacy mention formats
-     */
+    /** Pass-through to {@link ConversationsRuntime.Instance.Mentions.validateMentions}. */
     validateMentions(text: string, availableAgents: MJAIAgentEntityExtended[], availableUsers?: UserInfo[]): string[];
-    /**
-     * Extract all mention names from text (raw strings)
-     * Supports both JSON and legacy mention formats
-     */
+    /** Pass-through to {@link ConversationsRuntime.Instance.Mentions.extractMentionNames}. */
     extractMentionNames(text: string): string[];
-    /**
-     * Replace mentions in text with formatted versions
-     * Example: "@agent" -> "@Agent Name" (with proper casing)
-     */
+    /** Pass-through to {@link ConversationsRuntime.Instance.Mentions.formatMentions}. */
     formatMentions(text: string, mentions: Mention[]): string;
-    /**
-     * Convert a message with JSON-encoded mentions to plain text.
-     * Replaces @{...} JSON mentions with simple @Name format.
-     * This is a wrapper around ConversationUtility.ToPlainText() for Angular injection.
-     *
-     * @param text - The message text containing JSON mentions
-     * @param agents - Optional array of agents for name lookup
-     * @param users - Optional array of users for name lookup
-     * @returns Plain text with mentions converted to @Name format
-     *
-     * @example
-     * // Input: '@{"type":"agent","id":"123","name":"Sage"} help me'
-     * // Output: '@Sage help me'
-     */
+    /** Pass-through to {@link ConversationsRuntime.Instance.Mentions.toPlainText}. */
     toPlainText(text: string, agents?: MJAIAgentEntityExtended[], users?: UserInfo[]): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<MentionParserService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<MentionParserService>;

package/dist/lib/services/mention-parser.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mention-parser.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/mention-parser.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAuB,MAAM,8BAA8B,CAAC;AAC5F,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;;AAEhD;;;GAGG;AACH,qBAGa,oBAAoB;IAE/B,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAiB;IAEpD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAwB;;IAI7D;;;;;;;OAOG;IACH,aAAa,CACX,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,uBAAuB,EAAE,EAC1C,cAAc,CAAC,EAAE,QAAQ,EAAE,GAC1B,kBAAkB;IA8ErB;;;OAGG;IACH,OAAO,CAAC,SAAS;IAwBjB;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAkBhB;;;;OAIG;IACH,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,uBAAuB,EAAE,EAC1C,cAAc,CAAC,EAAE,QAAQ,EAAE,GAC1B,MAAM,EAAE;IAgDX;;;OAGG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAoB3C;;;OAGG;IACH,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,OAAO,EAAE,GAClB,MAAM;IAkBT;;;;;;;;;;;;;OAaG;IACH,WAAW,CACT,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,uBAAuB,EAAE,EAClC,KAAK,CAAC,EAAE,QAAQ,EAAE,GACjB,MAAM;yCAhRE,oBAAoB;6CAApB,oBAAoB;CAiShC"}
+{"version":3,"file":"mention-parser.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/mention-parser.service.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AACzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,6BAA6B,EAAE,MAAM,2CAA2C,CAAC;;AAO1F,qBACa,oBAAoB;gBACjB,UAAU,EAAE,6BAA6B;IAIrD,oFAAoF;IACpF,aAAa,CACT,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,uBAAuB,EAAE,EAC1C,cAAc,CAAC,EAAE,QAAQ,EAAE,GAC5B,kBAAkB;IAQrB,uFAAuF;IACvF,gBAAgB,CACZ,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,uBAAuB,EAAE,EAC1C,cAAc,CAAC,EAAE,QAAQ,EAAE,GAC5B,MAAM,EAAE;IAQX,0FAA0F;IAC1F,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAI3C,qFAAqF;IACrF,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM;IAIzD,kFAAkF;IAClF,WAAW,CACP,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,uBAAuB,EAAE,EAClC,KAAK,CAAC,EAAE,QAAQ,EAAE,GACnB,MAAM;yCA9CA,oBAAoB;6CAApB,oBAAoB;CAiDhC"}