@memberjunction/conversations-runtime 0.0.1 → 5.41.0

package/dist/default-agent/DefaultAgentResolver.js

@@ -0,0 +1,103 @@
+/**
+ * @fileoverview Default-agent resolution chain.
+ *
+ * Replaces the hardcoded `Agents.find(a => a.Name === 'Sage')` lookup that previously lived
+ * in three places inside `@memberjunction/ng-conversations` with a metadata-driven chain
+ * routed through `MJ: Application Settings`.
+ *
+ * Resolution order on every {@link DefaultAgentResolver.resolve} call:
+ *
+ * 1. **Explicit `explicitAgentId`** on the call (matches the widget's `[DefaultAgentId]`
+ *    `@Input` — already works today, preserved here for layering).
+ * 2. **App-scoped `MJ: Application Settings`** row (`ApplicationID = <current app>`,
+ *    `Name = 'Conversations.DefaultAgentID'`, `Value = <agent ID>`).
+ * 3. **Global `MJ: Application Settings`** row (`ApplicationID IS NULL`, same name).
+ *    Ships as a metadata seed pointing at Sage on a fresh install.
+ * 4. **Code-const fallback** — `Agents.find(a => a.Name === 'Sage')`. Safety net for
+ *    installs where the seed was skipped; preserves today's behavior so the system never
+ *    silently fails to route a turn.
+ *
+ * Steps 2 and 3 are handled by `ApplicationSettingEngine.GetSetting` in one call — that API
+ * already does app-scoped-first / global-fallback resolution internally.
+ *
+ * @module @memberjunction/conversations-runtime
+ */
+import { UUIDsEqual } from '@memberjunction/global';
+import { AIEngineBase } from '@memberjunction/ai-engine-base';
+import { ApplicationSettingEngine } from '@memberjunction/core-entities';
+/**
+ * Resolves the default agent for a conversation turn.
+ *
+ * Usually accessed via `ConversationsRuntime.Instance.DefaultAgent`. Stateless beyond
+ * lazy delegation to `ApplicationSettingEngine` and `AIEngineBase`.
+ */
+export class DefaultAgentResolver {
+    /** Application Setting key consulted in steps 2 and 3. */
+    static { this.SETTING_NAME = 'Conversations.DefaultAgentID'; }
+    /**
+     * Last-resort fallback agent name (step 4). Kept as a constant rather than another
+     * setting so the system has a hard floor even if metadata sync has never run on a
+     * fresh install — preserves today's "Sage is the default" behavior unconditionally.
+     */
+    static { this.FALLBACK_AGENT_NAME = 'Sage'; }
+    /**
+     * Resolve the default agent for this turn. Walks the 4-step chain; throws a descriptive
+     * error if every step misses (vs. the previous code path's silent `null` return, which
+     * made misconfigurations hard to spot at the call site).
+     *
+     * @example
+     * ```typescript
+     * const agent = await runtime.DefaultAgent.resolve({
+     *     explicitAgentId: widgetInput.DefaultAgentId,   // wins if non-null and matches
+     *     applicationId: currentAppId,                    // scopes the settings lookup
+     *     contextUser: this.ProviderToUse.CurrentUser,
+     *     provider: this.ProviderToUse,
+     * });
+     * ```
+     */
+    async resolve(options = {}) {
+        const { explicitAgentId, applicationId, contextUser, provider } = options;
+        // Lazy-config the engines we depend on. Both `Config(false, ...)` calls are
+        // idempotent — first caller pays the load cost, others are cache hits.
+        await AIEngineBase.Instance.Config(false, contextUser, provider);
+        await ApplicationSettingEngine.Instance.Config(false, contextUser, provider);
+        // Step 1: explicit ID wins if it resolves to a real agent.
+        if (explicitAgentId) {
+            const explicit = this.findAgentById(explicitAgentId);
+            if (explicit)
+                return explicit;
+            // If an explicit ID was supplied but doesn't resolve, fall through — this is
+            // surprising enough to warrant a warning but not surprising enough to throw
+            // (the rest of the chain may still produce a sensible default).
+            console.warn(`DefaultAgentResolver: explicitAgentId "${explicitAgentId}" did not match any known agent — falling through to settings chain.`);
+        }
+        // Steps 2 + 3: Application Setting resolution. `GetSetting` already does
+        // app-scoped-first / global-fallback in one call.
+        const settingValue = ApplicationSettingEngine.Instance.GetSetting(DefaultAgentResolver.SETTING_NAME, applicationId ?? undefined);
+        if (settingValue) {
+            const fromSetting = this.findAgentById(settingValue);
+            if (fromSetting)
+                return fromSetting;
+            console.warn(`DefaultAgentResolver: Application Setting "${DefaultAgentResolver.SETTING_NAME}" resolved to "${settingValue}" but no matching agent was found — falling through to code-const fallback.`);
+        }
+        // Step 4: code-const fallback. Find the agent named `Sage` and return it.
+        const fallback = AIEngineBase.Instance.Agents.find((a) => a.Name === DefaultAgentResolver.FALLBACK_AGENT_NAME);
+        if (fallback)
+            return fallback;
+        // No agent at any layer — descriptive error so the call site sees the misconfiguration.
+        throw new Error(`DefaultAgentResolver: could not resolve a default conversation manager agent. ` +
+            `Tried (1) explicitAgentId=${explicitAgentId ?? 'null'}, ` +
+            `(2)+(3) Application Setting "${DefaultAgentResolver.SETTING_NAME}" (applicationId=${applicationId ?? 'null'}) = "${settingValue ?? 'undefined'}", ` +
+            `(4) code-const fallback agent name = "${DefaultAgentResolver.FALLBACK_AGENT_NAME}". ` +
+            `Configure the Application Setting or seed the fallback agent.`);
+    }
+    /**
+     * Find an agent by ID from the AIEngineBase cache. Returns `undefined` if not found.
+     * Uses {@link UUIDsEqual} per the standing rule about comparing UUIDs across
+     * SQL Server / Postgres (case differences would silently miss).
+     */
+    findAgentById(id) {
+        return AIEngineBase.Instance.Agents.find((a) => UUIDsEqual(a.ID, id));
+    }
+}
+//# sourceMappingURL=DefaultAgentResolver.js.map

