@memberjunction/ai-agents 5.40.2 → 5.42.0

package/dist/realtime/realtime-channel-server-host.js

@@ -0,0 +1,378 @@
+/**
+ * @fileoverview Process-wide host for SERVER-SIDE interactive-channel plugins — the resolution +
+ * per-session lifecycle half of the `BaseRealtimeChannelServer` contract (`@memberjunction/ai`).
+ *
+ * The base class is deliberately MJ-core-free; this host is the DB-aware piece: it reads the ACTIVE
+ * `MJ: AI Agent Channels` registry rows at session start, resolves each row's `ServerPluginClass`
+ * through the MJ ClassFactory into a fresh per-session plugin instance (the exact mirror of how
+ * `VoiceSessionService.loadActiveChannels` resolves `ClientPluginClass` in the browser), and routes
+ * the session lifecycle events into those instances:
+ *
+ *  - **session started** — `SessionManager.CreateSession` (MJServer) → {@link RealtimeChannelServerHost.OnSessionStarted}
+ *  - **channel state saved** — the `SaveSessionChannelState` mutation → {@link RealtimeChannelServerHost.OnChannelStateSave}
+ *    (pre-persistence; the plugin may normalize the payload)
+ *  - **session closed** — `SessionManager.CloseSession` (every close path: explicit, janitor,
+ *    shutdown drain, error teardown) → {@link RealtimeChannelServerHost.OnSessionClosed}
+ *
+ * **Failure posture:** nothing in here ever throws to a caller. Registry failures degrade to "no
+ * server plugins"; a throwing plugin hook is logged and skipped; an unknown session is a no-op.
+ * Channel plugins can never break a live call or block persistence.
+ *
+ * **`BaseSingleton` (per MJ rule #7):** plugin instances are in-memory, per-process state shared
+ * between the resolver layer and `SessionManager`/`SessionJanitor` call paths — a plain instance
+ * field on either would split the state, so the host is a Global-Object-Store-backed singleton.
+ *
+ * @module @memberjunction/ai-agents
+ * @author MemberJunction.com
+ */
+import { BaseRealtimeChannelServer, } from '@memberjunction/ai';
+import { BaseSingleton, MJGlobal } from '@memberjunction/global';
+import { LogError, LogStatus } from '@memberjunction/core';
+import { AIEngineBase } from '@memberjunction/ai-engine-base';
+/** Entity name — kept in sync with the session machinery's `MJ:`-prefix convention. */
+const CHANNEL_ENTITY = 'MJ: AI Agent Channels';
+/**
+ * Default post-close linger (ms) before plugin instances are disposed. The client's channel-state
+ * pipeline debounces saves (~3s) and flushes once at teardown — that final flush legitimately lands
+ * AFTER `CloseAgentSession`, and it is the state of record a future resume restores, so it must
+ * still route through the plugin's normalization hook. 15s comfortably covers the flush window.
+ */
+const DEFAULT_DISPOSE_LINGER_MS = 15_000;
+/**
+ * Singleton host that owns every live `BaseRealtimeChannelServer` instance in this process —
+ * one instance per (session × active channel row with a resolvable `ServerPluginClass`).
+ *
+ * ### Lifecycle routing (who calls what)
+ * | Host method | Invoked from | Plugin hook(s) fired |
+ * |---|---|---|
+ * | {@link OnSessionStarted} | `SessionManager.CreateSession` after the session row persists | `Initialize(ctx)` then `OnSessionStarted()` per resolved plugin |
+ * | {@link OnChannelStateSave} | `SaveSessionChannelState` resolver, pre-persistence | the matching channel's `OnChannelStateSave(stateJson)` |
+ * | {@link OnSessionClosed} | `SessionManager.CloseSession` (all close provenances) | `OnSessionClosed(reason)` per plugin, then deferred `Dispose()` |
+ *
+ * ### Janitor / cross-host notes
+ * - The janitor's sweeps run on EVERY instance and funnel through `SessionManager.CloseSession`,
+ *   so a session whose plugins live in this process is eventually cleaned up here even when its
+ *   client vanished — including when ANOTHER instance won the close race (`CloseSession`'s
+ *   already-closed path still notifies this host, and an unknown session is a no-op).
+ * - A close for a session minted on a different host/boot simply finds no local instances.
+ */
+export class RealtimeChannelServerHost extends BaseSingleton {
+    constructor() {
+        super();
+        /** session id (lowercased) → that session's plugin instances + disposal state. */
+        this.sessions = new Map();
+        /**
+         * Post-close linger (ms) before {@link BaseRealtimeChannelServer.Dispose} runs, so the client's
+         * legitimate post-close state flush still routes through the plugin. `0` disposes immediately
+         * (used by tests). Mutable on purpose — a deployment-level knob, not per-session state.
+         */
+        this.DisposeLingerMs = DEFAULT_DISPOSE_LINGER_MS;
+    }
+    /** Process-wide singleton accessor (Global Object Store backed via {@link BaseSingleton}). */
+    static get Instance() {
+        return super.getInstance();
+    }
+    /** Number of sessions currently holding live (or close-lingering) plugin instances. */
+    get ActiveSessionCount() {
+        return this.sessions.size;
+    }
+    /**
+     * Returns the live plugin instance for `(agentSessionID, channelName)`, or `null` when none
+     * exists (no plugin resolved for that channel, unknown session, or already disposed).
+     * Lookup is case/whitespace-insensitive on both keys.
+     */
+    GetSessionPlugin(agentSessionID, channelName) {
+        const entry = this.sessions.get(this.sessionKey(agentSessionID));
+        return entry?.plugins.get(this.channelKey(channelName)) ?? null;
+    }
+    // ──────────────────────────────────────────────────────────────────────────────
+    // Server-executed channel tools — the deferred "channel tool contribution feeding
+    // RealtimeSessionRunner.ExtraTools" the realtime guide flagged. The host aggregates every
+    // live plugin's GetServerToolDefinitions and routes each prefixed tool call back to the owner.
+    // ──────────────────────────────────────────────────────────────────────────────
+    /**
+     * Aggregates the **server-executed** tool definitions every live plugin of a session contributes
+     * (each plugin's {@link BaseRealtimeChannelServer.GetServerToolDefinitions}, possibly
+     * runtime-computed) into one flat set — the per-session server-channel tool vocabulary fed into
+     * `RealtimeSessionRunner.ServerChannelTools`.
+     *
+     * Tolerant by contract: a plugin whose `GetServerToolDefinitions` throws is logged and skipped,
+     * never breaking the assembly. An unknown session returns `[]`.
+     *
+     * @param agentSessionID The session whose channels' server tools to collect.
+     * @returns The aggregated tool definitions across all of the session's live channel plugins.
+     */
+    GetSessionServerTools(agentSessionID) {
+        const entry = this.sessions.get(this.sessionKey(agentSessionID));
+        if (!entry) {
+            return [];
+        }
+        const tools = [];
+        for (const [name, plugin] of entry.plugins) {
+            try {
+                const channelTools = plugin.GetServerToolDefinitions();
+                if (Array.isArray(channelTools)) {
+                    tools.push(...channelTools);
+                }
+            }
+            catch (error) {
+                LogError(`[RealtimeChannelServerHost] GetServerToolDefinitions failed for session ${agentSessionID} / ` +
+                    `channel '${name}' — skipping its tools: ${this.message(error)}`);
+            }
+        }
+        return tools;
+    }
+    /**
+     * Routes ONE server-executed tool call to the session's plugin that owns it, matched by the
+     * plugin's {@link BaseRealtimeChannelServer.ToolNamePrefix}, and returns its result. Resolution
+     * picks the plugin whose (non-empty) prefix the tool name starts with — the longest matching
+     * prefix wins, so overlapping prefixes resolve deterministically.
+     *
+     * Never throws: an unowned tool (no channel prefix matches), an unknown session, or a plugin that
+     * throws all resolve to a structured `{ Success: false }` result so the model always receives a
+     * consistent `tool_response`.
+     *
+     * @param agentSessionID The session the tool call belongs to.
+     * @param toolName The full tool name the model invoked.
+     * @param argsJson The raw arguments JSON the model emitted.
+     * @returns The execution result (or a structured error).
+     */
+    async ExecuteSessionServerTool(agentSessionID, toolName, argsJson) {
+        const plugin = this.resolveToolOwner(agentSessionID, toolName);
+        if (!plugin) {
+            return { Success: false, Output: `No active channel owns the server tool '${toolName}' for session ${agentSessionID}.` };
+        }
+        try {
+            return await plugin.ExecuteServerTool(toolName, argsJson);
+        }
+        catch (error) {
+            LogError(`[RealtimeChannelServerHost] ExecuteServerTool failed for session ${agentSessionID} / tool '${toolName}': ${this.message(error)}`);
+            return { Success: false, Output: `Server tool '${toolName}' failed: ${this.message(error)}` };
+        }
+    }
+    /** Returns `true` when the given tool name is owned by a live channel of the session. */
+    OwnsServerTool(agentSessionID, toolName) {
+        return this.resolveToolOwner(agentSessionID, toolName) !== null;
+    }
+    /**
+     * Finds the live plugin of a session whose {@link BaseRealtimeChannelServer.ToolNamePrefix} the
+     * tool name starts with. The longest matching prefix wins so overlapping prefixes
+     * (`'Meeting_'` vs `'MeetingControls_'`) resolve to the most specific channel.
+     */
+    resolveToolOwner(agentSessionID, toolName) {
+        const entry = this.sessions.get(this.sessionKey(agentSessionID));
+        if (!entry) {
+            return null;
+        }
+        let best = null;
+        let bestPrefixLength = -1;
+        for (const plugin of entry.plugins.values()) {
+            const prefix = plugin.ToolNamePrefix;
+            if (prefix && toolName.startsWith(prefix) && prefix.length > bestPrefixLength) {
+                best = plugin;
+                bestPrefixLength = prefix.length;
+            }
+        }
+        return best;
+    }
+    /**
+     * Session-started entry point. Loads the ACTIVE channel registry rows, resolves each row's
+     * `ServerPluginClass` through the ClassFactory into ONE fresh instance for this session, and
+     * brackets each with `Initialize(ctx)` + `OnSessionStarted()`. Rows with no registered plugin
+     * are skipped with a log; a plugin whose start bracket throws is dropped (logged) without
+     * touching its siblings. Never throws — any registry/host failure degrades to "no plugins".
+     *
+     * Idempotent per session: a second start notification for a session that already holds
+     * instances is ignored (logged) rather than double-initializing.
+     */
+    async OnSessionStarted(ctx, contextUser, provider) {
+        try {
+            const key = this.sessionKey(ctx.AgentSessionID);
+            if (this.sessions.has(key)) {
+                LogStatus(`[RealtimeChannelServerHost] Session ${ctx.AgentSessionID} already has server channel plugins — ignoring duplicate start.`);
+                return;
+            }
+            const rows = await this.fetchChannelDefinitions(contextUser, provider);
+            const plugins = await this.instantiateSessionPlugins(rows, ctx);
+            if (plugins.size > 0) {
+                this.sessions.set(key, { plugins, disposeTimer: null });
+            }
+        }
+        catch (error) {
+            LogError(`[RealtimeChannelServerHost] OnSessionStarted failed for session ${ctx.AgentSessionID}: ${this.message(error)}`);
+        }
+    }
+    /**
+     * Channel-state-save entry point, invoked PRE-persistence. Routes the payload to the session's
+     * matching plugin and returns the string to persist:
+     *  - no live plugin for the channel (or unknown session) → the original `stateJson`;
+     *  - the plugin returns a non-empty replacement string → that replacement;
+     *  - the plugin returns `null`/empty/non-string, or throws (logged) → the original `stateJson`.
+     *
+     * A plugin can therefore only ever *transform* a save — it can never lose or block one.
+     */
+    async OnChannelStateSave(agentSessionID, channelName, stateJson) {
+        const plugin = this.GetSessionPlugin(agentSessionID, channelName);
+        if (!plugin) {
+            return stateJson;
+        }
+        try {
+            const replacement = await plugin.OnChannelStateSave(stateJson);
+            if (typeof replacement === 'string' && replacement.length > 0) {
+                return replacement;
+            }
+        }
+        catch (error) {
+            LogError(`[RealtimeChannelServerHost] OnChannelStateSave plugin failure for session ${agentSessionID} / ` +
+                `channel '${channelName}' — persisting the original state: ${this.message(error)}`);
+        }
+        return stateJson;
+    }
+    /**
+     * Session-closed entry point — invoked from EVERY close provenance (explicit, janitor sweeps,
+     * shutdown drain, error teardown; `SessionManager.CloseSession` is the single funnel). Fires
+     * each plugin's `OnSessionClosed(reason)` (failures logged, siblings unaffected), then defers
+     * `Dispose()` by {@link DisposeLingerMs} so the client's post-close state flush still routes
+     * through the plugins. Idempotent: an unknown session, or one whose close hooks already fired
+     * (disposal pending), is a no-op. Never throws.
+     */
+    async OnSessionClosed(agentSessionID, closeReason) {
+        const key = this.sessionKey(agentSessionID);
+        const entry = this.sessions.get(key);
+        if (!entry || entry.disposeTimer) {
+            return; // unknown session, or close hooks already fired and disposal is pending
+        }
+        for (const [name, plugin] of entry.plugins) {
+            try {
+                await plugin.OnSessionClosed(closeReason);
+            }
+            catch (error) {
+                LogError(`[RealtimeChannelServerHost] OnSessionClosed plugin failure for session ${agentSessionID} / ` +
+                    `channel '${name}': ${this.message(error)}`);
+            }
+        }
+        this.scheduleDisposal(key, entry);
+    }
+    // ----- internals -------------------------------------------------------------------------
+    /** Disposes the session's plugins now, or after the linger window when one is configured. */
+    scheduleDisposal(key, entry) {
+        if (this.DisposeLingerMs <= 0) {
+            this.disposeSession(key);
+            return;
+        }
+        entry.disposeTimer = setTimeout(() => this.disposeSession(key), this.DisposeLingerMs);
+        // Never keep the process alive for a disposal sweep.
+        entry.disposeTimer.unref?.();
+    }
+    /** Disposes and forgets every plugin instance of one session (failures logged per plugin). */
+    disposeSession(key) {
+        const entry = this.sessions.get(key);
+        if (!entry) {
+            return;
+        }
+        this.sessions.delete(key);
+        for (const [name, plugin] of entry.plugins) {
+            try {
+                plugin.Dispose();
+            }
+            catch (error) {
+                LogError(`[RealtimeChannelServerHost] Dispose failure for channel '${name}': ${this.message(error)}`);
+            }
+        }
+    }
+    /**
+     * Reads the ACTIVE `MJ: AI Agent Channels` rows from {@link AIEngineBase}'s cached
+     * `AgentChannels` (provider-scoped engine instance, lazy `Config` — no per-session RunView;
+     * the engine's BaseEntity-event reactivity keeps the registry fresh) — the server-side mirror
+     * of the client's `fetchChannelDefinitions`. Failures are logged and degrade to an empty
+     * list; channel availability must never block a session.
+     */
+    async fetchChannelDefinitions(contextUser, provider) {
+        try {
+            const engine = AIEngineBase.GetProviderInstance(provider, AIEngineBase);
+            await engine.Config(false, contextUser, provider);
+            return (engine.AgentChannels ?? [])
+                .filter((c) => c.IsActive)
+                .map((c) => ({
+                ID: c.ID,
+                Name: c.Name,
+                ServerPluginClass: c.ServerPluginClass ?? null,
+            }));
+        }
+        catch (error) {
+            LogError(`[RealtimeChannelServerHost] Failed to load the channel registry from ${CHANNEL_ENTITY}: ${this.message(error)}`);
+            return [];
+        }
+    }
+    /** Resolves + start-brackets one fresh plugin instance per resolvable registry row. */
+    async instantiateSessionPlugins(rows, ctx) {
+        const plugins = new Map();
+        for (const row of rows) {
+            const plugin = this.resolveChannelPlugin(row);
+            if (!plugin) {
+                continue;
+            }
+            try {
+                plugin.Initialize(ctx);
+                await plugin.OnSessionStarted();
+                plugins.set(this.channelKey(row.Name), plugin);
+            }
+            catch (error) {
+                LogError(`[RealtimeChannelServerHost] Server plugin for channel '${row.Name}' failed during session start ` +
+                    `— dropping it for session ${ctx.AgentSessionID}: ${this.message(error)}`);
+                this.safeDispose(plugin, row.Name);
+            }
+        }
+        return plugins;
+    }
+    /**
+     * Resolves one registry row's `ServerPluginClass` via the ClassFactory (registration checked
+     * first, exactly like the client half and the realtime model drivers) and instantiates a fresh
+     * per-session plugin. Returns `null` (logged) when the key is blank, unregistered (e.g. its
+     * `Load...()` function was never called server-side), or fails to instantiate.
+     */
+    resolveChannelPlugin(row) {
+        const key = row.ServerPluginClass?.trim();
+        if (!key) {
+            LogStatus(`[RealtimeChannelServerHost] Channel '${row.Name}' has no ServerPluginClass — skipping.`);
+            return null;
+        }
+        const registration = MJGlobal.Instance.ClassFactory.GetRegistration(BaseRealtimeChannelServer, key);
+        if (!registration) {
+            LogStatus(`[RealtimeChannelServerHost] No server plugin registered for channel '${row.Name}' (key '${key}') — skipping.`);
+            return null;
+        }
+        const plugin = MJGlobal.Instance.ClassFactory.CreateInstance(BaseRealtimeChannelServer, key);
+        if (!plugin) {
+            LogError(`[RealtimeChannelServerHost] Failed to instantiate server plugin for channel '${row.Name}' (key '${key}').`);
+            return null;
+        }
+        if (this.channelKey(plugin.ChannelName) !== this.channelKey(row.Name)) {
+            LogError(`[RealtimeChannelServerHost] Server plugin '${key}' reports ChannelName '${plugin.ChannelName}' but is ` +
+                `registered on channel row '${row.Name}' — routing by the row name; fix the plugin/registry mismatch.`);
+        }
+        return plugin;
+    }
+    /** Disposes a plugin defensively, swallowing (logging) any error. */
+    safeDispose(plugin, channelName) {
+        try {
+            plugin.Dispose();
+        }
+        catch (error) {
+            LogError(`[RealtimeChannelServerHost] Dispose failure for channel '${channelName}': ${this.message(error)}`);
+        }
+    }
+    /** Canonical map key for a session id (UUID case differs across DB platforms). */
+    sessionKey(agentSessionID) {
+        return agentSessionID.trim().toLowerCase();
+    }
+    /** Canonical map key for a channel name. */
+    channelKey(channelName) {
+        return channelName.trim().toLowerCase();
+    }
+    /** Normalizes an unknown thrown value into a loggable message. */
+    message(error) {
+        return error instanceof Error ? error.message : String(error);
+    }
+}
+//# sourceMappingURL=realtime-channel-server-host.js.map

package/dist/realtime/realtime-channel-server-host.js.map

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