@memberjunction/ai-agents 5.42.0 → 5.44.0

package/dist/realtime/realtime-turn-moderator.js

@@ -0,0 +1,266 @@
+/**
+ * @fileoverview The **realtime turn moderator** — the agent-layer plugin behind the bridge engine's
+ * `SetTurnModerator` hook. For each turn in a MULTI-agent voice room it runs ONE fast LLM **prompt** (not an
+ * agent run) that decides which agent(s), in order, should speak next — routing a question to several agents
+ * when relevant, letting a *productive* agent↔agent discussion continue, and going quiet on unproductive
+ * ping-pong. The engine speaks the returned agents serially via the floor; the audio plane is untouched.
+ *
+ * Why a prompt, not an agent: this is a stateless yes/who classification — no planning, tools, or sub-agents.
+ * Each decision is an `AIPromptRun` tied to the co-agent's `AIAgentRun` (`agentRunId`) so the "who spoke and
+ * why" trail is fully observable. Informally this is the meeting's **moderator** (a.k.a. "nanny mode") — but
+ * note it *brings agents in* as much as it restrains them.
+ *
+ * The engine stays framework-agnostic: it knows only `(ctx) => Promise<string[]>`. This module supplies that
+ * function via {@link RealtimeTurnModeratorDecision}; the context types below **structurally match** the
+ * engine's exported `TurnModeratorContext` (we don't take a dependency on `@memberjunction/ai-bridge-server`,
+ * exactly as `bridge-room-transcript-sink.ts` mirrors `BridgeTranscriptSink`).
+ *
+ * @module @memberjunction/ai-agents
+ */
+import { LogError, LogStatus, LogStatusEx, RunView } from '@memberjunction/core';
+import { UUIDsEqual } from '@memberjunction/global';
+import { AIEngine } from '@memberjunction/aiengine';
+import { AIPromptParams } from '@memberjunction/ai-core-plus';
+import { AIPromptRunner } from '@memberjunction/ai-prompts';
+import { ResolveEffectiveRealtimeConfig, GetEffectiveModeratorConfig, GetEffectiveTurnMode, } from './realtime-coagent-config.js';
+/** The agent-type name whose `DefaultConfiguration` carries the room-wide moderator settings. */
+const REALTIME_AGENT_TYPE_NAME = 'Realtime';
+/**
+ * The realtime turn moderator. One shared instance is wired into the engine; it resolves the room-wide
+ * moderator config from the Realtime agent type's `DefaultConfiguration` and runs the configured prompt.
+ */
+export class RealtimeTurnModerator {
+    constructor() {
+        this.runner = new AIPromptRunner();
+        /** AgentSessionID → co-agent `AIAgentRun` id (stable per session) — avoids a query per turn. `null` = looked up, none found. */
+        this.sessionRunIdCache = new Map();
+        /** AgentID → resolved { role, mode } (stable per agent) — avoids re-resolving the cascade per turn. */
+        this.agentMetaCache = new Map();
+    }
+    /**
+     * Decides who speaks next for one turn. Returns the ordered `AgentSessionID`s to trigger (empty = nobody).
+     * Honors the optional consecutive-agent backstop, the per-call timeout, and the `onError` policy; degrades
+     * to a name-contains safety net ONLY when no moderator prompt is configured (a metadata gap, not the norm).
+     */
+    async Decide(ctx) {
+        const cfg = this.resolveConfig();
+        if (!cfg) {
+            // No moderator configured for this deployment → safety net so a room isn't mute. The configured
+            // LLM moderator is the real mechanism; this only fires when the metadata is missing.
+            return this.addressedFallback(ctx);
+        }
+        // `prestageOnAgentSpeech` controls agent↔agent continuation: when an AGENT just spoke (a continuation
+        // turn) and pre-staging is OFF, agents do not proactively respond to each other — they speak only when
+        // a human turn routes to them. (When ON, the continuation runs during the prior agent's playback.)
+        if (!cfg.prestageOnAgentSpeech && ctx.LatestTurn.IsAgent) {
+            return [];
+        }
+        // Optional HARD ping-pong backstop. Default (null) relies on the model's own progress assessment, so a
+        // genuine discussion is never gated by a counter — this only trips when an operator sets a cap.
+        if (cfg.maxConsecutiveAgentOnlyTurns != null &&
+            ctx.LatestTurn.IsAgent &&
+            ctx.ConsecutiveAgentOnlyTurns >= cfg.maxConsecutiveAgentOnlyTurns) {
+            LogStatus(`[RealtimeTurnModerator] consecutive-agent cap (${cfg.maxConsecutiveAgentOnlyTurns}) reached — room going quiet`);
+            return [];
+        }
+        try {
+            const agentRunId = ctx.AgentRunID ?? (await this.resolveAgentRunId(ctx));
+            const decision = await this.withTimeout(this.runPrompt(ctx, cfg, agentRunId), cfg.timeoutMs);
+            const names = (decision?.speakers ?? []).map((s) => s.agent);
+            if (decision?.note) {
+                LogStatus(`[RealtimeTurnModerator] note: ${decision.note}`);
+            }
+            return this.mapNamesToSessions(names, ctx);
+        }
+        catch (err) {
+            LogError(`[RealtimeTurnModerator] decision failed (${cfg.onError} fallback): ${err instanceof Error ? err.message : String(err)}`);
+            return cfg.onError === 'addressed-only' ? this.addressedFallback(ctx) : [];
+        }
+    }
+    /** Resolves the room-wide moderator config from the Realtime agent type's `DefaultConfiguration` (cache-backed). */
+    resolveConfig() {
+        try {
+            const type = (AIEngine.Instance.AgentTypes ?? []).find((t) => (t.Name ?? '').toLowerCase() === REALTIME_AGENT_TYPE_NAME.toLowerCase());
+            return GetEffectiveModeratorConfig(ResolveEffectiveRealtimeConfig(type?.DefaultConfiguration ?? null, null, null));
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Resolves an agent's live { role, mode } from its own config — `role` from its Description, `mode` from
+     * the `turnTaking.mode` of (agent type `DefaultConfiguration` ← that agent's `TypeConfiguration`). Cached
+     * per agent id. Returns `null` for an unknown id (caller falls back to engine-provided values).
+     */
+    resolveAgentMeta(agentId) {
+        if (!agentId) {
+            return null;
+        }
+        const key = agentId.toLowerCase();
+        const cached = this.agentMetaCache.get(key);
+        if (cached) {
+            return cached;
+        }
+        try {
+            const agent = (AIEngine.Instance.Agents ?? []).find((a) => UUIDsEqual(a.ID, agentId));
+            if (!agent) {
+                return null;
+            }
+            const type = (AIEngine.Instance.AgentTypes ?? []).find((t) => UUIDsEqual(t.ID, agent.TypeID));
+            const cfg = ResolveEffectiveRealtimeConfig(type?.DefaultConfiguration ?? null, null, null, agent.TypeConfiguration ?? null);
+            const meta = { role: (agent.Description ?? '').trim(), mode: GetEffectiveTurnMode(cfg) };
+            if (this.agentMetaCache.size > 1000) {
+                this.agentMetaCache.clear(); // bounded; also drops any stale entries after a metadata edit
+            }
+            this.agentMetaCache.set(key, meta);
+            return meta;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Resolves the co-agent `AIAgentRun` id for the room's representative session (found by `AgentSessionID`,
+     * Running, top-level), so each moderator prompt run nests under it. Cached per session (the run is stable
+     * for the session's life); a not-yet-found result is left uncached so it's picked up once the run exists.
+     */
+    async resolveAgentRunId(ctx) {
+        const sessionId = ctx.RepAgentSessionID?.trim();
+        if (!sessionId) {
+            return undefined;
+        }
+        const key = sessionId.toLowerCase();
+        if (this.sessionRunIdCache.has(key)) {
+            return this.sessionRunIdCache.get(key) ?? undefined;
+        }
+        try {
+            const rv = ctx.Provider ? RunView.FromMetadataProvider(ctx.Provider) : new RunView();
+            const res = await rv.RunView({
+                EntityName: 'MJ: AI Agent Runs',
+                ExtraFilter: `AgentSessionID='${sessionId.replace(/'/g, "''")}' AND Status='Running' AND ParentRunID IS NULL`,
+                Fields: ['ID'],
+                OrderBy: '__mj_CreatedAt DESC',
+                MaxRows: 1,
+                ResultType: 'simple',
+            }, ctx.ContextUser);
+            const id = res.Success && res.Results.length ? String(res.Results[0].ID) : null;
+            // Cache the result either way — the co-agent run is created at session start (before any turn), so a
+            // miss means it's genuinely unlinkable; caching null stops a per-turn DB query. Bounded by session count.
+            if (this.sessionRunIdCache.size > 1000) {
+                this.sessionRunIdCache.clear();
+            }
+            this.sessionRunIdCache.set(key, id);
+            return id ?? undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /** Runs the moderator prompt and returns its parsed decision. Throws on a missing prompt / failed run. */
+    async runPrompt(ctx, cfg, agentRunId) {
+        const prompt = AIEngine.Instance.Prompts.find((p) => UUIDsEqual(p.ID, cfg.promptId));
+        if (!prompt) {
+            throw new Error(`moderator prompt '${cfg.promptId}' not found in the AIEngine cache`);
+        }
+        const params = new AIPromptParams();
+        params.prompt = prompt;
+        params.contextUser = ctx.ContextUser;
+        params.agentRunId = agentRunId; // ties this prompt run to the co-agent run for observability
+        params.data = this.buildData(ctx, cfg);
+        const result = await this.runner.ExecutePrompt(params);
+        if (!result.success) {
+            throw new Error(result.errorMessage ?? 'moderator prompt run failed');
+        }
+        // The runner hands back the structured object OR the raw JSON string depending on the prompt's output
+        // config — normalize to the object so `.speakers` is always available (a string would make `.speakers`
+        // undefined → the room would silently route to nobody).
+        let decision = result.result;
+        if (typeof decision === 'string') {
+            try {
+                decision = JSON.parse(decision.replace(/^\s*```json/i, '').replace(/```\s*$/i, '').trim());
+            }
+            catch {
+                decision = undefined;
+            }
+        }
+        const parsed = decision;
+        LogStatusEx({ message: `[RealtimeTurnModerator][diag] decision (type=${typeof result.result}) speakers=${JSON.stringify(parsed?.speakers ?? null)}`, verboseOnly: true });
+        return parsed;
+    }
+    /**
+     * Builds the prompt data. The ROSTER (stable within a room) is separated from the rolling CONVERSATION
+     * window so a prompt template can keep the roster near the top (cacheable prefix) and the variable
+     * lookback at the bottom. The lookback is narrowed to the configured window + clipped per turn.
+     */
+    buildData(ctx, cfg) {
+        const agents = ctx.Roster.map((r) => {
+            // Resolve the live role + participation mode from the agent's own config (the TARGET agent it
+            // voices, falling back to its co-agent id). The engine ships defaults; this fills in the real values.
+            const meta = this.resolveAgentMeta(r.TargetAgentID ?? r.AgentID);
+            return {
+                name: r.Names[0] ?? 'Agent',
+                aliases: r.Names.slice(1),
+                role: meta?.role || r.Role || '',
+                mode: meta?.mode ?? r.Mode,
+            };
+        });
+        const conversation = ctx.Lookback.slice(-cfg.contextWindowTurns).map((t) => ({
+            speaker: t.Speaker,
+            isAgent: t.IsAgent,
+            text: t.Text.slice(0, cfg.maxCharsPerTurn),
+        }));
+        return {
+            agents,
+            latestSpeaker: ctx.LatestTurn.Speaker,
+            latestIsAgent: ctx.LatestTurn.IsAgent,
+            conversation,
+        };
+    }
+    /** Maps moderator-returned agent NAMES to roster `AgentSessionID`s, in order, de-duplicated. */
+    mapNamesToSessions(names, ctx) {
+        const out = [];
+        for (const name of names) {
+            const n = (name ?? '').trim().toLowerCase();
+            if (!n) {
+                continue;
+            }
+            const match = ctx.Roster.find((r) => r.Names.some((x) => x.trim().toLowerCase() === n));
+            if (match && !out.includes(match.AgentSessionID)) {
+                out.push(match.AgentSessionID);
+            }
+        }
+        return out;
+    }
+    /**
+     * Pure safety net (ONLY when no moderator prompt is configured): route to any agent whose name literally
+     * appears in the latest turn. This is deliberately crude — the configured LLM moderator handles all the
+     * nuance (typos, indirect address, relevance) that this can't.
+     */
+    addressedFallback(ctx) {
+        const text = ctx.LatestTurn.Text.toLowerCase();
+        return ctx.Roster.filter((r) => r.Names.some((nm) => nm && text.includes(nm.toLowerCase()))).map((r) => r.AgentSessionID);
+    }
+    /** Rejects if `p` doesn't settle within `ms` — keeps a slow moderator from stalling a turn. */
+    withTimeout(p, ms) {
+        return new Promise((resolve, reject) => {
+            const t = setTimeout(() => reject(new Error(`moderator timed out after ${ms}ms`)), ms);
+            p.then((v) => {
+                clearTimeout(t);
+                resolve(v);
+            }, (e) => {
+                clearTimeout(t);
+                reject(e);
+            });
+        });
+    }
+}
+/** The one shared moderator wired into the engine (no per-call construction cost). */
+const sharedModerator = new RealtimeTurnModerator();
+/**
+ * The function to pass to `AIBridgeEngine.SetTurnModerator(...)`. Structurally a `TurnModerator`
+ * (`(ctx) => Promise<string[]>`); the MJServer resolver wires it at schema-build time.
+ */
+export function RealtimeTurnModeratorDecision(ctx) {
+    return sharedModerator.Decide(ctx);
+}
+//# sourceMappingURL=realtime-turn-moderator.js.map

package/dist/realtime/realtime-turn-moderator.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/ai-agents",
   "type": "module",
-  "version": "5.42.0",
+  "version": "5.44.0",
   "description": "MemberJunction: AI Agent Execution and Management",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,22 +17,23 @@
   "author": "MemberJunction.com",
   "license": "ISC",
   "dependencies": {
-    "@memberjunction/actions": "5.42.0",
-    "@memberjunction/actions-base": "5.42.0",
-    "@memberjunction/ai": "5.42.0",
-    "@memberjunction/ai-core-plus": "5.42.0",
-    "@memberjunction/ai-engine-base": "5.42.0",
-    "@memberjunction/ai-prompts": "5.42.0",
-    "@memberjunction/ai-reranker": "5.42.0",
-    "@memberjunction/ai-vector-dupe": "5.42.0",
-    "@memberjunction/ai-vector-sync": "5.42.0",
-    "@memberjunction/aiengine": "5.42.0",
-    "@memberjunction/core": "5.42.0",
-    "@memberjunction/core-entities": "5.42.0",
-    "@memberjunction/global": "5.42.0",
-    "@memberjunction/search-engine": "5.42.0",
-    "@memberjunction/storage": "5.42.0",
-    "@memberjunction/templates": "5.42.0",
+    "@memberjunction/actions": "5.44.0",
+    "@memberjunction/actions-base": "5.44.0",
+    "@memberjunction/ai": "5.44.0",
+    "@memberjunction/ai-core-plus": "5.44.0",
+    "@memberjunction/ai-engine-base": "5.44.0",
+    "@memberjunction/ai-prompts": "5.44.0",
+    "@memberjunction/ai-reranker": "5.44.0",
+    "@memberjunction/ai-vector-dupe": "5.44.0",
+    "@memberjunction/ai-vector-sync": "5.44.0",
+    "@memberjunction/aiengine": "5.44.0",
+    "@memberjunction/context-crush": "5.44.0",
+    "@memberjunction/core": "5.44.0",
+    "@memberjunction/core-entities": "5.44.0",
+    "@memberjunction/global": "5.44.0",
+    "@memberjunction/search-engine": "5.44.0",
+    "@memberjunction/storage": "5.44.0",
+    "@memberjunction/templates": "5.44.0",
     "dotenv": "^17.2.4",
     "exceljs": "^4.4.0",
     "lodash": "^4.17.23",