package/dist/default-agent/DefaultAgentResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultAgentResolver.js","sourceRoot":"","sources":["../../src/default-agent/DefaultAgentResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAE9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AA4BzE;;;;;GAKG;AACH,MAAM,OAAO,oBAAoB;IAC7B,0DAA0D;aACnC,iBAAY,GAAG,8BAA8B,CAAC;IAErE;;;;OAIG;aACoB,wBAAmB,GAAG,MAAM,CAAC;IAEpD;;;;;;;;;;;;;;OAcG;IACI,KAAK,CAAC,OAAO,CAAC,UAAsC,EAAE;QACzD,MAAM,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QAE1E,4EAA4E;QAC5E,uEAAuE;QACvE,MAAM,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;QACjE,MAAM,wBAAwB,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;QAE7E,2DAA2D;QAC3D,IAAI,eAAe,EAAE,CAAC;YAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC;YACrD,IAAI,QAAQ;gBAAE,OAAO,QAAQ,CAAC;YAC9B,6EAA6E;YAC7E,4EAA4E;YAC5E,gEAAgE;YAChE,OAAO,CAAC,IAAI,CACR,0CAA0C,eAAe,sEAAsE,CAClI,CAAC;QACN,CAAC;QAED,yEAAyE;QACzE,kDAAkD;QAClD,MAAM,YAAY,GAAG,wBAAwB,CAAC,QAAQ,CAAC,UAAU,CAC7D,oBAAoB,CAAC,YAAY,EACjC,aAAa,IAAI,SAAS,CAC7B,CAAC;QACF,IAAI,YAAY,EAAE,CAAC;YACf,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;YACrD,IAAI,WAAW;gBAAE,OAAO,WAAW,CAAC;YACpC,OAAO,CAAC,IAAI,CACR,8CAA8C,oBAAoB,CAAC,YAAY,kBAAkB,YAAY,6EAA6E,CAC7L,CAAC;QACN,CAAC;QAED,0EAA0E;QAC1E,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAC9C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,oBAAoB,CAAC,mBAAmB,CAC7D,CAAC;QACF,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAE9B,wFAAwF;QACxF,MAAM,IAAI,KAAK,CACX,gFAAgF;YAC5E,6BAA6B,eAAe,IAAI,MAAM,IAAI;YAC1D,gCAAgC,oBAAoB,CAAC,YAAY,oBAAoB,aAAa,IAAI,MAAM,QAAQ,YAAY,IAAI,WAAW,KAAK;YACpJ,yCAAyC,oBAAoB,CAAC,mBAAmB,KAAK;YACtF,+DAA+D,CACtE,CAAC;IACN,CAAC;IAED;;;;OAIG;IACK,aAAa,CAAC,EAAU;QAC5B,OAAO,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview Public entry point for `@memberjunction/conversations-runtime`.
+ *
+ * Pure-TypeScript, framework-agnostic runtime for MemberJunction conversational AI
+ * experiences. Consumable from browser (Angular widget, React, Vue, Node-side workers)
+ * or server (Node tests, CLI tools).
+ *
+ * @module @memberjunction/conversations-runtime
+ */
+export { ConversationsRuntime } from './ConversationsRuntime.js';
+export { MentionParser, type Mention, type MentionParseResult } from './mentions/MentionParser.js';
+export { ConversationBridge, type ConversationSwitchEvent, type ConversationDeepLink, } from './bridge/ConversationBridge.js';
+export { DefaultAgentResolver, type DefaultAgentResolveOptions, } from './default-agent/DefaultAgentResolver.js';
+export { SessionsObserver, type SessionLifecycleEvent, type SessionChannelState, type SessionEndReason, } from './sessions/SessionsObserver.js';
+export { ConversationStreaming, type CompletionEvent, type MessageProgressUpdate, type MessageProgressMetadata, type MessageProgressCallback, type StreamingConnectionStatus, } from './streaming/ConversationStreaming.js';
+export { ConversationAgentRunner, type ProcessMessageInput, } from './agent-runner/ConversationAgentRunner.js';
+export { type INotificationAdapter, type NotificationLevel, ConsoleNotificationAdapter, } from './adapters/INotificationAdapter.js';
+export { type IActiveTaskTracker, NoOpActiveTaskTracker, } from './adapters/IActiveTaskTracker.js';
+export { type ISessionsAdapter, NoOpSessionsAdapter, } from './adapters/ISessionsAdapter.js';
+export type { IConversationsRuntimeContext } from './context/IConversationsRuntimeContext.js';
+export { ClientToolRegistry, type ClientToolDefinition, type ClientToolHandler, } from '@memberjunction/ai-agent-client';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,KAAK,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAChG,OAAO,EACH,kBAAkB,EAClB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,GAC5B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACH,oBAAoB,EACpB,KAAK,0BAA0B,GAClC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACH,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACxB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACH,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,GACjC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACH,uBAAuB,EACvB,KAAK,mBAAmB,GAC3B,MAAM,wCAAwC,CAAC;AAGhD,OAAO,EACH,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,0BAA0B,GAC7B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACH,KAAK,kBAAkB,EACvB,qBAAqB,GACxB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACH,KAAK,gBAAgB,EACrB,mBAAmB,GACtB,MAAM,6BAA6B,CAAC;AAIrC,YAAY,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AAM3F,OAAO,EACH,kBAAkB,EAClB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACzB,MAAM,iCAAiC,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+/**
+ * @fileoverview Public entry point for `@memberjunction/conversations-runtime`.
+ *
+ * Pure-TypeScript, framework-agnostic runtime for MemberJunction conversational AI
+ * experiences. Consumable from browser (Angular widget, React, Vue, Node-side workers)
+ * or server (Node tests, CLI tools).
+ *
+ * @module @memberjunction/conversations-runtime
+ */
+// Top-level runtime singleton
+export { ConversationsRuntime } from './ConversationsRuntime.js';
+// Sub-components and their public types
+export { MentionParser } from './mentions/MentionParser.js';
+export { ConversationBridge, } from './bridge/ConversationBridge.js';
+export { DefaultAgentResolver, } from './default-agent/DefaultAgentResolver.js';
+export { SessionsObserver, } from './sessions/SessionsObserver.js';
+export { ConversationStreaming, } from './streaming/ConversationStreaming.js';
+export { ConversationAgentRunner, } from './agent-runner/ConversationAgentRunner.js';
+// Adapter interfaces + defaults
+export { ConsoleNotificationAdapter, } from './adapters/INotificationAdapter.js';
+export { NoOpActiveTaskTracker, } from './adapters/IActiveTaskTracker.js';
+export { NoOpSessionsAdapter, } from './adapters/ISessionsAdapter.js';
+// Re-export `ClientToolRegistry` from `@memberjunction/ai-agent-client` so consumers
+// can use the runtime's tool layer (`runtime.Tools`) without importing a second package
+// just to know the type. The class itself is owned by `ai-agent-client` — we are NOT
+// reimplementing it, just exposing the established surface here.
+export { ClientToolRegistry, } from '@memberjunction/ai-agent-client';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,8BAA8B;AAC9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,wCAAwC;AACxC,OAAO,EAAE,aAAa,EAAyC,MAAM,0BAA0B,CAAC;AAChG,OAAO,EACH,kBAAkB,GAGrB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACH,oBAAoB,GAEvB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACH,gBAAgB,GAInB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACH,qBAAqB,GAMxB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACH,uBAAuB,GAE1B,MAAM,wCAAwC,CAAC;AAEhD,gCAAgC;AAChC,OAAO,EAGH,0BAA0B,GAC7B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAEH,qBAAqB,GACxB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAEH,mBAAmB,GACtB,MAAM,6BAA6B,CAAC;AAMrC,qFAAqF;AACrF,wFAAwF;AACxF,qFAAqF;AACrF,iEAAiE;AACjE,OAAO,EACH,kBAAkB,GAGrB,MAAM,iCAAiC,CAAC"}

package/dist/mentions/MentionParser.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @fileoverview Pure-TypeScript mention parser for conversation message text.
+ *
+ * Ported from `@memberjunction/ng-conversations/src/lib/services/mention-parser.service.ts`
+ * — the original was already pure string + regex logic, the only Angular bit was the
+ * `@Injectable()` decorator. Stripped that, kept everything else identical.
+ *
+ * Supports both formats currently in use in MJ conversations:
+ * - **JSON format** (new): `@{"type":"agent","id":"<uuid>","name":"Sage","configId":"<uuid>"}`
+ * - **Legacy text format**: `@AgentName` or `@"Agent Name With Spaces"`
+ *
+ * @module @memberjunction/conversations-runtime
+ */
+import { MJAIAgentEntityExtended } from '@memberjunction/ai-core-plus';
+import { UserInfo } from '@memberjunction/core';
+/** A single parsed mention. */
+export interface Mention {
+    type: 'agent' | 'user' | 'entity';
+    id: string;
+    name: string;
+    /** Configuration preset ID — agent mentions only. */
+    configurationId?: string;
+}
+/** Result of parsing all mentions out of a message. */
+export interface MentionParseResult {
+    /** All mentions, in order of appearance. */
+    mentions: Mention[];
+    /** First agent mention (if any). Conventionally the routing target. */
+    agentMention: Mention | null;
+    /** All user mentions. */
+    userMentions: Mention[];
+    /** All entity mentions (`#Entity` / `@{"type":"entity",…}`). */
+    entityMentions: Mention[];
+}
+/**
+ * Parses `@`-mentions out of conversation message text.
+ *
+ * Pure logic — no framework deps, no I/O, no observable state. Safe to call from
+ * browser, Node, tests, or anywhere TypeScript runs.
+ *
+ * Consumers usually access this via `ConversationsRuntime.Instance.Mentions`.
+ */
+export declare class MentionParser {
+    /** Matches JSON-encoded mentions like `@{"type":"agent","id":"…","name":"…"}`. */
+    private readonly JSON_MENTION_REGEX;
+    /** Matches legacy text mentions — quoted names with spaces or unquoted names. */
+    private readonly LEGACY_MENTION_REGEX;
+    /**
+     * Parse every mention out of the supplied text.
+     *
+     * Tries JSON format first; if no JSON mentions are present, falls back to the legacy
+     * text format and resolves names against `availableAgents` / `availableUsers`.
+     *
+     * @param text Message text to parse
+     * @param availableAgents Agents to resolve legacy `@Name` references against
+     * @param availableUsers Optional users to resolve legacy `@Name` references against
+     * @returns Parsed mentions with agent/user separation
+     *
+     * @example
+     * ```typescript
+     * const result = parser.parseMentions(
+     *     '@Sage help me with this',
+     *     AIEngineBase.Instance.Agents
+     * );
+     * if (result.agentMention) {
+     *     // Route the message to result.agentMention.id
+     * }
+     * ```
+     */
+    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[];
+    /**
+     * Extract every raw mention name from `text` (no resolution against agents/users).
+     */
+    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;
+    /**
+     * Convert a message containing JSON-encoded mentions to plain text — `@{…}` blocks
+     * become simple `@Name` strings. Delegates to
+     * {@link ConversationUtility.ToPlainText} which is the canonical implementation.
+     *
+     * @example
+     * ```typescript
+     * // Input:  '@{"type":"agent","id":"123","name":"Sage"} help me'
+     * // Output: '@Sage help me'
+     * ```
+     */
+    toPlainText(text: string, agents?: MJAIAgentEntityExtended[], users?: UserInfo[]): string;
+    /**
+     * 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
+     * names share a substring (`@Agent` matching `Marketing Agent`, `Data Agent`, …).
+     */
+    private findAgent;
+    /**
+     * Find a user by name (case-insensitive). Tries exact name, email, then starts-with name.
+     * Same no-contains-match rule as {@link findAgent} for consistency.
+     */
+    private findUser;
+}
+//# sourceMappingURL=MentionParser.d.ts.map

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

@@ -0,0 +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,CAAC;IAClC,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;CAC7B;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;IA6ErB;;;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"}

package/dist/mentions/MentionParser.js

@@ -0,0 +1,276 @@
+/**
+ * @fileoverview Pure-TypeScript mention parser for conversation message text.
+ *
+ * Ported from `@memberjunction/ng-conversations/src/lib/services/mention-parser.service.ts`
+ * — the original was already pure string + regex logic, the only Angular bit was the
+ * `@Injectable()` decorator. Stripped that, kept everything else identical.
+ *
+ * Supports both formats currently in use in MJ conversations:
+ * - **JSON format** (new): `@{"type":"agent","id":"<uuid>","name":"Sage","configId":"<uuid>"}`
+ * - **Legacy text format**: `@AgentName` or `@"Agent Name With Spaces"`
+ *
+ * @module @memberjunction/conversations-runtime
+ */
+import { ConversationUtility } from '@memberjunction/ai-core-plus';
+/**
+ * Parses `@`-mentions out of conversation message text.
+ *
+ * Pure logic — no framework deps, no I/O, no observable state. Safe to call from
+ * browser, Node, tests, or anywhere TypeScript runs.
+ *
+ * Consumers usually access this via `ConversationsRuntime.Instance.Mentions`.
+ */
+export class MentionParser {
+    constructor() {
+        /** Matches JSON-encoded mentions like `@{"type":"agent","id":"…","name":"…"}`. */
+        this.JSON_MENTION_REGEX = /@\{[^}]+\}/g;
+        /** Matches legacy text mentions — quoted names with spaces or unquoted names. */
+        this.LEGACY_MENTION_REGEX = /@"([^"]+)"|@(\S+)/g;
+    }
+    /**
+     * Parse every mention out of the supplied text.
+     *
+     * Tries JSON format first; if no JSON mentions are present, falls back to the legacy
+     * text format and resolves names against `availableAgents` / `availableUsers`.
+     *
+     * @param text Message text to parse
+     * @param availableAgents Agents to resolve legacy `@Name` references against
+     * @param availableUsers Optional users to resolve legacy `@Name` references against
+     * @returns Parsed mentions with agent/user separation
+     *
+     * @example
+     * ```typescript
+     * const result = parser.parseMentions(
+     *     '@Sage help me with this',
+     *     AIEngineBase.Instance.Agents
+     * );
+     * if (result.agentMention) {
+     *     // Route the message to result.agentMention.id
+     * }
+     * ```
+     */
+    parseMentions(text, availableAgents, availableUsers) {
+        const mentions = [];
+        // First, try to parse JSON mentions (new format)
+        const jsonMatches = Array.from(text.matchAll(this.JSON_MENTION_REGEX));
+        for (const match of jsonMatches) {
+            try {
+                // Extract JSON string (remove @ prefix)
+                const jsonStr = match[0].substring(1);
+                const mentionData = JSON.parse(jsonStr);
+                // Validate required fields
+                if (mentionData.type && mentionData.id && mentionData.name) {
+                    const mention = {
+                        type: mentionData.type,
+                        id: mentionData.id,
+                        name: mentionData.name,
+                    };
+                    // Add configuration if present (for agents)
+                    if (mentionData.configId) {
+                        mention.configurationId = mentionData.configId;
+                    }
+                    mentions.push(mention);
+                }
+            }
+            catch (error) {
+                console.warn('MentionParser: failed to parse JSON mention:', match[0], error);
+                // Continue to next match
+            }
+        }
+        // If no JSON mentions found, fall back to legacy text format
+        if (mentions.length === 0) {
+            const legacyMatches = Array.from(text.matchAll(this.LEGACY_MENTION_REGEX));
+            for (const match of legacyMatches) {
+                // Extract the mention name (either quoted or unquoted)
+                const mentionName = match[1] || match[2];
+                if (!mentionName)
+                    continue;
+                // Try to match against agents first
+                const agent = this.findAgent(mentionName, availableAgents);
+                if (agent) {
+                    mentions.push({
+                        type: 'agent',
+                        id: agent.ID,
+                        name: agent.Name || 'Unknown',
+                    });
+                    continue;
+                }
+                // Try to match against users
+                if (availableUsers) {
+                    const user = this.findUser(mentionName, availableUsers);
+                    if (user) {
+                        mentions.push({
+                            type: 'user',
+                            id: user.ID,
+                            name: user.Name,
+                        });
+                    }
+                }
+            }
+        }
+        // Extract first agent mention, all user mentions, and all entity mentions.
+        // Entity mentions arrive as JSON (`@{"type":"entity",…}`) from the editor and are
+        // resolved against the target entity downstream (e.g. Skip's EntityMentionResolver).
+        const agentMention = mentions.find((m) => m.type === 'agent') || null;
+        const userMentions = mentions.filter((m) => m.type === 'user');
+        const entityMentions = mentions.filter((m) => m.type === 'entity');
+        return { mentions, agentMention, userMentions, entityMentions };
+    }
+    /**
+     * 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) {
+        const invalidMentions = [];
+        // Check JSON mentions first
+        const jsonMatches = Array.from(text.matchAll(this.JSON_MENTION_REGEX));
+        if (jsonMatches.length > 0) {
+            for (const match of jsonMatches) {
+                try {
+                    const jsonStr = match[0].substring(1);
+                    const mentionData = JSON.parse(jsonStr);
+                    const mentionName = mentionData.name;
+                    if (mentionData.type === 'agent') {
+                        const isAgent = this.findAgent(mentionName, availableAgents) !== null;
+                        if (!isAgent) {
+                            invalidMentions.push(mentionName);
+                        }
+                    }
+                    else if (mentionData.type === 'user') {
+                        const isUser = availableUsers
+                            ? this.findUser(mentionName, availableUsers) !== null
+                            : false;
+                        if (!isUser) {
+                            invalidMentions.push(mentionName);
+                        }
+                    }
+                }
+                catch (error) {
+                    // Invalid JSON mention
+                    invalidMentions.push(match[0]);
+                }
+            }
+        }
+        else {
+            // Fall back to legacy format
+            const matches = Array.from(text.matchAll(this.LEGACY_MENTION_REGEX));
+            for (const match of matches) {
+                const mentionName = match[1] || match[2];
+                if (!mentionName)
+                    continue;
+                const isAgent = this.findAgent(mentionName, availableAgents) !== null;
+                const isUser = availableUsers
+                    ? this.findUser(mentionName, availableUsers) !== null
+                    : false;
+                if (!isAgent && !isUser) {
+                    invalidMentions.push(mentionName);
+                }
+            }
+        }
+        return invalidMentions;
+    }
+    /**
+     * Extract every raw mention name from `text` (no resolution against agents/users).
+     */
+    extractMentionNames(text) {
+        // Check JSON mentions first
+        const jsonMatches = Array.from(text.matchAll(this.JSON_MENTION_REGEX));
+        if (jsonMatches.length > 0) {
+            return jsonMatches
+                .map((match) => {
+                try {
+                    const jsonStr = match[0].substring(1);
+                    const mentionData = JSON.parse(jsonStr);
+                    return mentionData.name;
+                }
+                catch (error) {
+                    return '';
+                }
+            })
+                .filter(Boolean);
+        }
+        // Fall back to legacy format
+        const matches = Array.from(text.matchAll(this.LEGACY_MENTION_REGEX));
+        return matches.map((match) => match[1] || match[2]).filter(Boolean);
+    }
+    /**
+     * 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) {
+        let formattedText = text;
+        for (const mention of mentions) {
+            // Find the mention in the text and replace with proper name
+            const patterns = [
+                new RegExp(`@"${mention.name}"`, 'gi'),
+                new RegExp(`@${mention.name.replace(/\s+/g, '\\s*')}`, 'gi'),
+            ];
+            for (const pattern of patterns) {
+                formattedText = formattedText.replace(pattern, `@${mention.name}`);
+            }
+        }
+        return formattedText;
+    }
+    /**
+     * Convert a message containing JSON-encoded mentions to plain text — `@{…}` blocks
+     * become simple `@Name` strings. Delegates to
+     * {@link ConversationUtility.ToPlainText} which is the canonical implementation.
+     *
+     * @example
+     * ```typescript
+     * // Input:  '@{"type":"agent","id":"123","name":"Sage"} help me'
+     * // Output: '@Sage help me'
+     * ```
+     */
+    toPlainText(text, agents, users) {
+        if (!text)
+            return '';
+        // Convert agents to the AgentInfo format expected by ConversationUtility
+        const agentInfos = agents?.map((a) => ({
+            ID: a.ID,
+            Name: a.Name || 'Unknown',
+        }));
+        // Convert users to the UserInfo format expected by ConversationUtility
+        const userInfos = users?.map((u) => ({
+            ID: u.ID,
+            Name: u.Name,
+        }));
+        return ConversationUtility.ToPlainText(text, agentInfos, userInfos);
+    }
+    /**
+     * 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
+     * names share a substring (`@Agent` matching `Marketing Agent`, `Data Agent`, …).
+     */
+    findAgent(name, agents) {
+        // Remove trailing punctuation and trim
+        const cleanName = name.replace(/[.,;!?]+$/, '').trim();
+        const lowerName = cleanName.toLowerCase();
+        // Try exact match first
+        let agent = agents.find((a) => (a.Name?.toLowerCase() || '') === lowerName);
+        if (agent)
+            return agent;
+        // Try starts-with match
+        agent = agents.find((a) => (a.Name?.toLowerCase() || '').startsWith(lowerName));
+        return agent ?? null;
+    }
+    /**
+     * Find a user by name (case-insensitive). Tries exact name, email, then starts-with name.
+     * Same no-contains-match rule as {@link findAgent} for consistency.
+     */
+    findUser(name, users) {
+        const lowerName = name.toLowerCase().trim();
+        // Try exact match first
+        let user = users.find((u) => u.Name.toLowerCase() === lowerName);
+        if (user)
+            return user;
+        // Try email match
+        user = users.find((u) => u.Email?.toLowerCase() === lowerName);
+        if (user)
+            return user;
+        // Try starts-with match
+        user = users.find((u) => u.Name.toLowerCase().startsWith(lowerName));
+        return user ?? null;
+    }
+}
+//# sourceMappingURL=MentionParser.js.map

package/dist/mentions/MentionParser.js.map

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